@rezi-ui/core 0.1.0-alpha.7 → 0.1.0-alpha.71

package/dist/theme/theme.js

@@ -1,21 +1,230 @@
 /**
- * packages/core/src/theme/theme.ts — Theme types and helpers.
+ * packages/core/src/theme/theme.ts — Internal compiled runtime theme helpers.
  *
- * Why: Provides a minimal theming system for color and spacing tokens that
- * can be resolved deterministically at render time.
+ * Why: The public contract is `ThemeDefinition`, but the renderer benefits from
+ * a precompiled color index and resolved spacing array.
  */
-import { defaultTheme } from "./defaultTheme.js";
-export function createTheme(overrides) {
-    const base = defaultTheme;
-    const raw = overrides;
-    const colors = Object.freeze({ ...base.colors, ...(raw.colors ?? {}) });
-    const spacing = Object.freeze([...(raw.spacing ?? base.spacing)]);
-    return Object.freeze({ colors, spacing });
+import { blendRgb } from "./blend.js";
+import { validateTheme } from "./validate.js";
+const compiledThemeCache = new WeakMap();
+function buildSpacing(spacing) {
+    return Object.freeze([
+        0,
+        spacing.xs,
+        spacing.sm,
+        spacing.md,
+        spacing.lg,
+        spacing.xl,
+        spacing["2xl"],
+    ]);
+}
+function buildColorIndex(theme) {
+    const c = theme.colors;
+    const widget = theme.widget;
+    return Object.freeze({
+        primary: c.accent.primary,
+        secondary: c.accent.secondary,
+        success: c.success,
+        danger: c.error,
+        warning: c.warning,
+        info: c.info,
+        muted: c.fg.muted,
+        bg: c.bg.base,
+        fg: c.fg.primary,
+        border: c.border.default,
+        error: c.error,
+        "bg.base": c.bg.base,
+        "bg.elevated": c.bg.elevated,
+        "bg.overlay": c.bg.overlay,
+        "bg.subtle": c.bg.subtle,
+        "fg.primary": c.fg.primary,
+        "fg.secondary": c.fg.secondary,
+        "fg.muted": c.fg.muted,
+        "fg.inverse": c.fg.inverse,
+        "accent.primary": c.accent.primary,
+        "accent.secondary": c.accent.secondary,
+        "accent.tertiary": c.accent.tertiary,
+        "focus.ring": c.focus.ring,
+        "focus.bg": c.focus.bg,
+        "selected.bg": c.selected.bg,
+        "selected.fg": c.selected.fg,
+        "disabled.fg": c.disabled.fg,
+        "disabled.bg": c.disabled.bg,
+        "diagnostic.error": c.diagnostic.error,
+        "diagnostic.warning": c.diagnostic.warning,
+        "diagnostic.info": c.diagnostic.info,
+        "diagnostic.hint": c.diagnostic.hint,
+        "border.subtle": c.border.subtle,
+        "border.default": c.border.default,
+        "border.strong": c.border.strong,
+        "widget.syntax.keyword": widget.syntax.keyword,
+        "widget.syntax.type": widget.syntax.type,
+        "widget.syntax.string": widget.syntax.string,
+        "widget.syntax.number": widget.syntax.number,
+        "widget.syntax.comment": widget.syntax.comment,
+        "widget.syntax.operator": widget.syntax.operator,
+        "widget.syntax.punctuation": widget.syntax.punctuation,
+        "widget.syntax.function": widget.syntax.function,
+        "widget.syntax.variable": widget.syntax.variable,
+        "widget.syntax.cursorFg": widget.syntax.cursorFg,
+        "widget.syntax.cursorBg": widget.syntax.cursorBg,
+        "widget.diff.addBg": widget.diff.addBg,
+        "widget.diff.deleteBg": widget.diff.deleteBg,
+        "widget.diff.addFg": widget.diff.addFg,
+        "widget.diff.deleteFg": widget.diff.deleteFg,
+        "widget.diff.hunkHeader": widget.diff.hunkHeader,
+        "widget.diff.lineNumber": widget.diff.lineNumber,
+        "widget.diff.border": widget.diff.border,
+        "widget.logs.trace": widget.logs.trace,
+        "widget.logs.debug": widget.logs.debug,
+        "widget.logs.info": widget.logs.info,
+        "widget.logs.warn": widget.logs.warn,
+        "widget.logs.error": widget.logs.error,
+        "widget.toast.info": widget.toast.info,
+        "widget.toast.success": widget.toast.success,
+        "widget.toast.warning": widget.toast.warning,
+        "widget.toast.error": widget.toast.error,
+        "widget.chart.primary": widget.chart.primary,
+        "widget.chart.accent": widget.chart.accent,
+        "widget.chart.muted": widget.chart.muted,
+        "widget.chart.success": widget.chart.success,
+        "widget.chart.warning": widget.chart.warning,
+        "widget.chart.danger": widget.chart.danger,
+    });
+}
+function blendColorTokens(from, to, t) {
+    return Object.freeze({
+        bg: Object.freeze({
+            base: blendRgb(from.bg.base, to.bg.base, t),
+            elevated: blendRgb(from.bg.elevated, to.bg.elevated, t),
+            overlay: blendRgb(from.bg.overlay, to.bg.overlay, t),
+            subtle: blendRgb(from.bg.subtle, to.bg.subtle, t),
+        }),
+        fg: Object.freeze({
+            primary: blendRgb(from.fg.primary, to.fg.primary, t),
+            secondary: blendRgb(from.fg.secondary, to.fg.secondary, t),
+            muted: blendRgb(from.fg.muted, to.fg.muted, t),
+            inverse: blendRgb(from.fg.inverse, to.fg.inverse, t),
+        }),
+        accent: Object.freeze({
+            primary: blendRgb(from.accent.primary, to.accent.primary, t),
+            secondary: blendRgb(from.accent.secondary, to.accent.secondary, t),
+            tertiary: blendRgb(from.accent.tertiary, to.accent.tertiary, t),
+        }),
+        success: blendRgb(from.success, to.success, t),
+        warning: blendRgb(from.warning, to.warning, t),
+        error: blendRgb(from.error, to.error, t),
+        info: blendRgb(from.info, to.info, t),
+        focus: Object.freeze({
+            ring: blendRgb(from.focus.ring, to.focus.ring, t),
+            bg: blendRgb(from.focus.bg, to.focus.bg, t),
+        }),
+        selected: Object.freeze({
+            bg: blendRgb(from.selected.bg, to.selected.bg, t),
+            fg: blendRgb(from.selected.fg, to.selected.fg, t),
+        }),
+        disabled: Object.freeze({
+            fg: blendRgb(from.disabled.fg, to.disabled.fg, t),
+            bg: blendRgb(from.disabled.bg, to.disabled.bg, t),
+        }),
+        diagnostic: Object.freeze({
+            error: blendRgb(from.diagnostic.error, to.diagnostic.error, t),
+            warning: blendRgb(from.diagnostic.warning, to.diagnostic.warning, t),
+            info: blendRgb(from.diagnostic.info, to.diagnostic.info, t),
+            hint: blendRgb(from.diagnostic.hint, to.diagnostic.hint, t),
+        }),
+        border: Object.freeze({
+            subtle: blendRgb(from.border.subtle, to.border.subtle, t),
+            default: blendRgb(from.border.default, to.border.default, t),
+            strong: blendRgb(from.border.strong, to.border.strong, t),
+        }),
+    });
+}
+function blendWidgetTokens(from, to, t) {
+    return Object.freeze({
+        syntax: Object.freeze({
+            keyword: blendRgb(from.syntax.keyword, to.syntax.keyword, t),
+            type: blendRgb(from.syntax.type, to.syntax.type, t),
+            string: blendRgb(from.syntax.string, to.syntax.string, t),
+            number: blendRgb(from.syntax.number, to.syntax.number, t),
+            comment: blendRgb(from.syntax.comment, to.syntax.comment, t),
+            operator: blendRgb(from.syntax.operator, to.syntax.operator, t),
+            punctuation: blendRgb(from.syntax.punctuation, to.syntax.punctuation, t),
+            function: blendRgb(from.syntax.function, to.syntax.function, t),
+            variable: blendRgb(from.syntax.variable, to.syntax.variable, t),
+            cursorFg: blendRgb(from.syntax.cursorFg, to.syntax.cursorFg, t),
+            cursorBg: blendRgb(from.syntax.cursorBg, to.syntax.cursorBg, t),
+        }),
+        diff: Object.freeze({
+            addBg: blendRgb(from.diff.addBg, to.diff.addBg, t),
+            deleteBg: blendRgb(from.diff.deleteBg, to.diff.deleteBg, t),
+            addFg: blendRgb(from.diff.addFg, to.diff.addFg, t),
+            deleteFg: blendRgb(from.diff.deleteFg, to.diff.deleteFg, t),
+            hunkHeader: blendRgb(from.diff.hunkHeader, to.diff.hunkHeader, t),
+            lineNumber: blendRgb(from.diff.lineNumber, to.diff.lineNumber, t),
+            border: blendRgb(from.diff.border, to.diff.border, t),
+        }),
+        logs: Object.freeze({
+            trace: blendRgb(from.logs.trace, to.logs.trace, t),
+            debug: blendRgb(from.logs.debug, to.logs.debug, t),
+            info: blendRgb(from.logs.info, to.logs.info, t),
+            warn: blendRgb(from.logs.warn, to.logs.warn, t),
+            error: blendRgb(from.logs.error, to.logs.error, t),
+        }),
+        toast: Object.freeze({
+            info: blendRgb(from.toast.info, to.toast.info, t),
+            success: blendRgb(from.toast.success, to.toast.success, t),
+            warning: blendRgb(from.toast.warning, to.toast.warning, t),
+            error: blendRgb(from.toast.error, to.toast.error, t),
+        }),
+        chart: Object.freeze({
+            primary: blendRgb(from.chart.primary, to.chart.primary, t),
+            accent: blendRgb(from.chart.accent, to.chart.accent, t),
+            muted: blendRgb(from.chart.muted, to.chart.muted, t),
+            success: blendRgb(from.chart.success, to.chart.success, t),
+            warning: blendRgb(from.chart.warning, to.chart.warning, t),
+            danger: blendRgb(from.chart.danger, to.chart.danger, t),
+        }),
+    });
+}
+export function compileTheme(themeDefinition) {
+    const validated = validateTheme(themeDefinition);
+    const cached = compiledThemeCache.get(validated);
+    if (cached)
+        return cached;
+    const compiled = Object.freeze({
+        definition: validated,
+        colors: buildColorIndex(validated),
+        spacing: buildSpacing(validated.spacing),
+        focusIndicator: Object.freeze({ ...validated.focusIndicator }),
+    });
+    compiledThemeCache.set(validated, compiled);
+    return compiled;
+}
+export function blendTheme(from, to, t) {
+    const clampedT = Math.max(0, Math.min(1, t));
+    if (clampedT <= 0)
+        return from;
+    if (clampedT >= 1)
+        return to;
+    const blended = validateTheme(Object.freeze({
+        name: to.definition.name,
+        colors: blendColorTokens(from.definition.colors, to.definition.colors, clampedT),
+        spacing: Object.freeze({ ...to.definition.spacing }),
+        focusIndicator: Object.freeze({ ...to.definition.focusIndicator }),
+        widget: blendWidgetTokens(from.definition.widget, to.definition.widget, clampedT),
+    }));
+    return Object.freeze({
+        definition: blended,
+        colors: buildColorIndex(blended),
+        spacing: buildSpacing(blended.spacing),
+        focusIndicator: Object.freeze({ ...blended.focusIndicator }),
+    });
 }
 export function resolveColor(theme, color) {
     if (typeof color !== "string")
         return color;
-    return theme.colors[color] ?? theme.colors.fg;
+    return theme.colors[color] ?? theme.colors.fg ?? theme.definition.colors.fg.primary;
 }
 export function resolveSpacing(theme, space) {
     if (!Number.isFinite(space))

package/dist/theme/theme.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/theme/theme.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA2BjD,MAAM,UAAU,WAAW,CACzB,SAA+F;IAE/F,MAAM,IAAI,GAAG,YAAY,CAAC;IAC1B,MAAM,GAAG,GAAG,SAAsE,CAAC;IACnF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAgB,CAAC;IACvF,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAClE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAY,EAAE,KAAmB;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,KAAa;IACxD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1E,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/theme/theme.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAStC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAA0B,CAAC;AAEjE,SAAS,YAAY,CAAC,OAA2B;IAC/C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,EAAE;QACV,OAAO,CAAC,EAAE;QACV,OAAO,CAAC,EAAE;QACV,OAAO,CAAC,EAAE;QACV,OAAO,CAAC,EAAE;QACV,OAAO,CAAC,KAAK,CAAC;KACf,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,KAAsB;IAC7C,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAE5B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO;QACzB,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS;QAC7B,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,MAAM,EAAE,CAAC,CAAC,KAAK;QACf,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK;QACjB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI;QACb,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO;QACxB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI;QACpB,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ;QAC5B,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO;QAC1B,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM;QACxB,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO;QAC1B,cAAc,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS;QAC9B,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK;QACtB,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO;QAC1B,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO;QAClC,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS;QACtC,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ;QACpC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI;QAC1B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE;QACtB,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE;QAC5B,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE;QAC5B,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE;QAC5B,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE;QAC5B,kBAAkB,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK;QACtC,oBAAoB,EAAE,CAAC,CAAC,UAAU,CAAC,OAAO;QAC1C,iBAAiB,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI;QACpC,iBAAiB,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI;QACpC,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM;QAChC,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO;QAClC,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM;QAChC,uBAAuB,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;QAC9C,oBAAoB,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI;QACxC,sBAAsB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;QAC5C,sBAAsB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;QAC5C,uBAAuB,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;QAC9C,wBAAwB,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;QAChD,2BAA2B,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW;QACtD,wBAAwB,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;QAChD,wBAAwB,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;QAChD,wBAAwB,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;QAChD,wBAAwB,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;QAChD,mBAAmB,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK;QACtC,sBAAsB,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ;QAC5C,mBAAmB,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK;QACtC,sBAAsB,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ;QAC5C,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU;QAChD,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU;QAChD,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;QACxC,mBAAmB,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK;QACtC,mBAAmB,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK;QACtC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;QACpC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;QACpC,mBAAmB,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK;QACtC,mBAAmB,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;QACtC,sBAAsB,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;QAC5C,sBAAsB,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;QAC5C,oBAAoB,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK;QACxC,sBAAsB,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;QAC5C,qBAAqB,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;QAC1C,oBAAoB,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK;QACxC,sBAAsB,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;QAC5C,sBAAsB,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;QAC5C,qBAAqB,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;KAC3C,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAiB,EAAE,EAAe,EAAE,CAAS;IACrE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC;YAChB,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3C,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;YACvD,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;SAClD,CAAC;QACF,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC;YAChB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;YAC1D,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9C,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;SACrD,CAAC;QACF,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5D,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YAClE,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;SAChE,CAAC;QACF,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QACxC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACrC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACjD,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;SAC5C,CAAC;QACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;YACjD,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;SAClD,CAAC;QACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;YACjD,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;SAClD,CAAC;QACF,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;YACxB,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;YACpE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3D,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;SAC5D,CAAC;QACF,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;YACpB,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACzD,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5D,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;SAC1D,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAkB,EAAE,EAAgB,EAAE,CAAS;IACxE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5D,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACnD,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACzD,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACzD,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5D,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC/D,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;YACxE,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC/D,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC/D,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC/D,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;SAChE,CAAC;QACF,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAClB,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAClD,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC3D,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAClD,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC3D,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YACjE,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YACjE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;SACtD,CAAC;QACF,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAClB,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAClD,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAClD,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/C,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/C,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;SACnD,CAAC;QACF,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACjD,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1D,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1D,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;SACrD,CAAC;QACF,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACnB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1D,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACvD,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YACpD,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1D,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1D,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;SACxD,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,eAAgC;IAC3D,MAAM,SAAS,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,UAAU,EAAE,SAAS;QACrB,MAAM,EAAE,eAAe,CAAC,SAAS,CAAC;QAClC,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,OAAO,CAAC;QACxC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,SAAS,CAAC,cAAc,EAAE,CAAyB;KACvF,CAAC,CAAC;IACH,kBAAkB,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC5C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAW,EAAE,EAAS,EAAE,CAAS;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,aAAa,CAC3B,MAAM,CAAC,MAAM,CAAC;QACZ,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI;QACxB,MAAM,EAAE,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC;QAChF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACpD,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC;QAClE,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC;KAClF,CAAC,CACH,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,UAAU,EAAE,OAAO;QACnB,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC;QAChC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC;QACtC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAyB;KACrF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAY,EAAE,KAAsB;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,KAAa;IACxD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1E,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/theme/tokens.d.ts

@@ -2,7 +2,7 @@
  * packages/core/src/theme/tokens.ts — Semantic color token system.
  *
  * Why: Provides a structured, semantic color system for consistent theming.
- * All colors are RGB objects { r, g, b } with values 0-255.
+ * All colors are packed RGB values (0x00RRGGBB).
  *
  * Token categories:
  *   - bg: Surface/background colors
@@ -14,81 +14,162 @@
  *
  * @see docs/styling/theme.md
  */
-import type { Rgb } from "../widgets/style.js";
+import { type Rgb24 } from "../widgets/style.js";
 /**
  * Surface (background) color tokens.
  */
 export type BgTokens = Readonly<{
     /** Main background color */
-    base: Rgb;
+    base: Rgb24;
     /** Elevated surfaces (cards, modals) */
-    elevated: Rgb;
+    elevated: Rgb24;
     /** Overlay surfaces (dropdowns, tooltips) */
-    overlay: Rgb;
+    overlay: Rgb24;
     /** Subtle hover/focus backgrounds */
-    subtle: Rgb;
+    subtle: Rgb24;
 }>;
 /**
  * Foreground (text) color tokens.
  */
 export type FgTokens = Readonly<{
     /** Primary text color */
-    primary: Rgb;
+    primary: Rgb24;
     /** Secondary/less important text */
-    secondary: Rgb;
+    secondary: Rgb24;
     /** Muted text (disabled, placeholders) */
-    muted: Rgb;
+    muted: Rgb24;
     /** Inverse text (on accent backgrounds) */
-    inverse: Rgb;
+    inverse: Rgb24;
 }>;
 /**
  * Accent color tokens.
  */
 export type AccentTokens = Readonly<{
     /** Primary accent (actions, focus) */
-    primary: Rgb;
+    primary: Rgb24;
     /** Secondary accent (links, highlights) */
-    secondary: Rgb;
+    secondary: Rgb24;
     /** Tertiary accent (subtle accents) */
-    tertiary: Rgb;
+    tertiary: Rgb24;
 }>;
 /**
  * Focus state tokens.
  */
 export type FocusTokens = Readonly<{
     /** Focus ring/outline color */
-    ring: Rgb;
+    ring: Rgb24;
     /** Focus background color */
-    bg: Rgb;
+    bg: Rgb24;
 }>;
 /**
  * Selection state tokens.
  */
 export type SelectedTokens = Readonly<{
     /** Selected item background */
-    bg: Rgb;
+    bg: Rgb24;
     /** Selected item foreground */
-    fg: Rgb;
+    fg: Rgb24;
 }>;
 /**
  * Disabled state tokens.
  */
 export type DisabledTokens = Readonly<{
     /** Disabled foreground */
-    fg: Rgb;
+    fg: Rgb24;
     /** Disabled background */
-    bg: Rgb;
+    bg: Rgb24;
 }>;
 /**
  * Border color tokens.
  */
 export type BorderTokens = Readonly<{
     /** Subtle borders (dividers) */
-    subtle: Rgb;
+    subtle: Rgb24;
     /** Default borders */
-    default: Rgb;
+    default: Rgb24;
     /** Strong/emphasized borders */
-    strong: Rgb;
+    strong: Rgb24;
+}>;
+/**
+ * Diagnostic color tokens.
+ */
+export type DiagnosticTokens = Readonly<{
+    /** Error diagnostics (squiggles, banners) */
+    error: Rgb24;
+    /** Warning diagnostics */
+    warning: Rgb24;
+    /** Informational diagnostics */
+    info: Rgb24;
+    /** Hint diagnostics */
+    hint: Rgb24;
+}>;
+/**
+ * Syntax highlighting token set for code-oriented widgets.
+ */
+export type SyntaxTokens = Readonly<{
+    keyword: Rgb24;
+    type: Rgb24;
+    string: Rgb24;
+    number: Rgb24;
+    comment: Rgb24;
+    operator: Rgb24;
+    punctuation: Rgb24;
+    function: Rgb24;
+    variable: Rgb24;
+    cursorFg: Rgb24;
+    cursorBg: Rgb24;
+}>;
+/**
+ * Diff viewer token set.
+ */
+export type DiffTokens = Readonly<{
+    addBg: Rgb24;
+    deleteBg: Rgb24;
+    addFg: Rgb24;
+    deleteFg: Rgb24;
+    hunkHeader: Rgb24;
+    lineNumber: Rgb24;
+    border: Rgb24;
+}>;
+/**
+ * Log console level token set.
+ */
+export type LogsTokens = Readonly<{
+    trace: Rgb24;
+    debug: Rgb24;
+    info: Rgb24;
+    warn: Rgb24;
+    error: Rgb24;
+}>;
+/**
+ * Toast style token set.
+ */
+export type ToastTokens = Readonly<{
+    info: Rgb24;
+    success: Rgb24;
+    warning: Rgb24;
+    error: Rgb24;
+}>;
+/**
+ * Chart palette token set.
+ */
+export type ChartTokens = Readonly<{
+    primary: Rgb24;
+    accent: Rgb24;
+    muted: Rgb24;
+    success: Rgb24;
+    warning: Rgb24;
+    danger: Rgb24;
+}>;
+/**
+ * Extended widget-specific theme tokens.
+ */
+export type WidgetTokens = Readonly<{
+    syntax: SyntaxTokens;
+    diff: DiffTokens;
+    logs: LogsTokens;
+    toast: ToastTokens;
+    chart: ChartTokens;
 }>;
 /**
  * Complete semantic color token set.
@@ -97,15 +178,39 @@ export type ColorTokens = Readonly<{
     bg: BgTokens;
     fg: FgTokens;
     accent: AccentTokens;
-    success: Rgb;
-    warning: Rgb;
-    error: Rgb;
-    info: Rgb;
+    success: Rgb24;
+    warning: Rgb24;
+    error: Rgb24;
+    info: Rgb24;
     focus: FocusTokens;
     selected: SelectedTokens;
     disabled: DisabledTokens;
+    diagnostic: DiagnosticTokens;
     border: BorderTokens;
 }>;
+/**
+ * Required spacing scale for semantic themes.
+ *
+ * Mirrors docs/styling/index.md spacing keys.
+ */
+export type ThemeSpacingTokens = Readonly<{
+    xs: number;
+    sm: number;
+    md: number;
+    lg: number;
+    xl: number;
+    "2xl": number;
+}>;
+/**
+ * Focus indicator style tokens.
+ *
+ * Rezi default focus style is underline + bold.
+ */
+export type FocusIndicatorTokens = Readonly<{
+    bold: boolean;
+    underline: boolean;
+    focusRingColor?: Rgb24;
+}>;
 /**
  * Theme definition with name and color tokens.
  */
@@ -114,11 +219,25 @@ export type ThemeDefinition = Readonly<{
     name: string;
     /** Complete color token set */
     colors: ColorTokens;
+    /** Required spacing scale used by design-system recipes. */
+    spacing: ThemeSpacingTokens;
+    /** Required default focus indicator styling. */
+    focusIndicator: FocusIndicatorTokens;
+    /** Widget-specific palettes for advanced surfaces. */
+    widget: WidgetTokens;
 }>;
 /**
- * Helper to create a frozen RGB color.
+ * Default semantic spacing tokens used by createThemeDefinition.
+ */
+export declare const DEFAULT_THEME_SPACING: ThemeSpacingTokens;
+/**
+ * Default focus indicator style used by createThemeDefinition.
+ */
+export declare const DEFAULT_FOCUS_INDICATOR: FocusIndicatorTokens;
+/**
+ * Helper to create a packed RGB color.
  */
-export declare function color(r: number, g: number, b: number): Rgb;
+export declare function color(r: number, g: number, b: number): Rgb24;
 /**
  * Helper to create a complete, frozen color token set.
  */
@@ -126,5 +245,9 @@ export declare function createColorTokens(tokens: ColorTokens): ColorTokens;
 /**
  * Helper to create a complete theme definition.
  */
-export declare function createThemeDefinition(name: string, colors: ColorTokens): ThemeDefinition;
+export declare function createThemeDefinition(name: string, colors: ColorTokens, options?: Readonly<{
+    spacing?: ThemeSpacingTokens;
+    focusIndicator?: FocusIndicatorTokens;
+    widget?: WidgetTokens;
+}>): ThemeDefinition;
 //# sourceMappingURL=tokens.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/theme/tokens.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/theme/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,KAAK,KAAK,EAAO,MAAM,qBAAqB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAC9B,4BAA4B;IAC5B,IAAI,EAAE,KAAK,CAAC;IACZ,wCAAwC;IACxC,QAAQ,EAAE,KAAK,CAAC;IAChB,6CAA6C;IAC7C,OAAO,EAAE,KAAK,CAAC;IACf,qCAAqC;IACrC,MAAM,EAAE,KAAK,CAAC;CACf,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAC9B,yBAAyB;IACzB,OAAO,EAAE,KAAK,CAAC;IACf,oCAAoC;IACpC,SAAS,EAAE,KAAK,CAAC;IACjB,0CAA0C;IAC1C,KAAK,EAAE,KAAK,CAAC;IACb,2CAA2C;IAC3C,OAAO,EAAE,KAAK,CAAC;CAChB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,sCAAsC;IACtC,OAAO,EAAE,KAAK,CAAC;IACf,2CAA2C;IAC3C,SAAS,EAAE,KAAK,CAAC;IACjB,uCAAuC;IACvC,QAAQ,EAAE,KAAK,CAAC;CACjB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,+BAA+B;IAC/B,IAAI,EAAE,KAAK,CAAC;IACZ,6BAA6B;IAC7B,EAAE,EAAE,KAAK,CAAC;CACX,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,+BAA+B;IAC/B,EAAE,EAAE,KAAK,CAAC;IACV,+BAA+B;IAC/B,EAAE,EAAE,KAAK,CAAC;CACX,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,0BAA0B;IAC1B,EAAE,EAAE,KAAK,CAAC;IACV,0BAA0B;IAC1B,EAAE,EAAE,KAAK,CAAC;CACX,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,gCAAgC;IAChC,MAAM,EAAE,KAAK,CAAC;IACd,sBAAsB;IACtB,OAAO,EAAE,KAAK,CAAC;IACf,gCAAgC;IAChC,MAAM,EAAE,KAAK,CAAC;CACf,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,6CAA6C;IAC7C,KAAK,EAAE,KAAK,CAAC;IACb,0BAA0B;IAC1B,OAAO,EAAE,KAAK,CAAC;IACf,gCAAgC;IAChC,IAAI,EAAE,KAAK,CAAC;IACZ,uBAAuB;IACvB,IAAI,EAAE,KAAK,CAAC;CACb,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,OAAO,EAAE,KAAK,CAAC;IACf,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC;IAChB,WAAW,EAAE,KAAK,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;CACjB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC;IAChB,UAAU,EAAE,KAAK,CAAC;IAClB,UAAU,EAAE,KAAK,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;CACf,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;CACd,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;CACd,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;CACf,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;CACpB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IAEjC,EAAE,EAAE,QAAQ,CAAC;IAGb,EAAE,EAAE,QAAQ,CAAC;IAGb,MAAM,EAAE,YAAY,CAAC;IAGrB,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IAGZ,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,cAAc,CAAC;IAGzB,UAAU,EAAE,gBAAgB,CAAC;IAG7B,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,KAAK,CAAC;CACxB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,MAAM,EAAE,WAAW,CAAC;IACpB,4DAA4D;IAC5D,OAAO,EAAE,kBAAkB,CAAC;IAC5B,gDAAgD;IAChD,cAAc,EAAE,oBAAoB,CAAC;IACrC,sDAAsD;IACtD,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,kBAOlC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,oBAGpC,CAAC;AAEH;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAE5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAelE;AA4DD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAM,GACN,eAAe,CAQjB"}