browser-debugger-cli 0.6.5 → 0.6.7

package/dist/commands/dom/index.js

@@ -1,14 +1,16 @@
+import { DomElementResolver } from '../../commands/dom/DomElementResolver.js';
 import { registerA11yCommands } from '../../commands/dom/a11y.js';
-import { queryDOMElements, getDOMElements, capturePageScreenshot } from '../../commands/dom/helpers.js';
+import { queryDOMElements, getDOMElements, capturePageScreenshot, getDomContext, } from '../../commands/dom/helpers.js';
 import { runCommand } from '../../commands/shared/CommandRunner.js';
+import { positiveIntRule } from '../../commands/shared/validation.js';
+import { QueryCacheManager } from '../../session/QueryCacheManager.js';
 import { resolveA11yNode } from '../../telemetry/a11y.js';
+import { synthesizeA11yNode } from '../../telemetry/roleInference.js';
 import { CommandError } from '../../ui/errors/index.js';
 import { formatDomQuery, formatDomGet, formatDomEval, formatDomScreenshot, } from '../../ui/formatters/dom.js';
-import { semantic } from '../../ui/formatters/semantic.js';
 import { elementNotFoundError } from '../../ui/messages/errors.js';
 import { EXIT_CODES } from '../../utils/exitCodes.js';
 import { filterDefined } from '../../utils/objects.js';
