pi-lazy-panel 0.1.0

package/src/ui/widgets/help-overlay.ts

@@ -0,0 +1,220 @@
+/**
+ * Help overlay (`?`).
+ *
+ * A centered box drawn over the panel listing the bindings of the focused pane
+ * followed by the global ones. Pure rendering: given the resolved keymap and
+ * the focused pane, produce lines; the panel composites them over its own
+ * output with `overlayCentered` from ../frame.ts.
+ *
+ *   ┌─ HELP · Sessions pane ─────────────────────┐
+ *   │ j/↓          Move cursor down              │
+ *   │ gg/G         Go to top / bottom            │
+ *   │ ...                                        │
+ *   │ Global                                     │
+ *   │ h/l/Tab      Focus previous / next pane    │
+ *   │ 1..3         Focus pane by number          │
+ *   └─ ? / Esc close ─ j/k scroll ───────────────┘
+ *
+ * 帮助内容直接来自最终合并后的 keymap，所以用户自定义的键位会如实显示。
+ * 描述过长时按描述列宽度折行（续行的 keys 列留空），不再用 … 截断——键位说明是重要信息。
+ */
+
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { visibleWidth } from "@earendil-works/pi-tui";
+import { actionDescription, HELP_GROUPS, helpGroupText, isDisabledIn, scopeTitle } from "../../config/keymap.ts";
+import { labelsFor, scopeChain } from "../../config/keys.ts";
+import { t } from "../../i18n/index.ts";
+import type { ActionId, Keymap, KeyScope } from "../../types.ts";
+import { fit, frame, overlayCentered } from "../frame.ts";
+
+export interface HelpOverlayProps {
+	keymap: Keymap;
+	/** Scope the keys currently go to: the focused pane, or the tree dialog while it is open. */
+	focus: KeyScope;
+	/** First visible row of the help body (for long lists). */
+	scroll: number;
+	theme: Theme;
+}
+
+/** One line of the help body, either a section header or a binding. */
+export type HelpLine = { kind: "header"; text: string } | { kind: "binding"; keys: string; text: string } | { kind: "blank" };
+
+/** Build the help body for `focus`: its own bindings first, then each outer scope (pane → global; dialog → tree pane → global). */
+export function buildHelpLines(keymap: Keymap, focus: KeyScope): HelpLine[] {
+	const out: HelpLine[] = [];
+	for (const scope of scopeChain(focus)) {
+		if (out.length) out.push({ kind: "blank" });
+		out.push({ kind: "header", text: scopeTitle(scope) });
+		out.push(...buildScopeLines(keymap, scope, focus));
+	}
+	return out;
+}
+
+/**
+ * Binding lines of one scope. Actions that belong to a HELP_GROUPS entry are
+ * merged into one line (placed where the first bound member appears) as long as
+ * at least two members are bound in this scope. Outer-scope actions switched
+ * off in `focus` (see DISABLED_ACTIONS) are left out.
+ *
+ * 同组动作合并成一行；组内只剩一个绑定时退回单独一行，避免描述和键位对不上。
+ */
+function buildScopeLines(keymap: Keymap, scope: KeyScope, focus: KeyScope): HelpLine[] {
+	const out: HelpLine[] = [];
+	const consumed = new Set<ActionId>();
+	const bound = (a: ActionId) => labelsFor(keymap, scope, a).length > 0 && !(scope !== focus && isDisabledIn(focus, a));
+	const actions = (Object.keys(keymap[scope]) as ActionId[]).filter(bound);
+	for (const action of actions) {
+		if (consumed.has(action)) continue;
+		const labels = labelsFor(keymap, scope, action);
+
+		const group = HELP_GROUPS.find((g) => g.actions.includes(action));
+		const members = group ? group.actions.filter(bound) : [];
+		if (group && members.length >= 2) {
+			for (const m of members) consumed.add(m);
+			const keys = members.flatMap((m) => labelsFor(keymap, scope, m));
+			out.push({ kind: "binding", keys: compactKeys(keys), text: helpGroupText(group) });
+			continue;
+		}
+		out.push({ kind: "binding", keys: compactKeys(labels), text: actionDescription(action) });
+	}
+	return out;
+}
+
+/**
+ * Render a list of key labels compactly.
+ *   ["1","2","3"]      -> "1..3"      (3+ consecutive single characters)
+ *   ["d","t","u","L"]  -> "d/t/u/L"
+ *   ["j","↓"]          -> "j/↓"
+ */
+export function compactKeys(labels: string[]): string {
+	if (labels.length >= 3 && labels.every((l) => [...l].length === 1)) {
+		const codes = labels.map((l) => l.codePointAt(0)!);
+		const consecutive = codes.every((c, i) => i === 0 || c === codes[i - 1]! + 1);
+		if (consecutive) return `${labels[0]}..${labels[labels.length - 1]}`;
+	}
+	return labels.join("/");
+}
+
+/** A concrete rendered row of the help body, after wrapping long descriptions. */
+type HelpRenderRow = { kind: "header"; text: string } | { kind: "blank" } | { kind: "binding"; keys: string; text: string };
+
+/**
+ * Word-wrap `text` into lines of at most `width` visible columns. Words that do
+ * not fit on a line of their own are hard-broken by columns.
+ *
+ * 帮助描述按可见宽度折行：英文按空格断词，单词超宽再按列硬断；中文描述通常够短、不折行。
+ */
+function wrapText(text: string, width: number): string[] {
+	if (width <= 0) return [text];
+	const out: string[] = [];
+	let cur = "";
+	for (const word of text.split(/\s+/).filter(Boolean)) {
+		const candidate = cur ? `${cur} ${word}` : word;
+		if (visibleWidth(candidate) <= width) {
+			cur = candidate;
+			continue;
+		}
+		if (cur) out.push(cur);
+		// 单词自身就超过一行：按可见列硬断成多段。
+		let rest = word;
+		while (visibleWidth(rest) > width) {
+			let take = "";
+			for (const ch of [...rest]) {
+				if (visibleWidth(take + ch) > width) break;
+				take += ch;
+			}
+			out.push(take);
+			rest = rest.slice(take.length);
+		}
+		cur = rest;
+	}
+	if (cur) out.push(cur);
+	return out.length ? out : [""];
+}
+
+/**
+ * Expand the logical help lines into concrete rendered rows for a box whose
+ * inner width is `inner`: a binding's description is wrapped onto continuation
+ * rows (with a blank key column) instead of being truncated. `keyColW` is the
+ * shared width of the key column.
+ *
+ * keyColW / inner 都是终端宽度的确定函数，所以行数在 helpBoxSize、renderHelpBox、
+ * helpLineCount 三处算出来一致，滚动和高度不会对不上。
+ */
+function helpLayout(keymap: Keymap, focus: KeyScope, inner: number): { rows: HelpRenderRow[]; keyColW: number } {
+	const lines = buildHelpLines(keymap, focus);
+	const keyColW = Math.min(16, Math.max(8, ...lines.map((l) => (l.kind === "binding" ? visibleWidth(l.keys) : 0))) + 1);
+	// 描述列可用宽度 = 内宽 - 前导空格 - keys 列 - keys 后的一个空格。
+	const descW = Math.max(1, inner - keyColW - 2);
+	const rows: HelpRenderRow[] = [];
+	for (const line of lines) {
+		if (line.kind === "blank") {
+			rows.push({ kind: "blank" });
+		} else if (line.kind === "header") {
+			rows.push({ kind: "header", text: line.text });
+		} else {
+			// 首行带 keys，续行 keys 列留空、描述接着往下排。
+			wrapText(line.text, descW).forEach((seg, i) => rows.push({ kind: "binding", keys: i === 0 ? line.keys : "", text: seg }));
+		}
+	}
+	return { rows, keyColW };
+}
+
+/** Width of the help box for a `termW`-column terminal. */
+export function helpBoxWidth(termW: number): number {
+	return Math.max(30, Math.min(termW - 4, 64));
+}
+
+/** Size of the box for a given terminal size (height grows with the wrapped row count). */
+export function helpBoxSize(termW: number, termH: number, keymap: Keymap, focus: KeyScope): { width: number; height: number } {
+	const width = helpBoxWidth(termW);
+	const rowCount = helpLayout(keymap, focus, width - 2).rows.length;
+	// +2 for borders
+	const height = Math.max(6, Math.min(termH - 2, rowCount + 2));
+	return { width, height };
+}
+
+/** Render the help box itself (lines of exactly `width`). */
+export function renderHelpBox(p: HelpOverlayProps, width: number, height: number): string[] {
+	const { theme } = p;
+	const inner = width - 2;
+	const { rows, keyColW } = helpLayout(p.keymap, p.focus, inner);
+	const visible = Math.max(1, height - 2);
+	const maxScroll = Math.max(0, rows.length - visible);
+	const start = Math.min(Math.max(0, p.scroll), maxScroll);
+
+	const body: string[] = [];
+	for (const row of rows.slice(start, start + visible)) {
+		if (row.kind === "blank") {
+			body.push("");
+		} else if (row.kind === "header") {
+			body.push(" " + theme.bold(theme.fg("accent", row.text)));
+		} else {
+			// 续行的 keys 为空，只占位对齐；描述由 helpLayout 折过行，这里不再截断。
+			const keys = fit(row.keys ? theme.fg("warning", row.keys) : "", keyColW);
+			body.push(` ${keys} ${theme.fg("text", row.text)}`);
+		}
+	}
+
+	const more = maxScroll > 0 ? ` ${start + 1}-${Math.min(rows.length, start + visible)}/${rows.length}` : "";
+	return frame(body, {
+		width,
+		height,
+		title: `${t("help.titlePrefix")} · ${scopeTitle(p.focus)}`,
+		meta: `${t("help.closeHint")}${maxScroll > 0 ? ` · ${t("help.scrollHint")}` : ""}${more}`,
+		border: (s) => theme.fg("borderAccent", s),
+		titleStyle: (s) => theme.bold(theme.fg("accent", s)),
+		metaStyle: (s) => theme.fg("dim", s),
+	});
+}
+
+/** Composite the help box centered over already-rendered panel `lines`. */
+export function overlayHelp(lines: string[], p: HelpOverlayProps, termW: number): string[] {
+	const { width, height } = helpBoxSize(termW, lines.length, p.keymap, p.focus);
+	return overlayCentered(lines, renderHelpBox(p, width, height), width, termW);
+}
+
+/** Number of rendered help rows (wrapping included), used by the panel to clamp help scrolling. */
+export function helpLineCount(keymap: Keymap, focus: KeyScope, termW: number): number {
+	return helpLayout(keymap, focus, helpBoxWidth(termW) - 2).rows.length;
+}

