pi-one-ui 0.8.0 → 0.9.1

package/extensions/layouts/{context/renderer/context-refresh.ts → transcript/renderer/transcript-refresh.ts}

@@ -11,22 +11,22 @@ import {
 
 // pi-coding-agent 类型声明中 AssistantMessageComponent 仅能以 value 形式使用，
 // updateContent/lastMessage 用结构化类型访问。
-type ContextComponentInternals = {
+type TranscriptComponentInternals = {
   lastMessage?: AssistantMessage;
   updateContent(message: AssistantMessage): void;
   invalidate?(): void;
 };
 
 /**
- * Refreshes one constructed context component.
+ * Refreshes one constructed transcript component.
  *
  * Assistant components receive their latest message, while tool components
  * refresh their display so resumed content returns to the current shell.
  */
-export function refreshContextComponent(value: unknown): boolean {
+export function refreshTranscriptComponent(value: unknown): boolean {
   if (!value || typeof value !== "object") return false;
   if (value instanceof AssistantMessageComponent) {
-    const self = value as unknown as ContextComponentInternals;
+    const self = value as unknown as TranscriptComponentInternals;
     if (self.lastMessage) self.updateContent(self.lastMessage);
     else self.invalidate?.();
     return true;
@@ -65,13 +65,13 @@ function assertCompactModeOutermost(): void {
  * This covers reload, resume and compaction paths where Pi rebuilds components
  * before the renderer patches are installed.
  */
-export function refreshMountedContext(tui?: unknown): void {
+export function refreshMountedTranscript(tui?: unknown): void {
   if (!tui || typeof (tui as any).getMountedRoots !== "function") return;
   // Fix patch order before refreshing so updateContent runs through the outer patch.
   assertCompactModeOutermost();
   walkComponentTree(tui, (value: any) => {
     try {
-      refreshContextComponent(value);
+      refreshTranscriptComponent(value);
     } catch {
       // Isolate one component failure; a later tree rebuild can retry it.
     }

package/extensions/layouts/{context → transcript}/thinking/compact-thinking.ts

@@ -33,8 +33,8 @@ import {
   formatThoughtDuration,
   styleCompactThinkingText,
 } from "../renderer/compact-mode.ts";
-import { refreshMountedContext } from "../renderer/context-refresh.ts";
 import { isToolTuiFullscreen } from "../renderer/tool/show-more-hint.ts";
+import { refreshMountedTranscript } from "../renderer/transcript-refresh.ts";
 
 // 保持导出兼容：渲染函数已并入 renderer/compact-mode.ts，这里 re-export。
 export {
@@ -1088,15 +1088,15 @@ function compactThinking(pi: ExtensionAPI) {
 
     // pi 在 reload/resume 时先于 session_start 用原始原型重建聊天组件
     // （rebuildChatFromMessages / renderCurrentSessionState）。由共享的
-    // refreshMountedContext 扫描挂载树重绘这些组件，恢复 compact 渲染、
+    // refreshMountedTranscript 扫描挂载树重绘这些组件，恢复 compact 渲染、
     // 持久化时长与工具调用显示。
-    refreshMountedContext(activeTui);
+    refreshMountedTranscript(activeTui);
     activeTui?.requestRender(true);
   });
 
   pi.on("session_tree", (_event, ctx) => {
     restoreDurationEntries(ctx.sessionManager.getBranch(), completedDurations);
-    refreshMountedContext(activeTui);
+    refreshMountedTranscript(activeTui);
     activeTui?.requestRender(true);
   });
 

package/extensions/tools/component-tree.ts

@@ -2,7 +2,7 @@
  * Shared recursive traversal for component trees.
  *
  * The implementation covers the children/getMountedRoots/seen traversal used by
- * context rendering, grouping and mouse packet handling.
+ * transcript rendering, grouping and mouse packet handling.
  *
  * The visitor runs once for every non-array object. Returning `false` stops
  * traversal into that node's children and mounted roots.

package/extensions/tools/patch-keys.ts

@@ -81,9 +81,6 @@ export const TOOL_GROUPING_GENERATION_KEY = Symbol.for(
 // ── 鼠标交互 ──
 export const TOOL_MOUSE_OWNER_KEY = Symbol.for("pi-one-ui.tool-mouse-owner");
 export const TOOL_MOUSE_TUI_SLOT = Symbol.for("pi-one-ui.tool-mouse-tui");
-export const SCROLL_BUTTON_STATE_SLOT = Symbol.for(
-  "pi-one-ui.scroll-button-state",
-);
 export const FLUSH_DOCKED_BASH_PATCH = Symbol.for(
   "pi-one-ui.flush-docked-bash-patch",
 );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-one-ui",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "A single, customizable Pi UI package with layout-oriented Context and Shell rendering for Pi.",
   "type": "module",
   "license": "MIT",
@@ -25,7 +25,8 @@
     "README.md",
     "README.en.md",
     "CHANGELOG.md",
-    "LICENSE"
+    "LICENSE",
+    "THIRD-PARTY-NOTICES.md"
   ],
   "scripts": {
     "format": "biome format --write extensions tests package.json tsconfig.json vitest.config.ts biome.json",

package/extensions/layouts/context/renderer/mouse/scroll.ts

@@ -1,216 +0,0 @@
-import {
-  getKeybindings,
-  type Keybinding,
-  matchesKey,
-  truncateToWidth,
-  visibleWidth,
-} from "@earendil-works/pi-tui";
-import { config } from "../../../../app/config/renderer.ts";
-import { isLazyProxyTui } from "../../../../tools/fullscreen-detect.ts";
-import {
-  patchRegistry,
-  SCROLL_BUTTON_STATE_SLOT,
-  TOOL_MOUSE_TUI_SLOT,
-} from "../../../../tools/patch-keys.ts";
-import { parseSgrMousePackets } from "./packets.ts";
-
-const PAGE_UP_INPUT =
-  /^\x1b\[5;9(?::[12])?~$|^\x1b\[57421;9(?::[12])?u$|^\x1b\[1;6A$/;
-const PAGE_DOWN_INPUT =
-  /^\x1b\[6;9(?::[12])?~$|^\x1b\[57422;9(?::[12])?u$|^\x1b\[1;6B$/;
-const SCROLL_BOTTOM_SHORTCUT = "ctrl+end";
-
-/**
- * 当前安装的 tui 宿主。宿主放本模块（滚动按钮/调度依赖它），
- * 由 mouse-interaction 经 setToolMouseTui 维护；跨模块一律经绑定/setter 访问。
- *
- * 状态镜像到 globalThis（Symbol 槽）：jiti 转译下经 re-export 链读取的
- * 模块级 let 绑定是初始值快照（死绑定，实测恒 null），函数调用才是活引用。
- * 跨模块读取一律用 getToolMouseTui()，避免拿到加载时的快照。
- */
-patchRegistry.ensure(TOOL_MOUSE_TUI_SLOT, () => null);
-export let toolMouseTui: any = null;
-export function getToolMouseTui(): any {
-  return patchRegistry.get(TOOL_MOUSE_TUI_SLOT);
-}
-export function setToolMouseTui(tui: any): void {
-  toolMouseTui = tui;
-  patchRegistry.install(TOOL_MOUSE_TUI_SLOT, tui);
-}
-
-// 滚动按钮状态同 toolMouseTui：镜像到 globalThis（Symbol 槽），跨模块读取
-// 一律用 getter（jiti 转译下模块级 let 绑定是初始值快照）。
-type ScrollButtonState = { visible: boolean; hovered: boolean; widget: any };
-function scrollButtonState(): ScrollButtonState {
-  return patchRegistry.ensure(SCROLL_BUTTON_STATE_SLOT, () => ({
-    visible: false,
-    hovered: false,
-    widget: null,
-  }));
-}
-export function getScrollButtonVisible(): boolean {
-  return scrollButtonState().visible;
-}
-export function getScrollButtonHovered(): boolean {
-  return scrollButtonState().hovered;
-}
-export function getScrollButtonWidget(): any {
-  return scrollButtonState().widget;
-}
-export function setScrollButtonVisible(visible: boolean): void {
-  scrollButtonState().visible = visible;
-}
-
-/** 返回是否发生变化（调用方据此决定是否需要重渲染）。 */
-export function setScrollButtonHovered(hovered: boolean): boolean {
-  if (hovered === scrollButtonState().hovered) return false;
-  scrollButtonState().hovered = hovered;
-  return true;
-}
-
-export function setScrollButtonWidget(widget: any): void {
-  scrollButtonState().widget = widget;
-}
-
-/** teardown 全量清零（visible/hovered/widget/sync 调度）。 */
-export function resetScrollButtonState(): void {
-  scrollButtonState().visible = false;
-  scrollButtonState().hovered = false;
-  scrollButtonState().widget = null;
-  scrollButtonSyncScheduled = false;
-}
-
-let scrollButtonSyncScheduled = false;
-
-// 交互开关只取决于配置模式：原实现按 isLazyProxyTui(toolMouseTui) 分两分支，
-// 两分支恒真（0.84+ 惰性 Proxy 下判定不再影响开关），折叠为单条件。
-export function toolMouseInteractionActive(): boolean {
-  return config.mode !== "off";
-}
-
-/** 惰性 Proxy 官方 fullscreen（TuiAltScreen）判定。 */
-export function fullscreenLazyTui(tui: any): boolean {
-  return isLazyProxyTui(tui) && tui.mode === "fullscreen";
-}
-
-/**
- * Reports whether fullscreen output is following the bottom of the context.
- */
-export function isFullscreenAtBottom(tui: any): boolean {
-  const following =
-    tui.isFollowingOutput ??
-    tui.getPrimaryScrollView?.()?.isFollowingEnd ??
-    true;
-  return Boolean(following);
-}
-
-function formatShortcut(shortcut: string): string {
-  return shortcut
-    .split("+")
-    .map((part) =>
-      part.length <= 1
-        ? part.toUpperCase()
-        : `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`,
-    )
-    .join("+");
-}
-
-export function isScrollBottomInput(data: string): boolean {
-  return matchesKey(data, SCROLL_BOTTOM_SHORTCUT);
-}
-
-function isScrollNavigationInput(data: string): boolean {
-  if (
-    matchesKey(data, "pageUp") ||
-    matchesKey(data, "pageDown") ||
-    PAGE_UP_INPUT.test(data) ||
-    PAGE_DOWN_INPUT.test(data) ||
-    // 官方 fullscreen viewport 的可滚动键（half-page/prompt/top/bottom）。
-    [
-      "tui.altScreen.pageUp",
-      "tui.altScreen.pageDown",
-      "tui.altScreen.halfPageUp",
-      "tui.altScreen.halfPageDown",
-      "tui.altScreen.previousPrompt",
-      "tui.altScreen.nextPrompt",
-      "tui.altScreen.top",
-      "tui.altScreen.bottom",
-    ].some((key) => getKeybindings().matches(data, key as Keybinding))
-  ) {
-    return true;
-  }
-  const packets = parseSgrMousePackets(data);
-  return Boolean(
-    packets?.some((packet) => {
-      const baseButton = packet.code & ~(4 | 8 | 16 | 32);
-      return packet.final === "M" && (baseButton === 64 || baseButton === 65);
-    }),
-  );
-}
-
-/**
- * Reports whether the context is at the bottom for the detected TUI mode.
- */
-function isAtContextBottom(tui: any): boolean {
-  // 惰性 Proxy fullscreen：官方 viewport 以 isFollowingOutput 判定是否在底部。
-  if (fullscreenLazyTui(tui)) return isFullscreenAtBottom(tui);
-  return true;
-}
-
-export function hideScrollButton(tui: any): void {
-  const changed = getScrollButtonVisible() || getScrollButtonHovered();
-  setScrollButtonVisible(false);
-  setScrollButtonHovered(false);
-  if (changed) tui.requestRender?.();
-}
-
-export function scheduleScrollButtonSync(tui: any, data: string): void {
-  if (
-    !fullscreenLazyTui(tui) ||
-    !toolMouseInteractionActive() ||
-    !isScrollNavigationInput(data) ||
-    scrollButtonSyncScheduled
-  )
-    return;
-  scrollButtonSyncScheduled = true;
-  const previousLines = tui.previousLines;
-  const check = (attempt: number) => {
-    scrollButtonSyncScheduled = false;
-    if (toolMouseTui !== tui) return;
-    // Pi renders on its own frame timer. Inspect the resulting viewport before
-    // showing the button so empty or non-scrollable contexts never flash it.
-    const rendered = tui.previousLines !== previousLines;
-    // fullscreen 下 isFollowingOutput 是即时状态，无需等待官方帧渲染。
-    if (!rendered && attempt < 4 && !fullscreenLazyTui(tui)) {
-      scrollButtonSyncScheduled = true;
-      const timer = setTimeout(() => check(attempt + 1), 16);
-      if (typeof timer === "object" && timer !== null && "unref" in timer) {
-        (timer as { unref: () => void }).unref();
-      }
-      return;
-    }
-    const nextVisible = !isAtContextBottom(tui);
-    if (nextVisible !== getScrollButtonVisible()) {
-      setScrollButtonVisible(nextVisible);
-      tui.requestRender?.();
-    }
-  };
-  process.nextTick(() => check(0));
-}
-
-export function updateScrollButtonFromInput(tui: any, data: string): void {
-  if (!fullscreenLazyTui(tui) || !toolMouseInteractionActive()) return;
-  if (matchesKey(data, "enter") || matchesKey(data, "return"))
-    hideScrollButton(tui);
-}
-
-export function renderScrollButton(width: number, theme: any): string[] {
-  if (!getScrollButtonVisible() || !fullscreenLazyTui(toolMouseTui)) return [];
-  const shortcut = formatShortcut(SCROLL_BOTTOM_SHORTCUT);
-  const label = theme.fg(
-    getScrollButtonHovered() ? "text" : "accent",
-    `[ ↓ Back to bottom · ${shortcut} ]`,
-  );
-  const leftPad = Math.max(0, Math.floor((width - visibleWidth(label)) / 2));
-  return [`${" ".repeat(leftPad)}${truncateToWidth(label, width, "…")}`];
-}