@rzl-zone/utils-js 3.7.1 → 3.9.0

package/dist/chunk-ZTHJQJ5F.cjs

@@ -0,0 +1,211 @@
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.9.0.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+'use strict';
+
+var chunkWKM6UVMG_cjs = require('./chunk-WKM6UVMG.cjs');
+var chunk7C7TQC5J_cjs = require('./chunk-7C7TQC5J.cjs');
+
+var maxInt = 2147483647;
+var base = 36;
+var tMin = 1;
+var tMax = 26;
+var skew = 38;
+var damp = 700;
+var initialBias = 72;
+var initialN = 128;
+var delimiter = "-";
+var regexPunycode = /^xn--/;
+var regexNonASCII = /[^\0-\x7F]/;
+var regexSeparators = /[\x2E\u3002\uFF0E\uFF61]/g;
+var errors = {
+  overflow: "Overflow: input needs wider integers to process",
+  "not-basic": "Illegal input >= 0x80 (not a basic code point)",
+  "invalid-input": "Invalid input"
+};
+var floor = Math.floor;
+var stringFromCharCode = String.fromCharCode;
+function error(type) {
+  throw new RangeError(errors[type]);
+}
+function map(array, fn) {
+  const result = [];
+  let length = array.length;
+  while (length--) result[length] = fn(array[length]);
+  return result;
+}
+function mapDomain(domain, fn) {
+  const parts = domain.split("@");
+  let result = "";
+  if (parts.length > 1) {
+    result = parts[0] + "@";
+    domain = parts[1];
+  }
+  domain = domain.replace(regexSeparators, ".");
+  const labels = domain.split(".");
+  return result + map(labels, fn).join(".");
+}
+function ucs2decode(input) {
+  chunkWKM6UVMG_cjs.assertIsString(input, {
+    message: ({ currentType, validType }) => `Utils \`punycodeUtilsJS.ucs2.decode\`, parameter \`input\` must be of type \`${validType}\`, but received: \`${currentType}\`.`
+  });
+  const output = [];
+  let counter = 0;
+  const length = input.length;
+  while (counter < length) {
+    const value = input.charCodeAt(counter++);
+    if (value >= 55296 && value <= 56319 && counter < length) {
+      const extra = input.charCodeAt(counter++);
+      if ((extra & 64512) === 56320)
+        output.push(((value & 1023) << 10) + (extra & 1023) + 65536);
+      else {
+        output.push(value);
+        counter--;
+      }
+    } else output.push(value);
+  }
+  return output;
+}
+var ucs2encode = (points) => {
+  if (!Array.isArray(points) || !points.every((p) => typeof p === "number" && Number.isFinite(p))) {
+    throw new TypeError(
+      `Utils \`punycodeUtilsJS.ucs2.encode\`, parameter \`points\` must be an array of numbers, but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
+        points
+      )}\`.`
+    );
+  }
+  return String.fromCodePoint(...points);
+};
+function basicToDigit(codePoint) {
+  if (codePoint >= 48 && codePoint < 58) return 26 + (codePoint - 48);
+  if (codePoint >= 65 && codePoint < 91) return codePoint - 65;
+  if (codePoint >= 97 && codePoint < 123) return codePoint - 97;
+  return base;
+}
+function digitToBasic(digit, flag) {
+  return digit + 22 + 75 * (digit < 26 ? 1 : 0) - Number(flag !== 0) * 32;
+}
+function adapt(delta, numPoints, firstTime) {
+  let k = 0;
+  delta = firstTime ? floor(delta / damp) : delta >> 1;
+  delta += floor(delta / numPoints);
+  while (delta > (base - tMin) * tMax >> 1) {
+    delta = floor(delta / (base - tMin));
+    k += base;
+  }
+  return floor(k + (base - tMin + 1) * delta / (delta + skew));
+}
+function decode(input) {
+  chunkWKM6UVMG_cjs.assertIsString(input, {
+    message: ({ currentType, validType }) => `Utils \`punycodeUtilsJS.decode\`, parameter \`input\` must be of type \`${validType}\`, but received: \`${currentType}\`.`
+  });
+  const output = [];
+  const inputLength = input.length;
+  let i = 0, n = initialN, bias = initialBias;
+  let basic = input.lastIndexOf(delimiter);
+  if (basic < 0) basic = 0;
+  for (let j = 0; j < basic; j++) {
+    if (input.charCodeAt(j) >= 128) error("not-basic");
+    output.push(input.charCodeAt(j));
+  }
+  for (let index = basic > 0 ? basic + 1 : 0; index < inputLength; ) {
+    const oldi = i;
+    let w = 1;
+    for (let k = base; ; k += base) {
+      if (index >= inputLength) error("invalid-input");
+      const digit = basicToDigit(input.charCodeAt(index++));
+      if (digit >= base) error("invalid-input");
+      if (digit > floor((maxInt - i) / w)) error("overflow");
+      i += digit * w;
+      const t = k <= bias ? tMin : k >= bias + tMax ? tMax : k - bias;
+      if (digit < t) break;
+      const baseMinusT = base - t;
+      if (w > floor(maxInt / baseMinusT)) error("overflow");
+      w *= baseMinusT;
+    }
+    const out = output.length + 1;
+    bias = adapt(i - oldi, out, oldi === 0);
+    if (floor(i / out) > maxInt - n) error("overflow");
+    n += floor(i / out);
+    i %= out;
+    output.splice(i++, 0, n);
+  }
+  return String.fromCodePoint(...output);
+}
+function encode(input) {
+  chunkWKM6UVMG_cjs.assertIsString(input, {
+    message: ({ currentType, validType }) => `Utils \`punycodeUtilsJS.encode\`, parameter \`input\` must be of type \`${validType}\`, but received: \`${currentType}\`.`
+  });
+  const output = [];
+  const points = ucs2decode(input);
+  const inputLength = points.length;
+  let n = initialN, delta = 0, bias = initialBias;
+  for (const cp of points) if (cp < 128) output.push(stringFromCharCode(cp));
+  const basicLength = output.length;
+  let handledCPCount = basicLength;
+  if (basicLength) output.push(delimiter);
+  while (handledCPCount < inputLength) {
+    let m = maxInt;
+    for (const cp of points) if (cp >= n && cp < m) m = cp;
+    const handledCPCountPlusOne = handledCPCount + 1;
+    if (m - n > floor((maxInt - delta) / handledCPCountPlusOne)) error("overflow");
+    delta += (m - n) * handledCPCountPlusOne;
+    n = m;
+    for (const cp of points) {
+      if (cp < n) delta++;
+      if (cp === n) {
+        let q = delta;
+        for (let k = base; ; k += base) {
+          const t = k <= bias ? tMin : k >= bias + tMax ? tMax : k - bias;
+          if (q < t) break;
+          output.push(stringFromCharCode(digitToBasic(t + (q - t) % (base - t), 0)));
+          q = floor((q - t) / (base - t));
+        }
+        output.push(stringFromCharCode(digitToBasic(q, 0)));
+        bias = adapt(delta, handledCPCountPlusOne, handledCPCount === basicLength);
+        delta = 0;
+        handledCPCount++;
+      }
+    }
+    delta++;
+    n++;
+  }
+  return output.join("");
+}
+function toUnicode(input) {
+  chunkWKM6UVMG_cjs.assertIsString(input, {
+    message: ({ currentType, validType }) => `Utils \`punycodeUtilsJS.toUnicode\`, parameter \`input\` must be of type \`${validType}\`, but received: \`${currentType}\`.`
+  });
+  return mapDomain(
+    input,
+    (str) => regexPunycode.test(str) ? decode(str.slice(4).toLowerCase()) : str
+  );
+}
+function toASCII(input) {
+  chunkWKM6UVMG_cjs.assertIsString(input, {
+    message: ({ currentType, validType }) => `Utils \`punycodeUtilsJS.toASCII\`, parameter \`input\` must be of type \`${validType}\`, but received: \`${currentType}\`.`
+  });
+  return mapDomain(
+    input,
+    (str) => regexNonASCII.test(str) ? "xn--" + encode(str) : str
+  );
+}
+var punycodeUtilsJS = {
+  version: "1.0.0",
+  ucs2: {
+    decode: ucs2decode,
+    encode: ucs2encode
+  },
+  decode,
+  encode,
+  toASCII,
+  toUnicode
+};
+
+exports.punycodeUtilsJS = punycodeUtilsJS;

