toolbox-x 2.0.14 → 2.2.0

package/dist/colors.cjs

@@ -17,8 +17,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primitives = require('./primitives-CBGICrDR.cjs');
 const require_css_colors = require('./css-colors-DC7oZ46Y.cjs');
-const require_guards = require('./guards-DGN95D2h.cjs');
-const require_convert = require('./convert-Cqy2Llek.cjs');
+const require_guards = require('./guards-CrfVwk0-.cjs');
+const require_convert = require('./convert-BjKz_hhr.cjs');
+const require_utilities = require('./utilities-BVpk3LKy.cjs');
 const require_constants = require('./constants-BOs8tjzp.cjs');
 
 //#region src/colors/random.ts
@@ -158,6 +159,18 @@ var Color = class Color {
 		yield this.hsla;
 	}
 	/**
+	* Allows the color to be used in string and number contexts.
+	* @param hint The hint to determine the conversion type.
+	*/
+	[Symbol.toPrimitive](hint) {
+		if (hint === "string") return this.hex8;
+		else if (hint === "number") {
+			const hex = this.hex8.endsWith("FF") ? this.hex : this.hex8;
+			return parseInt(hex.replace("#", "0x"), 16);
+		}
+		return this;
+	}
+	/**
 	* @private Convert `Hex6` color format to `Hex8` by applying `100%` opacity.
 	* @param hex `Hex6` color to convert to `Hex8`.
 	*/
