@browserbasehq/orca 3.0.9-alpha-3 → 3.1.0-patch.0

package/dist/esm/tests/snapshot-dom-session-builders.test.js

@@ -0,0 +1,251 @@
+import { describe, expect, it } from "vitest";
+import {
+  buildSessionDomIndex,
+  domMapsForSession,
+  getDomTreeWithFallback,
+  hydrateDomTree
+} from "../lib/v3/understudy/a11y/snapshot/domTree.js";
+import { StagehandDomProcessError } from "../lib/v3/types/public/sdkErrors.js";
+import { MockCDPSession } from "./helpers/mockCDPSession.js";
+let nextNodeId = 1;
+const makeDomNode = (overrides = {}) => {
+  const nodeId = overrides.nodeId ?? nextNodeId++;
+  const backendNodeId = overrides.backendNodeId ?? nextNodeId++;
+  const nodeName = overrides.nodeName ?? "DIV";
+  const nodeType = overrides.nodeType ?? 1;
+  const children = overrides.children ?? [];
+  return {
+    nodeId,
+    backendNodeId,
+    nodeName,
+    nodeType,
+    localName: overrides.localName ?? nodeName.toLowerCase(),
+    nodeValue: overrides.nodeValue ?? "",
+    childNodeCount: overrides.childNodeCount ?? children.length,
+    children,
+    shadowRoots: overrides.shadowRoots,
+    contentDocument: overrides.contentDocument,
+    isScrollable: overrides.isScrollable
+  };
+};
+const buildSampleDomTree = () => {
+  const iframeChild = makeDomNode({ nodeName: "P" });
+  const iframeBody = makeDomNode({
+    nodeName: "BODY",
+    children: [iframeChild],
+    isScrollable: true
+  });
+  const iframeHtml = makeDomNode({ nodeName: "HTML", children: [iframeBody] });
+  const iframeDoc = makeDomNode({
+    nodeName: "#document",
+    nodeType: 9,
+    children: [iframeHtml]
+  });
+  const iframeElement = makeDomNode({
+    nodeName: "IFRAME",
+    contentDocument: iframeDoc
+  });
+  const scrollDiv = makeDomNode({
+    nodeName: "DIV",
+    isScrollable: true
+  });
+  const body = makeDomNode({
+    nodeName: "BODY",
+    children: [scrollDiv, iframeElement]
+  });
+  const html = makeDomNode({ nodeName: "HTML", children: [body] });
+  const root = makeDomNode({
+    nodeName: "#document",
+    nodeType: 9,
+    children: [html]
+  });
+  return {
+    root,
+    html,
+    body,
+    scrollDiv,
+    iframeElement,
+    iframeDoc,
+    iframeHtml,
+    iframeBody,
+    iframeChild
+  };
+};
+describe("hydrateDomTree", () => {
+  it("expands truncated nodes by calling DOM.describeNode", async () => {
+    const child = makeDomNode({ nodeName: "DIV" });
+    const root = makeDomNode({
+      nodeName: "HTML",
+      childNodeCount: 1,
+      children: []
+    });
+    const session = new MockCDPSession({
+      "DOM.describeNode": async () => ({
+        node: {
+          ...root,
+          children: [child],
+          childNodeCount: 1
+        }
+      })
+    });
+    await hydrateDomTree(session, root, true);
+    expect(root.children).toEqual([child]);
+  });
+  it("retries describeNode when CBOR errors occur before succeeding", async () => {
+    const child = makeDomNode({ nodeName: "DIV" });
+    const root = makeDomNode({
+      nodeName: "HTML",
+      childNodeCount: 1,
+      children: []
+    });
+    let attempts = 0;
+    const session = new MockCDPSession({
+      "DOM.describeNode": async () => {
+        attempts++;
+        if (attempts === 1) throw new Error("CBOR: stack limit exceeded");
+        return { node: { ...root, children: [child], childNodeCount: 1 } };
+      }
+    });
+    await hydrateDomTree(session, root, true);
+    expect(attempts).toBe(2);
+    expect(root.children).toEqual([child]);
+  });
+  it("throws StagehandDomProcessError after exhausting describeNode retries", async () => {
+    const root = makeDomNode({
+      nodeName: "HTML",
+      childNodeCount: 1,
+      children: []
+    });
+    const session = new MockCDPSession({
+      "DOM.describeNode": async () => {
+        throw new Error("CBOR: stack limit exceeded");
+      }
+    });
+    await expect(hydrateDomTree(session, root, true)).rejects.toBeInstanceOf(
+      StagehandDomProcessError
+    );
+  });
+});
+describe("getDomTreeWithFallback", () => {
+  it("retries DOM.getDocument after CBOR errors and returns the hydrated root", async () => {
+    const root = makeDomNode({
+      nodeName: "#document",
+      nodeType: 9,
+      children: []
+    });
+    const depths = [];
+    const session = new MockCDPSession({
+      "DOM.getDocument": async (params) => {
+        const depth = params?.depth ?? 0;
+        depths.push(depth);
+        if (depth === -1) throw new Error("CBOR: stack limit exceeded");
+        return { root };
+      },
+      "DOM.describeNode": async () => ({ node: root })
+    });
+    const result = await getDomTreeWithFallback(session, true);
+    expect(result).toBe(root);
+    expect(depths).toEqual([-1, 256]);
+  });
+  it("propagates non-CBOR DOM.getDocument errors", async () => {
+    const session = new MockCDPSession({
+      "DOM.getDocument": async () => {
+        throw new Error("network fail");
+      }
+    });
+    await expect(getDomTreeWithFallback(session, false)).rejects.toThrow(
+      "network fail"
+    );
+  });
+  it("throws StagehandDomProcessError when all depth attempts hit CBOR limits", async () => {
+    const session = new MockCDPSession({
+      "DOM.getDocument": async () => {
+        throw new Error("CBOR: stack limit exceeded");
+      }
+    });
+    await expect(getDomTreeWithFallback(session, false)).rejects.toBeInstanceOf(
+      StagehandDomProcessError
+    );
+  });
+});
+describe("buildSessionDomIndex", () => {
+  it("collects absolute paths, scrollability, and content-document metadata", async () => {
+    const tree = buildSampleDomTree();
+    const session = new MockCDPSession({
+      "DOM.enable": async () => ({}),
+      "DOM.getDocument": async () => ({ root: tree.root }),
+      "DOM.describeNode": async () => ({ node: tree.root })
+    });
+    const index = await buildSessionDomIndex(session, true);
+    expect(index.rootBackend).toBe(tree.root.backendNodeId);
+    expect(index.absByBe.get(tree.body.backendNodeId)).toBe("/html[1]/body[1]");
+    expect(index.absByBe.get(tree.scrollDiv.backendNodeId)).toBe(
+      "/html[1]/body[1]/div[1]"
+    );
+    expect(index.scrollByBe.get(tree.scrollDiv.backendNodeId)).toBe(true);
+    expect(index.docRootOf.get(tree.iframeHtml.backendNodeId)).toBe(
+      tree.iframeDoc.backendNodeId
+    );
+    expect(
+      index.contentDocRootByIframe.get(tree.iframeElement.backendNodeId)
+    ).toBe(tree.iframeDoc.backendNodeId);
+  });
+});
+describe("domMapsForSession", () => {
+  it("derives frame-relative xpath/tag/scrollable maps for a frame's document root", async () => {
+    const tree = buildSampleDomTree();
+    const session = new MockCDPSession({
+      "DOM.enable": async () => ({}),
+      "DOM.getDocument": async () => ({ root: tree.root }),
+      "DOM.getFrameOwner": async () => ({
+        backendNodeId: tree.iframeElement.backendNodeId
+      }),
+      "DOM.describeNode": async () => ({ node: tree.root })
+    });
+    const encode = (frameId, backendNodeId) => `${frameId}-${backendNodeId}`;
+    const maps = await domMapsForSession(
+      session,
+      "frame-A",
+      true,
+      encode,
+      true
+    );
+    const iframeDocKey = `frame-A-${tree.iframeDoc.backendNodeId}`;
+    const iframeBodyKey = `frame-A-${tree.iframeBody.backendNodeId}`;
+    const iframeChildKey = `frame-A-${tree.iframeChild.backendNodeId}`;
+    expect(maps.tagNameMap[iframeDocKey]).toBe("#document");
+    expect(maps.xpathMap[iframeDocKey]).toBe("/");
+    expect(maps.xpathMap[iframeBodyKey]).toBe("/html[1]/body[1]");
+    expect(maps.xpathMap[iframeChildKey]).toBe("/html[1]/body[1]/p[1]");
+    expect(maps.scrollableMap[iframeBodyKey]).toBe(true);
+    expect(Object.keys(maps.tagNameMap)).not.toContain(
+      `frame-A-${tree.html.backendNodeId}`
+    );
+  });
+  it("falls back to the root document when frame owner lookup fails", async () => {
+    const tree = buildSampleDomTree();
+    const session = new MockCDPSession({
+      "DOM.enable": async () => ({}),
+      "DOM.getDocument": async () => ({ root: tree.root }),
+      "DOM.getFrameOwner": async () => {
+        throw new Error("owner lookup failed");
+      },
+      "DOM.describeNode": async () => ({ node: tree.root })
+    });
+    const encode = (frameId, backendNodeId) => `${frameId}-${backendNodeId}`;
+    const maps = await domMapsForSession(
+      session,
+      "frame-B",
+      false,
+      encode,
+      true
+    );
+    expect(maps.xpathMap[`frame-B-${tree.html.backendNodeId}`]).toBe(
+      "/html[1]"
+    );
+    expect(maps.xpathMap[`frame-B-${tree.scrollDiv.backendNodeId}`]).toBe(
+      "/html[1]/body[1]/div[1]"
+    );
+  });
+});
+//# sourceMappingURL=snapshot-dom-session-builders.test.js.map

