toolbox-x 2.0.13 → 2.2.0

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]);
 };
 /**

package/dist/date.cjs

@@ -16,12 +16,12 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primitives = require('./primitives-CBGICrDR.cjs');
+const require_specials = require('./specials-DU8u108m.cjs');
+const require_utilities = require('./utilities-BVpk3LKy.cjs');
 const require_constants = require('./constants-CgFaV72Z.cjs');
 const require_timezone = require('./timezone-CSz7R0L6.cjs');
-const require_specials = require('./specials-dkYP1Nh2.cjs');
-const require_utilities = require('./utilities-CWV1GPGY.cjs');
-const require_parse = require('./parse-CbVVRoFY.cjs');
-const require_basics = require('./basics-Bb5ovcvz.cjs');
+const require_parse = require('./parse-jh637S25.cjs');
+const require_guards = require('./guards-CqbVT4L5.cjs');
 
 //#region src/date/calculation.ts
 /**
@@ -180,7 +180,7 @@ const TZ_MAP = /* @__PURE__ */ new Map();
 * @returns An array of matching IANA time-zone identifiers, or an empty array if the offset is invalid.
 */
 function getTimeZoneIds(offset) {
-	if (!require_basics.isValidUTCOffset(offset)) return [];
+	if (!require_guards.isValidUTCOffset(offset)) return [];
 	if (TZ_MAP.has(offset)) return TZ_MAP.get(offset) ?? [];
 	for (const zone of require_timezone.NATIVE_TZ_IDS) {
 		const off = require_parse._gmtToUtcOffset(require_parse._resolveNativeTzName(zone, "longOffset"));
@@ -351,7 +351,7 @@ function getGreeting(configs) {
 	const { morningEnds = "11:59", noonEnds = "12:59", afternoonEnds = "17:59", eveningEnds = "23:59", midnightEnds = "02:59", currentTime, appendToMsg = "", prependToMsg = "", morningMessage = "Good Morning!", noonMessage = "Good Noon!", afternoonMessage = "Good Afternoon!", eveningMessage = "Good Evening!", midnightMessage = "Hello, Night Owl!", defaultMessage = "Greetings!" } = configs || {};
 	let hour;
 	let minute;
-	if (currentTime && require_basics.isValidTime(currentTime)) [hour, minute] = extractHourMinute(currentTime);
+	if (currentTime && require_guards.isValidTime(currentTime)) [hour, minute] = extractHourMinute(currentTime);
 	else {
 		hour = getCurrentDateTime().getHours();
 		minute = getCurrentDateTime().getMinutes();

package/dist/date.mjs

@@ -15,12 +15,12 @@
  */
 
 import { c as isNumber, m as isUndefined } from "./primitives-Djsevc69.mjs";
+import { E as isObjectWithKeys, T as isObject } from "./specials-krf7zsqI.mjs";
+import { a as normalizeNumber } from "./utilities-BSv8VbnM.mjs";
 import { a as RELATIVE_TIME_DIVISIONS, t as DATE_UNIT_SETTERS } from "./constants-GZL_CT1W.mjs";
 import { n as NATIVE_TZ_IDS } from "./timezone-avZ4TvDx.mjs";
-import { E as isObjectWithKeys, T as isObject } from "./specials-Hq5Ncd6y.mjs";
-import { a as normalizeNumber } from "./utilities-DPscNbS1.mjs";
-import { a as _normalizeOffset, i as _gmtToUtcOffset, n as _dateArgsToDate, o as _resolveNativeTzName, r as _formatDate, t as parseMSec } from "./parse-DUJ0YThn.mjs";
-import { Q as isValidTime, et as isValidUTCOffset } from "./basics-Dald7J6c.mjs";
+import { a as _normalizeOffset, i as _gmtToUtcOffset, n as _dateArgsToDate, o as _resolveNativeTzName, r as _formatDate, t as parseMSec } from "./parse-TuFyLeVH.mjs";
+import { a as isValidTime, s as isValidUTCOffset } from "./guards-DKGBsd6x.mjs";
 
 //#region src/date/calculation.ts
 /**

package/dist/dom.cjs

@@ -16,9 +16,10 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primitives = require('./primitives-CBGICrDR.cjs');
-const require_specials = require('./specials-dkYP1Nh2.cjs');
-const require_basics = require('./basics-Bb5ovcvz.cjs');
-const require_query = require('./query-BUBCpo-q.cjs');
+const require_specials = require('./specials-DU8u108m.cjs');
+const require_guards = require('./guards-CqbVT4L5.cjs');
+const require_basics = require('./basics-byj0VH1c.cjs');
+const require_query = require('./query-sWSi-d7u.cjs');
 
 //#region src/dom/storage.ts
 /**
@@ -229,8 +230,8 @@ const createFormData = (data, configs) => {
 			const transformedKey = _transformKey(key);
 			const fullKey = parentKey ? `${parentKey}.${transformedKey}` : transformedKey;
 			if (_compareKeyPaths(fullKey, ignoreKeys)) return acc;
-			if (value != null && value !== "" || _isRequiredKey(fullKey) || require_primitives.isNonEmptyString(value) || require_specials.isValidArray(value) || require_specials.isNotEmptyObject(value)) if (require_basics.isDateLike(value)) acc[transformedKey] = value;
-			else if (require_specials.isNotEmptyObject(value)) if (require_basics.isDateLike(value)) acc[transformedKey] = value;
+			if (value != null && value !== "" || _isRequiredKey(fullKey) || require_primitives.isNonEmptyString(value) || require_specials.isValidArray(value) || require_specials.isNotEmptyObject(value)) if (require_guards.isDateLike(value)) acc[transformedKey] = value;
+			else if (require_specials.isNotEmptyObject(value)) if (require_guards.isDateLike(value)) acc[transformedKey] = value;
 			else {
 				const cleaned = _cleanObject(value, fullKey);
 				if (_isRequiredKey(fullKey) || require_specials.isNotEmptyObject(cleaned)) acc[transformedKey] = cleaned;
@@ -253,13 +254,13 @@ const createFormData = (data, configs) => {
 	const _addToFormData = (key, value) => {
 		const transformedKey = _transformKey(key);
 		if (_compareKeyPaths(transformedKey, ignoreKeys)) return;
-		if (require_query.isCustomFileArray(value)) value?.forEach((file) => formData.append(transformedKey, file?.originFileObj));
+		if (require_query.isCustomFileArray(value)) for (const file of value) formData.append(transformedKey, file?.originFileObj);
 		else if (require_query.isFileUpload(value)) {
-			if (value?.fileList) value?.fileList.forEach((file) => formData.append(transformedKey, file?.originFileObj));
+			if (value?.fileList) for (const file of value.fileList) formData.append(transformedKey, file?.originFileObj);
 			else if (value?.file) if (require_query.isCustomFile(value?.file)) formData.append(transformedKey, value?.file?.originFileObj);
 			else formData.append(transformedKey, value?.file);
 		} else if (require_query.isFileOrBlob(value)) formData.append(transformedKey, value);
-		else if (require_query.isFileList(value)) for (let i = 0; i < value?.length; i++) formData.append(transformedKey, value.item(i));
+		else if (require_query.isFileList(value)) for (let i = 0; i < value?.length; i++) formData.append(transformedKey, value?.item(i));
 		else if (Array.isArray(value)) {
 			if (require_query.isFileArray(value)) if (_shouldBreakArray(key)) value?.forEach((item, index) => {
 				_addToFormData(`${transformedKey}[${index}]`, item);
@@ -272,7 +273,7 @@ const createFormData = (data, configs) => {
 			});
 			else formData.append(transformedKey, JSON.stringify(value));
 			else if (_isRequiredKey(key)) formData.append(transformedKey, JSON.stringify(value));
-		} else if (require_basics.isDateLike(value)) formData.append(transformedKey, _parseDateLike(value));
+		} else if (require_guards.isDateLike(value)) formData.append(transformedKey, _parseDateLike(value));
 		else if (require_specials.isNotEmptyObject(value)) if (_shouldStringify(key) && !_shouldDotNotate(key)) {
 			const cleanedValue = _cleanObject(value, key);
 			if (require_specials.isNotEmptyObject(cleanedValue) || _isRequiredKey(key)) formData.append(transformedKey, JSON.stringify(cleanedValue));
@@ -294,10 +295,10 @@ const createFormData = (data, configs) => {
 			if (_compareKeyPaths(fullKey, ignoreKeys)) return;
 			if (configs?.trimStrings && require_primitives.isNonEmptyString(value)) value = require_basics.trimString(value);
 			if (_shouldDotNotate(fullKey)) _addToFormData(fullKey, value);
-			else if (require_specials.isNotEmptyObject(value) && !_shouldStringify(fullKey)) if (require_basics.isDateLike(value)) _addToFormData(key, _parseDateLike(value));
+			else if (require_specials.isNotEmptyObject(value) && !_shouldStringify(fullKey)) if (require_guards.isDateLike(value)) _addToFormData(key, _parseDateLike(value));
 			else _processObject(value, key);
 			else if (require_query.isFileOrBlob(value)) _addToFormData(key, value);
-			else if (require_basics.isDateLike(value)) _addToFormData(key, _parseDateLike(value));
+			else if (require_guards.isDateLike(value)) _addToFormData(key, _parseDateLike(value));
 			else if (require_specials.isEmptyObject(value)) {
 				if (_isRequiredKey(fullKey)) _addToFormData(key, JSON.stringify(value));
 			} else _addToFormData(key, value);

package/dist/dom.d.cts

@@ -16,7 +16,7 @@
 
 import { J as Deserializer, ft as Serializer, y as GenericObject } from "./object-DyVg8BFt.cjs";
 import { a as updateQueryParam, i as parseQueryStringLiteral, n as getQueryParams, r as parseQueryString, t as generateQueryParams } from "./query-BLsaWi3q.cjs";
-import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "./form-CHFqlgPr.cjs";
+import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "./form-DA-YShnM.cjs";
 
 //#region src/dom/storage.d.ts
 /**
@@ -166,6 +166,6 @@ declare function serializeForm<T extends boolean = false>(form: HTMLFormElement,
  * @param parsePrimitives - Whether to parse string values into primitive types (e.g., boolean, number, array, object). Defaults to `true`.
  * @returns The parsed form data as an object.
  */
-declare function parseFormData<T extends FormData | string>(data: T, parsePrimitives?: boolean): ParsedFormData<T>;
+declare function parseFormData<D extends FormData | string, P extends boolean = true>(data: D, parsePrimitives?: P): ParsedFormData<D, P>;
 //#endregion
 export { createFormData as convertToFormData, createFormData, copyToClipboard, generateQueryParams as createQueryParams, generateQueryParams as formatQueryParams, generateQueryParams, getFromLocalStorage, getFromSessionStorage, getQueryParams, parseQueryString as getQueryStringAsObject, parseQueryString, parseQueryString as queryStringToObject, isCustomFile, isCustomFileArray, isFileArray, isFileList, isFileOrBlob, isFileUpload, isOriginFileObj, isValidFormData, parseQueryStringLiteral as literalQueryStringToObject, parseQueryStringLiteral, parseFormData, removeFromLocalStorage, removeFromSessionStorage, saveToLocalStorage, saveToSessionStorage, serializeForm, smoothScrollTo, toggleFullScreen, updateQueryParam };

package/dist/dom.d.mts

@@ -16,7 +16,7 @@
 
 import { J as Deserializer, ft as Serializer, y as GenericObject } from "./object-DyVg8BFt.mjs";
 import { a as updateQueryParam, i as parseQueryStringLiteral, n as getQueryParams, r as parseQueryString, t as generateQueryParams } from "./query-Bi_ofCBp.mjs";
-import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "./form-crhNgN40.mjs";
+import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "./form-DIYoIS0E.mjs";
 
 //#region src/dom/storage.d.ts
 /**
@@ -166,6 +166,6 @@ declare function serializeForm<T extends boolean = false>(form: HTMLFormElement,
  * @param parsePrimitives - Whether to parse string values into primitive types (e.g., boolean, number, array, object). Defaults to `true`.
  * @returns The parsed form data as an object.
  */
-declare function parseFormData<T extends FormData | string>(data: T, parsePrimitives?: boolean): ParsedFormData<T>;
+declare function parseFormData<D extends FormData | string, P extends boolean = true>(data: D, parsePrimitives?: P): ParsedFormData<D, P>;
 //#endregion
 export { createFormData as convertToFormData, createFormData, copyToClipboard, generateQueryParams as createQueryParams, generateQueryParams as formatQueryParams, generateQueryParams, getFromLocalStorage, getFromSessionStorage, getQueryParams, parseQueryString as getQueryStringAsObject, parseQueryString, parseQueryString as queryStringToObject, isCustomFile, isCustomFileArray, isFileArray, isFileList, isFileOrBlob, isFileUpload, isOriginFileObj, isValidFormData, parseQueryStringLiteral as literalQueryStringToObject, parseQueryStringLiteral, parseFormData, removeFromLocalStorage, removeFromSessionStorage, saveToLocalStorage, saveToSessionStorage, serializeForm, smoothScrollTo, toggleFullScreen, updateQueryParam };

package/dist/dom.mjs

@@ -15,9 +15,10 @@
  */
 
 import { a as isNonEmptyString, d as isString } from "./primitives-Djsevc69.mjs";
-import { j as isValidArray, v as isEmptyObject, w as isNotEmptyObject } from "./specials-Hq5Ncd6y.mjs";
-import { J as isDateLike, n as trimString } from "./basics-Dald7J6c.mjs";
-import { C as isValidFormData, S as isOriginFileObj, _ as isCustomFileArray, a as updateQueryParam, b as isFileOrBlob, g as isCustomFile, i as parseQueryStringLiteral, m as parseObjectValues, n as getQueryParams, r as parseQueryString, t as generateQueryParams, v as isFileArray, x as isFileUpload, y as isFileList } from "./query-B4Lrr5Vt.mjs";
+import { j as isValidArray, v as isEmptyObject, w as isNotEmptyObject } from "./specials-krf7zsqI.mjs";
+import { t as isDateLike } from "./guards-DKGBsd6x.mjs";
+import { n as trimString } from "./basics-20lm69yy.mjs";
+import { C as isValidFormData, S as isOriginFileObj, _ as isCustomFileArray, a as updateQueryParam, b as isFileOrBlob, g as isCustomFile, i as parseQueryStringLiteral, m as parseObjectValues, n as getQueryParams, r as parseQueryString, t as generateQueryParams, v as isFileArray, x as isFileUpload, y as isFileList } from "./query-BomnyWh3.mjs";
 
 //#region src/dom/storage.ts
 /**
@@ -252,13 +253,13 @@ const createFormData = (data, configs) => {
 	const _addToFormData = (key, value) => {
 		const transformedKey = _transformKey(key);
 		if (_compareKeyPaths(transformedKey, ignoreKeys)) return;
-		if (isCustomFileArray(value)) value?.forEach((file) => formData.append(transformedKey, file?.originFileObj));
+		if (isCustomFileArray(value)) for (const file of value) formData.append(transformedKey, file?.originFileObj);
 		else if (isFileUpload(value)) {
-			if (value?.fileList) value?.fileList.forEach((file) => formData.append(transformedKey, file?.originFileObj));
+			if (value?.fileList) for (const file of value.fileList) formData.append(transformedKey, file?.originFileObj);
 			else if (value?.file) if (isCustomFile(value?.file)) formData.append(transformedKey, value?.file?.originFileObj);
 			else formData.append(transformedKey, value?.file);
 		} else if (isFileOrBlob(value)) formData.append(transformedKey, value);
-		else if (isFileList(value)) for (let i = 0; i < value?.length; i++) formData.append(transformedKey, value.item(i));
+		else if (isFileList(value)) for (let i = 0; i < value?.length; i++) formData.append(transformedKey, value?.item(i));
 		else if (Array.isArray(value)) {
 			if (isFileArray(value)) if (_shouldBreakArray(key)) value?.forEach((item, index) => {
 				_addToFormData(`${transformedKey}[${index}]`, item);

package/dist/{form-CHFqlgPr.d.cts → form-DA-YShnM.d.cts}

@@ -14,8 +14,9 @@
  * limitations under the License.
  */
 
-import { S as KeyForObject, T as NestedKeyString, ai as RequireExactly, u as DotNotationKey, x as KeyForArray } from "./object-DyVg8BFt.cjs";
+import { S as KeyForObject, T as NestedKeyString, ai as RequireExactly, at as NormalPrimitive, u as DotNotationKey, x as KeyForArray } from "./object-DyVg8BFt.cjs";
 import { F as QueryString } from "./string-EMT7czsU.cjs";
+import { f as TypeOrArray } from "./array-EVkwcL_k.cjs";
 
 //#region src/types/form.d.ts
 /** - Configuration options to control FormData generation behavior. */
@@ -111,6 +112,6 @@ interface FileError extends Error {
 /** THe return type of `serializeForm` wither as object or query string. */
 type SerializedForm<T extends boolean> = T extends false ? Record<string, string | string[]> : QueryString;
 /** * Represents the parsed form data. */
-type ParsedFormData<T> = T extends string ? Record<string, string | string[]> : Record<string, string | string[] | File | File[]>;
+type ParsedFormData<T extends FormData | string, P extends boolean> = T extends string ? Record<string, P extends true ? TypeOrArray<NormalPrimitive> : TypeOrArray<string>> : Record<string, P extends true ? TypeOrArray<NormalPrimitive | File> : TypeOrArray<string | File>>;
 //#endregion
 export { OriginFileObj as a, FormDataConfigs as i, FileError as n, ParsedFormData as o, FileUpload as r, SerializedForm as s, CustomFile as t };

package/dist/{form-crhNgN40.d.mts → form-DIYoIS0E.d.mts}

@@ -14,8 +14,9 @@
  * limitations under the License.
  */
 
-import { S as KeyForObject, T as NestedKeyString, ai as RequireExactly, u as DotNotationKey, x as KeyForArray } from "./object-DyVg8BFt.mjs";
+import { S as KeyForObject, T as NestedKeyString, ai as RequireExactly, at as NormalPrimitive, u as DotNotationKey, x as KeyForArray } from "./object-DyVg8BFt.mjs";
 import { F as QueryString } from "./string-GQsmDdYa.mjs";
+import { f as TypeOrArray } from "./array-CbAKXvhH.mjs";
 
 //#region src/types/form.d.ts
 /** - Configuration options to control FormData generation behavior. */
@@ -111,6 +112,6 @@ interface FileError extends Error {
 /** THe return type of `serializeForm` wither as object or query string. */
 type SerializedForm<T extends boolean> = T extends false ? Record<string, string | string[]> : QueryString;
 /** * Represents the parsed form data. */
-type ParsedFormData<T> = T extends string ? Record<string, string | string[]> : Record<string, string | string[] | File | File[]>;
+type ParsedFormData<T extends FormData | string, P extends boolean> = T extends string ? Record<string, P extends true ? TypeOrArray<NormalPrimitive> : TypeOrArray<string>> : Record<string, P extends true ? TypeOrArray<NormalPrimitive | File> : TypeOrArray<string | File>>;
 //#endregion
 export { OriginFileObj as a, FormDataConfigs as i, FileError as n, ParsedFormData as o, FileUpload as r, SerializedForm as s, CustomFile as t };

package/dist/{guards-D8Iz6EEy.cjs → guards-BSwFQX1M.cjs}

@@ -15,9 +15,9 @@
  */
 
 const require_primitives = require('./primitives-CBGICrDR.cjs');
-const require_specials = require('./specials-dkYP1Nh2.cjs');
-const require_utilities = require('./utilities-CWV1GPGY.cjs');
-const require_basics = require('./basics-Bb5ovcvz.cjs');
+const require_specials = require('./specials-DU8u108m.cjs');
+const require_utilities = require('./utilities-BVpk3LKy.cjs');
+const require_basics = require('./basics-byj0VH1c.cjs');
 
 //#region src/object/basics.ts
 /**

package/dist/{guards-DziDBD0p.mjs → guards-CNG9gnvL.mjs}

@@ -65,7 +65,7 @@ const _isSimilarToLast = (recentColors, newColor) => {
 * @returns `true` if it's a valid alpha value, `false` if not.
 */
 function _isValidAlpha(value) {
-	return value >= 0 && value <= 1 && !isNaN(value);
+	return value >= 0 && value <= 1 && !Number.isNaN(value);
 }
 /** @private Validates RGB component (0–255). */
 function _isValidRGBComponent(value) {