color-name-list 12.2.0 → 13.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "color-name-list",
-  "version": "12.2.0",
+  "version": "13.0.0",
   "description": "long list of color names",
   "main": "dist/colornames.json",
   "browser": "dist/colornames.umd.js",

package/scripts/build.js

@@ -1,22 +1,8 @@
 import fs from 'fs';
 import path from 'path';
-import { parseCSVString, findDuplicates, objArrToString } from './lib.js';
+import { parseCSVString, objArrToString } from './lib.js';
 import { exec } from 'child_process';
 
-const args = process.argv;
-// treat --testonly / --testOnly the same
-const isTestRun = args.some((arg) => arg.toLowerCase() === '--testonly');
-
-// only hex colors with 6 values
-const hexColorValidation = /^#[0-9a-f]{6}$/;
-const errors = [];
-
-// spaces regex
-const spacesValidation = /^\s+|\s{2,}|\s$/;
-
-// quote regex
-const quoteValidation = /"|'|`/;
-
 // setting
 const __dirname = path.dirname(new URL(import.meta.url).pathname);
 const baseFolder = __dirname + '/../';
@@ -29,7 +15,6 @@ const readmeFileName = 'README.md';
 const fileNameShortPostfix = '.short';
 const maxShortNameLength = 12;
 
-const sortBy = 'name';
 const csvKeys = ['name', 'hex'];
 const bestOfKey = 'good name';
 
@@ -40,63 +25,6 @@ const src = fs
 
 const colorsSrc = parseCSVString(src);
 
