@monoes/monobrowse 1.0.12 → 1.0.14

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

@@ -0,0 +1,102 @@
+/**
+ * `monobrowse report <url>` — open a page, measure it, judge it against a
+ * budget, and leave behind one self-contained HTML file plus a sibling JSON.
+ *
+ * collect.ts (drive the browser) -> analyze.ts (a11y + budgets -> verdict)
+ * -> history/trend/diff (what changed since last time) -> render.ts (HTML).
+ * This module is the seam that wires them together and writes the two files.
+ */
+import type { CdpClient } from '../browser/cdp.js';
+import type { CollectOptions } from './collect.js';
+import { type FlakeReport } from './flake.js';
+import { type HistoryRun } from './history.js';
+import type { Budget, Report } from './types.js';
+export * from './a11y.js';
+export * from './analyze.js';
+export * from './budget.js';
+export * from './collect.js';
+export * from './collect-a11y.js';
+export * from './evidence.js';
+export * from './flake.js';
+export * from './history.js';
+export * from './pixel-diff.js';
+export * from './png.js';
+export * from './render.js';
+export * from './run-diff.js';
+export * from './structure.js';
+export * from './trend.js';
+export * from './types.js';
+/** Prior runs a trend is charted over. Older runs stay on disk, off the chart. */
+export declare const DEFAULT_TREND_WINDOW = 10;
+export interface RunReportOptions extends CollectOptions {
+    /** Output path: a `.html` file, or a directory to drop the default name in. */
+    out?: string;
+    /** Budget file path or inline JSON. Omitted means DEFAULT_BUDGET. */
+    budget?: string | Budget;
+    cwd?: string;
+    /** Persist this run and compare against previous ones. Default true. */
+    history?: boolean;
+    /** Runs kept per URL. Default DEFAULT_HISTORY_MAX. */
+    historyMax?: number;
+    /** Root of the history store. Default `~/.monomind/browser-reports`. */
+    historyDir?: string;
+    /** Prior runs charted. Default DEFAULT_TREND_WINDOW. */
+    trendWindow?: number;
+}
+export interface ReportResult {
+    report: Report;
+    htmlPath: string;
+    jsonPath: string;
+    summary: string;
+    /** Present when the run was saved to the history store. */
+    historyDir?: string;
+    /** Present only for a `--repeat` run (RIG-14); see RepeatResult. */
+    flake?: FlakeReport;
+}
+/**
+ * Resolve `--out` into an absolute .html path. A path that is an existing
+ * directory, or that ends in a separator, gets the generated filename
+ * appended — `--out ./reports` should not silently produce a file called
+ * `reports`.
+ */
+export declare function resolveOutPath(out: string | undefined, url: string, capturedAt: string, cwd: string): Promise<string>;
+/**
+ * The JSON sibling drops the base64 image payloads — they are megabytes of
+ * noise for anything reading this programmatically, and the HTML already
+ * carries them inline. `path` still points at the PNG on disk. The pixel
+ * diff's highlight image and the evidence frames go the same way: every
+ * measurement survives, only the pixels are dropped.
+ */
+export declare function toJsonReport(report: Report): Record<string, unknown>;
+export declare function writeReportFiles(report: Report, htmlPath: string, extras?: {
+    flake?: FlakeReport;
+}): Promise<{
+    htmlPath: string;
+    jsonPath: string;
+}>;
+/** One run: collect, judge, compare against history, write the two files. */
+export declare function runReport(client: CdpClient, sessionId: string, options: RunReportOptions): Promise<ReportResult>;
+export interface RepeatResult extends ReportResult {
+    flake: FlakeReport;
+    /** Every run, in order. `report` is the last of them. */
+    reports: Report[];
+}
+/**
+ * `--repeat N`: run the same URL N times and judge the set (RIG-14).
+ *
+ * Only the last run is written out in full — N runs' worth of inlined
+ * screenshots is not something anyone wants on disk — but the flake analysis
+ * covers all of them, and it is the flake verdict that decides the exit code.
+ * A check that passed three times and failed twice must not exit 0.
+ */
+export declare function runReportRepeated(client: CdpClient, sessionId: string, options: RunReportOptions & {
+    repeat: number;
+}): Promise<RepeatResult>;
+/** `--history <url>`: the stored runs for a URL, oldest first. */
+export declare function readHistory(url: string, options?: {
+    historyDir?: string;
+}): Promise<{
+    dir: string;
+    runs: HistoryRun[];
+}>;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/report/index.js

