@herbertgao/pi-extensions 2026.9.19 → 2026.10.0

package/node_modules/@herbertgao/pi-cc-extensions/extensions/config/config.ts

@@ -1,16 +1,49 @@
+import type { ThemeBg } from "@earendil-works/pi-coding-agent";
 import type { CompactThinkingConfig } from "../feature/compact-thinking.ts";
 import {
-	DEFAULT_TOOL_DISPLAY_CONFIG,
-	type DiffIndicatorMode,
-	type DiffViewMode,
-	type ToolDisplayConfig,
-} from "../renderer/tool/diff/index.ts";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
+	DEFAULT_FOOTER_CHIP_LAYOUT,
+	formatFooterChipSummary,
+	normalizeFooterChipLayout,
+} from "../feature/shell/footer-layout.ts";
+import { existsSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 
 export type CompactStyleMode = "on" | "compact" | "off";
 
+export type DiffViewMode = "auto" | "split" | "unified";
+export type DiffIndicatorMode = "bars" | "classic" | "none";
+
+export interface ToolDisplayConfig {
+	diffViewMode: DiffViewMode;
+	diffIndicatorMode: DiffIndicatorMode;
+	diffSplitMinWidth: number;
+	editDiffCollapsedLines: number;
+	/** Write-only collapsed body lines. 0 = `↳ created · click to show more`. */
+	writeDiffCollapsedLines: number;
+	diffWordWrap: boolean;
+	expandedPreviewMaxLines: number;
+}
+
+export const DEFAULT_TOOL_DISPLAY_CONFIG: ToolDisplayConfig = {
+	diffViewMode: "auto",
+	diffIndicatorMode: "bars",
+	diffSplitMinWidth: 120,
+	/** Collapsed edit/diff body: ~half a typical terminal after chrome. */
+	editDiffCollapsedLines: 24,
+	/**
+	 * Write create/overwrite collapsed body.
+	 * 0 = `↳ created · click to show more` (stats stay on the title).
+	 */
+	writeDiffCollapsedLines: 0,
+	diffWordWrap: true,
+	/**
+	 * Expanded TaskList body cap. Tool Input/Output and diffs use their own settings;
+	 * an expanded diff always renders every line.
+	 */
+	expandedPreviewMaxLines: 40,
+};
+
 export type Config = {
 	mode: CompactStyleMode;
 	excludeRenderers: string[];
@@ -21,8 +54,10 @@ export type Config = {
 	writeDiffCollapsedLines: number;
 	diffWordWrap: boolean;
 	expandedPreviewMaxLines: number;
+	expandedCardBackground: ThemeBg;
 	expandedInputMaxLines: number;
 	expandedOutputMaxLines: number;
+	inputClip: number;
 	useSummaryTitlesAsThinkingTitle: boolean;
 	previewLines: number;
 	animationIntervalMs: number;
@@ -35,10 +70,17 @@ export type Config = {
 	enableAgentSummary: boolean;
 	enableWorkingMessage: boolean;
 	enableAliases: boolean;
+	enableCustomFooter: boolean;
+	footerNerdIcons: boolean;
+	footerHiddenKeys: string[];
+	footerLine1Keys: string[];
+	footerLine2Keys: string[];
+	footerLine3Keys: string[];
 };
 
 const AGENT_DIR = process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent");
-const CONFIG_PATH = join(AGENT_DIR, "claude-code-style.json");
+export const CONFIG_PATH = join(AGENT_DIR, "pi-cc-extensions.json");
+const LEGACY_CONFIG_PATH = join(AGENT_DIR, "claude-code-style.json");
 
 export const DIFF_VIEW_MODES: DiffViewMode[] = ["auto", "split", "unified"];
 export const DIFF_INDICATOR_MODES: DiffIndicatorMode[] = ["bars", "classic", "none"];
@@ -48,8 +90,26 @@ export const DIFF_COLLAPSED_LINES_VALUES = ["12", "24", "36", "48", "80", "120"]
 export const WRITE_DIFF_COLLAPSED_LINES_VALUES = ["0", "4", "8", "12", "24", "36"];
 /** Presets for expanded body height — keep low options first so cycling stays TUI-friendly. */
 export const EXPANDED_PREVIEW_MAX_LINES_VALUES = ["40", "60", "80", "120", "200", "500", "2000"];
+/**
+ * 展开卡可用的主题背景槽位。theme.bg/getBgAnsi 只认这些 token，
+ * 别的名字会抛 Unknown theme color，所以按白名单校验；
+ * 面板顺序把 userMessageBg（默认）和 toolPendingBg（内置主题的中性灰）放最前。
+ */
+export const EXPANDED_CARD_BACKGROUND_SLOTS: readonly ThemeBg[] = [
+	"userMessageBg",
+	"toolPendingBg",
+	"customMessageBg",
+	"selectedBg",
+	"searchMatchBg",
+	"toolSuccessBg",
+	"toolErrorBg",
+];
+/** 展开工具卡 Input 可见行数预设。 */
 export const EXPANDED_INPUT_MAX_LINES_VALUES = ["5", "10", "20", "40", "80"];
+/** 展开工具卡 Output 可见行数预设。 */
 export const EXPANDED_OUTPUT_MAX_LINES_VALUES = ["10", "20", "40", "80", "120"];
+/** 工具摘要里 path/command 等输入的折叠字符数；0 = 只按可用宽度截断。 */
+export const INPUT_CLIP_VALUES = ["0", "40", "60", "80", "100", "120", "160"];
 export const THINKING_PREVIEW_LINES_VALUES = ["0", "1", "3", "5", "10"];
 export const THINKING_ANIMATION_INTERVAL_VALUES = ["40", "60", "90", "120", "180"];
 /** fullscreen 滚轮步进行数预设。 */
@@ -57,6 +117,7 @@ export const SCROLL_STEP_LINES_VALUES = ["1", "2", "3", "5", "10"];
 /** Tools commonly toggled in excludeRenderers via the settings panel. */
 export const EXCLUDE_RENDERER_CANDIDATES = [
 	"bash",
+	"powershell",
 	"read",
 	"edit",
 	"write",
@@ -77,8 +138,11 @@ export const DEFAULT_CONFIG: Config = {
 	writeDiffCollapsedLines: DEFAULT_TOOL_DISPLAY_CONFIG.writeDiffCollapsedLines,
 	diffWordWrap: DEFAULT_TOOL_DISPLAY_CONFIG.diffWordWrap,
 	expandedPreviewMaxLines: DEFAULT_TOOL_DISPLAY_CONFIG.expandedPreviewMaxLines,
+	/** 展开卡背景。userMessageBg 与用户消息同色（ccstyle 原约定）。 */
+	expandedCardBackground: "userMessageBg",
 	expandedInputMaxLines: 5,
 	expandedOutputMaxLines: 10,
+	inputClip: 0,
 	useSummaryTitlesAsThinkingTitle: true,
 	previewLines: 3,
 	animationIntervalMs: 90,
@@ -91,6 +155,9 @@ export const DEFAULT_CONFIG: Config = {
 	enableAgentSummary: true,
 	enableWorkingMessage: true,
 	enableAliases: true,
+	enableCustomFooter: true,
+	footerNerdIcons: true,
+	...DEFAULT_FOOTER_CHIP_LAYOUT,
 };
 
 function pickEnum<T extends string>(value: unknown, allowed: readonly T[], fallback: T): T {
@@ -105,6 +172,12 @@ export function pickPositiveInt(value: unknown, fallback: number, min = 1, max =
 	return Math.min(max, Math.max(min, Math.floor(n)));
 }
 
+/** inputClip：0 表示按宽度自适应，其余夹到 8..500。 */
+export function pickInputClip(value: unknown): number {
+	const n = typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
+	return n === 0 ? 0 : pickPositiveInt(value, DEFAULT_CONFIG.inputClip, 8, 500);
+}
+
 export function pickPositiveNumber(value: unknown, fallback: number, min = 1): number {
 	const n = typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
 	return Number.isFinite(n) ? Math.max(min, n) : fallback;
@@ -112,16 +185,7 @@ export function pickPositiveNumber(value: unknown, fallback: number, min = 1): n
 
 export function normalizeConfig(input: unknown): Config {
 	const source = (input && typeof input === "object" ? input : {}) as Record<string, unknown>;
-	const mode = source.mode;
-	// 旧 `enabled: boolean` 配置迁移；compact 已恢复为受支持模式，不再回退 on。
-	const migratedMode: CompactStyleMode =
-		mode === "on" || mode === "compact" || mode === "off"
-			? mode
-			: typeof source.enabled === "boolean"
-				? source.enabled
-					? "on"
-					: "off"
-				: "on";
+	const mode = pickEnum(source.mode, ["on", "compact", "off"], DEFAULT_CONFIG.mode);
 	const excludeRenderers = Array.isArray(source.excludeRenderers)
 		? [
 				...new Set(
@@ -132,7 +196,7 @@ export function normalizeConfig(input: unknown): Config {
 			]
 		: [];
 	return {
-		mode: migratedMode,
+		mode,
 		excludeRenderers,
 		diffViewMode: pickEnum(source.diffViewMode, DIFF_VIEW_MODES, DEFAULT_CONFIG.diffViewMode),
 		diffIndicatorMode: pickEnum(
@@ -147,7 +211,7 @@ export function normalizeConfig(input: unknown): Config {
 			300,
 		),
 		editDiffCollapsedLines: pickPositiveInt(
-			source.editDiffCollapsedLines ?? source.diffCollapsedLines,
+			source.editDiffCollapsedLines,
 			DEFAULT_CONFIG.editDiffCollapsedLines,
 			1,
 			500,
@@ -165,6 +229,11 @@ export function normalizeConfig(input: unknown): Config {
 			10,
 			50_000,
 		),
+		expandedCardBackground: pickEnum(
+			source.expandedCardBackground,
+			EXPANDED_CARD_BACKGROUND_SLOTS,
+			DEFAULT_CONFIG.expandedCardBackground,
+		),
 		expandedInputMaxLines: pickPositiveInt(
 			source.expandedInputMaxLines,
 			DEFAULT_CONFIG.expandedInputMaxLines,
@@ -177,6 +246,7 @@ export function normalizeConfig(input: unknown): Config {
 			1,
 			5_000,
 		),
+		inputClip: pickInputClip(source.inputClip),
 		useSummaryTitlesAsThinkingTitle: source.useSummaryTitlesAsThinkingTitle !== false,
 		previewLines: pickPositiveInt(
 			source.previewLines,
@@ -197,6 +267,9 @@ export function normalizeConfig(input: unknown): Config {
 		enableAgentSummary: source.enableAgentSummary !== false,
 		enableWorkingMessage: source.enableWorkingMessage !== false,
 		enableAliases: source.enableAliases !== false,
+		enableCustomFooter: source.enableCustomFooter !== false,
+		footerNerdIcons: source.footerNerdIcons !== false,
+		...normalizeFooterChipLayout(source),
 	};
 }
 
@@ -237,6 +310,7 @@ export function formatConfigStatus(source: Config = config): string {
 		`expandedMax=${source.expandedPreviewMaxLines}`,
 		`expandedInput=${source.expandedInputMaxLines}`,
 		`expandedOutput=${source.expandedOutputMaxLines}`,
+		`inputClip=${source.inputClip}`,
 		`thinkingTitle=${source.useSummaryTitlesAsThinkingTitle ? "summary" : "default"}`,
 		`thinkingPreview=${source.previewLines}`,
 		`thinkingAnimation=${source.animationIntervalMs}ms`,
@@ -249,30 +323,32 @@ export function formatConfigStatus(source: Config = config): string {
 		`agentSummary=${source.enableAgentSummary ? "on" : "off"}`,
 		`workingMsg=${source.enableWorkingMessage ? "on" : "off"}`,
 		`aliases=${source.enableAliases ? "on" : "off"}`,
+		`footer=${source.enableCustomFooter ? "on" : "off"}`,
+		`footerIcons=${source.footerNerdIcons ? "nerd" : "plain"}`,
+		formatFooterChipSummary(source),
 	].join(" · ");
 }
 
-export let config: Config = loadConfig();
+/** 进程内唯一的活动配置对象。读取直接用 `config.xxx`；写入必须走 `updateConfig`。 */
+export const config: Config = loadConfig();
 
 function loadConfig(): Config {
 	try {
-		const source = existsSync(CONFIG_PATH)
-			? (JSON.parse(readFileSync(CONFIG_PATH, "utf8")) as Record<string, unknown>)
+		const fromLegacy = !existsSync(CONFIG_PATH) && existsSync(LEGACY_CONFIG_PATH);
+		const rawPath = existsSync(CONFIG_PATH) ? CONFIG_PATH : fromLegacy ? LEGACY_CONFIG_PATH : null;
+		const source = rawPath
+			? (JSON.parse(readFileSync(rawPath, "utf8")) as Record<string, unknown>)
 			: {};
-		const normalized = normalizeConfig(source);
-		if (
-			typeof source.enabled === "boolean" &&
-			source.mode !== "on" &&
-			source.mode !== "compact" &&
-			source.mode !== "off"
-		) {
+		const next = normalizeConfig(source);
+		if (fromLegacy) {
 			try {
-				writeFileSync(CONFIG_PATH, JSON.stringify(normalized, null, 2));
+				writeFileSync(CONFIG_PATH, JSON.stringify(next, null, 2));
+				rmSync(LEGACY_CONFIG_PATH, { force: true });
 			} catch {
-				// A read-only config still uses the migrated in-memory value.
+				// 新路径写失败时仍使用已读到的旧配置，旧文件保留。
 			}
 		}
-		return normalized;
+		return next;
 	} catch {
 		// Ignore bad config and fall back to defaults.
 	}
@@ -283,7 +359,13 @@ export function saveConfig() {
 	writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
 }
 
-/** 整体替换配置（default export 的 configOverride 注入路径；导入绑定不可重新赋值）。 */
+/** 运行时配置写入的唯一入口：合并 + 规范化 + 持久化。 */
+export function updateConfig(partial: Partial<Config>): void {
+	Object.assign(config, normalizeConfig({ ...config, ...partial }));
+	saveConfig();
+}
+
+/** 整体替换配置（default export 的 configOverride 注入路径；就地覆盖，不持久化）。 */
 export function setConfig(next: Config): void {
-	config = next;
+	Object.assign(config, next);
 }