@rehearsal-labs/retest 0.1.0 → 0.2.0

package/dist/protocol/diagnostics.d.ts

@@ -159,6 +159,9 @@ export type NetworkResponseRecord = DiagnosticIdentity & NativeNetworkProvenance
     serviceWorker?: boolean;
     protocol?: string;
     redirectedTo?: string;
+    /** The response was the test's own: a route of the page gave it in the network's place. `route` is its pattern. */
+    mocked?: true;
+    route?: string;
 };
 /**
  * A hop that finished: for a redirect, when its response arrived. `durationMs` is the browser's own measure from the
@@ -186,6 +189,13 @@ export type NetworkFailedRecord = DiagnosticIdentity & NativeNetworkProvenance &
     reason: string;
     canceled?: true;
     blocked?: string;
+    /**
+     * The failure was the test's own: a route of the page refused the request. `route` is its pattern, and
+     * `routeRefused` Chrome's reason when Chrome refused the route's answer, so Retest failed the request in its place.
+     */
+    mocked?: true;
+    route?: string;
+    routeRefused?: string;
 };
 /**
  * Why a hop's end is not recorded: it was still open when the attempt ended, the run was interrupted, the page crashed

package/dist/protocol/diagnostics.d.ts.map

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

package/dist/protocol/diagnostics.js

@@ -149,6 +149,8 @@ const responseShape = {
     serviceWorker: s.optional(s.boolean()),
     protocol: s.optional(s.string()),
     redirectedTo: s.optional(s.string()),
+    mocked: s.optional(s.literal(true)),
+    route: s.optional(s.string()),
 };
 const finishedShape = {
     ...nativeNetworkProvenance,
@@ -169,6 +171,9 @@ const failedShape = {
     reason: s.string(),
     canceled: s.optional(s.literal(true)),
     blocked: s.optional(s.string()),
+    mocked: s.optional(s.literal(true)),
+    route: s.optional(s.string()),
+    routeRefused: s.optional(s.string()),
 };
 const pendingShape = {
     ...identity,

package/dist/protocol/dialogs.d.ts

@@ -0,0 +1,104 @@
+import { type Failure } from './failures.ts';
+import { type Schema } from './schema.ts';
+/** The kinds of JavaScript dialog a page can open. */
+export type DialogType = 'alert' | 'confirm' | 'prompt' | 'beforeunload';
+export declare const dialogTypes: readonly DialogType[];
+/**
+ * A dialog as the test file's process receives it: its id within the attempt, its kind, the text the page showed and a
+ * prompt's default, both with every value the run hides replaced. A dialog other than a prompt has an empty default.
+ */
+export type DialogRecord = {
+    id: string;
+    type: DialogType;
+    message: string;
+    defaultValue: string;
+};
+/**
+ * What a test asks of an app's page about dialogs: to wait for the next one, to stop a wait whose action failed before
+ * any dialog opened, naming the wait by its id, or to answer a dialog it was given, with the text a prompt takes.
+ */
+export type DialogRequest = {
+    kind: 'wait';
+} | {
+    kind: 'stop';
+    wait: number;
+} | {
+    kind: 'answer';
+    dialog: string;
+    accept: boolean;
+    promptText?: string;
+};
+/**
+ * The parent's answers. A wait is first `armed`, once the page hands its next dialog to the test, then `opened` with that
+ * dialog, or `failed` at either point. A stop is `stopped`, and an answer `answered` or `failed`.
+ */
+export type DialogAnswer = {
+    kind: 'armed';
+} | {
+    kind: 'opened';
+    dialog: DialogRecord;
+} | {
+    kind: 'stopped';
+} | {
+    kind: 'answered';
+} | {
+    kind: 'failed';
+    failure: Failure;
+};
+/** How a dialog was answered: accepted or dismissed. */
+export type DialogAnswered = 'accepted' | 'dismissed';
+/** How many code units of a dialog's text an event records, as a title is cut. */
+export declare const dialogTextLimit = 300;
+export declare const dialogTypeSchema: Schema<DialogType>;
+export declare const dialogRecordSchema: Schema<DialogRecord>;
+export declare const dialogRequestSchema: Schema<DialogRequest>;
+export declare const dialogAnswerSchema: Schema<DialogAnswer>;
+/**
+ * Whether a value names a kind of dialog, as Chrome's `Page.javascriptDialogOpening` reports it.
+ *
+ * @example isDialogType('confirm') // true
+ */
+export declare function isDialogType(value: string): value is DialogType;
+/**
+ * Who reads a dialog's sentence: a test, which can wrap an action in `page.dialog()`, or an agent session, which cannot
+ * and is told what Retest answered instead.
+ */
+export type DialogReader = 'test' | 'agent';
+/** A dialog Retest answered itself because nothing waited for it, as a failure's sentence names it. */
+export type UnwaitedDialogParts = {
+    type: DialogType;
+    /** The text the page showed, as a sentence may quote it: redacted, or left out where it cannot be. */
+    text?: string | undefined;
+    answered: DialogAnswered;
+    /** The command that was running, as a failure names it, such as "click getByTestId('delete')"; none when idle. */
+    command?: string | undefined;
+    /** The dialog came from a page this page opened while nothing waited for it. */
+    popup?: boolean | undefined;
+    /** Who reads the sentence; a test unless named. */
+    reader?: DialogReader | undefined;
+};
+/**
+ * The sentence for a dialog nobody waited for, when it is the whole failure of the command that ran meanwhile: its kind
+ * and text, what was running, how Retest answered it, and, for a test, how to answer it. A `beforeunload` dialog is
+ * accepted, so the navigation the test asked for happens.
+ *
+ * @example unwaitedDialogMessage({ type: 'confirm', text: 'Delete?', answered: 'dismissed', command: "click getByTestId('delete')" })
+ */
+export declare function unwaitedDialogMessage(parts: UnwaitedDialogParts): string;
+/**
+ * The sentence for a dialog nobody waited for, when the command that ran meanwhile failed of its own accord: it follows
+ * that command's own message and names the dialog and Retest's answer.
+ *
+ * @example unwaitedDialogSentence({ type: 'alert', text: 'Saved', answered: 'dismissed' }) // 'The page also opened an alert dialog that says "Saved", and Retest dismissed it.'
+ */
+export declare function unwaitedDialogSentence(parts: UnwaitedDialogParts): string;
+/**
+ * A failure that names a dialog Retest answered, in words for its reader, with the dialog's text quoted once `redact` has
+ * hidden every value in it. The page gives that text apart, in `details.dialogMessage`, and a failure whose `details`
+ * name the command was the dialog's alone; any other is the command's own, with the dialog's sentence after it. Any
+ * other failure is given back as it is.
+ *
+ * @example withDialogWords(failure, (text) => redactor.redact(text), 'agent')
+ */
+export declare function withDialogWords(failure: Failure, redact: (text: string) => string, reader?: DialogReader): Failure;
+//# sourceMappingURL=dialogs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dialogs.d.ts","sourceRoot":"","sources":["../../src/protocol/dialogs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAK,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAG5C,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,cAAc,CAAA;AAExE,eAAO,MAAM,WAAW,EAAE,SAAS,UAAU,EAAmD,CAAA;AAEhG;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAA;AAElG;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAExJ;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAA;AAE3K,wDAAwD;AACxD,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,CAAA;AAErD,kFAAkF;AAClF,eAAO,MAAM,eAAe,MAAM,CAAA;AAElC,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAA0D,CAAA;AAE1G,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,YAAY,CAAuG,CAAA;AAE3J,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,aAAa,CAIpD,CAAA;AAEF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,YAAY,CAMlD,CAAA;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,CAAA;AAE3C,uGAAuG;AACvG,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,UAAU,CAAA;IAChB,sGAAsG;IACtG,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,QAAQ,EAAE,cAAc,CAAA;IACxB,kHAAkH;IAClH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,gFAAgF;IAChF,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC3B,mDAAmD;IACnD,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CAClC,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CASxE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAKzE;AASD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,MAAM,GAAE,YAAqB,GAAG,OAAO,CAe1H"}

