agent-web-interface 4.0.0

package/dist/src/snapshot/extractors/grouping-resolver.js.map

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

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

@@ -0,0 +1,19 @@
+/**
+ * Snapshot Extractors
+ *
+ * Barrel export for all extractors and resolvers.
+ *
+ * @module snapshot/extractors
+ */
+export type { RawDomNode, RawAxNode, AxProperty, AxPropertyValue, NodeLayoutInfo, RawNodeData, ExtractorContext, DomExtractionResult, AxExtractionResult, LayoutExtractionResult, } from './types.js';
+export { createExtractorContext, isValidRawDomNode, isValidRawAxNode, isValidNodeLayoutInfo, DOM_NODE_TYPES, INTERACTIVE_AX_ROLES, READABLE_AX_ROLES, STRUCTURAL_AX_ROLES, } from './types.js';
+export { extractDom } from './dom-extractor.js';
+export { extractAx, classifyAxRole, type RoleClassification } from './ax-extractor.js';
+export { extractLayout, computeScreenZone, computeVisibility } from './layout-extractor.js';
+export { extractState } from './state-extractor.js';
+export { resolveLabel, type LabelResolution, type LabelSource } from './label-resolver.js';
+export { resolveRegion } from './region-resolver.js';
+export { buildLocators } from './locator-builder.js';
+export { resolveGrouping, type GroupingInfo } from './grouping-resolver.js';
+export { extractAttributes, sanitizeUrl, type AttributeExtractionOptions, } from './attribute-extractor.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/snapshot/extractors/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG5F,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAG3F,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG5E,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,KAAK,0BAA0B,GAChC,MAAM,0BAA0B,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * Snapshot Extractors
+ *
+ * Barrel export for all extractors and resolvers.
+ *
+ * @module snapshot/extractors
+ */
+export { createExtractorContext, isValidRawDomNode, isValidRawAxNode, isValidNodeLayoutInfo, DOM_NODE_TYPES, INTERACTIVE_AX_ROLES, READABLE_AX_ROLES, STRUCTURAL_AX_ROLES, } from './types.js';
+// DOM Extractor
+export { extractDom } from './dom-extractor.js';
+// AX Extractor
+export { extractAx, classifyAxRole } from './ax-extractor.js';
+// Layout Extractor
+export { extractLayout, computeScreenZone, computeVisibility } from './layout-extractor.js';
+// State Extractor
+export { extractState } from './state-extractor.js';
+// Label Resolver
+export { resolveLabel } from './label-resolver.js';
+// Region Resolver
+export { resolveRegion } from './region-resolver.js';
+// Locator Builder
+export { buildLocators } from './locator-builder.js';
+// Grouping Resolver
+export { resolveGrouping } from './grouping-resolver.js';
+// Attribute Extractor
+export { extractAttributes, sanitizeUrl, } from './attribute-extractor.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/snapshot/extractors/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,gBAAgB;AAChB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,eAAe;AACf,OAAO,EAAE,SAAS,EAAE,cAAc,EAA2B,MAAM,mBAAmB,CAAC;AAEvF,mBAAmB;AACnB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE5F,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAA0C,MAAM,qBAAqB,CAAC;AAE3F,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,oBAAoB;AACpB,OAAO,EAAE,eAAe,EAAqB,MAAM,wBAAwB,CAAC;AAE5E,sBAAsB;AACtB,OAAO,EACL,iBAAiB,EACjB,WAAW,GAEZ,MAAM,0BAA0B,CAAC"}

package/dist/src/snapshot/extractors/label-resolver.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Label Resolver
+ *
+ * Computes accessible name with fallback strategies.
+ *
+ * @module snapshot/extractors/label-resolver
+ *
+ * Sources (priority order):
+ * 1. AX tree computed name
+ * 2. aria-label attribute
+ * 3. aria-labelledby reference (not fully implemented - requires DOM lookup)
+ * 4. Associated label element (not fully implemented - requires DOM lookup)
+ * 5. Text content (not implemented - requires full DOM)
+ * 6. title attribute
+ * 7. placeholder attribute
+ * 8. alt attribute (images)
+ * 9. value attribute (submit buttons)
+ * 10. name attribute (form elements)
+ * 11. data-testid (fallback)
+ */
+import type { RawDomNode, RawAxNode } from './types.js';
+/**
+ * Label source types (for debugging/tracking)
+ */
+export type LabelSource = 'ax-name' | 'aria-label' | 'labelledby' | 'label-element' | 'text-content' | 'title' | 'placeholder' | 'alt' | 'value' | 'name' | 'test-id' | 'none';
+/**
+ * Label resolution result
+ */
+export interface LabelResolution {
+    /** Resolved label text */
+    label: string;
+    /** Source of the label */
+    source: LabelSource;
+}
+/**
+ * Resolve label for an element from AX and DOM data.
+ *
+ * @param domNode - Raw DOM node data (optional)
+ * @param axNode - Raw AX node data (optional)
+ * @param idMap - Map of DOM ID to RawDomNode (optional, for aria-labelledby)
+ * @returns LabelResolution with label text and source
+ */
+export declare function resolveLabel(domNode: RawDomNode | undefined, axNode: RawAxNode | undefined, idMap?: Map<string, RawDomNode>): LabelResolution;
+//# sourceMappingURL=label-resolver.d.ts.map

