@browserbasehq/orca 3.4.0-preview.0 → 3.5.0-preview.0

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

@@ -1,304 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { buildHierarchicalTree, decorateRoles, extractUrlFromAXNode, isStructural, removeRedundantStaticTextChildren, } from "../../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,
-});
-describe("decorateRoles", () => {
-    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 = decorateRoles(nodes, opts);
-        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" },
-        ]);
-    });
-    it("overrides role to 'input, file' for file inputs", () => {
-        const opts = {
-            ...defaultOpts,
-            tagNameMap: { "enc-10": "input, file" },
-            scrollableMap: {},
-        };
-        const nodes = [
-            makeAxNode({
-                backendDOMNodeId: 10,
-                role: axString("button"),
-                name: axString("Choose File"),
-            }),
-        ];
-        const decorated = decorateRoles(nodes, opts);
-        expect(decorated[0]).toMatchObject({
-            encodedId: "enc-10",
-            role: "input, file",
-            name: "Choose File",
-        });
-    });
-    it("falls back when encoding fails", () => {
-        const opts = {
-            ...defaultOpts,
-            encode: () => {
-                throw new Error("boom");
-            },
-        };
-        const nodes = [makeAxNode({ backendDOMNodeId: 4 })];
-        const decorated = decorateRoles(nodes, opts);
-        expect(decorated[0]?.encodedId).toBeUndefined();
-    });
-});
-describe("buildHierarchicalTree", () => {
-    const opts = {
-        ...defaultOpts,
-        tagNameMap: { root: "div", child: "span" },
-    };
-    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 buildHierarchicalTree(nodes, opts);
-        expect(tree).toEqual([]);
-    });
-    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 buildHierarchicalTree(nodes, {
-            ...opts,
-            tagNameMap: { root: "select" },
-        });
-        expect(tree[0]?.role).toBe("select");
-    });
-    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 buildHierarchicalTree(nodes, opts);
-        expect(tree[0]?.role).toBe("StaticText");
-    });
-    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 buildHierarchicalTree(nodes, opts);
-        expect(tree).toEqual([]);
-    });
-    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 buildHierarchicalTree(nodes, {
-            ...opts,
-            tagNameMap: { root: "section" },
-        });
-        expect(tree[0]?.role).toBe("section");
-    });
-    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 buildHierarchicalTree(nodes, opts);
-        expect(tree).toEqual([]);
-    });
-});
-describe("isStructural", () => {
-    it("marks generic/none/InlineTextBox roles as structural", () => {
-        expect(isStructural("generic")).toBe(true);
-        expect(isStructural("none")).toBe(true);
-        expect(isStructural("InlineTextBox")).toBe(true);
-        expect(isStructural("button")).toBe(false);
-    });
-});
-describe("removeRedundantStaticTextChildren", () => {
-    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 = removeRedundantStaticTextChildren(parent, children);
-        expect(pruned).toEqual([{ role: "button", name: "Child", nodeId: "c3" }]);
-    });
-    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" },
-        ];
-        expect(removeRedundantStaticTextChildren(parent, children)).toEqual(children);
-    });
-    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" },
-        ];
-        expect(removeRedundantStaticTextChildren(parent, children)).toEqual(children);
-    });
-});
-describe("extractUrlFromAXNode", () => {
-    it("returns trimmed URL string from node properties", () => {
-        const node = makeAxNode({
-            properties: [
-                { name: "busy", value: axString("bar") },
-                { name: "url", value: axString(" https://example.com ") },
-            ],
-        });
-        expect(extractUrlFromAXNode(node)).toBe("https://example.com");
-    });
-    it("returns undefined when url property missing or invalid", () => {
-        expect(extractUrlFromAXNode(makeAxNode({ properties: [] }))).toBeUndefined();
-        expect(extractUrlFromAXNode(makeAxNode({
-            properties: [{ name: "url", value: { type: "number", value: 123 } }],
-        }))).toBeUndefined();
-    });
-});
-//# sourceMappingURL=snapshot-a11y-tree-utils.test.js.map

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

@@ -1 +0,0 @@
-{"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(\"overrides role to 'input, file' for file inputs\", () => {\n    const opts: A11yOptions = {\n      ...defaultOpts,\n      tagNameMap: { \"enc-10\": \"input, file\" },\n      scrollableMap: {},\n    };\n    const nodes = [\n      makeAxNode({\n        backendDOMNodeId: 10,\n        role: axString(\"button\"),\n        name: axString(\"Choose File\"),\n      }),\n    ];\n\n    const decorated = decorateRoles(nodes, opts);\n    expect(decorated[0]).toMatchObject({\n      encodedId: \"enc-10\",\n      role: \"input, file\",\n      name: \"Choose File\",\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/esm/tests/unit/snapshot-capture-orchestration.test.d.ts

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