package/dist/conversions/index.cjs

@@ -2,103 +2,103 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunkKTQLDIIT_cjs = require('../chunk-KTQLDIIT.cjs');
-require('../chunk-TFDXRT6D.cjs');
-var chunkAKKM6MOX_cjs = require('../chunk-AKKM6MOX.cjs');
-require('../chunk-UKAUXY2U.cjs');
-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');
-require('../chunk-7QQV66RX.cjs');
-require('../chunk-ATLFMKAF.cjs');
-require('../chunk-7WBMA2VE.cjs');
+var chunkJI57K7D4_cjs = require('../chunk-JI57K7D4.cjs');
+require('../chunk-ALRISPTL.cjs');
+var chunkI33PB44Q_cjs = require('../chunk-I33PB44Q.cjs');
+require('../chunk-MMRHKYT6.cjs');
+var chunk2XGQQZ6A_cjs = require('../chunk-2XGQQZ6A.cjs');
+require('../chunk-PWKOFPAH.cjs');
+require('../chunk-FWWPEL7J.cjs');
+require('../chunk-WKM6UVMG.cjs');
+var chunkKUVRZ2JW_cjs = require('../chunk-KUVRZ2JW.cjs');
+require('../chunk-TJ5OY6MC.cjs');
+require('../chunk-NAOVH4OH.cjs');
+require('../chunk-OYFUBKEG.cjs');
 require('../chunk-BAV5T2E3.cjs');