package/dist/protocol/dialogs.js

@@ -0,0 +1,101 @@
+import { failureSchema } from "./failures.js";
+import { s } from "./schema.js";
+import { quoteText } from "./text.js";
+export const dialogTypes = ['alert', 'confirm', 'prompt', 'beforeunload'];
+/** How many code units of a dialog's text an event records, as a title is cut. */
+export const dialogTextLimit = 300;
+export const dialogTypeSchema = s.enum(['alert', 'confirm', 'prompt', 'beforeunload']);
+export const dialogRecordSchema = s.object({ id: s.string(), type: dialogTypeSchema, message: s.string(), defaultValue: s.string() });
+export const dialogRequestSchema = s.discriminatedUnion('kind', [
+    s.object({ kind: s.literal('wait') }),
+    s.object({ kind: s.literal('stop'), wait: s.number({ integer: true, min: 0 }) }),
+    s.object({ kind: s.literal('answer'), dialog: s.string(), accept: s.boolean(), promptText: s.optional(s.string()) }),
+]);
+export const dialogAnswerSchema = s.discriminatedUnion('kind', [
+    s.object({ kind: s.literal('armed') }),
+    s.object({ kind: s.literal('opened'), dialog: dialogRecordSchema }),
+    s.object({ kind: s.literal('stopped') }),
+    s.object({ kind: s.literal('answered') }),
+    s.object({ kind: s.literal('failed'), failure: failureSchema }),
+]);
+/**
+ * Whether a value names a kind of dialog, as Chrome's `Page.javascriptDialogOpening` reports it.
+ *
+ * @example isDialogType('confirm') // true
+ */
+export function isDialogType(value) {
+    return dialogTypes.some((type) => type === value);
+}
+/**
+ * The sentence for a dialog nobody waited for, when it is the whole failure of the command that ran meanwhile: its kind
+ * and text, what was running, how Retest answered it, and, for a test, how to answer it. A `beforeunload` dialog is
+ * accepted, so the navigation the test asked for happens.
+ *
+ * @example unwaitedDialogMessage({ type: 'confirm', text: 'Delete?', answered: 'dismissed', command: "click getByTestId('delete')" })
+ */
+export function unwaitedDialogMessage(parts) {
+    const { type, command, popup, reader } = parts;
+    const agent = reader === 'agent';
+    const who = popup === true ? 'A page this page opened showed' : agent ? 'The page showed' : 'The page opened';
+    const when = command === undefined ? (agent ? 'between commands' : 'while no action was running') : `while Retest tried to ${command}`;
+    const opened = `${who} ${article(type)} ${type} dialog${says(parts.text)} ${when}.`;
+    if (agent)
+        return `${opened} ${capitalize(answeredWords(parts))}.`;
+    const fix = popup === true ? 'To answer it, take that page with page.popup() and wrap its action in dialog().' : command === undefined ? 'To answer it, wrap the action that opens it in page.dialog().' : 'To answer it, wrap the action in page.dialog().';
+    return `${opened} ${capitalize(answeredWords(parts))}. ${fix}`;
+}
+/**
+ * The sentence for a dialog nobody waited for, when the command that ran meanwhile failed of its own accord: it follows
+ * that command's own message and names the dialog and Retest's answer.
+ *
+ * @example unwaitedDialogSentence({ type: 'alert', text: 'Saved', answered: 'dismissed' }) // 'The page also opened an alert dialog that says "Saved", and Retest dismissed it.'
+ */
+export function unwaitedDialogSentence(parts) {
+    const { type, popup, reader } = parts;
+    const verb = reader === 'agent' ? 'showed' : 'opened';
+    const who = popup === true ? 'A page this page opened also showed' : `The page also ${verb}`;
+    return `${who} ${article(type)} ${type} dialog${says(parts.text)}, and ${answeredWords(parts)}.`;
+}
+// What Retest did with a dialog, as a test reads it, or as an agent reads it: the answer a person would have given.
+function answeredWords({ type, answered, reader }) {
+    if (reader !== 'agent')
+        return answered === 'accepted' ? 'Retest accepted it, so the page could leave' : 'Retest dismissed it';
+    if (answered === 'accepted')
+        return 'Retest answered yes, so the page could leave';
+    return type === 'alert' ? 'Retest closed it' : 'Retest answered no';
+}
+/**
+ * A failure that names a dialog Retest answered, in words for its reader, with the dialog's text quoted once `redact` has
+ * hidden every value in it. The page gives that text apart, in `details.dialogMessage`, and a failure whose `details`
+ * name the command was the dialog's alone; any other is the command's own, with the dialog's sentence after it. Any
+ * other failure is given back as it is.
+ *
+ * @example withDialogWords(failure, (text) => redactor.redact(text), 'agent')
+ */
+export function withDialogWords(failure, redact, reader = 'test') {
+    const { details } = failure;
+    const text = details?.['dialogMessage'];
+    const type = details?.['dialog'];
+    const given = details?.['answered'];
+    const command = details?.['command'];
+    const answered = given === 'accepted' || given === 'dismissed' ? given : undefined;
+    if (typeof text !== 'string' || typeof type !== 'string' || !isDialogType(type) || answered === undefined)
+        return failure;
+    const { dialogMessage: _text, command: _command, ...kept } = details ?? {};
+    const parts = { type, answered, popup: details?.['popup'] === true, reader };
+    if (typeof command === 'string')
+        return { ...failure, message: unwaitedDialogMessage({ ...parts, text: redact(text), command }), details: kept };
+    // The page wrote the dialog's sentence after the command's own message, for a test and without the text.
+    const written = ` ${unwaitedDialogSentence({ type, answered, popup: parts.popup })}`;
+    const own = failure.message.endsWith(written) ? failure.message.slice(0, -written.length) : failure.message;
+    return { ...failure, message: `${own} ${unwaitedDialogSentence({ ...parts, text: redact(text) })}`, details: kept };
+}
+function says(text) {
+    return text === undefined || text === '' ? '' : ` that says ${quoteText(text)}`;
+}
+function capitalize(text) {
+    return `${text.charAt(0).toUpperCase()}${text.slice(1)}`;
+}
+function article(word) {
+    return /^[aeiou]/.test(word) ? 'an' : 'a';
+}

