@sardine/colour 2.2.0 → 2.3.0

package/dist/convertHextoCSSRGB.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Converts an hexadecimal colour into CSS RGB/A colour.
+ * @param {string} hex - An hexadecimal colour in the format:
+ *
+ * - `#000`
+ * - `#102030`
+ * - `#ffff`
+ * - `#102030ff`
+ *
+ * @returns {string} either a CSS RGB or CSS RGBA string.
+ */
+export declare function convertHextoCSSRGB(hex: string): string;

package/dist/convertHextoRGB.d.ts

@@ -8,6 +8,6 @@ import type { RGBColour } from "./types";
  * - `#ffff`
  * - `#102030ff`
  *
- * @returns {RGBColour} - RGB colour object.
+ * @returns {RGBColour} RGB colour object.
  */
 export declare function convertHextoRGB(hex: string): RGBColour;

package/dist/getContrastRatio.d.ts

@@ -0,0 +1,9 @@
+import type { NamedCSSColour, WCAG } from "./types";
+/**
+ * Calculates the contrast ratio between two colours.
+ * @param colour1 The first colour
+ * @param colour2 The second colour
+ * @param standard The standard to evaluate the contrast ratio against, defaults to WCAG2.1
+ * @returns The contrast ratio between the two colours truncated to 3 decimal places
+ */
+export declare function getContrastRatio(colour1: string | NamedCSSColour, colour2: string | NamedCSSColour, standard: WCAG): number;

package/dist/getContrastRatioFromCSSRGB.d.ts

@@ -0,0 +1,9 @@
+import type { WCAG } from "./types";
+/**
+ * Calculates the contrast ratio between two colours in CSSRGB format.
+ * @param colour1 The first colour in CSSRGB format
+ * @param colour2 The second colour in CSSRGB format
+ * @param standard The standard to evaluate the contrast ratio against, defaults to WCAG2.1
+ * @returns The contrast ratio between the two colours truncated to 3 decimal places
+ */
+export declare function getContrastRatioFromCSSRGB(colour1: string, colour2: string, standard: WCAG): number;

package/dist/getContrastRatioFromNamedCSSColour.d.ts

@@ -0,0 +1,11 @@
+import type { NamedCSSColour, WCAG } from "./types";
+/**
+ * Calculates the contrast ratio between two named CSS colours in.
+ *
+ * See list here https://developer.mozilla.org/en-US/docs/Web/CSS/named-color
+ * @param colour1 The first named CSS colour
+ * @param colour2 The second named CSS colour
+ * @param standard The standard to evaluate the contrast ratio against, defaults to WCAG2.1
+ * @returns The contrast ratio between the two colours truncated to 3 decimal places
+ */
+export declare function getContrastRatioFromNamedCSSColour(colour1: NamedCSSColour, colour2: NamedCSSColour, standard: WCAG): number;

package/dist/index.cjs

