chromonym 1.1.0 → 1.3.0

package/dist/conversions/pantone.js

@@ -1,34 +1,6 @@
 import { pantone } from '../colorspaces/pantone';
-import { euclideanDistance } from '../math/euclideanDistance';
+import { getNameIndex, nearest, pantoneNormalize } from '../indexing';
 import { hexToRgba } from './hex';
-// Strip casing, common prefixes ("Pantone", "PMS"), and all non-alphanumeric
-// characters so that "185 C", "185c", "Pantone 185 C", "PMS185C" all match
-// the stored canonical key "185C".
-function normalize(s) {
-    return s
-        .toLowerCase()
-        .replace(/^(pantone|pms)\s*/, '')
-        .replace(/[^a-z0-9]/g, '');
-}
-// Lazy normalized-name -> canonical-key index.
-let nameIndex = null;
-function getNameIndex() {
-    if (!nameIndex) {
-        nameIndex = new Map();
-        for (const key of Object.keys(pantone)) {
-            nameIndex.set(normalize(key), key);
-        }
-    }
-    return nameIndex;
-}
-// Lazy canonical-key -> rgba index (precomputed to avoid per-lookup hex parsing).
-let rgbaIndex = null;
-function getRgbaIndex() {
-    if (!rgbaIndex) {
-        rgbaIndex = Object.entries(pantone).map(([code, hex]) => [code, hexToRgba(hex)]);
-    }
-    return rgbaIndex;
-}
 /**
  * Resolve a Pantone code to Rgba.
  * Accepts any casing, spacing, and common prefixes ("PMS", "Pantone")
@@ -36,28 +8,20 @@ function getRgbaIndex() {
  * Throws on unknown codes.
  */
 export function pantoneToRgba(code) {
-    const canonical = getNameIndex().get(normalize(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 code (Coated) to the given Rgba by
- * Euclidean distance in RGB. Alpha is ignored. Always returns a code.
+ * 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) {
-    const entries = getRgbaIndex();
-    // Pantone colorspace has 907 entries; first-entry fallback is defensive.
-    let bestCode = entries[0]?.[0] ?? '';
-    let bestDistance = Infinity;
-    for (const [code, candidate] of entries) {
-        const d = euclideanDistance(rgba, candidate);
-        if (d < bestDistance) {
-            bestDistance = d;
-            bestCode = code;
-        }
-    }
-    return bestCode;
+    return nearest(rgba, pantone, 'deltaE2000');
 }
 //# sourceMappingURL=pantone.js.map

package/dist/conversions/pantone.js.map

@@ -1 +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,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,6EAA6E;AAC7E,2EAA2E;AAC3E,mCAAmC;AACnC,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC;SACL,WAAW,EAAE;SACb,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;SAChC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,+CAA+C;AAC/C,IAAI,SAAS,GAA+B,IAAI,CAAC;AACjD,SAAS,YAAY;IACnB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACvC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,kFAAkF;AAClF,IAAI,SAAS,GAAsD,IAAI,CAAC;AACxE,SAAS,YAAY;IACnB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CACrC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,GAAe,CAAC,CAAU,CAC7D,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAiB;IAC7C,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,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,GAAG,CAAC,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAC/B,yEAAyE;IACzE,IAAI,QAAQ,GAAW,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,YAAY,GAAG,QAAQ,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,OAAO,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,YAAY,EAAE,CAAC;YACrB,YAAY,GAAG,CAAC,CAAC;YACjB,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,QAAuB,CAAC;AACjC,CAAC"}
+{"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

@@ -2,12 +2,14 @@ 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; out-of-range values
- * are clamped to 0..255; fractional values are rounded.
+ * 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

@@ -1 +1 @@
-{"version":3,"file":"rgb.d.ts","sourceRoot":"","sources":["../../src/conversions/rgb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAa,SAAS,EAAE,MAAM,UAAU,CAAC;AAKhF;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CA+B3D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,CAG/C"}
+{"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

@@ -1,17 +1,25 @@
+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 a = input.length === 4 ? input[3] : 1;
+        const rawA = input.length === 4 ? input[3] : 1;
         return {
-            r: input[0],
-            g: input[1],
-            b: input[2],
-            a,
+            r: sanitizeChannel(input[0], 'r'),
+            g: sanitizeChannel(input[1], 'g'),
+            b: sanitizeChannel(input[2], 'b'),
+            a: sanitizeAlpha(rawA),
         };
     }
     if (typeof input === 'string') {
@@ -19,28 +27,31 @@ export function rgbToRgba(input) {
         if (!match)
             throw new Error(`Invalid rgb(a) string: ${input}`);
         return {
-            r: Number(match[1]),
-            g: Number(match[2]),
-            b: Number(match[3]),
-            a: match[4] !== undefined ? Number(match[4]) : 1,
+            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: obj.r,
-        g: obj.g,
-        b: obj.b,
-        a: 'a' in obj ? obj.a : 1,
+        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; out-of-range values
- * are clamped to 0..255; fractional values are rounded.
+ * 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 clamp = (n) => Math.max(0, Math.min(255, Math.round(n)));
-    return `rgb(${clamp(rgba.r)}, ${clamp(rgba.g)}, ${clamp(rgba.b)})`;
+    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

@@ -1 +1 @@
-{"version":3,"file":"rgb.js","sourceRoot":"","sources":["../../src/conversions/rgb.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GACV,+GAA+G,CAAC;AAElH;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAA2B;IACnD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,CAAC,CAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,OAAO;YACL,CAAC,EAAE,KAAK,CAAC,CAAC,CAAW;YACrB,CAAC,EAAE,KAAK,CAAC,CAAC,CAAW;YACrB,CAAC,EAAE,KAAK,CAAC,CAAC,CAAW;YACrB,CAAC;SACF,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,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACjD,CAAC;IACJ,CAAC;IAED,qEAAqE;IACrE,iEAAiE;IACjE,MAAM,GAAG,GAAG,KAAyB,CAAC;IACtC,OAAO;QACL,CAAC,EAAE,GAAG,CAAC,CAAC;QACR,CAAC,EAAE,GAAG,CAAC,CAAC;QACR,CAAC,EAAE,GAAG,CAAC,CAAC;QACR,CAAC,EAAE,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAU;IAClC,MAAM,KAAK,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,OAAO,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAgB,CAAC;AAClF,CAAC"}
+{"version":3,"file":"rgb.js","sourceRoot":"","sources":["../../src/conversions/rgb.ts"],"names":[],"mappings":"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"}

package/dist/convert.d.ts

@@ -1,4 +1,15 @@
-import type { ColorFormat, ColorInput, ColorValue } from './types';
+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.

package/dist/convert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,UAAU,EAQX,MAAM,SAAS,CAAC;AAuCjB;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAAG,UAAU,CAG1F"}
+{"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

@@ -4,8 +4,24 @@ import { hsvToRgba, rgbaToHsv } from './conversions/hsv';
 import { pantoneToRgba, rgbaToPantone } from './conversions/pantone';
 import { rgbaToRgb, rgbToRgba } from './conversions/rgb';
 import { detectFormat } from './detectFormat';
-function toRgba(input) {
-    const format = detectFormat(input);
+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);
@@ -20,10 +36,13 @@ function toRgba(input) {
         case 'PANTONE':
             return pantoneToRgba(input);
         default:
-            throw new Error(`Unrecognized color input: ${String(input)}`);
+            throw new Error(`Unrecognized color input: ${safeStringify(input)}`);
     }
 }
-function fromRgba(rgba, format) {
+/**
+ * Emit a canonical `Rgba` in the target format. Colorspace-independent.
+ */
+export function fromRgba(rgba, format = 'HEX') {
     switch (format) {
         case 'HEX':
             return rgbaToHex(rgba);
@@ -45,7 +64,6 @@ function fromRgba(rgba, format) {
  * Throws if the input isn't a recognized color shape.
  */
 export function convert(input, opts = {}) {
-    const { format = 'HEX' } = opts;
-    return fromRgba(toRgba(input), format);
+    return fromRgba(toRgba(input), opts.format ?? 'HEX');
 }
 //# sourceMappingURL=convert.js.map

package/dist/convert.js.map

@@ -1 +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,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAc9C,SAAS,MAAM,CAAC,KAAiB;IAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,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,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,IAAU,EAAE,MAAmB;IAC/C,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,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;IAChC,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC"}
+{"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

@@ -5,5 +5,13 @@ import type { ColorFormat, ColorInput } from './types';
  * 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

@@ -1 +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;AAWrD,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CA2B9D"}
+{"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

@@ -1,4 +1,5 @@
-const HEX_RE = /^#(?:[0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i;
+/** 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;
@@ -6,6 +7,14 @@ 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 === '')
@@ -32,13 +41,16 @@ export function detectFormat(input) {
         return 'UNKNOWN';
     }
     if (input !== null && typeof input === 'object') {
-        if ('h' in input && 'v' in input)
+        // 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 ('h' in input && 'l' in input)
+        if (has(input, 'h') && has(input, 'l'))
             return 'HSL';
-        if ('a' in input)
+        if (has(input, 'r') && has(input, 'a'))
             return 'RGBA';
-        if ('r' in input)
+        if (has(input, 'r'))
             return 'RGB';
         return 'UNKNOWN';
     }

package/dist/detectFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"detectFormat.js","sourceRoot":"","sources":["../src/detectFormat.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,GAAG,6CAA6C,CAAC;AAC7D,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,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,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QAC/C,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QAC/C,IAAI,GAAG,IAAI,KAAK;YAAE,OAAO,MAAM,CAAC;QAChC,IAAI,GAAG,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"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

@@ -1,12 +1,20 @@
-import type { ColorInput, ColorspaceName } from './types';
+import { toRgba } from './convert';
+import type { ColorspaceName, DistanceMetric } from './types';
 /**
  * Identify the nearest-named color for any color input.
- * Uses Euclidean distance in RGB (alpha is ignored).
- * Returns `null` if the input isn't a recognized color shape.
  *
- * Defaults: colorspace = 'web'.
+ * 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: ColorInput, opts?: {
+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

@@ -1 +1 @@
-{"version":3,"file":"identify.d.ts","sourceRoot":"","sources":["../src/identify.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAc,cAAc,EAAkB,MAAM,SAAS,CAAC;AAiBtF;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,EACjB,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,cAAc,CAAA;CAAO,GACzC,MAAM,GAAG,IAAI,CAiBf"}
+{"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"}

package/dist/identify.js

@@ -1,44 +1,29 @@
-import { pantone } from './colorspaces/pantone';
-import { web } from './colorspaces/web';
-import { x11 } from './colorspaces/x11';
-import { hexToRgba } from './conversions/hex';
-import { convert } from './convert';
+import { COLORSPACE_NAMES, COLORSPACES, DEFAULT_METRICS } from './colorspaces/registry';
+import { toRgba } from './convert';
 import { detectFormat } from './detectFormat';
-import { euclideanDistance } from './math/euclideanDistance';
-const COLORSPACES = { web, x11, pantone };
-// Lazy per-colorspace rgba index — built on first lookup, reused thereafter.
-const rgbaIndexes = new Map();
-function getRgbaIndex(colorspace) {
-    let idx = rgbaIndexes.get(colorspace);
-    if (idx === undefined) {
-        const space = COLORSPACES[colorspace];
-        idx = Object.entries(space).map(([name, hex]) => [name, hexToRgba(hex)]);
-        rgbaIndexes.set(colorspace, idx);
-    }
-    return idx;
-}
+import { nearest } from './indexing';
 /**
  * Identify the nearest-named color for any color input.
- * Uses Euclidean distance in RGB (alpha is ignored).
- * Returns `null` if the input isn't a recognized color shape.
  *
- * Defaults: colorspace = 'web'.
+ * 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 function identify(input, opts = {}) {
-    if (detectFormat(input) === 'UNKNOWN')
+    const format = detectFormat(input);
+    if (format === 'UNKNOWN')
+        return null;
+    const { colorspace = 'web', metric } = opts;
+    if (!COLORSPACE_NAMES.has(colorspace))
         return null;
-    const { colorspace = 'web' } = opts;
-    const rgba = convert(input, { format: 'RGBA' });
-    const entries = getRgbaIndex(colorspace);
-    let bestName = null;
-    let bestDistance = Infinity;
-    for (const [name, candidate] of entries) {
-        const d = euclideanDistance(rgba, candidate);
-        if (d < bestDistance) {
-            bestDistance = d;
-            bestName = name;
-        }
-    }
-    return bestName;
+    const rgba = toRgba(input, format);
+    const name = nearest(rgba, COLORSPACES[colorspace], metric ?? DEFAULT_METRICS[colorspace]);
+    return name || null;
 }
 //# sourceMappingURL=identify.js.map

package/dist/identify.js.map

@@ -1 +1 @@
-{"version":3,"file":"identify.js","sourceRoot":"","sources":["../src/identify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,MAAM,WAAW,GAAuC,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAE9E,6EAA6E;AAC7E,MAAM,WAAW,GAAG,IAAI,GAAG,EAA8D,CAAC;AAE1F,SAAS,YAAY,CAAC,UAA0B;IAC9C,IAAI,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;QACtC,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,GAAe,CAAC,CAAU,CAAC,CAAC;QAC9F,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAiB,EACjB,IAAI,GAAoC,EAAE;IAE1C,IAAI,YAAY,CAAC,KAAK,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAEnD,MAAM,EAAE,UAAU,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAS,CAAC;IACxD,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAEzC,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,YAAY,GAAG,QAAQ,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,OAAO,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,YAAY,EAAE,CAAC;YACrB,YAAY,GAAG,CAAC,CAAC;YACjB,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"identify.js","sourceRoot":"","sources":["../src/identify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGrC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAmC,EACnC,IAAI,GAA6D,EAAE;IAEnE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAEtC,MAAM,EAAE,UAAU,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,IAAI,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3F,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC"}

package/dist/index.d.ts

@@ -6,8 +6,8 @@ export { hslToRgba, rgbaToHsl } from './conversions/hsl';
 export { hsvToRgba, rgbaToHsv } from './conversions/hsv';
 export { pantoneToRgba, rgbaToPantone } from './conversions/pantone';
 export { rgbaToRgb, rgbToRgba } from './conversions/rgb';
-export { convert } from './convert';
-export { type DetectedFormat, detectFormat } from './detectFormat';
+export { convert, fromRgba, toRgba } from './convert';
+export { type DetectedFormat, detectFormat, isColor } from './detectFormat';
 export { identify } from './identify';
 export { resolve } from './resolve';
 export type { ColorFormat, ColorInput, Colorspace, ColorspaceName, ColorValue, HexColor, HslInput, HslObject, HslString, HsvInput, HsvObject, HsvString, PantoneCode, Rgba, RgbaInput, RgbaString, RgbaTuple, RgbInput, RgbObject, RgbString, RgbTuple, } from './types';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,gBAAgB,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,KAAK,YAAY,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,KAAK,YAAY,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC3D,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,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EACT,QAAQ,EACR,SAAS,EACT,SAAS,EACT,WAAW,EACX,IAAI,EACJ,SAAS,EACT,UAAU,EACV,SAAS,EACT,QAAQ,EACR,SAAS,EACT,SAAS,EACT,QAAQ,GACT,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,gBAAgB,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,KAAK,YAAY,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,KAAK,YAAY,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC3D,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,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,KAAK,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EACT,QAAQ,EACR,SAAS,EACT,SAAS,EACT,WAAW,EACX,IAAI,EACJ,SAAS,EACT,UAAU,EACV,SAAS,EACT,QAAQ,EACR,SAAS,EACT,SAAS,EACT,QAAQ,GACT,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -8,8 +8,8 @@ export { hslToRgba, rgbaToHsl } from './conversions/hsl';
 export { hsvToRgba, rgbaToHsv } from './conversions/hsv';
 export { pantoneToRgba, rgbaToPantone } from './conversions/pantone';
 export { rgbaToRgb, rgbToRgba } from './conversions/rgb';
-export { convert } from './convert';
-export { detectFormat } from './detectFormat';
+export { convert, fromRgba, toRgba } from './convert';
+export { detectFormat, isColor } from './detectFormat';
 export { identify } from './identify';
 export { resolve } from './resolve';
 export { COLOR_FORMATS } from './types';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,sDAAsD;AAEtD,OAAO,EAAyB,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAqB,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAqB,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC3D,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,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAuB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,sDAAsD;AAEtD,OAAO,EAAyB,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAqB,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAqB,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC3D,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,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAuB,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/indexing.d.ts

@@ -0,0 +1,44 @@
+import type { Colorspace, DistanceMetric, Rgba } from './types';
+/**
+ * Name normalization and per-colorspace lookup indexes.
+ *
+ * Tree-shaking note: this module never imports colorspace data itself.
+ * Callers pass their own colorspace in, so importing (say) `pantoneToRgba`
+ * never drags in `web` or `x11` through here.
+ *
+ * Caches are keyed by the colorspace object reference (WeakMap), so each
+ * colorspace's index is built once per process and reused by every caller.
+ */
+export type NormalizeFn = (name: string) => string;
+/** Lowercase + strip non-alphanumeric. Used for web and x11. */
+export declare const standardNormalize: NormalizeFn;
+/**
+ * Pantone: also strip a leading "Pantone" or "PMS" prefix so that
+ * "185 C", "185c", "Pantone 185 C", "PMS185C" all map to "185c".
+ */
+export declare const pantoneNormalize: NormalizeFn;
+/**
+ * Normalized-name → canonical-key map for a given colorspace.
+ * Each (colorspace, normalize) pair must be stable — callers are
+ * expected to always pair a given colorspace with the same normalizer.
+ */
+export declare function getNameIndex(space: Colorspace, normalize: NormalizeFn): Map<string, string>;
+/**
+ * Canonical-key → Rgba entries for a given colorspace, built by parsing
+ * each hex value once. Used by nearest-match lookups (identify, rgbaToPantone).
+ */
+export declare function getRgbaIndex(space: Colorspace): Array<readonly [string, Rgba]>;
+/**
+ * Find the nearest-named entry in a colorspace to the given Rgba, using
+ * squared Euclidean distance in sRGB (alpha ignored). Used by `identify`
+ * and `rgbaToPantone` when metric === 'euclidean-srgb'.
+ */
+export declare function nearestByRgb(target: Rgba, space: Colorspace): string;
+/**
+ * Find the nearest-named entry in a colorspace under the specified distance
+ * metric. Dispatches to the right index (rgba / linear-rgb / Lab) and
+ * the right distance function. See `DistanceMetric` in types.ts for how
+ * to pick a metric.
+ */
+export declare function nearest(target: Rgba, space: Colorspace, metric?: DistanceMetric): string;
+//# sourceMappingURL=indexing.d.ts.map

package/dist/indexing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexing.d.ts","sourceRoot":"","sources":["../src/indexing.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAY,IAAI,EAAE,MAAM,SAAS,CAAC;AAE1E;;;;;;;;;GASG;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAEnD,gEAAgE;AAChE,eAAO,MAAM,iBAAiB,EAAE,WAA8D,CAAC;AAE/F;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAID,CAAC;AAK/B;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAU3F;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAO9E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAYpE;AAsED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,IAAI,EACZ,KAAK,EAAE,UAAU,EACjB,MAAM,GAAE,cAAiC,GACxC,MAAM,CAaR"}