@design-edito/tools 0.3.9 → 0.3.11

package/agnostic/arrays/index.d.ts

@@ -1,6 +1,6 @@
 export * as dedupe from './dedupe/index.js'
 export * as findDuplicates from './find-duplicates/index.js'
 export * as isArrayOf from './is-array-of/index.js'
-export * as randomPick from './random-pick/index.js'
-export * as shuffle from './shuffle/index.js'
 export * as make from './make/index.js'
+export * as shuffle from './shuffle/index.js'
+export * as randomPick from './random-pick/index.js'

package/agnostic/arrays/index.js

@@ -1,6 +1,6 @@
 export * as dedupe from './dedupe/index.js'
 export * as findDuplicates from './find-duplicates/index.js'
 export * as isArrayOf from './is-array-of/index.js'
-export * as randomPick from './random-pick/index.js'
-export * as shuffle from './shuffle/index.js'
 export * as make from './make/index.js'
+export * as shuffle from './shuffle/index.js'
+export * as randomPick from './random-pick/index.js'

package/agnostic/arrays/is-array-of/index.d.ts

@@ -12,5 +12,5 @@ type TypeOfChecker<C> = C extends ConstructorFunction<infer U> ? U : C extends T
  * Supports constructor functions (e.g., `Number`, `String`, `Boolean`, custom classes)
  * and custom type guard functions.
  */
-export declare function isArrayOf<C extends TypeChecker<any> | TypeChecker<any>[]>(input: unknown, _types?: C): input is Array<TypeOfChecker<C extends any[] ? C[number] : C>>;
+export declare function isArrayOf<C extends TypeChecker<any> | Array<TypeChecker<any>>>(input: unknown, _types?: C): input is Array<TypeOfChecker<C extends any[] ? C[number] : C>>;
 export {};

package/agnostic/arrays/is-array-of/index.js

