agent-web-interface 4.2.0 → 4.4.0

package/dist/src/snapshot/frame-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-context.d.ts","sourceRoot":"","sources":["../../../src/snapshot/frame-context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,4EAA4E;IAC5E,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAKnE;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAIxD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,mBAAmB,GAAG,eAAe,CAiBpF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,eAAe,EAAE,eAAe,GAC/B,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,CAGrC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,mBAAmB,GAAG,aAAa,CAqBhF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,mBAAmB,EAC9B,aAAa,EAAE,aAAa,GAC3B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAqCrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE;IACT,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;CACzB,EACD,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EAC5C,YAAY,UAAO,GAClB,IAAI,CAaN"}

package/dist/src/snapshot/frame-context.js

@@ -0,0 +1,131 @@
+/**
+ * Frame and Shadow DOM Context Utilities
+ *
+ * Provides context-scoped ID maps, adjacency maps for shadow roots and
+ * iframe content documents, and DOM order indexing.
+ *
+ * @module snapshot/frame-context
+ */
+const ROOT_CONTEXT = 'root';
+const LIGHT_DOM_CONTEXT = 'light';
+/**
+ * Build a context key based on iframe and shadow ancestry.
+ */
+export function buildContextKey(node) {
+    const frameKey = node.framePath?.length ? node.framePath.join('/') : ROOT_CONTEXT;
+    const shadowKey = node.shadowPath?.length ? node.shadowPath.join('/') : LIGHT_DOM_CONTEXT;
+    return `${frameKey}|${shadowKey}`;
+}
+/**
+ * Build context-scoped ID maps to avoid cross-frame/shadow collisions.
+ */
+export function buildIdMapsByContext(domResult) {
+    const idMaps = new Map();
+    for (const node of domResult.nodes.values()) {
+        const id = node.attributes?.id;
+        if (!id)
+            continue;
+        const contextKey = buildContextKey(node);
+        let map = idMaps.get(contextKey);
+        if (!map) {
+            map = new Map();
+            idMaps.set(contextKey, map);
+        }
+        map.set(id, node);
+    }
+    return idMaps;
+}
+/**
+ * Get the ID map scoped to a node's frame/shadow context.
+ */
+export function getIdMapForNode(node, idMapsByContext) {
+    if (!node)
+        return undefined;
+    return idMapsByContext.get(buildContextKey(node));
+}
+/**
+ * Build adjacency maps for shadow roots and iframe content documents.
+ * Single O(n) pass through all nodes.
+ *
+ * @param domResult - DOM extraction result
+ * @returns Adjacency maps for shadow roots and content documents
+ */
+export function buildAdjacencyMaps(domResult) {
+    const shadowRootsByHost = new Map();
+    const contentDocsByFrame = new Map();
+    for (const [nodeId, node] of domResult.nodes) {
+        if (node.parentId === undefined)
+            continue;
+        if (node.nodeName === '#document-fragment') {
+            // This is a shadow root - add to shadow host's children
+            const existing = shadowRootsByHost.get(node.parentId) ?? [];
+            existing.push(nodeId);
+            shadowRootsByHost.set(node.parentId, existing);
+        }
+        else if (node.nodeName === '#document') {
+            // This is a content document - add to iframe's children
+            const existing = contentDocsByFrame.get(node.parentId) ?? [];
+            existing.push(nodeId);
+            contentDocsByFrame.set(node.parentId, existing);
+        }
+    }
+    return { shadowRootsByHost, contentDocsByFrame };
+}
+/**
+ * Build DOM pre-order index by traversing the DOM tree.
+ * Also traverses into shadow roots and iframe content documents.
+ *
+ * @param domResult - DOM extraction result with nodes and rootId
+ * @param adjacencyMaps - Precomputed maps for shadow roots and content documents
+ * @returns Map of backendNodeId -> DOM order index
+ */
+export function buildDomOrderIndex(domResult, adjacencyMaps) {
+    const orderIndex = new Map();
+    const shadowHostSet = new Set(domResult.shadowRoots);
+    let index = 0;
+    function traverse(nodeId) {
+        const node = domResult.nodes.get(nodeId);
+        if (!node)
+            return;
+        orderIndex.set(nodeId, index++);
+        // 1. Process light DOM children first (pre-order DFS)
+        if (node.childNodeIds) {
+            for (const childId of node.childNodeIds) {
+                traverse(childId);
+            }
+        }
+        // 2. If this node hosts a shadow root, traverse shadow content (O(1) lookup)
+        if (shadowHostSet.has(nodeId)) {
+            const shadowRoots = adjacencyMaps.shadowRootsByHost.get(nodeId) ?? [];
+            for (const shadowRootId of shadowRoots) {
+                traverse(shadowRootId);
+            }
+        }
+        // 3. If this node is an iframe, traverse content document (O(1) lookup)
+        if (node.frameId || node.nodeName.toUpperCase() === 'IFRAME') {
+            const contentDocs = adjacencyMaps.contentDocsByFrame.get(nodeId) ?? [];
+            for (const contentDocId of contentDocs) {
+                traverse(contentDocId);
+            }
+        }
+    }
+    traverse(domResult.rootId);
+    return orderIndex;
+}
+/**
+ * Recursively collect frame loaderIds from frame tree.
+ */
+export function collectFrameLoaderIds(frameTree, frameLoaderIds, _isMainFrame = true) {
+    const frame = frameTree.frame;
+    frameLoaderIds.set(frame.id, {
+        frameId: frame.id,
+        loaderId: frame.loaderId,
+        isMainFrame: !frame.parentId,
+    });
+    if (frameTree.childFrames) {
+        for (const child of frameTree.childFrames) {
+            collectFrameLoaderIds(child, frameLoaderIds, false);
+        }
+    }
+}
+//# sourceMappingURL=frame-context.js.map

