@wordpress/dom 4.57.0 → 5.1.0

package/build-module/dom/replace.mjs

@@ -1,13 +1,18 @@
-// packages/dom/src/dom/replace.js
 import { assertIsDefined } from "../utils/assert-is-defined.mjs";
 import insertAfter from "./insert-after.mjs";
 import remove from "./remove.mjs";
+// packages/dom/src/dom/replace.ts
+/**
+* Given two DOM nodes, replaces the former with the latter in the DOM.
+*
+* @param processedNode Node to be removed.
+* @param newNode       Node to be inserted in its place.
+*/
 function replace(processedNode, newNode) {
-  assertIsDefined(processedNode.parentNode, "processedNode.parentNode");
-  insertAfter(newNode, processedNode.parentNode);
-  remove(processedNode);
+	assertIsDefined(processedNode.parentNode, "processedNode.parentNode");
+	insertAfter(newNode, processedNode.parentNode);
+	remove(processedNode);
 }
-export {
-  replace as default
-};
-//# sourceMappingURL=replace.mjs.map
+export { replace as default };
+
+//# sourceMappingURL=replace.mjs.map

package/build-module/dom/replace.mjs.map

@@ -1,7 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/dom/replace.js"],
-  "sourcesContent": ["import { assertIsDefined } from '../utils/assert-is-defined';\nimport insertAfter from './insert-after';\nimport remove from './remove';\n\n/**\n * Given two DOM nodes, replaces the former with the latter in the DOM.\n *\n * @param {Element} processedNode Node to be removed.\n * @param {Element} newNode       Node to be inserted in its place.\n * @return {void}\n */\nexport default function replace( processedNode, newNode ) {\n\tassertIsDefined( processedNode.parentNode, 'processedNode.parentNode' );\n\tinsertAfter( newNode, processedNode.parentNode );\n\tremove( processedNode );\n}\n"],
-  "mappings": ";AAAA,SAAS,uBAAuB;AAChC,OAAO,iBAAiB;AACxB,OAAO,YAAY;AASJ,SAAR,QAA0B,eAAe,SAAU;AACzD,kBAAiB,cAAc,YAAY,0BAA2B;AACtE,cAAa,SAAS,cAAc,UAAW;AAC/C,SAAQ,aAAc;AACvB;",
-  "names": []
-}
+{"version":3,"file":"replace.mjs","names":[],"sources":["../../src/dom/replace.ts"],"sourcesContent":["import { assertIsDefined } from '../utils/assert-is-defined';\nimport insertAfter from './insert-after';\nimport remove from './remove';\n\n/**\n * Given two DOM nodes, replaces the former with the latter in the DOM.\n *\n * @param processedNode Node to be removed.\n * @param newNode       Node to be inserted in its place.\n */\nexport default function replace(\n\tprocessedNode: Element,\n\tnewNode: Element\n): void {\n\tassertIsDefined( processedNode.parentNode, 'processedNode.parentNode' );\n\tinsertAfter( newNode, processedNode.parentNode );\n\tremove( processedNode );\n}\n"],"mappings":";;;;;;;;;;AAUA,SAAwB,QACvB,eACA,SACO;CACP,gBAAiB,cAAc,YAAY,0BAA2B;CACtE,YAAa,SAAS,cAAc,UAAW;CAC/C,OAAQ,aAAc;AACvB"}

package/build-module/dom/safe-html.mjs

@@ -1,27 +1,30 @@
-// packages/dom/src/dom/safe-html.js
 import remove from "./remove.mjs";
+// packages/dom/src/dom/safe-html.ts
+/**
+* Strips scripts and on* attributes from HTML.
+*
+* @param html HTML to sanitize.
+*
+* @return The sanitized HTML.
+*/
 function safeHTML(html) {
-  const { body } = document.implementation.createHTMLDocument("");
-  body.innerHTML = html;
-  const elements = body.getElementsByTagName("*");
-  let elementIndex = elements.length;
-  while (elementIndex--) {
-    const element = elements[elementIndex];
-    if (element.tagName === "SCRIPT") {
-      remove(element);
-    } else {
-      let attributeIndex = element.attributes.length;
-      while (attributeIndex--) {
-        const { name: key } = element.attributes[attributeIndex];
-        if (key.startsWith("on")) {
-          element.removeAttribute(key);
-        }
-      }
-    }
-  }
-  return body.innerHTML;
+	const { body } = document.implementation.createHTMLDocument("");
+	body.innerHTML = html;
+	const elements = body.getElementsByTagName("*");
+	let elementIndex = elements.length;
+	while (elementIndex--) {
+		const element = elements[elementIndex];
+		if (element.tagName === "SCRIPT") remove(element);
+		else {
+			let attributeIndex = element.attributes.length;
+			while (attributeIndex--) {
+				const { name: key } = element.attributes[attributeIndex];
+				if (key.startsWith("on")) element.removeAttribute(key);
+			}
+		}
+	}
+	return body.innerHTML;
 }
-export {
-  safeHTML as default
-};
-//# sourceMappingURL=safe-html.mjs.map
+export { safeHTML as default };
+
+//# sourceMappingURL=safe-html.mjs.map

package/build-module/dom/safe-html.mjs.map

