chromonym 1.0.1 → 1.2.0

package/dist/conversions/hex.d.ts

@@ -0,0 +1,13 @@
+import type { HexColor, Rgba } from '../types';
+/**
+ * Parse a hex color string into the canonical Rgba representation.
+ * Accepts 3-digit (`#rgb`), 6-digit (`#rrggbb`), and 8-digit (`#rrggbbaa`).
+ * Throws on any other input shape.
+ */
+export declare function hexToRgba(hex: HexColor): Rgba;
+/**
+ * Emit a 6-digit lowercase hex string. Alpha is dropped; out-of-range
+ * channel values are clamped to 0..255; fractional values are rounded.
+ */
+export declare function rgbaToHex(rgba: Rgba): HexColor;
+//# sourceMappingURL=hex.d.ts.map

package/dist/conversions/hex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/conversions/hex.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAsB7C;AAMD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,CAE9C"}

package/dist/conversions/hex.js

@@ -0,0 +1,40 @@
+import { HEX_RE } from '../detectFormat';
+import { clamp } from '../math/clamp';
+/**
+ * Parse a hex color string into the canonical Rgba representation.
+ * Accepts 3-digit (`#rgb`), 6-digit (`#rrggbb`), and 8-digit (`#rrggbbaa`).
+ * Throws on any other input shape.
+ */
+export function hexToRgba(hex) {
+    const match = HEX_RE.exec(hex);
+    const body = match?.[1];
+    if (!body)
+        throw new Error(`Invalid hex color: ${hex}`);
+    if (body.length === 3) {
+        const r = body.charAt(0);
+        const g = body.charAt(1);
+        const b = body.charAt(2);
+        return {
+            r: parseInt(r + r, 16),
+            g: parseInt(g + g, 16),
+            b: parseInt(b + b, 16),
+            a: 1,
+        };
+    }
+    const r = parseInt(body.slice(0, 2), 16);
+    const g = parseInt(body.slice(2, 4), 16);
+    const b = parseInt(body.slice(4, 6), 16);
+    const a = body.length === 8 ? parseInt(body.slice(6, 8), 16) / 255 : 1;
+    return { r, g, b, a };
+}
+function channelToHex(n) {
+    return clamp(Math.round(n), 0, 255).toString(16).padStart(2, '0');
+}
+/**
+ * Emit a 6-digit lowercase hex string. Alpha is dropped; out-of-range
+ * channel values are clamped to 0..255; fractional values are rounded.
+ */
+export function rgbaToHex(rgba) {
+    return `#${channelToHex(rgba.r)}${channelToHex(rgba.g)}${channelToHex(rgba.b)}`;
+}
+//# sourceMappingURL=hex.js.map

package/dist/conversions/hex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.js","sourceRoot":"","sources":["../../src/conversions/hex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGtC;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,GAAa;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;IAExD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACzB,OAAO;YACL,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACtB,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACtB,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACtB,CAAC,EAAE,CAAC;SACL,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACpE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAU;IAClC,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAc,CAAC;AAC9F,CAAC"}

package/dist/conversions/hsl.d.ts

@@ -0,0 +1,12 @@
+import type { HslInput, HslString, Rgba } from '../types';
+/**
+ * Parse HSL input (string or object) into canonical Rgba.
+ * Hue wraps modulo 360; saturation and lightness are 0..100 percent.
+ */
+export declare function hslToRgba(input: HslInput): Rgba;
+/**
+ * Emit an `hsl(h, s%, l%)` string from Rgba. Alpha is dropped; all
+ * three components are rounded to whole numbers.
+ */
+export declare function rgbaToHsl(rgba: Rgba): HslString;
+//# sourceMappingURL=hsl.d.ts.map

package/dist/conversions/hsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hsl.d.ts","sourceRoot":"","sources":["../../src/conversions/hsl.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAK1D;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAqC/C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,CAyB/C"}

package/dist/conversions/hsl.js

