@deepseek-harness-tui/dsh-tui 0.11.0 → 0.11.2

package/lib/types/components/SubagentCard.js

@@ -9,7 +9,11 @@ function formatDuration(ms) {
 }
 export function SubagentCard({ subagent, focused, onClick }) {
     const running = subagent.status === 'running' || subagent.status === 'starting';
-    const elapsed = subagent.completedAt ? subagent.completedAt - subagent.startedAt : Date.now() - subagent.startedAt;
+    // Only a live run ticks; discovered history (`unknown`) has no end time to
+    // count from, so it must not accumulate a fake growing duration.
+    const elapsed = running
+        ? Date.now() - subagent.startedAt
+        : subagent.completedAt !== undefined ? subagent.completedAt - subagent.startedAt : undefined;
     const total = subagent.tokens?.total ?? ((subagent.tokens?.input ?? 0) + (subagent.tokens?.output ?? 0) || 0);
     // Mouse affordance: clickable cards tint on hover; the keyboard-focused
     // card keeps its brand-color header (no double highlight).
@@ -22,12 +26,14 @@ export function SubagentCard({ subagent, focused, onClick }) {
     const liveLine = running ? subagent.output[subagent.output.length - 1] : undefined;
     const minimal = isMinimalMode();
     const glyph = running ? (minimal ? '·' : '🟡')
-        : subagent.status === 'failed' || subagent.status === 'cancelled' ? (minimal ? '×' : '🔴')
-            : (minimal ? '✓' : '🟢');
+        : subagent.status === 'unknown' ? (minimal ? '·' : '⚪')
+            : subagent.status === 'failed' || subagent.status === 'cancelled' ? (minimal ? '×' : '🔴')
+                : (minimal ? '✓' : '🟢');
     const glyphColor = minimal ? undefined
         : running ? 'warning'
-            : subagent.status === 'failed' || subagent.status === 'cancelled' ? 'error'
-                : 'success';
+            : subagent.status === 'unknown' ? 'subtle'
+                : subagent.status === 'failed' || subagent.status === 'cancelled' ? 'error'
+                    : 'success';
     const hoverTint = onClick !== undefined && hovered && !focused;
-    return _jsxs(Box, { flexDirection: "column", paddingLeft: 1, marginBottom: 1, onClick: onClick, onMouseEnter: onClick !== undefined ? () => setHovered(true) : undefined, onMouseLeave: onClick !== undefined ? () => setHovered(false) : undefined, backgroundColor: hoverTint ? 'userMessageBackgroundHover' : undefined, children: [_jsxs(Box, { flexDirection: "row", gap: 1, children: [_jsx(Text, { color: glyphColor, children: glyph }), _jsx(Text, { bold: true, color: focused ? 'accent' : undefined, children: `${t('subagent-card-prefix')}${subagent.description}` }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: ' · ' }), _jsx(Text, { children: subagent.model ?? subagent.provider ?? 'default' }), _jsx(Text, { dimColor: true, children: ` · ${formatDuration(elapsed)} · ${total || '—'} tok · ${subagent.toolCalls.length} tools` })] })] }), liveLine && _jsx(Text, { dimColor: true, wrap: "truncate", children: `  │ ${liveLine}` })] });
+    return _jsxs(Box, { flexDirection: "column", paddingLeft: 1, marginBottom: 1, onClick: onClick, onMouseEnter: onClick !== undefined ? () => setHovered(true) : undefined, onMouseLeave: onClick !== undefined ? () => setHovered(false) : undefined, backgroundColor: hoverTint ? 'userMessageBackgroundHover' : undefined, children: [_jsxs(Box, { flexDirection: "row", gap: 1, children: [_jsx(Text, { color: glyphColor, children: glyph }), _jsx(Text, { bold: true, color: focused ? 'accent' : undefined, children: `${t('subagent-card-prefix')}${subagent.description}` }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: ' · ' }), _jsx(Text, { children: subagent.model ?? subagent.provider ?? 'default' }), _jsxs(Text, { dimColor: true, children: [elapsed !== undefined ? ` · ${formatDuration(elapsed)} · ` : ' · ', total || '—', " tok \u00B7 ", subagent.toolCalls.length, " tools"] })] })] }), liveLine && _jsx(Text, { dimColor: true, wrap: "truncate", children: `  │ ${liveLine}` })] });
 }

