craftdriver 0.0.3 → 0.2.0

package/dist/cli/selector.js

@@ -0,0 +1,100 @@
+/**
+ * Selector syntax for the CLI / agent surface.
+ *
+ * Agents pick a "kind" by prefixing the selector with one of the
+ * known schemes; otherwise the value is treated as a CSS selector
+ * (the default everywhere in craftdriver). Examples:
+ *
+ *   #submit                  → By.css('#submit')
+ *   css=button.primary       → By.css('button.primary')
+ *   xpath=//button[1]        → By.xpath('//button[1]')
+ *   text=Sign In             → By.text('Sign In')
+ *   text*=Sign               → By.partialText('Sign')
+ *   role=button              → By.role('button')
+ *   role=button[name=Submit] → By.role('button', { name: 'Submit' })
+ *   label=Email              → By.labelText('Email')
+ *   testid=login-btn         → By.testId('login-btn')
+ *   placeholder=Search…      → By.placeholder('Search…')
+ *   alt=Logo                 → By.altText('Logo')
+ *   title=Help               → By.title('Help')
+ *   ref=e5                   → By.css('[data-craftdriver-ref="e5"]')
+ *                              (refs come from `craftdriver snapshot` /
+ *                              browser_snapshot; invalidated by the next
+ *                              snapshot or navigation)
+ */
+import { By } from '../lib/by.js';
+import { CraftdriverError, ErrorCode } from '../lib/errors.js';
+const ROLE_RE = /^([a-z-]+)(?:\[name=([^\]]+)\])?$/i;
+export function parseSelector(input) {
+    if (input === undefined || input === null || input === '') {
+        throw new CraftdriverError(ErrorCode.INVALID_ARGUMENT, 'parseSelector: selector is empty', { hint: 'pass a CSS selector or a prefixed form like role=button or text=Sign In' });
+    }
+    const eq = input.indexOf('=');
+    if (eq <= 0)
+        return By.css(input);
+    const kind = input.slice(0, eq).toLowerCase();
+    const valueRaw = input.slice(eq + 1);
+    switch (kind) {
+        case 'css':
+            return By.css(valueRaw);
+        case 'xpath':
+            return By.xpath(valueRaw);
+        case 'id':
+            return By.id(valueRaw);
+        case 'name':
+            return By.name(valueRaw);
+        case 'tag':
+        case 'tagname':
+            return By.tagName(valueRaw);
+        case 'class':
+        case 'classname':
+            return By.className(valueRaw);
+        case 'text':
+            return By.text(valueRaw);
+        case 'text*':
+        case 'partialtext':
+            return By.partialText(valueRaw);
+        case 'role': {
+            const m = ROLE_RE.exec(valueRaw.trim());
+            if (!m) {
+                throw new CraftdriverError(ErrorCode.INVALID_ARGUMENT, `parseSelector: invalid role syntax "${valueRaw}"`, { hint: 'use role=<role> or role=<role>[name=<name>]' });
+            }
+            const [, role, name] = m;
+            return name ? By.role(role, { name }) : By.role(role);
+        }
+        case 'label':
+        case 'labeltext':
+            return By.labelText(valueRaw);
+        case 'placeholder':
+            return By.placeholder(valueRaw);
+        case 'alt':
+        case 'alttext':
+            return By.altText(valueRaw);
+        case 'title':
+            return By.title(valueRaw);
+        case 'testid':
+        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.
+            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}"]`);
+        }
+        default:
+            // Treat unknown prefix as part of a CSS selector (e.g. attribute
+            // selectors with `=` inside). This is the least-surprising default.
+            return By.css(input);
+    }
+}
+/** Short, log-friendly description of a By for error messages. */
+export function describeSelector(by) {
+    return `${by.using}=${by.value}`;
+}
+//# sourceMappingURL=selector.js.map

package/dist/cli/selector.js.map

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