@@ -0,0 +1,72 @@
+import { requireFinite } from '../math/clamp';
+import { hueSectorToPrime } from '../math/hueSector';
+const HSL_RE = /^hsl\s*\(\s*(-?\d+(?:\.\d+)?)\s*,\s*(-?\d+(?:\.\d+)?)%?\s*,\s*(-?\d+(?:\.\d+)?)%?\s*\)$/i;
+/**
+ * Parse HSL input (string or object) into canonical Rgba.
+ * Hue wraps modulo 360; saturation and lightness are 0..100 percent.
+ */
+export function hslToRgba(input) {
+    let h;
+    let s;
+    let l;
+    if (typeof input === 'string') {
+        const match = HSL_RE.exec(input);
+        if (!match)
+            throw new Error(`Invalid hsl string: ${input}`);
+        h = Number(match[1]);
+        s = Number(match[2]);
+        l = Number(match[3]);
+    }
+    else {
+        h = requireFinite(input.h, 'h');
+        s = requireFinite(input.s, 's');
+        l = requireFinite(input.l, 'l');
+    }
+    const saturation = s / 100;
+    const lightness = l / 100;
+    if (saturation === 0) {
+        const gray = Math.round(lightness * 255);
+        return { r: gray, g: gray, b: gray, a: 1 };
+    }
+    const chroma = (1 - Math.abs(2 * lightness - 1)) * saturation;
+    const hueSector = (((h % 360) + 360) % 360) / 60;
+    const secondary = chroma * (1 - Math.abs((hueSector % 2) - 1));
+    const lightnessOffset = lightness - chroma / 2;
+    const [rPrime, gPrime, bPrime] = hueSectorToPrime(hueSector, chroma, secondary);
+    return {
+        r: Math.round((rPrime + lightnessOffset) * 255),
+        g: Math.round((gPrime + lightnessOffset) * 255),
+        b: Math.round((bPrime + lightnessOffset) * 255),
+        a: 1,
+    };
+}
+/**
+ * Emit an `hsl(h, s%, l%)` string from Rgba. Alpha is dropped; all
+ * three components are rounded to whole numbers.
+ */
+export function rgbaToHsl(rgba) {
+    const rNorm = rgba.r / 255;
+    const gNorm = rgba.g / 255;
+    const bNorm = rgba.b / 255;
+    const max = Math.max(rNorm, gNorm, bNorm);
+    const min = Math.min(rNorm, gNorm, bNorm);
+    const lightness = (max + min) / 2;
+    if (max === min) {
+        return `hsl(0, 0%, ${Math.round(lightness * 100)}%)`;
+    }
+    const delta = max - min;
+    const saturation = lightness > 0.5 ? delta / (2 - max - min) : delta / (max + min);
+    let hue;
+    if (max === rNorm) {
+        hue = (gNorm - bNorm) / delta + (gNorm < bNorm ? 6 : 0);
+    }
+    else if (max === gNorm) {
+        hue = (bNorm - rNorm) / delta + 2;
+    }
+    else {
+        hue = (rNorm - gNorm) / delta + 4;
+    }
+    hue *= 60;
+    return `hsl(${Math.round(hue)}, ${Math.round(saturation * 100)}%, ${Math.round(lightness * 100)}%)`;
+}
+//# sourceMappingURL=hsl.js.map

package/dist/conversions/hsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hsl.js","sourceRoot":"","sources":["../../src/conversions/hsl.ts"],"names":[],"mappings":"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"}

package/dist/conversions/hsv.d.ts

@@ -0,0 +1,12 @@
+import type { HsvInput, HsvString, Rgba } from '../types';
+/**
+ * Parse HSV input (string or object) into canonical Rgba.
+ * Hue wraps modulo 360; saturation and value are 0..100 percent.
+ */
+export declare function hsvToRgba(input: HsvInput): Rgba;
+/**
+ * Emit an `hsv(h, s%, v%)` string from Rgba. Alpha is dropped; all
+ * three components are rounded to whole numbers.
+ */
+export declare function rgbaToHsv(rgba: Rgba): HsvString;
+//# sourceMappingURL=hsv.d.ts.map

package/dist/conversions/hsv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hsv.d.ts","sourceRoot":"","sources":["../../src/conversions/hsv.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAK1D;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CA+B/C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,CAuB/C"}

