color-map 2.2.0 → 2.3.0

package/esm/color/calc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calc.js","names":[],"sources":["../../src/color/calc.ts"],"sourcesContent":["import { fail, UNITS } from './parse.js'\n\nconst TOKEN = /\\s*(?:(\\d*\\.?\\d+(?:e[+-]?\\d+)?)([a-z%]*)|([a-z][a-z0-9-]*)|([-+*/(),]))/y\n\n/**\n * Evaluates the `calc()` subset relative colors accept: numbers (angles become\n * degrees), `+ - * /`, parentheses, `calc`, `min`, `max`, `clamp`, the\n * constants `pi` and `e`, and the channel keywords in `vars`.\n */\nexport function evaluate(text: string, vars: Record<string, number>): number {\n\tconst tokens: string[] = []\n\tTOKEN.lastIndex = 0\n\tlet end = 0\n\tfor (let m = TOKEN.exec(text); m; m = TOKEN.exec(text)) {\n\t\tend = TOKEN.lastIndex\n\t\tif (m[1] === undefined) tokens.push(m[3] ?? m[4])\n\t\telse {\n\t\t\tconst unit = UNITS[m[2]]\n\t\t\tif (unit === undefined) return fail(text, 'units other than angles are not supported in calc()', m[1] + m[2])\n\t\t\ttokens.push(String(Number(m[1]) * unit))\n\t\t}\n\t}\n\tif (end !== text.trimEnd().length) return fail(text, 'invalid calc() expression')\n\tlet pos = 0\n\tconst next = (): string => tokens[pos++]\n\tconst eat = (t: string): boolean => (tokens[pos] === t ? ++pos > 0 : false)\n\tconst need = (t: string): void => {\n\t\tif (!eat(t)) fail(text, `expected \"${t}\" in calc()`, tokens[pos])\n\t}\n\tfunction sum(): number {\n\t\tlet v = product()\n\t\tfor (;;) {\n\t\t\tif (eat('+')) v += product()\n\t\t\telse if (eat('-')) v -= product()\n\t\t\telse return v\n\t\t}\n\t}\n\tfunction product(): number {\n\t\tlet v = unary()\n\t\tfor (;;) {\n\t\t\tif (eat('*')) v *= unary()\n\t\t\telse if (eat('/')) v /= unary()\n\t\t\telse return v\n\t\t}\n\t}\n\tfunction unary(): number {\n\t\tif (eat('-')) return -unary()\n\t\tif (eat('+')) return unary()\n\t\treturn atom()\n\t}\n\tfunction args(): number[] {\n\t\tconst list = [sum()]\n\t\twhile (eat(',')) list.push(sum())\n\t\tneed(')')\n\t\treturn list\n\t}\n\tfunction atom(): number {\n\t\tconst t = next()\n\t\tif (t === undefined) return fail(text, 'unfinished calc() expression')\n\t\tif (/^[\\d.]/.test(t)) return Number(t)\n\t\tif (t === '(') {\n\t\t\tconst v = sum()\n\t\t\tneed(')')\n\t\t\treturn v\n\t\t}\n\t\tif (!/^[a-z]/.test(t)) return fail(text, 'unexpected token', t)\n\t\tif (eat('(')) {\n\t\t\tconst list = args()\n\t\t\tif (t === 'calc' && list.length === 1) return list[0]\n\t\t\tif (t === 'min') return Math.min(...list)\n\t\t\tif (t === 'max') return Math.max(...list)\n\t\t\tif (t === 'clamp' && list.length === 3) return Math.min(list[2], Math.max(list[0], list[1]))\n\t\t\treturn fail(text, 'unknown function', t)\n\t\t}\n\t\tif (t === 'pi') return Math.PI\n\t\tif (t === 'e') return Math.E\n\t\tconst v = vars[t]\n\t\tif (typeof v === 'number') return v\n\t\treturn fail(text, 'unknown keyword', t)\n\t}\n\tconst value = sum()\n\tif (pos < tokens.length) return fail(text, 'unexpected token', tokens[pos])\n\treturn value\n}\n"],"mappings":";;AAEA,MAAM,QAAQ;;;;;;AAOd,SAAgB,SAAS,MAAc,MAAsC;CAC5E,MAAM,SAAmB,CAAC;CAC1B,MAAM,YAAY;CAClB,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,GAAG,GAAG,IAAI,MAAM,KAAK,IAAI,GAAG;EACvD,MAAM,MAAM;EACZ,IAAI,EAAE,OAAO,KAAA,GAAW,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE;OAC3C;GACJ,MAAM,OAAO,MAAM,EAAE;GACrB,IAAI,SAAS,KAAA,GAAW,OAAO,KAAK,MAAM,uDAAuD,EAAE,KAAK,EAAE,EAAE;GAC5G,OAAO,KAAK,OAAO,OAAO,EAAE,EAAE,IAAI,IAAI,CAAC;EACxC;CACD;CACA,IAAI,QAAQ,KAAK,QAAQ,CAAC,CAAC,QAAQ,OAAO,KAAK,MAAM,2BAA2B;CAChF,IAAI,MAAM;CACV,MAAM,aAAqB,OAAO;CAClC,MAAM,OAAO,MAAwB,OAAO,SAAS,IAAI,EAAE,MAAM,IAAI;CACrE,MAAM,QAAQ,MAAoB;EACjC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,MAAM,aAAa,EAAE,cAAc,OAAO,IAAI;CACjE;CACA,SAAS,MAAc;EACtB,IAAI,IAAI,QAAQ;EAChB,SACC,IAAI,IAAI,GAAG,GAAG,KAAK,QAAQ;OACtB,IAAI,IAAI,GAAG,GAAG,KAAK,QAAQ;OAC3B,OAAO;CAEd;CACA,SAAS,UAAkB;EAC1B,IAAI,IAAI,MAAM;EACd,SACC,IAAI,IAAI,GAAG,GAAG,KAAK,MAAM;OACpB,IAAI,IAAI,GAAG,GAAG,KAAK,MAAM;OACzB,OAAO;CAEd;CACA,SAAS,QAAgB;EACxB,IAAI,IAAI,GAAG,GAAG,OAAO,CAAC,MAAM;EAC5B,IAAI,IAAI,GAAG,GAAG,OAAO,MAAM;EAC3B,OAAO,KAAK;CACb;CACA,SAAS,OAAiB;EACzB,MAAM,OAAO,CAAC,IAAI,CAAC;EACnB,OAAO,IAAI,GAAG,GAAG,KAAK,KAAK,IAAI,CAAC;EAChC,KAAK,GAAG;EACR,OAAO;CACR;CACA,SAAS,OAAe;EACvB,MAAM,IAAI,KAAK;EACf,IAAI,MAAM,KAAA,GAAW,OAAO,KAAK,MAAM,8BAA8B;EACrE,IAAI,SAAS,KAAK,CAAC,GAAG,OAAO,OAAO,CAAC;EACrC,IAAI,MAAM,KAAK;GACd,MAAM,IAAI,IAAI;GACd,KAAK,GAAG;GACR,OAAO;EACR;EACA,IAAI,CAAC,SAAS,KAAK,CAAC,GAAG,OAAO,KAAK,MAAM,oBAAoB,CAAC;EAC9D,IAAI,IAAI,GAAG,GAAG;GACb,MAAM,OAAO,KAAK;GAClB,IAAI,MAAM,UAAU,KAAK,WAAW,GAAG,OAAO,KAAK;GACnD,IAAI,MAAM,OAAO,OAAO,KAAK,IAAI,GAAG,IAAI;GACxC,IAAI,MAAM,OAAO,OAAO,KAAK,IAAI,GAAG,IAAI;GACxC,IAAI,MAAM,WAAW,KAAK,WAAW,GAAG,OAAO,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;GAC3F,OAAO,KAAK,MAAM,oBAAoB,CAAC;EACxC;EACA,IAAI,MAAM,MAAM,OAAO,KAAK;EAC5B,IAAI,MAAM,KAAK,OAAO,KAAK;EAC3B,MAAM,IAAI,KAAK;EACf,IAAI,OAAO,MAAM,UAAU,OAAO;EAClC,OAAO,KAAK,MAAM,mBAAmB,CAAC;CACvC;CACA,MAAM,QAAQ,IAAI;CAClB,IAAI,MAAM,OAAO,QAAQ,OAAO,KAAK,MAAM,oBAAoB,OAAO,IAAI;CAC1E,OAAO;AACR"}