@@ -1,7 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/dom/safe-html.js"],
-  "sourcesContent": ["import remove from './remove';\n\n/**\n * Strips scripts and on* attributes from HTML.\n *\n * @param {string} html HTML to sanitize.\n *\n * @return {string} The sanitized HTML.\n */\nexport default function safeHTML( html ) {\n\tconst { body } = document.implementation.createHTMLDocument( '' );\n\tbody.innerHTML = html;\n\tconst elements = body.getElementsByTagName( '*' );\n\tlet elementIndex = elements.length;\n\n\twhile ( elementIndex-- ) {\n\t\tconst element = elements[ elementIndex ];\n\n\t\tif ( element.tagName === 'SCRIPT' ) {\n\t\t\tremove( element );\n\t\t} else {\n\t\t\tlet attributeIndex = element.attributes.length;\n\n\t\t\twhile ( attributeIndex-- ) {\n\t\t\t\tconst { name: key } = element.attributes[ attributeIndex ];\n\n\t\t\t\tif ( key.startsWith( 'on' ) ) {\n\t\t\t\t\telement.removeAttribute( key );\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\treturn body.innerHTML;\n}\n"],
-  "mappings": ";AAAA,OAAO,YAAY;AASJ,SAAR,SAA2B,MAAO;AACxC,QAAM,EAAE,KAAK,IAAI,SAAS,eAAe,mBAAoB,EAAG;AAChE,OAAK,YAAY;AACjB,QAAM,WAAW,KAAK,qBAAsB,GAAI;AAChD,MAAI,eAAe,SAAS;AAE5B,SAAQ,gBAAiB;AACxB,UAAM,UAAU,SAAU,YAAa;AAEvC,QAAK,QAAQ,YAAY,UAAW;AACnC,aAAQ,OAAQ;AAAA,IACjB,OAAO;AACN,UAAI,iBAAiB,QAAQ,WAAW;AAExC,aAAQ,kBAAmB;AAC1B,cAAM,EAAE,MAAM,IAAI,IAAI,QAAQ,WAAY,cAAe;AAEzD,YAAK,IAAI,WAAY,IAAK,GAAI;AAC7B,kBAAQ,gBAAiB,GAAI;AAAA,QAC9B;AAAA,MACD;AAAA,IACD;AAAA,EACD;AAEA,SAAO,KAAK;AACb;",
-  "names": []
-}
+{"version":3,"file":"safe-html.mjs","names":[],"sources":["../../src/dom/safe-html.ts"],"sourcesContent":["import remove from './remove';\n\n/**\n * Strips scripts and on* attributes from HTML.\n *\n * @param html HTML to sanitize.\n *\n * @return The sanitized HTML.\n */\nexport default function safeHTML( html: string ): string {\n\tconst { body } = document.implementation.createHTMLDocument( '' );\n\tbody.innerHTML = html;\n\tconst elements = body.getElementsByTagName( '*' );\n\tlet elementIndex = elements.length;\n\n\twhile ( elementIndex-- ) {\n\t\tconst element = elements[ elementIndex ];\n\n\t\tif ( element.tagName === 'SCRIPT' ) {\n\t\t\tremove( element );\n\t\t} else {\n\t\t\tlet attributeIndex = element.attributes.length;\n\n\t\t\twhile ( attributeIndex-- ) {\n\t\t\t\tconst { name: key } = element.attributes[ attributeIndex ];\n\n\t\t\t\tif ( key.startsWith( 'on' ) ) {\n\t\t\t\t\telement.removeAttribute( key );\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\treturn body.innerHTML;\n}\n"],"mappings":";;;;;;;;;AASA,SAAwB,SAAU,MAAuB;CACxD,MAAM,EAAE,SAAS,SAAS,eAAe,mBAAoB,EAAG;CAChE,KAAK,YAAY;CACjB,MAAM,WAAW,KAAK,qBAAsB,GAAI;CAChD,IAAI,eAAe,SAAS;CAE5B,OAAQ,gBAAiB;EACxB,MAAM,UAAU,SAAU;EAE1B,IAAK,QAAQ,YAAY,UACxB,OAAQ,OAAQ;OACV;GACN,IAAI,iBAAiB,QAAQ,WAAW;GAExC,OAAQ,kBAAmB;IAC1B,MAAM,EAAE,MAAM,QAAQ,QAAQ,WAAY;IAE1C,IAAK,IAAI,WAAY,IAAK,GACzB,QAAQ,gBAAiB,GAAI;GAE/B;EACD;CACD;CAEA,OAAO,KAAK;AACb"}

package/build-module/dom/scroll-if-no-range.mjs

@@ -1,16 +1,23 @@
-// packages/dom/src/dom/scroll-if-no-range.js
+// packages/dom/src/dom/scroll-if-no-range.ts
+/**
+* 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 container  The container to scroll.
+* @param alignToTop True to align to top, false to bottom.
+* @param callback   The callback to create the range.
+*
+* @return The range returned by the callback.
+*/
 function scrollIfNoRange(container, alignToTop, callback) {
-  let range = callback();
-  if (!range || !range.startContainer || !container.contains(range.startContainer)) {
-    container.scrollIntoView(alignToTop);
-    range = callback();
-    if (!range || !range.startContainer || !container.contains(range.startContainer)) {
-      return null;
-    }
-  }
-  return range;
+	let range = callback();
+	if (!range || !range.startContainer || !container.contains(range.startContainer)) {
+		container.scrollIntoView(alignToTop);
+		range = callback();
+		if (!range || !range.startContainer || !container.contains(range.startContainer)) return null;
+	}
+	return range;
 }
-export {
-  scrollIfNoRange
-};
-//# sourceMappingURL=scroll-if-no-range.mjs.map
+export { scrollIfNoRange };
+
+//# sourceMappingURL=scroll-if-no-range.mjs.map

package/build-module/dom/scroll-if-no-range.mjs.map

