@tempots/std 0.27.0 → 0.28.1

package/color-adjust.d.ts

@@ -0,0 +1,148 @@
+import { Color } from './color';
+/**
+ * Increases the lightness of a color by the given amount.
+ *
+ * Operates in OKLCH space and returns the result in the
+ * same color space as the input.
+ *
+ * @param c - The color to lighten.
+ * @param amount - A value between 0 and 1 indicating how
+ *   much to increase lightness.
+ * @returns The lightened color in the original color space.
+ * @public
+ * @example
+ * ```ts
+ * const light = lighten(rgb8a(100, 50, 50, 1), 0.2)
+ * ```
+ */
+export declare const lighten: (c: Color, amount: number) => Color;
+/**
+ * Decreases the lightness of a color by the given amount.
+ *
+ * Operates in OKLCH space and returns the result in the
+ * same color space as the input.
+ *
+ * @param c - The color to darken.
+ * @param amount - A value between 0 and 1 indicating how
+ *   much to decrease lightness.
+ * @returns The darkened color in the original color space.
+ * @public
+ * @example
+ * ```ts
+ * const dark = darken(rgb8a(200, 150, 150, 1), 0.2)
+ * ```
+ */
+export declare const darken: (c: Color, amount: number) => Color;
+/**
+ * Increases the chroma (saturation) of a color by the
+ * given amount.
+ *
+ * Operates in OKLCH space. The amount is scaled by 0.4 to
+ * map the 0–1 input range to the typical OKLCH chroma
+ * range.
+ *
+ * @param c - The color to saturate.
+ * @param amount - A value between 0 and 1 indicating how
+ *   much to increase chroma.
+ * @returns The saturated color in the original color space.
+ * @public
+ * @example
+ * ```ts
+ * const vivid = saturate(rgb8a(100, 100, 100, 1), 0.5)
+ * ```
+ */
+export declare const saturate: (c: Color, amount: number) => Color;
+/**
+ * Decreases the chroma (saturation) of a color by the
+ * given amount.
+ *
+ * Operates in OKLCH space. The amount is scaled by 0.4 to
+ * map the 0–1 input range to the typical OKLCH chroma
+ * range.
+ *
+ * @param c - The color to desaturate.
+ * @param amount - A value between 0 and 1 indicating how
+ *   much to decrease chroma.
+ * @returns The desaturated color in the original color
+ *   space.
+ * @public
+ * @example
+ * ```ts
+ * const muted = desaturate(rgb8a(255, 0, 0, 1), 0.5)
+ * ```
+ */
+export declare const desaturate: (c: Color, amount: number) => Color;
+/**
+ * Increases the opacity (alpha) of a color by the given
+ * amount.
+ *
+ * No color space conversion is performed — the alpha
+ * channel is adjusted directly.
+ *
+ * @param c - The color to make more opaque.
+ * @param amount - A value between 0 and 1 indicating how
+ *   much to increase alpha.
+ * @returns The color with increased opacity, in the same
+ *   color space.
+ * @public
+ * @example
+ * ```ts
+ * const opaque = opacify(rgb8a(100, 50, 50, 0.5), 0.3)
+ * // alpha is now 0.8
+ * ```
+ */
+export declare const opacify: (c: Color, amount: number) => Color;
+/**
+ * Decreases the opacity (alpha) of a color by the given
+ * amount.
+ *
+ * No color space conversion is performed — the alpha
+ * channel is adjusted directly.
+ *
+ * @param c - The color to make more transparent.
+ * @param amount - A value between 0 and 1 indicating how
+ *   much to decrease alpha.
+ * @returns The color with decreased opacity, in the same
+ *   color space.
+ * @public
+ * @example
+ * ```ts
+ * const faded = transparentize(rgb8a(100, 50, 50, 1), 0.3)
+ * // alpha is now 0.7
+ * ```
+ */
+export declare const transparentize: (c: Color, amount: number) => Color;
+/**
+ * Inverts the RGB channels of a color while preserving
+ * alpha.
+ *
+ * Converts to RGB8 space, inverts each channel
+ * (`255 - value`), and converts back to the original
+ * color space.
+ *
+ * @param c - The color to invert.
+ * @returns The inverted color in the original color space.
+ * @public
+ * @example
+ * ```ts
+ * const inv = invert(rgb8a(255, 0, 0, 1))
+ * // result is cyan: rgb8a(0, 255, 255, 1)
+ * ```
+ */
+export declare const invert: (c: Color) => Color;
+/**
+ * Converts a color to grayscale by removing all chroma.
+ *
+ * Operates in OKLCH space by setting chroma to 0 while
+ * preserving lightness and hue. Returns the result in the
+ * same color space as the input.
+ *
+ * @param c - The color to convert to grayscale.
+ * @returns The grayscale color in the original color space.
+ * @public
+ * @example
+ * ```ts
+ * const gray = grayscale(rgb8a(255, 0, 0, 1))
+ * ```
+ */
+export declare const grayscale: (c: Color) => Color;