package/esm/color/compare.d.ts

@@ -0,0 +1,20 @@
+import { Color, Space } from "./types.js";
+/** Euclidean distance in OKLab, the ΔEOK of CSS Color 4 gamut mapping. */
+export declare function deltaEOk(a: Color, b: Color): number;
+/**
+ * Builds {@link deltaEOk} over the spaces given, plus `oklab`, so a bundle
+ * contains only those. A color in a space not given throws, naming that space.
+ */
+export declare function createDeltaEOk(...spaces: Space[]): (a: Color, b: Color) => number;
+/**
+ * True when both colors are the same within `epsilon` per component. Colors in
+ * different spaces are compared in the first one's space. `none` equals only
+ * `none`, and a missing alpha equals 1.
+ */
+export declare function equals(a: Color, b: Color, epsilon?: number): boolean;
+/**
+ * Builds {@link equals} over the spaces given, so a bundle contains only those.
+ * It needs no space of its own: give the spaces of both colors.
+ */
+export declare function createEquals(...spaces: Space[]): (a: Color, b: Color, epsilon?: number) => boolean;
+//# sourceMappingURL=compare.d.ts.map

package/esm/color/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","names":[],"sources":["../../src/color/compare.ts"],"mappings":";;wBAMgB,SAAS,GAAG,OAAO,GAAG;;;;;wBAetB,kBAAkB,QAAQ,WAAW,GAAG,OAAO,GAAG;;;;;;wBAalD,OAAO,GAAG,OAAO,GAAG,OAAO;;;;;wBAe3B,gBAAgB,QAAQ,WAAW,GAAG,OAAO,GAAG,OAAO"}

package/esm/color/compare.js

@@ -0,0 +1,46 @@
+import { componentsOver, convertWith } from "./convert.js";
+import { oklab } from "./oklab.js";
+import { componentsIn } from "./spaces.js";
+// src/color/compare.ts
+/** Euclidean distance in OKLab, the ΔEOK of CSS Color 4 gamut mapping. */
+function deltaEOk(a, b) {
+	return deltaEOkWith(componentsIn, a, b);
+}
+/** {@link deltaEOk} over the spaces `componentsIn` knows, which must include `oklab`. */
+function deltaEOkWith(componentsIn, a, b) {
+	const [l1, a1, b1] = componentsIn(a, "oklab");
+	const [l2, a2, b2] = componentsIn(b, "oklab");
+	return Math.hypot(l1 - l2, a1 - a2, b1 - b2);
+}
+/**
+* Builds {@link deltaEOk} over the spaces given, plus `oklab`, so a bundle
+* contains only those. A color in a space not given throws, naming that space.
+*/
+function createDeltaEOk(...spaces) {
+	const over = componentsOver([oklab, ...spaces]);
+	return (a, b) => deltaEOkWith(over, a, b);
+}
+const same = (x, y, epsilon) => x === y || x != null && y != null && Math.abs(x - y) <= epsilon;
+/**
+* True when both colors are the same within `epsilon` per component. Colors in
+* different spaces are compared in the first one's space. `none` equals only
+* `none`, and a missing alpha equals 1.
+*/
+function equals(a, b, epsilon = 1e-6) {
+	return equalsWith(componentsIn, a, b, epsilon);
+}
+function equalsWith(componentsIn, a, b, epsilon) {
+	const other = convertWith(componentsIn, b, a.colorSpace);
+	return same(a.alpha ?? 1, other.alpha ?? 1, epsilon) && a.components.every((c, i) => same(c, other.components[i], epsilon));
+}
+/**
+* Builds {@link equals} over the spaces given, so a bundle contains only those.
+* It needs no space of its own: give the spaces of both colors.
+*/
+function createEquals(...spaces) {
+	const over = componentsOver(spaces);
+	return (a, b, epsilon = 1e-6) => equalsWith(over, a, b, epsilon);
+}
+export { createDeltaEOk, createEquals, deltaEOk, deltaEOkWith, equals };
+
+//# sourceMappingURL=compare.js.map

package/esm/color/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","names":[],"sources":["../../src/color/compare.ts"],"sourcesContent":["import { type ComponentsIn, componentsOver, convertWith } from './convert.js'\nimport { oklab } from './oklab.js'\nimport { componentsIn } from './spaces.js'\nimport type { Color, Space } from './types.js'\n\n/** Euclidean distance in OKLab, the ΔEOK of CSS Color 4 gamut mapping. */\nexport function deltaEOk(a: Color, b: Color): number {\n\treturn deltaEOkWith(componentsIn, a, b)\n}\n\n/** {@link deltaEOk} over the spaces `componentsIn` knows, which must include `oklab`. */\nexport function deltaEOkWith(componentsIn: ComponentsIn, a: Color, b: Color): number {\n\tconst [l1, a1, b1] = componentsIn(a, 'oklab') as number[]\n\tconst [l2, a2, b2] = componentsIn(b, 'oklab') as number[]\n\treturn Math.hypot(l1 - l2, a1 - a2, b1 - b2)\n}\n\n/**\n * Builds {@link deltaEOk} over the spaces given, plus `oklab`, so a bundle\n * contains only those. A color in a space not given throws, naming that space.\n */\nexport function createDeltaEOk(...spaces: Space[]): (a: Color, b: Color) => number {\n\tconst over = componentsOver([oklab, ...spaces])\n\treturn (a, b) => deltaEOkWith(over, a, b)\n}\n\nconst same = (x: number | null | undefined, y: number | null | undefined, epsilon: number): boolean =>\n\tx === y || (x != null && y != null && Math.abs(x - y) <= epsilon)\n\n/**\n * True when both colors are the same within `epsilon` per component. Colors in\n * different spaces are compared in the first one's space. `none` equals only\n * `none`, and a missing alpha equals 1.\n */\nexport function equals(a: Color, b: Color, epsilon = 1e-6): boolean {\n\treturn equalsWith(componentsIn, a, b, epsilon)\n}\n\nfunction equalsWith(componentsIn: ComponentsIn, a: Color, b: Color, epsilon: number): boolean {\n\tconst other = convertWith(componentsIn, b, a.colorSpace)\n\treturn (\n\t\tsame(a.alpha ?? 1, other.alpha ?? 1, epsilon) && a.components.every((c, i) => same(c, other.components[i], epsilon))\n\t)\n}\n\n/**\n * Builds {@link equals} over the spaces given, so a bundle contains only those.\n * It needs no space of its own: give the spaces of both colors.\n */\nexport function createEquals(...spaces: Space[]): (a: Color, b: Color, epsilon?: number) => boolean {\n\tconst over = componentsOver(spaces)\n\treturn (a, b, epsilon = 1e-6) => equalsWith(over, a, b, epsilon)\n}\n"],"mappings":";;;;;AAMA,SAAgB,SAAS,GAAU,GAAkB;CACpD,OAAO,aAAa,cAAc,GAAG,CAAC;AACvC;;AAGA,SAAgB,aAAa,cAA4B,GAAU,GAAkB;CACpF,MAAM,CAAC,IAAI,IAAI,MAAM,aAAa,GAAG,OAAO;CAC5C,MAAM,CAAC,IAAI,IAAI,MAAM,aAAa,GAAG,OAAO;CAC5C,OAAO,KAAK,MAAM,KAAK,IAAI,KAAK,IAAI,KAAK,EAAE;AAC5C;;;;;AAMA,SAAgB,eAAe,GAAG,QAAiD;CAClF,MAAM,OAAO,eAAe,CAAC,OAAO,GAAG,MAAM,CAAC;CAC9C,QAAQ,GAAG,MAAM,aAAa,MAAM,GAAG,CAAC;AACzC;AAEA,MAAM,QAAQ,GAA8B,GAA8B,YACzE,MAAM,KAAM,KAAK,QAAQ,KAAK,QAAQ,KAAK,IAAI,IAAI,CAAC,KAAK;;;;;;AAO1D,SAAgB,OAAO,GAAU,GAAU,UAAU,MAAe;CACnE,OAAO,WAAW,cAAc,GAAG,GAAG,OAAO;AAC9C;AAEA,SAAS,WAAW,cAA4B,GAAU,GAAU,SAA0B;CAC7F,MAAM,QAAQ,YAAY,cAAc,GAAG,EAAE,UAAU;CACvD,OACC,KAAK,EAAE,SAAS,GAAG,MAAM,SAAS,GAAG,OAAO,KAAK,EAAE,WAAW,OAAO,GAAG,MAAM,KAAK,GAAG,MAAM,WAAW,IAAI,OAAO,CAAC;AAErH;;;;;AAMA,SAAgB,aAAa,GAAG,QAAoE;CACnG,MAAM,OAAO,eAAe,MAAM;CAClC,QAAQ,GAAG,GAAG,UAAU,SAAS,WAAW,MAAM,GAAG,GAAG,OAAO;AAChE"}

