@design-edito/tools 0.4.23 → 0.5.0

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

@@ -1,71 +1,71 @@
-import { type Hex, type Rgba, type Hsla, type Hsba, type Laba, type Lcha, type Cmyka, type Xyza, type CssColor, type Color } from '../types.js';
+import type { Hex, Rgba, Hsla, Hsba, Laba, Lcha, Cmyka, Xyza, CssColor, Color } from '../types.js';
 /**
  * Type guard to check if a value is a valid hexadecimal color string.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Hex} True if the value is a valid hex color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid hex color, false otherwise.
  */
 export declare const isHex: (color: unknown) => color is Hex;
 /**
  * Type guard to check if a value is a valid RGBA color object.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Rgba} True if the value is a valid RGBA color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid RGBA color, false otherwise.
  */
 export declare const isRgb: (color: unknown) => color is Rgba;
 /**
  * Type guard to check if a value is a valid HSLA color object.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Hsla} True if the value is a valid HSLA color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid HSLA color, false otherwise.
  */
 export declare const isHsl: (color: unknown) => color is Hsla;
 /**
  * Type guard to check if a value is a valid HSBA color object.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Hsba} True if the value is a valid HSBA color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid HSBA color, false otherwise.
  */
 export declare const isHsb: (color: unknown) => color is Hsba;
 /**
  * Type guard to check if a value is a valid CIELAB color object.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Laba} True if the value is a valid CIELAB color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid CIELAB color, false otherwise.
  */
 export declare const isLab: (color: unknown) => color is Laba;
 /**
  * Type guard to check if a value is a valid CIELCh color object.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Lcha} True if the value is a valid CIELCh color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid CIELCh color, false otherwise.
  */
 export declare const isLch: (color: unknown) => color is Lcha;
 /**
  * Type guard to check if a value is a valid CMYK color object.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Cmyka} True if the value is a valid CMYK color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid CMYK color, false otherwise.
  */
 export declare const isCmyk: (color: unknown) => color is Cmyka;
 /**
  * Type guard to check if a value is a valid CIE XYZ color object.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Xyza} True if the value is a valid CIE XYZ color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid CIE XYZ color, false otherwise.
  */
 export declare const isXyz: (color: unknown) => color is Xyza;
 /**
  * Type guard to check if a value is a valid CSS named color.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is CssColor} True if the value is a valid CSS named color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid CSS named color, false otherwise.
  */
 export declare const isCssColor: (color: unknown) => color is CssColor;
 /**
  * Type guard to check if a value is any valid color format.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Color} True if the value is a valid color in any supported format, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid color in any supported format, false otherwise.
  */
 export declare const isColor: (color: unknown) => color is Color;

package/agnostic/colors/typechecks/index.js

