wtr-a11y-tree-plugin 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Serhii Kulykov <iamkulykov@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,156 @@
-# Temporary Holding Version
+# wtr-a11y-tree-plugin
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Read the Chrome accessibility tree in Web Test Runner tests.
+
+The package has three parts:
+
+- Server plugin that reads a11y tree through the Chrome DevTools Protocol.
+- `getA11yTree()` browser command that returns the tree of an element.
+- Chai assertions: `matchA11yTree()` and `equalA11yTreeSnapshot()`.
+
+## Install
+
+```sh
+npm install --save-dev wtr-a11y-tree-plugin
+```
+
+Pre-requisites: `@web/test-runner` and `@web/test-runner-playwright` (Chrome only).
+
+## Configuration
+
+Add the plugin to the Web Test Runner config:
+
+```js
+import { playwrightLauncher } from '@web/test-runner-playwright';
+import { a11yTreePlugin } from 'wtr-a11y-tree-plugin';
+
+export default {
+  nodeResolve: true,
+  browsers: [playwrightLauncher({ product: 'chromium' })],
+  plugins: [a11yTreePlugin()],
+};
+```
+
+Set `channel: 'chrome'` to use local Chrome e.g. in GitHub Actions:
+
+```js
+import { playwrightLauncher } from '@web/test-runner-playwright';
+import { a11yTreePlugin } from 'wtr-a11y-tree-plugin';
+
+export default {
+  nodeResolve: true,
+  browsers: [
+    playwrightLauncher({
+      product: 'chromium',
+      launchOptions: {
+        channel: 'chrome',
+        headless: true,
+      },
+    }),
+  ],
+  plugins: [a11yTreePlugin()],
+};
+```
+
+Note: snapshots can differ depending on the Chrome or Playwright Chromium version.
+
+## Getting a11y tree
+
+Call `getA11yTree()` with an element. The result is a list of `A11yNode` objects.
+
+```js
+import { getA11yTree } from 'wtr-a11y-tree-plugin/browser';
+
+const tree = await getA11yTree(document.querySelector('my-button'));
+```
+
+Each node has these fields:
+
+- `role`: the accessibility role.
+- `name`: the accessible name.
+- `value`: the value, when there is one.
+- `description`: the accessible description, when there is one.
+- `states`: the states, such as `expanded` or `pressed`.
+- `relations`: the targets of `controls`, `owns` and similar relations, as `{ role, name }`.
+- `children`: the child nodes.
+
+Text nodes have the role `text` and only a name.
+
+## Chai assertions
+
+Register the plugin with `chai.use()`. The plugin does not import chai. It uses the chai instance that you pass.
+
+```js
+import * as chai from 'chai';
+import { chaiA11yTree } from 'wtr-a11y-tree-plugin/chai';
+
+chai.use(chaiA11yTree);
+const { expect } = chai;
+
+it('exposes the combobox', async () => {
+  await expect(element).to.matchA11yTree(`
+    - combobox "Size" [expanded]:
+      - /value: Medium
+  `);
+});
+
+it('keeps the tree', async () => {
+  await expect(element).to.equalA11yTreeSnapshot();
+});
+```
+
+TypeScript users need `@types/chai`. The `wtr-a11y-tree-plugin/chai` module adds both methods to `Chai.Assertion`.
+
+## Snapshot format
+
+The format follows Playwright aria snapshots. Each line is a node.
+
+```text
+- text: Size
+- combobox "Size" [haspopup=listbox, expanded]:
+  - /value: Medium
+  - /activedescendant: option "Medium"
+  - /controls: listbox "Size"
+- listbox "Size" [orientation=vertical]:
+  - option "Small"
+  - option "Medium" [selected]
+```
+
+The rules are:
+
+- **Role and name**: A node starts with its role. The name follows in double quotes.
+- **States**: States appear in square brackets. A true state prints its lowercase name. Other states print as `name=value`.
+- **False states**: Only `expanded=false` and `pressed=false` print. Other false states do not.
+- **Value**: A value prints as `/value`. A single text child prints as an inline value.
+- **Description**: A description prints as `/description`.
+- **Relations**: Each relation target prints as `/relation: role "name"`.
+
+## Matching rules
+
+`matchA11yTree()` checks that the expected tree is a subset of the actual tree. It does not require an exact match.
+
+- **Subset**: The actual tree may have more nodes, states and properties.
+- **Order**: Expected siblings must appear in the same order as in the actual tree.
+- **Depth**: The first level of the expected tree may match nodes at any depth. Nested levels must match children.
+- **Omitted parts**: A name or value that you do not write matches anything.
+
+When the match fails, the assertion error holds the serialized actual tree. Test reporters show the difference.
+
+## Other exports
+
+The `wtr-a11y-tree-plugin/format` module runs in the browser and in Node. It exports these functions:
+
+- `serializeA11yTree(nodes)`: converts `A11yNode[]` to the snapshot text.
+- `parseDisplayTree(text)`: parses the snapshot text.
+- `matchDisplayList(expected, actual, deep)`: applies the matching rules.
+- `dedent(text)`: removes the common indentation of a template literal.
+
+## Limitations
+
+- Works in Playwright Chromium and Chrome only. Puppeteer and `@web/test-runner-chrome` are not supported.
+- `equalA11yTreeSnapshot()` works in Mocha tests only. It uses the snapshot support of Web Test Runner.
+- Pass `--update-snapshots` to Web Test Runner to rewrite saved snapshots.
+
+## License
+
+MIT