package/color-adjust.js

@@ -0,0 +1,47 @@
+import { clamp as e } from "./number.js";
+import { m as s, R as c, a4 as l } from "./color-SZxckS9U.js";
+const i = (a, n) => {
+  const o = a.space, t = s(a, "oklch"), r = c(e(t.l + n, 0, 1), t.c, t.h, t.alpha);
+  return s(r, o);
+}, u = (a, n) => {
+  const o = a.space, t = s(a, "oklch"), r = c(e(t.l - n, 0, 1), t.c, t.h, t.alpha);
+  return s(r, o);
+}, d = (a, n) => {
+  const o = a.space, t = s(a, "oklch"), r = c(
+    t.l,
+    Math.max(0, t.c + n * 0.4),
+    t.h,
+    t.alpha
+  );
+  return s(r, o);
+}, g = (a, n) => {
+  const o = a.space, t = s(a, "oklch"), r = c(
+    t.l,
+    Math.max(0, t.c - n * 0.4),
+    t.h,
+    t.alpha
+  );
+  return s(r, o);
+}, k = (a, n) => ({
+  ...a,
+  alpha: e(a.alpha + n, 0, 1)
+}), m = (a, n) => ({
+  ...a,
+  alpha: e(a.alpha - n, 0, 1)
+}), j = (a) => {
+  const n = a.space, o = s(a, "rgb8"), t = l(255 - o.r, 255 - o.g, 255 - o.b, o.alpha);
+  return s(t, n);
+}, b = (a) => {
+  const n = a.space, o = s(a, "oklch"), t = c(o.l, 0, o.h, o.alpha);
+  return s(t, n);
+};
+export {
+  u as darken,
+  g as desaturate,
+  b as grayscale,
+  j as invert,
+  i as lighten,
+  k as opacify,
+  d as saturate,
+  m as transparentize
+};

package/color-channel.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./number.cjs"),e=require("./color-D7FAmkht.cjs"),t=(a,l)=>a[l],h=a=>{const{space:l,...r}=a;return r},n=a=>{switch(a.space){case"rgb":return[a.r,a.g,a.b,a.alpha];case"rgb8":return[a.r,a.g,a.b,a.alpha];case"hsl":return[a.h,a.s,a.l,a.alpha];case"hsv":return[a.h,a.s,a.v,a.alpha];case"hwb":return[a.h,a.w,a.b,a.alpha];case"lab":return[a.l,a.a,a.b,a.alpha];case"lch":return[a.l,a.c,a.h,a.alpha];case"oklab":return[a.l,a.a,a.b,a.alpha];case"oklch":return[a.l,a.c,a.h,a.alpha]}},o=(a,l)=>{switch(a.space){case"rgb":{const r={...a,...l};return e.rgba(r.r,r.g,r.b,r.alpha)}case"rgb8":{const r={...a,...l};return e.rgb8a(r.r,r.g,r.b,r.alpha)}case"hsl":{const r={...a,...l};return e.hsla(r.h,r.s,r.l,r.alpha)}case"hsv":{const r={...a,...l};return e.hsva(r.h,r.s,r.v,r.alpha)}case"hwb":{const r={...a,...l};return e.hwba(r.h,r.w,r.b,r.alpha)}case"lab":{const r={...a,...l};return e.laba(r.l,r.a,r.b,r.alpha)}case"lch":{const r={...a,...l};return e.lcha(r.l,r.c,r.h,r.alpha)}case"oklab":{const r={...a,...l};return e.oklaba(r.l,r.a,r.b,r.alpha)}case"oklch":{const r={...a,...l};return e.oklcha(r.l,r.c,r.h,r.alpha)}}},p=(a,l)=>({...a,alpha:s.clamp(l,0,1)}),b=a=>a.alpha>=1,u=a=>a.alpha<=0;exports.getChannel=t;exports.getChannels=h;exports.getChannelsAsArray=n;exports.isOpaque=b;exports.isTransparent=u;exports.withAlpha=p;exports.withColor=o;

