@herbertgao/pi-extensions 2026.9.18 → 2026.9.20

package/node_modules/@herbertgao/pi-cc-extensions/extensions/renderer/tool/result.ts

@@ -1,32 +1,38 @@
 import { Text, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
-import { posix, win32 } from "node:path";
 import { inspect } from "node:util";
 import { config } from "../../config/config.ts";
-import { showMoreHintText } from "../show-more-hint.ts";
+import { showMoreHintText } from "./show-more-hint.ts";
 import { TOOL_LOADING_INTERVAL_MS, toolLoadingIcon } from "../../utils/tool-loading-icon.ts";
+import { getToolMouseTui } from "../mouse/scroll.ts";
 import { sanitizeToolResultText } from "../../utils/tool-result-sanitize.ts";
 
+const TOOL_VIEWPORT_WIDTH_RATIO = 0.8;
+/** 宽屏右侧留白上限：比例留白超过这么多列时改用固定留白。 */
+const TOOL_VIEWPORT_MAX_GUTTER = 24;
+
 export function toolViewportWidth(width: number): number {
-	return Math.max(1, Math.floor(width));
+	return Math.max(
+		1,
+		Math.floor(width * TOOL_VIEWPORT_WIDTH_RATIO),
+		Math.floor(width) - TOOL_VIEWPORT_MAX_GUTTER,
+	);
 }
 
-/** 与默认工具结果相同的一级缩进包装。 */
+/** 与默认工具结果相同的一级缩进包装。子组件只扣始终加上的 1 列；↳ 行多出的 2 列由 truncateToWidth 吃掉。 */
 export function insetComponent(component: any): any {
-	return {
+	const wrapped: Record<string, unknown> = {
 		render: (width: number) =>
 			component.render(Math.max(1, width - 1)).map((line: string) => {
 				const nestedMarker = line.replace(/^((?:\x1b\[[0-?]*[ -/]*[@-~])*)↳/, "$1  ↳");
-				return ` ${nestedMarker}`;
+				return truncateToWidth(` ${nestedMarker}`, Math.max(0, width), "");
 			}),
 		invalidate: () => component.invalidate?.(),
 	};
-}
-
-export function oneLine(value: unknown, max = 4096): string {
-	const text = sanitizeToolResultText(String(value ?? ""))
-		.replace(/\s+/g, " ")
-		.trim();
-	return text.length > max ? `${text.slice(0, max - 1)}…` : text;
+	// 内层 diff 声明的 remainder 行：鼠标层只能看到这个包装组件。
+	if (typeof component.isCollapsedHintLine === "function") {
+		wrapped.isCollapsedHintLine = (line: string) => component.isCollapsedHintLine(line);
+	}
+	return wrapped;
 }
 
 function rawTextFromResult(result: any): string {
@@ -72,14 +78,11 @@ function hasExpandableResult(text: string): boolean {
 	return countLines(text) > 1;
 }
 
-function toolIcon(_name: string): string {
-	return "●";
-}
-
 const activeAnimationContexts = new Set<any>();
 let sharedAnimationTimer: ReturnType<typeof setTimeout> | null = null;
 
 function clearAnimation(context: any) {
+	if (context?.state) context.state.ccstyleAnimationLight = false;
 	if (!context?.state?.ccstyleAnimationScheduled) return;
 	context.state.ccstyleAnimationScheduled = false;
 	activeAnimationContexts.delete(context);
@@ -92,6 +95,7 @@ function clearAnimation(context: any) {
 export function clearAllAnimations() {
 	for (const ctx of activeAnimationContexts) {
 		ctx.state.ccstyleAnimationScheduled = false;
+		ctx.state.ccstyleAnimationLight = false;
 	}
 	activeAnimationContexts.clear();
 	if (sharedAnimationTimer) {
@@ -100,8 +104,15 @@ export function clearAllAnimations() {
 	}
 }
 
-export function scheduleAnimation(context: any, intervalMs = TOOL_LOADING_INTERVAL_MS) {
+export function scheduleAnimation(
+	context: any,
+	options: { light?: boolean; intervalMs?: number } = {},
+) {
 	const state = (context.state ??= {});
+	// light：调用方自己在 render() 内重取 loading 帧，定时器只需请求重绘；
+	// 否则定时器走 context.invalidate()（compact 摘要等靠它重建）。
+	// 每次调用都按本次 options 写入，避免上次 light 残留后非 light 调用仍跳过 invalidate。
+	state.ccstyleAnimationLight = Boolean(options.light);
 	if (state.ccstyleAnimationScheduled) return;
 	state.ccstyleAnimationScheduled = true;
 	activeAnimationContexts.add(context);
@@ -110,11 +121,16 @@ export function scheduleAnimation(context: any, intervalMs = TOOL_LOADING_INTERV
 			sharedAnimationTimer = null;
 			const contexts = Array.from(activeAnimationContexts);
 			activeAnimationContexts.clear();
+			const tui = getToolMouseTui();
+			const canRequestRender = typeof tui?.requestRender === "function";
+			let lightFrames = false;
 			for (const ctx of contexts) {
 				ctx.state.ccstyleAnimationScheduled = false;
-				ctx.invalidate?.();
+				if (ctx.state.ccstyleAnimationLight && canRequestRender) lightFrames = true;
+				else ctx.invalidate?.();
 			}
-		}, intervalMs);
+			if (lightFrames) tui.requestRender();
+		}, options.intervalMs ?? TOOL_LOADING_INTERVAL_MS);
 	}
 }
 
@@ -127,7 +143,8 @@ type ToolVisualState = "pending" | "success" | "error";
 export function settledIcon(name: string, state: ToolVisualState | undefined): string {
 	if (state === "success") return "✓";
 	if (state === "error") return "✗";
-	return toolIcon(name);
+	// toolIcon(name) 曾恒返回 "●"，已内联；name 保留以稳定导出签名。
+	return "●";
 }
 
 export function setToolVisualState(context: any, visualState: ToolVisualState) {
@@ -213,7 +230,7 @@ export class ExpandedToolResultText {
 	}
 }
 
-/** Affordance next to truncated Input/Output headers — click opens full preview. */
+/** 截断体末行 `… +N more lines` 旁的展开提示，点击打开全量预览。 */
 export const SHOW_MORE_LABEL = "• click to show more";
 
 export type ToolIoSection = "input" | "output";
@@ -232,6 +249,8 @@ const EXPANDED_TOOL_IO_VIEW_GENERATION = Symbol("ccstyle-expanded-tool-io-view")
  *   └ Output  click to show more
  *     result line…
  *
+ * flushLeft=true（仅 mode=on 展开卡）：去掉树线前导空格，由外层 Box(1,1) 提供 1 格 padding。
+ *
  * Reused across re-renders via context.lastComponent when possible.
  */
 export class ExpandedToolIoView {
@@ -247,16 +266,20 @@ export class ExpandedToolIoView {
 	private hoveredSection: ToolIoSection | null = null;
 	/** Which sections currently show the show-more affordance (after last render). */
 	private truncated: { input: boolean; output: boolean } = { input: false, output: false };
-	/** 0-based body/footer line indexes that carry show-more after last render. */
+	/** 0-based header line indexes that carry show-more after last render. */
 	private showMoreHeaderRows: { input?: number; output?: number } = {};
 
+	/** flushLeft：贴左渲染（mode=on 展开卡）；默认 false 保留前导空格（compact 等共用路径）。 */
+	private flushLeft: boolean;
+
 	constructor(
 		theme: any,
 		inputBody: string,
 		outputBody: string,
 		isError: boolean,
-		maxOutputLines = config.expandedPreviewMaxLines,
-		maxInputLines = config.expandedPreviewMaxLines,
+		maxOutputLines = config.expandedOutputMaxLines,
+		maxInputLines = config.expandedInputMaxLines,
+		flushLeft = false,
 	) {
 		this.theme = theme;
 		this.inputBody = inputBody;
@@ -264,6 +287,7 @@ export class ExpandedToolIoView {
 		this.isError = isError;
 		this.maxOutputLines = Math.max(1, maxOutputLines);
 		this.maxInputLines = Math.max(1, maxInputLines);
+		this.flushLeft = flushLeft;
 	}
 
 	setContent(
@@ -272,16 +296,19 @@ export class ExpandedToolIoView {
 		isError: boolean,
 		maxOutputLines?: number,
 		maxInputLines?: number,
+		flushLeft?: boolean,
 	): void {
 		const nextOut =
 			maxOutputLines !== undefined ? Math.max(1, maxOutputLines) : this.maxOutputLines;
 		const nextIn = maxInputLines !== undefined ? Math.max(1, maxInputLines) : this.maxInputLines;
+		const nextFlush = flushLeft !== undefined ? flushLeft : this.flushLeft;
 		if (
 			this.inputBody === inputBody &&
 			this.outputBody === outputBody &&
 			this.isError === isError &&
 			this.maxOutputLines === nextOut &&
-			this.maxInputLines === nextIn
+			this.maxInputLines === nextIn &&
+			this.flushLeft === nextFlush
 		) {
 			return;
 		}
@@ -290,6 +317,7 @@ export class ExpandedToolIoView {
 		this.isError = isError;
 		this.maxOutputLines = nextOut;
 		this.maxInputLines = nextIn;
+		this.flushLeft = nextFlush;
 		this.invalidate();
 	}
 
@@ -307,7 +335,11 @@ export class ExpandedToolIoView {
 		this.invalidate();
 	}
 
-	/** True when the plain footer line is a truncated section with show-more. */
+	getHoveredSection(): ToolIoSection | null {
+		return this.hoveredSection;
+	}
+
+	/** True when the plain truncation footer carries show-more. Input 续行带 │，Output 不带。 */
 	matchShowMoreLine(plainLine: string): ToolIoSection | null {
 		const line = plainLine.replace(/\x1b\[[0-9;]*m/g, "");
 		if (!line.includes(` • ${showMoreHintText()}`) || !/\+\d+ more lines/.test(line)) return null;
@@ -347,7 +379,9 @@ export class ExpandedToolIoView {
 
 		const theme = this.theme;
 		const safeWidth = Math.max(1, Math.floor(width));
-		const rail = " │ ";
+		// flushLeft：贴左（外层 Box 负责 1 格 pad）；否则保留 1 格前导空格（compact 共用）
+		const lead = this.flushLeft ? "" : " ";
+		const rail = `${lead}│ `;
 		const railWidth = visibleWidth(rail);
 		const bodyWidth = toolViewportWidth(safeWidth);
 		const contentWidth = Math.max(1, bodyWidth - railWidth);
@@ -357,7 +391,7 @@ export class ExpandedToolIoView {
 		this.showMoreHeaderRows = {};
 
 		const pushHeader = (corner: "├" | "└", label: string) => {
-			const mark = theme.fg("dim", ` ${corner} `);
+			const mark = theme.fg("dim", `${lead}${corner} `);
 			const title = theme.fg(
 				"accent",
 				typeof theme.bold === "function" ? theme.bold(label) : label,
@@ -366,12 +400,13 @@ export class ExpandedToolIoView {
 		};
 
 		const pushRailLine = (styledContent: string, continued = true) => {
-			const prefix = continued ? rail : "   ";
+			// 续行 rail；Output 正文相对 └ 缩进 2 格（+ 可选 lead）
+			const prefix = continued ? rail : `${lead}  `;
 			lines.push(truncateToWidth(theme.fg("dim", prefix) + styledContent, safeWidth, ""));
 		};
 
 		const pushBlankRail = () => {
-			lines.push(truncateToWidth(theme.fg("dim", " │"), safeWidth, ""));
+			lines.push(truncateToWidth(theme.fg("dim", `${lead}│`), safeWidth, ""));
 		};
 
 		/** Style `key: value` input rows — dim keys, readable values. */
@@ -407,6 +442,7 @@ export class ExpandedToolIoView {
 			if (truncated) {
 				const hidden = Math.max(0, wrapped.length - visible.length);
 				if (hidden > 0) {
+					// hover 只高亮文字，圆点保持 dim（与 group hint 一致）。
 					const more =
 						theme.fg("dim", " •") +
 						theme.fg(
@@ -423,6 +459,7 @@ export class ExpandedToolIoView {
 		const hasInput = this.inputBody.trim().length > 0;
 		const outputText = this.getOutputBody();
 
+		// Decide show-more from the same truncation rules as pushBody.
 		const inputWouldTruncate =
 			hasInput &&
 			bodyExceedsLineLimit(this.inputBody, this.maxInputLines, contentWidth, true, theme);
@@ -447,11 +484,19 @@ export class ExpandedToolIoView {
 			pushBlankRail();
 			this.truncated.output = outputWouldTruncate;
 			pushHeader("└", "Output");
-			pushBody(outputText, { limit: this.maxOutputLines, continued: false, section: "output" });
+			pushBody(outputText, {
+				limit: this.maxOutputLines,
+				continued: false,
+				section: "output",
+			});
 		} else {
 			this.truncated.output = outputWouldTruncate;
 			pushHeader("└", "Output");
-			pushBody(outputText, { limit: this.maxOutputLines, continued: false, section: "output" });
+			pushBody(outputText, {
+				limit: this.maxOutputLines,
+				continued: false,
+				section: "output",
+			});
 		}
 
 		this.cachedWidth = width;
@@ -558,103 +603,6 @@ export function middleTruncateToWidth(text: string, width: number): string {
 	return `${left}…${right}`;
 }
 
-export type ToolCallSummary = {
-	main: string;
-	detail: string;
-	/** 路径摘要保留结构，供最终渲染按实际宽度优先保留文件名。 */
-	path?: { prefix: string; value: string };
-};
-
-function pathApi(value: string) {
-	if (win32.isAbsolute(value)) return win32;
-	if (posix.isAbsolute(value)) return posix;
-	return undefined;
-}
-
-/** cwd 内绝对路径转相对路径；cwd 外路径保持不变。 */
-export function displayPath(value: unknown, cwd?: string): string {
-	const text = oneLine(value, 4096);
-	const base = cwd ? oneLine(cwd, 4096) : "";
-	const api = pathApi(text);
-	if (!api || !base || !api.isAbsolute(base)) return text;
-	const relative = api.relative(base, text);
-	if (!relative) return api.basename(text) || ".";
-	if (relative === ".." || relative.startsWith(`..${api.sep}`) || api.isAbsolute(relative)) {
-		return text;
-	}
-	return relative;
-}
-
-function headToWidth(text: string, width: number, ellipsis = ""): string {
-	if (visibleWidth(text) <= width) return text;
-	if (width <= 0) return "";
-	const suffix = visibleWidth(ellipsis) <= width ? ellipsis : "";
-	const contentWidth = width - visibleWidth(suffix);
-	let head = "";
-	for (const char of Array.from(text)) {
-		if (visibleWidth(head + char) > contentWidth) break;
-		head += char;
-	}
-	return head + suffix;
-}
-
-function tailToWidth(text: string, width: number): string {
-	if (width <= 0) return "";
-	let tail = "";
-	for (const char of Array.from(text).reverse()) {
-		if (visibleWidth(char + tail) > width) break;
-		tail = char + tail;
-	}
-	return tail;
-}
-
-/** 中间截断路径：目录保留开头，末尾优先完整保留文件名。 */
-export function truncatePathToWidth(path: string, width: number): string {
-	if (visibleWidth(path) <= width) return path;
-	if (width <= 1) return width === 1 ? "…" : "";
-	const separatorIndex = Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\"));
-	const filename = separatorIndex >= 0 ? path.slice(separatorIndex + 1) : path;
-	const filenameWidth = visibleWidth(filename);
-	if (separatorIndex >= 0 && filenameWidth + 1 <= width) {
-		const separator = path[separatorIndex]!;
-		const suffix = `${separator}${filename}`;
-		const prefixWidth = width - visibleWidth(suffix) - 1;
-		const prefix = headToWidth(path.slice(0, separatorIndex), Math.max(0, prefixWidth));
-		return `${prefix}…${prefix ? suffix : filename}`;
-	}
-	const leftWidth = Math.max(1, Math.floor((width - 1) * 0.45));
-	const rightWidth = Math.max(0, width - leftWidth - 1);
-	return `${headToWidth(filename, leftWidth)}…${tailToWidth(filename, rightWidth)}`;
-}
-
-/** 路径展示的统一入口：相对化后按当前可用宽度中间截断。 */
-export function formatDisplayPath(value: unknown, cwd: string | undefined, width: number): string {
-	return truncatePathToWidth(displayPath(value, cwd), Math.max(0, Math.floor(width)));
-}
-
-/** 按最终终端宽度渲染摘要；路径摘要不会再被整行头部截断。 */
-export function fitToolCallSummary(summary: ToolCallSummary, width: number): string {
-	if (!summary.path) return headTruncateToWidth(summary.main, width);
-	const prefix = summary.path.prefix;
-	const pathWidth = Math.max(0, width - visibleWidth(prefix) - 1);
-	if (pathWidth <= 0) return headTruncateToWidth(prefix, width);
-	return `${prefix} ${truncatePathToWidth(summary.path.value, pathWidth)}`;
-}
-
-export function pathSummary(
-	prefix: string,
-	value: unknown,
-	cwd: string | undefined,
-	detail = "",
-): ToolCallSummary {
-	const path = displayPath(value, cwd);
-	return {
-		main: `${prefix} ${path}`,
-		detail,
-		path: { prefix, value: path },
-	};
-}
-
 /** Pretty-print tool call args for the expanded Input section. */
 export function formatToolInputArgs(args: unknown, maxChars = 8_000): string {
 	if (args === undefined || args === null) return "";
@@ -746,6 +694,8 @@ export function renderExpandedToolResult(
 	lastComponent?: unknown,
 	args?: unknown,
 	context?: any,
+	/** mode=on 展开卡贴左；compact 等保持默认前导空格 */
+	flushLeft = false,
 ): ExpandedToolIoView | ExpandedToolResultText | Text {
 	const inputBody = formatToolInputArgs(args);
 	const outputBody = body;
@@ -756,7 +706,14 @@ export function renderExpandedToolResult(
 	if (inputBody.trim() || outputBody.trim()) {
 		let view: ExpandedToolIoView;
 		if (isExpandedToolIoView(lastComponent)) {
-			lastComponent.setContent(inputBody, outputBody, isError, maxOutputLines, maxInputLines);
+			lastComponent.setContent(
+				inputBody,
+				outputBody,
+				isError,
+				maxOutputLines,
+				maxInputLines,
+				flushLeft,
+			);
 			view = lastComponent;
 		} else {
 			view = new ExpandedToolIoView(
@@ -766,6 +723,7 @@ export function renderExpandedToolResult(
 				isError,
 				maxOutputLines,
 				maxInputLines,
+				flushLeft,
 			);
 		}
 		if (context) rememberIoView(context, view);
@@ -803,7 +761,7 @@ function frameViewId(view: ExpandedToolIoView): number | null {
 function withIoViewMarkers(view: ExpandedToolIoView, lines: string[]): string[] {
 	const id = frameViewId(view);
 	if (id === null) return lines;
-	// Mark by exact recorded show-more row from render — never scan body text heuristically.
+	// Mark by exact header row from render — never scan body text for Input/Output labels.
 	const marked = lines.slice();
 	for (const { section, line } of view.showMoreHeaderLineIndexes()) {
 		if (line < 0 || line >= marked.length) continue;

package/node_modules/@herbertgao/pi-cc-extensions/extensions/renderer/{show-more-hint.ts → tool/show-more-hint.ts}

@@ -36,3 +36,13 @@ export function expandShortcutText(): string {
 export function showMoreHintText(): string {
 	return isToolTuiFullscreen() ? "click to show more" : `${expandShortcutText()} to show more`;
 }
+
+/** 展开卡的收起提示，与折叠态 showMoreHintText 同一位置对称。 */
+export function collapseHintText(): string {
+	return isToolTuiFullscreen() ? "↑ Collapse" : `${expandShortcutText()} to collapse`;
+}
+
+/** 该行是否带展开态收起提示（用于展开卡的 hint hover 命中）。 */
+export function isCollapseHintLine(plainLine: string): boolean {
+	return plainLine.includes(collapseHintText());
+}

package/node_modules/@herbertgao/pi-cc-extensions/extensions/renderer/transcript-refresh.ts

@@ -1,5 +1,7 @@
 import type { AssistantMessage } from "@earendil-works/pi-ai";
 import { AssistantMessageComponent, ToolExecutionComponent } from "@earendil-works/pi-coding-agent";
+import { walkComponentTree } from "../utils/component-tree.ts";
+import { COMPACT_MODE_PATCH_KEY, patchRegistry } from "../utils/patch-keys.ts";
 
 // pi-coding-agent 类型声明中 AssistantMessageComponent 仅能以 value 形式使用，
 // updateContent/lastMessage 用结构化类型访问。
@@ -37,8 +39,6 @@ export function refreshTranscriptComponent(value: unknown): boolean {
  * 遍历 value.children 与 value.getMountedRoots?.()（seen 集合防环），
  * 单个组件失败用 try/catch 隔离，不影响其余组件。
  */
-// compact-mode 把补丁暴露在此 Symbol 上（见 compact-mode.ts），避免循环依赖。
-const COMPACT_MODE_PATCH_KEY = Symbol.for("pi.ccstyle.compact-mode-patch");
 
 /**
  * 补丁链序不变量：compact 模式下 compact-mode 必须位于 compact-thinking
@@ -48,8 +48,10 @@ const COMPACT_MODE_PATCH_KEY = Symbol.for("pi.ccstyle.compact-mode-patch");
  */
 function assertCompactModeOutermost(): void {
 	try {
-		const patch = (globalThis as any)[COMPACT_MODE_PATCH_KEY];
-		if (typeof patch?.assertAssistantOwnership === "function") {
+		const patch = patchRegistry.get<{ assertAssistantOwnership?: () => void }>(
+			COMPACT_MODE_PATCH_KEY,
+		);
+		if (patch && typeof patch.assertAssistantOwnership === "function") {
 			patch.assertAssistantOwnership();
 		}
 	} catch {
@@ -61,31 +63,11 @@ export function refreshMountedTranscript(tui?: unknown): void {
 	if (!tui || typeof (tui as any).getMountedRoots !== "function") return;
 	// 先修正链序再重绘：扫描触发 updateContent 时 compact-mode 已在外层。
 	assertCompactModeOutermost();
-	const seen = new Set<object>();
-	const visit = (value: any): void => {
-		if (!value || typeof value !== "object" || seen.has(value)) return;
-		seen.add(value);
-		if (Array.isArray(value)) {
-			for (const child of value) visit(child);
-			return;
-		}
+	walkComponentTree(tui, (value: any) => {
 		try {
 			refreshTranscriptComponent(value);
 		} catch {
 			// 单个组件失败不阻断其余组件；后续 session_tree/重绘再试。
 		}
-		const children = value.children;
-		if (Array.isArray(children)) {
-			for (const child of children) visit(child);
-		}
-		try {
-			const mounted = value.getMountedRoots?.();
-			if (Array.isArray(mounted)) {
-				for (const root of mounted) visit(root);
-			}
-		} catch {
-			// 惰性 Proxy / 未挂载容器没有 mounted roots。
-		}
-	};
-	visit(tui);
+	});
 }

package/node_modules/@herbertgao/pi-cc-extensions/extensions/utils/ansi-color.ts

@@ -0,0 +1,44 @@
+/** ANSI 16 色 → RGB（标准 xterm 色序）。 */
+const ANSI_16_RGB: readonly [number, number, number][] = [
+	[0, 0, 0],
+	[128, 0, 0],
+	[0, 128, 0],
+	[128, 128, 0],
+	[0, 0, 128],
+	[128, 0, 128],
+	[0, 128, 128],
+	[192, 192, 192],
+	[128, 128, 128],
+	[255, 0, 0],
+	[0, 255, 0],
+	[255, 255, 0],
+	[0, 0, 255],
+	[255, 0, 255],
+	[0, 255, 255],
+	[255, 255, 255],
+];
+
+/** ANSI 16 色码（0-15）→ RGB；越界回退白。 */
+export function ansi16ToRgb(index: number): [number, number, number] {
+	return ANSI_16_RGB[index] ?? [255, 255, 255];
+}
+
+/** ANSI 256 色码 → RGB（0-15 标准色 + 232-255 灰阶 + 16-231 六阶立方体）。 */
+export function ansi256ToRgb(code: number): [number, number, number] {
+	// SGR 正则可解析任意位数字，入口先规范：取整并钳制到合法区间，
+	// 否则灰阶分支对 code > 255 会算出超出 0-255 的非法 RGB。
+	if (!Number.isFinite(code)) return [0, 0, 0];
+	code = Math.min(255, Math.max(0, Math.trunc(code)));
+	if (code < 16) return ansi16ToRgb(code);
+	if (code >= 232) {
+		const gray = 8 + (code - 232) * 10;
+		return [gray, gray, gray];
+	}
+	const cubeIndex = code - 16;
+	const levels = [0, 95, 135, 175, 215, 255];
+	return [
+		levels[Math.floor(cubeIndex / 36)]!,
+		levels[Math.floor((cubeIndex % 36) / 6)]!,
+		levels[cubeIndex % 6]!,
+	];
+}

package/node_modules/@herbertgao/pi-cc-extensions/extensions/utils/ansi-text.ts

@@ -0,0 +1,76 @@
+/**
+ * 顶层共享的 ANSI/终端控制序列处理。
+ *
+ * 收敛原先散落在 renderer/grouping.ts / renderer/mouse/packets.ts /
+ * renderer/compact-mode.ts 的重复剥离逻辑，供 renderer 与 feature 共用。
+ */
+
+/** 单个 CSI 序列（颜色、光标等 SGR/CUP/ED 等）。 */
+const CSI_SEQUENCE_RE = /\x1b\[[0-?]*[ -/]*[@-~]/g;
+/** OSC 序列（如 \x1b]8;;url\x07 或 ST 结尾）。 */
+const OSC_SEQUENCE_RE = /\x1b\][^\x07]*(?:\x07|\x1b\\)/g;
+/** compact-mode 原有 hasVisibleText 用的更严格 OSC（内容不允许内嵌 ESC）。 */
+const OSC_SEQUENCE_STRICT_RE = /\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g;
+
+/** 剥离一行内所有 CSI 序列。 */
+export function stripAnsi(line: string): string {
+	return line.replace(CSI_SEQUENCE_RE, "");
+}
+
+/** 仅剥离终端序列、保留原布局（换行/空白不动），用于命中区间计算。 */
+export function stripTerminalSequencesPreservingLayout(value: string): string {
+	return value.replace(OSC_SEQUENCE_RE, "").replace(CSI_SEQUENCE_RE, "");
+}
+
+/** 剥离终端序列并折叠空白（用于纯文本比较）。 */
+export function stripTerminalSequences(value: string): string {
+	return stripTerminalSequencesPreservingLayout(value).replace(/\s+/g, " ").trim();
+}
+
+/** 去掉行内所有 CSI/OSC 序列后是否仍有可见文本（判断工具卡首尾内容行）。 */
+export function hasVisibleText(line: string): boolean {
+	// OSC 用更严格的变体：内容内嵌 ESC 时不吞并后续文本，保持 compact-mode 原有语义。
+	return line.replace(CSI_SEQUENCE_RE, "").replace(OSC_SEQUENCE_STRICT_RE, "").trim().length > 0;
+}
+
+/** 剥离背景色 ANSI（用于重新铺背景行）。 */
+export function stripBackgroundAnsi(line: string): string {
+	return line.replace(/\x1b\[(?:4[0-9]|10[0-7]|48(?:(?:;|:)[0-9]+)+|49)m/g, "");
+}
+
+/** 剥离行首状态图标（展开组内工具首行复用）。 */
+export function stripLeadingStatusIcon(line: string): string {
+	return line.replace(
+		/^((?:\x1b\[[0-9;]*m|[ \t]|[├└│─])*)(?:\x1b\[[0-9;]*m)*(?:[✓✗●○■⬤•·])(?:\x1b\[[0-9;]*m)*\s+/,
+		"$1",
+	);
+}
+
+/** 终端序列零宽（不计入 plain 下标），与 stripAnsi/stripTerminalSequencesPreservingLayout 一致。 */
+const ANY_SEQUENCE_RE = new RegExp(`${CSI_SEQUENCE_RE.source}|${OSC_SEQUENCE_RE.source}`, "g");
+
+/** 只保留 [start, end) 之外的字符（base 为 text 首字符在 plain 串中的下标）。 */
+function keepOutsideRange(text: string, base: number, start: number, end: number): string {
+	if (base + text.length <= start || base >= end) return text;
+	return text.slice(0, Math.max(0, start - base)) + text.slice(Math.max(0, end - base));
+}
+
+/**
+ * 删除 plain 区间 [start, end) 的字符，保留其余字符的 ANSI 样式。
+ * 区间内的终端序列原样保留，因此区间后的字符（如收尾括号）沿用前文颜色，
+ * 不会像截断后拼纯文本那样掉回终端默认前景色。
+ */
+export function removeStyledRange(styled: string, start: number, end: number): string {
+	if (end <= start) return styled;
+	let plain = 0;
+	let cursor = 0;
+	let out = "";
+	for (const match of styled.matchAll(ANY_SEQUENCE_RE)) {
+		const text = styled.slice(cursor, match.index);
+		out += keepOutsideRange(text, plain, start, end);
+		plain += text.length;
+		out += match[0];
+		cursor = match.index + match[0].length;
+	}
+	return out + keepOutsideRange(styled.slice(cursor), plain, start, end);
+}

package/node_modules/@herbertgao/pi-cc-extensions/extensions/utils/component-tree.ts

@@ -0,0 +1,34 @@
+/**
+ * 组件树递归遍历共享实现。
+ *
+ * 收敛原先散落在 renderer 的 compact-mode / message-display / transcript-refresh /
+ * grouping / mouse/packets 的「children + getMountedRoots + seen 防环」同款遍历。
+ *
+ * visitor 在每个非数组对象节点上调用一次；返回 `false` 表示不再下钻该节点的
+ * children 与 mounted roots（对应各处原有的提前 return 语义）。
+ */
+export function walkComponentTree(root: any, visitor: (value: any) => boolean | void): void {
+	const seen = new Set<any>();
+	const visit = (value: any): void => {
+		if (!value || typeof value !== "object" || seen.has(value)) return;
+		seen.add(value);
+		if (Array.isArray(value)) {
+			for (const child of value) visit(child);
+			return;
+		}
+		if (visitor(value) === false) return;
+		const children = value.children;
+		if (Array.isArray(children)) {
+			for (const child of children) visit(child);
+		}
+		try {
+			const mounted = value.getMountedRoots?.();
+			if (Array.isArray(mounted)) {
+				for (const root of mounted) visit(root);
+			}
+		} catch {
+			// renderer 切换中的惰性 Proxy 可能暂时没有 mounted roots。
+		}
+	};
+	visit(root);
+}