package/src/ui/widgets/import-dialog.ts

@@ -0,0 +1,32 @@
+/**
+ * Import prompt (`I` in the sessions pane, what pi's `/import` does): the title
+ * and footer hints ./input-dialog.ts shows while asking for a session JSONL.
+ *
+ * After Enter the panel asks for confirmation (./confirm-dialog.ts, like pi's
+ * "Replace current session with …?"), then the actions layer copies the file
+ * into the session directory and switches pi to it; the panel closes.
+ *
+ * 导入只是通用输入弹窗（InputDialog）的一个预设：输入 JSONL 路径（相对路径按 pi 的工作目录、
+ * 支持 ~），回车后确认，再复制进会话目录并切过去。
+ */
+
+import { t } from "../../i18n/index.ts";
+import type { KeyHint } from "../../types.ts";
+
+/** Title on the top border of the box. */
+export function importDialogTitle(): string {
+	return t("dialog.importTitle");
+}
+
+/** Right end of the title bar: what the prompt wants. */
+export function importDialogSubject(): string {
+	return t("dialog.importSubject");
+}
+
+/** Footer hints while the dialog is open. */
+export function importDialogHints(): KeyHint[] {
+	return [
+		["Enter", t("hint.import")],
+		["Esc", t("hint.cancel")],
+	];
+}

