@tenphi/tasty 0.1.0

package/dist/plugins/okhsl-plugin.mjs

@@ -0,0 +1,345 @@
+import { Lru } from "../parser/lru.mjs";
+
+//#region src/plugins/okhsl-plugin.ts
+/**
+* OKHSL Plugin for Tasty
+*
+* Converts OKHSL color syntax to RGB notation.
+* Supports angle units: deg, turn, rad, or unitless (degrees).
+*
+* Examples:
+*   okhsl(240.5 50% 50%)
+*   okhsl(240.5deg 50% 50%)
+*   okhsl(0.25turn 50% 50%)
+*   okhsl(1.57rad 50% 50%)
+*
+* Conversion math inlined from @texel/color to avoid external dependencies.
+*/
+const conversionCache = new Lru(500);
+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 OKLab_to_linear_sRGB_coefficients = [
+	[[-1.8817030993265873, -.8093650129914302], [
+		1.19086277,
+		1.76576728,
+		.59662641,
+		.75515197,
+		.56771245
+	]],
+	[[1.8144407988010998, -1.194452667805235], [
+		.73956515,
+		-.45954404,
+		.08285427,
+		.12541073,
+		-.14503204
+	]],
+	[[.13110757611180954, 1.813339709266608], [
+		1.35733652,
+		-.00915799,
+		-1.1513021,
+		-.50559606,
+		.00692167
+	]]
+];
+const TAU = 2 * Math.PI;
+const clamp = (value, min, max) => Math.max(Math.min(value, max), min);
+const constrainAngle = (angle) => (angle % 360 + 360) % 360;
+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 dot3 = (a, b) => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+const transform = (input, matrix) => [
+	dot3(input, matrix[0]),
+	dot3(input, matrix[1]),
+	dot3(input, matrix[2])
+];
+const cubed3 = (lms) => [
+	lms[0] * lms[0] * lms[0],
+	lms[1] * lms[1] * lms[1],
+	lms[2] * lms[2] * lms[2]
+];
+const OKLabToLinearSRGB = (lab) => {
+	return transform(cubed3(transform(lab, OKLab_to_LMS_M)), LMS_to_linear_sRGB_M);
+};
+const K1 = .206;
+const K2 = .03;
+const K3 = (1 + K1) / (1 + K2);
+const toeInv = (x) => (x ** 2 + K1 * x) / (K3 * (x + K2));
+const dotXY = (a, b) => a[0] * b[0] + a[1] * b[1];
+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_ * l_ * l_;
+	const m = m_ * m_ * m_;
+	const s = s_ * s_ * s_;
+	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 ldt_ = dl + dc * kl;
+		const mdt_ = dl + dc * km;
+		const sdt_ = dl + dc * ks;
+		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_ * l_ * l_;
+		const m = m_ * m_ * m_;
+		const s = s_ * s_ * s_;
+		const ldt = 3 * ldt_ * l_ * l_;
+		const mdt = 3 * mdt_ * m_ * m_;
+		const sdt = 3 * sdt_ * s_ * s_;
+		const ldt2 = 6 * ldt_ * ldt_ * l_;
+		const mdt2 = 6 * mdt_ * mdt_ * m_;
+		const sdt2 = 6 * sdt_ * sdt_ * 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) => {
+	const l = cusp[0];
+	const c = cusp[1];
+	return [c / l, c / (1 - l)];
+};
+const computeStMid = (a, b) => {
+	return [.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
+	];
+};
+const OKHSLToOKLab = (hsl) => {
+	let h = hsl[0];
+	const s = hsl[1];
+	const l = hsl[2];
+	const L = toeInv(l);
+	let a = 0;
+	let b = 0;
+	h = constrainAngle(h) / 360;
+	if (L !== 0 && L !== 1 && s !== 0) {
+		const a_ = Math.cos(TAU * h);
+		const b_ = Math.sin(TAU * h);
+		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
+	];
+};
+const okhslToSRGB = (h, s, l) => {
+	const linearRGB = OKLabToLinearSRGB(OKHSLToOKLab([
+		h,
+		s,
+		l
+	]));
+	return [
+		clamp(sRGBLinearToGamma(linearRGB[0]), 0, 1),
+		clamp(sRGBLinearToGamma(linearRGB[1]), 0, 1),
+		clamp(sRGBLinearToGamma(linearRGB[2]), 0, 1)
+	];
+};
+/**
+* Parse an angle value with optional unit.
+* Supports: deg, turn, rad, or unitless (treated as degrees).
+*/
+const parseAngle = (value) => {
+	const match = value.match(/^([+-]?\d*\.?\d+)(deg|turn|rad)?$/);
+	if (!match) return 0;
+	const num = parseFloat(match[1]);
+	switch (match[2]) {
+		case "turn": return num * 360;
+		case "rad": return num * 180 / Math.PI;
+		default: return num;
+	}
+};
+/**
+* Parse a percentage value (e.g., "50%") to a 0-1 range.
+*/
+const parsePercentage = (value) => {
+	const match = value.match(/^([+-]?\d*\.?\d+)%?$/);
+	if (!match) return 0;
+	const num = parseFloat(match[1]);
+	return value.includes("%") ? num / 100 : num;
+};
+/**
+* The okhsl function handler for tasty parser.
+* Receives parsed style groups and returns an RGB color string.
+*/
+const okhslFunc = (groups) => {
+	if (groups.length === 0 || groups[0].all.length < 3) {
+		console.warn("[okhsl] Expected 3 values (H S L), got:", groups);
+		return "rgb(0% 0% 0%)";
+	}
+	const group = groups[0];
+	const tokens = group.all;
+	const alpha = group.parts.length > 1 && group.parts[1].all.length > 0 ? group.parts[1].output : void 0;
+	const cacheKey = tokens.slice(0, 3).join(" ") + (alpha ? ` / ${alpha}` : "");
+	const cached = conversionCache.get(cacheKey);
+	if (cached) return cached;
+	const h = parseAngle(tokens[0]);
+	const s = parsePercentage(tokens[1]);
+	const l = parsePercentage(tokens[2]);
+	const [r, g, b] = okhslToSRGB(h, clamp(s, 0, 1), clamp(l, 0, 1));
+	const format = (n) => {
+		const pct = n * 100;
+		return parseFloat(pct.toFixed(1)).toString() + "%";
+	};
+	const result = alpha ? `rgb(${format(r)} ${format(g)} ${format(b)} / ${alpha})` : `rgb(${format(r)} ${format(g)} ${format(b)})`;
+	conversionCache.set(cacheKey, result);
+	return result;
+};
+
+//#endregion
+export { okhslFunc };
+//# sourceMappingURL=okhsl-plugin.mjs.map