@@ -0,0 +1,216 @@
+/**
+ * `monobrowse report <url>` — open a page, measure it, judge it against a
+ * budget, and leave behind one self-contained HTML file plus a sibling JSON.
+ *
+ * collect.ts (drive the browser) -> analyze.ts (a11y + budgets -> verdict)
+ * -> history/trend/diff (what changed since last time) -> render.ts (HTML).
+ * This module is the seam that wires them together and writes the two files.
+ */
+import { mkdir, stat, writeFile } from 'node:fs/promises';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { buildReport, summarizeVerdict } from './analyze.js';
+import { loadBudget } from './budget.js';
+import { collect } from './collect.js';
+import { buildEvidence } from './evidence.js';
+import { analyzeFlake, summarizeFlake } from './flake.js';
+import { DEFAULT_HISTORY_MAX, historyDirFor, historyRoot, listRuns, saveRun, } from './history.js';
+import { renderHtml } from './render.js';
+import { buildRunDiff } from './run-diff.js';
+import { buildTrend } from './trend.js';
+export * from './a11y.js';
+export * from './analyze.js';
+export * from './budget.js';
+export * from './collect.js';
+export * from './collect-a11y.js';
+export * from './evidence.js';
+export * from './flake.js';
+export * from './history.js';
+export * from './pixel-diff.js';
+export * from './png.js';
+export * from './render.js';
+export * from './run-diff.js';
+export * from './structure.js';
+export * from './trend.js';
+export * from './types.js';
+/** Prior runs a trend is charted over. Older runs stay on disk, off the chart. */
+export const DEFAULT_TREND_WINDOW = 10;
+function slugFor(url) {
+    try {
+        const parsed = new URL(url);
+        const path = parsed.pathname.replace(/\/+$/, '').replace(/[^a-z0-9]+/gi, '-');
+        return `${parsed.hostname}${path}`.replace(/-+/g, '-').replace(/^-|-$/g, '').toLowerCase();
+    }
+    catch {
+        return (url
+            .replace(/[^a-z0-9]+/gi, '-')
+            .replace(/^-|-$/g, '')
+            .toLowerCase() || 'page');
+    }
+}
+function timestamp(iso) {
+    return iso.replace(/[-:]/g, '').replace(/\.\d+Z$/, 'Z');
+}
+/**
+ * Resolve `--out` into an absolute .html path. A path that is an existing
+ * directory, or that ends in a separator, gets the generated filename
+ * appended — `--out ./reports` should not silently produce a file called
+ * `reports`.
+ */
+export async function resolveOutPath(out, url, capturedAt, cwd) {
+    const defaultName = `monobrowse-report-${slugFor(url)}-${timestamp(capturedAt)}.html`;
+    if (!out)
+        return join(cwd, defaultName);
+    const abs = isAbsolute(out) ? out : resolve(cwd, out);
+    if (/[\\/]$/.test(out))
+        return join(abs, defaultName);
+    const isDir = await stat(abs)
+        .then((s) => s.isDirectory())
+        .catch(() => false);
+    if (isDir)
+        return join(abs, defaultName);
+    return abs.toLowerCase().endsWith('.html') || abs.toLowerCase().endsWith('.htm')
+        ? abs
+        : `${abs}.html`;
+}
+/**
+ * The JSON sibling drops the base64 image payloads — they are megabytes of
+ * noise for anything reading this programmatically, and the HTML already
+ * carries them inline. `path` still points at the PNG on disk. The pixel
+ * diff's highlight image and the evidence frames go the same way: every
+ * measurement survives, only the pixels are dropped.
+ */
+export function toJsonReport(report) {
+    const { screenshots, recording, diff, evidence, ...rest } = report;
+    void recording;
+    return {
+        ...rest,
+        screenshots: screenshots.map(({ label, width, height, path }) => ({
+            label,
+            width,
+            height,
+            path,
+        })),
+        ...(diff
+            ? {
+                diff: {
+                    ...diff,
+                    pixels: diff.pixels ? { ...diff.pixels, diffDataUrl: undefined } : undefined,
+                },
+            }
+            : {}),
+        ...(evidence
+            ? {
+                evidence: {
+                    ...evidence,
+                    frames: evidence.frames.map(({ offsetMs, bytes }) => ({ offsetMs, bytes })),
+                },
+            }
+            : {}),
+    };
+}
+export async function writeReportFiles(report, htmlPath, extras = {}) {
+    const jsonPath = `${htmlPath.replace(/\.html?$/i, '')}.json`;
+    await mkdir(dirname(htmlPath), { recursive: true });
+    await writeFile(htmlPath, renderHtml(report, extras), 'utf8');
+    const json = extras.flake
+        ? { ...toJsonReport(report), flake: extras.flake }
+        : toJsonReport(report);
+    await writeFile(jsonPath, `${JSON.stringify(json, null, 2)}\n`, 'utf8');
+    return { htmlPath, jsonPath };
+}
+/**
+ * Attach the trend and the diff, then persist the run.
+ *
+ * Order matters: history is read BEFORE the run is saved, so a run never
+ * trends or diffs against itself. A failure anywhere in here becomes a note
+ * on the report rather than an error — an unwritable home directory should
+ * cost you the trend section, not the report.
+ */
+async function applyHistory(report, options) {
+    if (options.history === false)
+        return undefined;
+    const root = options.historyDir ?? historyRoot();
+    const dir = historyDirFor(report.url, root);
+    try {
+        const previous = await listRuns(dir);
+        const window = options.trendWindow ?? DEFAULT_TREND_WINDOW;
+        report.trend = buildTrend(report, previous.slice(-window));
+        report.diff = await buildRunDiff(dir, previous.at(-1), report);
+        await saveRun(report, { root, max: options.historyMax ?? DEFAULT_HISTORY_MAX });
+        return dir;
+    }
+    catch (err) {
+        report.notes.push(`Run history unavailable (${err.message}) — no trend or diff for this run.`);
+        return undefined;
+    }
+}
+/** Turn the recorder's raw frames into the evidence block, when warranted. */
+function applyEvidence(report, data) {
+    const recording = data.recording;
+    if (!recording)
+        return;
+    if (report.verdict !== 'fail' && !recording.requested)
+        return;
+    report.evidence = buildEvidence({
+        reason: report.verdict === 'fail' ? 'budget-failure' : 'requested',
+        startedAtMs: recording.startedAtMs,
+        frames: recording.frames,
+        bufferDropped: recording.droppedFrames,
+        console: report.console,
+        pageErrors: report.pageErrors,
+        requests: report.requests,
+        failures: report.failures,
+    });
+}
+async function resolveBudget(options) {
+    return options.budget && typeof options.budget === 'object'
+        ? options.budget
+        : await loadBudget(options.budget);
+}
+/** One run: collect, judge, compare against history, write the two files. */
+export async function runReport(client, sessionId, options) {
+    const budget = await resolveBudget(options);
+    const data = await collect(client, sessionId, options);
+    const report = buildReport(data, budget);
+    applyEvidence(report, data);
+    const historyDir = await applyHistory(report, options);
+    // Working material, not report content — and megabytes of it.
+    report.recording = undefined;
+    const htmlPath = await resolveOutPath(options.out, options.url, data.capturedAt, options.cwd ?? process.cwd());
+    const paths = await writeReportFiles(report, htmlPath);
+    return { report, ...paths, summary: summarizeVerdict(report), historyDir };
+}
+/**
+ * `--repeat N`: run the same URL N times and judge the set (RIG-14).
+ *
+ * Only the last run is written out in full — N runs' worth of inlined
+ * screenshots is not something anyone wants on disk — but the flake analysis
+ * covers all of them, and it is the flake verdict that decides the exit code.
+ * A check that passed three times and failed twice must not exit 0.
+ */
+export async function runReportRepeated(client, sessionId, options) {
+    const times = Math.max(1, Math.floor(options.repeat));
+    const budget = await resolveBudget(options);
+    const reports = [];
+    for (let i = 0; i < times; i++) {
+        const data = await collect(client, sessionId, options);
+        const report = buildReport(data, budget);
+        applyEvidence(report, data);
+        report.recording = undefined;
+        reports.push(report);
+    }
+    const flake = analyzeFlake(reports);
+    const report = reports[reports.length - 1];
+    // Only the run we keep is persisted: writing N history entries for one
+    // command would let a single `--repeat 20` evict the whole trend window.
+    const historyDir = await applyHistory(report, options);
+    const htmlPath = await resolveOutPath(options.out, options.url, report.capturedAt, options.cwd ?? process.cwd());
+    const paths = await writeReportFiles(report, htmlPath, { flake });
+    return { report, reports, flake, ...paths, summary: summarizeFlake(flake), historyDir };
+}
+/** `--history <url>`: the stored runs for a URL, oldest first. */
+export async function readHistory(url, options = {}) {
+    const dir = historyDirFor(url, options.historyDir ?? historyRoot());
+    return { dir, runs: await listRuns(dir) };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/report/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE/D,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAoB,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EACL,mBAAmB,EAEnB,aAAa,EACb,WAAW,EACX,QAAQ,EACR,OAAO,GACR,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAE3B,kFAAkF;AAClF,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AA6BvC,SAAS,OAAO,CAAC,GAAW;IAC1B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QAC9E,OAAO,GAAG,MAAM,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CACL,GAAG;aACA,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;aAC5B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;aACrB,WAAW,EAAE,IAAI,MAAM,CAC3B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAuB,EACvB,GAAW,EACX,UAAkB,EAClB,GAAW;IAEX,MAAM,WAAW,GAAG,qBAAqB,OAAO,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC;IACtF,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAExC,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACtD,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC;SAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC5B,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IACtB,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACzC,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC9E,CAAC,CAAC,GAAG;QACL,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACnE,KAAK,SAAS,CAAC;IACf,OAAO;QACL,GAAG,IAAI;QACP,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAChE,KAAK;YACL,KAAK;YACL,MAAM;YACN,IAAI;SACL,CAAC,CAAC;QACH,GAAG,CAAC,IAAI;YACN,CAAC,CAAC;gBACE,IAAI,EAAE;oBACJ,GAAG,IAAI;oBACP,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;iBAC7E;aACF;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,QAAQ;YACV,CAAC,CAAC;gBACE,QAAQ,EAAE;oBACR,GAAG,QAAQ;oBACX,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;iBAC5E;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAc,EACd,QAAgB,EAChB,MAAM,GAA4B,EAAE;IAEpC,MAAM,QAAQ,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC;IAC7D,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK;QACvB,CAAC,CAAC,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;QAClD,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACzB,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,YAAY,CACzB,MAAc,EACd,OAAyB;IAEzB,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,IAAI,WAAW,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,IAAI,oBAAoB,CAAC;QAC3D,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,IAAI,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/D,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,UAAU,IAAI,mBAAmB,EAAE,CAAC,CAAC;QAChF,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,IAAI,CACf,4BAA6B,GAAa,CAAC,OAAO,oCAAoC,CACvF,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,SAAS,aAAa,CAAC,MAAc,EAAE,IAAiB;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACjC,IAAI,CAAC,SAAS;QAAE,OAAO;IACvB,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS;QAAE,OAAO;IAC9D,MAAM,CAAC,QAAQ,GAAG,aAAa,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,WAAW;QAClE,WAAW,EAAE,SAAS,CAAC,WAAW;QAClC,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,aAAa,EAAE,SAAS,CAAC,aAAa;QACtC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,OAAyB;IACpD,OAAO,OAAO,CAAC,MAAM,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ;QACzD,CAAC,CAAC,OAAO,CAAC,MAAM;QAChB,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,MAA4B,CAAC,CAAC;AAC7D,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAiB,EACjB,SAAiB,EACjB,OAAyB;IAEzB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAgB,MAAM,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEzC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD,8DAA8D;IAC9D,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;IAE7B,MAAM,QAAQ,GAAG,MAAM,cAAc,CACnC,OAAO,CAAC,GAAG,EACX,OAAO,CAAC,GAAG,EACX,IAAI,CAAC,UAAU,EACf,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAC7B,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvD,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;AAC7E,CAAC;AAQD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAiB,EACjB,SAAiB,EACjB,OAA8C;IAE9C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5B,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,uEAAuE;IACvE,yEAAyE;IACzE,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvD,MAAM,QAAQ,GAAG,MAAM,cAAc,CACnC,OAAO,CAAC,GAAG,EACX,OAAO,CAAC,GAAG,EACX,MAAM,CAAC,UAAU,EACjB,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAC7B,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAClE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;AAC1F,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,OAAO,GAA4B,EAAE;IAErC,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,IAAI,WAAW,EAAE,CAAC,CAAC;IACpE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;AAC5C,CAAC"}

package/dist/src/report/pixel-diff.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Pixel diff between two screenshots (RIG-10), with no image dependency —
+ * png.ts decodes and re-encodes using node's own zlib.
+ *
+ * Two design choices worth stating:
+ *
+ *  - A per-channel tolerance, not exact equality. Chrome's rasteriser is not
+ *    bit-deterministic across runs (font hinting, GPU vs. software paths), so
+ *    an exact compare reports 4% of every screenshot as "changed" and the
+ *    number becomes noise nobody reads.
+ *  - Differing dimensions are a result, not an error. A page that grew 200px
+ *    taller is exactly the regression this is for, so we compare the
+ *    overlapping region, count the rest as changed, and say so.
+ */
+import type { PixelDiff } from './types.js';
+export interface PixelDiffOptions {
+    threshold?: number;
+    maxPixels?: number;
+    /** Set false to skip building the highlight image (counts only). */
+    renderImage?: boolean;
+}
+/**
+ * Compare two PNGs. Never throws for image-shaped reasons — an undecodable
+ * screenshot produces a result carrying `note` and no counts, because a
+ * report that renders minus one section beats a report that fails to build.
+ */
+export declare function pixelDiff(previousPng: Uint8Array, currentPng: Uint8Array, options?: PixelDiffOptions): PixelDiff;
+/** One line for a CI log. */
+export declare function summarizePixelDiff(diff: PixelDiff): string;
+//# sourceMappingURL=pixel-diff.d.ts.map

package/dist/src/report/pixel-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixel-diff.d.ts","sourceRoot":"","sources":["../../../src/report/pixel-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAW5C,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAwED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,WAAW,EAAE,UAAU,EACvB,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CAwEX;AAED,6BAA6B;AAC7B,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAQ1D"}

package/dist/src/report/pixel-diff.js

@@ -0,0 +1,175 @@
+/**
+ * Pixel diff between two screenshots (RIG-10), with no image dependency —
+ * png.ts decodes and re-encodes using node's own zlib.
+ *
+ * Two design choices worth stating:
+ *
+ *  - A per-channel tolerance, not exact equality. Chrome's rasteriser is not
+ *    bit-deterministic across runs (font hinting, GPU vs. software paths), so
+ *    an exact compare reports 4% of every screenshot as "changed" and the
+ *    number becomes noise nobody reads.
+ *  - Differing dimensions are a result, not an error. A page that grew 200px
+ *    taller is exactly the regression this is for, so we compare the
+ *    overlapping region, count the rest as changed, and say so.
+ */
+import { decodePng, encodePng, pngToDataUrl } from './png.js';
+/** Per-channel delta below which two pixels are "the same". */
+const DEFAULT_THRESHOLD = 16;
+/**
+ * Cap on the highlight image, in pixels. A full-page shot of a long article
+ * can be 1440x20000; inlining that as a data URI would add ~20MB to a report
+ * that is supposed to stay openable.
+ */
+const DEFAULT_MAX_PIXELS = 1_400_000;
+function changedAt(a, ai, b, bi, threshold) {
+    return (Math.abs(a[ai] - b[bi]) > threshold ||
+        Math.abs(a[ai + 1] - b[bi + 1]) > threshold ||
+        Math.abs(a[ai + 2] - b[bi + 2]) > threshold ||
+        Math.abs(a[ai + 3] - b[bi + 3]) > threshold);
+}
+/**
+ * Build the highlight image: the current screenshot faded towards white so it
+ * reads as context, with changed pixels painted a saturated magenta. Scaled
+ * down by an integer factor when the shot is large, ORing the change mask so
+ * a one-pixel-wide change survives the downscale instead of being averaged
+ * into invisibility.
+ */
+function renderHighlight(current, mask, maxPixels) {
+    const { width, height, data } = current;
+    const scale = Math.max(1, Math.ceil(Math.sqrt((width * height) / maxPixels)));
+    const outW = Math.max(1, Math.ceil(width / scale));
+    const outH = Math.max(1, Math.ceil(height / scale));
+    const out = new Uint8Array(outW * outH * 4);
+    for (let oy = 0; oy < outH; oy++) {
+        for (let ox = 0; ox < outW; ox++) {
+            let r = 0;
+            let g = 0;
+            let b = 0;
+            let n = 0;
+            let hit = false;
+            for (let dy = 0; dy < scale; dy++) {
+                const y = oy * scale + dy;
+                if (y >= height)
+                    break;
+                for (let dx = 0; dx < scale; dx++) {
+                    const x = ox * scale + dx;
+                    if (x >= width)
+                        break;
+                    const i = (y * width + x) * 4;
+                    r += data[i];
+                    g += data[i + 1];
+                    b += data[i + 2];
+                    n++;
+                    if (mask[y * width + x])
+                        hit = true;
+                }
+            }
+            const o = (oy * outW + ox) * 4;
+            if (!n) {
+                out[o + 3] = 255;
+                continue;
+            }
+            if (hit) {
+                out[o] = 214;
+                out[o + 1] = 31;
+                out[o + 2] = 105;
+            }
+            else {
+                // Fade to white: keeps the layout legible without competing with the
+                // magenta, and compresses far better than the original.
+                out[o] = Math.round(255 - (255 - r / n) * 0.28);
+                out[o + 1] = Math.round(255 - (255 - g / n) * 0.28);
+                out[o + 2] = Math.round(255 - (255 - b / n) * 0.28);
+            }
+            out[o + 3] = 255;
+        }
+    }
+    return { image: { width: outW, height: outH, data: out }, scale };
+}
+/**
+ * Compare two PNGs. Never throws for image-shaped reasons — an undecodable
+ * screenshot produces a result carrying `note` and no counts, because a
+ * report that renders minus one section beats a report that fails to build.
+ */
+export function pixelDiff(previousPng, currentPng, options = {}) {
+    const threshold = options.threshold ?? DEFAULT_THRESHOLD;
+    const maxPixels = options.maxPixels ?? DEFAULT_MAX_PIXELS;
+    let prev;
+    let curr;
+    try {
+        prev = decodePng(previousPng);
+        curr = decodePng(currentPng);
+    }
+    catch (err) {
+        return {
+            comparable: false,
+            note: `Pixel diff skipped: ${err.message}`,
+            changedPixels: 0,
+            totalPixels: 0,
+            changedPercent: 0,
+            previousSize: null,
+            currentSize: null,
+            sizeChanged: false,
+        };
+    }
+    const overlapW = Math.min(prev.width, curr.width);
+    const overlapH = Math.min(prev.height, curr.height);
+    const sizeChanged = prev.width !== curr.width || prev.height !== curr.height;
+    // Denominator is the union, not the overlap: if the page doubled in height,
+    // "0.1% of pixels changed" would be a lie told by a small denominator.
+    const totalPixels = Math.max(prev.width * prev.height, curr.width * curr.height);
+    const mask = new Uint8Array(curr.width * curr.height);
+    let changed = 0;
+    for (let y = 0; y < curr.height; y++) {
+        for (let x = 0; x < curr.width; x++) {
+            const ci = (y * curr.width + x) * 4;
+            if (x >= overlapW || y >= overlapH) {
+                // Outside the overlap there is nothing to compare against: the pixel
+                // is new by definition.
+                mask[y * curr.width + x] = 1;
+                changed++;
+                continue;
+            }
+            const pi = (y * prev.width + x) * 4;
+            if (changedAt(prev.data, pi, curr.data, ci, threshold)) {
+                mask[y * curr.width + x] = 1;
+                changed++;
+            }
+        }
+    }
+    // Pixels the previous shot had and this one does not are changes too.
+    changed += Math.max(0, prev.width * prev.height - overlapW * overlapH);
+    const result = {
+        comparable: true,
+        changedPixels: changed,
+        totalPixels,
+        changedPercent: totalPixels ? (changed / totalPixels) * 100 : 0,
+        previousSize: { width: prev.width, height: prev.height },
+        currentSize: { width: curr.width, height: curr.height },
+        sizeChanged,
+    };
+    if (options.renderImage !== false && changed > 0) {
+        try {
+            const { image, scale } = renderHighlight(curr, mask, maxPixels);
+            result.diffDataUrl = pngToDataUrl(encodePng(image));
+            if (scale > 1)
+                result.scale = scale;
+        }
+        catch (err) {
+            result.note = `Highlight image not rendered: ${err.message}`;
+        }
+    }
+    return result;
+}
+/** One line for a CI log. */
+export function summarizePixelDiff(diff) {
+    if (!diff.comparable)
+        return diff.note ?? 'pixel diff unavailable';
+    const pct = diff.changedPercent;
+    const shown = pct === 0 ? '0' : pct < 0.01 ? '<0.01' : pct.toFixed(2);
+    const size = diff.sizeChanged
+        ? ` (size ${diff.previousSize?.width}x${diff.previousSize?.height} -> ${diff.currentSize?.width}x${diff.currentSize?.height})`
+        : '';
+    return `${shown}% of pixels changed${size}`;
+}
+//# sourceMappingURL=pixel-diff.js.map

package/dist/src/report/pixel-diff.js.map

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

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

@@ -0,0 +1,28 @@
+/**
+ * A minimal PNG decoder and encoder built on node's own `zlib`.
+ *
+ * This exists so the pixel diff (RIG-10) can compare two screenshots without
+ * adding an image dependency to a package whose whole point is to be a small
+ * self-contained CDP client. PNG is simple enough to justify it: the format
+ * is a chunk list wrapping one zlib stream, and node ships the zlib.
+ *
+ * Scope is deliberately narrow — what `Page.captureScreenshot` actually
+ * emits. Non-interlaced, bit depth 8 (16 is accepted by taking the high
+ * byte), colour types 0/2/3/4/6. Anything else throws a message that names
+ * what it saw, so the caller can degrade to "pixel diff unavailable" instead
+ * of rendering a wrong picture.
+ */
+export interface RgbaImage {
+    width: number;
+    height: number;
+    /** Row-major RGBA, 4 bytes per pixel, length === width * height * 4. */
+    data: Uint8Array;
+}
+export declare function crc32(buf: Uint8Array): number;
+export declare function decodePng(input: Uint8Array): RgbaImage;
+/** Encode RGBA bytes as a non-interlaced, 8-bit truecolour-with-alpha PNG. */
+export declare function encodePng(image: RgbaImage): Buffer;
+/** `data:image/png;base64,...` -> bytes. Accepts a bare base64 payload too. */
+export declare function pngFromDataUrl(dataUrl: string): Uint8Array;
+export declare function pngToDataUrl(png: Uint8Array): string;
+//# sourceMappingURL=png.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"png.d.ts","sourceRoot":"","sources":["../../../src/report/png.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,IAAI,EAAE,UAAU,CAAC;CAClB;AAgBD,wBAAgB,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAI7C;AAoID,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAwDtD;AAgBD,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CA6BlD;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAI1D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAEpD"}