@@ -1,7 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/dom/scroll-if-no-range.js"],
-  "sourcesContent": ["/**\n * If no range range can be created or it is outside the container, the element\n * may be out of view, so scroll it into view and try again.\n *\n * @param {HTMLElement} container  The container to scroll.\n * @param {boolean}     alignToTop True to align to top, false to bottom.\n * @param {Function}    callback   The callback to create the range.\n *\n * @return {?Range} The range returned by the callback.\n */\nexport function scrollIfNoRange( container, alignToTop, callback ) {\n\tlet range = callback();\n\n\t// If no range range can be created or it is outside the container, the\n\t// element may be out of view.\n\tif (\n\t\t! range ||\n\t\t! range.startContainer ||\n\t\t! container.contains( range.startContainer )\n\t) {\n\t\tcontainer.scrollIntoView( alignToTop );\n\t\trange = callback();\n\n\t\tif (\n\t\t\t! range ||\n\t\t\t! range.startContainer ||\n\t\t\t! container.contains( range.startContainer )\n\t\t) {\n\t\t\treturn null;\n\t\t}\n\t}\n\n\treturn range;\n}\n"],
-  "mappings": ";AAUO,SAAS,gBAAiB,WAAW,YAAY,UAAW;AAClE,MAAI,QAAQ,SAAS;AAIrB,MACC,CAAE,SACF,CAAE,MAAM,kBACR,CAAE,UAAU,SAAU,MAAM,cAAe,GAC1C;AACD,cAAU,eAAgB,UAAW;AACrC,YAAQ,SAAS;AAEjB,QACC,CAAE,SACF,CAAE,MAAM,kBACR,CAAE,UAAU,SAAU,MAAM,cAAe,GAC1C;AACD,aAAO;AAAA,IACR;AAAA,EACD;AAEA,SAAO;AACR;",
-  "names": []
-}
+{"version":3,"file":"scroll-if-no-range.mjs","names":[],"sources":["../../src/dom/scroll-if-no-range.ts"],"sourcesContent":["/**\n * If no range range can be created or it is outside the container, the element\n * may be out of view, so scroll it into view and try again.\n *\n * @param container  The container to scroll.\n * @param alignToTop True to align to top, false to bottom.\n * @param callback   The callback to create the range.\n *\n * @return The range returned by the callback.\n */\nexport function scrollIfNoRange(\n\tcontainer: HTMLElement,\n\talignToTop: boolean,\n\tcallback: () => Range | null\n): Range | null {\n\tlet range = callback();\n\n\t// If no range range can be created or it is outside the container, the\n\t// element may be out of view.\n\tif (\n\t\t! range ||\n\t\t! range.startContainer ||\n\t\t! container.contains( range.startContainer )\n\t) {\n\t\tcontainer.scrollIntoView( alignToTop );\n\t\trange = callback();\n\n\t\tif (\n\t\t\t! range ||\n\t\t\t! range.startContainer ||\n\t\t\t! container.contains( range.startContainer )\n\t\t) {\n\t\t\treturn null;\n\t\t}\n\t}\n\n\treturn range;\n}\n"],"mappings":";;;;;;;;;;;AAUA,SAAgB,gBACf,WACA,YACA,UACe;CACf,IAAI,QAAQ,SAAS;CAIrB,IACC,CAAE,SACF,CAAE,MAAM,kBACR,CAAE,UAAU,SAAU,MAAM,cAAe,GAC1C;EACD,UAAU,eAAgB,UAAW;EACrC,QAAQ,SAAS;EAEjB,IACC,CAAE,SACF,CAAE,MAAM,kBACR,CAAE,UAAU,SAAU,MAAM,cAAe,GAE3C,OAAO;CAET;CAEA,OAAO;AACR"}

package/build-module/dom/strip-html.mjs

@@ -1,12 +1,18 @@
-// packages/dom/src/dom/strip-html.js
 import safeHTML from "./safe-html.mjs";
+// packages/dom/src/dom/strip-html.ts
+/**
+* Removes any HTML tags from the provided string.
+*
+* @param html The string containing html.
+*
+* @return The text content with any html removed.
+*/
 function stripHTML(html) {
-  html = safeHTML(html);
-  const doc = document.implementation.createHTMLDocument("");
-  doc.body.innerHTML = html;
-  return doc.body.textContent || "";
+	html = safeHTML(html);
+	const doc = document.implementation.createHTMLDocument("");
+	doc.body.innerHTML = html;
+	return doc.body.textContent || "";
 }
-export {
-  stripHTML as default
-};
-//# sourceMappingURL=strip-html.mjs.map
+export { stripHTML as default };
+
+//# sourceMappingURL=strip-html.mjs.map

package/build-module/dom/strip-html.mjs.map

@@ -1,7 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/dom/strip-html.js"],
-  "sourcesContent": ["import safeHTML from './safe-html';\n\n/**\n * Removes any HTML tags from the provided string.\n *\n * @param {string} html The string containing html.\n *\n * @return {string} The text content with any html removed.\n */\nexport default function stripHTML( html ) {\n\t// Remove any script tags or on* attributes otherwise their *contents* will be left\n\t// in place following removal of HTML tags.\n\thtml = safeHTML( html );\n\n\tconst doc = document.implementation.createHTMLDocument( '' );\n\tdoc.body.innerHTML = html;\n\treturn doc.body.textContent || '';\n}\n"],
-  "mappings": ";AAAA,OAAO,cAAc;AASN,SAAR,UAA4B,MAAO;AAGzC,SAAO,SAAU,IAAK;AAEtB,QAAM,MAAM,SAAS,eAAe,mBAAoB,EAAG;AAC3D,MAAI,KAAK,YAAY;AACrB,SAAO,IAAI,KAAK,eAAe;AAChC;",
-  "names": []
-}
+{"version":3,"file":"strip-html.mjs","names":[],"sources":["../../src/dom/strip-html.ts"],"sourcesContent":["import safeHTML from './safe-html';\n\n/**\n * Removes any HTML tags from the provided string.\n *\n * @param html The string containing html.\n *\n * @return The text content with any html removed.\n */\nexport default function stripHTML( html: string ): string {\n\t// Remove any script tags or on* attributes otherwise their *contents* will be left\n\t// in place following removal of HTML tags.\n\thtml = safeHTML( html );\n\n\tconst doc = document.implementation.createHTMLDocument( '' );\n\tdoc.body.innerHTML = html;\n\treturn doc.body.textContent || '';\n}\n"],"mappings":";;;;;;;;;AASA,SAAwB,UAAW,MAAuB;CAGzD,OAAO,SAAU,IAAK;CAEtB,MAAM,MAAM,SAAS,eAAe,mBAAoB,EAAG;CAC3D,IAAI,KAAK,YAAY;CACrB,OAAO,IAAI,KAAK,eAAe;AAChC"}

