@dyyz1993/agent-browser 0.28.0 → 0.29.1

package/dist/snapshot.js

@@ -1,1801 +1,2 @@
-/**
- * Enhanced snapshot with element refs for deterministic element selection.
- *
- * This module generates accessibility snapshots with embedded refs that can be
- * used to click/fill/interact with elements without re-querying the DOM.
- *
- * Example output:
- *   - heading "Example Domain" [ref=e1] [level=1]
- *   - paragraph: Some text content
- *   - button "Submit" [ref=e2]
- *   - textbox "Email" [ref=e3]
- *
- * Usage:
- *   agent-browser snapshot              # Full snapshot
- *   agent-browser snapshot -i           # Interactive elements only
- *   agent-browser snapshot --depth 3    # Limit depth
- *   agent-browser click @e2             # Click element by ref
- */
-// Counter for generating refs
-let refCounter = 0;
-/**
- * Reset ref counter (call at start of each snapshot)
- */
-export function resetRefs() {
-    refCounter = 0;
-}
-/**
- * Generate next ref ID
- */
-function nextRef() {
-    return `e${++refCounter}`;
-}
-/**
- * Roles that are interactive and should get refs
- */
-const INTERACTIVE_ROLES = new Set([
-    'button',
-    'link',
-    'textbox',
-    'checkbox',
-    'radio',
-    'combobox',
-    'listbox',
-    'menuitem',
-    'menuitemcheckbox',
-    'menuitemradio',
-    'option',
-    'searchbox',
-    'slider',
-    'spinbutton',
-    'switch',
-    'tab',
-    'treeitem',
-]);
-/**
- * Roles that provide structure/context (get refs for text extraction)
- */
-const CONTENT_ROLES = new Set([
-    'heading',
-    'cell',
-    'gridcell',
-    'columnheader',
-    'rowheader',
-    'listitem',
-    'article',
-    'region',
-    'main',
-    'navigation',
-]);
-/**
- * Roles that are purely structural (can be filtered in compact mode)
- */
-const STRUCTURAL_ROLES = new Set([
-    'generic',
-    'group',
-    'list',
-    'table',
-    'row',
-    'rowgroup',
-    'grid',
-    'treegrid',
-    'menu',
-    'menubar',
-    'toolbar',
-    'tablist',
-    'tree',
-    'directory',
-    'document',
-    'application',
-    'presentation',
-    'none',
-]);
-/**
- * Build a selector string for storing in ref map
- */
-function buildSelector(role, name) {
-    if (name) {
-        const escapedName = name.replace(/"/g, '\\"');
-        return `getByRole('${role}', { name: "${escapedName}", exact: true })`;
-    }
-    return `getByRole('${role}')`;
-}
-/**
- * Query the page for clickable elements that might not have proper ARIA roles.
- * This finds elements with cursor: pointer or onclick handlers.
- */
-async function findCursorInteractiveElements(page, selector) {
-    const rootSelector = selector || 'body';
-    // Use a string function body to avoid TypeScript transpilation issues
-    const scriptBody = `(rootSel) => {
-    const results = [];
-
-    // Elements that already have interactive ARIA roles - skip these
-    const interactiveRoles = new Set([
-      'button', 'link', 'textbox', 'checkbox', 'radio', 'combobox', 'listbox',
-      'menuitem', 'menuitemcheckbox', 'menuitemradio', 'option', 'searchbox',
-      'slider', 'spinbutton', 'switch', 'tab', 'treeitem'
-    ]);
-
-    // Tags that are already interactive by default
-    const interactiveTags = new Set([
-      'a', 'button', 'input', 'select', 'textarea', 'details', 'summary'
-    ]);
-
-    const root = document.querySelector(rootSel) || document.body;
-    const allElements = root.querySelectorAll('*');
-
-    // Build a unique selector for an element
-    const buildSelector = (el) => {
-      const testId = el.getAttribute('data-testid');
-      if (testId) return '[data-testid="' + testId + '"]';
-      if (el.id) return '#' + CSS.escape(el.id);
-
-      const path = [];
-      let current = el;
-      while (current && current !== document.body) {
-        let sel = current.tagName.toLowerCase();
-        const classes = Array.from(current.classList).filter(c => c.trim());
-        if (classes.length > 0) sel += '.' + CSS.escape(classes[0]);
-
-        const parent = current.parentElement;
-        if (parent) {
-          const siblings = Array.from(parent.children);
-          const matching = siblings.filter(s => {
-            if (s.tagName !== current.tagName) return false;
-            if (classes.length > 0 && !s.classList.contains(classes[0])) return false;
-            return true;
-          });
-          if (matching.length > 1) {
-            const idx = matching.indexOf(current) + 1;
-            sel += ':nth-of-type(' + idx + ')';
-          }
-        }
-        path.unshift(sel);
-        current = current.parentElement;
-        if (path.length >= 3) break;
-      }
-      return path.join(' > ');
-    };
-
-    // Heuristic patterns for clickable element class names
-    // Use substring matching (contains) for more flexible detection
-    const clickableClassPatterns = [
-      /tab/i,        // matches: tab, tabs, tab-item, creator-tab, tablist
-      /btn/i,        // matches: btn, button, btn-primary, my-btn
-      /button/i,     // matches: button, button-group, my-button
-      /clickable/i,  // matches: clickable, is-clickable, clickable-area
-      /action/i,     // matches: action, actions, action-btn, user-action
-      /menuitem/i,   // matches: menuitem, menu-item, my-menuitem
-      /navitem/i,    // matches: navitem, nav-item, navbar-item
-      /listitem/i,   // matches: listitem, list-item, my-listitem
-      /card/i,       // matches: card, card-item, profile-card
-      /toggle/i,     // matches: toggle, toggle-btn, dark-toggle
-      /switch/i,     // matches: switch, switch-btn, toggle-switch
-      /dropdown/i,   // matches: dropdown, dropdown-menu, my-dropdown
-      /modal/i,      // matches: modal, modal-trigger, modal-open
-      /popup/i,      // matches: popup, popup-trigger, show-popup
-      /close/i,      // matches: close, close-btn, modal-close
-      /dismiss/i,    // matches: dismiss, dismiss-btn
-      /expand/i,     // matches: expand, expand-btn, expandable
-      /collapse/i,   // matches: collapse, collapse-btn, collapsible
-    ];
-
-    // Check if element looks clickable based on class name
-    const hasClickableClassName = (el) => {
-      const className = el.getAttribute('class') || '';
-      // Split by whitespace and check each individual class
-      const classes = className.split(/\s+/);
-      return classes.some(cls => clickableClassPatterns.some(p => p.test(cls)));
-    };
-
-    // Check for Vue/React event handlers (data attributes or special patterns)
-    const hasFrameworkEventHandler = (el) => {
-      // Vue: elements with @click often have data-v-* attributes and are in components
-      // Check for common Vue/React patterns
-      const attrs = el.attributes;
-      for (let i = 0; i < attrs.length; i++) {
-        const name = attrs[i].name;
-        // Vue compiled @click handlers
-        if (name.startsWith('data-v-')) return true;
-        // React synthetic events sometimes leave traces
-        if (name.startsWith('data-reactid')) return true;
-      }
-      return false;
-    };
-
-    for (const el of allElements) {
-      const tagName = el.tagName.toLowerCase();
-      if (interactiveTags.has(tagName)) continue;
-
-      const role = el.getAttribute('role');
-      if (role && interactiveRoles.has(role.toLowerCase())) continue;
-
-      const computedStyle = getComputedStyle(el);
-      const hasCursorPointer = computedStyle.cursor === 'pointer';
-      const hasOnClick = el.hasAttribute('onclick') || el.onclick !== null;
-      const tabIndex = el.getAttribute('tabindex');
-      const hasTabIndex = tabIndex !== null && tabIndex !== '-1';
-
-      // New heuristic checks
-      const looksClickable = hasClickableClassName(el);
-      const hasFrameworkEvent = hasFrameworkEventHandler(el);
-
-      // Skip if no indication of interactivity
-      // Only include elements that look explicitly clickable (not just have framework events)
-      const isClickable = hasCursorPointer || hasOnClick || hasTabIndex || looksClickable;
-      if (!isClickable) continue;
-
-      // Get direct text content only (exclude child elements' text)
-      // This helps avoid duplicate entries from parent containers
-      let text = '';
-      for (const node of el.childNodes) {
-        if (node.nodeType === Node.TEXT_NODE) {
-          text += node.textContent || '';
-        }
-      }
-      text = text.trim();
-
-      // If no direct text, check if element has only one child element (like a span)
-      // This handles cases like <div class="tab"><span>Tab Text</span></div>
-      if (!text && el.children.length === 1) {
-        const child = el.children[0];
-        // Check if child is a simple inline element with only text
-        if (child.tagName === 'SPAN' || child.tagName === 'A' || child.tagName === 'LABEL') {
-          text = (child.textContent || '').trim();
-        }
-      }
-
-      // Skip if no text
-      if (!text) continue;
-
-      // Skip if text is too long (likely a container with many children)
-      if (text.length > 30) continue;
-
-      const rect = el.getBoundingClientRect();
-      if (rect.width === 0 || rect.height === 0) continue;
-
-      // Determine if this is truly clickable or just has framework events
-      const trulyClickable = hasCursorPointer || hasOnClick || hasTabIndex || looksClickable;
-
-      results.push({
-        selector: buildSelector(el),
-        text,
-        tagName,
-        hasOnClick,
-        hasCursorPointer: trulyClickable,
-        hasTabIndex
-      });
-    }
-    return results;
-  }`;
-    const fn = new Function('return ' + scriptBody)();
-    return page.evaluate(fn, rootSelector);
-}
-/**
- * Suggest common selectors for the current page
- */
-async function suggestSelectors(page) {
-    const selectors = [];
-    try {
-        const commonSelectors = [
-            'body',
-            'main',
-            '#main',
-            '#content',
-            '.content',
-            'article',
-            'form',
-            '#app',
-            '.app',
-        ];
-        for (const selector of commonSelectors) {
-            try {
-                const locator = page.locator(selector);
-                const count = await locator.count();
-                if (count > 0) {
-                    selectors.push(selector);
-                }
-            }
-            catch {
-                // Ignore errors
-            }
-        }
-        if (selectors.length === 0) {
-            selectors.push('body');
-        }
-    }
-    catch {
-        selectors.push('body');
-    }
-    return selectors;
-}
-export async function generateStableSelectors(page, refs) {
-    const result = {};
-    for (const [ref, data] of Object.entries(refs)) {
-        if (data.role === 'clickable' || data.role === 'focusable') {
-            if (data.selector && !data.selector.startsWith('getByRole')) {
-                result[ref] = { cssSelector: data.selector, xpath: '' };
-            }
-            continue;
-        }
-        try {
-            let locator;
-            if (data.name) {
-                locator = page.getByRole(data.role, {
-                    name: data.name,
-                    exact: true,
-                });
-            }
-            else {
-                locator = page.getByRole(data.role);
-            }
-            if (data.nth !== undefined) {
-                locator = locator.nth(data.nth);
-            }
-            const elementCount = await locator.count();
-            if (elementCount === 0)
-                continue;
-            const selectorData = await locator
-                .evaluate((el) => {
-                const UTILITY_CLASS_PATTERNS = [
-                    /^_/,
-                    /^css-/,
-                    /^[a-z]{1,2}$/,
-                    /^(active|disabled|hidden|visible|selected|hover|focus|current|open|closed)$/i,
-                    /^(text-|font-|bg-|p-|m-|w-|h-|flex|grid|border|rounded|shadow|opacity|z-)/,
-                    /^(sm:|md:|lg:|xl:|2xl:)/,
-                ];
-                const SEMANTIC_ATTRS = [
-                    'data-testid',
-                    'data-test',
-                    'data-cy',
-                    'name',
-                    'aria-label',
-                    'aria-labelledby',
-                    'role',
-                    'type',
-                    'placeholder',
-                    'title',
-                    'alt',
-                ];
-                function isHighEntropyClassName(className) {
-                    if (!className || className.length < 4 || className.length > 15)
-                        return false;
-                    if (/^[a-zA-Z]+_[a-zA-Z]+_{2}[a-zA-Z0-9]+$/.test(className))
-                        return true;
-                    if (/^sc-[a-zA-Z0-9]+$/.test(className))
-                        return true;
-                    const hasUpper = /[A-Z]/.test(className);
-                    const hasLower = /[a-z]/.test(className);
-                    const hasDigit = /[0-9]/.test(className);
-                    const hasSeparator = /[-_]/.test(className);
-                    if (hasSeparator)
-                        return false;
-                    if (hasUpper && hasLower && hasDigit)
-                        return true;
-                    if (/^[A-Z][a-z0-9]+[A-Z]/.test(className) && className.length <= 12)
-                        return true;
-                    if (/^[a-z]/.test(className) && /[a-z][A-Z][a-z][A-Z]/.test(className))
-                        return true;
-                    return false;
-                }
-                function isUniqueSelector(selector) {
-                    try {
-                        return document.querySelectorAll(selector).length === 1;
-                    }
-                    catch {
-                        return false;
-                    }
-                }
-                function filterUsefulClasses(element) {
-                    const htmlEl = element;
-                    if (!htmlEl.className || typeof htmlEl.className !== 'string')
-                        return [];
-                    return htmlEl.className
-                        .trim()
-                        .split(/\s+/)
-                        .filter((c) => {
-                        if (!c)
-                            return false;
-                        if (UTILITY_CLASS_PATTERNS.some((p) => p.test(c)))
-                            return false;
-                        if (isHighEntropyClassName(c))
-                            return false;
-                        return true;
-                    });
-                }
-                function tryIdSelector(element) {
-                    const htmlEl = element;
-                    if (htmlEl.id) {
-                        const sel = '#' + CSS.escape(htmlEl.id);
-                        if (isUniqueSelector(sel))
-                            return sel;
-                    }
-                    return null;
-                }
-                function getMultiAttributeSelector(element) {
-                    const tag = element.tagName.toLowerCase();
-                    const attrs = [];
-                    for (const attr of SEMANTIC_ATTRS) {
-                        const value = element.getAttribute(attr);
-                        if (value)
-                            attrs.push({ attr, value });
-                    }
-                    if (attrs.length === 0)
-                        return null;
-                    for (const { attr, value } of attrs) {
-                        const sel = tag + '[' + attr + '="' + CSS.escape(value) + '"]';
-                        if (isUniqueSelector(sel))
-                            return sel;
-                    }
-                    if (attrs.length >= 2) {
-                        for (let i = 0; i < attrs.length; i++) {
-                            for (let j = i + 1; j < attrs.length; j++) {
-                                const sel = tag +
-                                    '[' +
-                                    attrs[i].attr +
-                                    '="' +
-                                    CSS.escape(attrs[i].value) +
-                                    '"]' +
-                                    '[' +
-                                    attrs[j].attr +
-                                    '="' +
-                                    CSS.escape(attrs[j].value) +
-                                    '"]';
-                                if (isUniqueSelector(sel))
-                                    return sel;
-                            }
-                        }
-                    }
-                    return null;
-                }
-                function getAttributeClassComboSelector(element) {
-                    const tag = element.tagName.toLowerCase();
-                    const classes = filterUsefulClasses(element);
-                    if (classes.length === 0)
-                        return null;
-                    classes.sort((a, b) => b.length - a.length);
-                    const bestClass = classes[0];
-                    for (const attr of SEMANTIC_ATTRS) {
-                        const value = element.getAttribute(attr);
-                        if (value) {
-                            const sel = tag + '.' + CSS.escape(bestClass) + '[' + attr + '="' + CSS.escape(value) + '"]';
-                            if (isUniqueSelector(sel))
-                                return sel;
-                        }
-                    }
-                    return null;
-                }
-                function getBestClassSelector(element) {
-                    const classes = filterUsefulClasses(element);
-                    if (classes.length === 0)
-                        return null;
-                    classes.sort((a, b) => b.length - a.length);
-                    const tag = element.tagName.toLowerCase();
-                    for (const cls of classes) {
-                        const sel = tag + '.' + CSS.escape(cls);
-                        if (isUniqueSelector(sel))
-                            return sel;
-                    }
-                    for (let i = 2; i <= Math.min(3, classes.length); i++) {
-                        const sel = tag +
-                            '.' +
-                            classes
-                                .slice(0, i)
-                                .map((c) => CSS.escape(c))
-                                .join('.');
-                        if (isUniqueSelector(sel))
-                            return sel;
-                    }
-                    return null;
-                }
-                function getFeatureSelector(element) {
-                    if (!element || element === document.body)
-                        return null;
-                    const htmlEl = element;
-                    if (htmlEl.id)
-                        return '#' + CSS.escape(htmlEl.id);
-                    for (const attr of ['data-testid', 'data-test', 'name', 'role', 'aria-label']) {
-                        const value = element.getAttribute(attr);
-                        if (value)
-                            return element.tagName.toLowerCase() + '[' + attr + '="' + CSS.escape(value) + '"]';
-                    }
-                    const classes = filterUsefulClasses(element);
-                    if (classes.length > 0) {
-                        classes.sort((a, b) => b.length - a.length);
-                        const sel = element.tagName.toLowerCase() + '.' + CSS.escape(classes[0]);
-                        if (isUniqueSelector(sel))
-                            return sel;
-                    }
-                    return null;
-                }
-                function getBaseSelector(element) {
-                    let sel = element.tagName.toLowerCase();
-                    const classes = filterUsefulClasses(element);
-                    if (classes.length > 0) {
-                        classes.sort((a, b) => b.length - a.length);
-                        sel +=
-                            '.' +
-                                classes
-                                    .slice(0, 2)
-                                    .map((c) => CSS.escape(c))
-                                    .join('.');
-                    }
-                    return sel;
-                }
-                function makeUniqueWithNth(element, baseSelector) {
-                    const parent = element.parentElement;
-                    if (!parent)
-                        return baseSelector;
-                    const siblings = Array.from(parent.children);
-                    const sameTagSiblings = siblings.filter((s) => s.tagName === element.tagName);
-                    if (sameTagSiblings.length === 1)
-                        return baseSelector;
-                    const index = siblings.indexOf(element) + 1;
-                    return baseSelector + ':nth-child(' + index + ')';
-                }
-                function getSiblingBasedSelector(element) {
-                    let prevSibling = element.previousElementSibling;
-                    let attempts = 0;
-                    while (prevSibling && attempts < 3) {
-                        const siblingSelector = getFeatureSelector(prevSibling);
-                        if (siblingSelector && isUniqueSelector(siblingSelector)) {
-                            const elementSelector = getBaseSelector(element);
-                            const combined = siblingSelector + ' + ' + elementSelector;
-                            if (isUniqueSelector(combined))
-                                return combined;
-                        }
-                        prevSibling = prevSibling.previousElementSibling;
-                        attempts++;
-                    }
-                    return null;
-                }
-                function buildComposedSelector(element) {
-                    const selfSelector = getBestClassSelector(element);
-                    if (selfSelector && isUniqueSelector(selfSelector))
-                        return selfSelector;
-                    const parts = [];
-                    let current = element;
-                    let depth = 0;
-                    const maxDepth = 3;
-                    while (current && current !== document.body && depth < maxDepth) {
-                        const featureSelector = getFeatureSelector(current);
-                        if (featureSelector) {
-                            parts.unshift(featureSelector);
-                            const elementSelector = depth === 0 ? getBaseSelector(element) : getBaseSelector(current);
-                            const fullSelector = parts.join(' > ') + (depth > 0 ? '' : ' > ' + elementSelector);
-                            if (isUniqueSelector(fullSelector))
-                                return fullSelector;
-                        }
-                        else {
-                            const baseSelector = getBaseSelector(current);
-                            const selector = makeUniqueWithNth(current, baseSelector);
-                            parts.unshift(selector);
-                            const fullSelector = parts.join(' > ');
-                            if (isUniqueSelector(fullSelector))
-                                return fullSelector;
-                        }
-                        current = current.parentElement;
-                        depth++;
-                    }
-                    return parts.length > 0 ? parts.join(' > ') : null;
-                }
-                function tryNthChild(element) {
-                    const baseSelector = getBaseSelector(element);
-                    const uniqueSelector = makeUniqueWithNth(element, baseSelector);
-                    try {
-                        if (document.querySelectorAll(uniqueSelector).length === 1)
-                            return uniqueSelector;
-                    }
-                    catch {
-                        // Intentionally ignored: invalid CSS selector in tryNthChild
-                    }
-                    return null;
-                }
-                function buildUniquePath(element) {
-                    const parts = [];
-                    let current = element;
-                    let depth = 0;
-                    while (current && current !== document.body && depth < 5) {
-                        const baseSelector = getBaseSelector(current);
-                        const selector = makeUniqueWithNth(current, baseSelector);
-                        parts.unshift(selector);
-                        const fullSelector = parts.join(' > ');
-                        if (isUniqueSelector(fullSelector))
-                            return fullSelector;
-                        current = current.parentElement;
-                        depth++;
-                    }
-                    return parts.length > 0 ? parts.join(' > ') : null;
-                }
-                function generateXPath(element) {
-                    const htmlEl = element;
-                    if (htmlEl.id)
-                        return '//*[@id="' + htmlEl.id + '"]';
-                    const testId = element.getAttribute('data-testid');
-                    if (testId)
-                        return '//*[@data-testid="' + testId + '"]';
-                    const nameAttr = element.getAttribute('name');
-                    if (nameAttr)
-                        return '//' + element.tagName.toLowerCase() + '[@name="' + nameAttr + '"]';
-                    const parts = [];
-                    let current = element;
-                    let depth = 0;
-                    while (current && depth < 5) {
-                        const curHtml = current;
-                        if (curHtml.id) {
-                            parts.unshift('//*[@id="' + curHtml.id + '"]');
-                            break;
-                        }
-                        const testId = current.getAttribute('data-testid');
-                        if (testId) {
-                            parts.unshift('//*[@data-testid="' + testId + '"]');
-                            break;
-                        }
-                        const tagName = current.tagName.toLowerCase();
-                        const parent = current.parentElement;
-                        if (parent) {
-                            const siblings = Array.from(parent.children).filter((c) => c.tagName === current.tagName);
-                            const index = siblings.indexOf(current) + 1;
-                            parts.unshift(tagName + '[' + index + ']');
-                        }
-                        else {
-                            parts.unshift(tagName);
-                        }
-                        current = current.parentElement;
-                        depth++;
-                    }
-                    if (parts.length > 0 && !parts[0].startsWith('//'))
-                        parts.unshift('//');
-                    return parts.join('/');
-                }
-                let cssSelector = null;
-                cssSelector = tryIdSelector(el);
-                if (!cssSelector)
-                    cssSelector = getMultiAttributeSelector(el);
-                if (!cssSelector)
-                    cssSelector = getAttributeClassComboSelector(el);
-                if (!cssSelector)
-                    cssSelector = getBestClassSelector(el);
-                if (!cssSelector)
-                    cssSelector = getSiblingBasedSelector(el);
-                if (!cssSelector)
-                    cssSelector = buildComposedSelector(el);
-                if (!cssSelector)
-                    cssSelector = tryNthChild(el);
-                if (!cssSelector)
-                    cssSelector = buildUniquePath(el);
-                if (!cssSelector)
-                    cssSelector = el.tagName.toLowerCase();
-                const xpath = generateXPath(el);
-                return { cssSelector, xpath };
-            })
-                .catch(() => null);
-            if (selectorData) {
-                result[ref] = {
-                    cssSelector: selectorData.cssSelector,
-                    xpath: selectorData.xpath,
-                };
-            }
-        }
-        catch {
-            // Intentionally ignored: element ref generation failed for this element
-        }
-    }
-    return result;
-}
-/**
- * Get enhanced snapshot with refs and optional filtering
- */
-export async function getEnhancedSnapshot(page, options = {}) {
-    if ((options.path || options.attrs) && !options.selector) {
-        throw new Error('由于内容可能过大，请使用 selector 参数限定范围');
-    }
-    resetRefs();
-    const refs = {};
-    const locator = options.selector ? page.locator(options.selector) : page.locator(':root');
-    let ariaTree;
-    try {
-        ariaTree = await locator.ariaSnapshot({ timeout: 2000 });
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        if (errorMessage.includes('Timeout') && options.selector) {
-            const suggestedSelectors = await suggestSelectors(page);
-            return {
-                tree: `(no elements found for selector: ${options.selector})\n\nSuggested selectors: ${suggestedSelectors.join(', ')}`,
-                refs: {},
-            };
-        }
-        throw error;
-    }
-    if (!ariaTree) {
-        return {
-            tree: '(empty)',
-            refs: {},
-        };
-    }
-    const enhancedTree = processAriaTree(ariaTree, refs, options);
-    if (options.cursor) {
-        const cursorElements = await findCursorInteractiveElements(page, options.selector);
-        const existingTexts = new Set(Object.values(refs).map((r) => r.name?.toLowerCase()));
-        const additionalLines = [];
-        for (const el of cursorElements) {
-            if (existingTexts.has(el.text.toLowerCase()))
-                continue;
-            const ref = nextRef();
-            const role = el.hasCursorPointer ? 'clickable' : el.hasOnClick ? 'clickable' : 'focusable';
-            refs[ref] = {
-                selector: el.selector,
-                role: role,
-                name: el.text,
-            };
-            const hints = [];
-            if (el.hasCursorPointer)
-                hints.push('cursor:pointer');
-            if (el.hasOnClick)
-                hints.push('onclick');
-            if (el.hasTabIndex)
-                hints.push('tabindex');
-            additionalLines.push(`- ${role} "${el.text}" [ref=${ref}] [${hints.join(', ')}]`);
-        }
-        if (additionalLines.length > 0) {
-            const separator = enhancedTree === '(no interactive elements)' ? '' : '\n# Cursor-interactive elements:\n';
-            const base = enhancedTree === '(no interactive elements)' ? '' : enhancedTree;
-            return {
-                tree: base + separator + additionalLines.join('\n'),
-                refs,
-            };
-        }
-    }
-    if (options.path || options.attrs) {
-        await enrichRefsWithPathsAndAttrs(page, refs, options);
-    }
-    let finalTree = enhancedTree;
-    if (options.selectors && Object.keys(refs).length > 0) {
-        const selectorMap = await buildCompactSelectors(page, refs, options);
-        if (selectorMap) {
-            finalTree += '\n## Selectors\n' + selectorMap;
-        }
-    }
-    return { tree: finalTree, refs };
-}
-async function buildCompactSelectors(page, refs, options) {
-    const entries = Object.entries(refs);
-    const parts = [];
-    const includeAll = options?.all ?? false;
-    for (const [ref, data] of entries) {
-        if (data.role === 'clickable' || data.role === 'focusable')
-            continue;
-        try {
-            let locator;
-            if (data.name) {
-                locator = page.getByRole(data.role, {
-                    name: data.name,
-                    exact: true,
-                });
-            }
-            else {
-                locator = page.getByRole(data.role);
-            }
-            if (data.nth !== undefined)
-                locator = locator.nth(data.nth);
-            if (!includeAll) {
-                const isReallyVisible = await locator
-                    .evaluate((el) => {
-                    const style = getComputedStyle(el);
-                    const rect = el.getBoundingClientRect();
-                    return !(style.display === 'none' ||
-                        style.visibility === 'hidden' ||
-                        parseFloat(style.opacity) === 0 ||
-                        (rect.width === 0 && rect.height === 0) ||
-                        rect.x + rect.width < 0 ||
-                        rect.y + rect.height < 0);
-                })
-                    .catch(() => false);
-                if (!isReallyVisible)
-                    continue;
-            }
-            const attrs = await locator
-                .evaluate((el) => {
-                const htmlEl = el;
-                const r = {};
-                if (htmlEl.dataset.testid)
-                    r['testid'] = `[data-testid="${htmlEl.dataset.testid}"]`;
-                if (htmlEl.id && !htmlEl.id.match(/^[:]/))
-                    r['id'] = '#' + CSS.escape(htmlEl.id);
-                const nameAttr = htmlEl.getAttribute('name');
-                if (nameAttr)
-                    r['name'] = `${htmlEl.tagName.toLowerCase()}[name="${nameAttr}"]`;
-                return r;
-            })
-                .catch(() => null);
-            if (!attrs)
-                continue;
-            let bestSelector = '';
-            if (attrs.testid)
-                bestSelector = attrs.testid;
-            else if (attrs.id)
-                bestSelector = attrs.id;
-            else if (attrs.name)
-                bestSelector = attrs.name;
-            if (bestSelector) {
-                parts.push(`${ref}: ${bestSelector}`);
-            }
-        }
-        catch {
-            // skip
-        }
-    }
-    return parts.join(' | ');
-}
-async function enrichRefsWithPathsAndAttrs(page, refs, options) {
-    if (Object.keys(refs).length === 0) {
-        return;
-    }
-    void `
-    () => {
-      const STYLE_CLASS_PATTERNS = [
-        /^(flex|grid|block|inline|hidden)$/,
-        /^(mt|mb|ml|mr|mx|my|pt|pb|pl|pr|px|py)-?\\d*$/,
-        /^(w|h|min|max)-/,
-        /^(text|font|bg|border)-/,
-        /^(rounded|shadow|opacity)-/,
-        /^(hover|focus|active):/,
-        /^(items|justify|gap|space)-/,
-        /^(p|m)-\\d*$/,
-        /^transition/,
-        /^duration/,
-        /^ease/,
-        /^transform/,
-        /^scale|rotate|translate/,
-      ];
-
-      const SEMANTIC_TAGS = new Set([
-        'main', 'nav', 'header', 'footer', 'article', 'section', 'aside', 'form'
-      ]);
-
-      function getSemanticClass(element) {
-        const className = element.getAttribute('class');
-        if (!className) return null;
-        const classes = className.split(/\\s+/).filter(cls => {
-          return !STYLE_CLASS_PATTERNS.some(p => p.test(cls));
-        });
-        if (classes.length === 0) return null;
-        const selectedClasses = classes.slice(0, 2);
-        return selectedClasses.map(cls => 'contains(@class, "' + cls + '")').join(' and ');
-      }
-
-      function getElementIndex(element) {
-        const parent = element.parentElement;
-        if (!parent) return 1;
-        const siblings = Array.from(parent.children).filter(
-          child => child.tagName === element.tagName
-        );
-        return siblings.indexOf(element) + 1;
-      }
-
-      function buildRelativeXPath(element, maxDepth) {
-        const path = [];
-        let current = element;
-        let depth = 0;
-        while (current && depth < maxDepth) {
-          if (current.id) {
-            path.unshift('//*[@id="' + current.id + '"]');
-            break;
-          }
-          const testId = current.getAttribute('data-testid');
-          if (testId) {
-            path.unshift('//*[@data-testid="' + testId + '"]');
-            break;
-          }
-          const tagName = current.tagName.toLowerCase();
-          if (SEMANTIC_TAGS.has(tagName)) {
-            const index = getElementIndex(current);
-            path.unshift('//' + tagName + '[' + index + ']');
-            break;
-          }
-          const index = getElementIndex(current);
-          path.unshift(tagName + '[' + index + ']');
-          current = current.parentElement;
-          depth++;
-        }
-        if (path.length > 0 && !path[0].startsWith('//')) {
-          path.unshift('//');
-        }
-        return path.join('/');
-      }
-
-      function generateXPath(element, maxDepth) {
-        if (element.id) return '//*[@id="' + element.id + '"]';
-        const testId = element.getAttribute('data-testid');
-        if (testId) return '//*[@data-testid="' + testId + '"]';
-        const dataId = element.getAttribute('data-id');
-        if (dataId) return '//*[@data-id="' + dataId + '"]';
-        const semanticClass = getSemanticClass(element);
-        if (semanticClass) return '//' + element.tagName.toLowerCase() + '[' + semanticClass + ']';
-        return buildRelativeXPath(element, maxDepth);
-      }
-
-      function buildElementSelector(element) {
-        const tagName = element.tagName.toLowerCase();
-        const className = element.getAttribute('class');
-        if (className) {
-          const classes = className.split(/\\s+/).filter(cls => {
-            return !STYLE_CLASS_PATTERNS.some(p => p.test(cls));
-          });
-          if (classes.length > 0) {
-            return tagName + '.' + classes.slice(0, 2).join('.');
-          }
-        }
-        const parent = element.parentElement;
-        if (parent) {
-          const index = Array.from(parent.children).indexOf(element) + 1;
-          return tagName + ':nth-child(' + index + ')';
-        }
-        return tagName;
-      }
-
-      function generateCSSPath(element, maxDepth) {
-        if (element.id) return '#' + element.id;
-        const testId = element.getAttribute('data-testid');
-        if (testId) return '[data-testid="' + testId + '"]';
-        const path = [];
-        let current = element;
-        let depth = 0;
-        while (current && depth < maxDepth) {
-          if (current.id) {
-            path.unshift('#' + current.id);
-            break;
-          }
-          const testId = current.getAttribute('data-testid');
-          if (testId) {
-            path.unshift('[data-testid="' + testId + '"]');
-            break;
-          }
-          const tagName = current.tagName.toLowerCase();
-          if (SEMANTIC_TAGS.has(tagName)) {
-            path.unshift(tagName);
-            break;
-          }
-          const selector = buildElementSelector(current);
-          path.unshift(selector);
-          current = current.parentElement;
-          depth++;
-        }
-        return path.join(' > ');
-      }
-
-      function collectAttributes(element) {
-        const attrs = {};
-        for (let i = 0; i < element.attributes.length; i++) {
-          const attr = element.attributes[i];
-          attrs[attr.name] = attr.value;
-        }
-        return attrs;
-      }
-
-      // Map role to implicit tag names
-      const roleToTag = {
-        'heading': ['h1', 'h2', 'h3', 'h4', 'h5', 'h6'],
-        'link': ['a'],
-        'button': ['button', 'input[type="button"]', 'input[type="submit"]'],
-        'textbox': ['input[type="text"]', 'input:not([type])', 'textarea'],
-        'checkbox': ['input[type="checkbox"]'],
-        'radio': ['input[type="radio"]'],
-        'listitem': ['li'],
-        'list': ['ul', 'ol'],
-        'navigation': ['nav'],
-        'main': ['main'],
-        'article': ['article'],
-        'section': ['section'],
-        'form': ['form'],
-      };
-
-      function getImplicitRole(element) {
-        const tag = element.tagName.toLowerCase();
-        const type = element.getAttribute('type');
-
-        // Check explicit role first
-        const explicitRole = element.getAttribute('role');
-        if (explicitRole) return explicitRole.toLowerCase();
-
-        // Check implicit roles
-        if (tag === 'a' && element.hasAttribute('href')) return 'link';
-        if (tag === 'button') return 'button';
-        if (tag === 'input') {
-          if (type === 'button' || type === 'submit' || type === 'reset') return 'button';
-          if (type === 'checkbox') return 'checkbox';
-          if (type === 'radio') return 'radio';
-          if (type === 'file') return 'button'; // file input is rendered as button
-          if (type === 'range') return 'slider';
-          if (type === 'number') return 'spinbutton';
-          if (type === 'date' || type === 'datetime-local' || type === 'month' || type === 'week' || type === 'time') return 'textbox';
-          return 'textbox';
-        }
-        if (tag === 'textarea') return 'textbox';
-        if (tag === 'select') return 'combobox';
-        if (tag === 'img' && element.hasAttribute('alt')) return 'img';
-        if (/^h[1-6]$/.test(tag)) return 'heading';
-        if (tag === 'nav') return 'navigation';
-        if (tag === 'main') return 'main';
-        if (tag === 'article') return 'article';
-        if (tag === 'section') return 'section';
-        if (tag === 'form') return 'form';
-        if (tag === 'ul' || tag === 'ol') return 'list';
-        if (tag === 'li') return 'listitem';
-
-        return null;
-      }
-
-      const results = {};
-      const refEntries = Object.entries(window.__AGENT_BROWSER_REFS__ || {});
-      
-      for (const [ref, data] of refEntries) {
-        const targetRole = data.role;
-        const targetName = data.name;
-        const nth = data.nth;
-
-        // Find matching elements
-        let elements = [];
-        const allElements = document.querySelectorAll('*');
-
-        for (const el of allElements) {
-          const elRole = getImplicitRole(el);
-          if (elRole !== targetRole && targetRole !== 'clickable' && targetRole !== 'focusable') continue;
-
-          // Get accessible name
-          let elName = el.getAttribute('aria-label') ||
-                       el.getAttribute('title') ||
-                       el.getAttribute('alt') || '';
-
-          if (!elName) {
-            // For heading, use text content
-            if (targetRole === 'heading') {
-              elName = el.textContent?.trim() || '';
-            }
-            // For link, use text content
-            else if (targetRole === 'link' || el.tagName.toLowerCase() === 'a') {
-              elName = el.textContent?.trim() || '';
-              // Also check img alt inside link
-              if (!elName) {
-                const img = el.querySelector('img[alt]');
-                if (img) elName = img.getAttribute('alt') || '';
-              }
-            }
-            // For button, use text or value
-            else if (targetRole === 'button') {
-              elName = el.textContent?.trim() || el.getAttribute('value') || '';
-              // Special case for file input - Playwright shows "Choose File" but element has no name
-              if (!elName && el.tagName.toLowerCase() === 'input' && el.getAttribute('type') === 'file') {
-                elName = 'choose file'; // Match Playwright's localized name
-              }
-            }
-            // For textbox, use label or placeholder
-            else if (targetRole === 'textbox') {
-              elName = el.getAttribute('placeholder') || '';
-              const label = el.labels?.[0]?.textContent?.trim();
-              if (label) elName = label;
-            }
-            else {
-              elName = el.textContent?.trim().slice(0, 100) || '';
-            }
-          }
-
-          // Match name
-          if (targetName) {
-            const normalizedElName = elName.toLowerCase().trim();
-            const normalizedTargetName = targetName.toLowerCase().trim();
-            if (normalizedElName !== normalizedTargetName && !normalizedElName.includes(normalizedTargetName)) {
-              continue;
-            }
-          }
-
-          elements.push(el);
-        }
-
-        if (elements.length > 0) {
-          const element = nth !== undefined ? elements[nth] : elements[0];
-          if (element) {
-            results[ref] = {
-              xpath: generateXPath(element, 5),
-              cssPath: generateCSSPath(element, 5),
-              attributes: collectAttributes(element),
-            };
-          }
-        }
-      }
-      
-      return results;
-    }
-  `;
-    const injectScript = `
-    window.__AGENT_BROWSER_REFS__ = ${JSON.stringify(refs)};
-  `;
-    if ('evaluate' in page) {
-        await page.evaluate(injectScript);
-    }
-    // Evaluate the function in the browser context
-    const elementData = await page.evaluate(() => {
-        const STYLE_CLASS_PATTERNS = [
-            /^(flex|grid|block|inline|hidden)$/,
-            /^(mt|mb|ml|mr|mx|my|pt|pb|pl|pr|px|py)-?\d*$/,
-            /^(w|h|min|max)-/,
-            /^(text|font|bg|border)-/,
-            /^(rounded|shadow|opacity)-/,
-            /^(hover|focus|active):/,
-            /^(items|justify|gap|space)-/,
-            /^(p|m)-\d*$/,
-            /^transition/,
-            /^duration/,
-            /^ease/,
-            /^transform/,
-            /^scale|rotate|translate/,
-        ];
-        const SEMANTIC_TAGS = new Set([
-            'main',
-            'nav',
-            'header',
-            'footer',
-            'article',
-            'section',
-            'aside',
-            'form',
-        ]);
-        function getSemanticClass(element) {
-            const className = element.getAttribute('class');
-            if (!className)
-                return null;
-            const classes = className.split(/\s+/).filter((cls) => {
-                return !STYLE_CLASS_PATTERNS.some((p) => p.test(cls));
-            });
-            if (classes.length === 0)
-                return null;
-            const selectedClasses = classes.slice(0, 2);
-            return selectedClasses.map((cls) => 'contains(@class, "' + cls + '")').join(' and ');
-        }
-        function getElementIndex(element) {
-            const parent = element.parentElement;
-            if (!parent)
-                return 1;
-            const siblings = Array.from(parent.children).filter((child) => child.tagName === element.tagName);
-            return siblings.indexOf(element) + 1;
-        }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        function buildRelativeXPath(element, maxDepth) {
-            const path = [];
-            let current = element;
-            let depth = 0;
-            while (current && depth < maxDepth) {
-                if (current.id) {
-                    path.unshift('//*[@id="' + current.id + '"]');
-                    break;
-                }
-                const testId = current.getAttribute('data-testid');
-                if (testId) {
-                    path.unshift('//*[@data-testid="' + testId + '"]');
-                    break;
-                }
-                const tagName = current.tagName.toLowerCase();
-                if (SEMANTIC_TAGS.has(tagName)) {
-                    const index = getElementIndex(current);
-                    path.unshift('//' + tagName + '[' + index + ']');
-                    break;
-                }
-                const index = getElementIndex(current);
-                path.unshift(tagName + '[' + index + ']');
-                current = current.parentElement;
-                depth++;
-            }
-            if (path.length > 0 && !path[0].startsWith('//')) {
-                path.unshift('//');
-            }
-            return path.join('/');
-        }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        function generateXPath(element, maxDepth) {
-            if (element.id)
-                return '//*[@id="' + element.id + '"]';
-            const testId = element.getAttribute('data-testid');
-            if (testId)
-                return '//*[@data-testid="' + testId + '"]';
-            const dataId = element.getAttribute('data-id');
-            if (dataId)
-                return '//*[@data-id="' + dataId + '"]';
-            const semanticClass = getSemanticClass(element);
-            if (semanticClass)
-                return '//' + element.tagName.toLowerCase() + '[' + semanticClass + ']';
-            return buildRelativeXPath(element, maxDepth);
-        }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        function buildElementSelector(element) {
-            const tagName = element.tagName.toLowerCase();
-            const className = element.getAttribute('class');
-            if (className) {
-                const classes = className.split(/\s+/).filter((cls) => {
-                    return !STYLE_CLASS_PATTERNS.some((p) => p.test(cls));
-                });
-                if (classes.length > 0) {
-                    return tagName + '.' + classes.slice(0, 2).join('.');
-                }
-            }
-            const parent = element.parentElement;
-            if (parent) {
-                const index = Array.from(parent.children).indexOf(element) + 1;
-                return tagName + ':nth-child(' + index + ')';
-            }
-            return tagName;
-        }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        function generateCSSPath(element, maxDepth) {
-            if (element.id)
-                return '#' + element.id;
-            const testId = element.getAttribute('data-testid');
-            if (testId)
-                return '[data-testid="' + testId + '"]';
-            const path = [];
-            let current = element;
-            let depth = 0;
-            while (current && depth < maxDepth) {
-                if (current.id) {
-                    path.unshift('#' + current.id);
-                    break;
-                }
-                const testId = current.getAttribute('data-testid');
-                if (testId) {
-                    path.unshift('[data-testid="' + testId + '"]');
-                    break;
-                }
-                const tagName = current.tagName.toLowerCase();
-                if (SEMANTIC_TAGS.has(tagName)) {
-                    path.unshift(tagName);
-                    break;
-                }
-                const selector = buildElementSelector(current);
-                path.unshift(selector);
-                current = current.parentElement;
-                depth++;
-            }
-            return path.join(' > ');
-        }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        function collectAttributes(element) {
-            const attrs = {};
-            for (let i = 0; i < element.attributes.length; i++) {
-                const attr = element.attributes[i];
-                attrs[attr.name] = attr.value;
-            }
-            return attrs;
-        }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        function getImplicitRole(element) {
-            const tag = element.tagName.toLowerCase();
-            const type = element.getAttribute('type');
-            const explicitRole = element.getAttribute('role');
-            if (explicitRole)
-                return explicitRole.toLowerCase();
-            if (tag === 'a' && element.hasAttribute('href'))
-                return 'link';
-            if (tag === 'button')
-                return 'button';
-            if (tag === 'input') {
-                if (type === 'button' || type === 'submit' || type === 'reset')
-                    return 'button';
-                if (type === 'checkbox')
-                    return 'checkbox';
-                if (type === 'radio')
-                    return 'radio';
-                if (type === 'file')
-                    return 'button'; // file input is rendered as button
-                if (type === 'range')
-                    return 'slider';
-                if (type === 'number')
-                    return 'spinbutton';
-                return 'textbox';
-            }
-            if (tag === 'textarea')
-                return 'textbox';
-            if (tag === 'select')
-                return 'combobox';
-            if (tag === 'img' && element.hasAttribute('alt'))
-                return 'img';
-            if (/^h[1-6]$/.test(tag))
-                return 'heading';
-            if (tag === 'nav')
-                return 'navigation';
-            if (tag === 'main')
-                return 'main';
-            if (tag === 'article')
-                return 'article';
-            if (tag === 'section')
-                return 'section';
-            if (tag === 'form')
-                return 'form';
-            if (tag === 'ul' || tag === 'ol')
-                return 'list';
-            if (tag === 'li')
-                return 'listitem';
-            return null;
-        }
-        const results = {};
-        const refEntries = Object.entries(window.__AGENT_BROWSER_REFS__ || {});
-        for (const [ref, data] of refEntries) {
-            const targetRole = data.role;
-            const targetName = data.name;
-            const nth = data.nth;
-            const elements = [];
-            const allElements = Array.from(document.querySelectorAll('*'));
-            for (const el of allElements) {
-                const elRole = getImplicitRole(el);
-                if (elRole !== targetRole && targetRole !== 'clickable' && targetRole !== 'focusable')
-                    continue;
-                let elName = el.getAttribute('aria-label') || el.getAttribute('title') || el.getAttribute('alt') || '';
-                if (!elName) {
-                    if (targetRole === 'heading') {
-                        elName = el.textContent?.trim() || '';
-                    }
-                    else if (targetRole === 'link' || el.tagName.toLowerCase() === 'a') {
-                        elName = el.textContent?.trim() || '';
-                        if (!elName) {
-                            const img = el.querySelector('img[alt]');
-                            if (img)
-                                elName = img.getAttribute('alt') || '';
-                        }
-                    }
-                    else if (targetRole === 'button') {
-                        elName = el.textContent?.trim() || el.getAttribute('value') || '';
-                        // Special case for file input - Playwright shows "Choose File" but element has no name
-                        if (!elName &&
-                            el.tagName.toLowerCase() === 'input' &&
-                            el.getAttribute('type') === 'file') {
-                            elName = 'choose file'; // Match Playwright's localized name
-                        }
-                    }
-                    else if (targetRole === 'textbox') {
-                        elName = el.getAttribute('placeholder') || '';
-                        const label = el.labels?.[0]?.textContent?.trim();
-                        if (label)
-                            elName = label;
-                    }
-                    else {
-                        elName = el.textContent?.trim().slice(0, 100) || '';
-                    }
-                }
-                if (targetName) {
-                    const normalizedElName = elName.toLowerCase().trim();
-                    const normalizedTargetName = targetName.toLowerCase().trim();
-                    if (normalizedElName !== normalizedTargetName &&
-                        !normalizedElName.includes(normalizedTargetName)) {
-                        continue;
-                    }
-                }
-                elements.push(el);
-            }
-            if (elements.length > 0) {
-                const element = nth !== undefined ? elements[nth] : elements[0];
-                if (element) {
-                    results[ref] = {
-                        xpath: generateXPath(element, 5),
-                        cssPath: generateCSSPath(element, 5),
-                        attributes: collectAttributes(element),
-                    };
-                }
-            }
-        }
-        return results;
-    });
-    if (!elementData || typeof elementData !== 'object') {
-        return;
-    }
-    for (const [ref, data] of Object.entries(elementData)) {
-        const typedData = data;
-        if (refs[ref] && data) {
-            if (options.path) {
-                refs[ref].xpath = typedData.xpath;
-                refs[ref].cssPath = typedData.cssPath;
-            }
-            if (options.attrs) {
-                refs[ref].attributes = typedData.attributes;
-            }
-        }
-    }
-}
-function createRoleNameTracker() {
-    const counts = new Map();
-    const refsByKey = new Map();
-    return {
-        counts,
-        refsByKey,
-        getKey(role, name) {
-            return `${role}:${name ?? ''}`;
-        },
-        getNextIndex(role, name) {
-            const key = this.getKey(role, name);
-            const current = counts.get(key) ?? 0;
-            counts.set(key, current + 1);
-            return current;
-        },
-        trackRef(role, name, ref) {
-            const key = this.getKey(role, name);
-            const refs = refsByKey.get(key) ?? [];
-            refs.push(ref);
-            refsByKey.set(key, refs);
-        },
-        getDuplicateKeys() {
-            const duplicates = new Set();
-            for (const [key, refs] of refsByKey) {
-                if (refs.length > 1) {
-                    duplicates.add(key);
-                }
-            }
-            return duplicates;
-        },
-    };
-}
-/**
- * Process ARIA snapshot: add refs and apply filters
- */
-function processAriaTree(ariaTree, refs, options) {
-    const lines = ariaTree.split('\n');
-    const result = [];
-    const tracker = createRoleNameTracker();
-    // For interactive-only mode, we collect just interactive elements
-    if (options.interactive) {
-        for (const line of lines) {
-            const match = line.match(/^(\s*-\s*)(\w+)(?:\s+"([^"]*)")?(.*)$/);
-            if (!match)
-                continue;
-            const [, , role, name, suffix] = match;
-            const roleLower = role.toLowerCase();
-            if (INTERACTIVE_ROLES.has(roleLower)) {
-                const ref = nextRef();
-                const nth = tracker.getNextIndex(roleLower, name);
-                tracker.trackRef(roleLower, name, ref);
-                refs[ref] = {
-                    selector: buildSelector(roleLower, name),
-                    role: roleLower,
-                    name,
-                    nth, // Always store nth, we'll use it for duplicates
-                };
-                let enhanced = `- ${role}`;
-                if (name)
-                    enhanced += ` "${name}"`;
-                enhanced += ` [ref=${ref}]`;
-                // Only show nth in output if it's > 0 (for readability)
-                if (nth > 0)
-                    enhanced += ` [nth=${nth}]`;
-                if (suffix && suffix.includes('['))
-                    enhanced += suffix;
-                result.push(enhanced);
-            }
-        }
-        // Post-process: remove nth from refs that don't have duplicates
-        removeNthFromNonDuplicates(refs, tracker);
-        return result.join('\n') || '(no interactive elements)';
-    }
-    // Normal processing with depth/compact filters
-    for (const line of lines) {
-        const processed = processLine(line, refs, options, tracker);
-        if (processed !== null) {
-            result.push(processed);
-        }
-    }
-    // Post-process: remove nth from refs that don't have duplicates
-    removeNthFromNonDuplicates(refs, tracker);
-    // If compact mode, remove empty structural elements
-    if (options.compact) {
-        return compactTree(result.join('\n'));
-    }
-    return result.join('\n');
-}
-/**
- * Remove nth from refs that ended up not having duplicates
- * This keeps single-element locators simple (no unnecessary .nth(0))
- */
-function removeNthFromNonDuplicates(refs, tracker) {
-    const duplicateKeys = tracker.getDuplicateKeys();
-    for (const [ref, data] of Object.entries(refs)) {
-        const key = tracker.getKey(data.role, data.name);
-        if (!duplicateKeys.has(key)) {
-            // Not a duplicate, remove nth to keep locator simple
-            delete refs[ref].nth;
-        }
-    }
-}
-/**
- * Get indentation level (number of spaces / 2)
- */
-function getIndentLevel(line) {
-    const match = line.match(/^(\s*)/);
-    return match ? Math.floor(match[1].length / 2) : 0;
-}
-/**
- * Process a single line: add ref if needed, filter if requested
- */
-function processLine(line, refs, options, tracker) {
-    const depth = getIndentLevel(line);
-    // Check max depth
-    if (options.maxDepth !== undefined && depth > options.maxDepth) {
-        return null;
-    }
-    // Match lines like:
-    //   - button "Submit"
-    //   - heading "Title" [level=1]
-    //   - link "Click me":
-    const match = line.match(/^(\s*-\s*)(\w+)(?:\s+"([^"]*)")?(.*)$/);
-    if (!match) {
-        // Metadata lines (like /url:) or text content
-        if (options.interactive) {
-            // In interactive mode, only keep metadata under interactive elements
-            return null;
-        }
-        return line;
-    }
-    const [, prefix, role, name, suffix] = match;
-    const roleLower = role.toLowerCase();
-    // Skip metadata lines (like /url:)
-    if (role.startsWith('/')) {
-        return line;
-    }
-    const isInteractive = INTERACTIVE_ROLES.has(roleLower);
-    const isContent = CONTENT_ROLES.has(roleLower);
-    const isStructural = STRUCTURAL_ROLES.has(roleLower);
-    // In interactive-only mode, filter non-interactive elements
-    if (options.interactive && !isInteractive) {
-        return null;
-    }
-    // In compact mode, skip unnamed structural elements
-    if (options.compact && isStructural && !name) {
-        return null;
-    }
-    // Add ref for interactive or named content elements
-    const shouldHaveRef = isInteractive || (isContent && name);
-    if (shouldHaveRef) {
-        const ref = nextRef();
-        const nth = tracker.getNextIndex(roleLower, name);
-        tracker.trackRef(roleLower, name, ref);
-        refs[ref] = {
-            selector: buildSelector(roleLower, name),
-            role: roleLower,
-            name,
-            nth, // Always store nth, we'll clean up non-duplicates later
-        };
-        // Build enhanced line with ref
-        let enhanced = `${prefix}${role}`;
-        if (name)
-            enhanced += ` "${name}"`;
-        enhanced += ` [ref=${ref}]`;
-        // Only show nth in output if it's > 0 (for readability)
-        if (nth > 0)
-            enhanced += ` [nth=${nth}]`;
-        if (suffix)
-            enhanced += suffix;
-        return enhanced;
-    }
-    return line;
-}
-/**
- * Remove empty structural branches in compact mode
- */
-function compactTree(tree) {
-    const lines = tree.split('\n');
-    const result = [];
-    // Simple pass: keep lines that have content or refs
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        // Always keep lines with refs
-        if (line.includes('[ref=')) {
-            result.push(line);
-            continue;
-        }
-        // Keep lines with text content (after :)
-        if (line.includes(':') && !line.endsWith(':')) {
-            result.push(line);
-            continue;
-        }
-        // Check if this structural element has children with refs
-        const currentIndent = getIndentLevel(line);
-        let hasRelevantChildren = false;
-        for (let j = i + 1; j < lines.length; j++) {
-            const childIndent = getIndentLevel(lines[j]);
-            if (childIndent <= currentIndent)
-                break;
-            if (lines[j].includes('[ref=')) {
-                hasRelevantChildren = true;
-                break;
-            }
-        }
-        if (hasRelevantChildren) {
-            result.push(line);
-        }
-    }
-    return result.join('\n');
-}
-/**
- * Parse a ref from command argument (e.g., "@e1" -> "e1")
- */
-export function parseRef(arg) {
-    if (arg.startsWith('@')) {
-        return arg.slice(1);
-    }
-    if (arg.startsWith('[ref=') && arg.endsWith(']')) {
-        return arg.slice(5, -1);
-    }
-    if (arg.startsWith('ref=')) {
-        return arg.slice(4);
-    }
-    if (/^e\d+$/.test(arg)) {
-        return arg;
-    }
-    return null;
-}
-/**
- * Get snapshot statistics
- */
-export function getSnapshotStats(tree, refs) {
-    const interactive = Object.values(refs).filter((r) => INTERACTIVE_ROLES.has(r.role)).length;
-    return {
-        lines: tree.split('\n').length,
-        chars: tree.length,
-        tokens: Math.ceil(tree.length / 4),
-        refs: Object.keys(refs).length,
-        interactive,
-    };
-}
-const STYLE_CLASS_PATTERNS = [
-    /^(flex|grid|block|inline|hidden)$/,
-    /^(mt|mb|ml|mr|mx|my|pt|pb|pl|pr|px|py)-?\d*$/,
-    /^(w|h|min|max)-/,
-    /^(text|font|bg|border)-/,
-    /^(rounded|shadow|opacity)-/,
-    /^(hover|focus|active):/,
-    /^(items|justify|gap|space)-/,
-    /^(p|m)-\d*$/,
-    /^transition/,
-    /^duration/,
-    /^ease/,
-    /^transform/,
-    /^scale|rotate|translate/,
-];
-const SEMANTIC_TAGS = new Set([
-    'main',
-    'nav',
-    'header',
-    'footer',
-    'article',
-    'section',
-    'aside',
-    'form',
-]);
-export function getSemanticClass(element) {
-    const className = element.getAttribute('class');
-    if (!className)
-        return null;
-    const classes = className.split(/\s+/).filter((cls) => {
-        return !STYLE_CLASS_PATTERNS.some((p) => p.test(cls));
-    });
-    if (classes.length === 0)
-        return null;
-    const selectedClasses = classes.slice(0, 2);
-    return selectedClasses.map((cls) => `contains(@class, "${cls}")`).join(' and ');
-}
-export function generateXPath(element, maxDepth = 5) {
-    const elemId = element.id;
-    if (elemId) {
-        return `//*[@id="${elemId}"]`;
-    }
-    const testId = element.getAttribute('data-testid');
-    if (testId) {
-        return `//*[@data-testid="${testId}"]`;
-    }
-    const dataId = element.getAttribute('data-id');
-    if (dataId) {
-        return `//*[@data-id="${dataId}"]`;
-    }
-    const semanticClass = getSemanticClass(element);
-    if (semanticClass) {
-        return `//${element.tagName.toLowerCase()}[${semanticClass}]`;
-    }
-    return buildRelativeXPath(element, maxDepth);
-}
-function buildRelativeXPath(element, maxDepth) {
-    const path = [];
-    let current = element;
-    let depth = 0;
-    while (current && depth < maxDepth) {
-        const currentId = current.id;
-        if (currentId) {
-            path.unshift(`//*[@id="${currentId}"]`);
-            break;
-        }
-        const testId = current.getAttribute('data-testid');
-        if (testId) {
-            path.unshift(`//*[@data-testid="${testId}"]`);
-            break;
-        }
-        const tagName = current.tagName.toLowerCase();
-        if (SEMANTIC_TAGS.has(tagName)) {
-            const index = getElementIndex(current);
-            path.unshift(`//${tagName}[${index}]`);
-            break;
-        }
-        const index = getElementIndex(current);
-        path.unshift(`${tagName}[${index}]`);
-        current = current.parentElement;
-        depth++;
-    }
-    if (path.length > 0 && !path[0].startsWith('//')) {
-        path.unshift('//');
-    }
-    return path.join('/');
-}
-function getElementIndex(element) {
-    const parent = element.parentElement;
-    if (!parent)
-        return 1;
-    const siblings = Array.from(parent.children).filter((child) => child.tagName === element.tagName);
-    return siblings.indexOf(element) + 1;
-}
-export function generateCSSPath(element, maxDepth = 5) {
-    const elemId = element.id;
-    if (elemId) {
-        return `#${elemId}`;
-    }
-    const testId = element.getAttribute('data-testid');
-    if (testId) {
-        return `[data-testid="${testId}"]`;
-    }
-    const path = [];
-    let current = element;
-    let depth = 0;
-    while (current && depth < maxDepth) {
-        const currentId = current.id;
-        if (currentId) {
-            path.unshift(`#${currentId}`);
-            break;
-        }
-        const testId = current.getAttribute('data-testid');
-        if (testId) {
-            path.unshift(`[data-testid="${testId}"]`);
-            break;
-        }
-        const tagName = current.tagName.toLowerCase();
-        if (SEMANTIC_TAGS.has(tagName)) {
-            path.unshift(tagName);
-            break;
-        }
-        const selector = buildElementSelector(current);
-        path.unshift(selector);
-        current = current.parentElement;
-        depth++;
-    }
-    return path.join(' > ');
-}
-function buildElementSelector(element) {
-    const tagName = element.tagName.toLowerCase();
-    const className = element.getAttribute('class');
-    if (className) {
-        const classes = className.split(/\s+/).filter((cls) => {
-            return !STYLE_CLASS_PATTERNS.some((p) => p.test(cls));
-        });
-        if (classes.length > 0) {
-            return `${tagName}.${classes.slice(0, 2).join('.')}`;
-        }
-    }
-    const parent = element.parentElement;
-    if (parent) {
-        const index = Array.from(parent.children).indexOf(element) + 1;
-        return `${tagName}:nth-child(${index})`;
-    }
-    return tagName;
-}
-export function collectAttributes(element) {
-    const attrs = {};
-    for (let i = 0; i < element.attributes.length; i++) {
-        const attr = element.attributes[i];
-        attrs[attr.name] = attr.value;
-    }
-    return attrs;
-}
+export * from './snapshot/index.js';
 //# sourceMappingURL=snapshot.js.map