package/dist/browser.d.ts

@@ -0,0 +1,15 @@
+import type { A11yNode } from './types.ts';
+export type { A11yNode } from './types.ts';
+declare global {
+    var __a11yTreeTargets: Map<string, Element> | undefined;
+}
+/**
+ * Returns the Chromium accessibility tree of an element: the roles, names,
+ * descriptions, values, states and relations of the element and its
+ * descendants, including shadow DOM and slotted content.
+ *
+ * @example
+ * const tree = await getA11yTree(document.querySelector('vaadin-text-field'));
+ */
+export declare function getA11yTree(element: Element): Promise<A11yNode[]>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,YAAY,CAAC;AAE5D,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACzD;AAID;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAWvE"}

package/dist/browser.js

@@ -0,0 +1,28 @@
+/**
+ * `getA11yTree()` is copied from vaadin/web-components test/test-runner-commands/index.js
+ * on proto/aria-snapshot at a9833531f6.
+ */
+import { executeServerCommand } from '@web/test-runner-commands';
+let a11yTreeId = 0;
+/**
+ * Returns the Chromium accessibility tree of an element: the roles, names,
+ * descriptions, values, states and relations of the element and its
+ * descendants, including shadow DOM and slotted content.
+ *
+ * @example
+ * const tree = await getA11yTree(document.querySelector('vaadin-text-field'));
+ */
+export async function getA11yTree(element) {
+    a11yTreeId += 1;
+    const id = `${a11yTreeId}`;
+    // Commands can only receive JSON, so the server reads the element from a global map.
+    globalThis.__a11yTreeTargets ||= new Map();
+    globalThis.__a11yTreeTargets.set(id, element);
+    try {
+        return (await executeServerCommand('get-a11y-tree', { id }));
+    }
+    finally {
+        globalThis.__a11yTreeTargets.delete(id);
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AASjE,IAAI,UAAU,GAAG,CAAC,CAAC;AAEnB;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAgB;IAChD,UAAU,IAAI,CAAC,CAAC;IAChB,MAAM,EAAE,GAAG,GAAG,UAAU,EAAE,CAAC;IAC3B,qFAAqF;IACrF,UAAU,CAAC,iBAAiB,KAAK,IAAI,GAAG,EAAE,CAAC;IAC3C,UAAU,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,oBAAoB,CAAC,eAAe,EAAE,EAAE,EAAE,EAA4B,CAAC,CAAe,CAAC;IACvG,CAAC;YAAS,CAAC;QACT,UAAU,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/chai.d.ts

@@ -0,0 +1,27 @@
+/// <reference types="chai" preserve="true" />
+declare global {
+    namespace Chai {
+        interface Assertion {
+            /**
+             * Compares the Chromium accessibility tree of an element with the one saved for the current test.
+             */
+            equalA11yTreeSnapshot(): Promise<void>;
+            /**
+             * Checks that the Chromium accessibility tree of an element contains the nodes of the expected tree.
+             */
+            matchA11yTree(expected: string): Promise<void>;
+        }
+    }
+}
+/**
+ * Registers `matchA11yTree()` and `equalA11yTreeSnapshot()`. It does not
+ * import chai: `chai.use()` passes the instance of the consumer.
+ *
+ * @example
+ * import * as chai from 'chai';
+ * import { chaiA11yTree } from 'wtr-a11y-tree-plugin/chai';
+ *
+ * chai.use(chaiA11yTree);
+ */
+export declare const chaiA11yTree: Chai.ChaiPlugin;
+//# sourceMappingURL=chai.d.ts.map

package/dist/chai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chai.d.ts","sourceRoot":"","sources":["../src/chai.ts"],"names":[],"mappings":";AAgBA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,IAAI,CAAC;QACb,UAAU,SAAS;YACjB;;eAEG;YACH,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;YAEvC;;eAEG;YACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;SAChD;KACF;CACF;AAwDD;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,EAAE,IAAI,CAAC,UAG/B,CAAC"}

package/dist/chai.js

@@ -0,0 +1,65 @@
+/**
+ * Copied from vaadin/web-components test/plugins/index.js and index.d.ts
+ * on proto/aria-snapshot at a9833531f6.
+ */
+/// <reference types="chai" preserve="true" />
+import { getSnapshot, getSnapshotConfig, saveSnapshot } from '@web/test-runner-commands';
+import { getA11yTree } from "./browser.js";
+import { dedent, matchDisplayList, parseDisplayTree, serializeA11yTree, serializeDisplayTree, toDisplayTree, } from "./format.js";
+/**
+ * Adds `matchA11yTree(expected)`, which checks that the Chromium accessibility
+ * tree of an element contains the nodes of the expected tree. The expected tree
+ * uses the snapshot format and lists only what the test cares about.
+ */
+const chaiA11yTreeMatch = (chai, utils) => {
+    async function matchA11yTree(expected) {
+        const element = utils.flag(this, 'object');
+        const actual = toDisplayTree(await getA11yTree(element));
+        if (!matchDisplayList(parseDisplayTree(expected), actual, true)) {
+            throw new chai.AssertionError('expected accessibility tree to contain the expected nodes', { actual: serializeDisplayTree(actual), expected: dedent(expected), showDiff: true }, utils.flag(this, 'ssfi'));
+        }
+    }
+    utils.addMethod(chai.Assertion.prototype, 'matchA11yTree', matchA11yTree);
+};
+/**
+ * Adds `equalA11yTreeSnapshot()`, which compares the Chromium accessibility
+ * tree of an element with the one saved for the current test, and saves it
+ * when there is none or when the test runner is called with `--update-snapshots`.
+ */
+const chaiA11yTreeSnapshot = (chai, utils) => {
+    async function equalA11yTreeSnapshot() {
+        const runner = globalThis.__WTR_MOCHA_RUNNER__;
+        if (!runner) {
+            throw new Error('equalA11yTreeSnapshot() works only in Mocha tests run by Web Test Runner.');
+        }
+        const element = utils.flag(this, 'object');
+        const name = runner.test.titlePath().join(' ');
+        const snapshot = serializeA11yTree(await getA11yTree(element));
+        const currentSnapshot = await getSnapshot({ name });
+        const config = await getSnapshotConfig();
+        if (currentSnapshot && !config.updateSnapshots) {
+            if (currentSnapshot !== snapshot) {
+                throw new chai.AssertionError(`Accessibility tree snapshot ${name} does not match the saved snapshot on disk`, { actual: snapshot, expected: currentSnapshot, showDiff: true }, utils.flag(this, 'ssfi'));
+            }
+        }
+        else if (currentSnapshot !== snapshot) {
+            await saveSnapshot({ name, content: snapshot });
+        }
+    }
+    utils.addMethod(chai.Assertion.prototype, 'equalA11yTreeSnapshot', equalA11yTreeSnapshot);
+};
+/**
+ * Registers `matchA11yTree()` and `equalA11yTreeSnapshot()`. It does not
+ * import chai: `chai.use()` passes the instance of the consumer.
+ *
+ * @example
+ * import * as chai from 'chai';
+ * import { chaiA11yTree } from 'wtr-a11y-tree-plugin/chai';
+ *
+ * chai.use(chaiA11yTree);
+ */
+export const chaiA11yTree = (chai, utils) => {
+    chaiA11yTreeMatch(chai, utils);
+    chaiA11yTreeSnapshot(chai, utils);
+};
+//# sourceMappingURL=chai.js.map

package/dist/chai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chai.js","sourceRoot":"","sources":["../src/chai.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,8CAA8C;AAC9C,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,MAAM,EACN,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,GACd,MAAM,aAAa,CAAC;AAkBrB;;;;GAIG;AACH,MAAM,iBAAiB,GAAoB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;IACzD,KAAK,UAAU,aAAa,CAA6B,QAAgB;QACvE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,IAAI,CAAC,cAAc,CAC3B,2DAA2D,EAC3D,EAAE,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EACpF,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CACzB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;AAC5E,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,oBAAoB,GAAoB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;IAC5D,KAAK,UAAU,qBAAqB;QAClC,MAAM,MAAM,GAAI,UAA6E,CAAC,oBAAoB,CAAC;QACnH,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;QAC/F,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/D,MAAM,eAAe,GAAG,MAAM,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,iBAAiB,EAAE,CAAC;QAEzC,IAAI,eAAe,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAC/C,IAAI,eAAe,KAAK,QAAQ,EAAE,CAAC;gBACjC,MAAM,IAAI,IAAI,CAAC,cAAc,CAC3B,+BAA+B,IAAI,4CAA4C,EAC/E,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,EAC/D,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CACzB,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,IAAI,eAAe,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,uBAAuB,EAAE,qBAAqB,CAAC,CAAC;AAC5F,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAoB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;IAC3D,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC,CAAC"}

package/dist/format.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Copied from vaadin/web-components test/plugins/index.js
+ * on proto/aria-snapshot at a9833531f6.
+ */
+import type { A11yNode } from './types.ts';
+export type DisplayNode = {
+    role: string;
+    name?: string;
+    states: string[];
+    value?: string;
+    props: Array<[string, string]>;
+    children: DisplayNode[];
+};
+/**
+ * Converts the tree returned by `getA11yTree()` into the nodes that the
+ * snapshot prints: formatted states, descriptions and relations as properties,
+ * and a single text child as the inline value.
+ */
+export declare const toDisplayTree: (nodes: A11yNode[]) => DisplayNode[];
+/**
+ * Serializes an accessibility tree to YAML in the format of Playwright aria
+ * snapshots. Descriptions and relations are printed as `/description` and
+ * `/<relation>` properties, like `/url` in Playwright.
+ */
+export declare const serializeDisplayTree: (nodes: DisplayNode[], indent?: string) => string;
+export declare const serializeA11yTree: (nodes: A11yNode[]) => string;
+/**
+ * Removes the common indentation and the blank first and last lines of a
+ * template literal.
+ */
+export declare const dedent: (text: string) => string;
+/**
+ * Parses a tree in the snapshot format into display nodes. Values that are
+ * not written, such as a missing name, are left undefined and match anything.
+ */
+export declare const parseDisplayTree: (text: string) => DisplayNode[];
+/**
+ * Checks that the expected nodes appear in the actual nodes in the same order.
+ * Other nodes, states and properties are allowed. With `deep`, an expected node
+ * can match an actual node at any depth, which is used for the top level only,
+ * so that the expected tree can start below containers.
+ */
+export declare function matchDisplayList(expected: DisplayNode[], actual: DisplayNode[], deep?: boolean): boolean;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/B,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB,CAAC;AAiCF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,QAAQ,EAAE,KAAG,WAAW,EA4BzD,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,WAAW,EAAE,EAAE,eAAW,KAAG,MAuB1D,CAAC;AAEhB,eAAO,MAAM,iBAAiB,GAAI,OAAO,QAAQ,EAAE,KAAG,MAAoD,CAAC;AAK3G;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,KAAG,MAIrC,CAAC;AAQF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,WAAW,EA2C1D,CAAC;AAmBF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,IAAI,UAAQ,GAAG,OAAO,CAoBtG"}

package/dist/format.js

@@ -0,0 +1,182 @@
+// States printed even when `false`, as `false` differs from a missing state.
+const A11Y_FALSE_STATES = new Set(['expanded', 'pressed']);
+// Snapshots are stored in template literals, which turn escape sequences
+// into characters on read, so quote without escaping.
+const quote = (text) => `"${text}"`;
+const formatText = (text) => (/^[\w$.,!?()•@ ]+$/u.test(text) && !/^\d/u.test(text) ? text : quote(text));
+const formatStates = (node) => Object.entries(node.states || {})
+    .map(([key, value]) => {
+    if (value === true || value === 'true') {
+        return key.toLowerCase();
+    }
+    if (value === false || value === 'false') {
+        return A11Y_FALSE_STATES.has(key) ? `${key}=false` : null;
+    }
+    if (value === '' || (key === 'valuetext' && String(value) === node.value)) {
+        return null;
+    }
+    return `${key.toLowerCase()}=${value}`;
+})
+    .filter((state) => state !== null);
+/**
+ * Removes text that repeats the parent name, such as the label of a button.
+ */
+const normalizeChildren = (children, parentName) => (children || []).filter((child) => !(child.role === 'text' && child.name === parentName));
+/**
+ * Converts the tree returned by `getA11yTree()` into the nodes that the
+ * snapshot prints: formatted states, descriptions and relations as properties,
+ * and a single text child as the inline value.
+ */
+export const toDisplayTree = (nodes) => normalizeChildren(nodes).map((node) => {
+    if (node.role === 'text') {
+        return { role: 'text', name: node.name, states: [], props: [], children: [] };
+    }
+    let children = normalizeChildren(node.children, node.name);
+    let value = node.value;
+    if (value === undefined && children.length === 1 && children[0].role === 'text') {
+        value = children[0].name;
+        children = [];
+    }
+    const props = [];
+    if (node.description) {
+        props.push(['description', node.description]);
+    }
+    Object.entries(node.relations || {}).forEach(([key, targets]) => {
+        targets.forEach(({ role, name }) => {
+            props.push([key, `${role}${name ? ` ${quote(name)}` : ''}`]);
+        });
+    });
+    return {
+        role: node.role,
+        name: node.name,
+        states: formatStates(node),
+        value,
+        props,
+        children: toDisplayTree(children),
+    };
+});
+/**
+ * Serializes an accessibility tree to YAML in the format of Playwright aria
+ * snapshots. Descriptions and relations are printed as `/description` and
+ * `/<relation>` properties, like `/url` in Playwright.
+ */
+export const serializeDisplayTree = (nodes, indent = '') => nodes
+    .map((node) => {
+    if (node.role === 'text') {
+        return `${indent}- text: ${formatText(node.name)}`;
+    }
+    let line = `${indent}- ${node.role}`;
+    if (node.name) {
+        line += ` ${quote(node.name)}`;
+    }
+    if (node.states.length) {
+        line += ` [${node.states.join(', ')}]`;
+    }
+    const props = node.props.map(([key, value]) => `${indent}  - /${key}: ${key === 'description' ? formatText(value) : value}`);
+    const nested = node.children.length ? serializeDisplayTree(node.children, `${indent}  `) : '';
+    if (!props.length && !nested) {
+        return node.value === undefined ? line : `${line}: ${formatText(node.value)}`;
+    }
+    const head = node.value === undefined ? `${line}:` : `${line}:\n${indent}  - /value: ${formatText(node.value)}`;
+    return [head, ...props, nested].filter(Boolean).join('\n');
+})
+    .join('\n');
+export const serializeA11yTree = (nodes) => serializeDisplayTree(toDisplayTree(nodes));
+const unquote = (text) => text.length > 1 && text.startsWith('"') && text.endsWith('"') ? text.slice(1, -1) : text;
+/**
+ * Removes the common indentation and the blank first and last lines of a
+ * template literal.
+ */
+export const dedent = (text) => {
+    const lines = text.replace(/^\s*\n|\n\s*$/gu, '').split('\n');
+    const indent = Math.min(...lines.filter((line) => line.trim()).map((line) => line.match(/^ */u)[0].length));
+    return lines.map((line) => line.slice(indent)).join('\n');
+};
+const NODE_PATTERN = /^(?<role>[\w-]+)(?: "(?<name>[^"]*)")?(?: \[(?<states>[^\]]*)\])?(?::(?: (?<value>.+))?)?$/u;
+/**
+ * Parses a tree in the snapshot format into display nodes. Values that are
+ * not written, such as a missing name, are left undefined and match anything.
+ */
+export const parseDisplayTree = (text) => {
+    const root = { children: [] };
+    const stack = [{ indent: -1, node: root }];
+    dedent(text)
+        .split('\n')
+        .filter((line) => line.trim())
+        .forEach((line) => {
+        const indent = line.match(/^ */u)[0].length;
+        const content = line.trim().replace(/^- /u, '');
+        while (stack[stack.length - 1].indent >= indent) {
+            stack.pop();
+        }
+        const parent = stack[stack.length - 1].node;
+        const prop = content.match(/^\/(?<key>[\w-]+): (?<value>.+)$/u);
+        if (prop) {
+            const { key, value } = prop.groups;
+            if (key === 'value') {
+                parent.value = unquote(value);
+            }
+            else {
+                parent.props.push([key, key === 'description' ? unquote(value) : value]);
+            }
+            return;
+        }
+        const match = content.match(NODE_PATTERN);
+        if (!match) {
+            throw new Error(`Cannot parse accessibility tree line: ${line}`);
+        }
+        const { role, name, states, value } = match.groups;
+        const node = role === 'text'
+            ? { role, name: value === undefined ? undefined : unquote(value) }
+            : {
+                role,
+                name,
+                states: states ? states.split(', ') : [],
+                value: value === undefined ? undefined : unquote(value),
+                props: [],
+                children: [],
+            };
+        parent.children.push(node);
+        stack.push({ indent, node });
+    });
+    return root.children;
+};
+/**
+ * Lists the nodes of a tree in document order, each with the index after its
+ * subtree, so that a match can skip the rest of the subtree.
+ */
+const flattenDisplayTree = (nodes, result = []) => {
+    nodes.forEach((node) => {
+        const entry = { node, end: 0 };
+        result.push(entry);
+        flattenDisplayTree(node.children || [], result);
+        entry.end = result.length;
+    });
+    return result;
+};
+/**
+ * Checks that the expected nodes appear in the actual nodes in the same order.
+ * Other nodes, states and properties are allowed. With `deep`, an expected node
+ * can match an actual node at any depth, which is used for the top level only,
+ * so that the expected tree can start below containers.
+ */
+export function matchDisplayList(expected, actual, deep = false) {
+    const matchNode = (exp, act) => exp.role === act.role &&
+        (exp.name === undefined || exp.name === act.name) &&
+        (exp.role === 'text' ||
+            ((exp.value === undefined || exp.value === act.value) &&
+                exp.states.every((state) => act.states.includes(state)) &&
+                exp.props.every(([key, value]) => act.props.some(([k, v]) => k === key && v === value)) &&
+                matchDisplayList(exp.children, act.children)));
+    const flat = deep ? flattenDisplayTree(actual) : actual.map((node, i) => ({ node, end: i + 1 }));
+    let cursor = 0;
+    return expected.every((node) => {
+        const index = flat.findIndex((entry, i) => i >= cursor && matchNode(node, entry.node));
+        if (index === -1) {
+            return false;
+        }
+        cursor = flat[index].end;
+        return true;
+    });
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `a11yTreePlugin()` is copied from vaadin/web-components wtr-utils.js
+ * on proto/aria-snapshot at a9833531f6.
+ */
+import type { TestRunnerPlugin } from '@web/test-runner';
+import type { A11yTreePayload } from './types.ts';
+export type { A11yNode } from './types.ts';
+/**
+ * A test runner command that returns the Chromium accessibility tree of the
+ * element marked by `getA11yTree()`. It works in Playwright Chromium only.
+ */
+export declare const a11yTreePlugin: () => TestRunnerPlugin<A11yTreePayload>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAO,gBAAgB,CAAC,eAAe,CA6BhE,CAAC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+import { toA11yTree } from "./tree.js";
+/**
+ * A test runner command that returns the Chromium accessibility tree of the
+ * element marked by `getA11yTree()`. It works in Playwright Chromium only.
+ */
+export const a11yTreePlugin = () => ({
+    name: 'a11y-tree-command',
+    async executeCommand({ command, payload, session }) {
+        if (command !== 'get-a11y-tree') {
+            return undefined;
+        }
+        const { id } = payload;
+        const browser = session.browser;
+        if (browser.type !== 'playwright' || browser.name !== 'Chromium') {
+            throw new Error(`Accessibility tree is not supported for browser ${browser.name}.`);
+        }
+        const page = browser.getPage(session.id);
+        const cdp = await page.context().newCDPSession(page);
+        try {
+            // The browser side stores the element in a global map, which also works
+            // for elements inside shadow roots.
+            const { result } = await cdp.send('Runtime.evaluate', {
+                expression: `globalThis.__a11yTreeTargets.get(${JSON.stringify(id)})`,
+            });
+            if (!result.objectId) {
+                throw new Error(`Cannot find the element for accessibility tree request ${id}.`);
+            }
+            const { node } = await cdp.send('DOM.describeNode', { objectId: result.objectId });
+            const { nodes } = await cdp.send('Accessibility.getFullAXTree');
+            return toA11yTree(nodes, node.backendNodeId);
+        }
+        finally {
+            await cdp.detach();
+        }
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAKvC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAsC,EAAE,CAAC,CAAC;IACtE,IAAI,EAAE,mBAAmB;IACzB,KAAK,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;QAChD,IAAI,OAAO,KAAK,eAAe,EAAE,CAAC;YAChC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,EAAE,EAAE,EAAE,GAAG,OAAQ,CAAC;QACxB,MAAM,OAAO,GAAG,OAAO,CAAC,OAA6B,CAAC;QACtD,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,mDAAmD,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;QACtF,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC;YACH,wEAAwE;YACxE,oCAAoC;YACpC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE;gBACpD,UAAU,EAAE,oCAAoC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG;aACtE,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CAAC,0DAA0D,EAAE,GAAG,CAAC,CAAC;YACnF,CAAC;YACD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YACnF,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YAChE,OAAO,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAC/C,CAAC;gBAAS,CAAC;YACT,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/tree.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `toA11yTree()` is copied from vaadin/web-components wtr-utils.js
+ * on proto/aria-snapshot at a9833531f6.
+ */
+import type { CDPSession } from 'playwright-core';
+import type { A11yNode } from './types.ts';
+declare const cdp: CDPSession;
+declare const fullAXTree: ReturnType<typeof cdp.send<'Accessibility.getFullAXTree'>>;
+type AXNode = Awaited<typeof fullAXTree>['nodes'][number];
+/**
+ * Converts the CDP accessibility tree below the given DOM node into a list of
+ * plain nodes. Ignored nodes, unnamed generic containers and noisy roles are
+ * skipped, and their children move up. Relations are resolved to the role and
+ * name of the target, as generated IDs change between runs.
+ */
+export declare const toA11yTree: (axNodes: AXNode[], backendNodeId: number) => A11yNode[];
+export {};
+//# sourceMappingURL=tree.d.ts.map

package/dist/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,CAAC,MAAM,GAAG,EAAE,UAAU,CAAC;AAC9B,OAAO,CAAC,MAAM,UAAU,EAAE,UAAU,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,CAAC;AACrF,KAAK,MAAM,GAAG,OAAO,CAAC,OAAO,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAyC1D;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,EAAE,EAAE,eAAe,MAAM,KAAG,QAAQ,EAsD7E,CAAC"}

package/dist/tree.js

@@ -0,0 +1,92 @@
+// Accessibility tree properties kept in `get-a11y-tree` results. Others,
+// such as `focusable` or `editable`, are set on most nodes and add noise.
+const A11Y_TREE_STATES = new Set([
+    'autocomplete',
+    'checked',
+    'disabled',
+    'expanded',
+    'hasPopup',
+    'invalid',
+    'level',
+    'modal',
+    'multiselectable',
+    'orientation',
+    'pressed',
+    'readonly',
+    'required',
+    'selected',
+    'valuemax',
+    'valuemin',
+    'valuetext',
+]);
+const A11Y_TREE_RELATIONS = new Set(['activedescendant', 'controls', 'details', 'errormessage', 'owns']);
+// Roles with no meaningful descendants: their text is already in the name or value.
+const A11Y_TREE_LEAF_ROLES = new Set([
+    'checkbox',
+    'combobox',
+    'radio',
+    'searchbox',
+    'slider',
+    'spinbutton',
+    'switch',
+    'textbox',
+]);
+// Roles that only add noise to the tree. Their children are kept.
+const A11Y_TREE_SKIPPED_ROLES = new Set(['InlineTextBox', 'LabelText', 'LineBreak', 'none']);
+/**
+ * Converts the CDP accessibility tree below the given DOM node into a list of
+ * plain nodes. Ignored nodes, unnamed generic containers and noisy roles are
+ * skipped, and their children move up. Relations are resolved to the role and
+ * name of the target, as generated IDs change between runs.
+ */
+export const toA11yTree = (axNodes, backendNodeId) => {
+    const byId = new Map(axNodes.map((node) => [node.nodeId, node]));
+    const byBackendId = new Map(axNodes.map((node) => [node.backendDOMNodeId, node]));
+    const describe = (node) => ({
+        role: String(node.role?.value),
+        name: node.name?.value ?? '',
+    });
+    const convert = (node) => {
+        const role = node.role?.value;
+        const name = node.name?.value ?? '';
+        const children = A11Y_TREE_LEAF_ROLES.has(role)
+            ? []
+            : (node.childIds || []).flatMap((id) => (byId.has(id) ? convert(byId.get(id)) : []));
+        if (node.ignored || A11Y_TREE_SKIPPED_ROLES.has(role) || (role === 'generic' && !name)) {
+            // Join the text of one container, such as a label, into one node. Text
+            // from different containers stays separate.
+            if (children.length > 1 && children.every((child) => child.role === 'text')) {
+                return [{ role: 'text', name: children.map((child) => child.name).join(' ') }];
+            }
+            return children;
+        }
+        if (role === 'StaticText') {
+            return name ? [{ role: 'text', name }] : [];
+        }
+        const states = {};
+        const relations = {};
+        const result = { role: role, name, states, relations, children };
+        const value = node.value?.value;
+        if (value !== undefined && value !== '') {
+            result.value = String(value);
+        }
+        if (node.description?.value) {
+            result.description = node.description.value;
+        }
+        (node.properties || []).forEach(({ name: key, value: { value: stateValue, relatedNodes } }) => {
+            if (A11Y_TREE_STATES.has(key)) {
+                states[key] = stateValue;
+            }
+            else if (A11Y_TREE_RELATIONS.has(key) && relatedNodes) {
+                relations[key] = relatedNodes
+                    .map((related) => byBackendId.get(related.backendDOMNodeId))
+                    .filter((related) => !!related)
+                    .map(describe);
+            }
+        });
+        return [result];
+    };
+    const root = byBackendId.get(backendNodeId);
+    return root ? convert(root) : [];
+};
+//# sourceMappingURL=tree.js.map

package/dist/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,16 @@
+export type A11yNode = {
+    role: string;
+    name: string;
+    value?: string;
+    description?: string;
+    states?: Record<string, boolean | number | string>;
+    relations?: Record<string, Array<{
+        role: string;
+        name: string;
+    }>>;
+    children?: A11yNode[];
+};
+export type A11yTreePayload = {
+    id: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAClE,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,64 @@
 {
   "name": "wtr-a11y-tree-plugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Chromium accessibility tree commands and chai assertions for Web Test Runner",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "default": "./dist/browser.js"
+    },
+    "./chai": {
+      "types": "./dist/chai.d.ts",
+      "default": "./dist/chai.js"
+    },
+    "./format": {
+      "types": "./dist/format.d.ts",
+      "default": "./dist/format.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "lint": "tsc && prettier --check .",
+    "test": "npm run test:unit && npm run test:browser",
+    "test:unit": "node --test \"test/*.test.ts\"",
+    "test:browser": "npm run build && web-test-runner",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@web/test-runner-commands": "^1.0.1"
+  },
+  "peerDependencies": {
+    "@types/chai": "*",
+    "@web/test-runner": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@types/chai": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/chai": "^5.0.0",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^24.0.0",
+    "@web/test-runner": "^1.0.0",
+    "@web/test-runner-playwright": "^1.0.0",
+    "chai": "^6.2.2",
+    "playwright": "1.64.1",
+    "playwright-core": "1.64.1",
+    "prettier": "^3.9.4",
+    "typescript": "^6.0.3"
+  }
+}