pi-cc-extensions 0.8.53 → 0.8.55

package/extensions/renderer/{tool-result.ts → tool/result.ts}

@@ -1,9 +1,9 @@
 import { Text, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
 import { inspect } from "node:util";
-import { config } from "../config/config.ts";
-import { showMoreHintText } from "./show-more-hint.ts";
-import { TOOL_LOADING_INTERVAL_MS, toolLoadingIcon } from "../utils/tool-loading-icon.ts";
-import { sanitizeToolResultText } from "../utils/tool-result-sanitize.ts";
+import { config } from "../../config/config.ts";
+import { showMoreHintText } from "../show-more-hint.ts";
+import { TOOL_LOADING_INTERVAL_MS, toolLoadingIcon } from "../../utils/tool-loading-icon.ts";
+import { sanitizeToolResultText } from "../../utils/tool-result-sanitize.ts";
 
 const TOOL_VIEWPORT_WIDTH_RATIO = 0.8;
 
@@ -23,13 +23,6 @@ export function insetComponent(component: any): any {
 	};
 }
 
-export function oneLine(value: unknown, max = 72): string {
-	const text = sanitizeToolResultText(String(value ?? ""))
-		.replace(/\s+/g, " ")
-		.trim();
-	return text.length > max ? `${text.slice(0, max - 1)}…` : text;
-}
-
 function rawTextFromResult(result: any): string {
 	return Array.isArray(result?.content)
 		? result.content
@@ -233,6 +226,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 {
@@ -251,6 +246,9 @@ export class ExpandedToolIoView {
 	/** 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,
@@ -258,6 +256,7 @@ export class ExpandedToolIoView {
 		isError: boolean,
 		maxOutputLines = config.expandedPreviewMaxLines,
 		maxInputLines = config.expandedPreviewMaxLines,
+		flushLeft = false,
 	) {
 		this.theme = theme;
 		this.inputBody = inputBody;
@@ -265,6 +264,7 @@ export class ExpandedToolIoView {
 		this.isError = isError;
 		this.maxOutputLines = Math.max(1, maxOutputLines);
 		this.maxInputLines = Math.max(1, maxInputLines);
+		this.flushLeft = flushLeft;
 	}
 
 	setContent(
@@ -273,16 +273,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;
 		}
@@ -291,6 +294,7 @@ export class ExpandedToolIoView {
 		this.isError = isError;
 		this.maxOutputLines = nextOut;
 		this.maxInputLines = nextIn;
+		this.flushLeft = nextFlush;
 		this.invalidate();
 	}
 
@@ -348,7 +352,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);
@@ -363,7 +369,7 @@ export class ExpandedToolIoView {
 			section: ToolIoSection,
 			showMore: boolean,
 		) => {
-			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,
@@ -378,12 +384,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. */
@@ -654,6 +661,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;
@@ -663,10 +672,18 @@ export function renderExpandedToolResult(
 	if (inputBody.trim() || outputBody.trim()) {
 		let view: ExpandedToolIoView;
 		if (isExpandedToolIoView(lastComponent)) {
-			lastComponent.setContent(inputBody, outputBody, isError, maxLines, maxLines);
+			lastComponent.setContent(inputBody, outputBody, isError, maxLines, maxLines, flushLeft);
 			view = lastComponent;
 		} else {
-			view = new ExpandedToolIoView(theme, inputBody, outputBody, isError, maxLines, maxLines);
+			view = new ExpandedToolIoView(
+				theme,
+				inputBody,
+				outputBody,
+				isError,
+				maxLines,
+				maxLines,
+				flushLeft,
+			);
 		}
 		if (context) rememberIoView(context, view);
 		return view;
@@ -677,15 +694,6 @@ export function renderExpandedToolResult(
 	return new Text(theme.fg(color, renderCollapsedToolResult("Done")), 0, 0);
 }
 
-export function formatExpandHint(lineCount: number): string {
-	return ` (${lineCount} more line${lineCount === 1 ? "" : "s"} / click)`;
-}
-
-function expandHint(theme: any, lineCount: number, hovered = false): string {
-	// Keep interaction guidance neutral; it should not inherit success/error
-	// coloring from the tool result surrounding it.
-	return theme.fg(hovered ? "text" : "muted", formatExpandHint(lineCount));
-}
 const toolViewMarker = (id: number, section: ToolIoSection) =>
 	`_cc:v${id}:${section === "input" ? "i" : "o"}`;
 

package/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/extensions/utils/format.ts

@@ -0,0 +1,21 @@
+import { sanitizeToolResultText } from "./tool-result-sanitize.ts";
+
+/** 毫秒 → "1h 2m 3s"/"2m 3s"/"3s"；低于 1 秒返回 ""（省略）。 */
+export function formatDuration(ms: number): string {
+	const totalSec = Math.floor(ms / 1000);
+	if (totalSec < 1) return "";
+	const hours = Math.floor(totalSec / 3600);
+	const minutes = Math.floor((totalSec % 3600) / 60);
+	const seconds = totalSec % 60;
+	if (hours > 0) return `${hours}h ${minutes}m ${seconds}s`;
+	if (minutes > 0) return `${minutes}m ${seconds}s`;
+	return `${seconds}s`;
+}
+
+/** 文本单行化：去换行空白，超宽截断加省略号。 */
+export function oneLine(value: unknown, max = 96): string {
+	const text = sanitizeToolResultText(String(value ?? ""), 4096)
+		.replace(/\s+/g, " ")
+		.trim();
+	return text.length > max ? `${text.slice(0, max - 1)}…` : text;
+}

package/extensions/utils/fullscreen-detect.ts

@@ -1,7 +1,3 @@
-// fullscreen 模式探测：官方 fullscreen TUI（TuiAltScreen）由官方独占布局，
-// 插件渲染层应让位。检测方式是瞬时 setWidget 拿 tui 实例检查 mode。
-const PROBE_KEY = "cc-fullscreen-probe";
-
 /**
  * 官方 0.84+ 的 tui 引用是惰性 Proxy（createInteractiveTuiReference）：
  * 函数属性每次 get 都返回新包装，执行时才解析到当前实现。
@@ -13,26 +9,3 @@ export function isLazyProxyTui(tui: any): boolean {
 	const probe = tui.requestRender;
 	return typeof probe === "function" && probe !== tui.requestRender;
 }
-
-/**
- * 探测当前会话的 TUI 是否运行在官方 fullscreen 模式。
- * 无 setWidget 的环境（测试 mock）视为 regular。
- */
-export function isFullscreenUi(ctx: { ui?: any }): boolean {
-	if (typeof ctx?.ui?.setWidget !== "function") return false;
-	let fullscreen = false;
-	try {
-		ctx.ui.setWidget(PROBE_KEY, (tui: any) => {
-			fullscreen = tui?.mode === "fullscreen";
-			return { render: () => 0, invalidate() {} };
-		});
-	} catch {
-		// 探测失败按 regular 处理，避免误伤
-	}
-	try {
-		ctx.ui.setWidget(PROBE_KEY, undefined);
-	} catch {
-		// 忽略
-	}
-	return fullscreen;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-cc-extensions",
-	"version": "0.8.53",
+	"version": "0.8.55",
 	"license": "MIT",
 	"description": "A Pi productivity suite with Claude Code-style UI, context inspection, and agent/session references",
 	"type": "module",
@@ -41,7 +41,9 @@
 		"typecheck": "node scripts/typecheck.mjs",
 		"format": "biome format --write .",
 		"format:check": "biome format .",
-		"preversion": "npm run format:check && npm run typecheck && npm test",
+		"docs:tool-render": "node scripts/generate-tool-render-examples.mjs",
+		"lint": "biome check .",
+		"preversion": "npm run format && npm run lint && npm run typecheck && npm test && npm run docs:tool-render",
 		"release": "npm version patch && npm publish",
 		"release:minor": "npm version minor && npm publish",
 		"release:major": "npm version major && npm publish"

package/extensions/renderer/tool-diff/write-display-utils.ts

@@ -1,29 +0,0 @@
-export interface WriteCallSummaryOptions {
-	hasContent: boolean;
-	hasDetailedResultHeader: boolean;
-}
-
-export function splitWriteContentLines(content: string): string[] {
-	if (!content) {
-		return [];
-	}
-
-	const normalized = content.replace(/\r/g, "");
-	const lines = normalized.split("\n");
-	if (lines.length > 0 && lines[lines.length - 1] === "") {
-		lines.pop();
-	}
-	return lines;
-}
-
-export function countWriteContentLines(value: unknown): number {
-	return typeof value === "string" ? splitWriteContentLines(value).length : 0;
-}
-
-export function getWriteContentSizeBytes(value: unknown): number {
-	return typeof value === "string" ? Buffer.byteLength(value, "utf8") : 0;
-}
-
-export function shouldRenderWriteCallSummary(options: WriteCallSummaryOptions): boolean {
-	return options.hasContent && !options.hasDetailedResultHeader;
-}