@tempots/std 0.27.0 → 0.28.1

package/color-lab.js

@@ -0,0 +1,15 @@
+import "./error.js";
+import "./number.js";
+import { f as o, g as c, J as L, K as g, M as h, N as T, _ as e, $ as p, a9 as t, aa as i } from "./color-SZxckS9U.js";
+export {
+  o as canParseLab,
+  c as canParseLch,
+  L as labaToLabString,
+  g as labaToRgb8a,
+  h as lchaToLchString,
+  T as lchaToRgb8a,
+  e as parseLab,
+  p as parseLch,
+  t as rgb8aToLaba,
+  i as rgb8aToLcha
+};

package/color-mix.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./color-D7FAmkht.cjs"),p=require("./number.cjs"),r=p.interpolate,b=p.interpolateAngle,i=(e,t,l,h)=>{const n=s.convertColor(e,h),c=s.convertColor(t,h);switch(h){case"rgb":{const a=n,o=c;return s.rgba(r(a.r,o.r,l),r(a.g,o.g,l),r(a.b,o.b,l),r(a.alpha,o.alpha,l))}case"rgb8":{const a=n,o=c;return s.rgb8a(Math.round(r(a.r,o.r,l)),Math.round(r(a.g,o.g,l)),Math.round(r(a.b,o.b,l)),r(a.alpha,o.alpha,l))}case"hsl":{const a=n,o=c;return s.hsla(b(a.h,o.h,l),r(a.s,o.s,l),r(a.l,o.l,l),r(a.alpha,o.alpha,l))}case"hsv":{const a=n,o=c;return s.hsva(b(a.h,o.h,l),r(a.s,o.s,l),r(a.v,o.v,l),r(a.alpha,o.alpha,l))}case"hwb":{const a=n,o=c;return s.hwba(b(a.h,o.h,l),r(a.w,o.w,l),r(a.b,o.b,l),r(a.alpha,o.alpha,l))}case"lab":{const a=n,o=c;return s.laba(r(a.l,o.l,l),r(a.a,o.a,l),r(a.b,o.b,l),r(a.alpha,o.alpha,l))}case"lch":{const a=n,o=c;return s.lcha(r(a.l,o.l,l),r(a.c,o.c,l),b(a.h,o.h,l),r(a.alpha,o.alpha,l))}case"oklab":{const a=n,o=c;return s.oklaba(r(a.l,o.l,l),r(a.a,o.a,l),r(a.b,o.b,l),r(a.alpha,o.alpha,l))}case"oklch":{const a=n,o=c;return s.oklcha(r(a.l,o.l,l),r(a.c,o.c,l),b(a.h,o.h,l),r(a.alpha,o.alpha,l))}}},u=(e,t,l=.5,h="oklch")=>i(e,t,l,h),g=(e,t,l,h="oklch")=>{if(l<2)return[u(e,t,.5,h)];const n=[];for(let c=0;c<l;c++){const a=c/(l-1);n.push(u(e,t,a,h))}return n};exports.interpolateColors=g;exports.mixColors=u;

package/color-mix.d.ts

@@ -0,0 +1,50 @@
+import { Color, ColorSpace } from './color';
+/**
+ * Blends two colors together in the specified color space.
+ *
+ * Converts both colors to the target space, linearly
+ * interpolates each channel (using shortest-path hue
+ * interpolation for polar spaces), and returns the result
+ * in the target space.
+ *
+ * @param a - The first color.
+ * @param b - The second color.
+ * @param t - The blend factor (0 = fully `a`, 1 = fully `b`).
+ *   Defaults to 0.5.
+ * @param space - The color space to blend in.
+ *   Defaults to `'oklch'`.
+ * @returns The blended color in the specified space.
+ * @public
+ * @example
+ * ```ts
+ * import { rgb8a } from './color'
+ * mixColors(rgb8a(255, 0, 0), rgb8a(0, 0, 255))
+ * // blended in oklch at t=0.5
+ * mixColors(rgb8a(255, 0, 0), rgb8a(0, 0, 255), 0.25, 'lab')
+ * // 25% blend in LAB space
+ * ```
+ */
+export declare const mixColors: (a: Color, b: Color, t?: number, space?: ColorSpace) => Color;
+/**
+ * Generates an array of evenly spaced colors between two
+ * endpoints (inclusive).
+ *
+ * If `steps` is less than 2, returns a single-element array
+ * containing the midpoint blend of `a` and `b`.
+ *
+ * @param a - The start color.
+ * @param b - The end color.
+ * @param steps - The number of colors to generate (inclusive
+ *   of both endpoints).
+ * @param space - The color space to interpolate in.
+ *   Defaults to `'oklch'`.
+ * @returns An array of interpolated colors.
+ * @public
+ * @example
+ * ```ts
+ * import { rgb8a } from './color'
+ * interpolateColors(rgb8a(255, 0, 0), rgb8a(0, 0, 255), 5)
+ * // [red, ..., blue] — 5 evenly spaced colors in oklch
+ * ```
+ */
+export declare const interpolateColors: (a: Color, b: Color, steps: number, space?: ColorSpace) => Color[];

