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

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/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"}

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

@@ -46,6 +46,7 @@ const ThemeContext = createContext({
     theme: 'dark',
     autoBase: 'dark',
     setTheme: () => false,
+    terminalBackground: '#000000',
 });
 /**
  * DSH_TUI_THEME skips terminal detection (tests, debugging). Accepts a
@@ -225,7 +226,17 @@ export function ThemeProvider({ children, theme, themeHost, }) {
         : isThemeAvailable(active)
             ? active
             : AUTO_THEME_NAME;
-    const value = React.useMemo(() => ({ theme: renderedTheme, autoBase, setTheme }), [renderedTheme, autoBase, setTheme]);
+    const value = React.useMemo(() => ({
+        theme: renderedTheme,
+        autoBase,
+        setTheme,
+        // 与下面 setShadeTarget 用同一个口径（OSC 11 的回答，缺失时按明暗取
+        // 白/黑）——terminal 图像的不透明衬底就合成到这个颜色上。
+        // 只在与主题明暗**一致**时才采信 OSC 11 的回答：透明背景/背景图形态
+        // 的终端会报一个跟画面对不上的颜色，那时宁可用纯白（浅色主题）或
+        // 纯黑（深色主题）——深色终端上糊一块白底最突兀。
+        terminalBackground: hexRgb(imageBackingColor(detectedBackground, renderedTheme)),
+    }), [renderedTheme, autoBase, setTheme, detectedBackground]);
     useEffect(() => {
         if (active !== null)
             setActiveThemeName(renderedTheme);
@@ -254,3 +265,31 @@ export function useTheme() {
     const { theme, setTheme } = useContext(ThemeContext);
     return [theme, setTheme];
 }
+/** `{r,g,b}` → `#rrggbb` for colour strings the style layer accepts. */
+function hexRgb(color) {
+    const part = (value) => Math.max(0, Math.min(255, Math.round(value))).toString(16).padStart(2, '0');
+    return `#${part(color.r)}${part(color.g)}${part(color.b)}`;
+}
+/**
+ * The opaque colour terminal images composite onto: the OSC 11 answer while
+ * it agrees with the rendered palette's lightness, else pure white (light
+ * palette) / pure black (dark palette). A light terminal must never get a
+ * dark slab, and a dark terminal must never get a white one.
+ */
+function imageBackingColor(detected, themeName) {
+    const light = isLightThemeActive(themeName);
+    const fallback = light ? { r: 255, g: 255, b: 255 } : { r: 0, g: 0, b: 0 };
+    if (detected === null)
+        return fallback;
+    // Rec. 601 luma: > 0.5 counts as a light background.
+    const luma = (0.299 * detected.r + 0.587 * detected.g + 0.114 * detected.b) / 255;
+    return (luma > 0.5) === light ? detected : fallback;
+}
+/**
+ * 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 function useTerminalBackground() {
+    return useContext(ThemeContext).terminalBackground;
+}

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

@@ -0,0 +1,44 @@
+import React from 'react';
+import type { TerminalImageSource } from '../ink/terminal-image.js';
+/** 一台机器上的两张立绘都解好、并补齐到**同一像素画布**上——几何完全一致，
+ *  换图时宿主是「擦旧 + 画新」一次写入，不会留残影。 */
+export interface MaidPortraits {
+    readonly normal: TerminalImageSource;
+    readonly happy: TerminalImageSource;
+}
+/**
+ * 解码两张立绘一次（进程内缓存；失败缓存成 `undefined`，坏安装不会每次
+ * 渲染都重试）。两张都裁掉透明边后**居中补到同一张透明画布**（取两者
+ * 较大的宽高）——所以它们的像素尺寸与单元格盒完全一致。
+ * @returns 两张 RGBA 源；任一张缺失/解码失败时整体 `undefined`。
+ */
+export declare function loadMaidPortraits(): Promise<MaidPortraits | undefined>;
+/**
+ * 两张立绘，终端图像能力确认后解码（一次把两张都备好，点击换图不等待）。
+ * @param enabled - `useTerminalImages()` 的结果；为假时根本不解码。
+ * @returns 两张 RGBA 源；未就绪/不可用时为 `undefined`。
+ */
+export declare function useMaidPortraits(enabled: boolean): MaidPortraits | undefined;
+/**
+ * The portrait's center column inside the whale's 40-column slot: the
+ * aspect-fit image spans columns 5..34 (center 19.5). The welcome tagline
+ * centers on this instead of `WHALE_CENTER` while the portrait shows.
+ */
+export declare const MAID_BOX_CENTER = 19.5;
+/**
+ * The portrait as an Ink component: a `width × height` cell box (aspect-fit
+ * from the real cell metrics so pixels stay square), centered horizontally
+ * by the caller's slot. `presentation` follows the surface — `'transcript'`
+ * opts into Sixel for the scrollable header, `'preview'` for modal cards —
+ * and the portrait always floats `transparent`: her trimmed silhouette sits
+ * on whatever the terminal shows, with no backing rectangle behind it.
+ */
+export declare function MaidPortrait({ source, maxColumns, maxRows, presentation, }: {
+    /** Decoded RGBA snapshot; `undefined` keeps the caller's fallback. */
+    readonly source?: TerminalImageSource;
+    /** Cell budget (the header passes the whale's 40-column slot). */
+    readonly maxColumns: number;
+    readonly maxRows: number;
+    readonly presentation: 'transcript' | 'preview';
+}): React.ReactNode;
+//# sourceMappingURL=maidPortrait.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"maidPortrait.d.ts","sourceRoot":"","sources":["../../../src/components/maidPortrait.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAuBnE;iCACiC;AACjC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;CACpC;AASD;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CA+BtE;AAsDD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAW5E;AAKD;;;;GAIG;AACH,eAAO,MAAM,eAAe,OAAO,CAAA;AAEnC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,UAAU,EACV,OAAO,EACP,YAAY,GACb,EAAE;IACD,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAA;IACrC,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,YAAY,EAAE,YAAY,GAAG,SAAS,CAAA;CAChD,GAAG,KAAK,CAAC,SAAS,CAuBlB"}