package/dist/conversions/hsv.js

@@ -0,0 +1,67 @@
+import { requireFinite } from '../math/clamp';
+import { hueSectorToPrime } from '../math/hueSector';
+const HSV_RE = /^hsv\s*\(\s*(-?\d+(?:\.\d+)?)\s*,\s*(-?\d+(?:\.\d+)?)%?\s*,\s*(-?\d+(?:\.\d+)?)%?\s*\)$/i;
+/**
+ * Parse HSV input (string or object) into canonical Rgba.
+ * Hue wraps modulo 360; saturation and value are 0..100 percent.
+ */
+export function hsvToRgba(input) {
+    let h;
+    let s;
+    let v;
+    if (typeof input === 'string') {
+        const match = HSV_RE.exec(input);
+        if (!match)
+            throw new Error(`Invalid hsv string: ${input}`);
+        h = Number(match[1]);
+        s = Number(match[2]);
+        v = Number(match[3]);
+    }
+    else {
+        h = requireFinite(input.h, 'h');
+        s = requireFinite(input.s, 's');
+        v = requireFinite(input.v, 'v');
+    }
+    const saturation = s / 100;
+    const value = v / 100;
+    const chroma = value * saturation;
+    const hueSector = (((h % 360) + 360) % 360) / 60;
+    const secondary = chroma * (1 - Math.abs((hueSector % 2) - 1));
+    const valueOffset = value - chroma;
+    const [rPrime, gPrime, bPrime] = hueSectorToPrime(hueSector, chroma, secondary);
+    return {
+        r: Math.round((rPrime + valueOffset) * 255),
+        g: Math.round((gPrime + valueOffset) * 255),
+        b: Math.round((bPrime + valueOffset) * 255),
+        a: 1,
+    };
+}
+/**
+ * Emit an `hsv(h, s%, v%)` string from Rgba. Alpha is dropped; all
+ * three components are rounded to whole numbers.
+ */
+export function rgbaToHsv(rgba) {
+    const rNorm = rgba.r / 255;
+    const gNorm = rgba.g / 255;
+    const bNorm = rgba.b / 255;
+    const max = Math.max(rNorm, gNorm, bNorm);
+    const min = Math.min(rNorm, gNorm, bNorm);
+    const delta = max - min;
+    const value = max;
+    const saturation = max === 0 ? 0 : delta / max;
+    let hue = 0;
+    if (delta !== 0) {
+        if (max === rNorm) {
+            hue = (gNorm - bNorm) / delta + (gNorm < bNorm ? 6 : 0);
+        }
+        else if (max === gNorm) {
+            hue = (bNorm - rNorm) / delta + 2;
+        }
+        else {
+            hue = (rNorm - gNorm) / delta + 4;
+        }
+        hue *= 60;
+    }
+    return `hsv(${Math.round(hue)}, ${Math.round(saturation * 100)}%, ${Math.round(value * 100)}%)`;
+}
+//# sourceMappingURL=hsv.js.map

package/dist/conversions/hsv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hsv.js","sourceRoot":"","sources":["../../src/conversions/hsv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGrD,MAAM,MAAM,GACV,0FAA0F,CAAC;AAE7F;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAe;IACvC,IAAI,CAAS,CAAC;IACd,IAAI,CAAS,CAAC;IACd,IAAI,CAAS,CAAC;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAC;QAC5D,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,GAAG,GAAG,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC;IACtB,MAAM,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;IAClC,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,CAAC;IAEnC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAChF,OAAO;QACL,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC;QAC3C,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC;QAC3C,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC;QAC3C,CAAC,EAAE,CAAC;KACL,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAU;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG,CAAC;IACxB,MAAM,KAAK,GAAG,GAAG,CAAC;IAClB,MAAM,UAAU,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC;IAE/C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;YAClB,GAAG,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC;aAAM,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;YACzB,GAAG,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;QACpC,CAAC;QACD,GAAG,IAAI,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,IAAiB,CAAC;AAC/G,CAAC"}

package/dist/conversions/index.d.ts