package/dist/src/snapshot/frame-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-context.js","sourceRoot":"","sources":["../../../src/snapshot/frame-context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH,MAAM,YAAY,GAAG,MAAM,CAAC;AAC5B,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAElC;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAClF,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAC1F,OAAO,GAAG,QAAQ,IAAI,SAAS,EAAE,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAA8B;IACjE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmC,CAAC;IAE1D,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QAC/B,IAAI,CAAC,EAAE;YAAE,SAAS;QAElB,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAsB,CAAC;YACpC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC9B,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,IAA4B,EAC5B,eAAgC;IAEhC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,eAAe,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAA8B;IAC/D,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAoB,CAAC;IACtD,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEvD,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QAC7C,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,SAAS;QAE1C,IAAI,IAAI,CAAC,QAAQ,KAAK,oBAAoB,EAAE,CAAC;YAC3C,wDAAwD;YACxD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC5D,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACjD,CAAC;aAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YACzC,wDAAwD;YACxD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC7D,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;AACnD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAA8B,EAC9B,aAA4B;IAE5B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACrD,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,SAAS,QAAQ,CAAC,MAAc;QAC9B,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAEhC,sDAAsD;QACtD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACxC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QAED,6EAA6E;QAC7E,IAAI,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,MAAM,WAAW,GAAG,aAAa,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACtE,KAAK,MAAM,YAAY,IAAI,WAAW,EAAE,CAAC;gBACvC,QAAQ,CAAC,YAAY,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,wEAAwE;QACxE,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC7D,MAAM,WAAW,GAAG,aAAa,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACvE,KAAK,MAAM,YAAY,IAAI,WAAW,EAAE,CAAC;gBACvC,QAAQ,CAAC,YAAY,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3B,OAAO,UAAU,CAAC;AACpB,CAAC;AAWD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAGC,EACD,cAA4C,EAC5C,YAAY,GAAG,IAAI;IAEnB,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;IAC9B,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE;QAC3B,OAAO,EAAE,KAAK,CAAC,EAAE;QACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,WAAW,EAAE,CAAC,KAAK,CAAC,QAAQ;KAC7B,CAAC,CAAC;IAEH,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAC1B,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,WAAmC,EAAE,CAAC;YAClE,qBAAqB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/snapshot/heading-index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Heading Index Builder
+ *
+ * Builds a heading context index mapping each backendNodeId to its
+ * heading context based on DOM order traversal.
+ *
+ * @module snapshot/heading-index
+ */
+import type { DomExtractionResult, AxExtractionResult } from './extractors/index.js';
+import type { AdjacencyMaps, IdMapsByContext } from './frame-context.js';
+/**
+ * Build heading index mapping each backendNodeId to its heading context.
+ * Uses DOM order to determine the most recent preceding heading.
+ * Also traverses into shadow roots and iframe content documents.
+ *
+ * Heading context is isolated at iframe boundaries:
+ * - Heading from parent document does NOT propagate into iframe
+ * - Heading from iframe does NOT propagate back to parent document
+ * - Shadow DOM shares heading context with its host document
+ *
+ * @param domResult - DOM extraction result
+ * @param axResult - AX extraction result for heading names
+ * @param idMapsByContext - Context-scoped ID maps for aria-labelledby resolution
+ * @param adjacencyMaps - Precomputed maps for shadow roots and content documents
+ * @returns Map of backendNodeId -> heading context string
+ */
+export declare function buildHeadingIndex(domResult: DomExtractionResult, axResult: AxExtractionResult | undefined, idMapsByContext: IdMapsByContext, adjacencyMaps: AdjacencyMaps): Map<number, string>;
+//# sourceMappingURL=heading-index.d.ts.map

