pi-one-ui 0.1.1 → 0.2.0

package/extensions/{transcript → layouts/context}/renderer/mouse/scroll.ts

@@ -5,14 +5,14 @@ import {
   visibleWidth,
   type Keybinding,
 } from "@earendil-works/pi-tui";
-import { config } from "../../../app/config/renderer.ts";
-import { isLazyProxyTui } from "../../../tools/fullscreen-detect.ts";
+import { config } from "../../../../app/config/renderer.ts";
+import { isLazyProxyTui } from "../../../../tools/fullscreen-detect.ts";
 import { parseSgrMousePackets } from "./packets.ts";
 import {
   patchRegistry,
   SCROLL_BUTTON_STATE_SLOT,
   TOOL_MOUSE_TUI_SLOT,
-} from "../../../tools/patch-keys.ts";
+} from "../../../../tools/patch-keys.ts";
 
 const ZENTUI_PAGE_UP_INPUT =
   /^\x1b\[5;9(?::[12])?~$|^\x1b\[57421;9(?::[12])?u$|^\x1b\[1;6A$/;
@@ -93,7 +93,9 @@ export function fullscreenLazyTui(tui: any): boolean {
   return isLazyProxyTui(tui) && tui.mode === "fullscreen";
 }
 
-/** 官方 fullscreen：是否已跟随 transcript 底部（按钮隐藏条件）。 */
+/**
+ * Reports whether fullscreen output is following the bottom of the context.
+ */
 export function isFullscreenAtBottom(tui: any): boolean {
   const following =
     tui.isFollowingOutput ??
@@ -146,7 +148,10 @@ function isScrollNavigationInput(data: string): boolean {
   );
 }
 
-function isAtTranscriptBottom(tui: any): boolean {
+/**
+ * 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;
@@ -173,7 +178,7 @@ export function scheduleScrollButtonSync(tui: any, data: string): void {
     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 transcripts never flash it.
+    // 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)) {
@@ -184,7 +189,7 @@ export function scheduleScrollButtonSync(tui: any, data: string): void {
       }
       return;
     }
-    const nextVisible = !isAtTranscriptBottom(tui);
+    const nextVisible = !isAtContextBottom(tui);
     if (nextVisible !== getScrollButtonVisible()) {
       setScrollButtonVisible(nextVisible);
       tui.requestRender?.();

package/extensions/{transcript → layouts/context}/renderer/tool/diff/diff-component.ts

@@ -2,9 +2,9 @@ import {
   DEFAULT_TOOL_DISPLAY_CONFIG,
   type DiffIndicatorMode,
   type ToolDisplayConfig,
-} from "../../../../app/config/renderer.ts";
+} from "../../../../../app/config/renderer.ts";
 import type { DiffPresentationMode } from "./diff-presentation.ts";
-import { RICH_DIFF_COMPONENT } from "../../../../tools/patch-keys.ts";
+import { RICH_DIFF_COMPONENT } from "../../../../../tools/patch-keys.ts";
 export { RICH_DIFF_COMPONENT };
 
 /** Snapshot or live getter — panel changes must apply on the next paint. */

package/extensions/{transcript → layouts/context}/renderer/tool/diff/diff-edit-render.ts

@@ -1,6 +1,6 @@
 import { Text, type Component } from "@earendil-works/pi-tui";
 import type { EditToolDetails } from "@earendil-works/pi-coding-agent";
-import { sanitizeToolResultText } from "../../../../tools/tool-result-sanitize.ts";
+import { sanitizeToolResultText } from "../../../../../tools/tool-result-sanitize.ts";
 import {
   getLineNumberWidth,
   parseDiff,

package/extensions/{transcript → layouts/context}/renderer/tool/diff/diff-highlight.ts

@@ -3,7 +3,7 @@ import {
   highlightCode,
 } from "@earendil-works/pi-coding-agent";
 import { sanitizeAnsiForThemedOutput } from "./ansi-utils.ts";
-import { sanitizeToolResultText } from "../../../../tools/tool-result-sanitize.ts";
+import { sanitizeToolResultText } from "../../../../../tools/tool-result-sanitize.ts";
 import { MAX_HL_CHARS, shikiHighlightCache } from "./shiki-highlight.ts";
 import { normalizeCodeWhitespace } from "./diff-text.ts";
 import {

package/extensions/{transcript → layouts/context}/renderer/tool/diff/diff-layout.ts

@@ -31,7 +31,7 @@ import {
   type SplitDiffRow,
 } from "./diff-inline.ts";
 import { formatMetaEntryRows } from "./diff-header.ts";
-import type { DiffIndicatorMode } from "../../../../app/config/renderer.ts";
+import type { DiffIndicatorMode } from "../../../../../app/config/renderer.ts";
 
 export interface RenderedRow {
   text: string;

package/extensions/{transcript → layouts/context}/renderer/tool/diff/diff-limits.ts

@@ -2,7 +2,7 @@ import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import {
   DEFAULT_TOOL_DISPLAY_CONFIG,
   type ToolDisplayConfig,
-} from "../../../../app/config/renderer.ts";
+} from "../../../../../app/config/renderer.ts";
 import { showMoreHintText } from "../show-more-hint.ts";
 import {
   buildCollapsedDiffHintText,

package/extensions/{transcript → layouts/context}/renderer/tool/diff/diff-palette.ts

@@ -5,7 +5,7 @@ import {
   readSgrColorSequence,
   toSgrParams,
 } from "./ansi-utils.ts";
-import { ansi256ToRgb } from "../../../../tools/ansi-color.ts";
+import { ansi256ToRgb } from "../../../../../tools/ansi-color.ts";
 import { fitToWidth } from "./diff-text.ts";
 import { mergeSpans, type DiffSpan } from "./diff-inline.ts";
 import type { DiffLineKind } from "./diff-parse.ts";

package/extensions/{transcript → layouts/context}/renderer/tool/diff/diff-presentation.ts

@@ -1,6 +1,6 @@
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { pluralize } from "./diff-text.ts";
-import type { ToolDisplayConfig } from "../../../../app/config/renderer.ts";
+import type { ToolDisplayConfig } from "../../../../../app/config/renderer.ts";
 
 export interface DiffSummaryStats {
   added: number;

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

@@ -1,5 +1,5 @@
 /**
- * Public entry surface for the diff renderer.
+ * Public entry layout for the diff renderer.
  *
  * Implementation is split across focused modules by concern:
  *   - diff-parse.ts        : diff string → line/meta/hunk/file entries + stats

package/extensions/{transcript → layouts/context}/renderer/tool/diff/diff-write-render.ts

@@ -4,7 +4,7 @@ import {
   visibleWidth,
   type Component,
 } from "@earendil-works/pi-tui";
-import { sanitizeToolResultText } from "../../../../tools/tool-result-sanitize.ts";
+import { sanitizeToolResultText } from "../../../../../tools/tool-result-sanitize.ts";
 import { showMoreHintText } from "../show-more-hint.ts";
 import { splitWriteContentLines } from "./diff-text.ts";
 import {

package/extensions/{transcript → layouts/context}/renderer/tool/diff/index.ts

@@ -8,7 +8,7 @@ import {
   renderWriteDiffResult,
   type DisplayConfigInput,
 } from "./diff-renderer.ts";
-import { DEFAULT_TOOL_DISPLAY_CONFIG } from "../../../../app/config/renderer.ts";
+import { DEFAULT_TOOL_DISPLAY_CONFIG } from "../../../../../app/config/renderer.ts";
 import {
   executeWriteWithMetadata,
   WriteExecutionMetadataStore,
@@ -142,6 +142,6 @@ export {
   type ToolDisplayConfig,
   type DiffViewMode,
   type DiffIndicatorMode,
-} from "../../../../app/config/renderer.ts";
+} from "../../../../../app/config/renderer.ts";
 export type { DisplayConfigInput } from "./diff-renderer.ts";
 export { WriteExecutionMetadataStore } from "./write-execution.ts";

package/extensions/{transcript → layouts/context}/renderer/tool/grouping.ts

@@ -12,21 +12,21 @@ import {
 import {
   TOOL_LOADING_INTERVAL_MS,
   toolLoadingIcon,
-} from "../../../tools/tool-loading-icon.ts";
+} from "../../../../tools/tool-loading-icon.ts";
 import { isToolTuiFullscreen, showMoreHintText } from "./show-more-hint.ts";
 import {
   stripAnsi,
   stripBackgroundAnsi,
   stripLeadingStatusIcon,
-} from "../../../tools/ansi-text.ts";
-import { walkComponentTree } from "../../../tools/component-tree.ts";
+} from "../../../../tools/ansi-text.ts";
+import { walkComponentTree } from "../../../../tools/component-tree.ts";
 import { humanizeToolLabel, toolCallSummary } from "./names.ts";
 import {
   patchRegistry,
   TOOL_GROUPING_GENERATION_KEY as GENERATION_KEY,
   TOOL_GROUPING_PARENT_KEY as PARENT_KEY,
   TOOL_GROUPING_PATCH_KEY as PATCH_KEY,
-} from "../../../tools/patch-keys.ts";
+} from "../../../../tools/patch-keys.ts";
 
 const NON_GROUPABLE = new Set(["edit", "write", "apply_patch"]);
 

package/extensions/{transcript → layouts/context}/renderer/tool/message-display.ts

@@ -7,10 +7,10 @@ import { Markdown, Spacer, Text } from "@earendil-works/pi-tui";
 import {
   MESSAGE_DISPLAY_PATCH,
   patchRegistry,
-} from "../../../tools/patch-keys.ts";
-import { config } from "../../../app/config/renderer.ts";
+} from "../../../../tools/patch-keys.ts";
+import { config } from "../../../../app/config/renderer.ts";
 import { showMoreHintText } from "./show-more-hint.ts";
-import { walkComponentTree } from "../../../tools/component-tree.ts";
+import { walkComponentTree } from "../../../../tools/component-tree.ts";
 
 /**
  * 接管三个消息组件（`<skill>` 块、压缩摘要、分支摘要），ccstyle on 时渲染为
@@ -172,7 +172,9 @@ export function isMessageDisplayComponent(value: any): boolean {
   );
 }
 
-/** 遍历当前 transcript，让已挂载的消息组件按当前 mode 重渲染（/ccstyle on|off 切换）。 */
+/**
+ * Refreshes mounted context message components after a mode change.
+ */
 export function refreshMessageDisplays(root: any): void {
   walkComponentTree(root, (value: any) => {
     if (isMessageDisplayComponent(value)) {

package/extensions/{transcript → layouts/context}/renderer/tool/names.ts

@@ -1,5 +1,5 @@
-import { config } from "../../../app/config/renderer.ts";
-import { oneLine } from "../../../tools/format.ts";
+import { config } from "../../../../app/config/renderer.ts";
+import { oneLine } from "../../../../tools/format.ts";
 
 function clip(value: unknown): string {
   return oneLine(value, config.toolInputNameLength);

package/extensions/{transcript → layouts/context}/renderer/tool/result.ts

@@ -5,13 +5,13 @@ import {
   wrapTextWithAnsi,
 } from "@earendil-works/pi-tui";
 import { inspect } from "node:util";
-import { config } from "../../../app/config/renderer.ts";
+import { config } from "../../../../app/config/renderer.ts";
 import { showMoreHintText } from "./show-more-hint.ts";
 import {
   TOOL_LOADING_INTERVAL_MS,
   toolLoadingIcon,
-} from "../../../tools/tool-loading-icon.ts";
-import { sanitizeToolResultText } from "../../../tools/tool-result-sanitize.ts";
+} from "../../../../tools/tool-loading-icon.ts";
+import { sanitizeToolResultText } from "../../../../tools/tool-result-sanitize.ts";
 
 const TOOL_VIEWPORT_WIDTH_RATIO = 0.8;
 

package/extensions/{features/agent-summary → layouts/context/summary}/core.ts

@@ -9,7 +9,7 @@
  */
 
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { formatDuration } from "../../tools/format.ts";
+import { formatDuration } from "../../../tools/format.ts";
 export { formatDuration };
 
 /** 工具分类。 */

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

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

package/extensions/{shell → layouts/editor}/accent-rail-editor.ts

@@ -1,16 +1,16 @@
 import type { Theme } from "@earendil-works/pi-coding-agent";
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import {
-  applyOwnedSurfaceBackground,
+  applyOwnedLayoutBackground,
   fillTerminalLine,
   renderCompletionRows,
 } from "./completion-menu.ts";
-import type { ZentuiConfig } from "../app/config/shell.ts";
+import type { ZentuiConfig } from "../../app/config/shell.ts";
 import { sanitizeEditorMetadataText } from "./editor-metadata-format.ts";
 import {
   renderStyleForSourceOrFallback,
   type SourceStyleFallback,
-} from "./style.ts";
+} from "../../shared/style.ts";
 
 export const ACCENT_RAIL_CHROME_WIDTH = 2;
 
@@ -90,17 +90,17 @@ export function renderAccentRailEditorFrame({
   ];
   const transparent =
     config.components.editor.styles["accent-rail"].transparent;
-  const surface = rows.map((line) => {
+  const layout = rows.map((line) => {
     const railCell = transparent
       ? rail
-      : applyOwnedSurfaceBackground(uiTheme, rail);
+      : applyOwnedLayoutBackground(uiTheme, rail);
     const bodyText = ` ${fillTerminalLine(line, contentWidth)}`;
     const body = transparent
       ? bodyText
-      : applyOwnedSurfaceBackground(uiTheme, bodyText);
+      : applyOwnedLayoutBackground(uiTheme, bodyText);
     return `${railCell}${body}`;
   });
-  const autocompleteSurface = renderCompletionRows({
+  const autocompleteLayout = renderCompletionRows({
     lines: autocompleteLines,
     width,
     theme: uiTheme,
@@ -108,5 +108,5 @@ export function renderAccentRailEditorFrame({
     ownedBackground: !transparent,
   });
 
-  return clampLines([...surface, ...autocompleteSurface], width);
+  return clampLines([...layout, ...autocompleteLayout], width);
 }

package/extensions/{shell → layouts/editor}/completion-menu.ts

@@ -70,10 +70,7 @@ export function fillTerminalLine(content: string, width: number): string {
   return `${truncated}${" ".repeat(Math.max(0, width - renderedWidth))}`;
 }
 
-export function applyOwnedSurfaceBackground(
-  theme: Theme,
-  text: string,
-): string {
+export function applyOwnedLayoutBackground(theme: Theme, text: string): string {
   try {
     const background = theme.getBgAnsi("userMessageBg");
     const restored = text.replace(SGR_SEQUENCE, (sequence) =>
@@ -136,7 +133,7 @@ export function renderCompletionRows({
       width,
     );
     const surfaced = ownedBackground
-      ? applyOwnedSurfaceBackground(theme, content)
+      ? applyOwnedLayoutBackground(theme, content)
       : content;
     return truncateTerminalLine(surfaced, width);
   });
@@ -176,7 +173,7 @@ export function renderCompletionPalette({
     return [...rows, truncateToWidth(separator, safeWidth, "")];
   const helpText = fillTerminalLine(helpLabel(safeWidth), safeWidth);
   const help = ownedBackground
-    ? applyOwnedSurfaceBackground(theme, helpText)
+    ? applyOwnedLayoutBackground(theme, helpText)
     : helpText;
   return [
     ...rows,