@soybeanjs/colord 0.0.4 → 0.0.6

package/dist/{colord-C3iU53g-.js → colord-CLzIbIN2.js}

@@ -1,8 +1,8 @@
-import { l as round, v as ALPHA_PRECISION } from "./utils-DajWVr6Z.js";
-import { a as parseRgbString, c as roundRgb, i as parseRgb, s as rgbToRgbString } from "./rgb-DNYno5F7.js";
-import { i as roundHsv, n as parseHsv, r as rgbToHsv } from "./hsv-BKcGyyrD.js";
-import { a as saturate, c as rgbToHsl, l as rgbToHslString, n as invert, o as parseHsl, r as lighten, s as parseHslString, t as changeAlpha, u as roundHsl } from "./manipulate-C3CvrU4m.js";
-import { t as getBrightness } from "./get-D0jfz1WU.js";
+import { l as round, v as ALPHA_PRECISION } from "./utils-CshL9w1R.js";
+import { a as parseRgbString, c as roundRgb, i as parseRgb, s as rgbToRgbString } from "./rgb-BVkoWOmR.js";
+import { i as roundHsv, n as parseHsv, r as rgbToHsv } from "./hsv-OOAVcaRH.js";
+import { a as saturate, c as rgbToHsl, l as rgbToHslString, n as invert, o as parseHsl, r as lighten, s as parseHslString, t as changeAlpha, u as roundHsl } from "./manipulate-DCHNBCkU.js";
+import { t as getBrightness } from "./get-SLuYLSG9.js";
 
 //#region src/models/hex.ts
 const hexMatcher = /^#([0-9a-f]{3,8})$/i;
@@ -27,7 +27,7 @@ const parseHex = (hexStr) => {
 };
 /** Formats any decimal number (e.g. 128) as a hexadecimal string (e.g. "08") */
 const format = (number) => {
-	const hex = number.toString(16);
+	const hex = Math.round(number).toString(16);
 	return hex.length < 2 ? `0${hex}` : hex;
 };
 /** Converts RGBA object to Hex6 or (if it has alpha channel) Hex8 string */
