@rehearsal-labs/retest 0.1.0 → 0.2.0

package/dist/reporters/format.d.ts.map

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

package/dist/reporters/format.js

@@ -91,6 +91,15 @@ export function runNotes(result) {
         ...(result.narrowed === undefined ? [] : ['narrowed by test.only']),
     ];
 }
+/**
+ * How many screenshot baselines a run wrote, as reports say it, so a run that wrote them never reads as an ordinary
+ * pass: its checks compared nothing with what they wrote.
+ *
+ * @example describeBaselinesWritten(2) // '2 written by --update-screenshots'
+ */
+export function describeBaselinesWritten(count) {
+    return `${count} written by --update-screenshots`;
+}
 export function totalTests(counts) {
     return counts.passed + counts.failed + counts.error + counts.notRun + counts.inconclusive + (counts.skipped ?? 0);
 }
@@ -112,6 +121,39 @@ export function describeLocks(event) {
     const held = `holds ${event.locks.length === 1 ? 'lock' : 'locks'} ${listWords(event.locks, 'and')}`;
     return event.waitedMs === 0 ? held : `${held}, after waiting ${formatDuration(event.waitedMs)}`;
 }
+/**
+ * A test's read of an inbox: the message it was given, by its subject as the test read it, or that it was given none,
+ * and how many looks it took.
+ *
+ * @example describeInboxRead({ inbox: 'owner', subject: 'Your code is {{code}}', looks: 3 }) // 'inbox owner gave "Your code is {{code}}" after 3 looks'
+ */
+export function describeInboxRead(event) {
+    const given = event.subject === undefined ? 'gave no message' : `gave ${JSON.stringify(event.subject)}`;
+    return `inbox ${event.inbox} ${given}${event.looks === 0 ? '' : ` after ${plural(event.looks, 'look')}`}`;
+}
+/**
+ * A download a page made: the name the browser suggested, where it began when not in the app's page, and its size once
+ * saved, that Retest removed it for holding a secret, how much of it arrived when the browser stopped it, or that it was
+ * still on its way when its test ended.
+ *
+ * @example describeDownload({ suggestedFilename: 'tasks.csv', state: 'completed', size: 35 }) // 'download tasks.csv, 35 bytes'
+ */
+export function describeDownload(event) {
+    const started = event.startedIn === undefined ? '' : event.startedIn === 'popup' ? ' from a page it opened' : ' from another page';
+    const name = `download ${printable(event.suggestedFilename)}${started}`;
+    const received = event.receivedBytes ?? 0;
+    const arrived = event.totalBytes === undefined || event.totalBytes === 0 ? plural(received, 'byte') : `${received} of ${plural(event.totalBytes, 'byte')}`;
+    switch (event.state) {
+        case 'completed':
+            return `${name}, ${plural(event.size ?? 0, 'byte')}`;
+        case 'withheld':
+            return `${name} not kept: it held a secret`;
+        case 'canceled':
+            return `${name} stopped after ${arrived}`;
+        case 'unfinished':
+            return `${name} unfinished when the test ended, ${arrived}`;
+    }
+}
 /**
  * The desktop, devices and data folders an attempt took, and how long it waited for them.
  *

package/dist/reporters/html/comparison-view.d.ts

@@ -0,0 +1,12 @@
+import type { FailureCard } from '../failure-card.ts';
+import type { ArtifactFiles } from './artifact-files.ts';
+import type { Markup } from './markup.ts';
+/**
+ * The pictures a failed screenshot comparison left, side by side, each linked to its file in the run folder: the
+ * baseline it expected, the picture the page showed, and where the two differ, in red. A picture the safe read refuses
+ * is named in a frame where it would have been. Undefined when the failing call left no pictures.
+ *
+ * @example comparisonView(card, context.files)
+ */
+export declare function comparisonView(card: FailureCard, files: ArtifactFiles): Markup | undefined;
+//# sourceMappingURL=comparison-view.d.ts.map

package/dist/reporters/html/comparison-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison-view.d.ts","sourceRoot":"","sources":["../../../src/reporters/html/comparison-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAMzC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAS1F"}

