@gajae-code/coding-agent 0.11.1 → 0.11.3

package/src/modes/components/command-palette.ts

@@ -0,0 +1,168 @@
+import {
+	type Component,
+	Container,
+	fuzzyFilter,
+	Input,
+	matchesKey,
+	padding,
+	truncateToWidth,
+	visibleWidth,
+} from "@gajae-code/tui";
+import { sanitizeStatusText } from "../shared";
+import { theme } from "../theme/theme";
+import { DynamicBorder } from "./dynamic-border";
+
+export interface CommandPaletteAction {
+	id: string;
+	label: string;
+	handler: () => void | Promise<void>;
+}
+
+export interface CommandPaletteEntry {
+	id: string;
+	label: string;
+	description?: string;
+	category?: string;
+	keybinding?: string;
+	bindingHint?: string;
+	searchText?: string;
+	handler?: () => void | Promise<void>;
+	disabled?: boolean;
+}
+
+function sanitizePaletteText(text: string): string {
+	return sanitizeStatusText(text.toWellFormed());
+}
+
+function isSafePaletteEntryId(id: string): boolean {
+	return id.length > 0 && !/[\s\u0000-\u001f\u007f-\u009f]/u.test(id);
+}
+
+class CommandPaletteList implements Component {
+	#entries: CommandPaletteEntry[];
+	#filteredEntries: CommandPaletteEntry[];
+	#selectedIndex = 0;
+	readonly #searchInput = new Input();
+	onSelect?: (entry: CommandPaletteEntry) => void;
+	onCancel?: () => void;
+
+	constructor(entries: CommandPaletteEntry[]) {
+		this.#entries = entries.map(entry => ({
+			...entry,
+			label: sanitizePaletteText(entry.label),
+			description: sanitizePaletteText(entry.description ?? entry.category ?? ""),
+			category: entry.category === undefined ? undefined : sanitizePaletteText(entry.category),
+			keybinding:
+				entry.keybinding === undefined && entry.bindingHint === undefined
+					? undefined
+					: sanitizePaletteText(entry.keybinding ?? entry.bindingHint ?? ""),
+			bindingHint: entry.bindingHint === undefined ? undefined : sanitizePaletteText(entry.bindingHint),
+			searchText: entry.searchText === undefined ? undefined : sanitizePaletteText(entry.searchText),
+		}));
+		this.#filteredEntries = this.#entries;
+	}
+
+	#filter(query: string): void {
+		this.#filteredEntries = fuzzyFilter(this.#entries, query, entry =>
+			[entry.label, entry.description, entry.keybinding ?? "", entry.searchText ?? ""].join(" "),
+		);
+		this.#selectedIndex = Math.max(0, Math.min(this.#selectedIndex, this.#filteredEntries.length - 1));
+	}
+
+	invalidate(): void {}
+
+	getEntries(): readonly CommandPaletteEntry[] {
+		return this.#filteredEntries;
+	}
+
+	render(width: number): string[] {
+		const lines = [theme.fg("muted", "  Search commands"), ...this.#searchInput.render(width), ""];
+		if (this.#filteredEntries.length === 0) {
+			lines.push(theme.fg("muted", "  No matching commands"));
+			return lines;
+		}
+
+		const maxVisible = 8;
+		const start = Math.max(
+			0,
+			Math.min(this.#selectedIndex - Math.floor(maxVisible / 2), this.#filteredEntries.length - maxVisible),
+		);
+		const end = Math.min(start + maxVisible, this.#filteredEntries.length);
+		for (let index = start; index < end; index += 1) {
+			const entry = this.#filteredEntries[index];
+			if (!entry) continue;
+			const selected = index === this.#selectedIndex;
+			const cursor = `${theme.nav.cursor} `;
+			const prefix = selected ? theme.fg("accent", cursor) : padding(visibleWidth(cursor));
+			const keybinding = entry.keybinding ? theme.fg("muted", entry.keybinding) : "";
+			const availableLabelWidth = Math.max(
+				1,
+				width - visibleWidth(prefix) - visibleWidth(keybinding) - (keybinding ? 1 : 0),
+			);
+			const label = truncateToWidth(entry.label, availableLabelWidth);
+			const labelPadding = padding(Math.max(0, availableLabelWidth - visibleWidth(label)));
+			const renderedLabel = selected ? theme.bold(label) : label;
+			lines.push(
+				entry.disabled
+					? theme.fg("muted", prefix + renderedLabel + labelPadding + (keybinding ? ` ${keybinding}` : ""))
+					: prefix + renderedLabel + labelPadding + (keybinding ? ` ${keybinding}` : ""),
+			);
+			lines.push(theme.fg("dim", truncateToWidth(`  ${entry.description ?? ""}`, width)));
+		}
+		if (start > 0 || end < this.#filteredEntries.length) {
+			lines.push(theme.fg("muted", `  (${this.#selectedIndex + 1}/${this.#filteredEntries.length})`));
+		}
+		lines.push("", theme.fg("muted", "  [Enter to run, Esc to close]"));
+		return lines;
+	}
+
+	handleInput(data: string): void {
+		if (matchesKey(data, "escape")) {
+			this.onCancel?.();
+			return;
+		}
+		if (matchesKey(data, "up")) {
+			this.#selectedIndex = Math.max(0, this.#selectedIndex - 1);
+			return;
+		}
+		if (matchesKey(data, "down")) {
+			this.#selectedIndex = Math.min(this.#filteredEntries.length - 1, this.#selectedIndex + 1);
+			return;
+		}
+		if (matchesKey(data, "enter") || matchesKey(data, "return") || data === "\n") {
+			const entry = this.#filteredEntries[this.#selectedIndex];
+			if (entry && !entry.disabled && isSafePaletteEntryId(entry.id)) this.onSelect?.(entry);
+			return;
+		}
+		this.#searchInput.handleInput(data);
+		this.#filter(this.#searchInput.getValue());
+	}
+}
+
+export class CommandPaletteComponent extends Container {
+	#list: CommandPaletteList;
+
+	constructor(entries: CommandPaletteEntry[], onSelect: (entry: CommandPaletteEntry) => void, onCancel: () => void) {
+		super();
+		this.addChild(new DynamicBorder());
+		this.#list = new CommandPaletteList(entries);
+		this.#list.onSelect = onSelect;
+		this.#list.onCancel = onCancel;
+		this.addChild(this.#list);
+		this.addChild(new DynamicBorder());
+	}
+
+	override render(width: number): string[] {
+		return super.render(width).map(line => truncateToWidth(line, width));
+	}
+	handleInput(data: string): void {
+		this.#list.handleInput(data);
+	}
+
+	getEntries(): readonly CommandPaletteEntry[] {
+		return this.#list.getEntries();
+	}
+}
+
+/** Backward-compatible name retained for extensions and existing call sites. */
+export class CommandPalette extends CommandPaletteComponent {}

package/src/modes/components/custom-editor.ts

@@ -402,7 +402,7 @@ export class CustomEditor extends Editor {
 			}
 		}
 
-		// Pass to parent for normal handling
+		// Pass to parent for normal handling.
 		super.handleInput(data);
 	}
 }