-// sort by sorting criteria
-colorsSrc.entries.sort((a, b) => {
-  return a[sortBy].localeCompare(b[sortBy]);
-});
-
-csvKeys.forEach((key) => {
-  // find duplicates
-  const dupes = findDuplicates(colorsSrc.values[key]);
-  dupes.forEach((dupe) => {
-    log(key, dupe, `found a double ${key}`);
-  });
-});
-
-// loop hex values for validations
-colorsSrc.values['hex'].forEach((hex) => {
-  // validate HEX values
-  if (!hexColorValidation.test(hex)) {
-    log(
-      'hex',
-      hex,
-      `${hex} is not a valid hex value. (Or to short, we avoid using the hex shorthands, no capital letters)`
-    );
-  }
-});
-
-// loop names
-colorsSrc.values['name'].forEach((name) => {
-  // check for spaces
-  if (spacesValidation.test(name)) {
-    log('name', name, `${name} found either a leading or trailing space (or both)`);
-  }
-  if (quoteValidation.test(name)) {
-    log('name', name, `${name} found a quote character, should be an apostrophe ’`);
-  }
-});
-
-// loop good name markers
-colorsSrc.values[bestOfKey].forEach((str) => {
-  // check for spaces
-  if (spacesValidation.test(str)) {
-    // Use the actual CSV key so we can resolve the offending entries (names)
-    log(bestOfKey, str, `${str} found either a leading or trailing space (or both)`);
-  }
-
-  if (!(str == 'x' || str == '')) {
-    // Use the actual CSV key so we can resolve the offending entries (names)
-    log(bestOfKey, str, `${str} must be a lowercase "x" character or empty`);
-  }
-});
-
-showLog();
-// In test mode we still perform the build so tests can import dist artifacts,
-// but we avoid mutating repository files like README.md or generating the SVG.
-if (isTestRun) {
-  console.log('Test mode: skipping README & SVG generation.');
-}
-
 // creates JS related files
 const JSONExportString = JSON.stringify(
   [...colorsSrc.entries].map(
@@ -339,91 +267,37 @@ for (const outputFormat in outputFormats) {
   }
 }
 
-if (!isTestRun) {
-  // updates the color count in readme file
-  const readme = fs
-    .readFileSync(path.normalize(`${baseFolder}${readmeFileName}`), 'utf8')
-    .toString();
-  fs.writeFileSync(
-    path.normalize(`${baseFolder}${readmeFileName}`),
-    readme
-      .replace(
-        // update color count in text
-        /__\d+__/g,
-        `__${colorsSrc.entries.length}__`
-      )
-      .replace(
-        // update color count in badge
-        /\d+-colors-orange/,
-        `${colorsSrc.entries.length}-colors-orange`
-      )
-      .replace(
-        // update color count in percentage
-        /__\d+(\.\d+)?%__/,
-        `__${((colorsSrc.entries.length / (256 * 256 * 256)) * 100).toFixed(2)}%__`
-      )
-      .replace(
-        // update file size
-        /\d+(\.\d+)? MB\)__/, // no global to only hit first occurrence
-        `${(
-          fs.statSync(path.normalize(`${baseFolder}${folderDist}${fileNameSrc}.json`)).size /
-          1024 /
-          1024
-        ).toFixed(2)} MB)__`
-      ),
-    'utf8'
-  );
-}
-
-/**
- * outputs the collected logs
- */
-function showLog() {
-  let errorLevel = 0;
-  let totalErrors = 0;
-  errors.forEach((error, i) => {
-    totalErrors = i + 1;
-    errorLevel = error.errorLevel || errorLevel;
-    console.log(`${error.errorLevel ? '⛔' : '⚠'}  ${error.message}`);
-    if (Array.isArray(error.entries) && error.entries.length) {
-      // Print a concise list of offending names for quick scanning
-      const nameList = error.entries
-        .map((e) => (e && e.name ? `${e.name}${e.hex ? ` (${e.hex})` : ''}` : ''))
-        .filter(Boolean)
-        .join(', ');
-      if (nameList) {
-        console.log(`Offending name(s): ${nameList}`);
-      }
-    }
-    // Keep the JSON dump for full context
-    console.log(JSON.stringify(error.entries));
-    console.log('*-------------------------*');
-  });
-  if (errorLevel) {
-    throw new Error(`⚠ failed because of the ${totalErrors} error${totalErrors > 1 ? 's' : ''} above ⚠`);
-  }
-  return totalErrors;
-}
-
-/**
- * logs errors and warning
- * @param   {string} key        key to look for in input
- * @param   {string} value      value to look for
- * @param   {string} message    error message
- * @param   {Number} errorLevel if any error is set to 1, the program will exit
- */
-function log(key, value, message, errorLevel = 1) {
-  const error = {};
-  // looks for the original item that caused the error
-  error.entries = colorsSrc.entries.filter((entry) => {
-    return entry[key] === value;
-  });
-
-  error.message = message;
-  error.errorLevel = errorLevel;
-
-  errors.push(error);
-}
+// updates the color count in readme file
+const readme = fs.readFileSync(path.normalize(`${baseFolder}${readmeFileName}`), 'utf8').toString();
+fs.writeFileSync(
+  path.normalize(`${baseFolder}${readmeFileName}`),
+  readme
+    .replace(
+      // update color count in text
+      /__\d+__/g,
+      `__${colorsSrc.entries.length}__`
+    )
+    .replace(
+      // update color count in badge
+      /\d+-colors-orange/,
+      `${colorsSrc.entries.length}-colors-orange`
+    )
+    .replace(
+      // update color count in percentage
+      /__\d+(\.\d+)?%__/,
+      `__${((colorsSrc.entries.length / (256 * 256 * 256)) * 100).toFixed(2)}%__`
+    )
+    .replace(
+      // update file size
+      /\d+(\.\d+)? MB\)__/, // no global to only hit first occurrence
+      `${(
+        fs.statSync(path.normalize(`${baseFolder}${folderDist}${fileNameSrc}.json`)).size /
+        1024 /
+        1024
+      ).toFixed(2)} MB)__`
+    ),
+  'utf8'
+);
 
 // gets SVG template
 const svgTpl = fs.readFileSync(path.normalize(__dirname + '/changes.svg.tpl'), 'utf8').toString();
@@ -497,6 +371,4 @@ function diffSVG() {
   );
 }
 
-if (!isTestRun) {
-  diffSVG();
-}
+diffSVG();

package/scripts/lib.js

