@monoes/monobrowse 1.0.12 → 1.0.13

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

@@ -0,0 +1,26 @@
+/**
+ * Trends across a URL's run history (RIG-13).
+ *
+ * The point is catching slow decay. A single run that renders in 2.4s looks
+ * fine; the same page at 2.0s nine runs ago is a regression nobody filed a
+ * bug for, because no individual run ever crossed the budget. So every series
+ * reports two deltas — against the previous run (what just changed) and
+ * against the oldest run in the window (what has been happening) — and the
+ * second one is what produces a headline.
+ *
+ * Pure: the tests feed arrays of history records.
+ */
+import type { HistoryRun } from './history.js';
+import type { Report, TrendReport } from './types.js';
+type Unit = 'ms' | 'score' | 'count';
+export declare function formatTrendValue(unit: Unit, value: number | null): string;
+export declare function formatTrendDelta(unit: Unit, delta: number | null): string;
+/**
+ * Compare `current` against prior runs for the same URL.
+ *
+ * `history` is oldest-first and must NOT include the current run; callers
+ * save the run after building the trend so a run never trends against itself.
+ */
+export declare function buildTrend(current: Report, history: HistoryRun[]): TrendReport;
+export {};
+//# sourceMappingURL=trend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trend.d.ts","sourceRoot":"","sources":["../../../src/report/trend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAA8B,WAAW,EAAe,MAAM,YAAY,CAAC;AAE/F,KAAK,IAAI,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;AAkDrC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAOzE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAIzE;AA2FD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,WAAW,CAY9E"}

package/dist/src/report/trend.js

