@monoes/monobrowse 1.0.11 → 1.0.13

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

package/dist/src/report/evidence.js

@@ -0,0 +1,279 @@
+/**
+ * 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.
+ */
+const DEFAULT_MAX_BUFFER_FRAMES = 160;
+const DEFAULT_MAX_BUFFER_BYTES = 32 * 1024 * 1024;
+/**
+ * Halve the temporal resolution of the buffer instead of dropping its head.
+ *
+ * A plain ring buffer keeps the end of the run, which is the wrong half: a
+ * page that throws during load has its evidence at the start. Decimating
+ * keeps coverage of the whole run and merely coarsens it, which degrades the
+ * timeline gracefully however long the run turns out to be.
+ */
+function decimate(frames) {
+    const kept = frames.filter((_, i) => i % 2 === 0);
+    return { kept, dropped: frames.length - kept.length };
+}
+export async function startEvidenceRecorder(client, sessionId, startedAtMs, options = {}) {
+    const maxFrames = options.maxFrames ?? DEFAULT_MAX_BUFFER_FRAMES;
+    const maxBytes = options.maxBytes ?? DEFAULT_MAX_BUFFER_BYTES;
+    const recorder = {
+        frames: [],
+        droppedFrames: 0,
+        stop: async () => { },
+    };
+    let bytes = 0;
+    const off = client.on('Page.screencastFrame', (params, sid) => {
+        if (sid !== sessionId)
+            return;
+        const p = params;
+        // Ack first and unconditionally: Chrome stops sending frames until the
+        // previous one is acknowledged, so a failure to ack silently ends the
+        // recording.
+        if (p.sessionId !== undefined) {
+            void client
+                .send('Page.screencastFrameAck', { sessionId: p.sessionId }, sessionId)
+                .catch(() => { });
+        }
+        if (!p.data)
+            return;
+        recorder.frames.push({
+            offsetMs: Math.max(0, Date.now() - startedAtMs),
+            data: p.data,
+            bytes: p.data.length,
+        });
+        bytes += p.data.length;
+        if (recorder.frames.length > maxFrames || bytes > maxBytes) {
+            const { kept, dropped } = decimate(recorder.frames);
+            recorder.frames = kept;
+            recorder.droppedFrames += dropped;
+            bytes = kept.reduce((sum, f) => sum + f.bytes, 0);
+        }
+    });
+    // Idempotent: collect() stops the recorder once the interesting part of the
+    // run is over and again in its `finally`, and Chrome errors on stopping a
+    // screencast that is already stopped.
+    let stopped = false;
+    recorder.stop = async () => {
+        if (stopped)
+            return;
+        stopped = true;
+        off();
+        await client.send('Page.stopScreencast', {}, sessionId).catch(() => { });
+    };
+    try {
+        await client.send('Page.startScreencast', {
+            format: 'jpeg',
+            quality: options.quality ?? 60,
+            everyNthFrame: options.everyNthFrame ?? 2,
+            maxWidth: options.maxWidth ?? 900,
+            maxHeight: options.maxHeight ?? 1600,
+        }, sessionId);
+    }
+    catch (err) {
+        off();
+        throw err;
+    }
+    return recorder;
+}
+const DEFAULT_ATTACH_FRAMES = 12;
+const DEFAULT_ATTACH_BYTES = 6 * 1024 * 1024;
+const DEFAULT_WINDOW_MS = 4000;
+/**
+ * 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 function selectFrames(frames, focusOffsetMs, options = {}) {
+    const maxFrames = Math.max(1, options.maxFrames ?? DEFAULT_ATTACH_FRAMES);
+    const maxBytes = options.maxBytes ?? DEFAULT_ATTACH_BYTES;
+    const windowMs = options.windowMs ?? DEFAULT_WINDOW_MS;
+    if (!frames.length)
+        return { frames: [], dropped: 0 };
+    let ranked;
+    if (focusOffsetMs === null) {
+        if (frames.length <= maxFrames) {
+            ranked = [...frames];
+        }
+        else {
+            const step = (frames.length - 1) / (maxFrames - 1 || 1);
+            const picked = new Set();
+            for (let i = 0; i < maxFrames; i++)
+                picked.add(Math.round(i * step));
+            ranked = [...picked].sort((a, b) => a - b).map((i) => frames[i]);
+        }
+    }
+    else {
+        const distance = (f) => Math.abs(f.offsetMs - focusOffsetMs);
+        const inWindow = frames.filter((f) => distance(f) <= windowMs);
+        // Fall back to the nearest frames overall rather than attaching none: a
+        // failure whose frames all fell outside the window still deserves context.
+        const pool = inWindow.length ? inWindow : [...frames];
+        ranked = [...pool].sort((a, b) => distance(a) - distance(b)).slice(0, maxFrames);
+    }
+    let dropped = frames.length - ranked.length;
+    let total = ranked.reduce((sum, f) => sum + f.bytes, 0);
+    if (total > maxBytes) {
+        const order = focusOffsetMs === null
+            ? [...ranked]
+            : [...ranked].sort((a, b) => Math.abs(a.offsetMs - focusOffsetMs) - Math.abs(b.offsetMs - focusOffsetMs));
+        const keep = new Set();
+        let used = 0;
+        for (const frame of order) {
+            if (used + frame.bytes > maxBytes)
+                continue;
+            keep.add(frame);
+            used += frame.bytes;
+        }
+        dropped += ranked.length - keep.size;
+        ranked = ranked.filter((f) => keep.has(f));
+        total = used;
+    }
+    return { frames: ranked.sort((a, b) => a.offsetMs - b.offsetMs), dropped };
+}
+const DEFAULT_MAX_EVENTS = 60;
+function truncate(text, max = 200) {
+    const flat = String(text ?? '')
+        .replace(/\s+/g, ' ')
+        .trim();
+    return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;
+}
+/**
+ * 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 function findFocusOffset(input) {
+    const candidates = [];
+    for (const e of input.console) {
+        if (e.type === 'error' && Number.isFinite(e.timestamp)) {
+            candidates.push(e.timestamp - input.startedAtMs);
+        }
+    }
+    for (const e of input.pageErrors) {
+        if (Number.isFinite(e.timestamp))
+            candidates.push(e.timestamp - input.startedAtMs);
+    }
+    for (const r of input.requests) {
+        if (r.failed && r.startedAtMs !== undefined)
+            candidates.push(r.startedAtMs - input.startedAtMs);
+    }
+    const usable = candidates.filter((v) => Number.isFinite(v) && v >= 0);
+    return usable.length ? Math.min(...usable) : null;
+}
+export function buildEvidence(input) {
+    const notes = [];
+    const focusOffsetMs = findFocusOffset(input);
+    const picked = selectFrames(input.frames, focusOffsetMs, input.select);
+    const frames = picked.frames.map((f) => ({
+        offsetMs: f.offsetMs,
+        dataUrl: `data:image/jpeg;base64,${f.data}`,
+        bytes: f.bytes,
+    }));
+    const events = [];
+    for (const [i, frame] of picked.frames.entries()) {
+        events.push({
+            offsetMs: frame.offsetMs,
+            kind: 'frame',
+            label: 'frame',
+            severity: 'info',
+            frameIndex: i,
+        });
+    }
+    for (const e of input.console) {
+        if (e.type !== 'error' && e.type !== 'warn' && e.type !== 'warning')
+            continue;
+        events.push({
+            offsetMs: e.timestamp - input.startedAtMs,
+            kind: 'console',
+            label: `console.${e.type}`,
+            detail: truncate(e.text),
+            severity: e.type === 'error' ? 'error' : 'warning',
+        });
+    }
+    for (const e of input.pageErrors) {
+        events.push({
+            offsetMs: e.timestamp - input.startedAtMs,
+            kind: 'pageerror',
+            label: 'uncaught exception',
+            detail: truncate(e.text),
+            severity: 'error',
+        });
+    }
+    for (const r of input.requests) {
+        if (!r.failed)
+            continue;
+        if (r.startedAtMs === undefined)
+            continue;
+        events.push({
+            offsetMs: r.startedAtMs - input.startedAtMs,
+            kind: 'request',
+            label: `${r.status ?? r.errorText ?? 'no response'} ${r.method}`,
+            detail: truncate(r.url),
+            severity: 'error',
+        });
+    }
+    if (focusOffsetMs !== null) {
+        events.push({
+            offsetMs: focusOffsetMs,
+            kind: 'marker',
+            label: 'first failure',
+            detail: input.failures.map((f) => `${f.budget} ${f.actual}`).join(', ') || undefined,
+            severity: 'error',
+        });
+    }
+    // Trim the non-frame rows worst-first, so a page with 400 console warnings
+    // still shows its one uncaught exception.
+    const frameRows = events.filter((e) => e.kind === 'frame');
+    let otherRows = events.filter((e) => e.kind !== 'frame');
+    const maxEvents = input.maxEvents ?? DEFAULT_MAX_EVENTS;
+    if (otherRows.length > maxEvents) {
+        const weight = { error: 0, warning: 1, info: 2 };
+        const kept = [...otherRows]
+            .sort((a, b) => weight[a.severity] - weight[b.severity] ||
+            Math.abs(a.offsetMs - (focusOffsetMs ?? 0)) - Math.abs(b.offsetMs - (focusOffsetMs ?? 0)))
+            .slice(0, maxEvents);
+        notes.push(`Timeline trimmed to the ${maxEvents} most relevant of ${otherRows.length} events.`);
+        otherRows = kept;
+    }
+    const timeline = [...frameRows, ...otherRows].sort((a, b) => a.offsetMs - b.offsetMs || a.kind.localeCompare(b.kind));
+    const droppedFrames = (input.bufferDropped ?? 0) + picked.dropped;
+    if (droppedFrames > 0) {
+        notes.push(`${droppedFrames} recorded frame(s) not attached — the report keeps the ${frames.length} nearest the failure to stay inside its size budget.`);
+    }
+    if (!frames.length && input.frames.length === 0) {
+        notes.push('No screencast frames were captured for this run.');
+    }
+    if (focusOffsetMs === null && input.failures.length) {
+        notes.push('No single moment of failure could be located — the breach is a load-wide metric, so the frames sample the whole run instead.');
+    }
+    return {
+        reason: input.reason,
+        focusOffsetMs,
+        frames,
+        timeline,
+        droppedFrames,
+        totalBytes: frames.reduce((sum, f) => sum + f.bytes, 0),
+        notes,
+    };
+}
+//# sourceMappingURL=evidence.js.map