@browserbasehq/orca 3.0.9-alpha-3 → 3.1.0-headers

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

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const focusSelectors_js_1 = require("../../lib/v3/understudy/a11y/snapshot/focusSelectors.js");
+(0, vitest_1.describe)("parseXPathToSteps", () => {
+    (0, vitest_1.it)("records axis direction and normalized names", () => {
+        const steps = (0, focusSelectors_js_1.parseXPathToSteps)(" //iframe[1]/div[2]//SPAN ");
+        (0, vitest_1.expect)(steps).toEqual([
+            { axis: "desc", raw: "iframe[1]", name: "iframe" },
+            { axis: "child", raw: "div[2]", name: "div" },
+            { axis: "desc", raw: "SPAN", name: "span" },
+        ]);
+    });
+    (0, vitest_1.it)("drops empty segments and returns [] for blank input", () => {
+        (0, vitest_1.expect)((0, focusSelectors_js_1.parseXPathToSteps)("   ")).toEqual([]);
+        (0, vitest_1.expect)((0, focusSelectors_js_1.parseXPathToSteps)("/ ")).toEqual([]);
+    });
+});
+(0, vitest_1.describe)("buildXPathFromSteps", () => {
+    (0, vitest_1.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" },
+        ];
+        (0, vitest_1.expect)((0, focusSelectors_js_1.buildXPathFromSteps)(steps)).toBe("/iframe[1]//div[@id='main']/span");
+    });
+    (0, vitest_1.it)("returns '/' for empty sequences", () => {
+        (0, vitest_1.expect)((0, focusSelectors_js_1.buildXPathFromSteps)([])).toBe("/");
+    });
+});
+(0, vitest_1.describe)("IFRAME_STEP_RE — frame boundary detection", () => {
+    (0, vitest_1.it)("matches both iframe and frame with optional index", () => {
+        (0, vitest_1.expect)(focusSelectors_js_1.IFRAME_STEP_RE.test("iframe")).toBe(true);
+        (0, vitest_1.expect)(focusSelectors_js_1.IFRAME_STEP_RE.test("iframe[1]")).toBe(true);
+        (0, vitest_1.expect)(focusSelectors_js_1.IFRAME_STEP_RE.test("frame")).toBe(true);
+        (0, vitest_1.expect)(focusSelectors_js_1.IFRAME_STEP_RE.test("frame[4]")).toBe(true);
+    });
+    (0, vitest_1.it)("does NOT match frameset", () => {
+        (0, vitest_1.expect)(focusSelectors_js_1.IFRAME_STEP_RE.test("frameset")).toBe(false);
+        (0, vitest_1.expect)(focusSelectors_js_1.IFRAME_STEP_RE.test("frameset[1]")).toBe(false);
+    });
+});
+(0, vitest_1.describe)("parseXPathToSteps — frameset XPaths", () => {
+    (0, vitest_1.it)("parses a frameset page XPath with frame[N] steps", () => {
+        const steps = (0, focusSelectors_js_1.parseXPathToSteps)("/html[1]/frameset[1]/frame[4]/html[1]/body[1]/table[1]");
+        (0, vitest_1.expect)(steps).toEqual([
+            { axis: "child", raw: "html[1]", name: "html" },
+            { axis: "child", raw: "frameset[1]", name: "frameset" },
+            { axis: "child", raw: "frame[4]", name: "frame" },
+            { axis: "child", raw: "html[1]", name: "html" },
+            { axis: "child", raw: "body[1]", name: "body" },
+            { axis: "child", raw: "table[1]", name: "table" },
+        ]);
+        // frame[4] step should be detected as a frame boundary
+        const frameBoundaries = steps.filter((s) => focusSelectors_js_1.IFRAME_STEP_RE.test(s.name));
+        (0, vitest_1.expect)(frameBoundaries).toHaveLength(1);
+        (0, vitest_1.expect)(frameBoundaries[0].raw).toBe("frame[4]");
+    });
+    (0, vitest_1.it)("detects iframe boundaries in standard iframe XPaths", () => {
+        const steps = (0, focusSelectors_js_1.parseXPathToSteps)("/html[1]/body[1]/div[2]/iframe[1]/html[1]/body[1]/p[1]");
+        const frameBoundaries = steps.filter((s) => focusSelectors_js_1.IFRAME_STEP_RE.test(s.name));
+        (0, vitest_1.expect)(frameBoundaries).toHaveLength(1);
+        (0, vitest_1.expect)(frameBoundaries[0].raw).toBe("iframe[1]");
+    });
+    (0, vitest_1.it)("does NOT detect frameset as a frame boundary", () => {
+        const steps = (0, focusSelectors_js_1.parseXPathToSteps)("/html[1]/frameset[1]/frame[2]");
+        const frameBoundaries = steps.filter((s) => focusSelectors_js_1.IFRAME_STEP_RE.test(s.name));
+        (0, vitest_1.expect)(frameBoundaries).toHaveLength(1);
+        // Only frame[2] matches, not frameset[1]
+        (0, vitest_1.expect)(frameBoundaries[0].raw).toBe("frame[2]");
+    });
+});
+(0, vitest_1.describe)("listChildrenOf", () => {
+    (0, vitest_1.it)("returns direct children whose parent matches the provided id", () => {
+        const parentByFrame = new Map([
+            ["frame-1", null],
+            ["frame-2", "frame-1"],
+            ["frame-3", "frame-1"],
+            ["frame-4", "frame-2"],
+        ]);
+        (0, vitest_1.expect)((0, focusSelectors_js_1.listChildrenOf)(parentByFrame, "frame-1")).toEqual([
+            "frame-2",
+            "frame-3",
+        ]);
+        (0, vitest_1.expect)((0, focusSelectors_js_1.listChildrenOf)(parentByFrame, "frame-4")).toEqual([]);
+    });
+});
+//# sourceMappingURL=snapshot-focus-selectors-utils.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-focus-selectors-utils.test.js","sourceRoot":"","sources":["../../../../tests/unit/snapshot-focus-selectors-utils.test.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Step } from \"../../lib/v3/types/private/snapshot.js\";\nimport { describe, expect, it } from \"vitest\";\nimport {\n  buildXPathFromSteps,\n  IFRAME_STEP_RE,\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(\"IFRAME_STEP_RE — frame boundary detection\", () => {\n  it(\"matches both iframe and frame with optional index\", () => {\n    expect(IFRAME_STEP_RE.test(\"iframe\")).toBe(true);\n    expect(IFRAME_STEP_RE.test(\"iframe[1]\")).toBe(true);\n    expect(IFRAME_STEP_RE.test(\"frame\")).toBe(true);\n    expect(IFRAME_STEP_RE.test(\"frame[4]\")).toBe(true);\n  });\n\n  it(\"does NOT match frameset\", () => {\n    expect(IFRAME_STEP_RE.test(\"frameset\")).toBe(false);\n    expect(IFRAME_STEP_RE.test(\"frameset[1]\")).toBe(false);\n  });\n});\n\ndescribe(\"parseXPathToSteps — frameset XPaths\", () => {\n  it(\"parses a frameset page XPath with frame[N] steps\", () => {\n    const steps = parseXPathToSteps(\n      \"/html[1]/frameset[1]/frame[4]/html[1]/body[1]/table[1]\",\n    );\n    expect(steps).toEqual([\n      { axis: \"child\", raw: \"html[1]\", name: \"html\" },\n      { axis: \"child\", raw: \"frameset[1]\", name: \"frameset\" },\n      { axis: \"child\", raw: \"frame[4]\", name: \"frame\" },\n      { axis: \"child\", raw: \"html[1]\", name: \"html\" },\n      { axis: \"child\", raw: \"body[1]\", name: \"body\" },\n      { axis: \"child\", raw: \"table[1]\", name: \"table\" },\n    ]);\n    // frame[4] step should be detected as a frame boundary\n    const frameBoundaries = steps.filter((s) => IFRAME_STEP_RE.test(s.name));\n    expect(frameBoundaries).toHaveLength(1);\n    expect(frameBoundaries[0].raw).toBe(\"frame[4]\");\n  });\n\n  it(\"detects iframe boundaries in standard iframe XPaths\", () => {\n    const steps = parseXPathToSteps(\n      \"/html[1]/body[1]/div[2]/iframe[1]/html[1]/body[1]/p[1]\",\n    );\n    const frameBoundaries = steps.filter((s) => IFRAME_STEP_RE.test(s.name));\n    expect(frameBoundaries).toHaveLength(1);\n    expect(frameBoundaries[0].raw).toBe(\"iframe[1]\");\n  });\n\n  it(\"does NOT detect frameset as a frame boundary\", () => {\n    const steps = parseXPathToSteps(\"/html[1]/frameset[1]/frame[2]\");\n    const frameBoundaries = steps.filter((s) => IFRAME_STEP_RE.test(s.name));\n    expect(frameBoundaries).toHaveLength(1);\n    // Only frame[2] matches, not frameset[1]\n    expect(frameBoundaries[0].raw).toBe(\"frame[2]\");\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"]}