package/color-channel.d.ts

@@ -0,0 +1,118 @@
+import { Color } from './color';
+/**
+ * Extracts the channel names of a color type, excluding the `space`
+ * discriminant.
+ *
+ * @public
+ */
+export type ChannelOf<C extends Color> = Exclude<keyof C, 'space'>;
+/**
+ * Returns the value of a single channel from a color.
+ *
+ * The `channel` parameter is type-safe — only channels that exist on the
+ * specific color type are accepted.
+ *
+ * @param c - The color to read from.
+ * @param channel - The channel name.
+ * @returns The channel value.
+ * @public
+ * @example
+ * ```ts
+ * getChannel(rgb8a(255, 0, 0), 'r') // 255
+ * getChannel(hsla(120, 50, 75), 'h') // 120
+ * ```
+ */
+export declare const getChannel: <C extends Color>(c: C, channel: ChannelOf<C>) => number;
+/**
+ * Returns all channels of a color as a plain object, excluding the `space`
+ * discriminant.
+ *
+ * @param c - The color to extract channels from.
+ * @returns An object mapping channel names to values.
+ * @public
+ * @example
+ * ```ts
+ * getChannels(rgb8a(255, 0, 0))
+ * // { r: 255, g: 0, b: 0, alpha: 1 }
+ * ```
+ */
+export declare const getChannels: <C extends Color>(c: C) => Omit<C, "space">;
+/**
+ * Returns all channel values of a color as a number array.
+ *
+ * The order is consistent per color space: color-specific channels first,
+ * then alpha. For example, RGB8 returns `[r, g, b, alpha]`, HSL returns
+ * `[h, s, l, alpha]`.
+ *
+ * @param c - The color to extract values from.
+ * @returns An array of channel values.
+ * @public
+ * @example
+ * ```ts
+ * getChannelsAsArray(rgb8a(255, 0, 0)) // [255, 0, 0, 1]
+ * getChannelsAsArray(hsla(120, 50, 75, 0.5)) // [120, 50, 75, 0.5]
+ * ```
+ */
+export declare const getChannelsAsArray: (c: Color) => number[];
+/**
+ * Creates a new color with one or more channels replaced, applying
+ * clamping and hue wrapping via the color's constructor.
+ *
+ * Returns the same color type as the input.
+ *
+ * @param c - The source color.
+ * @param changes - An object with the channels to change.
+ * @returns A new color with the changes applied.
+ * @public
+ * @example
+ * ```ts
+ * withColor(rgb8a(255, 0, 0), { g: 255 })
+ * // rgb8a(255, 255, 0)
+ *
+ * withColor(hsla(0, 100, 50), { h: 120 })
+ * // hsla(120, 100, 50)
+ * ```
+ */
+export declare const withColor: <C extends Color>(c: C, changes: Partial<Omit<C, "space">>) => C;
+/**
+ * Creates a new color with the alpha channel set to the given value.
+ *
+ * This is a shortcut for `withColor(c, { alpha })`.
+ *
+ * @param c - The source color.
+ * @param alpha - The new alpha value (0–1).
+ * @returns A new color with the updated alpha.
+ * @public
+ * @example
+ * ```ts
+ * withAlpha(rgb8a(255, 0, 0), 0.5) // rgb8a(255, 0, 0, 0.5)
+ * withAlpha(hsla(120, 100, 50), 0) // hsla(120, 100, 50, 0)
+ * ```
+ */
+export declare const withAlpha: <C extends Color>(c: C, alpha: number) => C;
+/**
+ * Returns `true` if the color is fully opaque (alpha >= 1).
+ *
+ * @param c - The color to check.
+ * @returns `true` if opaque.
+ * @public
+ * @example
+ * ```ts
+ * isOpaque(rgb8a(255, 0, 0)) // true
+ * isOpaque(rgb8a(255, 0, 0, 0.5)) // false
+ * ```
+ */
+export declare const isOpaque: (c: Color) => boolean;
+/**
+ * Returns `true` if the color is fully transparent (alpha <= 0).
+ *
+ * @param c - The color to check.
+ * @returns `true` if transparent.
+ * @public
+ * @example
+ * ```ts
+ * isTransparent(rgb8a(255, 0, 0, 0)) // true
+ * isTransparent(rgb8a(255, 0, 0, 0.5)) // false
+ * ```
+ */
+export declare const isTransparent: (c: Color) => boolean;

