chromonym 1.0.1 → 1.2.0

package/dist/index.js

@@ -1,268 +1,16 @@
-export const colorGroups = {
-    red: [
-        'rgb(102,0,0)',
-        'rgb(153,0,0)',
-        'rgb(204,0,0)',
-        'rgb(255,0,0)',
-        'rgb(255,51,51)',
-        'rgb(255,102,102)',
-        'rgb(255,153,153)',
-    ],
-    orange: [
-        'rgb(102,51,0)',
-        'rgb(153,76,0)',
-        'rgb(204,102,0)',
-        'rgb(255,128,0)',
-        'rgb(255,153,51)',
-        'rgb(255,178,102)',
-        'rgb(255,204,153)',
-    ],
-    yellow: [
-        'rgb(102,102,0)',
-        'rgb(153,153,0)',
-        'rgb(204,204,0)',
-        'rgb(255,255,0)',
-        'rgb(255,255,51)',
-        'rgb(255,255,102)',
-        'rgb(255,255,153)',
-        'rgb(255,255,204)',
-    ],
-    green: [
-        'rgb(124,252,0)',
-        'rgb(127,255,0)',
-        'rgb(50,205,50)',
-        'rgb(0,255,0)',
-        'rgb(34,139,34)',
-        'rgb(0,128,0)',
-        'rgb(0,100,0)',
-        'rgb(173,255,47)',
-        'rgb(154,205,50)',
-        'rgb(0,255,127)',
-        'rgb(0,250,154)',
-        'rgb(144,238,144)',
-        'rgb(152,251,152)',
-        'rgb(143,188,143)',
-        'rgb(60,179,113)',
-        'rgb(46,139,87)',
-        'rgb(128,128,0)',
-        'rgb(85,107,47)',
-        'rgb(107,142,35)',
-        'rgb(2,166,165)',
-        'rgb(13,125,126)',
-    ],
-    blue: [
-        'rgb(0,0,102)',
-        'rgb(0,0,153)',
-        'rgb(0,0,255)',
-        'rgb(51,51,255)',
-        'rgb(102,102,255)',
-        'rgb(0,51,102)',
-        'rgb(0,76,153)',
-        'rgb(0,102,204)',
-        'rgb(0,128,255)',
-        'rgb(51,153,255)',
-        'rgb(102,178,255)',
-        'rgb(0,204,204)',
-        'rgb(0,255,255)',
-        'rgb(51,255,255)',
-        'rgb(153,255,255)',
-        'rgb(204,229,255)',
-        'rgb(196,218,242)',
-    ],
-    white: [
-        'rgb(255,255,255)',
-        'rgb(255,250,250)',
-        'rgb(240,255,240)',
-        'rgb(245,255,250)',
-        'rgb(255,255,240)',
-        'rgb(196,222,237)',
-        'rgb(254,249,191)',
-        'rgb(169,199,209)',
-    ],
-    pink: [
-        'rgb(51,0,51)',
-        'rgb(102,0,102)',
-        'rgb(153,0,153)',
-        'rgb(204,0,204)',
-        'rgb(255,0,255)',
-        'rgb(255,51,255)',
-        'rgb(255,102,255)',
-        'rgb(255,153,255)',
-        'rgb(255,204,255)',
-        'rgb(251,140,173)',
-        'rgb(211,78,125)',
-    ],
-    black: ['rgb(0,0,0)', 'rgb(32,32,32)'],
-    grey: [
-        'rgb(64,64,64)',
-        'rgb(96,96,96)',
-        'rgb(128,128,128)',
-        'rgb(160,160,160)',
-        'rgb(192,192,192)',
-    ],
-    purple: [
-        'rgb(51,0,102)',
-        'rgb(76,0,153)',
-        'rgb(102,0,204)',
-        'rgb(127,0,255)',
-        'rgb(153,51,255)',
-        'rgb(178,102,255)',
-        'rgb(204,153,255)',
-    ],
-};
-export const cssColorList = {
-    aliceblue: '#f0f8ff',
-    antiquewhite: '#faebd7',
-    aqua: '#00ffff',
-    aquamarine: '#7fffd4',
-    azure: '#f0ffff',
-    beige: '#f5f5dc',
-    bisque: '#ffe4c4',
-    black: '#000000',
-    blanchedalmond: '#ffebcd',
-    blue: '#0000ff',
-    blueviolet: '#8a2be2',
-    brown: '#a52a2a',
-    burlywood: '#deb887',
-    cadetblue: '#5f9ea0',
-    chartreuse: '#7fff00',
-    chocolate: '#d2691e',
-    coral: '#ff7f50',
-    cornflowerblue: '#6495ed',
-    cornsilk: '#fff8dc',
-    crimson: '#dc143c',
-    cyan: '#00ffff',
-    darkblue: '#00008b',
-    darkcyan: '#008b8b',
-    darkgoldenrod: '#b8860b',
-    darkgray: '#a9a9a9',
-    darkgreen: '#006400',
-    darkgrey: '#a9a9a9',
-    darkkhaki: '#bdb76b',
-    darkmagenta: '#8b008b',
-    darkolivegreen: '#556b2f',
-    darkorange: '#ff8c00',
-    darkorchid: '#9932cc',
-    darkred: '#8b0000',
-    darksalmon: '#e9967a',
-    darkseagreen: '#8fbc8f',
-    darkslateblue: '#483d8b',
-    darkslategray: '#2f4f4f',
-    darkslategrey: '#2f4f4f',
-    darkturquoise: '#00ced1',
-    darkviolet: '#9400d3',
-    deeppink: '#ff1493',
-    deepskyblue: '#00bfff',
-    dimgray: '#696969',
-    dimgrey: '#696969',
-    dodgerblue: '#1e90ff',
-    firebrick: '#b22222',
-    floralwhite: '#fffaf0',
-    forestgreen: '#228b22',
-    fuchsia: '#ff00ff',
-    gainsboro: '#dcdcdc',
-    ghostwhite: '#f8f8ff',
-    goldenrod: '#daa520',
-    gold: '#ffd700',
-    gray: '#808080',
-    green: '#008000',
-    greenyellow: '#adff2f',
-    grey: '#808080',
-    honeydew: '#f0fff0',
-    hotpink: '#ff69b4',
-    indianred: '#cd5c5c',
-    indigo: '#4b0082',
-    ivory: '#fffff0',
-    khaki: '#f0e68c',
-    lavenderblush: '#fff0f5',
-    lavender: '#e6e6fa',
-    lawngreen: '#7cfc00',
-    lemonchiffon: '#fffacd',
-    lightblue: '#add8e6',
-    lightcoral: '#f08080',
-    lightcyan: '#e0ffff',
-    lightgoldenrodyellow: '#fafad2',
-    lightgray: '#d3d3d3',
-    lightgreen: '#90ee90',
-    lightgrey: '#d3d3d3',
-    lightpink: '#ffb6c1',
-    lightsalmon: '#ffa07a',
-    lightseagreen: '#20b2aa',
-    lightskyblue: '#87cefa',
-    lightslategray: '#778899',
-    lightslategrey: '#778899',
-    lightsteelblue: '#b0c4de',
-    lightyellow: '#ffffe0',
-    lime: '#00ff00',
-    limegreen: '#32cd32',
-    linen: '#faf0e6',
-    magenta: '#ff00ff',
-    maroon: '#800000',
-    mediumaquamarine: '#66cdaa',
-    mediumblue: '#0000cd',
-    mediumorchid: '#ba55d3',
-    mediumpurple: '#9370db',
-    mediumseagreen: '#3cb371',
-    mediumslateblue: '#7b68ee',
-    mediumspringgreen: '#00fa9a',
-    mediumturquoise: '#48d1cc',
-    mediumvioletred: '#c71585',
-    midnightblue: '#191970',
-    mintcream: '#f5fffa',
-    mistyrose: '#ffe4e1',
-    moccasin: '#ffe4b5',
-    navajowhite: '#ffdead',
-    navy: '#000080',
-    oldlace: '#fdf5e6',
-    olive: '#808000',
-    olivedrab: '#6b8e23',
-    orange: '#ffa500',
-    orangered: '#ff4500',
-    orchid: '#da70d6',
-    palegoldenrod: '#eee8aa',
-    palegreen: '#98fb98',
-    paleturquoise: '#afeeee',
-    palevioletred: '#db7093',
-    papayawhip: '#ffefd5',
-    peachpuff: '#ffdab9',
-    peru: '#cd853f',
-    pink: '#ffc0cb',
-    plum: '#dda0dd',
-    powderblue: '#b0e0e6',
-    purple: '#800080',
-    rebeccapurple: '#663399',
-    red: '#ff0000',
-    rosybrown: '#bc8f8f',
-    royalblue: '#4169e1',
-    saddlebrown: '#8b4513',
-    salmon: '#fa8072',
-    sandybrown: '#f4a460',
-    seagreen: '#2e8b57',
-    seashell: '#fff5ee',
-    sienna: '#a0522d',
-    silver: '#c0c0c0',
-    skyblue: '#87ceeb',
-    slateblue: '#6a5acd',
-    slategray: '#708090',
-    slategrey: '#708090',
-    snow: '#fffafa',
-    springgreen: '#00ff7f',
-    steelblue: '#4682b4',
-    tan: '#d2b48c',
-    teal: '#008080',
-    thistle: '#d8bfd8',
-    tomato: '#ff6347',
-    turquoise: '#40e0d0',
-    violet: '#ee82ee',
-    wheat: '#f5deb3',
-    white: '#ffffff',
-    whitesmoke: '#f5f5f5',
-    yellow: '#ffff00',
-    yellowgreen: '#9acd32',
-};
-export const colors = {
-    ...colorGroups,
-    cssColorList,
-};
-export default colors;
+// 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';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,GAAG,EAAE;QACH,cAAc;QACd,cAAc;QACd,cAAc;QACd,cAAc;QACd,gBAAgB;QAChB,kBAAkB;QAClB,kBAAkB;KACnB;IACD,MAAM,EAAE;QACN,eAAe;QACf,eAAe;QACf,gBAAgB;QAChB,gBAAgB;QAChB,iBAAiB;QACjB,kBAAkB;QAClB,kBAAkB;KACnB;IACD,MAAM,EAAE;QACN,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,iBAAiB;QACjB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;KACnB;IACD,KAAK,EAAE;QACL,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,cAAc;QACd,gBAAgB;QAChB,cAAc;QACd,cAAc;QACd,iBAAiB;QACjB,iBAAiB;QACjB,gBAAgB;QAChB,gBAAgB;QAChB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,iBAAiB;QACjB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,iBAAiB;QACjB,gBAAgB;QAChB,iBAAiB;KAClB;IACD,IAAI,EAAE;QACJ,cAAc;QACd,cAAc;QACd,cAAc;QACd,gBAAgB;QAChB,kBAAkB;QAClB,eAAe;QACf,eAAe;QACf,gBAAgB;QAChB,gBAAgB;QAChB,iBAAiB;QACjB,kBAAkB;QAClB,gBAAgB;QAChB,gBAAgB;QAChB,iBAAiB;QACjB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;KACnB;IACD,KAAK,EAAE;QACL,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;KACnB;IACD,IAAI,EAAE;QACJ,cAAc;QACd,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,iBAAiB;QACjB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,iBAAiB;KAClB;IACD,KAAK,EAAE,CAAC,YAAY,EAAE,eAAe,CAAC;IACtC,IAAI,EAAE;QACJ,eAAe;QACf,eAAe;QACf,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;KACnB;IACD,MAAM,EAAE;QACN,eAAe;QACf,eAAe;QACf,gBAAgB;QAChB,gBAAgB;QAChB,iBAAiB;QACjB,kBAAkB;QAClB,kBAAkB;KACnB;CACsD,CAAC;AAI1D,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS,EAAE,SAAS;IACpB,YAAY,EAAE,SAAS;IACvB,IAAI,EAAE,SAAS;IACf,UAAU,EAAE,SAAS;IACrB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,SAAS;IAChB,cAAc,EAAE,SAAS;IACzB,IAAI,EAAE,SAAS;IACf,UAAU,EAAE,SAAS;IACrB,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,SAAS;IACrB,SAAS,EAAE,SAAS;IACpB,KAAK,EAAE,SAAS;IAChB,cAAc,EAAE,SAAS;IACzB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,aAAa,EAAE,SAAS;IACxB,QAAQ,EAAE,SAAS;IACnB,SAAS,EAAE,SAAS;IACpB,QAAQ,EAAE,SAAS;IACnB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,SAAS;IACtB,cAAc,EAAE,SAAS;IACzB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,SAAS;IACvB,aAAa,EAAE,SAAS;IACxB,aAAa,EAAE,SAAS;IACxB,aAAa,EAAE,SAAS;IACxB,aAAa,EAAE,SAAS;IACxB,UAAU,EAAE,SAAS;IACrB,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,SAAS;IACtB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,SAAS;IACrB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,SAAS;IACtB,WAAW,EAAE,SAAS;IACtB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,SAAS;IACrB,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,WAAW,EAAE,SAAS;IACtB,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,aAAa,EAAE,SAAS;IACxB,QAAQ,EAAE,SAAS;IACnB,SAAS,EAAE,SAAS;IACpB,YAAY,EAAE,SAAS;IACvB,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,SAAS;IACrB,SAAS,EAAE,SAAS;IACpB,oBAAoB,EAAE,SAAS;IAC/B,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,SAAS;IACrB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,YAAY,EAAE,SAAS;IACvB,cAAc,EAAE,SAAS;IACzB,cAAc,EAAE,SAAS;IACzB,cAAc,EAAE,SAAS;IACzB,WAAW,EAAE,SAAS;IACtB,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,SAAS;IACpB,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IACjB,gBAAgB,EAAE,SAAS;IAC3B,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,SAAS;IACvB,cAAc,EAAE,SAAS;IACzB,eAAe,EAAE,SAAS;IAC1B,iBAAiB,EAAE,SAAS;IAC5B,eAAe,EAAE,SAAS;IAC1B,eAAe,EAAE,SAAS;IAC1B,YAAY,EAAE,SAAS;IACvB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,SAAS;IACtB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,SAAS;IACjB,aAAa,EAAE,SAAS;IACxB,SAAS,EAAE,SAAS;IACpB,aAAa,EAAE,SAAS;IACxB,aAAa,EAAE,SAAS;IACxB,UAAU,EAAE,SAAS;IACrB,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,UAAU,EAAE,SAAS;IACrB,MAAM,EAAE,SAAS;IACjB,aAAa,EAAE,SAAS;IACxB,GAAG,EAAE,SAAS;IACd,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,SAAS;IACtB,MAAM,EAAE,SAAS;IACjB,UAAU,EAAE,SAAS;IACrB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,SAAS;IACtB,SAAS,EAAE,SAAS;IACpB,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,UAAU,EAAE,SAAS;IACrB,MAAM,EAAE,SAAS;IACjB,WAAW,EAAE,SAAS;CACqB,CAAC;AAI9C,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,WAAW;IACd,YAAY;CACJ,CAAC;AAEX,eAAe,MAAM,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"}