package/dist/cjs/tests/unit/snapshot-frame-merge.test.d.ts

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

package/dist/cjs/tests/unit/snapshot-frame-merge.test.js

@@ -0,0 +1,335 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const mockCDPSession_js_1 = require("./helpers/mockCDPSession.js");
+const capture_js_1 = require("../../lib/v3/understudy/a11y/snapshot/capture.js");
+const makePage = (sessions) => ({
+    getSessionForFrame: (frameId) => sessions[frameId] ?? sessions.root,
+    getOrdinal: (frameId) => frameId === "frame-1" ? 0 : frameId === "frame-2" ? 1 : 2,
+});
+(0, vitest_1.describe)("computeFramePrefixes", () => {
+    (0, vitest_1.it)("derives prefixes from parent iframe xpaths within the same session", async () => {
+        const parentSession = new mockCDPSession_js_1.MockCDPSession({
+            "DOM.getFrameOwner": async () => ({ backendNodeId: 200 }),
+        });
+        const page = makePage({
+            "frame-1": parentSession,
+            "frame-2": parentSession,
+            root: parentSession,
+        });
+        const perFrameMaps = new Map([
+            [
+                "frame-1",
+                {
+                    tagNameMap: {},
+                    scrollableMap: {},
+                    urlMap: {},
+                    xpathMap: { "0-200": "/html[1]/body[1]/iframe[1]" },
+                },
+            ],
+        ]);
+        const context = {
+            rootId: "frame-1",
+            frames: ["frame-1", "frame-2"],
+            parentByFrame: new Map([
+                ["frame-1", null],
+                ["frame-2", "frame-1"],
+            ]),
+        };
+        const { absPrefix, iframeHostEncByChild } = await (0, capture_js_1.computeFramePrefixes)(page, context, perFrameMaps, context.frames);
+        (0, vitest_1.expect)(absPrefix.get("frame-1")).toBe("");
+        (0, vitest_1.expect)(absPrefix.get("frame-2")).toBe("/html[1]/body[1]/iframe[1]");
+        (0, vitest_1.expect)(iframeHostEncByChild.get("frame-2")).toBe("0-200");
+    });
+    (0, vitest_1.it)("inherits the parent prefix when frame owner lookups fail (OOPIF)", async () => {
+        const parentSession = new mockCDPSession_js_1.MockCDPSession({
+            "DOM.getFrameOwner": async (params) => {
+                if (params?.frameId === "frame-2")
+                    return { backendNodeId: 200 };
+                if (params?.frameId === "frame-3")
+                    throw new Error("unavailable");
+                return {};
+            },
+        });
+        const page = makePage({
+            "frame-1": parentSession,
+            "frame-2": parentSession,
+            "frame-3": parentSession,
+            root: parentSession,
+        });
+        const perFrameMaps = new Map([
+            [
+                "frame-1",
+                {
+                    tagNameMap: {},
+                    scrollableMap: {},
+                    urlMap: {},
+                    xpathMap: { "0-200": "/iframe[1]" },
+                },
+            ],
+            [
+                "frame-2",
+                {
+                    tagNameMap: {},
+                    scrollableMap: {},
+                    urlMap: {},
+                    xpathMap: { "1-300": "/div[1]/iframe[1]" },
+                },
+            ],
+        ]);
+        const context = {
+            rootId: "frame-1",
+            frames: ["frame-1", "frame-2", "frame-3"],
+            parentByFrame: new Map([
+                ["frame-1", null],
+                ["frame-2", "frame-1"],
+                ["frame-3", "frame-2"],
+            ]),
+        };
+        const maps = await (0, capture_js_1.computeFramePrefixes)(page, context, perFrameMaps, context.frames);
+        (0, vitest_1.expect)(maps.absPrefix.get("frame-2")).toBe("/iframe[1]");
+        (0, vitest_1.expect)(maps.absPrefix.get("frame-3")).toBe("/iframe[1]");
+    });
+    (0, vitest_1.it)("inherits parent prefix when iframe xpath mapping is missing", async () => {
+        const session = new mockCDPSession_js_1.MockCDPSession({
+            "DOM.getFrameOwner": async () => ({ backendNodeId: 999 }),
+        });
+        const page = makePage({
+            "frame-1": session,
+            "frame-2": session,
+            root: session,
+        });
+        const perFrameMaps = new Map([
+            [
+                "frame-1",
+                {
+                    tagNameMap: {},
+                    scrollableMap: {},
+                    urlMap: {},
+                    xpathMap: {},
+                },
+            ],
+        ]);
+        const context = {
+            rootId: "frame-1",
+            frames: ["frame-1", "frame-2"],
+            parentByFrame: new Map([
+                ["frame-1", null],
+                ["frame-2", "frame-1"],
+            ]),
+        };
+        const result = await (0, capture_js_1.computeFramePrefixes)(page, context, perFrameMaps, context.frames);
+        (0, vitest_1.expect)(result.absPrefix.get("frame-2")).toBe("");
+    });
+    (0, vitest_1.it)("does not compute prefixes for frames excluded from the scope", async () => {
+        const session = new mockCDPSession_js_1.MockCDPSession({
+            "DOM.getFrameOwner": async () => ({ backendNodeId: 200 }),
+        });
+        const page = makePage({
+            "frame-1": session,
+            "frame-2": session,
+            root: session,
+        });
+        const perFrameMaps = new Map([
+            [
+                "frame-1",
+                {
+                    tagNameMap: {},
+                    scrollableMap: {},
+                    urlMap: {},
+                    xpathMap: { "0-200": "/iframe[1]" },
+                },
+            ],
+        ]);
+        const context = {
+            rootId: "frame-1",
+            frames: ["frame-1", "frame-2"],
+            parentByFrame: new Map([
+                ["frame-1", null],
+                ["frame-2", "frame-1"],
+            ]),
+        };
+        const { absPrefix, iframeHostEncByChild } = await (0, capture_js_1.computeFramePrefixes)(page, context, perFrameMaps, ["frame-1"]);
+        (0, vitest_1.expect)(absPrefix.has("frame-2")).toBe(false);
+        (0, vitest_1.expect)(iframeHostEncByChild.has("frame-2")).toBe(false);
+    });
+});
+(0, vitest_1.describe)("mergeFramesIntoSnapshot", () => {
+    (0, vitest_1.it)("merges root and child maps, prefixing child xpaths and injecting subtrees", () => {
+        const context = {
+            rootId: "frame-1",
+            frames: ["frame-1", "frame-2"],
+            parentByFrame: new Map([
+                ["frame-1", null],
+                ["frame-2", "frame-1"],
+            ]),
+        };
+        const perFrameMaps = new Map([
+            [
+                "frame-1",
+                {
+                    tagNameMap: {},
+                    scrollableMap: {},
+                    urlMap: { "0-10": "https://example.com" },
+                    xpathMap: { "0-10": "/html[1]/body[1]" },
+                },
+            ],
+            [
+                "frame-2",
+                {
+                    tagNameMap: {},
+                    scrollableMap: {},
+                    urlMap: { "1-20": "https://child.com" },
+                    xpathMap: { "1-20": "/div[1]/span[1]" },
+                },
+            ],
+        ]);
+        const perFrameOutlines = [
+            { frameId: "frame-1", outline: "[0-10] body\n  [0-200] iframe" },
+            { frameId: "frame-2", outline: "[1-20] child" },
+        ];
+        const absPrefix = new Map([
+            ["frame-1", ""],
+            ["frame-2", "/html[1]/body[1]/iframe[1]"],
+        ]);
+        const iframeHostEncByChild = new Map([
+            ["frame-2", "0-200"],
+        ]);
+        const snapshot = (0, capture_js_1.mergeFramesIntoSnapshot)(context, perFrameMaps, perFrameOutlines, absPrefix, iframeHostEncByChild, context.frames);
+        (0, vitest_1.expect)(snapshot.combinedXpathMap["0-10"]).toBe("/html[1]/body[1]");
+        (0, vitest_1.expect)(snapshot.combinedXpathMap["1-20"]).toBe("/html[1]/body[1]/iframe[1]/div[1]/span[1]");
+        (0, vitest_1.expect)(snapshot.combinedUrlMap["1-20"]).toBe("https://child.com");
+        (0, vitest_1.expect)(snapshot.combinedTree).toContain("[1-20] child");
+    });
+    (0, vitest_1.it)("skips frames without maps and handles missing iframe mappings", () => {
+        const context = {
+            rootId: "frame-1",
+            frames: ["frame-1", "frame-2"],
+            parentByFrame: new Map([
+                ["frame-1", null],
+                ["frame-2", "frame-1"],
+            ]),
+        };
+        const perFrameMaps = new Map([
+            [
+                "frame-1",
+                {
+                    tagNameMap: {},
+                    scrollableMap: {},
+                    urlMap: {},
+                    xpathMap: { "0-10": "/html[1]" },
+                },
+            ],
+        ]);
+        const perFrameOutlines = [
+            { frameId: "frame-1", outline: "[0-10] html" },
+            { frameId: "frame-2", outline: "[1-20] orphan" },
+        ];
+        const absPrefix = new Map([
+            ["frame-1", ""],
+            ["frame-2", "/missing"],
+        ]);
+        const snapshot = (0, capture_js_1.mergeFramesIntoSnapshot)(context, perFrameMaps, perFrameOutlines, absPrefix, new Map(), context.frames);
+        (0, vitest_1.expect)(snapshot.combinedXpathMap["1-20"]).toBeUndefined();
+        (0, vitest_1.expect)(snapshot.combinedTree).toBe("[0-10] html");
+    });
+    (0, vitest_1.it)("falls back to first outline when root frame outline is missing", () => {
+        const context = {
+            rootId: "frame-1",
+            frames: ["frame-1", "frame-2"],
+            parentByFrame: new Map([
+                ["frame-1", null],
+                ["frame-2", "frame-1"],
+            ]),
+        };
+        const perFrameMaps = new Map([
+            [
+                "frame-2",
+                {
+                    tagNameMap: {},
+                    scrollableMap: {},
+                    urlMap: {},
+                    xpathMap: {},
+                },
+            ],
+        ]);
+        const perFrameOutlines = [
+            { frameId: "frame-2", outline: "[child] frame2" },
+        ];
+        const snapshot = (0, capture_js_1.mergeFramesIntoSnapshot)(context, perFrameMaps, perFrameOutlines, new Map([["frame-2", "/iframe[1]"]]), new Map(), context.frames);
+        (0, vitest_1.expect)(snapshot.combinedTree).toBe("[child] frame2");
+    });
+    (0, vitest_1.it)("overwrites duplicate iframe host entries when multiple children map to the same parent", () => {
+        const context = {
+            rootId: "frame-1",
+            frames: ["frame-1", "frame-2", "frame-3"],
+            parentByFrame: new Map([
+                ["frame-1", null],
+                ["frame-2", "frame-1"],
+                ["frame-3", "frame-1"],
+            ]),
+        };
+        const perFrameMaps = new Map([
+            [
+                "frame-1",
+                {
+                    tagNameMap: {},
+                    scrollableMap: {},
+                    urlMap: {},
+                    xpathMap: {},
+                },
+            ],
+        ]);
+        const perFrameOutlines = [
+            { frameId: "frame-1", outline: "[root] frame1\n  [0-200] iframe slot" },
+            { frameId: "frame-2", outline: "[child] frame2" },
+            { frameId: "frame-3", outline: "[child] frame3" },
+        ];
+        const snapshot = (0, capture_js_1.mergeFramesIntoSnapshot)(context, perFrameMaps, perFrameOutlines, new Map([
+            ["frame-1", ""],
+            ["frame-2", ""],
+            ["frame-3", ""],
+        ]), new Map([
+            ["frame-2", "0-200"],
+            ["frame-3", "0-200"],
+        ]), context.frames);
+        (0, vitest_1.expect)(snapshot.combinedTree).toContain("[child] frame3");
+        (0, vitest_1.expect)(snapshot.combinedTree).not.toContain("[child] frame2");
+    });
+    (0, vitest_1.it)("only merges xpath and url maps for frames included in frameIds", () => {
+        const context = {
+            rootId: "frame-1",
+            frames: ["frame-1", "frame-2"],
+            parentByFrame: new Map([
+                ["frame-1", null],
+                ["frame-2", "frame-1"],
+            ]),
+        };
+        const perFrameMaps = new Map([
+            [
+                "frame-1",
+                {
+                    tagNameMap: {},
+                    scrollableMap: {},
+                    urlMap: { "0-10": "https://root.test" },
+                    xpathMap: { "0-10": "/html[1]" },
+                },
+            ],
+            [
+                "frame-2",
+                {
+                    tagNameMap: {},
+                    scrollableMap: {},
+                    urlMap: { "1-20": "https://child.test" },
+                    xpathMap: { "1-20": "/div[1]" },
+                },
+            ],
+        ]);
+        const perFrameOutlines = [{ frameId: "frame-1", outline: "[root] doc" }];
+        const snapshot = (0, capture_js_1.mergeFramesIntoSnapshot)(context, perFrameMaps, perFrameOutlines, new Map([["frame-1", ""]]), new Map(), ["frame-1"]);
+        (0, vitest_1.expect)(snapshot.combinedXpathMap["0-10"]).toBe("/html[1]");
+        (0, vitest_1.expect)(snapshot.combinedXpathMap["1-20"]).toBeUndefined();
+        (0, vitest_1.expect)(snapshot.perFrame?.map((pf) => pf.frameId)).toEqual(["frame-1"]);
+    });
+});
+//# sourceMappingURL=snapshot-frame-merge.test.js.map