package/build-module/dom/unwrap.mjs

@@ -1,14 +1,16 @@
-// packages/dom/src/dom/unwrap.js
 import { assertIsDefined } from "../utils/assert-is-defined.mjs";
+// packages/dom/src/dom/unwrap.ts
+/**
+* Unwrap the given node. This means any child nodes are moved to the parent.
+*
+* @param node The node to unwrap.
+*/
 function unwrap(node) {
-  const parent = node.parentNode;
-  assertIsDefined(parent, "node.parentNode");
-  while (node.firstChild) {
-    parent.insertBefore(node.firstChild, node);
-  }
-  parent.removeChild(node);
+	const parent = node.parentNode;
+	assertIsDefined(parent, "node.parentNode");
+	while (node.firstChild) parent.insertBefore(node.firstChild, node);
+	parent.removeChild(node);
 }
-export {
-  unwrap as default
-};
-//# sourceMappingURL=unwrap.mjs.map
+export { unwrap as default };
+
+//# sourceMappingURL=unwrap.mjs.map

package/build-module/dom/unwrap.mjs.map

@@ -1,7 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/dom/unwrap.js"],
-  "sourcesContent": ["import { assertIsDefined } from '../utils/assert-is-defined';\n\n/**\n * Unwrap the given node. This means any child nodes are moved to the parent.\n *\n * @param {Node} node The node to unwrap.\n *\n * @return {void}\n */\nexport default function unwrap( node ) {\n\tconst parent = node.parentNode;\n\n\tassertIsDefined( parent, 'node.parentNode' );\n\n\twhile ( node.firstChild ) {\n\t\tparent.insertBefore( node.firstChild, node );\n\t}\n\n\tparent.removeChild( node );\n}\n"],
-  "mappings": ";AAAA,SAAS,uBAAuB;AASjB,SAAR,OAAyB,MAAO;AACtC,QAAM,SAAS,KAAK;AAEpB,kBAAiB,QAAQ,iBAAkB;AAE3C,SAAQ,KAAK,YAAa;AACzB,WAAO,aAAc,KAAK,YAAY,IAAK;AAAA,EAC5C;AAEA,SAAO,YAAa,IAAK;AAC1B;",
-  "names": []
-}
+{"version":3,"file":"unwrap.mjs","names":[],"sources":["../../src/dom/unwrap.ts"],"sourcesContent":["import { assertIsDefined } from '../utils/assert-is-defined';\n\n/**\n * Unwrap the given node. This means any child nodes are moved to the parent.\n *\n * @param node The node to unwrap.\n */\nexport default function unwrap( node: Node ): void {\n\tconst parent = node.parentNode;\n\n\tassertIsDefined( parent, 'node.parentNode' );\n\n\twhile ( node.firstChild ) {\n\t\tparent.insertBefore( node.firstChild, node );\n\t}\n\n\tparent.removeChild( node );\n}\n"],"mappings":";;;;;;;AAOA,SAAwB,OAAQ,MAAmB;CAClD,MAAM,SAAS,KAAK;CAEpB,gBAAiB,QAAQ,iBAAkB;CAE3C,OAAQ,KAAK,YACZ,OAAO,aAAc,KAAK,YAAY,IAAK;CAG5C,OAAO,YAAa,IAAK;AAC1B"}

package/build-module/dom/wrap.mjs

@@ -1,11 +1,16 @@
-// packages/dom/src/dom/wrap.js
 import { assertIsDefined } from "../utils/assert-is-defined.mjs";
+// packages/dom/src/dom/wrap.ts
+/**
+* Wraps the given node with a new node with the given tag name.
+*
+* @param newNode       The node to insert.
+* @param referenceNode The node to wrap.
+*/
 function wrap(newNode, referenceNode) {
-  assertIsDefined(referenceNode.parentNode, "referenceNode.parentNode");
-  referenceNode.parentNode.insertBefore(newNode, referenceNode);
-  newNode.appendChild(referenceNode);
+	assertIsDefined(referenceNode.parentNode, "referenceNode.parentNode");
+	referenceNode.parentNode.insertBefore(newNode, referenceNode);
+	newNode.appendChild(referenceNode);
 }
-export {
-  wrap as default
-};
-//# sourceMappingURL=wrap.mjs.map
+export { wrap as default };
+
+//# sourceMappingURL=wrap.mjs.map

package/build-module/dom/wrap.mjs.map

