@browserbasehq/orca 3.1.0-patch.3 → 3.2.0-preview.1

package/dist/cjs/tests/unit/snapshot-a11y-tree-utils.test.js

@@ -0,0 +1,286 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const a11yTree_js_1 = require("../../lib/v3/understudy/a11y/snapshot/a11yTree.js");
+const axString = (value) => ({
+    type: "string",
+    value,
+});
+const defaultOpts = {
+    focusSelector: undefined,
+    experimental: false,
+    tagNameMap: {},
+    scrollableMap: {},
+    encode: (backendNodeId) => `enc-${backendNodeId}`,
+};
+const makeAxNode = (overrides = {}) => ({
+    nodeId: overrides.nodeId ?? String(Math.random()),
+    backendDOMNodeId: overrides.backendDOMNodeId ?? Math.floor(Math.random() * 1e6),
+    role: overrides.role ?? axString("generic"),
+    childIds: overrides.childIds ?? [],
+    parentId: overrides.parentId,
+    properties: overrides.properties ?? [],
+    name: overrides.name,
+    description: overrides.description,
+    value: overrides.value,
+    ignored: overrides.ignored ?? false,
+});
+(0, vitest_1.describe)("decorateRoles", () => {
+    (0, vitest_1.it)("marks scrollable DOM nodes with tag labels and encoded ids", () => {
+        const opts = {
+            ...defaultOpts,
+            tagNameMap: {
+                "enc-1": "div",
+                "enc-2": "html",
+                "enc-3": "#document",
+                "enc-4": "#svg",
+            },
+            scrollableMap: { "enc-1": true, "enc-4": true },
+        };
+        const nodes = [
+            makeAxNode({
+                backendDOMNodeId: 1,
+                role: { type: "string", value: "region" },
+            }),
+            makeAxNode({
+                backendDOMNodeId: 2,
+                role: { type: "string", value: "generic" },
+            }),
+            makeAxNode({
+                backendDOMNodeId: 3,
+                role: { type: "string", value: "generic" },
+            }),
+            makeAxNode({
+                backendDOMNodeId: 4,
+                role: { type: "string", value: "generic" },
+            }),
+        ];
+        const decorated = (0, a11yTree_js_1.decorateRoles)(nodes, opts);
+        (0, vitest_1.expect)(decorated).toMatchObject([
+            { encodedId: "enc-1", role: "scrollable, div" },
+            { encodedId: "enc-2", role: "scrollable, html" },
+            { encodedId: "enc-3", role: "generic" },
+            { encodedId: "enc-4", role: "scrollable, svg" },
+        ]);
+    });
+    (0, vitest_1.it)("falls back when encoding fails", () => {
+        const opts = {
+            ...defaultOpts,
+            encode: () => {
+                throw new Error("boom");
+            },
+        };
+        const nodes = [makeAxNode({ backendDOMNodeId: 4 })];
+        const decorated = (0, a11yTree_js_1.decorateRoles)(nodes, opts);
+        (0, vitest_1.expect)(decorated[0]?.encodedId).toBeUndefined();
+    });
+});
+(0, vitest_1.describe)("buildHierarchicalTree", () => {
+    const opts = {
+        ...defaultOpts,
+        tagNameMap: { root: "div", child: "span" },
+    };
+    (0, vitest_1.it)("drops structural nodes without children or names", async () => {
+        const nodes = [
+            {
+                role: "generic",
+                name: "",
+                nodeId: "root",
+                encodedId: "root",
+                parentId: undefined,
+                childIds: ["child"],
+            },
+            {
+                role: "generic",
+                name: "",
+                nodeId: "child",
+                encodedId: "child",
+                parentId: "root",
+                childIds: [],
+            },
+        ];
+        const { tree } = await (0, a11yTree_js_1.buildHierarchicalTree)(nodes, opts);
+        (0, vitest_1.expect)(tree).toEqual([]);
+    });
+    (0, vitest_1.it)("promotes select/combobox tag names for structural nodes", async () => {
+        const nodes = [
+            {
+                role: "combobox",
+                name: "Select",
+                nodeId: "root",
+                encodedId: "root",
+                parentId: undefined,
+                childIds: ["child"],
+            },
+            {
+                role: "StaticText",
+                name: "Option",
+                nodeId: "child",
+                encodedId: "child",
+                parentId: "root",
+                childIds: [],
+            },
+        ];
+        const { tree } = await (0, a11yTree_js_1.buildHierarchicalTree)(nodes, {
+            ...opts,
+            tagNameMap: { root: "select" },
+        });
+        (0, vitest_1.expect)(tree[0]?.role).toBe("select");
+    });
+    (0, vitest_1.it)("drops structural parents with a single cleaned child while keeping it in place", async () => {
+        const nodes = [
+            {
+                role: "generic",
+                name: "",
+                nodeId: "root",
+                encodedId: "root",
+                parentId: undefined,
+                childIds: ["child"],
+            },
+            {
+                role: "StaticText",
+                name: "Ok",
+                nodeId: "child",
+                encodedId: "child",
+                parentId: "root",
+                childIds: [],
+            },
+        ];
+        const { tree } = await (0, a11yTree_js_1.buildHierarchicalTree)(nodes, opts);
+        (0, vitest_1.expect)(tree[0]?.role).toBe("StaticText");
+    });
+    (0, vitest_1.it)("drops structural parents entirely when all descendants are pruned", async () => {
+        const nodes = [
+            {
+                role: "generic",
+                name: "",
+                nodeId: "root",
+                encodedId: "root",
+                parentId: undefined,
+                childIds: ["child"],
+            },
+            {
+                role: "generic",
+                name: "",
+                nodeId: "child",
+                encodedId: "child",
+                parentId: "root",
+                childIds: [],
+            },
+        ];
+        const { tree } = await (0, a11yTree_js_1.buildHierarchicalTree)(nodes, opts);
+        (0, vitest_1.expect)(tree).toEqual([]);
+    });
+    (0, vitest_1.it)("renames structural nodes to their tag names when not combobox", async () => {
+        const nodes = [
+            {
+                role: "generic",
+                name: "Container",
+                nodeId: "root",
+                encodedId: "root",
+                parentId: undefined,
+                childIds: ["child-a", "child-b"],
+            },
+            {
+                role: "StaticText",
+                name: "A",
+                nodeId: "child-a",
+                encodedId: "child-a",
+                parentId: "root",
+                childIds: [],
+            },
+            {
+                role: "StaticText",
+                name: "B",
+                nodeId: "child-b",
+                encodedId: "child-b",
+                parentId: "root",
+                childIds: [],
+            },
+        ];
+        const { tree } = await (0, a11yTree_js_1.buildHierarchicalTree)(nodes, {
+            ...opts,
+            tagNameMap: { root: "section" },
+        });
+        (0, vitest_1.expect)(tree[0]?.role).toBe("section");
+    });
+    (0, vitest_1.it)("skips nodes with negative node ids early", async () => {
+        const nodes = [
+            {
+                role: "button",
+                name: "Hidden",
+                nodeId: "-1",
+                encodedId: "hidden",
+                parentId: undefined,
+                childIds: [],
+            },
+        ];
+        const { tree } = await (0, a11yTree_js_1.buildHierarchicalTree)(nodes, opts);
+        (0, vitest_1.expect)(tree).toEqual([]);
+    });
+});
+(0, vitest_1.describe)("isStructural", () => {
+    (0, vitest_1.it)("marks generic/none/InlineTextBox roles as structural", () => {
+        (0, vitest_1.expect)((0, a11yTree_js_1.isStructural)("generic")).toBe(true);
+        (0, vitest_1.expect)((0, a11yTree_js_1.isStructural)("none")).toBe(true);
+        (0, vitest_1.expect)((0, a11yTree_js_1.isStructural)("InlineTextBox")).toBe(true);
+        (0, vitest_1.expect)((0, a11yTree_js_1.isStructural)("button")).toBe(false);
+    });
+});
+(0, vitest_1.describe)("removeRedundantStaticTextChildren", () => {
+    (0, vitest_1.it)("removes static text children whose concatenated text equals the parent name", () => {
+        const parent = {
+            role: "button",
+            name: "HelloWorld",
+            nodeId: "root",
+        };
+        const children = [
+            { role: "StaticText", name: "Hello", nodeId: "c1" },
+            { role: "StaticText", name: "World", nodeId: "c2" },
+            { role: "button", name: "Child", nodeId: "c3" },
+        ];
+        const pruned = (0, a11yTree_js_1.removeRedundantStaticTextChildren)(parent, children);
+        (0, vitest_1.expect)(pruned).toEqual([{ role: "button", name: "Child", nodeId: "c3" }]);
+    });
+    (0, vitest_1.it)("keeps static text when combined text differs", () => {
+        const parent = {
+            role: "button",
+            name: "Hello World",
+            nodeId: "root",
+        };
+        const children = [
+            { role: "StaticText", name: "Hello", nodeId: "c1" },
+            { role: "StaticText", name: "Mars", nodeId: "c2" },
+        ];
+        (0, vitest_1.expect)((0, a11yTree_js_1.removeRedundantStaticTextChildren)(parent, children)).toEqual(children);
+    });
+    (0, vitest_1.it)("returns original children when parent name is empty", () => {
+        const parent = {
+            role: "button",
+            nodeId: "root",
+        };
+        const children = [
+            { role: "StaticText", name: "Hello", nodeId: "c1" },
+            { role: "StaticText", name: "World", nodeId: "c2" },
+        ];
+        (0, vitest_1.expect)((0, a11yTree_js_1.removeRedundantStaticTextChildren)(parent, children)).toEqual(children);
+    });
+});
+(0, vitest_1.describe)("extractUrlFromAXNode", () => {
+    (0, vitest_1.it)("returns trimmed URL string from node properties", () => {
+        const node = makeAxNode({
+            properties: [
+                { name: "busy", value: axString("bar") },
+                { name: "url", value: axString(" https://example.com ") },
+            ],
+        });
+        (0, vitest_1.expect)((0, a11yTree_js_1.extractUrlFromAXNode)(node)).toBe("https://example.com");
+    });
+    (0, vitest_1.it)("returns undefined when url property missing or invalid", () => {
+        (0, vitest_1.expect)((0, a11yTree_js_1.extractUrlFromAXNode)(makeAxNode({ properties: [] }))).toBeUndefined();
+        (0, vitest_1.expect)((0, a11yTree_js_1.extractUrlFromAXNode)(makeAxNode({
+            properties: [{ name: "url", value: { type: "number", value: 123 } }],
+        }))).toBeUndefined();
+    });
+});
+//# sourceMappingURL=snapshot-a11y-tree-utils.test.js.map