package/dist/plugins/okhsl-plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"okhsl-plugin.mjs","names":[],"sources":["../../src/plugins/okhsl-plugin.ts"],"sourcesContent":["/**\n * OKHSL Plugin for Tasty\n *\n * Converts OKHSL color syntax to RGB notation.\n * Supports angle units: deg, turn, rad, or unitless (degrees).\n *\n * Examples:\n *   okhsl(240.5 50% 50%)\n *   okhsl(240.5deg 50% 50%)\n *   okhsl(0.25turn 50% 50%)\n *   okhsl(1.57rad 50% 50%)\n *\n * Conversion math inlined from @texel/color to avoid external dependencies.\n */\n\nimport { Lru } from '../parser/lru';\n\nimport type { StyleDetails } from '../parser/types';\nimport type { TastyPlugin, TastyPluginFactory } from './types';\n\n// Cache for OKHSL to RGB conversions\nconst conversionCache = new Lru<string, string>(500);\n\n// ============================================================================\n// Conversion Matrices (from texel-color)\n// ============================================================================\n\nconst OKLab_to_LMS_M: [number, number, number][] = [\n  [1.0, 0.3963377773761749, 0.2158037573099136],\n  [1.0, -0.1055613458156586, -0.0638541728258133],\n  [1.0, -0.0894841775298119, -1.2914855480194092],\n];\n\nconst LMS_to_linear_sRGB_M: [number, number, number][] = [\n  [4.076741636075959, -3.307711539258062, 0.2309699031821041],\n  [-1.2684379732850313, 2.6097573492876878, -0.3413193760026569],\n  [-0.004196076138675526, -0.703418617935936, 1.7076146940746113],\n];\n\nconst OKLab_to_linear_sRGB_coefficients: [\n  [[number, number], number[]],\n  [[number, number], number[]],\n  [[number, number], number[]],\n] = [\n  [\n    [-1.8817030993265873, -0.8093650129914302],\n    [1.19086277, 1.76576728, 0.59662641, 0.75515197, 0.56771245],\n  ],\n  [\n    [1.8144407988010998, -1.194452667805235],\n    [0.73956515, -0.45954404, 0.08285427, 0.12541073, -0.14503204],\n  ],\n  [\n    [0.13110757611180954, 1.813339709266608],\n    [1.35733652, -0.00915799, -1.1513021, -0.50559606, 0.00692167],\n  ],\n];\n\n// ============================================================================\n// Math Utilities\n// ============================================================================\n\nconst TAU = 2 * Math.PI;\n\nconst clamp = (value: number, min: number, max: number): number =>\n  Math.max(Math.min(value, max), min);\n\nconst constrainAngle = (angle: number): number => ((angle % 360) + 360) % 360;\n\nconst copySign = (to: number, from: number): number =>\n  Math.sign(to) === Math.sign(from) ? to : -to;\n\nconst _spow = (base: number, exp: number): number =>\n  copySign(Math.abs(base) ** exp, base);\n\n// ============================================================================\n// sRGB Gamma Conversion\n// ============================================================================\n\nconst sRGBLinearToGamma = (val: number): number => {\n  const sign = val < 0 ? -1 : 1;\n  const abs = Math.abs(val);\n  return abs > 0.0031308\n    ? sign * (1.055 * Math.pow(abs, 1 / 2.4) - 0.055)\n    : 12.92 * val;\n};\n\n// ============================================================================\n// Matrix Operations\n// ============================================================================\n\ntype Vec3 = [number, number, number];\n\nconst dot3 = (a: Vec3, b: Vec3): number =>\n  a[0] * b[0] + a[1] * b[1] + a[2] * b[2];\n\nconst transform = (input: Vec3, matrix: Vec3[]): Vec3 => [\n  dot3(input, matrix[0]),\n  dot3(input, matrix[1]),\n  dot3(input, matrix[2]),\n];\n\nconst cubed3 = (lms: Vec3): Vec3 => [\n  lms[0] * lms[0] * lms[0],\n  lms[1] * lms[1] * lms[1],\n  lms[2] * lms[2] * lms[2],\n];\n\n// ============================================================================\n// OKLab Conversion\n// ============================================================================\n\nconst OKLabToLinearSRGB = (lab: Vec3): Vec3 => {\n  const lms = transform(lab, OKLab_to_LMS_M);\n  const cubedLms = cubed3(lms);\n  return transform(cubedLms, LMS_to_linear_sRGB_M);\n};\n\n// ============================================================================\n// OKHSL to OKLab Conversion (from texel-color)\n// ============================================================================\n\nconst K1 = 0.206;\nconst K2 = 0.03;\nconst K3 = (1.0 + K1) / (1.0 + K2);\n\nconst _toe = (x: number): number =>\n  0.5 *\n  (K3 * x - K1 + Math.sqrt((K3 * x - K1) * (K3 * x - K1) + 4 * K2 * K3 * x));\n\nconst toeInv = (x: number): number => (x ** 2 + K1 * x) / (K3 * (x + K2));\n\nconst dotXY = (a: [number, number], b: [number, number]): number =>\n  a[0] * b[0] + a[1] * b[1];\n\nconst computeMaxSaturationOKLC = (a: number, b: number): number => {\n  const okCoeff = OKLab_to_linear_sRGB_coefficients;\n  const lmsToRgb = LMS_to_linear_sRGB_M;\n  const tmp2: [number, number] = [a, b];\n  const tmp3: Vec3 = [0, a, b];\n\n  let chnlCoeff: number[];\n  let chnlLMS: Vec3;\n\n  if (dotXY(okCoeff[0][0], tmp2) > 1) {\n    chnlCoeff = okCoeff[0][1];\n    chnlLMS = lmsToRgb[0];\n  } else if (dotXY(okCoeff[1][0], tmp2) > 1) {\n    chnlCoeff = okCoeff[1][1];\n    chnlLMS = lmsToRgb[1];\n  } else {\n    chnlCoeff = okCoeff[2][1];\n    chnlLMS = lmsToRgb[2];\n  }\n\n  const [k0, k1, k2, k3, k4] = chnlCoeff;\n  const [wl, wm, ws] = chnlLMS;\n\n  let sat = k0 + k1 * a + k2 * b + k3 * (a * a) + k4 * a * b;\n\n  const dotYZ = (mat: Vec3, vec: Vec3): number =>\n    mat[1] * vec[1] + mat[2] * vec[2];\n\n  const kl = dotYZ(OKLab_to_LMS_M[0], tmp3);\n  const km = dotYZ(OKLab_to_LMS_M[1], tmp3);\n  const ks = dotYZ(OKLab_to_LMS_M[2], tmp3);\n\n  const l_ = 1.0 + sat * kl;\n  const m_ = 1.0 + sat * km;\n  const s_ = 1.0 + sat * ks;\n\n  const l = l_ * l_ * l_;\n  const m = m_ * m_ * m_;\n  const s = s_ * s_ * s_;\n\n  const lds = 3.0 * kl * (l_ * l_);\n  const mds = 3.0 * km * (m_ * m_);\n  const sds = 3.0 * ks * (s_ * s_);\n\n  const lds2 = 6.0 * (kl * kl) * l_;\n  const mds2 = 6.0 * (km * km) * m_;\n  const sds2 = 6.0 * (ks * ks) * s_;\n\n  const f = wl * l + wm * m + ws * s;\n  const f1 = wl * lds + wm * mds + ws * sds;\n  const f2 = wl * lds2 + wm * mds2 + ws * sds2;\n\n  sat = sat - (f * f1) / (f1 * f1 - 0.5 * f * f2);\n\n  return sat;\n};\n\nconst findCuspOKLCH = (a: number, b: number): [number, number] => {\n  const _lmsToRgb = LMS_to_linear_sRGB_M;\n  const S_cusp = computeMaxSaturationOKLC(a, b);\n\n  const lab: Vec3 = [1, S_cusp * a, S_cusp * b];\n  const rgb_at_max = OKLabToLinearSRGB(lab);\n\n  const L_cusp = Math.cbrt(\n    1 /\n      Math.max(\n        Math.max(rgb_at_max[0], rgb_at_max[1]),\n        Math.max(rgb_at_max[2], 0.0),\n      ),\n  );\n  const C_cusp = L_cusp * S_cusp;\n\n  return [L_cusp, C_cusp];\n};\n\nconst findGamutIntersectionOKLCH = (\n  a: number,\n  b: number,\n  l1: number,\n  c1: number,\n  l0: number,\n  cusp: [number, number],\n): number => {\n  const lmsToRgb = LMS_to_linear_sRGB_M;\n  const tmp3: Vec3 = [0, a, b];\n  const floatMax = Number.MAX_VALUE;\n\n  let t: number;\n\n  const dotYZ = (mat: Vec3, vec: Vec3): number =>\n    mat[1] * vec[1] + mat[2] * vec[2];\n  const dotXYZ = (vec: Vec3, x: number, y: number, z: number): number =>\n    vec[0] * x + vec[1] * y + vec[2] * z;\n\n  if ((l1 - l0) * cusp[1] - (cusp[0] - l0) * c1 <= 0.0) {\n    const denom = c1 * cusp[0] + cusp[1] * (l0 - l1);\n    t = denom === 0 ? 0 : (cusp[1] * l0) / denom;\n  } else {\n    const denom = c1 * (cusp[0] - 1.0) + cusp[1] * (l0 - l1);\n    t = denom === 0 ? 0 : (cusp[1] * (l0 - 1.0)) / denom;\n\n    const dl = l1 - l0;\n    const dc = c1;\n\n    const kl = dotYZ(OKLab_to_LMS_M[0], tmp3);\n    const km = dotYZ(OKLab_to_LMS_M[1], tmp3);\n    const ks = dotYZ(OKLab_to_LMS_M[2], tmp3);\n\n    const ldt_ = dl + dc * kl;\n    const mdt_ = dl + dc * km;\n    const sdt_ = dl + dc * ks;\n\n    const L = l0 * (1.0 - t) + t * l1;\n    const C = t * c1;\n\n    const l_ = L + C * kl;\n    const m_ = L + C * km;\n    const s_ = L + C * ks;\n\n    const l = l_ * l_ * l_;\n    const m = m_ * m_ * m_;\n    const s = s_ * s_ * s_;\n\n    const ldt = 3 * ldt_ * l_ * l_;\n    const mdt = 3 * mdt_ * m_ * m_;\n    const sdt = 3 * sdt_ * s_ * s_;\n\n    const ldt2 = 6 * ldt_ * ldt_ * l_;\n    const mdt2 = 6 * mdt_ * mdt_ * m_;\n    const sdt2 = 6 * sdt_ * sdt_ * s_;\n\n    const r_ = dotXYZ(lmsToRgb[0], l, m, s) - 1;\n    const r1 = dotXYZ(lmsToRgb[0], ldt, mdt, sdt);\n    const r2 = dotXYZ(lmsToRgb[0], ldt2, mdt2, sdt2);\n\n    const ur = r1 / (r1 * r1 - 0.5 * r_ * r2);\n    let tr = -r_ * ur;\n\n    const g_ = dotXYZ(lmsToRgb[1], l, m, s) - 1;\n    const g1 = dotXYZ(lmsToRgb[1], ldt, mdt, sdt);\n    const g2 = dotXYZ(lmsToRgb[1], ldt2, mdt2, sdt2);\n\n    const ug = g1 / (g1 * g1 - 0.5 * g_ * g2);\n    let tg = -g_ * ug;\n\n    const b_ = dotXYZ(lmsToRgb[2], l, m, s) - 1;\n    const b1 = dotXYZ(lmsToRgb[2], ldt, mdt, sdt);\n    const b2 = dotXYZ(lmsToRgb[2], ldt2, mdt2, sdt2);\n\n    const ub = b1 / (b1 * b1 - 0.5 * b_ * b2);\n    let tb = -b_ * ub;\n\n    tr = ur >= 0.0 ? tr : floatMax;\n    tg = ug >= 0.0 ? tg : floatMax;\n    tb = ub >= 0.0 ? tb : floatMax;\n\n    t += Math.min(tr, Math.min(tg, tb));\n  }\n\n  return t;\n};\n\nconst computeSt = (cusp: [number, number]): [number, number] => {\n  const l = cusp[0];\n  const c = cusp[1];\n  return [c / l, c / (1 - l)];\n};\n\nconst computeStMid = (a: number, b: number): [number, number] => {\n  const s =\n    0.11516993 +\n    1.0 /\n      (7.4477897 +\n        4.1590124 * b +\n        a *\n          (-2.19557347 +\n            1.75198401 * b +\n            a *\n              (-2.13704948 -\n                10.02301043 * b +\n                a * (-4.24894561 + 5.38770819 * b + 4.69891013 * a))));\n\n  const t =\n    0.11239642 +\n    1.0 /\n      (1.6132032 -\n        0.68124379 * b +\n        a *\n          (0.40370612 +\n            0.90148123 * b +\n            a *\n              (-0.27087943 +\n                0.6122399 * b +\n                a * (0.00299215 - 0.45399568 * b - 0.14661872 * a))));\n\n  return [s, t];\n};\n\nconst getCs = (\n  L: number,\n  a: number,\n  b: number,\n  cusp: [number, number],\n): [number, number, number] => {\n  const cMax = findGamutIntersectionOKLCH(a, b, L, 1, L, cusp);\n  const stMax = computeSt(cusp);\n\n  const k = cMax / Math.min(L * stMax[0], (1 - L) * stMax[1]);\n\n  const stMid = computeStMid(a, b);\n\n  let ca = L * stMid[0];\n  let cb = (1.0 - L) * stMid[1];\n  const cMid =\n    0.9 * k * Math.sqrt(Math.sqrt(1.0 / (1.0 / ca ** 4 + 1.0 / cb ** 4)));\n\n  ca = L * 0.4;\n  cb = (1.0 - L) * 0.8;\n  const c0 = Math.sqrt(1.0 / (1.0 / ca ** 2 + 1.0 / cb ** 2));\n\n  return [c0, cMid, cMax];\n};\n\nconst OKHSLToOKLab = (hsl: Vec3): Vec3 => {\n  let h = hsl[0];\n  const s = hsl[1];\n  const l = hsl[2];\n\n  const L = toeInv(l);\n  let a = 0;\n  let b = 0;\n\n  h = constrainAngle(h) / 360.0;\n\n  if (L !== 0.0 && L !== 1.0 && s !== 0) {\n    const a_ = Math.cos(TAU * h);\n    const b_ = Math.sin(TAU * h);\n\n    const cusp = findCuspOKLCH(a_, b_);\n    const Cs = getCs(L, a_, b_, cusp);\n    const [c0, cMid, cMax] = Cs;\n\n    const mid = 0.8;\n    const midInv = 1.25;\n    let t: number, k0: number, k1: number, k2: number;\n\n    if (s < mid) {\n      t = midInv * s;\n      k0 = 0.0;\n      k1 = mid * c0;\n      k2 = 1.0 - k1 / cMid;\n    } else {\n      t = 5 * (s - 0.8);\n      k0 = cMid;\n      k1 = (0.2 * cMid ** 2 * 1.25 ** 2) / c0;\n      k2 = 1.0 - k1 / (cMax - cMid);\n    }\n\n    const c = k0 + (t * k1) / (1.0 - k2 * t);\n\n    a = c * a_;\n    b = c * b_;\n  }\n\n  return [L, a, b];\n};\n\n// ============================================================================\n// OKHSL to sRGB Conversion\n// ============================================================================\n\nconst okhslToSRGB = (h: number, s: number, l: number): Vec3 => {\n  // h: 0-360, s: 0-1, l: 0-1\n  const oklab = OKHSLToOKLab([h, s, l]);\n  const linearRGB = OKLabToLinearSRGB(oklab);\n\n  // Apply gamma correction and clamp\n  return [\n    clamp(sRGBLinearToGamma(linearRGB[0]), 0, 1),\n    clamp(sRGBLinearToGamma(linearRGB[1]), 0, 1),\n    clamp(sRGBLinearToGamma(linearRGB[2]), 0, 1),\n  ];\n};\n\n// ============================================================================\n// Parsing Utilities\n// ============================================================================\n\n/**\n * Parse an angle value with optional unit.\n * Supports: deg, turn, rad, or unitless (treated as degrees).\n */\nconst parseAngle = (value: string): number => {\n  const match = value.match(/^([+-]?\\d*\\.?\\d+)(deg|turn|rad)?$/);\n  if (!match) return 0;\n\n  const num = parseFloat(match[1]);\n  const unit = match[2];\n\n  switch (unit) {\n    case 'turn':\n      return num * 360;\n    case 'rad':\n      return (num * 180) / Math.PI;\n    case 'deg':\n    default:\n      return num;\n  }\n};\n\n/**\n * Parse a percentage value (e.g., \"50%\") to a 0-1 range.\n */\nconst parsePercentage = (value: string): number => {\n  const match = value.match(/^([+-]?\\d*\\.?\\d+)%?$/);\n  if (!match) return 0;\n\n  const num = parseFloat(match[1]);\n  // If the value includes %, divide by 100, otherwise assume 0-1 range\n  return value.includes('%') ? num / 100 : num;\n};\n\n// ============================================================================\n// Plugin Implementation\n// ============================================================================\n\n/**\n * The okhsl function handler for tasty parser.\n * Receives parsed style groups and returns an RGB color string.\n */\nconst okhslFunc = (groups: StyleDetails[]): string => {\n  // We expect a single group with 3 values: H, S, L\n  // and an optional slash-separated alpha part\n  if (groups.length === 0 || groups[0].all.length < 3) {\n    console.warn('[okhsl] Expected 3 values (H S L), got:', groups);\n    return 'rgb(0% 0% 0%)';\n  }\n\n  const group = groups[0];\n  const tokens = group.all;\n\n  // Alpha is in the second slash-separated part (e.g., okhsl(240 50% 50% / .5))\n  const alpha =\n    group.parts.length > 1 && group.parts[1].all.length > 0\n      ? group.parts[1].output\n      : undefined;\n\n  // Create cache key from input tokens\n  const cacheKey = tokens.slice(0, 3).join(' ') + (alpha ? ` / ${alpha}` : '');\n  const cached = conversionCache.get(cacheKey);\n  if (cached) return cached;\n\n  const h = parseAngle(tokens[0]);\n  const s = parsePercentage(tokens[1]);\n  const l = parsePercentage(tokens[2]);\n\n  const [r, g, b] = okhslToSRGB(h, clamp(s, 0, 1), clamp(l, 0, 1));\n\n  const format = (n: number): string => {\n    const pct = n * 100;\n    return parseFloat(pct.toFixed(1)).toString() + '%';\n  };\n\n  const result = alpha\n    ? `rgb(${format(r)} ${format(g)} ${format(b)} / ${alpha})`\n    : `rgb(${format(r)} ${format(g)} ${format(b)})`;\n\n  conversionCache.set(cacheKey, result);\n  return result;\n};\n\n/**\n * OKHSL Plugin for Tasty.\n *\n * Adds support for the `okhsl()` color function in tasty styles.\n *\n * @example\n * ```ts\n * import { configure } from '@tenphi/tasty';\n * import { okhslPlugin } from '@tenphi/tasty';\n *\n * configure({\n *   plugins: [okhslPlugin()],\n * });\n *\n * // Now you can use okhsl in styles:\n * const Box = tasty({\n *   styles: {\n *     fill: 'okhsl(240 50% 50%)',\n *   },\n * });\n * ```\n */\nexport const okhslPlugin: TastyPluginFactory = (): TastyPlugin => ({\n  name: 'okhsl',\n  funcs: {\n    okhsl: okhslFunc,\n  },\n});\n\n// Export the raw function for direct use if needed\nexport { okhslFunc };\n"],"mappings":"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"}