@@ -92,14 +92,27 @@ const colord = (input) => {
 var Colord = class {
 	parsed;
 	rgb;
+	source;
 	constructor(input) {
-		this.parsed = parse(input)[0];
+		const [rgb, format$1] = parse(input);
+		this.parsed = rgb;
 		this.rgb = this.parsed || {
 			r: 0,
 			g: 0,
 			b: 0,
 			alpha: 1
 		};
+		if (format$1 && this.parsed) this.source = {
+			format: format$1,
+			input
+		};
+	}
+	/**
+	* Get the original input format if available
+	* @internal
+	*/
+	getSource() {
+		return this.source;
 	}
 	/**
 	* Returns a boolean indicating whether or not an input has been parsed successfully.

package/dist/{colord-xpgrVWRV.d.ts → colord-Dc09uNcG.d.ts}

@@ -53,6 +53,10 @@ type AnyColor = string | ObjectColor;
 type InputObject = Record<string, unknown>;
 type Format = 'name' | 'hex' | 'rgb' | 'lrgb' | 'hsl' | 'hsv' | 'hwb' | 'xyz' | 'lab' | 'lch' | 'cmyk' | 'oklab' | 'oklch';
 type Input = string | InputObject;
+interface InputSource {
+  format: Format;
+  input: Input;
+}
 type ParseFunction<I extends Input> = (input: I) => RgbColor | null;
 type Parser<I extends Input> = [ParseFunction<I>, Format];
 type Parsers = {
@@ -69,7 +73,13 @@ declare const colord: (input: AnyColor | Colord) => Colord;
 declare class Colord {
   private readonly parsed;
   readonly rgb: RgbColor;
+  private readonly source?;
   constructor(input: AnyColor);
+  /**
+   * Get the original input format if available
+   * @internal
+   */
+  getSource(): InputSource | undefined;
   /**
    * Returns a boolean indicating whether or not an input has been parsed successfully.
    * Note: If parsing is unsuccessful, Colord defaults to black (does not throws an error).

package/dist/colord.d.ts

@@ -1,2 +1,2 @@
-import { n as colord, t as Colord } from "./colord-xpgrVWRV.js";
+import { n as colord, t as Colord } from "./colord-Dc09uNcG.js";
 export { Colord, colord };

package/dist/colord.js

@@ -1,10 +1,10 @@
-import "./utils-DajWVr6Z.js";
-import "./rgb-DNYno5F7.js";
-import { n as colord, t as Colord } from "./colord-C3iU53g-.js";
-import "./hsv-BKcGyyrD.js";
-import "./manipulate-C3CvrU4m.js";
-import "./xyz-CXEZJhV8.js";
-import "./lab-B5wAd4fu.js";
-import "./get-D0jfz1WU.js";
+import "./utils-CshL9w1R.js";
+import "./rgb-BVkoWOmR.js";
+import { n as colord, t as Colord } from "./colord-CLzIbIN2.js";
+import "./hsv-OOAVcaRH.js";
+import "./manipulate-DCHNBCkU.js";
+import "./xyz-DsYRwYO_.js";
+import "./lab-9NsKpGel.js";
+import "./get-SLuYLSG9.js";
 
 export { Colord, colord };

package/dist/{extend-DrPfn2Q1.d.ts → extend-D_jQFvDk.d.ts}

@@ -1,4 +1,4 @@
-import { m as Parsers, t as Colord } from "./colord-xpgrVWRV.js";
+import { m as Parsers, t as Colord } from "./colord-Dc09uNcG.js";
 
 //#region src/extend.d.ts
 type Plugin = (ColordClass: typeof Colord, parsers: Parsers) => void;

package/dist/{get-D0jfz1WU.js → get-SLuYLSG9.js}

@@ -1,4 +1,4 @@
-import { o as rgbToLinearRgb } from "./rgb-DNYno5F7.js";
+import { o as rgbToLinearRgb } from "./rgb-BVkoWOmR.js";
 
 //#region src/shared/get.ts
 /**

package/dist/{hsv-BKcGyyrD.js → hsv-OOAVcaRH.js}

@@ -1,4 +1,4 @@
-import { i as isPresent, l as round, n as clampHue, t as clamp, v as ALPHA_PRECISION } from "./utils-DajWVr6Z.js";
+import { i as isPresent, l as round, n as clampHue, t as clamp, v as ALPHA_PRECISION } from "./utils-CshL9w1R.js";
 
 //#region src/models/hsv.ts
 const clampHsv = (hsv) => ({

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { a as Format, c as HwbColor, d as LchColor, f as OklabColor, g as XyzColor, h as RgbColor, l as Input, n as colord, o as HslColor, p as OklchColor, r as AnyColor, s as HsvColor, t as Colord, u as LabColor } from "./colord-xpgrVWRV.js";
-import { n as extend, t as Plugin } from "./extend-DrPfn2Q1.js";
+import { a as Format, c as HwbColor, d as LchColor, f as OklabColor, g as XyzColor, h as RgbColor, l as Input, n as colord, o as HslColor, p as OklchColor, r as AnyColor, s as HsvColor, t as Colord, u as LabColor } from "./colord-Dc09uNcG.js";
+import { n as extend, t as Plugin } from "./extend-D_jQFvDk.js";
 
 //#region src/shared/parse.d.ts
 

package/dist/index.js

@@ -1,11 +1,11 @@
-import "./utils-DajWVr6Z.js";
-import "./rgb-DNYno5F7.js";
-import { a as parsers, i as getFormat, n as colord, r as random, t as Colord } from "./colord-C3iU53g-.js";
-import "./hsv-BKcGyyrD.js";
-import "./manipulate-C3CvrU4m.js";
-import "./xyz-CXEZJhV8.js";
-import "./lab-B5wAd4fu.js";
-import "./get-D0jfz1WU.js";
+import "./utils-CshL9w1R.js";
+import "./rgb-BVkoWOmR.js";
+import { a as parsers, i as getFormat, n as colord, r as random, t as Colord } from "./colord-CLzIbIN2.js";
+import "./hsv-OOAVcaRH.js";
+import "./manipulate-DCHNBCkU.js";
+import "./xyz-DsYRwYO_.js";
+import "./lab-9NsKpGel.js";
+import "./get-SLuYLSG9.js";
 
 //#region src/extend.ts
 const activePlugins = [];

package/dist/lab-9NsKpGel.js

@@ -0,0 +1,219 @@
+import { a as mul3x3, d as M_D65_TO_D50, i as isPresent, l as round, o as parseAlpha, t as clamp, u as M_D50_TO_D65, v as ALPHA_PRECISION, y as D50 } from "./utils-CshL9w1R.js";
+import { n as clampRgb } from "./rgb-BVkoWOmR.js";
+import { a as xyzToRgb, r as rgbToXyz } from "./xyz-DsYRwYO_.js";
+
+//#region src/models/lab.ts
+const EPSILON = 216 / 24389;
+const KAPPA = 24389 / 27;
+/**
+* Clamps LAB axis values as defined in CSS Color Level 4 specs.
+* https://www.w3.org/TR/css-color-4/#specifying-lab-lch
+* Note: a and b can theoretically go beyond [-128, 127], extended to [-160, 160] for wider gamut
+*/
+const clampLab = (lab) => {
+	const { l, a, b, alpha } = lab;
+	return {
+		l: clamp(l, 0, 100),
+		a: clamp(a, -160, 160),
+		b: clamp(b, -160, 160),
+		alpha: clamp(alpha)
+	};
+};
+const roundLab = (lab) => {
+	const { l, a, b, alpha } = lab;
+	return {
+		l: round(l, 3),
+		a: round(a, 3),
+		b: round(b, 3),
+		alpha: round(alpha, ALPHA_PRECISION)
+	};
+};
+/**
+* Performs RGB → CIEXYZ → LAB color conversion
+* https://www.w3.org/TR/css-color-4/#color-conversion-code
+*/
+const rgbToLab = (rgb) => {
+	const xyzD65 = rgbToXyz(rgb);
+	const { alpha } = xyzD65;
+	const [x, y, z] = mul3x3(M_D65_TO_D50, [
+		xyzD65.x,
+		xyzD65.y,
+		xyzD65.z
+	]);
+	return xyzToLabRaw({
+		x,
+		y,
+		z,
+		alpha
+	});
+};
+/**
+* Convert LAB to RGB without gamut checking (internal helper)
+*/
+const labToRgbDirect = (lab) => {
+	const xyzD50 = labToXyzRaw(lab);
+	const [x, y, z] = mul3x3(M_D50_TO_D65, [
+		xyzD50.x,
+		xyzD50.y,
+		xyzD50.z
+	]);
+	return xyzToRgb({
+		x,
+		y,
+		z,
+		alpha: lab.alpha
+	});
+};
+/**
+* Check if RGB is within sRGB gamut
+* Note: RGB values are in [0, 255] range
+*/
+const isRgbInGamut = (rgb, epsilon = .01) => {
+	return rgb.r >= -epsilon && rgb.r <= 255 + epsilon && rgb.g >= -epsilon && rgb.g <= 255 + epsilon && rgb.b >= -epsilon && rgb.b <= 255 + epsilon;
+};
+/**
+* Binary search to find maximum chroma that fits in sRGB gamut for LAB
+* Similar to LCH's findGamutChroma
+* @param l - Lightness (0-100)
+* @param hue - Hue angle in radians (atan2(b, a))
+* @param alpha - Alpha (0-1)
+* @returns Maximum chroma that fits in sRGB gamut
+*/
+const findGamutChromaForLab = (l, hue, alpha) => {
+	let min = 0;
+	let max = 150;
+	const epsilon = .01;
+	if (isRgbInGamut(labToRgbDirect({
+		l,
+		a: max * Math.cos(hue),
+		b: max * Math.sin(hue),
+		alpha
+	}))) return max;
+	while (max - min > epsilon) {
+		const mid = (min + max) / 2;
+		if (isRgbInGamut(labToRgbDirect({
+			l,
+			a: mid * Math.cos(hue),
+			b: mid * Math.sin(hue),
+			alpha
+		}))) min = mid;
+		else max = mid;
+	}
+	return min;
+};
+/**
+* Performs LAB → CIEXYZ → RGB color conversion with gamut mapping
+* https://www.w3.org/TR/css-color-4/#color-conversion-code
+*
+* Similar to LCH, if the color is out of sRGB gamut, reduce chroma
+* while preserving lightness and hue
+*/
+const labToRgb = (lab) => {
+	const { l, a, b, alpha } = lab;
+	let rgb = labToRgbDirect(lab);
+	if (!isRgbInGamut(rgb)) {
+		if (Math.sqrt(a * a + b * b) > 1e-4) {
+			const hue = Math.atan2(b, a);
+			const maxChroma = findGamutChromaForLab(l, hue, alpha);
+			rgb = labToRgbDirect({
+				l,
+				a: maxChroma * Math.cos(hue),
+				b: maxChroma * Math.sin(hue),
+				alpha
+			});
+		}
+	}
+	return clampRgb(rgb);
+};
+function xyzToLabRaw(xyz) {
+	const { x, y, z, alpha } = xyz;
+	const xr = x / D50.x;
+	const yr = y / D50.y;
+	const zr = z / D50.z;
+	const f = (t) => t > EPSILON ? Math.cbrt(t) : (KAPPA * t + 16) / 116;
+	const fx = f(xr);
+	const fy = f(yr);
+	const fz = f(zr);
+	return {
+		l: 116 * fy - 16,
+		a: 500 * (fx - fy),
+		b: 200 * (fy - fz),
+		alpha
+	};
+}
+function labToXyzRaw(lab) {
+	const { l, a, b, alpha } = lab;
+	const fy = (l + 16) / 116;
+	const fx = a / 500 + fy;
+	const fz = fy - b / 200;
+	const f3 = (t) => t * t * t > EPSILON ? t * t * t : (116 * t - 16) / KAPPA;
+	const xr = f3(fx);
+	const yr = l > KAPPA * EPSILON ? ((l + 16) / 116) ** 3 : l / KAPPA;
+	const zr = f3(fz);
+	return {
+		x: xr * D50.x,
+		y: yr * D50.y,
+		z: zr * D50.z,
+		alpha
+	};
+}
+const parseLab = ({ l, a, b, alpha = 1 }) => {
+	if (!isPresent(l) || !isPresent(a) || !isPresent(b)) return null;
+	return clampLab({
+		l: Number(l),
+		a: Number(a),
+		b: Number(b),
+		alpha: Number(alpha)
+	});
+};
+const parseLabToRgb = (input) => {
+	const lab = parseLab(input);
+	if (!lab) return null;
+	return labToRgb(lab);
+};
+/**
+* Parsing syntax: lab(L a b [/ alpha])
+* - L: <number|percentage> [0,100]
+* - a: <number> [-125,125]
+* - b: <number> [-125,125]
+* - alpha: <number|percentage> [0,1]
+*/
+const labMatcher = /^lab\(\s*([+-]?[\d.]+)%?\s+([+-]?[\d.]+)\s+([+-]?[\d.]+)(?:\s*\/\s*([+-]?[\d.]+%?))?\s*\)$/i;
+const parseLabString = (input) => {
+	const match = labMatcher.exec(input);
+	if (!match) return null;
+	const [_, l, a, b, alpha] = match;
+	return clampLab({
+		l: Number.parseFloat(l),
+		a: Number.parseFloat(a),
+		b: Number.parseFloat(b),
+		alpha: parseAlpha(alpha)
+	});
+};
+const parseLabStringToRgb = (input) => {
+	const lab = parseLabString(input);
+	if (!lab) return null;
+	return labToRgb(lab);
+};
+const toLabString = (lab) => {
+	const { l, a, b, alpha } = roundLab(lab);
+	return alpha < 1 ? `lab(${l}% ${a} ${b} / ${alpha})` : `lab(${l}% ${a} ${b})`;
+};
+const rgbToLabString = (rgb) => {
+	return toLabString(rgbToLab(rgb));
+};
+const parseLabBySource = (source) => {
+	if (!source || source.format !== "lab") return null;
+	const { input } = source;
+	if (typeof input === "string") return parseLabString(input);
+	if (typeof input === "object") return parseLab(input);
+	return null;
+};
+const toLabStringBySource = (source) => {
+	const lab = parseLabBySource(source);
+	if (!lab) return null;
+	return toLabString(lab);
+};
+
+//#endregion
+export { parseLabToRgb as a, roundLab as c, parseLabStringToRgb as i, toLabStringBySource as l, labToRgb as n, rgbToLab as o, parseLabBySource as r, rgbToLabString as s, clampLab as t };

package/dist/{manipulate-C3CvrU4m.js → manipulate-DCHNBCkU.js}

@@ -1,6 +1,6 @@
-import { i as isPresent, l as round, n as clampHue, o as parseAlpha, s as parseHue, t as clamp, v as ALPHA_PRECISION } from "./utils-DajWVr6Z.js";
-import { r as rgbToHsv, t as hsvToRgb } from "./hsv-BKcGyyrD.js";
-import { a as rgbToLab, n as labToRgb, t as clampLab } from "./lab-B5wAd4fu.js";
+import { i as isPresent, l as round, n as clampHue, o as parseAlpha, s as parseHue, t as clamp, v as ALPHA_PRECISION } from "./utils-CshL9w1R.js";
+import { r as rgbToHsv, t as hsvToRgb } from "./hsv-OOAVcaRH.js";
+import { n as labToRgb, o as rgbToLab, t as clampLab } from "./lab-9NsKpGel.js";
 
 //#region src/models/hsl.ts
 const clampHsl = (hsl) => {

package/dist/plugins/a11y.d.ts

@@ -1,5 +1,5 @@
-import { r as AnyColor } from "../colord-xpgrVWRV.js";
-import { t as Plugin } from "../extend-DrPfn2Q1.js";
+import { r as AnyColor } from "../colord-Dc09uNcG.js";
+import { t as Plugin } from "../extend-D_jQFvDk.js";
 
 //#region src/plugins/a11y.d.ts
 interface ReadabilityOptions {

package/dist/plugins/a11y.js

@@ -1,6 +1,6 @@
-import { l as round, r as floor } from "../utils-DajWVr6Z.js";
-import "../rgb-DNYno5F7.js";
-import { i as getLuminance, n as getContrast } from "../get-D0jfz1WU.js";
+import { l as round, r as floor } from "../utils-CshL9w1R.js";
+import "../rgb-BVkoWOmR.js";
+import { i as getLuminance, n as getContrast } from "../get-SLuYLSG9.js";
 
 //#region src/plugins/a11y.ts
 /**

package/dist/plugins/cmyk.d.ts

@@ -1,5 +1,5 @@
-import { i as CmykColor } from "../colord-xpgrVWRV.js";
-import { t as Plugin } from "../extend-DrPfn2Q1.js";
+import { i as CmykColor } from "../colord-Dc09uNcG.js";
+import { t as Plugin } from "../extend-D_jQFvDk.js";
 
 //#region src/plugins/cmyk.d.ts
 declare module '@soybeanjs/colord' {

package/dist/plugins/cmyk.js

@@ -1,4 +1,4 @@
-import { i as isPresent, l as round, o as parseAlpha, t as clamp, v as ALPHA_PRECISION } from "../utils-DajWVr6Z.js";
+import { i as isPresent, l as round, o as parseAlpha, t as clamp, v as ALPHA_PRECISION } from "../utils-CshL9w1R.js";
 
 //#region src/models/cmyk.ts
 /**

package/dist/plugins/harmonies.d.ts

@@ -1,4 +1,4 @@
-import { t as Plugin } from "../extend-DrPfn2Q1.js";
+import { t as Plugin } from "../extend-D_jQFvDk.js";
 
 //#region src/plugins/harmonies.d.ts
 type HarmonyType = 'analogous' | 'complementary' | 'double-split-complementary' | 'rectangle' | 'split-complementary' | 'tetradic' | 'triadic';

package/dist/plugins/hwb.d.ts

@@ -1,5 +1,5 @@
-import { c as HwbColor } from "../colord-xpgrVWRV.js";
-import { t as Plugin } from "../extend-DrPfn2Q1.js";
+import { c as HwbColor } from "../colord-Dc09uNcG.js";
+import { t as Plugin } from "../extend-D_jQFvDk.js";
 
 //#region src/plugins/hwb.d.ts
 declare module '@soybeanjs/colord' {

package/dist/plugins/hwb.js

@@ -1,5 +1,5 @@
-import { i as isPresent, l as round, n as clampHue, o as parseAlpha, s as parseHue, t as clamp, v as ALPHA_PRECISION } from "../utils-DajWVr6Z.js";
-import { r as rgbToHsv, t as hsvToRgb } from "../hsv-BKcGyyrD.js";
+import { i as isPresent, l as round, n as clampHue, o as parseAlpha, s as parseHue, t as clamp, v as ALPHA_PRECISION } from "../utils-CshL9w1R.js";
+import { r as rgbToHsv, t as hsvToRgb } from "../hsv-OOAVcaRH.js";
 
 //#region src/models/hwb.ts
 const clampHwb = (hwb) => {

package/dist/plugins/lab.d.ts

@@ -1,5 +1,5 @@
-import { r as AnyColor, u as LabColor } from "../colord-xpgrVWRV.js";
-import { t as Plugin } from "../extend-DrPfn2Q1.js";
+import { r as AnyColor, u as LabColor } from "../colord-Dc09uNcG.js";
+import { t as Plugin } from "../extend-D_jQFvDk.js";
 
 //#region src/plugins/lab.d.ts
 declare module '@soybeanjs/colord' {
@@ -9,6 +9,10 @@ declare module '@soybeanjs/colord' {
      * The object always includes `alpha` value [0, 1].
      */
     toLab(): LabColor;
+    /**
+     * Converts a color to CIELAB color space and returns a string.
+     */
+    toLabString(): string;
     /**
      * Calculates the perceived color difference for two colors according to
      * [Delta E2000](https://en.wikipedia.org/wiki/Color_difference#CIEDE2000).

package/dist/plugins/lab.js

@@ -1,8 +1,8 @@
-import { l as round, t as clamp } from "../utils-DajWVr6Z.js";
-import "../rgb-DNYno5F7.js";
-import "../xyz-CXEZJhV8.js";
-import { a as rgbToLab, i as parseLabString, o as roundLab, r as parseLab } from "../lab-B5wAd4fu.js";
-import { r as getDeltaE2000 } from "../get-D0jfz1WU.js";
+import { l as round, t as clamp } from "../utils-CshL9w1R.js";
+import "../rgb-BVkoWOmR.js";
+import "../xyz-DsYRwYO_.js";
+import { a as parseLabToRgb, c as roundLab, i as parseLabStringToRgb, l as toLabStringBySource, o as rgbToLab, r as parseLabBySource, s as rgbToLabString } from "../lab-9NsKpGel.js";
+import { r as getDeltaE2000 } from "../get-SLuYLSG9.js";
 
 //#region src/plugins/lab.ts
 /**
@@ -11,14 +11,17 @@ import { r as getDeltaE2000 } from "../get-D0jfz1WU.js";
 */
 const labPlugin = (ColordClass, parsers) => {
 	ColordClass.prototype.toLab = function toLab() {
-		return roundLab(rgbToLab(this.rgb));
+		return roundLab(parseLabBySource(this.getSource()) || rgbToLab(this.rgb));
+	};
+	ColordClass.prototype.toLabString = function toLabString() {
+		return toLabStringBySource(this.getSource()) || rgbToLabString(this.rgb);
 	};
 	ColordClass.prototype.delta = function delta(color = "#FFF") {
 		const compared = color instanceof ColordClass ? color : new ColordClass(color);
 		return clamp(round(getDeltaE2000(this.toLab(), compared.toLab()) / 100, 3));
 	};
-	parsers.object.push([parseLab, "lab"]);
-	parsers.string.push([parseLabString, "lab"]);
+	parsers.string.push([parseLabStringToRgb, "lab"]);
+	parsers.object.push([parseLabToRgb, "lab"]);
 };
 var lab_default = labPlugin;
 

package/dist/plugins/lch.d.ts

@@ -1,5 +1,5 @@
-import { d as LchColor } from "../colord-xpgrVWRV.js";
-import { t as Plugin } from "../extend-DrPfn2Q1.js";
+import { d as LchColor } from "../colord-Dc09uNcG.js";
+import { t as Plugin } from "../extend-D_jQFvDk.js";
 
 //#region src/plugins/lch.d.ts
 declare module '@soybeanjs/colord' {