@cdx-ui/styles 0.0.1-beta.59 → 0.0.1-beta.60

package/lib/commonjs/index.js

@@ -33,6 +33,12 @@ Object.defineProperty(exports, "applyThemeOverride", {
     return _theming.applyThemeOverride;
   }
 });
+Object.defineProperty(exports, "deriveBaseColorKey", {
+  enumerable: true,
+  get: function () {
+    return _palette.deriveBaseColorKey;
+  }
+});
 Object.defineProperty(exports, "generateColorScale", {
   enumerable: true,
   get: function () {

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_types","require","_palette","_theming","_useForgeFonts","_useCdxFonts"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,IAAAA,MAAA,GAAAC,OAAA;AAsBA,IAAAC,QAAA,GAAAD,OAAA;AAOA,IAAAE,QAAA,GAAAF,OAAA;AAcA,IAAAG,cAAA,GAAAH,OAAA;AACA,IAAAI,YAAA,GAAAJ,OAAA","ignoreList":[]}
+{"version":3,"names":["_types","require","_palette","_theming","_useForgeFonts","_useCdxFonts"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,IAAAA,MAAA,GAAAC,OAAA;AAsBA,IAAAC,QAAA,GAAAD,OAAA;AAOA,IAAAE,QAAA,GAAAF,OAAA;AAcA,IAAAG,cAAA,GAAAH,OAAA;AACA,IAAAI,YAAA,GAAAJ,OAAA","ignoreList":[]}

package/lib/commonjs/palette.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.deriveBaseColorKey = deriveBaseColorKey;
 exports.generateColorScale = generateColorScale;
 exports.generatePalettesFromInputs = generatePalettesFromInputs;
 var _leonardoContrastColors = require("@adobe/leonardo-contrast-colors");
@@ -128,6 +129,87 @@ function generateColorScale(hex, category) {
   return result;
 }
 
+// ---------------------------------------------------------------------------
+// Base color-key derivation
+// ---------------------------------------------------------------------------
+
+/** Saturation (0–1) applied to the brand hue to produce the base color key. */
+const BASE_SATURATION = 0.05;
+
+/** Convert a normalised hex string to HSL (`h` in degrees, `s`/`l` in 0–1). */
+function hexToHsl(hex) {
+  const r = parseInt(hex.slice(1, 3), 16) / 255;
+  const g = parseInt(hex.slice(3, 5), 16) / 255;
+  const b = parseInt(hex.slice(5, 7), 16) / 255;
+  const max = Math.max(r, g, b);
+  const min = Math.min(r, g, b);
+  const delta = max - min;
+  const l = (max + min) / 2;
+  let h = 0;
+  let s = 0;
+  if (delta !== 0) {
+    s = l > 0.5 ? delta / (2 - max - min) : delta / (max + min);
+    switch (max) {
+      case r:
+        h = (g - b) / delta + (g < b ? 6 : 0);
+        break;
+      case g:
+        h = (b - r) / delta + 2;
+        break;
+      default:
+        h = (r - g) / delta + 4;
+        break;
+    }
+    h *= 60;
+  }
+  return {
+    h,
+    s,
+    l
+  };
+}
+
+/** Convert HSL (`h` in degrees, `s`/`l` in 0–1) to a normalised hex string. */
+function hslToHex({
+  h,
+  s,
+  l
+}) {
+  const c = (1 - Math.abs(2 * l - 1)) * s;
+  const hp = (h % 360 + 360) % 360 / 60;
+  const x = c * (1 - Math.abs(hp % 2 - 1));
+  let r = 0;
+  let g = 0;
+  let b = 0;
+  if (hp < 1) [r, g, b] = [c, x, 0];else if (hp < 2) [r, g, b] = [x, c, 0];else if (hp < 3) [r, g, b] = [0, c, x];else if (hp < 4) [r, g, b] = [0, x, c];else if (hp < 5) [r, g, b] = [x, 0, c];else [r, g, b] = [c, 0, x];
+  const m = l - c / 2;
+  const toHex = v => Math.round((v + m) * 255).toString(16).padStart(2, '0');
+  return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+}
+
+/**
+ * Derive the base palette color key from a brand color.
+ *
+ * The base scale shares the brand's hue and lightness but is nearly neutral:
+ * the brand color is converted to HSL and its saturation is lowered to
+ * {@link BASE_SATURATION} (5%). The resulting hex is the color key fed to
+ * {@link generateColorScale} for the `base` category.
+ *
+ * @param brandHex - A valid hex color string (`#RGB` or `#RRGGBB`).
+ * @returns The normalised hex color key for the base scale.
+ */
+function deriveBaseColorKey(brandHex) {
+  const {
+    h,
+    l
+  } = hexToHsl(validateHex(brandHex));
+  return hslToHex({
+    h,
+    s: BASE_SATURATION,
+    l
+  });
+}
+
 // ---------------------------------------------------------------------------
 // Convenience wrapper
 // ---------------------------------------------------------------------------
@@ -139,7 +221,7 @@ function generateColorScale(hex, category) {
  *
  * Keep in sync with `INPUT_TOKEN_MAP` in `./index.ts`.
  */
-const COLOR_INPUT_ENTRIES = [['brandPrimary', 'color.brand'], ['accentPrimary', 'color.accent']];
+const COLOR_INPUT_ENTRIES = [['brandPrimary', 'color.brand'], ['accentPrimary', 'color.accent'], ['basePrimary', 'color.base']];
 
 /**
  * Generate palettes for all colour inputs in a theme override `inputs` object.

package/lib/commonjs/palette.js.map

@@ -1 +1 @@
-{"version":3,"names":["_leonardoContrastColors","require","REFERENCE_BACKGROUND","PALETTE_STEPS","CONTRAST_RATIOS","HEX_REGEX","validateHex","hex","TypeError","test","length","r","g","b","toLowerCase","generateColorScale","category","normalised","ratiosObject","step","color","Color","name","colorKeys","colorSpace","ratios","smooth","output","bg","BackgroundColor","theme","Theme","colors","backgroundColor","lightness","contrast","saturation","formula","pairs","contrastColorPairs","tokenPrefix","result","COLOR_INPUT_ENTRIES","generatePalettesFromInputs","inputs","inputKey","tokenPath","value","replace","scale","Object","assign"],"sourceRoot":"../../src","sources":["palette.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_leonardoContrastColors","require","REFERENCE_BACKGROUND","PALETTE_STEPS","CONTRAST_RATIOS","HEX_REGEX","validateHex","hex","TypeError","test","length","r","g","b","toLowerCase","generateColorScale","category","normalised","ratiosObject","step","color","Color","name","colorKeys","colorSpace","ratios","smooth","output","bg","BackgroundColor","theme","Theme","colors","backgroundColor","lightness","contrast","saturation","formula","pairs","contrastColorPairs","tokenPrefix","result","BASE_SATURATION","hexToHsl","parseInt","slice","max","Math","min","delta","l","h","s","hslToHex","c","abs","hp","x","m","toHex","v","round","toString","padStart","deriveBaseColorKey","brandHex","COLOR_INPUT_ENTRIES","generatePalettesFromInputs","inputs","inputKey","tokenPath","value","replace","scale","Object","assign"],"sourceRoot":"../../src","sources":["palette.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/theming.js

@@ -137,6 +137,39 @@ function presetPatchToUniwindMaps(patch, runtimeMap, runtimePlatform) {
  */
 const FONT_INPUT_ENTRIES = Object.entries(_types.INPUT_TOKEN_MAP).filter(([, tokenPath]) => !tokenPath.startsWith('color.'));
 
+/**
+ * Matches a token-reference alias value such as `{color.brand.700}` and
+ * captures the referenced token dot-path.
+ */
+const TOKEN_ALIAS_REGEX = /^\{([^}]+)\}$/;
+
+/**
+ * Resolve an `overrides.{mode}` value into the string written to the CSS
+ * variable map.
+ *
+ * - **Token-reference alias** (`{color.brand.700}`) → resolves the referenced
+ *   token path via the runtime map and returns a CSS `var()` reference
+ *   (`var(--color-brand-700)`), so the override tracks its source through the
+ *   cascade — the same mechanism the base theme uses for its semantic tokens.
+ *   Returns `null` when the referenced path is absent from the runtime map
+ *   (e.g. a non-primitive target), so the caller skips it; this enforces the
+ *   primitive-only alias constraint at the resolution layer.
+ * - **Literal value** (`#F5F7F6`, `8`) → returned as-is (stringified).
+ *
+ * @see docs/internal/token-architecture/16-override-structure.md — Token-reference aliases vs. literal values
+ */
+function resolveOverrideValue(value, runtimeMap) {
+  if (typeof value === 'string') {
+    const aliasMatch = TOKEN_ALIAS_REGEX.exec(value);
+    if (aliasMatch) {
+      const referencedPath = aliasMatch[1].trim();
+      const targetCssVar = runtimeMap[referencedPath];
+      return targetCssVar ? `var(${targetCssVar})` : null;
+    }
+  }
+  return String(value);
+}
+
 /**
  * Convert a hybrid FI override (`ThemeOverride`) into per-mode CSS variable
  * maps suitable for `Uniwind.updateCSSVariables`.
@@ -200,13 +233,17 @@ function themeOverrideToUniwindMaps(override, runtimeMap
       if (cssVar) bucket[cssVar] = value;
     }
 
-    // 3. Explicit per-mode overrides (wins on collision)
+    // 3. Explicit per-mode overrides (wins on collision). Values may be
+    //    token-reference aliases (resolved to a CSS var() reference) or
+    //    literals; see resolveOverrideValue.
     const modeOverrides = overrides?.[mode];
     if (modeOverrides) {
       for (const [dotPath, value] of Object.entries(modeOverrides)) {
         const modePrefixed = `modes.${mode}.${dotPath}`;
         const cssVar = runtimeMap[modePrefixed] ?? runtimeMap[dotPath];
-        if (cssVar) bucket[cssVar] = String(value);
+        if (!cssVar) continue;
+        const resolved = resolveOverrideValue(value, runtimeMap);
+        if (resolved !== null) bucket[cssVar] = resolved;
       }
     }
   }

package/lib/commonjs/theming.js.map

@@ -1 +1 @@
-{"version":3,"names":["_palette","require","_types","_applyThemeOverride","isSchemaVersionSupported","override","version","$extensions","schemaVersion","SUPPORTED_OVERRIDE_SCHEMA_VERSIONS","includes","isTokenValue","node","flattenDtcg","prefix","result","key","Object","keys","startsWith","child","path","$value","bucketByMode","flatTokens","runtimeMap","runtimePlatform","light","dark","dotPath","value","entries","strValue","String","cssVar","segments","split","platform","presetPatchToUniwindMaps","patch","flat","FONT_INPUT_ENTRIES","INPUT_TOKEN_MAP","filter","tokenPath","themeOverrideToUniwindMaps","inputs","overrides","paletteTokens","generatePalettesFromInputs","fontTokens","inputKey","undefined","modes","mode","bucket","hexValue","modePrefixed","modeOverrides"],"sourceRoot":"../../src","sources":["theming.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_palette","require","_types","_applyThemeOverride","isSchemaVersionSupported","override","version","$extensions","schemaVersion","SUPPORTED_OVERRIDE_SCHEMA_VERSIONS","includes","isTokenValue","node","flattenDtcg","prefix","result","key","Object","keys","startsWith","child","path","$value","bucketByMode","flatTokens","runtimeMap","runtimePlatform","light","dark","dotPath","value","entries","strValue","String","cssVar","segments","split","platform","presetPatchToUniwindMaps","patch","flat","FONT_INPUT_ENTRIES","INPUT_TOKEN_MAP","filter","tokenPath","TOKEN_ALIAS_REGEX","resolveOverrideValue","aliasMatch","exec","referencedPath","trim","targetCssVar","themeOverrideToUniwindMaps","inputs","overrides","paletteTokens","generatePalettesFromInputs","fontTokens","inputKey","undefined","modes","mode","bucket","hexValue","modePrefixed","modeOverrides","resolved"],"sourceRoot":"../../src","sources":["theming.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -9,7 +9,7 @@ export { OVERRIDE_SCHEMA_VERSION, SUPPORTED_OVERRIDE_SCHEMA_VERSIONS, INPUT_TOKE
 // Palette generation
 // ---------------------------------------------------------------------------
 
-export { generateColorScale, generatePalettesFromInputs } from './palette';
+export { generateColorScale, generatePalettesFromInputs, deriveBaseColorKey } from './palette';
 // ---------------------------------------------------------------------------
 // Theming utilities
 // ---------------------------------------------------------------------------

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["OVERRIDE_SCHEMA_VERSION","SUPPORTED_OVERRIDE_SCHEMA_VERSIONS","INPUT_TOKEN_MAP","presetFonts","generateColorScale","generatePalettesFromInputs","isSchemaVersionSupported","presetPatchToUniwindMaps","themeOverrideToUniwindMaps","applyThemeOverride","DEFAULT_PRESET","useForgeFonts","useCdxFonts"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA;AACA;;AAEA,SACEA,uBAAuB,EACvBC,kCAAkC,EAClCC,eAAe,EACfC,WAAW,QACN,SAAS;AAahB;AACA;AACA;;AAEA,SAASC,kBAAkB,EAAEC,0BAA0B,QAAQ,WAAW;AAG1E;AACA;AACA;;AAEA,SACEC,wBAAwB,EACxBC,wBAAwB,EACxBC,0BAA0B,EAC1BC,kBAAkB,EAClBC,cAAc,QACT,WAAW;AAIlB;AACA;AACA;;AAEA,SAASC,aAAa,QAAQ,iBAAiB;AAC/C,SAASC,WAAW,QAAQ,eAAe","ignoreList":[]}
+{"version":3,"names":["OVERRIDE_SCHEMA_VERSION","SUPPORTED_OVERRIDE_SCHEMA_VERSIONS","INPUT_TOKEN_MAP","presetFonts","generateColorScale","generatePalettesFromInputs","deriveBaseColorKey","isSchemaVersionSupported","presetPatchToUniwindMaps","themeOverrideToUniwindMaps","applyThemeOverride","DEFAULT_PRESET","useForgeFonts","useCdxFonts"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA;AACA;;AAEA,SACEA,uBAAuB,EACvBC,kCAAkC,EAClCC,eAAe,EACfC,WAAW,QACN,SAAS;AAahB;AACA;AACA;;AAEA,SAASC,kBAAkB,EAAEC,0BAA0B,EAAEC,kBAAkB,QAAQ,WAAW;AAG9F;AACA;AACA;;AAEA,SACEC,wBAAwB,EACxBC,wBAAwB,EACxBC,0BAA0B,EAC1BC,kBAAkB,EAClBC,cAAc,QACT,WAAW;AAIlB;AACA;AACA;;AAEA,SAASC,aAAa,QAAQ,iBAAiB;AAC/C,SAASC,WAAW,QAAQ,eAAe","ignoreList":[]}

package/lib/module/palette.js

@@ -124,6 +124,87 @@ export function generateColorScale(hex, category) {
   return result;
 }
 
+// ---------------------------------------------------------------------------
+// Base color-key derivation
+// ---------------------------------------------------------------------------
+
+/** Saturation (0–1) applied to the brand hue to produce the base color key. */
+const BASE_SATURATION = 0.05;
+
+/** Convert a normalised hex string to HSL (`h` in degrees, `s`/`l` in 0–1). */
+function hexToHsl(hex) {
+  const r = parseInt(hex.slice(1, 3), 16) / 255;
+  const g = parseInt(hex.slice(3, 5), 16) / 255;
+  const b = parseInt(hex.slice(5, 7), 16) / 255;
+  const max = Math.max(r, g, b);
+  const min = Math.min(r, g, b);
+  const delta = max - min;
+  const l = (max + min) / 2;
+  let h = 0;
+  let s = 0;
+  if (delta !== 0) {
+    s = l > 0.5 ? delta / (2 - max - min) : delta / (max + min);
+    switch (max) {
+      case r:
+        h = (g - b) / delta + (g < b ? 6 : 0);
+        break;
+      case g:
+        h = (b - r) / delta + 2;
+        break;
+      default:
+        h = (r - g) / delta + 4;
+        break;
+    }
+    h *= 60;
+  }
+  return {
+    h,
+    s,
+    l
+  };
+}
+
+/** Convert HSL (`h` in degrees, `s`/`l` in 0–1) to a normalised hex string. */
+function hslToHex({
+  h,
+  s,
+  l
+}) {
+  const c = (1 - Math.abs(2 * l - 1)) * s;
+  const hp = (h % 360 + 360) % 360 / 60;
+  const x = c * (1 - Math.abs(hp % 2 - 1));
+  let r = 0;
+  let g = 0;
+  let b = 0;
+  if (hp < 1) [r, g, b] = [c, x, 0];else if (hp < 2) [r, g, b] = [x, c, 0];else if (hp < 3) [r, g, b] = [0, c, x];else if (hp < 4) [r, g, b] = [0, x, c];else if (hp < 5) [r, g, b] = [x, 0, c];else [r, g, b] = [c, 0, x];
+  const m = l - c / 2;
+  const toHex = v => Math.round((v + m) * 255).toString(16).padStart(2, '0');
+  return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+}
+
+/**
+ * Derive the base palette color key from a brand color.
+ *
+ * The base scale shares the brand's hue and lightness but is nearly neutral:
+ * the brand color is converted to HSL and its saturation is lowered to
+ * {@link BASE_SATURATION} (5%). The resulting hex is the color key fed to
+ * {@link generateColorScale} for the `base` category.
+ *
+ * @param brandHex - A valid hex color string (`#RGB` or `#RRGGBB`).
+ * @returns The normalised hex color key for the base scale.
+ */
+export function deriveBaseColorKey(brandHex) {
+  const {
+    h,
+    l
+  } = hexToHsl(validateHex(brandHex));
+  return hslToHex({
+    h,
+    s: BASE_SATURATION,
+    l
+  });
+}
+
 // ---------------------------------------------------------------------------
 // Convenience wrapper
 // ---------------------------------------------------------------------------
@@ -135,7 +216,7 @@ export function generateColorScale(hex, category) {
  *
  * Keep in sync with `INPUT_TOKEN_MAP` in `./index.ts`.
  */
-const COLOR_INPUT_ENTRIES = [['brandPrimary', 'color.brand'], ['accentPrimary', 'color.accent']];
+const COLOR_INPUT_ENTRIES = [['brandPrimary', 'color.brand'], ['accentPrimary', 'color.accent'], ['basePrimary', 'color.base']];
 
 /**
  * Generate palettes for all colour inputs in a theme override `inputs` object.

package/lib/module/palette.js.map

@@ -1 +1 @@
-{"version":3,"names":["BackgroundColor","Color","Theme","REFERENCE_BACKGROUND","PALETTE_STEPS","CONTRAST_RATIOS","HEX_REGEX","validateHex","hex","TypeError","test","length","r","g","b","toLowerCase","generateColorScale","category","normalised","ratiosObject","step","color","name","colorKeys","colorSpace","ratios","smooth","output","bg","theme","colors","backgroundColor","lightness","contrast","saturation","formula","pairs","contrastColorPairs","tokenPrefix","result","COLOR_INPUT_ENTRIES","generatePalettesFromInputs","inputs","inputKey","tokenPath","value","replace","scale","Object","assign"],"sourceRoot":"../../src","sources":["palette.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["BackgroundColor","Color","Theme","REFERENCE_BACKGROUND","PALETTE_STEPS","CONTRAST_RATIOS","HEX_REGEX","validateHex","hex","TypeError","test","length","r","g","b","toLowerCase","generateColorScale","category","normalised","ratiosObject","step","color","name","colorKeys","colorSpace","ratios","smooth","output","bg","theme","colors","backgroundColor","lightness","contrast","saturation","formula","pairs","contrastColorPairs","tokenPrefix","result","BASE_SATURATION","hexToHsl","parseInt","slice","max","Math","min","delta","l","h","s","hslToHex","c","abs","hp","x","m","toHex","v","round","toString","padStart","deriveBaseColorKey","brandHex","COLOR_INPUT_ENTRIES","generatePalettesFromInputs","inputs","inputKey","tokenPath","value","replace","scale","Object","assign"],"sourceRoot":"../../src","sources":["palette.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/theming.js

@@ -121,6 +121,39 @@ export function presetPatchToUniwindMaps(patch, runtimeMap, runtimePlatform) {
  */
 const FONT_INPUT_ENTRIES = Object.entries(INPUT_TOKEN_MAP).filter(([, tokenPath]) => !tokenPath.startsWith('color.'));
 
+/**
+ * Matches a token-reference alias value such as `{color.brand.700}` and
+ * captures the referenced token dot-path.
+ */
+const TOKEN_ALIAS_REGEX = /^\{([^}]+)\}$/;
+
+/**
+ * Resolve an `overrides.{mode}` value into the string written to the CSS
+ * variable map.
+ *
+ * - **Token-reference alias** (`{color.brand.700}`) → resolves the referenced
+ *   token path via the runtime map and returns a CSS `var()` reference
+ *   (`var(--color-brand-700)`), so the override tracks its source through the
+ *   cascade — the same mechanism the base theme uses for its semantic tokens.
+ *   Returns `null` when the referenced path is absent from the runtime map
+ *   (e.g. a non-primitive target), so the caller skips it; this enforces the
+ *   primitive-only alias constraint at the resolution layer.
+ * - **Literal value** (`#F5F7F6`, `8`) → returned as-is (stringified).
+ *
+ * @see docs/internal/token-architecture/16-override-structure.md — Token-reference aliases vs. literal values
+ */
+function resolveOverrideValue(value, runtimeMap) {
+  if (typeof value === 'string') {
+    const aliasMatch = TOKEN_ALIAS_REGEX.exec(value);
+    if (aliasMatch) {
+      const referencedPath = aliasMatch[1].trim();
+      const targetCssVar = runtimeMap[referencedPath];
+      return targetCssVar ? `var(${targetCssVar})` : null;
+    }
+  }
+  return String(value);
+}
+
 /**
  * Convert a hybrid FI override (`ThemeOverride`) into per-mode CSS variable
  * maps suitable for `Uniwind.updateCSSVariables`.
@@ -184,13 +217,17 @@ export function themeOverrideToUniwindMaps(override, runtimeMap
       if (cssVar) bucket[cssVar] = value;
     }
 
-    // 3. Explicit per-mode overrides (wins on collision)
+    // 3. Explicit per-mode overrides (wins on collision). Values may be
+    //    token-reference aliases (resolved to a CSS var() reference) or
+    //    literals; see resolveOverrideValue.
     const modeOverrides = overrides?.[mode];
     if (modeOverrides) {
       for (const [dotPath, value] of Object.entries(modeOverrides)) {
         const modePrefixed = `modes.${mode}.${dotPath}`;
         const cssVar = runtimeMap[modePrefixed] ?? runtimeMap[dotPath];
-        if (cssVar) bucket[cssVar] = String(value);
+        if (!cssVar) continue;
+        const resolved = resolveOverrideValue(value, runtimeMap);
+        if (resolved !== null) bucket[cssVar] = resolved;
       }
     }
   }

package/lib/module/theming.js.map

@@ -1 +1 @@
-{"version":3,"names":["generatePalettesFromInputs","INPUT_TOKEN_MAP","SUPPORTED_OVERRIDE_SCHEMA_VERSIONS","applyThemeOverride","DEFAULT_PRESET","isSchemaVersionSupported","override","version","$extensions","schemaVersion","includes","isTokenValue","node","flattenDtcg","prefix","result","key","Object","keys","startsWith","child","path","$value","bucketByMode","flatTokens","runtimeMap","runtimePlatform","light","dark","dotPath","value","entries","strValue","String","cssVar","segments","split","platform","presetPatchToUniwindMaps","patch","flat","FONT_INPUT_ENTRIES","filter","tokenPath","themeOverrideToUniwindMaps","inputs","overrides","paletteTokens","fontTokens","inputKey","undefined","modes","mode","bucket","hexValue","modePrefixed","modeOverrides"],"sourceRoot":"../../src","sources":["theming.ts"],"mappings":";;AAAA,SAASA,0BAA0B,QAAQ,WAAW;AACtD,SACEC,eAAe,EACfC,kCAAkC,QAM7B,SAAS;;AAEhB;AACA;AACA;;AAEA,SAASC,kBAAkB,EAAEC,cAAc,QAAQ,sBAAsB;;AAGzE;AACA;AACA;;AAEA;;AAMA;;AAGA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,wBAAwBA,CAACC,QAAuB,EAAW;EACzE,MAAMC,OAAO,GAAGD,QAAQ,CAACE,WAAW,CAAC,4BAA4B,CAAC,CAACC,aAAa;EAChF,OAAOP,kCAAkC,CAACQ,QAAQ,CAACH,OAAO,CAAC;AAC7D;;AAEA;AACA;AACA;;AAEA,SAASI,YAAYA,CAACC,IAAa,EAAsB;EACvD,OAAO,OAAOA,IAAI,KAAK,QAAQ,IAAIA,IAAI,KAAK,IAAI,IAAI,QAAQ,IAAIA,IAAI,IAAI,OAAO,IAAIA,IAAI;AACzF;;AAEA;AACA;AACA;AACA;AACA,SAASC,WAAWA,CAClBD,IAAgB,EAChBE,MAAc,EACdC,MAAuC,EACjC;EACN,KAAK,MAAMC,GAAG,IAAIC,MAAM,CAACC,IAAI,CAACN,IAAI,CAAC,EAAE;IACnC,IAAII,GAAG,CAACG,UAAU,CAAC,GAAG,CAAC,EAAE;IAEzB,MAAMC,KAAK,GAAGR,IAAI,CAACI,GAAG,CAAC;IACvB,MAAMK,IAAI,GAAGP,MAAM,GAAG,GAAGA,MAAM,IAAIE,GAAG,EAAE,GAAGA,GAAG;IAE9C,IAAIL,YAAY,CAACS,KAAK,CAAC,EAAE;MACvBL,MAAM,CAACM,IAAI,CAAC,GAAGD,KAAK,CAACE,MAAM;IAC7B,CAAC,MAAM,IAAI,OAAOF,KAAK,KAAK,QAAQ,IAAIA,KAAK,KAAK,IAAI,EAAE;MACtDP,WAAW,CAACO,KAAK,EAAEC,IAAI,EAAEN,MAAM,CAAC;IAClC;EACF;AACF;;AAEA;AACA;AACA;;AAEA,SAASQ,YAAYA,CACnBC,UAA2C,EAC3CC,UAAsB,EACtBC,eAAyB,EACR;EACjB,MAAMC,KAA6B,GAAG,CAAC,CAAC;EACxC,MAAMC,IAA4B,GAAG,CAAC,CAAC;EAEvC,KAAK,MAAM,CAACC,OAAO,EAAEC,KAAK,CAAC,IAAIb,MAAM,CAACc,OAAO,CAACP,UAAU,CAAC,EAAE;IACzD,MAAMQ,QAAQ,GAAGC,MAAM,CAACH,KAAK,CAAC;IAE9B,IAAID,OAAO,CAACV,UAAU,CAAC,cAAc,CAAC,EAAE;MACtC,MAAMe,MAAM,GAAGT,UAAU,CAACI,OAAO,CAAC;MAClC,IAAIK,MAAM,EAAEP,KAAK,CAACO,MAAM,CAAC,GAAGF,QAAQ;IACtC,CAAC,MAAM,IAAIH,OAAO,CAACV,UAAU,CAAC,aAAa,CAAC,EAAE;MAC5C,MAAMe,MAAM,GAAGT,UAAU,CAACI,OAAO,CAAC;MAClC,IAAIK,MAAM,EAAEN,IAAI,CAACM,MAAM,CAAC,GAAGF,QAAQ;IACrC,CAAC,MAAM,IAAIH,OAAO,CAACV,UAAU,CAAC,WAAW,CAAC,EAAE;MAC1C,MAAMgB,QAAQ,GAAGN,OAAO,CAACO,KAAK,CAAC,GAAG,CAAC;MACnC,MAAMC,QAAQ,GAAGF,QAAQ,CAAC,CAAC,CAAC;MAC5B,IAAIE,QAAQ,KAAKX,eAAe,EAAE;MAElC,MAAMQ,MAAM,GAAGT,UAAU,CAACI,OAAO,CAAC;MAClC,IAAIK,MAAM,EAAE;QACVP,KAAK,CAACO,MAAM,CAAC,GAAGF,QAAQ;QACxBJ,IAAI,CAACM,MAAM,CAAC,GAAGF,QAAQ;MACzB;IACF,CAAC,MAAM;MACL,MAAME,MAAM,GAAGT,UAAU,CAACI,OAAO,CAAC;MAClC,IAAIK,MAAM,EAAE;QACVP,KAAK,CAACO,MAAM,CAAC,GAAGF,QAAQ;QACxBJ,IAAI,CAACM,MAAM,CAAC,GAAGF,QAAQ;MACzB;IACF;EACF;EAEA,OAAO;IAAEL,KAAK;IAAEC;EAAK,CAAC;AACxB;;AAEA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASU,wBAAwBA,CACtCC,KAAiB,EACjBd,UAAsB,EACtBC,eAAyB,EACR;EACjB,MAAMc,IAAqC,GAAG,CAAC,CAAC;EAChD3B,WAAW,CAAC0B,KAAK,EAAE,EAAE,EAAEC,IAAI,CAAC;EAC5B,OAAOjB,YAAY,CAACiB,IAAI,EAAEf,UAAU,EAAEC,eAAe,CAAC;AACxD;;AAEA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA,MAAMe,kBAA0D,GAC9DxB,MAAM,CAACc,OAAO,CAAC9B,eAAe,CAAC,CAC/ByC,MAAM,CAAC,CAAC,GAAGC,SAAS,CAAC,KAAK,CAACA,SAAS,CAACxB,UAAU,CAAC,QAAQ,CAAC,CAAC;;AAE5D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASyB,0BAA0BA,CACxCtC,QAAuB,EACvBmB;AACA;AAAA,EACiB;EACjB,MAAME,KAA6B,GAAG,CAAC,CAAC;EACxC,MAAMC,IAA4B,GAAG,CAAC,CAAC;EAEvC,MAAMiB,MAAM,GAAGvC,QAAQ,CAACuC,MAAM;EAC9B,MAAMC,SAAS,GAAGxC,QAAQ,CAACwC,SAAS;EAEpC,IAAI,CAACD,MAAM,IAAI,CAACC,SAAS,EAAE;IACzB,OAAO;MAAEnB,KAAK;MAAEC;IAAK,CAAC;EACxB;;EAEA;EACA,IAAImB,aAAqC,GAAG,CAAC,CAAC;EAC9C,IAAIF,MAAM,EAAE;IACVE,aAAa,GAAG/C,0BAA0B,CAAC6C,MAAM,CAAC;EACpD;;EAEA;EACA,MAAMG,UAAkC,GAAG,CAAC,CAAC;EAC7C,IAAIH,MAAM,EAAE;IACV,KAAK,MAAM,CAACI,QAAQ,EAAEN,SAAS,CAAC,IAAIF,kBAAkB,EAAE;MACtD,MAAMX,KAAK,GAAGe,MAAM,CAACI,QAAQ,CAAC;MAC9B,IAAInB,KAAK,KAAKoB,SAAS,EAAE;QACvBF,UAAU,CAACL,SAAS,CAAC,GAAGV,MAAM,CAACH,KAAK,CAAC;MACvC;IACF;EACF;;EAEA;EACA,MAAMqB,KAAa,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC;EAEvC,KAAK,MAAMC,IAAI,IAAID,KAAK,EAAE;IACxB,MAAME,MAAM,GAAGD,IAAI,KAAK,OAAO,GAAGzB,KAAK,GAAGC,IAAI;;IAE9C;IACA,KAAK,MAAM,CAACC,OAAO,EAAEyB,QAAQ,CAAC,IAAIrC,MAAM,CAACc,OAAO,CAACgB,aAAa,CAAC,EAAE;MAC/D,MAAMb,MAAM,GAAGT,UAAU,CAACI,OAAO,CAAC;MAClC,IAAIK,MAAM,EAAEmB,MAAM,CAACnB,MAAM,CAAC,GAAGoB,QAAQ;IACvC;;IAEA;IACA,KAAK,MAAM,CAACX,SAAS,EAAEb,KAAK,CAAC,IAAIb,MAAM,CAACc,OAAO,CAACiB,UAAU,CAAC,EAAE;MAC3D,MAAMO,YAAY,GAAG,SAASH,IAAI,IAAIT,SAAS,EAAE;MACjD,MAAMT,MAAM,GAAGT,UAAU,CAAC8B,YAAY,CAAC,IAAI9B,UAAU,CAACkB,SAAS,CAAC;MAChE,IAAIT,MAAM,EAAEmB,MAAM,CAACnB,MAAM,CAAC,GAAGJ,KAAK;IACpC;;IAEA;IACA,MAAM0B,aAAa,GAAGV,SAAS,GAAGM,IAAI,CAAC;IACvC,IAAII,aAAa,EAAE;MACjB,KAAK,MAAM,CAAC3B,OAAO,EAAEC,KAAK,CAAC,IAAIb,MAAM,CAACc,OAAO,CAACyB,aAAa,CAAC,EAAE;QAC5D,MAAMD,YAAY,GAAG,SAASH,IAAI,IAAIvB,OAAO,EAAE;QAC/C,MAAMK,MAAM,GAAGT,UAAU,CAAC8B,YAAY,CAAC,IAAI9B,UAAU,CAACI,OAAO,CAAC;QAC9D,IAAIK,MAAM,EAAEmB,MAAM,CAACnB,MAAM,CAAC,GAAGD,MAAM,CAACH,KAAK,CAAC;MAC5C;IACF;EACF;EAEA,OAAO;IAAEH,KAAK;IAAEC;EAAK,CAAC;AACxB","ignoreList":[]}
+{"version":3,"names":["generatePalettesFromInputs","INPUT_TOKEN_MAP","SUPPORTED_OVERRIDE_SCHEMA_VERSIONS","applyThemeOverride","DEFAULT_PRESET","isSchemaVersionSupported","override","version","$extensions","schemaVersion","includes","isTokenValue","node","flattenDtcg","prefix","result","key","Object","keys","startsWith","child","path","$value","bucketByMode","flatTokens","runtimeMap","runtimePlatform","light","dark","dotPath","value","entries","strValue","String","cssVar","segments","split","platform","presetPatchToUniwindMaps","patch","flat","FONT_INPUT_ENTRIES","filter","tokenPath","TOKEN_ALIAS_REGEX","resolveOverrideValue","aliasMatch","exec","referencedPath","trim","targetCssVar","themeOverrideToUniwindMaps","inputs","overrides","paletteTokens","fontTokens","inputKey","undefined","modes","mode","bucket","hexValue","modePrefixed","modeOverrides","resolved"],"sourceRoot":"../../src","sources":["theming.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/index.d.ts

@@ -1,6 +1,6 @@
 export { OVERRIDE_SCHEMA_VERSION, SUPPORTED_OVERRIDE_SCHEMA_VERSIONS, INPUT_TOKEN_MAP, presetFonts, } from './types';
 export type { TokenValue, TokenGroup, Preset, ThemeMetadata, ThemeOverrideMetadata, ThemeObject, ThemeOverride, Mode, Platform, } from './types';
-export { generateColorScale, generatePalettesFromInputs } from './palette';
+export { generateColorScale, generatePalettesFromInputs, deriveBaseColorKey } from './palette';
 export type { PaletteCategory, PaletteScale, PaletteStep, PaletteTokenMap } from './palette';
 export { isSchemaVersionSupported, presetPatchToUniwindMaps, themeOverrideToUniwindMaps, applyThemeOverride, DEFAULT_PRESET, } from './theming';
 export type { CssVariableMaps, RuntimeMap } from './theming';

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,uBAAuB,EACvB,kCAAkC,EAClC,eAAe,EACf,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,UAAU,EACV,UAAU,EACV,MAAM,EACN,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,aAAa,EACb,IAAI,EACJ,QAAQ,GACT,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAC3E,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAM7F,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,kBAAkB,EAClB,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC7D,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAMhG,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,uBAAuB,EACvB,kCAAkC,EAClC,eAAe,EACf,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,UAAU,EACV,UAAU,EACV,MAAM,EACN,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,aAAa,EACb,IAAI,EACJ,QAAQ,GACT,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/F,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAM7F,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,kBAAkB,EAClB,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC7D,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAMhG,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/lib/typescript/palette.d.ts

@@ -1,7 +1,7 @@
 /** Palette step keys produced by `generateColorScale`. */
 export type PaletteStep = '50' | '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900' | '950' | 'input';
 /** Token category that supports palette generation. */
-export type PaletteCategory = 'brand' | 'accent';
+export type PaletteCategory = 'brand' | 'accent' | 'base';
 /** Map of palette step → resolved hex color. */
 export type PaletteScale = Record<PaletteStep, string>;
 /** Map of token dot-path → resolved hex color (e.g. `color.brand.500` → `#548cdc`). */
@@ -19,6 +19,18 @@ export type PaletteTokenMap = Record<string, string>;
  *   (e.g. `"color.brand.50"` through `"color.brand.950"` plus `"color.brand.input"`).
  */
 export declare function generateColorScale(hex: string, category: PaletteCategory): PaletteTokenMap;
+/**
+ * Derive the base palette color key from a brand color.
+ *
+ * The base scale shares the brand's hue and lightness but is nearly neutral:
+ * the brand color is converted to HSL and its saturation is lowered to
+ * {@link BASE_SATURATION} (5%). The resulting hex is the color key fed to
+ * {@link generateColorScale} for the `base` category.
+ *
+ * @param brandHex - A valid hex color string (`#RGB` or `#RRGGBB`).
+ * @returns The normalised hex color key for the base scale.
+ */
+export declare function deriveBaseColorKey(brandHex: string): string;
 /**
  * Generate palettes for all colour inputs in a theme override `inputs` object.
  *

package/lib/typescript/palette.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../../src/palette.ts"],"names":[],"mappings":"AAMA,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GACnB,IAAI,GACJ,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,OAAO,CAAC;AAEZ,uDAAuD;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjD,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAEvD,uFAAuF;AACvF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AA8ErD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,eAAe,CAgD1F;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACtC,eAAe,CAcjB"}
+{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../../src/palette.ts"],"names":[],"mappings":"AAMA,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GACnB,IAAI,GACJ,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,OAAO,CAAC;AAEZ,uDAAuD;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1D,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAEvD,uFAAuF;AACvF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AA8ErD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,eAAe,CAgD1F;AAkED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG3D;AAmBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACtC,eAAe,CAcjB"}

package/lib/typescript/theming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theming.d.ts","sourceRoot":"","sources":["../../src/theming.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,UAAU,EAEhB,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1E,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAMhG,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAMhD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAGzE;AAgFD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,QAAQ,GACxB,eAAe,CAIjB;AAcD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,UAAU,GAErB,eAAe,CA2DjB"}
+{"version":3,"file":"theming.d.ts","sourceRoot":"","sources":["../../src/theming.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,UAAU,EAEhB,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1E,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAMhG,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAMhD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAGzE;AAgFD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,QAAQ,GACxB,eAAe,CAIjB;AA+CD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,UAAU,GAErB,eAAe,CAgEjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cdx-ui/styles",
-  "version": "0.0.1-beta.59",
+  "version": "0.0.1-beta.60",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
   "react-native": "src/index.ts",
@@ -65,7 +65,7 @@
     "@expo-google-fonts/manrope": "0.4.2",
     "@expo-google-fonts/outfit": "0.4.3",
     "@expo-google-fonts/public-sans": "0.4.2",
-    "@cdx-ui/utils": "0.0.1-beta.59"
+    "@cdx-ui/utils": "0.0.1-beta.60"
   },
   "peerDependencies": {
     "expo-font": ">=13.0.0",

package/src/__tests__/applyThemeOverride.test.ts

@@ -96,6 +96,9 @@ jest.mock(
     'color.accent.100': '--color-accent-100',
     'color.accent.500': '--color-accent-500',
     'color.accent.input': '--color-accent-input',
+    'color.base.50': '--color-base-50',
+    'color.base.500': '--color-base-500',
+    'color.base.950': '--color-base-950',
     'font.display': '--font-display',
     'modes.light.color.surface.background': '--color-surface-background',
     'modes.dark.color.surface.background': '--color-surface-background',
@@ -131,6 +134,9 @@ const TEST_RUNTIME_MAP: RuntimeMap = {
   'color.accent.100': '--color-accent-100',
   'color.accent.500': '--color-accent-500',
   'color.accent.input': '--color-accent-input',
+  'color.base.50': '--color-base-50',
+  'color.base.500': '--color-base-500',
+  'color.base.950': '--color-base-950',
   'font.display': '--font-display',
   'modes.light.color.surface.background': '--color-surface-background',
   'modes.dark.color.surface.background': '--color-surface-background',
@@ -194,6 +200,30 @@ describe('applyThemeOverride', () => {
       expect(mockUpdateCSSVariables).toHaveBeenCalledWith('dark', expect.any(Object));
     });
 
+    it('applies a base palette from a basePrimary input', () => {
+      const override: ThemeOverride = {
+        $extensions: {
+          'com.forge.ui.themeOverride': {
+            basePreset: 'poise',
+            schemaVersion: '1.0.0',
+          },
+        },
+        inputs: { brandPrimary: '#0052cc', basePrimary: '#61666c' },
+      };
+
+      const result = applyThemeOverride(override, {
+        runtimeMap: TEST_RUNTIME_MAP,
+        runtimePlatform: 'web',
+      });
+
+      expect(result.applied).toBe(true);
+      if (result.applied) {
+        expect(result.light['--color-base-50']).toBeDefined();
+        expect(result.light['--color-base-500']).toBeDefined();
+        expect(result.dark['--color-base-950']).toBeDefined();
+      }
+    });
+
     it('applies font input override', () => {
       const override: ThemeOverride = {
         $extensions: {
@@ -242,6 +272,40 @@ describe('applyThemeOverride', () => {
         expect(result.dark['--color-surface-background']).toBe('#1a1a1a');
       }
     });
+
+    it('resolves alias overrides to var() references end-to-end', () => {
+      const override: ThemeOverride = {
+        $extensions: {
+          'com.forge.ui.themeOverride': {
+            basePreset: 'poise',
+            schemaVersion: '1.0.0',
+          },
+        },
+        inputs: { brandPrimary: '#0052cc' },
+        overrides: {
+          light: { 'color.surface.background': '{color.brand.700}' },
+          dark: { 'color.surface.background': '{color.brand.300}' },
+        },
+      };
+
+      const result = applyThemeOverride(override, {
+        runtimeMap: TEST_RUNTIME_MAP,
+        runtimePlatform: 'web',
+      });
+
+      expect(result.applied).toBe(true);
+      if (result.applied) {
+        expect(result.light['--color-surface-background']).toBe('var(--color-brand-700)');
+        expect(result.dark['--color-surface-background']).toBe('var(--color-brand-300)');
+        // The referenced primitive is present in the same batch (palette
+        // generation emitted it), so the var() reference resolves.
+        expect(result.light['--color-brand-700']).toBeDefined();
+      }
+      expect(mockUpdateCSSVariables).toHaveBeenCalledWith(
+        'light',
+        expect.objectContaining({ '--color-surface-background': 'var(--color-brand-700)' }),
+      );
+    });
   });
 
   describe('non-default preset patch + override', () => {

package/src/__tests__/generateColorScale.test.ts

@@ -1,4 +1,4 @@
-import { generateColorScale, generatePalettesFromInputs } from '../palette';
+import { generateColorScale, generatePalettesFromInputs, deriveBaseColorKey } from '../palette';
 
 const PALETTE_STEPS = [
   '50',
@@ -63,6 +63,16 @@ describe('generateColorScale', () => {
       expect(Object.keys(result)).toHaveLength(12);
     });
 
+    it('returns all 11 contrast steps plus the input key for base', () => {
+      const result = generateColorScale('#797986', 'base');
+
+      for (const step of PALETTE_STEPS) {
+        expect(`color.base.${step}` in result).toBe(true);
+      }
+      expect('color.base.input' in result).toBe(true);
+      expect(Object.keys(result)).toHaveLength(12);
+    });
+
     it('all generated values are valid 7-character hex strings', () => {
       const result = generateColorScale('#0052cc', 'brand');
 
@@ -147,6 +157,65 @@ describe('generateColorScale', () => {
   });
 });
 
+// ---------------------------------------------------------------------------
+// deriveBaseColorKey
+// ---------------------------------------------------------------------------
+
+/** Saturation component (0–1) of a hex color in HSL. */
+function saturation(hex: string): number {
+  const r = parseInt(hex.slice(1, 3), 16) / 255;
+  const g = parseInt(hex.slice(3, 5), 16) / 255;
+  const b = parseInt(hex.slice(5, 7), 16) / 255;
+  const max = Math.max(r, g, b);
+  const min = Math.min(r, g, b);
+  const l = (max + min) / 2;
+  const delta = max - min;
+  if (delta === 0) return 0;
+  return l > 0.5 ? delta / (2 - max - min) : delta / (max + min);
+}
+
+/** Hue component (degrees) of a hex color in HSL. */
+function hue(hex: string): number {
+  const r = parseInt(hex.slice(1, 3), 16) / 255;
+  const g = parseInt(hex.slice(3, 5), 16) / 255;
+  const b = parseInt(hex.slice(5, 7), 16) / 255;
+  const max = Math.max(r, g, b);
+  const min = Math.min(r, g, b);
+  const delta = max - min;
+  if (delta === 0) return 0;
+  let h: number;
+  if (max === r) h = (g - b) / delta + (g < b ? 6 : 0);
+  else if (max === g) h = (b - r) / delta + 2;
+  else h = (r - g) / delta + 4;
+  return h * 60;
+}
+
+describe('deriveBaseColorKey', () => {
+  it('returns a normalised 7-character hex string', () => {
+    expect(deriveBaseColorKey('#346099')).toMatch(/^#[0-9a-f]{6}$/);
+  });
+
+  it('lowers saturation to ~5%', () => {
+    // ~5% saturation rounded through 8-bit channels lands close to 0.05.
+    expect(saturation(deriveBaseColorKey('#346099'))).toBeCloseTo(0.05, 2);
+    expect(saturation(deriveBaseColorKey('#ff0000'))).toBeCloseTo(0.05, 2);
+  });
+
+  it('preserves the brand hue (within rounding tolerance)', () => {
+    // At 5% saturation the channels are nearly equal, so 8-bit rounding can
+    // nudge the hue by a couple of degrees — assert a small absolute tolerance.
+    expect(Math.abs(hue(deriveBaseColorKey('#346099')) - hue('#346099'))).toBeLessThan(5);
+  });
+
+  it('accepts shorthand hex and normalises the result', () => {
+    expect(deriveBaseColorKey('#36c')).toMatch(/^#[0-9a-f]{6}$/);
+  });
+
+  it('throws for invalid hex input', () => {
+    expect(() => deriveBaseColorKey('nope')).toThrow(TypeError);
+  });
+});
+
 // ---------------------------------------------------------------------------
 // generatePalettesFromInputs
 // ---------------------------------------------------------------------------
@@ -199,4 +268,29 @@ describe('generatePalettesFromInputs', () => {
       expect(key).toMatch(/^color\.brand\./);
     }
   });
+
+  it('generates a base palette from a basePrimary input', () => {
+    const result = generatePalettesFromInputs({
+      basePrimary: deriveBaseColorKey('#346099'),
+    });
+
+    for (const step of PALETTE_STEPS) {
+      expect(`color.base.${step}` in result).toBe(true);
+    }
+    expect('color.base.input' in result).toBe(true);
+  });
+
+  it('generates brand, accent, and base palettes together', () => {
+    const result = generatePalettesFromInputs({
+      brandPrimary: '#0052cc',
+      accentPrimary: '#ff8c42',
+      basePrimary: deriveBaseColorKey('#0052cc'),
+    });
+
+    for (const step of PALETTE_STEPS) {
+      expect(`color.brand.${step}` in result).toBe(true);
+      expect(`color.accent.${step}` in result).toBe(true);
+      expect(`color.base.${step}` in result).toBe(true);
+    }
+  });
 });

package/src/__tests__/theming.test.ts

@@ -49,6 +49,10 @@ const MOCK_RUNTIME_MAP: RuntimeMap = {
   'modes.dark.font.display': '--font-display',
   'modes.light.border-radius.button': '--border-radius-button',
   'modes.dark.border-radius.button': '--border-radius-button',
+  'modes.light.color.surface.action.strong': '--color-surface-action-strong',
+  'modes.dark.color.surface.action.strong': '--color-surface-action-strong',
+  'modes.light.color.content.link': '--color-content-link',
+  'modes.dark.color.content.link': '--color-content-link',
 
   // Platform-prefixed tokens
   'platform.web.font.sans': '--font-sans',
@@ -477,6 +481,124 @@ describe('themeOverrideToUniwindMaps', () => {
       expect(Object.keys(result.light)).toHaveLength(1);
     });
   });
+
+  describe('token-reference aliases', () => {
+    it('resolves an alias override to a CSS var() reference', () => {
+      const override: ThemeOverride = {
+        ...baseOverride,
+        overrides: {
+          light: { 'color.surface.action.strong': '{color.brand.700}' },
+        },
+      };
+
+      const result = themeOverrideToUniwindMaps(override, MOCK_RUNTIME_MAP, 'web');
+
+      expect(result.light['--color-surface-action-strong']).toBe('var(--color-brand-700)');
+    });
+
+    it('supports per-mode step shifts (brand.700 light / brand.300 dark)', () => {
+      const override: ThemeOverride = {
+        ...baseOverride,
+        overrides: {
+          light: { 'color.surface.action.strong': '{color.brand.700}' },
+          dark: { 'color.surface.action.strong': '{color.brand.300}' },
+        },
+      };
+
+      const result = themeOverrideToUniwindMaps(override, MOCK_RUNTIME_MAP, 'web');
+
+      expect(result.light['--color-surface-action-strong']).toBe('var(--color-brand-700)');
+      expect(result.dark['--color-surface-action-strong']).toBe('var(--color-brand-300)');
+    });
+
+    it('resolves aliases targeting the accent scale', () => {
+      const override: ThemeOverride = {
+        ...baseOverride,
+        overrides: {
+          light: { 'color.content.link': '{color.accent.600}' },
+        },
+      };
+
+      const result = themeOverrideToUniwindMaps(override, MOCK_RUNTIME_MAP, 'web');
+
+      expect(result.light['--color-content-link']).toBe('var(--color-accent-600)');
+    });
+
+    it('mixes alias and literal values in the same mode', () => {
+      const override: ThemeOverride = {
+        ...baseOverride,
+        overrides: {
+          light: {
+            'color.surface.action.strong': '{color.brand.700}',
+            'color.surface.background': '#F5F7F6',
+          },
+        },
+      };
+
+      const result = themeOverrideToUniwindMaps(override, MOCK_RUNTIME_MAP, 'web');
+
+      expect(result.light['--color-surface-action-strong']).toBe('var(--color-brand-700)');
+      expect(result.light['--color-surface-background']).toBe('#F5F7F6');
+    });
+
+    it('passes a numeric literal through without alias treatment', () => {
+      const override: ThemeOverride = {
+        ...baseOverride,
+        overrides: {
+          light: { 'border-radius.button': 8 },
+        },
+      };
+
+      const result = themeOverrideToUniwindMaps(override, MOCK_RUNTIME_MAP, 'web');
+
+      expect(result.light['--border-radius-button']).toBe('8');
+    });
+
+    it('alias override wins over a palette-generated primitive on collision', () => {
+      const override: ThemeOverride = {
+        ...baseOverride,
+        inputs: { brandPrimary: '#0052cc' },
+        overrides: {
+          light: { 'color.brand.500': '{color.brand.700}' },
+        },
+      };
+
+      const result = themeOverrideToUniwindMaps(override, MOCK_RUNTIME_MAP, 'web');
+
+      expect(result.light['--color-brand-500']).toBe('var(--color-brand-700)');
+    });
+
+    it('skips an alias whose referenced primitive is absent from the runtime map', () => {
+      const override: ThemeOverride = {
+        ...baseOverride,
+        overrides: {
+          light: { 'color.surface.background': '{color.brand.999}' },
+        },
+      };
+
+      const result = themeOverrideToUniwindMaps(override, MOCK_RUNTIME_MAP, 'web');
+
+      expect(result.light['--color-surface-background']).toBeUndefined();
+      expect(Object.keys(result.light)).toHaveLength(0);
+    });
+
+    it('skips an alias targeting a non-primitive token (primitive-only constraint)', () => {
+      const override: ThemeOverride = {
+        ...baseOverride,
+        overrides: {
+          // `color.content.primary` exists only as a mode-prefixed semantic
+          // token, not as a resolvable primitive path — so it is not a valid
+          // alias target and resolution skips it.
+          light: { 'color.surface.action.strong': '{color.content.primary}' },
+        },
+      };
+
+      const result = themeOverrideToUniwindMaps(override, MOCK_RUNTIME_MAP, 'web');
+
+      expect(result.light['--color-surface-action-strong']).toBeUndefined();
+      expect(Object.keys(result.light)).toHaveLength(0);
+    });
+  });
 });
 
 // ---------------------------------------------------------------------------