package/dist/plugins/types.d.mts

@@ -0,0 +1,49 @@
+import { StyleDetails, UnitHandler } from "../parser/types.mjs";
+import { StyleHandlerDefinition } from "../utils/styles.mjs";
+import { RecipeStyles } from "../styles/types.mjs";
+
+//#region src/plugins/types.d.ts
+/**
+ * A tasty plugin that extends the style system with custom functions, units, states, or handlers.
+ */
+interface TastyPlugin {
+  /** Unique name for the plugin (used for debugging and conflict detection) */
+  name: string;
+  /** Custom functions that transform parsed style groups into CSS values */
+  funcs?: Record<string, (groups: StyleDetails[]) => string>;
+  /** Custom units that transform numeric values (e.g., `2x` → `calc(2 * var(--gap))`) */
+  units?: Record<string, string | UnitHandler>;
+  /** Custom state aliases (e.g., `'@mobile': '@media(w < 768px)'`) */
+  states?: Record<string, string>;
+  /**
+   * Custom style handlers that transform style properties into CSS declarations.
+   * Handlers replace built-in handlers for the same style name.
+   * @example
+   * ```ts
+   * handlers: {
+   *   // Simple handler - lookup style inferred from key
+   *   fill: ({ fill }) => fill ? { 'background-color': fill } : undefined,
+   *   // Multi-property handler
+   *   spacing: [['gap', 'padding'], ({ gap, padding }) => ({ ... })],
+   * }
+   * ```
+   */
+  handlers?: Record<string, StyleHandlerDefinition>;
+  /** Predefined tokens replaced during style parsing (`$name` or `#name`) */
+  tokens?: Record<`$${string}` | `#${string}`, string | number>;
+  /**
+   * Predefined style recipes -- named style bundles that can be applied via `recipe` style property.
+   * Recipe values are flat tasty styles (no sub-element keys).
+   * @example
+   * ```ts
+   * recipes: {
+   *   card: { padding: '4x', fill: '#surface', radius: '1r', border: true },
+   *   elevated: { shadow: '2x 2x 4x #shadow' },
+   * }
+   * ```
+   */
+  recipes?: Record<string, RecipeStyles>;
+}
+//#endregion
+export { TastyPlugin };
+//# sourceMappingURL=types.d.mts.map

