@monoes/monobrowse 1.0.12 → 1.0.14

package/dist/src/report/analyze.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Budget evaluation — the step that makes "the agent tested it" mean
+ * something. Pure function of CaptureData + Budget, so CI behaviour is
+ * testable without a browser.
+ */
+import type { Budget, BudgetFailure, CaptureData, ConsoleEntry, Report, RequestEntry, VerdictValue } from './types.js';
+export declare function consoleErrors(entries: ConsoleEntry[]): ConsoleEntry[];
+export declare function consoleWarnings(entries: ConsoleEntry[]): ConsoleEntry[];
+export declare function failedRequests(requests: RequestEntry[]): RequestEntry[];
+export interface Evaluation {
+    verdict: VerdictValue;
+    failures: BudgetFailure[];
+    /** Budgets that were set but could not be checked — the page never reported the metric. */
+    unmeasured: string[];
+}
+export declare function evaluateBudget(data: CaptureData, budget: Budget): Evaluation;
+export declare function buildReport(data: CaptureData, budget: Budget): Report;
+/** One line for a CI log / agent transcript. */
+export declare function summarizeVerdict(report: Report): string;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/src/report/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/report/analyze.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAEV,MAAM,EACN,aAAa,EACb,WAAW,EACX,YAAY,EACZ,MAAM,EACN,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAC;AAKpB,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAErE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAEvE;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAEvE;AAgCD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,2FAA2F;IAC3F,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CA+E5E;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAmBrE;AAED,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMvD"}

package/dist/src/report/analyze.js

