@rzl-zone/utils-js 3.12.1-beta.0 → 3.13.0-beta.2

package/dist/promises/index.d.ts

@@ -2,7 +2,7 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
@@ -10,114 +10,114 @@
 
 import { CustomPromiseType } from "@rzl-zone/ts-types-plus";
 /** -------------------------------------------------------------
- * * ***Utility Class: `CustomPromise`.***
- * -------------------------------------------------------------
- * **A strongly typed extension of the native {@link Promise | **`Promise`**}.**
- *  1. **Behaves exactly like a normal Promise** for `then`/`catch`
- *      and `await` semantics.
- *  2. **Stores the final resolution or rejection internally** so
- *      it can be retrieved by a custom `finish` handler.
- *  3. **Adds a `finish` method** which runs once after settlement
- *      with access to both the fulfilled value *and* the rejection
- *      reason (only one will be defined).
- * - **Key Differences from a Native `Promise`:**
- *    - Every call to `then`/`catch` returns **`CustomPromise`**
- *      again, so the `finish` method remains available on the
- *      entire chain.
- *    - `finish` provides a tuple-like callback:
- *      - `val`  → defined when fulfilled.
- *      - `err`  → defined when rejected.
- * @template Success  Type of the resolved value.
- * @template Error    Type of the rejection reason (default `unknown`).
- * @example
- * ```ts
- * import { CustomPromise, type CustomPromiseType } from "@rzl-zone/utils-js/promises";
- *
- * type User = { id: number; name: string };
- * type ApiError = { message: string };
- *
- * function fetchUser(): CustomPromiseType<User, ApiError> {
- *   return new CustomPromise<User, ApiError>((resolve, reject) => {
- *     setTimeout(
- *       () =>
- *         void (Math.random() > 0.5
- *           ? resolve({ id: 1, name: "Alice" })
- *           : reject({ message: "Random failure" })),
- *       500
- *     );
- *   });
- * }
- *
- * fetchUser()
- *   .then(user => {
- *      console.log("SUCCESS:", user);
- *      return user;
- *    })
- *   .catch(err => {
- *      console.error("ERROR:", err);
- *      throw err;
- *    })
- *   .finish((val, err) => {
- *     // Runs once after settle, regardless of outcome
- *     console.log("FINISH:", { val, err });
- *   });
- * ```
- * ---
- * - **Implementation Notes:**
- *    - Uses `Object.setPrototypeOf` to preserve the prototype chain
- *      for environments targeting ES5 or when subclassing Promise.
- *    - Internal `_value` and `_error` are updated as soon as the
- *      executor resolves or rejects, guaranteeing `finish` receives
- *      the final state even when added after settlement.
- */
+* * ***Utility Class: `CustomPromise`.***
+* -------------------------------------------------------------
+* **A strongly typed extension of the native {@link Promise | **`Promise`**}.**
+*  1. **Behaves exactly like a normal Promise** for `then`/`catch`
+*      and `await` semantics.
+*  2. **Stores the final resolution or rejection internally** so
+*      it can be retrieved by a custom `finish` handler.
+*  3. **Adds a `finish` method** which runs once after settlement
+*      with access to both the fulfilled value *and* the rejection
+*      reason (only one will be defined).
+* - **Key Differences from a Native `Promise`:**
+*    - Every call to `then`/`catch` returns **`CustomPromise`**
+*      again, so the `finish` method remains available on the
+*      entire chain.
+*    - `finish` provides a tuple-like callback:
+*      - `val`  → defined when fulfilled.
+*      - `err`  → defined when rejected.
+* @template Success  Type of the resolved value.
+* @template Error    Type of the rejection reason (default `unknown`).
+* @example
+* ```ts
+* import { CustomPromise, type CustomPromiseType } from "@rzl-zone/utils-js/promises";
+*
+* type User = { id: number; name: string };
+* type ApiError = { message: string };
+*
+* function fetchUser(): CustomPromiseType<User, ApiError> {
+*   return new CustomPromise<User, ApiError>((resolve, reject) => {
+*     setTimeout(
+*       () =>
+*         void (Math.random() > 0.5
+*           ? resolve({ id: 1, name: "Alice" })
+*           : reject({ message: "Random failure" })),
+*       500
+*     );
+*   });
+* }
+*
+* fetchUser()
+*   .then(user => {
+*      console.log("SUCCESS:", user);
+*      return user;
+*    })
+*   .catch(err => {
+*      console.error("ERROR:", err);
+*      throw err;
+*    })
+*   .finish((val, err) => {
+*     // Runs once after settle, regardless of outcome
+*     console.log("FINISH:", { val, err });
+*   });
+* ```
+* ---
+* - **Implementation Notes:**
+*    - Uses `Object.setPrototypeOf` to preserve the prototype chain
+*      for environments targeting ES5 or when subclassing Promise.
+*    - Internal `_value` and `_error` are updated as soon as the
+*      executor resolves or rejects, guaranteeing `finish` receives
+*      the final state even when added after settlement.
+*/
 declare class CustomPromise<Success, Error = unknown> extends Promise<Success> implements CustomPromiseType<Success, Error> {
   private _value?;
   private _error?;
   private _finish;
   constructor(executor: (resolve: (v: Success) => void, reject: (e: Error) => void) => void);
-  then<TResult1 = Success, TResult2 = never>(onfulfilled?: ((value: Success) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: Error) => TResult2 | PromiseLike<TResult2>) | null): CustomPromise<TResult1 | TResult2, Error>;
-  catch<TResult = never>(onrejected?: ((reason: Error) => TResult | PromiseLike<TResult>) | null): CustomPromise<Success | TResult, Error>;
+  override then<TResult1 = Success, TResult2 = never>(onfulfilled?: ((value: Success) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: Error) => TResult2 | PromiseLike<TResult2>) | null): CustomPromise<TResult1 | TResult2, Error>;
+  override catch<TResult = never>(onrejected?: ((reason: Error) => TResult | PromiseLike<TResult>) | null): CustomPromise<Success | TResult, Error>;
   /**
-   * Registers a callback to be invoked **exactly once** when the
-   * promise settles, with access to both the resolved value and
-   * the rejection reason.
-   *
-   * If the promise is already settled when `finish` is called,
-   * the callback executes immediately on the same tick.
-   *
-   * @param cb Callback receiving the final `(value, error)`.
-   * @returns `this` for fluent chaining.
-   */
+  * Registers a callback to be invoked **exactly once** when the
+  * promise settles, with access to both the resolved value and
+  * the rejection reason.
+  *
+  * If the promise is already settled when `finish` is called,
+  * the callback executes immediately on the same tick.
+  *
+  * @param cb Callback receiving the final `(value, error)`.
+  * @returns `this` for fluent chaining.
+  */
   finish(cb: (val?: Success, err?: Error) => void): this;
 }
 /** ------------------------------------------------------------
- * * ***Utility: `delay`.***
- * ------------------------------------------------------------
- * **Creates a Promise-based delay that resolves after a given number
- * of milliseconds, optionally supports cancellation with `AbortSignal`.**
- * - **Behavior:**
- *    - Validates `milliSeconds` is a non-zero, non-negative integer.
- *    - Validates `signal` is an `AbortSignal` instance when provided.
- *    - Cleans up event listeners and timers properly.
- * @param {number} [milliSeconds=1000]
- *  The duration of the delay in milliseconds, default is `1000`.
- * @param {AbortSignal} [signal]
- *  An optional `AbortSignal` that can cancel the delay.
- * @returns {Promise<void>}
- *  A promise that resolves after the specified delay or
- *  rejects with an `AbortError` if aborted.
- * @throws **{@link TypeError | `TypeError`}** while validates `milliSeconds` and `signal`:
- *  - If `milliSeconds` **is not a valid** an `integer-number`, `NaN`, `negative-number`, or `≤ 0`.
- *  - If `signal` **is not a valid** an`AbortSignal`.
- * @throws **{@link DOMException | `DOMException`}** if the delay is aborted using the signal, rejects with `AbortError`.
- * @example
- * // Waits for 2 seconds
- * await delay(2000);
- *
- * // Delay with AbortSignal
- * const controller = new AbortController();
- * delay(5000, controller.signal).catch(err => console.log(err.name)); // "AbortError"
- * controller.abort();
- */
+* * ***Utility: `delay`.***
+* ------------------------------------------------------------
+* **Creates a Promise-based delay that resolves after a given number
+* of milliseconds, optionally supports cancellation with `AbortSignal`.**
+* - **Behavior:**
+*    - Validates `milliSeconds` is a non-zero, non-negative integer.
+*    - Validates `signal` is an `AbortSignal` instance when provided.
+*    - Cleans up event listeners and timers properly.
+* @param {number} [milliSeconds=1000]
+*  The duration of the delay in milliseconds, default is `1000`.
+* @param {AbortSignal} [signal]
+*  An optional `AbortSignal` that can cancel the delay.
+* @returns {Promise<void>}
+*  A promise that resolves after the specified delay or
+*  rejects with an `AbortError` if aborted.
+* @throws **{@link TypeError | `TypeError`}** while validates `milliSeconds` and `signal`:
+*  - If `milliSeconds` **is not a valid** an `integer-number`, `NaN`, `negative-number`, or `≤ 0`.
+*  - If `signal` **is not a valid** an`AbortSignal`.
+* @throws **{@link DOMException | `DOMException`}** if the delay is aborted using the signal, rejects with `AbortError`.
+* @example
+* // Waits for 2 seconds
+* await delay(2000);
+*
+* // Delay with AbortSignal
+* const controller = new AbortController();
+* delay(5000, controller.signal).catch(err => console.log(err.name)); // "AbortError"
+* controller.abort();
+*/
 declare const delay: (milliSeconds?: number, signal?: AbortSignal) => Promise<void>;
 export { CustomPromise, type CustomPromiseType, delay };

