pi-one-ui 0.1.1

package/extensions/transcript/renderer/tool/show-more-hint.ts

@@ -0,0 +1,42 @@
+/**
+ * show-more 提示文本：fullscreen 下鼠标 hover/click 可用，提示 "click to show more"；
+ * 其他模式（regular 保留终端原生 scrollback、不启用鼠标上报）提示默认展开快捷键。
+ *
+ * tui 模式由 mouse-interaction 在 renderer 回调中维护；未安装时按 fullscreen 处理，
+ * 保证纯渲染测试与既有行为不变。
+ */
+import { getKeybindings } from "@earendil-works/pi-tui";
+
+let toolTuiFullscreen: boolean | undefined;
+
+export function setToolTuiFullscreen(value: boolean): void {
+  toolTuiFullscreen = value;
+}
+
+export function isToolTuiFullscreen(): boolean {
+  return toolTuiFullscreen !== false;
+}
+
+function formatKeyPart(part: string): string {
+  // 与 pi 内置 keybinding-hints 一致：macOS 上 alt 显示为 option
+  return process.platform === "darwin" && part.toLowerCase() === "alt"
+    ? "option"
+    : part;
+}
+
+/** 默认展开快捷键（app.tools.expand）显示文本；未配置时回退 ctrl+o。 */
+export function expandShortcutText(): string {
+  const keys = getKeybindings().getKeys("app.tools.expand");
+  if (keys.length === 0) return "ctrl+o";
+  return keys
+    .join("/")
+    .split("/")
+    .map((part) => part.split("+").map(formatKeyPart).join("+"))
+    .join("/");
+}
+
+export function showMoreHintText(): string {
+  return isToolTuiFullscreen()
+    ? "click to show more"
+    : `${expandShortcutText()} to show more`;
+}

package/extensions/transcript/renderer/transcript-refresh.ts

@@ -0,0 +1,79 @@
+import type { AssistantMessage } from "@earendil-works/pi-ai";
+import {
+  AssistantMessageComponent,
+  ToolExecutionComponent,
+} from "@earendil-works/pi-coding-agent";
+import { walkComponentTree } from "../../tools/component-tree.ts";
+import {
+  COMPACT_MODE_PATCH_KEY,
+  patchRegistry,
+} from "../../tools/patch-keys.ts";
+
+// pi-coding-agent 类型声明中 AssistantMessageComponent 仅能以 value 形式使用，
+// updateContent/lastMessage 用结构化类型访问。
+type TranscriptComponentInternals = {
+  lastMessage?: AssistantMessage;
+  updateContent(message: AssistantMessage): void;
+  invalidate?(): void;
+};
+
+/**
+ * 重绘单个已构造的组件：assistant 用最新消息重渲染（compact thinking），
+ * tool 强制 updateDisplay（其内容可能仍在旧 shell 容器中）。
+ * 不吞异常——由调用方决定如何处理失败。
+ */
+export function refreshTranscriptComponent(value: unknown): boolean {
+  if (!value || typeof value !== "object") return false;
+  if (value instanceof AssistantMessageComponent) {
+    const self = value as unknown as TranscriptComponentInternals;
+    if (self.lastMessage) self.updateContent(self.lastMessage);
+    else self.invalidate?.();
+    return true;
+  }
+  if (value instanceof ToolExecutionComponent) {
+    // updateDisplay 是私有方法，但它是 resume 后让内容回到正确
+    // shell 容器的唯一入口（原型链已含全局工具渲染补丁）。
+    (value as unknown as { updateDisplay(): void }).updateDisplay();
+    return true;
+  }
+  return false;
+}
+
+/**
+ * 扫描挂载树，重绘所有已构造的 assistant/tool 组件。
+ * 用于 reload/resume/compaction 后"pi 用原始原型重建、补丁事后才装"的场景。
+ * 遍历 value.children 与 value.getMountedRoots?.()（seen 集合防环），
+ * 单个组件失败用 try/catch 隔离，不影响其余组件。
+ */
+
+/**
+ * 补丁链序不变量：compact 模式下 compact-mode 必须位于 compact-thinking
+ * 外层（round 摘要才能聚合工具统计）。resume/reload 后若无新消息，
+ * message_update 触发的重新认领不会执行，这里在任何重绘前先断言一次。
+ * 断言幂等：链序已正确时无操作；mode=on 时也安全（外层走 pass-through）。
+ */
+function assertCompactModeOutermost(): void {
+  try {
+    const patch = patchRegistry.get<{ assertAssistantOwnership?: () => void }>(
+      COMPACT_MODE_PATCH_KEY,
+    );
+    if (patch && typeof patch.assertAssistantOwnership === "function") {
+      patch.assertAssistantOwnership();
+    }
+  } catch {
+    // 无 compact-mode 补丁或断言失败时跳过，扫描仍会执行。
+  }
+}
+
+export function refreshMountedTranscript(tui?: unknown): void {
+  if (!tui || typeof (tui as any).getMountedRoots !== "function") return;
+  // 先修正链序再重绘：扫描触发 updateContent 时 compact-mode 已在外层。
+  assertCompactModeOutermost();
+  walkComponentTree(tui, (value: any) => {
+    try {
+      refreshTranscriptComponent(value);
+    } catch {
+      // 单个组件失败不阻断其余组件；后续 session_tree/重绘再试。
+    }
+  });
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "pi-one-ui",
+  "version": "0.1.1",
+  "description": "A single, customizable Pi UI package combining Zentui shell chrome with Claude Code-style transcript rendering.",
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "extensions",
+    "themes",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "npm run test:node && npm run test:vitest",
+    "test:node": "node --test tests/config.test.ts tests/one-ui-integration.test.ts tests/transcript-*.test.ts",
+    "format": "biome format --write extensions tests package.json tsconfig.json biome.json",
+    "format:check": "biome format extensions tests package.json tsconfig.json biome.json",
+    "lint": "biome check extensions/index.ts extensions/app/panel.ts extensions/app/presets.ts package.json tsconfig.json biome.json",
+    "test:vitest": "vitest run tests/shell-*.test.ts",
+    "verify": "npm run format:check && npm run lint && npm run typecheck && npm test",
+    "pack:check": "npm pack --dry-run",
+    "pi:dev": "${PI_BIN:-pi} --no-extensions -e ./extensions/index.ts",
+    "pi:install-local": "${PI_BIN:-pi} install ./ -l"
+  },
+  "dependencies": {
+    "@shikijs/cli": "^4.0.2",
+    "grok-mermaid": "^0.2.2",
+    "jiti": "^2.7.0"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": ">=0.84.0",
+    "@earendil-works/pi-coding-agent": ">=0.84.0",
+    "@earendil-works/pi-tui": ">=0.84.0"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "pi": {
+    "extensions": [
+      "./extensions/index.ts"
+    ],
+    "themes": [
+      "./themes/cc-dark.json",
+      "./themes/cc-light.json"
+    ],
+    "image": "https://raw.githubusercontent.com/minuque/pi-cc-extensions/main/assets/readme/preview.png"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.5",
+    "@earendil-works/pi-ai": "^0.84.0",
+    "@earendil-works/pi-coding-agent": "^0.84.0",
+    "@earendil-works/pi-tui": "^0.84.0",
+    "@types/node": "^26.1.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.11"
+  }
+}

