@monoes/monobrowse 1.0.12 → 1.0.13

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"}

package/dist/src/report/collect.js

@@ -0,0 +1,275 @@
+/**
+ * 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 { evaluateJs } from '../browser/actions.js';
+import { getCurrentTitle, getCurrentUrl, openUrl, waitForLoad } from '../browser/browser.js';
+import { clearConsoleMessages, clearPageErrors, enableConsoleCapture, getConsoleMessages, getPageErrors, setupConsoleCapture, } from '../browser/console-log.js';
+import { emulateDevice, listDevices } from '../browser/emulation.js';
+import { clearCapturedRequests, getCapturedRequests, startRequestCapture, } from '../browser/network.js';
+import { captureScreenshot } from '../browser/screenshot.js';
+import { collectVitals } from '../browser/vitals.js';
+import { waitFor } from '../browser/wait.js';
+import { collectA11y } from './collect-a11y.js';
+import { startEvidenceRecorder } from './evidence.js';
+import { message, STEP_TIMEOUT_MS, sleep, withTimeout } from './util.js';
+const DEFAULT_VITALS_WAIT_MS = 2500;
+const DEFAULT_LOAD_TIMEOUT_MS = 20_000;
+/** Cap on inlined screenshot bytes so the single HTML file stays openable. */
+const MAX_INLINE_BYTES = 12 * 1024 * 1024;
+/**
+ * CDP reports request timings on a monotonic clock with an arbitrary epoch,
+ * which cannot be compared with the `Date.now()` stamps on console entries.
+ * Sampling both clocks on the first request we see gives an offset that puts
+ * every request on the same timeline as everything else (RIG-11).
+ */
+function trackClockOffset(client, sessionId) {
+    let offset;
+    const off = client.on('Network.requestWillBeSent', (params, sid) => {
+        if (sid !== sessionId || offset !== undefined)
+            return;
+        const p = params;
+        if (typeof p.timestamp !== 'number')
+            return;
+        offset = Date.now() - p.timestamp * 1000;
+    });
+    return { offset: () => offset, stop: off };
+}
+/**
+ * `startRequestCapture` records timings but drops `Network.loadingFailed`'s
+ * errorText, so a DNS failure and a still-in-flight request look identical in
+ * its output. Listen alongside it rather than editing it.
+ */
+function trackLoadingFailures(client, sessionId) {
+    const failures = new Map();
+    const off = client.on('Network.loadingFailed', (params, sid) => {
+        if (sid !== sessionId)
+            return;
+        const p = params;
+        if (!p.requestId)
+            return;
+        failures.set(p.requestId, {
+            errorText: p.errorText,
+            blockedReason: p.blockedReason,
+            canceled: p.canceled,
+        });
+    });
+    return { failures, stop: off };
+}
+export function toRequestEntries(captured, failures, clockOffsetMs) {
+    return captured.map((r) => {
+        const failure = failures.get(r.id);
+        const httpError = r.status !== undefined && r.status >= 400;
+        // A cancelled request is usually the page itself aborting a fetch on
+        // navigation — noise, not a defect. A blockedReason (CSP, mixed content,
+        // an ad blocker) is a real failure even though CDP also marks it cancelled.
+        const hardFailure = failure !== undefined && (!failure.canceled || !!failure.blockedReason);
+        const errorText = failure?.blockedReason
+            ? `blocked: ${failure.blockedReason}`
+            : (failure?.errorText ?? undefined);
+        return {
+            url: r.url,
+            method: r.method,
+            startedAtMs: clockOffsetMs === undefined ? undefined : r.startTime + clockOffsetMs,
+            status: r.status,
+            mimeType: r.mimeType,
+            durationMs: r.endTime !== undefined ? Math.max(0, r.endTime - r.startTime) : undefined,
+            encodedSize: r.encodedSize,
+            failed: httpError || hardFailure,
+            errorText: hardFailure ? errorText : undefined,
+        };
+    });
+}
+// ---------------------------------------------------------------------------
+// Screenshots
+// ---------------------------------------------------------------------------
+async function measure(client, sessionId, fullPage) {
+    try {
+        const raw = await evaluateJs(client, sessionId, fullPage
+            ? '({width: document.documentElement.scrollWidth, height: document.documentElement.scrollHeight})'
+            : '({width: window.innerWidth, height: window.innerHeight})');
+        const size = raw;
+        return { width: Math.round(size?.width ?? 0), height: Math.round(size?.height ?? 0) };
+    }
+    catch {
+        return { width: 0, height: 0 };
+    }
+}
+async function takeShot(client, sessionId, label, fullPage, dir, notes, inlineBudget) {
+    try {
+        const slug = label.replace(/[^a-z0-9]+/gi, '-').toLowerCase();
+        const path = dir ? `${dir}/${slug}.png` : undefined;
+        const shot = await withTimeout(captureScreenshot(client, sessionId, { fullPage, path }), STEP_TIMEOUT_MS, `screenshot (${label})`);
+        if (shot.dataUrl.length > inlineBudget.left) {
+            notes.push(`Screenshot "${label}" omitted from the HTML — inlining it would blow the size budget.`);
+            return null;
+        }
+        inlineBudget.left -= shot.dataUrl.length;
+        const size = await measure(client, sessionId, fullPage);
+        return {
+            label,
+            width: size.width,
+            height: size.height,
+            dataUrl: shot.dataUrl,
+            path: shot.path,
+        };
+    }
+    catch (err) {
+        notes.push(`Screenshot "${label}" failed: ${message(err)}`);
+        return null;
+    }
+}
+async function captureDeviceMatrix(client, sessionId, url, devices, dir, notes, inlineBudget) {
+    const known = new Set(listDevices());
+    const shots = [];
+    for (const device of devices) {
+        if (!known.has(device)) {
+            notes.push(`Unknown device "${device}" — known devices: ${[...known].join(', ')}`);
+            continue;
+        }
+        try {
+            await emulateDevice(client, sessionId, device);
+            // Re-navigate: responsive layout and media queries only settle on a
+            // fresh load, so resizing an already-rendered page can photograph a
+            // layout the device would never actually produce.
+            await openUrl(client, sessionId, url).catch(() => { });
+            await waitForLoad(client, sessionId, 'domcontentloaded', 5000).catch(() => { });
+            const shot = await takeShot(client, sessionId, device, false, dir, notes, inlineBudget);
+            if (shot)
+                shots.push(shot);
+        }
+        catch (err) {
+            notes.push(`Device "${device}" skipped: ${message(err)}`);
+        }
+    }
+    // Put the tab back the way we found it, so a later command in the same
+    // session is not silently stuck emulating an iPhone.
+    await client.send('Emulation.clearDeviceMetricsOverride', {}, sessionId).catch(() => { });
+    await client
+        .send('Emulation.setTouchEmulationEnabled', { enabled: false }, sessionId)
+        .catch(() => { });
+    await client.send('Emulation.setUserAgentOverride', { userAgent: '' }, sessionId).catch(() => { });
+    return shots;
+}
+// ---------------------------------------------------------------------------
+// Orchestration
+// ---------------------------------------------------------------------------
+export async function collect(client, sessionId, options) {
+    const notes = [];
+    const startedAt = Date.now();
+    const capturedAt = new Date().toISOString();
+    const loadTimeoutMs = options.loadTimeoutMs ?? DEFAULT_LOAD_TIMEOUT_MS;
+    const fullPage = options.fullPage ?? true;
+    // Capture must be armed BEFORE navigating, or the errors and requests that
+    // fire during load — the interesting ones — are already gone.
+    setupConsoleCapture(client, sessionId);
+    await enableConsoleCapture(client, sessionId).catch(() => { });
+    clearConsoleMessages(sessionId);
+    clearPageErrors(sessionId);
+    startRequestCapture(client, sessionId);
+    clearCapturedRequests(sessionId);
+    const tracker = trackLoadingFailures(client, sessionId);
+    const clock = trackClockOffset(client, sessionId);
+    // Armed before navigation for the same reason console capture is: the
+    // frames worth having are the ones showing the page fail to load.
+    let recorder = null;
+    if (options.record) {
+        try {
+            recorder = await startEvidenceRecorder(client, sessionId, startedAt, options.recordOptions);
+        }
+        catch (err) {
+            notes.push(`Screen recording unavailable: ${message(err)}`);
+        }
+    }
+    try {
+        const navigation = openUrl(client, sessionId, options.url)
+            .then(() => 'ok')
+            .catch((err) => {
+            notes.push(`Navigation reported an error: ${message(err)}`);
+            return 'error';
+        });
+        const outcome = await Promise.race([
+            navigation,
+            sleep(loadTimeoutMs).then(() => 'timeout'),
+        ]);
+        if (outcome === 'timeout') {
+            notes.push(`Page never went network-idle within ${loadTimeoutMs}ms — reporting on what had loaded by then.`);
+            await waitForLoad(client, sessionId, 'domcontentloaded', 5000).catch(() => { });
+        }
+        if (options.wait !== undefined) {
+            const waitMs = typeof options.wait === 'number' ? options.wait : Number(options.wait);
+            try {
+                if (Number.isFinite(waitMs)) {
+                    await sleep(waitMs);
+                }
+                else {
+                    await waitFor(client, sessionId, { selector: String(options.wait), timeout: 15_000 });
+                }
+            }
+            catch (err) {
+                notes.push(`--wait not satisfied: ${message(err)}`);
+            }
+        }
+        let vitals = {};
+        const vitalsWaitMs = options.vitalsWaitMs ?? DEFAULT_VITALS_WAIT_MS;
+        try {
+            vitals = await withTimeout(collectVitals(client, sessionId, vitalsWaitMs), vitalsWaitMs + STEP_TIMEOUT_MS, 'web vitals');
+        }
+        catch (err) {
+            notes.push(`Web vitals unavailable: ${message(err)}`);
+        }
+        const a11y = await collectA11y(client, sessionId, notes);
+        // Stop before the screenshots: a device matrix re-navigates the page
+        // several times, and those frames belong to no failure worth explaining.
+        if (recorder)
+            await recorder.stop().catch(() => { });
+        const finalUrl = await getCurrentUrl(client, sessionId).catch(() => options.url);
+        const title = await getCurrentTitle(client, sessionId).catch(() => '');
+        const consoleEntries = getConsoleMessages(sessionId);
+        const pageErrors = getPageErrors(sessionId);
+        const requests = toRequestEntries(getCapturedRequests(sessionId), tracker.failures, clock.offset());
+        const inlineBudget = { left: MAX_INLINE_BYTES };
+        const screenshots = [];
+        const main = await takeShot(client, sessionId, 'page', fullPage, options.screenshotDir, notes, inlineBudget);
+        if (main)
+            screenshots.push(main);
+        if (options.devices?.length) {
+            screenshots.push(...(await captureDeviceMatrix(client, sessionId, options.url, options.devices, options.screenshotDir, notes, inlineBudget)));
+        }
+        return {
+            url: options.url,
+            finalUrl,
+            title,
+            capturedAt,
+            durationMs: Date.now() - startedAt,
+            console: consoleEntries,
+            pageErrors,
+            requests,
+            vitals,
+            a11y: a11y.findings,
+            structure: a11y.structure,
+            screenshots,
+            notes,
+            recording: recorder
+                ? {
+                    startedAtMs: startedAt,
+                    frames: recorder.frames,
+                    droppedFrames: recorder.droppedFrames,
+                    requested: true,
+                }
+                : undefined,
+        };
+    }
+    finally {
+        tracker.stop();
+        clock.stop();
+        if (recorder)
+            await recorder.stop().catch(() => { });
+    }
+}
+//# sourceMappingURL=collect.js.map

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

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

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