package/esm/color/contrast.d.ts

@@ -0,0 +1,107 @@
+import { Color, Space } from "./types.js";
+/**
+ * A contrast measure: `(fg, bg) => number`, plus what a caller needs to use it
+ * without knowing the algorithm. Any plain `(fg, bg) => number` also works
+ * wherever a `ContrastFn` is taken; the extra fields are optional.
+ */
+export interface ContrastFn {
+  (fg: Color, bg: Color): number;
+  /** A label for messages and output, for example `wcag2`. */
+  readonly algorithm?: string;
+  /** Named targets, for example `{ AA: 4.5 }`, which `meets` accepts as a level. */
+  readonly thresholds?: Readonly<Record<string, number>>;
+  /** `symmetric` when swapping fg and bg gives the same number; `signed` when the sign says which is lighter. */
+  readonly polarity?: 'symmetric' | 'signed';
+}
+/** The contrast algorithms built in. */
+export type ContrastAlgorithm = 'wcag2';
+/** Either a built-in name or a {@link ContrastFn}. */
+export type ContrastOption = ContrastAlgorithm | ContrastFn;
+type ColorInput = Color | string;
+/**
+ * WCAG 2 contrast ratio, 1 to 21. A translucent `fg` is laid over `bg` first;
+ * `bg` is taken as opaque.
+ */
+export declare const wcag2: ContrastFn;
+/**
+ * Contrast of `fg` on `bg`. Colors may be CSS strings. The default is WCAG 2;
+ * pass a {@link ContrastFn} to use another measure (see the APCA recipe).
+ */
+export declare function contrast(fg: ColorInput, bg: ColorInput, algo?: ContrastOption): number;
+/**
+ * Builds {@link contrast} over the spaces given, plus `srgb` and `xyz-d65`,
+ * which WCAG 2 works in, so a bundle contains only those. It takes color
+ * objects, not strings, so it does not carry `parse`. A color in a space not
+ * given throws, naming that space.
+ */
+export declare function createContrast(...spaces: Space[]): (fg: Color, bg: Color, algo?: ContrastOption) => number;
+/**
+ * True when `fg` on `bg` reaches `level`: a number, or a name from the
+ * algorithm's thresholds (WCAG 2: `AA`, `AA-large`, `AAA`, `AAA-large`,
+ * `non-text`). A signed measure such as APCA is compared by magnitude.
+ */
+export declare function meets(fg: ColorInput, bg: ColorInput, level: number | string, algo?: ContrastOption): boolean;
+/**
+ * Builds {@link meets} over the spaces given, plus `srgb` and `xyz-d65`, which
+ * WCAG 2 works in, so a bundle contains only those. It takes color objects,
+ * not strings, so it does not carry `parse`. A color in a space not given
+ * throws, naming that space.
+ */
+export declare function createMeets(...spaces: Space[]): (fg: Color, bg: Color, level: number | string, algo?: ContrastOption) => boolean;
+/** Options for `findContrast` and the function `createFindContrast` returns. */
+export interface FindContrastOptions {
+  /** Hue of the result, in OKLCH degrees. Default: the hue of `bg`. */
+  hue?: number;
+  /** Chroma of the result, in OKLCH. Default 0. The result is mapped into the gamut. */
+  chroma?: number;
+  /** Which way to look first from `bg`. Default: darker on a light `bg`, lighter on a dark one. */
+  direction?: 'lighter' | 'darker';
+  /** Default `wcag2`. */
+  contrast?: ContrastOption;
+}
+/** What `findContrast` returns: the color it found and whether it reached the target. */
+export interface FoundContrast {
+  /** The color, in `srgb` and inside the gamut. */
+  color: Color;
+  /** The contrast it achieves against `bg`, as the algorithm reports it. */
+  contrast: number;
+  /** False when no lightness reaches `target`; `color` is then the best one found. */
+  met: boolean;
+}
+/**
+ * Finds the color closest in lightness to `bg` (OKLCH L, at the given hue and
+ * chroma) that reaches `target` contrast against it, by binary search. It looks
+ * the preferred way first, then the other. The returned `contrast` is measured
+ * on the final, gamut-mapped color, and `met` says whether it reaches `target`.
+ */
+export declare function findContrast(bg: ColorInput, target: number, options?: FindContrastOptions): FoundContrast;
+/**
+ * Builds {@link findContrast} over the spaces given, plus `srgb`, `xyz-d65`,
+ * `oklch` and `oklab`, which WCAG 2 and gamut mapping work in, so a bundle
+ * contains only those. It takes a color object, not a string, so it does not
+ * carry `parse`. A color in a space not given throws, naming that space.
+ */
+export declare function createFindContrast(...spaces: Space[]): (bg: Color, target: number, options?: FindContrastOptions) => FoundContrast;
+/** Options for `onColor` and the function `createOnColor` returns. */
+export interface OnColorOptions {
+  /** The contrast the text needs. Default 4.5 for WCAG 2. */
+  target?: number;
+  /** How much of the background's hue the dark text carries, as OKLCH chroma. Default 0.03. */
+  chroma?: number;
+  /** Default `wcag2`. */
+  contrast?: ContrastOption;
+}
+/**
+ * The text color for `bg`, by the Radix rule: white, unless white's contrast
+ * on `bg` is under `target`, then a near-black tinted with the hue of `bg`
+ * (OKLCH lightness 0.2). When neither reaches `target`, whichever contrasts more.
+ */
+export declare function onColor(bg: ColorInput, options?: OnColorOptions): Color;
+/**
+ * Builds {@link onColor} over the spaces given, plus `srgb`, `xyz-d65`,
+ * `oklch` and `oklab`, which WCAG 2 and gamut mapping work in, so a bundle
+ * contains only those. It takes a color object, not a string, so it does not
+ * carry `parse`. A color in a space not given throws, naming that space.
+ */
+export declare function createOnColor(...spaces: Space[]): (bg: Color, options?: OnColorOptions) => Color;
+//# sourceMappingURL=contrast.d.ts.map