package/dist/cli/snapshot.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Compact a11y snapshot generation + per-session diffing.
+ *
+ * Why this exists: the MCP spec (§6 of the AI-productivity plan) says
+ * "a11y snapshot is the default, not a screenshot." Screenshots cost
+ * 800–1500 image tokens; a flat list of visible interactive elements
+ * (role + accessible name + selector hint) is ~50–500 text tokens and
+ * far more useful for a text model writing the next selector.
+ *
+ * Snapshot algorithm runs entirely in the page via `page.evaluate`:
+ * pick interactive elements + headings + landmarks, compute an
+ * accessible name, skip the invisible, cap at `MAX_NODES`. The
+ * output is a single string with one node per line. Diffing is just
+ * a flat line-by-line compare.
+ */
+import type { Browser } from '../lib/browser.js';
+export interface SnapshotShape {
+    url: string;
+    title: string;
+    /** One line per visible interactive node, prefixed with `eN: `. */
+    lines: string[];
+}
+/**
+ * Build a fresh snapshot of the active page. Errors swallowed so a
+ * partial post-action payload never breaks the protocol.
+ */
+export declare function takeSnapshot(browser: Browser): Promise<SnapshotShape | null>;
+/**
+ * Render a snapshot as a compact, agent-friendly string. Either the
+ * full snapshot (first call in a session) or a `+/-` diff vs. the
+ * previous snapshot in the same session.
+ *
+ * Diff format intentionally mirrors `diff -u` lines so agents
+ * already familiar with unified diffs read it without instruction.
+ *
+ * Ref numbers (`e1`, `e2`, …) re-allocate on every snapshot so they
+ * can't be used to drive the diff directly — we strip them before
+ * the set-difference and re-attach them when rendering, so the diff
+ * stays semantically stable across renumberings.
+ */
+export declare function renderDelta(prev: SnapshotShape | null, next: SnapshotShape | null): string;
+/**
+ * Render a fresh, full snapshot (no diff). Used by the on-demand
+ * `snapshot` command + `browser_snapshot` tool when the agent wants
+ * the current sanitized DOM regardless of session history.
+ */
+export declare function renderFull(next: SnapshotShape | null): string;
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/cli/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAKjD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAYlF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,aAAa,GAAG,IAAI,EAC1B,IAAI,EAAE,aAAa,GAAG,IAAI,GACzB,MAAM,CAqBR;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,CAO7D"}

package/dist/cli/snapshot.js

