wotann 0.5.0

package/dist/ui/theme/tokens.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Design tokens — semantic surface for the TUI.
+ *
+ * Layered on top of `src/ui/themes.ts` (the canonical 5-palette system),
+ * this module exposes a small, readable vocabulary that components can
+ * import without juggling hex colors or remembering severity/rune
+ * conventions.
+ *
+ * ── Why a second token layer? ────────────────────────────────────────
+ * `themes.ts` owns the palette graph (dark/light/sepia/...) and is
+ * already wired through `ThemeManager`. But components historically
+ * picked literal Ink color names ("cyan", "magenta", "green") and
+ * scattered glyphs ("●", "▸", "✓") inline, which made:
+ *   - The cyan signature inconsistent (some places used "cyan", others
+ *     "blue", others SEVERITY.accent — same intent, three spellings).
+ *   - Norse runic punctuation impossible to roll out without a global
+ *     find-replace.
+ *   - Status meaning leaky: "yellow" sometimes meant warning, sometimes
+ *     "muted info", sometimes just "different".
+ *
+ * This module names the intents — `tone.primary`, `tone.success`,
+ * `glyph.statusOk`, `rune.ask` — so callers describe meaning rather
+ * than ink color.
+ *
+ * ── Pull from the active palette ─────────────────────────────────────
+ * Every tone token resolves to a hex from `Palette` so theme switches
+ * (Ctrl+Y / `/theme dracula` / etc.) flow through automatically. We
+ * accept a `Palette` argument when building a token bundle so the
+ * caller can pass `themeManager.getCurrent().colors` and stay aligned
+ * with the rest of the surface.
+ *
+ * For places that don't yet thread the active theme through props, we
+ * also export `STATIC_TOKENS` — a snapshot bound to the canonical dark
+ * palette which matches the historical SEVERITY constant. Existing
+ * callers that import SEVERITY can migrate to STATIC_TOKENS without a
+ * behaviour change.
+ */
+import type { Palette } from "../themes.js";
+/**
+ * A `Tone` is a named color role. Components reference tones (e.g.
+ * `tone.success`) instead of literal Ink names so theming + visual
+ * consistency stay coupled.
+ */
+export interface Tone {
+    /** Brand accent — cyan signature, focus rings, key actions. */
+    readonly primary: string;
+    /** Muted accent — secondary buttons, inactive focus. */
+    readonly primaryMuted: string;
+    /** Default text color (inherits theme.text). */
+    readonly text: string;
+    /** Dimmed metadata text. */
+    readonly muted: string;
+    /** Border / divider color. */
+    readonly border: string;
+    /** Surface background (panels, status bar). */
+    readonly surface: string;
+    /** Info severity (neutral assistive). */
+    readonly info: string;
+    /** Success severity. */
+    readonly success: string;
+    /** Warning severity. */
+    readonly warning: string;
+    /** Error severity. */
+    readonly error: string;
+    /** Danger — same family as error but reserved for destructive cues. */
+    readonly danger: string;
+    /** Norse signature accent — used for runic glyphs and ornaments. */
+    readonly rune: string;
+}
+/** Build a `Tone` bundle from any `Palette`. */
+export declare function buildTone(palette: Palette): Tone;
+/**
+ * Status glyphs. Used by progress, agent list, dispatch inbox, etc.
+ * Pulling from one place means a status icon refresh is one edit, not
+ * 12.
+ */
+export declare const glyph: Readonly<{
+    /** Filled dot — running / active / unread. */
+    statusActive: "●";
+    /** Empty dot — idle / inactive. */
+    statusIdle: "○";
+    /** Heavy check — completed ok. */
+    statusOk: "✓";
+    /** Heavy cross — failed. */
+    statusFail: "✗";
+    /** Half-filled — in progress / partial / snoozed. */
+    statusPartial: "◐";
+    /** Quarter-filled — queued / paused. */
+    statusQueued: "◑";
+    /** Right-pointing pointer — selected row / cursor. */
+    pointer: "▸";
+    /** Diamond — assistant role badge. */
+    badgeAssistant: "◆";
+    /** Right arrow — navigation hint. */
+    arrowRight: "→";
+    /** Left arrow — back navigation. */
+    arrowLeft: "←";
+    /** Up arrow — history prev. */
+    arrowUp: "↑";
+    /** Down arrow — history next. */
+    arrowDown: "↓";
+    /** Bullet for muted lists. */
+    bullet: "·";
+    /** Vertical bar — section separator in keyhint footer. */
+    separator: "│";
+    /** Block — progress bar fill. */
+    progressFill: "█";
+    /** Light shade — progress bar empty. */
+    progressEmpty: "░";
+    /** Cursor — text input. */
+    cursorBlock: "█";
+    /** Streaming dot — animated cursor. */
+    streamingTail: "▌";
+}>;
+export type GlyphName = keyof typeof glyph;
+/**
+ * Three runic glyphs reserved as visual punctuation for WOTANN's
+ * three command modes. Used sparingly — a single rune in a banner
+ * carries the brand without crowding the layout.
+ *
+ * Mapping per CLAUDE.md:
+ *   ᚠ Fehu     — Ask / wealth / starting state
+ *   ᚱ Raidho   — Relay / journey / hand-off
+ *   ᛉ Algiz    — Autopilot / protection / autonomous
+ */
+export declare const rune: Readonly<{
+    ask: "ᚠ";
+    relay: "ᚱ";
+    autopilot: "ᛉ";
+}>;
+/**
+ * Braille spinner — preferred default. 10 frames at ~80ms gives a
+ * smooth rotating dot. Encoded as a tuple so consumers can do
+ * `frames[i % frames.length]` without rebuilding arrays.
+ */
+export declare const SPINNER_DOTS: readonly string[];
+/** Slower bullet-pulse spinner — for low-priority background hints. */
+export declare const SPINNER_PULSE: readonly string[];
+/**
+ * Vertical spacing rhythm. Ink boxes use unitless line heights; we
+ * standardize on these so panels feel consistent without one-off
+ * marginTop/marginBottom values scattered through callers.
+ */
+export declare const space: Readonly<{
+    /** Tight — used inside related elements (e.g. badge + label). */
+    tight: 0;
+    /** Single — between paragraphs in the same panel. */
+    single: 1;
+    /** Block — between major panel sections. */
+    block: 2;
+}>;
+/**
+ * Ink supports a fixed set of border styles. We standardize on rounded
+ * ("╭...") for cards/overlays and single ("─") for separator
+ * rules. Components use `border.card` rather than `borderStyle="round"`
+ * so a future migration to a richer style is a single-token swap.
+ */
+export declare const border: Readonly<{
+    /** Rounded box — overlays, panels, banners. */
+    card: "round";
+    /** Single line — internal separators, status bars. */
+    rule: "single";
+    /** Bold double — heavy callouts (errors, security). */
+    heavy: "double";
+}>;
+export type BorderToken = (typeof border)[keyof typeof border];
+/**
+ * Snapshot bundle bound to the dark palette. Components that don't yet
+ * thread the active theme through props can import these and still
+ * stay inside the token system. Matches the legacy `SEVERITY` constant.
+ */
+export declare const STATIC_TOKENS: Readonly<{
+    readonly tone: Tone;
+}>;
+/**
+ * Compose all token surfaces for the active theme. Callers that only
+ * need glyphs/runes can import them directly; components that consume
+ * tone tokens pass `palette` and get a Tone bundle aligned to the
+ * active theme.
+ */
+export interface DesignSystem {
+    readonly tone: Tone;
+    readonly glyph: typeof glyph;
+    readonly rune: typeof rune;
+    readonly space: typeof space;
+    readonly border: typeof border;
+    readonly spinner: {
+        readonly dots: readonly string[];
+        readonly pulse: readonly string[];
+    };
+}
+export declare function buildDesignSystem(palette: Palette): DesignSystem;
+/**
+ * Default design system bound to the dark palette. Stable identity so
+ * `React.memo` predicates can compare by reference.
+ */
+export declare const DEFAULT_DESIGN_SYSTEM: DesignSystem;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/ui/theme/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/ui/theme/tokens.ts"],"names":[],"mappings":"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"}