@@ -1,10 +1,11 @@
+/* eslint-disable @typescript-eslint/no-unsafe-type-assertion -- isNonNullObject only narrows to `object`, which TS can't statically prove matches Record<string, unknown>, even though every color object here is a plain record */
 import { isNonNullObject } from '../../objects/is-object/index.js';
 import { cssColors } from '../cssColorsMap.js';
 /**
  * Type guard to check if a value is a valid hexadecimal color string.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Hex} True if the value is a valid hex color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid hex color, false otherwise.
  */
 export const isHex = (color) => {
     if (typeof color !== 'string')
@@ -16,13 +17,13 @@ export const isHex = (color) => {
     const allowedLengths = [3, 4, 6, 8];
     if (!allowedLengths.includes(withoutHashLength))
         return false;
-    return /^[0-9a-f]+$/igm.test(withoutHash);
+    return /^[0-9a-f]+$/igmv.test(withoutHash);
 };
 /**
  * Type guard to check if a value is a valid RGBA color object.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Rgba} True if the value is a valid RGBA color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid RGBA color, false otherwise.
  */
 export const isRgb = (color) => {
     if (!isNonNullObject(color))
@@ -41,8 +42,8 @@ export const isRgb = (color) => {
 /**
  * Type guard to check if a value is a valid HSLA color object.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Hsla} True if the value is a valid HSLA color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid HSLA color, false otherwise.
  */
 export const isHsl = (color) => {
     if (!isNonNullObject(color))
@@ -61,8 +62,8 @@ export const isHsl = (color) => {
 /**
  * Type guard to check if a value is a valid HSBA color object.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Hsba} True if the value is a valid HSBA color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid HSBA color, false otherwise.
  */
 export const isHsb = (color) => {
     if (!isNonNullObject(color))
@@ -81,8 +82,8 @@ export const isHsb = (color) => {
 /**
  * Type guard to check if a value is a valid CIELAB color object.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Laba} True if the value is a valid CIELAB color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid CIELAB color, false otherwise.
  */
 export const isLab = (color) => {
     if (!isNonNullObject(color))
@@ -101,8 +102,8 @@ export const isLab = (color) => {
 /**
  * Type guard to check if a value is a valid CIELCh color object.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Lcha} True if the value is a valid CIELCh color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid CIELCh color, false otherwise.
  */
 export const isLch = (color) => {
     if (!isNonNullObject(color))
@@ -121,8 +122,8 @@ export const isLch = (color) => {
 /**
  * Type guard to check if a value is a valid CMYK color object.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Cmyka} True if the value is a valid CMYK color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid CMYK color, false otherwise.
  */
 export const isCmyk = (color) => {
     if (!isNonNullObject(color))
@@ -143,8 +144,8 @@ export const isCmyk = (color) => {
 /**
  * Type guard to check if a value is a valid CIE XYZ color object.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Xyza} True if the value is a valid CIE XYZ color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid CIE XYZ color, false otherwise.
  */
 export const isXyz = (color) => {
     if (!isNonNullObject(color))
@@ -163,16 +164,16 @@ export const isXyz = (color) => {
 /**
  * Type guard to check if a value is a valid CSS named color.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is CssColor} True if the value is a valid CSS named color, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid CSS named color, false otherwise.
  */
 export const isCssColor = (color) => typeof color === 'string'
     && cssColors[color] !== undefined;
 /**
  * Type guard to check if a value is any valid color format.
  *
- * @param {unknown} color - The value to check.
- * @returns {color is Color} True if the value is a valid color in any supported format, false otherwise.
+ * @param color - The value to check.
+ * @returns True if the value is a valid color in any supported format, false otherwise.
  */
 export const isColor = (color) => {
     if (isHex(color))

package/agnostic/colors/types.d.ts

@@ -4,10 +4,10 @@
 export type Hex = `#${string}`;
 /**
  * Represents a color in the RGBA color space.
- * @property {number} r - Red channel (0-255).
- * @property {number} g - Green channel (0-255).
- * @property {number} b - Blue channel (0-255).
- * @property {number} [a] - Alpha channel (0-1), optional.
+ * @property r - Red channel (0-255).
+ * @property g - Green channel (0-255).
+ * @property b - Blue channel (0-255).
+ * @property [a] - Alpha channel (0-1), optional.
  */
 export type Rgba = {
     r: number;
@@ -17,10 +17,10 @@ export type Rgba = {
 };
 /**
  * Represents a color in the HSLA color space.
- * @property {number} h - Hue (0-360).
- * @property {number} s - Saturation (0-100).
- * @property {number} l - Lightness (0-100).
- * @property {number} [a] - Alpha channel (0-1), optional.
+ * @property h - Hue (0-360).
+ * @property s - Saturation (0-100).
+ * @property l - Lightness (0-100).
+ * @property [a] - Alpha channel (0-1), optional.
  */
 export type Hsla = {
     h: number;
@@ -30,10 +30,10 @@ export type Hsla = {
 };
 /**
  * Represents a color in the HSBA (HSB/HSV) color space.
- * @property {number} h - Hue (0-360).
- * @property {number} s - Saturation (0-100).
- * @property {number} b - Brightness (0-100).
- * @property {number} [a] - Alpha channel (0-1), optional.
+ * @property h - Hue (0-360).
+ * @property s - Saturation (0-100).
+ * @property b - Brightness (0-100).
+ * @property [a] - Alpha channel (0-1), optional.
  */
 export type Hsba = {
     h: number;
@@ -43,10 +43,10 @@ export type Hsba = {
 };
 /**
  * Represents a color in the CIELAB color space.
- * @property {number} l - Lightness (0-100).
- * @property {number} a - Green-red axis (approximately -128 to 127).
- * @property {number} b - Blue-yellow axis (approximately -128 to 127).
- * @property {number} [al] - Alpha channel (0-1), optional.
+ * @property l - Lightness (0-100).
+ * @property a - Green-red axis (approximately -128 to 127).
+ * @property b - Blue-yellow axis (approximately -128 to 127).
+ * @property [al] - Alpha channel (0-1), optional.
  */
 export type Laba = {
     l: number;
@@ -56,10 +56,10 @@ export type Laba = {
 };
 /**
  * Represents a color in the CIELCh color space.
- * @property {number} l - Lightness (0-100).
- * @property {number} c - Chroma (0 to approximately 150).
- * @property {number} h - Hue (0-360).
- * @property {number} [a] - Alpha channel (0-1), optional.
+ * @property l - Lightness (0-100).
+ * @property c - Chroma (0 to approximately 150).
+ * @property h - Hue (0-360).
+ * @property [a] - Alpha channel (0-1), optional.
  */
 export type Lcha = {
     l: number;
@@ -69,11 +69,11 @@ export type Lcha = {
 };
 /**
  * Represents a color in the CMYK color space.
- * @property {number} c - Cyan (0-100).
- * @property {number} m - Magenta (0-100).
- * @property {number} y - Yellow (0-100).
- * @property {number} k - Black (0-100).
- * @property {number} [a] - Alpha channel (0-1), optional.
+ * @property c - Cyan (0-100).
+ * @property m - Magenta (0-100).
+ * @property y - Yellow (0-100).
+ * @property k - Black (0-100).
+ * @property [a] - Alpha channel (0-1), optional.
  */
 export type Cmyka = {
     c: number;
@@ -84,10 +84,10 @@ export type Cmyka = {
 };
 /**
  * Represents a color in the CIE XYZ color space.
- * @property {number} x - X tristimulus value (approximately 0-95.047).
- * @property {number} y - Y tristimulus value (approximately 0-100).
- * @property {number} z - Z tristimulus value (approximately 0-108.883).
- * @property {number} [a] - Alpha channel (0-1), optional.
+ * @property x - X tristimulus value (approximately 0-95.047).
+ * @property y - Y tristimulus value (approximately 0-100).
+ * @property z - Z tristimulus value (approximately 0-108.883).
+ * @property [a] - Alpha channel (0-1), optional.
  */
 export type Xyza = {
     x: number;
@@ -151,10 +151,10 @@ export type Palette<C extends Color, T extends PaletteType> = PaletteMap<C>[T];
 export type GrayscaleMethod = 'rgb-avg' | 'rgb-weighted-avg' | 'rgb-min-channel' | 'rgb-max-channel' | 'rgb-via-red' | 'rgb-via-green' | 'rgb-via-blue' | 'cmyk-avg' | 'cmyk-no-black-avg' | 'cmyk-min-channel' | 'cmyk-min-no-black-channel' | 'cmyk-max-channel' | 'cmyk-max-no-black-channel' | 'cmyk-via-cyan' | 'cmyk-via-magenta' | 'cmyk-via-yellow' | 'cmyk-via-black' | 'cmyk-perceptual' | 'hsl' | 'hsb' | 'xyz' | 'lab' | 'lch';
 /**
  * Represents a color in the linear sRGB color space.
- * @property {number} linearR - Linear red channel (0-1).
- * @property {number} linearG - Linear green channel (0-1).
- * @property {number} linearB - Linear blue channel (0-1).
- * @property {number} [a] - Alpha channel (0-1), optional.
+ * @property linearR - Linear red channel (0-1).
+ * @property linearG - Linear green channel (0-1).
+ * @property linearB - Linear blue channel (0-1).
+ * @property [a] - Alpha channel (0-1), optional.
  */
 export type Srgba = {
     linearR: number;

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

@@ -1,20 +1,20 @@
-export declare function getNamesArr(arg: any): string[];
+export declare function getNamesArr(arg: unknown): string[];
 export interface Block {
     name: string;
     modifiers: string[];
 }
 export declare class BEM {
     constructor();
-    addBlock(blockNameArg: any): this;
-    addElement(elementNameArg: any): this;
-    addModifier(modifierNameArg: any): this;
+    addBlock(blockNameArg: unknown): this;
+    addElement(elementNameArg: unknown): this;
+    addModifier(modifierNameArg: unknown): this;
     copy(): BEM;
-    block(blockNameArg: any): BEM;
-    element(elementNameArg: any): BEM;
-    modifier(modifierNameArg: any): BEM;
-    blk(blockNameArg: any): BEM;
-    elt(elementNameArg: any): BEM;
-    mod(modifierNameArg: any): BEM;
+    block(blockNameArg: unknown): BEM;
+    element(elementNameArg: unknown): BEM;
+    modifier(modifierNameArg: unknown): BEM;
+    blk(blockNameArg: unknown): BEM;
+    elt(elementNameArg: unknown): BEM;
+    mod(modifierNameArg: unknown): BEM;
     cp(): BEM;
     get value(): string;
     get val(): string;
@@ -27,4 +27,4 @@ export declare class BEM {
     private createBlockByName;
     private getCurrentBlock;
 }
-export declare function bem(blockNameArg: any): BEM;
+export declare function bem(blockNameArg: unknown): BEM;

package/agnostic/css/bem/index.js

@@ -1,14 +1,14 @@
-import { isNonNullObject } from 'agnostic/objects/is-object/index.js';
+import { isNonNullObject } from '../../objects/is-object/index.js';
 import { isFalsy } from '../../booleans/is-falsy/index.js';
 import { isValidClassName } from '../is-valid-css-class-name/index.js';
 export function getNamesArr(arg) {
     const returned = [];
     if (typeof arg === 'string') {
-        arg.trim().split(/\s+/gm).forEach(name => { if (isValidClassName(name))
+        arg.trim().split(/\s+/gmv).forEach(name => { if (isValidClassName(name))
             returned.push(name); });
     }
     else if (Array.isArray(arg)) {
-        arg.forEach(elt => returned.push(...getNamesArr(elt)));
+        arg.forEach(elt => { returned.push(...getNamesArr(elt)); });
     }
     else if (isNonNullObject(arg)) {
         Object.entries(arg).forEach(([key, val]) => {
@@ -41,12 +41,12 @@ export class BEM {
     }
     addBlock(blockNameArg) {
         const blocksNames = getNamesArr(blockNameArg);
-        blocksNames.forEach(this.addSingleBlock.bind(this));
+        blocksNames.forEach(() => { this.addSingleBlock.bind(this); });
         return this;
     }
     addElement(elementNameArg) {
         const elementsNames = getNamesArr(elementNameArg);
-        elementsNames.forEach(this.addSingleElement.bind(this));
+        elementsNames.forEach(() => { this.addSingleElement.bind(this); });
         return this;
     }
     addModifier(modifierNameArg) {
@@ -54,14 +54,14 @@ export class BEM {
         if (currentBlock === undefined)
             return this;
         const modifiersNames = getNamesArr(modifierNameArg);
-        modifiersNames.forEach(this.addSingleModifier.bind(this));
+        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.bind(copy));
+            block.modifiers.forEach(() => { copy.addModifier.bind(copy); });
         });
         return copy;
     }
@@ -99,7 +99,7 @@ export class BEM {
         if (currentBlock === undefined)
             this.addBlock(elementName);
         else {
-            currentBlock.name = currentBlock.name + '__' + elementName;
+            currentBlock.name = `${currentBlock.name}__${elementName}`;
         }
         return this;
     }
@@ -122,6 +122,7 @@ export class BEM {
         }
         return this;
     }
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
     createBlockByName(blockName) {
         return { name: blockName, modifiers: [] };
     }

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

@@ -46,7 +46,7 @@ export type ClssMaker = (eltNames?: EltNamesDescriptor, modNames?: ModsDescripto
  * @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}
+ * @returns
  *   A function to generate class names for elements and modifiers.
  *
  *   The returned function (`ClssMaker`) parameters:

package/agnostic/css/clss/index.js

@@ -5,7 +5,7 @@
  * @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}
+ * @returns
  *   A function to generate class names for elements and modifiers.
  *
  *   The returned function (`ClssMaker`) parameters:

package/agnostic/css/index.d.ts

@@ -2,5 +2,5 @@ export * as bem from './bem/index.js'
 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 stylesSet from './styles-set/index.js'
 export * as scale from './scale/index.js'
+export * as stylesSet from './styles-set/index.js'

package/agnostic/css/index.js

@@ -2,5 +2,5 @@ export * as bem from './bem/index.js'
 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 stylesSet from './styles-set/index.js'
 export * as scale from './scale/index.js'
+export * as stylesSet from './styles-set/index.js'

package/agnostic/css/is-valid-css-class-name/index.d.ts

@@ -7,7 +7,7 @@ export declare const classNameRegex: RegExp;
 /**
  * Checks if a string is a valid CSS class name.
  *
- * @param {string} string - The string to validate.
- * @returns {boolean} True if the string is a valid CSS class name, false otherwise.
+ * @param string - The string to validate.
+ * @returns True if the string is a valid CSS class name, false otherwise.
  */
 export declare function isValidClassName(string: string): boolean;

package/agnostic/css/is-valid-css-class-name/index.js

@@ -3,12 +3,12 @@
  * Matches class names that start with an optional hyphen, followed by a letter or underscore,
  * then any combination of letters, numbers, underscores, or hyphens.
  */
-export const classNameRegex = /^-?[_a-zA-Z]+[_a-zA-Z0-9-]*$/;
+export const classNameRegex = /^-?[_a-zA-Z]+[_a-zA-Z0-9\-]*$/v;
 /**
  * Checks if a string is a valid CSS class name.
  *
- * @param {string} string - The string to validate.
- * @returns {boolean} True if the string is a valid CSS class name, false otherwise.
+ * @param string - The string to validate.
+ * @returns True if the string is a valid CSS class name, false otherwise.
  */
 export function isValidClassName(string) {
     return classNameRegex.test(string);

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

@@ -1,10 +1,10 @@
 /**
  * Generates an array of interpolated values between a minimum and maximum using a geometric progression.
  *
- * @param {number} min - The starting value of the scale.
- * @param {number} max - The ending value of the scale.
- * @param {number} intermediateLevels - The number of intermediate levels between min and max.
- * @returns {number[]} An array of rounded values including the minimum and interpolated steps up to the maximum.
+ * @param min - The starting value of the scale.
+ * @param max - The ending value of the scale.
+ * @param intermediateLevels - The number of intermediate levels between min and max.
+ * @returns An array of rounded values including the minimum and interpolated steps up to the maximum.
  */
 export declare const interpolateLevels: (min: number, max: number, intermediateLevels: number) => number[];
 /** Describes the configuration used to compute scale values across breakpoints. */
@@ -17,11 +17,11 @@ export type ScaleDataOptions = {
 /**
  * Computes scale data for each breakpoint, including interpolated levels.
  *
- * @param {ScaleDataOptions} options - Configuration for generating scale data.
- * @param {number[]} options.breakpoints - Ordered list of breakpoint widths in pixels.
- * @param {[number, number]} options.loScaleBounds - Minimum and maximum values for the low end of the scale.
- * @param {[number, number]} options.hiScaleBounds - Minimum and maximum values for the high end of the scale.
- * @param {number} options.intermediateLevels - Number of intermediate levels between bounds.
+ * @param options - Configuration for generating scale data.
+ * @param options.breakpoints - Ordered list of breakpoint widths in pixels.
+ * @param options.loScaleBounds - Minimum and maximum values for the low end of the scale.
+ * @param options.hiScaleBounds - Minimum and maximum values for the high end of the scale.
+ * @param options.intermediateLevels - Number of intermediate levels between bounds.
  * @throws Will throw if `breakpoints` contains fewer than two values.
  */
 export declare const getScaleData: ({ breakpoints, loScaleBounds, hiScaleBounds, intermediateLevels }: ScaleDataOptions) => Array<{
@@ -37,14 +37,14 @@ export type GenerateScaleCssOptions = ScaleDataOptions & {
 /**
  * Generates responsive CSS custom properties for a scale across breakpoints.
  *
- * @param {GenerateScaleCssOptions} options - Configuration for generating the CSS output.
- * @param {string} options.scaleName - Base name for CSS custom properties.
- * @param {string} options.targetSelector - CSS selector to which the properties will be applied.
- * @param {string} options.unit - Unit appended to each value.
- * @param {number[]} options.breakpoints - Ordered list of breakpoint widths in pixels.
- * @param {[number, number]} options.loScaleBounds - Minimum and maximum values for the low end of the scale.
- * @param {[number, number]} options.hiScaleBounds - Minimum and maximum values for the high end of the scale.
- * @param {number} options.intermediateLevels - Number of intermediate levels between bounds.
- * @returns {string} A CSS string containing custom properties for each breakpoint, wrapped in media queries where applicable.
+ * @param options - Configuration for generating the CSS output.
+ * @param options.scaleName - Base name for CSS custom properties.
+ * @param options.targetSelector - CSS selector to which the properties will be applied.
+ * @param options.unit - Unit appended to each value.
+ * @param options.breakpoints - Ordered list of breakpoint widths in pixels.
+ * @param options.loScaleBounds - Minimum and maximum values for the low end of the scale.
+ * @param options.hiScaleBounds - Minimum and maximum values for the high end of the scale.
+ * @param options.intermediateLevels - Number of intermediate levels between bounds.
+ * @returns A CSS string containing custom properties for each breakpoint, wrapped in media queries where applicable.
  */
 export declare const generateScaleCss: ({ scaleName, targetSelector, unit, ...options }: GenerateScaleCssOptions) => string;

package/agnostic/css/scale/index.js

@@ -4,10 +4,10 @@ import { make as makeArr } from '../../arrays/make/index.js';
 /**
  * Generates an array of interpolated values between a minimum and maximum using a geometric progression.
  *
- * @param {number} min - The starting value of the scale.
- * @param {number} max - The ending value of the scale.
- * @param {number} intermediateLevels - The number of intermediate levels between min and max.
- * @returns {number[]} An array of rounded values including the minimum and interpolated steps up to the maximum.
+ * @param min - The starting value of the scale.
+ * @param max - The ending value of the scale.
+ * @param intermediateLevels - The number of intermediate levels between min and max.
+ * @returns An array of rounded values including the minimum and interpolated steps up to the maximum.
  */
 export const interpolateLevels = (min, max, intermediateLevels) => [
     round(min, 2),
@@ -16,11 +16,11 @@ export const interpolateLevels = (min, max, intermediateLevels) => [
 /**
  * Computes scale data for each breakpoint, including interpolated levels.
  *
- * @param {ScaleDataOptions} options - Configuration for generating scale data.
- * @param {number[]} options.breakpoints - Ordered list of breakpoint widths in pixels.
- * @param {[number, number]} options.loScaleBounds - Minimum and maximum values for the low end of the scale.
- * @param {[number, number]} options.hiScaleBounds - Minimum and maximum values for the high end of the scale.
- * @param {number} options.intermediateLevels - Number of intermediate levels between bounds.
+ * @param options - Configuration for generating scale data.
+ * @param options.breakpoints - Ordered list of breakpoint widths in pixels.
+ * @param options.loScaleBounds - Minimum and maximum values for the low end of the scale.
+ * @param options.hiScaleBounds - Minimum and maximum values for the high end of the scale.
+ * @param options.intermediateLevels - Number of intermediate levels between bounds.
  * @throws Will throw if `breakpoints` contains fewer than two values.
  */
 export const getScaleData = ({ breakpoints, loScaleBounds, hiScaleBounds, intermediateLevels }) => {
@@ -47,15 +47,15 @@ export const getScaleData = ({ breakpoints, loScaleBounds, hiScaleBounds, interm
 /**
  * Generates responsive CSS custom properties for a scale across breakpoints.
  *
- * @param {GenerateScaleCssOptions} options - Configuration for generating the CSS output.
- * @param {string} options.scaleName - Base name for CSS custom properties.
- * @param {string} options.targetSelector - CSS selector to which the properties will be applied.
- * @param {string} options.unit - Unit appended to each value.
- * @param {number[]} options.breakpoints - Ordered list of breakpoint widths in pixels.
- * @param {[number, number]} options.loScaleBounds - Minimum and maximum values for the low end of the scale.
- * @param {[number, number]} options.hiScaleBounds - Minimum and maximum values for the high end of the scale.
- * @param {number} options.intermediateLevels - Number of intermediate levels between bounds.
- * @returns {string} A CSS string containing custom properties for each breakpoint, wrapped in media queries where applicable.
+ * @param options - Configuration for generating the CSS output.
+ * @param options.scaleName - Base name for CSS custom properties.
+ * @param options.targetSelector - CSS selector to which the properties will be applied.
+ * @param options.unit - Unit appended to each value.
+ * @param options.breakpoints - Ordered list of breakpoint widths in pixels.
+ * @param options.loScaleBounds - Minimum and maximum values for the low end of the scale.
+ * @param options.hiScaleBounds - Minimum and maximum values for the high end of the scale.
+ * @param options.intermediateLevels - Number of intermediate levels between bounds.
+ * @returns A CSS string containing custom properties for each breakpoint, wrapped in media queries where applicable.
  */
 export const generateScaleCss = ({ scaleName, targetSelector, unit, ...options }) => getScaleData(options).map(({ breakpoint, levels }, pos) => {
     const levelsCss = levels.map((lvlVal, lvlPos) => `--${scaleName}-${lvlPos}: ${lvlVal}${unit};`);

package/agnostic/css/styles-set/index.d.ts

@@ -30,7 +30,7 @@ export type StylesSetCompProps = {
     items?: StylesSet['items'];
     privateIDAttribute?: StylesSet['tagsPrivateIDAttribute'];
     publicIDAttribute?: StylesSet['tagsPublicIDAttribute'];
-    onRendered?: (...any: any[]) => any;
+    onRendered?: (...any: unknown[]) => unknown;
 };
 export declare class StylesSetComp extends Component<StylesSetCompProps> {
     componentDidMount(): void;

package/agnostic/css/styles-set/index.js

@@ -112,8 +112,6 @@ export class StylesSet {
     }
     async getDomString(documentObj) {
         const actualDocumentObj = documentObj ?? window.document;
-        if (actualDocumentObj === null)
-            throw new Error('Window.document is not available');
         return await new Promise(resolve => {
             const tempElt = actualDocumentObj.createElement('div');
             const tempRoot = reactCreateRoot(tempElt);

package/agnostic/errors/register/index.d.ts

@@ -1,6 +1,6 @@
 export type RegisterEntry = {
     message: string;
-    detailsMaker: (...p: any[]) => any;
+    detailsMaker: (...p: unknown[]) => unknown;
 };
 export type Source<C extends string> = {
     [K in C]: RegisterEntry;