@@ -0,0 +1,179 @@
+const MAX_NODES = 80;
+const MAX_NAME = 80;
+/**
+ * Build a fresh snapshot of the active page. Errors swallowed so a
+ * partial post-action payload never breaks the protocol.
+ */
+export async function takeSnapshot(browser) {
+    try {
+        const page = await browser.activePage();
+        const [url, title] = await Promise.all([
+            page.url().catch(() => ''),
+            page.title().catch(() => ''),
+        ]);
+        const lines = await page.evaluate(JS_SNAPSHOT);
+        return { url, title, lines: Array.isArray(lines) ? lines : [] };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Render a snapshot as a compact, agent-friendly string. Either the
+ * full snapshot (first call in a session) or a `+/-` diff vs. the
+ * previous snapshot in the same session.
+ *
+ * Diff format intentionally mirrors `diff -u` lines so agents
+ * already familiar with unified diffs read it without instruction.
+ *
+ * Ref numbers (`e1`, `e2`, …) re-allocate on every snapshot so they
+ * can't be used to drive the diff directly — we strip them before
+ * the set-difference and re-attach them when rendering, so the diff
+ * stays semantically stable across renumberings.
+ */
+export function renderDelta(prev, next) {
+    if (!next)
+        return '';
+    const header = `page: ${next.title || '(untitled)'} — ${next.url || '(no url)'}`;
+    if (!prev) {
+        // First snapshot — print full.
+        if (next.lines.length === 0)
+            return `${header}\n(no interactive elements detected)`;
+        return `${header}\n${next.lines.join('\n')}`;
+    }
+    if (prev.url !== next.url) {
+        // Page changed — full snapshot.
+        return `${header}\n${next.lines.join('\n')}`;
+    }
+    const strip = (l) => l.replace(/^e\d+:\s*/, '');
+    const prevBodies = new Set(prev.lines.map(strip));
+    const nextBodies = new Set(next.lines.map(strip));
+    const removed = prev.lines.filter((l) => !nextBodies.has(strip(l))).map((l) => `- ${l}`);
+    const added = next.lines.filter((l) => !prevBodies.has(strip(l))).map((l) => `+ ${l}`);
+    if (removed.length === 0 && added.length === 0) {
+        return `${header}\n(no a11y changes)`;
+    }
+    return `${header}\n${removed.concat(added).join('\n')}`;
+}
+/**
+ * Render a fresh, full snapshot (no diff). Used by the on-demand
+ * `snapshot` command + `browser_snapshot` tool when the agent wants
+ * the current sanitized DOM regardless of session history.
+ */
+export function renderFull(next) {
+    if (!next)
+        return '(no snapshot available)';
+    const header = `page: ${next.title || '(untitled)'} — ${next.url || '(no url)'}`;
+    if (next.lines.length === 0) {
+        return `${header}\n(no interactive elements detected)`;
+    }
+    return `${header}\n${next.lines.join('\n')}`;
+}
+/**
+ * JS executed in-page. Keep it self-contained — no closure capture.
+ *
+ * Strategy:
+ * 1. Walk a curated set of selectors (interactive + structural).
+ * 2. Skip nodes outside the viewport-ish bounds and zero-sized nodes.
+ * 3. For each, compute role + accessible name + a stable selector hint
+ *    (prefer #id, then [data-testid], then [name], then tag+text).
+ * 4. Cap output at MAX_NODES so the snapshot stays bounded regardless
+ *    of page complexity.
+ */
+const JS_SNAPSHOT = `
+const MAX_NODES = ${MAX_NODES};
+const MAX_NAME = ${MAX_NAME};
+function visible(el) {
+  if (!el || !el.getClientRects) return false;
+  if (el.hidden) return false;
+  const rects = el.getClientRects();
+  if (!rects.length) return false;
+  const r = rects[0];
+  if (r.width === 0 || r.height === 0) return false;
+  const cs = getComputedStyle(el);
+  if (cs.visibility === 'hidden' || cs.display === 'none' || cs.opacity === '0') return false;
+  return true;
+}
+function impliedRole(el) {
+  const t = el.tagName.toLowerCase();
+  const explicit = el.getAttribute('role');
+  if (explicit) return explicit;
+  if (t === 'a' && el.hasAttribute('href')) return 'link';
+  if (t === 'button') return 'button';
+  if (t === 'input') {
+    const it = (el.getAttribute('type') || 'text').toLowerCase();
+    if (it === 'submit' || it === 'button' || it === 'reset') return 'button';
+    if (it === 'checkbox') return 'checkbox';
+    if (it === 'radio') return 'radio';
+    return 'textbox';
+  }
+  if (t === 'textarea') return 'textbox';
+  if (t === 'select') return 'combobox';
+  if (/^h[1-6]$/.test(t)) return 'heading';
+  if (t === 'nav') return 'navigation';
+  if (t === 'main') return 'main';
+  if (t === 'header') return 'banner';
+  if (t === 'footer') return 'contentinfo';
+  if (t === 'form') return 'form';
+  if (t === 'img') return 'img';
+  return t;
+}
+function accName(el) {
+  const aria = el.getAttribute('aria-label');
+  if (aria) return aria.trim();
+  const labelledby = el.getAttribute('aria-labelledby');
+  if (labelledby) {
+    const ref = document.getElementById(labelledby);
+    if (ref) return (ref.textContent || '').trim();
+  }
+  if (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA' || el.tagName === 'SELECT') {
+    if (el.id) {
+      const lbl = document.querySelector('label[for=' + JSON.stringify(el.id) + ']');
+      if (lbl) return (lbl.textContent || '').trim();
+    }
+    const parentLabel = el.closest('label');
+    if (parentLabel) return (parentLabel.textContent || '').trim();
+    const placeholder = el.getAttribute('placeholder');
+    if (placeholder) return placeholder.trim();
+  }
+  if (el.tagName === 'IMG') {
+    const alt = el.getAttribute('alt');
+    if (alt) return alt.trim();
+  }
+  const text = (el.textContent || '').trim().replace(/\\s+/g, ' ');
+  return text;
+}
+function locatorHint(el) {
+  if (el.id) return '#' + el.id;
+  const testid = el.getAttribute('data-testid') || el.getAttribute('data-test-id');
+  if (testid) return '[data-testid=' + JSON.stringify(testid) + ']';
+  const name = el.getAttribute('name');
+  if (name) return el.tagName.toLowerCase() + '[name=' + JSON.stringify(name) + ']';
+  return null;
+}
+const sel = 'a,button,input,select,textarea,h1,h2,h3,h4,h5,h6,[role],nav,main,header,footer,form,img,label';
+// Wipe stale refs from a previous snapshot so numbering is deterministic.
+const stale = document.querySelectorAll('[data-craftdriver-ref]');
+for (let i = 0; i < stale.length; i++) stale[i].removeAttribute('data-craftdriver-ref');
+const out = [];
+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 role = impliedRole(el);
+  let name = accName(el);
+  if (name.length > MAX_NAME) name = name.slice(0, MAX_NAME - 1) + '…';
+  const hint = locatorHint(el);
+  const ref = 'e' + (out.length + 1);
+  el.setAttribute('data-craftdriver-ref', ref);
+  let line = ref + ': ' + role;
+  if (name) line += ' "' + name + '"';
+  if (hint) line += ' ' + hint;
+  // Annotate disabled/checked state, agents need it.
+  if (el.disabled) line += ' (disabled)';
+  if (el.checked) line += ' (checked)';
+  out.push(line);
+}
+return out;
+`;
+//# sourceMappingURL=snapshot.js.map

package/dist/cli/snapshot.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,17 @@
-export { Browser, type LaunchOptions } from './lib/browser.js';
+export { CraftdriverError, ErrorCode, type ErrorCodeName, type ErrorCodeValue, type CraftdriverErrorOptions, } from './lib/errors.js';
+export { Browser, devices, type LaunchOptions, type LoadState, type Dialog, type DialogType, type MobileEmulation, type DeviceMetrics, type DeviceName, type Download, type EmulateOptions, } from './lib/browser.js';
 export { Key } from './lib/keys.js';
 export { By } from './lib/by.js';
+export { Locator } from './lib/locator.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';
+export { Keyboard } from './lib/keyboard.js';
+export { Mouse } from './lib/mouse.js';
+export { type TraceStartOptions, type TraceScreenshotMode, type TraceEvent, } from './lib/tracing.js';
+export { NetworkInterceptor, LogMonitor, SessionStateManager, type Cookie, type CookieInput, type SessionState, type StorageStateOptions, type MockResponse, type InterceptedRequest, type InterceptedResponse, type ConsoleMessage, type JavaScriptError, type LogMessage, } from './lib/bidi/index.js';
+export { ChromeService, type ChromeServiceOptions } from './lib/chrome.js';
+export { FirefoxService, type FirefoxServiceOptions } from './lib/firefox.js';
+export { Clock, type ClockTime, type ClockInstallOptions, } from './lib/clock.js';
+export { A11y, A11yError, type A11yOptions, type A11yResult, type A11yViolation, type A11yViolationNode, type A11yImpact, } from './lib/a11y.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,OAAO,EACP,OAAO,EACP,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EACL,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,mBAAmB,EACnB,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9E,OAAO,EACL,KAAK,EACL,KAAK,SAAS,EACd,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,IAAI,EACJ,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,UAAU,GAChB,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,5 +1,21 @@
 // Public entrypoint: expose the simplified Browser API only
-export { Browser } from './lib/browser.js';
+export { CraftdriverError, ErrorCode, } from './lib/errors.js';
+export { Browser, devices, } from './lib/browser.js';
 export { Key } from './lib/keys.js';
 export { By } from './lib/by.js';
+export { Locator } from './lib/locator.js';
+export { Frame } from './lib/frame.js';
+export { Page } from './lib/page.js';
+export { BrowserContext, } from './lib/browserContext.js';
+export { Keyboard } from './lib/keyboard.js';
+export { Mouse } from './lib/mouse.js';
+// BiDi features - network interception, logging, session state
+export { NetworkInterceptor, LogMonitor, SessionStateManager, } from './lib/bidi/index.js';
+// Driver services — expose for users who need custom binary paths / ports
+export { ChromeService } from './lib/chrome.js';
+export { FirefoxService } from './lib/firefox.js';
+// Virtual clock control
+export { Clock, } from './lib/clock.js';
+// Accessibility audits (axe-core wrapper — axe-core ships with craftdriver)
+export { A11y, A11yError, } from './lib/a11y.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,EAAE,OAAO,EAAsB,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,EACL,gBAAgB,EAChB,SAAS,GAIV,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,OAAO,EACP,OAAO,GAUR,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EACL,cAAc,GAOf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAOvC,+DAA+D;AAC/D,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,mBAAmB,GAWpB,MAAM,qBAAqB,CAAC;AAE7B,0EAA0E;AAC1E,OAAO,EAAE,aAAa,EAA6B,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAA8B,MAAM,kBAAkB,CAAC;AAE9E,wBAAwB;AACxB,OAAO,EACL,KAAK,GAGN,MAAM,gBAAgB,CAAC;AAExB,4EAA4E;AAC5E,OAAO,EACL,IAAI,EACJ,SAAS,GAMV,MAAM,eAAe,CAAC"}

package/dist/lib/a11y.d.ts

@@ -0,0 +1,81 @@
+import type { Driver } from './driver.js';
+import type { WebElement } from './webelement.js';
+import { CraftdriverError } from './errors.js';
+/** Severity buckets reported by axe-core. */
+export type A11yImpact = 'minor' | 'moderate' | 'serious' | 'critical';
+export interface A11yOptions {
+    /**
+     * Rule IDs to skip entirely. The common case — most projects maintain
+     * a small constant list of rules the team knowingly waives.
+     */
+    disableRules?: string[];
+    /** Only run these rule IDs. Mutually exclusive with `disableRules`. */
+    rules?: string[];
+    /** Minimum impact reported. Defaults to `'serious'`. */
+    minImpact?: A11yImpact;
+    /** Escape hatch: raw axe-core run options merged last (overrides everything else). */
+    axeOptions?: Record<string, unknown>;
+}
+export interface A11yViolationNode {
+    /** CSS selector chain identifying the violating node. */
+    target: string[];
+    /** HTML snippet of the violating node. */
+    html: string;
+    /** Human-readable summary of why this node failed. */
+    failureSummary: string;
+}
+export interface A11yViolation {
+    /** Rule ID, e.g. `'color-contrast'`. */
+    id: string;
+    impact: A11yImpact;
+    description: string;
+    /** Link to the axe-core rule documentation. */
+    helpUrl: string;
+    nodes: A11yViolationNode[];
+}
+export interface A11yResult {
+    violations: A11yViolation[];
+    passes: number;
+    incomplete: number;
+    inapplicable: number;
+}
+/** Thrown by `A11y.check()` when violations are found. */
+export declare class A11yError extends CraftdriverError {
+    readonly violations: A11yViolation[];
+    readonly result: A11yResult;
+    constructor(message: string, result: A11yResult);
+}
+/**
+ * Internal configuration object describing how an `A11y` instance should
+ * locate its target. Not part of the public API — produced by the
+ * `.a11y` accessor on `Browser`, `ElementHandle`, and `Locator`.
+ */
+export interface A11ySource {
+    driver: Driver;
+    /** Resolve the target element (omit for document-level audits). */
+    resolveTarget?: () => Promise<WebElement>;
+    /** Frame context switching for frame-bound locators. */
+    withContext?: <T>(fn: () => Promise<T>) => Promise<T>;
+}
+/**
+ * Ergonomic wrapper around axe-core. Obtain instances via the `.a11y`
+ * accessor on `Browser`, `ElementHandle`, or `Locator` — never construct
+ * directly.
+ *
+ * - `audit(options?)` returns the report.
+ * - `check(options?)` throws an `A11yError` when violations exist.
+ */
+export declare class A11y {
+    private source;
+    constructor(source: A11ySource);
+    /** Run an accessibility audit and return the report. */
+    audit(options?: A11yOptions): Promise<A11yResult>;
+    /**
+     * Run an audit and throw an `A11yError` if any violation is found.
+     *
+     * The thrown error carries the full `result` and `violations` for
+     * programmatic inspection.
+     */
+    check(options?: A11yOptions): Promise<void>;
+}
+//# sourceMappingURL=a11y.d.ts.map

package/dist/lib/a11y.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.d.ts","sourceRoot":"","sources":["../../src/lib/a11y.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAa,MAAM,aAAa,CAAC;AAE1D,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAEvE,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,wDAAwD;IACxD,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,0DAA0D;AAC1D,qBAAa,SAAU,SAAQ,gBAAgB;IAC7C,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;gBAChB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU;CAWhD;AA6ED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1C,wDAAwD;IACxD,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CACvD;AAED;;;;;;;GAOG;AACH,qBAAa,IAAI;IACH,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC,wDAAwD;IAClD,KAAK,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAgC3D;;;;;OAKG;IACG,KAAK,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAUtD"}

package/dist/lib/a11y.js

@@ -0,0 +1,171 @@
+import { CraftdriverError, ErrorCode } from './errors.js';
+/** Thrown by `A11y.check()` when violations are found. */
+export class A11yError extends CraftdriverError {
+    violations;
+    result;
+    constructor(message, result) {
+        super(ErrorCode.A11Y_VIOLATIONS, message, {
+            detail: {
+                violationCount: result.violations.length,
+                rules: result.violations.map((v) => v.id),
+            },
+        });
+        this.name = 'A11yError';
+        this.violations = result.violations;
+        this.result = result;
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal — axe-core loader
+// ---------------------------------------------------------------------------
+const IMPACT_RANK = {
+    minor: 0,
+    moderate: 1,
+    serious: 2,
+    critical: 3,
+};
+let _axeSourceCache = null;
+async function loadAxeSource() {
+    if (_axeSourceCache)
+        return _axeSourceCache;
+    let mod;
+    try {
+        mod = await import('axe-core');
+    }
+    catch (e) {
+        // axe-core ships as a direct dependency of craftdriver; if this fails
+        // the install is broken — surface the underlying error.
+        throw new Error(`craftdriver: failed to load axe-core. Try reinstalling dependencies. ` +
+            `Underlying error: ${e?.message ?? String(e)}`);
+    }
+    const candidate = mod?.source ??
+        mod?.default?.source;
+    if (typeof candidate !== 'string' || candidate.length === 0) {
+        throw new Error('craftdriver: the installed axe-core build does not expose a `.source` string.');
+    }
+    _axeSourceCache = candidate;
+    return candidate;
+}
+function buildAxeRunOptions(opts) {
+    if (opts.disableRules?.length && opts.rules?.length) {
+        throw new Error('craftdriver a11y: `disableRules` and `rules` are mutually exclusive. ' +
+            'Pick one or use `axeOptions` directly.');
+    }
+    const out = {};
+    if (opts.disableRules?.length) {
+        out.rules = Object.fromEntries(opts.disableRules.map((id) => [id, { enabled: false }]));
+    }
+    if (opts.rules?.length) {
+        out.runOnly = { type: 'rule', values: opts.rules };
+    }
+    // Caller-provided axeOptions win — escape hatch by design.
+    return { ...out, ...(opts.axeOptions ?? {}) };
+}
+function formatViolations(violations) {
+    return violations
+        .map((v) => {
+        const nodeCount = v.nodes.length;
+        const nodeLabel = nodeCount === 1 ? '1 node' : `${nodeCount} nodes`;
+        return (`  • ${v.id} (${v.impact}) — ${v.description}\n` +
+            `      ${nodeLabel} · ${v.helpUrl}`);
+    })
+        .join('\n');
+}
+/**
+ * Ergonomic wrapper around axe-core. Obtain instances via the `.a11y`
+ * accessor on `Browser`, `ElementHandle`, or `Locator` — never construct
+ * directly.
+ *
+ * - `audit(options?)` returns the report.
+ * - `check(options?)` throws an `A11yError` when violations exist.
+ */
+export class A11y {
+    source;
+    constructor(source) {
+        this.source = source;
+    }
+    /** Run an accessibility audit and return the report. */
+    async audit(options = {}) {
+        const axeOptions = buildAxeRunOptions(options);
+        const minImpact = options.minImpact ?? 'serious';
+        const withContext = this.source.withContext ?? ((fn) => fn());
+        return withContext(async () => {
+            const axeSource = await loadAxeSource();
+            const target = this.source.resolveTarget
+                ? await this.source.resolveTarget()
+                : null;
+            const raw = await this.source.driver.executeAsyncScript(AUDIT_SCRIPT, [target, axeSource, JSON.stringify(axeOptions)]);
+            if (!raw || !raw.ok) {
+                throw new Error(`craftdriver a11y: audit failed in the page — ${raw?.error ?? 'unknown error'}`);
+            }
+            const threshold = IMPACT_RANK[minImpact];
+            const filtered = (raw.result ?? { violations: [], passes: 0, incomplete: 0, inapplicable: 0 });
+            return {
+                ...filtered,
+                violations: filtered.violations.filter((v) => IMPACT_RANK[v.impact] >= threshold),
+            };
+        });
+    }
+    /**
+     * Run an audit and throw an `A11yError` if any violation is found.
+     *
+     * The thrown error carries the full `result` and `violations` for
+     * programmatic inspection.
+     */
+    async check(options = {}) {
+        const result = await this.audit(options);
+        if (result.violations.length === 0)
+            return;
+        const count = result.violations.length;
+        const noun = count === 1 ? 'violation' : 'violations';
+        throw new A11yError(`Accessibility check found ${count} ${noun}:\n${formatViolations(result.violations)}`, result);
+    }
+}
+// ---------------------------------------------------------------------------
+// Page-side script — kept as a constant so it's easy to audit.
+// ---------------------------------------------------------------------------
+const AUDIT_SCRIPT = `
+  var target = arguments[0];
+  var axeSource = arguments[1];
+  var optsJson = arguments[2];
+  var done = arguments[arguments.length - 1];
+  try {
+    if (!window.__craftdriverAxeLoaded) {
+      // eslint-disable-next-line no-new-func
+      (new Function(axeSource)).call(window);
+      window.__craftdriverAxeLoaded = true;
+    }
+    var ctx = target || document;
+    var opts = JSON.parse(optsJson);
+    window.axe.run(ctx, opts).then(function (r) {
+      done({
+        ok: true,
+        result: {
+          violations: (r.violations || []).map(function (v) {
+            return {
+              id: v.id,
+              impact: v.impact || 'minor',
+              description: v.description,
+              helpUrl: v.helpUrl,
+              nodes: (v.nodes || []).map(function (n) {
+                return {
+                  target: (n.target || []).map(String),
+                  html: n.html,
+                  failureSummary: n.failureSummary || '',
+                };
+              }),
+            };
+          }),
+          passes: (r.passes || []).length,
+          incomplete: (r.incomplete || []).length,
+          inapplicable: (r.inapplicable || []).length,
+        },
+      });
+    }, function (err) {
+      done({ ok: false, error: (err && err.message) ? err.message : String(err) });
+    });
+  } catch (e) {
+    done({ ok: false, error: (e && e.message) ? e.message : String(e) });
+  }
+`;
+//# sourceMappingURL=a11y.js.map