@linxiraos/pi-tui 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 ## [Unreleased]
 
+## [1.2.1] - 2026-10-13
+
+- The welcome box now resolves its labels, the `Tip:` label, the `[NEW]` tag, and every tip body through the host `tuiText` catalogue (`welcome*` and `tipN` keys, where `tipN` maps to `tips.txt` line N). The inline English stays as the permanent fallback, so rendering without a registered source is unchanged; a registered source localises the box and re-renders on a live language switch.
+- Welcome banner restored to the upstream logo lockup: the ζ block mark sits beside a half-block `Zeta` wordmark with the version under it and the session tip below, replacing the two-column card. Model/provider labels, LSP servers and recent sessions are no longer rendered (the same removal upstream shipped in `1fb10d29bc1`), and the setup splash now reuses a cached water field, cell grid and per-frame gradient escapes with a skip hint that follows the live symbol preset.
+
 ## [1.2.0] - 2026-10-12
 
 - Added cache-release hooks for TUI components and tool cards, allowing extensions to discard derived render data without rebuilding content ([#13632](https://github.com/can1357/oh-my-pi/pull/13632) by [@iliaal](https://github.com/iliaal)).

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

@@ -6,7 +6,7 @@ import { type Component, type ResizeScrollbackMode, type TerminalFramePlan, type
 import type { NativeSurface, NativeSurfaceProvider } from "../native/node.js";
 import { CustomEditor } from "./custom-editor.js";
 import type { WordCompletionMethod } from "./word-completion.js";
-import { WelcomeComponent, type RecentSession, type LspServerInfo } from "./welcome.js";
+import { WelcomeComponent } from "./welcome.js";
 /** Live settings that affect the composer before and after session adoption. */
 export interface ComposerPreferences {
     readonly quiet: boolean;
@@ -25,11 +25,6 @@ export declare const COMPOSER_DEFAULTS: ComposerPreferences;
 /** Welcome data that can be supplied initially or patched as startup resolves it. */
 export interface ComposerWelcomeUpdate {
     readonly version?: string;
-    readonly modelName?: string;
-    readonly providerName?: string;
-    readonly recentSessions?: readonly RecentSession[];
-    /** Detected project servers; `null` means LSP is disabled and hides the welcome section. */
-    readonly lspServers?: readonly LspServerInfo[] | null;
 }
 /**
  * Status-bar inputs persisted by the last session. The first frame renders

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

@@ -1,63 +1,38 @@
-import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
+import type { DescribeContext, NativeNode } from "../native/node.js";
 import type { Component } from "../tui.js";
-/**
- * Fixed number of session rows in the welcome box so its height stays stable
- * across recent-session updates.
- */
-export declare const WELCOME_SESSION_SLOTS = 4;
-/**
- * Fixed number of LSP-server rows, for the same reason. Overflow is sliced so
- * the box height is constant regardless of how many servers a project has.
- */
-export declare const WELCOME_LSP_SLOTS = 4;
 /** Pick a tip from `tips`, biased toward "[NEW]" tips by {@link NEW_TIP_WEIGHT};
  *  `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;
 /**
- * The welcome tip as lines of at most `width` columns: `Tip:` and the body
- * wrapped together, with no indent, so the banner can center each line.
- * `[]` when `width` leaves no room for a useful line.
+ * The welcome tip as lines of at most `width` columns: the `welcomeTipLabel`
+ * label and the body wrapped together, with no indent, so the banner can center
+ * each line. `isNew` drives the rainbow "welcomeNewTag" suffix; it is passed in
+ * because the marker lives in tips.txt, not in the resolved body. `[]` when
+ * `width` leaves no room for a useful line.
  */
-export declare function renderWelcomeTip(tip: string, width: number, phase?: number): string[];
-export interface RecentSession {
-    name: string;
-    timeAgo: string;
-    /** Session file; a native click on the row resumes it. */
-    path?: string;
-}
-export interface LspServerInfo {
-    name: string;
-    status: "ready" | "error" | "connecting" | "available";
-    fileTypes: string[];
-}
+export declare function renderWelcomeTip(tip: string, width: number, phase?: number, isNew?: boolean): string[];
 /**
- * Premium welcome screen with block-based ZETA logo and two-column layout.
+ * The session's welcome banner. In a terminal: the gradient logo beside the
+ * `zeta` wordmark with the version under it (the logo alone when the lockup does
+ * not fit) and the tip of the session (dropped below {@link TIP_MIN_COLUMNS}
+ * columns). Natively: a card with the same logo, wordmark, version and tip
+ * ({@link WelcomeComponent.describe}).
  */
 export declare class WelcomeComponent implements Component {
     #private;
     private version;
-    private modelName;
-    private providerName;
-    private recentSessions;
-    /** Detected project servers; `null` means LSP is disabled and hides the section. */
-    private lspServers;
-    constructor(version: string, modelName?: string, providerName?: string, recentSessions?: RecentSession[], 
-    /** Detected project servers; `null` means LSP is disabled and hides the section. */
-    lspServers?: LspServerInfo[] | null);
+    constructor(version: string);
     get tip(): string | undefined;
     invalidate(): void;
     /**
-     * A `card` (`zeta.welcome`) titled with the app version. The brand column
-     * (`zeta.welcome.brand`: greeting and the terminal's builtin `zeta` mark, which
-     * it animates) sits beside the info column (`zeta.welcome.info`: prompt-sigil
-     * keycaps, LSP servers, recent sessions); the tip of the session closes the card. Roles
-     * carry the look (gradient logo, type scale, column hairline); a "[NEW]" tip
+     * A `card` (`zeta.welcome`) mirroring the terminal banner: the lockup
+     * (`zeta.welcome.lockup`: the terminal's builtin `zeta` mark, which it animates,
+     * beside the wordmark with the version under it) and the tip of the session.
+     * Roles carry the look (gradient logo, type scale); a "[NEW]" tip
      * carries a terminal-clocked shimmering tag.
      */
     describe(_cx: DescribeContext): NativeNode;
-    /** A click on a recent session resumes it. */
-    handleNativeEvent(event: NativeUiEvent): void;
     /** The intro keeps the welcome block mutable; settling lets it retire to history. */
     isTranscriptBlockFinalized(): boolean;
     /**
@@ -76,9 +51,6 @@ export declare class WelcomeComponent implements Component {
     stopIntro(): void;
     /** Update the version embedded in the welcome border title. */
     setVersion(version: string): void;
-    setModel(modelName: string, providerName: string): void;
-    setRecentSessions(sessions: RecentSession[]): void;
-    setLspServers(servers: LspServerInfo[] | null): void;
     render(termWidth: number): readonly string[];
 }
 /** Block-grid brand mark shared by the welcome and setup surfaces. */

package/dist/types/setup/scenes/splash.d.ts

@@ -3,7 +3,7 @@ export declare const SETUP_SPLASH_MS = 2600;
 export declare const SETUP_TICK_MS = 33;
 export declare function renderStarfield(width: number, height: number, frame: number): string[];
 /**
- * Animated setup splash, in the spirit of the omp landing page: the brand ζ
+ * Animated setup splash, in the spirit of the Zeta visual identity: the brand ζ
  * mark rendered with the live diagonal gradient + shine sweep, rising out of a
  * rippling, gradient-lit water surface, under a faint twinkling starfield. The
  * mark and water share one continuous gradient so the sweep reads across the

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@linxiraos/pi-tui",
-	"version": "1.2.0",
+	"version": "1.2.1",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://linxira-os.github.io/zeta/",
 	"author": "Linxira-OS",
@@ -38,14 +38,14 @@
 		"gen:glyphs": "bun scripts/gen-glyphs.ts"
 	},
 	"dependencies": {
-		"@linxiraos/pi-omptype": "1.2.0",
-		"@linxiraos/pi-agent-core": "1.2.0",
-		"@linxiraos/pi-ai": "1.2.0",
-		"@linxiraos/pi-catalog": "1.2.0",
-		"@linxiraos/pi-natives": "1.2.0",
-		"@linxiraos/pi-utils": "1.2.0",
-		"@linxiraos/pi-wire": "1.2.0",
-		"@linxiraos/pi-snapcompact": "1.2.0"
+		"@linxiraos/pi-omptype": "1.2.1",
+		"@linxiraos/pi-agent-core": "1.2.1",
+		"@linxiraos/pi-ai": "1.2.1",
+		"@linxiraos/pi-catalog": "1.2.1",
+		"@linxiraos/pi-natives": "1.2.1",
+		"@linxiraos/pi-utils": "1.2.1",
+		"@linxiraos/pi-wire": "1.2.1",
+		"@linxiraos/pi-snapcompact": "1.2.1"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/overlays/agent-hub.ts

@@ -1211,7 +1211,7 @@ export class AgentHubOverlayComponent<TRecord extends AgentRecordLike = AgentRec
 						[span("Finished, parked, and killed subagents remain with the session that created them.", "dim")],
 						{ wrap: "word" },
 					),
-					text([span("Resume that session with omp-dev --continue, or spawn a task here.", "dim")], {
+					text([span("Resume that session with zetacode --continue, or spawn a task here.", "dim")], {
 						wrap: "word",
 					}),
 				],
@@ -1857,7 +1857,7 @@ export class AgentHubOverlayComponent<TRecord extends AgentRecordLike = AgentRec
 				const emptyState = [
 					`${theme.fg("muted", theme.status.shadowed)} ${theme.bold("No agents in this session")}`,
 					theme.fg("dim", "Finished, parked, and killed subagents remain with the session that created them."),
-					theme.fg("dim", "Resume that session with omp-dev --continue, or spawn a task here."),
+					theme.fg("dim", "Resume that session with zetacode --continue, or spawn a task here."),
 				];
 				for (const line of emptyState.slice(0, budget)) {
 					lines.push(line);

package/src/overlays/plugin-settings.ts

@@ -307,9 +307,15 @@ export class PluginListComponent extends OverlayPanel {
 		if (entries.length === 0) {
 			this.addChild(new Text(theme.fg("muted", "No plugins installed"), 0, 0));
 			this.addChild(new Spacer(1));
-			this.addChild(new Text(theme.fg("dim", "Install npm plugins:        zeta-c plugin install <package>"), 0, 0));
 			this.addChild(
-				new Text(theme.fg("dim", "Install marketplace plugins: zeta-c plugin install <name>@<marketplace>"), 0, 0),
+				new Text(theme.fg("dim", "Install npm plugins:        zetacode plugin install <package>"), 0, 0),
+			);
+			this.addChild(
+				new Text(
+					theme.fg("dim", "Install marketplace plugins: zetacode plugin install <name>@<marketplace>"),
+					0,
+					0,
+				),
 			);
 			this.addChild(new Spacer(1));
 

package/src/prompt/composer-cache.ts

@@ -3,11 +3,10 @@
  * (`~/.zeta/agent/cache/composer.db`).
  *
  * Each row is one JSON payload keyed by project (the resolved cwd) and kind.
- * Settings-derived kinds (theme/composer preferences, welcome model labels,
- * status-bar inputs) are also written under the empty project, so a folder that
- * never ran zeta-c still paints with the user's theme and status bar: those are
- * rarely project-specific, and path/branch render live. Recent sessions and LSP
- * rows stay per project.
+ * Settings-derived kinds (theme/composer preferences, status-bar inputs) are
+ * also written under the empty project, so a folder that never ran zeta-c still
+ * paints with the user's theme and status bar: those are rarely
+ * project-specific, and path/branch render live.
  *
  * ```text
  * entries (project TEXT, kind TEXT, value TEXT JSON, PRIMARY KEY (project, kind))
@@ -25,7 +24,6 @@ import * as logger from "@linxiraos/pi-utils/logger";
 import * as postmortem from "@linxiraos/pi-utils/postmortem";
 import { openSqliteDatabaseSync } from "@linxiraos/pi-utils/sqlite";
 import { isRecord } from "@linxiraos/pi-utils/type-guards";
-import type { LspServerInfo, RecentSession } from "./welcome";
 import type { ComposerPreferences, ComposerStatusCache } from "./composer";
 import { readStatusLineStartupData } from "../status-line/startup";
 import type { SymbolPreset } from "../theme/theme";

package/src/prompt/composer.ts

@@ -22,7 +22,7 @@ import { postmortem } from "@linxiraos/pi-utils";
 import { CustomEditor } from "./custom-editor";
 import type { WordCompletionMethod } from "./word-completion";
 import { type AnimationFrame, TranscriptContainer } from "../chrome/transcript-container";
-import { WelcomeComponent, type RecentSession, type LspServerInfo } from "./welcome";
+import { WelcomeComponent } from "./welcome";
 import { ensureThemeSync, getEditorTheme, theme } from "../theme/theme";
 
 const DOUBLE_INTERRUPT_MS = 500;
@@ -58,11 +58,6 @@ export const COMPOSER_DEFAULTS: ComposerPreferences = {
 /** Welcome data that can be supplied initially or patched as startup resolves it. */
 export interface ComposerWelcomeUpdate {
 	readonly version?: string;
-	readonly modelName?: string;
-	readonly providerName?: string;
-	readonly recentSessions?: readonly RecentSession[];
-	/** Detected project servers; `null` means LSP is disabled and hides the welcome section. */
-	readonly lspServers?: readonly LspServerInfo[] | null;
 }
 
 /**
@@ -215,10 +210,6 @@ export class Composer implements TerminalFrameProvider, NativeSurfaceProvider {
 	#preferences: ComposerPreferences;
 	#welcome: WelcomeComponent | undefined;
 	#version = "";
-	#modelName = "";
-	#providerName = "";
-	#recentSessions: RecentSession[] = [];
-	#lspServers: LspServerInfo[] | null = [];
 	#headerBefore: readonly Component[] = [];
 	#headerAfter: readonly Component[] = [];
 	#runtimeChildren: readonly Component[] = [];
@@ -894,7 +885,6 @@ export class Composer implements TerminalFrameProvider, NativeSurfaceProvider {
 		const welcome = this.#welcome;
 		if (!welcome) return;
 		if (update.version !== undefined) welcome.setVersion(this.#version);
-		welcome.setModel(this.#modelName, this.#providerName);
 		this.ui.requestRender();
 	}
 
@@ -976,20 +966,10 @@ export class Composer implements TerminalFrameProvider, NativeSurfaceProvider {
 
 	#applyWelcomeUpdate(update: ComposerWelcomeUpdate): void {
 		if (update.version !== undefined) this.#version = update.version;
-		if (update.modelName !== undefined || update.providerName !== undefined) {
-			this.#modelName = update.modelName ?? this.#modelName;
-			this.#providerName = update.providerName ?? this.#providerName;
-		}
 	}
 
 	#ensureWelcome(): void {
-		this.#welcome ??= new WelcomeComponent(
-			this.#version,
-			this.#modelName,
-			this.#providerName,
-			this.#recentSessions,
-			this.#lspServers,
-		);
+		this.#welcome ??= new WelcomeComponent(this.#version);
 	}
 
 	#rebuildHeader(): void {

package/src/prompt/welcome.ts

@@ -2,57 +2,73 @@ import { APP_NAME } from "@linxiraos/pi-utils/dirs";
 import type { TspSpan } from "@linxiraos/pi-wire";
 import { formatDoubleTap, formatKeyHint, formatKeyHints, type KeyName } from "../app-keybindings";
 import { editorKey } from "../chrome/keybinding-hints";
+import { tuiText } from "../i18n";
 import { getKeybindings, type Keybinding } from "../keybindings";
-import { card, col, kbd, keyed, node, row, span, text } from "../native/describe";
-import type { DescribeContext, NativeChild, NativeNode, NativeUiEvent } from "../native/node";
-import { runTranscriptAction } from "../chat/transcript-actions";
-import { compactText, plainLine, plainText } from "../native/spans";
-
+import { card, col, keyed, node, row, span, text } from "../native/describe";
+import type { DescribeContext, NativeChild, NativeNode } from "../native/node";
+import { compactText, plainText } from "../native/spans";
 import { isNativeRendering } from "../native/state";
 import { isHyperlinkEnabled, urlHyperlink, urlLinkSpan } from "../render/hyperlink";
 import { TERMINAL } from "../terminal-capabilities";
 import { theme } from "../theme/theme";
 import type { Component } from "../tui";
-import { padding, replaceTabs, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "../utils";
+import { padding, replaceTabs, visibleWidth, wrapTextWithAnsi } from "../utils";
 import tipsText from "./tips.txt" with { type: "text" };
 
 /** Leading marker for a tip that pitches Tern: shown only while no TSP surface
  *  is live, since a live one means the user is already in Tern. */
 const NO_TERN_TIP_MARKER = /^\[NO-TERN\]\s*/;
 
-/** tips.txt lines embedded at build time; blanks dropped. Key placeholders
- *  (see {@link expandTipKeys}) stay raw until render time. */
-const TIP_LINES: readonly string[] = tipsText
-	.split("\n")
-	.map(line => line.trim())
-	.filter(line => line.length > 0);
-
-/**
- * Fixed number of session rows in the welcome box so its height stays stable
- * across recent-session updates.
- */
-export const WELCOME_SESSION_SLOTS = 4;
-
-/**
- * Fixed number of LSP-server rows, for the same reason. Overflow is sliced so
- * the box height is constant regardless of how many servers a project has.
- */
-export const WELCOME_LSP_SLOTS = 4;
-
-/** Tips for the classic renderer: every tip, {@link NO_TERN_TIP_MARKER} stripped. */
-const TIPS: readonly string[] = TIP_LINES.map(line => line.replace(NO_TERN_TIP_MARKER, ""));
-
-/** Tips for a live TSP surface: those marked {@link NO_TERN_TIP_MARKER} dropped. */
-const TSP_TIPS: readonly string[] = TIP_LINES.filter(line => !NO_TERN_TIP_MARKER.test(line));
-
 /** 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}
  *  painted as a shimmering rainbow. Non-global so `.test` stays stateless. */
 const NEW_TIP_MARKER = /\s*\[NEW\]\s*$/;
 
+/** A tips.txt line. The structural markers stay in the source line — they drive
+ *  pool selection and the "[NEW]" weighting — while the user-visible text is
+ *  resolved from the host catalogue under `tipN`, N = the 1-based line number. */
+interface TipLine {
+	/** 1-based tips.txt line number; the catalogue key is `tip${line}`. */
+	readonly line: number;
+	/** Raw line, markers intact — what the weighted picker selects from. */
+	readonly raw: string;
+	/** English body with both markers stripped: the `tuiText` fallback. */
+	readonly english: string;
+	/** Pitches Tern; excluded from the TSP pool. */
+	readonly noTern: boolean;
+	/** "What's new" callout; carries the heavier selection weight. */
+	readonly isNew: boolean;
+}
+
+/** tips.txt lines embedded at build time; blanks dropped. Key placeholders
+ *  (see {@link expandTipKeys}) and markdown links stay raw until render time. */
+const TIP_LINES: readonly TipLine[] = tipsText.split("\n").flatMap((line, index) => {
+	const raw = line.trim();
+	if (raw.length === 0) return [];
+	return [
+		{
+			line: index + 1,
+			raw,
+			english: raw.replace(NO_TERN_TIP_MARKER, "").replace(NEW_TIP_MARKER, ""),
+			noTern: NO_TERN_TIP_MARKER.test(raw),
+			isNew: NEW_TIP_MARKER.test(raw),
+		},
+	];
+});
+
+/** Classic pool: every tip's raw line, so {@link pickWeightedTip} can still read
+ *  the trailing {@link NEW_TIP_MARKER} for its selection weight. */
+const TIPS: readonly string[] = TIP_LINES.map(tip => tip.raw);
+
+/** TSP pool: those marked {@link NO_TERN_TIP_MARKER} dropped. */
+const TSP_TIPS: readonly string[] = TIP_LINES.filter(tip => !tip.noTern).map(tip => tip.raw);
+
 /** Visible text rendered in place of {@link NEW_TIP_MARKER}. */
 const NEW_TAG_TEXT = "NEW!";
 
+/** Inline English for the nerdfont nudge tip (`welcomeNerdFontJoke`). */
+const NERDFONT_TIP = "Please use nerdfont 😭.";
+
 /** Milliseconds for one full hue rotation of the rainbow "NEW!" tag. */
 const NEW_GLOW_PERIOD_MS = 1500;
 
@@ -75,16 +91,33 @@ export function pickWeightedTip(tips: readonly string[], r: number): string {
 	return tips[tips.length - 1] ?? "";
 }
 
+/** A tip resolved through the host catalogue: the localised body plus the
+ *  structural "[NEW]" flag, which lives in tips.txt rather than the translated
+ *  text (so a translation never has to carry the marker). */
+interface ResolvedTip {
+	readonly text: string;
+	readonly isNew: boolean;
+}
+
+/** Localise a picked tip. `raw` is a {@link TIPS}/{@link TSP_TIPS} member (or the
+ *  nerdfont nudge); the catalogue is consulted live, so `/language` applies. */
+function resolveTip(raw: string): ResolvedTip {
+	if (raw === NERDFONT_TIP) return { text: tuiText("welcomeNerdFontJoke", NERDFONT_TIP), isNew: false };
+	const entry = TIP_LINES.find(tip => tip.raw === raw);
+	if (entry === undefined) return { text: raw, isNew: NEW_TIP_MARKER.test(raw) };
+	return { text: tuiText(`tip${entry.line}`, entry.english), isNew: entry.isNew };
+}
+
 type ColorEncoding = "ansi-16m" | "ansi-256";
 
-/** Paint each glyph of {@link NEW_TAG_TEXT} 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 {
+/** Paint each glyph of `tagText` 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(tagText: 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 = [...tagText];
 	let out = bold;
 	let prev = "";
 	for (let i = 0; i < chars.length; i++) {
@@ -158,67 +191,58 @@ function tipSpans(tip: string): TspSpan[] {
 }
 
 /**
- * The welcome tip as lines of at most `width` columns: `Tip:` and the body
- * wrapped together, with no indent, so the banner can center each line.
- * `[]` when `width` leaves no room for a useful line.
+ * The welcome tip as lines of at most `width` columns: the `welcomeTipLabel`
+ * label and the body wrapped together, with no indent, so the banner can center
+ * each line. `isNew` drives the rainbow "welcomeNewTag" suffix; it is passed in
+ * because the marker lives in tips.txt, not in the resolved body. `[]` when
+ * `width` leaves no room for a useful line.
  */
-export function renderWelcomeTip(tip: string, width: number, phase = 0): string[] {
-	const label = "Tip: ";
-	const labelWidth = visibleWidth(label);
-	const bodyBudget = width - labelWidth;
-	if (bodyBudget < 8) return [];
+export function renderWelcomeTip(tip: string, width: number, phase = 0, isNew = NEW_TIP_MARKER.test(tip)): string[] {
+	const label = tuiText("welcomeTipLabel", "Tip: ");
+	if (width - visibleWidth(label) < 8) return [];
 
-	const isNew = NEW_TIP_MARKER.test(tip);
 	const body = linkTipText(expandTipKeys(isNew ? tip.replace(NEW_TIP_MARKER, "") : tip));
 
-	const wrappedBody = wrapTextWithAnsi(replaceTabs(body), bodyBudget);
-	if (wrappedBody.length === 0) return [];
+	// Trailing spaces left by the wrap would count toward the width the banner centers.
+	const wrapped = wrapTextWithAnsi(replaceTabs(`${label}${body}`), width).map(line => line.trimEnd());
+	if (wrapped.length === 0) return [];
 
 	// Pull both colors from the active theme so the line stays readable on light
 	// themes; the previous hardcoded `#b48cff` / `#9ccfff` pastels (plus a manual
 	// `\x1b[2m` dim on the body) dropped to ~1.5:1 contrast on a white background.
-	const continuationIndent = padding(labelWidth);
 	const styledLabel = theme.fg("customMessageLabel", label);
-
-	const lines = wrappedBody.map((line, index) => {
-		const styledBody = theme.fg("muted", line);
-		const content = index === 0 ? `${styledLabel}${styledBody}` : `${styledBody}`;
-		return theme.italic(content);
-	});
+	const lines = wrapped.map((line, index) =>
+		theme.italic(
+			index === 0 && line.startsWith(label)
+				? `${styledLabel}${theme.fg("muted", line.slice(label.length))}`
+				: theme.fg("muted", line),
+		),
+	);
 
 	if (isNew) {
-		// Append the rainbow tag to the final body line when it fits within the
-		// box; otherwise drop it onto its own indented continuation line so the
-		// styled glyphs never overflow or reflow the wrapped body.
+		// Append the rainbow tag to the final line when it fits; otherwise give it
+		// a line of its own so the styled glyphs never overflow the width.
 		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 tagText = tuiText("welcomeNewTag", NEW_TAG_TEXT);
+		const tag = renderNewTag(tagText, phase, encoding);
+		const tagWidth = 1 + visibleWidth(tagText); // 1 = space separator
 		const lastLine = lines[lines.length - 1];
 		if (lastLine !== undefined && visibleWidth(lastLine) + tagWidth <= width) {
 			lines[lines.length - 1] = `${lastLine} ${tag}`;
 		} else {
-			lines.push(continuationIndent + tag);
+			lines.push(tag);
 		}
 	}
 
 	return lines;
 }
 
-export interface RecentSession {
-	name: string;
-	timeAgo: string;
-	/** Session file; a native click on the row resumes it. */
-	path?: string;
-}
-
-export interface LspServerInfo {
-	name: string;
-	status: "ready" | "error" | "connecting" | "available";
-	fileTypes: string[];
-}
-
 /**
- * Premium welcome screen with block-based ZETA logo and two-column layout.
+ * The session's welcome banner. In a terminal: the gradient logo beside the
+ * `zeta` wordmark with the version under it (the logo alone when the lockup does
+ * not fit) and the tip of the session (dropped below {@link TIP_MIN_COLUMNS}
+ * columns). Natively: a card with the same logo, wordmark, version and tip
+ * ({@link WelcomeComponent.describe}).
  */
 export class WelcomeComponent implements Component {
 	#animStart: number | null = null;
@@ -233,24 +257,20 @@ export class WelcomeComponent implements Component {
 	#tipRoll: number | undefined;
 	// Render cache: the welcome box is the first transcript-area component, so
 	// returning a stable array reference keeps the whole frame prefix stable.
-	// Bypassed while the intro animation runs (every frame differs).
+	// Bypassed while the intro animation runs (every frame differs). The
+	// `#cachedLang` sentinel retires the cache when `/language` swaps the
+	// catalogue, so a live switch repaints instead of serving stale text.
 	#cachedWidth = -1;
 	#cachedLines: string[] | undefined;
-	#native: { tip: string | undefined; node: NativeNode } | undefined;
-
-	constructor(
-		private version: string,
-		private modelName: string = "",
-		private providerName: string = "",
-		private recentSessions: RecentSession[] = [],
-		/** Detected project servers; `null` means LSP is disabled and hides the section. */
-		private lspServers: LspServerInfo[] | null = [],
-	) {}
+	#cachedLang = "";
+	#native: { lang: string; tip: string | undefined; node: NativeNode } | undefined;
+
+	constructor(private version: string) {}
 	get tip(): string | undefined {
 		this.#nagRoll ??= Math.random();
 		this.#tipRoll ??= Math.random();
 		if (theme.getSymbolPreset() === "unicode" && this.#nagRoll < 0.1) {
-			return "Please use nerdfont 😭.";
+			return NERDFONT_TIP;
 		}
 		return pickWeightedTip(isNativeRendering() ? TSP_TIPS : TIPS, this.#tipRoll) || undefined;
 	}
@@ -262,25 +282,23 @@ export class WelcomeComponent implements Component {
 	}
 
 	/**
-	 * A `card` (`zeta.welcome`) titled with the app version. The brand column
-	 * (`zeta.welcome.brand`: greeting and the terminal's builtin `zeta` mark, which
-	 * it animates) sits beside the info column (`zeta.welcome.info`: prompt-sigil
-	 * keycaps, LSP servers, recent sessions); the tip of the session closes the card. Roles
-	 * carry the look (gradient logo, type scale, column hairline); a "[NEW]" tip
+	 * A `card` (`zeta.welcome`) mirroring the terminal banner: the lockup
+	 * (`zeta.welcome.lockup`: the terminal's builtin `zeta` mark, which it animates,
+	 * beside the wordmark with the version under it) and the tip of the session.
+	 * Roles carry the look (gradient logo, type scale); a "[NEW]" tip
 	 * carries a terminal-clocked shimmering tag.
 	 */
 	describe(_cx: DescribeContext): NativeNode {
-		const tip = this.tip;
-		if (this.#native && this.#native.tip === tip) return this.#native.node;
-		const line = (spans: readonly TspSpan[], role?: string, key?: string): NativeNode =>
-			keyed(text(spans, { wrap: "none", truncate: "end", role }), key ?? role ?? "");
-		// Centered brand lines are short and fixed; the logo is multi-line art that must never truncate.
+		const lang = tuiText("welcomeBack", "Welcome back!");
+		const rawTip = this.tip;
+		const tip = rawTip === undefined ? undefined : resolveTip(rawTip);
+		if (this.#native && this.#native.lang === lang && this.#native.tip === tip?.text) return this.#native.node;
+		// Brand lines are short and fixed; never wrap or truncate them.
 		const art = (spans: readonly TspSpan[], role: string): NativeNode =>
 			keyed(text(spans, { wrap: "none", role }), role);
-		const brand = keyed(
-			col(
+		const lockupRow = keyed(
+			row(
 				[
-					art([span("Welcome back!", "strong")], "zeta.welcome.greeting"),
 					node(
 						"image",
 						{
@@ -292,115 +310,38 @@ export class WelcomeComponent implements Component {
 						undefined,
 						"logo",
 					),
-				],
-				{ align: "center", role: "zeta.welcome.brand" },
-			),
-			"brand",
-		);
-		const section = (key: string, label: string, rows: readonly NativeChild[]): NativeNode =>
-			keyed(
-				col([line([span(label, "dim")], "zeta.welcome.heading"), ...rows], {
-					gap: "xs",
-					role: `zeta.welcome.${key}`,
-				}),
-				key,
-			);
-		const shortcut = (key: string, label: string): NativeNode =>
-			keyed(row([kbd(key), line([span(label, "muted")])], { gap: "sm" }), label);
-		const info: NativeChild[] = [
-			line([span(this.version, "dim mono")], "zeta.welcome.version"),
-			section("tips", "Tips", [
-				shortcut("#", "prompt actions"),
-				shortcut("/", "commands"),
-				shortcut("!", "run bash"),
-				shortcut("$", "run python"),
-			]),
-		];
-		if (this.lspServers !== null) {
-			const lsp: NativeChild[] = [];
-			if (this.lspServers.length === 0) lsp.push(line([span("No LSP servers", "dim")], undefined, "none"));
-			for (const server of this.lspServers.slice(0, WELCOME_LSP_SLOTS)) {
-				const [symbol, token] =
-					server.status === "ready"
-						? (["status.enabled", "success"] as const)
-						: server.status === "available"
-							? (["status.enabled", "dim"] as const)
-							: server.status === "connecting"
-								? (["status.pending", "muted"] as const)
-								: (["status.error", "error"] as const);
-				lsp.push(
 					keyed(
-						row(
+						col(
 							[
-								text([span("●", token)], { role: "zeta.welcome.lsp-dot", title: server.status, aria: symbol }),
-								line([span(server.name)]),
-								...server.fileTypes
-									.slice(0, 3)
-									.map(type => node("badge", { text: type, role: "zeta.welcome.lsp-type" }, undefined, type)),
+								art([span("Z e t a", "strong")], "zeta.welcome.wordmark"),
+								art([span(`v${this.version}`, "dim mono")], "zeta.welcome.version"),
 							],
-							{ gap: "sm", role: "zeta.welcome.lsp-row" },
+							{ role: "zeta.welcome.mark" },
 						),
-						server.name,
+						"mark",
 					),
-				);
-			}
-			info.push(section("lsp", "LSP servers", lsp));
-		}
-		const recents: NativeChild[] = [];
-		if (this.recentSessions.length === 0) recents.push(line([span("No recent sessions", "dim")], undefined, "none"));
-		for (const [index, session] of this.recentSessions.slice(0, WELCOME_SESSION_SLOTS).entries()) {
-			recents.push(
-				keyed(
-					row(
-						[
-							line([span(plainLine(session.name))], "zeta.welcome.session"),
-							line([span(session.timeAgo, "dim")], "zeta.welcome.age"),
-						],
-						{
-							gap: "md",
-							justify: "between",
-							role: "zeta.welcome.recent",
-							actions: session.path ? { click: "resume" } : undefined,
-							title: session.path ? `Resume ${plainLine(session.name)}` : undefined,
-						},
-					),
-					`s${index}`,
-				),
-			);
-		}
-		info.push(section("recents", "Recent sessions", recents));
-		const body: NativeChild[] = [
-			keyed(
-				row([brand, keyed(col(info, { gap: "md", role: "zeta.welcome.info" }), "info")], {
-					align: "start",
-					wrap: true,
-					role: "zeta.welcome.grid",
-				}),
-				"grid",
+				],
+				{ align: "center", gap: "md", role: "zeta.welcome.lockup" },
 			),
-		];
+			"lockup",
+		);
+		const body: NativeChild[] = [lockupRow];
 		if (tip) {
-			const isNew = NEW_TIP_MARKER.test(tip);
-			const tipText = compactText(tipSpans(expandTipKeys(isNew ? tip.replace(NEW_TIP_MARKER, "") : tip)));
+			const tipText = compactText(tipSpans(expandTipKeys(tip.text)));
 			const tipRow: NativeChild[] = [
 				node("icon", { name: "lightbulb", role: "zeta.welcome.tip-icon" }),
 				text(tipText, { wrap: "word", role: "zeta.welcome.tip-text" }),
 			];
-			if (isNew) tipRow.push(node("shimmer", { text: "New", role: "zeta.welcome.new" }));
+			if (tip.isNew) {
+				tipRow.push(node("shimmer", { text: tuiText("welcomeNewTag", NEW_TAG_TEXT), role: "zeta.welcome.new" }));
+			}
 			body.push(node("row", { gap: "sm", align: "start", role: "zeta.welcome.tip" }, tipRow, "tip"));
 		}
-		// No head row or chevron: the card is the hero; the version sits in the info column.
+		// No head row or chevron: the card is the hero; the version sits under the wordmark.
 		const described = card({ role: "zeta.welcome" }, body);
-		this.#native = { tip, node: described };
+		this.#native = { lang, tip: tip?.text, node: described };
 		return described;
 	}
-	/** A click on a recent session resumes it. */
-	handleNativeEvent(event: NativeUiEvent): void {
-		if (event.type !== "action" || event.act !== "resume") return;
-		const index = Number(/\/s(\d+)$/.exec(event.key)?.[1]);
-		const path = this.recentSessions[index]?.path;
-		if (path) runTranscriptAction({ act: "resume", path });
-	}
 
 	/** The intro keeps the welcome block mutable; settling lets it retire to history. */
 	isTranscriptBlockFinalized(): boolean {
@@ -468,25 +409,10 @@ export class WelcomeComponent implements Component {
 		this.invalidate();
 	}
 
-	setModel(modelName: string, providerName: string): void {
-		this.modelName = modelName;
-		this.providerName = providerName;
-		this.invalidate();
-	}
-
-	setRecentSessions(sessions: RecentSession[]): void {
-		this.recentSessions = sessions;
-		this.invalidate();
-	}
-
-	setLspServers(servers: LspServerInfo[] | null): void {
-		this.lspServers = servers;
-		this.invalidate();
-	}
-
 	render(termWidth: number): readonly string[] {
 		const animating = this.#animStart != null;
-		if (!animating && this.#cachedLines && this.#cachedWidth === termWidth) {
+		const lang = tuiText("welcomeBack", "Welcome back!");
+		if (!animating && this.#cachedLines && this.#cachedWidth === termWidth && this.#cachedLang === lang) {
 			return this.#cachedLines;
 		}
 		const lines = this.#renderLines(termWidth);
@@ -496,223 +422,39 @@ export class WelcomeComponent implements Component {
 		} else {
 			this.#cachedLines = lines;
 			this.#cachedWidth = termWidth;
+			this.#cachedLang = lang;
 		}
 		return lines;
 	}
 
 	#renderLines(termWidth: number): string[] {
-		// Box dimensions - responsive with max width and small-terminal support
-		const maxWidth = 100;
-		const boxWidth = Math.min(maxWidth, Math.max(0, termWidth - 2));
-		if (boxWidth < 4) {
-			return [];
-		}
-		const dualContentWidth = boxWidth - 3; // 3 = │ + │ + │
-		const preferredLeftCol = 26;
-		const minLeftCol = 12; // logo width
-		const minRightCol = 20;
-		// 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 desiredLeftCol = Math.max(
-			Math.min(preferredLeftCol, Math.max(minLeftCol, Math.floor(dualContentWidth * 0.35))),
-			leftMinContentWidth,
-		);
-		const dualLeftCol =
-			dualContentWidth >= minRightCol + 1
-				? Math.min(desiredLeftCol, dualContentWidth - minRightCol)
-				: Math.max(1, dualContentWidth - 1);
-		const dualRightCol = Math.max(1, dualContentWidth - dualLeftCol);
-		const showRightColumn = dualLeftCol >= leftMinContentWidth && dualRightCol >= minRightCol;
-		const leftCol = showRightColumn ? dualLeftCol : boxWidth - 2;
-		const rightCol = showRightColumn ? dualRightCol : 0;
-
-		// Logo: pick a frame from the intro animation if active, else the resting frame.
-		const logoColored = this.#currentLogoFrame();
-
-		// Left column - centered content
-		const leftLines = [
-			"",
-			this.#centerText(theme.bold("Welcome back!"), leftCol),
-			"",
-			...logoColored.map(l => this.#centerText(l, leftCol)),
-			"",
-			this.#centerText(theme.fg("muted", this.modelName), leftCol),
-			this.#centerText(theme.fg("borderMuted", this.providerName), leftCol),
-		];
-
-		// Right column separator
-		const separatorWidth = Math.max(0, rightCol - 2); // padding on each side
-		const separator = ` ${theme.fg("dim", theme.boxRound.horizontal.repeat(separatorWidth))}`;
-
-		// Recent sessions content
-		const sessionLines: string[] = [];
-		if (this.recentSessions.length === 0) {
-			sessionLines.push(` ${theme.fg("dim", "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
-			// absorbs whatever space is left.
-			const bulletPrefix = ` ${theme.md.bullet} `;
-			const prefixWidth = visibleWidth(bulletPrefix);
-			for (const session of this.recentSessions.slice(0, WELCOME_SESSION_SLOTS)) {
-				const timeSuffixRaw = ` (${session.timeAgo})`;
-				const timeWidth = visibleWidth(timeSuffixRaw);
-				const nameBudget = Math.max(1, rightCol - prefixWidth - timeWidth);
-				const nameVis = visibleWidth(session.name);
-				const name = nameVis > nameBudget ? truncateToWidth(session.name, nameBudget) : session.name;
-				sessionLines.push(
-					`${theme.fg("dim", bulletPrefix)}${theme.fg("muted", name)}${theme.fg("dim", timeSuffixRaw)}`,
-				);
-			}
-		}
-		// Pad to the fixed slot count so the box height doesn't depend on session count.
-		while (sessionLines.length < WELCOME_SESSION_SLOTS) {
-			sessionLines.push("");
-		}
-
-		// 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")}`,
-			...this.#renderLspSection(separator),
-			separator,
-			` ${theme.bold(theme.fg("accent", "Recent sessions"))}`,
-			...sessionLines,
-			"",
-		];
-
-		// Border characters (dim)
-		const hChar = theme.boxRound.horizontal;
-		const h = theme.fg("dim", hChar);
-		const v = theme.fg("dim", theme.boxRound.vertical);
-		const tl = theme.fg("dim", theme.boxRound.topLeft);
-		const tr = theme.fg("dim", theme.boxRound.topRight);
-		const bl = theme.fg("dim", theme.boxRound.bottomLeft);
-		const br = theme.fg("dim", theme.boxRound.bottomRight);
-
-		const lines: string[] = [];
-
-		// Top border with embedded title
-		const title = ` ${APP_NAME} v${this.version} `;
-		const titlePrefixRaw = hChar.repeat(3);
-		const titleStyled = theme.fg("dim", titlePrefixRaw) + theme.fg("muted", title);
-		const titleVisLen = visibleWidth(titlePrefixRaw) + visibleWidth(title);
-		const titleSpace = boxWidth - 2;
-		if (titleVisLen >= titleSpace) {
-			lines.push(tl + truncateToWidth(titleStyled, titleSpace) + tr);
-		} else {
-			const afterTitle = titleSpace - titleVisLen;
-			lines.push(tl + titleStyled + theme.fg("dim", hChar.repeat(afterTitle)) + tr);
-		}
-
-		// Content rows
-		const maxRows = showRightColumn ? Math.max(leftLines.length, rightLines.length) : leftLines.length;
-		for (let i = 0; i < maxRows; i++) {
-			const left = this.#fitToWidth(leftLines[i] ?? "", leftCol);
-			if (showRightColumn) {
-				const right = this.#fitToWidth(rightLines[i] ?? "", rightCol);
-				lines.push(v + left + v + right + v);
-			} else {
-				lines.push(v + left + v);
-			}
-		}
-		// Bottom border
-		if (showRightColumn) {
-			lines.push(bl + h.repeat(leftCol) + theme.fg("dim", theme.boxRound.teeUp) + h.repeat(rightCol) + br);
-		} else {
-			lines.push(bl + h.repeat(leftCol) + br);
-		}
-
-		// Randomly picked tip, rendered directly beneath the box.
-		// The banner centers every tip line, so the tip drops out entirely on
-		// narrow boxes rather than wrapping into unreadable slivers.
-		if (termWidth >= 16) lines.push(...this.#renderTip(boxWidth));
-
+		// Content keeps a column clear on each side; everything centers in the full width.
+		const room = termWidth - 2;
+		if (room < 4) return [];
+		const logo = this.#currentLogoFrame();
+		const version = theme.fg("dim", `v${this.version}`);
+		const lockupWidth = LOGO_WIDTH + LOCKUP_GAP + Math.max(WORDMARK_WIDTH, visibleWidth(version));
+		const art = room >= lockupWidth ? lockup(logo, version) : room >= LOGO_WIDTH ? logo : [];
+		const lines = centerBlock(art, termWidth);
+		const tip = termWidth >= TIP_MIN_COLUMNS ? this.#renderTip(room) : [];
+		if (tip.length > 0) lines.push("", ...tip.flatMap(line => centerBlock([line], termWidth)));
 		return lines;
 	}
 
-	/** Right-column LSP rows padded to a fixed height; empty when LSP is disabled. */
-	#renderLspSection(separator: string): string[] {
-		if (this.lspServers === null) return [];
-		const lspLines: string[] = [];
-		if (this.lspServers.length === 0) {
-			lspLines.push(` ${theme.fg("dim", "No LSP servers")}`);
-		} else {
-			for (const server of this.lspServers.slice(0, WELCOME_LSP_SLOTS)) {
-				const icon =
-					server.status === "ready"
-						? theme.styledSymbol("status.enabled", "success")
-						: server.status === "available"
-							? theme.styledSymbol("status.enabled", "dim")
-							: server.status === "connecting"
-								? theme.styledSymbol("status.pending", "muted")
-								: theme.styledSymbol("status.error", "error");
-				const exts = server.fileTypes.slice(0, 3).join(" ");
-				lspLines.push(` ${icon} ${theme.fg("muted", server.name)} ${theme.fg("dim", exts)}`);
-			}
-		}
-		// Pad to the fixed slot count so the box height doesn't depend on server count.
-		while (lspLines.length < WELCOME_LSP_SLOTS) {
-			lspLines.push("");
-		}
-		return [separator, ` ${theme.bold(theme.fg("accent", "LSP Servers"))}`, ...lspLines];
-	}
-
 	/**
-	 * Render the per-instance tip line: the `customMessageLabel`-themed `Tip:`
-	 * label followed by a `muted` body, the whole line italicized. Returns `[]`
-	 * when no tip is available or the box is too narrow to be useful.
+	 * The tip of the session wrapped to {@link TIP_MEASURE} columns (fewer when
+	 * `room` is narrower); `[]` when there is none or no room for it.
 	 */
-	#renderTip(boxWidth: number): string[] {
-		const tip = this.tip;
-		if (!tip) return [];
-		// A trailing "[NEW]" marker paints an animated rainbow "NEW!" tag. Derive
-		// its hue phase from wall-clock time so it shimmers across the welcome
-		// intro's re-render frames, then settles into a still rainbow once the box
+	#renderTip(room: number): string[] {
+		const raw = this.tip;
+		if (!raw) return [];
+		// A trailing "[NEW]" marker paints an animated rainbow tag. Derive its
+		// hue phase from wall-clock time so it shimmers across the welcome intro's
+		// re-render frames, then settles into a still rainbow once the banner
 		// 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);
-	}
-
-	/** Center text within a given width */
-	#centerText(text: string, width: number): string {
-		const visLen = visibleWidth(text);
-		if (visLen >= width) {
-			return truncateToWidth(text, width);
-		}
-		const leftPad = Math.floor((width - visLen) / 2);
-		const rightPad = width - visLen - leftPad;
-		return padding(leftPad) + text + padding(rightPad);
-	}
-
-	/** Fit string to exact width with ANSI-aware truncation/padding */
-	#fitToWidth(str: string, width: number): string {
-		const visLen = visibleWidth(str);
-		if (visLen > width) {
-			const ellipsis = "…";
-			const ellipsisWidth = visibleWidth(ellipsis);
-			const maxWidth = Math.max(0, width - ellipsisWidth);
-			let truncated = "";
-			let currentWidth = 0;
-			let inEscape = false;
-			for (const char of str) {
-				if (char === "\x1b") inEscape = true;
-				if (inEscape) {
-					truncated += char;
-					if (char === "m") inEscape = false;
-				} else if (currentWidth < maxWidth) {
-					truncated += char;
-					currentWidth++;
-				}
-			}
-			return `${truncated}${ellipsis}`;
-		}
-		return str + padding(width - visLen);
+		const tip = resolveTip(raw);
+		const phase = tip.isNew ? performance.now() / NEW_GLOW_PERIOD_MS : 0;
+		return renderWelcomeTip(tip.text, Math.min(room, TIP_MEASURE), phase, tip.isNew);
 	}
 
 	/** Pick the logo frame for the current intro phase, or the resting frame. */
@@ -725,7 +467,46 @@ export class WelcomeComponent implements Component {
 }
 
 /** Block-grid brand mark shared by the welcome and setup surfaces. */
-export const ZETA_LOGO = ["█████████╗", "╚════████║", "   ████╔═╝", " ████╔═╝  ", "█████████╗", "╚════════╝"];
+export const ZETA_LOGO = ["████████████", "   ████████ ", "  ████████  ", " ████████▒▒▒", "████████████"];
+
+/** Columns of {@link ZETA_LOGO}. */
+const LOGO_WIDTH = Math.max(...ZETA_LOGO.map(row => row.length));
+
+/**
+ * The `Zeta` wordmark in half-blocks, set beside {@link ZETA_LOGO} from its
+ * second row: the `Z` is a solid zig-zag closed by a light step, `e`/`a` sit on
+ * the x-height, the `t` ascender rises above it, and the version takes the
+ * fifth row.
+ */
+const WORDMARK = ["███▀         ▄        ", " ██   ███▄  ███   ▄██▄", "▄▄██  █▄▄    █▄   █▄▄█"];
+
+/** Columns of {@link WORDMARK}. */
+const WORDMARK_WIDTH = Math.max(...WORDMARK.map(row => row.length));
+
+/** Columns between the logo and the wordmark. */
+const LOCKUP_GAP = 4;
+
+/** Widest a welcome tip wraps, so a long one stays a centered paragraph. */
+const TIP_MEASURE = 72;
+
+/** Narrowest terminal that still shows the tip; below it the banner is the logo alone. */
+const TIP_MIN_COLUMNS = 50;
+
+/** Logo frame `logo` with the wordmark beside it and `version` (styled) under the wordmark. */
+function lockup(logo: readonly string[], version: string): string[] {
+	const beside = ["", ...WORDMARK.map(row => theme.bold(theme.fg("text", row))), version];
+	return logo.map((row, index) => `${row}${padding(LOCKUP_GAP)}${beside[index] ?? ""}`);
+}
+
+/**
+ * `lines` indented as one block whose widest line is centered in `width`
+ * columns; pass a single line to center it on its own.
+ */
+function centerBlock(lines: readonly string[], width: number): string[] {
+	const widest = lines.reduce((max, line) => Math.max(max, visibleWidth(line)), 0);
+	const indent = padding(Math.max(0, Math.floor((width - widest) / 2)));
+	return lines.map(line => indent + line);
+}
 
 /** The block-grid brand mark as accent lines; `shimmer` declares the terminal-clocked shine sweep. */
 export function logoNode(lines: readonly string[], shimmer: boolean): NativeNode {

package/src/setup/scenes/splash.ts

@@ -27,18 +27,11 @@ const RESET = "\x1b[0m";
 const MIN_SCENE_WIDTH = 56;
 const MIN_SCENE_HEIGHT = 22;
 
+/** Skip affordance; built at render time so it follows the live symbol preset. */
 function skipHint(): string {
-	return `press ${formatKeyHint("enter")} to skip`;
+	return tuiText("setupSkipHint", "press {key} to skip").replace("{key}", formatKeyHint("enter"));
 }
 
-/** Density ramp for the rippling water, lightest → heaviest. */
-const WATER_RAMP = [
-	{ min: 0.62, char: "█" },
-	{ min: 0.5, char: "▓" },
-	{ min: 0.36, char: "▒" },
-	{ min: 0.24, char: "░" },
-];
-
 function starAt(x: number, y: number, frame: number): string {
 	const hash = (x * 73856093) ^ (y * 19349663) ^ (frame * 83492791);
 	const bucket = Math.abs(hash) % 97;
@@ -85,35 +78,88 @@ function waterJitter(x: number, y: number): number {
 }
 
 /**
- * Rippling water amplitude in [0,1] at (x, y): three travelling sine waves
- * interfere, then a radial edge falloff and a downward fade concentrate the
- * ripples beneath the mark and dissolve them toward the edges/bottom. `t`
- * advances each tick, so the surface drifts.
+ * Time-invariant terms of the rippling water for one screen size: three
+ * travelling sine waves interfere, then a radial edge falloff and a downward
+ * fade concentrate the ripples beneath the mark and dissolve them toward the
+ * edges/bottom. Only the sine phases move per tick, so everything else is
+ * computed once per size.
  */
-function waterAmplitude(
-	x: number,
-	y: number,
-	cx: number,
-	waterTop: number,
-	waterHeight: number,
-	width: number,
-	t: number,
-): number {
-	const dx = (x - cx) / 2;
-	const dy = y - waterTop;
-	const dist = Math.sqrt(dx * dx + dy * dy);
-	const wave =
-		0.5 * Math.sin(dist * 0.55 - t) +
-		0.3 * Math.sin(x * 0.22 + y * 0.45 - t * 0.7) +
-		0.2 * Math.sin(Math.abs(dx) * 0.8 + dy * 0.5 - t * 1.4);
-	const level = 0.5 + 0.5 * wave;
-	const edge = Math.max(0, 1 - Math.abs(x - cx) / (width * 0.5));
-	const fade = Math.max(0, 1 - (dy / Math.max(1, waterHeight)) * 0.55);
-	return level * edge ** 0.7 * fade;
+interface WaterField {
+	readonly width: number;
+	readonly height: number;
+	readonly waterTop: number;
+	/** Per cell (row-major from `waterTop`): `dist * 0.55`. */
+	readonly radial: Float64Array;
+	/** Per cell: `x * 0.22 + y * 0.45`. */
+	readonly diagonal: Float64Array;
+	/** Per cell: `|dx| * 0.8 + dy * 0.5`. */
+	readonly cross: Float64Array;
+	/** Per cell: `(waterJitter(x, y) - 0.5) * 0.06`. */
+	readonly jitter: Float64Array;
+	/** Per column: `edge ** 0.7`. */
+	readonly edge: Float64Array;
+	/** Per water row: downward fade. */
+	readonly fade: Float64Array;
+}
+
+let waterField: WaterField | undefined;
+
+function getWaterField(width: number, height: number, cx: number, waterTop: number): WaterField {
+	const cached = waterField;
+	if (cached && cached.width === width && cached.height === height && cached.waterTop === waterTop) return cached;
+	const waterHeight = Math.max(1, height - waterTop);
+	const rows = Math.max(0, height - waterTop);
+	const radial = new Float64Array(rows * width);
+	const diagonal = new Float64Array(rows * width);
+	const cross = new Float64Array(rows * width);
+	const jitter = new Float64Array(rows * width);
+	const edge = new Float64Array(width);
+	const fade = new Float64Array(rows);
+	for (let x = 0; x < width; x++) edge[x] = Math.max(0, 1 - Math.abs(x - cx) / (width * 0.5)) ** 0.7;
+	for (let row = 0; row < rows; row++) {
+		const y = waterTop + row;
+		const dy = y - waterTop;
+		fade[row] = Math.max(0, 1 - (dy / waterHeight) * 0.55);
+		for (let x = 0; x < width; x++) {
+			const i = row * width + x;
+			const dx = (x - cx) / 2;
+			radial[i] = Math.sqrt(dx * dx + dy * dy) * 0.55;
+			diagonal[i] = x * 0.22 + y * 0.45;
+			cross[i] = Math.abs(dx) * 0.8 + dy * 0.5;
+			jitter[i] = (waterJitter(x, y) - 0.5) * 0.06;
+		}
+	}
+	waterField = { width, height, waterTop, radial, diagonal, cross, jitter, edge, fade };
+	return waterField;
+}
+
+/** Water glyph for an amplitude, lightest → heaviest density ramp; undefined below the floor. */
+function waterChar(amp: number): string | undefined {
+	if (amp > 0.62) return "█";
+	if (amp > 0.5) return "▓";
+	if (amp > 0.36) return "▒";
+	if (amp > 0.24) return "░";
+	return undefined;
 }
 
+/** Reused cell grid; resized when the screen changes. */
+let splashCells: string[][] = [];
+
+function resetCells(width: number, height: number): string[][] {
+	if (splashCells.length !== height || splashCells[0]?.length !== width) {
+		// oxlint-disable-next-line unicorn/no-new-array -- length preallocation
+		splashCells = Array.from({ length: height }, () => new Array<string>(width).fill(" "));
+	} else {
+		for (const row of splashCells) row.fill(" ");
+	}
+	return splashCells;
+}
+
+/** Per-frame gradient escapes, one per screen diagonal (the gradient only varies along it). */
+let diagonalEscapes: (string | undefined)[] = [];
+
 /**
- * Animated setup splash, in the spirit of the omp landing page: the brand ζ
+ * Animated setup splash, in the spirit of the Zeta visual identity: the brand ζ
  * mark rendered with the live diagonal gradient + shine sweep, rising out of a
  * rippling, gradient-lit water surface, under a faint twinkling starfield. The
  * mark and water share one continuous gradient so the sweep reads across the
@@ -132,23 +178,46 @@ export function renderSetupSplash(width: number, height: number, elapsedMs: numb
 	const cx = Math.floor(w / 2);
 	const surfaceTime = frame * 0.13;
 
-	// [suppressed] length preallocation
-	const cells: string[][] = Array.from({ length: h }, () => new Array<string>(w).fill(" "));
+	const cells = resetCells(w, h);
 	const put = (x: number, y: number, glyph: string): void => {
 		if (y >= 0 && y < h && x >= 0 && x < w) cells[y][x] = glyph;
 	};
+	// Every cell on a diagonal shares one gradient position, so resolve each
+	// escape once per frame instead of once per cell.
+	const diagonals = w + h - 1;
+	if (diagonalEscapes.length !== diagonals) diagonalEscapes = Array.from({ length: diagonals });
+	else diagonalEscapes.fill(undefined);
+	const escapes = diagonalEscapes;
+	const gradient = (x: number, y: number): string => {
+		const d = x + (h - 1 - y);
+		let escape = escapes[d];
+		if (escape === undefined) {
+			escape = gradientEscape(screenGradientT(x, y, w, h, phase), shine);
+			escapes[d] = escape;
+		}
+		return escape;
+	};
 
 	const hx = Math.floor((w - LOGO_WIDTH) / 2);
 	const hy = Math.max(2, Math.floor(h * 0.16));
 	const waterTop = hy + LOGO_HEIGHT;
-	const waterHeight = Math.max(1, h - waterTop);
 
 	// 1. rippling water surface (shares the screen-wide gradient with the mark)
+	const field = getWaterField(w, h, cx, waterTop);
+	const tDiagonal = surfaceTime * 0.7;
+	const tCross = surfaceTime * 1.4;
 	for (let y = waterTop; y < h; y++) {
+		const row = y - waterTop;
+		const fade = field.fade[row];
 		for (let x = 0; x < w; x++) {
-			const amp = waterAmplitude(x, y, cx, waterTop, waterHeight, w, surfaceTime) + (waterJitter(x, y) - 0.5) * 0.06;
-			const cell = WATER_RAMP.find(step => amp > step.min);
-			if (cell) put(x, y, gradientEscape(screenGradientT(x, y, w, h, phase), shine) + cell.char + RESET);
+			const i = row * w + x;
+			const wave =
+				0.5 * Math.sin(field.radial[i] - surfaceTime) +
+				0.3 * Math.sin(field.diagonal[i] - tDiagonal) +
+				0.2 * Math.sin(field.cross[i] - tCross);
+			const level = 0.5 + 0.5 * wave;
+			const char = waterChar(level * field.edge[x] * fade + field.jitter[i]);
+			if (char) cells[y][x] = gradient(x, y) + char + RESET;
 		}
 	}
 	// 2. twinkling starfield in the sky above the water
@@ -162,18 +231,15 @@ export function renderSetupSplash(width: number, height: number, elapsedMs: numb
 	LARGE_LOGO.forEach((line, row) => {
 		let col = 0;
 		for (const ch of line) {
-			if (ch !== " ") {
-				put(
-					hx + col,
-					hy + row,
-					gradientEscape(screenGradientT(hx + col, hy + row, w, h, phase), shine) + ch + RESET,
-				);
-			}
+			const x = hx + col;
+			const y = hy + row;
+			if (ch !== " " && y >= 0 && y < h && x >= 0 && x < w) cells[y][x] = gradient(x, y) + ch + RESET;
 			col++;
 		}
 	});
-	// 4. skip hint on a cleared strip at the bottom so it stays legible over the water
-	const hint = tuiText("setupSkipHint", "press enter to skip");
+	// 4. skip hint on a cleared strip at the bottom so it stays legible over the water.
+	// `formatKeyHint` yields plain glyphs (no ANSI), so per-character dim styling is safe.
+	const hint = skipHint();
 	const hintWidth = visibleWidth(hint);
 	const hintStart = Math.floor((w - hintWidth) / 2);
 	const hintRow = h - 1;
@@ -219,9 +285,6 @@ function renderCompactSplash(width: number, height: number, phase: number, shine
 		lines.push(width > 0 ? padToWidth(item !== undefined ? centerLine(item, width) : "", width) : "");
 	}
 	if (height > 2)
-		lines[height - 2] =
-			width > 0
-				? padToWidth(centerLine(theme.fg("dim", tuiText("setupSkipHint", "press enter to skip")), width), width)
-				: "";
+		lines[height - 2] = width > 0 ? padToWidth(centerLine(theme.fg("dim", skipHint()), width), width) : "";
 	return lines;
 }