agent-web-interface 4.0.0

package/dist/src/lib/text-utils.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Text Normalization and Processing Utilities
+ *
+ * Pure utility functions for text processing, normalization,
+ * and string matching used in element discovery.
+ */
+/**
+ * Normalize text for matching:
+ * - Unicode NFKC normalization
+ * - Remove zero-width/invisible characters
+ * - Collapse whitespace
+ */
+export declare function normalizeText(text: string): string;
+/**
+ * Sanitize accessible name/label hint for selector building
+ * Returns undefined if the result is empty or too short
+ */
+export declare function sanitizeAccessibleHint(value: string, maxLength?: number): string | undefined;
+/**
+ * Truncate string with ellipsis
+ */
+export declare function truncate(value: string, max?: number): string;
+/**
+ * Escape string for CSS attribute selector (for display labels).
+ * Normalizes and truncates the value.
+ */
+export declare function escapeAttributeValue(value: string, maxLength?: number): string;
+/**
+ * Escape a value for use inside CSS attribute selector quotes.
+ * Follows CSS string serialization spec:
+ * - Null (U+0000) -> U+FFFD replacement character
+ * - Control chars (U+0001-U+001F, U+007F) -> hex escape with trailing space
+ * - Quotes and backslashes -> backslash escape
+ *
+ * Does NOT truncate or normalize. Use for exact-match selectors like [attr="value"].
+ *
+ * @param value - Raw attribute value
+ * @returns String safe for use in [attr="value"] selectors
+ */
+export declare function escapeAttrSelectorValue(value: string): string;
+/**
+ * Escape a name for use in Playwright-style role locators: role=button[name="..."]
+ * Only escapes quotes and backslashes - keeps control characters raw.
+ * Playwright's role engine matches against actual accessible names, not CSS.
+ *
+ * @param value - Raw accessible name
+ * @returns String safe for use in role=[name="value"] locators
+ */
+export declare function escapeRoleLocatorName(value: string): string;
+/**
+ * Escape a string for use in CSS selectors (CSS.escape() semantics).
+ * Does NOT truncate or normalize - uses raw value.
+ * Safe for ID selectors (#id), class selectors (.class), etc.
+ *
+ * Follows CSS.escape() specification:
+ * https://drafts.csswg.org/cssom/#the-css.escape()-method
+ *
+ * @param value - Raw string to escape
+ * @returns CSS-escaped string safe for use in selectors
+ */
+export declare function cssEscape(value: string): string;
+/**
+ * Escape string for XPath string literal
+ * XPath doesn't have a standard escape mechanism, so we handle quotes carefully
+ */
+export declare function escapeXPathValue(value: string): string;
+/**
+ * Tokenize text for XPath matching
+ * Takes first few significant words to avoid overly specific selectors
+ */
+export declare function tokenizeForMatching(text: string, maxTokens?: number, minLength?: number): string[];
+/**
+ * Check if two strings match using fuzzy token-based comparison
+ */
+export declare function fuzzyTokenMatch(text: string, query: string, minMatchTokens?: number): boolean;
+/**
+ * Calculate Levenshtein (edit) distance between two strings.
+ * Uses optimized single-row algorithm with O(min(m,n)) space.
+ */
+export declare function levenshteinDistance(a: string, b: string): number;
+/**
+ * Calculate similarity ratio (0-1) between two strings based on Levenshtein distance.
+ * Returns 1 for identical strings, 0 for completely different strings.
+ */
+export declare function stringSimilarity(a: string, b: string): number;
+/**
+ * Options for fuzzy token matching
+ */
+export interface FuzzyTokenMatchOptions {
+    /** Minimum token overlap ratio (0-1) for a match. Default: 0.5 */
+    minTokenOverlap?: number;
+    /** Enable prefix matching for tokens. Default: true */
+    prefixMatch?: boolean;
+    /** Minimum edit distance similarity (0-1) for similar tokens. Default: 0.8 */
+    minSimilarity?: number;
+}
+/**
+ * Result from fuzzy token matching
+ */
+export interface FuzzyTokenMatchResult {
+    /** Whether the tokens match based on options */
+    isMatch: boolean;
+    /** Match score (0-1) based on token overlap quality */
+    score: number;
+}
+/**
+ * Enhanced fuzzy token matching with similarity scoring.
+ * Supports exact matching, prefix matching, and edit distance similarity.
+ *
+ * @param textTokens - Tokens from the text being searched
+ * @param queryTokens - Tokens from the search query
+ * @param options - Matching options
+ * @returns Match result with score
+ */
+export declare function fuzzyTokensMatch(textTokens: string[], queryTokens: string[], options?: FuzzyTokenMatchOptions): FuzzyTokenMatchResult;
+/**
+ * Minimal DOM node interface for text content extraction.
+ * Compatible with RawDomNode from extractors.
+ */
+export interface TextContentNode {
+    /** Node type (3 = TEXT_NODE) */
+    nodeType: number;
+    /** Text content for text nodes */
+    nodeValue?: string;
+    /** Child node IDs (backendNodeIds) */
+    childNodeIds?: number[];
+}
+/**
+ * Extract text content from a DOM node by concatenating text-node children.
+ * Uses depth-limited traversal to avoid performance issues.
+ *
+ * @param nodeId - Backend node ID of the element
+ * @param domNodes - Map of backendNodeId -> node with nodeType, nodeValue, childNodeIds
+ * @param maxDepth - Maximum depth to traverse (default: 2)
+ * @returns Normalized text content or undefined if none found
+ */
+export declare function getTextContent(nodeId: number, domNodes: Map<number, TextContentNode>, maxDepth?: number): string | undefined;
+/**
+ * Escape special XML characters in a string.
+ * Used for XML element content and attribute values.
+ *
+ * @param str - String to escape
+ * @returns XML-safe string
+ */
+export declare function escapeXml(str: string): string;
+/**
+ * Build an XML attribute string, choosing quote style to minimize escaping.
+ * Uses single quotes when value contains double quotes (common in selectors).
+ *
+ * @param name - Attribute name
+ * @param value - Attribute value
+ * @returns Formatted attribute string like `name="value"` or `name='value'`
+ */
+export declare function xmlAttr(name: string, value: string): string;
+//# sourceMappingURL=text-utils.d.ts.map

