@deepseek-harness-tui/dsh-tui 0.5.0

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

@@ -0,0 +1,25 @@
+/**
+ * Pixel-whale animation frames for the startup splash, converted from
+ * the hand-drawn Excel art in `whale_frames.zip` (25x40 cells, palette
+ * alphabet shared with Whale.tsx: D outline, B body, L belly, W mouth,
+ * `.` transparent). `OPENING_SEQUENCE` plays once at startup: blink,
+ * water-spout bloom, tail wag, then the header settles static.
+ */
+/** One animation frame: 25 sprite rows of 40 palette characters. */
+export interface WhaleFrame {
+    /** Frame label from the source art (Chinese names kept for traceability). */
+    readonly name: string;
+    readonly rows: readonly string[];
+}
+/** The 13 hand-drawn frames. */
+export declare const WHALE_FRAMES: readonly WhaleFrame[];
+/** One step of the opening animation: frame index + dwell time. */
+export interface OpeningStep {
+    /** Index into WHALE_FRAMES. */
+    readonly frame: number;
+    /** How long the frame stays on screen, in milliseconds. */
+    readonly ms: number;
+}
+/** Startup sequence (~3.4s), ending on the standard pose. */
+export declare const OPENING_SEQUENCE: readonly OpeningStep[];
+//# sourceMappingURL=whaleFrames.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"whaleFrames.d.ts","sourceRoot":"","sources":["../../../src/components/whaleFrames.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CACjC;AAED,gCAAgC;AAChC,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAuY7C,CAAA;AAED,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB;AAED,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,EAAE,SAAS,WAAW,EAiBlD,CAAA"}

package/lib/types/components/whaleFrames.js