package/esm/color/contrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.d.ts","names":[],"sources":["../../src/color/contrast.ts"],"mappings":";;;;;;iBAgBiB;GACf,IAAI,OAAO,IAAI;;WAEP;;WAEA,aAAa,SAAS;;WAEtB;;;YAIE;;YAGA,iBAAiB,oBAAoB;KAE5C,aAAa;;;;;qBAoBL,OAAO;;;;;wBA8CJ,SAAS,IAAI,YAAY,IAAI,YAAY,OAAM;;;;;;;wBAU/C,kBAAkB,QAAQ,WAAW,IAAI,OAAO,IAAI,OAAO,OAAO;;;;;;wBAUlE,MAAM,IAAI,YAAY,IAAI,YAAY,wBAAwB,OAAM;;;;;;;wBAYpE,eACZ,QAAQ,WACR,IAAI,OAAO,IAAI,OAAO,wBAAwB,OAAO;;iBAkBxC;;EAEhB;;EAEA;;EAEA;;EAEA,WAAW;;;iBAIK;;EAEhB,OAAO;;EAEP;;EAEA;;;;;;;;wBAWe,aAAa,IAAI,YAAY,gBAAgB,UAAS,sBAA2B;;;;;;;wBAUjF,sBACZ,QAAQ,WACR,IAAI,OAAO,gBAAgB,UAAU,wBAAwB;;iBA+ChD;;EAEhB;;EAEA;;EAEA,WAAW;;;;;;;wBAQI,QAAQ,IAAI,YAAY,UAAS,iBAAsB;;;;;;;wBAUvD,iBAAiB,QAAQ,WAAW,IAAI,OAAO,UAAU,mBAAmB"}

package/esm/color/contrast.js

@@ -0,0 +1,242 @@
+import { componentsOver } from "./convert.js";
+import { toGamutWith } from "./gamut.js";
+import { oklab } from "./oklab.js";
+import { oklch } from "./oklch.js";
+import { toColor } from "./parse.js";
+import { componentsIn } from "./spaces.js";
+import { srgb } from "./srgb.js";
+import { unknownName } from "./unknown-name.js";
+import { xyzD65 } from "./xyz-d65.js";
+// src/color/contrast.ts
+/** Relative luminance (WCAG 2): the Y of the color in XYZ-D65, with white at 1. */
+function luminance(componentsIn, color) {
+	return Math.max(0, componentsIn(color, "xyz-d65")[1]);
+}
+/** Lays a translucent color over `bg`, in `srgb`, the way a browser paints it. */
+function flatten(componentsIn, fg, bg) {
+	const alpha = fg.alpha === null ? 0 : fg.alpha ?? 1;
+	if (alpha >= 1) return fg;
+	const f = componentsIn(fg, "srgb");
+	const b = componentsIn(bg, "srgb");
+	return {
+		colorSpace: "srgb",
+		components: f.map((x, i) => x * alpha + b[i] * (1 - alpha))
+	};
+}
+/**
+* WCAG 2 contrast ratio, 1 to 21. A translucent `fg` is laid over `bg` first;
+* `bg` is taken as opaque.
+*/
+const wcag2 = /* @__PURE__ */ wcag2Over(componentsIn);
+/** WCAG 2 over the spaces `componentsIn` knows, which must include `srgb` and `xyz-d65`. */
+function wcag2Over(componentsIn) {
+	return Object.assign((fg, bg) => {
+		const a = luminance(componentsIn, flatten(componentsIn, fg, bg)) + .05;
+		const b = luminance(componentsIn, bg) + .05;
+		return a > b ? a / b : b / a;
+	}, {
+		algorithm: "wcag2",
+		thresholds: {
+			AA: 4.5,
+			"AA-large": 3,
+			AAA: 7,
+			"AAA-large": 4.5,
+			"non-text": 3
+		},
+		polarity: "symmetric"
+	});
+}
+/** The measure `algo` names: `wcag2` or a function; anything else is an unknown name. */
+function pick(algo) {
+	return pickFrom(wcag2, algo);
+}
+/** {@link pick}, with `builtin` as what `wcag2` names. */
+function pickFrom(builtin, algo) {
+	if (algo === "wcag2") return builtin;
+	if (typeof algo !== "function") throw unknownName("contrast algorithm", algo, ["wcag2"]);
+	return algo;
+}
+/** A {@link ContrastKit} over `needed` and `spaces`. */
+function contrastKit(needed, spaces) {
+	const over = componentsOver([...needed, ...spaces]);
+	return {
+		componentsIn: over,
+		wcag2: wcag2Over(over)
+	};
+}
+/**
+* Contrast of `fg` on `bg`. Colors may be CSS strings. The default is WCAG 2;
+* pass a {@link ContrastFn} to use another measure (see the APCA recipe).
+*/
+function contrast(fg, bg, algo = "wcag2") {
+	return pick(algo)(toColor(fg), toColor(bg));
+}
+/**
+* Builds {@link contrast} over the spaces given, plus `srgb` and `xyz-d65`,
+* which WCAG 2 works in, so a bundle contains only those. It takes color
+* objects, not strings, so it does not carry `parse`. A color in a space not
+* given throws, naming that space.
+*/
+function createContrast(...spaces) {
+	const kit = contrastKit([srgb, xyzD65], spaces);
+	return (fg, bg, algo = "wcag2") => pickFrom(kit.wcag2, algo)(fg, bg);
+}
+/**
+* True when `fg` on `bg` reaches `level`: a number, or a name from the
+* algorithm's thresholds (WCAG 2: `AA`, `AA-large`, `AAA`, `AAA-large`,
+* `non-text`). A signed measure such as APCA is compared by magnitude.
+*/
+function meets(fg, bg, level, algo = "wcag2") {
+	const fn = pick(algo);
+	const target = levelOf(fn, level);
+	return Math.abs(fn(toColor(fg), toColor(bg))) >= target;
+}
+/**
+* Builds {@link meets} over the spaces given, plus `srgb` and `xyz-d65`, which
+* WCAG 2 works in, so a bundle contains only those. It takes color objects,
+* not strings, so it does not carry `parse`. A color in a space not given
+* throws, naming that space.
+*/
+function createMeets(...spaces) {
+	const kit = contrastKit([srgb, xyzD65], spaces);
+	return (fg, bg, level, algo = "wcag2") => {
+		const fn = pickFrom(kit.wcag2, algo);
+		return Math.abs(fn(fg, bg)) >= levelOf(fn, level);
+	};
+}
+/** The contrast `level` stands for under `fn`: the number itself, or one of its thresholds by name. */
+function levelOf(fn, level) {
+	const named = typeof level === "number" ? level : fn.thresholds?.[level];
+	const target = typeof named === "number" ? named : void 0;
+	if (target === void 0) throw unknownName("contrast level", level, Object.keys(fn.thresholds ?? {}));
+	return target;
+}
+const STEPS = 32;
+/**
+* Finds the color closest in lightness to `bg` (OKLCH L, at the given hue and
+* chroma) that reaches `target` contrast against it, by binary search. It looks
+* the preferred way first, then the other. The returned `contrast` is measured
+* on the final, gamut-mapped color, and `met` says whether it reaches `target`.
+*/
+function findContrast(bg, target, options = {}) {
+	return findContrastWith({
+		componentsIn,
+		wcag2
+	}, toColor(bg), target, options);
+}
+/**
+* Builds {@link findContrast} over the spaces given, plus `srgb`, `xyz-d65`,
+* `oklch` and `oklab`, which WCAG 2 and gamut mapping work in, so a bundle
+* contains only those. It takes a color object, not a string, so it does not
+* carry `parse`. A color in a space not given throws, naming that space.
+*/
+function createFindContrast(...spaces) {
+	const kit = contrastKit([
+		srgb,
+		xyzD65,
+		oklch,
+		oklab
+	], spaces);
+	return (bg, target, options = {}) => findContrastWith(kit, bg, target, options);
+}
+function findContrastWith({ componentsIn, wcag2 }, back, target, options) {
+	const fn = pickFrom(wcag2, options.contrast ?? "wcag2");
+	const lch = componentsIn(back, "oklch");
+	const l0 = lch[0];
+	const hue = options.hue ?? lch[2];
+	const chroma = options.chroma ?? 0;
+	const at = (l) => {
+		const color = toGamutWith(componentsIn, {
+			colorSpace: "oklch",
+			components: [
+				l,
+				chroma,
+				hue
+			]
+		}, {});
+		const value = fn(color, back);
+		return {
+			color,
+			contrast: value,
+			met: Math.abs(value) >= target
+		};
+	};
+	const first = options.direction ?? (l0 > .5 ? "darker" : "lighter");
+	let best;
+	for (const side of [first, first === "darker" ? "lighter" : "darker"]) {
+		const far = side === "darker" ? 0 : 1;
+		const end = at(far);
+		if (!end.met) {
+			if (!best || Math.abs(end.contrast) > Math.abs(best.contrast)) best = end;
+			continue;
+		}
+		let [lo, hi] = [l0, far];
+		let found = end;
+		for (let i = 0; i < STEPS; i++) {
+			const mid = (lo + hi) / 2;
+			const candidate = at(mid);
+			if (candidate.met) {
+				hi = mid;
+				found = candidate;
+			} else lo = mid;
+		}
+		return found;
+	}
+	return {
+		...best,
+		met: false
+	};
+}
+/**
+* The text color for `bg`, by the Radix rule: white, unless white's contrast
+* on `bg` is under `target`, then a near-black tinted with the hue of `bg`
+* (OKLCH lightness 0.2). When neither reaches `target`, whichever contrasts more.
+*/
+function onColor(bg, options = {}) {
+	return onColorWith({
+		componentsIn,
+		wcag2
+	}, toColor(bg), options);
+}
+/**
+* Builds {@link onColor} over the spaces given, plus `srgb`, `xyz-d65`,
+* `oklch` and `oklab`, which WCAG 2 and gamut mapping work in, so a bundle
+* contains only those. It takes a color object, not a string, so it does not
+* carry `parse`. A color in a space not given throws, naming that space.
+*/
+function createOnColor(...spaces) {
+	const kit = contrastKit([
+		srgb,
+		xyzD65,
+		oklch,
+		oklab
+	], spaces);
+	return (bg, options = {}) => onColorWith(kit, bg, options);
+}
+function onColorWith({ componentsIn, wcag2 }, back, options) {
+	const fn = pickFrom(wcag2, options.contrast ?? "wcag2");
+	const target = options.target ?? 4.5;
+	const white = {
+		colorSpace: "srgb",
+		components: [
+			1,
+			1,
+			1
+		]
+	};
+	const whiteScore = Math.abs(fn(white, back));
+	if (whiteScore >= target) return white;
+	const hue = componentsIn(back, "oklch")[2];
+	const dark = toGamutWith(componentsIn, {
+		colorSpace: "oklch",
+		components: [
+			.2,
+			options.chroma ?? .03,
+			hue
+		]
+	}, {});
+	return Math.abs(fn(dark, back)) >= whiteScore ? dark : white;
+}
+export { contrast, createContrast, createFindContrast, createMeets, createOnColor, findContrast, meets, onColor, pick, wcag2 };
+
+//# sourceMappingURL=contrast.js.map