package/color-channel.js

@@ -0,0 +1,75 @@
+import { clamp as l } from "./number.js";
+import { R as h, O as t, L as e, I as n, w as o, s as p, o as b, a4 as u, af as m } from "./color-SZxckS9U.js";
+const k = (a, r) => a[r], g = (a) => {
+  const { space: r, ...s } = a;
+  return s;
+}, v = (a) => {
+  switch (a.space) {
+    case "rgb":
+      return [a.r, a.g, a.b, a.alpha];
+    case "rgb8":
+      return [a.r, a.g, a.b, a.alpha];
+    case "hsl":
+      return [a.h, a.s, a.l, a.alpha];
+    case "hsv":
+      return [a.h, a.s, a.v, a.alpha];
+    case "hwb":
+      return [a.h, a.w, a.b, a.alpha];
+    case "lab":
+      return [a.l, a.a, a.b, a.alpha];
+    case "lch":
+      return [a.l, a.c, a.h, a.alpha];
+    case "oklab":
+      return [a.l, a.a, a.b, a.alpha];
+    case "oklch":
+      return [a.l, a.c, a.h, a.alpha];
+  }
+}, C = (a, r) => {
+  switch (a.space) {
+    case "rgb": {
+      const s = { ...a, ...r };
+      return m(s.r, s.g, s.b, s.alpha);
+    }
+    case "rgb8": {
+      const s = { ...a, ...r };
+      return u(s.r, s.g, s.b, s.alpha);
+    }
+    case "hsl": {
+      const s = { ...a, ...r };
+      return b(s.h, s.s, s.l, s.alpha);
+    }
+    case "hsv": {
+      const s = { ...a, ...r };
+      return p(s.h, s.s, s.v, s.alpha);
+    }
+    case "hwb": {
+      const s = { ...a, ...r };
+      return o(s.h, s.w, s.b, s.alpha);
+    }
+    case "lab": {
+      const s = { ...a, ...r };
+      return n(s.l, s.a, s.b, s.alpha);
+    }
+    case "lch": {
+      const s = { ...a, ...r };
+      return e(s.l, s.c, s.h, s.alpha);
+    }
+    case "oklab": {
+      const s = { ...a, ...r };
+      return t(s.l, s.a, s.b, s.alpha);
+    }
+    case "oklch": {
+      const s = { ...a, ...r };
+      return h(s.l, s.c, s.h, s.alpha);
+    }
+  }
+}, f = (a, r) => ({ ...a, alpha: l(r, 0, 1) }), A = (a) => a.alpha >= 1, O = (a) => a.alpha <= 0;
+export {
+  k as getChannel,
+  g as getChannels,
+  v as getChannelsAsArray,
+  A as isOpaque,
+  O as isTransparent,
+  f as withAlpha,
+  C as withColor
+};

package/color-contrast.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./color-D7FAmkht.cjs"),a=t=>t<=.04045?t/12.92:Math.pow((t+.055)/1.055,2.4),l=t=>{const o=e.convertColor(t,"rgb8"),n=a(o.r/255),r=a(o.g/255),s=a(o.b/255);return .2126*n+.7152*r+.0722*s},c=(t,o)=>{const n=l(t),r=l(o),s=Math.max(n,r),g=Math.min(n,r);return(s+.05)/(g+.05)},i=(t,o=e.rgb8a(0,0,0),n=e.rgb8a(255,255,255))=>{const r=c(t,o),s=c(t,n);return r>=s?o:n},b={AA:4.5,AAA:7,"AA-large":3,"AAA-large":4.5},A=(t,o,n)=>c(t,o)>=b[n];exports.contrastColor=i;exports.contrastRatio=c;exports.luminance=l;exports.meetsContrast=A;