package/color-mix.js

@@ -0,0 +1,101 @@
+import { m as b, R as u, O as x, L as i, I as g, w as y, s as m, o as k, a4 as w, af as f } from "./color-SZxckS9U.js";
+import { interpolate as v, interpolateAngle as d } from "./number.js";
+const l = v, p = d, C = (h, e, s, n) => {
+  const c = b(h, n), r = b(e, n);
+  switch (n) {
+    case "rgb": {
+      const a = c, o = r;
+      return f(
+        l(a.r, o.r, s),
+        l(a.g, o.g, s),
+        l(a.b, o.b, s),
+        l(a.alpha, o.alpha, s)
+      );
+    }
+    case "rgb8": {
+      const a = c, o = r;
+      return w(
+        Math.round(l(a.r, o.r, s)),
+        Math.round(l(a.g, o.g, s)),
+        Math.round(l(a.b, o.b, s)),
+        l(a.alpha, o.alpha, s)
+      );
+    }
+    case "hsl": {
+      const a = c, o = r;
+      return k(
+        p(a.h, o.h, s),
+        l(a.s, o.s, s),
+        l(a.l, o.l, s),
+        l(a.alpha, o.alpha, s)
+      );
+    }
+    case "hsv": {
+      const a = c, o = r;
+      return m(
+        p(a.h, o.h, s),
+        l(a.s, o.s, s),
+        l(a.v, o.v, s),
+        l(a.alpha, o.alpha, s)
+      );
+    }
+    case "hwb": {
+      const a = c, o = r;
+      return y(
+        p(a.h, o.h, s),
+        l(a.w, o.w, s),
+        l(a.b, o.b, s),
+        l(a.alpha, o.alpha, s)
+      );
+    }
+    case "lab": {
+      const a = c, o = r;
+      return g(
+        l(a.l, o.l, s),
+        l(a.a, o.a, s),
+        l(a.b, o.b, s),
+        l(a.alpha, o.alpha, s)
+      );
+    }
+    case "lch": {
+      const a = c, o = r;
+      return i(
+        l(a.l, o.l, s),
+        l(a.c, o.c, s),
+        p(a.h, o.h, s),
+        l(a.alpha, o.alpha, s)
+      );
+    }
+    case "oklab": {
+      const a = c, o = r;
+      return x(
+        l(a.l, o.l, s),
+        l(a.a, o.a, s),
+        l(a.b, o.b, s),
+        l(a.alpha, o.alpha, s)
+      );
+    }
+    case "oklch": {
+      const a = c, o = r;
+      return u(
+        l(a.l, o.l, s),
+        l(a.c, o.c, s),
+        p(a.h, o.h, s),
+        l(a.alpha, o.alpha, s)
+      );
+    }
+  }
+}, t = (h, e, s = 0.5, n = "oklch") => C(h, e, s, n), A = (h, e, s, n = "oklch") => {
+  if (s < 2)
+    return [t(h, e, 0.5, n)];
+  const c = [];
+  for (let r = 0; r < s; r++) {
+    const a = r / (s - 1);
+    c.push(t(h, e, a, n));
+  }
+  return c;
+};
+export {
+  A as interpolateColors,
+  t as mixColors
+};