package/dist/src/snapshot/heading-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-index.d.ts","sourceRoot":"","sources":["../../../src/snapshot/heading-index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGrF,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGzE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,mBAAmB,EAC9B,QAAQ,EAAE,kBAAkB,GAAG,SAAS,EACxC,eAAe,EAAE,eAAe,EAChC,aAAa,EAAE,aAAa,GAC3B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA2FrB"}

package/dist/src/snapshot/heading-index.js

@@ -0,0 +1,108 @@
+/**
+ * Heading Index Builder
+ *
+ * Builds a heading context index mapping each backendNodeId to its
+ * heading context based on DOM order traversal.
+ *
+ * @module snapshot/heading-index
+ */
+import { resolveLabel } from './extractors/index.js';
+import { getTextContent } from '../lib/text-utils.js';
+import { getIdMapForNode } from './frame-context.js';
+/**
+ * Build heading index mapping each backendNodeId to its heading context.
+ * Uses DOM order to determine the most recent preceding heading.
+ * Also traverses into shadow roots and iframe content documents.
+ *
+ * Heading context is isolated at iframe boundaries:
+ * - Heading from parent document does NOT propagate into iframe
+ * - Heading from iframe does NOT propagate back to parent document
+ * - Shadow DOM shares heading context with its host document
+ *
+ * @param domResult - DOM extraction result
+ * @param axResult - AX extraction result for heading names
+ * @param idMapsByContext - Context-scoped ID maps for aria-labelledby resolution
+ * @param adjacencyMaps - Precomputed maps for shadow roots and content documents
+ * @returns Map of backendNodeId -> heading context string
+ */
+export function buildHeadingIndex(domResult, axResult, idMapsByContext, adjacencyMaps) {
+    const headingIndex = new Map();
+    const shadowHostSet = new Set(domResult.shadowRoots);
+    // Helper to check if a node is a heading and resolve its name
+    function isHeading(backendNodeId) {
+        const domNode = domResult.nodes.get(backendNodeId);
+        const axNode = axResult?.nodes.get(backendNodeId);
+        // Check AX role first
+        const scopedIdMap = domNode ? getIdMapForNode(domNode, idMapsByContext) : undefined;
+        if (axNode?.role === 'heading') {
+            // Priority: AX name -> resolveLabel -> DOM text content
+            let name = axNode.name;
+            if (!name && domNode) {
+                const labelResult = resolveLabel(domNode, axNode, scopedIdMap);
+                if (labelResult.source !== 'none') {
+                    name = labelResult.label;
+                }
+            }
+            name ??= getTextContent(backendNodeId, domResult.nodes);
+            return { isHeading: true, name };
+        }
+        // Check DOM tag (H1-H6)
+        if (domNode?.nodeName?.match(/^H[1-6]$/i)) {
+            // Priority: AX name -> resolveLabel -> DOM text content
+            let name = axNode?.name;
+            if (!name) {
+                const labelResult = resolveLabel(domNode, axNode, scopedIdMap);
+                if (labelResult.source !== 'none') {
+                    name = labelResult.label;
+                }
+            }
+            name ??= getTextContent(backendNodeId, domResult.nodes);
+            return { isHeading: true, name };
+        }
+        return { isHeading: false };
+    }
+    // Traverse DOM in pre-order, passing and returning heading context
+    function traverse(nodeId, currentHeading) {
+        const node = domResult.nodes.get(nodeId);
+        if (!node)
+            return currentHeading;
+        // Check if this node is a heading
+        const headingInfo = isHeading(nodeId);
+        if (headingInfo.isHeading && headingInfo.name) {
+            currentHeading = headingInfo.name;
+        }
+        // Record the current heading context for this node
+        if (currentHeading) {
+            headingIndex.set(nodeId, currentHeading);
+        }
+        // 1. Process light DOM children first (pre-order DFS)
+        // Heading context propagates and updates through light DOM
+        if (node.childNodeIds) {
+            for (const childId of node.childNodeIds) {
+                currentHeading = traverse(childId, currentHeading) ?? currentHeading;
+            }
+        }
+        // 2. If this node hosts a shadow root, traverse shadow content (O(1) lookup)
+        // Shadow DOM shares heading context with host document (same logical document)
+        if (shadowHostSet.has(nodeId)) {
+            const shadowRoots = adjacencyMaps.shadowRootsByHost.get(nodeId) ?? [];
+            for (const shadowRootId of shadowRoots) {
+                currentHeading = traverse(shadowRootId, currentHeading) ?? currentHeading;
+            }
+        }
+        // 3. If this node is an iframe, traverse content document (O(1) lookup)
+        // IMPORTANT: Heading context resets at iframe boundary (separate document)
+        // - Pass undefined to reset context inside iframe
+        // - Discard returned heading (iframe headings don't affect parent)
+        if (node.frameId || node.nodeName.toUpperCase() === 'IFRAME') {
+            const contentDocs = adjacencyMaps.contentDocsByFrame.get(nodeId) ?? [];
+            for (const contentDocId of contentDocs) {
+                traverse(contentDocId, undefined);
+            }
+        }
+        return currentHeading;
+    }
+    traverse(domResult.rootId, undefined);
+    return headingIndex;
+}
+//# sourceMappingURL=heading-index.js.map