@@ -1,7 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/dom/wrap.js"],
-  "sourcesContent": ["import { assertIsDefined } from '../utils/assert-is-defined';\n\n/**\n * Wraps the given node with a new node with the given tag name.\n *\n * @param {Element} newNode       The node to insert.\n * @param {Element} referenceNode The node to wrap.\n */\nexport default function wrap( newNode, referenceNode ) {\n\tassertIsDefined( referenceNode.parentNode, 'referenceNode.parentNode' );\n\treferenceNode.parentNode.insertBefore( newNode, referenceNode );\n\tnewNode.appendChild( referenceNode );\n}\n"],
-  "mappings": ";AAAA,SAAS,uBAAuB;AAQjB,SAAR,KAAuB,SAAS,eAAgB;AACtD,kBAAiB,cAAc,YAAY,0BAA2B;AACtE,gBAAc,WAAW,aAAc,SAAS,aAAc;AAC9D,UAAQ,YAAa,aAAc;AACpC;",
-  "names": []
-}
+{"version":3,"file":"wrap.mjs","names":[],"sources":["../../src/dom/wrap.ts"],"sourcesContent":["import { assertIsDefined } from '../utils/assert-is-defined';\n\n/**\n * Wraps the given node with a new node with the given tag name.\n *\n * @param newNode       The node to insert.\n * @param referenceNode The node to wrap.\n */\nexport default function wrap( newNode: Element, referenceNode: Element ) {\n\tassertIsDefined( referenceNode.parentNode, 'referenceNode.parentNode' );\n\treferenceNode.parentNode.insertBefore( newNode, referenceNode );\n\tnewNode.appendChild( referenceNode );\n}\n"],"mappings":";;;;;;;;AAQA,SAAwB,KAAM,SAAkB,eAAyB;CACxE,gBAAiB,cAAc,YAAY,0BAA2B;CACtE,cAAc,WAAW,aAAc,SAAS,aAAc;CAC9D,QAAQ,YAAa,aAAc;AACpC"}

package/build-module/focusable.mjs

@@ -1,62 +1,104 @@
-// packages/dom/src/focusable.js
+// packages/dom/src/focusable.ts
+/**
+* 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
+*/
+/**
+* Returns a CSS selector used to query for focusable elements.
+*
+* @param sequential If set, only query 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 CSS selector.
+*/
 function buildSelector(sequential) {
-  return [
-    sequential ? '[tabindex]:not([tabindex^="-"])' : "[tabindex]",
-    "a[href]",
-    "button:not([disabled])",
-    'input:not([type="hidden"]):not([disabled])',
-    "select:not([disabled])",
-    "textarea:not([disabled])",
-    'iframe:not([tabindex^="-"])',
-    "object",
-    "embed",
-    "summary",
-    "area[href]",
-    "[contenteditable]:not([contenteditable=false])"
-  ].join(",");
+	return [
+		sequential ? "[tabindex]:not([tabindex^=\"-\"])" : "[tabindex]",
+		"a[href]",
+		"button:not([disabled])",
+		"input:not([type=\"hidden\"]):not([disabled])",
+		"select:not([disabled])",
+		"textarea:not([disabled])",
+		"iframe:not([tabindex^=\"-\"])",
+		"object",
+		"embed",
+		"summary",
+		"area[href]",
+		"[contenteditable]:not([contenteditable=false])"
+	].join(",");
 }
+/**
+* Returns true if the specified element has a layout box and is not hidden by
+* CSS visibility or content visibility.
+*
+* @param element DOM element to test.
+*
+* @return Whether element is visible.
+*/
 function isVisible(element) {
-  if (typeof element.checkVisibility === "function") {
-    if (!element.checkVisibility({ visibilityProperty: true })) {
-      return false;
-    }
-  } else {
-    const visibility = element.ownerDocument.defaultView?.getComputedStyle(
-      element
-    ).visibility;
-    if (visibility === "hidden" || visibility === "collapse") {
-      return false;
-    }
-  }
-  return element.offsetWidth > 0 || element.offsetHeight > 0 || element.getClientRects().length > 0;
+	if (typeof element.checkVisibility === "function") {
+		if (!element.checkVisibility({ visibilityProperty: true })) return false;
+	} else {
+		const visibility = element.ownerDocument.defaultView?.getComputedStyle(element).visibility;
+		if (visibility === "hidden" || visibility === "collapse") return false;
+	}
+	return element.offsetWidth > 0 || element.offsetHeight > 0 || element.getClientRects().length > 0;
 }
+/**
+* Returns true if the specified area element is a valid focusable element, or
+* false otherwise. Area is only focusable if within a map where a named map
+* referenced by an image somewhere in the document.
+*
+* @param element DOM area element to test.
+*
+* @return Whether area element is valid for focus.
+*/
 function isValidFocusableArea(element) {
-  const map = element.closest("map[name]");
-  if (!map) {
-    return false;
-  }
-  const img = element.ownerDocument.querySelector(
-    'img[usemap="#' + map.name + '"]'
-  );
-  return !!img && !img.closest("[inert]") && isVisible(img);
+	const map = element.closest("map[name]");
+	if (!map) return false;
+	const img = element.ownerDocument.querySelector("img[usemap=\"#" + map.name + "\"]");
+	return !!img && !img.closest("[inert]") && isVisible(img);
 }
+/**
+* Returns all focusable elements within a given context.
+*
+* @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 Focusable elements.
+*/
 function find(context, { sequential = false } = {}) {
-  const elements = context.querySelectorAll(buildSelector(sequential));
-  return Array.from(elements).filter((element) => {
-    const { nodeName } = element;
-    if ("AREA" === nodeName) {
-      return isValidFocusableArea(
-        /** @type {HTMLAreaElement} */
-        element
-      );
-    }
-    if (element.closest("[inert]")) {
-      return false;
-    }
-    return isVisible(element);
-  });
+	const elements = context.querySelectorAll(buildSelector(sequential));
+	return Array.from(elements).filter((element) => {
+		const { nodeName } = element;
+		if ("AREA" === nodeName) return isValidFocusableArea(element);
+		if (element.closest("[inert]")) return false;
+		return isVisible(element);
+	});
 }