package/esm/color/contrast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.js","names":[],"sources":["../../src/color/contrast.ts"],"sourcesContent":["import { type ComponentsIn, componentsOver } from './convert.js'\nimport { toGamutWith } from './gamut.js'\nimport { oklab } from './oklab.js'\nimport { oklch } from './oklch.js'\nimport { toColor } from './parse.js'\nimport { componentsIn } from './spaces.js'\nimport { srgb } from './srgb.js'\nimport type { Color, Space } from './types.js'\nimport { unknownName } from './unknown-name.js'\nimport { xyzD65 } from './xyz-d65.js'\n\n/**\n * A contrast measure: `(fg, bg) => number`, plus what a caller needs to use it\n * without knowing the algorithm. Any plain `(fg, bg) => number` also works\n * wherever a `ContrastFn` is taken; the extra fields are optional.\n */\nexport interface ContrastFn {\n\t(fg: Color, bg: Color): number\n\t/** A label for messages and output, for example `wcag2`. */\n\treadonly algorithm?: string\n\t/** Named targets, for example `{ AA: 4.5 }`, which `meets` accepts as a level. */\n\treadonly thresholds?: Readonly<Record<string, number>>\n\t/** `symmetric` when swapping fg and bg gives the same number; `signed` when the sign says which is lighter. */\n\treadonly polarity?: 'symmetric' | 'signed'\n}\n\n/** The contrast algorithms built in. */\nexport type ContrastAlgorithm = 'wcag2'\n\n/** Either a built-in name or a {@link ContrastFn}. */\nexport type ContrastOption = ContrastAlgorithm | ContrastFn\n\ntype ColorInput = Color | string\n\n/** Relative luminance (WCAG 2): the Y of the color in XYZ-D65, with white at 1. */\nfunction luminance(componentsIn: ComponentsIn, color: Color): number {\n\treturn Math.max(0, componentsIn(color, 'xyz-d65')[1] as number)\n}\n\n/** Lays a translucent color over `bg`, in `srgb`, the way a browser paints it. */\nfunction flatten(componentsIn: ComponentsIn, fg: Color, bg: Color): Color {\n\tconst alpha = fg.alpha === null ? 0 : (fg.alpha ?? 1)\n\tif (alpha >= 1) return fg\n\tconst f = componentsIn(fg, 'srgb')\n\tconst b = componentsIn(bg, 'srgb')\n\treturn { colorSpace: 'srgb', components: f.map((x, i) => (x as number) * alpha + (b[i] as number) * (1 - alpha)) }\n}\n\n/**\n * WCAG 2 contrast ratio, 1 to 21. A translucent `fg` is laid over `bg` first;\n * `bg` is taken as opaque.\n */\nexport const wcag2: ContrastFn = /* @__PURE__ */ wcag2Over(componentsIn)\n\n/** WCAG 2 over the spaces `componentsIn` knows, which must include `srgb` and `xyz-d65`. */\nfunction wcag2Over(componentsIn: ComponentsIn): ContrastFn {\n\treturn Object.assign(\n\t\t(fg: Color, bg: Color): number => {\n\t\t\tconst a = luminance(componentsIn, flatten(componentsIn, fg, bg)) + 0.05\n\t\t\tconst b = luminance(componentsIn, bg) + 0.05\n\t\t\treturn a > b ? a / b : b / a\n\t\t},\n\t\t{\n\t\t\talgorithm: 'wcag2',\n\t\t\tthresholds: { AA: 4.5, 'AA-large': 3, AAA: 7, 'AAA-large': 4.5, 'non-text': 3 },\n\t\t\tpolarity: 'symmetric'\n\t\t} as const\n\t)\n}\n\n/** The measure `algo` names: `wcag2` or a function; anything else is an unknown name. */\nexport function pick(algo: ContrastOption): ContrastFn {\n\treturn pickFrom(wcag2, algo)\n}\n\n/** {@link pick}, with `builtin` as what `wcag2` names. */\nfunction pickFrom(builtin: ContrastFn, algo: ContrastOption): ContrastFn {\n\tif (algo === 'wcag2') return builtin\n\tif (typeof algo !== 'function') throw unknownName('contrast algorithm', algo, ['wcag2'])\n\treturn algo\n}\n\n/** What a narrow contrast helper works over: its spaces and its own `wcag2`. */\ninterface ContrastKit {\n\tcomponentsIn: ComponentsIn\n\twcag2: ContrastFn\n}\n\n/** A {@link ContrastKit} over `needed` and `spaces`. */\nfunction contrastKit(needed: Space[], spaces: Space[]): ContrastKit {\n\tconst over = componentsOver([...needed, ...spaces])\n\treturn { componentsIn: over, wcag2: wcag2Over(over) }\n}\n\n/**\n * Contrast of `fg` on `bg`. Colors may be CSS strings. The default is WCAG 2;\n * pass a {@link ContrastFn} to use another measure (see the APCA recipe).\n */\nexport function contrast(fg: ColorInput, bg: ColorInput, algo: ContrastOption = 'wcag2'): number {\n\treturn pick(algo)(toColor(fg), toColor(bg))\n}\n\n/**\n * Builds {@link contrast} over the spaces given, plus `srgb` and `xyz-d65`,\n * which WCAG 2 works in, so a bundle contains only those. It takes color\n * objects, not strings, so it does not carry `parse`. A color in a space not\n * given throws, naming that space.\n */\nexport function createContrast(...spaces: Space[]): (fg: Color, bg: Color, algo?: ContrastOption) => number {\n\tconst kit = contrastKit([srgb, xyzD65], spaces)\n\treturn (fg, bg, algo = 'wcag2') => pickFrom(kit.wcag2, algo)(fg, bg)\n}\n\n/**\n * True when `fg` on `bg` reaches `level`: a number, or a name from the\n * algorithm's thresholds (WCAG 2: `AA`, `AA-large`, `AAA`, `AAA-large`,\n * `non-text`). A signed measure such as APCA is compared by magnitude.\n */\nexport function meets(fg: ColorInput, bg: ColorInput, level: number | string, algo: ContrastOption = 'wcag2'): boolean {\n\tconst fn = pick(algo)\n\tconst target = levelOf(fn, level)\n\treturn Math.abs(fn(toColor(fg), toColor(bg))) >= target\n}\n\n/**\n * Builds {@link meets} over the spaces given, plus `srgb` and `xyz-d65`, which\n * WCAG 2 works in, so a bundle contains only those. It takes color objects,\n * not strings, so it does not carry `parse`. A color in a space not given\n * throws, naming that space.\n */\nexport function createMeets(\n\t...spaces: Space[]\n): (fg: Color, bg: Color, level: number | string, algo?: ContrastOption) => boolean {\n\tconst kit = contrastKit([srgb, xyzD65], spaces)\n\treturn (fg, bg, level, algo = 'wcag2') => {\n\t\tconst fn = pickFrom(kit.wcag2, algo)\n\t\treturn Math.abs(fn(fg, bg)) >= levelOf(fn, level)\n\t}\n}\n\n/** The contrast `level` stands for under `fn`: the number itself, or one of its thresholds by name. */\nfunction levelOf(fn: ContrastFn, level: number | string): number {\n\tconst named = typeof level === 'number' ? level : fn.thresholds?.[level]\n\t// A name that is not the algorithm's own (`constructor`) finds something that is not a number.\n\tconst target = typeof named === 'number' ? named : undefined\n\tif (target === undefined) throw unknownName('contrast level', level, Object.keys(fn.thresholds ?? {}))\n\treturn target\n}\n\n/** Options for `findContrast` and the function `createFindContrast` returns. */\nexport interface FindContrastOptions {\n\t/** Hue of the result, in OKLCH degrees. Default: the hue of `bg`. */\n\thue?: number\n\t/** Chroma of the result, in OKLCH. Default 0. The result is mapped into the gamut. */\n\tchroma?: number\n\t/** Which way to look first from `bg`. Default: darker on a light `bg`, lighter on a dark one. */\n\tdirection?: 'lighter' | 'darker'\n\t/** Default `wcag2`. */\n\tcontrast?: ContrastOption\n}\n\n/** What `findContrast` returns: the color it found and whether it reached the target. */\nexport interface FoundContrast {\n\t/** The color, in `srgb` and inside the gamut. */\n\tcolor: Color\n\t/** The contrast it achieves against `bg`, as the algorithm reports it. */\n\tcontrast: number\n\t/** False when no lightness reaches `target`; `color` is then the best one found. */\n\tmet: boolean\n}\n\nconst STEPS = 32\n\n/**\n * Finds the color closest in lightness to `bg` (OKLCH L, at the given hue and\n * chroma) that reaches `target` contrast against it, by binary search. It looks\n * the preferred way first, then the other. The returned `contrast` is measured\n * on the final, gamut-mapped color, and `met` says whether it reaches `target`.\n */\nexport function findContrast(bg: ColorInput, target: number, options: FindContrastOptions = {}): FoundContrast {\n\treturn findContrastWith({ componentsIn, wcag2 }, toColor(bg), target, options)\n}\n\n/**\n * Builds {@link findContrast} over the spaces given, plus `srgb`, `xyz-d65`,\n * `oklch` and `oklab`, which WCAG 2 and gamut mapping work in, so a bundle\n * contains only those. It takes a color object, not a string, so it does not\n * carry `parse`. A color in a space not given throws, naming that space.\n */\nexport function createFindContrast(\n\t...spaces: Space[]\n): (bg: Color, target: number, options?: FindContrastOptions) => FoundContrast {\n\tconst kit = contrastKit([srgb, xyzD65, oklch, oklab], spaces)\n\treturn (bg, target, options = {}) => findContrastWith(kit, bg, target, options)\n}\n\nfunction findContrastWith(\n\t{ componentsIn, wcag2 }: ContrastKit,\n\tback: Color,\n\ttarget: number,\n\toptions: FindContrastOptions\n): FoundContrast {\n\tconst fn = pickFrom(wcag2, options.contrast ?? 'wcag2')\n\tconst lch = componentsIn(back, 'oklch')\n\tconst l0 = lch[0] as number\n\tconst hue = options.hue ?? (lch[2] as number)\n\tconst chroma = options.chroma ?? 0\n\tconst at = (l: number): FoundContrast => {\n\t\tconst color = toGamutWith(componentsIn, { colorSpace: 'oklch', components: [l, chroma, hue] }, {})\n\t\tconst value = fn(color, back)\n\t\treturn { color, contrast: value, met: Math.abs(value) >= target }\n\t}\n\tconst first = options.direction ?? (l0 > 0.5 ? 'darker' : 'lighter')\n\tlet best: FoundContrast | undefined\n\tfor (const side of [first, first === 'darker' ? 'lighter' : 'darker']) {\n\t\tconst far = side === 'darker' ? 0 : 1\n\t\tconst end = at(far)\n\t\tif (!end.met) {\n\t\t\tif (!best || Math.abs(end.contrast) > Math.abs(best.contrast)) best = end\n\t\t\tcontinue\n\t\t}\n\t\t// `lo` is on the bg side and fails or is the bg itself; `hi` always passes.\n\t\tlet [lo, hi] = [l0, far]\n\t\tlet found = end\n\t\tfor (let i = 0; i < STEPS; i++) {\n\t\t\tconst mid = (lo + hi) / 2\n\t\t\tconst candidate = at(mid)\n\t\t\tif (candidate.met) {\n\t\t\t\thi = mid\n\t\t\t\tfound = candidate\n\t\t\t} else lo = mid\n\t\t}\n\t\treturn found\n\t}\n\treturn { ...(best as FoundContrast), met: false }\n}\n\n/** Options for `onColor` and the function `createOnColor` returns. */\nexport interface OnColorOptions {\n\t/** The contrast the text needs. Default 4.5 for WCAG 2. */\n\ttarget?: number\n\t/** How much of the background's hue the dark text carries, as OKLCH chroma. Default 0.03. */\n\tchroma?: number\n\t/** Default `wcag2`. */\n\tcontrast?: ContrastOption\n}\n\n/**\n * The text color for `bg`, by the Radix rule: white, unless white's contrast\n * on `bg` is under `target`, then a near-black tinted with the hue of `bg`\n * (OKLCH lightness 0.2). When neither reaches `target`, whichever contrasts more.\n */\nexport function onColor(bg: ColorInput, options: OnColorOptions = {}): Color {\n\treturn onColorWith({ componentsIn, wcag2 }, toColor(bg), options)\n}\n\n/**\n * Builds {@link onColor} over the spaces given, plus `srgb`, `xyz-d65`,\n * `oklch` and `oklab`, which WCAG 2 and gamut mapping work in, so a bundle\n * contains only those. It takes a color object, not a string, so it does not\n * carry `parse`. A color in a space not given throws, naming that space.\n */\nexport function createOnColor(...spaces: Space[]): (bg: Color, options?: OnColorOptions) => Color {\n\tconst kit = contrastKit([srgb, xyzD65, oklch, oklab], spaces)\n\treturn (bg, options = {}) => onColorWith(kit, bg, options)\n}\n\nfunction onColorWith({ componentsIn, wcag2 }: ContrastKit, back: Color, options: OnColorOptions): Color {\n\tconst fn = pickFrom(wcag2, options.contrast ?? 'wcag2')\n\tconst target = options.target ?? 4.5\n\tconst white: Color = { colorSpace: 'srgb', components: [1, 1, 1] }\n\tconst whiteScore = Math.abs(fn(white, back))\n\tif (whiteScore >= target) return white\n\tconst hue = componentsIn(back, 'oklch')[2] as number\n\tconst dark = toGamutWith(componentsIn, { colorSpace: 'oklch', components: [0.2, options.chroma ?? 0.03, hue] }, {})\n\treturn Math.abs(fn(dark, back)) >= whiteScore ? dark : white\n}\n"],"mappings":"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"}

package/esm/color/convert.d.ts

@@ -0,0 +1,9 @@
+import { Color, ColorSpaceId, Space, Vec3 } from "./types.js";
+/** Converts bare components between two spaces, through the XYZ-D65 hub. */
+export declare function convertComponents(from: Space, to: Space, c: Vec3): Vec3;
+/**
+ * Builds `convert` over just the spaces given, so a bundle contains only those.
+ * `none` components become 0 when the space changes.
+ */
+export declare function createConverter(...spaces: Space[]): (color: Color, to: ColorSpaceId) => Color;
+//# sourceMappingURL=convert.d.ts.map

package/esm/color/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","names":[],"sources":["../../src/color/convert.ts"],"mappings":";;wBAIgB,kBAAkB,MAAM,OAAO,IAAI,OAAO,GAAG,OAAO;;;;;wBAmCpD,mBAAmB,QAAQ,WAAW,OAAO,OAAO,IAAI,iBAAiB"}

package/esm/color/convert.js

@@ -0,0 +1,45 @@
+import { unknownName } from "./unknown-name.js";
+// src/color/convert.ts
+/** Converts bare components between two spaces, through the XYZ-D65 hub. */
+function convertComponents(from, to, c) {
+	return from === to ? c : to.fromXyz(from.toXyz(c));
+}
+/** {@link ComponentsIn} over the spaces given. */
+function componentsOver(spaces) {
+	const byId = new Map(spaces.map((s) => [s.id, s]));
+	const find = (id) => {
+		const space = byId.get(id);
+		if (!space) throw unknownName("color space", id, [...byId.keys()]);
+		return space;
+	};
+	return (color, to) => {
+		if (color.colorSpace === to) return [...color.components];
+		const from = find(color.colorSpace);
+		const c = color.components;
+		return find(to).fromXyz(from.toXyz([
+			c[0] ?? 0,
+			c[1] ?? 0,
+			c[2] ?? 0
+		]));
+	};
+}
+/** `convert` over the spaces `componentsIn` knows: the color in `to`, keeping its alpha. */
+function convertWith(componentsIn, color, to) {
+	const result = {
+		colorSpace: to,
+		components: componentsIn(color, to)
+	};
+	if (color.alpha !== void 0) result.alpha = color.alpha;
+	return result;
+}
+/**
+* Builds `convert` over just the spaces given, so a bundle contains only those.
+* `none` components become 0 when the space changes.
+*/
+function createConverter(...spaces) {
+	const componentsIn = componentsOver(spaces);
+	return (color, to) => convertWith(componentsIn, color, to);
+}
+export { componentsOver, convertComponents, convertWith, createConverter };
+
+//# sourceMappingURL=convert.js.map

package/esm/color/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","names":[],"sources":["../../src/color/convert.ts"],"sourcesContent":["import type { Color, ColorSpaceId, Component, Space, Vec3 } from './types.js'\nimport { unknownName } from './unknown-name.js'\n\n/** Converts bare components between two spaces, through the XYZ-D65 hub. */\nexport function convertComponents(from: Space, to: Space, c: Vec3): Vec3 {\n\treturn from === to ? c : to.fromXyz(from.toXyz(c))\n}\n\n/** The components of a color in another space: a copy in the same space, else `none` becomes 0. */\nexport type ComponentsIn = (color: Color, to: ColorSpaceId) => Component[]\n\n/** {@link ComponentsIn} over the spaces given. */\nexport function componentsOver(spaces: Space[]): ComponentsIn {\n\tconst byId = new Map(spaces.map((s) => [s.id, s]))\n\tconst find = (id: ColorSpaceId): Space => {\n\t\tconst space = byId.get(id)\n\t\tif (!space) throw unknownName('color space', id, [...byId.keys()])\n\t\treturn space\n\t}\n\treturn (color, to) => {\n\t\tif (color.colorSpace === to) return [...color.components]\n\t\tconst from = find(color.colorSpace)\n\t\tconst c = color.components\n\t\t// Different ids, so different spaces: straight through the hub, `none` as 0.\n\t\treturn find(to).fromXyz(from.toXyz([c[0] ?? 0, c[1] ?? 0, c[2] ?? 0]))\n\t}\n}\n\n/** `convert` over the spaces `componentsIn` knows: the color in `to`, keeping its alpha. */\nexport function convertWith(componentsIn: ComponentsIn, color: Color, to: ColorSpaceId): Color {\n\tconst result: Color = { colorSpace: to, components: componentsIn(color, to) }\n\tif (color.alpha !== undefined) result.alpha = color.alpha\n\treturn result\n}\n\n/**\n * Builds `convert` over just the spaces given, so a bundle contains only those.\n * `none` components become 0 when the space changes.\n */\nexport function createConverter(...spaces: Space[]): (color: Color, to: ColorSpaceId) => Color {\n\tconst componentsIn = componentsOver(spaces)\n\treturn (color, to) => convertWith(componentsIn, color, to)\n}\n"],"mappings":";;;AAIA,SAAgB,kBAAkB,MAAa,IAAW,GAAe;CACxE,OAAO,SAAS,KAAK,IAAI,GAAG,QAAQ,KAAK,MAAM,CAAC,CAAC;AAClD;;AAMA,SAAgB,eAAe,QAA+B;CAC7D,MAAM,OAAO,IAAI,IAAI,OAAO,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;CACjD,MAAM,QAAQ,OAA4B;EACzC,MAAM,QAAQ,KAAK,IAAI,EAAE;EACzB,IAAI,CAAC,OAAO,MAAM,YAAY,eAAe,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;EACjE,OAAO;CACR;CACA,QAAQ,OAAO,OAAO;EACrB,IAAI,MAAM,eAAe,IAAI,OAAO,CAAC,GAAG,MAAM,UAAU;EACxD,MAAM,OAAO,KAAK,MAAM,UAAU;EAClC,MAAM,IAAI,MAAM;EAEhB,OAAO,KAAK,EAAE,CAAC,CAAC,QAAQ,KAAK,MAAM;GAAC,EAAE,MAAM;GAAG,EAAE,MAAM;GAAG,EAAE,MAAM;EAAC,CAAC,CAAC;CACtE;AACD;;AAGA,SAAgB,YAAY,cAA4B,OAAc,IAAyB;CAC9F,MAAM,SAAgB;EAAE,YAAY;EAAI,YAAY,aAAa,OAAO,EAAE;CAAE;CAC5E,IAAI,MAAM,UAAU,KAAA,GAAW,OAAO,QAAQ,MAAM;CACpD,OAAO;AACR;;;;;AAMA,SAAgB,gBAAgB,GAAG,QAA4D;CAC9F,MAAM,eAAe,eAAe,MAAM;CAC1C,QAAQ,OAAO,OAAO,YAAY,cAAc,OAAO,EAAE;AAC1D"}

package/esm/color/display-p3-linear.d.ts

@@ -0,0 +1,7 @@
+import { Space } from "./types.js";
+/**
+ * The CSS `display-p3-linear` space: Display P3 primaries without a transfer curve. Components are red, green and blue in 0 to 1.
+ * Pass it to `createConverter` and to the narrow helpers such as `createMix` and `createToGamut`.
+ */
+export declare const displayP3Linear: Space;
+//# sourceMappingURL=display-p3-linear.d.ts.map

package/esm/color/display-p3-linear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-p3-linear.d.ts","names":["_$__types_js0.Space"],"sources":["../../src/color/display-p3-linear.ts"],"mappings":";;;;;qBAQa,iBAAAA"}

package/esm/color/display-p3-linear.js

@@ -0,0 +1,12 @@
+import { p3ToXyz, xyzToP3 } from "./matrices.js";
+import { rgbSpace } from "./rgb.js";
+import { identity } from "./transfer.js";
+// src/color/display-p3-linear.ts
+/**
+* The CSS `display-p3-linear` space: Display P3 primaries without a transfer curve. Components are red, green and blue in 0 to 1.
+* Pass it to `createConverter` and to the narrow helpers such as `createMix` and `createToGamut`.
+*/
+const displayP3Linear = rgbSpace("display-p3-linear", identity, identity, p3ToXyz, xyzToP3);
+export { displayP3Linear };
+
+//# sourceMappingURL=display-p3-linear.js.map

package/esm/color/display-p3-linear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-p3-linear.js","names":[],"sources":["../../src/color/display-p3-linear.ts"],"sourcesContent":["import { p3ToXyz, xyzToP3 } from './matrices.js'\nimport { rgbSpace } from './rgb.js'\nimport { identity } from './transfer.js'\n\n/**\n * The CSS `display-p3-linear` space: Display P3 primaries without a transfer curve. Components are red, green and blue in 0 to 1.\n * Pass it to `createConverter` and to the narrow helpers such as `createMix` and `createToGamut`.\n */\nexport const displayP3Linear = rgbSpace('display-p3-linear', identity, identity, p3ToXyz, xyzToP3)\n"],"mappings":";;;;;;;;AAQA,MAAa,kBAAkB,SAAS,qBAAqB,UAAU,UAAU,SAAS,OAAO"}

package/esm/color/display-p3.d.ts

@@ -0,0 +1,7 @@
+import { Space } from "./types.js";
+/**
+ * The CSS `display-p3` space. Components are red, green and blue in 0 to 1, with the sRGB transfer curve.
+ * Pass it to `createConverter` and to the narrow helpers such as `createMix` and `createToGamut`.
+ */
+export declare const displayP3: Space;
+//# sourceMappingURL=display-p3.d.ts.map

package/esm/color/display-p3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-p3.d.ts","names":["_$__types_js0.Space"],"sources":["../../src/color/display-p3.ts"],"mappings":";;;;;qBAQa,WAAAA"}

package/esm/color/display-p3.js

@@ -0,0 +1,12 @@
+import { p3ToXyz, xyzToP3 } from "./matrices.js";
+import { rgbSpace } from "./rgb.js";
+import { srgbToGamma, srgbToLinear } from "./transfer.js";
+// src/color/display-p3.ts
+/**
+* The CSS `display-p3` space. Components are red, green and blue in 0 to 1, with the sRGB transfer curve.
+* Pass it to `createConverter` and to the narrow helpers such as `createMix` and `createToGamut`.
+*/
+const displayP3 = rgbSpace("display-p3", srgbToLinear, srgbToGamma, p3ToXyz, xyzToP3);
+export { displayP3 };
+
+//# sourceMappingURL=display-p3.js.map

package/esm/color/display-p3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-p3.js","names":[],"sources":["../../src/color/display-p3.ts"],"sourcesContent":["import { p3ToXyz, xyzToP3 } from './matrices.js'\nimport { rgbSpace } from './rgb.js'\nimport { srgbToGamma, srgbToLinear } from './transfer.js'\n\n/**\n * The CSS `display-p3` space. Components are red, green and blue in 0 to 1, with the sRGB transfer curve.\n * Pass it to `createConverter` and to the narrow helpers such as `createMix` and `createToGamut`.\n */\nexport const displayP3 = rgbSpace('display-p3', srgbToLinear, srgbToGamma, p3ToXyz, xyzToP3)\n"],"mappings":";;;;;;;;AAQA,MAAa,YAAY,SAAS,cAAc,cAAc,aAAa,SAAS,OAAO"}