package/dist/cjs/tests/unit/snapshot-frame-merge.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-frame-merge.test.js","sourceRoot":"","sources":["../../../../tests/unit/snapshot-frame-merge.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport type {\n  FrameContext,\n  FrameDomMaps,\n} from \"../../lib/v3/types/private/index.js\";\nimport type { Page } from \"../../lib/v3/understudy/page.js\";\nimport { MockCDPSession } from \"./helpers/mockCDPSession.js\";\nimport {\n  computeFramePrefixes,\n  mergeFramesIntoSnapshot,\n} from \"../../lib/v3/understudy/a11y/snapshot/capture.js\";\n\nconst makePage = (sessions: Record<string, MockCDPSession>): Page =>\n  ({\n    getSessionForFrame: (frameId: string) => sessions[frameId] ?? sessions.root,\n    getOrdinal: (frameId: string) =>\n      frameId === \"frame-1\" ? 0 : frameId === \"frame-2\" ? 1 : 2,\n  }) as unknown as Page;\n\ndescribe(\"computeFramePrefixes\", () => {\n  it(\"derives prefixes from parent iframe xpaths within the same session\", async () => {\n    const parentSession = new MockCDPSession({\n      \"DOM.getFrameOwner\": async () => ({ backendNodeId: 200 }),\n    });\n    const page = makePage({\n      \"frame-1\": parentSession,\n      \"frame-2\": parentSession,\n      root: parentSession,\n    });\n\n    const perFrameMaps = new Map<string, FrameDomMaps>([\n      [\n        \"frame-1\",\n        {\n          tagNameMap: {},\n          scrollableMap: {},\n          urlMap: {},\n          xpathMap: { \"0-200\": \"/html[1]/body[1]/iframe[1]\" },\n        },\n      ],\n    ]);\n\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 { absPrefix, iframeHostEncByChild } = await computeFramePrefixes(\n      page,\n      context,\n      perFrameMaps,\n      context.frames,\n    );\n\n    expect(absPrefix.get(\"frame-1\")).toBe(\"\");\n    expect(absPrefix.get(\"frame-2\")).toBe(\"/html[1]/body[1]/iframe[1]\");\n    expect(iframeHostEncByChild.get(\"frame-2\")).toBe(\"0-200\");\n  });\n\n  it(\"inherits the parent prefix when frame owner lookups fail (OOPIF)\", async () => {\n    const parentSession = new MockCDPSession({\n      \"DOM.getFrameOwner\": async (params) => {\n        if (params?.frameId === \"frame-2\") return { backendNodeId: 200 };\n        if (params?.frameId === \"frame-3\") throw new Error(\"unavailable\");\n        return {};\n      },\n    });\n    const page = makePage({\n      \"frame-1\": parentSession,\n      \"frame-2\": parentSession,\n      \"frame-3\": parentSession,\n      root: parentSession,\n    });\n\n    const perFrameMaps = new Map<string, FrameDomMaps>([\n      [\n        \"frame-1\",\n        {\n          tagNameMap: {},\n          scrollableMap: {},\n          urlMap: {},\n          xpathMap: { \"0-200\": \"/iframe[1]\" },\n        },\n      ],\n      [\n        \"frame-2\",\n        {\n          tagNameMap: {},\n          scrollableMap: {},\n          urlMap: {},\n          xpathMap: { \"1-300\": \"/div[1]/iframe[1]\" },\n        },\n      ],\n    ]);\n\n    const context: FrameContext = {\n      rootId: \"frame-1\",\n      frames: [\"frame-1\", \"frame-2\", \"frame-3\"],\n      parentByFrame: new Map([\n        [\"frame-1\", null],\n        [\"frame-2\", \"frame-1\"],\n        [\"frame-3\", \"frame-2\"],\n      ]),\n    };\n\n    const maps = await computeFramePrefixes(\n      page,\n      context,\n      perFrameMaps,\n      context.frames,\n    );\n\n    expect(maps.absPrefix.get(\"frame-2\")).toBe(\"/iframe[1]\");\n    expect(maps.absPrefix.get(\"frame-3\")).toBe(\"/iframe[1]\");\n  });\n\n  it(\"inherits parent prefix when iframe xpath mapping is missing\", async () => {\n    const session = new MockCDPSession({\n      \"DOM.getFrameOwner\": async () => ({ backendNodeId: 999 }),\n    });\n    const page = makePage({\n      \"frame-1\": session,\n      \"frame-2\": session,\n      root: session,\n    });\n\n    const perFrameMaps = new Map<string, FrameDomMaps>([\n      [\n        \"frame-1\",\n        {\n          tagNameMap: {},\n          scrollableMap: {},\n          urlMap: {},\n          xpathMap: {},\n        },\n      ],\n    ]);\n\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 result = await computeFramePrefixes(\n      page,\n      context,\n      perFrameMaps as Map<string, FrameDomMaps>,\n      context.frames,\n    );\n    expect(result.absPrefix.get(\"frame-2\")).toBe(\"\");\n  });\n\n  it(\"does not compute prefixes for frames excluded from the scope\", async () => {\n    const session = new MockCDPSession({\n      \"DOM.getFrameOwner\": async () => ({ backendNodeId: 200 }),\n    });\n    const page = makePage({\n      \"frame-1\": session,\n      \"frame-2\": session,\n      root: session,\n    });\n\n    const perFrameMaps = new Map<string, FrameDomMaps>([\n      [\n        \"frame-1\",\n        {\n          tagNameMap: {},\n          scrollableMap: {},\n          urlMap: {},\n          xpathMap: { \"0-200\": \"/iframe[1]\" },\n        },\n      ],\n    ]);\n\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 { absPrefix, iframeHostEncByChild } = await computeFramePrefixes(\n      page,\n      context,\n      perFrameMaps,\n      [\"frame-1\"],\n    );\n\n    expect(absPrefix.has(\"frame-2\")).toBe(false);\n    expect(iframeHostEncByChild.has(\"frame-2\")).toBe(false);\n  });\n});\n\ndescribe(\"mergeFramesIntoSnapshot\", () => {\n  it(\"merges root and child maps, prefixing child xpaths and injecting subtrees\", () => {\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 perFrameMaps = new Map<string, FrameDomMaps>([\n      [\n        \"frame-1\",\n        {\n          tagNameMap: {},\n          scrollableMap: {},\n          urlMap: { \"0-10\": \"https://example.com\" },\n          xpathMap: { \"0-10\": \"/html[1]/body[1]\" },\n        },\n      ],\n      [\n        \"frame-2\",\n        {\n          tagNameMap: {},\n          scrollableMap: {},\n          urlMap: { \"1-20\": \"https://child.com\" },\n          xpathMap: { \"1-20\": \"/div[1]/span[1]\" },\n        },\n      ],\n    ]);\n\n    const perFrameOutlines = [\n      { frameId: \"frame-1\", outline: \"[0-10] body\\n  [0-200] iframe\" },\n      { frameId: \"frame-2\", outline: \"[1-20] child\" },\n    ];\n\n    const absPrefix = new Map<string, string>([\n      [\"frame-1\", \"\"],\n      [\"frame-2\", \"/html[1]/body[1]/iframe[1]\"],\n    ]);\n    const iframeHostEncByChild = new Map<string, string>([\n      [\"frame-2\", \"0-200\"],\n    ]);\n\n    const snapshot = mergeFramesIntoSnapshot(\n      context,\n      perFrameMaps,\n      perFrameOutlines,\n      absPrefix,\n      iframeHostEncByChild,\n      context.frames,\n    );\n\n    expect(snapshot.combinedXpathMap[\"0-10\"]).toBe(\"/html[1]/body[1]\");\n    expect(snapshot.combinedXpathMap[\"1-20\"]).toBe(\n      \"/html[1]/body[1]/iframe[1]/div[1]/span[1]\",\n    );\n    expect(snapshot.combinedUrlMap[\"1-20\"]).toBe(\"https://child.com\");\n    expect(snapshot.combinedTree).toContain(\"[1-20] child\");\n  });\n\n  it(\"skips frames without maps and handles missing iframe mappings\", () => {\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 perFrameMaps = new Map<string, FrameDomMaps>([\n      [\n        \"frame-1\",\n        {\n          tagNameMap: {},\n          scrollableMap: {},\n          urlMap: {},\n          xpathMap: { \"0-10\": \"/html[1]\" },\n        },\n      ],\n    ]);\n\n    const perFrameOutlines = [\n      { frameId: \"frame-1\", outline: \"[0-10] html\" },\n      { frameId: \"frame-2\", outline: \"[1-20] orphan\" },\n    ];\n\n    const absPrefix = new Map<string, string>([\n      [\"frame-1\", \"\"],\n      [\"frame-2\", \"/missing\"],\n    ]);\n\n    const snapshot = mergeFramesIntoSnapshot(\n      context,\n      perFrameMaps,\n      perFrameOutlines,\n      absPrefix,\n      new Map(),\n      context.frames,\n    );\n\n    expect(snapshot.combinedXpathMap[\"1-20\"]).toBeUndefined();\n    expect(snapshot.combinedTree).toBe(\"[0-10] html\");\n  });\n\n  it(\"falls back to first outline when root frame outline is missing\", () => {\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 perFrameMaps = new Map<string, FrameDomMaps>([\n      [\n        \"frame-2\",\n        {\n          tagNameMap: {},\n          scrollableMap: {},\n          urlMap: {},\n          xpathMap: {},\n        },\n      ],\n    ]);\n\n    const perFrameOutlines = [\n      { frameId: \"frame-2\", outline: \"[child] frame2\" },\n    ];\n\n    const snapshot = mergeFramesIntoSnapshot(\n      context,\n      perFrameMaps,\n      perFrameOutlines,\n      new Map([[\"frame-2\", \"/iframe[1]\"]]),\n      new Map(),\n      context.frames,\n    );\n\n    expect(snapshot.combinedTree).toBe(\"[child] frame2\");\n  });\n\n  it(\"overwrites duplicate iframe host entries when multiple children map to the same parent\", () => {\n    const context: FrameContext = {\n      rootId: \"frame-1\",\n      frames: [\"frame-1\", \"frame-2\", \"frame-3\"],\n      parentByFrame: new Map([\n        [\"frame-1\", null],\n        [\"frame-2\", \"frame-1\"],\n        [\"frame-3\", \"frame-1\"],\n      ]),\n    };\n\n    const perFrameMaps = new Map<string, FrameDomMaps>([\n      [\n        \"frame-1\",\n        {\n          tagNameMap: {},\n          scrollableMap: {},\n          urlMap: {},\n          xpathMap: {},\n        },\n      ],\n    ]);\n\n    const perFrameOutlines = [\n      { frameId: \"frame-1\", outline: \"[root] frame1\\n  [0-200] iframe slot\" },\n      { frameId: \"frame-2\", outline: \"[child] frame2\" },\n      { frameId: \"frame-3\", outline: \"[child] frame3\" },\n    ];\n\n    const snapshot = mergeFramesIntoSnapshot(\n      context,\n      perFrameMaps,\n      perFrameOutlines,\n      new Map([\n        [\"frame-1\", \"\"],\n        [\"frame-2\", \"\"],\n        [\"frame-3\", \"\"],\n      ]),\n      new Map([\n        [\"frame-2\", \"0-200\"],\n        [\"frame-3\", \"0-200\"],\n      ]),\n      context.frames,\n    );\n\n    expect(snapshot.combinedTree).toContain(\"[child] frame3\");\n    expect(snapshot.combinedTree).not.toContain(\"[child] frame2\");\n  });\n\n  it(\"only merges xpath and url maps for frames included in frameIds\", () => {\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 perFrameMaps = new Map<string, FrameDomMaps>([\n      [\n        \"frame-1\",\n        {\n          tagNameMap: {},\n          scrollableMap: {},\n          urlMap: { \"0-10\": \"https://root.test\" },\n          xpathMap: { \"0-10\": \"/html[1]\" },\n        },\n      ],\n      [\n        \"frame-2\",\n        {\n          tagNameMap: {},\n          scrollableMap: {},\n          urlMap: { \"1-20\": \"https://child.test\" },\n          xpathMap: { \"1-20\": \"/div[1]\" },\n        },\n      ],\n    ]);\n\n    const perFrameOutlines = [{ frameId: \"frame-1\", outline: \"[root] doc\" }];\n\n    const snapshot = mergeFramesIntoSnapshot(\n      context,\n      perFrameMaps,\n      perFrameOutlines,\n      new Map([[\"frame-1\", \"\"]]),\n      new Map(),\n      [\"frame-1\"],\n    );\n\n    expect(snapshot.combinedXpathMap[\"0-10\"]).toBe(\"/html[1]\");\n    expect(snapshot.combinedXpathMap[\"1-20\"]).toBeUndefined();\n    expect(snapshot.perFrame?.map((pf) => pf.frameId)).toEqual([\"frame-1\"]);\n  });\n});\n"]}

