@prototyperco/ui 0.5.0-alpha.0 → 0.5.0

package/dist/lib/color-utils.cjs

@@ -0,0 +1,315 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/color-utils.ts
+var color_utils_exports = {};
+__export(color_utils_exports, {
+  clamp: () => clamp,
+  formatColor: () => formatColor,
+  gamutMapChroma: () => gamutMapChroma,
+  hexToRgb: () => hexToRgb,
+  isInGamut: () => isInGamut,
+  maxChromaForLH: () => maxChromaForLH,
+  oklchToRgb: () => oklchToRgb,
+  parseColor: () => parseColor,
+  renderAreaGradient: () => renderAreaGradient,
+  rgbToHex: () => rgbToHex,
+  rgbToOklch: () => rgbToOklch
+});
+module.exports = __toCommonJS(color_utils_exports);
+var DEG = Math.PI / 180;
+var MAX_CHROMA = 0.4;
+function clamp(v, min, max) {
+  return Math.min(max, Math.max(min, v));
+}
+function round(v, d) {
+  const f = 10 ** d;
+  return Math.round(v * f) / f;
+}
+function oklchToOklab(l, c, h) {
+  const hRad = h * DEG;
+  return { L: l, a: c * Math.cos(hRad), b: c * Math.sin(hRad) };
+}
+function oklabToOklch(L, a, b) {
+  const c = Math.sqrt(a * a + b * b);
+  let h = Math.atan2(b, a) / DEG;
+  if (h < 0) h += 360;
+  return { l: L, c, h };
+}
+function oklabToLinearRgb(L, a, b) {
+  const l_ = L + 0.3963377774 * a + 0.2158037573 * b;
+  const m_ = L - 0.1055613458 * a - 0.0638541728 * b;
+  const s_ = L - 0.0894841775 * a - 1.291485548 * b;
+  const l = l_ * l_ * l_;
+  const m = m_ * m_ * m_;
+  const s = s_ * s_ * s_;
+  return {
+    r: 4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s,
+    g: -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s,
+    b: -0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s
+  };
+}
+function linearRgbToOklab(r, g, b) {
+  const l = Math.cbrt(0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b);
+  const m = Math.cbrt(0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b);
+  const s = Math.cbrt(0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b);
+  return {
+    L: 0.2104542553 * l + 0.793617785 * m - 0.0040720468 * s,
+    a: 1.9779984951 * l - 2.428592205 * m + 0.4505937099 * s,
+    b: 0.0259040371 * l + 0.7827717662 * m - 0.808675766 * s
+  };
+}
+function linearToSrgb(c) {
+  return c <= 31308e-7 ? 12.92 * c : 1.055 * Math.pow(c, 1 / 2.4) - 0.055;
+}
+function srgbToLinear(c) {
+  return c <= 0.04045 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
+}
+function oklchToRgb(l, c, h) {
+  const lab = oklchToOklab(l, c, h);
+  const lin = oklabToLinearRgb(lab.L, lab.a, lab.b);
+  return [
+    clamp(Math.round(linearToSrgb(lin.r) * 255), 0, 255),
+    clamp(Math.round(linearToSrgb(lin.g) * 255), 0, 255),
+    clamp(Math.round(linearToSrgb(lin.b) * 255), 0, 255)
+  ];
+}
+function rgbToOklch(r, g, b) {
+  const lr = srgbToLinear(r / 255);
+  const lg = srgbToLinear(g / 255);
+  const lb = srgbToLinear(b / 255);
+  const lab = linearRgbToOklab(lr, lg, lb);
+  return oklabToOklch(lab.L, lab.a, lab.b);
+}
+function isInGamut(l, c, h) {
+  const lab = oklchToOklab(l, c, h);
+  const lin = oklabToLinearRgb(lab.L, lab.a, lab.b);
+  const eps = 1e-3;
+  return lin.r >= -eps && lin.r <= 1 + eps && lin.g >= -eps && lin.g <= 1 + eps && lin.b >= -eps && lin.b <= 1 + eps;
+}
+function gamutMapChroma(l, c, h) {
+  if (isInGamut(l, c, h)) return c;
+  let lo = 0;
+  let hi = c;
+  while (hi - lo > 1e-3) {
+    const mid = (lo + hi) / 2;
+    if (isInGamut(l, mid, h)) lo = mid;
+    else hi = mid;
+  }
+  return lo;
+}
+function maxChromaForLH(l, h) {
+  let lo = 0;
+  let hi = MAX_CHROMA;
+  while (hi - lo > 1e-3) {
+    const mid = (lo + hi) / 2;
+    if (isInGamut(l, mid, h)) lo = mid;
+    else hi = mid;
+  }
+  return lo;
+}
+function hexToRgb(hex) {
+  hex = hex.replace(/^#/, "");
+  if (hex.length === 3 || hex.length === 4) {
+    hex = hex.split("").map((c) => c + c).join("");
+  }
+  const r = parseInt(hex.slice(0, 2), 16);
+  const g = parseInt(hex.slice(2, 4), 16);
+  const b = parseInt(hex.slice(4, 6), 16);
+  const a = hex.length === 8 ? parseInt(hex.slice(6, 8), 16) / 255 : 1;
+  return [r, g, b, a];
+}
+function rgbToHex(r, g, b, a) {
+  const hex = [r, g, b].map((v) => clamp(Math.round(v), 0, 255).toString(16).padStart(2, "0")).join("");
+  if (a !== void 0 && a < 1) {
+    return `#${hex}${clamp(Math.round(a * 255), 0, 255).toString(16).padStart(2, "0")}`;
+  }
+  return `#${hex}`;
+}
+function parseColor(input) {
+  const s = input.trim().toLowerCase();
+  if (s.startsWith("#")) {
+    const [r, g, b, a] = hexToRgb(s);
+    if (isNaN(r) || isNaN(g) || isNaN(b)) return null;
+    const oklch = rgbToOklch(r, g, b);
+    return { l: oklch.l, c: oklch.c, h: oklch.h, a };
+  }
+  const oklchMatch = s.match(
+    /oklch\(\s*([\d.]+)%?\s+([\d.]+)\s+([\d.]+)(?:\s*\/\s*([\d.]+%?))?\s*\)/
+  );
+  if (oklchMatch) {
+    let l = parseFloat(oklchMatch[1]);
+    if (l > 1) l /= 100;
+    const c = parseFloat(oklchMatch[2]);
+    const h = parseFloat(oklchMatch[3]);
+    let a = 1;
+    if (oklchMatch[4]) {
+      a = oklchMatch[4].endsWith("%") ? parseFloat(oklchMatch[4]) / 100 : parseFloat(oklchMatch[4]);
+    }
+    return { l, c, h, a };
+  }
+  const rgbMatch = s.match(
+    /rgba?\(\s*([\d.]+)[,\s]+([\d.]+)[,\s]+([\d.]+)(?:[,\s/]+([\d.]+%?))?\s*\)/
+  );
+  if (rgbMatch) {
+    const r = parseFloat(rgbMatch[1]);
+    const g = parseFloat(rgbMatch[2]);
+    const b = parseFloat(rgbMatch[3]);
+    let a = 1;
+    if (rgbMatch[4]) {
+      a = rgbMatch[4].endsWith("%") ? parseFloat(rgbMatch[4]) / 100 : parseFloat(rgbMatch[4]);
+    }
+    const oklch = rgbToOklch(r, g, b);
+    return { l: oklch.l, c: oklch.c, h: oklch.h, a };
+  }
+  const hslMatch = s.match(
+    /hsla?\(\s*([\d.]+)[,\s]+([\d.]+)%[,\s]+([\d.]+)%(?:[,\s/]+([\d.]+%?))?\s*\)/
+  );
+  if (hslMatch) {
+    const [r, g, b] = hslToRgb(
+      parseFloat(hslMatch[1]),
+      parseFloat(hslMatch[2]),
+      parseFloat(hslMatch[3])
+    );
+    let a = 1;
+    if (hslMatch[4]) {
+      a = hslMatch[4].endsWith("%") ? parseFloat(hslMatch[4]) / 100 : parseFloat(hslMatch[4]);
+    }
+    const oklch = rgbToOklch(r, g, b);
+    return { l: oklch.l, c: oklch.c, h: oklch.h, a };
+  }
+  const named = {
+    white: "#ffffff",
+    black: "#000000",
+    red: "#ff0000",
+    green: "#008000",
+    blue: "#0000ff",
+    yellow: "#ffff00",
+    cyan: "#00ffff",
+    magenta: "#ff00ff",
+    orange: "#ffa500",
+    transparent: "#00000000"
+  };
+  if (named[s]) return parseColor(named[s]);
+  return null;
+}
+function hslToRgb(h, s, l) {
+  s /= 100;
+  l /= 100;
+  const c = (1 - Math.abs(2 * l - 1)) * s;
+  const x = c * (1 - Math.abs(h / 60 % 2 - 1));
+  const m = l - c / 2;
+  let r = 0, g = 0, b = 0;
+  if (h < 60) {
+    r = c;
+    g = x;
+  } else if (h < 120) {
+    r = x;
+    g = c;
+  } else if (h < 180) {
+    g = c;
+    b = x;
+  } else if (h < 240) {
+    g = x;
+    b = c;
+  } else if (h < 300) {
+    r = x;
+    b = c;
+  } else {
+    r = c;
+    b = x;
+  }
+  return [
+    Math.round((r + m) * 255),
+    Math.round((g + m) * 255),
+    Math.round((b + m) * 255)
+  ];
+}
+function rgbToHsl(r, g, b) {
+  r /= 255;
+  g /= 255;
+  b /= 255;
+  const max = Math.max(r, g, b);
+  const min = Math.min(r, g, b);
+  const l = (max + min) / 2;
+  if (max === min) return [0, 0, l * 100];
+  const d = max - min;
+  const s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+  let h = 0;
+  if (max === r) h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
+  else if (max === g) h = ((b - r) / d + 2) / 6;
+  else h = ((r - g) / d + 4) / 6;
+  return [h * 360, s * 100, l * 100];
+}
+function formatColor(color, format) {
+  const hasAlpha = color.a < 1;
+  switch (format) {
+    case "hex": {
+      const [r, g, b] = oklchToRgb(color.l, color.c, color.h);
+      return rgbToHex(r, g, b, hasAlpha ? color.a : void 0);
+    }
+    case "oklch": {
+      const l = round(color.l * 100, 1);
+      const c = round(color.c, 3);
+      const h = round(color.h, 1);
+      return hasAlpha ? `oklch(${l}% ${c} ${h} / ${round(color.a, 2)})` : `oklch(${l}% ${c} ${h})`;
+    }
+    case "rgb": {
+      const [r, g, b] = oklchToRgb(color.l, color.c, color.h);
+      return hasAlpha ? `rgba(${r}, ${g}, ${b}, ${round(color.a, 2)})` : `rgb(${r}, ${g}, ${b})`;
+    }
+    case "hsl": {
+      const [r, g, b] = oklchToRgb(color.l, color.c, color.h);
+      const [h, s, l] = rgbToHsl(r, g, b);
+      return hasAlpha ? `hsla(${round(h, 0)}, ${round(s, 1)}%, ${round(l, 1)}%, ${round(color.a, 2)})` : `hsl(${round(h, 0)}, ${round(s, 1)}%, ${round(l, 1)}%)`;
+    }
+  }
+}
+function renderAreaGradient(width, height, hue) {
+  const data = new ImageData(width, height);
+  const buf = data.data;
+  for (let y = 0; y < height; y++) {
+    const l = 1 - y / (height - 1);
+    for (let x = 0; x < width; x++) {
+      const c = x / (width - 1) * MAX_CHROMA;
+      const [r, g, b] = oklchToRgb(l, c, hue);
+      const idx = (y * width + x) * 4;
+      buf[idx] = r;
+      buf[idx + 1] = g;
+      buf[idx + 2] = b;
+      buf[idx + 3] = 255;
+    }
+  }
+  return data;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clamp,
+  formatColor,
+  gamutMapChroma,
+  hexToRgb,
+  isInGamut,
+  maxChromaForLH,
+  oklchToRgb,
+  parseColor,
+  renderAreaGradient,
+  rgbToHex,
+  rgbToOklch
+});
+//# sourceMappingURL=color-utils.cjs.map