package/dist/reporters/html/comparison-view.js

@@ -0,0 +1,21 @@
+import { html } from "./markup.js";
+import { pictureView } from "./screenshots-view.js";
+const names = { expected: 'Expected', actual: 'Actual', diff: 'Difference' };
+/**
+ * The pictures a failed screenshot comparison left, side by side, each linked to its file in the run folder: the
+ * baseline it expected, the picture the page showed, and where the two differ, in red. A picture the safe read refuses
+ * is named in a frame where it would have been. Undefined when the failing call left no pictures.
+ *
+ * @example comparisonView(card, context.files)
+ */
+export function comparisonView(card, files) {
+    const { call } = card;
+    if (call?.type !== 'assertion.failed' || call.attachments === undefined || call.attachments.length === 0)
+        return undefined;
+    const subject = call.screenshot === undefined ? 'the check' : `"${call.screenshot.name}"`;
+    const shown = call.attachments.map(({ name, path }) => {
+        const label = names[name] ?? name;
+        return pictureView(files.picture(path), `${label} picture of ${subject}`, `${label} · ${path}`);
+    });
+    return html `<div class="shots comparison">${shown}</div>`;
+}

package/dist/reporters/html/diagnostics-view.js

@@ -135,11 +135,19 @@ function requestRow(row, clock) {
         ...(failed === undefined ? [] : [failed.blocked === undefined ? failed.reason : `${failed.reason}, blocked: ${failed.blocked}`]),
         ...(pending === undefined ? [] : [describePending(pending)]),
         ...(response?.serviceWorker === true ? ['answered by a service worker'] : []),
+        ...mockedBy(response?.route ?? failed?.route, failed?.routeRefused),
     ];
     const during = elapsed === undefined ? undefined : clock.during(elapsed);
     const under = [...endings, ...(during === undefined ? [] : [`during ${during}`])].map((line) => html `<div class="muted small words">${line}</div>`);
     return html `<tr><td class="time">${elapsed === undefined ? '?' : formatDuration(elapsed)}</td><td class="muted">${request.requestId}</td><td>${request.method}</td><td>${status}</td><td class="number">${durationMs === undefined ? '' : formatMilliseconds(durationMs)}</td><td><span class="words">${request.url}</span>${under}</td></tr>`;
 }
