color-map 2.2.0 → 2.3.1

package/cjs/palette-DyFV_KoJ.js

@@ -0,0 +1,332 @@
+const require_parse = require("./parse-8mt2OMKf.js");
+const require_tone = require("./tone-BAhu-QzQ.js");
+const require_contrast = require("./contrast-XjF5Rwui.js");
+// src/palette/dark.ts
+const STRATEGIES = [
+	"mirror",
+	"tone-swap",
+	"lightness-invert"
+];
+/**
+* A dark version of a light scale (ordered light to dark), with the same
+* number of steps.
+* - `mirror`: step n takes the color of step N+1-n, so the scale runs dark to
+*   light and step 1 is the old last step. Colors are unchanged.
+* - `tone-swap`: each color keeps its OKLCH hue and chroma and takes the CIE
+*   L* tone 100 minus its own, as Material swaps tone 40 for 80. Contrast
+*   between two steps is kept roughly the same.
+* - `lightness-invert`: OKLCH lightness is reflected within the scale's own
+*   range, keeping step order, with chroma eased by 10% to curb vibration on
+*   dark backgrounds.
+*/
+function darkVariant(scale, strategy = "tone-swap", options = {}) {
+	const { gamut = "srgb" } = options;
+	if (!STRATEGIES.includes(strategy)) throw require_parse.unknownName("dark variant strategy", strategy, STRATEGIES);
+	if (strategy === "mirror") return [...scale].reverse();
+	if (strategy === "tone-swap") return scale.map((c) => {
+		const [, chroma, hue] = require_parse.componentsIn(c, "oklch");
+		return withAlpha(require_tone.toneColor(100 - require_tone.lstar(c), chroma, hue ?? 0, gamut), c);
+	});
+	const oklch = scale.map((c) => require_parse.componentsIn(c, "oklch"));
+	const ls = oklch.map((c) => c[0]);
+	const sum = Math.min(...ls) + Math.max(...ls);
+	return scale.map((c, i) => {
+		const [l, chroma, hue] = oklch[i];
+		return withAlpha(require_parse.toGamut({
+			colorSpace: "oklch",
+			components: [
+				sum - l,
+				chroma * .9,
+				hue
+			]
+		}, { gamut }), c);
+	});
+}
+function withAlpha(color, from) {
+	return from.alpha === void 0 ? color : {
+		...color,
+		alpha: from.alpha
+	};
+}
+// src/palette/harmony.ts
+/** The hue rotations, in degrees, that each scheme adds to the base color. */
+const SCHEMES = {
+	__proto__: null,
+	complementary: [0, 180],
+	split: [
+		0,
+		150,
+		210
+	],
+	analogous: [
+		-30,
+		0,
+		30
+	],
+	triadic: [
+		0,
+		120,
+		240
+	],
+	tetradic: [
+		0,
+		90,
+		180,
+		270
+	]
+};
+const HUE_SPACES = [
+	"oklch",
+	"lch",
+	"hsl",
+	"hwb"
+];
+const hueIndex = (space) => space === "hsl" || space === "hwb" ? 0 : 2;
+/**
+* The colors of a harmony: `color` rotated around the hue wheel of `space`,
+* with lightness and chroma held, in the order of the scheme's angles
+* (`complementary` 0 and 180; `split` 0, 150, 210; `analogous` -30, 0, 30;
+* `triadic` 0, 120, 240; `tetradic` 0, 90, 180, 270). The color itself is the
+* entry at angle 0, returned as given. Rotated colors are mapped into `gamut`.
+* The same angle looks different in `hsl` and `oklch`, so name the space.
+*/
+function harmony(color, scheme, options = {}) {
+	const { space = "oklch", gamut = "srgb" } = options;
+	const angles = SCHEMES[scheme];
+	if (!angles) throw require_parse.unknownName("harmony scheme", scheme, Object.keys(SCHEMES));
+	if (!HUE_SPACES.includes(space)) throw require_parse.unknownName("harmony space", space, HUE_SPACES);
+	const base = require_parse.toColor(color);
+	const inSpace = require_parse.convert(base, space);
+	const at = hueIndex(space);
+	const hue = inSpace.components[at] ?? 0;
+	return angles.map((angle) => {
+		if (angle === 0) return base;
+		const components = [...inSpace.components];
+		components[at] = require_parse.normalizeHue(hue + angle);
+		return require_parse.toGamut({
+			...inSpace,
+			components
+		}, { gamut });
+	});
+}
+/**
+* Nudges `color`'s hue toward `toward`, as Material's `Blend.harmonize` does:
+* by half the hue difference, but at most 15 degrees, in OKLCH, keeping
+* lightness and chroma. Use it to make a status color feel at home with a
+* brand color without changing its meaning.
+*/
+function harmonize(color, toward, options = {}) {
+	const { max = 15, factor = .5, gamut = "srgb" } = options;
+	const from = require_parse.convert(require_parse.toColor(color), "oklch");
+	const to = require_parse.convert(require_parse.toColor(toward), "oklch");
+	const h0 = from.components[2] ?? 0;
+	const h1 = to.components[2] ?? h0;
+	const diff = require_parse.normalizeHue(h1 - h0 + 180) - 180;
+	const rotation = Math.min(Math.abs(diff) * factor, max) * Math.sign(diff);
+	const components = [...from.components];
+	components[2] = require_parse.normalizeHue(h0 + rotation);
+	return require_parse.toGamut({
+		...from,
+		components
+	}, { gamut });
+}
+/**
+* The opposite of a color. `lightness` flips OKLCH lightness (L becomes 1 - L)
+* and keeps hue and chroma, so light turns dark without changing its hue;
+* `rgb` inverts each sRGB channel, which also turns the hue to its complement.
+* Alpha is kept. The result is mapped into sRGB.
+*/
+function inverse(color, mode = "lightness") {
+	const base = require_parse.toColor(color);
+	if (mode === "rgb") {
+		const c = require_parse.convert(base, "srgb");
+		return require_parse.toGamut({
+			...c,
+			components: c.components.map((x) => 1 - x)
+		});
+	}
+	const c = require_parse.convert(base, "oklch");
+	return require_parse.toGamut({
+		...c,
+		components: [
+			1 - c.components[0],
+			c.components[1],
+			c.components[2]
+		]
+	});
+}
+// src/palette/semantic.ts
+const BG_TONE = {
+	primary: [40, 80],
+	primaryContainer: [90, 30],
+	surface: [98, 6],
+	surfaceVariant: [90, 30]
+};
+const FG_TONE = {
+	primary: [100, 20],
+	primaryContainer: [10, 90],
+	surface: [10, 90],
+	surfaceVariant: [30, 80]
+};
+const STATUS = {
+	success: 145,
+	warning: 85,
+	danger: 25,
+	info: 240
+};
+/**
+* A role-based palette from one brand color: primary and its container, four
+* status colors (success, warning, danger, info) harmonized toward the brand's
+* hue, a surface and a variant tinted by the brand hue, and an outline. Every
+* pair is built from L* tones, so a 50-tone gap or more reaches about 4.5 on
+* WCAG 2 (the worst pair, 100 on 50, gives 4.48). Each pair records the ratio
+* it reached; a foreground that falls short of `target` is replaced by the
+* closest one that meets it, and `validate` reports any that cannot.
+*/
+function semanticPalette(options) {
+	const { mode = "light", contrast = "wcag2", target = 4.5, gamut = "srgb" } = options;
+	const fn = require_contrast.pick(contrast);
+	const dark = require_parse.checkMode(mode) === "dark";
+	const i = dark ? 1 : 0;
+	const brand = require_parse.toColor(options.brand);
+	const [, c, h] = require_parse.componentsIn(brand, "oklch");
+	const hue = h ?? 0;
+	const chroma = Math.max(c, .04);
+	const tint = .015;
+	const pair = (bg, fgTone, fgChroma, need = target) => {
+		let fg = require_tone.toneColor(fgTone, fgChroma, hue, gamut);
+		let ratio = Math.abs(fn(fg, bg));
+		if (ratio < need) {
+			const found = require_contrast.findContrast(bg, need, {
+				contrast: fn,
+				chroma: fgChroma,
+				hue
+			});
+			fg = found.color;
+			ratio = Math.abs(found.contrast);
+		}
+		return {
+			bg,
+			fg,
+			ratio,
+			target: need
+		};
+	};
+	const status = (name) => {
+		const base = require_tone.toneColor(BG_TONE.primary[i], .14, STATUS[name], gamut);
+		return pair(harmonize(base, brand, { gamut }), FG_TONE.primary[i], .02);
+	};
+	const surface = require_tone.toneColor(BG_TONE.surface[i], tint, hue, gamut);
+	const outline = pair(surface, dark ? 60 : 50, tint, 3);
+	return {
+		meta: {
+			mode,
+			contrast: fn.algorithm ?? "custom",
+			target,
+			gamut
+		},
+		scales: {
+			primary: require_tone.tonalPalette(hue, chroma, void 0, { gamut }),
+			neutral: require_tone.tonalPalette(hue, tint, void 0, { gamut })
+		},
+		roles: {
+			primary: pair(require_tone.toneColor(BG_TONE.primary[i], chroma, hue, gamut), FG_TONE.primary[i], .02),
+			primaryContainer: pair(require_tone.toneColor(BG_TONE.primaryContainer[i], chroma, hue, gamut), FG_TONE.primaryContainer[i], .02),
+			success: status("success"),
+			warning: status("warning"),
+			danger: status("danger"),
+			info: status("info"),
+			surface: pair(surface, FG_TONE.surface[i], tint),
+			surfaceVariant: pair(require_tone.toneColor(BG_TONE.surfaceVariant[i], tint, hue, gamut), FG_TONE.surfaceVariant[i], tint),
+			outline
+		}
+	};
+}
+// src/palette/validate.ts
+/**
+* Checks a palette and lists what is wrong, so an agent can fix it:
+* - `contrast`: a role pair whose measured contrast is under its target;
+* - `lightness`: a scale whose OKLCH lightness does not change steadily in one
+*   direction from one step to the next;
+* - `gamut`: a color outside the gamut (it would be clipped on display).
+*/
+function validate(palette, options = {}) {
+	const { contrast = "wcag2", target = 4.5, gamut = "srgb" } = options;
+	const fn = require_contrast.pick(contrast);
+	const issues = [];
+	const outside = (path, color) => {
+		if (!require_parse.inGamut(color, gamut)) issues.push({
+			kind: "gamut",
+			path,
+			message: `${path} is outside ${gamut}`
+		});
+	};
+	for (const [name, p] of Object.entries(palette.roles ?? {})) {
+		const need = p.target ?? target;
+		const ratio = Math.abs(fn(p.fg, p.bg));
+		if (ratio < need) issues.push({
+			kind: "contrast",
+			path: `roles.${name}`,
+			message: `roles.${name} reaches ${ratio.toFixed(2)}, needs ${need}`
+		});
+		outside(`roles.${name}.bg`, p.bg);
+		outside(`roles.${name}.fg`, p.fg);
+	}
+	for (const [name, scale] of Object.entries(palette.scales ?? {})) {
+		const ls = scale.map((c) => require_parse.componentsIn(c, "oklch")[0]);
+		const steps = ls.slice(1).map((l, k) => l - ls[k]);
+		const direction = Math.sign(steps.find((d) => d !== 0) ?? 0);
+		steps.forEach((d, k) => {
+			if (Math.sign(d) !== direction || Math.abs(d) < 1e-9) issues.push({
+				kind: "lightness",
+				path: `scales.${name}[${k + 1}]`,
+				message: `scales.${name} lightness does not change steadily at step ${k + 1}`
+			});
+		});
+		scale.forEach((c, k) => {
+			outside(`scales.${name}[${k}]`, c);
+		});
+	}
+	return {
+		ok: issues.length === 0,
+		issues
+	};
+}
+Object.defineProperty(exports, "darkVariant", {
+	enumerable: true,
+	get: function() {
+		return darkVariant;
+	}
+});
+Object.defineProperty(exports, "harmonize", {
+	enumerable: true,
+	get: function() {
+		return harmonize;
+	}
+});
+Object.defineProperty(exports, "harmony", {
+	enumerable: true,
+	get: function() {
+		return harmony;
+	}
+});
+Object.defineProperty(exports, "inverse", {
+	enumerable: true,
+	get: function() {
+		return inverse;
+	}
+});
+Object.defineProperty(exports, "semanticPalette", {
+	enumerable: true,
+	get: function() {
+		return semanticPalette;
+	}
+});
+Object.defineProperty(exports, "validate", {
+	enumerable: true,
+	get: function() {
+		return validate;
+	}
+});
+
+//# sourceMappingURL=palette-DyFV_KoJ.js.map

