@wdio/mcp 2.2.0 → 2.3.0

package/lib/snapshot.d.ts

@@ -1,73 +1,57 @@
 /**
- * Browser accessibility tree snapshot
- * Extracts semantic information about page elements (roles, names, states)
- */
-interface AccessibilityNode {
-    role: string;
-    name: string;
-    value: string;
-    description: string;
-    disabled: string;
-    focused: string;
-    selected: string;
-    checked: string;
-    expanded: string;
-    pressed: string;
-    readonly: string;
-    required: string;
-    level: string | number;
-    valuemin: string | number;
-    valuemax: string | number;
-    autocomplete: string;
-    haspopup: string;
-    invalid: string;
-    modal: string;
-    multiline: string;
-    multiselectable: string;
-    orientation: string;
-    keyshortcuts: string;
-    roledescription: string;
-    valuetext: string;
-}
-/**
- * Get browser accessibility tree snapshot
- * Browser-only - requires Puppeteer access via WebDriverIO browser instance
+ * Browser element detection
+ * Single browser.execute() call: querySelectorAll → flat interactable element list
  *
- * @param browser - WebDriverIO browser instance
- * @returns Flattened accessibility tree nodes
+ * NOTE: This script runs in browser context via browser.execute()
+ * It must be self-contained with no external dependencies
  */
-declare function getBrowserAccessibilityTree(browser: WebdriverIO.Browser): Promise<AccessibilityNode[]>;
-
-type ElementType = 'interactable' | 'visual' | 'all';
 interface BrowserElementInfo {
     tagName: string;
+    name: string;
     type: string;
-    id: string;
-    className: string;
-    textContent: string;
     value: string;
-    placeholder: string;
     href: string;
-    ariaLabel: string;
-    role: string;
-    src: string;
-    alt: string;
-    cssSelector: string;
+    selector: string;
     isInViewport: boolean;
+    boundingBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
 }
 interface GetBrowserElementsOptions {
-    /** Type of elements to return. Default: 'interactable' */
-    elementType?: ElementType;
+    includeBounds?: boolean;
 }
 /**
- * Get browser interactable elements
- * Wrapper function that executes the script in browser context
+ * Get interactable browser elements via querySelectorAll.
+ */
+declare function getInteractableBrowserElements(browser: WebdriverIO.Browser, options?: GetBrowserElementsOptions): Promise<BrowserElementInfo[]>;
+
+/**
+ * Browser accessibility tree
+ * Single browser.execute() call: DOM walk → flat accessibility node list
  *
- * @param browser - WebDriverIO browser instance
- * @param options - Options for element filtering
- * @returns Array of visible element information
+ * NOTE: This script runs in browser context via browser.execute()
+ * It must be self-contained with no external dependencies
  */
-declare function getBrowserInteractableElements(browser: WebdriverIO.Browser, options?: GetBrowserElementsOptions): Promise<BrowserElementInfo[]>;
+interface AccessibilityNode {
+    role: string;
+    name: string;
+    selector: string;
+    level: number | string;
+    disabled: string;
+    checked: string;
+    expanded: string;
+    selected: string;
+    pressed: string;
+    required: string;
+    readonly: string;
+}
+/**
+ * Get browser accessibility tree via a single DOM walk.
+ */
+declare function getBrowserAccessibilityTree(browser: WebdriverIO.Browser): Promise<AccessibilityNode[]>;
 
 interface FilterOptions {
     includeTagNames?: string[];
@@ -120,4 +104,4 @@ interface GetMobileElementsOptions {
  */
 declare function getMobileVisibleElements(browser: WebdriverIO.Browser, platform: 'ios' | 'android', options?: GetMobileElementsOptions): Promise<MobileElementInfo[]>;
 
-export { type AccessibilityNode, type BrowserElementInfo, type ElementType, type GetBrowserElementsOptions, type GetMobileElementsOptions, type MobileElementInfo, getBrowserAccessibilityTree, getBrowserInteractableElements, getMobileVisibleElements };
+export { type AccessibilityNode, type BrowserElementInfo, type GetBrowserElementsOptions, type GetMobileElementsOptions, type MobileElementInfo, getBrowserAccessibilityTree, getInteractableBrowserElements, getMobileVisibleElements };