package/color-contrast.d.ts

@@ -0,0 +1,96 @@
+import { Color } from './color';
+/**
+ * WCAG contrast level thresholds.
+ *
+ * - `'AA'` — 4.5:1 for normal text
+ * - `'AAA'` — 7:1 for normal text
+ * - `'AA-large'` — 3:1 for large text
+ * - `'AAA-large'` — 4.5:1 for large text
+ *
+ * @public
+ */
+export type ContrastLevel = 'AA' | 'AAA' | 'AA-large' | 'AAA-large';
+/**
+ * Computes the WCAG relative luminance of a color.
+ *
+ * Converts the color to sRGB, linearizes each channel,
+ * and returns the weighted sum per the WCAG 2.x formula.
+ *
+ * @param c - The color to measure
+ * @returns A number between 0 (darkest) and 1 (lightest)
+ *
+ * @example
+ * ```ts
+ * luminance(rgb8a(255, 255, 255)) // 1
+ * luminance(rgb8a(0, 0, 0))       // 0
+ * ```
+ *
+ * @public
+ */
+export declare const luminance: (c: Color) => number;
+/**
+ * Computes the WCAG contrast ratio between two colors.
+ *
+ * The ratio ranges from 1:1 (identical) to 21:1
+ * (black vs white).
+ *
+ * @param a - The first color
+ * @param b - The second color
+ * @returns A number between 1 and 21
+ *
+ * @example
+ * ```ts
+ * contrastRatio(
+ *   rgb8a(0, 0, 0),
+ *   rgb8a(255, 255, 255)
+ * ) // 21
+ * ```
+ *
+ * @public
+ */
+export declare const contrastRatio: (a: Color, b: Color) => number;
+/**
+ * Picks whichever of two candidates has better contrast
+ * against a reference color.
+ *
+ * Useful for choosing a readable foreground color for
+ * a given background.
+ *
+ * @param c - The reference color (e.g. a background)
+ * @param dark - The dark candidate (defaults to black)
+ * @param light - The light candidate (defaults to white)
+ * @returns The candidate with the higher contrast ratio
+ *
+ * @example
+ * ```ts
+ * // Returns white for a dark background
+ * contrastColor(rgb8a(30, 30, 30))
+ *
+ * // Returns black for a light background
+ * contrastColor(rgb8a(220, 220, 220))
+ * ```
+ *
+ * @public
+ */
+export declare const contrastColor: (c: Color, dark?: Color, light?: Color) => Color;
+/**
+ * Checks whether two colors meet a WCAG contrast level.
+ *
+ * @param a - The first color
+ * @param b - The second color
+ * @param level - The WCAG level to test against
+ * @returns `true` if the contrast ratio meets or exceeds
+ *   the threshold for the given level
+ *
+ * @example
+ * ```ts
+ * meetsContrast(
+ *   rgb8a(0, 0, 0),
+ *   rgb8a(255, 255, 255),
+ *   'AAA'
+ * ) // true
+ * ```
+ *
+ * @public
+ */
+export declare const meetsContrast: (a: Color, b: Color, level: ContrastLevel) => boolean;

package/color-contrast.js

@@ -0,0 +1,22 @@
+import { a4 as e, m as g } from "./color-SZxckS9U.js";
+const a = (t) => t <= 0.04045 ? t / 12.92 : Math.pow((t + 0.055) / 1.055, 2.4), l = (t) => {
+  const o = g(t, "rgb8"), n = a(o.r / 255), r = a(o.g / 255), s = a(o.b / 255);
+  return 0.2126 * n + 0.7152 * r + 0.0722 * s;
+}, c = (t, o) => {
+  const n = l(t), r = l(o), s = Math.max(n, r), A = Math.min(n, r);
+  return (s + 0.05) / (A + 0.05);
+}, m = (t, o = e(0, 0, 0), n = e(255, 255, 255)) => {
+  const r = c(t, o), s = c(t, n);
+  return r >= s ? o : n;
+}, b = {
+  AA: 4.5,
+  AAA: 7,
+  "AA-large": 3,
+  "AAA-large": 4.5
+}, h = (t, o, n) => c(t, o) >= b[n];
+export {
+  m as contrastColor,
+  c as contrastRatio,
+  l as luminance,
+  h as meetsContrast
+};