package/dist/cjs/tests/unit/snapshot-tree-format-utils.test.d.ts

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

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

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const treeFormatUtils_js_1 = require("../../lib/v3/understudy/a11y/snapshot/treeFormatUtils.js");
+(0, vitest_1.describe)("formatTreeLine", () => {
+    (0, vitest_1.it)("includes encoded ids and indents children", () => {
+        const outline = (0, treeFormatUtils_js_1.formatTreeLine)({
+            role: "section",
+            name: "Container",
+            encodedId: "frame-1",
+            nodeId: "ax-1",
+            children: [
+                {
+                    role: "button",
+                    name: "Submit",
+                    nodeId: "ax-2",
+                },
+            ],
+        });
+        (0, vitest_1.expect)(outline).toBe("[frame-1] section: Container\n  [ax-2] button: Submit");
+    });
+});
+(0, vitest_1.describe)("injectSubtrees", () => {
+    (0, vitest_1.it)("nests child outlines under iframe encoded ids", () => {
+        const rootOutline = `[root] document\n  [iframe-1] iframe\n  [leaf] item`;
+        const iframeOutline = `[child-root] child\n  [nested-frame] iframe`;
+        const nestedOutline = `[nested-leaf] nested`;
+        const merged = (0, treeFormatUtils_js_1.injectSubtrees)(rootOutline, new Map([
+            ["iframe-1", iframeOutline],
+            ["nested-frame", nestedOutline],
+        ]));
+        (0, vitest_1.expect)(merged).toBe(`[root] document
+  [iframe-1] iframe
+    [child-root] child
+      [nested-frame] iframe
+        [nested-leaf] nested
+  [leaf] item`);
+    });
+    (0, vitest_1.it)("injects child outline only once when the same id repeats", () => {
+        const rootOutline = `[root] document
+  [iframe-1] iframe
+  [iframe-1] iframe`;
+        const iframeOutline = `[child-root] child`;
+        const merged = (0, treeFormatUtils_js_1.injectSubtrees)(rootOutline, new Map([["iframe-1", iframeOutline]]));
+        (0, vitest_1.expect)(merged).toBe(`[root] document
+  [iframe-1] iframe
+    [child-root] child
+  [iframe-1] iframe`);
+    });
+    (0, vitest_1.it)("returns the original outline when no encoded ids are matched", () => {
+        const outline = `[root] document\n  [leaf] item`;
+        (0, vitest_1.expect)((0, treeFormatUtils_js_1.injectSubtrees)(outline, new Map([["other", "[x] child"]]))).toBe(outline);
+    });
+});
+(0, vitest_1.describe)("indentBlock", () => {
+    (0, vitest_1.it)("prefixes each line with the provided indent", () => {
+        (0, vitest_1.expect)((0, treeFormatUtils_js_1.indentBlock)("a\nb", "  ")).toBe("  a\n  b");
+        (0, vitest_1.expect)((0, treeFormatUtils_js_1.indentBlock)("", "  ")).toBe("");
+    });
+});
+(0, vitest_1.describe)("diffCombinedTrees", () => {
+    (0, vitest_1.it)("returns newly-added lines relative to previous outline", () => {
+        const prev = `[root] document\n  [child] a`;
+        const next = `[root] document\n  [child] a\n  [child-2] b`;
+        (0, vitest_1.expect)((0, treeFormatUtils_js_1.diffCombinedTrees)(prev, next)).toBe("[child-2] b");
+    });
+    (0, vitest_1.it)("normalizes indentation for added lines with stray spaces", () => {
+        const prev = `[root] document\n    [child] a`;
+        const next = `[root] document\n    [child] a\n        [child-2] b`;
+        (0, vitest_1.expect)((0, treeFormatUtils_js_1.diffCombinedTrees)(prev, next)).toBe("[child-2] b");
+    });
+});
+(0, vitest_1.describe)("cleanText", () => {
+    (0, vitest_1.it)("removes NBSP and private-use characters while collapsing spaces", () => {
+        const dirty = `Hello\u00A0\u00A0world\uE000 !`;
+        (0, vitest_1.expect)((0, treeFormatUtils_js_1.cleanText)(dirty)).toBe("Hello world !");
+    });
+});
+(0, vitest_1.describe)("normaliseSpaces", () => {
+    (0, vitest_1.it)("replaces whitespace runs with a single space", () => {
+        (0, vitest_1.expect)((0, treeFormatUtils_js_1.normaliseSpaces)("a   b\tc\nd")).toBe("a b c d");
+    });
+});
+//# sourceMappingURL=snapshot-tree-format-utils.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-tree-format-utils.test.js","sourceRoot":"","sources":["../../../../tests/unit/snapshot-tree-format-utils.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport {\n  cleanText,\n  diffCombinedTrees,\n  formatTreeLine,\n  indentBlock,\n  injectSubtrees,\n  normaliseSpaces,\n} from \"../../lib/v3/understudy/a11y/snapshot/treeFormatUtils.js\";\n\ndescribe(\"formatTreeLine\", () => {\n  it(\"includes encoded ids and indents children\", () => {\n    const outline = formatTreeLine({\n      role: \"section\",\n      name: \"Container\",\n      encodedId: \"frame-1\",\n      nodeId: \"ax-1\",\n      children: [\n        {\n          role: \"button\",\n          name: \"Submit\",\n          nodeId: \"ax-2\",\n        },\n      ],\n    });\n\n    expect(outline).toBe(\n      \"[frame-1] section: Container\\n  [ax-2] button: Submit\",\n    );\n  });\n});\n\ndescribe(\"injectSubtrees\", () => {\n  it(\"nests child outlines under iframe encoded ids\", () => {\n    const rootOutline = `[root] document\\n  [iframe-1] iframe\\n  [leaf] item`;\n    const iframeOutline = `[child-root] child\\n  [nested-frame] iframe`;\n    const nestedOutline = `[nested-leaf] nested`;\n\n    const merged = injectSubtrees(\n      rootOutline,\n      new Map([\n        [\"iframe-1\", iframeOutline],\n        [\"nested-frame\", nestedOutline],\n      ]),\n    );\n\n    expect(merged).toBe(\n      `[root] document\n  [iframe-1] iframe\n    [child-root] child\n      [nested-frame] iframe\n        [nested-leaf] nested\n  [leaf] item`,\n    );\n  });\n\n  it(\"injects child outline only once when the same id repeats\", () => {\n    const rootOutline = `[root] document\n  [iframe-1] iframe\n  [iframe-1] iframe`;\n    const iframeOutline = `[child-root] child`;\n\n    const merged = injectSubtrees(\n      rootOutline,\n      new Map([[\"iframe-1\", iframeOutline]]),\n    );\n\n    expect(merged).toBe(\n      `[root] document\n  [iframe-1] iframe\n    [child-root] child\n  [iframe-1] iframe`,\n    );\n  });\n\n  it(\"returns the original outline when no encoded ids are matched\", () => {\n    const outline = `[root] document\\n  [leaf] item`;\n    expect(injectSubtrees(outline, new Map([[\"other\", \"[x] child\"]]))).toBe(\n      outline,\n    );\n  });\n});\n\ndescribe(\"indentBlock\", () => {\n  it(\"prefixes each line with the provided indent\", () => {\n    expect(indentBlock(\"a\\nb\", \"  \")).toBe(\"  a\\n  b\");\n    expect(indentBlock(\"\", \"  \")).toBe(\"\");\n  });\n});\n\ndescribe(\"diffCombinedTrees\", () => {\n  it(\"returns newly-added lines relative to previous outline\", () => {\n    const prev = `[root] document\\n  [child] a`;\n    const next = `[root] document\\n  [child] a\\n  [child-2] b`;\n    expect(diffCombinedTrees(prev, next)).toBe(\"[child-2] b\");\n  });\n\n  it(\"normalizes indentation for added lines with stray spaces\", () => {\n    const prev = `[root] document\\n    [child] a`;\n    const next = `[root] document\\n    [child] a\\n        [child-2] b`;\n    expect(diffCombinedTrees(prev, next)).toBe(\"[child-2] b\");\n  });\n});\n\ndescribe(\"cleanText\", () => {\n  it(\"removes NBSP and private-use characters while collapsing spaces\", () => {\n    const dirty = `Hello\\u00A0\\u00A0world\\uE000 !`;\n    expect(cleanText(dirty)).toBe(\"Hello world !\");\n  });\n});\n\ndescribe(\"normaliseSpaces\", () => {\n  it(\"replaces whitespace runs with a single space\", () => {\n    expect(normaliseSpaces(\"a   b\\tc\\nd\")).toBe(\"a b c d\");\n  });\n});\n"]}

package/dist/cjs/tests/unit/snapshot-xpath-utils.test.d.ts

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