package/dist/protocol/drag.d.ts

@@ -0,0 +1,45 @@
+import type { Failure } from './failures.ts';
+import type { LocatorRecipe } from './locator.ts';
+import { type Schema } from './schema.ts';
+/** How many positions a drag moves the mouse through on its way to the target when the test gives no `steps`. */
+export declare const defaultDragSteps = 5;
+/** The most positions a test may ask a drag to move through. Each one waits for a frame of the page. */
+export declare const maxDragSteps = 100;
+/**
+ * How a drag reached the page: through mouse events alone, or, once the press and the first moves began an HTML drag
+ * (`draggable`, `dragstart`), through the browser's drag events, which carry the drag's `dataTransfer` to the drop.
+ */
+export type DragThrough = 'mouse' | 'drag-events';
+export declare const dragThroughSchema: Schema<DragThrough>;
+/** A drag as commands and events carry it: the element it drops on, and the positions the test asked for, when it did. */
+type DragCall = {
+    readonly target: LocatorRecipe;
+    readonly steps?: number | undefined;
+};
+/**
+ * A `dragTo` as its action's event records it: the element it drops on, the positions the test asked for when it did,
+ * and, once it dropped, how it reached the page.
+ */
+export type DragRecord = {
+    target: LocatorRecipe;
+    steps?: number;
+    through?: DragThrough;
+};
+export declare const dragRecordSchema: Schema<DragRecord>;
+/**
+ * What the test process and the parent both refuse, as `usage`, in a drag: `steps` that is not a whole number from 1
+ * to `maxDragSteps`.
+ *
+ * @example dragProblem({ steps: 0 })?.message // 'dragTo() takes steps as a whole number from 1 to 100, received 0.'
+ */
+export declare function dragProblem({ steps }: {
+    readonly steps?: number | undefined;
+}): Failure | undefined;
+/**
+ * The arguments of a drag as a test writes them: the target's locator, and `steps` when the test gave it.
+ *
+ * @example describeDragArguments({ target: { by: 'testId', value: 'done' }, steps: 10 }) // "getByTestId('done'), { steps: 10 }"
+ */
+export declare function describeDragArguments({ target, steps }: DragCall): string;
+export {};
+//# sourceMappingURL=drag.d.ts.map