package/dist/indexing.js

@@ -0,0 +1,140 @@
+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, '');
+/**
+ * Pantone: also strip a leading "Pantone" or "PMS" prefix so that
+ * "185 C", "185c", "Pantone 185 C", "PMS185C" all map to "185c".
+ */
+export const pantoneNormalize = (s) => s
+    .toLowerCase()
+    .replace(/^(pantone|pms)\s*/, '')
+    .replace(/[^a-z0-9]/g, '');
+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.
+ */
+export function getNameIndex(space, normalize) {
+    let idx = nameIndexCache.get(space);
+    if (idx === undefined) {
+        idx = new Map();
+        for (const key of Object.keys(space)) {
+            idx.set(normalize(key), key);
+        }
+        nameIndexCache.set(space, idx);
+    }
+    return idx;
+}
+/**
+ * Canonical-key → Rgba entries for a given colorspace, 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)]);
+        rgbaIndexCache.set(space, idx);
+    }
+    return idx;
+}
+/**
+ * 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 function nearestByRgb(target, space) {
+    const entries = getRgbaIndex(space);
+    let bestName = entries[0]?.[0] ?? '';
+    let bestDistance = Number.POSITIVE_INFINITY;
+    for (const [name, candidate] of entries) {
+        const d = squaredDistanceRgb(target, candidate);
+        if (d < bestDistance) {
+            bestDistance = d;
+            bestName = name;
+        }
+    }
+    return bestName;
+}
+const labIndexCache = new WeakMap();
+function getLabIndex(space) {
+    let idx = labIndexCache.get(space);
+    if (idx === undefined) {
+        idx = getRgbaIndex(space).map(([name, rgba]) => [name, rgbaToLab(rgba)]);
+        labIndexCache.set(space, idx);
+    }
+    return idx;
+}
+// Precomputed linear-RGB entries for euclidean-linear metric.
+const linearIndexCache = new WeakMap();
+function getLinearIndex(space) {
+    let idx = linearIndexCache.get(space);
+    if (idx === undefined) {
+        idx = getRgbaIndex(space).map(([name, rgba]) => [name, rgbaToLinearRgb(rgba)]);
+        linearIndexCache.set(space, idx);
+    }
+    return idx;
+}
+// Precomputed OKLAB entries for deltaEok metric.
+const oklabIndexCache = new WeakMap();
+function getOklabIndex(space) {
+    let idx = oklabIndexCache.get(space);
+    if (idx === undefined) {
+        idx = getRgbaIndex(space).map(([name, rgba]) => [name, rgbaToOklab(rgba)]);
+        oklabIndexCache.set(space, idx);
+    }
+    return idx;
+}
+/**
+ * Generic argmin over an `[name, value]` entries array with a custom
+ * distance function. Factored so the three metric branches in `nearest`
+ * share one loop body instead of duplicating it three times.
+ */
+function argminBy(entries, target, dist) {
+    let bestName = entries[0]?.[0] ?? '';
+    let bestDistance = Number.POSITIVE_INFINITY;
+    for (const [name, candidate] of entries) {
+        const d = dist(target, candidate);
+        if (d < bestDistance) {
+            bestDistance = d;
+            bestName = name;
+        }
+    }
+    return bestName;
+}
+// Squared Euclidean on a [number, number, number] triple. Used for the
+// linear-RGB metric (sharing shape with Lab but different meaning).
+function squaredDistanceTriple(a, b) {
+    const d0 = a[0] - b[0];
+    const d1 = a[1] - b[1];
+    const d2 = a[2] - b[2];
+    return d0 * d0 + d1 * d1 + d2 * d2;
+}
+/**
+ * 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 function nearest(target, space, metric = 'euclidean-srgb') {
+    if (metric === 'euclidean-srgb')
+        return nearestByRgb(target, space);
+    if (metric === 'euclidean-linear') {
+        return argminBy(getLinearIndex(space), rgbaToLinearRgb(target), squaredDistanceTriple);
+    }
+    if (metric === 'deltaEok') {
+        return argminBy(getOklabIndex(space), rgbaToOklab(target), deltaEokSquared);
+    }
+    const labTarget = rgbaToLab(target);
+    const labIndex = getLabIndex(space);
+    if (metric === 'deltaE76')
+        return argminBy(labIndex, labTarget, deltaE76Squared);
+    if (metric === 'deltaE94')
+        return argminBy(labIndex, labTarget, deltaE94);
+    return argminBy(labIndex, labTarget, deltaE2000);
+}
+//# sourceMappingURL=indexing.js.map

package/dist/indexing.js.map

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

package/dist/math/clamp.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Clamp n to [lo, hi]. Caller must ensure n is a finite number.
+ */
+export declare function clamp(n: number, lo: number, hi: number): number;
+/**
+ * Require a finite number at an API boundary; throws otherwise.
+ * Used by converter entry points to reject NaN, Infinity, and non-numeric
+ * values before they propagate through color math.
+ */
+export declare function requireFinite(n: unknown, label: string): number;
+//# sourceMappingURL=clamp.d.ts.map

