toolbox-x 2.4.2 → 2.4.6

package/CHANGELOG.md

@@ -4,6 +4,25 @@ 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.6](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v2.4.6) — 2026-06-28
+
+[Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v2.4.4...v2.4.6)
+
+* \[[`56043d65ef`](https://github.com/nazmul-nhb/toolbox-x/commit/56043d65ef)] - 🔧 update(string): added new signature for `truncateString` with `TruncateOptions` (Nazmul Hassan)
+* \[[`bde1e98b99`](https://github.com/nazmul-nhb/toolbox-x/commit/bde1e98b99)] - 🔧 update(string): updated `MaskOptions` for `maskString` (Nazmul Hassan)
+* \[[`bdeea053f1`](https://github.com/nazmul-nhb/toolbox-x/commit/bdeea053f1)] - 📚 docs: updated CHANGELOG.md for v2.4.4 (github-actions\[bot])
+
+## [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-BGu9ygZK.cjs}

@@ -15,8 +15,8 @@
  */
 
 const require_primitives = require('./primitives-CBGICrDR.cjs');
-const require_utils = require('./utils-C4yOIzOJ.cjs');
 const require_specials = require('./specials-DU8u108m.cjs');
+const require_utils = require('./utils-BzeK3wO9.cjs');
 const require_utilities = require('./utilities-_COSGq1U.cjs');
 
 //#region src/string/convert.ts
@@ -34,7 +34,7 @@ const require_utilities = require('./utilities-_COSGq1U.cjs');
 */
 const replaceAllInString = (input, find, replace) => {
 	const trimmedString = require_utils.trimString(input);
-	const regex = require_primitives.isString(find) ? new RegExp(find, "g") : new RegExp(find, find?.flags.includes("g") ? find?.flags : find?.flags + "g");
+	const regex = require_primitives.isString(find) ? new RegExp(find, "g") : new RegExp(find, find?.flags.includes("g") ? find?.flags : `${find?.flags}g`);
 	return trimmedString?.replace(regex, replace);
 };
 /**
@@ -52,10 +52,10 @@ const slugifyString = (input) => {
 * @returns The masked string.
 */
 const maskString = (input, options) => {
-	const { start = 1, end = 1, maskCharacter: maskChar = "*" } = options || {};
-	const trimmedString = require_utils.trimString(input);
-	if (trimmedString?.length <= start + end) return maskChar?.repeat(trimmedString?.length);
-	return trimmedString.slice(0, start) + maskChar?.repeat(trimmedString?.length - start - end) + (end > 0 ? trimmedString.slice(-end) : "");
+	const { start = 1, end = 1, trim = false, maskCharacter = "*" } = options || {};
+	const trimmedString = trim ? require_utils.trimString(input) : input;
+	if (trimmedString?.length <= start + end) return maskCharacter?.repeat(trimmedString?.length);
+	return trimmedString.slice(0, start) + maskCharacter?.repeat(trimmedString?.length - start - end) + (end > 0 ? trimmedString.slice(-end) : "");
 };
 /**
 * * Reverses a given string.

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

@@ -15,8 +15,8 @@
  */
 
 import { d as isString, m as isUndefined } from "./primitives-Djsevc69.mjs";
-import { $ as trimString, m as stableStringify } from "./utils-C0NzTJMR.mjs";
 import { b as isFunction, w as isNotEmptyObject } from "./specials-krf7zsqI.mjs";
+import { $ as trimString, m as stableStringify } from "./utils-DnyVgO8p.mjs";
 import { a as normalizeNumber } from "./utilities-CmPwOkdy.mjs";
 
 //#region src/string/convert.ts
@@ -34,7 +34,7 @@ import { a as normalizeNumber } from "./utilities-CmPwOkdy.mjs";
 */
 const replaceAllInString = (input, find, replace) => {
 	const trimmedString = trimString(input);
-	const regex = isString(find) ? new RegExp(find, "g") : new RegExp(find, find?.flags.includes("g") ? find?.flags : find?.flags + "g");
+	const regex = isString(find) ? new RegExp(find, "g") : new RegExp(find, find?.flags.includes("g") ? find?.flags : `${find?.flags}g`);
 	return trimmedString?.replace(regex, replace);
 };
 /**
@@ -52,10 +52,10 @@ const slugifyString = (input) => {
 * @returns The masked string.
 */
 const maskString = (input, options) => {
-	const { start = 1, end = 1, maskCharacter: maskChar = "*" } = options || {};
-	const trimmedString = trimString(input);
-	if (trimmedString?.length <= start + end) return maskChar?.repeat(trimmedString?.length);
-	return trimmedString.slice(0, start) + maskChar?.repeat(trimmedString?.length - start - end) + (end > 0 ? trimmedString.slice(-end) : "");
+	const { start = 1, end = 1, trim = false, maskCharacter = "*" } = options || {};
+	const trimmedString = trim ? trimString(input) : input;
+	if (trimmedString?.length <= start + end) return maskCharacter?.repeat(trimmedString?.length);
+	return trimmedString.slice(0, start) + maskCharacter?.repeat(trimmedString?.length - start - end) + (end > 0 ? trimmedString.slice(-end) : "");
 };
 /**
 * * Reverses a given string.

package/dist/{basics-BuHQJCNG.d.mts → basics-D64kohDf.d.mts}

@@ -14,17 +14,25 @@
  * limitations under the License.
  */
 
-import { z as RandomIdOptions } from "./string-edtZyJHf.mjs";
+import { J as TruncateOptions, z as RandomIdOptions } from "./string-D7N_U6y2.mjs";
 
 //#region src/string/basics.d.ts
 /**
  * * Utility to truncate a string to a specified length.
  *
  * @param str The string to truncate.
- * @param maxLength The maximum length of the truncated string.
- * @returns Truncated string with ellipsis (`...`) (only if it has more length than `maxLength`).
+ * @param maxLength The maximum length of the truncated string. Defaults to `100`.
+ * @returns Truncated string with ellipsis (`'...'`) (only if it has more length than `maxLength`).
  */
-declare function truncateString(str: string, maxLength: number): string;
+declare function truncateString(str: string, maxLength?: number): string;
+/**
+ * * Utility to truncate a string to a specified length using options.
+ *
+ * @param str The string to truncate.
+ * @param options Options for truncating the string.
+ * @returns Truncated string based on the {@link options}.
+ */
+declare function truncateString(str: string, options?: TruncateOptions): string;
 /**
  * * Generates a random alphanumeric (16 characters long, this length is customizable in the options) ID string composed of an optional `prefix`, `suffix`, a `timestamp`, `caseOption` and a customizable `separator`.
  *
@@ -32,6 +40,7 @@ declare function truncateString(str: string, maxLength: number): string;
  * @returns The generated ID string composed of the random alphanumeric string of specified length with optional `timeStamp`, `prefix`, and `suffix`, `caseOption` and `separator`.
  *
  * @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/hash/uuid uuid} for `uuid` generation
+ * @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/hash/random-numeric randomHex} for random numeric string generation
  * @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/hash/random-hex randomHex} for random hexadecimal string generation
  *
  * @example

package/dist/{basics-CLwtIxap.d.cts → basics-lvlgIf5Y.d.cts}

@@ -14,17 +14,25 @@
  * limitations under the License.
  */
 
-import { z as RandomIdOptions } from "./string-Ok_IMpHP.cjs";
+import { J as TruncateOptions, z as RandomIdOptions } from "./string-Cm9AMOl_.cjs";
 
 //#region src/string/basics.d.ts
 /**
  * * Utility to truncate a string to a specified length.
  *
  * @param str The string to truncate.
- * @param maxLength The maximum length of the truncated string.
- * @returns Truncated string with ellipsis (`...`) (only if it has more length than `maxLength`).
+ * @param maxLength The maximum length of the truncated string. Defaults to `100`.
+ * @returns Truncated string with ellipsis (`'...'`) (only if it has more length than `maxLength`).
  */
-declare function truncateString(str: string, maxLength: number): string;
+declare function truncateString(str: string, maxLength?: number): string;
+/**
+ * * Utility to truncate a string to a specified length using options.
+ *
+ * @param str The string to truncate.
+ * @param options Options for truncating the string.
+ * @returns Truncated string based on the {@link options}.
+ */
+declare function truncateString(str: string, options?: TruncateOptions): string;
 /**
  * * Generates a random alphanumeric (16 characters long, this length is customizable in the options) ID string composed of an optional `prefix`, `suffix`, a `timestamp`, `caseOption` and a customizable `separator`.
  *
@@ -32,6 +40,7 @@ declare function truncateString(str: string, maxLength: number): string;
  * @returns The generated ID string composed of the random alphanumeric string of specified length with optional `timeStamp`, `prefix`, and `suffix`, `caseOption` and `separator`.
  *
  * @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/hash/uuid uuid} for `uuid` generation
+ * @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/hash/random-numeric randomHex} for random numeric string generation
  * @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/hash/random-hex randomHex} for random hexadecimal string generation
  *
  * @example

package/dist/{case-BmB2aGyp.d.cts → case-Be3-bSPx.d.cts}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { F as PascalCase, G as TitleCase, H as SnakeCase, I as PascalSnakeCase, K as TrainCase, L as PathCase, N as KebabCase, V as SentenceCase, W as StringCaseOptions, g as CaseFormat, h as CapitalizeOptions, k as DotCase, m as CamelCase, u as $WidenEmpty, v as ConstantCase } from "./string-Ok_IMpHP.cjs";
+import { F as PascalCase, G as TitleCase, H as SnakeCase, I as PascalSnakeCase, K as TrainCase, L as PathCase, N as KebabCase, V as SentenceCase, W as StringCaseOptions, g as CaseFormat, h as CapitalizeOptions, k as DotCase, m as CamelCase, u as $WidenEmpty, v as ConstantCase } from "./string-Cm9AMOl_.cjs";
 
 //#region src/string/case.d.ts
 /**

package/dist/{case-Ce8HJI8I.d.mts → case-q0o80oIc.d.mts}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { F as PascalCase, G as TitleCase, H as SnakeCase, I as PascalSnakeCase, K as TrainCase, L as PathCase, N as KebabCase, V as SentenceCase, W as StringCaseOptions, g as CaseFormat, h as CapitalizeOptions, k as DotCase, m as CamelCase, u as $WidenEmpty, v as ConstantCase } from "./string-edtZyJHf.mjs";
+import { F as PascalCase, G as TitleCase, H as SnakeCase, I as PascalSnakeCase, K as TrainCase, L as PathCase, N as KebabCase, V as SentenceCase, W as StringCaseOptions, g as CaseFormat, h as CapitalizeOptions, k as DotCase, m as CamelCase, u as $WidenEmpty, v as ConstantCase } from "./string-D7N_U6y2.mjs";
 
 //#region src/string/case.d.ts
 /**

package/dist/change-case.d.cts

@@ -14,5 +14,5 @@
  * limitations under the License.
  */
 
-import { a as toDotCase, c as toPascalSnakeCase, d as toSnakeCase, f as toTitleCase, i as toConstantCase, l as toPathCase, n as convertStringCase, o as toKebabCase, p as toTrainCase, r as toCamelCase, s as toPascalCase, t as capitalizeString, u as toSentenceCase } from "./case-BmB2aGyp.cjs";
+import { a as toDotCase, c as toPascalSnakeCase, d as toSnakeCase, f as toTitleCase, i as toConstantCase, l as toPathCase, n as convertStringCase, o as toKebabCase, p as toTrainCase, r as toCamelCase, s as toPascalCase, t as capitalizeString, u as toSentenceCase } from "./case-Be3-bSPx.cjs";
 export { capitalizeString, convertStringCase, toCamelCase, toConstantCase, toDotCase, toKebabCase, toPascalCase, toPascalSnakeCase, toPathCase, toSentenceCase, toSnakeCase, toTitleCase, toTrainCase };

package/dist/change-case.d.mts

@@ -14,5 +14,5 @@
  * limitations under the License.
  */
 
-import { a as toDotCase, c as toPascalSnakeCase, d as toSnakeCase, f as toTitleCase, i as toConstantCase, l as toPathCase, n as convertStringCase, o as toKebabCase, p as toTrainCase, r as toCamelCase, s as toPascalCase, t as capitalizeString, u as toSentenceCase } from "./case-Ce8HJI8I.mjs";
+import { a as toDotCase, c as toPascalSnakeCase, d as toSnakeCase, f as toTitleCase, i as toConstantCase, l as toPathCase, n as convertStringCase, o as toKebabCase, p as toTrainCase, r as toCamelCase, s as toPascalCase, t as capitalizeString, u as toSentenceCase } from "./case-q0o80oIc.mjs";
 export { capitalizeString, convertStringCase, toCamelCase, toConstantCase, toDotCase, toKebabCase, toPascalCase, toPascalSnakeCase, toPathCase, toSentenceCase, toSnakeCase, toTitleCase, toTrainCase };

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_specials = require('../specials-DU8u108m.cjs');
-const require_guards = require('../guards-BD2Fkugj.cjs');
-const require_query = require('../query-lGVoAJl3.cjs');
+const require_utils = require('../utils-BzeK3wO9.cjs');
+const require_guards = require('../guards-DalSfIxV.cjs');
+const require_query = require('../query-Bo-_PC3j.cjs');
 
 //#region src/dom/storage.ts
 /**

package/dist/dom/index.d.cts

@@ -15,8 +15,8 @@
  */
 
 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-BMtRmMSC.cjs";
-import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "../form-DhsFvo_D.cjs";
+import { a as updateQueryParam, i as parseQueryStringLiteral, n as getQueryParams, r as parseQueryString, t as generateQueryParams } from "../query-Cih_n7VU.cjs";
+import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "../form-cW0-Ichd.cjs";
 
 //#region src/dom/storage.d.ts
 /**

package/dist/dom/index.d.mts

@@ -15,8 +15,8 @@
  */
 
 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-C-r5ZbO-.mjs";
-import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "../form-D_5I437n.mjs";
+import { a as updateQueryParam, i as parseQueryStringLiteral, n as getQueryParams, r as parseQueryString, t as generateQueryParams } from "../query-DNJK9kPd.mjs";
+import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "../form-CDTwFDkB.mjs";
 
 //#region src/dom/storage.d.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 { 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 { $ as trimString } from "../utils-DnyVgO8p.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-CLkSagHs.mjs";
 
 //#region src/dom/storage.ts
 /**

package/dist/{form-D_5I437n.d.mts → form-CDTwFDkB.d.mts}

@@ -15,7 +15,7 @@
  */
 
 import { S as KeyForObject, T as NestedKeyString, ai as RequireExactly, at as NormalPrimitive, u as DotNotationKey, x as KeyForArray } from "./object-DyVg8BFt.mjs";
-import { R as QueryString } from "./string-edtZyJHf.mjs";
+import { R as QueryString } from "./string-D7N_U6y2.mjs";
 import { f as TypeOrArray } from "./array-CbAKXvhH.mjs";
 
 //#region src/types/form.d.ts

package/dist/{form-DhsFvo_D.d.cts → form-cW0-Ichd.d.cts}

@@ -15,7 +15,7 @@
  */
 
 import { S as KeyForObject, T as NestedKeyString, ai as RequireExactly, at as NormalPrimitive, u as DotNotationKey, x as KeyForArray } from "./object-DyVg8BFt.cjs";
-import { R as QueryString } from "./string-Ok_IMpHP.cjs";
+import { R as QueryString } from "./string-Cm9AMOl_.cjs";
 import { f as TypeOrArray } from "./array-EVkwcL_k.cjs";
 
 //#region src/types/form.d.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_specials = require('../specials-DU8u108m.cjs');
-const require_basics = require('../basics-CiT7tnu_.cjs');
+const require_utils = require('../utils-BzeK3wO9.cjs');
+const require_basics = require('../basics-BGu9ygZK.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 { 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 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-DnyVgO8p.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-Bd2mj0uG.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_specials = require('../specials-DU8u108m.cjs');
-const require_parse = require('../parse-CffWYCuy.cjs');
+const require_utils = require('../utils-BzeK3wO9.cjs');
+const require_parse = require('../parse-Dz186-PH.cjs');
 
 //#region src/hash/Cipher.ts
 /**

package/dist/hash/index.d.cts

@@ -17,7 +17,7 @@
 import { nt as Maybe, y as GenericObject } from "../object-DyVg8BFt.cjs";
 import { _ as VerifiedToken, d as SignetPayload, l as SignOptions, p as TokenString, s as DecodedToken, v as VerifyOptions } from "../hash-DHawpylk.cjs";
 import { a as isUUIDv4, c as isUUIDv7, i as isUUIDv3, l as isUUIDv8, n as isUUIDv1, o as isUUIDv5, r as isUUIDv2, s as isUUIDv6, t as decodeUUID, u as uuid, w as isUUID } from "../uuid-CMNRM9NO.cjs";
-import { t as generateRandomID } from "../basics-CLwtIxap.cjs";
+import { t as generateRandomID } from "../basics-lvlgIf5Y.cjs";
 
 //#region src/hash/Cipher.d.ts
 /**

package/dist/hash/index.d.mts

@@ -17,7 +17,7 @@
 import { nt as Maybe, y as GenericObject } from "../object-DyVg8BFt.mjs";
 import { _ as VerifiedToken, d as SignetPayload, l as SignOptions, p as TokenString, s as DecodedToken, v as VerifyOptions } from "../hash-2mygGWLk.mjs";
 import { a as isUUIDv4, c as isUUIDv7, i as isUUIDv3, l as isUUIDv8, n as isUUIDv1, o as isUUIDv5, r as isUUIDv2, s as isUUIDv6, t as decodeUUID, u as uuid, w as isUUID } from "../uuid-DvQsIl9p.mjs";
-import { t as generateRandomID } from "../basics-BuHQJCNG.mjs";
+import { t as generateRandomID } from "../basics-D64kohDf.mjs";
 
 //#region src/hash/Cipher.d.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 { 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 { 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-DnyVgO8p.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_specials = require('./specials-DU8u108m.cjs');
-const require_basics = require('./basics-CiT7tnu_.cjs');
+const require_utils = require('./utils-BzeK3wO9.cjs');
+const require_basics = require('./basics-BGu9ygZK.cjs');
 const require_utilities = require('./utilities-_COSGq1U.cjs');
-const require_query = require('./query-lGVoAJl3.cjs');
+const require_query = require('./query-Bo-_PC3j.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.d.cts

@@ -15,12 +15,12 @@
  */
 
 import { $n as NumberType, Bn as DecimalOptions, D as NumericDotKey, E as NestedPrimitiveKey, F as SanitizeOptions, I as SanitizedData, In as BnDigitResult, Ln as ConvertOptions, O as ObjectEntry, Q as FlattenPartial, Rn as ConvertedDecimal, Un as FrankFurterCurrency, V as BasicPrimitive, Xn as LocaleCode, Zn as LooseRomanNumeral, a as ConvertObjectOptions, ar as RomanCapital, c as DeepKeys, ci as Tuple, ct as Numeric, g as FlattenDotValue, ir as RangedNumbers, k as Objects, lt as OwnKeys, nr as RandomNumberOptions, nt as Maybe, o as ConvertedObject, p as ExpandAll, pi as Unit, rr as RangeOptions, s as CountryDetails, tr as PercentageOptions, u as DotNotationKey, ut as PartialOrRequired, v as FlattenLeafValue, w as MergeAll, y as GenericObject, z as Any, zn as CurrencyCode } from "./object-DyVg8BFt.cjs";
-import { D as DiffResult, P as MaskOptions, _ as CharDiffResult, p as AnagramOptions } from "./string-Ok_IMpHP.cjs";
-import { n as convertStringCase, t as capitalizeString } from "./case-BmB2aGyp.cjs";
-import { i as parseQueryStringLiteral, r as parseQueryString, t as generateQueryParams } from "./query-BMtRmMSC.cjs";
+import { D as DiffResult, P as MaskOptions, _ as CharDiffResult, p as AnagramOptions } from "./string-Cm9AMOl_.cjs";
+import { n as convertStringCase, t as capitalizeString } from "./case-Be3-bSPx.cjs";
+import { i as parseQueryStringLiteral, r as parseQueryString, t as generateQueryParams } from "./query-Cih_n7VU.cjs";
 import { c as OrderOption, l as SortByOption, n as FindOptions, s as OptionsConfig, t as FieldValue, u as SortNature } from "./array-EVkwcL_k.cjs";
 import { C as shuffleArray, S as isInvalidOrEmptyArray, _ as findPrimeNumbers, a as deepParsePrimitives, b as flattenArray, c as getInstanceGetterNames, d as getStaticMethodNames, 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 isPrime, x as getLastArrayElement, y as filterArrayOfObjects } from "./index-D00Uqm9S.cjs";
-import { n as trimString, r as truncateString, t as generateRandomID } from "./basics-CLwtIxap.cjs";
+import { n as trimString, r as truncateString, t as generateRandomID } from "./basics-lvlgIf5Y.cjs";
 
 //#region src/string/anagram.d.ts
 /**

package/dist/index.d.mts

@@ -15,12 +15,12 @@
  */
 
 import { $n as NumberType, Bn as DecimalOptions, D as NumericDotKey, E as NestedPrimitiveKey, F as SanitizeOptions, I as SanitizedData, In as BnDigitResult, Ln as ConvertOptions, O as ObjectEntry, Q as FlattenPartial, Rn as ConvertedDecimal, Un as FrankFurterCurrency, V as BasicPrimitive, Xn as LocaleCode, Zn as LooseRomanNumeral, a as ConvertObjectOptions, ar as RomanCapital, c as DeepKeys, ci as Tuple, ct as Numeric, g as FlattenDotValue, ir as RangedNumbers, k as Objects, lt as OwnKeys, nr as RandomNumberOptions, nt as Maybe, o as ConvertedObject, p as ExpandAll, pi as Unit, rr as RangeOptions, s as CountryDetails, tr as PercentageOptions, u as DotNotationKey, ut as PartialOrRequired, v as FlattenLeafValue, w as MergeAll, y as GenericObject, z as Any, zn as CurrencyCode } from "./object-DyVg8BFt.mjs";
-import { D as DiffResult, P as MaskOptions, _ as CharDiffResult, p as AnagramOptions } from "./string-edtZyJHf.mjs";
-import { n as convertStringCase, t as capitalizeString } from "./case-Ce8HJI8I.mjs";
-import { i as parseQueryStringLiteral, r as parseQueryString, t as generateQueryParams } from "./query-C-r5ZbO-.mjs";
+import { D as DiffResult, P as MaskOptions, _ as CharDiffResult, p as AnagramOptions } from "./string-D7N_U6y2.mjs";
+import { n as convertStringCase, t as capitalizeString } from "./case-q0o80oIc.mjs";
+import { i as parseQueryStringLiteral, r as parseQueryString, t as generateQueryParams } from "./query-DNJK9kPd.mjs";
 import { c as OrderOption, l as SortByOption, n as FindOptions, s as OptionsConfig, t as FieldValue, u as SortNature } from "./array-CbAKXvhH.mjs";
 import { C as shuffleArray, S as isInvalidOrEmptyArray, _ as findPrimeNumbers, a as deepParsePrimitives, b as flattenArray, c as getInstanceGetterNames, d as getStaticMethodNames, 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 isPrime, x as getLastArrayElement, y as filterArrayOfObjects } from "./index-BbBnKdBb.mjs";
-import { n as trimString, r as truncateString, t as generateRandomID } from "./basics-BuHQJCNG.mjs";
+import { n as trimString, r as truncateString, t as generateRandomID } from "./basics-D64kohDf.mjs";
 
 //#region src/string/anagram.d.ts
 /**

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 { 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 { $ 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-DnyVgO8p.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-Bd2mj0uG.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-CLkSagHs.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-lGVoAJl3.cjs → query-Bo-_PC3j.cjs}

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

package/dist/{query-Cp1dq-qU.mjs → query-CLkSagHs.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 { 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 { $ as trimString, a as deepParsePrimitives, f as isDeepEqual } from "./utils-DnyVgO8p.mjs";
+import { t as isDateLike } from "./guards-CyOZsZ1r.mjs";
 
 //#region src/form/guards.ts
 /**

package/dist/{query-BMtRmMSC.d.cts → query-Cih_n7VU.d.cts}

@@ -15,7 +15,7 @@
  */
 
 import { M as ParsedQueryGeneric, N as QueryObject, j as ParsedQuery } from "./object-DyVg8BFt.cjs";
-import { R as QueryString } from "./string-Ok_IMpHP.cjs";
+import { R as QueryString } from "./string-Cm9AMOl_.cjs";
 
 //#region src/dom/query.d.ts
 /**

package/dist/{query-C-r5ZbO-.d.mts → query-DNJK9kPd.d.mts}

@@ -15,7 +15,7 @@
  */
 
 import { M as ParsedQueryGeneric, N as QueryObject, j as ParsedQuery } from "./object-DyVg8BFt.mjs";
-import { R as QueryString } from "./string-edtZyJHf.mjs";
+import { R as QueryString } from "./string-D7N_U6y2.mjs";
 
 //#region src/dom/query.d.ts
 /**

package/dist/{string-Ok_IMpHP.d.cts → string-Cm9AMOl_.d.cts}

@@ -109,6 +109,17 @@ interface MaskOptions {
   end?: number;
   /** Character to use for masking. Defaults to `*`. */
   maskCharacter?: string;
+  /** Whether to trim all whitespace characters before masking. Defaults to `false`. */
+  trim?: boolean;
+}
+/** Options for truncating a string */
+interface TruncateOptions {
+  /** The maximum length of the truncated string. Defaults to `100`. */
+  maxLength?: number;
+  /** The string to append to the truncated string. Defaults to `'...'`. */
+  suffix?: string;
+  /** Whether to trim all whitespace characters from the string before truncating. Defaults to `false`. */
+  trim?: boolean;
 }
 /** Formatted query string as `?${string}` = `?key=value&...` or empty string. */
 type QueryString = `?${string}` | '';
@@ -282,4 +293,4 @@ interface CharDiffResult {
   modified: HighlightedText[];
 }
 //#endregion
-export { HighlightedText as A, RemovedDiffLine as B, CountryShortISO as C, DiffResult as D, DiffLineType as E, PascalCase as F, TitleCase as G, SnakeCase as H, PascalSnakeCase as I, UnchangedOrModifiedDiffLine as J, TrainCase as K, PathCase as L, IsAlphabet as M, KebabCase as N, DiffStats as O, MaskOptions as P, QueryString as R, CountryName as S, DiffLineDetails as T, SpecialCharacter as U, SentenceCase as V, StringCaseOptions as W, CharDiffResult as _, $NormalizeString as a, CountryCode as b, $TrimRight as c, AddedDiffLine as d, Alphabet as f, CaseFormat as g, CapitalizeOptions as h, $LowercaseWords as i, Includes as j, DotCase as k, $UppercaseWords as l, CamelCase as m, $EnsureString as n, $TitleCaseWords as o, AnagramOptions as p, Trim as q, $LowerCaseWord as r, $TrimLeft as s, $CapitalizeWords as t, $WidenEmpty as u, ConstantCase as v, DiffLine as w, CountryISO as x, Country as y, RandomIdOptions as z };
+export { HighlightedText as A, RemovedDiffLine as B, CountryShortISO as C, DiffResult as D, DiffLineType as E, PascalCase as F, TitleCase as G, SnakeCase as H, PascalSnakeCase as I, TruncateOptions as J, TrainCase as K, PathCase as L, IsAlphabet as M, KebabCase as N, DiffStats as O, MaskOptions as P, QueryString as R, CountryName as S, DiffLineDetails as T, SpecialCharacter as U, SentenceCase as V, StringCaseOptions as W, UnchangedOrModifiedDiffLine as Y, CharDiffResult as _, $NormalizeString as a, CountryCode as b, $TrimRight as c, AddedDiffLine as d, Alphabet as f, CaseFormat as g, CapitalizeOptions as h, $LowercaseWords as i, Includes as j, DotCase as k, $UppercaseWords as l, CamelCase as m, $EnsureString as n, $TitleCaseWords as o, AnagramOptions as p, Trim as q, $LowerCaseWord as r, $TrimLeft as s, $CapitalizeWords as t, $WidenEmpty as u, ConstantCase as v, DiffLine as w, CountryISO as x, Country as y, RandomIdOptions as z };

package/dist/{string-edtZyJHf.d.mts → string-D7N_U6y2.d.mts}

@@ -109,6 +109,17 @@ interface MaskOptions {
   end?: number;
   /** Character to use for masking. Defaults to `*`. */
   maskCharacter?: string;
+  /** Whether to trim all whitespace characters before masking. Defaults to `false`. */
+  trim?: boolean;
+}
+/** Options for truncating a string */
+interface TruncateOptions {
+  /** The maximum length of the truncated string. Defaults to `100`. */
+  maxLength?: number;
+  /** The string to append to the truncated string. Defaults to `'...'`. */
+  suffix?: string;
+  /** Whether to trim all whitespace characters from the string before truncating. Defaults to `false`. */
+  trim?: boolean;
 }
 /** Formatted query string as `?${string}` = `?key=value&...` or empty string. */
 type QueryString = `?${string}` | '';
@@ -282,4 +293,4 @@ interface CharDiffResult {
   modified: HighlightedText[];
 }
 //#endregion
-export { HighlightedText as A, RemovedDiffLine as B, CountryShortISO as C, DiffResult as D, DiffLineType as E, PascalCase as F, TitleCase as G, SnakeCase as H, PascalSnakeCase as I, UnchangedOrModifiedDiffLine as J, TrainCase as K, PathCase as L, IsAlphabet as M, KebabCase as N, DiffStats as O, MaskOptions as P, QueryString as R, CountryName as S, DiffLineDetails as T, SpecialCharacter as U, SentenceCase as V, StringCaseOptions as W, CharDiffResult as _, $NormalizeString as a, CountryCode as b, $TrimRight as c, AddedDiffLine as d, Alphabet as f, CaseFormat as g, CapitalizeOptions as h, $LowercaseWords as i, Includes as j, DotCase as k, $UppercaseWords as l, CamelCase as m, $EnsureString as n, $TitleCaseWords as o, AnagramOptions as p, Trim as q, $LowerCaseWord as r, $TrimLeft as s, $CapitalizeWords as t, $WidenEmpty as u, ConstantCase as v, DiffLine as w, CountryISO as x, Country as y, RandomIdOptions as z };
+export { HighlightedText as A, RemovedDiffLine as B, CountryShortISO as C, DiffResult as D, DiffLineType as E, PascalCase as F, TitleCase as G, SnakeCase as H, PascalSnakeCase as I, TruncateOptions as J, TrainCase as K, PathCase as L, IsAlphabet as M, KebabCase as N, DiffStats as O, MaskOptions as P, QueryString as R, CountryName as S, DiffLineDetails as T, SpecialCharacter as U, SentenceCase as V, StringCaseOptions as W, UnchangedOrModifiedDiffLine as Y, CharDiffResult as _, $NormalizeString as a, CountryCode as b, $TrimRight as c, AddedDiffLine as d, Alphabet as f, CaseFormat as g, CapitalizeOptions as h, $LowercaseWords as i, Includes as j, DotCase as k, $UppercaseWords as l, CamelCase as m, $EnsureString as n, $TitleCaseWords as o, AnagramOptions as p, Trim as q, $LowerCaseWord as r, $TrimLeft as s, $CapitalizeWords as t, $WidenEmpty as u, ConstantCase as v, DiffLine as w, CountryISO as x, Country as y, RandomIdOptions as z };

package/dist/types/form.d.cts

@@ -14,5 +14,5 @@
  * limitations under the License.
  */
 
-import { a as OriginFileObj, i as FormDataConfigs, n as FileError, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "../form-DhsFvo_D.cjs";
+import { a as OriginFileObj, i as FormDataConfigs, n as FileError, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "../form-cW0-Ichd.cjs";
 export { CustomFile, FileError, FileUpload, FormDataConfigs, OriginFileObj, ParsedFormData, SerializedForm };

package/dist/types/form.d.mts

@@ -14,5 +14,5 @@
  * limitations under the License.
  */
 
-import { a as OriginFileObj, i as FormDataConfigs, n as FileError, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "../form-D_5I437n.mjs";
+import { a as OriginFileObj, i as FormDataConfigs, n as FileError, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "../form-CDTwFDkB.mjs";
 export { CustomFile, FileError, FileUpload, FormDataConfigs, OriginFileObj, ParsedFormData, SerializedForm };

package/dist/types/string.d.cts

@@ -14,5 +14,5 @@
  * limitations under the License.
  */
 
-import { A as HighlightedText, B as RemovedDiffLine, C as CountryShortISO, D as DiffResult, E as DiffLineType, F as PascalCase, G as TitleCase, H as SnakeCase, I as PascalSnakeCase, J as UnchangedOrModifiedDiffLine, K as TrainCase, L as PathCase, M as IsAlphabet, N as KebabCase, O as DiffStats, P as MaskOptions, R as QueryString, S as CountryName, T as DiffLineDetails, U as SpecialCharacter, V as SentenceCase, W as StringCaseOptions, _ as CharDiffResult, a as $NormalizeString, b as CountryCode, c as $TrimRight, d as AddedDiffLine, f as Alphabet, g as CaseFormat, h as CapitalizeOptions, i as $LowercaseWords, j as Includes, k as DotCase, l as $UppercaseWords, m as CamelCase, n as $EnsureString, o as $TitleCaseWords, p as AnagramOptions, q as Trim, r as $LowerCaseWord, s as $TrimLeft, t as $CapitalizeWords, u as $WidenEmpty, v as ConstantCase, w as DiffLine, x as CountryISO, y as Country, z as RandomIdOptions } from "../string-Ok_IMpHP.cjs";
-export { $CapitalizeWords, $EnsureString, $LowerCaseWord, $LowercaseWords, $NormalizeString, $TitleCaseWords, $TrimLeft, $TrimRight, $UppercaseWords, $WidenEmpty, AddedDiffLine, Alphabet, AnagramOptions, CamelCase, CapitalizeOptions, CaseFormat, CharDiffResult, ConstantCase, Country, CountryCode, CountryISO, CountryName, CountryShortISO, DiffLine, DiffLineDetails, DiffLineType, DiffResult, DiffStats, DotCase, HighlightedText, Includes, IsAlphabet, KebabCase, MaskOptions, PascalCase, PascalSnakeCase, PathCase, QueryString, RandomIdOptions, RemovedDiffLine, SentenceCase, SnakeCase, SpecialCharacter, StringCaseOptions, TitleCase, TrainCase, Trim, UnchangedOrModifiedDiffLine };
+import { A as HighlightedText, B as RemovedDiffLine, C as CountryShortISO, D as DiffResult, E as DiffLineType, F as PascalCase, G as TitleCase, H as SnakeCase, I as PascalSnakeCase, J as TruncateOptions, K as TrainCase, L as PathCase, M as IsAlphabet, N as KebabCase, O as DiffStats, P as MaskOptions, R as QueryString, S as CountryName, T as DiffLineDetails, U as SpecialCharacter, V as SentenceCase, W as StringCaseOptions, Y as UnchangedOrModifiedDiffLine, _ as CharDiffResult, a as $NormalizeString, b as CountryCode, c as $TrimRight, d as AddedDiffLine, f as Alphabet, g as CaseFormat, h as CapitalizeOptions, i as $LowercaseWords, j as Includes, k as DotCase, l as $UppercaseWords, m as CamelCase, n as $EnsureString, o as $TitleCaseWords, p as AnagramOptions, q as Trim, r as $LowerCaseWord, s as $TrimLeft, t as $CapitalizeWords, u as $WidenEmpty, v as ConstantCase, w as DiffLine, x as CountryISO, y as Country, z as RandomIdOptions } from "../string-Cm9AMOl_.cjs";
+export { $CapitalizeWords, $EnsureString, $LowerCaseWord, $LowercaseWords, $NormalizeString, $TitleCaseWords, $TrimLeft, $TrimRight, $UppercaseWords, $WidenEmpty, AddedDiffLine, Alphabet, AnagramOptions, CamelCase, CapitalizeOptions, CaseFormat, CharDiffResult, ConstantCase, Country, CountryCode, CountryISO, CountryName, CountryShortISO, DiffLine, DiffLineDetails, DiffLineType, DiffResult, DiffStats, DotCase, HighlightedText, Includes, IsAlphabet, KebabCase, MaskOptions, PascalCase, PascalSnakeCase, PathCase, QueryString, RandomIdOptions, RemovedDiffLine, SentenceCase, SnakeCase, SpecialCharacter, StringCaseOptions, TitleCase, TrainCase, Trim, TruncateOptions, UnchangedOrModifiedDiffLine };

package/dist/types/string.d.mts

@@ -14,5 +14,5 @@
  * limitations under the License.
  */
 
-import { A as HighlightedText, B as RemovedDiffLine, C as CountryShortISO, D as DiffResult, E as DiffLineType, F as PascalCase, G as TitleCase, H as SnakeCase, I as PascalSnakeCase, J as UnchangedOrModifiedDiffLine, K as TrainCase, L as PathCase, M as IsAlphabet, N as KebabCase, O as DiffStats, P as MaskOptions, R as QueryString, S as CountryName, T as DiffLineDetails, U as SpecialCharacter, V as SentenceCase, W as StringCaseOptions, _ as CharDiffResult, a as $NormalizeString, b as CountryCode, c as $TrimRight, d as AddedDiffLine, f as Alphabet, g as CaseFormat, h as CapitalizeOptions, i as $LowercaseWords, j as Includes, k as DotCase, l as $UppercaseWords, m as CamelCase, n as $EnsureString, o as $TitleCaseWords, p as AnagramOptions, q as Trim, r as $LowerCaseWord, s as $TrimLeft, t as $CapitalizeWords, u as $WidenEmpty, v as ConstantCase, w as DiffLine, x as CountryISO, y as Country, z as RandomIdOptions } from "../string-edtZyJHf.mjs";
-export { $CapitalizeWords, $EnsureString, $LowerCaseWord, $LowercaseWords, $NormalizeString, $TitleCaseWords, $TrimLeft, $TrimRight, $UppercaseWords, $WidenEmpty, AddedDiffLine, Alphabet, AnagramOptions, CamelCase, CapitalizeOptions, CaseFormat, CharDiffResult, ConstantCase, Country, CountryCode, CountryISO, CountryName, CountryShortISO, DiffLine, DiffLineDetails, DiffLineType, DiffResult, DiffStats, DotCase, HighlightedText, Includes, IsAlphabet, KebabCase, MaskOptions, PascalCase, PascalSnakeCase, PathCase, QueryString, RandomIdOptions, RemovedDiffLine, SentenceCase, SnakeCase, SpecialCharacter, StringCaseOptions, TitleCase, TrainCase, Trim, UnchangedOrModifiedDiffLine };
+import { A as HighlightedText, B as RemovedDiffLine, C as CountryShortISO, D as DiffResult, E as DiffLineType, F as PascalCase, G as TitleCase, H as SnakeCase, I as PascalSnakeCase, J as TruncateOptions, K as TrainCase, L as PathCase, M as IsAlphabet, N as KebabCase, O as DiffStats, P as MaskOptions, R as QueryString, S as CountryName, T as DiffLineDetails, U as SpecialCharacter, V as SentenceCase, W as StringCaseOptions, Y as UnchangedOrModifiedDiffLine, _ as CharDiffResult, a as $NormalizeString, b as CountryCode, c as $TrimRight, d as AddedDiffLine, f as Alphabet, g as CaseFormat, h as CapitalizeOptions, i as $LowercaseWords, j as Includes, k as DotCase, l as $UppercaseWords, m as CamelCase, n as $EnsureString, o as $TitleCaseWords, p as AnagramOptions, q as Trim, r as $LowerCaseWord, s as $TrimLeft, t as $CapitalizeWords, u as $WidenEmpty, v as ConstantCase, w as DiffLine, x as CountryISO, y as Country, z as RandomIdOptions } from "../string-D7N_U6y2.mjs";
+export { $CapitalizeWords, $EnsureString, $LowerCaseWord, $LowercaseWords, $NormalizeString, $TitleCaseWords, $TrimLeft, $TrimRight, $UppercaseWords, $WidenEmpty, AddedDiffLine, Alphabet, AnagramOptions, CamelCase, CapitalizeOptions, CaseFormat, CharDiffResult, ConstantCase, Country, CountryCode, CountryISO, CountryName, CountryShortISO, DiffLine, DiffLineDetails, DiffLineType, DiffResult, DiffStats, DotCase, HighlightedText, Includes, IsAlphabet, KebabCase, MaskOptions, PascalCase, PascalSnakeCase, PathCase, QueryString, RandomIdOptions, RemovedDiffLine, SentenceCase, SnakeCase, SpecialCharacter, StringCaseOptions, TitleCase, TrainCase, Trim, TruncateOptions, UnchangedOrModifiedDiffLine };

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

@@ -17,22 +17,28 @@
 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
-/**
-* * Utility to truncate a string to a specified length.
+/** Utility to truncate a string to a specified length.
 *
 * @param str The string to truncate.
-* @param maxLength The maximum length of the truncated string.
-* @returns Truncated string with ellipsis (`...`) (only if it has more length than `maxLength`).
+* @param optionsOrLength The maximum length of the truncated string or options.
+* @returns Truncated string based on provided options.
 */
-function truncateString(str, maxLength) {
+function truncateString(str, optionsOrLength) {
 	if (!require_primitives.isNonEmptyString(str)) return "";
-	const trimmedString = str.trim();
+	let maxLength = 100, suffix = "...", trim = false;
+	if (require_primitives.isNumber(optionsOrLength) && optionsOrLength > 0) maxLength = optionsOrLength;
+	else if (require_specials.isNotEmptyObject(optionsOrLength)) {
+		maxLength = optionsOrLength?.maxLength ?? maxLength;
+		suffix = optionsOrLength?.suffix ?? suffix;
+		trim = optionsOrLength?.trim ?? trim;
+	}
+	const trimmedString = trim ? trimString(str) : str;
 	if (!trimmedString) return "";
 	if (trimmedString.length <= maxLength) return trimmedString;
-	return trimmedString.slice(0, maxLength).concat("...");
+	return trimmedString.slice(0, maxLength).concat(suffix);
 }
 /**
 * * Generates a random alphanumeric (16 characters long, this length is customizable in the options) ID string composed of an optional `prefix`, `suffix`, a `timestamp`, `caseOption` and a customizable `separator`.
@@ -41,6 +47,7 @@ function truncateString(str, maxLength) {
 * @returns The generated ID string composed of the random alphanumeric string of specified length with optional `timeStamp`, `prefix`, and `suffix`, `caseOption` and `separator`.
 *
 * @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/hash/uuid uuid} for `uuid` generation
+* @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/hash/random-numeric randomHex} for random numeric string generation
 * @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/hash/random-hex randomHex} for random hexadecimal string generation
 *
 * @example
@@ -145,7 +152,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 +585,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 +625,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 +764,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 +854,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 +1170,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 +1299,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 +1313,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 +1678,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-DnyVgO8p.mjs}

@@ -17,22 +17,28 @@
 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
-/**
-* * Utility to truncate a string to a specified length.
+/** Utility to truncate a string to a specified length.
 *
 * @param str The string to truncate.
-* @param maxLength The maximum length of the truncated string.
-* @returns Truncated string with ellipsis (`...`) (only if it has more length than `maxLength`).
+* @param optionsOrLength The maximum length of the truncated string or options.
+* @returns Truncated string based on provided options.
 */
-function truncateString(str, maxLength) {
+function truncateString(str, optionsOrLength) {
 	if (!isNonEmptyString(str)) return "";
-	const trimmedString = str.trim();
+	let maxLength = 100, suffix = "...", trim = false;
+	if (isNumber(optionsOrLength) && optionsOrLength > 0) maxLength = optionsOrLength;
+	else if (isNotEmptyObject(optionsOrLength)) {
+		maxLength = optionsOrLength?.maxLength ?? maxLength;
+		suffix = optionsOrLength?.suffix ?? suffix;
+		trim = optionsOrLength?.trim ?? trim;
+	}
+	const trimmedString = trim ? trimString(str) : str;
 	if (!trimmedString) return "";
 	if (trimmedString.length <= maxLength) return trimmedString;
-	return trimmedString.slice(0, maxLength).concat("...");
+	return trimmedString.slice(0, maxLength).concat(suffix);
 }
 /**
 * * Generates a random alphanumeric (16 characters long, this length is customizable in the options) ID string composed of an optional `prefix`, `suffix`, a `timestamp`, `caseOption` and a customizable `separator`.
@@ -41,6 +47,7 @@ function truncateString(str, maxLength) {
 * @returns The generated ID string composed of the random alphanumeric string of specified length with optional `timeStamp`, `prefix`, and `suffix`, `caseOption` and `separator`.
 *
 * @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/hash/uuid uuid} for `uuid` generation
+* @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/hash/random-numeric randomHex} for random numeric string generation
 * @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/hash/random-hex randomHex} for random hexadecimal string generation
 *
 * @example
@@ -145,7 +152,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 +585,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 +625,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 +764,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 +854,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 +1170,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 +1299,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 +1313,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 +1678,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.6",
   "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": {