package/color-named.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e={aliceblue:[240,248,255],antiquewhite:[250,235,215],aqua:[0,255,255],aquamarine:[127,255,212],azure:[240,255,255],beige:[245,245,220],bisque:[255,228,196],black:[0,0,0],blanchedalmond:[255,235,205],blue:[0,0,255],blueviolet:[138,43,226],brown:[165,42,42],burlywood:[222,184,135],cadetblue:[95,158,160],chartreuse:[127,255,0],chocolate:[210,105,30],coral:[255,127,80],cornflowerblue:[100,149,237],cornsilk:[255,248,220],crimson:[220,20,60],cyan:[0,255,255],darkblue:[0,0,139],darkcyan:[0,139,139],darkgoldenrod:[184,134,11],darkgray:[169,169,169],darkgreen:[0,100,0],darkgrey:[169,169,169],darkkhaki:[189,183,107],darkmagenta:[139,0,139],darkolivegreen:[85,107,47],darkorange:[255,140,0],darkorchid:[153,50,204],darkred:[139,0,0],darksalmon:[233,150,122],darkseagreen:[143,188,143],darkslateblue:[72,61,139],darkslategray:[47,79,79],darkslategrey:[47,79,79],darkturquoise:[0,206,209],darkviolet:[148,0,211],deeppink:[255,20,147],deepskyblue:[0,191,255],dimgray:[105,105,105],dimgrey:[105,105,105],dodgerblue:[30,144,255],firebrick:[178,34,34],floralwhite:[255,250,240],forestgreen:[34,139,34],fuchsia:[255,0,255],gainsboro:[220,220,220],ghostwhite:[248,248,255],gold:[255,215,0],goldenrod:[218,165,32],gray:[128,128,128],green:[0,128,0],greenyellow:[173,255,47],grey:[128,128,128],honeydew:[240,255,240],hotpink:[255,105,180],indianred:[205,92,92],indigo:[75,0,130],ivory:[255,255,240],khaki:[240,230,140],lavender:[230,230,250],lavenderblush:[255,240,245],lawngreen:[124,252,0],lemonchiffon:[255,250,205],lightblue:[173,216,230],lightcoral:[240,128,128],lightcyan:[224,255,255],lightgoldenrodyellow:[250,250,210],lightgray:[211,211,211],lightgreen:[144,238,144],lightgrey:[211,211,211],lightpink:[255,182,193],lightsalmon:[255,160,122],lightseagreen:[32,178,170],lightskyblue:[135,206,250],lightslategray:[119,136,153],lightslategrey:[119,136,153],lightsteelblue:[176,196,222],lightyellow:[255,255,224],lime:[0,255,0],limegreen:[50,205,50],linen:[250,240,230],magenta:[255,0,255],maroon:[128,0,0],mediumaquamarine:[102,205,170],mediumblue:[0,0,205],mediumorchid:[186,85,211],mediumpurple:[147,112,219],mediumseagreen:[60,179,113],mediumslateblue:[123,104,238],mediumspringgreen:[0,250,154],mediumturquoise:[72,209,204],mediumvioletred:[199,21,133],midnightblue:[25,25,112],mintcream:[245,255,250],mistyrose:[255,228,225],moccasin:[255,228,181],navajowhite:[255,222,173],navy:[0,0,128],oldlace:[253,245,230],olive:[128,128,0],olivedrab:[107,142,35],orange:[255,165,0],orangered:[255,69,0],orchid:[218,112,214],palegoldenrod:[238,232,170],palegreen:[152,251,152],paleturquoise:[175,238,238],palevioletred:[219,112,147],papayawhip:[255,239,213],peachpuff:[255,218,185],peru:[205,133,63],pink:[255,192,203],plum:[221,160,221],powderblue:[176,224,230],purple:[128,0,128],rebeccapurple:[102,51,153],red:[255,0,0],rosybrown:[188,143,143],royalblue:[65,105,225],saddlebrown:[139,69,19],salmon:[250,128,114],sandybrown:[244,164,96],seagreen:[46,139,87],seashell:[255,245,238],sienna:[160,82,45],silver:[192,192,192],skyblue:[135,206,235],slateblue:[106,90,205],slategray:[112,128,144],slategrey:[112,128,144],snow:[255,250,250],springgreen:[0,255,127],steelblue:[70,130,180],tan:[210,180,140],teal:[0,128,128],thistle:[216,191,216],tomato:[255,99,71],turquoise:[64,224,208],violet:[238,130,238],wheat:[245,222,179],white:[255,255,255],whitesmoke:[245,245,245],yellow:[255,255,0],yellowgreen:[154,205,50]};exports.NAMED_COLORS=e;

package/color-named.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CSS named colors map.
+ *
+ * Contains all 148 CSS named colors as lowercase keys mapped to `[r, g, b]` tuples.
+ *
+ * @public
+ */
+export declare const NAMED_COLORS: Record<string, readonly [number, number, number]>;

