@sardine/colour 2.2.1 → 2.4.0

package/README.md

@@ -1,6 +1,3 @@
-[![Test Coverage](https://api.codeclimate.com/v1/badges/e8d765e149b42c6bac15/test_coverage)](https://codeclimate.com/github/sardinedev/colour/test_coverage)
-[![npm version](https://badge.fury.io/js/%40sardine%2Fcolour.svg)](https://badge.fury.io/js/%40sardine%2Fcolour)
-
 <img alt="Sardine logo" src="https://colour.sardine.dev/assets/icons/logo.svg" width="300">
 
 # @sardine/colour

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/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));
@@ -178,6 +174,51 @@ 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
+    };
+  }
+  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})`;
+}
 const namedCSSColours = /* @__PURE__ */ new Map([
   ["aliceblue", "#f0f8ff"],
   ["antiquewhite", "#faebd7"],
@@ -335,44 +376,6 @@ function convertHextoNamedCSSColour(colour) {
   }
   return void 0;
 }
-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: Number.parseInt(`${hex[7]}${hex[8]}`, 16) / 255
-    };
-  }
-  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: Number.parseInt(`${hex[4]}${hex[4]}`, 16) / 255
-    };
-  }
-  throw new Error(
-    `convertHextoRGB expects an valid hexadecimal colour value but got ${hex}`
-  );
-}
 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) {
@@ -645,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;
@@ -670,5 +671,7 @@ exports.isCSSNamedDarkColour = isCSSNamedDarkColour;
 exports.isCSSRGBColour = isCSSRGBColour;
 exports.isCSSRGBDarkColour = isCSSRGBDarkColour;
 exports.isDarkColour = isDarkColour;
+exports.isHexColour = isHexColour;
 exports.isHexDarkColour = isHexDarkColour;
+exports.isNamedCSSColour = isNamedCSSColour;
 exports.pickHexColourContrast = pickHexColourContrast;

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { RGBdistance } from "./RGBdistance";
 export { ciede2000 } from "./CIEDE2000";
 export { convertCSSRGBtoHex } from "./convertCSSRGBtoHex";
 export { convertCSSRGBtoRGB } from "./convertCSSRGBtoRGB";
+export { convertHextoCSSRGB } from "./convertHextoCSSRGB";
 export { convertHextoNamedCSSColour } from "./convertHextoNamedCSSColour";
 export { convertHextoRGB } from "./convertHextoRGB";
 export { convertNamedCSSColourtoHex } from "./convertNamedCSSColourtoHex";
@@ -27,5 +28,7 @@ export { isCSSNamedDarkColour } from "./isCSSNameDarkColour";
 export { isCSSRGBColour } from "./assertions";
 export { isCSSRGBDarkColour } from "./isCSSRGBDarkColour";
 export { isDarkColour } from "./isDarkColour";
+export { isHexColour } from "./assertions";
 export { isHexDarkColour } from "./isHexDarkColour";
+export { isNamedCSSColour } from "./assertions";
 export { pickHexColourContrast } from "./pickHexColourContrast";

package/dist/index.min.js

@@ -1,7 +1,7 @@
-"use strict";function U(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 he({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 Se({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 b=e=>e*(Math.PI/180),j=e=>Math.sqrt(e**7/(e**7+25**7));function g(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 y(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 pe(e,t,n){return Math.min(Math.max(e,t),n)}function O(e,t){const n=e.L,r=e.a,o=e.b,a=t.L,s=t.a,f=t.b,c=1,m=1,$=1,C=Math.sqrt(r**2+o**2),h=Math.sqrt(s**2+f**2),ue=a-n,le=(C+h)/2,P=.5*(1-j(le)),F=r*(1+P),A=s*(1+P),B=Math.sqrt(F**2+o**2),k=Math.sqrt(A**2+f**2),w=(B+k)/2,E=k-B,Y=U(o,F),X=U(f,A),de=he({C1:C,C2:h,h1_d:Y,h2_d:X}),Z=2*Math.sqrt(B*k)*Math.sin(b(de)/2),S=Se({C1:C,C2:h,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,T=1+.015*w*me,ge=30*Math.exp(-(((S-275)/25)**2)),Ce=-2*j(w)*Math.sin(b(ge*2));return Math.sqrt((ue/(c*be))**2+(E/(m*z))**2+(Z/($*T))**2+Ce*(E/(m*z))*(Z/($*T)))}function V(e){const{R:t,G:n,B:r}=e,o=g(t)*100,a=g(n)*100,s=g(r)*100,f=o*.4124+a*.3576+s*.1805,c=o*.2126+a*.7152+s*.0722,m=o*.0193+a*.1192+s*.9505;return{X:f,Y:c,Z:m}}function J(e){const{X:t,Y:n,Z:r}=e,o=t/95.047,a=n/100,s=r/108.883,f=y(o),c=y(a),m=y(s),$=116*c-16,C=500*(f-c),h=200*(c-m);return{L:$,a:C,b:h}}function N(e){const t=V(e);return J(t)}const K=(e,t)=>{const n=N(e),r=N(t);return O(n,r)},Q=/^#[a-fA-F0-9]{6}$/,_=/^#[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=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=>pe(a,0,255).toString(16).padStart(2,"0");return`#${o(e)}${o(t)}${o(n)}${r?o(Math.round(r*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(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)};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(_))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(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:Number.parseInt(`${e[4]}${e[4]}`,16)/255};throw new Error(`convertHextoRGB expects an valid hexadecimal colour value but got ${e}`)}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:r}){return`rgb(${e} ${t} ${n}${r?` / ${r}`:""})`}function I(e){const t=p(e);return re(t)}function v(e,t){if(!t||t.length<2)return e;const n=[];for(const o of t){const a=K(e,o);n.push([o,a])}return n.sort((o,a)=>o[1]-a[1])[0][0]}function Re(e,t){if(!t||t.length<2)return e;const n=i(e),r=t.map(a=>i(a)),o=v(n,r);return q(o)}function L(e){return!!e.match(ne)}function oe(e){return!!e.match(Q)||!!e.match(_)||!!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,r;const o=[];if(oe(e)&&(n=u(e),r="hex"),L(e)&&(n=i(e),r="cssRGB"),ae(e)&&(n=R(e),r="namedCSS"),!n)return;for(const s of t)oe(s)&&o.push(u(s)),L(s)&&o.push(i(s)),ae(s)&&o.push(R(s));if(o.length<2)return e;const a=v(n,o);if(r==="hex")return p(a);if(r==="cssRGB")return q(a);if(r==="namedCSS")return I(a)}function Ge(e,t){if(!t||t.length<2)return e;const n=u(e),r=t.map(a=>u(a)),o=v(n,r);return p(o)}function $e(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=v(n,o);return I(a)}function G({R:e,G:t,B:n},r){const o=r==="WCAG2.1",a=g(e,o),s=g(t,o),f=g(n,o);return .2126*a+.7152*s+.0722*f}function d(e,t){const n=u(e);return G(n,t)}function se(e,t){const n=Math.max(e,t),r=Math.min(e,t),o=(n+.05)/(r+.05);return Math.floor(o*1e3)/1e3}function W(e,t,n){const r=d(e,n),o=d(t,n);return se(r,o)}function Be(e,t,n){let r,o;if(e.startsWith("#"))r=e;else if(e.startsWith("rgb"))r=M(e);else{const a=l(e);if(a===void 0)throw new Error(`getContrastRatio expects valid CSS named colours.
+"use strict";function j(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),O=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 V(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,F=.5*(1-O(le)),E=o*(1+F),Y=s*(1+F),B=Math.sqrt(E**2+r**2),k=Math.sqrt(Y**2+c**2),w=(B+k)/2,X=k-B,Z=j(r,E),D=j(c,Y),de=Ce({C1:h,C2:C,h1_d:Z,h2_d:D}),z=2*Math.sqrt(B*k)*Math.sin(b(de)/2),S=Se({C1:h,C2:C,h1_d:Z,h2_d: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*(_-50)**2/Math.sqrt(20+(_-50)**2),T=.045*w+1,U=1+.015*w*me,ge=30*Math.exp(-(((S-275)/25)**2)),he=-2*O(w)*Math.sin(b(ge*2));return Math.sqrt((ue/(f*be))**2+(X/(m*T))**2+(z/(G*U))**2+he*(X/(m*T))*(z/(G*U)))}function J(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 K(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=J(e);return K(t)}const Q=(e,t)=>{const n=N(e),o=N(t);return V(n,o)},ee=/^#[a-fA-F0-9]{6}$/,te=/^#[a-fA-F0-9]{8}$/,ne=/^#[a-fA-F0-9]{3}$/,re=/^#[a-fA-F0-9]{4}$/,oe=/^rgba*\(\s*([-+]?\d+)\s*(?:,)?\s*([-+]?\d+)\s*(?:,)?\s*([-+]?\d+)\s*(?:,*|\/*)\s*([-+]?\d*[.]?\d+[%]?)*\)$/i;function i(e){const t=e.match(oe);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)}function u(e){if(typeof e!="string")throw new Error(`convertHextoRGB expects a string but got a ${typeof e}`);if(e.match(ee))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(ne))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(te))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(re))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})`}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 ae(e){for(const[t,n]of H.entries())if(n===e)return t}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 ae(t)}function $(e,t){if(!t||t.length<2)return e;const n=[];for(const r of t){const a=Q(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(oe)}function W(e){return!!e.match(ee)||!!e.match(te)||!!e.match(re)||!!e.match(ne)}function x(e){return H.has(e)}function ve(e,t){if(!t||t.length<2)return e;let n,o;const r=[];if(W(e)&&(n=u(e),o="hex"),L(e)&&(n=i(e),o="cssRGB"),x(e)&&(n=R(e),o="namedCSS"),!n)return;for(const s of t)W(s)&&r.push(u(s)),L(s)&&r.push(i(s)),x(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 P(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`);r=a}if(t.startsWith("#"))o=t;else if(t.startsWith("rgb"))o=M(t);else{const a=l(t);if(a===void 0)throw new Error(`getContrastRatio expects valid CSS named colours.
+					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`);o=a}return W(r,o,n)}function ke(e,t,n){const r=i(e),o=i(t),a=G(r,n),s=G(o,n);return se(a,s)}function we(e,t,n){const r=l(e),o=l(t);if(r===void 0||o===void 0)throw new Error(`getContrastRatioFromNamedCSSColour expects valid CSS named colours.
+					See https://developer.mozilla.org/en-US/docs/Web/CSS/named-color`);r=a}return P(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(r,o,n)}function x(e,t){const n=d(e,t)+.05,r=1.05/n,o=n/.05;return r>o}function fe(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 ce(e,t){const n=i(e),r=G(n,t),o=1.05/r,a=r/.05;return o>a}function ye(e,t){try{return e.startsWith("#")?x(e,t):e.startsWith("rgb")?ce(e,t):fe(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,Ne=({backgroundColour:e,optionOneColour:t,optionTwoColour:n},r)=>{const o=d(e,r)+.05,a=d(t,r)+.05,s=d(n,r)+.05,f=ie(a,o),c=ie(s,o);return f>c?t:n};export{K as RGBdistance,O as ciede2000,M as convertCSSRGBtoHex,i as convertCSSRGBtoRGB,re as convertHextoNamedCSSColour,u as convertHextoRGB,l as convertNamedCSSColourtoHex,R as convertNamedCSSColourtoRGB,q as convertRGBtoCSSRGB,p as convertRGBtoHex,N as convertRGBtoLab,I as convertRGBtoNamedCSSColour,V as convertRGBtoXYZ,J as convertXYZtoLab,Re as findNearestCSSRGBColour,ve as findNearestColour,Ge as findNearestHexColour,$e as findNearestNamedCSSColour,v as findNearestRGBColour,Be as getContrastRatio,ke as getContrastRatioFromCSSRGB,W as getContrastRatioFromHex,we as getContrastRatioFromNamedCSSColour,d as getSRGBLuminanceFromHex,G as getSRGBLuminanceFromRGB,fe as isCSSNamedDarkColour,L as isCSSRGBColour,ce as isCSSRGBDarkColour,ye as isDarkColour,x as isHexDarkColour,Ne as pickHexColourContrast};
+			See https://developer.mozilla.org/en-US/docs/Web/CSS/named-color`);return P(o,r,n)}function A(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 A(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("#")?A(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{Q as RGBdistance,V as ciede2000,M as convertCSSRGBtoHex,i as convertCSSRGBtoRGB,Re as convertHextoCSSRGB,ae as convertHextoNamedCSSColour,u as convertHextoRGB,l as convertNamedCSSColourtoHex,R as convertNamedCSSColourtoRGB,q as convertRGBtoCSSRGB,p as convertRGBtoHex,N as convertRGBtoLab,I as convertRGBtoNamedCSSColour,J as convertRGBtoXYZ,K as convertXYZtoLab,$e as findNearestCSSRGBColour,ve as findNearestColour,Ge as findNearestHexColour,Be as findNearestNamedCSSColour,$ as findNearestRGBColour,ke as getContrastRatio,we as getContrastRatioFromCSSRGB,P as getContrastRatioFromHex,ye as getContrastRatioFromNamedCSSColour,d as getSRGBLuminanceFromHex,v as getSRGBLuminanceFromRGB,ce as isCSSNamedDarkColour,L as isCSSRGBColour,fe as isCSSRGBDarkColour,Ne as isDarkColour,W as isHexColour,A as isHexDarkColour,x as isNamedCSSColour,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));
@@ -176,6 +172,51 @@ 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
+    };
+  }
+  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})`;
+}
 const namedCSSColours = /* @__PURE__ */ new Map([
   ["aliceblue", "#f0f8ff"],
   ["antiquewhite", "#faebd7"],
@@ -333,44 +374,6 @@ function convertHextoNamedCSSColour(colour) {
   }
   return void 0;
 }
-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: Number.parseInt(`${hex[7]}${hex[8]}`, 16) / 255
-    };
-  }
-  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: Number.parseInt(`${hex[4]}${hex[4]}`, 16) / 255
-    };
-  }
-  throw new Error(
-    `convertHextoRGB expects an valid hexadecimal colour value but got ${hex}`
-  );
-}
 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) {
@@ -644,6 +644,7 @@ export {
   ciede2000,
   convertCSSRGBtoHex,
   convertCSSRGBtoRGB,
+  convertHextoCSSRGB,
   convertHextoNamedCSSColour,
   convertHextoRGB,
   convertNamedCSSColourtoHex,
@@ -669,6 +670,8 @@ export {
   isCSSRGBColour,
   isCSSRGBDarkColour,
   isDarkColour,
+  isHexColour,
   isHexDarkColour,
+  isNamedCSSColour,
   pickHexColourContrast
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sardine/colour",
-  "version": "2.2.1",
+  "version": "2.4.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"
   }
 }