@foolsecret/pi-prompt 0.4.0 → 0.4.8

package/src/draft.ts

@@ -0,0 +1,178 @@
+/**
+ * 配置草稿层（draft）：抽屉内所有编辑先改**内存**，Ctrl+S 时统一落盘。
+ *
+ * 为什么需要这一层（对齐姊妹项目 pi-pricer 的 PricingDraft）：
+ *   - 用户要"先改内存、Ctrl+S 保存"的可撤销中间态；
+ *   - 保存前可以整体丢弃（Ctrl+R），误改不会立刻落盘；
+ *   - 纯逻辑无 TUI 依赖，可直接单测。
+ *
+ * 与 pi-pricer 的差异：pi-pricer 保存前要跑引用完整性校验（删价格可能被方案引用），
+ * pi-prompt 的配置是扁平 JSON、无跨字段引用，故校验只需"值域合法"。
+ *
+ * ⚠️ 会话三轴（show/write/do）不在配置文件里，而是落会话条目（prompt-axes）。
+ *    save() 必须**两处都落**，否则"未保存"语义是假的（轴改了却没保存）。
+ */
+
+import type { PromptConfigFile, ToolOutputConfig } from "./config.ts";
+import type { DoMode, ShowMode, WriteMode } from "./modes.ts";
+
+/** 三轴取值（会话档） */
+export interface SessionAxes {
+	show: ShowMode;
+	write: WriteMode;
+	do: DoMode;
+}
+
+/** 保存结果：ok=false 时 reason 说明原因 */
+export interface DraftSaveResult {
+	ok: boolean;
+	reason: string;
+}
+
+/** 草稿层的落盘接口（由接线层注入，避免 draft 直接依赖 fs / session） */
+export interface DraftPersist {
+	/** 写入配置文件的已知字段（合并写，保留未展示字段） */
+	writeConfig(patch: Partial<PromptConfigFile>): boolean;
+	/** 写入会话三轴（落会话条目） */
+	writeSessionAxes(axes: SessionAxes): void;
+}
+
+/** 变更面（状态栏展示用；中文名与抽屉分类一致） */
+export type ChangeArea = "风格" | "代码" | "行动" | "工具" | "上下文" | "其他";
+
+/** 数值参数名（与 config 的 writeNumber 一致） */
+export type NumberName =
+	| "maxTokensCap"
+	| "autoSampleInterval"
+	| "autoSampleMaxPerDay"
+	| "hysteresis"
+	| "autoCompactMaxTokens"
+	| "autoCompactPercent"
+	| "autoCompactMinTurns";
+
+/** 布尔开关名（toolOutput 是嵌套的，单独处理） */
+export type FlagName = "peakUpgrade" | "quietStartup" | "hideStatus" | "autoSample" | "autoCompact";
+
+/** 工具名 */
+export type ToolName = "grep" | "read" | "bash" | "default";
+
+/**
+ * 编辑会话：持有配置的深拷贝 + 会话三轴暂存 + 变更记账。
+ * 所有 set* 方法只改内存；save() 才写盘；reset() 从磁盘重读。
+ */
+export class PromptDraft {
+	/** 内存态配置（深拷贝，与磁盘解耦） */
+	private config: PromptConfigFile;
+	/** 内存态会话三轴 */
+	private axes: SessionAxes;
+	/** 自加载以来变更过的面 */
+	private changed = new Set<ChangeArea>();
+
+	constructor(
+		initialConfig: PromptConfigFile,
+		initialAxes: SessionAxes,
+		private readonly persist: DraftPersist,
+	) {
+		this.config = structuredClone(initialConfig);
+		this.axes = { ...initialAxes };
+	}
+
+	/**
+	 * 当前内存态（只读用途：渲染）。
+	 * 返回**防御性拷贝**：否则调用方（readState/测试）拿到内部引用后一改
+	 * 就会静默篡改草稿状态。
+	 */
+	snapshot(): { config: PromptConfigFile; axes: SessionAxes } {
+		return { config: structuredClone(this.config), axes: { ...this.axes } };
+	}
+
+	/** 是否有未保存改动 */
+	get isDirty(): boolean {
+		return this.changed.size > 0;
+	}
+
+	/** 未保存改动涉及的面（状态栏展示） */
+	get changedAreas(): ChangeArea[] {
+		return [...this.changed].sort();
+	}
+
+	private mark(area: ChangeArea): void {
+		this.changed.add(area);
+	}
+
+	// ── 会话三轴 ─────────────────────────────────────────────────────────
+
+	/** 设置会话档（show/write/do） */
+	setAxis(axis: keyof SessionAxes, value: string): boolean {
+		this.axes = { ...this.axes, [axis]: value as never };
+		this.mark(axis === "show" ? "风格" : axis === "write" ? "代码" : "行动");
+		return true;
+	}
+
+	// ── 默认档 ───────────────────────────────────────────────────────────
+
+	/** 设置新会话默认档（写配置字段） */
+	setDefaultAxis(axis: keyof SessionAxes, value: string): boolean {
+		const key = axis === "show" ? "defaultShow" : axis === "write" ? "defaultWrite" : "defaultDo";
+		this.config = { ...this.config, [key]: value };
+		this.mark(axis === "show" ? "风格" : axis === "write" ? "代码" : "行动");
+		return true;
+	}
+
+	// ── 开关 / 数值 / 工具上限 ───────────────────────────────────────────
+
+	/** 设置顶层布尔开关；toolOutput 是嵌套字段，走 setToolOutputEnabled */
+	setFlag(name: FlagName | "toolOutput", value: boolean): boolean {
+		if (name === "toolOutput") return this.setToolOutputEnabled(value);
+		this.config = { ...this.config, [name]: value };
+		this.mark(name === "autoCompact" ? "上下文" : name === "autoSample" ? "其他" : "其他");
+		return true;
+	}
+
+	/** 设置工具输出截断总开关（嵌套 toolOutput.enabled） */
+	setToolOutputEnabled(value: boolean): boolean {
+		this.config = { ...this.config, toolOutput: { ...this.config.toolOutput, enabled: value } };
+		this.mark("工具");
+		return true;
+	}
+
+	/** 设置数值参数（校验：非负；百分比必须在 0~1） */
+	setNumber(name: NumberName, value: number): boolean {
+		if (!Number.isFinite(value) || value < 0) return false;
+		if (name === "autoCompactPercent" && value >= 1) return false;
+		this.config = { ...this.config, [name]: value };
+		this.mark(name.startsWith("autoCompact") ? "上下文" : name === "maxTokensCap" ? "工具" : "其他");
+		return true;
+	}
+
+	/** 设置某工具的输出上限（0 = 不截） */
+	setToolCap(tool: ToolName, value: number): boolean {
+		if (!Number.isFinite(value) || value < 0) return false;
+		const toolOutput: ToolOutputConfig = { ...this.config.toolOutput, [tool]: value };
+		this.config = { ...this.config, toolOutput };
+		this.mark("工具");
+		return true;
+	}
+
+	// ── 提交 / 放弃 ──────────────────────────────────────────────────────
+
+	/**
+	 * 落盘：配置字段 + 会话三轴**都要写**（见文件头 ⚠️）。
+	 * 无改动时直接返回成功（幂等，Ctrl+S 空按不报错）。
+	 */
+	save(): DraftSaveResult {
+		if (!this.isDirty) return { ok: true, reason: "" };
+		const ok = this.persist.writeConfig(this.config);
+		if (!ok) return { ok: false, reason: "配置写入失败" };
+		this.persist.writeSessionAxes({ ...this.axes });
+		this.changed.clear();
+		return { ok: true, reason: "" };
+	}
+
+	/** 丢弃所有未保存改动（回到构造时的初值 = 磁盘态） */
+	reset(initialConfig: PromptConfigFile, initialAxes: SessionAxes): void {
+		this.config = structuredClone(initialConfig);
+		this.axes = { ...initialAxes };
+		this.changed.clear();
+	}
+}

