@design-edito/tools 0.4.3 → 0.4.5

package/agnostic/colors/palette/index.js

@@ -1,14 +1,841 @@
-import {
-  rotate
-} from "../../../chunks/chunk-YY3TSU22.js";
-import "../../../chunks/chunk-WGRQXVBK.js";
-import "../../../chunks/chunk-CVMYA5XK.js";
-import "../../../chunks/chunk-OBSTP7YR.js";
-import "../../../chunks/chunk-HQLRJ7XW.js";
-import "../../../chunks/chunk-DNIOWD7K.js";
-import "../../../chunks/chunk-PUQUSA6S.js";
-import "../../../chunks/chunk-OSAXBA7G.js";
-import "../../../chunks/chunk-WSFCRVEQ.js";
+// src/agnostic/numbers/absolute-modulo/index.ts
+function absoluteModulo(nbr, modulo) {
+  return (nbr % modulo + modulo) % modulo;
+}
+
+// src/agnostic/numbers/clamp/index.ts
+function clamp(num, bound1, bound2) {
+  const min = Math.min(bound1, bound2);
+  const max = Math.max(bound1, bound2);
+  return Math.min(Math.max(num, min), max);
+}
+
+// src/agnostic/objects/is-object/index.ts
+function isObject(unk) {
+  return typeof unk === "object";
+}
+function isNonNullObject(unk) {
+  return unk !== null && isObject(unk);
+}
+
+// src/agnostic/colors/cssColorsMap.ts
+var cssColors = {
+  aliceblue: { r: 240, g: 248, b: 255 },
+  antiquewhite: { r: 250, g: 235, b: 215 },
+  aqua: { r: 0, g: 255, b: 255 },
+  aquamarine: { r: 127, g: 255, b: 212 },
+  azure: { r: 240, g: 255, b: 255 },
+  beige: { r: 245, g: 245, b: 220 },
+  bisque: { r: 255, g: 228, b: 196 },
+  black: { r: 0, g: 0, b: 0 },
+  blanchedalmond: { r: 255, g: 235, b: 205 },
+  blue: { r: 0, g: 0, b: 255 },
+  blueviolet: { r: 138, g: 43, b: 226 },
+  brown: { r: 165, g: 42, b: 42 },
+  burlywood: { r: 222, g: 184, b: 135 },
+  cadetblue: { r: 95, g: 158, b: 160 },
+  chartreuse: { r: 127, g: 255, b: 0 },
+  chocolate: { r: 210, g: 105, b: 30 },
+  coral: { r: 255, g: 127, b: 80 },
+  cornflowerblue: { r: 100, g: 149, b: 237 },
+  cornsilk: { r: 255, g: 248, b: 220 },
+  crimson: { r: 220, g: 20, b: 60 },
+  cyan: { r: 0, g: 255, b: 255 },
+  darkblue: { r: 0, g: 0, b: 139 },
+  darkcyan: { r: 0, g: 139, b: 139 },
+  darkgoldenrod: { r: 184, g: 134, b: 11 },
+  darkgray: { r: 169, g: 169, b: 169 },
+  darkgreen: { r: 0, g: 100, b: 0 },
+  darkgrey: { r: 169, g: 169, b: 169 },
+  darkkhaki: { r: 189, g: 183, b: 107 },
+  darkmagenta: { r: 139, g: 0, b: 139 },
+  darkolivegreen: { r: 85, g: 107, b: 47 },
+  darkorange: { r: 255, g: 140, b: 0 },
+  darkorchid: { r: 153, g: 50, b: 204 },
+  darkred: { r: 139, g: 0, b: 0 },
+  darksalmon: { r: 233, g: 150, b: 122 },
+  darkseagreen: { r: 143, g: 188, b: 143 },
+  darkslateblue: { r: 72, g: 61, b: 139 },
+  darkslategray: { r: 47, g: 79, b: 79 },
+  darkslategrey: { r: 47, g: 79, b: 79 },
+  darkturquoise: { r: 0, g: 206, b: 209 },
+  darkviolet: { r: 148, g: 0, b: 211 },
+  deeppink: { r: 255, g: 20, b: 147 },
+  deepskyblue: { r: 0, g: 191, b: 255 },
+  dimgray: { r: 105, g: 105, b: 105 },
+  dimgrey: { r: 105, g: 105, b: 105 },
+  dodgerblue: { r: 30, g: 144, b: 255 },
+  firebrick: { r: 178, g: 34, b: 34 },
+  floralwhite: { r: 255, g: 250, b: 240 },
+  forestgreen: { r: 34, g: 139, b: 34 },
+  fuchsia: { r: 255, g: 0, b: 255 },
+  gainsboro: { r: 220, g: 220, b: 220 },
+  ghostwhite: { r: 248, g: 248, b: 255 },
+  gold: { r: 255, g: 215, b: 0 },
+  goldenrod: { r: 218, g: 165, b: 32 },
+  gray: { r: 128, g: 128, b: 128 },
+  green: { r: 0, g: 128, b: 0 },
+  greenyellow: { r: 173, g: 255, b: 47 },
+  grey: { r: 128, g: 128, b: 128 },
+  honeydew: { r: 240, g: 255, b: 240 },
+  hotpink: { r: 255, g: 105, b: 180 },
+  indianred: { r: 205, g: 92, b: 92 },
+  indigo: { r: 75, g: 0, b: 130 },
+  ivory: { r: 255, g: 255, b: 240 },
+  khaki: { r: 240, g: 230, b: 140 },
+  lavender: { r: 230, g: 230, b: 250 },
+  lavenderblush: { r: 255, g: 240, b: 245 },
+  lawngreen: { r: 124, g: 252, b: 0 },
+  lemonchiffon: { r: 255, g: 250, b: 205 },
+  lightblue: { r: 173, g: 216, b: 230 },
+  lightcoral: { r: 240, g: 128, b: 128 },
+  lightcyan: { r: 224, g: 255, b: 255 },
+  lightgoldenrodyellow: { r: 250, g: 250, b: 210 },
+  lightgray: { r: 211, g: 211, b: 211 },
+  lightgreen: { r: 144, g: 238, b: 144 },
+  lightgrey: { r: 211, g: 211, b: 211 },
+  lightpink: { r: 255, g: 182, b: 193 },
+  lightsalmon: { r: 255, g: 160, b: 122 },
+  lightseagreen: { r: 32, g: 178, b: 170 },
+  lightskyblue: { r: 135, g: 206, b: 250 },
+  lightslategray: { r: 119, g: 136, b: 153 },
+  lightslategrey: { r: 119, g: 136, b: 153 },
+  lightsteelblue: { r: 176, g: 196, b: 222 },
+  lightyellow: { r: 255, g: 255, b: 224 },
+  lime: { r: 0, g: 255, b: 0 },
+  limegreen: { r: 50, g: 205, b: 50 },
+  linen: { r: 250, g: 240, b: 230 },
+  magenta: { r: 255, g: 0, b: 255 },
+  maroon: { r: 128, g: 0, b: 0 },
+  mediumaquamarine: { r: 102, g: 205, b: 170 },
+  mediumblue: { r: 0, g: 0, b: 205 },
+  mediumorchid: { r: 186, g: 85, b: 211 },
+  mediumpurple: { r: 147, g: 112, b: 219 },
+  mediumseagreen: { r: 60, g: 179, b: 113 },
+  mediumslateblue: { r: 123, g: 104, b: 238 },
+  mediumspringgreen: { r: 0, g: 250, b: 154 },
+  mediumturquoise: { r: 72, g: 209, b: 204 },
+  mediumvioletred: { r: 199, g: 21, b: 133 },
+  midnightblue: { r: 25, g: 25, b: 112 },
+  mintcream: { r: 245, g: 255, b: 250 },
+  mistyrose: { r: 255, g: 228, b: 225 },
+  moccasin: { r: 255, g: 228, b: 181 },
+  navajowhite: { r: 255, g: 222, b: 173 },
+  navy: { r: 0, g: 0, b: 128 },
+  oldlace: { r: 253, g: 245, b: 230 },
+  olive: { r: 128, g: 128, b: 0 },
+  olivedrab: { r: 107, g: 142, b: 35 },
+  orange: { r: 255, g: 165, b: 0 },
+  orangered: { r: 255, g: 69, b: 0 },
+  orchid: { r: 218, g: 112, b: 214 },
+  palegoldenrod: { r: 238, g: 232, b: 170 },
+  palegreen: { r: 152, g: 251, b: 152 },
+  paleturquoise: { r: 175, g: 238, b: 238 },
+  palevioletred: { r: 219, g: 112, b: 147 },
+  papayawhip: { r: 255, g: 239, b: 213 },
+  peachpuff: { r: 255, g: 218, b: 185 },
+  peru: { r: 205, g: 133, b: 63 },
+  pink: { r: 255, g: 192, b: 203 },
+  plum: { r: 221, g: 160, b: 221 },
+  powderblue: { r: 176, g: 224, b: 230 },
+  purple: { r: 128, g: 0, b: 128 },
+  rebeccapurple: { r: 102, g: 51, b: 153 },
+  red: { r: 255, g: 0, b: 0 },
+  rosybrown: { r: 188, g: 143, b: 143 },
+  royalblue: { r: 65, g: 105, b: 225 },
+  saddlebrown: { r: 139, g: 69, b: 19 },
+  salmon: { r: 250, g: 128, b: 114 },
+  sandybrown: { r: 244, g: 164, b: 96 },
+  seagreen: { r: 46, g: 139, b: 87 },
+  seashell: { r: 255, g: 245, b: 238 },
+  sienna: { r: 160, g: 82, b: 45 },
+  silver: { r: 192, g: 192, b: 192 },
+  skyblue: { r: 135, g: 206, b: 235 },
+  slateblue: { r: 106, g: 90, b: 205 },
+  slategray: { r: 112, g: 128, b: 144 },
+  slategrey: { r: 112, g: 128, b: 144 },
+  snow: { r: 255, g: 250, b: 250 },
+  springgreen: { r: 0, g: 255, b: 127 },
+  steelblue: { r: 70, g: 130, b: 180 },
+  tan: { r: 210, g: 180, b: 140 },
+  teal: { r: 0, g: 128, b: 128 },
+  thistle: { r: 216, g: 191, b: 216 },
+  tomato: { r: 255, g: 99, b: 71 },
+  turquoise: { r: 64, g: 224, b: 208 },
+  violet: { r: 238, g: 130, b: 238 },
+  wheat: { r: 245, g: 222, b: 179 },
+  white: { r: 255, g: 255, b: 255 },
+  whitesmoke: { r: 245, g: 245, b: 245 },
+  yellow: { r: 255, g: 255, b: 0 },
+  yellowgreen: { r: 154, g: 205, b: 50 }
+};
+
+// src/agnostic/colors/typechecks/index.ts
+var isHex = (color) => {
+  if (typeof color !== "string") return false;
+  if (!color.startsWith("#")) return false;
+  const withoutHash = color.slice(1);
+  const withoutHashLength = withoutHash.length;
+  const allowedLengths = [3, 4, 6, 8];
+  if (!allowedLengths.includes(withoutHashLength)) return false;
+  return /^[0-9a-f]+$/igm.test(withoutHash);
+};
+var isRgb = (color) => {
+  if (!isNonNullObject(color)) return false;
+  const { r, g, b, a } = color;
+  if (typeof r !== "number") return false;
+  if (typeof g !== "number") return false;
+  if (typeof b !== "number") return false;
+  if (a !== void 0 && typeof a !== "number") return false;
+  return true;
+};
+var isHsl = (color) => {
+  if (!isNonNullObject(color)) return false;
+  const { h, s, l, a } = color;
+  if (typeof h !== "number") return false;
+  if (typeof s !== "number") return false;
+  if (typeof l !== "number") return false;
+  if (a !== void 0 && typeof a !== "number") return false;
+  return true;
+};
+var isHsb = (color) => {
+  if (!isNonNullObject(color)) return false;
+  const { h, s, b, a } = color;
+  if (typeof h !== "number") return false;
+  if (typeof s !== "number") return false;
+  if (typeof b !== "number") return false;
+  if (a !== void 0 && typeof a !== "number") return false;
+  return true;
+};
+var isLab = (color) => {
+  if (!isNonNullObject(color)) return false;
+  const { l, a, b, al } = color;
+  if (typeof l !== "number") return false;
+  if (typeof a !== "number") return false;
+  if (typeof b !== "number") return false;
+  if (al !== void 0 && typeof al !== "number") return false;
+  return true;
+};
+var isLch = (color) => {
+  if (!isNonNullObject(color)) return false;
+  const { l, c, h, a } = color;
+  if (typeof l !== "number") return false;
+  if (typeof c !== "number") return false;
+  if (typeof h !== "number") return false;
+  if (a !== void 0 && typeof a !== "number") return false;
+  return true;
+};
+var isCmyk = (color) => {
+  if (!isNonNullObject(color)) return false;
+  const { c, m, y, k, a } = color;
+  if (typeof c !== "number") return false;
+  if (typeof m !== "number") return false;
+  if (typeof y !== "number") return false;
+  if (typeof k !== "number") return false;
+  if (a !== void 0 && typeof a !== "number") return false;
+  return true;
+};
+var isXyz = (color) => {
+  if (!isNonNullObject(color)) return false;
+  const { x, y, z, a } = color;
+  if (typeof x !== "number") return false;
+  if (typeof y !== "number") return false;
+  if (typeof z !== "number") return false;
+  if (a !== void 0 && typeof a !== "number") return false;
+  return true;
+};
+var isCssColor = (color) => typeof color === "string" && cssColors[color] !== void 0;
+
+// src/agnostic/errors/unknown-to-string/index.ts
+function unknownToString(unk, encoding) {
+  if (unk instanceof Error) return unk.message;
+  if (unk instanceof Buffer) return unk.toString(encoding ?? "utf-8");
+  if (typeof unk === "string") return unk;
+  if (typeof unk === "object" && unk !== null) return JSON.stringify(unk);
+  return `${unk}`;
+}
+
+// src/agnostic/colors/convert/index.ts
+function _hex2rgb(hex) {
+  if (!isHex(hex)) throw new Error(`invalid hex color ${unknownToString(hex)}`);
+  let hexString = hex;
+  const inputHex = hexString;
+  const startsWithHash = hexString.startsWith("#");
+  if (!startsWithHash) throw new Error(`invalid hex color ${inputHex}`);
+  hexString = hexString.slice(1);
+  if (hexString.length === 3) {
+    hexString = hexString.split("").map((c) => c + c).join("") + "ff";
+  } else if (hexString.length === 4) {
+    hexString = hexString.split("").map((c) => c + c).join("");
+  } else if (hexString.length === 6) {
+    hexString = hexString + "ff";
+  } else if (hexString.length !== 8) throw new Error(`invalid hex color ${inputHex}`);
+  const r = parseInt(hexString.slice(0, 2), 16);
+  const g = parseInt(hexString.slice(2, 4), 16);
+  const b = parseInt(hexString.slice(4, 6), 16);
+  const a = parseInt(hexString.slice(6, 8), 16) / 255;
+  return { r, g, b, a };
+}
+function _rgb2hex(rgb) {
+  const { r, g, b, a = 1 } = rgb;
+  const rHex = Math.round(r).toString(16).padStart(2, "0");
+  const gHex = Math.round(g).toString(16).padStart(2, "0");
+  const bHex = Math.round(b).toString(16).padStart(2, "0");
+  const aHex = Math.round(a * 255).toString(16).padStart(2, "0");
+  const returned = `#${rHex}${gHex}${bHex}${aHex}`;
+  if (!isHex(returned)) {
+    throw new Error(`invalid hex color output ${unknownToString(returned)}`);
+  }
+  return returned;
+}
+function _css2rgb(color) {
+  if (color in cssColors) return cssColors[color];
+  return void 0;
+}
+var cssColorsWithHex = Object.entries(cssColors).map(([cssColor, rgba]) => ({
+  name: cssColor,
+  hex: _rgb2hex(rgba),
+  rgba
+}));
+function _hsl2rgb(hsl) {
+  const { h, s, l, a = 1 } = hsl;
+  const H = absoluteModulo(h, 360) / 360;
+  const S = Math.max(0, Math.min(1, s / 100));
+  const L = Math.max(0, Math.min(1, l / 100));
+  const A = Math.max(0, Math.min(1, a));
+  const hue2rgb = (p, q, t) => {
+    if (t < 0) t += 1;
+    if (t > 1) t -= 1;
+    if (t < 1 / 6) return p + (q - p) * 6 * t;
+    if (t < 1 / 2) return q;
+    if (t < 2 / 3) return p + (q - p) * (2 / 3 - t) * 6;
+    return p;
+  };
+  let r;
+  let g;
+  let b;
+  if (S === 0) {
+    r = g = b = L;
+  } else {
+    const q = L < 0.5 ? L * (1 + S) : L + S - L * S;
+    const p = 2 * L - q;
+    r = hue2rgb(p, q, H + 1 / 3);
+    g = hue2rgb(p, q, H);
+    b = hue2rgb(p, q, H - 1 / 3);
+  }
+  return {
+    r: Math.round(r * 255),
+    g: Math.round(g * 255),
+    b: Math.round(b * 255),
+    a: A
+  };
+}
+function _rgb2hsl(rgb) {
+  const { r, g, b, a = 1 } = rgb;
+  const R = r / 255;
+  const G = g / 255;
+  const B = b / 255;
+  const max = Math.max(R, G, B);
+  const min = Math.min(R, G, B);
+  const delta = max - min;
+  let h = 0;
+  let s = 0;
+  const l = (max + min) / 2;
+  if (delta !== 0) {
+    s = l > 0.5 ? delta / (2 - max - min) : delta / (max + min);
+    if (max === R) {
+      h = ((G - B) / delta + (G < B ? 6 : 0)) / 6;
+    } else if (max === G) {
+      h = ((B - R) / delta + 2) / 6;
+    } else {
+      h = ((R - G) / delta + 4) / 6;
+    }
+  }
+  return {
+    h: Math.round(h * 360),
+    s: Math.round(s * 100),
+    l: Math.round(l * 100),
+    a
+  };
+}
+function _hsb2rgb(hsb) {
+  const { h, s, b, a = 1 } = hsb;
+  const H = absoluteModulo(h, 360) / 360;
+  const S = Math.max(0, Math.min(1, s / 100));
+  const B = Math.max(0, Math.min(1, b / 100));
+  const A = Math.max(0, Math.min(1, a));
+  const i = Math.floor(H * 6);
+  const f = H * 6 - i;
+  const p = B * (1 - S);
+  const q = B * (1 - f * S);
+  const t = B * (1 - (1 - f) * S);
+  let r;
+  let g;
+  let blue;
+  switch (absoluteModulo(i, 6)) {
+    case 0:
+      r = B;
+      g = t;
+      blue = p;
+      break;
+    case 1:
+      r = q;
+      g = B;
+      blue = p;
+      break;
+    case 2:
+      r = p;
+      g = B;
+      blue = t;
+      break;
+    case 3:
+      r = p;
+      g = q;
+      blue = B;
+      break;
+    case 4:
+      r = t;
+      g = p;
+      blue = B;
+      break;
+    case 5:
+      r = B;
+      g = p;
+      blue = q;
+      break;
+    default:
+      r = g = blue = 0;
+  }
+  return {
+    r: Math.round(r * 255),
+    g: Math.round(g * 255),
+    b: Math.round(blue * 255),
+    a: A
+  };
+}
+function _rgb2hsb(rgb) {
+  const { r, g, b, a = 1 } = rgb;
+  const R = r / 255;
+  const G = g / 255;
+  const B = b / 255;
+  const max = Math.max(R, G, B);
+  const min = Math.min(R, G, B);
+  const delta = max - min;
+  let h = 0;
+  let s = 0;
+  const brightness = max;
+  if (max !== 0) {
+    s = delta / max;
+  }
+  if (delta !== 0) {
+    if (max === R) {
+      h = ((G - B) / delta + (G < B ? 6 : 0)) / 6;
+    } else if (max === G) {
+      h = ((B - R) / delta + 2) / 6;
+    } else {
+      h = ((R - G) / delta + 4) / 6;
+    }
+  }
+  return {
+    h: Math.round(h * 360),
+    s: Math.round(s * 100),
+    b: Math.round(brightness * 100),
+    a
+  };
+}
+function _cmyk2rgb(cmyka) {
+  const { c, m, y, k, a = 1 } = cmyka;
+  const C = Math.max(0, Math.min(100, c)) / 100;
+  const M = Math.max(0, Math.min(100, m)) / 100;
+  const Y = Math.max(0, Math.min(100, y)) / 100;
+  const K = Math.max(0, Math.min(100, k)) / 100;
+  const A = Math.max(0, Math.min(1, a));
+  const R = 1 - Math.min(1, C * (1 - K) + K);
+  const G = 1 - Math.min(1, M * (1 - K) + K);
+  const B = 1 - Math.min(1, Y * (1 - K) + K);
+  return {
+    r: Math.round(R * 255),
+    g: Math.round(G * 255),
+    b: Math.round(B * 255),
+    a: A
+  };
+}
+function _rgb2cmyk(rgb) {
+  const { r, g, b, a = 1 } = rgb;
+  const R = Math.max(0, Math.min(1, r / 255));
+  const G = Math.max(0, Math.min(1, g / 255));
+  const B = Math.max(0, Math.min(1, b / 255));
+  const A = Math.max(0, Math.min(1, a));
+  const K = 1 - Math.max(R, G, B);
+  const denom = 1 - K || 1;
+  const C = (1 - R - K) / denom;
+  const M = (1 - G - K) / denom;
+  const Y = (1 - B - K) / denom;
+  return {
+    c: Math.round(C * 100),
+    m: Math.round(M * 100),
+    y: Math.round(Y * 100),
+    k: Math.round(K * 100),
+    a: A
+  };
+}
+function _xyz2rgb(xyza) {
+  const { x, y, z, a = 1 } = xyza;
+  const X = x / 100;
+  const Y = y / 100;
+  const Z = z / 100;
+  const A = Math.max(0, Math.min(1, a));
+  let R = X * 3.2404542 + Y * -1.5371385 + Z * -0.4985314;
+  let G = X * -0.969266 + Y * 1.8760108 + Z * 0.041556;
+  let B = X * 0.0556434 + Y * -0.2040259 + Z * 1.0572252;
+  const GAMMA_THRESHOLD = 31308e-7;
+  const GAMMA_EXPONENT = 1 / 2.4;
+  const GAMMA_MULT = 1.055;
+  const GAMMA_OFFSET = 0.055;
+  const LINEAR_DIVISOR = 12.92;
+  const gammaCorrect = (c) => c <= GAMMA_THRESHOLD ? c * LINEAR_DIVISOR : GAMMA_MULT * Math.pow(c, GAMMA_EXPONENT) - GAMMA_OFFSET;
+  R = gammaCorrect(R);
+  G = gammaCorrect(G);
+  B = gammaCorrect(B);
+  return {
+    r: Math.round(Math.max(0, Math.min(1, R)) * 255),
+    g: Math.round(Math.max(0, Math.min(1, G)) * 255),
+    b: Math.round(Math.max(0, Math.min(1, B)) * 255),
+    a: A
+  };
+}
+function _rgb2xyz(rgb) {
+  const { r, g, b, a = 1 } = rgb;
+  let R = Math.max(0, Math.min(1, r / 255));
+  let G = Math.max(0, Math.min(1, g / 255));
+  let B = Math.max(0, Math.min(1, b / 255));
+  const A = Math.max(0, Math.min(1, a));
+  const SRGB_THRESHOLD = 0.04045;
+  const SRGB_OFFSET = 0.055;
+  const SRGB_DIVISOR = 1.055;
+  const SRGB_EXPONENT = 2.4;
+  const SRGB_LINEAR_DIVISOR = 12.92;
+  const linearize = (c) => c > SRGB_THRESHOLD ? Math.pow((c + SRGB_OFFSET) / SRGB_DIVISOR, SRGB_EXPONENT) : c / SRGB_LINEAR_DIVISOR;
+  R = linearize(R);
+  G = linearize(G);
+  B = linearize(B);
+  const X = R * 0.4124564 + G * 0.3575761 + B * 0.1804375;
+  const Y = R * 0.2126729 + G * 0.7151522 + B * 0.072175;
+  const Z = R * 0.0193339 + G * 0.119192 + B * 0.9503041;
+  return {
+    x: X * 100,
+    y: Y * 100,
+    z: Z * 100,
+    a: A
+  };
+}
+function _lab2xyz(lab) {
+  const { l, a: A = 0, b: B = 0, al: alpha = 1 } = lab;
+  const REF_X = 95.047;
+  const REF_Y = 100;
+  const REF_Z = 108.883;
+  const fy = (l + 16) / 116;
+  const fx = fy + A / 500;
+  const fz = fy - B / 200;
+  const fx3 = Math.pow(fx, 3);
+  const fz3 = Math.pow(fz, 3);
+  const fy3 = Math.pow(fy, 3);
+  const epsilon = 8856e-6;
+  const kappa = 903.3;
+  const X = fx3 > epsilon ? fx3 : (116 * fx - 16) / kappa;
+  const Y = l > kappa * epsilon ? fy3 : l / kappa;
+  const Z = fz3 > epsilon ? fz3 : (116 * fz - 16) / kappa;
+  return {
+    x: X * REF_X,
+    y: Y * REF_Y,
+    z: Z * REF_Z,
+    a: Math.max(0, Math.min(1, alpha))
+  };
+}
+function _xyz2lab(xyza) {
+  const { x, y, z, a: alpha = 1 } = xyza;
+  const REF_X = 95.047;
+  const REF_Y = 100;
+  const REF_Z = 108.883;
+  const X = x / REF_X;
+  const Y = y / REF_Y;
+  const Z = z / REF_Z;
+  const epsilon = 8856e-6;
+  const kappa = 903.3;
+  const fx = X > epsilon ? Math.cbrt(X) : (kappa * X + 16) / 116;
+  const fy = Y > epsilon ? Math.cbrt(Y) : (kappa * Y + 16) / 116;
+  const fz = Z > epsilon ? Math.cbrt(Z) : (kappa * Z + 16) / 116;
+  const L = 116 * fy - 16;
+  const A = 500 * (fx - fy);
+  const B = 200 * (fy - fz);
+  return {
+    l: L,
+    a: A,
+    b: B,
+    al: Math.max(0, Math.min(1, alpha))
+  };
+}
+function _lab2lch(lab) {
+  const { l, a, b, al = 1 } = lab;
+  const c = Math.sqrt(a * a + b * b);
+  let h = Math.atan2(b, a) * (180 / Math.PI);
+  if (h < 0) h += 360;
+  return { l, c, h, a: al };
+}
+function _lch2lab(lch) {
+  const { l, c, h, a = 1 } = lch;
+  const hRad = h * Math.PI / 180;
+  const A = c * Math.cos(hRad);
+  const B = c * Math.sin(hRad);
+  return { l, a: A, b: B, al: a };
+}
+function toRgb(color) {
+  if (isRgb(color)) return color;
+  if (isHsl(color)) return _hsl2rgb(color);
+  if (isHsb(color)) return _hsb2rgb(color);
+  if (isCmyk(color)) return _cmyk2rgb(color);
+  if (isCssColor(color)) return _css2rgb(color);
+  if (isHex(color)) return _hex2rgb(color);
+  if (isXyz(color)) return _xyz2rgb(color);
+  if (isLab(color)) return _xyz2rgb(_lab2xyz(color));
+  if (isLch(color)) return _xyz2rgb(_lab2xyz(_lch2lab(color)));
+  throw new Error(`Invalid color input: ${unknownToString(color)}`);
+}
+function toXyz(color) {
+  if (isXyz(color)) return color;
+  if (isLab(color)) return _lab2xyz(color);
+  if (isLch(color)) return _lab2xyz(_lch2lab(color));
+  if (isRgb(color)) return _rgb2xyz(color);
+  if (isHsl(color)) return _rgb2xyz(_hsl2rgb(color));
+  if (isHsb(color)) return _rgb2xyz(_hsb2rgb(color));
+  if (isCmyk(color)) return _rgb2xyz(_cmyk2rgb(color));
+  if (isCssColor(color)) return _rgb2xyz(_css2rgb(color));
+  if (isHex(color)) return _rgb2xyz(_hex2rgb(color));
+  throw new Error(`Invalid color input: ${unknownToString(color)}`);
+}
+function toLab(color) {
+  if (isLab(color)) return color;
+  if (isLch(color)) return _lch2lab(color);
+  const xyzColor = toXyz(color);
+  return _xyz2lab(xyzColor);
+}
+function toLch(color) {
+  if (isLch(color)) return color;
+  const labColor = toLab(color);
+  return _lab2lch(labColor);
+}
+function toHsl(color) {
+  if (isHsl(color)) return color;
+  const rgbColor = toRgb(color);
+  return _rgb2hsl(rgbColor);
+}
+function toHsb(color) {
+  if (isHsb(color)) return color;
+  const rgbColor = toRgb(color);
+  return _rgb2hsb(rgbColor);
+}
+function toCmyk(color) {
+  if (isCmyk(color)) return color;
+  const rgbColor = toRgb(color);
+  return _rgb2cmyk(rgbColor);
+}
+function toHex(color) {
+  if (isHex(color)) return color;
+  const rgbColor = toRgb(color);
+  return _rgb2hex(rgbColor);
+}
+function viaRgb(color, transformer) {
+  const _color = color;
+  const rgb = toRgb(_color);
+  const transformedRgb = transformer(rgb);
+  if (isRgb(_color)) return transformedRgb;
+  if (isHsl(_color)) return toHsl(transformedRgb);
+  if (isHsb(_color)) return toHsb(transformedRgb);
+  if (isCmyk(_color)) return toCmyk(transformedRgb);
+  if (isXyz(_color)) return toXyz(transformedRgb);
+  if (isLab(_color)) return toLab(transformedRgb);
+  if (isLch(_color)) return toLch(transformedRgb);
+  if (isHex(_color)) return toRgb(transformedRgb);
+  if (isCssColor(_color)) return transformedRgb;
+  const _typecheck = true;
+  throw new Error(`Invalid color input: ${unknownToString(_color)}`);
+}
+function viaHsl(color, transformer) {
+  const _color = color;
+  const hsl = toHsl(_color);
+  const transformedHsl = transformer(hsl);
+  if (isHsl(_color)) return transformedHsl;
+  if (isRgb(_color)) return toRgb(transformedHsl);
+  if (isHsb(_color)) return toHsb(transformedHsl);
+  if (isCmyk(_color)) return toCmyk(transformedHsl);
+  if (isXyz(_color)) return toXyz(transformedHsl);
+  if (isLab(_color)) return toLab(transformedHsl);
+  if (isLch(_color)) return toLch(transformedHsl);
+  if (isHex(_color)) return toHex(transformedHsl);
+  if (isCssColor(_color)) return transformedHsl;
+  const _typecheck = true;
+  throw new Error(`Invalid color input: ${unknownToString(_color)}`);
+}
+function viaHsb(color, transformer) {
+  const _color = color;
+  const hsb = toHsb(_color);
+  const transformedHsb = transformer(hsb);
+  if (isHsb(_color)) return transformedHsb;
+  if (isRgb(_color)) return toRgb(transformedHsb);
+  if (isHsl(_color)) return toHsl(transformedHsb);
+  if (isCmyk(_color)) return toCmyk(transformedHsb);
+  if (isXyz(_color)) return toXyz(transformedHsb);
+  if (isLab(_color)) return toLab(transformedHsb);
+  if (isLch(_color)) return toLch(transformedHsb);
+  if (isHex(_color)) return toHex(transformedHsb);
+  if (isCssColor(_color)) return transformedHsb;
+  const _typecheck = true;
+  throw new Error(`Invalid color input: ${unknownToString(_color)}`);
+}
+function viaCmyk(color, transformer) {
+  const _color = color;
+  const cmyk = toCmyk(_color);
+  const transformedCmyk = transformer(cmyk);
+  if (isHsb(_color)) return transformedCmyk;
+  if (isRgb(_color)) return toRgb(transformedCmyk);
+  if (isHsl(_color)) return toHsl(transformedCmyk);
+  if (isCmyk(_color)) return toCmyk(transformedCmyk);
+  if (isXyz(_color)) return toXyz(transformedCmyk);
+  if (isLab(_color)) return toLab(transformedCmyk);
+  if (isLch(_color)) return toLch(transformedCmyk);
+  if (isHex(_color)) return toHex(transformedCmyk);
+  if (isCssColor(_color)) return transformedCmyk;
+  const _typecheck = true;
+  throw new Error(`Invalid color input: ${unknownToString(_color)}`);
+}
+function viaXyz(color, transformer) {
+  const _color = color;
+  const xyz = toXyz(_color);
+  const transformedXyz = transformer(xyz);
+  if (isHsb(_color)) return transformedXyz;
+  if (isRgb(_color)) return toRgb(transformedXyz);
+  if (isHsl(_color)) return toHsl(transformedXyz);
+  if (isCmyk(_color)) return toCmyk(transformedXyz);
+  if (isXyz(_color)) return toXyz(transformedXyz);
+  if (isLab(_color)) return toLab(transformedXyz);
+  if (isLch(_color)) return toLch(transformedXyz);
+  if (isHex(_color)) return toHex(transformedXyz);
+  if (isCssColor(_color)) return transformedXyz;
+  const _typecheck = true;
+  throw new Error(`Invalid color input: ${unknownToString(_color)}`);
+}
+function viaLab(color, transformer) {
+  const _color = color;
+  const lab = toLab(_color);
+  const transformedLab = transformer(lab);
+  if (isHsb(_color)) return transformedLab;
+  if (isRgb(_color)) return toRgb(transformedLab);
+  if (isHsl(_color)) return toHsl(transformedLab);
+  if (isCmyk(_color)) return toCmyk(transformedLab);
+  if (isXyz(_color)) return toXyz(transformedLab);
+  if (isLab(_color)) return toLab(transformedLab);
+  if (isLch(_color)) return toLch(transformedLab);
+  if (isHex(_color)) return toHex(transformedLab);
+  if (isCssColor(_color)) return transformedLab;
+  const _typecheck = true;
+  throw new Error(`Invalid color input: ${unknownToString(_color)}`);
+}
+function viaLch(color, transformer) {
+  const _color = color;
+  const lch = toLch(_color);
+  const transformedLch = transformer(lch);
+  if (isHsb(_color)) return transformedLch;
+  if (isRgb(_color)) return toRgb(transformedLch);
+  if (isHsl(_color)) return toHsl(transformedLch);
+  if (isCmyk(_color)) return toCmyk(transformedLch);
+  if (isXyz(_color)) return toXyz(transformedLch);
+  if (isLab(_color)) return toLab(transformedLch);
+  if (isLch(_color)) return toLch(transformedLch);
+  if (isHex(_color)) return toHex(transformedLch);
+  if (isCssColor(_color)) return transformedLch;
+  const _typecheck = true;
+  throw new Error(`Invalid color input: ${unknownToString(_color)}`);
+}
+
+// src/agnostic/colors/channels/index.ts
+function addChannel(color, channel, amount) {
+  switch (channel) {
+    case "red":
+      return viaRgb(color, (rgb) => ({ ...rgb, r: clamp(rgb.r + amount, 0, 255) }));
+    case "green":
+      return viaRgb(color, (rgb) => ({ ...rgb, g: clamp(rgb.g + amount, 0, 255) }));
+    case "blue":
+      return viaRgb(color, (rgb) => ({ ...rgb, b: clamp(rgb.b + amount, 0, 255) }));
+    case "hue":
+      return viaHsl(color, (hsl) => ({ ...hsl, h: absoluteModulo(hsl.h + amount, 360) }));
+    case "saturation":
+      return viaHsl(color, (hsl) => ({ ...hsl, s: clamp(hsl.s + amount, 0, 100) }));
+    case "lightness":
+      return viaHsl(color, (hsl) => ({ ...hsl, l: clamp(hsl.l + amount, 0, 100) }));
+    case "brightness":
+      return viaHsb(color, (hsb) => ({ ...hsb, b: clamp(hsb.b + amount, 0, 100) }));
+    case "alpha":
+      return viaRgb(color, (rgb) => ({ ...rgb, a: clamp(rgb.a ?? 1 + amount, 0, 1) }));
+    case "cyan":
+      return viaCmyk(color, (cmyk) => ({ ...cmyk, c: clamp(cmyk.c + amount, 0, 100) }));
+    case "magenta":
+      return viaCmyk(color, (cmyk) => ({ ...cmyk, m: clamp(cmyk.m + amount, 0, 100) }));
+    case "yellow":
+      return viaCmyk(color, (cmyk) => ({ ...cmyk, y: clamp(cmyk.y + amount, 0, 100) }));
+    case "black":
+      return viaCmyk(color, (cmyk) => ({ ...cmyk, k: clamp(cmyk.k + amount, 0, 100) }));
+    case "x":
+      return viaXyz(color, (xyz) => ({ ...xyz, x: xyz.x + amount }));
+    case "y":
+      return viaXyz(color, (xyz) => ({ ...xyz, y: xyz.y + amount }));
+    case "z":
+      return viaXyz(color, (xyz) => ({ ...xyz, z: xyz.z + amount }));
+    case "lightnessLab":
+      return viaLab(color, (lab) => ({ ...lab, l: clamp(lab.l + amount, 0, 100) }));
+    case "aLab":
+      return viaLab(color, (lab) => ({ ...lab, a: lab.a + amount }));
+    case "bLab":
+      return viaLab(color, (lab) => ({ ...lab, b: lab.b + amount }));
+    case "chroma":
+      return viaLch(color, (lch) => ({ ...lch, c: Math.max(0, lch.c + amount) }));
+    case "hueLch":
+      return viaLch(color, (lch) => ({ ...lch, h: clamp(lch.h + amount, 0, 360) }));
+  }
+}
+
+// src/agnostic/colors/rotate/index.ts
+function rotateHsl(color, degrees) {
+  return addChannel(color, "hue", degrees);
+}
+function rotateLab(color, degrees) {
+  return viaLab(color, (lab) => {
+    const hue = Math.atan2(lab.b, lab.a) * (180 / Math.PI);
+    const chroma = Math.sqrt(lab.a ** 2 + lab.b ** 2);
+    const newHue = absoluteModulo(hue + degrees, 360);
+    const rad = newHue * (Math.PI / 180);
+    return {
+      ...lab,
+      a: chroma * Math.cos(rad),
+      b: chroma * Math.sin(rad)
+    };
+  });
+}
+function rotateLch(color, degrees) {
+  return viaLch(color, (lch) => ({
+    ...lch,
+    h: absoluteModulo(lch.h + degrees, 360)
+  }));
+}
+function rotate(color, degrees, method = "hsl") {
+  switch (method) {
+    case "hsl":
+      return rotateHsl(color, degrees);
+    case "lab":
+      return rotateLab(color, degrees);
+    case "lch":
+      return rotateLch(color, degrees);
+  }
+}
 
 // src/agnostic/colors/palette/index.ts
 function complementaryHsl(color) {