+// A hop one of the page's routes answered or refused is the test's own, and says which route, and why Chrome refused
+// the route's answer when it did.
+function mockedBy(route, refused) {
+    if (route === undefined)
+        return [];
+    return [`mocked by page.route(${route})${refused === undefined ? '' : `, whose answer Chrome refused: ${refused}`}`];
+}
 // A hop handed outside the scope is not pending: its end is reported where Retest does not listen.
 function describePending({ reason, lastState }) {
     return reason === 'out_of_scope' ? `out of scope after it was ${lastState}` : `pending, ${lastState}, ${reason.replaceAll('_', ' ')}`;

package/dist/reporters/html/downloads-view.d.ts

@@ -0,0 +1,10 @@
+import type { TestEvent } from '../run-record.ts';
+import type { Markup } from './markup.ts';
+/**
+ * A test's downloads, each linked to its file in the run folder so a reviewer can open it, or saying why there is none:
+ * the browser stopped it, it was unfinished when the test ended, or its file is not where its record says.
+ *
+ * @example downloadsView(events, '/work/.retest/runs/2026-10-14T10-00-00')
+ */
+export declare function downloadsView(events: readonly TestEvent[], directory: string): Markup | undefined;
+//# sourceMappingURL=downloads-view.d.ts.map

package/dist/reporters/html/downloads-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloads-view.d.ts","sourceRoot":"","sources":["../../../src/reporters/html/downloads-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAQzC;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIjG"}

package/dist/reporters/html/downloads-view.js

@@ -0,0 +1,29 @@
+import { checkArtifact } from "../../store/artifacts.js";
+import { describeDownload, failureLabel } from "../format.js";
+import { artifactLink, html } from "./markup.js";
+// Larger than any file a test downloads; the report links to the file and never reads it.
+const maxDownloadBytes = Number.MAX_SAFE_INTEGER;
+/**
+ * A test's downloads, each linked to its file in the run folder so a reviewer can open it, or saying why there is none:
+ * the browser stopped it, it was unfinished when the test ended, or its file is not where its record says.
+ *
+ * @example downloadsView(events, '/work/.retest/runs/2026-10-14T10-00-00')
+ */
+export function downloadsView(events, directory) {
+    const downloads = events.filter((event) => event.type === 'download');
+    if (downloads.length === 0)
+        return undefined;
+    return html `<ul class="downloads">${downloads.map((event) => html `<li class="words">${downloadItem(event, directory)}</li>`)}</ul>`;
+}
+function downloadItem(event, directory) {
+    const what = describeDownload(event);
+    if (event.state !== 'completed' || event.path === undefined) {
+        const failed = event.failure === undefined ? '' : html ` <span class="status status-failed">${failureLabel(event.failure.class)}</span>`;
+        return html `${what}${failed}`;
+    }
+    const checked = checkArtifact(directory, event.path, { maxBytes: maxDownloadBytes });
+    const link = artifactLink(event.path);
+    if (!checked.ok || link === undefined)
+        return html `${what}: <code>${event.path}</code> cannot be opened (${checked.ok ? 'not a path inside the run folder' : checked.message})`;
+    return html `<a href="${link}" download><code>${event.path}</code></a> · ${what}`;
+}

package/dist/reporters/html/style.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/reporters/html/style.ts"],"names":[],"mappings":"AAIA,yEAAyE;AACzE,eAAO,MAAM,UAAU,EAAE,MAqIxB,CAAA"}
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/reporters/html/style.ts"],"names":[],"mappings":"AAIA,yEAAyE;AACzE,eAAO,MAAM,UAAU,EAAE,MAwIxB,CAAA"}

package/dist/reporters/html/style.js

@@ -113,6 +113,9 @@ tr.row-failed td.what { color: var(--failed); }
 .shot { margin: 0; max-width: 100%; }
 .shot img, .shot video { display: block; max-width: min(100%, 38rem); height: auto; border: 1px solid var(--rule); border-radius: 4px; }
 .shot figcaption { font-size: 12px; color: var(--muted); margin-top: 4px; overflow-wrap: anywhere; }
+.comparison { flex-wrap: nowrap; }
+.comparison .shot { flex: 1 1 0; min-width: 0; max-width: 24rem; }
+.comparison .shot img { width: 100%; max-width: 100%; height: auto; }
 .gap { margin: 10px 0 0; padding: 12px 14px; border: 1.5px dashed var(--muted); border-radius: 4px; color: var(--muted); font-size: 13px; overflow-wrap: anywhere; }
 .gap strong { color: var(--ink); font-weight: 600; }
 .part { margin: 14px 0 0; }

package/dist/reporters/html/summary-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summary-view.d.ts","sourceRoot":"","sources":["../../../src/reporters/html/summary-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAmB/C,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAO5F;AA+ED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAQ1F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAK7F"}
+{"version":3,"file":"summary-view.d.ts","sourceRoot":"","sources":["../../../src/reporters/html/summary-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAmB/C,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAO5F;AAgFD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAQ1F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAK7F"}

package/dist/reporters/html/summary-view.js

@@ -1,7 +1,7 @@
 import { diagnosticsTotals } from "../../diagnostics/report.js";
 import { countEvaluations } from "../../evaluation/report.js";
 import { describeFileProblem, runFailureToShow } from "../failure-card.js";
-import { countParts, describeNarrowed, failureLabel, formatDetail, formatDuration, runNotes, testTitle } from "../format.js";
+import { countParts, describeBaselinesWritten, describeNarrowed, failureLabel, formatDetail, formatDuration, runNotes, testTitle } from "../format.js";
 import { countHostChecks } from "../host-checks.js";
 import { describeBrowser, describeNative, targetSummaries, variantLabel } from "../targets.js";
 import { codeFrameView, failureView } from "./failure-view.js";
@@ -113,7 +113,8 @@ function noticesView(context) {
     const stopped = result.status === 'interrupted' ? html `<div class="notice notice-error">The run was stopped before it finished. Tests it had not reached did not run.</div>` : undefined;
     const incomplete = result.complete ? undefined : html `<div class="notice notice-error">The run is incomplete: it did not check everything it was asked to check.</div>`;
     const narrowed = result.narrowed === undefined ? undefined : html `<div class="notice notice-error words">${describeNarrowed(result.narrowed)}</div>`;
-    return html `${read}${failed}${stopped}${incomplete}${narrowed}`;
+    const baselines = result.baselinesWritten === undefined ? undefined : html `<div class="notice notice-error words">Screenshot baselines: ${describeBaselinesWritten(result.baselinesWritten)}, so their checks compared nothing.</div>`;
+    return html `${read}${failed}${stopped}${incomplete}${narrowed}${baselines}`;
 }
 /**
  * Every test in one table, in run order, each linked to its section: its status, title, targets, time and how much of

package/dist/reporters/html/test-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-view.d.ts","sourceRoot":"","sources":["../../../src/reporters/html/test-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAiBxD,+GAA+G;AAC/G,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,CAAA;AAI9I,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAE9E"}
+{"version":3,"file":"test-view.d.ts","sourceRoot":"","sources":["../../../src/reporters/html/test-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAmBxD,+GAA+G;AAC/G,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,CAAA;AAI9I,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAE9E"}

package/dist/reporters/html/test-view.js

@@ -3,11 +3,13 @@ import { formatInspectCommand } from "../commands.js";
 import { notRunReason } from "../failure-card.js";
 import { failureLabel, formatDuration, statusLabel, testTitle } from "../format.js";
 import { namingTargets, variantLabel } from "../targets.js";
+import { comparisonView } from "./comparison-view.js";
 import { diagnosticsView } from "./diagnostics-view.js";
+import { downloadsView } from "./downloads-view.js";
 import { evaluationsView } from "./evaluations-view.js";
 import { evidenceLabel, noScreenshotReason } from "./evidence-status.js";
 import { codeFrameView, failureView } from "./failure-view.js";
-import { html } from "./markup.js";
+import { html, join } from "./markup.js";
 import { recordingsView } from "./recordings-view.js";
 import { replayView } from "./replay-view.js";
 import { screenshotsView } from "./screenshots-view.js";
@@ -54,7 +56,7 @@ function head({ test, evidence }, context) {
 }
 function body(entry, context) {
     const { test, card, evidence, events } = entry;
-    const failing = card === undefined ? undefined : failureView(card);
+    const failing = card === undefined ? undefined : join([failureView(card), comparisonView(card, context.files)]);
     const reasons = evidenceReasons(entry);
     const warnings = evaluationWarnings(test).map((warning) => html `<div class="notice notice-error words">${warning}</div>`);
     const notRun = notRunNote(test, context);
@@ -62,11 +64,12 @@ function body(entry, context) {
     const pictures = screenshotsView(evidence.screenshots, { missing });
     const code = card?.location === undefined ? undefined : codeFrameView(context, card.location);
     const recordings = recordingsView(test.recordings ?? [], context.files);
+    const downloads = downloadsView(events, context.input.directory);
     const evaluations = evaluationsView(test.evaluations ?? [], context.files);
     const openChecks = (test.evaluations ?? []).some((record) => record.verdict !== 'pass' && record.verdict !== 'not_run');
     const diagnostics = diagnosticsView(test.diagnostics ?? [], events, context.files);
     const replay = replayView(test);
-    return html `${failing}${notRun}${warnings}${reasons}${pictures}${code}${part('Recordings', recordings, card !== undefined)}${part('AI checks', evaluations, openChecks)}${part('Steps', timelineView(test, events), false)}${part('Console and network', diagnostics, false)}${part('Targets', targetsView(test, context), false)}${part('Replay facts', replay, false)}${commands(entry, context)}`;
+    return html `${failing}${notRun}${warnings}${reasons}${pictures}${code}${part('Recordings', recordings, card !== undefined)}${part('Downloads', downloads, card !== undefined)}${part('AI checks', evaluations, openChecks)}${part('Steps', timelineView(test, events), false)}${part('Console and network', diagnostics, false)}${part('Targets', targetsView(test, context), false)}${part('Replay facts', replay, false)}${commands(entry, context)}`;
 }
 function part(title, content, open) {
     if (content === undefined)

package/dist/reporters/html/timeline-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeline-view.d.ts","sourceRoot":"","sources":["../../../src/reporters/html/timeline-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAE1D,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAE9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAqCzC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAoBnF"}
+{"version":3,"file":"timeline-view.d.ts","sourceRoot":"","sources":["../../../src/reporters/html/timeline-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAE1D,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAE9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAyCzC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAqBnF"}

package/dist/reporters/html/timeline-view.js

@@ -5,7 +5,9 @@ import { describeLocator } from "../../protocol/locator.js";
 import { secretPlaceholder } from "../../protocol/secret.js";
 import { describeLeaseParts } from "../../runner/resources.js";
 import { actionNotes, describeWrittenAction } from "../actions.js";
-import { describeCleanup, describeLeaseExpired, describeLocks, describePage, describePreparation, describeResources, describeSessions, describeSessionsReleased, describeStateEvent, failureLabel, formatDuration, plural, printable, statusLabel, } from "../format.js";
+import { describeDialog, describePopupClosed, describePopupOpened } from "../dialogs-popups.js";
+import { describeRouteChange } from "../routes.js";
+import { describeCleanup, describeDownload, describeInboxRead, describeLeaseExpired, describeLocks, describePage, describePreparation, describeResources, describeSessions, describeSessionsReleased, describeStateEvent, failureLabel, formatDuration, plural, printable, statusLabel, } from "../format.js";
 import { describeHostCheck, hostCheckPage } from "../host-checks.js";
 import { html } from "./markup.js";
 const marks = { passed: '✓', failed: '✗', warning: '!' };
@@ -23,7 +25,8 @@ export function timelineView(test, events) {
     if (events.length === 0)
         return html `<p class="gap">No steps are shown: the run folder holds no events for this test.</p>`;
     const start = events[0]?.elapsedMs ?? 0;
-    const named = test.variant !== undefined;
+    // A popup's steps are the popup's own, so a test that was given one names the app of every row, as a variant does.
+    const named = test.variant !== undefined || events.some((event) => event.type === 'popup.opened');
     const stepNames = new Map();
     let depth = 0;
     const rows = [];
@@ -70,7 +73,12 @@ function isPageEvent(event) {
         case 'recording.finished':
         case 'capture.withheld':
         case 'capture.resumed':
+        case 'dialog':
+        case 'popup.opened':
+        case 'popup.closed':
         case 'capture.masked_entry':
+        case 'download':
+        case 'route':
             return true;
         default:
             return false;
@@ -133,6 +141,22 @@ function describe(entry, stepNames) {
             return { what: `screenshot not saved: ${event.message}`, mark: 'warning' };
         case 'evaluation.finished':
             return describeEvaluationEvent(event);
+        case 'inbox.read':
+            return event.failure === undefined ? { what: describeInboxRead(event), took: event.waitedMs } : { what: describeInboxRead(event), mark: 'failed', took: event.waitedMs, failure: failureLabel(event.failure.class) };
+        case 'dialog':
+            return event.by === 'test' ? { what: describeDialog(event) } : { what: describeDialog(event), mark: 'warning' };
+        case 'popup.opened':
+            return { what: describePopupOpened(event) };
+        case 'popup.closed':
+            return { what: describePopupClosed(event) };
+        case 'download': {
+            const what = describeDownload(event);
+            if (event.state === 'completed')
+                return { what, ...(event.path === undefined ? {} : { details: [`file ${event.path}`] }) };
+            return event.failure === undefined ? { what, mark: 'warning' } : { what, mark: 'failed', failure: failureLabel(event.failure.class) };
+        }
+        case 'route':
+            return event.failure === undefined ? { what: describeRouteChange(event) } : { what: describeRouteChange(event), mark: 'failed', failure: failureLabel(event.failure.class) };
         case 'recording.started':
             return { what: `recording ${event.number} started: ${event.source}, ${event.mode}, ${event.width}×${event.height} at ${event.fps} fps` };
         case 'recording.finished': {

package/dist/reporters/human-card.js

@@ -135,6 +135,8 @@ function closing(card, options) {
     const lines = card.screenshots.map((path) => field('Screenshot', path));
     for (const problem of card.evidenceProblems)
         lines.push(field('Screenshot', `not saved: ${problem}`));
+    for (const { name, path } of card.attachments ?? [])
+        lines.push(field(attachmentLabel(name), path));
     for (const { label, value } of card.diagnostics ?? [])
         lines.push(field(label, value));
     for (const failure of card.cleanupFailures) {
@@ -146,6 +148,14 @@ function closing(card, options) {
     lines.push(field('Inspect', inspect));
     return lines;
 }
+// A screenshot comparison's pictures are named as a reader looks for them: what was expected, what came, and where.
+function attachmentLabel(name) {
+    if (name === 'expected')
+        return 'Expected';
+    if (name === 'actual')
+        return 'Actual';
+    return name === 'diff' ? 'Difference' : name;
+}
 // Labels may carry colour codes, so the padding counts only the visible characters.
 function field(label, value) {
     const gap = ' '.repeat(Math.max(2, labelWidth - visibleLength(label)));

package/dist/reporters/human.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"human.d.ts","sourceRoot":"","sources":["../../src/reporters/human.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAqC7C,OAAO,EAA0C,KAAK,MAAM,EAAE,MAAM,YAAY,CAAA;AAYhF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;IACd,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,mFAAmF;AACnF,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE,CAAA;AAE9E;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA0GhF"}
+{"version":3,"file":"human.d.ts","sourceRoot":"","sources":["../../src/reporters/human.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAsC7C,OAAO,EAA0C,KAAK,MAAM,EAAE,MAAM,YAAY,CAAA;AAYhF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;IACd,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,mFAAmF;AACnF,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE,CAAA;AAE9E;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA0GhF"}

package/dist/reporters/human.js

@@ -3,7 +3,7 @@ import { countEvaluations } from "../evaluation/report.js";
 import { variantKey } from "../protocol/variant.js";
 import { createChildEcho } from "./child-output.js";
 import { describeFileProblem, failureCards, fileProblemOf, notRunReason, runFailureToShow, testsNotRun, } from "./failure-card.js";
-import { countParts, describeAppEvent, describeBorrowedSetup, describeHolders, describeLeaseExpired, describeLocks, describeNarrowed, describeResources, describeSessions, describeStateEvent, failureLabel, formatDetail, formatDuration, messageLines, plural, runNotes, testTitle, titleWithin, } from "./format.js";
+import { countParts, describeAppEvent, describeBaselinesWritten, describeBorrowedSetup, describeHolders, describeLeaseExpired, describeLocks, describeNarrowed, describeResources, describeSessions, describeStateEvent, failureLabel, formatDetail, formatDuration, messageLines, plural, runNotes, testTitle, titleWithin, } from "./format.js";
 import { countHostChecks } from "./host-checks.js";
 import { renderCard } from "./human-card.js";
 import { RunRecord } from "./run-record.js";
@@ -228,6 +228,8 @@ function summaryLines(result, context) {
         rows.push(['Files', files.join(' · ')]);
     if (result.evidenceStatus !== undefined)
         rows.push(['Evidence', describeEvidence(result.evidenceStatus)]);
+    if (result.baselinesWritten !== undefined)
+        rows.push(['Baselines', describeBaselinesWritten(result.baselinesWritten)]);
     rows.push(['Time', formatDuration(result.durationMs)], ['Output', context.runFolder]);
     const notes = runNotes(result);
     const exit = `${result.exitCode}${notes.length === 0 ? '' : ` · ${notes.join(', ')}`}`;

package/dist/reporters/routes.d.ts

@@ -0,0 +1,9 @@
+import type { EventOfType } from './run-record.ts';
+/**
+ * A change to an app's routes as reports name it: the call as the test wrote it, with what an added route answers, or
+ * how many routes a removal took away; or a request a route could not answer because Chrome refused its answer.
+ *
+ * @example describeRouteChange({ operation: 'add', pattern: '/tasks/i', answer: { status: 200, bodyBytes: 2 } }) // 'page.route(/tasks/i) answers 200, 2 bytes'
+ */
+export declare function describeRouteChange(event: Pick<EventOfType<'route'>, 'operation' | 'pattern' | 'answer' | 'removed' | 'url'>): string;
+//# sourceMappingURL=routes.d.ts.map

package/dist/reporters/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/reporters/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAIlD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC,GAAG,MAAM,CAMrI"}

package/dist/reporters/routes.js

@@ -0,0 +1,17 @@
+import { describeRouteSummary } from "../protocol/routes.js";
+import { plural, printable } from "./format.js";
+/**
+ * A change to an app's routes as reports name it: the call as the test wrote it, with what an added route answers, or
+ * how many routes a removal took away; or a request a route could not answer because Chrome refused its answer.
+ *
+ * @example describeRouteChange({ operation: 'add', pattern: '/tasks/i', answer: { status: 200, bodyBytes: 2 } }) // 'page.route(/tasks/i) answers 200, 2 bytes'
+ */
+export function describeRouteChange(event) {
+    const pattern = printable(event.pattern);
+    if (event.operation === 'remove')
+        return `page.unroute(${pattern})${event.removed === undefined ? '' : ` removed ${plural(event.removed, 'route')}`}`;
+    if (event.operation === 'answer')
+        return `page.route(${pattern}) could not answer ${printable(event.url ?? 'a request')}, which Retest failed`;
+    const answer = event.answer === undefined ? '' : ` ${'abort' in event.answer ? '' : 'answers '}${describeRouteSummary(event.answer)}`;
+    return `page.route(${pattern})${answer}`;
+}

package/dist/runner/child-program.js

@@ -42,6 +42,16 @@ function receive(message) {
             return current?.resolveCommand(message.id, message.result);
         case 'evaluation-result':
             return current?.resolveEvaluation(message.id, message.answer);
+        case 'inbox-result':
+            return current?.resolveInbox(message.id, message.answer);
+        case 'dialog-result':
+            return current?.resolveDialog(message.id, message.answer);
+        case 'popup-result':
+            return current?.resolvePopup(message.id, message.answer);
+        case 'files-result':
+            return current?.resolveFiles(message.id, message.answer);
+        case 'route-result':
+            return current?.resolveRoute(message.id, message.answer);
         case 'abort':
             return current?.abort();
         case 'close':

package/dist/runner/contract.d.ts

@@ -124,6 +124,11 @@ export type RunOptions = {
      * is given. Absent, `only` narrows the run and the reports say so.
      */
     forbidOnly?: string;
+    /**
+     * Writes every screenshot baseline the run's checks compare against, from the picture each settled on, in place of
+     * any there, and passes those checks. The result counts what it wrote. Absent: each check compares with its baseline.
+     */
+    updateScreenshots?: true;
     /**
      * The files are Playwright test files. Their imports of `@playwright/test` resolve to Retest's own
      * `/playwright` subpath, relative imports may leave out their extension, and the run says so in `run.started`.

package/dist/runner/contract.d.ts.map

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

package/dist/runner/dialogs.d.ts

@@ -0,0 +1,71 @@
+import type { OwnedPage } from '../browser/contract.ts';
+import type { CommandResult } from '../protocol/commands.ts';
+import type { EventBody } from '../protocol/events.ts';
+import type { Failure } from '../protocol/failures.ts';
+import type { ChildMessage, ParentMessage } from '../protocol/messages.ts';
+import type { Timeouts } from '../protocol/timeouts.ts';
+/**
+ * What the parent's handling of a test's dialogs and popups needs of the running test: its pages, its own and the
+ * popups it was given, its clock and budgets, the child, its events, the failures it saw for itself, and its redactor.
+ */
+export type TestHost = {
+    readonly testId: string;
+    readonly attemptId: string;
+    readonly timeouts: Timeouts;
+    /** The page an app's commands go to, one of the test's own or a popup it was given. */
+    page(app: string): OwnedPage | undefined;
+    /** Why nothing more may go to the page, once the test was stopped or is over. */
+    refusal(): Failure | undefined;
+    /** Milliseconds the test has left, when its body has begun. */
+    remainingMs(): number | undefined;
+    /** Whether the test is running and not stopped, so its process still takes answers. */
+    answerable(): boolean;
+    /** Whether the test has sent a command to a page yet: a dialog answered before then belongs to no action of it. */
+    commandsSent(): boolean;
+    /** The step the test was in when its latest command arrived. */
+    stepId(): string | undefined;
+    send(message: ParentMessage): void;
+    emit(body: EventBody): void;
+    /** Records a failure the parent saw for itself, which fails the test whatever its process claims. */
+    observe(problem: Failure): void;
+    /** Ends the test: its process broke the protocol. */
+    violation(problem: string): void;
+    /** Hides every value the run hides in a text. */
+    redact(text: string): string;
+};
+type DialogMessage = Extract<ChildMessage, {
+    type: 'dialog';
+}>;
+/**
+ * The parent's side of a test's JavaScript dialogs. A wait arms the app's page at once, before the action the test runs
+ * next arrives, and gives the test the dialog when it opens, its text redacted, under an id of the attempt's own. An
+ * answer goes to the page that showed the dialog. A dialog nothing waited for is answered by the page, and recorded
+ * here: one that opened while no command ran fails the test, and one that opened during a command fails that command,
+ * in the words `withDialogText` gives it. A dialog the test was given and left open is dismissed as the body settles.
+ * Every dialog that closed is written down as a `dialog` event.
+ */
+export declare class TestDialogs {
+    #private;
+    constructor(host: TestHost);
+    /** Hears the dialogs an app's page answers itself. Returns a function that stops listening. */
+    watch(app: string, page: OwnedPage): () => void;
+    receive(message: DialogMessage): void;
+    /**
+     * Dismisses every dialog the test was given and left open, within `timeoutMs`, so its page answers again and the action
+     * that opened it can end. Each is written down as dismissed by Retest. Nothing is recorded against the test: its own
+     * process names the dialog it left open.
+     */
+    settle(timeoutMs: number): Promise<void>;
+    /** Stops every wait still running, with `reason`, as the test is stopped or ends; none is answered. */
+    stop(reason: Failure): void;
+}
+/**
+ * A command's answer, with a dialog the page answered while the command ran named in words: the page gives the
+ * dialog's text apart, as the page showed it, and only the parent can hide the run's values in it before quoting it.
+ * Any other answer is given back as it is.
+ *
+ * @example withDialogText(result, (text) => redactor.redact(text))
+ */
+export declare function withDialogText(result: CommandResult, redact: (text: string) => string): CommandResult;
+export {};
+//# sourceMappingURL=dialogs.d.ts.map

package/dist/runner/dialogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogs.d.ts","sourceRoot":"","sources":["../../src/runner/dialogs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAE5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,yBAAyB,CAAA;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAOvD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,uFAAuF;IACvF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;IACxC,iFAAiF;IACjF,OAAO,IAAI,OAAO,GAAG,SAAS,CAAA;IAC9B,+DAA+D;IAC/D,WAAW,IAAI,MAAM,GAAG,SAAS,CAAA;IACjC,uFAAuF;IACvF,UAAU,IAAI,OAAO,CAAA;IACrB,mHAAmH;IACnH,YAAY,IAAI,OAAO,CAAA;IACvB,gEAAgE;IAChE,MAAM,IAAI,MAAM,GAAG,SAAS,CAAA;IAC5B,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;IAClC,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAC3B,qGAAqG;IACrG,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IAC/B,qDAAqD;IACrD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,iDAAiD;IACjD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAC7B,CAAA;AAED,KAAK,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAA;AAI9D;;;;;;;GAOG;AACH,qBAAa,WAAW;;gBAMV,IAAI,EAAE,QAAQ;IAI1B,+FAA+F;IAC/F,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,IAAI;IAI/C,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAcrC;;;;OAIG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiF9C,uGAAuG;IACvG,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;CAoC5B;AAaD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,aAAa,CAIrG"}