package/src/info-page.ts

@@ -0,0 +1,115 @@
+/**
+ * 只读信息页：把结构化说明以 **Markdown 排版**渲染，自带固定高度滚动窗口。
+ * （移植自姊妹项目 pi-pricer 的 pricing-info-page.ts，行为对齐。）
+ *
+ * 为什么需要它：`ctx.ui.notify` 只接受纯文本，长内容既无样式层级也不可滚动，
+ * 而 `##` 这类 Markdown 语法会**原样显示**。本组件统一成
+ * "Markdown 内容 + 自滚动窗口"一条通路。
+ *
+ * ⚠ 标题显示为字面 `##` 的根因：给 `Markdown` 传了内容但**没传 MarkdownTheme**
+ *   （或 theme 缺 heading）时标题不会套样式。故 buildMarkdownTheme 必须把
+ *   `heading` 映射到 `theme.fg("mdHeading", bold(text))`，其余标记同理。
+ */
+
+import { getKeybindings, Markdown, type Component, type MarkdownTheme } from "@earendil-works/pi-tui";
+
+/** 信息页固定显示的最大行数（跟随 SettingsList 自限高惯例，不侵入布局系统） */
+export const MAX_INFO_LINES = 16;
+
+/** 抽屉主题（fg/bold 的最小依赖面；由 pi 的 ctx.ui.custom factory 注入真实色板） */
+export interface DrawerTheme {
+	fg: (color: string, text: string) => string;
+	bold: (text: string) => string;
+}
+
+/**
+ * 把 DrawerTheme 映射成 pi-tui MarkdownTheme。
+ * 标题用 mdHeading、代码用 mdCode / mdCodeBlock，正文继承默认样式。
+ */
+export function buildMarkdownTheme(theme: DrawerTheme): MarkdownTheme {
+	return {
+		heading: (text: string) => theme.fg("mdHeading", theme.bold(text)),
+		link: (text: string) => theme.fg("mdLink", text),
+		linkUrl: (text: string) => theme.fg("mdLinkUrl", text),
+		code: (text: string) => theme.fg("mdCode", text),
+		codeBlock: (text: string) => theme.fg("mdCodeBlock", text),
+		codeBlockBorder: (text: string) => theme.fg("mdCodeBlockBorder", text),
+		quote: (text: string) => theme.fg("mdQuote", text),
+		quoteBorder: (text: string) => theme.fg("mdQuoteBorder", text),
+		hr: (text: string) => theme.fg("mdHr", text),
+		listBullet: (text: string) => theme.fg("mdListBullet", text),
+		bold: (text: string) => theme.bold(text),
+		italic: (text: string) => theme.fg("muted", text),
+		strikethrough: (text: string) => theme.fg("dim", text),
+		underline: (text: string) => text,
+	};
+}
+
+/** 只读信息页：Markdown 渲染 + 固定高度窗口 + 内部滚动；Esc 走 goBack */
+export class InfoPage implements Component {
+	/** 已渲染的完整内容行缓存（Markdown 按宽度折行，宽变才重渲） */
+	private cache: { width: number; lines: string[] } | null = null;
+	private scrollTop = 0;
+	private readonly markdown: Markdown;
+
+	constructor(
+		content: string,
+		private readonly theme: DrawerTheme,
+		private readonly goBack: () => void,
+		/** 页脚注（dim 渲染在提示条下方，说明本页关键上下文） */
+		private readonly notes: string[] = [],
+	) {
+		this.markdown = new Markdown(content, 1, 0, buildMarkdownTheme(theme));
+	}
+
+	/** 取完整内容行（按 width 缓存） */
+	private allLines(width: number): string[] {
+		if (this.cache?.width === width) return this.cache.lines;
+		const lines = this.markdown.render(width);
+		this.cache = { width, lines };
+		return lines;
+	}
+
+	/** 内容总行数（用于滚动边界） */
+	private maxTop(): number {
+		const total = this.cache ? this.cache.lines.length : 0;
+		return Math.max(0, total - MAX_INFO_LINES);
+	}
+
+	render(width: number): string[] {
+		const lines = this.allLines(width);
+		if (this.scrollTop > this.maxTop()) this.scrollTop = this.maxTop();
+		const window = lines.slice(this.scrollTop, this.scrollTop + MAX_INFO_LINES);
+		const hint = this.theme.fg("dim", "  ↑↓ 滚动 · PgUp/PgDn 翻页 · Esc 返回");
+		const out = [...window, hint];
+		for (const n of this.notes) out.push(this.theme.fg("dim", `  ${n}`));
+		return out;
+	}
+
+	handleInput(data: string): void {
+		const kb = getKeybindings();
+		if (kb.matches(data, "tui.select.cancel")) {
+			this.goBack();
+			return;
+		}
+		const maxTop = this.maxTop();
+		if (kb.matches(data, "tui.select.up")) {
+			this.scrollTop = Math.max(0, this.scrollTop - 1);
+		} else if (kb.matches(data, "tui.select.down")) {
+			this.scrollTop = Math.min(maxTop, this.scrollTop + 1);
+		} else if (kb.matches(data, "tui.select.pageUp") || kb.matches(data, "tui.altScreen.pageUp") || kb.matches(data, "tui.editor.pageUp")) {
+			this.scrollTop = Math.max(0, this.scrollTop - MAX_INFO_LINES);
+		} else if (kb.matches(data, "tui.select.pageDown") || kb.matches(data, "tui.altScreen.pageDown") || kb.matches(data, "tui.editor.pageDown")) {
+			this.scrollTop = Math.min(maxTop, this.scrollTop + MAX_INFO_LINES);
+		} else if (kb.matches(data, "tui.altScreen.top") || kb.matches(data, "tui.editor.cursorLineStart")) {
+			this.scrollTop = 0;
+		} else if (kb.matches(data, "tui.altScreen.bottom") || kb.matches(data, "tui.editor.cursorLineEnd")) {
+			this.scrollTop = maxTop;
+		}
+	}
+
+	invalidate(): void {
+		this.cache = null;
+		this.markdown.invalidate();
+	}
+}