@cortex-js/compute-engine 0.55.6 → 0.56.0

package/dist/compile.esm.js

@@ -1,4 +1,4 @@
-/** Compute Engine 0.55.6 */
+/** Compute Engine 0.56.0 */
 
 // src/compute-engine/numerics/richardson.ts
 function extrapolate(f, x0, options = {}) {
@@ -1511,6 +1511,7 @@ var SCALAR_TYPES = [
 ];
 var VALUE_TYPES = [
   "value",
+  "color",
   ...COLLECTION_TYPES,
   ...SCALAR_TYPES
 ];
@@ -3206,6 +3207,7 @@ var PRIMITIVE_SUBTYPES = {
   symbol: [],
   boolean: [],
   string: [],
+  color: [],
   expression: EXPRESSION_TYPES
 };
 function isPrimitiveSubtype(lhs, rhs) {
@@ -8793,6 +8795,8 @@ var DEFINITIONS_ARITHMETIC = [
     precedence: DIVISION_PRECEDENCE,
     parse: "Mod"
   },
+  // Function-style alias: `\operatorname{mod}(a, b)`
+  { latexTrigger: "\\operatorname{mod}", parse: "Mod" },
   {
     latexTrigger: "\\pmod",
     kind: "prefix",
@@ -9033,6 +9037,13 @@ var DEFINITIONS_ARITHMETIC = [
       const rhs = serializer.wrap(operand(expr, 2), ADDITION_PRECEDENCE + 3);
       return joinLatex([lhs, "-", rhs]);
     }
+  },
+  // Euclidean distance between two points (tuples of numbers).
+  {
+    name: "Distance",
+    latexTrigger: ["\\operatorname{distance}"],
+    kind: "function",
+    serialize: (serializer, expr) => "\\operatorname{distance}" + serializer.wrapArguments(expr)
   }
 ];
 function getIndexAssignment(expr, upper) {
@@ -10457,7 +10468,9 @@ var DEFINITIONS_STATISTICS = [
       if (!expr || !symbol(expr)) return null;
       return ["Mean", expr];
     }
-  }
+  },
+  // Function-style alias: `\operatorname{var}(...)`
+  { latexTrigger: "\\operatorname{var}", parse: "Variance" }
 ];
 
 // src/compute-engine/numerics/unit-data.ts
@@ -11465,7 +11478,7 @@ var DEFINITIONS_OTHERS = [
         36: "\\qquad"
       }[v] ?? "";
     }
-  }
+  },
   // if (
   //   [
   //     '\\!',
@@ -11489,6 +11502,121 @@ var DEFINITIONS_OTHERS = [
   //     name: '',
   //     trigger: '\\check',
   // },
+  // ---------------------------------------------------------------------------
+  // Function-style aliases for collection / random operators that some
+  // notations write in lowercase (e.g. `\operatorname{shuffle}(L)`).
+  // The capitalized library entries already exist; these are pure parse
+  // aliases so the lowercase names don't land in `unsupported-operator`.
+  // ---------------------------------------------------------------------------
+  { latexTrigger: "\\operatorname{random}", parse: "Random" },
+  { latexTrigger: "\\operatorname{shuffle}", parse: "Shuffle" },
+  { latexTrigger: "\\operatorname{repeat}", parse: "Repeat" },
+  { latexTrigger: "\\operatorname{join}", parse: "Join" },
+  // ---------------------------------------------------------------------------
+  // Geometric primitive heads. Registered as known typed heads so consumers
+  // can branch on the operator name; CE itself doesn't render them. The
+  // library entries (with no evaluator) live in `library/core.ts`.
+  // ---------------------------------------------------------------------------
+  {
+    name: "Triangle",
+    latexTrigger: ["\\operatorname{triangle}"],
+    kind: "function",
+    serialize: (serializer, expr) => "\\operatorname{triangle}" + serializer.wrapArguments(expr)
+  },
+  // Desmos's geometric `vector(p1, p2)` — a directed segment between two
+  // points. Routed to a dedicated head (not the existing column-vector
+  // `Vector`, which has a narrower `(number+) -> vector` signature).
+  {
+    name: "GeometricVector",
+    latexTrigger: ["\\operatorname{vector}"],
+    kind: "function",
+    serialize: (serializer, expr) => "\\operatorname{vector}" + serializer.wrapArguments(expr)
+  },
+  {
+    name: "Sphere",
+    latexTrigger: ["\\operatorname{sphere}"],
+    kind: "function",
+    serialize: (serializer, expr) => "\\operatorname{sphere}" + serializer.wrapArguments(expr)
+  },
+  {
+    name: "Segment",
+    latexTrigger: ["\\operatorname{segment}"],
+    kind: "function",
+    serialize: (serializer, expr) => "\\operatorname{segment}" + serializer.wrapArguments(expr)
+  }
+];
+
+// src/compute-engine/latex-syntax/dictionary/definitions-colors.ts
+var DEFINITIONS_COLORS = [
+  // Color constructors (one per colorspace, preserves space on evaluation)
+  {
+    name: "Rgb",
+    latexTrigger: ["\\operatorname{rgb}"],
+    kind: "function",
+    serialize: (serializer, expr) => "\\operatorname{rgb}" + serializer.wrapArguments(expr)
+  },
+  {
+    name: "Hsv",
+    latexTrigger: ["\\operatorname{hsv}"],
+    kind: "function",
+    serialize: (serializer, expr) => "\\operatorname{hsv}" + serializer.wrapArguments(expr)
+  },
+  {
+    name: "Hsl",
+    latexTrigger: ["\\operatorname{hsl}"],
+    kind: "function",
+    serialize: (serializer, expr) => "\\operatorname{hsl}" + serializer.wrapArguments(expr)
+  },
+  {
+    name: "Oklab",
+    latexTrigger: ["\\operatorname{oklab}"],
+    kind: "function",
+    serialize: (serializer, expr) => "\\operatorname{oklab}" + serializer.wrapArguments(expr)
+  },
+  {
+    name: "Oklch",
+    latexTrigger: ["\\operatorname{oklch}"],
+    kind: "function",
+    serialize: (serializer, expr) => "\\operatorname{oklch}" + serializer.wrapArguments(expr)
+  },
+  // Conversion functions (color → color in the named space)
+  {
+    name: "AsRgb",
+    latexTrigger: ["\\operatorname{asRgb}"],
+    kind: "function",
+    serialize: (serializer, expr) => "\\operatorname{asRgb}" + serializer.wrapArguments(expr)
+  },
+  {
+    name: "AsHsv",
+    latexTrigger: ["\\operatorname{asHsv}"],
+    kind: "function",
+    serialize: (serializer, expr) => "\\operatorname{asHsv}" + serializer.wrapArguments(expr)
+  },
+  {
+    name: "AsHsl",
+    latexTrigger: ["\\operatorname{asHsl}"],
+    kind: "function",
+    serialize: (serializer, expr) => "\\operatorname{asHsl}" + serializer.wrapArguments(expr)
+  },
+  {
+    name: "AsOklab",
+    latexTrigger: ["\\operatorname{asOklab}"],
+    kind: "function",
+    serialize: (serializer, expr) => "\\operatorname{asOklab}" + serializer.wrapArguments(expr)
+  },
+  {
+    name: "AsOklch",
+    latexTrigger: ["\\operatorname{asOklch}"],
+    kind: "function",
+    serialize: (serializer, expr) => "\\operatorname{asOklch}" + serializer.wrapArguments(expr)
+  },
+  // Perceptual difference (returns a scalar in [0, ~1])
+  {
+    name: "ColorDelta",
+    latexTrigger: ["\\operatorname{colorDelta}"],
+    kind: "function",
+    serialize: (serializer, expr) => "\\operatorname{colorDelta}" + serializer.wrapArguments(expr)
+  }
 ];
 
 // src/compute-engine/latex-syntax/dictionary/default-dictionary.ts