package/dist/src/snapshot/heading-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-index.js","sourceRoot":"","sources":["../../../src/snapshot/heading-index.ts"],"names":[],"mappings":"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"}

package/dist/src/snapshot/index.d.ts

@@ -6,9 +6,11 @@
  * @module snapshot
  */
 export type { BaseSnapshot, Viewport, SnapshotMeta, ReadableNode, NodeKind, SemanticRegion, NodeLocation, NodeLayout, BBox, BoundingBox, ScreenZone, NodeState, NodeLocators, NodeAttributes, SnapshotOptions, SnapshotResult, } from './snapshot.types.js';
-export { isInteractiveNode, isReadableNode, isStructuralNode } from './snapshot.types.js';
+export { isInteractiveNode, isReadableNode, isStructuralNode, isLiveRegionNode, } from './snapshot.types.js';
 export { SnapshotStore, type SnapshotEntry, type SnapshotStoreOptions, type SnapshotStoreStats, } from './snapshot-store.js';
-export { clickByBackendNodeId, typeByBackendNodeId, pressKey, selectOption, hoverByBackendNodeId, scrollIntoView, scrollPage, clearFocusedText, MODIFIER_ALT, MODIFIER_CTRL, MODIFIER_META, MODIFIER_SHIFT, } from './element-resolver.js';
-export { SnapshotCompiler, compileSnapshot, type CompileOptions } from './snapshot-compiler.js';
+export { clickByBackendNodeId, clickAtCoordinates, clickAtElementOffset, getElementTopLeft, dragBetweenCoordinates, dispatchWheelEvent, typeByBackendNodeId, pressKey, selectOption, hoverByBackendNodeId, scrollIntoView, scrollPage, clearFocusedText, MODIFIER_ALT, MODIFIER_CTRL, MODIFIER_META, MODIFIER_SHIFT, } from './element-resolver.js';
+export { SnapshotCompiler, compileSnapshot } from './snapshot-compiler.js';
+export type { CompileOptions } from './kind-mapping.js';
+export { sliceWithOverlayPriority } from './node-filter.js';
 export * from './extractors/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/snapshot/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/snapshot/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,UAAU,EACV,IAAI,EACJ,WAAW,EACX,UAAU,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG1F,OAAO,EACL,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGhG,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/snapshot/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,UAAU,EACV,IAAI,EACJ,WAAW,EACX,UAAU,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC3E,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,cAAc,uBAAuB,CAAC"}

package/dist/src/snapshot/index.js

@@ -6,13 +6,14 @@
  * @module snapshot
  */
 // Type guards