package/color-named.js

@@ -0,0 +1,153 @@
+const e = {
+  aliceblue: [240, 248, 255],
+  antiquewhite: [250, 235, 215],
+  aqua: [0, 255, 255],
+  aquamarine: [127, 255, 212],
+  azure: [240, 255, 255],
+  beige: [245, 245, 220],
+  bisque: [255, 228, 196],
+  black: [0, 0, 0],
+  blanchedalmond: [255, 235, 205],
+  blue: [0, 0, 255],
+  blueviolet: [138, 43, 226],
+  brown: [165, 42, 42],
+  burlywood: [222, 184, 135],
+  cadetblue: [95, 158, 160],
+  chartreuse: [127, 255, 0],
+  chocolate: [210, 105, 30],
+  coral: [255, 127, 80],
+  cornflowerblue: [100, 149, 237],
+  cornsilk: [255, 248, 220],
+  crimson: [220, 20, 60],
+  cyan: [0, 255, 255],
+  darkblue: [0, 0, 139],
+  darkcyan: [0, 139, 139],
+  darkgoldenrod: [184, 134, 11],
+  darkgray: [169, 169, 169],
+  darkgreen: [0, 100, 0],
+  darkgrey: [169, 169, 169],
+  darkkhaki: [189, 183, 107],
+  darkmagenta: [139, 0, 139],
+  darkolivegreen: [85, 107, 47],
+  darkorange: [255, 140, 0],
+  darkorchid: [153, 50, 204],
+  darkred: [139, 0, 0],
+  darksalmon: [233, 150, 122],
+  darkseagreen: [143, 188, 143],
+  darkslateblue: [72, 61, 139],
+  darkslategray: [47, 79, 79],
+  darkslategrey: [47, 79, 79],
+  darkturquoise: [0, 206, 209],
+  darkviolet: [148, 0, 211],
+  deeppink: [255, 20, 147],
+  deepskyblue: [0, 191, 255],
+  dimgray: [105, 105, 105],
+  dimgrey: [105, 105, 105],
+  dodgerblue: [30, 144, 255],
+  firebrick: [178, 34, 34],
+  floralwhite: [255, 250, 240],
+  forestgreen: [34, 139, 34],
+  fuchsia: [255, 0, 255],
+  gainsboro: [220, 220, 220],
+  ghostwhite: [248, 248, 255],
+  gold: [255, 215, 0],
+  goldenrod: [218, 165, 32],
+  gray: [128, 128, 128],
+  green: [0, 128, 0],
+  greenyellow: [173, 255, 47],
+  grey: [128, 128, 128],
+  honeydew: [240, 255, 240],
+  hotpink: [255, 105, 180],
+  indianred: [205, 92, 92],
+  indigo: [75, 0, 130],
+  ivory: [255, 255, 240],
+  khaki: [240, 230, 140],
+  lavender: [230, 230, 250],
+  lavenderblush: [255, 240, 245],
+  lawngreen: [124, 252, 0],
+  lemonchiffon: [255, 250, 205],
+  lightblue: [173, 216, 230],
+  lightcoral: [240, 128, 128],
+  lightcyan: [224, 255, 255],
+  lightgoldenrodyellow: [250, 250, 210],
+  lightgray: [211, 211, 211],
+  lightgreen: [144, 238, 144],
+  lightgrey: [211, 211, 211],
+  lightpink: [255, 182, 193],
+  lightsalmon: [255, 160, 122],
+  lightseagreen: [32, 178, 170],
+  lightskyblue: [135, 206, 250],
+  lightslategray: [119, 136, 153],
+  lightslategrey: [119, 136, 153],
+  lightsteelblue: [176, 196, 222],
+  lightyellow: [255, 255, 224],
+  lime: [0, 255, 0],
+  limegreen: [50, 205, 50],
+  linen: [250, 240, 230],
+  magenta: [255, 0, 255],
+  maroon: [128, 0, 0],
+  mediumaquamarine: [102, 205, 170],
+  mediumblue: [0, 0, 205],
+  mediumorchid: [186, 85, 211],
+  mediumpurple: [147, 112, 219],
+  mediumseagreen: [60, 179, 113],
+  mediumslateblue: [123, 104, 238],
+  mediumspringgreen: [0, 250, 154],
+  mediumturquoise: [72, 209, 204],
+  mediumvioletred: [199, 21, 133],
+  midnightblue: [25, 25, 112],
+  mintcream: [245, 255, 250],
+  mistyrose: [255, 228, 225],
+  moccasin: [255, 228, 181],
+  navajowhite: [255, 222, 173],
+  navy: [0, 0, 128],
+  oldlace: [253, 245, 230],
+  olive: [128, 128, 0],
+  olivedrab: [107, 142, 35],
+  orange: [255, 165, 0],
+  orangered: [255, 69, 0],
+  orchid: [218, 112, 214],
+  palegoldenrod: [238, 232, 170],
+  palegreen: [152, 251, 152],
+  paleturquoise: [175, 238, 238],
+  palevioletred: [219, 112, 147],
+  papayawhip: [255, 239, 213],
+  peachpuff: [255, 218, 185],
+  peru: [205, 133, 63],
+  pink: [255, 192, 203],
+  plum: [221, 160, 221],
+  powderblue: [176, 224, 230],
+  purple: [128, 0, 128],
+  rebeccapurple: [102, 51, 153],
+  red: [255, 0, 0],
+  rosybrown: [188, 143, 143],
+  royalblue: [65, 105, 225],
+  saddlebrown: [139, 69, 19],
+  salmon: [250, 128, 114],
+  sandybrown: [244, 164, 96],
+  seagreen: [46, 139, 87],
+  seashell: [255, 245, 238],
+  sienna: [160, 82, 45],
+  silver: [192, 192, 192],
+  skyblue: [135, 206, 235],
+  slateblue: [106, 90, 205],
+  slategray: [112, 128, 144],
+  slategrey: [112, 128, 144],
+  snow: [255, 250, 250],
+  springgreen: [0, 255, 127],
+  steelblue: [70, 130, 180],
+  tan: [210, 180, 140],
+  teal: [0, 128, 128],
+  thistle: [216, 191, 216],
+  tomato: [255, 99, 71],
+  turquoise: [64, 224, 208],
+  violet: [238, 130, 238],
+  wheat: [245, 222, 179],
+  white: [255, 255, 255],
+  whitesmoke: [245, 245, 245],
+  yellow: [255, 255, 0],
+  yellowgreen: [154, 205, 50]
+};
+export {
+  e as NAMED_COLORS
+};