package/themes/cc-dark.json

@@ -0,0 +1,91 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "cc-dark",
+	"vars": {
+		"bg": "#131217",
+		"panel": "#1b1922",
+		"surface": "#211e2b",
+		"surfaceRaised": "#292533",
+		"border": "#36313f",
+		"borderMuted": "#292631",
+		"accent": "#5e9cff",
+		"accentBright": "#8ab4ff",
+		"purple": "#c084fc",
+		"pink": "#f472b6",
+		"cyan": "#67e8f9",
+		"blue": "#60a5fa",
+		"green": "#4ade80",
+		"red": "#fb7185",
+		"yellow": "#facc15",
+		"orange": "#fb923c",
+		"text": "#f5f5f5",
+		"muted": "#a1a1aa",
+		"dim": "#71717a",
+		"selectedBg": "#252035",
+		"userMessageBg": "#1e1e2e",
+		"toolPendingBg": "#1b1924",
+		"toolSuccessBg": "#1e1e2e",
+		"toolErrorBg": "#2a1b22",
+		"customMessageBg": "#211c30"
+	},
+	"colors": {
+		"accent": "accent",
+		"border": "border",
+		"borderAccent": "accent",
+		"borderMuted": "borderMuted",
+		"success": "green",
+		"error": "red",
+		"warning": "yellow",
+		"muted": "muted",
+		"dim": "dim",
+		"text": "text",
+		"thinkingText": "muted",
+		"selectedBg": "selectedBg",
+		"scrollbarThumb": "selectedBg",
+		"userMessageBg": "userMessageBg",
+		"userMessageText": "text",
+		"customMessageBg": "customMessageBg",
+		"customMessageText": "text",
+		"customMessageLabel": "purple",
+		"toolPendingBg": "toolPendingBg",
+		"toolSuccessBg": "toolSuccessBg",
+		"toolErrorBg": "toolErrorBg",
+		"toolTitle": "accentBright",
+		"toolOutput": "muted",
+		"mdHeading": "accentBright",
+		"mdLink": "cyan",
+		"mdLinkUrl": "muted",
+		"mdCode": "accentBright",
+		"mdCodeBlock": "text",
+		"mdCodeBlockBorder": "border",
+		"mdQuote": "muted",
+		"mdQuoteBorder": "accent",
+		"mdHr": "borderMuted",
+		"mdListBullet": "accent",
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "muted",
+		"syntaxComment": "#6b7280",
+		"syntaxKeyword": "pink",
+		"syntaxFunction": "accentBright",
+		"syntaxVariable": "blue",
+		"syntaxString": "green",
+		"syntaxNumber": "orange",
+		"syntaxType": "cyan",
+		"syntaxOperator": "text",
+		"syntaxPunctuation": "muted",
+		"thinkingOff": "muted",
+		"thinkingMinimal": "dim",
+		"thinkingLow": "blue",
+		"thinkingMedium": "accent",
+		"thinkingHigh": "accentBright",
+		"thinkingXhigh": "#4db9cd",
+		"thinkingMax": "cyan",
+		"bashMode": "green"
+	},
+	"export": {
+		"pageBg": "bg",
+		"cardBg": "panel",
+		"infoBg": "surface"
+	}
+}