@@ -0,0 +1,164 @@
+/**
+ * Trends across a URL's run history (RIG-13).
+ *
+ * The point is catching slow decay. A single run that renders in 2.4s looks
+ * fine; the same page at 2.0s nine runs ago is a regression nobody filed a
+ * bug for, because no individual run ever crossed the budget. So every series
+ * reports two deltas — against the previous run (what just changed) and
+ * against the oldest run in the window (what has been happening) — and the
+ * second one is what produces a headline.
+ *
+ * Pure: the tests feed arrays of history records.
+ */
+const SERIES = [
+    { key: 'lcp', label: 'LCP', unit: 'ms', read: (r) => r.vitals.lcp },
+    { key: 'fcp', label: 'FCP', unit: 'ms', read: (r) => r.vitals.fcp },
+    { key: 'cls', label: 'CLS', unit: 'score', read: (r) => r.vitals.cls },
+    { key: 'inp', label: 'INP', unit: 'ms', read: (r) => r.vitals.inp },
+    { key: 'ttfb', label: 'TTFB', unit: 'ms', read: (r) => r.vitals.ttfb },
+    {
+        key: 'consoleErrors',
+        label: 'Console errors',
+        unit: 'count',
+        read: (r) => r.counts.consoleErrors,
+    },
+    { key: 'pageErrors', label: 'Page errors', unit: 'count', read: (r) => r.counts.pageErrors },
+    {
+        key: 'failedRequests',
+        label: 'Failed requests',
+        unit: 'count',
+        read: (r) => r.counts.failedRequests,
+    },
+    {
+        key: 'a11yErrors',
+        label: 'Accessibility errors',
+        unit: 'count',
+        read: (r) => r.counts.a11yErrors,
+    },
+];
+/**
+ * Smallest change worth calling a change. Chrome's own run-to-run variance on
+ * a paint metric is tens of milliseconds, so without a floor every series
+ * would report a direction every single run and the word would stop meaning
+ * anything.
+ */
+function significant(unit, delta, base) {
+    const magnitude = Math.abs(delta);
+    if (unit === 'count')
+        return magnitude >= 1;
+    if (unit === 'score')
+        return magnitude >= 0.01;
+    const relative = base !== null && base > 0 ? base * 0.05 : 0;
+    return magnitude >= Math.max(25, relative);
+}
+export function formatTrendValue(unit, value) {
+    if (value === null || !Number.isFinite(value))
+        return '—';
+    if (unit === 'ms') {
+        return value >= 1000 ? `${(value / 1000).toFixed(2)}s` : `${Math.round(value)}ms`;
+    }
+    if (unit === 'score')
+        return value.toFixed(3);
+    return String(Math.round(value));
+}
+export function formatTrendDelta(unit, delta) {
+    if (delta === null || !Number.isFinite(delta) || delta === 0)
+        return 'no change';
+    const sign = delta > 0 ? '+' : '−';
+    return `${sign}${formatTrendValue(unit, Math.abs(delta))}`;
+}
+function clean(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+function buildSeries(def, history, current) {
+    const points = history.map((run) => ({
+        capturedAt: run.capturedAt,
+        value: clean(def.read(run)),
+    }));
+    const currentValue = clean(def.read({ vitals: current.vitals, counts: current.counts }));
+    points.push({ capturedAt: current.capturedAt, value: currentValue });
+    const priorWithValues = points.slice(0, -1).filter((p) => p.value !== null);
+    const previous = priorWithValues.length
+        ? priorWithValues[priorWithValues.length - 1].value
+        : null;
+    const oldest = priorWithValues.length ? priorWithValues[0].value : null;
+    const deltaFromPrevious = currentValue !== null && previous !== null ? currentValue - previous : null;
+    const deltaFromOldest = currentValue !== null && oldest !== null ? currentValue - oldest : null;
+    let direction = 'flat';
+    if (currentValue === null || previous === null) {
+        direction = 'new';
+    }
+    else if (deltaFromPrevious !== null && significant(def.unit, deltaFromPrevious, previous)) {
+        // Every metric here is lower-is-better, so the sign maps straight across.
+        direction = deltaFromPrevious > 0 ? 'regressed' : 'improved';
+    }
+    const series = {
+        key: def.key,
+        label: def.label,
+        unit: def.unit,
+        points,
+        current: currentValue,
+        previous,
+        oldest,
+        deltaFromPrevious,
+        deltaFromOldest,
+        direction,
+    };
+    // The creep sentence: drift across the whole window, which is invisible run
+    // to run. Needs at least three prior points to be worth asserting.
+    if (priorWithValues.length >= 3 &&
+        deltaFromOldest !== null &&
+        oldest !== null &&
+        significant(def.unit, deltaFromOldest, oldest)) {
+        const verb = deltaFromOldest > 0 ? 'crept up' : 'come down';
+        series.creep =
+            `${def.label} has ${verb} ${formatTrendValue(def.unit, Math.abs(deltaFromOldest))} ` +
+                `over ${points.length} runs (${formatTrendValue(def.unit, oldest)} → ${formatTrendValue(def.unit, currentValue)}).`;
+    }
+    return series;
+}
+/**
+ * Rank the creep sentences so the report leads with the worst. Regressions
+ * first, then by how far the metric moved relative to where it started.
+ */
+function headlinesFor(series, history, current) {
+    const regressions = series
+        .filter((s) => s.creep && (s.deltaFromOldest ?? 0) > 0)
+        .sort((a, b) => {
+        const ratio = (s) => s.oldest && s.oldest > 0 ? Math.abs(s.deltaFromOldest ?? 0) / s.oldest : Infinity;
+        return ratio(b) - ratio(a);
+    })
+        .map((s) => s.creep);
+    const headlines = [...regressions];
+    // A verdict flip is the loudest thing that can happen, so it goes first.
+    const priorVerdicts = history.map((r) => r.verdict);
+    const allPassed = priorVerdicts.length > 0 && priorVerdicts.every((v) => v === 'pass');
+    const allFailed = priorVerdicts.length > 0 && priorVerdicts.every((v) => v === 'fail');
+    if (current.verdict === 'fail' && allPassed) {
+        headlines.unshift(`First failure in this window — the previous ${priorVerdicts.length} run(s) all passed.`);
+    }
+    else if (current.verdict === 'pass' && allFailed) {
+        headlines.unshift(`Back to passing — the previous ${priorVerdicts.length} run(s) all failed.`);
+    }
+    return headlines;
+}
+/**
+ * Compare `current` against prior runs for the same URL.
+ *
+ * `history` is oldest-first and must NOT include the current run; callers
+ * save the run after building the trend so a run never trends against itself.
+ */
+export function buildTrend(current, history) {
+    const series = SERIES.map((def) => buildSeries(def, history, current));
+    return {
+        runs: history.length,
+        windowFrom: history.length ? history[0].capturedAt : null,
+        series,
+        verdictHistory: [
+            ...history.map((r) => ({ capturedAt: r.capturedAt, verdict: r.verdict })),
+            { capturedAt: current.capturedAt, verdict: current.verdict },
+        ],
+        headlines: headlinesFor(series, history, current),
+    };
+}
+//# sourceMappingURL=trend.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trend.js","sourceRoot":"","sources":["../../../src/report/trend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,MAAM,MAAM,GAAgB;IAC1B,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE;IACnE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE;IACnE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE;IACtE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE;IACnE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;IACtE;QACE,GAAG,EAAE,eAAe;QACpB,KAAK,EAAE,gBAAgB;QACvB,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa;KACpC;IACD,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE;IAC5F;QACE,GAAG,EAAE,gBAAgB;QACrB,KAAK,EAAE,iBAAiB;QACxB,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc;KACrC;IACD;QACE,GAAG,EAAE,YAAY;QACjB,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU;KACjC;CACF,CAAC;AAEF;;;;;GAKG;AACH,SAAS,WAAW,CAAC,IAAU,EAAE,KAAa,EAAE,IAAmB;IACjE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,SAAS,IAAI,CAAC,CAAC;IAC5C,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,SAAS,IAAI,IAAI,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,KAAK,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAU,EAAE,KAAoB;IAC/D,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC1D,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;IACpF,CAAC;IACD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAU,EAAE,KAAoB;IAC/D,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IACjF,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACnC,OAAO,GAAG,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED,SAAS,KAAK,CAAC,KAAgC;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5E,CAAC;AAED,SAAS,WAAW,CAAC,GAAc,EAAE,OAAqB,EAAE,OAAe;IACzE,MAAM,MAAM,GAAiB,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACjD,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;KAC5B,CAAC,CAAC,CAAC;IACJ,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACzF,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IAErE,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM;QACrC,CAAC,CAAE,eAAe,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAgB;QAC/D,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAE,eAAe,CAAC,CAAC,CAAC,CAAC,KAAgB,CAAC,CAAC,CAAC,IAAI,CAAC;IAEpF,MAAM,iBAAiB,GACrB,YAAY,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9E,MAAM,eAAe,GAAG,YAAY,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAEhG,IAAI,SAAS,GAAmB,MAAM,CAAC;IACvC,IAAI,YAAY,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC/C,SAAS,GAAG,KAAK,CAAC;IACpB,CAAC;SAAM,IAAI,iBAAiB,KAAK,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC5F,0EAA0E;QAC1E,SAAS,GAAG,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;IAC/D,CAAC;IAED,MAAM,MAAM,GAAgB;QAC1B,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM;QACN,OAAO,EAAE,YAAY;QACrB,QAAQ;QACR,MAAM;QACN,iBAAiB;QACjB,eAAe;QACf,SAAS;KACV,CAAC;IAEF,4EAA4E;IAC5E,mEAAmE;IACnE,IACE,eAAe,CAAC,MAAM,IAAI,CAAC;QAC3B,eAAe,KAAK,IAAI;QACxB,MAAM,KAAK,IAAI;QACf,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,CAAC,EAC9C,CAAC;QACD,MAAM,IAAI,GAAG,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;QAC5D,MAAM,CAAC,KAAK;YACV,GAAG,GAAG,CAAC,KAAK,QAAQ,IAAI,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,GAAG;gBACpF,QAAQ,MAAM,CAAC,MAAM,UAAU,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC;IACxH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,MAAqB,EAAE,OAAqB,EAAE,OAAe;IACjF,MAAM,WAAW,GAAG,MAAM;SACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;SACtD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,MAAM,KAAK,GAAG,CAAC,CAAc,EAAE,EAAE,CAC/B,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QACpF,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAe,CAAC,CAAC;IAEjC,MAAM,SAAS,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;IAEnC,yEAAyE;IACzE,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;IACvF,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;IACvF,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM,IAAI,SAAS,EAAE,CAAC;QAC5C,SAAS,CAAC,OAAO,CACf,+CAA+C,aAAa,CAAC,MAAM,qBAAqB,CACzF,CAAC;IACJ,CAAC;SAAM,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM,IAAI,SAAS,EAAE,CAAC;QACnD,SAAS,CAAC,OAAO,CAAC,kCAAkC,aAAa,CAAC,MAAM,qBAAqB,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,OAAqB;IAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACvE,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,MAAM;QACpB,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;QACzD,MAAM;QACN,cAAc,EAAE;YACd,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACzE,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;SAC7D;QACD,SAAS,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;KAClD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,320 @@
+/**
+ * Shared shapes for `monobrowse report` — the one-command page test rig.
+ *
+ * The pipeline is collect (drive the browser) -> analyze (a11y rules +
+ * budget evaluation) -> render (self-contained HTML). Only `collect` talks
+ * to Chrome; everything downstream is a pure function over these types,
+ * which is what makes the analyzer and the renderer unit-testable without
+ * launching a browser.
+ */
+export type A11yRuleId = 'unlabelled-control' | 'image-missing-alt' | 'form-field-no-label' | 'heading-order-jump' | 'negative-tabindex';
+export type A11yImpact = 'error' | 'warning';
+export interface A11yFinding {
+    rule: A11yRuleId;
+    impact: A11yImpact;
+    /** ARIA role as the AX tree reports it, lowercased. */
+    role: string;
+    /** Accessible name, or null when the finding IS the missing name. */
+    name: string | null;
+    /** CSS selector when we could resolve one, else `ax-node:<id>`. */
+    locator: string;
+    detail: string;
+}
+/**
+ * The subset of CDP's `Accessibility.AXNode` these rules read. Declared here
+ * rather than imported because snapshot.ts keeps its own copy private, and
+ * because tests feed in hand-written fixture trees.
+ *
+ * Note `nodeId` is a string on the wire (`AXNodeId`); number is accepted so
+ * fixtures can stay terse.
+ */
+export interface AxNode {
+    nodeId: string | number;
+    ignored?: boolean;
+    role?: {
+        value?: unknown;
+    };
+    name?: {
+        value?: unknown;
+    };
+    properties?: Array<{
+        name: string;
+        value?: {
+            value?: unknown;
+        };
+    }>;
+    backendDOMNodeId?: number;
+    parentId?: string | number;
+    childIds?: Array<string | number>;
+}
+/**
+ * An element the DOM says has a negative tabindex. The AX tree cannot
+ * report tabindex at all, so this comes from a separate DOM sweep.
+ */
+export interface FocusCandidate {
+    tag: string;
+    role: string;
+    name: string | null;
+    tabindex: number;
+    locator: string;
+}
+export interface ConsoleEntry {
+    type: string;
+    text: string;
+    url?: string;
+    lineNumber?: number;
+    timestamp: number;
+}
+export interface PageErrorEntry {
+    text: string;
+    url?: string;
+    lineNumber?: number;
+    columnNumber?: number;
+    timestamp: number;
+}
+export interface RequestEntry {
+    url: string;
+    method: string;
+    /**
+     * Wall-clock ms the request started, when the CDP monotonic clock could be
+     * aligned to Date.now(). Absent otherwise — the evidence timeline (RIG-11)
+     * is the only consumer and it degrades to omitting the request.
+     */
+    startedAtMs?: number;
+    status?: number;
+    mimeType?: string;
+    durationMs?: number;
+    encodedSize?: number;
+    /** True for a 4xx/5xx response or a request that never got one. */
+    failed: boolean;
+    /** CDP `Network.loadingFailed` errorText / blockedReason, when we saw one. */
+    errorText?: string;
+}
+export interface VitalsData {
+    lcp?: number;
+    fcp?: number;
+    cls?: number;
+    ttfb?: number;
+    inp?: number;
+    domInteractive?: number;
+    domContentLoaded?: number;
+    loadTime?: number;
+    resources?: number;
+}
+export interface Screenshot {
+    /** Device name, or 'page' for the default viewport shot. */
+    label: string;
+    width: number;
+    height: number;
+    /** `data:image/png;base64,...` — inlined so the HTML stays self-contained. */
+    dataUrl: string;
+    /** Where captureScreenshot also dropped the PNG, for callers that want it. */
+    path?: string;
+}
+export interface CaptureData {
+    /** URL as requested on the command line. */
+    url: string;
+    /** URL after redirects / client-side navigation. */
+    finalUrl: string;
+    title: string;
+    capturedAt: string;
+    durationMs: number;
+    console: ConsoleEntry[];
+    pageErrors: PageErrorEntry[];
+    requests: RequestEntry[];
+    vitals: VitalsData;
+    a11y: A11yFinding[];
+    screenshots: Screenshot[];
+    /**
+     * Flat AX-tree signature used for the structural diff. Optional because a
+     * page whose AX tree we could not read still produces a valid report.
+     */
+    structure?: StructureNode[];
+    /** Screencast frames + timeline, present only when evidence was recorded. */
+    evidence?: Evidence;
+    /** Raw recorder output, consumed by runReport and never serialized. */
+    recording?: Recording;
+    /** Anything that degraded — a timeout, a collector that came back empty. */
+    notes: string[];
+}
+/** `null` means "do not enforce this one". */
+export interface Budget {
+    maxConsoleErrors: number | null;
+    maxPageErrors: number | null;
+    maxFailedRequests: number | null;
+    maxA11yErrors: number | null;
+    lcpMs: number | null;
+    clsScore: number | null;
+    inpMs: number | null;
+    fcpMs: number | null;
+    ttfbMs: number | null;
+}
+export interface BudgetFailure {
+    /** The budget key that was breached, e.g. `lcpMs`. */
+    budget: keyof Budget;
+    /** Human-readable threshold, e.g. `<= 2500ms`. */
+    expected: string;
+    /** Human-readable measurement, e.g. `3120ms`. */
+    actual: string;
+    /** Concrete evidence — which errors, which requests. */
+    detail?: string;
+}
+export type VerdictValue = 'pass' | 'fail';
+export interface Report extends CaptureData {
+    budget: Budget;
+    verdict: VerdictValue;
+    failures: BudgetFailure[];
+    /** Budgets we could not evaluate (e.g. the page reported no LCP). */
+    unmeasured: string[];
+    counts: {
+        consoleErrors: number;
+        consoleWarnings: number;
+        pageErrors: number;
+        requests: number;
+        failedRequests: number;
+        a11yErrors: number;
+        a11yWarnings: number;
+    };
+    /** This run against the previous N for the same URL (RIG-13). */
+    trend?: TrendReport;
+    /** This run against the immediately previous one (RIG-10). */
+    diff?: RunDiff;
+}
+/** One AX-tree element, addressed by a path of `role[n]` segments. */
+export interface StructureNode {
+    path: string;
+    role: string;
+    name: string | null;
+    depth: number;
+}
+export interface StructureDiff {
+    gained: StructureNode[];
+    lost: StructureNode[];
+    /** Same slot, same role, different accessible name. */
+    renamed: Array<{
+        path: string;
+        role: string;
+        from: string | null;
+        to: string | null;
+    }>;
+    /** Same role and name, different path — reordered, not added or removed. */
+    moved: Array<{
+        role: string;
+        name: string | null;
+        from: string;
+        to: string;
+    }>;
+    unchanged: number;
+    /** gained + lost + renamed. `moved` is excluded: moving is rarely a defect. */
+    changed: number;
+}
+export interface ImageSize {
+    width: number;
+    height: number;
+}
+export interface PixelDiff {
+    /** False when a screenshot could not be decoded; see `note`. */
+    comparable: boolean;
+    changedPixels: number;
+    totalPixels: number;
+    changedPercent: number;
+    previousSize: ImageSize | null;
+    currentSize: ImageSize | null;
+    sizeChanged: boolean;
+    /** Highlight image, `data:image/png;base64,...`. Absent when nothing changed. */
+    diffDataUrl?: string;
+    /** Integer downscale factor applied to the highlight image, when > 1. */
+    scale?: number;
+    note?: string;
+}
+export interface RunDiff {
+    previousRunId: string;
+    previousCapturedAt: string;
+    structure?: StructureDiff;
+    pixels?: PixelDiff;
+    notes: string[];
+}
+export type TrendDirection = 'improved' | 'regressed' | 'flat' | 'new';
+export interface TrendPoint {
+    capturedAt: string;
+    value: number | null;
+}
+export interface TrendSeries {
+    /** Metric key, e.g. `lcp` or `consoleErrors`. */
+    key: string;
+    label: string;
+    unit: 'ms' | 'score' | 'count';
+    /** Oldest to newest; the last point is this run. */
+    points: TrendPoint[];
+    current: number | null;
+    previous: number | null;
+    oldest: number | null;
+    deltaFromPrevious: number | null;
+    deltaFromOldest: number | null;
+    direction: TrendDirection;
+    /** Set when drift across the whole window is big enough to name out loud. */
+    creep?: string;
+}
+export interface TrendReport {
+    /** How many prior runs this run was compared against. */
+    runs: number;
+    windowFrom: string | null;
+    series: TrendSeries[];
+    verdictHistory: Array<{
+        capturedAt: string;
+        verdict: VerdictValue;
+    }>;
+    /** The sentences worth reading first, e.g. slow LCP decay. */
+    headlines: string[];
+}
+/** One screencast frame as the recorder buffers it, before selection. */
+export interface RawFrame {
+    /** Milliseconds since the run started. */
+    offsetMs: number;
+    /** Base64 JPEG, as CDP hands it over. */
+    data: string;
+    bytes: number;
+}
+/**
+ * The recorder's raw output, carried on CaptureData so `runReport` can turn
+ * it into an Evidence block once the verdict is known. Stripped from the JSON
+ * sibling — it is working material, not part of the report.
+ */
+export interface Recording {
+    /** `Date.now()` at the start of the run: the zero of every frame offset. */
+    startedAtMs: number;
+    frames: RawFrame[];
+    /** Frames already dropped to keep the in-memory buffer bounded. */
+    droppedFrames: number;
+    /** True when the caller asked for a recording regardless of the verdict. */
+    requested: boolean;
+}
+export interface EvidenceFrame {
+    /** Milliseconds since the run started. */
+    offsetMs: number;
+    /** `data:image/jpeg;base64,...` */
+    dataUrl: string;
+    bytes: number;
+}
+export type TimelineKind = 'frame' | 'console' | 'pageerror' | 'request' | 'marker';
+export interface TimelineEntry {
+    offsetMs: number;
+    kind: TimelineKind;
+    label: string;
+    detail?: string;
+    severity: 'info' | 'warning' | 'error';
+    /** Index into `Evidence.frames` for a `frame` entry. */
+    frameIndex?: number;
+}
+export interface Evidence {
+    reason: 'budget-failure' | 'requested';
+    /** Offset the timeline is centred on — the first failure we could locate. */
+    focusOffsetMs: number | null;
+    frames: EvidenceFrame[];
+    timeline: TimelineEntry[];
+    /** Frames captured but dropped to stay inside the count/byte budget. */
+    droppedFrames: number;
+    totalBytes: number;
+    notes: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/report/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,MAAM,UAAU,GAClB,oBAAoB,GACpB,mBAAmB,GACnB,qBAAqB,GACrB,oBAAoB,GACpB,mBAAmB,CAAC;AAExB,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3B,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,MAAM,EAAE,OAAO,CAAC;IAChB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,uEAAuE;IACvE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAMD,8CAA8C;AAC9C,MAAM,WAAW,MAAM;IACrB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,MAAM,WAAW,MAAO,SAAQ,WAAW;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,qEAAqE;IACrE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,iEAAiE;IACjE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAMD,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,uDAAuD;IACvD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACvF,4EAA4E;IAC5E,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,gEAAgE;IAChE,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,SAAS,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAMD,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,KAAK,CAAC;AAEvE,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;IAC/B,oDAAoD;IACpD,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,cAAc,CAAC;IAC1B,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,cAAc,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;IACrE,8DAA8D;IAC9D,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAMD,yEAAyE;AACzE,MAAM,WAAW,QAAQ;IACvB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEpF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAAC;IACvC,6EAA6E;IAC7E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/src/report/types.js

@@ -0,0 +1,11 @@
+/**
+ * Shared shapes for `monobrowse report` — the one-command page test rig.
+ *
+ * The pipeline is collect (drive the browser) -> analyze (a11y rules +
+ * budget evaluation) -> render (self-contained HTML). Only `collect` talks
+ * to Chrome; everything downstream is a pure function over these types,
+ * which is what makes the analyzer and the renderer unit-testable without
+ * launching a browser.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/report/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

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

@@ -0,0 +1,17 @@
+/** Small shared helpers for the report collectors. */
+/** Budget for one non-navigation collector (AX tree, screenshot, eval). */
+export declare const STEP_TIMEOUT_MS = 15000;
+export declare function sleep(ms: number): Promise<void>;
+export declare function message(err: unknown): string;
+/**
+ * Races a promise against a timer. Used everywhere in collect.ts so a wedged
+ * page degrades into a note instead of hanging the command forever.
+ */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number, label: string): Promise<T>;
+/**
+ * HTML-escape a value for interpolation into the report. Lives here rather
+ * than in render.ts so the renderer and its section modules can share it
+ * without importing each other.
+ */
+export declare function escapeHtml(value: unknown): string;
+//# sourceMappingURL=util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/report/util.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,2EAA2E;AAC3E,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/C;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAa/F;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOjD"}

package/dist/src/report/util.js

@@ -0,0 +1,45 @@
+/** Small shared helpers for the report collectors. */
+/** Budget for one non-navigation collector (AX tree, screenshot, eval). */
+export const STEP_TIMEOUT_MS = 15_000;
+export function sleep(ms) {
+    return new Promise((r) => {
+        const t = setTimeout(r, ms);
+        t.unref?.();
+    });
+}
+export function message(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/**
+ * Races a promise against a timer. Used everywhere in collect.ts so a wedged
+ * page degrades into a note instead of hanging the command forever.
+ */
+export async function withTimeout(promise, ms, label) {
+    let timer;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error(`${label} timed out after ${ms}ms`)), ms);
+                timer.unref?.();
+            }),
+        ]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * HTML-escape a value for interpolation into the report. Lives here rather
+ * than in render.ts so the renderer and its section modules can share it
+ * without importing each other.
+ */
+export function escapeHtml(value) {
+    return String(value ?? '')
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+//# sourceMappingURL=util.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../src/report/util.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;QACvB,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5B,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,OAAmB,EAAE,EAAU,EAAE,KAAa;IACjF,IAAI,KAAgD,CAAC;IACrD,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;YACxB,OAAO;YACP,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBAC/B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpF,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YAClB,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC"}