-var chunkYC7AK3KX_cjs = require('../chunk-YC7AK3KX.cjs');
+var chunkH44QVAZL_cjs = require('../chunk-H44QVAZL.cjs');
 require('../chunk-UDA26MCU.cjs');
-require('../chunk-F3WBQKRI.cjs');
+require('../chunk-7C7TQC5J.cjs');
 
 Object.defineProperty(exports, "convertType", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.convertType; }
+  get: function () { return chunkJI57K7D4_cjs.convertType; }
 });
 Object.defineProperty(exports, "dedupeArray", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.dedupeArray; }
+  get: function () { return chunkJI57K7D4_cjs.dedupeArray; }
 });
 Object.defineProperty(exports, "removeObjectPaths", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.removeObjectPaths; }
+  get: function () { return chunkJI57K7D4_cjs.removeObjectPaths; }
 });
 Object.defineProperty(exports, "toBooleanContent", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.toBooleanContent; }
+  get: function () { return chunkJI57K7D4_cjs.toBooleanContent; }
 });
 Object.defineProperty(exports, "toBooleanContentDeep", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.toBooleanContentDeep; }
+  get: function () { return chunkJI57K7D4_cjs.toBooleanContentDeep; }
 });
 Object.defineProperty(exports, "toBooleanExplicit", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.toBooleanExplicit; }
+  get: function () { return chunkJI57K7D4_cjs.toBooleanExplicit; }
 });
 Object.defineProperty(exports, "toBooleanLoose", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.toBooleanLoose; }
+  get: function () { return chunkJI57K7D4_cjs.toBooleanLoose; }
 });
 Object.defineProperty(exports, "toNumberArrayUnRecursive", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.toNumberArrayUnRecursive; }
+  get: function () { return chunkJI57K7D4_cjs.toNumberArrayUnRecursive; }
 });
 Object.defineProperty(exports, "toNumberDeep", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.toNumberDeep; }
+  get: function () { return chunkJI57K7D4_cjs.toNumberDeep; }
 });
 Object.defineProperty(exports, "toStringDeep", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.toStringDeep; }
+  get: function () { return chunkJI57K7D4_cjs.toStringDeep; }
 });
 Object.defineProperty(exports, "toStringDeepForce", {
   enumerable: true,
-  get: function () { return chunkKTQLDIIT_cjs.toStringDeepForce; }
+  get: function () { return chunkJI57K7D4_cjs.toStringDeepForce; }
 });
 Object.defineProperty(exports, "filterNilArray", {
   enumerable: true,
-  get: function () { return chunkAKKM6MOX_cjs.filterNilArray; }
+  get: function () { return chunkI33PB44Q_cjs.filterNilArray; }
 });
 Object.defineProperty(exports, "toStringArrayUnRecursive", {
   enumerable: true,
-  get: function () { return chunkAKKM6MOX_cjs.toStringArrayUnRecursive; }
+  get: function () { return chunkI33PB44Q_cjs.toStringArrayUnRecursive; }
 });
 Object.defineProperty(exports, "parseCurrencyString", {
   enumerable: true,
-  get: function () { return chunkEK7FSI7F_cjs.parseCurrencyString; }
+  get: function () { return chunk2XGQQZ6A_cjs.parseCurrencyString; }
 });
 Object.defineProperty(exports, "cleanParsedData", {
   enumerable: true,
-  get: function () { return chunk66WLOZOD_cjs.cleanParsedData; }
+  get: function () { return chunkKUVRZ2JW_cjs.cleanParsedData; }
 });
 Object.defineProperty(exports, "extractDigits", {
   enumerable: true,
-  get: function () { return chunk66WLOZOD_cjs.extractDigits; }
+  get: function () { return chunkKUVRZ2JW_cjs.extractDigits; }
 });
 Object.defineProperty(exports, "parseCustomDate", {
   enumerable: true,
-  get: function () { return chunk66WLOZOD_cjs.parseCustomDate; }
+  get: function () { return chunkKUVRZ2JW_cjs.parseCustomDate; }
 });
 Object.defineProperty(exports, "safeJsonParse", {
   enumerable: true,
-  get: function () { return chunk66WLOZOD_cjs.safeJsonParse; }
+  get: function () { return chunkKUVRZ2JW_cjs.safeJsonParse; }
 });
 Object.defineProperty(exports, "safeStableStringify", {
   enumerable: true,
-  get: function () { return chunkYC7AK3KX_cjs.safeStableStringify; }
+  get: function () { return chunkH44QVAZL_cjs.safeStableStringify; }
 });

