@zenodinh/pi-render 0.1.0 → 0.1.2

package/src/renderers/content/artifacts/local-binary.test.ts

@@ -1,207 +0,0 @@
-/**
- * local-binary.test.ts — the audited spawn boundary (T-25 follow-up): spawnLocal's real argv/cwd/timeout
- * contract, cmux's absolute-candidate resolution, openInCmux's fixed argv and its no-shell guarantee, and
- * the PlantUML include guard.
- *
- * Compatibility tests for the two seams nothing else exercises: the package's only `node:child_process`
- * call site and the include guard in front of the JVM. Where behavior needs a real process it runs the
- * Node binary this test is already running under and `/bin/echo` — never a PATH lookup, never a shell;
- * everywhere else the seam is the injected `spawn`/`resolve`/`exists`. Each test carries a spec +
- * fails_when line.
- *
- * shape: none — test module, no runtime unit for DSG-1's trigger table to select a shape for.
- */
-
-import { existsSync, mkdtempSync, realpathSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { isAbsolute, join } from "node:path";
-import { beforeEach, describe, expect, it } from "vitest";
-import {
-	type LocalSpawn,
-	type LocalSpawnResult,
-	openInCmux,
-	plantumlIncludeOffense,
-	resolveCmux,
-	spawnLocal,
-} from "./local-binary.ts";
-
-// invented: the canned result an exit-0 process reports; there is no upstream payload to record.
-const OK: LocalSpawnResult = { status: 0, signal: null, stdout: Buffer.alloc(0), stderr: Buffer.alloc(0) };
-
-const CMUX_URL = "http://127.0.0.1:7777/artifact/9f2c";
-
-/** boundary: a spawn error is `unknown` until its `code` is narrowed here — no cast, no field read blind. */
-function errorCode(result: LocalSpawnResult): unknown {
-	const error: unknown = result.error;
-	return error !== null && typeof error === "object" && "code" in error ? error.code : undefined;
-}
-
-function only<T>(items: T[]): T {
-	const first = items[0];
-	if (first === undefined) throw new Error("test fixture: expected exactly one recorded item");
-	return first;
-}
-
-interface SpawnCall {
-	cmd: string;
-	args: string[];
-	timeoutMs: number;
-}
-
-/** invented: the recording spawn is the fixture — it captures the argv/timeout and never runs a process. */
-function recorder() {
-	const calls: SpawnCall[] = [];
-	const spawn: LocalSpawn = (cmd, args, opts) => {
-		calls.push({ cmd, args, timeoutMs: opts.timeoutMs });
-		return OK;
-	};
-	return { calls, spawn };
-}
-
-let dir: string;
-
-beforeEach(() => {
-	dir = mkdtempSync(join(tmpdir(), "pi-render-local-binary-"));
-});
-
-describe("cmux resolution", () => {
-	// spec: resolveCmux scans the two absolute app-bundle candidates in order and returns the first that
-	//   exists — no PATH lookup, no environment override, undefined when neither is there.
-	// fails_when: a relative or PATH-derived candidate is launched in the user's terminal.
-	it("returns the first existing absolute candidate and undefined when none exist", () => {
-		expect(resolveCmux(() => false)).toBeUndefined();
-		expect(resolveCmux(() => true)).toBe("/Applications/cmux.app/Contents/Resources/bin/cmux");
-
-		const second = resolveCmux((candidate) => candidate !== "/Applications/cmux.app/Contents/Resources/bin/cmux");
-		expect(second).toBeDefined();
-		expect(isAbsolute(second as string)).toBe(true);
-		expect(second?.endsWith("/Applications/cmux.app/Contents/Resources/bin/cmux")).toBe(true);
-	});
-
-	// spec: with no injected binary, openInCmux resolves cmux itself; on a machine without it the call is
-	//   a named error, never a spawn.
-	// fails_when: the default resolution is skipped, or a missing cmux turns into a failed spawn attempt.
-	it("resolves cmux itself when no binary is injected", () => {
-		const { calls, spawn } = recorder();
-
-		try {
-			openInCmux(CMUX_URL, { spawn });
-		} catch (error) {
-			expect(error instanceof Error ? error.message : String(error)).toBe("cmux: CLI not found");
-			expect(calls).toEqual([]);
-			return;
-		}
-
-		const call = only(calls);
-		expect(call.cmd).toBe(resolveCmux());
-		expect(isAbsolute(call.cmd)).toBe(true);
-	});
-});
-
-describe("openInCmux — the fixed cmux argv", () => {
-	// spec: openInCmux spawns the resolved binary with exactly
-	//   `new-pane --type browser --url <url> --focus false` and the 10s default timeout.
-	// fails_when: a cmux CLI change (reordered flags, dropped --focus) silently stops opening the card.
-	it("sends the fixed argv with the default timeout", () => {
-		const binary = "/Applications/cmux.app/Contents/Resources/bin/cmux";
-		const { calls, spawn } = recorder();
-
-		expect(openInCmux(CMUX_URL, { binary, spawn })).toEqual(OK);
-
-		const call = only(calls);
-		expect(call.cmd).toBe(binary);
-		expect(call.args).toEqual(["new-pane", "--type", "browser", "--url", CMUX_URL, "--focus", "false"]);
-		expect(call.timeoutMs).toBe(10_000);
-	});
-
-	// spec: an injected resolve() wins over the candidate scan, and a caller timeout overrides the 10s one.
-	// fails_when: the seams are ignored — a test or a caller cannot point the op at its own cmux.
-	it("honors an injected resolve and a timeout override", () => {
-		const { calls, spawn } = recorder();
-
-		openInCmux(CMUX_URL, { resolve: () => "/opt/pi-render-test/bin/cmux", spawn, timeoutMs: 250 });
-
-		const call = only(calls);
-		expect(call.cmd).toBe("/opt/pi-render-test/bin/cmux");
-		expect(call.timeoutMs).toBe(250);
-	});
-
-	// spec: with no cmux resolvable the call throws the named error and no process is started.
-	// fails_when: the caller gets a raw spawn error instead of the actionable message.
-	it("throws the named error when no cmux resolves and spawns nothing", () => {
-		const { calls, spawn } = recorder();
-
-		expect(() => openInCmux(CMUX_URL, { resolve: () => undefined, spawn })).toThrow("cmux: CLI not found");
-		expect(calls).toEqual([]);
-	});
-
-	// spec: the default spawn goes straight to the binary — no shell — so shell metacharacters in the URL
-	//   stay literal arguments and execute nothing.
-	// fails_when: a shell is introduced at this boundary and a card URL can run a command.
-	it("runs argv without a shell, so metacharacters in the URL stay literal", () => {
-		const canary = join(dir, "pwned");
-		const url = `http://127.0.0.1:7777/a;touch ${canary}`;
-
-		const result = openInCmux(url, { binary: "/bin/echo", timeoutMs: 2_000 });
-
-		expect(result.status).toBe(0);
-		expect(result.stdout?.toString("utf8")).toBe(`new-pane --type browser --url ${url} --focus false\n`);
-		expect(existsSync(canary)).toBe(false);
-	});
-});
-
-describe("spawnLocal — the one process runner", () => {
-	// spec: spawnLocal runs a fixed argv with a buffer encoding and returns the exit status and stdout.
-	// fails_when: the encoding or the argv passthrough changes and every caller reads the wrong bytes.
-	it("runs a fixed argv and returns the status with buffered output", () => {
-		const result = spawnLocal(process.execPath, ["-e", "process.stdout.write('ok')"], { timeoutMs: 10_000 });
-
-		expect(result.status).toBe(0);
-		expect(result.stdout?.toString("utf8")).toBe("ok");
-	});
-
-	// spec: spawnLocal runs the process in the cwd it was given.
-	// fails_when: a caller's temp-dir cwd is ignored, so a spawn writes into the user's directory.
-	it("runs in the cwd it was given", () => {
-		const result = spawnLocal(process.execPath, ["-e", "process.stdout.write(process.cwd())"], {
-			cwd: dir,
-			timeoutMs: 10_000,
-		});
-
-		const printed = result.stdout?.toString("utf8") ?? "";
-		expect(realpathSync(printed)).toBe(realpathSync(dir));
-	});
-
-	// spec: a process outliving its timeout is killed and reported as ETIMEDOUT with SIGTERM.
-	// fails_when: a hung binary pins the render thread forever.
-	it("kills a process past its timeout and reports ETIMEDOUT", () => {
-		const result = spawnLocal(process.execPath, ["-e", "setTimeout(() => {}, 5_000)"], { timeoutMs: 300 });
-
-		expect(errorCode(result)).toBe("ETIMEDOUT");
-		expect(result.signal).toBe("SIGTERM");
-	});
-
-	// spec: a missing binary is reported as ENOENT in the result, never thrown.
-	// fails_when: the caller crashes on a machine where the binary is absent instead of degrading.
-	it("reports a missing binary as ENOENT without throwing", () => {
-		const result = spawnLocal("/nonexistent/pi-render-no-such-binary", [], { timeoutMs: 1_000 });
-
-		expect(result.status).toBeNull();
-		expect(errorCode(result)).toBe("ENOENT");
-	});
-});
-
-describe("the PlantUML include guard", () => {
-	// spec: plantumlIncludeOffense reports every include-shaped directive by name — case-insensitively,
-	//   after leading whitespace, on any line — and passes ordinary source through.
-	// fails_when: a directive variant slips past the guard and an included local file reaches the image.
-	it("reports each include directive variant and passes ordinary source", () => {
-		expect(plantumlIncludeOffense("@startuml\n!include /etc/passwd\n@enduml")).toBe("!include");
-		expect(plantumlIncludeOffense("!includeurl https://example.invalid/x.puml")).toBe("!includeurl");
-		expect(plantumlIncludeOffense("  !includesub other.puml!FOO")).toBe("!includesub");
-		expect(plantumlIncludeOffense("!include_many a.puml")).toBe("!include_many");
-		expect(plantumlIncludeOffense("IDEA\n!IMPORT x.yaml\n")).toBe("!IMPORT");
-		expect(plantumlIncludeOffense("@startuml\n!pragma layout smetana\nAlice -> Bob\n@enduml")).toBeUndefined();
-		expect(plantumlIncludeOffense("")).toBeUndefined();
-	});
-});

package/src/renderers/content/image-card.test.ts

@@ -1,170 +0,0 @@
-// Fixture provenance — every image fixture is a real file written into a temp dir, so the assertions
-// drive the surface's own default probe (the bounded header read) instead of an injected stub.
-//   pic.png  — invented: a real 3×2 PNG (73 bytes) built with zlib + CRC32 on 2026-10-06; non-square,
-//              so a width/height swap cannot pass.
-//   pic.gif  — recorded-from: macOS sips converting that 3×2 PNG to GIF on 2026-10-06 (49 bytes, GIF87a).
-//   hdr.jpeg — invented: a 33-byte JPEG header (SOI, one APP1 segment to walk over, SOF0 3×2, EOI); the
-//              reader's contract is the segment walk, not the scan data.
-//   rst.jpeg — invented: a 25-byte JPEG header with a standalone RST0 marker before SOF0 3×2 — the walk
-//              must step over a marker that carries no length field.
-//   trunc.jpeg — invented: a 10-byte JPEG header whose APP1 segment claims 32 bytes the file does not
-//              hold — the walk must give up rather than read past the end.
-//   hdr.webp — invented: a 12-byte RIFF/WEBP signature — a known image whose dimensions this module does
-//              not walk, which is the path that cards with the path alone.
-//   bad.png  — invented: the PNG header with both dimensions zeroed (33 bytes) — the shape a corrupt or
-//              truncated header produces, where the dimensions must be dropped, not trusted.
-//   cut.png  — invented: the 8-byte PNG signature alone, no IHDR.
-//   notes.txt — invented: real text behind an image reference, the not-an-image case.
-
-// shape: none — test module: every behavior is asserted only through the createImageCardSurface seam.
-import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { afterAll, beforeAll, describe, expect, it } from "vitest";
-import { markerPaint } from "../../../test/fakes/index.ts";
-import type { TransformContext } from "../../core/types/host.ts";
-import { createImageCardSurface } from "./image-card.ts";
-
-const PNG = "iVBORw0KGgoAAAANSUhEUgAAAAMAAAACCAIAAAASFvFNAAAAEElEQVR42mP4z8AAQQxwFgBB0gX7b/EWxwAAAABJRU5ErkJggg==";
-const GIF = "R0lGODdhAwACAJEAAAAAAP8AAP///wAAACH5BAQAAAAALAAAAAADAAIAAAICjF8AOw==";
-const JPEG_HEADER = "/9j/4QAIRXhpZgAA/8AAEQgAAgADAwERAAIRAQMRAf/Z";
-const JPEG_RST_HEADER = "/9j/0P/AABEIAAIAAwMBEQACEQEDEQH/2Q==";
-const JPEG_TRUNCATED_HEADER = "/9j/4QAgRXhpZg==";
-const WEBP_HEADER = "UklGRgQAAABXRUJQ";
-const ZEROED_PNG = "iVBORw0KGgoAAAANSUhEUgAAAAAAAAAACAIAAAAAAAAA";
-const CUT_PNG = "iVBORw0KGgo=";
-
-/** The offered width every assertion here runs at: a 64-column card, 60 columns of content. */
-const ctx: TransformContext = { messageType: "assistant", isStreaming: false, availableWidth: 100 };
-
-let dir: string;
-
-beforeAll(() => {
-	dir = mkdtempSync(join(tmpdir(), "pi-render-image-card-"));
-	writeFileSync(join(dir, "pic.png"), Buffer.from(PNG, "base64"));
-	writeFileSync(join(dir, "pic.gif"), Buffer.from(GIF, "base64"));
-	writeFileSync(join(dir, "hdr.jpeg"), Buffer.from(JPEG_HEADER, "base64"));
-	writeFileSync(join(dir, "rst.jpeg"), Buffer.from(JPEG_RST_HEADER, "base64"));
-	writeFileSync(join(dir, "trunc.jpeg"), Buffer.from(JPEG_TRUNCATED_HEADER, "base64"));
-	writeFileSync(join(dir, "hdr.webp"), Buffer.from(WEBP_HEADER, "base64"));
-	writeFileSync(join(dir, "bad.png"), Buffer.from(ZEROED_PNG, "base64"));
-	writeFileSync(join(dir, "cut.png"), Buffer.from(CUT_PNG, "base64"));
-	writeFileSync(join(dir, "notes.txt"), "not an image\n");
-});
-
-afterAll(() => {
-	rmSync(dir, { recursive: true, force: true });
-});
-
-describe("createImageCardSurface — image references", () => {
-	it("AC-1: an existing local image renders the golden card with its resolved path and dimensions", () => {
-		const paint = markerPaint();
-		const surface = createImageCardSurface({ projectDir: dir });
-		const path = join(dir, "pic.png");
-		const out = surface.rewrite("![shot](pic.png)", ctx, paint);
-		// Golden geometry at 64 columns: header rule run 56, content 60, bottom run 62; the frame carries
-		// the rule role and every text row the quote role — the only content role that reads as metadata.
-		// A temp path outgrows one row on some machines, so the expected path rows are its pinned
-		// 60-column chunks: the widths and the row shape are literals, only the path's length varies.
-		const pathRows: string[] = [];
-		for (let at = 0; at < path.length; at += 60) {
-			pathRows.push(`${paint.rule("│")} ${paint.quote(path.slice(at, at + 60).padEnd(60))} ${paint.rule("│")}`);
-		}
-		const golden = [
-			paint.rule(`╭─ png ${"─".repeat(56)}╮`),
-			`${paint.rule("│")} ${paint.quote(`pic.png · 3×2${" ".repeat(47)}`)} ${paint.rule("│")}`,
-			...pathRows,
-			paint.rule(`╰${"─".repeat(62)}╯`),
-		].join("  \n");
-		// fails_when: card shape drifts or dims are wrong
-		expect(out).toBe(`${golden}\n`);
-	});
-
-	it("AC-1: PNG, GIF and JPEG headers become dimensions and an unwalked format still cards", () => {
-		const paint = markerPaint();
-		const surface = createImageCardSurface({ projectDir: dir });
-		const titleRow = (ref: string): string => surface.rewrite(`![shot](${ref})`, ctx, paint).split("  \n")[1] ?? "";
-		const cases: ReadonlyArray<readonly [string, string]> = [
-			["pic.png", "pic.png · 3×2"],
-			["pic.gif", "pic.gif · 3×2"],
-			["hdr.jpeg", "hdr.jpeg · 3×2"],
-			["rst.jpeg", "rst.jpeg · 3×2"],
-		];
-		for (const [ref, title] of cases) {
-			// fails_when: a header's offsets are wrong or a width/height swap goes unnoticed
-			expect(titleRow(ref)).toContain(title);
-		}
-		// fails_when: an image format whose dimensions we do not read drops the card instead of the path
-		expect(titleRow("hdr.webp")).toContain("hdr.webp");
-		expect(titleRow("hdr.webp")).not.toContain("·");
-	});
-
-	it("AC-1: a corrupt header drops the dimensions instead of the card", () => {
-		const paint = markerPaint();
-		const surface = createImageCardSurface({ projectDir: dir });
-		const titleRow = (ref: string): string => surface.rewrite(`![shot](${ref})`, ctx, paint).split("  \n")[1] ?? "";
-		for (const ref of ["bad.png", "cut.png", "trunc.jpeg"]) {
-			// fails_when: a header we cannot trust is trusted anyway
-			expect(titleRow(ref)).toContain(ref);
-			expect(titleRow(ref)).not.toContain("·");
-		}
-	});
-
-	it("AC-2: a reference to a file that is not there stays raw with one log line", () => {
-		const log: string[] = [];
-		const surface = createImageCardSurface({ projectDir: dir, log: (line) => log.push(line) });
-		const markdown = "![shot](gone.png)";
-		// fails_when: a missing image breaks the answer render
-		expect(surface.rewrite(markdown, ctx, markerPaint())).toBe(markdown);
-		expect(log).toHaveLength(1);
-		expect(log[0]).toContain("gone.png");
-	});
-
-	it("AC-2: a local file that is not an image stays raw with one log line", () => {
-		const log: string[] = [];
-		const surface = createImageCardSurface({ projectDir: dir, log: (line) => log.push(line) });
-		const markdown = "![shot](notes.txt)";
-		// fails_when: a non-image file behind an image reference is carded
-		expect(surface.rewrite(markdown, ctx, markerPaint())).toBe(markdown);
-		expect(log).toHaveLength(1);
-		expect(log[0]).toContain("notes.txt");
-	});
-
-	it("AC-2: a probe that throws keeps the reference and logs its message", () => {
-		const log: string[] = [];
-		const surface = createImageCardSurface({
-			projectDir: dir,
-			log: (line) => log.push(line),
-			probe: () => {
-				throw new Error("disk gone");
-			},
-		});
-		const markdown = "![shot](pic.png)";
-		// fails_when: a failing probe takes the answer render down
-		expect(surface.rewrite(markdown, ctx, markerPaint())).toBe(markdown);
-		expect(log).toHaveLength(1);
-		expect(log[0]).toContain("disk gone");
-	});
-
-	it("AC-2: a remote, protocol-relative or anchored reference is left alone and never logged", () => {
-		const log: string[] = [];
-		const surface = createImageCardSurface({ projectDir: dir, log: (line) => log.push(line) });
-		const hrefs = ["https://example.test/a.png", "//example.test/a.png", "#figure", "data:image/png;base64,AAAA"];
-		for (const href of hrefs) {
-			const markdown = `![shot](${href})`;
-			// fails_when: a reference pi-render does not own is read as a local path
-			expect(surface.rewrite(markdown, ctx, markerPaint())).toBe(markdown);
-		}
-		expect(log).toEqual([]);
-	});
-
-	it("leaves a reference inside a fenced block alone and cards the one outside it", () => {
-		const surface = createImageCardSurface({ projectDir: dir });
-		const markdown = ["```md", "![shot](pic.png)", "```", "![shot](pic.png)"].join("\n");
-		const out = surface.rewrite(markdown, ctx, markerPaint());
-		// fails_when: text inside a code block is rewritten as an image reference
-		expect(out).toContain("```md\n![shot](pic.png)\n```");
-		// exactly one card, and it is the reference outside the fence
-		expect(out.match(/╭─ png /g)).toHaveLength(1);
-	});
-});

package/src/renderers/content/panels.test.ts

@@ -1,188 +0,0 @@
-/**
- * panels.test.ts — the spec of the two content Surfaces at their seam: fenced markdown in, panel
- * markdown out. Every test drives `createCodePanel(...).rewrite` / `createJsonPanel(...).rewrite` with a
- * plain transform context; no module internals are imported.
- *
- * Fixtures: the code theme is `createCodeTheme` over a deterministic engine double that stamps its bound
- * theme into each line, so a panel names the theme it was colored for. Panels are driven with the marker
- * paint double, so a frame escape that is not the codeBlockBorder role is visible in the golden.
- */
-
-import { visibleWidth } from "@earendil-works/pi-tui";
-import { describe, expect, it } from "vitest";
-import { markerPaint } from "../../../test/fakes/index.ts";
-import { type BindHighlightEngine, type CodeThemeName, createCodeTheme } from "../../core/code-theme.ts";
-import type { CodeTheme, TransformContext } from "../../core/types.ts";
-import { createCodePanel } from "./code-panel.ts";
-import { createJsonPanel, type JsonPanelDeps } from "./json-panel.ts";
-
-const ESC = String.fromCharCode(27);
-/** The codeBlockBorder role's marker pair (test/fakes/paint.ts), the only frame escape a panel may emit. */
-const border = (text: string): string => `${ESC}[38;5;211m${text}${ESC}[38;5;231m`;
-/** The quote role's marker pair, used for the JSON pane's footer. */
-const quote = (text: string): string => `${ESC}[38;5;209m${text}${ESC}[38;5;229m`;
-/** One highlighted body line as the engine double emits it. */
-const ink = (rgb: string, text: string): string => `${ESC}[38;2;${rgb}m${text}${ESC}[0m`;
-/** Panel rows embedded as markdown: one code span per row, joined by the hard break the host honors. */
-const rows = (lines: string[]): string => lines.map((line) => `\`${line}\``).join("  \n");
-
-// invented: the engine is faked, so the golden pins OUR frame and highlight wiring, not shiki's palette.
-// Colours sit above the low-contrast floor (72) so code-theme's normalization leaves them alone.
-const INK: Record<CodeThemeName, string> = { "dracula-soft": "200;100;50", "one-dark-pro": "50;200;100" };
-const THEMES = Object.entries(INK) as Array<[CodeThemeName, string]>;
-
-/** Theme double: an engine that stamps the bound theme's ink into each line. */
-function themeNamed(name: CodeThemeName): CodeTheme {
-	const engine: BindHighlightEngine = (theme) => (code) => code.split("\n").map((line) => ink(INK[theme], line));
-	return createCodeTheme(engine, { registry: { getSettings: () => ({ codeTheme: name }) } });
-}
-
-/** Markdown transform context; only availableWidth is read (core/types/host.ts). */
-// invented: the two gate fields are the completed-assistant case, which is the only case a surface sees.
-const ctx = (availableWidth: number): TransformContext => ({
-	messageType: "assistant",
-	isStreaming: false,
-	availableWidth,
-});
-
-/** Reader double over a fixed file map (the injected seam T-28 wires to the filesystem). */
-function reader(files: Record<string, string>): JsonPanelDeps {
-	return { read: (href) => files[href] };
-}
-
-describe("code panel", () => {
-	it.each(THEMES)("AC-1: a fence renders as a bordered panel in %s's ink", (name, inkRgb) => {
-		const out = createCodePanel(themeNamed(name)).rewrite("```python\nx = 1\n```\n", ctx(80), markerPaint());
-
-		const expected = `${rows([
-			border("╭─ python ─────────────╮"),
-			`${border("│")} ${ink(inkRgb, "x = 1")}${" ".repeat(15)} ${border("│")}`,
-			border("╰──────────────────────╯"),
-		])}\n`;
-		// fails_when: the frame geometry, the language header, or the theme's ink drifts.
-		expect(out).toBe(expected);
-	});
-
-	it("AC-1: a bare fence and the mermaid/artifact fences keep their raw text", () => {
-		const panel = createCodePanel(themeNamed("dracula-soft"));
-		for (const raw of ["```\nx\n```\n", "```mermaid\ngraph TD;\n```\n", "```plantuml\nA -> B\n```\n"]) {
-			// fails_when: a host-owned or artifact-bound fence is consumed into a panel.
-			expect(panel.rewrite(raw, ctx(80), markerPaint())).toBe(raw);
-		}
-	});
-
-	it("AC-1: a fence hugging its content stays under the offered width", () => {
-		const out = createCodePanel(themeNamed("dracula-soft")).rewrite("```py\nx = 1\n```\n", ctx(80), markerPaint());
-		// fails_when: the panel spans the terminal instead of hugging its content.
-		expect(visibleWidth(out.split("\n")[0] ?? "")).toBeLessThan(30);
-	});
-
-	it("AC-2: a throwing highlightSync degrades to a plain panel, no throw", () => {
-		const throwing: CodeTheme = {
-			highlight: () => Promise.reject(new Error("boom")),
-			highlightSync: () => {
-				throw new Error("boom");
-			},
-		};
-		const panel = createCodePanel(throwing);
-		let out = "";
-		// fails_when: a highlighter failure kills the answer render.
-		expect(() => {
-			out = panel.rewrite("```ts\nlet x = 1;\n```\n", ctx(40), markerPaint());
-		}).not.toThrow();
-		expect(out).toContain("let x = 1;");
-		expect(out).not.toContain(`${ESC}[38;2;`); // no engine ink survived
-	});
-
-	it("AC-2: a throwing engine behind the real CodeTheme degrades the same way", () => {
-		const engine: BindHighlightEngine = () => () => {
-			throw new Error("boom");
-		};
-		const theme = createCodeTheme(engine, { registry: { getSettings: () => ({ codeTheme: "dracula-soft" }) } });
-		const out = createCodePanel(theme).rewrite("```ts\nlet x = 1;\n```\n", ctx(40), markerPaint());
-		// fails_when: code-theme's own degrade does not reach the panel.
-		expect(out).toContain("let x = 1;");
-		expect(out).not.toContain(`${ESC}[38;2;`);
-	});
-
-	it("AC-3: box columns align when truecolor escapes sit inside CJK content", () => {
-		const cjk = "// 撤销转退款场景，根据是否超过保价时间限制判断是否进行汇率决策";
-		const out = createCodePanel(themeNamed("dracula-soft")).rewrite(
-			`\`\`\`java\n${cjk}\npublic class X {}\n\`\`\`\n`,
-			ctx(110),
-			markerPaint(),
-		);
-		const widths = new Set(
-			out
-				.split("\n")
-				.filter((line) => line !== "")
-				.map((line) => visibleWidth(line.trimEnd())),
-		);
-		// fails_when: a wide character is measured as one column, so the closing │ no longer lines up.
-		expect(widths.size).toBe(1);
-	});
-});
-
-describe("json panel", () => {
-	// recorded-from: pi-pretty-tui/src/features/canvas/json-panel.test.ts (2026-10-06) — the same two-key body.
-	const DATA = '{\n  "name": "pi-pretty-tui",\n  "version": "0.1.0"\n}\n';
-
-	it.each(THEMES)("AC-1: a local .json link renders as a json pane in %s's ink", (name, inkRgb) => {
-		const panel = createJsonPanel(themeNamed(name), reader({ "/repo/data.json": DATA }));
-		const out = panel.rewrite("[data.json](/repo/data.json)\n", ctx(80), markerPaint());
-
-		const body = ["{", '  "name": "pi-pretty-tui",', '  "version": "0.1.0"', "}"];
-		const expected = `${rows([
-			border("╭─ json ─────────────────────╮"),
-			...body.map((line) => `${border("│")} ${ink(inkRgb, line)}${" ".repeat(26 - line.length)} ${border("│")}`),
-			border("╰────────────────────────────╯"),
-		])}\n\n${quote("/repo/data.json")}\n`;
-		// fails_when: the pane frame, the header, the footer, or the theme's ink drifts.
-		expect(out).toBe(expected);
-	});
-
-	it("AC-1: a ```json fence renders through the same panel", () => {
-		const panel = createJsonPanel(themeNamed("dracula-soft"), reader({}));
-		const out = panel.rewrite("```json\n{}\n```\n", ctx(40), markerPaint());
-		// fails_when: the JSON fence is left raw or rendered without the json header.
-		expect(out).toContain("╭─ json ");
-		expect(out).toContain(ink("200;100;50", "{}"));
-	});
-
-	it("caps a long file at 40 lines and leaves one way out", () => {
-		// invented: 60 numbered lines is one past the 40-line cap plus a countable remainder.
-		const sixty = Array.from({ length: 60 }, (_, index) => `line ${index}`).join("\n");
-		const panel = createJsonPanel(themeNamed("dracula-soft"), reader({ "/repo/big.json": sixty }));
-		const out = panel.rewrite("[big.json](/repo/big.json)\n", ctx(80), markerPaint());
-
-		// fails_when: the transcript swallows the whole file, or loses the way to the rest of it.
-		expect(out).toContain("╭─ json ");
-		expect(out).toContain("… +20 more lines");
-		expect(out).toContain("[Open](/repo/big.json)");
-		expect(out).not.toContain("line 40");
-	});
-
-	it("leaves a non-JSON or unreadable link as-is", () => {
-		const panel = createJsonPanel(themeNamed("dracula-soft"), reader({}));
-		const notes = "[notes.md](/repo/notes.md)\n";
-		const missing = "[gone.json](/repo/gone.json)\n";
-		// fails_when: a markdown link is pane-ized, or a missing file breaks the answer render.
-		expect(panel.rewrite(notes, ctx(80), markerPaint())).toBe(notes);
-		expect(panel.rewrite(missing, ctx(80), markerPaint())).toBe(missing);
-	});
-
-	it("logs once when the linked file cannot be read", () => {
-		const seen: string[] = [];
-		const panel = createJsonPanel(themeNamed("dracula-soft"), {
-			read: () => undefined,
-			log: {
-				logOnce: (key) => {
-					seen.push(key);
-				},
-			},
-		});
-		panel.rewrite("[gone.json](/repo/gone.json)\n", ctx(80), markerPaint());
-		// fails_when: an unreadable link is silent.
-		expect(seen).toEqual(["read:/repo/gone.json"]);
-	});
-});