-export {
-  find
-};
-//# sourceMappingURL=focusable.mjs.map
+export { find };
+
+//# sourceMappingURL=focusable.mjs.map

package/build-module/focusable.mjs.map

@@ -1,7 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/focusable.js"],
-  "sourcesContent": ["/**\n * References:\n *\n * Focusable:\n *  - https://www.w3.org/TR/html5/editing.html#focus-management\n *\n * Sequential focus navigation:\n *  - https://www.w3.org/TR/html5/editing.html#sequential-focus-navigation-and-the-tabindex-attribute\n *\n * Disabled elements:\n *  - https://www.w3.org/TR/html5/disabled-elements.html#disabled-elements\n *\n * getClientRects algorithm (requiring layout box):\n *  - https://www.w3.org/TR/cssom-view-1/#extension-to-the-element-interface\n *\n * AREA elements associated with an IMG:\n *  - https://w3c.github.io/html/editing.html#data-model\n */\n\n/**\n * Returns a CSS selector used to query for focusable elements.\n *\n * @param {boolean} sequential If set, only query elements that are sequentially\n *                             focusable. Non-interactive elements with a\n *                             negative `tabindex` are focusable but not\n *                             sequentially focusable.\n *                             https://html.spec.whatwg.org/multipage/interaction.html#the-tabindex-attribute\n *\n * @return {string} CSS selector.\n */\nfunction buildSelector( sequential ) {\n\treturn [\n\t\tsequential ? '[tabindex]:not([tabindex^=\"-\"])' : '[tabindex]',\n\t\t'a[href]',\n\t\t'button:not([disabled])',\n\t\t'input:not([type=\"hidden\"]):not([disabled])',\n\t\t'select:not([disabled])',\n\t\t'textarea:not([disabled])',\n\t\t'iframe:not([tabindex^=\"-\"])',\n\t\t'object',\n\t\t'embed',\n\t\t'summary',\n\t\t'area[href]',\n\t\t'[contenteditable]:not([contenteditable=false])',\n\t].join( ',' );\n}\n\n/**\n * Returns true if the specified element has a layout box and is not hidden by\n * CSS visibility or content visibility.\n *\n * @param {HTMLElement} element DOM element to test.\n *\n * @return {boolean} Whether element is visible.\n */\nfunction isVisible( element ) {\n\tif ( typeof element.checkVisibility === 'function' ) {\n\t\tif ( ! element.checkVisibility( { visibilityProperty: true } ) ) {\n\t\t\treturn false;\n\t\t}\n\t} else {\n\t\tconst visibility =\n\t\t\telement.ownerDocument.defaultView?.getComputedStyle(\n\t\t\t\telement\n\t\t\t).visibility;\n\t\tif ( visibility === 'hidden' || visibility === 'collapse' ) {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\treturn (\n\t\telement.offsetWidth > 0 ||\n\t\telement.offsetHeight > 0 ||\n\t\telement.getClientRects().length > 0\n\t);\n}\n\n/**\n * Returns true if the specified area element is a valid focusable element, or\n * false otherwise. Area is only focusable if within a map where a named map\n * referenced by an image somewhere in the document.\n *\n * @param {HTMLAreaElement} element DOM area element to test.\n *\n * @return {boolean} Whether area element is valid for focus.\n */\nfunction isValidFocusableArea( element ) {\n\t/** @type {HTMLMapElement | null} */\n\tconst map = element.closest( 'map[name]' );\n\tif ( ! map ) {\n\t\treturn false;\n\t}\n\n\t/** @type {HTMLImageElement | null} */\n\tconst img = element.ownerDocument.querySelector(\n\t\t'img[usemap=\"#' + map.name + '\"]'\n\t);\n\treturn !! img && ! img.closest( '[inert]' ) && isVisible( img );\n}\n\n/**\n * Returns all focusable elements within a given context.\n *\n * @param {Element} context              Element in which to search.\n * @param {Object}  options\n * @param {boolean} [options.sequential] If set, only return elements that are\n *                                       sequentially focusable.\n *                                       Non-interactive elements with a\n *                                       negative `tabindex` are focusable but\n *                                       not sequentially focusable.\n *                                       https://html.spec.whatwg.org/multipage/interaction.html#the-tabindex-attribute\n *\n * @return {HTMLElement[]} Focusable elements.\n */\nexport function find( context, { sequential = false } = {} ) {\n\t/** @type {NodeListOf<HTMLElement>} */\n\tconst elements = context.querySelectorAll( buildSelector( sequential ) );\n\n\treturn Array.from( elements ).filter( ( element ) => {\n\t\tconst { nodeName } = element;\n\t\tif ( 'AREA' === nodeName ) {\n\t\t\t// The mapped image determines whether this region is visible or inert.\n\t\t\treturn isValidFocusableArea(\n\t\t\t\t/** @type {HTMLAreaElement} */ ( element )\n\t\t\t);\n\t\t}\n\n\t\t// Elements inside an inert subtree are not focusable.\n\t\tif ( element.closest( '[inert]' ) ) {\n\t\t\treturn false;\n\t\t}\n\n\t\treturn isVisible( element );\n\t} );\n}\n"],
-  "mappings": ";AA8BA,SAAS,cAAe,YAAa;AACpC,SAAO;AAAA,IACN,aAAa,oCAAoC;AAAA,IACjD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD,EAAE,KAAM,GAAI;AACb;AAUA,SAAS,UAAW,SAAU;AAC7B,MAAK,OAAO,QAAQ,oBAAoB,YAAa;AACpD,QAAK,CAAE,QAAQ,gBAAiB,EAAE,oBAAoB,KAAK,CAAE,GAAI;AAChE,aAAO;AAAA,IACR;AAAA,EACD,OAAO;AACN,UAAM,aACL,QAAQ,cAAc,aAAa;AAAA,MAClC;AAAA,IACD,EAAE;AACH,QAAK,eAAe,YAAY,eAAe,YAAa;AAC3D,aAAO;AAAA,IACR;AAAA,EACD;AAEA,SACC,QAAQ,cAAc,KACtB,QAAQ,eAAe,KACvB,QAAQ,eAAe,EAAE,SAAS;AAEpC;AAWA,SAAS,qBAAsB,SAAU;AAExC,QAAM,MAAM,QAAQ,QAAS,WAAY;AACzC,MAAK,CAAE,KAAM;AACZ,WAAO;AAAA,EACR;AAGA,QAAM,MAAM,QAAQ,cAAc;AAAA,IACjC,kBAAkB,IAAI,OAAO;AAAA,EAC9B;AACA,SAAO,CAAC,CAAE,OAAO,CAAE,IAAI,QAAS,SAAU,KAAK,UAAW,GAAI;AAC/D;AAgBO,SAAS,KAAM,SAAS,EAAE,aAAa,MAAM,IAAI,CAAC,GAAI;AAE5D,QAAM,WAAW,QAAQ,iBAAkB,cAAe,UAAW,CAAE;AAEvE,SAAO,MAAM,KAAM,QAAS,EAAE,OAAQ,CAAE,YAAa;AACpD,UAAM,EAAE,SAAS,IAAI;AACrB,QAAK,WAAW,UAAW;AAE1B,aAAO;AAAA;AAAA,QAC2B;AAAA,MAClC;AAAA,IACD;AAGA,QAAK,QAAQ,QAAS,SAAU,GAAI;AACnC,aAAO;AAAA,IACR;AAEA,WAAO,UAAW,OAAQ;AAAA,EAC3B,CAAE;AACH;",
-  "names": []
-}
+{"version":3,"file":"focusable.mjs","names":[],"sources":["../src/focusable.ts"],"sourcesContent":["import type { FindFocusableOptions } from './types';\n\n/**\n * References:\n *\n * Focusable:\n *  - https://www.w3.org/TR/html5/editing.html#focus-management\n *\n * Sequential focus navigation:\n *  - https://www.w3.org/TR/html5/editing.html#sequential-focus-navigation-and-the-tabindex-attribute\n *\n * Disabled elements:\n *  - https://www.w3.org/TR/html5/disabled-elements.html#disabled-elements\n *\n * getClientRects algorithm (requiring layout box):\n *  - https://www.w3.org/TR/cssom-view-1/#extension-to-the-element-interface\n *\n * AREA elements associated with an IMG:\n *  - https://w3c.github.io/html/editing.html#data-model\n */\n\n/**\n * Returns a CSS selector used to query for focusable elements.\n *\n * @param sequential If set, only query elements that are sequentially\n *                   focusable. Non-interactive elements with a\n *                   negative `tabindex` are focusable but not\n *                   sequentially focusable.\n *                   https://html.spec.whatwg.org/multipage/interaction.html#the-tabindex-attribute\n *\n * @return CSS selector.\n */\nfunction buildSelector( sequential: boolean ): string {\n\treturn [\n\t\tsequential ? '[tabindex]:not([tabindex^=\"-\"])' : '[tabindex]',\n\t\t'a[href]',\n\t\t'button:not([disabled])',\n\t\t'input:not([type=\"hidden\"]):not([disabled])',\n\t\t'select:not([disabled])',\n\t\t'textarea:not([disabled])',\n\t\t'iframe:not([tabindex^=\"-\"])',\n\t\t'object',\n\t\t'embed',\n\t\t'summary',\n\t\t'area[href]',\n\t\t'[contenteditable]:not([contenteditable=false])',\n\t].join( ',' );\n}\n\n/**\n * Returns true if the specified element has a layout box and is not hidden by\n * CSS visibility or content visibility.\n *\n * @param element DOM element to test.\n *\n * @return Whether element is visible.\n */\nfunction isVisible( element: HTMLElement ): boolean {\n\tif ( typeof element.checkVisibility === 'function' ) {\n\t\tif ( ! element.checkVisibility( { visibilityProperty: true } ) ) {\n\t\t\treturn false;\n\t\t}\n\t} else {\n\t\tconst visibility =\n\t\t\telement.ownerDocument.defaultView?.getComputedStyle(\n\t\t\t\telement\n\t\t\t).visibility;\n\t\tif ( visibility === 'hidden' || visibility === 'collapse' ) {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\treturn (\n\t\telement.offsetWidth > 0 ||\n\t\telement.offsetHeight > 0 ||\n\t\telement.getClientRects().length > 0\n\t);\n}\n\n/**\n * Returns true if the specified area element is a valid focusable element, or\n * false otherwise. Area is only focusable if within a map where a named map\n * referenced by an image somewhere in the document.\n *\n * @param element DOM area element to test.\n *\n * @return Whether area element is valid for focus.\n */\nfunction isValidFocusableArea( element: HTMLAreaElement ): boolean {\n\tconst map: HTMLMapElement | null = element.closest( 'map[name]' );\n\tif ( ! map ) {\n\t\treturn false;\n\t}\n\n\tconst img: HTMLImageElement | null = element.ownerDocument.querySelector(\n\t\t'img[usemap=\"#' + map.name + '\"]'\n\t);\n\treturn !! img && ! img.closest( '[inert]' ) && isVisible( img );\n}\n\n/**\n * Returns all focusable elements within a given context.\n *\n * @param context              Element in which to search.\n * @param options\n * @param [options.sequential] If set, only return elements that are\n *                             sequentially focusable.\n *                             Non-interactive elements with a\n *                             negative `tabindex` are focusable but\n *                             not sequentially focusable.\n *                             https://html.spec.whatwg.org/multipage/interaction.html#the-tabindex-attribute\n *\n * @return Focusable elements.\n */\nexport function find(\n\tcontext: Element,\n\t{ sequential = false }: FindFocusableOptions = {}\n): HTMLElement[] {\n\tconst elements: NodeListOf< HTMLElement > = context.querySelectorAll(\n\t\tbuildSelector( sequential )\n\t);\n\n\treturn Array.from( elements ).filter( ( element ) => {\n\t\tconst { nodeName } = element;\n\t\tif ( 'AREA' === nodeName ) {\n\t\t\t// The mapped image determines whether this region is visible or inert.\n\t\t\treturn isValidFocusableArea( element as HTMLAreaElement );\n\t\t}\n\n\t\t// Elements inside an inert subtree are not focusable.\n\t\tif ( element.closest( '[inert]' ) ) {\n\t\t\treturn false;\n\t\t}\n\n\t\treturn isVisible( element );\n\t} );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,SAAS,cAAe,YAA8B;CACrD,OAAO;EACN,aAAa,sCAAoC;EACjD;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACD,CAAC,CAAC,KAAM,GAAI;AACb;;;;;;;;;AAUA,SAAS,UAAW,SAAgC;CACnD,IAAK,OAAO,QAAQ,oBAAoB,YAClC;MAAA,CAAE,QAAQ,gBAAiB,EAAE,oBAAoB,KAAK,CAAE,GAC5D,OAAO;CAAA,OAEF;EACN,MAAM,aACL,QAAQ,cAAc,aAAa,iBAClC,OACD,CAAC,CAAC;EACH,IAAK,eAAe,YAAY,eAAe,YAC9C,OAAO;CAET;CAEA,OACC,QAAQ,cAAc,KACtB,QAAQ,eAAe,KACvB,QAAQ,eAAe,CAAC,CAAC,SAAS;AAEpC;;;;;;;;;;AAWA,SAAS,qBAAsB,SAAoC;CAClE,MAAM,MAA6B,QAAQ,QAAS,WAAY;CAChE,IAAK,CAAE,KACN,OAAO;CAGR,MAAM,MAA+B,QAAQ,cAAc,cAC1D,mBAAkB,IAAI,OAAO,KAC9B;CACA,OAAO,CAAC,CAAE,OAAO,CAAE,IAAI,QAAS,SAAU,KAAK,UAAW,GAAI;AAC/D;;;;;;;;;;;;;;;AAgBA,SAAgB,KACf,SACA,EAAE,aAAa,UAAgC,CAAC,GAChC;CAChB,MAAM,WAAsC,QAAQ,iBACnD,cAAe,UAAW,CAC3B;CAEA,OAAO,MAAM,KAAM,QAAS,CAAC,CAAC,QAAU,YAAa;EACpD,MAAM,EAAE,aAAa;EACrB,IAAK,WAAW,UAEf,OAAO,qBAAsB,OAA2B;EAIzD,IAAK,QAAQ,QAAS,SAAU,GAC/B,OAAO;EAGR,OAAO,UAAW,OAAQ;CAC3B,CAAE;AACH"}

package/build-module/index.mjs

@@ -1,11 +1,17 @@
-// packages/dom/src/index.js
 import * as focusable from "./focusable.mjs";
 import * as tabbable from "./tabbable.mjs";
 export * from "./dom/index.mjs";
 export * from "./phrasing-content.mjs";
 export * from "./data-transfer.mjs";
-var focus = { focusable, tabbable };
-export {
-  focus
+// packages/dom/src/index.ts
+/**
+* Object grouping `focusable` and `tabbable` utils
+* under the keys with the same name.
+*/
+const focus = {
+	focusable,
+	tabbable
 };
-//# sourceMappingURL=index.mjs.map
+export { focus };
+
+//# sourceMappingURL=index.mjs.map

package/build-module/index.mjs.map

@@ -1,7 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/index.js"],
-  "sourcesContent": ["import * as focusable from './focusable';\nimport * as tabbable from './tabbable';\n\n/**\n * Object grouping `focusable` and `tabbable` utils\n * under the keys with the same name.\n */\nexport const focus = { focusable, tabbable };\n\nexport * from './dom';\nexport * from './phrasing-content';\nexport * from './data-transfer';\n"],
-  "mappings": ";AAAA,YAAY,eAAe;AAC3B,YAAY,cAAc;AAQ1B,cAAc;AACd,cAAc;AACd,cAAc;AAJP,IAAM,QAAQ,EAAE,WAAW,SAAS;",
-  "names": []
-}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import * as focusable from './focusable';\nimport * as tabbable from './tabbable';\n\n/**\n * Object grouping `focusable` and `tabbable` utils\n * under the keys with the same name.\n */\nexport const focus = { focusable, tabbable };\n\nexport * from './dom';\nexport * from './phrasing-content';\nexport * from './data-transfer';\n\n/**\n * Schema of the content allowed inside an element, keyed by tag name.\n */\nexport type { ContentSchema } from './types';\n\n/**\n * The attributes and children allowed for an element in a `ContentSchema`.\n */\nexport type { SemanticElementDefinition } from './types';\n\n/**\n * Schema that `cleanNodeList` and `removeInvalidHTML` clean HTML against,\n * keyed by tag name.\n */\nexport type { Schema } from './dom/types';\n\n/**\n * The rules for a single tag in a `Schema`.\n */\nexport type { SchemaItem } from './dom/types';\n"],"mappings":";;;;;;;;;;AAOA,MAAa,QAAQ;CAAE;CAAW;AAAS"}