package/dist/math/clamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp.d.ts","sourceRoot":"","sources":["../../src/math/clamp.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/D"}

package/dist/math/clamp.js

@@ -0,0 +1,18 @@
+/**
+ * Clamp n to [lo, hi]. Caller must ensure n is a finite number.
+ */
+export function clamp(n, lo, hi) {
+    return Math.max(lo, Math.min(hi, n));
+}
+/**
+ * Require a finite number at an API boundary; throws otherwise.
+ * Used by converter entry points to reject NaN, Infinity, and non-numeric
+ * values before they propagate through color math.
+ */
+export function requireFinite(n, label) {
+    if (typeof n !== 'number' || !Number.isFinite(n)) {
+        throw new Error(`Expected finite number for ${label}, got ${typeof n}: ${String(n)}`);
+    }
+    return n;
+}
+//# sourceMappingURL=clamp.js.map

package/dist/math/clamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp.js","sourceRoot":"","sources":["../../src/math/clamp.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,CAAS,EAAE,EAAU,EAAE,EAAU;IACrD,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,CAAU,EAAE,KAAa;IACrD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,SAAS,OAAO,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/math/colorSpace.d.ts

@@ -0,0 +1,39 @@
+import type { Rgba } from '../types';
+/**
+ * Color-space conversions needed by the perceptual distance metrics.
+ *
+ * Pipeline:  sRGB (0..255)  →  linear RGB (0..1)  →  XYZ (D65)  →  Lab
+ *
+ * References:
+ *   sRGB EOTF / companding:      IEC 61966-2-1
+ *   sRGB → XYZ (D65):            Bruce Lindbloom, http://www.brucelindbloom.com/
+ *   XYZ → Lab:                   CIE 15: 2004
+ */
+/** sRGB → linear for a single channel in [0, 255]. Returns [0, 1]. */
+export declare function srgbToLinear(channel: number): number;
+/** Linear → sRGB for a single channel in [0, 1]. Returns [0, 1] (scale by 255 if needed). */
+export declare function linearToSrgb(linear: number): number;
+/** Rgba → linear RGB triple in [0, 1] (alpha dropped). */
+export declare function rgbaToLinearRgb(rgba: Rgba): [number, number, number];
+/**
+ * Linear RGB (D65) → CIE XYZ (D65), using the standard sRGB matrix.
+ * Input and output both in [0, 1] on each axis (approximately; Y = 1 is white).
+ */
+export declare function linearRgbToXyz(r: number, g: number, b: number): [number, number, number];
+/** CIE XYZ (D65) → CIE Lab. L ∈ [0, 100] approx; a,b unbounded but typically [-128, 127]. */
+export declare function xyzToLab(x: number, y: number, z: number): [number, number, number];
+/** Rgba (sRGB, 0..255) → CIE Lab. Canonical pipeline for perceptual distance. */
+export declare function rgbaToLab(rgba: Rgba): [number, number, number];
+/**
+ * Linear sRGB → OKLAB (Björn Ottosson, 2020). OKLAB is strictly more
+ * perceptually uniform than CIELAB, especially in the blue/purple region
+ * where even CIEDE2000 has residual error. Distance in OKLAB is plain
+ * Euclidean — no weighting formula needed, because the space itself is
+ * designed around uniformity.
+ *
+ * Reference: https://bottosson.github.io/posts/oklab/
+ */
+export declare function linearRgbToOklab(r: number, g: number, b: number): [number, number, number];
+/** Rgba (sRGB, 0..255) → OKLAB. */
+export declare function rgbaToOklab(rgba: Rgba): [number, number, number];
+//# sourceMappingURL=colorSpace.d.ts.map