-export { isInteractiveNode, isReadableNode, isStructuralNode } from './snapshot.types.js';
+export { isInteractiveNode, isReadableNode, isStructuralNode, isLiveRegionNode, } from './snapshot.types.js';
 // Store
 export { SnapshotStore, } from './snapshot-store.js';
 // Element resolver - CDP input functions
-export { clickByBackendNodeId, typeByBackendNodeId, pressKey, selectOption, hoverByBackendNodeId, scrollIntoView, scrollPage, clearFocusedText, MODIFIER_ALT, MODIFIER_CTRL, MODIFIER_META, MODIFIER_SHIFT, } from './element-resolver.js';
+export { clickByBackendNodeId, clickAtCoordinates, clickAtElementOffset, getElementTopLeft, dragBetweenCoordinates, dispatchWheelEvent, typeByBackendNodeId, pressKey, selectOption, hoverByBackendNodeId, scrollIntoView, scrollPage, clearFocusedText, MODIFIER_ALT, MODIFIER_CTRL, MODIFIER_META, MODIFIER_SHIFT, } from './element-resolver.js';
 // Snapshot compiler
 export { SnapshotCompiler, compileSnapshot } from './snapshot-compiler.js';
+export { sliceWithOverlayPriority } from './node-filter.js';
 // Extractors (advanced usage)
 export * from './extractors/index.js';
 //# sourceMappingURL=index.js.map

package/dist/src/snapshot/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/snapshot/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH,cAAc;AACd,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE1F,QAAQ;AACR,OAAO,EACL,aAAa,GAId,MAAM,qBAAqB,CAAC;AAE7B,yCAAyC;AACzC,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,oBAAoB;AACpB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAuB,MAAM,wBAAwB,CAAC;AAEhG,8BAA8B;AAC9B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/snapshot/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH,cAAc;AACd,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,QAAQ;AACR,OAAO,EACL,aAAa,GAId,MAAM,qBAAqB,CAAC;AAE7B,yCAAyC;AACzC,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,oBAAoB;AACpB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,8BAA8B;AAC9B,cAAc,uBAAuB,CAAC"}

package/dist/src/snapshot/kind-mapping.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Kind Mapping
+ *
+ * Maps AX roles and HTML tags to NodeKind values.
+ *
+ * @module snapshot/kind-mapping
+ */
+import type { NodeKind, SnapshotOptions } from './snapshot.types.js';
+/**
+ * Snapshot compiler options
+ */
+export interface CompileOptions extends Partial<SnapshotOptions> {
+    /** Include readable content nodes (headings, paragraphs). Default: true */
+    includeReadable?: boolean;
+    /** Extract bounding boxes and layout info. Default: true */
+    includeLayout?: boolean;
+}
+/**
+ * Default compile options
+ */
+export declare const DEFAULT_OPTIONS: Required<CompileOptions>;
+/**
+ * Map AX role to NodeKind.
+ */
+export declare function mapRoleToKind(role: string | undefined): NodeKind | undefined;
+/**
+ * Get NodeKind from HTML tag name.
+ */
+export declare function getKindFromTag(tagName: string): NodeKind | undefined;
+//# sourceMappingURL=kind-mapping.d.ts.map

package/dist/src/snapshot/kind-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-mapping.d.ts","sourceRoot":"","sources":["../../../src/snapshot/kind-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,OAAO,CAAC,eAAe,CAAC;IAC9D,2EAA2E;IAC3E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4DAA4D;IAC5D,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,cAAc,CAQpD,CAAC;AAoFF;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAG5E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAEpE"}

package/dist/src/snapshot/kind-mapping.js