package/lib/types/components/maidPortrait.js

@@ -0,0 +1,178 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import { Image, useTerminalImageCellSize } from '../ui.js';
+import { existsSync, readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { DEFAULT_TERMINAL_CELL_SIZE } from '../ink/terminal-image.js';
+import { loadSharp } from '../dsh-adapter/sharp.js';
+/**
+ * The maid portrait (鲸鱼娘) for `dsh-tui.whaleGirl` and the star modal —
+ * the author-designed 464×464 pixel art shipped at `assets/whale-girl/`,
+ * rendered FIRST as a real raster through the terminal image protocols
+ * (Kitty graphics / Sixel): full fidelity, anti-aliased curves, the whole
+ * palette. The chain degrades per surface when images cannot show — the
+ * header falls back to the character-art maid (`WhaleGirl.tsx`, the
+ * author's placeholder), the star modal to the animated pixel whale — so
+ * the setting never leaves the header worse than the whale it replaces.
+ */
+/** 两张立绘：`normal` 是安静版，`happy` 是「高兴鲸娘」（点击她 / star 成功
+ *  时替换）。资产候选同时覆盖两种目录深度：`lib/types/components`（发布形态）
+ *  比 `src/components`（仓库形态）深一层。 */
+const ASSET_FILES = {
+    normal: 'whale-girl.png',
+    happy: 'whale-girl-happy.png',
+};
+const assetPath = (file) => [`../../../assets/whale-girl/${file}`, `../../assets/whale-girl/${file}`]
+    .map(relative => fileURLToPath(new URL(relative, import.meta.url)))
+    .find(candidate => existsSync(candidate));
+let loadOnce;
+/**
+ * 解码两张立绘一次（进程内缓存；失败缓存成 `undefined`，坏安装不会每次
+ * 渲染都重试）。两张都裁掉透明边后**居中补到同一张透明画布**（取两者
+ * 较大的宽高）——所以它们的像素尺寸与单元格盒完全一致。
+ * @returns 两张 RGBA 源；任一张缺失/解码失败时整体 `undefined`。
+ */
+export function loadMaidPortraits() {
+    loadOnce ??= (async () => {
+        try {
+            const sharp = await loadSharp();
+            if (sharp === undefined)
+                return undefined;
+            const trimmed = { normal: undefined, happy: undefined };
+            for (const variant of ['normal', 'happy']) {
+                const path = assetPath(ASSET_FILES[variant]);
+                if (path === undefined)
+                    return undefined;
+                const decoded = await sharp(readFileSync(path), { failOn: 'error' })
+                    .toColourspace('srgb')
+                    .ensureAlpha()
+                    .raw()
+                    .toBuffer({ resolveWithObject: true });
+                if (decoded.info.channels !== 4
+                    || decoded.data.byteLength !== decoded.info.width * decoded.info.height * 4)
+                    return undefined;
+                const rgba = {
+                    data: new Uint8Array(decoded.data.buffer, decoded.data.byteOffset, decoded.data.byteLength),
+                    width: decoded.info.width,
+                    height: decoded.info.height,
+                };
+                trimmed[variant] = trimTransparent(rgba);
+            }
+            const width = Math.max(trimmed.normal.width, trimmed.happy.width);
+            const height = Math.max(trimmed.normal.height, trimmed.happy.height);
+            return { normal: centerOnCanvas(trimmed.normal, width, height), happy: centerOnCanvas(trimmed.happy, width, height) };
+        }
+        catch {
+            return undefined;
+        }
+    })();
+    return loadOnce;
+}
+/** 把一张已裁边的图居中放进 `width × height` 的透明画布（几何对齐用）。 */
+function centerOnCanvas(source, width, height) {
+    if (source.width === width && source.height === height)
+        return source;
+    const data = new Uint8Array(width * height * 4);
+    const left = Math.floor((width - source.width) / 2);
+    const top = Math.floor((height - source.height) / 2);
+    for (let y = 0; y < source.height; y++) {
+        const from = y * source.width * 4;
+        data.set(source.data.subarray(from, from + source.width * 4), ((top + y) * width + left) * 4);
+    }
+    return { data, width, height };
+}
+/**
+ * Trim fully-transparent borders (the art's canvas margins) with a small
+ * transparent pad. Sixel cannot express partial alpha, so the pad is dropped
+ * by the coverage mask at encode time; trimming first hands the terminal the
+ * artwork itself and lets the same cell box draw her larger.
+ */
+function trimTransparent(source, pad = 4) {
+    const { data, width, height } = source;
+    let minX = width;
+    let minY = height;
+    let maxX = -1;
+    let maxY = -1;
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            // Anti-aliased edges carry alpha > 0, so only truly empty pixels fall
+            // outside the bounding box.
+            if (data[(y * width + x) * 4 + 3] === 0)
+                continue;
+            if (x < minX)
+                minX = x;
+            if (x > maxX)
+                maxX = x;
+            if (y < minY)
+                minY = y;
+            if (y > maxY)
+                maxY = y;
+        }
+    }
+    if (maxX < minX || maxY < minY)
+        return source;
+    const left = Math.max(0, minX - pad);
+    const top = Math.max(0, minY - pad);
+    const right = Math.min(width - 1, maxX + pad);
+    const bottom = Math.min(height - 1, maxY + pad);
+    const cropWidth = right - left + 1;
+    const cropHeight = bottom - top + 1;
+    if (cropWidth === width && cropHeight === height)
+        return source;
+    const cropped = new Uint8Array(cropWidth * cropHeight * 4);
+    for (let y = 0; y < cropHeight; y++) {
+        const from = ((top + y) * width + left) * 4;
+        cropped.set(data.subarray(from, from + cropWidth * 4), y * cropWidth * 4);
+    }
+    return { data: cropped, width: cropWidth, height: cropHeight };
+}
+/**
+ * 两张立绘，终端图像能力确认后解码（一次把两张都备好，点击换图不等待）。
+ * @param enabled - `useTerminalImages()` 的结果；为假时根本不解码。
+ * @returns 两张 RGBA 源；未就绪/不可用时为 `undefined`。
+ */
+export function useMaidPortraits(enabled) {
+    const [sources, setSources] = React.useState(undefined);
+    React.useEffect(() => {
+        if (!enabled)
+            return;
+        let live = true;
+        void loadMaidPortraits().then(next => {
+            if (live && next !== undefined)
+                setSources(next);
+        });
+        return () => { live = false; };
+    }, [enabled]);
+    return enabled ? sources : undefined;
+}
+/** Fallback aspect before the source lands (square canvas). */
+const MAID_RATIO = 1;
+/**
+ * The portrait's center column inside the whale's 40-column slot: the
+ * aspect-fit image spans columns 5..34 (center 19.5). The welcome tagline
+ * centers on this instead of `WHALE_CENTER` while the portrait shows.
+ */
+export const MAID_BOX_CENTER = 19.5;
+/**
+ * The portrait as an Ink component: a `width × height` cell box (aspect-fit
+ * from the real cell metrics so pixels stay square), centered horizontally
+ * by the caller's slot. `presentation` follows the surface — `'transcript'`
+ * opts into Sixel for the scrollable header, `'preview'` for modal cards —
+ * and the portrait always floats `transparent`: her trimmed silhouette sits
+ * on whatever the terminal shows, with no backing rectangle behind it.
+ */
+export function MaidPortrait({ source, maxColumns, maxRows, presentation, }) {
+    const cell = useTerminalImageCellSize() ?? DEFAULT_TERMINAL_CELL_SIZE;
+    const cellRatio = cell.height / cell.width;
+    // Fit the TRIMMED artwork's own aspect, not the source canvas: the raster
+    // is her bounding box, so she fills the slot instead of floating in
+    // transparent padding.
+    const ratio = source !== undefined && source.height > 0 ? source.width / source.height : MAID_RATIO;
+    let width = maxColumns;
+    let height = Math.round(width / (cellRatio * ratio));
+    if (height > maxRows) {
+        height = maxRows;
+        width = Math.max(1, Math.min(maxColumns, Math.round(cellRatio * height * ratio)));
+    }
+    return (_jsx(Image, { transparent: true, source: source, width: width, height: height, alt: "", presentation: presentation }));
+}

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