@@ -181,11 +194,12 @@ var Color = class Color {
 		return `hsla(${h}, ${s}%, ${l}%, 1)`;
 	}
 	/**
-	* @instance Applies or modifies the opacity of a color and returns a new instance.
+	* @instance Sets the opacity of this color to the given **absolute** percentage and returns a new instance.
 	*
 	* @remarks
+	* - This is an **absolute setter**: passing `50` means "set opacity to exactly 50%", regardless of the current opacity.
 	* - For solid colors ({@link Hex6}/{@link RGB}/{@link HSL}): Adds an alpha channel with the specified opacity.
-	* - For alpha colors ({@link Hex8}/{@link RGBA}/{@link HSLA}): Updates the existing alpha channel.
+	* - For alpha colors ({@link Hex8}/{@link RGBA}/{@link HSLA}): Replaces the existing alpha channel.
 	*
 	* @param opacity - A number between `0-100` representing the opacity percentage.
 	* @returns A new instance of `Color` containing all color formats with the applied opacity.
@@ -204,40 +218,81 @@ var Color = class Color {
 		return new Color(`${this.hex.slice(0, 7)}${require_convert.percentToHex(opacity)}`.toUpperCase());
 	}
 	/**
-	* @instance Darkens the color by reducing the lightness by the given percentage.
-	* @param percent - The percentage to darken (`0–100`).
-	* @returns A new `Color` instance with the modified darkness.
+	* @instance Darkens the color by **subtracting** the given percentage points from the current lightness in HSL space.
+	*
+	* @remarks
+	* - This is a **relative adjustment**: passing `20` means "reduce lightness by 20 percentage points" from its current value.
+	* - Lightness is clamped to `0%` at minimum.
+	* - The original alpha (opacity) is preserved in the returned color.
+	*
+	* @param percent - The percentage points to subtract from lightness (`0–100`).
+	* @returns A new `Color` instance with the reduced lightness.
+	*
+	* @example
+	* const blue = new Color("#0000ff"); // hsl(240, 100%, 50%)
+	* const darkerBlue = blue.applyDarkness(20);
+	* console.log(darkerBlue.hsl); // hsl(240, 100%, 30%)
 	*/
 	applyDarkness(percent) {
 		const [h, s, l, a] = require_convert.extractAlphaColorValues(this.hsla);
 		return new Color(`hsl(${h}, ${s}%, ${Math.max(0, l - percent)}%)`).applyOpacity(a * 100);
 	}
 	/**
-	* @instance Lightens the color by increasing the lightness by the given percentage.
-	* @param percent - The percentage to brighten (`0–100`).
-	* @returns A new `Color` instance with the modified lightness.
+	* @instance Lightens the color by **adding** the given percentage points to the current lightness in HSL space.
+	*
+	* @remarks
+	* - This is a **relative adjustment**: passing `30` means "increase lightness by 30 percentage points" from its current value.
+	* - Lightness is clamped to `100%` at maximum.
+	* - The original alpha (opacity) is preserved in the returned color.
+	*
+	* @param percent - The percentage points to add to lightness (`0–100`).
+	* @returns A new `Color` instance with the increased lightness.
+	*
+	* @example
+	* const green = new Color("#008000"); // hsl(120, 100%, 25.1%)
+	* const lighterGreen = green.applyBrightness(30);
+	* console.log(lighterGreen.hsl); // hsl(120, 100%, 55.1%)
 	*/
 	applyBrightness(percent) {
 		const [h, s, l, a] = require_convert.extractAlphaColorValues(this.hsla);
 		return new Color(`hsl(${h}, ${s}%, ${Math.min(100, l + percent)}%)`).applyOpacity(a * 100);
 	}
 	/**
-	* @instance Reduces the saturation of the color to make it appear duller.
-	* @param percent - The percentage to reduce saturation (`0–100`).
-	* @returns A new `Color` instance with the modified saturation.
+	* @instance Desaturates the color by **subtracting** the given percentage points from the current saturation in HSL space.
+	*
+	* @remarks
+	* - This is a **relative adjustment**: passing `50` means "reduce saturation by 50 percentage points" from its current value.
+	* - Saturation is clamped to `0%` at minimum (fully desaturated / grayscale).
+	* - The original alpha (opacity) is preserved in the returned color.
+	*
+	* @param percent - The percentage points to subtract from saturation (`0–100`).
+	* @returns A new `Color` instance with the reduced saturation.
+	*
+	* @example
+	* const pink = new Color("#ff69b4"); // hsl(330, 100%, 70.59%)
+	* const dullPink = pink.applyDullness(50);
+	* console.log(dullPink.hsl); // hsl(330, 50%, 70.59%)
 	*/
 	applyDullness(percent) {
 		const [h, s, l, a] = require_convert.extractAlphaColorValues(this.hsla);
 		return new Color(`hsl(${h}, ${Math.max(0, s - percent)}%, ${l}%)`).applyOpacity(a * 100);
 	}
 	/**
-	* @instance Softens the color toward white by reducing saturation and increasing lightness based on a percentage.
+	* @instance Softens the color toward white by **proportionally** reducing saturation and increasing lightness.
 	*
 	* @remarks
-	* This creates a soft UI-like white shade effect (similar to some UI libraries' light color scale).
+	* - This is a **proportional blend**: passing `40` means "move 40% of the *remaining distance* toward pure white".
+	* - Unlike {@link applyBrightness} or {@link applyDullness}, the effect scales relative to the current distance from white, producing a natural pastel/tint effect.
+	* - This creates a soft UI-like white shade effect (similar to some UI libraries' light color scale).
+	* - The original alpha (opacity) is preserved in the returned color.
 	*
 	* @param percent - Value from `0` to `100` representing how far to push the color toward white.
 	* @returns A new `Color` instance shifted toward white.
+	*
+	* @example
+	* const purple = new Color("#800080"); // hsl(300, 100%, 25.1%)
+	* const softPurple = purple.applyWhiteShade(40);
+	* console.log(softPurple.hsl); // hsl(300, 60%, 55.06%)
 	*/
 	applyWhiteShade(percent) {
 		const [h, s, l, a] = require_convert.extractAlphaColorValues(this.hsla);
@@ -258,14 +313,14 @@ var Color = class Color {
 	*/
 	blendWith(other, weight = .5) {
 		const w = Math.max(0, Math.min(1, weight));
-		const converted = Color.isCSSColor(other) ? new Color(other) : new Color(other);
-		const [r1, b1, g1, a1] = require_convert.extractAlphaColorValues(this.rgba);
-		const [r2, b2, g2, a2] = require_convert.extractAlphaColorValues(converted.rgba);
+		const converted = new Color(other);
+		const [r1, g1, b1, a1] = require_convert.extractAlphaColorValues(this.rgba);
+		const [r2, g2, b2, a2] = require_convert.extractAlphaColorValues(converted.rgba);
 		const alpha = Math.round((a1 * (1 - w) + a2 * w) * 100) / 100;
-		const blendChannel = (c1, c2) => {
+		const _blendChannel = (c1, c2) => {
 			return Math.round((c1 * a1 * (1 - w) + c2 * a2 * w) / alpha);
 		};
-		return new Color(`rgba(${blendChannel(r1, r2)}, ${blendChannel(g1, g2)}, ${blendChannel(b1, b2)}, ${alpha})`);
+		return new Color(`rgba(${_blendChannel(r1, r2)}, ${_blendChannel(g1, g2)}, ${_blendChannel(b1, b2)}, ${alpha})`);
 	}
 	/**
 	* @instance Calculates the contrast ratio between this color and another color (WCAG).
@@ -273,11 +328,11 @@ var Color = class Color {
 	* @returns A number representing the contrast ratio (rounded to 2 decimal places).
 	*/
 	contrastRatio(other) {
-		const newColor = Color.isCSSColor(other) ? new Color(other) : new Color(other);
+		const newColor = new Color(other);
 		const luminance = (rgb) => {
 			const [r, g, b] = require_convert.extractSolidColorValues(rgb).map((v) => {
 				const c = v / 255;
-				return c <= .03928 ? c / 12.92 : Math.pow((c + .055) / 1.055, 2.4);
+				return c <= .03928 ? c / 12.92 : ((c + .055) / 1.055) ** 2.4;
 			});
 			return .2126 * r + .7152 * g + .0722 * b;
 		};
@@ -353,6 +408,35 @@ var Color = class Color {
 		].map((c) => c.applyOpacity(a * 100));
 	}
 	/**
+	* @instance Generates a color palette of evenly distributed hues based on the current color's saturation, lightness, and alpha.
+	*
+	* @remarks
+	* - Colors are spaced evenly around the color wheel (`360° / count` apart), starting from the current hue.
+	* - Saturation, lightness, and alpha from the source color are preserved across all generated colors.
+	*
+	* @typeParam N - A literal number type representing the palette size.
+	* @param count - The number of colors to generate in the palette (must be a positive integer ≥ `1`). Default: `7`.
+	* @param step - The step value (degree) to be added to the hue of the previous color. Default: `360 / count`.
+	* @returns Array of `Color` instances with the specified count.
+	*
+	* @example
+	* const red = new Color("#ff0000");
+	* const palette = red.generatePalette(4);
+	* console.log(palette.map((color) => color.hex));
+	* // ['#FF0000', '#80FF00', '#00FFFF', '#8000FF']
+	*/
+	generatePalette(count, step) {
+		const [h, s, l, a] = require_convert.extractAlphaColorValues(this.hsla);
+		const clampedCount = require_utilities.clampNumber(count ?? 7, 1, 360);
+		const calculatedStep = step ? require_utilities.clampNumber(step, 1, 360) : 360 / clampedCount;
+		const colors = [];
+		for (let i = 0; i < clampedCount; i++) {
+			const color = new Color(`hsl(${(h + calculatedStep * i) % 360}, ${s}%, ${l}%)`).applyOpacity(a * 100);
+			colors.push(color);
+		}
+		return colors;
+	}
+	/**
 	* @instance Gets the `WCAG` accessibility rating between this and another color.
 	* @param other - The other color to test contrast against.
 	* @returns `'Fail'`, `'AA'`, or `'AAA'` based on `WCAG 2.1` contrast standards.
@@ -374,6 +458,28 @@ var Color = class Color {
 		return (r * 299 + g * 587 + b * 114) / 1e3 > Math.min(255, Math.max(0, threshold));
 	}
 	/**
+	* @instance Convert the color to string.
+	* @returns The `Hex8` representation of the color.
+	*
+	* @remarks
+	* - Called by `String()`, `Object.prototype.toString()` or in template literals.
+	* - Uses the same implementation as `toJSON()`.
+	*/
+	toString() {
+		return this.hex8;
+	}
+	/**
+	* @instance Convert the color to JSON.
+	* @returns The `Hex8` representation of the color.
+	*
+	* @remarks
+	* - Called by `JSON.stringify()`.
+	* - It uses the same implementation as `toString()`.
+	*/
+	toJSON() {
+		return this.hex8;
+	}
+	/**
 	* @static Checks if a color is in {@link Hex6} format.
 	*
 	* @param color Color to check.
@@ -525,10 +631,10 @@ function getColorForInitial(input = "", opacity = 100) {
 		return require_guards._applyOpacity(DEFAULT, hexOpacity);
 	} else if (Array.isArray(input)) {
 		if (input?.length < 1) return [...require_constants.ALPHABET_COLOR_PALETTE, ...require_constants.NUMBER_COLOR_PALETTE].map((color) => require_guards._applyOpacity(color, hexOpacity));
-		return input.map((el) => {
+		return input.flatMap((el) => {
 			if (Array.isArray(el)) return getColorForInitial(el, opacity);
 			return getColorForInitial(el, opacity);
-		}).flat();
+		});
 	}
 	return require_guards._applyOpacity(DEFAULT, hexOpacity);
 }

package/dist/colors.d.cts

@@ -15,7 +15,7 @@
  */
 
 import { er as Percent } from "./object-DyVg8BFt.cjs";
-import { C as RandomColorOptions, S as RandomColor, T as SolidValues, _ as Hex, a as AlphaValues, b as RGB, g as HSLA, h as HSL, l as ColorInputArray, n as $ColorType, t as Color, v as Hex6, x as RGBA, y as Hex8 } from "./Color-asKZqwDF.cjs";
+import { C as RandomColorOptions, S as RandomColor, T as SolidValues, _ as Hex, a as AlphaValues, b as RGB, g as HSLA, h as HSL, l as ColorInputArray, n as $ColorType, t as Color, v as Hex6, x as RGBA, y as Hex8 } from "./Color-CVRcGmWe.cjs";
 
 //#region src/colors/convert.d.ts
 /**
@@ -203,7 +203,7 @@ declare function convertColorCode(color: HSLA): {
 //#endregion
 //#region src/colors/initials.d.ts
 /**
- *  * Generates a hex (`Hex8` format) color based on the first character (initial) of a string or number.
+ * * Generates a hex (`Hex8` format) color based on the first character (initial) of a string or number.
  *
  * - For numbers, it uses 10 predefined colors (0-9).
  * - For letters, it uses 26 predefined colors (A-Z).

package/dist/colors.d.mts

@@ -15,7 +15,7 @@
  */
 
 import { er as Percent } from "./object-DyVg8BFt.mjs";
-import { C as RandomColorOptions, S as RandomColor, T as SolidValues, _ as Hex, a as AlphaValues, b as RGB, g as HSLA, h as HSL, l as ColorInputArray, n as $ColorType, t as Color, v as Hex6, x as RGBA, y as Hex8 } from "./Color-B2SgCGbm.mjs";
+import { C as RandomColorOptions, S as RandomColor, T as SolidValues, _ as Hex, a as AlphaValues, b as RGB, g as HSLA, h as HSL, l as ColorInputArray, n as $ColorType, t as Color, v as Hex6, x as RGBA, y as Hex8 } from "./Color-CInCJvH7.mjs";
 
 //#region src/colors/convert.d.ts
 /**
@@ -203,7 +203,7 @@ declare function convertColorCode(color: HSLA): {
 //#endregion
 //#region src/colors/initials.d.ts
 /**
- *  * Generates a hex (`Hex8` format) color based on the first character (initial) of a string or number.
+ * * Generates a hex (`Hex8` format) color based on the first character (initial) of a string or number.
  *
  * - For numbers, it uses 10 predefined colors (0-9).
  * - For letters, it uses 26 predefined colors (A-Z).

package/dist/colors.mjs

@@ -16,8 +16,9 @@
 
 import { a as isNonEmptyString, c as isNumber, d as isString } from "./primitives-Djsevc69.mjs";
 import { t as CSS_COLORS } from "./css-colors-B-y4TmeC.mjs";
-import { c as _applyOpacity, l as _generateRandomHSL, n as isHSL, o as isRGB, r as isHSLA, s as isRGBA, u as _isSimilarToLast } from "./guards-DziDBD0p.mjs";
-import { _ as extractSolidColorValues, a as convertHexToRgb, c as convertHslaToHex8, d as convertRgbToHsl, f as convertRgbToRgba, g as extractAlphaColorValues, h as applyOpacityToHex, i as convertHexToHsl, l as convertHslaToRgba, m as convertRgbaToHsla, n as convertHex8ToHsla, o as convertHslToHex, p as convertRgbaToHex8, r as convertHex8ToRgba, s as convertHslToRgb, t as convertColorCode, u as convertRgbToHex, v as percentToHex } from "./convert-lXdkXPJR.mjs";
+import { c as _applyOpacity, l as _generateRandomHSL, n as isHSL, o as isRGB, r as isHSLA, s as isRGBA, u as _isSimilarToLast } from "./guards-CNG9gnvL.mjs";
+import { _ as extractSolidColorValues, a as convertHexToRgb, c as convertHslaToHex8, d as convertRgbToHsl, f as convertRgbToRgba, g as extractAlphaColorValues, h as applyOpacityToHex, i as convertHexToHsl, l as convertHslaToRgba, m as convertRgbaToHsla, n as convertHex8ToHsla, o as convertHslToHex, p as convertRgbaToHex8, r as convertHex8ToRgba, s as convertHslToRgb, t as convertColorCode, u as convertRgbToHex, v as percentToHex } from "./convert-DRZXcjcS.mjs";
+import { t as clampNumber } from "./utilities-BSv8VbnM.mjs";
 import { n as NUMBER_COLOR_PALETTE, t as ALPHABET_COLOR_PALETTE } from "./constants-DCZL77t-.mjs";
 
 //#region src/colors/random.ts
@@ -157,6 +158,18 @@ var Color = class Color {
 		yield this.hsla;
 	}
 	/**
+	* Allows the color to be used in string and number contexts.
+	* @param hint The hint to determine the conversion type.
+	*/
+	[Symbol.toPrimitive](hint) {
+		if (hint === "string") return this.hex8;
+		else if (hint === "number") {
+			const hex = this.hex8.endsWith("FF") ? this.hex : this.hex8;
+			return parseInt(hex.replace("#", "0x"), 16);
+		}
+		return this;
+	}
+	/**
 	* @private Convert `Hex6` color format to `Hex8` by applying `100%` opacity.
 	* @param hex `Hex6` color to convert to `Hex8`.
 	*/
@@ -180,11 +193,12 @@ var Color = class Color {
 		return `hsla(${h}, ${s}%, ${l}%, 1)`;
 	}
 	/**
-	* @instance Applies or modifies the opacity of a color and returns a new instance.
+	* @instance Sets the opacity of this color to the given **absolute** percentage and returns a new instance.
 	*
 	* @remarks
+	* - This is an **absolute setter**: passing `50` means "set opacity to exactly 50%", regardless of the current opacity.
 	* - For solid colors ({@link Hex6}/{@link RGB}/{@link HSL}): Adds an alpha channel with the specified opacity.
-	* - For alpha colors ({@link Hex8}/{@link RGBA}/{@link HSLA}): Updates the existing alpha channel.
+	* - For alpha colors ({@link Hex8}/{@link RGBA}/{@link HSLA}): Replaces the existing alpha channel.
 	*
 	* @param opacity - A number between `0-100` representing the opacity percentage.
 	* @returns A new instance of `Color` containing all color formats with the applied opacity.
@@ -203,40 +217,81 @@ var Color = class Color {
 		return new Color(`${this.hex.slice(0, 7)}${percentToHex(opacity)}`.toUpperCase());
 	}
 	/**
-	* @instance Darkens the color by reducing the lightness by the given percentage.
-	* @param percent - The percentage to darken (`0–100`).
-	* @returns A new `Color` instance with the modified darkness.
+	* @instance Darkens the color by **subtracting** the given percentage points from the current lightness in HSL space.
+	*
+	* @remarks
+	* - This is a **relative adjustment**: passing `20` means "reduce lightness by 20 percentage points" from its current value.
+	* - Lightness is clamped to `0%` at minimum.
+	* - The original alpha (opacity) is preserved in the returned color.
+	*
+	* @param percent - The percentage points to subtract from lightness (`0–100`).
+	* @returns A new `Color` instance with the reduced lightness.
+	*
+	* @example
+	* const blue = new Color("#0000ff"); // hsl(240, 100%, 50%)
+	* const darkerBlue = blue.applyDarkness(20);
+	* console.log(darkerBlue.hsl); // hsl(240, 100%, 30%)
 	*/
 	applyDarkness(percent) {
 		const [h, s, l, a] = extractAlphaColorValues(this.hsla);
 		return new Color(`hsl(${h}, ${s}%, ${Math.max(0, l - percent)}%)`).applyOpacity(a * 100);
 	}
 	/**
-	* @instance Lightens the color by increasing the lightness by the given percentage.
-	* @param percent - The percentage to brighten (`0–100`).
-	* @returns A new `Color` instance with the modified lightness.
+	* @instance Lightens the color by **adding** the given percentage points to the current lightness in HSL space.
+	*
+	* @remarks
+	* - This is a **relative adjustment**: passing `30` means "increase lightness by 30 percentage points" from its current value.
+	* - Lightness is clamped to `100%` at maximum.
+	* - The original alpha (opacity) is preserved in the returned color.
+	*
+	* @param percent - The percentage points to add to lightness (`0–100`).
+	* @returns A new `Color` instance with the increased lightness.
+	*
+	* @example
+	* const green = new Color("#008000"); // hsl(120, 100%, 25.1%)
+	* const lighterGreen = green.applyBrightness(30);
+	* console.log(lighterGreen.hsl); // hsl(120, 100%, 55.1%)
 	*/
 	applyBrightness(percent) {
 		const [h, s, l, a] = extractAlphaColorValues(this.hsla);
 		return new Color(`hsl(${h}, ${s}%, ${Math.min(100, l + percent)}%)`).applyOpacity(a * 100);
 	}
 	/**
-	* @instance Reduces the saturation of the color to make it appear duller.
-	* @param percent - The percentage to reduce saturation (`0–100`).
-	* @returns A new `Color` instance with the modified saturation.
+	* @instance Desaturates the color by **subtracting** the given percentage points from the current saturation in HSL space.
+	*
+	* @remarks
+	* - This is a **relative adjustment**: passing `50` means "reduce saturation by 50 percentage points" from its current value.
+	* - Saturation is clamped to `0%` at minimum (fully desaturated / grayscale).
+	* - The original alpha (opacity) is preserved in the returned color.
+	*
+	* @param percent - The percentage points to subtract from saturation (`0–100`).
+	* @returns A new `Color` instance with the reduced saturation.
+	*
+	* @example
+	* const pink = new Color("#ff69b4"); // hsl(330, 100%, 70.59%)
+	* const dullPink = pink.applyDullness(50);
+	* console.log(dullPink.hsl); // hsl(330, 50%, 70.59%)
 	*/
 	applyDullness(percent) {
 		const [h, s, l, a] = extractAlphaColorValues(this.hsla);
 		return new Color(`hsl(${h}, ${Math.max(0, s - percent)}%, ${l}%)`).applyOpacity(a * 100);
 	}
 	/**
-	* @instance Softens the color toward white by reducing saturation and increasing lightness based on a percentage.
+	* @instance Softens the color toward white by **proportionally** reducing saturation and increasing lightness.
 	*
 	* @remarks
-	* This creates a soft UI-like white shade effect (similar to some UI libraries' light color scale).
+	* - This is a **proportional blend**: passing `40` means "move 40% of the *remaining distance* toward pure white".
+	* - Unlike {@link applyBrightness} or {@link applyDullness}, the effect scales relative to the current distance from white, producing a natural pastel/tint effect.
+	* - This creates a soft UI-like white shade effect (similar to some UI libraries' light color scale).
+	* - The original alpha (opacity) is preserved in the returned color.
 	*
 	* @param percent - Value from `0` to `100` representing how far to push the color toward white.
 	* @returns A new `Color` instance shifted toward white.
+	*
+	* @example
+	* const purple = new Color("#800080"); // hsl(300, 100%, 25.1%)
+	* const softPurple = purple.applyWhiteShade(40);
+	* console.log(softPurple.hsl); // hsl(300, 60%, 55.06%)
 	*/
 	applyWhiteShade(percent) {
 		const [h, s, l, a] = extractAlphaColorValues(this.hsla);
@@ -257,14 +312,14 @@ var Color = class Color {
 	*/
 	blendWith(other, weight = .5) {
 		const w = Math.max(0, Math.min(1, weight));
-		const converted = Color.isCSSColor(other) ? new Color(other) : new Color(other);
-		const [r1, b1, g1, a1] = extractAlphaColorValues(this.rgba);
-		const [r2, b2, g2, a2] = extractAlphaColorValues(converted.rgba);
+		const converted = new Color(other);
+		const [r1, g1, b1, a1] = extractAlphaColorValues(this.rgba);
+		const [r2, g2, b2, a2] = extractAlphaColorValues(converted.rgba);
 		const alpha = Math.round((a1 * (1 - w) + a2 * w) * 100) / 100;
-		const blendChannel = (c1, c2) => {
+		const _blendChannel = (c1, c2) => {
 			return Math.round((c1 * a1 * (1 - w) + c2 * a2 * w) / alpha);
 		};
-		return new Color(`rgba(${blendChannel(r1, r2)}, ${blendChannel(g1, g2)}, ${blendChannel(b1, b2)}, ${alpha})`);
+		return new Color(`rgba(${_blendChannel(r1, r2)}, ${_blendChannel(g1, g2)}, ${_blendChannel(b1, b2)}, ${alpha})`);
 	}
 	/**
 	* @instance Calculates the contrast ratio between this color and another color (WCAG).
@@ -272,11 +327,11 @@ var Color = class Color {
 	* @returns A number representing the contrast ratio (rounded to 2 decimal places).
 	*/
 	contrastRatio(other) {
-		const newColor = Color.isCSSColor(other) ? new Color(other) : new Color(other);
+		const newColor = new Color(other);
 		const luminance = (rgb) => {
 			const [r, g, b] = extractSolidColorValues(rgb).map((v) => {
 				const c = v / 255;
-				return c <= .03928 ? c / 12.92 : Math.pow((c + .055) / 1.055, 2.4);
+				return c <= .03928 ? c / 12.92 : ((c + .055) / 1.055) ** 2.4;
 			});
 			return .2126 * r + .7152 * g + .0722 * b;
 		};
@@ -352,6 +407,35 @@ var Color = class Color {
 		].map((c) => c.applyOpacity(a * 100));
 	}
 	/**
+	* @instance Generates a color palette of evenly distributed hues based on the current color's saturation, lightness, and alpha.
+	*
+	* @remarks
+	* - Colors are spaced evenly around the color wheel (`360° / count` apart), starting from the current hue.
+	* - Saturation, lightness, and alpha from the source color are preserved across all generated colors.
+	*
+	* @typeParam N - A literal number type representing the palette size.
+	* @param count - The number of colors to generate in the palette (must be a positive integer ≥ `1`). Default: `7`.
+	* @param step - The step value (degree) to be added to the hue of the previous color. Default: `360 / count`.
+	* @returns Array of `Color` instances with the specified count.
+	*
+	* @example
+	* const red = new Color("#ff0000");
+	* const palette = red.generatePalette(4);
+	* console.log(palette.map((color) => color.hex));
+	* // ['#FF0000', '#80FF00', '#00FFFF', '#8000FF']
+	*/
+	generatePalette(count, step) {
+		const [h, s, l, a] = extractAlphaColorValues(this.hsla);
+		const clampedCount = clampNumber(count ?? 7, 1, 360);
+		const calculatedStep = step ? clampNumber(step, 1, 360) : 360 / clampedCount;
+		const colors = [];
+		for (let i = 0; i < clampedCount; i++) {
+			const color = new Color(`hsl(${(h + calculatedStep * i) % 360}, ${s}%, ${l}%)`).applyOpacity(a * 100);
+			colors.push(color);
+		}
+		return colors;
+	}
+	/**
 	* @instance Gets the `WCAG` accessibility rating between this and another color.
 	* @param other - The other color to test contrast against.
 	* @returns `'Fail'`, `'AA'`, or `'AAA'` based on `WCAG 2.1` contrast standards.
@@ -373,6 +457,28 @@ var Color = class Color {
 		return (r * 299 + g * 587 + b * 114) / 1e3 > Math.min(255, Math.max(0, threshold));
 	}
 	/**
+	* @instance Convert the color to string.
+	* @returns The `Hex8` representation of the color.
+	*
+	* @remarks
+	* - Called by `String()`, `Object.prototype.toString()` or in template literals.
+	* - Uses the same implementation as `toJSON()`.
+	*/
+	toString() {
+		return this.hex8;
+	}
+	/**
+	* @instance Convert the color to JSON.
+	* @returns The `Hex8` representation of the color.
+	*
+	* @remarks
+	* - Called by `JSON.stringify()`.
+	* - It uses the same implementation as `toString()`.
+	*/
+	toJSON() {
+		return this.hex8;
+	}
+	/**
 	* @static Checks if a color is in {@link Hex6} format.
 	*
 	* @param color Color to check.
@@ -524,10 +630,10 @@ function getColorForInitial(input = "", opacity = 100) {
 		return _applyOpacity(DEFAULT, hexOpacity);
 	} else if (Array.isArray(input)) {
 		if (input?.length < 1) return [...ALPHABET_COLOR_PALETTE, ...NUMBER_COLOR_PALETTE].map((color) => _applyOpacity(color, hexOpacity));
-		return input.map((el) => {
+		return input.flatMap((el) => {
 			if (Array.isArray(el)) return getColorForInitial(el, opacity);
 			return getColorForInitial(el, opacity);
-		}).flat();
+		});
 	}
 	return _applyOpacity(DEFAULT, hexOpacity);
 }

package/dist/constants.cjs

@@ -17,10 +17,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_constants = require('./constants-D_HkIg02.cjs');
 const require_css_colors = require('./css-colors-DC7oZ46Y.cjs');
-const require_constants$1 = require('./constants-BOs8tjzp.cjs');
-const require_constants$2 = require('./constants-CgFaV72Z.cjs');
+const require_constants$1 = require('./constants-B3nc8psr.cjs');
+const require_constants$2 = require('./constants-BOs8tjzp.cjs');
+const require_constants$3 = require('./constants-CgFaV72Z.cjs');
 const require_timezone = require('./timezone-CSz7R0L6.cjs');
-const require_constants$3 = require('./constants-B3nc8psr.cjs');
 const require_constants$4 = require('./constants-DIBRCBIP.cjs');
 const require_countries = require('./countries-C0x58zVg.cjs');
 const require_constants$5 = require('./constants-ZnFGKd7G.cjs');
@@ -376,17 +376,17 @@ const SEASON_PRESETS = /* @__PURE__ */ Object.freeze({
 });
 
 //#endregion
-exports.ALPHABET_COLOR_PALETTE = require_constants$1.ALPHABET_COLOR_PALETTE;
+exports.ALPHABET_COLOR_PALETTE = require_constants$2.ALPHABET_COLOR_PALETTE;
 exports.AUSTRALIA_SEASONS = AUSTRALIA_SEASONS;
 exports.BANGLADESH_SEASONS = BANGLADESH_SEASONS;
 exports.CATEGORIZED_UNITS = require_constants$4.UNITS;
 exports.COUNTRIES = require_countries.COUNTRIES;
 exports.CSS_COLORS = require_css_colors.CSS_COLORS;
-exports.CURRENCY_CODES = require_constants$3.CURRENCY_CODES;
-exports.CURRENCY_LOCALES = require_constants$3.CURRENCY_LOCALES;
+exports.CURRENCY_CODES = require_constants$1.CURRENCY_CODES;
+exports.CURRENCY_LOCALES = require_constants$1.CURRENCY_LOCALES;
 exports.ETHIOPIA_SEASONS = ETHIOPIA_SEASONS;
-exports.FRANKFURTER_CURRENCIES = require_constants$3.FRANKFURTER_CURRENCIES;
-exports.GENERAL_UNITS = require_constants$3.UNITS;
+exports.FRANKFURTER_CURRENCIES = require_constants$1.FRANKFURTER_CURRENCIES;
+exports.GENERAL_UNITS = require_constants$1.UNITS;
 exports.HTTP_CODES = require_constants$5.HTTP_STATUS_CODES;
 exports.HTTP_STATUS = require_constants$5.HTTP_STATUS_CODES;
 exports.HTTP_STATUS_CODES = require_constants$5.HTTP_STATUS_CODES;
@@ -395,11 +395,11 @@ exports.INDIA_IMD_SEASONS = INDIA_IMD_SEASONS;
 exports.INDIA_TAMIL_SEASONS = INDIA_TAMIL_SEASONS;
 exports.INDIA_VEDIC_SEASONS = INDIA_VEDIC_SEASONS;
 exports.JAPAN_SEASONS = JAPAN_SEASONS;
-exports.LOCALE_CODES = require_constants$3.LOCALE_CODES;
+exports.LOCALE_CODES = require_constants$1.LOCALE_CODES;
 exports.LOWERCASED_WORDS = require_constants.LOWERCASE;
-exports.MONTHS = require_constants$2.MONTHS;
+exports.MONTHS = require_constants$3.MONTHS;
 exports.NATIVE_TZ_IDS = require_timezone.NATIVE_TZ_IDS;
-exports.NUMBER_COLOR_PALETTE = require_constants$1.NUMBER_COLOR_PALETTE;
+exports.NUMBER_COLOR_PALETTE = require_constants$2.NUMBER_COLOR_PALETTE;
 exports.PHILIPPINES_SEASONS = PHILIPPINES_SEASONS;
 exports.SEASON_PRESETS = SEASON_PRESETS;
 exports.STATUS_CODES = require_constants$5.HTTP_STATUS_CODES;
@@ -409,7 +409,7 @@ exports.TIME_ZONE_IDS = require_timezone.TIME_ZONE_IDS;
 exports.TIME_ZONE_LABELS = require_timezone.TIME_ZONE_LABELS;
 exports.TZ_ABBREVIATIONS = require_timezone.TIME_ZONES;
 exports.US_ACADEMIC_SEASONS = US_ACADEMIC_SEASONS;
-exports.VEDIC_ZODIAC_SIGNS = require_constants$2.VEDIC_ZODIAC_SIGNS;
-exports.WEEK_DAYS = require_constants$2.DAYS;
+exports.VEDIC_ZODIAC_SIGNS = require_constants$3.VEDIC_ZODIAC_SIGNS;
+exports.WEEK_DAYS = require_constants$3.DAYS;
 exports.WESTERN_SEASONS = DEFAULT_SEASONS;
-exports.WESTERN_ZODIAC_SIGNS = require_constants$2.WESTERN_ZODIAC_SIGNS;
+exports.WESTERN_ZODIAC_SIGNS = require_constants$3.WESTERN_ZODIAC_SIGNS;

package/dist/constants.mjs

@@ -16,10 +16,10 @@
 
 import { t as LOWERCASE } from "./constants-B0zJiNqH.mjs";
 import { t as CSS_COLORS } from "./css-colors-B-y4TmeC.mjs";
+import { a as LOCALE_CODES, i as FRANKFURTER_CURRENCIES, n as CURRENCY_CODES, p as UNITS$1, r as CURRENCY_LOCALES } from "./constants-ZyfpysiQ.mjs";
 import { n as NUMBER_COLOR_PALETTE, t as ALPHABET_COLOR_PALETTE } from "./constants-DCZL77t-.mjs";
 import { c as WESTERN_ZODIAC_SIGNS, n as DAYS, r as MONTHS, s as VEDIC_ZODIAC_SIGNS } from "./constants-GZL_CT1W.mjs";
 import { a as TIME_ZONE_IDS, i as TIME_ZONES_NATIVE, n as NATIVE_TZ_IDS, o as TIME_ZONE_LABELS, r as TIME_ZONES, t as IANA_TZ_IDS } from "./timezone-avZ4TvDx.mjs";
-import { a as LOCALE_CODES, i as FRANKFURTER_CURRENCIES, n as CURRENCY_CODES, p as UNITS$1, r as CURRENCY_LOCALES } from "./constants-ZyfpysiQ.mjs";
 import { r as UNITS } from "./constants-ByLTHWQm.mjs";
 import { t as COUNTRIES } from "./countries-CMxHxKiK.mjs";
 import { t as HTTP_STATUS_CODES } from "./constants-BLAcLxOu.mjs";

package/dist/{convert-Cqy2Llek.cjs → convert-BjKz_hhr.cjs}

@@ -15,7 +15,7 @@
  */
 
 const require_primitives = require('./primitives-CBGICrDR.cjs');
-const require_guards = require('./guards-DGN95D2h.cjs');
+const require_guards = require('./guards-CrfVwk0-.cjs');
 
 //#region src/colors/utils.ts
 /**
@@ -160,7 +160,11 @@ const convertRgbToHsl = (r, g, b) => {
 * @returns A string representing the color in Hex format (e.g., `#FF0000`).
 */
 const convertHslToHex = (h, s, l) => {
-	const rgb = convertHslToRgb(h, s, l).match(/\d+/g).map(Number);
+	const rgb = convertHslToRgb(h, s, l).match(/\d+/g)?.map(Number) ?? [
+		0,
+		0,
+		0
+	];
 	return convertRgbToHex(rgb[0], rgb[1], rgb[2]);
 };
 /**

package/dist/{convert-lXdkXPJR.mjs → convert-DRZXcjcS.mjs}

@@ -15,7 +15,7 @@
  */
 
 import { a as isNonEmptyString, c as isNumber } from "./primitives-Djsevc69.mjs";
-import { a as isHex8, c as _applyOpacity, d as _isValidAlpha, i as isHex6, n as isHSL, o as isRGB, r as isHSLA, s as isRGBA } from "./guards-DziDBD0p.mjs";
+import { a as isHex8, c as _applyOpacity, d as _isValidAlpha, i as isHex6, n as isHSL, o as isRGB, r as isHSLA, s as isRGBA } from "./guards-CNG9gnvL.mjs";
 
 //#region src/colors/utils.ts
 /**
@@ -160,7 +160,11 @@ const convertRgbToHsl = (r, g, b) => {
 * @returns A string representing the color in Hex format (e.g., `#FF0000`).
 */
 const convertHslToHex = (h, s, l) => {
-	const rgb = convertHslToRgb(h, s, l).match(/\d+/g).map(Number);
+	const rgb = convertHslToRgb(h, s, l).match(/\d+/g)?.map(Number) ?? [
+		0,
+		0,
+		0
+	];
 	return convertRgbToHex(rgb[0], rgb[1], rgb[2]);
 };
 /**