package/dist/protocol/drag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag.d.ts","sourceRoot":"","sources":["../../src/protocol/drag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,OAAO,EAAK,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAE5C,iHAAiH;AACjH,eAAO,MAAM,gBAAgB,IAAI,CAAA;AAEjC,wGAAwG;AACxG,eAAO,MAAM,YAAY,MAAM,CAAA;AAE/B;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,aAAa,CAAA;AAEjD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,WAAW,CAAoC,CAAA;AAEtF,0HAA0H;AAC1H,KAAK,QAAQ,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAEvF;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,WAAW,CAAA;CAAE,CAAA;AAEzF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAI9C,CAAA;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,OAAO,GAAG,SAAS,CAGnG;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,GAAG,MAAM,CAEzE"}

package/dist/protocol/drag.js

@@ -0,0 +1,31 @@
+import { describeLocator, locatorRecipeSchema } from "./locator.js";
+import { s } from "./schema.js";
+/** How many positions a drag moves the mouse through on its way to the target when the test gives no `steps`. */
+export const defaultDragSteps = 5;
+/** The most positions a test may ask a drag to move through. Each one waits for a frame of the page. */
+export const maxDragSteps = 100;
+export const dragThroughSchema = s.enum(['mouse', 'drag-events']);
+export const dragRecordSchema = s.object({
+    target: locatorRecipeSchema,
+    steps: s.optional(s.number({ integer: true, min: 1 })),
+    through: s.optional(dragThroughSchema),
+});
+/**
+ * What the test process and the parent both refuse, as `usage`, in a drag: `steps` that is not a whole number from 1
+ * to `maxDragSteps`.
+ *
+ * @example dragProblem({ steps: 0 })?.message // 'dragTo() takes steps as a whole number from 1 to 100, received 0.'
+ */
+export function dragProblem({ steps }) {
+    if (steps === undefined || (Number.isInteger(steps) && steps >= 1 && steps <= maxDragSteps))
+        return undefined;
+    return { class: 'usage', message: `dragTo() takes steps as a whole number from 1 to ${maxDragSteps}, received ${String(steps)}.`, details: { inputSent: false } };
+}
+/**
+ * The arguments of a drag as a test writes them: the target's locator, and `steps` when the test gave it.
+ *
+ * @example describeDragArguments({ target: { by: 'testId', value: 'done' }, steps: 10 }) // "getByTestId('done'), { steps: 10 }"
+ */
+export function describeDragArguments({ target, steps }) {
+    return `${describeLocator(target)}${steps === undefined ? '' : `, { steps: ${steps} }`}`;
+}