@@ -0,0 +1,80 @@
+/**
+ * Recorded evidence for a bug report (RIG-11).
+ *
+ * When a run breaches its budget, "LCP was 4.1s" is a number; the frames
+ * either side of the moment it went wrong, lined up against the console and
+ * network entries from the same instant, is a bug report. This module records
+ * the frames and assembles that timeline.
+ *
+ * Size is the hard constraint. A screencast is tens of megabytes and a report
+ * is a single self-contained HTML file, so there are three separate bounds:
+ * the recorder's ring buffer (what we hold in memory), the frame selection
+ * (what we attach), and a byte budget applied over the selection. Nothing
+ * here can produce a 200MB report.
+ *
+ * `startEvidenceRecorder` talks to Chrome; everything below it is pure and
+ * unit-tested against fixture frames.
+ */
+import type { CdpClient } from '../browser/cdp.js';
+import type { BudgetFailure, ConsoleEntry, Evidence, PageErrorEntry, RawFrame, RequestEntry } from './types.js';
+export type { RawFrame };
+export interface EvidenceRecorderOptions {
+    /** Frames held in memory before the buffer is decimated. */
+    maxFrames?: number;
+    /** Base64 bytes held in memory before the buffer is decimated. */
+    maxBytes?: number;
+    everyNthFrame?: number;
+    quality?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+}
+export interface EvidenceRecorder {
+    frames: RawFrame[];
+    droppedFrames: number;
+    stop: () => Promise<void>;
+}
+export declare function startEvidenceRecorder(client: CdpClient, sessionId: string, startedAtMs: number, options?: EvidenceRecorderOptions): Promise<EvidenceRecorder>;
+export interface SelectFramesOptions {
+    /** Frames to attach to the report. */
+    maxFrames?: number;
+    /** Total base64 bytes to attach. */
+    maxBytes?: number;
+    /** Half-width of the window around the focus, in ms. */
+    windowMs?: number;
+}
+/**
+ * Pick the frames to attach.
+ *
+ * With a focus offset, frames nearest it win — that is the moment being
+ * explained. Without one (a vitals-only breach has no instant), the run is
+ * sampled evenly so the reader still sees it load. The byte budget is applied
+ * last, evicting the least relevant frame first, so the cap is never reached
+ * by truncating the interesting end.
+ */
+export declare function selectFrames(frames: RawFrame[], focusOffsetMs: number | null, options?: SelectFramesOptions): {
+    frames: RawFrame[];
+    dropped: number;
+};
+export interface BuildEvidenceInput {
+    reason: Evidence['reason'];
+    /** `Date.now()` at the start of the run — the zero of every offset. */
+    startedAtMs: number;
+    frames: RawFrame[];
+    /** Frames the recorder already dropped to stay inside its buffer. */
+    bufferDropped?: number;
+    console: ConsoleEntry[];
+    pageErrors: PageErrorEntry[];
+    requests: RequestEntry[];
+    failures: BudgetFailure[];
+    select?: SelectFramesOptions;
+    /** Cap on non-frame timeline rows. */
+    maxEvents?: number;
+}
+/**
+ * The instant the run went wrong: the earliest hard error we have a clock
+ * reading for. Returns null when the breach has no moment attached — a slow
+ * LCP is a property of the whole load, not an event.
+ */
+export declare function findFocusOffset(input: BuildEvidenceInput): number | null;
+export declare function buildEvidence(input: BuildEvidenceInput): Evidence;
+//# sourceMappingURL=evidence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../../src/report/evidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,QAAQ,EAER,cAAc,EACd,QAAQ,EACR,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,QAAQ,EAAE,CAAC;AAMzB,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAkBD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,gBAAgB,CAAC,CAiE3B;AAMD,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,QAAQ,EAAE,EAClB,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,OAAO,GAAE,mBAAwB,GAChC;IAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA+CzC;AAMD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3B,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAexE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,QAAQ,CA2GjE"}