@monoes/monobrowse 1.0.11 → 1.0.13

package/dist/src/report/render-trend.js

@@ -0,0 +1,194 @@
+/**
+ * Report sections for the trend (RIG-13) and the run-to-run diff (RIG-10).
+ *
+ * Kept separate from render.ts purely for size. Same rules apply: no external
+ * resources, so the sparklines are hand-written inline SVG rather than a
+ * charting library, and the diff image is a `data:` URI.
+ *
+ * The design goal for the trend is legibility at a glance — the point of the
+ * feature is catching decay nobody noticed, which only works if the reader
+ * sees it without going looking.
+ */
+import { formatTrendDelta, formatTrendValue } from './trend.js';
+import { escapeHtml } from './util.js';
+/** Rows shown per diff category before the tail is summarised. */
+const MAX_DIFF_ROWS = 20;
+export const TREND_STYLES = `
+.headlines{background:var(--warn-bg);border:1px solid var(--warn);color:var(--warn);
+  border-radius:10px;padding:12px 16px;margin:0 0 16px}
+.headlines p{margin:0 0 6px;font-size:14px}
+.headlines p:last-child{margin-bottom:0}
+.spark{display:block}
+.spark .line{fill:none;stroke:var(--muted);stroke-width:1.5}
+.spark .dot{fill:var(--ink)}
+.dir{font-weight:600}
+.dir.regressed{color:var(--fail)}
+.dir.improved{color:var(--pass)}
+.dir.flat,.dir.new{color:var(--muted)}
+.verdictstrip{display:flex;flex-wrap:wrap;gap:4px;margin:0 0 16px;padding:0;list-style:none}
+.verdictstrip li{width:13px;height:13px;border-radius:3px;background:var(--pass)}
+.verdictstrip li.fail{background:var(--fail)}
+.difftag{display:inline-block;margin:0 8px 8px 0;padding:4px 10px;border-radius:999px;
+  font-size:12px;background:var(--panel);border:1px solid var(--line)}
+.difftag b{font-variant-numeric:tabular-nums}
+`.trim();
+// ---------------------------------------------------------------------------
+// Trend
+// ---------------------------------------------------------------------------
+/**
+ * A sparkline as inline SVG. Flat series are drawn down the middle rather
+ * than at y=0, which is what a naive min/max scale does when every value is
+ * identical and it reads as a cliff.
+ */
+function sparkline(series) {
+    const values = series.points.map((p) => p.value).filter((v) => v !== null);
+    if (values.length < 2)
+        return '<span style="color:var(--muted)">—</span>';
+    const width = 120;
+    const height = 24;
+    const min = Math.min(...values);
+    const max = Math.max(...values);
+    const span = max - min;
+    const x = (i) => (i / (values.length - 1)) * (width - 4) + 2;
+    const y = (v) => span === 0 ? height / 2 : height - 2 - ((v - min) / span) * (height - 4);
+    const points = values.map((v, i) => `${x(i).toFixed(1)},${y(v).toFixed(1)}`).join(' ');
+    const lastX = x(values.length - 1).toFixed(1);
+    const lastY = y(values[values.length - 1]).toFixed(1);
+    const label = `${series.label} over ${values.length} runs, ${formatTrendValue(series.unit, min)} to ${formatTrendValue(series.unit, max)}`;
+    return `<svg class="spark" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="${escapeHtml(label)}">
+    <polyline class="line" points="${points}"/>
+    <circle class="dot" cx="${lastX}" cy="${lastY}" r="2.5"/>
+  </svg>`;
+}
+const DIRECTION_WORD = {
+    regressed: 'worse',
+    improved: 'better',
+    flat: 'steady',
+    new: 'first',
+};
+export function renderTrend(trend) {
+    if (!trend)
+        return '';
+    if (trend.runs === 0) {
+        return `<h2>Trend</h2><p class="empty">First recorded run for this URL — from the next run on, this section compares against it.</p>`;
+    }
+    const headlines = trend.headlines.length
+        ? `<div class="headlines">${trend.headlines.map((h) => `<p>${escapeHtml(h)}</p>`).join('')}</div>`
+        : '';
+    const strip = `<ul class="verdictstrip" aria-label="Verdict per run, oldest first">${trend.verdictHistory
+        .map((v) => `<li class="${v.verdict}" title="${escapeHtml(`${v.capturedAt}: ${v.verdict}`)}"></li>`)
+        .join('')}</ul>`;
+    // A series nobody has ever measured is noise, not an absent trend.
+    const rows = trend.series
+        .filter((s) => s.points.some((p) => p.value !== null))
+        .map((s) => `<tr>
+        <td><b>${escapeHtml(s.label)}</b></td>
+        <td class="num mono">${escapeHtml(formatTrendValue(s.unit, s.previous))}</td>
+        <td class="num mono">${escapeHtml(formatTrendValue(s.unit, s.current))}</td>
+        <td class="num mono"><span class="dir ${s.direction}">${escapeHtml(formatTrendDelta(s.unit, s.deltaFromPrevious))}</span></td>
+        <td class="num mono">${escapeHtml(formatTrendDelta(s.unit, s.deltaFromOldest))}</td>
+        <td><span class="dir ${s.direction}">${DIRECTION_WORD[s.direction]}</span></td>
+        <td>${sparkline(s)}</td>
+      </tr>`)
+        .join('');
+    return `<h2>Trend — this run against the previous ${trend.runs}</h2>
+${headlines}
+${strip}
+<table><thead><tr>
+  <th>Metric</th><th>Last run</th><th>This run</th><th>vs last</th>
+  <th>vs ${trend.runs} runs ago</th><th>Direction</th><th>History</th>
+</tr></thead><tbody>${rows}</tbody></table>
+<p class="note">Window starts ${escapeHtml(trend.windowFrom ?? 'unknown')}. Every metric here is lower-is-better, so a positive delta is a regression.</p>`;
+}
+// ---------------------------------------------------------------------------
+// Diff
+// ---------------------------------------------------------------------------
+function nodeRows(nodes, kind) {
+    const shown = nodes.slice(0, MAX_DIFF_ROWS);
+    const rows = shown
+        .map((n) => `<tr>
+      <td>${escapeHtml(kind)}</td>
+      <td>${escapeHtml(n.role)}</td>
+      <td>${n.name ? escapeHtml(n.name) : '<span style="color:var(--muted)">(no accessible name)</span>'}</td>
+      <td class="wrap mono">${escapeHtml(n.path)}</td>
+    </tr>`)
+        .join('');
+    const rest = nodes.length - shown.length;
+    return rest > 0
+        ? `${rows}<tr><td colspan="4" style="color:var(--muted)">…and ${rest} more ${escapeHtml(kind)}</td></tr>`
+        : rows;
+}
+function renderStructure(diff) {
+    const tags = [
+        `<span class="difftag"><b>${diff.gained.length}</b> gained</span>`,
+        `<span class="difftag"><b>${diff.lost.length}</b> lost</span>`,
+        `<span class="difftag"><b>${diff.renamed.length}</b> renamed</span>`,
+        `<span class="difftag"><b>${diff.moved.length}</b> moved</span>`,
+        `<span class="difftag"><b>${diff.unchanged}</b> unchanged</span>`,
+    ].join('');
+    if (diff.changed === 0 && diff.moved.length === 0) {
+        return `${tags}<p class="empty">The accessibility tree is identical to the previous run.</p>`;
+    }
+    const renamedRows = diff.renamed
+        .slice(0, MAX_DIFF_ROWS)
+        .map((r) => `<tr>
+      <td>renamed</td>
+      <td>${escapeHtml(r.role)}</td>
+      <td>${escapeHtml(r.from ?? '(none)')} → <b>${escapeHtml(r.to ?? '(none)')}</b></td>
+      <td class="wrap mono">${escapeHtml(r.path)}</td>
+    </tr>`)
+        .join('');
+    const body = `${nodeRows(diff.gained, 'gained')}${nodeRows(diff.lost, 'lost')}${renamedRows}`;
+    return `${tags}
+<table><thead><tr><th>Change</th><th>Role</th><th>Accessible name</th><th>Path</th></tr></thead>
+<tbody>${body}</tbody></table>
+<p class="note">Compared on the accessibility tree, not the DOM: a restyled class name is invisible here, while a control losing its label is not. Elements that only moved are counted but not listed.</p>`;
+}
+function renderPixels(diff) {
+    if (!diff.comparable)
+        return `<p class="empty">${escapeHtml(diff.note ?? 'Pixel diff unavailable.')}</p>`;
+    const pct = diff.changedPercent === 0
+        ? '0'
+        : diff.changedPercent < 0.01
+            ? '<0.01'
+            : diff.changedPercent.toFixed(2);
+    const size = diff.sizeChanged
+        ? `<span class="difftag">size <b>${diff.previousSize?.width}×${diff.previousSize?.height}</b> → <b>${diff.currentSize?.width}×${diff.currentSize?.height}</b></span>`
+        : '';
+    const tags = `<span class="difftag"><b>${pct}%</b> of pixels changed</span>
+    <span class="difftag"><b>${diff.changedPixels.toLocaleString('en-US')}</b> of ${diff.totalPixels.toLocaleString('en-US')} pixels</span>${size}`;
+    if (!diff.diffDataUrl) {
+        return `${tags}<p class="empty">The screenshots are pixel-identical.</p>`;
+    }
+    const scaled = diff.scale
+        ? ` Shown at 1/${diff.scale} scale; a change smaller than one output pixel is still marked.`
+        : '';
+    return `${tags}
+<figure>
+  <figcaption>Changed pixels in magenta, over this run's screenshot.${escapeHtml(scaled)}</figcaption>
+  <img alt="Pixel differences against the previous run" src="${escapeHtml(diff.diffDataUrl)}">
+</figure>
+<p class="note">Per-channel tolerance is applied before counting, so anti-aliasing and font-hinting jitter do not register as change.</p>`;
+}
+export function renderDiff(diff) {
+    if (!diff)
+        return '';
+    const notes = diff.notes.length
+        ? `<p class="note">${diff.notes.map((n) => escapeHtml(n)).join(' ')}</p>`
+        : '';
+    const structure = diff.structure
+        ? `<h3 style="font-size:13px;color:var(--muted);margin:20px 0 8px">Structure</h3>${renderStructure(diff.structure)}`
+        : '';
+    const pixels = diff.pixels
+        ? `<h3 style="font-size:13px;color:var(--muted);margin:24px 0 8px">Pixels</h3>${renderPixels(diff.pixels)}`
+        : '';
+    if (!structure && !pixels) {
+        return `<h2>Changes since the previous run</h2>${notes || '<p class="empty">Nothing could be compared against the previous run.</p>'}`;
+    }
+    return `<h2>Changes since the previous run</h2>
+<p class="note">Compared against the run of ${escapeHtml(diff.previousCapturedAt)}.</p>
+${structure}
+${pixels}
+${notes}`;
+}
+//# sourceMappingURL=render-trend.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * Renders a Report as ONE self-contained HTML file: CSS inline, screenshots
+ * as `data:` URIs, no fonts, no CDN, no network access of any kind at view
+ * time. That is not a stylistic preference — it is what lets monomind's
+ * document pipeline ingest the file as an ordinary document, so test history
+ * becomes searchable, and what lets the report be mailed or archived and
+ * still render years later.
+ *
+ * Reading order matches how you triage: verdict, errors, failed requests,
+ * vitals, accessibility, screenshots.
+ */
+import type { FlakeReport } from './flake.js';
+import type { Report } from './types.js';
+import { escapeHtml } from './util.js';
+export { escapeHtml };
+export interface RenderOptions {
+    /** Present when the report came from `--repeat` (RIG-14). */
+    flake?: FlakeReport;
+}
+export declare function renderHtml(report: Report, options?: RenderOptions): string;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/report/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,KAAK,EAAe,MAAM,EAA4B,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,CAAC;AA6OtB,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAoD9E"}

