@rzl-zone/utils-js 3.7.1 → 3.8.0

package/dist/conversions/index.cjs

@@ -2,14 +2,14 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunkKTQLDIIT_cjs = require('../chunk-KTQLDIIT.cjs');
+var chunk3JD53UUH_cjs = require('../chunk-3JD53UUH.cjs');
 require('../chunk-TFDXRT6D.cjs');
 var chunkAKKM6MOX_cjs = require('../chunk-AKKM6MOX.cjs');
 require('../chunk-UKAUXY2U.cjs');
@@ -17,7 +17,7 @@ var chunkEK7FSI7F_cjs = require('../chunk-EK7FSI7F.cjs');
 require('../chunk-B4SDEBN7.cjs');
 require('../chunk-NREACG6M.cjs');
 require('../chunk-K63WO3XA.cjs');
-var chunk66WLOZOD_cjs = require('../chunk-66WLOZOD.cjs');
+var chunk6NORJBI6_cjs = require('../chunk-6NORJBI6.cjs');
 require('../chunk-7QQV66RX.cjs');
 require('../chunk-ATLFMKAF.cjs');
 require('../chunk-7WBMA2VE.cjs');
@@ -28,47 +28,47 @@ require('../chunk-F3WBQKRI.cjs');
 
 Object.defineProperty(exports, "convertType", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.convertType; }
+  get: function () { return chunk3JD53UUH_cjs.convertType; }
 });
 Object.defineProperty(exports, "dedupeArray", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.dedupeArray; }
+  get: function () { return chunk3JD53UUH_cjs.dedupeArray; }
 });
 Object.defineProperty(exports, "removeObjectPaths", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.removeObjectPaths; }
+  get: function () { return chunk3JD53UUH_cjs.removeObjectPaths; }
 });
 Object.defineProperty(exports, "toBooleanContent", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.toBooleanContent; }
+  get: function () { return chunk3JD53UUH_cjs.toBooleanContent; }
 });
 Object.defineProperty(exports, "toBooleanContentDeep", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.toBooleanContentDeep; }
+  get: function () { return chunk3JD53UUH_cjs.toBooleanContentDeep; }
 });
 Object.defineProperty(exports, "toBooleanExplicit", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.toBooleanExplicit; }
+  get: function () { return chunk3JD53UUH_cjs.toBooleanExplicit; }
 });
 Object.defineProperty(exports, "toBooleanLoose", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.toBooleanLoose; }
+  get: function () { return chunk3JD53UUH_cjs.toBooleanLoose; }
 });
 Object.defineProperty(exports, "toNumberArrayUnRecursive", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.toNumberArrayUnRecursive; }
+  get: function () { return chunk3JD53UUH_cjs.toNumberArrayUnRecursive; }
 });
 Object.defineProperty(exports, "toNumberDeep", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.toNumberDeep; }
+  get: function () { return chunk3JD53UUH_cjs.toNumberDeep; }
 });
 Object.defineProperty(exports, "toStringDeep", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.toStringDeep; }
+  get: function () { return chunk3JD53UUH_cjs.toStringDeep; }
 });
 Object.defineProperty(exports, "toStringDeepForce", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.toStringDeepForce; }