package/dist/cjs/tests/unit/snapshot-a11y-tree-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-a11y-tree-utils.test.js","sourceRoot":"","sources":["../../../../tests/unit/snapshot-a11y-tree-utils.test.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Protocol } from \"devtools-protocol\";\nimport { describe, expect, it } from \"vitest\";\nimport type {\n  A11yNode,\n  A11yOptions,\n} from \"../../lib/v3/types/private/snapshot.js\";\nimport {\n  buildHierarchicalTree,\n  decorateRoles,\n  extractUrlFromAXNode,\n  isStructural,\n  removeRedundantStaticTextChildren,\n} from \"../../lib/v3/understudy/a11y/snapshot/a11yTree.js\";\n\nconst axString = (value: string): Protocol.Accessibility.AXValue => ({\n  type: \"string\",\n  value,\n});\n\nconst defaultOpts: A11yOptions = {\n  focusSelector: undefined,\n  experimental: false,\n  tagNameMap: {},\n  scrollableMap: {},\n  encode: (backendNodeId: number) => `enc-${backendNodeId}`,\n};\n\nconst makeAxNode = (\n  overrides: Partial<Protocol.Accessibility.AXNode> = {},\n): Protocol.Accessibility.AXNode => ({\n  nodeId: overrides.nodeId ?? String(Math.random()),\n  backendDOMNodeId:\n    overrides.backendDOMNodeId ?? Math.floor(Math.random() * 1e6),\n  role: overrides.role ?? axString(\"generic\"),\n  childIds: overrides.childIds ?? [],\n  parentId: overrides.parentId,\n  properties: overrides.properties ?? [],\n  name: overrides.name,\n  description: overrides.description,\n  value: overrides.value,\n  ignored: overrides.ignored ?? false,\n});\n\ndescribe(\"decorateRoles\", () => {\n  it(\"marks scrollable DOM nodes with tag labels and encoded ids\", () => {\n    const opts: A11yOptions = {\n      ...defaultOpts,\n      tagNameMap: {\n        \"enc-1\": \"div\",\n        \"enc-2\": \"html\",\n        \"enc-3\": \"#document\",\n        \"enc-4\": \"#svg\",\n      },\n      scrollableMap: { \"enc-1\": true, \"enc-4\": true },\n    };\n    const nodes = [\n      makeAxNode({\n        backendDOMNodeId: 1,\n        role: { type: \"string\", value: \"region\" },\n      }),\n      makeAxNode({\n        backendDOMNodeId: 2,\n        role: { type: \"string\", value: \"generic\" },\n      }),\n      makeAxNode({\n        backendDOMNodeId: 3,\n        role: { type: \"string\", value: \"generic\" },\n      }),\n      makeAxNode({\n        backendDOMNodeId: 4,\n        role: { type: \"string\", value: \"generic\" },\n      }),\n    ];\n\n    const decorated = decorateRoles(nodes, opts);\n    expect(decorated).toMatchObject([\n      { encodedId: \"enc-1\", role: \"scrollable, div\" },\n      { encodedId: \"enc-2\", role: \"scrollable, html\" },\n      { encodedId: \"enc-3\", role: \"generic\" },\n      { encodedId: \"enc-4\", role: \"scrollable, svg\" },\n    ]);\n  });\n\n  it(\"falls back when encoding fails\", () => {\n    const opts: A11yOptions = {\n      ...defaultOpts,\n      encode: () => {\n        throw new Error(\"boom\");\n      },\n    };\n    const nodes = [makeAxNode({ backendDOMNodeId: 4 })];\n    const decorated = decorateRoles(nodes, opts);\n    expect(decorated[0]?.encodedId).toBeUndefined();\n  });\n});\n\ndescribe(\"buildHierarchicalTree\", () => {\n  const opts: A11yOptions = {\n    ...defaultOpts,\n    tagNameMap: { root: \"div\", child: \"span\" },\n  };\n\n  it(\"drops structural nodes without children or names\", async () => {\n    const nodes: A11yNode[] = [\n      {\n        role: \"generic\",\n        name: \"\",\n        nodeId: \"root\",\n        encodedId: \"root\",\n        parentId: undefined,\n        childIds: [\"child\"],\n      },\n      {\n        role: \"generic\",\n        name: \"\",\n        nodeId: \"child\",\n        encodedId: \"child\",\n        parentId: \"root\",\n        childIds: [],\n      },\n    ];\n\n    const { tree } = await buildHierarchicalTree(nodes, opts);\n    expect(tree).toEqual([]);\n  });\n\n  it(\"promotes select/combobox tag names for structural nodes\", async () => {\n    const nodes: A11yNode[] = [\n      {\n        role: \"combobox\",\n        name: \"Select\",\n        nodeId: \"root\",\n        encodedId: \"root\",\n        parentId: undefined,\n        childIds: [\"child\"],\n      },\n      {\n        role: \"StaticText\",\n        name: \"Option\",\n        nodeId: \"child\",\n        encodedId: \"child\",\n        parentId: \"root\",\n        childIds: [],\n      },\n    ];\n\n    const { tree } = await buildHierarchicalTree(nodes, {\n      ...opts,\n      tagNameMap: { root: \"select\" },\n    });\n    expect(tree[0]?.role).toBe(\"select\");\n  });\n\n  it(\"drops structural parents with a single cleaned child while keeping it in place\", async () => {\n    const nodes: A11yNode[] = [\n      {\n        role: \"generic\",\n        name: \"\",\n        nodeId: \"root\",\n        encodedId: \"root\",\n        parentId: undefined,\n        childIds: [\"child\"],\n      },\n      {\n        role: \"StaticText\",\n        name: \"Ok\",\n        nodeId: \"child\",\n        encodedId: \"child\",\n        parentId: \"root\",\n        childIds: [],\n      },\n    ];\n\n    const { tree } = await buildHierarchicalTree(nodes, opts);\n    expect(tree[0]?.role).toBe(\"StaticText\");\n  });\n\n  it(\"drops structural parents entirely when all descendants are pruned\", async () => {\n    const nodes: A11yNode[] = [\n      {\n        role: \"generic\",\n        name: \"\",\n        nodeId: \"root\",\n        encodedId: \"root\",\n        parentId: undefined,\n        childIds: [\"child\"],\n      },\n      {\n        role: \"generic\",\n        name: \"\",\n        nodeId: \"child\",\n        encodedId: \"child\",\n        parentId: \"root\",\n        childIds: [],\n      },\n    ];\n\n    const { tree } = await buildHierarchicalTree(nodes, opts);\n    expect(tree).toEqual([]);\n  });\n\n  it(\"renames structural nodes to their tag names when not combobox\", async () => {\n    const nodes: A11yNode[] = [\n      {\n        role: \"generic\",\n        name: \"Container\",\n        nodeId: \"root\",\n        encodedId: \"root\",\n        parentId: undefined,\n        childIds: [\"child-a\", \"child-b\"],\n      },\n      {\n        role: \"StaticText\",\n        name: \"A\",\n        nodeId: \"child-a\",\n        encodedId: \"child-a\",\n        parentId: \"root\",\n        childIds: [],\n      },\n      {\n        role: \"StaticText\",\n        name: \"B\",\n        nodeId: \"child-b\",\n        encodedId: \"child-b\",\n        parentId: \"root\",\n        childIds: [],\n      },\n    ];\n\n    const { tree } = await buildHierarchicalTree(nodes, {\n      ...opts,\n      tagNameMap: { root: \"section\" },\n    });\n    expect(tree[0]?.role).toBe(\"section\");\n  });\n\n  it(\"skips nodes with negative node ids early\", async () => {\n    const nodes: A11yNode[] = [\n      {\n        role: \"button\",\n        name: \"Hidden\",\n        nodeId: \"-1\",\n        encodedId: \"hidden\",\n        parentId: undefined,\n        childIds: [],\n      },\n    ];\n\n    const { tree } = await buildHierarchicalTree(nodes, opts);\n    expect(tree).toEqual([]);\n  });\n});\n\ndescribe(\"isStructural\", () => {\n  it(\"marks generic/none/InlineTextBox roles as structural\", () => {\n    expect(isStructural(\"generic\")).toBe(true);\n    expect(isStructural(\"none\")).toBe(true);\n    expect(isStructural(\"InlineTextBox\")).toBe(true);\n    expect(isStructural(\"button\")).toBe(false);\n  });\n});\n\ndescribe(\"removeRedundantStaticTextChildren\", () => {\n  it(\"removes static text children whose concatenated text equals the parent name\", () => {\n    const parent: A11yNode = {\n      role: \"button\",\n      name: \"HelloWorld\",\n      nodeId: \"root\",\n    };\n    const children: A11yNode[] = [\n      { role: \"StaticText\", name: \"Hello\", nodeId: \"c1\" },\n      { role: \"StaticText\", name: \"World\", nodeId: \"c2\" },\n      { role: \"button\", name: \"Child\", nodeId: \"c3\" },\n    ];\n    const pruned = removeRedundantStaticTextChildren(parent, children);\n    expect(pruned).toEqual([{ role: \"button\", name: \"Child\", nodeId: \"c3\" }]);\n  });\n\n  it(\"keeps static text when combined text differs\", () => {\n    const parent: A11yNode = {\n      role: \"button\",\n      name: \"Hello World\",\n      nodeId: \"root\",\n    };\n    const children: A11yNode[] = [\n      { role: \"StaticText\", name: \"Hello\", nodeId: \"c1\" },\n      { role: \"StaticText\", name: \"Mars\", nodeId: \"c2\" },\n    ];\n    expect(removeRedundantStaticTextChildren(parent, children)).toEqual(\n      children,\n    );\n  });\n  it(\"returns original children when parent name is empty\", () => {\n    const parent: A11yNode = {\n      role: \"button\",\n      nodeId: \"root\",\n    };\n    const children: A11yNode[] = [\n      { role: \"StaticText\", name: \"Hello\", nodeId: \"c1\" },\n      { role: \"StaticText\", name: \"World\", nodeId: \"c2\" },\n    ];\n    expect(removeRedundantStaticTextChildren(parent, children)).toEqual(\n      children,\n    );\n  });\n});\n\ndescribe(\"extractUrlFromAXNode\", () => {\n  it(\"returns trimmed URL string from node properties\", () => {\n    const node = makeAxNode({\n      properties: [\n        { name: \"busy\", value: axString(\"bar\") },\n        { name: \"url\", value: axString(\" https://example.com \") },\n      ],\n    });\n    expect(extractUrlFromAXNode(node)).toBe(\"https://example.com\");\n  });\n\n  it(\"returns undefined when url property missing or invalid\", () => {\n    expect(\n      extractUrlFromAXNode(makeAxNode({ properties: [] })),\n    ).toBeUndefined();\n    expect(\n      extractUrlFromAXNode(\n        makeAxNode({\n          properties: [{ name: \"url\", value: { type: \"number\", value: 123 } }],\n        }),\n      ),\n    ).toBeUndefined();\n  });\n});\n"]}

package/dist/cjs/tests/unit/snapshot-capture-orchestration.test.d.ts

@@ -0,0 +1 @@
+export {};