package/src/modes/components/custom-provider-wizard.ts

@@ -1,4 +1,4 @@
-import { Container, Input, matchesKey, Spacer, Text, TruncatedText } from "@gajae-code/tui";
+import { Container, Input, matchesKey, SecretInput, Spacer, Text, TruncatedText } from "@gajae-code/tui";
 import type { ProviderCompatibility, ProviderSetupInput } from "../../setup/provider-onboarding";
 import { theme } from "../theme/theme";
 import { matchesAppInterrupt } from "../utils/keybinding-matchers";
@@ -29,7 +29,7 @@ export type CustomProviderWizardSubmit = ProviderSetupInput;
 
 export class CustomProviderWizardComponent extends Container {
 	#contentContainer: Container;
-	#input: Input | null = null;
+	#input: Input | SecretInput | null = null;
 	#step: WizardStep = "compatibility";
 	#selectedIndex = 0;
 	#lastSubmitError: string | null = null;
@@ -82,6 +82,7 @@ export class CustomProviderWizardComponent extends Container {
 	handleInput(keyData: string): void {
 		if (matchesAppInterrupt(keyData)) {
 			if (this.#step === "compatibility") {
+				this.#clearLiteralCredential();
 				this.#onCancel();
 				return;
 			}
@@ -90,6 +91,10 @@ export class CustomProviderWizardComponent extends Container {
 		}
 
 		if (this.#input) {
+			if (this.#input instanceof SecretInput) {
+				this.#input.handleInput(keyData);
+				return;
+			}
 			if (matchesKey(keyData, "enter") || matchesKey(keyData, "return") || keyData === "\n") {
 				this.#saveInputAndProceed();
 				return;
@@ -138,16 +143,16 @@ export class CustomProviderWizardComponent extends Container {
 				this.#renderCredentialSourceStep();
 				break;
 			case "credential":
-				this.#renderInputStep(
-					"Step 5: Credential",
-					this.#state.credentialSource === "env"
-						? "Enter the API key environment variable name:"
-						: "Paste the API key:",
-					this.#state.credential,
-					this.#state.credentialSource === "env"
-						? "e.g. OPENAI_API_KEY"
-						: "The key will be stored in models.yml and redacted in output.",
-				);
+				if (this.#state.credentialSource === "env") {
+					this.#renderInputStep(
+						"Step 5: Credential",
+						"Enter the API key environment variable name:",
+						this.#state.credential,
+						"e.g. OPENAI_API_KEY",
+					);
+				} else {
+					this.#renderSecretInputStep();
+				}
 				break;
 			case "models":
 				this.#renderInputStep(
@@ -198,6 +203,27 @@ export class CustomProviderWizardComponent extends Container {
 		this.#addHelp("[Enter to continue, Esc to go back]");
 	}
 
+	#renderSecretInputStep(): void {
+		this.#contentContainer.addChild(new Text(theme.fg("accent", "Step 5: Credential")));
+		this.#contentContainer.addChild(new Spacer(1));
+		this.#contentContainer.addChild(new Text("Paste the API key:", 0, 0));
+		this.#contentContainer.addChild(new Spacer(1));
+		const input = new SecretInput();
+		input.onSubmit = secret => {
+			const credential = secret.consume().trim();
+			if (!credential) return;
+			this.#state.credential = credential;
+			this.#step = "models";
+			this.#renderStep();
+			this.#onRender();
+		};
+		this.#input = input;
+		this.#contentContainer.addChild(input);
+		this.#contentContainer.addChild(new Spacer(1));
+		this.#addHelp("The key will be stored securely and redacted in output.");
+		this.#addHelp("[Enter to continue, Esc to go back]");
+	}
+
 	#renderConfirmStep(force: boolean): void {
 		this.#contentContainer.addChild(
 			new Text(theme.fg("accent", force ? "Provider exists — replace it?" : "Confirm custom provider")),
@@ -235,7 +261,8 @@ export class CustomProviderWizardComponent extends Container {
 	}
 
 	#saveInputAndProceed(): void {
-		const value = this.#input?.getValue().trim() ?? "";
+		if (!(this.#input instanceof Input)) return;
+		const value = this.#input.getValue().trim();
 		if (!value) return;
 		if (this.#step === "provider-id") {
 			this.#state.providerId = value;
@@ -277,7 +304,7 @@ export class CustomProviderWizardComponent extends Container {
 	}
 
 	#buildInput(force: boolean): CustomProviderWizardSubmit {
-		return {
+		const input = {
 			compatibility: this.#state.compatibility,
 			providerId: this.#state.providerId,
 			baseUrl: this.#state.baseUrl,
@@ -289,6 +316,16 @@ export class CustomProviderWizardComponent extends Container {
 				.filter(Boolean),
 			force,
 		};
+
+		return input;
+	}
+
+	complete(): void {
+		this.#clearLiteralCredential();
+	}
+
+	#clearLiteralCredential(): void {
+		if (this.#state.credentialSource === "literal") this.#state.credential = "";
 	}
 
 	#moveSelection(delta: number): void {

package/src/modes/components/index.ts

@@ -3,6 +3,7 @@ export * from "./assistant-message";
 export * from "./bash-execution";
 export * from "./bordered-loader";
 export * from "./branch-summary-message";
+export * from "./chrome";
 export * from "./compaction-summary-message";
 export * from "./countdown-timer";
 export * from "./custom-editor";
@@ -23,11 +24,11 @@ export * from "./read-tool-group";
 export * from "./session-selector";
 export * from "./settings-selector";
 export * from "./show-images-selector";
-export * from "./status-line";
 export * from "./theme-selector";
 export * from "./thinking-selector";
 export * from "./todo-reminder";
 export * from "./tool-execution";
+export * from "./tool-status-header";
 export * from "./tree-selector";
 export * from "./ttsr-notification";
 export * from "./user-message";

package/src/modes/components/pet-selector.ts

@@ -1,6 +1,5 @@
-import { Container, PET_SKIN_IDS, PET_SKINS, SelectList } from "@gajae-code/tui";
-import { getSelectListTheme } from "../theme/theme";
-import { DynamicBorder } from "./dynamic-border";
+import { Container, PET_SKIN_IDS, PET_SKINS, type SelectList } from "@gajae-code/tui";
+import { FramedSelect } from "./chrome";
 import type { PetMode } from "./gajae-pet-widget";
 import { createPetSelectItems } from "./pet-capability";
 
@@ -31,20 +30,15 @@ export class PetSelectorComponent extends Container {
 
 		const items = createPetSelectItems(PET_OPTIONS, current, available);
 
-		this.addChild(new DynamicBorder());
-
-		this.#selectList = new SelectList(items, 10, getSelectListTheme());
-		const currentIndex = PET_OPTIONS.findIndex(option => option.value === current);
-		if (currentIndex !== -1) {
-			this.#selectList.setSelectedIndex(currentIndex);
-		}
-
-		this.#selectList.onSelect = item => onSelect(item.value as PetMode);
-		this.#selectList.onCancel = () => onCancel();
-		this.#selectList.onSelectionChange = item => onPreview(item.value as PetMode);
-
-		this.addChild(this.#selectList);
-		this.addChild(new DynamicBorder());
+		const framed = FramedSelect(undefined, items, {
+			maxVisible: 10,
+			selectedValue: current,
+			onSelect: item => onSelect(item.value as PetMode),
+			onCancel,
+			onSelectionChange: item => onPreview(item.value as PetMode),
+		});
+		this.#selectList = framed.selectList;
+		this.addChild(framed.container);
 	}
 
 	getSelectList(): SelectList {

package/src/modes/components/plan-preview-overlay.ts

@@ -0,0 +1,295 @@
+import { createHash } from "node:crypto";
+import { Container, Input, type KeyId, type MouseEvent, matchesKey, truncateToWidth } from "@gajae-code/tui";
+
+import { theme } from "../theme/theme";
+import { DynamicBorder } from "./dynamic-border";
+
+export const PLAN_REVIEW_ACTIONS = [
+	"Approve and execute",
+	"Approve and compact context",
+	"Approve and keep context",
+	"Refine plan",
+] as const;
+export type PlanReviewAction = (typeof PLAN_REVIEW_ACTIONS)[number];
+export type PlanPreviewFocus = "preview" | "sourceSelect" | "commentInput" | "actionBar";
+export interface PlanPreviewOptions {
+	externalEditorKey?: string;
+	externalEditorKeys?: readonly KeyId[];
+	onExternalEditor?: () => Promise<string | null>;
+}
+
+export interface PlanComment {
+	id: string;
+	startLine: number;
+	endLine: number;
+	text: string;
+	snapshotHash: string;
+	createdAt: number;
+}
+export interface PlanPreviewResult {
+	action?: PlanReviewAction;
+	comments: PlanComment[];
+	notes: string;
+	snapshotHash: string;
+}
+
+export function planSnapshotHash(content: string): string {
+	return createHash("sha256").update(content).digest("hex");
+}
+export function serializePlanReviewComments(
+	content: string,
+	hash: string,
+	comments: readonly PlanComment[],
+	notes = "",
+): string {
+	const lines = content.split("\n").map(line => line.replace(/\r$/, ""));
+	const valid = comments.filter(
+		comment =>
+			comment.snapshotHash === hash &&
+			comment.text.trim() &&
+			Number.isInteger(comment.startLine) &&
+			Number.isInteger(comment.endLine) &&
+			comment.startLine >= 1 &&
+			comment.endLine >= comment.startLine &&
+			comment.startLine <= lines.length,
+	);
+	if (!valid.length && !notes.trim()) return "";
+	const block = [`Plan review comments (snapshot ${hash.slice(0, 8)}):`];
+	for (const comment of valid) {
+		const end = Math.min(lines.length, Math.max(comment.startLine, comment.endLine));
+		block.push(`- L${comment.startLine}${end === comment.startLine ? "" : `-L${end}`}: ${comment.text.trim()}`);
+		for (let line = comment.startLine; line <= Math.min(end, comment.startLine + 5); line++)
+			block.push(`> ${lines[line - 1]}`);
+	}
+	if (notes.trim()) block.push(notes.trim());
+	return block.join("\n");
+}
+
+/** Modal pre-decision review. Its result is consumed by InteractiveMode, which owns audit and dispatch semantics. */
+export class PlanPreviewOverlay extends Container {
+	#focus: PlanPreviewFocus = "preview";
+	#scroll = 0;
+	#sourceLine = 1;
+	#actionIndex = 0;
+	#comments: PlanComment[] = [];
+	#notes = "";
+	#input = new Input();
+	#inputKind: "comment" | "notes" = "comment";
+	#renderedSourceLines: number[] = [];
+	#renderedBody: string[] = [];
+	#renderedBodyWidth = 0;
+	content: string | null;
+
+	snapshotHash: string;
+	lines: string[];
+	constructor(
+		content: string | null,
+		private readonly done: (result: PlanPreviewResult) => void,
+		private readonly requestRender: () => void,
+		private readonly options: PlanPreviewOptions = {},
+	) {
+		super();
+		this.content = content;
+		this.snapshotHash = planSnapshotHash(content ?? "");
+		this.lines = (content ?? "").split("\n");
+		this.#input.onSubmit = text => this.#saveInput(text);
+	}
+
+	get focusState(): PlanPreviewFocus {
+		return this.#focus;
+	}
+	get comments(): readonly PlanComment[] {
+		return this.#comments;
+	}
+	get pageOffset(): number {
+		return this.#scroll;
+	}
+	get sourceLine(): number {
+		return this.#sourceLine;
+	}
+	override render(width: number): string[] {
+		const height = Math.max(5, (process.stdout.rows || 40) - 8);
+		const bodyWidth = Math.max(1, width - 2);
+		const body = this.#renderSourceRows(bodyWidth);
+		this.#scroll = Math.max(0, Math.min(this.#scroll, Math.max(0, body.length - height)));
+		const visible = body.slice(this.#scroll, this.#scroll + height);
+		const actions = PLAN_REVIEW_ACTIONS.map(
+			(action, index) => `${this.#focus === "actionBar" && index === this.#actionIndex ? "▶ " : "  "}${action}`,
+		);
+		const actionBar = width < 40 ? actions : [actions.join("  ")];
+		const footer =
+			this.#focus === "commentInput"
+				? `${this.#inputKind === "notes" ? "Notes" : `Comment for source line ${this.#sourceLine}`} (Enter save, Esc cancel): ${this.#input.getValue()}`
+				: this.#focus === "sourceSelect"
+					? `Source line ${this.#sourceLine}/${this.lines.length || 1}  j/k:select  c:comment  Esc:done`
+					: `${this.#scroll + 1}-${Math.min(this.#scroll + height, body.length)}/${body.length || 1}  s:source line  n:notes  ${this.options.externalEditorKey ? `${this.options.externalEditorKey.toLowerCase()}:edit  ` : ""}Tab:actions  PgUp/PgDn:page`;
+
+		const rendered = [
+			new DynamicBorder().render(width)[0] ?? "",
+			` ${theme.bold(theme.fg("accent", "Plan review"))}`,
+			...visible.map(line => ` ${line}`),
+			"",
+			...actionBar.map(action => ` ${action}`),
+			` ${footer}`,
+			new DynamicBorder().render(width)[0] ?? "",
+		];
+		return rendered.map(line =>
+			!this.content && width < 40 && PLAN_REVIEW_ACTIONS.some(action => line.includes(action))
+				? line
+				: truncateToWidth(line, width),
+		);
+	}
+	handleMouse(event: MouseEvent): void {
+		if (event.kind !== "click" || this.#focus === "commentInput") return;
+		const renderedRow = this.#scroll + (event.localY ?? event.y) - 2;
+		const sourceLine = this.#renderedSourceLines[renderedRow];
+		if (sourceLine === undefined) return;
+		this.#sourceLine = sourceLine;
+		this.#focus = "sourceSelect";
+		this.requestRender();
+	}
+
+	handleInput(key: string): void {
+		if (this.#focus === "commentInput") {
+			if (matchesKey(key, "escape")) {
+				this.#focus = "preview";
+				this.#input.setValue("");
+				this.requestRender();
+				return;
+			}
+			this.#input.handleInput(key);
+			this.requestRender();
+			return;
+		}
+		if (matchesKey(key, "escape")) {
+			this.done({ comments: this.#comments, notes: this.#notes, snapshotHash: this.snapshotHash });
+			return;
+		}
+		if (this.#matchesExternalEditor(key)) {
+			void this.#openExternalEditor();
+			return;
+		}
+
+		if (matchesKey(key, "tab")) {
+			this.#focus = this.#focus === "actionBar" ? "preview" : "actionBar";
+			this.requestRender();
+			return;
+		}
+		if (this.#focus === "actionBar") {
+			if (matchesKey(key, "left") || matchesKey(key, "up")) this.#actionIndex = Math.max(0, this.#actionIndex - 1);
+			else if (matchesKey(key, "right") || matchesKey(key, "down"))
+				this.#actionIndex = Math.min(PLAN_REVIEW_ACTIONS.length - 1, this.#actionIndex + 1);
+			else if (matchesKey(key, "enter") || key === "\r")
+				this.done({
+					action: PLAN_REVIEW_ACTIONS[this.#actionIndex],
+					comments: this.#comments,
+
+					notes: this.#notes,
+					snapshotHash: this.snapshotHash,
+				});
+			this.requestRender();
+			return;
+		}
+		if (this.#focus === "sourceSelect") {
+			if (key === "j" || matchesKey(key, "down"))
+				this.#sourceLine = Math.min(this.lines.length || 1, this.#sourceLine + 1);
+			else if (key === "k" || matchesKey(key, "up")) this.#sourceLine = Math.max(1, this.#sourceLine - 1);
+			else if (key === "c") {
+				this.#inputKind = "comment";
+				this.#focus = "commentInput";
+			} else if (matchesKey(key, "enter")) this.#focus = "preview";
+			this.requestRender();
+			return;
+		}
+		if (key === "s") {
+			this.#focus = "sourceSelect";
+			this.requestRender();
+			return;
+		}
+		if (key === "c") {
+			this.#inputKind = "comment";
+			this.#focus = "commentInput";
+			this.requestRender();
+			return;
+		}
+		if (key === "n") {
+			this.#inputKind = "notes";
+			this.#focus = "commentInput";
+			this.requestRender();
+			return;
+		}
+		if (matchesKey(key, "pageDown")) this.#scroll += 15;
+		if (matchesKey(key, "pageUp")) this.#scroll -= 15;
+		this.requestRender();
+	}
+	#saveInput(text: string): void {
+		if (text.trim()) {
+			if (this.#inputKind === "notes") this.#notes = text;
+			else
+				this.#comments.push({
+					id: crypto.randomUUID(),
+					startLine: this.#sourceLine,
+					endLine: this.#sourceLine,
+					text,
+					snapshotHash: this.snapshotHash,
+					createdAt: Date.now(),
+				});
+		}
+		this.#input.setValue("");
+		this.#focus = "preview";
+		this.requestRender();
+	}
+	// Render numbered source rather than Markdown so every displayed row has an exact source-line owner.
+	#renderSourceRows(width: number): string[] {
+		if (!this.content) {
+			this.#renderedSourceLines = [];
+			this.#renderedBody = [theme.fg("warning", "Plan file is empty or missing.")];
+			this.#renderedBodyWidth = width;
+			return this.#renderedBody;
+		}
+		if (this.#renderedBodyWidth === width) return this.#renderedBody;
+
+		const lineNumberWidth = String(this.lines.length).length;
+		const prefixWidth = lineNumberWidth + 3;
+		const sourceWidth = Math.max(1, width - prefixWidth);
+		const body: string[] = [];
+		const sourceLines: number[] = [];
+		for (let index = 0; index < this.lines.length; index++) {
+			const prefix = `${String(index + 1).padStart(lineNumberWidth)} │ `;
+			const wrapped = Bun.wrapAnsi(this.lines[index]!.replace(/\r$/, ""), sourceWidth, {
+				hard: true,
+				trim: false,
+			});
+			const rows = wrapped ? wrapped.split("\n") : [""];
+			for (const row of rows) {
+				body.push(`${prefix}${row}`);
+				sourceLines.push(index + 1);
+			}
+		}
+		this.#renderedSourceLines = sourceLines;
+		this.#renderedBody = body;
+		this.#renderedBodyWidth = width;
+		return body;
+	}
+	#matchesExternalEditor(key: string): boolean {
+		return Boolean(
+			this.options.onExternalEditor && this.options.externalEditorKeys?.some(binding => matchesKey(key, binding)),
+		);
+	}
+	async #openExternalEditor(): Promise<void> {
+		const updatedContent = await this.options.onExternalEditor?.();
+		if (updatedContent === null || updatedContent === undefined || updatedContent === this.content) return;
+		this.content = updatedContent;
+		this.snapshotHash = planSnapshotHash(updatedContent);
+		this.lines = updatedContent.split("\n");
+		this.#renderedSourceLines = [];
+		this.#renderedBody = [];
+		this.#renderedBodyWidth = 0;
+		this.#comments = [];
+		this.#notes = "";
+		this.#scroll = 0;
+		this.#sourceLine = 1;
+		this.#focus = "preview";
+		this.requestRender();
+	}
+}