@design-edito/tools 0.4.4 → 0.4.6

package/agnostic/colors/convert/index.test.js

@@ -0,0 +1,98 @@
+import { describe, it, expect } from 'vitest';
+import { toRgb, toHsl, toHsb, toCmyk, toHex, toLab, toLch, toXyz, viaRgb } from './index.js';
+describe('toRgb', () => {
+    it('preserves RGB colors', () => {
+        const color = { r: 255, g: 128, b: 64 };
+        expect(toRgb(color)).toEqual({ r: 255, g: 128, b: 64 });
+    });
+    it('converts hex to RGB', () => {
+        const result = toRgb('#ff8040');
+        expect(result).toMatchObject({ r: 255, g: 128, b: 64 });
+    });
+    it('converts HSL to RGB', () => {
+        const result = toRgb({ h: 0, s: 100, l: 50 });
+        expect(result).toMatchObject({ r: 255, g: 0, b: 0 });
+    });
+});
+describe('toHsl', () => {
+    it('preserves HSL colors', () => {
+        const color = { h: 180, s: 50, l: 75 };
+        expect(toHsl(color)).toEqual({ h: 180, s: 50, l: 75 });
+    });
+    it('converts RGB to HSL', () => {
+        const result = toHsl({ r: 255, g: 0, b: 0 });
+        expect(result).toMatchObject({ h: 0, s: 100, l: 50 });
+    });
+});
+describe('toHsb', () => {
+    it('preserves HSB colors', () => {
+        const color = { h: 180, s: 50, b: 75 };
+        expect(toHsb(color)).toEqual({ h: 180, s: 50, b: 75 });
+    });
+    it('converts RGB to HSB', () => {
+        const result = toHsb({ r: 255, g: 0, b: 0 });
+        expect(result).toMatchObject({ h: 0, s: 100, b: 100 });
+    });
+});
+describe('toCmyk', () => {
+    it('preserves CMYK colors', () => {
+        const color = { c: 50, m: 50, y: 50, k: 50 };
+        expect(toCmyk(color)).toEqual({ c: 50, m: 50, y: 50, k: 50 });
+    });
+    it('converts RGB to CMYK', () => {
+        const result = toCmyk({ r: 0, g: 0, b: 0 });
+        expect(result).toMatchObject({ k: 100 });
+    });
+});
+describe('toHex', () => {
+    it('preserves hex colors', () => {
+        expect(toHex('#ff0000')).toBe('#ff0000');
+    });
+    it('converts RGB to hex', () => {
+        const result = toHex({ r: 255, g: 0, b: 0 });
+        expect(result).toBe('#ff0000ff');
+    });
+});
+describe('toLab', () => {
+    it('preserves Lab colors', () => {
+        const color = { l: 50, a: 0, b: 0 };
+        expect(toLab(color)).toMatchObject({ l: 50, a: 0, b: 0 });
+    });
+    it('converts RGB to Lab', () => {
+        const result = toLab({ r: 255, g: 255, b: 255 });
+        expect(result.l).toBeGreaterThan(90);
+    });
+});
+describe('toLch', () => {
+    it('preserves LCH colors', () => {
+        const color = { l: 50, c: 50, h: 180 };
+        expect(toLch(color)).toMatchObject({ l: 50, c: 50, h: 180 });
+    });
+    it('converts RGB to LCH', () => {
+        const result = toLch({ r: 255, g: 0, b: 0 });
+        expect(result).toHaveProperty('l');
+        expect(result).toHaveProperty('c');
+        expect(result).toHaveProperty('h');
+    });
+});
+describe('toXyz', () => {
+    it('preserves XYZ colors', () => {
+        const color = { x: 50, y: 50, z: 50 };
+        expect(toXyz(color)).toMatchObject({ x: 50, y: 50, z: 50 });
+    });
+    it('converts RGB to XYZ', () => {
+        const result = toXyz({ r: 255, g: 255, b: 255 });
+        expect(result).toHaveProperty('x');
+        expect(result).toHaveProperty('y');
+        expect(result).toHaveProperty('z');
+    });
+});
+describe('viaRgb', () => {
+    it('transforms color and preserves format', () => {
+        const hslColor = { h: 0, s: 100, l: 50 };
+        const result = viaRgb(hslColor, rgb => ({ ...rgb, r: 128 }));
+        expect(result).toHaveProperty('h');
+        expect(result).toHaveProperty('s');
+        expect(result).toHaveProperty('l');
+    });
+});

package/agnostic/colors/cssColorsMap.js