+  get: function () { return chunk3JD53UUH_cjs.toStringDeepForce; }
 });
 Object.defineProperty(exports, "filterNilArray", {
   enumerable: true,
@@ -84,19 +84,19 @@ Object.defineProperty(exports, "parseCurrencyString", {
 });
 Object.defineProperty(exports, "cleanParsedData", {
   enumerable: true,
-  get: function () { return chunk66WLOZOD_cjs.cleanParsedData; }
+  get: function () { return chunk6NORJBI6_cjs.cleanParsedData; }
 });
 Object.defineProperty(exports, "extractDigits", {
   enumerable: true,
-  get: function () { return chunk66WLOZOD_cjs.extractDigits; }
+  get: function () { return chunk6NORJBI6_cjs.extractDigits; }
 });
 Object.defineProperty(exports, "parseCustomDate", {
   enumerable: true,
-  get: function () { return chunk66WLOZOD_cjs.parseCustomDate; }
+  get: function () { return chunk6NORJBI6_cjs.parseCustomDate; }
 });
 Object.defineProperty(exports, "safeJsonParse", {
   enumerable: true,
-  get: function () { return chunk66WLOZOD_cjs.safeJsonParse; }
+  get: function () { return chunk6NORJBI6_cjs.safeJsonParse; }
 });
 Object.defineProperty(exports, "safeStableStringify", {
   enumerable: true,

package/dist/conversions/index.d.ts

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
@@ -72,7 +72,7 @@ removeInvalidValueNumber?:T;};
  *    - Other values ➔ coerced into `undefined`.
  *    - Invalid values can be **removed** (`removeInvalidValueNumber: true`) or **kept** (`false`).
  * - **ℹ️ Note:**
- *    - _For recursive / nested arrays, use **{@link toNumberDeep | `toNumberDeep`}** instead._
+ *    - _For recursive / nested arrays, use ***`toNumberDeep` utility function*** instead._
  * @template T - Element type of the input array.
  * @template R - Whether invalid values should be removed (`true`) or kept (`false`).
  * @param {Array<T> | readonly T[] | null | undefined} [array] - The array to convert, returns `undefined` if not an array.
@@ -154,7 +154,7 @@ removeInvalidValue?:T;};
  *    - Other unsupported types will be converted to `undefined` (and removed
  *      if `removeInvalidValue=true`).
  * - **ℹ️ Note:**
- *    - _For recursive / nested arrays, use **{@link toStringDeep | `toStringDeep`}** instead._
+ *    - _For recursive / nested arrays, use ***`toStringDeep` utility function*** instead._
  * @template T - Element type of the input array.
  * @template R - Whether invalid values should be removed (`true`) or kept (`false`).
  * @param {Array<string | number | bigint | boolean | null | undefined> | null | undefined} [array] - The array to convert, returns `undefined` if not an array.
@@ -220,7 +220,7 @@ flatten?:Fl;};
  * @param {unknown[]} inputArray - The array to deduplicate, can be deeply nested and contain any mix of types.
  * @param {DedupeArrayOptions<ForceToString, Flattening>|undefined} [options] - Options to control string conversion.
  * @returns {DedupeResult<ForceToString, Flattening>} Deduplicated array with optional transformations.
- * @throws {TypeError} If the input is not an array, or options is not an object, or if `forceToString` is invalid.
+ * @throws **{@link TypeError | `TypeError`}** if the input is not an array, or options is not an object, or if `forceToString` is invalid.
  * @example
  * ```ts
  * dedupeArray(["apple", "banana", "apple"]);
@@ -430,7 +430,7 @@ includeIndeterminate?:boolean;};
  * @param {ToBooleanExplicitOptions["trimString"]} [options.trimString=true] - Whether to trim whitespace before comparison, default: `true`.
  * @param {ToBooleanExplicitOptions["includeIndeterminate"]} [options.includeIndeterminate=false] - If `true`, the string `"indeterminate"` is considered a truthy value, defaults to `false`.
  * @returns {boolean} Return `true` if the value matches a truthy representation, otherwise `false`.
- * @throws {TypeError} Throws if any option provided is not a boolean.
+ * @throws **{@link TypeError | `TypeError`}** if any option provided is not a boolean.
  * @example
  * toBooleanExplicit(1);
  * // ➔ true
@@ -703,7 +703,7 @@ checkSymbols?:boolean;};
  * @param {*} data - The parsed JSON data.
  * @param {ParseParsedDataOptions} [options] - The cleaning options.
  * @returns {T | null | undefined} The cleaned data.
- * - ***⚠️ Notice:*** _If data is JSON string, we recommend use **{@link safeJsonParse | `safeJsonParse`}** for more safe._
+ * - ***⚠️ Notice:*** _If data is JSON string, we recommend use ***`safeJsonParse` utility function*** for more safe._
  * - ***⚠️ Note:*** _If using **`convertDates`** **options**, result may contain Date objects, you may need type assertions in strict TypeScript settings._
  * @example
  * ```ts
@@ -728,7 +728,7 @@ declare const cleanParsedData:<T=unknown>(data:T,options?:ParseParsedDataOptions
  * @param {string} dateString - Date string to parse.
  * @param {string} format - Date format to match.
  * @returns {Date | null} Returns a `Date` object if valid, otherwise `null`.
- * @throws {TypeError} Throw an type-error if `dateString` **(first parameter)** and `format` **(second parameter)** is not a string or empty-string.
+ * @throws **{@link TypeError | `TypeError`}** if `dateString` **(first parameter)** and `format` **(second parameter)** is not a string or empty-string.
  * @example
  * // Valid: European format (DD/MM/YYYY)
  * const date1 = parseCustomDate("03/09/2025", "DD/MM/YYYY");
@@ -797,7 +797,7 @@ type SafeJsonParseResult<TData,T>=IfNotExtends<T,NonJsonParsableType>extends tru
  * @param {ParseParsedDataOptions} [options] - Options to clean, convert types, enable strict mode,
  *   support custom date formats, enable logging, or handle errors via callback.
  * @returns {SafeJsonParseResult<TData, TInput>} Parsed and optionally cleaned result, or `null`/`undefined`.
- * @throws {TypeError} If `options` is provided but not a valid object.
+ * @throws **{@link TypeError | `TypeError`}** if `options` is provided but not a valid object.
  * @example
  * 1. ***Basic parse with number & boolean conversion:***
  *  ```ts
@@ -1038,8 +1038,7 @@ type ResultRemoveObjectPaths<T,K extends readonly ConfigRemoveObjectPaths<T>[]>=
  * @returns {Partial<T>}
  *   - A new object with specified keys removed if `deepClone` is `true`.
  *   - The *same mutated object* if `deepClone` is `false`.
- * @throws {TypeError}
- *   - If `keysToDelete` is not an array of `{ key, deep? }` objects.
+ * @throws **{@link TypeError | `TypeError`}** if `keysToDelete` is not an array of `{ key, deep? }` objects.
  * @example
  * // Shallow deletion
  * removeObjectPaths(
@@ -1199,8 +1198,7 @@ keepUndefined?:boolean;};
  *    - `pretty` (boolean) – Whether to pretty-print JSON output with 2-space indentation, default: `false`.
  * @returns {string}
  *   A stable JSON string representation of the input value.
- * @throws {TypeError}
- *   Throws if `sortKeys`, `sortArray`, or `pretty` are not strictly boolean.
+ * @throws **{@link TypeError | `TypeError`}** if `sortKeys`, `sortArray`, or `pretty` are not strictly boolean.
  * @example
  * ```ts
  * // Basic object key sorting

package/dist/conversions/index.js

@@ -2,12 +2,12 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-export { convertType, dedupeArray, removeObjectPaths, toBooleanContent, toBooleanContentDeep, toBooleanExplicit, toBooleanLoose, toNumberArrayUnRecursive, toNumberDeep, toStringDeep, toStringDeepForce } from '../chunk-TDPYR5JY.js';
+export { convertType, dedupeArray, removeObjectPaths, toBooleanContent, toBooleanContentDeep, toBooleanExplicit, toBooleanLoose, toNumberArrayUnRecursive, toNumberDeep, toStringDeep, toStringDeepForce } from '../chunk-6VA4F6VR.js';
 import '../chunk-ZN53RM3R.js';
 export { filterNilArray, toStringArrayUnRecursive } from '../chunk-TDYGYHSH.js';
 import '../chunk-PZQC3FZY.js';
@@ -15,7 +15,7 @@ export { parseCurrencyString } from '../chunk-DPLL67OT.js';
 import '../chunk-7ZNEUWYP.js';
 import '../chunk-JY4HLZ4W.js';
 import '../chunk-FI76UZRF.js';
-export { cleanParsedData, extractDigits, parseCustomDate, safeJsonParse } from '../chunk-XFTUHS4Y.js';
+export { cleanParsedData, extractDigits, parseCustomDate, safeJsonParse } from '../chunk-KVZ3HL2B.js';
 import '../chunk-SZJ7OI4S.js';
 import '../chunk-VCVND6CH.js';
 import '../chunk-6WMB5AJR.js';

package/dist/events/index.cjs

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/events/index.d.ts

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
@@ -25,8 +25,8 @@
  *    - Throws `TypeError` if the `className` parameter is not a string.
  * @defaultValue `"on_processing"`
  * @param {string} [className="on_processing"] - The CSS class to add, defaults to `"on_processing"`.
- * @returns {void} Does not return anything.
- * @throws {TypeError} If `className` is not a string.
+ * @returns {void} Does not return anything (void).
+ * @throws **{@link TypeError | `TypeError`}** if `className` is not a string.
  * @example
  * * ***Example in your code:***
  * ```ts
@@ -69,8 +69,8 @@ declare const disableUserInteraction:(className?:string)=>void;
  *    - Throws `TypeError` if the `className` parameter is not a string.
  * @defaultValue `"on_processing"`
  * @param {string} [className="on_processing"] - The CSS class to remove, defaults to `"on_processing"`.
- * @returns {void} Does not return anything.
- * @throws {TypeError} If `className` is not a string.
+ * @returns {void} Does not return anything (void).
+ * @throws **{@link TypeError | `TypeError`}** if `className` is not a string.
  * @example
  * * ***Example in your code:***
  * ```ts
@@ -100,10 +100,10 @@ declare const enableUserInteraction:(className?:string)=>void;
  * ----------------------------------------------------------
  * **Removes focus from the currently active element in the document.**
  * - **Features**:
- *    - This function works **only in browser environments**.
- *    - If an element is focused, it will lose focus by calling `blur()`.
+ *    - This function works **only in browser environments** ***(safely no-ops in server environments)***.
+ *    - If an element is focused, it will lose focus by calling `HTMLElement.blur()`.
  *    - If no element is focused or the active element is not an `HTMLElement`, nothing happens.
- * @returns {void} Does not return anything.
+ * @returns {void} Does not return anything (void).
  * @example
  * removeElementFocus(); // ➔ Removes focus from the currently active element
  */
@@ -153,7 +153,7 @@ timeout?:number|undefined;};
  *   - Non-integer number are truncated to an integer.
  *   - Force to `2147483647` if number is larger than `2147483647`.
  *   - Default force to `1` if `missing`, `NaN`, `invalid`, or `less-than` `1`.
- * @returns {void} Does not return anything, only scrolling to top.
+ * @returns {void} Does not return anything, only scrolling to top (void).
  * @example
  * // ✅ Valid options value:
  * scrollToTop();

package/dist/events/index.js

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/formatters/index.cjs

@@ -2,14 +2,14 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunkOS5OT5JA_cjs = require('../chunk-OS5OT5JA.cjs');
+var chunk5PF7KRCP_cjs = require('../chunk-5PF7KRCP.cjs');
 require('../chunk-B6UIKBHR.cjs');
 require('../chunk-EK7FSI7F.cjs');
 require('../chunk-B4SDEBN7.cjs');
@@ -22,41 +22,41 @@ require('../chunk-F3WBQKRI.cjs');
 
 Object.defineProperty(exports, "censorEmail", {
   enumerable: true,
-  get: function () { return chunkOS5OT5JA_cjs.censorEmail; }
+  get: function () { return chunk5PF7KRCP_cjs.censorEmail; }
 });
 Object.defineProperty(exports, "chunkString", {
   enumerable: true,
-  get: function () { return chunkOS5OT5JA_cjs.chunkString; }
+  get: function () { return chunk5PF7KRCP_cjs.chunkString; }
 });
 Object.defineProperty(exports, "formatCurrency", {
   enumerable: true,
-  get: function () { return chunkOS5OT5JA_cjs.formatCurrency; }
+  get: function () { return chunk5PF7KRCP_cjs.formatCurrency; }
 });
 Object.defineProperty(exports, "formatDateFns", {
   enumerable: true,
-  get: function () { return chunkOS5OT5JA_cjs.formatDateFns; }
+  get: function () { return chunk5PF7KRCP_cjs.formatDateFns; }
 });
 Object.defineProperty(exports, "formatDateIntl", {
   enumerable: true,
-  get: function () { return chunkOS5OT5JA_cjs.formatDateIntl; }
+  get: function () { return chunk5PF7KRCP_cjs.formatDateIntl; }
 });
 Object.defineProperty(exports, "formatDateTime", {
   enumerable: true,
-  get: function () { return chunkOS5OT5JA_cjs.formatDateTime; }
+  get: function () { return chunk5PF7KRCP_cjs.formatDateTime; }
 });
 Object.defineProperty(exports, "formatNumber", {
   enumerable: true,
-  get: function () { return chunkOS5OT5JA_cjs.formatNumber; }
+  get: function () { return chunk5PF7KRCP_cjs.formatNumber; }
 });
 Object.defineProperty(exports, "formatPhoneNumber", {
   enumerable: true,
-  get: function () { return chunkOS5OT5JA_cjs.formatPhoneNumber; }
+  get: function () { return chunk5PF7KRCP_cjs.formatPhoneNumber; }
 });
 Object.defineProperty(exports, "getGMTOffset", {
   enumerable: true,
-  get: function () { return chunkOS5OT5JA_cjs.getGMTOffset; }
+  get: function () { return chunk5PF7KRCP_cjs.getGMTOffset; }
 });
 Object.defineProperty(exports, "truncateString", {
   enumerable: true,
-  get: function () { return chunkOS5OT5JA_cjs.truncateString; }
+  get: function () { return chunk5PF7KRCP_cjs.truncateString; }
 });

package/dist/formatters/index.d.ts

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
@@ -148,7 +148,7 @@ indianFormat?:boolean;};
  *          - `"CHF 12'345.60"` ***(Swiss)***.
  *          - `"1,23,456.78"` ***(Indian)***.
  * - Auto extracts numeric value with smart multi-locale parsing