@@ -11519,7 +11647,8 @@ var LATEX_DICTIONARY = [
   ...DEFINITIONS_STATISTICS,
   ...DEFINITIONS_UNITS,
   ...DEFINITIONS_OTHERS,
-  ...DEFINITIONS_PHYSICS
+  ...DEFINITIONS_PHYSICS,
+  ...DEFINITIONS_COLORS
 ];
 
 // src/math-json/symbols.ts
@@ -15154,8 +15283,7 @@ function compile(expr, options) {
         ce.pushScope();
         try {
           if (vars && typeof vars === "object") {
-            for (const [k, v] of Object.entries(vars))
-              ce.assign(k, v);
+            for (const [k, v] of Object.entries(vars)) ce.assign(k, v);
           }
           return expr.evaluate().re;
         } finally {
@@ -15242,8 +15370,7 @@ function tryGetComplexParts(expr, compile2) {
         return { re: null, im: formatFloat(iScale) };
       }
       const compiledFactors = remaining.map((r) => compile2(r));
-      if (iScale !== 1)
-        compiledFactors.unshift(formatFloat(iScale));
+      if (iScale !== 1) compiledFactors.unshift(formatFloat(iScale));
       const imCode = foldTerms(compiledFactors, "1.0", "*");
       return { re: null, im: imCode };
     }
@@ -15308,6 +15435,40 @@ function rgbToHsl(r, g, b) {
   else h = ((r - g) / d + 4) / 6;
   return { h: h * 360, s, l };
 }
+function hsvToRgb(h, s, v) {
+  h = (h % 360 + 360) % 360;
+  s = Math.max(0, Math.min(1, s));
+  v = Math.max(0, Math.min(1, v));
+  const c = v * s;
+  const x = c * (1 - Math.abs(h / 60 % 2 - 1));
+  const m = v - c;
+  let r = 0, g = 0, b = 0;
+  if (h < 60) [r, g, b] = [c, x, 0];
+  else if (h < 120) [r, g, b] = [x, c, 0];
+  else if (h < 180) [r, g, b] = [0, c, x];
+  else if (h < 240) [r, g, b] = [0, x, c];
+  else if (h < 300) [r, g, b] = [x, 0, c];
+  else [r, g, b] = [c, 0, x];
+  return { r: (r + m) * 255, g: (g + m) * 255, b: (b + m) * 255 };
+}
+function rgbToHsv(r, g, b) {
+  r /= 255;
+  g /= 255;
+  b /= 255;
+  const max2 = Math.max(r, g, b);
+  const min2 = Math.min(r, g, b);
+  const d = max2 - min2;
+  let h = 0;
+  if (d > 0) {
+    if (max2 === r) h = (g - b) / d % 6;
+    else if (max2 === g) h = (b - r) / d + 2;
+    else h = (r - g) / d + 4;
+    h *= 60;
+    if (h < 0) h += 360;
+  }
+  const s = max2 === 0 ? 0 : d / max2;
+  return { h, s, v: max2 };
+}
 function parseHexColor(s) {
   const hex = s.startsWith("#") ? s.substring(1) : s;
   let r, g, b;
@@ -15763,6 +15924,13 @@ var NAMED_COLORS = {
 };
 function parseColor(s, darkMode) {
   const str = s.trim().toLowerCase();
+  const opacityMatch = str.match(/^(.+?)\s*\/\s*(\d+(?:\.\d+)?)%?\s*$/);
+  if (opacityMatch) {
+    const base = parseColor(opacityMatch[1].trim(), darkMode);
+    const opacity = Math.max(0, Math.min(100, parseFloat(opacityMatch[2])));
+    const alpha = Math.round(opacity / 100 * 255);
+    return base & 4294967040 | alpha;
+  }
   if (str.startsWith("#")) {
     const hex = str.substring(1);
     let r, g, b, a = 255;
@@ -15895,14 +16063,6 @@ function parseColor(s, darkMode) {
   console.warn(`parseColor: unrecognized color "${s}"`);
   return 0;
 }
-function parseColorToRgb01(s, darkMode) {
-  const color = parseColor(s, darkMode);
-  return [
-    (color >>> 24 & 255) / 255,
-    (color >>> 16 & 255) / 255,
-    (color >>> 8 & 255) / 255
-  ];
-}
 function apca(bgColor, fgColor) {
   const bgRgb = asRgb(bgColor);
   const fgRgb = asRgb(fgColor);
@@ -15961,6 +16121,12 @@ function contrastingColor(arg) {
   const contrast2 = Math.abs(apca(fg2, bg));
   return contrast1 >= contrast2 ? asColorNumber(fg1) : asColorNumber(fg2);
 }
+function oklabDeltaE(a, b) {
+  const dL = a.L - b.L;
+  const da = a.a - b.a;
+  const db = a.b - b.b;
+  return Math.sqrt(dL * dL + da * da + db * db);
+}
 var TYCHO_11 = [
   "#4e79a7",
   // Blue
@@ -20172,39 +20338,130 @@ var JAVASCRIPT_FUNCTIONS = {
     if (args.length >= 2)
       return `_SYS.colormap(${compile2(args[0])}, ${compile2(args[1])})`;
     return `_SYS.colormap(${compile2(args[0])})`;
+  },
+  // -----------------------------------------------------------------------
+  // Color constructor heads. All compile to OKLCh arrays at runtime — the
+  // canonical color representation in this target. The constructors take
+  // their own colorspace's components and convert internally.
+  // (Mirrors the GPU target's design: color values are vec3 OKLCh.)
+  // -----------------------------------------------------------------------
+  Rgb: (args, compile2) => {
+    if (args.length < 3) throw new Error("Rgb: need 3 components");
+    return `_SYS.rgb(${args.map(compile2).join(", ")})`;
+  },
+  Hsv: (args, compile2) => {
+    if (args.length < 3) throw new Error("Hsv: need 3 components");
+    return `_SYS.hsv(${args.map(compile2).join(", ")})`;
+  },
+  Hsl: (args, compile2) => {
+    if (args.length < 3) throw new Error("Hsl: need 3 components");
+    return `_SYS.hsl(${args.map(compile2).join(", ")})`;
+  },
+  Oklab: (args, compile2) => {
+    if (args.length < 3) throw new Error("Oklab: need 3 components");
+    return `_SYS.oklab(${args.map(compile2).join(", ")})`;
+  },
+  Oklch: (args, compile2) => {
+    if (args.length < 3) throw new Error("Oklch: need 3 components");
+    return `_SYS.oklch(${args.map(compile2).join(", ")})`;
+  },
+  // -----------------------------------------------------------------------
+  // As* converters. Compile-time output convention matches the engine and
+  // the GPU target: each returns components in the named space as a 3- or
+  // 4-element array. `AsRgb` uses 0-1 sRGB channels (consistent across all
+  // layers). `AsOklch` is the identity (canonical form).
+  // -----------------------------------------------------------------------
+  AsRgb: ([c], compile2) => {
+    if (c === null) throw new Error("AsRgb: no argument");
+    return `_SYS.asRgb(${compile2(c)})`;
+  },
+  AsHsv: ([c], compile2) => {
+    if (c === null) throw new Error("AsHsv: no argument");
+    return `_SYS.asHsv(${compile2(c)})`;
+  },
+  AsHsl: ([c], compile2) => {
+    if (c === null) throw new Error("AsHsl: no argument");
+    return `_SYS.asHsl(${compile2(c)})`;
+  },
+  AsOklab: ([c], compile2) => {
+    if (c === null) throw new Error("AsOklab: no argument");
+    return `_SYS.asOklab(${compile2(c)})`;
+  },
+  AsOklch: ([c], compile2) => {
+    if (c === null) throw new Error("AsOklch: no argument");
+    return compile2(c);
+  },
+  // Perceptual color difference (ΔE_OK).
+  ColorDelta: ([a, b], compile2) => {
+    if (a === null || b === null)
+      throw new Error("ColorDelta: need two colors");
+    return `_SYS.colorDelta(${compile2(a)}, ${compile2(b)})`;
+  },
+  // Euclidean distance between two tuples (any positive dimension).
+  // The GPU target maps `Distance` to the GLSL/WGSL `distance()` builtin
+  // (vec-only); this JS handler works on plain arrays of any length.
+  Distance: ([a, b], compile2) => {
+    if (a === null || b === null) throw new Error("Distance: need two points");
+    return `_SYS.distance(${compile2(a)}, ${compile2(b)})`;
   }
 };
 function toRI(c) {
   return { re: c.re, im: c.im };
 }
+function normalizeAlpha(a) {
+  if (a === void 0) return void 0;
+  if (!Number.isFinite(a)) return void 0;
+  if (Math.abs(a - 1) < 1e-9) return void 0;
+  return a;
+}
 function toRgb255(input) {
   if (typeof input === "string") {
     const c = parseColor(input);
-    return {
+    const rgb2 = {
       r: c >>> 24 & 255,
       g: c >>> 16 & 255,
-      b: c >>> 8 & 255,
-      alpha: (c & 255) / 255
+      b: c >>> 8 & 255
     };
+    const alpha = normalizeAlpha((c & 255) / 255);
+    if (alpha !== void 0) rgb2.alpha = alpha;
+    return rgb2;
+  }
+  const rgb = oklchToRgb({ L: input[0], C: input[1], H: input[2] });
+  if (input.length >= 4) {
+    const alpha = normalizeAlpha(input[3]);
+    if (alpha !== void 0) rgb.alpha = alpha;
   }
-  const rgb = {
-    r: input[0] * 255,
-    g: input[1] * 255,
-    b: input[2] * 255
-  };
-  if (input.length >= 4) rgb.alpha = input[3];
   return rgb;
 }
-function packedToArray(c) {
-  const r = (c >>> 24 & 255) / 255;
-  const g = (c >>> 16 & 255) / 255;
-  const b = (c >>> 8 & 255) / 255;
-  const a = (c & 255) / 255;
-  return Math.abs(a - 1) < 1e-4 ? [r, g, b] : [r, g, b, a];
+function toOklch(input) {
+  if (typeof input === "string") {
+    const c = parseColor(input);
+    const r = c >>> 24 & 255;
+    const g = c >>> 16 & 255;
+    const b = c >>> 8 & 255;
+    const oklch2 = rgbToOklch({ r, g, b });
+    const alpha = normalizeAlpha((c & 255) / 255);
+    if (alpha !== void 0) oklch2.alpha = alpha;
+    return oklch2;
+  }
+  return {
+    L: input[0],
+    C: input[1],
+    H: input[2],
+    alpha: input.length >= 4 ? normalizeAlpha(input[3]) : void 0
+  };
+}
+function packedToOklch(c) {
+  const r = c >>> 24 & 255;
+  const g = c >>> 16 & 255;
+  const b = c >>> 8 & 255;
+  const oklch2 = rgbToOklch({ r, g, b });
+  const alpha = normalizeAlpha((c & 255) / 255);
+  return alpha !== void 0 ? [oklch2.L, oklch2.C, oklch2.H, alpha] : [oklch2.L, oklch2.C, oklch2.H];
 }
 var colorHelpers = {
   color(input) {
-    return packedToArray(parseColor(input));
+    return packedToOklch(parseColor(input));
   },
   colorToString(input, format) {
     const rgb = toRgb255(input);
@@ -20215,7 +20472,7 @@ var colorHelpers = {
         const g = Math.round(Math.max(0, Math.min(255, rgb.g)));
         const b = Math.round(Math.max(0, Math.min(255, rgb.b)));
         let hex = `#${r.toString(16).padStart(2, "0")}${g.toString(16).padStart(2, "0")}${b.toString(16).padStart(2, "0")}`;
-        if (rgb.alpha !== void 0 && Math.abs(rgb.alpha - 1) > 1e-4) {
+        if (rgb.alpha !== void 0) {
           const a = Math.round(Math.max(0, Math.min(255, rgb.alpha * 255)));
           hex += a.toString(16).padStart(2, "0");
         }
@@ -20225,7 +20482,7 @@ var colorHelpers = {
         const r = Math.round(rgb.r);
         const g = Math.round(rgb.g);
         const b = Math.round(rgb.b);
-        if (rgb.alpha !== void 0 && Math.abs(rgb.alpha - 1) > 1e-4)
+        if (rgb.alpha !== void 0)
           return `rgb(${r} ${g} ${b} / ${rgb.alpha})`;
         return `rgb(${r} ${g} ${b})`;
       }
@@ -20234,7 +20491,7 @@ var colorHelpers = {
         const h = Math.round(hsl.h * 10) / 10;
         const s = Math.round(hsl.s * 1e3) / 10;
         const l = Math.round(hsl.l * 1e3) / 10;
-        if (rgb.alpha !== void 0 && Math.abs(rgb.alpha - 1) > 1e-4)
+        if (rgb.alpha !== void 0)
           return `hsl(${h} ${s}% ${l}% / ${rgb.alpha})`;
         return `hsl(${h} ${s}% ${l}%)`;
       }
@@ -20243,7 +20500,7 @@ var colorHelpers = {
         const L = Math.round(c.L * 1e3) / 1e3;
         const C = Math.round(c.C * 1e3) / 1e3;
         const H = Math.round(c.H * 10) / 10;
-        if (rgb.alpha !== void 0 && Math.abs(rgb.alpha - 1) > 1e-4)
+        if (rgb.alpha !== void 0)
           return `oklch(${L} ${C} ${H} / ${rgb.alpha})`;
         return `oklch(${L} ${C} ${H})`;
       }
@@ -20252,29 +20509,29 @@ var colorHelpers = {
     }
   },
   colorMix(input1, input2, ratio = 0.5) {
-    const rgb1 = toRgb255(input1);
-    const rgb2 = toRgb255(input2);
+    const c1 = toOklch(input1);
+    const c2 = toOklch(input2);
     ratio = Math.max(0, Math.min(1, ratio));
-    const c1 = rgbToOklch(rgb1);
-    const c2 = rgbToOklch(rgb2);
-    let dh = c2.H - c1.H;
-    if (dh > 180) dh -= 360;
-    if (dh < -180) dh += 360;
-    let H = c1.H + dh * ratio;
-    if (H < 0) H += 360;
-    if (H >= 360) H -= 360;
-    const mixed = oklchToRgb({
-      L: c1.L + (c2.L - c1.L) * ratio,
-      C: c1.C + (c2.C - c1.C) * ratio,
-      H
-    });
-    const r = mixed.r / 255;
-    const g = mixed.g / 255;
-    const b = mixed.b / 255;
-    const a1 = rgb1.alpha ?? 1;
-    const a2 = rgb2.alpha ?? 1;
-    const alpha = a1 + (a2 - a1) * ratio;
-    return Math.abs(alpha - 1) > 1e-4 ? [r, g, b, alpha] : [r, g, b];
+    const c1Achromatic = c1.C < 1e-6;
+    const c2Achromatic = c2.C < 1e-6;
+    let H;
+    if (c1Achromatic && c2Achromatic) H = c1.H;
+    else if (c1Achromatic) H = c2.H;
+    else if (c2Achromatic) H = c1.H;
+    else {
+      let dh = c2.H - c1.H;
+      if (dh > 180) dh -= 360;
+      if (dh < -180) dh += 360;
+      H = c1.H + dh * ratio;
+      if (H < 0) H += 360;
+      if (H >= 360) H -= 360;
+    }
+    const L = c1.L + (c2.L - c1.L) * ratio;
+    const C = c1.C + (c2.C - c1.C) * ratio;
+    const a1 = c1.alpha ?? 1;
+    const a2 = c2.alpha ?? 1;
+    const alpha = normalizeAlpha(a1 + (a2 - a1) * ratio);
+    return alpha !== void 0 ? [L, C, H, alpha] : [L, C, H];
   },
   colorContrast(bg, fg) {
     return apca(toRgb255(bg), toRgb255(fg));
@@ -20282,11 +20539,11 @@ var colorHelpers = {
   contrastingColor(bg, fg1, fg2) {
     const bgRgb = toRgb255(bg);
     if (fg1 !== void 0 && fg2 !== void 0) {
-      return packedToArray(
+      return packedToOklch(
         contrastingColor({ bg: bgRgb, fg1: toRgb255(fg1), fg2: toRgb255(fg2) })
       );
     }
-    return packedToArray(contrastingColor(bgRgb));
+    return packedToOklch(contrastingColor(bgRgb));
   },
   colorToColorspace(input, space) {
     const rgb = toRgb255(input);
@@ -20315,7 +20572,7 @@ var colorHelpers = {
       default:
         throw new Error(`Unknown color space: ${space}`);
     }
-    if (alpha !== void 0 && Math.abs(alpha - 1) > 1e-4) result.push(alpha);
+    if (alpha !== void 0) result.push(alpha);
     return result;
   },
   colormap(name, arg) {
@@ -20327,7 +20584,7 @@ var colorHelpers = {
     const palette = allPalettes[name];
     if (!palette) throw new Error(`Unknown palette: ${name}`);
     const colors = palette.map(
-      (hex) => parseColorToRgb01(hex)
+      (hex) => packedToOklch(parseColor(hex))
     );
     if (arg === void 0) return colors;
     if (Number.isInteger(arg) && arg >= 2) {
@@ -20351,62 +20608,128 @@ var colorHelpers = {
     const frac = pos - i;
     if (frac === 0 || i >= colors.length - 1)
       return [...colors[Math.min(i, colors.length - 1)]];
-    const rgb1 = {
-      r: colors[i][0] * 255,
-      g: colors[i][1] * 255,
-      b: colors[i][2] * 255
-    };
-    const rgb2 = {
-      r: colors[i + 1][0] * 255,
-      g: colors[i + 1][1] * 255,
-      b: colors[i + 1][2] * 255
-    };
-    const c1 = rgbToOklch(rgb1);
-    const c2 = rgbToOklch(rgb2);
-    let dh = c2.H - c1.H;
-    if (dh > 180) dh -= 360;
-    if (dh < -180) dh += 360;
-    let H = c1.H + dh * frac;
-    if (H < 0) H += 360;
-    if (H >= 360) H -= 360;
-    const mixed = oklchToRgb({
-      L: c1.L + (c2.L - c1.L) * frac,
-      C: c1.C + (c2.C - c1.C) * frac,
-      H
-    });
-    return [mixed.r / 255, mixed.g / 255, mixed.b / 255];
+    const [L1, C1, H1] = colors[i];
+    const [L2, C2, H2] = colors[i + 1];
+    const c1Achromatic = C1 < 1e-6;
+    const c2Achromatic = C2 < 1e-6;
+    let H;
+    if (c1Achromatic && c2Achromatic) H = H1;
+    else if (c1Achromatic) H = H2;
+    else if (c2Achromatic) H = H1;
+    else {
+      let dh = H2 - H1;
+      if (dh > 180) dh -= 360;
+      if (dh < -180) dh += 360;
+      H = H1 + dh * frac;
+      if (H < 0) H += 360;
+      if (H >= 360) H -= 360;
+    }
+    return [L1 + (L2 - L1) * frac, C1 + (C2 - C1) * frac, H];
   },
   colorFromColorspace(components, space) {
     const c0 = components[0];
     const c1 = components[1];
     const c2 = components[2];
     const alpha = components.length >= 4 ? components[3] : void 0;
-    let result;
+    let oklch2;
     switch (space.toLowerCase()) {
       case "rgb":
-        result = [c0, c1, c2];
+        oklch2 = rgbToOklch({ r: c0 * 255, g: c1 * 255, b: c2 * 255 });
         break;
       case "hsl": {
-        const r = hslToRgb(c0, c1, c2);
-        result = [r.r / 255, r.g / 255, r.b / 255];
+        const rgb = hslToRgb(c0, c1, c2);
+        oklch2 = rgbToOklch(rgb);
         break;
       }
-      case "oklch": {
-        const r = oklchToRgb({ L: c0, C: c1, H: c2 });
-        result = [r.r / 255, r.g / 255, r.b / 255];
+      case "oklch":
+        oklch2 = { L: c0, C: c1, H: c2 };
         break;
-      }
       case "oklab":
-      case "lab": {
-        const r = oklabToRgb({ L: c0, a: c1, b: c2 });
-        result = [r.r / 255, r.g / 255, r.b / 255];
+      case "lab":
+        oklch2 = oklabToOklch({ L: c0, a: c1, b: c2 });
         break;
-      }
       default:
         throw new Error(`Unknown color space: ${space}`);
     }
-    if (alpha !== void 0 && Math.abs(alpha - 1) > 1e-4) result.push(alpha);
-    return result;
+    return alpha !== void 0 ? [oklch2.L, oklch2.C, oklch2.H, alpha] : [oklch2.L, oklch2.C, oklch2.H];
+  },
+  // -----------------------------------------------------------------------
+  // Color constructors. Each accepts components in its colorspace's natural
+  // units and returns the canonical OKLCh array `[L, C, H]` (or with alpha).
+  // -----------------------------------------------------------------------
+  rgb(r, g, b, alpha) {
+    const c = rgbToOklch({ r: r * 255, g: g * 255, b: b * 255 });
+    const a = normalizeAlpha(alpha);
+    return a !== void 0 ? [c.L, c.C, c.H, a] : [c.L, c.C, c.H];
+  },
+  hsv(h, s, v, alpha) {
+    const rgb = hsvToRgb(h, s, v);
+    const c = rgbToOklch(rgb);
+    const a = normalizeAlpha(alpha);
+    return a !== void 0 ? [c.L, c.C, c.H, a] : [c.L, c.C, c.H];
+  },
+  hsl(h, s, l, alpha) {
+    const rgb = hslToRgb(h, s, l);
+    const c = rgbToOklch({ r: rgb.r, g: rgb.g, b: rgb.b });
+    const a = normalizeAlpha(alpha);
+    return a !== void 0 ? [c.L, c.C, c.H, a] : [c.L, c.C, c.H];
+  },
+  oklab(L, a, b, alpha) {
+    const c = oklabToOklch({ L, a, b });
+    const al = normalizeAlpha(alpha);
+    return al !== void 0 ? [c.L, c.C, c.H, al] : [c.L, c.C, c.H];
+  },
+  oklch(L, C, H, alpha) {
+    const a = normalizeAlpha(alpha);
+    return a !== void 0 ? [L, C, H, a] : [L, C, H];
+  },
+  // -----------------------------------------------------------------------
+  // As* converters. Inputs are anything `toOklch` accepts (string, packed
+  // int, or OKLCh array). Outputs are 3- or 4-element arrays in the named
+  // space. sRGB-based outputs (asRgb/asHsv/asHsl) use 0-1 channels for
+  // consistency with the GPU target's shader convention.
+  // -----------------------------------------------------------------------
+  asRgb(input) {
+    const rgb = toRgb255(input);
+    const r = rgb.r / 255;
+    const g = rgb.g / 255;
+    const b = rgb.b / 255;
+    return rgb.alpha !== void 0 ? [r, g, b, rgb.alpha] : [r, g, b];
+  },
+  asHsv(input) {
+    const rgb = toRgb255(input);
+    const hsv = rgbToHsv(rgb.r, rgb.g, rgb.b);
+    return rgb.alpha !== void 0 ? [hsv.h, hsv.s, hsv.v, rgb.alpha] : [hsv.h, hsv.s, hsv.v];
+  },
+  asHsl(input) {
+    const rgb = toRgb255(input);
+    const hsl = rgbToHsl(rgb.r, rgb.g, rgb.b);
+    return rgb.alpha !== void 0 ? [hsl.h, hsl.s, hsl.l, rgb.alpha] : [hsl.h, hsl.s, hsl.l];
+  },
+  asOklab(input) {
+    const c = toOklch(input);
+    const lab = oklchToOklab({ L: c.L, C: c.C, H: c.H });
+    return c.alpha !== void 0 ? [lab.L, lab.a, lab.b, c.alpha] : [lab.L, lab.a, lab.b];
+  },
+  // asOklch is identity — handled at compile time as a pass-through
+  // Perceptual color difference (ΔE_OK).
+  colorDelta(a, b) {
+    const labA = oklchToOklab(toOklch(a));
+    const labB = oklchToOklab(toOklch(b));
+    return oklabDeltaE(labA, labB);
+  },
+  // Euclidean distance between two tuples. Plain numeric — not a color
+  // operation despite living in the same helpers block.
+  distance(a, b) {
+    if (!Array.isArray(a) || !Array.isArray(b))
+      throw new Error("Distance: expected two arrays");
+    if (a.length !== b.length) throw new Error("Distance: dimension mismatch");
+    let sumSq = 0;
+    for (let i = 0; i < a.length; i++) {
+      const d = a[i] - b[i];
+      sumSq += d * d;
+    }
+    return Math.sqrt(sumSq);
   }
 };
 var SYS_HELPERS = {
@@ -20845,6 +21168,13 @@ var GPU_OPERATORS = {
 function gpuVec2(target) {
   return target?.language === "wgsl" ? "vec2f" : "vec2";
 }
+function gpuVec3(target) {
+  return target?.language === "wgsl" ? "vec3f" : "vec3";
+}
+function readStringLiteral(expr) {
+  if (!isString(expr)) return null;
+  return expr.string?.toLowerCase() ?? null;
+}
 function compileIntArg(expr, compile2, target) {
   const c = tryGetConstant(expr);
   if (c !== void 0 && Number.isInteger(c)) return c.toString();
@@ -20903,7 +21233,7 @@ function compileGPUSumProduct(kind, args, _compile, target) {
     `for (${indexDecl} = ${lowerStr}; ${index} <= ${upperStr}; ${index}++) {`,
     `  ${acc} ${op}= ${body};`,
     `}`,
-    `return ${acc}`
+    `return ${acc};`
   ];
   return lines.join("\n");
 }
@@ -20957,8 +21287,7 @@ var GPU_FUNCTIONS = {
       const iScale = isSymbol2(iFactor, "ImaginaryUnit") ? 1 : iFactor.im;
       const realFactors = args.filter((_, i) => i !== iIndex);
       const v2 = gpuVec2(target);
-      if (realFactors.length === 0)
-        return `${v2}(0.0, ${formatFloat(iScale)})`;
+      if (realFactors.length === 0) return `${v2}(0.0, ${formatFloat(iScale)})`;
       const factors = realFactors.map((f) => compile2(f));
       if (iScale !== 1) factors.unshift(formatFloat(iScale));
       const imCode = foldTerms(factors, "1.0", "*");
@@ -21011,8 +21340,7 @@ var GPU_FUNCTIONS = {
     if (isNumber(x) && x.im !== 0) {
       return `${gpuVec2(target)}(${formatFloat(-x.re)}, ${formatFloat(-x.im)})`;
     }
-    if (isSymbol2(x, "ImaginaryUnit"))
-      return `${gpuVec2(target)}(0.0, -1.0)`;
+    if (isSymbol2(x, "ImaginaryUnit")) return `${gpuVec2(target)}(0.0, -1.0)`;
     return `(-${compile2(x)})`;
   },
   // Standard math functions with complex dispatch
@@ -21385,17 +21713,127 @@ var GPU_FUNCTIONS = {
     }
     const isWGSL = target?.language === "wgsl";
     const v3 = isWGSL ? "vec3f" : "vec3";
-    return `((_gpu_apca(${bg}, ${v3}(0.0)) > 50.0) ? ${v3}(0.0) : ${v3}(1.0))`;
+    const black = `${v3}(0.0)`;
+    const white = `${v3}(1.0, 0.0, 0.0)`;
+    return `((_gpu_apca(${bg}, ${black}) > 50.0) ? ${black} : ${white})`;
   },
   ColorToColorspace: ([color, space], compile2) => {
     if (color === null || space === null)
       throw new Error("ColorToColorspace: need color and space");
-    return `_gpu_srgb_to_oklab(${compile2(color)})`;
+    const spaceName = readStringLiteral(space);
+    if (spaceName === null)
+      throw new Error("ColorToColorspace: space must be a string literal");
+    const c = compile2(color);
+    switch (spaceName) {
+      case "oklch":
+        return c;
+      case "oklab":
+      case "lab":
+        return `_gpu_oklch_to_oklab(${c})`;
+      case "rgb":
+        return `_gpu_oklch_to_srgb(${c})`;
+      case "hsl":
+        return `_gpu_rgb_to_hsl(_gpu_oklch_to_srgb(${c}))`;
+      case "hsv":
+        return `_gpu_rgb_to_hsv(_gpu_oklch_to_srgb(${c}))`;
+      default:
+        throw new Error(
+          `ColorToColorspace: unsupported space "${spaceName}" on GPU target`
+        );
+    }
   },
   ColorFromColorspace: ([components, space], compile2) => {
     if (components === null || space === null)
       throw new Error("ColorFromColorspace: need components and space");
-    return `_gpu_oklab_to_srgb(${compile2(components)})`;
+    const spaceName = readStringLiteral(space);
+    if (spaceName === null)
+      throw new Error("ColorFromColorspace: space must be a string literal");
+    const c = compile2(components);
+    switch (spaceName) {
+      case "oklch":
+        return c;
+      case "oklab":
+      case "lab":
+        return `_gpu_oklab_to_oklch(${c})`;
+      case "rgb":
+        return `_gpu_srgb_to_oklch(${c})`;
+      case "hsl":
+        return `_gpu_srgb_to_oklch(_gpu_hsl_to_rgb(${c}))`;
+      case "hsv":
+        return `_gpu_srgb_to_oklch(_gpu_hsv_to_rgb(${c}))`;
+      default:
+        throw new Error(
+          `ColorFromColorspace: unsupported space "${spaceName}" on GPU target`
+        );
+    }
+  },
+  // ---------------------------------------------------------------------------
+  // Color literals. Each typed head compiles to a canonical OKLCh vec3.
+  // Alpha (4th argument) is dropped — GPU color values are vec3 only. Pass
+  // alpha as a separate uniform if it's needed at the framebuffer boundary.
+  // ---------------------------------------------------------------------------
+  Color: ([s], _compile, target) => {
+    if (s === null) throw new Error("Color: no argument");
+    const str = readStringLiteral(s);
+    if (str === null)
+      throw new Error("Color: argument must be a string literal on GPU target");
+    const packed = parseColor(str);
+    if (packed === 0 && str.trim().toLowerCase() !== "transparent")
+      throw new Error(`Color: invalid color string "${str}"`);
+    const r = packed >>> 24 & 255;
+    const g = packed >>> 16 & 255;
+    const b = packed >>> 8 & 255;
+    const oklch2 = rgbToOklch({ r, g, b });
+    return `${gpuVec3(target)}(${formatFloat(oklch2.L)}, ${formatFloat(oklch2.C)}, ${formatFloat(oklch2.H)})`;
+  },
+  Rgb: (args, compile2, target) => {
+    if (args.length < 3) throw new Error("Rgb: need 3 components");
+    const v3 = gpuVec3(target);
+    return `_gpu_srgb_to_oklch(${v3}(${compile2(args[0])}, ${compile2(args[1])}, ${compile2(args[2])}))`;
+  },
+  Hsv: (args, compile2, target) => {
+    if (args.length < 3) throw new Error("Hsv: need 3 components");
+    const v3 = gpuVec3(target);
+    return `_gpu_srgb_to_oklch(_gpu_hsv_to_rgb(${v3}(${compile2(args[0])}, ${compile2(args[1])}, ${compile2(args[2])})))`;
+  },
+  Hsl: (args, compile2, target) => {
+    if (args.length < 3) throw new Error("Hsl: need 3 components");
+    const v3 = gpuVec3(target);
+    return `_gpu_srgb_to_oklch(_gpu_hsl_to_rgb(${v3}(${compile2(args[0])}, ${compile2(args[1])}, ${compile2(args[2])})))`;
+  },
+  Oklab: (args, compile2, target) => {
+    if (args.length < 3) throw new Error("Oklab: need 3 components");
+    const v3 = gpuVec3(target);
+    return `_gpu_oklab_to_oklch(${v3}(${compile2(args[0])}, ${compile2(args[1])}, ${compile2(args[2])}))`;
+  },
+  Oklch: (args, compile2, target) => {
+    if (args.length < 3) throw new Error("Oklch: need 3 components");
+    const v3 = gpuVec3(target);
+    return `${v3}(${compile2(args[0])}, ${compile2(args[1])}, ${compile2(args[2])})`;
+  },
+  // ---------------------------------------------------------------------------
+  // As* operators. AsOklch is identity (canonical). The other As* return
+  // components in the named space, equivalent to ColorToColorspace(c, 'x').
+  // ---------------------------------------------------------------------------
+  AsOklch: ([c], compile2) => {
+    if (c === null) throw new Error("AsOklch: no argument");
+    return compile2(c);
+  },
+  AsOklab: ([c], compile2) => {
+    if (c === null) throw new Error("AsOklab: no argument");
+    return `_gpu_oklch_to_oklab(${compile2(c)})`;
+  },
+  AsRgb: ([c], compile2) => {
+    if (c === null) throw new Error("AsRgb: no argument");
+    return `_gpu_oklch_to_srgb(${compile2(c)})`;
+  },
+  AsHsv: ([c], compile2) => {
+    if (c === null) throw new Error("AsHsv: no argument");
+    return `_gpu_rgb_to_hsv(_gpu_oklch_to_srgb(${compile2(c)}))`;
+  },
+  AsHsl: ([c], compile2) => {
+    if (c === null) throw new Error("AsHsl: no argument");
+    return `_gpu_rgb_to_hsl(_gpu_oklch_to_srgb(${compile2(c)}))`;
   },
   // Fractal functions
   Mandelbrot: ([c, maxIter], compile2, target) => {
@@ -22088,28 +22526,124 @@ vec3 _gpu_oklab_to_srgb(vec3 lab) {
 
 vec3 _gpu_oklab_to_oklch(vec3 lab) {
   float C = length(lab.yz);
-  float H = atan(lab.z, lab.y);
+  float H = atan(lab.z, lab.y) * (180.0 / 3.14159265359);
+  if (H < 0.0) H += 360.0;
   return vec3(lab.x, C, H);
 }
 
 vec3 _gpu_oklch_to_oklab(vec3 lch) {
-  return vec3(lch.x, lch.y * cos(lch.z), lch.y * sin(lch.z));
+  float h_rad = lch.z * (3.14159265359 / 180.0);
+  return vec3(lch.x, lch.y * cos(h_rad), lch.y * sin(h_rad));
+}
+
+vec3 _gpu_srgb_to_oklch(vec3 rgb) {
+  return _gpu_oklab_to_oklch(_gpu_srgb_to_oklab(rgb));
+}
+
+vec3 _gpu_oklch_to_srgb(vec3 lch) {
+  return _gpu_oklab_to_srgb(_gpu_oklch_to_oklab(lch));
+}
+
+// HSL conversion. Hue in degrees, saturation/lightness in 0-1.
+vec3 _gpu_hsl_to_rgb(vec3 hsl) {
+  float h = hsl.x;
+  float s = hsl.y;
+  float l = hsl.z;
+  float c = (1.0 - abs(2.0 * l - 1.0)) * s;
+  float h6 = h / 60.0;
+  float x = c * (1.0 - abs(mod(h6, 2.0) - 1.0));
+  float r = 0.0;
+  float g = 0.0;
+  float b = 0.0;
+  if (h6 < 1.0)      { r = c; g = x; b = 0.0; }
+  else if (h6 < 2.0) { r = x; g = c; b = 0.0; }
+  else if (h6 < 3.0) { r = 0.0; g = c; b = x; }
+  else if (h6 < 4.0) { r = 0.0; g = x; b = c; }
+  else if (h6 < 5.0) { r = x; g = 0.0; b = c; }
+  else               { r = c; g = 0.0; b = x; }
+  float m = l - c / 2.0;
+  return vec3(r + m, g + m, b + m);
+}
+
+vec3 _gpu_rgb_to_hsl(vec3 rgb) {
+  float maxc = max(max(rgb.x, rgb.y), rgb.z);
+  float minc = min(min(rgb.x, rgb.y), rgb.z);
+  float l = (maxc + minc) / 2.0;
+  float d = maxc - minc;
+  if (d < 1e-6) return vec3(0.0, 0.0, l);
+  float s = d / (1.0 - abs(2.0 * l - 1.0));
+  float h;
+  if (maxc == rgb.x)      h = mod((rgb.y - rgb.z) / d, 6.0);
+  else if (maxc == rgb.y) h = (rgb.z - rgb.x) / d + 2.0;
+  else                    h = (rgb.x - rgb.y) / d + 4.0;
+  h *= 60.0;
+  if (h < 0.0) h += 360.0;
+  return vec3(h, s, l);
+}
+
+// HSV conversion. Hue in degrees, saturation/value in 0-1.
+vec3 _gpu_hsv_to_rgb(vec3 hsv) {
+  float h = hsv.x;
+  float s = hsv.y;
+  float v = hsv.z;
+  float c = v * s;
+  float h6 = h / 60.0;
+  float x = c * (1.0 - abs(mod(h6, 2.0) - 1.0));
+  float r = 0.0;
+  float g = 0.0;
+  float b = 0.0;
+  if (h6 < 1.0)      { r = c; g = x; b = 0.0; }
+  else if (h6 < 2.0) { r = x; g = c; b = 0.0; }
+  else if (h6 < 3.0) { r = 0.0; g = c; b = x; }
+  else if (h6 < 4.0) { r = 0.0; g = x; b = c; }
+  else if (h6 < 5.0) { r = x; g = 0.0; b = c; }
+  else               { r = c; g = 0.0; b = x; }
+  float m = v - c;
+  return vec3(r + m, g + m, b + m);
 }
 
-vec3 _gpu_color_mix(vec3 rgb1, vec3 rgb2, float t) {
-  vec3 lch1 = _gpu_oklab_to_oklch(_gpu_srgb_to_oklab(rgb1));
-  vec3 lch2 = _gpu_oklab_to_oklch(_gpu_srgb_to_oklab(rgb2));
+vec3 _gpu_rgb_to_hsv(vec3 rgb) {
+  float maxc = max(max(rgb.x, rgb.y), rgb.z);
+  float minc = min(min(rgb.x, rgb.y), rgb.z);
+  float v = maxc;
+  float d = maxc - minc;
+  if (d < 1e-6) return vec3(0.0, 0.0, v);
+  float s = (maxc < 1e-6) ? 0.0 : d / maxc;
+  float h;
+  if (maxc == rgb.x)      h = mod((rgb.y - rgb.z) / d, 6.0);
+  else if (maxc == rgb.y) h = (rgb.z - rgb.x) / d + 2.0;
+  else                    h = (rgb.x - rgb.y) / d + 4.0;
+  h *= 60.0;
+  if (h < 0.0) h += 360.0;
+  return vec3(h, s, v);
+}
+
+vec3 _gpu_color_mix(vec3 lch1, vec3 lch2, float t) {
   float L = mix(lch1.x, lch2.x, t);
   float C = mix(lch1.y, lch2.y, t);
-  float dh = lch2.z - lch1.z;
-  const float PI = 3.14159265359;
-  if (dh > PI) dh -= 2.0 * PI;
-  if (dh < -PI) dh += 2.0 * PI;
-  float H = lch1.z + dh * t;
-  return _gpu_oklab_to_srgb(_gpu_oklch_to_oklab(vec3(L, C, H)));
+  bool a1 = lch1.y < 1e-6;
+  bool a2 = lch2.y < 1e-6;
+  float H;
+  if (a1 && a2) {
+    H = lch1.z;
+  } else if (a1) {
+    H = lch2.z;
+  } else if (a2) {
+    H = lch1.z;
+  } else {
+    float dh = lch2.z - lch1.z;
+    if (dh > 180.0) dh -= 360.0;
+    if (dh < -180.0) dh += 360.0;
+    H = lch1.z + dh * t;
+    if (H < 0.0) H += 360.0;
+    if (H >= 360.0) H -= 360.0;
+  }
+  return vec3(L, C, H);
 }
 
-float _gpu_apca(vec3 bg, vec3 fg) {
+float _gpu_apca(vec3 lch_bg, vec3 lch_fg) {
+  vec3 bg = _gpu_oklch_to_srgb(lch_bg);
+  vec3 fg = _gpu_oklch_to_srgb(lch_fg);
   float bgR = _gpu_srgb_to_linear(bg.x);
   float bgG = _gpu_srgb_to_linear(bg.y);
   float bgB = _gpu_srgb_to_linear(bg.z);
@@ -22120,9 +22654,7 @@ float _gpu_apca(vec3 bg, vec3 fg) {
   float fgY = 0.2126729 * fgR + 0.7151522 * fgG + 0.0721750 * fgB;
   float bgC = pow(bgY, 0.56);
   float fgC = pow(fgY, 0.57);
-  float contrast = (bgC > fgC)
-    ? (bgC - fgC) * 1.14
-    : (bgC - fgC) * 1.14;
+  float contrast = (bgC - fgC) * 1.14;
   return contrast * 100.0;
 }
 `;
@@ -22166,28 +22698,133 @@ fn _gpu_oklab_to_srgb(lab: vec3f) -> vec3f {
 
 fn _gpu_oklab_to_oklch(lab: vec3f) -> vec3f {
   let C = length(lab.yz);
-  let H = atan2(lab.z, lab.y);
+  var H = atan2(lab.z, lab.y) * (180.0 / 3.14159265359);
+  if (H < 0.0) { H = H + 360.0; }
   return vec3f(lab.x, C, H);
 }
 
 fn _gpu_oklch_to_oklab(lch: vec3f) -> vec3f {
-  return vec3f(lch.x, lch.y * cos(lch.z), lch.y * sin(lch.z));
+  let h_rad = lch.z * (3.14159265359 / 180.0);
+  return vec3f(lch.x, lch.y * cos(h_rad), lch.y * sin(h_rad));
 }
 
-fn _gpu_color_mix(rgb1: vec3f, rgb2: vec3f, t: f32) -> vec3f {
-  let lch1 = _gpu_oklab_to_oklch(_gpu_srgb_to_oklab(rgb1));
-  let lch2 = _gpu_oklab_to_oklch(_gpu_srgb_to_oklab(rgb2));
+fn _gpu_srgb_to_oklch(rgb: vec3f) -> vec3f {
+  return _gpu_oklab_to_oklch(_gpu_srgb_to_oklab(rgb));
+}
+
+fn _gpu_oklch_to_srgb(lch: vec3f) -> vec3f {
+  return _gpu_oklab_to_srgb(_gpu_oklch_to_oklab(lch));
+}
+
+fn _gpu_hsl_to_rgb(hsl: vec3f) -> vec3f {
+  let h = hsl.x;
+  let s = hsl.y;
+  let l = hsl.z;
+  let c = (1.0 - abs(2.0 * l - 1.0)) * s;
+  let h6 = h / 60.0;
+  let x = c * (1.0 - abs((h6 - 2.0 * floor(h6 / 2.0)) - 1.0));
+  var r: f32 = 0.0;
+  var g: f32 = 0.0;
+  var b: f32 = 0.0;
+  if (h6 < 1.0)      { r = c; g = x; b = 0.0; }
+  else if (h6 < 2.0) { r = x; g = c; b = 0.0; }
+  else if (h6 < 3.0) { r = 0.0; g = c; b = x; }
+  else if (h6 < 4.0) { r = 0.0; g = x; b = c; }
+  else if (h6 < 5.0) { r = x; g = 0.0; b = c; }
+  else               { r = c; g = 0.0; b = x; }
+  let m = l - c / 2.0;
+  return vec3f(r + m, g + m, b + m);
+}
+
+fn _gpu_rgb_to_hsl(rgb: vec3f) -> vec3f {
+  let maxc = max(max(rgb.x, rgb.y), rgb.z);
+  let minc = min(min(rgb.x, rgb.y), rgb.z);
+  let l = (maxc + minc) / 2.0;
+  let d = maxc - minc;
+  if (d < 1e-6) { return vec3f(0.0, 0.0, l); }
+  let s = d / (1.0 - abs(2.0 * l - 1.0));
+  var h: f32;
+  if (maxc == rgb.x) {
+    let v = (rgb.y - rgb.z) / d;
+    h = v - 6.0 * floor(v / 6.0);
+  } else if (maxc == rgb.y) {
+    h = (rgb.z - rgb.x) / d + 2.0;
+  } else {
+    h = (rgb.x - rgb.y) / d + 4.0;
+  }
+  h = h * 60.0;
+  if (h < 0.0) { h = h + 360.0; }
+  return vec3f(h, s, l);
+}
+
+fn _gpu_hsv_to_rgb(hsv: vec3f) -> vec3f {
+  let h = hsv.x;
+  let s = hsv.y;
+  let v = hsv.z;
+  let c = v * s;
+  let h6 = h / 60.0;
+  let x = c * (1.0 - abs((h6 - 2.0 * floor(h6 / 2.0)) - 1.0));
+  var r: f32 = 0.0;
+  var g: f32 = 0.0;
+  var b: f32 = 0.0;
+  if (h6 < 1.0)      { r = c; g = x; b = 0.0; }
+  else if (h6 < 2.0) { r = x; g = c; b = 0.0; }
+  else if (h6 < 3.0) { r = 0.0; g = c; b = x; }
+  else if (h6 < 4.0) { r = 0.0; g = x; b = c; }
+  else if (h6 < 5.0) { r = x; g = 0.0; b = c; }
+  else               { r = c; g = 0.0; b = x; }
+  let m = v - c;
+  return vec3f(r + m, g + m, b + m);
+}
+
+fn _gpu_rgb_to_hsv(rgb: vec3f) -> vec3f {
+  let maxc = max(max(rgb.x, rgb.y), rgb.z);
+  let minc = min(min(rgb.x, rgb.y), rgb.z);
+  let v = maxc;
+  let d = maxc - minc;
+  if (d < 1e-6) { return vec3f(0.0, 0.0, v); }
+  var s: f32 = 0.0;
+  if (maxc >= 1e-6) { s = d / maxc; }
+  var h: f32;
+  if (maxc == rgb.x) {
+    let q = (rgb.y - rgb.z) / d;
+    h = q - 6.0 * floor(q / 6.0);
+  } else if (maxc == rgb.y) {
+    h = (rgb.z - rgb.x) / d + 2.0;
+  } else {
+    h = (rgb.x - rgb.y) / d + 4.0;
+  }
+  h = h * 60.0;
+  if (h < 0.0) { h = h + 360.0; }
+  return vec3f(h, s, v);
+}
+
+fn _gpu_color_mix(lch1: vec3f, lch2: vec3f, t: f32) -> vec3f {
   let L = mix(lch1.x, lch2.x, t);
   let C = mix(lch1.y, lch2.y, t);
-  let PI = 3.14159265359;
-  var dh = lch2.z - lch1.z;
-  if (dh > PI) { dh -= 2.0 * PI; }
-  if (dh < -PI) { dh += 2.0 * PI; }
-  let H = lch1.z + dh * t;
-  return _gpu_oklab_to_srgb(_gpu_oklch_to_oklab(vec3f(L, C, H)));
+  let a1 = lch1.y < 1e-6;
+  let a2 = lch2.y < 1e-6;
+  var H: f32;
+  if (a1 && a2) {
+    H = lch1.z;
+  } else if (a1) {
+    H = lch2.z;
+  } else if (a2) {
+    H = lch1.z;
+  } else {
+    var dh = lch2.z - lch1.z;
+    if (dh > 180.0) { dh = dh - 360.0; }
+    if (dh < -180.0) { dh = dh + 360.0; }
+    H = lch1.z + dh * t;
+    if (H < 0.0) { H = H + 360.0; }
+    if (H >= 360.0) { H = H - 360.0; }
+  }
+  return vec3f(L, C, H);
 }
 
-fn _gpu_apca(bg: vec3f, fg: vec3f) -> f32 {
+fn _gpu_apca(lch_bg: vec3f, lch_fg: vec3f) -> f32 {
+  let bg = _gpu_oklch_to_srgb(lch_bg);
+  let fg = _gpu_oklch_to_srgb(lch_fg);
   let bgR = _gpu_srgb_to_linear(bg.x);
   let bgG = _gpu_srgb_to_linear(bg.y);
   let bgB = _gpu_srgb_to_linear(bg.z);
@@ -22475,7 +23112,7 @@ var GPUShaderTarget = class {
         if (stmts.length === 0) return "";
         const last = stmts.length - 1;
         stmts[last] = `return ${stmts[last]}`;
-        return stmts.join(";\n");
+        return stmts.join(";\n") + ";";
       },
       ...options
     };
@@ -22574,7 +23211,7 @@ var GLSLTarget = class extends GPUShaderTarget {
     if (body.includes("\n")) {
       const indented = body.split("\n").map((l) => `  ${l}`).join("\n");
       return `${returnType} ${functionName}(${params}) {
-${indented};
+${indented}
 }`;
     }
     return `${returnType} ${functionName}(${params}) {
@@ -22685,7 +23322,7 @@ var WGSLTarget = class extends GPUShaderTarget {
       return `fn ${functionName}(${params}) -> ${toWGSLType(
         returnType
       )} {
-${indented};
+${indented}
 }`;
     }
     return `fn ${functionName}(${params}) -> ${toWGSLType(returnType)} {
@@ -24864,7 +25501,7 @@ function compileToIntervalTarget(expr, target) {
 }
 
 // src/compile.ts
-var version = "0.55.6";
+var version = "0.56.0";
 export {
   BaseCompiler,
   GLSLTarget,