nhb-toolbox 4.24.1 → 4.24.2

package/CHANGELOG.md

@@ -6,6 +6,10 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.24.2] - 2025-10-31
+
+- **Fixed** *return type* when no `'colorType'` option is passed in `generateRandomColor`. **Improved** color related *types*.
+
 ## [4.24.1] - 2025-10-30
 
 - **Added** aliases for `generateRandomHSLColor`. **Updated** tsdoc for some color utilities.

package/dist/dts/colors/Color.d.ts

@@ -100,7 +100,7 @@ export declare class Color {
      */
     constructor(color: CSSColor);
     /** - Iterates over the color representations (Hex, RGB, HSL). */
-    [Symbol.iterator](): Generator<Hex8 | HSL | Hex6 | RGB | RGBA | HSLA, void, unknown>;
+    [Symbol.iterator](): Generator<Hex8 | `hsl(${number},${number}%,${number}%)` | `hsl(${number},${number}%, ${number}%)` | `hsl(${number}, ${number}%,${number}%)` | `hsl(${number}, ${number}%, ${number}%)` | Hex6 | `rgb(${number},${number},${number})` | `rgb(${number},${number}, ${number})` | `rgb(${number}, ${number},${number})` | `rgb(${number}, ${number}, ${number})` | `rgba(${number},${number},${number},${number})` | `rgba(${number},${number},${number}, ${number})` | `rgba(${number},${number}, ${number},${number})` | `rgba(${number},${number}, ${number}, ${number})` | `rgba(${number}, ${number},${number},${number})` | `rgba(${number}, ${number},${number}, ${number})` | `rgba(${number}, ${number}, ${number},${number})` | `rgba(${number}, ${number}, ${number}, ${number})` | `hsla(${number},${number}%,${number}%,${number})` | `hsla(${number},${number}%,${number}%, ${number})` | `hsla(${number},${number}%, ${number}%,${number})` | `hsla(${number},${number}%, ${number}%, ${number})` | `hsla(${number}, ${number}%,${number}%,${number})` | `hsla(${number}, ${number}%,${number}%, ${number})` | `hsla(${number}, ${number}%, ${number}%,${number})` | `hsla(${number}, ${number}%, ${number}%, ${number})`, void, unknown>;
     /**
      * @instance Applies or modifies the opacity of a color. Mutate the original instance.
      * - For solid colors (Hex6/RGB/HSL): Adds an alpha channel with the specified opacity.

package/dist/dts/colors/types.d.ts

@@ -15,6 +15,8 @@ export type Hex = `#${string}`;
  * * Format: `#3C6945`
  */
 export type Hex6 = Branded<`#${string}`, 'Hex6'>;
+/** Optional space */
+export type $Space = '' | ' ';
 /**
  * * Represents an RGB color string.
  * * Format: `rgb(R, G, B)`
@@ -23,7 +25,7 @@ export type Hex6 = Branded<`#${string}`, 'Hex6'>;
  * - G (Green): 0-255
  * - B (Blue): 0-255
  */
-export type RGB = `rgb(${number}, ${number}, ${number})` | `rgb(${number},${number},${number})`;
+export type RGB = `rgb(${number},${$Space}${number},${$Space}${number})`;
 /**
  * * Represents an HSL color string.
  * * Format: `hsl(H, S%, L%)`
@@ -32,7 +34,7 @@ export type RGB = `rgb(${number}, ${number}, ${number})` | `rgb(${number},${numb
  * - S (Saturation): 0-100%
  * - L (Lightness): 0-100%
  */
-export type HSL = `hsl(${number}, ${number}%, ${number}%)` | `hsl(${number},${number}%,${number}%)`;
+export type HSL = `hsl(${number},${$Space}${number}%,${$Space}${number}%)`;
 /**
  * * Represents a hexadecimal color code with optional alpha channel.
  * * Format: `#3C6945FF`
@@ -42,12 +44,12 @@ export type Hex8 = Branded<`#${string}`, 'Hex8'>;
  * * Represents an RGBA color string, now includes optional alpha (opacity).
  * * Format: `rgba(R, G, B, A)`
  */
-export type RGBA = `rgba(${number}, ${number}, ${number}, ${number})` | `rgba(${number},${number},${number},${number})`;
+export type RGBA = `rgba(${number},${$Space}${number},${$Space}${number},${$Space}${number})`;
 /**
  * * Represents an HSLA color string with optional alpha channel.
  * * Format: `hsla(H, S%, L%, A)`
  */
-export type HSLA = `hsla(${number}, ${number}%, ${number}%, ${number})` | `hsla(${number},${number}%,${number}%,${number})`;
+export type HSLA = `hsla(${number},${$Space}${number}%,${$Space}${number}%,${$Space}${number})`;
 /** Represents an object with `hex` (`hex6`) and `rgb` color */
 export type RandomHexRGB = {
     /** Represents a hexadecimal color code. */
@@ -58,14 +60,14 @@ export type RandomHexRGB = {
 /** Basic color type: `hex`, `rgb` or `hsl`. */
 export type $ColorType = 'hex' | 'rgb' | 'hsl';
 /** Options for random color generation. */
-export interface RandomColorOptions<Color extends $ColorType | undefined> {
+export interface RandomColorOptions<C extends $ColorType | undefined> {
     /** The type of expected return type of color: `hex`, `rgb` or `hsl`. Default is `'hex'`. */
-    colorType?: Color;
+    colorType?: C;
     /** The maximum number of recent colors to store in memory. Default is `16`. */
     maxColors?: number;
 }
-/** Infers the return color type (`Hex6`, `RGB`, or `HSL`) based on the provided color type. */
-export type RandomColor<Color extends $ColorType | undefined = undefined> = Color extends 'hsl' ? HSL : Color extends 'rgb' ? RGB : Hex6;
+/** Infers random color type (`Hex6`, `RGB`, or `HSL`) based on the provided color type `C`. */
+export type RandomColor<C extends $ColorType | undefined = undefined> = C extends undefined | 'hex' ? Hex6 : C extends 'hsl' ? HSL : C extends 'rgb' ? RGB : Hex6;
 /** * Union type representing a color in Hex6, RGB, or HSL format. */
 export type ColorTypeSolid = Hex6 | RGB | HSL;
 /** * Union type representing a color in Hex8, RGBA, or HSLA format. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.24.1",
+  "version": "4.24.2",
   "description": "A versatile collection of smart, efficient, and reusable utility functions, classes and types for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",