- *   via ***{@link parseCurrencyString | `parseCurrencyString`}***.
+ *   via ***`parseCurrencyString` utility function***.
  * - Strong type checks & clear errors for misconfigured options.
  * - **Handles:**
  *    - Thousands separators: `.`, `,`, `'`, ` `.
@@ -228,8 +228,7 @@ indianFormat?:boolean;};
  *    - `"Rp 15.000,10.-"`.
  *    - `"15'000.10 USD"`.
  *    - `"12,34,567.89"`.
- * @throws {TypeError}
- *  ***Will throw TypeError If:***
+ * @throws **{@link TypeError | `TypeError`}** ***If:***
  *    - The `value` is not string or number.
  *    - Cannot parse to valid number.
  *    - Options have invalid types.
@@ -379,8 +378,7 @@ declare const formatCurrency:(value:string|number,options?:FormatCurrencyOptions
  * @param {string} [separator=","] - The thousands separator to use, examples: `","` ***(default)***, `"."`, `" "`, etc.
  * @returns {string} The formatted string with thousands separators and
  *   appropriate decimal separator.
- * @throws {TypeError} If `value` is not a string or number,
- * or `separator` is not a string.
+ * @throws **{@link TypeError | `TypeError`}** if `value` is not a string or number, or `separator` is not a string.
  * @example
  * formatNumber(1000000);
  * // ➔ "1,000,000"
@@ -1118,8 +1116,8 @@ takeNumberOnly:true;}>;
  * - **E.164 compliance:**
  *    - Optional leading `+` is recommended but **not required**.
  *    - If Without leading `+`, you must passing `defaultCountry`.