package/dist/src/snapshot/extractors/label-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-resolver.d.ts","sourceRoot":"","sources":["../../../../src/snapshot/extractors/label-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGxD;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,eAAe,GACf,cAAc,GACd,OAAO,GACP,aAAa,GACb,KAAK,GACL,OAAO,GACP,MAAM,GACN,SAAS,GACT,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,MAAM,EAAE,WAAW,CAAC;CACrB;AAyBD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,MAAM,EAAE,SAAS,GAAG,SAAS,EAC7B,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAC9B,eAAe,CAkIjB"}

package/dist/src/snapshot/extractors/label-resolver.js

@@ -0,0 +1,173 @@
+/**
+ * Label Resolver
+ *
+ * Computes accessible name with fallback strategies.
+ *
+ * @module snapshot/extractors/label-resolver
+ *
+ * Sources (priority order):
+ * 1. AX tree computed name
+ * 2. aria-label attribute
+ * 3. aria-labelledby reference (not fully implemented - requires DOM lookup)
+ * 4. Associated label element (not fully implemented - requires DOM lookup)
+ * 5. Text content (not implemented - requires full DOM)
+ * 6. title attribute
+ * 7. placeholder attribute
+ * 8. alt attribute (images)
+ * 9. value attribute (submit buttons)
+ * 10. name attribute (form elements)
+ * 11. data-testid (fallback)
+ */
+import { normalizeText, truncate } from '../../lib/text-utils.js';
+/** Maximum label length before truncation */
+const MAX_LABEL_LENGTH = 160;
+/**
+ * Test ID attribute names to check
+ */
+const TEST_ID_ATTRS = ['data-testid', 'data-test', 'data-cy', 'data-test-id'];
+/**
+ * Get attribute value from DOM node, normalized and non-empty.
+ *
+ * @param attributes - DOM attributes record
+ * @param name - Attribute name
+ * @returns Normalized attribute value or undefined if empty
+ */
+function getAttr(attributes, name) {
+    if (!attributes)
+        return undefined;
+    const value = attributes[name];
+    if (!value)
+        return undefined;
+    const normalized = normalizeText(value);
+    return normalized || undefined;
+}
+/**
+ * Resolve label for an element from AX and DOM data.
+ *
+ * @param domNode - Raw DOM node data (optional)
+ * @param axNode - Raw AX node data (optional)
+ * @param idMap - Map of DOM ID to RawDomNode (optional, for aria-labelledby)
+ * @returns LabelResolution with label text and source
+ */
+export function resolveLabel(domNode, axNode, idMap) {
+    const attributes = domNode?.attributes;
+    const nodeName = domNode?.nodeName?.toUpperCase();
+    // 1. AX computed name (highest priority)
+    if (axNode?.name) {
+        const normalized = normalizeText(axNode.name);
+        if (normalized) {
+            return {
+                label: truncate(normalized, MAX_LABEL_LENGTH),
+                source: 'ax-name',
+            };
+        }
+    }
+    // 2. aria-labelledby
+    const labelledBy = getAttr(attributes, 'aria-labelledby');
+    if (labelledBy && idMap) {
+        const ids = labelledBy.split(/\s+/);
+        const parts = [];
+        for (const id of ids) {
+            const refNode = idMap.get(id);
+            if (refNode) {
+                // Try to get text from referenced node
+                // Priority: aria-label > nodeValue (text) > first child text
+                const refLabel = getAttr(refNode.attributes, 'aria-label');
+                if (refLabel) {
+                    parts.push(refLabel);
+                }
+                else if (refNode.nodeValue) {
+                    parts.push(refNode.nodeValue);
+                }
+                else if (refNode.childNodeIds && refNode.childNodeIds.length > 0) {
+                    // Check first child for text (simplistic but handles <label>Text</label>)
+                    // Note: we can't easily look up child by ID here without the full tree map
+                    // But we don't have the full tree map passed as 'idMap' (it's id -> node).
+                    // We can't lookup child by backendNodeId unless we have that map too.
+                    // For now, skip deep traversal to avoid complexity/perf cost.
+                }
+            }
+        }
+        if (parts.length > 0) {
+            return {
+                label: truncate(parts.join(' '), MAX_LABEL_LENGTH),
+                source: 'labelledby',
+            };
+        }
+    }
+    // 3. aria-label
+    const ariaLabel = getAttr(attributes, 'aria-label');
+    if (ariaLabel) {
+        return {
+            label: truncate(ariaLabel, MAX_LABEL_LENGTH),
+            source: 'aria-label',
+        };
+    }
+    // 4. title attribute
+    const title = getAttr(attributes, 'title');
+    if (title) {
+        return {
+            label: truncate(title, MAX_LABEL_LENGTH),
+            source: 'title',
+        };
+    }
+    // 5. placeholder (inputs, textareas)
+    if (nodeName === 'INPUT' || nodeName === 'TEXTAREA') {
+        const placeholder = getAttr(attributes, 'placeholder');
+        if (placeholder) {
+            return {
+                label: truncate(placeholder, MAX_LABEL_LENGTH),
+                source: 'placeholder',
+            };
+        }
+    }
+    // 6. alt attribute (images)
+    if (nodeName === 'IMG' || nodeName === 'IMAGE') {
+        const alt = getAttr(attributes, 'alt');
+        if (alt) {
+            return {
+                label: truncate(alt, MAX_LABEL_LENGTH),
+                source: 'alt',
+            };
+        }
+    }
+    // 7. value attribute (submit/button inputs)
+    if (nodeName === 'INPUT') {
+        const inputType = attributes?.type?.toLowerCase();
+        if (inputType === 'submit' || inputType === 'button' || inputType === 'reset') {
+            const value = getAttr(attributes, 'value');
+            if (value) {
+                return {
+                    label: truncate(value, MAX_LABEL_LENGTH),
+                    source: 'value',
+                };
+            }
+        }
+    }
+    // 8. name attribute (form elements)
+    if (nodeName === 'INPUT' || nodeName === 'SELECT' || nodeName === 'TEXTAREA') {
+        const name = getAttr(attributes, 'name');
+        if (name) {
+            return {
+                label: truncate(name, MAX_LABEL_LENGTH),
+                source: 'name',
+            };
+        }
+    }
+    // 9. data-testid and variants (fallback for debugging)
+    for (const testIdAttr of TEST_ID_ATTRS) {
+        const testId = getAttr(attributes, testIdAttr);
+        if (testId) {
+            return {
+                label: truncate(testId, MAX_LABEL_LENGTH),
+                source: 'test-id',
+            };
+        }
+    }
+    // No label found
+    return {
+        label: '',
+        source: 'none',
+    };
+}
+//# sourceMappingURL=label-resolver.js.map

