dsh-code 0.6.0 → 0.7.0

package/lib/types/startup.d.ts

@@ -1,9 +1,9 @@
 /**
  * The interactive terminal app's command-line provider: parses `--resume`,
- * `--continue`, `--session`, `--mode`, and `--help`, then publishes
- * {@link TUI_STARTUP_SERVICE} for the runner to consume lazily. Follows the
- * headless bundle's startup shape (a commander action publishing a service
- * through {@link parseCmdline}).
+ * `--continue`, `--session`, `--mode`, `--theme`, and `--help`, then
+ * publishes {@link TUI_STARTUP_SERVICE} for the runner to consume lazily.
+ * Follows the headless bundle's startup shape (a commander action publishing
+ * a service through {@link parseCmdline}).
  *
  * Semantics:
  * - `--resume <id|prefix>` — continue the persisted session whose id or unique
@@ -13,11 +13,14 @@
  *   whose project directory matches the current working directory.
  * - `--session <id>` — create a new session under an explicit identity (the
  *   id must not exist yet).
+ * - `--theme <dark|light|auto>` — the color palette; auto follows the
+ *   terminal (dark fallback until OSC-11 detection lands).
  * - no flags — a fresh session with a minted id.
  *
  * @module @deepseek-ai/dsh-tui/startup
  */
 import type { Context } from '@deepseek-ai/cordis';
+import { type ThemeName } from './theme.ts';
 /** Stable Cordis plugin name. */
 export declare const name = "tui-startup";
 /** Services required before the invocation can be resolved. */
@@ -28,21 +31,26 @@ export declare const TUI_STARTUP_SERVICE = "tuiStartup";
 export type TuiStartup = {
     readonly kind: 'fresh';
     readonly mode?: string;
+    readonly theme?: ThemeName;
 } | {
     readonly kind: 'named';
     readonly sessionId: string;
     readonly mode?: string;
+    readonly theme?: ThemeName;
 } | {
     readonly kind: 'resume';
     readonly sessionId: string;
+    readonly theme?: ThemeName;
 } | {
     readonly kind: 'latest';
+    readonly theme?: ThemeName;
 };
 export interface TuiStartupOptions {
     readonly resume?: string;
     readonly continue?: boolean;
     readonly session?: string;
     readonly mode?: string;
+    readonly theme?: ThemeName;
 }
 /** Pure option policy shared by Commander and tests. */
 export declare function resolveTuiStartup(options: TuiStartupOptions): TuiStartup;

package/lib/types/theme-panel.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The `/theme` picker (the Codex `/theme` contract): one bounded list over
+ * the three color themes — dark, light, and auto (terminal-sensed; auto
+ * falls back to dark until OSC-11 detection lands). Enter applies the row
+ * and the runner persists it; Esc closes without changing the theme.
+ *
+ * @module @deepseek-ai/dsh-tui/theme-panel
+ */
+import { type ReactElement } from 'react';
+import { type ThemeName } from './theme.ts';
+/**
+ * The /theme list: one row per theme, the current one marked with ●, the
+ * focused one with ›. Enter applies the focused theme (the runner persists
+ * it), Esc/q closes without changing anything. Colors read the ACTIVE
+ * palette, so the panel itself adapts to a light theme once applied.
+ */
+export declare function ThemePanel({ current, select, close }: {
+    /** Theme name in force (the requested name; 'auto' included). */
+    current: ThemeName;
+    /** Accept one theme name: applied immediately and persisted by the runner. */
+    select(name: ThemeName): void;
+    /** Close without changing the theme. */
+    close(): void;
+}): ReactElement;

package/lib/types/theme.d.ts

@@ -4,17 +4,141 @@
  * (`packages/client/ui-theme/src/styles/design-platform.css`). Truecolor RGB
  * rides chalk, which degrades automatically on terminals without truecolor.
  *
+ * Two palettes — `dark` (the default) and `light` — share the same token keys
+ * with different values. Painters and the palette accessor read the ACTIVE
+ * palette selected through {@link setTheme}, so a theme switch recolors every
+ * painted surface on the next render without touching call sites. Raw token
+ * consumers keep reading {@link TUI_RGB} (the dark values) until the
+ * theme-aware integration replaces those call sites with
+ * `inkColor(getPalette().token)`.
+ *
  * @module @deepseek-ai/dsh-tui/theme
  */