package/dist/src/lib/text-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/text-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUlD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,GAAG,SAAS,CAQzF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAM,GAAG,MAAM,CAKzD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAE3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA+B7D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA8D/C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYtD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAI,EAAE,SAAS,SAAI,GAAG,MAAM,EAAE,CAIxF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,SAAI,GAAG,OAAO,CAcxF;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAwChE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CA+CvB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAKD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EACtC,QAAQ,SAAI,GACX,MAAM,GAAG,SAAS,CA+BpB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ7C;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAoB3D"}

package/dist/src/lib/text-utils.js

@@ -0,0 +1,391 @@
+/**
+ * Text Normalization and Processing Utilities
+ *
+ * Pure utility functions for text processing, normalization,
+ * and string matching used in element discovery.
+ */
+/**
+ * Normalize text for matching:
+ * - Unicode NFKC normalization
+ * - Remove zero-width/invisible characters
+ * - Collapse whitespace
+ */
+export function normalizeText(text) {
+    return (text
+        .normalize('NFKC')
+        // Remove zero-width/invisible characters
+        // eslint-disable-next-line no-misleading-character-class
+        .replace(/[\u200B-\u200D\uFEFF\u034F\u2060\u180E]/g, '')
+        .replace(/\s+/g, ' ')
+        .trim());
+}
+/**
+ * Sanitize accessible name/label hint for selector building
+ * Returns undefined if the result is empty or too short
+ */
+export function sanitizeAccessibleHint(value, maxLength = 160) {
+    const normalized = normalizeText(value);
+    if (!normalized)
+        return undefined;
+    const tokens = normalized.split(' ').filter(Boolean).slice(0, 12);
+    if (tokens.length === 0)
+        return undefined;
+    return truncate(tokens.join(' '), maxLength);
+}
+/**
+ * Truncate string with ellipsis
+ */
+export function truncate(value, max = 120) {
+    if (value.length <= max) {
+        return value;
+    }
+    return `${value.slice(0, max - 1)}…`;
+}
+/**
+ * Escape string for CSS attribute selector (for display labels).
+ * Normalizes and truncates the value.
+ */
+export function escapeAttributeValue(value, maxLength = 120) {
+    return truncate(normalizeText(value), maxLength).replace(/["\\]/g, '\\$&');
+}
+/**
+ * Escape a value for use inside CSS attribute selector quotes.
+ * Follows CSS string serialization spec:
+ * - Null (U+0000) -> U+FFFD replacement character
+ * - Control chars (U+0001-U+001F, U+007F) -> hex escape with trailing space
+ * - Quotes and backslashes -> backslash escape
+ *
+ * Does NOT truncate or normalize. Use for exact-match selectors like [attr="value"].
+ *
+ * @param value - Raw attribute value
+ * @returns String safe for use in [attr="value"] selectors
+ */
+export function escapeAttrSelectorValue(value) {
+    if (!value)
+        return '';
+    const result = [];
+    for (let i = 0; i < value.length; i++) {
+        const char = value.charAt(i);
+        const codeUnit = value.charCodeAt(i);
+        // Null character -> replacement character
+        if (codeUnit === 0) {
+            result.push('\uFFFD');
+            continue;
+        }
+        // Control characters (U+0001 to U+001F, U+007F) -> hex escape with trailing space
+        if ((codeUnit >= 0x0001 && codeUnit <= 0x001f) || codeUnit === 0x007f) {
+            result.push('\\' + codeUnit.toString(16) + ' ');
+            continue;
+        }
+        // Quotes and backslashes -> backslash escape
+        if (char === '"' || char === '\\') {
+            result.push('\\' + char);
+            continue;
+        }
+        result.push(char);
+    }
+    return result.join('');
+}
+/**
+ * Escape a name for use in Playwright-style role locators: role=button[name="..."]
+ * Only escapes quotes and backslashes - keeps control characters raw.
+ * Playwright's role engine matches against actual accessible names, not CSS.
+ *
+ * @param value - Raw accessible name
+ * @returns String safe for use in role=[name="value"] locators
+ */
+export function escapeRoleLocatorName(value) {
+    if (!value)
+        return '';
+    return value.replace(/["\\]/g, '\\$&');
+}
+/**
+ * Escape a string for use in CSS selectors (CSS.escape() semantics).
+ * Does NOT truncate or normalize - uses raw value.
+ * Safe for ID selectors (#id), class selectors (.class), etc.
+ *
+ * Follows CSS.escape() specification:
+ * https://drafts.csswg.org/cssom/#the-css.escape()-method
+ *
+ * @param value - Raw string to escape
+ * @returns CSS-escaped string safe for use in selectors
+ */
+export function cssEscape(value) {
+    if (!value)
+        return '';
+    const result = [];
+    const length = value.length;
+    for (let i = 0; i < length; i++) {
+        const char = value.charAt(i);
+        const codeUnit = value.charCodeAt(i);
+        // Null character -> U+FFFD replacement character
+        if (codeUnit === 0) {
+            result.push('\uFFFD');
+            continue;
+        }
+        // Control characters (U+0001 to U+001F, U+007F) -> unicode escape
+        if ((codeUnit >= 0x0001 && codeUnit <= 0x001f) || codeUnit === 0x007f) {
+            result.push('\\' + codeUnit.toString(16) + ' ');
+            continue;
+        }
+        // First character special rules
+        if (i === 0) {
+            // Digit as first character -> unicode escape
+            if (codeUnit >= 0x0030 && codeUnit <= 0x0039) {
+                result.push('\\' + codeUnit.toString(16) + ' ');
+                continue;
+            }
+            // Single hyphen -> escape
+            if (char === '-' && length === 1) {
+                result.push('\\-');
+                continue;
+            }
+            // Hyphen followed by digit -> escape the hyphen
+            if (char === '-' && length > 1) {
+                const nextCodeUnit = value.charCodeAt(1);
+                if (nextCodeUnit >= 0x0030 && nextCodeUnit <= 0x0039) {
+                    result.push('\\-');
+                    continue;
+                }
+            }
+        }
+        // Safe characters: letters, digits (not first), hyphen, underscore, non-ASCII
+        if (codeUnit >= 0x0080 || // Non-ASCII
+            char === '-' ||
+            char === '_' ||
+            (codeUnit >= 0x0030 && codeUnit <= 0x0039) || // 0-9
+            (codeUnit >= 0x0041 && codeUnit <= 0x005a) || // A-Z
+            (codeUnit >= 0x0061 && codeUnit <= 0x007a) // a-z
+        ) {
+            result.push(char);
+            continue;
+        }
+        // Everything else gets escaped with backslash
+        result.push('\\' + char);
+    }
+    return result.join('');
+}
+/**
+ * Escape string for XPath string literal
+ * XPath doesn't have a standard escape mechanism, so we handle quotes carefully
+ */
+export function escapeXPathValue(value) {
+    if (value.includes("'")) {
+        if (value.includes('"')) {
+            // Contains both - use concat() to build the string
+            const parts = value.split("'");
+            return 'concat(' + parts.map((part) => `'${part}'`).join(', "\'", ') + ')';
+        }
+        // Contains only single quotes - wrap in double quotes
+        return `"${value}"`;
+    }
+    // No single quotes - use as-is (caller wraps in single quotes)
+    return value;
+}
+/**
+ * Tokenize text for XPath matching
+ * Takes first few significant words to avoid overly specific selectors
+ */
+export function tokenizeForMatching(text, maxTokens = 3, minLength = 2) {
+    const normalized = normalizeText(text);
+    const words = normalized.split(' ').filter((word) => word.length > minLength);
+    return words.slice(0, maxTokens);
+}
+/**
+ * Check if two strings match using fuzzy token-based comparison
+ */
+export function fuzzyTokenMatch(text, query, minMatchTokens = 2) {
+    const textTokens = new Set(tokenizeForMatching(text.toLowerCase(), 10, 2));
+    const queryTokens = tokenizeForMatching(query.toLowerCase(), 5, 2);
+    if (queryTokens.length === 0)
+        return false;
+    let matchCount = 0;
+    for (const token of queryTokens) {
+        if (textTokens.has(token)) {
+            matchCount++;
+        }
+    }
+    return matchCount >= Math.min(minMatchTokens, queryTokens.length);
+}
+// ============================================================================
+// Fuzzy Matching Utilities
+// ============================================================================
+/**
+ * Calculate Levenshtein (edit) distance between two strings.
+ * Uses optimized single-row algorithm with O(min(m,n)) space.
+ */
+export function levenshteinDistance(a, b) {
+    // Ensure a is the shorter string for space optimization
+    if (a.length > b.length) {
+        [a, b] = [b, a];
+    }
+    const m = a.length;
+    const n = b.length;
+    // Early exit for empty strings
+    if (m === 0)
+        return n;
+    if (n === 0)
+        return m;
+    // Single row of previous distances
+    let prevRow = new Array(m + 1);
+    let currRow = new Array(m + 1);
+    // Initialize first row
+    for (let i = 0; i <= m; i++) {
+        prevRow[i] = i;
+    }
+    // Fill in the rest
+    for (let j = 1; j <= n; j++) {
+        currRow[0] = j;
+        for (let i = 1; i <= m; i++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            currRow[i] = Math.min(prevRow[i] + 1, // deletion
+            currRow[i - 1] + 1, // insertion
+            prevRow[i - 1] + cost // substitution
+            );
+        }
+        // Swap rows
+        [prevRow, currRow] = [currRow, prevRow];
+    }
+    return prevRow[m];
+}
+/**
+ * Calculate similarity ratio (0-1) between two strings based on Levenshtein distance.
+ * Returns 1 for identical strings, 0 for completely different strings.
+ */
+export function stringSimilarity(a, b) {
+    const maxLen = Math.max(a.length, b.length);
+    if (maxLen === 0)
+        return 1; // Both empty strings are identical
+    return 1 - levenshteinDistance(a, b) / maxLen;
+}
+/**
+ * Enhanced fuzzy token matching with similarity scoring.
+ * Supports exact matching, prefix matching, and edit distance similarity.
+ *
+ * @param textTokens - Tokens from the text being searched
+ * @param queryTokens - Tokens from the search query
+ * @param options - Matching options
+ * @returns Match result with score
+ */
+export function fuzzyTokensMatch(textTokens, queryTokens, options = {}) {
+    const { minTokenOverlap = 0.5, prefixMatch = true, minSimilarity = 0.8 } = options;
+    if (queryTokens.length === 0) {
+        return { isMatch: false, score: 0 };
+    }
+    let totalScore = 0;
+    for (const queryToken of queryTokens) {
+        let bestMatch = 0;
+        for (const textToken of textTokens) {
+            // Exact match - perfect score
+            if (textToken === queryToken) {
+                bestMatch = 1;
+                break;
+            }
+            // Prefix match - high score (query token is prefix of text token)
+            if (prefixMatch && textToken.startsWith(queryToken)) {
+                bestMatch = Math.max(bestMatch, 0.9);
+                continue;
+            }
+            // Prefix match - query token contains text token (slightly lower)
+            if (prefixMatch && queryToken.startsWith(textToken)) {
+                bestMatch = Math.max(bestMatch, 0.85);
+                continue;
+            }
+            // Edit distance similarity - typo tolerance
+            const similarity = stringSimilarity(textToken, queryToken);
+            if (similarity >= minSimilarity) {
+                bestMatch = Math.max(bestMatch, similarity);
+            }
+        }
+        totalScore += bestMatch;
+    }
+    const overlapRatio = totalScore / queryTokens.length;
+    return {
+        isMatch: overlapRatio >= minTokenOverlap,
+        score: overlapRatio,
+    };
+}
+/** DOM node type constant for text nodes */
+const TEXT_NODE_TYPE = 3;
+/**
+ * Extract text content from a DOM node by concatenating text-node children.
+ * Uses depth-limited traversal to avoid performance issues.
+ *
+ * @param nodeId - Backend node ID of the element
+ * @param domNodes - Map of backendNodeId -> node with nodeType, nodeValue, childNodeIds
+ * @param maxDepth - Maximum depth to traverse (default: 2)
+ * @returns Normalized text content or undefined if none found
+ */
+export function getTextContent(nodeId, domNodes, maxDepth = 2) {
+    const parts = [];
+    function traverse(currentNodeId, depth) {
+        if (depth > maxDepth)
+            return;
+        const node = domNodes.get(currentNodeId);
+        if (!node)
+            return;
+        // Collect text from text nodes
+        if (node.nodeType === TEXT_NODE_TYPE && node.nodeValue) {
+            const trimmed = node.nodeValue.trim();
+            if (trimmed) {
+                parts.push(trimmed);
+            }
+        }
+        // Traverse children
+        if (node.childNodeIds) {
+            for (const childId of node.childNodeIds) {
+                traverse(childId, depth + 1);
+            }
+        }
+    }
+    traverse(nodeId, 0);
+    if (parts.length === 0)
+        return undefined;
+    const result = normalizeText(parts.join(' '));
+    return result || undefined;
+}
+/**
+ * Escape special XML characters in a string.
+ * Used for XML element content and attribute values.
+ *
+ * @param str - String to escape
+ * @returns XML-safe string
+ */
+export function escapeXml(str) {
+    if (!str)
+        return '';
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+/**
+ * Build an XML attribute string, choosing quote style to minimize escaping.
+ * Uses single quotes when value contains double quotes (common in selectors).
+ *
+ * @param name - Attribute name
+ * @param value - Attribute value
+ * @returns Formatted attribute string like `name="value"` or `name='value'`
+ */
+export function xmlAttr(name, value) {
+    if (!value)
+        return `${name}=""`;
+    const hasDoubleQuote = value.includes('"');
+    const hasSingleQuote = value.includes("'");
+    // Prefer single quotes when value contains double quotes (common in selectors)
+    if (hasDoubleQuote && !hasSingleQuote) {
+        const escaped = value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+        return `${name}='${escaped}'`;
+    }
+    // Default: double-quote wrapping with full escaping
+    const escaped = value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+    return `${name}="${escaped}"`;
+}
+//# sourceMappingURL=text-utils.js.map

package/dist/src/lib/text-utils.js.map

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

package/dist/src/observation/eid-linker.d.ts

@@ -0,0 +1,104 @@
+/**
+ * EID Linker
+ *
+ * Links DOM observations to snapshot nodes by semantic matching.
+ * Since observations are captured in browser context (no access to CDP backend_node_id),
+ * we perform post-hoc matching after snapshot capture using semantic signals:
+ * - Tag → Kind mapping
+ * - Role matching
+ * - Label/text fuzzy matching
+ */
+import type { DOMObservation, ObservationGroups, ObservationChild } from './observation.types.js';
+import type { BaseSnapshot, ReadableNode, NodeKind } from '../snapshot/snapshot.types.js';
+import type { ElementRegistry } from '../state/element-registry.js';
+/**
+ * Configuration for observation-to-node matching.
+ */
+export interface EidLinkerOptions {
+    /** Minimum score threshold for a valid match (0-1). Default: 0.5 */
+    minMatchScore?: number;
+    /** Enable fuzzy text matching. Default: true */
+    fuzzyTextMatch?: boolean;
+    /** Minimum token overlap for fuzzy matching. Default: 0.5 */
+    minTokenOverlap?: number;
+}
+/**
+ * Result of eid linking operation.
+ */
+export interface EidLinkingResult {
+    /** Number of observations that were linked */
+    linked: number;
+    /** Number of observations that could not be linked */
+    unlinked: number;
+    /** Total observations processed */
+    total: number;
+}
+/**
+ * Link observations to snapshot nodes by computing eids.
+ *
+ * Mutates observations in-place, setting the `eid` field for matched observations.
+ * Only processes 'appeared' observations (disappeared elements don't exist in snapshot).
+ *
+ * @param observations - Observation groups to link
+ * @param snapshot - Current snapshot to match against
+ * @param registry - Element registry for eid lookup
+ * @param options - Matching configuration
+ * @returns Statistics about linking operation
+ */
+export declare function linkObservationsToSnapshot(observations: ObservationGroups, snapshot: BaseSnapshot, registry: ElementRegistry, options?: EidLinkerOptions): EidLinkingResult;
+/**
+ * Build an index of snapshot nodes by kind for efficient lookup.
+ *
+ * @param snapshot - Snapshot to index
+ * @returns Map from NodeKind to array of nodes
+ */
+export declare function buildNodeIndex(snapshot: BaseSnapshot): Map<NodeKind, ReadableNode[]>;
+/**
+ * Find the best matching node for an observation.
+ *
+ * @param observation - The observation to match
+ * @param nodeIndex - Pre-built index of nodes by kind
+ * @param options - Matching options
+ * @returns Best matching node or undefined if no match meets threshold
+ */
+export declare function findBestMatch(observation: DOMObservation, nodeIndex: Map<NodeKind, ReadableNode[]>, options?: EidLinkerOptions): ReadableNode | undefined;
+/**
+ * Get candidate NodeKind values for an observation based on tag and role.
+ */
+export declare function getCandidateKinds(observation: DOMObservation): NodeKind[];
+/**
+ * Compute match score between an observation and a snapshot node.
+ *
+ * Scoring breakdown:
+ * - Tag/Kind match: 0.3 (required - if no match, return 0)
+ * - Role match: 0.25
+ * - Label fuzzy match: 0.3
+ * - Dialog context match: 0.15
+ *
+ * @param observation - DOM observation
+ * @param node - Snapshot node
+ * @param options - Matching options
+ * @returns Score from 0-1 (0 = no match, 1 = perfect match)
+ */
+export declare function computeMatchScore(observation: DOMObservation, node: ReadableNode, options?: EidLinkerOptions): number;
+/**
+ * Build a pre-filtered list of interactive nodes for child extraction.
+ * This is O(n) and done once per snapshot, avoiding O(m*n) when processing m observations.
+ *
+ * @param snapshot - Snapshot to filter
+ * @returns Array of nodes that qualify as observation children
+ */
+export declare function buildInteractiveNodeList(snapshot: BaseSnapshot): ReadableNode[];
+/**
+ * Extract notable children from an observation's matched node.
+ *
+ * Finds interactive elements and headings that are visually contained within
+ * the observation container, up to MAX_OBSERVATION_CHILDREN limit.
+ *
+ * @param matchedNode - The snapshot node that matched the observation
+ * @param interactiveNodes - Pre-filtered list of interactive nodes (from buildInteractiveNodeList)
+ * @param registry - Element registry for eid lookup
+ * @returns Array of observation children (interactive elements and headings)
+ */
+export declare function extractObservationChildren(matchedNode: ReadableNode, interactiveNodes: ReadableNode[], registry: ElementRegistry): ObservationChild[];
+//# sourceMappingURL=eid-linker.d.ts.map

package/dist/src/observation/eid-linker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eid-linker.d.ts","sourceRoot":"","sources":["../../../src/observation/eid-linker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAOpE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,gDAAgD;IAChD,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IAEf,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IAEjB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AA2GD;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,iBAAiB,EAC/B,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,gBAAqB,GAC7B,gBAAgB,CAkDlB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,CAWpF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,cAAc,EAC3B,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,EACxC,OAAO,GAAE,gBAAqB,GAC7B,YAAY,GAAG,SAAS,CAgC1B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,cAAc,GAAG,QAAQ,EAAE,CAyBzE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,cAAc,EAC3B,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE,gBAAqB,GAC7B,MAAM,CAkDR;AA0CD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,EAAE,CAE/E;AAgDD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,YAAY,EACzB,gBAAgB,EAAE,YAAY,EAAE,EAChC,QAAQ,EAAE,eAAe,GACxB,gBAAgB,EAAE,CAuBpB"}