@browserbasehq/orca 3.1.0-patch.0 → 3.1.0-patch.2

package/dist/cjs/tests/snapshot-a11y-resolvers.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../tests/snapshot-a11y-resolvers.test.ts"],
+  "sourcesContent": ["import type { Protocol } from \"devtools-protocol\";\nimport { beforeEach, describe, expect, it, vi } from \"vitest\";\nimport { a11yForFrame } from \"../lib/v3/understudy/a11y/snapshot/a11yTree.js\";\nimport type { AccessibilityTreeResult } from \"../lib/v3/types/private/index.js\";\nimport * as focusSelectors from \"../lib/v3/understudy/a11y/snapshot/focusSelectors.js\";\nimport { MockCDPSession } from \"./helpers/mockCDPSession.js\";\nimport { executionContexts } from \"../lib/v3/understudy/executionContextRegistry.js\";\nimport { tryScopedSnapshot } from \"../lib/v3/understudy/a11y/snapshot/capture.js\";\nimport type {\n  FrameContext,\n  A11yOptions,\n} from \"../lib/v3/types/private/index.js\";\nimport type { Page } from \"../lib/v3/understudy/page.js\";\nimport * as domTree from \"../lib/v3/understudy/a11y/snapshot/domTree.js\";\nimport * as a11yTree from \"../lib/v3/understudy/a11y/snapshot/a11yTree.js\";\nimport * as logger from \"../lib/v3/logger.js\";\n\nconst stringType = \"string\" as Protocol.Accessibility.AXValueType;\n\nconst baseAxNodes = (): Protocol.Accessibility.AXNode[] => [\n  {\n    nodeId: \"1\",\n    role: { type: stringType, value: \"RootWebArea\" },\n    backendDOMNodeId: 100,\n    childIds: [\"2\"],\n    ignored: false,\n  },\n  {\n    nodeId: \"2\",\n    role: { type: stringType, value: \"link\" },\n    name: { type: stringType, value: \"Docs\" },\n    backendDOMNodeId: 101,\n    parentId: \"1\",\n    childIds: [],\n    properties: [\n      {\n        name: \"url\",\n        value: { type: stringType, value: \"https://example.com\" },\n      },\n    ],\n    ignored: false,\n  },\n];\n\nconst baseHandlers = {\n  \"Accessibility.enable\": async () => ({}),\n  \"Runtime.enable\": async () => ({}),\n  \"DOM.enable\": async () => ({}),\n};\n\ndescribe(\"a11yForFrame\", () => {\n  beforeEach(() => {\n    vi.restoreAllMocks();\n  });\n\n  it(\"returns full outline and url map when no focus selector is provided\", async () => {\n    const session = new MockCDPSession({\n      ...baseHandlers,\n      \"Accessibility.getFullAXTree\": async () => ({ nodes: baseAxNodes() }),\n    });\n\n    const opts: A11yOptions = {\n      focusSelector: undefined,\n      experimental: false,\n      tagNameMap: { \"enc-100\": \"#document\", \"enc-101\": \"a\" },\n      scrollableMap: {},\n      encode: (backend) => `enc-${backend}`,\n    };\n\n    const result = await a11yForFrame(session, undefined, opts);\n\n    expect(result.scopeApplied).toBe(false);\n    expect(result.urlMap[\"enc-101\"]).toBe(\"https://example.com\");\n    expect(result.outline).toContain(\"Docs\");\n  });\n\n  it(\"scopes the tree to the resolved focus selector target\", async () => {\n    const nodes = baseAxNodes().map((n) =>\n      n.nodeId === \"2\"\n        ? {\n            ...n,\n            childIds: [\"3\"],\n          }\n        : n,\n    );\n    nodes.push({\n      nodeId: \"3\",\n      parentId: \"2\",\n      childIds: [],\n      role: { type: stringType, value: \"StaticText\" },\n      backendDOMNodeId: 102,\n      ignored: false,\n    });\n\n    let scopedOnce = false;\n    const session = new MockCDPSession({\n      ...baseHandlers,\n      \"Accessibility.getFullAXTree\": async (params) => {\n        if (params?.frameId && !scopedOnce) {\n          scopedOnce = true;\n          throw new Error(\"does not belong to the target\");\n        }\n        return { nodes };\n      },\n      \"DOM.describeNode\": async () => ({\n        node: { backendNodeId: 101 },\n      }),\n    });\n\n    const resolveSpy = vi\n      .spyOn(focusSelectors, \"resolveObjectIdForXPath\")\n      .mockResolvedValue(\"object-1\");\n\n    const opts: A11yOptions = {\n      focusSelector: \"xpath=//a\",\n      experimental: false,\n      tagNameMap: { \"enc-101\": \"a\" },\n      scrollableMap: {},\n      encode: (backend) => `enc-${backend}`,\n    };\n\n    const result = await a11yForFrame(session, \"frame-1\", opts);\n\n    expect(result.scopeApplied).toBe(true);\n    expect(result.outline).not.toContain(\"RootWebArea\");\n    expect(resolveSpy).toHaveBeenCalled();\n    resolveSpy.mockRestore();\n  });\n\n  it(\"falls back to full tree when resolveObjectId throws\", async () => {\n    const session = new MockCDPSession({\n      ...baseHandlers,\n      \"Accessibility.getFullAXTree\": async () => ({ nodes: baseAxNodes() }),\n    });\n    vi.spyOn(focusSelectors, \"resolveObjectIdForCss\").mockRejectedValue(\n      new Error(\"fail\"),\n    );\n    const opts: A11yOptions = {\n      focusSelector: \".btn\",\n      experimental: false,\n      tagNameMap: {},\n      scrollableMap: {},\n      encode: (backend) => `enc-${backend}`,\n    };\n\n    const result = await a11yForFrame(session, \"frame-1\", opts);\n    expect(result.scopeApplied).toBe(false);\n  });\n});\n\ndescribe(\"resolveObjectIdForXPath\", () => {\n  beforeEach(() => {\n    vi.restoreAllMocks();\n  });\n\n  it(\"evaluates in the target frame's main world when available\", async () => {\n    vi.spyOn(executionContexts, \"waitForMainWorld\").mockResolvedValue(42);\n    vi.spyOn(executionContexts, \"getMainWorld\").mockReturnValue(undefined);\n    const session = new MockCDPSession({\n      \"Runtime.evaluate\": async (params) => {\n        expect(params?.contextId).toBe(42);\n        return { result: { objectId: \"node-obj\" } };\n      },\n    });\n\n    const objectId = await focusSelectors.resolveObjectIdForXPath(\n      session,\n      \"//div\",\n      \"frame-1\",\n    );\n    expect(objectId).toBe(\"node-obj\");\n  });\n\n  it(\"returns null when evaluation throws or reports exception details\", async () => {\n    vi.spyOn(executionContexts, \"waitForMainWorld\").mockRejectedValue(\n      new Error(\"missing\"),\n    );\n    vi.spyOn(executionContexts, \"getMainWorld\").mockReturnValue(undefined);\n    const session = new MockCDPSession({\n      \"Runtime.evaluate\": async () => ({\n        result: {},\n        exceptionDetails: { exception: { description: \"bad\" } },\n      }),\n    });\n\n    const objectId = await focusSelectors.resolveObjectIdForXPath(\n      session,\n      \"//div\",\n      \"frame-2\",\n    );\n    expect(objectId).toBeNull();\n  });\n});\n\ndescribe(\"resolveObjectIdForCss\", () => {\n  beforeEach(() => {\n    vi.restoreAllMocks();\n  });\n\n  it(\"returns primary evaluation result when available\", async () => {\n    vi.spyOn(executionContexts, \"waitForMainWorld\").mockResolvedValue(7);\n    const session = new MockCDPSession({\n      \"Runtime.evaluate\": async () => ({\n        result: { objectId: \"primary-obj\" },\n      }),\n    });\n    const objectId = await focusSelectors.resolveObjectIdForCss(\n      session,\n      \".btn\",\n      \"frame-1\",\n    );\n    expect(objectId).toBe(\"primary-obj\");\n  });\n\n  it(\"falls back to the pierce selector when the primary lookup fails\", async () => {\n    let call = 0;\n    const session = new MockCDPSession({\n      \"Runtime.evaluate\": async (params) => {\n        call++;\n        if (call === 1) {\n          expect(String(params?.expression)).toContain(\"resolveCssSelector\");\n          return { result: {} };\n        }\n        expect(String(params?.expression)).toContain(\n          \"resolveCssSelectorPierce\",\n        );\n        return { result: { objectId: \"css-obj\" } };\n      },\n    });\n\n    const objectId = await focusSelectors.resolveObjectIdForCss(\n      session,\n      \".btn\",\n      undefined,\n    );\n    expect(objectId).toBe(\"css-obj\");\n  });\n\n  it(\"returns null when both primary and fallback evaluations throw\", async () => {\n    vi.spyOn(executionContexts, \"waitForMainWorld\").mockResolvedValue(11);\n    vi.spyOn(executionContexts, \"getMainWorld\").mockReturnValue(undefined);\n    const session = new MockCDPSession({\n      \"Runtime.evaluate\": async () => ({\n        result: {},\n        exceptionDetails: { exception: { description: \"fail\" } },\n      }),\n    });\n\n    const objectId = await focusSelectors.resolveObjectIdForCss(\n      session,\n      \".missing\",\n      \"frame-1\",\n    );\n    expect(objectId).toBeNull();\n  });\n});\n\ndescribe(\"tryScopedSnapshot\", () => {\n  const ordinal = (frameId: string) => (frameId === \"frame-1\" ? 0 : 1);\n  const context: FrameContext = {\n    rootId: \"frame-1\",\n    frames: [\"frame-1\", \"frame-2\"],\n    parentByFrame: new Map([\n      [\"frame-1\", null],\n      [\"frame-2\", \"frame-1\"],\n    ]),\n  };\n\n  const makePage = (session: MockCDPSession, overrides?: Partial<Page>): Page =>\n    ({\n      mainFrameId: () => \"frame-1\",\n      asProtocolFrameTree: () => ({\n        frame: { id: \"frame-1\" as Protocol.Page.FrameId },\n        childFrames: [{ frame: { id: \"frame-2\" as Protocol.Page.FrameId } }],\n      }),\n      listAllFrameIds: () => [\"frame-1\", \"frame-2\"],\n      getSessionForFrame: () => session,\n      getOrdinal: (fid: string) => ordinal(fid),\n      ...overrides,\n    }) as unknown as Page;\n\n  beforeEach(() => {\n    vi.restoreAllMocks();\n  });\n\n  it(\"returns scoped snapshot when focus selector resolves via CSS hops\", async () => {\n    const session = new MockCDPSession({});\n    const domMapsSpy = vi\n      .spyOn(domTree, \"domMapsForSession\")\n      .mockResolvedValue({\n        tagNameMap: { \"1-10\": \"div\" },\n        xpathMap: { \"1-10\": \"/div[1]\" },\n        scrollableMap: {},\n      });\n    const a11ySpy = vi.spyOn(a11yTree, \"a11yForFrame\").mockResolvedValue({\n      outline: \"[1-10] div\",\n      urlMap: { \"1-10\": \"https://example.com\" },\n      scopeApplied: true,\n    } as AccessibilityTreeResult);\n    vi.spyOn(focusSelectors, \"resolveCssFocusFrameAndTail\").mockResolvedValue({\n      targetFrameId: \"frame-2\",\n      tailSelector: \".btn-inner\",\n      absPrefix: \"/html/body/iframe[1]\",\n    });\n\n    const result = await tryScopedSnapshot(\n      makePage(session),\n      { focusSelector: \".btn\" },\n      context,\n      true,\n    );\n\n    expect(result).not.toBeNull();\n    expect(result?.combinedXpathMap[\"1-10\"]).toBe(\n      \"/html/body/iframe[1]/div[1]\",\n    );\n    expect(domMapsSpy).toHaveBeenCalled();\n    expect(a11ySpy).toHaveBeenCalled();\n  });\n\n  it(\"returns null and logs fallback when scope is not applied\", async () => {\n    const session = new MockCDPSession({});\n    vi.spyOn(domTree, \"domMapsForSession\").mockResolvedValue({\n      tagNameMap: { \"1-10\": \"div\" },\n      xpathMap: { \"1-10\": \"/div[1]\" },\n      scrollableMap: {},\n    });\n    vi.spyOn(a11yTree, \"a11yForFrame\").mockResolvedValue({\n      outline: \"ignored\",\n      urlMap: {},\n      scopeApplied: false,\n    } as AccessibilityTreeResult);\n    const loggerSpy = vi.spyOn(logger, \"v3Logger\").mockImplementation(() => {});\n\n    const result = await tryScopedSnapshot(\n      makePage(session),\n      { focusSelector: \".btn\" },\n      context,\n      false,\n    );\n\n    expect(result).toBeNull();\n    expect(loggerSpy).toHaveBeenCalled();\n  });\n\n  it(\"returns null immediately when no focus selector is provided\", async () => {\n    const result = await tryScopedSnapshot(\n      makePage(new MockCDPSession({})),\n      {},\n      context,\n      true,\n    );\n    expect(result).toBeNull();\n  });\n\n  it(\"supports XPath focus resolution branch\", async () => {\n    const session = new MockCDPSession({});\n    vi.spyOn(domTree, \"domMapsForSession\").mockResolvedValue({\n      tagNameMap: { \"1-10\": \"div\" },\n      xpathMap: { \"1-10\": \"/div[1]\" },\n      scrollableMap: {},\n    });\n    vi.spyOn(a11yTree, \"a11yForFrame\").mockResolvedValue({\n      outline: \"[1-10] div\",\n      urlMap: {},\n      scopeApplied: true,\n    } as AccessibilityTreeResult);\n    vi.spyOn(focusSelectors, \"resolveFocusFrameAndTail\").mockResolvedValue({\n      targetFrameId: \"frame-1\",\n      tailXPath: \"//div[1]\",\n      absPrefix: \"\",\n    });\n\n    const result = await tryScopedSnapshot(\n      makePage(session),\n      { focusSelector: \"xpath=//div\" },\n      context,\n      true,\n    );\n\n    expect(result).not.toBeNull();\n    expect(result?.combinedXpathMap[\"1-10\"]).toBe(\"/div[1]\");\n  });\n\n  it(\"logs and returns null when resolver throws\", async () => {\n    const session = new MockCDPSession({});\n    vi.spyOn(focusSelectors, \"resolveCssFocusFrameAndTail\").mockRejectedValue(\n      new Error(\"bad selector\"),\n    );\n    const loggerSpy = vi.spyOn(logger, \"v3Logger\").mockImplementation(() => {});\n\n    const result = await tryScopedSnapshot(\n      makePage(session),\n      { focusSelector: \".bad\" },\n      context,\n      true,\n    );\n\n    expect(result).toBeNull();\n    expect(loggerSpy).toHaveBeenCalled();\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,294 @@
+var import_vitest = require("vitest");
+var import_a11yTree = require("../lib/v3/understudy/a11y/snapshot/a11yTree.js");
+const axString = (value) => ({
+  type: "string",
+  value
+});
+const defaultOpts = {
+  focusSelector: void 0,
+  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, import_vitest.describe)("decorateRoles", () => {
+  (0, import_vitest.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, import_a11yTree.decorateRoles)(nodes, opts);
+    (0, import_vitest.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, import_vitest.it)("falls back when encoding fails", () => {
+    const opts = {
+      ...defaultOpts,
+      encode: () => {
+        throw new Error("boom");
+      }
+    };
+    const nodes = [makeAxNode({ backendDOMNodeId: 4 })];
+    const decorated = (0, import_a11yTree.decorateRoles)(nodes, opts);
+    (0, import_vitest.expect)(decorated[0]?.encodedId).toBeUndefined();
+  });
+});
+(0, import_vitest.describe)("buildHierarchicalTree", () => {
+  const opts = {
+    ...defaultOpts,
+    tagNameMap: { root: "div", child: "span" }
+  };
+  (0, import_vitest.it)("drops structural nodes without children or names", async () => {
+    const nodes = [
+      {
+        role: "generic",
+        name: "",
+        nodeId: "root",
+        encodedId: "root",
+        parentId: void 0,
+        childIds: ["child"]
+      },
+      {
+        role: "generic",
+        name: "",
+        nodeId: "child",
+        encodedId: "child",
+        parentId: "root",
+        childIds: []
+      }
+    ];
+    const { tree } = await (0, import_a11yTree.buildHierarchicalTree)(nodes, opts);
+    (0, import_vitest.expect)(tree).toEqual([]);
+  });
+  (0, import_vitest.it)("promotes select/combobox tag names for structural nodes", async () => {
+    const nodes = [
+      {
+        role: "combobox",
+        name: "Select",
+        nodeId: "root",
+        encodedId: "root",
+        parentId: void 0,
+        childIds: ["child"]
+      },
+      {
+        role: "StaticText",
+        name: "Option",
+        nodeId: "child",
+        encodedId: "child",
+        parentId: "root",
+        childIds: []
+      }
+    ];
+    const { tree } = await (0, import_a11yTree.buildHierarchicalTree)(nodes, {
+      ...opts,
+      tagNameMap: { root: "select" }
+    });
+    (0, import_vitest.expect)(tree[0]?.role).toBe("select");
+  });
+  (0, import_vitest.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: void 0,
+        childIds: ["child"]
+      },
+      {
+        role: "StaticText",
+        name: "Ok",
+        nodeId: "child",
+        encodedId: "child",
+        parentId: "root",
+        childIds: []
+      }
+    ];
+    const { tree } = await (0, import_a11yTree.buildHierarchicalTree)(nodes, opts);
+    (0, import_vitest.expect)(tree[0]?.role).toBe("StaticText");
+  });
+  (0, import_vitest.it)("drops structural parents entirely when all descendants are pruned", async () => {
+    const nodes = [
+      {
+        role: "generic",
+        name: "",
+        nodeId: "root",
+        encodedId: "root",
+        parentId: void 0,
+        childIds: ["child"]
+      },
+      {
+        role: "generic",
+        name: "",
+        nodeId: "child",
+        encodedId: "child",
+        parentId: "root",
+        childIds: []
+      }
+    ];
+    const { tree } = await (0, import_a11yTree.buildHierarchicalTree)(nodes, opts);
+    (0, import_vitest.expect)(tree).toEqual([]);
+  });
+  (0, import_vitest.it)("renames structural nodes to their tag names when not combobox", async () => {
+    const nodes = [
+      {
+        role: "generic",
+        name: "Container",
+        nodeId: "root",
+        encodedId: "root",
+        parentId: void 0,
+        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, import_a11yTree.buildHierarchicalTree)(nodes, {
+      ...opts,
+      tagNameMap: { root: "section" }
+    });
+    (0, import_vitest.expect)(tree[0]?.role).toBe("section");
+  });
+  (0, import_vitest.it)("skips nodes with negative node ids early", async () => {
+    const nodes = [
+      {
+        role: "button",
+        name: "Hidden",
+        nodeId: "-1",
+        encodedId: "hidden",
+        parentId: void 0,
+        childIds: []
+      }
+    ];
+    const { tree } = await (0, import_a11yTree.buildHierarchicalTree)(nodes, opts);
+    (0, import_vitest.expect)(tree).toEqual([]);
+  });
+});
+(0, import_vitest.describe)("isStructural", () => {
+  (0, import_vitest.it)("marks generic/none/InlineTextBox roles as structural", () => {
+    (0, import_vitest.expect)((0, import_a11yTree.isStructural)("generic")).toBe(true);
+    (0, import_vitest.expect)((0, import_a11yTree.isStructural)("none")).toBe(true);
+    (0, import_vitest.expect)((0, import_a11yTree.isStructural)("InlineTextBox")).toBe(true);
+    (0, import_vitest.expect)((0, import_a11yTree.isStructural)("button")).toBe(false);
+  });
+});
+(0, import_vitest.describe)("removeRedundantStaticTextChildren", () => {
+  (0, import_vitest.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, import_a11yTree.removeRedundantStaticTextChildren)(parent, children);
+    (0, import_vitest.expect)(pruned).toEqual([{ role: "button", name: "Child", nodeId: "c3" }]);
+  });
+  (0, import_vitest.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, import_vitest.expect)((0, import_a11yTree.removeRedundantStaticTextChildren)(parent, children)).toEqual(
+      children
+    );
+  });
+  (0, import_vitest.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, import_vitest.expect)((0, import_a11yTree.removeRedundantStaticTextChildren)(parent, children)).toEqual(
+      children
+    );
+  });
+});
+(0, import_vitest.describe)("extractUrlFromAXNode", () => {
+  (0, import_vitest.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, import_vitest.expect)((0, import_a11yTree.extractUrlFromAXNode)(node)).toBe("https://example.com");
+  });
+  (0, import_vitest.it)("returns undefined when url property missing or invalid", () => {
+    (0, import_vitest.expect)(
+      (0, import_a11yTree.extractUrlFromAXNode)(makeAxNode({ properties: [] }))
+    ).toBeUndefined();
+    (0, import_vitest.expect)(
+      (0, import_a11yTree.extractUrlFromAXNode)(
+        makeAxNode({
+          properties: [{ name: "url", value: { type: "number", value: 123 } }]
+        })
+      )
+    ).toBeUndefined();
+  });
+});
+//# sourceMappingURL=snapshot-a11y-tree-utils.test.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../tests/snapshot-a11y-tree-utils.test.ts"],
+  "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"],
+  "mappings": "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",
+  "names": []
+}