@motion-proto/live-tokens 0.50.0 → 0.52.1

package/dist-plugin/index.cjs

@@ -65,26 +65,16 @@ function sanitizeFileName(name) {
   return name.toLowerCase().trim().replace(/\s+/g, "-").replace(/[^a-z0-9\-_]/g, "").replace(/-+/g, "-").replace(/^[-_]+|-+$/g, "") || "unnamed";
 }
 
-// src/editor/core/palettes/oklch.ts
+// src/system/internal/oklch.ts
 function srgbToLinear(c) {
   return c <= 0.04045 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
 }
-function linearToSrgb(c) {
-  return c <= 31308e-7 ? 12.92 * c : 1.055 * Math.pow(c, 1 / 2.4) - 0.055;
-}
 function hexToLinearRgb(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;
   return [srgbToLinear(r), srgbToLinear(g), srgbToLinear(b)];
 }
-function linearRgbToHex(r, g, b) {
-  const toHex = (c) => {
-    const v = Math.round(Math.max(0, Math.min(1, linearToSrgb(c))) * 255);
-    return v.toString(16).padStart(2, "0");
-  };
-  return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
-}
 function linearRgbToOklab(r, g, b) {
   const l_ = 0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b;
   const m_ = 0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b;
@@ -126,19 +116,10 @@ function hexToOklch(hex) {
   const [L, a, bVal] = linearRgbToOklab(r, g, b);
   return oklabToOklch(L, a, bVal);
 }
-function oklchToHex(l, c, h) {
-  const [L, a, b] = oklchToOklab(l, c, h);
-  const [r, g, bVal] = oklabToLinearRgb(L, a, b);
-  return linearRgbToHex(r, g, bVal);
-}
 function isInGamut(r, g, b) {
   const eps = 1e-4;
   return r >= -eps && r <= 1 + eps && g >= -eps && g <= 1 + eps && b >= -eps && b <= 1 + eps;
 }
-function oklchToHexClamped(l, c, h) {
-  const g = gamutClamp(l, c, h);
-  return oklchToHex(g.l, g.c, g.h);
-}
 function gamutClamp(l, c, h) {
   if (l <= 0) return { l: 0, c: 0, h };
   if (l >= 1) return { l: 1, c: 0, h };
@@ -159,6 +140,31 @@ function gamutClamp(l, c, h) {
   }
   return { l, c: lo, h };
 }
+function trim(value, decimals) {
+  return Number(value.toFixed(decimals)).toString();
+}
+function oklchToCss(l, c, h) {
+  const cs = trim(c, 4);
+  return `oklch(${trim(l, 4)} ${cs} ${cs === "0" ? "0" : trim(h, 2)})`;
+}
+function oklchToCssClamped(l, c, h) {
+  const g = gamutClamp(l, c, h);
+  return oklchToCss(g.l, g.c, g.h);
+}
+var OKLCH_RE = /^oklch\(\s*([\d.]+)(%?)\s+([\d.]+)(%?)\s+([\d.]+)(?:deg)?\s*\)$/i;
+var HEX6_RE = /^#[0-9a-f]{6}$/i;
+function parseOklchCss(value) {
+  const m = OKLCH_RE.exec(value.trim());
+  if (!m) return null;
+  const l = Number.parseFloat(m[1]) / (m[2] === "%" ? 100 : 1);
+  const c = Number.parseFloat(m[3]) * (m[4] === "%" ? 4e-3 : 1);
+  return { l, c, h: Number.parseFloat(m[5]) };
+}
+function cssColorToOklch(value) {
+  const raw = value.trim();
+  if (HEX6_RE.test(raw)) return hexToOklch(raw);
+  return parseOklchCss(raw);
+}
 
 // src/editor/ui/curveEngine.ts
 function makeAnchor(x, y, tangentLen = 15) {
@@ -183,6 +189,15 @@ function tangentAnchor(x, y, prev, next) {
   const outDx = next ? (next.x - x) * HANDLE_SPAN : 0;
   return { x, y, inDx, inDy: m * inDx, outDx, outDy: m * outDx };
 }
+function isCornerAnchor(a) {
+  return a.inDx === 0 && a.inDy === 0 && a.outDx === 0 && a.outDy === 0;
+}
+function resmoothAutoCurve(anchors) {
+  if (anchors.length < 2) return anchors;
+  return anchors.map(
+    (a, i) => isCornerAnchor(a) ? a : tangentAnchor(a.x, a.y, anchors[i - 1] ?? null, anchors[i + 1] ?? null)
+  );
+}
 function evalBezier(p0x, p0y, c0x, c0y, c1x, c1y, p1x, p1y, t) {
   const u = 1 - t, u2 = u * u, u3 = u2 * u;
   const t2 = t * t, t3 = t2 * t;
@@ -278,37 +293,39 @@ var SCALES = [
 ];
 var BW_GUARD_MIN_L = 0.17;
 var BW_GUARD_MAX_L = 0.93;
-var DEFAULT_PALETTE_LIGHTNESS = () => [makeAnchor(0, 95, 5), makeAnchor(100, 8, 5)];
-var DEFAULT_PALETTE_SATURATION = () => [makeAnchor(0, 100, 30), makeAnchor(100, 100, 30)];
+var autoCurve = (...anchors) => resmoothAutoCurve(anchors);
+var DEFAULT_PALETTE_LIGHTNESS = () => autoCurve(makeAnchor(0, 95), makeAnchor(100, 8));
+var DEFAULT_PALETTE_SATURATION = () => autoCurve(makeAnchor(0, 100), makeAnchor(100, 100));
+var wrapHue = (h) => (h % 360 + 360) % 360;
 function scaleCurveDefaults(scheme = "dark") {
   if (scheme === "light") {
     return {
       Surfaces: {
-        lightness: () => [makeAnchor(0, 98, 5), makeAnchor(100, 82, 5)],
-        saturation: () => [makeAnchor(0, 100, 30), makeAnchor(100, 100, 30)]
+        lightness: () => autoCurve(makeAnchor(0, 98), makeAnchor(100, 82)),
+        saturation: () => autoCurve(makeAnchor(0, 100), makeAnchor(100, 100))
       },
       Borders: {
-        lightness: () => [makeAnchor(0, 92, 5), makeAnchor(100, 45, 5)],
-        saturation: () => [makeAnchor(0, 100, 30), makeAnchor(100, 100, 30)]
+        lightness: () => autoCurve(makeAnchor(0, 92), makeAnchor(100, 45)),
+        saturation: () => autoCurve(makeAnchor(0, 100), makeAnchor(100, 100))
       },
       Text: {
-        lightness: () => [makeAnchor(0, 30, 30), makeAnchor(100, 120, 30)],
-        saturation: () => [makeAnchor(0, 100, 30), makeAnchor(100, 15, 30)]
+        lightness: () => autoCurve(makeAnchor(0, 30), makeAnchor(100, 120)),
+        saturation: () => autoCurve(makeAnchor(0, 100), makeAnchor(100, 15))
       }
     };
   }
   return {
     Surfaces: {
-      lightness: () => [makeAnchor(0, 15, 5), makeAnchor(100, 47, 5)],
-      saturation: () => [makeAnchor(0, 100, 30), makeAnchor(100, 100, 30)]
+      lightness: () => autoCurve(makeAnchor(0, 15), makeAnchor(100, 47)),
+      saturation: () => autoCurve(makeAnchor(0, 100), makeAnchor(100, 100))
     },
     Borders: {
-      lightness: () => [makeAnchor(0, 25, 5), makeAnchor(100, 80, 5)],
-      saturation: () => [makeAnchor(0, 100, 30), makeAnchor(100, 100, 30)]
+      lightness: () => autoCurve(makeAnchor(0, 25), makeAnchor(100, 80)),
+      saturation: () => autoCurve(makeAnchor(0, 100), makeAnchor(100, 100))
     },
     Text: {
-      lightness: () => [makeAnchor(0, 120, 30), makeAnchor(100, 55, 30)],
-      saturation: () => [makeAnchor(0, 100, 30), makeAnchor(100, 15, 30)]
+      lightness: () => autoCurve(makeAnchor(0, 120), makeAnchor(100, 55)),
+      saturation: () => autoCurve(makeAnchor(0, 100), makeAnchor(100, 15))
     }
   };
 }
@@ -327,14 +344,16 @@ function scaleStepToX(step, scale) {
   return scale.steps.length > 1 ? idx / (scale.steps.length - 1) * 100 : 50;
 }
 function serializeDerivedValue(value) {
-  return value.kind === "raw" ? value.css : oklchToHexClamped(value.l, value.c, value.h);
+  return value.kind === "raw" ? value.css : oklchToCssClamped(value.l, value.c, value.h);
 }
-function computePaletteOklch(index, base, lightnessCurve, saturationCurve, curveOffset) {
-  const { c: baseC, h } = base;
+function computePaletteOklch(index, base, lightnessCurve, saturationCurve, curveOffset, hueCurve) {
+  const { c: baseC } = base;
   const xPos = stepIndexToX(index);
   const targetL = Math.max(0, Math.min(100, sampleCurve(lightnessCurve, xPos) + (curveOffset.lightness ?? 0))) / 100;
   const satMul = Math.max(0, Math.min(2, (sampleCurve(saturationCurve, xPos) + (curveOffset.saturation ?? 0)) / 100));
   const targetC = baseC * satMul;
+  const hueDelta = (hueCurve ? sampleCurve(hueCurve, xPos) : 0) + (curveOffset.hue ?? 0);
+  const h = hueDelta === 0 ? base.h : wrapHue(base.h + hueDelta);
   return gamutClamp(targetL, targetC, h);
 }
 function nearestPaletteStep(lightnessCurve, baseL) {
@@ -430,10 +449,12 @@ function syncBaseAnchor(cfg) {
   const fresh = prev === void 0;
   let lCurve = cfg.lightnessCurve;
   let sCurve = cfg.saturationCurve;
+  let hCurve = cfg.hueCurve;
   if (prev) {
     const prevX = stepIndexToX(prev.step);
     lCurve = liftCurveAnchor(lCurve, prevX, prev.displacedL);
     sCurve = liftCurveAnchor(sCurve, prevX, prev.displacedS);
+    if (hCurve) hCurve = liftCurveAnchor(hCurve, prevX, prev.displacedH);
   }
   const step = nearestPaletteStep(lCurve, cfg.baseColor.l);
   const x = stepIndexToX(step);
@@ -441,12 +462,19 @@ function syncBaseAnchor(cfg) {
   const s = setCurveAnchor(sCurve, x, 100, fresh);
   cfg.lightnessCurve = l.curve;
   cfg.saturationCurve = s.curve;
+  const h = hCurve ? setCurveAnchor(hCurve, x, 0, fresh) : void 0;
+  if (h) cfg.hueCurve = h.curve;
   cfg.anchorPlacement = {
     step,
     displacedL: l.displacedY,
     displacedS: s.displacedY,
+    displacedH: h?.displacedY,
     priorLightnessEndpoints: prev?.priorLightnessEndpoints ?? l.priorEndpoints,
-    priorSaturationEndpoints: prev?.priorSaturationEndpoints ?? s.priorEndpoints
+    priorSaturationEndpoints: prev?.priorSaturationEndpoints ?? s.priorEndpoints,
+    // No else-branch reading `prev?.priorHueEndpoints`: that could only fire
+    // if a placed hue curve later went absent, which RJC 7 (reset never
+    // deletes) never lets happen.
+    priorHueEndpoints: h ? prev?.priorHueEndpoints ?? h.priorEndpoints : void 0
   };
 }
 function computeDerivedOklch(step, base, scaleTitle, scaleCurves, curveOffset) {
@@ -455,8 +483,10 @@ function computeDerivedOklch(step, base, scaleTitle, scaleCurves, curveOffset) {
   const defs = defaultScaleCurves[scaleTitle];
   const lCurve = scaleCurves[scaleTitle]?.lightness ?? defs.lightness();
   const sCurve = scaleCurves[scaleTitle]?.saturation ?? defs.saturation();
+  const hCurve = scaleCurves[scaleTitle]?.hue;
   const lOff = curveOffset[`${scaleTitle}-lightness`] ?? 0;
   const sOff = curveOffset[`${scaleTitle}-saturation`] ?? 0;
+  const hOff = curveOffset[`${scaleTitle}-hue`] ?? 0;
   const { l: baseL, c: baseC, h: baseH } = base;
   let targetL;
   if (scale.isText) {
@@ -467,7 +497,9 @@ function computeDerivedOklch(step, base, scaleTitle, scaleCurves, curveOffset) {
   }
   const satMul = Math.max(0, Math.min(2, (sampleCurve(sCurve, xPos) + sOff) / 100));
   const targetC = baseC * satMul;
-  return gamutClamp(targetL, targetC, baseH);
+  const hueDelta = (hCurve ? sampleCurve(hCurve, xPos) : 0) + hOff;
+  const targetH = hueDelta === 0 ? baseH : wrapHue(baseH + hueDelta);
+  return gamutClamp(targetL, targetC, targetH);
 }
 function scaleToCssVar(scaleTitle, stepName, cssNamespace) {
   if (cssNamespace === null) return null;
@@ -496,7 +528,7 @@ function derivePaletteValues(spec, config) {
   const saturationCurve = config.saturationCurve ?? DEFAULT_PALETTE_SATURATION();
   PALETTE_STEPS.forEach((ps, index) => {
     const k = paletteStepKey(ps.label);
-    const value = k in overrides ? { kind: "color", ...overrides[k] } : { kind: "color", ...computePaletteOklch(index, baseColor, lightnessCurve, saturationCurve, curveOffset) };
+    const value = k in overrides ? { kind: "color", ...overrides[k] } : { kind: "color", ...computePaletteOklch(index, baseColor, lightnessCurve, saturationCurve, curveOffset, config.hueCurve) };
     out[`--color-${spec.cssNamespace}-${ps.label}`] = value;
   });
   for (const scale of SCALES) {
@@ -531,8 +563,8 @@ function derivePaletteValues(spec, config) {
       );
       const stopsCss = sortedStops.map((s) => {
         const stopValue = out[`--color-${spec.cssNamespace}-${s.paletteLabel}`];
-        const hex = stopValue ? serializeDerivedValue(stopValue) : "#000000";
-        return `${hex} ${s.position}%`;
+        const css = stopValue ? serializeDerivedValue(stopValue) : "oklch(0 0 0)";
+        return `${css} ${s.position}%`;
       }).join(", ");
       let gradient;
       switch (gradientStyle) {
@@ -551,13 +583,6 @@ function derivePaletteValues(spec, config) {
   }
   return out;
 }
-function derivePaletteVars(spec, config) {
-  const out = {};
-  for (const [k, v] of Object.entries(derivePaletteValues(spec, config))) {
-    out[k] = serializeDerivedValue(v);
-  }
-  return out;
-}
 function palettesToValues(palettes) {
   const out = {};
   for (const spec of PALETTE_SPECS) {
@@ -572,7 +597,6 @@ function palettesToVars(palettes) {
   }
   return out;
 }
-var HEX_RE = /^#[0-9a-f]{6}$/i;
 function reconcilePalettesFromCssVars(palettes, cssVars) {
   const next = structuredClone(palettes);
   const consumed = /* @__PURE__ */ new Set();
@@ -581,16 +605,17 @@ function reconcilePalettesFromCssVars(palettes, cssVars) {
     const current = next[spec.label];
     if (current === void 0) continue;
     if (current._imported === true) {
-      const anchorHex = cssVars[`--color-${spec.cssNamespace}-500`];
-      if (anchorHex && HEX_RE.test(anchorHex.trim())) {
-        next[spec.label] = { ...current, baseColor: hexToOklch(anchorHex.trim()), _imported: false };
+      const anchor = cssVars[`--color-${spec.cssNamespace}-500`];
+      const anchorOklch = anchor ? cssColorToOklch(anchor) : null;
+      if (anchorOklch) {
+        next[spec.label] = { ...current, baseColor: anchorOklch, _imported: false };
         syncBaseAnchor(next[spec.label]);
         snapped.add(spec.label);
       } else {
         next[spec.label] = { ...current, _imported: false };
       }
     }
-    for (const k of Object.keys(derivePaletteVars(spec, next[spec.label]))) {
+    for (const k of Object.keys(derivePaletteValues(spec, next[spec.label]))) {
       consumed.add(k);
     }
   }
@@ -1303,6 +1328,20 @@ var tokensCssMigration_2026_07_20_semanticTextStyles = {
   }
 };
 
+// vite-plugin/tokensCssMigrations/migrations/2026-08-19-oklch-color-values.ts
+var HEX_DECLARATION_RE = /(--[a-z0-9-]+:\s*)#([0-9a-f]{6})(?=\s*[;}])/gi;
+var tokensCssMigration_2026_08_19_oklchColorValues = {
+  id: "2026-08-19-oklch-color-values",
+  kind: "breaking",
+  description: "Rewrite hex token values as oklch()",
+  apply(css) {
+    return css.replace(HEX_DECLARATION_RE, (_match, prefix, hex) => {
+      const { l, c, h } = hexToOklch(`#${hex}`);
+      return `${prefix}${oklchToCss(l, c, h)}`;
+    });
+  }
+};
+
 // vite-plugin/tokensCssMigrations/index.ts
 var TOKENS_CSS_MIGRATIONS = [
   tokensCssMigration_2026_05_29_typographyScaleAdditions,
@@ -1311,7 +1350,8 @@ var TOKENS_CSS_MIGRATIONS = [
   tokensCssMigration_2026_06_04_removeDeadSizeIconScale,
   tokensCssMigration_2026_06_04_easingColorAndTypescaleAdditions,
   tokensCssMigration_2026_07_20_lineHeightRename,
-  tokensCssMigration_2026_07_20_semanticTextStyles
+  tokensCssMigration_2026_07_20_semanticTextStyles,
+  tokensCssMigration_2026_08_19_oklchColorValues
 ];
 function runTokensCssMigrations(css) {
   return foldMigrations(css, () => true);

package/dist-plugin/index.js

@@ -1,9 +1,8 @@
 import {
-  hexToOklch,
   palettesToVars,
   reconcilePalettesFromCssVars,
   sanitizeFileName
-} from "./chunk-76TFDTJO.js";
+} from "./chunk-JIGIIE5P.js";
 import {
   THEME_SCHEMA_VERSION,
   detectLegacyLayout,
@@ -18,7 +17,10 @@ import {
   runAdditiveTokensCssMigrations,
   runTokensCssMigrations,
   validateTokensCss
-} from "./chunk-44RSTAII.js";
+} from "./chunk-TKZBVIW5.js";
+import {
+  hexToOklch
+} from "./chunk-YR6GPXW2.js";
 import {
   resolveDataDirs
 } from "./chunk-D3ZVKOR4.js";

package/dist-plugin/{themeTypes-DSwKq-bj.d.cts → themeTypes-Dky03HL9.d.cts}

@@ -33,11 +33,21 @@ interface PaletteConfig {
     baseColor: Oklch;
     lightnessCurve: CurveAnchor[];
     saturationCurve: CurveAnchor[];
+    /** Signed hue offset in degrees per step, applied on top of the base hue.
+     *  Absent means flat zero: the palette holds one hue, which is what every
+     *  theme saved before this field did. */
+    hueCurve?: CurveAnchor[];
     scaleCurves: Record<string, {
         lightness: CurveAnchor[];
         saturation: CurveAnchor[];
+        hue?: CurveAnchor[];
     }>;
     curveOffset: Record<string, number>;
+    /** Per curve key: are the tangents derived from the points, or held by hand?
+     *  Only an explicit switch-off is recorded. A missing key means the curve's own
+     *  shape answers (`isAutoSmoothCurve`), which is what every theme saved before
+     *  the flag existed relies on. */
+    curveAutoSmooth?: Record<string, boolean>;
     overrides: Record<string, Oklch>;
     snappedScales: string[];
     emptyMode?: 'solid' | 'gradient';
@@ -50,11 +60,12 @@ interface PaletteConfig {
     /**
      * Where the base color sits in the ramp while `anchorToBase` is on: the
      * PALETTE_STEPS index whose curve anchors are pinned to the base color
-     * (lightness = base L, saturation = multiplier 100). `displacedL` /
-     * `displacedS` remember the y of a pre-existing anchor (endpoint or
-     * user-authored) the placement overwrote at that x, so moving the
-     * placement or toggling off restores it instead of deleting it.
-     * `priorLightnessEndpoints` / `priorSaturationEndpoints` remember the two
+     * (lightness = base L, saturation = multiplier 100, hue delta = 0 when a
+     * hue curve exists). `displacedL` / `displacedS` / `displacedH` remember
+     * the y of a pre-existing anchor (endpoint or user-authored) the placement
+     * overwrote at that x, so moving the placement or toggling off restores it
+     * instead of deleting it. `priorLightnessEndpoints` /
+     * `priorSaturationEndpoints` / `priorHueEndpoints` remember the two
      * endpoints exactly as they stood before the curve's first-ever placement
      * (a smoothed reshape, not algebraically invertible the way a later
      * scaled-handle re-placement is), so a clear can still restore the true
@@ -64,8 +75,10 @@ interface PaletteConfig {
         step: number;
         displacedL?: number;
         displacedS?: number;
+        displacedH?: number;
         priorLightnessEndpoints?: [CurveAnchor, CurveAnchor];
         priorSaturationEndpoints?: [CurveAnchor, CurveAnchor];
+        priorHueEndpoints?: [CurveAnchor, CurveAnchor];
     };
     /**
      * Set to true by importers when they overlay `cssVariables[--color-{ns}-*]`

package/dist-plugin/{themeTypes-DSwKq-bj.d.ts → themeTypes-Dky03HL9.d.ts}

@@ -33,11 +33,21 @@ interface PaletteConfig {
     baseColor: Oklch;
     lightnessCurve: CurveAnchor[];
     saturationCurve: CurveAnchor[];
+    /** Signed hue offset in degrees per step, applied on top of the base hue.
+     *  Absent means flat zero: the palette holds one hue, which is what every
+     *  theme saved before this field did. */
+    hueCurve?: CurveAnchor[];
     scaleCurves: Record<string, {
         lightness: CurveAnchor[];
         saturation: CurveAnchor[];
+        hue?: CurveAnchor[];
     }>;
     curveOffset: Record<string, number>;
+    /** Per curve key: are the tangents derived from the points, or held by hand?
+     *  Only an explicit switch-off is recorded. A missing key means the curve's own
+     *  shape answers (`isAutoSmoothCurve`), which is what every theme saved before
+     *  the flag existed relies on. */
+    curveAutoSmooth?: Record<string, boolean>;
     overrides: Record<string, Oklch>;
     snappedScales: string[];
     emptyMode?: 'solid' | 'gradient';
@@ -50,11 +60,12 @@ interface PaletteConfig {
     /**
      * Where the base color sits in the ramp while `anchorToBase` is on: the
      * PALETTE_STEPS index whose curve anchors are pinned to the base color
-     * (lightness = base L, saturation = multiplier 100). `displacedL` /
-     * `displacedS` remember the y of a pre-existing anchor (endpoint or
-     * user-authored) the placement overwrote at that x, so moving the
-     * placement or toggling off restores it instead of deleting it.
-     * `priorLightnessEndpoints` / `priorSaturationEndpoints` remember the two
+     * (lightness = base L, saturation = multiplier 100, hue delta = 0 when a
+     * hue curve exists). `displacedL` / `displacedS` / `displacedH` remember
+     * the y of a pre-existing anchor (endpoint or user-authored) the placement
+     * overwrote at that x, so moving the placement or toggling off restores it
+     * instead of deleting it. `priorLightnessEndpoints` /
+     * `priorSaturationEndpoints` / `priorHueEndpoints` remember the two
      * endpoints exactly as they stood before the curve's first-ever placement
      * (a smoothed reshape, not algebraically invertible the way a later
      * scaled-handle re-placement is), so a clear can still restore the true
@@ -64,8 +75,10 @@ interface PaletteConfig {
         step: number;
         displacedL?: number;
         displacedS?: number;
+        displacedH?: number;
         priorLightnessEndpoints?: [CurveAnchor, CurveAnchor];
         priorSaturationEndpoints?: [CurveAnchor, CurveAnchor];
+        priorHueEndpoints?: [CurveAnchor, CurveAnchor];
     };
     /**
      * Set to true by importers when they overlay `cssVariables[--color-{ns}-*]`

package/dist-plugin/tokensCssMigrations/index.cjs

@@ -33,6 +33,7 @@ __export(tokensCssMigrations_exports, {
   TOKENS_CSS_MIGRATIONS: () => TOKENS_CSS_MIGRATIONS,
   collectDefinedTokens: () => collectDefinedTokens,
   collectReferencedTokens: () => collectReferencedTokens,
+  collectTokenValues: () => collectTokenValues,
   enforceBreakingRequiresMajor: () => enforceBreakingRequiresMajor,
   ensureScale: () => ensureScale,
   findContractViolations: () => findContractViolations,
@@ -61,11 +62,17 @@ function extractGlobalRootBody(source) {
 // vite-plugin/tokensCssMigrations/cssTokenOps.ts
 var DECL_RE = /(^|[\s;{])(--[a-z0-9-]+)\s*:/gi;
 var REF_RE = /var\(\s*(--[a-z0-9-]+)/gi;
+var DECL_VALUE_RE = /(^|[\s;{])(--[a-z0-9-]+)\s*:([^;}]*)/gi;
 function collectDefinedTokens(css) {
   const out = /* @__PURE__ */ new Set();
   for (const m of css.matchAll(DECL_RE)) out.add(m[2]);
   return out;
 }
+function collectTokenValues(css) {
+  const out = /* @__PURE__ */ new Map();
+  for (const m of css.matchAll(DECL_VALUE_RE)) out.set(m[2], m[3].trim());
+  return out;
+}
 function collectReferencedTokens(css) {
   const out = /* @__PURE__ */ new Set();
   for (const m of css.matchAll(REF_RE)) out.add(m[1]);
@@ -399,6 +406,62 @@ var tokensCssMigration_2026_07_20_semanticTextStyles = {
   }
 };
 
+// src/system/internal/oklch.ts
+function srgbToLinear(c) {
+  return c <= 0.04045 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
+}
+function hexToLinearRgb(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;
+  return [srgbToLinear(r), srgbToLinear(g), srgbToLinear(b)];
+}
+function linearRgbToOklab(r, g, b) {
+  const l_ = 0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b;
+  const m_ = 0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b;
+  const s_ = 0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b;
+  const l = Math.cbrt(l_);
+  const m = Math.cbrt(m_);
+  const s = Math.cbrt(s_);
+  return [
+    0.2104542553 * l + 0.793617785 * m - 0.0040720468 * s,
+    1.9779984951 * l - 2.428592205 * m + 0.4505937099 * s,
+    0.0259040371 * l + 0.7827717662 * m - 0.808675766 * s
+  ];
+}
+function oklabToOklch(L, a, b) {
+  const c = Math.sqrt(a * a + b * b);
+  let h = Math.atan2(b, a) * 180 / Math.PI;
+  if (h < 0) h += 360;
+  return { l: L, c, h };
+}
+function hexToOklch(hex) {
+  const [r, g, b] = hexToLinearRgb(hex);
+  const [L, a, bVal] = linearRgbToOklab(r, g, b);
+  return oklabToOklch(L, a, bVal);
+}
+function trim(value, decimals) {
+  return Number(value.toFixed(decimals)).toString();
+}
+function oklchToCss(l, c, h) {
+  const cs = trim(c, 4);
+  return `oklch(${trim(l, 4)} ${cs} ${cs === "0" ? "0" : trim(h, 2)})`;
+}
+
+// vite-plugin/tokensCssMigrations/migrations/2026-08-19-oklch-color-values.ts
+var HEX_DECLARATION_RE = /(--[a-z0-9-]+:\s*)#([0-9a-f]{6})(?=\s*[;}])/gi;
+var tokensCssMigration_2026_08_19_oklchColorValues = {
+  id: "2026-08-19-oklch-color-values",
+  kind: "breaking",
+  description: "Rewrite hex token values as oklch()",
+  apply(css) {
+    return css.replace(HEX_DECLARATION_RE, (_match, prefix, hex) => {
+      const { l, c, h } = hexToOklch(`#${hex}`);
+      return `${prefix}${oklchToCss(l, c, h)}`;
+    });
+  }
+};
+
 // vite-plugin/files/dataPaths.ts
 var import_fs = __toESM(require("fs"), 1);
 var import_path = __toESM(require("path"), 1);
@@ -441,7 +504,8 @@ var TOKENS_CSS_MIGRATIONS = [
   tokensCssMigration_2026_06_04_removeDeadSizeIconScale,
   tokensCssMigration_2026_06_04_easingColorAndTypescaleAdditions,
   tokensCssMigration_2026_07_20_lineHeightRename,
-  tokensCssMigration_2026_07_20_semanticTextStyles
+  tokensCssMigration_2026_07_20_semanticTextStyles,
+  tokensCssMigration_2026_08_19_oklchColorValues
 ];
 function runTokensCssMigrations(css) {
   return foldMigrations(css, () => true);
@@ -466,10 +530,11 @@ function findContractViolations(canonicalCss) {
   const violations = [];
   for (const m of TOKENS_CSS_MIGRATIONS) {
     if (m.kind !== "additive") continue;
-    const before = collectDefinedTokens(canonicalCss);
-    const after = collectDefinedTokens(m.apply(canonicalCss));
-    const removed = [...before].filter((t) => !after.has(t)).sort();
-    if (removed.length) violations.push({ id: m.id, removed });
+    const before = collectTokenValues(canonicalCss);
+    const after = collectTokenValues(m.apply(canonicalCss));
+    const removed = [...before.keys()].filter((t) => !after.has(t)).sort();
+    const changed = [...before.entries()].filter(([t, v]) => after.has(t) && after.get(t) !== v).map(([t]) => t).sort();
+    if (removed.length || changed.length) violations.push({ id: m.id, removed, changed });
   }
   return violations;
 }
@@ -530,6 +595,7 @@ function validateTokensCss(input) {
   TOKENS_CSS_MIGRATIONS,
   collectDefinedTokens,
   collectReferencedTokens,
+  collectTokenValues,
   enforceBreakingRequiresMajor,
   ensureScale,
   findContractViolations,

package/dist-plugin/tokensCssMigrations/index.d.cts

@@ -52,6 +52,8 @@ interface TokensCssMigration {
  */
 /** Names declared as custom properties (`--x: …;`) anywhere in the source. */
 declare function collectDefinedTokens(css: string): Set<string>;
+/** Declared name → value, last declaration winning (as the cascade would). */
+declare function collectTokenValues(css: string): Map<string, string>;
 /** Names referenced via `var(--x)` anywhere in the source. */
 declare function collectReferencedTokens(css: string): Set<string>;
 interface ScaleEntry {
@@ -123,16 +125,25 @@ interface ContractViolation {
     id: string;
     /** Token names the migration removed or renamed away despite declaring `additive`. */
     removed: string[];
+    /** Token names whose value the migration rewrote despite declaring `additive`. */
+    changed: string[];
 }
 /**
- * Guardrail for the token-as-API contract: an `additive` migration must never
- * remove or rename a token. We verify behaviorally rather than trusting the
- * label — apply each additive migration to the package's own canonical
- * `tokens.css` (which defines the full current vocabulary) and flag any token
- * that disappears. A rename surfaces as the removal of its old name, so it is
- * caught too. This catches the dangerous direction: a breaking change shipped as
- * a backward-compatible one. (Over-labeling a no-op as `breaking` is harmless
- * and not checked.)
+ * Guardrail for the token-as-API contract: an `additive` migration must only
+ * ever insert new names — it must never remove or rename a token, and never
+ * rewrite the value of one a consumer already references. We verify
+ * behaviorally rather than trusting the label: apply each additive migration to
+ * the package's own canonical `tokens.css` (which defines the full current
+ * vocabulary) and flag any token that disappears or changes value. A rename
+ * surfaces as the removal of its old name, so it is caught too.
+ *
+ * The value half is what makes a value-rewriting migration (hex → `oklch()`)
+ * impossible to mislabel: it renames nothing, so a name-only guard would wave
+ * it through as additive and the dev plugin would auto-apply a breaking change
+ * to a consumer's vendored file.
+ *
+ * This catches the dangerous direction only. (Over-labeling a no-op as
+ * `breaking` is harmless and not checked.)
  */
 declare function findContractViolations(canonicalCss: string): ContractViolation[];
 type SemverBump = 'major' | 'minor' | 'patch' | 'none';
@@ -183,4 +194,4 @@ interface ValidateInput {
  */
 declare function validateTokensCss(input: ValidateInput): MissingToken[];
 
-export { type BreakingGateResult, type ComponentSource, type ContractViolation, type MissingToken, type RunResult, type SemverBump, TOKENS_CSS_MIGRATIONS, type TokensCssMigration, type ValidateInput, collectDefinedTokens, collectReferencedTokens, enforceBreakingRequiresMajor, ensureScale, findContractViolations, removeToken, removeTokensMatching, renameToken, runAdditiveTokensCssMigrations, runTokensCssMigrations, semverBumpType, validateTokensCss };
+export { type BreakingGateResult, type ComponentSource, type ContractViolation, type MissingToken, type RunResult, type SemverBump, TOKENS_CSS_MIGRATIONS, type TokensCssMigration, type ValidateInput, collectDefinedTokens, collectReferencedTokens, collectTokenValues, enforceBreakingRequiresMajor, ensureScale, findContractViolations, removeToken, removeTokensMatching, renameToken, runAdditiveTokensCssMigrations, runTokensCssMigrations, semverBumpType, validateTokensCss };