@@ -0,0 +1,25 @@
+import type { TerminalImageSource } from '../ink/terminal-image.js';
+import type { MathRenderRequest } from '../math/renderer.js';
+/** What a click on a formula image hands to the preview host. */
+export interface MathPreviewRequest {
+    /** The formula's TeX without delimiters; the card shows it as its title. */
+    readonly tex: string;
+    /** The request that produced the raster currently on screen. */
+    readonly request: MathRenderRequest;
+    /** Those pixels, used as-is when a sharper raster cannot be produced. */
+    readonly source: TerminalImageSource;
+}
+export type MathPreviewOpener = (request: MathPreviewRequest) => void;
+/** Published by the transcript host; cleared when it unmounts. */
+export declare function setMathPreviewOpener(next: MathPreviewOpener | undefined): void;
+export declare function getMathPreviewOpener(): MathPreviewOpener | undefined;
+export declare function subscribeMathPreviewOpener(listener: () => void): () => void;
+/** The host's opener, or undefined when nothing can show a preview card. */
+export declare function useMathPreviewOpener(): MathPreviewOpener | undefined;
+/**
+ * RGBA raster → PNG bytes, the form the image preview card decodes. Sharp is
+ * already a runtime dependency (Sixel encoding uses it) and is optional, so a
+ * missing build rejects rather than returning a broken byte string.
+ */
+export declare function rasterToPng(source: TerminalImageSource): Promise<Uint8Array>;
+//# sourceMappingURL=mathPreview.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mathPreview.d.ts","sourceRoot":"","sources":["../../../src/components/mathPreview.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAG5D,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;IACnC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;CACrC;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAA;AAKrE,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAI9E;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,SAAS,CAEpE;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAK3E;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,SAAS,CAEpE;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAOlF"}

