@tenphi/glaze 0.0.0-snapshot.02f3ca5

package/dist/index.mjs

@@ -0,0 +1,2544 @@
+//#region src/okhsl-color-math.ts
+const OKLab_to_LMS_M = [
+	[
+		1,
+		.3963377773761749,
+		.2158037573099136
+	],
+	[
+		1,
+		-.1055613458156586,
+		-.0638541728258133
+	],
+	[
+		1,
+		-.0894841775298119,
+		-1.2914855480194092
+	]
+];
+const LMS_to_linear_sRGB_M = [
+	[
+		4.076741636075959,
+		-3.307711539258062,
+		.2309699031821041
+	],
+	[
+		-1.2684379732850313,
+		2.6097573492876878,
+		-.3413193760026569
+	],
+	[
+		-.004196076138675526,
+		-.703418617935936,
+		1.7076146940746113
+	]
+];
+const linear_sRGB_to_LMS_M = [
+	[
+		.4122214708,
+		.5363325363,
+		.0514459929
+	],
+	[
+		.2119034982,
+		.6806995451,
+		.1073969566
+	],
+	[
+		.0883024619,
+		.2817188376,
+		.6299787005
+	]
+];
+const LMS_to_OKLab_M = [
+	[
+		.2104542553,
+		.793617785,
+		-.0040720468
+	],
+	[
+		1.9779984951,
+		-2.428592205,
+		.4505937099
+	],
+	[
+		.0259040371,
+		.7827717662,
+		-.808675766
+	]
+];
+const OKLab_to_linear_sRGB_coefficients = [
+	[[-1.8817030993265873, -.8093650129914302], [
+		1.19086277,
+		1.76576728,
+		.59662641,
+		.75515197,
+		.56771245
+	]],
+	[[1.8144407988010998, -1.194452667805235], [
+		.73956515,
+		-.45954404,
+		.08285427,
+		.1254107,
+		.14503204
+	]],
+	[[.13110757611180954, 1.813339709266608], [
+		1.35733652,
+		-.00915799,
+		-1.1513021,
+		-.50559606,
+		.00692167
+	]]
+];
+const TAU = 2 * Math.PI;
+const K1 = .206;
+const K2 = .03;
+const K3 = (1 + K1) / (1 + K2);
+const EPSILON = 1e-10;
+const constrainAngle = (angle) => (angle % 360 + 360) % 360;
+const toe = (x) => .5 * (K3 * x - K1 + Math.sqrt((K3 * x - K1) * (K3 * x - K1) + 4 * K2 * K3 * x));
+const toeInv = (x) => (x ** 2 + K1 * x) / (K3 * (x + K2));
+const dot3 = (a, b) => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+const dotXY = (a, b) => a[0] * b[0] + a[1] * b[1];
+const transform = (input, matrix) => [
+	dot3(input, matrix[0]),
+	dot3(input, matrix[1]),
+	dot3(input, matrix[2])
+];
+const cubed3 = (lms) => [
+	lms[0] ** 3,
+	lms[1] ** 3,
+	lms[2] ** 3
+];
+const cbrt3 = (lms) => [
+	Math.cbrt(lms[0]),
+	Math.cbrt(lms[1]),
+	Math.cbrt(lms[2])
+];
+const clampVal = (v, min, max) => Math.max(min, Math.min(max, v));
+const OKLabToLinearSRGB = (lab) => {
+	return transform(cubed3(transform(lab, OKLab_to_LMS_M)), LMS_to_linear_sRGB_M);
+};
+const computeMaxSaturationOKLC = (a, b) => {
+	const okCoeff = OKLab_to_linear_sRGB_coefficients;
+	const lmsToRgb = LMS_to_linear_sRGB_M;
+	const tmp2 = [a, b];
+	const tmp3 = [
+		0,
+		a,
+		b
+	];
+	let chnlCoeff;
+	let chnlLMS;
+	if (dotXY(okCoeff[0][0], tmp2) > 1) {
+		chnlCoeff = okCoeff[0][1];
+		chnlLMS = lmsToRgb[0];
+	} else if (dotXY(okCoeff[1][0], tmp2) > 1) {
+		chnlCoeff = okCoeff[1][1];
+		chnlLMS = lmsToRgb[1];
+	} else {
+		chnlCoeff = okCoeff[2][1];
+		chnlLMS = lmsToRgb[2];
+	}
+	const [k0, k1, k2, k3, k4] = chnlCoeff;
+	const [wl, wm, ws] = chnlLMS;
+	let sat = k0 + k1 * a + k2 * b + k3 * (a * a) + k4 * a * b;
+	const dotYZ = (mat, vec) => mat[1] * vec[1] + mat[2] * vec[2];
+	const kl = dotYZ(OKLab_to_LMS_M[0], tmp3);
+	const km = dotYZ(OKLab_to_LMS_M[1], tmp3);
+	const ks = dotYZ(OKLab_to_LMS_M[2], tmp3);
+	const l_ = 1 + sat * kl;
+	const m_ = 1 + sat * km;
+	const s_ = 1 + sat * ks;
+	const l = l_ ** 3;
+	const m = m_ ** 3;
+	const s = s_ ** 3;
+	const lds = 3 * kl * l_ * l_;
+	const mds = 3 * km * m_ * m_;
+	const sds = 3 * ks * s_ * s_;
+	const lds2 = 6 * kl * kl * l_;
+	const mds2 = 6 * km * km * m_;
+	const sds2 = 6 * ks * ks * s_;
+	const f = wl * l + wm * m + ws * s;
+	const f1 = wl * lds + wm * mds + ws * sds;
+	const f2 = wl * lds2 + wm * mds2 + ws * sds2;
+	sat = sat - f * f1 / (f1 * f1 - .5 * f * f2);
+	return sat;
+};
+const findCuspOKLCH = (a, b) => {
+	const S_cusp = computeMaxSaturationOKLC(a, b);
+	const rgb_at_max = OKLabToLinearSRGB([
+		1,
+		S_cusp * a,
+		S_cusp * b
+	]);
+	const L_cusp = Math.cbrt(1 / Math.max(Math.max(rgb_at_max[0], rgb_at_max[1]), Math.max(rgb_at_max[2], 0)));
+	return [L_cusp, L_cusp * S_cusp];
+};
+const findGamutIntersectionOKLCH = (a, b, l1, c1, l0, cusp) => {
+	const lmsToRgb = LMS_to_linear_sRGB_M;
+	const tmp3 = [
+		0,
+		a,
+		b
+	];
+	const floatMax = Number.MAX_VALUE;
+	let t;
+	const dotYZ = (mat, vec) => mat[1] * vec[1] + mat[2] * vec[2];
+	const dotXYZ = (vec, x, y, z) => vec[0] * x + vec[1] * y + vec[2] * z;
+	if ((l1 - l0) * cusp[1] - (cusp[0] - l0) * c1 <= 0) {
+		const denom = c1 * cusp[0] + cusp[1] * (l0 - l1);
+		t = denom === 0 ? 0 : cusp[1] * l0 / denom;
+	} else {
+		const denom = c1 * (cusp[0] - 1) + cusp[1] * (l0 - l1);
+		t = denom === 0 ? 0 : cusp[1] * (l0 - 1) / denom;
+		const dl = l1 - l0;
+		const dc = c1;
+		const kl = dotYZ(OKLab_to_LMS_M[0], tmp3);
+		const km = dotYZ(OKLab_to_LMS_M[1], tmp3);
+		const ks = dotYZ(OKLab_to_LMS_M[2], tmp3);
+		const L = l0 * (1 - t) + t * l1;
+		const C = t * c1;
+		const l_ = L + C * kl;
+		const m_ = L + C * km;
+		const s_ = L + C * ks;
+		const l = l_ ** 3;
+		const m = m_ ** 3;
+		const s = s_ ** 3;
+		const ldt = 3 * (dl + dc * kl) * l_ * l_;
+		const mdt = 3 * (dl + dc * km) * m_ * m_;
+		const sdt = 3 * (dl + dc * ks) * s_ * s_;
+		const ldt2 = 6 * (dl + dc * kl) ** 2 * l_;
+		const mdt2 = 6 * (dl + dc * km) ** 2 * m_;
+		const sdt2 = 6 * (dl + dc * ks) ** 2 * s_;
+		const r_ = dotXYZ(lmsToRgb[0], l, m, s) - 1;
+		const r1 = dotXYZ(lmsToRgb[0], ldt, mdt, sdt);
+		const r2 = dotXYZ(lmsToRgb[0], ldt2, mdt2, sdt2);
+		const ur = r1 / (r1 * r1 - .5 * r_ * r2);
+		let tr = -r_ * ur;
+		const g_ = dotXYZ(lmsToRgb[1], l, m, s) - 1;
+		const g1 = dotXYZ(lmsToRgb[1], ldt, mdt, sdt);
+		const g2 = dotXYZ(lmsToRgb[1], ldt2, mdt2, sdt2);
+		const ug = g1 / (g1 * g1 - .5 * g_ * g2);
+		let tg = -g_ * ug;
+		const b_ = dotXYZ(lmsToRgb[2], l, m, s) - 1;
+		const b1 = dotXYZ(lmsToRgb[2], ldt, mdt, sdt);
+		const b2 = dotXYZ(lmsToRgb[2], ldt2, mdt2, sdt2);
+		const ub = b1 / (b1 * b1 - .5 * b_ * b2);
+		let tb = -b_ * ub;
+		tr = ur >= 0 ? tr : floatMax;
+		tg = ug >= 0 ? tg : floatMax;
+		tb = ub >= 0 ? tb : floatMax;
+		t += Math.min(tr, Math.min(tg, tb));
+	}
+	return t;
+};
+const computeSt = (cusp) => [cusp[1] / cusp[0], cusp[1] / (1 - cusp[0])];
+const computeStMid = (a, b) => [.11516993 + 1 / (7.4477897 + 4.1590124 * b + a * (-2.19557347 + 1.75198401 * b + a * (-2.13704948 - 10.02301043 * b + a * (-4.24894561 + 5.38770819 * b + 4.69891013 * a)))), .11239642 + 1 / (1.6132032 - .68124379 * b + a * (.40370612 + .90148123 * b + a * (-.27087943 + .6122399 * b + a * (.00299215 - .45399568 * b - .14661872 * a))))];
+const getCs = (L, a, b, cusp) => {
+	const cMax = findGamutIntersectionOKLCH(a, b, L, 1, L, cusp);
+	const stMax = computeSt(cusp);
+	const k = cMax / Math.min(L * stMax[0], (1 - L) * stMax[1]);
+	const stMid = computeStMid(a, b);
+	let ca = L * stMid[0];
+	let cb = (1 - L) * stMid[1];
+	const cMid = .9 * k * Math.sqrt(Math.sqrt(1 / (1 / ca ** 4 + 1 / cb ** 4)));
+	ca = L * .4;
+	cb = (1 - L) * .8;
+	return [
+		Math.sqrt(1 / (1 / ca ** 2 + 1 / cb ** 2)),
+		cMid,
+		cMax
+	];
+};
+/**
+* Convert OKHSL (h: 0–360, s: 0–1, l: 0–1) to OKLab [L, a, b].
+*/
+function okhslToOklab(h, s, l) {
+	const L = toeInv(l);
+	let a = 0;
+	let b = 0;
+	const hNorm = constrainAngle(h) / 360;
+	if (L !== 0 && L !== 1 && s !== 0) {
+		const a_ = Math.cos(TAU * hNorm);
+		const b_ = Math.sin(TAU * hNorm);
+		const [c0, cMid, cMax] = getCs(L, a_, b_, findCuspOKLCH(a_, b_));
+		const mid = .8;
+		const midInv = 1.25;
+		let t, k0, k1, k2;
+		if (s < mid) {
+			t = midInv * s;
+			k0 = 0;
+			k1 = mid * c0;
+			k2 = 1 - k1 / cMid;
+		} else {
+			t = 5 * (s - .8);
+			k0 = cMid;
+			k1 = .2 * cMid ** 2 * 1.25 ** 2 / c0;
+			k2 = 1 - k1 / (cMax - cMid);
+		}
+		const c = k0 + t * k1 / (1 - k2 * t);
+		a = c * a_;
+		b = c * b_;
+	}
+	return [
+		L,
+		a,
+		b
+	];
+}
+/**
+* Convert OKHSL (h: 0–360, s: 0–1, l: 0–1) to linear sRGB.
+* Channels may exceed [0, 1] near gamut boundaries — caller must clamp if needed.
+*/
+function okhslToLinearSrgb(h, s, l) {
+	return OKLabToLinearSRGB(okhslToOklab(h, s, l));
+}
+/**
+* Compute relative luminance Y from linear sRGB channels.
+* Per WCAG 2: Y = 0.2126·R + 0.7152·G + 0.0722·B
+*/
+function relativeLuminanceFromLinearRgb(rgb) {
+	return .2126 * rgb[0] + .7152 * rgb[1] + .0722 * rgb[2];
+}
+/**
+* WCAG 2 contrast ratio from two luminance values.
+*/
+function contrastRatioFromLuminance(yA, yB) {
+	const lighter = Math.max(yA, yB);
+	const darker = Math.min(yA, yB);
+	return (lighter + .05) / (darker + .05);
+}
+const sRGBLinearToGamma = (val) => {
+	const sign = val < 0 ? -1 : 1;
+	const abs = Math.abs(val);
+	return abs > .0031308 ? sign * (1.055 * Math.pow(abs, 1 / 2.4) - .055) : 12.92 * val;
+};
+const sRGBGammaToLinear = (val) => {
+	const sign = val < 0 ? -1 : 1;
+	const abs = Math.abs(val);
+	return abs <= .04045 ? val / 12.92 : sign * Math.pow((abs + .055) / 1.055, 2.4);
+};
+/**
+* Convert OKHSL to gamma-encoded sRGB (clamped to 0–1).
+*/
+function okhslToSrgb(h, s, l) {
+	const lin = okhslToLinearSrgb(h, s, l);
+	return [
+		Math.max(0, Math.min(1, sRGBLinearToGamma(lin[0]))),
+		Math.max(0, Math.min(1, sRGBLinearToGamma(lin[1]))),
+		Math.max(0, Math.min(1, sRGBLinearToGamma(lin[2])))
+	];
+}
+/**
+* Compute WCAG 2 relative luminance from linear sRGB, matching the browser
+* rendering pipeline: gamma-encode, clamp to sRGB gamut [0,1], then linearize.
+* This avoids over/under-estimating luminance for out-of-gamut OKHSL colors.
+*/
+function gamutClampedLuminance(linearRgb) {
+	const r = sRGBGammaToLinear(Math.max(0, Math.min(1, sRGBLinearToGamma(linearRgb[0]))));
+	const g = sRGBGammaToLinear(Math.max(0, Math.min(1, sRGBLinearToGamma(linearRgb[1]))));
+	const b = sRGBGammaToLinear(Math.max(0, Math.min(1, sRGBLinearToGamma(linearRgb[2]))));
+	return .2126 * r + .7152 * g + .0722 * b;
+}
+const linearSrgbToOklab = (rgb) => {
+	return transform(cbrt3(transform(rgb, linear_sRGB_to_LMS_M)), LMS_to_OKLab_M);
+};
+/**
+* Convert OKLab to OKHSL.
+* Input: [L, a, b] where L: 0–1, a/b: roughly -0.5 to 0.5.
+* Returns [h, s, l] where h: 0–360, s: 0–1, l: 0–1.
+*/
+const oklabToOkhsl = (lab) => {
+	const L = lab[0];
+	const a = lab[1];
+	const b = lab[2];
+	const C = Math.sqrt(a * a + b * b);
+	if (C < EPSILON) return [
+		0,
+		0,
+		toe(L)
+	];
+	const L_EXTREME_EPSILON = 1e-6;
+	if (L >= 1 - L_EXTREME_EPSILON || L <= L_EXTREME_EPSILON) return [
+		0,
+		0,
+		toe(L)
+	];
+	const a_ = a / C;
+	const b_ = b / C;
+	let h = Math.atan2(b, a) * (180 / Math.PI);
+	h = constrainAngle(h);
+	const [c0, cMid, cMax] = getCs(L, a_, b_, findCuspOKLCH(a_, b_));
+	const mid = .8;
+	const midInv = 1.25;
+	let s;
+	if (C < cMid) {
+		const k1 = mid * c0;
+		s = C / (k1 + C * (1 - k1 / cMid)) / midInv;
+	} else {
+		const k0 = cMid;
+		const k1 = .2 * cMid ** 2 * 1.25 ** 2 / c0;
+		const k2 = 1 - k1 / (cMax - cMid);
+		const cDiff = C - k0;
+		s = mid + cDiff / (k1 + cDiff * k2) / 5;
+	}
+	const l = toe(L);
+	return [
+		h,
+		clampVal(s, 0, 1),
+		clampVal(l, 0, 1)
+	];
+};
+/**
+* Convert gamma-encoded sRGB (0–1 per channel) to OKHSL.
+* Returns [h, s, l] where h: 0–360, s: 0–1, l: 0–1.
+*/
+function srgbToOkhsl(rgb) {
+	return oklabToOkhsl(linearSrgbToOklab([
+		sRGBGammaToLinear(rgb[0]),
+		sRGBGammaToLinear(rgb[1]),
+		sRGBGammaToLinear(rgb[2])
+	]));
+}
+/**
+* Convert CSS HSL (sRGB-based) to gamma-encoded sRGB [r, g, b] in 0–1 range.
+* h: 0–360, s: 0–1, l: 0–1.
+*
+* Note: CSS HSL is not the same as OKHSL — it's HSL in the sRGB color space.
+* Use this when parsing `hsl(...)` strings before passing to `srgbToOkhsl`.
+*/
+function hslToSrgb(h, s, l) {
+	const hh = (h % 360 + 360) % 360 / 360;
+	const ss = clampVal(s, 0, 1);
+	const ll = clampVal(l, 0, 1);
+	if (ss === 0) return [
+		ll,
+		ll,
+		ll
+	];
+	const q = ll < .5 ? ll * (1 + ss) : ll + ss - ll * ss;
+	const p = 2 * ll - q;
+	const hueToChannel = (t) => {
+		let tt = t;
+		if (tt < 0) tt += 1;
+		if (tt > 1) tt -= 1;
+		if (tt < 1 / 6) return p + (q - p) * 6 * tt;
+		if (tt < 1 / 2) return q;
+		if (tt < 2 / 3) return p + (q - p) * (2 / 3 - tt) * 6;
+		return p;
+	};
+	return [
+		hueToChannel(hh + 1 / 3),
+		hueToChannel(hh),
+		hueToChannel(hh - 1 / 3)
+	];
+}
+/**
+* Parse a hex color string (#rgb or #rrggbb) to sRGB [r, g, b] in 0–1 range.
+* Returns null if the string is not a valid hex color.
+*
+* For 8-digit hex (`#rrggbbaa`) and 4-digit hex (`#rgba`) with alpha,
+* use {@link parseHexAlpha}.
+*/
+function parseHex(hex) {
+	const result = parseHexAlpha(hex);
+	if (!result || result.alpha !== void 0) return null;
+	return result.rgb;
+}
+/**
+* Parse a hex color string (#rgb, #rrggbb, #rgba, or #rrggbbaa) to
+* sRGB [r, g, b] in 0–1 range plus an optional alpha (0–1).
+* Returns null if the string is not a valid hex color.
+*/
+function parseHexAlpha(hex) {
+	const h = hex.startsWith("#") ? hex.slice(1) : hex;
+	if (h.length === 3) {
+		const r = parseInt(h[0] + h[0], 16);
+		const g = parseInt(h[1] + h[1], 16);
+		const b = parseInt(h[2] + h[2], 16);
+		if (isNaN(r) || isNaN(g) || isNaN(b)) return null;
+		return { rgb: [
+			r / 255,
+			g / 255,
+			b / 255
+		] };
+	}
+	if (h.length === 4) {
+		const r = parseInt(h[0] + h[0], 16);
+		const g = parseInt(h[1] + h[1], 16);
+		const b = parseInt(h[2] + h[2], 16);
+		const a = parseInt(h[3] + h[3], 16);
+		if (isNaN(r) || isNaN(g) || isNaN(b) || isNaN(a)) return null;
+		return {
+			rgb: [
+				r / 255,
+				g / 255,
+				b / 255
+			],
+			alpha: a / 255
+		};
+	}
+	if (h.length === 6) {
+		const r = parseInt(h.slice(0, 2), 16);
+		const g = parseInt(h.slice(2, 4), 16);
+		const b = parseInt(h.slice(4, 6), 16);
+		if (isNaN(r) || isNaN(g) || isNaN(b)) return null;
+		return { rgb: [
+			r / 255,
+			g / 255,
+			b / 255
+		] };
+	}
+	if (h.length === 8) {
+		const r = parseInt(h.slice(0, 2), 16);
+		const g = parseInt(h.slice(2, 4), 16);
+		const b = parseInt(h.slice(4, 6), 16);
+		const a = parseInt(h.slice(6, 8), 16);
+		if (isNaN(r) || isNaN(g) || isNaN(b) || isNaN(a)) return null;
+		return {
+			rgb: [
+				r / 255,
+				g / 255,
+				b / 255
+			],
+			alpha: a / 255
+		};
+	}
+	return null;
+}
+function fmt$1(value, decimals) {
+	return parseFloat(value.toFixed(decimals)).toString();
+}
+/**
+* Format OKHSL values as a CSS `okhsl(H S% L%)` string.
+* h: 0–360, s: 0–100, l: 0–100 (percentage scale for s and l).
+*/
+function formatOkhsl(h, s, l) {
+	return `okhsl(${fmt$1(h, 2)} ${fmt$1(s, 2)}% ${fmt$1(l, 2)}%)`;
+}
+/**
+* Format OKHSL values as a CSS `rgb(R G B)` string.
+* Uses 2 decimal places to avoid 8-bit quantization contrast loss.
+* h: 0–360, s: 0–100, l: 0–100 (percentage scale for s and l).
+*/
+function formatRgb(h, s, l) {
+	const [r, g, b] = okhslToSrgb(h, s / 100, l / 100);
+	return `rgb(${parseFloat((r * 255).toFixed(2))} ${parseFloat((g * 255).toFixed(2))} ${parseFloat((b * 255).toFixed(2))})`;
+}
+/**
+* Format OKHSL values as a CSS `hsl(H S% L%)` string.
+* h: 0–360, s: 0–100, l: 0–100 (percentage scale for s and l).
+*/
+function formatHsl(h, s, l) {
+	const [r, g, b] = okhslToSrgb(h, s / 100, l / 100);
+	const max = Math.max(r, g, b);
+	const min = Math.min(r, g, b);
+	const delta = max - min;
+	let hh = 0;
+	let ss = 0;
+	const ll = (max + min) / 2;
+	if (delta > 0) {
+		ss = ll > .5 ? delta / (2 - max - min) : delta / (max + min);
+		if (max === r) hh = ((g - b) / delta + (g < b ? 6 : 0)) * 60;
+		else if (max === g) hh = ((b - r) / delta + 2) * 60;
+		else hh = ((r - g) / delta + 4) * 60;
+	}
+	return `hsl(${fmt$1(hh, 2)} ${fmt$1(ss * 100, 2)}% ${fmt$1(ll * 100, 2)}%)`;
+}
+/**
+* Format OKHSL values as a CSS `oklch(L C H)` string.
+* h: 0–360, s: 0–100, l: 0–100 (percentage scale for s and l).
+*/
+function formatOklch(h, s, l) {
+	const [L, a, b] = okhslToOklab(h, s / 100, l / 100);
+	const C = Math.sqrt(a * a + b * b);
+	let hh = Math.atan2(b, a) * (180 / Math.PI);
+	hh = constrainAngle(hh);
+	return `oklch(${fmt$1(L, 4)} ${fmt$1(C, 4)} ${fmt$1(hh, 2)})`;
+}
+
+//#endregion
+//#region src/config.ts
+/**
+* Build a fresh defaults object. Called from module init and from
+* `resetConfig()` so the two paths can't drift.
+*/
+function defaultConfig() {
+	return {
+		lightLightness: [10, 100],
+		darkLightness: [15, 95],
+		darkDesaturation: .1,
+		darkCurve: .5,
+		states: {
+			dark: "@dark",
+			highContrast: "@high-contrast"
+		},
+		modes: {
+			dark: true,
+			highContrast: false
+		},
+		autoFlip: true
+	};
+}
+let globalConfig = defaultConfig();
+/**
+* Monotonic counter incremented on every `configure()` / `resetConfig()`
+* call. Theme / palette caches read this to invalidate stale resolve
+* results when the config changes between exports.
+*/
+let configVersion = 0;
+/** Live reference to the current config. Mutated by `configure()` / `resetConfig()`. */
+function getConfig() {
+	return globalConfig;
+}
+function getConfigVersion() {
+	return configVersion;
+}
+/**
+* Public-facing snapshot used by `glaze.getConfig()`. Returns a shallow
+* copy so callers can't mutate the live config.
+*/
+function snapshotConfig() {
+	return { ...globalConfig };
+}
+function configure(config) {
+	configVersion++;
+	globalConfig = {
+		lightLightness: config.lightLightness ?? globalConfig.lightLightness,
+		darkLightness: config.darkLightness ?? globalConfig.darkLightness,
+		darkDesaturation: config.darkDesaturation ?? globalConfig.darkDesaturation,
+		darkCurve: config.darkCurve ?? globalConfig.darkCurve,
+		states: {
+			dark: config.states?.dark ?? globalConfig.states.dark,
+			highContrast: config.states?.highContrast ?? globalConfig.states.highContrast
+		},
+		modes: {
+			dark: config.modes?.dark ?? globalConfig.modes.dark,
+			highContrast: config.modes?.highContrast ?? globalConfig.modes.highContrast
+		},
+		shadowTuning: config.shadowTuning ?? globalConfig.shadowTuning,
+		autoFlip: config.autoFlip ?? globalConfig.autoFlip
+	};
+}
+function resetConfig() {
+	configVersion++;
+	globalConfig = defaultConfig();
+}
+
+//#endregion
+//#region src/hc-pair.ts
+function pairNormal(p) {
+	return Array.isArray(p) ? p[0] : p;
+}
+function pairHC(p) {
+	return Array.isArray(p) ? p[1] : p;
+}
+function clamp(v, min, max) {
+	return Math.max(min, Math.min(max, v));
+}
+/**
+* Parse a value that can be absolute (number) or relative (signed string).
+* Returns the numeric value and whether it's relative.
+*/
+function parseRelativeOrAbsolute(value) {
+	if (typeof value === "number") return {
+		value,
+		relative: false
+	};
+	return {
+		value: parseFloat(value),
+		relative: true
+	};
+}
+/**
+* Compute the effective hue for a color, given the theme seed hue
+* and an optional per-color hue override.
+*/
+function resolveEffectiveHue(seedHue, defHue) {
+	if (defHue === void 0) return seedHue;
+	const parsed = parseRelativeOrAbsolute(defHue);
+	if (parsed.relative) return ((seedHue + parsed.value) % 360 + 360) % 360;
+	return (parsed.value % 360 + 360) % 360;
+}
+/**
+* Check whether a lightness value represents an absolute root definition
+* (i.e. a number, not a relative string).
+*/
+function isAbsoluteLightness(lightness) {
+	if (lightness === void 0) return false;
+	return typeof (Array.isArray(lightness) ? lightness[0] : lightness) === "number";
+}
+
+//#endregion
+//#region src/contrast-solver.ts
+/**
+* OKHSL Contrast Solver
+*
+* Finds the closest OKHSL lightness that satisfies a WCAG 2 contrast target
+* against a base color. Used by glaze when resolving dependent colors
+* with `contrast`.
+*/
+const CONTRAST_PRESETS = {
+	AA: 4.5,
+	AAA: 7,
+	"AA-large": 3,
+	"AAA-large": 4.5
+};
+function resolveMinContrast(value) {
+	if (typeof value === "number") return Math.max(1, value);
+	return CONTRAST_PRESETS[value];
+}
+const CACHE_SIZE = 512;
+const luminanceCache = /* @__PURE__ */ new Map();
+const cacheOrder = [];
+function cachedLuminance(h, s, l) {
+	const lRounded = Math.round(l * 1e4) / 1e4;
+	const key = `${h}|${s}|${lRounded}`;
+	const cached = luminanceCache.get(key);
+	if (cached !== void 0) return cached;
+	const y = gamutClampedLuminance(okhslToLinearSrgb(h, s, lRounded));
+	if (luminanceCache.size >= CACHE_SIZE) {
+		const evict = cacheOrder.shift();
+		luminanceCache.delete(evict);
+	}
+	luminanceCache.set(key, y);
+	cacheOrder.push(key);
+	return y;
+}
+/**
+* Binary search one branch [lo, hi] for the nearest passing lightness to `preferred`.
+*/
+function searchBranch(h, s, lo, hi, yBase, target, epsilon, maxIter, preferred) {
+	const yLo = cachedLuminance(h, s, lo);
+	const yHi = cachedLuminance(h, s, hi);
+	const crLo = contrastRatioFromLuminance(yLo, yBase);
+	const crHi = contrastRatioFromLuminance(yHi, yBase);
+	if (crLo < target && crHi < target) {
+		if (crLo >= crHi) return {
+			lightness: lo,
+			contrast: crLo,
+			met: false
+		};
+		return {
+			lightness: hi,
+			contrast: crHi,
+			met: false
+		};
+	}
+	let low = lo;
+	let high = hi;
+	for (let i = 0; i < maxIter; i++) {
+		if (high - low < epsilon) break;
+		const mid = (low + high) / 2;
+		if (contrastRatioFromLuminance(cachedLuminance(h, s, mid), yBase) >= target) if (mid < preferred) low = mid;
+		else high = mid;
+		else if (mid < preferred) high = mid;
+		else low = mid;
+	}
+	const yLow = cachedLuminance(h, s, low);
+	const yHigh = cachedLuminance(h, s, high);
+	const crLow = contrastRatioFromLuminance(yLow, yBase);
+	const crHigh = contrastRatioFromLuminance(yHigh, yBase);
+	const lowPasses = crLow >= target;
+	const highPasses = crHigh >= target;
+	if (lowPasses && highPasses) {
+		if (Math.abs(low - preferred) <= Math.abs(high - preferred)) return {
+			lightness: low,
+			contrast: crLow,
+			met: true
+		};
+		return {
+			lightness: high,
+			contrast: crHigh,
+			met: true
+		};
+	}
+	if (lowPasses) return {
+		lightness: low,
+		contrast: crLow,
+		met: true
+	};
+	if (highPasses) return {
+		lightness: high,
+		contrast: crHigh,
+		met: true
+	};
+	return coarseScan(h, s, lo, hi, yBase, target, epsilon, maxIter);
+}
+/**
+* Fallback coarse scan when binary search is unstable near gamut edges.
+*/
+function coarseScan(h, s, lo, hi, yBase, target, epsilon, maxIter) {
+	const STEPS = 64;
+	const step = (hi - lo) / STEPS;
+	let bestL = lo;
+	let bestCr = 0;
+	let bestMet = false;
+	for (let i = 0; i <= STEPS; i++) {
+		const l = lo + step * i;
+		const cr = contrastRatioFromLuminance(cachedLuminance(h, s, l), yBase);
+		if (cr >= target && !bestMet) {
+			bestL = l;
+			bestCr = cr;
+			bestMet = true;
+		} else if (cr >= target && bestMet) {
+			bestL = l;
+			bestCr = cr;
+		} else if (!bestMet && cr > bestCr) {
+			bestL = l;
+			bestCr = cr;
+		}
+	}
+	if (bestMet && bestL > lo + step) {
+		let rLo = bestL - step;
+		let rHi = bestL;
+		for (let i = 0; i < maxIter; i++) {
+			if (rHi - rLo < epsilon) break;
+			const mid = (rLo + rHi) / 2;
+			const cr = contrastRatioFromLuminance(cachedLuminance(h, s, mid), yBase);
+			if (cr >= target) {
+				rHi = mid;
+				bestL = mid;
+				bestCr = cr;
+			} else rLo = mid;
+		}
+	}
+	return {
+		lightness: bestL,
+		contrast: bestCr,
+		met: bestMet
+	};
+}
+/**
+* Find the OKHSL lightness that satisfies a WCAG 2 contrast target
+* against a base color, staying as close to `preferredLightness` as possible.
+*/
+function findLightnessForContrast(options) {
+	const { hue, saturation, preferredLightness, baseLinearRgb, contrast: contrastInput, lightnessRange = [0, 1], epsilon = 1e-4, maxIterations = 14 } = options;
+	const target = resolveMinContrast(contrastInput);
+	const searchTarget = target * 1.01;
+	const yBase = gamutClampedLuminance(baseLinearRgb);
+	const crPref = contrastRatioFromLuminance(cachedLuminance(hue, saturation, preferredLightness), yBase);
+	if (crPref >= searchTarget) return {
+		lightness: preferredLightness,
+		contrast: crPref,
+		met: true,
+		branch: "preferred"
+	};
+	const [minL, maxL] = lightnessRange;
+	const canDarker = preferredLightness > minL;
+	const canLighter = preferredLightness < maxL;
+	let initialIsDarker;
+	if (options.initialDirection !== void 0) initialIsDarker = options.initialDirection === "darker";
+	else if (canDarker && !canLighter) initialIsDarker = true;
+	else if (!canDarker && canLighter) initialIsDarker = false;
+	else if (!canDarker && !canLighter) return {
+		lightness: preferredLightness,
+		contrast: crPref,
+		met: false,
+		branch: "preferred"
+	};
+	else {
+		const yMinExt = cachedLuminance(hue, saturation, minL);
+		const yMaxExt = cachedLuminance(hue, saturation, maxL);
+		initialIsDarker = contrastRatioFromLuminance(yMinExt, yBase) >= contrastRatioFromLuminance(yMaxExt, yBase);
+	}
+	const searchInitial = () => initialIsDarker ? searchBranch(hue, saturation, minL, preferredLightness, yBase, searchTarget, epsilon, maxIterations, preferredLightness) : searchBranch(hue, saturation, preferredLightness, maxL, yBase, searchTarget, epsilon, maxIterations, preferredLightness);
+	const searchOpposite = () => initialIsDarker ? searchBranch(hue, saturation, preferredLightness, maxL, yBase, searchTarget, epsilon, maxIterations, preferredLightness) : searchBranch(hue, saturation, minL, preferredLightness, yBase, searchTarget, epsilon, maxIterations, preferredLightness);
+	const initialBranchName = initialIsDarker ? "darker" : "lighter";
+	const oppositeBranchName = initialIsDarker ? "lighter" : "darker";
+	const initialResult = searchInitial();
+	initialResult.met = initialResult.contrast >= target;
+	if (initialResult.met && !options.flip) return {
+		...initialResult,
+		branch: initialBranchName
+	};
+	if (options.flip) {
+		const oppositeResult = (initialIsDarker ? canLighter : canDarker) ? searchOpposite() : null;
+		if (oppositeResult) oppositeResult.met = oppositeResult.contrast >= target;
+		if (initialResult.met && oppositeResult?.met) {
+			if (Math.abs(initialResult.lightness - preferredLightness) <= Math.abs(oppositeResult.lightness - preferredLightness)) return {
+				...initialResult,
+				branch: initialBranchName
+			};
+			return {
+				...oppositeResult,
+				branch: oppositeBranchName,
+				flipped: true
+			};
+		}
+		if (initialResult.met) return {
+			...initialResult,
+			branch: initialBranchName
+		};
+		if (oppositeResult?.met) return {
+			...oppositeResult,
+			branch: oppositeBranchName,
+			flipped: true
+		};
+	}
+	const extreme = initialIsDarker ? minL : maxL;
+	return {
+		lightness: extreme,
+		contrast: contrastRatioFromLuminance(cachedLuminance(hue, saturation, extreme), yBase),
+		met: false,
+		branch: initialBranchName
+	};
+}
+/**
+* Binary-search one branch [lo, hi] for the nearest passing mix value
+* to `preferred`.
+*/
+function searchMixBranch(lo, hi, yBase, target, epsilon, maxIter, preferred, luminanceAt) {
+	const crLo = contrastRatioFromLuminance(luminanceAt(lo), yBase);
+	const crHi = contrastRatioFromLuminance(luminanceAt(hi), yBase);
+	if (crLo < target && crHi < target) {
+		if (crLo >= crHi) return {
+			lightness: lo,
+			contrast: crLo,
+			met: false
+		};
+		return {
+			lightness: hi,
+			contrast: crHi,
+			met: false
+		};
+	}
+	let low = lo;
+	let high = hi;
+	for (let i = 0; i < maxIter; i++) {
+		if (high - low < epsilon) break;
+		const mid = (low + high) / 2;
+		if (contrastRatioFromLuminance(luminanceAt(mid), yBase) >= target) if (mid < preferred) low = mid;
+		else high = mid;
+		else if (mid < preferred) high = mid;
+		else low = mid;
+	}
+	const crLow = contrastRatioFromLuminance(luminanceAt(low), yBase);
+	const crHigh = contrastRatioFromLuminance(luminanceAt(high), yBase);
+	const lowPasses = crLow >= target;
+	const highPasses = crHigh >= target;
+	if (lowPasses && highPasses) {
+		if (Math.abs(low - preferred) <= Math.abs(high - preferred)) return {
+			lightness: low,
+			contrast: crLow,
+			met: true
+		};
+		return {
+			lightness: high,
+			contrast: crHigh,
+			met: true
+		};
+	}
+	if (lowPasses) return {
+		lightness: low,
+		contrast: crLow,
+		met: true
+	};
+	if (highPasses) return {
+		lightness: high,
+		contrast: crHigh,
+		met: true
+	};
+	return crLow >= crHigh ? {
+		lightness: low,
+		contrast: crLow,
+		met: false
+	} : {
+		lightness: high,
+		contrast: crHigh,
+		met: false
+	};
+}
+/**
+* Find the mix parameter (ratio or opacity) that satisfies a WCAG 2 contrast
+* target against a base color, staying as close to `preferredValue` as possible.
+*/
+function findValueForMixContrast(options) {
+	const { preferredValue, baseLinearRgb, contrast: contrastInput, luminanceAtValue, epsilon = 1e-4, maxIterations = 20 } = options;
+	const target = resolveMinContrast(contrastInput);
+	const searchTarget = target * 1.01;
+	const yBase = gamutClampedLuminance(baseLinearRgb);
+	const crPref = contrastRatioFromLuminance(luminanceAtValue(preferredValue), yBase);
+	if (crPref >= searchTarget) return {
+		value: preferredValue,
+		contrast: crPref,
+		met: true
+	};
+	const canLower = preferredValue > 0;
+	const canUpper = preferredValue < 1;
+	let initialIsLower;
+	if (canLower && !canUpper) initialIsLower = true;
+	else if (!canLower && canUpper) initialIsLower = false;
+	else if (!canLower && !canUpper) return {
+		value: preferredValue,
+		contrast: crPref,
+		met: false
+	};
+	else initialIsLower = contrastRatioFromLuminance(luminanceAtValue(0), yBase) >= contrastRatioFromLuminance(luminanceAtValue(1), yBase);
+	const searchInitial = () => initialIsLower ? searchMixBranch(0, preferredValue, yBase, searchTarget, epsilon, maxIterations, preferredValue, luminanceAtValue) : searchMixBranch(preferredValue, 1, yBase, searchTarget, epsilon, maxIterations, preferredValue, luminanceAtValue);
+	const searchOpposite = () => initialIsLower ? searchMixBranch(preferredValue, 1, yBase, searchTarget, epsilon, maxIterations, preferredValue, luminanceAtValue) : searchMixBranch(0, preferredValue, yBase, searchTarget, epsilon, maxIterations, preferredValue, luminanceAtValue);
+	const initialResult = searchInitial();
+	initialResult.met = initialResult.contrast >= target;
+	if (initialResult.met && !options.flip) return {
+		value: initialResult.lightness,
+		contrast: initialResult.contrast,
+		met: true
+	};
+	if (options.flip) {
+		const oppositeResult = (initialIsLower ? canUpper : canLower) ? searchOpposite() : null;
+		if (oppositeResult) oppositeResult.met = oppositeResult.contrast >= target;
+		if (initialResult.met && oppositeResult?.met) {
+			if (Math.abs(initialResult.lightness - preferredValue) <= Math.abs(oppositeResult.lightness - preferredValue)) return {
+				value: initialResult.lightness,
+				contrast: initialResult.contrast,
+				met: true
+			};
+			return {
+				value: oppositeResult.lightness,
+				contrast: oppositeResult.contrast,
+				met: true,
+				flipped: true
+			};
+		}
+		if (initialResult.met) return {
+			value: initialResult.lightness,
+			contrast: initialResult.contrast,
+			met: true
+		};
+		if (oppositeResult?.met) return {
+			value: oppositeResult.lightness,
+			contrast: oppositeResult.contrast,
+			met: true,
+			flipped: true
+		};
+	}
+	const extreme = initialIsLower ? 0 : 1;
+	return {
+		value: extreme,
+		contrast: contrastRatioFromLuminance(luminanceAtValue(extreme), yBase),
+		met: false
+	};
+}
+
+//#endregion
+//#region src/shadow.ts
+/**
+* Shadow color computation.
+*
+* Owns the shadow / mix def predicates, default tuning constants, the
+* tuning merge, and the actual `computeShadow` math (hue blend,
+* saturation cap, lightness clamp, alpha curve). The resolver consumes
+* this module per scheme variant.
+*/
+function isShadowDef(def) {
+	return def.type === "shadow";
+}
+function isMixDef(def) {
+	return def.type === "mix";
+}
+const DEFAULT_SHADOW_TUNING = {
+	saturationFactor: .18,
+	maxSaturation: .25,
+	lightnessFactor: .25,
+	lightnessBounds: [.05, .2],
+	minGapTarget: .05,
+	alphaMax: 1,
+	bgHueBlend: .2
+};
+function resolveShadowTuning(perColor) {
+	const globalTuning = getConfig().shadowTuning;
+	return {
+		...DEFAULT_SHADOW_TUNING,
+		...globalTuning,
+		...perColor,
+		lightnessBounds: perColor?.lightnessBounds ?? globalTuning?.lightnessBounds ?? DEFAULT_SHADOW_TUNING.lightnessBounds
+	};
+}
+function circularLerp(a, b, t) {
+	let diff = b - a;
+	if (diff > 180) diff -= 360;
+	else if (diff < -180) diff += 360;
+	return ((a + diff * t) % 360 + 360) % 360;
+}
+/**
+* Compute the canonical max-contrast reference t value for normalization.
+* Uses bg.l=1, fg.l=0, intensity=100 — the theoretical maximum.
+* This is a fixed constant per tuning configuration, ensuring uniform
+* scaling across all bg/fg pairs at low intensities.
+*/
+function computeRefT(tuning) {
+	const EPSILON = 1e-6;
+	let lShRef = clamp(tuning.lightnessFactor, tuning.lightnessBounds[0], tuning.lightnessBounds[1]);
+	lShRef = Math.max(Math.min(lShRef, 1 - tuning.minGapTarget), 0);
+	return 1 / Math.max(1 - lShRef, EPSILON);
+}
+function computeShadow(bg, fg, intensity, tuning) {
+	const EPSILON = 1e-6;
+	const clampedIntensity = clamp(intensity, 0, 100);
+	const contrastWeight = fg ? Math.abs(bg.l - fg.l) : 1;
+	const deltaL = clampedIntensity / 100 * contrastWeight;
+	const h = fg ? circularLerp(fg.h, bg.h, tuning.bgHueBlend) : bg.h;
+	const s = fg ? Math.min(fg.s * tuning.saturationFactor, tuning.maxSaturation) : 0;
+	let lSh = clamp(bg.l * tuning.lightnessFactor, tuning.lightnessBounds[0], tuning.lightnessBounds[1]);
+	lSh = Math.max(Math.min(lSh, bg.l - tuning.minGapTarget), 0);
+	const t = deltaL / Math.max(bg.l - lSh, EPSILON);
+	const tRef = computeRefT(tuning);
+	const norm = Math.tanh(tRef / tuning.alphaMax);
+	const alpha = Math.min(tuning.alphaMax * Math.tanh(t / tuning.alphaMax) / norm, tuning.alphaMax);
+	return {
+		h,
+		s,
+		l: lSh,
+		alpha
+	};
+}
+
+//#endregion
+//#region src/scheme-mapping.ts
+/**
+* Light / dark scheme lightness mappings.
+*
+* Owns the active lightness window selection (with per-call scaling
+* overrides and high-contrast handling), the Möbius curve used by the
+* `'auto'` dark adaptation, and the saturation-desaturation reducer
+* for dark mode.
+*/
+/**
+* Resolve the active lightness window for a scheme.
+* - HC variants always return `[0, 100]` (existing behavior, predates per-call overrides).
+* - Otherwise, per-call `scaling` (e.g. from `glaze.color()`'s third arg) wins;
+*   `false` is interpreted as `[0, 100]` (no remap). Falls back to `globalConfig.*Lightness`.
+*/
+function lightnessWindow(isHighContrast, kind, scaling) {
+	if (isHighContrast) return [0, 100];
+	if (scaling) {
+		const override = kind === "dark" ? scaling.darkLightness : scaling.lightLightness;
+		if (override === false) return [0, 100];
+		if (override !== void 0) return override;
+	}
+	const cfg = getConfig();
+	return kind === "dark" ? cfg.darkLightness : cfg.lightLightness;
+}
+function mapLightnessLight(l, mode, isHighContrast, scaling) {
+	if (mode === "static") return l;
+	const [lo, hi] = lightnessWindow(isHighContrast, "light", scaling);
+	return l * (hi - lo) / 100 + lo;
+}
+function mobiusCurve(t, beta) {
+	if (beta >= 1) return t;
+	return t / (t + beta * (1 - t));
+}
+function mapLightnessDark(l, mode, isHighContrast, scaling) {
+	if (mode === "static") return l;
+	const cfg = getConfig();
+	const beta = isHighContrast ? pairHC(cfg.darkCurve) : pairNormal(cfg.darkCurve);
+	const [darkLo, darkHi] = lightnessWindow(isHighContrast, "dark", scaling);
+	if (mode === "fixed") return l * (darkHi - darkLo) / 100 + darkLo;
+	const [lightLo, lightHi] = lightnessWindow(isHighContrast, "light", scaling);
+	const t = (lightHi - (l * (lightHi - lightLo) / 100 + lightLo)) / (lightHi - lightLo);
+	return darkLo + (darkHi - darkLo) * mobiusCurve(t, beta);
+}
+function lightMappedToDark(lightL, isHighContrast, scaling) {
+	const cfg = getConfig();
+	const beta = isHighContrast ? pairHC(cfg.darkCurve) : pairNormal(cfg.darkCurve);
+	const [lightLo, lightHi] = lightnessWindow(isHighContrast, "light", scaling);
+	const [darkLo, darkHi] = lightnessWindow(isHighContrast, "dark", scaling);
+	const t = (lightHi - clamp(lightL, lightLo, lightHi)) / (lightHi - lightLo);
+	return darkLo + (darkHi - darkLo) * mobiusCurve(t, beta);
+}
+function mapSaturationDark(s, mode) {
+	if (mode === "static") return s;
+	return s * (1 - getConfig().darkDesaturation);
+}
+function schemeLightnessRange(isDark, mode, isHighContrast, scaling) {
+	if (mode === "static") return [0, 1];
+	const [lo, hi] = lightnessWindow(isHighContrast, isDark ? "dark" : "light", scaling);
+	return [lo / 100, hi / 100];
+}
+
+//#endregion
+//#region src/validation.ts
+/**
+* Color graph validation and topological sort.
+*
+* `validateColorDefs` rejects bad references (missing / shadow-referencing /
+* base/contrast/lightness mismatches) and detects cycles before the
+* resolver runs. `topoSort` orders defs so each color is processed after
+* its base / bg / fg / target dependencies.
+*/
+function validateColorDefs(defs, externalBases) {
+	const localNames = new Set(Object.keys(defs));
+	const allNames = new Set([...localNames, ...externalBases ? externalBases.keys() : []]);
+	for (const [name, def] of Object.entries(defs)) {
+		if (isShadowDef(def)) {
+			if (!allNames.has(def.bg)) throw new Error(`glaze: shadow "${name}" references non-existent bg "${def.bg}".`);
+			if (localNames.has(def.bg) && isShadowDef(defs[def.bg])) throw new Error(`glaze: shadow "${name}" bg "${def.bg}" references another shadow color.`);
+			if (def.fg !== void 0) {
+				if (!allNames.has(def.fg)) throw new Error(`glaze: shadow "${name}" references non-existent fg "${def.fg}".`);
+				if (localNames.has(def.fg) && isShadowDef(defs[def.fg])) throw new Error(`glaze: shadow "${name}" fg "${def.fg}" references another shadow color.`);
+			}
+			continue;
+		}
+		if (isMixDef(def)) {
+			if (!allNames.has(def.base)) throw new Error(`glaze: mix "${name}" references non-existent base "${def.base}".`);
+			if (!allNames.has(def.target)) throw new Error(`glaze: mix "${name}" references non-existent target "${def.target}".`);
+			if (localNames.has(def.base) && isShadowDef(defs[def.base])) throw new Error(`glaze: mix "${name}" base "${def.base}" references a shadow color.`);
+			if (localNames.has(def.target) && isShadowDef(defs[def.target])) throw new Error(`glaze: mix "${name}" target "${def.target}" references a shadow color.`);
+			continue;
+		}
+		const regDef = def;
+		if (regDef.contrast !== void 0 && !regDef.base) throw new Error(`glaze: color "${name}" has "contrast" without "base".`);
+		if (regDef.lightness !== void 0 && !isAbsoluteLightness(regDef.lightness) && !regDef.base) throw new Error(`glaze: color "${name}" has relative "lightness" without "base".`);
+		if (regDef.base && !allNames.has(regDef.base)) throw new Error(`glaze: color "${name}" references non-existent base "${regDef.base}".`);
+		if (regDef.base && localNames.has(regDef.base) && isShadowDef(defs[regDef.base])) throw new Error(`glaze: color "${name}" base "${regDef.base}" references a shadow color.`);
+		if (!isAbsoluteLightness(regDef.lightness) && regDef.base === void 0) throw new Error(`glaze: color "${name}" must have either absolute "lightness" (root) or "base" (dependent).`);
+		if (regDef.contrast !== void 0 && regDef.opacity !== void 0) console.warn(`glaze: color "${name}" has both "contrast" and "opacity". Opacity makes perceived lightness unpredictable.`);
+	}
+	const visited = /* @__PURE__ */ new Set();
+	const inStack = /* @__PURE__ */ new Set();
+	function dfs(name) {
+		if (!localNames.has(name)) return;
+		if (inStack.has(name)) throw new Error(`glaze: circular base reference detected involving "${name}".`);
+		if (visited.has(name)) return;
+		inStack.add(name);
+		const def = defs[name];
+		if (isShadowDef(def)) {
+			dfs(def.bg);
+			if (def.fg) dfs(def.fg);
+		} else if (isMixDef(def)) {
+			dfs(def.base);
+			dfs(def.target);
+		} else {
+			const regDef = def;
+			if (regDef.base) dfs(regDef.base);
+		}
+		inStack.delete(name);
+		visited.add(name);
+	}
+	for (const name of localNames) dfs(name);
+}
+function topoSort(defs) {
+	const result = [];
+	const visited = /* @__PURE__ */ new Set();
+	function visit(name) {
+		if (visited.has(name)) return;
+		visited.add(name);
+		const def = defs[name];
+		if (def === void 0) return;
+		if (isShadowDef(def)) {
+			visit(def.bg);
+			if (def.fg) visit(def.fg);
+		} else if (isMixDef(def)) {
+			visit(def.base);
+			visit(def.target);
+		} else {
+			const regDef = def;
+			if (regDef.base) visit(regDef.base);
+		}
+		result.push(name);
+	}
+	for (const name of Object.keys(defs)) visit(name);
+	return result;
+}
+
+//#endregion
+//#region src/warnings.ts
+/**
+* Contrast-warning dispatcher.
+*
+* Tokens memoize their resolution, but a long-lived process (e.g. a dev
+* server with HMR) can re-resolve the same theme many times. The cache
+* here dedupes warnings within a session with a soft cap to keep noise
+* bounded.
+*/
+const CONTRAST_WARN_CACHE_LIMIT = 256;
+const contrastWarnCache = /* @__PURE__ */ new Set();
+/**
+* Slack factor below the requested target before we emit a warning.
+* The contrast solver already overshoots by `OVERSHOOT` (currently 1%)
+* to absorb rounding noise (`see findLightnessForContrast` in
+* `contrast-solver.ts`), so an `actual` ratio within ~2x that overshoot
+* is effectively a pass and not worth nagging the user about.
+*/
+const CONTRAST_WARN_SLACK = .98;
+function schemeLabel(isDark, isHighContrast) {
+	if (isDark && isHighContrast) return "darkContrast";
+	if (isDark) return "dark";
+	if (isHighContrast) return "lightContrast";
+	return "light";
+}
+function formatContrastTarget(input, ratio) {
+	return typeof input === "string" ? `"${input}" (${ratio.toFixed(2)})` : ratio.toFixed(2);
+}
+function warnContrastUnmet(name, isDark, isHighContrast, target, actual) {
+	const targetRatio = resolveMinContrast(target);
+	if (actual >= targetRatio * CONTRAST_WARN_SLACK) return;
+	const scheme = schemeLabel(isDark, isHighContrast);
+	const key = `${name}|${scheme}|${targetRatio.toFixed(3)}|${actual.toFixed(2)}`;
+	if (contrastWarnCache.has(key)) return;
+	if (contrastWarnCache.size >= CONTRAST_WARN_CACHE_LIMIT) contrastWarnCache.clear();
+	contrastWarnCache.add(key);
+	console.warn(`glaze: color "${name}" cannot meet contrast ${formatContrastTarget(target, targetRatio)} in ${scheme} scheme (got ${actual.toFixed(2)}). Try widening the lightness window, lowering the contrast target, or picking a base color further from this color's lightness.`);
+}
+
+//#endregion
+//#region src/resolver.ts
+/**
+* Color resolution engine.
+*
+* Runs the four-pass solver (light → light-HC → dark → dark-HC) that
+* turns a `ColorMap` into a fully resolved `ResolvedColor` per name.
+* Owns the per-scheme resolve helpers for regular, shadow, and mix
+* color defs.
+*/
+function getSchemeVariant(color, isDark, isHighContrast) {
+	if (isDark && isHighContrast) return color.darkContrast;
+	if (isDark) return color.dark;
+	if (isHighContrast) return color.lightContrast;
+	return color.light;
+}
+function resolveRootColor(_name, def, _ctx, isHighContrast) {
+	const rawL = def.lightness;
+	return {
+		lightL: clamp(parseRelativeOrAbsolute(isHighContrast ? pairHC(rawL) : pairNormal(rawL)).value, 0, 100),
+		satFactor: clamp(def.saturation ?? 1, 0, 1)
+	};
+}
+function resolveDependentColor(name, def, ctx, isHighContrast, isDark, effectiveHue) {
+	const baseName = def.base;
+	const baseResolved = ctx.resolved.get(baseName);
+	if (!baseResolved) throw new Error(`glaze: base "${baseName}" not yet resolved for "${name}".`);
+	const mode = def.mode ?? "auto";
+	const satFactor = clamp(def.saturation ?? 1, 0, 1);
+	const baseVariant = getSchemeVariant(baseResolved, isDark, isHighContrast);
+	const baseL = baseVariant.l * 100;
+	let preferredL;
+	const rawLightness = def.lightness;
+	if (rawLightness === void 0) preferredL = baseL;
+	else {
+		const parsed = parseRelativeOrAbsolute(isHighContrast ? pairHC(rawLightness) : pairNormal(rawLightness));
+		if (parsed.relative) {
+			const delta = parsed.value;
+			if (isDark && mode === "auto") preferredL = lightMappedToDark(clamp(getSchemeVariant(baseResolved, false, isHighContrast).l * 100 + delta, 0, 100), isHighContrast, ctx.scaling);
+			else preferredL = clamp(baseL + delta, 0, 100);
+		} else if (isDark) preferredL = mapLightnessDark(parsed.value, mode, isHighContrast, ctx.scaling);
+		else preferredL = mapLightnessLight(parsed.value, mode, isHighContrast, ctx.scaling);
+	}
+	const rawContrast = def.contrast;
+	if (rawContrast !== void 0) {
+		const minCr = isHighContrast ? pairHC(rawContrast) : pairNormal(rawContrast);
+		const effectiveSat = isDark ? mapSaturationDark(satFactor * ctx.saturation / 100, mode) : satFactor * ctx.saturation / 100;
+		const baseLinearRgb = okhslToLinearSrgb(baseVariant.h, baseVariant.s, baseVariant.l);
+		const windowRange = schemeLightnessRange(isDark, mode, isHighContrast, ctx.scaling);
+		const autoFlip = ctx.autoFlip ?? getConfig().autoFlip;
+		let initialDirection;
+		if (preferredL < baseL) initialDirection = "darker";
+		else if (preferredL > baseL) initialDirection = "lighter";
+		const result = findLightnessForContrast({
+			hue: effectiveHue,
+			saturation: effectiveSat,
+			preferredLightness: clamp(preferredL / 100, windowRange[0], windowRange[1]),
+			baseLinearRgb,
+			contrast: minCr,
+			lightnessRange: [0, 1],
+			initialDirection,
+			flip: autoFlip
+		});
+		if (!result.met) warnContrastUnmet(name, isDark, isHighContrast, minCr, result.contrast);
+		return {
+			l: result.lightness * 100,
+			satFactor
+		};
+	}
+	return {
+		l: clamp(preferredL, 0, 100),
+		satFactor
+	};
+}
+function resolveColorForScheme(name, def, ctx, isDark, isHighContrast) {
+	if (isShadowDef(def)) return resolveShadowForScheme(def, ctx, isDark, isHighContrast);
+	if (isMixDef(def)) return resolveMixForScheme(def, ctx, isDark, isHighContrast);
+	const regDef = def;
+	const mode = regDef.mode ?? "auto";
+	const isRoot = isAbsoluteLightness(regDef.lightness) && !regDef.base;
+	const effectiveHue = resolveEffectiveHue(ctx.hue, regDef.hue);
+	let lightL;
+	let satFactor;
+	if (isRoot) {
+		const root = resolveRootColor(name, regDef, ctx, isHighContrast);
+		lightL = root.lightL;
+		satFactor = root.satFactor;
+	} else {
+		const dep = resolveDependentColor(name, regDef, ctx, isHighContrast, isDark, effectiveHue);
+		lightL = dep.l;
+		satFactor = dep.satFactor;
+	}
+	let finalL;
+	let finalSat;
+	if (isDark && isRoot) {
+		finalL = mapLightnessDark(lightL, mode, isHighContrast, ctx.scaling);
+		finalSat = mapSaturationDark(satFactor * ctx.saturation / 100, mode);
+	} else if (isDark && !isRoot) {
+		finalL = lightL;
+		finalSat = mapSaturationDark(satFactor * ctx.saturation / 100, mode);
+	} else if (isRoot) {
+		finalL = mapLightnessLight(lightL, mode, isHighContrast, ctx.scaling);
+		finalSat = satFactor * ctx.saturation / 100;
+	} else {
+		finalL = lightL;
+		finalSat = satFactor * ctx.saturation / 100;
+	}
+	return {
+		h: effectiveHue,
+		s: clamp(finalSat, 0, 1),
+		l: clamp(finalL / 100, 0, 1),
+		alpha: regDef.opacity ?? 1
+	};
+}
+function resolveShadowForScheme(def, ctx, isDark, isHighContrast) {
+	const bgVariant = getSchemeVariant(ctx.resolved.get(def.bg), isDark, isHighContrast);
+	let fgVariant;
+	if (def.fg) fgVariant = getSchemeVariant(ctx.resolved.get(def.fg), isDark, isHighContrast);
+	const intensity = isHighContrast ? pairHC(def.intensity) : pairNormal(def.intensity);
+	const tuning = resolveShadowTuning(def.tuning);
+	return computeShadow(bgVariant, fgVariant, intensity, tuning);
+}
+function variantToLinearRgb(v) {
+	return okhslToLinearSrgb(v.h, v.s, v.l);
+}
+/**
+* Resolve hue for OKHSL mixing, handling achromatic colors.
+* When one color has no saturation, its hue is meaningless —
+* use the hue from the color that has saturation (matches CSS
+* color-mix "missing component" behavior).
+*/
+function mixHue(base, target, t) {
+	const SAT_EPSILON = 1e-6;
+	const baseHasSat = base.s > SAT_EPSILON;
+	const targetHasSat = target.s > SAT_EPSILON;
+	if (baseHasSat && targetHasSat) return circularLerp(base.h, target.h, t);
+	if (targetHasSat) return target.h;
+	return base.h;
+}
+function linearSrgbLerp(base, target, t) {
+	return [
+		base[0] + (target[0] - base[0]) * t,
+		base[1] + (target[1] - base[1]) * t,
+		base[2] + (target[2] - base[2]) * t
+	];
+}
+function linearRgbToVariant(rgb) {
+	const [h, s, l] = srgbToOkhsl([
+		Math.max(0, Math.min(1, sRGBLinearToGamma(rgb[0]))),
+		Math.max(0, Math.min(1, sRGBLinearToGamma(rgb[1]))),
+		Math.max(0, Math.min(1, sRGBLinearToGamma(rgb[2])))
+	]);
+	return {
+		h,
+		s,
+		l,
+		alpha: 1
+	};
+}
+function resolveMixForScheme(def, ctx, isDark, isHighContrast) {
+	const baseResolved = ctx.resolved.get(def.base);
+	const targetResolved = ctx.resolved.get(def.target);
+	const baseVariant = getSchemeVariant(baseResolved, isDark, isHighContrast);
+	const targetVariant = getSchemeVariant(targetResolved, isDark, isHighContrast);
+	let t = clamp(isHighContrast ? pairHC(def.value) : pairNormal(def.value), 0, 100) / 100;
+	const blend = def.blend ?? "opaque";
+	const space = def.space ?? "okhsl";
+	const baseLinear = variantToLinearRgb(baseVariant);
+	const targetLinear = variantToLinearRgb(targetVariant);
+	if (def.contrast !== void 0) {
+		const minCr = isHighContrast ? pairHC(def.contrast) : pairNormal(def.contrast);
+		let luminanceAt;
+		if (blend === "transparent") luminanceAt = (v) => gamutClampedLuminance(linearSrgbLerp(baseLinear, targetLinear, v));
+		else if (space === "srgb") luminanceAt = (v) => gamutClampedLuminance(linearSrgbLerp(baseLinear, targetLinear, v));
+		else luminanceAt = (v) => {
+			return gamutClampedLuminance(okhslToLinearSrgb(mixHue(baseVariant, targetVariant, v), baseVariant.s + (targetVariant.s - baseVariant.s) * v, baseVariant.l + (targetVariant.l - baseVariant.l) * v));
+		};
+		const autoFlip = ctx.autoFlip ?? getConfig().autoFlip;
+		t = findValueForMixContrast({
+			preferredValue: t,
+			baseLinearRgb: baseLinear,
+			targetLinearRgb: targetLinear,
+			contrast: minCr,
+			luminanceAtValue: luminanceAt,
+			flip: autoFlip
+		}).value;
+	}
+	if (blend === "transparent") return {
+		h: targetVariant.h,
+		s: targetVariant.s,
+		l: targetVariant.l,
+		alpha: clamp(t, 0, 1)
+	};
+	if (space === "srgb") return linearRgbToVariant(linearSrgbLerp(baseLinear, targetLinear, t));
+	return {
+		h: mixHue(baseVariant, targetVariant, t),
+		s: clamp(baseVariant.s + (targetVariant.s - baseVariant.s) * t, 0, 1),
+		l: clamp(baseVariant.l + (targetVariant.l - baseVariant.l) * t, 0, 1),
+		alpha: 1
+	};
+}
+function defMode(def) {
+	if (isShadowDef(def) || isMixDef(def)) return void 0;
+	return def.mode ?? "auto";
+}
+/**
+* Run a single resolve pass over all local names. Pass 1 lazily creates
+* each `ResolvedColor` (all four slots seeded with the just-resolved
+* variant) the first time it sees a name; later passes update the
+* `target` slot on the existing record.
+*/
+function runPass(order, defs, ctx, isDark, isHighContrast, target) {
+	const out = /* @__PURE__ */ new Map();
+	for (const name of order) {
+		const variant = resolveColorForScheme(name, defs[name], ctx, isDark, isHighContrast);
+		out.set(name, variant);
+		const existing = ctx.resolved.get(name);
+		if (existing) ctx.resolved.set(name, {
+			...existing,
+			[target]: variant
+		});
+		else ctx.resolved.set(name, {
+			name,
+			light: variant,
+			dark: variant,
+			lightContrast: variant,
+			darkContrast: variant,
+			mode: defMode(defs[name])
+		});
+	}
+	return out;
+}
+/**
+* Re-seed a single variant slot with a previously-resolved map so the
+* upcoming pass reads sensible fallbacks via `getSchemeVariant`.
+*/
+function seedField(order, ctx, field, source) {
+	for (const name of order) {
+		const existing = ctx.resolved.get(name);
+		ctx.resolved.set(name, {
+			...existing,
+			[field]: source.get(name)
+		});
+	}
+}
+function resolveAllColors(hue, saturation, defs, scaling, externalBases, overrideAutoFlip) {
+	validateColorDefs(defs, externalBases);
+	const order = topoSort(defs);
+	const cfg = getConfig();
+	const ctx = {
+		hue,
+		saturation,
+		defs,
+		resolved: /* @__PURE__ */ new Map(),
+		scaling,
+		autoFlip: overrideAutoFlip ?? cfg.autoFlip
+	};
+	if (externalBases) for (const [name, color] of externalBases) ctx.resolved.set(name, color);
+	const lightMap = runPass(order, defs, ctx, false, false, "light");
+	seedField(order, ctx, "lightContrast", lightMap);
+	const lightHCMap = runPass(order, defs, ctx, false, true, "lightContrast");
+	seedField(order, ctx, "dark", lightMap);
+	seedField(order, ctx, "darkContrast", lightHCMap);
+	const darkMap = runPass(order, defs, ctx, true, false, "dark");
+	seedField(order, ctx, "darkContrast", darkMap);
+	const darkHCMap = runPass(order, defs, ctx, true, true, "darkContrast");
+	const result = /* @__PURE__ */ new Map();
+	for (const name of order) result.set(name, {
+		name,
+		light: lightMap.get(name),
+		dark: darkMap.get(name),
+		lightContrast: lightHCMap.get(name),
+		darkContrast: darkHCMap.get(name),
+		mode: defMode(defs[name])
+	});
+	return result;
+}
+
+//#endregion
+//#region src/formatters.ts
+/**
+* Output formatting for resolved color maps.
+*
+* Owns the CSS-string formatter dispatch table (`okhsl` / `rgb` / `hsl` /
+* `oklch`) and the four token-map shapes Glaze emits:
+* - `buildTokenMap` — Tasty style-to-state bindings (`#name` keys, state aliases).
+* - `buildFlatTokenMap` — `{ light, dark, ... }` per-variant maps.
+* - `buildJsonMap` — `{ name: { light, dark, ... } }` per-color JSON.
+* - `buildCssMap` — CSS custom property declaration strings per variant.
+*/
+const formatters = {
+	okhsl: formatOkhsl,
+	rgb: formatRgb,
+	hsl: formatHsl,
+	oklch: formatOklch
+};
+function fmt(value, decimals) {
+	return parseFloat(value.toFixed(decimals)).toString();
+}
+function formatVariant(v, format = "okhsl") {
+	const base = formatters[format](v.h, v.s * 100, v.l * 100);
+	if (v.alpha >= 1) return base;
+	const closing = base.lastIndexOf(")");
+	return `${base.slice(0, closing)} / ${fmt(v.alpha, 4)})`;
+}
+function resolveModes(override) {
+	const cfg = getConfig();
+	return {
+		dark: override?.dark ?? cfg.modes.dark,
+		highContrast: override?.highContrast ?? cfg.modes.highContrast
+	};
+}
+function buildTokenMap(resolved, prefix, states, modes, format = "okhsl") {
+	const tokens = {};
+	for (const [name, color] of resolved) {
+		const key = `#${prefix}${name}`;
+		const entry = { "": formatVariant(color.light, format) };
+		if (modes.dark) entry[states.dark] = formatVariant(color.dark, format);
+		if (modes.highContrast) entry[states.highContrast] = formatVariant(color.lightContrast, format);
+		if (modes.dark && modes.highContrast) entry[`${states.dark} & ${states.highContrast}`] = formatVariant(color.darkContrast, format);
+		tokens[key] = entry;
+	}
+	return tokens;
+}
+function buildFlatTokenMap(resolved, prefix, modes, format = "okhsl") {
+	const result = { light: {} };
+	if (modes.dark) result.dark = {};
+	if (modes.highContrast) result.lightContrast = {};
+	if (modes.dark && modes.highContrast) result.darkContrast = {};
+	for (const [name, color] of resolved) {
+		const key = `${prefix}${name}`;
+		result.light[key] = formatVariant(color.light, format);
+		if (modes.dark) result.dark[key] = formatVariant(color.dark, format);
+		if (modes.highContrast) result.lightContrast[key] = formatVariant(color.lightContrast, format);
+		if (modes.dark && modes.highContrast) result.darkContrast[key] = formatVariant(color.darkContrast, format);
+	}
+	return result;
+}
+function buildJsonMap(resolved, modes, format = "okhsl") {
+	const result = {};
+	for (const [name, color] of resolved) {
+		const entry = { light: formatVariant(color.light, format) };
+		if (modes.dark) entry.dark = formatVariant(color.dark, format);
+		if (modes.highContrast) entry.lightContrast = formatVariant(color.lightContrast, format);
+		if (modes.dark && modes.highContrast) entry.darkContrast = formatVariant(color.darkContrast, format);
+		result[name] = entry;
+	}
+	return result;
+}
+function buildCssMap(resolved, prefix, suffix, format) {
+	const lines = {
+		light: [],
+		dark: [],
+		lightContrast: [],
+		darkContrast: []
+	};
+	for (const [name, color] of resolved) {
+		const prop = `--${prefix}${name}${suffix}`;
+		lines.light.push(`${prop}: ${formatVariant(color.light, format)};`);
+		lines.dark.push(`${prop}: ${formatVariant(color.dark, format)};`);
+		lines.lightContrast.push(`${prop}: ${formatVariant(color.lightContrast, format)};`);
+		lines.darkContrast.push(`${prop}: ${formatVariant(color.darkContrast, format)};`);
+	}
+	return {
+		light: lines.light.join("\n"),
+		dark: lines.dark.join("\n"),
+		lightContrast: lines.lightContrast.join("\n"),
+		darkContrast: lines.darkContrast.join("\n")
+	};
+}
+
+//#endregion
+//#region src/color-token.ts
+/**
+* Standalone single-color tokens (`glaze.color()` / `glaze.colorFrom()`).
+*
+* Owns the value-shorthand parser (hex, `rgb()` / `hsl()` / `okhsl()` /
+* `oklch()`, `{ r, g, b }`, `{ h, s, l }`, `{ l, c, h }`), the structured-input
+* validator, the two factory paths (value vs structured), and the
+* JSON-safe export / rehydration round-trip.
+*
+* Standalone tokens snapshot the relevant `globalConfig` fields at
+* create time so later `configure()` calls do not retroactively change
+* exported tokens — the snapshot is captured eagerly in
+* `defaultStandaloneScaling()`. The token's resolved variants are then
+* memoized on first `.resolve()` / `.token()` / ... call.
+*/
+/** Internal name of the user-facing standalone color in the synthesized def map. */
+const STANDALONE_VALUE = "value";
+/** Internal name of the hidden static-anchor seed used for relative lightness / contrast. */
+const STANDALONE_SEED = "seed";
+/** Internal name of an externally-resolved `GlazeColorToken` injected as a base reference. */
+const STANDALONE_BASE = "externalBase";
+/** Reserved internal names that user-supplied `name` must not collide with. */
+const RESERVED_STANDALONE_NAMES = new Set([
+	STANDALONE_VALUE,
+	STANDALONE_SEED,
+	STANDALONE_BASE
+]);
+/**
+* Create-time scaling for all value-shorthand `glaze.color()` inputs.
+* Light lightness is preserved (`lightLightness: false`); dark uses the
+* theme window from `globalConfig.darkLightness`, snapshotted at create
+* time so later `configure()` does not retroactively change tokens.
+*/
+function defaultValueShorthandScaling() {
+	return {
+		lightLightness: false,
+		darkLightness: getConfig().darkLightness
+	};
+}
+/**
+* Create-time scaling for structured `glaze.color({ hue, saturation,
+* lightness, ... })`. Both windows come from `globalConfig` so the
+* token behaves like an ordinary theme color on light and dark sides.
+*/
+function defaultStructuredScaling() {
+	const cfg = getConfig();
+	return {
+		lightLightness: cfg.lightLightness,
+		darkLightness: cfg.darkLightness
+	};
+}
+/**
+* Discriminate a `GlazeColorToken` from a raw `GlazeColorValue`.
+* Used to widen `base?` so it accepts either a token reference or a
+* raw value (auto-wrapped into `glaze.color(value)`).
+*/
+function isGlazeColorToken(candidate) {
+	return typeof candidate === "object" && candidate !== null && !Array.isArray(candidate) && "resolve" in candidate && typeof candidate.resolve === "function";
+}
+function isStructuredColorInput(input) {
+	return typeof input === "object" && input !== null && !Array.isArray(input) && "hue" in input && "lightness" in input;
+}
+/**
+* Matches the CSS color functions Glaze itself emits (`rgb()`, `hsl()`,
+* `okhsl()`, `oklch()`) plus their legacy alpha aliases (`rgba()`, `hsla()`).
+*
+* Only bare numeric components are supported. Named colors (`red`),
+* relative-color syntax (`from <color> ...`), and angle units other
+* than bare degrees (`deg` is the only suffix tolerated by `parseFloat`)
+* are out of scope.
+*/
+const COLOR_FN_RE = /^(rgba?|hsla?|okhsl|oklch)\(\s*([^)]*)\s*\)$/i;
+function parseNumberOrPercent(raw, percentScale) {
+	if (raw.endsWith("%")) return parseFloat(raw) / 100 * percentScale;
+	return parseFloat(raw);
+}
+/**
+* Split the body of a CSS color function into its components and detect
+* whether an alpha channel was present.
+*
+* Handles both modern slash syntax (`R G B / A` or `R, G, B / A`) and
+* legacy comma syntax (`R, G, B, A`). The alpha value itself is discarded
+* by the caller — standalone Glaze colors have no opacity field.
+*/
+function splitColorBody(body) {
+	const slashIdx = body.indexOf("/");
+	if (slashIdx !== -1) return {
+		components: body.slice(0, slashIdx).trim().split(/[\s,]+/).filter(Boolean),
+		hadAlpha: body.slice(slashIdx + 1).trim().length > 0
+	};
+	const components = body.split(/[\s,]+/).filter(Boolean);
+	if (components.length === 4) {
+		components.pop();
+		return {
+			components,
+			hadAlpha: true
+		};
+	}
+	return {
+		components,
+		hadAlpha: false
+	};
+}
+function warnDroppedAlpha(input) {
+	console.warn(`glaze: alpha component dropped from "${input}" (standalone color has no opacity field).`);
+}
+function parseColorString(input) {
+	if (input.startsWith("#")) {
+		const parsed = parseHexAlpha(input);
+		if (!parsed) throw new Error(`glaze: invalid hex color "${input}".`);
+		if (parsed.alpha !== void 0) warnDroppedAlpha(input);
+		const [h, s, l] = srgbToOkhsl(parsed.rgb);
+		return {
+			h,
+			s,
+			l
+		};
+	}
+	const m = input.match(COLOR_FN_RE);
+	if (!m) throw new Error(`glaze: unsupported color string "${input}".`);
+	const fn = m[1].toLowerCase();
+	const { components, hadAlpha } = splitColorBody(m[2].trim());
+	if (hadAlpha) warnDroppedAlpha(input);
+	if (components.length !== 3) throw new Error(`glaze: expected 3 components in "${input}".`);
+	switch (fn) {
+		case "rgb":
+		case "rgba": {
+			const [h, s, l] = srgbToOkhsl([
+				parseNumberOrPercent(components[0], 255) / 255,
+				parseNumberOrPercent(components[1], 255) / 255,
+				parseNumberOrPercent(components[2], 255) / 255
+			]);
+			return {
+				h,
+				s,
+				l
+			};
+		}
+		case "hsl":
+		case "hsla": {
+			const [oh, os, ol] = srgbToOkhsl(hslToSrgb(parseFloat(components[0]), parseNumberOrPercent(components[1], 1), parseNumberOrPercent(components[2], 1)));
+			return {
+				h: oh,
+				s: os,
+				l: ol
+			};
+		}
+		case "okhsl": return {
+			h: parseFloat(components[0]),
+			s: parseNumberOrPercent(components[1], 1),
+			l: parseNumberOrPercent(components[2], 1)
+		};
+		case "oklch": {
+			const L = parseNumberOrPercent(components[0], 1);
+			const C = parseNumberOrPercent(components[1], .4);
+			const hRad = parseFloat(components[2]) * Math.PI / 180;
+			const [h, s, l] = oklabToOkhsl([
+				L,
+				C * Math.cos(hRad),
+				C * Math.sin(hRad)
+			]);
+			return {
+				h,
+				s,
+				l
+			};
+		}
+	}
+	throw new Error(`glaze: unsupported color function "${fn}".`);
+}
+/**
+* Validate a user-supplied `OkhslColor`. Catches the common 0-100 vs 0-1
+* confusion (the structured form uses 0-100, OKHSL objects use 0-1).
+*/
+function validateOkhslColor(value) {
+	const { h, s, l } = value;
+	if (!Number.isFinite(h) || !Number.isFinite(s) || !Number.isFinite(l)) throw new Error("glaze.color: OkhslColor h/s/l must be finite numbers.");
+	if (s > 1.5 || l > 1.5) throw new Error("glaze.color: OkhslColor s/l must be in 0–1 range. Did you mean the structured form { hue, saturation, lightness } (which uses 0–100)?");
+}
+/** Validate a user-supplied `{ r, g, b }` object in 0–255. */
+function validateRgbColor(value) {
+	for (const key of [
+		"r",
+		"g",
+		"b"
+	]) {
+		const n = value[key];
+		if (!Number.isFinite(n) || n < 0 || n > 255) throw new Error(`glaze.color: RgbColor ${key} must be a finite number in 0–255 (got ${n}).`);
+	}
+}
+/** Validate a user-supplied `{ l, c, h }` OKLCh object. */
+function validateOklchColor(value) {
+	const { l, c, h } = value;
+	if (!Number.isFinite(l) || !Number.isFinite(c) || !Number.isFinite(h)) throw new Error("glaze.color: OklchColor l/c/h must be finite numbers.");
+	if (l > 1.5 || c > 1.5) throw new Error("glaze.color: OklchColor l/c must be in 0–1 range (matching oklch() strings).");
+}
+function oklchComponentsToOkhsl(l, c, hDeg) {
+	const hRad = hDeg * Math.PI / 180;
+	const [h, s, outL] = oklabToOkhsl([
+		l,
+		c * Math.cos(hRad),
+		c * Math.sin(hRad)
+	]);
+	return {
+		h,
+		s,
+		l: outL
+	};
+}
+function isRgbColorObject(value) {
+	return "r" in value && "g" in value && "b" in value;
+}
+function isOklchColorObject(value) {
+	return "c" in value && "l" in value && "h" in value;
+}
+/**
+* Validate a user-supplied `opacity` override on `glaze.color()`.
+* Must be a finite number in `0..=1`.
+*/
+function validateStandaloneOpacity(value) {
+	if (!Number.isFinite(value) || value < 0 || value > 1) throw new Error(`glaze.color: opacity must be a finite number in 0–1 (got ${value}).`);
+}
+/**
+* Validate a structured `GlazeColorInput`. Range-checks the `hue` /
+* `saturation` / `lightness` numerics (and any HC-pair second value)
+* before the resolver sees them so out-of-range or non-finite inputs
+* fail with a helpful, top-level error rather than producing a
+* NaN-laden token. `opacity` is checked here too so all input
+* validation lives in one place.
+*/
+function validateStructuredInput(input) {
+	if (!Number.isFinite(input.hue)) throw new Error(`glaze.color: structured hue must be a finite number (got ${input.hue}).`);
+	if (!Number.isFinite(input.saturation) || input.saturation < 0 || input.saturation > 100) throw new Error(`glaze.color: structured saturation must be a finite number in 0–100 (got ${input.saturation}).`);
+	const checkLightness = (value, label) => {
+		if (!Number.isFinite(value) || value < 0 || value > 100) throw new Error(`glaze.color: structured ${label} must be a finite number in 0–100 (got ${value}).`);
+	};
+	if (Array.isArray(input.lightness)) {
+		checkLightness(input.lightness[0], "lightness[normal]");
+		checkLightness(input.lightness[1], "lightness[hc]");
+	} else checkLightness(input.lightness, "lightness");
+	if (input.saturationFactor !== void 0) {
+		if (!Number.isFinite(input.saturationFactor) || input.saturationFactor < 0 || input.saturationFactor > 1) throw new Error(`glaze.color: structured saturationFactor must be a finite number in 0–1 (got ${input.saturationFactor}).`);
+	}
+	if (input.opacity !== void 0) validateStandaloneOpacity(input.opacity);
+}
+/**
+* Validate a user-supplied `name` override. Rejects empty / whitespace-only
+* strings and names colliding with `glaze`'s reserved internal sentinels.
+*/
+function validateStandaloneName(name) {
+	if (typeof name !== "string" || name.trim() === "") throw new Error("glaze.color: name must be a non-empty string. Omit `name` if you do not want to set a debug label.");
+	if (RESERVED_STANDALONE_NAMES.has(name)) {
+		const reserved = [...RESERVED_STANDALONE_NAMES].map((n) => `"${n}"`).join(", ");
+		throw new Error(`glaze.color: name "${name}" is reserved (used internally). Reserved names are: ${reserved}. Pick a different name.`);
+	}
+}
+/**
+* Extract an OKHSL color from any `GlazeColorValue` form. Also used by
+* `glaze.shadow()` so all shadow inputs (hex, color functions, OKHSL,
+* literal objects) go through one parser.
+*/
+function extractOkhslFromValue(value) {
+	if (typeof value === "string") return parseColorString(value);
+	if (Array.isArray(value)) throw new Error("glaze.color: RGB tuple [r, g, b] is no longer supported — use { r, g, b } instead.");
+	if (isRgbColorObject(value)) {
+		validateRgbColor(value);
+		const [h, s, l] = srgbToOkhsl([
+			value.r / 255,
+			value.g / 255,
+			value.b / 255
+		]);
+		return {
+			h,
+			s,
+			l
+		};
+	}
+	if (isOklchColorObject(value)) {
+		validateOklchColor(value);
+		return oklchComponentsToOkhsl(value.l, value.c, value.h);
+	}
+	validateOkhslColor(value);
+	return value;
+}
+/**
+* Build the `ColorMap` for a value-shorthand `glaze.color()` call.
+*
+* The user-facing color (`STANDALONE_VALUE`) defaults to `mode: 'auto'`
+* across every value-shorthand form, using the snapshotted
+* `globalConfig.darkLightness` window (light lightness preserved via
+* `lightLightness: false`).
+*
+* When the user requests `contrast` or relative `lightness`, a hidden
+* `STANDALONE_SEED` def is synthesized at `mode: 'static'`. That keeps
+* the seed pinned to the literal user-provided color across all four
+* variants, so the contrast solver always anchors against it.
+*/
+function buildStandaloneValueDefs(main, options) {
+	const seedHue = typeof options?.hue === "number" ? options.hue : main.h;
+	const seedSaturation = options?.saturation ?? main.s * 100;
+	const relativeHue = typeof options?.hue === "string" ? options.hue : void 0;
+	const lightnessOption = options?.lightness;
+	const hasExternalBase = options?.base !== void 0;
+	const needsSeedAnchor = !hasExternalBase && (options?.contrast !== void 0 || lightnessOption !== void 0 && !isAbsoluteLightness(lightnessOption));
+	if (options?.opacity !== void 0) validateStandaloneOpacity(options.opacity);
+	const userName = options?.name;
+	if (userName !== void 0) validateStandaloneName(userName);
+	const primary = userName ?? STANDALONE_VALUE;
+	const valueDef = {
+		hue: relativeHue,
+		saturation: options?.saturationFactor,
+		lightness: lightnessOption ?? main.l * 100,
+		contrast: options?.contrast,
+		mode: options?.mode ?? "auto",
+		opacity: options?.opacity,
+		base: hasExternalBase ? STANDALONE_BASE : needsSeedAnchor ? STANDALONE_SEED : void 0
+	};
+	const defs = { [primary]: valueDef };
+	if (needsSeedAnchor) defs[STANDALONE_SEED] = {
+		hue: main.h,
+		saturation: 1,
+		lightness: main.l * 100,
+		mode: "static"
+	};
+	return {
+		seedHue,
+		seedSaturation,
+		defs,
+		primary
+	};
+}
+function createColorTokenFromDefs(seedHue, seedSaturation, defs, primary, effectiveScaling, baseToken, exportData, autoFlip) {
+	let cached;
+	const resolveOnce = () => {
+		if (cached) return cached;
+		cached = resolveAllColors(seedHue, seedSaturation, defs, effectiveScaling, baseToken ? new Map([[STANDALONE_BASE, baseToken.resolve()]]) : void 0, autoFlip);
+		return cached;
+	};
+	const resolveStates = (options) => {
+		const cfg = getConfig();
+		return {
+			dark: options?.states?.dark ?? cfg.states.dark,
+			highContrast: options?.states?.highContrast ?? cfg.states.highContrast
+		};
+	};
+	const tokenLike = (options) => {
+		return buildTokenMap(resolveOnce(), "", resolveStates(options), resolveModes(options?.modes), options?.format)[`#${primary}`];
+	};
+	return {
+		resolve() {
+			return resolveOnce().get(primary);
+		},
+		token: tokenLike,
+		tasty: tokenLike,
+		json(options) {
+			return buildJsonMap(resolveOnce(), resolveModes(options?.modes), options?.format)[primary];
+		},
+		css(options) {
+			return buildCssMap(new Map([[options.name, resolveOnce().get(primary)]]), "", options.suffix ?? "-color", options.format ?? "rgb");
+		},
+		export: exportData
+	};
+}
+/**
+* Resolve `base` (which may be a token reference or a raw color value)
+* into a `GlazeColorToken`. Raw values are auto-wrapped via
+* `glaze.color(value)` so they pick up the same auto-invert defaults as
+* an explicit wrap. Returns `undefined` when no base is provided.
+*/
+function resolveBaseToken(base) {
+	if (base === void 0) return void 0;
+	if (isGlazeColorToken(base)) return base;
+	return createColorTokenFromValue(base, void 0, void 0);
+}
+function createColorToken(input, scaling, overrideAutoFlip) {
+	validateStructuredInput(input);
+	const userName = input.name;
+	if (userName !== void 0) validateStandaloneName(userName);
+	const primary = userName ?? STANDALONE_VALUE;
+	const baseToken = resolveBaseToken(input.base);
+	const hasExternalBase = baseToken !== void 0;
+	const needsSeedAnchor = !hasExternalBase && input.contrast !== void 0;
+	const defs = { [primary]: {
+		lightness: input.lightness,
+		saturation: input.saturationFactor,
+		mode: input.mode ?? "auto",
+		contrast: input.contrast,
+		opacity: input.opacity,
+		base: hasExternalBase ? STANDALONE_BASE : needsSeedAnchor ? STANDALONE_SEED : void 0
+	} };
+	if (needsSeedAnchor) defs[STANDALONE_SEED] = {
+		lightness: pairNormal(input.lightness),
+		saturation: 1,
+		mode: "static"
+	};
+	const effectiveScaling = scaling ?? defaultStructuredScaling();
+	const autoFlip = overrideAutoFlip ?? getConfig().autoFlip;
+	const exportData = () => ({
+		form: "structured",
+		input: buildStructuredInputExport(input),
+		scaling: effectiveScaling,
+		autoFlip
+	});
+	return createColorTokenFromDefs(input.hue, input.saturation, defs, primary, effectiveScaling, baseToken, exportData, autoFlip);
+}
+function createColorTokenFromValue(value, options, scaling, overrideAutoFlip) {
+	const main = extractOkhslFromValue(value);
+	const baseToken = resolveBaseToken(options?.base);
+	const { seedHue, seedSaturation, defs, primary } = buildStandaloneValueDefs(main, options);
+	const effectiveScaling = scaling ?? defaultValueShorthandScaling();
+	const autoFlip = overrideAutoFlip ?? getConfig().autoFlip;
+	const exportData = () => ({
+		form: "value",
+		input: value,
+		...options !== void 0 ? { overrides: buildOverridesExport(options) } : {},
+		scaling: effectiveScaling,
+		autoFlip
+	});
+	return createColorTokenFromDefs(seedHue, seedSaturation, defs, primary, effectiveScaling, baseToken, exportData, autoFlip);
+}
+/**
+* Build a JSON-safe snapshot of `GlazeColorOverrides`. `base` is
+* recursively serialized when it was originally a token; raw values are
+* preserved as-is so `glaze.colorFrom(...)` round-trips them.
+*/
+function buildOverridesExport(options) {
+	const out = {};
+	if (options.hue !== void 0) out.hue = options.hue;
+	if (options.saturation !== void 0) out.saturation = options.saturation;
+	if (options.lightness !== void 0) out.lightness = options.lightness;
+	if (options.saturationFactor !== void 0) out.saturationFactor = options.saturationFactor;
+	if (options.mode !== void 0) out.mode = options.mode;
+	if (options.contrast !== void 0) out.contrast = options.contrast;
+	if (options.opacity !== void 0) out.opacity = options.opacity;
+	if (options.name !== void 0) out.name = options.name;
+	if (options.base !== void 0) out.base = isGlazeColorToken(options.base) ? options.base.export() : options.base;
+	return out;
+}
+function buildStructuredInputExport(input) {
+	const out = {
+		hue: input.hue,
+		saturation: input.saturation,
+		lightness: input.lightness
+	};
+	if (input.saturationFactor !== void 0) out.saturationFactor = input.saturationFactor;
+	if (input.mode !== void 0) out.mode = input.mode;
+	if (input.opacity !== void 0) out.opacity = input.opacity;
+	if (input.contrast !== void 0) out.contrast = input.contrast;
+	if (input.name !== void 0) out.name = input.name;
+	if (input.base !== void 0) out.base = isGlazeColorToken(input.base) ? input.base.export() : input.base;
+	return out;
+}
+/**
+* Discriminate a `GlazeColorTokenExport` from a raw `GlazeColorValue`.
+* `GlazeColorTokenExport` always has a `form` field set to either
+* `'value'` or `'structured'`; raw values never do.
+*/
+function isExportedToken(candidate) {
+	return typeof candidate === "object" && candidate !== null && !Array.isArray(candidate) && "form" in candidate && (candidate.form === "value" || candidate.form === "structured");
+}
+function rehydrateOverrides(data) {
+	const out = {};
+	if (data.hue !== void 0) out.hue = data.hue;
+	if (data.saturation !== void 0) out.saturation = data.saturation;
+	if (data.lightness !== void 0) out.lightness = data.lightness;
+	if (data.saturationFactor !== void 0) out.saturationFactor = data.saturationFactor;
+	if (data.mode !== void 0) out.mode = data.mode;
+	if (data.contrast !== void 0) out.contrast = data.contrast;
+	if (data.opacity !== void 0) out.opacity = data.opacity;
+	if (data.name !== void 0) out.name = data.name;
+	if (data.base !== void 0) out.base = isExportedToken(data.base) ? colorFromExport(data.base) : data.base;
+	return out;
+}
+function rehydrateStructuredInput(data) {
+	const out = {
+		hue: data.hue,
+		saturation: data.saturation,
+		lightness: data.lightness
+	};
+	if (data.saturationFactor !== void 0) out.saturationFactor = data.saturationFactor;
+	if (data.mode !== void 0) out.mode = data.mode;
+	if (data.opacity !== void 0) out.opacity = data.opacity;
+	if (data.contrast !== void 0) out.contrast = data.contrast;
+	if (data.name !== void 0) out.name = data.name;
+	if (data.base !== void 0) out.base = isExportedToken(data.base) ? colorFromExport(data.base) : data.base;
+	return out;
+}
+/**
+* Rehydrate a token from its `.export()` snapshot. Recursively rebuilds
+* any base dependency. Inverse of `GlazeColorToken.export()`.
+*/
+function colorFromExport(data) {
+	if (data === null || typeof data !== "object") throw new Error(`glaze.colorFrom: expected an object from token.export(), got ${data === null ? "null" : typeof data}.`);
+	if (data.form !== "value" && data.form !== "structured") throw new Error(`glaze.colorFrom: invalid "form" field — expected "value" or "structured" (got ${JSON.stringify(data.form)}).`);
+	if (data.input === void 0) throw new Error(`glaze.colorFrom: missing "input" field — expected the original ${data.form === "value" ? "GlazeColorValue" : "GlazeColorInput"}.`);
+	if (data.form === "value") {
+		const value = data.input;
+		const overrides = data.overrides ? rehydrateOverrides(data.overrides) : void 0;
+		const cfg = getConfig();
+		const effectiveAutoFlip = data.autoFlip ?? cfg.autoFlip;
+		return createColorTokenFromValue(value, overrides, data.scaling, effectiveAutoFlip);
+	}
+	const input = rehydrateStructuredInput(data.input);
+	const cfg = getConfig();
+	const effectiveAutoFlip = data.autoFlip ?? cfg.autoFlip;
+	return createColorToken(input, data.scaling, effectiveAutoFlip);
+}
+
+//#endregion
+//#region src/palette.ts
+/**
+* Palette factory.
+*
+* Composes multiple themes into a single token namespace with optional
+* theme-name prefixes and a "primary theme" that also surfaces an
+* unprefixed copy of its tokens. All four export methods (`tokens` /
+* `tasty` / `json` / `css`) share a `buildPaletteOutput` driver that
+* handles validation, per-theme iteration, prefix resolution, collision
+* filtering, and primary duplication.
+*/
+function resolvePrefix(options, themeName, defaultPrefix = false) {
+	const prefix = options?.prefix ?? defaultPrefix;
+	if (prefix === true) return `${themeName}-`;
+	if (typeof prefix === "object" && prefix !== null) return prefix[themeName] ?? `${themeName}-`;
+	return "";
+}
+function validatePrimaryTheme(primary, themes) {
+	if (primary !== void 0 && !(primary in themes)) {
+		const available = Object.keys(themes).join(", ");
+		throw new Error(`glaze: primary theme "${primary}" not found in palette. Available: ${available}.`);
+	}
+}
+/**
+* Resolve the effective primary for an export call.
+* `false` disables, a string overrides, `undefined` inherits from palette.
+*/
+function resolveEffectivePrimary(exportPrimary, palettePrimary) {
+	if (exportPrimary === false) return void 0;
+	return exportPrimary ?? palettePrimary;
+}
+/**
+* Filter a resolved color map, skipping keys already in `seen`.
+* Warns on collision and keeps the first-written value (first-write-wins).
+* Returns a new map containing only non-colliding entries.
+*/
+function filterCollisions(resolved, prefix, seen, themeName, isPrimary) {
+	const filtered = /* @__PURE__ */ new Map();
+	const label = isPrimary ? `${themeName} (primary)` : themeName;
+	for (const [name, color] of resolved) {
+		const key = `${prefix}${name}`;
+		if (seen.has(key)) {
+			console.warn(`glaze: token "${key}" from theme "${label}" collides with theme "${seen.get(key)}" — skipping.`);
+			continue;
+		}
+		seen.set(key, label);
+		filtered.set(name, color);
+	}
+	return filtered;
+}
+/**
+* Shared per-theme driver for `tokens` / `tasty` / `css`. `json` skips
+* this because it doesn't do collision filtering or primary duplication.
+*/
+function buildPaletteOutput(themes, paletteOptions, options, buildOne, merge, empty) {
+	const effectivePrimary = resolveEffectivePrimary(options?.primary, paletteOptions?.primary);
+	if (options?.primary !== void 0) validatePrimaryTheme(effectivePrimary, themes);
+	const acc = empty();
+	const seen = /* @__PURE__ */ new Map();
+	for (const [themeName, theme] of Object.entries(themes)) {
+		const resolved = theme.resolve();
+		const prefix = resolvePrefix(options, themeName, true);
+		merge(acc, buildOne(filterCollisions(resolved, prefix, seen, themeName), prefix));
+		if (themeName === effectivePrimary) merge(acc, buildOne(filterCollisions(resolved, "", seen, themeName, true), ""));
+	}
+	return acc;
+}
+function createPalette(themes, paletteOptions) {
+	validatePrimaryTheme(paletteOptions?.primary, themes);
+	return {
+		tokens(options) {
+			const modes = resolveModes(options?.modes);
+			return buildPaletteOutput(themes, paletteOptions, options, (filtered, prefix) => buildFlatTokenMap(filtered, prefix, modes, options?.format), (acc, part) => {
+				for (const variant of Object.keys(part)) {
+					if (!acc[variant]) acc[variant] = {};
+					Object.assign(acc[variant], part[variant]);
+				}
+			}, () => ({}));
+		},
+		tasty(options) {
+			const cfg = getConfig();
+			const states = {
+				dark: options?.states?.dark ?? cfg.states.dark,
+				highContrast: options?.states?.highContrast ?? cfg.states.highContrast
+			};
+			const modes = resolveModes(options?.modes);
+			return buildPaletteOutput(themes, paletteOptions, options, (filtered, prefix) => buildTokenMap(filtered, prefix, states, modes, options?.format), (acc, part) => Object.assign(acc, part), () => ({}));
+		},
+		json(options) {
+			const modes = resolveModes(options?.modes);
+			const result = {};
+			for (const [themeName, theme] of Object.entries(themes)) result[themeName] = buildJsonMap(theme.resolve(), modes, options?.format);
+			return result;
+		},
+		css(options) {
+			const suffix = options?.suffix ?? "-color";
+			const format = options?.format ?? "rgb";
+			const lines = buildPaletteOutput(themes, paletteOptions, options, (filtered, prefix) => buildCssMap(filtered, prefix, suffix, format), (acc, part) => {
+				for (const key of [
+					"light",
+					"dark",
+					"lightContrast",
+					"darkContrast"
+				]) if (part[key]) acc[key].push(part[key]);
+			}, () => ({
+				light: [],
+				dark: [],
+				lightContrast: [],
+				darkContrast: []
+			}));
+			return {
+				light: lines.light.join("\n"),
+				dark: lines.dark.join("\n"),
+				lightContrast: lines.lightContrast.join("\n"),
+				darkContrast: lines.darkContrast.join("\n")
+			};
+		}
+	};
+}
+
+//#endregion
+//#region src/theme.ts
+/**
+* Theme factory.
+*
+* Wraps a hue/saturation seed and a mutable `ColorMap`, and exposes
+* `tokens()` / `tasty()` / `json()` / `css()` / `resolve()` / `export()`
+* / `extend()`. Caches the last resolve result so successive exports
+* with the same defs and config don't re-run the four-pass resolver.
+*/
+function createTheme(hue, saturation, initialColors) {
+	let colorDefs = initialColors ? { ...initialColors } : {};
+	let cache = null;
+	function resolveCached() {
+		const version = getConfigVersion();
+		if (cache && cache.version === version) return cache.map;
+		const map = resolveAllColors(hue, saturation, colorDefs);
+		cache = {
+			map,
+			version
+		};
+		return map;
+	}
+	function invalidate() {
+		cache = null;
+	}
+	return {
+		get hue() {
+			return hue;
+		},
+		get saturation() {
+			return saturation;
+		},
+		colors(defs) {
+			colorDefs = {
+				...colorDefs,
+				...defs
+			};
+			invalidate();
+		},
+		color(name, def) {
+			if (def === void 0) return colorDefs[name];
+			colorDefs[name] = def;
+			invalidate();
+		},
+		remove(names) {
+			const list = Array.isArray(names) ? names : [names];
+			for (const name of list) delete colorDefs[name];
+			invalidate();
+		},
+		has(name) {
+			return name in colorDefs;
+		},
+		list() {
+			return Object.keys(colorDefs);
+		},
+		reset() {
+			colorDefs = {};
+			invalidate();
+		},
+		export() {
+			return {
+				hue,
+				saturation,
+				colors: { ...colorDefs }
+			};
+		},
+		extend(options) {
+			const newHue = options.hue ?? hue;
+			const newSat = options.saturation ?? saturation;
+			const inheritedColors = {};
+			for (const [name, def] of Object.entries(colorDefs)) if (def.inherit !== false) inheritedColors[name] = def;
+			return createTheme(newHue, newSat, options.colors ? {
+				...inheritedColors,
+				...options.colors
+			} : { ...inheritedColors });
+		},
+		resolve() {
+			return new Map(resolveCached());
+		},
+		tokens(options) {
+			const modes = resolveModes(options?.modes);
+			return buildFlatTokenMap(resolveCached(), "", modes, options?.format);
+		},
+		tasty(options) {
+			const cfg = getConfig();
+			const states = {
+				dark: options?.states?.dark ?? cfg.states.dark,
+				highContrast: options?.states?.highContrast ?? cfg.states.highContrast
+			};
+			const modes = resolveModes(options?.modes);
+			return buildTokenMap(resolveCached(), "", states, modes, options?.format);
+		},
+		json(options) {
+			const modes = resolveModes(options?.modes);
+			return buildJsonMap(resolveCached(), modes, options?.format);
+		},
+		css(options) {
+			return buildCssMap(resolveCached(), "", options?.suffix ?? "-color", options?.format ?? "rgb");
+		}
+	};
+}
+
+//#endregion
+//#region src/glaze.ts
+/**
+* Glaze — OKHSL-based color theme generator.
+*
+* Public API entry. Wires `glaze()` and its attached static methods to
+* the focused modules in this folder:
+* - `theme.ts` — single-theme factory
+* - `palette.ts` — multi-theme composition
+* - `color-token.ts` — standalone single-color tokens (`glaze.color`)
+* - `shadow.ts` — standalone shadow factory (`glaze.shadow`)
+* - `formatters.ts` — variant → string (`glaze.format`)
+* - `config.ts` — global config singleton
+*/
+/**
+* Create a single-hue glaze theme.
+*
+* @example
+* ```ts
+* const primary = glaze({ hue: 280, saturation: 80 });
+* // or shorthand:
+* const primary = glaze(280, 80);
+* ```
+*/
+function glaze(hueOrOptions, saturation) {
+	if (typeof hueOrOptions === "number") return createTheme(hueOrOptions, saturation ?? 100);
+	return createTheme(hueOrOptions.hue, hueOrOptions.saturation);
+}
+/** Configure global glaze settings. */
+glaze.configure = function configure$1(config) {
+	configure(config);
+};
+/** Compose multiple themes into a palette. */
+glaze.palette = function palette(themes, options) {
+	return createPalette(themes, options);
+};
+/** Create a theme from a serialized export. */
+glaze.from = function from(data) {
+	return createTheme(data.hue, data.saturation, data.colors);
+};
+/**
+* Create a standalone single-color token.
+*
+* Two overloads:
+* - `glaze.color(input, scaling?)` — structured form:
+*   `{ hue, saturation, lightness, ... }` plus an optional per-call
+*   lightness-window override.
+* - `glaze.color(value, overrides?, scaling?)` — value-shorthand: a hex
+*   string (3/6/8 digits), one of the CSS color functions Glaze itself
+*   emits (`rgb()`, `hsl()`, `okhsl()`, `oklch()`), or literal objects
+*   `{ r, g, b }` (0–255), `{ h, s, l }` (OKHSL 0–1), `{ l, c, h }`
+*   (OKLCh, matching `oklch()` strings).
+*
+* Defaults: every input form defaults to `mode: 'auto'`. Value-shorthand
+* (strings and literal objects) snapshots `{ lightLightness: false,
+* darkLightness: globalConfig.darkLightness }` — light preserves the
+* input; dark uses the theme window. Structured `{ hue, saturation,
+* lightness, ... }` snapshots both `globalConfig` windows like a theme
+* color.
+*
+* Pass `{ mode: 'fixed' }` to opt back into the legacy linear, non-
+* inverting mapping, or `{ mode: 'static' }` to pin the same lightness
+* across every variant.
+*
+* Relative `lightness: '+N'` and `contrast: <ratio>` are anchored to
+* the literal seed (the value passed in) by default, pinned at
+* `mode: 'static'` across all four variants. Pass `overrides.base` (a
+* `GlazeColorToken`) to anchor `contrast` and relative `lightness`
+* against another color's resolved variant per scheme instead. Relative
+* `hue: '+N'` always anchors to the seed.
+*
+* Alpha components in `rgba()` / `hsla()` / slash-alpha syntax and
+* 8-digit hex are parsed but dropped with a `console.warn`.
+*/
+glaze.color = function color(input, arg2, arg3) {
+	if (isStructuredColorInput(input)) return createColorToken(input, arg2);
+	return createColorTokenFromValue(input, arg2, arg3);
+};
+/**
+* Compute a shadow color from a bg/fg pair and intensity.
+*
+* Both `bg` and `fg` accept any `GlazeColorValue` form: hex (`#rgb` /
+* `#rrggbb` / `#rrggbbaa`), `rgb()` / `hsl()` / `okhsl()` / `oklch()`
+* strings, or `{ r, g, b }` / `{ h, s, l }` / `{ l, c, h }` objects.
+*/
+glaze.shadow = function shadow(input) {
+	const bg = extractOkhslFromValue(input.bg);
+	const fg = input.fg ? extractOkhslFromValue(input.fg) : void 0;
+	const tuning = resolveShadowTuning(input.tuning);
+	return computeShadow({
+		...bg,
+		alpha: 1
+	}, fg ? {
+		...fg,
+		alpha: 1
+	} : void 0, input.intensity, tuning);
+};
+/** Format a resolved color variant as a CSS string. */
+glaze.format = function format(variant, colorFormat) {
+	return formatVariant(variant, colorFormat);
+};
+/**
+* Create a theme from a hex color string.
+* Extracts hue and saturation from the color.
+*/
+glaze.fromHex = function fromHex(hex) {
+	const rgb = parseHex(hex);
+	if (!rgb) throw new Error(`glaze: invalid hex color "${hex}".`);
+	const [h, s] = srgbToOkhsl(rgb);
+	return createTheme(h, s * 100);
+};
+/**
+* Create a theme from RGB values (0–255).
+* Extracts hue and saturation from the color.
+*/
+glaze.fromRgb = function fromRgb(r, g, b) {
+	const [h, s] = srgbToOkhsl([
+		r / 255,
+		g / 255,
+		b / 255
+	]);
+	return createTheme(h, s * 100);
+};
+/**
+* Rehydrate a `glaze.color()` token from a `.export()` snapshot.
+*
+* The snapshot is a plain JSON-safe object containing the original
+* input value, overrides (with any `base` token recursively serialized),
+* and the captured scaling. The reconstructed token is identical in
+* behavior to the original at the time of export.
+*
+* @example
+* ```ts
+* const text = glaze.color('#1a1a1a', { contrast: 'AA' });
+* const data = text.export();           // JSON-safe
+* localStorage.setItem('text', JSON.stringify(data));
+* // ...later...
+* const restored = glaze.colorFrom(JSON.parse(localStorage.getItem('text')!));
+* ```
+*/
+glaze.colorFrom = function colorFrom(data) {
+	return colorFromExport(data);
+};
+/** Get the current global configuration (for testing/debugging). */
+glaze.getConfig = function getConfig() {
+	return snapshotConfig();
+};
+/** Reset global configuration to defaults. */
+glaze.resetConfig = function resetConfig$1() {
+	resetConfig();
+};
+
+//#endregion
+export { contrastRatioFromLuminance, findLightnessForContrast, findValueForMixContrast, formatHsl, formatOkhsl, formatOklch, formatRgb, gamutClampedLuminance, glaze, hslToSrgb, okhslToLinearSrgb, okhslToOklab, okhslToSrgb, oklabToOkhsl, parseHex, parseHexAlpha, relativeLuminanceFromLinearRgb, resolveMinContrast, srgbToOkhsl };
+//# sourceMappingURL=index.mjs.map