package/color-distance.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("./color-D7FAmkht.cjs"),r=l=>l*Math.PI/180,F=(l,q)=>{const n=d.convertColor(l,"lab"),c=d.convertColor(q,"lab"),h=n.l-c.l,e=n.a-c.a,a=n.b-c.b;return Math.sqrt(h*h+e*e+a*a)},J=(l,q)=>{const n=d.convertColor(l,"lab"),c=d.convertColor(q,"lab"),h=n.l,e=n.a,a=n.b,v=c.l,m=c.a,M=c.b,T=Math.sqrt(e*e+a*a),H=Math.sqrt(m*m+M*M),I=(T+H)/2,g=Math.pow(I,7),w=.5*(1-Math.sqrt(g/(g+Math.pow(25,7)))),f=e*(1+w),L=m*(1+w),i=Math.sqrt(f*f+a*a),p=Math.sqrt(L*L+M*M);let t=Math.atan2(a,f)*180/Math.PI;t<0&&(t+=360);let o=Math.atan2(M,L)*180/Math.PI;o<0&&(o+=360);const R=v-h,y=p-i;let b;i*p===0?b=0:Math.abs(o-t)<=180?b=o-t:o-t>180?b=o-t-360:b=o-t+360;const j=2*Math.sqrt(i*p)*Math.sin(r(b/2)),x=(h+v)/2,_=(i+p)/2;let s;i*p===0?s=t+o:Math.abs(t-o)<=180?s=(t+o)/2:t+o<360?s=(t+o+360)/2:s=(t+o-360)/2;const G=1-.17*Math.cos(r(s-30))+.24*Math.cos(r(2*s))+.32*Math.cos(r(3*s+6))-.2*Math.cos(r(4*s-63)),C=x-50,O=1+.015*C*C/Math.sqrt(20+C*C),k=1+.045*_,z=1+.015*_*G,A=30*Math.exp(-((s-275)/25*((s-275)/25))),D=Math.pow(_,7),B=2*Math.sqrt(D/(D+Math.pow(25,7))),E=-Math.sin(r(2*A))*B,P=R/O,S=y/k,u=j/z;return Math.sqrt(P*P+S*S+u*u+E*S*u)};exports.colorDistance=J;exports.colorDistanceSimple=F;

package/color-distance.d.ts

@@ -0,0 +1,41 @@
+import { Color } from './color';
+/**
+ * Computes the CIE76 color distance (Euclidean distance in
+ * CIELAB space) between two colors.
+ *
+ * @param a - The first color.
+ * @param b - The second color.
+ * @returns The Euclidean distance in LAB space.
+ * @public
+ * @example
+ * ```ts
+ * import { rgb8a } from './color'
+ * colorDistanceSimple(
+ *   rgb8a(255, 0, 0),
+ *   rgb8a(0, 255, 0)
+ * ) // ~170.56
+ * ```
+ */
+export declare const colorDistanceSimple: (a: Color, b: Color) => number;
+/**
+ * Computes the CIEDE2000 color distance between two colors.
+ *
+ * This is the most perceptually uniform color difference metric
+ * standardized by the CIE. It accounts for lightness, chroma,
+ * and hue weighting as well as interactive effects between
+ * chroma and hue differences.
+ *
+ * @param a - The first color.
+ * @param b - The second color.
+ * @returns The CIEDE2000 deltaE value.
+ * @public
+ * @example
+ * ```ts
+ * import { rgb8a } from './color'
+ * colorDistance(
+ *   rgb8a(255, 0, 0),
+ *   rgb8a(0, 255, 0)
+ * ) // ~86.61
+ * ```
+ */
+export declare const colorDistance: (a: Color, b: Color) => number;

package/color-distance.js

