Restore FireFox-only caretPositionFromPoint type

See https://unpkg.com/browse/@types/[email protected]/index.d.ts
WordPress · Aug 30, 2021 · b4636c1 · b4636c1
1 parent 04b2b09
commit b4636c1
Showing 1 changed file with 6 additions and 1 deletion.
diff --git a/packages/dom/src/dom/caret-range-from-point.js b/packages/dom/src/dom/caret-range-from-point.js
@@ -4,7 +4,7 @@
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/API/Document/caretRangeFromPoint
  *
- * @param {Document} doc The document of the range.
+ * @param {DocumentMaybeWithCaretPositionFromPoint} doc The document of the range.
  * @param {number}   x   Horizontal position within the current viewport.
  * @param {number}   y   Vertical position within the current viewport.
  *
@@ -34,3 +34,8 @@ export default function caretRangeFromPoint( doc, x, y ) {
 
 	return range;
 }
+
+/**
+ * @typedef {{caretPositionFromPoint?: (x: number, y: number)=> CaretPosition | null} & Document } DocumentMaybeWithCaretPositionFromPoint
+ * @typedef {{ readonly offset: number; readonly offsetNode: Node; getClientRect(): DOMRect | null; }} CaretPosition
+ */