@chances-ai/ui-core 24.0.0 → 24.2.0

package/dist/theme/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * (7.3 / task 03 — W0) The seed token-engine barrel. The public `../theme.js`
+ * (TUI palette) + `../web-theme.js` (CSS vars) are thin back-compat shims over
+ * this. Pure / browser-safe.
+ */
+export * from "./color.js";
+export * from "./contrast.js";
+export type { HexColor, OklchColor, ColorValue, ThemeSeeds, ChancesThemeVariant, ChancesTheme } from "./schema.js";
+export { parseCustomTheme } from "./schema.js";
+export type { ChancesTokenName, ChancesTokens, TuiRole, WebChromeToken } from "./tokens.js";
+export { TUI_ROLES, WEB_CHROME_TOKENS, ALL_TOKENS, TOKEN_GROUPS } from "./tokens.js";
+export { resolveThemeVariant } from "./resolve.js";
+export { toTuiTheme, toCssVars, kebab } from "./project.js";
+export { BUILTIN_THEMES, DEFAULT_THEME, DALTONIZED_THEME, ANSI_THEME } from "./builtins.js";
+import type { ChancesTheme } from "./schema.js";
+import type { ChancesTokens } from "./tokens.js";
+export type ThemeMode = "dark" | "light";
+/** Resolve a built-in (by id) or custom theme + mode → the full token set. */
+export declare function resolveThemeTokens(theme: ChancesTheme | string, mode: ThemeMode): ChancesTokens;
+/** The expanded theme-selection setting (config / `/theme`). `auto`/`dark`/`light`
+ *  target the `default` theme; the daltonized/ansi variants target their theme. */
+export type ThemeSettingId = "auto" | "dark" | "light" | "daltonized" | "dark-daltonized" | "light-daltonized" | "ansi" | "dark-ansi" | "light-ansi";
+/** Parse a setting into `{ themeId, mode }`. `auto` → default/dark (terminal-bg
+ *  detection is a later lever); unknown → default/dark. */
+export declare function parseThemeSetting(setting: string | undefined): {
+    themeId: string;
+    mode: ThemeMode;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/theme/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzC,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,aAAa,CAG/F;AAED;mFACmF;AACnF,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,MAAM,GACN,OAAO,GACP,YAAY,GACZ,iBAAiB,GACjB,kBAAkB,GAClB,MAAM,GACN,WAAW,GACX,YAAY,CAAC;AAEjB;2DAC2D;AAC3D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAmBnG"}

package/dist/theme/index.js

@@ -0,0 +1,42 @@
+/**
+ * (7.3 / task 03 — W0) The seed token-engine barrel. The public `../theme.js`
+ * (TUI palette) + `../web-theme.js` (CSS vars) are thin back-compat shims over
+ * this. Pure / browser-safe.
+ */
+export * from "./color.js";
+export * from "./contrast.js";
+export { parseCustomTheme } from "./schema.js";
+export { TUI_ROLES, WEB_CHROME_TOKENS, ALL_TOKENS, TOKEN_GROUPS } from "./tokens.js";
+export { resolveThemeVariant } from "./resolve.js";
+export { toTuiTheme, toCssVars, kebab } from "./project.js";
+export { BUILTIN_THEMES, DEFAULT_THEME, DALTONIZED_THEME, ANSI_THEME } from "./builtins.js";
+import { BUILTIN_THEMES } from "./builtins.js";
+import { resolveThemeVariant } from "./resolve.js";
+/** Resolve a built-in (by id) or custom theme + mode → the full token set. */
+export function resolveThemeTokens(theme, mode) {
+    const t = typeof theme === "string" ? (BUILTIN_THEMES[theme] ?? BUILTIN_THEMES.default) : theme;
+    return resolveThemeVariant(mode === "dark" ? t.dark : t.light, mode === "dark");
+}
+/** Parse a setting into `{ themeId, mode }`. `auto` → default/dark (terminal-bg
+ *  detection is a later lever); unknown → default/dark. */
+export function parseThemeSetting(setting) {
+    switch (setting) {
+        case "light":
+            return { themeId: "default", mode: "light" };
+        case "daltonized":
+        case "dark-daltonized":
+            return { themeId: "daltonized", mode: "dark" };
+        case "light-daltonized":
+            return { themeId: "daltonized", mode: "light" };
+        case "ansi":
+        case "dark-ansi":
+            return { themeId: "ansi", mode: "dark" };
+        case "light-ansi":
+            return { themeId: "ansi", mode: "light" };
+        case "dark":
+        case "auto":
+        default:
+            return { themeId: "default", mode: "dark" };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/theme/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAE9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAI5F,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAInD,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB,CAAC,KAA4B,EAAE,IAAe;IAC9E,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,OAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACjG,OAAO,mBAAmB,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC;AAClF,CAAC;AAeD;2DAC2D;AAC3D,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC/C,KAAK,YAAY,CAAC;QAClB,KAAK,iBAAiB;YACpB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACjD,KAAK,kBAAkB;YACrB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAClD,KAAK,MAAM,CAAC;QACZ,KAAK,WAAW;YACd,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC3C,KAAK,YAAY;YACf,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC5C,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/theme/project.d.ts

@@ -0,0 +1,14 @@
+import type { ChancesTokens, TuiRole } from "./tokens.js";
+/** Project resolved tokens → the 23 TUI roles (the legacy `Theme` shape). Keys
+ *  are `TuiRole` which === the `Theme` field names, so the result is assignable
+ *  to `Theme` (all fields optional). */
+export declare function toTuiTheme(tokens: ChancesTokens): Record<TuiRole, string>;
+/** camelCase token name → kebab CSS-var suffix (`diffAddedBg` → `diff-added-bg`).
+ *  Matches the legacy `web-theme.ts` deriver so `--ch-*` names are unchanged. */
+export declare function kebab(s: string): string;
+/** Project resolved tokens → `--ch-*` CSS custom properties (the whole set).
+ *  Hex values are emitted as `rgb(r,g,b)` so each `--ch-*` is VALUE-IDENTICAL to
+ *  the TUI projection (true single source — the web-theme test asserts this);
+ *  `var(--…)` passes through. Spread onto an element's inline `style`. */
+export declare function toCssVars(tokens: ChancesTokens): Record<`--${string}`, string>;
+//# sourceMappingURL=project.d.ts.map

package/dist/theme/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/theme/project.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAa1D;;wCAEwC;AACxC,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAIzE;AAED;iFACiF;AACjF,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvC;AAED;;;0EAG0E;AAC1E,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,KAAK,MAAM,EAAE,EAAE,MAAM,CAAC,CAM9E"}

package/dist/theme/project.js

@@ -0,0 +1,37 @@
+import { TUI_ROLES } from "./tokens.js";
+import { hexToRgbString } from "./color.js";
+/** A token value as the TUI consumes it: `#hex` → `rgb(r,g,b)`; `ansi:<name>`
+ *  passes through (the TUI shim maps it to chalk's named ANSI); `var(--…)` is
+ *  not meaningful on the TUI and passes through unchanged (web-only themes never
+ *  reach here). */
+function tuiValue(v) {
+    if (v.startsWith("#"))
+        return hexToRgbString(v);
+    return v; // ansi:… or var(…)
+}
+/** Project resolved tokens → the 23 TUI roles (the legacy `Theme` shape). Keys
+ *  are `TuiRole` which === the `Theme` field names, so the result is assignable
+ *  to `Theme` (all fields optional). */
+export function toTuiTheme(tokens) {
+    const out = {};
+    for (const role of TUI_ROLES)
+        out[role] = tuiValue(tokens[role]);
+    return out;
+}
+/** camelCase token name → kebab CSS-var suffix (`diffAddedBg` → `diff-added-bg`).
+ *  Matches the legacy `web-theme.ts` deriver so `--ch-*` names are unchanged. */
+export function kebab(s) {
+    return s.replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`);
+}
+/** Project resolved tokens → `--ch-*` CSS custom properties (the whole set).
+ *  Hex values are emitted as `rgb(r,g,b)` so each `--ch-*` is VALUE-IDENTICAL to
+ *  the TUI projection (true single source — the web-theme test asserts this);
+ *  `var(--…)` passes through. Spread onto an element's inline `style`. */
+export function toCssVars(tokens) {
+    const vars = {};
+    for (const [name, value] of Object.entries(tokens)) {
+        vars[`--ch-${kebab(name)}`] = value.startsWith("#") ? hexToRgbString(value) : value;
+    }
+    return vars;
+}
+//# sourceMappingURL=project.js.map

package/dist/theme/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/theme/project.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;;mBAGmB;AACnB,SAAS,QAAQ,CAAC,CAAa;IAC7B,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,cAAc,CAAC,CAAiB,CAAC,CAAC;IAChE,OAAO,CAAC,CAAC,CAAC,mBAAmB;AAC/B,CAAC;AAED;;wCAEwC;AACxC,MAAM,UAAU,UAAU,CAAC,MAAqB;IAC9C,MAAM,GAAG,GAAG,EAA6B,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,SAAS;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,OAAO,GAAG,CAAC;AACb,CAAC;AAED;iFACiF;AACjF,MAAM,UAAU,KAAK,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED;;;0EAG0E;AAC1E,MAAM,UAAU,SAAS,CAAC,MAAqB;IAC7C,MAAM,IAAI,GAAkC,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,KAAqB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACtG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/theme/resolve.d.ts

@@ -0,0 +1,11 @@
+/**
+ * (7.3 / task 03 — W0) The role-map: a theme variant (9 seeds + 3 optional
+ * expressive seeds + overrides) → ~68 resolved tokens `[11.4]`. Adapts opencode's
+ * `resolveThemeVariant` step choices, curated to chances' token set. Every token
+ * is derived from a seed scale; `overrides` win LAST (the `default` theme pins
+ * the 23 TUI roles + surface anchors there ⇒ zero TUI regression). Pure.
+ */
+import type { ChancesThemeVariant } from "./schema.js";
+import type { ChancesTokens } from "./tokens.js";
+export declare function resolveThemeVariant(variant: ChancesThemeVariant, isDark: boolean): ChancesTokens;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/theme/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/theme/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAoC,MAAM,aAAa,CAAC;AACzF,OAAO,KAAK,EAAoB,aAAa,EAAE,MAAM,aAAa,CAAC;AAgBnE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,OAAO,GAAG,aAAa,CA6IhG"}

package/dist/theme/resolve.js

@@ -0,0 +1,152 @@
+import { generateNeutralScale, generateScale, hexToOklch, shift } from "./color.js";
+import { on } from "./contrast.js";
+/** Target OKLCH hues (deg) for the discrete brand colors when a theme does NOT
+ *  supply explicit expressive seeds. Chosen to land teal / violet / pink and to
+ *  stay Δh-distinct from each other (gate in engine.test.ts). */
+const DISCRETE_HUE = { planMode: 175, autoAccept: 300, bashPink: 350 };
+function deriveDiscrete(seed, fallbackFrom, targetHue, isDark) {
+    if (seed)
+        return seed;
+    // Rotate the fallback seed to the target hue, keep a vivid, mid chroma/lightness.
+    const base = hexToOklch(fallbackFrom);
+    return shift(fallbackFrom, { h: targetHue - base.h, c: 1.0, l: isDark ? 0.06 : -0.04 });
+}
+export function resolveThemeVariant(variant, isDark) {
+    const s = variant.seeds;
+    const neutral = generateNeutralScale(s.neutral, isDark);
+    const primary = generateScale(s.primary, isDark);
+    const success = generateScale(s.success, isDark);
+    const warning = generateScale(s.warning, isDark);
+    const error = generateScale(s.error, isDark);
+    const info = generateScale(s.info, isDark);
+    const interactive = generateScale(s.interactive, isDark);
+    const diffAdd = generateScale(s.diffAdd, isDark);
+    const diffDelete = generateScale(s.diffDelete, isDark);
+    // A vivid text-level value off a scale (opencode `content`): brightest end + a
+    // small chroma/lightness nudge so it reads on the base background.
+    const content = (scale) => shift(scale[10], { l: isDark ? 0.034 : -0.024, c: isDark ? 1.3 : 1.18 });
+    const planMode = deriveDiscrete(s.planMode, s.info, DISCRETE_HUE.planMode, isDark);
+    const autoAccept = deriveDiscrete(s.autoAccept, s.interactive, DISCRETE_HUE.autoAccept, isDark);
+    const bashPink = deriveDiscrete(s.bashPink, s.error, DISCRETE_HUE.bashPink, isDark);
+    const accent = primary[isDark ? 7 : 8];
+    const successC = success[6];
+    const errorC = error[isDark ? 6 : 9];
+    const warningC = warning[isDark ? 6 : 6];
+    // The general action color (HeroUI `--accent` family): the same mid step (l≈0.58
+    // in both modes, the HeroUI `--accent` sweet spot) used by borderFocus/Selected,
+    // so it stays visible on the bg AND `on()` keeps button text legible. Verified
+    // ≥ AA-large vs bg across every built-in theme × mode (engine.test).
+    const interactiveC = interactive[8];
+    const t = {
+        // -- brand (23 TUI roles) --
+        accent,
+        success: successC,
+        error: errorC,
+        warning: warningC,
+        permission: info[isDark ? 7 : 5],
+        planMode,
+        autoAccept,
+        bashPink,
+        stall: shift(s.error, { l: isDark ? -0.12 : -0.1, c: 1.0 }),
+        userMessageBg: neutral[isDark ? 1 : 2],
+        // -- diff line/word backgrounds --
+        diffAddedBg: diffAdd[isDark ? 1 : 9],
+        diffRemovedBg: diffDelete[isDark ? 1 : 9],
+        diffAddedWordBg: diffAdd[isDark ? 3 : 7],
+        diffRemovedWordBg: diffDelete[isDark ? 3 : 7],
+        // -- syntax (9) --
+        synKeyword: content(info),
+        synString: content(success),
+        synComment: neutral[isDark ? 6 : 7],
+        synNumber: content(warning),
+        synFunction: content(interactive),
+        synType: content(warning),
+        synLiteral: content(diffAdd),
+        synTitle: content(interactive),
+        synAttr: content(warning),
+        // -- backgrounds / surfaces --
+        bgBase: neutral[0],
+        bgWeak: neutral[1],
+        bgStrong: isDark ? neutral[1] : neutral[0],
+        surfaceBase: neutral[1],
+        surfaceRaised: neutral[2],
+        surfaceInset: neutral[0],
+        surfaceHover: neutral[2],
+        surfaceActive: neutral[3],
+        // -- text --
+        textBase: neutral[10],
+        textWeak: neutral[8],
+        textWeaker: neutral[7],
+        textStrong: neutral[11],
+        // -- borders --
+        borderBase: neutral[isDark ? 4 : 6],
+        borderWeak: neutral[isDark ? 3 : 5],
+        borderStrong: neutral[isDark ? 6 : 7],
+        borderFocus: interactive[8],
+        borderSelected: interactive[8],
+        // -- inputs --
+        inputBase: isDark ? neutral[1] : neutral[0],
+        inputHover: neutral[2],
+        inputFocus: interactive[6],
+        inputDisabled: neutral[3],
+        // -- icons --
+        iconBase: neutral[9],
+        iconWeak: neutral[6],
+        iconStrong: neutral[11],
+        iconDisabled: neutral[isDark ? 5 : 6],
+        // -- buttons --
+        buttonPrimary: neutral[11],
+        buttonSecondary: isDark ? neutral[2] : neutral[0],
+        buttonGhostHover: neutral[2],
+        // -- action / interactive (HeroUI `--accent` family) --
+        interactive: interactiveC,
+        // -- diff surfaces / change-bar --
+        diffAddSurface: diffAdd[2],
+        diffDeleteSurface: diffDelete[2],
+        diffChangeBarAdd: diffAdd[isDark ? 7 : 6],
+        diffChangeBarDelete: diffDelete[isDark ? 7 : 6],
+        diffChangeBarModified: warning[isDark ? 7 : 6],
+        // -- markdown --
+        mdHeading: content(primary),
+        mdLink: content(interactive),
+        mdCode: content(success),
+        mdQuote: content(warning),
+        mdStrong: content(primary),
+        mdEmph: content(warning),
+        // -- state-on (computed from the resolved fills) --
+        textOnAccent: on(accent),
+        textOnSuccess: on(successC),
+        textOnError: on(errorC),
+        textOnWarning: on(warningC),
+        textOnInteractive: on(interactiveC),
+    };
+    // Overrides win last (pinning).
+    if (variant.overrides) {
+        for (const [k, v] of Object.entries(variant.overrides)) {
+            t[k] = v;
+        }
+    }
+    // (codex R2 MUST) The state-on foregrounds must legibly contrast the FINAL
+    // fills, so recompute them AFTER overrides. The `default` theme pins
+    // accent/success/error/warning to legacy RGB, and `on()` run on the
+    // pre-override (generated) fill could pick the wrong black/white (e.g. white
+    // on the pinned light success → ~2.5:1, sub-WCAG). Skip when the fill isn't a
+    // hex (the ansi theme's `ansi:<name>` fills are TUI-only, never read on the
+    // web) or when the theme gave an explicit `textOn*` override.
+    const STATE_ON = [
+        ["textOnAccent", "accent"],
+        ["textOnSuccess", "success"],
+        ["textOnError", "error"],
+        ["textOnWarning", "warning"],
+        ["textOnInteractive", "interactive"],
+    ];
+    for (const [onToken, fillToken] of STATE_ON) {
+        if (variant.overrides && onToken in variant.overrides)
+            continue;
+        const fill = t[fillToken];
+        if (typeof fill === "string" && fill.startsWith("#"))
+            t[onToken] = on(fill);
+    }
+    return t;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/theme/resolve.js.map

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

package/dist/theme/schema.d.ts

@@ -0,0 +1,60 @@
+/**
+ * (7.3 / task 03 — W0) Seed-theme types + a dependency-free validator for
+ * user/custom themes. 9 semantic seeds + 3 optional "expressive" seeds (plan/
+ * accept/bash discrete hues) `[11.4]`. Mirrors opencode's `ThemeSeedColors` +
+ * `desktop-theme.schema.json` shape, trimmed to chances' needs. Pure; no `node:*`,
+ * no `zod` (ui-core keeps a minimal dep set — hand-rolled validation instead).
+ */
+import { type ChancesTokenName } from "./tokens.js";
+/** `#rgb` / `#rgba` / `#rrggbb` / `#rrggbbaa`. */
+export type HexColor = `#${string}`;
+/** A token value: a hex color, an `ansi:<name>` (TUI 16-color), or a `var(--…)` ref. */
+export type ColorValue = HexColor | `ansi:${string}` | `var(--${string})`;
+export interface OklchColor {
+    /** Lightness 0–1. */
+    l: number;
+    /** Chroma 0–~0.4. */
+    c: number;
+    /** Hue 0–360. */
+    h: number;
+}
+/** The 9 semantic seeds (+3 optional discrete-hue seeds). A theme variant
+ *  (light or dark) is fully described by these + an optional override map. */
+export interface ThemeSeeds {
+    neutral: HexColor;
+    primary: HexColor;
+    success: HexColor;
+    warning: HexColor;
+    error: HexColor;
+    info: HexColor;
+    interactive: HexColor;
+    diffAdd: HexColor;
+    diffDelete: HexColor;
+    /** Discrete visual facts; omitted ⇒ derived via the documented shift formula
+     *  (with a Δh gate, see resolve.ts / engine.test.ts). */
+    planMode?: HexColor;
+    autoAccept?: HexColor;
+    bashPink?: HexColor;
+}
+export interface ChancesThemeVariant {
+    seeds: ThemeSeeds;
+    /** Pin specific resolved tokens to exact values (opencode `overrides`). The
+     *  built-in `default` theme uses this to pin every claude-code visual-language
+     *  role to today's RGB ⇒ zero TUI regression (7.3 §2.5). */
+    overrides?: Partial<Record<ChancesTokenName, ColorValue>>;
+}
+export interface ChancesTheme {
+    /** Slug `^[a-z0-9-]+$`. */
+    id: string;
+    /** Human-readable name. */
+    name: string;
+    light: ChancesThemeVariant;
+    dark: ChancesThemeVariant;
+    /** Which surfaces this theme is offered on (e.g. `ansi` is TUI-only). Default
+     *  = both. */
+    surfaces?: ("tui" | "web")[];
+}
+/** Parse + validate a user theme JSON (from `~/.chances/themes/<id>.json`).
+ *  Throws a descriptive Error on any malformed field. */
+export declare function parseCustomTheme(json: unknown): ChancesTheme;
+//# sourceMappingURL=schema.d.ts.map

package/dist/theme/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/theme/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEhE,kDAAkD;AAClD,MAAM,MAAM,QAAQ,GAAG,IAAI,MAAM,EAAE,CAAC;AACpC,wFAAwF;AACxF,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,MAAM,EAAE,GAAG,SAAS,MAAM,GAAG,CAAC;AAE1E,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,qBAAqB;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,iBAAiB;IACjB,CAAC,EAAE,MAAM,CAAC;CACX;AAED;8EAC8E;AAC9E,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,QAAQ,CAAC;IAClB,OAAO,EAAE,QAAQ,CAAC;IAClB,OAAO,EAAE,QAAQ,CAAC;IAClB,OAAO,EAAE,QAAQ,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,QAAQ,CAAC;IACtB,OAAO,EAAE,QAAQ,CAAC;IAClB,UAAU,EAAE,QAAQ,CAAC;IACrB;6DACyD;IACzD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,UAAU,CAAC;IAClB;;gEAE4D;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,mBAAmB,CAAC;IAC3B,IAAI,EAAE,mBAAmB,CAAC;IAC1B;kBACc;IACd,QAAQ,CAAC,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,EAAE,CAAC;CAC9B;AAqDD;yDACyD;AACzD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,CAc5D"}

package/dist/theme/schema.js

@@ -0,0 +1,81 @@
+/**
+ * (7.3 / task 03 — W0) Seed-theme types + a dependency-free validator for
+ * user/custom themes. 9 semantic seeds + 3 optional "expressive" seeds (plan/
+ * accept/bash discrete hues) `[11.4]`. Mirrors opencode's `ThemeSeedColors` +
+ * `desktop-theme.schema.json` shape, trimmed to chances' needs. Pure; no `node:*`,
+ * no `zod` (ui-core keeps a minimal dep set — hand-rolled validation instead).
+ */
+import { ALL_TOKENS } from "./tokens.js";
+const HEX = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+// (codex R2 MUST) hex branch must match HEX exactly — `{3,8}` wrongly accepted
+// invalid 5/7-digit hex (`#12345`), which then leaked into `--ch-*` vars.
+const COLOR_VALUE = /^(#([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})|ansi:[a-zA-Z]+|var\(--[a-z0-9-]+\))$/;
+/** Every valid override key — an unknown key would be copied verbatim by
+ *  `resolveThemeVariant` and emitted as an arbitrary `--ch-*` var (codex R2 MUST). */
+const TOKEN_NAMES = new Set(ALL_TOKENS);
+const REQUIRED_SEEDS = [
+    "neutral",
+    "primary",
+    "success",
+    "warning",
+    "error",
+    "info",
+    "interactive",
+    "diffAdd",
+    "diffDelete",
+];
+function isHex(v) {
+    return typeof v === "string" && HEX.test(v);
+}
+function validateVariant(v, where) {
+    if (typeof v !== "object" || v === null)
+        throw new Error(`${where}: expected an object`);
+    const seeds = v.seeds;
+    if (typeof seeds !== "object" || seeds === null)
+        throw new Error(`${where}.seeds: expected an object`);
+    for (const k of REQUIRED_SEEDS) {
+        if (!isHex(seeds[k])) {
+            throw new Error(`${where}.seeds.${k}: expected a hex color (got ${JSON.stringify(seeds[k])})`);
+        }
+    }
+    for (const k of ["planMode", "autoAccept", "bashPink"]) {
+        const val = seeds[k];
+        if (val !== undefined && !isHex(val))
+            throw new Error(`${where}.seeds.${k}: expected a hex color or omitted`);
+    }
+    const overrides = v.overrides;
+    if (overrides !== undefined) {
+        if (typeof overrides !== "object" || overrides === null)
+            throw new Error(`${where}.overrides: expected an object`);
+        for (const [k, val] of Object.entries(overrides)) {
+            if (!TOKEN_NAMES.has(k)) {
+                throw new Error(`${where}.overrides.${k}: unknown token (must be a ChancesTokenName)`);
+            }
+            if (typeof val !== "string" || !COLOR_VALUE.test(val)) {
+                throw new Error(`${where}.overrides.${k}: expected a hex / ansi: / var(--…) color (got ${JSON.stringify(val)})`);
+            }
+        }
+    }
+    return v;
+}
+/** Parse + validate a user theme JSON (from `~/.chances/themes/<id>.json`).
+ *  Throws a descriptive Error on any malformed field. */
+export function parseCustomTheme(json) {
+    if (typeof json !== "object" || json === null)
+        throw new Error("theme: expected an object");
+    const t = json;
+    if (typeof t.id !== "string" || !/^[a-z0-9-]+$/.test(t.id))
+        throw new Error("theme.id: expected a slug ^[a-z0-9-]+$");
+    if (typeof t.name !== "string" || t.name.length === 0)
+        throw new Error("theme.name: expected a non-empty string");
+    const light = validateVariant(t.light, "theme.light");
+    const dark = validateVariant(t.dark, "theme.dark");
+    const surfaces = t.surfaces;
+    if (surfaces !== undefined) {
+        if (!Array.isArray(surfaces) || surfaces.some((s) => s !== "tui" && s !== "web")) {
+            throw new Error('theme.surfaces: expected an array of "tui"|"web"');
+        }
+    }
+    return { id: t.id, name: t.name, light, dark, surfaces: surfaces };
+}
+//# sourceMappingURL=schema.js.map

package/dist/theme/schema.js.map

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

package/dist/theme/tokens.d.ts

@@ -0,0 +1,40 @@
+/**
+ * (7.3 / task 03 — W0) The curated ~70-token semantic set the seed engine
+ * resolves to (`[11.4]` targets ~100; we stay lean). Two consumer projections
+ * (project.ts): the TUI reads the 23 `TUI_ROLES` (→ chalk-rgb `Theme`), the web
+ * reads the whole set (→ `--ch-*` CSS vars). Token names are camelCase so the 23
+ * brand roles align 1:1 with the existing `Theme` field names (trivial
+ * projection) and the web `kebab()` deriver keeps emitting the SAME `--ch-*`
+ * names as today (zero web-theme regression).
+ */
+/** The 23 brand/diff/syntax roles the TUI consumes — names === `Theme` fields.
+ *  The `default` theme PINS all of these to today's exact RGB (zero regression). */
+export declare const TUI_ROLES: readonly ["accent", "success", "error", "warning", "permission", "planMode", "autoAccept", "bashPink", "diffAddedBg", "diffRemovedBg", "diffAddedWordBg", "diffRemovedWordBg", "userMessageBg", "stall", "synKeyword", "synString", "synComment", "synNumber", "synFunction", "synType", "synLiteral", "synTitle", "synAttr"];
+/** Web-only chrome tokens generated from the neutral/interactive/diff scales
+ *  (NEW — no existing snapshot, so generation is unconstrained beyond WCAG). */
+export declare const WEB_CHROME_TOKENS: readonly ["bgBase", "bgWeak", "bgStrong", "surfaceBase", "surfaceRaised", "surfaceInset", "surfaceHover", "surfaceActive", "textBase", "textWeak", "textWeaker", "textStrong", "borderBase", "borderWeak", "borderStrong", "borderFocus", "borderSelected", "inputBase", "inputHover", "inputFocus", "inputDisabled", "iconBase", "iconWeak", "iconStrong", "iconDisabled", "buttonPrimary", "buttonSecondary", "buttonGhostHover", "interactive", "diffAddSurface", "diffDeleteSurface", "diffChangeBarAdd", "diffChangeBarDelete", "diffChangeBarModified", "mdHeading", "mdLink", "mdCode", "mdQuote", "mdStrong", "mdEmph", "textOnAccent", "textOnSuccess", "textOnError", "textOnWarning", "textOnInteractive"];
+export type TuiRole = (typeof TUI_ROLES)[number];
+export type WebChromeToken = (typeof WEB_CHROME_TOKENS)[number];
+export type ChancesTokenName = TuiRole | WebChromeToken;
+/** All token names, for exhaustiveness checks (e.g. tokens.css `@theme` parity). */
+export declare const ALL_TOKENS: readonly ChancesTokenName[];
+/** Grouped for docs / @theme generation. */
+export declare const TOKEN_GROUPS: {
+    brand: ("error" | "accent" | "success" | "warning" | "permission" | "planMode" | "autoAccept" | "bashPink" | "userMessageBg" | "stall")[];
+    diff: ("diffAddedBg" | "diffRemovedBg" | "diffAddedWordBg" | "diffRemovedWordBg")[];
+    syntax: ("synKeyword" | "synString" | "synComment" | "synNumber" | "synFunction" | "synType" | "synLiteral" | "synTitle" | "synAttr")[];
+    background: ("bgBase" | "bgWeak" | "bgStrong")[];
+    surface: ("surfaceBase" | "surfaceRaised" | "surfaceInset" | "surfaceHover" | "surfaceActive")[];
+    text: ("textBase" | "textWeak" | "textWeaker" | "textStrong")[];
+    border: ("borderBase" | "borderWeak" | "borderStrong" | "borderFocus" | "borderSelected")[];
+    input: ("inputBase" | "inputHover" | "inputFocus" | "inputDisabled")[];
+    icon: ("iconBase" | "iconWeak" | "iconStrong" | "iconDisabled")[];
+    button: ("buttonPrimary" | "buttonSecondary" | "buttonGhostHover")[];
+    action: "interactive"[];
+    diffSurface: ("diffAddSurface" | "diffDeleteSurface" | "diffChangeBarAdd" | "diffChangeBarDelete" | "diffChangeBarModified")[];
+    markdown: ("mdHeading" | "mdLink" | "mdCode" | "mdQuote" | "mdStrong" | "mdEmph")[];
+    stateOn: ("textOnAccent" | "textOnSuccess" | "textOnError" | "textOnWarning" | "textOnInteractive")[];
+};
+/** A fully resolved theme variant: every token → a concrete color value. */
+export type ChancesTokens = Record<ChancesTokenName, import("./schema.js").ColorValue>;
+//# sourceMappingURL=tokens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/theme/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;oFACoF;AACpF,eAAO,MAAM,SAAS,+TAwBZ,CAAC;AAEX;gFACgF;AAChF,eAAO,MAAM,iBAAiB,urBAyDpB,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AACjD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,cAAc,CAAC;AAExD,oFAAoF;AACpF,eAAO,MAAM,UAAU,EAAE,SAAS,gBAAgB,EAAyC,CAAC;AAE5F,4CAA4C;AAC5C,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;CAeqB,CAAC;AAE/C,4EAA4E;AAC5E,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,gBAAgB,EAAE,OAAO,aAAa,EAAE,UAAU,CAAC,CAAC"}