@@ -0,0 +1,419 @@
+/**
+ * Pixel-whale animation frames for the startup splash, converted from
+ * the hand-drawn Excel art in `whale_frames.zip` (25x40 cells, palette
+ * alphabet shared with Whale.tsx: D outline, B body, L belly, W mouth,
+ * `.` transparent). `OPENING_SEQUENCE` plays once at startup: blink,
+ * water-spout bloom, tail wag, then the header settles static.
+ */
+/** The 13 hand-drawn frames. */
+export const WHALE_FRAMES = [
+    {
+        name: 'standard',
+        rows: [
+            '........................................',
+            '........................................',
+            '........................D...............',
+            '.......................DBD.......D......',
+            '.......................DBBD.....DBD.....',
+            '.......................DBBBD..DDBBD.....',
+            '.......................DBBBBDDBBBBD.....',
+            '.......DDDDDDDDD........DBBBBBBBBD......',
+            '......DBBBBBBBBBDD.......DBBBBBBBD......',
+            '.....DBBBBBBBBBBBBDD.....DBBBBBDD.......',
+            '....DBBBBBBBBBBBBBBBDD....DBBBD.........',
+            '...DDBBBBBBBBBBBBBBBBBD..DBBBBD.........',
+            '...DBBBBBBBBBBBBBBBBBBBDDBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBD..........',
+            '...DBBBBBBBBBBBBBBBBBBBBBBBBBD..........',
+            '...DBBBBWWWWWWWBBBBBBBBDBBBBD...........',
+            '...DDBWWWWWWWWWWWWBBBBBBDBBBD...........',
+            '....DLLWWWWWWWWWWWWDBBBBDDBD............',
+            '.....DLLLWWWWWWWWWWDBBBBBDD.............',
+            '......DDLLLWWWWWWLLLDBBBBBDD............',
+            '........DLLLLLLLLLLLDDBBBBBBD...........',
+            '.........DDDDDDDDDDD..DDDDDDD...........',
+            '........................................',
+            '........................................',
+        ],
+    },
+    {
+        name: 'blink',
+        rows: [
+            '........................................',
+            '........................................',
+            '........................D...............',
+            '.......................DBD.......D......',
+            '.......................DBBD.....DBD.....',
+            '.......................DBBBD..DDBBD.....',
+            '.......................DBBBBDDBBBBD.....',
+            '.......DDDDDDDDD........DBBBBBBBBD......',
+            '......DBBBBBBBBBDD.......DBBBBBBBD......',
+            '.....DBBBBBBBBBBBBDD.....DBBBBBDD.......',
+            '....DBBBBBBBBBBBBBBBDD....DBBBD.........',
+            '...DDBBBBBBBBBBBBBBBBBD..DBBBBD.........',
+            '...DBBBBBBBBBBBBBBBBBBBDDBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBBD.........',
+            '...DBBBBBBBBBBBBBBBBBBBBBBBBBD..........',
+            '...DBBBBBBBBBBBBBBBBBBBBBBBBBD..........',
+            '...DBBBBWWWWWWWBBBBBBBBDBBBBD...........',
+            '...DDBWWWWWWWWWWWWBBBBBBDBBBD...........',
+            '....DLLWWWWWWWWWWWWDBBBBDDBD............',
+            '.....DLLLWWWWWWWWWWDBBBBBDD.............',
+            '......DDLLLWWWWWWLLLDBBBBBDD............',
+            '........DLLLLLLLLLLLDDBBBBBBD...........',
+            '.........DDDDDDDDDDD..DDDDDDD...........',
+            '........................................',
+            '........................................',
+        ],
+    },
+    {
+        name: 'fin1',
+        rows: [
+            '........................................',
+            '........................................',
+            '........................D...............',
+            '.......................DBD.......D......',
+            '.......................DBBD.....DBD.....',
+            '.......................DBBBD..DDBBD.....',
+            '.......................DBBBBDDBBBBD.....',
+            '.......DDDDDDDDD........DBBBBBBBBD......',
+            '......DBBBBBBBBBDD.......DBBBBBBBD......',
+            '.....DBBBBBBBBBBBBDD.....DBBBBBDD.......',
+            '....DBBBBBBBBBBBBBBBDD....DBBBD.........',
+            '...DDBBBBBBBBBBBBBBBBBD..DBBBBD.........',
+            '...DBBBBBBBBBBBBBBBBBBBDDBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBD..........',
+            '...DBBBBBBBBBBBBBBBBBBBBBBBBBD..........',
+            '...DBBBBWWWWWWWBBBBBBBBDBBBBD...........',
+            '...DDBWWWWWWWWWWWWBBBBBBDBBBD...........',
+            '....DLLWWWWWWWWWWWWDBBBBBDBD............',
+            '.....DLLLWWWWWWWWWWDBBBBBBD.............',
+            '......DDLLLWWWWWWLLLDBBBBBBDD...........',
+            '........DLLLLLLLLLLLLDDBBBBBBD..........',
+            '.........DDDDDDDDDDDD..DDDDDD...........',
+            '........................................',
+            '........................................',
+        ],
+    },
+    {
+        name: 'fin2',
+        rows: [
+            '........................................',
+            '........................................',
+            '........................D...............',
+            '.......................DBD.......D......',
+            '.......................DBBD.....DBD.....',
+            '.......................DBBBD..DDBBD.....',
+            '.......................DBBBBDDBBBBD.....',
+            '.......DDDDDDDDD........DBBBBBBBBD......',
+            '......DBBBBBBBBBDD.......DBBBBBBBD......',
+            '.....DBBBBBBBBBBBBDD.....DBBBBBDD.......',
+            '....DBBBBBBBBBBBBBBBDD....DBBBD.........',
+            '...DDBBBBBBBBBBBBBBBBBD..DBBBBD.........',
+            '...DBBBBBBBBBBBBBBBBBBBDDBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBD..........',
+            '...DBBBBBBBBBBBBBBBBBBBBBBBBBD..........',
+            '...DBBBBWWWWWWWBBBBBBBBDBBBBD...........',
+            '...DDBWWWWWWWWWWWWBBBBBBDDBBD...........',
+            '....DLLWWWWWWWWWWWWDBBBBBBDD............',
+            '.....DLLLWWWWWWWWWWDBBBBBBBBDD..........',
+            '......DDLLLWWWWWWLLLDBBBBBBBBBD.........',
+            '........DLLLLLLLLLLLLDDDBBBBBD..........',
+            '.........DDDDDDDDDDDD...DDDDD...........',
+            '........................................',
+            '........................................',
+        ],
+    },
+    {
+        name: 'spout1',
+        rows: [
+            '........................................',
+            '........................................',
+            '........................D...............',
+            '.......................DBD.......D......',
+            '.......................DBBD.....DBD.....',
+            '..........LLL..........DBBBD..DDBBD.....',
+            '...........L...........DBBBBDDBBBBD.....',
+            '.......DDDDDDDDD........DBBBBBBBBD......',
+            '......DBBBBBBBBBDD.......DBBBBBBBD......',
+            '.....DBBBBBBBBBBBBDD.....DBBBBBDD.......',
+            '....DBBBBBBBBBBBBBBBDD....DBBBD.........',
+            '...DDBBBBBBBBBBBBBBBBBD..DBBBBD.........',
+            '...DBBBBBBBBBBBBBBBBBBBDDBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBD..........',
+            '...DBBBBBBBBBBBBBBBBBBBBBBBBBD..........',
+            '...DBBBBWWWWWWWBBBBBBBBDBBBBD...........',
+            '...DDBWWWWWWWWWWWWBBBBBBDBBBD...........',
+            '....DLLWWWWWWWWWWWWDBBBBDDBD............',
+            '.....DLLLWWWWWWWWWWDBBBBBDD.............',
+            '......DDLLLWWWWWWLLLDBBBBBDD............',
+            '........DLLLLLLLLLLLDDBBBBBBD...........',
+            '.........DDDDDDDDDDD..DDDDDDD...........',
+            '........................................',
+            '........................................',
+        ],
+    },
+    {
+        name: 'spout2',
+        rows: [
+            '........................................',
+            '........................................',
+            '........................D...............',
+            '...........L...........DBD.......D......',
+            '.........LLLLL.........DBBD.....DBD.....',
+            '..........LLL..........DBBBD..DDBBD.....',
+            '...........L...........DBBBBDDBBBBD.....',
+            '.......DDDDDDDDD........DBBBBBBBBD......',
+            '......DBBBBBBBBBDD.......DBBBBBBBD......',
+            '.....DBBBBBBBBBBBBDD.....DBBBBBDD.......',
+            '....DBBBBBBBBBBBBBBBDD....DBBBD.........',
+            '...DDBBBBBBBBBBBBBBBBBD..DBBBBD.........',
+            '...DBBBBBBBBBBBBBBBBBBBDDBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBD..........',
+            '...DBBBBBBBBBBBBBBBBBBBBBBBBBD..........',
+            '...DBBBBWWWWWWWBBBBBBBBDBBBBD...........',
+            '...DDBWWWWWWWWWWWWBBBBBBDBBBD...........',
+            '....DLLWWWWWWWWWWWWDBBBBDDBD............',
+            '.....DLLLWWWWWWWWWWDBBBBBDD.............',
+            '......DDLLLWWWWWWLLLDBBBBBDD............',
+            '........DLLLLLLLLLLLDDBBBBBBD...........',
+            '.........DDDDDDDDDDD..DDDDDDD...........',
+            '........................................',
+            '........................................',
+        ],
+    },
+    {
+        name: 'spout3',
+        rows: [
+            '........................................',
+            '........................................',
+            '...........L............D...............',
+            '.........LLLLL.........DBD.......D......',
+            '.......LLLLLLLLL.......DBBD.....DBD.....',
+            '..........LLL..........DBBBD..DDBBD.....',
+            '...........L...........DBBBBDDBBBBD.....',
+            '.......DDDDDDDDD........DBBBBBBBBD......',
+            '......DBBBBBBBBBDD.......DBBBBBBBD......',
+            '.....DBBBBBBBBBBBBDD.....DBBBBBDD.......',
+            '....DBBBBBBBBBBBBBBBDD....DBBBD.........',
+            '...DDBBBBBBBBBBBBBBBBBD..DBBBBD.........',
+            '...DBBBBBBBBBBBBBBBBBBBDDBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBD..........',
+            '...DBBBBBBBBBBBBBBBBBBBBBBBBBD..........',
+            '...DBBBBWWWWWWWBBBBBBBBDBBBBD...........',
+            '...DDBWWWWWWWWWWWWBBBBBBDBBBD...........',
+            '....DLLWWWWWWWWWWWWDBBBBDDBD............',
+            '.....DLLLWWWWWWWWWWDBBBBBDD.............',
+            '......DDLLLWWWWWWLLLDBBBBBDD............',
+            '........DLLLLLLLLLLLDDBBBBBBD...........',
+            '.........DDDDDDDDDDD..DDDDDDD...........',
+            '........................................',
+            '........................................',
+        ],
+    },
+    {
+        name: 'spout4',
+        rows: [
+            '........................................',
+            '...........L............................',
+            '........LLLLLLL.........D...............',
+            '......LLLLLLLLLLL......DBD.......D......',
+            '......L...LLL...L......DBBD.....DBD.....',
+            '...........L...........DBBBD..DDBBD.....',
+            '.......................DBBBBDDBBBBD.....',
+            '.......DDDDDDDDD........DBBBBBBBBD......',
+            '......DBBBBBBBBBDD.......DBBBBBBBD......',
+            '.....DBBBBBBBBBBBBDD.....DBBBBBDD.......',
+            '....DBBBBBBBBBBBBBBBDD....DBBBD.........',
+            '...DDBBBBBBBBBBBBBBBBBD..DBBBBD.........',
+            '...DBBBBBBBBBBBBBBBBBBBDDBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBD..........',
+            '...DBBBBBBBBBBBBBBBBBBBBBBBBBD..........',
+            '...DBBBBWWWWWWWBBBBBBBBDBBBBD...........',
+            '...DDBWWWWWWWWWWWWBBBBBBDBBBD...........',
+            '....DLLWWWWWWWWWWWWDBBBBDDBD............',
+            '.....DLLLWWWWWWWWWWDBBBBBDD.............',
+            '......DDLLLWWWWWWLLLDBBBBBDD............',
+            '........DLLLLLLLLLLLDDBBBBBBD...........',
+            '.........DDDDDDDDDDD..DDDDDDD...........',
+            '........................................',
+            '........................................',
+        ],
+    },
+    {
+        name: 'spout5',
+        rows: [
+            '........................................',
+            '.......LL..L..LL........................',
+            '......LLLL.L.LLLL.......D...............',
+            '.....L....LLL....L.....DBD.......D......',
+            '....L......L......L....DBBD.....DBD.....',
+            '.......................DBBBD..DDBBD.....',
+            '.......................DBBBBDDBBBBD.....',
+            '.......DDDDDDDDD........DBBBBBBBBD......',
+            '......DBBBBBBBBBDD.......DBBBBBBBD......',
+            '.....DBBBBBBBBBBBBDD.....DBBBBBDD.......',
+            '....DBBBBBBBBBBBBBBBDD....DBBBD.........',
+            '...DDBBBBBBBBBBBBBBBBBD..DBBBBD.........',
+            '...DBBBBBBBBBBBBBBBBBBBDDBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBD..........',
+            '...DBBBBBBBBBBBBBBBBBBBBBBBBBD..........',
+            '...DBBBBWWWWWWWBBBBBBBBDBBBBD...........',
+            '...DDBWWWWWWWWWWWWBBBBBBDBBBD...........',
+            '....DLLWWWWWWWWWWWWDBBBBDDBD............',
+            '.....DLLLWWWWWWWWWWDBBBBBDD.............',
+            '......DDLLLWWWWWWLLLDBBBBBDD............',
+            '........DLLLLLLLLLLLDDBBBBBBD...........',
+            '.........DDDDDDDDDDD..DDDDDDD...........',
+            '........................................',
+            '........................................',
+        ],
+    },
+    {
+        name: 'spout6',
+        rows: [
+            '........................................',
+            '......LL...L...LL.......................',
+            '.....L..LL.L.LL..L......D...............',
+            '....L.....LLL.....L....DBD.......D......',
+            '...L.......L.......L...DBBD.....DBD.....',
+            '.......................DBBBD..DDBBD.....',
+            '.......................DBBBBDDBBBBD.....',
+            '.......DDDDDDDDD........DBBBBBBBBD......',
+            '......DBBBBBBBBBDD.......DBBBBBBBD......',
+            '.....DBBBBBBBBBBBBDD.....DBBBBBDD.......',
+            '....DBBBBBBBBBBBBBBBDD....DBBBD.........',
+            '...DDBBBBBBBBBBBBBBBBBD..DBBBBD.........',
+            '...DBBBBBBBBBBBBBBBBBBBDDBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBD..........',
+            '...DBBBBBBBBBBBBBBBBBBBBBBBBBD..........',
+            '...DBBBBWWWWWWWBBBBBBBBDBBBBD...........',
+            '...DDBWWWWWWWWWWWWBBBBBBDBBBD...........',
+            '....DLLWWWWWWWWWWWWDBBBBDDBD............',
+            '.....DLLLWWWWWWWWWWDBBBBBDD.............',
+            '......DDLLLWWWWWWLLLDBBBBBDD............',
+            '........DLLLLLLLLLLLDDBBBBBBD...........',
+            '.........DDDDDDDDDDD..DDDDDDD...........',
+            '........................................',
+            '........................................',
+        ],
+    },
+    {
+        name: 'tail1',
+        rows: [
+            '........................................',
+            '........................................',
+            '.........................D..............',
+            '........................DBD.......D.....',
+            '........................DBBD.....DBD....',
+            '........................DBBBD..DDBBD....',
+            '.........................DBBBDDBBBBD....',
+            '.......DDDDDDDDD.........DBBBBBBBBD.....',
+            '......DBBBBBBBBBDD........DBBBBBBBD.....',
+            '.....DBBBBBBBBBBBBDD......DBBBBBDD......',
+            '....DBBBBBBBBBBBBBBBDD.....DBBBD........',
+            '...DDBBBBBBBBBBBBBBBBBD...DBBBBD........',
+            '...DBBBBBBBBBBBBBBBBBBBDDDBBBBBD........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBBD.........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBBD.........',
+            '...DBBBBBBBBBBBBBBBBBBBBBBBBBD..........',
+            '...DBBBBWWWWWWWBBBBBBBBDBBBBBD..........',
+            '...DDBWWWWWWWWWWWWBBBBBBDBBBD...........',
+            '....DLLWWWWWWWWWWWWDBBBBDDBD............',
+            '.....DLLLWWWWWWWWWWDBBBBBDD.............',
+            '......DDLLLWWWWWWLLLDBBBBBDD............',
+            '........DLLLLLLLLLLLDDBBBBBBD...........',
+            '.........DDDDDDDDDDD..DDDDDDD...........',
+            '........................................',
+            '........................................',
+        ],
+    },
+    {
+        name: 'tail2',
+        rows: [
+            '........................................',
+            '........................................',
+            '..........................D.............',
+            '.........................DBD........DD..',
+            '.........................DBBD......DBD..',
+            '.........................DBBBD....DBBD..',
+            '..........................DBBBD.DDBBD...',
+            '.......DDDDDDDDD...........DBBBDBBBBD...',
+            '......DBBBBBBBBBDD.........DBBBBBBBD....',
+            '.....DBBBBBBBBBBBBDD........DBBBBBD.....',
+            '....DBBBBBBBBBBBBBBBDD......DBBBBBD.....',
+            '...DDBBBBBBBBBBBBBBBBBD..DDDBBBBDD......',
+            '...DBBBBBBBBBBBBBBBBBBBDDBBBBBBBD.......',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBBBD........',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBBD.........',
+            '...DBBBBBBBBBBBBBBBBBBBBBBBBBBD.........',
+            '...DBBBBWWWWWWWBBBBBBBBDBBBBBD..........',
+            '...DDBWWWWWWWWWWWWBBBBBBDBBBD...........',
+            '....DLLWWWWWWWWWWWWDBBBBDDBD............',
+            '.....DLLLWWWWWWWWWWDBBBBBDD.............',
+            '......DDLLLWWWWWWLLLDBBBBBDD............',
+            '........DLLLLLLLLLLLDDBBBBBBD...........',
+            '.........DDDDDDDDDDD..DDDDDDD...........',
+            '........................................',
+            '........................................',
+        ],
+    },
+    {
+        name: 'tail3',
+        rows: [
+            '........................................',
+            '........................................',
+            '........................................',
+            '.............................D..........',
+            '............................DBD.........',
+            '............................DBD.........',
+            '...........................DBBD.....DD..',
+            '.......DDDDDDDDD...........DBBBD...DBBD.',
+            '......DBBBBBBBBBDD.........DBBBD.DDBBD..',
+            '.....DBBBBBBBBBBBBDD.......DBBBBDBBBBD..',
+            '....DBBBBBBBBBBBBBBBDD......DBBBBBBBD...',
+            '...DDBBBBBBBBBBBBBBBBBD...DDBBBBBBBD....',
+            '...DBBBBBBBBBBBBBBBBBBBDDDBBBBBBBBD.....',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBBBBDD......',
+            '...DBBBDBBBBBBDBBBBBBBBBBBBBBBBD........',
+            '...DBBBBBBBBBBBBBBBBBBBBBBBBBBBD........',
+            '...DBBBBWWWWWWWBBBBBBBBDBBBBBBD.........',
+            '...DDBWWWWWWWWWWWWBBBBBBDBBBDD..........',
+            '....DLLWWWWWWWWWWWWDBBBBDDBDD...........',
+            '.....DLLLWWWWWWWWWWDBBBBBDD.............',
+            '......DDLLLWWWWWWLLLDBBBBBDD............',
+            '........DLLLLLLLLLLLDDBBBBBBD...........',
+            '.........DDDDDDDDDDD..DDDDDDD...........',
+            '........................................',
+            '........................................',
+        ],
+    },
+];
+/** Startup sequence (~3.4s), ending on the standard pose. */
+export const OPENING_SEQUENCE = [
+    { frame: 0, ms: 400 }, // standard
+    { frame: 1, ms: 250 }, // blink
+    { frame: 0, ms: 300 }, // standard
+    { frame: 4, ms: 150 }, // spout1
+    { frame: 5, ms: 150 }, // spout2
+    { frame: 6, ms: 150 }, // spout3
+    { frame: 7, ms: 150 }, // spout4
+    { frame: 8, ms: 150 }, // spout5
+    { frame: 9, ms: 150 }, // spout6
+    { frame: 0, ms: 250 }, // standard
+    { frame: 10, ms: 170 }, // tail1
+    { frame: 11, ms: 170 }, // tail2
+    { frame: 12, ms: 260 }, // tail3
+    { frame: 11, ms: 170 }, // tail2
+    { frame: 10, ms: 170 }, // tail1
+    { frame: 0, ms: 300 }, // standard
+];

