chromonym 1.4.1 → 3.0.0

package/dist/identify.d.ts

@@ -1,28 +1,50 @@
-import type { PantoneColorName } from './colorspaces/pantone';
-import type { WebColorName } from './colorspaces/web';
-import type { X11ColorName } from './colorspaces/x11';
-import type { ColorInput, ColorspaceName, DistanceMetric } from './types';
-type ColorNameByColorspace = {
-    web: WebColorName;
-    x11: X11ColorName;
-    pantone: PantoneColorName;
+import { web } from './palettes/web.js';
+import type { ColorInput, DistanceMetric, HexColor, Palette } from './types.js';
+/** Extract string keys from a Palette's `colors` map. */
+type PaletteKey<P extends Palette> = Extract<keyof P['colors'], string>;
+/**
+ * One ranked nearest-match entry when `identify` is called with `k`.
+ * `value` is the palette's stored hex for the match (useful for rendering
+ * swatches). `distance` is in the selected metric's natural units — ΔE
+ * for `deltaE*` metrics, channel-unit Euclidean for the others.
+ */
+export type IdentifyMatch<Name extends string> = {
+    readonly name: Name;
+    readonly value: HexColor;
+    readonly distance: number;
 };
 /**
- * Identify the nearest-named color for any color input.
+ * Identify the nearest-named color for any color input (or palette name
+ * from another palette via `source`).
+ *
+ * **Simple case — color in, name out:**
+ *   identify('#ff0000')                           → 'red'
+ *   identify('#ff0000', { palette: pantone })     → '172 C'
  *
- * 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.
+ * **Cross-palette — name from one palette, nearest in another:**
+ *   identify('rebeccapurple', { palette: pantone, source: web })  → '267 C'
+ *   identify('Razzmatazz',    { palette: pantone, source: crayola }) → '213 C'
  *
- * Returns `null` if the input isn't a recognized color shape or the
- * colorspace name isn't one of `web` / `x11` / `pantone`.
+ * **Top-k ranked matches with ΔE distances:**
+ *   identify('#ff0000', { palette: pantone, k: 3 })
+ *   // [{ name: '172 C', value: '#fa4616', distance: 3.2 }, ...]
  *
- * Defaults: colorspace = 'web', metric = DEFAULT_METRICS[colorspace].
+ * The distance metric defaults to the target palette's `defaultMetric`
+ * (web/x11: `deltaE76`, pantone: `deltaE2000`, crayola: `deltaEok`).
+ * Override with `metric`.
+ *
+ * Returns `null` (or `[]` when `k` is set) if the input can't be parsed.
  */
-export declare function identify<C extends ColorspaceName = 'web'>(input: ColorInput, opts?: {
-    colorspace?: C;
+export declare function identify<P extends Palette = typeof web>(input: ColorInput | string, opts?: {
+    palette?: P;
+    source?: Palette;
+    metric?: DistanceMetric;
+}): PaletteKey<P> | null;
+export declare function identify<P extends Palette = typeof web>(input: ColorInput | string, opts: {
+    palette?: P;
+    source?: Palette;
     metric?: DistanceMetric;
-}): ColorNameByColorspace[C] | null;
+    k: number;
+}): Array<IdentifyMatch<PaletteKey<P>>>;
 export {};
 //# 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":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE1E,KAAK,qBAAqB,GAAG;IAC3B,GAAG,EAAE,YAAY,CAAC;IAClB,GAAG,EAAE,YAAY,CAAC;IAClB,OAAO,EAAE,gBAAgB,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,cAAc,GAAG,KAAK,EACvD,KAAK,EAAE,UAAU,EACjB,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CAAO,GACrD,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI,CAUjC"}
+{"version":3,"file":"identify.d.ts","sourceRoot":"","sources":["../src/identify.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,EAAQ,MAAM,YAAY,CAAC;AAEtF,yDAAyD;AACzD,KAAK,UAAU,CAAC,CAAC,SAAS,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;AAExE;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CAAC,IAAI,SAAS,MAAM,IAAI;IAC/C,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAmBF;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,GAAG,EACrD,KAAK,EAAE,UAAU,GAAG,MAAM,EAC1B,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,GAChE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;AAGxB,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,GAAG,EACrD,KAAK,EAAE,UAAU,GAAG,MAAM,EAC1B,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1E,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC","sourcesContent":["import { hexToRgba } from './conversions/hex.js';\nimport { toRgba } from './convert.js';\nimport { detectFormat } from './detectFormat.js';\nimport { getNameIndex, nearest, nearestAll } from './indexing.js';\nimport { web } from './palettes/web.js';\nimport type { ColorInput, DistanceMetric, HexColor, Palette, Rgba } from './types.js';\n\n/** Extract string keys from a Palette's `colors` map. */\ntype PaletteKey<P extends Palette> = Extract<keyof P['colors'], string>;\n\n/**\n * One ranked nearest-match entry when `identify` is called with `k`.\n * `value` is the palette's stored hex for the match (useful for rendering\n * swatches). `distance` is in the selected metric's natural units — ΔE\n * for `deltaE*` metrics, channel-unit Euclidean for the others.\n */\nexport type IdentifyMatch<Name extends string> = {\n  readonly name: Name;\n  readonly value: HexColor;\n  readonly distance: number;\n};\n\n/**\n * Parse a string input that may be a color literal or a palette name.\n * Returns the canonical Rgba, or `null` if nothing matches.\n */\nfunction parseInput(input: ColorInput | string, source?: Palette): Rgba | null {\n  const detected = detectFormat(input as ColorInput);\n  if (detected !== 'UNKNOWN') return toRgba(input as ColorInput, detected);\n  if (source !== undefined && typeof input === 'string') {\n    const canonical = getNameIndex(source).get(source.normalize(input));\n    if (canonical === undefined) return null;\n    const hex = (source.colors as Record<string, HexColor>)[canonical];\n    if (hex === undefined) return null;\n    return hexToRgba(hex);\n  }\n  return null;\n}\n\n/**\n * Identify the nearest-named color for any color input (or palette name\n * from another palette via `source`).\n *\n * **Simple case — color in, name out:**\n *   identify('#ff0000')                           → 'red'\n *   identify('#ff0000', { palette: pantone })     → '172 C'\n *\n * **Cross-palette — name from one palette, nearest in another:**\n *   identify('rebeccapurple', { palette: pantone, source: web })  → '267 C'\n *   identify('Razzmatazz',    { palette: pantone, source: crayola }) → '213 C'\n *\n * **Top-k ranked matches with ΔE distances:**\n *   identify('#ff0000', { palette: pantone, k: 3 })\n *   // [{ name: '172 C', value: '#fa4616', distance: 3.2 }, ...]\n *\n * The distance metric defaults to the target palette's `defaultMetric`\n * (web/x11: `deltaE76`, pantone: `deltaE2000`, crayola: `deltaEok`).\n * Override with `metric`.\n *\n * Returns `null` (or `[]` when `k` is set) if the input can't be parsed.\n */\n\n// Overload 1: no `k` — single name (or null). Unchanged legacy shape.\nexport function identify<P extends Palette = typeof web>(\n  input: ColorInput | string,\n  opts?: { palette?: P; source?: Palette; metric?: DistanceMetric },\n): PaletteKey<P> | null;\n\n// Overload 2: `k` present — ranked Match[] with distances.\nexport function identify<P extends Palette = typeof web>(\n  input: ColorInput | string,\n  opts: { palette?: P; source?: Palette; metric?: DistanceMetric; k: number },\n): Array<IdentifyMatch<PaletteKey<P>>>;\n\n// Implementation.\nexport function identify(\n  input: ColorInput | string,\n  opts: { palette?: Palette; source?: Palette; metric?: DistanceMetric; k?: number } = {},\n): string | null | Array<IdentifyMatch<string>> {\n  const palette = opts.palette ?? web;\n  const metric = opts.metric ?? palette.defaultMetric;\n  const rgba = parseInput(input, opts.source);\n\n  if (opts.k !== undefined) {\n    if (rgba === null) return [];\n    const raw = nearestAll(rgba, palette, metric, opts.k);\n    return raw.map((m) => {\n      const value = (palette.colors as Record<string, HexColor>)[m.name];\n      return { name: m.name, value: value as HexColor, distance: m.distance };\n    });\n  }\n\n  if (rgba === null) return null;\n  const name = nearest(rgba, palette, metric);\n  return name || null;\n}\n"]}

package/dist/identify.js

@@ -1,29 +1,44 @@
-import { COLORSPACE_NAMES, COLORSPACES, DEFAULT_METRICS } from './colorspaces/registry';
-import { toRgba } from './convert';
-import { detectFormat } from './detectFormat';
-import { nearest } from './indexing';
+import { hexToRgba } from './conversions/hex.js';
+import { toRgba } from './convert.js';
+import { detectFormat } from './detectFormat.js';
+import { getNameIndex, nearest, nearestAll } from './indexing.js';
+import { web } from './palettes/web.js';
 /**
- * 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].
+ * Parse a string input that may be a color literal or a palette name.
+ * Returns the canonical Rgba, or `null` if nothing matches.
  */
+function parseInput(input, source) {
+    const detected = detectFormat(input);
+    if (detected !== 'UNKNOWN')
+        return toRgba(input, detected);
+    if (source !== undefined && typeof input === 'string') {
+        const canonical = getNameIndex(source).get(source.normalize(input));
+        if (canonical === undefined)
+            return null;
+        const hex = source.colors[canonical];
+        if (hex === undefined)
+            return null;
+        return hexToRgba(hex);
+    }
+    return null;
+}
+// Implementation.
 export function identify(input, opts = {}) {
-    const format = detectFormat(input);
-    if (format === 'UNKNOWN')
-        return null;
-    const colorspace = (opts.colorspace ?? 'web');
-    if (!COLORSPACE_NAMES.has(colorspace))
+    const palette = opts.palette ?? web;
+    const metric = opts.metric ?? palette.defaultMetric;
+    const rgba = parseInput(input, opts.source);
+    if (opts.k !== undefined) {
+        if (rgba === null)
+            return [];
+        const raw = nearestAll(rgba, palette, metric, opts.k);
+        return raw.map((m) => {
+            const value = palette.colors[m.name];
+            return { name: m.name, value: value, distance: m.distance };
+        });
+    }
+    if (rgba === null)
         return null;
-    const rgba = toRgba(input, format);
-    const name = nearest(rgba, COLORSPACES[colorspace], opts.metric ?? DEFAULT_METRICS[colorspace]);
+    const name = nearest(rgba, palette, metric);
     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":"AACA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGxF,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AASrC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAiB,EACjB,IAAI,GAAgD,EAAE;IAEtD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAEtC,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,KAAK,CAAM,CAAC;IACnD,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,IAAI,CAAC,MAAM,IAAI,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;IAChG,OAAQ,IAAiC,IAAI,IAAI,CAAC;AACpD,CAAC"}
+{"version":3,"file":"identify.js","sourceRoot":"","sources":["../src/identify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAkBxC;;;GAGG;AACH,SAAS,UAAU,CAAC,KAA0B,EAAE,MAAgB;IAC9D,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAmB,CAAC,CAAC;IACnD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,KAAmB,EAAE,QAAQ,CAAC,CAAC;IACzE,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACtD,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACzC,MAAM,GAAG,GAAI,MAAM,CAAC,MAAmC,CAAC,SAAS,CAAC,CAAC;QACnE,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAqCD,kBAAkB;AAClB,MAAM,UAAU,QAAQ,CACtB,KAA0B,EAC1B,IAAI,GAAiF,EAAE;IAEvF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IACpD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAE5C,IAAI,IAAI,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACtD,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACnB,MAAM,KAAK,GAAI,OAAO,CAAC,MAAmC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACnE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAiB,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC","sourcesContent":["import { hexToRgba } from './conversions/hex.js';\nimport { toRgba } from './convert.js';\nimport { detectFormat } from './detectFormat.js';\nimport { getNameIndex, nearest, nearestAll } from './indexing.js';\nimport { web } from './palettes/web.js';\nimport type { ColorInput, DistanceMetric, HexColor, Palette, Rgba } from './types.js';\n\n/** Extract string keys from a Palette's `colors` map. */\ntype PaletteKey<P extends Palette> = Extract<keyof P['colors'], string>;\n\n/**\n * One ranked nearest-match entry when `identify` is called with `k`.\n * `value` is the palette's stored hex for the match (useful for rendering\n * swatches). `distance` is in the selected metric's natural units — ΔE\n * for `deltaE*` metrics, channel-unit Euclidean for the others.\n */\nexport type IdentifyMatch<Name extends string> = {\n  readonly name: Name;\n  readonly value: HexColor;\n  readonly distance: number;\n};\n\n/**\n * Parse a string input that may be a color literal or a palette name.\n * Returns the canonical Rgba, or `null` if nothing matches.\n */\nfunction parseInput(input: ColorInput | string, source?: Palette): Rgba | null {\n  const detected = detectFormat(input as ColorInput);\n  if (detected !== 'UNKNOWN') return toRgba(input as ColorInput, detected);\n  if (source !== undefined && typeof input === 'string') {\n    const canonical = getNameIndex(source).get(source.normalize(input));\n    if (canonical === undefined) return null;\n    const hex = (source.colors as Record<string, HexColor>)[canonical];\n    if (hex === undefined) return null;\n    return hexToRgba(hex);\n  }\n  return null;\n}\n\n/**\n * Identify the nearest-named color for any color input (or palette name\n * from another palette via `source`).\n *\n * **Simple case — color in, name out:**\n *   identify('#ff0000')                           → 'red'\n *   identify('#ff0000', { palette: pantone })     → '172 C'\n *\n * **Cross-palette — name from one palette, nearest in another:**\n *   identify('rebeccapurple', { palette: pantone, source: web })  → '267 C'\n *   identify('Razzmatazz',    { palette: pantone, source: crayola }) → '213 C'\n *\n * **Top-k ranked matches with ΔE distances:**\n *   identify('#ff0000', { palette: pantone, k: 3 })\n *   // [{ name: '172 C', value: '#fa4616', distance: 3.2 }, ...]\n *\n * The distance metric defaults to the target palette's `defaultMetric`\n * (web/x11: `deltaE76`, pantone: `deltaE2000`, crayola: `deltaEok`).\n * Override with `metric`.\n *\n * Returns `null` (or `[]` when `k` is set) if the input can't be parsed.\n */\n\n// Overload 1: no `k` — single name (or null). Unchanged legacy shape.\nexport function identify<P extends Palette = typeof web>(\n  input: ColorInput | string,\n  opts?: { palette?: P; source?: Palette; metric?: DistanceMetric },\n): PaletteKey<P> | null;\n\n// Overload 2: `k` present — ranked Match[] with distances.\nexport function identify<P extends Palette = typeof web>(\n  input: ColorInput | string,\n  opts: { palette?: P; source?: Palette; metric?: DistanceMetric; k: number },\n): Array<IdentifyMatch<PaletteKey<P>>>;\n\n// Implementation.\nexport function identify(\n  input: ColorInput | string,\n  opts: { palette?: Palette; source?: Palette; metric?: DistanceMetric; k?: number } = {},\n): string | null | Array<IdentifyMatch<string>> {\n  const palette = opts.palette ?? web;\n  const metric = opts.metric ?? palette.defaultMetric;\n  const rgba = parseInput(input, opts.source);\n\n  if (opts.k !== undefined) {\n    if (rgba === null) return [];\n    const raw = nearestAll(rgba, palette, metric, opts.k);\n    return raw.map((m) => {\n      const value = (palette.colors as Record<string, HexColor>)[m.name];\n      return { name: m.name, value: value as HexColor, distance: m.distance };\n    });\n  }\n\n  if (rgba === null) return null;\n  const name = nearest(rgba, palette, metric);\n  return name || null;\n}\n"]}

package/dist/index.d.ts

@@ -1,15 +1,16 @@
-export { type PantoneColorName, pantone } from './colorspaces/pantone';
-export { type WebColorName, web } from './colorspaces/web';
-export { type X11ColorName, x11 } from './colorspaces/x11';
-export { hexToRgba, rgbaToHex } from './conversions/hex';
-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, 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';
-export { COLOR_FORMATS } from './types';
+export { hexToRgba, rgbaToHex } from './conversions/hex.js';
+export { hslToRgba, rgbaToHsl } from './conversions/hsl.js';
+export { hsvToRgba, rgbaToHsv } from './conversions/hsv.js';
+export { pantoneToRgba, rgbaToPantone } from './conversions/pantone.js';
+export { rgbaToRgb, rgbToRgba } from './conversions/rgb.js';
+export { convert, fromRgba, toRgba } from './convert.js';
+export { type DetectedFormat, detectFormat, isColor } from './detectFormat.js';
+export { type IdentifyMatch, identify } from './identify.js';
+export { type CrayolaColorName, crayola } from './palettes/crayola.js';
+export { type PantoneColorName, pantone } from './palettes/pantone.js';
+export { type WebColorName, web } from './palettes/web.js';
+export { type X11ColorName, x11 } from './palettes/x11.js';
+export { type ResolveMatch, resolve } from './resolve.js';
+export type { ColorFormat, ColorInput, ColorValue, DistanceMetric, HexColor, HslInput, HslObject, HslString, HsvInput, HsvObject, HsvString, NormalizeFn, Palette, Rgba, RgbaInput, RgbaString, RgbaTuple, RgbInput, RgbObject, RgbString, RgbTuple, } from './types.js';
+export { COLOR_FORMATS } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,KAAK,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,KAAK,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,KAAK,gBAAgB,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACvE,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,KAAK,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EACT,QAAQ,EACR,SAAS,EACT,SAAS,EACT,WAAW,EACX,OAAO,EACP,IAAI,EACJ,SAAS,EACT,UAAU,EACV,SAAS,EACT,QAAQ,EACR,SAAS,EACT,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC","sourcesContent":["// Public API barrel — explicit named re-exports only (tree-shake friendly).\n// No default export; no side effects at module scope.\n\nexport { hexToRgba, rgbaToHex } from './conversions/hex.js';\nexport { hslToRgba, rgbaToHsl } from './conversions/hsl.js';\nexport { hsvToRgba, rgbaToHsv } from './conversions/hsv.js';\nexport { pantoneToRgba, rgbaToPantone } from './conversions/pantone.js';\nexport { rgbaToRgb, rgbToRgba } from './conversions/rgb.js';\nexport { convert, fromRgba, toRgba } from './convert.js';\nexport { type DetectedFormat, detectFormat, isColor } from './detectFormat.js';\nexport { type IdentifyMatch, identify } from './identify.js';\nexport { type CrayolaColorName, crayola } from './palettes/crayola.js';\nexport { type PantoneColorName, pantone } from './palettes/pantone.js';\nexport { type WebColorName, web } from './palettes/web.js';\nexport { type X11ColorName, x11 } from './palettes/x11.js';\nexport { type ResolveMatch, resolve } from './resolve.js';\nexport type {\n  ColorFormat,\n  ColorInput,\n  ColorValue,\n  DistanceMetric,\n  HexColor,\n  HslInput,\n  HslObject,\n  HslString,\n  HsvInput,\n  HsvObject,\n  HsvString,\n  NormalizeFn,\n  Palette,\n  Rgba,\n  RgbaInput,\n  RgbaString,\n  RgbaTuple,\n  RgbInput,\n  RgbObject,\n  RgbString,\n  RgbTuple,\n} from './types.js';\nexport { COLOR_FORMATS } from './types.js';\n"]}

package/dist/index.js

@@ -1,16 +1,17 @@
 // Public API barrel — explicit named re-exports only (tree-shake friendly).
 // No default export; no side effects at module scope.
-export { pantone } from './colorspaces/pantone';
-export { web } from './colorspaces/web';
-export { x11 } from './colorspaces/x11';
-export { hexToRgba, rgbaToHex } from './conversions/hex';
-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, fromRgba, toRgba } from './convert';
-export { detectFormat, isColor } from './detectFormat';
-export { identify } from './identify';
-export { resolve } from './resolve';
-export { COLOR_FORMATS } from './types';
+export { hexToRgba, rgbaToHex } from './conversions/hex.js';
+export { hslToRgba, rgbaToHsl } from './conversions/hsl.js';
+export { hsvToRgba, rgbaToHsv } from './conversions/hsv.js';
+export { pantoneToRgba, rgbaToPantone } from './conversions/pantone.js';
+export { rgbaToRgb, rgbToRgba } from './conversions/rgb.js';
+export { convert, fromRgba, toRgba } from './convert.js';
+export { detectFormat, isColor } from './detectFormat.js';
+export { identify } from './identify.js';
+export { crayola } from './palettes/crayola.js';
+export { pantone } from './palettes/pantone.js';
+export { web } from './palettes/web.js';
+export { x11 } from './palettes/x11.js';
+export { resolve } from './resolve.js';
+export { COLOR_FORMATS } from './types.js';
 //# sourceMappingURL=index.js.map

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,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,sDAAsD;AAEtD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAuB,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAsB,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAyB,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACvE,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,EAAqB,OAAO,EAAE,MAAM,cAAc,CAAC;AAwB1D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC","sourcesContent":["// Public API barrel — explicit named re-exports only (tree-shake friendly).\n// No default export; no side effects at module scope.\n\nexport { hexToRgba, rgbaToHex } from './conversions/hex.js';\nexport { hslToRgba, rgbaToHsl } from './conversions/hsl.js';\nexport { hsvToRgba, rgbaToHsv } from './conversions/hsv.js';\nexport { pantoneToRgba, rgbaToPantone } from './conversions/pantone.js';\nexport { rgbaToRgb, rgbToRgba } from './conversions/rgb.js';\nexport { convert, fromRgba, toRgba } from './convert.js';\nexport { type DetectedFormat, detectFormat, isColor } from './detectFormat.js';\nexport { type IdentifyMatch, identify } from './identify.js';\nexport { type CrayolaColorName, crayola } from './palettes/crayola.js';\nexport { type PantoneColorName, pantone } from './palettes/pantone.js';\nexport { type WebColorName, web } from './palettes/web.js';\nexport { type X11ColorName, x11 } from './palettes/x11.js';\nexport { type ResolveMatch, resolve } from './resolve.js';\nexport type {\n  ColorFormat,\n  ColorInput,\n  ColorValue,\n  DistanceMetric,\n  HexColor,\n  HslInput,\n  HslObject,\n  HslString,\n  HsvInput,\n  HsvObject,\n  HsvString,\n  NormalizeFn,\n  Palette,\n  Rgba,\n  RgbaInput,\n  RgbaString,\n  RgbaTuple,\n  RgbInput,\n  RgbObject,\n  RgbString,\n  RgbTuple,\n} from './types.js';\nexport { COLOR_FORMATS } from './types.js';\n"]}

package/dist/indexing.d.ts

@@ -1,44 +1,68 @@
-import type { Colorspace, DistanceMetric, Rgba } from './types';
+import type { DistanceMetric, NormalizeFn, Palette, Rgba } from './types.js';
 /**
- * Name normalization and per-colorspace lookup indexes.
+ * Per-palette lookup indexes for name resolution and nearest-match.
  *
- * 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.
+ * Caches are keyed by the Palette wrapper (WeakMap), so each palette's
+ * indexes are built once per process and reused by every caller —
+ * including BYO palettes the user supplies.
  */
-export type NormalizeFn = (name: string) => string;
-/** Lowercase + strip non-alphanumeric. Used for web and x11. */
-export declare const standardNormalize: NormalizeFn;
+export { pantoneNormalize, standardNormalize } from './palettes/normalize.js';
+export type { NormalizeFn };
+type AnyPalette = Palette<string>;
 /**
- * Pantone: also strip a leading "Pantone" or "PMS" prefix so that
- * "185 C", "185c", "Pantone 185 C", "PMS185C" all map to "185c".
+ * Normalized-name → canonical-key map for a given palette. Built once
+ * per palette using its own `normalize` function.
  */
-export declare const pantoneNormalize: NormalizeFn;
+export declare function getNameIndex(space: AnyPalette): Map<string, string>;
 /**
- * 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.
+ * Hex → canonical-key map (reverse of `palette.colors`). Built once per
+ * palette. Used by `convert(color, { palette, format: 'NAME' })` for
+ * O(1) exact reverse lookup. Returns `undefined` on miss — the caller
+ * decides whether that's an error (convert throws; use `identify` for
+ * nearest-match semantics).
+ *
+ * Hex values are lowercased for the key so callers can normalize their
+ * input with `rgbaToHex(...).toLowerCase()` before lookup.
  */
-export declare function getNameIndex(space: Colorspace, normalize: NormalizeFn): Map<string, string>;
+export declare function getReverseNameIndex(space: AnyPalette): Map<string, string>;
 /**
- * Canonical-key → Rgba entries for a given colorspace, built by parsing
+ * Canonical-key → Rgba entries for a given palette, built by parsing
  * each hex value once. Used by nearest-match lookups (identify, rgbaToPantone).
  */
-export declare function getRgbaIndex(space: Colorspace): Array<readonly [string, Rgba]>;
+export declare function getRgbaIndex(space: AnyPalette): Array<readonly [string, Rgba]>;
 /**
- * Find the nearest-named entry in a colorspace to the given Rgba, using
+ * Find the nearest-named entry in a palette 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;
+export declare function nearestByRgb(target: Rgba, space: AnyPalette): string;
 /**
- * Find the nearest-named entry in a colorspace under the specified distance
+ * Find the nearest-named entry in a palette 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.
+ *
+ * `metric` is required — callers should pass `space.defaultMetric` if
+ * they want the palette's declared preference. A silent default would
+ * hide the distance-metric choice from the hot path.
+ */
+export declare function nearest(target: Rgba, space: AnyPalette, metric: DistanceMetric): string;
+/**
+ * Rank every palette entry by distance to `target`. Returns an array of
+ * `{ name, distance }` sorted ascending (nearest first). Optional `k`
+ * truncates to the top-k matches.
+ *
+ * Distances are **real** metric values (not squared) — ΔE76 / ΔE94 /
+ * ΔE2000 / ΔE-OK are in standard ΔE units (≈1 = just-noticeable for
+ * most of the gamut on ΔE76/2000); `euclidean-srgb` / `euclidean-linear`
+ * are in their respective channel-unit Euclidean distances.
+ *
+ * Cost: O(n log n) for the sort vs O(n) for `nearest` — acceptable for
+ * top-K queries. For strict "what's the single nearest?" stay on
+ * `nearest` / `identify`.
  */
-export declare function nearest(target: Rgba, space: Colorspace, metric?: DistanceMetric): string;
+export declare function nearestAll(target: Rgba, space: AnyPalette, metric: DistanceMetric, k?: number): Array<{
+    name: string;
+    distance: number;
+}>;
 //# sourceMappingURL=indexing.d.ts.map

package/dist/indexing.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"indexing.d.ts","sourceRoot":"","sources":["../src/indexing.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAY,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvF;;;;;;GAMG;AAKH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B,KAAK,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAKlC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAWnE;AAID;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAU1E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAS9E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAYpE;AAsED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAavF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,IAAI,EACZ,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,cAAc,EACtB,CAAC,CAAC,EAAE,MAAM,GACT,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA2C3C","sourcesContent":["import { hexToRgba } from './conversions/hex.js';\nimport { rgbaToLab, rgbaToLinearRgb, rgbaToOklab } from './math/colorSpace.js';\nimport { deltaE76Squared, deltaE94, deltaE2000, deltaEokSquared } from './math/deltaE.js';\nimport { squaredDistanceRgb } from './math/euclideanDistance.js';\nimport type { DistanceMetric, HexColor, NormalizeFn, Palette, Rgba } from './types.js';\n\n/**\n * Per-palette lookup indexes for name resolution and nearest-match.\n *\n * Caches are keyed by the Palette wrapper (WeakMap), so each palette's\n * indexes are built once per process and reused by every caller —\n * including BYO palettes the user supplies.\n */\n\n// Re-export normalizers from their own module for backward compat with any\n// caller that expected them here. The functions live in ./palettes/normalize\n// so palette modules can import them without pulling this file's math graph.\nexport { pantoneNormalize, standardNormalize } from './palettes/normalize.js';\nexport type { NormalizeFn };\n\ntype AnyPalette = Palette<string>;\n\nconst nameIndexCache = new WeakMap<AnyPalette, Map<string, string>>();\nconst rgbaIndexCache = new WeakMap<AnyPalette, Array<readonly [string, Rgba]>>();\n\n/**\n * Normalized-name → canonical-key map for a given palette. Built once\n * per palette using its own `normalize` function.\n */\nexport function getNameIndex(space: AnyPalette): Map<string, string> {\n  let idx = nameIndexCache.get(space);\n  if (idx === undefined) {\n    idx = new Map();\n    const { normalize } = space;\n    for (const key of Object.keys(space.colors)) {\n      idx.set(normalize(key), key);\n    }\n    nameIndexCache.set(space, idx);\n  }\n  return idx;\n}\n\nconst reverseIndexCache = new WeakMap<AnyPalette, Map<string, string>>();\n\n/**\n * Hex → canonical-key map (reverse of `palette.colors`). Built once per\n * palette. Used by `convert(color, { palette, format: 'NAME' })` for\n * O(1) exact reverse lookup. Returns `undefined` on miss — the caller\n * decides whether that's an error (convert throws; use `identify` for\n * nearest-match semantics).\n *\n * Hex values are lowercased for the key so callers can normalize their\n * input with `rgbaToHex(...).toLowerCase()` before lookup.\n */\nexport function getReverseNameIndex(space: AnyPalette): Map<string, string> {\n  let idx = reverseIndexCache.get(space);\n  if (idx === undefined) {\n    idx = new Map();\n    for (const [name, hex] of Object.entries(space.colors)) {\n      idx.set((hex as string).toLowerCase(), name);\n    }\n    reverseIndexCache.set(space, idx);\n  }\n  return idx;\n}\n\n/**\n * Canonical-key → Rgba entries for a given palette, built by parsing\n * each hex value once. Used by nearest-match lookups (identify, rgbaToPantone).\n */\nexport function getRgbaIndex(space: AnyPalette): Array<readonly [string, Rgba]> {\n  let idx = rgbaIndexCache.get(space);\n  if (idx === undefined) {\n    idx = Object.entries(space.colors).map(\n      ([name, hex]) => [name, hexToRgba(hex as HexColor)] as const,\n    );\n    rgbaIndexCache.set(space, idx);\n  }\n  return idx;\n}\n\n/**\n * Find the nearest-named entry in a palette to the given Rgba, using\n * squared Euclidean distance in sRGB (alpha ignored). Used by `identify`\n * and `rgbaToPantone` when metric === 'euclidean-srgb'.\n */\nexport function nearestByRgb(target: Rgba, space: AnyPalette): string {\n  const entries = getRgbaIndex(space);\n  let bestName = entries[0]?.[0] ?? '';\n  let bestDistance = Number.POSITIVE_INFINITY;\n  for (const [name, candidate] of entries) {\n    const d = squaredDistanceRgb(target, candidate);\n    if (d < bestDistance) {\n      bestDistance = d;\n      bestName = name;\n    }\n  }\n  return bestName;\n}\n\n// Precomputed Lab entries for delta-E metrics. Same shape as rgba index.\ntype LabTriple = readonly [number, number, number];\nconst labIndexCache = new WeakMap<AnyPalette, Array<readonly [string, LabTriple]>>();\n\nfunction getLabIndex(space: AnyPalette): Array<readonly [string, LabTriple]> {\n  let idx = labIndexCache.get(space);\n  if (idx === undefined) {\n    idx = getRgbaIndex(space).map(([name, rgba]) => [name, rgbaToLab(rgba)] as const);\n    labIndexCache.set(space, idx);\n  }\n  return idx;\n}\n\n// Precomputed linear-RGB entries for euclidean-linear metric.\nconst linearIndexCache = new WeakMap<AnyPalette, Array<readonly [string, LabTriple]>>();\n\nfunction getLinearIndex(space: AnyPalette): Array<readonly [string, LabTriple]> {\n  let idx = linearIndexCache.get(space);\n  if (idx === undefined) {\n    idx = getRgbaIndex(space).map(([name, rgba]) => [name, rgbaToLinearRgb(rgba)] as const);\n    linearIndexCache.set(space, idx);\n  }\n  return idx;\n}\n\n// Precomputed OKLAB entries for deltaEok metric.\nconst oklabIndexCache = new WeakMap<AnyPalette, Array<readonly [string, LabTriple]>>();\n\nfunction getOklabIndex(space: AnyPalette): Array<readonly [string, LabTriple]> {\n  let idx = oklabIndexCache.get(space);\n  if (idx === undefined) {\n    idx = getRgbaIndex(space).map(([name, rgba]) => [name, rgbaToOklab(rgba)] as const);\n    oklabIndexCache.set(space, idx);\n  }\n  return idx;\n}\n\n/**\n * Generic argmin over an `[name, value]` entries array with a custom\n * distance function. Factored so the three metric branches in `nearest`\n * share one loop body instead of duplicating it three times.\n */\nfunction argminBy<T>(\n  entries: Array<readonly [string, T]>,\n  target: T,\n  dist: (a: T, b: T) => number,\n): string {\n  let bestName = entries[0]?.[0] ?? '';\n  let bestDistance = Number.POSITIVE_INFINITY;\n  for (const [name, candidate] of entries) {\n    const d = dist(target, candidate);\n    if (d < bestDistance) {\n      bestDistance = d;\n      bestName = name;\n    }\n  }\n  return bestName;\n}\n\n// Squared Euclidean on a [number, number, number] triple. Used for the\n// linear-RGB metric (sharing shape with Lab but different meaning).\nfunction squaredDistanceTriple(a: LabTriple, b: LabTriple): number {\n  const d0 = a[0] - b[0];\n  const d1 = a[1] - b[1];\n  const d2 = a[2] - b[2];\n  return d0 * d0 + d1 * d1 + d2 * d2;\n}\n\n/**\n * Find the nearest-named entry in a palette under the specified distance\n * metric. Dispatches to the right index (rgba / linear-rgb / Lab) and\n * the right distance function. See `DistanceMetric` in types.ts for how\n * to pick a metric.\n *\n * `metric` is required — callers should pass `space.defaultMetric` if\n * they want the palette's declared preference. A silent default would\n * hide the distance-metric choice from the hot path.\n */\nexport function nearest(target: Rgba, space: AnyPalette, metric: DistanceMetric): string {\n  if (metric === 'euclidean-srgb') return nearestByRgb(target, space);\n  if (metric === 'euclidean-linear') {\n    return argminBy(getLinearIndex(space), rgbaToLinearRgb(target), squaredDistanceTriple);\n  }\n  if (metric === 'deltaEok') {\n    return argminBy(getOklabIndex(space), rgbaToOklab(target), deltaEokSquared);\n  }\n  const labTarget = rgbaToLab(target);\n  const labIndex = getLabIndex(space);\n  if (metric === 'deltaE76') return argminBy(labIndex, labTarget, deltaE76Squared);\n  if (metric === 'deltaE94') return argminBy(labIndex, labTarget, deltaE94);\n  return argminBy(labIndex, labTarget, deltaE2000);\n}\n\n/**\n * Rank every palette entry by distance to `target`. Returns an array of\n * `{ name, distance }` sorted ascending (nearest first). Optional `k`\n * truncates to the top-k matches.\n *\n * Distances are **real** metric values (not squared) — ΔE76 / ΔE94 /\n * ΔE2000 / ΔE-OK are in standard ΔE units (≈1 = just-noticeable for\n * most of the gamut on ΔE76/2000); `euclidean-srgb` / `euclidean-linear`\n * are in their respective channel-unit Euclidean distances.\n *\n * Cost: O(n log n) for the sort vs O(n) for `nearest` — acceptable for\n * top-K queries. For strict \"what's the single nearest?\" stay on\n * `nearest` / `identify`.\n */\nexport function nearestAll(\n  target: Rgba,\n  space: AnyPalette,\n  metric: DistanceMetric,\n  k?: number,\n): Array<{ name: string; distance: number }> {\n  const ranked: Array<[string, number]> = [];\n\n  if (metric === 'euclidean-srgb') {\n    for (const [name, candidate] of getRgbaIndex(space)) {\n      ranked.push([name, Math.sqrt(squaredDistanceRgb(target, candidate))]);\n    }\n  } else if (metric === 'euclidean-linear') {\n    const tgt = rgbaToLinearRgb(target);\n    for (const [name, candidate] of getLinearIndex(space)) {\n      ranked.push([name, Math.sqrt(squaredDistanceTriple(tgt, candidate))]);\n    }\n  } else if (metric === 'deltaEok') {\n    const tgt = rgbaToOklab(target);\n    for (const [name, candidate] of getOklabIndex(space)) {\n      ranked.push([name, Math.sqrt(deltaEokSquared(tgt, candidate))]);\n    }\n  } else {\n    const tgt = rgbaToLab(target);\n    const labIndex = getLabIndex(space);\n    if (metric === 'deltaE76') {\n      for (const [name, candidate] of labIndex) {\n        ranked.push([name, Math.sqrt(deltaE76Squared(tgt, candidate))]);\n      }\n    } else if (metric === 'deltaE94') {\n      for (const [name, candidate] of labIndex) {\n        ranked.push([name, deltaE94(tgt, candidate)]);\n      }\n    } else {\n      for (const [name, candidate] of labIndex) {\n        ranked.push([name, deltaE2000(tgt, candidate)]);\n      }\n    }\n  }\n\n  ranked.sort((a, b) => a[1] - b[1]);\n  const limit = k === undefined ? ranked.length : Math.min(Math.max(k, 0), ranked.length);\n  const result: Array<{ name: string; distance: number }> = new Array(limit);\n  for (let i = 0; i < limit; i++) {\n    const entry = ranked[i];\n    if (entry !== undefined) result[i] = { name: entry[0], distance: entry[1] };\n  }\n  return result;\n}\n"]}

package/dist/indexing.js

@@ -1,49 +1,72 @@
-import { hexToRgba } from './conversions/hex';
-import { rgbaToLab, rgbaToLinearRgb, rgbaToOklab } from './math/colorSpace';
-import { deltaE76Squared, deltaE94, deltaE2000, deltaEokSquared } from './math/deltaE';
-import { squaredDistanceRgb } from './math/euclideanDistance';
-/** Lowercase + strip non-alphanumeric. Used for web and x11. */
-export const standardNormalize = (s) => s.toLowerCase().replace(/[^a-z0-9]/g, '');
+import { hexToRgba } from './conversions/hex.js';
+import { rgbaToLab, rgbaToLinearRgb, rgbaToOklab } from './math/colorSpace.js';
+import { deltaE76Squared, deltaE94, deltaE2000, deltaEokSquared } from './math/deltaE.js';
+import { squaredDistanceRgb } from './math/euclideanDistance.js';
 /**
- * Pantone: also strip a leading "Pantone" or "PMS" prefix so that
- * "185 C", "185c", "Pantone 185 C", "PMS185C" all map to "185c".
+ * Per-palette lookup indexes for name resolution and nearest-match.
+ *
+ * Caches are keyed by the Palette wrapper (WeakMap), so each palette's
+ * indexes are built once per process and reused by every caller —
+ * including BYO palettes the user supplies.
  */
-export const pantoneNormalize = (s) => s
-    .toLowerCase()
-    .replace(/^(pantone|pms)\s*/, '')
-    .replace(/[^a-z0-9]/g, '');
+// Re-export normalizers from their own module for backward compat with any
+// caller that expected them here. The functions live in ./palettes/normalize
+// so palette modules can import them without pulling this file's math graph.
+export { pantoneNormalize, standardNormalize } from './palettes/normalize.js';
 const nameIndexCache = new WeakMap();
 const rgbaIndexCache = new WeakMap();
 /**
- * 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.
+ * Normalized-name → canonical-key map for a given palette. Built once
+ * per palette using its own `normalize` function.
  */
-export function getNameIndex(space, normalize) {
+export function getNameIndex(space) {
     let idx = nameIndexCache.get(space);
     if (idx === undefined) {
         idx = new Map();
-        for (const key of Object.keys(space)) {
+        const { normalize } = space;
+        for (const key of Object.keys(space.colors)) {
             idx.set(normalize(key), key);
         }
         nameIndexCache.set(space, idx);
     }
     return idx;
 }
+const reverseIndexCache = new WeakMap();
 /**
- * Canonical-key → Rgba entries for a given colorspace, built by parsing
+ * Hex → canonical-key map (reverse of `palette.colors`). Built once per
+ * palette. Used by `convert(color, { palette, format: 'NAME' })` for
+ * O(1) exact reverse lookup. Returns `undefined` on miss — the caller
+ * decides whether that's an error (convert throws; use `identify` for
+ * nearest-match semantics).
+ *
+ * Hex values are lowercased for the key so callers can normalize their
+ * input with `rgbaToHex(...).toLowerCase()` before lookup.
+ */
+export function getReverseNameIndex(space) {
+    let idx = reverseIndexCache.get(space);
+    if (idx === undefined) {
+        idx = new Map();
+        for (const [name, hex] of Object.entries(space.colors)) {
+            idx.set(hex.toLowerCase(), name);
+        }
+        reverseIndexCache.set(space, idx);
+    }
+    return idx;
+}
+/**
+ * Canonical-key → Rgba entries for a given palette, built by parsing
  * each hex value once. Used by nearest-match lookups (identify, rgbaToPantone).
  */
 export function getRgbaIndex(space) {
     let idx = rgbaIndexCache.get(space);
     if (idx === undefined) {
-        idx = Object.entries(space).map(([name, hex]) => [name, hexToRgba(hex)]);
+        idx = Object.entries(space.colors).map(([name, hex]) => [name, hexToRgba(hex)]);
         rgbaIndexCache.set(space, idx);
     }
     return idx;
 }
 /**
- * Find the nearest-named entry in a colorspace to the given Rgba, using
+ * Find the nearest-named entry in a palette to the given Rgba, using
  * squared Euclidean distance in sRGB (alpha ignored). Used by `identify`
  * and `rgbaToPantone` when metric === 'euclidean-srgb'.
  */
@@ -115,12 +138,16 @@ function squaredDistanceTriple(a, b) {
     return d0 * d0 + d1 * d1 + d2 * d2;
 }
 /**
- * Find the nearest-named entry in a colorspace under the specified distance
+ * Find the nearest-named entry in a palette 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.
+ *
+ * `metric` is required — callers should pass `space.defaultMetric` if
+ * they want the palette's declared preference. A silent default would
+ * hide the distance-metric choice from the hot path.
  */
-export function nearest(target, space, metric = 'euclidean-srgb') {
+export function nearest(target, space, metric) {
     if (metric === 'euclidean-srgb')
         return nearestByRgb(target, space);
     if (metric === 'euclidean-linear') {
@@ -137,4 +164,66 @@ export function nearest(target, space, metric = 'euclidean-srgb') {
         return argminBy(labIndex, labTarget, deltaE94);
     return argminBy(labIndex, labTarget, deltaE2000);
 }
+/**
+ * Rank every palette entry by distance to `target`. Returns an array of
+ * `{ name, distance }` sorted ascending (nearest first). Optional `k`
+ * truncates to the top-k matches.
+ *
+ * Distances are **real** metric values (not squared) — ΔE76 / ΔE94 /
+ * ΔE2000 / ΔE-OK are in standard ΔE units (≈1 = just-noticeable for
+ * most of the gamut on ΔE76/2000); `euclidean-srgb` / `euclidean-linear`
+ * are in their respective channel-unit Euclidean distances.
+ *
+ * Cost: O(n log n) for the sort vs O(n) for `nearest` — acceptable for
+ * top-K queries. For strict "what's the single nearest?" stay on
+ * `nearest` / `identify`.
+ */
+export function nearestAll(target, space, metric, k) {
+    const ranked = [];
+    if (metric === 'euclidean-srgb') {
+        for (const [name, candidate] of getRgbaIndex(space)) {
+            ranked.push([name, Math.sqrt(squaredDistanceRgb(target, candidate))]);
+        }
+    }
+    else if (metric === 'euclidean-linear') {
+        const tgt = rgbaToLinearRgb(target);
+        for (const [name, candidate] of getLinearIndex(space)) {
+            ranked.push([name, Math.sqrt(squaredDistanceTriple(tgt, candidate))]);
+        }
+    }
+    else if (metric === 'deltaEok') {
+        const tgt = rgbaToOklab(target);
+        for (const [name, candidate] of getOklabIndex(space)) {
+            ranked.push([name, Math.sqrt(deltaEokSquared(tgt, candidate))]);
+        }
+    }
+    else {
+        const tgt = rgbaToLab(target);
+        const labIndex = getLabIndex(space);
+        if (metric === 'deltaE76') {
+            for (const [name, candidate] of labIndex) {
+                ranked.push([name, Math.sqrt(deltaE76Squared(tgt, candidate))]);
+            }
+        }
+        else if (metric === 'deltaE94') {
+            for (const [name, candidate] of labIndex) {
+                ranked.push([name, deltaE94(tgt, candidate)]);
+            }
+        }
+        else {
+            for (const [name, candidate] of labIndex) {
+                ranked.push([name, deltaE2000(tgt, candidate)]);
+            }
+        }
+    }
+    ranked.sort((a, b) => a[1] - b[1]);
+    const limit = k === undefined ? ranked.length : Math.min(Math.max(k, 0), ranked.length);
+    const result = new Array(limit);
+    for (let i = 0; i < limit; i++) {
+        const entry = ranked[i];
+        if (entry !== undefined)
+            result[i] = { name: entry[0], distance: entry[1] };
+    }
+    return result;
+}
 //# sourceMappingURL=indexing.js.map