@@ -0,0 +1,136 @@
+/**
+ * Budget evaluation — the step that makes "the agent tested it" mean
+ * something. Pure function of CaptureData + Budget, so CI behaviour is
+ * testable without a browser.
+ */
+import { countA11y } from './a11y.js';
+import { budgetLabel, formatThreshold } from './budget.js';
+/** How many concrete examples to quote in a failure's `detail`. */
+const DETAIL_SAMPLE = 3;
+export function consoleErrors(entries) {
+    return entries.filter((e) => e.type === 'error');
+}
+export function consoleWarnings(entries) {
+    return entries.filter((e) => e.type === 'warn' || e.type === 'warning');
+}
+export function failedRequests(requests) {
+    return requests.filter((r) => r.failed);
+}
+function truncate(text, max = 160) {
+    const flat = text.replace(/\s+/g, ' ').trim();
+    return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;
+}
+function sample(items) {
+    // Not `.map(truncate)`: map passes the index as the second argument, which
+    // would become truncate's `max` and shave every sample down to nothing.
+    const shown = items.slice(0, DETAIL_SAMPLE).map((item) => truncate(item));
+    const rest = items.length - shown.length;
+    return rest > 0 ? `${shown.join(' | ')} (+${rest} more)` : shown.join(' | ');
+}
+function describeRequest(r) {
+    const status = r.status !== undefined ? String(r.status) : (r.errorText ?? 'no response');
+    return `${status} ${r.method} ${r.url}`;
+}
+export function evaluateBudget(data, budget) {
+    const failures = [];
+    const unmeasured = [];
+    const cErrors = consoleErrors(data.console);
+    const failed = failedRequests(data.requests);
+    const a11y = countA11y(data.a11y);
+    const counts = [
+        {
+            key: 'maxConsoleErrors',
+            actual: cErrors.length,
+            detail: sample(cErrors.map((e) => e.text)),
+        },
+        {
+            key: 'maxPageErrors',
+            actual: data.pageErrors.length,
+            detail: sample(data.pageErrors.map((e) => e.text)),
+        },
+        {
+            key: 'maxFailedRequests',
+            actual: failed.length,
+            detail: sample(failed.map(describeRequest)),
+        },
+        {
+            key: 'maxA11yErrors',
+            actual: a11y.errors,
+            detail: sample(data.a11y
+                .filter((f) => f.impact === 'error')
+                .map((f) => `${f.rule} at ${f.locator}`)),
+        },
+    ];
+    for (const check of counts) {
+        const limit = budget[check.key];
+        if (limit === null)
+            continue;
+        if (check.actual > limit) {
+            failures.push({
+                budget: check.key,
+                expected: formatThreshold(check.key, limit),
+                actual: String(check.actual),
+                detail: check.detail || undefined,
+            });
+        }
+    }
+    const ms = (v) => `${Math.round(v)}ms`;
+    const score = (v) => v.toFixed(4).replace(/0+$/, '').replace(/\.$/, '');
+    const metrics = [
+        { key: 'lcpMs', actual: data.vitals.lcp, format: ms },
+        { key: 'clsScore', actual: data.vitals.cls, format: score },
+        { key: 'inpMs', actual: data.vitals.inp, format: ms },
+        { key: 'fcpMs', actual: data.vitals.fcp, format: ms },
+        { key: 'ttfbMs', actual: data.vitals.ttfb, format: ms },
+    ];
+    for (const metric of metrics) {
+        const limit = budget[metric.key];
+        if (limit === null)
+            continue;
+        if (metric.actual === undefined || !Number.isFinite(metric.actual)) {
+            // A page that never fires an LCP entry (no contentful paint, an
+            // observer the browser does not support, a collector that timed out)
+            // must not be silently graded as passing — but it is not a breach
+            // either. Surface it as unmeasured and let the report say so.
+            unmeasured.push(budgetLabel(metric.key));
+            continue;
+        }
+        if (metric.actual > limit) {
+            failures.push({
+                budget: metric.key,
+                expected: formatThreshold(metric.key, limit),
+                actual: metric.format(metric.actual),
+            });
+        }
+    }
+    return { verdict: failures.length > 0 ? 'fail' : 'pass', failures, unmeasured };
+}
+export function buildReport(data, budget) {
+    const evaluation = evaluateBudget(data, budget);
+    const a11y = countA11y(data.a11y);
+    return {
+        ...data,
+        budget,
+        verdict: evaluation.verdict,
+        failures: evaluation.failures,
+        unmeasured: evaluation.unmeasured,
+        counts: {
+            consoleErrors: consoleErrors(data.console).length,
+            consoleWarnings: consoleWarnings(data.console).length,
+            pageErrors: data.pageErrors.length,
+            requests: data.requests.length,
+            failedRequests: failedRequests(data.requests).length,
+            a11yErrors: a11y.errors,
+            a11yWarnings: a11y.warnings,
+        },
+    };
+}
+/** One line for a CI log / agent transcript. */
+export function summarizeVerdict(report) {
+    if (report.verdict === 'pass') {
+        return `PASS — ${report.counts.requests} requests, 0 budget failures`;
+    }
+    const names = report.failures.map((f) => budgetLabel(f.budget)).join(', ');
+    return `FAIL — ${report.failures.length} budget failure(s): ${names}`;
+}
+//# sourceMappingURL=analyze.js.map

package/dist/src/report/analyze.js.map

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

package/dist/src/report/budget.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Budget parsing for `monobrowse report`.
+ *
+ * A budget is what turns "the agent looked at the page" into "the agent
+ * tested the page": the thresholds the run is gated on. Defaults are the
+ * strict ones you actually want in CI — zero errors, zero failed requests,
+ * Core Web Vitals at Google's "good" boundary.
+ */
+import type { Budget } from './types.js';
+export declare const DEFAULT_BUDGET: Budget;
+export declare function budgetLabel(key: keyof Budget): string;
+/** `2500` -> `<= 2500ms`, `0` -> `<= 0`, `0.1` -> `<= 0.1`. */
+export declare function formatThreshold(key: keyof Budget, value: number): string;
+/**
+ * Turn a parsed JSON object into a Budget, merged over the defaults.
+ *
+ * Unknown keys throw rather than being ignored: a typo'd `max_console_error`
+ * silently loosening a CI gate is exactly the failure mode budgets exist to
+ * prevent.
+ */
+export declare function parseBudget(input: unknown, source?: string): Budget;
+/**
+ * Resolve `--budget`. The value is either inline JSON (starts with `{`) or a
+ * path to a JSON file. Omitted means DEFAULT_BUDGET.
+ */
+export declare function loadBudget(spec?: string): Promise<Budget>;
+//# sourceMappingURL=budget.d.ts.map

