@linxiraos/pi-tui 1.1.17 → 1.1.18

package/CHANGELOG.md

@@ -2,10 +2,9 @@
 
 ## [Unreleased]
 
-## [1.1.16] - 2026-09-19
+## [1.1.18] - 2026-09-22
 
-- 上游 v18.2.5 同步:每击键/每帧渲染浪费削减、billing 摘要重构、stream 状态分段、paint-listener 通知管线。
-- 主题、覆盖层、chat、工具渲染器与 apps 组件自 coding-agent 迁入本包(模块迁移)。
+- 新增宿主可注入文本层:`setTuiTextSource` / `tuiText` / `tuiTextFmt`——内联英文为永久 fallback,宿主(coding-agent)注入活翻译代理,面板文本随 `/language` 即时切换;pi-tui 独立使用零依赖。
 
 ## [9.8.0] - 2026-02-01
 
@@ -381,6 +380,11 @@ Initial release under @oh-my-pi scope. See previous releases at [badlogic/pi-mon
 
 - Added `getText()` method to Text component for retrieving current text content
 
+## [1.1.16] - 2026-09-19
+
+- 上游 v18.2.5 同步:每击键/每帧渲染浪费削减、billing 摘要重构、stream 状态分段、paint-listener 通知管线。
+- 主题、覆盖层、chat、工具渲染器与 apps 组件自 coding-agent 迁入本包(模块迁移)。
+
 ## [0.50.0] - 2026-01-26
 
 ### Added

package/dist/types/i18n.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Host-injectable UI text source for @linxiraos/pi-tui.
+ *
+ * pi-tui must not depend on the coding-agent i18n bundle (dependency
+ * direction: coding-agent -> pi-tui). Instead, every user-visible string in
+ * a tui component goes through `tuiText(key, englishFallback)`: the inline
+ * English is the permanent fallback, and the host (coding-agent) registers
+ * a text source that resolves keys against its localised catalogue. The
+ * source is consulted on every call, so a runtime language switch takes
+ * effect immediately without rebuilding components.
+ *
+ * Key naming: reuse the coding-agent Messages key verbatim when one exists
+ * (e.g. `ssFooterSuffix`); otherwise add a new flat camelCase key namespaced
+ * by the panel (e.g. `mcpAddStepTransport`) to Messages/en/zh.
+ */
+export type TuiTextSource = (key: string) => string | undefined;
+/**
+ * Register the host text source. Pass `undefined` to reset to English
+ * fallbacks (the default; also the headless behavior — no rendering surface
+ * exists without the interactive CLI host).
+ */
+export declare function setTuiTextSource(source: TuiTextSource | undefined): void;
+/**
+ * Resolve a UI string: host catalogue first, inline English fallback second.
+ * Called per render, so language switches apply live.
+ */
+export declare function tuiText(key: string, fallback: string): string;
+/**
+ * Resolve a formatted UI string (`*Fmt` keys). `%s` / `%d` placeholders in
+ * the resolved text are substituted positionally with `args`.
+ */
+export declare function tuiTextFmt(key: string, fallback: string, ...args: (string | number)[]): string;

package/dist/types/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./autocomplete.js";
+export * from "./i18n.js";
 export * from "./chat/transcript-browser.js";
 export * from "./components/box.js";
 export * from "./components/cancellable-loader.js";

package/dist/types/overlays/agent-hub.d.ts

@@ -20,7 +20,7 @@ import { type AgentActivitySource } from "./agent-activity.js";
 import type { KeyId } from "../app-keybindings.js";
 import type { MessageRenderer } from "../chat/extension-types.js";
 import type { AgentLifecycleLike, IrcBusLike } from "./agent-hub-types.js";
-import { type AgentRecordLike, type AgentHubRegistry } from "./agent-hub-types.js";
+import { type AgentRecordLike, type AgentHubRegistry, type AgentStatus } from "./agent-hub-types.js";
 import type { SessionObserverRegistry } from "./session-observer-registry.js";
 import { type AgentTranscriptSource } from "./agent-transcript-viewer.js";
 import type { AgentRoleDisplay } from "./agent-hub-renderer.js";
@@ -40,6 +40,11 @@ export interface AgentHubRemote {
     /** Mirrors readFileIncremental: text from fromByte (complete JSONL lines), newSize = next fromByte base; null = temporarily unavailable. */
     readTranscript(id: string, fromByte: number): Promise<AgentHubRemoteTranscript | null>;
 }
+/** Localizable status words; keys resolve per render so /language switches live. */
+export declare const AGENT_STATUS_TEXT: Record<AgentStatus, {
+    key: string;
+    fallback: string;
+}>;
 export interface AgentHubDeps<TRecord extends AgentRecordLike = AgentRecordLike> {
     /** Progress/status snapshot source (task lifecycle + progress channels). */
     observers: SessionObserverRegistry;

package/dist/types/overlays/agent-transcript-viewer.d.ts

@@ -22,7 +22,7 @@ import type { AgentLifecycleLike } from "./agent-hub-types.js";
 import type { AgentHubRegistry } from "./agent-hub-types.js";
 import type { SessionMessageEntryLike } from "../chat/transcript-entry.js";
 import type { SessionObserverRegistry } from "./session-observer-registry.js";
-import type { AgentHubRemote } from "./agent-hub.js";
+import { type AgentHubRemote } from "./agent-hub.js";
 /** Parsed message and model metadata relevant to a transcript viewer. */
 export type AgentTranscriptEntry = SessionMessageEntryLike | {
     type: "model_change";

package/dist/types/overlays/btw-panel.d.ts

@@ -14,6 +14,7 @@ export declare class BtwPanelComponent extends OverlayPanel {
     markComplete(): void;
     /** Visual confirmation that `c` copied the answer to the clipboard. */
     markCopied(): void;
+    render(width: number): readonly string[];
     /** Shows that the completed answer is being promoted into the chat session. */
     markBranching(): void;
     markAborted(): void;

package/dist/types/overlays/composer-shape-registry.d.ts

@@ -2,42 +2,18 @@ import { type ComposerStyle } from "../index.js";
 import type { SubmenuOption } from "./settings-defs.js";
 /** Composer shape id; extensions may register additional values at runtime. */
 export type ComposerShape = string;
-/** Built-in composer choices and their shared settings/setup copy. */
-export declare const BUILTIN_COMPOSER_SHAPES: readonly [{
-    readonly value: "band";
-    readonly label: "Status Band (Default)";
-    readonly description: "Flush soft-capped status band above a curved prompt, no frame";
-}, {
-    readonly value: "box";
-    readonly label: "Rounded Box";
-    readonly description: "Status line embedded in top border, compact 2-line prompt";
-}, {
-    readonly value: "claude";
-    readonly label: "Claude Code";
-    readonly description: "Full-width horizontal rules above and below, status line at bottom";
-}, {
-    readonly value: "pi";
-    readonly label: "Pi";
-    readonly description: "Framed horizontal rules with status line at bottom";
-}, {
-    readonly value: "borderless";
-    readonly label: "Borderless";
-    readonly description: "Clean prompt glyph with status line at bottom, no box borders";
-}, {
-    readonly value: "rule";
-    readonly label: "Top Rule Dock";
-    readonly description: "Single top rule with status docked onto it and below";
-}, {
-    readonly value: "field";
-    readonly label: "Compact Field";
-    readonly description: "Filled one-row field with accent end caps";
-}, {
-    readonly value: "rail";
-    readonly label: "Accent Rail";
-    readonly description: "Filled one-row field anchored by a single accent rail";
-}];
+/**
+ * Built-in composer choices and their shared settings/setup copy. Labels and
+ * descriptions resolve through `tuiText` on every read (getter, not cached
+ * field) so a runtime language switch applies to the next rendered selector.
+ */
+export declare const BUILTIN_COMPOSER_SHAPES: {
+    value: string;
+    readonly label: string;
+    readonly description: string;
+}[];
 /** Built-in composer ids used by tests and non-runtime consumers. */
-export declare const COMPOSER_SHAPE_VALUES: ("band" | "borderless" | "box" | "claude" | "field" | "pi" | "rail" | "rule")[];
+export declare const COMPOSER_SHAPE_VALUES: string[];
 /** Visual composer style and selector copy registered by an extension. */
 export interface ComposerShapeDefinition {
     label: string;

package/dist/types/overlays/history-search.d.ts

@@ -12,5 +12,7 @@ import { OverlayPanel } from "../chrome/overlay-box.js";
 export declare class HistorySearchComponent extends OverlayPanel {
     #private;
     constructor(historyStorage: HistorySource, onSelect: (prompt: string) => void, onCancel: () => void);
+    /** Re-resolve the panel title every render so a live language switch applies. */
+    render(width: number): readonly string[];
     handleInput(keyData: string): void;
 }

package/dist/types/overlays/login-dialog.d.ts

@@ -40,4 +40,5 @@ export declare class LoginDialogComponent extends OverlayPanel {
     /** Route non-bracketed paste transports into the active login input. */
     pasteText(text: string): void;
     handleInput(data: string): void;
+    render(width: number): readonly string[];
 }

package/dist/types/overlays/logout-account-selector.d.ts

@@ -12,4 +12,5 @@ export declare class LogoutAccountSelectorComponent extends OverlayPanel {
     #private;
     constructor(providerName: string, accounts: LogoutAccount[], onSelect: (account: LogoutAccount) => void, onCancel: () => void);
     handleInput(keyData: string): void;
+    render(width: number): readonly string[];
 }

package/dist/types/overlays/move-overlay.d.ts

@@ -1,10 +1,3 @@
-/**
- * `/move` overlay: a path input with live directory autocomplete.
- *
- * Rendered as a centered modal via `showHookCustom(..., { overlay: true })`.
- * The user types a path, Tab autocompletes the highlighted directory, and Enter
- * confirms — yielding the resolved directory string (or `undefined` on cancel).
- */
 import { type Component, type Focusable } from "../index.js";
 export interface MoveOverlayResult {
     directory: string;

package/dist/types/overlays/oauth-selector.d.ts

@@ -38,4 +38,5 @@ export declare class OAuthSelectorComponent extends OverlayPanel {
      * drives the hover band, and a left click selects and confirms like Enter.
      */
     routeMouse(event: SgrMouseEvent, line: number, _col: number): void;
+    render(width: number): readonly string[];
 }

package/dist/types/overlays/queue-mode-selector.d.ts

@@ -8,4 +8,5 @@ export declare class QueueModeSelectorComponent extends OverlayPanel {
     constructor(currentMode: "all" | "one-at-a-time", onSelect: (mode: "all" | "one-at-a-time") => void, onCancel: () => void);
     getSelectList(): SelectList;
     routeMouse(event: SgrMouseEvent, line: number, col: number): void;
+    render(width: number): readonly string[];
 }

package/dist/types/overlays/reset-usage-selector.d.ts

@@ -20,4 +20,5 @@ export declare class ResetUsageSelectorComponent extends OverlayPanel {
     #private;
     constructor(accounts: ResetUsageAccount[], onSelect: (account: ResetUsageAccount) => void, onCancel: () => void);
     handleInput(keyData: string): void;
+    render(width: number): readonly string[];
 }

package/dist/types/overlays/settings-defs.d.ts

@@ -1,4 +1,3 @@
-/** Schema-independent display definitions for the settings overlay. */
 import type { SymbolKey } from "../theme/symbols.js";
 export type SettingTab = "appearance" | "model" | "interaction" | "context" | "memory" | "files" | "shell" | "tools" | "tasks" | "providers";
 /** Tab display metadata - icon is resolved via theme.symbol() */

package/dist/types/overlays/show-images-selector.d.ts

@@ -8,4 +8,5 @@ export declare class ShowImagesSelectorComponent extends OverlayPanel {
     constructor(currentValue: boolean, onSelect: (show: boolean) => void, onCancel: () => void);
     getSelectList(): SelectList;
     routeMouse(event: SgrMouseEvent, line: number, col: number): void;
+    render(width: number): readonly string[];
 }

package/dist/types/overlays/theme-selector.d.ts

@@ -9,4 +9,5 @@ export declare class ThemeSelectorComponent extends OverlayPanel {
     constructor(currentTheme: string, themes: string[], onSelect: (themeName: string) => void, onCancel: () => void, onPreview: (themeName: string) => void);
     getSelectList(): SelectList;
     routeMouse(event: SgrMouseEvent, line: number, col: number): void;
+    render(width: number): readonly string[];
 }

package/dist/types/overlays/thinking-selector.d.ts

@@ -9,4 +9,5 @@ export declare class ThinkingSelectorComponent extends OverlayPanel {
     constructor(currentLevel: Effort, availableLevels: Effort[], onSelect: (level: Effort) => void, onCancel: () => void);
     getSelectList(): SelectList;
     routeMouse(event: SgrMouseEvent, line: number, col: number): void;
+    render(width: number): readonly string[];
 }

package/dist/types/overlays/tree-selector.d.ts

@@ -86,6 +86,8 @@ export declare class TreeSelectorComponent extends OverlayPanel {
     constructor(tree: TreeSelectorNode[], currentLeafId: string | null, terminalHeight: number, onSelect: (entryId: string, options: {
         summarize: boolean;
     }) => void, onCancel: () => void, onLabelChangeCallback?: ((entryId: string, label: string | undefined) => void) | undefined, initialFilterMode?: FilterMode);
+    /** Re-resolve the panel title every render so a live language switch applies. */
+    render(width: number): readonly string[];
     handleInput(keyData: string): void;
     getTreeList(): TreeList;
 }

package/dist/types/setup/scenes/sign-in.d.ts

@@ -8,7 +8,7 @@ import type { SetupSceneHost, SetupTab } from "./types.js";
 export declare class SignInTab implements SetupTab {
     #private;
     readonly id = "sign-in";
-    readonly label = "Sign in";
+    get label(): string;
     constructor(host: SetupSceneHost);
     /** Modal while an OAuth flow is running so the scene won't switch tabs or finish. */
     get modal(): boolean;

package/dist/types/setup/scenes/web-search.d.ts

@@ -9,7 +9,7 @@ import type { SetupSceneHost, SetupTab } from "./types.js";
 export declare class WebSearchTab implements SetupTab {
     #private;
     readonly id = "web-search";
-    readonly label = "Web search";
+    get label(): string;
     readonly modal = false;
     constructor(host: SetupSceneHost);
     onActivate(): void;

package/package.json

@@ -1,10 +1,10 @@
 {
 	"type": "module",
 	"name": "@linxiraos/pi-tui",
-	"version": "1.1.17",
+	"version": "1.1.18",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://linxira-os.github.io/zeta/",
-	"author": "Stencil Labs, Inc.",
+	"author": "Linxira-OS",
 	"contributors": [
 		"Mario Zechner"
 	],
@@ -37,14 +37,14 @@
 		"fmt": "oxfmt --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts'"
 	},
 	"dependencies": {
-		"@linxiraos/pi-natives": "1.1.17",
-		"@linxiraos/pi-utils": "1.1.17",
-		"@linxiraos/pi-omptype": "1.1.17",
-		"@linxiraos/pi-agent-core": "1.1.17",
-		"@linxiraos/pi-ai": "1.1.17",
-		"@linxiraos/pi-catalog": "1.1.17",
-		"@linxiraos/pi-wire": "1.1.17",
-		"@linxiraos/pi-snapcompact": "1.1.17"
+		"@linxiraos/pi-natives": "1.1.18",
+		"@linxiraos/pi-utils": "1.1.18",
+		"@linxiraos/pi-omptype": "1.1.18",
+		"@linxiraos/pi-agent-core": "1.1.18",
+		"@linxiraos/pi-ai": "1.1.18",
+		"@linxiraos/pi-catalog": "1.1.18",
+		"@linxiraos/pi-wire": "1.1.18",
+		"@linxiraos/pi-snapcompact": "1.1.18"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/apps/git/diff-pane.ts

@@ -24,6 +24,7 @@ import { getLanguageFromPath } from "../../lang-from-path";
 import { createHighlightStream, theme } from "../../theme/theme";
 import { bgAnsiHex, canvasHex, fgAnsiHex, mixHex, pill, selectionBgAnsi, textHex, withBg } from "./colors";
 import { DIFF_CONTEXT_LINES, type FileAssetSide, type FileStreamUpdate } from "./state";
+import { tuiText } from "../../i18n";
 
 /** Column ranges (inclusive start, exclusive end) carrying intraline emphasis. */
 type MarkRanges = readonly (readonly [number, number])[];
@@ -1033,7 +1034,7 @@ export class DiffPane {
 		if (this.state === "streaming" && this.#streaming) return this.#renderStreaming(width, height);
 		if (this.state === "asset" && this.#asset) return this.#renderAsset(width, height);
 		if (!doc || this.state !== "ready") {
-			const message = this.state === "loading" ? "Loading diff…" : this.emptyMessage;
+			const message = this.state === "loading" ? tuiText("gitLoadingDiff", "Loading diff…") : this.emptyMessage;
 			const lines: string[] = [];
 			for (let i = 0; i < height; i++) {
 				lines.push(
@@ -1084,11 +1085,17 @@ export class DiffPane {
 		for (let index = 0; index < height; index++) {
 			const leftSource =
 				index === 0
-					? centerLine(theme.bold(this.#assetTitle("Before", asset.old)), leftWidth).trimEnd()
+					? centerLine(
+							theme.bold(this.#assetTitle(tuiText("gitAssetBefore", "Before"), asset.old)),
+							leftWidth,
+						).trimEnd()
 					: (oldLines[index - 1] ?? "");
 			const rightSource =
 				index === 0
-					? centerLine(theme.bold(this.#assetTitle("After", asset.new)), rightWidth).trimEnd()
+					? centerLine(
+							theme.bold(this.#assetTitle(tuiText("gitAssetAfter", "After"), asset.new)),
+							rightWidth,
+						).trimEnd()
 					: (newLines[index - 1] ?? "");
 			const left = truncateToWidth(leftSource, leftWidth);
 			const right = truncateToWidth(rightSource, rightWidth);
@@ -1121,26 +1128,30 @@ export class DiffPane {
 			let details: string[];
 			switch (side.kind) {
 				case "empty":
-					details = ["No file"];
+					details = [tuiText("gitNoFile", "No file")];
 					break;
 				case "text":
-					details = ["Text object", formatBytes(side.byteLength)];
+					details = [tuiText("gitTextObject", "Text object"), formatBytes(side.byteLength)];
 					break;
 				case "binary":
 					details = [
-						"Binary object",
-						side.byteLength === undefined ? "Size unavailable" : formatBytes(side.byteLength),
+						tuiText("gitBinaryObject", "Binary object"),
+						side.byteLength === undefined
+							? tuiText("gitSizeUnavailable", "Size unavailable")
+							: formatBytes(side.byteLength),
 					];
 					break;
 				case "tooLarge":
 					details = [
-						"Object too large to preview",
-						side.byteLength === undefined ? "Exceeds preview limit" : formatBytes(side.byteLength),
+						tuiText("gitObjectTooLarge", "Object too large to preview"),
+						side.byteLength === undefined
+							? tuiText("gitExceedsPreviewLimit", "Exceeds preview limit")
+							: formatBytes(side.byteLength),
 					];
 					break;
 				case "lfsMissing":
 					details = [
-						"Git LFS object unavailable",
+						tuiText("gitLfsObjectUnavailable", "Git LFS object unavailable"),
 						`sha256:${side.oid.slice(0, 12)}… · ${formatBytes(side.byteLength)}`,
 					];
 					break;
@@ -1165,19 +1176,19 @@ export class DiffPane {
 				lfs = side.image.lfsOid !== undefined;
 				break;
 			case "text":
-				kind = "Text";
+				kind = tuiText("gitKindText", "Text");
 				lfs = side.lfsOid !== undefined;
 				break;
 			case "binary":
-				kind = "Binary";
+				kind = tuiText("gitKindBinary", "Binary");
 				lfs = side.lfsOid !== undefined;
 				break;
 			case "tooLarge":
-				kind = "Too large";
+				kind = tuiText("gitKindTooLarge", "Too large");
 				lfs = side.lfsOid !== undefined;
 				break;
 			case "lfsMissing":
-				kind = "LFS missing";
+				kind = tuiText("gitKindLfsMissing", "LFS missing");
 				lfs = true;
 				break;
 		}
@@ -1190,7 +1201,9 @@ export class DiffPane {
 		const total = this.#total();
 		if (total === 0) {
 			return Array.from({ length: height }, (_, index) =>
-				index === Math.floor(height / 2) ? centerLine(theme.fg("dim", "Streaming file…"), width).trimEnd() : "",
+				index === Math.floor(height / 2)
+					? centerLine(theme.fg("dim", tuiText("gitStreamingFile", "Streaming file…")), width).trimEnd()
+					: "",
 			);
 		}
 		this.#clampScroll();