-import { parsePositiveIntOption } from '../../utils/validation.js';
 /**
  * Handle bdg dom query <selector> command
  *
@@ -22,37 +24,16 @@ import { parsePositiveIntOption } from '../../utils/validation.js';
 async function handleDomQuery(selector, options) {
     await runCommand(async () => {
         const result = await queryDOMElements(selector);
-        const { setSessionQueryCache } = await import('../../session/queryCache.js');
-        setSessionQueryCache(result);
+        const cacheManager = QueryCacheManager.getInstance();
+        const navigationId = await cacheManager.getCurrentNavigationId();
+        const resultWithNavId = {
+            ...result,
+            ...(navigationId !== null && { navigationId }),
+        };
+        await cacheManager.set(resultWithNavId);
         return { success: true, data: result };
     }, options, formatDomQuery);
 }
-/**
- * Retrieve cached node by index with validation.
- *
- * @param index - Zero-based index from query results
- * @returns Node from cache
- * @throws CommandError if cache missing, index out of range, or node not found
- */
-async function getCachedNodeByIndex(index) {
-    const { getSessionQueryCache } = await import('../../session/queryCache.js');
-    const cachedQuery = getSessionQueryCache();
-    if (!cachedQuery) {
-        throw new CommandError('No cached query results found', {
-            suggestion: 'Run "bdg dom query <selector>" first to generate indexed results',
-        }, EXIT_CODES.INVALID_ARGUMENTS);
-    }
-    if (index < 0 || index >= cachedQuery.nodes.length) {
-        throw new CommandError(`Index ${index} out of range (found ${cachedQuery.nodes.length} elements)`, {
-            suggestion: `Use an index between 0 and ${cachedQuery.nodes.length - 1}`,
-        }, EXIT_CODES.INVALID_ARGUMENTS);
-    }
-    const targetNode = cachedQuery.nodes[index];
-    if (!targetNode) {
-        throw new CommandError(`Element at index ${index} not found`, {}, EXIT_CODES.RESOURCE_NOT_FOUND);
-    }
-    return targetNode;
-}
 /**
  * Handle bdg dom get command
  *
@@ -76,9 +57,10 @@ async function handleDomGet(selectorOrIndex, options) {
  * Handle get command with numeric index
  */
 async function handleIndexGet(index, options) {
+    const resolver = DomElementResolver.getInstance();
     if (options.raw) {
         await runCommand(async () => {
-            const targetNode = await getCachedNodeByIndex(index);
+            const targetNode = await resolver.getNodeIdForIndex(index);
             const getOptions = filterDefined({
                 nodeId: targetNode.nodeId,
             });
@@ -88,13 +70,18 @@ async function handleIndexGet(index, options) {
     }
     else {
         await runCommand(async () => {
-            const targetNode = await getCachedNodeByIndex(index);
-            const node = await resolveA11yNode('', targetNode.nodeId);
+            const targetNode = await resolver.getNodeIdForIndex(index);
+            const [a11yNode, domContext] = await Promise.all([
+                resolveA11yNode('', targetNode.nodeId),
+                getDomContext(targetNode.nodeId),
+            ]);
+            // Graceful degradation: synthesize node from DOM context when a11y unavailable
+            const node = a11yNode ?? (domContext ? synthesizeA11yNode(domContext, targetNode.nodeId) : null);
             if (!node) {
                 throw new CommandError(elementNotFoundError(`index ${index}`), {}, EXIT_CODES.RESOURCE_NOT_FOUND);
             }
-            return { success: true, data: node };
-        }, options, formatSemanticNode);
+            return { success: true, data: { node, domContext } };
+        }, options, formatSemanticNodeWithContext);
     }
 }
 /**
@@ -115,24 +102,93 @@ async function handleSelectorGet(selector, options) {
     }
     else {
         await runCommand(async () => {
-            const node = await resolveA11yNode(selector);
+            const a11yNode = await resolveA11yNode(selector);
+            // Fetch DOM context for enrichment or fallback
+            let domContext = null;
+            let nodeId;
+            if (a11yNode?.backendDOMNodeId) {
+                nodeId = a11yNode.backendDOMNodeId;
+                domContext = await getDomContext(nodeId);
+            }
+            else if (!a11yNode) {
+                // Try to get DOM context by querying the selector directly
+                const { callCDP } = await import('../../ipc/client.js');
+                const docResponse = await callCDP('DOM.getDocument', {});
+                const doc = docResponse.data?.result;
+                if (doc?.root?.nodeId) {
+                    const queryResponse = await callCDP('DOM.querySelector', {
+                        nodeId: doc.root.nodeId,
+                        selector,
+                    });
+                    const queryResult = queryResponse.data?.result;
+                    if (queryResult?.nodeId) {
+                        nodeId = queryResult.nodeId;
+                        domContext = await getDomContext(nodeId);
+                    }
+                }
+            }
+            // Graceful degradation: synthesize node from DOM context when a11y unavailable
+            const node = a11yNode ?? (domContext && nodeId ? synthesizeA11yNode(domContext, nodeId) : null);
             if (!node) {
                 throw new CommandError(elementNotFoundError(selector), {}, EXIT_CODES.RESOURCE_NOT_FOUND);
             }
-            return { success: true, data: node };
-        }, options, formatSemanticNode);
+            return { success: true, data: { node, domContext } };
+        }, options, formatSemanticNodeWithContext);
     }
 }
 /**
- * Formatter for single semantic node
+ * Formatter for single semantic node with DOM context fallback.
+ *
+ * When a11y name is missing, shows DOM context (tag, classes, text preview)
+ * to provide useful information instead of just "[Role]".
+ * Shows "(inferred from DOM)" indicator when node is synthesized.
  */
-function formatSemanticNode(node) {
-    const fakeTree = {
-        root: node,
-        nodes: new Map([[node.nodeId, node]]),
-        count: 1,
-    };
-    return semantic(fakeTree);
+function formatSemanticNodeWithContext(data) {
+    const { node, domContext } = data;
+    // Build the role text
+    let roleText = `[${capitalize(node.role)}]`;
+    if (node.role.toLowerCase() === 'heading' && node.properties?.['level'] !== undefined) {
+        const level = node.properties['level'];
+        const levelNum = typeof level === 'number' ? level : Number(level);
+        if (!isNaN(levelNum)) {
+            roleText = `[Heading L${levelNum}]`;
+        }
+    }
+    // Build the name/context text
+    let contextText = '';
+    if (node.name) {
+        // Use a11y name when available
+        contextText = ` "${node.name}"`;
+    }
+    else if (domContext) {
+        // Fallback to DOM context when a11y name is missing
+        const tagPart = `<${domContext.tag}`;
+        const classPart = domContext.classes && domContext.classes.length > 0
+            ? `.${domContext.classes.slice(0, 3).join('.')}`
+            : '';
+        const previewPart = domContext.preview ? ` "${domContext.preview}"` : '';
+        contextText = ` ${tagPart}${classPart}>${previewPart}`;
+    }
+    // Build properties text
+    const props = [];
+    if (node.focusable)
+        props.push('focusable');
+    if (node.focused)
+        props.push('focused');
+    if (node.disabled)
+        props.push('disabled');
+    if (node.required)
+        props.push('required');
+    const propsText = props.length > 0 ? ` (${props.join(', ')})` : '';
+    // Add inferred indicator when node is synthesized from DOM
+    const inferredText = node.inferred ? ' (inferred from DOM)' : '';
+    return `${roleText}${contextText}${propsText}${inferredText}`;
+}
+/**
+ * Capitalize first letter of string.
+ */
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
 }
 /**
  * Handle bdg dom screenshot <path> command
@@ -171,11 +227,8 @@ async function handleDomEval(script, options) {
         const { validateActiveSession, getValidatedSessionMetadata, verifyTargetExists, executeScript, } = await import('../../commands/dom/evalHelpers.js');
         validateActiveSession();
         const metadata = getValidatedSessionMetadata();
-        const port = parsePositiveIntOption('port', options.port, {
-            defaultValue: 9222,
-            min: 1,
-            max: 65535,
-        });
+        const portRule = positiveIntRule({ min: 1, max: 65535, default: 9222 });
+        const port = portRule.validate(options.port);
         await verifyTargetExists(metadata, port);
         const cdp = new CDPConnection();
         // eslint-disable-next-line @typescript-eslint/no-non-null-assertion

package/dist/commands/dom/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/dom/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/dom/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,aAAa,GACd,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAOhE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EACL,cAAc,EACd,YAAY,EACZ,aAAa,EACb,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;GASG;AACH,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,OAA+B;IAC7E,MAAM,UAAU,CACd,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAEhD,MAAM,YAAY,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC;QACrD,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,sBAAsB,EAAE,CAAC;QACjE,MAAM,eAAe,GAAG;YACtB,GAAG,MAAM;YACT,GAAG,CAAC,YAAY,KAAK,IAAI,IAAI,EAAE,YAAY,EAAE,CAAC;SAC/C,CAAC;QACF,MAAM,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAExC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACzC,CAAC,EACD,OAAO,EACP,cAAc,CACf,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,YAAY,CAAC,eAAuB,EAAE,OAA6B;IAChF,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAErD,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,cAAc,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACN,MAAM,iBAAiB,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,cAAc,CAAC,KAAa,EAAE,OAA6B;IACxE,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,EAAE,CAAC;IAElD,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,MAAM,UAAU,CACd,KAAK,IAAI,EAAE;YACT,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC3D,MAAM,UAAU,GAAG,aAAa,CAAC;gBAC/B,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAwB,CAAC;YAE1B,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;YAChD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACzC,CAAC,EACD,OAAO,EACP,YAAY,CACb,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,CACd,KAAK,IAAI,EAAE;YACT,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC3D,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC/C,eAAe,CAAC,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC;gBACtC,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC;aACjC,CAAC,CAAC;YAEH,+EAA+E;YAC/E,MAAM,IAAI,GACR,QAAQ,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAEtF,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,YAAY,CACpB,oBAAoB,CAAC,SAAS,KAAK,EAAE,CAAC,EACtC,EAAE,EACF,UAAU,CAAC,kBAAkB,CAC9B,CAAC;YACJ,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC;QACvD,CAAC,EACD,OAAO,EACP,6BAA6B,CAC9B,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAAC,QAAgB,EAAE,OAA6B;IAC9E,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,MAAM,UAAU,CACd,KAAK,IAAI,EAAE;YACT,MAAM,UAAU,GAAG,aAAa,CAAC;gBAC/B,QAAQ;gBACR,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAwB,CAAC;YAE1B,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;YAChD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACzC,CAAC,EACD,OAAO,EACP,YAAY,CACb,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,CACd,KAAK,IAAI,EAAE;YACT,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;YAEjD,+CAA+C;YAC/C,IAAI,UAAU,GAAsB,IAAI,CAAC;YACzC,IAAI,MAA0B,CAAC;YAE/B,IAAI,QAAQ,EAAE,gBAAgB,EAAE,CAAC;gBAC/B,MAAM,GAAG,QAAQ,CAAC,gBAAgB,CAAC;gBACnC,UAAU,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;iBAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACrB,2DAA2D;gBAC3D,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;gBACpD,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;gBACzD,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,EAAE,MAAoD,CAAC;gBACnF,IAAI,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;oBACtB,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,mBAAmB,EAAE;wBACvD,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM;wBACvB,QAAQ;qBACT,CAAC,CAAC;oBACH,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,EAAE,MAAyC,CAAC;oBAClF,IAAI,WAAW,EAAE,MAAM,EAAE,CAAC;wBACxB,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;wBAC5B,UAAU,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;oBAC3C,CAAC;gBACH,CAAC;YACH,CAAC;YAED,+EAA+E;YAC/E,MAAM,IAAI,GACR,QAAQ,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAErF,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,YAAY,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC;YAC5F,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC;QACvD,CAAC,EACD,OAAO,EACP,6BAA6B,CAC9B,CAAC;IACJ,CAAC;AACH,CAAC;AAUD;;;;;;GAMG;AACH,SAAS,6BAA6B,CAAC,IAA6B;IAClE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAElC,sBAAsB;IACtB,IAAI,QAAQ,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC5C,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;QACtF,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrB,QAAQ,GAAG,aAAa,QAAQ,GAAG,CAAC;QACtC,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,+BAA+B;QAC/B,WAAW,GAAG,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC;IAClC,CAAC;SAAM,IAAI,UAAU,EAAE,CAAC;QACtB,oDAAoD;QACpD,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,GAAG,EAAE,CAAC;QACrC,MAAM,SAAS,GACb,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YACjD,CAAC,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YAChD,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,WAAW,GAAG,IAAI,OAAO,GAAG,SAAS,IAAI,WAAW,EAAE,CAAC;IACzD,CAAC;IAED,wBAAwB;IACxB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5C,IAAI,IAAI,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,IAAI,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAEnE,2DAA2D;IAC3D,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjE,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,EAAE,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,mBAAmB,CAChC,IAAY,EACZ,OAAoC;IAEpC,MAAM,UAAU,CACd,KAAK,IAAI,EAAE;QACT,MAAM,iBAAiB,GAAG,aAAa,CAAC;YACtC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAsE,CAAC;QAExE,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;QACpE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACzC,CAAC,EACD,OAAO,EACP,mBAAmB,CACpB,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,OAA8B;IACzE,MAAM,UAAU,CACd,KAAK,IAAI,EAAE;QACT,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAC9D,MAAM,EACJ,qBAAqB,EACrB,2BAA2B,EAC3B,kBAAkB,EAClB,aAAa,GACd,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;QAElD,qBAAqB,EAAE,CAAC;QAExB,MAAM,QAAQ,GAAG,2BAA2B,EAAE,CAAC;QAE/C,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAEzC,MAAM,GAAG,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,oEAAoE;QACpE,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAqB,CAAC,CAAC;QAElD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAChD,GAAG,CAAC,KAAK,EAAE,CAAC;QAEZ,OAAO;YACL,OAAO,EAAE,IAAI;YACb,mEAAmE;YACnE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE;SACvC,CAAC;IACJ,CAAC,EACD,OAAO,EACP,aAAa,CACd,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,iCAAiC,CAAC,CAAC;IAElF,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAE1B,GAAG;SACA,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,+BAA+B,CAAC;SAC5C,QAAQ,CAAC,YAAY,EAAE,iDAAiD,CAAC;SACzE,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC;SACtC,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,OAA+B,EAAE,EAAE;QAClE,MAAM,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,oDAAoD,CAAC;SACjE,QAAQ,CAAC,UAAU,EAAE,wEAAwE,CAAC;SAC9F,MAAM,CAAC,qBAAqB,EAAE,uCAAuC,CAAC;SACtE,MAAM,CAAC,YAAY,EAAE,uCAAuC,CAAC;SAC7D,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,OAA8B,EAAE,EAAE;QAC/D,MAAM,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,oEAAoE,CAAC;SACjF,QAAQ,CAAC,YAAY,EAAE,iDAAiD,CAAC;SACzE,MAAM,CAAC,OAAO,EAAE,4CAA4C,CAAC;SAC7D,MAAM,CAAC,OAAO,EAAE,mCAAmC,CAAC;SACpD,MAAM,CAAC,WAAW,EAAE,iCAAiC,EAAE,QAAQ,CAAC;SAChE,MAAM,CAAC,gBAAgB,EAAE,uCAAuC,EAAE,QAAQ,CAAC;SAC3E,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC;SACtC,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,OAA6B,EAAE,EAAE;QAChE,MAAM,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,yBAAyB,CAAC;SACtC,QAAQ,CAAC,QAAQ,EAAE,6CAA6C,CAAC;SACjE,MAAM,CAAC,mBAAmB,EAAE,0CAA0C,CAAC;SACvE,MAAM,CAAC,oBAAoB,EAAE,kCAAkC,EAAE,QAAQ,CAAC;SAC1E,MAAM,CAAC,gBAAgB,EAAE,4CAA4C,CAAC;SACtE,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC;SACtC,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,OAAoC,EAAE,EAAE;QACnE,MAAM,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/dom/keyMapping.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Key name to CDP key event parameters mapping.
+ *
+ * Maps human-readable key names to Chrome DevTools Protocol Input.dispatchKeyEvent parameters.
+ */
+/**
+ * CDP key event parameters for a specific key.
+ */
+export interface KeyDefinition {
+    /** Physical key code (e.g., "Enter", "KeyA") */
+    code: string;
+    /** Logical key value (e.g., "Enter", "a") */
+    key: string;
+    /** Windows virtual key code */
+    keyCode: number;
+}
+/**
+ * Modifier key bit flags for CDP Input.dispatchKeyEvent.
+ */
+export declare const MODIFIER_FLAGS: {
+    readonly shift: 1;
+    readonly ctrl: 2;
+    readonly alt: 4;
+    readonly meta: 8;
+};
+/**
+ * Get key definition by name (case-insensitive).
+ *
+ * @param keyName - Human-readable key name (e.g., "Enter", "Tab", "a")
+ * @returns Key definition or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const def = getKeyDefinition('Enter');
+ * // { code: 'Enter', key: 'Enter', keyCode: 13 }
+ *
+ * const letterDef = getKeyDefinition('a');
+ * // { code: 'KeyA', key: 'a', keyCode: 65 }
+ * ```
+ */
+export declare function getKeyDefinition(keyName: string): KeyDefinition | undefined;
+/**
+ * Parse modifier string into CDP modifier flags.
+ *
+ * @param modifiers - Comma-separated modifier names (e.g., "ctrl,shift")
+ * @returns Combined modifier bit flags
+ *
+ * @example
+ * ```typescript
+ * parseModifiers('ctrl,shift'); // Returns 3 (1 + 2)
+ * parseModifiers('alt');        // Returns 4
+ * parseModifiers('');           // Returns 0
+ * ```
+ */
+export declare function parseModifiers(modifiers: string | undefined): number;
+//# sourceMappingURL=keyMapping.d.ts.map

package/dist/commands/dom/keyMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyMapping.d.ts","sourceRoot":"","sources":["../../../src/commands/dom/keyMapping.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AA0DX;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE3E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAgBpE"}

package/dist/commands/dom/keyMapping.js

@@ -0,0 +1,110 @@
+/**
+ * Key name to CDP key event parameters mapping.
+ *
+ * Maps human-readable key names to Chrome DevTools Protocol Input.dispatchKeyEvent parameters.
+ */
+/**
+ * Modifier key bit flags for CDP Input.dispatchKeyEvent.
+ */
+export const MODIFIER_FLAGS = {
+    shift: 1,
+    ctrl: 2,
+    alt: 4,
+    meta: 8,
+};
+/**
+ * Map of supported key names to their CDP parameters.
+ *
+ * Keys are case-insensitive for user convenience.
+ */
+const KEY_DEFINITIONS = {
+    enter: { code: 'Enter', key: 'Enter', keyCode: 13 },
+    tab: { code: 'Tab', key: 'Tab', keyCode: 9 },
+    escape: { code: 'Escape', key: 'Escape', keyCode: 27 },
+    space: { code: 'Space', key: ' ', keyCode: 32 },
+    backspace: { code: 'Backspace', key: 'Backspace', keyCode: 8 },
+    delete: { code: 'Delete', key: 'Delete', keyCode: 46 },
+    arrowup: { code: 'ArrowUp', key: 'ArrowUp', keyCode: 38 },
+    arrowdown: { code: 'ArrowDown', key: 'ArrowDown', keyCode: 40 },
+    arrowleft: { code: 'ArrowLeft', key: 'ArrowLeft', keyCode: 37 },
+    arrowright: { code: 'ArrowRight', key: 'ArrowRight', keyCode: 39 },
+    home: { code: 'Home', key: 'Home', keyCode: 36 },
+    end: { code: 'End', key: 'End', keyCode: 35 },
+    pageup: { code: 'PageUp', key: 'PageUp', keyCode: 33 },
+    pagedown: { code: 'PageDown', key: 'PageDown', keyCode: 34 },
+    f1: { code: 'F1', key: 'F1', keyCode: 112 },
+    f2: { code: 'F2', key: 'F2', keyCode: 113 },
+    f3: { code: 'F3', key: 'F3', keyCode: 114 },
+    f4: { code: 'F4', key: 'F4', keyCode: 115 },
+    f5: { code: 'F5', key: 'F5', keyCode: 116 },
+    f6: { code: 'F6', key: 'F6', keyCode: 117 },
+    f7: { code: 'F7', key: 'F7', keyCode: 118 },
+    f8: { code: 'F8', key: 'F8', keyCode: 119 },
+    f9: { code: 'F9', key: 'F9', keyCode: 120 },
+    f10: { code: 'F10', key: 'F10', keyCode: 121 },
+    f11: { code: 'F11', key: 'F11', keyCode: 122 },
+    f12: { code: 'F12', key: 'F12', keyCode: 123 },
+};
+for (let i = 0; i < 26; i++) {
+    const letter = String.fromCharCode(97 + i); // 'a' = 97
+    const upperLetter = letter.toUpperCase();
+    KEY_DEFINITIONS[letter] = {
+        code: `Key${upperLetter}`,
+        key: letter,
+        keyCode: 65 + i, // 'A' = 65
+    };
+}
+for (let i = 0; i < 10; i++) {
+    const digit = String(i);
+    KEY_DEFINITIONS[digit] = {
+        code: `Digit${digit}`,
+        key: digit,
+        keyCode: 48 + i, // '0' = 48
+    };
+}
+/**
+ * Get key definition by name (case-insensitive).
+ *
+ * @param keyName - Human-readable key name (e.g., "Enter", "Tab", "a")
+ * @returns Key definition or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const def = getKeyDefinition('Enter');
+ * // { code: 'Enter', key: 'Enter', keyCode: 13 }
+ *
+ * const letterDef = getKeyDefinition('a');
+ * // { code: 'KeyA', key: 'a', keyCode: 65 }
+ * ```
+ */
+export function getKeyDefinition(keyName) {
+    return KEY_DEFINITIONS[keyName.toLowerCase()];
+}
+/**
+ * Parse modifier string into CDP modifier flags.
+ *
+ * @param modifiers - Comma-separated modifier names (e.g., "ctrl,shift")
+ * @returns Combined modifier bit flags
+ *
+ * @example
+ * ```typescript
+ * parseModifiers('ctrl,shift'); // Returns 3 (1 + 2)
+ * parseModifiers('alt');        // Returns 4
+ * parseModifiers('');           // Returns 0
+ * ```
+ */
+export function parseModifiers(modifiers) {
+    if (!modifiers) {
+        return 0;
+    }
+    let flags = 0;
+    const parts = modifiers.toLowerCase().split(',');
+    for (const part of parts) {
+        const trimmed = part.trim();
+        if (trimmed in MODIFIER_FLAGS) {
+            flags |= MODIFIER_FLAGS[trimmed];
+        }
+    }
+    return flags;
+}
+//# sourceMappingURL=keyMapping.js.map

package/dist/commands/dom/keyMapping.js.map

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

package/dist/commands/dom/reactEventHelpers.d.ts

@@ -16,22 +16,16 @@
  * @remarks
  * Works with React, Vue, Angular, and vanilla JS applications.
  */
-export declare const REACT_FILL_SCRIPT = "\n(function(selector, value, options) {\n  const el = document.querySelector(selector);\n  \n  if (!el) {\n    return { \n      success: false, \n      error: 'Element not found',\n      selector: selector\n    };\n  }\n  \n  const tagName = el.tagName.toLowerCase();\n  const inputType = el.type?.toLowerCase();\n  \n  const isFillable = (\n    tagName === 'input' || \n    tagName === 'textarea' || \n    tagName === 'select' ||\n    el.isContentEditable\n  );\n  \n  if (!isFillable) {\n    return {\n      success: false,\n      error: 'Element is not fillable',\n      elementType: tagName,\n      suggestion: 'Only input, textarea, select, and contenteditable elements can be filled'\n    };\n  }\n  \n  el.focus();\n  \n  if (tagName === 'select') {\n    el.value = value;\n    el.dispatchEvent(new Event('change', { bubbles: true }));\n  } else if (inputType === 'checkbox' || inputType === 'radio') {\n    const shouldCheck = value === 'true' || value === true;\n    el.checked = shouldCheck;\n    el.dispatchEvent(new Event('change', { bubbles: true }));\n  } else if (inputType === 'file') {\n    return {\n      success: false,\n      error: 'File inputs require CDP DOM.setFileInputFiles method',\n      suggestion: 'Use: bdg cdp DOM.setFileInputFiles --params {\\\"files\\\":[\\\"path\\\"]}'\n    };\n  } else if (el.isContentEditable) {\n    el.textContent = value;\n    el.dispatchEvent(new Event('input', { bubbles: true }));\n  } else {\n    const nativeInputValueSetter = Object.getOwnPropertyDescriptor(\n      window.HTMLInputElement.prototype,\n      'value'\n    )?.set;\n    \n    const nativeTextAreaValueSetter = Object.getOwnPropertyDescriptor(\n      window.HTMLTextAreaElement.prototype,\n      'value'\n    )?.set;\n    \n    const setter = tagName === 'textarea' \n      ? nativeTextAreaValueSetter \n      : nativeInputValueSetter;\n    \n    if (setter) {\n      setter.call(el, value);\n    } else {\n      el.value = value;\n    }\n    \n    el.dispatchEvent(new Event('input', { bubbles: true }));\n    el.dispatchEvent(new Event('change', { bubbles: true }));\n  }\n  \n  if (options.blur !== false) {\n    el.blur();\n    el.dispatchEvent(new FocusEvent('focusout', { bubbles: true }));\n  }\n  \n  return {\n    success: true,\n    selector: selector,\n    value: el.value || el.textContent,\n    elementType: tagName,\n    inputType: inputType || null,\n    checked: el.checked || undefined\n  };\n})\n";
+export declare const REACT_FILL_SCRIPT = "\n(function(selector, value, options) {\n  const allMatches = document.querySelectorAll(selector);\n  \n  if (allMatches.length === 0) {\n    return { \n      success: false, \n      error: 'Element not found',\n      selector: selector\n    };\n  }\n  \n  let el;\n  const index = options.index;\n  \n  // If index is provided, use it directly (1-based)\n  if (typeof index === 'number' && index > 0) {\n    if (index > allMatches.length) {\n      return {\n        success: false,\n        error: 'Index out of range',\n        selector: selector,\n        matchCount: allMatches.length,\n        requestedIndex: index,\n        suggestion: 'Use --index between 1 and ' + allMatches.length\n      };\n    }\n    el = allMatches[index - 1];\n  } else {\n    el = allMatches[0];\n  }\n  \n  const tagName = el.tagName.toLowerCase();\n  const inputType = el.type?.toLowerCase();\n  \n  const isFillable = (\n    tagName === 'input' || \n    tagName === 'textarea' || \n    tagName === 'select' ||\n    el.isContentEditable\n  );\n  \n  if (!isFillable) {\n    return {\n      success: false,\n      error: 'Element is not fillable',\n      elementType: tagName,\n      suggestion: 'Only input, textarea, select, and contenteditable elements can be filled'\n    };\n  }\n  \n  el.focus();\n  \n  if (tagName === 'select') {\n    el.value = value;\n    el.dispatchEvent(new Event('change', { bubbles: true }));\n  } else if (inputType === 'checkbox' || inputType === 'radio') {\n    const shouldCheck = value === 'true' || value === true;\n    el.checked = shouldCheck;\n    el.dispatchEvent(new Event('change', { bubbles: true }));\n  } else if (inputType === 'file') {\n    return {\n      success: false,\n      error: 'File inputs require CDP DOM.setFileInputFiles method',\n      suggestion: 'Use: bdg cdp DOM.setFileInputFiles --params {\\\"files\\\":[\\\"path\\\"]}'\n    };\n  } else if (el.isContentEditable) {\n    el.textContent = value;\n    el.dispatchEvent(new Event('input', { bubbles: true }));\n  } else {\n    const nativeInputValueSetter = Object.getOwnPropertyDescriptor(\n      window.HTMLInputElement.prototype,\n      'value'\n    )?.set;\n    \n    const nativeTextAreaValueSetter = Object.getOwnPropertyDescriptor(\n      window.HTMLTextAreaElement.prototype,\n      'value'\n    )?.set;\n    \n    const setter = tagName === 'textarea' \n      ? nativeTextAreaValueSetter \n      : nativeInputValueSetter;\n    \n    if (setter) {\n      setter.call(el, value);\n    } else {\n      el.value = value;\n    }\n    \n    el.dispatchEvent(new Event('input', { bubbles: true }));\n    el.dispatchEvent(new Event('change', { bubbles: true }));\n  }\n  \n  if (options.blur !== false) {\n    el.blur();\n    el.dispatchEvent(new FocusEvent('focusout', { bubbles: true }));\n  }\n  \n  return {\n    success: true,\n    selector: selector,\n    value: el.value || el.textContent,\n    elementType: tagName,\n    inputType: inputType || null,\n    checked: el.checked || undefined\n  };\n})\n";
 /**
  * JavaScript function to click an element.
  *
  * @remarks
- * Simple click implementation that works with buttons, links, and custom components.
- * When selector matches multiple elements, prioritizes visible ones.
+ * Handles both direct selector matching and indexed selection.
+ * When index is provided, selects the nth matching element (1-based).
+ * When selector matches multiple elements without index, prioritizes visible ones.
  */
-export declare const CLICK_ELEMENT_SCRIPT = "\n(function(selector) {\n  let el = document.querySelector(selector);\n  \n  if (!el) {\n    return {\n      success: false,\n      error: 'Element not found',\n      selector: selector\n    };\n  }\n  \n  const allMatches = document.querySelectorAll(selector);\n  if (allMatches.length > 1) {\n    for (const candidate of allMatches) {\n      const style = window.getComputedStyle(candidate);\n      const rect = candidate.getBoundingClientRect();\n      \n      const hasSize = rect.width > 0 && rect.height > 0;\n      const isDisplayed = style.display !== 'none' && style.visibility !== 'hidden';\n      const isOpaque = parseFloat(style.opacity) > 0;\n      const isPositioned = candidate.offsetParent !== null || style.position === 'fixed';\n      \n      const isVisible = hasSize && isDisplayed && isOpaque && isPositioned;\n      \n      if (isVisible) {\n        el = candidate;\n        break;\n      }\n    }\n  }\n  \n  const tagName = el.tagName.toLowerCase();\n  const isClickable = (\n    tagName === 'button' ||\n    tagName === 'a' ||\n    tagName === 'input' ||\n    el.onclick !== null ||\n    el.getAttribute('role') === 'button' ||\n    window.getComputedStyle(el).cursor === 'pointer'\n  );\n  \n  if (!isClickable) {\n    console.warn('Warning: Element may not be clickable:', el);\n  }\n  \n  el.scrollIntoView({ behavior: 'auto', block: 'center' });\n  \n  el.click();\n  \n  return {\n    success: true,\n    selector: selector,\n    elementType: tagName,\n    clickable: isClickable\n  };\n})\n";
-/**
- * JavaScript function to get multiple elements by selector.
- *
- * @remarks
- * Used when --index is specified to select from multiple matches.
- */
-export declare const GET_ELEMENT_BY_INDEX_SCRIPT = "\n(function(selector, index) {\n  const elements = document.querySelectorAll(selector);\n  \n  if (elements.length === 0) {\n    return {\n      success: false,\n      error: 'No elements found',\n      selector: selector,\n      matchCount: 0\n    };\n  }\n  \n  if (index < 1 || index > elements.length) {\n    return {\n      success: false,\n      error: 'Index out of range',\n      selector: selector,\n      matchCount: elements.length,\n      requestedIndex: index,\n      suggestion: `Use --index between 1 and ${elements.length}`\n    };\n  }\n  \n  const el = elements[index - 1]; // Convert to 0-based\n  \n  function buildUniquePath(element) {\n    if (element.id) {\n      return `#${CSS.escape(element.id)}`;\n    }\n    \n    const path = [];\n    let current = element;\n    \n    while (current && current !== document.documentElement) {\n      let selector = current.tagName.toLowerCase();\n      \n      if (current.parentElement) {\n        const siblings = Array.from(current.parentElement.children);\n        const sameTagSiblings = siblings.filter(\n          (sibling) => sibling.tagName === current!.tagName\n        );\n        \n        if (sameTagSiblings.length > 1) {\n          const index = sameTagSiblings.indexOf(current) + 1;\n          selector += `:nth-of-type(${index})`;\n        }\n      }\n      \n      path.unshift(selector);\n      current = current.parentElement;\n    }\n    \n    return 'html > ' + path.join(' > ');\n  }\n  \n  const uniqueSelector = buildUniquePath(el);\n  \n  return {\n    success: true,\n    selector: selector,\n    matchCount: elements.length,\n    selectedIndex: index,\n    uniqueSelector: uniqueSelector\n  };\n})\n";
+export declare const CLICK_ELEMENT_SCRIPT = "\n(function(selector, index) {\n  const allMatches = document.querySelectorAll(selector);\n  \n  if (allMatches.length === 0) {\n    return {\n      success: false,\n      error: 'Element not found',\n      selector: selector\n    };\n  }\n  \n  let el;\n  \n  // If index is provided, use it directly (1-based)\n  if (typeof index === 'number' && index > 0) {\n    if (index > allMatches.length) {\n      return {\n        success: false,\n        error: 'Index out of range',\n        selector: selector,\n        matchCount: allMatches.length,\n        requestedIndex: index,\n        suggestion: 'Use --index between 1 and ' + allMatches.length\n      };\n    }\n    el = allMatches[index - 1];\n  } else if (allMatches.length === 1) {\n    // Single match - use it directly\n    el = allMatches[0];\n  } else {\n    // Multiple matches without index - find first visible one\n    el = allMatches[0];\n    for (const candidate of allMatches) {\n      const style = window.getComputedStyle(candidate);\n      const rect = candidate.getBoundingClientRect();\n      \n      const hasSize = rect.width > 0 && rect.height > 0;\n      const isDisplayed = style.display !== 'none' && style.visibility !== 'hidden';\n      const isOpaque = parseFloat(style.opacity) > 0;\n      const isPositioned = candidate.offsetParent !== null || style.position === 'fixed';\n      \n      const isVisible = hasSize && isDisplayed && isOpaque && isPositioned;\n      \n      if (isVisible) {\n        el = candidate;\n        break;\n      }\n    }\n  }\n  \n  const tagName = el.tagName.toLowerCase();\n  const isClickable = (\n    tagName === 'button' ||\n    tagName === 'a' ||\n    tagName === 'input' ||\n    el.onclick !== null ||\n    el.getAttribute('role') === 'button' ||\n    window.getComputedStyle(el).cursor === 'pointer'\n  );\n  \n  if (!isClickable) {\n    console.warn('Warning: Element may not be clickable:', el);\n  }\n  \n  el.scrollIntoView({ behavior: 'auto', block: 'center' });\n  \n  el.click();\n  \n  return {\n    success: true,\n    selector: selector,\n    elementType: tagName,\n    clickable: isClickable,\n    matchCount: allMatches.length,\n    selectedIndex: typeof index === 'number' ? index : undefined\n  };\n})\n";
 /**
  * Options for filling an element.
  */
@@ -63,18 +57,23 @@ export interface ClickResult {
     selector?: string;
     elementType?: string;
     clickable?: boolean;
-}
-/**
- * Result of getting element by index.
- */
-export interface ElementByIndexResult {
-    success: boolean;
-    error?: string;
-    selector?: string;
     matchCount?: number;
     selectedIndex?: number;
     requestedIndex?: number;
-    uniqueSelector?: string;
     suggestion?: string;
 }
+/**
+ * Type guard for FillResult.
+ *
+ * @param value - Value to check
+ * @returns True if value is a valid FillResult
+ */
+export declare function isFillResult(value: unknown): value is FillResult;
+/**
+ * Type guard for ClickResult.
+ *
+ * @param value - Value to check
+ * @returns True if value is a valid ClickResult
+ */
+export declare function isClickResult(value: unknown): value is ClickResult;
 //# sourceMappingURL=reactEventHelpers.d.ts.map

package/dist/commands/dom/reactEventHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reactEventHelpers.d.ts","sourceRoot":"","sources":["../../../src/commands/dom/reactEventHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,+4EAwF7B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,u/CAyDhC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,+pDAkEvC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"reactEventHelpers.d.ts","sourceRoot":"","sources":["../../../src/commands/dom/reactEventHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,o8FA4G7B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,isEA8EhC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAIhE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAIlE"}