npm - @nodebug/browser-element-finder - Versions diffs - 1.1.7 → 1.1.9 - Mend

@nodebug/browser-element-finder 1.1.7 → 1.1.9

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 +233 -81
package/index.js +351 -21
package/index.min.js +15 -1
package/package.json +9 -14
package/src/element-definitions.json +1 -1
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.**
 ---
@@ -18,6 +20,14 @@ const results = ElementFinder.findElements('button', 'Submit')
 // Find by text only (any type)
 const results = ElementFinder.findElements(null, 'seleniumbase')
+// Count semantic element types on the screen
+const counts = ElementFinder.getElementCounts()
+// Returns counts for all defined non-generic types, excluding `element`
+// Count one semantic type
+const buttonCount = ElementFinder.getElementCounts('button')
+// Returns `{ button: 3 }`
 // Find in all frames (default)
 const results = ElementFinder.findElements('button')
@@ -43,6 +53,7 @@ results.elements.forEach((e) => {
 - For iframe results, switch context before interacting (see Selenium/Playwright docs)
 - Use `getValidTypes()` to enumerate all supported semantic types
 - Use `getSearchableAttributes()` to see which attributes are searched for text
+- Use `getSearchableAttributeValues(element)` to inspect which searchable attributes are present on a specific element
 ---
@@ -52,7 +63,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 +103,18 @@ 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')
+// Count element types
+const counts = ElementFinder.getElementCounts()
+// Count one type
+const buttonCount = ElementFinder.getElementCounts('button')
 // Check visibility of found elements
 results.elements.forEach((e) => {
-  console.log('Visible:', e.isVisible)
+  console.log('Hidden:', e.isHidden)
 })
 ```
@@ -113,7 +128,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,14 +140,72 @@ 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',
+])
+```
+### Inspecting Attribute Values
+Use `getSearchableAttributeValues(element)` to inspect which current searchable attributes are present on a specific element and what values they contain.
+```js
+const input = document.querySelector('input')
+const values = ElementFinder.getSearchableAttributeValues(input)
+console.log(values)
+// { placeholder: 'Email', 'data-testid': 'email-input', id: 'email' }
+```
+The returned object only includes searchable attributes that exist on the element and have non-empty values. It respects any custom attribute order set with `setSearchableAttributes()`.
+### 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:
 ```javascript
 // ESM - Import JSON directly
-import ELEMENT_DEFINITIONS from '@nodebug/browser-element-finder/element-definitions.json' assert { type: 'json' }
-import SEARCHABLE_ATTRIBUTES from '@nodebug/browser-element-finder/searchable-attributes.json' assert { type: 'json' }
+import ELEMENT_DEFINITIONS from '@nodebug/browser-element-finder/element-definitions.json' with { type: 'json' }
+import SEARCHABLE_ATTRIBUTES from '@nodebug/browser-element-finder/searchable-attributes.json' with { type: 'json' }
 // Get all valid element types
 console.log(Object.keys(ELEMENT_DEFINITIONS)) // ['button', 'checkbox', 'dropdown', ...]
@@ -141,34 +214,37 @@ console.log(Object.keys(ELEMENT_DEFINITIONS)) // ['button', 'checkbox', 'dropdow
 console.log(SEARCHABLE_ATTRIBUTES) // ['placeholder', 'value', 'data-test-id', ...]
 ```
-```javascript
-// CommonJS - Use require
-const ELEMENT_DEFINITIONS = require('@nodebug/browser-element-finder/element-definitions.json')
-const SEARCHABLE_ATTRIBUTES = require('@nodebug/browser-element-finder/searchable-attributes.json')
-```
+The package is ESM-only (`"type": "module"`), so CommonJS `require()` examples are not supported.
 ---
 ## 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: [...] }`                               |
+| `getElementCounts(type, parent)`                  | Count elements by semantic type, excluding generic `element` by default                      |
+| `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                                                            |
+| `getSearchableAttributeValues(element)`           | Get current non-empty searchable attribute values from an element                            |
+| `getElementDescriptor(element)`                   | Get identifiable text, source attribute, occurrence index, type, and tag name for an element |
+| `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)               |
 ---
@@ -176,17 +252,18 @@ const SEARCHABLE_ATTRIBUTES = require('@nodebug/browser-element-finder/searchabl
 Finds elements matching the specified type and/or text. Combines type and attribute matching in a single call. Searches all frames (main document + iframes) by default.
-| Parameter | Type      | Default | Description                                                                                                      |
-| --------- | --------- | ------- | ---------------------------------------------------------------------------------------------------------------- |
-| `type`    | `string`  | `null`  | Element type (see supported types below). If `null`, matches any type. Throws `TypeError` for non-string values. |
-| `text`    | `string`  | `null`  | Text to search for in content/attributes. If `null`/`''`/`undefined`, matches any text.                          |
-| `exact`   | `boolean` | `false` | Exact text match vs substring (only used when text is provided)                                                  |
-| `parent`  | `Element` | `null`  | Parent element to search within                                                                                  |
+| Parameter | Type      | Default | Description                                                                                                                     |
+| --------- | --------- | ------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| `type`    | `string`  | `null`  | Element type (see supported types below). If `null` or `undefined`, matches any type. Throws `TypeError` for non-string values. |
+| `text`    | `string`  | `null`  | Text to search for in content/attributes. If `null`/`''`/`undefined`, matches any text.                                         |
+| `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 +280,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 +297,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 +342,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.
@@ -277,6 +358,47 @@ Sets custom searchable attributes.
 Returns the current searchable attributes array.
+### `getElementDescriptor(element)`
+Returns identifiable text for a DOM element, plus structured metadata about where it came from, its 1-based occurrence index, its semantic type, and its HTML tag name. Uniqueness can be inferred from `index`: `index === 1` means the identifiable text is unique within the current frame.
+```javascript
+const descriptor = ElementFinder.getElementDescriptor(element)
+```
+**Returns**:
+```javascript
+{
+  identifiableText: 'Save', // Plain searchable text only; no CSS/XPath/index syntax
+  attributeName: 'title',   // Attribute name, or 'text' for direct/textContent fallback
+  index: 2,                 // 1-based occurrence index; index > 1 means not unique
+  type: 'button',           // Semantic element type, or null for non-elements
+  tagName: 'button'         // Lowercase HTML tag name, or null for non-elements
+}
+```
+Descriptor selection follows the same searchable-attribute priority as text search:
+1. First non-empty searchable attribute value is used.
+2. `aria-labelledby` is resolved to referenced element text before returning the identifiable text.
+3. `src` values are returned as the image filename without path, query string, fragment, or extension.
+4. If no searchable attribute exists, direct text nodes are used and `attributeName` is set to `'text'`.
+5. If direct text is empty, trimmed full `textContent` is used and `attributeName` is set to `'text'`.
+6. If no text exists, `identifiableText` and `attributeName` are `null`, but `index`, `type`, and `tagName` are still returned.
+Null or non-element input returns:
+```javascript
+{
+  identifiableText: null,
+  attributeName: null,
+  index: 1,
+  type: null,
+  tagName: null
+}
+```
 ### `matchesType(el, type)`
 Checks if an element matches the specified type definition.
@@ -285,7 +407,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 +416,37 @@ 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)`
+### `getElementCounts(type, parent)`
+Counts elements by semantic type on the current screen. Searches all frames (main document + iframes) by default.
+| Parameter | Type      | Default | Description                                                                                                   |
+| --------- | --------- | ------- | ------------------------------------------------------------------------------------------------------------- |
+| `type`    | `string`  | `null`  | Specific element type to count. If `null`/`undefined`, returns counts for all defined types except `element`. |
+| `parent`  | `Element` | `null`  | Parent element to count within                                                                                |
+**Returns**: `Object.<string, number>` keyed by semantic element type.
+```javascript
+// Count all defined non-generic types
+const counts = ElementFinder.getElementCounts()
+// { button: 3, textbox: 2, link: 1, ... }
+// Count one type
+const buttons = ElementFinder.getElementCounts('button')
+// { button: 3 }
+// Count within a parent element
+const inputs = ElementFinder.getElementCounts(
+  'textbox',
+  document.querySelector('form'),
+)
+// { textbox: 2 }
+```
+The generic `element` type is excluded from the all-types count so the result contains only semantic types such as `button`, `textbox`, `link`, and `table`.
+### `findElementsByAttribute(value, exact, parent)`
 Finds elements by text/attribute value only. Searches all frames by default.
@@ -329,7 +481,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 +504,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 +515,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 +525,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                                                                                 |
 ---
@@ -416,19 +568,19 @@ Both `column` and `cell` types find table cells, but they behave differently:
 ```javascript
 // Find all cells in the "City" column (header + 3 data cells = 4 total)
-const columnResult = ElementFinder.findElement('column', 'City')
+const columnResult = ElementFinder.findElements('column', 'City')
 // Returns: [th:City, td:New York, td:London, td:Paris]
 // Find all cells when searching for a data cell value
-const columnResult2 = ElementFinder.findElement('column', 'Paris')
+const columnResult2 = ElementFinder.findElements('column', 'Paris')
 // Returns: [th:City, td:New York, td:London, td:Paris]
 // Find only the specific cell containing "Paris"
-const cellResult = ElementFinder.findElement('cell', 'Paris')
+const cellResult = ElementFinder.findElements('cell', 'Paris')
 // Returns: [td:Paris]
 // Find by header text with cell type - returns only the header cell
-const headerCell = ElementFinder.findElement('cell', 'City')
+const headerCell = ElementFinder.findElements('cell', 'City')
 // Returns: [] (no td elements match "City" header text)
 ```
@@ -438,8 +590,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,21 +21,27 @@ 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,
     getBoundingBox: () => getBoundingBox,
+    getElementCounts: () => getElementCounts,
+    getElementDescriptor: () => getElementDescriptor,
+    getSearchableAttributeValues: () => getSearchableAttributeValues,
     getSearchableAttributes: () => getSearchableAttributes,
     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
@@ -61,7 +67,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 +80,7 @@ var ElementFinder = (() => {
   var searchable_attributes_default = [
     "placeholder",
     "value",
+    "data-value",
     "data-test-id",
     "data-testid",
     "id",
@@ -118,6 +125,156 @@ var ElementFinder = (() => {
   function getSearchableAttributes() {
     return [...SEARCHABLE_ATTRIBUTES];
   }
+  function getSearchableAttributeValues(el) {
+    if (el == null || el.nodeType !== Node.ELEMENT_NODE) return {};
+    const values = {};
+    const attrs = SEARCHABLE_ATTRIBUTES;
+    for (let i = 0; i < attrs.length; i++) {
+      const attr = attrs[i];
+      let attrValue;
+      try {
+        attrValue = el.getAttribute(attr);
+      } catch (e) {
+        continue;
+      }
+      if (attrValue !== null && attrValue !== void 0 && attrValue !== "") {
+        values[attr] = attrValue;
+      }
+    }
+    return values;
+  }
+  function normalizeDescriptorText(text) {
+    if (text == null) return "";
+    return String(text).replace(/\s+/g, " ").trim();
+  }
+  function getImageFilenameWithoutExtension(src) {
+    const normalizedSrc = normalizeDescriptorText(src);
+    if (!normalizedSrc) return "";
+    const withoutQueryOrFragment = normalizedSrc.split(/[?#]/)[0];
+    const lastSlashIndex = Math.max(
+      withoutQueryOrFragment.lastIndexOf("/"),
+      withoutQueryOrFragment.lastIndexOf("\\")
+    );
+    const filenameWithExtension = lastSlashIndex >= 0 ? withoutQueryOrFragment.slice(lastSlashIndex + 1) : withoutQueryOrFragment;
+    const lastDotIndex = filenameWithExtension.lastIndexOf(".");
+    return lastDotIndex > 0 ? filenameWithExtension.slice(0, lastDotIndex) : filenameWithExtension;
+  }
+  function getResolvedAriaLabelledByText(el) {
+    const labelledBy = el.getAttribute("aria-labelledby");
+    if (!labelledBy) return "";
+    const ids = labelledBy.split(/\s+/);
+    const ownerDocument = el.ownerDocument || document;
+    let text = "";
+    for (const id of ids) {
+      try {
+        const refEl = ownerDocument.getElementById(id);
+        if (!refEl) continue;
+        const refText = normalizeDescriptorText(refEl.textContent);
+        if (refText) {
+          text = text ? `${text} ${refText}` : refText;
+        }
+      } catch (e) {
+      }
+    }
+    return text;
+  }
+  function getElementDescriptorText(el) {
+    const values = getSearchableAttributeValues(el);
+    const attrs = SEARCHABLE_ATTRIBUTES;
+    for (let i = 0; i < attrs.length; i++) {
+      const attr = attrs[i];
+      if (!Object.prototype.hasOwnProperty.call(values, attr)) continue;
+      const rawText = attr === "aria-labelledby" ? getResolvedAriaLabelledByText(el) : attr === "src" ? getImageFilenameWithoutExtension(values[attr]) : values[attr];
+      const identifiableText = normalizeDescriptorText(rawText);
+      if (identifiableText) {
+        return { attributeName: attr, identifiableText };
+      }
+    }
+    const directText = normalizeDescriptorText(getDirectText(el));
+    if (directText) {
+      return { attributeName: "text", identifiableText: directText };
+    }
+    const fullText = normalizeDescriptorText(el.textContent);
+    if (fullText) {
+      return { attributeName: "text", identifiableText: fullText };
+    }
+    return null;
+  }
+  function getElementDescriptorFrame(el) {
+    if (!el || !el.ownerDocument) return null;
+    try {
+      const frames = getAllFrames(window);
+      for (let i = 0; i < frames.length; i++) {
+        if (frames[i].document === el.ownerDocument) {
+          return frames[i].document;
+        }
+      }
+    } catch (e) {
+    }
+    return el.ownerDocument;
+  }
+  function getElementDescriptorUniqueness(el, text) {
+    const root = getElementDescriptorFrame(el);
+    if (!root) {
+      return { index: 1 };
+    }
+    const elements = getAllElements(root);
+    let index = 1;
+    let count = 0;
+    for (let i = 0; i < elements.length; i++) {
+      const candidate = elements[i];
+      if (candidate !== el && (candidate === root.documentElement || candidate.tagName === "BODY")) {
+        continue;
+      }
+      const candidateDescriptor = getElementDescriptorText(candidate);
+      if (!candidateDescriptor || candidateDescriptor.identifiableText !== text) continue;
+      count++;
+      if (candidate === el) {
+        index = count;
+      }
+    }
+    return { index };
+  }
+  function getElementDescriptorType(el) {
+    if (el == null || el.nodeType !== Node.ELEMENT_NODE) return null;
+    const types = Object.keys(ELEMENT_DEFINITIONS);
+    for (let i = 0; i < types.length; i++) {
+      const type = types[i];
+      if (type === "element") continue;
+      if (matchesType(el, type)) return type;
+    }
+    return "element";
+  }
+  function getElementDescriptor(el) {
+    if (el == null || el.nodeType !== Node.ELEMENT_NODE) {
+      return {
+        identifiableText: null,
+        attributeName: null,
+        index: 1,
+        type: null,
+        tagName: null
+      };
+    }
+    const type = getElementDescriptorType(el);
+    const descriptorSource = getElementDescriptorText(el);
+    if (!descriptorSource) {
+      return {
+        identifiableText: null,
+        attributeName: null,
+        index: 1,
+        type,
+        tagName: el.tagName.toLowerCase()
+      };
+    }
+    const uniqueness = getElementDescriptorUniqueness(el, descriptorSource.identifiableText);
+    return {
+      identifiableText: descriptorSource.identifiableText,
+      attributeName: descriptorSource.attributeName,
+      index: uniqueness.index,
+      type,
+      tagName: el.tagName.toLowerCase()
+    };
+  }
   function parseXPath(expr, el, depth = 0) {
     if (expr == null || el == null) return false;
     if (depth > MAX_RECURSION_DEPTH) {
@@ -387,15 +544,40 @@ 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, options = null) {
     if (type === null || type === void 0) {
       type = "element";
     }
     if (typeof type !== "string") {
       throw new TypeError(`type must be a string, got ${typeof type}`);
     }
+    const failOnUnknownType = options && options.failOnUnknownType === true;
     if (type && !ELEMENT_DEFINITIONS[type]) {
-      console.warn(`Unknown element type: ${type}. Valid types: ${Object.keys(ELEMENT_DEFINITIONS).join(", ")}`);
+      const message = `Unknown element type: ${type}. Valid types: ${Object.keys(ELEMENT_DEFINITIONS).join(", ")}`;
+      if (failOnUnknownType) {
+        throw new TypeError(`Unknown element type: ${type}`);
+      }
+      console.warn(message);
       return { elements: [] };
     }
     const matches = [];
@@ -430,23 +612,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 +662,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 };
@@ -526,7 +714,43 @@ var ElementFinder = (() => {
     }
     return false;
   }
-  function findElements(type = null, text = null, exact = false, parent = null) {
+  function getElementCounts(type = null, parent = null, options = null) {
+    const hasType = type !== null && type !== void 0;
+    if (hasType) {
+      if (typeof type !== "string") {
+        throw new TypeError(`type must be a string, got ${typeof type}`);
+      }
+      if (!ELEMENT_DEFINITIONS[type]) {
+        const message = `Unknown element type: ${type}. Valid types: ${Object.keys(ELEMENT_DEFINITIONS).join(", ")}`;
+        if (options && options.failOnUnknownType === true) {
+          throw new TypeError(`Unknown element type: ${type}`);
+        }
+        console.warn(message);
+        return { [type]: 0 };
+      }
+    }
+    const counts = {};
+    const targetTypes = hasType ? [type] : Object.keys(ELEMENT_DEFINITIONS).filter((item) => item !== "element");
+    for (let i = 0; i < targetTypes.length; i++) {
+      counts[targetTypes[i]] = 0;
+    }
+    const frames = getAllFrames(window);
+    for (let i = 0; i < frames.length; i++) {
+      const frame = frames[i];
+      const allElements = getAllElements(parent || frame.document);
+      for (let j = 0; j < allElements.length; j++) {
+        const el = allElements[j];
+        for (let k = 0; k < targetTypes.length; k++) {
+          const targetType = targetTypes[k];
+          if (matchesType(el, targetType)) {
+            counts[targetType] += 1;
+          }
+        }
+      }
+    }
+    return counts;
+  }
+  function findElements(type = null, text = null, exact = false, parent = null, options = null) {
     if (text === null || text === void 0) {
       text = "";
     }
@@ -535,7 +759,11 @@ var ElementFinder = (() => {
         throw new TypeError(`type must be a string, got ${typeof type}`);
       }
       if (!ELEMENT_DEFINITIONS[type]) {
-        console.warn(`Unknown element type: ${type}. Valid types: ${Object.keys(ELEMENT_DEFINITIONS).join(", ")}`);
+        const message = `Unknown element type: ${type}. Valid types: ${Object.keys(ELEMENT_DEFINITIONS).join(", ")}`;
+        if (options && options.failOnUnknownType === true) {
+          throw new TypeError(`Unknown element type: ${type}`);
+        }
+        console.warn(message);
         return { elements: [] };
       }
     }
@@ -567,18 +795,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 };
@@ -637,23 +868,45 @@ var ElementFinder = (() => {
         }
       }
     }
+    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) {
+  function findProbableElements(elementType, attributeText, exact = false, parent = null, options = 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, options);
     }
     if (!hasType && hasText) {
-      return findElementByAttributes(attributeText, exact, parent);
+      return findElementsByAttribute(attributeText, exact, parent);
     }
     if (hasType) {
       if (typeof elementType !== "string") {
         throw new TypeError(`elementType must be a string, got ${typeof elementType}`);
       }
       if (!ELEMENT_DEFINITIONS[elementType]) {
-        console.warn(`Unknown element type: ${elementType}. Valid types: ${Object.keys(ELEMENT_DEFINITIONS).join(", ")}`);
+        const message = `Unknown element type: ${elementType}. Valid types: ${Object.keys(ELEMENT_DEFINITIONS).join(", ")}`;
+        if (options && options.failOnUnknownType === true) {
+          throw new TypeError(`Unknown element type: ${elementType}`);
+        }
+        console.warn(message);
         return { elements: [] };
       }
     }
@@ -680,7 +933,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();
@@ -706,18 +961,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 };
@@ -755,6 +1013,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,i)=>{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:!(i=j(t,r))||i.enumerable});return e};var z=e=>V(M({},"__esModule",{value:!0}),e);var oe={};U(oe,{ELEMENT_DEFINITIONS:()=>p,findElementByAttributes:()=>q,findElementByType:()=>$,findElements:()=>Q,findProbableElements:()=>v,getAllElements:()=>w,getAllFrames:()=>N,getBoundingBox:()=>x,getSearchableAttributes:()=>H,getValidAttributes:()=>re,getValidTypes:()=>ne,highlight:()=>ee,matchesAttribute:()=>y,matchesType:()=>g,parseCondition:()=>k,parseXPath:()=>b,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[@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'",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=>b(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 b(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 o=1,l=!0;for(let a=1;a<e.length-1;a++)if(e[a]==="("?o++:e[a]===")"&&o--,o===0){l=!1;break}if(l)return b(e.slice(1,-1),t,n+1)}let i=T(e,"or");if(i.length>1){for(let o of i)if(b(o,t,n+1))return!0;return!1}let r=T(e,"and");if(r.length>1){for(let o of r)if(!b(o,t,n+1))return!1;return!0}return k(e,t,n)}function T(e,t){let n=[],i=0,r="",o=!1,l="",a=t==="or"?h.operatorOr:h.operatorAnd;for(let s=0;s<e.length;s++){let f=e[s];if((f==="'"||f==='"')&&(s===0||e[s-1]!=="\\")&&(o?f===l&&(o=!1):(o=!0,l=f)),!o&&(f==="("?i++:f===")"&&i--,i===0)){let u=e.slice(s).match(a);if(u){n.push(r.trim()),s+=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 i=e.match(h.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(h.contains);if(r)return(t.getAttribute(r[1])||"").toLowerCase().includes(r[2].toLowerCase());let o=e.match(h.attrEquals);if(o)return t.getAttribute(o[1])===o[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 s=e.match(h.ancestor);if(s){let f=t.parentElement;for(;f;){if(b(s[1],f,n+1))return!0;f=f.parentElement}return!1}return!1}var p=Object.freeze(I);function L(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 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+/),i="";for(let r of n)try{let o=document.getElementById(r);o&&(i+=o.textContent)}catch(o){}return i}function y(e,t,n=!1){if(e==null)return!1;if(t==null||t==="")return!0;if(G(e))return!1;let i=E;for(let l=0;l<i.length;l++){let a=i[l],s;try{s=e.getAttribute(a)}catch(f){continue}if(s){if(a==="aria-labelledby"){if(n?s===t:s.includes(t))return!0;let f=R(e);if(f&&(n?f===t:f.includes(t)))return!0}else if(n?s===t:s.includes(t))return!0}}let r=L(e);if(n?r===t:r.includes(t))return!0;let o=e.textContent;return!!(n?o.trim()===t:o.includes(t))}function g(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 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 o=r.children;for(let l=o.length-1;l>=0;l--)i.push(o[l]);try{if(r.shadowRoot){let l=r.shadowRoot.children;for(let a=l.length-1;a>=0;a--)i.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 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(o){o.name==="SecurityError"?console.warn("Skipping cross-origin iframe:",o.message):console.warn("Error accessing iframe:",o.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&&!p[e])return console.warn(`Unknown element type: ${e}. Valid types: ${Object.keys(p).join(", ")}`),{elements:[]};let n=[],i=N(window);for(let l of i){let a=w(t||l.document);for(let s=0;s<a.length;s++){let f=a[s];e&&!g(f,e)||n.push({element:f,frame:l})}}let r=[];if(n.length>0){let l=new Set(n.map(s=>s.element)),a=new Set;for(let s=n.length-1;s>=0;s--){let f=n[s],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),s=l.element.tagName.toLowerCase();return l.frame.isMainFrame?{element:l.element,boundingBox:a,tagName:s,frameIndex:l.frame.frameIndex}:{boundingBox:a,tagName:s,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 i=[],r=N(window);for(let a of r){let s=w(n||a.document);for(let f=0;f<s.length;f++){let c=s[f];y(c,e,t)&&i.push({element:c,frame:a})}}return{elements:i.filter(a=>{let s=a.element;if(B(s,e,t))return!0;for(let c of i)if(c.element!==s&&s.contains(c.element))return!1;return!0}).map(a=>{let s=x(a.element),f=a.element.tagName.toLowerCase();return a.frame.isMainFrame?{element:a.element,boundingBox:s,tagName:f,frameIndex:a.frame.frameIndex}:{boundingBox:s,tagName:f,frameIndex:a.frame.frameIndex}})}}function B(e,t,n=!1){if(t==null||t==="")return!0;let i=E;for(let o=0;o<i.length;o++){let l=i[o],a;try{a=e.getAttribute(l)}catch(s){continue}if(a){if(l==="aria-labelledby"){if(n?a===t:a.includes(t))return!0;let s=R(e);if(s&&(n?s===t:s.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,i=null){if(t==null&&(t=""),e!=null){if(typeof e!="string")throw new TypeError(`type must be a string, got ${typeof e}`);if(!p[e])return console.warn(`Unknown element type: ${e}. Valid types: ${Object.keys(p).join(", ")}`),{elements:[]}}if(t!==""&&typeof t!="string")throw new TypeError(`text must be a string, got ${typeof t}`);let r=[],o=N(window);for(let s of o){let f=w(i||s.document);for(let c=0;c<f.length;c++){let u=f[c];e!=null&&!g(u,e)||t!==""&&!y(u,t,n)||r.push({element:u,frame:s})}}return{elements:(t!==""?r.filter(s=>{let f=s.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(s=>{let f=x(s.element),c=s.element.tagName.toLowerCase();return s.frame.isMainFrame?{element:s.element,boundingBox:f,tagName:c,frameIndex:s.frame.frameIndex}:{boundingBox:f,tagName:c,frameIndex:s.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(g(n,t))return n;n=C(n)}let i=e.children||[];for(let o of i)if(g(o,t))return o;let r=J(e);for(let o of r)if(o!==e&&g(o,t))return o;for(let o of r){if(o===e)continue;let l=w(o);for(let a=0;a<l.length;a++)if(g(l[a],t))return l[a]}return null}function v(e,t,n=!1,i=null){let r=e!=null&&e!=="",o=t!=null&&t!=="";if(r&&!o)return $(e,i);if(!r&&o)return q(t,n,i);if(r){if(typeof e!="string")throw new TypeError(`elementType must be a string, got ${typeof e}`);if(!p[e])return console.warn(`Unknown element type: ${e}. Valid types: ${Object.keys(p).join(", ")}`),{elements:[]}}if(o&&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(i||c.document);for(let d=0;d<u.length;d++){let m=u[d];r&&!g(m,e)||o&&!y(m,t,n)||l.push({element:m,frame:c})}}if(l.length===0&&r&&o){let c=[];for(let d of a){let m=w(i||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:(o?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 i=P(e);for(let r=0;r<i.length;r++){let o=i[r],l=o.element?o.element:o;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 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"))}}function ne(){return Object.keys(p)}function re(){return[...E]}return z(oe);})();
+var ElementFinder=(()=>{var P=Object.defineProperty;var W=Object.getOwnPropertyDescriptor;var Y=Object.getOwnPropertyNames;var X=Object.prototype.hasOwnProperty;var Z=(e,t)=>{for(var n in t)P(e,n,{get:t[n],enumerable:!0})},Q=(e,t,n,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of Y(t))!X.call(e,r)&&r!==n&&P(e,r,{get:()=>t[r],enumerable:!(o=W(t,r))||o.enumerable});return e};var G=e=>Q(P({},"__esModule",{value:!0}),e);var we={};Z(we,{ELEMENT_DEFINITIONS:()=>p,findElements:()=>ce,findElementsByAttribute:()=>V,findElementsByType:()=>F,findProbableElements:()=>me,getAllElements:()=>y,getAllFrames:()=>x,getBoundingBox:()=>A,getElementCounts:()=>fe,getElementDescriptor:()=>le,getSearchableAttributeValues:()=>j,getSearchableAttributes:()=>te,getValidAttributes:()=>be,getValidTypes:()=>ye,highlight:()=>de,isHidden:()=>k,matchesAttribute:()=>S,matchesType:()=>g,parseCondition:()=>H,parseXPath:()=>w,pauseAnimations:()=>ge,resumeAnimations:()=>pe,setSearchableAttributes:()=>ee,splitByOperator:()=>B,unhighlight:()=>he});var D={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 R=["placeholder","value","data-value","data-test-id","data-testid","id","resource-id","name","aria-label","hint","title","tooltip","alt","src","aria-labelledby"];var b={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},v=100,C=new Map;for(let[e,t]of Object.entries(D))t==="true()"?C.set(e,()=>!0):C.set(e,n=>w(t,n));var E=R;function ee(e){if(!Array.isArray(e))throw new TypeError("attributes must be an array");E=e}function te(){return[...E]}function j(e){if(e==null||e.nodeType!==Node.ELEMENT_NODE)return{};let t={},n=E;for(let o=0;o<n.length;o++){let r=n[o],i;try{i=e.getAttribute(r)}catch(l){continue}i!=null&&i!==""&&(t[r]=i)}return t}function T(e){return e==null?"":String(e).replace(/\s+/g," ").trim()}function ne(e){let t=T(e);if(!t)return"";let n=t.split(/[?#]/)[0],o=Math.max(n.lastIndexOf("/"),n.lastIndexOf("\\")),r=o>=0?n.slice(o+1):n,i=r.lastIndexOf(".");return i>0?r.slice(0,i):r}function re(e){let t=e.getAttribute("aria-labelledby");if(!t)return"";let n=t.split(/\s+/),o=e.ownerDocument||document,r="";for(let i of n)try{let l=o.getElementById(i);if(!l)continue;let s=T(l.textContent);s&&(r=r?`${r} ${s}`:s)}catch(l){}return r}function q(e){let t=j(e),n=E;for(let i=0;i<n.length;i++){let l=n[i];if(!Object.prototype.hasOwnProperty.call(t,l))continue;let s=l==="aria-labelledby"?re(e):l==="src"?ne(t[l]):t[l],a=T(s);if(a)return{attributeName:l,identifiableText:a}}let o=T(L(e));if(o)return{attributeName:"text",identifiableText:o};let r=T(e.textContent);return r?{attributeName:"text",identifiableText:r}:null}function oe(e){if(!e||!e.ownerDocument)return null;try{let t=x(window);for(let n=0;n<t.length;n++)if(t[n].document===e.ownerDocument)return t[n].document}catch(t){}return e.ownerDocument}function ie(e,t){let n=oe(e);if(!n)return{index:1};let o=y(n),r=1,i=0;for(let l=0;l<o.length;l++){let s=o[l];if(s!==e&&(s===n.documentElement||s.tagName==="BODY"))continue;let a=q(s);!a||a.identifiableText!==t||(i++,s===e&&(r=i))}return{index:r}}function se(e){if(e==null||e.nodeType!==Node.ELEMENT_NODE)return null;let t=Object.keys(p);for(let n=0;n<t.length;n++){let o=t[n];if(o!=="element"&&g(e,o))return o}return"element"}function le(e){if(e==null||e.nodeType!==Node.ELEMENT_NODE)return{identifiableText:null,attributeName:null,index:1,type:null,tagName:null};let t=se(e),n=q(e);if(!n)return{identifiableText:null,attributeName:null,index:1,type:t,tagName:e.tagName.toLowerCase()};let o=ie(e,n.identifiableText);return{identifiableText:n.identifiableText,attributeName:n.attributeName,index:o.index,type:t,tagName:e.tagName.toLowerCase()}}function w(e,t,n=0){if(e==null||t==null)return!1;if(n>v)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 i=1,l=!0;for(let s=1;s<e.length-1;s++)if(e[s]==="("?i++:e[s]===")"&&i--,i===0){l=!1;break}if(l)return w(e.slice(1,-1),t,n+1)}let o=B(e,"or");if(o.length>1){for(let i of o)if(w(i,t,n+1))return!0;return!1}let r=B(e,"and");if(r.length>1){for(let i of r)if(!w(i,t,n+1))return!1;return!0}return H(e,t,n)}function B(e,t){let n=[],o=0,r="",i=!1,l="",s=t==="or"?b.operatorOr:b.operatorAnd;for(let a=0;a<e.length;a++){let f=e[a];if((f==="'"||f==='"')&&(a===0||e[a-1]!=="\\")&&(i?f===l&&(i=!1):(i=!0,l=f)),!i&&(f==="("?o++:f===")"&&o--,o===0)){let c=e.slice(a).match(s);if(c){n.push(r.trim()),a+=c[0].length-1,r="";continue}}r+=f}return r.trim()&&n.push(r.trim()),n}function H(e,t,n=0){if(e==null||t==null)return!1;e=e.trim();let o=e.match(b.selfWithTag);if(o){let f=o[1].toUpperCase();return t.tagName!==f?!1:o[2]?w(o[2],t,n+1):!0}let r=e.match(b.contains);if(r)return(t.getAttribute(r[1])||"").toLowerCase().includes(r[2].toLowerCase());let i=e.match(b.attrEquals);if(i)return t.getAttribute(i[1])===i[2];let l=e.match(b.attrExists);if(l)return t.hasAttribute(l[1]);let s=e.match(b.descendant);if(s)return t.querySelector(s[1])!==null;let a=e.match(b.ancestor);if(a){let f=t.parentElement;for(;f;){if(w(a[1],f,n+1))return!0;f=f.parentElement}return!1}return!1}var p=Object.freeze(D);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 ae(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 _(e){let t=e.getAttribute("aria-labelledby");if(!t)return"";let n=t.split(/\s+/),o="";for(let r of n)try{let i=document.getElementById(r);i&&(o+=i.textContent)}catch(i){}return o}function S(e,t,n=!1){if(e==null)return!1;if(t==null||t==="")return!0;if(ae(e))return!1;let o=E;for(let l=0;l<o.length;l++){let s=o[l],a;try{a=e.getAttribute(s)}catch(f){continue}if(a){if(s==="aria-labelledby"){if(n?a===t:a.includes(t))return!0;let f=_(e);if(f&&(n?f===t:f.includes(t)))return!0}else if(n?a===t:a.includes(t))return!0}}let r=L(e);if(n?r===t:r.includes(t))return!0;let i=e.textContent;return!!(n?i.trim()===t:i.includes(t))}function g(e,t){if(e==null)return!1;let n=C.get(t);return n?n(e):!1}function y(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 i=r.children;for(let l=i.length-1;l>=0;l--)o.push(i[l]);try{if(r.shadowRoot){let l=r.shadowRoot.children;for(let s=l.length-1;s>=0;s--)o.push(l[s])}}catch(l){}}return t}function x(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(i){i.name==="SecurityError"?console.warn("Skipping cross-origin iframe:",i.message):console.warn("Error accessing iframe:",i.message)}}}catch(n){console.warn("Error getting frames:",n.message)}return t}function A(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 k(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 F(e="element",t=null,n=null){if(e==null&&(e="element"),typeof e!="string")throw new TypeError(`type must be a string, got ${typeof e}`);let o=n&&n.failOnUnknownType===!0;if(e&&!p[e]){let a=`Unknown element type: ${e}. Valid types: ${Object.keys(p).join(", ")}`;if(o)throw new TypeError(`Unknown element type: ${e}`);return console.warn(a),{elements:[]}}let r=[],i=x(window);for(let a of i){let f=y(t||a.document);for(let u=0;u<f.length;u++){let c=f[u];e&&!g(c,e)||r.push({element:c,frame:a})}}let l=[];if(r.length>0){let a=new Set(r.map(u=>u.element)),f=new Set;for(let u=r.length-1;u>=0;u--){let c=r[u],m=c.element;if(!f.has(m)){l.unshift(c);let d=m.parentElement;for(;d;)a.has(d)&&f.add(d),d=d.parentElement}}}return{elements:l.map(a=>{let f=A(a.element),u=a.element.tagName.toLowerCase(),c=k(a.element);return a.frame.isMainFrame?{element:a.element,boundingBox:f,tagName:u,frameIndex:a.frame.frameIndex,isHidden:c}:{boundingBox:f,tagName:u,frameIndex:a.frame.frameIndex,isHidden:c}})}}function V(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=x(window);for(let s of r){let a=y(n||s.document);for(let f=0;f<a.length;f++){let u=a[f];S(u,e,t)&&o.push({element:u,frame:s})}}return{elements:o.filter(s=>{let a=s.element;if(I(a,e,t))return!0;for(let u of o)if(u.element!==a&&a.contains(u.element))return!1;return!0}).map(s=>{let a=A(s.element),f=s.element.tagName.toLowerCase(),u=k(s.element);return s.frame.isMainFrame?{element:s.element,boundingBox:a,tagName:f,frameIndex:s.frame.frameIndex,isHidden:u}:{boundingBox:a,tagName:f,frameIndex:s.frame.frameIndex,isHidden:u}})}}function I(e,t,n=!1){if(t==null||t==="")return!0;let o=E;for(let i=0;i<o.length;i++){let l=o[i],s;try{s=e.getAttribute(l)}catch(a){continue}if(s){if(l==="aria-labelledby"){if(n?s===t:s.includes(t))return!0;let a=_(e);if(a&&(n?a===t:a.includes(t)))return!0}else if(n?s===t:s.includes(t))return!0}}let r=L(e);return!!(n?r===t:r.includes(t))}function fe(e=null,t=null,n=null){let o=e!=null;if(o){if(typeof e!="string")throw new TypeError(`type must be a string, got ${typeof e}`);if(!p[e]){let s=`Unknown element type: ${e}. Valid types: ${Object.keys(p).join(", ")}`;if(n&&n.failOnUnknownType===!0)throw new TypeError(`Unknown element type: ${e}`);return console.warn(s),{[e]:0}}}let r={},i=o?[e]:Object.keys(p).filter(s=>s!=="element");for(let s=0;s<i.length;s++)r[i[s]]=0;let l=x(window);for(let s=0;s<l.length;s++){let a=l[s],f=y(t||a.document);for(let u=0;u<f.length;u++){let c=f[u];for(let m=0;m<i.length;m++){let d=i[m];g(c,d)&&(r[d]+=1)}}}return r}function ce(e=null,t=null,n=!1,o=null,r=null){if(t==null&&(t=""),e!=null){if(typeof e!="string")throw new TypeError(`type must be a string, got ${typeof e}`);if(!p[e]){let f=`Unknown element type: ${e}. Valid types: ${Object.keys(p).join(", ")}`;if(r&&r.failOnUnknownType===!0)throw new TypeError(`Unknown element type: ${e}`);return console.warn(f),{elements:[]}}}if(t!==""&&typeof t!="string")throw new TypeError(`text must be a string, got ${typeof t}`);let i=[],l=x(window);for(let f of l){let u=y(o||f.document);for(let c=0;c<u.length;c++){let m=u[c];e!=null&&!g(m,e)||t!==""&&!S(m,t,n)||i.push({element:m,frame:f})}}return{elements:(t!==""?i.filter(f=>{let u=f.element;if(I(u,t,n))return!0;for(let m of i)if(m.element!==u&&u.contains(m.element))return!1;return!0}):i).map(f=>{let u=A(f.element),c=f.element.tagName.toLowerCase(),m=k(f.element);return f.frame.isMainFrame?{element:f.element,boundingBox:u,tagName:c,frameIndex:f.frame.frameIndex,isHidden:m}:{boundingBox:u,tagName:c,frameIndex:f.frame.frameIndex,isHidden:m}})}}function $(e){if(e.parentElement)return e.parentElement;try{let t=e.getRootNode();if(t&&t.host)return t.host}catch(t){}return null}function U(e){let t=$(e);if(!t)return[];if(t.shadowRoot)try{return Array.from(t.shadowRoot.children)}catch(n){return[]}return Array.from(t.children)}function ue(e,t){let n=$(e);for(;n;){if(g(n,t))return n;n=$(n)}let o=e.children||[];for(let l of o)if(g(l,t))return l;let r=U(e);for(let l of r)if(l!==e&&g(l,t))return l;for(let l of r){if(l===e)continue;let s=y(l);for(let a=0;a<s.length;a++)if(g(s[a],t))return s[a]}let i=e.parentElement;for(;i;){let l=U(i);for(let s of l)if(s!==i){if(g(s,t))return s;let a=y(s);for(let f=0;f<a.length;f++)if(g(a[f],t))return a[f]}i=i.parentElement}return null}function me(e,t,n=!1,o=null,r=null){let i=e!=null&&e!=="",l=t!=null&&t!=="";if(i&&!l)return F(e,o,r);if(!i&&l)return V(t,n,o);if(i){if(typeof e!="string")throw new TypeError(`elementType must be a string, got ${typeof e}`);if(!p[e]){let c=`Unknown element type: ${e}. Valid types: ${Object.keys(p).join(", ")}`;if(r&&r.failOnUnknownType===!0)throw new TypeError(`Unknown element type: ${e}`);return console.warn(c),{elements:[]}}}if(l&&typeof t!="string")throw new TypeError(`attributeText must be a string, got ${typeof t}`);let s=[],a=x(window);for(let c of a){let m=y(o||c.document);for(let d=0;d<m.length;d++){let h=m[d];i&&!g(h,e)||l&&!S(h,t,n)||s.push({element:h,frame:c})}}if(s.length===0&&i&&l){let c=[];for(let d of a){let h=y(o||d.document);for(let M=0;M<h.length;M++){let O=h[M];S(O,t,n)&&I(O,t,n)&&c.push({element:O,frame:d})}}let m=new Set;for(let d of c){let h=ue(d.element,e);h&&!m.has(h)&&(m.add(h),s.push({element:h,frame:d.frame}))}}return{elements:(l?s.filter(c=>{let m=c.element;if(I(m,t,n))return!0;for(let h of s)if(h.element!==m&&m.contains(h.element))return!1;return!0}):s).map(c=>{let m=A(c.element),d=c.element.tagName.toLowerCase(),h=k(c.element);return c.frame.isMainFrame?{element:c.element,boundingBox:m,tagName:d,frameIndex:c.frame.frameIndex,isHidden:h}:{boundingBox:m,tagName:d,frameIndex:c.frame.frameIndex,isHidden:h}})}}function z(e){return e?e&&e.elements&&Array.isArray(e.elements)?e.elements:Array.isArray(e)?e:[e]:[]}function de(e,t="red",n=3){let o=z(e);for(let r=0;r<o.length;r++){let i=o[r],l=i.element?i.element:i;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 he(e){let t=z(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"))}}var N=[];function ge(){let e=new Map,t=y();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 o={originalStyles:e,pausedCount:e.size};return N.push(o),o}function pe(e){if(e){let n=N.indexOf(e);if(n===-1)return;N.splice(n,1)}else{if(N.length===0)return;e=N.pop()}let t=e.originalStyles;if(t)for(let[n,o]of t)n&&n.style&&(n.style.animationPlayState=o.animationPlayState||"",n.style.transitionProperty=o.transitionProperty||"",n.style.webkitAnimationPlayState=o.webkitAnimationPlayState||"",n.style.webkitTransitionProperty=o.webkitTransitionProperty||"");if(N.length===0){let n=document.getElementById("elementfinder-animation-pause");n&&n.remove()}}function ye(){return Object.keys(p)}function be(){return[...E]}return G(we);})();

package/package.json CHANGED Viewed

@@ -1,29 +1,23 @@
 {
   "name": "@nodebug/browser-element-finder",
-  "version": "1.1.7",
+  "version": "1.1.9",
   "description": "Browser Element Finder - Find elements by type and text content",
   "exports": {
     ".": {
-      "browser": "./index.js",
-      "require": "./index.js",
       "import": "./src/element-finder.js",
+      "default": "./src/element-finder.js"
+    },
+    "./browser": {
       "default": "./index.js"
     },
     "./min": {
-      "browser": "./index.min.js",
-      "require": "./index.min.js",
-      "import": "./index.min.js",
       "default": "./index.min.js"
     },
     "./element-definitions.json": {
-      "browser": "./src/element-definitions.json",
-      "require": "./src/element-definitions.json",
       "import": "./src/element-definitions.json",
       "default": "./src/element-definitions.json"
     },
     "./searchable-attributes.json": {
-      "browser": "./src/searchable-attributes.json",
-      "require": "./src/searchable-attributes.json",
       "import": "./src/searchable-attributes.json",
       "default": "./src/searchable-attributes.json"
     }
@@ -54,7 +48,8 @@
     "url": "https://github.com/node-bug/browser-element-finder/issues"
   },
   "scripts": {
-    "build": "node build.js",
+    "build": "node scripts/build.js",
+    "prepack": "npm run build",
     "lint": "eslint .",
     "test": "npm run build && vitest run",
     "test:watch": "npm run build && vitest",
@@ -63,7 +58,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/coverage-v8": "^3.2.6",
     "esbuild": "^0.28.0",
     "eslint": "^10.2.0",
     "eslint-config-prettier": "^10.1.8",
@@ -73,10 +68,10 @@
     "lint-staged": "^16.4.0",
     "prettier": "^3.8.2",
     "selenium-webdriver": "^4.43.0",
-    "vitest": "^3.0.0"
+    "vitest": "^3.2.6"
   },
   "lint-staged": {
-    "*.{js,jsx,ts,tsx}": [
+    "*.js": [
       "eslint --fix"
     ],
     "*.{json,yaml,yml,md,sh,groovy}": [

package/src/element-definitions.json CHANGED Viewed

@@ -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",