package/dist/esm/tests/snapshot-dom-session-builders.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../tests/snapshot-dom-session-builders.test.ts"],
+  "sourcesContent": ["import type { Protocol } from \"devtools-protocol\";\nimport { describe, expect, it } from \"vitest\";\nimport {\n  buildSessionDomIndex,\n  domMapsForSession,\n  getDomTreeWithFallback,\n  hydrateDomTree,\n} from \"../lib/v3/understudy/a11y/snapshot/domTree.js\";\nimport { StagehandDomProcessError } from \"../lib/v3/types/public/sdkErrors.js\";\nimport { MockCDPSession } from \"./helpers/mockCDPSession.js\";\n\nlet nextNodeId = 1;\nconst makeDomNode = (\n  overrides: Partial<Protocol.DOM.Node> = {},\n): Protocol.DOM.Node => {\n  const nodeId = overrides.nodeId ?? nextNodeId++;\n  const backendNodeId = overrides.backendNodeId ?? nextNodeId++;\n  const nodeName = overrides.nodeName ?? \"DIV\";\n  const nodeType = overrides.nodeType ?? 1;\n  const children = overrides.children ?? [];\n  return {\n    nodeId,\n    backendNodeId,\n    nodeName,\n    nodeType,\n    localName: overrides.localName ?? nodeName.toLowerCase(),\n    nodeValue: overrides.nodeValue ?? \"\",\n    childNodeCount: overrides.childNodeCount ?? children.length,\n    children,\n    shadowRoots: overrides.shadowRoots,\n    contentDocument: overrides.contentDocument,\n    isScrollable: overrides.isScrollable,\n  };\n};\n\nconst buildSampleDomTree = () => {\n  const iframeChild = makeDomNode({ nodeName: \"P\" });\n  const iframeBody = makeDomNode({\n    nodeName: \"BODY\",\n    children: [iframeChild],\n    isScrollable: true,\n  });\n  const iframeHtml = makeDomNode({ nodeName: \"HTML\", children: [iframeBody] });\n  const iframeDoc = makeDomNode({\n    nodeName: \"#document\",\n    nodeType: 9,\n    children: [iframeHtml],\n  });\n  const iframeElement = makeDomNode({\n    nodeName: \"IFRAME\",\n    contentDocument: iframeDoc,\n  });\n  const scrollDiv = makeDomNode({\n    nodeName: \"DIV\",\n    isScrollable: true,\n  });\n  const body = makeDomNode({\n    nodeName: \"BODY\",\n    children: [scrollDiv, iframeElement],\n  });\n  const html = makeDomNode({ nodeName: \"HTML\", children: [body] });\n  const root = makeDomNode({\n    nodeName: \"#document\",\n    nodeType: 9,\n    children: [html],\n  });\n  return {\n    root,\n    html,\n    body,\n    scrollDiv,\n    iframeElement,\n    iframeDoc,\n    iframeHtml,\n    iframeBody,\n    iframeChild,\n  };\n};\n\ndescribe(\"hydrateDomTree\", () => {\n  it(\"expands truncated nodes by calling DOM.describeNode\", async () => {\n    const child = makeDomNode({ nodeName: \"DIV\" });\n    const root = makeDomNode({\n      nodeName: \"HTML\",\n      childNodeCount: 1,\n      children: [],\n    });\n\n    const session = new MockCDPSession({\n      \"DOM.describeNode\": async () => ({\n        node: {\n          ...root,\n          children: [child],\n          childNodeCount: 1,\n        },\n      }),\n    });\n\n    await hydrateDomTree(session, root, true);\n    expect(root.children).toEqual([child]);\n  });\n\n  it(\"retries describeNode when CBOR errors occur before succeeding\", async () => {\n    const child = makeDomNode({ nodeName: \"DIV\" });\n    const root = makeDomNode({\n      nodeName: \"HTML\",\n      childNodeCount: 1,\n      children: [],\n    });\n\n    let attempts = 0;\n    const session = new MockCDPSession({\n      \"DOM.describeNode\": async () => {\n        attempts++;\n        if (attempts === 1) throw new Error(\"CBOR: stack limit exceeded\");\n        return { node: { ...root, children: [child], childNodeCount: 1 } };\n      },\n    });\n\n    await hydrateDomTree(session, root, true);\n    expect(attempts).toBe(2);\n    expect(root.children).toEqual([child]);\n  });\n\n  it(\"throws StagehandDomProcessError after exhausting describeNode retries\", async () => {\n    const root = makeDomNode({\n      nodeName: \"HTML\",\n      childNodeCount: 1,\n      children: [],\n    });\n    const session = new MockCDPSession({\n      \"DOM.describeNode\": async () => {\n        throw new Error(\"CBOR: stack limit exceeded\");\n      },\n    });\n\n    await expect(hydrateDomTree(session, root, true)).rejects.toBeInstanceOf(\n      StagehandDomProcessError,\n    );\n  });\n});\n\ndescribe(\"getDomTreeWithFallback\", () => {\n  it(\"retries DOM.getDocument after CBOR errors and returns the hydrated root\", async () => {\n    const root = makeDomNode({\n      nodeName: \"#document\",\n      nodeType: 9,\n      children: [],\n    });\n    const depths: number[] = [];\n    const session = new MockCDPSession({\n      \"DOM.getDocument\": async (params) => {\n        const depth = (params?.depth ?? 0) as number;\n        depths.push(depth);\n        if (depth === -1) throw new Error(\"CBOR: stack limit exceeded\");\n        return { root };\n      },\n      \"DOM.describeNode\": async () => ({ node: root }),\n    });\n\n    const result = await getDomTreeWithFallback(session, true);\n    expect(result).toBe(root);\n    expect(depths).toEqual([-1, 256]);\n  });\n\n  it(\"propagates non-CBOR DOM.getDocument errors\", async () => {\n    const session = new MockCDPSession({\n      \"DOM.getDocument\": async () => {\n        throw new Error(\"network fail\");\n      },\n    });\n    await expect(getDomTreeWithFallback(session, false)).rejects.toThrow(\n      \"network fail\",\n    );\n  });\n\n  it(\"throws StagehandDomProcessError when all depth attempts hit CBOR limits\", async () => {\n    const session = new MockCDPSession({\n      \"DOM.getDocument\": async () => {\n        throw new Error(\"CBOR: stack limit exceeded\");\n      },\n    });\n    await expect(getDomTreeWithFallback(session, false)).rejects.toBeInstanceOf(\n      StagehandDomProcessError,\n    );\n  });\n});\n\ndescribe(\"buildSessionDomIndex\", () => {\n  it(\"collects absolute paths, scrollability, and content-document metadata\", async () => {\n    const tree = buildSampleDomTree();\n    const session = new MockCDPSession({\n      \"DOM.enable\": async () => ({}),\n      \"DOM.getDocument\": async () => ({ root: tree.root }),\n      \"DOM.describeNode\": async () => ({ node: tree.root }),\n    });\n\n    const index = await buildSessionDomIndex(session, true);\n\n    expect(index.rootBackend).toBe(tree.root.backendNodeId);\n    expect(index.absByBe.get(tree.body.backendNodeId)).toBe(\"/html[1]/body[1]\");\n    expect(index.absByBe.get(tree.scrollDiv.backendNodeId)).toBe(\n      \"/html[1]/body[1]/div[1]\",\n    );\n    expect(index.scrollByBe.get(tree.scrollDiv.backendNodeId)).toBe(true);\n    expect(index.docRootOf.get(tree.iframeHtml.backendNodeId)).toBe(\n      tree.iframeDoc.backendNodeId,\n    );\n    expect(\n      index.contentDocRootByIframe.get(tree.iframeElement.backendNodeId),\n    ).toBe(tree.iframeDoc.backendNodeId);\n  });\n});\n\ndescribe(\"domMapsForSession\", () => {\n  it(\"derives frame-relative xpath/tag/scrollable maps for a frame's document root\", async () => {\n    const tree = buildSampleDomTree();\n    const session = new MockCDPSession({\n      \"DOM.enable\": async () => ({}),\n      \"DOM.getDocument\": async () => ({ root: tree.root }),\n      \"DOM.getFrameOwner\": async () => ({\n        backendNodeId: tree.iframeElement.backendNodeId,\n      }),\n      \"DOM.describeNode\": async () => ({ node: tree.root }),\n    });\n\n    const encode = (frameId: string, backendNodeId: number) =>\n      `${frameId}-${backendNodeId}`;\n    const maps = await domMapsForSession(\n      session,\n      \"frame-A\",\n      true,\n      encode,\n      true,\n    );\n\n    const iframeDocKey = `frame-A-${tree.iframeDoc.backendNodeId}`;\n    const iframeBodyKey = `frame-A-${tree.iframeBody.backendNodeId}`;\n    const iframeChildKey = `frame-A-${tree.iframeChild.backendNodeId}`;\n\n    expect(maps.tagNameMap[iframeDocKey]).toBe(\"#document\");\n    expect(maps.xpathMap[iframeDocKey]).toBe(\"/\");\n    expect(maps.xpathMap[iframeBodyKey]).toBe(\"/html[1]/body[1]\");\n    expect(maps.xpathMap[iframeChildKey]).toBe(\"/html[1]/body[1]/p[1]\");\n    expect(maps.scrollableMap[iframeBodyKey]).toBe(true);\n    expect(Object.keys(maps.tagNameMap)).not.toContain(\n      `frame-A-${tree.html.backendNodeId}`,\n    );\n  });\n\n  it(\"falls back to the root document when frame owner lookup fails\", async () => {\n    const tree = buildSampleDomTree();\n    const session = new MockCDPSession({\n      \"DOM.enable\": async () => ({}),\n      \"DOM.getDocument\": async () => ({ root: tree.root }),\n      \"DOM.getFrameOwner\": async () => {\n        throw new Error(\"owner lookup failed\");\n      },\n      \"DOM.describeNode\": async () => ({ node: tree.root }),\n    });\n\n    const encode = (frameId: string, backendNodeId: number) =>\n      `${frameId}-${backendNodeId}`;\n    const maps = await domMapsForSession(\n      session,\n      \"frame-B\",\n      false,\n      encode,\n      true,\n    );\n\n    expect(maps.xpathMap[`frame-B-${tree.html.backendNodeId}`]).toBe(\n      \"/html[1]\",\n    );\n    expect(maps.xpathMap[`frame-B-${tree.scrollDiv.backendNodeId}`]).toBe(\n      \"/html[1]/body[1]/div[1]\",\n    );\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,109 @@
+import { describe, expect, it } from "vitest";
+import {
+  collectDomTraversalTargets,
+  findNodeByBackendId,
+  mergeDomNodes,
+  shouldExpandNode
+} from "../lib/v3/understudy/a11y/snapshot/domTree.js";
+let nextNodeId = 1;
+const makeNode = (overrides = {}) => {
+  const base = {
+    nodeId: nextNodeId++,
+    backendNodeId: nextNodeId++,
+    nodeType: 1,
+    nodeName: "DIV",
+    localName: "div",
+    nodeValue: "",
+    childNodeCount: overrides.childNodeCount ?? (overrides.children ? overrides.children.length : 0)
+  };
+  return { ...base, ...overrides };
+};
+describe("shouldExpandNode", () => {
+  it("returns true when declared children exceed realized children", () => {
+    const node = makeNode({
+      childNodeCount: 2,
+      children: [makeNode()]
+    });
+    expect(shouldExpandNode(node)).toBe(true);
+  });
+  it("returns false when all declared children are realized", () => {
+    const child = makeNode();
+    const node = makeNode({
+      childNodeCount: 1,
+      children: [child]
+    });
+    expect(shouldExpandNode(node)).toBe(false);
+  });
+});
+describe("mergeDomNodes", () => {
+  it("overrides structural fields with expanded node data", () => {
+    const originalChildren = [makeNode({ nodeName: "SPAN" })];
+    const target = makeNode({
+      childNodeCount: 1,
+      children: originalChildren,
+      shadowRoots: [makeNode({ nodeName: "shadow-old" })],
+      contentDocument: makeNode({ nodeName: "doc-old" })
+    });
+    const source = makeNode({
+      childNodeCount: 3,
+      children: [makeNode({ nodeName: "DIV" })],
+      shadowRoots: [],
+      contentDocument: makeNode({ nodeName: "doc-new" })
+    });
+    mergeDomNodes(target, source);
+    expect(target.childNodeCount).toBe(3);
+    expect(target.children).toEqual(source.children);
+    expect(target.shadowRoots).toEqual([]);
+    expect(target.contentDocument?.nodeName).toBe("doc-new");
+  });
+  it("preserves original structures when source omits them", () => {
+    const child = makeNode();
+    const target = makeNode({
+      childNodeCount: 1,
+      children: [child]
+    });
+    const source = makeNode({
+      childNodeCount: 5
+    });
+    mergeDomNodes(target, source);
+    expect(target.childNodeCount).toBe(5);
+    expect(target.children).toEqual([child]);
+  });
+});
+describe("collectDomTraversalTargets", () => {
+  it("returns children, shadow roots, and content document in order", () => {
+    const childA = makeNode({ nodeName: "CHILD-A" });
+    const childB = makeNode({ nodeName: "CHILD-B" });
+    const shadow = makeNode({ nodeName: "SHADOW" });
+    const content = makeNode({ nodeName: "CONTENT" });
+    const node = makeNode({
+      children: [childA, childB],
+      shadowRoots: [shadow],
+      contentDocument: content
+    });
+    const targets = collectDomTraversalTargets(node);
+    expect(targets).toEqual([childA, childB, shadow, content]);
+  });
+});
+describe("findNodeByBackendId", () => {
+  it("finds nodes nested within children and shadow roots", () => {
+    const target = makeNode({ backendNodeId: 999, nodeName: "TARGET" });
+    const root = makeNode({
+      children: [
+        makeNode({
+          children: [makeNode(), target]
+        })
+      ],
+      shadowRoots: [makeNode()]
+    });
+    expect(findNodeByBackendId(root, 999)).toBe(target);
+  });
+  it("returns undefined when no node matches the backend id", () => {
+    const root = makeNode({
+      children: [makeNode()],
+      shadowRoots: [makeNode()]
+    });
+    expect(findNodeByBackendId(root, 123456)).toBeUndefined();
+  });
+});
+//# sourceMappingURL=snapshot-dom-tree-utils.test.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../tests/snapshot-dom-tree-utils.test.ts"],
+  "sourcesContent": ["import type { Protocol } from \"devtools-protocol\";\nimport { describe, expect, it } from \"vitest\";\nimport {\n  collectDomTraversalTargets,\n  findNodeByBackendId,\n  mergeDomNodes,\n  shouldExpandNode,\n} from \"../lib/v3/understudy/a11y/snapshot/domTree.js\";\n\nlet nextNodeId = 1;\nconst makeNode = (\n  overrides: Partial<Protocol.DOM.Node> = {},\n): Protocol.DOM.Node => {\n  const base: Protocol.DOM.Node = {\n    nodeId: nextNodeId++,\n    backendNodeId: nextNodeId++,\n    nodeType: 1,\n    nodeName: \"DIV\",\n    localName: \"div\",\n    nodeValue: \"\",\n    childNodeCount:\n      overrides.childNodeCount ??\n      (overrides.children ? overrides.children.length : 0),\n  };\n  return { ...base, ...overrides };\n};\n\ndescribe(\"shouldExpandNode\", () => {\n  it(\"returns true when declared children exceed realized children\", () => {\n    const node = makeNode({\n      childNodeCount: 2,\n      children: [makeNode()],\n    });\n    expect(shouldExpandNode(node)).toBe(true);\n  });\n\n  it(\"returns false when all declared children are realized\", () => {\n    const child = makeNode();\n    const node = makeNode({\n      childNodeCount: 1,\n      children: [child],\n    });\n    expect(shouldExpandNode(node)).toBe(false);\n  });\n});\n\ndescribe(\"mergeDomNodes\", () => {\n  it(\"overrides structural fields with expanded node data\", () => {\n    const originalChildren = [makeNode({ nodeName: \"SPAN\" })];\n    const target = makeNode({\n      childNodeCount: 1,\n      children: originalChildren,\n      shadowRoots: [makeNode({ nodeName: \"shadow-old\" })],\n      contentDocument: makeNode({ nodeName: \"doc-old\" }),\n    });\n    const source = makeNode({\n      childNodeCount: 3,\n      children: [makeNode({ nodeName: \"DIV\" })],\n      shadowRoots: [],\n      contentDocument: makeNode({ nodeName: \"doc-new\" }),\n    });\n\n    mergeDomNodes(target, source);\n\n    expect(target.childNodeCount).toBe(3);\n    expect(target.children).toEqual(source.children);\n    expect(target.shadowRoots).toEqual([]);\n    expect(target.contentDocument?.nodeName).toBe(\"doc-new\");\n  });\n\n  it(\"preserves original structures when source omits them\", () => {\n    const child = makeNode();\n    const target = makeNode({\n      childNodeCount: 1,\n      children: [child],\n    });\n    const source = makeNode({\n      childNodeCount: 5,\n    });\n\n    mergeDomNodes(target, source);\n\n    expect(target.childNodeCount).toBe(5);\n    expect(target.children).toEqual([child]);\n  });\n});\n\ndescribe(\"collectDomTraversalTargets\", () => {\n  it(\"returns children, shadow roots, and content document in order\", () => {\n    const childA = makeNode({ nodeName: \"CHILD-A\" });\n    const childB = makeNode({ nodeName: \"CHILD-B\" });\n    const shadow = makeNode({ nodeName: \"SHADOW\" });\n    const content = makeNode({ nodeName: \"CONTENT\" });\n\n    const node = makeNode({\n      children: [childA, childB],\n      shadowRoots: [shadow],\n      contentDocument: content,\n    });\n\n    const targets = collectDomTraversalTargets(node);\n    expect(targets).toEqual([childA, childB, shadow, content]);\n  });\n});\n\ndescribe(\"findNodeByBackendId\", () => {\n  it(\"finds nodes nested within children and shadow roots\", () => {\n    const target = makeNode({ backendNodeId: 999, nodeName: \"TARGET\" });\n    const root = makeNode({\n      children: [\n        makeNode({\n          children: [makeNode(), target],\n        }),\n      ],\n      shadowRoots: [makeNode()],\n    });\n\n    expect(findNodeByBackendId(root, 999)).toBe(target);\n  });\n\n  it(\"returns undefined when no node matches the backend id\", () => {\n    const root = makeNode({\n      children: [makeNode()],\n      shadowRoots: [makeNode()],\n    });\n    expect(findNodeByBackendId(root, 123456)).toBeUndefined();\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/tests/snapshot-focus-selectors-utils.test.js

@@ -0,0 +1,49 @@
+import { describe, expect, it } from "vitest";
+import {
+  buildXPathFromSteps,
+  listChildrenOf,
+  parseXPathToSteps
+} from "../lib/v3/understudy/a11y/snapshot/focusSelectors.js";
+describe("parseXPathToSteps", () => {
+  it("records axis direction and normalized names", () => {
+    const steps = parseXPathToSteps(" //iframe[1]/div[2]//SPAN ");
+    expect(steps).toEqual([
+      { axis: "desc", raw: "iframe[1]", name: "iframe" },
+      { axis: "child", raw: "div[2]", name: "div" },
+      { axis: "desc", raw: "SPAN", name: "span" }
+    ]);
+  });
+  it("drops empty segments and returns [] for blank input", () => {
+    expect(parseXPathToSteps("   ")).toEqual([]);
+    expect(parseXPathToSteps("/ ")).toEqual([]);
+  });
+});
+describe("buildXPathFromSteps", () => {
+  it("reconstructs descendant and child hops as a string", () => {
+    const steps = [
+      { axis: "child", raw: "iframe[1]", name: "iframe" },
+      { axis: "desc", raw: "div[@id='main']", name: "div" },
+      { axis: "child", raw: "span", name: "span" }
+    ];
+    expect(buildXPathFromSteps(steps)).toBe("/iframe[1]//div[@id='main']/span");
+  });
+  it("returns '/' for empty sequences", () => {
+    expect(buildXPathFromSteps([])).toBe("/");
+  });
+});
+describe("listChildrenOf", () => {
+  it("returns direct children whose parent matches the provided id", () => {
+    const parentByFrame = /* @__PURE__ */ new Map([
+      ["frame-1", null],
+      ["frame-2", "frame-1"],
+      ["frame-3", "frame-1"],
+      ["frame-4", "frame-2"]
+    ]);
+    expect(listChildrenOf(parentByFrame, "frame-1")).toEqual([
+      "frame-2",
+      "frame-3"
+    ]);
+    expect(listChildrenOf(parentByFrame, "frame-4")).toEqual([]);
+  });
+});
+//# sourceMappingURL=snapshot-focus-selectors-utils.test.js.map

package/dist/esm/tests/snapshot-focus-selectors-utils.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../tests/snapshot-focus-selectors-utils.test.ts"],
+  "sourcesContent": ["import type { Step } from \"../lib/v3/types/private/snapshot.js\";\nimport { describe, expect, it } from \"vitest\";\nimport {\n  buildXPathFromSteps,\n  listChildrenOf,\n  parseXPathToSteps,\n} from \"../lib/v3/understudy/a11y/snapshot/focusSelectors.js\";\n\ndescribe(\"parseXPathToSteps\", () => {\n  it(\"records axis direction and normalized names\", () => {\n    const steps = parseXPathToSteps(\" //iframe[1]/div[2]//SPAN \");\n    expect(steps).toEqual([\n      { axis: \"desc\", raw: \"iframe[1]\", name: \"iframe\" },\n      { axis: \"child\", raw: \"div[2]\", name: \"div\" },\n      { axis: \"desc\", raw: \"SPAN\", name: \"span\" },\n    ]);\n  });\n\n  it(\"drops empty segments and returns [] for blank input\", () => {\n    expect(parseXPathToSteps(\"   \")).toEqual([]);\n    expect(parseXPathToSteps(\"/ \")).toEqual([]);\n  });\n});\n\ndescribe(\"buildXPathFromSteps\", () => {\n  it(\"reconstructs descendant and child hops as a string\", () => {\n    const steps: ReadonlyArray<Step> = [\n      { axis: \"child\", raw: \"iframe[1]\", name: \"iframe\" },\n      { axis: \"desc\", raw: \"div[@id='main']\", name: \"div\" },\n      { axis: \"child\", raw: \"span\", name: \"span\" },\n    ];\n    expect(buildXPathFromSteps(steps)).toBe(\"/iframe[1]//div[@id='main']/span\");\n  });\n\n  it(\"returns '/' for empty sequences\", () => {\n    expect(buildXPathFromSteps([])).toBe(\"/\");\n  });\n});\n\ndescribe(\"listChildrenOf\", () => {\n  it(\"returns direct children whose parent matches the provided id\", () => {\n    const parentByFrame = new Map<string, string | null>([\n      [\"frame-1\", null],\n      [\"frame-2\", \"frame-1\"],\n      [\"frame-3\", \"frame-1\"],\n      [\"frame-4\", \"frame-2\"],\n    ]);\n    expect(listChildrenOf(parentByFrame, \"frame-1\")).toEqual([\n      \"frame-2\",\n      \"frame-3\",\n    ]);\n    expect(listChildrenOf(parentByFrame, \"frame-4\")).toEqual([]);\n  });\n});\n"],
+  "mappings": "AACA,SAAS,UAAU,QAAQ,UAAU;AACrC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,qBAAqB,MAAM;AAClC,KAAG,+CAA+C,MAAM;AACtD,UAAM,QAAQ,kBAAkB,4BAA4B;AAC5D,WAAO,KAAK,EAAE,QAAQ;AAAA,MACpB,EAAE,MAAM,QAAQ,KAAK,aAAa,MAAM,SAAS;AAAA,MACjD,EAAE,MAAM,SAAS,KAAK,UAAU,MAAM,MAAM;AAAA,MAC5C,EAAE,MAAM,QAAQ,KAAK,QAAQ,MAAM,OAAO;AAAA,IAC5C,CAAC;AAAA,EACH,CAAC;AAED,KAAG,uDAAuD,MAAM;AAC9D,WAAO,kBAAkB,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC3C,WAAO,kBAAkB,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;AAAA,EAC5C,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,MAAM;AACpC,KAAG,sDAAsD,MAAM;AAC7D,UAAM,QAA6B;AAAA,MACjC,EAAE,MAAM,SAAS,KAAK,aAAa,MAAM,SAAS;AAAA,MAClD,EAAE,MAAM,QAAQ,KAAK,mBAAmB,MAAM,MAAM;AAAA,MACpD,EAAE,MAAM,SAAS,KAAK,QAAQ,MAAM,OAAO;AAAA,IAC7C;AACA,WAAO,oBAAoB,KAAK,CAAC,EAAE,KAAK,kCAAkC;AAAA,EAC5E,CAAC;AAED,KAAG,mCAAmC,MAAM;AAC1C,WAAO,oBAAoB,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG;AAAA,EAC1C,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,MAAM;AAC/B,KAAG,gEAAgE,MAAM;AACvE,UAAM,gBAAgB,oBAAI,IAA2B;AAAA,MACnD,CAAC,WAAW,IAAI;AAAA,MAChB,CAAC,WAAW,SAAS;AAAA,MACrB,CAAC,WAAW,SAAS;AAAA,MACrB,CAAC,WAAW,SAAS;AAAA,IACvB,CAAC;AACD,WAAO,eAAe,eAAe,SAAS,CAAC,EAAE,QAAQ;AAAA,MACvD;AAAA,MACA;AAAA,IACF,CAAC;AACD,WAAO,eAAe,eAAe,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;AAAA,EAC7D,CAAC;AACH,CAAC;",
+  "names": []
+}