package/dist/src/report/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../src/report/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,eAAO,MAAM,cAAc,EAAE,MAU5B,CAAC;AAiDF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,MAAM,GAAG,MAAM,CAErD;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIxE;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,SAAW,GAAG,MAAM,CA4BrE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B/D"}

package/dist/src/report/budget.js

@@ -0,0 +1,143 @@
+/**
+ * Budget parsing for `monobrowse report`.
+ *
+ * A budget is what turns "the agent looked at the page" into "the agent
+ * tested the page": the thresholds the run is gated on. Defaults are the
+ * strict ones you actually want in CI — zero errors, zero failed requests,
+ * Core Web Vitals at Google's "good" boundary.
+ */
+import { readFile } from 'node:fs/promises';
+export const DEFAULT_BUDGET = {
+    maxConsoleErrors: 0,
+    maxPageErrors: 0,
+    maxFailedRequests: 0,
+    maxA11yErrors: 0,
+    lcpMs: 2500,
+    clsScore: 0.1,
+    inpMs: 200,
+    fcpMs: null,
+    ttfbMs: null,
+};
+/** Every spelling we accept, normalized (lowercased, `_`/`-` stripped). */
+const KEY_ALIASES = {
+    maxconsoleerrors: 'maxConsoleErrors',
+    consoleerrors: 'maxConsoleErrors',
+    maxpageerrors: 'maxPageErrors',
+    pageerrors: 'maxPageErrors',
+    maxfailedrequests: 'maxFailedRequests',
+    failedrequests: 'maxFailedRequests',
+    maxa11yerrors: 'maxA11yErrors',
+    a11yerrors: 'maxA11yErrors',
+    maxaccessibilityerrors: 'maxA11yErrors',
+    lcp: 'lcpMs',
+    lcpms: 'lcpMs',
+    cls: 'clsScore',
+    clsscore: 'clsScore',
+    inp: 'inpMs',
+    inpms: 'inpMs',
+    fcp: 'fcpMs',
+    fcpms: 'fcpMs',
+    ttfb: 'ttfbMs',
+    ttfbms: 'ttfbMs',
+};
+const BUDGET_UNITS = {
+    maxConsoleErrors: 'count',
+    maxPageErrors: 'count',
+    maxFailedRequests: 'count',
+    maxA11yErrors: 'count',
+    lcpMs: 'ms',
+    clsScore: 'score',
+    inpMs: 'ms',
+    fcpMs: 'ms',
+    ttfbMs: 'ms',
+};
+const BUDGET_LABELS = {
+    maxConsoleErrors: 'Console errors',
+    maxPageErrors: 'Uncaught page errors',
+    maxFailedRequests: 'Failed requests',
+    maxA11yErrors: 'Accessibility errors',
+    lcpMs: 'LCP (Largest Contentful Paint)',
+    clsScore: 'CLS (Cumulative Layout Shift)',
+    inpMs: 'INP (Interaction to Next Paint)',
+    fcpMs: 'FCP (First Contentful Paint)',
+    ttfbMs: 'TTFB (Time to First Byte)',
+};
+export function budgetLabel(key) {
+    return BUDGET_LABELS[key];
+}
+/** `2500` -> `<= 2500ms`, `0` -> `<= 0`, `0.1` -> `<= 0.1`. */
+export function formatThreshold(key, value) {
+    const unit = BUDGET_UNITS[key];
+    if (unit === 'ms')
+        return `<= ${value}ms`;
+    return `<= ${value}`;
+}
+function normalizeKey(raw) {
+    return raw.toLowerCase().replace(/[_\-\s]/g, '');
+}
+/**
+ * Turn a parsed JSON object into a Budget, merged over the defaults.
+ *
+ * Unknown keys throw rather than being ignored: a typo'd `max_console_error`
+ * silently loosening a CI gate is exactly the failure mode budgets exist to
+ * prevent.
+ */
+export function parseBudget(input, source = 'budget') {
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        throw new Error(`Invalid ${source}: expected a JSON object of budget keys`);
+    }
+    const budget = { ...DEFAULT_BUDGET };
+    for (const [rawKey, rawValue] of Object.entries(input)) {
+        const key = KEY_ALIASES[normalizeKey(rawKey)];
+        if (!key) {
+            throw new Error(`Unknown budget key "${rawKey}" in ${source}. Known keys: ${Object.keys(DEFAULT_BUDGET).join(', ')}`);
+        }
+        if (rawValue === null) {
+            budget[key] = null;
+            continue;
+        }
+        if (typeof rawValue !== 'number' || !Number.isFinite(rawValue)) {
+            throw new Error(`Budget "${rawKey}" must be a number or null, got ${JSON.stringify(rawValue)}`);
+        }
+        if (rawValue < 0) {
+            throw new Error(`Budget "${rawKey}" must not be negative, got ${rawValue}`);
+        }
+        budget[key] = rawValue;
+    }
+    return budget;
+}
+/**
+ * Resolve `--budget`. The value is either inline JSON (starts with `{`) or a
+ * path to a JSON file. Omitted means DEFAULT_BUDGET.
+ */
+export async function loadBudget(spec) {
+    if (spec === undefined || spec === '')
+        return { ...DEFAULT_BUDGET };
+    const trimmed = spec.trim();
+    if (trimmed.startsWith('{')) {
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch (err) {
+            throw new Error(`--budget is not valid JSON: ${err.message}`);
+        }
+        return parseBudget(parsed, 'inline --budget');
+    }
+    let text;
+    try {
+        text = await readFile(trimmed, 'utf8');
+    }
+    catch {
+        throw new Error(`Budget file not found or unreadable: ${trimmed}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (err) {
+        throw new Error(`Budget file ${trimmed} is not valid JSON: ${err.message}`);
+    }
+    return parseBudget(parsed, trimmed);
+}
+//# sourceMappingURL=budget.js.map

package/dist/src/report/budget.js.map

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

package/dist/src/report/collect-a11y.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The browser-facing half of the accessibility check: fetch the AX tree,
+ * sweep the DOM for tabindex (which the AX tree does not expose at all), and
+ * turn `ax-node:<id>` placeholders into real CSS selectors a human or an
+ * agent can act on. The rules themselves live in a11y.ts and stay pure.
+ */
+import type { CdpClient } from '../browser/cdp.js';
+import type { A11yFinding, AxNode, StructureNode } from './types.js';
+/**
+ * Rewrites `ax-node:<id>` placeholder locators into real CSS selectors.
+ * Bounded: a page with 400 unlabelled buttons must not cost 400 CDP
+ * round-trips, and nobody reads the 400th finding anyway.
+ */
+export declare function upgradeLocators(client: CdpClient, sessionId: string, findings: A11yFinding[], nodes: AxNode[]): Promise<A11yFinding[]>;
+export interface A11yResult {
+    findings: A11yFinding[];
+    /**
+     * Flat signature of the same tree, for the run-to-run structural diff. It
+     * rides along here because the AX tree is already in hand — fetching it
+     * twice would double the cost of the most expensive collector.
+     */
+    structure: StructureNode[];
+}
+export declare function collectA11y(client: CdpClient, sessionId: string, notes: string[]): Promise<A11yResult>;
+//# sourceMappingURL=collect-a11y.d.ts.map

package/dist/src/report/collect-a11y.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-a11y.d.ts","sourceRoot":"","sources":["../../../src/report/collect-a11y.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAkB,aAAa,EAAE,MAAM,YAAY,CAAC;AAgGrF;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,WAAW,EAAE,CAAC,CA2BxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB;;;;OAIG;IACH,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,UAAU,CAAC,CAuCrB"}

package/dist/src/report/collect-a11y.js

@@ -0,0 +1,154 @@
+/**
+ * The browser-facing half of the accessibility check: fetch the AX tree,
+ * sweep the DOM for tabindex (which the AX tree does not expose at all), and
+ * turn `ax-node:<id>` placeholders into real CSS selectors a human or an
+ * agent can act on. The rules themselves live in a11y.ts and stay pure.
+ */
+import { evaluateJs } from '../browser/actions.js';
+import { runA11yRules } from './a11y.js';
+import { buildStructure } from './structure.js';
+import { message, STEP_TIMEOUT_MS, withTimeout } from './util.js';
+/** Most AX findings we will spend a DOM round-trip on to get a real selector. */
+const MAX_LOCATOR_LOOKUPS = 60;
+/** Builds a short, stable CSS selector for an element, from inside the page. */
+const LOCATOR_FN = `function(){
+  var el = this;
+  if (!el || el.nodeType !== 1) return '';
+  var esc = function(s){ return window.CSS && CSS.escape ? CSS.escape(s) : s; };
+  if (el.id) return '#' + esc(el.id);
+  var parts = [], node = el, depth = 0;
+  while (node && node.nodeType === 1 && depth < 5) {
+    var part = node.tagName.toLowerCase();
+    if (node.id) { parts.unshift('#' + esc(node.id)); break; }
+    var parent = node.parentElement;
+    if (parent) {
+      var sibs = Array.prototype.filter.call(parent.children, function(c){ return c.tagName === node.tagName; });
+      if (sibs.length > 1) part += ':nth-of-type(' + (sibs.indexOf(node) + 1) + ')';
+    }
+    parts.unshift(part);
+    node = parent;
+    depth++;
+  }
+  return parts.join(' > ');
+}`;
+/** DOM sweep for tabindex — the AX tree does not expose it at all. */
+const FOCUS_CANDIDATES_JS = `(function(){
+  try {
+    var esc = function(s){ return window.CSS && CSS.escape ? CSS.escape(s) : s; };
+    var loc = function(el){
+      if (el.id) return '#' + esc(el.id);
+      var parts = [], node = el, depth = 0;
+      while (node && node.nodeType === 1 && depth < 5) {
+        var part = node.tagName.toLowerCase();
+        if (node.id) { parts.unshift('#' + esc(node.id)); break; }
+        var parent = node.parentElement;
+        if (parent) {
+          var sibs = Array.prototype.filter.call(parent.children, function(c){ return c.tagName === node.tagName; });
+          if (sibs.length > 1) part += ':nth-of-type(' + (sibs.indexOf(node) + 1) + ')';
+        }
+        parts.unshift(part);
+        node = parent;
+        depth++;
+      }
+      return parts.join(' > ');
+    };
+    var out = [];
+    var els = document.querySelectorAll('[tabindex]');
+    for (var i = 0; i < els.length && out.length < 100; i++) {
+      var el = els[i];
+      var ti = parseInt(el.getAttribute('tabindex'), 10);
+      if (!(ti < 0)) continue;
+      var name = (el.getAttribute('aria-label') || el.getAttribute('title') || (el.textContent || '')).trim();
+      out.push({
+        tag: el.tagName.toLowerCase(),
+        role: (el.getAttribute('role') || '').toLowerCase(),
+        name: name ? name.slice(0, 120) : null,
+        tabindex: ti,
+        locator: loc(el)
+      });
+    }
+    return out;
+  } catch (e) { return []; }
+})()`;
+async function resolveLocator(client, sessionId, backendNodeId) {
+    try {
+        const resolved = await client.send('DOM.resolveNode', { backendNodeId }, sessionId);
+        const objectId = resolved.object?.objectId;
+        if (!objectId)
+            return null;
+        try {
+            const call = await client.send('Runtime.callFunctionOn', { functionDeclaration: LOCATOR_FN, objectId, returnByValue: true }, sessionId);
+            return call.result?.value || null;
+        }
+        finally {
+            await client.send('Runtime.releaseObject', { objectId }, sessionId).catch(() => { });
+        }
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Rewrites `ax-node:<id>` placeholder locators into real CSS selectors.
+ * Bounded: a page with 400 unlabelled buttons must not cost 400 CDP
+ * round-trips, and nobody reads the 400th finding anyway.
+ */
+export async function upgradeLocators(client, sessionId, findings, nodes) {
+    const backendByNodeId = new Map();
+    for (const n of nodes) {
+        if (n.backendDOMNodeId !== undefined)
+            backendByNodeId.set(String(n.nodeId), n.backendDOMNodeId);
+    }
+    let budget = MAX_LOCATOR_LOOKUPS;
+    const cache = new Map();
+    const out = [];
+    for (const finding of findings) {
+        if (!finding.locator.startsWith('ax-node:') || budget <= 0) {
+            out.push(finding);
+            continue;
+        }
+        const backendId = backendByNodeId.get(finding.locator.slice('ax-node:'.length));
+        if (backendId === undefined) {
+            out.push(finding);
+            continue;
+        }
+        if (!cache.has(backendId)) {
+            budget--;
+            cache.set(backendId, await resolveLocator(client, sessionId, backendId));
+        }
+        const selector = cache.get(backendId);
+        out.push(selector ? { ...finding, locator: selector } : finding);
+    }
+    return out;
+}
+export async function collectA11y(client, sessionId, notes) {
+    let nodes = [];
+    try {
+        const tree = await withTimeout(client.send('Accessibility.getFullAXTree', {}, sessionId), STEP_TIMEOUT_MS, 'accessibility tree');
+        nodes = tree.nodes ?? [];
+    }
+    catch (err) {
+        notes.push(`Accessibility tree unavailable: ${message(err)}`);
+        return { findings: [], structure: [] };
+    }
+    let focusCandidates = [];
+    try {
+        const raw = await withTimeout(evaluateJs(client, sessionId, FOCUS_CANDIDATES_JS), STEP_TIMEOUT_MS, 'tabindex sweep');
+        if (Array.isArray(raw))
+            focusCandidates = raw;
+    }
+    catch (err) {
+        notes.push(`Tabindex sweep skipped: ${message(err)}`);
+    }
+    const structure = buildStructure(nodes);
+    const findings = runA11yRules({ nodes, focusCandidates });
+    try {
+        const upgraded = await withTimeout(upgradeLocators(client, sessionId, findings, nodes), STEP_TIMEOUT_MS, 'locator resolution');
+        return { findings: upgraded, structure };
+    }
+    catch {
+        notes.push('Some accessibility locators could not be resolved to CSS selectors.');
+        return { findings, structure };
+    }
+}
+//# sourceMappingURL=collect-a11y.js.map

package/dist/src/report/collect-a11y.js.map

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

package/dist/src/report/collect.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Drives the browser and gathers the raw material for a report.
+ *
+ * Resilience is the design constraint: a page with no vitals, a site that
+ * never goes network-idle, a CSP that blocks our evaluate — each must
+ * degrade into a note in the report, never a hang and never a crash. Every
+ * collector is individually timed out and individually try/caught, and this
+ * function always returns a CaptureData.
+ */
+import type { CdpClient } from '../browser/cdp.js';
+import type { EvidenceRecorderOptions } from './evidence.js';
+import type { CaptureData, RequestEntry } from './types.js';
+export interface CollectOptions {
+    url: string;
+    /** A CSS selector to wait for, or a number of milliseconds. */
+    wait?: string | number;
+    /** Device names from `listDevices()` to add to the screenshot matrix. */
+    devices?: string[];
+    vitalsWaitMs?: number;
+    loadTimeoutMs?: number;
+    screenshotDir?: string;
+    fullPage?: boolean;
+    /** Record screencast frames for the evidence timeline (RIG-11). */
+    record?: boolean;
+    recordOptions?: EvidenceRecorderOptions;
+}
+interface FailureRecord {
+    errorText?: string;
+    blockedReason?: string;
+    canceled?: boolean;
+}
+export interface CapturedRequestLike {
+    id: string;
+    url: string;
+    method: string;
+    status?: number;
+    mimeType?: string;
+    startTime: number;
+    endTime?: number;
+    encodedSize?: number;
+}
+export declare function toRequestEntries(captured: CapturedRequestLike[], failures: Map<string, FailureRecord>, clockOffsetMs?: number): RequestEntry[];
+export declare function collect(client: CdpClient, sessionId: string, options: CollectOptions): Promise<CaptureData>;
+export {};
+//# sourceMappingURL=collect.d.ts.map

package/dist/src/report/collect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../../src/report/collect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAmBnD,OAAO,KAAK,EAAoB,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE/E,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAA0B,MAAM,YAAY,CAAC;AAGpF,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,uBAAuB,CAAC;CACzC;AAWD,UAAU,aAAa;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkDD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EACpC,aAAa,CAAC,EAAE,MAAM,GACrB,YAAY,EAAE,CAuBhB;AA2GD,wBAAsB,OAAO,CAC3B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,WAAW,CAAC,CAgJtB"}