npm - @nodebug/browser-element-finder - Versions diffs - 1.1.6 → 1.1.8 - Mend

@nodebug/browser-element-finder 1.1.6 → 1.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md +119 -64
package/index.js +155 -18
package/index.min.js +15 -1
package/package.json +1 -1
package/src/element-definitions.json +3 -3
package/src/searchable-attributes.json +1 -0

package/README.md CHANGED Viewed

@@ -1,5 +1,7 @@
 # @nodebug/browser-element-finder
+**Version**: 1.1.8
 **A robust, agent-friendly JavaScript library for identifying DOM elements by type and/or text content, with full support for shadow DOM, iframes, and automation workflows.**
 ---
@@ -52,7 +54,7 @@ results.elements.forEach((e) => {
 - **Text content search**: Search within element text, attributes, and placeholders
 - **Shadow DOM support**: Automatically traverses shadow roots to find nested elements
 - **Iframe support**: Automatically searches all frames (main document + iframes) by default
-- **Visibility detection**: All elements returned with `isVisible` property (`true`/`false`)
+- **Visibility detection**: All elements returned with `isHidden` property (`true`/`false`)
 - **Bounding box data**: Returns position and dimensions for each found element
 - **XPath-like type definitions**: Extensible element type matching using XPath-like expressions
 - **Optimized performance**: Pre-compiled type matchers, O(n) innermost element filtering, and efficient Set-based lookups
@@ -92,14 +94,14 @@ browser-element-finder/
 ```js
 // Find all elements (visible and hidden)
-const results = ElementFinder.findElement('button')
+const results = ElementFinder.findElements('button')
 // Find by text
-const results = ElementFinder.findElement('button', 'Submit')
+const results = ElementFinder.findElements('button', 'Submit')
 // Find by text only
-const results = ElementFinder.findElement(null, 'seleniumbase')
+const results = ElementFinder.findElements(null, 'seleniumbase')
 // Check visibility of found elements
 results.elements.forEach((e) => {
-  console.log('Visible:', e.isVisible)
+  console.log('Hidden:', e.isHidden)
 })
 ```
@@ -113,7 +115,7 @@ The library automatically searches all frames (main + iframes). For agent/automa
 **Example**:
 ```js
-const results = ElementFinder.findElement('button')
+const results = ElementFinder.findElements('button')
 for (const item of results.elements) {
   if (item.frameIndex === -1 && item.element) {
     // Interact directly
@@ -125,6 +127,50 @@ for (const item of results.elements) {
 }
 ```
+### Customizing Searchable Attributes
+You can customize which attributes the library searches for text (e.g., adding a custom `data-test-id` or removing `placeholder`).
+```js
+// Get current attributes
+const currentAttrs = ElementFinder.getSearchableAttributes()
+// Set new priority list
+ElementFinder.setSearchableAttributes([
+  'id',
+  'name',
+  'data-testid',
+  'placeholder',
+])
+```
+### Pausing Animations for Screenshots
+When taking screenshots or performing visual assertions, animations can cause flaky tests. Use `pauseAnimations()` and `resumeAnimations()` to freeze and restore animations:
+```js
+// Pause all CSS animations and transitions
+const pauseState = ElementFinder.pauseAnimations()
+// Take screenshot or perform visual assertions
+// ... screenshot code here ...
+// Resume animations
+ElementFinder.resumeAnimations(pauseState)
+```
+For Selenium WebDriver tests, call the functions directly in the browser context:
+```js
+// Pause animations (state is stored internally in browser)
+await driver.executeScript('return ElementFinder.pauseAnimations()')
+// ... take screenshot ...
+// Resume animations (pops from internal stack - no argument needed)
+await driver.executeScript('ElementFinder.resumeAnimations()')
+```
 ### Accessing Element Definitions and Searchable Attributes
 The package exports JSON files containing element type definitions and searchable attributes:
@@ -151,24 +197,28 @@ const SEARCHABLE_ATTRIBUTES = require('@nodebug/browser-element-finder/searchabl
 ## API Summary
-| Function                                          | Description                                                                   |
-| ------------------------------------------------- | ----------------------------------------------------------------------------- |
-| `findElements(type, text, exact, parent)`         | Find elements by type/text, returns `{ elements: [...] }`                     |
-| `findElementByType(type, parent)`                 | Find elements by type only, returns `{ elements: [...] }`                     |
-| `findElementByAttributes(value, exact, parent)`   | Find elements by text/attribute, returns `{ elements: [...] }`                |
-| `findProbableElements(type, text, exact, parent)` | Find elements with fallback to nearby elements, returns `{ elements: [...] }` |
-| `highlight(elements, color, width)`               | Highlight elements with outline                                               |
-| `unhighlight(elements)`                           | Remove highlight                                                              |
-| `getValidTypes()`                                 | List all supported element types                                              |
-| `getBoundingBox(element)`                         | Get bounding box for an element                                               |
-| `setSearchableAttributes(attributes)`             | Set custom attributes for text search                                         |
-| `getSearchableAttributes()`                       | Get current searchable attributes                                             |
-| `matchesType(el, type)`                           | Check if element matches a type                                               |
-| `matchesAttribute(el, value, exact)`              | Check if element matches text/attribute                                       |
-| `getAllElements(root)`                            | Get all elements (with shadow DOM)                                            |
-| `getAllFrames(root)`                              | Get all frames (main + iframes)                                               |
-| `parseXPath(expr, el, depth)`                     | Parse XPath-like type expressions                                             |
-| `splitByOperator(expr, op)`                       | Split XPath by operator                                                       |
+| Function                                          | Description                                                                    |
+| ------------------------------------------------- | ------------------------------------------------------------------------------ |
+| `findElements(type, text, exact, parent)`         | Find elements by type/text, returns `{ elements: [...] }`                      |
+| `findElementsByType(type, parent)`                | Find elements by type only, returns `{ elements: [...] }`                      |
+| `findElementsByAttribute(value, exact, parent)`   | Find elements by text/attribute, returns `{ elements: [...] }`                 |
+| `findProbableElements(type, text, exact, parent)` | Find elements with fallback to nearby elements, returns `{ elements: [...] }`  |
+| `highlight(elements, color, width)`               | Highlight elements with outline                                                |
+| `unhighlight(elements)`                           | Remove highlight                                                               |
+| `pauseAnimations()`                               | Pause all CSS animations and transitions, returns state object                 |
+| `resumeAnimations(state)`                         | Resume animations using state from `pauseAnimations()`                         |
+| `getValidTypes()`                                 | List all supported element types                                               |
+| `getValidAttributes()`                            | List all valid searchable attribute names                                      |
+| `getBoundingBox(element)`                         | Get bounding box for an element                                                |
+| `setSearchableAttributes(attributes)`             | Set custom attributes for text search                                          |
+| `getSearchableAttributes()`                       | Get current searchable attributes                                              |
+| `matchesType(el, type)`                           | Check if element matches a type                                                |
+| `matchesAttribute(el, value, exact)`              | Check if element matches text/attribute                                        |
+| `getAllElements(root)`                            | Get all elements (with shadow DOM)                                             |
+| `getAllFrames(root)`                              | Get all frames (main + iframes)                                                |
+| `parseXPath(expr, el, depth)`                     | Parse XPath-like type expressions                                              |
+| `splitByOperator(expr, op)`                       | Split XPath by operator                                                        |
+| `isHidden(el)`                                    | Check if element is hidden (display:none, visibility:hidden, hidden attribute) |
 ---
@@ -183,10 +233,11 @@ Finds elements matching the specified type and/or text. Combines type and attrib
 | `exact`   | `boolean` | `false` | Exact text match vs substring (only used when text is provided)                                                  |
 | `parent`  | `Element` | `null`  | Parent element to search within                                                                                  |
-**Returns**: `{ elements: [{ element, boundingBox, tagName, frameIndex }] }`
+**Returns**: `{ elements: [{ element, boundingBox, tagName, frameIndex, isHidden }] }`
 - `element`: Raw DOM element (main frame only; for iframes, use `frameIndex` and re-query after switching context)
 - `frameIndex`: `-1` for main frame, `0, 1, 2...` for iframes
+- `isHidden`: `true` if element is hidden (display:none, visibility:hidden, hidden attribute, or zero dimensions)
 **Agent/Automation Note**: Iframe elements cannot be interacted with directly. Use `frameIndex` to switch context, then re-run `findElements` inside the iframe.
@@ -203,12 +254,12 @@ Finds elements matching the specified type with intelligent fallback to nearby e
 | `exact`   | `boolean` | `false` | Exact text match vs substring (only used when text is provided)                                                                   |
 | `parent`  | `Element` | `null`  | Parent element to search within                                                                                                   |
-**Returns**: `{ elements: [{ element, boundingBox, tagName, frameIndex }] }`
+**Returns**: `{ elements: [{ element, boundingBox, tagName, frameIndex, isHidden }] }`
 **Behavior**:
-- If only `type` is provided: delegates to `findElementByType(type, parent)`
-- If only `text` is provided: delegates to `findElementByAttributes(text, exact, parent)`
+- If only `type` is provided: delegates to `findElementsByType(type, parent)`
+- If only `text` is provided: delegates to `findElementsByAttribute(text, exact, parent)`
 - If both are provided: attempts direct match, then falls back to nearby elements
 **Fallback Strategy**: When no element matches both type and text directly, searches for nearby elements in this order:
@@ -220,11 +271,11 @@ Finds elements matching the specified type with intelligent fallback to nearby e
 **Example**:
 ```javascript
-// Type-only search (delegates to findElementByType)
+// Type-only search (delegates to findElementsByType)
 const result1 = ElementFinder.findProbableElements('button')
 // Returns all buttons on the page
-// Text-only search (delegates to findElementByAttributes)
+// Text-only search (delegates to findElementsByAttribute)
 const result2 = ElementFinder.findProbableElements(null, 'Submit')
 // Returns all elements containing "Submit"
@@ -265,6 +316,10 @@ Removes highlighting from elements.
 Returns an array of all valid element type names.
+### `getValidAttributes()`
+Returns an array of all valid searchable attribute names (same as `getSearchableAttributes()`).
 ### `getBoundingBox(element)`
 Returns the bounding box for an element.
@@ -285,7 +340,7 @@ Checks if an element matches the specified type definition.
 Checks if an element matches the specified text/attribute value. Safely handles edge case elements that may throw errors on attribute access.
-### `findElementByType(type, parent)`
+### `findElementsByType(type, parent)`
 Finds elements by type only. Searches all frames by default.
@@ -294,7 +349,7 @@ Finds elements by type only. Searches all frames by default.
 | `type`    | `string`  | `"element"` | Element type (see supported types below). Throws `TypeError` for non-string values. |
 | `parent`  | `Element` | `null`      | Parent element to search within                                                     |
-### `findElementByAttributes(value, exact, parent)`
+### `findElementsByAttribute(value, exact, parent)`
 Finds elements by text/attribute value only. Searches all frames by default.
@@ -329,7 +384,7 @@ The library automatically searches all frames (main + iframes) by default. Howev
 ### Iframe Element Limitations
 ```javascript
-const results = ElementFinder.findElement('button')
+const results = ElementFinder.findElements('button')
 results.elements.forEach((item) => {
   if (item.frameIndex === -1) {
@@ -352,7 +407,7 @@ To interact with elements inside an iframe, you must switch the Selenium driver
 ```javascript
 // Find iframe elements
 const results = await driver.executeScript(`
-  return ElementFinder.findElement('button');
+  return ElementFinder.findElements('button');
 `)
 // Switch to iframe and interact
@@ -363,7 +418,7 @@ if (iframeElements.length > 0) {
   // Now find and interact with elements in the iframe
   const iframeResults = await driver.executeScript(`
-    return ElementFinder.findElement('button');
+    return ElementFinder.findElements('button');
   `)
   // These elements will have the element property since we're in the iframe context
 }
@@ -373,33 +428,33 @@ if (iframeElements.length > 0) {
 ## Supported Element Types
-| Type          | Description                                             |
-| ------------- | ------------------------------------------------------- |
-| `button`      | `<button>`, `[role="button"]`, `[type="button"]`        |
-| `checkbox`    | `<input type="checkbox">`, `[role="checkbox"]`          |
-| `switch`      | Toggle switches, checkboxes with switch role            |
-| `slider`      | `<input type="range">`, `[role="slider"]`               |
-| `datepicker`  | `<input type="date">`                                   |
-| `colorpicker` | `<input type="color">`                                  |
-| `radio`       | `<input type="radio">`, `[role="radio"]`                |
-| `dropdown`    | `<select>`, `[role="combobox"]`, `[role="listbox"]`     |
-| `textbox`     | `<input>`, `<textarea>`, `[role="textbox"]`             |
-| `link`        | `<a>`, `[role="link"]`, `[href]`                        |
-| `heading`     | `<h1>-<h6>`, `[role="heading"]`                         |
-| `navigation`  | `<nav>`, `[role="navigation"]`                          |
-| `list`        | `<ul>`, `<ol>`, `[role="list"]`                         |
-| `listitem`    | `<li>`, `[role="listitem"]`                             |
-| `menu`        | `<menu>`, `[role="menu"]`                               |
-| `menuitem`    | `[role="menuitem"]`                                     |
-| `toolbar`     | `[role="toolbar"]`                                      |
-| `dialog`      | `[role="dialog"]`                                       |
-| `table`       | `<table>`, `[role="table"]`                             |
-| `row`         | `<tr>`, `[role="row"]`                                  |
-| `column`      | `<td>`, `<th>`, `[role="cell"]`                         |
-| `cell`        | `<td>`, `[role="cell"]` (data cells only, no expansion) |
-| `image`       | `<img>`, `[role="img"]`                                 |
-| `file`        | `<input type="file"]`                                   |
-| `element`     | Matches all elements                                    |
+| Type          | Description                                                                                          |
+| ------------- | ---------------------------------------------------------------------------------------------------- |
+| `button`      | `<button>`, `[role="button"]`, `[type="button"]`, `[type="submit"]`                                  |
+| `checkbox`    | `<input type="checkbox">`, `[role="checkbox"]`                                                       |
+| `switch`      | Toggle switches, checkboxes with switch role, buttons with `class="switch"` or `data-state`          |
+| `slider`      | `<input type="range">`, `[role="slider"]`                                                            |
+| `datepicker`  | `<input type="date">`, `[role="date"]`                                                               |
+| `colorpicker` | `<input type="color">`, `[role="color"]`                                                             |
+| `radio`       | `<input type="radio">`, `[role="radio"]`                                                             |
+| `dropdown`    | `<select>`, `[role="combobox"]`, `[role="listbox"]`, class-based dropdown/trigger, ancestor matching |
+| `textbox`     | `<textarea>`, `<input>` (text/password/search/email/number/tel/url), `[role="textbox"]`              |
+| `link`        | `<a>`, `[role="link"]`, `[href]`                                                                     |
+| `heading`     | `<h1>-<h6>`, `[role="heading"]`                                                                      |
+| `navigation`  | `<nav>`, `[role="navigation"]`                                                                       |
+| `list`        | `<ul>`, `<ol>`, `[role="list"]`                                                                      |
+| `listitem`    | `<li>`, `[role="listitem"]`                                                                          |
+| `menu`        | `<menu>`, `[role="menu"]`                                                                            |
+| `menuitem`    | `[role="menuitem"]`                                                                                  |
+| `toolbar`     | `[role="toolbar"]`                                                                                   |
+| `dialog`      | `[role="dialog"]`, `[role="alertdialog"]`                                                            |
+| `table`       | `<table>`, `[role="table"]`                                                                          |
+| `row`         | `<tr>`, `[role="row"]`                                                                               |
+| `column`      | `<td>`, `<th>`, `[role="cell"]`, `[role="gridcell"]`, `[role="columnheader"]`                        |
+| `cell`        | `<td>`, `[role="cell"]`, `[role="gridcell"]` (data cells only, no expansion)                         |
+| `image`       | `<img>`, `[role="img"]`, `[alt]`                                                                     |
+| `file`        | `<input type="file">`                                                                                |
+| `element`     | Matches all elements                                                                                 |
 ---
@@ -438,8 +493,8 @@ const headerCell = ElementFinder.findElement('cell', 'City')
 By default, the library searches these attributes (in priority order):
-- `placeholder`, `value`, `data-test-id`, `data-testid`, `id`
-- `resource-id`, `name`, `aria-label`, `class`, `hint`
+- `placeholder`, `value`, `data-value`, `data-test-id`, `data-testid`, `id`
+- `resource-id`, `name`, `aria-label`, `hint`
 - `title`, `tooltip`, `alt`, `src`, `aria-labelledby`
 ---

package/index.js CHANGED Viewed

@@ -21,9 +21,9 @@ var ElementFinder = (() => {
   var element_finder_exports = {};
   __export(element_finder_exports, {
     ELEMENT_DEFINITIONS: () => ELEMENT_DEFINITIONS,
-    findElementByAttributes: () => findElementByAttributes,
-    findElementByType: () => findElementByType,
     findElements: () => findElements,
+    findElementsByAttribute: () => findElementsByAttribute,
+    findElementsByType: () => findElementsByType,
     findProbableElements: () => findProbableElements,
     getAllElements: () => getAllElements,
     getAllFrames: () => getAllFrames,
@@ -32,10 +32,13 @@ var ElementFinder = (() => {
     getValidAttributes: () => getValidAttributes,
     getValidTypes: () => getValidTypes,
     highlight: () => highlight,
+    isHidden: () => isHidden,
     matchesAttribute: () => matchesAttribute,
     matchesType: () => matchesType,
     parseCondition: () => parseCondition,
     parseXPath: () => parseXPath,
+    pauseAnimations: () => pauseAnimations,
+    resumeAnimations: () => resumeAnimations,
     setSearchableAttributes: () => setSearchableAttributes,
     splitByOperator: () => splitByOperator,
     unhighlight: () => unhighlight
@@ -50,8 +53,8 @@ var ElementFinder = (() => {
     checkbox: "(self::input and @type='checkbox') or @role='checkbox'",
     switch: "(self::input and @type='checkbox') or @role='switch' or (self::button and (contains(@class, 'switch') or @data-state))",
     slider: "self::input[@type='range'] or @role='slider'",
-    datepicker: "self::input and @type='date'",
-    colorpicker: "self::input and @type='color'",
+    datepicker: "self::input[@type='date'] or @role='date'",
+    colorpicker: "self::input[@type='color'] or @role='color'",
     radio: "(self::input and @type='radio') or @role='radio'",
     dropdown: "(self::select[descendant::option] or @role='combobox' or @role='listbox' or contains(@class, 'dropdown') or contains(@class, 'trigger') or ancestor::*[contains(@class, 'dropdown') or @role='combobox'])",
     textbox: "self::textarea or (self::input and (@type='text' or @type='password' or @type='search' or @type='email' or @type='number' or @type='tel' or @type='url')) or @role='textbox'",
@@ -61,7 +64,7 @@ var ElementFinder = (() => {
     menu: "self::menu or @role='menu'",
     menuitem: "@role='menuitem'",
     toolbar: "@role='toolbar'",
-    dialog: "@role='dialog'",
+    dialog: "@role='dialog' or @role='alertdialog'",
     table: "self::table or @role='table'",
     row: "self::tr or @role='row'",
     column: "self::td or self::th or @role='cell' or @role='gridcell' or @role='columnheader'",
@@ -74,6 +77,7 @@ var ElementFinder = (() => {
   var searchable_attributes_default = [
     "placeholder",
     "value",
+    "data-value",
     "data-test-id",
     "data-testid",
     "id",
@@ -387,7 +391,27 @@ var ElementFinder = (() => {
       tagName: el.tagName.toLowerCase()
     };
   }
-  function findElementByType(type = "element", parent = null) {
+  function isHidden(el) {
+    if (el == null) return true;
+    if (el.offsetWidth === 0 && el.offsetHeight === 0) {
+      return true;
+    }
+    try {
+      const style = window.getComputedStyle(el);
+      if (style.visibility === "hidden" || style.visibility === "collapse") {
+        return true;
+      }
+      if (style.display === "none") {
+        return true;
+      }
+    } catch (e) {
+    }
+    if (el.hasAttribute("hidden")) {
+      return true;
+    }
+    return false;
+  }
+  function findElementsByType(type = "element", parent = null) {
     if (type === null || type === void 0) {
       type = "element";
     }
@@ -430,23 +454,26 @@ var ElementFinder = (() => {
     const qualified = innermostMatches.map((item) => {
       const boundingBox = getBoundingBox(item.element);
       const tagName = item.element.tagName.toLowerCase();
+      const hidden = isHidden(item.element);
       if (!item.frame.isMainFrame) {
         return {
           boundingBox,
           tagName,
-          frameIndex: item.frame.frameIndex
+          frameIndex: item.frame.frameIndex,
+          isHidden: hidden
         };
       }
       return {
         element: item.element,
         boundingBox,
         tagName,
-        frameIndex: item.frame.frameIndex
+        frameIndex: item.frame.frameIndex,
+        isHidden: hidden
       };
     });
     return { elements: qualified };
   }
-  function findElementByAttributes(value, exact = false, parent = null) {
+  function findElementsByAttribute(value, exact = false, parent = null) {
     if (value === null || value === void 0) {
       value = "";
     }
@@ -477,18 +504,21 @@ var ElementFinder = (() => {
     const qualified = filteredMatches.map((item) => {
       const boundingBox = getBoundingBox(item.element);
       const tagName = item.element.tagName.toLowerCase();
+      const hidden = isHidden(item.element);
       if (!item.frame.isMainFrame) {
         return {
           boundingBox,
           tagName,
-          frameIndex: item.frame.frameIndex
+          frameIndex: item.frame.frameIndex,
+          isHidden: hidden
         };
       }
       return {
         element: item.element,
         boundingBox,
         tagName,
-        frameIndex: item.frame.frameIndex
+        frameIndex: item.frame.frameIndex,
+        isHidden: hidden
       };
     });
     return { elements: qualified };
@@ -567,18 +597,21 @@ var ElementFinder = (() => {
     const qualified = filteredMatches.map((item) => {
       const boundingBox = getBoundingBox(item.element);
       const tagName = item.element.tagName.toLowerCase();
+      const hidden = isHidden(item.element);
       if (!item.frame.isMainFrame) {
         return {
           boundingBox,
           tagName,
-          frameIndex: item.frame.frameIndex
+          frameIndex: item.frame.frameIndex,
+          isHidden: hidden
         };
       }
       return {
         element: item.element,
         boundingBox,
         tagName,
-        frameIndex: item.frame.frameIndex
+        frameIndex: item.frame.frameIndex,
+        isHidden: hidden
       };
     });
     return { elements: qualified };
@@ -628,16 +661,43 @@ var ElementFinder = (() => {
         return sibling;
       }
     }
+    for (const sibling of siblings) {
+      if (sibling === el) continue;
+      const siblingElements = getAllElements(sibling);
+      for (let i = 0; i < siblingElements.length; i++) {
+        if (matchesType(siblingElements[i], targetType)) {
+          return siblingElements[i];
+        }
+      }
+    }
+    let ancestor = el.parentElement;
+    while (ancestor) {
+      const ancestorSiblings = getSiblingElements(ancestor);
+      for (const sibling of ancestorSiblings) {
+        if (sibling !== ancestor) {
+          if (matchesType(sibling, targetType)) {
+            return sibling;
+          }
+          const siblingElements = getAllElements(sibling);
+          for (let i = 0; i < siblingElements.length; i++) {
+            if (matchesType(siblingElements[i], targetType)) {
+              return siblingElements[i];
+            }
+          }
+        }
+      }
+      ancestor = ancestor.parentElement;
+    }
     return null;
   }
   function findProbableElements(elementType, attributeText, exact = false, parent = null) {
     const hasType = elementType !== null && elementType !== void 0 && elementType !== "";
     const hasText = attributeText !== null && attributeText !== void 0 && attributeText !== "";
     if (hasType && !hasText) {
-      return findElementByType(elementType, parent);
+      return findElementsByType(elementType, parent);
     }
     if (!hasType && hasText) {
-      return findElementByAttributes(attributeText, exact, parent);
+      return findElementsByAttribute(attributeText, exact, parent);
     }
     if (hasType) {
       if (typeof elementType !== "string") {
@@ -671,7 +731,9 @@ var ElementFinder = (() => {
         for (let i = 0; i < allElements.length; i++) {
           const el = allElements[i];
           if (!matchesAttribute(el, attributeText, exact)) continue;
-          attributeMatches.push({ element: el, frame });
+          if (hasOwnMatch(el, attributeText, exact)) {
+            attributeMatches.push({ element: el, frame });
+          }
         }
       }
       const foundElements = /* @__PURE__ */ new Set();
@@ -697,18 +759,21 @@ var ElementFinder = (() => {
     const qualified = filteredMatches.map((item) => {
       const boundingBox = getBoundingBox(item.element);
       const tagName = item.element.tagName.toLowerCase();
+      const hidden = isHidden(item.element);
       if (!item.frame.isMainFrame) {
         return {
           boundingBox,
           tagName,
-          frameIndex: item.frame.frameIndex
+          frameIndex: item.frame.frameIndex,
+          isHidden: hidden
         };
       }
       return {
         element: item.element,
         boundingBox,
         tagName,
-        frameIndex: item.frame.frameIndex
+        frameIndex: item.frame.frameIndex,
+        isHidden: hidden
       };
     });
     return { elements: qualified };
@@ -746,6 +811,78 @@ var ElementFinder = (() => {
       }
     }
   }
+  var animationPauseStack = [];
+  function pauseAnimations() {
+    const originalStyles = /* @__PURE__ */ new Map();
+    const elements = getAllElements();
+    for (const el of elements) {
+      if (el && el.style) {
+        if (el.style.animationPlayState !== "paused") {
+          originalStyles.set(el, {
+            animationPlayState: el.style.animationPlayState,
+            transitionProperty: el.style.transitionProperty,
+            webkitAnimationPlayState: el.style.webkitAnimationPlayState,
+            webkitTransitionProperty: el.style.webkitTransitionProperty
+          });
+          el.style.animationPlayState = "paused";
+          el.style.transitionProperty = "none";
+          el.style.webkitAnimationPlayState = "paused";
+          el.style.webkitTransitionProperty = "none";
+        }
+      }
+    }
+    let styleSheet = document.getElementById("elementfinder-animation-pause");
+    if (!styleSheet) {
+      styleSheet = document.createElement("style");
+      styleSheet.id = "elementfinder-animation-pause";
+      styleSheet.textContent = `
+      *, *::before, *::after {
+        animation-play-state: paused !important;
+        transition-property: none !important;
+        -webkit-animation-play-state: paused !important;
+        -webkit-transition-property: none !important;
+      }
+      @media (prefers-reduced-motion: no-preference) {
+        *, *::before, *::after {
+          animation-duration: 0s !important;
+          animation-iteration-count: 1 !important;
+          transition-duration: 0s !important;
+        }
+      }
+    `;
+      document.head.appendChild(styleSheet);
+    }
+    const pauseState = { originalStyles, pausedCount: originalStyles.size };
+    animationPauseStack.push(pauseState);
+    return pauseState;
+  }
+  function resumeAnimations(pauseState) {
+    if (!pauseState) {
+      if (animationPauseStack.length === 0) return;
+      pauseState = animationPauseStack.pop();
+    } else {
+      const index = animationPauseStack.indexOf(pauseState);
+      if (index === -1) return;
+      animationPauseStack.splice(index, 1);
+    }
+    const originalStyles = pauseState.originalStyles;
+    if (originalStyles) {
+      for (const [el, styles] of originalStyles) {
+        if (el && el.style) {
+          el.style.animationPlayState = styles.animationPlayState || "";
+          el.style.transitionProperty = styles.transitionProperty || "";
+          el.style.webkitAnimationPlayState = styles.webkitAnimationPlayState || "";
+          el.style.webkitTransitionProperty = styles.webkitTransitionProperty || "";
+        }
+      }
+    }
+    if (animationPauseStack.length === 0) {
+      const styleSheet = document.getElementById("elementfinder-animation-pause");
+      if (styleSheet) {
+        styleSheet.remove();
+      }
+    }
+  }
   function getValidTypes() {
     return Object.keys(ELEMENT_DEFINITIONS);
   }

package/index.min.js CHANGED Viewed

@@ -1 +1,15 @@
-var ElementFinder=(()=>{var M=Object.defineProperty;var j=Object.getOwnPropertyDescriptor;var _=Object.getOwnPropertyNames;var F=Object.prototype.hasOwnProperty;var U=(e,t)=>{for(var n in t)M(e,n,{get:t[n],enumerable:!0})},V=(e,t,n,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of _(t))!F.call(e,r)&&r!==n&&M(e,r,{get:()=>t[r],enumerable:!(o=j(t,r))||o.enumerable});return e};var z=e=>V(M({},"__esModule",{value:!0}),e);var oe={};U(oe,{ELEMENT_DEFINITIONS:()=>g,findElementByAttributes:()=>q,findElementByType:()=>$,findElements:()=>Q,findProbableElements:()=>v,getAllElements:()=>w,getAllFrames:()=>N,getBoundingBox:()=>x,getSearchableAttributes:()=>H,getValidAttributes:()=>re,getValidTypes:()=>ne,highlight:()=>ee,matchesAttribute:()=>y,matchesType:()=>b,parseCondition:()=>k,parseXPath:()=>p,setSearchableAttributes:()=>W,splitByOperator:()=>T,unhighlight:()=>te});var I={link:"self::a or @role='link' or @href",navigation:"@role='navigation' or self::nav",heading:"@role='heading' or self::h1 or self::h2 or self::h3 or self::h4 or self::h5 or self::h6",button:"self::button or @role='button' or @type='button' or @type='submit'",checkbox:"(self::input and @type='checkbox') or @role='checkbox'",switch:"(self::input and @type='checkbox') or @role='switch' or (self::button and (contains(@class, 'switch') or @data-state))",slider:"self::input[@type='range'] or @role='slider'",datepicker:"self::input and @type='date'",colorpicker:"self::input and @type='color'",radio:"(self::input and @type='radio') or @role='radio'",dropdown:"(self::select[descendant::option] or @role='combobox' or @role='listbox' or contains(@class, 'dropdown') or contains(@class, 'trigger') or ancestor::*[contains(@class, 'dropdown') or @role='combobox'])",textbox:"self::textarea or (self::input and (@type='text' or @type='password' or @type='search' or @type='email' or @type='number' or @type='tel' or @type='url')) or @role='textbox'",file:"self::input and @type='file'",list:"self::ul or self::ol or @role='list'",listitem:"self::li or @role='listitem'",menu:"self::menu or @role='menu'",menuitem:"@role='menuitem'",toolbar:"@role='toolbar'",dialog:"@role='dialog'",table:"self::table or @role='table'",row:"self::tr or @role='row'",column:"self::td or self::th or @role='cell' or @role='gridcell' or @role='columnheader'",cell:"self::td or @role='cell' or @role='gridcell'",image:"self::img or @role='img' or @alt",element:"true()"};var O=["placeholder","value","data-test-id","data-testid","id","resource-id","name","aria-label","hint","title","tooltip","alt","src","aria-labelledby"];var h={selfWithTag:/^self::([a-zA-Z0-9-]+)(?:\[([^\]]+)\])?$/,contains:/contains\(@([a-zA-Z0-9-]+),\s*['"]([^'"]+)['"]\)/i,attrEquals:/@([a-zA-Z0-9-]+)\s*=\s*['"]([^'"]*)['"]/,attrExists:/^@([a-zA-Z0-9-]+)$/,descendant:/descendant::([a-zA-Z0-9-]+)/i,ancestor:/ancestor::\*\[([^\]]+)\]/i,operatorOr:/^\s*\bor\b\s*/i,operatorAnd:/^\s*\band\b\s*/i},Z=100,S=new Map;for(let[e,t]of Object.entries(I))t==="true()"?S.set(e,()=>!0):S.set(e,n=>p(t,n));var E=O;function W(e){if(!Array.isArray(e))throw new TypeError("attributes must be an array");E=e}function H(){return[...E]}function p(e,t,n=0){if(e==null||t==null)return!1;if(n>Z)throw new Error("XPath expression exceeds maximum recursion depth");if(e=e.trim(),e==="true()")return!0;if(e[0]==="("&&e[e.length-1]===")"){let s=1,l=!0;for(let a=1;a<e.length-1;a++)if(e[a]==="("?s++:e[a]===")"&&s--,s===0){l=!1;break}if(l)return p(e.slice(1,-1),t,n+1)}let o=T(e,"or");if(o.length>1){for(let s of o)if(p(s,t,n+1))return!0;return!1}let r=T(e,"and");if(r.length>1){for(let s of r)if(!p(s,t,n+1))return!1;return!0}return k(e,t,n)}function T(e,t){let n=[],o=0,r="",s=!1,l="",a=t==="or"?h.operatorOr:h.operatorAnd;for(let i=0;i<e.length;i++){let f=e[i];if((f==="'"||f==='"')&&(i===0||e[i-1]!=="\\")&&(s?f===l&&(s=!1):(s=!0,l=f)),!s&&(f==="("?o++:f===")"&&o--,o===0)){let u=e.slice(i).match(a);if(u){n.push(r.trim()),i+=u[0].length-1,r="";continue}}r+=f}return r.trim()&&n.push(r.trim()),n}function k(e,t,n=0){if(e==null||t==null)return!1;e=e.trim();let o=e.match(h.selfWithTag);if(o){let f=o[1].toUpperCase();return t.tagName!==f?!1:o[2]?p(o[2],t,n+1):!0}let r=e.match(h.contains);if(r)return(t.getAttribute(r[1])||"").toLowerCase().includes(r[2].toLowerCase());let s=e.match(h.attrEquals);if(s)return t.getAttribute(s[1])===s[2];let l=e.match(h.attrExists);if(l)return t.hasAttribute(l[1]);let a=e.match(h.descendant);if(a)return t.querySelector(a[1])!==null;let i=e.match(h.ancestor);if(i){let f=t.parentElement;for(;f;){if(p(i[1],f,n+1))return!0;f=f.parentElement}return!1}return!1}var g=Object.freeze(I);function L(e){let t="";for(let n=0;n<e.childNodes.length;n++){let o=e.childNodes[n];o.nodeType===Node.TEXT_NODE&&(t+=o.textContent)}return t.trim()}function G(e){if(e.tagName==="STYLE"||e.tagName==="SCRIPT"||e.querySelector("STYLE, SCRIPT"))return!0;let t=e.parentElement;for(;t;){if(t.tagName==="STYLE"||t.tagName==="SCRIPT")return!0;t=t.parentElement}return!1}function R(e){let t=e.getAttribute("aria-labelledby");if(!t)return"";let n=t.split(/\s+/),o="";for(let r of n)try{let s=document.getElementById(r);s&&(o+=s.textContent)}catch(s){}return o}function y(e,t,n=!1){if(e==null)return!1;if(t==null||t==="")return!0;if(G(e))return!1;let o=E;for(let l=0;l<o.length;l++){let a=o[l],i;try{i=e.getAttribute(a)}catch(f){continue}if(i){if(a==="aria-labelledby"){if(n?i===t:i.includes(t))return!0;let f=R(e);if(f&&(n?f===t:f.includes(t)))return!0}else if(n?i===t:i.includes(t))return!0}}let r=L(e);if(n?r===t:r.includes(t))return!0;let s=e.textContent;return!!(n?s.trim()===t:s.includes(t))}function b(e,t){if(e==null)return!1;let n=S.get(t);return n?n(e):!1}function w(e=document){let t=[];if(e==null)return t;let n=e.nodeType===Node.DOCUMENT_NODE?e.documentElement:e;if(!n)return t;let o=[n];for(;o.length>0;){let r=o.pop();if(r.nodeType!==Node.ELEMENT_NODE||r.tagName==="SCRIPT"||r.tagName==="STYLE")continue;t.push(r);let s=r.children;for(let l=s.length-1;l>=0;l--)o.push(s[l]);try{if(r.shadowRoot){let l=r.shadowRoot.children;for(let a=l.length-1;a>=0;a--)o.push(l[a])}}catch(l){}}return t}function N(e=window){let t=[];try{t.push({window:e,document:e.document,isMainFrame:!0,frameIndex:-1});let n=e.document.querySelectorAll("iframe");for(let o=0;o<n.length;o++){let r=n[o];try{r.contentWindow&&r.contentDocument&&t.push({window:r.contentWindow,document:r.contentDocument,isMainFrame:!1,frameElement:r,frameIndex:o})}catch(s){s.name==="SecurityError"?console.warn("Skipping cross-origin iframe:",s.message):console.warn("Error accessing iframe:",s.message)}}}catch(n){console.warn("Error getting frames:",n.message)}return t}function x(e){let t=e.getBoundingClientRect();return{x:t.x,y:t.y,width:t.width,height:t.height,top:t.top,bottom:t.bottom,left:t.left,right:t.right,midx:t.x+t.width/2,midy:t.y+t.height/2,tagName:e.tagName.toLowerCase()}}function $(e="element",t=null){if(e==null&&(e="element"),typeof e!="string")throw new TypeError(`type must be a string, got ${typeof e}`);if(e&&!g[e])return console.warn(`Unknown element type: ${e}. Valid types: ${Object.keys(g).join(", ")}`),{elements:[]};let n=[],o=N(window);for(let l of o){let a=w(t||l.document);for(let i=0;i<a.length;i++){let f=a[i];e&&!b(f,e)||n.push({element:f,frame:l})}}let r=[];if(n.length>0){let l=new Set(n.map(i=>i.element)),a=new Set;for(let i=n.length-1;i>=0;i--){let f=n[i],c=f.element;if(!a.has(c)){r.unshift(f);let u=c.parentElement;for(;u;)l.has(u)&&a.add(u),u=u.parentElement}}}return{elements:r.map(l=>{let a=x(l.element),i=l.element.tagName.toLowerCase();return l.frame.isMainFrame?{element:l.element,boundingBox:a,tagName:i,frameIndex:l.frame.frameIndex}:{boundingBox:a,tagName:i,frameIndex:l.frame.frameIndex}})}}function q(e,t=!1,n=null){if(e==null&&(e=""),typeof e!="string")throw new TypeError(`value must be a string, got ${typeof e}`);let o=[],r=N(window);for(let a of r){let i=w(n||a.document);for(let f=0;f<i.length;f++){let c=i[f];y(c,e,t)&&o.push({element:c,frame:a})}}return{elements:o.filter(a=>{let i=a.element;if(B(i,e,t))return!0;for(let c of o)if(c.element!==i&&i.contains(c.element))return!1;return!0}).map(a=>{let i=x(a.element),f=a.element.tagName.toLowerCase();return a.frame.isMainFrame?{element:a.element,boundingBox:i,tagName:f,frameIndex:a.frame.frameIndex}:{boundingBox:i,tagName:f,frameIndex:a.frame.frameIndex}})}}function B(e,t,n=!1){if(t==null||t==="")return!0;let o=E;for(let s=0;s<o.length;s++){let l=o[s],a;try{a=e.getAttribute(l)}catch(i){continue}if(a){if(l==="aria-labelledby"){if(n?a===t:a.includes(t))return!0;let i=R(e);if(i&&(n?i===t:i.includes(t)))return!0}else if(n?a===t:a.includes(t))return!0}}let r=L(e);return!!(n?r===t:r.includes(t))}function Q(e=null,t=null,n=!1,o=null){if(t==null&&(t=""),e!=null){if(typeof e!="string")throw new TypeError(`type must be a string, got ${typeof e}`);if(!g[e])return console.warn(`Unknown element type: ${e}. Valid types: ${Object.keys(g).join(", ")}`),{elements:[]}}if(t!==""&&typeof t!="string")throw new TypeError(`text must be a string, got ${typeof t}`);let r=[],s=N(window);for(let i of s){let f=w(o||i.document);for(let c=0;c<f.length;c++){let u=f[c];e!=null&&!b(u,e)||t!==""&&!y(u,t,n)||r.push({element:u,frame:i})}}return{elements:(t!==""?r.filter(i=>{let f=i.element;if(B(f,t,n))return!0;for(let u of r)if(u.element!==f&&f.contains(u.element))return!1;return!0}):r).map(i=>{let f=x(i.element),c=i.element.tagName.toLowerCase();return i.frame.isMainFrame?{element:i.element,boundingBox:f,tagName:c,frameIndex:i.frame.frameIndex}:{boundingBox:f,tagName:c,frameIndex:i.frame.frameIndex}})}}function C(e){if(e.parentElement)return e.parentElement;try{let t=e.getRootNode();if(t&&t.host)return t.host}catch(t){}return null}function J(e){let t=C(e);if(!t)return[];if(t.shadowRoot)try{return Array.from(t.shadowRoot.children)}catch(n){return[]}return Array.from(t.children)}function K(e,t){let n=C(e);for(;n;){if(b(n,t))return n;n=C(n)}let o=e.children||[];for(let s of o)if(b(s,t))return s;let r=J(e);for(let s of r)if(s!==e&&b(s,t))return s;return null}function v(e,t,n=!1,o=null){let r=e!=null&&e!=="",s=t!=null&&t!=="";if(r&&!s)return $(e,o);if(!r&&s)return q(t,n,o);if(r){if(typeof e!="string")throw new TypeError(`elementType must be a string, got ${typeof e}`);if(!g[e])return console.warn(`Unknown element type: ${e}. Valid types: ${Object.keys(g).join(", ")}`),{elements:[]}}if(s&&typeof t!="string")throw new TypeError(`attributeText must be a string, got ${typeof t}`);let l=[],a=N(window);for(let c of a){let u=w(o||c.document);for(let d=0;d<u.length;d++){let m=u[d];r&&!b(m,e)||s&&!y(m,t,n)||l.push({element:m,frame:c})}}if(l.length===0&&r&&s){let c=[];for(let d of a){let m=w(o||d.document);for(let A=0;A<m.length;A++){let D=m[A];y(D,t,n)&&c.push({element:D,frame:d})}}let u=new Set;for(let d of c){let m=K(d.element,e);m&&!u.has(m)&&(u.add(m),l.push({element:m,frame:d.frame}))}}return{elements:(s?l.filter(c=>{let u=c.element;if(B(u,t,n))return!0;for(let m of l)if(m.element!==u&&u.contains(m.element))return!1;return!0}):l).map(c=>{let u=x(c.element),d=c.element.tagName.toLowerCase();return c.frame.isMainFrame?{element:c.element,boundingBox:u,tagName:d,frameIndex:c.frame.frameIndex}:{boundingBox:u,tagName:d,frameIndex:c.frame.frameIndex}})}}function P(e){return e?e&&e.elements&&Array.isArray(e.elements)?e.elements:Array.isArray(e)?e:[e]:[]}function ee(e,t="red",n=3){let o=P(e);for(let r=0;r<o.length;r++){let s=o[r],l=s.element?s.element:s;l&&l.style&&(l.style.outline=`${n}px solid ${t}`,l.style.outlineOffset="2px",l.style.boxShadow="0 0 0 2px rgba(255, 255, 255, 0.8)",l.classList.add("elementfinder-highlighted"))}}function te(e){let t=P(e);for(let n=0;n<t.length;n++){let o=t[n],r=o.element?o.element:o;r&&r.style&&(r.style.outline="",r.style.outlineOffset="",r.style.boxShadow="",r.classList.remove("elementfinder-highlighted"))}}function ne(){return Object.keys(g)}function re(){return[...E]}return z(oe);})();
+var ElementFinder=(()=>{var I=Object.defineProperty;var F=Object.getOwnPropertyDescriptor;var z=Object.getOwnPropertyNames;var U=Object.prototype.hasOwnProperty;var V=(e,t)=>{for(var n in t)I(e,n,{get:t[n],enumerable:!0})},W=(e,t,n,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of z(t))!U.call(e,r)&&r!==n&&I(e,r,{get:()=>t[r],enumerable:!(i=F(t,r))||i.enumerable});return e};var X=e=>W(I({},"__esModule",{value:!0}),e);var le={};V(le,{ELEMENT_DEFINITIONS:()=>y,findElements:()=>v,findElementsByAttribute:()=>j,findElementsByType:()=>H,findProbableElements:()=>te,getAllElements:()=>g,getAllFrames:()=>A,getBoundingBox:()=>S,getSearchableAttributes:()=>J,getValidAttributes:()=>ae,getValidTypes:()=>se,highlight:()=>ne,isHidden:()=>N,matchesAttribute:()=>E,matchesType:()=>h,parseCondition:()=>R,parseXPath:()=>b,pauseAnimations:()=>oe,resumeAnimations:()=>ie,setSearchableAttributes:()=>Q,splitByOperator:()=>B,unhighlight:()=>re});var T={link:"self::a or @role='link' or @href",navigation:"@role='navigation' or self::nav",heading:"@role='heading' or self::h1 or self::h2 or self::h3 or self::h4 or self::h5 or self::h6",button:"self::button or @role='button' or @type='button' or @type='submit'",checkbox:"(self::input and @type='checkbox') or @role='checkbox'",switch:"(self::input and @type='checkbox') or @role='switch' or (self::button and (contains(@class, 'switch') or @data-state))",slider:"self::input[@type='range'] or @role='slider'",datepicker:"self::input[@type='date'] or @role='date'",colorpicker:"self::input[@type='color'] or @role='color'",radio:"(self::input and @type='radio') or @role='radio'",dropdown:"(self::select[descendant::option] or @role='combobox' or @role='listbox' or contains(@class, 'dropdown') or contains(@class, 'trigger') or ancestor::*[contains(@class, 'dropdown') or @role='combobox'])",textbox:"self::textarea or (self::input and (@type='text' or @type='password' or @type='search' or @type='email' or @type='number' or @type='tel' or @type='url')) or @role='textbox'",file:"self::input and @type='file'",list:"self::ul or self::ol or @role='list'",listitem:"self::li or @role='listitem'",menu:"self::menu or @role='menu'",menuitem:"@role='menuitem'",toolbar:"@role='toolbar'",dialog:"@role='dialog' or @role='alertdialog'",table:"self::table or @role='table'",row:"self::tr or @role='row'",column:"self::td or self::th or @role='cell' or @role='gridcell' or @role='columnheader'",cell:"self::td or @role='cell' or @role='gridcell'",image:"self::img or @role='img' or @alt",element:"true()"};var D=["placeholder","value","data-value","data-test-id","data-testid","id","resource-id","name","aria-label","hint","title","tooltip","alt","src","aria-labelledby"];var p={selfWithTag:/^self::([a-zA-Z0-9-]+)(?:\[([^\]]+)\])?$/,contains:/contains\(@([a-zA-Z0-9-]+),\s*['"]([^'"]+)['"]\)/i,attrEquals:/@([a-zA-Z0-9-]+)\s*=\s*['"]([^'"]*)['"]/,attrExists:/^@([a-zA-Z0-9-]+)$/,descendant:/descendant::([a-zA-Z0-9-]+)/i,ancestor:/ancestor::\*\[([^\]]+)\]/i,operatorOr:/^\s*\bor\b\s*/i,operatorAnd:/^\s*\band\b\s*/i},G=100,C=new Map;for(let[e,t]of Object.entries(T))t==="true()"?C.set(e,()=>!0):C.set(e,n=>b(t,n));var x=D;function Q(e){if(!Array.isArray(e))throw new TypeError("attributes must be an array");x=e}function J(){return[...x]}function b(e,t,n=0){if(e==null||t==null)return!1;if(n>G)throw new Error("XPath expression exceeds maximum recursion depth");if(e=e.trim(),e==="true()")return!0;if(e[0]==="("&&e[e.length-1]===")"){let l=1,s=!0;for(let a=1;a<e.length-1;a++)if(e[a]==="("?l++:e[a]===")"&&l--,l===0){s=!1;break}if(s)return b(e.slice(1,-1),t,n+1)}let i=B(e,"or");if(i.length>1){for(let l of i)if(b(l,t,n+1))return!0;return!1}let r=B(e,"and");if(r.length>1){for(let l of r)if(!b(l,t,n+1))return!1;return!0}return R(e,t,n)}function B(e,t){let n=[],i=0,r="",l=!1,s="",a=t==="or"?p.operatorOr:p.operatorAnd;for(let o=0;o<e.length;o++){let f=e[o];if((f==="'"||f==='"')&&(o===0||e[o-1]!=="\\")&&(l?f===s&&(l=!1):(l=!0,s=f)),!l&&(f==="("?i++:f===")"&&i--,i===0)){let u=e.slice(o).match(a);if(u){n.push(r.trim()),o+=u[0].length-1,r="";continue}}r+=f}return r.trim()&&n.push(r.trim()),n}function R(e,t,n=0){if(e==null||t==null)return!1;e=e.trim();let i=e.match(p.selfWithTag);if(i){let f=i[1].toUpperCase();return t.tagName!==f?!1:i[2]?b(i[2],t,n+1):!0}let r=e.match(p.contains);if(r)return(t.getAttribute(r[1])||"").toLowerCase().includes(r[2].toLowerCase());let l=e.match(p.attrEquals);if(l)return t.getAttribute(l[1])===l[2];let s=e.match(p.attrExists);if(s)return t.hasAttribute(s[1]);let a=e.match(p.descendant);if(a)return t.querySelector(a[1])!==null;let o=e.match(p.ancestor);if(o){let f=t.parentElement;for(;f;){if(b(o[1],f,n+1))return!0;f=f.parentElement}return!1}return!1}var y=Object.freeze(T);function $(e){let t="";for(let n=0;n<e.childNodes.length;n++){let i=e.childNodes[n];i.nodeType===Node.TEXT_NODE&&(t+=i.textContent)}return t.trim()}function K(e){if(e.tagName==="STYLE"||e.tagName==="SCRIPT"||e.querySelector("STYLE, SCRIPT"))return!0;let t=e.parentElement;for(;t;){if(t.tagName==="STYLE"||t.tagName==="SCRIPT")return!0;t=t.parentElement}return!1}function q(e){let t=e.getAttribute("aria-labelledby");if(!t)return"";let n=t.split(/\s+/),i="";for(let r of n)try{let l=document.getElementById(r);l&&(i+=l.textContent)}catch(l){}return i}function E(e,t,n=!1){if(e==null)return!1;if(t==null||t==="")return!0;if(K(e))return!1;let i=x;for(let s=0;s<i.length;s++){let a=i[s],o;try{o=e.getAttribute(a)}catch(f){continue}if(o){if(a==="aria-labelledby"){if(n?o===t:o.includes(t))return!0;let f=q(e);if(f&&(n?f===t:f.includes(t)))return!0}else if(n?o===t:o.includes(t))return!0}}let r=$(e);if(n?r===t:r.includes(t))return!0;let l=e.textContent;return!!(n?l.trim()===t:l.includes(t))}function h(e,t){if(e==null)return!1;let n=C.get(t);return n?n(e):!1}function g(e=document){let t=[];if(e==null)return t;let n=e.nodeType===Node.DOCUMENT_NODE?e.documentElement:e;if(!n)return t;let i=[n];for(;i.length>0;){let r=i.pop();if(r.nodeType!==Node.ELEMENT_NODE||r.tagName==="SCRIPT"||r.tagName==="STYLE")continue;t.push(r);let l=r.children;for(let s=l.length-1;s>=0;s--)i.push(l[s]);try{if(r.shadowRoot){let s=r.shadowRoot.children;for(let a=s.length-1;a>=0;a--)i.push(s[a])}}catch(s){}}return t}function A(e=window){let t=[];try{t.push({window:e,document:e.document,isMainFrame:!0,frameIndex:-1});let n=e.document.querySelectorAll("iframe");for(let i=0;i<n.length;i++){let r=n[i];try{r.contentWindow&&r.contentDocument&&t.push({window:r.contentWindow,document:r.contentDocument,isMainFrame:!1,frameElement:r,frameIndex:i})}catch(l){l.name==="SecurityError"?console.warn("Skipping cross-origin iframe:",l.message):console.warn("Error accessing iframe:",l.message)}}}catch(n){console.warn("Error getting frames:",n.message)}return t}function S(e){let t=e.getBoundingClientRect();return{x:t.x,y:t.y,width:t.width,height:t.height,top:t.top,bottom:t.bottom,left:t.left,right:t.right,midx:t.x+t.width/2,midy:t.y+t.height/2,tagName:e.tagName.toLowerCase()}}function N(e){if(e==null||e.offsetWidth===0&&e.offsetHeight===0)return!0;try{let t=window.getComputedStyle(e);if(t.visibility==="hidden"||t.visibility==="collapse"||t.display==="none")return!0}catch(t){}return!!e.hasAttribute("hidden")}function H(e="element",t=null){if(e==null&&(e="element"),typeof e!="string")throw new TypeError(`type must be a string, got ${typeof e}`);if(e&&!y[e])return console.warn(`Unknown element type: ${e}. Valid types: ${Object.keys(y).join(", ")}`),{elements:[]};let n=[],i=A(window);for(let s of i){let a=g(t||s.document);for(let o=0;o<a.length;o++){let f=a[o];e&&!h(f,e)||n.push({element:f,frame:s})}}let r=[];if(n.length>0){let s=new Set(n.map(o=>o.element)),a=new Set;for(let o=n.length-1;o>=0;o--){let f=n[o],c=f.element;if(!a.has(c)){r.unshift(f);let u=c.parentElement;for(;u;)s.has(u)&&a.add(u),u=u.parentElement}}}return{elements:r.map(s=>{let a=S(s.element),o=s.element.tagName.toLowerCase(),f=N(s.element);return s.frame.isMainFrame?{element:s.element,boundingBox:a,tagName:o,frameIndex:s.frame.frameIndex,isHidden:f}:{boundingBox:a,tagName:o,frameIndex:s.frame.frameIndex,isHidden:f}})}}function j(e,t=!1,n=null){if(e==null&&(e=""),typeof e!="string")throw new TypeError(`value must be a string, got ${typeof e}`);let i=[],r=A(window);for(let a of r){let o=g(n||a.document);for(let f=0;f<o.length;f++){let c=o[f];E(c,e,t)&&i.push({element:c,frame:a})}}return{elements:i.filter(a=>{let o=a.element;if(P(o,e,t))return!0;for(let c of i)if(c.element!==o&&o.contains(c.element))return!1;return!0}).map(a=>{let o=S(a.element),f=a.element.tagName.toLowerCase(),c=N(a.element);return a.frame.isMainFrame?{element:a.element,boundingBox:o,tagName:f,frameIndex:a.frame.frameIndex,isHidden:c}:{boundingBox:o,tagName:f,frameIndex:a.frame.frameIndex,isHidden:c}})}}function P(e,t,n=!1){if(t==null||t==="")return!0;let i=x;for(let l=0;l<i.length;l++){let s=i[l],a;try{a=e.getAttribute(s)}catch(o){continue}if(a){if(s==="aria-labelledby"){if(n?a===t:a.includes(t))return!0;let o=q(e);if(o&&(n?o===t:o.includes(t)))return!0}else if(n?a===t:a.includes(t))return!0}}let r=$(e);return!!(n?r===t:r.includes(t))}function v(e=null,t=null,n=!1,i=null){if(t==null&&(t=""),e!=null){if(typeof e!="string")throw new TypeError(`type must be a string, got ${typeof e}`);if(!y[e])return console.warn(`Unknown element type: ${e}. Valid types: ${Object.keys(y).join(", ")}`),{elements:[]}}if(t!==""&&typeof t!="string")throw new TypeError(`text must be a string, got ${typeof t}`);let r=[],l=A(window);for(let o of l){let f=g(i||o.document);for(let c=0;c<f.length;c++){let u=f[c];e!=null&&!h(u,e)||t!==""&&!E(u,t,n)||r.push({element:u,frame:o})}}return{elements:(t!==""?r.filter(o=>{let f=o.element;if(P(f,t,n))return!0;for(let u of r)if(u.element!==f&&f.contains(u.element))return!1;return!0}):r).map(o=>{let f=S(o.element),c=o.element.tagName.toLowerCase(),u=N(o.element);return o.frame.isMainFrame?{element:o.element,boundingBox:f,tagName:c,frameIndex:o.frame.frameIndex,isHidden:u}:{boundingBox:f,tagName:c,frameIndex:o.frame.frameIndex,isHidden:u}})}}function O(e){if(e.parentElement)return e.parentElement;try{let t=e.getRootNode();if(t&&t.host)return t.host}catch(t){}return null}function L(e){let t=O(e);if(!t)return[];if(t.shadowRoot)try{return Array.from(t.shadowRoot.children)}catch(n){return[]}return Array.from(t.children)}function ee(e,t){let n=O(e);for(;n;){if(h(n,t))return n;n=O(n)}let i=e.children||[];for(let s of i)if(h(s,t))return s;let r=L(e);for(let s of r)if(s!==e&&h(s,t))return s;for(let s of r){if(s===e)continue;let a=g(s);for(let o=0;o<a.length;o++)if(h(a[o],t))return a[o]}let l=e.parentElement;for(;l;){let s=L(l);for(let a of s)if(a!==l){if(h(a,t))return a;let o=g(a);for(let f=0;f<o.length;f++)if(h(o[f],t))return o[f]}l=l.parentElement}return null}function te(e,t,n=!1,i=null){let r=e!=null&&e!=="",l=t!=null&&t!=="";if(r&&!l)return H(e,i);if(!r&&l)return j(t,n,i);if(r){if(typeof e!="string")throw new TypeError(`elementType must be a string, got ${typeof e}`);if(!y[e])return console.warn(`Unknown element type: ${e}. Valid types: ${Object.keys(y).join(", ")}`),{elements:[]}}if(l&&typeof t!="string")throw new TypeError(`attributeText must be a string, got ${typeof t}`);let s=[],a=A(window);for(let c of a){let u=g(i||c.document);for(let m=0;m<u.length;m++){let d=u[m];r&&!h(d,e)||l&&!E(d,t,n)||s.push({element:d,frame:c})}}if(s.length===0&&r&&l){let c=[];for(let m of a){let d=g(i||m.document);for(let M=0;M<d.length;M++){let k=d[M];E(k,t,n)&&P(k,t,n)&&c.push({element:k,frame:m})}}let u=new Set;for(let m of c){let d=ee(m.element,e);d&&!u.has(d)&&(u.add(d),s.push({element:d,frame:m.frame}))}}return{elements:(l?s.filter(c=>{let u=c.element;if(P(u,t,n))return!0;for(let d of s)if(d.element!==u&&u.contains(d.element))return!1;return!0}):s).map(c=>{let u=S(c.element),m=c.element.tagName.toLowerCase(),d=N(c.element);return c.frame.isMainFrame?{element:c.element,boundingBox:u,tagName:m,frameIndex:c.frame.frameIndex,isHidden:d}:{boundingBox:u,tagName:m,frameIndex:c.frame.frameIndex,isHidden:d}})}}function _(e){return e?e&&e.elements&&Array.isArray(e.elements)?e.elements:Array.isArray(e)?e:[e]:[]}function ne(e,t="red",n=3){let i=_(e);for(let r=0;r<i.length;r++){let l=i[r],s=l.element?l.element:l;s&&s.style&&(s.style.outline=`${n}px solid ${t}`,s.style.outlineOffset="2px",s.style.boxShadow="0 0 0 2px rgba(255, 255, 255, 0.8)",s.classList.add("elementfinder-highlighted"))}}function re(e){let t=_(e);for(let n=0;n<t.length;n++){let i=t[n],r=i.element?i.element:i;r&&r.style&&(r.style.outline="",r.style.outlineOffset="",r.style.boxShadow="",r.classList.remove("elementfinder-highlighted"))}}var w=[];function oe(){let e=new Map,t=g();for(let r of t)r&&r.style&&r.style.animationPlayState!=="paused"&&(e.set(r,{animationPlayState:r.style.animationPlayState,transitionProperty:r.style.transitionProperty,webkitAnimationPlayState:r.style.webkitAnimationPlayState,webkitTransitionProperty:r.style.webkitTransitionProperty}),r.style.animationPlayState="paused",r.style.transitionProperty="none",r.style.webkitAnimationPlayState="paused",r.style.webkitTransitionProperty="none");let n=document.getElementById("elementfinder-animation-pause");n||(n=document.createElement("style"),n.id="elementfinder-animation-pause",n.textContent=`
+      *, *::before, *::after {
+        animation-play-state: paused !important;
+        transition-property: none !important;
+        -webkit-animation-play-state: paused !important;
+        -webkit-transition-property: none !important;
+      }
+      @media (prefers-reduced-motion: no-preference) {
+        *, *::before, *::after {
+          animation-duration: 0s !important;
+          animation-iteration-count: 1 !important;
+          transition-duration: 0s !important;
+        }
+      }
+    `,document.head.appendChild(n));let i={originalStyles:e,pausedCount:e.size};return w.push(i),i}function ie(e){if(e){let n=w.indexOf(e);if(n===-1)return;w.splice(n,1)}else{if(w.length===0)return;e=w.pop()}let t=e.originalStyles;if(t)for(let[n,i]of t)n&&n.style&&(n.style.animationPlayState=i.animationPlayState||"",n.style.transitionProperty=i.transitionProperty||"",n.style.webkitAnimationPlayState=i.webkitAnimationPlayState||"",n.style.webkitTransitionProperty=i.webkitTransitionProperty||"");if(w.length===0){let n=document.getElementById("elementfinder-animation-pause");n&&n.remove()}}function se(){return Object.keys(y)}function ae(){return[...x]}return X(le);})();

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@nodebug/browser-element-finder",
-  "version": "1.1.6",
+  "version": "1.1.8",
   "description": "Browser Element Finder - Find elements by type and text content",
   "exports": {
     ".": {

package/src/element-definitions.json CHANGED Viewed

@@ -6,8 +6,8 @@
   "checkbox": "(self::input and @type='checkbox') or @role='checkbox'",
   "switch": "(self::input and @type='checkbox') or @role='switch' or (self::button and (contains(@class, 'switch') or @data-state))",
   "slider": "self::input[@type='range'] or @role='slider'",
-  "datepicker": "self::input and @type='date'",
-  "colorpicker": "self::input and @type='color'",
+  "datepicker": "self::input[@type='date'] or @role='date'",
+  "colorpicker": "self::input[@type='color'] or @role='color'",
   "radio": "(self::input and @type='radio') or @role='radio'",
   "dropdown": "(self::select[descendant::option] or @role='combobox' or @role='listbox' or contains(@class, 'dropdown') or contains(@class, 'trigger') or ancestor::*[contains(@class, 'dropdown') or @role='combobox'])",
   "textbox": "self::textarea or (self::input and (@type='text' or @type='password' or @type='search' or @type='email' or @type='number' or @type='tel' or @type='url')) or @role='textbox'",
@@ -17,7 +17,7 @@
   "menu": "self::menu or @role='menu'",
   "menuitem": "@role='menuitem'",
   "toolbar": "@role='toolbar'",
-  "dialog": "@role='dialog'",
+  "dialog": "@role='dialog' or @role='alertdialog'",
   "table": "self::table or @role='table'",
   "row": "self::tr or @role='row'",
   "column": "self::td or self::th or @role='cell' or @role='gridcell' or @role='columnheader'",

package/src/searchable-attributes.json CHANGED Viewed

@@ -1,6 +1,7 @@
 [
   "placeholder",
   "value",
+  "data-value",
   "data-test-id",
   "data-testid",
   "id",