@@ -0,0 +1,25 @@
+import { m } from "./color-SZxckS9U.js";
+const h = (M) => M * Math.PI / 180, K = (M, d) => {
+  const n = m(M, "lab"), c = m(d, "lab"), l = n.l - c.l, e = n.a - c.a, o = n.b - c.b;
+  return Math.sqrt(l * l + e * e + o * o);
+}, N = (M, d) => {
+  const n = m(M, "lab"), c = m(d, "lab"), l = n.l, e = n.a, o = n.b, H = c.l, q = c.a, r = c.b, x = Math.sqrt(e * e + o * o), D = Math.sqrt(q * q + r * r), R = (x + D) / 2, I = Math.pow(R, 7), P = 0.5 * (1 - Math.sqrt(I / (I + Math.pow(25, 7)))), f = e * (1 + P), L = q * (1 + P), p = Math.sqrt(f * f + o * o), b = Math.sqrt(L * L + r * r);
+  let t = Math.atan2(o, f) * 180 / Math.PI;
+  t < 0 && (t += 360);
+  let s = Math.atan2(r, L) * 180 / Math.PI;
+  s < 0 && (s += 360);
+  const g = H - l, v = b - p;
+  let i;
+  p * b === 0 ? i = 0 : Math.abs(s - t) <= 180 ? i = s - t : s - t > 180 ? i = s - t - 360 : i = s - t + 360;
+  const G = 2 * Math.sqrt(p * b) * Math.sin(h(i / 2)), j = (l + H) / 2, _ = (p + b) / 2;
+  let a;
+  p * b === 0 ? a = t + s : Math.abs(t - s) <= 180 ? a = (t + s) / 2 : t + s < 360 ? a = (t + s + 360) / 2 : a = (t + s - 360) / 2;
+  const k = 1 - 0.17 * Math.cos(h(a - 30)) + 0.24 * Math.cos(h(2 * a)) + 0.32 * Math.cos(h(3 * a + 6)) - 0.2 * Math.cos(h(4 * a - 63)), C = j - 50, y = 1 + 0.015 * C * C / Math.sqrt(20 + C * C), z = 1 + 0.045 * _, A = 1 + 0.015 * _ * k, B = 30 * Math.exp(-((a - 275) / 25 * ((a - 275) / 25))), T = Math.pow(_, 7), E = 2 * Math.sqrt(T / (T + Math.pow(25, 7))), F = -Math.sin(h(2 * B)) * E, u = g / y, w = v / z, S = G / A;
+  return Math.sqrt(
+    u * u + w * w + S * S + F * w * S
+  );
+};
+export {
+  N as colorDistance,
+  K as colorDistanceSimple
+};

