@sardine/colour 2.3.0 → 3.0.0

package/dist/index.mjs

@@ -1,177 +1,3 @@
-function hue_d(x, y) {
-  if (x === 0 && y === 0) {
-    return 0;
-  }
-  const angle = Math.atan2(x, y) * (180 / Math.PI);
-  if (angle >= 0) {
-    return angle;
-  }
-  return angle + 360;
-}
-function deltaHue_d({ C1, C2, h1_d, h2_d }) {
-  if (C1 * C2 === 0) {
-    return 0;
-  }
-  const delta = h2_d - h1_d;
-  if (Math.abs(delta) <= 180) {
-    return delta;
-  }
-  if (delta > 180) {
-    return delta - 360;
-  }
-  return delta + 360;
-}
-function meanHue_d({ C1, C2, h1_d, h2_d }) {
-  if (C1 * C2 === 0) {
-    return h2_d + h1_d;
-  }
-  const delta = Math.abs(h1_d - h2_d);
-  if (delta <= 180) {
-    return (h2_d + h1_d) / 2;
-  }
-  if (delta > 180 && h1_d + h2_d < 360) {
-    return (h2_d + h1_d + 360) / 2;
-  }
-  return (h2_d + h1_d - 360) / 2;
-}
-const toRadians = (n) => n * (Math.PI / 180);
-const bigSquare = (n) => Math.sqrt(n ** 7 / (n ** 7 + 25 ** 7));
-function linearRGB(rgbValue, WCAG21) {
-  const rgbRatio = rgbValue / 255;
-  const threshold = WCAG21 ? 0.03928 : 0.04045;
-  let linearValue;
-  if (rgbRatio > threshold) {
-    linearValue = ((rgbRatio + 0.055) / 1.055) ** 2.4;
-  } else {
-    linearValue = rgbRatio / 12.92;
-  }
-  return linearValue;
-}
-function constrainLab(n) {
-  const delta = 6 / 29;
-  const deltaCube = delta ** 3;
-  let t;
-  if (n > deltaCube) {
-    t = Math.cbrt(n);
-  } else {
-    t = n / (3 * delta ** 2) + 4 / 29;
-  }
-  return t;
-}
-function clamp(value, min, max) {
-  return Math.min(Math.max(value, min), max);
-}
-function ciede2000(colour1, colour2) {
-  const lightness1 = colour1.L;
-  const greenRed1 = colour1.a;
-  const blueYellow1 = colour1.b;
-  const lightness2 = colour2.L;
-  const greenRed2 = colour2.a;
-  const blueYellow2 = colour2.b;
-  const luminanceWeight = 1;
-  const chromaWeight = 1;
-  const hueWeight = 1;
-  const chroma1 = Math.sqrt(greenRed1 ** 2 + blueYellow1 ** 2);
-  const chroma2 = Math.sqrt(greenRed2 ** 2 + blueYellow2 ** 2);
-  const deltaLightness = lightness2 - lightness1;
-  const meanChroma = (chroma1 + chroma2) / 2;
-  const G = 0.5 * (1 - bigSquare(meanChroma));
-  const greenRed1Prime = greenRed1 * (1 + G);
-  const greenRed2Prime = greenRed2 * (1 + G);
-  const chroma1Prime = Math.sqrt(greenRed1Prime ** 2 + blueYellow1 ** 2);
-  const chroma2Prime = Math.sqrt(greenRed2Prime ** 2 + blueYellow2 ** 2);
-  const meanChromaPrime = (chroma1Prime + chroma2Prime) / 2;
-  const deltaChromaPrime = chroma2Prime - chroma1Prime;
-  const hue1Prime = hue_d(blueYellow1, greenRed1Prime);
-  const hue2Prime = hue_d(blueYellow2, greenRed2Prime);
-  const deltaHuePrime = deltaHue_d({
-    C1: chroma1,
-    C2: chroma2,
-    h1_d: hue1Prime,
-    h2_d: hue2Prime
-  });
-  const deltaHue = 2 * Math.sqrt(chroma1Prime * chroma2Prime) * Math.sin(toRadians(deltaHuePrime) / 2);
-  const meanHuePrime = meanHue_d({
-    C1: chroma1,
-    C2: chroma2,
-    h1_d: hue1Prime,
-    h2_d: hue2Prime
-  });
-  const meanLightness = (lightness1 + lightness2) / 2;
-  const T = 1 - 0.17 * Math.cos(toRadians(meanHuePrime - 30)) + 0.24 * Math.cos(toRadians(2 * meanHuePrime)) + 0.32 * Math.cos(toRadians(3 * meanHuePrime + 6)) - 0.2 * Math.cos(toRadians(4 * meanHuePrime - 63));
-  const SL = 1 + 0.015 * (meanLightness - 50) ** 2 / Math.sqrt(20 + (meanLightness - 50) ** 2);
-  const SC = 0.045 * meanChromaPrime + 1;
-  const SH = 1 + 0.015 * meanChromaPrime * T;
-  const rotation = 30 * Math.exp(-(((meanHuePrime - 275) / 25) ** 2));
-  const RT = -2 * bigSquare(meanChromaPrime) * Math.sin(toRadians(rotation * 2));
-  const deltaE = Math.sqrt(
-    (deltaLightness / (luminanceWeight * SL)) ** 2 + (deltaChromaPrime / (chromaWeight * SC)) ** 2 + (deltaHue / (hueWeight * SH)) ** 2 + RT * (deltaChromaPrime / (chromaWeight * SC)) * (deltaHue / (hueWeight * SH))
-  );
-  return deltaE;
-}
-function convertRGBtoXYZ(colour) {
-  const { R, G, B } = colour;
-  const _R = linearRGB(R) * 100;
-  const _G = linearRGB(G) * 100;
-  const _B = linearRGB(B) * 100;
-  const X = _R * 0.4124 + _G * 0.3576 + _B * 0.1805;
-  const Y = _R * 0.2126 + _G * 0.7152 + _B * 0.0722;
-  const Z = _R * 0.0193 + _G * 0.1192 + _B * 0.9505;
-  return { X, Y, Z };
-}
-function convertXYZtoLab(colour) {
-  const { X, Y, Z } = colour;
-  const _X = X / 95.047;
-  const _Y = Y / 100;
-  const _Z = Z / 108.883;
-  const fX = constrainLab(_X);
-  const fY = constrainLab(_Y);
-  const fZ = constrainLab(_Z);
-  const L = 116 * fY - 16;
-  const a = 500 * (fX - fY);
-  const b = 200 * (fY - fZ);
-  return { L, a, b };
-}
-function convertRGBtoLab(colour) {
-  const XYZColour = convertRGBtoXYZ(colour);
-  return convertXYZtoLab(XYZColour);
-}
-const RGBdistance = (colour1, colour2) => {
-  const c1 = convertRGBtoLab(colour1);
-  const c2 = convertRGBtoLab(colour2);
-  return ciede2000(c1, c2);
-};
-const hexRegex = /^#[a-fA-F0-9]{6}$/;
-const hexAlphaRegex = /^#[a-fA-F0-9]{8}$/;
-const shortHexRegex = /^#[a-fA-F0-9]{3}$/;
-const shortAlphaHexRegex = /^#[a-fA-F0-9]{4}$/;
-const cssRGBARegex = /^rgba*\(\s*([-+]?\d+)\s*(?:,)?\s*([-+]?\d+)\s*(?:,)?\s*([-+]?\d+)\s*(?:,*|\/*)\s*([-+]?\d*[.]?\d+[%]?)*\)$/i;
-function convertCSSRGBtoRGB(colour) {
-  const match = colour.match(cssRGBARegex);
-  if (!match) {
-    throw new Error(
-      `convertCSSRGBtoHex expects a valid CSS RGB string but got ${colour}`
-    );
-  }
-  const rgbNumber = (n) => n ? Number.parseFloat(n) : void 0;
-  return {
-    R: rgbNumber(match[1]),
-    G: rgbNumber(match[2]),
-    B: rgbNumber(match[3]),
-    A: rgbNumber(match[4])
-  };
-}
-function convertRGBtoHex({ R, G, B, A }) {
-  const hex = (n) => {
-    const value = clamp(n, 0, 255);
-    return value.toString(16).padStart(2, "0");
-  };
-  return `#${hex(R)}${hex(G)}${hex(B)}${A ? hex(Math.round(A * 255)) : ""}`;
-}
-function convertCSSRGBtoHex(colour) {
-  const rgb = convertCSSRGBtoRGB(colour);
-  return convertRGBtoHex(rgb);
-}
 const namedCSSColours = /* @__PURE__ */ new Map([
   ["aliceblue", "#f0f8ff"],
   ["antiquewhite", "#faebd7"],
@@ -278,6 +104,7 @@ const namedCSSColours = /* @__PURE__ */ new Map([
   ["oldlace", "#fdf5e6"],
   ["olive", "#808000"],
   ["olivedrab", "#6b8e23"],
+  ["orange", "#ffa500"],
   ["orangered", "#ff4500"],
   ["orchid", "#da70d6"],
   ["palegoldenrod", "#eee8aa"],
@@ -291,6 +118,7 @@ const namedCSSColours = /* @__PURE__ */ new Map([
   ["plum", "#dda0dd"],
   ["powderblue", "#b0e0e6"],
   ["purple", "#800080"],
+  ["rebeccapurple", "#663399"],
   ["red", "#ff0000"],
   ["rosybrown", "#bc8f8f"],
   ["royalblue", "#4169e1"],
@@ -321,51 +149,209 @@ const namedCSSColours = /* @__PURE__ */ new Map([
   ["yellow", "#ffff00"],
   ["yellowgreen", "#9acd32"]
 ]);
-function convertHextoNamedCSSColour(colour) {
-  for (const [name, hex] of namedCSSColours.entries()) {
-    if (hex === colour) {
-      return name;
+const hexAnyRegex = /^#(?:[0-9a-fA-F]{8}|[0-9a-fA-F]{6}|[0-9a-fA-F]{4}|[0-9a-fA-F]{3})$/;
+const cssRGBARegex = /^rgba?\(\s*([-+]?\d*\.?\d+%?)\s*[,\s]\s*([-+]?\d*\.?\d+%?)\s*[,\s]\s*([-+]?\d*\.?\d+%?)\s*(?:[,/]\s*([-+]?\d*\.?\d+%?))?\s*\)$/i;
+function isCSSRGBColour(colour) {
+  return cssRGBARegex.test(colour);
+}
+function isHexColour(colour) {
+  return hexAnyRegex.test(colour);
+}
+function isNamedCSSColour(colour) {
+  return namedCSSColours.has(colour);
+}
+function hue_d(x, y) {
+  if (x === 0 && y === 0) {
+    return 0;
+  }
+  const angle = Math.atan2(x, y) * (180 / Math.PI);
+  if (angle >= 0) {
+    return angle;
+  }
+  return angle + 360;
+}
+function deltaHue_d({ C1, C2, h1_d, h2_d }) {
+  if (C1 * C2 === 0) {
+    return 0;
+  }
+  const delta = h2_d - h1_d;
+  if (Math.abs(delta) <= 180) {
+    return delta;
+  }
+  if (delta > 180) {
+    return delta - 360;
+  }
+  return delta + 360;
+}
+function meanHue_d({ C1, C2, h1_d, h2_d }) {
+  if (C1 * C2 === 0) {
+    return h2_d + h1_d;
+  }
+  const delta = Math.abs(h1_d - h2_d);
+  if (delta <= 180) {
+    return (h2_d + h1_d) / 2;
+  }
+  if (delta > 180 && h1_d + h2_d < 360) {
+    return (h2_d + h1_d + 360) / 2;
+  }
+  return (h2_d + h1_d - 360) / 2;
+}
+const DEG_TO_RAD = Math.PI / 180;
+const toRadians = (n) => n * DEG_TO_RAD;
+const POW_25_7 = 25 ** 7;
+const bigSquare = (n) => Math.sqrt(n ** 7 / (n ** 7 + POW_25_7));
+function linearRGB(rgbValue, WCAG21) {
+  const rgbRatio = rgbValue / 255;
+  const threshold = WCAG21 ? 0.03928 : 0.04045;
+  let linearValue;
+  if (rgbRatio > threshold) {
+    linearValue = ((rgbRatio + 0.055) / 1.055) ** 2.4;
+  } else {
+    linearValue = rgbRatio / 12.92;
+  }
+  return linearValue;
+}
+const LAB_DELTA = 6 / 29;
+const LAB_DELTA_CUBE = LAB_DELTA ** 3;
+const LAB_DELTA_SQ_3 = 3 * LAB_DELTA ** 2;
+function constrainLab(n) {
+  if (n > LAB_DELTA_CUBE) {
+    return Math.cbrt(n);
+  }
+  return n / LAB_DELTA_SQ_3 + 4 / 29;
+}
+function clamp(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+}
+const NAMED_CSS_COLOUR_URL = "https://developer.mozilla.org/en-US/docs/Web/CSS/named-color";
+function ciede2000(colour1, colour2) {
+  const lightness1 = colour1.L;
+  const greenRed1 = colour1.a;
+  const blueYellow1 = colour1.b;
+  const lightness2 = colour2.L;
+  const greenRed2 = colour2.a;
+  const blueYellow2 = colour2.b;
+  const luminanceWeight = 1;
+  const chromaWeight = 1;
+  const hueWeight = 1;
+  const chroma1 = Math.sqrt(greenRed1 ** 2 + blueYellow1 ** 2);
+  const chroma2 = Math.sqrt(greenRed2 ** 2 + blueYellow2 ** 2);
+  const deltaLightness = lightness2 - lightness1;
+  const meanChroma = (chroma1 + chroma2) / 2;
+  const G = 0.5 * (1 - bigSquare(meanChroma));
+  const greenRed1Prime = greenRed1 * (1 + G);
+  const greenRed2Prime = greenRed2 * (1 + G);
+  const chroma1Prime = Math.sqrt(greenRed1Prime ** 2 + blueYellow1 ** 2);
+  const chroma2Prime = Math.sqrt(greenRed2Prime ** 2 + blueYellow2 ** 2);
+  const meanChromaPrime = (chroma1Prime + chroma2Prime) / 2;
+  const deltaChromaPrime = chroma2Prime - chroma1Prime;
+  const hue1Prime = hue_d(blueYellow1, greenRed1Prime);
+  const hue2Prime = hue_d(blueYellow2, greenRed2Prime);
+  const deltaHuePrime = deltaHue_d({
+    C1: chroma1,
+    C2: chroma2,
+    h1_d: hue1Prime,
+    h2_d: hue2Prime
+  });
+  const deltaHue = 2 * Math.sqrt(chroma1Prime * chroma2Prime) * Math.sin(toRadians(deltaHuePrime) / 2);
+  const meanHuePrime = meanHue_d({
+    C1: chroma1,
+    C2: chroma2,
+    h1_d: hue1Prime,
+    h2_d: hue2Prime
+  });
+  const meanLightness = (lightness1 + lightness2) / 2;
+  const T = 1 - 0.17 * Math.cos(toRadians(meanHuePrime - 30)) + 0.24 * Math.cos(toRadians(2 * meanHuePrime)) + 0.32 * Math.cos(toRadians(3 * meanHuePrime + 6)) - 0.2 * Math.cos(toRadians(4 * meanHuePrime - 63));
+  const SL = 1 + 0.015 * (meanLightness - 50) ** 2 / Math.sqrt(20 + (meanLightness - 50) ** 2);
+  const SC = 0.045 * meanChromaPrime + 1;
+  const SH = 1 + 0.015 * meanChromaPrime * T;
+  const rotation = 30 * Math.exp(-(((meanHuePrime - 275) / 25) ** 2));
+  const RT = -2 * bigSquare(meanChromaPrime) * Math.sin(toRadians(rotation * 2));
+  const deltaE = Math.sqrt(
+    (deltaLightness / (luminanceWeight * SL)) ** 2 + (deltaChromaPrime / (chromaWeight * SC)) ** 2 + (deltaHue / (hueWeight * SH)) ** 2 + RT * (deltaChromaPrime / (chromaWeight * SC)) * (deltaHue / (hueWeight * SH))
+  );
+  return deltaE;
+}
+function convertCssValueToNumber(value, isAlpha = false) {
+  if (value.endsWith("%")) {
+    const percentage = Number.parseFloat(value.slice(0, -1));
+    if (isAlpha) {
+      return percentage / 100;
     }
+    return Math.round(percentage / 100 * 255);
   }
-  return void 0;
+  return Number.parseFloat(value);
+}
+function convertCssRgbChannelValue(value) {
+  if (!value) return void 0;
+  return convertCssValueToNumber(value);
+}
+function convertCssAlphaChannelValue(value) {
+  if (!value) return void 0;
+  return convertCssValueToNumber(value, true);
+}
+function convertCSSRGBtoRGB(colour) {
+  const match = colour.match(cssRGBARegex);
+  if (!match) {
+    throw new Error(
+      `convertCSSRGBtoRGB expects a valid CSS RGB string but got ${colour}`
+    );
+  }
+  return {
+    R: convertCssRgbChannelValue(match[1]),
+    G: convertCssRgbChannelValue(match[2]),
+    B: convertCssRgbChannelValue(match[3]),
+    A: convertCssAlphaChannelValue(match[4])
+  };
+}
+function convertRGBtoHex({ R, G, B, A }) {
+  const hex = (n) => {
+    const value = clamp(n, 0, 255);
+    return value.toString(16).padStart(2, "0");
+  };
+  return `#${hex(R)}${hex(G)}${hex(B)}${A ? hex(Math.round(A * 255)) : ""}`;
+}
+function convertCSSRGBtoHex(colour) {
+  const rgb = convertCSSRGBtoRGB(colour);
+  return convertRGBtoHex(rgb);
 }
 function convertHextoRGB(hex) {
   if (typeof hex !== "string") {
     throw new Error(`convertHextoRGB expects a string but got a ${typeof hex}`);
   }
-  if (hex.match(hexRegex)) {
-    return {
-      R: Number.parseInt(`${hex[1]}${hex[2]}`, 16),
-      G: Number.parseInt(`${hex[3]}${hex[4]}`, 16),
-      B: Number.parseInt(`${hex[5]}${hex[6]}`, 16)
-    };
-  }
-  if (hex.match(shortHexRegex)) {
-    return {
-      R: Number.parseInt(`${hex[1]}${hex[1]}`, 16),
-      G: Number.parseInt(`${hex[2]}${hex[2]}`, 16),
-      B: Number.parseInt(`${hex[3]}${hex[3]}`, 16)
-    };
-  }
-  if (hex.match(hexAlphaRegex)) {
-    return {
-      R: Number.parseInt(`${hex[1]}${hex[2]}`, 16),
-      G: Number.parseInt(`${hex[3]}${hex[4]}`, 16),
-      B: Number.parseInt(`${hex[5]}${hex[6]}`, 16),
-      A: Math.round(Number.parseInt(`${hex[7]}${hex[8]}`, 16) / 255 * 100) / 100
-    };
-  }
-  if (hex.match(shortAlphaHexRegex)) {
-    return {
-      R: Number.parseInt(`${hex[1]}${hex[1]}`, 16),
-      G: Number.parseInt(`${hex[2]}${hex[2]}`, 16),
-      B: Number.parseInt(`${hex[3]}${hex[3]}`, 16),
-      A: Math.round(Number.parseInt(`${hex[4]}${hex[4]}`, 16) / 255 * 100) / 100
-    };
+  if (!hexAnyRegex.test(hex)) {
+    throw new Error(
+      `convertHextoRGB expects a valid hexadecimal colour value but got ${hex}`
+    );
+  }
+  switch (hex.length) {
+    case 7:
+      return {
+        R: parseInt(hex.slice(1, 3), 16),
+        G: parseInt(hex.slice(3, 5), 16),
+        B: parseInt(hex.slice(5, 7), 16)
+      };
+    case 4:
+      return {
+        R: parseInt(hex.slice(1, 2).repeat(2), 16),
+        G: parseInt(hex.slice(2, 3).repeat(2), 16),
+        B: parseInt(hex.slice(3, 4).repeat(2), 16)
+      };
+    case 9:
+      return {
+        R: parseInt(hex.slice(1, 3), 16),
+        G: parseInt(hex.slice(3, 5), 16),
+        B: parseInt(hex.slice(5, 7), 16),
+        A: Math.round(parseInt(hex.slice(7, 9), 16) / 255 * 100) / 100
+      };
+    default:
+      return {
+        R: parseInt(hex.slice(1, 2).repeat(2), 16),
+        G: parseInt(hex.slice(2, 3).repeat(2), 16),
+        B: parseInt(hex.slice(3, 4).repeat(2), 16),
+        A: Math.round(parseInt(hex.slice(4, 5).repeat(2), 16) / 255 * 100) / 100
+      };
   }
-  throw new Error(
-    `convertHextoRGB expects an valid hexadecimal colour value but got ${hex}`
-  );
 }
 function convertHextoCSSRGB(hex) {
   const rgb = convertHextoRGB(hex);
@@ -374,6 +360,14 @@ function convertHextoCSSRGB(hex) {
   }
   return `rgb(${rgb.R},${rgb.G},${rgb.B})`;
 }
+function convertHextoNamedCSSColour(colour) {
+  for (const [name, hex] of namedCSSColours.entries()) {
+    if (hex === colour) {
+      return name;
+    }
+  }
+  return void 0;
+}
 function convertNamedCSSColourtoHex(name) {
   return namedCSSColours.get(name);
 }
@@ -387,44 +381,56 @@ function convertNamedCSSColourtoRGB(colour) {
 function convertRGBtoCSSRGB({ R, G, B, A }) {
   return `rgb(${R} ${G} ${B}${A ? ` / ${A}` : ""})`;
 }
+function convertRGBtoXYZ(colour) {
+  const { R, G, B } = colour;
+  const _R = linearRGB(R) * 100;
+  const _G = linearRGB(G) * 100;
+  const _B = linearRGB(B) * 100;
+  const X = _R * 0.4124 + _G * 0.3576 + _B * 0.1805;
+  const Y = _R * 0.2126 + _G * 0.7152 + _B * 0.0722;
+  const Z = _R * 0.0193 + _G * 0.1192 + _B * 0.9505;
+  return { X, Y, Z };
+}
+function convertXYZtoLab(colour) {
+  const { X, Y, Z } = colour;
+  const _X = X / 95.047;
+  const _Y = Y / 100;
+  const _Z = Z / 108.883;
+  const fX = constrainLab(_X);
+  const fY = constrainLab(_Y);
+  const fZ = constrainLab(_Z);
+  const L = 116 * fY - 16;
+  const a = 500 * (fX - fY);
+  const b = 200 * (fY - fZ);
+  return { L, a, b };
+}
+function convertRGBtoLab(colour) {
+  const XYZColour = convertRGBtoXYZ(colour);
+  return convertXYZtoLab(XYZColour);
+}
 function convertRGBtoNamedCSSColour(colour) {
   const hex = convertRGBtoHex(colour);
   return convertHextoNamedCSSColour(hex);
 }
+const RGBdistance = (colour1, colour2) => {
+  const c1 = convertRGBtoLab(colour1);
+  const c2 = convertRGBtoLab(colour2);
+  return ciede2000(c1, c2);
+};
 function findNearestRGBColour(colour, palette) {
   if (!palette || palette.length < 2) {
     return colour;
   }
-  const map = [];
+  let nearest = colour;
+  let minDistance = Number.POSITIVE_INFINITY;
   for (const paletteColour of palette) {
     const distance = RGBdistance(colour, paletteColour);
-    map.push([paletteColour, distance]);
-  }
-  const closest = map.sort((a, b) => a[1] - b[1]);
-  return closest[0][0];
-}
-function findNearestCSSRGBColour(colour, palette) {
-  if (!palette || palette.length < 2) {
-    return colour;
+    if (distance < minDistance) {
+      minDistance = distance;
+      nearest = paletteColour;
+    }
   }
-  const baseRGBColour = convertCSSRGBtoRGB(colour);
-  const paletteRGBColours = palette.map(
-    (hexColour) => convertCSSRGBtoRGB(hexColour)
-  );
-  const nearestRGBColour = findNearestRGBColour(
-    baseRGBColour,
-    paletteRGBColours
-  );
-  return convertRGBtoCSSRGB(nearestRGBColour);
-}
-function isCSSRGBColour(colour) {
-  return !!colour.match(cssRGBARegex);
-}
-function isHexColour(colour) {
-  return !!colour.match(hexRegex) || !!colour.match(hexAlphaRegex) || !!colour.match(shortAlphaHexRegex) || !!colour.match(shortHexRegex);
-}
-function isNamedCSSColour(colour) {
-  return namedCSSColours.has(colour);
+  return nearest;
 }
 function findNearestColour(colour, palette) {
   if (!palette || palette.length < 2) {
@@ -436,12 +442,10 @@ function findNearestColour(colour, palette) {
   if (isHexColour(colour)) {
     baseColour = convertHextoRGB(colour);
     colourType = "hex";
-  }
-  if (isCSSRGBColour(colour)) {
+  } else if (isCSSRGBColour(colour)) {
     baseColour = convertCSSRGBtoRGB(colour);
     colourType = "cssRGB";
-  }
-  if (isNamedCSSColour(colour)) {
+  } else if (isNamedCSSColour(colour)) {
     baseColour = convertNamedCSSColourtoRGB(colour);
     colourType = "namedCSS";
   }
@@ -451,12 +455,11 @@ function findNearestColour(colour, palette) {
   for (const paletteColour of palette) {
     if (isHexColour(paletteColour)) {
       paletteRGB.push(convertHextoRGB(paletteColour));
-    }
-    if (isCSSRGBColour(paletteColour)) {
+    } else if (isCSSRGBColour(paletteColour)) {
       paletteRGB.push(convertCSSRGBtoRGB(paletteColour));
-    }
-    if (isNamedCSSColour(paletteColour)) {
-      paletteRGB.push(convertNamedCSSColourtoRGB(paletteColour));
+    } else if (isNamedCSSColour(paletteColour)) {
+      const rgb = convertNamedCSSColourtoRGB(paletteColour);
+      if (rgb) paletteRGB.push(rgb);
     }
   }
   if (paletteRGB.length < 2) {
@@ -471,6 +474,20 @@ function findNearestColour(colour, palette) {
   }
   return convertRGBtoNamedCSSColour(nearest);
 }
+function findNearestCSSRGBColour(colour, palette) {
+  if (!palette || palette.length < 2) {
+    return colour;
+  }
+  const baseRGBColour = convertCSSRGBtoRGB(colour);
+  const paletteRGBColours = palette.map(
+    (hexColour) => convertCSSRGBtoRGB(hexColour)
+  );
+  const nearestRGBColour = findNearestRGBColour(
+    baseRGBColour,
+    paletteRGBColours
+  );
+  return convertRGBtoCSSRGB(nearestRGBColour);
+}
 function findNearestHexColour(colour, palette) {
   if (!palette || palette.length < 2) {
     return colour;
@@ -538,9 +555,7 @@ function getContrastRatio(colour1, colour2, standard) {
     const _hexColour1 = convertNamedCSSColourtoHex(colour1);
     if (_hexColour1 === void 0) {
       throw new Error(
-        `getContrastRatio expects valid CSS named colours.
-					${colour1} is not a valid CSS named colour.
-					See https://developer.mozilla.org/en-US/docs/Web/CSS/named-color`
+        `getContrastRatio expects valid CSS named colours. ${colour1} is not a valid CSS named colour. See ${NAMED_CSS_COLOUR_URL}`
       );
     }
     hexColour1 = _hexColour1;
@@ -552,9 +567,9 @@ function getContrastRatio(colour1, colour2, standard) {
   } else {
     const _hexColour2 = convertNamedCSSColourtoHex(colour2);
     if (_hexColour2 === void 0) {
-      throw new Error(`getContrastRatio expects valid CSS named colours.
-					${colour2} is not a valid CSS named colour.
-					See https://developer.mozilla.org/en-US/docs/Web/CSS/named-color`);
+      throw new Error(
+        `getContrastRatio expects valid CSS named colours. ${colour2} is not a valid CSS named colour. See ${NAMED_CSS_COLOUR_URL}`
+      );
     }
     hexColour2 = _hexColour2;
   }
@@ -572,9 +587,7 @@ function getContrastRatioFromNamedCSSColour(colour1, colour2, standard) {
   const hexColour2 = convertNamedCSSColourtoHex(colour2);
   if (hexColour1 === void 0 || hexColour2 === void 0) {
     throw new Error(
-      `getContrastRatioFromNamedCSSColour expects valid CSS named colours.
-			${colour1} or ${colour2} are not valid CSS named colours.
-			See https://developer.mozilla.org/en-US/docs/Web/CSS/named-color`
+      `getContrastRatioFromNamedCSSColour expects valid CSS named colours. ${colour1} or ${colour2} are not valid CSS named colours. See ${NAMED_CSS_COLOUR_URL}`
     );
   }
   return getContrastRatioFromHex(hexColour1, hexColour2, standard);
@@ -591,7 +604,7 @@ function isCSSNamedDarkColour(name, standard) {
     return isHexDarkColour(hex, standard);
   }
   throw new Error(
-    `${name} is not a valid colour format. isCSSNamedDarkColour only accepts CSS named colours. Check more details here https://developer.mozilla.org/en-US/docs/Web/CSS/named-color`
+    `${name} is not a valid colour format. isCSSNamedDarkColour only accepts CSS named colours. See ${NAMED_CSS_COLOUR_URL}`
   );
 }
 function isCSSRGBDarkColour(colour, standard) {
@@ -610,9 +623,9 @@ function isDarkColour(colour, standard) {
       return isCSSRGBDarkColour(colour, standard);
     }
     return isCSSNamedDarkColour(colour, standard);
-  } catch (error) {
+  } catch (_error) {
     throw new Error(
-      `${colour} is not a valid colour format. isDarkColour accepts CSS RGB formats, ie rgb(0,0,0) and rgba(255, 255, 255, 0.4), hexadecimal and CSS named colours.`
+      `${colour} is not a valid colour format. isDarkColour accepts CSS RGB formats, ie rgb(0,0,0), rgba(255, 255, 255, 0.4), rgb(50%, 25%, 100%), and rgba(50%, 25%, 100%, 80%), hexadecimal and CSS named colours.`
     );
   }
 }
@@ -639,6 +652,90 @@ const pickHexColourContrast = ({ backgroundColour, optionOneColour, optionTwoCol
   }
   return optionTwoColour;
 };
+function convertRGBtoHSV(r, g, b) {
+  const red = r / 255;
+  const green = g / 255;
+  const blue = b / 255;
+  const max = Math.max(red, green, blue);
+  const min = Math.min(red, green, blue);
+  let hue = 0;
+  let saturation = 0;
+  const value = max;
+  const delta = max - min;
+  if (max === 0) {
+    saturation = 0;
+  } else {
+    saturation = delta / max;
+  }
+  if (delta !== 0) {
+    if (max === red) {
+      hue = (green - blue) / delta % 6;
+    } else if (max === green) {
+      hue = (blue - red) / delta + 2;
+    } else if (max === blue) {
+      hue = (red - green) / delta + 4;
+    }
+    hue = hue * 60;
+    if (hue < 0) {
+      hue = hue + 360;
+    }
+  }
+  return { h: hue, s: saturation, v: value };
+}
+function getColorInfo(hex) {
+  const { R, G, B, A } = convertHextoRGB(hex);
+  const a = typeof A === "number" ? A : 1;
+  const { h, s, v } = convertRGBtoHSV(R, G, B);
+  return { h, s, v, a };
+}
+function getGreyscaleOrder(v) {
+  if (v === 0) return 1;
+  if (v === 1) return 2;
+  return 0;
+}
+function sortHexColours(hexColours) {
+  const cache = /* @__PURE__ */ new Map();
+  for (const hex of hexColours) {
+    if (!cache.has(hex)) {
+      cache.set(hex, getColorInfo(hex));
+    }
+  }
+  const normal = [];
+  const greyscale = [];
+  const transparent = [];
+  for (const hex of hexColours) {
+    const { s, a } = cache.get(hex);
+    if (a === 0) {
+      transparent.push(hex);
+    } else if (s === 0) {
+      greyscale.push(hex);
+    } else {
+      normal.push(hex);
+    }
+  }
+  normal.sort((a, b) => {
+    const ca = cache.get(a);
+    const cb = cache.get(b);
+    if (ca.h !== cb.h) return ca.h - cb.h;
+    return cb.s - ca.s;
+  });
+  greyscale.sort((a, b) => {
+    const ca = cache.get(a);
+    const cb = cache.get(b);
+    const orderA = getGreyscaleOrder(ca.v);
+    const orderB = getGreyscaleOrder(cb.v);
+    if (orderA !== orderB) {
+      return orderA - orderB;
+    }
+    return ca.v - cb.v;
+  });
+  transparent.sort((a, b) => {
+    const ca = cache.get(a);
+    const cb = cache.get(b);
+    return ca.v - cb.v;
+  });
+  return [...normal, ...greyscale, ...transparent];
+}
 export {
   RGBdistance,
   ciede2000,
@@ -670,6 +767,9 @@ export {
   isCSSRGBColour,
   isCSSRGBDarkColour,
   isDarkColour,
+  isHexColour,
   isHexDarkColour,
-  pickHexColourContrast
+  isNamedCSSColour,
+  pickHexColourContrast,
+  sortHexColours
 };