@@ -0,0 +1,6 @@
+export { hexToRgba, rgbaToHex } from './hex';
+export { hslToRgba, rgbaToHsl } from './hsl';
+export { hsvToRgba, rgbaToHsv } from './hsv';
+export { pantoneToRgba, rgbaToPantone } from './pantone';
+export { rgbaToRgb, rgbToRgba } from './rgb';
+//# sourceMappingURL=index.d.ts.map

package/dist/conversions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC"}

package/dist/conversions/index.js

@@ -0,0 +1,6 @@
+export { hexToRgba, rgbaToHex } from './hex';
+export { hslToRgba, rgbaToHsl } from './hsl';
+export { hsvToRgba, rgbaToHsv } from './hsv';
+export { pantoneToRgba, rgbaToPantone } from './pantone';
+export { rgbaToRgb, rgbToRgba } from './rgb';
+//# sourceMappingURL=index.js.map

package/dist/conversions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/conversions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC"}

package/dist/conversions/pantone.d.ts

@@ -0,0 +1,17 @@
+import type { PantoneCode, Rgba } from '../types';
+/**
+ * Resolve a Pantone code to Rgba.
+ * Accepts any casing, spacing, and common prefixes ("PMS", "Pantone")
+ * since non-alphanumeric characters are stripped before lookup.
+ * Throws on unknown codes.
+ */
+export declare function pantoneToRgba(code: PantoneCode): Rgba;
+/**
+ * Find the nearest Pantone Coated code to the given Rgba. Uses ΔE*00
+ * (CIEDE2000) — the industry-standard perceptual metric — by default, since
+ * Pantone values cluster densely in the saturated blue/purple region where
+ * sRGB Euclidean distance gives visually wrong answers.
+ * Alpha is ignored. Always returns a code.
+ */
+export declare function rgbaToPantone(rgba: Rgba): PantoneCode;
+//# sourceMappingURL=pantone.d.ts.map

package/dist/conversions/pantone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pantone.d.ts","sourceRoot":"","sources":["../../src/conversions/pantone.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAY,WAAW,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAG5D;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAKrD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,CAErD"}

package/dist/conversions/pantone.js

@@ -0,0 +1,27 @@
+import { pantone } from '../colorspaces/pantone';
+import { getNameIndex, nearest, pantoneNormalize } from '../indexing';
+import { hexToRgba } from './hex';
+/**
+ * Resolve a Pantone code to Rgba.
+ * Accepts any casing, spacing, and common prefixes ("PMS", "Pantone")
+ * since non-alphanumeric characters are stripped before lookup.
+ * Throws on unknown codes.
+ */
+export function pantoneToRgba(code) {
+    const canonical = getNameIndex(pantone, pantoneNormalize).get(pantoneNormalize(code));
+    if (canonical === undefined)
+        throw new Error(`Unknown Pantone code: ${code}`);
+    const hex = pantone[canonical];
+    return hexToRgba(hex);
+}
+/**
+ * Find the nearest Pantone Coated code to the given Rgba. Uses ΔE*00
+ * (CIEDE2000) — the industry-standard perceptual metric — by default, since
+ * Pantone values cluster densely in the saturated blue/purple region where
+ * sRGB Euclidean distance gives visually wrong answers.
+ * Alpha is ignored. Always returns a code.
+ */
+export function rgbaToPantone(rgba) {
+    return nearest(rgba, pantone, 'deltaE2000');
+}
+//# sourceMappingURL=pantone.js.map

package/dist/conversions/pantone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pantone.js","sourceRoot":"","sources":["../../src/conversions/pantone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAiB;IAC7C,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IACtF,IAAI,SAAS,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IAC9E,MAAM,GAAG,GAAG,OAAO,CAAC,SAAiC,CAAC,CAAC;IACvD,OAAO,SAAS,CAAC,GAAe,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,OAAO,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,CAAgB,CAAC;AAC7D,CAAC"}

package/dist/conversions/rgb.d.ts

