@siteimprove/alfa-dom 0.97.0 → 0.99.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @siteimprove/alfa-dom
 
+## 0.99.0
+
+### Minor Changes
+
+- **Added:** The `<search>` element is now correctly handled. ([#1759](https://github.com/Siteimprove/alfa/pull/1759))
+
+## 0.98.0
+
+### Minor Changes
+
+- **Changed:** Node serialization with `Low` verbosity now also include the `Node#path`. ([#1748](https://github.com/Siteimprove/alfa/pull/1748))
+
+### Patch Changes
+
+- **Changed:** Classes that do not implement the Singleton pattern now have `protected` constructor and can be extended. ([#1735](https://github.com/Siteimprove/alfa/pull/1735))
+
 ## 0.97.0
 
 ## 0.96.0

package/dist/node/attribute.d.ts

@@ -17,7 +17,7 @@ export declare class Attribute<N extends string = string> extends Node<"attribut
     private readonly _name;
     private readonly _value;
     private _owner;
-    private constructor();
+    protected constructor(namespace: Option<Namespace>, prefix: Option<string>, name: N, value: string, externalId?: string, internalId?: string, extraData?: any);
     get namespace(): Option<Namespace>;
     get prefix(): Option<string>;
     get name(): N | Lowercase<N>;

package/dist/node/comment.d.ts

@@ -8,7 +8,7 @@ export declare class Comment extends Node<"comment"> {
     static of(data: string, externalId?: string, internalId?: string, extraData?: any): Comment;
     static empty(): Comment;
     private readonly _data;
-    private constructor();
+    protected constructor(data: string, externalId?: string, internalId?: string, extraData?: any);
     get data(): string;
     /**
      * @internal

package/dist/node/document.d.ts

@@ -15,7 +15,7 @@ export declare class Document extends Node<"document"> {
     static empty(): Document;
     private readonly _style;
     private _frame;
-    private constructor();
+    protected constructor(children: Array<Node>, style: Iterable<Sheet>, externalId?: string, internalId?: string, extraData?: any);
     get style(): Iterable<Sheet>;
     get frame(): Option<Element>;
     parent(options?: Node.Traversal): Option<Node>;

package/dist/node/element.d.ts

@@ -31,7 +31,7 @@ export declare class Element<N extends string = string> extends Node<"element">
     private readonly _id;
     private readonly _classes;
     private readonly _boxes;
-    private constructor();
+    protected constructor(namespace: Option<Namespace>, prefix: Option<string>, name: N, attributes: Array<Attribute>, children: Array<Node>, style: Option<Block>, box: Option<Rectangle>, device: Option<Device>, externalId?: string, internalId?: string, extraData?: any);
     get namespace(): Option<Namespace>;
     get prefix(): Option<string>;
     get name(): N;

package/dist/node/fragment.d.ts

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

package/dist/node/shadow.d.ts

@@ -15,7 +15,7 @@ export declare class Shadow extends Node<"shadow"> {
     private readonly _mode;
     private _host;
     private readonly _style;
-    private constructor();
+    protected constructor(children: Array<Node>, style: Array<Sheet>, mode: Shadow.Mode, externalId?: string, internalId?: string, extraData?: any);
     get mode(): Shadow.Mode;
     get host(): Option<Element>;
     get style(): Iterable<Sheet>;

package/dist/node/text.d.ts

@@ -11,7 +11,7 @@ export declare class Text extends Node<"text"> implements Slotable {
     static of(data: string, externalId?: string, internalId?: string, extraData?: any): Text;
     static empty(): Text;
     private readonly _data;
-    private constructor();
+    protected constructor(data: string, externalId?: string, internalId?: string, extraData?: any);
     get data(): string;
     assignedSlot(): Option<Slot>;
     /**

package/dist/node/type.d.ts

@@ -11,7 +11,7 @@ export declare class Type<N extends string = string> extends Node<"type"> {
     private readonly _name;
     private readonly _publicId;
     private readonly _systemId;
-    private constructor();
+    protected constructor(name: N, publicId: Option<string>, systemId: Option<string>, externalId?: string, internalId?: string, extraData?: any);
     get name(): N;
     get publicId(): Option<string>;
     get systemId(): Option<string>;

package/dist/node.d.ts

@@ -1,12 +1,13 @@
 import type { Device } from "@siteimprove/alfa-device";
 import { Flags } from "@siteimprove/alfa-flags";
+import { Serializable } from "@siteimprove/alfa-json";
 import { Option } from "@siteimprove/alfa-option";
 import type { Predicate } from "@siteimprove/alfa-predicate";
 import type { Refinement } from "@siteimprove/alfa-refinement";
 import { Sequence } from "@siteimprove/alfa-sequence";
 import type { Trampoline } from "@siteimprove/alfa-trampoline";
 import type * as earl from "@siteimprove/alfa-earl";
-import type * as json from "@siteimprove/alfa-json";
+import * as json from "@siteimprove/alfa-json";
 import type * as sarif from "@siteimprove/alfa-sarif";
 import * as tree from "@siteimprove/alfa-tree";
 import { Attribute, Comment, Document, Element, Fragment, Shadow, Text, Type } from "./index.js";
@@ -40,6 +41,7 @@ export declare abstract class Node<T extends string = string> extends tree.Node<
     path(options?: Node.Traversal): string;
     equals(value: Node): boolean;
     equals(value: unknown): value is this;
+    toJSON(options?: Serializable.Options): Node.JSON<T>;
     toEARL(): Node.EARL;
     toSARIF(): sarif.Location;
 }
@@ -80,6 +82,7 @@ export interface Node {
  */
 export declare namespace Node {
     interface JSON<T extends string = string> extends tree.Node.JSON<T> {
+        path?: string;
     }
     interface SerializationOptions extends json.Serializable.Options {
         device?: Device;

package/dist/node.js

@@ -1,11 +1,13 @@
 import { Cache } from "@siteimprove/alfa-cache";
 import { Comparable, Comparison, } from "@siteimprove/alfa-comparable";
 import { Flags } from "@siteimprove/alfa-flags";
+import { Serializable } from "@siteimprove/alfa-json";
 import { Lazy } from "@siteimprove/alfa-lazy";
 import { Option } from "@siteimprove/alfa-option";
 import { Selective } from "@siteimprove/alfa-selective";
 import { Sequence } from "@siteimprove/alfa-sequence";
 import { String } from "@siteimprove/alfa-string";
+import * as json from "@siteimprove/alfa-json";
 import * as tree from "@siteimprove/alfa-tree";
 import { Attribute, Comment, Document, Element, Fragment, Shadow, Slot, Slotable, Text, Type, } from "./index.js";
 import * as predicate from "./node/predicate.js";
@@ -107,10 +109,12 @@ export class Node extends tree.Node {
          * shadow tree or content document.
          *
          * @remarks
-         * It is important that this expansion happens **after** sorting by tabindex
+         * It is important that this expansion happens **after** sorting by
+         *   tabindex
          * since shadow DOM and content documents build their own sequential focus
-         * order that is inserted as-is in the light tree or parent browsing context.
-         * That is, a tabindex of 1 in a shadow tree or content document does
+         * order that is inserted as-is in the light tree or parent browsing
+         *   context. That is, a tabindex of 1 in a shadow tree or content document
+         *   does
          * **not** come before a tabindex of 2 in the main document.
          */
         function expand([element, tabIndex]) {
@@ -190,6 +194,16 @@ export class Node extends tree.Node {
     equals(value) {
         return value === this;
     }
+    toJSON(options) {
+        const verbosity = options?.verbosity ?? json.Serializable.Verbosity.Medium;
+        return {
+            ...super.toJSON(options),
+            ...(json.Serializable.Verbosity.Minimal < verbosity &&
+                verbosity < json.Serializable.Verbosity.Medium
+                ? { path: this.path(Node.composedNested) }
+                : {}),
+        };
+    }
     toEARL() {
         return {
             "@context": {

package/dist/style/block.d.ts

@@ -10,7 +10,7 @@ import { Declaration } from "./declaration.js";
 export declare class Block implements Iterable<Declaration>, Equatable, Serializable {
     static of(declarations: Iterable<Declaration>): Block;
     private _declarations;
-    private constructor();
+    protected constructor(declarations: Array<Declaration>);
     get declarations(): Iterable<Declaration>;
     get size(): number;
     isEmpty(): boolean;

package/dist/style/declaration.d.ts

@@ -28,7 +28,7 @@ export declare class Declaration implements Equatable, Serializable {
      * Only one of _parent and _owner should be Some.
      */
     private _owner;
-    private constructor();
+    protected constructor(name: string, value: string, important: boolean);
     get name(): string;
     get value(): string;
     get important(): boolean;

package/dist/style/rule/font-face.d.ts

@@ -8,7 +8,7 @@ import { Rule } from "../rule.js";
 export declare class FontFaceRule extends Rule<"font-face"> {
     static of(declarations: Iterable<Declaration>): FontFaceRule;
     private readonly _style;
-    private constructor();
+    protected constructor(declarations: Array<Declaration>);
     get style(): Block;
     toJSON(): FontFaceRule.JSON;
     toString(): string;

package/dist/style/rule/import.d.ts

@@ -17,7 +17,7 @@ export declare class ImportRule extends ConditionRule<"import"> {
     private readonly _supportCondition;
     private readonly _supportQuery;
     private _layer;
-    private constructor();
+    protected constructor(href: string, sheet: Sheet, mediaCondition: Option<string>, supportCondition: Option<string>, layer: Option<string>);
     get supportCondition(): Option<string>;
     get mediaQueries(): Feature.Media.List;
     get supportQuery(): Option<Option<Feature.Supports.Query>>;

package/dist/style/rule/keyframe.d.ts

@@ -9,7 +9,7 @@ export declare class KeyframeRule extends Rule<"keyframe"> {
     static of(key: string, declarations: Iterable<Declaration>): KeyframeRule;
     private readonly _key;
     private readonly _style;
-    private constructor();
+    protected constructor(key: string, declarations: Array<Declaration>);
     get key(): string;
     get style(): Block;
     toJSON(): KeyframeRule.JSON;

package/dist/style/rule/keyframes.d.ts

@@ -7,7 +7,7 @@ import { GroupingRule } from "./grouping.js";
 export declare class KeyframesRule extends GroupingRule<"keyframes"> {
     static of(name: string, rules: Iterable<Rule>): KeyframesRule;
     private readonly _name;
-    private constructor();
+    protected constructor(name: string, rules: Array<Rule>);
     get name(): string;
     toJSON(): KeyframesRule.JSON;
     toString(): string;

package/dist/style/rule/layer.d.ts

@@ -24,7 +24,7 @@ export declare namespace Layer {
     class StatementRule extends Rule<"layer-statement"> {
         static of(layers: Iterable<string>): StatementRule;
         private readonly _layers;
-        private constructor();
+        protected constructor(layers: Array<string>);
         get layers(): Iterable<string>;
         toJSON(): StatementRule.JSON;
         toString(): string;
@@ -44,7 +44,7 @@ export declare namespace Layer {
     class BlockRule extends GroupingRule<"layer-block"> {
         static of(rules: Iterable<Rule>, layer?: string | null): BlockRule;
         private readonly _layer;
-        private constructor();
+        protected constructor(layer: Option<string>, rules: Array<Rule>);
         get layer(): Option<string>;
         equals(value: unknown): value is this;
         toJSON(): BlockRule.JSON;

package/dist/style/rule/media.d.ts

@@ -11,7 +11,7 @@ import { ConditionRule } from "./condition.js";
 export declare class MediaRule extends ConditionRule<"media"> {
     static of(condition: string, rules: Iterable<Rule>): MediaRule;
     private readonly _queries;
-    private constructor();
+    protected constructor(condition: string, rules: Array<Rule>);
     get queries(): Feature.Media.List;
     toJSON(): MediaRule.JSON;
     toString(): string;

package/dist/style/rule/namespace.d.ts

@@ -8,7 +8,7 @@ export declare class NamespaceRule extends Rule<"namespace"> {
     static of(namespace: string, prefix: Option<string>): NamespaceRule;
     private readonly _namespace;
     private readonly _prefix;
-    private constructor();
+    protected constructor(namespace: string, prefix: Option<string>);
     get namespace(): string;
     get prefix(): Option<string>;
     toJSON(): NamespaceRule.JSON;

package/dist/style/rule/page.d.ts

@@ -9,7 +9,7 @@ export declare class PageRule extends Rule<"page"> {
     static of(selector: string, declarations: Iterable<Declaration>): PageRule;
     private readonly _selector;
     private readonly _style;
-    private constructor();
+    protected constructor(selector: string, declarations: Array<Declaration>);
     get selector(): string;
     get style(): Block;
     toJSON(): PageRule.JSON;

package/dist/style/rule/style.d.ts

@@ -10,7 +10,7 @@ export declare class StyleRule extends Rule<"style"> {
     private readonly _selector;
     private readonly _style;
     private readonly _hint;
-    private constructor();
+    protected constructor(selector: string, declarations: Array<Declaration>, hint: boolean);
     get selector(): string;
     get style(): Block;
     get hint(): boolean;

package/dist/style/rule/supports.d.ts

@@ -11,7 +11,7 @@ import type { Predicate } from "@siteimprove/alfa-predicate";
 export declare class SupportsRule extends ConditionRule<"supports"> {
     static of(condition: string, rules: Iterable<Rule>): SupportsRule;
     private readonly _query;
-    private constructor();
+    protected constructor(condition: string, rules: Array<Rule>);
     get query(): Option<Feature.Supports.Query>;
     toJSON(): SupportsRule.JSON;
     toString(): string;

package/dist/style/sheet.d.ts

@@ -12,7 +12,7 @@ export declare class Sheet implements Equatable, Serializable {
     private _rules;
     private readonly _disabled;
     private readonly _condition;
-    private constructor();
+    protected constructor(rules: Array<Rule>, disabled: boolean, condition: Option<string>);
     get rules(): Iterable<Rule>;
     get disabled(): boolean;
     get condition(): Option<string>;

package/package.json

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