package/dist/protocol/events.d.ts

@@ -2,19 +2,25 @@ import type { CaptureReference } from './evidence.ts';
 import type { NativeExecutionRecord } from './execution.ts';
 import { type ActionKind } from './commands.ts';
 import { type DiagnosticLimits, type DiagnosticScope, type DiagnosticsPolicyRecord, type DiagnosticsSummary } from './diagnostics.ts';
+import { type DialogType } from './dialogs.ts';
+import { type DragRecord } from './drag.ts';
 import { type Emulation } from './emulation.ts';
 import { type EvaluationRecord, type HostEvaluationRecord } from './evaluation.ts';
 import { type BundleRecord, type CleanupRecord, type Ending, type ExecutionRecord, type PreparationRecord, type RequirementCheck } from './execution.ts';
 import { type Failure, type SourceLocation, type TruncatedText } from './failures.ts';
+import { type FileRecord } from './files.ts';
 import { type HostCheckActual, type HostCheckRecord } from './host-check.ts';
 import { type CaptureSourceName } from './identity.ts';
+import { type LayoutRecord } from './layout-checks.ts';
 import { type CheckRecord } from './locator-checks.ts';
 import { type LocatorRecipe } from './locator.ts';
 import { type ObservedRecord } from './observation-record.ts';
 import { type OptionChoiceRecord } from './option-choices.ts';
 import { type NavigationCause, type NavigationDocument } from './page-facts.ts';
 import { type EvidenceStatus, type LeftoverRecord, type MediaStartedRecord, type RecordingRecord, type RunEvidenceStatus } from './recording.ts';