@@ -0,0 +1,15 @@
+import type { Rgba, RgbaInput, RgbInput, RgbString } from '../types';
+/**
+ * Normalize any RGB/RGBA input shape (string, tuple, or object) into
+ * the canonical Rgba representation. Alpha defaults to 1 when absent.
+ * Rejects non-finite numeric inputs; clamps r/g/b to [0,255] and a to [0,1].
+ * Throws on malformed strings.
+ */
+export declare function rgbToRgba(input: RgbInput | RgbaInput): Rgba;
+/**
+ * Emit an `rgb(r, g, b)` string. Alpha is dropped; values are
+ * already-clamped by rgbToRgba, but we re-clamp defensively for direct
+ * Rgba-object callers who bypass the input normalizer.
+ */
+export declare function rgbaToRgb(rgba: Rgba): RgbString;
+//# sourceMappingURL=rgb.d.ts.map

package/dist/conversions/rgb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgb.d.ts","sourceRoot":"","sources":["../../src/conversions/rgb.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAa,SAAS,EAAE,MAAM,UAAU,CAAC;AAahF;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CA+B3D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,CAK/C"}

package/dist/conversions/rgb.js

@@ -0,0 +1,57 @@
+import { clamp, requireFinite } from '../math/clamp';
+const RGB_RE = /^rgba?\s*\(\s*(-?\d+(?:\.\d+)?)\s*,\s*(-?\d+(?:\.\d+)?)\s*,\s*(-?\d+(?:\.\d+)?)\s*(?:,\s*(\d*\.?\d+)\s*)?\)$/i;
+function sanitizeChannel(n, label) {
+    return clamp(requireFinite(n, label), 0, 255);
+}
+function sanitizeAlpha(n) {
+    return clamp(requireFinite(n, 'alpha'), 0, 1);
+}
+/**
+ * Normalize any RGB/RGBA input shape (string, tuple, or object) into
+ * the canonical Rgba representation. Alpha defaults to 1 when absent.
+ * Rejects non-finite numeric inputs; clamps r/g/b to [0,255] and a to [0,1].
+ * Throws on malformed strings.
+ */
+export function rgbToRgba(input) {
+    if (Array.isArray(input)) {
+        const rawA = input.length === 4 ? input[3] : 1;
+        return {
+            r: sanitizeChannel(input[0], 'r'),
+            g: sanitizeChannel(input[1], 'g'),
+            b: sanitizeChannel(input[2], 'b'),
+            a: sanitizeAlpha(rawA),
+        };
+    }
+    if (typeof input === 'string') {
+        const match = RGB_RE.exec(input);
+        if (!match)
+            throw new Error(`Invalid rgb(a) string: ${input}`);
+        return {
+            r: sanitizeChannel(Number(match[1]), 'r'),
+            g: sanitizeChannel(Number(match[2]), 'g'),
+            b: sanitizeChannel(Number(match[3]), 'b'),
+            a: sanitizeAlpha(match[4] !== undefined ? Number(match[4]) : 1),
+        };
+    }
+    // Object form — TypeScript's Array.isArray narrowing doesn't exclude
+    // readonly tuple types from the union, so cast after the guards.
+    const obj = input;
+    return {
+        r: sanitizeChannel(obj.r, 'r'),
+        g: sanitizeChannel(obj.g, 'g'),
+        b: sanitizeChannel(obj.b, 'b'),
+        a: sanitizeAlpha('a' in obj ? obj.a : 1),
+    };
+}
+/**
+ * Emit an `rgb(r, g, b)` string. Alpha is dropped; values are
+ * already-clamped by rgbToRgba, but we re-clamp defensively for direct
+ * Rgba-object callers who bypass the input normalizer.
+ */
+export function rgbaToRgb(rgba) {
+    const r = clamp(Math.round(rgba.r), 0, 255);
+    const g = clamp(Math.round(rgba.g), 0, 255);
+    const b = clamp(Math.round(rgba.b), 0, 255);
+    return `rgb(${r}, ${g}, ${b})`;
+}
+//# sourceMappingURL=rgb.js.map

