ptywright 0.4.0 → 0.6.0

package/dist/{runner-zApMYWZx.mjs → runner-BHXXwxYp.mjs}

@@ -1,11 +1,13 @@
-import { a as applyTextMaskRules, c as encodeSgrMouse, d as isDefaultStyle, f as styleKey, i as fnv1a32, l as extractStyle, n as TraceRecorder, o as snapshotGrid, p as encodeKey, r as sleep, s as snapshotLines, t as TerminalSession, u as findMeaningfulEndCol } from "./terminal_session-DopC7Xg6.mjs";
+import { n as mergeProcessEnv, o as relativeHref, t as envTruthy } from "./env-DPYHo-zH.mjs";
+import { a as styleKey, i as isDefaultStyle, n as extractStyle, r as findMeaningfulEndCol } from "./style-BtIUv5H0.mjs";
+import { a as fnv1a32, c as encodeSgrMouse, i as TraceRecorder, l as encodeKey, n as sleep, o as snapshotGrid, r as applyTextMaskRules, s as snapshotLines, t as TerminalSession } from "./terminal_session-MX_vWpRG.mjs";
 import { createRequire } from "node:module";
+import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, dirname, extname, isAbsolute, join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
 import { z } from "zod";
-import { spawn } from "bun-pty";
 import { Terminal } from "@xterm/headless";