+/** One RGB triple for a palette token. */
+export type RgbTriple = readonly [number, number, number];
+/** Palette token keys shared by every theme. */
+export type ThemeToken = 'brand' | 'brandBright' | 'brandMid' | 'brandDeep' | 'dim' | 'success' | 'error' | 'warn' | 'text' | 'code';
+/** One full color palette: every token key mapped to an RGB triple. */
+export type ThemePalette = Readonly<Record<ThemeToken, RgbTriple>>;
+/** Selectable theme names: dark, light, or auto (terminal-sensed). */
+export type ThemeName = 'dark' | 'light' | 'auto';
+/** Valid theme names in canonical picker order. */
+export declare const THEME_NAMES: readonly ThemeName[];
 /**
- * RGB triples for the TUI, one entry per design-platform token in use.
- * Keep names and values in sync with the CSS custom properties cited inline.
+ * DeepSeek dark palette: the original TUI colors, one entry per
+ * design-platform token in use. Keep names and values in sync with the CSS
+ * custom properties cited inline.
+ */
+export declare const DARK_PALETTE: {
+    /** Primary brand blue — `--dsw-static-deepseek-500`. */
+    readonly brand: readonly [65, 118, 230];
+    /** Brighter brand blue for live/streaming emphasis — `--dsw-static-deepseek-400`. */
+    readonly brandBright: readonly [103, 158, 254];
+    /** Intermediate brand blue between brand and brandBright — `--dsw-static-deepseek-450`. */
+    readonly brandMid: readonly [86, 134, 254];
+    /** Deep brand blue for secondary chrome — `--dsw-static-deepseek-600`. */
+    readonly brandDeep: readonly [72, 104, 178];
+    /** Muted caption gray — `--dsw-static-neutral-bluish-600`. */
+    readonly dim: readonly [129, 133, 140];
+    /** Success green — `--dsw-static-green-500`. */
+    readonly success: readonly [34, 197, 94];
+    /** Error red — `--dsw-static-red-500`. */
+    readonly error: readonly [239, 68, 68];
+    /** Warning amber — `--dsw-static-amber-500`. */
+    readonly warn: readonly [245, 158, 11];
+    /** Default foreground text — `--dsw-static-neutral-50`. */
+    readonly text: readonly [236, 240, 246];
+    /** Inline/fenced code — soft sky blue, distinct from brand accents. */
+    readonly code: readonly [125, 211, 252];
+};
+/**
+ * Light palette tuned for white terminals: the same token keys as dark with
+ * contrast-driven values (AA on a white background). Brand keeps its dark
+ * value (≈4.9:1); the bright/mid/deep blues, muted grays, and status colors
+ * deepen so they stay legible on bright backgrounds.
+ */
+export declare const LIGHT_PALETTE: {
+    /** Primary brand blue — unchanged, ≈4.9:1 AA on white. */
+    readonly brand: readonly [65, 118, 230];
+    /** Brighter brand blue deepened for white backgrounds (was 2.7:1). */
+    readonly brandBright: readonly [72, 104, 178];
+    /** Intermediate brand blue — Tailwind blue-500. */
+    readonly brandMid: readonly [59, 130, 246];
+    /** Deep brand blue for secondary chrome — `--dsw-static-deepseek-700`. */
+    readonly brandDeep: readonly [47, 76, 143];
+    /** Muted caption gray deepened for white backgrounds. */
+    readonly dim: readonly [101, 103, 107];
+    /** Success green — Tailwind green-700. */
+    readonly success: readonly [21, 128, 61];
+    /** Error red — Tailwind red-600. */
+    readonly error: readonly [236, 19, 19];
+    /** Warning amber — Tailwind amber-700. */
+    readonly warn: readonly [180, 83, 9];
+    /** Default foreground text — near-black. */
+    readonly text: readonly [21, 21, 23];
+    /** Inline/fenced code — Tailwind cyan-700, distinct from brand accents. */
+    readonly code: readonly [14, 116, 144];
+};
+/** Every palette by theme name; auto resolves through {@link resolveTheme}. */
+export declare const PALETTES: {
+    readonly dark: {
+        /** Primary brand blue — `--dsw-static-deepseek-500`. */
+        readonly brand: readonly [65, 118, 230];
+        /** Brighter brand blue for live/streaming emphasis — `--dsw-static-deepseek-400`. */
+        readonly brandBright: readonly [103, 158, 254];
+        /** Intermediate brand blue between brand and brandBright — `--dsw-static-deepseek-450`. */
+        readonly brandMid: readonly [86, 134, 254];
+        /** Deep brand blue for secondary chrome — `--dsw-static-deepseek-600`. */
+        readonly brandDeep: readonly [72, 104, 178];
+        /** Muted caption gray — `--dsw-static-neutral-bluish-600`. */
+        readonly dim: readonly [129, 133, 140];
+        /** Success green — `--dsw-static-green-500`. */
+        readonly success: readonly [34, 197, 94];
+        /** Error red — `--dsw-static-red-500`. */
+        readonly error: readonly [239, 68, 68];
+        /** Warning amber — `--dsw-static-amber-500`. */
+        readonly warn: readonly [245, 158, 11];
+        /** Default foreground text — `--dsw-static-neutral-50`. */
+        readonly text: readonly [236, 240, 246];
+        /** Inline/fenced code — soft sky blue, distinct from brand accents. */
+        readonly code: readonly [125, 211, 252];
+    };
+    readonly light: {
+        /** Primary brand blue — unchanged, ≈4.9:1 AA on white. */
+        readonly brand: readonly [65, 118, 230];
+        /** Brighter brand blue deepened for white backgrounds (was 2.7:1). */
+        readonly brandBright: readonly [72, 104, 178];
+        /** Intermediate brand blue — Tailwind blue-500. */
+        readonly brandMid: readonly [59, 130, 246];
+        /** Deep brand blue for secondary chrome — `--dsw-static-deepseek-700`. */
+        readonly brandDeep: readonly [47, 76, 143];
+        /** Muted caption gray deepened for white backgrounds. */
+        readonly dim: readonly [101, 103, 107];
+        /** Success green — Tailwind green-700. */
+        readonly success: readonly [21, 128, 61];
+        /** Error red — Tailwind red-600. */
+        readonly error: readonly [236, 19, 19];
+        /** Warning amber — Tailwind amber-700. */
+        readonly warn: readonly [180, 83, 9];
+        /** Default foreground text — near-black. */
+        readonly text: readonly [21, 21, 23];
+        /** Inline/fenced code — Tailwind cyan-700, distinct from brand accents. */
+        readonly code: readonly [14, 116, 144];
+    };
+};
+/**
+ * The dark palette under its original name: call sites that predate the
+ * two-palette switch keep compiling and painting identically (the default
+ * theme IS dark). New code should read the active palette through
+ * {@link getPalette} so a theme switch reaches it.
  */
 export declare const TUI_RGB: {
     /** Primary brand blue — `--dsw-static-deepseek-500`. */
     readonly brand: readonly [65, 118, 230];
     /** Brighter brand blue for live/streaming emphasis — `--dsw-static-deepseek-400`. */
     readonly brandBright: readonly [103, 158, 254];
+    /** Intermediate brand blue between brand and brandBright — `--dsw-static-deepseek-450`. */
+    readonly brandMid: readonly [86, 134, 254];
     /** Deep brand blue for secondary chrome — `--dsw-static-deepseek-600`. */
     readonly brandDeep: readonly [72, 104, 178];
     /** Muted caption gray — `--dsw-static-neutral-bluish-600`. */
@@ -30,6 +154,38 @@ export declare const TUI_RGB: {
     /** Inline/fenced code — soft sky blue, distinct from brand accents. */
     readonly code: readonly [125, 211, 252];
 };
+/**
+ * Resolve a theme name to the palette actually in use. `auto` detection
+ * (OSC 11 terminal background query) is a later enhancement; until it lands,
+ * auto falls back to the dark palette.
+ * @param name - the requested theme name.
+ * @returns 'dark' or 'light' — the palette key to paint with.
+ */
+export declare function resolveTheme(name: ThemeName): 'dark' | 'light';
+/**
+ * Switch the active theme: painters and {@link getPalette} reflect the new
+ * palette from the next render onward. The default is dark, so a process
+ * that never calls this paints exactly as before.
+ * @param name - the theme to activate ('auto' resolves to dark for now).
+ */
+export declare function setTheme(name: ThemeName): void;
+/**
+ * The theme name in force. Returns the requested name ('auto' included) so
+ * the /theme picker and persistence can round-trip the user's choice; the
+ * palette actually used is {@link getPalette}.
+ */
+export declare function getTheme(): ThemeName;
+/** The palette in force; theme-aware call sites read colors through it. */
+export declare function getPalette(): ThemePalette;
+/**
+ * Parse a persisted theme name: only 'light' and 'auto' survive; anything
+ * else (missing, corrupt, or unknown) falls back to the dark default.
+ * @param value - the raw parsed JSON value (expected string).
+ * @returns a valid theme name.
+ */
+export declare function parseThemeName(value: unknown): ThemeName;
+/** Ink `color` string for one RGB triple. */
+export declare function inkColor(triple: RgbTriple): string;
 /** Paint with the primary brand blue: whale, wordmark, tool names, accents. */
 export declare function brand(text: string): string;
 /** Paint with the bright brand blue: streaming output and active spinners. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-code",
   "description": "Claude-Code-style interactive TUI bundle for DeepSeek Harness (dsh): DeepSeek-blue whale banner, live session transcript, and a blended status line",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "bin": {
     "deepseek": "./bin/deepseek.mjs",