package/dist/plugins/types.d.ts

@@ -0,0 +1,69 @@
+import { StyleDetails, UnitHandler } from "../parser/types.js";
+import { StyleHandlerDefinition } from "../utils/styles.js";
+import { RecipeStyles } from "../styles/types.js";
+
+//#region src/plugins/types.d.ts
+/**
+ * A tasty plugin that extends the style system with custom functions, units, states, or handlers.
+ */
+interface TastyPlugin {
+  /** Unique name for the plugin (used for debugging and conflict detection) */
+  name: string;
+  /** Custom functions that transform parsed style groups into CSS values */
+  funcs?: Record<string, (groups: StyleDetails[]) => string>;
+  /** Custom units that transform numeric values (e.g., `2x` → `calc(2 * var(--gap))`) */
+  units?: Record<string, string | UnitHandler>;
+  /** Custom state aliases (e.g., `'@mobile': '@media(w < 768px)'`) */
+  states?: Record<string, string>;
+  /**
+   * Custom style handlers that transform style properties into CSS declarations.
+   * Handlers replace built-in handlers for the same style name.
+   * @example
+   * ```ts
+   * handlers: {
+   *   // Simple handler - lookup style inferred from key
+   *   fill: ({ fill }) => fill ? { 'background-color': fill } : undefined,
+   *   // Multi-property handler
+   *   spacing: [['gap', 'padding'], ({ gap, padding }) => ({ ... })],
+   * }
+   * ```
+   */
+  handlers?: Record<string, StyleHandlerDefinition>;
+  /** Predefined tokens replaced during style parsing (`$name` or `#name`) */
+  tokens?: Record<`$${string}` | `#${string}`, string | number>;
+  /**
+   * Predefined style recipes -- named style bundles that can be applied via `recipe` style property.
+   * Recipe values are flat tasty styles (no sub-element keys).
+   * @example
+   * ```ts
+   * recipes: {
+   *   card: { padding: '4x', fill: '#surface', radius: '1r', border: true },
+   *   elevated: { shadow: '2x 2x 4x #shadow' },
+   * }
+   * ```
+   */
+  recipes?: Record<string, RecipeStyles>;
+}
+/**
+ * A factory function that creates a TastyPlugin.
+ * Can optionally accept configuration options.
+ *
+ * @example
+ * ```ts
+ * // Plugin without options
+ * const okhslPlugin: TastyPluginFactory = () => ({
+ *   name: 'okhsl',
+ *   funcs: { okhsl: okhslFunc },
+ * });
+ *
+ * // Plugin with options
+ * const debugPlugin: TastyPluginFactory<{ verbose: boolean }> = (options) => ({
+ *   name: 'debug',
+ *   funcs: { debug: createDebugFunc(options.verbose) },
+ * });
+ * ```
+ */
+type TastyPluginFactory<TOptions = void> = TOptions extends void ? () => TastyPlugin : (options: TOptions) => TastyPlugin;
+//#endregion
+export { TastyPlugin, TastyPluginFactory };
+//# sourceMappingURL=types.d.ts.map