package/src/ui/widgets/input-dialog.ts

@@ -0,0 +1,136 @@
+/**
+ * Input dialog — a one-line text field in a box centered over the panel,
+ * like lazygit's commit-message popup:
+ *
+ *   ┌─ Label ──────────────────────── user: hi ─┐
+ *   │ checkpoint▏                                │
+ *   └────────────────────────────────────────────┘
+ *    LABEL │ Enter save   Esc cancel   empty removes      <- footer while open
+ *
+ * Generic: the caller passes a title, the pre-filled value, an optional
+ * subject for the title bar and the callbacks on each `open`, so the same
+ * widget serves node labels (`T`), session renames and any later prompt. The
+ * dialog only collects text and draws the box; key hints go to the footer
+ * (see `hints`), like lazygit.
+ *
+ * 通用的居中单行输入弹窗：包装 pi-tui `Input`，标题 / 预填值 / 右上角说明 / 回调都在 open 时传入，
+ * 打标签、给 session 起名等场景共用同一个组件；快捷键提示由 app.ts 放在底部 footer。
+ */
+
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { Input, truncateToWidth } from "@earendil-works/pi-tui";
+import type { KeyHint } from "../../types.ts";
+import { dialogWidth, frame, metaBudget, overlayCentered } from "../frame.ts";
+
+/** Box height: top border, input, bottom border. */
+export const INPUT_DIALOG_HEIGHT = 3;
+
+/** Legacy "End" key sequence; pi-tui's `Input` maps it to "move to line end". */
+const END_KEY = "\x1b[F";
+
+/** What one prompt looks like; passed to `open`. */
+export interface InputDialogSpec {
+	/** Title on the top border, e.g. "Label" / "Rename". */
+	title: string;
+	/** Pre-filled text; the cursor starts at its end. */
+	value?: string;
+	/** One-line description shown at the right end of the title bar (e.g. the node being labelled). */
+	subject?: string;
+	/** Footer hints while this prompt is open. */
+	hints: KeyHint[];
+	onSubmit: (value: string) => void;
+	onCancel: () => void;
+}
+
+export interface InputDialogOptions {
+	theme: Theme;
+	/** Called after every keystroke so the panel can re-render. */
+	onChange: () => void;
+}
+
+export class InputDialog {
+	private input: Input;
+	private spec: InputDialogSpec | undefined;
+	private _focused = false;
+
+	constructor(private readonly o: InputDialogOptions) {
+		this.input = new Input({ prompt: "" });
+	}
+
+	/** Focusable propagation (IME cursor): mirrored from the root component. */
+	get focused(): boolean {
+		return this._focused;
+	}
+	set focused(v: boolean) {
+		this._focused = v;
+		this.input.focused = v;
+	}
+
+	/** True between `open` and `close`. */
+	get isOpen(): boolean {
+		return this.spec !== undefined;
+	}
+
+	/** Footer hints of the current prompt (empty when closed). */
+	get hints(): KeyHint[] {
+		return this.spec?.hints ?? [];
+	}
+
+	/** Start a prompt: a fresh field pre-filled with `spec.value`. */
+	open(spec: InputDialogSpec): void {
+		this.spec = spec;
+		this.input = this.createInput(spec.value ?? "");
+		this.input.focused = this._focused;
+	}
+
+	/** Drop the current prompt without firing a callback. */
+	close(): void {
+		this.spec = undefined;
+	}
+
+	getValue(): string {
+		return this.input.getValue();
+	}
+
+	handleInput(data: string): void {
+		this.input.handleInput(data);
+		this.o.onChange();
+	}
+
+	/** Render the box itself, every line exactly `width` columns. */
+	render(width: number): string[] {
+		const { theme } = this.o;
+		const title = this.spec?.title ?? "";
+		const inner = width - 2;
+		// 输入行左侧留一列空白，光标不会贴着边框。
+		const field = ` ${this.input.render(Math.max(1, inner - 2))[0] ?? ""}`;
+		// 标题和说明之间至少留 3 个 ─，否则两者会贴在一起。
+		const meta = truncateToWidth(this.spec?.subject ?? "", metaBudget(width, title) - 3, "…", false);
+		return frame([field], {
+			width,
+			height: INPUT_DIALOG_HEIGHT,
+			title,
+			...(meta ? { meta } : {}),
+			border: (s) => theme.fg("borderAccent", s),
+			titleStyle: (s) => theme.bold(theme.fg("accent", s)),
+			metaStyle: (s) => theme.fg("dim", s),
+		});
+	}
+
+	/** Composite the box centered over the already-rendered panel `lines`. */
+	overlay(lines: string[], termW: number): string[] {
+		const width = dialogWidth(termW);
+		return overlayCentered(lines, this.render(width), width, termW);
+	}
+
+	/** New input wired to the current spec; `setValue` leaves the cursor at 0, so move it to the end. */
+	private createInput(value: string): Input {
+		const input = new Input({ prompt: "" });
+		// 回调走 this.spec，而不是捕获当时的 spec：open 换了 spec 后旧 Input 也不会再被用到。
+		input.onSubmit = (v) => this.spec?.onSubmit(v);
+		input.onEscape = () => this.spec?.onCancel();
+		input.setValue(value);
+		if (value) input.handleInput(END_KEY);
+		return input;
+	}
+}