@@ -0,0 +1,153 @@
+/**
+ * Map of CSS named colors to their corresponding RGBA values.
+ */
+export const cssColors = {
+    aliceblue: { r: 240, g: 248, b: 255 },
+    antiquewhite: { r: 250, g: 235, b: 215 },
+    aqua: { r: 0, g: 255, b: 255 },
+    aquamarine: { r: 127, g: 255, b: 212 },
+    azure: { r: 240, g: 255, b: 255 },
+    beige: { r: 245, g: 245, b: 220 },
+    bisque: { r: 255, g: 228, b: 196 },
+    black: { r: 0, g: 0, b: 0 },
+    blanchedalmond: { r: 255, g: 235, b: 205 },
+    blue: { r: 0, g: 0, b: 255 },
+    blueviolet: { r: 138, g: 43, b: 226 },
+    brown: { r: 165, g: 42, b: 42 },
+    burlywood: { r: 222, g: 184, b: 135 },
+    cadetblue: { r: 95, g: 158, b: 160 },
+    chartreuse: { r: 127, g: 255, b: 0 },
+    chocolate: { r: 210, g: 105, b: 30 },
+    coral: { r: 255, g: 127, b: 80 },
+    cornflowerblue: { r: 100, g: 149, b: 237 },
+    cornsilk: { r: 255, g: 248, b: 220 },
+    crimson: { r: 220, g: 20, b: 60 },
+    cyan: { r: 0, g: 255, b: 255 },
+    darkblue: { r: 0, g: 0, b: 139 },
+    darkcyan: { r: 0, g: 139, b: 139 },
+    darkgoldenrod: { r: 184, g: 134, b: 11 },
+    darkgray: { r: 169, g: 169, b: 169 },
+    darkgreen: { r: 0, g: 100, b: 0 },
+    darkgrey: { r: 169, g: 169, b: 169 },
+    darkkhaki: { r: 189, g: 183, b: 107 },
+    darkmagenta: { r: 139, g: 0, b: 139 },
+    darkolivegreen: { r: 85, g: 107, b: 47 },
+    darkorange: { r: 255, g: 140, b: 0 },
+    darkorchid: { r: 153, g: 50, b: 204 },
+    darkred: { r: 139, g: 0, b: 0 },
+    darksalmon: { r: 233, g: 150, b: 122 },
+    darkseagreen: { r: 143, g: 188, b: 143 },
+    darkslateblue: { r: 72, g: 61, b: 139 },
+    darkslategray: { r: 47, g: 79, b: 79 },
+    darkslategrey: { r: 47, g: 79, b: 79 },
+    darkturquoise: { r: 0, g: 206, b: 209 },
+    darkviolet: { r: 148, g: 0, b: 211 },
+    deeppink: { r: 255, g: 20, b: 147 },
+    deepskyblue: { r: 0, g: 191, b: 255 },
+    dimgray: { r: 105, g: 105, b: 105 },
+    dimgrey: { r: 105, g: 105, b: 105 },
+    dodgerblue: { r: 30, g: 144, b: 255 },
+    firebrick: { r: 178, g: 34, b: 34 },
+    floralwhite: { r: 255, g: 250, b: 240 },
+    forestgreen: { r: 34, g: 139, b: 34 },
+    fuchsia: { r: 255, g: 0, b: 255 },
+    gainsboro: { r: 220, g: 220, b: 220 },
+    ghostwhite: { r: 248, g: 248, b: 255 },
+    gold: { r: 255, g: 215, b: 0 },
+    goldenrod: { r: 218, g: 165, b: 32 },
+    gray: { r: 128, g: 128, b: 128 },
+    green: { r: 0, g: 128, b: 0 },
+    greenyellow: { r: 173, g: 255, b: 47 },
+    grey: { r: 128, g: 128, b: 128 },
+    honeydew: { r: 240, g: 255, b: 240 },
+    hotpink: { r: 255, g: 105, b: 180 },
+    indianred: { r: 205, g: 92, b: 92 },
+    indigo: { r: 75, g: 0, b: 130 },
+    ivory: { r: 255, g: 255, b: 240 },
+    khaki: { r: 240, g: 230, b: 140 },
+    lavender: { r: 230, g: 230, b: 250 },
+    lavenderblush: { r: 255, g: 240, b: 245 },
+    lawngreen: { r: 124, g: 252, b: 0 },
+    lemonchiffon: { r: 255, g: 250, b: 205 },
+    lightblue: { r: 173, g: 216, b: 230 },
+    lightcoral: { r: 240, g: 128, b: 128 },
+    lightcyan: { r: 224, g: 255, b: 255 },
+    lightgoldenrodyellow: { r: 250, g: 250, b: 210 },
+    lightgray: { r: 211, g: 211, b: 211 },
+    lightgreen: { r: 144, g: 238, b: 144 },
+    lightgrey: { r: 211, g: 211, b: 211 },
+    lightpink: { r: 255, g: 182, b: 193 },
+    lightsalmon: { r: 255, g: 160, b: 122 },
+    lightseagreen: { r: 32, g: 178, b: 170 },
+    lightskyblue: { r: 135, g: 206, b: 250 },
+    lightslategray: { r: 119, g: 136, b: 153 },
+    lightslategrey: { r: 119, g: 136, b: 153 },
+    lightsteelblue: { r: 176, g: 196, b: 222 },
+    lightyellow: { r: 255, g: 255, b: 224 },
+    lime: { r: 0, g: 255, b: 0 },
+    limegreen: { r: 50, g: 205, b: 50 },
+    linen: { r: 250, g: 240, b: 230 },
+    magenta: { r: 255, g: 0, b: 255 },
+    maroon: { r: 128, g: 0, b: 0 },
+    mediumaquamarine: { r: 102, g: 205, b: 170 },
+    mediumblue: { r: 0, g: 0, b: 205 },
+    mediumorchid: { r: 186, g: 85, b: 211 },
+    mediumpurple: { r: 147, g: 112, b: 219 },
+    mediumseagreen: { r: 60, g: 179, b: 113 },
+    mediumslateblue: { r: 123, g: 104, b: 238 },
+    mediumspringgreen: { r: 0, g: 250, b: 154 },
+    mediumturquoise: { r: 72, g: 209, b: 204 },
+    mediumvioletred: { r: 199, g: 21, b: 133 },
+    midnightblue: { r: 25, g: 25, b: 112 },
+    mintcream: { r: 245, g: 255, b: 250 },
+    mistyrose: { r: 255, g: 228, b: 225 },
+    moccasin: { r: 255, g: 228, b: 181 },
+    navajowhite: { r: 255, g: 222, b: 173 },
+    navy: { r: 0, g: 0, b: 128 },
+    oldlace: { r: 253, g: 245, b: 230 },
+    olive: { r: 128, g: 128, b: 0 },
+    olivedrab: { r: 107, g: 142, b: 35 },
+    orange: { r: 255, g: 165, b: 0 },
+    orangered: { r: 255, g: 69, b: 0 },
+    orchid: { r: 218, g: 112, b: 214 },
+    palegoldenrod: { r: 238, g: 232, b: 170 },
+    palegreen: { r: 152, g: 251, b: 152 },
+    paleturquoise: { r: 175, g: 238, b: 238 },
+    palevioletred: { r: 219, g: 112, b: 147 },
+    papayawhip: { r: 255, g: 239, b: 213 },
+    peachpuff: { r: 255, g: 218, b: 185 },
+    peru: { r: 205, g: 133, b: 63 },
+    pink: { r: 255, g: 192, b: 203 },
+    plum: { r: 221, g: 160, b: 221 },
+    powderblue: { r: 176, g: 224, b: 230 },
+    purple: { r: 128, g: 0, b: 128 },
+    rebeccapurple: { r: 102, g: 51, b: 153 },
+    red: { r: 255, g: 0, b: 0 },
+    rosybrown: { r: 188, g: 143, b: 143 },
+    royalblue: { r: 65, g: 105, b: 225 },
+    saddlebrown: { r: 139, g: 69, b: 19 },
+    salmon: { r: 250, g: 128, b: 114 },
+    sandybrown: { r: 244, g: 164, b: 96 },
+    seagreen: { r: 46, g: 139, b: 87 },
+    seashell: { r: 255, g: 245, b: 238 },
+    sienna: { r: 160, g: 82, b: 45 },
+    silver: { r: 192, g: 192, b: 192 },
+    skyblue: { r: 135, g: 206, b: 235 },
+    slateblue: { r: 106, g: 90, b: 205 },
+    slategray: { r: 112, g: 128, b: 144 },
+    slategrey: { r: 112, g: 128, b: 144 },
+    snow: { r: 255, g: 250, b: 250 },
+    springgreen: { r: 0, g: 255, b: 127 },
+    steelblue: { r: 70, g: 130, b: 180 },
+    tan: { r: 210, g: 180, b: 140 },
+    teal: { r: 0, g: 128, b: 128 },
+    thistle: { r: 216, g: 191, b: 216 },
+    tomato: { r: 255, g: 99, b: 71 },
+    turquoise: { r: 64, g: 224, b: 208 },
+    violet: { r: 238, g: 130, b: 238 },
+    wheat: { r: 245, g: 222, b: 179 },
+    white: { r: 255, g: 255, b: 255 },
+    whitesmoke: { r: 245, g: 245, b: 245 },
+    yellow: { r: 255, g: 255, b: 0 },
+    yellowgreen: { r: 154, g: 205, b: 50 }
+};