package/dist/src/report/render.js

@@ -0,0 +1,286 @@
+/**
+ * Renders a Report as ONE self-contained HTML file: CSS inline, screenshots
+ * as `data:` URIs, no fonts, no CDN, no network access of any kind at view
+ * time. That is not a stylistic preference — it is what lets monomind's
+ * document pipeline ingest the file as an ordinary document, so test history
+ * becomes searchable, and what lets the report be mailed or archived and
+ * still render years later.
+ *
+ * Reading order matches how you triage: verdict, errors, failed requests,
+ * vitals, accessibility, screenshots.
+ */
+import { budgetLabel } from './budget.js';
+import { EVIDENCE_STYLES, renderEvidence, renderFlake } from './render-evidence.js';
+import { renderDiff, renderTrend, TREND_STYLES } from './render-trend.js';
+import { escapeHtml } from './util.js';
+export { escapeHtml };
+function ms(value) {
+    return value === undefined || !Number.isFinite(value) ? 'not measured' : `${Math.round(value)}ms`;
+}
+function vitalRating(metric, v) {
+    if (v === undefined || !Number.isFinite(v))
+        return 'none';
+    const scale = {
+        lcp: [2500, 4000],
+        fcp: [1800, 3000],
+        cls: [0.1, 0.25],
+        inp: [200, 500],
+        ttfb: [800, 1800],
+    };
+    const bounds = scale[metric];
+    if (!bounds)
+        return 'none';
+    return v <= bounds[0] ? 'good' : v <= bounds[1] ? 'mixed' : 'poor';
+}
+const STYLES = `
+:root{
+  --bg:#fbfbfd; --panel:#fff; --ink:#15171c; --muted:#5d6470; --line:#e3e6ec;
+  --pass:#0f7b4f; --pass-bg:#e7f6ee; --fail:#b3261e; --fail-bg:#fdeceb;
+  --warn:#8a5a00; --warn-bg:#fff5e0; --code:#f3f4f7;
+}
+@media (prefers-color-scheme: dark){
+  :root{
+    --bg:#101317; --panel:#171b21; --ink:#e7eaf0; --muted:#98a1b0; --line:#262c35;
+    --pass:#57d69c; --pass-bg:#11291f; --fail:#ff9a92; --fail-bg:#2c1614;
+    --warn:#f0c168; --warn-bg:#2b2113; --code:#1d222a;
+  }
+}
+*{box-sizing:border-box}
+body{margin:0;padding:32px 16px 72px;background:var(--bg);color:var(--ink);
+  font:15px/1.55 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Helvetica,Arial,sans-serif;}
+main{max-width:940px;margin:0 auto}
+h1{font-size:22px;margin:0 0 4px;letter-spacing:-.01em}
+h2{font-size:15px;text-transform:uppercase;letter-spacing:.08em;color:var(--muted);
+  margin:36px 0 12px;font-weight:600}
+a{color:inherit}
+.sub{color:var(--muted);font-size:13px;margin:0 0 24px;word-break:break-all}
+.verdict{border-radius:12px;padding:18px 20px;margin-bottom:8px;border:1px solid transparent}
+.verdict.pass{background:var(--pass-bg);border-color:var(--pass);color:var(--pass)}
+.verdict.fail{background:var(--fail-bg);border-color:var(--fail);color:var(--fail)}
+.verdict .tag{font-size:26px;font-weight:700;letter-spacing:.02em}
+.verdict .line{color:var(--ink);margin-top:6px;font-size:14px}
+.stats{display:flex;flex-wrap:wrap;gap:8px;margin:16px 0 0;padding:0;list-style:none}
+.stats li{background:var(--panel);border:1px solid var(--line);border-radius:8px;
+  padding:8px 12px;font-size:13px;color:var(--muted)}
+.stats li b{display:block;font-size:18px;color:var(--ink)}
+.stats li.bad b{color:var(--fail)}
+table{width:100%;border-collapse:collapse;background:var(--panel);
+  border:1px solid var(--line);border-radius:10px;overflow:hidden;font-size:13px}
+th,td{text-align:left;padding:9px 12px;border-bottom:1px solid var(--line);vertical-align:top}
+th{color:var(--muted);font-weight:600;white-space:nowrap}
+tr:last-child td{border-bottom:none}
+td.num{text-align:right;white-space:nowrap;font-variant-numeric:tabular-nums}
+.wrap{word-break:break-all}
+code,.mono{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:12px}
+code{background:var(--code);padding:1px 5px;border-radius:4px}
+.pill{display:inline-block;padding:1px 7px;border-radius:999px;font-size:11px;
+  font-weight:600;text-transform:uppercase;letter-spacing:.04em}
+.pill.error{background:var(--fail-bg);color:var(--fail)}
+.pill.warning{background:var(--warn-bg);color:var(--warn)}
+.pill.good{background:var(--pass-bg);color:var(--pass)}
+.pill.mixed{background:var(--warn-bg);color:var(--warn)}
+.pill.poor{background:var(--fail-bg);color:var(--fail)}
+.pill.none{background:var(--code);color:var(--muted)}
+.empty{color:var(--muted);font-size:13px;background:var(--panel);border:1px solid var(--line);
+  border-radius:10px;padding:12px}
+.note{color:var(--muted);font-size:12px;margin-top:8px}
+figure{margin:0 0 20px}
+figcaption{color:var(--muted);font-size:12px;margin-bottom:6px}
+img{max-width:100%;height:auto;display:block;border:1px solid var(--line);border-radius:10px}
+footer{margin-top:40px;color:var(--muted);font-size:12px;border-top:1px solid var(--line);
+  padding-top:12px}
+@media (max-width:640px){body{padding:20px 12px 48px}th,td{padding:8px}}
+`.trim();
+function emptyBlock(text) {
+    return `<p class="empty">${escapeHtml(text)}</p>`;
+}
+function renderVerdict(report) {
+    const pass = report.verdict === 'pass';
+    const headline = pass
+        ? 'All budgets met.'
+        : `${report.failures.length} budget ${report.failures.length === 1 ? 'failure' : 'failures'}.`;
+    const rows = report.failures
+        .map((f) => `<tr>
+        <td>${escapeHtml(budgetLabel(f.budget))}</td>
+        <td class="num mono">${escapeHtml(f.expected)}</td>
+        <td class="num mono">${escapeHtml(f.actual)}</td>
+        <td class="wrap">${escapeHtml(f.detail ?? '')}</td>
+      </tr>`)
+        .join('');
+    const table = report.failures.length
+        ? `<table><thead><tr><th>Budget</th><th>Expected</th><th>Actual</th><th>Evidence</th></tr></thead>
+       <tbody>${rows}</tbody></table>`
+        : '';
+    const unmeasured = report.unmeasured.length
+        ? `<p class="note">Not measured on this run: ${escapeHtml(report.unmeasured.join(', '))} — the page never reported the metric, so its budget was neither met nor breached.</p>`
+        : '';
+    return `<section class="verdict ${pass ? 'pass' : 'fail'}">
+    <div class="tag">${pass ? 'PASS' : 'FAIL'}</div>
+    <div class="line">${escapeHtml(headline)}</div>
+  </section>
+  ${table}
+  ${unmeasured}`;
+}
+function renderStats(report) {
+    const c = report.counts;
+    const item = (label, value, bad) => `<li class="${bad ? 'bad' : ''}"><b>${value}</b>${escapeHtml(label)}</li>`;
+    return `<ul class="stats">
+    ${item('console errors', c.consoleErrors, c.consoleErrors > 0)}
+    ${item('page errors', c.pageErrors, c.pageErrors > 0)}
+    ${item('failed requests', c.failedRequests, c.failedRequests > 0)}
+    ${item('requests', c.requests, false)}
+    ${item('a11y errors', c.a11yErrors, c.a11yErrors > 0)}
+    ${item('a11y warnings', c.a11yWarnings, false)}
+  </ul>`;
+}
+function renderErrors(report) {
+    const rows = [];
+    for (const e of report.pageErrors) {
+        const where = e.url ? `${e.url}${e.lineNumber !== undefined ? `:${e.lineNumber}` : ''}` : '';
+        rows.push(`<tr>
+      <td><span class="pill error">uncaught</span></td>
+      <td class="wrap">${escapeHtml(e.text)}</td>
+      <td class="wrap mono">${escapeHtml(where)}</td>
+    </tr>`);
+    }
+    for (const m of report.console) {
+        if (m.type !== 'error' && m.type !== 'warn' && m.type !== 'warning')
+            continue;
+        const pill = m.type === 'error' ? 'error' : 'warning';
+        const where = m.url ? `${m.url}${m.lineNumber !== undefined ? `:${m.lineNumber}` : ''}` : '';
+        rows.push(`<tr>
+      <td><span class="pill ${pill}">console.${escapeHtml(m.type)}</span></td>
+      <td class="wrap">${escapeHtml(m.text)}</td>
+      <td class="wrap mono">${escapeHtml(where)}</td>
+    </tr>`);
+    }
+    if (!rows.length)
+        return emptyBlock('No console errors, warnings or uncaught exceptions.');
+    return `<table><thead><tr><th>Kind</th><th>Message</th><th>Source</th></tr></thead>
+    <tbody>${rows.join('')}</tbody></table>`;
+}
+function renderRequests(requests) {
+    const failed = requests.filter((r) => r.failed);
+    if (!failed.length)
+        return emptyBlock('Every request returned a successful response.');
+    const rows = failed
+        .map((r) => `<tr>
+      <td class="mono">${escapeHtml(r.status ?? '—')}</td>
+      <td class="mono">${escapeHtml(r.method)}</td>
+      <td class="wrap mono">${escapeHtml(r.url)}</td>
+      <td class="wrap">${escapeHtml(r.errorText ?? '')}</td>
+    </tr>`)
+        .join('');
+    return `<table><thead><tr><th>Status</th><th>Method</th><th>URL</th><th>Error</th></tr></thead>
+    <tbody>${rows}</tbody></table>`;
+}
+function renderVitals(report) {
+    const v = report.vitals;
+    const defs = [
+        ['lcp', 'LCP', 'Largest Contentful Paint'],
+        ['fcp', 'FCP', 'First Contentful Paint'],
+        ['cls', 'CLS', 'Cumulative Layout Shift'],
+        ['inp', 'INP', 'Interaction to Next Paint'],
+        ['ttfb', 'TTFB', 'Time to First Byte'],
+    ];
+    const rows = defs
+        .map(([key, short, long]) => {
+        const raw = v[key];
+        const rating = vitalRating(key, raw);
+        const shown = key === 'cls' ? (raw === undefined ? 'not measured' : raw.toFixed(3)) : ms(raw);
+        return `<tr>
+        <td><b>${short}</b> <span style="color:var(--muted)">${escapeHtml(long)}</span></td>
+        <td class="num mono">${escapeHtml(shown)}</td>
+        <td><span class="pill ${rating}">${rating === 'none' ? 'n/a' : rating}</span></td>
+      </tr>`;
+    })
+        .join('');
+    const load = `<tr><td>Load event</td><td class="num mono">${escapeHtml(ms(v.loadTime))}</td><td></td></tr>
+    <tr><td>DOM interactive</td><td class="num mono">${escapeHtml(ms(v.domInteractive))}</td><td></td></tr>
+    <tr><td>Resources</td><td class="num mono">${escapeHtml(v.resources ?? '—')}</td><td></td></tr>`;
+    return `<table><thead><tr><th>Metric</th><th>Value</th><th>Rating</th></tr></thead>
+    <tbody>${rows}${load}</tbody></table>`;
+}
+function renderA11y(findings) {
+    const disclaimer = '<p class="note">Colour contrast is not evaluated: it cannot be derived from the accessibility tree, and guessing it would be worse than omitting it.</p>';
+    if (!findings.length) {
+        return `${emptyBlock('No accessibility findings from the AX tree.')}${disclaimer}`;
+    }
+    const order = { error: 0, warning: 1 };
+    const rows = [...findings]
+        .sort((a, b) => order[a.impact] - order[b.impact])
+        .map((f) => `<tr>
+      <td><span class="pill ${f.impact}">${escapeHtml(f.impact)}</span></td>
+      <td class="mono">${escapeHtml(f.rule)}</td>
+      <td>${escapeHtml(f.role)}</td>
+      <td>${f.name ? escapeHtml(f.name) : '<span style="color:var(--muted)">(no accessible name)</span>'}</td>
+      <td class="wrap mono">${escapeHtml(f.locator)}</td>
+      <td class="wrap">${escapeHtml(f.detail)}</td>
+    </tr>`)
+        .join('');
+    return `<table><thead><tr><th>Impact</th><th>Rule</th><th>Role</th><th>Name</th><th>Locator</th><th>Detail</th></tr></thead>
+    <tbody>${rows}</tbody></table>${disclaimer}`;
+}
+function renderScreenshots(shots) {
+    if (!shots.length)
+        return emptyBlock('No screenshot was captured.');
+    return shots
+        .map((s) => `<figure>
+      <figcaption>${escapeHtml(s.label)} — ${s.width}×${s.height}</figcaption>
+      <img alt="${escapeHtml(`${s.label} screenshot`)}" src="${escapeHtml(s.dataUrl)}">
+    </figure>`)
+        .join('');
+}
+export function renderHtml(report, options = {}) {
+    const title = report.title || report.finalUrl || report.url;
+    const notes = report.notes.length
+        ? `<h2>Run notes</h2><ul class="empty">${report.notes.map((n) => `<li>${escapeHtml(n)}</li>`).join('')}</ul>`
+        : '';
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="color-scheme" content="light dark">
+<title>${escapeHtml(`Page report — ${title}`)}</title>
+<style>${STYLES}
+${TREND_STYLES}
+${EVIDENCE_STYLES}</style>
+</head>
+<body>
+<main>
+<h1>${escapeHtml(title)}</h1>
+<p class="sub">${escapeHtml(report.finalUrl || report.url)} · captured ${escapeHtml(report.capturedAt)} · ${Math.round(report.durationMs)}ms</p>
+
+${renderVerdict(report)}
+${renderFlake(options.flake)}
+${renderStats(report)}
+
+${renderTrend(report.trend)}
+${renderDiff(report.diff)}
+
+<h2>Errors</h2>
+${renderErrors(report)}
+
+${renderEvidence(report.evidence)}
+
+<h2>Failed requests</h2>
+${renderRequests(report.requests)}
+
+<h2>Web vitals</h2>
+${renderVitals(report)}
+
+<h2>Accessibility</h2>
+${renderA11y(report.a11y)}
+
+<h2>Screenshots</h2>
+${renderScreenshots(report.screenshots)}
+
+${notes}
+<footer>Generated by monobrowse report — self-contained, no external resources.</footer>
+</main>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=render.js.map

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * Assembles the run-to-run diff (RIG-10) from what the previous run left in
+ * the history directory: its structural signature (in the JSON record) and
+ * its screenshot (the sibling PNG).
+ *
+ * Every missing piece degrades into a note rather than an absent section, so
+ * a reader can tell "nothing changed" apart from "we could not check".
+ */
+import { type HistoryRun } from './history.js';
+import { type PixelDiffOptions } from './pixel-diff.js';
+import type { Report, RunDiff } from './types.js';
+export interface BuildRunDiffOptions {
+    pixels?: PixelDiffOptions;
+    /** Set false to skip the pixel half entirely. */
+    comparePixels?: boolean;
+}
+export declare function buildRunDiff(dir: string, previous: HistoryRun | undefined, current: Report, options?: BuildRunDiffOptions): Promise<RunDiff | undefined>;
+//# sourceMappingURL=run-diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-diff.d.ts","sourceRoot":"","sources":["../../../src/report/run-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAqB,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,KAAK,gBAAgB,EAAa,MAAM,iBAAiB,CAAC;AAGnE,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,iDAAiD;IACjD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,UAAU,GAAG,SAAS,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAoC9B"}

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

@@ -0,0 +1,51 @@
+/**
+ * Assembles the run-to-run diff (RIG-10) from what the previous run left in
+ * the history directory: its structural signature (in the JSON record) and
+ * its screenshot (the sibling PNG).
+ *
+ * Every missing piece degrades into a note rather than an absent section, so
+ * a reader can tell "nothing changed" apart from "we could not check".
+ */
+import { loadRunScreenshot } from './history.js';
+import { pixelDiff } from './pixel-diff.js';
+import { pngFromDataUrl } from './png.js';
+import { diffStructure } from './structure.js';
+export async function buildRunDiff(dir, previous, current, options = {}) {
+    if (!previous)
+        return undefined;
+    const notes = [];
+    const diff = {
+        previousRunId: previous.id,
+        previousCapturedAt: previous.capturedAt,
+        notes,
+    };
+    if (previous.structure?.length && current.structure?.length) {
+        diff.structure = diffStructure(previous.structure, current.structure);
+    }
+    else if (!current.structure?.length) {
+        notes.push('No accessibility tree this run — structural diff skipped.');
+    }
+    else {
+        notes.push('The previous run stored no structural signature — nothing to diff against.');
+    }
+    if (options.comparePixels !== false) {
+        const currentShot = current.screenshots.find((s) => s.label === 'page') ?? current.screenshots[0];
+        const previousPng = await loadRunScreenshot(dir, previous);
+        if (!previousPng) {
+            notes.push('The previous run archived no screenshot — pixel diff skipped.');
+        }
+        else if (!currentShot?.dataUrl) {
+            notes.push('No screenshot this run — pixel diff skipped.');
+        }
+        else {
+            try {
+                diff.pixels = pixelDiff(previousPng, pngFromDataUrl(currentShot.dataUrl), options.pixels);
+            }
+            catch (err) {
+                notes.push(`Pixel diff failed: ${err.message}`);
+            }
+        }
+    }
+    return diff;
+}
+//# sourceMappingURL=run-diff.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-diff.js","sourceRoot":"","sources":["../../../src/report/run-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAmB,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAyB,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAS/C,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAW,EACX,QAAgC,EAChC,OAAe,EACf,OAAO,GAAwB,EAAE;IAEjC,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAY;QACpB,aAAa,EAAE,QAAQ,CAAC,EAAE;QAC1B,kBAAkB,EAAE,QAAQ,CAAC,UAAU;QACvC,KAAK;KACN,CAAC;IAEF,IAAI,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAC5D,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACxE,CAAC;SAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IAC1E,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;IAC3F,CAAC;IAED,IAAI,OAAO,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;QACpC,MAAM,WAAW,GACf,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC3D,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;QAC9E,CAAC;aAAM,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,WAAW,EAAE,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAC5F,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,KAAK,CAAC,IAAI,CAAC,sBAAuB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}