+import { type RouteAnswerSummary } from './routes.ts';
 import { type Schema } from './schema.ts';
+import { type Attachment, type ScreenshotRecord } from './screenshot.ts';
 import { type Timeouts } from './timeouts.ts';
 import { type Variant } from './variant.ts';
 /**
@@ -152,9 +158,14 @@ type ActionFields = StepScope & {
     pageTitle?: string;
     durationMs: number;
     location?: SourceLocation;
-    /** The length of the text a `fill` typed. A secret fill names its secret instead. */
+    /**
+     * The length of the text a `fill` typed. A secret fill names its secret instead, and a fill of an inbox's code names
+     * `code`; a `goto` to an inbox's link names the link, `link` or `link:2`, as it prints.
+     */
     valueLength?: number;
     secret?: string;
+    /** The inbox a `fill` took its code from, or a `goto` its link. */
+    inbox?: string;
     /** The key a `press` sent, as the test wrote it. */
     key?: string;
     /** The options a `select` chose, as the test named them. */
@@ -180,6 +191,15 @@ type ActionFields = StepScope & {
     operation?: 'wait' | 'dismiss' | 'dismissFirstRunCard' | 'accept';
     /** The label of the button a native alert call pressed, as the test wrote it. */
     button?: string;
+    /** The files a `setInputFiles` or a file picker's `setFiles` gave the input, as its `change` carried them. */
+    files?: FileRecord[];
+    /**
+     * A `dragTo`'s target, the positions the test asked for when it did, and, once it dropped, whether it reached the page
+     * through mouse events alone or through the browser's drag events.
+     */
+    drag?: DragRecord;
+    /** What the input held once the page's own listeners ran, when that differs from `files`, as when a page clears it. */
+    kept?: FileRecord[];
     /**
      * For a call that gave itself `{ timeout }`: in `callTimeoutMs` what it asked for, and in `timeoutMs` the time the
      * parent gave the command, the smallest of that, the action or navigation budget and the test's time left. Both
@@ -220,6 +240,18 @@ type AssertionFields = TestScope & {
      * names no look, the session of the app it judged it on. A value assertion has none.
      */
     sessionId?: string;
+    /**
+     * What the look a layout assertion rested on measured, as the parent judged it, with the viewport's size. Absent on
+     * every other assertion.
+     */
+    layout?: LayoutRecord;
+    /**
+     * What the picture a screenshot assertion rested on showed against its baseline, as the parent judged it. Absent on
+     * every other assertion.
+     */
+    screenshot?: ScreenshotRecord;
+    /** Files the parent left in the run folder for the assertion, such as a failed screenshot comparison's pictures. */
+    attachments?: Attachment[];
     /** From `expect.soft`: the test went on after it failed. */
     soft?: true;
 };