package/dist/conversions/index.d.ts

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.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,24 +2,24 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.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';
-import '../chunk-ZN53RM3R.js';
-export { filterNilArray, toStringArrayUnRecursive } from '../chunk-TDYGYHSH.js';
-import '../chunk-PZQC3FZY.js';
-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';
-import '../chunk-SZJ7OI4S.js';
-import '../chunk-VCVND6CH.js';
-import '../chunk-6WMB5AJR.js';
+export { convertType, dedupeArray, removeObjectPaths, toBooleanContent, toBooleanContentDeep, toBooleanExplicit, toBooleanLoose, toNumberArrayUnRecursive, toNumberDeep, toStringDeep, toStringDeepForce } from '../chunk-VBSLIIDB.js';
+import '../chunk-WRGN6UBK.js';
+export { filterNilArray, toStringArrayUnRecursive } from '../chunk-SN5HAK3Y.js';
+import '../chunk-44X74C26.js';
+export { parseCurrencyString } from '../chunk-EJV5AF4L.js';
+import '../chunk-MZ3T6L7Z.js';
+import '../chunk-5O66AUEC.js';
+import '../chunk-OSSFLQDD.js';
+export { cleanParsedData, extractDigits, parseCustomDate, safeJsonParse } from '../chunk-DXPM4NOU.js';
+import '../chunk-J6VLFVIL.js';
+import '../chunk-M5QB2GM5.js';
+import '../chunk-TXOVQZPU.js';
 import '../chunk-YWHHVDT4.js';
-export { safeStableStringify } from '../chunk-2VO2CBTU.js';
+export { safeStableStringify } from '../chunk-X6ULJZ3X.js';
 import '../chunk-QNKGP5DY.js';
-import '../chunk-3KTD3QDI.js';
+import '../chunk-J4TT33ZX.js';

package/dist/events/index.cjs

@@ -2,31 +2,31 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunkYGB2BQPB_cjs = require('../chunk-YGB2BQPB.cjs');
+var chunkYVRUY4EW_cjs = require('../chunk-YVRUY4EW.cjs');
 require('../chunk-VJDDGRIK.cjs');
-require('../chunk-K63WO3XA.cjs');
-require('../chunk-F3WBQKRI.cjs');
+require('../chunk-WKM6UVMG.cjs');
+require('../chunk-7C7TQC5J.cjs');
 
 Object.defineProperty(exports, "disableUserInteraction", {
   enumerable: true,
-  get: function () { return chunkYGB2BQPB_cjs.disableUserInteraction; }
+  get: function () { return chunkYVRUY4EW_cjs.disableUserInteraction; }
 });
 Object.defineProperty(exports, "enableUserInteraction", {
   enumerable: true,
-  get: function () { return chunkYGB2BQPB_cjs.enableUserInteraction; }
+  get: function () { return chunkYVRUY4EW_cjs.enableUserInteraction; }
 });
 Object.defineProperty(exports, "removeElementFocus", {
   enumerable: true,
-  get: function () { return chunkYGB2BQPB_cjs.removeElementFocus; }
+  get: function () { return chunkYVRUY4EW_cjs.removeElementFocus; }
 });
 Object.defineProperty(exports, "scrollToTop", {
   enumerable: true,
-  get: function () { return chunkYGB2BQPB_cjs.scrollToTop; }
+  get: function () { return chunkYVRUY4EW_cjs.scrollToTop; }
 });

package/dist/events/index.d.ts

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.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,12 +2,12 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-export { disableUserInteraction, enableUserInteraction, removeElementFocus, scrollToTop } from '../chunk-4ZOXSUXB.js';
+export { disableUserInteraction, enableUserInteraction, removeElementFocus, scrollToTop } from '../chunk-C7GC2PFX.js';
 import '../chunk-L5RDAVVH.js';
-import '../chunk-FI76UZRF.js';
-import '../chunk-3KTD3QDI.js';
+import '../chunk-OSSFLQDD.js';
+import '../chunk-J4TT33ZX.js';