-import { basename, dirname, extname, isAbsolute, join, relative, resolve } from "node:path";
-import { pathToFileURL } from "node:url";
-import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { spawn } from "bun-pty";
 //#region src/pty/bun_pty_adapter.ts
 function toForkOptions(options) {
 	return {
@@ -176,7 +178,7 @@ var SessionManager = class {
 		const rows = clampInt$2(args.rows ?? 24, 1, 300);
 		const cwd = args.cwd ?? process.cwd();
 		const term = args.env?.TERM ?? args.name ?? "xterm-256color";
-		const env = mergeEnv({
+		const env = mergeProcessEnv({
 			TERM: term,
 			COLORTERM: "truecolor"
 		}, args.env);
@@ -226,13 +228,6 @@ function clampInt$2(value, min, max) {
 	if (int > max) return max;
 	return int;
 }
-function mergeEnv(base, override) {
-	const env = {};
-	for (const [k, v] of Object.entries(process.env)) if (typeof v === "string") env[k] = v;
-	for (const [k, v] of Object.entries(base)) env[k] = v;
-	if (override) for (const [k, v] of Object.entries(override)) env[k] = v;
-	return env;
-}
 function pickTraceEnv(env) {
 	const picked = {};
 	for (const key of [
@@ -247,6 +242,232 @@ function pickTraceEnv(env) {
 	return picked;
 }
 //#endregion
+//#region src/script/text_mask_schema.ts
+const textMaskRuleSchema = z.object({
+	regex: z.string().min(1),
+	flags: z.string().optional(),
+	replacement: z.string().optional(),
+	preserveLength: z.boolean().optional()
+});
+const assertionScriptStepSchemas = [
+	z.object({
+		type: z.literal("expectMeta"),
+		bufferType: z.enum(["normal", "alternate"]).optional(),
+		cols: z.number().int().positive().optional(),
+		rows: z.number().int().positive().optional(),
+		cursor: z.object({
+			x: z.number().int().positive(),
+			y: z.number().int().positive()
+		}).optional()
+	}).superRefine((value, ctx) => {
+		if (value.bufferType === void 0 && value.cols === void 0 && value.rows === void 0 && value.cursor === void 0) ctx.addIssue({
+			code: z.ZodIssueCode.custom,
+			message: "expectMeta requires at least one assertion (bufferType/cols/rows/cursor)"
+		});
+	}),
+	z.object({
+		type: z.literal("snapshot"),
+		kind: z.enum([
+			"text",
+			"view",
+			"ansi",
+			"view_ansi",
+			"grid"
+		]),
+		scope: z.enum(["visible", "buffer"]).optional(),
+		trimRight: z.boolean().optional(),
+		trimBottom: z.boolean().optional(),
+		maxLines: z.number().int().positive().optional(),
+		tailLines: z.number().int().positive().optional(),
+		lineNumbers: z.boolean().optional(),
+		includeStyles: z.boolean().optional(),
+		mask: z.array(textMaskRuleSchema).optional(),
+		saveAs: z.string().optional(),
+		saveTo: z.string().optional()
+	}).superRefine((value, ctx) => {
+		if (value.maxLines !== void 0 && value.tailLines !== void 0) ctx.addIssue({
+			code: z.ZodIssueCode.custom,
+			message: "snapshot: maxLines and tailLines are mutually exclusive"
+		});
+	}),
+	z.object({
+		type: z.literal("expect"),
+		from: z.string().optional(),
+		equals: z.string().optional(),
+		contains: z.array(z.string()).optional(),
+		notContains: z.array(z.string()).optional(),
+		regex: z.string().optional()
+	}).superRefine((value, ctx) => {
+		if (value.equals === void 0 && !value.contains?.length && !value.notContains?.length && !value.regex) ctx.addIssue({
+			code: z.ZodIssueCode.custom,
+			message: "expect requires at least one matcher (equals/contains/notContains/regex)"
+		});
+	}),
+	z.object({
+		type: z.literal("expectGolden"),
+		from: z.string().optional(),
+		path: z.string().min(1)
+	}),
+	z.object({
+		type: z.literal("custom"),
+		name: z.string().min(1),
+		payload: z.unknown().optional()
+	}),
+	z.object({
+		type: z.literal("assert"),
+		scope: z.enum(["visible", "buffer"]).optional(),
+		text: z.string().optional(),
+		regex: z.string().optional(),
+		description: z.string().optional()
+	}).superRefine((value, ctx) => {
+		if (!value.text && !value.regex) ctx.addIssue({
+			code: z.ZodIssueCode.custom,
+			message: "assert requires text or regex"
+		});
+	}),
+	z.object({
+		type: z.literal("assertSemantic"),
+		prompt: z.string().min(1),
+		description: z.string().optional()
+	})
+];
+const inputScriptStepSchemas = [
+	z.object({
+		type: z.literal("sendText"),
+		text: z.string(),
+		enter: z.boolean().optional()
+	}),
+	z.object({
+		type: z.literal("pressKey"),
+		key: z.string().min(1)
+	}),
+	z.object({
+		type: z.literal("sendMouse"),
+		action: z.enum([
+			"down",
+			"up",
+			"move",
+			"click",
+			"scroll_up",
+			"scroll_down"
+		]),
+		x: z.number().int(),
+		y: z.number().int(),
+		button: z.enum([
+			"left",
+			"middle",
+			"right"
+		]).optional(),
+		shift: z.boolean().optional(),
+		alt: z.boolean().optional(),
+		ctrl: z.boolean().optional()
+	}),
+	z.object({
+		type: z.literal("resize"),
+		cols: z.number().int().positive(),
+		rows: z.number().int().positive()
+	}),
+	z.object({
+		type: z.literal("mark"),
+		label: z.string().optional()
+	}),
+	z.object({
+		type: z.literal("sleep"),
+		ms: z.number().int().nonnegative()
+	})
+];
+const waitScriptStepSchemas = [
+	z.object({
+		type: z.literal("waitForText"),
+		scope: z.enum(["visible", "buffer"]).optional(),
+		text: z.string().optional(),
+		regex: z.string().optional(),
+		timeoutMs: z.number().int().positive().optional(),
+		intervalMs: z.number().int().positive().optional()
+	}).superRefine((value, ctx) => {
+		if (!value.text && !value.regex) ctx.addIssue({
+			code: z.ZodIssueCode.custom,
+			message: "waitForText requires text or regex"
+		});
+	}),
+	z.object({
+		type: z.literal("waitForStableScreen"),
+		timeoutMs: z.number().int().positive().optional(),
+		quietMs: z.number().int().positive().optional(),
+		intervalMs: z.number().int().positive().optional()
+	}),
+	z.object({
+		type: z.literal("waitForExit"),
+		timeoutMs: z.number().int().positive().optional(),
+		intervalMs: z.number().int().positive().optional(),
+		exitCode: z.number().int().optional(),
+		signal: z.union([z.number().int(), z.string()]).optional()
+	})
+];
+//#endregion
+//#region src/script/step_schemas.ts
+const scriptStepSchema = z.union([
+	...inputScriptStepSchemas,
+	...waitScriptStepSchemas,
+	...assertionScriptStepSchemas
+]);
+//#endregion
+//#region src/script/schema.ts
+const launchConfigSchema = z.object({
+	backend: z.enum([
+		"pty",
+		"frames",
+		"ink",
+		"ratatui"
+	]).optional(),
+	command: z.string().min(1).optional(),
+	args: z.array(z.string()).optional(),
+	cwd: z.string().optional(),
+	env: z.record(z.string()).optional(),
+	cols: z.number().int().positive().optional(),
+	rows: z.number().int().positive().optional(),
+	name: z.string().optional(),
+	frame: z.string().optional(),
+	frames: z.array(z.union([z.string(), z.object({
+		name: z.string().optional(),
+		text: z.string().optional(),
+		frame: z.string().optional(),
+		snapshot: z.string().optional(),
+		lastFrame: z.string().optional()
+	})])).optional(),
+	framePath: z.string().optional(),
+	frameModule: z.string().optional(),
+	advanceOnInput: z.boolean().optional()
+}).superRefine((value, ctx) => {
+	if ((value.backend ?? "pty") === "pty") {
+		if (!value.command) ctx.addIssue({
+			code: z.ZodIssueCode.custom,
+			path: ["command"],
+			message: "launch.command is required when backend=pty"
+		});
+		return;
+	}
+	if (!value.frame && !value.frames?.length && !value.framePath && !value.frameModule) ctx.addIssue({
+		code: z.ZodIssueCode.custom,
+		message: "framework launch requires one of frame, frames, framePath, or frameModule when backend is not pty"
+	});
+});
+const scriptTraceSchema = z.object({
+	saveCast: z.boolean().optional(),
+	saveReport: z.boolean().optional(),
+	castPath: z.string().optional(),
+	reportPath: z.string().optional(),
+	reportScope: z.enum(["visible", "buffer"]).optional(),
+	reportMaxFrames: z.number().int().positive().optional()
+});
+const scriptSchema = z.object({
+	name: z.string().optional(),
+	artifactsDir: z.string().optional(),
+	launch: launchConfigSchema,
+	trace: scriptTraceSchema.optional(),
+	steps: z.array(scriptStepSchema).min(1)
+});
+//#endregion
 //#region src/terminal/view.ts
 function formatSnapshotView(options) {
 	const lineNumbers = options.lineNumbers ?? true;
@@ -307,233 +528,226 @@ function ensureAsciinemaPlayerAssets(reportPath) {
 	}
 }
 //#endregion
-//#region src/trace/report.ts
-async function generateTraceReportHtml(cast, options) {
-	const parsed = parseAsciicast(cast);
-	const termInfo = getTermInfo(parsed.header);
-	const terminal = new Terminal({
-		cols: termInfo.cols,
-		rows: termInfo.rows,
-		allowProposedApi: true,
-		scrollback: 2e3,
-		convertEol: true
-	});
-	const scope = options?.scope ?? "visible";
-	const maxFrames = options?.maxFrames ?? 200;
-	const scriptName = options?.scriptName?.trim() ? options.scriptName.trim() : "";
-	const result = options?.result;
-	const artifacts = options?.artifacts;
-	const steps = options?.steps;
-	let writeChain = Promise.resolve();
-	const frames = [];
-	let previousRowSignatures = null;
-	const capture = (args) => {
-		if (frames.length >= maxFrames) return;
-		let viewHtml;
-		let changedCount;
-		if (args.overrideViewText) {
-			const parsedView = parseSnapshotViewText(args.overrideViewText.text);
-			const headerLine = parsedView.headerLine ?? (args.overrideViewText.hash?.trim() ? `hash=${args.overrideViewText.hash.trim()}` : "snapshot");
-			const rowSignatures = parsedView.rows.map((r) => r.text);
-			const changedLines = diffLineIndices(previousRowSignatures ?? [], rowSignatures);
-			previousRowSignatures = rowSignatures;
-			changedCount = changedLines.size;
-			viewHtml = renderSnapshotViewTextHtml({
-				headerLine,
-				rows: parsedView.rows,
-				changedLines
-			});
-		} else {
-			let lines;
-			let hash;
-			let changedLines = /* @__PURE__ */ new Set();
-			if (scope === "visible") {
-				const grid = snapshotGrid(terminal, {
-					trimRight: true,
-					includeStyles: true
-				});
-				lines = grid.lines;
-				hash = fnv1a32(JSON.stringify(grid));
-				const rowSignatures = lines.map((line, idx) => {
-					const runs = grid.styleRuns?.[idx] ?? [];
-					if (line === "" && runs.length === 0) return "";
-					return `${line}\n${JSON.stringify(runs)}`;
-				});
-				changedLines = diffLineIndices(previousRowSignatures ?? [], rowSignatures);
-				previousRowSignatures = rowSignatures;
-			} else {
-				lines = snapshotLines(terminal, {
-					scope,
-					trimRight: true
-				});
-				hash = fnv1a32(lines.join("\n"));
-			}
-			changedCount = changedLines.size;
-			viewHtml = renderSnapshotViewHtml({
-				terminal,
-				sessionId: "replay",
-				scope,
-				hash,
-				lines,
-				meta: getMeta(terminal),
-				lineNumbers: true,
-				changedLines,
-				trimRight: true
-			});
-		}
-		const previousFrame = frames.at(-1);
-		frames.push({
-			id: `frame-${frames.length + 1}`,
-			atSeconds: args.atSeconds,
-			kind: args.kind,
-			label: args.label,
-			markLabel: args.markLabel,
-			viewHtml,
-			changedCount,
-			stepInfo: args.stepInfo,
-			previousViewHtml: previousFrame?.viewHtml
-		});
-	};
-	if (steps && steps.length > 0) for (let i = 0; i < steps.length; i += 1) {
-		const stepRec = steps[i];
-		if (!stepRec) continue;
-		const stepLabel = formatStepLabel$1(stepRec.step);
-		const viewText = stepRec.after?.text ?? "";
-		const displayIndex = (typeof stepRec.index === "number" ? stepRec.index : i) + 1;
-		const stepType = stepRec.step.type;
-		const kind = stepType === "mark" ? "mark" : stepType === "resize" ? "resize" : "step";
-		const markLabel = kind === "mark" && typeof stepRec.step.label === "string" ? String(stepRec.step.label) : void 0;
-		const stepParams = {};
-		for (const [key, value] of Object.entries(stepRec.step)) if (key !== "type") stepParams[key] = value;
-		capture({
-			atSeconds: displayIndex,
-			kind,
-			label: stepLabel,
-			markLabel,
-			stepInfo: {
-				index: displayIndex,
-				type: stepType,
-				ok: stepRec.ok,
-				error: stepRec.error,
-				params: Object.keys(stepParams).length > 0 ? stepParams : void 0,
-				durationMs: typeof stepRec.durationMs === "number" ? stepRec.durationMs : void 0
-			},
-			overrideViewText: {
-				text: viewText,
-				hash: stepRec.after?.hash
-			}
-		});
-		if (frames.length >= maxFrames) break;
-	}
-	else {
-		for (const event of parsed.events) {
-			const [time, type, data] = event;
-			if (type === "o") writeChain = writeChain.then(() => writeTerminal(terminal, data));
-			else if (type === "r") writeChain.then(() => {
-				const resized = parseResize(data);
-				if (resized) terminal.resize(resized.cols, resized.rows);
-				capture({
-					atSeconds: time,
-					kind: "resize",
-					label: `resize ${data}`
-				});
-			});
-			else if (type === "m") writeChain.then(() => {
-				const markLabel = (data ?? "").trim();
-				capture({
-					atSeconds: time,
-					kind: "mark",
-					label: markLabel ? `mark ${markLabel}` : "mark",
-					markLabel
-				});
-			});
-		}
-		await writeChain;
-		capture({
-			atSeconds: parsed.events.at(-1)?.[0] ?? 0,
-			kind: "final",
-			label: "final"
-		});
+//#region src/trace/asciicast_parse.ts
+function parseAsciicast(cast) {
+	const lines = cast.trimEnd().split("\n");
+	const header = safeJsonObject(lines[0]);
+	const events = [];
+	for (const line of lines.slice(1)) {
+		if (!line.trim()) continue;
+		const value = JSON.parse(line);
+		if (!Array.isArray(value) || value.length < 3) continue;
+		const time = Number(value[0]);
+		const type = String(value[1]);
+		const data = String(value[2]);
+		if (!Number.isFinite(time)) continue;
+		if (type === "o" || type === "i" || type === "r" || type === "m") events.push([
+			time,
+			type,
+			data
+		]);
 	}
-	terminal.dispose();
-	return renderHtml({
-		cast,
-		header: parsed.header,
-		term: termInfo,
-		scope,
-		scriptName,
-		result,
-		artifacts,
-		frames,
-		eventCount: parsed.events.length
-	});
+	return {
+		header,
+		events
+	};
 }
-function formatStepLabel$1(step) {
-	const showText = envTruthy$1(process.env.PTYWRIGHT_REPORT_SHOW_STEP_TEXT);
-	if (step.type === "custom" && typeof step.name === "string") return `custom(${step.name})`;
-	if (step.type === "sendText") {
-		const enter = typeof step.enter === "boolean" ? step.enter : void 0;
-		const enterSuffix = enter !== void 0 ? `enter=${enter}` : "";
-		const description = typeof step.description === "string" ? step.description : "";
-		const text = typeof step.text === "string" ? step.text : description;
-		if (!text) return enterSuffix ? `sendText (${enterSuffix})` : "sendText";
-		if (!showText) return `sendText <redacted> (len=${text.length}${enterSuffix ? `, ${enterSuffix}` : ""})`;
-		return `sendText "${truncateInline$1(text)}"${enterSuffix ? ` (${enterSuffix})` : ""}`;
-	}
-	if (step.type === "waitForText") {
-		const text = typeof step.text === "string" ? step.text : void 0;
-		const regex = typeof step.regex === "string" ? step.regex : void 0;
-		const description = typeof step.description === "string" ? step.description : void 0;
-		if (!showText) {
-			if (text) return "waitForText (text)";
-			if (regex) return "waitForText (regex)";
-			return "waitForText";
-		}
-		if (text) return `waitFor "${truncateInline$1(text)}"`;
-		if (regex) return `waitFor /${truncateInline$1(regex)}/`;
-		if (description) return `waitForText "${truncateInline$1(description)}"`;
-		return "waitForText";
-	}
-	if (step.type === "assert") {
-		const text = typeof step.text === "string" ? step.text : void 0;
-		const regex = typeof step.regex === "string" ? step.regex : void 0;
-		const description = typeof step.description === "string" ? step.description : void 0;
-		if (!showText) {
-			if (text) return "assert (text)";
-			if (regex) return "assert (regex)";
-			return "assert";
-		}
-		if (text) return `assert "${truncateInline$1(text)}"`;
-		if (regex) return `assert /${truncateInline$1(regex)}/`;
-		if (description) return `assert "${truncateInline$1(description)}"`;
-		return "assert";
-	}
-	if (step.type === "pressKey" && typeof step.key === "string") return `pressKey ${step.key}`;
-	if (step.type === "mark") {
-		const label = typeof step.label === "string" ? step.label.trim() : "";
-		return label ? `mark ${label}` : "mark";
+function safeJsonObject(line) {
+	if (!line) return {};
+	try {
+		const value = JSON.parse(line);
+		return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+	} catch {
+		return {};
 	}
-	if (step.type === "resize") {
-		const cols = typeof step.cols === "number" ? step.cols : void 0;
-		const rows = typeof step.rows === "number" ? step.rows : void 0;
-		if (cols !== void 0 && rows !== void 0) return `resize ${cols}x${rows}`;
-		return "resize";
+}
+//#endregion
+//#region src/trace/report_cli.ts
+async function runTraceReportCli(argv, generateTraceReportHtml) {
+	const inputPath = argv[0];
+	if (!inputPath) {
+		console.error("Usage: bun run src/trace/report.ts <path/to/cast>");
+		process.exit(2);
 	}
-	return step.type;
+	const html = await generateTraceReportHtml(await Bun.file(inputPath).text());
+	const outPath = join(dirname(inputPath), `${basename(inputPath, extname(inputPath))}.report.html`);
+	writeFileSync(outPath, html);
+	ensureAsciinemaPlayerAssets(outPath);
+	console.log(outPath);
 }
-function truncateInline$1(text, maxChars = 60) {
-	const normalized = text.replace(/\r\n/g, "\n").replace(/\r/g, "\n").replace(/\n/g, "\\n");
-	if (normalized.length <= maxChars) return normalized;
-	return `${normalized.slice(0, maxChars)}…(+${normalized.length - maxChars})`;
+//#endregion
+//#region src/common/html.ts
+function escapeHtml(text) {
+	return text.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
 }
-function envTruthy$1(value) {
-	if (!value?.trim()) return false;
-	const normalized = value.trim().toLowerCase();
-	return normalized === "1" || normalized === "true" || normalized === "yes" || normalized === "on";
+function jsonForHtml(data) {
+	return JSON.stringify(data).replaceAll("<", "\\u003c");
 }
-function stripAnsi(str) {
-	return str.replace(/\x1B\[[0-?]*[ -/]*[@-~]/g, "");
+function coerceDisplayString(value) {
+	if (value === null || value === void 0) return "";
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean") return String(value);
+	try {
+		return JSON.stringify(value) ?? "";
+	} catch {
+		return "";
+	}
+}
+//#endregion
+//#region src/trace/term_info.ts
+function getTermInfo(header) {
+	if (Number(header.version ?? 2) === 3) {
+		const term = header.term;
+		return {
+			cols: clampInt$1(Number(term?.cols ?? 80), 1, 500),
+			rows: clampInt$1(Number(term?.rows ?? 24), 1, 300),
+			type: typeof term?.type === "string" ? term.type : "xterm-256color"
+		};
+	}
+	return {
+		cols: clampInt$1(Number(header.width ?? 80), 1, 500),
+		rows: clampInt$1(Number(header.height ?? 24), 1, 300),
+		type: typeof header.term === "string" ? header.term : "xterm-256color"
+	};
+}
+function parseResize(value) {
+	const match = /^\s*(\d+)x(\d+)\s*$/.exec(value);
+	if (!match) return null;
+	return {
+		cols: clampInt$1(Number(match[1] ?? 0), 1, 500),
+		rows: clampInt$1(Number(match[2] ?? 0), 1, 300)
+	};
+}
+function clampInt$1(value, min, max) {
+	if (!Number.isFinite(value)) return min;
+	const int = Math.trunc(value);
+	if (int < min) return min;
+	if (int > max) return max;
+	return int;
+}
+//#endregion
+//#region src/trace/report_snapshot_styles.ts
+function renderVisibleRowHtml(terminal, rowIndex, trimRight) {
+	const buffer = terminal.buffer.active;
+	const nullCell = buffer.getNullCell();
+	const startY = buffer.viewportY;
+	const line = buffer.getLine(startY + rowIndex);
+	const endCol = trimRight ? findMeaningfulEndCol(line, terminal.cols, nullCell) : terminal.cols;
+	const segments = [];
+	let currentKey = null;
+	let currentStyle = null;
+	let currentText = "";
+	const flush = () => {
+		if (!currentStyle) return;
+		if (currentText.length === 0) return;
+		segments.push({
+			key: currentKey ?? styleKey(currentStyle),
+			style: currentStyle,
+			text: currentText
+		});
+		currentText = "";
+	};
+	for (let x = 0; x < endCol; x += 1) {
+		const cell = line?.getCell(x, nullCell);
+		if (!cell) {
+			if (currentStyle) {
+				flush();
+				currentStyle = null;
+				currentKey = null;
+			}
+			continue;
+		}
+		if (cell.getWidth() === 0) continue;
+		const chars = cell.getChars() || " ";
+		const style = extractStyle(cell);
+		const key = styleKey(style);
+		if (!currentStyle) {
+			currentStyle = style;
+			currentKey = key;
+			currentText = chars;
+			continue;
+		}
+		if (key === currentKey) {
+			currentText += chars;
+			continue;
+		}
+		flush();
+		currentStyle = style;
+		currentKey = key;
+		currentText = chars;
+	}
+	if (currentStyle) flush();
+	return segments.map((segment) => renderSegmentHtml(segment.text, segment.style)).join("");
+}
+function renderSegmentHtml(text, style) {
+	const safeText = escapeHtml(text);
+	if (isDefaultStyle(style)) return safeText;
+	const css = styleToCss(style);
+	if (!css) return `<span class="seg">${safeText}</span>`;
+	return `<span class="seg" style="${css}">${safeText}</span>`;
+}
+function styleToCss(style) {
+	let fg = colorToCss(style.fg);
+	let bg = colorToCss(style.bg);
+	if (style.inverse) {
+		const tmp = fg;
+		fg = bg;
+		bg = tmp;
+	}
+	const decls = [];
+	if (fg) decls.push(`color: ${fg}`);
+	if (bg) decls.push(`background-color: ${bg}`);
+	if (style.bold) decls.push("font-weight: 600");
+	if (style.italic) decls.push("font-style: italic");
+	if (style.dim) decls.push("opacity: 0.75");
+	const decorations = [];
+	if (style.underline) decorations.push("underline");
+	if (style.strikethrough) decorations.push("line-through");
+	if (decorations.length > 0) decls.push(`text-decoration: ${decorations.join(" ")}`);
+	return decls.join("; ");
+}
+function colorToCss(color) {
+	if (color.mode === "default") return null;
+	if (color.mode === "rgb") return `#${(color.value & 16777215).toString(16).padStart(6, "0")}`;
+	return xterm256Color(clampInt$1(color.value, 0, 255));
+}
+function xterm256Color(idx) {
+	const table16 = [
+		"#000000",
+		"#800000",
+		"#008000",
+		"#808000",
+		"#000080",
+		"#800080",
+		"#008080",
+		"#c0c0c0",
+		"#808080",
+		"#ff0000",
+		"#00ff00",
+		"#ffff00",
+		"#0000ff",
+		"#ff00ff",
+		"#00ffff",
+		"#ffffff"
+	];
+	if (idx < 16) return table16[idx] ?? "#000000";
+	if (idx >= 16 && idx <= 231) {
+		const c = [
+			0,
+			95,
+			135,
+			175,
+			215,
+			255
+		];
+		const n = idx - 16;
+		return `rgb(${c[Math.trunc(n / 36) % 6] ?? 0} ${c[Math.trunc(n / 6) % 6] ?? 0} ${c[n % 6] ?? 0})`;
+	}
+	const v = clampInt$1(8 + (idx - 232) * 10, 0, 255);
+	return `rgb(${v} ${v} ${v})`;
 }
+//#endregion
+//#region src/trace/report_snapshot_view.ts
 function parseSnapshotViewText(viewText) {
 	const lines = stripAnsi(viewText).replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n");
 	const first = lines[0] ?? "";
@@ -561,77 +775,373 @@ function renderSnapshotViewTextHtml(options) {
 	}
 	return out.join("");
 }
-async function writeTerminal(terminal, data) {
-	await new Promise((resolve) => {
-		terminal.write(data, resolve);
+function renderSnapshotViewHtml(options) {
+	const headerLine = formatHeaderLine({
+		sessionId: options.sessionId,
+		scope: options.scope,
+		hash: options.hash,
+		meta: options.meta,
+		changedCount: options.changedLines.size
 	});
+	const digits = Math.max(2, String(options.lines.length).length);
+	const out = [`<span class="headerblock">${escapeHtml(headerLine)}</span>`];
+	if (options.scope === "visible") {
+		for (let i = 0; i < options.lines.length; i += 1) {
+			const n = i + 1;
+			const prefix = options.lineNumbers ? `${String(n).padStart(digits, "0")}│ ` : "";
+			const prefixHtml = options.lineNumbers ? `<span class="ln">${escapeHtml(prefix)}</span>` : "";
+			const contentHtml = renderVisibleRowHtml(options.terminal, i, options.trimRight);
+			const rowClass = options.changedLines.has(i) ? "row changed" : "row";
+			out.push(`<span class="${rowClass}">${prefixHtml}${contentHtml}</span>`);
+		}
+		return out.join("");
+	}
+	for (let i = 0; i < options.lines.length; i += 1) {
+		const n = i + 1;
+		const prefix = options.lineNumbers ? `${String(n).padStart(digits, "0")}│ ` : "";
+		const prefixHtml = options.lineNumbers ? `<span class="ln">${escapeHtml(prefix)}</span>` : "";
+		out.push(`<span class="row">${prefixHtml}${escapeHtml(options.lines[i] ?? "")}</span>`);
+	}
+	return out.join("");
 }
-function renderHtml(input) {
-	const title = input.scriptName || coerceDisplayString(input.header.title) || "ptywright trace report";
-	const command = coerceDisplayString(input.header.command);
-	const timestamp = input.header.timestamp;
-	const headerJson = JSON.stringify(input.header, null, 2);
-	const durationSeconds = input.frames.at(-1)?.atSeconds ?? 0;
-	const markFrames = input.frames.filter((f) => f.kind === "mark");
-	const resultLabel = input.result?.ok === true ? "PASS" : input.result?.ok === false ? "FAIL" : "UNKNOWN";
-	const resultClass = input.result?.ok === true ? "pass" : input.result?.ok === false ? "fail" : "unknown";
-	const artifactsRows = [];
-	if (input.artifacts?.castHref?.trim()) artifactsRows.push({
-		label: "cast",
-		href: input.artifacts.castHref.trim()
-	});
-	if (input.artifacts?.failureErrorHref?.trim()) artifactsRows.push({
-		label: "failure.error.txt",
-		href: input.artifacts.failureErrorHref.trim()
-	});
-	if (input.artifacts?.failureStepHref?.trim()) artifactsRows.push({
-		label: "failure.step.json",
-		href: input.artifacts.failureStepHref.trim()
-	});
-	if (input.artifacts?.failureLastTextHref?.trim()) artifactsRows.push({
-		label: "failure.last.txt",
-		href: input.artifacts.failureLastTextHref.trim()
-	});
-	if (input.artifacts?.failureLastViewHref?.trim()) artifactsRows.push({
-		label: "failure.last.view.txt",
-		href: input.artifacts.failureLastViewHref.trim()
-	});
-	const artifactsHtml = artifactsRows.length === 0 ? `<p class="muted">No artifacts linked.</p>` : `<ul class="artifacts">
-${artifactsRows.map((a) => `<li><a href="${escapeHtml(a.href)}">${escapeHtml(a.label)}</a><span class="muted"> (${escapeHtml(a.href)})</span></li>`).join("\n")}
-</ul>`;
-	const castPlayerHtml = `
-        <p class="muted">Render the full recording using <span class="mono">asciinema-player</span>.</p>
-        <div class="cast-controls">
-          <button id="castToggleSize" class="badge chip" type="button">expand</button>
-          <span id="castPlayerStatus" class="muted mono"></span>
-        </div>
-        <div id="castPlayer" class="cast-player"></div>
-        <script id="castData" type="application/json">${jsonForHtml(input.cast)}<\/script>
-        <script>
-          (function () {
-            const statusEl = document.getElementById("castPlayerStatus");
-            const container = document.getElementById("castPlayer");
-            const castEl = document.getElementById("castData");
-            const toggleBtn = document.getElementById("castToggleSize");
-            if (!container || !castEl) return;
-
-            // Load external assets automatically (no extra click).
-            const VERSION = "3.9.0";
-            const LOCAL_CSS = "./asciinema-player.css";
-            const LOCAL_JS = "./asciinema-player.min.js";
-            // Use multiple CDNs to avoid regional blocks (e.g. jsdelivr).
-            const CDN_BASES = [
-              "https://cdn.jsdelivr.net/npm/asciinema-player@" + VERSION + "/dist/bundle/",
-              "https://unpkg.com/asciinema-player@" + VERSION + "/dist/bundle/",
-            ];
-            const CSS_URLS = [LOCAL_CSS, ...CDN_BASES.map((b) => b + "asciinema-player.css")];
-            const JS_URLS = [LOCAL_JS, ...CDN_BASES.map((b) => b + "asciinema-player.min.js")];
-
-            function setStatus(text) {
-              if (statusEl) statusEl.textContent = text ? " " + text : "";
-            }
-
-            async function loadCssOnce() {
+function diffLineIndices(previous, next) {
+	const out = /* @__PURE__ */ new Set();
+	const max = Math.max(previous.length, next.length);
+	for (let i = 0; i < max; i += 1) if ((previous[i] ?? "") !== (next[i] ?? "")) out.add(i);
+	return out;
+}
+function getTerminalMeta(terminal) {
+	const buffer = terminal.buffer.active;
+	return {
+		cols: terminal.cols,
+		rows: terminal.rows,
+		bufferType: buffer.type,
+		viewportY: buffer.viewportY,
+		baseY: buffer.baseY,
+		length: buffer.length,
+		cursorX: buffer.cursorX,
+		cursorY: buffer.cursorY
+	};
+}
+function stripAnsi(str) {
+	return str.replace(/\x1B\[[0-?]*[ -/]*[@-~]/g, "");
+}
+function formatHeaderLine(input) {
+	const cursorViewportRow = input.meta.baseY + input.meta.cursorY - input.meta.viewportY;
+	const cursorViewportCol = input.meta.cursorX;
+	return [
+		`session=${input.sessionId}`,
+		`scope=${input.scope}`,
+		`size=${input.meta.cols}x${input.meta.rows}`,
+		`buffer=${input.meta.bufferType}`,
+		`cursor=${cursorViewportCol + 1},${cursorViewportRow + 1}`,
+		`hash=${input.hash}`,
+		`changed=${input.changedCount}`
+	].join(" ");
+}
+//#endregion
+//#region src/trace/report_frame_capture.ts
+function createFrameCapture(args) {
+	let previousRowSignatures = null;
+	return (captureArgs) => {
+		if (args.frames.length >= args.maxFrames) return;
+		const view = captureArgs.overrideViewText ? renderOverrideView(captureArgs.overrideViewText, previousRowSignatures) : renderTerminalView(args.terminal, args.scope, previousRowSignatures);
+		previousRowSignatures = view.rowSignatures;
+		const previousFrame = args.frames.at(-1);
+		args.frames.push({
+			id: `frame-${args.frames.length + 1}`,
+			atSeconds: captureArgs.atSeconds,
+			kind: captureArgs.kind,
+			label: captureArgs.label,
+			markLabel: captureArgs.markLabel,
+			viewHtml: view.viewHtml,
+			changedCount: view.changedCount,
+			stepInfo: captureArgs.stepInfo,
+			previousViewHtml: previousFrame?.viewHtml
+		});
+	};
+}
+function renderOverrideView(overrideViewText, previousRowSignatures) {
+	const parsedView = parseSnapshotViewText(overrideViewText.text);
+	const headerLine = parsedView.headerLine ?? (overrideViewText.hash?.trim() ? `hash=${overrideViewText.hash.trim()}` : "snapshot");
+	const rowSignatures = parsedView.rows.map((row) => row.text);
+	const changedLines = diffLineIndices(previousRowSignatures ?? [], rowSignatures);
+	return {
+		rowSignatures,
+		changedCount: changedLines.size,
+		viewHtml: renderSnapshotViewTextHtml({
+			headerLine,
+			rows: parsedView.rows,
+			changedLines
+		})
+	};
+}
+function renderTerminalView(terminal, scope, previousRowSignatures) {
+	let lines;
+	let hash;
+	let changedLines = /* @__PURE__ */ new Set();
+	let rowSignatures;
+	if (scope === "visible") {
+		const grid = snapshotGrid(terminal, {
+			trimRight: true,
+			includeStyles: true
+		});
+		lines = grid.lines;
+		hash = fnv1a32(JSON.stringify(grid));
+		rowSignatures = lines.map((line, idx) => {
+			const runs = grid.styleRuns?.[idx] ?? [];
+			if (line === "" && runs.length === 0) return "";
+			return `${line}\n${JSON.stringify(runs)}`;
+		});
+		changedLines = diffLineIndices(previousRowSignatures ?? [], rowSignatures);
+	} else {
+		lines = snapshotLines(terminal, {
+			scope,
+			trimRight: true
+		});
+		hash = fnv1a32(lines.join("\n"));
+		rowSignatures = previousRowSignatures ?? [];
+	}
+	return {
+		rowSignatures,
+		changedCount: changedLines.size,
+		viewHtml: renderSnapshotViewHtml({
+			terminal,
+			sessionId: "replay",
+			scope,
+			hash,
+			lines,
+			meta: getTerminalMeta(terminal),
+			lineNumbers: true,
+			changedLines,
+			trimRight: true
+		})
+	};
+}
+//#endregion
+//#region src/trace/report_step_label.ts
+function formatStepLabel$1(step) {
+	const showText = envTruthy(process.env.PTYWRIGHT_REPORT_SHOW_STEP_TEXT);
+	if (step.type === "custom" && typeof step.name === "string") return `custom(${step.name})`;
+	if (step.type === "sendText") {
+		const enter = typeof step.enter === "boolean" ? step.enter : void 0;
+		const enterSuffix = enter !== void 0 ? `enter=${enter}` : "";
+		const description = typeof step.description === "string" ? step.description : "";
+		const text = typeof step.text === "string" ? step.text : description;
+		if (!text) return enterSuffix ? `sendText (${enterSuffix})` : "sendText";
+		if (!showText) return `sendText <redacted> (len=${text.length}${enterSuffix ? `, ${enterSuffix}` : ""})`;
+		return `sendText "${truncateInline$1(text)}"${enterSuffix ? ` (${enterSuffix})` : ""}`;
+	}
+	if (step.type === "waitForText") {
+		const text = typeof step.text === "string" ? step.text : void 0;
+		const regex = typeof step.regex === "string" ? step.regex : void 0;
+		const description = typeof step.description === "string" ? step.description : void 0;
+		if (!showText) {
+			if (text) return "waitForText (text)";
+			if (regex) return "waitForText (regex)";
+			return "waitForText";
+		}
+		if (text) return `waitFor "${truncateInline$1(text)}"`;
+		if (regex) return `waitFor /${truncateInline$1(regex)}/`;
+		if (description) return `waitForText "${truncateInline$1(description)}"`;
+		return "waitForText";
+	}
+	if (step.type === "assert") {
+		const text = typeof step.text === "string" ? step.text : void 0;
+		const regex = typeof step.regex === "string" ? step.regex : void 0;
+		const description = typeof step.description === "string" ? step.description : void 0;
+		if (!showText) {
+			if (text) return "assert (text)";
+			if (regex) return "assert (regex)";
+			return "assert";
+		}
+		if (text) return `assert "${truncateInline$1(text)}"`;
+		if (regex) return `assert /${truncateInline$1(regex)}/`;
+		if (description) return `assert "${truncateInline$1(description)}"`;
+		return "assert";
+	}
+	if (step.type === "pressKey" && typeof step.key === "string") return `pressKey ${step.key}`;
+	if (step.type === "mark") {
+		const label = typeof step.label === "string" ? step.label.trim() : "";
+		return label ? `mark ${label}` : "mark";
+	}
+	if (step.type === "resize") {
+		const cols = typeof step.cols === "number" ? step.cols : void 0;
+		const rows = typeof step.rows === "number" ? step.rows : void 0;
+		if (cols !== void 0 && rows !== void 0) return `resize ${cols}x${rows}`;
+		return "resize";
+	}
+	return step.type;
+}
+function truncateInline$1(text, maxChars = 60) {
+	const normalized = text.replace(/\r\n/g, "\n").replace(/\r/g, "\n").replace(/\n/g, "\\n");
+	if (normalized.length <= maxChars) return normalized;
+	return `${normalized.slice(0, maxChars)}…(+${normalized.length - maxChars})`;
+}
+//#endregion
+//#region src/trace/report_frames.ts
+async function buildTraceReportFrames(args) {
+	const terminal = new Terminal({
+		cols: args.term.cols,
+		rows: args.term.rows,
+		allowProposedApi: true,
+		scrollback: 2e3,
+		convertEol: true
+	});
+	const frames = [];
+	const capture = createFrameCapture({
+		terminal,
+		frames,
+		scope: args.scope,
+		maxFrames: args.maxFrames
+	});
+	const steps = args.steps;
+	if (steps && steps.length > 0) buildStepFrames(steps, frames, args.maxFrames, capture);
+	else await buildCastEventFrames(args.parsed, terminal, capture);
+	terminal.dispose();
+	return frames;
+}
+function buildStepFrames(steps, frames, maxFrames, capture) {
+	for (let i = 0; i < steps.length; i += 1) {
+		const stepRec = steps[i];
+		if (!stepRec) continue;
+		const stepLabel = formatStepLabel$1(stepRec.step);
+		const viewText = stepRec.after?.text ?? "";
+		const displayIndex = (typeof stepRec.index === "number" ? stepRec.index : i) + 1;
+		const stepType = stepRec.step.type;
+		const kind = stepType === "mark" ? "mark" : stepType === "resize" ? "resize" : "step";
+		const markLabel = kind === "mark" && typeof stepRec.step.label === "string" ? String(stepRec.step.label) : void 0;
+		const stepParams = collectStepParams(stepRec.step);
+		capture({
+			atSeconds: displayIndex,
+			kind,
+			label: stepLabel,
+			markLabel,
+			stepInfo: {
+				index: displayIndex,
+				type: stepType,
+				ok: stepRec.ok,
+				error: stepRec.error,
+				params: Object.keys(stepParams).length > 0 ? stepParams : void 0,
+				durationMs: typeof stepRec.durationMs === "number" ? stepRec.durationMs : void 0
+			},
+			overrideViewText: {
+				text: viewText,
+				hash: stepRec.after?.hash
+			}
+		});
+		if (frames.length >= maxFrames) break;
+	}
+}
+function collectStepParams(step) {
+	const stepParams = {};
+	for (const [key, value] of Object.entries(step)) if (key !== "type") stepParams[key] = value;
+	return stepParams;
+}
+async function buildCastEventFrames(parsed, terminal, capture) {
+	let writeChain = Promise.resolve();
+	for (const event of parsed.events) {
+		const [time, type, data] = event;
+		if (type === "o") writeChain = writeChain.then(() => writeTerminal(terminal, data));
+		else if (type === "r") writeChain.then(() => {
+			const resized = parseResize(data);
+			if (resized) terminal.resize(resized.cols, resized.rows);
+			capture({
+				atSeconds: time,
+				kind: "resize",
+				label: `resize ${data}`
+			});
+		});
+		else if (type === "m") writeChain.then(() => {
+			const markLabel = (data ?? "").trim();
+			capture({
+				atSeconds: time,
+				kind: "mark",
+				label: markLabel ? `mark ${markLabel}` : "mark",
+				markLabel
+			});
+		});
+	}
+	await writeChain;
+	capture({
+		atSeconds: parsed.events.at(-1)?.[0] ?? 0,
+		kind: "final",
+		label: "final"
+	});
+}
+async function writeTerminal(terminal, data) {
+	await new Promise((resolve) => {
+		terminal.write(data, resolve);
+	});
+}
+//#endregion
+//#region src/trace/report_html.ts
+function renderTraceReportHtml(input) {
+	const title = input.scriptName || coerceDisplayString(input.header.title) || "ptywright trace report";
+	const command = coerceDisplayString(input.header.command);
+	const timestamp = input.header.timestamp;
+	const headerJson = JSON.stringify(input.header, null, 2);
+	const durationSeconds = input.frames.at(-1)?.atSeconds ?? 0;
+	const markFrames = input.frames.filter((f) => f.kind === "mark");
+	const resultLabel = input.result?.ok === true ? "PASS" : input.result?.ok === false ? "FAIL" : "UNKNOWN";
+	const resultClass = input.result?.ok === true ? "pass" : input.result?.ok === false ? "fail" : "unknown";
+	const artifactsRows = [];
+	if (input.artifacts?.castHref?.trim()) artifactsRows.push({
+		label: "cast",
+		href: input.artifacts.castHref.trim()
+	});
+	if (input.artifacts?.failureErrorHref?.trim()) artifactsRows.push({
+		label: "failure.error.txt",
+		href: input.artifacts.failureErrorHref.trim()
+	});
+	if (input.artifacts?.failureStepHref?.trim()) artifactsRows.push({
+		label: "failure.step.json",
+		href: input.artifacts.failureStepHref.trim()
+	});
+	if (input.artifacts?.failureLastTextHref?.trim()) artifactsRows.push({
+		label: "failure.last.txt",
+		href: input.artifacts.failureLastTextHref.trim()
+	});
+	if (input.artifacts?.failureLastViewHref?.trim()) artifactsRows.push({
+		label: "failure.last.view.txt",
+		href: input.artifacts.failureLastViewHref.trim()
+	});
+	const artifactsHtml = artifactsRows.length === 0 ? `<p class="muted">No artifacts linked.</p>` : `<ul class="artifacts">
+${artifactsRows.map((a) => `<li><a href="${escapeHtml(a.href)}">${escapeHtml(a.label)}</a><span class="muted"> (${escapeHtml(a.href)})</span></li>`).join("\n")}
+</ul>`;
+	const castPlayerHtml = `
+        <p class="muted">Render the full recording using <span class="mono">asciinema-player</span>.</p>
+        <div class="cast-controls">
+          <button id="castToggleSize" class="badge chip" type="button">expand</button>
+          <span id="castPlayerStatus" class="muted mono"></span>
+        </div>
+        <div id="castPlayer" class="cast-player"></div>
+        <script id="castData" type="application/json">${jsonForHtml(input.cast)}<\/script>
+        <script>
+          (function () {
+            const statusEl = document.getElementById("castPlayerStatus");
+            const container = document.getElementById("castPlayer");
+            const castEl = document.getElementById("castData");
+            const toggleBtn = document.getElementById("castToggleSize");
+            if (!container || !castEl) return;
+
+            // Load external assets automatically (no extra click).
+            const VERSION = "3.9.0";
+            const LOCAL_CSS = "./asciinema-player.css";
+            const LOCAL_JS = "./asciinema-player.min.js";
+            // Use multiple CDNs to avoid regional blocks (e.g. jsdelivr).
+            const CDN_BASES = [
+              "https://cdn.jsdelivr.net/npm/asciinema-player@" + VERSION + "/dist/bundle/",
+              "https://unpkg.com/asciinema-player@" + VERSION + "/dist/bundle/",
+            ];
+            const CSS_URLS = [LOCAL_CSS, ...CDN_BASES.map((b) => b + "asciinema-player.css")];
+            const JS_URLS = [LOCAL_JS, ...CDN_BASES.map((b) => b + "asciinema-player.min.js")];
+
+            function setStatus(text) {
+              if (statusEl) statusEl.textContent = text ? " " + text : "";
+            }
+
+            async function loadCssOnce() {
               if (document.getElementById("asciinemaPlayerCss")) return;
 
               for (const href of CSS_URLS) {
@@ -1803,275 +2313,387 @@ timestamp=${escapeHtml(coerceDisplayString(timestamp))}</div>
 	  </body>
 	</html>`;
 }
-function jsonForHtml(data) {
-	return JSON.stringify(data).replaceAll("<", "\\u003c");
-}
-function renderSnapshotViewHtml(options) {
-	const headerLine = formatHeaderLine({
-		sessionId: options.sessionId,
-		scope: options.scope,
-		hash: options.hash,
-		meta: options.meta,
-		changedCount: options.changedLines.size
-	});
-	const digits = Math.max(2, String(options.lines.length).length);
-	const out = [`<span class="headerblock">${escapeHtml(headerLine)}</span>`];
-	if (options.scope === "visible") {
-		for (let i = 0; i < options.lines.length; i += 1) {
-			const n = i + 1;
-			const prefix = options.lineNumbers ? `${String(n).padStart(digits, "0")}│ ` : "";
-			const prefixHtml = options.lineNumbers ? `<span class="ln">${escapeHtml(prefix)}</span>` : "";
-			const contentHtml = renderVisibleRowHtml(options.terminal, i, options.trimRight);
-			const rowClass = options.changedLines.has(i) ? "row changed" : "row";
-			out.push(`<span class="${rowClass}">${prefixHtml}${contentHtml}</span>`);
-		}
-		return out.join("");
-	}
-	for (let i = 0; i < options.lines.length; i += 1) {
-		const n = i + 1;
-		const prefix = options.lineNumbers ? `${String(n).padStart(digits, "0")}│ ` : "";
-		const prefixHtml = options.lineNumbers ? `<span class="ln">${escapeHtml(prefix)}</span>` : "";
-		out.push(`<span class="row">${prefixHtml}${escapeHtml(options.lines[i] ?? "")}</span>`);
-	}
-	return out.join("");
+//#endregion
+//#region src/trace/report.ts
+async function generateTraceReportHtml(cast, options) {
+	const parsed = parseAsciicast(cast);
+	const termInfo = getTermInfo(parsed.header);
+	const scope = options?.scope ?? "visible";
+	const maxFrames = options?.maxFrames ?? 200;
+	const scriptName = options?.scriptName?.trim() ? options.scriptName.trim() : "";
+	const result = options?.result;
+	const artifacts = options?.artifacts;
+	const frames = await buildTraceReportFrames({
+		parsed,
+		term: termInfo,
+		scope,
+		maxFrames,
+		steps: options?.steps
+	});
+	return renderTraceReportHtml({
+		cast,
+		header: parsed.header,
+		term: termInfo,
+		scope,
+		scriptName,
+		result,
+		artifacts,
+		frames,
+		eventCount: parsed.events.length
+	});
 }
-function renderVisibleRowHtml(terminal, rowIndex, trimRight) {
-	const buffer = terminal.buffer.active;
-	const nullCell = buffer.getNullCell();
-	const startY = buffer.viewportY;
-	const line = buffer.getLine(startY + rowIndex);
-	const endCol = trimRight ? findMeaningfulEndCol(line, terminal.cols, nullCell) : terminal.cols;
-	const segments = [];
-	let currentKey = null;
-	let currentStyle = null;
-	let currentText = "";
-	const flush = () => {
-		if (!currentStyle) return;
-		if (currentText.length === 0) return;
-		segments.push({
-			key: currentKey ?? styleKey(currentStyle),
-			style: currentStyle,
-			text: currentText
-		});
-		currentText = "";
+if (import.meta.main) await runTraceReportCli(process.argv.slice(2), generateTraceReportHtml);
+//#endregion
+//#region src/script/failure_artifacts.ts
+async function writeFailureArtifacts(args) {
+	const { session, artifactsDir, scriptName, stepIndex, step, last, error } = args;
+	const err = error instanceof Error ? error : new Error(String(error));
+	const errorText = err.stack ?? err.message;
+	writeFileSync(join(artifactsDir, "failure.error.txt"), `${errorText}\n`, "utf8");
+	const stepPayload = {
+		script: scriptName,
+		stepIndex: stepIndex >= 0 ? stepIndex + 1 : null,
+		step: step ?? null,
+		last: last ? {
+			kind: last.kind,
+			hash: last.hash
+		} : null
 	};
-	for (let x = 0; x < endCol; x += 1) {
-		const cell = line?.getCell(x, nullCell);
-		if (!cell) {
-			if (currentStyle) {
-				flush();
-				currentStyle = null;
-				currentKey = null;
-			}
-			continue;
-		}
-		if (cell.getWidth() === 0) continue;
-		const chars = cell.getChars() || " ";
-		const style = extractStyle(cell);
-		const key = styleKey(style);
-		if (!currentStyle) {
-			currentStyle = style;
-			currentKey = key;
-			currentText = chars;
-			continue;
-		}
-		if (key === currentKey) {
-			currentText += chars;
-			continue;
-		}
-		flush();
-		currentStyle = style;
-		currentKey = key;
-		currentText = chars;
+	writeFileSync(join(artifactsDir, "failure.step.json"), `${JSON.stringify(stepPayload, null, 2)}\n`, "utf8");
+	let capturedText = void 0;
+	let capturedHash = void 0;
+	try {
+		const captured = await session.snapshotText({
+			scope: "visible",
+			trimRight: true,
+			trimBottom: true,
+			captureFrame: true
+		});
+		capturedText = captured.text;
+		capturedHash = captured.hash;
+	} catch {}
+	const text = capturedText ?? last?.text;
+	const hash = capturedHash ?? last?.hash ?? "unknown";
+	if (text !== void 0) {
+		writeFileSync(join(artifactsDir, "failure.last.txt"), `${text}\n`, "utf8");
+		const view = formatSnapshotView({
+			sessionId: session.id,
+			scope: "visible",
+			hash,
+			lines: text.split("\n"),
+			meta: session.getMeta(),
+			lineNumbers: true
+		});
+		writeFileSync(join(artifactsDir, "failure.last.view.txt"), `${view}\n`, "utf8");
 	}
-	if (currentStyle) flush();
-	return segments.map((segment) => renderSegmentHtml(segment.text, segment.style)).join("");
 }
-function renderSegmentHtml(text, style) {
-	const safeText = escapeHtml(text);
-	if (isDefaultStyle(style)) return safeText;
-	const css = styleToCss(style);
-	if (!css) return `<span class="seg">${safeText}</span>`;
-	return `<span class="seg" style="${css}">${safeText}</span>`;
+//#endregion
+//#region src/script/step_label.ts
+function formatStepLabel(step) {
+	return step.type === "custom" ? `custom(${step.name})` : step.type;
 }
-function styleToCss(style) {
-	let fg = colorToCss(style.fg);
-	let bg = colorToCss(style.bg);
-	if (style.inverse) {
-		const tmp = fg;
-		fg = bg;
-		bg = tmp;
+function formatPublicStepLabel(step) {
+	const showText = envTruthy(process.env.PTYWRIGHT_REPORT_SHOW_STEP_TEXT);
+	if (step.type === "custom") return `custom(${step.name})`;
+	if (step.type === "sendText") {
+		const enter = step.enter !== void 0 ? ` enter=${String(step.enter)}` : "";
+		if (!showText) return `sendText <redacted> (len=${step.text.length}${enter})`;
+		return `sendText "${truncateInline(step.text)}"${enter ? ` (${enter.trim()})` : ""}`;
 	}
-	const decls = [];
-	if (fg) decls.push(`color: ${fg}`);
-	if (bg) decls.push(`background-color: ${bg}`);
-	if (style.bold) decls.push("font-weight: 600");
-	if (style.italic) decls.push("font-style: italic");
-	if (style.dim) decls.push("opacity: 0.75");
-	const decorations = [];
-	if (style.underline) decorations.push("underline");
-	if (style.strikethrough) decorations.push("line-through");
-	if (decorations.length > 0) decls.push(`text-decoration: ${decorations.join(" ")}`);
-	return decls.join("; ");
-}
-function colorToCss(color) {
-	if (color.mode === "default") return null;
-	if (color.mode === "rgb") return `#${(color.value & 16777215).toString(16).padStart(6, "0")}`;
-	return xterm256Color(clampInt$1(color.value, 0, 255));
-}
-function xterm256Color(idx) {
-	const table16 = [
-		"#000000",
-		"#800000",
-		"#008000",
-		"#808000",
-		"#000080",
-		"#800080",
-		"#008080",
-		"#c0c0c0",
-		"#808080",
-		"#ff0000",
-		"#00ff00",
-		"#ffff00",
-		"#0000ff",
-		"#ff00ff",
-		"#00ffff",
-		"#ffffff"
-	];
-	if (idx < 16) return table16[idx] ?? "#000000";
-	if (idx >= 16 && idx <= 231) {
-		const c = [
-			0,
-			95,
-			135,
-			175,
-			215,
-			255
-		];
-		const n = idx - 16;
-		return `rgb(${c[Math.trunc(n / 36) % 6] ?? 0} ${c[Math.trunc(n / 6) % 6] ?? 0} ${c[n % 6] ?? 0})`;
+	if (step.type === "pressKey") return `pressKey ${step.key}`;
+	if (step.type === "sendMouse") return `sendMouse ${step.action} (${step.x},${step.y})`;
+	if (step.type === "resize") return `resize ${step.cols}x${step.rows}`;
+	if (step.type === "mark") return step.label ? `mark ${step.label}` : "mark";
+	if (step.type === "sleep") return `sleep ${step.ms}ms`;
+	if (step.type === "waitForText") {
+		if (!showText) return step.text ? "waitForText (text)" : step.regex ? "waitForText (regex)" : "waitForText";
+		if (step.text) return `waitFor "${truncateInline(step.text)}"`;
+		if (step.regex) return `waitFor /${truncateInline(step.regex)}/`;
+		return "waitForText";
 	}
-	const v = clampInt$1(8 + (idx - 232) * 10, 0, 255);
-	return `rgb(${v} ${v} ${v})`;
+	if (step.type === "waitForStableScreen") return "waitForStableScreen";
+	if (step.type === "waitForExit") return "waitForExit";
+	if (step.type === "expectMeta") return "expectMeta";
+	if (step.type === "snapshot") return `snapshot ${step.kind}${step.saveAs ? ` as ${step.saveAs}` : ""}`;
+	if (step.type === "expect") {
+		const parts = [];
+		if (step.equals !== void 0) parts.push("equals");
+		if (step.contains?.length) parts.push(`contains(${step.contains.length})`);
+		if (step.notContains?.length) parts.push(`notContains(${step.notContains.length})`);
+		if (step.regex) parts.push("regex");
+		return parts.length ? `expect ${parts.join(",")}` : "expect";
+	}
+	if (step.type === "expectGolden") return `expectGolden ${step.path}`;
+	if (step.type === "assert") {
+		if (!showText) return step.text ? "assert (text)" : step.regex ? "assert (regex)" : "assert";
+		if (step.text) return `assert "${truncateInline(step.text)}"`;
+		if (step.regex) return `assert /${truncateInline(step.regex)}/`;
+		if (step.description) return `assert "${truncateInline(step.description)}"`;
+		return "assert";
+	}
+	if (step.type === "assertSemantic") return "assertSemantic";
+	return assertUnreachableStep(step);
 }
-function diffLineIndices(previous, next) {
-	const out = /* @__PURE__ */ new Set();
-	const max = Math.max(previous.length, next.length);
-	for (let i = 0; i < max; i += 1) if ((previous[i] ?? "") !== (next[i] ?? "")) out.add(i);
-	return out;
+function truncateInline(text, maxChars = 60) {
+	const normalized = text.replace(/\r\n/g, "\n").replace(/\r/g, "\n").replace(/\n/g, "\\n");
+	if (normalized.length <= maxChars) return normalized;
+	return `${normalized.slice(0, maxChars)}…(+${normalized.length - maxChars})`;
 }
-function formatHeaderLine(input) {
-	const cursorViewportRow = input.meta.baseY + input.meta.cursorY - input.meta.viewportY;
-	const cursorViewportCol = input.meta.cursorX;
-	return [
-		`session=${input.sessionId}`,
-		`scope=${input.scope}`,
-		`size=${input.meta.cols}x${input.meta.rows}`,
-		`buffer=${input.meta.bufferType}`,
-		`cursor=${cursorViewportCol + 1},${cursorViewportRow + 1}`,
-		`hash=${input.hash}`,
-		`changed=${input.changedCount}`
-	].join(" ");
+function assertUnreachableStep(_step) {
+	return "unknown";
 }
-function coerceDisplayString(value) {
-	if (value === null || value === void 0) return "";
-	if (typeof value === "string") return value;
-	if (typeof value === "number" || typeof value === "boolean") return String(value);
+//#endregion
+//#region src/script/test_data_artifact.ts
+function writeTestDataArtifact(args) {
 	try {
-		return JSON.stringify(value) ?? "";
-	} catch {
-		return "";
+		const testId = basename(args.artifactsDir);
+		const outPath = args.resolveArtifactPath("test.data.js");
+		mkdirSync(dirname(outPath), { recursive: true });
+		const steps = args.executionSteps.map((s) => ({
+			index: s.index + 1,
+			type: s.step.type,
+			label: formatPublicStepLabel(s.step),
+			ok: s.ok,
+			durationMs: s.durationMs,
+			error: s.ok ? null : s.error ?? null
+		}));
+		const data = {
+			version: 1,
+			testId,
+			scriptName: args.scriptName,
+			ok: args.ok,
+			error: args.ok ? null : args.error ?? null,
+			stepCount: steps.length,
+			steps,
+			generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+		};
+		const json = JSON.stringify(data).replaceAll("<", "\\u003c");
+		writeFileSync(outPath, `globalThis.__ptywright = globalThis.__ptywright || {};
+globalThis.__ptywright.tests = globalThis.__ptywright.tests || {};
+globalThis.__ptywright.tests[${JSON.stringify(testId)}] = ${json};\n`, "utf8");
+	} catch {}
+}
+//#endregion
+//#region src/script/trace_artifacts.ts
+async function writeTraceArtifacts(args) {
+	if (!args.saveCast && !args.saveReport) return;
+	const snapshot = await args.session.snapshotCast();
+	if (args.saveCast) {
+		mkdirSync(dirname(args.castPath), { recursive: true });
+		writeFileSync(args.castPath, snapshot.cast, "utf8");
+	}
+	if (args.saveReport) {
+		const artifactHrefs = buildReportArtifactHrefs({
+			reportPath: args.reportPath,
+			castPath: args.saveCast ? args.castPath : null,
+			artifactsDir: args.artifactsDir,
+			includeFailures: args.result?.ok === false
+		});
+		const html = await generateTraceReportHtml(snapshot.cast, {
+			scope: args.reportScope,
+			maxFrames: args.reportMaxFrames,
+			scriptName: args.scriptName,
+			result: args.result,
+			artifacts: artifactHrefs,
+			steps: args.executionSteps
+		});
+		mkdirSync(dirname(args.reportPath), { recursive: true });
+		writeFileSync(args.reportPath, html, "utf8");
+		ensureAsciinemaPlayerAssets(args.reportPath);
 	}
 }
-function escapeHtml(text) {
-	return text.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
+function buildReportArtifactHrefs(args) {
+	const items = {};
+	if (args.castPath) items.castHref = relativeHref(args.reportPath, args.castPath);
+	if (args.includeFailures) {
+		items.failureErrorHref = relativeHref(args.reportPath, join(args.artifactsDir, "failure.error.txt"));
+		items.failureStepHref = relativeHref(args.reportPath, join(args.artifactsDir, "failure.step.json"));
+		items.failureLastTextHref = relativeHref(args.reportPath, join(args.artifactsDir, "failure.last.txt"));
+		items.failureLastViewHref = relativeHref(args.reportPath, join(args.artifactsDir, "failure.last.view.txt"));
+	}
+	return Object.keys(items).length ? items : void 0;
 }
-function getMeta(terminal) {
-	const buffer = terminal.buffer.active;
-	return {
-		cols: terminal.cols,
-		rows: terminal.rows,
-		bufferType: buffer.type,
-		viewportY: buffer.viewportY,
-		baseY: buffer.baseY,
-		length: buffer.length,
-		cursorX: buffer.cursorX,
-		cursorY: buffer.cursorY
-	};
+//#endregion
+//#region src/script/runner_paths.ts
+function resolveArtifactsDir(script, scriptName, override) {
+	if (override?.trim()) return resolve(override.trim());
+	if (script.artifactsDir?.trim()) return resolve(script.artifactsDir.trim());
+	return resolve(".tmp", "runs", scriptName);
 }
-function parseAsciicast(cast) {
-	const lines = cast.trimEnd().split("\n");
-	const header = safeJsonObject(lines[0]);
-	const events = [];
-	for (const line of lines.slice(1)) {
-		if (!line.trim()) continue;
-		const value = JSON.parse(line);
-		if (!Array.isArray(value) || value.length < 3) continue;
-		const time = Number(value[0]);
-		const type = String(value[1]);
-		const data = String(value[2]);
-		if (!Number.isFinite(time)) continue;
-		if (type === "o" || type === "i" || type === "r" || type === "m") events.push([
-			time,
-			type,
-			data
-		]);
-	}
+function createScriptPathResolvers(artifactsDir) {
 	return {
-		header,
-		events
+		resolveGoldenPath: (path) => isAbsolute(path) ? path : resolve(process.cwd(), path),
+		resolveArtifactPath: (path) => isAbsolute(path) ? path : resolve(artifactsDir, path)
 	};
 }
-function safeJsonObject(line) {
-	if (!line) return {};
-	try {
-		const value = JSON.parse(line);
-		return value && typeof value === "object" && !Array.isArray(value) ? value : {};
-	} catch {
-		return {};
-	}
+//#endregion
+//#region src/script/runner_load.ts
+async function loadJsonScriptFileWithDefaultName(scriptPath) {
+	const raw = await Bun.file(scriptPath).text();
+	const parsedJson = JSON.parse(raw);
+	const baseName = basename(scriptPath, extname(scriptPath));
+	return parsedJson && typeof parsedJson === "object" && !Array.isArray(parsedJson) && !("name" in parsedJson) ? {
+		...parsedJson,
+		name: baseName
+	} : parsedJson;
 }
-function getTermInfo(header) {
-	if (Number(header.version ?? 2) === 3) {
-		const term = header.term;
-		return {
-			cols: clampInt$1(Number(term?.cols ?? 80), 1, 500),
-			rows: clampInt$1(Number(term?.rows ?? 24), 1, 300),
-			type: typeof term?.type === "string" ? term.type : "xterm-256color"
-		};
+//#endregion
+//#region src/script/frame_text.ts
+function normalizeNewlines(text) {
+	return text.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+}
+function normalizeLineWidth(line, cols, trimRight) {
+	const clipped = line.length > cols ? line.slice(0, cols) : line;
+	return trimRight ? clipped.trimEnd() : clipped.padEnd(cols, " ");
+}
+function trimBottomEmptyLines(lines) {
+	let end = lines.length;
+	while (end > 0 && (lines[end - 1] ?? "").trim() === "") end -= 1;
+	return lines.slice(0, end);
+}
+function sliceLines(lines, options) {
+	if (options?.maxLines !== void 0) return lines.slice(0, Math.max(0, Math.trunc(options.maxLines)));
+	if (options?.tailLines !== void 0) {
+		const tail = Math.max(0, Math.trunc(options.tailLines));
+		return lines.slice(Math.max(0, lines.length - tail));
 	}
-	return {
-		cols: clampInt$1(Number(header.width ?? 80), 1, 500),
-		rows: clampInt$1(Number(header.height ?? 24), 1, 300),
-		type: typeof header.term === "string" ? header.term : "xterm-256color"
-	};
+	return lines;
 }
-function parseResize(value) {
-	const match = /^\s*(\d+)x(\d+)\s*$/.exec(value);
-	if (!match) return null;
-	return {
-		cols: clampInt$1(Number(match[1] ?? 0), 1, 500),
-		rows: clampInt$1(Number(match[2] ?? 0), 1, 300)
-	};
+function inferCols(frames) {
+	return clampInt(frames.reduce((acc, frame) => {
+		const lines = normalizeNewlines(frame).split("\n");
+		return Math.max(acc, ...lines.map((line) => line.length));
+	}, 0) || 80, 1, 500);
 }
-function clampInt$1(value, min, max) {
+function inferRows(frames) {
+	return clampInt(frames.reduce((acc, frame) => {
+		return Math.max(acc, normalizeNewlines(frame).split("\n").length);
+	}, 0) || 24, 1, 300);
+}
+function clampInt(value, min, max) {
 	if (!Number.isFinite(value)) return min;
 	const int = Math.trunc(value);
 	if (int < min) return min;
 	if (int > max) return max;
 	return int;
 }
-if (import.meta.main) {
-	const inputPath = process.argv[2];
-	if (!inputPath) {
-		console.error("Usage: bun run src/trace/report.ts <path/to/cast>");
-		process.exit(2);
+//#endregion
+//#region src/script/frame_snapshot.ts
+function snapshotFrameText(inputLines, options) {
+	if (options?.maxLines !== void 0 && options.tailLines !== void 0) throw new Error("snapshotText: maxLines and tailLines are mutually exclusive");
+	let lines = inputLines;
+	if (options?.trimBottom ?? true) lines = trimBottomEmptyLines(lines);
+	lines = sliceLines(lines, options);
+	lines = applyTextMaskRules(lines, options?.mask);
+	const text = lines.join("\n");
+	return {
+		text,
+		hash: fnv1a32(text)
+	};
+}
+function snapshotFrameAnsiFromText(text, hash) {
+	return {
+		ansi: text,
+		plain: text,
+		hash,
+		lines: text.split("\n").map((line) => ({
+			ansi: line,
+			plain: line
+		}))
+	};
+}
+function snapshotFrameGrid(args) {
+	const grid = {
+		cols: args.cols,
+		rows: args.rows,
+		bufferType: "normal",
+		cursorX: 0,
+		cursorY: args.cursorY,
+		viewportY: 0,
+		lines: args.lines,
+		styleRuns: args.includeStyles ? args.lines.map(() => []) : void 0
+	};
+	return {
+		grid,
+		hash: fnv1a32(JSON.stringify(grid))
+	};
+}
+//#endregion
+//#region src/script/frame_source.ts
+async function resolveLaunchFrames(launch, cwd, backend) {
+	const frames = [];
+	if (launch.frames?.length) frames.push(...normalizeFrames(launch.frames));
+	if (launch.frame !== void 0) frames.push(launch.frame);
+	if (launch.framePath) {
+		const path = resolveLaunchPath(cwd, launch.framePath);
+		frames.push(readFileSync(path, "utf8").replace(/\n$/, ""));
 	}
-	const html = await generateTraceReportHtml(await Bun.file(inputPath).text());
-	const outPath = join(dirname(inputPath), `${basename(inputPath, extname(inputPath))}.report.html`);
-	writeFileSync(outPath, html);
-	ensureAsciinemaPlayerAssets(outPath);
-	console.log(outPath);
+	if (launch.frameModule) frames.push(...await loadFrameModule(resolveLaunchPath(cwd, launch.frameModule), backend));
+	if (frames.length === 0) throw new Error(`launch.backend=${backend} requires frame, frames, framePath, or frameModule`);
+	return frames;
+}
+async function loadFrameModule(modulePath, backend) {
+	return normalizeFrames(await materializeFrameSource(selectModuleFrameSource(await import(pathToFileURL(modulePath).href), backend)));
+}
+function selectModuleFrameSource(mod, backend) {
+	if (mod.frames !== void 0) return mod.frames;
+	if (mod.default !== void 0) return mod.default;
+	if (backend === "ink" && mod.lastFrame !== void 0) return mod.lastFrame;
+	if (backend === "ink" && mod.frame !== void 0) return mod.frame;
+	if (backend === "ratatui" && mod.snapshot !== void 0) return mod.snapshot;
+	if (mod.frame !== void 0) return mod.frame;
+	if (mod.snapshot !== void 0) return mod.snapshot;
+	throw new Error(`frame module did not export frames/default/frame/snapshot/lastFrame`);
+}
+async function materializeFrameSource(source) {
+	if (typeof source === "function") return await source();
+	return source;
+}
+function normalizeFrames(source) {
+	if (Array.isArray(source)) return source.map((frame) => normalizeFrame(frame));
+	return [normalizeFrame(source)];
+}
+function normalizeFrame(frame) {
+	if (typeof frame === "string") return normalizeNewlines(frame).replace(/\n$/, "");
+	if (typeof frame === "object" && frame !== null) {
+		const value = frame;
+		const text = typeof value.text === "string" ? value.text : typeof value.frame === "string" ? value.frame : typeof value.snapshot === "string" ? value.snapshot : typeof value.lastFrame === "string" ? value.lastFrame : void 0;
+		if (text !== void 0) return normalizeNewlines(text).replace(/\n$/, "");
+	}
+	throw new Error("frame entries must be strings or objects with text/frame/snapshot/lastFrame");
+}
+function resolveLaunchPath(cwd, path) {
+	return isAbsolute(path) ? path : resolve(cwd, path);
+}
+//#endregion
+//#region src/script/frame_wait.ts
+async function waitForFrameText(snapshotText, args) {
+	const startedAt = Date.now();
+	while (true) {
+		const snapshot = await snapshotText({
+			scope: args.scope,
+			captureFrame: true
+		});
+		if (args.text && snapshot.text.includes(args.text)) return {
+			found: true,
+			...snapshot
+		};
+		if (args.regex && args.regex.test(snapshot.text)) return {
+			found: true,
+			...snapshot
+		};
+		if (Date.now() - startedAt >= args.timeoutMs) return {
+			found: false,
+			...snapshot
+		};
+		await sleep(Math.max(1, args.intervalMs));
+	}
+}
+async function waitForFrameStableScreen(snapshotText) {
+	return {
+		stable: true,
+		...await snapshotText({ captureFrame: true })
+	};
 }
 //#endregion
 //#region src/script/frame_session.ts
@@ -2148,17 +2770,11 @@ var FrameSession = class {
 			baseY: 0,
 			length: this.visibleLines({ trimRight: true }).length,
 			cursorX: 0,
-			cursorY: Math.max(0, Math.min(this.rowsValue - 1, this.currentLines().length - 1))
+			cursorY: this.cursorY()
 		};
 	}
 	async snapshotText(options) {
-		if (options?.maxLines !== void 0 && options.tailLines !== void 0) throw new Error("snapshotText: maxLines and tailLines are mutually exclusive");
-		let lines = options?.scope === "buffer" ? this.currentLines({ trimRight: options?.trimRight }) : this.visibleLines({ trimRight: options?.trimRight });
-		if (options?.trimBottom ?? true) lines = trimBottomEmptyLines(lines);
-		lines = sliceLines(lines, options);
-		lines = applyTextMaskRules(lines, options?.mask);
-		const text = lines.join("\n");
-		const hash = fnv1a32(text);
+		const { text, hash } = snapshotFrameText(options?.scope === "buffer" ? this.currentLines({ trimRight: options?.trimRight }) : this.visibleLines({ trimRight: options?.trimRight }), options);
 		if (options?.captureFrame ?? true) this.captureFrame(text, hash);
 		return {
 			text,
@@ -2167,29 +2783,17 @@ var FrameSession = class {
 	}
 	async snapshotAnsi(options) {
 		const { text, hash } = await this.snapshotText(options);
-		return {
-			ansi: text,
-			plain: text,
-			hash,
-			lines: text.split("\n").map((line) => ({
-				ansi: line,
-				plain: line
-			}))
-		};
+		return snapshotFrameAnsiFromText(text, hash);
 	}
 	async snapshotGrid(options) {
 		const lines = this.visibleLines({ trimRight: options?.trimRight });
-		const grid = {
+		const { grid, hash } = snapshotFrameGrid({
+			lines,
 			cols: this.colsValue,
 			rows: this.rowsValue,
-			bufferType: "normal",
-			cursorX: 0,
-			cursorY: Math.max(0, Math.min(this.rowsValue - 1, this.currentLines().length - 1)),
-			viewportY: 0,
-			lines,
-			styleRuns: options?.includeStyles ? lines.map(() => []) : void 0
-		};
-		const hash = fnv1a32(JSON.stringify(grid));
+			cursorY: this.cursorY(),
+			includeStyles: options?.includeStyles
+		});
 		if (options?.captureFrame ?? true) this.captureFrame(lines.join("\n"), hash);
 		return {
 			grid,
@@ -2201,32 +2805,10 @@ var FrameSession = class {
 		return this.trace.snapshot({ tailEvents: options?.tailEvents });
 	}
 	async waitForText(args) {
-		const startedAt = Date.now();
-		while (true) {
-			const snapshot = await this.snapshotText({
-				scope: args.scope,
-				captureFrame: true
-			});
-			if (args.text && snapshot.text.includes(args.text)) return {
-				found: true,
-				...snapshot
-			};
-			if (args.regex && args.regex.test(snapshot.text)) return {
-				found: true,
-				...snapshot
-			};
-			if (Date.now() - startedAt >= args.timeoutMs) return {
-				found: false,
-				...snapshot
-			};
-			await sleep(Math.max(1, args.intervalMs));
-		}
+		return waitForFrameText((options) => this.snapshotText(options), args);
 	}
 	async waitForStableScreen() {
-		return {
-			stable: true,
-			...await this.snapshotText({ captureFrame: true })
-		};
+		return waitForFrameStableScreen((options) => this.snapshotText(options));
 	}
 	isClosed() {
 		return this.closed !== null;
@@ -2261,6 +2843,9 @@ var FrameSession = class {
 		while (lines.length < this.rowsValue) lines.push("");
 		return lines;
 	}
+	cursorY() {
+		return Math.max(0, Math.min(this.rowsValue - 1, this.currentLines().length - 1));
+	}
 	captureFrame(text, hash) {
 		this.snapshotRing.push({
 			atMs: Date.now(),
@@ -2289,374 +2874,424 @@ async function createFrameSessionFromLaunch(args) {
 		advanceOnInput: args.launch.advanceOnInput
 	});
 }
-async function resolveLaunchFrames(launch, cwd, backend) {
-	const frames = [];
-	if (launch.frames?.length) frames.push(...normalizeFrames(launch.frames));
-	if (launch.frame !== void 0) frames.push(launch.frame);
-	if (launch.framePath) {
-		const path = resolveLaunchPath(cwd, launch.framePath);
-		frames.push(readFileSync(path, "utf8").replace(/\n$/, ""));
+//#endregion
+//#region src/script/runner_session.ts
+async function launchScriptSession(args) {
+	const { launch, scriptName } = args;
+	const cwd = launch.cwd ? resolve(process.cwd(), launch.cwd) : process.cwd();
+	if ((launch.backend ?? "pty") === "pty") {
+		const sessions = new SessionManager({ snapshotRingSize: 50 });
+		if (!launch.command) throw new Error("launch.command is required when backend=pty");
+		return {
+			session: sessions.launchSession({
+				command: launch.command,
+				args: launch.args ?? [],
+				cwd,
+				env: launch.env,
+				cols: launch.cols,
+				rows: launch.rows,
+				name: launch.name
+			}),
+			closeSession: () => sessions.closeAll()
+		};
 	}
-	if (launch.frameModule) frames.push(...await loadFrameModule(resolveLaunchPath(cwd, launch.frameModule), backend));
-	if (frames.length === 0) throw new Error(`launch.backend=${backend} requires frame, frames, framePath, or frameModule`);
-	return frames;
-}
-async function loadFrameModule(modulePath, backend) {
-	return normalizeFrames(await materializeFrameSource(selectModuleFrameSource(await import(pathToFileURL(modulePath).href), backend)));
-}
-function selectModuleFrameSource(mod, backend) {
-	if (mod.frames !== void 0) return mod.frames;
-	if (mod.default !== void 0) return mod.default;
-	if (backend === "ink" && mod.lastFrame !== void 0) return mod.lastFrame;
-	if (backend === "ink" && mod.frame !== void 0) return mod.frame;
-	if (backend === "ratatui" && mod.snapshot !== void 0) return mod.snapshot;
-	if (mod.frame !== void 0) return mod.frame;
-	if (mod.snapshot !== void 0) return mod.snapshot;
-	throw new Error(`frame module did not export frames/default/frame/snapshot/lastFrame`);
+	const session = await createFrameSessionFromLaunch({
+		launch,
+		cwd,
+		title: scriptName
+	});
+	return {
+		session,
+		closeSession: () => session.close()
+	};
 }
-async function materializeFrameSource(source) {
-	if (typeof source === "function") return await source();
-	return source;
+//#endregion
+//#region src/script/runner_trace.ts
+function resolveScriptTraceArtifacts(args) {
+	const trace = args.script.trace ?? {};
+	return {
+		saveCast: trace.saveCast ?? true,
+		saveReport: trace.saveReport ?? true,
+		castPath: args.resolveArtifactPath(trace.castPath ?? `${args.scriptName}.cast`),
+		reportPath: args.resolveArtifactPath(trace.reportPath ?? `${args.scriptName}.report.html`),
+		reportScope: trace.reportScope,
+		reportMaxFrames: trace.reportMaxFrames
+	};
 }
-function normalizeFrames(source) {
-	if (Array.isArray(source)) return source.map((frame) => normalizeFrame(frame));
-	return [normalizeFrame(source)];
+//#endregion
+//#region src/script/snapshot.ts
+function persistSnapshotRecord(args) {
+	const saveAs = args.saveAs?.trim();
+	if (saveAs) args.snapshots.set(saveAs, args.record);
+	const saveTo = args.saveTo?.trim();
+	if (!saveTo) return;
+	const path = args.resolveArtifactPath(saveTo);
+	mkdirSync(dirname(path), { recursive: true });
+	writeFileSync(path, `${args.record.text}\n`, "utf8");
 }
-function normalizeFrame(frame) {
-	if (typeof frame === "string") return normalizeNewlines(frame).replace(/\n$/, "");
-	if (typeof frame === "object" && frame !== null) {
-		const value = frame;
-		const text = typeof value.text === "string" ? value.text : typeof value.frame === "string" ? value.frame : typeof value.snapshot === "string" ? value.snapshot : typeof value.lastFrame === "string" ? value.lastFrame : void 0;
-		if (text !== void 0) return normalizeNewlines(text).replace(/\n$/, "");
+function selectSnapshot(last, snapshots, from) {
+	const key = from?.trim() ? from.trim() : "last";
+	if (key === "last") {
+		if (!last) throw new Error("expect: no previous snapshot (from=last)");
+		return last;
 	}
-	throw new Error("frame entries must be strings or objects with text/frame/snapshot/lastFrame");
+	const found = snapshots.get(key);
+	if (!found) throw new Error(`expect: unknown snapshot reference: ${key}`);
+	return found;
 }
-function resolveLaunchPath(cwd, path) {
-	return isAbsolute(path) ? path : resolve(cwd, path);
+function assertRecordMatches(record, step, stepIndex) {
+	if (step.equals !== void 0 && record.text !== step.equals) throw new Error(`step ${stepIndex + 1} expect.equals failed`);
+	if (step.contains && step.contains.length > 0) {
+		for (const item of step.contains) if (!record.text.includes(item)) throw new Error(`step ${stepIndex + 1} expect.contains failed: ${JSON.stringify(item)}`);
+	}
+	if (step.notContains && step.notContains.length > 0) {
+		for (const item of step.notContains) if (record.text.includes(item)) throw new Error(`step ${stepIndex + 1} expect.notContains failed: ${JSON.stringify(item)}`);
+	}
+	if (step.regex) {
+		if (!new RegExp(step.regex).test(record.text)) throw new Error(`step ${stepIndex + 1} expect.regex failed: ${JSON.stringify(step.regex)}`);
+	}
 }
-function normalizeNewlines(text) {
-	return text.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+function assertGoldenText(path, text, update) {
+	if (update) {
+		mkdirSync(dirname(path), { recursive: true });
+		writeFileSync(path, text, "utf8");
+		return;
+	}
+	if (text !== readFileSync(path, "utf8")) throw new Error(`golden mismatch: ${path}`);
 }
-function normalizeLineWidth(line, cols, trimRight) {
-	const clipped = line.length > cols ? line.slice(0, cols) : line;
-	return trimRight ? clipped.trimEnd() : clipped.padEnd(cols, " ");
+async function snapshotAfterStep(session) {
+	try {
+		const captured = await session.snapshotText({
+			scope: "visible",
+			trimRight: true,
+			trimBottom: true,
+			captureFrame: true
+		});
+		const lines = captured.text.split("\n");
+		const view = formatSnapshotView({
+			sessionId: session.id,
+			scope: "visible",
+			hash: captured.hash,
+			lines,
+			meta: session.getMeta(),
+			lineNumbers: true
+		});
+		return {
+			kind: "view",
+			hash: captured.hash,
+			text: view
+		};
+	} catch {
+		return null;
+	}
 }
-function trimBottomEmptyLines(lines) {
-	let end = lines.length;
-	while (end > 0 && (lines[end - 1] ?? "").trim() === "") end -= 1;
-	return lines.slice(0, end);
+async function snapshotStep(session, step) {
+	if (step.kind === "grid") {
+		if (step.mask && step.mask.length > 0) throw new Error("snapshot.kind=grid does not support mask (use text/view instead)");
+		const { grid, hash } = await session.snapshotGrid({
+			trimRight: step.trimRight,
+			includeStyles: step.includeStyles,
+			captureFrame: true
+		});
+		return {
+			kind: step.kind,
+			hash,
+			text: JSON.stringify(grid, null, 2)
+		};
+	}
+	if (step.kind === "ansi" || step.kind === "view_ansi") {
+		const { ansi, hash } = await session.snapshotAnsi({
+			scope: step.scope,
+			trimRight: step.trimRight,
+			trimBottom: step.trimBottom ?? true,
+			maxLines: step.maxLines,
+			tailLines: step.tailLines,
+			mask: step.mask
+		});
+		if (step.kind === "ansi") return {
+			kind: step.kind,
+			hash,
+			text: ansi
+		};
+		const lines = ansi.split("\n");
+		const view = formatSnapshotView({
+			sessionId: session.id,
+			scope: step.scope ?? "visible",
+			hash,
+			lines,
+			meta: session.getMeta(),
+			lineNumbers: step.lineNumbers
+		});
+		return {
+			kind: step.kind,
+			hash,
+			text: view
+		};
+	}
+	const { text, hash } = await session.snapshotText({
+		scope: step.scope,
+		trimRight: step.trimRight,
+		trimBottom: step.trimBottom ?? true,
+		maxLines: step.maxLines,
+		tailLines: step.tailLines,
+		captureFrame: true,
+		mask: step.mask
+	});
+	if (step.kind === "text") return {
+		kind: step.kind,
+		hash,
+		text
+	};
+	const lines = text.split("\n");
+	const view = formatSnapshotView({
+		sessionId: session.id,
+		scope: step.scope ?? "visible",
+		hash,
+		lines,
+		meta: session.getMeta(),
+		lineNumbers: step.lineNumbers
+	});
+	return {
+		kind: step.kind,
+		hash,
+		text: view
+	};
 }
-function sliceLines(lines, options) {
-	if (options?.maxLines !== void 0) return lines.slice(0, Math.max(0, Math.trunc(options.maxLines)));
-	if (options?.tailLines !== void 0) {
-		const tail = Math.max(0, Math.trunc(options.tailLines));
-		return lines.slice(Math.max(0, lines.length - tail));
+//#endregion
+//#region src/script/assertion_step_runner_helpers.ts
+async function expectSessionMeta(session, step) {
+	await session.flush();
+	const meta = session.getMeta();
+	if (step.bufferType !== void 0 && meta.bufferType !== step.bufferType) throw new Error(`expectMeta.bufferType mismatch (got ${meta.bufferType})`);
+	if (step.cols !== void 0 && meta.cols !== step.cols) throw new Error(`expectMeta.cols mismatch (got ${meta.cols})`);
+	if (step.rows !== void 0 && meta.rows !== step.rows) throw new Error(`expectMeta.rows mismatch (got ${meta.rows})`);
+	if (step.cursor) {
+		const cursorViewportRow = meta.baseY + meta.cursorY - meta.viewportY;
+		const actual = {
+			x: meta.cursorX + 1,
+			y: cursorViewportRow + 1
+		};
+		if (actual.x !== step.cursor.x || actual.y !== step.cursor.y) throw new Error(`expectMeta.cursor mismatch (got ${actual.x},${actual.y})`);
 	}
-	return lines;
 }
-function inferCols(frames) {
-	return clampInt(frames.reduce((acc, frame) => {
-		const lines = normalizeNewlines(frame).split("\n");
-		return Math.max(acc, ...lines.map((line) => line.length));
-	}, 0) || 80, 1, 500);
+async function runAssertStep(session, step, stepIndex) {
+	const regex = step.regex ? new RegExp(step.regex) : void 0;
+	if (!(await session.waitForText({
+		scope: step.scope,
+		text: step.text,
+		regex,
+		timeoutMs: 0,
+		intervalMs: 0
+	})).found) throw new Error(`step ${stepIndex + 1} assert failed: ${step.description || step.text || step.regex || "pattern mismatch"}`);
 }
-function inferRows(frames) {
-	return clampInt(frames.reduce((acc, frame) => {
-		return Math.max(acc, normalizeNewlines(frame).split("\n").length);
-	}, 0) || 24, 1, 300);
+//#endregion
+//#region src/script/custom_step_runner.ts
+async function runCustomStep(args) {
+	const handler = args.stepHandlers?.[args.step.name];
+	if (!handler) throw new Error(`custom handler not found: ${args.step.name}`);
+	return await handler({
+		session: args.session,
+		stepIndex: args.stepIndex,
+		last: args.last,
+		snapshots: args.snapshots,
+		artifactsDir: args.artifactsDir,
+		resolveArtifactPath: args.resolveArtifactPath,
+		resolveGoldenPath: args.resolveGoldenPath,
+		updateGoldens: args.updateGoldens,
+		captureSnapshot: async (snapshotConfig) => {
+			const record = await snapshotStep(args.session, {
+				type: "snapshot",
+				...snapshotConfig
+			});
+			persistSnapshotRecord({
+				record,
+				saveAs: snapshotConfig.saveAs,
+				saveTo: snapshotConfig.saveTo,
+				snapshots: args.snapshots,
+				resolveArtifactPath: args.resolveArtifactPath
+			});
+			return record;
+		},
+		getSnapshot: (from) => selectSnapshot(args.last, args.snapshots, from),
+		writeArtifactText: (path, text) => {
+			const resolved = args.resolveArtifactPath(path);
+			mkdirSync(dirname(resolved), { recursive: true });
+			writeFileSync(resolved, text, "utf8");
+		},
+		assertGoldenText: (path, text) => {
+			assertGoldenText(args.resolveGoldenPath(path), text, args.updateGoldens);
+		}
+	}, args.step) ?? args.last;
 }
-function clampInt(value, min, max) {
-	if (!Number.isFinite(value)) return min;
-	const int = Math.trunc(value);
-	if (int < min) return min;
-	if (int > max) return max;
-	return int;
+//#endregion
+//#region src/script/input_step_runner_helpers.ts
+function runMouseStep(session, step) {
+	const modifiers = step.shift || step.alt || step.ctrl ? {
+		shift: step.shift,
+		alt: step.alt,
+		ctrl: step.ctrl
+	} : void 0;
+	session.sendMouse({
+		action: step.action,
+		x: step.x,
+		y: step.y,
+		button: step.button,
+		modifiers
+	});
 }
 //#endregion
-//#region src/script/schema.ts
-const textMaskRuleSchema = z.object({
-	regex: z.string().min(1),
-	flags: z.string().optional(),
-	replacement: z.string().optional(),
-	preserveLength: z.boolean().optional()
-});
-const launchConfigSchema = z.object({
-	backend: z.enum([
-		"pty",
-		"frames",
-		"ink",
-		"ratatui"
-	]).optional(),
-	command: z.string().min(1).optional(),
-	args: z.array(z.string()).optional(),
-	cwd: z.string().optional(),
-	env: z.record(z.string()).optional(),
-	cols: z.number().int().positive().optional(),
-	rows: z.number().int().positive().optional(),
-	name: z.string().optional(),
-	frame: z.string().optional(),
-	frames: z.array(z.union([z.string(), z.object({
-		name: z.string().optional(),
-		text: z.string().optional(),
-		frame: z.string().optional(),
-		snapshot: z.string().optional(),
-		lastFrame: z.string().optional()
-	})])).optional(),
-	framePath: z.string().optional(),
-	frameModule: z.string().optional(),
-	advanceOnInput: z.boolean().optional()
-}).superRefine((value, ctx) => {
-	if ((value.backend ?? "pty") === "pty") {
-		if (!value.command) ctx.addIssue({
-			code: z.ZodIssueCode.custom,
-			path: ["command"],
-			message: "launch.command is required when backend=pty"
+//#region src/script/wait_step_runner_helpers.ts
+async function waitForTextStep(session, step, stepIndex) {
+	const regex = step.regex ? new RegExp(step.regex) : void 0;
+	if (!(await session.waitForText({
+		scope: step.scope,
+		text: step.text,
+		regex,
+		timeoutMs: step.timeoutMs ?? 1e4,
+		intervalMs: step.intervalMs ?? 100
+	})).found) throw new Error(`step ${stepIndex + 1} waitForText not found: ${step.text ?? step.regex ?? ""}`);
+}
+async function waitForStableScreenStep(session, step, stepIndex) {
+	if (!(await session.waitForStableScreen({
+		timeoutMs: step.timeoutMs ?? 1e4,
+		quietMs: step.quietMs ?? 400,
+		intervalMs: step.intervalMs ?? 80
+	})).stable) throw new Error(`step ${stepIndex + 1} waitForStableScreen timed out`);
+}
+async function waitForExitStep(session, step) {
+	const startedAt = Date.now();
+	const timeoutMs = step.timeoutMs ?? 1e4;
+	const intervalMs = step.intervalMs ?? 50;
+	while (Date.now() - startedAt <= timeoutMs) {
+		if (session.isClosed()) break;
+		await sleep(intervalMs);
+	}
+	const reason = session.getCloseReason();
+	if (!reason) throw new Error("waitForExit timed out");
+	if (reason.type !== "process_exit") throw new Error("waitForExit: session was closed by user");
+	if (step.exitCode !== void 0 && reason.exitCode !== step.exitCode) throw new Error(`waitForExit: exitCode mismatch (got ${reason.exitCode})`);
+	if (step.signal !== void 0 && reason.signal !== step.signal) throw new Error(`waitForExit: signal mismatch (got ${String(reason.signal ?? "")})`);
+}
+//#endregion
+//#region src/script/step_runner.ts
+async function runStep(args) {
+	const { step } = args;
+	try {
+		if (step.type === "sendText") {
+			args.session.sendText(step.text, { enter: step.enter });
+			return args.last;
+		}
+		if (step.type === "pressKey") {
+			args.session.pressKey(step.key);
+			return args.last;
+		}
+		if (step.type === "sendMouse") {
+			runMouseStep(args.session, step);
+			return args.last;
+		}
+		if (step.type === "resize") {
+			args.session.resize(step.cols, step.rows);
+			return args.last;
+		}
+		if (step.type === "mark") {
+			args.session.mark(step.label);
+			return args.last;
+		}
+		if (step.type === "sleep") {
+			await sleep(step.ms);
+			return args.last;
+		}
+		if (step.type === "waitForText") {
+			await waitForTextStep(args.session, step, args.stepIndex);
+			return args.last;
+		}
+		if (step.type === "waitForStableScreen") {
+			await waitForStableScreenStep(args.session, step, args.stepIndex);
+			return args.last;
+		}
+		if (step.type === "waitForExit") {
+			await waitForExitStep(args.session, step);
+			return args.last;
+		}
+		if (step.type === "expectMeta") {
+			await expectSessionMeta(args.session, step);
+			return args.last;
+		}
+		if (step.type === "snapshot") {
+			const record = await snapshotStep(args.session, step);
+			persistSnapshotRecord({
+				record,
+				saveAs: step.saveAs,
+				saveTo: step.saveTo,
+				snapshots: args.snapshots,
+				resolveArtifactPath: args.resolveArtifactPath
+			});
+			return record;
+		}
+		if (step.type === "expect") {
+			assertRecordMatches(selectSnapshot(args.last, args.snapshots, step.from), step, args.stepIndex);
+			return args.last;
+		}
+		if (step.type === "assert") {
+			await runAssertStep(args.session, step, args.stepIndex);
+			return args.last;
+		}
+		if (step.type === "assertSemantic") return args.last;
+		if (step.type === "expectGolden") {
+			const record = selectSnapshot(args.last, args.snapshots, step.from);
+			assertGoldenText(args.resolveGoldenPath(step.path), `${record.text}\n`, args.updateGoldens);
+			return args.last;
+		}
+		if (step.type === "custom") return await runCustomStep({
+			step,
+			stepIndex: args.stepIndex,
+			session: args.session,
+			snapshots: args.snapshots,
+			last: args.last,
+			resolveGoldenPath: args.resolveGoldenPath,
+			resolveArtifactPath: args.resolveArtifactPath,
+			updateGoldens: args.updateGoldens,
+			stepHandlers: args.stepHandlers,
+			artifactsDir: args.artifactsDir
 		});
-		return;
+		throw new Error(`unknown type: ${step.type}`);
+	} catch (error) {
+		throw annotateStepError(error, args.stepIndex, step);
 	}
-	if (!value.frame && !value.frames?.length && !value.framePath && !value.frameModule) ctx.addIssue({
-		code: z.ZodIssueCode.custom,
-		message: "framework launch requires one of frame, frames, framePath, or frameModule when backend is not pty"
-	});
-});
-const scriptTraceSchema = z.object({
-	saveCast: z.boolean().optional(),
-	saveReport: z.boolean().optional(),
-	castPath: z.string().optional(),
-	reportPath: z.string().optional(),
-	reportScope: z.enum(["visible", "buffer"]).optional(),
-	reportMaxFrames: z.number().int().positive().optional()
-});
-const sendTextStepSchema = z.object({
-	type: z.literal("sendText"),
-	text: z.string(),
-	enter: z.boolean().optional()
-});
-const pressKeyStepSchema = z.object({
-	type: z.literal("pressKey"),
-	key: z.string().min(1)
-});
-const sendMouseStepSchema = z.object({
-	type: z.literal("sendMouse"),
-	action: z.enum([
-		"down",
-		"up",
-		"move",
-		"click",
-		"scroll_up",
-		"scroll_down"
-	]),
-	x: z.number().int(),
-	y: z.number().int(),
-	button: z.enum([
-		"left",
-		"middle",
-		"right"
-	]).optional(),
-	shift: z.boolean().optional(),
-	alt: z.boolean().optional(),
-	ctrl: z.boolean().optional()
-});
-const resizeStepSchema = z.object({
-	type: z.literal("resize"),
-	cols: z.number().int().positive(),
-	rows: z.number().int().positive()
-});
-const markStepSchema = z.object({
-	type: z.literal("mark"),
-	label: z.string().optional()
-});
-const sleepStepSchema = z.object({
-	type: z.literal("sleep"),
-	ms: z.number().int().nonnegative()
-});
-const waitForTextStepSchema = z.object({
-	type: z.literal("waitForText"),
-	scope: z.enum(["visible", "buffer"]).optional(),
-	text: z.string().optional(),
-	regex: z.string().optional(),
-	timeoutMs: z.number().int().positive().optional(),
-	intervalMs: z.number().int().positive().optional()
-}).superRefine((value, ctx) => {
-	if (!value.text && !value.regex) ctx.addIssue({
-		code: z.ZodIssueCode.custom,
-		message: "waitForText requires text or regex"
-	});
-});
-const waitForStableScreenStepSchema = z.object({
-	type: z.literal("waitForStableScreen"),
-	timeoutMs: z.number().int().positive().optional(),
-	quietMs: z.number().int().positive().optional(),
-	intervalMs: z.number().int().positive().optional()
-});
-const waitForExitStepSchema = z.object({
-	type: z.literal("waitForExit"),
-	timeoutMs: z.number().int().positive().optional(),
-	intervalMs: z.number().int().positive().optional(),
-	exitCode: z.number().int().optional(),
-	signal: z.union([z.number().int(), z.string()]).optional()
-});
-const expectMetaStepSchema = z.object({
-	type: z.literal("expectMeta"),
-	bufferType: z.enum(["normal", "alternate"]).optional(),
-	cols: z.number().int().positive().optional(),
-	rows: z.number().int().positive().optional(),
-	cursor: z.object({
-		x: z.number().int().positive(),
-		y: z.number().int().positive()
-	}).optional()
-}).superRefine((value, ctx) => {
-	if (value.bufferType === void 0 && value.cols === void 0 && value.rows === void 0 && value.cursor === void 0) ctx.addIssue({
-		code: z.ZodIssueCode.custom,
-		message: "expectMeta requires at least one assertion (bufferType/cols/rows/cursor)"
-	});
-});
-const snapshotStepSchema = z.object({
-	type: z.literal("snapshot"),
-	kind: z.enum([
-		"text",
-		"view",
-		"ansi",
-		"view_ansi",
-		"grid"
-	]),
-	scope: z.enum(["visible", "buffer"]).optional(),
-	trimRight: z.boolean().optional(),
-	trimBottom: z.boolean().optional(),
-	maxLines: z.number().int().positive().optional(),
-	tailLines: z.number().int().positive().optional(),
-	lineNumbers: z.boolean().optional(),
-	includeStyles: z.boolean().optional(),
-	mask: z.array(textMaskRuleSchema).optional(),
-	saveAs: z.string().optional(),
-	saveTo: z.string().optional()
-}).superRefine((value, ctx) => {
-	if (value.maxLines !== void 0 && value.tailLines !== void 0) ctx.addIssue({
-		code: z.ZodIssueCode.custom,
-		message: "snapshot: maxLines and tailLines are mutually exclusive"
-	});
-});
-const expectStepSchema = z.object({
-	type: z.literal("expect"),
-	from: z.string().optional(),
-	equals: z.string().optional(),
-	contains: z.array(z.string()).optional(),
-	notContains: z.array(z.string()).optional(),
-	regex: z.string().optional()
-}).superRefine((value, ctx) => {
-	if (value.equals === void 0 && !value.contains?.length && !value.notContains?.length && !value.regex) ctx.addIssue({
-		code: z.ZodIssueCode.custom,
-		message: "expect requires at least one matcher (equals/contains/notContains/regex)"
-	});
-});
-const expectGoldenStepSchema = z.object({
-	type: z.literal("expectGolden"),
-	from: z.string().optional(),
-	path: z.string().min(1)
-});
-const customStepSchema = z.object({
-	type: z.literal("custom"),
-	name: z.string().min(1),
-	payload: z.unknown().optional()
-});
-const assertStepSchema = z.object({
-	type: z.literal("assert"),
-	scope: z.enum(["visible", "buffer"]).optional(),
-	text: z.string().optional(),
-	regex: z.string().optional(),
-	description: z.string().optional()
-}).superRefine((value, ctx) => {
-	if (!value.text && !value.regex) ctx.addIssue({
-		code: z.ZodIssueCode.custom,
-		message: "assert requires text or regex"
-	});
-});
-const assertSemanticStepSchema = z.object({
-	type: z.literal("assertSemantic"),
-	prompt: z.string().min(1),
-	description: z.string().optional()
-});
-const scriptStepSchema = z.union([
-	sendTextStepSchema,
-	pressKeyStepSchema,
-	sendMouseStepSchema,
-	resizeStepSchema,
-	markStepSchema,
-	sleepStepSchema,
-	waitForTextStepSchema,
-	waitForStableScreenStepSchema,
-	waitForExitStepSchema,
-	expectMetaStepSchema,
-	snapshotStepSchema,
-	expectStepSchema,
-	expectGoldenStepSchema,
-	customStepSchema,
-	assertStepSchema,
-	assertSemanticStepSchema
-]);
-const scriptSchema = z.object({
-	name: z.string().optional(),
-	artifactsDir: z.string().optional(),
-	launch: launchConfigSchema,
-	trace: scriptTraceSchema.optional(),
-	steps: z.array(scriptStepSchema).min(1)
-});
+}
+function annotateStepError(error, stepIndex, step) {
+	const label = step.type === "custom" ? `custom(${step.name})` : step.type;
+	const prefix = `step ${stepIndex + 1} ${label}`;
+	if (error instanceof Error) {
+		if (!error.message.startsWith("step ")) error.message = `${prefix}: ${error.message}`;
+		return error;
+	}
+	return /* @__PURE__ */ new Error(`${prefix}: ${String(error)}`);
+}
 //#endregion
 //#region src/script/runner.ts
 async function runScriptFile(scriptPath, options) {
-	const raw = await Bun.file(scriptPath).text();
-	const parsedJson = JSON.parse(raw);
-	const baseName = basename(scriptPath, extname(scriptPath));
-	return runScript(parsedJson && typeof parsedJson === "object" && !Array.isArray(parsedJson) && !("name" in parsedJson) ? {
-		...parsedJson,
-		name: baseName
-	} : parsedJson, options);
+	return runScript(await loadJsonScriptFileWithDefaultName(scriptPath), options);
 }
 async function runScript(script, options) {
 	const parsed = scriptSchema.parse(script);
 	const scriptName = parsed.name ?? "script";
 	const artifactsDir = resolveArtifactsDir(parsed, scriptName, options?.artifactsDir);
 	mkdirSync(artifactsDir, { recursive: true });
-	const launch = parsed.launch;
-	const cwd = launch.cwd ? resolve(process.cwd(), launch.cwd) : process.cwd();
-	const backend = launch.backend ?? "pty";
-	let sessions = null;
-	let session;
-	if (backend === "pty") {
-		sessions = new SessionManager({ snapshotRingSize: 50 });
-		if (!launch.command) throw new Error("launch.command is required when backend=pty");
-		session = sessions.launchSession({
-			command: launch.command,
-			args: launch.args ?? [],
-			cwd,
-			env: launch.env,
-			cols: launch.cols,
-			rows: launch.rows,
-			name: launch.name
-		});
-	} else session = await createFrameSessionFromLaunch({
-		launch,
-		cwd,
-		title: scriptName
+	const { session, closeSession } = await launchScriptSession({
+		launch: parsed.launch,
+		scriptName
 	});
-	const closeSession = () => {
-		if (sessions) {
-			sessions.closeAll();
-			return;
-		}
-		session.close();
-	};
 	const snapshots = /* @__PURE__ */ new Map();
 	let last = null;
 	let currentStepIndex = -1;
 	let currentStep = null;
-	const resolveGoldenPath = (path) => isAbsolute(path) ? path : resolve(process.cwd(), path);
-	const resolveArtifactPath = (path) => isAbsolute(path) ? path : resolve(artifactsDir, path);
-	const trace = parsed.trace ?? {};
-	const saveCast = trace.saveCast ?? true;
-	const saveReport = trace.saveReport ?? true;
-	const castPath = resolveArtifactPath(trace.castPath ?? `${scriptName}.cast`);
-	const reportPath = resolveArtifactPath(trace.reportPath ?? `${scriptName}.report.html`);
+	const { resolveArtifactPath, resolveGoldenPath } = createScriptPathResolvers(artifactsDir);
+	const traceArtifacts = resolveScriptTraceArtifacts({
+		script: parsed,
+		scriptName,
+		resolveArtifactPath
+	});
 	const stepHandlers = options?.steps;
 	const executionSteps = [];
 	try {
@@ -2679,30 +3314,9 @@ async function runScript(script, options) {
 					stepHandlers,
 					artifactsDir
 				});
-				let after = last;
-				if (!(last !== before)) try {
-					const captured = await session.snapshotText({
-						scope: "visible",
-						trimRight: true,
-						trimBottom: true,
-						captureFrame: true
-					});
-					const lines = captured.text.split("\n");
-					const view = formatSnapshotView({
-						sessionId: session.id,
-						scope: "visible",
-						hash: captured.hash,
-						lines,
-						meta: session.getMeta(),
-						lineNumbers: true
-					});
-					after = {
-						kind: "view",
-						hash: captured.hash,
-						text: view
-					};
-					last = after;
-				} catch {}
+				const stepProducedNewSnapshot = last !== before;
+				const after = stepProducedNewSnapshot ? last : await snapshotAfterStep(session);
+				if (!stepProducedNewSnapshot && after) last = after;
 				executionSteps.push({
 					index: stepIndex,
 					step,
@@ -2727,12 +3341,12 @@ async function runScript(script, options) {
 		await writeTraceArtifacts({
 			session,
 			artifactsDir,
-			saveCast,
-			castPath,
-			saveReport,
-			reportPath,
-			reportScope: trace.reportScope,
-			reportMaxFrames: trace.reportMaxFrames,
+			saveCast: traceArtifacts.saveCast,
+			castPath: traceArtifacts.castPath,
+			saveReport: traceArtifacts.saveReport,
+			reportPath: traceArtifacts.reportPath,
+			reportScope: traceArtifacts.reportScope,
+			reportMaxFrames: traceArtifacts.reportMaxFrames,
 			scriptName,
 			result: { ok: true },
 			executionSteps
@@ -2771,12 +3385,12 @@ async function runScript(script, options) {
 			await writeTraceArtifacts({
 				session,
 				artifactsDir,
-				saveCast,
-				castPath,
-				saveReport,
-				reportPath,
-				reportScope: trace.reportScope,
-				reportMaxFrames: trace.reportMaxFrames,
+				saveCast: traceArtifacts.saveCast,
+				castPath: traceArtifacts.castPath,
+				saveReport: traceArtifacts.saveReport,
+				reportPath: traceArtifacts.reportPath,
+				reportScope: traceArtifacts.reportScope,
+				reportMaxFrames: traceArtifacts.reportMaxFrames,
 				scriptName,
 				result: {
 					ok: false,
@@ -2794,464 +3408,5 @@ async function runScript(script, options) {
 		throw error;
 	}
 }
-function resolveArtifactsDir(script, scriptName, override) {
-	if (override?.trim()) return resolve(override.trim());
-	if (script.artifactsDir?.trim()) return resolve(script.artifactsDir.trim());
-	return resolve(".tmp", "runs", scriptName);
-}
-async function runStep(args) {
-	const { step } = args;
-	try {
-		if (step.type === "sendText") {
-			args.session.sendText(step.text, { enter: step.enter });
-			return args.last;
-		}
-		if (step.type === "pressKey") {
-			args.session.pressKey(step.key);
-			return args.last;
-		}
-		if (step.type === "sendMouse") {
-			const modifiers = step.shift || step.alt || step.ctrl ? {
-				shift: step.shift,
-				alt: step.alt,
-				ctrl: step.ctrl
-			} : void 0;
-			args.session.sendMouse({
-				action: step.action,
-				x: step.x,
-				y: step.y,
-				button: step.button,
-				modifiers
-			});
-			return args.last;
-		}
-		if (step.type === "resize") {
-			args.session.resize(step.cols, step.rows);
-			return args.last;
-		}
-		if (step.type === "mark") {
-			args.session.mark(step.label);
-			return args.last;
-		}
-		if (step.type === "sleep") {
-			await sleep(step.ms);
-			return args.last;
-		}
-		if (step.type === "waitForText") {
-			const regex = step.regex ? new RegExp(step.regex) : void 0;
-			if (!(await args.session.waitForText({
-				scope: step.scope,
-				text: step.text,
-				regex,
-				timeoutMs: step.timeoutMs ?? 1e4,
-				intervalMs: step.intervalMs ?? 100
-			})).found) throw new Error(`step ${args.stepIndex + 1} waitForText not found: ${step.text ?? step.regex ?? ""}`);
-			return args.last;
-		}
-		if (step.type === "waitForStableScreen") {
-			if (!(await args.session.waitForStableScreen({
-				timeoutMs: step.timeoutMs ?? 1e4,
-				quietMs: step.quietMs ?? 400,
-				intervalMs: step.intervalMs ?? 80
-			})).stable) throw new Error(`step ${args.stepIndex + 1} waitForStableScreen timed out`);
-			return args.last;
-		}
-		if (step.type === "waitForExit") {
-			const startedAt = Date.now();
-			const timeoutMs = step.timeoutMs ?? 1e4;
-			const intervalMs = step.intervalMs ?? 50;
-			while (Date.now() - startedAt <= timeoutMs) {
-				if (args.session.isClosed()) break;
-				await sleep(intervalMs);
-			}
-			const reason = args.session.getCloseReason();
-			if (!reason) throw new Error("waitForExit timed out");
-			if (reason.type !== "process_exit") throw new Error("waitForExit: session was closed by user");
-			if (step.exitCode !== void 0 && reason.exitCode !== step.exitCode) throw new Error(`waitForExit: exitCode mismatch (got ${reason.exitCode})`);
-			if (step.signal !== void 0 && reason.signal !== step.signal) throw new Error(`waitForExit: signal mismatch (got ${String(reason.signal ?? "")})`);
-			return args.last;
-		}
-		if (step.type === "expectMeta") {
-			await args.session.flush();
-			const meta = args.session.getMeta();
-			if (step.bufferType !== void 0 && meta.bufferType !== step.bufferType) throw new Error(`expectMeta.bufferType mismatch (got ${meta.bufferType})`);
-			if (step.cols !== void 0 && meta.cols !== step.cols) throw new Error(`expectMeta.cols mismatch (got ${meta.cols})`);
-			if (step.rows !== void 0 && meta.rows !== step.rows) throw new Error(`expectMeta.rows mismatch (got ${meta.rows})`);
-			if (step.cursor) {
-				const cursorViewportRow = meta.baseY + meta.cursorY - meta.viewportY;
-				const actual = {
-					x: meta.cursorX + 1,
-					y: cursorViewportRow + 1
-				};
-				if (actual.x !== step.cursor.x || actual.y !== step.cursor.y) throw new Error(`expectMeta.cursor mismatch (got ${actual.x},${actual.y})`);
-			}
-			return args.last;
-		}
-		if (step.type === "snapshot") {
-			const record = await snapshotStep(args.session, step);
-			persistSnapshotRecord({
-				record,
-				saveAs: step.saveAs,
-				saveTo: step.saveTo,
-				snapshots: args.snapshots,
-				resolveArtifactPath: args.resolveArtifactPath
-			});
-			return record;
-		}
-		if (step.type === "expect") {
-			assertRecordMatches(selectSnapshot(args.last, args.snapshots, step.from), step, args.stepIndex);
-			return args.last;
-		}
-		if (step.type === "assert") {
-			const regex = step.regex ? new RegExp(step.regex) : void 0;
-			if (!(await args.session.waitForText({
-				scope: step.scope,
-				text: step.text,
-				regex,
-				timeoutMs: 0,
-				intervalMs: 0
-			})).found) throw new Error(`step ${args.stepIndex + 1} assert failed: ${step.description || step.text || step.regex || "pattern mismatch"}`);
-			return args.last;
-		}
-		if (step.type === "assertSemantic") return args.last;
-		if (step.type === "expectGolden") {
-			const record = selectSnapshot(args.last, args.snapshots, step.from);
-			assertGoldenText(args.resolveGoldenPath(step.path), `${record.text}\n`, args.updateGoldens);
-			return args.last;
-		}
-		if (step.type === "custom") {
-			const handler = args.stepHandlers?.[step.name];
-			if (!handler) throw new Error(`custom handler not found: ${step.name}`);
-			const result = await handler({
-				session: args.session,
-				stepIndex: args.stepIndex,
-				last: args.last,
-				snapshots: args.snapshots,
-				artifactsDir: args.artifactsDir,
-				resolveArtifactPath: args.resolveArtifactPath,
-				resolveGoldenPath: args.resolveGoldenPath,
-				updateGoldens: args.updateGoldens,
-				captureSnapshot: async (snapshotConfig) => {
-					const record = await snapshotStep(args.session, {
-						type: "snapshot",
-						...snapshotConfig
-					});
-					persistSnapshotRecord({
-						record,
-						saveAs: snapshotConfig.saveAs,
-						saveTo: snapshotConfig.saveTo,
-						snapshots: args.snapshots,
-						resolveArtifactPath: args.resolveArtifactPath
-					});
-					return record;
-				},
-				getSnapshot: (from) => selectSnapshot(args.last, args.snapshots, from),
-				writeArtifactText: (path, text) => {
-					const resolved = args.resolveArtifactPath(path);
-					mkdirSync(dirname(resolved), { recursive: true });
-					writeFileSync(resolved, text, "utf8");
-				},
-				assertGoldenText: (path, text) => {
-					assertGoldenText(args.resolveGoldenPath(path), text, args.updateGoldens);
-				}
-			}, step);
-			if (!result) return args.last;
-			return result;
-		}
-		throw new Error(`unknown type: ${step.type}`);
-	} catch (error) {
-		throw annotateStepError(error, args.stepIndex, step);
-	}
-}
-function persistSnapshotRecord(args) {
-	const saveAs = args.saveAs?.trim();
-	if (saveAs) args.snapshots.set(saveAs, args.record);
-	const saveTo = args.saveTo?.trim();
-	if (!saveTo) return;
-	const path = args.resolveArtifactPath(saveTo);
-	mkdirSync(dirname(path), { recursive: true });
-	writeFileSync(path, `${args.record.text}\n`, "utf8");
-}
-function annotateStepError(error, stepIndex, step) {
-	const label = step.type === "custom" ? `custom(${step.name})` : step.type;
-	const prefix = `step ${stepIndex + 1} ${label}`;
-	if (error instanceof Error) {
-		if (!error.message.startsWith("step ")) error.message = `${prefix}: ${error.message}`;
-		return error;
-	}
-	return /* @__PURE__ */ new Error(`${prefix}: ${String(error)}`);
-}
-function selectSnapshot(last, snapshots, from) {
-	const key = from?.trim() ? from.trim() : "last";
-	if (key === "last") {
-		if (!last) throw new Error("expect: no previous snapshot (from=last)");
-		return last;
-	}
-	const found = snapshots.get(key);
-	if (!found) throw new Error(`expect: unknown snapshot reference: ${key}`);
-	return found;
-}
-function assertRecordMatches(record, step, stepIndex) {
-	if (step.equals !== void 0 && record.text !== step.equals) throw new Error(`step ${stepIndex + 1} expect.equals failed`);
-	if (step.contains && step.contains.length > 0) {
-		for (const item of step.contains) if (!record.text.includes(item)) throw new Error(`step ${stepIndex + 1} expect.contains failed: ${JSON.stringify(item)}`);
-	}
-	if (step.notContains && step.notContains.length > 0) {
-		for (const item of step.notContains) if (record.text.includes(item)) throw new Error(`step ${stepIndex + 1} expect.notContains failed: ${JSON.stringify(item)}`);
-	}
-	if (step.regex) {
-		if (!new RegExp(step.regex).test(record.text)) throw new Error(`step ${stepIndex + 1} expect.regex failed: ${JSON.stringify(step.regex)}`);
-	}
-}
-function assertGoldenText(path, text, update) {
-	if (update) {
-		mkdirSync(dirname(path), { recursive: true });
-		writeFileSync(path, text, "utf8");
-		return;
-	}
-	if (text !== readFileSync(path, "utf8")) throw new Error(`golden mismatch: ${path}`);
-}
-async function writeFailureArtifacts(args) {
-	const { session, artifactsDir, scriptName, stepIndex, step, last, error } = args;
-	const err = error instanceof Error ? error : new Error(String(error));
-	const errorText = err.stack ?? err.message;
-	writeFileSync(join(artifactsDir, "failure.error.txt"), `${errorText}\n`, "utf8");
-	const stepPayload = {
-		script: scriptName,
-		stepIndex: stepIndex >= 0 ? stepIndex + 1 : null,
-		step: step ?? null,
-		last: last ? {
-			kind: last.kind,
-			hash: last.hash
-		} : null
-	};
-	writeFileSync(join(artifactsDir, "failure.step.json"), `${JSON.stringify(stepPayload, null, 2)}\n`, "utf8");
-	let capturedText = void 0;
-	let capturedHash = void 0;
-	try {
-		const captured = await session.snapshotText({
-			scope: "visible",
-			trimRight: true,
-			trimBottom: true,
-			captureFrame: true
-		});
-		capturedText = captured.text;
-		capturedHash = captured.hash;
-	} catch {}
-	const text = capturedText ?? last?.text;
-	const hash = capturedHash ?? last?.hash ?? "unknown";
-	if (text !== void 0) {
-		writeFileSync(join(artifactsDir, "failure.last.txt"), `${text}\n`, "utf8");
-		const view = formatSnapshotView({
-			sessionId: session.id,
-			scope: "visible",
-			hash,
-			lines: text.split("\n"),
-			meta: session.getMeta(),
-			lineNumbers: true
-		});
-		writeFileSync(join(artifactsDir, "failure.last.view.txt"), `${view}\n`, "utf8");
-	}
-}
-async function snapshotStep(session, step) {
-	if (step.kind === "grid") {
-		if (step.mask && step.mask.length > 0) throw new Error("snapshot.kind=grid does not support mask (use text/view instead)");
-		const { grid, hash } = await session.snapshotGrid({
-			trimRight: step.trimRight,
-			includeStyles: step.includeStyles,
-			captureFrame: true
-		});
-		return {
-			kind: step.kind,
-			hash,
-			text: JSON.stringify(grid, null, 2)
-		};
-	}
-	if (step.kind === "ansi" || step.kind === "view_ansi") {
-		const { ansi, hash } = await session.snapshotAnsi({
-			scope: step.scope,
-			trimRight: step.trimRight,
-			trimBottom: step.trimBottom ?? true,
-			maxLines: step.maxLines,
-			tailLines: step.tailLines,
-			mask: step.mask
-		});
-		if (step.kind === "ansi") return {
-			kind: step.kind,
-			hash,
-			text: ansi
-		};
-		const lines = ansi.split("\n");
-		const view = formatSnapshotView({
-			sessionId: session.id,
-			scope: step.scope ?? "visible",
-			hash,
-			lines,
-			meta: session.getMeta(),
-			lineNumbers: step.lineNumbers
-		});
-		return {
-			kind: step.kind,
-			hash,
-			text: view
-		};
-	}
-	const { text, hash } = await session.snapshotText({
-		scope: step.scope,
-		trimRight: step.trimRight,
-		trimBottom: step.trimBottom ?? true,
-		maxLines: step.maxLines,
-		tailLines: step.tailLines,
-		captureFrame: true,
-		mask: step.mask
-	});
-	if (step.kind === "text") return {
-		kind: step.kind,
-		hash,
-		text
-	};
-	const lines = text.split("\n");
-	const view = formatSnapshotView({
-		sessionId: session.id,
-		scope: step.scope ?? "visible",
-		hash,
-		lines,
-		meta: session.getMeta(),
-		lineNumbers: step.lineNumbers
-	});
-	return {
-		kind: step.kind,
-		hash,
-		text: view
-	};
-}
-async function writeTraceArtifacts(args) {
-	if (!args.saveCast && !args.saveReport) return;
-	const snapshot = await args.session.snapshotCast();
-	if (args.saveCast) {
-		mkdirSync(dirname(args.castPath), { recursive: true });
-		writeFileSync(args.castPath, snapshot.cast, "utf8");
-	}
-	if (args.saveReport) {
-		const artifactHrefs = buildReportArtifactHrefs({
-			reportPath: args.reportPath,
-			castPath: args.saveCast ? args.castPath : null,
-			artifactsDir: args.artifactsDir,
-			includeFailures: args.result?.ok === false
-		});
-		const html = await generateTraceReportHtml(snapshot.cast, {
-			scope: args.reportScope,
-			maxFrames: args.reportMaxFrames,
-			scriptName: args.scriptName,
-			result: args.result,
-			artifacts: artifactHrefs,
-			steps: args.executionSteps
-		});
-		mkdirSync(dirname(args.reportPath), { recursive: true });
-		writeFileSync(args.reportPath, html, "utf8");
-		ensureAsciinemaPlayerAssets(args.reportPath);
-	}
-}
-function buildReportArtifactHrefs(args) {
-	const items = {};
-	if (args.castPath) items.castHref = relativeHref(args.reportPath, args.castPath);
-	if (args.includeFailures) {
-		items.failureErrorHref = relativeHref(args.reportPath, join(args.artifactsDir, "failure.error.txt"));
-		items.failureStepHref = relativeHref(args.reportPath, join(args.artifactsDir, "failure.step.json"));
-		items.failureLastTextHref = relativeHref(args.reportPath, join(args.artifactsDir, "failure.last.txt"));
-		items.failureLastViewHref = relativeHref(args.reportPath, join(args.artifactsDir, "failure.last.view.txt"));
-	}
-	return Object.keys(items).length ? items : void 0;
-}
-function relativeHref(fromFile, toFile) {
-	const normalized = relative(dirname(fromFile), toFile).replace(/\\/g, "/");
-	return normalized.startsWith(".") ? normalized : `./${normalized}`;
-}
-function formatStepLabel(step) {
-	return step.type === "custom" ? `custom(${step.name})` : step.type;
-}
-function formatPublicStepLabel(step) {
-	const showText = envTruthy(process.env.PTYWRIGHT_REPORT_SHOW_STEP_TEXT);
-	if (step.type === "custom") return `custom(${step.name})`;
-	if (step.type === "sendText") {
-		const enter = step.enter !== void 0 ? ` enter=${String(step.enter)}` : "";
-		if (!showText) return `sendText <redacted> (len=${step.text.length}${enter})`;
-		return `sendText "${truncateInline(step.text)}"${enter ? ` (${enter.trim()})` : ""}`;
-	}
-	if (step.type === "pressKey") return `pressKey ${step.key}`;
-	if (step.type === "sendMouse") return `sendMouse ${step.action} (${step.x},${step.y})`;
-	if (step.type === "resize") return `resize ${step.cols}x${step.rows}`;
-	if (step.type === "mark") return step.label ? `mark ${step.label}` : "mark";
-	if (step.type === "sleep") return `sleep ${step.ms}ms`;
-	if (step.type === "waitForText") {
-		if (!showText) return step.text ? "waitForText (text)" : step.regex ? "waitForText (regex)" : "waitForText";
-		if (step.text) return `waitFor "${truncateInline(step.text)}"`;
-		if (step.regex) return `waitFor /${truncateInline(step.regex)}/`;
-		return "waitForText";
-	}
-	if (step.type === "waitForStableScreen") return "waitForStableScreen";
-	if (step.type === "waitForExit") return "waitForExit";
-	if (step.type === "expectMeta") return "expectMeta";
-	if (step.type === "snapshot") return `snapshot ${step.kind}${step.saveAs ? ` as ${step.saveAs}` : ""}`;
-	if (step.type === "expect") {
-		const parts = [];
-		if (step.equals !== void 0) parts.push("equals");
-		if (step.contains?.length) parts.push(`contains(${step.contains.length})`);
-		if (step.notContains?.length) parts.push(`notContains(${step.notContains.length})`);
-		if (step.regex) parts.push("regex");
-		return parts.length ? `expect ${parts.join(",")}` : "expect";
-	}
-	if (step.type === "expectGolden") return `expectGolden ${step.path}`;
-	if (step.type === "assert") {
-		if (!showText) return step.text ? "assert (text)" : step.regex ? "assert (regex)" : "assert";
-		if (step.text) return `assert "${truncateInline(step.text)}"`;
-		if (step.regex) return `assert /${truncateInline(step.regex)}/`;
-		if (step.description) return `assert "${truncateInline(step.description)}"`;
-		return "assert";
-	}
-	if (step.type === "assertSemantic") return "assertSemantic";
-	return assertUnreachableStep(step);
-}
-function truncateInline(text, maxChars = 60) {
-	const normalized = text.replace(/\r\n/g, "\n").replace(/\r/g, "\n").replace(/\n/g, "\\n");
-	if (normalized.length <= maxChars) return normalized;
-	return `${normalized.slice(0, maxChars)}…(+${normalized.length - maxChars})`;
-}
-function assertUnreachableStep(_step) {
-	return "unknown";
-}
-function writeTestDataArtifact(args) {
-	try {
-		const testId = basename(args.artifactsDir);
-		const outPath = args.resolveArtifactPath("test.data.js");
-		mkdirSync(dirname(outPath), { recursive: true });
-		const steps = args.executionSteps.map((s) => ({
-			index: s.index + 1,
-			type: s.step.type,
-			label: formatPublicStepLabel(s.step),
-			ok: s.ok,
-			durationMs: s.durationMs,
-			error: s.ok ? null : s.error ?? null
-		}));
-		const data = {
-			version: 1,
-			testId,
-			scriptName: args.scriptName,
-			ok: args.ok,
-			error: args.ok ? null : args.error ?? null,
-			stepCount: steps.length,
-			steps,
-			generatedAt: (/* @__PURE__ */ new Date()).toISOString()
-		};
-		const json = JSON.stringify(data).replaceAll("<", "\\u003c");
-		writeFileSync(outPath, `globalThis.__ptywright = globalThis.__ptywright || {};
-globalThis.__ptywright.tests = globalThis.__ptywright.tests || {};
-globalThis.__ptywright.tests[${JSON.stringify(testId)}] = ${json};\n`, "utf8");
-	} catch {}
-}
-function envTruthy(value) {
-	const v = value?.trim().toLowerCase();
-	return v === "1" || v === "true" || v === "yes" || v === "on";
-}
 //#endregion
-export { ensureAsciinemaPlayerAssets as a, createDefaultPtyAdapter as c, generateTraceReportHtml as i, resolvePtyBackend as l, runScriptFile as n, formatSnapshotView as o, scriptSchema as r, SessionManager as s, runScript as t };
+export { jsonForHtml as a, scriptSchema as c, resolvePtyBackend as d, escapeHtml as i, SessionManager as l, runScriptFile as n, ensureAsciinemaPlayerAssets as o, generateTraceReportHtml as r, formatSnapshotView as s, runScript as t, createDefaultPtyAdapter as u };