color-map 2.2.0 → 2.3.1

package/esm/color/expr.d.ts

@@ -0,0 +1,43 @@
+import { HueMethod } from "./mix.js";
+import { Color, ColorSpaceId } from "./types.js";
+/** A color that needs a context to become concrete: see {@link resolve}. */
+export type ColorExpr = Color | {
+  type: 'currentcolor';
+} | {
+  type: 'system';
+  name: string;
+} | {
+  type: 'light-dark';
+  light: ColorExpr;
+  dark: ColorExpr;
+} | {
+  type: 'contrast-color';
+  color: ColorExpr;
+} | {
+  type: 'color-mix';
+  space: ColorSpaceId;
+  hue?: HueMethod;
+  /** Exactly two. `percent` is 0 to 100, absent when not written. */
+  items: {
+    color: ColorExpr;
+    percent?: number;
+  }[];
+} | {
+  /** `rgb(from red r g b)` and the like. The channels are kept as written, for `resolve` to evaluate. */
+  type: 'relative';
+  /** The function name: `rgb`, `hsl`, `hwb`, `lab`, `lch`, `oklab`, `oklch` or `color`. */
+  fn: string;
+  space: ColorSpaceId;
+  from: ColorExpr;
+  channels: [string, string, string];
+  alpha?: string;
+};
+/**
+ * Parses any CSS Color 4 or 5 color into a {@link ColorExpr}: everything
+ * `parse` takes, plus `currentcolor`, system colors, `light-dark()`,
+ * `color-mix()`, `contrast-color()` and relative colors such as
+ * `oklch(from #3b82f6 calc(l + 0.1) c h)`. A concrete color comes back as a
+ * plain {@link Color}; the rest are nodes that {@link resolve} turns into one.
+ */
+export declare function parseExpr(input: string): ColorExpr;
+//# sourceMappingURL=expr.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expr.d.ts","names":[],"sources":["../../src/color/expr.ts"],"mappings":";;;YAKY,YACT;EACE;;EACA;EAAgB;;EAChB;EAAoB,OAAO;EAAW,MAAM;;EAC5C;EAAwB,OAAO;;EAEjC;EACA,OAAO;EACP,MAAM;;EAEN;IAAS,OAAO;IAAW;;;;EAI3B;;EAEA;EACA,OAAO;EACP,MAAM;EACN;EACA;;;;;;;;;wBAgHa,UAAU,gBAAgB"}

package/esm/color/expr.js