package/dist/src/snapshot/extractors/label-resolver.js.map

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

package/dist/src/snapshot/extractors/layout-extractor.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Layout Extractor
+ *
+ * Gets bounding boxes and CSS layout info for nodes.
+ *
+ * @module snapshot/extractors/layout-extractor
+ *
+ * CDP Domains:
+ * - DOM.getBoxModel: Get bounding box for a node
+ * - CSS.getComputedStyleForNode: Get computed CSS properties
+ */
+import type { BBox, ScreenZone, Viewport } from '../snapshot.types.js';
+import type { ExtractorContext, LayoutExtractionResult, RawDomNode } from './types.js';
+/**
+ * Compute screen zone based on element position relative to viewport.
+ *
+ * @param bbox - Element bounding box
+ * @param viewport - Viewport dimensions
+ * @returns ScreenZone classification
+ */
+export declare function computeScreenZone(bbox: BBox, viewport: Viewport): ScreenZone;
+/**
+ * Compute visibility from display, visibility CSS properties and bbox.
+ *
+ * @param bbox - Element bounding box
+ * @param display - CSS display value
+ * @param visibility - CSS visibility value
+ * @returns true if element is visible
+ */
+export declare function computeVisibility(bbox: BBox, display?: string, visibility?: string): boolean;
+/**
+ * Node ID lookup interface for extractLayout.
+ * Maps backendNodeId to object containing nodeId.
+ */
+type NodeIdLookup = Map<number, {
+    nodeId: number;
+    backendNodeId?: number;
+}>;
+/**
+ * Extract layout information for multiple nodes.
+ *
+ * Uses a batch strategy via Runtime.evaluate to minimize roundtrips.
+ * Falls back to individual CDP calls for nodes that cannot be resolved via batch (e.g. inside closed shadow roots).
+ *
+ * @param ctx - Extractor context with CDP client and options
+ * @param backendNodeIds - Array of backend node IDs to extract layout for
+ * @param domNodes - Map of backendNodeId to DOM node
+ * @returns LayoutExtractionResult with layouts map
+ */
+export declare function extractLayout(ctx: ExtractorContext, backendNodeIds: number[], domNodes?: NodeIdLookup | Map<number, RawDomNode>): Promise<LayoutExtractionResult>;
+export {};
+//# sourceMappingURL=layout-extractor.d.ts.map

package/dist/src/snapshot/extractors/layout-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-extractor.d.ts","sourceRoot":"","sources":["../../../../src/snapshot/extractors/layout-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EAEtB,UAAU,EACX,MAAM,YAAY,CAAC;AAoDpB;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAmC5E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAiB5F;AA4ED;;;GAGG;AACH,KAAK,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE5E;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,cAAc,EAAE,MAAM,EAAE,EACxB,QAAQ,CAAC,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAChD,OAAO,CAAC,sBAAsB,CAAC,CA8DjC"}