chromonym 2.0.0 → 3.1.0

package/dist/palettes/crayola.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Crayola crayon colors — canonical subset. ~85 entries covering the
+ * current 64-standard box, iconic fluorescents, and widely-recognized
+ * modern additions.
+ *
+ * Keys are Title Case with spaces (`'Granny Smith Apple'`,
+ * `'Razzmatazz'`) — how the names are printed on the crayon wrapper.
+ * `standardNormalize` strips spaces + case + punctuation on input, so
+ * `resolve('granny-smith-apple')` and `resolve('Granny Smith Apple')`
+ * both hit the same entry.
+ *
+ * sRGB values are community-sourced approximations (Wikipedia's
+ * well-cited list of Crayola crayon colors). They do not represent
+ * a licensed Crayola reference. See NOTICE.md for trademark note.
+ *
+ * Default metric: `deltaEok`. The Crayola set spans a wide gamut with
+ * many saturated brights (fluorescents especially) where CIELAB-based
+ * metrics are less perceptually uniform than OKLAB. Same cost profile
+ * as deltaE76, better neighbor selection in saturated regions.
+ */
+declare const crayolaColors: {
+    readonly Red: '#ee204d';
+    readonly 'Red Orange': '#ff5349';
+    readonly Orange: '#ff7538';
+    readonly 'Yellow Orange': '#ffae42';
+    readonly Yellow: '#fce883';
+    readonly 'Yellow Green': '#c5e384';
+    readonly Green: '#1cac78';
+    readonly 'Blue Green': '#0d98ba';
+    readonly Blue: '#1f75fe';
+    readonly 'Blue Violet': '#7366bd';
+    readonly Violet: '#926eae';
+    readonly 'Red Violet': '#c0448f';
+    readonly Black: '#232323';
+    readonly Brown: '#b4674d';
+    readonly White: '#ededed';
+    readonly Gray: '#95918c';
+    readonly 'Carnation Pink': '#ffaacc';
+    readonly 'Sky Blue': '#80daeb';
+    readonly Tan: '#faa76c';
+    readonly Apricot: '#fdd9b5';
+    readonly Peach: '#ffcfab';
+    readonly 'Cadet Blue': '#b0b7c6';
+    readonly Salmon: '#ff9baa';
+    readonly 'Forest Green': '#6dae81';
+    readonly 'Lemon Yellow': '#fff44f';
+    readonly Mahogany: '#cd4a4c';
+    readonly Maroon: '#c8385a';
+    readonly Bittersweet: '#fd7c6e';
+    readonly Sepia: '#a5694f';
+    readonly 'Burnt Sienna': '#ea7e5d';
+    readonly 'Burnt Orange': '#ff7f49';
+    readonly 'Raw Sienna': '#d68a59';
+    readonly Silver: '#cdc5c2';
+    readonly Gold: '#e7c697';
+    readonly Copper: '#dd9475';
+    readonly 'Green Yellow': '#f0e891';
+    readonly 'Pine Green': '#158078';
+    readonly 'Olive Green': '#bab86c';
+    readonly Indigo: '#5d76cb';
+    readonly Periwinkle: '#c5d0e6';
+    readonly Cerulean: '#1dacd6';
+    readonly 'Sea Green': '#9fe2bf';
+    readonly 'Turquoise Blue': '#77dde7';
+    readonly 'Atomic Tangerine': '#ff9966';
+    readonly 'Blizzard Blue': '#ace5ee';
+    readonly 'Hot Magenta': '#ff1dce';
+    readonly 'Laser Lemon': '#fdfc74';
+    readonly 'Neon Carrot': '#ffa343';
+    readonly 'Purple Pizzazz': '#fe4eda';
+    readonly 'Razzle Dazzle Rose': '#ff48d0';
+    readonly Razzmatazz: '#e3256b';
+    readonly "Screamin' Green": '#76ff7a';
+    readonly 'Shocking Pink': '#fb7efd';
+    readonly 'Tickle Me Pink': '#fc89ac';
+    readonly 'Unmellow Yellow': '#ffff66';
+    readonly 'Wild Watermelon': '#fc6c85';
+    readonly 'Outrageous Orange': '#ff6e4a';
+    readonly 'Electric Lime': '#ceff1d';
+    readonly 'Granny Smith Apple': '#a8e4a0';
+    readonly 'Macaroni and Cheese': '#ffbd88';
+    readonly 'Banana Mania': '#fae7b5';
+    readonly 'Caribbean Green': '#1cd3a2';
+    readonly Cerise: '#dd4492';
+    readonly 'Cotton Candy': '#ffbcd9';
+    readonly 'Fuzzy Wuzzy': '#cc6666';
+    readonly Inchworm: '#b2ec5d';
+    readonly 'Jazzberry Jam': '#ca3767';
+    readonly Manatee: '#979aaa';
+    readonly 'Mango Tango': '#ff8243';
+    readonly Mauvelous: '#ef98aa';
+    readonly 'Midnight Blue': '#1a4876';
+    readonly 'Navy Blue': '#1974d2';
+    readonly 'Pacific Blue': '#1ca9c9';
+    readonly 'Piggy Pink': '#fddde6';
+    readonly Plum: '#8e4585';
+    readonly 'Purple Heart': '#7442c8';
+    readonly "Robin's Egg Blue": '#1fcecb';
+    readonly 'Royal Purple': '#7851a9';
+    readonly Scarlet: '#fc2847';
+    readonly Timberwolf: '#dbd7d2';
+    readonly Tumbleweed: '#deaa88';
+    readonly 'Violet Red': '#f75394';
+    readonly 'Vivid Violet': '#8f509d';
+    readonly Wisteria: '#cda4de';
+};
+export type CrayolaColorName = keyof typeof crayolaColors;
+export declare const crayola: {
+    readonly name: 'crayola';
+    readonly colors: {
+        readonly Red: '#ee204d';
+        readonly 'Red Orange': '#ff5349';
+        readonly Orange: '#ff7538';
+        readonly 'Yellow Orange': '#ffae42';
+        readonly Yellow: '#fce883';
+        readonly 'Yellow Green': '#c5e384';
+        readonly Green: '#1cac78';
+        readonly 'Blue Green': '#0d98ba';
+        readonly Blue: '#1f75fe';
+        readonly 'Blue Violet': '#7366bd';
+        readonly Violet: '#926eae';
+        readonly 'Red Violet': '#c0448f';
+        readonly Black: '#232323';
+        readonly Brown: '#b4674d';
+        readonly White: '#ededed';
+        readonly Gray: '#95918c';
+        readonly 'Carnation Pink': '#ffaacc';
+        readonly 'Sky Blue': '#80daeb';
+        readonly Tan: '#faa76c';
+        readonly Apricot: '#fdd9b5';
+        readonly Peach: '#ffcfab';
+        readonly 'Cadet Blue': '#b0b7c6';
+        readonly Salmon: '#ff9baa';
+        readonly 'Forest Green': '#6dae81';
+        readonly 'Lemon Yellow': '#fff44f';
+        readonly Mahogany: '#cd4a4c';
+        readonly Maroon: '#c8385a';
+        readonly Bittersweet: '#fd7c6e';
+        readonly Sepia: '#a5694f';
+        readonly 'Burnt Sienna': '#ea7e5d';
+        readonly 'Burnt Orange': '#ff7f49';
+        readonly 'Raw Sienna': '#d68a59';
+        readonly Silver: '#cdc5c2';
+        readonly Gold: '#e7c697';
+        readonly Copper: '#dd9475';
+        readonly 'Green Yellow': '#f0e891';
+        readonly 'Pine Green': '#158078';
+        readonly 'Olive Green': '#bab86c';
+        readonly Indigo: '#5d76cb';
+        readonly Periwinkle: '#c5d0e6';
+        readonly Cerulean: '#1dacd6';
+        readonly 'Sea Green': '#9fe2bf';
+        readonly 'Turquoise Blue': '#77dde7';
+        readonly 'Atomic Tangerine': '#ff9966';
+        readonly 'Blizzard Blue': '#ace5ee';
+        readonly 'Hot Magenta': '#ff1dce';
+        readonly 'Laser Lemon': '#fdfc74';
+        readonly 'Neon Carrot': '#ffa343';
+        readonly 'Purple Pizzazz': '#fe4eda';
+        readonly 'Razzle Dazzle Rose': '#ff48d0';
+        readonly Razzmatazz: '#e3256b';
+        readonly "Screamin' Green": '#76ff7a';
+        readonly 'Shocking Pink': '#fb7efd';
+        readonly 'Tickle Me Pink': '#fc89ac';
+        readonly 'Unmellow Yellow': '#ffff66';
+        readonly 'Wild Watermelon': '#fc6c85';
+        readonly 'Outrageous Orange': '#ff6e4a';
+        readonly 'Electric Lime': '#ceff1d';
+        readonly 'Granny Smith Apple': '#a8e4a0';
+        readonly 'Macaroni and Cheese': '#ffbd88';
+        readonly 'Banana Mania': '#fae7b5';
+        readonly 'Caribbean Green': '#1cd3a2';
+        readonly Cerise: '#dd4492';
+        readonly 'Cotton Candy': '#ffbcd9';
+        readonly 'Fuzzy Wuzzy': '#cc6666';
+        readonly Inchworm: '#b2ec5d';
+        readonly 'Jazzberry Jam': '#ca3767';
+        readonly Manatee: '#979aaa';
+        readonly 'Mango Tango': '#ff8243';
+        readonly Mauvelous: '#ef98aa';
+        readonly 'Midnight Blue': '#1a4876';
+        readonly 'Navy Blue': '#1974d2';
+        readonly 'Pacific Blue': '#1ca9c9';
+        readonly 'Piggy Pink': '#fddde6';
+        readonly Plum: '#8e4585';
+        readonly 'Purple Heart': '#7442c8';
+        readonly "Robin's Egg Blue": '#1fcecb';
+        readonly 'Royal Purple': '#7851a9';
+        readonly Scarlet: '#fc2847';
+        readonly Timberwolf: '#dbd7d2';
+        readonly Tumbleweed: '#deaa88';
+        readonly 'Violet Red': '#f75394';
+        readonly 'Vivid Violet': '#8f509d';
+        readonly Wisteria: '#cda4de';
+    };
+    readonly normalize: import("../types.js").NormalizeFn;
+    readonly defaultMetric: 'deltaEok';
+};
+export {};
+//# sourceMappingURL=crayola.d.ts.map