package/color-oklab.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("./error.cjs");require("./number.cjs");const a=require("./color-D7FAmkht.cjs");exports.canParseOklab=a.canParseOklab;exports.canParseOklch=a.canParseOklch;exports.oklabaToOklabString=a.oklabaToOklabString;exports.oklabaToRgb8a=a.oklabaToRgb8a;exports.oklchaToOklchString=a.oklchaToOklchString;exports.oklchaToRgb8a=a.oklchaToRgb8a;exports.parseOklab=a.parseOklab;exports.parseOklch=a.parseOklch;exports.rgb8aToOklaba=a.rgb8aToOklaba;exports.rgb8aToOklcha=a.rgb8aToOklcha;

package/color-oklab.d.ts

@@ -0,0 +1,141 @@
+import { RGB8A, OKLABA, OKLCHA } from './color';
+/**
+ * Returns `true` if the string can be parsed as an `oklab()` color.
+ *
+ * @param s - The string to test.
+ * @returns `true` if the string matches the `oklab()` format.
+ * @public
+ * @example
+ * ```ts
+ * canParseOklab('oklab(0.5 -0.1 0.1)') // true
+ * canParseOklab('red') // false
+ * ```
+ */
+export declare const canParseOklab: (s: string) => boolean;
+/**
+ * Parses an `oklab()` color string into an OKLABA color.
+ *
+ * L may be a percentage (0–100% mapped to 0–1) or a decimal (0–1). The `a`
+ * and `b` channels are decimals that may be negative.
+ *
+ * @param s - The string to parse.
+ * @returns An OKLABA color.
+ * @throws ParsingError if the string is not a valid OKLAB color.
+ * @public
+ * @example
+ * ```ts
+ * parseOklab('oklab(0.5 -0.1 0.1)') // oklaba(0.5, -0.1, 0.1)
+ * parseOklab('oklab(50% -0.1 0.1 / 0.8)') // oklaba(0.5, -0.1, 0.1, 0.8)
+ * ```
+ */
+export declare const parseOklab: (s: string) => OKLABA;
+/**
+ * Returns `true` if the string can be parsed as an `oklch()` color.
+ *
+ * @param s - The string to test.
+ * @returns `true` if the string matches the `oklch()` format.
+ * @public
+ * @example
+ * ```ts
+ * canParseOklch('oklch(0.5 0.15 326)') // true
+ * canParseOklch('red') // false
+ * ```
+ */
+export declare const canParseOklch: (s: string) => boolean;
+/**
+ * Parses an `oklch()` color string into an OKLCHA color.
+ *
+ * L may be a percentage (0–100% mapped to 0–1) or a decimal (0–1). C is a
+ * non-negative decimal and H is an angle in degrees.
+ *
+ * @param s - The string to parse.
+ * @returns An OKLCHA color.
+ * @throws ParsingError if the string is not a valid OKLCH color.
+ * @public
+ * @example
+ * ```ts
+ * parseOklch('oklch(0.5 0.15 326)') // oklcha(0.5, 0.15, 326)
+ * parseOklch('oklch(50% 0.15 326 / 0.8)') // oklcha(0.5, 0.15, 326, 0.8)
+ * ```
+ */
+export declare const parseOklch: (s: string) => OKLCHA;
+/**
+ * Converts an RGB8A color to an OKLABA color.
+ *
+ * @param c - The RGB8A color to convert.
+ * @returns The equivalent OKLABA color.
+ * @public
+ * @example
+ * ```ts
+ * rgb8aToOklaba(rgb8a(255, 0, 0)) // oklaba(~0.628, ~0.225, ~0.126)
+ * ```
+ */
+export declare const rgb8aToOklaba: (c: RGB8A) => OKLABA;
+/**
+ * Converts an OKLABA color to an RGB8A color.
+ *
+ * @param c - The OKLABA color to convert.
+ * @returns The equivalent RGB8A color with channels clamped to 0–255.
+ * @public
+ * @example
+ * ```ts
+ * oklabaToRgb8a(oklaba(0.628, 0.225, 0.126)) // rgb8a(~255, ~0, ~0)
+ * ```
+ */
+export declare const oklabaToRgb8a: (c: OKLABA) => RGB8A;
+/**
+ * Converts an RGB8A color to an OKLCHA color.
+ *
+ * @param c - The RGB8A color to convert.
+ * @returns The equivalent OKLCHA color.
+ * @public
+ * @example
+ * ```ts
+ * rgb8aToOklcha(rgb8a(255, 0, 0)) // oklcha(~0.628, ~0.258, ~29.2)
+ * ```
+ */
+export declare const rgb8aToOklcha: (c: RGB8A) => OKLCHA;
+/**
+ * Converts an OKLCHA color to an RGB8A color.
+ *
+ * @param c - The OKLCHA color to convert.
+ * @returns The equivalent RGB8A color with channels clamped to 0–255.
+ * @public
+ * @example
+ * ```ts
+ * oklchaToRgb8a(oklcha(0.628, 0.258, 29.2)) // rgb8a(~255, ~0, ~0)
+ * ```
+ */
+export declare const oklchaToRgb8a: (c: OKLCHA) => RGB8A;
+/**
+ * Serializes an OKLABA color to a CSS `oklab()` string.
+ *
+ * Produces `oklab(L a b)` when alpha is 1, or `oklab(L a b / alpha)`
+ * otherwise. Values are rounded to 5 decimal places.
+ *
+ * @param c - The OKLABA color to serialize.
+ * @returns A CSS `oklab()` color string.
+ * @public
+ * @example
+ * ```ts
+ * oklabaToOklabString(oklaba(0.5, -0.1, 0.1)) // 'oklab(0.5 -0.1 0.1)'
+ * oklabaToOklabString(oklaba(0.5, -0.1, 0.1, 0.8)) // 'oklab(0.5 -0.1 0.1 / 0.8)'
+ * ```
+ */
+export declare const oklabaToOklabString: (c: OKLABA) => string;
+/**
+ * Serializes an OKLCHA color to a CSS `oklch()` string.
+ *
+ * Produces `oklch(L C H)` when alpha is 1, or `oklch(L C H / alpha)`
+ * otherwise. L and C are rounded to 5 decimal places, H to 2.
+ *
+ * @param c - The OKLCHA color to serialize.
+ * @returns A CSS `oklch()` color string.
+ * @public
+ * @example
+ * ```ts
+ * oklchaToOklchString(oklcha(0.5, 0.15, 326)) // 'oklch(0.5 0.15 326)'
+ * oklchaToOklchString(oklcha(0.5, 0.15, 326, 0.8)) // 'oklch(0.5 0.15 326 / 0.8)'
+ * ```
+ */
+export declare const oklchaToOklchString: (c: OKLCHA) => string;