package/dist/conversions/rgb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgb.js","sourceRoot":"","sources":["../../src/conversions/rgb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGrD,MAAM,MAAM,GACV,+GAA+G,CAAC;AAElH,SAAS,eAAe,CAAC,CAAU,EAAE,KAAa;IAChD,OAAO,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,aAAa,CAAC,CAAU;IAC/B,OAAO,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAA2B;IACnD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,OAAO;YACL,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;YACjC,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;YACjC,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;YACjC,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;QAC/D,OAAO;YACL,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;YACzC,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;YACzC,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;YACzC,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAChE,CAAC;IACJ,CAAC;IAED,qEAAqE;IACrE,iEAAiE;IACjE,MAAM,GAAG,GAAG,KAAyB,CAAC;IACtC,OAAO;QACL,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC;QAC9B,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC;QAC9B,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC;QAC9B,CAAC,EAAE,aAAa,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACzC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAU;IAClC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAgB,CAAC;AAC9C,CAAC"}

package/dist/convert.d.ts

@@ -0,0 +1,21 @@
+import { type DetectedFormat } from './detectFormat';
+import type { ColorFormat, ColorInput, ColorValue, Rgba } from './types';
+/**
+ * Normalize any recognized color input to canonical `Rgba`.
+ * Pass `knownFormat` when the caller has already run `detectFormat` to skip
+ * the redundant detection. Throws on `UNKNOWN` input.
+ */
+export declare function toRgba(input: ColorInput, knownFormat?: DetectedFormat): Rgba;
+/**
+ * Emit a canonical `Rgba` in the target format. Colorspace-independent.
+ */
+export declare function fromRgba(rgba: Rgba, format?: ColorFormat): ColorValue;
+/**
+ * Detect the input color format, normalize to Rgba, and emit the result
+ * in the requested output format. Colorspace-independent.
+ * Throws if the input isn't a recognized color shape.
+ */
+export declare function convert(input: ColorInput, opts?: {
+    format?: ColorFormat;
+}): ColorValue;
+//# sourceMappingURL=convert.d.ts.map

package/dist/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,cAAc,EAAgB,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,UAAU,EAKV,IAAI,EAGL,MAAM,SAAS,CAAC;AAYjB;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,cAAc,GAAG,IAAI,CAkB5E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,WAAmB,GAAG,UAAU,CAe5E;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAAG,UAAU,CAE1F"}

package/dist/convert.js

@@ -0,0 +1,69 @@
+import { hexToRgba, rgbaToHex } from './conversions/hex';
+import { hslToRgba, rgbaToHsl } from './conversions/hsl';
+import { hsvToRgba, rgbaToHsv } from './conversions/hsv';
+import { pantoneToRgba, rgbaToPantone } from './conversions/pantone';
+import { rgbaToRgb, rgbToRgba } from './conversions/rgb';
+import { detectFormat } from './detectFormat';
+function safeStringify(x) {
+    if (x === undefined)
+        return 'undefined';
+    try {
+        const s = JSON.stringify(x);
+        return s === undefined ? String(x) : s;
+    }
+    catch {
+        return Object.prototype.toString.call(x);
+    }
+}
+/**
+ * Normalize any recognized color input to canonical `Rgba`.
+ * Pass `knownFormat` when the caller has already run `detectFormat` to skip
+ * the redundant detection. Throws on `UNKNOWN` input.
+ */
+export function toRgba(input, knownFormat) {
+    const format = knownFormat ?? detectFormat(input);
+    switch (format) {
+        case 'HEX':
+            return hexToRgba(input);
+        case 'RGB':
+            return rgbToRgba(input);
+        case 'RGBA':
+            return rgbToRgba(input);
+        case 'HSL':
+            return hslToRgba(input);
+        case 'HSV':
+            return hsvToRgba(input);
+        case 'PANTONE':
+            return pantoneToRgba(input);
+        default:
+            throw new Error(`Unrecognized color input: ${safeStringify(input)}`);
+    }
+}
+/**
+ * Emit a canonical `Rgba` in the target format. Colorspace-independent.
+ */
+export function fromRgba(rgba, format = 'HEX') {
+    switch (format) {
+        case 'HEX':
+            return rgbaToHex(rgba);
+        case 'RGB':
+            return rgbaToRgb(rgba);
+        case 'RGBA':
+            return rgba;
+        case 'HSL':
+            return rgbaToHsl(rgba);
+        case 'HSV':
+            return rgbaToHsv(rgba);
+        case 'PANTONE':
+            return rgbaToPantone(rgba);
+    }
+}
+/**
+ * Detect the input color format, normalize to Rgba, and emit the result
+ * in the requested output format. Colorspace-independent.
+ * Throws if the input isn't a recognized color shape.
+ */
+export function convert(input, opts = {}) {
+    return fromRgba(toRgba(input), opts.format ?? 'HEX');
+}
+//# sourceMappingURL=convert.js.map