package/src/ui/widgets/label-dialog.ts

@@ -0,0 +1,28 @@
+/**
+ * Label prompt (`T` in the tree pane, same as `Shift+T` in pi's `/tree`):
+ * the title and footer hints that ./input-dialog.ts shows while labelling.
+ *
+ * The panel owns the target node and persists the change through the injected
+ * actions; the pre-filled value is the node's current label and an empty
+ * submission clears it.
+ *
+ * 打标签只是通用输入弹窗（InputDialog）的一个预设：这里只放标题和 footer 提示，
+ * 其他场景（比如给 session 起名）照此再写一个预设即可。
+ */
+
+import { t } from "../../i18n/index.ts";
+import type { KeyHint } from "../../types.ts";
+
+/** Title on the top border of the box. */
+export function labelDialogTitle(): string {
+	return t("dialog.labelTitle");
+}
+
+/** Footer hints while the dialog is open. */
+export function labelDialogHints(): KeyHint[] {
+	return [
+		["Enter", t("hint.save")],
+		["Esc", t("hint.cancel")],
+		[t("hint.emptyKey"), t("hint.removes")],
+	];
+}

package/src/ui/widgets/new-session-dialog.ts

@@ -0,0 +1,29 @@
+/**
+ * New-session prompt (`n` in the sessions pane, what `/new` does): the title and
+ * footer hints ./input-dialog.ts shows while naming a new session, same idea as
+ * ./rename-dialog.ts.
+ *
+ * The name is optional — an empty submission starts an unnamed session (pi's
+ * `/name` [name] argument is left unset). The panel starts the session through
+ * the injected actions and closes.
+ *
+ * 新建会话只是通用输入弹窗（InputDialog）的一个预设：标题 + 提示；名字可留空
+ * （对应 /name 的可选 [name] 参数，空则不设置），回车新建并关闭面板。
+ */
+
+import { t } from "../../i18n/index.ts";
+import type { KeyHint } from "../../types.ts";
+
+/** Title on the top border of the box. */
+export function newSessionDialogTitle(): string {
+	return t("dialog.newTitle");
+}
+
+/** Footer hints while the dialog is open. */
+export function newSessionDialogHints(): KeyHint[] {
+	return [
+		["Enter", t("hint.create")],
+		["Esc", t("hint.cancel")],
+		[t("hint.emptyKey"), t("hint.noName")],
+	];
+}

