craftdriver 1.8.0 → 1.9.0

package/CHANGELOG.md

@@ -1,15 +1,16 @@
-# [1.8.0](https://github.com/dtopuzov/craftdriver/compare/v1.7.0...v1.8.0) (2026-07-21)
+# [1.9.0](https://github.com/dtopuzov/craftdriver/compare/v1.8.0...v1.9.0) (2026-07-24)
 
 
 ### Features
 
-* **agent:** add AI tooling and reliable auth-state reuse ([2a0f079](https://github.com/dtopuzov/craftdriver/commit/2a0f079b327ffd1545fa0f1919e06045e89422dc))
+* add open Shadow DOM support ([#49](https://github.com/dtopuzov/craftdriver/issues/49)) ([fadd962](https://github.com/dtopuzov/craftdriver/commit/fadd962c6d1a583501d9efb7c8117d42ce3710a6)), closes [#40](https://github.com/dtopuzov/craftdriver/issues/40)
+
+# [1.8.0](https://github.com/dtopuzov/craftdriver/compare/v1.7.0...v1.8.0) (2026-07-21)
 
-## Unreleased
 
 ### Features
 
-* **agent CLI:** add a persistent browser exploration workflow with semantic snapshots, safe temporary refs, live-validated durable locators, manual QA actions, console/network evidence, mocks, traces, and reusable login state
+* **agent CLI:** add a persistent browser exploration workflow with semantic snapshots, safe temporary refs, live-validated durable locators, manual QA actions, console/network evidence, mocks, traces, and reusable login state ([2a0f079](https://github.com/dtopuzov/craftdriver/commit/2a0f079b327ffd1545fa0f1919e06045e89422dc))
 * **auth state:** restore cookies and multi-origin localStorage before the first navigation on BiDi launch and contexts, with path/object inputs and one-time hydration that preserves later application writes
 * **sessions:** isolate browsers, cookies, pages, refs, and artifacts in named sessions under a project-scoped daemon
 * **MCP:** add a validated stdio tool server with automatic post-action snapshot diffs, bounded responses, and quota-controlled file artifacts for token-efficient context
@@ -220,7 +221,7 @@ Fixes: https://github.com/dtopuzov/craftdriver/issues/20
 
 # [0.1.0](https://github.com/dtopuzov/craftdriver/compare/v0.0.3...v0.1.0) (2026-02-08)
 
-## Unreleased
+### Changes
 
 - docs: refresh the README as a product front door, add a VitePress documentation site with GitHub Pages deployment, add proof pages/launch kit/social card, and add contribution files (issue forms, PR template, code of conduct).
 - **breaking** (pre-1.0): BiDi console/error log capture is lazy by default. Messages emitted before the first `browser.logs` / `onConsole` / `onError` / `waitForConsole` touch are no longer captured unless `Browser.launch({ captureLogs: true })` is used to arm logging at launch.

package/README.md

@@ -89,11 +89,11 @@ await browser.network.mock('**/api/users', {
 });
 
 // Save and reuse login state
-await browser.saveState('./session.json');
+await browser.saveState('.auth/session.json');
 
 await Browser.launch({
   browserName: 'chrome',
-  storageState: './session.json',
+  storageState: '.auth/session.json',
 });
 
 // Built-in accessibility checks via axe-core
@@ -113,6 +113,7 @@ explicit single-active-origin fallback after navigation; see
 | Driver management    | Zero-config driver resolution, cache behavior, env vars, offline mode              | [Driver configuration](https://dtopuzov.github.io/craftdriver/driver-configuration)                                                        |
 | Browser control      | Navigation, tabs, popups, iframes, content helpers, evaluate, init scripts         | [Browser API](https://dtopuzov.github.io/craftdriver/browser-api)                                                                          |
 | Locators             | CSS, XPath, text, role, label, test id, and composable `locator()` chains          | [Selectors](https://dtopuzov.github.io/craftdriver/selectors)                                                                              |
+| Open Shadow DOM      | Explicit lazy `shadowRoot()` boundaries over WebDriver Classic and BiDi            | [Shadow DOM](https://dtopuzov.github.io/craftdriver/selectors#open-shadow-dom)                                                             |
 | Element actions      | Click, fill, upload, inspect, and interact through element handles                 | [Element API](https://dtopuzov.github.io/craftdriver/element-api)                                                                          |
 | Assertions           | Built-in `expect(...)`, retries, visibility, text, attributes, and timing behavior | [Assertions](https://dtopuzov.github.io/craftdriver/assertions)                                                                            |
 | Input                | Low-level key presses, mouse movement, hover, drag, and pointer input              | [Keyboard and mouse](https://dtopuzov.github.io/craftdriver/keyboard-mouse)                                                                |

package/dist/cli/pageSemantics.d.ts

@@ -1,42 +1,6 @@
 /**
- * Page-side role and accessible-name extraction, shared by the snapshot and
- * the locator-candidate builder.
- *
- * These two surfaces must agree, and both must agree with `By.role` — that is
- * the whole point of the module. The snapshot tells an agent an element is a
- * `listbox`; the candidate builder proposes `role=listbox[name=Colors]`; and
- * `By.role('listbox', { name: 'Colors' })` has to actually resolve it in the
- * committed test. When those three drifted apart, the recommended locator for
- * a multi-select was a brittle `text=RedBlue`.
- *
- * So the mapping lives here once, `src/lib/by.ts` stays the resolution
- * authority, and `tests/cli/role-conformance.test.ts` pins the agreement
- * against a real browser.
- *
- * Emitted as JS **source text**: both callers assemble a body for
- * `page.evaluate`, and the build has no DOM lib. Keep it dependency-free and
- * side-effect-free — it is concatenated into larger scripts.
- *
- * ## The ARIA role / display token split
- *
- * `ariaRole` returns a real ARIA role or `null`. `null` is not a failure: an
- * `<input type="password">` genuinely has no ARIA role, and pretending it is a
- * `textbox` produces a `role=textbox[name=Password]` that resolves to nothing.
- * The snapshot falls back to `displayRole` (the tag name) so the element still
- * appears, while the candidate builder proposes a role locator only when
- * `ariaRole` is non-null. Honest over convenient.
+ * Compatibility re-export. The page-side semantic evaluator is shared by the
+ * public locator engine and CLI snapshot/candidate surfaces.
  */
-/**
- * Function declarations injected into a page-side script.
- *
- * Provides `firstRoleToken`, `hasSectioningAncestor`, `ariaRole`,
- * `displayRole`, `associatedLabel` and `accName`.
- */
-export declare const PAGE_SEMANTICS_JS = "\nfunction firstRoleToken(el) {\n  const role = (el.getAttribute('role') || '').trim();\n  return role ? role.split(/\\s+/)[0] : null;\n}\n// Mirrors HAS_SECTIONING_ANCESTOR in src/lib/by.ts: header/footer are only\n// banner/contentinfo when not nested in sectioning content.\nfunction hasSectioningAncestor(el) {\n  for (let p = el.parentElement; p; p = p.parentElement) {\n    const t = p.tagName.toLowerCase();\n    if (t === 'article' || t === 'aside' || t === 'main' || t === 'nav' || t === 'section') {\n      return true;\n    }\n    const role = firstRoleToken(p);\n    if (\n      role === 'article' ||\n      role === 'complementary' ||\n      role === 'main' ||\n      role === 'navigation' ||\n      role === 'region'\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n// The ARIA role, or null when the element has none that By.role can resolve.\n// Every branch here must have a counterpart in IMPLICIT_ROLE_XPATH.\nfunction ariaRole(el) {\n  const explicit = firstRoleToken(el);\n  if (explicit) return explicit;\n  const t = el.tagName.toLowerCase();\n  if (t === 'a' || t === 'area') return el.hasAttribute('href') ? 'link' : null;\n  if (t === 'button' || t === 'summary') return 'button';\n  if (t === 'input') {\n    const it = (el.getAttribute('type') || 'text').toLowerCase();\n    if (it === 'submit' || it === 'button' || it === 'reset' || it === 'image') return 'button';\n    if (it === 'checkbox') return 'checkbox';\n    if (it === 'radio') return 'radio';\n    if (it === 'search') return 'searchbox';\n    if (it === 'number') return 'spinbutton';\n    if (it === 'range') return 'slider';\n    if (it === 'text' || it === 'email' || it === 'tel' || it === 'url') return 'textbox';\n    // password, date, file, color, hidden\u2026 have no corresponding ARIA role.\n    return el.hasAttribute('type') ? null : 'textbox';\n  }\n  if (t === 'textarea') return 'textbox';\n  // multiple/size are reflected IDL attributes, so reading the properties\n  // stays equivalent to the attribute test By.role compiles to XPath.\n  if (t === 'select') return el.multiple || el.size > 1 ? 'listbox' : 'combobox';\n  if (/^h[1-6]$/.test(t)) return 'heading';\n  if (t === 'img') return 'img';\n  if (t === 'ul' || t === 'ol') return 'list';\n  if (t === 'li') return 'listitem';\n  if (t === 'table') return 'table';\n  if (t === 'tr') return 'row';\n  if (t === 'td') return 'cell';\n  if (t === 'th') return 'columnheader';\n  if (t === 'nav') return 'navigation';\n  if (t === 'main') return 'main';\n  if (t === 'article') return 'article';\n  if (t === 'form') return 'form';\n  if (t === 'header') return hasSectioningAncestor(el) ? null : 'banner';\n  if (t === 'footer') return hasSectioningAncestor(el) ? null : 'contentinfo';\n  return null;\n}\n// What the snapshot prints. Falls back to the tag name so an element with no\n// ARIA role is still listed and still addressable by ref.\nfunction displayRole(el) {\n  return ariaRole(el) || el.tagName.toLowerCase();\n}\n// The <label> a user reads for a form control, independent of accName \u2014\n// By.labelText resolves against exactly this.\nfunction associatedLabel(el) {\n  const t = el.tagName;\n  if (t !== 'INPUT' && t !== 'TEXTAREA' && t !== 'SELECT') return null;\n  if (el.id) {\n    const forLabel = document.querySelector('label[for=' + JSON.stringify(el.id) + ']');\n    if (forLabel) return (forLabel.textContent || '').trim() || null;\n  }\n  const parentLabel = el.closest('label');\n  if (parentLabel) return (parentLabel.textContent || '').trim() || null;\n  return null;\n}\n// Approximates the accessible name, in the same source order By.role's name\n// predicate checks. Sources By.role cannot match must not appear here.\nfunction accName(el) {\n  const aria = el.getAttribute('aria-label');\n  if (aria && aria.trim()) return aria.trim();\n  const labelledby = el.getAttribute('aria-labelledby');\n  if (labelledby) {\n    // Single id only \u2014 By.role's @aria-labelledby test is an equality match.\n    const ref = document.getElementById(labelledby);\n    if (ref) {\n      const t = (ref.textContent || '').trim();\n      if (t) return t;\n    }\n  }\n  const label = associatedLabel(el);\n  if (label) return label;\n  const tag = el.tagName;\n  if (tag === 'INPUT') {\n    const it = (el.getAttribute('type') || 'text').toLowerCase();\n    // Native buttons carry their name in value=, not in text content.\n    if (it === 'submit' || it === 'button' || it === 'reset') {\n      const v = el.getAttribute('value');\n      if (v && v.trim()) return v.trim();\n    }\n    if (it === 'image') {\n      const alt = el.getAttribute('alt');\n      if (alt && alt.trim()) return alt.trim();\n    }\n  }\n  if (tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT') {\n    const placeholder = el.getAttribute('placeholder');\n    if (placeholder && placeholder.trim()) return placeholder.trim();\n  }\n  if (tag === 'IMG') {\n    const alt = el.getAttribute('alt');\n    if (alt && alt.trim()) return alt.trim();\n  }\n  const text = (el.textContent || '').trim().replace(/\\s+/g, ' ');\n  if (text) return text;\n  const title = el.getAttribute('title');\n  if (title && title.trim()) return title.trim();\n  return '';\n}\n";
-/**
- * Every role `ariaRole` can emit for a native element. The conformance test
- * walks this list, so a new branch above without a `By.role` counterpart
- * fails CI rather than shipping an unresolvable recommendation.
- */
-export declare const EMITTABLE_ROLES: readonly ["link", "button", "checkbox", "radio", "searchbox", "spinbutton", "slider", "textbox", "listbox", "combobox", "heading", "img", "list", "listitem", "table", "row", "cell", "columnheader", "navigation", "main", "article", "form", "banner", "contentinfo"];
+export { PAGE_SEMANTICS_JS, EMITTABLE_ROLES } from '../lib/pageSemantics.js';
 //# sourceMappingURL=pageSemantics.d.ts.map

package/dist/cli/pageSemantics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pageSemantics.d.ts","sourceRoot":"","sources":["../../src/cli/pageSemantics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,+nKA+H7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,yQAyBlB,CAAC"}
+{"version":3,"file":"pageSemantics.d.ts","sourceRoot":"","sources":["../../src/cli/pageSemantics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/cli/pageSemantics.js

@@ -1,194 +1,6 @@
 /**
- * Page-side role and accessible-name extraction, shared by the snapshot and
- * the locator-candidate builder.
- *
- * These two surfaces must agree, and both must agree with `By.role` — that is
- * the whole point of the module. The snapshot tells an agent an element is a
- * `listbox`; the candidate builder proposes `role=listbox[name=Colors]`; and
- * `By.role('listbox', { name: 'Colors' })` has to actually resolve it in the
- * committed test. When those three drifted apart, the recommended locator for
- * a multi-select was a brittle `text=RedBlue`.
- *
- * So the mapping lives here once, `src/lib/by.ts` stays the resolution
- * authority, and `tests/cli/role-conformance.test.ts` pins the agreement
- * against a real browser.
- *
- * Emitted as JS **source text**: both callers assemble a body for
- * `page.evaluate`, and the build has no DOM lib. Keep it dependency-free and
- * side-effect-free — it is concatenated into larger scripts.
- *
- * ## The ARIA role / display token split
- *
- * `ariaRole` returns a real ARIA role or `null`. `null` is not a failure: an
- * `<input type="password">` genuinely has no ARIA role, and pretending it is a
- * `textbox` produces a `role=textbox[name=Password]` that resolves to nothing.
- * The snapshot falls back to `displayRole` (the tag name) so the element still
- * appears, while the candidate builder proposes a role locator only when
- * `ariaRole` is non-null. Honest over convenient.
+ * Compatibility re-export. The page-side semantic evaluator is shared by the
+ * public locator engine and CLI snapshot/candidate surfaces.
  */
-/**
- * Function declarations injected into a page-side script.
- *
- * Provides `firstRoleToken`, `hasSectioningAncestor`, `ariaRole`,
- * `displayRole`, `associatedLabel` and `accName`.
- */
-export const PAGE_SEMANTICS_JS = `
-function firstRoleToken(el) {
-  const role = (el.getAttribute('role') || '').trim();
-  return role ? role.split(/\\s+/)[0] : null;
-}
-// Mirrors HAS_SECTIONING_ANCESTOR in src/lib/by.ts: header/footer are only
-// banner/contentinfo when not nested in sectioning content.
-function hasSectioningAncestor(el) {
-  for (let p = el.parentElement; p; p = p.parentElement) {
-    const t = p.tagName.toLowerCase();
-    if (t === 'article' || t === 'aside' || t === 'main' || t === 'nav' || t === 'section') {
-      return true;
-    }
-    const role = firstRoleToken(p);
-    if (
-      role === 'article' ||
-      role === 'complementary' ||
-      role === 'main' ||
-      role === 'navigation' ||
-      role === 'region'
-    ) {
-      return true;
-    }
-  }
-  return false;
-}
-// The ARIA role, or null when the element has none that By.role can resolve.
-// Every branch here must have a counterpart in IMPLICIT_ROLE_XPATH.
-function ariaRole(el) {
-  const explicit = firstRoleToken(el);
-  if (explicit) return explicit;
-  const t = el.tagName.toLowerCase();
-  if (t === 'a' || t === 'area') return el.hasAttribute('href') ? 'link' : null;
-  if (t === 'button' || t === 'summary') return 'button';
-  if (t === 'input') {
-    const it = (el.getAttribute('type') || 'text').toLowerCase();
-    if (it === 'submit' || it === 'button' || it === 'reset' || it === 'image') return 'button';
-    if (it === 'checkbox') return 'checkbox';
-    if (it === 'radio') return 'radio';
-    if (it === 'search') return 'searchbox';
-    if (it === 'number') return 'spinbutton';
-    if (it === 'range') return 'slider';
-    if (it === 'text' || it === 'email' || it === 'tel' || it === 'url') return 'textbox';
-    // password, date, file, color, hidden… have no corresponding ARIA role.
-    return el.hasAttribute('type') ? null : 'textbox';
-  }
-  if (t === 'textarea') return 'textbox';
-  // multiple/size are reflected IDL attributes, so reading the properties
-  // stays equivalent to the attribute test By.role compiles to XPath.
-  if (t === 'select') return el.multiple || el.size > 1 ? 'listbox' : 'combobox';
-  if (/^h[1-6]$/.test(t)) return 'heading';
-  if (t === 'img') return 'img';
-  if (t === 'ul' || t === 'ol') return 'list';
-  if (t === 'li') return 'listitem';
-  if (t === 'table') return 'table';
-  if (t === 'tr') return 'row';
-  if (t === 'td') return 'cell';
-  if (t === 'th') return 'columnheader';
-  if (t === 'nav') return 'navigation';
-  if (t === 'main') return 'main';
-  if (t === 'article') return 'article';
-  if (t === 'form') return 'form';
-  if (t === 'header') return hasSectioningAncestor(el) ? null : 'banner';
-  if (t === 'footer') return hasSectioningAncestor(el) ? null : 'contentinfo';
-  return null;
-}
-// What the snapshot prints. Falls back to the tag name so an element with no
-// ARIA role is still listed and still addressable by ref.
-function displayRole(el) {
-  return ariaRole(el) || el.tagName.toLowerCase();
-}
-// The <label> a user reads for a form control, independent of accName —
-// By.labelText resolves against exactly this.
-function associatedLabel(el) {
-  const t = el.tagName;
-  if (t !== 'INPUT' && t !== 'TEXTAREA' && t !== 'SELECT') return null;
-  if (el.id) {
-    const forLabel = document.querySelector('label[for=' + JSON.stringify(el.id) + ']');
-    if (forLabel) return (forLabel.textContent || '').trim() || null;
-  }
-  const parentLabel = el.closest('label');
-  if (parentLabel) return (parentLabel.textContent || '').trim() || null;
-  return null;
-}
-// Approximates the accessible name, in the same source order By.role's name
-// predicate checks. Sources By.role cannot match must not appear here.
-function accName(el) {
-  const aria = el.getAttribute('aria-label');
-  if (aria && aria.trim()) return aria.trim();
-  const labelledby = el.getAttribute('aria-labelledby');
-  if (labelledby) {
-    // Single id only — By.role's @aria-labelledby test is an equality match.
-    const ref = document.getElementById(labelledby);
-    if (ref) {
-      const t = (ref.textContent || '').trim();
-      if (t) return t;
-    }
-  }
-  const label = associatedLabel(el);
-  if (label) return label;
-  const tag = el.tagName;
-  if (tag === 'INPUT') {
-    const it = (el.getAttribute('type') || 'text').toLowerCase();
-    // Native buttons carry their name in value=, not in text content.
-    if (it === 'submit' || it === 'button' || it === 'reset') {
-      const v = el.getAttribute('value');
-      if (v && v.trim()) return v.trim();
-    }
-    if (it === 'image') {
-      const alt = el.getAttribute('alt');
-      if (alt && alt.trim()) return alt.trim();
-    }
-  }
-  if (tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT') {
-    const placeholder = el.getAttribute('placeholder');
-    if (placeholder && placeholder.trim()) return placeholder.trim();
-  }
-  if (tag === 'IMG') {
-    const alt = el.getAttribute('alt');
-    if (alt && alt.trim()) return alt.trim();
-  }
-  const text = (el.textContent || '').trim().replace(/\\s+/g, ' ');
-  if (text) return text;
-  const title = el.getAttribute('title');
-  if (title && title.trim()) return title.trim();
-  return '';
-}
-`;
-/**
- * Every role `ariaRole` can emit for a native element. The conformance test
- * walks this list, so a new branch above without a `By.role` counterpart
- * fails CI rather than shipping an unresolvable recommendation.
- */
-export const EMITTABLE_ROLES = [
-    'link',
-    'button',
-    'checkbox',
-    'radio',
-    'searchbox',
-    'spinbutton',
-    'slider',
-    'textbox',
-    'listbox',
-    'combobox',
-    'heading',
-    'img',
-    'list',
-    'listitem',
-    'table',
-    'row',
-    'cell',
-    'columnheader',
-    'navigation',
-    'main',
-    'article',
-    'form',
-    'banner',
-    'contentinfo',
-];
+export { PAGE_SEMANTICS_JS, EMITTABLE_ROLES } from '../lib/pageSemantics.js';
 //# sourceMappingURL=pageSemantics.js.map

package/dist/cli/pageSemantics.js.map

@@ -1 +1 @@
-{"version":3,"file":"pageSemantics.js","sourceRoot":"","sources":["../../src/cli/pageSemantics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+HhC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM;IACN,QAAQ;IACR,UAAU;IACV,OAAO;IACP,WAAW;IACX,YAAY;IACZ,QAAQ;IACR,SAAS;IACT,SAAS;IACT,UAAU;IACV,SAAS;IACT,KAAK;IACL,MAAM;IACN,UAAU;IACV,OAAO;IACP,KAAK;IACL,MAAM;IACN,cAAc;IACd,YAAY;IACZ,MAAM;IACN,SAAS;IACT,MAAM;IACN,QAAQ;IACR,aAAa;CACL,CAAC"}
+{"version":3,"file":"pageSemantics.js","sourceRoot":"","sources":["../../src/cli/pageSemantics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/cli/selector.d.ts

@@ -17,10 +17,10 @@
  *   placeholder=Search…      → By.placeholder('Search…')
  *   alt=Logo                 → By.altText('Logo')
  *   title=Help               → By.title('Help')
- *   ref=e5                   → By.css('[data-craftdriver-ref="e5"]')
+ *   ref=e5                   → By.ref('e5') (resolved through the page identity registry)
  *                              (refs come from `craftdriver snapshot` /
- *                              browser_snapshot; invalidated by the next
- *                              snapshot or navigation)
+ *                              browser_snapshot; invalidated by detachment,
+ *                              navigation, or page replacement)
  */
 import { By } from '../lib/by.js';
 export declare function parseSelector(input: string): By;

package/dist/cli/selector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../src/cli/selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAKlC,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,EAAE,CA8E/C;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,CAE/C"}
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../src/cli/selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAKlC,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,EAAE,CA2E/C;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,CAE/C"}

package/dist/cli/selector.js

@@ -17,10 +17,10 @@
  *   placeholder=Search…      → By.placeholder('Search…')
  *   alt=Logo                 → By.altText('Logo')
  *   title=Help               → By.title('Help')
- *   ref=e5                   → By.css('[data-craftdriver-ref="e5"]')
+ *   ref=e5                   → By.ref('e5') (resolved through the page identity registry)
  *                              (refs come from `craftdriver snapshot` /
- *                              browser_snapshot; invalidated by the next
- *                              snapshot or navigation)
+ *                              browser_snapshot; invalidated by detachment,
+ *                              navigation, or page replacement)
  */
 import { By } from '../lib/by.js';
 import { CraftdriverError, ErrorCode } from '../lib/errors.js';
@@ -76,16 +76,13 @@ export function parseSelector(input) {
         case 'data-testid':
             return By.testId(valueRaw);
         case 'ref': {
-            // Refs are stamped onto elements by the snapshot evaluator as
-            // `data-craftdriver-ref="eN"`. They are stable until the next
-            // snapshot or navigation. We resolve them as a plain CSS
-            // attribute selector so all the usual auto-waiting paths work
-            // unchanged.
+            // Refs resolve through the page's identity registry. The marker
+            // attribute is diagnostic only and cannot cross a shadow boundary.
             const v = valueRaw.trim();
             if (!/^e\d+$/.test(v)) {
                 throw new CraftdriverError(ErrorCode.INVALID_ARGUMENT, `parseSelector: invalid ref "${valueRaw}"`, { hint: 'refs look like e1, e2, … (take a snapshot to see them)' });
             }
-            return By.css(`[data-craftdriver-ref="${v}"]`);
+            return By.ref(v);
         }
         default:
             // Treat unknown prefix as part of a CSS selector (e.g. attribute

package/dist/cli/selector.js.map

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

package/dist/cli/snapshot.d.ts

@@ -27,17 +27,16 @@
  * makes every pre-navigation ref detectably stale instead of silently
  * rebound.
  *
- * The element marker attribute (`data-craftdriver-ref`) is kept so
- * `ref=eN` still resolves through the ordinary CSS auto-waiting path, but
- * the map — not the attribute — is the source of truth. An attribute that
- * the map does not corroborate (authored into the HTML, or duplicated by
- * `cloneNode`) never resolves.
+ * The element marker attribute (`data-craftdriver-ref`) is diagnostic only.
+ * Resolution goes directly through the registry, which works for elements
+ * inside open shadow trees and cannot be confused by authored or cloned
+ * marker attributes.
  */
 import type { Browser } from '../lib/browser.js';
 export interface SnapshotShape {
     url: string;
     title: string;
-    /** One line per visible interactive node, prefixed with `eN: `. */
+    /** Visible semantic nodes plus indented open-shadow boundary lines. */
     lines: string[];
     /**
      * Identity of the document the refs belong to. Changes on navigation and

package/dist/cli/snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/cli/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAYjD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+DAA+D;AAC/D,MAAM,MAAM,SAAS,GACjB,IAAI,GACJ,aAAa,GACb,aAAa,GACb,kBAAkB,GAClB,aAAa,GACb,UAAU,GACV,WAAW,CAAC;AAEhB,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,EAChB,MAAM,SAAI,GACT,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAwB/B;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOzE;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,kBAAkB,EAAE,MAAM,GAAG,IAAI,GAChC,OAAO,CAAC,QAAQ,CAAC,CAgBnB;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAU3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,aAAa,GAAG,IAAI,EAC1B,IAAI,EAAE,aAAa,GAAG,IAAI,GACzB,MAAM,CA8CR;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,CAO7D;AAED;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAK;IAEtB,iEAAiE;IACjE,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,IAAI,OAAO,IAAI,aAAa,GAAG,IAAI,CAElC;IAED;;;;;;OAMG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,yEAAyE;IACzE,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,aAAa,GAAG,IAAI;IAQxD,4DAA4D;IAC5D,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM;IAO3C,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/cli/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAYjD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+DAA+D;AAC/D,MAAM,MAAM,SAAS,GACjB,IAAI,GACJ,aAAa,GACb,aAAa,GACb,kBAAkB,GAClB,aAAa,GACb,UAAU,GACV,WAAW,CAAC;AAEhB,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,EAChB,MAAM,SAAI,GACT,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAwB/B;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOzE;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,kBAAkB,EAAE,MAAM,GAAG,IAAI,GAChC,OAAO,CAAC,QAAQ,CAAC,CAgBnB;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAU3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,aAAa,GAAG,IAAI,EAC1B,IAAI,EAAE,aAAa,GAAG,IAAI,GACzB,MAAM,CA8CR;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,CAO7D;AAED;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAK;IAEtB,iEAAiE;IACjE,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,IAAI,OAAO,IAAI,aAAa,GAAG,IAAI,CAElC;IAED;;;;;;OAMG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,yEAAyE;IACzE,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,aAAa,GAAG,IAAI;IAQxD,4DAA4D;IAC5D,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM;IAO3C,KAAK,IAAI,IAAI;CAGd"}

package/dist/cli/snapshot.js

@@ -117,7 +117,7 @@ export function renderDelta(prev, next) {
     if (prev.documentId !== next.documentId || prev.url !== next.url) {
         return `${header}\n${next.lines.join('\n')}`;
     }
-    const strip = (l) => l.replace(/^e\d+:\s*/, '');
+    const strip = (l) => l.replace(/^(\s*)e\d+:\s*/, '$1');
     // Count occurrences rather than testing membership: a page with three
     // identical "Remove" buttons must still report a change when one of them
     // goes, and a set-difference silently calls that "no changes".
@@ -230,10 +230,13 @@ if (expected !== null && reg.doc !== expected) {
 }
 const el = reg.map.get(ref);
 if (!el) return { status: 'unknown-ref', documentId: reg.doc };
-if (!document.contains(el)) return { status: 'detached', documentId: reg.doc };
-const marked = document.querySelectorAll('[data-craftdriver-ref="' + ref + '"]');
-if (marked.length !== 1 || marked[0] !== el) {
-  return { status: 'ambiguous', documentId: reg.doc, count: marked.length };
+if (!el.isConnected || el.ownerDocument !== document) {
+  return { status: 'detached', documentId: reg.doc };
+}
+// The reverse map is the exact identity index. A mismatch is only possible for a
+// corrupt/legacy registry; marker attributes deliberately do not participate.
+if (reg.reverse && reg.reverse.get(el) !== ref) {
+  return { status: 'ambiguous', documentId: reg.doc };
 }
 return { status: 'ok', documentId: reg.doc };
 `;
@@ -243,7 +246,7 @@ return { status: 'ok', documentId: reg.doc };
  *
  * Strategy:
  * 1. Get or create the per-document ref registry.
- * 2. Walk a curated set of selectors (interactive + structural).
+ * 2. Walk the composed tree, entering open shadow roots and flattened slots.
  * 3. Skip nodes outside the viewport-ish bounds and zero-sized nodes.
  * 4. Reuse each node's existing ref, or issue the next unused one.
  * 5. Cap output at MAX_NODES so the snapshot stays bounded regardless
@@ -262,9 +265,18 @@ function newDocId(epoch) {
 function registry() {
   let reg = window.__craftdriverRefs;
   if (!reg || !reg.map) {
-    reg = { doc: newDocId(1), epoch: 1, next: 1, issued: 0, map: new Map() };
+    reg = {
+      doc: newDocId(1), epoch: 1, next: 1, issued: 0,
+      map: new Map(), reverse: new WeakMap()
+    };
     window.__craftdriverRefs = reg;
   }
+  if (!reg.reverse) {
+    reg.reverse = new WeakMap();
+    reg.map.forEach(function (el, ref) {
+      if (el) reg.reverse.set(el, ref);
+    });
+  }
   // Never reissue a number the session has already handed out. A fresh
   // document starts its counter above the session high-water mark, so a
   // ref captured before a navigation can never match a new element.
@@ -278,24 +290,26 @@ function registry() {
   // re-key on every single snapshot — invalidating refs the instant they
   // were handed out.
   if (reg.issued >= MAX_REFS) {
-    const marked = document.querySelectorAll('[data-craftdriver-ref]');
-    for (let i = 0; i < marked.length; i++) marked[i].removeAttribute('data-craftdriver-ref');
+    reg.map.forEach(function (el) {
+      if (el && el.removeAttribute) el.removeAttribute('data-craftdriver-ref');
+    });
     reg.epoch += 1;
     reg.doc = newDocId(reg.epoch);
     reg.issued = 0;
     reg.map = new Map();
+    reg.reverse = new WeakMap();
   }
   return reg;
 }
 function refFor(reg, el) {
-  const existing = el.getAttribute('data-craftdriver-ref');
-  // Trust the attribute only when the registry agrees it names this node;
-  // that rejects authored markup and cloneNode duplicates.
+  const existing = reg.reverse.get(el);
   if (existing && reg.map.get(existing) === el) return existing;
   const ref = 'e' + reg.next;
   reg.next += 1;
   reg.issued += 1;
   reg.map.set(ref, el);
+  reg.reverse.set(el, ref);
+  // Diagnostic only. Exact ref resolution never queries this attribute.
   el.setAttribute('data-craftdriver-ref', ref);
   return ref;
 }
@@ -323,22 +337,21 @@ const reg = registry();
 const sel = 'a,button,input,select,textarea,h1,h2,h3,h4,h5,h6,[role],nav,main,header,footer,form,img,label';
 const out = [];
 const refs = [];
-const nodes = document.querySelectorAll(sel);
-for (let i = 0; i < nodes.length && out.length < MAX_NODES; i++) {
-  const el = nodes[i];
-  if (!visible(el)) continue;
+const seen = new WeakSet();
+function emit(el, depth) {
+  if (out.length >= MAX_NODES || !visible(el)) return;
   // A <header>/<footer> inside sectioning content is not a landmark, and
   // listing it as a bare tag would be pure noise. Everything else keeps a
   // line even without an ARIA role, so controls stay addressable by ref.
   const tag = el.tagName.toLowerCase();
-  if (!ariaRole(el) && (tag === 'header' || tag === 'footer')) continue;
+  if (!ariaRole(el) && (tag === 'header' || tag === 'footer')) return;
   const role = displayRole(el);
   let name = accName(el);
   if (name.length > MAX_NAME) name = name.slice(0, MAX_NAME - 1) + '…';
   const hint = locatorHint(el);
   const ref = refFor(reg, el);
   refs.push(ref);
-  let line = ref + ': ' + role;
+  let line = '  '.repeat(depth) + ref + ': ' + role;
   if (name) line += ' "' + name + '"';
   if (hint) line += ' ' + hint;
   // Annotate disabled/checked state, agents need it.
@@ -346,6 +359,34 @@ for (let i = 0; i < nodes.length && out.length < MAX_NODES; i++) {
   if (el.checked) line += ' (checked)';
   out.push(line);
 }
+function visitContainer(container, depth) {
+  const children = container && container.children ? Array.from(container.children) : [];
+  for (let i = 0; i < children.length && out.length < MAX_NODES; i++) {
+    visitElement(children[i], depth);
+  }
+}
+function visitElement(el, depth) {
+  if (!el || seen.has(el) || out.length >= MAX_NODES) return;
+  seen.add(el);
+  const openRoot = el.shadowRoot || null;
+  if (el.matches(sel) || openRoot) emit(el, depth);
+  if (openRoot) {
+    if (out.length < MAX_NODES) out.push('  '.repeat(depth + 1) + '#shadow-root (open)');
+    visitContainer(openRoot, depth + 2);
+    return;
+  }
+  if (el.tagName === 'SLOT') {
+    const assigned = el.assignedElements ? el.assignedElements({ flatten: true }) : [];
+    if (assigned.length) {
+      for (let i = 0; i < assigned.length && out.length < MAX_NODES; i++) {
+        visitElement(assigned[i], depth);
+      }
+      return;
+    }
+  }
+  visitContainer(el, depth);
+}
+visitContainer(document, 0);
 return { lines: out, refs: refs, documentId: reg.doc, nextRef: reg.next };
 `;
 }

package/dist/cli/snapshot.js.map

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

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export { type RemoteWebDriverOptions, type RemoteAuth } from './lib/remote.js';
 export { Key } from './lib/keys.js';
 export { By } from './lib/by.js';
 export { Locator } from './lib/locator.js';
+export { ShadowRootLocator } from './lib/shadowRootLocator.js';
 export { Frame } from './lib/frame.js';
 export { Page } from './lib/page.js';
 export { BrowserContext, type ClearCookiesFilter, type ContextStorageStateOptions, type BrowserContextConfig, type BrowserContextHooks, type InitScriptHandle, type RoutePattern, } from './lib/browserContext.js';
@@ -21,5 +22,5 @@ export { type ElectronMock, type ElectronMockCall } from './lib/electronMock.js'
 export { ElectronMainLogMonitor, type ElectronMainLog, type ElectronMainLogLevel, type ElectronMainLogHandler, } from './lib/electronMainLogs.js';
 export { Clock, type ClockTime, type ClockInstallOptions, } from './lib/clock.js';
 export { compareScreenshots, VisualMismatchError, type ScreenshotCompareOptions, type ExpectScreenshotOptions, type VisualScreenshotOptions, type VisualComparisonResult, type ScreenshotMatchResult, } from './lib/visual/index.js';
-export { A11y, A11yError, type A11yOptions, type A11yResult, type A11yViolation, type A11yViolationNode, type A11yImpact, } from './lib/a11y.js';
+export { A11y, A11yError, type A11yOptions, type A11yResult, type A11yViolation, type A11yViolationNode, type A11yImpact, type A11yShadowSelector, type A11yTarget, } from './lib/a11y.js';
 //# sourceMappingURL=index.d.ts.map