package/dist/palettes/crayola.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crayola.d.ts","sourceRoot":"","sources":["../../src/palettes/crayola.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Palette } from '../types.js';\nimport { standardNormalize } from './normalize.js';\n\n/**\n * Crayola crayon colors — canonical subset. ~85 entries covering the\n * current 64-standard box, iconic fluorescents, and widely-recognized\n * modern additions.\n *\n * Keys are Title Case with spaces (`'Granny Smith Apple'`,\n * `'Razzmatazz'`) — how the names are printed on the crayon wrapper.\n * `standardNormalize` strips spaces + case + punctuation on input, so\n * `resolve('granny-smith-apple')` and `resolve('Granny Smith Apple')`\n * both hit the same entry.\n *\n * sRGB values are community-sourced approximations (Wikipedia's\n * well-cited list of Crayola crayon colors). They do not represent\n * a licensed Crayola reference. See NOTICE.md for trademark note.\n *\n * Default metric: `deltaEok`. The Crayola set spans a wide gamut with\n * many saturated brights (fluorescents especially) where CIELAB-based\n * metrics are less perceptually uniform than OKLAB. Same cost profile\n * as deltaE76, better neighbor selection in saturated regions.\n */\nconst crayolaColors = {\n  // --- Current standard box: the 12 primary/secondary hue wheel ---\n  Red: '#ee204d',\n  'Red Orange': '#ff5349',\n  Orange: '#ff7538',\n  'Yellow Orange': '#ffae42',\n  Yellow: '#fce883',\n  'Yellow Green': '#c5e384',\n  Green: '#1cac78',\n  'Blue Green': '#0d98ba',\n  Blue: '#1f75fe',\n  'Blue Violet': '#7366bd',\n  Violet: '#926eae',\n  'Red Violet': '#c0448f',\n\n  // --- Achromatics ---\n  Black: '#232323',\n  Brown: '#b4674d',\n  White: '#ededed',\n  Gray: '#95918c',\n\n  // --- 64-box additions (pre-1990 core set) ---\n  'Carnation Pink': '#ffaacc',\n  'Sky Blue': '#80daeb',\n  Tan: '#faa76c',\n  Apricot: '#fdd9b5',\n  Peach: '#ffcfab',\n  'Cadet Blue': '#b0b7c6',\n  Salmon: '#ff9baa',\n  'Forest Green': '#6dae81',\n  'Lemon Yellow': '#fff44f',\n  Mahogany: '#cd4a4c',\n  Maroon: '#c8385a',\n  Bittersweet: '#fd7c6e',\n  Sepia: '#a5694f',\n  'Burnt Sienna': '#ea7e5d',\n  'Burnt Orange': '#ff7f49',\n  'Raw Sienna': '#d68a59',\n\n  // --- Metallics ---\n  Silver: '#cdc5c2',\n  Gold: '#e7c697',\n  Copper: '#dd9475',\n\n  // --- Earth / nature tones ---\n  'Green Yellow': '#f0e891',\n  'Pine Green': '#158078',\n  'Olive Green': '#bab86c',\n  Indigo: '#5d76cb',\n  Periwinkle: '#c5d0e6',\n  Cerulean: '#1dacd6',\n  'Sea Green': '#9fe2bf',\n  'Turquoise Blue': '#77dde7',\n\n  // --- Fluorescents (the iconic \"Neon 24\" era) ---\n  'Atomic Tangerine': '#ff9966',\n  'Blizzard Blue': '#ace5ee',\n  'Hot Magenta': '#ff1dce',\n  'Laser Lemon': '#fdfc74',\n  'Neon Carrot': '#ffa343',\n  'Purple Pizzazz': '#fe4eda',\n  'Razzle Dazzle Rose': '#ff48d0',\n  Razzmatazz: '#e3256b',\n  \"Screamin' Green\": '#76ff7a',\n  'Shocking Pink': '#fb7efd',\n  'Tickle Me Pink': '#fc89ac',\n  'Unmellow Yellow': '#ffff66',\n  'Wild Watermelon': '#fc6c85',\n  'Outrageous Orange': '#ff6e4a',\n  'Electric Lime': '#ceff1d',\n\n  // --- Modern / whimsical additions ---\n  'Granny Smith Apple': '#a8e4a0',\n  'Macaroni and Cheese': '#ffbd88',\n  'Banana Mania': '#fae7b5',\n  'Caribbean Green': '#1cd3a2',\n  Cerise: '#dd4492',\n  'Cotton Candy': '#ffbcd9',\n  'Fuzzy Wuzzy': '#cc6666',\n  Inchworm: '#b2ec5d',\n  'Jazzberry Jam': '#ca3767',\n  Manatee: '#979aaa',\n  'Mango Tango': '#ff8243',\n  Mauvelous: '#ef98aa',\n  'Midnight Blue': '#1a4876',\n  'Navy Blue': '#1974d2',\n  'Pacific Blue': '#1ca9c9',\n  'Piggy Pink': '#fddde6',\n  Plum: '#8e4585',\n  'Purple Heart': '#7442c8',\n  \"Robin's Egg Blue\": '#1fcecb',\n  'Royal Purple': '#7851a9',\n  Scarlet: '#fc2847',\n  Timberwolf: '#dbd7d2',\n  Tumbleweed: '#deaa88',\n  'Violet Red': '#f75394',\n  'Vivid Violet': '#8f509d',\n  Wisteria: '#cda4de',\n} as const;\n\nexport type CrayolaColorName = keyof typeof crayolaColors;\n\nexport const crayola = {\n  name: 'crayola',\n  colors: crayolaColors,\n  normalize: standardNormalize,\n  defaultMetric: 'deltaEok',\n} as const satisfies Palette<CrayolaColorName>;\n"]}

package/dist/palettes/crayola.js

@@ -0,0 +1,121 @@
+import { standardNormalize } from './normalize.js';
+/**
+ * Crayola crayon colors — canonical subset. ~85 entries covering the
+ * current 64-standard box, iconic fluorescents, and widely-recognized
+ * modern additions.
+ *
+ * Keys are Title Case with spaces (`'Granny Smith Apple'`,
+ * `'Razzmatazz'`) — how the names are printed on the crayon wrapper.
+ * `standardNormalize` strips spaces + case + punctuation on input, so
+ * `resolve('granny-smith-apple')` and `resolve('Granny Smith Apple')`
+ * both hit the same entry.
+ *
+ * sRGB values are community-sourced approximations (Wikipedia's
+ * well-cited list of Crayola crayon colors). They do not represent
+ * a licensed Crayola reference. See NOTICE.md for trademark note.
+ *
+ * Default metric: `deltaEok`. The Crayola set spans a wide gamut with
+ * many saturated brights (fluorescents especially) where CIELAB-based
+ * metrics are less perceptually uniform than OKLAB. Same cost profile
+ * as deltaE76, better neighbor selection in saturated regions.
+ */
+const crayolaColors = {
+    // --- Current standard box: the 12 primary/secondary hue wheel ---
+    Red: '#ee204d',
+    'Red Orange': '#ff5349',
+    Orange: '#ff7538',
+    'Yellow Orange': '#ffae42',
+    Yellow: '#fce883',
+    'Yellow Green': '#c5e384',
+    Green: '#1cac78',
+    'Blue Green': '#0d98ba',
+    Blue: '#1f75fe',
+    'Blue Violet': '#7366bd',
+    Violet: '#926eae',
+    'Red Violet': '#c0448f',
+    // --- Achromatics ---
+    Black: '#232323',
+    Brown: '#b4674d',
+    White: '#ededed',
+    Gray: '#95918c',
+    // --- 64-box additions (pre-1990 core set) ---
+    'Carnation Pink': '#ffaacc',
+    'Sky Blue': '#80daeb',
+    Tan: '#faa76c',
+    Apricot: '#fdd9b5',
+    Peach: '#ffcfab',
+    'Cadet Blue': '#b0b7c6',
+    Salmon: '#ff9baa',
+    'Forest Green': '#6dae81',
+    'Lemon Yellow': '#fff44f',
+    Mahogany: '#cd4a4c',
+    Maroon: '#c8385a',
+    Bittersweet: '#fd7c6e',
+    Sepia: '#a5694f',
+    'Burnt Sienna': '#ea7e5d',
+    'Burnt Orange': '#ff7f49',
+    'Raw Sienna': '#d68a59',
+    // --- Metallics ---
+    Silver: '#cdc5c2',
+    Gold: '#e7c697',
+    Copper: '#dd9475',
+    // --- Earth / nature tones ---
+    'Green Yellow': '#f0e891',
+    'Pine Green': '#158078',
+    'Olive Green': '#bab86c',
+    Indigo: '#5d76cb',
+    Periwinkle: '#c5d0e6',
+    Cerulean: '#1dacd6',
+    'Sea Green': '#9fe2bf',
+    'Turquoise Blue': '#77dde7',
+    // --- Fluorescents (the iconic "Neon 24" era) ---
+    'Atomic Tangerine': '#ff9966',
+    'Blizzard Blue': '#ace5ee',
+    'Hot Magenta': '#ff1dce',
+    'Laser Lemon': '#fdfc74',
+    'Neon Carrot': '#ffa343',
+    'Purple Pizzazz': '#fe4eda',
+    'Razzle Dazzle Rose': '#ff48d0',
+    Razzmatazz: '#e3256b',
+    "Screamin' Green": '#76ff7a',
+    'Shocking Pink': '#fb7efd',
+    'Tickle Me Pink': '#fc89ac',
+    'Unmellow Yellow': '#ffff66',
+    'Wild Watermelon': '#fc6c85',
+    'Outrageous Orange': '#ff6e4a',
+    'Electric Lime': '#ceff1d',
+    // --- Modern / whimsical additions ---
+    'Granny Smith Apple': '#a8e4a0',
+    'Macaroni and Cheese': '#ffbd88',
+    'Banana Mania': '#fae7b5',
+    'Caribbean Green': '#1cd3a2',
+    Cerise: '#dd4492',
+    'Cotton Candy': '#ffbcd9',
+    'Fuzzy Wuzzy': '#cc6666',
+    Inchworm: '#b2ec5d',
+    'Jazzberry Jam': '#ca3767',
+    Manatee: '#979aaa',
+    'Mango Tango': '#ff8243',
+    Mauvelous: '#ef98aa',
+    'Midnight Blue': '#1a4876',
+    'Navy Blue': '#1974d2',
+    'Pacific Blue': '#1ca9c9',
+    'Piggy Pink': '#fddde6',
+    Plum: '#8e4585',
+    'Purple Heart': '#7442c8',
+    "Robin's Egg Blue": '#1fcecb',
+    'Royal Purple': '#7851a9',
+    Scarlet: '#fc2847',
+    Timberwolf: '#dbd7d2',
+    Tumbleweed: '#deaa88',
+    'Violet Red': '#f75394',
+    'Vivid Violet': '#8f509d',
+    Wisteria: '#cda4de',
+};
+export const crayola = {
+    name: 'crayola',
+    colors: crayolaColors,
+    normalize: standardNormalize,
+    defaultMetric: 'deltaEok',
+};
+//# sourceMappingURL=crayola.js.map

package/dist/palettes/crayola.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crayola.js","sourceRoot":"","sources":["../../src/palettes/crayola.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Palette } from '../types.js';\nimport { standardNormalize } from './normalize.js';\n\n/**\n * Crayola crayon colors — canonical subset. ~85 entries covering the\n * current 64-standard box, iconic fluorescents, and widely-recognized\n * modern additions.\n *\n * Keys are Title Case with spaces (`'Granny Smith Apple'`,\n * `'Razzmatazz'`) — how the names are printed on the crayon wrapper.\n * `standardNormalize` strips spaces + case + punctuation on input, so\n * `resolve('granny-smith-apple')` and `resolve('Granny Smith Apple')`\n * both hit the same entry.\n *\n * sRGB values are community-sourced approximations (Wikipedia's\n * well-cited list of Crayola crayon colors). They do not represent\n * a licensed Crayola reference. See NOTICE.md for trademark note.\n *\n * Default metric: `deltaEok`. The Crayola set spans a wide gamut with\n * many saturated brights (fluorescents especially) where CIELAB-based\n * metrics are less perceptually uniform than OKLAB. Same cost profile\n * as deltaE76, better neighbor selection in saturated regions.\n */\nconst crayolaColors = {\n  // --- Current standard box: the 12 primary/secondary hue wheel ---\n  Red: '#ee204d',\n  'Red Orange': '#ff5349',\n  Orange: '#ff7538',\n  'Yellow Orange': '#ffae42',\n  Yellow: '#fce883',\n  'Yellow Green': '#c5e384',\n  Green: '#1cac78',\n  'Blue Green': '#0d98ba',\n  Blue: '#1f75fe',\n  'Blue Violet': '#7366bd',\n  Violet: '#926eae',\n  'Red Violet': '#c0448f',\n\n  // --- Achromatics ---\n  Black: '#232323',\n  Brown: '#b4674d',\n  White: '#ededed',\n  Gray: '#95918c',\n\n  // --- 64-box additions (pre-1990 core set) ---\n  'Carnation Pink': '#ffaacc',\n  'Sky Blue': '#80daeb',\n  Tan: '#faa76c',\n  Apricot: '#fdd9b5',\n  Peach: '#ffcfab',\n  'Cadet Blue': '#b0b7c6',\n  Salmon: '#ff9baa',\n  'Forest Green': '#6dae81',\n  'Lemon Yellow': '#fff44f',\n  Mahogany: '#cd4a4c',\n  Maroon: '#c8385a',\n  Bittersweet: '#fd7c6e',\n  Sepia: '#a5694f',\n  'Burnt Sienna': '#ea7e5d',\n  'Burnt Orange': '#ff7f49',\n  'Raw Sienna': '#d68a59',\n\n  // --- Metallics ---\n  Silver: '#cdc5c2',\n  Gold: '#e7c697',\n  Copper: '#dd9475',\n\n  // --- Earth / nature tones ---\n  'Green Yellow': '#f0e891',\n  'Pine Green': '#158078',\n  'Olive Green': '#bab86c',\n  Indigo: '#5d76cb',\n  Periwinkle: '#c5d0e6',\n  Cerulean: '#1dacd6',\n  'Sea Green': '#9fe2bf',\n  'Turquoise Blue': '#77dde7',\n\n  // --- Fluorescents (the iconic \"Neon 24\" era) ---\n  'Atomic Tangerine': '#ff9966',\n  'Blizzard Blue': '#ace5ee',\n  'Hot Magenta': '#ff1dce',\n  'Laser Lemon': '#fdfc74',\n  'Neon Carrot': '#ffa343',\n  'Purple Pizzazz': '#fe4eda',\n  'Razzle Dazzle Rose': '#ff48d0',\n  Razzmatazz: '#e3256b',\n  \"Screamin' Green\": '#76ff7a',\n  'Shocking Pink': '#fb7efd',\n  'Tickle Me Pink': '#fc89ac',\n  'Unmellow Yellow': '#ffff66',\n  'Wild Watermelon': '#fc6c85',\n  'Outrageous Orange': '#ff6e4a',\n  'Electric Lime': '#ceff1d',\n\n  // --- Modern / whimsical additions ---\n  'Granny Smith Apple': '#a8e4a0',\n  'Macaroni and Cheese': '#ffbd88',\n  'Banana Mania': '#fae7b5',\n  'Caribbean Green': '#1cd3a2',\n  Cerise: '#dd4492',\n  'Cotton Candy': '#ffbcd9',\n  'Fuzzy Wuzzy': '#cc6666',\n  Inchworm: '#b2ec5d',\n  'Jazzberry Jam': '#ca3767',\n  Manatee: '#979aaa',\n  'Mango Tango': '#ff8243',\n  Mauvelous: '#ef98aa',\n  'Midnight Blue': '#1a4876',\n  'Navy Blue': '#1974d2',\n  'Pacific Blue': '#1ca9c9',\n  'Piggy Pink': '#fddde6',\n  Plum: '#8e4585',\n  'Purple Heart': '#7442c8',\n  \"Robin's Egg Blue\": '#1fcecb',\n  'Royal Purple': '#7851a9',\n  Scarlet: '#fc2847',\n  Timberwolf: '#dbd7d2',\n  Tumbleweed: '#deaa88',\n  'Violet Red': '#f75394',\n  'Vivid Violet': '#8f509d',\n  Wisteria: '#cda4de',\n} as const;\n\nexport type CrayolaColorName = keyof typeof crayolaColors;\n\nexport const crayola = {\n  name: 'crayola',\n  colors: crayolaColors,\n  normalize: standardNormalize,\n  defaultMetric: 'deltaEok',\n} as const satisfies Palette<CrayolaColorName>;\n"]}

package/dist/resolve.d.ts

@@ -1,16 +1,49 @@
+import { web } from './palettes/web.js';
 import type { ColorFormat, ColorValue, Palette } from './types.js';
+/** Extract string keys from a Palette's `colors` map. */
+type PaletteKey<P extends Palette> = Extract<keyof P['colors'], string>;
 /**
- * Resolve a human-readable name to a color. Normalizes the input using the
- * palette's own `normalize` function before looking it up. Returns `null`
- * if unknown.
+ * One ranked fuzzy-match entry when `resolve` is called with `k`.
+ * `distance` is the Levenshtein edit distance between the normalized
+ * input and the normalized palette key — integer count of insertions,
+ * deletions, and substitutions.
+ */
+export type ResolveMatch<Name extends string> = {
+    readonly name: Name;
+    readonly value: ColorValue;
+    readonly distance: number;
+};
+/**
+ * Resolve a human-readable name to a color. Normalizes the input using
+ * the palette's own `normalize` function before looking it up.
+ *
+ * **Without `k`** (strict, unchanged): returns the exact match value, or
+ * `null` if the normalized name isn't in the palette.
  *
- * Defaults: palette = `web`, format = 'HEX'.
+ * **With `k`** (fuzzy, typo-tolerant): returns an array of the top `k`
+ * matches ranked by Levenshtein edit distance against normalized keys.
+ * Useful for user-typed input where misspellings, casing, and
+ * punctuation can all be recovered.
  *
- * BYO palettes: pass any object matching `Palette<Name>` — no registration
- * needed; the palette's normalizer handles lookup.
+ * ```ts
+ * resolve('rebeccapurple')                                // '#663399'
+ * resolve('rebecapurple')                                 // null (strict)
+ * resolve('rebecapurple', { palette: web, k: 3 })         // fuzzy:
+ * //   [{ name: 'rebeccapurple', value: '#663399', distance: 1 },
+ * //    { name: 'purple',        value: '#800080', distance: 6 },
+ * //    ...]
+ * ```
+ *
+ * Defaults: palette = `web`, format = 'HEX', `k` = undefined (strict).
  */
 export declare function resolve(name: string, opts?: {
     palette?: Palette;
     format?: ColorFormat;
 }): ColorValue | null;
+export declare function resolve<P extends Palette = typeof web>(name: string, opts: {
+    palette?: P;
+    format?: ColorFormat;
+    k: number;
+}): Array<ResolveMatch<PaletteKey<P>>>;
+export {};
 //# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAY,OAAO,EAAE,MAAM,YAAY,CAAC;AAE7E;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACrD,UAAU,GAAG,IAAI,CASnB","sourcesContent":["import { hexToRgba } from './conversions/hex.js';\nimport { fromRgba } from './convert.js';\nimport { getNameIndex } from './indexing.js';\nimport { web } from './palettes/web.js';\nimport type { ColorFormat, ColorValue, HexColor, Palette } from './types.js';\n\n/**\n * Resolve a human-readable name to a color. Normalizes the input using the\n * palette's own `normalize` function before looking it up. Returns `null`\n * if unknown.\n *\n * Defaults: palette = `web`, format = 'HEX'.\n *\n * BYO palettes: pass any object matching `Palette<Name>` — no registration\n * needed; the palette's normalizer handles lookup.\n */\nexport function resolve(\n  name: string,\n  opts: { palette?: Palette; format?: ColorFormat } = {},\n): ColorValue | null {\n  const palette = opts.palette ?? web;\n  const format = opts.format ?? 'HEX';\n  const canonical = getNameIndex(palette).get(palette.normalize(name));\n  if (canonical === undefined) return null;\n  const hex = (palette.colors as Record<string, HexColor>)[canonical];\n  if (hex === undefined) return null;\n  // Skip detectFormat — we already know this is HEX (read from palette data).\n  return fromRgba(hexToRgba(hex), format);\n}\n"]}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAY,OAAO,EAAE,MAAM,YAAY,CAAC;AAO7E,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,YAAY,CAAC,IAAI,SAAS,MAAM,IAAI;IAC9C,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GACjD,UAAU,GAAG,IAAI,CAAC;AAGrB,wBAAgB,OAAO,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,GAAG,EACpD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC","sourcesContent":["import { hexToRgba } from './conversions/hex.js';\nimport { fromRgba } from './convert.js';\nimport { getNameIndex } from './indexing.js';\nimport { levenshtein } from './math/editDistance.js';\nimport { web } from './palettes/web.js';\nimport type { ColorFormat, ColorValue, HexColor, Palette } from './types.js';\n\n// No built-in palette key exceeds ~30 chars post-normalize; anything well past\n// that can't plausibly win a fuzzy match and risks pathological O(n·m) cost\n// across every palette entry. Guard the k-branch input at 64.\nconst MAX_FUZZY_INPUT_LENGTH = 64;\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 fuzzy-match entry when `resolve` is called with `k`.\n * `distance` is the Levenshtein edit distance between the normalized\n * input and the normalized palette key — integer count of insertions,\n * deletions, and substitutions.\n */\nexport type ResolveMatch<Name extends string> = {\n  readonly name: Name;\n  readonly value: ColorValue;\n  readonly distance: number;\n};\n\n/**\n * Resolve a human-readable name to a color. Normalizes the input using\n * the palette's own `normalize` function before looking it up.\n *\n * **Without `k`** (strict, unchanged): returns the exact match value, or\n * `null` if the normalized name isn't in the palette.\n *\n * **With `k`** (fuzzy, typo-tolerant): returns an array of the top `k`\n * matches ranked by Levenshtein edit distance against normalized keys.\n * Useful for user-typed input where misspellings, casing, and\n * punctuation can all be recovered.\n *\n * ```ts\n * resolve('rebeccapurple')                                // '#663399'\n * resolve('rebecapurple')                                 // null (strict)\n * resolve('rebecapurple', { palette: web, k: 3 })         // fuzzy:\n * //   [{ name: 'rebeccapurple', value: '#663399', distance: 1 },\n * //    { name: 'purple',        value: '#800080', distance: 6 },\n * //    ...]\n * ```\n *\n * Defaults: palette = `web`, format = 'HEX', `k` = undefined (strict).\n */\n\n// Overload 1: strict — single ColorValue or null (unchanged).\nexport function resolve(\n  name: string,\n  opts?: { palette?: Palette; format?: ColorFormat },\n): ColorValue | null;\n\n// Overload 2: fuzzy top-k — ranked Match[].\nexport function resolve<P extends Palette = typeof web>(\n  name: string,\n  opts: { palette?: P; format?: ColorFormat; k: number },\n): Array<ResolveMatch<PaletteKey<P>>>;\n\n// Implementation.\nexport function resolve(\n  name: string,\n  opts: { palette?: Palette; format?: ColorFormat; k?: number } = {},\n): ColorValue | null | Array<ResolveMatch<string>> {\n  const palette = opts.palette ?? web;\n  const format = opts.format ?? 'HEX';\n  const normalized = palette.normalize(name);\n\n  if (opts.k !== undefined) {\n    const limit = Math.max(0, opts.k);\n    if (limit === 0) return [];\n    if (normalized.length > MAX_FUZZY_INPUT_LENGTH) return [];\n    // Iterate the name index's normalized → canonical map once; for each\n    // entry compute Levenshtein from the user's normalized input.\n    const ranked: Array<[string, number]> = [];\n    for (const [normalizedKey, canonical] of getNameIndex(palette).entries()) {\n      ranked.push([canonical, levenshtein(normalized, normalizedKey)]);\n    }\n    ranked.sort((a, b) => a[1] - b[1]);\n    const out: Array<ResolveMatch<string>> = [];\n    const take = Math.min(limit, ranked.length);\n    for (let i = 0; i < take; i++) {\n      const entry = ranked[i];\n      if (entry === undefined) continue;\n      const hex = (palette.colors as Record<string, HexColor>)[entry[0]];\n      if (hex === undefined) continue;\n      out.push({\n        name: entry[0],\n        value: fromRgba(hexToRgba(hex), format),\n        distance: entry[1],\n      });\n    }\n    return out;\n  }\n\n  // Strict path.\n  const canonical = getNameIndex(palette).get(normalized);\n  if (canonical === undefined) return null;\n  const hex = (palette.colors as Record<string, HexColor>)[canonical];\n  if (hex === undefined) return null;\n  return fromRgba(hexToRgba(hex), format);\n}\n"]}

package/dist/resolve.js

@@ -1,27 +1,54 @@
 import { hexToRgba } from './conversions/hex.js';
 import { fromRgba } from './convert.js';
 import { getNameIndex } from './indexing.js';
+import { levenshtein } from './math/editDistance.js';
 import { web } from './palettes/web.js';
-/**
- * Resolve a human-readable name to a color. Normalizes the input using the
- * palette's own `normalize` function before looking it up. Returns `null`
- * if unknown.
- *
- * Defaults: palette = `web`, format = 'HEX'.
- *
- * BYO palettes: pass any object matching `Palette<Name>` — no registration
- * needed; the palette's normalizer handles lookup.
- */
+// No built-in palette key exceeds ~30 chars post-normalize; anything well past
+// that can't plausibly win a fuzzy match and risks pathological O(n·m) cost
+// across every palette entry. Guard the k-branch input at 64.
+const MAX_FUZZY_INPUT_LENGTH = 64;
+// Implementation.
 export function resolve(name, opts = {}) {
     const palette = opts.palette ?? web;
     const format = opts.format ?? 'HEX';
-    const canonical = getNameIndex(palette).get(palette.normalize(name));
+    const normalized = palette.normalize(name);
+    if (opts.k !== undefined) {
+        const limit = Math.max(0, opts.k);
+        if (limit === 0)
+            return [];
+        if (normalized.length > MAX_FUZZY_INPUT_LENGTH)
+            return [];
+        // Iterate the name index's normalized → canonical map once; for each
+        // entry compute Levenshtein from the user's normalized input.
+        const ranked = [];
+        for (const [normalizedKey, canonical] of getNameIndex(palette).entries()) {
+            ranked.push([canonical, levenshtein(normalized, normalizedKey)]);
+        }
+        ranked.sort((a, b) => a[1] - b[1]);
+        const out = [];
+        const take = Math.min(limit, ranked.length);
+        for (let i = 0; i < take; i++) {
+            const entry = ranked[i];
+            if (entry === undefined)
+                continue;
+            const hex = palette.colors[entry[0]];
+            if (hex === undefined)
+                continue;
+            out.push({
+                name: entry[0],
+                value: fromRgba(hexToRgba(hex), format),
+                distance: entry[1],
+            });
+        }
+        return out;
+    }
+    // Strict path.
+    const canonical = getNameIndex(palette).get(normalized);
     if (canonical === undefined)
         return null;
     const hex = palette.colors[canonical];
     if (hex === undefined)
         return null;
-    // Skip detectFormat — we already know this is HEX (read from palette data).
     return fromRgba(hexToRgba(hex), format);
 }
 //# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGxC;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CACrB,IAAY,EACZ,IAAI,GAAgD,EAAE;IAEtD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;IACpC,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,GAAG,GAAI,OAAO,CAAC,MAAmC,CAAC,SAAS,CAAC,CAAC;IACpE,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnC,4EAA4E;IAC5E,OAAO,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC","sourcesContent":["import { hexToRgba } from './conversions/hex.js';\nimport { fromRgba } from './convert.js';\nimport { getNameIndex } from './indexing.js';\nimport { web } from './palettes/web.js';\nimport type { ColorFormat, ColorValue, HexColor, Palette } from './types.js';\n\n/**\n * Resolve a human-readable name to a color. Normalizes the input using the\n * palette's own `normalize` function before looking it up. Returns `null`\n * if unknown.\n *\n * Defaults: palette = `web`, format = 'HEX'.\n *\n * BYO palettes: pass any object matching `Palette<Name>` — no registration\n * needed; the palette's normalizer handles lookup.\n */\nexport function resolve(\n  name: string,\n  opts: { palette?: Palette; format?: ColorFormat } = {},\n): ColorValue | null {\n  const palette = opts.palette ?? web;\n  const format = opts.format ?? 'HEX';\n  const canonical = getNameIndex(palette).get(palette.normalize(name));\n  if (canonical === undefined) return null;\n  const hex = (palette.colors as Record<string, HexColor>)[canonical];\n  if (hex === undefined) return null;\n  // Skip detectFormat — we already know this is HEX (read from palette data).\n  return fromRgba(hexToRgba(hex), format);\n}\n"]}
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGxC,+EAA+E;AAC/E,4EAA4E;AAC5E,8DAA8D;AAC9D,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAqDlC,kBAAkB;AAClB,MAAM,UAAU,OAAO,CACrB,IAAY,EACZ,IAAI,GAA4D,EAAE;IAElE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;IACpC,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAE3C,IAAI,IAAI,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,MAAM,GAAG,sBAAsB;YAAE,OAAO,EAAE,CAAC;QAC1D,qEAAqE;QACrE,8DAA8D;QAC9D,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YACzE,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,GAAG,GAAgC,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACxB,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAClC,MAAM,GAAG,GAAI,OAAO,CAAC,MAAmC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACnE,IAAI,GAAG,KAAK,SAAS;gBAAE,SAAS;YAChC,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;gBACd,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;gBACvC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;aACnB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,eAAe;IACf,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxD,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,GAAG,GAAI,OAAO,CAAC,MAAmC,CAAC,SAAS,CAAC,CAAC;IACpE,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC","sourcesContent":["import { hexToRgba } from './conversions/hex.js';\nimport { fromRgba } from './convert.js';\nimport { getNameIndex } from './indexing.js';\nimport { levenshtein } from './math/editDistance.js';\nimport { web } from './palettes/web.js';\nimport type { ColorFormat, ColorValue, HexColor, Palette } from './types.js';\n\n// No built-in palette key exceeds ~30 chars post-normalize; anything well past\n// that can't plausibly win a fuzzy match and risks pathological O(n·m) cost\n// across every palette entry. Guard the k-branch input at 64.\nconst MAX_FUZZY_INPUT_LENGTH = 64;\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 fuzzy-match entry when `resolve` is called with `k`.\n * `distance` is the Levenshtein edit distance between the normalized\n * input and the normalized palette key — integer count of insertions,\n * deletions, and substitutions.\n */\nexport type ResolveMatch<Name extends string> = {\n  readonly name: Name;\n  readonly value: ColorValue;\n  readonly distance: number;\n};\n\n/**\n * Resolve a human-readable name to a color. Normalizes the input using\n * the palette's own `normalize` function before looking it up.\n *\n * **Without `k`** (strict, unchanged): returns the exact match value, or\n * `null` if the normalized name isn't in the palette.\n *\n * **With `k`** (fuzzy, typo-tolerant): returns an array of the top `k`\n * matches ranked by Levenshtein edit distance against normalized keys.\n * Useful for user-typed input where misspellings, casing, and\n * punctuation can all be recovered.\n *\n * ```ts\n * resolve('rebeccapurple')                                // '#663399'\n * resolve('rebecapurple')                                 // null (strict)\n * resolve('rebecapurple', { palette: web, k: 3 })         // fuzzy:\n * //   [{ name: 'rebeccapurple', value: '#663399', distance: 1 },\n * //    { name: 'purple',        value: '#800080', distance: 6 },\n * //    ...]\n * ```\n *\n * Defaults: palette = `web`, format = 'HEX', `k` = undefined (strict).\n */\n\n// Overload 1: strict — single ColorValue or null (unchanged).\nexport function resolve(\n  name: string,\n  opts?: { palette?: Palette; format?: ColorFormat },\n): ColorValue | null;\n\n// Overload 2: fuzzy top-k — ranked Match[].\nexport function resolve<P extends Palette = typeof web>(\n  name: string,\n  opts: { palette?: P; format?: ColorFormat; k: number },\n): Array<ResolveMatch<PaletteKey<P>>>;\n\n// Implementation.\nexport function resolve(\n  name: string,\n  opts: { palette?: Palette; format?: ColorFormat; k?: number } = {},\n): ColorValue | null | Array<ResolveMatch<string>> {\n  const palette = opts.palette ?? web;\n  const format = opts.format ?? 'HEX';\n  const normalized = palette.normalize(name);\n\n  if (opts.k !== undefined) {\n    const limit = Math.max(0, opts.k);\n    if (limit === 0) return [];\n    if (normalized.length > MAX_FUZZY_INPUT_LENGTH) return [];\n    // Iterate the name index's normalized → canonical map once; for each\n    // entry compute Levenshtein from the user's normalized input.\n    const ranked: Array<[string, number]> = [];\n    for (const [normalizedKey, canonical] of getNameIndex(palette).entries()) {\n      ranked.push([canonical, levenshtein(normalized, normalizedKey)]);\n    }\n    ranked.sort((a, b) => a[1] - b[1]);\n    const out: Array<ResolveMatch<string>> = [];\n    const take = Math.min(limit, ranked.length);\n    for (let i = 0; i < take; i++) {\n      const entry = ranked[i];\n      if (entry === undefined) continue;\n      const hex = (palette.colors as Record<string, HexColor>)[entry[0]];\n      if (hex === undefined) continue;\n      out.push({\n        name: entry[0],\n        value: fromRgba(hexToRgba(hex), format),\n        distance: entry[1],\n      });\n    }\n    return out;\n  }\n\n  // Strict path.\n  const canonical = getNameIndex(palette).get(normalized);\n  if (canonical === undefined) return null;\n  const hex = (palette.colors as Record<string, HexColor>)[canonical];\n  if (hex === undefined) return null;\n  return fromRgba(hexToRgba(hex), format);\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "chromonym",
-  "version": "2.0.0",
-  "description": "One color-naming API for any palette. Identify, resolve, and convert colors across your own palette or the built-in CSS, X11, and Pantone sets — fully typed, tree-shakeable, perceptual distance metrics (CIEDE2000).",
+  "version": "3.1.0",
+  "description": "One color-naming API for any palette. Identify, resolve, and convert colors across your own palette or the built-in CSS, X11, Pantone, and Crayola sets — fully typed, tree-shakeable, perceptual distance metrics (CIEDE2000 / OKLAB).",
   "keywords": [
     "color",
     "color-name",
@@ -13,6 +13,7 @@
     "css-colors",
     "x11-colors",
     "pantone",
+    "crayola",
     "deltaE",
     "ciede2000",
     "lab",
@@ -64,6 +65,11 @@
       "import": "./dist/palettes/pantone.js",
       "default": "./dist/palettes/pantone.js"
     },
+    "./crayola": {
+      "types": "./dist/palettes/crayola.d.ts",
+      "import": "./dist/palettes/crayola.js",
+      "default": "./dist/palettes/crayola.js"
+    },
     "./conversions/hex": {
       "types": "./dist/conversions/hex.d.ts",
       "import": "./dist/conversions/hex.js",
@@ -120,16 +126,19 @@
     "lint:fix": "biome check --write",
     "format": "biome format --write .",
     "test": "bun test",
+    "check:package": "publint && attw --pack --profile esm-only",
+    "check:knip": "knip",
     "demo": "bun run build && cd demo && bun run dev",
-    "prepublishOnly": "bun run build"
+    "prepublishOnly": "bun run build && bun run check:package"
   },
   "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.2",
     "@biomejs/biome": "^2.2.0",
-    "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/git": "^10.0.1",
     "@semantic-release/npm": "^13.1.5",
     "@types/bun": "^1.3.12",
     "@typescript/native-preview": "7.0.0-dev.20260417.1",
+    "knip": "^6.5.0",
+    "publint": "^0.3.18",
     "semantic-release": "^25.0.3"
   },
   "publishConfig": {

package/dist/conversions/index.d.ts

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC","sourcesContent":["export { hexToRgba, rgbaToHex } from './hex.js';\nexport { hslToRgba, rgbaToHsl } from './hsl.js';\nexport { hsvToRgba, rgbaToHsv } from './hsv.js';\nexport { pantoneToRgba, rgbaToPantone } from './pantone.js';\nexport { rgbaToRgb, rgbToRgba } from './rgb.js';\n"]}

package/dist/conversions/index.js

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

package/dist/conversions/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/conversions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC","sourcesContent":["export { hexToRgba, rgbaToHex } from './hex.js';\nexport { hslToRgba, rgbaToHsl } from './hsl.js';\nexport { hsvToRgba, rgbaToHsv } from './hsv.js';\nexport { pantoneToRgba, rgbaToPantone } from './pantone.js';\nexport { rgbaToRgb, rgbToRgba } from './rgb.js';\n"]}

package/dist/palettes/index.d.ts

@@ -1,4 +0,0 @@
-export { type PantoneColorName, pantone } from './pantone.js';
-export { type WebColorName, web } from './web.js';
-export { type X11ColorName, x11 } from './x11.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/palettes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,KAAK,YAAY,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,KAAK,YAAY,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC","sourcesContent":["export { type PantoneColorName, pantone } from './pantone.js';\nexport { type WebColorName, web } from './web.js';\nexport { type X11ColorName, x11 } from './x11.js';\n"]}

package/dist/palettes/index.js

@@ -1,4 +0,0 @@
-export { pantone } from './pantone.js';
-export { web } from './web.js';
-export { x11 } from './x11.js';
-//# sourceMappingURL=index.js.map

package/dist/palettes/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/palettes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,OAAO,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAqB,GAAG,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAqB,GAAG,EAAE,MAAM,UAAU,CAAC","sourcesContent":["export { type PantoneColorName, pantone } from './pantone.js';\nexport { type WebColorName, web } from './web.js';\nexport { type X11ColorName, x11 } from './x11.js';\n"]}