@siteimprove/alfa-dom 0.93.7 → 0.94.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @siteimprove/alfa-dom
 
+## 0.94.0
+
+### Minor Changes
+
+- **Breaking:** `#serializationId` has been replaced with `#internalId`. ([#1705](https://github.com/Siteimprove/alfa/pull/1705))
+
+  The old `#serializationId` is now deprecated and acts as an alias to `#internalId`. It will be removed in a future version.
+
+- **Added:** A `Query.descendants` helper is now available, to filter DOM descendants by a predicate. ([#1709](https://github.com/Siteimprove/alfa/pull/1709))
+
+  Results are cached by predicate and node.
+
+## 0.93.8
+
 ## 0.93.7
 
 ## 0.93.6

package/dist/h.d.ts

@@ -5,17 +5,17 @@ import { Attribute, Block, Declaration, Document, Element, FontFaceRule, Fragmen
 /**
  * @public
  */
-export declare function h<N extends string = string>(name: N, attributes?: Array<Attribute> | Record<string, string | boolean>, children?: Array<Node | string>, style?: Array<Declaration> | Record<string, string>, box?: Rectangle, device?: Device, externalId?: string, serializationId?: string, extraData?: any): Element<N>;
+export declare function h<N extends string = string>(name: N, attributes?: Array<Attribute> | Record<string, string | boolean>, children?: Array<Node | string>, style?: Array<Declaration> | Record<string, string>, box?: Rectangle, device?: Device, externalId?: string, internalId?: string, extraData?: any): Element<N>;
 /**
  * @public
  */
 export declare namespace h {
-    function element<N extends string = string>(name: N, attributes?: Array<Attribute> | Record<string, string | boolean>, children?: Array<Node | string>, style?: Array<Declaration> | Record<string, string>, namespace?: Namespace, box?: Rectangle, device?: Device, externalId?: string, serializationId?: string, extraData?: any): Element<N>;
-    function attribute<N extends string = string>(name: N, value: string, externalId?: string, serializationId?: string, extraData?: any): Attribute<N>;
-    function text(data: string, externalId?: string, serializationId?: string, extraData?: any): Text;
-    function document(children: Array<Node | string>, style?: Array<Sheet>, externalId?: string, serializationId?: string, extraData?: any): Document;
-    function shadow(children: Array<Node | string>, style?: Array<Sheet>, mode?: Shadow.Mode, externalId?: string, serializationId?: string, extraData?: any): Shadow;
-    function type<N extends string = string>(name: N, publicId?: string, systemId?: string, externalId?: string, serializationId?: string, extraData?: any): Type<N>;
+    function element<N extends string = string>(name: N, attributes?: Array<Attribute> | Record<string, string | boolean>, children?: Array<Node | string>, style?: Array<Declaration> | Record<string, string>, namespace?: Namespace, box?: Rectangle, device?: Device, externalId?: string, internalId?: string, extraData?: any): Element<N>;
+    function attribute<N extends string = string>(name: N, value: string, externalId?: string, internalId?: string, extraData?: any): Attribute<N>;
+    function text(data: string, externalId?: string, internalId?: string, extraData?: any): Text;
+    function document(children: Array<Node | string>, style?: Array<Sheet>, externalId?: string, internalId?: string, extraData?: any): Document;
+    function shadow(children: Array<Node | string>, style?: Array<Sheet>, mode?: Shadow.Mode, externalId?: string, internalId?: string, extraData?: any): Shadow;
+    function type<N extends string = string>(name: N, publicId?: string, systemId?: string, externalId?: string, internalId?: string, extraData?: any): Type<N>;
     function fragment(children: Array<Node | string>, externalId?: string, extraData?: any): Fragment;
     function sheet(rules: Array<Rule>, disabled?: boolean, condition?: string): Sheet;
     function block(declarations: Array<Declaration> | Record<string, string>): Block;

package/dist/h.js

@@ -7,14 +7,14 @@ const { nor } = Predicate;
 /**
  * @public
  */
-export function h(name, attributes, children, style, box, device = Device.standard(), externalId, serializationId, extraData) {
-    return h.element(name, attributes, children, style, undefined, box, device, externalId, serializationId, extraData);
+export function h(name, attributes, children, style, box, device = Device.standard(), externalId, internalId, extraData) {
+    return h.element(name, attributes, children, style, undefined, box, device, externalId, internalId, extraData);
 }
 /**
  * @public
  */
 (function (h) {
-    function element(name, attributes = [], children = [], style = [], namespace, box, device, externalId, serializationId, extraData) {
+    function element(name, attributes = [], children = [], style = [], namespace, box, device, externalId, internalId, extraData) {
         attributes = Array.isArray(attributes)
             ? attributes
             : entries(attributes).reduce((attributes, [name, value]) => {
@@ -43,7 +43,7 @@ export function h(name, attributes, children, style, box, device = Device.standa
             .map((child) => (typeof child === "string" ? h.text(child) : child)), (Array.isArray(style) && style.length === 0) ||
             Object.keys(style).length === 0
             ? None
-            : Option.of(block), Option.from(box), Option.from(device), externalId, serializationId, extraData);
+            : Option.of(block), Option.from(box), Option.from(device), externalId, internalId, extraData);
         if (content !== undefined) {
             element._attachContent(content);
         }
@@ -53,24 +53,24 @@ export function h(name, attributes, children, style, box, device = Device.standa
         return element;
     }
     h.element = element;
-    function attribute(name, value, externalId, serializationId, extraData) {
-        return Attribute.of(None, None, name, value, externalId, serializationId, extraData);
+    function attribute(name, value, externalId, internalId, extraData) {
+        return Attribute.of(None, None, name, value, externalId, internalId, extraData);
     }
     h.attribute = attribute;
-    function text(data, externalId, serializationId, extraData) {
-        return Text.of(data, externalId, serializationId, extraData);
+    function text(data, externalId, internalId, extraData) {
+        return Text.of(data, externalId, internalId, extraData);
     }
     h.text = text;
-    function document(children, style, externalId, serializationId, extraData) {
-        return Document.of(children.map((child) => typeof child === "string" ? text(child) : child), style, externalId, serializationId, extraData);
+    function document(children, style, externalId, internalId, extraData) {
+        return Document.of(children.map((child) => typeof child === "string" ? text(child) : child), style, externalId, internalId, extraData);
     }
     h.document = document;
-    function shadow(children, style, mode, externalId, serializationId, extraData) {
-        return Shadow.of(children.map((child) => typeof child === "string" ? text(child) : child), style, mode, externalId, serializationId, extraData);
+    function shadow(children, style, mode, externalId, internalId, extraData) {
+        return Shadow.of(children.map((child) => typeof child === "string" ? text(child) : child), style, mode, externalId, internalId, extraData);
     }
     h.shadow = shadow;
-    function type(name, publicId, systemId, externalId, serializationId, extraData) {
-        return Type.of(name, Option.from(publicId), Option.from(systemId), externalId, serializationId, extraData);
+    function type(name, publicId, systemId, externalId, internalId, extraData) {
+        return Type.of(name, Option.from(publicId), Option.from(systemId), externalId, internalId, extraData);
     }
     h.type = type;
     function fragment(children, externalId, extraData) {

package/dist/jsx.js

@@ -10,7 +10,7 @@ export function jsx(name, properties = null, ...children) {
     let box = undefined;
     let device = undefined;
     let externalId = undefined;
-    let serializationId = undefined;
+    let internalId = undefined;
     for (const [name, value] of entries(properties ?? {})) {
         if (value === null || value === undefined) {
             continue;
@@ -31,15 +31,15 @@ export function jsx(name, properties = null, ...children) {
                     externalId = value;
                 }
                 continue;
-            case "serializationId":
+            case "internalId":
                 if (typeof value === "string") {
-                    serializationId = value;
+                    internalId = value;
                 }
                 continue;
             default:
                 attributes[name] = value === true ? value : `${value}`;
         }
     }
-    return h(name, attributes, children.flat(Infinity), style, box, device, externalId, serializationId);
+    return h(name, attributes, children.flat(Infinity), style, box, device, externalId, internalId);
 }
 //# sourceMappingURL=jsx.js.map

package/dist/node/attribute.d.ts

@@ -10,7 +10,7 @@ import * as predicate from "./attribute/predicate.js";
  * @public
  */
 export declare class Attribute<N extends string = string> extends Node<"attribute"> {
-    static of<N extends string = string>(namespace: Option<Namespace>, prefix: Option<string>, name: N, value: string, externalId?: string, serializationId?: string, extraData?: any): Attribute<N>;
+    static of<N extends string = string>(namespace: Option<Namespace>, prefix: Option<string>, name: N, value: string, externalId?: string, internalId?: string, extraData?: any): Attribute<N>;
     private readonly _namespace;
     private readonly _prefix;
     private readonly _name;

package/dist/node/attribute.js

@@ -13,16 +13,16 @@ const { equals, not } = Predicate;
  * @public
  */
 export class Attribute extends Node {
-    static of(namespace, prefix, name, value, externalId, serializationId, extraData) {
-        return new Attribute(namespace, prefix, name, value, externalId, serializationId, extraData);
+    static of(namespace, prefix, name, value, externalId, internalId, extraData) {
+        return new Attribute(namespace, prefix, name, value, externalId, internalId, extraData);
     }
     _namespace;
     _prefix;
     _name;
     _value;
     _owner = None;
-    constructor(namespace, prefix, name, value, externalId, serializationId, extraData) {
-        super([], "attribute", externalId, serializationId, extraData);
+    constructor(namespace, prefix, name, value, externalId, internalId, extraData) {
+        super([], "attribute", externalId, internalId, extraData);
         this._namespace = namespace;
         this._prefix = prefix;
         this._name = name;
@@ -137,14 +137,14 @@ export class Attribute extends Node {
      * @internal
      */
     function fromAttribute(attribute) {
-        return Trampoline.done(Attribute.of(Option.from(attribute.namespace), Option.from(attribute.prefix), attribute.name, attribute.value, attribute.externalId, attribute.serializationId));
+        return Trampoline.done(Attribute.of(Option.from(attribute.namespace), Option.from(attribute.prefix), attribute.name, attribute.value, attribute.externalId, attribute.internalId));
     }
     Attribute.fromAttribute = fromAttribute;
     /**
      * @internal
      */
     function cloneAttribute(attribute) {
-        return Trampoline.done(Attribute.of(attribute.namespace, attribute.prefix, attribute.name, attribute.value, attribute.externalId, attribute.serializationId, attribute.extraData));
+        return Trampoline.done(Attribute.of(attribute.namespace, attribute.prefix, attribute.name, attribute.value, attribute.externalId, attribute.internalId, attribute.extraData));
     }
     Attribute.cloneAttribute = cloneAttribute;
     /**

package/dist/node/comment.d.ts

@@ -5,7 +5,7 @@ import { Node } from "../node.js";
  * @public
  */
 export declare class Comment extends Node<"comment"> {
-    static of(data: string, externalId?: string, serializationId?: string, extraData?: any): Comment;
+    static of(data: string, externalId?: string, internalId?: string, extraData?: any): Comment;
     static empty(): Comment;
     private readonly _data;
     private constructor();

package/dist/node/comment.js

@@ -5,15 +5,15 @@ import { Node } from "../node.js";
  * @public
  */
 export class Comment extends Node {
-    static of(data, externalId, serializationId, extraData) {
-        return new Comment(data, externalId, serializationId, extraData);
+    static of(data, externalId, internalId, extraData) {
+        return new Comment(data, externalId, internalId, extraData);
     }
     static empty() {
         return new Comment("");
     }
     _data;
-    constructor(data, externalId, serializationId, extraData) {
-        super([], "comment", externalId, serializationId, extraData);
+    constructor(data, externalId, internalId, extraData) {
+        super([], "comment", externalId, internalId, extraData);
         this._data = data;
     }
     get data() {
@@ -60,14 +60,14 @@ export class Comment extends Node {
      * @internal
      */
     function fromComment(json) {
-        return Trampoline.done(Comment.of(json.data, json.externalId, json.serializationId));
+        return Trampoline.done(Comment.of(json.data, json.externalId, json.internalId));
     }
     Comment.fromComment = fromComment;
     /**
      * @internal
      */
     function cloneComment(comment) {
-        return Trampoline.done(Comment.of(comment.data, comment.externalId, comment.serializationId, comment.extraData));
+        return Trampoline.done(Comment.of(comment.data, comment.externalId, comment.internalId, comment.extraData));
     }
     Comment.cloneComment = cloneComment;
 })(Comment || (Comment = {}));

package/dist/node/document.d.ts

@@ -11,7 +11,7 @@ import { Element } from "./element.js";
  * @public
  */
 export declare class Document extends Node<"document"> {
-    static of(children: Iterable<Node>, style?: Iterable<Sheet>, externalId?: string, serializationId?: string, extraData?: any): Document;
+    static of(children: Iterable<Node>, style?: Iterable<Sheet>, externalId?: string, internalId?: string, extraData?: any): Document;
     static empty(): Document;
     private readonly _style;
     private _frame;

package/dist/node/document.js

@@ -11,16 +11,16 @@ import { Element } from "./element.js";
  * @public
  */
 export class Document extends Node {
-    static of(children, style = [], externalId, serializationId, extraData) {
-        return new Document(Array.from(children), style, externalId, serializationId, extraData);
+    static of(children, style = [], externalId, internalId, extraData) {
+        return new Document(Array.from(children), style, externalId, internalId, extraData);
     }
     static empty() {
         return new Document([], []);
     }
     _style;
     _frame = None;
-    constructor(children, style, externalId, serializationId, extraData) {
-        super(children, "document", externalId, serializationId, extraData);
+    constructor(children, style, externalId, internalId, extraData) {
+        super(children, "document", externalId, internalId, extraData);
         this._style = Array.from(style);
     }
     get style() {
@@ -92,7 +92,7 @@ export class Document extends Node {
      * @internal
      */
     function fromDocument(json, device) {
-        return Trampoline.traverse(json.children ?? [], (child) => Node.fromNode(child, device)).map((children) => Document.of(children, json.style.map(Sheet.from), json.externalId, json.serializationId));
+        return Trampoline.traverse(json.children ?? [], (child) => Node.fromNode(child, device)).map((children) => Document.of(children, json.style.map(Sheet.from), json.externalId, json.internalId));
     }
     Document.fromDocument = fromDocument;
     /**
@@ -105,7 +105,7 @@ export class Document extends Node {
             }
             return Node.cloneNode(child, options, device).map((node) => [node]);
         }).map((children) => {
-            return Document.of(Iterable.flatten(children), document.style, document.externalId, document.serializationId, document.extraData);
+            return Document.of(Iterable.flatten(children), document.style, document.externalId, document.internalId, document.extraData);
         });
     }
     Document.cloneDocument = cloneDocument;

package/dist/node/element.d.ts

@@ -20,7 +20,7 @@ import * as predicate from "./element/predicate.js";
  * @public
  */
 export declare class Element<N extends string = string> extends Node<"element"> implements Slot, Slotable {
-    static of<N extends string = string>(namespace: Option<Namespace>, prefix: Option<string>, name: N, attributes?: Iterable<Attribute>, children?: Iterable<Node>, style?: Option<Block>, box?: Option<Rectangle>, device?: Option<Device>, externalId?: string, serializationId?: string, extraData?: any): Element<N>;
+    static of<N extends string = string>(namespace: Option<Namespace>, prefix: Option<string>, name: N, attributes?: Iterable<Attribute>, children?: Iterable<Node>, style?: Option<Block>, box?: Option<Rectangle>, device?: Option<Device>, externalId?: string, internalId?: string, extraData?: any): Element<N>;
     private readonly _namespace;
     private readonly _prefix;
     private readonly _name;

package/dist/node/element.js

@@ -22,8 +22,8 @@ const { not } = Predicate;
  * @public
  */
 export class Element extends Node {
-    static of(namespace, prefix, name, attributes = [], children = [], style = None, box = None, device = None, externalId, serializationId, extraData) {
-        return new Element(namespace, prefix, name, Array.from(attributes), Array.from(children), style, box, device, externalId, serializationId, extraData);
+    static of(namespace, prefix, name, attributes = [], children = [], style = None, box = None, device = None, externalId, internalId, extraData) {
+        return new Element(namespace, prefix, name, Array.from(attributes), Array.from(children), style, box, device, externalId, internalId, extraData);
     }
     _namespace;
     _prefix;
@@ -35,8 +35,8 @@ export class Element extends Node {
     _id;
     _classes;
     _boxes;
-    constructor(namespace, prefix, name, attributes, children, style, box, device, externalId, serializationId, extraData) {
-        super(children, "element", externalId, serializationId, extraData);
+    constructor(namespace, prefix, name, attributes, children, style, box, device, externalId, internalId, extraData) {
+        super(children, "element", externalId, internalId, extraData);
         this._namespace = namespace;
         this._prefix = prefix;
         this._name = name;
@@ -301,7 +301,7 @@ export class Element extends Node {
         return Trampoline.traverse(json.children ?? [], (child) => Node.fromNode(child, device)).map((children) => {
             const element = Element.of(Option.from(json.namespace), Option.from(json.prefix), json.name, json.attributes.map((attribute) => Attribute.fromAttribute(attribute).run()), children, json.style?.length === 0
                 ? None
-                : Option.from(json.style).map(Block.from), Option.from(json.box).map(Rectangle.from), Option.from(device), json.externalId, json.serializationId);
+                : Option.from(json.style).map(Block.from), Option.from(json.box).map(Rectangle.from), Option.from(device), json.externalId, json.internalId);
             if (json.shadow !== null) {
                 element._attachShadow(Shadow.fromShadow(json.shadow, device).run());
             }
@@ -325,7 +325,7 @@ export class Element extends Node {
             const deviceOption = Option.from(device);
             const clonedElement = Element.of(element.namespace, element.prefix, element.name, element.attributes.map((attribute) => Attribute.clone(attribute, options, device)), Iterable.flatten(children), element.style.map((block) => {
                 return Block.of(Iterable.map(block.declarations, (declaration) => Declaration.of(declaration.name, declaration.value, declaration.important)));
-            }), deviceOption.flatMap((d) => element.getBoundingBox(d)), deviceOption, element.externalId, element.serializationId, element.extraData);
+            }), deviceOption.flatMap((d) => element.getBoundingBox(d)), deviceOption, element.externalId, element.internalId, element.extraData);
             if (element.shadow.isSome()) {
                 clonedElement._attachShadow(Shadow.clone(element.shadow.get(), options, device));
             }

package/dist/node/fragment.d.ts

@@ -6,7 +6,7 @@ import { Node } from "../node.js";
  * @public
  */
 export declare class Fragment extends Node<"fragment"> {
-    static of(children: Iterable<Node>, externalId?: string, serializationId?: string, extraData?: any): Fragment;
+    static of(children: Iterable<Node>, externalId?: string, internalId?: string, extraData?: any): Fragment;
     static empty(): Fragment;
     private constructor();
     /**

package/dist/node/fragment.js

@@ -7,14 +7,14 @@ import { Element } from "./element.js";
  * @public
  */
 export class Fragment extends Node {
-    static of(children, externalId, serializationId, extraData) {
-        return new Fragment(Array.from(children), externalId, serializationId, extraData);
+    static of(children, externalId, internalId, extraData) {
+        return new Fragment(Array.from(children), externalId, internalId, extraData);
     }
     static empty() {
         return new Fragment([]);
     }
-    constructor(children, externalId, serializationId, extraData) {
-        super(children, "fragment", externalId, serializationId, extraData);
+    constructor(children, externalId, internalId, extraData) {
+        super(children, "fragment", externalId, internalId, extraData);
     }
     /**
      * @internal

package/dist/node/query/descendants.d.ts

@@ -0,0 +1,34 @@
+import type { Predicate } from "@siteimprove/alfa-predicate";
+import type { Refinement } from "@siteimprove/alfa-refinement";
+import type { Sequence } from "@siteimprove/alfa-sequence";
+import { Node } from "../../node.js";
+import { Element } from "../element.js";
+/**
+ * Get all descendants of a node that satisfy a given refinement.
+ *
+ * @remarks
+ * In order to properly cache results for improved performance, care must be taken
+ * to use the exact same refinement (JS object) and not merely a clone of it.
+ *
+ * @public
+ */
+export declare function getDescendants<T extends Node>(refinement: Refinement<Node, T>): (node: Node, options?: Node.Traversal) => Sequence<T>;
+/**
+ * Get all descendants of a node that satisfy a given predicate.
+ *
+ * @remarks
+ * In order to properly cache results for improved performance, care must be taken
+ * to use the exact same predicate (JS object) and not merely a clone of it.
+ *
+ * @public
+ */
+export declare function getDescendants(predicate: Predicate<Node>): (node: Node, options?: Node.Traversal) => Sequence<Node>;
+/**
+ * @public
+ */
+export declare const getElementDescendants: (node: Node, options?: Node.Traversal) => Sequence<Element<string>>;
+/**
+ * @public
+ */
+export declare function getInclusiveElementDescendants(node: Element, options?: Node.Traversal): Sequence<Element>;
+//# sourceMappingURL=descendants.d.ts.map

package/dist/node/query/descendants.js

@@ -0,0 +1,26 @@
+import { Cache } from "@siteimprove/alfa-cache";
+import { Node } from "../../node.js";
+import { Element } from "../element.js";
+const _descendantsCache = Cache.empty();
+export function getDescendants(predicate) {
+    return (node, options = Node.Traversal.empty) => {
+        const optionsMap = _descendantsCache
+            .get(predicate, Cache.empty)
+            .get(node, () => []);
+        if (optionsMap[options.value] === undefined) {
+            optionsMap[options.value] = node.descendants(options).filter(predicate);
+        }
+        return optionsMap[options.value];
+    };
+}
+/**
+ * @public
+ */
+export const getElementDescendants = getDescendants(Element.isElement);
+/**
+ * @public
+ */
+export function getInclusiveElementDescendants(node, options = Node.Traversal.empty) {
+    return getElementDescendants(node, options).prepend(node);
+}
+//# sourceMappingURL=descendants.js.map

package/dist/node/query/element-id-map.js

@@ -1,7 +1,7 @@
 import { Cache } from "@siteimprove/alfa-cache";
 import { Map } from "@siteimprove/alfa-map";
 import { Document } from "../document.js";
-import { getElementDescendants } from "./element-descendants.js";
+import { getElementDescendants } from "./descendants.js";
 const elementMapCache = Cache.empty();
 /**
  * Returns a map from id to elements, in the subtree rooted at a given node.

package/dist/node/query/index.d.ts

@@ -1,12 +1,12 @@
-import * as elementDescendants from "./element-descendants.js";
+import * as descendants from "./descendants.js";
 import * as elementIdMap from "./element-id-map.js";
-import * as inclusiveElementDescendants from "./inclusive-element-descendants.js";
 /**
  * @public
  */
 export declare namespace Query {
-    const getElementDescendants: typeof elementDescendants.getElementDescendants;
+    const getDescendants: typeof descendants.getDescendants;
+    const getElementDescendants: (node: import("../../node.js").Node, options?: import("../../node.js").Node.Traversal) => import("@siteimprove/alfa-sequence").Sequence<import("../element.js").Element<string>>;
     const getElementIdMap: typeof elementIdMap.getElementIdMap;
-    const getInclusiveElementDescendants: typeof inclusiveElementDescendants.getInclusiveElementDescendants;
+    const getInclusiveElementDescendants: typeof descendants.getInclusiveElementDescendants;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/node/query/index.js

@@ -1,13 +1,13 @@
-import * as elementDescendants from "./element-descendants.js";
+import * as descendants from "./descendants.js";
 import * as elementIdMap from "./element-id-map.js";
-import * as inclusiveElementDescendants from "./inclusive-element-descendants.js";
 /**
  * @public
  */
 export var Query;
 (function (Query) {
-    Query.getElementDescendants = elementDescendants.getElementDescendants;
+    Query.getDescendants = descendants.getDescendants;
+    Query.getElementDescendants = descendants.getElementDescendants;
     Query.getElementIdMap = elementIdMap.getElementIdMap;
-    Query.getInclusiveElementDescendants = inclusiveElementDescendants.getInclusiveElementDescendants;
+    Query.getInclusiveElementDescendants = descendants.getInclusiveElementDescendants;
 })(Query || (Query = {}));
 //# sourceMappingURL=index.js.map

package/dist/node/shadow.d.ts

@@ -10,7 +10,7 @@ import { Element } from "./element.js";
  * @public
  */
 export declare class Shadow extends Node<"shadow"> {
-    static of(children: Iterable<Node>, style?: Iterable<Sheet>, mode?: Shadow.Mode, externalId?: string, serializationId?: string, extraData?: any): Shadow;
+    static of(children: Iterable<Node>, style?: Iterable<Sheet>, mode?: Shadow.Mode, externalId?: string, internalId?: string, extraData?: any): Shadow;
     static empty(): Shadow;
     private readonly _mode;
     private _host;

package/dist/node/shadow.js

@@ -10,8 +10,8 @@ import { Element } from "./element.js";
  * @public
  */
 export class Shadow extends Node {
-    static of(children, style = [], mode = Shadow.Mode.Open, externalId, serializationId, extraData) {
-        return new Shadow(Array.from(children), Array.from(style), mode, externalId, serializationId, extraData);
+    static of(children, style = [], mode = Shadow.Mode.Open, externalId, internalId, extraData) {
+        return new Shadow(Array.from(children), Array.from(style), mode, externalId, internalId, extraData);
     }
     static empty() {
         return new Shadow([], [], Shadow.Mode.Open);
@@ -19,8 +19,8 @@ export class Shadow extends Node {
     _mode;
     _host = None;
     _style;
-    constructor(children, style, mode, externalId, serializationId, extraData) {
-        super(children, "shadow", externalId, serializationId, extraData);
+    constructor(children, style, mode, externalId, internalId, extraData) {
+        super(children, "shadow", externalId, internalId, extraData);
         this._mode = mode;
         this._style = style;
     }
@@ -107,7 +107,7 @@ export class Shadow extends Node {
      * @internal
      */
     function fromShadow(json, device) {
-        return Trampoline.traverse(json.children ?? [], (child) => Node.fromNode(child, device)).map((children) => Shadow.of(children, json.style.map(Sheet.from), json.mode, json.externalId, json.serializationId));
+        return Trampoline.traverse(json.children ?? [], (child) => Node.fromNode(child, device)).map((children) => Shadow.of(children, json.style.map(Sheet.from), json.mode, json.externalId, json.internalId));
     }
     Shadow.fromShadow = fromShadow;
     /**
@@ -120,7 +120,7 @@ export class Shadow extends Node {
             }
             return Node.cloneNode(child, options, device).map((node) => [node]);
         }).map((children) => {
-            return Shadow.of(Iterable.flatten(children), shadow.style, shadow.mode, shadow.externalId, shadow.extraData, shadow.serializationId);
+            return Shadow.of(Iterable.flatten(children), shadow.style, shadow.mode, shadow.externalId, shadow.extraData, shadow.internalId);
         });
     }
     Shadow.cloneShadow = cloneShadow;

package/dist/node/text.d.ts

@@ -8,7 +8,7 @@ import { Slotable } from "./slotable.js";
  * @public
  */
 export declare class Text extends Node<"text"> implements Slotable {
-    static of(data: string, externalId?: string, serializationId?: string, extraData?: any): Text;
+    static of(data: string, externalId?: string, internalId?: string, extraData?: any): Text;
     static empty(): Text;
     private readonly _data;
     private constructor();

package/dist/node/text.js

@@ -6,15 +6,15 @@ import { Slotable } from "./slotable.js";
  * @public
  */
 export class Text extends Node {
-    static of(data, externalId, serializationId, extraData) {
-        return new Text(data, externalId, serializationId, extraData);
+    static of(data, externalId, internalId, extraData) {
+        return new Text(data, externalId, internalId, extraData);
     }
     static empty() {
         return new Text("");
     }
     _data;
-    constructor(data, externalId, serializationId, extraData) {
-        super([], "text", externalId, serializationId, extraData);
+    constructor(data, externalId, internalId, extraData) {
+        super([], "text", externalId, internalId, extraData);
         this._data = data;
     }
     get data() {
@@ -69,14 +69,14 @@ export class Text extends Node {
      * @internal
      */
     function fromText(json) {
-        return Trampoline.done(Text.of(json.data, json.externalId, undefined, json.serializationId));
+        return Trampoline.done(Text.of(json.data, json.externalId, undefined, json.internalId));
     }
     Text.fromText = fromText;
     /**
      * @internal
      */
     function cloneText(text) {
-        return Trampoline.done(Text.of(text.data, text.externalId, text.extraData, text.serializationId));
+        return Trampoline.done(Text.of(text.data, text.externalId, text.extraData, text.internalId));
     }
     Text.cloneText = cloneText;
 })(Text || (Text = {}));

package/dist/node/type.d.ts

@@ -6,7 +6,7 @@ import { Node } from "../node.js";
  * @public
  */
 export declare class Type<N extends string = string> extends Node<"type"> {
-    static of<N extends string = string>(name: N, publicId?: Option<string>, systemId?: Option<string>, externalId?: string, serializationId?: string, extraData?: any): Type<N>;
+    static of<N extends string = string>(name: N, publicId?: Option<string>, systemId?: Option<string>, externalId?: string, internalId?: string, extraData?: any): Type<N>;
     static empty(): Type;
     private readonly _name;
     private readonly _publicId;

package/dist/node/type.js

@@ -6,8 +6,8 @@ import { Node } from "../node.js";
  * @public
  */
 export class Type extends Node {
-    static of(name, publicId = None, systemId = None, externalId, serializationId, extraData) {
-        return new Type(name, publicId, systemId, externalId, serializationId, extraData);
+    static of(name, publicId = None, systemId = None, externalId, internalId, extraData) {
+        return new Type(name, publicId, systemId, externalId, internalId, extraData);
     }
     static empty() {
         return new Type("html", None, None);
@@ -15,8 +15,8 @@ export class Type extends Node {
     _name;
     _publicId;
     _systemId;
-    constructor(name, publicId, systemId, externalId, serializationId, extraData) {
-        super([], "type", externalId, serializationId, extraData);
+    constructor(name, publicId, systemId, externalId, internalId, extraData) {
+        super([], "type", externalId, internalId, extraData);
         this._name = name;
         this._publicId = publicId;
         this._systemId = systemId;
@@ -60,14 +60,14 @@ export class Type extends Node {
      * @internal
      */
     function fromType(json) {
-        return Trampoline.done(Type.of(json.name, Option.from(json.publicId), Option.from(json.systemId), json.externalId, json.serializationId));
+        return Trampoline.done(Type.of(json.name, Option.from(json.publicId), Option.from(json.systemId), json.externalId, json.internalId));
     }
     Type.fromType = fromType;
     /**
      * @internal
      */
     function cloneType(type) {
-        return Trampoline.done(Type.of(type.name, type.publicId, type.systemId, type.externalId, type.serializationId));
+        return Trampoline.done(Type.of(type.name, type.publicId, type.systemId, type.externalId, type.internalId));
     }
     Type.cloneType = cloneType;
 })(Type || (Type = {}));

package/dist/node.d.ts

@@ -16,7 +16,7 @@ import * as traversal from "./node/traversal.js";
  * @public
  */
 export declare abstract class Node<T extends string = string> extends tree.Node<Node.Traversal.Flag, T> implements earl.Serializable<Node.EARL>, json.Serializable<tree.Node.JSON<T>>, sarif.Serializable<sarif.Location> {
-    protected constructor(children: Array<Node>, type: T, externalId?: string, serializationId?: string, extraData?: any);
+    protected constructor(children: Array<Node>, type: T, externalId?: string, internalId?: string, extraData?: any);
     /**
      * {@link https://dom.spec.whatwg.org/#concept-descendant-text-content}
      */

package/dist/node.js

@@ -14,8 +14,8 @@ import * as traversal from "./node/traversal.js";
  * @public
  */
 export class Node extends tree.Node {
-    constructor(children, type, externalId, serializationId, extraData) {
-        super(children, type, externalId, serializationId, extraData);
+    constructor(children, type, externalId, internalId, extraData) {
+        super(children, type, externalId, internalId, extraData);
     }
     /**
      * {@link https://dom.spec.whatwg.org/#concept-descendant-text-content}

package/package.json

@@ -2,7 +2,7 @@
   "$schema": "http://json.schemastore.org/package",
   "name": "@siteimprove/alfa-dom",
   "homepage": "https://alfa.siteimprove.com",
-  "version": "0.93.7",
+  "version": "0.94.0",
   "license": "MIT",
   "description": "Implementations of the core DOM and CSSOM node types",
   "repository": {
@@ -33,32 +33,32 @@
     "dist/**/*.d.ts"
   ],
   "dependencies": {
-    "@siteimprove/alfa-array": "^0.93.7",
-    "@siteimprove/alfa-cache": "^0.93.7",
-    "@siteimprove/alfa-comparable": "^0.93.7",
-    "@siteimprove/alfa-css": "^0.93.7",
-    "@siteimprove/alfa-css-feature": "^0.93.7",
-    "@siteimprove/alfa-device": "^0.93.7",
-    "@siteimprove/alfa-earl": "^0.93.7",
-    "@siteimprove/alfa-equatable": "^0.93.7",
-    "@siteimprove/alfa-flags": "^0.93.7",
-    "@siteimprove/alfa-iterable": "^0.93.7",
-    "@siteimprove/alfa-json": "^0.93.7",
-    "@siteimprove/alfa-lazy": "^0.93.7",
-    "@siteimprove/alfa-map": "^0.93.7",
-    "@siteimprove/alfa-option": "^0.93.7",
-    "@siteimprove/alfa-predicate": "^0.93.7",
-    "@siteimprove/alfa-rectangle": "^0.93.7",
-    "@siteimprove/alfa-refinement": "^0.93.7",
-    "@siteimprove/alfa-sarif": "^0.93.7",
-    "@siteimprove/alfa-selective": "^0.93.7",
-    "@siteimprove/alfa-sequence": "^0.93.7",
-    "@siteimprove/alfa-string": "^0.93.7",
-    "@siteimprove/alfa-trampoline": "^0.93.7",
-    "@siteimprove/alfa-tree": "^0.93.7"
+    "@siteimprove/alfa-array": "^0.94.0",
+    "@siteimprove/alfa-cache": "^0.94.0",
+    "@siteimprove/alfa-comparable": "^0.94.0",
+    "@siteimprove/alfa-css": "^0.94.0",
+    "@siteimprove/alfa-css-feature": "^0.94.0",
+    "@siteimprove/alfa-device": "^0.94.0",
+    "@siteimprove/alfa-earl": "^0.94.0",
+    "@siteimprove/alfa-equatable": "^0.94.0",
+    "@siteimprove/alfa-flags": "^0.94.0",
+    "@siteimprove/alfa-iterable": "^0.94.0",
+    "@siteimprove/alfa-json": "^0.94.0",
+    "@siteimprove/alfa-lazy": "^0.94.0",
+    "@siteimprove/alfa-map": "^0.94.0",
+    "@siteimprove/alfa-option": "^0.94.0",
+    "@siteimprove/alfa-predicate": "^0.94.0",
+    "@siteimprove/alfa-rectangle": "^0.94.0",
+    "@siteimprove/alfa-refinement": "^0.94.0",
+    "@siteimprove/alfa-sarif": "^0.94.0",
+    "@siteimprove/alfa-selective": "^0.94.0",
+    "@siteimprove/alfa-sequence": "^0.94.0",
+    "@siteimprove/alfa-string": "^0.94.0",
+    "@siteimprove/alfa-trampoline": "^0.94.0",
+    "@siteimprove/alfa-tree": "^0.94.0"
   },
   "devDependencies": {
-    "@siteimprove/alfa-test": "^0.93.7",
+    "@siteimprove/alfa-test": "^0.94.0",
     "@types/jsdom": "^21.1.6",
     "jsdom": "^25.0.0"
   },

package/dist/node/query/element-descendants.d.ts

@@ -1,8 +0,0 @@
-import type { Sequence } from "@siteimprove/alfa-sequence";
-import { Node } from "../../node.js";
-import { Element } from "../element.js";
-/**
- * @public
- */
-export declare function getElementDescendants(node: Node, options?: Node.Traversal): Sequence<Element>;
-//# sourceMappingURL=element-descendants.d.ts.map

package/dist/node/query/element-descendants.js

@@ -1,17 +0,0 @@
-import { Cache } from "@siteimprove/alfa-cache";
-import { Node } from "../../node.js";
-import { Element } from "../element.js";
-const _elementDescendantsCache = Cache.empty();
-/**
- * @public
- */
-export function getElementDescendants(node, options = Node.Traversal.empty) {
-    const optionsMap = _elementDescendantsCache.get(node, () => []);
-    if (optionsMap[options.value] === undefined) {
-        optionsMap[options.value] = node
-            .descendants(options)
-            .filter(Element.isElement);
-    }
-    return optionsMap[options.value];
-}
-//# sourceMappingURL=element-descendants.js.map

package/dist/node/query/inclusive-element-descendants.d.ts

@@ -1,8 +0,0 @@
-import type { Sequence } from "@siteimprove/alfa-sequence";
-import { Node } from "../../node.js";
-import type { Element } from "../element.js";
-/**
- * @public
- */
-export declare function getInclusiveElementDescendants(node: Element, options?: Node.Traversal): Sequence<Element>;
-//# sourceMappingURL=inclusive-element-descendants.d.ts.map

package/dist/node/query/inclusive-element-descendants.js

@@ -1,9 +0,0 @@
-import { Node } from "../../node.js";
-import { getElementDescendants } from "./element-descendants.js";
-/**
- * @public
- */
-export function getInclusiveElementDescendants(node, options = Node.Traversal.empty) {
-    return getElementDescendants(node, options).prepend(node);
-}
-//# sourceMappingURL=inclusive-element-descendants.js.map