package/dist/promises/index.js

@@ -2,14 +2,14 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { E as isNull, r as getPreciseType } from "../assertIsBoolean-BlBct0Fc.js";
-import { t as safeStableStringify } from "../safeStableStringify-BNh3D0K0.js";
-import { t as isInteger } from "../isInteger-DS9V7l_f.js";
+import { E as isNull, r as getPreciseType } from "../assertIsBoolean-Bv6gL-xe.js";
+import { t as safeStableStringify } from "../safeStableStringify-BrOcdX9n.js";
+import { t as isInteger } from "../isInteger-DZ163OQg.js";
 var CustomPromise = class extends Promise {
 	_value;
 	_error;

package/dist/{punyCode-hmiFzLWT.js → punyCode-BeFYDjj0.js}

@@ -2,13 +2,13 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { r as getPreciseType } from "./assertIsBoolean-BlBct0Fc.js";
-import { t as assertIsString } from "./assertIsString-DqV9NwbI.js";
+import { r as getPreciseType } from "./assertIsBoolean-Bv6gL-xe.js";
+import { t as assertIsString } from "./assertIsString-1WiUjgqf.js";
 const maxInt = 2147483647;
 const base = 36, tMin = 1, tMax = 26, skew = 38, damp = 700;
 const initialBias = 72, initialN = 128, delimiter = "-";
@@ -28,7 +28,7 @@ function error(type) {
 function map(array, fn) {
 	const result = [];
 	let length = array.length;
-	while (length--) result[length] = fn(array[length]);
+	while (length--) if (array[length]) result[length] = fn(array[length]);
 	return result;
 }
 function mapDomain(domain, fn) {
@@ -36,7 +36,7 @@ function mapDomain(domain, fn) {
 	let result = "";
 	if (parts.length > 1) {
 		result = parts[0] + "@";
-		domain = parts[1];
+		if (parts[1]) domain = parts[1];
 	}
 	domain = domain.replace(regexSeparators, ".");
 	const labels = domain.split(".");
@@ -176,4 +176,4 @@ const punycodeUtilsJS = {
 	toUnicode
 };
 export { punycodeUtilsJS as t };
-//# sourceMappingURL=punyCode-hmiFzLWT.js.map
+//# sourceMappingURL=punyCode-BeFYDjj0.js.map

package/dist/punyCode-BeFYDjj0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"punyCode-BeFYDjj0.js","names":[],"sources":["../src/urls/utils/punyCode.ts"],"sourcesContent":["/** ---------------------------------------------------------\n * * ***Constants for `Punycode-UtilsJS` algorithm.***\n * ---------------------------------------------------------\n * These constants are used internally for encoding and decoding.\n *\n * Unicode domain names to ASCII (`Punycode-UtilsJS`) and vice versa.\n */\n\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { assertIsString } from \"@/assertions/strings/assertIsString\";\n\n/**\n * Constant `maxInt` for validate.\n */\nconst maxInt = 2147483647;\n\n/**\n * Bootstring parameters for `Punycode-UtilsJS`.\n */\nconst base = 36,\n  tMin = 1,\n  tMax = 26,\n  skew = 38,\n  damp = 700;\n\n/**\n * Initial bias and code point.\n */\nconst initialBias = 72,\n  initialN = 128,\n  delimiter = \"-\";\n\n/**\n * Regular expressions used internally.\n * Matches `Punycode-UtilsJS` prefix.\n */\nconst regexPunycode = /^xn--/;\n/**\n * Regular expressions used internally.\n * Matches non-ASCII chars.\n */\nconst regexNonASCII = /[^\\0-\\x7F]/;\n/**\n * Regular expressions used internally.\n * Matches domain label separators.\n */\nconst regexSeparators = /[\\x2E\\u3002\\uFF0E\\uFF61]/g;\n\n/**\n * Error messages used internally.\n */\nconst errors: Record<string, string> = {\n  overflow: \"Overflow: input needs wider integers to process\",\n  \"not-basic\": \"Illegal input >= 0x80 (not a basic code point)\",\n  \"invalid-input\": \"Invalid input\"\n};\n\n/**\n * Aliases of `Math.floor`.\n */\nconst floor = Math.floor;\n/** \n * Aliases of `String.fromCharCode`.\n\n*/\nconst stringFromCharCode = String.fromCharCode;\n\n/** ---------------------------------------------------------\n * * ***Throws a RangeError with a predefined error message.***\n * ---------------------------------------------------------\n *\n * @param type - Key of the error type to throw.\n */\nfunction error(type: keyof typeof errors): never {\n  throw new RangeError(errors[type]);\n}\n\n/** ---------------------------------------------------------\n * * ***Maps an array using a callback function.***\n * ---------------------------------------------------------\n *\n * @param array - Array to transform.\n * @param fn - Function to apply to each element.\n * @returns Transformed array.\n */\nfunction map<T, U>(array: T[], fn: (v: T) => U): U[] {\n  const result: U[] = [];\n  let length = array.length;\n  while (length--) {\n    if (array[length]) {\n      result[length] = fn(array[length]!);\n    }\n  }\n  return result;\n}\n\n/** ---------------------------------------------------------\n * * ***Maps a domain name using a callback on each label.***\n * ---------------------------------------------------------\n *\n * Handles email-like domains (local@domain).\n * @param domain - Domain string to process.\n * @param fn - Function applied to each domain label.\n * @returns Transformed domain string.\n */\nfunction mapDomain(domain: string, fn: (v: string) => string): string {\n  const parts = domain.split(\"@\");\n  let result = \"\";\n  if (parts.length > 1) {\n    result = parts[0] + \"@\";\n    if (parts[1]) domain = parts[1];\n  }\n  domain = domain.replace(regexSeparators, \"\\x2E\");\n  const labels = domain.split(\".\");\n  return result + map(labels, fn).join(\".\");\n}\n\n/** ---------------------------------------------------------\n * * ***Converts a UCS-2 encoded string to an array of Unicode code points.***\n * ---------------------------------------------------------\n *\n * @param input - String to decode.\n * @returns Array of Unicode code points.\n */\nfunction ucs2decode(input: string): number[] {\n  assertIsString(input, {\n    message: ({ currentType, validType }) =>\n      `Utils \\`punycodeUtilsJS.ucs2.decode\\`, parameter \\`input\\` must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const output: number[] = [];\n  let counter = 0;\n  const length = input.length;\n  while (counter < length) {\n    const value = input.charCodeAt(counter++);\n    if (value >= 0xd800 && value <= 0xdbff && counter < length) {\n      const extra = input.charCodeAt(counter++);\n      if ((extra & 0xfc00) === 0xdc00)\n        output.push(((value & 0x3ff) << 10) + (extra & 0x3ff) + 0x10000);\n      else {\n        output.push(value);\n        counter--;\n      }\n    } else output.push(value);\n  }\n  return output;\n}\n\n/** ---------------------------------------------------------\n * * ***Encodes an array of Unicode code points to a string.***\n * ---------------------------------------------------------\n *\n * @param points - Array of Unicode code points.\n * @returns Encoded string.\n */\nconst ucs2encode = (points: number[]): string => {\n  if (\n    !Array.isArray(points) ||\n    !points.every((p) => typeof p === \"number\" && Number.isFinite(p))\n  ) {\n    throw new TypeError(\n      `Utils \\`punycodeUtilsJS.ucs2.encode\\`, parameter \\`points\\` must be an array of numbers, but received: \\`${getPreciseType(\n        points\n      )}\\`.`\n    );\n  }\n\n  return String.fromCodePoint(...points);\n};\n\n/** ---------------------------------------------------------\n * * ***Converts a basic code point to its digit value for `Punycode-UtilsJS`.***\n * ---------------------------------------------------------\n *\n * @param codePoint - Unicode code point.\n * @returns Digit value.\n */\nfunction basicToDigit(codePoint: number): number {\n  if (codePoint >= 0x30 && codePoint < 0x3a) return 26 + (codePoint - 0x30);\n  if (codePoint >= 0x41 && codePoint < 0x5b) return codePoint - 0x41;\n  if (codePoint >= 0x61 && codePoint < 0x7b) return codePoint - 0x61;\n  return base;\n}\n\n/** ---------------------------------------------------------\n * * ***Converts a digit to a basic code point for `Punycode-UtilsJS`.***\n * ---------------------------------------------------------\n *\n * @param digit - Numeric value.\n * @param flag - Bias flag (0 or 1).\n * @returns Code point.\n */\nfunction digitToBasic(digit: number, flag: number): number {\n  return digit + 22 + 75 * (digit < 26 ? 1 : 0) - Number(flag !== 0) * 32;\n}\n\n/** ---------------------------------------------------------\n * * ***Bias adaptation function for `Punycode-UtilsJS` encoding/decoding.***\n * ---------------------------------------------------------\n *\n * @param delta - Delta value.\n * @param numPoints - Number of code points.\n * @param firstTime - Indicates first adaptation.\n * @returns Adapted bias.\n */\nfunction adapt(delta: number, numPoints: number, firstTime: boolean): number {\n  let k = 0;\n  delta = firstTime ? floor(delta / damp) : delta >> 1;\n  delta += floor(delta / numPoints);\n  while (delta > ((base - tMin) * tMax) >> 1) {\n    delta = floor(delta / (base - tMin));\n    k += base;\n  }\n  return floor(k + ((base - tMin + 1) * delta) / (delta + skew));\n}\n\n/** ---------------------------------------------------------\n * * ***Decodes a `Punycode-UtilsJS` string to Unicode.***\n * ---------------------------------------------------------\n *\n * @param input - `Punycode-UtilsJS` string.\n * @returns Decoded Unicode string.\n */\nfunction decode(input: string): string {\n  assertIsString(input, {\n    message: ({ currentType, validType }) =>\n      `Utils \\`punycodeUtilsJS.decode\\`, parameter \\`input\\` must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const output: number[] = [];\n  const inputLength = input.length;\n  let i = 0,\n    n = initialN,\n    bias = initialBias;\n\n  let basic = input.lastIndexOf(delimiter);\n  if (basic < 0) basic = 0;\n\n  for (let j = 0; j < basic; j++) {\n    if (input.charCodeAt(j) >= 0x80) error(\"not-basic\");\n    output.push(input.charCodeAt(j));\n  }\n\n  for (let index = basic > 0 ? basic + 1 : 0; index < inputLength; ) {\n    const oldi = i;\n    let w = 1;\n    for (let k = base; ; k += base) {\n      if (index >= inputLength) error(\"invalid-input\");\n      const digit = basicToDigit(input.charCodeAt(index++));\n      if (digit >= base) error(\"invalid-input\");\n      if (digit > floor((maxInt - i) / w)) error(\"overflow\");\n      i += digit * w;\n      const t = k <= bias ? tMin : k >= bias + tMax ? tMax : k - bias;\n      if (digit < t) break;\n      const baseMinusT = base - t;\n      if (w > floor(maxInt / baseMinusT)) error(\"overflow\");\n      w *= baseMinusT;\n    }\n    const out = output.length + 1;\n    bias = adapt(i - oldi, out, oldi === 0);\n    if (floor(i / out) > maxInt - n) error(\"overflow\");\n    n += floor(i / out);\n    i %= out;\n    output.splice(i++, 0, n);\n  }\n  return String.fromCodePoint(...output);\n}\n\n/** ---------------------------------------------------------\n * * ***Encodes a Unicode string to `Punycode-UtilsJS`.***\n * ---------------------------------------------------------\n *\n * @param input - Unicode string.\n * @returns `Punycode-UtilsJS` string.\n */\nfunction encode(input: string): string {\n  assertIsString(input, {\n    message: ({ currentType, validType }) =>\n      `Utils \\`punycodeUtilsJS.encode\\`, parameter \\`input\\` must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const output: string[] = [];\n  const points = ucs2decode(input);\n  const inputLength = points.length;\n  let n = initialN,\n    delta = 0,\n    bias = initialBias;\n\n  for (const cp of points) if (cp < 0x80) output.push(stringFromCharCode(cp));\n  const basicLength = output.length;\n  let handledCPCount = basicLength;\n  if (basicLength) output.push(delimiter);\n\n  while (handledCPCount < inputLength) {\n    let m = maxInt;\n    for (const cp of points) if (cp >= n && cp < m) m = cp;\n\n    const handledCPCountPlusOne = handledCPCount + 1;\n    if (m - n > floor((maxInt - delta) / handledCPCountPlusOne))\n      error(\"overflow\");\n    delta += (m - n) * handledCPCountPlusOne;\n    n = m;\n\n    for (const cp of points) {\n      if (cp < n) delta++;\n      if (cp === n) {\n        let q = delta;\n        for (let k = base; ; k += base) {\n          const t = k <= bias ? tMin : k >= bias + tMax ? tMax : k - bias;\n          if (q < t) break;\n          output.push(\n            stringFromCharCode(digitToBasic(t + ((q - t) % (base - t)), 0))\n          );\n          q = floor((q - t) / (base - t));\n        }\n        output.push(stringFromCharCode(digitToBasic(q, 0)));\n        bias = adapt(\n          delta,\n          handledCPCountPlusOne,\n          handledCPCount === basicLength\n        );\n        delta = 0;\n        handledCPCount++;\n      }\n    }\n    delta++;\n    n++;\n  }\n\n  return output.join(\"\");\n}\n\n/** ---------------------------------------------------------\n * * ***Converts `Punycode-UtilsJS` to Unicode for domain names.***\n * ---------------------------------------------------------\n *\n * @param input - Domain or label.\n * @returns Unicode string.\n */\nfunction toUnicode(input: string): string {\n  assertIsString(input, {\n    message: ({ currentType, validType }) =>\n      `Utils \\`punycodeUtilsJS.toUnicode\\`, parameter \\`input\\` must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  return mapDomain(input, (str) =>\n    regexPunycode.test(str) ? decode(str.slice(4).toLowerCase()) : str\n  );\n}\n\n/** ---------------------------------------------------------\n * * ***Converts Unicode to ASCII (`Punycode-UtilsJS`) for domain names.***\n * ---------------------------------------------------------\n *\n * @param input - Domain or label.\n * @returns ASCII string.\n */\nfunction toASCII(input: string): string {\n  assertIsString(input, {\n    message: ({ currentType, validType }) =>\n      `Utils \\`punycodeUtilsJS.toASCII\\`, parameter \\`input\\` must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  return mapDomain(input, (str) =>\n    regexNonASCII.test(str) ? \"xn--\" + encode(str) : str\n  );\n}\n\ntype PunycodeUtilsJS = {\n  /** ---------------------------------------------------------\n   * * ***Version of the `Punycode-UtilsJS` implementation.***\n   * ---------------------------------------------------------\n   *\n   * @example\n   * console.log(punycodeUtilsJS.version); // \"1.0.0\"\n   */\n  version: string;\n  /** ---------------------------------------------------------\n   * * ***UCS-2 utility functions.***\n   * ---------------------------------------------------------\n   */\n  ucs2: {\n    /** ---------------------------------------------------------\n     * * ***Decodes a UCS-2 encoded string to an array of Unicode code points.***\n     * ---------------------------------------------------------\n     *\n     * @param input - The UCS-2 string to decode.\n     * @returns Array of Unicode code points.\n     * @example\n     * punycodeUtilsJS.ucs2.decode(\"𐍈\");\n     * // ➔ [66376]\n     */\n    decode: (input: string) => number[];\n    /** ---------------------------------------------------------\n     * * ***Encodes an array of Unicode code points to a UCS-2 string.***\n     * ---------------------------------------------------------\n     *\n     * @param points - Array of Unicode code points.\n     * @returns Encoded string.\n     * @example\n     * punycodeUtilsJS.ucs2.encode([66376]);\n     * // ➔ \"𐍈\"\n     */\n    encode: (points: number[]) => string;\n  };\n  /** ---------------------------------------------------------\n   * * ***Decodes a `Punycode-UtilsJS` string to a Unicode string.***\n   * ---------------------------------------------------------\n   *\n   * @param input - The `Punycode-UtilsJS` string to decode.\n   * @returns Decoded Unicode string.\n   * @example\n   * punycodeUtilsJS.decode(\"xn--fsq\");\n   * // ➔ \"ü\"\n   */\n  decode: (input: string) => string;\n  /** ---------------------------------------------------------\n   * * ***Encodes a Unicode string to `Punycode-UtilsJS`.***\n   * ---------------------------------------------------------\n   *\n   * @param input - Unicode string to encode.\n   * @returns `Punycode-UtilsJS` string.\n   * @example\n   * punycodeUtilsJS.encode(\"ü\");\n   * // ➔ \"xn--fsq\"\n   */\n  encode: (input: string) => string;\n  /** ---------------------------------------------------------\n   * * ***Converts a Unicode domain or label to ASCII (`Punycode-UtilsJS`).***\n   * ---------------------------------------------------------\n   *\n   * @param input - Domain or label string.\n   * @returns ASCII string suitable for DNS.\n   * @example\n   * punycodeUtilsJS.toASCII(\"пример.рф\");\n   * // ➔ \"xn--e1afmkfd.xn--p1ai\"\n   */\n  toASCII: (input: string) => string;\n  /** ---------------------------------------------------------\n   * * ***Converts an ASCII (`Punycode-UtilsJS`) domain or label to Unicode.***\n   * ---------------------------------------------------------\n   *\n   * @param input - ASCII string (with xn-- prefix if needed).\n   * @returns Unicode string.\n   * @example\n   * punycodeUtilsJS.toUnicode(\"xn--e1afmkfd.xn--p1ai\");\n   * // ➔ \"пример.рф\"\n   */\n  toUnicode: (input: string) => string;\n};\n\n/** ---------------------------------------------------------\n * * ***`Punycode-UtilsJS` object exposing all API functions and version.***\n * ---------------------------------------------------------\n * Provides encoding and decoding of Unicode domain names to ASCII (`Punycode-UtilsJS`)\n * and vice versa.\n *\n * - Useful for IDN (Internationalized Domain Names) support.\n */\nconst punycodeUtilsJS: PunycodeUtilsJS = {\n  version: \"1.0.0\",\n  ucs2: {\n    decode: ucs2decode,\n    encode: ucs2encode\n  },\n  decode: decode,\n  encode: encode,\n  toASCII: toASCII,\n  toUnicode: toUnicode\n};\n\n/**\n * Export individual functions.\n */\nexport { punycodeUtilsJS };\n"],"mappings":"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"}

package/dist/{punyCode-CTWXVVFo.cjs → punyCode-DmTsB7q_.cjs}

@@ -2,14 +2,14 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 "use strict";
-const require_assertIsBoolean = require('./assertIsBoolean-DozdtbNi.cjs');
-const require_assertIsString = require('./assertIsString-Bvk7bUL7.cjs');
+const require_assertIsBoolean = require('./assertIsBoolean-amRiJHnh.cjs');
+const require_assertIsString = require('./assertIsString-C0b28AU1.cjs');
 const maxInt = 2147483647;
 const base = 36, tMin = 1, tMax = 26, skew = 38, damp = 700;
 const initialBias = 72, initialN = 128, delimiter = "-";
@@ -29,7 +29,7 @@ function error(type) {
 function map(array, fn) {
 	const result = [];
 	let length = array.length;
-	while (length--) result[length] = fn(array[length]);
+	while (length--) if (array[length]) result[length] = fn(array[length]);
 	return result;
 }
 function mapDomain(domain, fn) {
@@ -37,7 +37,7 @@ function mapDomain(domain, fn) {
 	let result = "";
 	if (parts.length > 1) {
 		result = parts[0] + "@";
-		domain = parts[1];
+		if (parts[1]) domain = parts[1];
 	}
 	domain = domain.replace(regexSeparators, ".");
 	const labels = domain.split(".");
@@ -182,4 +182,4 @@ Object.defineProperty(exports, 'punycodeUtilsJS', {
     return punycodeUtilsJS;
   }
 });
-//# sourceMappingURL=punyCode-CTWXVVFo.cjs.map
+//# sourceMappingURL=punyCode-DmTsB7q_.cjs.map

package/dist/punyCode-DmTsB7q_.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"punyCode-DmTsB7q_.cjs","names":["getPreciseType"],"sources":["../src/urls/utils/punyCode.ts"],"sourcesContent":["/** ---------------------------------------------------------\n * * ***Constants for `Punycode-UtilsJS` algorithm.***\n * ---------------------------------------------------------\n * These constants are used internally for encoding and decoding.\n *\n * Unicode domain names to ASCII (`Punycode-UtilsJS`) and vice versa.\n */\n\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { assertIsString } from \"@/assertions/strings/assertIsString\";\n\n/**\n * Constant `maxInt` for validate.\n */\nconst maxInt = 2147483647;\n\n/**\n * Bootstring parameters for `Punycode-UtilsJS`.\n */\nconst base = 36,\n  tMin = 1,\n  tMax = 26,\n  skew = 38,\n  damp = 700;\n\n/**\n * Initial bias and code point.\n */\nconst initialBias = 72,\n  initialN = 128,\n  delimiter = \"-\";\n\n/**\n * Regular expressions used internally.\n * Matches `Punycode-UtilsJS` prefix.\n */\nconst regexPunycode = /^xn--/;\n/**\n * Regular expressions used internally.\n * Matches non-ASCII chars.\n */\nconst regexNonASCII = /[^\\0-\\x7F]/;\n/**\n * Regular expressions used internally.\n * Matches domain label separators.\n */\nconst regexSeparators = /[\\x2E\\u3002\\uFF0E\\uFF61]/g;\n\n/**\n * Error messages used internally.\n */\nconst errors: Record<string, string> = {\n  overflow: \"Overflow: input needs wider integers to process\",\n  \"not-basic\": \"Illegal input >= 0x80 (not a basic code point)\",\n  \"invalid-input\": \"Invalid input\"\n};\n\n/**\n * Aliases of `Math.floor`.\n */\nconst floor = Math.floor;\n/** \n * Aliases of `String.fromCharCode`.\n\n*/\nconst stringFromCharCode = String.fromCharCode;\n\n/** ---------------------------------------------------------\n * * ***Throws a RangeError with a predefined error message.***\n * ---------------------------------------------------------\n *\n * @param type - Key of the error type to throw.\n */\nfunction error(type: keyof typeof errors): never {\n  throw new RangeError(errors[type]);\n}\n\n/** ---------------------------------------------------------\n * * ***Maps an array using a callback function.***\n * ---------------------------------------------------------\n *\n * @param array - Array to transform.\n * @param fn - Function to apply to each element.\n * @returns Transformed array.\n */\nfunction map<T, U>(array: T[], fn: (v: T) => U): U[] {\n  const result: U[] = [];\n  let length = array.length;\n  while (length--) {\n    if (array[length]) {\n      result[length] = fn(array[length]!);\n    }\n  }\n  return result;\n}\n\n/** ---------------------------------------------------------\n * * ***Maps a domain name using a callback on each label.***\n * ---------------------------------------------------------\n *\n * Handles email-like domains (local@domain).\n * @param domain - Domain string to process.\n * @param fn - Function applied to each domain label.\n * @returns Transformed domain string.\n */\nfunction mapDomain(domain: string, fn: (v: string) => string): string {\n  const parts = domain.split(\"@\");\n  let result = \"\";\n  if (parts.length > 1) {\n    result = parts[0] + \"@\";\n    if (parts[1]) domain = parts[1];\n  }\n  domain = domain.replace(regexSeparators, \"\\x2E\");\n  const labels = domain.split(\".\");\n  return result + map(labels, fn).join(\".\");\n}\n\n/** ---------------------------------------------------------\n * * ***Converts a UCS-2 encoded string to an array of Unicode code points.***\n * ---------------------------------------------------------\n *\n * @param input - String to decode.\n * @returns Array of Unicode code points.\n */\nfunction ucs2decode(input: string): number[] {\n  assertIsString(input, {\n    message: ({ currentType, validType }) =>\n      `Utils \\`punycodeUtilsJS.ucs2.decode\\`, parameter \\`input\\` must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const output: number[] = [];\n  let counter = 0;\n  const length = input.length;\n  while (counter < length) {\n    const value = input.charCodeAt(counter++);\n    if (value >= 0xd800 && value <= 0xdbff && counter < length) {\n      const extra = input.charCodeAt(counter++);\n      if ((extra & 0xfc00) === 0xdc00)\n        output.push(((value & 0x3ff) << 10) + (extra & 0x3ff) + 0x10000);\n      else {\n        output.push(value);\n        counter--;\n      }\n    } else output.push(value);\n  }\n  return output;\n}\n\n/** ---------------------------------------------------------\n * * ***Encodes an array of Unicode code points to a string.***\n * ---------------------------------------------------------\n *\n * @param points - Array of Unicode code points.\n * @returns Encoded string.\n */\nconst ucs2encode = (points: number[]): string => {\n  if (\n    !Array.isArray(points) ||\n    !points.every((p) => typeof p === \"number\" && Number.isFinite(p))\n  ) {\n    throw new TypeError(\n      `Utils \\`punycodeUtilsJS.ucs2.encode\\`, parameter \\`points\\` must be an array of numbers, but received: \\`${getPreciseType(\n        points\n      )}\\`.`\n    );\n  }\n\n  return String.fromCodePoint(...points);\n};\n\n/** ---------------------------------------------------------\n * * ***Converts a basic code point to its digit value for `Punycode-UtilsJS`.***\n * ---------------------------------------------------------\n *\n * @param codePoint - Unicode code point.\n * @returns Digit value.\n */\nfunction basicToDigit(codePoint: number): number {\n  if (codePoint >= 0x30 && codePoint < 0x3a) return 26 + (codePoint - 0x30);\n  if (codePoint >= 0x41 && codePoint < 0x5b) return codePoint - 0x41;\n  if (codePoint >= 0x61 && codePoint < 0x7b) return codePoint - 0x61;\n  return base;\n}\n\n/** ---------------------------------------------------------\n * * ***Converts a digit to a basic code point for `Punycode-UtilsJS`.***\n * ---------------------------------------------------------\n *\n * @param digit - Numeric value.\n * @param flag - Bias flag (0 or 1).\n * @returns Code point.\n */\nfunction digitToBasic(digit: number, flag: number): number {\n  return digit + 22 + 75 * (digit < 26 ? 1 : 0) - Number(flag !== 0) * 32;\n}\n\n/** ---------------------------------------------------------\n * * ***Bias adaptation function for `Punycode-UtilsJS` encoding/decoding.***\n * ---------------------------------------------------------\n *\n * @param delta - Delta value.\n * @param numPoints - Number of code points.\n * @param firstTime - Indicates first adaptation.\n * @returns Adapted bias.\n */\nfunction adapt(delta: number, numPoints: number, firstTime: boolean): number {\n  let k = 0;\n  delta = firstTime ? floor(delta / damp) : delta >> 1;\n  delta += floor(delta / numPoints);\n  while (delta > ((base - tMin) * tMax) >> 1) {\n    delta = floor(delta / (base - tMin));\n    k += base;\n  }\n  return floor(k + ((base - tMin + 1) * delta) / (delta + skew));\n}\n\n/** ---------------------------------------------------------\n * * ***Decodes a `Punycode-UtilsJS` string to Unicode.***\n * ---------------------------------------------------------\n *\n * @param input - `Punycode-UtilsJS` string.\n * @returns Decoded Unicode string.\n */\nfunction decode(input: string): string {\n  assertIsString(input, {\n    message: ({ currentType, validType }) =>\n      `Utils \\`punycodeUtilsJS.decode\\`, parameter \\`input\\` must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const output: number[] = [];\n  const inputLength = input.length;\n  let i = 0,\n    n = initialN,\n    bias = initialBias;\n\n  let basic = input.lastIndexOf(delimiter);\n  if (basic < 0) basic = 0;\n\n  for (let j = 0; j < basic; j++) {\n    if (input.charCodeAt(j) >= 0x80) error(\"not-basic\");\n    output.push(input.charCodeAt(j));\n  }\n\n  for (let index = basic > 0 ? basic + 1 : 0; index < inputLength; ) {\n    const oldi = i;\n    let w = 1;\n    for (let k = base; ; k += base) {\n      if (index >= inputLength) error(\"invalid-input\");\n      const digit = basicToDigit(input.charCodeAt(index++));\n      if (digit >= base) error(\"invalid-input\");\n      if (digit > floor((maxInt - i) / w)) error(\"overflow\");\n      i += digit * w;\n      const t = k <= bias ? tMin : k >= bias + tMax ? tMax : k - bias;\n      if (digit < t) break;\n      const baseMinusT = base - t;\n      if (w > floor(maxInt / baseMinusT)) error(\"overflow\");\n      w *= baseMinusT;\n    }\n    const out = output.length + 1;\n    bias = adapt(i - oldi, out, oldi === 0);\n    if (floor(i / out) > maxInt - n) error(\"overflow\");\n    n += floor(i / out);\n    i %= out;\n    output.splice(i++, 0, n);\n  }\n  return String.fromCodePoint(...output);\n}\n\n/** ---------------------------------------------------------\n * * ***Encodes a Unicode string to `Punycode-UtilsJS`.***\n * ---------------------------------------------------------\n *\n * @param input - Unicode string.\n * @returns `Punycode-UtilsJS` string.\n */\nfunction encode(input: string): string {\n  assertIsString(input, {\n    message: ({ currentType, validType }) =>\n      `Utils \\`punycodeUtilsJS.encode\\`, parameter \\`input\\` must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const output: string[] = [];\n  const points = ucs2decode(input);\n  const inputLength = points.length;\n  let n = initialN,\n    delta = 0,\n    bias = initialBias;\n\n  for (const cp of points) if (cp < 0x80) output.push(stringFromCharCode(cp));\n  const basicLength = output.length;\n  let handledCPCount = basicLength;\n  if (basicLength) output.push(delimiter);\n\n  while (handledCPCount < inputLength) {\n    let m = maxInt;\n    for (const cp of points) if (cp >= n && cp < m) m = cp;\n\n    const handledCPCountPlusOne = handledCPCount + 1;\n    if (m - n > floor((maxInt - delta) / handledCPCountPlusOne))\n      error(\"overflow\");\n    delta += (m - n) * handledCPCountPlusOne;\n    n = m;\n\n    for (const cp of points) {\n      if (cp < n) delta++;\n      if (cp === n) {\n        let q = delta;\n        for (let k = base; ; k += base) {\n          const t = k <= bias ? tMin : k >= bias + tMax ? tMax : k - bias;\n          if (q < t) break;\n          output.push(\n            stringFromCharCode(digitToBasic(t + ((q - t) % (base - t)), 0))\n          );\n          q = floor((q - t) / (base - t));\n        }\n        output.push(stringFromCharCode(digitToBasic(q, 0)));\n        bias = adapt(\n          delta,\n          handledCPCountPlusOne,\n          handledCPCount === basicLength\n        );\n        delta = 0;\n        handledCPCount++;\n      }\n    }\n    delta++;\n    n++;\n  }\n\n  return output.join(\"\");\n}\n\n/** ---------------------------------------------------------\n * * ***Converts `Punycode-UtilsJS` to Unicode for domain names.***\n * ---------------------------------------------------------\n *\n * @param input - Domain or label.\n * @returns Unicode string.\n */\nfunction toUnicode(input: string): string {\n  assertIsString(input, {\n    message: ({ currentType, validType }) =>\n      `Utils \\`punycodeUtilsJS.toUnicode\\`, parameter \\`input\\` must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  return mapDomain(input, (str) =>\n    regexPunycode.test(str) ? decode(str.slice(4).toLowerCase()) : str\n  );\n}\n\n/** ---------------------------------------------------------\n * * ***Converts Unicode to ASCII (`Punycode-UtilsJS`) for domain names.***\n * ---------------------------------------------------------\n *\n * @param input - Domain or label.\n * @returns ASCII string.\n */\nfunction toASCII(input: string): string {\n  assertIsString(input, {\n    message: ({ currentType, validType }) =>\n      `Utils \\`punycodeUtilsJS.toASCII\\`, parameter \\`input\\` must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  return mapDomain(input, (str) =>\n    regexNonASCII.test(str) ? \"xn--\" + encode(str) : str\n  );\n}\n\ntype PunycodeUtilsJS = {\n  /** ---------------------------------------------------------\n   * * ***Version of the `Punycode-UtilsJS` implementation.***\n   * ---------------------------------------------------------\n   *\n   * @example\n   * console.log(punycodeUtilsJS.version); // \"1.0.0\"\n   */\n  version: string;\n  /** ---------------------------------------------------------\n   * * ***UCS-2 utility functions.***\n   * ---------------------------------------------------------\n   */\n  ucs2: {\n    /** ---------------------------------------------------------\n     * * ***Decodes a UCS-2 encoded string to an array of Unicode code points.***\n     * ---------------------------------------------------------\n     *\n     * @param input - The UCS-2 string to decode.\n     * @returns Array of Unicode code points.\n     * @example\n     * punycodeUtilsJS.ucs2.decode(\"𐍈\");\n     * // ➔ [66376]\n     */\n    decode: (input: string) => number[];\n    /** ---------------------------------------------------------\n     * * ***Encodes an array of Unicode code points to a UCS-2 string.***\n     * ---------------------------------------------------------\n     *\n     * @param points - Array of Unicode code points.\n     * @returns Encoded string.\n     * @example\n     * punycodeUtilsJS.ucs2.encode([66376]);\n     * // ➔ \"𐍈\"\n     */\n    encode: (points: number[]) => string;\n  };\n  /** ---------------------------------------------------------\n   * * ***Decodes a `Punycode-UtilsJS` string to a Unicode string.***\n   * ---------------------------------------------------------\n   *\n   * @param input - The `Punycode-UtilsJS` string to decode.\n   * @returns Decoded Unicode string.\n   * @example\n   * punycodeUtilsJS.decode(\"xn--fsq\");\n   * // ➔ \"ü\"\n   */\n  decode: (input: string) => string;\n  /** ---------------------------------------------------------\n   * * ***Encodes a Unicode string to `Punycode-UtilsJS`.***\n   * ---------------------------------------------------------\n   *\n   * @param input - Unicode string to encode.\n   * @returns `Punycode-UtilsJS` string.\n   * @example\n   * punycodeUtilsJS.encode(\"ü\");\n   * // ➔ \"xn--fsq\"\n   */\n  encode: (input: string) => string;\n  /** ---------------------------------------------------------\n   * * ***Converts a Unicode domain or label to ASCII (`Punycode-UtilsJS`).***\n   * ---------------------------------------------------------\n   *\n   * @param input - Domain or label string.\n   * @returns ASCII string suitable for DNS.\n   * @example\n   * punycodeUtilsJS.toASCII(\"пример.рф\");\n   * // ➔ \"xn--e1afmkfd.xn--p1ai\"\n   */\n  toASCII: (input: string) => string;\n  /** ---------------------------------------------------------\n   * * ***Converts an ASCII (`Punycode-UtilsJS`) domain or label to Unicode.***\n   * ---------------------------------------------------------\n   *\n   * @param input - ASCII string (with xn-- prefix if needed).\n   * @returns Unicode string.\n   * @example\n   * punycodeUtilsJS.toUnicode(\"xn--e1afmkfd.xn--p1ai\");\n   * // ➔ \"пример.рф\"\n   */\n  toUnicode: (input: string) => string;\n};\n\n/** ---------------------------------------------------------\n * * ***`Punycode-UtilsJS` object exposing all API functions and version.***\n * ---------------------------------------------------------\n * Provides encoding and decoding of Unicode domain names to ASCII (`Punycode-UtilsJS`)\n * and vice versa.\n *\n * - Useful for IDN (Internationalized Domain Names) support.\n */\nconst punycodeUtilsJS: PunycodeUtilsJS = {\n  version: \"1.0.0\",\n  ucs2: {\n    decode: ucs2decode,\n    encode: ucs2encode\n  },\n  decode: decode,\n  encode: encode,\n  toASCII: toASCII,\n  toUnicode: toUnicode\n};\n\n/**\n * Export individual functions.\n */\nexport { punycodeUtilsJS };\n"],"mappings":"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"}

package/dist/{removeSpaces-BE8lfh-4.js → removeSpaces-B96axxP6.js}

@@ -2,12 +2,15 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { A as isPlainObject, y as isNonEmptyString } from "./assertIsBoolean-BlBct0Fc.js";
+import { A as isPlainObject, y as isNonEmptyString } from "./assertIsBoolean-Bv6gL-xe.js";
+const normalizeString = (input) => {
+	return isNonEmptyString(input) ? input.trim() : "";
+};
 const removeSpaces = (value, options = { trimOnly: false }) => {
 	if (!isNonEmptyString(value)) return "";
 	if (!isPlainObject(options)) options = {};
@@ -15,5 +18,5 @@ const removeSpaces = (value, options = { trimOnly: false }) => {
 	if (trimOnly) return value.trim();
 	return value.replace(/\s+/g, "");
 };
-export { removeSpaces as t };
-//# sourceMappingURL=removeSpaces-BE8lfh-4.js.map
+export { normalizeString as n, removeSpaces as t };
+//# sourceMappingURL=removeSpaces-B96axxP6.js.map

package/dist/removeSpaces-B96axxP6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeSpaces-B96axxP6.js","names":[],"sources":["../src/strings/sanitizations/normalizeString.ts","../src/strings/sanitizations/removeSpaces.ts"],"sourcesContent":["import { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `normalizeString`.***\n * ----------------------------------------------------------\n * **Normalizes a string by ensuring it is a valid string and trimming whitespace.**\n * - **Behavior:**\n *    - If the input is `undefined`, `null`, or an `empty string` after trimming,\n *      it returns an empty string `(\"\")`.\n * @param {string | undefined | null} input - The input string to be normalize. If `null` or `undefined`, returns an empty string.\n * @returns {string} A trimmed string or an empty string if the input is invalid.\n * @example\n * normalizeString(\"   Hello World   \");\n * // ➔ \"Hello World\"\n * normalizeString(\"   Hello    World   \");\n * // ➔ \"Hello    World\"\n * normalizeString(\"\");\n * // ➔ \"\"\n * normalizeString(null);\n * // ➔ \"\"\n * normalizeString(undefined);\n * // ➔ \"\"\n */\nexport const normalizeString = (input: string | null | undefined): string => {\n  return isNonEmptyString(input) ? input.trim() : \"\";\n};\n","import { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\ntype RemoveSpacesOptions = {\n  /** If `true`, only trims the string, defaultValue: `false`.\n   *\n   * @default false\n   */\n  trimOnly?: boolean;\n};\n\n/** ----------------------------------------------------------\n * * ***Utility: `removeSpaces`.***\n * ----------------------------------------------------------\n * **Removes all spaces from a string or trims only, based on the options provided.**\n * - **Behavior:**\n *    - If `trimOnly` is `true`, the string is simply trimmed.\n *    - Otherwise, removes **all spaces**, tabs, newlines, etc.\n *    - If the input is `null` or `undefined`, returns an empty string `(\"\")`.\n * @param {string | null | undefined} value - The input string to be processed. If `null` or `undefined`, returns an empty string.\n * @param {RemoveSpacesOptions} [options] - The options object.\n * @param {RemoveSpacesOptions[\"trimOnly\"]} [options.trimOnly=false] - If `true`, only trims the string without removing spaces inside.\n * @returns {string} The processed string.\n * @example\n * removeSpaces(\"  Hello   World  \");\n * // ➔ \"HelloWorld\"\n * removeSpaces(\"  Hello   World  \", { trimOnly: true });\n * // ➔ \"Hello   World\"\n * removeSpaces(null);\n * // ➔ \"\"\n */\nexport const removeSpaces = (\n  value: string | null | undefined,\n  options: RemoveSpacesOptions = {\n    trimOnly: false\n  }\n): string => {\n  if (!isNonEmptyString(value)) return \"\";\n\n  if (!isPlainObject(options)) {\n    options = {};\n  }\n\n  const { trimOnly = false } = options;\n\n  if (trimOnly) return value.trim();\n\n  // Remove all spaces (including tabs, newlines, etc.)\n  return value.replace(/\\s+/g, \"\");\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,mBAAmB,UAA6C;CAC3E,OAAO,iBAAiB,MAAM,GAAG,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;ACOlD,MAAa,gBACX,OACA,UAA+B,EAC7B,UAAU,OACX,KACU;CACX,IAAI,CAAC,iBAAiB,MAAM,EAAE,OAAO;CAErC,IAAI,CAAC,cAAc,QAAQ,EACzB,UAAU,EAAE;CAGd,MAAM,EAAE,WAAW,UAAU;CAE7B,IAAI,UAAU,OAAO,MAAM,MAAM;CAGjC,OAAO,MAAM,QAAQ,QAAQ,GAAG"}

package/dist/{removeSpaces-DRRxNWlb.cjs → removeSpaces-C8mu_yp3.cjs}

@@ -2,13 +2,16 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 "use strict";
-const require_assertIsBoolean = require('./assertIsBoolean-DozdtbNi.cjs');
+const require_assertIsBoolean = require('./assertIsBoolean-amRiJHnh.cjs');
+const normalizeString = (input) => {
+	return require_assertIsBoolean.isNonEmptyString(input) ? input.trim() : "";
+};
 const removeSpaces = (value, options = { trimOnly: false }) => {
 	if (!require_assertIsBoolean.isNonEmptyString(value)) return "";
 	if (!require_assertIsBoolean.isPlainObject(options)) options = {};
@@ -16,10 +19,16 @@ const removeSpaces = (value, options = { trimOnly: false }) => {
 	if (trimOnly) return value.trim();
 	return value.replace(/\s+/g, "");
 };
+Object.defineProperty(exports, 'normalizeString', {
+  enumerable: true,
+  get: function () {
+    return normalizeString;
+  }
+});
 Object.defineProperty(exports, 'removeSpaces', {
   enumerable: true,
   get: function () {
     return removeSpaces;
   }
 });
-//# sourceMappingURL=removeSpaces-DRRxNWlb.cjs.map
+//# sourceMappingURL=removeSpaces-C8mu_yp3.cjs.map

package/dist/removeSpaces-C8mu_yp3.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeSpaces-C8mu_yp3.cjs","names":["isNonEmptyString","isNonEmptyString","isPlainObject"],"sources":["../src/strings/sanitizations/normalizeString.ts","../src/strings/sanitizations/removeSpaces.ts"],"sourcesContent":["import { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `normalizeString`.***\n * ----------------------------------------------------------\n * **Normalizes a string by ensuring it is a valid string and trimming whitespace.**\n * - **Behavior:**\n *    - If the input is `undefined`, `null`, or an `empty string` after trimming,\n *      it returns an empty string `(\"\")`.\n * @param {string | undefined | null} input - The input string to be normalize. If `null` or `undefined`, returns an empty string.\n * @returns {string} A trimmed string or an empty string if the input is invalid.\n * @example\n * normalizeString(\"   Hello World   \");\n * // ➔ \"Hello World\"\n * normalizeString(\"   Hello    World   \");\n * // ➔ \"Hello    World\"\n * normalizeString(\"\");\n * // ➔ \"\"\n * normalizeString(null);\n * // ➔ \"\"\n * normalizeString(undefined);\n * // ➔ \"\"\n */\nexport const normalizeString = (input: string | null | undefined): string => {\n  return isNonEmptyString(input) ? input.trim() : \"\";\n};\n","import { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\ntype RemoveSpacesOptions = {\n  /** If `true`, only trims the string, defaultValue: `false`.\n   *\n   * @default false\n   */\n  trimOnly?: boolean;\n};\n\n/** ----------------------------------------------------------\n * * ***Utility: `removeSpaces`.***\n * ----------------------------------------------------------\n * **Removes all spaces from a string or trims only, based on the options provided.**\n * - **Behavior:**\n *    - If `trimOnly` is `true`, the string is simply trimmed.\n *    - Otherwise, removes **all spaces**, tabs, newlines, etc.\n *    - If the input is `null` or `undefined`, returns an empty string `(\"\")`.\n * @param {string | null | undefined} value - The input string to be processed. If `null` or `undefined`, returns an empty string.\n * @param {RemoveSpacesOptions} [options] - The options object.\n * @param {RemoveSpacesOptions[\"trimOnly\"]} [options.trimOnly=false] - If `true`, only trims the string without removing spaces inside.\n * @returns {string} The processed string.\n * @example\n * removeSpaces(\"  Hello   World  \");\n * // ➔ \"HelloWorld\"\n * removeSpaces(\"  Hello   World  \", { trimOnly: true });\n * // ➔ \"Hello   World\"\n * removeSpaces(null);\n * // ➔ \"\"\n */\nexport const removeSpaces = (\n  value: string | null | undefined,\n  options: RemoveSpacesOptions = {\n    trimOnly: false\n  }\n): string => {\n  if (!isNonEmptyString(value)) return \"\";\n\n  if (!isPlainObject(options)) {\n    options = {};\n  }\n\n  const { trimOnly = false } = options;\n\n  if (trimOnly) return value.trim();\n\n  // Remove all spaces (including tabs, newlines, etc.)\n  return value.replace(/\\s+/g, \"\");\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,mBAAmB,UAA6C;CAC3E,OAAOA,yCAAiB,MAAM,GAAG,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;ACOlD,MAAa,gBACX,OACA,UAA+B,EAC7B,UAAU,OACX,KACU;CACX,IAAI,CAACC,yCAAiB,MAAM,EAAE,OAAO;CAErC,IAAI,CAACC,sCAAc,QAAQ,EACzB,UAAU,EAAE;CAGd,MAAM,EAAE,WAAW,UAAU;CAE7B,IAAI,UAAU,OAAO,MAAM,MAAM;CAGjC,OAAO,MAAM,QAAQ,QAAQ,GAAG"}