package/lib/types/components/SubagentDetailScene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SubagentDetailScene.d.ts","sourceRoot":"","sources":["../../../src/components/SubagentDetailScene.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAuGhE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,aAAa,CAAA;IACvB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACxC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,MAAM,EACN,WAAW,GACZ,EAAE,wBAAwB,GAAG,KAAK,CAAC,SAAS,CA8M5C"}
+{"version":3,"file":"SubagentDetailScene.d.ts","sourceRoot":"","sources":["../../../src/components/SubagentDetailScene.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAwGhE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,aAAa,CAAA;IACvB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACxC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,MAAM,EACN,WAAW,GACZ,EAAE,wBAAwB,GAAG,KAAK,CAAC,SAAS,CAiN5C"}

package/lib/types/components/SubagentDetailScene.js

@@ -28,6 +28,8 @@ function statusGlyph(status) {
         return { glyph: minimal ? '×' : '🔴', color: minimal ? undefined : 'error', label: 'failed' };
     if (status === 'cancelled')
         return { glyph: minimal ? '×' : '🔴', color: minimal ? undefined : 'error', label: 'cancelled' };
+    if (status === 'unknown')
+        return { glyph: minimal ? '·' : '⚪', color: minimal ? undefined : 'subtle', label: 'history' };
     return { glyph: minimal ? '·' : '🟡', color: minimal ? undefined : 'warning', label: 'running' };
 }
 const PAGES = ['summary', 'output', 'tools'];
@@ -37,7 +39,7 @@ function StatRow({ label, children }) {
 }
 /** Two-column key/value stats grid (Kimi Code settled summary style). */
 function StatGrid({ subagent, totalTokens, elapsed, statusLabel, statusColor }) {
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(StatRow, { label: t('subagent-status-label'), children: _jsx(Text, { color: statusColor, children: statusLabel }) }), _jsx(StatRow, { label: t('subagent-model'), children: _jsx(Text, { children: subagent.model ?? subagent.provider ?? 'default' }) }), _jsx(StatRow, { label: t('subagent-duration'), children: _jsx(Text, { children: formatDuration(elapsed) }) }), _jsx(StatRow, { label: "tokens", children: _jsxs(Text, { children: [totalTokens || '—', subagent.tokens?.input !== undefined ? ` (in ${subagent.tokens.input} · out ${subagent.tokens.output ?? 0})` : ''] }) }), _jsx(StatRow, { label: t('subagent-tools'), children: _jsx(Text, { children: subagent.toolCalls.length }) }), _jsx(StatRow, { label: t('subagent-started'), children: _jsx(Text, { children: formatTimestamp(subagent.startedAt) }) }), subagent.completedAt !== undefined && (_jsx(StatRow, { label: t('subagent-completed'), children: _jsx(Text, { children: formatTimestamp(subagent.completedAt) }) }))] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(StatRow, { label: t('subagent-status-label'), children: _jsx(Text, { color: statusColor, children: statusLabel }) }), _jsx(StatRow, { label: t('subagent-model'), children: _jsx(Text, { children: subagent.model ?? subagent.provider ?? 'default' }) }), _jsx(StatRow, { label: t('subagent-duration'), children: _jsx(Text, { children: elapsed !== undefined ? formatDuration(elapsed) : '—' }) }), _jsx(StatRow, { label: "tokens", children: _jsxs(Text, { children: [totalTokens || '—', subagent.tokens?.input !== undefined ? ` (in ${subagent.tokens.input} · out ${subagent.tokens.output ?? 0})` : ''] }) }), _jsx(StatRow, { label: t('subagent-tools'), children: _jsx(Text, { children: subagent.toolCalls.length }) }), _jsx(StatRow, { label: t('subagent-started'), children: _jsx(Text, { children: formatTimestamp(subagent.startedAt) }) }), subagent.completedAt !== undefined && (_jsx(StatRow, { label: t('subagent-completed'), children: _jsx(Text, { children: formatTimestamp(subagent.completedAt) }) }))] }));
 }
 /** Tool args line: JSON-looking args get cli-highlight syntax colors (loaded
  * lazily through the shared promise); anything else stays a dim flat line. */
@@ -77,7 +79,10 @@ export function SubagentDetailScene({ subagent, onBack, onInterrupt, }) {
     const { rows, columns } = useTerminalSize();
     const [page, setPage] = React.useState('summary');
     const isRunning = subagent.status === 'running' || subagent.status === 'starting';
-    const elapsed = subagent.completedAt ? subagent.completedAt - subagent.startedAt : Date.now() - subagent.startedAt;
+    // Only a live run ticks; discovered history (`unknown`) shows no duration.
+    const elapsed = isRunning
+        ? Date.now() - subagent.startedAt
+        : subagent.completedAt !== undefined ? subagent.completedAt - subagent.startedAt : undefined;
     const info = statusGlyph(subagent.status);
     const totalTokens = subagent.tokens?.total ?? ((subagent.tokens?.input ?? 0) + (subagent.tokens?.output ?? 0) || 0);
     const pageIndex = PAGES.indexOf(page);
@@ -137,6 +142,6 @@ export function SubagentDetailScene({ subagent, onBack, onInterrupt, }) {
         const active = page === name;
         return (_jsxs(React.Fragment, { children: [_jsx(Box, { onClick: () => setPage(name), backgroundColor: !active ? 'userMessageBackgroundHover' : undefined, children: _jsx(Text, { color: active ? 'accent' : undefined, bold: active, inverse: active, children: ` ${label} ` }) }), _jsx(Text, { dimColor: true, children: name === PAGES[PAGES.length - 1] ? '' : '│' })] }, name));
     };
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsxs(Box, { flexDirection: "row", gap: 1, children: [_jsx(Text, { color: info.color, bold: true, children: info.glyph }), _jsx(Text, { bold: true, children: `${t('subagent-card-prefix')}${subagent.description}` }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { color: info.color, children: info.label }), _jsx(Box, { flexGrow: 1 }), _jsx(ExitButton, { onClick: onBack })] }), _jsxs(Text, { children: [_jsx(Text, { children: subagent.model ?? subagent.provider ?? 'default' }), _jsx(Text, { dimColor: true, children: ` · ${formatDuration(elapsed)} · ${totalTokens || '—'} tok · ${subagent.toolCalls.length} tools` })] }), _jsxs(Text, { dimColor: true, children: [`${t('subagent-started')} ${formatTimestamp(subagent.startedAt)}`
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsxs(Box, { flexDirection: "row", gap: 1, children: [_jsx(Text, { color: info.color, bold: true, children: info.glyph }), _jsx(Text, { bold: true, children: `${t('subagent-card-prefix')}${subagent.description}` }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { color: info.color, children: info.label }), _jsx(Box, { flexGrow: 1 }), _jsx(ExitButton, { onClick: onBack })] }), _jsxs(Text, { children: [_jsx(Text, { children: subagent.model ?? subagent.provider ?? 'default' }), _jsxs(Text, { dimColor: true, children: [elapsed !== undefined ? ` · ${formatDuration(elapsed)} · ` : ' · ', totalTokens || '—', " tok \u00B7 ", subagent.toolCalls.length, " tools"] })] }), _jsxs(Text, { dimColor: true, children: [`${t('subagent-started')} ${formatTimestamp(subagent.startedAt)}`
                         + (subagent.completedAt ? ` · ${t('subagent-completed')} ${formatTimestamp(subagent.completedAt)}` : ''), ` · id ${subagent.agentId}`] }), subagent.error && (_jsx(Box, { marginTop: 0, children: _jsx(Text, { color: "error", wrap: "wrap", children: `${t('subagent-error-label')}: ${subagent.error}` }) })), _jsxs(Box, { flexDirection: "row", gap: 0, marginTop: 1, children: [tab('summary', t('subagent-tab-summary')), tab('output', t('subagent-output-label')), tab('tools', t('subagent-tools')), _jsx(Text, { dimColor: true, children: `  ${pageIndex + 1}/${PAGES.length}` })] }), _jsx(Text, { dimColor: true, children: '─'.repeat(Math.max(20, Math.min(72, columns - 6))) }), _jsx(Box, { flexDirection: "column", paddingX: 1, maxHeight: Math.max(10, rows - 14), children: _jsxs(ScrollBox, { ref: scrollRef, flexDirection: "column", flexGrow: 1, children: [page === 'summary' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(StatGrid, { subagent: subagent, totalTokens: totalTokens, elapsed: elapsed, statusLabel: info.label, statusColor: info.color }), subagent.summary && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { dimColor: true, bold: true, children: '─ summary ' }), _jsx(Text, { wrap: "wrap", children: subagent.summary })] })), !subagent.summary && (_jsx(Text, { dimColor: true, children: isRunning ? t('subagent-no-output') : t('subagent-no-summary') }))] })), page === 'output' && (subagent.outputEvents.length === 0 && subagent.output.length === 0 ? (_jsx(Text, { dimColor: true, children: t('subagent-no-output') })) : (subagent.outputEvents.map((line, index) => (_jsxs(Text, { wrap: "wrap", dimColor: line.kind === 'thinking' || line.kind === 'system', color: line.kind === 'error' ? 'error' : undefined, children: [line.kind === 'thinking' ? '  ⌁ ' : '  ', line.text, !line.settled && isRunning ? ' ▍' : ''] }, index))))), page === 'tools' && (subagent.toolCalls.length === 0 ? (_jsx(Text, { dimColor: true, children: t('subagent-no-tools') })) : (subagent.toolCalls.map((tool, index) => (_jsxs(Box, { flexDirection: "column", marginTop: index === 0 ? 0 : 1, children: [_jsxs(Box, { flexDirection: "row", gap: 1, children: [_jsx(Text, { color: tool.status === 'failed' ? 'error' : tool.status === 'running' ? 'warning' : 'success', children: tool.status === 'running' ? '·' : tool.status === 'failed' ? '×' : '✓' }), _jsx(Text, { color: toolNameColor(tool.name), children: tool.name }), tool.endedAt && _jsx(Text, { dimColor: true, children: formatDuration(tool.endedAt - tool.startedAt) })] }), tool.argsPreview && (_jsx(Box, { flexDirection: "row", paddingLeft: 2, children: _jsx(JsonArgsText, { raw: tool.argsPreview }) })), tool.resultPreview && (_jsx(Box, { flexDirection: "row", paddingLeft: 2, children: _jsx(Text, { dimColor: true, wrap: "wrap", children: `⎿ ${tool.resultPreview}` }) })), tool.error && (_jsx(Box, { flexDirection: "row", paddingLeft: 2, children: _jsx(Text, { color: "error", wrap: "wrap", children: tool.error }) }))] }, tool.id ?? index)))))] }) }), _jsx(Divider, { color: "subtle", title: "" }), _jsxs(Box, { marginTop: 0, flexDirection: "row", children: [_jsx(Text, { dimColor: true, children: `←/→ ${t('subagent-hint-page')} · ↑/↓ ${t('subagent-hint-scroll')}` }), isRunning && onInterrupt && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: ' · ' }), _jsx(Box, { onClick: () => onInterrupt(subagent.agentId), children: _jsx(Text, { dimColor: true, bold: true, color: "warning", children: "X interrupt" }) })] })), _jsx(Text, { dimColor: true, children: ` · Esc ${t('subagent-hint-back')}` })] })] }));
 }