package/src/ui/widgets/prompt-bar.ts

@@ -0,0 +1,92 @@
+/**
+ * Prompt bar — a one-line text prompt that replaces the footer row.
+ *
+ *   <label>foo▏                              Enter <ok>  Esc <cancel>
+ *
+ * Generic building block behind the search bar (`/`). Wraps pi-tui's `Input`
+ * so cursor movement, word deletion, paste and the kill-ring come for free.
+ * The bar only owns rendering + the input widget; the panel decides what to do
+ * on submit / cancel. (Labelling a tree node uses the centered
+ * ./input-dialog.ts instead.)
+ *
+ * 底部一行式输入框：搜索栏用它，只负责画和收键，语义由 app.ts 决定。
+ */
+
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { Input, visibleWidth } from "@earendil-works/pi-tui";
+import type { KeyHint } from "../../types.ts";
+import { fit } from "../frame.ts";
+
+/** Legacy "End" key sequence; pi-tui's `Input` maps it to "move to line end". */
+const END_KEY = "\x1b[F";
+
+/** One `key description` pair shown at the right end of the bar. */
+export type PromptHint = KeyHint;
+
+export interface PromptBarOptions {
+	theme: Theme;
+	/** Text in front of the input, e.g. "搜索: ". */
+	label: string;
+	/** Hints rendered after the field; dropped when the terminal is too narrow. */
+	hints: PromptHint[];
+	onSubmit: (value: string) => void;
+	onCancel: () => void;
+	/** Called after every keystroke so the panel can re-render. */
+	onChange: () => void;
+}
+
+export class PromptBar {
+	private readonly input: Input;
+	private _focused = false;
+
+	constructor(private readonly o: PromptBarOptions) {
+		// 前面已经有自己的 label（如 "搜索: "），去掉 pi-tui Input 默认的 "> " 提示符。
+		this.input = new Input({ prompt: "" });
+		this.input.onSubmit = (v) => this.o.onSubmit(v);
+		this.input.onEscape = () => this.o.onCancel();
+	}
+
+	/** Focusable propagation (IME cursor): mirrored from the root component. */
+	get focused(): boolean {
+		return this._focused;
+	}
+	set focused(v: boolean) {
+		this._focused = v;
+		this.input.focused = v;
+	}
+
+	getValue(): string {
+		return this.input.getValue();
+	}
+
+	/** Reset the field, optionally pre-filled; `cursorAtEnd` puts the cursor after the text instead of in front of it. */
+	reset(value = "", cursorAtEnd = false): void {
+		this.input.setValue(value);
+		// setValue 把光标留在开头；要接着往后打字（对话框里再按 / 编辑已有的查询）就移到末尾。
+		if (cursorAtEnd && value) this.input.handleInput(END_KEY);
+	}
+
+	handleInput(data: string): void {
+		this.input.handleInput(data);
+		this.o.onChange();
+	}
+
+	/** Render the bar as one line of exactly `width`. */
+	render(width: number): string[] {
+		const { theme } = this.o;
+		const label = theme.bold(theme.fg("accent", this.o.label));
+		const hint = this.o.hints.map(([k, t]) => `${theme.fg("dim", k)} ${theme.fg("muted", t)}`).join("  ");
+		const hintW = visibleWidth(hint);
+		const labelW = visibleWidth(this.o.label);
+		let inputW = width - labelW - hintW - 2;
+		let showHint = hint.length > 0;
+		// 太窄就放弃提示，把宽度都留给输入框。
+		if (inputW < 10) {
+			showHint = false;
+			inputW = Math.max(1, width - labelW);
+		}
+		const field = this.input.render(inputW)[0] ?? "";
+		const line = showHint ? `${label}${fit(field, inputW)}  ${hint}` : `${label}${field}`;
+		return [fit(line, width)];
+	}
+}

