toolbox-x 2.4.4 → 2.4.6

package/CHANGELOG.md

@@ -4,6 +4,14 @@ 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)

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

@@ -15,8 +15,8 @@
  */
 
 const require_primitives = require('./primitives-CBGICrDR.cjs');
-const require_utils = require('./utils-BxZGABHS.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-KYRpMQNe.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-DcRr0A7B.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/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-BxZGABHS.cjs');
 const require_specials = require('../specials-DU8u108m.cjs');
+const require_utils = require('../utils-BzeK3wO9.cjs');
 const require_guards = require('../guards-DalSfIxV.cjs');
-const require_query = require('../query-iJflCkq1.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-DcRr0A7B.mjs";
 import { j as isValidArray, v as isEmptyObject, w as isNotEmptyObject } from "../specials-krf7zsqI.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-B8VPCIKA.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,9 +16,9 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primitives = require('../primitives-CBGICrDR.cjs');
-const require_utils = require('../utils-BxZGABHS.cjs');
 const require_specials = require('../specials-DU8u108m.cjs');
-const require_basics = require('../basics-CUzK7wFN.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-DalSfIxV.cjs');
 

package/dist/guards/index.mjs

@@ -15,9 +15,9 @@
  */
 
 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-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-KYRpMQNe.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-CyOZsZ1r.mjs";
 

package/dist/hash/index.cjs

@@ -16,8 +16,8 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primitives = require('../primitives-CBGICrDR.cjs');
-const require_utils = require('../utils-BxZGABHS.cjs');
 const require_specials = require('../specials-DU8u108m.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,8 +15,8 @@
  */
 
 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-DcRr0A7B.mjs";
 import { c as isHexString, m as isUUID, n as isBinaryString, t as isBase64, w as isNotEmptyObject } from "../specials-krf7zsqI.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-BxZGABHS.cjs');
 const require_specials = require('./specials-DU8u108m.cjs');
-const require_basics = require('./basics-CUzK7wFN.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-iJflCkq1.cjs');
+const require_query = require('./query-Bo-_PC3j.cjs');
 
 //#region src/string/anagram.ts
 /** `WeakMap` to cache user provided dictionary array */

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-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-KYRpMQNe.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-B8VPCIKA.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 */

package/dist/{query-iJflCkq1.cjs → query-Bo-_PC3j.cjs}

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

package/dist/{query-B8VPCIKA.mjs → query-CLkSagHs.mjs}

@@ -15,8 +15,8 @@
  */
 
 import { d as isString } from "./primitives-Djsevc69.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 { $ 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-BxZGABHS.cjs → utils-BzeK3wO9.cjs}

@@ -20,19 +20,25 @@ const require_utilities = require('./utilities-_COSGq1U.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

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

@@ -20,19 +20,25 @@ import { a as normalizeNumber } from "./utilities-CmPwOkdy.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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolbox-x",
-  "version": "2.4.4",
+  "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",