package/src/index.ts

@@ -24,7 +24,7 @@ export type {
 // Palette generation
 // ---------------------------------------------------------------------------
 
-export { generateColorScale, generatePalettesFromInputs } from './palette';
+export { generateColorScale, generatePalettesFromInputs, deriveBaseColorKey } from './palette';
 export type { PaletteCategory, PaletteScale, PaletteStep, PaletteTokenMap } from './palette';
 
 // ---------------------------------------------------------------------------

package/src/palette.ts

@@ -20,7 +20,7 @@ export type PaletteStep =
   | 'input';
 
 /** Token category that supports palette generation. */
-export type PaletteCategory = 'brand' | 'accent';
+export type PaletteCategory = 'brand' | 'accent' | 'base';
 
 /** Map of palette step → resolved hex color. */
 export type PaletteScale = Record<PaletteStep, string>;
@@ -166,6 +166,86 @@ export function generateColorScale(hex: string, category: PaletteCategory): Pale
   return result;
 }
 
+// ---------------------------------------------------------------------------
+// Base color-key derivation
+// ---------------------------------------------------------------------------
+
+/** Saturation (0–1) applied to the brand hue to produce the base color key. */
+const BASE_SATURATION = 0.05;
+
+/** Convert a normalised hex string to HSL (`h` in degrees, `s`/`l` in 0–1). */
+function hexToHsl(hex: CssColor): { h: number; s: number; l: number } {
+  const r = parseInt(hex.slice(1, 3), 16) / 255;
+  const g = parseInt(hex.slice(3, 5), 16) / 255;
+  const b = parseInt(hex.slice(5, 7), 16) / 255;
+
+  const max = Math.max(r, g, b);
+  const min = Math.min(r, g, b);
+  const delta = max - min;
+  const l = (max + min) / 2;
+
+  let h = 0;
+  let s = 0;
+  if (delta !== 0) {
+    s = l > 0.5 ? delta / (2 - max - min) : delta / (max + min);
+    switch (max) {
+      case r:
+        h = (g - b) / delta + (g < b ? 6 : 0);
+        break;
+      case g:
+        h = (b - r) / delta + 2;
+        break;
+      default:
+        h = (r - g) / delta + 4;
+        break;
+    }
+    h *= 60;
+  }
+
+  return { h, s, l };
+}
+
+/** Convert HSL (`h` in degrees, `s`/`l` in 0–1) to a normalised hex string. */
+function hslToHex({ h, s, l }: { h: number; s: number; l: number }): CssColor {
+  const c = (1 - Math.abs(2 * l - 1)) * s;
+  const hp = (((h % 360) + 360) % 360) / 60;
+  const x = c * (1 - Math.abs((hp % 2) - 1));
+
+  let r = 0;
+  let g = 0;
+  let b = 0;
+  if (hp < 1) [r, g, b] = [c, x, 0];
+  else if (hp < 2) [r, g, b] = [x, c, 0];
+  else if (hp < 3) [r, g, b] = [0, c, x];
+  else if (hp < 4) [r, g, b] = [0, x, c];
+  else if (hp < 5) [r, g, b] = [x, 0, c];
+  else [r, g, b] = [c, 0, x];
+
+  const m = l - c / 2;
+  const toHex = (v: number) =>
+    Math.round((v + m) * 255)
+      .toString(16)
+      .padStart(2, '0');
+
+  return `#${toHex(r)}${toHex(g)}${toHex(b)}` as CssColor;
+}
+
+/**
+ * Derive the base palette color key from a brand color.
+ *
+ * The base scale shares the brand's hue and lightness but is nearly neutral:
+ * the brand color is converted to HSL and its saturation is lowered to
+ * {@link BASE_SATURATION} (5%). The resulting hex is the color key fed to
+ * {@link generateColorScale} for the `base` category.
+ *
+ * @param brandHex - A valid hex color string (`#RGB` or `#RRGGBB`).
+ * @returns The normalised hex color key for the base scale.
+ */
+export function deriveBaseColorKey(brandHex: string): string {
+  const { h, l } = hexToHsl(validateHex(brandHex));
+  return hslToHex({ h, s: BASE_SATURATION, l });
+}
+
 // ---------------------------------------------------------------------------
 // Convenience wrapper
 // ---------------------------------------------------------------------------