package/dist/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAuB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAcnE,SAAS,aAAa,CAAC,CAAU;IAC/B,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,KAAiB,EAAE,WAA4B;IACpE,MAAM,MAAM,GAAG,WAAW,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;IAClD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK;YACR,OAAO,SAAS,CAAC,KAAiB,CAAC,CAAC;QACtC,KAAK,KAAK;YACR,OAAO,SAAS,CAAC,KAAiB,CAAC,CAAC;QACtC,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,KAAkB,CAAC,CAAC;QACvC,KAAK,KAAK;YACR,OAAO,SAAS,CAAC,KAAiB,CAAC,CAAC;QACtC,KAAK,KAAK;YACR,OAAO,SAAS,CAAC,KAAiB,CAAC,CAAC;QACtC,KAAK,SAAS;YACZ,OAAO,aAAa,CAAC,KAAoB,CAAC,CAAC;QAC7C;YACE,MAAM,IAAI,KAAK,CAAC,6BAA6B,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAU,EAAE,MAAM,GAAgB,KAAK;IAC9D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK;YACR,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,KAAK;YACR,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;QACd,KAAK,KAAK;YACR,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,KAAK;YACR,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,SAAS;YACZ,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,KAAiB,EAAE,IAAI,GAA6B,EAAE;IAC5E,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;AACvD,CAAC"}

package/dist/detectFormat.d.ts

@@ -0,0 +1,17 @@
+import type { ColorFormat, ColorInput } from './types';
+/**
+ * A color comes in, a format key comes out.
+ * 'UNKNOWN' signals the caller that the input isn't a recognized color shape.
+ * Used as the dispatch key for format-specific converters.
+ */
+export type DetectedFormat = ColorFormat | 'UNKNOWN';
+/** Shared with `src/conversions/hex.ts`. Capture group is used there; .test() ignores it here. */
+export declare const HEX_RE: RegExp;
+/**
+ * Runtime type-guard — returns `true` if `input` looks like something any of
+ * chromonym's converters can parse. Cheaper than catching a `convert` throw
+ * and more ergonomic than hand-rolling `detectFormat(x) !== 'UNKNOWN'`.
+ */
+export declare function isColor(input: unknown): input is ColorInput;
+export declare function detectFormat(input: ColorInput): DetectedFormat;
+//# sourceMappingURL=detectFormat.d.ts.map

package/dist/detectFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectFormat.d.ts","sourceRoot":"","sources":["../src/detectFormat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,SAAS,CAAC;AAErD,kGAAkG;AAClG,eAAO,MAAM,MAAM,QAA8C,CAAC;AASlE;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAE3D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CA8B9D"}

package/dist/detectFormat.js