package/dist/ui/theme/tokens.js

@@ -0,0 +1,199 @@
+/**
+ * Design tokens — semantic surface for the TUI.
+ *
+ * Layered on top of `src/ui/themes.ts` (the canonical 5-palette system),
+ * this module exposes a small, readable vocabulary that components can
+ * import without juggling hex colors or remembering severity/rune
+ * conventions.
+ *
+ * ── Why a second token layer? ────────────────────────────────────────
+ * `themes.ts` owns the palette graph (dark/light/sepia/...) and is
+ * already wired through `ThemeManager`. But components historically
+ * picked literal Ink color names ("cyan", "magenta", "green") and
+ * scattered glyphs ("●", "▸", "✓") inline, which made:
+ *   - The cyan signature inconsistent (some places used "cyan", others
+ *     "blue", others SEVERITY.accent — same intent, three spellings).
+ *   - Norse runic punctuation impossible to roll out without a global
+ *     find-replace.
+ *   - Status meaning leaky: "yellow" sometimes meant warning, sometimes
+ *     "muted info", sometimes just "different".
+ *
+ * This module names the intents — `tone.primary`, `tone.success`,
+ * `glyph.statusOk`, `rune.ask` — so callers describe meaning rather
+ * than ink color.
+ *
+ * ── Pull from the active palette ─────────────────────────────────────
+ * Every tone token resolves to a hex from `Palette` so theme switches
+ * (Ctrl+Y / `/theme dracula` / etc.) flow through automatically. We
+ * accept a `Palette` argument when building a token bundle so the
+ * caller can pass `themeManager.getCurrent().colors` and stay aligned
+ * with the rest of the surface.
+ *
+ * For places that don't yet thread the active theme through props, we
+ * also export `STATIC_TOKENS` — a snapshot bound to the canonical dark
+ * palette which matches the historical SEVERITY constant. Existing
+ * callers that import SEVERITY can migrate to STATIC_TOKENS without a
+ * behaviour change.
+ */
+import { PALETTES } from "../themes.js";
+/** Build a `Tone` bundle from any `Palette`. */
+export function buildTone(palette) {
+    return {
+        primary: palette.accent,
+        primaryMuted: palette.accentMuted,
+        text: palette.text,
+        muted: palette.muted,
+        border: palette.border,
+        surface: palette.surface,
+        info: palette.info,
+        success: palette.success,
+        warning: palette.warning,
+        error: palette.error,
+        danger: palette.error,
+        // Rune defaults to the accent (cyan). Sepia/light themes still get
+        // a tonally-coherent rune color this way.
+        rune: palette.accent,
+    };
+}
+// ── Glyphs — meaning-carrying unicode characters ─────────────────────
+/**
+ * Status glyphs. Used by progress, agent list, dispatch inbox, etc.
+ * Pulling from one place means a status icon refresh is one edit, not
+ * 12.
+ */
+export const glyph = Object.freeze({
+    /** Filled dot — running / active / unread. */
+    statusActive: "●", // ●
+    /** Empty dot — idle / inactive. */
+    statusIdle: "○", // ○
+    /** Heavy check — completed ok. */
+    statusOk: "✓", // ✓
+    /** Heavy cross — failed. */
+    statusFail: "✗", // ✗
+    /** Half-filled — in progress / partial / snoozed. */
+    statusPartial: "◐", // ◐
+    /** Quarter-filled — queued / paused. */
+    statusQueued: "◑", // ◑
+    /** Right-pointing pointer — selected row / cursor. */
+    pointer: "▸", // ▸
+    /** Diamond — assistant role badge. */
+    badgeAssistant: "◆", // ◆
+    /** Right arrow — navigation hint. */
+    arrowRight: "→", // →
+    /** Left arrow — back navigation. */
+    arrowLeft: "←", // ←
+    /** Up arrow — history prev. */
+    arrowUp: "↑", // ↑
+    /** Down arrow — history next. */
+    arrowDown: "↓", // ↓
+    /** Bullet for muted lists. */
+    bullet: "·", // ·
+    /** Vertical bar — section separator in keyhint footer. */
+    separator: "│", // │
+    /** Block — progress bar fill. */
+    progressFill: "█", // █
+    /** Light shade — progress bar empty. */
+    progressEmpty: "░", // ░
+    /** Cursor — text input. */
+    cursorBlock: "█", // █
+    /** Streaming dot — animated cursor. */
+    streamingTail: "▌", // ▌
+});
+// ── Runes — Norse signature glyphs ───────────────────────────────────
+/**
+ * Three runic glyphs reserved as visual punctuation for WOTANN's
+ * three command modes. Used sparingly — a single rune in a banner
+ * carries the brand without crowding the layout.
+ *
+ * Mapping per CLAUDE.md:
+ *   ᚠ Fehu     — Ask / wealth / starting state
+ *   ᚱ Raidho   — Relay / journey / hand-off
+ *   ᛉ Algiz    — Autopilot / protection / autonomous
+ */
+export const rune = Object.freeze({
+    ask: "ᚠ", // ᚠ
+    relay: "ᚱ", // ᚱ
+    autopilot: "ᛉ", // ᛉ
+});
+// ── Spinners ──────────────────────────────────────────────────────────
+/**
+ * Braille spinner — preferred default. 10 frames at ~80ms gives a
+ * smooth rotating dot. Encoded as a tuple so consumers can do
+ * `frames[i % frames.length]` without rebuilding arrays.
+ */
+export const SPINNER_DOTS = [
+    "⠋", // ⠋
+    "⠙", // ⠙
+    "⠹", // ⠹
+    "⠸", // ⠸
+    "⠼", // ⠼
+    "⠴", // ⠴
+    "⠦", // ⠦
+    "⠧", // ⠧
+    "⠇", // ⠇
+    "⠏", // ⠏
+];
+/** Slower bullet-pulse spinner — for low-priority background hints. */
+export const SPINNER_PULSE = [
+    "·", // ·
+    "•", // •
+    "●", // ●
+    "•", // •
+];
+// ── Spacing rhythm ────────────────────────────────────────────────────
+/**
+ * Vertical spacing rhythm. Ink boxes use unitless line heights; we
+ * standardize on these so panels feel consistent without one-off
+ * marginTop/marginBottom values scattered through callers.
+ */
+export const space = Object.freeze({
+    /** Tight — used inside related elements (e.g. badge + label). */
+    tight: 0,
+    /** Single — between paragraphs in the same panel. */
+    single: 1,
+    /** Block — between major panel sections. */
+    block: 2,
+});
+// ── Border + radius preferences ──────────────────────────────────────
+/**
+ * Ink supports a fixed set of border styles. We standardize on rounded
+ * ("╭...") for cards/overlays and single ("─") for separator
+ * rules. Components use `border.card` rather than `borderStyle="round"`
+ * so a future migration to a richer style is a single-token swap.
+ */
+export const border = Object.freeze({
+    /** Rounded box — overlays, panels, banners. */
+    card: "round",
+    /** Single line — internal separators, status bars. */
+    rule: "single",
+    /** Bold double — heavy callouts (errors, security). */
+    heavy: "double",
+});
+// ── Static fallback tokens ──────────────────────────────────────────
+/**
+ * Snapshot bundle bound to the dark palette. Components that don't yet
+ * thread the active theme through props can import these and still
+ * stay inside the token system. Matches the legacy `SEVERITY` constant.
+ */
+export const STATIC_TOKENS = Object.freeze({
+    tone: buildTone(PALETTES.dark),
+});
+export function buildDesignSystem(palette) {
+    return {
+        tone: buildTone(palette),
+        glyph,
+        rune,
+        space,
+        border,
+        spinner: {
+            dots: SPINNER_DOTS,
+            pulse: SPINNER_PULSE,
+        },
+    };
+}
+/**
+ * Default design system bound to the dark palette. Stable identity so
+ * `React.memo` predicates can compare by reference.
+ */
+export const DEFAULT_DESIGN_SYSTEM = buildDesignSystem(PALETTES.dark);
+//# sourceMappingURL=tokens.js.map

