@tenphi/glaze 1.5.0 → 2.0.1

package/dist/index.d.cts

@@ -1698,7 +1698,11 @@ declare function okhslToOkhst(c: {
 };
 /**
  * Edge adapter: a resolved variant stores canonical tone `t` (0–1). Convert
- * it to the OKHSL `{ h, s, l }` the formatters and luminance pipeline expect.
+ * it to the OKHSL `{ h, s, l }` the formatters and luminance pipeline expect —
+ * `s` and `l` on the same 0–1 factor scale, so `const { h, s, l } =
+ * variantToOkhsl(v)` destructures straight into `formatOkhsl` / `formatRgb` /
+ * `okhslToLinearSrgb` with no rescaling. `alpha` stays on the variant; use
+ * `glaze.format(v, format)` for a string that carries it.
  */
 declare function variantToOkhsl(v: {
   h: number;
@@ -1753,6 +1757,7 @@ declare function relativeLuminanceFromLinearRgb(rgb: [number, number, number]):
 declare function contrastRatioFromLuminance(yA: number, yB: number): number;
 /**
  * Convert OKHSL to gamma-encoded sRGB (clamped to 0–1).
+ * h: 0–360, s: 0–1, l: 0–1. Returns [r, g, b] with each channel 0–1.
  */
 declare function okhslToSrgb(h: number, s: number, l: number, pastel?: boolean): [number, number, number];
 /**
@@ -1799,12 +1804,12 @@ declare function parseHexAlpha(hex: string): {
 } | null;
 /**
  * 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).
+ * h: 0–360, s: 0–1, l: 0–1 (factor scale, as returned by every converter).
  */
 declare function formatOkhsl(h: number, s: number, l: number, pastel?: boolean): string;
 /**
  * Format OKHST values as a CSS `okhst(H S% T%)` string.
- * h: 0–360, s: 0–100, t: 0–100 (percentage scale for s and t).
+ * h: 0–360, s: 0–1, t: 0–1 (factor scale, matching `ResolvedColorVariant`).
  *
  * Pastel recompute matches `formatOkhsl`: convert via OKLab so external
  * parsers that only understand non-pastel OKHST render identically.
@@ -1813,17 +1818,17 @@ declare function formatOkhst(h: number, s: number, t: number, pastel?: boolean):
 /**
  * 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).
+ * h: 0–360, s: 0–1, l: 0–1 (factor scale, as returned by every converter).
  */
 declare function formatRgb(h: number, s: number, l: number, pastel?: boolean): string;
 /**
  * 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).
+ * h: 0–360, s: 0–1, l: 0–1 (factor scale, as returned by every converter).
  */
 declare function formatHsl(h: number, s: number, l: number, pastel?: boolean): string;
 /**
  * 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).
+ * h: 0–360, s: 0–1, l: 0–1 (factor scale, as returned by every converter).
  */
 declare function formatOklch(h: number, s: number, l: number, pastel?: boolean): string;
 /**

package/dist/index.d.mts

@@ -1698,7 +1698,11 @@ declare function okhslToOkhst(c: {
 };
 /**
  * Edge adapter: a resolved variant stores canonical tone `t` (0–1). Convert
- * it to the OKHSL `{ h, s, l }` the formatters and luminance pipeline expect.
+ * it to the OKHSL `{ h, s, l }` the formatters and luminance pipeline expect —
+ * `s` and `l` on the same 0–1 factor scale, so `const { h, s, l } =
+ * variantToOkhsl(v)` destructures straight into `formatOkhsl` / `formatRgb` /
+ * `okhslToLinearSrgb` with no rescaling. `alpha` stays on the variant; use
+ * `glaze.format(v, format)` for a string that carries it.
  */
 declare function variantToOkhsl(v: {
   h: number;
@@ -1753,6 +1757,7 @@ declare function relativeLuminanceFromLinearRgb(rgb: [number, number, number]):
 declare function contrastRatioFromLuminance(yA: number, yB: number): number;
 /**
  * Convert OKHSL to gamma-encoded sRGB (clamped to 0–1).
+ * h: 0–360, s: 0–1, l: 0–1. Returns [r, g, b] with each channel 0–1.
  */
 declare function okhslToSrgb(h: number, s: number, l: number, pastel?: boolean): [number, number, number];
 /**
@@ -1799,12 +1804,12 @@ declare function parseHexAlpha(hex: string): {
 } | null;
 /**
  * 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).
+ * h: 0–360, s: 0–1, l: 0–1 (factor scale, as returned by every converter).
  */
 declare function formatOkhsl(h: number, s: number, l: number, pastel?: boolean): string;
 /**
  * Format OKHST values as a CSS `okhst(H S% T%)` string.
- * h: 0–360, s: 0–100, t: 0–100 (percentage scale for s and t).
+ * h: 0–360, s: 0–1, t: 0–1 (factor scale, matching `ResolvedColorVariant`).
  *
  * Pastel recompute matches `formatOkhsl`: convert via OKLab so external
  * parsers that only understand non-pastel OKHST render identically.
@@ -1813,17 +1818,17 @@ declare function formatOkhst(h: number, s: number, t: number, pastel?: boolean):
 /**
  * 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).
+ * h: 0–360, s: 0–1, l: 0–1 (factor scale, as returned by every converter).
  */
 declare function formatRgb(h: number, s: number, l: number, pastel?: boolean): string;
 /**
  * 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).
+ * h: 0–360, s: 0–1, l: 0–1 (factor scale, as returned by every converter).
  */
 declare function formatHsl(h: number, s: number, l: number, pastel?: boolean): string;
 /**
  * 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).
+ * h: 0–360, s: 0–1, l: 0–1 (factor scale, as returned by every converter).
  */
 declare function formatOklch(h: number, s: number, l: number, pastel?: boolean): string;
 /**

package/dist/index.mjs

@@ -370,6 +370,7 @@ const sRGBGammaToLinear = (val) => {
 };
 /**
 * Convert OKHSL to gamma-encoded sRGB (clamped to 0–1).
+* h: 0–360, s: 0–1, l: 0–1. Returns [r, g, b] with each channel 0–1.
 */
 function okhslToSrgb(h, s, l, pastel = false) {
 	const lin = okhslToLinearSrgb(h, s, l, pastel);
@@ -579,47 +580,72 @@ function fmt$1(value, decimals) {
 	return parseFloat(value.toFixed(decimals)).toString();
 }
 /**
+* Every `format*` writer takes `s` / `l` / `t` on the **0–1 factor scale** —
+* the same scale every producer in the library hands back (`resolve()`,
+* `variantToOkhsl`, `srgbToOkhsl`, `oklabToOkhsl`, `okhslToOklab`,
+* `okhslToSrgb`). The percentages are an output detail: the writers multiply
+* by 100 themselves when the CSS syntax asks for a percentage.
+*
+* Before 2.0 the writers took 0–100 while everything producing those values
+* returned 0–1, so the obvious composition was off by 100x and failed
+* silently — `0.7` is a legal percentage, so the result was a valid CSS string
+* naming a near-black color. A value above 1 can only be that old
+* percentage-scale input, so warn about it loudly rather than emit a wrong
+* color quietly.
+*/
+const scaleWarnCache = /* @__PURE__ */ new Set();
+function warnPercentScale(fn, ...values) {
+	if (!values.some((v) => v > 1.000001)) return;
+	if (!scaleWarnCache.has(fn)) {
+		scaleWarnCache.add(fn);
+		console.warn(`glaze: ${fn}() got a value above 1 — it takes the 0-1 factors every Glaze producer returns (resolve(), variantToOkhsl, srgbToOkhsl), not 0-100 percentages. Divide by 100, or drop the "* 100" left over from the pre-2.0 signature.`);
+	}
+}
+/**
 * 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).
+* h: 0–360, s: 0–1, l: 0–1 (factor scale, as returned by every converter).
 */
 function formatOkhsl(h, s, l, pastel = false) {
+	warnPercentScale("formatOkhsl", s, l);
 	let outS = s;
-	if (pastel) outS = oklabToOkhsl(okhslToOklab(h, s / 100, l / 100, true), false)[1] * 100;
-	return `okhsl(${fmt$1(h, 2)} ${fmt$1(outS, 2)}% ${fmt$1(l, 2)}%)`;
+	if (pastel) outS = oklabToOkhsl(okhslToOklab(h, s, l, true), false)[1];
+	return `okhsl(${fmt$1(h, 2)} ${fmt$1(outS * 100, 2)}% ${fmt$1(l * 100, 2)}%)`;
 }
 /**
 * Format OKHST values as a CSS `okhst(H S% T%)` string.
-* h: 0–360, s: 0–100, t: 0–100 (percentage scale for s and t).
+* h: 0–360, s: 0–1, t: 0–1 (factor scale, matching `ResolvedColorVariant`).
 *
 * Pastel recompute matches `formatOkhsl`: convert via OKLab so external
 * parsers that only understand non-pastel OKHST render identically.
 */
 function formatOkhst(h, s, t, pastel = false) {
+	warnPercentScale("formatOkhst", s, t);
 	let outS = s;
 	if (pastel) {
 		const REF_EPS = .05;
 		const den = Math.log(1 + REF_EPS) - Math.log(REF_EPS);
-		const y = Math.exp(t / 100 * den + Math.log(REF_EPS)) - REF_EPS;
-		const l = toe(Math.cbrt(Math.max(0, y)));
-		outS = oklabToOkhsl(okhslToOklab(h, s / 100, l, true), false)[1] * 100;
+		const y = Math.exp(t * den + Math.log(REF_EPS)) - REF_EPS;
+		outS = oklabToOkhsl(okhslToOklab(h, s, toe(Math.cbrt(Math.max(0, y))), true), false)[1];
 	}
-	return `okhst(${fmt$1(h, 2)} ${fmt$1(outS, 2)}% ${fmt$1(t, 2)}%)`;
+	return `okhst(${fmt$1(h, 2)} ${fmt$1(outS * 100, 2)}% ${fmt$1(t * 100, 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).
+* h: 0–360, s: 0–1, l: 0–1 (factor scale, as returned by every converter).
 */
 function formatRgb(h, s, l, pastel = false) {
-	const [r, g, b] = okhslToSrgb(h, s / 100, l / 100, pastel);
+	warnPercentScale("formatRgb", s, l);
+	const [r, g, b] = okhslToSrgb(h, s, l, pastel);
 	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).
+* h: 0–360, s: 0–1, l: 0–1 (factor scale, as returned by every converter).
 */
 function formatHsl(h, s, l, pastel = false) {
-	const [r, g, b] = okhslToSrgb(h, s / 100, l / 100, pastel);
+	warnPercentScale("formatHsl", s, l);
+	const [r, g, b] = okhslToSrgb(h, s, l, pastel);
 	const max = Math.max(r, g, b);
 	const min = Math.min(r, g, b);
 	const delta = max - min;
@@ -636,10 +662,11 @@ function formatHsl(h, s, l, pastel = false) {
 }
 /**
 * 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).
+* h: 0–360, s: 0–1, l: 0–1 (factor scale, as returned by every converter).
 */
 function formatOklch(h, s, l, pastel = false) {
-	const [L, C, hh] = okhslToOklch(h, s / 100, l / 100, pastel);
+	warnPercentScale("formatOklch", s, l);
+	const [L, C, hh] = okhslToOklch(h, s, l, pastel);
 	return `oklch(${fmt$1(L, 4)} ${fmt$1(C, 4)} ${fmt$1(hh, 2)})`;
 }
 /**
@@ -1117,7 +1144,11 @@ function okhslToOkhst(c) {
 }
 /**
 * Edge adapter: a resolved variant stores canonical tone `t` (0–1). Convert
-* it to the OKHSL `{ h, s, l }` the formatters and luminance pipeline expect.
+* it to the OKHSL `{ h, s, l }` the formatters and luminance pipeline expect —
+* `s` and `l` on the same 0–1 factor scale, so `const { h, s, l } =
+* variantToOkhsl(v)` destructures straight into `formatOkhsl` / `formatRgb` /
+* `okhslToLinearSrgb` with no rescaling. `alpha` stays on the variant; use
+* `glaze.format(v, format)` for a string that carries it.
 */
 function variantToOkhsl(v) {
 	return {
@@ -3024,10 +3055,10 @@ function fmt(value, decimals) {
 function formatVariant(v, format = "oklch", pastel = false) {
 	const effectivePastel = v.pastel ?? pastel;
 	let base;
-	if (format === "okhst") base = formatOkhst(v.h, v.s * 100, v.t * 100, effectivePastel);
+	if (format === "okhst") base = formatOkhst(v.h, v.s, v.t, effectivePastel);
 	else {
 		const { l } = variantToOkhsl(v);
-		base = formatters[format](v.h, v.s * 100, l * 100, effectivePastel);
+		base = formatters[format](v.h, v.s, l, effectivePastel);
 	}
 	if (v.alpha >= 1) return base;
 	const closing = base.lastIndexOf(")");
@@ -3043,7 +3074,7 @@ function formatVariantHue(v, plan, pastel = false) {
 	const [L, C] = okhslToOklch(v.h, v.s, l, effectivePastel);
 	let base;
 	if (plan.inline) if (v.s <= 1e-6) base = `oklch(${fmt(L, 4)} 0 0)`;
-	else base = formatOklch(v.h, v.s * 100, l * 100, effectivePastel);
+	else base = formatOklch(v.h, v.s, l, effectivePastel);
 	else base = `oklch(${fmt(L, 4)} ${fmt(C, 4)} ${plan.hueVar})`;
 	if (v.alpha >= 1) return base;
 	const closing = base.lastIndexOf(")");