@wordpress/dom 4.57.0 → 5.1.0

package/build-types/dom/replace.d.ts

@@ -1,9 +1,8 @@
 /**
  * Given two DOM nodes, replaces the former with the latter in the DOM.
  *
- * @param {Element} processedNode Node to be removed.
- * @param {Element} newNode       Node to be inserted in its place.
- * @return {void}
+ * @param processedNode Node to be removed.
+ * @param newNode       Node to be inserted in its place.
  */
 export default function replace(processedNode: Element, newNode: Element): void;
 //# sourceMappingURL=replace.d.ts.map

package/build-types/dom/replace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"replace.d.ts","sourceRoot":"","sources":["../../src/dom/replace.js"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAE,aAAa,EAJnC,OAImC,EAAE,OAAO,EAH5C,OAG4C,GAF3C,IAAI,CAMf"}
+{"version":3,"file":"replace.d.ts","sourceRoot":"","sources":["../../src/dom/replace.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAC9B,aAAa,EAAE,OAAO,EACtB,OAAO,EAAE,OAAO,GACd,IAAI,CAIN"}

package/build-types/dom/safe-html.d.ts

@@ -1,9 +1,9 @@
 /**
  * Strips scripts and on* attributes from HTML.
  *
- * @param {string} html HTML to sanitize.
+ * @param html HTML to sanitize.
  *
- * @return {string} The sanitized HTML.
+ * @return The sanitized HTML.
  */
 export default function safeHTML(html: string): string;
 //# sourceMappingURL=safe-html.d.ts.map

package/build-types/dom/safe-html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"safe-html.d.ts","sourceRoot":"","sources":["../../src/dom/safe-html.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAE,IAAI,EAJ3B,MAI2B,GAF1B,MAAM,CA2BjB"}
+{"version":3,"file":"safe-html.d.ts","sourceRoot":"","sources":["../../src/dom/safe-html.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAE,IAAI,EAAE,MAAM,GAAI,MAAM,CAyBvD"}

package/build-types/dom/scroll-if-no-range.d.ts

@@ -2,11 +2,11 @@
  * If no range range can be created or it is outside the container, the element
  * may be out of view, so scroll it into view and try again.
  *
- * @param {HTMLElement} container  The container to scroll.
- * @param {boolean}     alignToTop True to align to top, false to bottom.
- * @param {Function}    callback   The callback to create the range.
+ * @param container  The container to scroll.
+ * @param alignToTop True to align to top, false to bottom.
+ * @param callback   The callback to create the range.
  *
- * @return {?Range} The range returned by the callback.
+ * @return The range returned by the callback.
  */
-export declare function scrollIfNoRange(container: HTMLElement, alignToTop: boolean, callback: Function): Range | null;
+export declare function scrollIfNoRange(container: HTMLElement, alignToTop: boolean, callback: () => Range | null): Range | null;
 //# sourceMappingURL=scroll-if-no-range.d.ts.map

package/build-types/dom/scroll-if-no-range.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scroll-if-no-range.d.ts","sourceRoot":"","sources":["../../src/dom/scroll-if-no-range.js"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAE,SAAS,EAN/B,WAM+B,EAAE,UAAU,EAL3C,OAK2C,EAAE,QAAQ,UAAA,GAFnD,KAAK,OAAA,CAyBjB"}
+{"version":3,"file":"scroll-if-no-range.d.ts","sourceRoot":"","sources":["../../src/dom/scroll-if-no-range.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC9B,SAAS,EAAE,WAAW,EACtB,UAAU,EAAE,OAAO,EACnB,QAAQ,EAAE,MAAM,KAAK,GAAG,IAAI,GAC1B,KAAK,GAAG,IAAI,CAuBd"}

package/build-types/dom/strip-html.d.ts

@@ -1,9 +1,9 @@
 /**
  * Removes any HTML tags from the provided string.
  *
- * @param {string} html The string containing html.
+ * @param html The string containing html.
  *
- * @return {string} The text content with any html removed.
+ * @return The text content with any html removed.
  */
 export default function stripHTML(html: string): string;
 //# sourceMappingURL=strip-html.d.ts.map

package/build-types/dom/strip-html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"strip-html.d.ts","sourceRoot":"","sources":["../../src/dom/strip-html.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAE,IAAI,EAJ5B,MAI4B,GAF3B,MAAM,CAUjB"}
+{"version":3,"file":"strip-html.d.ts","sourceRoot":"","sources":["../../src/dom/strip-html.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAE,IAAI,EAAE,MAAM,GAAI,MAAM,CAQxD"}

package/build-types/dom/types.d.ts

@@ -0,0 +1,32 @@
+export interface SchemaItem {
+    /**
+     * Attributes.
+     */
+    attributes?: string[];
+    /**
+     * Classnames or RegExp to test against. Use '*' to keep all classes.
+     */
+    classes?: (string | RegExp)[];
+    /**
+     * Child schemas.
+     */
+    children?: '*' | {
+        [tag: string]: SchemaItem;
+    };
+    /**
+     * Selectors to test required children against. Leave empty or undefined if there are no requirements.
+     */
+    require?: string[];
+    /**
+     * Whether to allow nodes without children.
+     */
+    allowEmpty?: boolean;
+    /**
+     * Function to test whether a node is a match. If left undefined any node will be assumed to match.
+     */
+    isMatch?: (node: Node) => boolean;
+}
+export type Schema = {
+    [tag: string]: SchemaItem;
+};
+//# sourceMappingURL=types.d.ts.map

package/build-types/dom/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/dom/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IAC1B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAE,MAAM,GAAG,MAAM,CAAE,EAAE,CAAC;IAChC;;OAEG;IACH,QAAQ,CAAC,EAAE,GAAG,GAAG;QAAE,CAAE,GAAG,EAAE,MAAM,GAAI,UAAU,CAAA;KAAE,CAAC;IACjD;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAE,IAAI,EAAE,IAAI,KAAM,OAAO,CAAC;CACpC;AAED,MAAM,MAAM,MAAM,GAAG;IAAE,CAAE,GAAG,EAAE,MAAM,GAAI,UAAU,CAAA;CAAE,CAAC"}

package/build-types/dom/unwrap.d.ts

@@ -1,9 +1,7 @@
 /**
  * Unwrap the given node. This means any child nodes are moved to the parent.
  *
- * @param {Node} node The node to unwrap.
- *
- * @return {void}
+ * @param node The node to unwrap.
  */
 export default function unwrap(node: Node): void;
 //# sourceMappingURL=unwrap.d.ts.map

package/build-types/dom/unwrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unwrap.d.ts","sourceRoot":"","sources":["../../src/dom/unwrap.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAE,IAAI,EAJzB,IAIyB,GAFxB,IAAI,CAYf"}
+{"version":3,"file":"unwrap.d.ts","sourceRoot":"","sources":["../../src/dom/unwrap.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAE,IAAI,EAAE,IAAI,GAAI,IAAI,CAUjD"}

package/build-types/dom/wrap.d.ts

@@ -1,8 +1,8 @@
 /**
  * Wraps the given node with a new node with the given tag name.
  *
- * @param {Element} newNode       The node to insert.
- * @param {Element} referenceNode The node to wrap.
+ * @param newNode       The node to insert.
+ * @param referenceNode The node to wrap.
  */
 export default function wrap(newNode: Element, referenceNode: Element): void;
 //# sourceMappingURL=wrap.d.ts.map

package/build-types/dom/wrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../src/dom/wrap.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,IAAI,CAAE,OAAO,EAH1B,OAG0B,EAAE,aAAa,EAFzC,OAEyC,QAInD"}
+{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../src/dom/wrap.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,IAAI,CAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,QAIrE"}

package/build-types/focusable.d.ts

@@ -1,36 +1,17 @@
-/**
- * References:
- *
- * Focusable:
- *  - https://www.w3.org/TR/html5/editing.html#focus-management
- *
- * Sequential focus navigation:
- *  - https://www.w3.org/TR/html5/editing.html#sequential-focus-navigation-and-the-tabindex-attribute
- *
- * Disabled elements:
- *  - https://www.w3.org/TR/html5/disabled-elements.html#disabled-elements
- *
- * getClientRects algorithm (requiring layout box):
- *  - https://www.w3.org/TR/cssom-view-1/#extension-to-the-element-interface
- *
- * AREA elements associated with an IMG:
- *  - https://w3c.github.io/html/editing.html#data-model
- */
+import type { FindFocusableOptions } from './types';
 /**
  * Returns all focusable elements within a given context.
  *
- * @param {Element} context              Element in which to search.
- * @param {Object}  options
- * @param {boolean} [options.sequential] If set, only return elements that are
- *                                       sequentially focusable.
- *                                       Non-interactive elements with a
- *                                       negative `tabindex` are focusable but
- *                                       not sequentially focusable.
- *                                       https://html.spec.whatwg.org/multipage/interaction.html#the-tabindex-attribute
+ * @param context              Element in which to search.
+ * @param options
+ * @param [options.sequential] If set, only return elements that are
+ *                             sequentially focusable.
+ *                             Non-interactive elements with a
+ *                             negative `tabindex` are focusable but
+ *                             not sequentially focusable.
+ *                             https://html.spec.whatwg.org/multipage/interaction.html#the-tabindex-attribute
  *
- * @return {HTMLElement[]} Focusable elements.
+ * @return Focusable elements.
  */
-export declare function find(context: Element, { sequential }?: {
-    sequential?: boolean;
-}): HTMLElement[];
+export declare function find(context: Element, { sequential }?: FindFocusableOptions): HTMLElement[];
 //# sourceMappingURL=focusable.d.ts.map

package/build-types/focusable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"focusable.d.ts","sourceRoot":"","sources":["../src/focusable.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAmFH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAE,OAAO,EAXlB,OAWkB,EAAE,EAAE,UAAkB,EAAE,GATlD;IAA0B,UAAU,AAApC,CAOA,EAPQ,OAAO,CAOf;CAEuD,GAF9C,WAAW,EAAE,CAsBxB"}
+{"version":3,"file":"focusable.d.ts","sourceRoot":"","sources":["../src/focusable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAoGpD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CACnB,OAAO,EAAE,OAAO,EAChB,EAAE,UAAkB,EAAE,GAAE,oBAAyB,GAC/C,WAAW,EAAE,CAmBf"}

package/build-types/index.d.ts

@@ -11,4 +11,21 @@ export declare const focus: {
 export * from './dom';
 export * from './phrasing-content';
 export * from './data-transfer';
+/**
+ * Schema of the content allowed inside an element, keyed by tag name.
+ */
+export type { ContentSchema } from './types';
+/**
+ * The attributes and children allowed for an element in a `ContentSchema`.
+ */
+export type { SemanticElementDefinition } from './types';
+/**
+ * Schema that `cleanNodeList` and `removeInvalidHTML` clean HTML against,
+ * keyed by tag name.
+ */
+export type { Schema } from './dom/types';
+/**
+ * The rules for a single tag in a `Schema`.
+ */
+export type { SchemaItem } from './dom/types';
 //# sourceMappingURL=index.d.ts.map

package/build-types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,KAAK;;;CAA0B,CAAC;AAE7C,cAAc,OAAO,CAAC;AACtB,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,KAAK;;;CAA0B,CAAC;AAE7C,cAAc,OAAO,CAAC;AACtB,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAEhC;;GAEG;AACH,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;GAEG;AACH,YAAY,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEzD;;;GAGG;AACH,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/build-types/phrasing-content.d.ts

@@ -1,43 +1,28 @@
-/**
- * All phrasing content elements.
- *
- * @see https://www.w3.org/TR/2011/WD-html5-20110525/content-models.html#phrasing-content-0
- */
-export type ContentSchema = Record<string, SemanticElementDefinition>;
-export type SemanticElementDefinition = {
-    /**
-     * Content attributes
-     */
-    attributes?: string[];
-    /**
-     * Content attributes
-     */
-    children?: ContentSchema | '*';
-};
+import type { ContentSchema } from './types';
 /**
  * Get schema of possible paths for phrasing content.
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content
  *
- * @param {string} [context] Set to "paste" to exclude invisible elements and
- *                           sensitive data.
+ * @param [context] Set to "paste" to exclude invisible elements and
+ *                  sensitive data.
  *
- * @return {Partial<ContentSchema>} Schema.
+ * @return Schema.
  */
-export declare function getPhrasingContentSchema(context?: string): Partial<ContentSchema>;
+export declare function getPhrasingContentSchema(context?: string): ContentSchema;
 /**
  * Find out whether or not the given node is phrasing content.
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content
  *
- * @param {Node} node The node to test.
+ * @param node The node to test.
  *
- * @return {boolean} True if phrasing content, false if not.
+ * @return True if phrasing content, false if not.
  */
 export declare function isPhrasingContent(node: Node): boolean;
 /**
- * @param {Node} node
- * @return {boolean} Node is text content
+ * @param node
+ * @return Node is text content
  */
 export declare function isTextContent(node: Node): boolean;
 //# sourceMappingURL=phrasing-content.d.ts.map

package/build-types/phrasing-content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"phrasing-content.d.ts","sourceRoot":"","sources":["../src/phrasing-content.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAGA,YAAoD,aAAa,GAAvD,MAAM,CAAC,MAAM,EAAC,yBAAyB,CAAC,CAAe;AAIjE,YAAS,yBAAyB,GAClC;;;;IAA+B,UAAU,AAAzC,CACA,EADW,MAAM,EAAE,CACnB;;;;IAA+B,QAAQ,AAAvC,CACF,EADa,aAAa,GAAC,GAAG,CAC9B;CAAA,CAAA;AAqID;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAE,OAAO,AAL9C,CAGA,EAHQ,MAKsC,GAFrC,OAAO,CAAC,aAAa,CAAC,CA4BjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAE,IAAI,EAJ5B,IAI4B,GAF3B,OAAO,CAKlB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAE,IAAI,EAHxB,IAGwB,GAFvB,OAAO,CAKlB"}
+{"version":3,"file":"phrasing-content.d.ts","sourceRoot":"","sources":["../src/phrasing-content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAuI7C;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAE,OAAO,CAAC,EAAE,MAAM,GAAI,aAAa,CAuB1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAE,IAAI,EAAE,IAAI,GAAI,OAAO,CAGvD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAE,IAAI,EAAE,IAAI,GAAI,OAAO,CAGnD"}

package/build-types/tabbable.d.ts

@@ -1,37 +1,32 @@
 /**
  * Returns true if the specified element is tabbable, or false otherwise.
  *
- * @param {Element} element Element to test.
+ * @param element Element to test.
  *
- * @return {boolean} Whether element is tabbable.
+ * @return Whether element is tabbable.
  */
 export declare function isTabbableIndex(element: Element): boolean;
-export type MaybeHTMLInputElement = HTMLElement & {
-    type?: string;
-    checked?: boolean;
-    name?: string;
-};
 /**
- * @param {Element} context
- * @return {HTMLElement[]} Tabbable elements within the context.
+ * @param context
+ * @return Tabbable elements within the context.
  */
 export declare function find(context: Element): HTMLElement[];
 /**
  * Given a focusable element, find the preceding tabbable element.
  *
- * @param {Element} element The focusable element before which to look. Defaults
- *                          to the active element.
+ * @param element The focusable element before which to look. Defaults
+ *                to the active element.
  *
- * @return {HTMLElement|undefined} Preceding tabbable element.
+ * @return Preceding tabbable element.
  */
 export declare function findPrevious(element: Element): HTMLElement | undefined;
 /**
  * Given a focusable element, find the next tabbable element.
  *
- * @param {Element} element The focusable element after which to look. Defaults
- *                          to the active element.
+ * @param element The focusable element after which to look. Defaults
+ *                to the active element.
  *
- * @return {HTMLElement|undefined} Next tabbable element.
+ * @return Next tabbable element.
  */
 export declare function findNext(element: Element): HTMLElement | undefined;
 //# sourceMappingURL=tabbable.d.ts.map

package/build-types/tabbable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tabbable.d.ts","sourceRoot":"","sources":["../src/tabbable.js"],"names":[],"mappings":"AAmBA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAE,OAAO,EAJ7B,OAI6B,GAF5B,OAAO,CAIlB;AAEG,YAA6E,qBAAqB,GAAxF,WAAW,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAuB;AA+GtG;;;GAGG;AACH,wBAAgB,IAAI,CAAE,OAAO,EAHlB,OAGkB,GAFjB,WAAW,EAAE,CAIxB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAE,OAAO,EAL1B,OAK0B,GAFzB,WAAW,GAAC,SAAS,CAWhC;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAE,OAAO,EALtB,OAKsB,GAFrB,WAAW,GAAC,SAAS,CAShC"}
+{"version":3,"file":"tabbable.d.ts","sourceRoot":"","sources":["../src/tabbable.ts"],"names":[],"mappings":"AAoBA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAE,OAAO,EAAE,OAAO,GAAI,OAAO,CAE3D;AAyHD;;;GAGG;AACH,wBAAgB,IAAI,CAAE,OAAO,EAAE,OAAO,GAAI,WAAW,EAAE,CAEtD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAE,OAAO,EAAE,OAAO,GAAI,WAAW,GAAG,SAAS,CASxE;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAE,OAAO,EAAE,OAAO,GAAI,WAAW,GAAG,SAAS,CAOpE"}

package/build-types/types.d.ts

@@ -0,0 +1,29 @@
+export interface SemanticElementDefinition {
+    /**
+     * Content attributes
+     */
+    attributes?: string[];
+    /**
+     * Allowed child elements, or `'*'` for any
+     */
+    children?: ContentSchema | '*';
+}
+export type ContentSchema = Record<string, SemanticElementDefinition>;
+export interface FindFocusableOptions {
+    /**
+     * If set, only return elements that are sequentially focusable.
+     * Non-interactive elements with a negative `tabindex` are focusable but
+     * not sequentially focusable.
+     */
+    sequential?: boolean;
+}
+export type MaybeHTMLInputElement = HTMLElement & {
+    type?: string;
+    checked?: boolean;
+    name?: string;
+};
+export interface ObjectTabbable {
+    element: HTMLElement;
+    index: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/build-types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACzC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,aAAa,GAAG,GAAG,CAAC;CAC/B;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAE,MAAM,EAAE,yBAAyB,CAAE,CAAC;AAExE,MAAM,WAAW,oBAAoB;IACpC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACd"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/dom",
-	"version": "4.57.0",
+	"version": "5.1.0",
 	"description": "DOM utilities module for WordPress.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -20,14 +20,13 @@
 		"url": "https://github.com/WordPress/gutenberg/issues"
 	},
 	"engines": {
-		"node": ">=18.12.0"
+		"node": ">=22.13.0"
 	},
 	"files": [
 		"src",
 		"build",
 		"build-module",
-		"build-types",
-		"*.md"
+		"build-types"
 	],
 	"main": "build/index.cjs",
 	"module": "build-module/index.mjs",
@@ -43,13 +42,13 @@
 	"types": "build-types",
 	"sideEffects": false,
 	"dependencies": {
-		"@wordpress/deprecated": "^4.57.0"
+		"@wordpress/deprecated": "^5.1.0"
 	},
 	"devDependencies": {
-		"vitest": "^5.0.3"
+		"vitest": "^5.0.5"
 	},
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "12441e2520c78b2254a792a8cba40c34110be060"
+	"gitHead": "9b70363b9f93cff0583a1f3153738d383cf5a49e"
 }

package/src/{data-transfer.js → data-transfer.ts}

@@ -1,11 +1,11 @@
 /**
  * Gets all files from a DataTransfer object.
  *
- * @param {DataTransfer} dataTransfer DataTransfer object to inspect.
+ * @param dataTransfer DataTransfer object to inspect.
  *
- * @return {File[]} An array containing all files.
+ * @return An array containing all files.
  */
-export function getFilesFromDataTransfer( dataTransfer ) {
+export function getFilesFromDataTransfer( dataTransfer: DataTransfer ): File[] {
 	const files = Array.from( dataTransfer.files );
 
 	Array.from( dataTransfer.items ).forEach( ( item ) => {

package/src/dom/{caret-range-from-point.js → caret-range-from-point.ts}

@@ -6,13 +6,17 @@
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/API/Document/caretPositionFromPoint
  *
- * @param {Document} doc The document of the range.
- * @param {number}   x   Horizontal position within the current viewport.
- * @param {number}   y   Vertical position within the current viewport.
+ * @param doc The document of the range.
+ * @param x   Horizontal position within the current viewport.
+ * @param y   Vertical position within the current viewport.
  *
- * @return {Range | null} The best range for the given point.
+ * @return The best range for the given point.
  */
-export default function caretRangeFromPoint( doc, x, y ) {
+export default function caretRangeFromPoint(
+	doc: Document,
+	x: number,
+	y: number
+): Range | null {
 	if ( doc.caretPositionFromPoint ) {
 		const point = doc.caretPositionFromPoint( x, y );
 

package/src/dom/{clean-node-list.js → clean-node-list.ts}

@@ -4,33 +4,27 @@ import unwrap from './unwrap';
 import { isPhrasingContent } from '../phrasing-content';
 import insertAfter from './insert-after';
 import isElement from './is-element';
+import type { Schema } from './types';
 
 const noop = () => {};
 
-/**
- * @typedef SchemaItem
- * @property {string[]}                            [attributes] Attributes.
- * @property {(string | RegExp)[]}                 [classes]    Classnames or RegExp to test against. Use '*' to keep all classes.
- * @property {'*' | { [tag: string]: SchemaItem }} [children]   Child schemas.
- * @property {string[]}                            [require]    Selectors to test required children against. Leave empty or undefined if there are no requirements.
- * @property {boolean}                             allowEmpty   Whether to allow nodes without children.
- * @property {(node: Node) => boolean}             [isMatch]    Function to test whether a node is a match. If left undefined any node will be assumed to match.
- */
-
-/** @typedef {{ [tag: string]: SchemaItem }} Schema */
-
 /**
  * Given a schema, unwraps or removes nodes, attributes and classes on a node
  * list.
  *
- * @param {NodeList} nodeList The nodeList to filter.
- * @param {Document} doc      The document of the nodeList.
- * @param {Schema}   schema   An array of functions that can mutate with the provided node.
- * @param {boolean}  inline   Whether to clean for inline mode.
+ * @param nodeList The nodeList to filter.
+ * @param doc      The document of the nodeList.
+ * @param schema   Schema for the HTML.
+ * @param [inline] Whether to clean for inline mode.
  */
-export default function cleanNodeList( nodeList, doc, schema, inline ) {
+export default function cleanNodeList(
+	nodeList: NodeList,
+	doc: Document,
+	schema: Schema,
+	inline?: boolean
+) {
 	Array.from( nodeList ).forEach(
-		( /** @type {Node & { nextElementSibling?: unknown }} */ node ) => {
+		( node: Node & { nextElementSibling?: unknown } ) => {
 			const tag = node.nodeName.toLowerCase();
 
 			// It's a valid child, if the tag exists in the schema without an isMatch
@@ -84,13 +78,11 @@ export default function cleanNodeList( nodeList, doc, schema, inline ) {
 									// Keep all classes.
 									return () => true;
 								} else if ( typeof item === 'string' ) {
-									return (
-										/** @type {string} */ className
-									) => className === item;
+									return ( className: string ) =>
+										className === item;
 								} else if ( item instanceof RegExp ) {
-									return (
-										/** @type {string} */ className
-									) => item.test( className );
+									return ( className: string ) =>
+										item.test( className );
 								}
 
 								return noop;

package/src/dom/{compute-caret-rect.js → compute-caret-rect.ts}

@@ -4,11 +4,11 @@ import { assertIsDefined } from '../utils/assert-is-defined';
 /**
  * Get the rectangle for the selection in a container.
  *
- * @param {Window} win The window of the selection.
+ * @param win The window of the selection.
  *
- * @return {DOMRect | null} The rectangle.
+ * @return The rectangle.
  */
-export default function computeCaretRect( win ) {
+export default function computeCaretRect( win: Window ): DOMRect | null {
 	const selection = win.getSelection();
 	assertIsDefined( selection, 'selection' );
 	const range = selection.rangeCount ? selection.getRangeAt( 0 ) : null;

package/src/dom/{document-has-selection.js → document-has-selection.ts}

@@ -6,11 +6,11 @@ import documentHasTextSelection from './document-has-text-selection';
  * Check whether the current document has a selection. This includes focus in
  * input fields, textareas, and general rich-text selection.
  *
- * @param {Document} doc The document to check.
+ * @param doc The document to check.
  *
- * @return {boolean} True if there is selection, false if not.
+ * @return True if there is selection, false if not.
  */
-export default function documentHasSelection( doc ) {
+export default function documentHasSelection( doc: Document ): boolean {
 	return (
 		!! doc.activeElement &&
 		( isHTMLInputElement( doc.activeElement ) ||

package/src/dom/{document-has-text-selection.js → document-has-text-selection.ts}

@@ -7,11 +7,11 @@ import { assertIsDefined } from '../utils/assert-is-defined';
  *
  * See: https://developer.mozilla.org/en-US/docs/Web/API/Window/getSelection#Related_objects.
  *
- * @param {Document} doc The document to check.
+ * @param doc The document to check.
  *
- * @return {boolean} True if there is selection, false if not.
+ * @return True if there is selection, false if not.
  */
-export default function documentHasTextSelection( doc ) {
+export default function documentHasTextSelection( doc: Document ): boolean {
 	assertIsDefined( doc.defaultView, 'doc.defaultView' );
 	const selection = doc.defaultView.getSelection();
 	assertIsDefined( selection, 'selection' );

package/src/dom/{document-has-uncollapsed-selection.js → document-has-uncollapsed-selection.ts}

@@ -6,11 +6,13 @@ import inputFieldHasUncollapsedSelection from './input-field-has-uncollapsed-sel
  * This includes ranges of text across elements and any selection inside
  * textual `<input>` and `<textarea>` elements.
  *
- * @param {Document} doc The document to check.
+ * @param doc The document to check.
  *
- * @return {boolean} Whether there is any recognizable text selection in the document.
+ * @return Whether there is any recognizable text selection in the document.
  */
-export default function documentHasUncollapsedSelection( doc ) {
+export default function documentHasUncollapsedSelection(
+	doc: Document
+): boolean {
 	return (
 		documentHasTextSelection( doc ) ||
 		( !! doc.activeElement &&

package/src/dom/{get-computed-style.js → get-computed-style.ts}

@@ -1,10 +1,12 @@
 import { assertIsDefined } from '../utils/assert-is-defined';
 
 /**
- * @param {Element} element
- * @return {ReturnType<Window['getComputedStyle']>} The computed style for the element.
+ * @param element
+ * @return The computed style for the element.
  */
-export default function getComputedStyle( element ) {
+export default function getComputedStyle(
+	element: Element
+): CSSStyleDeclaration {
 	assertIsDefined(
 		element.ownerDocument.defaultView,
 		'element.ownerDocument.defaultView'