@@ -0,0 +1,59 @@
+/** Shared with `src/conversions/hex.ts`. Capture group is used there; .test() ignores it here. */
+export const HEX_RE = /^#([0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i;
+const RGBA_STR_RE = /^rgba\s*\(/i;
+const RGB_STR_RE = /^rgb\s*\(/i;
+const HSL_STR_RE = /^hsl\s*\(/i;
+const HSV_STR_RE = /^hsv\s*\(/i;
+// Conservative: matches "<digits> C|U|M" with optional "Pantone" prefix.
+// Refine once the real Pantone code list lands.
+const PANTONE_RE = /^(?:pantone\s+)?\d+\s*[CUM]$/i;
+/**
+ * Runtime type-guard — returns `true` if `input` looks like something any of
+ * chromonym's converters can parse. Cheaper than catching a `convert` throw
+ * and more ergonomic than hand-rolling `detectFormat(x) !== 'UNKNOWN'`.
+ */
+export function isColor(input) {
+    return detectFormat(input) !== 'UNKNOWN';
+}
+export function detectFormat(input) {
+    if (typeof input === 'string') {
+        if (input === '')
+            return 'UNKNOWN';
+        if (HEX_RE.test(input))
+            return 'HEX';
+        if (RGBA_STR_RE.test(input))
+            return 'RGBA';
+        if (RGB_STR_RE.test(input))
+            return 'RGB';
+        if (HSL_STR_RE.test(input))
+            return 'HSL';
+        if (HSV_STR_RE.test(input))
+            return 'HSV';
+        if (PANTONE_RE.test(input))
+            return 'PANTONE';
+        return 'UNKNOWN';
+    }
+    if (Array.isArray(input)) {
+        if (input.length === 4)
+            return 'RGBA';
+        if (input.length === 3)
+            return 'RGB';
+        return 'UNKNOWN';
+    }
+    if (input !== null && typeof input === 'object') {
+        // Use Object.hasOwn — `in` walks the prototype chain and can be
+        // abused by attacker-controlled prototypes to misclassify inputs.
+        const has = Object.hasOwn;
+        if (has(input, 'h') && has(input, 'v'))
+            return 'HSV';
+        if (has(input, 'h') && has(input, 'l'))
+            return 'HSL';
+        if (has(input, 'r') && has(input, 'a'))
+            return 'RGBA';
+        if (has(input, 'r'))
+            return 'RGB';
+        return 'UNKNOWN';
+    }
+    return 'UNKNOWN';
+}
+//# sourceMappingURL=detectFormat.js.map

package/dist/detectFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectFormat.js","sourceRoot":"","sources":["../src/detectFormat.ts"],"names":[],"mappings":"AASA,kGAAkG;AAClG,MAAM,CAAC,MAAM,MAAM,GAAG,2CAA2C,CAAC;AAClE,MAAM,WAAW,GAAG,aAAa,CAAC;AAClC,MAAM,UAAU,GAAG,YAAY,CAAC;AAChC,MAAM,UAAU,GAAG,YAAY,CAAC;AAChC,MAAM,UAAU,GAAG,YAAY,CAAC;AAChC,yEAAyE;AACzE,gDAAgD;AAChD,MAAM,UAAU,GAAG,+BAA+B,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,YAAY,CAAC,KAAmB,CAAC,KAAK,SAAS,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,KAAK,EAAE;YAAE,OAAO,SAAS,CAAC;QACnC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACrC,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QAC3C,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACzC,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACzC,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACzC,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC7C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QACtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACrC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,gEAAgE;QAChE,kEAAkE;QAClE,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;QAC1B,IAAI,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACrD,IAAI,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACrD,IAAI,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC;QACtD,IAAI,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/identify.d.ts

@@ -0,0 +1,20 @@
+import { toRgba } from './convert';
+import type { ColorspaceName, DistanceMetric } from './types';
+/**
+ * Identify the nearest-named color for any color input.
+ *
+ * The distance metric defaults to the colorspace's recommended choice
+ * (web/x11: `deltaE76`, pantone: `deltaE2000`). Override with the `metric`
+ * option — e.g. `{ metric: 'euclidean-srgb' }` for maximum speed, or
+ * `{ metric: 'deltaE2000' }` for strictest perceptual accuracy.
+ *
+ * Returns `null` if the input isn't a recognized color shape or the
+ * colorspace name isn't one of `web` / `x11` / `pantone`.
+ *
+ * Defaults: colorspace = 'web', metric = DEFAULT_METRICS[colorspace].
+ */
+export declare function identify(input: Parameters<typeof toRgba>[0], opts?: {
+    colorspace?: ColorspaceName;
+    metric?: DistanceMetric;
+}): string | null;
+//# sourceMappingURL=identify.d.ts.map

package/dist/identify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identify.d.ts","sourceRoot":"","sources":["../src/identify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,EACnC,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CAAO,GAClE,MAAM,GAAG,IAAI,CAUf"}