package/themes/cc-light.json

@@ -0,0 +1,91 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "cc-light",
+	"vars": {
+		"bg": "#f7f7f8",
+		"panel": "#ffffff",
+		"surface": "#f3f1f7",
+		"surfaceRaised": "#ebe8f0",
+		"border": "#d4d0db",
+		"borderMuted": "#e5e2e9",
+		"accent": "#2563eb",
+		"accentBright": "#1d4ed8",
+		"purple": "#7e22ce",
+		"pink": "#be185d",
+		"cyan": "#0e7490",
+		"blue": "#2563eb",
+		"green": "#15803d",
+		"red": "#dc2626",
+		"yellow": "#a16207",
+		"orange": "#c2410c",
+		"text": "#242127",
+		"muted": "#625f68",
+		"dim": "#76717d",
+		"selectedBg": "#e3e8f5",
+		"userMessageBg": "#f0eef4",
+		"toolPendingBg": "#f1f3f9",
+		"toolSuccessBg": "#edf7f0",
+		"toolErrorBg": "#fceff1",
+		"customMessageBg": "#f4effa"
+	},
+	"colors": {
+		"accent": "accent",
+		"border": "border",
+		"borderAccent": "accent",
+		"borderMuted": "borderMuted",
+		"success": "green",
+		"error": "red",
+		"warning": "yellow",
+		"muted": "muted",
+		"dim": "dim",
+		"text": "text",
+		"thinkingText": "muted",
+		"selectedBg": "selectedBg",
+		"scrollbarThumb": "selectedBg",
+		"userMessageBg": "userMessageBg",
+		"userMessageText": "text",
+		"customMessageBg": "customMessageBg",
+		"customMessageText": "text",
+		"customMessageLabel": "purple",
+		"toolPendingBg": "toolPendingBg",
+		"toolSuccessBg": "toolSuccessBg",
+		"toolErrorBg": "toolErrorBg",
+		"toolTitle": "accentBright",
+		"toolOutput": "muted",
+		"mdHeading": "accentBright",
+		"mdLink": "cyan",
+		"mdLinkUrl": "muted",
+		"mdCode": "accentBright",
+		"mdCodeBlock": "text",
+		"mdCodeBlockBorder": "border",
+		"mdQuote": "muted",
+		"mdQuoteBorder": "accent",
+		"mdHr": "borderMuted",
+		"mdListBullet": "accent",
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "muted",
+		"syntaxComment": "#6b7280",
+		"syntaxKeyword": "pink",
+		"syntaxFunction": "accentBright",
+		"syntaxVariable": "blue",
+		"syntaxString": "green",
+		"syntaxNumber": "orange",
+		"syntaxType": "cyan",
+		"syntaxOperator": "text",
+		"syntaxPunctuation": "muted",
+		"thinkingOff": "muted",
+		"thinkingMinimal": "dim",
+		"thinkingLow": "blue",
+		"thinkingMedium": "accent",
+		"thinkingHigh": "accentBright",
+		"thinkingXhigh": "#4a8fa3",
+		"thinkingMax": "cyan",
+		"bashMode": "green"
+	},
+	"export": {
+		"pageBg": "bg",
+		"cardBg": "panel",
+		"infoBg": "surface"
+	}
+}