package/agnostic/colors/distance/index.js

@@ -1,56 +1,68 @@
-import {
-  toLab
-} from "../../../chunks/chunk-CVMYA5XK.js";
-import "../../../chunks/chunk-OBSTP7YR.js";
-import "../../../chunks/chunk-HQLRJ7XW.js";
-import "../../../chunks/chunk-DNIOWD7K.js";
-import "../../../chunks/chunk-PUQUSA6S.js";
-import "../../../chunks/chunk-OSAXBA7G.js";
-import "../../../chunks/chunk-WSFCRVEQ.js";
-
-// src/agnostic/colors/distance/index.ts
+import { toLab } from '../convert/index.js';
 function distanceCiede2000(c1, c2) {
-  const deg2rad = (deg) => Math.PI / 180 * deg;
-  const rad2deg = (rad) => 180 / Math.PI * rad;
-  const C1 = Math.sqrt(c1.a * c1.a + c1.b * c1.b);
-  const C2 = Math.sqrt(c2.a * c2.a + c2.b * c2.b);
-  const meanC = (C1 + C2) / 2;
-  const meanC7 = Math.pow(meanC, 7);
-  const G = 0.5 * (1 - Math.sqrt(meanC7 / (meanC7 + Math.pow(25, 7))));
-  const a1p = (1 + G) * c1.a;
-  const a2p = (1 + G) * c2.a;
-  const C1p = Math.sqrt(a1p * a1p + c1.b * c1.b);
-  const C2p = Math.sqrt(a2p * a2p + c2.b * c2.b);
-  const h1p = Math.atan2(c1.b, a1p);
-  const h2p = Math.atan2(c2.b, a2p);
-  const dLp = c2.l - c1.l;
-  const dCp = C2p - C1p;
-  let dhp = h2p - h1p;
-  if (dhp > Math.PI) dhp -= 2 * Math.PI;
-  if (dhp < -Math.PI) dhp += 2 * Math.PI;
-  const dHp = 2 * Math.sqrt(C1p * C2p) * Math.sin(dhp / 2);
-  const meanLp = (c1.l + c2.l) / 2;
-  let meanHp = (h1p + h2p) / 2;
-  if (Math.abs(h1p - h2p) > Math.PI) {
-    meanHp += Math.PI;
-  }
-  const T = 1 - 0.17 * Math.cos(meanHp - deg2rad(30)) + 0.24 * Math.cos(2 * meanHp) + 0.32 * Math.cos(3 * meanHp + deg2rad(6)) - 0.2 * Math.cos(4 * meanHp - deg2rad(63));
-  const SL = 1 + 0.015 * (meanLp - 50) * (meanLp - 50) / Math.sqrt(20 + (meanLp - 50) * (meanLp - 50));
-  const SC = 1 + 0.045 * meanC;
-  const SH = 1 + 0.015 * meanC * T;
-  const deltaTheta = deg2rad(60) * Math.exp(-((rad2deg(meanHp) - 275) / 25) * ((rad2deg(meanHp) - 275) / 25));
-  const RC = Math.sqrt(Math.pow(meanC, 7) / (Math.pow(meanC, 7) + Math.pow(25, 7)));
-  const RT = -2 * RC * Math.sin(deltaTheta);
-  return Math.sqrt(
-    dLp / SL * (dLp / SL) + dCp / SC * (dCp / SC) + dHp / SH * (dHp / SH) + RT * (dCp / SC) * (dHp / SH)
-  );
+    const deg2rad = (deg) => (Math.PI / 180) * deg;
+    const rad2deg = (rad) => (180 / Math.PI) * rad;
+    // Step 1: Compute C* and mean C*
+    const C1 = Math.sqrt(c1.a * c1.a + c1.b * c1.b);
+    const C2 = Math.sqrt(c2.a * c2.a + c2.b * c2.b);
+    const meanC = (C1 + C2) / 2;
+    // Step 2: Compute G
+    const meanC7 = Math.pow(meanC, 7);
+    const G = 0.5 * (1 - Math.sqrt(meanC7 / (meanC7 + Math.pow(25, 7))));
+    // Step 3: a' values
+    const a1p = (1 + G) * c1.a;
+    const a2p = (1 + G) * c2.a;
+    // Step 4: C' and h'
+    const C1p = Math.sqrt(a1p * a1p + c1.b * c1.b);
+    const C2p = Math.sqrt(a2p * a2p + c2.b * c2.b);
+    const h1p = Math.atan2(c1.b, a1p);
+    const h2p = Math.atan2(c2.b, a2p);
+    // Step 5: ΔL', ΔC', ΔH'
+    const dLp = c2.l - c1.l;
+    const dCp = C2p - C1p;
+    let dhp = h2p - h1p;
+    if (dhp > Math.PI)
+        dhp -= 2 * Math.PI;
+    if (dhp < -Math.PI)
+        dhp += 2 * Math.PI;
+    const dHp = 2 * Math.sqrt(C1p * C2p) * Math.sin(dhp / 2);
+    // Step 6: mean L', mean C', mean h'
+    const meanLp = (c1.l + c2.l) / 2;
+    let meanHp = (h1p + h2p) / 2;
+    if (Math.abs(h1p - h2p) > Math.PI) {
+        meanHp += Math.PI;
+    }
+    // Step 7: T
+    const T = 1
+        - 0.17 * Math.cos(meanHp - deg2rad(30))
+        + 0.24 * Math.cos(2 * meanHp)
+        + 0.32 * Math.cos(3 * meanHp + deg2rad(6))
+        - 0.20 * Math.cos(4 * meanHp - deg2rad(63));
+    // Step 8: SL, SC, SH
+    const SL = 1 + (0.015 * (meanLp - 50) * (meanLp - 50)) / Math.sqrt(20 + (meanLp - 50) * (meanLp - 50));
+    const SC = 1 + 0.045 * meanC;
+    const SH = 1 + 0.015 * meanC * T;
+    // Step 9: RT
+    const deltaTheta = deg2rad(60) * Math.exp(-((rad2deg(meanHp) - 275) / 25) * ((rad2deg(meanHp) - 275) / 25));
+    const RC = Math.sqrt(Math.pow(meanC, 7) / (Math.pow(meanC, 7) + Math.pow(25, 7)));
+    const RT = -2 * RC * Math.sin(deltaTheta);
+    // Step 10: return ΔE00
+    return Math.sqrt((dLp / SL) * (dLp / SL)
+        + (dCp / SC) * (dCp / SC)
+        + (dHp / SH) * (dHp / SH)
+        + RT * (dCp / SC) * (dHp / SH));
 }