package/dist/lib/color-utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/color-utils.ts"],"sourcesContent":["/* ============================================================\n * color-utils — OKLCH-native color conversion & gamut mapping\n * ============================================================\n * Pure math, no React.\n * All internal state uses OKLCH { l, c, h, a }.\n * Provides parsing from CSS strings and formatting to hex/oklch/rgb/hsl.\n * ============================================================ */\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface OklchColor {\n  l: number; // 0 – 1   (lightness)\n  c: number; // 0 – 0.4 (chroma)\n  h: number; // 0 – 360 (hue, degrees)\n  a: number; // 0 – 1   (alpha)\n}\n\nexport type ColorFormat = \"hex\" | \"oklch\" | \"rgb\" | \"hsl\";\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst DEG = Math.PI / 180;\nconst MAX_CHROMA = 0.4;\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nexport function clamp(v: number, min: number, max: number): number {\n  return Math.min(max, Math.max(min, v));\n}\n\nfunction round(v: number, d: number): number {\n  const f = 10 ** d;\n  return Math.round(v * f) / f;\n}\n\n// ---------------------------------------------------------------------------\n// OKLCH ↔ OKLab\n// ---------------------------------------------------------------------------\n\nfunction oklchToOklab(l: number, c: number, h: number) {\n  const hRad = h * DEG;\n  return { L: l, a: c * Math.cos(hRad), b: c * Math.sin(hRad) };\n}\n\nfunction oklabToOklch(L: number, a: number, b: number) {\n  const c = Math.sqrt(a * a + b * b);\n  let h = Math.atan2(b, a) / DEG;\n  if (h < 0) h += 360;\n  return { l: L, c, h };\n}\n\n// ---------------------------------------------------------------------------\n// OKLab ↔ Linear sRGB\n// ---------------------------------------------------------------------------\n\nfunction oklabToLinearRgb(L: number, a: number, b: number) {\n  const l_ = L + 0.3963377774 * a + 0.2158037573 * b;\n  const m_ = L - 0.1055613458 * a - 0.0638541728 * b;\n  const s_ = L - 0.0894841775 * a - 1.291485548 * b;\n\n  const l = l_ * l_ * l_;\n  const m = m_ * m_ * m_;\n  const s = s_ * s_ * s_;\n\n  return {\n    r: +4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s,\n    g: -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s,\n    b: -0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s,\n  };\n}\n\nfunction linearRgbToOklab(r: number, g: number, b: number) {\n  const l = Math.cbrt(0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b);\n  const m = Math.cbrt(0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b);\n  const s = Math.cbrt(0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b);\n\n  return {\n    L: 0.2104542553 * l + 0.793617785 * m - 0.0040720468 * s,\n    a: 1.9779984951 * l - 2.428592205 * m + 0.4505937099 * s,\n    b: 0.0259040371 * l + 0.7827717662 * m - 0.808675766 * s,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Linear sRGB ↔ sRGB (gamma)\n// ---------------------------------------------------------------------------\n\nfunction linearToSrgb(c: number): number {\n  return c <= 0.0031308 ? 12.92 * c : 1.055 * Math.pow(c, 1 / 2.4) - 0.055;\n}\n\nfunction srgbToLinear(c: number): number {\n  return c <= 0.04045 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);\n}\n\n// ---------------------------------------------------------------------------\n// OKLCH → sRGB (clamped 0-255)\n// ---------------------------------------------------------------------------\n\nexport function oklchToRgb(\n  l: number,\n  c: number,\n  h: number,\n): [number, number, number] {\n  const lab = oklchToOklab(l, c, h);\n  const lin = oklabToLinearRgb(lab.L, lab.a, lab.b);\n  return [\n    clamp(Math.round(linearToSrgb(lin.r) * 255), 0, 255),\n    clamp(Math.round(linearToSrgb(lin.g) * 255), 0, 255),\n    clamp(Math.round(linearToSrgb(lin.b) * 255), 0, 255),\n  ];\n}\n\n// ---------------------------------------------------------------------------\n// sRGB → OKLCH\n// ---------------------------------------------------------------------------\n\nexport function rgbToOklch(\n  r: number,\n  g: number,\n  b: number,\n): { l: number; c: number; h: number } {\n  const lr = srgbToLinear(r / 255);\n  const lg = srgbToLinear(g / 255);\n  const lb = srgbToLinear(b / 255);\n  const lab = linearRgbToOklab(lr, lg, lb);\n  return oklabToOklch(lab.L, lab.a, lab.b);\n}\n\n// ---------------------------------------------------------------------------\n// Gamut check — is (l, c, h) within sRGB?\n// ---------------------------------------------------------------------------\n\nexport function isInGamut(l: number, c: number, h: number): boolean {\n  const lab = oklchToOklab(l, c, h);\n  const lin = oklabToLinearRgb(lab.L, lab.a, lab.b);\n  const eps = 0.001;\n  return (\n    lin.r >= -eps &&\n    lin.r <= 1 + eps &&\n    lin.g >= -eps &&\n    lin.g <= 1 + eps &&\n    lin.b >= -eps &&\n    lin.b <= 1 + eps\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Gamut mapping — reduce chroma until in gamut (binary search)\n// ---------------------------------------------------------------------------\n\nexport function gamutMapChroma(l: number, c: number, h: number): number {\n  if (isInGamut(l, c, h)) return c;\n  let lo = 0;\n  let hi = c;\n  while (hi - lo > 0.001) {\n    const mid = (lo + hi) / 2;\n    if (isInGamut(l, mid, h)) lo = mid;\n    else hi = mid;\n  }\n  return lo;\n}\n\n// ---------------------------------------------------------------------------\n// Max chroma for a given (l, h) — for area rendering\n// ---------------------------------------------------------------------------\n\nexport function maxChromaForLH(l: number, h: number): number {\n  let lo = 0;\n  let hi = MAX_CHROMA;\n  while (hi - lo > 0.001) {\n    const mid = (lo + hi) / 2;\n    if (isInGamut(l, mid, h)) lo = mid;\n    else hi = mid;\n  }\n  return lo;\n}\n\n// ---------------------------------------------------------------------------\n// Hex parsing & formatting\n// ---------------------------------------------------------------------------\n\nexport function hexToRgb(hex: string): [number, number, number, number] {\n  hex = hex.replace(/^#/, \"\");\n  if (hex.length === 3 || hex.length === 4) {\n    hex = hex\n      .split(\"\")\n      .map((c) => c + c)\n      .join(\"\");\n  }\n  const r = parseInt(hex.slice(0, 2), 16);\n  const g = parseInt(hex.slice(2, 4), 16);\n  const b = parseInt(hex.slice(4, 6), 16);\n  const a = hex.length === 8 ? parseInt(hex.slice(6, 8), 16) / 255 : 1;\n  return [r, g, b, a];\n}\n\nexport function rgbToHex(r: number, g: number, b: number, a?: number): string {\n  const hex = [r, g, b]\n    .map((v) => clamp(Math.round(v), 0, 255).toString(16).padStart(2, \"0\"))\n    .join(\"\");\n  if (a !== undefined && a < 1) {\n    return `#${hex}${clamp(Math.round(a * 255), 0, 255)\n      .toString(16)\n      .padStart(2, \"0\")}`;\n  }\n  return `#${hex}`;\n}\n\n// ---------------------------------------------------------------------------\n// Parse any CSS color string → OklchColor\n// ---------------------------------------------------------------------------\n\nexport function parseColor(input: string): OklchColor | null {\n  const s = input.trim().toLowerCase();\n\n  // hex: #rgb, #rgba, #rrggbb, #rrggbbaa\n  if (s.startsWith(\"#\")) {\n    const [r, g, b, a] = hexToRgb(s);\n    if (isNaN(r) || isNaN(g) || isNaN(b)) return null;\n    const oklch = rgbToOklch(r, g, b);\n    return { l: oklch.l, c: oklch.c, h: oklch.h, a };\n  }\n\n  // oklch(l% c h) or oklch(l% c h / a)\n  const oklchMatch = s.match(\n    /oklch\\(\\s*([\\d.]+)%?\\s+([\\d.]+)\\s+([\\d.]+)(?:\\s*\\/\\s*([\\d.]+%?))?\\s*\\)/,\n  );\n  if (oklchMatch) {\n    let l = parseFloat(oklchMatch[1]);\n    if (l > 1) l /= 100; // handle percentage\n    const c = parseFloat(oklchMatch[2]);\n    const h = parseFloat(oklchMatch[3]);\n    let a = 1;\n    if (oklchMatch[4]) {\n      a = oklchMatch[4].endsWith(\"%\")\n        ? parseFloat(oklchMatch[4]) / 100\n        : parseFloat(oklchMatch[4]);\n    }\n    return { l, c, h, a };\n  }\n\n  // rgb(r, g, b) or rgb(r g b) or rgba(r, g, b, a)\n  const rgbMatch = s.match(\n    /rgba?\\(\\s*([\\d.]+)[,\\s]+([\\d.]+)[,\\s]+([\\d.]+)(?:[,\\s/]+([\\d.]+%?))?\\s*\\)/,\n  );\n  if (rgbMatch) {\n    const r = parseFloat(rgbMatch[1]);\n    const g = parseFloat(rgbMatch[2]);\n    const b = parseFloat(rgbMatch[3]);\n    let a = 1;\n    if (rgbMatch[4]) {\n      a = rgbMatch[4].endsWith(\"%\")\n        ? parseFloat(rgbMatch[4]) / 100\n        : parseFloat(rgbMatch[4]);\n    }\n    const oklch = rgbToOklch(r, g, b);\n    return { l: oklch.l, c: oklch.c, h: oklch.h, a };\n  }\n\n  // hsl(h, s%, l%) or hsla(h, s%, l%, a)\n  const hslMatch = s.match(\n    /hsla?\\(\\s*([\\d.]+)[,\\s]+([\\d.]+)%[,\\s]+([\\d.]+)%(?:[,\\s/]+([\\d.]+%?))?\\s*\\)/,\n  );\n  if (hslMatch) {\n    const [r, g, b] = hslToRgb(\n      parseFloat(hslMatch[1]),\n      parseFloat(hslMatch[2]),\n      parseFloat(hslMatch[3]),\n    );\n    let a = 1;\n    if (hslMatch[4]) {\n      a = hslMatch[4].endsWith(\"%\")\n        ? parseFloat(hslMatch[4]) / 100\n        : parseFloat(hslMatch[4]);\n    }\n    const oklch = rgbToOklch(r, g, b);\n    return { l: oklch.l, c: oklch.c, h: oklch.h, a };\n  }\n\n  // Named colors — small subset for common use\n  const named: Record<string, string> = {\n    white: \"#ffffff\",\n    black: \"#000000\",\n    red: \"#ff0000\",\n    green: \"#008000\",\n    blue: \"#0000ff\",\n    yellow: \"#ffff00\",\n    cyan: \"#00ffff\",\n    magenta: \"#ff00ff\",\n    orange: \"#ffa500\",\n    transparent: \"#00000000\",\n  };\n  if (named[s]) return parseColor(named[s]);\n\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// HSL ↔ RGB helpers\n// ---------------------------------------------------------------------------\n\nfunction hslToRgb(h: number, s: number, l: number): [number, number, number] {\n  s /= 100;\n  l /= 100;\n  const c = (1 - Math.abs(2 * l - 1)) * s;\n  const x = c * (1 - Math.abs(((h / 60) % 2) - 1));\n  const m = l - c / 2;\n  let r = 0,\n    g = 0,\n    b = 0;\n  if (h < 60) {\n    r = c;\n    g = x;\n  } else if (h < 120) {\n    r = x;\n    g = c;\n  } else if (h < 180) {\n    g = c;\n    b = x;\n  } else if (h < 240) {\n    g = x;\n    b = c;\n  } else if (h < 300) {\n    r = x;\n    b = c;\n  } else {\n    r = c;\n    b = x;\n  }\n  return [\n    Math.round((r + m) * 255),\n    Math.round((g + m) * 255),\n    Math.round((b + m) * 255),\n  ];\n}\n\nfunction rgbToHsl(r: number, g: number, b: number): [number, number, number] {\n  r /= 255;\n  g /= 255;\n  b /= 255;\n  const max = Math.max(r, g, b);\n  const min = Math.min(r, g, b);\n  const l = (max + min) / 2;\n  if (max === min) return [0, 0, l * 100];\n  const d = max - min;\n  const s = l > 0.5 ? d / (2 - max - min) : d / (max + min);\n  let h = 0;\n  if (max === r) h = ((g - b) / d + (g < b ? 6 : 0)) / 6;\n  else if (max === g) h = ((b - r) / d + 2) / 6;\n  else h = ((r - g) / d + 4) / 6;\n  return [h * 360, s * 100, l * 100];\n}\n\n// ---------------------------------------------------------------------------\n// Format OklchColor → CSS string\n// ---------------------------------------------------------------------------\n\nexport function formatColor(color: OklchColor, format: ColorFormat): string {\n  const hasAlpha = color.a < 1;\n\n  switch (format) {\n    case \"hex\": {\n      const [r, g, b] = oklchToRgb(color.l, color.c, color.h);\n      return rgbToHex(r, g, b, hasAlpha ? color.a : undefined);\n    }\n    case \"oklch\": {\n      const l = round(color.l * 100, 1);\n      const c = round(color.c, 3);\n      const h = round(color.h, 1);\n      return hasAlpha\n        ? `oklch(${l}% ${c} ${h} / ${round(color.a, 2)})`\n        : `oklch(${l}% ${c} ${h})`;\n    }\n    case \"rgb\": {\n      const [r, g, b] = oklchToRgb(color.l, color.c, color.h);\n      return hasAlpha\n        ? `rgba(${r}, ${g}, ${b}, ${round(color.a, 2)})`\n        : `rgb(${r}, ${g}, ${b})`;\n    }\n    case \"hsl\": {\n      const [r, g, b] = oklchToRgb(color.l, color.c, color.h);\n      const [h, s, l] = rgbToHsl(r, g, b);\n      return hasAlpha\n        ? `hsla(${round(h, 0)}, ${round(s, 1)}%, ${round(l, 1)}%, ${round(color.a, 2)})`\n        : `hsl(${round(h, 0)}, ${round(s, 1)}%, ${round(l, 1)}%)`;\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Render a 2D area gradient (lightness × chroma) for a given hue\n// Returns ImageData to draw onto a canvas\n// ---------------------------------------------------------------------------\n\nexport function renderAreaGradient(\n  width: number,\n  height: number,\n  hue: number,\n): ImageData {\n  const data = new ImageData(width, height);\n  const buf = data.data;\n\n  for (let y = 0; y < height; y++) {\n    const l = 1 - y / (height - 1); // top = 1 (light), bottom = 0 (dark)\n    for (let x = 0; x < width; x++) {\n      const c = (x / (width - 1)) * MAX_CHROMA;\n      const [r, g, b] = oklchToRgb(l, c, hue);\n      const idx = (y * width + x) * 4;\n      buf[idx] = r;\n      buf[idx + 1] = g;\n      buf[idx + 2] = b;\n      buf[idx + 3] = 255;\n    }\n  }\n\n  return data;\n}\n"],"mappings":"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","names":[]}

package/dist/lib/color-utils.d.cts

@@ -0,0 +1,24 @@
+interface OklchColor {
+    l: number;
+    c: number;
+    h: number;
+    a: number;
+}
+type ColorFormat = "hex" | "oklch" | "rgb" | "hsl";
+declare function clamp(v: number, min: number, max: number): number;
+declare function oklchToRgb(l: number, c: number, h: number): [number, number, number];
+declare function rgbToOklch(r: number, g: number, b: number): {
+    l: number;
+    c: number;
+    h: number;
+};
+declare function isInGamut(l: number, c: number, h: number): boolean;
+declare function gamutMapChroma(l: number, c: number, h: number): number;
+declare function maxChromaForLH(l: number, h: number): number;
+declare function hexToRgb(hex: string): [number, number, number, number];
+declare function rgbToHex(r: number, g: number, b: number, a?: number): string;
+declare function parseColor(input: string): OklchColor | null;
+declare function formatColor(color: OklchColor, format: ColorFormat): string;
+declare function renderAreaGradient(width: number, height: number, hue: number): ImageData;
+
+export { type ColorFormat, type OklchColor, clamp, formatColor, gamutMapChroma, hexToRgb, isInGamut, maxChromaForLH, oklchToRgb, parseColor, renderAreaGradient, rgbToHex, rgbToOklch };

package/dist/lib/color-utils.d.ts

@@ -0,0 +1,24 @@
+interface OklchColor {
+    l: number;
+    c: number;
+    h: number;
+    a: number;
+}
+type ColorFormat = "hex" | "oklch" | "rgb" | "hsl";
+declare function clamp(v: number, min: number, max: number): number;
+declare function oklchToRgb(l: number, c: number, h: number): [number, number, number];
+declare function rgbToOklch(r: number, g: number, b: number): {
+    l: number;
+    c: number;
+    h: number;
+};
+declare function isInGamut(l: number, c: number, h: number): boolean;
+declare function gamutMapChroma(l: number, c: number, h: number): number;
+declare function maxChromaForLH(l: number, h: number): number;
+declare function hexToRgb(hex: string): [number, number, number, number];
+declare function rgbToHex(r: number, g: number, b: number, a?: number): string;
+declare function parseColor(input: string): OklchColor | null;
+declare function formatColor(color: OklchColor, format: ColorFormat): string;
+declare function renderAreaGradient(width: number, height: number, hue: number): ImageData;
+
+export { type ColorFormat, type OklchColor, clamp, formatColor, gamutMapChroma, hexToRgb, isInGamut, maxChromaForLH, oklchToRgb, parseColor, renderAreaGradient, rgbToHex, rgbToOklch };

package/dist/lib/color-utils.js

@@ -0,0 +1,280 @@
+// src/lib/color-utils.ts
+var DEG = Math.PI / 180;
+var MAX_CHROMA = 0.4;
+function clamp(v, min, max) {
+  return Math.min(max, Math.max(min, v));
+}
+function round(v, d) {
+  const f = 10 ** d;
+  return Math.round(v * f) / f;
+}
+function oklchToOklab(l, c, h) {
+  const hRad = h * DEG;
+  return { L: l, a: c * Math.cos(hRad), b: c * Math.sin(hRad) };
+}
+function oklabToOklch(L, a, b) {
+  const c = Math.sqrt(a * a + b * b);
+  let h = Math.atan2(b, a) / DEG;
+  if (h < 0) h += 360;
+  return { l: L, c, h };
+}
+function oklabToLinearRgb(L, a, b) {
+  const l_ = L + 0.3963377774 * a + 0.2158037573 * b;
+  const m_ = L - 0.1055613458 * a - 0.0638541728 * b;
+  const s_ = L - 0.0894841775 * a - 1.291485548 * b;
+  const l = l_ * l_ * l_;
+  const m = m_ * m_ * m_;
+  const s = s_ * s_ * s_;
+  return {
+    r: 4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s,
+    g: -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s,
+    b: -0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s
+  };
+}
+function linearRgbToOklab(r, g, b) {
+  const l = Math.cbrt(0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b);
+  const m = Math.cbrt(0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b);
+  const s = Math.cbrt(0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b);
+  return {
+    L: 0.2104542553 * l + 0.793617785 * m - 0.0040720468 * s,
+    a: 1.9779984951 * l - 2.428592205 * m + 0.4505937099 * s,
+    b: 0.0259040371 * l + 0.7827717662 * m - 0.808675766 * s
+  };
+}
+function linearToSrgb(c) {
+  return c <= 31308e-7 ? 12.92 * c : 1.055 * Math.pow(c, 1 / 2.4) - 0.055;
+}
+function srgbToLinear(c) {
+  return c <= 0.04045 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
+}
+function oklchToRgb(l, c, h) {
+  const lab = oklchToOklab(l, c, h);
+  const lin = oklabToLinearRgb(lab.L, lab.a, lab.b);
+  return [
+    clamp(Math.round(linearToSrgb(lin.r) * 255), 0, 255),
+    clamp(Math.round(linearToSrgb(lin.g) * 255), 0, 255),
+    clamp(Math.round(linearToSrgb(lin.b) * 255), 0, 255)
+  ];
+}
+function rgbToOklch(r, g, b) {
+  const lr = srgbToLinear(r / 255);
+  const lg = srgbToLinear(g / 255);
+  const lb = srgbToLinear(b / 255);
+  const lab = linearRgbToOklab(lr, lg, lb);
+  return oklabToOklch(lab.L, lab.a, lab.b);
+}
+function isInGamut(l, c, h) {
+  const lab = oklchToOklab(l, c, h);
+  const lin = oklabToLinearRgb(lab.L, lab.a, lab.b);
+  const eps = 1e-3;
+  return lin.r >= -eps && lin.r <= 1 + eps && lin.g >= -eps && lin.g <= 1 + eps && lin.b >= -eps && lin.b <= 1 + eps;
+}
+function gamutMapChroma(l, c, h) {
+  if (isInGamut(l, c, h)) return c;
+  let lo = 0;
+  let hi = c;
+  while (hi - lo > 1e-3) {
+    const mid = (lo + hi) / 2;
+    if (isInGamut(l, mid, h)) lo = mid;
+    else hi = mid;
+  }
+  return lo;
+}
+function maxChromaForLH(l, h) {
+  let lo = 0;
+  let hi = MAX_CHROMA;
+  while (hi - lo > 1e-3) {
+    const mid = (lo + hi) / 2;
+    if (isInGamut(l, mid, h)) lo = mid;
+    else hi = mid;
+  }
+  return lo;
+}
+function hexToRgb(hex) {
+  hex = hex.replace(/^#/, "");
+  if (hex.length === 3 || hex.length === 4) {
+    hex = hex.split("").map((c) => c + c).join("");
+  }
+  const r = parseInt(hex.slice(0, 2), 16);
+  const g = parseInt(hex.slice(2, 4), 16);
+  const b = parseInt(hex.slice(4, 6), 16);
+  const a = hex.length === 8 ? parseInt(hex.slice(6, 8), 16) / 255 : 1;
+  return [r, g, b, a];
+}
+function rgbToHex(r, g, b, a) {
+  const hex = [r, g, b].map((v) => clamp(Math.round(v), 0, 255).toString(16).padStart(2, "0")).join("");
+  if (a !== void 0 && a < 1) {
+    return `#${hex}${clamp(Math.round(a * 255), 0, 255).toString(16).padStart(2, "0")}`;
+  }
+  return `#${hex}`;
+}
+function parseColor(input) {
+  const s = input.trim().toLowerCase();
+  if (s.startsWith("#")) {
+    const [r, g, b, a] = hexToRgb(s);
+    if (isNaN(r) || isNaN(g) || isNaN(b)) return null;
+    const oklch = rgbToOklch(r, g, b);
+    return { l: oklch.l, c: oklch.c, h: oklch.h, a };
+  }
+  const oklchMatch = s.match(
+    /oklch\(\s*([\d.]+)%?\s+([\d.]+)\s+([\d.]+)(?:\s*\/\s*([\d.]+%?))?\s*\)/
+  );
+  if (oklchMatch) {
+    let l = parseFloat(oklchMatch[1]);
+    if (l > 1) l /= 100;
+    const c = parseFloat(oklchMatch[2]);
+    const h = parseFloat(oklchMatch[3]);
+    let a = 1;
+    if (oklchMatch[4]) {
+      a = oklchMatch[4].endsWith("%") ? parseFloat(oklchMatch[4]) / 100 : parseFloat(oklchMatch[4]);
+    }
+    return { l, c, h, a };
+  }
+  const rgbMatch = s.match(
+    /rgba?\(\s*([\d.]+)[,\s]+([\d.]+)[,\s]+([\d.]+)(?:[,\s/]+([\d.]+%?))?\s*\)/
+  );
+  if (rgbMatch) {
+    const r = parseFloat(rgbMatch[1]);
+    const g = parseFloat(rgbMatch[2]);
+    const b = parseFloat(rgbMatch[3]);
+    let a = 1;
+    if (rgbMatch[4]) {
+      a = rgbMatch[4].endsWith("%") ? parseFloat(rgbMatch[4]) / 100 : parseFloat(rgbMatch[4]);
+    }
+    const oklch = rgbToOklch(r, g, b);
+    return { l: oklch.l, c: oklch.c, h: oklch.h, a };
+  }
+  const hslMatch = s.match(
+    /hsla?\(\s*([\d.]+)[,\s]+([\d.]+)%[,\s]+([\d.]+)%(?:[,\s/]+([\d.]+%?))?\s*\)/
+  );
+  if (hslMatch) {
+    const [r, g, b] = hslToRgb(
+      parseFloat(hslMatch[1]),
+      parseFloat(hslMatch[2]),
+      parseFloat(hslMatch[3])
+    );
+    let a = 1;
+    if (hslMatch[4]) {
+      a = hslMatch[4].endsWith("%") ? parseFloat(hslMatch[4]) / 100 : parseFloat(hslMatch[4]);
+    }
+    const oklch = rgbToOklch(r, g, b);
+    return { l: oklch.l, c: oklch.c, h: oklch.h, a };
+  }
+  const named = {
+    white: "#ffffff",
+    black: "#000000",
+    red: "#ff0000",
+    green: "#008000",
+    blue: "#0000ff",
+    yellow: "#ffff00",
+    cyan: "#00ffff",
+    magenta: "#ff00ff",
+    orange: "#ffa500",
+    transparent: "#00000000"
+  };
+  if (named[s]) return parseColor(named[s]);
+  return null;
+}
+function hslToRgb(h, s, l) {
+  s /= 100;
+  l /= 100;
+  const c = (1 - Math.abs(2 * l - 1)) * s;
+  const x = c * (1 - Math.abs(h / 60 % 2 - 1));
+  const m = l - c / 2;
+  let r = 0, g = 0, b = 0;
+  if (h < 60) {
+    r = c;
+    g = x;
+  } else if (h < 120) {
+    r = x;
+    g = c;
+  } else if (h < 180) {
+    g = c;
+    b = x;
+  } else if (h < 240) {
+    g = x;
+    b = c;
+  } else if (h < 300) {
+    r = x;
+    b = c;
+  } else {
+    r = c;
+    b = x;
+  }
+  return [
+    Math.round((r + m) * 255),
+    Math.round((g + m) * 255),
+    Math.round((b + m) * 255)
+  ];
+}
+function rgbToHsl(r, g, b) {
+  r /= 255;
+  g /= 255;
+  b /= 255;
+  const max = Math.max(r, g, b);
+  const min = Math.min(r, g, b);
+  const l = (max + min) / 2;
+  if (max === min) return [0, 0, l * 100];
+  const d = max - min;
+  const s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+  let h = 0;
+  if (max === r) h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
+  else if (max === g) h = ((b - r) / d + 2) / 6;
+  else h = ((r - g) / d + 4) / 6;
+  return [h * 360, s * 100, l * 100];
+}
+function formatColor(color, format) {
+  const hasAlpha = color.a < 1;
+  switch (format) {
+    case "hex": {
+      const [r, g, b] = oklchToRgb(color.l, color.c, color.h);
+      return rgbToHex(r, g, b, hasAlpha ? color.a : void 0);
+    }
+    case "oklch": {
+      const l = round(color.l * 100, 1);
+      const c = round(color.c, 3);
+      const h = round(color.h, 1);
+      return hasAlpha ? `oklch(${l}% ${c} ${h} / ${round(color.a, 2)})` : `oklch(${l}% ${c} ${h})`;
+    }
+    case "rgb": {
+      const [r, g, b] = oklchToRgb(color.l, color.c, color.h);
+      return hasAlpha ? `rgba(${r}, ${g}, ${b}, ${round(color.a, 2)})` : `rgb(${r}, ${g}, ${b})`;
+    }
+    case "hsl": {
+      const [r, g, b] = oklchToRgb(color.l, color.c, color.h);
+      const [h, s, l] = rgbToHsl(r, g, b);
+      return hasAlpha ? `hsla(${round(h, 0)}, ${round(s, 1)}%, ${round(l, 1)}%, ${round(color.a, 2)})` : `hsl(${round(h, 0)}, ${round(s, 1)}%, ${round(l, 1)}%)`;
+    }
+  }
+}
+function renderAreaGradient(width, height, hue) {
+  const data = new ImageData(width, height);
+  const buf = data.data;
+  for (let y = 0; y < height; y++) {
+    const l = 1 - y / (height - 1);
+    for (let x = 0; x < width; x++) {
+      const c = x / (width - 1) * MAX_CHROMA;
+      const [r, g, b] = oklchToRgb(l, c, hue);
+      const idx = (y * width + x) * 4;
+      buf[idx] = r;
+      buf[idx + 1] = g;
+      buf[idx + 2] = b;
+      buf[idx + 3] = 255;
+    }
+  }
+  return data;
+}
+export {
+  clamp,
+  formatColor,
+  gamutMapChroma,
+  hexToRgb,
+  isInGamut,
+  maxChromaForLH,
+  oklchToRgb,
+  parseColor,
+  renderAreaGradient,
+  rgbToHex,
+  rgbToOklch
+};
+//# sourceMappingURL=color-utils.js.map