package/lib/types/customTheme.d.ts

@@ -0,0 +1,104 @@
+/**
+ * User-defined color themes for dsh-tui.
+ *
+ * A theme is a JSON file in `~/.dsh-cc/themes/<name>.json`:
+ *
+ * ```json
+ * { "name": "sakura", "displayName": "Sakura Pink", "base": "dark",
+ *   "colors": { "claude": "#FF9EC7", "text": "#E8E6E0" } }
+ * ```
+ *
+ * `base` is required (`light`/`dark`/`dark-ansi`) and selects the built-in
+ * palette the file overlays; `colors` holds a subset of Theme keys. `name`
+ * defaults to the file name; `displayName` defaults to `name`.
+ *
+ * Validation is best-effort per key: unknown keys and invalid color values
+ * are skipped with a warning on stderr, never fatal; a file whose JSON is
+ * malformed or whose `base` is invalid is skipped entirely (also warned).
+ * Accepted color value forms (the same forms the built-in palettes and the
+ * Ink color engine use): `#rgb`, `#rrggbb`, `#rrggbbaa`, `rgb(r,g,b)`,
+ * `ansi256(n)` and the 16 `ansi:` names.
+ */
+import { type Theme } from './theme.js';
+/** The base palettes a user theme may overlay. */
+export declare const THEME_BASE_NAMES: readonly ["light", "dark", "dark-ansi"];
+export type ThemeBase = (typeof THEME_BASE_NAMES)[number];
+/** The directory user theme files live in (~/.dsh-cc/themes). */
+export declare const CUSTOM_THEME_DIR: string;
+/** A validated user theme file. `colors` only carries accepted overrides. */
+export type CustomThemeSpec = {
+    /** Stable id: the file's `name` field, or the file name (minus .json) when omitted. */
+    name: string;
+    /** Human-readable label for pickers; defaults to `name`. */
+    displayName: string;
+    /** The built-in palette this theme overlays. */
+    base: ThemeBase;
+    /** Validated Theme-key overrides (a subset of the base palette). */
+    colors: Partial<Theme>;
+    /** The underlying file name without .json — the on-disk load key. */
+    file: string;
+};
+/**
+ * Whether a name is safe to use as a file name (no path separators or dot
+ * traversal). Theme names are user input from CC_TUI_THEME and /theme, so
+ * they must never escape the themes directory.
+ */
+export declare function isSafeThemeName(name: string): boolean;
+/**
+ * Whether a value is an accepted color string: #rgb/#rrggbb/#rrggbbaa,
+ * rgb(r,g,b), ansi256(n) or one of the 16 ansi: names — the same forms the
+ * built-in palettes and the Ink color engine accept.
+ * @param value - Candidate color value.
+ * @returns True when the value is a well-formed color string.
+ */
+export declare function isValidThemeColor(value: unknown): value is string;
+/**
+ * Parse and validate a theme file's contents. Unknown keys and invalid
+ * color values are skipped (each warned); a file that is not an object,
+ * has an invalid `base`, or has a non-object `colors` is rejected entirely.
+ * @param text - Raw file contents.
+ * @param fileName - File name (with or without the .json extension); the
+ *   load key and the default theme name when the file omits `name`.
+ * @returns The validated spec, or undefined when the file is unusable.
+ */
+export declare function parseCustomTheme(text: string, fileName: string): CustomThemeSpec | undefined;
+/**
+ * Load and validate one user theme by name.
+ * @param name - Theme name (file name without .json).
+ * @param dir - Themes directory (injectable for tests).
+ * @returns The validated spec, or undefined when missing/invalid.
+ */
+export declare function loadCustomTheme(name: string, dir?: string): CustomThemeSpec | undefined;
+/**
+ * Discover every usable user theme in the themes directory, sorted by name.
+ * Invalid files are skipped (each warned by parseCustomTheme).
+ * @param dir - Themes directory (injectable for tests).
+ * @returns The validated specs found.
+ */
+export declare function listCustomThemes(dir?: string): CustomThemeSpec[];
+/**
+ * Overlay a spec's overrides onto its base palette.
+ * @param spec - Validated theme spec.
+ * @returns The full concrete palette.
+ */
+export declare function buildTheme(spec: CustomThemeSpec): Theme;
+/**
+ * Resolve a user theme name to its full palette, cached after first load.
+ * A `name` field that differs from the file name is indexed on the first
+ * miss, so display names resolve everywhere. Failures are not cached, so a
+ * file fixed while the TUI runs can be picked up on the next attempt.
+ * @param name - User theme name.
+ * @returns The built palette, or undefined when unknown/invalid.
+ */
+export declare function resolveCustomTheme(name: string): Theme | undefined;
+/**
+ * Whether a name selects a usable theme: a built-in palette or a valid user
+ * theme file. Used for CC_TUI_THEME / persisted-preference validation and
+ * the runtime /theme switch.
+ * @param name - Candidate theme name.
+ * @returns True when the theme resolves.
+ */
+export declare function isThemeAvailable(name: string): boolean;
+/** Drop the resolved-theme cache and name index (tests, or after themes change on disk). */
+export declare function clearCustomThemeCache(): void;
+//# sourceMappingURL=customTheme.d.ts.map

package/lib/types/customTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customTheme.d.ts","sourceRoot":"","sources":["../../src/customTheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,YAAY,CAAA;AAE9D,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,yCAA0C,CAAA;AACvE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEzD,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,QAAuC,CAAA;AAEpE,6EAA6E;AAC7E,MAAM,MAAM,eAAe,GAAG;IAC5B,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,IAAI,EAAE,SAAS,CAAA;IACf,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IACtB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AA2CD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQrD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAUjE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,SAAS,CAkE7B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAyB,GAC7B,eAAe,GAAG,SAAS,CAQ7B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAyB,GAAG,eAAe,EAAE,CAclF;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,KAAK,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAWlE;AAcD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C"}