package/cjs/palette-DyFV_KoJ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette-DyFV_KoJ.js","names":["unknownName","componentsIn","toneColor","lstar","toGamut","unknownName","toColor","convert","normalizeHue","toGamut","pick","checkMode","toColor","componentsIn","toneColor","findContrast","tonalPalette","pick","inGamut","componentsIn"],"sources":["../src/palette/dark.ts","../src/palette/harmony.ts","../src/palette/semantic.ts","../src/palette/validate.ts"],"sourcesContent":["import { type GamutId, toGamut } from '../color/gamut.js'\nimport { componentsIn } from '../color/spaces.js'\nimport type { Color } from '../color/types.js'\nimport { unknownName } from '../color/unknown-name.js'\nimport { lstar, toneColor } from '../scale/tone.js'\n\n/** How `darkVariant` builds a dark scale from a light one: `mirror`, `tone-swap` or `lightness-invert`. */\nexport type DarkStrategy = 'mirror' | 'tone-swap' | 'lightness-invert'\n\nconst STRATEGIES: readonly string[] = ['mirror', 'tone-swap', 'lightness-invert']\n\n/** Options for `darkVariant`. */\nexport interface DarkVariantOptions {\n\t/** The gamut every color must fit. Default `srgb`. */\n\tgamut?: GamutId\n}\n\n/**\n * A dark version of a light scale (ordered light to dark), with the same\n * number of steps.\n * - `mirror`: step n takes the color of step N+1-n, so the scale runs dark to\n *   light and step 1 is the old last step. Colors are unchanged.\n * - `tone-swap`: each color keeps its OKLCH hue and chroma and takes the CIE\n *   L* tone 100 minus its own, as Material swaps tone 40 for 80. Contrast\n *   between two steps is kept roughly the same.\n * - `lightness-invert`: OKLCH lightness is reflected within the scale's own\n *   range, keeping step order, with chroma eased by 10% to curb vibration on\n *   dark backgrounds.\n */\nexport function darkVariant(\n\tscale: readonly Color[],\n\tstrategy: DarkStrategy = 'tone-swap',\n\toptions: DarkVariantOptions = {}\n): Color[] {\n\tconst { gamut = 'srgb' } = options\n\tif (!STRATEGIES.includes(strategy)) throw unknownName('dark variant strategy', strategy, STRATEGIES)\n\tif (strategy === 'mirror') return [...scale].reverse()\n\tif (strategy === 'tone-swap') {\n\t\treturn scale.map((c) => {\n\t\t\tconst [, chroma, hue] = componentsIn(c, 'oklch') as [number, number, number | null]\n\t\t\treturn withAlpha(toneColor(100 - lstar(c), chroma, hue ?? 0, gamut), c)\n\t\t})\n\t}\n\tconst oklch = scale.map((c) => componentsIn(c, 'oklch') as [number, number, number | null])\n\tconst ls = oklch.map((c) => c[0])\n\tconst sum = Math.min(...ls) + Math.max(...ls)\n\treturn scale.map((c, i) => {\n\t\tconst [l, chroma, hue] = oklch[i] as [number, number, number | null]\n\t\treturn withAlpha(toGamut({ colorSpace: 'oklch', components: [sum - l, chroma * 0.9, hue] }, { gamut }), c)\n\t})\n}\n\nfunction withAlpha(color: Color, from: Color): Color {\n\treturn from.alpha === undefined ? color : { ...color, alpha: from.alpha }\n}\n","import { type GamutId, toGamut } from '../color/gamut.js'\nimport { normalizeHue } from '../color/math.js'\nimport { toColor } from '../color/parse.js'\nimport { convert } from '../color/spaces.js'\nimport type { Color } from '../color/types.js'\nimport { unknownName } from '../color/unknown-name.js'\n\ntype ColorInput = Color | string\n\n/** The hue rotations, in degrees, that each scheme adds to the base color. */\nconst SCHEMES = {\n\t__proto__: null,\n\tcomplementary: [0, 180],\n\tsplit: [0, 150, 210],\n\tanalogous: [-30, 0, 30],\n\ttriadic: [0, 120, 240],\n\ttetradic: [0, 90, 180, 270]\n} as const\n\n/** A harmony scheme `harmony` accepts: `complementary`, `split`, `analogous`, `triadic` or `tetradic`. */\nexport type HarmonyScheme = keyof typeof SCHEMES\n\n/** Spaces with a hue channel that a scheme can rotate in. */\nexport type HarmonySpace = 'oklch' | 'lch' | 'hsl' | 'hwb'\n\n/** Options for `harmony`. */\nexport interface HarmonyOptions {\n\t/** The space whose hue is rotated. Default `oklch`, which keeps perceived lightness steady. */\n\tspace?: HarmonySpace\n\t/** The gamut every color must fit. Default `srgb`. */\n\tgamut?: GamutId\n}\n\nconst HUE_SPACES: readonly string[] = ['oklch', 'lch', 'hsl', 'hwb']\n\nconst hueIndex = (space: HarmonySpace): number => (space === 'hsl' || space === 'hwb' ? 0 : 2)\n\n/**\n * The colors of a harmony: `color` rotated around the hue wheel of `space`,\n * with lightness and chroma held, in the order of the scheme's angles\n * (`complementary` 0 and 180; `split` 0, 150, 210; `analogous` -30, 0, 30;\n * `triadic` 0, 120, 240; `tetradic` 0, 90, 180, 270). The color itself is the\n * entry at angle 0, returned as given. Rotated colors are mapped into `gamut`.\n * The same angle looks different in `hsl` and `oklch`, so name the space.\n */\nexport function harmony(color: ColorInput, scheme: HarmonyScheme, options: HarmonyOptions = {}): Color[] {\n\tconst { space = 'oklch', gamut = 'srgb' } = options\n\tconst angles = SCHEMES[scheme]\n\tif (!angles) throw unknownName('harmony scheme', scheme, Object.keys(SCHEMES))\n\tif (!HUE_SPACES.includes(space)) throw unknownName('harmony space', space, HUE_SPACES)\n\tconst base = toColor(color)\n\tconst inSpace = convert(base, space)\n\tconst at = hueIndex(space)\n\tconst hue = (inSpace.components[at] as number | null) ?? 0\n\treturn angles.map((angle) => {\n\t\tif (angle === 0) return base\n\t\tconst components = [...inSpace.components]\n\t\tcomponents[at] = normalizeHue(hue + angle)\n\t\treturn toGamut({ ...inSpace, components }, { gamut })\n\t})\n}\n\n/** Options for `harmonize`. */\nexport interface HarmonizeOptions {\n\t/** The most the hue may move, in degrees. Default 15. */\n\tmax?: number\n\t/** The share of the hue difference to move. Default 0.5. */\n\tfactor?: number\n\t/** The gamut the result must fit. Default `srgb`. */\n\tgamut?: GamutId\n}\n\n/**\n * Nudges `color`'s hue toward `toward`, as Material's `Blend.harmonize` does:\n * by half the hue difference, but at most 15 degrees, in OKLCH, keeping\n * lightness and chroma. Use it to make a status color feel at home with a\n * brand color without changing its meaning.\n */\nexport function harmonize(color: ColorInput, toward: ColorInput, options: HarmonizeOptions = {}): Color {\n\tconst { max = 15, factor = 0.5, gamut = 'srgb' } = options\n\tconst from = convert(toColor(color), 'oklch')\n\tconst to = convert(toColor(toward), 'oklch')\n\tconst h0 = (from.components[2] as number | null) ?? 0\n\tconst h1 = (to.components[2] as number | null) ?? h0\n\t// Signed shortest way round, -180 to 180.\n\tconst diff = normalizeHue(h1 - h0 + 180) - 180\n\tconst rotation = Math.min(Math.abs(diff) * factor, max) * Math.sign(diff)\n\tconst components = [...from.components]\n\tcomponents[2] = normalizeHue(h0 + rotation)\n\treturn toGamut({ ...from, components }, { gamut })\n}\n\n/**\n * The opposite of a color. `lightness` flips OKLCH lightness (L becomes 1 - L)\n * and keeps hue and chroma, so light turns dark without changing its hue;\n * `rgb` inverts each sRGB channel, which also turns the hue to its complement.\n * Alpha is kept. The result is mapped into sRGB.\n */\nexport function inverse(color: ColorInput, mode: 'lightness' | 'rgb' = 'lightness'): Color {\n\tconst base = toColor(color)\n\tif (mode === 'rgb') {\n\t\tconst c = convert(base, 'srgb')\n\t\treturn toGamut({ ...c, components: c.components.map((x) => 1 - (x as number)) })\n\t}\n\tconst c = convert(base, 'oklch')\n\treturn toGamut({ ...c, components: [1 - (c.components[0] as number), c.components[1], c.components[2]] })\n}\n","import { type ContrastOption, findContrast, pick } from '../color/contrast.js'\nimport type { GamutId } from '../color/gamut.js'\nimport { toColor } from '../color/parse.js'\nimport { componentsIn } from '../color/spaces.js'\nimport type { Color } from '../color/types.js'\nimport { checkMode } from '../color/unknown-name.js'\nimport { tonalPalette, toneColor } from '../scale/tone.js'\nimport { harmonize } from './harmony.js'\n\n/** A background, the foreground drawn on it, and the contrast they reach. */\nexport interface RolePair {\n\tbg: Color\n\tfg: Color\n\t/** The contrast of `fg` on `bg`, as the algorithm reports it (absolute value). */\n\tratio: number\n\t/** The contrast the pair was built to reach. */\n\ttarget: number\n}\n\n/** Options for `semanticPalette`. Only `brand` is required. */\nexport interface SemanticPaletteOptions {\n\t/** The brand color; it sets the hue of the primary, the neutrals and the harmonized status colors. */\n\tbrand: Color | string\n\t/** Default `light`. */\n\tmode?: 'light' | 'dark'\n\t/** The contrast measure. Default `wcag2`. */\n\tcontrast?: ContrastOption\n\t/** The contrast text pairs must reach. Default 4.5, which fits WCAG 2 (pass about 60 for APCA Lc). */\n\ttarget?: number\n\t/** The gamut every color must fit. Default `srgb`. */\n\tgamut?: GamutId\n}\n\n/** A role in a {@link SemanticPalette}. Each role holds a {@link RolePair}. */\nexport type SemanticRole =\n\t| 'primary'\n\t| 'primaryContainer'\n\t| 'success'\n\t| 'warning'\n\t| 'danger'\n\t| 'info'\n\t| 'surface'\n\t| 'surfaceVariant'\n\t| 'outline'\n\n/** What `semanticPalette` returns: the settings it used, the tonal scales it built from, and a pair for each role. */\nexport interface SemanticPalette {\n\tmeta: { mode: 'light' | 'dark'; contrast: string; target: number; gamut: GamutId }\n\t/** Material's 13 tones, dark to light, in the brand's hue (`primary`) and a faint tint of it (`neutral`). */\n\tscales: { primary: Color[]; neutral: Color[] }\n\troles: Record<SemanticRole, RolePair>\n}\n\n// Tones (light, dark) per role: Material's 2021 assignments (see the research notes, B-palettes).\nconst BG_TONE = { primary: [40, 80], primaryContainer: [90, 30], surface: [98, 6], surfaceVariant: [90, 30] } as const\nconst FG_TONE = { primary: [100, 20], primaryContainer: [10, 90], surface: [10, 90], surfaceVariant: [30, 80] } as const\n\n// OKLCH hues of the status colors, before they are harmonized toward the brand.\nconst STATUS = { success: 145, warning: 85, danger: 25, info: 240 } as const\n\n/**\n * A role-based palette from one brand color: primary and its container, four\n * status colors (success, warning, danger, info) harmonized toward the brand's\n * hue, a surface and a variant tinted by the brand hue, and an outline. Every\n * pair is built from L* tones, so a 50-tone gap or more reaches about 4.5 on\n * WCAG 2 (the worst pair, 100 on 50, gives 4.48). Each pair records the ratio\n * it reached; a foreground that falls short of `target` is replaced by the\n * closest one that meets it, and `validate` reports any that cannot.\n */\nexport function semanticPalette(options: SemanticPaletteOptions): SemanticPalette {\n\tconst { mode = 'light', contrast = 'wcag2', target = 4.5, gamut = 'srgb' } = options\n\tconst fn = pick(contrast)\n\tconst dark = checkMode(mode) === 'dark'\n\tconst i = dark ? 1 : 0\n\tconst brand = toColor(options.brand)\n\tconst [, c, h] = componentsIn(brand, 'oklch') as [number, number, number | null]\n\tconst hue = h ?? 0\n\tconst chroma = Math.max(c, 0.04)\n\tconst tint = 0.015\n\n\tconst pair = (bg: Color, fgTone: number, fgChroma: number, need = target): RolePair => {\n\t\tlet fg = toneColor(fgTone, fgChroma, hue, gamut)\n\t\tlet ratio = Math.abs(fn(fg, bg))\n\t\tif (ratio < need) {\n\t\t\tconst found = findContrast(bg, need, { contrast: fn, chroma: fgChroma, hue })\n\t\t\tfg = found.color\n\t\t\tratio = Math.abs(found.contrast)\n\t\t}\n\t\treturn { bg, fg, ratio, target: need }\n\t}\n\tconst status = (name: keyof typeof STATUS): RolePair => {\n\t\tconst base = toneColor(BG_TONE.primary[i], 0.14, STATUS[name], gamut)\n\t\treturn pair(harmonize(base, brand, { gamut }), FG_TONE.primary[i], 0.02)\n\t}\n\tconst surface = toneColor(BG_TONE.surface[i], tint, hue, gamut)\n\tconst outline = pair(surface, dark ? 60 : 50, tint, 3)\n\n\treturn {\n\t\tmeta: { mode, contrast: fn.algorithm ?? 'custom', target, gamut },\n\t\tscales: {\n\t\t\tprimary: tonalPalette(hue, chroma, undefined, { gamut }),\n\t\t\tneutral: tonalPalette(hue, tint, undefined, { gamut })\n\t\t},\n\t\troles: {\n\t\t\tprimary: pair(toneColor(BG_TONE.primary[i], chroma, hue, gamut), FG_TONE.primary[i], 0.02),\n\t\t\tprimaryContainer: pair(\n\t\t\t\ttoneColor(BG_TONE.primaryContainer[i], chroma, hue, gamut),\n\t\t\t\tFG_TONE.primaryContainer[i],\n\t\t\t\t0.02\n\t\t\t),\n\t\t\tsuccess: status('success'),\n\t\t\twarning: status('warning'),\n\t\t\tdanger: status('danger'),\n\t\t\tinfo: status('info'),\n\t\t\tsurface: pair(surface, FG_TONE.surface[i], tint),\n\t\t\tsurfaceVariant: pair(toneColor(BG_TONE.surfaceVariant[i], tint, hue, gamut), FG_TONE.surfaceVariant[i], tint),\n\t\t\toutline\n\t\t}\n\t}\n}\n","import { type ContrastOption, pick } from '../color/contrast.js'\nimport { type GamutId, inGamut } from '../color/gamut.js'\nimport { componentsIn } from '../color/spaces.js'\nimport type { Color } from '../color/types.js'\nimport type { RolePair } from './semantic.js'\n\n/** What `validate` accepts: a {@link SemanticPalette}, or any object with role pairs and/or scales. */\nexport interface PaletteLike {\n\troles?: Record<string, RolePair>\n\tscales?: Record<string, readonly Color[]>\n}\n\n/** Options for `validate`. */\nexport interface ValidateOptions {\n\t/** The measure used to re-check each pair. Default `wcag2`. */\n\tcontrast?: ContrastOption\n\t/** The target for a pair that carries none. Default 4.5. */\n\ttarget?: number\n\t/** The gamut colors must fit; a color outside it was clipped or never mapped. Default `srgb`. */\n\tgamut?: GamutId\n}\n\n/** One problem `validate` found in a palette. */\nexport interface PaletteIssue {\n\tkind: 'contrast' | 'lightness' | 'gamut'\n\t/** Where: `roles.danger`, `scales.primary[3]`. */\n\tpath: string\n\tmessage: string\n}\n\n/** What `validate` returns: `ok` is true when `issues` is empty. */\nexport interface ValidateResult {\n\tok: boolean\n\tissues: PaletteIssue[]\n}\n\n/**\n * Checks a palette and lists what is wrong, so an agent can fix it:\n * - `contrast`: a role pair whose measured contrast is under its target;\n * - `lightness`: a scale whose OKLCH lightness does not change steadily in one\n *   direction from one step to the next;\n * - `gamut`: a color outside the gamut (it would be clipped on display).\n */\nexport function validate(palette: PaletteLike, options: ValidateOptions = {}): ValidateResult {\n\tconst { contrast = 'wcag2', target = 4.5, gamut = 'srgb' } = options\n\tconst fn = pick(contrast)\n\tconst issues: PaletteIssue[] = []\n\tconst outside = (path: string, color: Color) => {\n\t\tif (!inGamut(color, gamut)) issues.push({ kind: 'gamut', path, message: `${path} is outside ${gamut}` })\n\t}\n\n\tfor (const [name, p] of Object.entries(palette.roles ?? {})) {\n\t\tconst need = p.target ?? target\n\t\tconst ratio = Math.abs(fn(p.fg, p.bg))\n\t\tif (ratio < need)\n\t\t\tissues.push({\n\t\t\t\tkind: 'contrast',\n\t\t\t\tpath: `roles.${name}`,\n\t\t\t\tmessage: `roles.${name} reaches ${ratio.toFixed(2)}, needs ${need}`\n\t\t\t})\n\t\toutside(`roles.${name}.bg`, p.bg)\n\t\toutside(`roles.${name}.fg`, p.fg)\n\t}\n\n\tfor (const [name, scale] of Object.entries(palette.scales ?? {})) {\n\t\tconst ls = scale.map((c) => componentsIn(c, 'oklch')[0] as number)\n\t\tconst steps = ls.slice(1).map((l, k) => l - (ls[k] as number))\n\t\tconst direction = Math.sign(steps.find((d) => d !== 0) ?? 0)\n\t\tsteps.forEach((d, k) => {\n\t\t\tif (Math.sign(d) !== direction || Math.abs(d) < 1e-9)\n\t\t\t\tissues.push({\n\t\t\t\t\tkind: 'lightness',\n\t\t\t\t\tpath: `scales.${name}[${k + 1}]`,\n\t\t\t\t\tmessage: `scales.${name} lightness does not change steadily at step ${k + 1}`\n\t\t\t\t})\n\t\t})\n\t\tscale.forEach((c, k) => {\n\t\t\toutside(`scales.${name}[${k}]`, c)\n\t\t})\n\t}\n\treturn { ok: issues.length === 0, issues }\n}\n"],"mappings":"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"}