-function distance(c1, c2, method = "ciede2000") {
-  switch (method) {
-    case "ciede2000":
-      return distanceCiede2000(toLab(c1), toLab(c2));
-  }
+// [WIP] maybe other implementations too (cie76, cie94, cmc, euclidean), but the output range can be different, so maybe should we normalize the output to 0-100?
+/**
+ * Calculates the perceptual distance between two colors using the specified method.
+ *
+ * @param {Color} c1 - The first color.
+ * @param {Color} c2 - The second color.
+ * @param {DistanceMethod} [method='ciede2000'] - The calculation method to use.
+ * @returns {number} The perceptual distance between the colors. Lower values indicate more similar colors.
+ */
+export function distance(c1, c2, method = 'ciede2000') {
+    switch (method) {
+        case 'ciede2000': return distanceCiede2000(toLab(c1), toLab(c2));
+    }
 }
-export {
-  distance
-};

package/agnostic/colors/distance/index.test.js

@@ -0,0 +1,21 @@
+import { describe, it, expect } from 'vitest';
+import { distance } from './index.js';
+describe('distance', () => {
+    it('returns small distance for identical colors', () => {
+        const result = distance({ r: 255, g: 128, b: 64 }, { r: 255, g: 128, b: 64 });
+        expect(result).toBeLessThan(1);
+    });
+    it('returns larger distance for very different colors', () => {
+        const result = distance({ r: 255, g: 0, b: 0 }, { r: 0, g: 255, b: 0 });
+        expect(result).toBeGreaterThan(10);
+    });
+    it('uses ciede2000 method by default', () => {
+        const result1 = distance({ r: 255, g: 0, b: 0 }, { r: 0, g: 255, b: 0 });
+        const result2 = distance({ r: 255, g: 0, b: 0 }, { r: 0, g: 255, b: 0 }, 'ciede2000');
+        expect(result1).toBe(result2);
+    });
+    it('returns non-negative distance', () => {
+        const result = distance({ r: 100, g: 100, b: 100 }, { r: 200, g: 200, b: 200 });
+        expect(result).toBeGreaterThanOrEqual(0);
+    });
+});

package/agnostic/colors/grayscale/index.js

@@ -1,162 +1,121 @@
-import {
-  viaCmyk,
-  viaHsb,
-  viaHsl,
-  viaLab,
-  viaLch,
-  viaRgb,
-  viaXyz
-} from "../../../chunks/chunk-CVMYA5XK.js";
-import "../../../chunks/chunk-OBSTP7YR.js";
-import "../../../chunks/chunk-HQLRJ7XW.js";
-import "../../../chunks/chunk-DNIOWD7K.js";
-import "../../../chunks/chunk-PUQUSA6S.js";
-import "../../../chunks/chunk-OSAXBA7G.js";
-import "../../../chunks/chunk-WSFCRVEQ.js";
-
-// src/agnostic/colors/grayscale/index.ts
+import { viaRgb, viaCmyk, viaHsl, viaHsb, viaXyz, viaLab, viaLch } from '../convert/index.js';
+/* * * * * * * * * * * * * * * * * *
+ * Grayscales
+ * * * * * * * * * * * * * * * * * */
+// RGB
 function avgGrayscaleRgb(rgb) {
-  const { r, g, b } = rgb;
-  const avg = (r + g + b) / 3;
-  return { ...rgb, r: avg, g: avg, b: avg };
+    const { r, g, b } = rgb;
+    const avg = (r + g + b) / 3;
+    return { ...rgb, r: avg, g: avg, b: avg };
 }
 function weightedAvgGrayscaleRgb(rgb) {
-  const { r, g, b } = rgb;
-  const avg = r * 0.2126 + g * 0.7152 + b * 0.0722;
-  return { ...rgb, r: avg, g: avg, b: avg };
+    const { r, g, b } = rgb;
+    const avg = (r * 0.2126 + g * 0.7152 + b * 0.0722);
+    return { ...rgb, r: avg, g: avg, b: avg };
 }
 function minChannelGrayscaleRgb(rgb) {
-  const { r, g, b } = rgb;
-  const min = Math.min(r, g, b);
-  return { ...rgb, r: min, g: min, b: min };
+    const { r, g, b } = rgb;
+    const min = Math.min(r, g, b);
+    return { ...rgb, r: min, g: min, b: min };
 }
 function maxChannelGrayscaleRgb(rgb) {
-  const { r, g, b } = rgb;
-  const max = Math.max(r, g, b);
-  return { ...rgb, r: max, g: max, b: max };
+    const { r, g, b } = rgb;
+    const max = Math.max(r, g, b);
+    return { ...rgb, r: max, g: max, b: max };
 }
 function grayscaleRgbVia(rgb, channel) {
-  const { r, g, b } = rgb;
-  switch (channel) {
-    case "red":
-      return { ...rgb, r, g: r, b: r };
-    case "green":
-      return { ...rgb, r: g, g, b: g };
-    case "blue":
-      return { ...rgb, r: b, g: b, b };
-  }
-}
+    const { r, g, b } = rgb;
+    switch (channel) {
+        case 'red': return { ...rgb, r, g: r, b: r };
+        case 'green': return { ...rgb, r: g, g, b: g };
+        case 'blue': return { ...rgb, r: b, g: b, b };
+    }
+}
+// CMYK
 function avgGrayscaleCmyk(cmyk) {
-  const { c, m, y, k } = cmyk;
-  const avg = (c + m + y + k) / 4;
-  return { ...cmyk, c: avg, m: avg, y: avg, k: avg };
+    const { c, m, y, k } = cmyk;
+    const avg = (c + m + y + k) / 4;
+    return { ...cmyk, c: avg, m: avg, y: avg, k: avg };
 }
 function avgNoBlackGrayscaleCmyk(cmyk) {
-  const { c, m, y } = cmyk;
-  const avg = (c + m + y) / 3;
-  return { ...cmyk, c: avg, m: avg, y: avg, k: avg };
+    // this grayscale approach is probably not necessary
+    const { c, m, y } = cmyk;
+    const avg = (c + m + y) / 3;
+    return { ...cmyk, c: avg, m: avg, y: avg, k: avg };
 }
 function minChannelGrayscaleCmyk(cmyk) {
-  const { c, m, y, k } = cmyk;
-  const min = Math.min(c, m, y, k);
-  return { ...cmyk, c: min, m: min, y: min, k: min };
+    const { c, m, y, k } = cmyk;
+    const min = Math.min(c, m, y, k);
+    return { ...cmyk, c: min, m: min, y: min, k: min };
 }
 function minNoBlackChannelGrayscaleCmyk(cmyk) {
-  const { c, m, y } = cmyk;
-  const min = Math.min(c, m, y);
-  return { ...cmyk, c: min, m: min, y: min, k: min };
+    const { c, m, y } = cmyk;
+    const min = Math.min(c, m, y);
+    return { ...cmyk, c: min, m: min, y: min, k: min };
 }
 function maxChannelGrayscaleCmyk(cmyk) {
-  const { c, m, y, k } = cmyk;
-  const max = Math.max(c, m, y, k);
-  return { ...cmyk, c: max, m: max, y: max, k: max };
+    const { c, m, y, k } = cmyk;
+    const max = Math.max(c, m, y, k);
+    return { ...cmyk, c: max, m: max, y: max, k: max };
 }
 function maxNoBlackChannelGrayscaleCmyk(cmyk) {
-  const { c, m, y } = cmyk;
-  const max = Math.max(c, m, y);
-  return { ...cmyk, c: max, m: max, y: max, k: max };
+    const { c, m, y } = cmyk;
+    const max = Math.max(c, m, y);
+    return { ...cmyk, c: max, m: max, y: max, k: max };
 }
 function grayscaleCmykVia(cmyk, channel) {
-  const { c, m, y, k } = cmyk;
-  switch (channel) {
-    case "cyan":
-      return { ...cmyk, c, m: c, y: c, k: c };
-    case "magenta":
-      return { ...cmyk, c: m, m, y: m, k: m };
-    case "yellow":
-      return { ...cmyk, c: y, m: y, y, k: y };
-    case "black":
-      return { ...cmyk, c: k, m: k, y: k, k };
-  }
+    const { c, m, y, k } = cmyk;
+    switch (channel) {
+        case 'cyan': return { ...cmyk, c, m: c, y: c, k: c };
+        case 'magenta': return { ...cmyk, c: m, m, y: m, k: m };
+        case 'yellow': return { ...cmyk, c: y, m: y, y, k: y };
+        case 'black': return { ...cmyk, c: k, m: k, y: k, k };
+    }
 }
 function perceptualGrayscaleCmyk(cmyk) {
-  return { ...cmyk, c: 0, m: 0, y: 0 };
-}
-function grayscaleHsl(hsl) {
-  return { ...hsl, s: 0 };
-}
-function grayscaleHsb(hsb) {
-  return { ...hsb, s: 0 };
-}
-function grayscaleXyz(xyz) {
-  return { ...xyz, x: xyz.y, z: xyz.y };
-}
-function grayscaleLab(lab) {
-  return { ...lab, a: 0, b: 0 };
-}
-function grayscaleLch(lch) {
-  return { ...lch, c: 0 };
-}
-function grayscale(color, method = "lab") {
-  switch (method) {
-    case "rgb-avg":
-      return viaRgb(color, avgGrayscaleRgb);
-    case "rgb-weighted-avg":
-      return viaRgb(color, weightedAvgGrayscaleRgb);
-    case "rgb-min-channel":
-      return viaRgb(color, minChannelGrayscaleRgb);
-    case "rgb-max-channel":
-      return viaRgb(color, maxChannelGrayscaleRgb);
-    case "rgb-via-red":
-      return viaRgb(color, (rgb) => grayscaleRgbVia(rgb, "red"));
-    case "rgb-via-green":
-      return viaRgb(color, (rgb) => grayscaleRgbVia(rgb, "green"));
-    case "rgb-via-blue":
-      return viaRgb(color, (rgb) => grayscaleRgbVia(rgb, "blue"));
-    case "cmyk-avg":
-      return viaCmyk(color, avgGrayscaleCmyk);
-    case "cmyk-no-black-avg":
-      return viaCmyk(color, avgNoBlackGrayscaleCmyk);
-    case "cmyk-min-channel":
-      return viaCmyk(color, minChannelGrayscaleCmyk);
-    case "cmyk-min-no-black-channel":
-      return viaCmyk(color, minNoBlackChannelGrayscaleCmyk);
-    case "cmyk-max-channel":
-      return viaCmyk(color, maxChannelGrayscaleCmyk);
-    case "cmyk-max-no-black-channel":
-      return viaCmyk(color, maxNoBlackChannelGrayscaleCmyk);
-    case "cmyk-via-cyan":
-      return viaCmyk(color, (cmyk) => grayscaleCmykVia(cmyk, "cyan"));
-    case "cmyk-via-magenta":
-      return viaCmyk(color, (cmyk) => grayscaleCmykVia(cmyk, "magenta"));
-    case "cmyk-via-yellow":
-      return viaCmyk(color, (cmyk) => grayscaleCmykVia(cmyk, "yellow"));
-    case "cmyk-via-black":
-      return viaCmyk(color, (cmyk) => grayscaleCmykVia(cmyk, "black"));
-    case "cmyk-perceptual":
-      return viaCmyk(color, perceptualGrayscaleCmyk);
-    case "hsl":
-      return viaHsl(color, grayscaleHsl);
-    case "hsb":
-      return viaHsb(color, grayscaleHsb);
-    case "xyz":
-      return viaXyz(color, grayscaleXyz);
-    case "lab":
-      return viaLab(color, grayscaleLab);
-    case "lch":
-      return viaLch(color, grayscaleLch);
-  }
+    return { ...cmyk, c: 0, m: 0, y: 0 };
+}
+// HSL & HSB
+function grayscaleHsl(hsl) { return { ...hsl, s: 0 }; }
+function grayscaleHsb(hsb) { return { ...hsb, s: 0 }; }
+// XYZ
+function grayscaleXyz(xyz) { return { ...xyz, x: xyz.y, z: xyz.y }; }
+// LAB
+function grayscaleLab(lab) { return { ...lab, a: 0, b: 0 }; }
+// LCH
+function grayscaleLch(lch) { return { ...lch, c: 0 }; }
+/**
+ * Converts a color to grayscale using the specified method.
+ *
+ * @template C - The input color type.
+ * @param {C} color - The color to convert to grayscale.
+ * @param {GrayscaleMethod} [method='lab'] - The grayscale conversion method to use.
+ * @returns {TransformedColor<C>} The grayscale color in the original format.
+ */
+export function grayscale(color, method = 'lab') {
+    switch (method) {
+        case 'rgb-avg': return viaRgb(color, avgGrayscaleRgb);
+        case 'rgb-weighted-avg': return viaRgb(color, weightedAvgGrayscaleRgb);
+        case 'rgb-min-channel': return viaRgb(color, minChannelGrayscaleRgb);
+        case 'rgb-max-channel': return viaRgb(color, maxChannelGrayscaleRgb);
+        case 'rgb-via-red': return viaRgb(color, rgb => grayscaleRgbVia(rgb, 'red'));
+        case 'rgb-via-green': return viaRgb(color, rgb => grayscaleRgbVia(rgb, 'green'));
+        case 'rgb-via-blue': return viaRgb(color, rgb => grayscaleRgbVia(rgb, 'blue'));
+        case 'cmyk-avg': return viaCmyk(color, avgGrayscaleCmyk);
+        case 'cmyk-no-black-avg': return viaCmyk(color, avgNoBlackGrayscaleCmyk);
+        case 'cmyk-min-channel': return viaCmyk(color, minChannelGrayscaleCmyk);
+        case 'cmyk-min-no-black-channel': return viaCmyk(color, minNoBlackChannelGrayscaleCmyk);
+        case 'cmyk-max-channel': return viaCmyk(color, maxChannelGrayscaleCmyk);
+        case 'cmyk-max-no-black-channel': return viaCmyk(color, maxNoBlackChannelGrayscaleCmyk);
+        case 'cmyk-via-cyan': return viaCmyk(color, cmyk => grayscaleCmykVia(cmyk, 'cyan'));
+        case 'cmyk-via-magenta': return viaCmyk(color, cmyk => grayscaleCmykVia(cmyk, 'magenta'));
+        case 'cmyk-via-yellow': return viaCmyk(color, cmyk => grayscaleCmykVia(cmyk, 'yellow'));
+        case 'cmyk-via-black': return viaCmyk(color, cmyk => grayscaleCmykVia(cmyk, 'black'));
+        case 'cmyk-perceptual': return viaCmyk(color, perceptualGrayscaleCmyk);
+        case 'hsl': return viaHsl(color, grayscaleHsl);
+        case 'hsb': return viaHsb(color, grayscaleHsb);
+        case 'xyz': return viaXyz(color, grayscaleXyz);
+        case 'lab': return viaLab(color, grayscaleLab);
+        case 'lch': return viaLch(color, grayscaleLch);
+    }
 }
-export {
-  grayscale
-};