@@ -0,0 +1,160 @@
+import { COLOR_SPACES, FUNCTIONS, VALUES_NEEDING_RESOLVE, fail, parse } from "./parse.js";
+// src/color/expr.ts
+const INTERPOLATION_SPACES = {
+	__proto__: null,
+	...COLOR_SPACES,
+	hsl: "hsl",
+	hwb: "hwb",
+	lab: "lab",
+	lch: "lch",
+	oklab: "oklab",
+	oklch: "oklch"
+};
+const HUE_METHODS = /* @__PURE__ */ new Set([
+	"shorter",
+	"longer",
+	"increasing",
+	"decreasing"
+]);
+const RELATIVE = /* @__PURE__ */ new Set([
+	"rgb",
+	"rgba",
+	"hsl",
+	"hsla",
+	"hwb",
+	"lab",
+	"lch",
+	"oklab",
+	"oklch",
+	"color"
+]);
+const PERCENT = /^[+-]?(?:\d+\.?\d*|\.\d+)%$/;
+/** Splits at top-level commas, or at top-level whitespace with `/` as its own item. */
+function split(text, commas, input) {
+	const out = [];
+	let depth = 0;
+	let current = "";
+	const flush = () => {
+		if (commas || current) out.push(current.trim());
+		current = "";
+	};
+	for (const ch of text) {
+		if (ch === "(") depth++;
+		else if (ch === ")") depth--;
+		if (depth === 0 && (commas ? ch === "," : /\s|\//.test(ch))) {
+			flush();
+			if (ch === "/") out.push("/");
+		} else current += ch;
+	}
+	if (depth !== 0) return fail(input, "unbalanced parentheses");
+	flush();
+	return out;
+}
+/** Splits `name(body)`, or returns undefined when the text is not one call that ends the text. */
+function call(text) {
+	const open = text.indexOf("(");
+	if (open < 1 || !text.endsWith(")") || !/^[a-z-]+$/.test(text.slice(0, open))) return void 0;
+	let depth = 0;
+	for (let i = open; i < text.length; i++) if (text[i] === "(") depth++;
+	else if (text[i] === ")" && --depth === 0 && i < text.length - 1) return void 0;
+	return [text.slice(0, open), text.slice(open + 1, -1)];
+}
+function colorMix(body, input) {
+	const [head, ...rest] = split(body, true, input);
+	const words = head.split(/\s+/);
+	if (words[0] !== "in" || !INTERPOLATION_SPACES[words[1]]) return fail(input, "color-mix() needs \"in <space>\"", words[1]);
+	const space = INTERPOLATION_SPACES[words[1]];
+	let hue;
+	if (words.length > 2) {
+		if (words.length !== 4 || words[3] !== "hue" || !HUE_METHODS.has(words[2])) return fail(input, "invalid hue interpolation", words.slice(2).join(" "));
+		hue = words[2];
+	}
+	if (rest.length !== 2) return fail(input, `color-mix() needs two colors, got ${rest.length}`);
+	const items = rest.map((text) => {
+		const parts = split(text, false, input);
+		const percents = parts.filter((p) => PERCENT.test(p));
+		if (parts.length - percents.length !== 1 || percents.length > 1) return fail(input, "invalid color-mix() item", text);
+		const percent = percents.length === 1 ? Number.parseFloat(percents[0]) : void 0;
+		if (percent !== void 0 && percent < 0) return fail(input, "negative percentage", text);
+		const color = parseExpr(parts.find((p) => !PERCENT.test(p)));
+		return percent === void 0 ? { color } : {
+			color,
+			percent
+		};
+	});
+	return hue === void 0 ? {
+		type: "color-mix",
+		space,
+		items
+	} : {
+		type: "color-mix",
+		space,
+		hue,
+		items
+	};
+}
+function relative(name, words, input) {
+	const from = words[1] === void 0 ? fail(input, "missing origin color") : parseExpr(words[1]);
+	let space;
+	let at = 2;
+	const fn = name === "rgba" ? "rgb" : name === "hsla" ? "hsl" : name;
+	if (fn === "color") {
+		const id = COLOR_SPACES[words[2]];
+		if (!id) return fail(input, "unknown color space", words[2]);
+		space = id;
+		at = 3;
+	} else space = FUNCTIONS[fn].space;
+	const channels = words.slice(at, at + 3);
+	const tail = words.slice(at + 3);
+	if (channels.length !== 3) return fail(input, `expected 3 components, got ${channels.length}`);
+	if (tail.length > 0 && (tail[0] !== "/" || tail.length !== 2)) return fail(input, "expected \"/ alpha\" after the components");
+	const node = {
+		type: "relative",
+		fn,
+		space,
+		from,
+		channels
+	};
+	if (tail.length === 2) node.alpha = tail[1];
+	return node;
+}
+/**
+* Parses any CSS Color 4 or 5 color into a {@link ColorExpr}: everything
+* `parse` takes, plus `currentcolor`, system colors, `light-dark()`,
+* `color-mix()`, `contrast-color()` and relative colors such as
+* `oklch(from #3b82f6 calc(l + 0.1) c h)`. A concrete color comes back as a
+* plain {@link Color}; the rest are nodes that {@link resolve} turns into one.
+*/
+function parseExpr(input) {
+	const text = input.trim().toLowerCase();
+	if (text === "currentcolor") return { type: "currentcolor" };
+	if (VALUES_NEEDING_RESOLVE.test(text)) return {
+		type: "system",
+		name: text
+	};
+	const parts = call(text);
+	if (!parts) return parse(text);
+	const [name, body] = parts;
+	if (name === "color-mix") return colorMix(body, input);
+	if (name === "light-dark") {
+		const list = split(body, true, input);
+		if (list.length !== 2) return fail(input, `light-dark() needs two colors, got ${list.length}`);
+		return {
+			type: "light-dark",
+			light: parseExpr(list[0]),
+			dark: parseExpr(list[1])
+		};
+	}
+	if (name === "contrast-color") return {
+		type: "contrast-color",
+		color: parseExpr(body)
+	};
+	if (RELATIVE.has(name)) {
+		const words = split(body, false, input);
+		if (words[0] === "from") return relative(name, words, input);
+	}
+	return parse(text);
+}
+export { parseExpr };
+
+//# sourceMappingURL=expr.js.map

package/esm/color/expr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expr.js","names":[],"sources":["../../src/color/expr.ts"],"sourcesContent":["import type { HueMethod } from './mix.js'\nimport { COLOR_SPACES, FUNCTIONS, fail, parse, VALUES_NEEDING_RESOLVE } from './parse.js'\nimport type { Color, ColorSpaceId } from './types.js'\n\n/** A color that needs a context to become concrete: see {@link resolve}. */\nexport type ColorExpr =\n\t| Color\n\t| { type: 'currentcolor' }\n\t| { type: 'system'; name: string }\n\t| { type: 'light-dark'; light: ColorExpr; dark: ColorExpr }\n\t| { type: 'contrast-color'; color: ColorExpr }\n\t| {\n\t\t\ttype: 'color-mix'\n\t\t\tspace: ColorSpaceId\n\t\t\thue?: HueMethod\n\t\t\t/** Exactly two. `percent` is 0 to 100, absent when not written. */\n\t\t\titems: { color: ColorExpr; percent?: number }[]\n\t  }\n\t| {\n\t\t\t/** `rgb(from red r g b)` and the like. The channels are kept as written, for `resolve` to evaluate. */\n\t\t\ttype: 'relative'\n\t\t\t/** The function name: `rgb`, `hsl`, `hwb`, `lab`, `lch`, `oklab`, `oklch` or `color`. */\n\t\t\tfn: string\n\t\t\tspace: ColorSpaceId\n\t\t\tfrom: ColorExpr\n\t\t\tchannels: [string, string, string]\n\t\t\talpha?: string\n\t  }\n\nconst INTERPOLATION_SPACES: Record<string, ColorSpaceId> = {\n\t__proto__: null as never,\n\t...COLOR_SPACES,\n\thsl: 'hsl',\n\thwb: 'hwb',\n\tlab: 'lab',\n\tlch: 'lch',\n\toklab: 'oklab',\n\toklch: 'oklch'\n}\nconst HUE_METHODS = new Set(['shorter', 'longer', 'increasing', 'decreasing'])\nconst RELATIVE = new Set(['rgb', 'rgba', 'hsl', 'hsla', 'hwb', 'lab', 'lch', 'oklab', 'oklch', 'color'])\nconst PERCENT = /^[+-]?(?:\\d+\\.?\\d*|\\.\\d+)%$/\n\n/** Splits at top-level commas, or at top-level whitespace with `/` as its own item. */\nfunction split(text: string, commas: boolean, input: string): string[] {\n\tconst out: string[] = []\n\tlet depth = 0\n\tlet current = ''\n\tconst flush = (): void => {\n\t\tif (commas || current) out.push(current.trim())\n\t\tcurrent = ''\n\t}\n\tfor (const ch of text) {\n\t\tif (ch === '(') depth++\n\t\telse if (ch === ')') depth--\n\t\tif (depth === 0 && (commas ? ch === ',' : /\\s|\\//.test(ch))) {\n\t\t\tflush()\n\t\t\tif (ch === '/') out.push('/')\n\t\t} else current += ch\n\t}\n\tif (depth !== 0) return fail(input, 'unbalanced parentheses')\n\tflush()\n\treturn out\n}\n\n/** Splits `name(body)`, or returns undefined when the text is not one call that ends the text. */\nfunction call(text: string): [string, string] | undefined {\n\tconst open = text.indexOf('(')\n\tif (open < 1 || !text.endsWith(')') || !/^[a-z-]+$/.test(text.slice(0, open))) return undefined\n\tlet depth = 0\n\tfor (let i = open; i < text.length; i++) {\n\t\tif (text[i] === '(') depth++\n\t\telse if (text[i] === ')' && --depth === 0 && i < text.length - 1) return undefined\n\t}\n\treturn [text.slice(0, open), text.slice(open + 1, -1)]\n}\n\nfunction colorMix(body: string, input: string): ColorExpr {\n\tconst [head, ...rest] = split(body, true, input)\n\tconst words = head.split(/\\s+/)\n\tif (words[0] !== 'in' || !INTERPOLATION_SPACES[words[1]])\n\t\treturn fail(input, 'color-mix() needs \"in <space>\"', words[1])\n\tconst space = INTERPOLATION_SPACES[words[1]]\n\tlet hue: HueMethod | undefined\n\tif (words.length > 2) {\n\t\tif (words.length !== 4 || words[3] !== 'hue' || !HUE_METHODS.has(words[2])) {\n\t\t\treturn fail(input, 'invalid hue interpolation', words.slice(2).join(' '))\n\t\t}\n\t\thue = words[2] as HueMethod\n\t}\n\tif (rest.length !== 2) return fail(input, `color-mix() needs two colors, got ${rest.length}`)\n\tconst items = rest.map((text) => {\n\t\tconst parts = split(text, false, input)\n\t\tconst percents = parts.filter((p) => PERCENT.test(p))\n\t\tif (parts.length - percents.length !== 1 || percents.length > 1)\n\t\t\treturn fail(input, 'invalid color-mix() item', text)\n\t\tconst percent = percents.length === 1 ? Number.parseFloat(percents[0]) : undefined\n\t\tif (percent !== undefined && percent < 0) return fail(input, 'negative percentage', text)\n\t\tconst color = parseExpr(parts.find((p) => !PERCENT.test(p)) as string)\n\t\treturn percent === undefined ? { color } : { color, percent }\n\t})\n\treturn hue === undefined ? { type: 'color-mix', space, items } : { type: 'color-mix', space, hue, items }\n}\n\nfunction relative(name: string, words: string[], input: string): ColorExpr {\n\tconst from = words[1] === undefined ? fail(input, 'missing origin color') : parseExpr(words[1])\n\tlet space: ColorSpaceId\n\tlet at = 2\n\tconst fn = name === 'rgba' ? 'rgb' : name === 'hsla' ? 'hsl' : name\n\tif (fn === 'color') {\n\t\tconst id = COLOR_SPACES[words[2]]\n\t\tif (!id) return fail(input, 'unknown color space', words[2])\n\t\tspace = id\n\t\tat = 3\n\t} else space = FUNCTIONS[fn].space\n\tconst channels = words.slice(at, at + 3)\n\tconst tail = words.slice(at + 3)\n\tif (channels.length !== 3) return fail(input, `expected 3 components, got ${channels.length}`)\n\tif (tail.length > 0 && (tail[0] !== '/' || tail.length !== 2))\n\t\treturn fail(input, 'expected \"/ alpha\" after the components')\n\tconst node: Extract<ColorExpr, { type: 'relative' }> = {\n\t\ttype: 'relative',\n\t\tfn,\n\t\tspace,\n\t\tfrom,\n\t\tchannels: channels as [string, string, string]\n\t}\n\tif (tail.length === 2) node.alpha = tail[1]\n\treturn node\n}\n\n/**\n * Parses any CSS Color 4 or 5 color into a {@link ColorExpr}: everything\n * `parse` takes, plus `currentcolor`, system colors, `light-dark()`,\n * `color-mix()`, `contrast-color()` and relative colors such as\n * `oklch(from #3b82f6 calc(l + 0.1) c h)`. A concrete color comes back as a\n * plain {@link Color}; the rest are nodes that {@link resolve} turns into one.\n */\nexport function parseExpr(input: string): ColorExpr {\n\tconst text = input.trim().toLowerCase()\n\tif (text === 'currentcolor') return { type: 'currentcolor' }\n\tif (VALUES_NEEDING_RESOLVE.test(text)) return { type: 'system', name: text }\n\tconst parts = call(text)\n\tif (!parts) return parse(text)\n\tconst [name, body] = parts\n\tif (name === 'color-mix') return colorMix(body, input)\n\tif (name === 'light-dark') {\n\t\tconst list = split(body, true, input)\n\t\tif (list.length !== 2) return fail(input, `light-dark() needs two colors, got ${list.length}`)\n\t\treturn { type: 'light-dark', light: parseExpr(list[0]), dark: parseExpr(list[1]) }\n\t}\n\tif (name === 'contrast-color') return { type: 'contrast-color', color: parseExpr(body) }\n\tif (RELATIVE.has(name)) {\n\t\tconst words = split(body, false, input)\n\t\tif (words[0] === 'from') return relative(name, words, input)\n\t}\n\treturn parse(text)\n}\n"],"mappings":"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"}

package/esm/color/gamut.d.ts

@@ -0,0 +1,31 @@
+import { Color, Space } from "./types.js";
+/** The bounded RGB spaces a color can be tested or mapped against. */
+export type GamutId = 'srgb' | 'srgb-linear' | 'display-p3' | 'display-p3-linear' | 'a98-rgb' | 'prophoto-rgb' | 'rec2020';
+/** True when every channel of `color`, seen in `gamut`, is within 0 to 1 (± `epsilon`). */
+export declare function inGamut(color: Color, gamut?: GamutId, epsilon?: number): boolean;
+/**
+ * Builds {@link inGamut} over the spaces given, plus `srgb`, so a bundle
+ * contains only those. Give the gamut too when it is not `srgb`. A color or
+ * gamut in a space not given throws, naming that space.
+ */
+export declare function createInGamut(...spaces: Space[]): (color: Color, gamut?: GamutId, epsilon?: number) => boolean;
+/** Options for `toGamut` and the function `createToGamut` returns. */
+export interface ToGamutOptions {
+  /** The gamut to fit into. Default `srgb`. */
+  gamut?: GamutId;
+  /** `css` is the CSS Color 4 OKLCH chroma reduction. `clip` clamps each channel. Default `css`. */
+  method?: 'css' | 'clip';
+}
+/**
+ * Maps a color into a gamut and returns it in its original space. `css` follows
+ * CSS Color 4 section 13.2: reduce OKLCH chroma until the clipped color is
+ * within a just-noticeable ΔEOK of 0.02.
+ */
+export declare function toGamut(color: Color, options?: ToGamutOptions): Color;
+/**
+ * Builds {@link toGamut} over the spaces given, plus `srgb`, `oklch` and
+ * `oklab`, which the CSS method works in. Give the gamut too when it is not
+ * `srgb`. A color or gamut in a space not given throws, naming that space.
+ */
+export declare function createToGamut(...spaces: Space[]): (color: Color, options?: ToGamutOptions) => Color;
+//# sourceMappingURL=gamut.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gamut.d.ts","names":[],"sources":["../../src/color/gamut.ts"],"mappings":";;YAYY;;wBAaI,QAAQ,OAAO,OAAO,QAAO,SAAkB;;;;;;wBAS/C,iBAAiB,QAAQ,WAAW,OAAO,OAAO,QAAQ,SAAS;;iBAMlE;;EAEhB,QAAQ;;EAER;;;;;;;wBAgBe,QAAQ,OAAO,OAAO,UAAS,iBAAsB;;;;;;wBASrD,iBAAiB,QAAQ,WAAW,OAAO,OAAO,UAAU,mBAAmB"}

package/esm/color/gamut.js

@@ -0,0 +1,210 @@
+import { deltaEOkWith } from "./compare.js";
+import { componentsOver, convertWith } from "./convert.js";
+import { product } from "./math.js";
+import { lmsToOklab, lmsToXyz, oklabToLms, srgbToXyz, xyzToLms, xyzToSrgb } from "./matrices.js";
+import { oklab } from "./oklab.js";
+import { oklch } from "./oklch.js";
+import { componentsIn } from "./spaces.js";
+import { srgb } from "./srgb.js";
+import { srgbToGamma } from "./transfer.js";
+// src/color/gamut.ts
+const within = (components, epsilon) => components.every((c) => c >= -epsilon && c <= 1 + epsilon);
+/** True when every channel of `color`, seen in `gamut`, is within 0 to 1 (± `epsilon`). */
+function inGamut(color, gamut = "srgb", epsilon = 1e-6) {
+	return within(componentsIn(color, gamut), epsilon);
+}
+/**
+* Builds {@link inGamut} over the spaces given, plus `srgb`, so a bundle
+* contains only those. Give the gamut too when it is not `srgb`. A color or
+* gamut in a space not given throws, naming that space.
+*/
+function createInGamut(...spaces) {
+	const over = componentsOver([srgb, ...spaces]);
+	return (color, gamut = "srgb", epsilon = 1e-6) => within(over(color, gamut), epsilon);
+}
+/** `color` with `components`, which are in `gamut`, clamped to 0 to 1: what `convert` then a clamp gives. */
+function clipped(color, gamut, components) {
+	return withAlpha({
+		colorSpace: gamut,
+		components: components.map((c) => Math.min(1, Math.max(0, c)))
+	}, color);
+}
+/**
+* Maps a color into a gamut and returns it in its original space. `css` follows
+* CSS Color 4 section 13.2: reduce OKLCH chroma until the clipped color is
+* within a just-noticeable ΔEOK of 0.02.
+*/
+function toGamut(color, options = {}) {
+	return toGamutWith(componentsIn, color, options);
+}
+/**
+* Builds {@link toGamut} over the spaces given, plus `srgb`, `oklch` and
+* `oklab`, which the CSS method works in. Give the gamut too when it is not
+* `srgb`. A color or gamut in a space not given throws, naming that space.
+*/
+function createToGamut(...spaces) {
+	const over = componentsOver([
+		srgb,
+		oklch,
+		oklab,
+		...spaces
+	]);
+	return (color, options = {}) => toGamutWith(over, color, options);
+}
+/** {@link toGamut} over the spaces `componentsIn` knows, which must include `oklch` and `oklab`. */
+function toGamutWith(componentsIn, color, options) {
+	const { gamut = "srgb", method = "css" } = options;
+	const deltaEOk = (a, b) => deltaEOkWith(componentsIn, a, b);
+	const back = (c) => convertWith(componentsIn, c, color.colorSpace);
+	const fit = componentsIn(color, gamut);
+	if (within(fit, 1e-6)) return color;
+	if (method === "clip") return back(clipped(color, gamut, fit));
+	const origin = convertWith(componentsIn, color, "oklch");
+	const [lightness, chroma, hue] = origin.components;
+	if (lightness >= 1) return back(withAlpha({
+		colorSpace: gamut,
+		components: [
+			1,
+			1,
+			1
+		]
+	}, color));
+	if (lightness <= 0) return back(withAlpha({
+		colorSpace: gamut,
+		components: [
+			0,
+			0,
+			0
+		]
+	}, color));
+	const JND = .02;
+	const EPSILON = 1e-4;
+	if (gamut === "srgb") return back(reduceChromaInSrgb(origin, lightness, chroma, hue));
+	let min = 0;
+	let max = chroma;
+	let minInGamut = true;
+	let clip = clipped(origin, gamut, componentsIn(origin, gamut));
+	if (deltaEOk(clip, origin) < JND) return back(clip);
+	while (max - min > EPSILON) {
+		const mid = (min + max) / 2;
+		const current = withAlpha({
+			colorSpace: "oklch",
+			components: [
+				lightness,
+				mid,
+				hue
+			]
+		}, origin);
+		const inGamutSpace = componentsIn(current, gamut);
+		if (minInGamut && within(inGamutSpace, 1e-6)) {
+			min = mid;
+			continue;
+		}
+		clip = clipped(current, gamut, inGamutSpace);
+		const e = deltaEOk(clip, current);
+		if (e < JND) {
+			if (JND - e < EPSILON) return back(clip);
+			minInGamut = false;
+			min = mid;
+		} else max = mid;
+	}
+	/* v8 ignore next */
+	return back(clip);
+}
+function withAlpha(c, source) {
+	if (source.alpha !== void 0) c.alpha = source.alpha;
+	return c;
+}
+let lmsToLinear;
+let linearToLms;
+const LOW = -1e-6 / 12.92;
+const HIGH = ((1 + 1e-6 + .055) / 1.055) ** 2.4;
+const encode = (n) => n === 0 || n === 1 ? n : srgbToGamma(n);
+const clamp01 = (n) => Math.min(1, Math.max(0, n));
+/**
+* The CSS Color 4 section 13.2 search of `toGamut` for the `srgb` gamut, done in
+* linear sRGB so the loop has no hub conversion, `**` or trigonometry. Clipping
+* to 0 to 1 commutes with the monotone transfer curve, so it finds what the
+* generic path finds, up to rounding. Returns the mapped color in `srgb`.
+*/
+function reduceChromaInSrgb(origin, lightness, chroma, hue) {
+	const m = lmsToLinear ??= product(xyzToSrgb, lmsToXyz);
+	const n = linearToLms ??= product(xyzToLms, srgbToXyz);
+	const o = oklabToLms;
+	const k = lmsToOklab;
+	const l = lightness;
+	const radians = (hue ?? 0) * Math.PI / 180;
+	const cos = Math.cos(radians);
+	const sin = Math.sin(radians);
+	let r = 0;
+	let g = 0;
+	let b = 0;
+	let inside = false;
+	/** Puts the candidate of chroma `c` in linear sRGB into r, g, b (unclipped), and says if it is within the gamut. */
+	const place = (c) => {
+		const a = c * cos;
+		const bb = c * sin;
+		const x = l + o[1] * a + o[2] * bb;
+		const y = l + o[4] * a + o[5] * bb;
+		const z = l + o[7] * a + o[8] * bb;
+		const x3 = x * x * x;
+		const y3 = y * y * y;
+		const z3 = z * z * z;
+		r = m[0] * x3 + m[1] * y3 + m[2] * z3;
+		g = m[3] * x3 + m[4] * y3 + m[5] * z3;
+		b = m[6] * x3 + m[7] * y3 + m[8] * z3;
+		inside = r >= LOW && r <= HIGH && g >= LOW && g <= HIGH && b >= LOW && b <= HIGH;
+	};
+	/** Clips r, g, b and returns its ΔEOK to the candidate of chroma `c`. */
+	const clipAndMeasure = (c) => {
+		r = clamp01(r);
+		g = clamp01(g);
+		b = clamp01(b);
+		const x = Math.cbrt(n[0] * r + n[1] * g + n[2] * b);
+		const y = Math.cbrt(n[3] * r + n[4] * g + n[5] * b);
+		const z = Math.cbrt(n[6] * r + n[7] * g + n[8] * b);
+		const dl = k[0] * x + k[1] * y + k[2] * z - l;
+		const da = k[3] * x + k[4] * y + k[5] * z - c * cos;
+		const db = k[6] * x + k[7] * y + k[8] * z - c * sin;
+		return Math.sqrt(dl * dl + da * da + db * db);
+	};
+	const JND = .02;
+	const EPSILON = 1e-4;
+	let min = 0;
+	let max = chroma;
+	let minInGamut = true;
+	place(chroma ?? 0);
+	let clip;
+	let e = clipAndMeasure(chroma ?? 0);
+	clip = [
+		r,
+		g,
+		b
+	];
+	if (e >= JND) while (max - min > EPSILON) {
+		const mid = (min + max) / 2;
+		place(mid);
+		if (minInGamut && inside) {
+			min = mid;
+			continue;
+		}
+		e = clipAndMeasure(mid);
+		clip = [
+			r,
+			g,
+			b
+		];
+		if (e < JND) {
+			if (JND - e < EPSILON) break;
+			minInGamut = false;
+			min = mid;
+		} else max = mid;
+	}
+	return withAlpha({
+		colorSpace: "srgb",
+		components: clip.map(encode)
+	}, origin);
+}
+export { createInGamut, createToGamut, inGamut, toGamut, toGamutWith };
+
+//# sourceMappingURL=gamut.js.map

package/esm/color/gamut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gamut.js","names":[],"sources":["../../src/color/gamut.ts"],"sourcesContent":["import { deltaEOkWith } from './compare.js'\nimport { type ComponentsIn, componentsOver, convertWith } from './convert.js'\nimport { type Matrix, product } from './math.js'\nimport { lmsToOklab, lmsToXyz, oklabToLms, srgbToXyz, xyzToLms, xyzToSrgb } from './matrices.js'\nimport { oklab } from './oklab.js'\nimport { oklch } from './oklch.js'\nimport { componentsIn } from './spaces.js'\nimport { srgb } from './srgb.js'\nimport { srgbToGamma } from './transfer.js'\nimport type { Color, ColorSpaceId, Component, Space, Vec3 } from './types.js'\n\n/** The bounded RGB spaces a color can be tested or mapped against. */\nexport type GamutId =\n\t| 'srgb'\n\t| 'srgb-linear'\n\t| 'display-p3'\n\t| 'display-p3-linear'\n\t| 'a98-rgb'\n\t| 'prophoto-rgb'\n\t| 'rec2020'\n\nconst within = (components: Component[], epsilon: number): boolean =>\n\tcomponents.every((c) => (c as number) >= -epsilon && (c as number) <= 1 + epsilon)\n\n/** True when every channel of `color`, seen in `gamut`, is within 0 to 1 (± `epsilon`). */\nexport function inGamut(color: Color, gamut: GamutId = 'srgb', epsilon = 1e-6): boolean {\n\treturn within(componentsIn(color, gamut), epsilon)\n}\n\n/**\n * Builds {@link inGamut} over the spaces given, plus `srgb`, so a bundle\n * contains only those. Give the gamut too when it is not `srgb`. A color or\n * gamut in a space not given throws, naming that space.\n */\nexport function createInGamut(...spaces: Space[]): (color: Color, gamut?: GamutId, epsilon?: number) => boolean {\n\tconst over = componentsOver([srgb, ...spaces])\n\treturn (color, gamut = 'srgb', epsilon = 1e-6) => within(over(color, gamut), epsilon)\n}\n\n/** Options for `toGamut` and the function `createToGamut` returns. */\nexport interface ToGamutOptions {\n\t/** The gamut to fit into. Default `srgb`. */\n\tgamut?: GamutId\n\t/** `css` is the CSS Color 4 OKLCH chroma reduction. `clip` clamps each channel. Default `css`. */\n\tmethod?: 'css' | 'clip'\n}\n\n/** `color` with `components`, which are in `gamut`, clamped to 0 to 1: what `convert` then a clamp gives. */\nfunction clipped(color: Color, gamut: GamutId, components: Component[]): Color {\n\treturn withAlpha(\n\t\t{ colorSpace: gamut, components: components.map((c) => Math.min(1, Math.max(0, c as number))) },\n\t\tcolor\n\t)\n}\n\n/**\n * Maps a color into a gamut and returns it in its original space. `css` follows\n * CSS Color 4 section 13.2: reduce OKLCH chroma until the clipped color is\n * within a just-noticeable ΔEOK of 0.02.\n */\nexport function toGamut(color: Color, options: ToGamutOptions = {}): Color {\n\treturn toGamutWith(componentsIn, color, options)\n}\n\n/**\n * Builds {@link toGamut} over the spaces given, plus `srgb`, `oklch` and\n * `oklab`, which the CSS method works in. Give the gamut too when it is not\n * `srgb`. A color or gamut in a space not given throws, naming that space.\n */\nexport function createToGamut(...spaces: Space[]): (color: Color, options?: ToGamutOptions) => Color {\n\tconst over = componentsOver([srgb, oklch, oklab, ...spaces])\n\treturn (color, options = {}) => toGamutWith(over, color, options)\n}\n\n/** {@link toGamut} over the spaces `componentsIn` knows, which must include `oklch` and `oklab`. */\nexport function toGamutWith(componentsIn: ComponentsIn, color: Color, options: ToGamutOptions): Color {\n\tconst { gamut = 'srgb', method = 'css' } = options\n\tconst deltaEOk = (a: Color, b: Color): number => deltaEOkWith(componentsIn, a, b)\n\tconst back = (c: Color): Color => convertWith(componentsIn, c, color.colorSpace as ColorSpaceId)\n\t// Each candidate is converted to the gamut once, then tested and clipped from that.\n\tconst fit = componentsIn(color, gamut)\n\tif (within(fit, 1e-6)) return color\n\tif (method === 'clip') return back(clipped(color, gamut, fit))\n\n\tconst origin = convertWith(componentsIn, color, 'oklch')\n\tconst [lightness, chroma, hue] = origin.components as [number, number, Component]\n\tif (lightness >= 1) return back(withAlpha({ colorSpace: gamut, components: [1, 1, 1] }, color))\n\tif (lightness <= 0) return back(withAlpha({ colorSpace: gamut, components: [0, 0, 0] }, color))\n\n\tconst JND = 0.02\n\tconst EPSILON = 0.0001\n\tif (gamut === 'srgb') return back(reduceChromaInSrgb(origin, lightness, chroma, hue))\n\tlet min = 0\n\tlet max = chroma\n\tlet minInGamut = true\n\tlet clip = clipped(origin, gamut, componentsIn(origin, gamut))\n\tif (deltaEOk(clip, origin) < JND) return back(clip)\n\twhile (max - min > EPSILON) {\n\t\tconst mid = (min + max) / 2\n\t\tconst current = withAlpha({ colorSpace: 'oklch', components: [lightness, mid, hue] }, origin)\n\t\tconst inGamutSpace = componentsIn(current, gamut)\n\t\tif (minInGamut && within(inGamutSpace, 1e-6)) {\n\t\t\tmin = mid\n\t\t\tcontinue\n\t\t}\n\t\tclip = clipped(current, gamut, inGamutSpace)\n\t\tconst e = deltaEOk(clip, current)\n\t\tif (e < JND) {\n\t\t\tif (JND - e < EPSILON) return back(clip)\n\t\t\tminInGamut = false\n\t\t\tmin = mid\n\t\t} else {\n\t\t\tmax = mid\n\t\t}\n\t}\n\t// The search ended by narrowing to EPSILON rather than by an early return. A\n\t// sweep of 88,000 colors never gets here, but the algorithm allows it.\n\t/* v8 ignore next */\n\treturn back(clip)\n}\n\nfunction withAlpha(c: Color, source: Color): Color {\n\tif (source.alpha !== undefined) c.alpha = source.alpha\n\treturn c\n}\n\nlet lmsToLinear: Matrix | undefined\nlet linearToLms: Matrix | undefined\n// The gamma-space tolerance of 1e-6 on each side, as a linear one: the transfer curve is monotone.\nconst LOW = -1e-6 / 12.92\nconst HIGH = ((1 + 1e-6 + 0.055) / 1.055) ** 2.4\n\n// A clipped channel of exactly 0 or 1 stays exactly that, as clipping after the curve gives.\nconst encode = (n: number): number => (n === 0 || n === 1 ? n : srgbToGamma(n))\nconst clamp01 = (n: number): number => Math.min(1, Math.max(0, n))\n\n/**\n * The CSS Color 4 section 13.2 search of `toGamut` for the `srgb` gamut, done in\n * linear sRGB so the loop has no hub conversion, `**` or trigonometry. Clipping\n * to 0 to 1 commutes with the monotone transfer curve, so it finds what the\n * generic path finds, up to rounding. Returns the mapped color in `srgb`.\n */\nfunction reduceChromaInSrgb(origin: Color, lightness: number, chroma: number, hue: Component): Color {\n\t// Composed on first use, so a bundle without this path does not pay for them at load.\n\tconst m = (lmsToLinear ??= product(xyzToSrgb, lmsToXyz))\n\tconst n = (linearToLms ??= product(xyzToLms, srgbToXyz))\n\tconst o = oklabToLms\n\tconst k = lmsToOklab\n\t// A `none` hue or chroma reads as 0, as it does in a conversion. A `none` lightness never gets here.\n\tconst l = lightness\n\tconst radians = ((hue ?? 0) * Math.PI) / 180\n\tconst cos = Math.cos(radians)\n\tconst sin = Math.sin(radians)\n\tlet r = 0\n\tlet g = 0\n\tlet b = 0\n\tlet inside = false\n\t/** Puts the candidate of chroma `c` in linear sRGB into r, g, b (unclipped), and says if it is within the gamut. */\n\tconst place = (c: number): void => {\n\t\tconst a = c * cos\n\t\tconst bb = c * sin\n\t\tconst x = l + o[1] * a + o[2] * bb\n\t\tconst y = l + o[4] * a + o[5] * bb\n\t\tconst z = l + o[7] * a + o[8] * bb\n\t\tconst x3 = x * x * x\n\t\tconst y3 = y * y * y\n\t\tconst z3 = z * z * z\n\t\tr = m[0] * x3 + m[1] * y3 + m[2] * z3\n\t\tg = m[3] * x3 + m[4] * y3 + m[5] * z3\n\t\tb = m[6] * x3 + m[7] * y3 + m[8] * z3\n\t\tinside = r >= LOW && r <= HIGH && g >= LOW && g <= HIGH && b >= LOW && b <= HIGH\n\t}\n\t/** Clips r, g, b and returns its ΔEOK to the candidate of chroma `c`. */\n\tconst clipAndMeasure = (c: number): number => {\n\t\tr = clamp01(r)\n\t\tg = clamp01(g)\n\t\tb = clamp01(b)\n\t\tconst x = Math.cbrt(n[0] * r + n[1] * g + n[2] * b)\n\t\tconst y = Math.cbrt(n[3] * r + n[4] * g + n[5] * b)\n\t\tconst z = Math.cbrt(n[6] * r + n[7] * g + n[8] * b)\n\t\tconst dl = k[0] * x + k[1] * y + k[2] * z - l\n\t\tconst da = k[3] * x + k[4] * y + k[5] * z - c * cos\n\t\tconst db = k[6] * x + k[7] * y + k[8] * z - c * sin\n\t\treturn Math.sqrt(dl * dl + da * da + db * db)\n\t}\n\tconst JND = 0.02\n\tconst EPSILON = 0.0001\n\tlet min = 0\n\tlet max = chroma\n\tlet minInGamut = true\n\tplace(chroma ?? 0)\n\tlet clip: Vec3\n\tlet e = clipAndMeasure(chroma ?? 0)\n\tclip = [r, g, b]\n\tif (e >= JND) {\n\t\twhile (max - min > EPSILON) {\n\t\t\tconst mid = (min + max) / 2\n\t\t\tplace(mid)\n\t\t\tif (minInGamut && inside) {\n\t\t\t\tmin = mid\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\te = clipAndMeasure(mid)\n\t\t\tclip = [r, g, b]\n\t\t\tif (e < JND) {\n\t\t\t\tif (JND - e < EPSILON) break\n\t\t\t\tminInGamut = false\n\t\t\t\tmin = mid\n\t\t\t} else {\n\t\t\t\tmax = mid\n\t\t\t}\n\t\t}\n\t}\n\treturn withAlpha({ colorSpace: 'srgb', components: clip.map(encode) }, origin)\n}\n"],"mappings":"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"}

package/esm/color/hsl.d.ts

@@ -0,0 +1,7 @@
+import { Space } from "./types.js";
+/**
+ * The CSS `hsl` space. Components are hue in degrees, then saturation and lightness in 0 to 100.
+ * Pass it to `createConverter` and to the narrow helpers such as `createMix` and `createToGamut`.
+ */
+export declare const hsl: Space;
+//# sourceMappingURL=hsl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hsl.d.ts","names":[],"sources":["../../src/color/hsl.ts"],"mappings":";;;;;qBAiDa,KAAK"}

package/esm/color/hsl.js

@@ -0,0 +1,67 @@
+import { normalizeHue } from "./math.js";
+import { srgb } from "./srgb.js";
+// src/color/hsl.ts
+function channel(t1, t2, sextant) {
+	const h = (sextant + 6) % 6;
+	if (h < 1) return (t2 - t1) * h + t1;
+	if (h < 3) return t2;
+	if (h < 4) return (t2 - t1) * (4 - h) + t1;
+	return t1;
+}
+/** CSS Color 4 hslToRgb. Hue in degrees, s and l in 0 to 1. */
+function hslToSrgb(h, s, l) {
+	const t2 = l <= .5 ? l * (s + 1) : l + s - l * s;
+	const t1 = l * 2 - t2;
+	const hue = normalizeHue(h) / 60;
+	return [
+		channel(t1, t2, hue + 2),
+		channel(t1, t2, hue),
+		channel(t1, t2, hue - 2)
+	];
+}
+/**
+* CSS Color 4 rgbToHsl. Returns hue in degrees, s and l in 0 to 1. For
+* out-of-gamut input the saturation can come out negative; it is made positive
+* and the hue turned by 180 degrees, unless `flipNegative` is false.
+*/
+function srgbToHsl([r, g, b], flipNegative = true) {
+	const max = Math.max(r, g, b);
+	const min = Math.min(r, g, b);
+	const l = (min + max) / 2;
+	const d = max - min;
+	let h = 0;
+	let s = 0;
+	if (d > 1e-9) {
+		s = l === 0 || l === 1 ? 0 : (max - l) / Math.min(l, 1 - l);
+		h = max === r ? (g - b) / d + (g < b ? 6 : 0) : max === g ? (b - r) / d + 2 : (r - g) / d + 4;
+		h *= 60;
+	}
+	if (s < 0) {
+		if (flipNegative) h += 180;
+		s = -s;
+	}
+	return [
+		normalizeHue(h),
+		s,
+		l
+	];
+}
+/**
+* The CSS `hsl` space. Components are hue in degrees, then saturation and lightness in 0 to 100.
+* Pass it to `createConverter` and to the narrow helpers such as `createMix` and `createToGamut`.
+*/
+const hsl = {
+	id: "hsl",
+	toXyz: ([h, s, l]) => srgb.toXyz(hslToSrgb(h, s / 100, l / 100)),
+	fromXyz: (xyz) => {
+		const [h, s, l] = srgbToHsl(srgb.fromXyz(xyz));
+		return [
+			h,
+			s * 100,
+			l * 100
+		];
+	}
+};
+export { hsl, hslToSrgb, srgbToHsl };
+
+//# sourceMappingURL=hsl.js.map

package/esm/color/hsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hsl.js","names":[],"sources":["../../src/color/hsl.ts"],"sourcesContent":["import { normalizeHue } from './math.js'\nimport { srgb } from './srgb.js'\nimport type { Space, Vec3 } from './types.js'\n\nfunction channel(t1: number, t2: number, sextant: number): number {\n\tconst h = (sextant + 6) % 6\n\tif (h < 1) return (t2 - t1) * h + t1\n\tif (h < 3) return t2\n\tif (h < 4) return (t2 - t1) * (4 - h) + t1\n\treturn t1\n}\n\n/** CSS Color 4 hslToRgb. Hue in degrees, s and l in 0 to 1. */\nexport function hslToSrgb(h: number, s: number, l: number): Vec3 {\n\tconst t2 = l <= 0.5 ? l * (s + 1) : l + s - l * s\n\tconst t1 = l * 2 - t2\n\tconst hue = normalizeHue(h) / 60\n\treturn [channel(t1, t2, hue + 2), channel(t1, t2, hue), channel(t1, t2, hue - 2)]\n}\n\n/**\n * CSS Color 4 rgbToHsl. Returns hue in degrees, s and l in 0 to 1. For\n * out-of-gamut input the saturation can come out negative; it is made positive\n * and the hue turned by 180 degrees, unless `flipNegative` is false.\n */\nexport function srgbToHsl([r, g, b]: Vec3, flipNegative = true): Vec3 {\n\tconst max = Math.max(r, g, b)\n\tconst min = Math.min(r, g, b)\n\tconst l = (min + max) / 2\n\tconst d = max - min\n\tlet h = 0\n\tlet s = 0\n\t// A spread of rounding noise is a gray: a round trip leaves white at 1 - 1e-16.\n\tif (d > 1e-9) {\n\t\ts = l === 0 || l === 1 ? 0 : (max - l) / Math.min(l, 1 - l)\n\t\th = max === r ? (g - b) / d + (g < b ? 6 : 0) : max === g ? (b - r) / d + 2 : (r - g) / d + 4\n\t\th *= 60\n\t}\n\tif (s < 0) {\n\t\tif (flipNegative) h += 180\n\t\ts = -s\n\t}\n\treturn [normalizeHue(h), s, l]\n}\n\n/**\n * The CSS `hsl` space. Components are hue in degrees, then saturation and lightness in 0 to 100.\n * Pass it to `createConverter` and to the narrow helpers such as `createMix` and `createToGamut`.\n */\nexport const hsl: Space = {\n\tid: 'hsl',\n\ttoXyz: ([h, s, l]) => srgb.toXyz(hslToSrgb(h, s / 100, l / 100)),\n\tfromXyz: (xyz) => {\n\t\tconst [h, s, l] = srgbToHsl(srgb.fromXyz(xyz))\n\t\treturn [h, s * 100, l * 100]\n\t}\n}\n"],"mappings":";;;AAIA,SAAS,QAAQ,IAAY,IAAY,SAAyB;CACjE,MAAM,KAAK,UAAU,KAAK;CAC1B,IAAI,IAAI,GAAG,QAAQ,KAAK,MAAM,IAAI;CAClC,IAAI,IAAI,GAAG,OAAO;CAClB,IAAI,IAAI,GAAG,QAAQ,KAAK,OAAO,IAAI,KAAK;CACxC,OAAO;AACR;;AAGA,SAAgB,UAAU,GAAW,GAAW,GAAiB;CAChE,MAAM,KAAK,KAAK,KAAM,KAAK,IAAI,KAAK,IAAI,IAAI,IAAI;CAChD,MAAM,KAAK,IAAI,IAAI;CACnB,MAAM,MAAM,aAAa,CAAC,IAAI;CAC9B,OAAO;EAAC,QAAQ,IAAI,IAAI,MAAM,CAAC;EAAG,QAAQ,IAAI,IAAI,GAAG;EAAG,QAAQ,IAAI,IAAI,MAAM,CAAC;CAAC;AACjF;;;;;;AAOA,SAAgB,UAAU,CAAC,GAAG,GAAG,IAAU,eAAe,MAAY;CACrE,MAAM,MAAM,KAAK,IAAI,GAAG,GAAG,CAAC;CAC5B,MAAM,MAAM,KAAK,IAAI,GAAG,GAAG,CAAC;CAC5B,MAAM,KAAK,MAAM,OAAO;CACxB,MAAM,IAAI,MAAM;CAChB,IAAI,IAAI;CACR,IAAI,IAAI;CAER,IAAI,IAAI,MAAM;EACb,IAAI,MAAM,KAAK,MAAM,IAAI,KAAK,MAAM,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;EAC1D,IAAI,QAAQ,KAAK,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,KAAK,QAAQ,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI;EAC5F,KAAK;CACN;CACA,IAAI,IAAI,GAAG;EACV,IAAI,cAAc,KAAK;EACvB,IAAI,CAAC;CACN;CACA,OAAO;EAAC,aAAa,CAAC;EAAG;EAAG;CAAC;AAC9B;;;;;AAMA,MAAa,MAAa;CACzB,IAAI;CACJ,QAAQ,CAAC,GAAG,GAAG,OAAO,KAAK,MAAM,UAAU,GAAG,IAAI,KAAK,IAAI,GAAG,CAAC;CAC/D,UAAU,QAAQ;EACjB,MAAM,CAAC,GAAG,GAAG,KAAK,UAAU,KAAK,QAAQ,GAAG,CAAC;EAC7C,OAAO;GAAC;GAAG,IAAI;GAAK,IAAI;EAAG;CAC5B;AACD"}

package/esm/color/hwb.d.ts

@@ -0,0 +1,7 @@
+import { Space } from "./types.js";
+/**
+ * The CSS `hwb` space. Components are hue in degrees, then whiteness and blackness in 0 to 100.
+ * Pass it to `createConverter` and to the narrow helpers such as `createMix` and `createToGamut`.
+ */
+export declare const hwb: Space;
+//# sourceMappingURL=hwb.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hwb.d.ts","names":[],"sources":["../../src/color/hwb.ts"],"mappings":";;;;;qBAQa,KAAK"}

package/esm/color/hwb.js

@@ -0,0 +1,40 @@
+import { hslToSrgb, srgbToHsl } from "./hsl.js";
+import { srgb } from "./srgb.js";
+// src/color/hwb.ts
+/**
+* The CSS `hwb` space. Components are hue in degrees, then whiteness and blackness in 0 to 100.
+* Pass it to `createConverter` and to the narrow helpers such as `createMix` and `createToGamut`.
+*/
+const hwb = {
+	id: "hwb",
+	toXyz: ([h, w, b]) => {
+		const white = w / 100;
+		const black = b / 100;
+		if (white + black >= 1) {
+			const gray = white / (white + black);
+			return srgb.toXyz([
+				gray,
+				gray,
+				gray
+			]);
+		}
+		const k = 1 - white - black;
+		const [red, green, blue] = hslToSrgb(h, 1, .5);
+		return srgb.toXyz([
+			red * k + white,
+			green * k + white,
+			blue * k + white
+		]);
+	},
+	fromXyz: (xyz) => {
+		const rgb = srgb.fromXyz(xyz);
+		return [
+			srgbToHsl(rgb, false)[0],
+			Math.min(...rgb) * 100,
+			(1 - Math.max(...rgb)) * 100
+		];
+	}
+};
+export { hwb };
+
+//# sourceMappingURL=hwb.js.map

package/esm/color/hwb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hwb.js","names":[],"sources":["../../src/color/hwb.ts"],"sourcesContent":["import { hslToSrgb, srgbToHsl } from './hsl.js'\nimport { srgb } from './srgb.js'\nimport type { Space } from './types.js'\n\n/**\n * The CSS `hwb` space. Components are hue in degrees, then whiteness and blackness in 0 to 100.\n * Pass it to `createConverter` and to the narrow helpers such as `createMix` and `createToGamut`.\n */\nexport const hwb: Space = {\n\tid: 'hwb',\n\ttoXyz: ([h, w, b]) => {\n\t\tconst white = w / 100\n\t\tconst black = b / 100\n\t\tif (white + black >= 1) {\n\t\t\tconst gray = white / (white + black)\n\t\t\treturn srgb.toXyz([gray, gray, gray])\n\t\t}\n\t\tconst k = 1 - white - black\n\t\tconst [red, green, blue] = hslToSrgb(h, 1, 0.5)\n\t\treturn srgb.toXyz([red * k + white, green * k + white, blue * k + white])\n\t},\n\tfromXyz: (xyz) => {\n\t\tconst rgb = srgb.fromXyz(xyz)\n\t\treturn [srgbToHsl(rgb, false)[0], Math.min(...rgb) * 100, (1 - Math.max(...rgb)) * 100]\n\t}\n}\n"],"mappings":";;;;;;;AAQA,MAAa,MAAa;CACzB,IAAI;CACJ,QAAQ,CAAC,GAAG,GAAG,OAAO;EACrB,MAAM,QAAQ,IAAI;EAClB,MAAM,QAAQ,IAAI;EAClB,IAAI,QAAQ,SAAS,GAAG;GACvB,MAAM,OAAO,SAAS,QAAQ;GAC9B,OAAO,KAAK,MAAM;IAAC;IAAM;IAAM;GAAI,CAAC;EACrC;EACA,MAAM,IAAI,IAAI,QAAQ;EACtB,MAAM,CAAC,KAAK,OAAO,QAAQ,UAAU,GAAG,GAAG,EAAG;EAC9C,OAAO,KAAK,MAAM;GAAC,MAAM,IAAI;GAAO,QAAQ,IAAI;GAAO,OAAO,IAAI;EAAK,CAAC;CACzE;CACA,UAAU,QAAQ;EACjB,MAAM,MAAM,KAAK,QAAQ,GAAG;EAC5B,OAAO;GAAC,UAAU,KAAK,KAAK,CAAC,CAAC;GAAI,KAAK,IAAI,GAAG,GAAG,IAAI;IAAM,IAAI,KAAK,IAAI,GAAG,GAAG,KAAK;EAAG;CACvF;AACD"}