package/color-gamut.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("./color-D7FAmkht.cjs"),e=o=>o<=.0031308?o*12.92:1.055*Math.pow(o,1/2.4)-.055,i=(o,t,n)=>[3.2404542*o-1.5371385*t-.4985314*n,-.969266*o+1.8760108*t+.041556*n,.0556434*o-.2040259*t+1.0572252*n],k=.95047,d=1,f=1.08883,T=6/29,M=3*T**2,p=(o,t,n)=>{const r=c=>c>T?c**3:M*(c-.13793103448275862),l=(o+16)/116,s=t/500+l,a=l-n/200;return[k*r(s),d*r(l),f*r(a)]},m=(o,t,n)=>{const r=o+.3963377774*t+.2158037573*n,l=o-.1055613458*t-.0638541728*n,s=o-.0894841775*t-1.291485548*n,a=r*r*r,c=l*l*l,h=s*s*s;return[4.0767416621*a-3.3077115913*c+.2309699292*h,-1.2684380046*a+2.6097574011*c-.3413193965*h,-.0041960863*a-.7034186147*c+1.707614701*h]},_=(o,t,n)=>{const r=n*Math.PI/180;return[o,t*Math.cos(r),t*Math.sin(r)]},G=(o,t,n)=>{const r=n*Math.PI/180;return[o,t*Math.cos(r),t*Math.sin(r)]},S=o=>{switch(o.space){case"rgb":return[o.r,o.g,o.b,o.alpha];case"rgb8":return[o.r/255,o.g/255,o.b/255,o.alpha];case"oklab":{const[t,n,r]=m(o.l,o.a,o.b);return[e(t),e(n),e(r),o.alpha]}case"oklch":{const[t,n,r]=_(o.l,o.c,o.h),[l,s,a]=m(t,n,r);return[e(l),e(s),e(a),o.alpha]}case"lab":{const[t,n,r]=p(o.l,o.a,o.b),[l,s,a]=i(t,n,r);return[e(l),e(s),e(a),o.alpha]}case"lch":{const[t,n,r]=G(o.l,o.c,o.h),[l,s,a]=p(t,n,r),[c,h,g]=i(l,s,a);return[e(c),e(h),e(g),o.alpha]}default:{const t=b.convertColor(o,"rgb8");return[t.r/255,t.g/255,t.b/255,t.alpha]}}},u=(o,t=.002)=>{const[n,r,l]=S(o);return n>=-t&&n<=1+t&&r>=-t&&r<=1+t&&l>=-t&&l<=1+t},v=o=>{if(u(o))return o;const t=o.space,n=b.convertColor(o,"rgb8"),r=b.rgb8a(n.r,n.g,n.b,n.alpha);return b.convertColor(r,t)},y=o=>{if(u(o))return o;const t=o.space,n=b.convertColor(o,"oklch");let r=0,l=n.c;const s=1e-4;for(let c=0;c<50&&l-r>s;c++){const h=(r+l)/2,g=b.oklcha(n.l,h,n.h,n.alpha);u(g)?r=h:l=h}const a=b.oklcha(n.l,r,n.h,n.alpha);return b.convertColor(a,t)};exports.clampToGamut=v;exports.clampToGamutOklch=y;exports.isInGamut=u;

package/color-gamut.d.ts

@@ -0,0 +1,59 @@
+import { Color } from './color';
+/**
+ * Tests whether a color is within the sRGB gamut.
+ *
+ * Colors in HSL, HSV, HWB, RGB, and RGB8 spaces are always in gamut by
+ * definition. Colors in LAB, LCH, OKLAB, and OKLCH may fall outside sRGB
+ * if their chroma is too high.
+ *
+ * @param c - The color to test.
+ * @param tolerance - How far outside 0–1 is still considered in-gamut.
+ *   Defaults to 0.002 to account for floating-point imprecision.
+ * @returns `true` if the color is representable in sRGB.
+ * @public
+ * @example
+ * ```ts
+ * isInGamut(rgb8a(255, 0, 0)) // true
+ * isInGamut(oklcha(0.5, 0.4, 150)) // likely false (very high chroma)
+ * ```
+ */
+export declare const isInGamut: (c: Color, tolerance?: number) => boolean;
+/**
+ * Clamps a color to the sRGB gamut by clamping RGB channel values.
+ *
+ * If the color is already in gamut, it is returned unchanged. Otherwise,
+ * it is converted to RGB8 (which clamps channels to 0–255) and converted
+ * back to the original color space.
+ *
+ * For perceptually better results on wide-gamut colors, use
+ * {@link clampToGamutOklch} which preserves lightness and hue.
+ *
+ * @param c - The color to clamp.
+ * @returns A color within the sRGB gamut in the original color space.
+ * @public
+ * @example
+ * ```ts
+ * clampToGamut(rgb8a(255, 0, 0)) // unchanged
+ * ```
+ */
+export declare const clampToGamut: (c: Color) => Color;
+/**
+ * Clamps a color to the sRGB gamut by reducing chroma in OKLCH space
+ * while preserving lightness and hue.
+ *
+ * This produces more perceptually pleasing results than simple RGB
+ * clamping, as it finds the most saturated version of the color that
+ * still fits within sRGB.
+ *
+ * Uses binary search to find the maximum in-gamut chroma.
+ *
+ * @param c - The color to clamp.
+ * @returns A color within the sRGB gamut in the original color space.
+ * @public
+ * @example
+ * ```ts
+ * clampToGamutOklch(oklcha(0.5, 0.4, 150))
+ * // Same lightness and hue, reduced chroma to fit sRGB
+ * ```
+ */
+export declare const clampToGamutOklch: (c: Color) => Color;