@linxiraos/pi-tui 1.1.16 → 1.1.17

package/dist/types/prompt/composer.d.ts

@@ -1,7 +1,7 @@
 import { type Terminal } from "../terminal.js";
 import { type Component, type ResizeScrollbackMode, type TerminalFramePlan, type TerminalFrameProvider, TUI, type TUIOptions, type ViewportSize } from "../tui.js";
 import { CustomEditor } from "./custom-editor.js";
-import { type LspServerInfo, type RecentSession, WelcomeComponent } from "./welcome.js";
+import { type LspServerInfo, type RecentSession, WelcomeComponent, type WelcomeStrings } from "./welcome.js";
 /** Live settings that affect the composer before and after session adoption. */
 export interface ComposerPreferences {
     readonly quiet: boolean;
@@ -24,6 +24,8 @@ export interface ComposerWelcomeUpdate {
     readonly providerName?: string;
     readonly recentSessions?: readonly RecentSession[];
     readonly lspServers?: readonly LspServerInfo[];
+    /** Localizable panel strings; pass getters so `/language` switches apply on the next render. */
+    readonly strings?: WelcomeStrings;
 }
 /**
  * Placeholder-only status chrome replayed on the next first frame so the

package/dist/types/prompt/welcome.d.ts

@@ -13,7 +13,7 @@ export declare const WELCOME_LSP_SLOTS = 4;
  *  `r` is a uniform sample in [0, 1). Returns "" when `tips` is empty.
  *  Exported for tests. */
 export declare function pickWeightedTip(tips: readonly string[], r: number): string;
-export declare function renderWelcomeTip(tip: string, boxWidth: number, phase?: number): string[];
+export declare function renderWelcomeTip(tip: string, boxWidth: number, phase?: number, tipLabel?: string, newTag?: string): string[];
 export interface RecentSession {
     name: string;
     timeAgo: string;
@@ -26,6 +26,29 @@ export interface LspServerInfo {
 /**
  * Premium welcome screen with block-based OMP logo and two-column layout.
  */
+/**
+ * Localizable strings for the welcome panel. The panel lives in pi-tui, which
+ * cannot import the host's i18n catalogue, so the host injects the strings.
+ * Every field is optional and falls back to the historical English literal.
+ * Fields may be plain strings OR zero-arg getters returning the current value;
+ * getters are re-read on every render so `/language` switches apply live.
+ */
+export type WelcomeStringSource = string | (() => string);
+export interface WelcomeStrings {
+    back?: WelcomeStringSource;
+    tipsTitle?: WelcomeStringSource;
+    lspServersTitle?: WelcomeStringSource;
+    recentSessionsTitle?: WelcomeStringSource;
+    noRecentSessions?: WelcomeStringSource;
+    noLspServers?: WelcomeStringSource;
+    tipLabel?: WelcomeStringSource;
+    newTag?: WelcomeStringSource;
+    promptActionsHint?: WelcomeStringSource;
+    commandsHint?: WelcomeStringSource;
+    runBashHint?: WelcomeStringSource;
+    runPythonHint?: WelcomeStringSource;
+    nagNerdfont?: WelcomeStringSource;
+}
 export declare class WelcomeComponent implements Component {
     #private;
     private version;
@@ -33,6 +56,8 @@ export declare class WelcomeComponent implements Component {
     private providerName;
     private recentSessions;
     private lspServers;
+    /** Inject localized strings; clears the render cache so the next frame uses them. */
+    setStrings(strings: WelcomeStrings): void;
     constructor(version: string, modelName: string, providerName: string, recentSessions?: RecentSession[], lspServers?: LspServerInfo[]);
     get tip(): string | undefined;
     invalidate(): void;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@linxiraos/pi-tui",
-	"version": "1.1.16",
+	"version": "1.1.17",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://linxira-os.github.io/zeta/",
 	"author": "Stencil Labs, Inc.",
@@ -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.16",
-		"@linxiraos/pi-utils": "1.1.16",
-		"@linxiraos/pi-omptype": "1.1.16",
-		"@linxiraos/pi-agent-core": "1.1.16",
-		"@linxiraos/pi-ai": "1.1.16",
-		"@linxiraos/pi-catalog": "1.1.16",
-		"@linxiraos/pi-wire": "1.1.16",
-		"@linxiraos/pi-snapcompact": "1.1.16"
+		"@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"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/prompt/composer.ts

@@ -1,7 +1,10 @@
+import { postmortem } from "@linxiraos/pi-utils";
+import { type AnimationFrame, TranscriptContainer } from "../chrome/transcript-container";
 import type { EditorTopBorder } from "../components/composer/types";
 import { Spacer } from "../components/spacer";
-import { isInsideTerminalMultiplexer } from "../terminal-multiplexer";
 import { ProcessTerminal, type Terminal } from "../terminal";
+import { isInsideTerminalMultiplexer } from "../terminal-multiplexer";
+import { ensureThemeSync, getEditorTheme, theme } from "../theme/theme";
 import {
 	type Component,
 	Container,
@@ -13,11 +16,8 @@ import {
 	type ViewportSize,
 } from "../tui";
 import { sliceWithWidth, truncateToWidth, visibleWidth } from "../utils";
-import { postmortem } from "@linxiraos/pi-utils";
 import { CustomEditor } from "./custom-editor";
-import { type AnimationFrame, TranscriptContainer } from "../chrome/transcript-container";
-import { type LspServerInfo, type RecentSession, WelcomeComponent } from "./welcome";
-import { ensureThemeSync, getEditorTheme, theme } from "../theme/theme";
+import { type LspServerInfo, type RecentSession, WelcomeComponent, type WelcomeStrings } from "./welcome";
 
 const DOUBLE_INTERRUPT_MS = 500;
 
@@ -56,6 +56,8 @@ export interface ComposerWelcomeUpdate {
 	readonly providerName?: string;
 	readonly recentSessions?: readonly RecentSession[];
 	readonly lspServers?: readonly LspServerInfo[];
+	/** Localizable panel strings; pass getters so `/language` switches apply on the next render. */
+	readonly strings?: WelcomeStrings;
 }
 
 /**
@@ -884,12 +886,17 @@ export class Composer implements TerminalFrameProvider {
 		this.#stopped = true;
 	}
 
+	#welcomeStrings: WelcomeStrings | undefined;
 	#applyWelcomeUpdate(update: ComposerWelcomeUpdate): void {
 		if (update.version !== undefined) this.#version = update.version;
 		if (update.modelName !== undefined) this.#modelName = update.modelName;
 		if (update.providerName !== undefined) this.#providerName = update.providerName;
 		if (update.recentSessions !== undefined) this.#recentSessions = [...update.recentSessions];
 		if (update.lspServers !== undefined) this.#lspServers = [...update.lspServers];
+		if (update.strings !== undefined) {
+			this.#welcomeStrings = update.strings;
+			this.#welcome?.setStrings(update.strings);
+		}
 	}
 
 	#ensureWelcome(): void {
@@ -900,6 +907,7 @@ export class Composer implements TerminalFrameProvider {
 			this.#recentSessions,
 			this.#lspServers,
 		);
+		if (this.#welcomeStrings) this.#welcome.setStrings(this.#welcomeStrings);
 	}
 
 	#rebuildHeader(): void {

package/src/prompt/welcome.ts

@@ -1,8 +1,8 @@
+import { APP_NAME } from "@linxiraos/pi-utils/dirs";
 import { TERMINAL } from "../terminal-capabilities";
+import { theme } from "../theme/theme";
 import type { Component } from "../tui";
 import { padding, replaceTabs, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "../utils";
-import { APP_NAME } from "@linxiraos/pi-utils/dirs";
-import { theme } from "../theme/theme";
 import tipsText from "./tips.txt" with { type: "text" };
 
 /** Tips embedded at build time, one per line; blanks dropped. */
@@ -24,12 +24,12 @@ export const WELCOME_SESSION_SLOTS = 4;
 export const WELCOME_LSP_SLOTS = 4;
 
 /** Trailing marker that flags a tip as a "what's new" callout. Stripped before
- *  wrapping (with any preceding whitespace) and replaced by {@link NEW_TAG_TEXT}
+ *  wrapping (with any preceding whitespace) and replaced by the NEW tag
  *  painted as a shimmering rainbow. Non-global so `.test` stays stateless. */
 const NEW_TIP_MARKER = /\s*\[NEW\]\s*$/;
 
 /** Visible text rendered in place of {@link NEW_TIP_MARKER}. */
-const NEW_TAG_TEXT = "NEW!";
+const NEW_TAG_TEXT_DEFAULT = "NEW!";
 
 /** Milliseconds for one full hue rotation of the rainbow "NEW!" tag. */
 const NEW_GLOW_PERIOD_MS = 1500;
@@ -55,14 +55,14 @@ export function pickWeightedTip(tips: readonly string[], r: number): string {
 
 type ColorEncoding = "ansi-16m" | "ansi-256";
 
-/** Paint each glyph of {@link NEW_TAG_TEXT} on a moving HSL rainbow. `phase`
+/** Paint each glyph of the NEW tag on a moving HSL rainbow. `phase`
  *  rotates the hue offset cyclically; successive renders with increasing phase
  *  shimmer, while a fixed phase yields a still rainbow. */
-function renderNewTag(phase: number, encoding: ColorEncoding): string {
+function renderNewTag(tag: string, phase: number, encoding: ColorEncoding): string {
 	const bold = "\x1b[1m";
 	const reset = "\x1b[0m";
 	const wrapped = ((phase % 1) + 1) % 1;
-	const chars = [...NEW_TAG_TEXT];
+	const chars = [...tag];
 	let out = bold;
 	let prev = "";
 	for (let i = 0; i < chars.length; i++) {
@@ -76,8 +76,14 @@ function renderNewTag(phase: number, encoding: ColorEncoding): string {
 	}
 	return out + reset;
 }
-export function renderWelcomeTip(tip: string, boxWidth: number, phase = 0): string[] {
-	const label = "Tip: ";
+export function renderWelcomeTip(
+	tip: string,
+	boxWidth: number,
+	phase = 0,
+	tipLabel = "Tip: ",
+	newTag = "NEW!",
+): string[] {
+	const label = tipLabel;
 	const labelWidth = visibleWidth(label);
 	const bodyBudget = boxWidth - 1 - labelWidth; // 1 = leading indent
 	if (bodyBudget < 8) return [];
@@ -105,8 +111,8 @@ export function renderWelcomeTip(tip: string, boxWidth: number, phase = 0): stri
 		// box; otherwise drop it onto its own indented continuation line so the
 		// styled glyphs never overflow or reflow the wrapped body.
 		const encoding: ColorEncoding = TERMINAL.trueColor ? "ansi-16m" : "ansi-256";
-		const tag = renderNewTag(phase, encoding);
-		const tagWidth = 1 + visibleWidth(NEW_TAG_TEXT); // 1 = space separator
+		const tag = renderNewTag(newTag, phase, encoding);
+		const tagWidth = 1 + visibleWidth(newTag); // 1 = space separator
 		const lastLine = lines[lines.length - 1];
 		if (lastLine !== undefined && visibleWidth(lastLine) + tagWidth <= boxWidth) {
 			lines[lines.length - 1] = `${lastLine} ${tag}`;
@@ -132,6 +138,35 @@ export interface LspServerInfo {
 /**
  * Premium welcome screen with block-based OMP logo and two-column layout.
  */
+/**
+ * Localizable strings for the welcome panel. The panel lives in pi-tui, which
+ * cannot import the host's i18n catalogue, so the host injects the strings.
+ * Every field is optional and falls back to the historical English literal.
+ * Fields may be plain strings OR zero-arg getters returning the current value;
+ * getters are re-read on every render so `/language` switches apply live.
+ */
+export type WelcomeStringSource = string | (() => string);
+export interface WelcomeStrings {
+	back?: WelcomeStringSource;
+	tipsTitle?: WelcomeStringSource;
+	lspServersTitle?: WelcomeStringSource;
+	recentSessionsTitle?: WelcomeStringSource;
+	noRecentSessions?: WelcomeStringSource;
+	noLspServers?: WelcomeStringSource;
+	tipLabel?: WelcomeStringSource;
+	newTag?: WelcomeStringSource;
+	promptActionsHint?: WelcomeStringSource;
+	commandsHint?: WelcomeStringSource;
+	runBashHint?: WelcomeStringSource;
+	runPythonHint?: WelcomeStringSource;
+	nagNerdfont?: WelcomeStringSource;
+}
+
+function read(source: WelcomeStringSource | undefined, fallback: string): string {
+	if (source === undefined) return fallback;
+	return typeof source === "function" ? source() : source;
+}
+
 export class WelcomeComponent implements Component {
 	#animStart: number | null = null;
 	#animTimer: Timer | null = null;
@@ -147,6 +182,13 @@ export class WelcomeComponent implements Component {
 	// Bypassed while the intro animation runs (every frame differs).
 	#cachedWidth = -1;
 	#cachedLines: string[] | undefined;
+	#strings: WelcomeStrings = {};
+
+	/** Inject localized strings; clears the render cache so the next frame uses them. */
+	setStrings(strings: WelcomeStrings): void {
+		this.#strings = strings;
+		this.#cachedLines = undefined;
+	}
 
 	constructor(
 		private version: string,
@@ -159,7 +201,7 @@ export class WelcomeComponent implements Component {
 		this.#nagRoll ??= Math.random();
 		this.#tipRoll ??= Math.random();
 		if (theme.getSymbolPreset() === "unicode" && this.#nagRoll < 0.1) {
-			return "Please use nerdfont 😭.";
+			return read(this.#strings.nagNerdfont, "Please use nerdfont 😭.");
 		}
 		return pickWeightedTip(TIPS, this.#tipRoll) || undefined;
 	}
@@ -271,7 +313,7 @@ export class WelcomeComponent implements Component {
 		// Dynamic model/provider labels are truncated inside the fixed column.
 		// Letting them influence the responsive breakpoint changes the box height
 		// when authoritative session data replaces the empty prepaint labels.
-		const leftMinContentWidth = Math.max(minLeftCol, visibleWidth("Welcome back!"));
+		const leftMinContentWidth = Math.max(minLeftCol, visibleWidth(read(this.#strings.back, "Welcome back!")));
 		const desiredLeftCol = Math.max(
 			Math.min(preferredLeftCol, Math.max(minLeftCol, Math.floor(dualContentWidth * 0.35))),
 			leftMinContentWidth,
@@ -291,7 +333,7 @@ export class WelcomeComponent implements Component {
 		// Left column - centered content
 		const leftLines = [
 			"",
-			this.#centerText(theme.bold("Welcome back!"), leftCol),
+			this.#centerText(theme.bold(read(this.#strings.back, "Welcome back!")), leftCol),
 			"",
 			...logoColored.map(l => this.#centerText(l, leftCol)),
 			"",
@@ -306,7 +348,7 @@ export class WelcomeComponent implements Component {
 		// Recent sessions content
 		const sessionLines: string[] = [];
 		if (this.recentSessions.length === 0) {
-			sessionLines.push(` ${theme.fg("dim", "No recent sessions")}`);
+			sessionLines.push(` ${theme.fg("dim", read(this.#strings.noRecentSessions, "No recent sessions"))}`);
 		} else {
 			// Reserve width for the bullet prefix (" • ") and the trailing " (timeAgo)"
 			// so the relative time is never the part that gets truncated. The name
@@ -332,7 +374,7 @@ export class WelcomeComponent implements Component {
 		// LSP servers content
 		const lspLines: string[] = [];
 		if (this.lspServers.length === 0) {
-			lspLines.push(` ${theme.fg("dim", "No LSP servers")}`);
+			lspLines.push(` ${theme.fg("dim", read(this.#strings.noLspServers, "No LSP servers"))}`);
 		} else {
 			for (const server of this.lspServers.slice(0, WELCOME_LSP_SLOTS)) {
 				const icon =
@@ -354,16 +396,16 @@ export class WelcomeComponent implements Component {
 
 		// Right column
 		const rightLines = [
-			` ${theme.bold(theme.fg("accent", "Tips"))}`,
-			` ${theme.fg("dim", "#")}${theme.fg("muted", " for prompt actions")}`,
-			` ${theme.fg("dim", "/")}${theme.fg("muted", " for commands")}`,
-			` ${theme.fg("dim", "!")}${theme.fg("muted", " to run bash")}`,
-			` ${theme.fg("dim", "$")}${theme.fg("muted", " to run python")}`,
+			` ${theme.bold(theme.fg("accent", read(this.#strings.tipsTitle, "Tips")))}`,
+			` ${theme.fg("dim", "#")}${theme.fg("muted", read(this.#strings.promptActionsHint, " for prompt actions"))}`,
+			` ${theme.fg("dim", "/")}${theme.fg("muted", read(this.#strings.commandsHint, " for commands"))}`,
+			` ${theme.fg("dim", "!")}${theme.fg("muted", read(this.#strings.runBashHint, " to run bash"))}`,
+			` ${theme.fg("dim", "$")}${theme.fg("muted", read(this.#strings.runPythonHint, " to run python"))}`,
 			separator,
-			` ${theme.bold(theme.fg("accent", "LSP Servers"))}`,
+			` ${theme.bold(theme.fg("accent", read(this.#strings.lspServersTitle, "LSP Servers")))}`,
 			...lspLines,
 			separator,
-			` ${theme.bold(theme.fg("accent", "Recent sessions"))}`,
+			` ${theme.bold(theme.fg("accent", read(this.#strings.recentSessionsTitle, "Recent sessions")))}`,
 			...sessionLines,
 			"",
 		];
@@ -429,7 +471,13 @@ export class WelcomeComponent implements Component {
 		// intro's re-render frames, then settles into a still rainbow once the box
 		// caches its resting frame. Non-"[NEW]" tips ignore the phase entirely.
 		const phase = NEW_TIP_MARKER.test(tip) ? performance.now() / NEW_GLOW_PERIOD_MS : 0;
-		return renderWelcomeTip(tip, boxWidth, phase);
+		return renderWelcomeTip(
+			tip,
+			boxWidth,
+			phase,
+			read(this.#strings.tipLabel, "Tip: "),
+			read(this.#strings.newTag, NEW_TAG_TEXT_DEFAULT),
+		);
 	}
 
 	/** Center text within a given width */