package/color-oklab.js

@@ -0,0 +1,15 @@
+import "./error.js";
+import "./number.js";
+import { i as l, j as r, P as b, Q as c, S as O, T, a1 as g, a2 as h, ab as e, ac as i } from "./color-SZxckS9U.js";
+export {
+  l as canParseOklab,
+  r as canParseOklch,
+  b as oklabaToOklabString,
+  c as oklabaToRgb8a,
+  O as oklchaToOklchString,
+  T as oklchaToRgb8a,
+  g as parseOklab,
+  h as parseOklch,
+  e as rgb8aToOklaba,
+  i as rgb8aToOklcha
+};

package/color-rgb.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("./error.cjs");require("./number.cjs");const e=require("./color-D7FAmkht.cjs");require("./color-named.cjs");exports.canParseHex=e.canParseHex;exports.canParseNamedColor=e.canParseNamedColor;exports.canParseRgb=e.canParseRgb;exports.parseHex=e.parseHex;exports.parseNamedColor=e.parseNamedColor;exports.parseRgb=e.parseRgb;exports.rgb8aToHexString=e.rgb8aToHexString;exports.rgb8aToRgbString=e.rgb8aToRgbString;

package/color-rgb.d.ts

@@ -0,0 +1,119 @@
+import { RGB8A } from './color';
+/**
+ * Returns `true` if the string can be parsed as a hex color.
+ *
+ * @param s - The string to test.
+ * @returns `true` if the string is a valid hex color.
+ * @public
+ * @example
+ * ```ts
+ * canParseHex('#ff0000') // true
+ * canParseHex('#f00') // true
+ * canParseHex('red') // false
+ * ```
+ */
+export declare const canParseHex: (s: string) => boolean;
+/**
+ * Parses a hex color string into an RGB8A color.
+ *
+ * Supports `#RGB`, `#RGBA`, `#RRGGBB`, and `#RRGGBBAA` formats.
+ *
+ * @param s - The hex string to parse.
+ * @returns An RGB8A color.
+ * @throws ParsingError if the string is not a valid hex color.
+ * @public
+ * @example
+ * ```ts
+ * parseHex('#ff0000') // rgb8a(255, 0, 0)
+ * parseHex('#f00') // rgb8a(255, 0, 0)
+ * parseHex('#ff000080') // rgb8a(255, 0, 0, ~0.502)
+ * ```
+ */
+export declare const parseHex: (s: string) => RGB8A;
+/**
+ * Returns `true` if the string can be parsed as an `rgb()` or `rgba()` color.
+ *
+ * @param s - The string to test.
+ * @returns `true` if the string is a valid RGB functional notation.
+ * @public
+ * @example
+ * ```ts
+ * canParseRgb('rgb(255, 0, 0)') // true
+ * canParseRgb('rgb(255 0 0 / 0.5)') // true
+ * canParseRgb('#ff0000') // false
+ * ```
+ */
+export declare const canParseRgb: (s: string) => boolean;
+/**
+ * Parses an `rgb()` or `rgba()` color string into an RGB8A color.
+ *
+ * Supports both legacy comma-separated and modern space-separated syntax.
+ *
+ * @param s - The string to parse.
+ * @returns An RGB8A color.
+ * @throws ParsingError if the string is not a valid RGB color.
+ * @public
+ * @example
+ * ```ts
+ * parseRgb('rgb(255, 0, 0)') // rgb8a(255, 0, 0)
+ * parseRgb('rgba(255, 0, 0, 0.5)') // rgb8a(255, 0, 0, 0.5)
+ * parseRgb('rgb(255 0 0 / 50%)') // rgb8a(255, 0, 0, 0.5)
+ * ```
+ */
+export declare const parseRgb: (s: string) => RGB8A;
+/**
+ * Returns `true` if the string is a recognized CSS named color.
+ *
+ * @param s - The string to test (case-insensitive).
+ * @returns `true` if the string is a named color.
+ * @public
+ * @example
+ * ```ts
+ * canParseNamedColor('red') // true
+ * canParseNamedColor('Red') // true
+ * canParseNamedColor('notacolor') // false
+ * ```
+ */
+export declare const canParseNamedColor: (s: string) => boolean;
+/**
+ * Parses a CSS named color string into an RGB8A color.
+ *
+ * @param s - The named color string (case-insensitive).
+ * @returns An RGB8A color.
+ * @throws ParsingError if the string is not a recognized named color.
+ * @public
+ * @example
+ * ```ts
+ * parseNamedColor('red') // rgb8a(255, 0, 0)
+ * parseNamedColor('cornflowerblue') // rgb8a(100, 149, 237)
+ * ```
+ */
+export declare const parseNamedColor: (s: string) => RGB8A;
+/**
+ * Serializes an RGB8A color to a hex string.
+ *
+ * Produces `#rrggbb` when alpha is 1, or `#rrggbbaa` otherwise.
+ *
+ * @param c - The RGB8A color to serialize.
+ * @returns A hex color string.
+ * @public
+ * @example
+ * ```ts
+ * rgb8aToHexString(rgb8a(255, 0, 0)) // '#ff0000'
+ * rgb8aToHexString(rgb8a(255, 0, 0, 0.5)) // '#ff000080'
+ * ```
+ */
+export declare const rgb8aToHexString: (c: RGB8A) => string;
+/**
+ * Serializes an RGB8A color to an `rgb()` or `rgba()` CSS string.
+ *
+ * @param c - The RGB8A color to serialize.
+ * @returns A CSS color string.
+ * @public
+ * @example
+ * ```ts
+ * rgb8aToRgbString(rgb8a(255, 0, 0)) // 'rgb(255, 0, 0)'
+ * rgb8aToRgbString(rgb8a(255, 0, 0, 0.5)) // 'rgba(255, 0, 0, 0.5)'
+ * ```
+ */
+export declare const rgb8aToRgbString: (c: RGB8A) => string;