@@ -0,0 +1,114 @@
+/**
+ * Kind Mapping
+ *
+ * Maps AX roles and HTML tags to NodeKind values.
+ *
+ * @module snapshot/kind-mapping
+ */
+/**
+ * Default compile options
+ */
+export const DEFAULT_OPTIONS = {
+    include_hidden: false,
+    max_nodes: 2000,
+    timeout: 30000,
+    redact_sensitive: true,
+    include_values: true, // Enable value extraction with password redaction
+    includeReadable: true,
+    includeLayout: true,
+};
+/** AX role → NodeKind lookup (hoisted to avoid per-call allocation) */
+const ROLE_TO_KIND = {
+    // Interactive
+    button: 'button',
+    link: 'link',
+    textbox: 'input',
+    searchbox: 'input',
+    combobox: 'combobox',
+    listbox: 'select',
+    checkbox: 'checkbox',
+    radio: 'radio',
+    switch: 'switch',
+    slider: 'slider',
+    spinbutton: 'slider',
+    tab: 'tab',
+    menuitem: 'menuitem',
+    menuitemcheckbox: 'menuitem',
+    menuitemradio: 'menuitem',
+    option: 'menuitem',
+    // Readable
+    heading: 'heading',
+    paragraph: 'paragraph',
+    text: 'text',
+    statictext: 'text',
+    list: 'list',
+    listitem: 'listitem',
+    tree: 'list',
+    treeitem: 'listitem',
+    image: 'image',
+    img: 'image',
+    figure: 'image',
+    canvas: 'canvas',
+    table: 'table',
+    grid: 'table',
+    treegrid: 'table',
+    // Structural
+    form: 'form',
+    dialog: 'dialog',
+    alertdialog: 'dialog',
+    navigation: 'navigation',
+    region: 'section',
+    article: 'section',
+    main: 'section',
+    banner: 'section',
+    complementary: 'section',
+    contentinfo: 'section',
+    // Live region / ephemeral feedback
+    alert: 'alert',
+    status: 'status',
+    log: 'log',
+    marquee: 'log',
+    timer: 'timer',
+    tooltip: 'tooltip',
+    progressbar: 'progressbar',
+};
+/** HTML tag → NodeKind lookup (hoisted to avoid per-call allocation) */
+const TAG_TO_KIND = {
+    BUTTON: 'button',
+    A: 'link',
+    INPUT: 'input',
+    TEXTAREA: 'textarea',
+    SELECT: 'select',
+    H1: 'heading',
+    H2: 'heading',
+    H3: 'heading',
+    H4: 'heading',
+    H5: 'heading',
+    H6: 'heading',
+    P: 'paragraph',
+    IMG: 'image',
+    TABLE: 'table',
+    UL: 'list',
+    OL: 'list',
+    LI: 'listitem',
+    FORM: 'form',
+    DIALOG: 'dialog',
+    NAV: 'navigation',
+    OPTION: 'menuitem',
+    CANVAS: 'canvas',
+};
+/**
+ * Map AX role to NodeKind.
+ */
+export function mapRoleToKind(role) {
+    if (!role)
+        return undefined;
+    return ROLE_TO_KIND[role.toLowerCase()];
+}
+/**
+ * Get NodeKind from HTML tag name.
+ */
+export function getKindFromTag(tagName) {
+    return TAG_TO_KIND[tagName.toUpperCase()];
+}
+//# sourceMappingURL=kind-mapping.js.map

package/dist/src/snapshot/kind-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-mapping.js","sourceRoot":"","sources":["../../../src/snapshot/kind-mapping.ts"],"names":[],"mappings":"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"}

package/dist/src/snapshot/node-filter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Node Filtering
+ *
+ * Filters noise nodes and slices to budget while preserving overlay content.
+ *
+ * @module snapshot/node-filter
+ */
+import type { ReadableNode } from './snapshot.types.js';
+import type { RawNodeData, RawDomNode, RawAxNode } from './extractors/index.js';
+/**
+ * Filter out noise nodes to reduce snapshot size.
+ *
+ * Filters:
+ * 1. Empty list/listitem containers with no semantic name AND no interactive descendants
+ * 2. StaticText/text nodes that mirror their parent's label exactly
+ */
+export declare function filterNoiseNodes(nodes: ReadableNode[], domTree: Map<number, RawDomNode>, axTree: Map<number, RawAxNode>): ReadableNode[];
+/**
+ * Slice nodes to max_nodes budget while preserving high z-index overlay content.
+ *
+ * Portal-rendered content (dropdowns, popovers, modals) appears at the end of
+ * DOM order. On heavy pages, a naive slice truncates it.
+ *
+ * Strategy:
+ * 1. Partition nodes into overlay (z-index > threshold) and main
+ * 2. Take all overlay nodes (up to 30% of budget)
+ * 3. Fill remaining budget with main nodes (DOM order)
+ * 4. Re-sort by original DOM order
+ */
+export declare function sliceWithOverlayPriority(nodes: RawNodeData[], maxNodes: number): RawNodeData[];
+//# sourceMappingURL=node-filter.d.ts.map

package/dist/src/snapshot/node-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-filter.d.ts","sourceRoot":"","sources":["../../../src/snapshot/node-filter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGhF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAChC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAC7B,YAAY,EAAE,CAkFhB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CA2C9F"}