package/src/ui/widgets/rename-dialog.ts

@@ -0,0 +1,29 @@
+/**
+ * Rename prompt (`r` in the sessions pane, what `/name` and ctrl+r in pi's
+ * `/resume` do): the title and footer hints that ./input-dialog.ts shows while
+ * renaming, same idea as ./label-dialog.ts.
+ *
+ * The panel owns the target session and persists the change through the
+ * injected actions; the pre-filled value is the session's current name and an
+ * empty submission clears it (the row falls back to its first-message preview).
+ *
+ * 给会话起名只是通用输入弹窗（InputDialog）的一个预设：标题 + footer 提示；
+ * 弹窗标题右侧显示被改名的会话（首条消息预览），空值清除名称。
+ */
+
+import { t } from "../../i18n/index.ts";
+import type { KeyHint } from "../../types.ts";
+
+/** Title on the top border of the box. */
+export function renameDialogTitle(): string {
+	return t("dialog.renameTitle");
+}
+
+/** Footer hints while the dialog is open. */
+export function renameDialogHints(): KeyHint[] {
+	return [
+		["Enter", t("hint.save")],
+		["Esc", t("hint.cancel")],
+		[t("hint.emptyKey"), t("hint.removes")],
+	];
+}

package/src/ui/widgets/restore-dialog.ts