@@ -180,6 +260,7 @@ export function generateColorScale(hex: string, category: PaletteCategory): Pale
 const COLOR_INPUT_ENTRIES: readonly (readonly [string, string])[] = [
   ['brandPrimary', 'color.brand'],
   ['accentPrimary', 'color.accent'],
+  ['basePrimary', 'color.base'],
 ] as const;
 
 /**

package/src/theming.ts

@@ -150,6 +150,39 @@ const FONT_INPUT_ENTRIES: readonly (readonly [string, string])[] = (
   Object.entries(INPUT_TOKEN_MAP) as [string, string][]
 ).filter(([, tokenPath]) => !tokenPath.startsWith('color.'));
 
+/**
+ * Matches a token-reference alias value such as `{color.brand.700}` and
+ * captures the referenced token dot-path.
+ */
+const TOKEN_ALIAS_REGEX = /^\{([^}]+)\}$/;
+
+/**
+ * Resolve an `overrides.{mode}` value into the string written to the CSS
+ * variable map.
+ *
+ * - **Token-reference alias** (`{color.brand.700}`) → resolves the referenced
+ *   token path via the runtime map and returns a CSS `var()` reference
+ *   (`var(--color-brand-700)`), so the override tracks its source through the
+ *   cascade — the same mechanism the base theme uses for its semantic tokens.
+ *   Returns `null` when the referenced path is absent from the runtime map
+ *   (e.g. a non-primitive target), so the caller skips it; this enforces the
+ *   primitive-only alias constraint at the resolution layer.
+ * - **Literal value** (`#F5F7F6`, `8`) → returned as-is (stringified).
+ *
+ * @see docs/internal/token-architecture/16-override-structure.md — Token-reference aliases vs. literal values
+ */
+function resolveOverrideValue(value: string | number, runtimeMap: RuntimeMap): string | null {
+  if (typeof value === 'string') {
+    const aliasMatch = TOKEN_ALIAS_REGEX.exec(value);
+    if (aliasMatch) {
+      const referencedPath = aliasMatch[1].trim();
+      const targetCssVar = runtimeMap[referencedPath];
+      return targetCssVar ? `var(${targetCssVar})` : null;
+    }
+  }
+  return String(value);
+}
+
 /**
  * Convert a hybrid FI override (`ThemeOverride`) into per-mode CSS variable
  * maps suitable for `Uniwind.updateCSSVariables`.
@@ -215,13 +248,18 @@ export function themeOverrideToUniwindMaps(
       if (cssVar) bucket[cssVar] = value;
     }
 
-    // 3. Explicit per-mode overrides (wins on collision)
+    // 3. Explicit per-mode overrides (wins on collision). Values may be
+    //    token-reference aliases (resolved to a CSS var() reference) or
+    //    literals; see resolveOverrideValue.
     const modeOverrides = overrides?.[mode];
     if (modeOverrides) {
       for (const [dotPath, value] of Object.entries(modeOverrides)) {
         const modePrefixed = `modes.${mode}.${dotPath}`;
         const cssVar = runtimeMap[modePrefixed] ?? runtimeMap[dotPath];
-        if (cssVar) bucket[cssVar] = String(value);
+        if (!cssVar) continue;
+
+        const resolved = resolveOverrideValue(value, runtimeMap);
+        if (resolved !== null) bucket[cssVar] = resolved;
       }
     }
   }