@@ -749,6 +781,126 @@ export type EventBody = (Common & VariantScope & (StepEvent | AssertionEvent)) |
  | (StepScope & {
     type: 'evaluation.finished';
     evaluation: EvaluationRecord;
+})
+/**
+ * A screenshot's baseline a run with `--update-screenshots` wrote, from the picture an assertion settled on. Always
+ * the parent's. `path` is the baseline's, POSIX and relative to the project's root; `replaced` says a baseline was
+ * there before. `observationId` names the look whose picture it is, and `session` the app whose page it shows.
+ */
+ | (StepScope & {
+    type: 'baseline.written';
+    sessionId: string;
+    observationId: string;
+    name: string;
+    path: string;
+    width: number;
+    height: number;
+    scale?: number;
+    replaced: boolean;
+    location?: SourceLocation;
+})
+/**
+ * A test's read of an inbox, once it ended. Always the parent's. `messages` is how many the mailbox held on the last
+ * look, `looks` how many times Retest asked it, none for a read refused before it asked, and `waitedMs` how long the
+ * read took. `wanted` is the subject the
+ * test asked for, a `RegExp` written `/source/flags`. A read that found a message records its `subject`, when it
+ * arrived and how many codes and links it holds, each code and each link that carries a token in the subject
+ * replaced by its placeholder; a read that found none records why in `failure`.
+ */
+ | (StepScope & {
+    type: 'inbox.read';
+    inbox: string;
+    messages: number;
+    looks: number;
+    waitedMs: number;
+    wanted?: string;
+    subject?: string;
+    receivedAt?: string;
+    codes?: number;
+    links?: number;
+    location?: SourceLocation;
+    failure?: Failure;
+})
+/**
+ * A JavaScript dialog an app's page opened, once it closed. Always the parent's. `dialog` is its kind and `message`
+ * its text, with every value the run hides replaced, cut to 300 code units. `answer` says whether it was accepted or
+ * dismissed, and `by` who answered it: the test, through `dialog.accept()` or `dialog.dismiss()`, or Retest, which
+ * answers a dialog nothing waited for and one the test left open when it ended. `typed` is how many characters a
+ * prompt was given. `location` names the call that answered it.
+ */
+ | (StepScope & {
+    type: 'dialog';
+    sessionId: string;
+    dialog: DialogType;
+    message: string;
+    answer: 'accepted' | 'dismissed';
+    by: 'test' | 'retest';
+    typed?: number;
+    location?: SourceLocation;
+})
+/**
+ * A page an app's page opened, once a `page.popup()` was given it. Always the parent's. `session` and `sessionId` name
+ * the page that opened it; `popup` is the app name its own commands and events go by, and `popupSessionId` its
+ * session. `url` is the first address it opened, its origin and path, and `title` that page's title. `location`
+ * names the `page.popup()` call.
+ */
+ | (StepScope & {
+    type: 'popup.opened';
+    sessionId: string;
+    popup: string;
+    popupSessionId: string;
+    url: string;
+    title?: string;
+    location?: SourceLocation;
+})
+/** A page a test was given by `page.popup()` that closed while the test ran, without the test closing it. `session` names it. */
+ | (StepScope & {
+    type: 'popup.closed';
+    sessionId: string;
+})
+/**
+ * A download its app's browser context made, once it ended or its test did. Always the parent's. `suggestedFilename`
+ * is the name the browser suggested and `url` the address it came from, its origin and path, each with every secret
+ * replaced. `startedIn` says where it began when that was not the app's page or a frame inside it: `popup`, a page
+ * it opened, or `other`, another page of its context. A `completed` download names its file in the run folder in
+ * `path`, with its size in bytes in `size`; a `withheld` one held the value of a secret, so its file was removed,
+ * and `failure` says so; a `canceled` one says how many bytes arrived of how many, and why in `failure`; an
+ * `unfinished` one was still on its way when its test ended. `awaited` marks one a `page.download()` waited for,
+ * and `location` names that call.
+ */
+ | (StepScope & {
+    type: 'download';
+    sessionId: string;
+    suggestedFilename: string;
+    url: string;
+    startedIn?: 'popup' | 'other';
+    state: 'completed' | 'withheld' | 'canceled' | 'unfinished';
+    path?: string;
+    size?: number;
+    receivedBytes?: number;
+    totalBytes?: number;
+    awaited?: true;
+    location?: SourceLocation;
+    failure?: Failure;
+})
+/**
+ * A change to an app's routes, once its page held it or refused it, or an answer of a route that Chrome refused.
+ * Always the parent's. `operation` is `add`, `remove` or `answer`, and `pattern` the route's pattern as the test
+ * wrote it, with every secret replaced, then cut to the message limit. An added route records its `answer`: its
+ * status, content type, header names and body size, or the error it refuses requests with. A removal records how
+ * many routes went in `removed`. An `answer` names the request in `url`, its origin and path, which Retest failed
+ * in its place. `failure` says why nothing changed or what Chrome refused, and `location` names the call.
+ */
+ | (StepScope & {
+    type: 'route';
+    sessionId: string;
+    operation: 'add' | 'remove' | 'answer';
+    pattern: string;
+    url?: string;
+    answer?: RouteAnswerSummary;
+    removed?: number;
+    location?: SourceLocation;
+    failure?: Failure;
 }) | (AttemptScope & {
     type: 'test.finished';
     status: TestStatus;