toolbox-x 2.4.2 → 2.4.4

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to **toolbox-x** will be documented in this file.
 
 > Auto-generated from git history using [changelog-maker](https://github.com/nodejs/changelog-maker).
 
+## [v2.4.4](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v2.4.4) — 2026-06-28
+
+[Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v2.4.2...v2.4.4)
+
+* \[[`5565185e11`](https://github.com/nazmul-nhb/toolbox-x/commit/5565185e11)] - 🧼 refactor(date): all conversion into `Date` object is now immutable (Nazmul Hassan)
+* \[[`592d976acc`](https://github.com/nazmul-nhb/toolbox-x/commit/592d976acc)] - 🛠️ chore: updated editor config and deps (Nazmul Hassan)
+* \[[`a3b28009a8`](https://github.com/nazmul-nhb/toolbox-x/commit/a3b28009a8)] - 🔧 update(docs): updated docs for `addDate` (Nazmul Hassan)
+* \[[`0f6476e6b0`](https://github.com/nazmul-nhb/toolbox-x/commit/0f6476e6b0)] - 🔧 update(package.json): added more keywords (Nazmul Hassan)
+* \[[`d1c6ff4282`](https://github.com/nazmul-nhb/toolbox-x/commit/d1c6ff4282)] - 🔧 update(docs): updated docs for natural sort utility (Nazmul Hassan)
+* \[[`56a8e690d5`](https://github.com/nazmul-nhb/toolbox-x/commit/56a8e690d5)] - 📚 docs: updated CHANGELOG.md for v2.4.2 (github-actions\[bot])
+
 ## [v2.4.2](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v2.4.2) — 2026-06-17
 
 [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v2.4.1...v2.4.2)

package/dist/{basics-CiT7tnu_.cjs → basics-CUzK7wFN.cjs}

@@ -15,7 +15,7 @@
  */
 
 const require_primitives = require('./primitives-CBGICrDR.cjs');
-const require_utils = require('./utils-C4yOIzOJ.cjs');
+const require_utils = require('./utils-BxZGABHS.cjs');
 const require_specials = require('./specials-DU8u108m.cjs');
 const require_utilities = require('./utilities-_COSGq1U.cjs');
 

package/dist/{basics-9MqP9Ecm.mjs → basics-KYRpMQNe.mjs}

@@ -15,7 +15,7 @@
  */
 
 import { d as isString, m as isUndefined } from "./primitives-Djsevc69.mjs";
-import { $ as trimString, m as stableStringify } from "./utils-C0NzTJMR.mjs";
+import { $ as trimString, m as stableStringify } from "./utils-DcRr0A7B.mjs";
 import { b as isFunction, w as isNotEmptyObject } from "./specials-krf7zsqI.mjs";
 import { a as normalizeNumber } from "./utilities-CmPwOkdy.mjs";
 

package/dist/{constants-ByLTHWQm.mjs → constants-B6yqsqJ5.mjs}

@@ -123,12 +123,12 @@ const IRREGULAR_PLURALS = /* @__PURE__ */ Object.freeze({
 	millennium: "millennia",
 	century: "centuries"
 });
-const INVARIANT_UNITS = /* @__PURE__ */ Object.freeze(new Set([
+const INVARIANT_UNITS = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ new Set([
 	"celsius",
 	"fahrenheit",
 	"kelvin"
 ]));
-const Y_TO_IES = /* @__PURE__ */ Object.freeze(new Set(["century"]));
+const Y_TO_IES = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ new Set(["century"]));
 
 //#endregion
 export { Y_TO_IES as i, IRREGULAR_PLURALS as n, UNITS as r, INVARIANT_UNITS as t };

package/dist/{constants-DIBRCBIP.cjs → constants-BUJG8exj.cjs}

@@ -124,12 +124,12 @@ const IRREGULAR_PLURALS = /* @__PURE__ */ Object.freeze({
 	millennium: "millennia",
 	century: "centuries"
 });
-const INVARIANT_UNITS = /* @__PURE__ */ Object.freeze(new Set([
+const INVARIANT_UNITS = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ new Set([
 	"celsius",
 	"fahrenheit",
 	"kelvin"
 ]));
-const Y_TO_IES = /* @__PURE__ */ Object.freeze(new Set(["century"]));
+const Y_TO_IES = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ new Set(["century"]));
 
 //#endregion
 Object.defineProperty(exports, 'INVARIANT_UNITS', {

package/dist/constants.cjs

@@ -21,7 +21,7 @@ const require_timezone = require('./timezone-CSz7R0L6.cjs');
 const require_constants$2 = require('./constants-BOs8tjzp.cjs');
 const require_css_colors = require('./css-colors-DC7oZ46Y.cjs');
 const require_constants$3 = require('./constants-B3nc8psr.cjs');
-const require_constants$4 = require('./constants-DIBRCBIP.cjs');
+const require_constants$4 = require('./constants-BUJG8exj.cjs');
 const require_countries = require('./countries-C0x58zVg.cjs');
 const require_constants$5 = require('./constants-ZnFGKd7G.cjs');
 

package/dist/constants.mjs

@@ -20,7 +20,7 @@ import { a as TIME_ZONE_IDS, i as TIME_ZONES_NATIVE, n as NATIVE_TZ_IDS, o as TI
 import { n as NUMBER_COLOR_PALETTE, t as ALPHABET_COLOR_PALETTE } from "./constants-DCZL77t-.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 { r as UNITS } from "./constants-ByLTHWQm.mjs";
+import { r as UNITS } from "./constants-B6yqsqJ5.mjs";
 import { t as COUNTRIES } from "./countries-CMxHxKiK.mjs";
 import { t as HTTP_STATUS_CODES } from "./constants-BLAcLxOu.mjs";
 

package/dist/converter/index.cjs

@@ -15,7 +15,7 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_constants = require('../constants-DIBRCBIP.cjs');
+const require_constants = require('../constants-BUJG8exj.cjs');
 
 //#region src/converter/base.ts
 /**

package/dist/converter/index.mjs

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { i as Y_TO_IES, n as IRREGULAR_PLURALS, r as UNITS, t as INVARIANT_UNITS } from "../constants-ByLTHWQm.mjs";
+import { i as Y_TO_IES, n as IRREGULAR_PLURALS, r as UNITS, t as INVARIANT_UNITS } from "../constants-B6yqsqJ5.mjs";
 
 //#region src/converter/base.ts
 /**

package/dist/date/index.cjs

@@ -20,8 +20,8 @@ const require_constants = require('../constants-CgFaV72Z.cjs');
 const require_timezone = require('../timezone-CSz7R0L6.cjs');
 const require_specials = require('../specials-DU8u108m.cjs');
 const require_utilities = require('../utilities-_COSGq1U.cjs');
-const require_guards = require('../guards-BD2Fkugj.cjs');
-const require_parse = require('../parse-CffWYCuy.cjs');
+const require_guards = require('../guards-DalSfIxV.cjs');
+const require_parse = require('../parse-Dz186-PH.cjs');
 
 //#region src/date/calculation.ts
 /**
@@ -47,9 +47,8 @@ const require_parse = require('../parse-CffWYCuy.cjs');
 * ```
 */
 function addDate(date, units) {
-	const $date = require_parse._dateArgsToDate(date);
-	if (Number.isNaN($date.getTime())) throw new TypeError("Provided date is invalid!");
-	const expected = new Date($date);
+	const expected = require_parse._dateArgsToDate(date);
+	if (Number.isNaN(expected.getTime())) throw new TypeError("Provided date is invalid!");
 	for (const [unit, value] of Object.entries(units)) {
 		const val = require_utilities.normalizeNumber(value);
 		if (!require_specials.isObjectWithKeys(require_constants.DATE_UNIT_SETTERS, [unit]) || !require_primitives.isNumber(val)) throw new TypeError(`Provided unit or value is invalid!`);

package/dist/date/index.mjs

@@ -19,8 +19,8 @@ import { a as RELATIVE_TIME_DIVISIONS, t as DATE_UNIT_SETTERS } from "../constan
 import { n as NATIVE_TZ_IDS } from "../timezone-avZ4TvDx.mjs";
 import { E as isObjectWithKeys, T as isObject } from "../specials-krf7zsqI.mjs";
 import { a as normalizeNumber } from "../utilities-CmPwOkdy.mjs";
-import { a as isValidTime, s as isValidUTCOffset } from "../guards-DBunDnng.mjs";
-import { a as _normalizeOffset, i as _gmtToUtcOffset, n as _dateArgsToDate, o as _resolveNativeTzName, r as _formatDate, t as parseMSec } from "../parse-CILDG7TG.mjs";
+import { a as isValidTime, s as isValidUTCOffset } from "../guards-CyOZsZ1r.mjs";
+import { a as _normalizeOffset, i as _gmtToUtcOffset, n as _dateArgsToDate, o as _resolveNativeTzName, r as _formatDate, t as parseMSec } from "../parse-CsTFudDu.mjs";
 
 //#region src/date/calculation.ts
 /**
@@ -46,9 +46,8 @@ import { a as _normalizeOffset, i as _gmtToUtcOffset, n as _dateArgsToDate, o as
 * ```
 */
 function addDate(date, units) {
-	const $date = _dateArgsToDate(date);
-	if (Number.isNaN($date.getTime())) throw new TypeError("Provided date is invalid!");
-	const expected = new Date($date);
+	const expected = _dateArgsToDate(date);
+	if (Number.isNaN(expected.getTime())) throw new TypeError("Provided date is invalid!");
 	for (const [unit, value] of Object.entries(units)) {
 		const val = normalizeNumber(value);
 		if (!isObjectWithKeys(DATE_UNIT_SETTERS, [unit]) || !isNumber(val)) throw new TypeError(`Provided unit or value is invalid!`);

package/dist/dom/index.cjs

@@ -16,10 +16,10 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primitives = require('../primitives-CBGICrDR.cjs');
-const require_utils = require('../utils-C4yOIzOJ.cjs');
+const require_utils = require('../utils-BxZGABHS.cjs');
 const require_specials = require('../specials-DU8u108m.cjs');
-const require_guards = require('../guards-BD2Fkugj.cjs');
-const require_query = require('../query-lGVoAJl3.cjs');
+const require_guards = require('../guards-DalSfIxV.cjs');
+const require_query = require('../query-iJflCkq1.cjs');
 
 //#region src/dom/storage.ts
 /**

package/dist/dom/index.mjs

@@ -15,10 +15,10 @@
  */
 
 import { a as isNonEmptyString, d as isString } from "../primitives-Djsevc69.mjs";
-import { $ as trimString } from "../utils-C0NzTJMR.mjs";
+import { $ as trimString } from "../utils-DcRr0A7B.mjs";
 import { j as isValidArray, v as isEmptyObject, w as isNotEmptyObject } from "../specials-krf7zsqI.mjs";
-import { t as isDateLike } from "../guards-DBunDnng.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-Cp1dq-qU.mjs";
+import { t as isDateLike } from "../guards-CyOZsZ1r.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-B8VPCIKA.mjs";
 
 //#region src/dom/storage.ts
 /**

package/dist/guards/index.cjs

@@ -16,11 +16,11 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primitives = require('../primitives-CBGICrDR.cjs');
-const require_utils = require('../utils-C4yOIzOJ.cjs');
+const require_utils = require('../utils-BxZGABHS.cjs');
 const require_specials = require('../specials-DU8u108m.cjs');
-const require_basics = require('../basics-CiT7tnu_.cjs');
+const require_basics = require('../basics-CUzK7wFN.cjs');
 const require_guards = require('../guards-CrfVwk0-.cjs');
-const require_guards$1 = require('../guards-BD2Fkugj.cjs');
+const require_guards$1 = require('../guards-DalSfIxV.cjs');
 
 exports.areInvalidNumbers = require_basics.areInvalidNumbers;
 exports.areNumbersInvalid = require_basics.areInvalidNumbers;

package/dist/guards/index.mjs

@@ -15,10 +15,10 @@
  */
 
 import { a as isNonEmptyString, c as isNumber, d as isString, f as isSymbol, i as isInteger, l as isPositiveInteger, m as isUndefined, n as isBoolean, o as isNormalPrimitive, p as isTruthy, r as isFalsy, s as isNull, t as isBigInt, u as isPrimitive } from "../primitives-Djsevc69.mjs";
-import { C as isUUIDv2, D as isUUIDv6, E as isUUIDv5, O as isUUIDv7, S as isUUIDv1, T as isUUIDv4, f as isDeepEqual, k as isUUIDv8, w as isUUIDv3 } from "../utils-C0NzTJMR.mjs";
+import { C as isUUIDv2, D as isUUIDv6, E as isUUIDv5, O as isUUIDv7, S as isUUIDv1, T as isUUIDv4, f as isDeepEqual, k as isUUIDv8, w as isUUIDv3 } from "../utils-DcRr0A7B.mjs";
 import { A as isSet, C as isMethodDescriptor, D as isPromise, E as isObjectWithKeys, O as isRegExp, S as isMap, T as isObject, _ as isDate, a as isEmail, b as isFunction, c as isHexString, d as isNumericString, f as isPhoneNumber, g as isArrayOfType, h as isArray, i as isDateString, j as isValidArray, k as isReturningPromise, l as isIPAddress, m as isUUID, n as isBinaryString, o as isEmailArray, p as isURL, r as isBrowser, s as isEnvironment, t as isBase64, u as isNode, v as isEmptyObject, w as isNotEmptyObject, x as isJSON, y as isError } from "../specials-krf7zsqI.mjs";
-import { C as isOdd, S as isMultiple, b as isEven, d as isCamelCase, f as isEmojiOnly, g as isSnakeCase, h as isPascalCase, i as isInvalidOrEmptyArray, m as isPalindrome, p as isKebabCase, v as isPrime, w as isPerfectSquare, x as isFibonacci, y as areInvalidNumbers } from "../basics-9MqP9Ecm.mjs";
+import { C as isOdd, S as isMultiple, b as isEven, d as isCamelCase, f as isEmojiOnly, g as isSnakeCase, h as isPascalCase, i as isInvalidOrEmptyArray, m as isPalindrome, p as isKebabCase, v as isPrime, w as isPerfectSquare, x as isFibonacci, y as areInvalidNumbers } from "../basics-KYRpMQNe.mjs";
 import { a as isHex8, i as isHex6, n as isHSL, o as isRGB, r as isHSLA, s as isRGBA, t as isCSSColor } from "../guards-CNG9gnvL.mjs";
-import { a as isValidTime, i as isTimeWithUnit, n as isLeapYear, o as isValidTimeZoneId, r as isNativeTimeZoneId, s as isValidUTCOffset, t as isDateLike } from "../guards-DBunDnng.mjs";
+import { a as isValidTime, i as isTimeWithUnit, n as isLeapYear, o as isValidTimeZoneId, r as isNativeTimeZoneId, s as isValidUTCOffset, t as isDateLike } from "../guards-CyOZsZ1r.mjs";
 
 export { areInvalidNumbers, areInvalidNumbers as areNumbersInvalid, areInvalidNumbers as isInvalidNumber, areInvalidNumbers as isNumberInvalid, isReturningPromise as doesReturnPromise, isReturningPromise, isArray, isArrayOfType, isValidArray as isArrayWithLength, isValidArray, isBase64, isBigInt, isBinaryString, isBoolean, isBrowser, isCSSColor, isCamelCase, isDate, isDateLike, isDateString, isDeepEqual, isEmail, isEmail as isValidEmail, isEmailArray, isEmojiOnly, isEmptyObject, isEmptyObject as isObjectEmpty, isEnvironment, isEnvironment as isExpectedNodeENV, isEnvironment as isNodeENV, isEnvironment as isNodeEnvironment, isError, isEven, isEven as isEvenNumber, isFalsy, isFibonacci, isFibonacci as isPartOfFibonacci, isFibonacci as isPartOfFibonacciSeries, isFunction, isHSL, isHSLA, isHex6, isHex8, isHexString, isIPAddress, isInteger, isInvalidOrEmptyArray, isJSON, isJSON as isValidJSON, isKebabCase, isLeapYear, isMap, isMethodDescriptor as isMethod, isMethodDescriptor, isMultiple, isMultiple as isMultipleOf, isNativeTimeZoneId, isNode, isNonEmptyString, isNormalPrimitive, isNotEmptyObject, isNotEmptyObject as isValidObject, isNull, isNumber, isNumericString, isObject, isObjectWithKeys, isOdd, isOdd as isOddNumber, isPalindrome, isPascalCase, isPerfectSquare, isPhoneNumber, isPositiveInteger, isPrime, isPrime as isPrimeNumber, isPrimitive, isPromise, isRGB, isRGBA, isRegExp, isRegExp as isRegularExpression, isSet, isSnakeCase, isString, isSymbol, isTimeWithUnit, isTruthy, isURL, isURL as isValidURL, isUUID, isUUIDv1, isUUIDv2, isUUIDv3, isUUIDv4, isUUIDv5, isUUIDv6, isUUIDv7, isUUIDv8, isUndefined, isValidTime, isValidTime as isValidTimeString, isValidTimeZoneId, isValidUTCOffset as isValidUTC, isValidUTCOffset };

package/dist/{guards-DBunDnng.mjs → guards-CyOZsZ1r.mjs}

@@ -54,7 +54,7 @@ function isValidUTCOffset(value) {
 * @returns `true` if the value is a valid IANA time zone identifier, otherwise `false`.
 */
 function isValidTimeZoneId(value) {
-	return isNonEmptyString(value) ? new Set([...IANA_TZ_IDS]).has(value) : false;
+	return isNonEmptyString(value) ? (/* @__PURE__ */ new Set([...IANA_TZ_IDS])).has(value) : false;
 }
 /**
 * * Validates whether the provided value is a supported time zone identifier using the native JavaScript API (`Intl.supportedValuesOf('timeZone')`).

package/dist/{guards-BD2Fkugj.cjs → guards-DalSfIxV.cjs}

@@ -54,7 +54,7 @@ function isValidUTCOffset(value) {
 * @returns `true` if the value is a valid IANA time zone identifier, otherwise `false`.
 */
 function isValidTimeZoneId(value) {
-	return require_primitives.isNonEmptyString(value) ? new Set([...require_timezone.IANA_TZ_IDS]).has(value) : false;
+	return require_primitives.isNonEmptyString(value) ? (/* @__PURE__ */ new Set([...require_timezone.IANA_TZ_IDS])).has(value) : false;
 }
 /**
 * * Validates whether the provided value is a supported time zone identifier using the native JavaScript API (`Intl.supportedValuesOf('timeZone')`).

package/dist/hash/index.cjs

@@ -16,9 +16,9 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primitives = require('../primitives-CBGICrDR.cjs');
-const require_utils = require('../utils-C4yOIzOJ.cjs');
+const require_utils = require('../utils-BxZGABHS.cjs');
 const require_specials = require('../specials-DU8u108m.cjs');
-const require_parse = require('../parse-CffWYCuy.cjs');
+const require_parse = require('../parse-Dz186-PH.cjs');
 
 //#region src/hash/Cipher.ts
 /**

package/dist/hash/index.mjs

@@ -15,9 +15,9 @@
  */
 
 import { a as isNonEmptyString } from "../primitives-Djsevc69.mjs";
-import { A as uuid, B as bytesToUtf8, C as isUUIDv2, D as isUUIDv6, E as isUUIDv5, F as _padStartWith0, G as randomAlphaNumeric, H as hexToBytes, I as _splitByCharLength, J as randomNumeric, K as randomBytes, L as base64ToBytes, M as sha1, N as sha256, O as isUUIDv7, P as _constantTimeEquals, Q as generateRandomID, R as bytesToBase64, S as isUUIDv1, T as isUUIDv4, U as hmacSha256, V as concatBytes, W as intTo4BytesBE, X as uint8To32ArrayBE, Y as sha256Bytes, Z as utf8ToBytes, h as stripJsonEdgeGarbage, j as md5, k as isUUIDv8, m as stableStringify, q as randomHex, w as isUUIDv3, x as decodeUUID, z as bytesToHex } from "../utils-C0NzTJMR.mjs";
+import { A as uuid, B as bytesToUtf8, C as isUUIDv2, D as isUUIDv6, E as isUUIDv5, F as _padStartWith0, G as randomAlphaNumeric, H as hexToBytes, I as _splitByCharLength, J as randomNumeric, K as randomBytes, L as base64ToBytes, M as sha1, N as sha256, O as isUUIDv7, P as _constantTimeEquals, Q as generateRandomID, R as bytesToBase64, S as isUUIDv1, T as isUUIDv4, U as hmacSha256, V as concatBytes, W as intTo4BytesBE, X as uint8To32ArrayBE, Y as sha256Bytes, Z as utf8ToBytes, h as stripJsonEdgeGarbage, j as md5, k as isUUIDv8, m as stableStringify, q as randomHex, w as isUUIDv3, x as decodeUUID, z as bytesToHex } from "../utils-DcRr0A7B.mjs";
 import { c as isHexString, m as isUUID, n as isBinaryString, t as isBase64, w as isNotEmptyObject } from "../specials-krf7zsqI.mjs";
-import { c as _toSeconds, s as _secToDate, t as parseMSec } from "../parse-CILDG7TG.mjs";
+import { c as _toSeconds, s as _secToDate, t as parseMSec } from "../parse-CsTFudDu.mjs";
 
 //#region src/hash/Cipher.ts
 /**

package/dist/index.cjs

@@ -19,11 +19,11 @@ const require_primitives = require('./primitives-CBGICrDR.cjs');
 const require_case = require('./case-Bd7QLHYw.cjs');
 const require_constants = require('./constants-B3nc8psr.cjs');
 const require_countries = require('./countries-C0x58zVg.cjs');
-const require_utils = require('./utils-C4yOIzOJ.cjs');
+const require_utils = require('./utils-BxZGABHS.cjs');
 const require_specials = require('./specials-DU8u108m.cjs');
-const require_basics = require('./basics-CiT7tnu_.cjs');
+const require_basics = require('./basics-CUzK7wFN.cjs');
 const require_utilities = require('./utilities-_COSGq1U.cjs');
-const require_query = require('./query-lGVoAJl3.cjs');
+const require_query = require('./query-iJflCkq1.cjs');
 
 //#region src/string/anagram.ts
 /** `WeakMap` to cache user provided dictionary array */
@@ -529,7 +529,7 @@ function getFactors(int) {
 	const num = require_utilities.normalizeNumber(int);
 	if (!require_primitives.isNumber(num) || num <= 0 || !Number.isInteger(num)) return [];
 	if (num === 1) return [1];
-	const factors = new Set([1, num]);
+	const factors = /* @__PURE__ */ new Set([1, num]);
 	const sqrt = Math.floor(Math.sqrt(num));
 	for (let i = 2; i <= sqrt; i++) if (num % i === 0) {
 		factors.add(i);
@@ -1255,7 +1255,7 @@ function getFibonacciSeriesMemo(limit) {
 	const cLimit = Number(limit);
 	if (!Number.isFinite(cLimit) || cLimit <= 0) return [];
 	if (cLimit === 1) return [0];
-	const memo = new Map([[0, 0], [1, 1]]);
+	const memo = /* @__PURE__ */ new Map([[0, 0], [1, 1]]);
 	const fib = (n) => {
 		if (memo.has(n)) return memo.get(n);
 		const val = fib(n - 1) + fib(n - 2);

package/dist/index.mjs

@@ -18,11 +18,11 @@ import { a as isNonEmptyString, c as isNumber, d as isString, i as isInteger, m
 import { n as convertStringCase, t as capitalizeString } from "./case-DBC4Rj0h.mjs";
 import { c as ORDINAL_UNDER_TEEN, d as TENS, f as THOUSANDS, l as PREFIX_MULTIPLIERS, o as ONES, s as ORDINAL_TO_CARDINAL, t as BN_DIGITS, u as TEENS } from "./constants-ZyfpysiQ.mjs";
 import { t as COUNTRIES } from "./countries-CMxHxKiK.mjs";
-import { $ as trimString, Q as generateRandomID, _ as naturalSort, a as deepParsePrimitives, b as _resolveNestedKey, c as getInstanceGetterNames, d as getStaticMethodNames, et as truncateString, f as isDeepEqual, g as throttleAction, h as stripJsonEdgeGarbage, i as debounceAction, l as getInstanceMethodNames, m as stableStringify, n as countInstanceMethods, o as definePrototypeMethod, p as parseJSON, r as countStaticMethods, s as getClassDetails, t as convertArrayToString, u as getStaticGetterNames, v as sortAnArray, y as _getNumericProp } from "./utils-C0NzTJMR.mjs";
+import { $ as trimString, Q as generateRandomID, _ as naturalSort, a as deepParsePrimitives, b as _resolveNestedKey, c as getInstanceGetterNames, d as getStaticMethodNames, et as truncateString, f as isDeepEqual, g as throttleAction, h as stripJsonEdgeGarbage, i as debounceAction, l as getInstanceMethodNames, m as stableStringify, n as countInstanceMethods, o as definePrototypeMethod, p as parseJSON, r as countStaticMethods, s as getClassDetails, t as convertArrayToString, u as getStaticGetterNames, v as sortAnArray, y as _getNumericProp } from "./utils-DcRr0A7B.mjs";
 import { T as isObject, b as isFunction, d as isNumericString, j as isValidArray } from "./specials-krf7zsqI.mjs";
-import { A as replaceAllInString, C as isOdd, D as formatUnitWithPlural, E as extractURLs, M as slugifyString, O as maskString, T as extractEmails, _ as findPrimeNumbers, a as shuffleArray, b as isEven, c as extractObjectEntries, i as isInvalidOrEmptyArray, j as reverseString, k as normalizeString, l as extractObjectKeys, n as flattenArray, o as cloneObject, r as getLastArrayElement, s as countObjectFields, t as filterArrayOfObjects, u as extractObjectKeysDeep, v as isPrime, y as areInvalidNumbers } from "./basics-9MqP9Ecm.mjs";
+import { A as replaceAllInString, C as isOdd, D as formatUnitWithPlural, E as extractURLs, M as slugifyString, O as maskString, T as extractEmails, _ as findPrimeNumbers, a as shuffleArray, b as isEven, c as extractObjectEntries, i as isInvalidOrEmptyArray, j as reverseString, k as normalizeString, l as extractObjectKeys, n as flattenArray, o as cloneObject, r as getLastArrayElement, s as countObjectFields, t as filterArrayOfObjects, u as extractObjectKeysDeep, v as isPrime, y as areInvalidNumbers } from "./basics-KYRpMQNe.mjs";
 import { a as normalizeNumber, i as getRandomFloat, n as formatCurrency, o as roundToNearest, r as getOrdinal, t as clampNumber } from "./utilities-CmPwOkdy.mjs";
-import { c as extractUpdatedFields, d as mergeAndFlattenObjects, f as mergeObjects, h as sanitizeData, i as parseQueryStringLiteral, l as flattenObjectDotNotation, m as parseObjectValues, o as extractNewFields, p as parseJsonToObject, r as parseQueryString, s as extractUpdatedAndNewFields, t as generateQueryParams, u as flattenObjectKeyValue } from "./query-Cp1dq-qU.mjs";
+import { c as extractUpdatedFields, d as mergeAndFlattenObjects, f as mergeObjects, h as sanitizeData, i as parseQueryStringLiteral, l as flattenObjectDotNotation, m as parseObjectValues, o as extractNewFields, p as parseJsonToObject, r as parseQueryString, s as extractUpdatedAndNewFields, t as generateQueryParams, u as flattenObjectKeyValue } from "./query-B8VPCIKA.mjs";
 
 //#region src/string/anagram.ts
 /** `WeakMap` to cache user provided dictionary array */
@@ -528,7 +528,7 @@ function getFactors(int) {
 	const num = normalizeNumber(int);
 	if (!isNumber(num) || num <= 0 || !Number.isInteger(num)) return [];
 	if (num === 1) return [1];
-	const factors = new Set([1, num]);
+	const factors = /* @__PURE__ */ new Set([1, num]);
 	const sqrt = Math.floor(Math.sqrt(num));
 	for (let i = 2; i <= sqrt; i++) if (num % i === 0) {
 		factors.add(i);
@@ -1254,7 +1254,7 @@ function getFibonacciSeriesMemo(limit) {
 	const cLimit = Number(limit);
 	if (!Number.isFinite(cLimit) || cLimit <= 0) return [];
 	if (cLimit === 1) return [0];
-	const memo = new Map([[0, 0], [1, 1]]);
+	const memo = /* @__PURE__ */ new Map([[0, 0], [1, 1]]);
 	const fib = (n) => {
 		if (memo.has(n)) return memo.get(n);
 		const val = fib(n - 1) + fib(n - 2);

package/dist/paginator.cjs

@@ -197,7 +197,7 @@ var Paginator = class Paginator {
 		const startPages = _getRange(1, edgeCount);
 		const middlePages = _getRange(start, end);
 		const endPages = _getRange(total - edgeCount + 1, total);
-		const pages = new Set([
+		const pages = /* @__PURE__ */ new Set([
 			...startPages,
 			...middlePages,
 			...endPages

package/dist/paginator.mjs

@@ -195,7 +195,7 @@ var Paginator = class Paginator {
 		const startPages = _getRange(1, edgeCount);
 		const middlePages = _getRange(start, end);
 		const endPages = _getRange(total - edgeCount + 1, total);
-		const pages = new Set([
+		const pages = /* @__PURE__ */ new Set([
 			...startPages,
 			...middlePages,
 			...endPages

package/dist/{parse-CILDG7TG.mjs → parse-CsTFudDu.mjs}

@@ -18,7 +18,7 @@ import { a as isNonEmptyString, c as isNumber, d as isString } from "./primitive
 import { i as MS_MAP, n as DAYS, o as SORTED_TIME_FORMATS, r as MONTHS } from "./constants-GZL_CT1W.mjs";
 import { d as isNumericString } from "./specials-krf7zsqI.mjs";
 import { r as getOrdinal } from "./utilities-CmPwOkdy.mjs";
-import { i as isTimeWithUnit } from "./guards-DBunDnng.mjs";
+import { i as isTimeWithUnit } from "./guards-CyOZsZ1r.mjs";
 
 //#region src/date/helpers.ts
 /** Core formatting logic shared by `formatDate` and `Chronos`, `BanglaCalendar` classes */
@@ -113,7 +113,7 @@ function _padZero(value, length = 2) {
 	return String(value).padStart(length, "0");
 }
 /**
-* Convert a string, number, or `Date` object to a `Date` object.
+* Convert a string, number, or `Date` object to a new `Date` object.
 * - If the input is already a `Date`, it is returned as is.
 * - If it's a string, it is parsed into a `Date`.
 * - If it's a number, it is treated as a timestamp and converted to a `Date`.
@@ -121,7 +121,7 @@ function _padZero(value, length = 2) {
 * @returns A `Date` object representing the input date.
 */
 function _dateArgsToDate(value) {
-	return value instanceof Date ? value : new Date(isString(value) ? value.replace(/['"]/g, "") : value ?? Date.now());
+	return new Date(value instanceof Date ? value : isString(value) ? value.replace(/['"]/g, "") : value ?? Date.now());
 }
 
 //#endregion

package/dist/{parse-CffWYCuy.cjs → parse-Dz186-PH.cjs}

@@ -18,7 +18,7 @@ const require_primitives = require('./primitives-CBGICrDR.cjs');
 const require_constants = require('./constants-CgFaV72Z.cjs');
 const require_specials = require('./specials-DU8u108m.cjs');
 const require_utilities = require('./utilities-_COSGq1U.cjs');
-const require_guards = require('./guards-BD2Fkugj.cjs');
+const require_guards = require('./guards-DalSfIxV.cjs');
 
 //#region src/date/helpers.ts
 /** Core formatting logic shared by `formatDate` and `Chronos`, `BanglaCalendar` classes */
@@ -113,7 +113,7 @@ function _padZero(value, length = 2) {
 	return String(value).padStart(length, "0");
 }
 /**
-* Convert a string, number, or `Date` object to a `Date` object.
+* Convert a string, number, or `Date` object to a new `Date` object.
 * - If the input is already a `Date`, it is returned as is.
 * - If it's a string, it is parsed into a `Date`.
 * - If it's a number, it is treated as a timestamp and converted to a `Date`.
@@ -121,7 +121,7 @@ function _padZero(value, length = 2) {
 * @returns A `Date` object representing the input date.
 */
 function _dateArgsToDate(value) {
-	return value instanceof Date ? value : new Date(require_primitives.isString(value) ? value.replace(/['"]/g, "") : value ?? Date.now());
+	return new Date(value instanceof Date ? value : require_primitives.isString(value) ? value.replace(/['"]/g, "") : value ?? Date.now());
 }
 
 //#endregion

package/dist/{query-Cp1dq-qU.mjs → query-B8VPCIKA.mjs}

@@ -15,9 +15,9 @@
  */
 
 import { d as isString } from "./primitives-Djsevc69.mjs";
-import { $ as trimString, a as deepParsePrimitives, f as isDeepEqual } from "./utils-C0NzTJMR.mjs";
+import { $ as trimString, a as deepParsePrimitives, f as isDeepEqual } from "./utils-DcRr0A7B.mjs";
 import { E as isObjectWithKeys, T as isObject, g as isArrayOfType, j as isValidArray, v as isEmptyObject, w as isNotEmptyObject } from "./specials-krf7zsqI.mjs";
-import { t as isDateLike } from "./guards-DBunDnng.mjs";
+import { t as isDateLike } from "./guards-CyOZsZ1r.mjs";
 
 //#region src/form/guards.ts
 /**

package/dist/{query-lGVoAJl3.cjs → query-iJflCkq1.cjs}

@@ -15,9 +15,9 @@
  */
 
 const require_primitives = require('./primitives-CBGICrDR.cjs');
-const require_utils = require('./utils-C4yOIzOJ.cjs');
+const require_utils = require('./utils-BxZGABHS.cjs');
 const require_specials = require('./specials-DU8u108m.cjs');
-const require_guards = require('./guards-BD2Fkugj.cjs');
+const require_guards = require('./guards-DalSfIxV.cjs');
 
 //#region src/form/guards.ts
 /**

package/dist/{utils-C4yOIzOJ.cjs → utils-BxZGABHS.cjs}

@@ -17,7 +17,7 @@
 const require_primitives = require('./primitives-CBGICrDR.cjs');
 const require_specials = require('./specials-DU8u108m.cjs');
 const require_utilities = require('./utilities-_COSGq1U.cjs');
-const require_guards = require('./guards-BD2Fkugj.cjs');
+const require_guards = require('./guards-DalSfIxV.cjs');
 
 //#region src/string/basics.ts
 /**
@@ -145,7 +145,7 @@ function trimString(input) {
 * - If `size` is 0 or negative, an empty `Uint8Array` is returned.
 */
 function randomBytes(size = 8) {
-	if (size <= 0) return new Uint8Array(0);
+	if (size <= 0) return /* @__PURE__ */ new Uint8Array(0);
 	return _fillWithRandomValues(new Uint8Array(size));
 }
 /**
@@ -578,7 +578,7 @@ function sha256Bytes(message) {
 	const lenView = new DataView(padding.buffer);
 	lenView.setUint32(padding.length - 8, Math.floor(ml / 4294967296), false);
 	lenView.setUint32(padding.length - 4, ml & 4294967295, false);
-	const w = new Uint32Array(64);
+	const w = /* @__PURE__ */ new Uint32Array(64);
 	const chunkView = new DataView(padding.buffer);
 	for (let offset = 0; offset < padding.length; offset += 64) {
 		for (let t = 0; t < 16; t++) w[t] = chunkView.getUint32(offset + t * 4, false);
@@ -618,7 +618,7 @@ function sha256Bytes(message) {
 		H[6] = H[6] + g >>> 0;
 		H[7] = H[7] + h >>> 0;
 	}
-	const out = new Uint8Array(32);
+	const out = /* @__PURE__ */ new Uint8Array(32);
 	const outView = new DataView(out.buffer);
 	for (let i = 0; i < 8; i++) outView.setUint32(i * 4, H[i], false);
 	return out;
@@ -757,7 +757,7 @@ function uint8To32ArrayBE(bytes) {
 * @see {@link uint8To32ArrayBE} for bytes to 32-bit integers conversion
 */
 function intTo4BytesBE(n) {
-	const b = new Uint8Array(4);
+	const b = /* @__PURE__ */ new Uint8Array(4);
 	b[0] = n >>> 24 & 255;
 	b[1] = n >>> 16 & 255;
 	b[2] = n >>> 8 & 255;
@@ -847,7 +847,7 @@ function bytesToHex(bytes) {
 * @see {@link bytesToHex} for the reverse process
 */
 function hexToBytes(hex) {
-	if (!require_specials.isHexString(hex)) return new Uint8Array();
+	if (!require_specials.isHexString(hex)) return /* @__PURE__ */ new Uint8Array();
 	const bytes = _splitByCharLength(hex, 2).map((h) => parseInt(h, 16));
 	return new Uint8Array(bytes);
 }
@@ -1163,7 +1163,7 @@ function sha1(msg) {
 		271733878,
 		3285377520
 	];
-	const W = new Uint32Array(80);
+	const W = /* @__PURE__ */ new Uint32Array(80);
 	for (let i = 0; i < words.length; i += 16) {
 		for (let j = 0; j < 16; j++) W[j] = words[i + j] | 0;
 		for (let j = 16; j < 80; j++) W[j] = rotl(W[j - 3] ^ W[j - 8] ^ W[j - 14] ^ W[j - 16], 1);
@@ -1292,7 +1292,7 @@ function uuid(options) {
 		case "v3":
 			if (_isOptionV3V5(options)) return _formatUUID(md5(options.namespace + options.name), 3, uppercase);
 			throw new Error("v3 requires valid namespace (uuid) and name!");
-		case "v4": return _formatUUID(_bytesToRandomHex(new Uint8Array(16)), 4, uppercase);
+		case "v4": return _formatUUID(_bytesToRandomHex(/* @__PURE__ */ new Uint8Array(16)), 4, uppercase);
 		case "v5":
 			if (_isOptionV3V5(options)) return _formatUUID(sha1(options.namespace + options.name).slice(0, 32), 5, uppercase);
 			throw new Error("v5 requires valid namespace (uuid) and name!");
@@ -1306,7 +1306,7 @@ function uuid(options) {
 		case "v7": return _formatUUID(Date.now().toString(16).padStart(12, "0") + randomHex(20), 7, uppercase);
 		case "v8": {
 			const ts = BigInt(Date.now());
-			const bytes = new Uint8Array(16);
+			const bytes = /* @__PURE__ */ new Uint8Array(16);
 			let temp = ts;
 			for (let i = 5; i >= 0; i--) {
 				bytes[i] = Number(temp & 255n);
@@ -1671,7 +1671,8 @@ function getInstanceGetterNames(cls) {
 * @returns A sorted array of static getter names.
 */
 function getStaticGetterNames(cls) {
-	return sortAnArray(Object.entries(Object.getOwnPropertyDescriptors(cls)).filter(([key, desc]) => typeof desc.get === "function" && key !== "prototype").map(([key]) => key));
+	const descriptors = Object.getOwnPropertyDescriptors(cls);
+	return sortAnArray(Object.entries(descriptors).filter(([key, desc]) => typeof desc.get === "function" && key !== "prototype").map(([key]) => key));
 }
 /**
 * * Gathers detailed information about the instance and static methods of a class.

package/dist/{utils-C0NzTJMR.mjs → utils-DcRr0A7B.mjs}

@@ -17,7 +17,7 @@
 import { a as isNonEmptyString, c as isNumber, d as isString, m as isUndefined, n as isBoolean, u as isPrimitive } from "./primitives-Djsevc69.mjs";
 import { C as isMethodDescriptor, E as isObjectWithKeys, T as isObject, b as isFunction, c as isHexString, d as isNumericString, g as isArrayOfType, h as isArray, j as isValidArray, m as isUUID, w as isNotEmptyObject } from "./specials-krf7zsqI.mjs";
 import { a as normalizeNumber } from "./utilities-CmPwOkdy.mjs";
-import { t as isDateLike } from "./guards-DBunDnng.mjs";
+import { t as isDateLike } from "./guards-CyOZsZ1r.mjs";
 
 //#region src/string/basics.ts
 /**
@@ -145,7 +145,7 @@ function trimString(input) {
 * - If `size` is 0 or negative, an empty `Uint8Array` is returned.
 */
 function randomBytes(size = 8) {
-	if (size <= 0) return new Uint8Array(0);
+	if (size <= 0) return /* @__PURE__ */ new Uint8Array(0);
 	return _fillWithRandomValues(new Uint8Array(size));
 }
 /**
@@ -578,7 +578,7 @@ function sha256Bytes(message) {
 	const lenView = new DataView(padding.buffer);
 	lenView.setUint32(padding.length - 8, Math.floor(ml / 4294967296), false);
 	lenView.setUint32(padding.length - 4, ml & 4294967295, false);
-	const w = new Uint32Array(64);
+	const w = /* @__PURE__ */ new Uint32Array(64);
 	const chunkView = new DataView(padding.buffer);
 	for (let offset = 0; offset < padding.length; offset += 64) {
 		for (let t = 0; t < 16; t++) w[t] = chunkView.getUint32(offset + t * 4, false);
@@ -618,7 +618,7 @@ function sha256Bytes(message) {
 		H[6] = H[6] + g >>> 0;
 		H[7] = H[7] + h >>> 0;
 	}
-	const out = new Uint8Array(32);
+	const out = /* @__PURE__ */ new Uint8Array(32);
 	const outView = new DataView(out.buffer);
 	for (let i = 0; i < 8; i++) outView.setUint32(i * 4, H[i], false);
 	return out;
@@ -757,7 +757,7 @@ function uint8To32ArrayBE(bytes) {
 * @see {@link uint8To32ArrayBE} for bytes to 32-bit integers conversion
 */
 function intTo4BytesBE(n) {
-	const b = new Uint8Array(4);
+	const b = /* @__PURE__ */ new Uint8Array(4);
 	b[0] = n >>> 24 & 255;
 	b[1] = n >>> 16 & 255;
 	b[2] = n >>> 8 & 255;
@@ -847,7 +847,7 @@ function bytesToHex(bytes) {
 * @see {@link bytesToHex} for the reverse process
 */
 function hexToBytes(hex) {
-	if (!isHexString(hex)) return new Uint8Array();
+	if (!isHexString(hex)) return /* @__PURE__ */ new Uint8Array();
 	const bytes = _splitByCharLength(hex, 2).map((h) => parseInt(h, 16));
 	return new Uint8Array(bytes);
 }
@@ -1163,7 +1163,7 @@ function sha1(msg) {
 		271733878,
 		3285377520
 	];
-	const W = new Uint32Array(80);
+	const W = /* @__PURE__ */ new Uint32Array(80);
 	for (let i = 0; i < words.length; i += 16) {
 		for (let j = 0; j < 16; j++) W[j] = words[i + j] | 0;
 		for (let j = 16; j < 80; j++) W[j] = rotl(W[j - 3] ^ W[j - 8] ^ W[j - 14] ^ W[j - 16], 1);
@@ -1292,7 +1292,7 @@ function uuid(options) {
 		case "v3":
 			if (_isOptionV3V5(options)) return _formatUUID(md5(options.namespace + options.name), 3, uppercase);
 			throw new Error("v3 requires valid namespace (uuid) and name!");
-		case "v4": return _formatUUID(_bytesToRandomHex(new Uint8Array(16)), 4, uppercase);
+		case "v4": return _formatUUID(_bytesToRandomHex(/* @__PURE__ */ new Uint8Array(16)), 4, uppercase);
 		case "v5":
 			if (_isOptionV3V5(options)) return _formatUUID(sha1(options.namespace + options.name).slice(0, 32), 5, uppercase);
 			throw new Error("v5 requires valid namespace (uuid) and name!");
@@ -1306,7 +1306,7 @@ function uuid(options) {
 		case "v7": return _formatUUID(Date.now().toString(16).padStart(12, "0") + randomHex(20), 7, uppercase);
 		case "v8": {
 			const ts = BigInt(Date.now());
-			const bytes = new Uint8Array(16);
+			const bytes = /* @__PURE__ */ new Uint8Array(16);
 			let temp = ts;
 			for (let i = 5; i >= 0; i--) {
 				bytes[i] = Number(temp & 255n);
@@ -1671,7 +1671,8 @@ function getInstanceGetterNames(cls) {
 * @returns A sorted array of static getter names.
 */
 function getStaticGetterNames(cls) {
-	return sortAnArray(Object.entries(Object.getOwnPropertyDescriptors(cls)).filter(([key, desc]) => typeof desc.get === "function" && key !== "prototype").map(([key]) => key));
+	const descriptors = Object.getOwnPropertyDescriptors(cls);
+	return sortAnArray(Object.entries(descriptors).filter(([key, desc]) => typeof desc.get === "function" && key !== "prototype").map(([key]) => key));
 }
 /**
 * * Gathers detailed information about the instance and static methods of a class.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolbox-x",
-  "version": "2.4.2",
+  "version": "2.4.4",
   "description": "A versatile collection of smart, efficient, and reusable utility functions, classes and types for everyday development needs.",
   "main": "./dist/index.cjs",
   "type": "module",
@@ -11,6 +11,8 @@
     "utility",
     "functions",
     "class",
+    "guard",
+    "predicate",
     "form",
     "random-id",
     "id",
@@ -37,6 +39,7 @@
     "verbalize",
     "verbalizer",
     "date",
+    "date-time",
     "chalk",
     "console",
     "style",
@@ -96,12 +99,12 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "@biomejs/biome": "^2.5.0",
-    "@types/node": "^25.9.3",
+    "@biomejs/biome": "^2.5.1",
+    "@types/node": "^26.0.1",
     "husky": "^9.1.7",
-    "lint-staged": "^17.0.7",
+    "lint-staged": "^17.0.8",
     "nhb-scripts": "^1.9.2",
-    "tsdown": "^0.22.2",
+    "tsdown": "^0.22.3",
     "typescript": "^6.0.3"
   },
   "lint-staged": {