package/lib/types/components/mathPreview.js

@@ -0,0 +1,48 @@
+/**
+ * Formula-image previews.
+ *
+ * The transcript host (Chat) publishes an opener for as long as it is mounted,
+ * and the math components call it when a formula image is clicked. A
+ * module-level registry — the same shape the live display settings use —
+ * keeps that callback out of the MessageList → Markdown prop chain, which
+ * would otherwise thread it through every message row.
+ */
+import React from 'react';
+import { loadSharp } from '../dsh-adapter/sharp.js';
+let opener;
+const listeners = new Set();
+/** Published by the transcript host; cleared when it unmounts. */
+export function setMathPreviewOpener(next) {
+    if (opener === next)
+        return;
+    opener = next;
+    for (const listener of listeners)
+        listener();
+}
+export function getMathPreviewOpener() {
+    return opener;
+}
+export function subscribeMathPreviewOpener(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+/** The host's opener, or undefined when nothing can show a preview card. */
+export function useMathPreviewOpener() {
+    return React.useSyncExternalStore(subscribeMathPreviewOpener, getMathPreviewOpener);
+}
+/**
+ * RGBA raster → PNG bytes, the form the image preview card decodes. Sharp is
+ * already a runtime dependency (Sixel encoding uses it) and is optional, so a
+ * missing build rejects rather than returning a broken byte string.
+ */
+export async function rasterToPng(source) {
+    const sharp = await loadSharp();
+    if (sharp === undefined)
+        throw new Error('image encoder unavailable');
+    const buffer = await sharp(Buffer.from(source.data), {
+        raw: { width: source.width, height: source.height, channels: 4 },
+    }).png().toBuffer();
+    return new Uint8Array(buffer);
+}

package/lib/types/components/messages/AssistantThinkingMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantThinkingMessage.d.ts","sourceRoot":"","sources":["../../../../src/components/messages/AssistantThinkingMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAczB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAUjE,KAAK,KAAK,GAAG;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB;;;sDAGkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4CAA4C;IAC5C,eAAe,EAAE,OAAO,CAAA;IACxB,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAA;IAChB;;4CAEwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;8EAE0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;CAClC,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,OAAO,EACP,SAAiB,EACjB,OAAe,EACf,UAAU,EACV,UAAkB,EAClB,OAAO,GACR,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CAuIzB"}
+{"version":3,"file":"AssistantThinkingMessage.d.ts","sourceRoot":"","sources":["../../../../src/components/messages/AssistantThinkingMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAczB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAWjE,KAAK,KAAK,GAAG;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB;;;sDAGkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4CAA4C;IAC5C,eAAe,EAAE,OAAO,CAAA;IACxB,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAA;IAChB;;4CAEwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;8EAE0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;CAClC,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,OAAO,EACP,SAAiB,EACjB,OAAe,EACf,UAAU,EACV,UAAkB,EAClB,OAAO,GACR,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CAuIzB"}

package/lib/types/components/messages/AssistantThinkingMessage.js

@@ -9,6 +9,7 @@ import { THINKING_SPINNER_FRAMES, THINKING_SPINNER_INTERVAL_MS, THINKING_SETTLED
 import { BRAND, ICE } from '../shimmer.js';
 import { interpolateColor } from '../Spinner/spinnerUtils.js';
 import { isMinimalMode } from '../../minimalMode.js';
+import { primaryComboString } from '../../utils/keymap.js';
 /** Preview body rows — a FIXED row count (kimicode-style constant-height
  *  ticker). Ink's truncate slices the whole string across newlines as one
  *  logical line, so a single joined Text collapses to 1-2 rows whenever
@@ -49,7 +50,7 @@ export function AssistantThinkingMessage({ thinking, textFull, marginTopOnTurn,
     // header's brand→ice ladder, one sine period per ~7 frames (≈0.56s) —
     // lively without strobing. Minimal mode drops the color (plain glyph);
     // settled always keeps the plain dim anchor.
-    const label = `${t('thinking-label')}${duration}${streaming ? '…' : ` ${t('hint-expand-ctrl-o')}`}`;
+    const label = `${t('thinking-label')}${duration}${streaming ? '…' : ` ${t('hint-expand-ctrl-o', { key: primaryComboString('transcript') })}`}`;
     const minimal = isMinimalMode();
     const pulse = (Math.sin(frame * 0.9) + 1) / 2;
     const pulseColor = interpolateColor(BRAND, ICE, pulse);

package/lib/types/components/messages/AssistantToolUseMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantToolUseMessage.d.ts","sourceRoot":"","sources":["../../../../src/components/messages/AssistantToolUseMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAA8C,OAAO,EAAE,MAAM,8BAA8B,CAAA;AASvG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAIjE,KAAK,KAAK,GAAG;IACX,IAAI,EAAE,OAAO,CAAA;IACb,4CAA4C;IAC5C,eAAe,EAAE,OAAO,CAAA;IACxB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAA;IAChB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,kEAAkE;IAClE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;OAIG;IACH,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACjC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IACzC,2EAA2E;IAC3E,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;8CAC0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AA2FD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,CAKtD;AAsVD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,IAAI,EACJ,eAAe,EACf,OAAO,EACP,UAAkB,EAClB,UAAkB,EAClB,OAAO,EACP,QAAQ,EACR,UAAmB,EACnB,cAAuB,EACvB,UAAU,EACV,mBAA2B,EAC3B,YAAoB,EACpB,KAAa,EACb,aAAa,GACd,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CA2PzB"}
+{"version":3,"file":"AssistantToolUseMessage.d.ts","sourceRoot":"","sources":["../../../../src/components/messages/AssistantToolUseMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAA8C,OAAO,EAAE,MAAM,8BAA8B,CAAA;AASvG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAKjE,KAAK,KAAK,GAAG;IACX,IAAI,EAAE,OAAO,CAAA;IACb,4CAA4C;IAC5C,eAAe,EAAE,OAAO,CAAA;IACxB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAA;IAChB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,kEAAkE;IAClE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;OAIG;IACH,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACjC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IACzC,2EAA2E;IAC3E,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;8CAC0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AA2FD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,CAKtD;AAsVD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,IAAI,EACJ,eAAe,EACf,OAAO,EACP,UAAkB,EAClB,UAAkB,EAClB,OAAO,EACP,QAAQ,EACR,UAAmB,EACnB,cAAuB,EACvB,UAAU,EACV,mBAA2B,EAC3B,YAAoB,EACpB,KAAa,EACb,aAAa,GACd,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CA2PzB"}