package/dist/properties/index.js

@@ -0,0 +1,158 @@
+import { getRgbValuesFromRgbaString, strToRgb } from "../utils/styles.js";
+
+//#region src/properties/index.ts
+const PROPERTIES_KEY = "@properties";
+/**
+* Valid CSS custom property name pattern (after the -- prefix).
+* Must start with a letter or underscore, followed by letters, digits, hyphens, or underscores.
+*/
+const VALID_PROPERTY_NAME_PATTERN = /^[a-z_][a-z0-9-_]*$/i;
+/**
+* Validate a CSS custom property name (the part after --).
+* Returns true if the name is valid for use as a CSS custom property.
+*/
+function isValidPropertyName(name) {
+	return VALID_PROPERTY_NAME_PATTERN.test(name);
+}
+/**
+* Check if styles object has local @properties definition.
+* Fast path: single property lookup.
+*/
+function hasLocalProperties(styles) {
+	return PROPERTIES_KEY in styles;
+}
+/**
+* Extract local @properties from styles object.
+* Returns null if no local properties (fast path).
+*/
+function extractLocalProperties(styles) {
+	const properties = styles[PROPERTIES_KEY];
+	if (!properties || typeof properties !== "object") return null;
+	return properties;
+}
+/**
+* Parse a property token name and return the CSS property name and whether it's a color.
+* Supports tasty token syntax and validates the property name.
+*
+* Token formats:
+* - `$name` → { cssName: '--name', isColor: false }
+* - `#name` → { cssName: '--name-color', isColor: true }
+* - `--name` → { cssName: '--name', isColor: false } (legacy, auto-detect color by suffix)
+* - `name` → { cssName: '--name', isColor: false } (legacy)
+*
+* @param token - The property token to parse
+* @returns Parsed result with cssName, isColor, isValid, and optional error
+*/
+function parsePropertyToken(token) {
+	if (!token || typeof token !== "string") return {
+		cssName: "",
+		isColor: false,
+		isValid: false,
+		error: "Property token must be a non-empty string"
+	};
+	let name;
+	let isColor;
+	if (token.startsWith("$")) {
+		name = token.slice(1);
+		isColor = false;
+	} else if (token.startsWith("#")) {
+		name = token.slice(1);
+		isColor = true;
+	} else if (token.startsWith("--")) {
+		name = token.slice(2);
+		isColor = token.endsWith("-color");
+	} else {
+		name = token;
+		isColor = token.endsWith("-color");
+	}
+	if (!name) return {
+		cssName: "",
+		isColor,
+		isValid: false,
+		error: "Property name cannot be empty"
+	};
+	if (!isValidPropertyName(name)) return {
+		cssName: "",
+		isColor,
+		isValid: false,
+		error: `Invalid property name "${name}". Must start with a letter or underscore, followed by letters, digits, hyphens, or underscores.`
+	};
+	let cssName;
+	if (token.startsWith("#")) cssName = `--${name}-color`;
+	else cssName = `--${name}`;
+	return {
+		cssName,
+		isColor,
+		isValid: true
+	};
+}
+/**
+* Normalize a property definition to a consistent string representation.
+* Used for comparing definitions to detect changes/conflicts.
+*
+* Keys are sorted alphabetically to ensure consistent comparison:
+* { inherits: true, syntax: '<color>' } === { syntax: '<color>', inherits: true }
+*/
+function normalizePropertyDefinition(def) {
+	const normalized = {};
+	if (def.inherits !== void 0) normalized.inherits = def.inherits;
+	if (def.initialValue !== void 0) normalized.initialValue = String(def.initialValue);
+	if (def.syntax !== void 0) normalized.syntax = def.syntax;
+	return JSON.stringify(normalized);
+}
+/**
+* Get the effective property definition for a token.
+* For color tokens (#name), auto-sets syntax to '<color>' and defaults initialValue to 'transparent'.
+*
+* @param token - Property token ($name, #name, --name, or plain name)
+* @param userDefinition - User-provided definition options
+* @returns Effective definition with cssName, definition, isValid, and optional error
+*/
+function getEffectiveDefinition(token, userDefinition) {
+	const parsed = parsePropertyToken(token);
+	if (!parsed.isValid) return {
+		cssName: "",
+		definition: userDefinition,
+		isColor: false,
+		isValid: false,
+		error: parsed.error
+	};
+	if (parsed.isColor) return {
+		cssName: parsed.cssName,
+		definition: {
+			syntax: "<color>",
+			inherits: userDefinition.inherits,
+			initialValue: userDefinition.initialValue ?? "transparent"
+		},
+		isColor: true,
+		isValid: true
+	};
+	return {
+		cssName: parsed.cssName,
+		definition: userDefinition,
+		isColor: false,
+		isValid: true
+	};
+}
+/**
+* Extract RGB triplet string from a color initial value.
+* Used when auto-creating the companion `-rgb` property for color @property definitions.
+*
+* @param initialValue - The color property's initial value (e.g., 'rgb(255 255 255)', 'transparent', '#fff')
+* @returns Space-separated RGB triplet (e.g., '255 255 255'), defaults to '0 0 0'
+*/
+function colorInitialValueToRgb(initialValue) {
+	if (initialValue == null) return "0 0 0";
+	const str = String(initialValue).trim();
+	if (!str || str === "transparent") return "0 0 0";
+	const rgba = strToRgb(str);
+	if (rgba) {
+		const values = getRgbValuesFromRgbaString(rgba);
+		if (values.length >= 3) return values.slice(0, 3).join(" ");
+	}
+	return "0 0 0";
+}
+
+//#endregion
+export { colorInitialValueToRgb, extractLocalProperties, getEffectiveDefinition, hasLocalProperties, normalizePropertyDefinition };
+//# sourceMappingURL=index.js.map