@@ -14,31 +14,27 @@ function deltaHue_d({ C1, C2, h1_d, h2_d }) {
   if (C1 * C2 === 0) {
     return 0;
   }
-  if (Math.abs(h2_d - h1_d) <= 180) {
-    return h2_d - h1_d;
+  const delta = h2_d - h1_d;
+  if (Math.abs(delta) <= 180) {
+    return delta;
   }
-  if (h2_d - h1_d > 180) {
-    return h2_d - h1_d - 360;
+  if (delta > 180) {
+    return delta - 360;
   }
-  if (h2_d - h1_d < -180) {
-    return h2_d - h1_d + 360;
-  }
-  return 0;
+  return delta + 360;
 }
 function meanHue_d({ C1, C2, h1_d, h2_d }) {
   if (C1 * C2 === 0) {
     return h2_d + h1_d;
   }
-  if (Math.abs(h1_d - h2_d) <= 180) {
+  const delta = Math.abs(h1_d - h2_d);
+  if (delta <= 180) {
     return (h2_d + h1_d) / 2;
   }
-  if (Math.abs(h1_d - h2_d) > 180 && h1_d + h2_d < 360) {
+  if (delta > 180 && h1_d + h2_d < 360) {
     return (h2_d + h1_d + 360) / 2;
   }
-  if (Math.abs(h1_d - h2_d) > 180 && h1_d + h2_d >= 360) {
-    return (h2_d + h1_d - 360) / 2;
-  }
-  return 0;
+  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));
@@ -358,7 +354,7 @@ function convertHextoRGB(hex) {
       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: Number.parseInt(`${hex[7]}${hex[8]}`, 16) / 255
+      A: Math.round(Number.parseInt(`${hex[7]}${hex[8]}`, 16) / 255 * 100) / 100
     };
   }
   if (hex.match(shortAlphaHexRegex)) {
@@ -366,13 +362,20 @@ function convertHextoRGB(hex) {
       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: Number.parseInt(`${hex[4]}${hex[4]}`, 16) / 255
+      A: Math.round(Number.parseInt(`${hex[4]}${hex[4]}`, 16) / 255 * 100) / 100
     };
   }
   throw new Error(
     `convertHextoRGB expects an valid hexadecimal colour value but got ${hex}`
   );
 }
+function convertHextoCSSRGB(hex) {
+  const rgb = convertHextoRGB(hex);
+  if (rgb.A) {
+    return `rgba(${rgb.R},${rgb.G},${rgb.B},${rgb.A})`;
+  }
+  return `rgb(${rgb.R},${rgb.G},${rgb.B})`;
+}
 function convertNamedCSSColourtoHex(name) {
   return namedCSSColours.get(name);
 }
@@ -468,10 +471,7 @@ function findNearestColour(colour, palette) {
   if (colourType === "cssRGB") {
     return convertRGBtoCSSRGB(nearest);
   }
-  if (colourType === "namedCSS") {
-    return convertRGBtoNamedCSSColour(nearest);
-  }
-  return;
+  return convertRGBtoNamedCSSColour(nearest);
 }
 function findNearestHexColour(colour, palette) {
   if (!palette || palette.length < 2) {
@@ -518,14 +518,69 @@ function getSRGBLuminanceFromHex(colour, standard) {
   const rgbColor = convertHextoRGB(colour);
   return getSRGBLuminanceFromRGB(rgbColor, standard);
 }
-function getContrastRatioFromHex(colour1, colour2, standard) {
-  const luminance1 = getSRGBLuminanceFromHex(colour1, standard);
-  const luminance2 = getSRGBLuminanceFromHex(colour2, standard);
+function calculateContrastRatio(luminance1, luminance2) {
   const lighter = Math.max(luminance1, luminance2);
   const darker = Math.min(luminance1, luminance2);
   const ratio = (lighter + 0.05) / (darker + 0.05);
   return Math.floor(ratio * 1e3) / 1e3;
 }
+function getContrastRatioFromHex(colour1, colour2, standard) {
+  const luminance1 = getSRGBLuminanceFromHex(colour1, standard);
+  const luminance2 = getSRGBLuminanceFromHex(colour2, standard);
+  return calculateContrastRatio(luminance1, luminance2);
+}
+function getContrastRatio(colour1, colour2, standard) {
+  let hexColour1;
+  let hexColour2;
+  if (colour1.startsWith("#")) {
+    hexColour1 = colour1;
+  } else if (colour1.startsWith("rgb")) {
+    hexColour1 = convertCSSRGBtoHex(colour1);
+  } else {
+    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`
+      );
+    }
+    hexColour1 = _hexColour1;
+  }
+  if (colour2.startsWith("#")) {
+    hexColour2 = colour2;
+  } else if (colour2.startsWith("rgb")) {
+    hexColour2 = convertCSSRGBtoHex(colour2);
+  } 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`);
+    }
+    hexColour2 = _hexColour2;
+  }
+  return getContrastRatioFromHex(hexColour1, hexColour2, standard);
+}
+function getContrastRatioFromCSSRGB(colour1, colour2, standard) {
+  const rgbColour1 = convertCSSRGBtoRGB(colour1);
+  const rgbColour2 = convertCSSRGBtoRGB(colour2);
+  const luminance1 = getSRGBLuminanceFromRGB(rgbColour1, standard);
+  const luminance2 = getSRGBLuminanceFromRGB(rgbColour2, standard);
+  return calculateContrastRatio(luminance1, luminance2);
+}
+function getContrastRatioFromNamedCSSColour(colour1, colour2, standard) {
+  const hexColour1 = convertNamedCSSColourtoHex(colour1);
+  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`
+    );
+  }
+  return getContrastRatioFromHex(hexColour1, hexColour2, standard);
+}
 function isHexDarkColour(colour, standard) {
   const colourLuminance = getSRGBLuminanceFromHex(colour, standard) + 0.05;
   const whiteContrast = 1.05 / colourLuminance;
@@ -590,6 +645,7 @@ exports.RGBdistance = RGBdistance;
 exports.ciede2000 = ciede2000;
 exports.convertCSSRGBtoHex = convertCSSRGBtoHex;
 exports.convertCSSRGBtoRGB = convertCSSRGBtoRGB;
+exports.convertHextoCSSRGB = convertHextoCSSRGB;
 exports.convertHextoNamedCSSColour = convertHextoNamedCSSColour;
 exports.convertHextoRGB = convertHextoRGB;
 exports.convertNamedCSSColourtoHex = convertNamedCSSColourtoHex;
@@ -605,7 +661,10 @@ exports.findNearestColour = findNearestColour;
 exports.findNearestHexColour = findNearestHexColour;
 exports.findNearestNamedCSSColour = findNearestNamedCSSColour;
 exports.findNearestRGBColour = findNearestRGBColour;
+exports.getContrastRatio = getContrastRatio;
+exports.getContrastRatioFromCSSRGB = getContrastRatioFromCSSRGB;
 exports.getContrastRatioFromHex = getContrastRatioFromHex;
+exports.getContrastRatioFromNamedCSSColour = getContrastRatioFromNamedCSSColour;
 exports.getSRGBLuminanceFromHex = getSRGBLuminanceFromHex;
 exports.getSRGBLuminanceFromRGB = getSRGBLuminanceFromRGB;
 exports.isCSSNamedDarkColour = isCSSNamedDarkColour;

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export { convertCSSRGBtoHex } from "./convertCSSRGBtoHex";
 export { convertCSSRGBtoRGB } from "./convertCSSRGBtoRGB";
 export { convertHextoNamedCSSColour } from "./convertHextoNamedCSSColour";
 export { convertHextoRGB } from "./convertHextoRGB";
+export { convertHextoCSSRGB } from "./convertHextoCSSRGB";
 export { convertNamedCSSColourtoHex } from "./convertNamedCSSColourtoHex";
 export { convertNamedCSSColourtoRGB } from "./convertNamedCSSColourtoRGB";
 export { convertRGBtoCSSRGB } from "./convertRGBtoCSSRGB";
@@ -17,7 +18,10 @@ export { findNearestColour } from "./findNearestColour";
 export { findNearestHexColour } from "./findNearestHexColour";
 export { findNearestNamedCSSColour } from "./findNearestNamedCSSColour";
 export { findNearestRGBColour } from "./findNearestRGBColour";
+export { getContrastRatio } from "./getContrastRatio";
+export { getContrastRatioFromCSSRGB } from "./getContrastRatioFromCSSRGB";
 export { getContrastRatioFromHex } from "./getContrastRatioFromHex";
+export { getContrastRatioFromNamedCSSColour } from "./getContrastRatioFromNamedCSSColour";
 export { getSRGBLuminanceFromHex } from "./getSRGBLuminanceFromHex";
 export { getSRGBLuminanceFromRGB } from "./getSRGBLuminanceFromRGB";
 export { isCSSNamedDarkColour } from "./isCSSNameDarkColour";

package/dist/index.min.js

@@ -1 +1,7 @@
-"use strict";function T(e,t){if(e===0&&t===0)return 0;const n=Math.atan2(e,t)*(180/Math.PI);return n>=0?n:n+360}function be({C1:e,C2:t,h1_d:n,h2_d:r}){return e*t===0?0:Math.abs(r-n)<=180?r-n:r-n>180?r-n-360:r-n<-180?r-n+360:0}function ge({C1:e,C2:t,h1_d:n,h2_d:r}){return e*t===0?r+n:Math.abs(n-r)<=180?(r+n)/2:Math.abs(n-r)>180&&n+r<360?(r+n+360)/2:Math.abs(n-r)>180&&n+r>=360?(r+n-360)/2:0}const m=e=>e*(Math.PI/180),z=e=>Math.sqrt(e**7/(e**7+25**7));function b(e,t){const n=e/255,r=t?.03928:.04045;let o;return n>r?o=((n+.055)/1.055)**2.4:o=n/12.92,o}function v(e){const t=.20689655172413793,n=t**3;let r;return e>n?r=Math.cbrt(e):r=e/(3*t**2)+4/29,r}function he(e,t,n){return Math.min(Math.max(e,t),n)}function j(e,t){const n=e.L,r=e.a,o=e.b,a=t.L,s=t.a,f=t.b,c=1,d=1,G=1,g=Math.sqrt(r**2+o**2),h=Math.sqrt(s**2+f**2),fe=a-n,ce=(g+h)/2,P=.5*(1-z(ce)),A=r*(1+P),Y=s*(1+P),B=Math.sqrt(A**2+o**2),$=Math.sqrt(Y**2+f**2),k=(B+$)/2,F=$-B,W=T(o,A),E=T(f,Y),ie=be({C1:g,C2:h,h1_d:W,h2_d:E}),X=2*Math.sqrt(B*$)*Math.sin(m(ie)/2),C=ge({C1:g,C2:h,h1_d:W,h2_d:E}),Z=(n+a)/2,ue=1-.17*Math.cos(m(C-30))+.24*Math.cos(m(2*C))+.32*Math.cos(m(3*C+6))-.2*Math.cos(m(4*C-63)),le=1+.015*(Z-50)**2/Math.sqrt(20+(Z-50)**2),D=.045*k+1,x=1+.015*k*ue,de=30*Math.exp(-(((C-275)/25)**2)),me=-2*z(k)*Math.sin(m(de*2));return Math.sqrt((fe/(c*le))**2+(F/(d*D))**2+(X/(G*x))**2+me*(F/(d*D))*(X/(G*x)))}function O(e){const{R:t,G:n,B:r}=e,o=b(t)*100,a=b(n)*100,s=b(r)*100,f=o*.4124+a*.3576+s*.1805,c=o*.2126+a*.7152+s*.0722,d=o*.0193+a*.1192+s*.9505;return{X:f,Y:c,Z:d}}function U(e){const{X:t,Y:n,Z:r}=e,o=t/95.047,a=n/100,s=r/108.883,f=v(o),c=v(a),d=v(s),G=116*c-16,g=500*(f-c),h=200*(c-d);return{L:G,a:g,b:h}}function w(e){const t=O(e);return U(t)}const V=(e,t)=>{const n=w(e),r=w(t);return j(n,r)},J=/^#[a-fA-F0-9]{6}$/,K=/^#[a-fA-F0-9]{8}$/,Q=/^#[a-fA-F0-9]{3}$/,_=/^#[a-fA-F0-9]{4}$/,ee=/^rgba*\(\s*([-+]?\d+)\s*(?:,)?\s*([-+]?\d+)\s*(?:,)?\s*([-+]?\d+)\s*(?:,*|\/*)\s*([-+]?\d*[.]?\d+[%]?)*\)$/i;function i(e){const t=e.match(ee);if(!t)throw new Error(`convertCSSRGBtoHex expects a valid CSS RGB string but got ${e}`);const n=r=>r?Number.parseFloat(r):void 0;return{R:n(t[1]),G:n(t[2]),B:n(t[3]),A:n(t[4])}}function p({R:e,G:t,B:n,A:r}){const o=a=>he(a,0,255).toString(16).padStart(2,"0");return`#${o(e)}${o(t)}${o(n)}${r?o(Math.round(r*255)):""}`}function Ce(e){const t=i(e);return p(t)}const y=new Map([["aliceblue","#f0f8ff"],["antiquewhite","#faebd7"],["aqua","#00ffff"],["aquamarine","#7fffd4"],["azure","#f0ffff"],["beige","#f5f5dc"],["bisque","#ffe4c4"],["black","#000000"],["blanchedalmond","#ffebcd"],["blue","#0000ff"],["blueviolet","#8a2be2"],["brown","#a52a2a"],["burlywood","#deb887"],["cadetblue","#5f9ea0"],["chartreuse","#7fff00"],["chocolate","#d2691e"],["coral","#ff7f50"],["cornflowerblue","#6495ed"],["cornsilk","#fff8dc"],["crimson","#dc143c"],["cyan","#00ffff"],["darkblue","#00008b"],["darkcyan","#008b8b"],["darkgoldenrod","#b8860b"],["darkgray","#a9a9a9"],["darkgreen","#006400"],["darkgrey","#a9a9a9"],["darkkhaki","#bdb76b"],["darkmagenta","#8b008b"],["darkolivegreen","#556b2f"],["darkorange","#ff8c00"],["darkorchid","#9932cc"],["darkred","#8b0000"],["darksalmon","#e9967a"],["darkseagreen","#8fbc8f"],["darkslateblue","#483d8b"],["darkslategray","#2f4f4f"],["darkslategrey","#2f4f4f"],["darkturquoise","#00ced1"],["darkviolet","#9400d3"],["deeppink","#ff1493"],["deepskyblue","#00bfff"],["dimgray","#696969"],["dimgrey","#696969"],["dodgerblue","#1e90ff"],["firebrick","#b22222"],["floralwhite","#fffaf0"],["forestgreen","#228b22"],["fuchsia","#ff00ff"],["gainsboro","#dcdcdc"],["ghostwhite","#f8f8ff"],["gold","#ffd700"],["goldenrod","#daa520"],["gray","#808080"],["green","#008000"],["greenyellow","#adff2f"],["grey","#808080"],["honeydew","#f0fff0"],["hotpink","#ff69b4"],["indianred","#cd5c5c"],["indigo","#4b0082"],["ivory","#fffff0"],["khaki","#f0e68c"],["lavender","#e6e6fa"],["lavenderblush","#fff0f5"],["lawngreen","#7cfc00"],["lemonchiffon","#fffacd"],["lightblue","#add8e6"],["lightcoral","#f08080"],["lightcyan","#e0ffff"],["lightgoldenrodyellow","#fafad2"],["lightgray","#d3d3d3"],["lightgreen","#90ee90"],["lightgrey","#d3d3d3"],["lightpink","#ffb6c1"],["lightsalmon","#ffa07a"],["lightseagreen","#20b2aa"],["lightskyblue","#87cefa"],["lightslategray","#778899"],["lightslategrey","#778899"],["lightsteelblue","#b0c4de"],["lightyellow","#ffffe0"],["lime","#00ff00"],["limegreen","#32cd32"],["linen","#faf0e6"],["magenta","#ff00ff"],["maroon","#800000"],["mediumaquamarine","#66cdaa"],["mediumblue","#0000cd"],["mediumorchid","#ba55d3"],["mediumpurple","#9370db"],["mediumseagreen","#3cb371"],["mediumslateblue","#7b68ee"],["mediumspringgreen","#00fa9a"],["mediumturquoise","#48d1cc"],["mediumvioletred","#c71585"],["midnightblue","#191970"],["mintcream","#f5fffa"],["mistyrose","#ffe4e1"],["moccasin","#ffe4b5"],["navajowhite","#ffdead"],["navy","#000080"],["oldlace","#fdf5e6"],["olive","#808000"],["olivedrab","#6b8e23"],["orangered","#ff4500"],["orchid","#da70d6"],["palegoldenrod","#eee8aa"],["palegreen","#98fb98"],["paleturquoise","#afeeee"],["palevioletred","#db7093"],["papayawhip","#ffefd5"],["peachpuff","#ffdab9"],["peru","#cd853f"],["pink","#ffc0cb"],["plum","#dda0dd"],["powderblue","#b0e0e6"],["purple","#800080"],["red","#ff0000"],["rosybrown","#bc8f8f"],["royalblue","#4169e1"],["saddlebrown","#8b4513"],["salmon","#fa8072"],["sandybrown","#f4a460"],["seagreen","#2e8b57"],["seashell","#fff5ee"],["sienna","#a0522d"],["silver","#c0c0c0"],["skyblue","#87ceeb"],["slateblue","#6a5acd"],["slategray","#708090"],["slategrey","#708090"],["snow","#fffafa"],["springgreen","#00ff7f"],["steelblue","#4682b4"],["tan","#d2b48c"],["teal","#008080"],["thistle","#d8bfd8"],["tomato","#ff6347"],["transparent","#00000000"],["turquoise","#40e0d0"],["violet","#ee82ee"],["wheat","#f5deb3"],["white","#ffffff"],["whitesmoke","#f5f5f5"],["yellow","#ffff00"],["yellowgreen","#9acd32"]]);function te(e){for(const[t,n]of y.entries())if(n===e)return t}function u(e){if(typeof e!="string")throw new Error(`convertHextoRGB expects a string but got a ${typeof e}`);if(e.match(J))return{R:Number.parseInt(`${e[1]}${e[2]}`,16),G:Number.parseInt(`${e[3]}${e[4]}`,16),B:Number.parseInt(`${e[5]}${e[6]}`,16)};if(e.match(Q))return{R:Number.parseInt(`${e[1]}${e[1]}`,16),G:Number.parseInt(`${e[2]}${e[2]}`,16),B:Number.parseInt(`${e[3]}${e[3]}`,16)};if(e.match(K))return{R:Number.parseInt(`${e[1]}${e[2]}`,16),G:Number.parseInt(`${e[3]}${e[4]}`,16),B:Number.parseInt(`${e[5]}${e[6]}`,16),A:Number.parseInt(`${e[7]}${e[8]}`,16)/255};if(e.match(_))return{R:Number.parseInt(`${e[1]}${e[1]}`,16),G:Number.parseInt(`${e[2]}${e[2]}`,16),B:Number.parseInt(`${e[3]}${e[3]}`,16),A:Number.parseInt(`${e[4]}${e[4]}`,16)/255};throw new Error(`convertHextoRGB expects an valid hexadecimal colour value but got ${e}`)}function M(e){return y.get(e)}function R(e){const t=M(e);if(t)return u(t)}function N({R:e,G:t,B:n,A:r}){return`rgb(${e} ${t} ${n}${r?` / ${r}`:""})`}function H(e){const t=p(e);return te(t)}function S(e,t){if(!t||t.length<2)return e;const n=[];for(const o of t){const a=V(e,o);n.push([o,a])}return n.sort((o,a)=>o[1]-a[1])[0][0]}function pe(e,t){if(!t||t.length<2)return e;const n=i(e),r=t.map(a=>i(a)),o=S(n,r);return N(o)}function q(e){return!!e.match(ee)}function ne(e){return!!e.match(J)||!!e.match(K)||!!e.match(_)||!!e.match(Q)}function re(e){return y.has(e)}function Re(e,t){if(!t||t.length<2)return e;let n,r;const o=[];if(ne(e)&&(n=u(e),r="hex"),q(e)&&(n=i(e),r="cssRGB"),re(e)&&(n=R(e),r="namedCSS"),!n)return;for(const s of t)ne(s)&&o.push(u(s)),q(s)&&o.push(i(s)),re(s)&&o.push(R(s));if(o.length<2)return e;const a=S(n,o);if(r==="hex")return p(a);if(r==="cssRGB")return N(a);if(r==="namedCSS")return H(a)}function Se(e,t){if(!t||t.length<2)return e;const n=u(e),r=t.map(a=>u(a)),o=S(n,r);return p(o)}function Ge(e,t){if(!t||t.length<2)return e;const n=R(e),o=t.map(s=>R(s)).filter(s=>s!==void 0);if(!n||o.length<2)return e;const a=S(n,o);return H(a)}function I({R:e,G:t,B:n},r){const o=r==="WCAG2.1",a=b(e,o),s=b(t,o),f=b(n,o);return .2126*a+.7152*s+.0722*f}function l(e,t){const n=u(e);return I(n,t)}function Be(e,t,n){const r=l(e,n),o=l(t,n),a=Math.max(r,o),s=Math.min(r,o),f=(a+.05)/(s+.05);return Math.floor(f*1e3)/1e3}function L(e,t){const n=l(e,t)+.05,r=1.05/n,o=n/.05;return r>o}function oe(e,t){const n=M(e);if(n)return L(n,t);throw new Error(`${e} 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`)}function ae(e,t){const n=i(e),r=I(n,t),o=1.05/r,a=r/.05;return o>a}function $e(e,t){try{return e.startsWith("#")?L(e,t):e.startsWith("rgb")?ae(e,t):oe(e,t)}catch{throw new Error(`${e} 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.`)}}const se=(e,t)=>e>t?e/t:t/e,ke=({backgroundColour:e,optionOneColour:t,optionTwoColour:n},r)=>{const o=l(e,r)+.05,a=l(t,r)+.05,s=l(n,r)+.05,f=se(a,o),c=se(s,o);return f>c?t:n};export{V as RGBdistance,j as ciede2000,Ce as convertCSSRGBtoHex,i as convertCSSRGBtoRGB,te as convertHextoNamedCSSColour,u as convertHextoRGB,M as convertNamedCSSColourtoHex,R as convertNamedCSSColourtoRGB,N as convertRGBtoCSSRGB,p as convertRGBtoHex,w as convertRGBtoLab,H as convertRGBtoNamedCSSColour,O as convertRGBtoXYZ,U as convertXYZtoLab,pe as findNearestCSSRGBColour,Re as findNearestColour,Se as findNearestHexColour,Ge as findNearestNamedCSSColour,S as findNearestRGBColour,Be as getContrastRatioFromHex,l as getSRGBLuminanceFromHex,I as getSRGBLuminanceFromRGB,oe as isCSSNamedDarkColour,q as isCSSRGBColour,ae as isCSSRGBDarkColour,$e as isDarkColour,L as isHexDarkColour,ke as pickHexColourContrast};
+"use strict";function T(e,t){if(e===0&&t===0)return 0;const n=Math.atan2(e,t)*(180/Math.PI);return n>=0?n:n+360}function Ce({C1:e,C2:t,h1_d:n,h2_d:o}){if(e*t===0)return 0;const r=o-n;return Math.abs(r)<=180?r:r>180?r-360:r+360}function Se({C1:e,C2:t,h1_d:n,h2_d:o}){if(e*t===0)return o+n;const r=Math.abs(n-o);return r<=180?(o+n)/2:r>180&&n+o<360?(o+n+360)/2:(o+n-360)/2}const b=e=>e*(Math.PI/180),U=e=>Math.sqrt(e**7/(e**7+25**7));function g(e,t){const n=e/255,o=t?.03928:.04045;let r;return n>o?r=((n+.055)/1.055)**2.4:r=n/12.92,r}function y(e){const t=.20689655172413793,n=t**3;let o;return e>n?o=Math.cbrt(e):o=e/(3*t**2)+4/29,o}function pe(e,t,n){return Math.min(Math.max(e,t),n)}function j(e,t){const n=e.L,o=e.a,r=e.b,a=t.L,s=t.a,c=t.b,f=1,m=1,G=1,h=Math.sqrt(o**2+r**2),C=Math.sqrt(s**2+c**2),ue=a-n,le=(h+C)/2,P=.5*(1-U(le)),A=o*(1+P),F=s*(1+P),B=Math.sqrt(A**2+r**2),k=Math.sqrt(F**2+c**2),w=(B+k)/2,E=k-B,Y=T(r,A),X=T(c,F),de=Ce({C1:h,C2:C,h1_d:Y,h2_d:X}),Z=2*Math.sqrt(B*k)*Math.sin(b(de)/2),S=Se({C1:h,C2:C,h1_d:Y,h2_d:X}),D=(n+a)/2,me=1-.17*Math.cos(b(S-30))+.24*Math.cos(b(2*S))+.32*Math.cos(b(3*S+6))-.2*Math.cos(b(4*S-63)),be=1+.015*(D-50)**2/Math.sqrt(20+(D-50)**2),z=.045*w+1,_=1+.015*w*me,ge=30*Math.exp(-(((S-275)/25)**2)),he=-2*U(w)*Math.sin(b(ge*2));return Math.sqrt((ue/(f*be))**2+(E/(m*z))**2+(Z/(G*_))**2+he*(E/(m*z))*(Z/(G*_)))}function O(e){const{R:t,G:n,B:o}=e,r=g(t)*100,a=g(n)*100,s=g(o)*100,c=r*.4124+a*.3576+s*.1805,f=r*.2126+a*.7152+s*.0722,m=r*.0193+a*.1192+s*.9505;return{X:c,Y:f,Z:m}}function V(e){const{X:t,Y:n,Z:o}=e,r=t/95.047,a=n/100,s=o/108.883,c=y(r),f=y(a),m=y(s),G=116*f-16,h=500*(c-f),C=200*(f-m);return{L:G,a:h,b:C}}function N(e){const t=O(e);return V(t)}const J=(e,t)=>{const n=N(e),o=N(t);return j(n,o)},K=/^#[a-fA-F0-9]{6}$/,Q=/^#[a-fA-F0-9]{8}$/,ee=/^#[a-fA-F0-9]{3}$/,te=/^#[a-fA-F0-9]{4}$/,ne=/^rgba*\(\s*([-+]?\d+)\s*(?:,)?\s*([-+]?\d+)\s*(?:,)?\s*([-+]?\d+)\s*(?:,*|\/*)\s*([-+]?\d*[.]?\d+[%]?)*\)$/i;function i(e){const t=e.match(ne);if(!t)throw new Error(`convertCSSRGBtoHex expects a valid CSS RGB string but got ${e}`);const n=o=>o?Number.parseFloat(o):void 0;return{R:n(t[1]),G:n(t[2]),B:n(t[3]),A:n(t[4])}}function p({R:e,G:t,B:n,A:o}){const r=a=>pe(a,0,255).toString(16).padStart(2,"0");return`#${r(e)}${r(t)}${r(n)}${o?r(Math.round(o*255)):""}`}function M(e){const t=i(e);return p(t)}const H=new Map([["aliceblue","#f0f8ff"],["antiquewhite","#faebd7"],["aqua","#00ffff"],["aquamarine","#7fffd4"],["azure","#f0ffff"],["beige","#f5f5dc"],["bisque","#ffe4c4"],["black","#000000"],["blanchedalmond","#ffebcd"],["blue","#0000ff"],["blueviolet","#8a2be2"],["brown","#a52a2a"],["burlywood","#deb887"],["cadetblue","#5f9ea0"],["chartreuse","#7fff00"],["chocolate","#d2691e"],["coral","#ff7f50"],["cornflowerblue","#6495ed"],["cornsilk","#fff8dc"],["crimson","#dc143c"],["cyan","#00ffff"],["darkblue","#00008b"],["darkcyan","#008b8b"],["darkgoldenrod","#b8860b"],["darkgray","#a9a9a9"],["darkgreen","#006400"],["darkgrey","#a9a9a9"],["darkkhaki","#bdb76b"],["darkmagenta","#8b008b"],["darkolivegreen","#556b2f"],["darkorange","#ff8c00"],["darkorchid","#9932cc"],["darkred","#8b0000"],["darksalmon","#e9967a"],["darkseagreen","#8fbc8f"],["darkslateblue","#483d8b"],["darkslategray","#2f4f4f"],["darkslategrey","#2f4f4f"],["darkturquoise","#00ced1"],["darkviolet","#9400d3"],["deeppink","#ff1493"],["deepskyblue","#00bfff"],["dimgray","#696969"],["dimgrey","#696969"],["dodgerblue","#1e90ff"],["firebrick","#b22222"],["floralwhite","#fffaf0"],["forestgreen","#228b22"],["fuchsia","#ff00ff"],["gainsboro","#dcdcdc"],["ghostwhite","#f8f8ff"],["gold","#ffd700"],["goldenrod","#daa520"],["gray","#808080"],["green","#008000"],["greenyellow","#adff2f"],["grey","#808080"],["honeydew","#f0fff0"],["hotpink","#ff69b4"],["indianred","#cd5c5c"],["indigo","#4b0082"],["ivory","#fffff0"],["khaki","#f0e68c"],["lavender","#e6e6fa"],["lavenderblush","#fff0f5"],["lawngreen","#7cfc00"],["lemonchiffon","#fffacd"],["lightblue","#add8e6"],["lightcoral","#f08080"],["lightcyan","#e0ffff"],["lightgoldenrodyellow","#fafad2"],["lightgray","#d3d3d3"],["lightgreen","#90ee90"],["lightgrey","#d3d3d3"],["lightpink","#ffb6c1"],["lightsalmon","#ffa07a"],["lightseagreen","#20b2aa"],["lightskyblue","#87cefa"],["lightslategray","#778899"],["lightslategrey","#778899"],["lightsteelblue","#b0c4de"],["lightyellow","#ffffe0"],["lime","#00ff00"],["limegreen","#32cd32"],["linen","#faf0e6"],["magenta","#ff00ff"],["maroon","#800000"],["mediumaquamarine","#66cdaa"],["mediumblue","#0000cd"],["mediumorchid","#ba55d3"],["mediumpurple","#9370db"],["mediumseagreen","#3cb371"],["mediumslateblue","#7b68ee"],["mediumspringgreen","#00fa9a"],["mediumturquoise","#48d1cc"],["mediumvioletred","#c71585"],["midnightblue","#191970"],["mintcream","#f5fffa"],["mistyrose","#ffe4e1"],["moccasin","#ffe4b5"],["navajowhite","#ffdead"],["navy","#000080"],["oldlace","#fdf5e6"],["olive","#808000"],["olivedrab","#6b8e23"],["orangered","#ff4500"],["orchid","#da70d6"],["palegoldenrod","#eee8aa"],["palegreen","#98fb98"],["paleturquoise","#afeeee"],["palevioletred","#db7093"],["papayawhip","#ffefd5"],["peachpuff","#ffdab9"],["peru","#cd853f"],["pink","#ffc0cb"],["plum","#dda0dd"],["powderblue","#b0e0e6"],["purple","#800080"],["red","#ff0000"],["rosybrown","#bc8f8f"],["royalblue","#4169e1"],["saddlebrown","#8b4513"],["salmon","#fa8072"],["sandybrown","#f4a460"],["seagreen","#2e8b57"],["seashell","#fff5ee"],["sienna","#a0522d"],["silver","#c0c0c0"],["skyblue","#87ceeb"],["slateblue","#6a5acd"],["slategray","#708090"],["slategrey","#708090"],["snow","#fffafa"],["springgreen","#00ff7f"],["steelblue","#4682b4"],["tan","#d2b48c"],["teal","#008080"],["thistle","#d8bfd8"],["tomato","#ff6347"],["transparent","#00000000"],["turquoise","#40e0d0"],["violet","#ee82ee"],["wheat","#f5deb3"],["white","#ffffff"],["whitesmoke","#f5f5f5"],["yellow","#ffff00"],["yellowgreen","#9acd32"]]);function re(e){for(const[t,n]of H.entries())if(n===e)return t}function u(e){if(typeof e!="string")throw new Error(`convertHextoRGB expects a string but got a ${typeof e}`);if(e.match(K))return{R:Number.parseInt(`${e[1]}${e[2]}`,16),G:Number.parseInt(`${e[3]}${e[4]}`,16),B:Number.parseInt(`${e[5]}${e[6]}`,16)};if(e.match(ee))return{R:Number.parseInt(`${e[1]}${e[1]}`,16),G:Number.parseInt(`${e[2]}${e[2]}`,16),B:Number.parseInt(`${e[3]}${e[3]}`,16)};if(e.match(Q))return{R:Number.parseInt(`${e[1]}${e[2]}`,16),G:Number.parseInt(`${e[3]}${e[4]}`,16),B:Number.parseInt(`${e[5]}${e[6]}`,16),A:Math.round(Number.parseInt(`${e[7]}${e[8]}`,16)/255*100)/100};if(e.match(te))return{R:Number.parseInt(`${e[1]}${e[1]}`,16),G:Number.parseInt(`${e[2]}${e[2]}`,16),B:Number.parseInt(`${e[3]}${e[3]}`,16),A:Math.round(Number.parseInt(`${e[4]}${e[4]}`,16)/255*100)/100};throw new Error(`convertHextoRGB expects an valid hexadecimal colour value but got ${e}`)}function Re(e){const t=u(e);return t.A?`rgba(${t.R},${t.G},${t.B},${t.A})`:`rgb(${t.R},${t.G},${t.B})`}function l(e){return H.get(e)}function R(e){const t=l(e);if(t)return u(t)}function q({R:e,G:t,B:n,A:o}){return`rgb(${e} ${t} ${n}${o?` / ${o}`:""})`}function I(e){const t=p(e);return re(t)}function $(e,t){if(!t||t.length<2)return e;const n=[];for(const r of t){const a=J(e,r);n.push([r,a])}return n.sort((r,a)=>r[1]-a[1])[0][0]}function $e(e,t){if(!t||t.length<2)return e;const n=i(e),o=t.map(a=>i(a)),r=$(n,o);return q(r)}function L(e){return!!e.match(ne)}function oe(e){return!!e.match(K)||!!e.match(Q)||!!e.match(te)||!!e.match(ee)}function ae(e){return H.has(e)}function ve(e,t){if(!t||t.length<2)return e;let n,o;const r=[];if(oe(e)&&(n=u(e),o="hex"),L(e)&&(n=i(e),o="cssRGB"),ae(e)&&(n=R(e),o="namedCSS"),!n)return;for(const s of t)oe(s)&&r.push(u(s)),L(s)&&r.push(i(s)),ae(s)&&r.push(R(s));if(r.length<2)return e;const a=$(n,r);return o==="hex"?p(a):o==="cssRGB"?q(a):I(a)}function Ge(e,t){if(!t||t.length<2)return e;const n=u(e),o=t.map(a=>u(a)),r=$(n,o);return p(r)}function Be(e,t){if(!t||t.length<2)return e;const n=R(e),r=t.map(s=>R(s)).filter(s=>s!==void 0);if(!n||r.length<2)return e;const a=$(n,r);return I(a)}function v({R:e,G:t,B:n},o){const r=o==="WCAG2.1",a=g(e,r),s=g(t,r),c=g(n,r);return .2126*a+.7152*s+.0722*c}function d(e,t){const n=u(e);return v(n,t)}function se(e,t){const n=Math.max(e,t),o=Math.min(e,t),r=(n+.05)/(o+.05);return Math.floor(r*1e3)/1e3}function W(e,t,n){const o=d(e,n),r=d(t,n);return se(o,r)}function ke(e,t,n){let o,r;if(e.startsWith("#"))o=e;else if(e.startsWith("rgb"))o=M(e);else{const a=l(e);if(a===void 0)throw new Error(`getContrastRatio expects valid CSS named colours.
+					${e} is not a valid CSS named colour.
+					See https://developer.mozilla.org/en-US/docs/Web/CSS/named-color`);o=a}if(t.startsWith("#"))r=t;else if(t.startsWith("rgb"))r=M(t);else{const a=l(t);if(a===void 0)throw new Error(`getContrastRatio expects valid CSS named colours.
+					${t} is not a valid CSS named colour.
+					See https://developer.mozilla.org/en-US/docs/Web/CSS/named-color`);r=a}return W(o,r,n)}function we(e,t,n){const o=i(e),r=i(t),a=v(o,n),s=v(r,n);return se(a,s)}function ye(e,t,n){const o=l(e),r=l(t);if(o===void 0||r===void 0)throw new Error(`getContrastRatioFromNamedCSSColour expects valid CSS named colours.
+			${e} or ${t} are not valid CSS named colours.
+			See https://developer.mozilla.org/en-US/docs/Web/CSS/named-color`);return W(o,r,n)}function x(e,t){const n=d(e,t)+.05,o=1.05/n,r=n/.05;return o>r}function ce(e,t){const n=l(e);if(n)return x(n,t);throw new Error(`${e} 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`)}function fe(e,t){const n=i(e),o=v(n,t),r=1.05/o,a=o/.05;return r>a}function Ne(e,t){try{return e.startsWith("#")?x(e,t):e.startsWith("rgb")?fe(e,t):ce(e,t)}catch{throw new Error(`${e} 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.`)}}const ie=(e,t)=>e>t?e/t:t/e,Me=({backgroundColour:e,optionOneColour:t,optionTwoColour:n},o)=>{const r=d(e,o)+.05,a=d(t,o)+.05,s=d(n,o)+.05,c=ie(a,r),f=ie(s,r);return c>f?t:n};export{J as RGBdistance,j as ciede2000,M as convertCSSRGBtoHex,i as convertCSSRGBtoRGB,Re as convertHextoCSSRGB,re as convertHextoNamedCSSColour,u as convertHextoRGB,l as convertNamedCSSColourtoHex,R as convertNamedCSSColourtoRGB,q as convertRGBtoCSSRGB,p as convertRGBtoHex,N as convertRGBtoLab,I as convertRGBtoNamedCSSColour,O as convertRGBtoXYZ,V as convertXYZtoLab,$e as findNearestCSSRGBColour,ve as findNearestColour,Ge as findNearestHexColour,Be as findNearestNamedCSSColour,$ as findNearestRGBColour,ke as getContrastRatio,we as getContrastRatioFromCSSRGB,W as getContrastRatioFromHex,ye as getContrastRatioFromNamedCSSColour,d as getSRGBLuminanceFromHex,v as getSRGBLuminanceFromRGB,ce as isCSSNamedDarkColour,L as isCSSRGBColour,fe as isCSSRGBDarkColour,Ne as isDarkColour,x as isHexDarkColour,Me as pickHexColourContrast};

package/dist/index.mjs

@@ -12,31 +12,27 @@ function deltaHue_d({ C1, C2, h1_d, h2_d }) {
   if (C1 * C2 === 0) {
     return 0;
   }
-  if (Math.abs(h2_d - h1_d) <= 180) {
-    return h2_d - h1_d;
+  const delta = h2_d - h1_d;
+  if (Math.abs(delta) <= 180) {
+    return delta;
   }
-  if (h2_d - h1_d > 180) {
-    return h2_d - h1_d - 360;
+  if (delta > 180) {
+    return delta - 360;
   }
-  if (h2_d - h1_d < -180) {
-    return h2_d - h1_d + 360;
-  }
-  return 0;
+  return delta + 360;
 }
 function meanHue_d({ C1, C2, h1_d, h2_d }) {
   if (C1 * C2 === 0) {
     return h2_d + h1_d;
   }
-  if (Math.abs(h1_d - h2_d) <= 180) {
+  const delta = Math.abs(h1_d - h2_d);
+  if (delta <= 180) {
     return (h2_d + h1_d) / 2;
   }
-  if (Math.abs(h1_d - h2_d) > 180 && h1_d + h2_d < 360) {
+  if (delta > 180 && h1_d + h2_d < 360) {
     return (h2_d + h1_d + 360) / 2;
   }
-  if (Math.abs(h1_d - h2_d) > 180 && h1_d + h2_d >= 360) {
-    return (h2_d + h1_d - 360) / 2;
-  }
-  return 0;
+  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));
@@ -356,7 +352,7 @@ function convertHextoRGB(hex) {
       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: Number.parseInt(`${hex[7]}${hex[8]}`, 16) / 255
+      A: Math.round(Number.parseInt(`${hex[7]}${hex[8]}`, 16) / 255 * 100) / 100
     };
   }
   if (hex.match(shortAlphaHexRegex)) {
@@ -364,13 +360,20 @@ function convertHextoRGB(hex) {
       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: Number.parseInt(`${hex[4]}${hex[4]}`, 16) / 255
+      A: Math.round(Number.parseInt(`${hex[4]}${hex[4]}`, 16) / 255 * 100) / 100
     };
   }
   throw new Error(
     `convertHextoRGB expects an valid hexadecimal colour value but got ${hex}`
   );
 }
+function convertHextoCSSRGB(hex) {
+  const rgb = convertHextoRGB(hex);
+  if (rgb.A) {
+    return `rgba(${rgb.R},${rgb.G},${rgb.B},${rgb.A})`;
+  }
+  return `rgb(${rgb.R},${rgb.G},${rgb.B})`;
+}
 function convertNamedCSSColourtoHex(name) {
   return namedCSSColours.get(name);
 }
@@ -466,10 +469,7 @@ function findNearestColour(colour, palette) {
   if (colourType === "cssRGB") {
     return convertRGBtoCSSRGB(nearest);
   }
-  if (colourType === "namedCSS") {
-    return convertRGBtoNamedCSSColour(nearest);
-  }
-  return;
+  return convertRGBtoNamedCSSColour(nearest);
 }
 function findNearestHexColour(colour, palette) {
   if (!palette || palette.length < 2) {
@@ -516,14 +516,69 @@ function getSRGBLuminanceFromHex(colour, standard) {
   const rgbColor = convertHextoRGB(colour);
   return getSRGBLuminanceFromRGB(rgbColor, standard);
 }
-function getContrastRatioFromHex(colour1, colour2, standard) {
-  const luminance1 = getSRGBLuminanceFromHex(colour1, standard);
-  const luminance2 = getSRGBLuminanceFromHex(colour2, standard);
+function calculateContrastRatio(luminance1, luminance2) {
   const lighter = Math.max(luminance1, luminance2);
   const darker = Math.min(luminance1, luminance2);
   const ratio = (lighter + 0.05) / (darker + 0.05);
   return Math.floor(ratio * 1e3) / 1e3;
 }
+function getContrastRatioFromHex(colour1, colour2, standard) {
+  const luminance1 = getSRGBLuminanceFromHex(colour1, standard);
+  const luminance2 = getSRGBLuminanceFromHex(colour2, standard);
+  return calculateContrastRatio(luminance1, luminance2);
+}
+function getContrastRatio(colour1, colour2, standard) {
+  let hexColour1;
+  let hexColour2;
+  if (colour1.startsWith("#")) {
+    hexColour1 = colour1;
+  } else if (colour1.startsWith("rgb")) {
+    hexColour1 = convertCSSRGBtoHex(colour1);
+  } else {
+    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`
+      );
+    }
+    hexColour1 = _hexColour1;
+  }
+  if (colour2.startsWith("#")) {
+    hexColour2 = colour2;
+  } else if (colour2.startsWith("rgb")) {
+    hexColour2 = convertCSSRGBtoHex(colour2);
+  } 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`);
+    }
+    hexColour2 = _hexColour2;
+  }
+  return getContrastRatioFromHex(hexColour1, hexColour2, standard);
+}
+function getContrastRatioFromCSSRGB(colour1, colour2, standard) {
+  const rgbColour1 = convertCSSRGBtoRGB(colour1);
+  const rgbColour2 = convertCSSRGBtoRGB(colour2);
+  const luminance1 = getSRGBLuminanceFromRGB(rgbColour1, standard);
+  const luminance2 = getSRGBLuminanceFromRGB(rgbColour2, standard);
+  return calculateContrastRatio(luminance1, luminance2);
+}
+function getContrastRatioFromNamedCSSColour(colour1, colour2, standard) {
+  const hexColour1 = convertNamedCSSColourtoHex(colour1);
+  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`
+    );
+  }
+  return getContrastRatioFromHex(hexColour1, hexColour2, standard);
+}
 function isHexDarkColour(colour, standard) {
   const colourLuminance = getSRGBLuminanceFromHex(colour, standard) + 0.05;
   const whiteContrast = 1.05 / colourLuminance;
@@ -589,6 +644,7 @@ export {
   ciede2000,
   convertCSSRGBtoHex,
   convertCSSRGBtoRGB,
+  convertHextoCSSRGB,
   convertHextoNamedCSSColour,
   convertHextoRGB,
   convertNamedCSSColourtoHex,
@@ -604,7 +660,10 @@ export {
   findNearestHexColour,
   findNearestNamedCSSColour,
   findNearestRGBColour,
+  getContrastRatio,
+  getContrastRatioFromCSSRGB,
   getContrastRatioFromHex,
+  getContrastRatioFromNamedCSSColour,
   getSRGBLuminanceFromHex,
   getSRGBLuminanceFromRGB,
   isCSSNamedDarkColour,

package/dist/util/calculateContrastRatio.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Calculate the contrast ratio between two colours
+ * @param luminance1 The luminance of the first colour
+ * @param luminance2 The luminance of the second colour
+ * @returns The contrast ratio between the two colours truncated to 3 decimal places
+ */
+export declare function calculateContrastRatio(luminance1: number, luminance2: number): number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sardine/colour",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "It does things to colours",
   "type": "module",
   "module": "./dist/index.mjs",
@@ -53,7 +53,7 @@
     "@vitest/coverage-v8": "^2.0.0",
     "lefthook": "^1.8.1",
     "typescript": "^5.4.5",
-    "vite": "^5.2.11",
+    "vite": "^6.0.0",
     "vitest": "^2.0.0"
   }
 }