package/dist/math/colorSpace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorSpace.d.ts","sourceRoot":"","sources":["../../src/math/colorSpace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAErC;;;;;;;;;GASG;AAEH,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAEpE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAKxF;AAaD,6FAA6F;AAC7F,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAQlF;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAI9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAa1F;AAED,mCAAmC;AACnC,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAGhE"}

package/dist/math/colorSpace.js

@@ -0,0 +1,85 @@
+/**
+ * Color-space conversions needed by the perceptual distance metrics.
+ *
+ * Pipeline:  sRGB (0..255)  →  linear RGB (0..1)  →  XYZ (D65)  →  Lab
+ *
+ * References:
+ *   sRGB EOTF / companding:      IEC 61966-2-1
+ *   sRGB → XYZ (D65):            Bruce Lindbloom, http://www.brucelindbloom.com/
+ *   XYZ → Lab:                   CIE 15: 2004
+ */
+/** sRGB → linear for a single channel in [0, 255]. Returns [0, 1]. */
+export function srgbToLinear(channel) {
+    const s = channel / 255;
+    return s <= 0.04045 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4;
+}
+/** Linear → sRGB for a single channel in [0, 1]. Returns [0, 1] (scale by 255 if needed). */
+export function linearToSrgb(linear) {
+    return linear <= 0.0031308 ? 12.92 * linear : 1.055 * linear ** (1 / 2.4) - 0.055;
+}
+/** Rgba → linear RGB triple in [0, 1] (alpha dropped). */
+export function rgbaToLinearRgb(rgba) {
+    return [srgbToLinear(rgba.r), srgbToLinear(rgba.g), srgbToLinear(rgba.b)];
+}
+/**
+ * Linear RGB (D65) → CIE XYZ (D65), using the standard sRGB matrix.
+ * Input and output both in [0, 1] on each axis (approximately; Y = 1 is white).
+ */
+export function linearRgbToXyz(r, g, b) {
+    const x = r * 0.4124564 + g * 0.3575761 + b * 0.1804375;
+    const y = r * 0.2126729 + g * 0.7151522 + b * 0.072175;
+    const z = r * 0.0193339 + g * 0.119192 + b * 0.9503041;
+    return [x, y, z];
+}
+// D65 white reference (CIE 1931 2° observer).
+const XN = 0.95047;
+const YN = 1.0;
+const ZN = 1.08883;
+// f(t) in the CIE Lab formula; cube-root with a linear toe near origin.
+function labF(t) {
+    const DELTA = 6 / 29;
+    return t > DELTA ** 3 ? Math.cbrt(t) : t / (3 * DELTA ** 2) + 4 / 29;
+}
+/** CIE XYZ (D65) → CIE Lab. L ∈ [0, 100] approx; a,b unbounded but typically [-128, 127]. */
+export function xyzToLab(x, y, z) {
+    const fx = labF(x / XN);
+    const fy = labF(y / YN);
+    const fz = labF(z / ZN);
+    const l = 116 * fy - 16;
+    const a = 500 * (fx - fy);
+    const b = 200 * (fy - fz);
+    return [l, a, b];
+}
+/** Rgba (sRGB, 0..255) → CIE Lab. Canonical pipeline for perceptual distance. */
+export function rgbaToLab(rgba) {
+    const [r, g, b] = rgbaToLinearRgb(rgba);
+    const [x, y, z] = linearRgbToXyz(r, g, b);
+    return xyzToLab(x, y, z);
+}
+/**
+ * Linear sRGB → OKLAB (Björn Ottosson, 2020). OKLAB is strictly more
+ * perceptually uniform than CIELAB, especially in the blue/purple region
+ * where even CIEDE2000 has residual error. Distance in OKLAB is plain
+ * Euclidean — no weighting formula needed, because the space itself is
+ * designed around uniformity.
+ *
+ * Reference: https://bottosson.github.io/posts/oklab/
+ */
+export function linearRgbToOklab(r, g, b) {
+    const l = 0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b;
+    const m = 0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b;
+    const s = 0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b;
+    const l_ = Math.cbrt(l);
+    const m_ = Math.cbrt(m);
+    const s_ = Math.cbrt(s);
+    const L = 0.2104542553 * l_ + 0.793617785 * m_ - 0.0040720468 * s_;
+    const a = 1.9779984951 * l_ - 2.428592205 * m_ + 0.4505937099 * s_;
+    const b2 = 0.0259040371 * l_ + 0.7827717662 * m_ - 0.808675766 * s_;
+    return [L, a, b2];
+}
+/** Rgba (sRGB, 0..255) → OKLAB. */
+export function rgbaToOklab(rgba) {
+    const [r, g, b] = rgbaToLinearRgb(rgba);
+    return linearRgbToOklab(r, g, b);
+}
+//# sourceMappingURL=colorSpace.js.map