@@ -4,7 +4,7 @@ import {
 } from "../../misc/is-constructor-function/index.js";
 function isArrayOf(input, _types) {
   if (!Array.isArray(input)) return false;
-  if (!_types) return true;
+  if (_types === void 0) return true;
   const types = Array.isArray(_types) ? _types : [_types];
   const primitiveTypeMap = /* @__PURE__ */ new Map([
     [Number, "number"],
@@ -15,7 +15,7 @@ function isArrayOf(input, _types) {
     (entry) => types.some((typeChecker) => {
       if (!isConstructorFunction(typeChecker)) return typeChecker(entry);
       const primitiveType = primitiveTypeMap.get(typeChecker);
-      if (primitiveType) return typeof entry === primitiveType;
+      if (primitiveType !== void 0) return typeof entry === primitiveType;
       return entry instanceof typeChecker;
     })
   );

package/agnostic/booleans/is-falsy/index.d.ts

@@ -1,4 +1,4 @@
-import { Nullish } from '../../misc/is-nullish/index.js';
+import { type Nullish } from '../../misc/is-nullish/index.js';
 /** Union type representing all falsy values in JavaScript. */
 export type Falsy = Nullish | false | '' | 0 | -0 | typeof NaN | 0n;
 /** Type that excludes falsy values from T (except numbers, which may be 0). */

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

@@ -1,4 +1,4 @@
-import { Color, TransformedColor, Channel } from '../types.js';
+import { type Color, type TransformedColor, type Channel } from '../types.js';
 /**
  * Sets a specific color channel to an absolute value.
  *

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

@@ -1,4 +1,4 @@
-import { Color, ContrastMethod } from '../types.js';
+import type { Color, ContrastMethod } from '../types.js';
 /**
  * Calculates the contrast ratio between two colors using the specified method.
  *

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

@@ -1,4 +1,4 @@
-import { Color, Hex, Rgba, Hsla, Hsba, Laba, Lcha, Cmyka, Xyza, CssColor, TransformedColor, Srgba } from '../types.js';
+import type { Color, Hex, Rgba, Hsla, Hsba, Laba, Lcha, Cmyka, Xyza, CssColor, TransformedColor, Srgba } from '../types.js';
 /**
  * Converts any supported color format to RGBA.
  *

package/agnostic/colors/convert/index.js

@@ -1,9 +1,7 @@
 // src/agnostic/colors/convert/index.ts
 import { absoluteModulo } from "../../numbers/absolute-modulo/index.js";
 import { tidy } from "../tidy/index.js";
-import {
-  cssColors
-} from "../types.js";
+import { cssColors } from "../cssColorsMap.js";
 import {
   isHex,
   isRgb,
@@ -15,8 +13,9 @@ import {
   isLab,
   isLch
 } from "../typechecks/index.js";
+import { unknownToString } from "../../errors/unknown-to-string/index.js";
 function _hex2rgb(hex) {
-  if (!isHex(hex)) throw new Error(`invalid hex color ${hex}`);
+  if (!isHex(hex)) throw new Error(`invalid hex color ${unknownToString(hex)}`);
   let hexString = hex;
   const inputHex = hexString;
   const startsWithHash = hexString.startsWith("#");
@@ -28,9 +27,7 @@ function _hex2rgb(hex) {
     hexString = hexString.split("").map((c) => c + c).join("");
   } else if (hexString.length === 6) {
     hexString = hexString + "ff";
-  } else if (hexString.length === 8) {
-    hexString = hexString;
-  } else throw new Error(`invalid hex color ${inputHex}`);
+  } else if (hexString.length !== 8) throw new Error(`invalid hex color ${inputHex}`);
   const r = parseInt(hexString.slice(0, 2), 16);
   const g = parseInt(hexString.slice(2, 4), 16);
   const b = parseInt(hexString.slice(4, 6), 16);
@@ -45,7 +42,7 @@ function _rgb2hex(rgb) {
   const aHex = Math.round(a * 255).toString(16).padStart(2, "0");
   const returned = `#${rHex}${gHex}${bHex}${aHex}`;
   if (!isHex(returned)) {
-    throw new Error(`invalid hex color output ${returned}`);
+    throw new Error(`invalid hex color output ${unknownToString(returned)}`);
   }
   return returned;
 }
@@ -364,7 +361,7 @@ function toRgb(color) {
   if (isXyz(color)) return _xyz2rgb(color);
   if (isLab(color)) return _xyz2rgb(_lab2xyz(color));
   if (isLch(color)) return _xyz2rgb(_lab2xyz(_lch2lab(color)));
-  throw new Error(`Invalid color input: ${color}`);
+  throw new Error(`Invalid color input: ${unknownToString(color)}`);
 }
 function toXyz(color) {
   if (isXyz(color)) return color;
@@ -376,7 +373,7 @@ function toXyz(color) {
   if (isCmyk(color)) return _rgb2xyz(_cmyk2rgb(color));
   if (isCssColor(color)) return _rgb2xyz(_css2rgb(color));
   if (isHex(color)) return _rgb2xyz(_hex2rgb(color));
-  throw new Error(`Invalid color input: ${color}`);
+  throw new Error(`Invalid color input: ${unknownToString(color)}`);
 }
 function toLab(color) {
   if (isLab(color)) return color;
@@ -428,7 +425,7 @@ function viaRgb(color, transformer) {
   if (isHex(_color)) return toRgb(transformedRgb);
   if (isCssColor(_color)) return transformedRgb;
   const _typecheck = true;
-  throw new Error(`Invalid color input: ${_color}`);
+  throw new Error(`Invalid color input: ${unknownToString(_color)}`);
 }
 function viaHsl(color, transformer) {
   const _color = color;
@@ -444,7 +441,7 @@ function viaHsl(color, transformer) {
   if (isHex(_color)) return toHex(transformedHsl);
   if (isCssColor(_color)) return transformedHsl;
   const _typecheck = true;
-  throw new Error(`Invalid color input: ${_color}`);
+  throw new Error(`Invalid color input: ${unknownToString(_color)}`);
 }
 function viaHsb(color, transformer) {
   const _color = color;
@@ -460,7 +457,7 @@ function viaHsb(color, transformer) {
   if (isHex(_color)) return toHex(transformedHsb);
   if (isCssColor(_color)) return transformedHsb;
   const _typecheck = true;
-  throw new Error(`Invalid color input: ${_color}`);
+  throw new Error(`Invalid color input: ${unknownToString(_color)}`);
 }
 function viaCmyk(color, transformer) {
   const _color = color;
@@ -476,7 +473,7 @@ function viaCmyk(color, transformer) {
   if (isHex(_color)) return toHex(transformedCmyk);
   if (isCssColor(_color)) return transformedCmyk;
   const _typecheck = true;
-  throw new Error(`Invalid color input: ${_color}`);
+  throw new Error(`Invalid color input: ${unknownToString(_color)}`);
 }
 function viaXyz(color, transformer) {
   const _color = color;
@@ -492,7 +489,7 @@ function viaXyz(color, transformer) {
   if (isHex(_color)) return toHex(transformedXyz);
   if (isCssColor(_color)) return transformedXyz;
   const _typecheck = true;
-  throw new Error(`Invalid color input: ${_color}`);
+  throw new Error(`Invalid color input: ${unknownToString(_color)}`);
 }
 function viaLab(color, transformer) {
   const _color = color;
@@ -508,7 +505,7 @@ function viaLab(color, transformer) {
   if (isHex(_color)) return toHex(transformedLab);
   if (isCssColor(_color)) return transformedLab;
   const _typecheck = true;
-  throw new Error(`Invalid color input: ${_color}`);
+  throw new Error(`Invalid color input: ${unknownToString(_color)}`);
 }
 function viaLch(color, transformer) {
   const _color = color;
@@ -524,7 +521,7 @@ function viaLch(color, transformer) {
   if (isHex(_color)) return toHex(transformedLch);
   if (isCssColor(_color)) return transformedLch;
   const _typecheck = true;
-  throw new Error(`Invalid color input: ${_color}`);
+  throw new Error(`Invalid color input: ${unknownToString(_color)}`);
 }
 function linearizeToSRgb(rgb) {
   const cleanRgb = tidy(rgb);

package/agnostic/colors/cssColorsMap.d.ts

@@ -0,0 +1,9 @@
+import type { CssColor, Rgba } from './types.js';
+type CssColorMap = {
+    [K in CssColor]: Rgba;
+};
+/**
+ * Map of CSS named colors to their corresponding RGBA values.
+ */
+export declare const cssColors: CssColorMap;
+export {};

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

@@ -1,4 +1,4 @@
-import { Color, DistanceMethod } from '../types.js';
+import { type Color, type DistanceMethod } from '../types.js';
 /**
  * Calculates the perceptual distance between two colors using the specified method.
  *

package/agnostic/colors/index.d.ts

@@ -1,12 +1,12 @@
 export * as channels from './channels/index.js'
-export * as contrast from './contrast/index.js'
+export * as grayscale from './grayscale/index.js'
 export * as convert from './convert/index.js'
 export * as distance from './distance/index.js'
 export * as invert from './invert/index.js'
-export * as grayscale from './grayscale/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 rotate from './rotate/index.js'
 export * as tidy from './tidy/index.js'
 export * as typechecks from './typechecks/index.js'
-export * as rotate from './rotate/index.js'
+export * as contrast from './contrast/index.js'

package/agnostic/colors/index.js

@@ -1,12 +1,12 @@
 export * as channels from './channels/index.js'
-export * as contrast from './contrast/index.js'
+export * as grayscale from './grayscale/index.js'
 export * as convert from './convert/index.js'
 export * as distance from './distance/index.js'
 export * as invert from './invert/index.js'
-export * as grayscale from './grayscale/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 rotate from './rotate/index.js'
 export * as tidy from './tidy/index.js'
 export * as typechecks from './typechecks/index.js'
-export * as rotate from './rotate/index.js'
+export * as contrast from './contrast/index.js'

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

@@ -1,4 +1,4 @@
-import { Color, TransformedColor, InvertMethod } from '../types.js';
+import { type Color, type TransformedColor, type InvertMethod } from '../types.js';
 /**
  * Inverts a color using the specified method.
  *

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

@@ -1,4 +1,4 @@
-import { Color, LuminanceMethod } from '../types.js';
+import { type Color, type LuminanceMethod } from '../types.js';
 /**
  * Calculates the relative luminance of a color using the specified method.
  *

package/agnostic/colors/palette/index.js

@@ -92,6 +92,8 @@ function palette(color, type) {
       return tetradicLab(color);
     case "tetradic-lch":
       return tetradicLch(color);
+    default:
+      throw new Error(`Invalid palette type: ${type}`);
   }
 }
 export {

package/agnostic/colors/tidy/index.js

@@ -3,6 +3,7 @@ import { isRgb, isHsl, isHsb, isCmyk, isXyz, isLab, isLch, isCssColor, isHex } f
 import { clamp } from "../../numbers/clamp/index.js";
 import { absoluteModulo } from "../../numbers/absolute-modulo/index.js";
 import { toRgb, toHex } from "../convert/index.js";
+import { unknownToString } from "../../errors/unknown-to-string/index.js";
 function tidy(color) {
   const _color = color;
   if (isRgb(_color)) return {
@@ -51,7 +52,7 @@ function tidy(color) {
   if (isCssColor(_color)) return tidy(toRgb(_color));
   if (isHex(_color)) return toHex(tidy(toRgb(_color)));
   const _typecheck = true;
-  throw new Error(`Invalid color input: ${_color}`);
+  throw new Error(`Invalid color input: ${unknownToString(_color)}`);
 }
 export {
   tidy

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

@@ -1,4 +1,4 @@
-import { Hex, Rgba, Hsla, Hsba, Laba, Lcha, Cmyka, Xyza, CssColor, Color } from '../types.js';
+import { type Hex, type Rgba, type Hsla, type Hsba, type Laba, type Lcha, type Cmyka, type Xyza, type CssColor, type Color } from '../types.js';
 /**
  * Type guard to check if a value is a valid hexadecimal color string.
  *

package/agnostic/colors/typechecks/index.js

@@ -1,8 +1,6 @@
 // src/agnostic/colors/typechecks/index.ts
 import { isNonNullObject } from "../../objects/is-object/index.js";
-import {
-  cssColors
-} from "../types.js";
+import { cssColors } from "../cssColorsMap.js";
 var isHex = (color) => {
   if (typeof color !== "string") return false;
   if (!color.startsWith("#")) return false;

package/agnostic/colors/types.d.ts

@@ -99,13 +99,6 @@ export type Xyza = {
  * Union type of all valid CSS named colors.
  */
 export type CssColor = 'aliceblue' | 'antiquewhite' | 'aqua' | 'aquamarine' | 'azure' | 'beige' | 'bisque' | 'black' | 'blanchedalmond' | 'blue' | 'blueviolet' | 'brown' | 'burlywood' | 'cadetblue' | 'chartreuse' | 'chocolate' | 'coral' | 'cornflowerblue' | 'cornsilk' | 'crimson' | 'cyan' | 'darkblue' | 'darkcyan' | 'darkgoldenrod' | 'darkgray' | 'darkgreen' | 'darkgrey' | 'darkkhaki' | 'darkmagenta' | 'darkolivegreen' | 'darkorange' | 'darkorchid' | 'darkred' | 'darksalmon' | 'darkseagreen' | 'darkslateblue' | 'darkslategray' | 'darkslategrey' | 'darkturquoise' | 'darkviolet' | 'deeppink' | 'deepskyblue' | 'dimgray' | 'dimgrey' | 'dodgerblue' | 'firebrick' | 'floralwhite' | 'forestgreen' | 'fuchsia' | 'gainsboro' | 'ghostwhite' | 'gold' | 'goldenrod' | 'gray' | 'green' | 'greenyellow' | 'grey' | 'honeydew' | 'hotpink' | 'indianred' | 'indigo' | 'ivory' | 'khaki' | 'lavender' | 'lavenderblush' | 'lawngreen' | 'lemonchiffon' | 'lightblue' | 'lightcoral' | 'lightcyan' | 'lightgoldenrodyellow' | 'lightgray' | 'lightgreen' | 'lightgrey' | 'lightpink' | 'lightsalmon' | 'lightseagreen' | 'lightskyblue' | 'lightslategray' | 'lightslategrey' | 'lightsteelblue' | 'lightyellow' | 'lime' | 'limegreen' | 'linen' | 'magenta' | 'maroon' | 'mediumaquamarine' | 'mediumblue' | 'mediumorchid' | 'mediumpurple' | 'mediumseagreen' | 'mediumslateblue' | 'mediumspringgreen' | 'mediumturquoise' | 'mediumvioletred' | 'midnightblue' | 'mintcream' | 'mistyrose' | 'moccasin' | 'navajowhite' | 'navy' | 'oldlace' | 'olive' | 'olivedrab' | 'orange' | 'orangered' | 'orchid' | 'palegoldenrod' | 'palegreen' | 'paleturquoise' | 'palevioletred' | 'papayawhip' | 'peachpuff' | 'peru' | 'pink' | 'plum' | 'powderblue' | 'purple' | 'rebeccapurple' | 'red' | 'rosybrown' | 'royalblue' | 'saddlebrown' | 'salmon' | 'sandybrown' | 'seagreen' | 'seashell' | 'sienna' | 'silver' | 'skyblue' | 'slateblue' | 'slategray' | 'slategrey' | 'snow' | 'springgreen' | 'steelblue' | 'tan' | 'teal' | 'thistle' | 'tomato' | 'turquoise' | 'violet' | 'wheat' | 'white' | 'whitesmoke' | 'yellow' | 'yellowgreen';
-type CssColorMap = {
-    [K in CssColor]: Rgba;
-};
-/**
- * Map of CSS named colors to their corresponding RGBA values.
- */
-export declare const cssColors: CssColorMap;
 /**
  * Union type representing any supported color format.
  */

package/agnostic/colors/types.js

@@ -1,154 +0,0 @@
-// src/agnostic/colors/types.ts
-var 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 }
-};
-export {
-  cssColors
-};

package/agnostic/css/bem/index.d.ts

@@ -5,9 +5,9 @@ export interface Block {
 }
 export declare class BEM {
     constructor();
-    addBlock(blockNameArg: any): BEM;
-    addElement(elementNameArg: any): BEM;
-    addModifier(modifierNameArg: any): BEM;
+    addBlock(blockNameArg: any): this;
+    addElement(elementNameArg: any): this;
+    addModifier(modifierNameArg: any): this;
     copy(): BEM;
     block(blockNameArg: any): BEM;
     element(elementNameArg: any): BEM;

package/agnostic/css/bem/index.js

@@ -1,4 +1,5 @@
 // src/agnostic/css/bem/index.ts
+import { isNonNullObject } from "agnostic/objects/is-object/index.js";
 import { isFalsy } from "../../booleans/is-falsy/index.js";
 import { isValidClassName } from "../is-valid-css-class-name/index.js";
 function getNamesArr(arg) {
@@ -9,7 +10,7 @@ function getNamesArr(arg) {
     });
   } else if (Array.isArray(arg)) {
     arg.forEach((elt) => returned.push(...getNamesArr(elt)));
-  } else if (typeof arg === "object" && arg !== null) {
+  } else if (isNonNullObject(arg)) {
     Object.entries(arg).forEach(([key, val]) => {
       if (!isFalsy(val)) returned.push(...getNamesArr(key));
     });
@@ -39,26 +40,26 @@ var BEM = class _BEM {
   }
   addBlock(blockNameArg) {
     const blocksNames = getNamesArr(blockNameArg);
-    blocksNames.forEach(this.addSingleBlock);
+    blocksNames.forEach(this.addSingleBlock.bind(this));
     return this;
   }
   addElement(elementNameArg) {
     const elementsNames = getNamesArr(elementNameArg);
-    elementsNames.forEach(this.addSingleElement);
+    elementsNames.forEach(this.addSingleElement.bind(this));
     return this;
   }
   addModifier(modifierNameArg) {
     const currentBlock = this.getCurrentBlock();
     if (currentBlock === void 0) return this;
     const modifiersNames = getNamesArr(modifierNameArg);
-    modifiersNames.forEach(this.addSingleModifier);
+    modifiersNames.forEach(this.addSingleModifier.bind(this));
     return this;
   }
   copy() {
     const copy = new _BEM();
     this.blocks.forEach((block) => {
       copy.addBlock(block.name);
-      block.modifiers.forEach(copy.addModifier);
+      block.modifiers.forEach(copy.addModifier.bind(copy));
     });
     return copy;
   }

package/agnostic/css/clss/index.d.ts

@@ -1,8 +1,61 @@
+/**
+ * Object representing a CSS module mapping class names to hashed class strings.
+ */
 export type CssModuleObj = Readonly<Record<string, string>>;
+/**
+ * Descriptor for modifiers.
+ * Can be:
+ * - a single string,
+ * - an array of strings,
+ * - an object mapping modifier names to boolean (only `true` modifiers are used).
+ */
 export type ModsDescriptor = string | string[] | Record<string, boolean | null | undefined>;
+/**
+ * Descriptor for element names.
+ * Can be:
+ * - a single string,
+ * - `null`,
+ * - an array of strings or `null`.
+ */
 export type EltNamesDescriptor = string | null | Array<string | null>;
+/**
+ * Options used to configure the `clss` function.
+ */
 export type Options = {
+    /** CSS module object containing class name mappings */
     cssModule: CssModuleObj;
+    /** Optional key for the root block in the CSS module */
     cssModuleRoot?: string;
 };
-export declare function clss(blockNames: string | string[], options?: Options): (eltNames: EltNamesDescriptor, modNames?: ModsDescriptor) => string;
+/**
+ * Function to compute class names for elements and modifiers.
+ *
+ * @param eltNames - Element names or `null`. Can be a string, `null`, or array of strings/null.
+ * @param modNames - Modifier names. Can be a string, array of strings, or an object mapping modifiers to boolean.
+ * @returns A string containing all resolved public and private CSS classes.
+ *
+ * @example
+ * const classes = btnClss('icon', { active: true, disabled: false })
+ * // Returns: "button__icon button__icon--active _hash123 _hash456"
+ */
+export type ClssMaker = (eltNames?: EltNamesDescriptor, modNames?: ModsDescriptor) => string;
+/**
+ * Generates a `ClssMaker` function for a block or blocks.
+ *
+ * @param blockNames - A single block name or an array of block names.
+ * @param options - Optional configuration:
+ *   - `cssModule`: Object mapping class names to their hashed equivalents (required if using CSS modules).
+ *   - `cssModuleRoot`: Optional key for the root block in the CSS module (defaults to `'root'` if not provided).
+ * @returns {ClssMaker}
+ *   A function to generate class names for elements and modifiers.
+ *
+ *   The returned function (`ClssMaker`) parameters:
+ *   - `eltNames`: Element names or `null`. Can be a string, `null`, or array of strings/null.
+ *   - `modNames`: Modifier names. Can be a string, array of strings, or object mapping modifiers to boolean (`true` modifiers are included).
+ *   - Returns a string containing all resolved public and private CSS classes, including element-specific and modifier-specific classes.
+ *
+ * @example
+ * const btnClss = clss('button', { cssModule: styles, cssModuleRoot: 'root' })
+ * const classes = btnClss('icon', { active: true, disabled: false })
+ */
+export declare function clss(blockNames: string | string[], options?: Options): ClssMaker;

package/agnostic/css/clss/index.js

@@ -1,7 +1,7 @@
 // src/agnostic/css/clss/index.ts
 function clss(blockNames, options) {
-  blockNames = Array.isArray(blockNames) ? blockNames : [blockNames];
-  return (eltNames, modNames = []) => {
+  const blockNamesArr = Array.isArray(blockNames) ? blockNames : [blockNames];
+  return (eltNames = null, modNames = []) => {
     const eltNamesArr = Array.isArray(eltNames) ? eltNames : [eltNames];
     const modNamesArr = (Array.isArray(modNames) ? modNames : [modNames]).map((modName) => {
       if (typeof modName === "string") return modName;
@@ -9,7 +9,7 @@ function clss(blockNames, options) {
       return trueModNames;
     }).flat();
     const outputClassesArr = [];
-    blockNames.forEach((compName) => {
+    blockNamesArr.forEach((compName) => {
       eltNamesArr.forEach((eltName) => {
         const targetPublicClss = eltName === null ? compName : `${compName}__${eltName}`;
         const targetPrivateClss = eltName === null ? options?.cssModule[options.cssModuleRoot ?? "root"] : options?.cssModule[eltName];

package/agnostic/css/generate-nice-color/index.js

@@ -64,6 +64,7 @@ var niceColors = [
 var generateNiceColor = () => {
   const pos = Math.floor(Math.random() * niceColors.length);
   const found = niceColors[pos];
+  if (found === void 0) throw new Error("Could not generate color (should never happen)");
   return found;
 };
 export {

package/agnostic/css/index.d.ts

@@ -1,6 +1,6 @@
 export * as clss from './clss/index.js'
 export * as generateNiceColor from './generate-nice-color/index.js'
 export * as isValidCssClassName from './is-valid-css-class-name/index.js'
-export * as scale from './scale/index.js'
 export * as bem from './bem/index.js'
+export * as scale from './scale/index.js'
 export * as stylesSet from './styles-set/index.js'

package/agnostic/css/index.js

@@ -1,6 +1,6 @@
 export * as clss from './clss/index.js'
 export * as generateNiceColor from './generate-nice-color/index.js'
 export * as isValidCssClassName from './is-valid-css-class-name/index.js'
-export * as scale from './scale/index.js'
 export * as bem from './bem/index.js'
+export * as scale from './scale/index.js'
 export * as stylesSet from './styles-set/index.js'