package/color-rgb.js

@@ -0,0 +1,14 @@
+import "./error.js";
+import "./number.js";
+import { a as g, h as p, k as m, W as t, a0 as b, a3 as i, a5 as n, ad as x } from "./color-SZxckS9U.js";
+import "./color-named.js";
+export {
+  g as canParseHex,
+  p as canParseNamedColor,
+  m as canParseRgb,
+  t as parseHex,
+  b as parseNamedColor,
+  i as parseRgb,
+  n as rgb8aToHexString,
+  x as rgb8aToRgbString
+};

package/color-utils.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./number.cjs"),o=require("./random.cjs"),a=require("./color-D7FAmkht.cjs"),c=require("./color-named.cjs"),b=require("./color-distance.cjs"),i=(l,e,t=1)=>{const r=a.convertColor(l,"lab"),n=a.convertColor(e,"lab");return s.nearEqual(r.l,n.l,t)&&s.nearEqual(r.a,n.a,t)&&s.nearEqual(r.b,n.b,t)&&s.nearEqual(r.alpha,n.alpha,.01)},h=(l="rgb8")=>{switch(l){case"rgb":return a.rgba(o.randomFloat(0,1),o.randomFloat(0,1),o.randomFloat(0,1));case"rgb8":return a.rgb8a(Math.round(o.randomFloat(0,255)),Math.round(o.randomFloat(0,255)),Math.round(o.randomFloat(0,255)));case"hsl":return a.hsla(o.randomFloat(0,360),o.randomFloat(0,100),o.randomFloat(0,100));case"hsv":return a.hsva(o.randomFloat(0,360),o.randomFloat(0,100),o.randomFloat(0,100));case"hwb":return a.hwba(o.randomFloat(0,360),o.randomFloat(0,100),o.randomFloat(0,100));case"lab":return a.laba(o.randomFloat(0,100),o.randomFloat(-125,125),o.randomFloat(-125,125));case"lch":return a.lcha(o.randomFloat(0,100),o.randomFloat(0,150),o.randomFloat(0,360));case"oklab":return a.oklaba(o.randomFloat(0,1),o.randomFloat(-.4,.4),o.randomFloat(-.4,.4));case"oklch":return a.oklcha(o.randomFloat(0,1),o.randomFloat(0,.4),o.randomFloat(0,360))}},q=l=>{let e="",t=1/0;for(const r of Object.keys(c.NAMED_COLORS)){const[n,m,u]=c.NAMED_COLORS[r],F=a.rgb8a(n,m,u),d=b.colorDistanceSimple(l,F);d<t&&(t=d,e=r)}return e};exports.closestNamedColor=q;exports.equalColors=i;exports.randomColor=h;