@@ -131,19 +131,50 @@ export const normalizeNameForDuplicates = (name) => {
  * @returns {Array<{norm:string, entries:Array<{name:string, lineNumber?:number}>}>}
  */
 export const findNearDuplicateNameConflicts = (items, options = {}) => {
-  const { allowlist = [], foldPlurals = false, pluralAllowlist = [] } = options;
-
-  // Normalize allowlist entries so callers can provide raw names or already-normalized keys.
+  const {
+    allowlist = [],
+    foldPlurals = false,
+    pluralAllowlist = [],
+    foldStopwords = false,
+    stopwords = [],
+  } = options;
+
+  // Precompute stopword set (normalized to lowercase ASCII) when folding is enabled
+  const stopSet = foldStopwords
+    ? new Set(
+        (Array.isArray(stopwords) ? stopwords : [])
+          .filter((w) => typeof w === 'string' && w.trim().length)
+          .map((w) =>
+            String(w)
+              .toLowerCase()
+              .normalize('NFD')
+              .replace(/[\u0300-\u036f]/g, '')
+          )
+      )
+    : null;
+
+  // Helper: normalize name using current options (stopword folding if enabled)
+  const normalizeForOptions = (name) => {
+    const base = String(name)
+      .toLowerCase()
+      .normalize('NFD')
+      .replace(/[\u0300-\u036f]/g, '');
+    const tokens = base.match(/[a-z0-9]+/g) || [];
+    const filtered = foldStopwords && stopSet && stopSet.size ? tokens.filter((t) => !stopSet.has(t)) : tokens;
+    return filtered.length ? filtered.join('') : normalizeNameForDuplicates(name);
+  };
+
+  // Normalize allowlist entries using the same normalization function.
   const allowSet = new Set(
     (Array.isArray(allowlist) ? allowlist : [])
       .filter((v) => typeof v === 'string' && v.trim().length)
-      .map((v) => normalizeNameForDuplicates(String(v)))
+      .map((v) => normalizeForOptions(String(v)))
   );
 
   const byNorm = new Map();
   for (const item of items) {
     if (!item || typeof item.name !== 'string') continue;
-    const norm = normalizeNameForDuplicates(item.name);
+    const norm = normalizeForOptions(item.name);
     if (!byNorm.has(norm)) byNorm.set(norm, []);
     byNorm.get(norm).push({ name: item.name, lineNumber: item.lineNumber });
   }
@@ -153,7 +184,8 @@ export const findNearDuplicateNameConflicts = (items, options = {}) => {
     const pluralAllowSet = new Set(
       (Array.isArray(pluralAllowlist) ? pluralAllowlist : [])
         .filter((v) => typeof v === 'string' && v.trim().length)
-        .map((v) => normalizeNameForDuplicates(String(v)))
+        // Use the same normalization as used for keys (respects stopword folding)
+        .map((v) => normalizeForOptions(String(v)))
     );
     // We iterate over a snapshot of keys because we'll mutate the map.
     for (const key of Array.from(byNorm.keys())) {

package/scripts/sortSrc.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
 /**
-* Script to sort the colornames.csv file alphabetically by name
-* This helps maintain order when new colors are added to the list
-*/
+ * Script to sort the colornames.csv file alphabetically by name
+ * This helps maintain order when new colors are added to the list
+ */
 
 import fs from 'fs';
 import path from 'path';
@@ -28,7 +28,7 @@ const readAndSortCSV = () => {
     while (lines.length && !lines[lines.length - 1].trim()) lines.pop();
 
     // Trim trailing whitespace on each line
-    lines = lines.map(l => l.replace(/\s+$/,''));
+    lines = lines.map((l) => l.replace(/\s+$/, ''));
 
     // The header should be kept as the first line
     const header = lines[0];
@@ -52,7 +52,6 @@ const readAndSortCSV = () => {
 
     console.log(`✅ Successfully sorted ${sortedColorLines.length} colors alphabetically by name`);
     console.log(`📝 File saved: ${csvPath}`);
-
   } catch (error) {
     console.error('❌ Error sorting the CSV file:', error);
     process.exit(1);

package/src/colornames.csv

@@ -200,7 +200,6 @@ After Dinner Mint,#e3f5e5,
 After Eight,#3d2e24,
 After Eight Filling,#d6eae8,
 After Midnight,#38393f,x
-After Rain,#c1dbea,
 After Shock,#fec65f,
 After the Rain,#8bc4d1,
 After the Storm,#33616a,x
@@ -930,7 +929,6 @@ Apple Crisp,#e19c55,
 Apple Crunch,#fee5c9,
 Apple Cucumber,#dbdbbc,
 Apple Custard,#fddfae,
-Apple Day,#7e976d,
 Apple Flower,#edf4eb,
 Apple Fritter,#cc9350,
 Apple Green,#76cd26,
@@ -957,7 +955,7 @@ Apple Slice,#f1f0bf,
 Apple Turnover,#e8c194,
 Apple Valley,#ea8386,
 Apple Wine,#b59f62,
-Apple-A-Day,#903f45,
+Apple-a-Day,#903f45,
 Applegate,#8ac479,
 Applegate Park,#aead93,
 Applemint,#cdeacd,
@@ -1402,7 +1400,7 @@ Asurmen Blue Wash,#273e51,
 Aswad Black,#17181c,
 At Ease,#e7eee1,
 At Ease Soldier,#9e9985,
-At The Beach,#e7d9b9,
+At the Beach,#e7d9b9,
 Atelier,#a3abb8,
 Ateneo Blue,#003a6c,
 Athena,#dcd7cc,
@@ -2096,7 +2094,6 @@ Baywater Blue,#c9d8e4,
 Bazaar,#8f7777,
 Bazooka Pink,#ffa6c9,
 BBQ,#a35046,
-Be Daring,#ffc943,
 Be Mine,#f4e3e7,
 Be My Valentine,#ec9dc3,
 Be Spontaneous,#a5cb66,
@@ -2933,7 +2930,7 @@ Blue Brocade,#70b8d0,
 Blue Bubble,#a6d7eb,
 Blue Burst,#309cd0,x
 Blue Buzz,#a1a2bd,
-Blue By You,#a0b7ba,
+Blue by You,#a0b7ba,
 Blue Calico,#a5cde1,
 Blue Calypso,#55a7b6,
 Blue Cardinal Flower,#2f36ba,
@@ -3199,7 +3196,7 @@ Blue Team Spirit,#5885a2,
 Blue Thistle,#adc0d6,
 Blue Tint,#9fd9d7,
 Blue Titmouse,#4466ff,
-Blue To You,#babfc5,
+Blue to You,#babfc5,
 Blue Tone Ink,#2b4057,
 Blue Topaz,#65aece,
 Blue Torus,#042993,
@@ -3777,7 +3774,7 @@ Broad Bean,#94975d,
 Broad Daylight,#bbddff,x
 Broadleaf Forest,#014421,
 Broadwater Blue,#034a71,
-Broadway,#434442,
+Broadway,#145775,
 Broadway Lights,#fee07c,
 Brocade,#8c87c5,
 Brocade Violet,#7b4d6b,
@@ -3823,7 +3820,6 @@ Broomstick,#74462d,
 Brother Blue,#b0b7c6,
 Brown,#653700,x
 Brown Alpaca,#b86d29,x
-Brown Bag,#deac6e,
 Brown Bear,#4a3f37,
 Brown Beauty,#4a3832,
 Brown Beige,#cc8833,
@@ -3872,7 +3868,7 @@ Brown Tumbleweed,#37290e,
 Brown Velvet,#704e40,
 Brown Wood,#b4674d,
 Brown Yellow,#dd9966,
-Brown-Bag-It,#ddbda3,
+Brown-Bag It,#ddbda3,
 Brown-Noser,#79512c,
 Browned Off,#bb4433,
 Brownie,#964b00,x
@@ -4195,8 +4191,7 @@ Buzz-In,#ffd756,
 Buzzard,#5f563f,
 Buzzards Bay,#017a79,
 By Gum,#816a38,
-By the Bayou,#007b90,
-By The Sea,#8d999e,
+By the Sea,#8d999e,
 Byakuroku Green,#a5ba93,
 Bygone,#918e8a,
 Bypass,#b6c4d2,
@@ -5832,10 +5827,8 @@ Cloud Abyss,#dfe7eb,
 Cloud Blue,#a2b6b9,
 Cloud Break,#f6f1fe,x
 Cloud Cover,#adb5bc,
-Cloud Cream,#ded1b3,
 Cloud Dancer,#f0eee9,x
 Cloud Grey,#b8a9af,
-Cloud Nine,#e9e0db,
 Cloud Number Nine,#f9cec6,
 Cloud of Cream,#f1e2c4,x
 Cloud Over London,#c2bcb1,
@@ -6942,7 +6935,6 @@ Curaçao Blue,#008894,
 Curated Lilac,#a6a6b6,
 Curated White,#eae1ce,
 Curd,#f8e1ba,
-Curds & Whey,#b59c76,
 Curds and Whey,#bca483,
 Cure All,#aa6988,
 Cured Eggplant,#380835,
@@ -6974,8 +6966,7 @@ Custard Powder,#f8dcaa,
 Custard Puff,#fceeae,
 Customs Green,#003839,
 Cut Heather,#9e909e,
-Cut of Mustard,#bc914d,
-Cut the Mustard,#ba7f38,
+Cut the Mustard,#ba7f38,x
 Cut Velvet,#b391c8,
 Cute Crab,#dd4444,x
 Cute Little Pink,#f4e2e1,
@@ -7747,7 +7738,7 @@ Devil Blue,#277594,
 Devil’s Advocate,#ff3344,x
 Devil’s Butterfly,#bb4422,
 Devil’s Flower Mantis,#8f9805,
-Devil’s Grass,#44aa55,
+Devil’s Grass,#44aa55,x
 Devil’s Lip,#662a2c,
 Devil’s Plum,#423450,
 Deviled Eggs,#fecd82,x
@@ -8036,7 +8027,6 @@ Downing Sand,#cbbca5,
 Downing Slate,#777f86,
 Downing Stone,#a6a397,
 Downing Straw,#caab7d,
-Downing to Earth,#635a4f,
 Download Progress,#58d332,
 Downpour,#43718b,
 Downriver,#092256,
@@ -12737,7 +12727,6 @@ Honey Bunny,#dbb881,x
 Honey Butter,#f5d29b,
 Honey Carrot Cake,#ff9955,
 Honey Chili,#883344,
-Honey Cream,#fae8ca,
 Honey Crisp,#e9c160,x
 Honey Crusted Chicken,#ffbb55,
 Honey Do,#ededc7,x
@@ -13161,8 +13150,6 @@ Ilvaite Black,#330011,
 Imagery,#7a6e70,
 Imaginary Mauve,#89687d,
 Imagination,#dfe0ee,
-Imagine,#af9468,
-Imagine That,#947c98,
 Imam Ali Gold,#fae199,
 Imayou Pink,#d0576b,
 Immaculate Iguana,#aacc00,
@@ -13202,7 +13189,7 @@ Impulse Blue,#006699,
 Impulsive Purple,#624977,
 Impure White,#f5e7e3,
 Imrik Blue,#67aed0,
-In A Pickle,#978c59,x
+In a Pickle,#978c59,x
 In Caffeine We Trust,#693c2a,
 In for a Penny,#ee8877,x
 In Good Taste,#b6d4a0,x
@@ -15889,7 +15876,6 @@ Mahogany Spice,#5b4646,
 Mahonia Berry Blue,#62788e,
 Mai Tai,#a56531,x
 Maiden Hair,#f5e9ca,
-Maiden Mist,#b9c0c0,
 Maiden of the Mist,#efdceb,
 Maiden Pink,#ff2feb,
 Maiden Voyage,#8ac7d4,
@@ -17008,7 +16994,6 @@ Mission Wildflower,#9e5566,
 Mississippi Mud,#99886f,
 Mississippi River,#3b638c,x
 Missouri Mud,#a6a19b,
-Mist Green,#aacebc,
 Mist Grey,#c4c4bc,
 Mist of Green,#e3f1eb,
 Mist Spirit,#e4ebe7,
@@ -17526,7 +17511,6 @@ Mousy Indigo,#5c544e,
 Moutarde de Bénichon,#bf9005,x
 Move Mint,#4effcd,
 Mover & Shaker,#9cce9e,
-Mover and Shaker,#855d44,
 Movie Magic,#b2bfd5,
 Movie Star,#c52033,
 Mow the Lawn,#a9b49a,
@@ -18656,7 +18640,6 @@ Olive Grey,#afa78d,
 Olive Grove,#716a4d,
 Olive Haze,#888064,
 Olive Hint,#c9bd88,
-Olive It,#aeab9a,
 Olive Leaf,#4e4b35,x
 Olive Leaf Tea,#78866b,
 Olive Martini,#ced2ab,
@@ -18970,7 +18953,6 @@ OU Crimson Red,#990000,
 Oubliette,#4f4944,
 Ouni Red,#ee7948,
 Our Little Secret,#a84b7a,x
-Out of Blue,#c0f7db,
 Out of Fashion,#f26d8f,
 Out of Plumb,#9c909c,
 Out of the Blue,#1199ee,x
@@ -19732,7 +19714,6 @@ Pearl Yellow,#f1e3bc,
 Pearled Couscous,#f2e9d5,
 Pearled Ivory,#f0dfcc,
 Pearls & Lace,#dcd0cb,
-Pearls and Lace,#eee7dc,
 Pearly,#f4e3df,x
 Pearly Pink,#ee99cc,x
 Pearly Purple,#b768a2,
@@ -21099,7 +21080,6 @@ Pretty Pale,#e3c6d6,
 Pretty Parasol,#ac5d3e,
 Pretty Pastry,#dfcdb2,x
 Pretty Petunia,#d6b7e2,
-Pretty Pink,#ebb3b2,
 Pretty Pink Piggy,#eeaadd,
 Pretty Please,#ffccc8,
 Pretty Posie,#bcbde4,
@@ -22057,6 +22037,7 @@ Red Salsa,#fd3a4a,
 Red Sandstorm,#e5cac0,
 Red Sauce Parlor,#cc3b22,
 Red Savina Pepper,#ee0128,
+Red Seal,#c92d21,x
 Red Sentinel,#b9090f,
 Red Shade Wash,#862808,
 Red Shimmer,#fee0da,
@@ -24494,7 +24475,6 @@ Sinatra,#4675b7,
 Sinbad,#a6d5d0,
 Sinful,#645059,
 Singapore Orchid,#a020f0,
-Singing Blue,#0074a4,
 Singing in the Rain,#8e9c98,
 Singing the Blues,#2b4d68,
 Single Origin,#713e39,x
@@ -25112,6 +25092,7 @@ Sour Lemon,#ffeea5,x
 Sour Lime,#acc326,x
 Sour Patch Peach,#f4d9c5,
 Sour Tarts,#fee5c8,
+Sour Veil,#ffffbf,x
 Sour Yellow,#eeff04,x
 Source Blue,#cdeae5,
 Source Green,#84b6a2,
@@ -26392,12 +26373,11 @@ Swedish Blue,#007cc0,
 Swedish Clover,#7b8867,
 Swedish Green,#184d43,
 Swedish Yellow,#fce081,
-Sweet & Sour,#c9aa37,
+Sweet & Sour,#c4bf0b,
 Sweet 60,#f29eab,
 Sweet Almond,#cc9977,
 Sweet Alyssum,#e7c2de,
 Sweet and Sassy,#e1c9d1,x
-Sweet and Sour,#c4bf0b,
 Sweet Angel,#f5c8bb,
 Sweet Angelica,#e8d08e,
 Sweet Annie,#9c946e,
@@ -26439,7 +26419,6 @@ Sweet Georgia Brown,#8b715a,
 Sweet Grape,#4d3d52,
 Sweet Grass,#b2b68a,
 Sweet Harbor,#d9dde7,
-Sweet Honey,#d4a55c,
 Sweet Illusion,#e0e8ec,
 Sweet Jasmine,#f9f4d4,
 Sweet Juliet,#b8bfd2,
@@ -27003,13 +26982,10 @@ Thatched Cottage,#d6c7a6,
 Thatched Roof,#efe0c6,
 Thawed Out,#e1eeec,
 The Art of Seduction,#dd0088,
-The Blarney Stone,#ab9f89,
 The Bluff,#ffc8c2,
 The Boulevard,#d0a492,
-The Broadway,#145775,
 The Cottage,#837663,
 The Count’s Black,#102030,x
-The Devil’s Grass,#666420,x
 The Ego Has Landed,#a75455,
 The End,#2a2a2a,x
 The End Is Beer,#eed508,
@@ -27024,7 +27000,6 @@ The Killing Joke,#b0bf1a,
 The Legend of Green,#558844,x
 The New Black,#ff8400,
 The Rainbow Fish,#4466ee,
-The Real Teal,#007883,
 The Sickener,#db7093,
 The Speed of Light,#f6f4ef,
 The Vast of Night,#110066,x
@@ -29157,7 +29132,6 @@ Whisper of Smoke,#cbcecf,x
 Whisper of White,#eadbca,x
 Whisper Pink,#d4c5b4,
 Whisper Ridge,#c9c3b5,
-Whisper White,#eae2d3,x
 Whisper Yellow,#ffe5b9,
 Whispered Secret,#3f4855,
 Whispering Blue,#c9dcdc,
@@ -29872,7 +29846,6 @@ Yearning,#061088,
 Yearning Desire,#ca135e,x
 Yeast,#fae1ac,
 Yell for Yellow,#fffe00,x
-Yell Yellow,#ffffbf,x
 Yellow,#ffff00,x
 Yellow Acorn,#b68d4c,
 Yellow Avarice,#f5f5d9,

package/tests/_utils/report.js

@@ -0,0 +1,76 @@
+// Small utility to build consistent, helpful failure messages in tests.
+// Keeps output informative while avoiding repeated boilerplate in each test file.
+
+/**
+ * Simple pluralization helper
+ * @param {number} n
+ * @param {string} singular
+ * @param {string} [plural]
+ * @returns {string}
+ */
+export function pluralize(n, singular, plural = `${singular}s`) {
+  return n === 1 ? singular : plural;
+}
+
+/**
+ * Join values as a readable, comma-separated list.
+ * Ensures uniqueness and stable order.
+ * @param {Array<string|number>} items
+ * @returns {string}
+ */
+export function list(items) {
+  if (!items || !items.length) return '';
+  const uniq = [...new Set(items.map(String))];
+  return uniq.join(', ');
+}
+
+/**
+ * Build a consistent failure message for test assertions.
+ *
+ * @param {Object} opts
+ * @param {string} opts.title - Heading/title of the error (without counts)
+ * @param {Array<string>} [opts.offenders] - Values to summarize in a one-line list.
+ * @param {string} [opts.offenderLabel] - Label for offenders list (e.g. "name", "hex code").
+ * @param {Array<string>} [opts.details] - Additional bullet/section lines to include.
+ * @param {Array<string>} [opts.tips] - How-to-fix tips appended at the end.
+ * @param {number} [opts.count] - Optional explicit count (defaults to offenders.length).
+ * @param {string} [opts.icon] - Optional icon/emphasis prefix, default ⛔.
+ * @returns {string}
+ */
+export function buildFailureMessage({
+  title,
+  offenders = [],
+  offenderLabel = 'item',
+  details = [],
+  tips = [],
+  count,
+  icon = '⛔',
+} = {}) {
+  const msgLines = [];
+  const n = typeof count === 'number' ? count : offenders.length;
+
+  msgLines.push(
+    `${icon} ${title.replace('{n}', String(n)).replace('{items}', pluralize(n, offenderLabel))}`
+  );
+  msgLines.push('');
+
+  if (offenders.length) {
+    msgLines.push(`Offending ${pluralize(offenders.length, offenderLabel)}: ${list(offenders)}`);
+    msgLines.push('*-------------------------*');
+    msgLines.push('');
+  }
+
+  if (details.length) {
+    for (const line of details) msgLines.push(line);
+    msgLines.push('');
+  }
+
+  if (tips.length) {
+    msgLines.push('Tip:');
+    for (const t of tips) msgLines.push(`  - ${t}`);
+    msgLines.push('');
+  }
+
+  msgLines.push('*-------------------------*');
+  return msgLines.join('\n');
+}