package/lib/types/components/TimelineRail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TimelineRail.d.ts","sourceRoot":"","sources":["../../../src/components/TimelineRail.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,UAAU,CAAA;AAEpE,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAA;AAwBhC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,aAAa,EACb,YAAY,EACZ,YAAY,GACb,EAAE;IACD,MAAM,EAAE,eAAe,GAAG,IAAI,CAAA;IAC9B,qEAAqE;IACrE,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;IAClC,gEAAgE;IAChE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB;sCACkC;IAClC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB;6DACyD;IACzD,YAAY,EAAE,OAAO,CAAA;IACrB;;;;;OAKG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACtC,GAAG,KAAK,CAAC,SAAS,CAuNlB"}
+{"version":3,"file":"TimelineRail.d.ts","sourceRoot":"","sources":["../../../src/components/TimelineRail.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,UAAU,CAAA;AAEpE,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAA;AAwBhC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,aAAa,EACb,YAAY,EACZ,YAAY,GACb,EAAE;IACD,MAAM,EAAE,eAAe,GAAG,IAAI,CAAA;IAC9B,qEAAqE;IACrE,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;IAClC,gEAAgE;IAChE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB;sCACkC;IAClC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB;6DACyD;IACzD,YAAY,EAAE,OAAO,CAAA;IACrB;;;;;OAKG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACtC,GAAG,KAAK,CAAC,SAAS,CA+NlB"}

package/lib/types/components/TimelineRail.js

@@ -177,7 +177,15 @@ export function TimelineRail({ handle, turns, activeId, upId, downId, terminalWi
                     const cardH = lines.length + 2;
                     if (cardH <= viewport) {
                         const top = Math.max(0, Math.min(tickRow - Math.floor(cardH / 2), viewport - cardH));
-                        card = (_jsx(Box, { position: "absolute", top: top, right: RAIL_WIDTH + 1, width: cardW, height: cardH, flexDirection: "column", flexShrink: 0, borderStyle: "round", borderColor: "inactive", paddingX: 1, 
+                        card = (_jsx(Box, { position: "absolute", top: top, right: RAIL_WIDTH + 1, width: cardW, height: cardH, flexDirection: "column", flexShrink: 0, borderStyle: "round", borderColor: "inactive", 
+                            // An opaque surface, like every other card floating over the
+                            // transcript (Tooltip's card uses the same token). Without it
+                            // the card is translucent: the rows underneath show through
+                            // the padding/border columns, so the transcript's own fills
+                            // leak out beside each preview line (reported from a real
+                            // session: one line leaked the message background, the next a
+                            // terminal-default gap).
+                            backgroundColor: "toolCardBackground", paddingX: 1, 
                             // The card floats LEFT of the rail over selectable
                             // transcript text; fence its own rect so a drag that
                             // happens under a dwell-popped preview never copies the

package/lib/types/components/Whale.d.ts

@@ -11,14 +11,23 @@ import { type WhaleLayerPose } from './whaleLayers.js';
  */
 type Rgb = readonly [number, number, number];
 /**
- * Render one frame to ANSI rows (one per sprite row pair) under its own
- * palette. Consecutive cells sharing one style are run-length encoded; every
- * row spans the full sprite width (transparent cells write plain spaces, so
- * the blank cells of a diff region are re-output and overwrite whatever the
- * previous frame painted there), and each row closes with an erase-to-EOL:
- * the text pipeline may trim trailing whitespace, and the erase guarantees
- * the terminal itself clears every cell past the row's last glyph — no
- * ghost pixels can survive a frame switch.
+ * Half-block row encoder for true-color letter-grid sprites (the pixel
+ * whale's frames): `pixel(x, y)` returns the color of sprite cell (x, y)
+ * or `undefined` for transparent.
+ *
+ * Render one sprite to ANSI rows (one per sprite row pair). Consecutive
+ * cells sharing one style are run-length encoded; every row spans the full
+ * sprite width (transparent cells write plain spaces, so the blank cells of
+ * a diff region are re-output and overwrite whatever the previous frame
+ * painted there), and each row closes with an erase-to-EOL: the text
+ * pipeline may trim trailing whitespace, and the erase guarantees the
+ * terminal itself clears every cell past the row's last glyph — no ghost
+ * pixels can survive a frame switch.
+ */
+export declare function renderCellRows(width: number, height: number, pixel: (x: number, y: number) => Rgb | undefined): string[];
+/**
+ * Render one letter-grid frame to ANSI rows under its own palette — the
+ * thin adapter over {@link renderCellRows} the whale frames use.
  */
 export declare function renderSpriteRows(sprite: readonly string[], palette: Record<string, Rgb | undefined>): string[];
 /** Render one composed pose (body + action layers) to ANSI rows, cached. */

package/lib/types/components/Whale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Whale.d.ts","sourceRoot":"","sources":["../../../src/components/Whale.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjF;;;;;;;;GAQG;AAEH,KAAK,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAoB5C;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,SAAS,CAAC,GAAG,MAAM,EAAE,CA2C9G;AAWD,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CAO/D;AAGD,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,EACvB,UAAiC,EACjC,IAAI,EACJ,KAAK,GACN,EAAE;IACD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG,KAAK,CAAC,SAAS,CAWlB"}
+{"version":3,"file":"Whale.d.ts","sourceRoot":"","sources":["../../../src/components/Whale.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjF;;;;;;;;GAQG;AAEH,KAAK,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAoB5C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,GAAG,GAAG,SAAS,GAC/C,MAAM,EAAE,CAyCV;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,SAAS,CAAC,GAAG,MAAM,EAAE,CAG9G;AAWD,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CAO/D;AAGD,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,EACvB,UAAiC,EACjC,IAAI,EACJ,KAAK,GACN,EAAE;IACD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG,KAAK,CAAC,SAAS,CAWlB"}

package/lib/types/components/Whale.js

@@ -19,25 +19,27 @@ const ERASE_TO_EOL = '\x1b[K';
 /** Reset the background plane to the terminal default (fg keeps its SGR). */
 const BG_DEFAULT = '\x1b[49m';
 /**
- * Render one frame to ANSI rows (one per sprite row pair) under its own
- * palette. Consecutive cells sharing one style are run-length encoded; every
- * row spans the full sprite width (transparent cells write plain spaces, so
- * the blank cells of a diff region are re-output and overwrite whatever the
- * previous frame painted there), and each row closes with an erase-to-EOL:
- * the text pipeline may trim trailing whitespace, and the erase guarantees
- * the terminal itself clears every cell past the row's last glyph — no
- * ghost pixels can survive a frame switch.
+ * Half-block row encoder for true-color letter-grid sprites (the pixel
+ * whale's frames): `pixel(x, y)` returns the color of sprite cell (x, y)
+ * or `undefined` for transparent.
+ *
+ * Render one sprite to ANSI rows (one per sprite row pair). Consecutive
+ * cells sharing one style are run-length encoded; every row spans the full
+ * sprite width (transparent cells write plain spaces, so the blank cells of
+ * a diff region are re-output and overwrite whatever the previous frame
+ * painted there), and each row closes with an erase-to-EOL: the text
+ * pipeline may trim trailing whitespace, and the erase guarantees the
+ * terminal itself clears every cell past the row's last glyph — no ghost
+ * pixels can survive a frame switch.
  */
-export function renderSpriteRows(sprite, palette) {
+export function renderCellRows(width, height, pixel) {
     const rows = [];
-    for (let r = 0; r < sprite.length; r += 2) {
-        const upper = sprite[r];
-        const lower = sprite[r + 1] ?? '';
+    for (let y = 0; y < height; y += 2) {
         let out = '';
         let current = '';
-        for (let x = 0; x < upper.length; x++) {
-            const up = palette[upper[x]];
-            const lo = palette[lower[x]];
+        for (let x = 0; x < width; x++) {
+            const up = pixel(x, y);
+            const lo = pixel(x, y + 1);
             let seq;
             let ch;
             if (up !== undefined && lo !== undefined) {
@@ -76,6 +78,14 @@ export function renderSpriteRows(sprite, palette) {
     }
     return rows;
 }
+/**
+ * Render one letter-grid frame to ANSI rows under its own palette — the
+ * thin adapter over {@link renderCellRows} the whale frames use.
+ */
+export function renderSpriteRows(sprite, palette) {
+    const width = sprite.reduce((max, row) => Math.max(max, row.length), 0);
+    return renderCellRows(width, sprite.length, (x, y) => palette[sprite[y]?.[x] ?? '']);
+}
 /** Pre-rendered ANSI rows for every whale frame, computed once at module load. */
 const RENDERED = WHALE_FRAMES.map(frame => renderSpriteRows(frame.rows, PALETTE));
 /**

package/lib/types/components/WhaleGirl.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+/**
+ * The maid portrait (鲸鱼娘) that can stand in for the header's pixel whale
+ * (settings `dsh-tui.whaleGirl`): the author-designed 30×30 true-color
+ * sprite in `whaleGirlSprite.ts`, rendered with the same half-block
+ * technique as the whale — one `▀`/`▄` cell packs two sprite rows, so the
+ * portrait shows at 30 columns × 15 rows. A static portrait by design: the
+ * whale's idle planner and click-hearts stay whale-only, so `dsh-tui.whaleIdle`
+ * has nothing to animate here (documented with the setting).
+ */
+/** Pre-rendered ANSI rows, computed once at module load. */
+export declare const WHALE_GIRL_ROWS: readonly string[];
+/**
+ * The portrait's center column when it fills the whale's 40-column box
+ * (indented (40−30)/2 = 5, so the art spans columns 5..34 → center 19.5).
+ * The welcome tagline centers on this instead of `WHALE_CENTER` in maid
+ * mode, keeping the caption under the art it belongs to.
+ */
+export declare const WHALE_GIRL_CENTER = 19.5;
+/**
+ * The maid portrait as an Ink component: 15 rows × 30 columns. `width` pins
+ * the box (the header passes the whale's 40-column box so the neighbouring
+ * text column never shifts) and centers the portrait inside it; without it
+ * the component is exactly the portrait's own 30 columns (the star modal).
+ */
+export declare function WhaleGirlArt({ width }: {
+    width?: number;
+}): React.ReactNode;
+//# sourceMappingURL=WhaleGirl.d.ts.map

package/lib/types/components/WhaleGirl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WhaleGirl.d.ts","sourceRoot":"","sources":["../../../src/components/WhaleGirl.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB;;;;;;;;GAQG;AAEH,4DAA4D;AAC5D,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAI5C,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAA;AAErC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,SAAS,CAW3E"}

package/lib/types/components/WhaleGirl.js

@@ -0,0 +1,32 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from '../ui.js';
+import { renderCellRows } from './Whale.js';
+import { WHALE_GIRL_COLS, WHALE_GIRL_SPRITE, WHALE_GIRL_SPRITE_ROWS } from './whaleGirlSprite.js';
+/**
+ * The maid portrait (鲸鱼娘) that can stand in for the header's pixel whale
+ * (settings `dsh-tui.whaleGirl`): the author-designed 30×30 true-color
+ * sprite in `whaleGirlSprite.ts`, rendered with the same half-block
+ * technique as the whale — one `▀`/`▄` cell packs two sprite rows, so the
+ * portrait shows at 30 columns × 15 rows. A static portrait by design: the
+ * whale's idle planner and click-hearts stay whale-only, so `dsh-tui.whaleIdle`
+ * has nothing to animate here (documented with the setting).
+ */
+/** Pre-rendered ANSI rows, computed once at module load. */
+export const WHALE_GIRL_ROWS = renderCellRows(WHALE_GIRL_COLS, WHALE_GIRL_SPRITE_ROWS, (x, y) => WHALE_GIRL_SPRITE[y]?.[x] ?? undefined);
+/**
+ * The portrait's center column when it fills the whale's 40-column box
+ * (indented (40−30)/2 = 5, so the art spans columns 5..34 → center 19.5).
+ * The welcome tagline centers on this instead of `WHALE_CENTER` in maid
+ * mode, keeping the caption under the art it belongs to.
+ */
+export const WHALE_GIRL_CENTER = 19.5;
+/**
+ * The maid portrait as an Ink component: 15 rows × 30 columns. `width` pins
+ * the box (the header passes the whale's 40-column box so the neighbouring
+ * text column never shifts) and centers the portrait inside it; without it
+ * the component is exactly the portrait's own 30 columns (the star modal).
+ */
+export function WhaleGirlArt({ width }) {
+    const pad = width === undefined ? 0 : Math.max(0, Math.floor((width - WHALE_GIRL_COLS) / 2));
+    return (_jsx(Box, { flexDirection: "column", flexShrink: 0, width: width, children: WHALE_GIRL_ROWS.map((row, index) => (_jsxs(Text, { wrap: "truncate-end", children: [pad > 0 ? ' '.repeat(pad) : '', row] }, index))) }));
+}

package/lib/types/components/WorkingSpinner.d.ts

@@ -7,7 +7,7 @@ import type { SpinnerMode } from './Spinner/spinnerMode.js';
  *
  * Random verb is picked once per turn (per mount of the spinner).
  */
-export declare function WorkingSpinner({ mode, hasActiveTools, responseLengthRef, uploadTokensRef, loadingStartTimeRef, totalPausedMsRef, pauseStartTimeRef, thinkingStatus, }: {
+export declare function WorkingSpinner({ mode, hasActiveTools, responseLengthRef, uploadTokensRef, loadingStartTimeRef, totalPausedMsRef, pauseStartTimeRef, thinkingStatus, suffix, }: {
     mode: SpinnerMode;
     hasActiveTools: boolean;
     responseLengthRef: React.RefObject<number>;
@@ -17,6 +17,9 @@ export declare function WorkingSpinner({ mode, hasActiveTools, responseLengthRef
     totalPausedMsRef: React.RefObject<number>;
     pauseStartTimeRef: React.RefObject<number | null>;
     thinkingStatus: 'thinking' | number | null;
+    /** Extra leading field (e.g. the auto-compaction badge) shown before the
+     *  timer/token counters; omitted for an ordinary turn. */
+    suffix?: string;
 }): React.ReactNode;
 /**
  * Tracks thinking status: 'thinking' while the model is streaming reasoning,

package/lib/types/components/WorkingSpinner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkingSpinner.d.ts","sourceRoot":"","sources":["../../../src/components/WorkingSpinner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAG1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAM3D;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,GACf,EAAE;IACD,IAAI,EAAE,WAAW,CAAA;IACjB,cAAc,EAAE,OAAO,CAAA;IACvB,iBAAiB,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAC1C,+EAA+E;IAC/E,eAAe,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACxC,mBAAmB,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAC5C,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACzC,iBAAiB,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACjD,cAAc,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAAA;CAC3C,GAAG,KAAK,CAAC,SAAS,CA4BlB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,OAAO,GAClB,UAAU,GAAG,MAAM,GAAG,IAAI,CA6C5B"}
+{"version":3,"file":"WorkingSpinner.d.ts","sourceRoot":"","sources":["../../../src/components/WorkingSpinner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAG1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAM3D;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,MAAM,GACP,EAAE;IACD,IAAI,EAAE,WAAW,CAAA;IACjB,cAAc,EAAE,OAAO,CAAA;IACvB,iBAAiB,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAC1C,+EAA+E;IAC/E,eAAe,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACxC,mBAAmB,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAC5C,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACzC,iBAAiB,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACjD,cAAc,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAAA;IAC1C;8DAC0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,GAAG,KAAK,CAAC,SAAS,CA4BlB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,OAAO,GAClB,UAAU,GAAG,MAAM,GAAG,IAAI,CA6C5B"}

package/lib/types/components/WorkingSpinner.js

@@ -13,12 +13,12 @@ import { sample } from 'lodash-es';
  *
  * Random verb is picked once per turn (per mount of the spinner).
  */
-export function WorkingSpinner({ mode, hasActiveTools, responseLengthRef, uploadTokensRef, loadingStartTimeRef, totalPausedMsRef, pauseStartTimeRef, thinkingStatus, }) {
+export function WorkingSpinner({ mode, hasActiveTools, responseLengthRef, uploadTokensRef, loadingStartTimeRef, totalPausedMsRef, pauseStartTimeRef, thinkingStatus, suffix, }) {
     const { columns } = useTerminalSize();
     // Pick a random verb once per spinner mount (per turn).
     const [randomVerb] = useState(() => sample(SPINNER_VERBS) ?? 'Working');
     const message = `${tOr(`spinner-verb-${randomVerb.toLowerCase()}`, randomVerb)}…`;
-    return (_jsx(Box, { flexDirection: "column", width: "100%", alignItems: "flex-start", children: _jsx(SpinnerAnimationRow, { mode: mode, reducedMotion: false, hasActiveTools: hasActiveTools, responseLengthRef: responseLengthRef, uploadTokensRef: uploadTokensRef, message: message, messageColor: "accent", shimmerColor: "accentShimmer", loadingStartTimeRef: loadingStartTimeRef, totalPausedMsRef: totalPausedMsRef, pauseStartTimeRef: pauseStartTimeRef, spinnerSuffix: null, verbose: true, columns: columns, thinkingStatus: thinkingStatus }) }));
+    return (_jsx(Box, { flexDirection: "column", width: "100%", alignItems: "flex-start", children: _jsx(SpinnerAnimationRow, { mode: mode, reducedMotion: false, hasActiveTools: hasActiveTools, responseLengthRef: responseLengthRef, uploadTokensRef: uploadTokensRef, message: message, messageColor: "accent", shimmerColor: "accentShimmer", loadingStartTimeRef: loadingStartTimeRef, totalPausedMsRef: totalPausedMsRef, pauseStartTimeRef: pauseStartTimeRef, spinnerSuffix: suffix === undefined ? null : suffix, verbose: true, columns: columns, thinkingStatus: thinkingStatus }) }));
 }
 /**
  * Tracks thinking status: 'thinking' while the model is streaming reasoning,

package/lib/types/components/bigfont.d.ts

@@ -1,28 +1,57 @@
+import type { SplashFont } from './splashFonts.js';
 /**
- * A 5-row block font for the header tagline, painted with a horizontal
- * color gradient plus a moving highlight window (the same sweep cadence as
- * the wordmark shimmer — see the `stepMs` parameter). Glyphs are 5 columns wide so curves
- * and diagonals stay legible; only the letters the tagline needs are
- * defined, and unknown characters fall back to a hollow box so a typo
- * fails visibly instead of crashing the splash.
+ * 5 行点阵大字的画布：横向颜色渐变 + 一道从左往右扫的高光（节奏与 `✦ dsh-TUI`
+ * 字标的扫光一致，见 `stepMs`）。字形与度量来自 `splashFonts.ts` 的字体描述符，
+ * 这里只负责"把某款字体画出来"——所以加字体是加数据，不是改画布。
+ *
+ * 缺字走字体自带的 `fallback` 空心方块：打错字要看得见，而不是让开屏崩掉。
  */
+/** 颜色通道。 */
 export interface Rgb {
     r: number;
     g: number;
     b: number;
 }
 /**
- * Render `text` in the 5-row block font. The gradient runs `from` → `to`
- * across the full line width; a SWEEP_WINDOW-wide highlight mixed toward
- * `flash` travels left to right (one column per `stepMs`, matching the
- * wordmark shimmer's cadence). Returns 5 ANSI rows.
- * @param text - Text to render; only D, E, P, S, K, H, A, R, N have glyphs, unknown letters fall back to a hollow box.
- * @param time - Elapsed time in milliseconds; drives the sweep position and the brightness pulse.
- * @param from - Gradient start color at the left edge.
- * @param to - Gradient end color at the right edge.
- * @param flash - Highlight color mixed into the moving sweep window.
- * @param stepMs - Milliseconds per column of sweep advance (default 60).
- * @returns Five ANSI rows, one per block-font line.
+ * 画字量宽只需要字身宽度——`SplashFont` 天然满足，`splashFonts.ts` 解字距时
+ * 手里只有宽度，也能直接复用同一套算术。
  */
-export declare function renderBigText(text: string, time: number, from: Rgb, to: Rgb, flash: Rgb, stepMs?: number): string[];
+export interface GlyphMetrics {
+    /** 字身宽度（列）。 */
+    readonly glyphWidth: number;
+}
+/**
+ * `text` 在该字身宽度、该字距下画出来的列数（含末尾那格字距留白）——与渲染循环
+ * 用同一套算术，放在这里以免两处漂移（`splashFonts.ts` 解字距时也读它）。
+ * @param font - 字体度量（只用到字身宽度）。
+ * @param text - 要量的文本。
+ * @param kerning - 每个字形之后补的空列数。
+ * @returns 画出来的列数。
+ */
+export declare function paintedWidth(font: GlyphMetrics, text: string, kerning: number): number;
+/**
+ * `text` 的显示宽度：含字距、**不含**最后一个字形之后的留白。开屏用它判断
+ * 某个词还放不放得下（配合鲸鱼），`verify-splash-layout` 会把它与实际画出的
+ * 列数对齐钉死。
+ * @param font - 字体度量（只用到字身宽度）。
+ * @param text - 要量的文本（只有字体表里定义的字母有字形）。
+ * @param kerning - 每个字形之后的空列数（默认 1）。
+ * @returns 显示宽度（终端列）。
+ */
+export declare function bigTextWidth(font: GlyphMetrics, text: string, kerning?: number): number;
+/**
+ * 用某款字体渲染 `text`：渐变从 `from` 走到 `to`，一段 SWEEP_WINDOW 宽的高光
+ * 混向 `flash` 并随时间从左扫到右。返回 5 行 ANSI。
+ * @param font - 字体描述符（字形 + 字身宽度 + fallback）。
+ * @param text - 要渲染的文本；缺字的字母退化成 fallback 方块。
+ * @param time - 毫秒；决定扫光位置与脉动亮度（定格时传 0）。
+ * @param from - 渐变起点色（最左列）。
+ * @param to - 渐变终点色（最右列）。
+ * @param flash - 扫光窗口混入的高光色。
+ * @param stepMs - 扫光每前进一列的毫秒数（默认 60）。
+ * @param kerning - 每个字形之后的空列数（默认 1）。两行标题靠它撑到等宽。
+ * @param indent - 每行左侧缩进列数（下排居中用，默认 0）。
+ * @returns 5 行 ANSI，每行是点阵字的一行。
+ */
+export declare function renderBigText(font: SplashFont, text: string, time: number, from: Rgb, to: Rgb, flash: Rgb, stepMs?: number, kerning?: number, indent?: number): string[];
 //# sourceMappingURL=bigfont.d.ts.map

package/lib/types/components/bigfont.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bigfont.d.ts","sourceRoot":"","sources":["../../../src/components/bigfont.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAiCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EACT,EAAE,EAAE,GAAG,EACP,KAAK,EAAE,GAAG,EACV,MAAM,SAAK,GACV,MAAM,EAAE,CA+CV"}
+{"version":3,"file":"bigfont.d.ts","sourceRoot":"","sources":["../../../src/components/bigfont.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD;;;;;;GAMG;AAEH,YAAY;AACZ,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe;IACf,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAYD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAItF;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,MAAM,CAKlF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EACT,EAAE,EAAE,GAAG,EACP,KAAK,EAAE,GAAG,EACV,MAAM,SAAK,EACX,OAAO,SAAI,EACX,MAAM,SAAI,GACT,MAAM,EAAE,CAgDV"}

package/lib/types/components/bigfont.js

@@ -1,51 +1,63 @@
 import { interpolateColor } from './Spinner/spinnerUtils.js';
-/** Glyph rows are 5 columns wide; `·` is a transparent cell. */
-const GLYPHS = {
-    D: ['█▀▀▀▄', '█···█', '█···█', '█···█', '█▄▄▄▀'],
-    E: ['█▀▀▀▀', '█····', '█▀▀▀·', '█····', '█▄▄▄▄'],
-    P: ['█▀▀▀▄', '█···█', '█▄▄▄▀', '█····', '█····'],
-    S: ['█▀▀▀▀', '█····', '·▀▀▀▄', '····█', '█▄▄▄▀'],
-    K: ['█···█', '█·█··', '██···', '█·█··', '█···█'],
-    H: ['█···█', '█···█', '█▀▀▀█', '█···█', '█···█'],
-    A: ['·▄▀▄·', '█···█', '█▀▀▀█', '█···█', '█···█'],
-    R: ['█▀▀▀▄', '█···█', '█▄▄▄▀', '█·█··', '█···█'],
-    N: ['█···█', '██··█', '█·█·█', '█··██', '█···█'],
-};
-const FALLBACK = [
-    '▄▄▄▄▄',
-    '█···█',
-    '█···█',
-    '█···█',
-    '▀▀▀▀▀',
-];
-/** Per-glyph advance (5 glyph columns + 1 kerning column). */
-const ADVANCE = 6;
-/** Space between words. */
+/** 词组之间的间隔列数。 */
 const WORD_GAP = 2;
-/** Sweep highlight window width, in terminal columns. */
+/** 扫光窗口宽度（列）。 */
 const SWEEP_WINDOW = 8;
+/** 一行字画几行。 */
+const ROWS = 5;
 const esc = (rgb) => `\x1b[38;2;${rgb.r};${rgb.g};${rgb.b}m`;
 const RESET = '\x1b[39m';
 /**
- * Render `text` in the 5-row block font. The gradient runs `from` → `to`
- * across the full line width; a SWEEP_WINDOW-wide highlight mixed toward
- * `flash` travels left to right (one column per `stepMs`, matching the
- * wordmark shimmer's cadence). Returns 5 ANSI rows.
- * @param text - Text to render; only D, E, P, S, K, H, A, R, N have glyphs, unknown letters fall back to a hollow box.
- * @param time - Elapsed time in milliseconds; drives the sweep position and the brightness pulse.
- * @param from - Gradient start color at the left edge.
- * @param to - Gradient end color at the right edge.
- * @param flash - Highlight color mixed into the moving sweep window.
- * @param stepMs - Milliseconds per column of sweep advance (default 60).
- * @returns Five ANSI rows, one per block-font line.
+ * `text` 在该字身宽度、该字距下画出来的列数（含末尾那格字距留白）——与渲染循环
+ * 用同一套算术，放在这里以免两处漂移（`splashFonts.ts` 解字距时也读它）。
+ * @param font - 字体度量（只用到字身宽度）。
+ * @param text - 要量的文本。
+ * @param kerning - 每个字形之后补的空列数。
+ * @returns 画出来的列数。
  */
-export function renderBigText(text, time, from, to, flash, stepMs = 60) {
-    const width = text.length * ADVANCE + (text.includes(' ') ? WORD_GAP - 1 : 0);
+export function paintedWidth(font, text, kerning) {
+    let width = 0;
+    for (const ch of text)
+        width += ch === ' ' ? WORD_GAP : font.glyphWidth + kerning;
+    return width;
+}
+/**
+ * `text` 的显示宽度：含字距、**不含**最后一个字形之后的留白。开屏用它判断
+ * 某个词还放不放得下（配合鲸鱼），`verify-splash-layout` 会把它与实际画出的
+ * 列数对齐钉死。
+ * @param font - 字体度量（只用到字身宽度）。
+ * @param text - 要量的文本（只有字体表里定义的字母有字形）。
+ * @param kerning - 每个字形之后的空列数（默认 1）。
+ * @returns 显示宽度（终端列）。
+ */
+export function bigTextWidth(font, text, kerning = 1) {
+    const characters = Array.from(text);
+    if (characters.length === 0)
+        return 0;
+    const trailing = characters[characters.length - 1] === ' ' ? WORD_GAP : kerning;
+    return paintedWidth(font, text, kerning) - trailing;
+}
+/**
+ * 用某款字体渲染 `text`：渐变从 `from` 走到 `to`，一段 SWEEP_WINDOW 宽的高光
+ * 混向 `flash` 并随时间从左扫到右。返回 5 行 ANSI。
+ * @param font - 字体描述符（字形 + 字身宽度 + fallback）。
+ * @param text - 要渲染的文本；缺字的字母退化成 fallback 方块。
+ * @param time - 毫秒；决定扫光位置与脉动亮度（定格时传 0）。
+ * @param from - 渐变起点色（最左列）。
+ * @param to - 渐变终点色（最右列）。
+ * @param flash - 扫光窗口混入的高光色。
+ * @param stepMs - 扫光每前进一列的毫秒数（默认 60）。
+ * @param kerning - 每个字形之后的空列数（默认 1）。两行标题靠它撑到等宽。
+ * @param indent - 每行左侧缩进列数（下排居中用，默认 0）。
+ * @returns 5 行 ANSI，每行是点阵字的一行。
+ */
+export function renderBigText(font, text, time, from, to, flash, stepMs = 60, kerning = 1, indent = 0) {
+    const width = paintedWidth(font, text, kerning) + indent;
     const cycle = width + SWEEP_WINDOW * 2;
     const sweepStart = (Math.floor(time / stepMs) % cycle) - SWEEP_WINDOW;
     const pulse = (Math.sin(time / (stepMs * 2)) + 1) / 2;
     const rows = [];
-    for (let row = 0; row < 5; row++) {
+    for (let row = 0; row < ROWS; row++) {
         let out = '';
         let current = '';
         let x = 0;
@@ -72,16 +84,19 @@ export function renderBigText(text, time, from, to, flash, stepMs = 60) {
             out += ch;
             x += 1;
         };
+        for (let i = 0; i < indent; i++)
+            emit(' ');
         for (const ch of text) {
             if (ch === ' ') {
                 for (let i = 0; i < WORD_GAP; i++)
                     emit(' ');
                 continue;
             }
-            const glyph = GLYPHS[ch] ?? FALLBACK;
-            for (const cell of glyph[row])
+            const glyph = font.glyphs[ch] ?? font.fallback;
+            for (const cell of glyph[row] ?? '')
                 emit(cell);
-            emit(' ');
+            for (let i = 0; i < kerning; i++)
+                emit(' ');
         }
         if (current !== '')
             out += RESET;

package/lib/types/components/design-system/HintLine.d.ts

@@ -2,8 +2,7 @@ import React from 'react';
 /**
  * Localized shortcut-hint line: renders a `t('hint-*')` string, with the
  * `**primary shortcut**` segment (the main action's key, wrapped in `**` in
- * the dict) in bold — the visual hierarchy KeyboardShortcutHint's `bold`
- * prop used to give. Wrap in `<Text dimColor italic>` for the common dim
+ * the dict) in bold. Wrap in `<Text dimColor italic>` for the common dim
  * styling, like the Byline it replaces.
  */
 export declare function HintLine({ text }: {

package/lib/types/components/design-system/HintLine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HintLine.d.ts","sourceRoot":"","sources":["../../../../src/components/design-system/HintLine.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,SAAS,CAUpE"}
+{"version":3,"file":"HintLine.d.ts","sourceRoot":"","sources":["../../../../src/components/design-system/HintLine.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,SAAS,CAUpE"}

package/lib/types/components/design-system/HintLine.js

@@ -3,8 +3,7 @@ import Text from './ThemedText.js';
 /**
  * Localized shortcut-hint line: renders a `t('hint-*')` string, with the
  * `**primary shortcut**` segment (the main action's key, wrapped in `**` in
- * the dict) in bold — the visual hierarchy KeyboardShortcutHint's `bold`
- * prop used to give. Wrap in `<Text dimColor italic>` for the common dim
+ * the dict) in bold. Wrap in `<Text dimColor italic>` for the common dim
  * styling, like the Byline it replaces.
  */
 export function HintLine({ text }) {

package/lib/types/components/design-system/ThemeProvider.d.ts

@@ -18,4 +18,10 @@ export declare function ThemeProvider({ children, theme, themeHost, }: {
  * `[themeName, setTheme]`.
  */
 export declare function useTheme(): [string, (name: string) => boolean];
+/**
+ * The colour the terminal shows behind the UI (`#rrggbb`): the OSC 11
+ * answer when available, else white/black by palette lightness. Terminal
+ * image placements use it as their opaque Sixel backing.
+ */
+export declare function useTerminalBackground(): `#${string}`;
 //# sourceMappingURL=ThemeProvider.d.ts.map

package/lib/types/components/design-system/ThemeProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../../../src/components/design-system/ThemeProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyD,MAAM,OAAO,CAAA;AAY7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAiE/D;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAGrD;AAcD,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,KAAK,EACL,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qEAAqE;IACrE,SAAS,CAAC,EAAE,YAAY,CAAA;CACzB,GAAG,KAAK,CAAC,SAAS,CAmMlB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAG9D"}
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../../../src/components/design-system/ThemeProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyD,MAAM,OAAO,CAAA;AAY7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AA2E/D;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAGrD;AAcD,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,KAAK,EACL,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qEAAqE;IACrE,SAAS,CAAC,EAAE,YAAY,CAAA;CACzB,GAAG,KAAK,CAAC,SAAS,CA6MlB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAG9D;AA2BD;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,MAAM,EAAE,CAEpD"}