package/dist/ui/theme/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../src/ui/theme/tokens.ts"],"names":[],"mappings":"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"}

package/dist/ui/themes/colorblind.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Color-blind palettes — Wave 6-OO TUI v2 Phase 2 accessibility.
+ *
+ * ── What this is ─────────────────────────────────────────────────
+ * A palette remapper that re-colours the active 5-canonical palette
+ * (`src/ui/themes.ts`) for the three most prevalent forms of colour
+ * vision deficiency:
+ *
+ *   - Protanopia    — red-blind (≈1% of males)
+ *   - Deuteranopia  — green-blind (≈1.1% of males, most common)
+ *   - Tritanopia    — blue-blind (rare, but still material)
+ *
+ * The remap targets the ROLE tokens (success/error/warning/info,
+ * the four message kinds, and the four HUD slots) rather than the
+ * neutral tokens (background/text/border) — those stay intact so
+ * the surface chrome still looks like itself.
+ *
+ * ── Why a remapper, not a 4th palette set ────────────────────────
+ * The 5-palette system (`themes.ts`) is theme-of-mood: dark, light,
+ * sepia, mono, high-contrast. Colour-blindness is independent —
+ * a deuteranope user picking the sepia theme should still get
+ * deuteran-safe accents on a sepia background. A remapper layered
+ * on top of any palette achieves that without quintuplicating the
+ * canonical palette set.
+ *
+ * ── Detection (QB#6 — honest fallback) ───────────────────────────
+ * - `WOTANN_COLOR_MODE` env var with the literal values
+ *   `protan`, `deutan`, `tritan` enables the corresponding remap.
+ * - Anything else → null mode (no remap, palette returned as-is).
+ *   We do NOT fall back to deutan when the env var is misspelled —
+ *   silent fallbacks lie to the user.
+ *
+ * ── Per-instance state (QB#7) ────────────────────────────────────
+ * `applyColorBlindMode` is a pure function. It does not cache, mutate
+ * the input palette, or carry global state. Callers thread the
+ * detected mode through their `ThemeManager` plumbing.
+ *
+ * ── Sibling-site scan (QB#11) ────────────────────────────────────
+ * The remapper preserves the `Palette` shape from `themes.ts`. It
+ * does NOT touch `theme/tokens.ts` (which adds glyph + spinner
+ * tokens) — that file already consumes a `Palette` and will inherit
+ * the remap automatically when callers pass the remapped palette to
+ * `buildTone`.
+ */
+import type { Palette } from "../themes.js";
+/** Supported colour-blind modes. `null` means "no remap". */
+export type ColorBlindMode = "protan" | "deutan" | "tritan";
+/**
+ * Resolve the active mode from env. Returns null when the env var
+ * is unset or contains a value we do not recognise — strict
+ * equality, no fuzzy matching.
+ */
+export declare function detectColorBlindMode(env?: NodeJS.ProcessEnv): ColorBlindMode | null;
+/**
+ * Apply a colour-blind remap to a palette.
+ *
+ * Returns a NEW palette object — the input is never mutated
+ * (immutability bar). When `mode` is null, the input palette is
+ * returned as-is so callers can use this unconditionally:
+ *
+ *   const palette = applyColorBlindMode(theme.colors, detectColorBlindMode());
+ *
+ * Pure, deterministic, no I/O.
+ */
+export declare function applyColorBlindMode<P extends Palette>(palette: P, mode: ColorBlindMode | null): P;
+/**
+ * Convenience wrapper — read env, then apply.
+ */
+export declare function applyEnvColorBlindMode<P extends Palette>(palette: P, env?: NodeJS.ProcessEnv): P;
+/** Internal — exported for tests to assert per-mode coverage. */
+export declare const __REMAP_TABLES_FOR_TEST: Readonly<Record<ColorBlindMode, Partial<Record<keyof Palette, string>>>>;
+/** Internal — supported env values exposed for tests. */
+export declare const __SUPPORTED_ENV_VALUES_FOR_TEST: string[];
+//# sourceMappingURL=colorblind.d.ts.map

package/dist/ui/themes/colorblind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorblind.d.ts","sourceRoot":"","sources":["../../../src/ui/themes/colorblind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAI5C,6DAA6D;AAC7D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAc5D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,cAAc,GAAG,IAAI,CAIhG;AAwED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,GAAG,CAAC,CAMjG;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,OAAO,EACtD,OAAO,EAAE,CAAC,EACV,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,CAAC,CAEH;AAID,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,0EAAe,CAAC;AACpD,yDAAyD;AACzD,eAAO,MAAM,+BAA+B,UAAqC,CAAC"}

package/dist/ui/themes/colorblind.js

@@ -0,0 +1,162 @@
+/**
+ * Color-blind palettes — Wave 6-OO TUI v2 Phase 2 accessibility.
+ *
+ * ── What this is ─────────────────────────────────────────────────
+ * A palette remapper that re-colours the active 5-canonical palette
+ * (`src/ui/themes.ts`) for the three most prevalent forms of colour
+ * vision deficiency:
+ *
+ *   - Protanopia    — red-blind (≈1% of males)
+ *   - Deuteranopia  — green-blind (≈1.1% of males, most common)
+ *   - Tritanopia    — blue-blind (rare, but still material)
+ *
+ * The remap targets the ROLE tokens (success/error/warning/info,
+ * the four message kinds, and the four HUD slots) rather than the
+ * neutral tokens (background/text/border) — those stay intact so
+ * the surface chrome still looks like itself.
+ *
+ * ── Why a remapper, not a 4th palette set ────────────────────────
+ * The 5-palette system (`themes.ts`) is theme-of-mood: dark, light,
+ * sepia, mono, high-contrast. Colour-blindness is independent —
+ * a deuteranope user picking the sepia theme should still get
+ * deuteran-safe accents on a sepia background. A remapper layered
+ * on top of any palette achieves that without quintuplicating the
+ * canonical palette set.
+ *
+ * ── Detection (QB#6 — honest fallback) ───────────────────────────
+ * - `WOTANN_COLOR_MODE` env var with the literal values
+ *   `protan`, `deutan`, `tritan` enables the corresponding remap.
+ * - Anything else → null mode (no remap, palette returned as-is).
+ *   We do NOT fall back to deutan when the env var is misspelled —
+ *   silent fallbacks lie to the user.
+ *
+ * ── Per-instance state (QB#7) ────────────────────────────────────
+ * `applyColorBlindMode` is a pure function. It does not cache, mutate
+ * the input palette, or carry global state. Callers thread the
+ * detected mode through their `ThemeManager` plumbing.
+ *
+ * ── Sibling-site scan (QB#11) ────────────────────────────────────
+ * The remapper preserves the `Palette` shape from `themes.ts`. It
+ * does NOT touch `theme/tokens.ts` (which adds glyph + spinner
+ * tokens) — that file already consumes a `Palette` and will inherit
+ * the remap automatically when callers pass the remapped palette to
+ * `buildTone`.
+ */
+/** Strict env values that opt into a mode. */
+const COLOR_MODE_ENV_VALUES = {
+    protan: "protan",
+    deutan: "deutan",
+    tritan: "tritan",
+};
+/** Env var that selects the mode. */
+const ENV_VAR = "WOTANN_COLOR_MODE";
+// ── Detection ────────────────────────────────────────────────────────
+/**
+ * Resolve the active mode from env. Returns null when the env var
+ * is unset or contains a value we do not recognise — strict
+ * equality, no fuzzy matching.
+ */
+export function detectColorBlindMode(env = process.env) {
+    const raw = env[ENV_VAR];
+    if (typeof raw !== "string")
+        return null;
+    return COLOR_MODE_ENV_VALUES[raw] ?? null;
+}
+// ── Remap tables ─────────────────────────────────────────────────────
+/**
+ * Per-mode role-colour overrides. We swap the primary indicators
+ * for ones distinguishable under each deficiency. References:
+ *
+ *   - "ColorBrewer" / Wong's Nature Methods palette (2011)
+ *   - The "Okabe-Ito" colour-blind safe set (2008)
+ *
+ * These hexes are well-trodden and play nicely with each other on
+ * dark and light backgrounds.
+ */
+const REMAP_TABLES = {
+    // Protanopia — red appears dim/dark. Replace red→orange,
+    // shift accent away from red-leaning hues.
+    protan: {
+        error: "#e69f00", // Okabe-Ito orange
+        warning: "#f0e442", // Okabe-Ito yellow
+        success: "#0072b2", // Okabe-Ito blue (keeps "good = blue" mental model)
+        info: "#56b4e9", // Okabe-Ito sky-blue
+        accent: "#0072b2",
+        accentMuted: "#005a8a",
+        userMessage: "#56b4e9",
+        assistantMessage: "#0072b2",
+        systemMessage: "#f0e442",
+        toolMessage: "#cc79a7", // Okabe-Ito reddish-purple
+        hudGreen: "#0072b2",
+        hudYellow: "#f0e442",
+        hudOrange: "#e69f00",
+        hudRed: "#cc79a7",
+    },
+    // Deuteranopia — green appears dim/dark. Most common form.
+    // Use the canonical Okabe-Ito set: orange/blue/yellow/sky.
+    deutan: {
+        error: "#d55e00", // Okabe-Ito vermillion
+        warning: "#f0e442",
+        success: "#0072b2", // blue stands in for green
+        info: "#56b4e9",
+        accent: "#0072b2",
+        accentMuted: "#005a8a",
+        userMessage: "#56b4e9",
+        assistantMessage: "#0072b2",
+        systemMessage: "#f0e442",
+        toolMessage: "#cc79a7",
+        hudGreen: "#0072b2",
+        hudYellow: "#f0e442",
+        hudOrange: "#d55e00",
+        hudRed: "#cc79a7",
+    },
+    // Tritanopia — blue/yellow confusion. Use red/green/teal mapping.
+    tritan: {
+        error: "#d55e00", // vermillion (high contrast)
+        warning: "#cc79a7", // reddish-purple replaces yellow
+        success: "#009e73", // bluish-green stays distinguishable
+        info: "#e69f00", // orange replaces sky-blue
+        accent: "#009e73",
+        accentMuted: "#007a59",
+        userMessage: "#e69f00",
+        assistantMessage: "#009e73",
+        systemMessage: "#cc79a7",
+        toolMessage: "#d55e00",
+        hudGreen: "#009e73",
+        hudYellow: "#cc79a7",
+        hudOrange: "#e69f00",
+        hudRed: "#d55e00",
+    },
+};
+// ── Public remapper ──────────────────────────────────────────────────
+/**
+ * Apply a colour-blind remap to a palette.
+ *
+ * Returns a NEW palette object — the input is never mutated
+ * (immutability bar). When `mode` is null, the input palette is
+ * returned as-is so callers can use this unconditionally:
+ *
+ *   const palette = applyColorBlindMode(theme.colors, detectColorBlindMode());
+ *
+ * Pure, deterministic, no I/O.
+ */
+export function applyColorBlindMode(palette, mode) {
+    if (mode === null)
+        return palette;
+    const overrides = REMAP_TABLES[mode];
+    // Merge into a fresh object — preserve any extra keys callers
+    // attached (e.g. ThemeColors adds primary/secondary/textDim).
+    return { ...palette, ...overrides };
+}
+/**
+ * Convenience wrapper — read env, then apply.
+ */
+export function applyEnvColorBlindMode(palette, env = process.env) {
+    return applyColorBlindMode(palette, detectColorBlindMode(env));
+}
+// ── Test helpers ─────────────────────────────────────────────────────
+/** Internal — exported for tests to assert per-mode coverage. */
+export const __REMAP_TABLES_FOR_TEST = REMAP_TABLES;
+/** Internal — supported env values exposed for tests. */
+export const __SUPPORTED_ENV_VALUES_FOR_TEST = Object.keys(COLOR_MODE_ENV_VALUES);
+//# sourceMappingURL=colorblind.js.map

package/dist/ui/themes/colorblind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorblind.js","sourceRoot":"","sources":["../../../src/ui/themes/colorblind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AASH,8CAA8C;AAC9C,MAAM,qBAAqB,GAA6C;IACtE,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF,qCAAqC;AACrC,MAAM,OAAO,GAAG,mBAAmB,CAAC;AAEpC,wEAAwE;AAExE;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACvE,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;IACzB,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,qBAAqB,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;AAC5C,CAAC;AAED,wEAAwE;AAExE;;;;;;;;;GASG;AACH,MAAM,YAAY,GAA6E;IAC7F,yDAAyD;IACzD,2CAA2C;IAC3C,MAAM,EAAE;QACN,KAAK,EAAE,SAAS,EAAE,mBAAmB;QACrC,OAAO,EAAE,SAAS,EAAE,mBAAmB;QACvC,OAAO,EAAE,SAAS,EAAE,oDAAoD;QACxE,IAAI,EAAE,SAAS,EAAE,qBAAqB;QACtC,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,SAAS;QACtB,gBAAgB,EAAE,SAAS;QAC3B,aAAa,EAAE,SAAS;QACxB,WAAW,EAAE,SAAS,EAAE,2BAA2B;QACnD,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;QACpB,MAAM,EAAE,SAAS;KAClB;IACD,2DAA2D;IAC3D,2DAA2D;IAC3D,MAAM,EAAE;QACN,KAAK,EAAE,SAAS,EAAE,uBAAuB;QACzC,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,SAAS,EAAE,2BAA2B;QAC/C,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,SAAS;QACtB,gBAAgB,EAAE,SAAS;QAC3B,aAAa,EAAE,SAAS;QACxB,WAAW,EAAE,SAAS;QACtB,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;QACpB,MAAM,EAAE,SAAS;KAClB;IACD,kEAAkE;IAClE,MAAM,EAAE;QACN,KAAK,EAAE,SAAS,EAAE,6BAA6B;QAC/C,OAAO,EAAE,SAAS,EAAE,iCAAiC;QACrD,OAAO,EAAE,SAAS,EAAE,qCAAqC;QACzD,IAAI,EAAE,SAAS,EAAE,2BAA2B;QAC5C,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,SAAS;QACtB,gBAAgB,EAAE,SAAS;QAC3B,aAAa,EAAE,SAAS;QACxB,WAAW,EAAE,SAAS;QACtB,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;QACpB,MAAM,EAAE,SAAS;KAClB;CACF,CAAC;AAEF,wEAAwE;AAExE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAoB,OAAU,EAAE,IAA2B;IAC5F,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC;IAClC,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACrC,8DAA8D;IAC9D,8DAA8D;IAC9D,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,SAAS,EAAO,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAU,EACV,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,wEAAwE;AAExE,iEAAiE;AACjE,MAAM,CAAC,MAAM,uBAAuB,GAAG,YAAY,CAAC;AACpD,yDAAyD;AACzD,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC"}