@@ -0,0 +1,60 @@
+/**
+ * Restore presets (`Enter` in the tree pane, same flow as pi's `/tree`): the
+ * "Summarize branch?" menu shown through ./select-dialog.ts and the custom
+ * instructions prompt shown through ./input-dialog.ts.
+ *
+ * The panel owns the target node and hands the choice to the injected
+ * actions as `RestoreOptions`; this module only holds the wording, the order
+ * of the entries and the footer hints.
+ *
+ * TREE Enter 的两个弹窗都是通用组件的预设：三选菜单（No summary / Summarize /
+ * Summarize with custom prompt，和 pi 内置 /tree 的顺序一致）和自定义摘要指令的输入框。
+ */
+
+import { t } from "../../i18n/index.ts";
+import type { KeyHint } from "../../types.ts";
+
+/** What the user picked in the menu. */
+export type SummaryChoice = "none" | "summarize" | "custom";
+
+/** Menu choices in pi's order; the picked index maps to `choice`. */
+export const SUMMARY_CHOICES: readonly SummaryChoice[] = ["none", "summarize", "custom"];
+
+/** Title on the top border of the menu (pi's wording, localised). */
+export function summaryMenuTitle(): string {
+	return t("dialog.restoreMenuTitle");
+}
+
+/** Menu entries in pi's order, localised; the picked index maps to `choice`. */
+export function summaryMenu(): ReadonlyArray<{ label: string; choice: SummaryChoice }> {
+	return [
+		{ label: t("dialog.restoreNone"), choice: "none" },
+		{ label: t("dialog.restoreSummarize"), choice: "summarize" },
+		{ label: t("dialog.restoreCustom"), choice: "custom" },
+	];
+}
+
+/** Footer hints while the menu is open. */
+export function summaryMenuHints(): KeyHint[] {
+	return [
+		["j/k", t("hint.move")],
+		["Enter", t("hint.select")],
+		["Esc", t("hint.cancel")],
+	];
+}
+
+/** Where the menu reopens after Esc in the custom prompt (pi loops back to the selector). */
+export const CUSTOM_PROMPT_INDEX = SUMMARY_CHOICES.indexOf("custom");
+
+/** Title of the custom instructions prompt (pi's wording, localised). */
+export function customPromptTitle(): string {
+	return t("dialog.restoreCustomTitle");
+}
+
+/** Footer hints while the custom prompt is open. */
+export function customPromptHints(): KeyHint[] {
+	return [
+		["Enter", t("hint.summarize")],
+		["Esc", t("hint.back")],
+	];
+}