- * @throws {TypeError} If `value` is not string, number, null or undefined.
- * @throws {TypeError} If `options` is not an object or contains wrong types.
+ * @throws **{@link TypeError | `TypeError`}** if `value` is not string, number, null or undefined.
+ * @throws **{@link TypeError | `TypeError`}** if `options` is not an object or contains wrong types.
  * @param {ValueFormatPhoneNumber} value
  *  ***Phone number to format, accepts:***
  *   - `string` (recommended to preserve leading zeros).
@@ -1243,8 +1241,8 @@ declare function formatPhoneNumber(value:ValueFormatPhoneNumber,options?:FormatP
  * - **E.164 compliance:**
  *    - Optional leading `+` is recommended but **not required**.
  *    - If Without leading `+`, you must passing `defaultCountry`.
- * @throws {TypeError} If `value` is not string, number, null or undefined.
- * @throws {TypeError} If `options` is not an object or contains wrong types.
+ * @throws **{@link TypeError | `TypeError`}** if `value` is not string, number, null or undefined.
+ * @throws **{@link TypeError | `TypeError`}** if `options` is not an object or contains wrong types.
  * @param {ValueFormatPhoneNumber} value
  *   Phone number to format. Accepts:
  *   - `string` (recommended to preserve leading zeros)
@@ -1299,8 +1297,8 @@ declare function formatPhoneNumber(value:ValueFormatPhoneNumber,options?:FormatP
  * - **E.164 compliance:**
  *    - Optional leading `+` is recommended but **not required**.
  *    - If Without leading `+`, you must passing `defaultCountry`.
- * @throws {TypeError} If `value` is not string, number, null or undefined.
- * @throws {TypeError} If `options` is not an object or contains wrong types.
+ * @throws **{@link TypeError | `TypeError`}** if `value` is not string, number, null or undefined.
+ * @throws **{@link TypeError | `TypeError`}** if `options` is not an object or contains wrong types.
  * @param {ValueFormatPhoneNumber} value
  *  Phone number to format. Accepts:
  *   - `string` (recommended to preserve leading zeros).
@@ -1359,8 +1357,8 @@ declare function formatPhoneNumber(value:ValueFormatPhoneNumber,options?:FormatP
  * - **E.164 compliance:**
  *    - Optional leading `+` is recommended but **not required**.
  *    - If Without leading `+`, you must passing `defaultCountry`.
- * @throws {TypeError} If `value` is not string, number, null or undefined.
- * @throws {TypeError} If `options` is not an object or contains wrong types.
+ * @throws **{@link TypeError | `TypeError`}** if `value` is not string, number, null or undefined.
+ * @throws **{@link TypeError | `TypeError`}** if `options` is not an object or contains wrong types.
  * @param {ValueFormatPhoneNumber} value
  *  Phone number to format. Accepts:
  *   - `string` (recommended to preserve leading zeros).
@@ -1475,8 +1473,8 @@ declare function formatPhoneNumber(value:ValueFormatPhoneNumber,options?:FormatP
  * - **E.164 compliance:**
  *    - Optional leading `+` is recommended but **not required**.
  *    - If Without leading `+`, you must passing `defaultCountry`.
- * @throws {TypeError} If `value` is not string, number, null or undefined.
- * @throws {TypeError} If `options` is not an object or contains wrong types.
+ * @throws **{@link TypeError | `TypeError`}** if `value` is not string, number, null or undefined.
+ * @throws **{@link TypeError | `TypeError`}** if `options` is not an object or contains wrong types.
  * @param {ValueFormatPhoneNumber} value
  *   Phone number to format. Accepts:
  *   - `string` (recommended to preserve leading zeros)
@@ -1554,8 +1552,8 @@ declare function formatPhoneNumber(value:ValueFormatPhoneNumber,options?:FormatP
  * - **E.164 compliance:**
  *    - Optional leading `+` is recommended but **not required**.
  *    - If Without leading `+`, you must passing `defaultCountry`.
- * @throws {TypeError} If `value` is not string, number, null or undefined.
- * @throws {TypeError} If `options` is not an object or contains wrong types.
+ * @throws **{@link TypeError | `TypeError`}** if `value` is not string, number, null or undefined.
+ * @throws **{@link TypeError | `TypeError`}** if `options` is not an object or contains wrong types.
  * @param {ValueFormatPhoneNumber} value
  *  Phone number to format. Accepts:
  *   - `string` (recommended to preserve leading zeros).
@@ -1699,7 +1697,7 @@ mode?:"random"|"fixed";};
  * @param {string | null | undefined} email - The email address to censor.
  * @param {CensorEmailOptions} [options={}] - Options object for mode.
  * @returns {string} The censored email, or an empty string if input is invalid.
- * @throws {TypeError} If `options` is not a plain object or `mode` is invalid.
+ * @throws **{@link TypeError | `TypeError`}** if `options` is not a plain object or `mode` is invalid.
  * @example
  * // Fixed mode (default, deterministic)
  * censorEmail("john.doe@gmail.com");
@@ -1821,11 +1819,8 @@ trim?:boolean;};
  *    - `length` (number, default 10): Maximum length of the truncated string.
  *    - `ending` (string, default `"..."`): String to append if truncation occurs.
  *    - `trim` (boolean, default `true`): Whether to trim the input before truncation.
- * @returns {string} The truncated string with optional trimming and ending.
- *                   Returns `""` if input is empty or length < 1.
- * @throws {TypeError} If `options.length` is not a finite number,
- *                     or if `options.ending` is not a string,
- *                     or if `options.trim` is not a boolean.
+ * @returns {string} The truncated string with optional trimming and ending, returns `""` if input is empty or length < 1.
+ * @throws **{@link TypeError | `TypeError`}** if `options.length` is not a finite number, or if `options.ending` is not a string, or if `options.trim` is not a boolean.
  * @example
  * truncateString("hello world", { length: 5 });
  * // ➔ "hello..."

package/dist/formatters/index.js

@@ -2,12 +2,12 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-export { censorEmail, chunkString, formatCurrency, formatDateFns, formatDateIntl, formatDateTime, formatNumber, formatPhoneNumber, getGMTOffset, truncateString } from '../chunk-QUITZ3GP.js';
+export { censorEmail, chunkString, formatCurrency, formatDateFns, formatDateIntl, formatDateTime, formatNumber, formatPhoneNumber, getGMTOffset, truncateString } from '../chunk-I3IXLEEG.js';
 import '../chunk-OFBFGFVH.js';
 import '../chunk-DPLL67OT.js';
 import '../chunk-7ZNEUWYP.js';

package/dist/generators/index.cjs

@@ -2,14 +2,14 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunkK3SONK25_cjs = require('../chunk-K3SONK25.cjs');
+var chunkHKJZ7K2K_cjs = require('../chunk-HKJZ7K2K.cjs');
 require('../chunk-DVMHRLKP.cjs');
 var chunkBAV5T2E3_cjs = require('../chunk-BAV5T2E3.cjs');
 require('../chunk-YC7AK3KX.cjs');
@@ -18,19 +18,23 @@ require('../chunk-F3WBQKRI.cjs');
 
 Object.defineProperty(exports, "getRandomItem", {
   enumerable: true,
-  get: function () { return chunkK3SONK25_cjs.getRandomItem; }
+  get: function () { return chunkHKJZ7K2K_cjs.getRandomItem; }
 });
 Object.defineProperty(exports, "randomInt", {
   enumerable: true,
-  get: function () { return chunkK3SONK25_cjs.randomInt; }
+  get: function () { return chunkHKJZ7K2K_cjs.randomInt; }
 });
 Object.defineProperty(exports, "randomIntByLength", {
   enumerable: true,
-  get: function () { return chunkK3SONK25_cjs.randomIntByLength; }
+  get: function () { return chunkHKJZ7K2K_cjs.randomIntByLength; }
 });
 Object.defineProperty(exports, "randomStr", {
   enumerable: true,
-  get: function () { return chunkK3SONK25_cjs.randomStr; }
+  get: function () { return chunkHKJZ7K2K_cjs.randomStr; }
+});
+Object.defineProperty(exports, "randomUUID", {
+  enumerable: true,
+  get: function () { return chunkHKJZ7K2K_cjs.randomUUID; }
 });
 Object.defineProperty(exports, "noop", {
   enumerable: true,