@design-edito/tools 0.4.23 → 0.5.1

package/agnostic/colors/convert/index.js

@@ -1,3 +1,5 @@
+/* eslint-disable @typescript-eslint/no-unsafe-type-assertion -- TransformedColor<C> can't be narrowed from a generic type param at compile time; every assertion here is guarded by an isX(...) runtime check immediately prior */
+/* eslint-disable max-lines */
 import { absoluteModulo } from '../../numbers/absolute-modulo/index.js';
 import { tidy } from '../tidy/index.js';
 import { cssColors } from '../cssColorsMap.js';
@@ -10,7 +12,6 @@ import { unknownToString } from '../../errors/unknown-to-string/index.js';
 // [WIP] maybe use absoluteModulo where needed?
 // needs rewrite, hex char checks, etc
 function _hex2rgb(hex) {
-    // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
     if (!isHex(hex))
         throw new Error(`invalid hex color ${unknownToString(hex)}`);
     let hexString = hex;
@@ -20,13 +21,13 @@ function _hex2rgb(hex) {
         throw new Error(`invalid hex color ${inputHex}`);
     hexString = hexString.slice(1);
     if (hexString.length === 3) {
-        hexString = hexString.split('').map(c => c + c).join('') + 'ff';
+        hexString = `${hexString.split('').map(c => c + c).join('')}ff`;
     }
     else if (hexString.length === 4) {
         hexString = hexString.split('').map(c => c + c).join('');
     }
     else if (hexString.length === 6) {
-        hexString = hexString + 'ff';
+        hexString = `${hexString}ff`;
     }
     else if (hexString.length !== 8)
         throw new Error(`invalid hex color ${inputHex}`);
@@ -73,10 +74,14 @@ function _hsl2rgb(hsl) {
     const L = Math.max(0, Math.min(1, l / 100));
     const A = Math.max(0, Math.min(1, a));
     const hue2rgb = (p, q, t) => {
-        if (t < 0)
+        // eslint-disable-next-line no-param-reassign
+        if (t < 0) {
             t += 1;
-        if (t > 1)
+        }
+        // eslint-disable-next-line no-param-reassign
+        if (t > 1) {
             t -= 1;
+        }
         if (t < 1 / 6)
             return p + (q - p) * 6 * t;
         if (t < 1 / 2)
@@ -85,13 +90,10 @@ function _hsl2rgb(hsl) {
             return p + (q - p) * (2 / 3 - t) * 6;
         return p;
     };
-    let r;
-    let g;
-    let b;
-    if (S === 0) {
-        r = g = b = L; // achromatic
-    }
-    else {
+    let r = L;
+    let g = L;
+    let b = L;
+    if (S !== 0) {
         const q = L < 0.5 ? L * (1 + S) : L + S - L * S;
         const p = 2 * L - q;
         r = hue2rgb(p, q, H + 1 / 3);
@@ -181,7 +183,10 @@ function _hsb2rgb(hsb) {
             g = p;
             blue = q;
             break;
-        default: r = g = blue = 0;
+        default:
+            r = 0;
+            g = 0;
+            blue = 0;
     }
     return {
         r: Math.round(r * 255),
@@ -329,7 +334,7 @@ function _rgb2xyz(rgb) {
 }
 // XYZ ↔ LAB
 function _lab2xyz(lab) {
-    const { l, a: A = 0, b: B = 0, al: alpha = 1 } = lab;
+    const { l, a: A, b: B, al: alpha = 1 } = lab;
     // D65 reference white
     const REF_X = 95.047;
     const REF_Y = 100.0;
@@ -398,8 +403,8 @@ function _lch2lab(lch) {
 /**
  * Converts any supported color format to RGBA.
  *
- * @param {Color} color - The color to convert.
- * @returns {Rgba} The color in RGBA format.
+ * @param color - The color to convert.
+ * @returns The color in RGBA format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export function toRgb(color) {
@@ -426,8 +431,8 @@ export function toRgb(color) {
 /**
  * Converts any supported color format to CIE XYZ.
  *
- * @param {Color} color - The color to convert.
- * @returns {Xyza} The color in CIE XYZ format.
+ * @param color - The color to convert.
+ * @returns The color in CIE XYZ format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export function toXyz(color) {
@@ -454,8 +459,8 @@ export function toXyz(color) {
 /**
  * Converts any supported color format to CIELAB.
  *
- * @param {Color} color - The color to convert.
- * @returns {Laba} The color in CIELAB format.
+ * @param color - The color to convert.
+ * @returns The color in CIELAB format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export function toLab(color) {
@@ -469,8 +474,8 @@ export function toLab(color) {
 /**
  * Converts any supported color format to CIELCh.
  *
- * @param {Color} color - The color to convert.
- * @returns {Lcha} The color in CIELCh format.
+ * @param color - The color to convert.
+ * @returns The color in CIELCh format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export function toLch(color) {
@@ -482,8 +487,8 @@ export function toLch(color) {
 /**
  * Converts any supported color format to HSLA.
  *
- * @param {Color} color - The color to convert.
- * @returns {Hsla} The color in HSLA format.
+ * @param color - The color to convert.
+ * @returns The color in HSLA format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export function toHsl(color) {
@@ -495,8 +500,8 @@ export function toHsl(color) {
 /**
  * Converts any supported color format to HSBA (HSB/HSV).
  *
- * @param {Color} color - The color to convert.
- * @returns {Hsba} The color in HSBA format.
+ * @param color - The color to convert.
+ * @returns The color in HSBA format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export function toHsb(color) {
@@ -508,8 +513,8 @@ export function toHsb(color) {
 /**
  * Converts any supported color format to CMYK.
  *
- * @param {Color} color - The color to convert.
- * @returns {Cmyka} The color in CMYK format.
+ * @param color - The color to convert.
+ * @returns The color in CMYK format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export function toCmyk(color) {
@@ -527,8 +532,8 @@ export function toCss(color) {
 /**
  * Converts any supported color format to hexadecimal.
  *
- * @param {Color} color - The color to convert.
- * @returns {Hex} The color in hexadecimal format.
+ * @param color - The color to convert.
+ * @returns The color in hexadecimal format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export function toHex(color) {
@@ -545,9 +550,9 @@ export function toHex(color) {
  * then converting back to the original color format.
  *
  * @template C - The input color type.
- * @param {C} color - The color to transform.
- * @param {(rgb: Rgba) => Rgba} transformer - Function that transforms the RGBA representation.
- * @returns {TransformedColor<C>} The transformed color in the original format.
+ * @param color - The color to transform.
+ * @param transformer - Function that transforms the RGBA representation.
+ * @returns The transformed color in the original format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export function viaRgb(color, transformer) {
@@ -581,9 +586,9 @@ export function viaRgb(color, transformer) {
  * then converting back to the original color format.
  *
  * @template C - The input color type.
- * @param {C} color - The color to transform.
- * @param {(hsl: Hsla) => Hsla} transformer - Function that transforms the HSLA representation.
- * @returns {TransformedColor<C>} The transformed color in the original format.
+ * @param color - The color to transform.
+ * @param transformer - Function that transforms the HSLA representation.
+ * @returns The transformed color in the original format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export function viaHsl(color, transformer) {
@@ -617,9 +622,9 @@ export function viaHsl(color, transformer) {
  * then converting back to the original color format.
  *
  * @template C - The input color type.
- * @param {C} color - The color to transform.
- * @param {(hsb: Hsba) => Hsba} transformer - Function that transforms the HSBA representation.
- * @returns {TransformedColor<C>} The transformed color in the original format.
+ * @param color - The color to transform.
+ * @param transformer - Function that transforms the HSBA representation.
+ * @returns The transformed color in the original format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export function viaHsb(color, transformer) {
@@ -653,9 +658,9 @@ export function viaHsb(color, transformer) {
  * then converting back to the original color format.
  *
  * @template C - The input color type.
- * @param {C} color - The color to transform.
- * @param {(cmyk: Cmyka) => Cmyka} transformer - Function that transforms the CMYK representation.
- * @returns {TransformedColor<C>} The transformed color in the original format.
+ * @param color - The color to transform.
+ * @param transformer - Function that transforms the CMYK representation.
+ * @returns The transformed color in the original format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export function viaCmyk(color, transformer) {
@@ -689,9 +694,9 @@ export function viaCmyk(color, transformer) {
  * then converting back to the original color format.
  *
  * @template C - The input color type.
- * @param {C} color - The color to transform.
- * @param {(xyz: Xyza) => Xyza} transformer - Function that transforms the XYZ representation.
- * @returns {TransformedColor<C>} The transformed color in the original format.
+ * @param color - The color to transform.
+ * @param transformer - Function that transforms the XYZ representation.
+ * @returns The transformed color in the original format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export function viaXyz(color, transformer) {
@@ -725,9 +730,9 @@ export function viaXyz(color, transformer) {
  * then converting back to the original color format.
  *
  * @template C - The input color type.
- * @param {C} color - The color to transform.
- * @param {(lab: Laba) => Laba} transformer - Function that transforms the CIELAB representation.
- * @returns {TransformedColor<C>} The transformed color in the original format.
+ * @param color - The color to transform.
+ * @param transformer - Function that transforms the CIELAB representation.
+ * @returns The transformed color in the original format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export function viaLab(color, transformer) {
@@ -761,9 +766,9 @@ export function viaLab(color, transformer) {
  * then converting back to the original color format.
  *
  * @template C - The input color type.
- * @param {C} color - The color to transform.
- * @param {(lch: Lcha) => Lcha} transformer - Function that transforms the CIELCh representation.
- * @returns {TransformedColor<C>} The transformed color in the original format.
+ * @param color - The color to transform.
+ * @param transformer - Function that transforms the CIELCh representation.
+ * @returns The transformed color in the original format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export function viaLch(color, transformer) {
@@ -798,8 +803,8 @@ export function viaLch(color, transformer) {
 /**
  * Converts an RGBA color to linear sRGB color space by applying inverse gamma correction.
  *
- * @param {Rgba} rgb - The RGBA color to linearize.
- * @returns {Srgba} The linearized color in sRGB color space.
+ * @param rgb - The RGBA color to linearize.
+ * @returns The linearized color in sRGB color space.
  */
 export function linearizeToSRgb(rgb) {
     const cleanRgb = tidy(rgb);
@@ -820,8 +825,8 @@ export function linearizeToSRgb(rgb) {
 /**
  * Converts a linear sRGB color to RGBA by applying gamma correction.
  *
- * @param {Srgba} srgb - The linear sRGB color to delinearize.
- * @returns {Rgba} The delinearized color in RGBA format.
+ * @param srgb - The linear sRGB color to delinearize.
+ * @returns The delinearized color in RGBA format.
  */
 export function delinearizeToRgb(srgb) {
     const gammaChannel = (v) => {

package/agnostic/colors/distance/index.d.ts

@@ -1,10 +1,10 @@
-import { type Color, type DistanceMethod } from '../types.js';
+import type { Color, DistanceMethod } from '../types.js';
 /**
  * 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.
+ * @param c1 - The first color.
+ * @param c2 - The second color.
+ * @param [method='ciede2000'] - The calculation method to use.
+ * @returns The perceptual distance between the colors. Lower values indicate more similar colors.
  */
 export declare function distance(c1: Color, c2: Color, method?: DistanceMethod): number;

package/agnostic/colors/distance/index.js

@@ -56,13 +56,14 @@ function distanceCiede2000(c1, c2) {
 /**
  * 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.
+ * @param c1 - The first color.
+ * @param c2 - The second color.
+ * @param [method='ciede2000'] - The calculation method to use.
+ * @returns The perceptual distance between the colors. Lower values indicate more similar colors.
  */
 export function distance(c1, c2, method = 'ciede2000') {
     switch (method) {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
         case 'ciede2000': return distanceCiede2000(toLab(c1), toLab(c2));
     }
 }

package/agnostic/colors/grayscale/index.d.ts

@@ -3,8 +3,8 @@ import type { Color, TransformedColor, GrayscaleMethod } from '../types.js';
  * 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.
+ * @param color - The color to convert to grayscale.
+ * @param [method='lab'] - The grayscale conversion method to use.
+ * @returns The grayscale color in the original format.
  */
 export declare function grayscale<C extends Color>(color: C, method?: GrayscaleMethod): TransformedColor<C>;

package/agnostic/colors/grayscale/index.js

@@ -88,9 +88,9 @@ 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.
+ * @param color - The color to convert to grayscale.
+ * @param [method='lab'] - The grayscale conversion method to use.
+ * @returns The grayscale color in the original format.
  */
 export function grayscale(color, method = 'lab') {
     switch (method) {

package/agnostic/colors/index.d.ts

@@ -1,12 +1,12 @@
 export * as channels from './channels/index.js'
+export * as convert from './convert/index.js'
 export * as contrast from './contrast/index.js'
-export * as grayscale from './grayscale/index.js'
 export * as distance from './distance/index.js'
+export * as grayscale from './grayscale/index.js'
+export * as invert from './invert/index.js'
 export * as lerp from './lerp/index.js'
 export * as luminance from './luminance/index.js'
 export * as palette from './palette/index.js'
-export * as convert from './convert/index.js'
 export * as rotate from './rotate/index.js'
 export * as tidy from './tidy/index.js'
 export * as typechecks from './typechecks/index.js'
-export * as invert from './invert/index.js'

package/agnostic/colors/index.js

@@ -1,12 +1,12 @@
 export * as channels from './channels/index.js'
+export * as convert from './convert/index.js'
 export * as contrast from './contrast/index.js'
-export * as grayscale from './grayscale/index.js'
 export * as distance from './distance/index.js'
+export * as grayscale from './grayscale/index.js'
+export * as invert from './invert/index.js'
 export * as lerp from './lerp/index.js'
 export * as luminance from './luminance/index.js'
 export * as palette from './palette/index.js'
-export * as convert from './convert/index.js'
 export * as rotate from './rotate/index.js'
 export * as tidy from './tidy/index.js'
 export * as typechecks from './typechecks/index.js'
-export * as invert from './invert/index.js'

package/agnostic/colors/invert/index.d.ts

@@ -1,10 +1,10 @@
-import { type Color, type TransformedColor, type InvertMethod } from '../types.js';
+import type { Color, TransformedColor, InvertMethod } from '../types.js';
 /**
  * Inverts a color using the specified method.
  *
  * @template C - The input color type.
- * @param {C} color - The color to invert.
- * @param {InvertMethod} [method='lch'] - The inversion method to use.
- * @returns {TransformedColor<C>} The inverted color in the original format.
+ * @param color - The color to invert.
+ * @param [method='lch'] - The inversion method to use.
+ * @returns The inverted color in the original format.
  */
 export declare function invert<C extends Color>(color: C, method?: InvertMethod): TransformedColor<C>;

package/agnostic/colors/invert/index.js

@@ -27,9 +27,9 @@ function invertLch(color) {
  * Inverts a color using the specified method.
  *
  * @template C - The input color type.
- * @param {C} color - The color to invert.
- * @param {InvertMethod} [method='lch'] - The inversion method to use.
- * @returns {TransformedColor<C>} The inverted color in the original format.
+ * @param color - The color to invert.
+ * @param [method='lch'] - The inversion method to use.
+ * @returns The inverted color in the original format.
  */
 export function invert(color, method = 'lch') {
     switch (method) {

package/agnostic/colors/lerp/index.d.ts

@@ -3,11 +3,10 @@ import type { Color, LerpMethod, TransformedColor } from '../types.js';
  * Linearly interpolates between two colors using the specified method.
  *
  * @template C1 - The first color type.
- * @template C2 - The second color type.
- * @param {C1} c1 - The starting color.
- * @param {C2} c2 - The ending color.
- * @param {number} amount - The interpolation amount (0-1), where 0 returns c1 and 1 returns c2.
- * @param {LerpMethod} [method='rgb'] - The interpolation method to use.
- * @returns {TransformedColor<C1>} The interpolated color in the format of c1.
+ * @param c1 - The starting color.
+ * @param c2 - The ending color.
+ * @param amount - The interpolation amount (0-1), where 0 returns c1 and 1 returns c2.
+ * @param [method='rgb'] - The interpolation method to use.
+ * @returns The interpolated color in the format of c1.
  */
-export declare function lerp<C1 extends Color, C2 extends Color>(c1: C1, c2: C2, amount: number, method?: LerpMethod): TransformedColor<C1>;
+export declare function lerp<C1 extends Color>(c1: C1, c2: Color, amount: number, method?: LerpMethod): TransformedColor<C1>;

package/agnostic/colors/lerp/index.js

@@ -69,12 +69,11 @@ function lerpXyz(xyz1, xyz2, amount) {
  * Linearly interpolates between two colors using the specified method.
  *
  * @template C1 - The first color type.
- * @template C2 - The second color type.
- * @param {C1} c1 - The starting color.
- * @param {C2} c2 - The ending color.
- * @param {number} amount - The interpolation amount (0-1), where 0 returns c1 and 1 returns c2.
- * @param {LerpMethod} [method='rgb'] - The interpolation method to use.
- * @returns {TransformedColor<C1>} The interpolated color in the format of c1.
+ * @param c1 - The starting color.
+ * @param c2 - The ending color.
+ * @param amount - The interpolation amount (0-1), where 0 returns c1 and 1 returns c2.
+ * @param [method='rgb'] - The interpolation method to use.
+ * @returns The interpolated color in the format of c1.
  */
 export function lerp(c1, c2, amount, method = 'rgb') {
     switch (method) {

package/agnostic/colors/luminance/index.d.ts

@@ -1,9 +1,9 @@
-import { type Color, type LuminanceMethod } from '../types.js';
+import type { Color, LuminanceMethod } from '../types.js';
 /**
  * Calculates the relative luminance of a color using the specified method.
  *
- * @param {Color} color - The color to analyze.
- * @param {LuminanceMethod} [method='lab'] - The calculation method to use.
- * @returns {number} The relative luminance value (0-1).
+ * @param color - The color to analyze.
+ * @param [method='lab'] - The calculation method to use.
+ * @returns The relative luminance value (0-1).
  */
 export declare function luminance(color: Color, method?: LuminanceMethod): number;

package/agnostic/colors/luminance/index.js

@@ -6,9 +6,9 @@ function luminanceRgb(rgb) {
 /**
  * Calculates the relative luminance of a color using the specified method.
  *
- * @param {Color} color - The color to analyze.
- * @param {LuminanceMethod} [method='lab'] - The calculation method to use.
- * @returns {number} The relative luminance value (0-1).
+ * @param color - The color to analyze.
+ * @param [method='lab'] - The calculation method to use.
+ * @returns The relative luminance value (0-1).
  */
 export function luminance(color, method = 'lab') {
     switch (method) {

package/agnostic/colors/palette/index.d.ts

@@ -4,8 +4,8 @@ import type { Color, PaletteType, Palette } from '../types.js';
  *
  * @template C - The input color type.
  * @template T - The palette generation scheme type.
- * @param {C} color - The base color for palette generation.
- * @param {T} type - The type of palette to generate (e.g., 'complementary', 'triadic', 'tetradic').
- * @returns {Palette<C, T>} An array of colors forming the requested palette, in the original color format.
+ * @param color - The base color for palette generation.
+ * @param type - The type of palette to generate (e.g., 'complementary', 'triadic', 'tetradic').
+ * @returns An array of colors forming the requested palette, in the original color format.
  */
 export declare function palette<C extends Color, T extends PaletteType>(color: C, type: T): Palette<C, T>;

package/agnostic/colors/palette/index.js

@@ -82,9 +82,9 @@ function tetradicLch(color) {
  *
  * @template C - The input color type.
  * @template T - The palette generation scheme type.
- * @param {C} color - The base color for palette generation.
- * @param {T} type - The type of palette to generate (e.g., 'complementary', 'triadic', 'tetradic').
- * @returns {Palette<C, T>} An array of colors forming the requested palette, in the original color format.
+ * @param color - The base color for palette generation.
+ * @param type - The type of palette to generate (e.g., 'complementary', 'triadic', 'tetradic').
+ * @returns An array of colors forming the requested palette, in the original color format.
  */
 export function palette(color, type) {
     switch (type) {
@@ -100,6 +100,7 @@ export function palette(color, type) {
         case 'tetradic': return tetradicHsl(color);
         case 'tetradic-lab': return tetradicLab(color);
         case 'tetradic-lch': return tetradicLch(color);
+        // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check
         default: throw new Error(`Invalid palette type: ${type}`);
     }
 }

package/agnostic/colors/rotate/index.d.ts

@@ -3,9 +3,9 @@ import type { Color, TransformedColor, RotateMethod } from '../types.js';
  * Rotates the hue of a color by a specified number of degrees.
  *
  * @template C - The input color type.
- * @param {C} color - The color to rotate.
- * @param {number} degrees - The number of degrees to rotate the hue (positive or negative).
- * @param {RotateMethod} [method='hsl'] - The color space to use for rotation.
- * @returns {TransformedColor<C>} The rotated color in the original format.
+ * @param color - The color to rotate.
+ * @param degrees - The number of degrees to rotate the hue (positive or negative).
+ * @param [method='hsl'] - The color space to use for rotation.
+ * @returns The rotated color in the original format.
  */
 export declare function rotate<C extends Color>(color: C, degrees: number, method?: RotateMethod): TransformedColor<C>;

package/agnostic/colors/rotate/index.js

@@ -27,10 +27,10 @@ function rotateLch(color, degrees) {
  * Rotates the hue of a color by a specified number of degrees.
  *
  * @template C - The input color type.
- * @param {C} color - The color to rotate.
- * @param {number} degrees - The number of degrees to rotate the hue (positive or negative).
- * @param {RotateMethod} [method='hsl'] - The color space to use for rotation.
- * @returns {TransformedColor<C>} The rotated color in the original format.
+ * @param color - The color to rotate.
+ * @param degrees - The number of degrees to rotate the hue (positive or negative).
+ * @param [method='hsl'] - The color space to use for rotation.
+ * @returns The rotated color in the original format.
  */
 export function rotate(color, degrees, method = 'hsl') {
     switch (method) {

package/agnostic/colors/tidy/index.d.ts

@@ -3,8 +3,8 @@ import type { Color, TransformedColor } from '../types.js';
  * Clamps and normalizes a color's channel values to their valid ranges.
  *
  * @template C - The input color type.
- * @param {C} color - The color to tidy.
- * @returns {TransformedColor<C>} The color with all channels clamped to valid ranges, in the original format.
+ * @param color - The color to tidy.
+ * @returns The color with all channels clamped to valid ranges, in the original format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export declare function tidy<C extends Color>(color: C): TransformedColor<C>;

package/agnostic/colors/tidy/index.js

@@ -7,8 +7,8 @@ import { unknownToString } from '../../errors/unknown-to-string/index.js';
  * Clamps and normalizes a color's channel values to their valid ranges.
  *
  * @template C - The input color type.
- * @param {C} color - The color to tidy.
- * @returns {TransformedColor<C>} The color with all channels clamped to valid ranges, in the original format.
+ * @param color - The color to tidy.
+ * @returns The color with all channels clamped to valid ranges, in the original format.
  * @throws {Error} If the color format is invalid or unsupported.
  */
 export function tidy(color) {