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

package/dist/{toStringArrayUnRecursive-tHp2a7KR.js → toStringArrayUnRecursive-DBicbWv8.js}

@@ -2,15 +2,15 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.13.0-beta.2`
+*  Version: `3.13.0-beta.3`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { E as isNull, F as isBoolean, M as isArray, N as isNil, T as assertIsPlainObject, b as hasOwnProp, k as isString, t as assertIsBoolean } from "./assertIsBoolean-Bv6gL-xe.js";
-import { t as isBigInt } from "./isBigInt-D-Pu9sxp.js";
-import { n as isEmptyArray } from "./isEmptyObject-CZ9DLi7R.js";
-import { t as isFinite } from "./isFinite-Cz_IFXuV.js";
+import { E as isNull, F as isBoolean, M as isArray, N as isNil, T as assertIsPlainObject, b as hasOwnProp, k as isString, t as assertIsBoolean } from "./assertIsBoolean-Clc7Vw4v.js";
+import { t as isBigInt } from "./isBigInt-Cx4j_cju.js";
+import { n as isEmptyArray } from "./isEmptyObject-Dp4pCGTa.js";
+import { t as isFinite } from "./isFinite-CZ-Aiy4T.js";
 function filterNilArray(input) {
 	if (isNil(input)) return void 0;
 	if (!isArray(input)) return [];
@@ -36,4 +36,4 @@ function toStringArrayUnRecursive(array, options = {}) {
 	}
 }
 export { filterNilArray as n, toStringArrayUnRecursive as t };
-//# sourceMappingURL=toStringArrayUnRecursive-tHp2a7KR.js.map
+//# sourceMappingURL=toStringArrayUnRecursive-DBicbWv8.js.map

package/dist/{toStringArrayUnRecursive-tHp2a7KR.js.map → toStringArrayUnRecursive-DBicbWv8.js.map}

@@ -1 +1 @@
-{"version":3,"file":"toStringArrayUnRecursive-tHp2a7KR.js","names":[],"sources":["../src/conversions/arrays/transforms/filterNilArray.ts","../src/conversions/arrays/casts/toStringArrayUnRecursive.ts"],"sourcesContent":["import type {\n  FilterNilArray,\n  FilterNilArrayFromTuple,\n  PreserveMutability\n} from \"./_private/filterNilArray.types\";\n\nimport { isNil } from \"@/predicates/is/isNil\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isEmptyArray } from \"@/predicates/is/isEmptyArray\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `filterNilArray`.***\n * ---------------------------------------------\n * **Removes `null` and `undefined` values from an array, including nested arrays.**\n * - **Behavior:**\n *    - Returns `undefined` if the input is explicitly `undefined` or `null`.\n *    - Returns `[]` if input is empty or all elements are removed after filtering.\n *    - Recursively filters nested arrays while preserving structure.\n *    - Ensures proper type inference for safer downstream operations.\n * @template A - The type of elements in the array.\n * @param {T[]|null|undefined} input - The array to be filtered.\n * @returns {T[] | undefined} A new array with `null` and `undefined` values removed,\n * or `undefined` if the input is explicitly `undefined` or `null`.\n * @example\n * ```ts\n * filterNilArray([1, null, 2, undefined, 3]);\n * // ➔ [1, 2, 3]\n * filterNilArray([null, undefined]);\n * // ➔ []\n * filterNilArray(undefined);\n * // ➔ undefined\n * filterNilArray(null);\n * // ➔ undefined\n * filterNilArray([]); // or\n * filterNilArray([[[]]]); // or\n * filterNilArray([[[],undefined,null]]);\n * // ➔ []\n * filterNilArray([1, [null, 2, [undefined, 3]]]);\n * // ➔ [1, [2, [3]]]\n * ```\n */\nexport function filterNilArray(input: null | undefined): undefined;\nexport function filterNilArray<A extends readonly unknown[]>(\n  input: A\n): PreserveMutability<A, FilterNilArrayFromTuple<A>>;\nexport function filterNilArray<A extends readonly unknown[]>(\n  input: A | null | undefined\n): PreserveMutability<A, FilterNilArrayFromTuple<A>> | undefined;\nexport function filterNilArray<A>(\n  input: (A | null | undefined)[] | null | undefined\n): FilterNilArray<A> | undefined;\nexport function filterNilArray(\n  input: readonly unknown[] | null | undefined\n): unknown[] | undefined;\nexport function filterNilArray(input: unknown[]): unknown[];\nexport function filterNilArray(input: unknown): unknown {\n  if (isNil(input)) return undefined;\n  if (!isArray(input)) return [];\n\n  const filtered = input.reduce<unknown[]>((output, element) => {\n    if (!isNil(element)) {\n      if (isArray(element)) {\n        const cleanedNested = filterNilArray(element);\n        if (cleanedNested && !isEmptyArray(cleanedNested)) {\n          output.push(cleanedNested);\n        }\n      } else {\n        output.push(element);\n      }\n    }\n    return output;\n  }, []);\n\n  return filtered;\n}\n","import type {\n  ToStringArrayUnRecursiveOptions,\n  ToStringArrayUnRecursiveReturn\n} from \"./toStringArrayUnRecursive.types\";\n\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isFinite } from \"@/predicates/is/isFinite\";\nimport { isBigInt } from \"@/predicates/is/isBigInt\";\nimport { isBoolean } from \"@/predicates/is/isBoolean\";\nimport { hasOwnProp } from \"@/predicates/has/hasOwnProp\";\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\nimport { assertIsPlainObject } from \"@/assertions/objects/assertIsPlainObject\";\n\nimport { filterNilArray } from \"../transforms/filterNilArray\";\n\n/** ---------------------------------------------\n * * ***Utility: `toStringArrayUnRecursive`.***\n * ---------------------------------------------\n * **Converts all values in a flat array into string representations.**\n * - **Behavior:**\n *    - Only processes **flat arrays** (non-recursive).\n *    - Supports input values: `string`, `number`, `bigint`, `boolean`,\n *      `null`, `undefined`.\n *    - Invalid values (`null` and `undefined`) can be **removed** or **kept**\n *      depending on the option.\n *    - Other unsupported types will be converted to `undefined` (and removed\n *      if `removeInvalidValue=true`).\n * - **ℹ️ Note:**\n *    - _For recursive / nested arrays, use ***`toStringDeep` utility function*** instead._\n * @template T - Element type of the input array.\n * @template R - Whether invalid values should be removed (`true`) or kept (`false`).\n * @param {Array<string | number | bigint | boolean | null | undefined> | null | undefined} [array] - The array to convert, returns `undefined` if not an array.\n * @param {ToStringArrayUnRecursiveOptions<RemoveInvalidValue>} [options] - Options to control transformation behavior, defaults to `{ removeInvalidValue: true }`.\n * @param {RemoveInvalidValue extends true ? boolean : boolean} [options.removeInvalidValue=true] Whether to remove invalid values (`null`, `undefined`, or unsupported types), default: `true`.\n * @returns {RemoveInvalidValue extends true ? string[] : (string | null | undefined)[]} A new array of string representations, with invalid values optionally removed.\n * @example\n * ```ts\n * // Convert numbers and strings\n * toStringArrayUnRecursive([1, 2, '3']);\n * // ➔ ['1', '2', '3']\n * // Remove null and undefined\n * toStringArrayUnRecursive([1, null, undefined, 'abc'], {\n *   removeInvalidValue: true\n * });\n * // ➔ ['1', 'abc']\n * // Keep null and undefined\n * toStringArrayUnRecursive([1, null, undefined, 'abc'], {\n *   removeInvalidValue: false\n * });\n * // ➔ ['1', null, undefined, 'abc']\n * // Convert boolean and bigint\n * toStringArrayUnRecursive([true, false, 10n]);\n * // ➔ ['true', 'false', '10']\n * // Not an array ➔ returns undefined\n * toStringArrayUnRecursive(null);\n * // ➔ undefined\n * toStringArrayUnRecursive(undefined);\n * // ➔ undefined\n * toStringArrayUnRecursive(1);\n * // ➔ undefined\n * toStringArrayUnRecursive(\"string\");\n * // ➔ undefined\n * ```\n */\nexport function toStringArrayUnRecursive(\n  array?: undefined | null,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): undefined;\nexport function toStringArrayUnRecursive(\n  array?: Array<never>,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): [];\nexport function toStringArrayUnRecursive<T, R extends boolean = true>(\n  array?: Array<T> | readonly T[] | null,\n  options?: ToStringArrayUnRecursiveOptions<R>\n): ToStringArrayUnRecursiveReturn<T, R>;\nexport function toStringArrayUnRecursive<T = unknown>(\n  array?: T,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): undefined;\nexport function toStringArrayUnRecursive<T>(\n  array?: Array<T> | readonly T[] | null,\n  options: ToStringArrayUnRecursiveOptions<boolean> = {}\n) {\n  assertIsPlainObject(options, {\n    message: ({ currentType, validType }) =>\n      `Second parameter (\\`options\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const riv = hasOwnProp(options, \"removeInvalidValue\")\n    ? options.removeInvalidValue\n    : true;\n\n  assertIsBoolean(riv, {\n    message: ({ currentType, validType }) =>\n      `Parameter \\`removeInvalidValue\\` property of the \\`options\\` (second parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  if (isArray(array)) {\n    // Convert each item in the array to a string, or null/undefined if it's not a valid value.\n    const result = Array.from(array, (x) => {\n      // Convert finite number, boolean, bigInt or string to string\n      if (isString(x) || isFinite(x) || isBoolean(x) || isBigInt(x))\n        return String(x);\n\n      // Handle null or undefined values\n      return isNull(x) ? null : undefined;\n    });\n\n    // Remove invalid values (null, undefined) if specified in options\n    if (riv) return filterNilArray(result);\n\n    return result;\n  }\n\n  // Return undefined if no array is provided\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAuDA,SAAgB,eAAe,OAAyB;CACtD,IAAI,MAAM,MAAM,EAAE,OAAO;CACzB,IAAI,CAAC,QAAQ,MAAM,EAAE,OAAO,EAAE;CAgB9B,OAdiB,MAAM,QAAmB,QAAQ,YAAY;EAC5D,IAAI,CAAC,MAAM,QAAQ,EACjB,IAAI,QAAQ,QAAQ,EAAE;GACpB,MAAM,gBAAgB,eAAe,QAAQ;GAC7C,IAAI,iBAAiB,CAAC,aAAa,cAAc,EAC/C,OAAO,KAAK,cAAc;SAG5B,OAAO,KAAK,QAAQ;EAGxB,OAAO;IACN,EAAE,CAEU;;;;;ACSjB,SAAgB,yBACd,OACA,UAAoD,EAAE,EACtD;CACA,oBAAoB,SAAS,EAC3B,UAAU,EAAE,aAAa,gBACvB,oDAAoD,UAAU,sBAAsB,YAAY,MACnG,CAAC;CAEF,MAAM,MAAM,WAAW,SAAS,qBAAqB,GACjD,QAAQ,qBACR;CAEJ,gBAAgB,KAAK,EACnB,UAAU,EAAE,aAAa,gBACvB,qGAAqG,UAAU,sBAAsB,YAAY,MACpJ,CAAC;CAEF,IAAI,QAAQ,MAAM,EAAE;EAElB,MAAM,SAAS,MAAM,KAAK,QAAQ,MAAM;GAEtC,IAAI,SAAS,EAAE,IAAI,SAAS,EAAE,IAAI,UAAU,EAAE,IAAI,SAAS,EAAE,EAC3D,OAAO,OAAO,EAAE;GAGlB,OAAO,OAAO,EAAE,GAAG,OAAO;IAC1B;EAGF,IAAI,KAAK,OAAO,eAAe,OAAO;EAEtC,OAAO"}
+{"version":3,"file":"toStringArrayUnRecursive-DBicbWv8.js","names":[],"sources":["../src/conversions/arrays/transforms/filterNilArray.ts","../src/conversions/arrays/casts/toStringArrayUnRecursive.ts"],"sourcesContent":["import type {\n  FilterNilArray,\n  FilterNilArrayFromTuple,\n  PreserveMutability\n} from \"./_private/filterNilArray.types\";\n\nimport { isNil } from \"@/predicates/is/isNil\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isEmptyArray } from \"@/predicates/is/isEmptyArray\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `filterNilArray`.***\n * ---------------------------------------------\n * **Removes `null` and `undefined` values from an array, including nested arrays.**\n * - **Behavior:**\n *    - Returns `undefined` if the input is explicitly `undefined` or `null`.\n *    - Returns `[]` if input is empty or all elements are removed after filtering.\n *    - Recursively filters nested arrays while preserving structure.\n *    - Ensures proper type inference for safer downstream operations.\n * @template A - The type of elements in the array.\n * @param {T[]|null|undefined} input - The array to be filtered.\n * @returns {T[] | undefined} A new array with `null` and `undefined` values removed,\n * or `undefined` if the input is explicitly `undefined` or `null`.\n * @example\n * ```ts\n * filterNilArray([1, null, 2, undefined, 3]);\n * // ➔ [1, 2, 3]\n * filterNilArray([null, undefined]);\n * // ➔ []\n * filterNilArray(undefined);\n * // ➔ undefined\n * filterNilArray(null);\n * // ➔ undefined\n * filterNilArray([]); // or\n * filterNilArray([[[]]]); // or\n * filterNilArray([[[],undefined,null]]);\n * // ➔ []\n * filterNilArray([1, [null, 2, [undefined, 3]]]);\n * // ➔ [1, [2, [3]]]\n * ```\n */\nexport function filterNilArray(input: null | undefined): undefined;\nexport function filterNilArray<A extends readonly unknown[]>(\n  input: A\n): PreserveMutability<A, FilterNilArrayFromTuple<A>>;\nexport function filterNilArray<A extends readonly unknown[]>(\n  input: A | null | undefined\n): PreserveMutability<A, FilterNilArrayFromTuple<A>> | undefined;\nexport function filterNilArray<A>(\n  input: (A | null | undefined)[] | null | undefined\n): FilterNilArray<A> | undefined;\nexport function filterNilArray(\n  input: readonly unknown[] | null | undefined\n): unknown[] | undefined;\nexport function filterNilArray(input: unknown[]): unknown[];\nexport function filterNilArray(input: unknown): unknown {\n  if (isNil(input)) return undefined;\n  if (!isArray(input)) return [];\n\n  const filtered = input.reduce<unknown[]>((output, element) => {\n    if (!isNil(element)) {\n      if (isArray(element)) {\n        const cleanedNested = filterNilArray(element);\n        if (cleanedNested && !isEmptyArray(cleanedNested)) {\n          output.push(cleanedNested);\n        }\n      } else {\n        output.push(element);\n      }\n    }\n    return output;\n  }, []);\n\n  return filtered;\n}\n","import type {\n  ToStringArrayUnRecursiveOptions,\n  ToStringArrayUnRecursiveReturn\n} from \"./toStringArrayUnRecursive.types\";\n\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isFinite } from \"@/predicates/is/isFinite\";\nimport { isBigInt } from \"@/predicates/is/isBigInt\";\nimport { isBoolean } from \"@/predicates/is/isBoolean\";\nimport { hasOwnProp } from \"@/predicates/has/hasOwnProp\";\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\nimport { assertIsPlainObject } from \"@/assertions/objects/assertIsPlainObject\";\n\nimport { filterNilArray } from \"../transforms/filterNilArray\";\n\n/** ---------------------------------------------\n * * ***Utility: `toStringArrayUnRecursive`.***\n * ---------------------------------------------\n * **Converts all values in a flat array into string representations.**\n * - **Behavior:**\n *    - Only processes **flat arrays** (non-recursive).\n *    - Supports input values: `string`, `number`, `bigint`, `boolean`,\n *      `null`, `undefined`.\n *    - Invalid values (`null` and `undefined`) can be **removed** or **kept**\n *      depending on the option.\n *    - Other unsupported types will be converted to `undefined` (and removed\n *      if `removeInvalidValue=true`).\n * - **ℹ️ Note:**\n *    - _For recursive / nested arrays, use ***`toStringDeep` utility function*** instead._\n * @template T - Element type of the input array.\n * @template R - Whether invalid values should be removed (`true`) or kept (`false`).\n * @param {Array<string | number | bigint | boolean | null | undefined> | null | undefined} [array] - The array to convert, returns `undefined` if not an array.\n * @param {ToStringArrayUnRecursiveOptions<RemoveInvalidValue>} [options] - Options to control transformation behavior, defaults to `{ removeInvalidValue: true }`.\n * @param {RemoveInvalidValue extends true ? boolean : boolean} [options.removeInvalidValue=true] Whether to remove invalid values (`null`, `undefined`, or unsupported types), default: `true`.\n * @returns {RemoveInvalidValue extends true ? string[] : (string | null | undefined)[]} A new array of string representations, with invalid values optionally removed.\n * @example\n * ```ts\n * // Convert numbers and strings\n * toStringArrayUnRecursive([1, 2, '3']);\n * // ➔ ['1', '2', '3']\n * // Remove null and undefined\n * toStringArrayUnRecursive([1, null, undefined, 'abc'], {\n *   removeInvalidValue: true\n * });\n * // ➔ ['1', 'abc']\n * // Keep null and undefined\n * toStringArrayUnRecursive([1, null, undefined, 'abc'], {\n *   removeInvalidValue: false\n * });\n * // ➔ ['1', null, undefined, 'abc']\n * // Convert boolean and bigint\n * toStringArrayUnRecursive([true, false, 10n]);\n * // ➔ ['true', 'false', '10']\n * // Not an array ➔ returns undefined\n * toStringArrayUnRecursive(null);\n * // ➔ undefined\n * toStringArrayUnRecursive(undefined);\n * // ➔ undefined\n * toStringArrayUnRecursive(1);\n * // ➔ undefined\n * toStringArrayUnRecursive(\"string\");\n * // ➔ undefined\n * ```\n */\nexport function toStringArrayUnRecursive(\n  array?: undefined | null,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): undefined;\nexport function toStringArrayUnRecursive(\n  array?: Array<never>,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): [];\nexport function toStringArrayUnRecursive<T, R extends boolean = true>(\n  array?: Array<T> | readonly T[] | null,\n  options?: ToStringArrayUnRecursiveOptions<R>\n): ToStringArrayUnRecursiveReturn<T, R>;\nexport function toStringArrayUnRecursive<T = unknown>(\n  array?: T,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): undefined;\nexport function toStringArrayUnRecursive<T>(\n  array?: Array<T> | readonly T[] | null,\n  options: ToStringArrayUnRecursiveOptions<boolean> = {}\n) {\n  assertIsPlainObject(options, {\n    message: ({ currentType, validType }) =>\n      `Second parameter (\\`options\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const riv = hasOwnProp(options, \"removeInvalidValue\")\n    ? options.removeInvalidValue\n    : true;\n\n  assertIsBoolean(riv, {\n    message: ({ currentType, validType }) =>\n      `Parameter \\`removeInvalidValue\\` property of the \\`options\\` (second parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  if (isArray(array)) {\n    // Convert each item in the array to a string, or null/undefined if it's not a valid value.\n    const result = Array.from(array, (x) => {\n      // Convert finite number, boolean, bigInt or string to string\n      if (isString(x) || isFinite(x) || isBoolean(x) || isBigInt(x))\n        return String(x);\n\n      // Handle null or undefined values\n      return isNull(x) ? null : undefined;\n    });\n\n    // Remove invalid values (null, undefined) if specified in options\n    if (riv) return filterNilArray(result);\n\n    return result;\n  }\n\n  // Return undefined if no array is provided\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAuDA,SAAgB,eAAe,OAAyB;CACtD,IAAI,MAAM,MAAM,EAAE,OAAO;CACzB,IAAI,CAAC,QAAQ,MAAM,EAAE,OAAO,EAAE;CAgB9B,OAdiB,MAAM,QAAmB,QAAQ,YAAY;EAC5D,IAAI,CAAC,MAAM,QAAQ,EACjB,IAAI,QAAQ,QAAQ,EAAE;GACpB,MAAM,gBAAgB,eAAe,QAAQ;GAC7C,IAAI,iBAAiB,CAAC,aAAa,cAAc,EAC/C,OAAO,KAAK,cAAc;SAG5B,OAAO,KAAK,QAAQ;EAGxB,OAAO;IACN,EAAE,CAEU;;;;;ACSjB,SAAgB,yBACd,OACA,UAAoD,EAAE,EACtD;CACA,oBAAoB,SAAS,EAC3B,UAAU,EAAE,aAAa,gBACvB,oDAAoD,UAAU,sBAAsB,YAAY,MACnG,CAAC;CAEF,MAAM,MAAM,WAAW,SAAS,qBAAqB,GACjD,QAAQ,qBACR;CAEJ,gBAAgB,KAAK,EACnB,UAAU,EAAE,aAAa,gBACvB,qGAAqG,UAAU,sBAAsB,YAAY,MACpJ,CAAC;CAEF,IAAI,QAAQ,MAAM,EAAE;EAElB,MAAM,SAAS,MAAM,KAAK,QAAQ,MAAM;GAEtC,IAAI,SAAS,EAAE,IAAI,SAAS,EAAE,IAAI,UAAU,EAAE,IAAI,SAAS,EAAE,EAC3D,OAAO,OAAO,EAAE;GAGlB,OAAO,OAAO,EAAE,GAAG,OAAO;IAC1B;EAGF,IAAI,KAAK,OAAO,eAAe,OAAO;EAEtC,OAAO"}

package/dist/{toStringArrayUnRecursive-D1mPM4wg.cjs → toStringArrayUnRecursive-DJ8JBO3N.cjs}

@@ -2,16 +2,16 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.13.0-beta.2`
+*  Version: `3.13.0-beta.3`
 *  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-amRiJHnh.cjs');
-const require_isBigInt = require('./isBigInt-CIFRnsdx.cjs');
-const require_isEmptyObject = require('./isEmptyObject-CEySmyHK.cjs');
-const require_isFinite = require('./isFinite-uukWvxJh.cjs');
+const require_assertIsBoolean = require('./assertIsBoolean-BKcvET7Z.cjs');
+const require_isBigInt = require('./isBigInt-BePsmNsm.cjs');
+const require_isEmptyObject = require('./isEmptyObject-DYypq92-.cjs');
+const require_isFinite = require('./isFinite-D8jhlqPf.cjs');
 function filterNilArray(input) {
 	if (require_assertIsBoolean.isNil(input)) return void 0;
 	if (!require_assertIsBoolean.isArray(input)) return [];
@@ -48,4 +48,4 @@ Object.defineProperty(exports, 'toStringArrayUnRecursive', {
     return toStringArrayUnRecursive;
   }
 });
-//# sourceMappingURL=toStringArrayUnRecursive-D1mPM4wg.cjs.map
+//# sourceMappingURL=toStringArrayUnRecursive-DJ8JBO3N.cjs.map

package/dist/{toStringArrayUnRecursive-D1mPM4wg.cjs.map → toStringArrayUnRecursive-DJ8JBO3N.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"toStringArrayUnRecursive-D1mPM4wg.cjs","names":["isNil","isArray","isEmptyArray","hasOwnProp","isArray","isString","isFinite","isBoolean","isBigInt","isNull"],"sources":["../src/conversions/arrays/transforms/filterNilArray.ts","../src/conversions/arrays/casts/toStringArrayUnRecursive.ts"],"sourcesContent":["import type {\n  FilterNilArray,\n  FilterNilArrayFromTuple,\n  PreserveMutability\n} from \"./_private/filterNilArray.types\";\n\nimport { isNil } from \"@/predicates/is/isNil\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isEmptyArray } from \"@/predicates/is/isEmptyArray\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `filterNilArray`.***\n * ---------------------------------------------\n * **Removes `null` and `undefined` values from an array, including nested arrays.**\n * - **Behavior:**\n *    - Returns `undefined` if the input is explicitly `undefined` or `null`.\n *    - Returns `[]` if input is empty or all elements are removed after filtering.\n *    - Recursively filters nested arrays while preserving structure.\n *    - Ensures proper type inference for safer downstream operations.\n * @template A - The type of elements in the array.\n * @param {T[]|null|undefined} input - The array to be filtered.\n * @returns {T[] | undefined} A new array with `null` and `undefined` values removed,\n * or `undefined` if the input is explicitly `undefined` or `null`.\n * @example\n * ```ts\n * filterNilArray([1, null, 2, undefined, 3]);\n * // ➔ [1, 2, 3]\n * filterNilArray([null, undefined]);\n * // ➔ []\n * filterNilArray(undefined);\n * // ➔ undefined\n * filterNilArray(null);\n * // ➔ undefined\n * filterNilArray([]); // or\n * filterNilArray([[[]]]); // or\n * filterNilArray([[[],undefined,null]]);\n * // ➔ []\n * filterNilArray([1, [null, 2, [undefined, 3]]]);\n * // ➔ [1, [2, [3]]]\n * ```\n */\nexport function filterNilArray(input: null | undefined): undefined;\nexport function filterNilArray<A extends readonly unknown[]>(\n  input: A\n): PreserveMutability<A, FilterNilArrayFromTuple<A>>;\nexport function filterNilArray<A extends readonly unknown[]>(\n  input: A | null | undefined\n): PreserveMutability<A, FilterNilArrayFromTuple<A>> | undefined;\nexport function filterNilArray<A>(\n  input: (A | null | undefined)[] | null | undefined\n): FilterNilArray<A> | undefined;\nexport function filterNilArray(\n  input: readonly unknown[] | null | undefined\n): unknown[] | undefined;\nexport function filterNilArray(input: unknown[]): unknown[];\nexport function filterNilArray(input: unknown): unknown {\n  if (isNil(input)) return undefined;\n  if (!isArray(input)) return [];\n\n  const filtered = input.reduce<unknown[]>((output, element) => {\n    if (!isNil(element)) {\n      if (isArray(element)) {\n        const cleanedNested = filterNilArray(element);\n        if (cleanedNested && !isEmptyArray(cleanedNested)) {\n          output.push(cleanedNested);\n        }\n      } else {\n        output.push(element);\n      }\n    }\n    return output;\n  }, []);\n\n  return filtered;\n}\n","import type {\n  ToStringArrayUnRecursiveOptions,\n  ToStringArrayUnRecursiveReturn\n} from \"./toStringArrayUnRecursive.types\";\n\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isFinite } from \"@/predicates/is/isFinite\";\nimport { isBigInt } from \"@/predicates/is/isBigInt\";\nimport { isBoolean } from \"@/predicates/is/isBoolean\";\nimport { hasOwnProp } from \"@/predicates/has/hasOwnProp\";\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\nimport { assertIsPlainObject } from \"@/assertions/objects/assertIsPlainObject\";\n\nimport { filterNilArray } from \"../transforms/filterNilArray\";\n\n/** ---------------------------------------------\n * * ***Utility: `toStringArrayUnRecursive`.***\n * ---------------------------------------------\n * **Converts all values in a flat array into string representations.**\n * - **Behavior:**\n *    - Only processes **flat arrays** (non-recursive).\n *    - Supports input values: `string`, `number`, `bigint`, `boolean`,\n *      `null`, `undefined`.\n *    - Invalid values (`null` and `undefined`) can be **removed** or **kept**\n *      depending on the option.\n *    - Other unsupported types will be converted to `undefined` (and removed\n *      if `removeInvalidValue=true`).\n * - **ℹ️ Note:**\n *    - _For recursive / nested arrays, use ***`toStringDeep` utility function*** instead._\n * @template T - Element type of the input array.\n * @template R - Whether invalid values should be removed (`true`) or kept (`false`).\n * @param {Array<string | number | bigint | boolean | null | undefined> | null | undefined} [array] - The array to convert, returns `undefined` if not an array.\n * @param {ToStringArrayUnRecursiveOptions<RemoveInvalidValue>} [options] - Options to control transformation behavior, defaults to `{ removeInvalidValue: true }`.\n * @param {RemoveInvalidValue extends true ? boolean : boolean} [options.removeInvalidValue=true] Whether to remove invalid values (`null`, `undefined`, or unsupported types), default: `true`.\n * @returns {RemoveInvalidValue extends true ? string[] : (string | null | undefined)[]} A new array of string representations, with invalid values optionally removed.\n * @example\n * ```ts\n * // Convert numbers and strings\n * toStringArrayUnRecursive([1, 2, '3']);\n * // ➔ ['1', '2', '3']\n * // Remove null and undefined\n * toStringArrayUnRecursive([1, null, undefined, 'abc'], {\n *   removeInvalidValue: true\n * });\n * // ➔ ['1', 'abc']\n * // Keep null and undefined\n * toStringArrayUnRecursive([1, null, undefined, 'abc'], {\n *   removeInvalidValue: false\n * });\n * // ➔ ['1', null, undefined, 'abc']\n * // Convert boolean and bigint\n * toStringArrayUnRecursive([true, false, 10n]);\n * // ➔ ['true', 'false', '10']\n * // Not an array ➔ returns undefined\n * toStringArrayUnRecursive(null);\n * // ➔ undefined\n * toStringArrayUnRecursive(undefined);\n * // ➔ undefined\n * toStringArrayUnRecursive(1);\n * // ➔ undefined\n * toStringArrayUnRecursive(\"string\");\n * // ➔ undefined\n * ```\n */\nexport function toStringArrayUnRecursive(\n  array?: undefined | null,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): undefined;\nexport function toStringArrayUnRecursive(\n  array?: Array<never>,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): [];\nexport function toStringArrayUnRecursive<T, R extends boolean = true>(\n  array?: Array<T> | readonly T[] | null,\n  options?: ToStringArrayUnRecursiveOptions<R>\n): ToStringArrayUnRecursiveReturn<T, R>;\nexport function toStringArrayUnRecursive<T = unknown>(\n  array?: T,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): undefined;\nexport function toStringArrayUnRecursive<T>(\n  array?: Array<T> | readonly T[] | null,\n  options: ToStringArrayUnRecursiveOptions<boolean> = {}\n) {\n  assertIsPlainObject(options, {\n    message: ({ currentType, validType }) =>\n      `Second parameter (\\`options\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const riv = hasOwnProp(options, \"removeInvalidValue\")\n    ? options.removeInvalidValue\n    : true;\n\n  assertIsBoolean(riv, {\n    message: ({ currentType, validType }) =>\n      `Parameter \\`removeInvalidValue\\` property of the \\`options\\` (second parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  if (isArray(array)) {\n    // Convert each item in the array to a string, or null/undefined if it's not a valid value.\n    const result = Array.from(array, (x) => {\n      // Convert finite number, boolean, bigInt or string to string\n      if (isString(x) || isFinite(x) || isBoolean(x) || isBigInt(x))\n        return String(x);\n\n      // Handle null or undefined values\n      return isNull(x) ? null : undefined;\n    });\n\n    // Remove invalid values (null, undefined) if specified in options\n    if (riv) return filterNilArray(result);\n\n    return result;\n  }\n\n  // Return undefined if no array is provided\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAuDA,SAAgB,eAAe,OAAyB;CACtD,IAAIA,8BAAM,MAAM,EAAE,OAAO;CACzB,IAAI,CAACC,gCAAQ,MAAM,EAAE,OAAO,EAAE;CAgB9B,OAdiB,MAAM,QAAmB,QAAQ,YAAY;EAC5D,IAAI,CAACD,8BAAM,QAAQ,EACjB,IAAIC,gCAAQ,QAAQ,EAAE;GACpB,MAAM,gBAAgB,eAAe,QAAQ;GAC7C,IAAI,iBAAiB,CAACC,mCAAa,cAAc,EAC/C,OAAO,KAAK,cAAc;SAG5B,OAAO,KAAK,QAAQ;EAGxB,OAAO;IACN,EAAE,CAEU;;;;;ACSjB,SAAgB,yBACd,OACA,UAAoD,EAAE,EACtD;CACA,4CAAoB,SAAS,EAC3B,UAAU,EAAE,aAAa,gBACvB,oDAAoD,UAAU,sBAAsB,YAAY,MACnG,CAAC;CAEF,MAAM,MAAMC,mCAAW,SAAS,qBAAqB,GACjD,QAAQ,qBACR;CAEJ,wCAAgB,KAAK,EACnB,UAAU,EAAE,aAAa,gBACvB,qGAAqG,UAAU,sBAAsB,YAAY,MACpJ,CAAC;CAEF,IAAIC,gCAAQ,MAAM,EAAE;EAElB,MAAM,SAAS,MAAM,KAAK,QAAQ,MAAM;GAEtC,IAAIC,iCAAS,EAAE,IAAIC,0BAAS,EAAE,IAAIC,kCAAU,EAAE,IAAIC,0BAAS,EAAE,EAC3D,OAAO,OAAO,EAAE;GAGlB,OAAOC,+BAAO,EAAE,GAAG,OAAO;IAC1B;EAGF,IAAI,KAAK,OAAO,eAAe,OAAO;EAEtC,OAAO"}
+{"version":3,"file":"toStringArrayUnRecursive-DJ8JBO3N.cjs","names":["isNil","isArray","isEmptyArray","hasOwnProp","isArray","isString","isFinite","isBoolean","isBigInt","isNull"],"sources":["../src/conversions/arrays/transforms/filterNilArray.ts","../src/conversions/arrays/casts/toStringArrayUnRecursive.ts"],"sourcesContent":["import type {\n  FilterNilArray,\n  FilterNilArrayFromTuple,\n  PreserveMutability\n} from \"./_private/filterNilArray.types\";\n\nimport { isNil } from \"@/predicates/is/isNil\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isEmptyArray } from \"@/predicates/is/isEmptyArray\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `filterNilArray`.***\n * ---------------------------------------------\n * **Removes `null` and `undefined` values from an array, including nested arrays.**\n * - **Behavior:**\n *    - Returns `undefined` if the input is explicitly `undefined` or `null`.\n *    - Returns `[]` if input is empty or all elements are removed after filtering.\n *    - Recursively filters nested arrays while preserving structure.\n *    - Ensures proper type inference for safer downstream operations.\n * @template A - The type of elements in the array.\n * @param {T[]|null|undefined} input - The array to be filtered.\n * @returns {T[] | undefined} A new array with `null` and `undefined` values removed,\n * or `undefined` if the input is explicitly `undefined` or `null`.\n * @example\n * ```ts\n * filterNilArray([1, null, 2, undefined, 3]);\n * // ➔ [1, 2, 3]\n * filterNilArray([null, undefined]);\n * // ➔ []\n * filterNilArray(undefined);\n * // ➔ undefined\n * filterNilArray(null);\n * // ➔ undefined\n * filterNilArray([]); // or\n * filterNilArray([[[]]]); // or\n * filterNilArray([[[],undefined,null]]);\n * // ➔ []\n * filterNilArray([1, [null, 2, [undefined, 3]]]);\n * // ➔ [1, [2, [3]]]\n * ```\n */\nexport function filterNilArray(input: null | undefined): undefined;\nexport function filterNilArray<A extends readonly unknown[]>(\n  input: A\n): PreserveMutability<A, FilterNilArrayFromTuple<A>>;\nexport function filterNilArray<A extends readonly unknown[]>(\n  input: A | null | undefined\n): PreserveMutability<A, FilterNilArrayFromTuple<A>> | undefined;\nexport function filterNilArray<A>(\n  input: (A | null | undefined)[] | null | undefined\n): FilterNilArray<A> | undefined;\nexport function filterNilArray(\n  input: readonly unknown[] | null | undefined\n): unknown[] | undefined;\nexport function filterNilArray(input: unknown[]): unknown[];\nexport function filterNilArray(input: unknown): unknown {\n  if (isNil(input)) return undefined;\n  if (!isArray(input)) return [];\n\n  const filtered = input.reduce<unknown[]>((output, element) => {\n    if (!isNil(element)) {\n      if (isArray(element)) {\n        const cleanedNested = filterNilArray(element);\n        if (cleanedNested && !isEmptyArray(cleanedNested)) {\n          output.push(cleanedNested);\n        }\n      } else {\n        output.push(element);\n      }\n    }\n    return output;\n  }, []);\n\n  return filtered;\n}\n","import type {\n  ToStringArrayUnRecursiveOptions,\n  ToStringArrayUnRecursiveReturn\n} from \"./toStringArrayUnRecursive.types\";\n\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isFinite } from \"@/predicates/is/isFinite\";\nimport { isBigInt } from \"@/predicates/is/isBigInt\";\nimport { isBoolean } from \"@/predicates/is/isBoolean\";\nimport { hasOwnProp } from \"@/predicates/has/hasOwnProp\";\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\nimport { assertIsPlainObject } from \"@/assertions/objects/assertIsPlainObject\";\n\nimport { filterNilArray } from \"../transforms/filterNilArray\";\n\n/** ---------------------------------------------\n * * ***Utility: `toStringArrayUnRecursive`.***\n * ---------------------------------------------\n * **Converts all values in a flat array into string representations.**\n * - **Behavior:**\n *    - Only processes **flat arrays** (non-recursive).\n *    - Supports input values: `string`, `number`, `bigint`, `boolean`,\n *      `null`, `undefined`.\n *    - Invalid values (`null` and `undefined`) can be **removed** or **kept**\n *      depending on the option.\n *    - Other unsupported types will be converted to `undefined` (and removed\n *      if `removeInvalidValue=true`).\n * - **ℹ️ Note:**\n *    - _For recursive / nested arrays, use ***`toStringDeep` utility function*** instead._\n * @template T - Element type of the input array.\n * @template R - Whether invalid values should be removed (`true`) or kept (`false`).\n * @param {Array<string | number | bigint | boolean | null | undefined> | null | undefined} [array] - The array to convert, returns `undefined` if not an array.\n * @param {ToStringArrayUnRecursiveOptions<RemoveInvalidValue>} [options] - Options to control transformation behavior, defaults to `{ removeInvalidValue: true }`.\n * @param {RemoveInvalidValue extends true ? boolean : boolean} [options.removeInvalidValue=true] Whether to remove invalid values (`null`, `undefined`, or unsupported types), default: `true`.\n * @returns {RemoveInvalidValue extends true ? string[] : (string | null | undefined)[]} A new array of string representations, with invalid values optionally removed.\n * @example\n * ```ts\n * // Convert numbers and strings\n * toStringArrayUnRecursive([1, 2, '3']);\n * // ➔ ['1', '2', '3']\n * // Remove null and undefined\n * toStringArrayUnRecursive([1, null, undefined, 'abc'], {\n *   removeInvalidValue: true\n * });\n * // ➔ ['1', 'abc']\n * // Keep null and undefined\n * toStringArrayUnRecursive([1, null, undefined, 'abc'], {\n *   removeInvalidValue: false\n * });\n * // ➔ ['1', null, undefined, 'abc']\n * // Convert boolean and bigint\n * toStringArrayUnRecursive([true, false, 10n]);\n * // ➔ ['true', 'false', '10']\n * // Not an array ➔ returns undefined\n * toStringArrayUnRecursive(null);\n * // ➔ undefined\n * toStringArrayUnRecursive(undefined);\n * // ➔ undefined\n * toStringArrayUnRecursive(1);\n * // ➔ undefined\n * toStringArrayUnRecursive(\"string\");\n * // ➔ undefined\n * ```\n */\nexport function toStringArrayUnRecursive(\n  array?: undefined | null,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): undefined;\nexport function toStringArrayUnRecursive(\n  array?: Array<never>,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): [];\nexport function toStringArrayUnRecursive<T, R extends boolean = true>(\n  array?: Array<T> | readonly T[] | null,\n  options?: ToStringArrayUnRecursiveOptions<R>\n): ToStringArrayUnRecursiveReturn<T, R>;\nexport function toStringArrayUnRecursive<T = unknown>(\n  array?: T,\n  options?: ToStringArrayUnRecursiveOptions<boolean>\n): undefined;\nexport function toStringArrayUnRecursive<T>(\n  array?: Array<T> | readonly T[] | null,\n  options: ToStringArrayUnRecursiveOptions<boolean> = {}\n) {\n  assertIsPlainObject(options, {\n    message: ({ currentType, validType }) =>\n      `Second parameter (\\`options\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const riv = hasOwnProp(options, \"removeInvalidValue\")\n    ? options.removeInvalidValue\n    : true;\n\n  assertIsBoolean(riv, {\n    message: ({ currentType, validType }) =>\n      `Parameter \\`removeInvalidValue\\` property of the \\`options\\` (second parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  if (isArray(array)) {\n    // Convert each item in the array to a string, or null/undefined if it's not a valid value.\n    const result = Array.from(array, (x) => {\n      // Convert finite number, boolean, bigInt or string to string\n      if (isString(x) || isFinite(x) || isBoolean(x) || isBigInt(x))\n        return String(x);\n\n      // Handle null or undefined values\n      return isNull(x) ? null : undefined;\n    });\n\n    // Remove invalid values (null, undefined) if specified in options\n    if (riv) return filterNilArray(result);\n\n    return result;\n  }\n\n  // Return undefined if no array is provided\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAuDA,SAAgB,eAAe,OAAyB;CACtD,IAAIA,8BAAM,MAAM,EAAE,OAAO;CACzB,IAAI,CAACC,gCAAQ,MAAM,EAAE,OAAO,EAAE;CAgB9B,OAdiB,MAAM,QAAmB,QAAQ,YAAY;EAC5D,IAAI,CAACD,8BAAM,QAAQ,EACjB,IAAIC,gCAAQ,QAAQ,EAAE;GACpB,MAAM,gBAAgB,eAAe,QAAQ;GAC7C,IAAI,iBAAiB,CAACC,mCAAa,cAAc,EAC/C,OAAO,KAAK,cAAc;SAG5B,OAAO,KAAK,QAAQ;EAGxB,OAAO;IACN,EAAE,CAEU;;;;;ACSjB,SAAgB,yBACd,OACA,UAAoD,EAAE,EACtD;CACA,4CAAoB,SAAS,EAC3B,UAAU,EAAE,aAAa,gBACvB,oDAAoD,UAAU,sBAAsB,YAAY,MACnG,CAAC;CAEF,MAAM,MAAMC,mCAAW,SAAS,qBAAqB,GACjD,QAAQ,qBACR;CAEJ,wCAAgB,KAAK,EACnB,UAAU,EAAE,aAAa,gBACvB,qGAAqG,UAAU,sBAAsB,YAAY,MACpJ,CAAC;CAEF,IAAIC,gCAAQ,MAAM,EAAE;EAElB,MAAM,SAAS,MAAM,KAAK,QAAQ,MAAM;GAEtC,IAAIC,iCAAS,EAAE,IAAIC,0BAAS,EAAE,IAAIC,kCAAU,EAAE,IAAIC,0BAAS,EAAE,EAC3D,OAAO,OAAO,EAAE;GAGlB,OAAOC,+BAAO,EAAE,GAAG,OAAO;IAC1B;EAGF,IAAI,KAAK,OAAO,eAAe,OAAO;EAEtC,OAAO"}

package/dist/urls/index.cjs

@@ -2,15 +2,15 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.13.0-beta.2`
+*  Version: `3.13.0-beta.3`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_punyCode = require('../punyCode-DmTsB7q_.cjs');
-const require_urls = require('../urls-DCyx8Wpk.cjs');
+const require_punyCode = require('../punyCode-DaBFrfga.cjs');
+const require_urls = require('../urls-DCjjZNTH.cjs');
 exports.constructURL = require_urls.constructURL;
 exports.extractURLs = require_urls.extractURLs;
 exports.formatEnvPort = require_urls.formatEnvPort;

package/dist/urls/index.d.cts

@@ -2,7 +2,7 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.13.0-beta.2`
+*  Version: `3.13.0-beta.3`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================

package/dist/urls/index.d.ts

@@ -2,7 +2,7 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.13.0-beta.2`
+*  Version: `3.13.0-beta.3`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================

package/dist/urls/index.js

@@ -2,11 +2,11 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.13.0-beta.2`
+*  Version: `3.13.0-beta.3`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { t as punycodeUtilsJS } from "../punyCode-BeFYDjj0.js";
-import { a as extractURLs, i as normalizePathname, n as getPrefixPathname, o as constructURL, r as getFirstPrefixPathname, t as formatEnvPort } from "../urls-CoxDAoki.js";
+import { t as punycodeUtilsJS } from "../punyCode-GakZYPCT.js";
+import { a as extractURLs, i as normalizePathname, n as getPrefixPathname, o as constructURL, r as getFirstPrefixPathname, t as formatEnvPort } from "../urls-DTndjYDD.js";
 export { constructURL, extractURLs, formatEnvPort, getFirstPrefixPathname, getPrefixPathname, normalizePathname, punycodeUtilsJS };

package/dist/{urls-DCyx8Wpk.cjs → urls-DCjjZNTH.cjs}

@@ -2,21 +2,21 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.13.0-beta.2`
+*  Version: `3.13.0-beta.3`
 *  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-amRiJHnh.cjs');
-const require_assertIsArray = require('./assertIsArray-BqjMoan3.cjs');
-const require_toStringArrayUnRecursive = require('./toStringArrayUnRecursive-D1mPM4wg.cjs');
-const require_safeStableStringify = require('./safeStableStringify-DRYQ56Dg.cjs');
-const require_isEmptyString = require('./isEmptyString-DI64RQCy.cjs');
-const require_isEmptyValue = require('./isEmptyValue-Cw6ovu7z.cjs');
-const require_isInteger = require('./isInteger-DPYjliLZ.cjs');
-const require_isValidDomain = require('./isValidDomain-BxyToAlh.cjs');
-const require_removeSpaces = require('./removeSpaces-C8mu_yp3.cjs');
+const require_assertIsBoolean = require('./assertIsBoolean-BKcvET7Z.cjs');
+const require_assertIsArray = require('./assertIsArray-DWsgvahU.cjs');
+const require_toStringArrayUnRecursive = require('./toStringArrayUnRecursive-DJ8JBO3N.cjs');
+const require_safeStableStringify = require('./safeStableStringify-DSwcrPll.cjs');
+const require_isEmptyString = require('./isEmptyString-CzY-9G-x.cjs');
+const require_isEmptyValue = require('./isEmptyValue-Ci3kVU4E.cjs');
+const require_isInteger = require('./isInteger-CCJhQ1Mx.cjs');
+const require_isValidDomain = require('./isValidDomain-CXWNcRo6.cjs');
+const require_removeSpaces = require('./removeSpaces-DhJ1haaH.cjs');
 const constructURL = (baseUrl, queryParams, removeParams) => {
 	if (require_assertIsBoolean.isString(baseUrl)) {
 		if (require_isEmptyString.isEmptyString(baseUrl)) throw new TypeError("First parameter (`baseUrl`) cannot be an empty-string.");
@@ -296,4 +296,4 @@ Object.defineProperty(exports, 'normalizePathname', {
     return normalizePathname;
   }
 });
-//# sourceMappingURL=urls-DCyx8Wpk.cjs.map
+//# sourceMappingURL=urls-DCjjZNTH.cjs.map

package/dist/{urls-DCyx8Wpk.cjs.map → urls-DCjjZNTH.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"urls-DCyx8Wpk.cjs","names":["isString","isEmptyString","normalizeString","isURL","getPreciseType","safeStableStringify","isUndefined","isNonEmptyString","isFunction","isEmptyValue","isNumber","isError","isNonEmptyString","isFunction","isNonEmptyString","getPreciseType","safeStableStringify","isUndefined","isSet","isArray","isNil","isString","isNull","removeSpaces","isValidDomain","isError","isNonEmptyString","getPreciseType","safeStableStringify","isArray","isString","isNil","isString","isArray","getPreciseType","isNull","isPlainObject","isInteger","safeStableStringify","isBoolean","isNonEmptyArray","joinLines","EOL","isNonEmptyString","isNonEmptyString","hasOwnProp","isBoolean","getPreciseType","isEmptyString"],"sources":["../src/urls/builders/constructURL.ts","../src/urls/extractors/extractURLs.ts","../src/urls/_private/NormalizePathnameError.ts","../src/urls/pathname/normalizePathname.ts","../src/urls/pathname/getFirstPrefixPathname.ts","../src/urls/pathname/getPrefixPathname.ts","../src/urls/utils/formatEnvPort.ts"],"sourcesContent":["import { isURL } from \"@/predicates/is/isURL\";\nimport { isError } from \"@/predicates/is/isError\";\nimport { isNumber } from \"@/predicates/is/isNumber\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isFunction } from \"@/predicates/is/isFunction\";\nimport { isUndefined } from \"@/predicates/is/isUndefined\";\nimport { isEmptyValue } from \"@/predicates/is/isEmptyValue\";\nimport { isEmptyString } from \"@/predicates/is/isEmptyString\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nimport { normalizeString } from \"@/strings/sanitizations/normalizeString\";\n\nimport { assertIsArray } from \"@/assertions/objects/assertIsArray\";\n\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\nimport { toStringArrayUnRecursive } from \"@/conversions/arrays/casts/toStringArrayUnRecursive\";\n\n/** ----------------------------------------------------------\n * * ***Type-Utility: `QueryParamPairs`.***\n * ----------------------------------------------------------\n * **Represents a non-empty array of key–value pairs.**\n * @description\n * Type for `queryParams` parameter, the second parameter of ***`constructURL` utility function***.\n * - **Behavior:**\n *    - Each inner tuple strictly follows the `[string, string | number]` shape.\n *    - Ensures the outer array contains **at least one pair** (non-empty).\n *    - Commonly used for URL construction parameters,\n *      query string segments, or other key–value structured data.\n * @example\n * // ✅ valid usage\n * const params: QueryParamPairs = [\n *   [\"foo\", 1],\n *   [\"bar\", \"baz\"]\n * ];\n * constructURL(\"https://example.com\", params);\n *\n * // ❌ invalid: must contain at least one item\n * const empty: QueryParamPairs = [];\n *\n * // ❌ invalid: key without value pairs.\n * const empty2: QueryParamPairs = [[\"key\"]];\n */\nexport type QueryParamPairs = [\n  [string, string | number],\n  ...[string, string | number][]\n];\n\n/** ---------------------------------\n * * ***Utility: `constructURL`.***\n * ---------------------------------\n * **Constructs a valid URL with optional query parameters and allows selective removal of duplicate parameters.**\n * @param {string | URL} baseUrl The base URL to build upon. Must include protocol (e.g., `\"https://\"`), `domain`, and may include port and existing query parameters.\n * @param {Iterable<[string, string]> | URLSearchParamsIterator<[string, string]> | QueryParamPairs} [queryParams]\n *   Additional query parameters to append or overwrite on the URL.\n *   - Accepts any iterable of key-value pairs (like `new URLSearchParams().entries()` and `[[string, string | number]...]`).\n * @param {string[]} [removeParams]\n *   A list of query parameter keys to remove from the final URL, whether they were in the base URL or provided queryParams.\n * @returns {URL} A new URL object representing the constructed URL with merged and cleaned query parameters.\n * @throws **{@link TypeError | `TypeError`}** if `baseUrl` is not a valid non-empty string or URL object, or if `queryParams` is not iterable, or if `removeParams` is not an array of strings.\n * @example\n *    1. #### Basic Usage:\n * ```ts\n *   constructURL(\n *     \"https://example.com/path\",\n *     new URLSearchParams({ a: \"1\", b: \"2\" }).entries()\n *   );\n *   // ➔ URL { href: \"https://example.com/path?a=1&b=2\", ... }\n * ```\n *    2. #### Remove parameters from Base and Added:\n * ```ts\n *   // with new URLSearchParams({ ... }).entries();\n *   constructURL(\n *     \"https://example.com/path?foo=1&bar=2\",\n *     new URLSearchParams({ bar: \"ignored\", baz: \"3\" }).entries(),\n *     [\"bar\"]\n *   );\n *   // ➔ URL { href: \"https://example.com/path?foo=1&baz=3\", ... }\n *\n *   // with [[string, string | number]...]\n *   constructURL(\n *     \"https://example.com/path?foo=1&bar=2\",\n *     [[\"bar\", \"ignored\"],[\"baz\", 3]],\n *     [\"bar\"]\n *   );\n *   // ➔ URL { href: \"https://example.com/path?foo=1&baz=3\", ... }\n *\n *   const params: QueryParamPairs = [\n *     [\"foo\", 1],\n *     [\"bar\", 2],\n *     [\"baz\", 3]\n *   ];\n *\n *   constructURL(\"https://example.com\", params, [\"bar\"]);\n *   // ➔ URL { href: \"https://example.com/?foo=1&baz=3\", ... }\n * ```\n */\nexport const constructURL = (\n  baseUrl: string | URL,\n  queryParams?:\n    | URLSearchParamsIterator<[string, string | number]>\n    | QueryParamPairs,\n  removeParams?: string[]\n): URL => {\n  if (isString(baseUrl)) {\n    if (isEmptyString(baseUrl)) {\n      throw new TypeError(\n        \"First parameter (`baseUrl`) cannot be an empty-string.\"\n      );\n    }\n    baseUrl = normalizeString(baseUrl);\n  } else if (!isURL(baseUrl)) {\n    throw new TypeError(\n      `First parameter (\\`baseUrl\\`) must be of type an URL instance or a \\`string\\` and a non empty-string, but received: \\`${getPreciseType(\n        baseUrl\n      )}\\`, with current value: \\`${safeStableStringify(baseUrl, {\n        keepUndefined: true\n      })}\\`.`\n    );\n  }\n\n  // Check removeParams\n  if (!isUndefined(removeParams)) {\n    assertIsArray(removeParams, {\n      message: ({ currentType, validType }) =>\n        `Third parameter (\\`removeParams\\`) must be of type \\`${validType} of strings\\`, but received: \\`${currentType}\\`.`\n    });\n\n    if (!removeParams.every((param) => isNonEmptyString(param))) {\n      throw new TypeError(\n        \"Third parameter (`removeParams`) must be of type `array` and contains `string` only and non empty-string.\"\n      );\n    }\n  }\n\n  try {\n    // Check queryParams\n    if (\n      !isUndefined(queryParams) &&\n      !isFunction(queryParams[Symbol.iterator])\n    ) {\n      throw new TypeError(\n        `Second parameter (\\`queryParams\\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \\`${getPreciseType(\n          queryParams\n        )}\\`, with value: \\`${safeStableStringify(queryParams, {\n          keepUndefined: true\n        })}\\`.`\n      );\n    }\n\n    const urlInstance = new URL(baseUrl);\n\n    // Add query parameters if provided\n    if (!isUndefined(queryParams)) {\n      const paramObject = Object.fromEntries(queryParams);\n\n      if (!isEmptyValue(paramObject)) {\n        // existing params\n        const mergedParams = new URLSearchParams(urlInstance.search);\n\n        // add / overwrite from queryParams\n        for (const [key, value] of Object.entries(paramObject)) {\n          if (\n            !isNonEmptyString(value) &&\n            !isNumber(value, { includeNaN: true })\n          ) {\n            throw new TypeError(\n              `Second parameter (\\`queryParams\\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \\`${getPreciseType(\n                queryParams\n              )}\\`, with value: \\`${safeStableStringify(queryParams, {\n                keepUndefined: true\n              })}\\`.`\n            );\n          }\n\n          mergedParams.set(key, String(value));\n        }\n\n        // Remove specific query parameters if needed\n        if (removeParams?.length) {\n          toStringArrayUnRecursive(removeParams).map((paramKey) => {\n            mergedParams.delete(paramKey);\n          });\n        }\n\n        urlInstance.search = mergedParams.toString();\n      }\n    }\n\n    // Remove query parameters directly from URL if needed\n    removeParams?.forEach((param) => urlInstance.searchParams.delete(param));\n\n    return urlInstance;\n  } catch (error) {\n    if (isError(error)) throw error;\n\n    throw new Error(\n      \"Failed to construct a valid URL in `constructURL()`, Error:\" + error,\n      { cause: error }\n    );\n  }\n};\n","import { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\n/** ---------------------------------\n * * ***Utility: `extractURLs`.***\n * ---------------------------------\n * **Extracts all valid URLs from a given string.**\n * @description\n * This function scans the input url and returns an array of URLs\n * that match a valid `http` or `https` format.\n * - **Supports:**\n *    - Internationalized domain names (IDN), e.g. `https://münich.de`\n *    - Unicode & emoji paths, e.g. `https://example.com/🎉/page`\n *    - Long URLs with multiple queries & fragments, e.g. `https://example.com/path?foo=1#hash`\n * - **Ignores:**\n *    - Non-string inputs\n *    - Empty or whitespace-only strings\n *    - Non-HTTP(S) protocols (ftp, mailto, etc)\n * @param {string | null | undefined} url - The input string containing potential URLs.\n * @returns {string[] | null} An array of extracted URLs or `null` if no URLs are found.\n * @example\n * extractURLs(\"Visit https://example.com and https://例子.公司\");\n * // ➔ [\"https://example.com\", \"https://例子.公司\"]\n * extractURLs(\"Here: https://example.com/🎉/page\");\n * // ➔ [\"https://example.com/🎉/page\"]\n * extractURLs(\"ftp://example.com http://example.com\");\n * // ➔ [\"http://example.com\"]\n */\nexport const extractURLs = (\n  url: string | null | undefined\n): string[] | null => {\n  if (!isNonEmptyString(url)) return null;\n\n  let decoded;\n  try {\n    decoded = decodeURIComponent(url);\n  } catch {\n    return null;\n  }\n\n  // Core regex with lookahead\n  const urlPattern = /https?:\\/\\/.*?(?=https?:\\/\\/|\\s|$)/g;\n  const matches = decoded.match(urlPattern);\n  if (!matches) return null;\n\n  // Cleanup trailing punctuation and validation protocol\n  const cleaned = matches\n    .map((url) => url.replace(/[.,;:!?)]*$/, \"\"))\n    .filter((url) => {\n      try {\n        const u = new URL(url);\n        return u.protocol === \"http:\" || u.protocol === \"https:\";\n      } catch {\n        return false;\n      }\n    });\n\n  return cleaned.length ? cleaned : null;\n};\n","import { isFunction } from \"@/predicates/is/isFunction\";\n\n/** ---------------------------------\n * * ***Custom Error for Pathname Normalization Failures***\n * ---------------------------------\n */\nexport class NormalizePathnameError extends Error {\n  /** ---------------------------------\n   * * ***The original error that triggered this normalization failure.***\n   * ---------------------------------\n   *\n   * **Always available for backward compatibility.**\n   */\n  public readonly originalError: Error;\n\n  constructor(message: string, originalError: Error) {\n    // Pass a `cause` option if the runtime supports it (ignored by older engines).\n    super(message, isFunction(Error) ? { cause: originalError } : undefined);\n\n    this.name = \"NormalizePathnameError\";\n    this.originalError = originalError;\n\n    // Preserve stack trace when available (Node.js & modern browsers).\n    if (isFunction(Error.captureStackTrace)) {\n      Error.captureStackTrace(this, NormalizePathnameError);\n    } else {\n      // Fallback for very old environments.\n      this.stack = new Error(message).stack;\n    }\n  }\n\n  /** ---------------------------------\n   * * ***Safe JSON representation for logging or IPC.***\n   * ---------------------------------\n   */\n  toJSON() {\n    return {\n      name: this.name,\n      message: this.message,\n      stack: this.stack,\n      originalError: {\n        name: this.originalError.name,\n        message: this.originalError.message,\n        stack: this.originalError.stack\n      }\n    };\n  }\n}\n","import type { OverrideTypes, Prettify } from \"@rzl-zone/ts-types-plus\";\n\nimport { isSet } from \"@/predicates/is/isSet\";\nimport { isNil } from \"@/predicates/is/isNil\";\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isError } from \"@/predicates/is/isError\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isValidDomain } from \"@/predicates/is/isValidDomain\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\nimport { assertIsPlainObject } from \"@/assertions/objects/assertIsPlainObject\";\n\nimport { removeSpaces } from \"@/strings/sanitizations/removeSpaces\";\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\n\nimport { NormalizePathnameError } from \"../_private/NormalizePathnameError\";\nimport { isUndefined } from \"@/predicates/is/isUndefined\";\n\n/** Options when `keepNullable` is false (default).\n *\n * Returns `defaultPath` if `pathname` is empty or invalid.\n */\ntype UnKeepNullableOptions = {\n  /** * ***Fallback value returned if `pathname` is empty-string or invalid.***\n   *\n   * Must be a **`non-empty string`**, defaultValue: `\"/\"`.\n   *\n   * @default \"/\"\n   */\n  defaultPath?: string;\n\n  /** * ***Whether to preserve `null` or `undefined`, defaultValue: `false`.***\n   *\n   * @default false\n   */\n  keepNullable?: false;\n};\n\n/** Options when `keepNullable` is true.\n *\n * Preserves `null` or `undefined` instead of returning `defaultPath`.\n */\ntype KeepNullableOptions = {\n  /** * ***Fallback path is ignored when `keepNullable` is true **(except if\n   * `pathname` is empty-string or invalid, even this `true`)**,\n   * defaultValue: `\"/\"`.***\n   *\n   * @default \"/\"\n   */\n  defaultPath?: string;\n\n  /** * ***Preserve `null` or `undefined` as-is if `true` (defaultValue: `false`).***\n   *\n   * - ***⚠️ Notes:***\n   *      - Keep returning `defaultPath` if `pathname` is empty-string, even this `true`.\n   *\n   * **Must be `true` in this type.**\n   *\n   * @default false\n   */\n  keepNullable?: true;\n};\n\ntype MainNormalizePathnameOptions = {\n  /** --------------------------------------------------------\n   * * ***Preserve trailing slash at the end of the normalized pathname, defaultValue: `false`.***\n   * --------------------------------------------------------\n   *\n   * @default `false`\n   */\n  keepTrailingSlash?: boolean;\n\n  /** --------------------------------------------------------\n   * * ***Allow special localhost domain at the beginning of the pathname.***\n   * --------------------------------------------------------\n   * @description\n   * If `true`, the first segment of the pathname that is `/localhost` or `localhost`\n   * (with or without a port, e.g., `localhost:3000`) will be treated as a special domain\n   * and **removed** from the normalized pathname.\n   *\n   * - **Examples (`localhostDomain: true`)**:\n   *    - `\"/localhost/path\"` ➔ `\"/path\"`\n   *    - `\"localhost:3000/path\"` ➔ `\"/path\"`\n   *    - `\"localhost\"` ➔ `\"/\"` (entire path removed)\n   *\n   * - Only the **first path segment** is affected. Any subsequent occurrences of `\"localhost\"`\n   *   will remain intact.\n   *\n   * @default false\n   */\n  localhostDomain?: boolean;\n\n  /**\n   * --------------------------------------------------------\n   * * ***Custom list of file extensions that prevent the first path segment from being treated as a domain.***\n   * --------------------------------------------------------\n   *\n   * **Description:**\n   * - The first segment of a pathname is often interpreted as a domain (e.g., `example.com`).\n   * - If this first segment ends with any of the extensions listed here, it will **not** be considered a domain,\n   *   and will instead be preserved as part of the relative path.\n   * - This is useful for cases where filenames appear at the start of a path and you want them treated as relative paths,\n   *   such as `\"image.png?version=2\"` or `\"archive.tar.gz#download\"`.\n   * - Only the **first path segment** is affected; all other segments are processed normally.\n   * - **Ignored** if:\n   *    1. The pathname starts with a full URL protocol (`http://` or `https://`), e.g., `\"https://example.com/file.png\"`.\n   *    2. The first path segment is already a valid domain, e.g., `\"example.com/image.png\"`.\n   *\n   * **Type & Validation:**\n   * - Must be a `Set<string>` or `string[]`.\n   * - Each string **must include the leading dot**, e.g., `.png`, `.tar.gz`.\n   * - Multi-part extensions (like `.tar.gz`, `.tar.bz`) are supported.\n   * - Throws a **TypeError** if:\n   *    1. The type is not a `Set<string>` or `string[]`.\n   *    2. Any string in the array/set is empty.\n   *    3. Any string does not start with a dot (`.`).\n   *\n   * **Usage Notes:**\n   * - Only applied when the first segment is otherwise domain-like **and** pathname is relative or domain-like without protocol.\n   * - Query strings (`?x=1`) and hash fragments (`#section`) are preserved.\n   *\n   * **Examples (relative paths, option active):**\n   * ```ts\n   * normalizePathname(\"image.png?version=2\", {\n   *   ignoreDomainExtensions: [\".png\", \".jpg\"]\n   * });\n   * // ➔ \"/image.png?version=2\"\n   *\n   * normalizePathname(\"archive.tar.gz#download\", {\n   *   ignoreDomainExtensions: new Set([\".tar.gz\"])\n   * });\n   * // ➔ \"/archive.tar.gz#download\"\n   *\n   * normalizePathname(\"script.js?module=true#top\", {\n   *   ignoreDomainExtensions: [\".js\"]\n   * });\n   * // ➔ \"/script.js?module=true#top\"\n   * ```\n   *\n   * **Examples (full URL or explicit domain - option ignored):**\n   * ```ts\n   * normalizePathname(\"https://example.com/image.png?version=2\", {\n   *   ignoreDomainExtensions: [\".png\"]\n   * });\n   * // ➔ \"/image.png?version=2\"  // URL is parsed normally; ignoreDomainExtensions has no effect\n   *\n   * normalizePathname(\"example.com/script.js?module=true#top\", {\n   *   ignoreDomainExtensions: [\".js\"]\n   * });\n   * // ➔ \"/script.js?module=true#top\"  // domain recognized; option ignored\n   * ```\n   *\n   * **Notes:**\n   * - Only the **first path segment** is checked.\n   * - Prevents false-positive domain stripping for filenames that look like domains.\n   * - Throws **TypeError** if invalid type or invalid string is provided.\n   *\n   * @default undefined (feature inactive if not provided)\n   */\n  ignoreDomainExtensions?: Set<string> | string[];\n};\n\n/** Options for main `normalizePathname`.\n *\n * Combines `UnKeepNullableOptions` or `KeepNullableOptions` with trailing slash control.\n */\ntype NormalizePathnameOptions = Prettify<\n  MainNormalizePathnameOptions & (UnKeepNullableOptions | KeepNullableOptions)\n>;\n\ntype NormalizePathnameOptionsKeepNullableTrue = MainNormalizePathnameOptions &\n  KeepNullableOptions;\ntype NormalizePathnameOptionsKeepNullableFalse = MainNormalizePathnameOptions &\n  UnKeepNullableOptions;\n\ntype ResUnKeepNullable<T> = T extends undefined\n  ? string\n  : T extends null\n    ? string\n    : T extends null | undefined\n      ? string\n      : string;\n\ntype ResKeepNullable<T> = T extends string\n  ? string\n  : T extends undefined\n    ? undefined\n    : T extends null\n      ? null\n      : T extends null | undefined\n        ? null | undefined\n        : string | null | undefined;\n\n/** --------------------------------------------------------\n * * ***Utility: `normalizePathname`.***\n * --------------------------------------------------------\n *\n * - **Description:**\n *    Normalizes any pathname or URL string to a clean, predictable format.\n *    Useful for routing, file paths, and URL handling.\n *    - Handles:\n *      - Leading/trailing spaces\n *      - Internal spaces in path segments\n *      - Redundant slashes (`//`)\n *      - Full URLs vs relative paths\n *      - Query (`?`) and hash (`#`) preservation\n *      - Unicode & emoji characters\n *      - Optional nullable preservation (`keepNullable`)\n *      - Optional trailing slash preservation (`keepTrailingSlash`)\n *      - Optional removal of localhost first segment (`localhostDomain`)\n *      - Prevention of false-positive domain stripping (`ignoreDomainExtensions`)\n *\n * - **Key Steps Internally:**\n *    1. Validate `options` (plain object, correct types)\n *    2. Validate `defaultPath` (non-empty string if `keepNullable` is false)\n *    3. Validate `ignoreDomainExtensions` (Set<string> | string[], each starts with `.`)\n *    4. Handle nullable:\n *       - Returns `null` / `undefined` if `keepNullable: true`\n *       - Otherwise uses `defaultPath`\n *    5. Trim spaces, remove internal spaces\n *    6. If full URL: parse using `URL` constructor\n *    7. If relative path or domain-like:\n *       - Remove `localhost`/`localhost:port` if `localhostDomain`\n *       - Remove first segment if domain-like and **not** in `ignoreDomainExtensions`\n *    8. Normalize slashes\n *    9. Ensure leading slash\n *    10. Handle trailing slash\n *    11. Decode Unicode safely\n *    12. Return normalized pathname + search + hash\n *\n * - **Error Handling:**\n *    - **TypeError**:\n *       - `defaultPath` invalid (non-string or empty) when `keepNullable: false`\n *       - `keepNullable`, `keepTrailingSlash`, `localhostDomain` not boolean\n *       - `ignoreDomainExtensions` invalid\n *    - **NormalizePathnameError** (extends ***Error***):\n *       - Invalid URL parsing\n *       - Unexpected normalization errors\n *\n * - **Options:**\n *    ```ts\n *    {\n *      // fallback if invalid path, default: \"/\"\n *      defaultPath?: string;\n *      // preserve null/undefined, default: false\n *      keepNullable?: boolean;\n *      // preserve trailing slash, default: false\n *      keepTrailingSlash?: boolean;\n *      // remove localhost:port first segment, default: false\n *      localhostDomain?: boolean;\n *      // prevent domain stripping, default: undefined\n *      ignoreDomainExtensions?: Set<string> | string[];\n *    }\n *    ```\n *\n * @example\n * // Basic path cleaning\n * normalizePathname(\"   /foo//bar  \");\n * // ➔ \"/foo/bar\"\n *\n * // Trailing slash control\n * normalizePathname(\"/api//v1//user//\", { keepTrailingSlash: true });\n * // ➔ \"/api/v1/user/\"\n * normalizePathname(\"/api//v1//user//\", { keepTrailingSlash: false });\n * // ➔ \"/api/v1/user\"\n *\n * // Full URL normalization\n * normalizePathname(\"https://example.com//path///to/resource?x=1#hash\");\n * // ➔ \"/path/to/resource?x=1#hash\"\n *\n * // Null/undefined preservation\n * normalizePathname(null, { keepNullable: true });\n * // ➔ null\n * normalizePathname(undefined, { keepNullable: true });\n * // ➔ undefined\n *\n * // Default fallback\n * normalizePathname(\"\", { defaultPath: \"/home\" });\n * // ➔ \"/home\"\n *\n * // Localhost removal\n * normalizePathname(\"localhost:3000/path/to/resource\", { localhostDomain: true });\n * // ➔ \"/path/to/resource\"\n *\n * // Prevent false-positive domain stripping\n * normalizePathname(\"archive.tar.gz#download\", { ignoreDomainExtensions: [\".tar.gz\"] });\n * // ➔ \"/archive.tar.gz#download\"\n * normalizePathname(\"image.png?version=2\", { ignoreDomainExtensions: [\".png\"] });\n * // ➔ \"/image.png?version=2\"\n *\n * // Emojis and Unicode\n * normalizePathname(\"🔥//deep//path///🚀\");\n * // ➔ \"/🔥/deep/path/🚀\"\n *\n * // Query-only or hash-only\n * normalizePathname(\"?page=2\");\n * // ➔ \"/?page=2\"\n * normalizePathname(\"#section3\");\n * // ➔ \"/#section3\"\n *\n * // Complex nested paths\n * normalizePathname(\"   //nested///folder//file.txt  \");\n * // ➔ \"/nested/folder/file.txt\"\n *\n * // Invalid URL triggers error\n * try {\n *   normalizePathname(\"http://\");\n * } catch (e) {\n *   // console.log(e);\n * }\n *\n * // First segment is domain but ignored due to extension\n * normalizePathname(\"example.tar.bz/file\", { ignoreDomainExtensions: [\".tar.bz\"] });\n * // ➔ \"/example.tar.bz/file\"\n */\nexport function normalizePathname<T>(\n  pathname: T,\n  options?: NormalizePathnameOptionsKeepNullableFalse\n): ResUnKeepNullable<T>;\nexport function normalizePathname<T>(\n  pathname: T,\n  options?: NormalizePathnameOptionsKeepNullableTrue\n): ResKeepNullable<T>;\nexport function normalizePathname(\n  pathname: unknown,\n  options: NormalizePathnameOptions = {\n    defaultPath: \"/\",\n    keepNullable: false\n  }\n): string | null | undefined {\n  assertIsPlainObject(options, {\n    message({ currentType, validType }) {\n      return `Second parameter (\\`options\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`;\n    }\n  });\n\n  const {\n    defaultPath = \"/\",\n    keepNullable = false,\n    keepTrailingSlash = false,\n    localhostDomain = false,\n    ignoreDomainExtensions = undefined\n  } = options;\n\n  // Validate defaultPath\n  if (!isNonEmptyString(defaultPath)) {\n    throw new TypeError(\n      `Parameter \\`defaultPath\\` property of the \\`options\\` (second parameter) must be of type \\`string\\` and not empty-string, but received: \\`${getPreciseType(\n        defaultPath\n      )}\\`, with value: \\`${safeStableStringify(defaultPath, {\n        keepUndefined: true\n      })}\\`.`\n    );\n  }\n\n  assertIsBoolean(keepNullable, {\n    message({ currentType, validType }) {\n      return `Parameter \\`keepNullable\\` property of the \\`options\\` (second parameter)  must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`;\n    }\n  });\n  assertIsBoolean(keepTrailingSlash, {\n    message({ currentType, validType }) {\n      return `Parameter \\`keepTrailingSlash\\` property of the \\`options\\` (second parameter)  must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`;\n    }\n  });\n  assertIsBoolean(localhostDomain, {\n    message({ currentType, validType }) {\n      return `Parameter \\`localhostDomain\\` property of the \\`options\\` (second parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`;\n    }\n  });\n\n  let ignoreDomainExtsSet: Set<string> | undefined;\n\n  if (!isUndefined(ignoreDomainExtensions)) {\n    if (!isSet(ignoreDomainExtensions) && !isArray(ignoreDomainExtensions)) {\n      throw new TypeError(\n        `Parameter \\`ignoreDomainExtensions\\` must be of type a \\`Set<string>\\` or \\`string[]\\`, but received: \\`${getPreciseType(\n          ignoreDomainExtensions\n        )}\\`.`\n      );\n    }\n\n    ignoreDomainExtsSet = isSet(ignoreDomainExtensions)\n      ? ignoreDomainExtensions\n      : new Set(ignoreDomainExtensions);\n\n    // validation every ext\n    let idx = 0;\n    for (const ext of ignoreDomainExtsSet) {\n      if (!isNonEmptyString(ext)) {\n        throw new TypeError(\n          `Parameter \\`ignoreDomainExtensions[${idx}]\\` must be a \\`string\\` and \\`non-empty string\\`, but received: \\`${safeStableStringify(\n            ext,\n            { keepUndefined: true }\n          )}\\`.`\n        );\n      }\n      if (!ext.startsWith(\".\")) {\n        throw new TypeError(\n          `Parameter \\`ignoreDomainExtensions[${idx}]\\` must start with a dot (.), but received: ${safeStableStringify(\n            ext,\n            { keepUndefined: true }\n          )}`\n        );\n      }\n      idx++;\n    }\n  }\n\n  try {\n    if (keepNullable && (isNil(pathname) || !isString(pathname))) {\n      if (isNull(pathname)) return null;\n      return undefined;\n    }\n\n    // If the pathname is invalid (null, undefined, or an empty string), return the default value, only if `keepNullable` is false\n    let currentPathName: string = isNonEmptyString(pathname)\n      ? pathname\n      : defaultPath;\n\n    // Trim spaces from the string (only trim leading and trailing spaces)\n    currentPathName = removeSpaces(currentPathName, { trimOnly: true }).replace(\n      /\\s+/g,\n      \"\"\n    ); // remove all space\n\n    currentPathName = stripLeadingDomain(currentPathName, {\n      keepTrailingSlash,\n      localhostDomain,\n      ignoreDomainExtensions: ignoreDomainExtsSet\n    });\n\n    let _pathName: string = currentPathName;\n    let search = \"\";\n    let hash = \"\";\n\n    // relative path: extract search/hash manually\n    const searchIndex = currentPathName.indexOf(\"?\");\n    const hashIndex = currentPathName.indexOf(\"#\");\n\n    if (searchIndex !== -1) {\n      search = currentPathName.slice(\n        searchIndex,\n        hashIndex !== -1 ? hashIndex : undefined\n      );\n    }\n    if (hashIndex !== -1) {\n      hash = currentPathName.slice(hashIndex);\n    }\n\n    const endIndex = Math.min(\n      searchIndex !== -1 ? searchIndex : currentPathName.length,\n      hashIndex !== -1 ? hashIndex : currentPathName.length\n    );\n    _pathName = currentPathName.slice(0, endIndex);\n\n    // Normalize slashes\n    _pathName = \"/\" + _pathName.replace(/^\\/+/, \"\").replace(/\\/{2,}/g, \"/\");\n\n    // Trailing slash\n    if (!keepTrailingSlash && _pathName !== \"/\") {\n      _pathName = _pathName.replace(/\\/+$/, \"\");\n    }\n\n    // Decode Unicode safely\n    _pathName = decodeUnicodeSequences(_pathName);\n    search = decodeUnicodeSequences(search);\n    hash = decodeUnicodeSequences(hash);\n\n    return _pathName + search + hash;\n  } catch (error) {\n    // Handle any errors that occur during processing\n    throwError(error);\n  }\n}\n\n// --- Internal Helper Utils ----\n\n/**\n * @internal\n */\nconst decodeUnicodeSequences = (str: string): string => {\n  return str.replace(/(?:%(?:[0-9A-F]{2})){2,}/gi, (match) => {\n    try {\n      const decoded = decodeURIComponent(match);\n      // eslint-disable-next-line no-control-regex\n      if (/^[\\u0000-\\u007F]+$/.test(decoded)) return match;\n      // eslint-enable-next-line no-control-regex\n      return decoded;\n    } catch {\n      return match;\n    }\n  });\n};\n\n/**\n * @internal\n */\nconst stripLeadingDomain = (\n  path: string,\n  options: OverrideTypes<\n    MainNormalizePathnameOptions,\n    { ignoreDomainExtensions?: Set<string> }\n  >\n): string => {\n  let currentPath = path;\n\n  const { ignoreDomainExtensions, localhostDomain } = options;\n\n  // Full URL (protocol) -> only normalize path, ignore ignoreDomainExtensions\n  if (/^https?:\\/\\//i.test(currentPath)) {\n    try {\n      const url = new URL(currentPath);\n      currentPath =\n        url.pathname.replace(/^\\/+/, \"\").replace(/\\/{2,}/g, \"/\") +\n        url.search +\n        url.hash;\n\n      return ensureLeadingSlash(currentPath);\n    } catch (error) {\n      // fallback: keep as-is\n      // Handle any errors that occur during processing\n      throwError(error);\n    }\n  }\n\n  // relative path: remove leading slash\n  if (currentPath.startsWith(\"/\")) {\n    currentPath = currentPath.replace(/\\/{2,}/g, \"/\").slice(1);\n  }\n\n  // take first segment\n  const segments = currentPath.split(\"/\");\n  const firstPart = segments[0];\n  const domainPart = firstPart?.split(\":\")[0];\n\n  const isDomain = isValidDomain(domainPart, {\n    subdomain: true,\n    allowUnicode: true,\n    wildcard: true,\n    allowLocalhost: localhostDomain,\n    allowPort: true,\n    allowProtocol: true,\n    topLevel: false\n  });\n\n  // ignoreDomainExtensions only applies for relative/non-protocol paths\n  let hasIgnoredExtension = false;\n  if (ignoreDomainExtensions) {\n    for (const ext of ignoreDomainExtensions) {\n      if (firstPart?.endsWith(ext)) {\n        hasIgnoredExtension = true;\n        break;\n      }\n    }\n  }\n\n  if (isDomain && !hasIgnoredExtension) {\n    segments.shift(); // remove first segment\n  }\n\n  return ensureLeadingSlash(segments.join(\"/\"));\n};\n\n/**\n * @internal\n */\nconst ensureLeadingSlash = (path: string): string => {\n  if (!path.startsWith(\"/\")) path = \"/\" + path;\n  return path;\n};\n\n/**\n * @internal\n */\nconst throwError = (error: unknown): never => {\n  // Handle any errors that occur during processing\n  const err = isError(error)\n    ? error\n    : new Error(\"Unknown error from function `normalizePathname()`.\");\n  throw new NormalizePathnameError(\n    `Failed to normalize pathname in function \\`normalizePathname()\\`: ${err.message}`,\n    err\n  );\n};\n","import { isNil } from \"@/predicates/is/isNil\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\nimport { normalizePathname } from \"./normalizePathname\";\n\n/** --------------------------------------------------------\n * * ***Utility: `getFirstPrefixPathname`.***\n * --------------------------------------------------------\n * **Extract First Valid Prefix from Path Array or String.**\n * - **Main Purpose:**\n *    - This function helps extract the first valid URL prefix from various possible inputs.\n *    - It is especially useful in routing systems, middleware, or frontend apps that need to\n *      decide layout, active navigation, or permissions based on the first segment (or prefix) of a pathname.\n * - **Typical uses include:**\n *    - Determining which layout to render (e.g., `/admin` vs `/dashboard` vs `/`).\n *    - Highlighting the active menu item in a sidebar based on the current URL.\n *    - Enforcing route guards or access controls depending on the URL prefix.\n *    - Parsing multi-level route prefixes and selecting the most relevant one.\n * - **Behavior:**\n *    - It works as follows:\n *        - If `result` is an array of strings, it normalizes each element and returns\n *          the first non-root path (i.e., not just `\"/\"`).\n *        - If all items normalize to `\"/\"`,\n *          it returns the `defaultValue` (normalized).\n *        - If `result` is a single string, it normalizes it and returns it if valid,\n *          otherwise falls back to the normalized `defaultValue`.\n *        - If `result` is `null` or `undefined`, it returns the normalized `defaultValue`.\n * - **Validation & Errors:**\n *    - Throws a `TypeError` if:\n *      - `defaultValue` is not a string or empty-string.\n *      - `result` is an array that contains non-string elements.\n *      - `result` is a value that is neither `string`, `string[]`, nor `null`.\n * @example\n * 1. #### For React (*Determining layout*):\n * ```ts\n *   const prefix = getFirstPrefixPathname(\n *      getPrefixPathname(\n *        \"/admin/settings\",\n *        [\"/admin\", \"/dashboard\"]\n *      )\n *   );\n *\n *   if (prefix === \"/admin\") {\n *     renderAdminLayout();\n *   }\n * ```\n *\n * 2. #### Setting active menu state:\n * ```ts\n *   const activeSection = getFirstPrefixPathname([\"\", \"/dashboard\", \"/profile\"]);\n *   // ➔ \"/dashboard\"\n * ```\n *\n * 3. #### Providing graceful fallback:\n * ```ts\n *   const section = getFirstPrefixPathname([], \"/home\");\n *   // ➔ \"/home\"\n * ```\n * 4. #### ✅ Using with an Array of Pathnames:\n * ```ts\n *   const result = getPrefixPathname([\"   \", \"/dashboard\", \"/settings\"]);\n *   console.log(getFirstPrefixPathname(result));\n *   // ➔ \"/dashboard\"\n * ```\n *\n * 5. #### ✅ Using with Single String:\n * ```ts\n *   console.log(getFirstPrefixPathname(\"/profile/settings\"));\n *   // ➔ \"/profile/settings\"\n *   console.log(getFirstPrefixPathname(\"   \"));\n *   // ➔ \"/\"\n * ```\n *\n * 6. #### ✅ Fallback to Custom Default:\n * ```ts\n *   console.log(getFirstPrefixPathname([\"   \", \"\"], \"/home\"));\n *   // ➔ \"/home\"\n *   console.log(getFirstPrefixPathname(null, \"/dashboard\"));\n *   // ➔ \"/dashboard\"\n * ```\n *\n * 7. #### ✅ Throws on Invalid Input:\n * ```ts\n *   getFirstPrefixPathname([1, 2] as any); // ➔ ❌ throws TypeError\n *   getFirstPrefixPathname({} as any);     // ➔ ❌ throws TypeError\n *   getFirstPrefixPathname(null, \"   \");   // ➔ ❌ throws TypeError\n * ```\n * @param {string | string[] | null | undefined} result\n *  ***The pathname(s) to process, can be:***\n *    - A string path (e.g. `\"/profile\"`),\n *    - An array of string paths (e.g. `[\"   \", \"/dashboard\"]`),\n *    - Or `null`.\n * @param {string} [defaultValue=\"/\"]\n *  ***A custom default path to use if `result` is null or no valid prefix is found, behavior:***\n *      - Must be a string and non-empty string.\n *      - Defaults to `\"/\"`.\n * @returns {string}\n *   ***The first valid normalized pathname, or the normalized default.***\n * @throws **{@link TypeError | `TypeError`}** ***if `result` is not a valid type, or `defaultValue` is not a string or empty-string.***\n */\nexport const getFirstPrefixPathname = (\n  result: string | string[] | null | undefined,\n  defaultValue: string = \"/\"\n): string => {\n  if (!isNonEmptyString(defaultValue)) {\n    throw new TypeError(\n      `Second parameter (\\`defaultValue\\`) must be of type \\`string\\` and not an \\`empty-string\\`, but received: \\`${getPreciseType(\n        defaultValue\n      )}\\`, with value: \\`${safeStableStringify(defaultValue, {\n        keepUndefined: true\n      })}\\`.`\n    );\n  }\n\n  if (isArray(result)) {\n    if (!result.every((item) => isString(item))) {\n      throw new TypeError(\n        `First parameter (\\`result\\`) must be of type \\`string\\` or \\`array of string\\`, but received: \\`${getPreciseType(\n          result\n        )}\\`, with value: \\`${safeStableStringify(result, {\n          keepUndefined: true\n        })}\\`.`\n      );\n    }\n\n    for (const item of result) {\n      const normalized = normalizePathname(item);\n      if (normalized !== \"/\") {\n        return normalized;\n      }\n    }\n    return normalizePathname(defaultValue);\n  }\n\n  if (isString(result)) {\n    const normalized = normalizePathname(result);\n    return normalized !== \"/\" ? normalized : normalizePathname(defaultValue);\n  }\n\n  if (!isNil(result)) {\n    throw new TypeError(\n      `First parameter (\\`result\\`) must be of type \\`string\\`, \\`array-string\\`, \\`null\\` or \\`undefined\\`, but received: \\`${getPreciseType(\n        result\n      )}\\`.`\n    );\n  }\n\n  return normalizePathname(defaultValue);\n};\n","import { joinLines, EOL } from \"@rzl-zone/build-tools/utils\";\n\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isInteger } from \"@/predicates/is/isInteger\";\nimport { isBoolean } from \"@/predicates/is/isBoolean\";\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyArray } from \"@/predicates/is/isNonEmptyArray\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\n\nimport { normalizePathname } from \"./normalizePathname\";\n\ntype GetPrefixPathnameOptions = {\n  /** The number of levels to include in the prefix (default is `1`).\n   *\n   * - For example, with `levels = 2`, the function will return the first two parts of the URL.\n   *\n   * @default 1\n   */\n  levels?: number;\n  /** Whether to remove duplicates from the result if multiple URLs are passed (default is `true`).\n   *\n   * @default true\n   */\n  removeDuplicates?: boolean;\n};\n\n/** --------------------------------------------------------\n * * ***Utility: `getPrefixPathname`.***\n * --------------------------------------------------------\n * **Get Prefix from URL with Optional Base or Auto-detection (Supports String or Array of URLs).**\n * - **This function extracts the prefix from one or more URLs. It can either:**\n *    - Use a provided `base` string or an array of strings to check and return the matching prefix.\n *    - Automatically detect the prefix if no `base` is provided by analyzing the first part of the URL.\n * - **The function is flexible and can handle both scenarios:**\n *    1. **When the base is provided as a single string or an array of strings**:\n *        - The function will check if the URL starts with one of the provided base(s) and return the matching base.\n *    2. **When the base is not provided**:\n *        - The function will automatically detect the prefix by splitting the URL or using a regex.\n * - **Important Notes**:\n *    - If a base (or an array of bases) is provided, the URL must start with one of the given base(s).\n *    - If no base is provided, the function will attempt to detect the prefix automatically.\n *    - The `url` parameter can be either a string or an array of strings.\n *    - Supports deduplication of results (enabled by default).\n *    - Automatically returns a single string if only one unique result exists after processing.\n * @param {string|string[]} url\n *  ***The full URL(s) from which the prefix should be extracted, can be a `string` or an `array of strings`.***\n * @param {string|string[]|null} [base=null]\n *  ***The base URL(s) (e.g., `\"/settings\"`), behavior:***\n *    - It can be a `string`, an `array of strings`, or `null`.\n *    - If `provided`, it will be used to check the URL(s).\n *    - If `not provided`, the prefix will be auto-detected.\n * @param {GetPrefixPathnameOptions} [options]\n *  ***Additional options object:***\n *    - `levels` (default `1`): The number of segments to include when auto-detecting the prefix (e.g. `/foo/bar` for `levels: 2`).\n *    - `removeDuplicates` (default `true`): Whether to remove duplicate prefixes from the final array result.\n * @returns {string|string[]|null}\n *  ***Returns one of:***\n *    - A single string if only one unique prefix/base is found.\n *    - An array of strings if multiple different prefixes/bases are found.\n *    - `null` if no matching base is found when using `base`.\n * @throws **{@link TypeError | `TypeError`}**\n *  ***if:***\n *    - `url` is `not a string` or `not an array of strings`.\n *    - `base` is `not a string`, `array of strings`, or `null`.\n *    - `options` is `not an object`.\n *    - `levels` is `not a number`.\n *    - `removeDuplicates` is `not a boolean`.\n * @example\n * - #### ✅ **Correct Usage (With an Array of URLs and Base):**\n * ```ts\n *    const routes = [\n *      \"/settings/profile\",\n *      \"/settings/password\",\n *      \"/settings/other-path\",\n *      \"/other-path/xyz\",\n *    ];\n *\n *    // With base provided as a string\n *    routes.forEach(route => {\n *      console.log(getPrefixPathname(route, '/settings'));\n *      // ➔ \"/settings\"\n *    });\n *\n *    // With base provided as an array\n *    routes.forEach(route => {\n *      console.log(getPrefixPathname(route, ['/settings', '/admin']));\n *      // ➔ \"/settings\" or \"/admin\" depending on the current URL.\n *    });\n * ```\n * - #### ✅ **Correct Usage (With Single URL and Single Base):**\n * ```ts\n *    const result = getPrefixPathname(\"/settings/profile\", \"/settings\");\n *    console.log(result); // ➔ \"/settings\"\n * ```\n * - #### ✅ **Correct Usage (With Multiple URLs and Single Base):**\n * ```ts\n *    const result = getPrefixPathname(\n *      [\"/settings/profile\", \"/settings/password\"],\n *      \"/settings\"\n *    );\n *    console.log(result); // ➔ \"/settings\"\n *\n *    const result2 = getPrefixPathname(\n *      [\"/settings/profile\", \"/other/password\"],\n *      \"/other\"\n *    );\n *    console.log(result2); // ➔ \"/other\"\n * ```\n * - #### ✅ **Correct Usage (With Multiple URLs and Multiple Bases)**\n * ```ts\n *    const result = getPrefixPathname(\n *      [\"/settings/profile\", \"/admin/password\"],\n *      [\"/settings\", \"/admin\"]\n *    );\n *    console.log(result); // ➔ [\"/settings\", \"/admin\"]\n * ```\n * - #### ✅ **Auto-detection of Prefix**\n * ```ts\n *    const result = getPrefixPathname(\"/settings/profile\");\n *    console.log(result); // ➔ \"/settings\"\n *\n *    const result2 = getPrefixPathname(\n *      \"/settings/profile/info\",\n *      null,\n *      { levels: 2 }\n *    );\n *    console.log(result2); // ➔ \"/settings/profile\"\n * ```\n * - #### ✅ **Multiple URLs with Auto-detection**\n * ```ts\n *    const result = getPrefixPathname([\"/admin/profile\", \"/settings/password\"]);\n *    console.log(result); // ➔ [\"/admin\", \"/settings\"]\n * ```\n * - #### ✅ **Handling Duplicates**\n * ```ts\n *    const result = getPrefixPathname(\n *      [\"/settings/profile\", \"/settings/password\"],\n *      \"/settings\"\n *    );\n *    console.log(result); // ➔ \"/settings\" (deduped to single string)\n *\n *    const result2 = getPrefixPathname(\n *      [\"/settings/profile\", \"/settings/profile\"],\n *      \"/settings\",\n *      { removeDuplicates: false }\n *    );\n *    console.log(result2); // ➔ [\"/settings\", \"/settings\"]\n * ```\n * - #### ❌ **Incorrect Usage (URL Does Not Match Base)**\n * ```ts\n *    const result = getPrefixPathname(\"/other-path/profile\", \"/settings\");\n *    console.log(result); // ➔ null\n * ```\n */\nexport const getPrefixPathname = (\n  url: string | string[],\n  base: string | string[] | null = null,\n  options: GetPrefixPathnameOptions = {}\n): string | string[] | null => {\n  const errors: string[] = [];\n\n  if (!isString(url) && !isArray(url)) {\n    errors.push(\n      `First parameter (\\`url\\`) must be of type \\`string\\` or \\`array-string\\`, but received: \\`${getPreciseType(\n        url\n      )}\\`.`\n    );\n  }\n  if (!isString(base) && !isArray(base) && !isNull(base)) {\n    errors.push(\n      `Second parameter (\\`base\\`) must be of type \\`string\\`, \\`array-string\\` or \\`null\\`, but received: \\`${getPreciseType(\n        base\n      )}\\`.`\n    );\n  }\n  if (!isPlainObject(options)) {\n    errors.push(\n      `Second parameter (\\`options\\`) must be of type \\`plain-object\\`, but received: \\`${getPreciseType(\n        options\n      )}\\`.`\n    );\n  }\n\n  const { levels = 1, removeDuplicates = true } = options;\n\n  if (!isInteger(levels) || (isInteger(levels) && levels < 0)) {\n    errors.push(\n      `Parameter \\`levels\\` property of the \\`options\\` (second parameter) must be of type \\`integer-number\\` and minimum is \\`0\\`, but received: \\`${getPreciseType(\n        levels\n      )}\\`, with value: \\`${safeStableStringify(levels, {\n        keepUndefined: true\n      })}\\`.`\n    );\n  }\n  if (!isBoolean(removeDuplicates)) {\n    errors.push(\n      `Parameter \\`removeDuplicates\\` property of the \\`options\\` (second parameter) must be of type \\`boolean\\`, but received: \\`${getPreciseType(\n        removeDuplicates\n      )}\\`.`\n    );\n  }\n  if (isNonEmptyArray(errors)) {\n    throw new TypeError(\n      joinLines(\n        \"Invalid parameter(s) in `getPrefixPathname` function:\",\n        `- ${errors.join(`${EOL}- `)}`\n      )\n    );\n  }\n\n  // Helper function to process a single URL\n  function getLevel(singleUrl: string) {\n    // If no base is provided, detect the base automatically\n    const parts = normalizePathname(singleUrl).split(\"/\").filter(Boolean); // Split URL into parts\n\n    // Return the first `levels` parts as the prefix\n    return `/${parts.slice(0, levels).join(\"/\")}`;\n  }\n\n  // Helper function to process a single URL\n  function processUrl(singleUrl: string): string | null {\n    // If a base is provided, check if URL starts with one of the bases\n    if (base) {\n      singleUrl = normalizePathname(singleUrl);\n\n      if (isArray(base)) {\n        // Check if the URL starts with any of the base values in the array\n        for (const b of base) {\n          if (singleUrl.startsWith(normalizePathname(b))) {\n            // return normalizePathname(b); // Return the matching base if URL starts with it\n            return getLevel(singleUrl);\n          }\n        }\n      } else if (\n        isNonEmptyString(base) &&\n        singleUrl.startsWith(normalizePathname(base))\n      ) {\n        // If base is a single string, check if URL starts with it\n        // return normalizePathname(base); // Return the base if URL starts with it\n        return getLevel(singleUrl);\n      }\n      return null; // Return null if the URL does not match any base\n    }\n\n    return getLevel(singleUrl);\n  }\n\n  // If url is an array, process each URL and return an array of results\n  if (isArray(url)) {\n    const result = url.map(processUrl).filter((r): r is string => !isNull(r));\n\n    // Remove duplicates if required\n    const uniqueResult = removeDuplicates ? [...new Set(result)] : result;\n\n    // If all results are the same, return just the first one\n    if (uniqueResult.length === 1) {\n      return uniqueResult[0] ?? null;\n    }\n\n    return uniqueResult;\n  }\n\n  // If url is a single string, process it and return the result\n  return processUrl(url);\n};\n","import { isBoolean } from \"@/predicates/is/isBoolean\";\nimport { hasOwnProp } from \"@/predicates/has/hasOwnProp\";\nimport { isEmptyString } from \"@/predicates/is/isEmptyString\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\nimport { assertIsPlainObject } from \"@/assertions/objects/assertIsPlainObject\";\n\ntype FormatEnvPortOptions = {\n  /** Add prefix with a colon, defaultValue: `false`.\n   *\n   * @default false\n   */\n  prefixColon?: boolean;\n};\n\n/** -----------------------------------------------\n * * ***Utility: `formatEnvPort`.***\n * -----------------------------------------------\n * **Retrieves and formats an environment port variable.**\n * - **Behavior:**\n *    - Extracts only digits from the input.\n *    - If no digits found, returns an empty string.\n *    - By default does NOT prefix with a colon.\n *      - Use `{ prefixColon: true }` to prefix with a colon.\n * @param {string | null | undefined} envVar The environment variable string.\n * @param {FormatEnvPortOptions} [options] Optional object: `{ prefixColon?: boolean }`.\n * @returns {string} A string like `\":8080\"` or `\"8080\"`, or `\"\"` if no digits.\n * @throws **{@link TypeError | `TypeError`}** if `options` is not an object or `prefixColon` is not boolean.\n * @example\n * formatEnvPort(\"port:8080\");\n * // ➔ \"8080\"\n * formatEnvPort(\"port:8080\", { prefixColon: true });\n * // ➔ \":8080\"\n */\nexport const formatEnvPort = (\n  envVar: string | null | undefined,\n  options: FormatEnvPortOptions = {}\n): string => {\n  if (!isNonEmptyString(envVar)) return \"\"; // Handle empty string case\n\n  assertIsPlainObject(options, {\n    message: ({ currentType, validType }) =>\n      `Second parameter (\\`options\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const prefixColon = hasOwnProp(options, \"prefixColon\")\n    ? options.prefixColon\n    : false;\n\n  if (!isBoolean(prefixColon)) {\n    throw new TypeError(\n      `Parameter \\`prefixColon\\` property of the \\`options\\` (second parameter) must be of type \\`boolean\\`, but received: \\`${getPreciseType(\n        prefixColon\n      )}\\`.`\n    );\n  }\n\n  const digitsOnly = envVar.replace(/\\D+/g, \"\");\n  if (isEmptyString(digitsOnly)) return \"\";\n\n  return prefixColon ? `:${digitsOnly}` : digitsOnly;\n};\n"],"mappings":"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"}
+{"version":3,"file":"urls-DCjjZNTH.cjs","names":["isString","isEmptyString","normalizeString","isURL","getPreciseType","safeStableStringify","isUndefined","isNonEmptyString","isFunction","isEmptyValue","isNumber","isError","isNonEmptyString","isFunction","isNonEmptyString","getPreciseType","safeStableStringify","isUndefined","isSet","isArray","isNil","isString","isNull","removeSpaces","isValidDomain","isError","isNonEmptyString","getPreciseType","safeStableStringify","isArray","isString","isNil","isString","isArray","getPreciseType","isNull","isPlainObject","isInteger","safeStableStringify","isBoolean","isNonEmptyArray","joinLines","EOL","isNonEmptyString","isNonEmptyString","hasOwnProp","isBoolean","getPreciseType","isEmptyString"],"sources":["../src/urls/builders/constructURL.ts","../src/urls/extractors/extractURLs.ts","../src/urls/_private/NormalizePathnameError.ts","../src/urls/pathname/normalizePathname.ts","../src/urls/pathname/getFirstPrefixPathname.ts","../src/urls/pathname/getPrefixPathname.ts","../src/urls/utils/formatEnvPort.ts"],"sourcesContent":["import { isURL } from \"@/predicates/is/isURL\";\nimport { isError } from \"@/predicates/is/isError\";\nimport { isNumber } from \"@/predicates/is/isNumber\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isFunction } from \"@/predicates/is/isFunction\";\nimport { isUndefined } from \"@/predicates/is/isUndefined\";\nimport { isEmptyValue } from \"@/predicates/is/isEmptyValue\";\nimport { isEmptyString } from \"@/predicates/is/isEmptyString\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nimport { normalizeString } from \"@/strings/sanitizations/normalizeString\";\n\nimport { assertIsArray } from \"@/assertions/objects/assertIsArray\";\n\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\nimport { toStringArrayUnRecursive } from \"@/conversions/arrays/casts/toStringArrayUnRecursive\";\n\n/** ----------------------------------------------------------\n * * ***Type-Utility: `QueryParamPairs`.***\n * ----------------------------------------------------------\n * **Represents a non-empty array of key–value pairs.**\n * @description\n * Type for `queryParams` parameter, the second parameter of ***`constructURL` utility function***.\n * - **Behavior:**\n *    - Each inner tuple strictly follows the `[string, string | number]` shape.\n *    - Ensures the outer array contains **at least one pair** (non-empty).\n *    - Commonly used for URL construction parameters,\n *      query string segments, or other key–value structured data.\n * @example\n * // ✅ valid usage\n * const params: QueryParamPairs = [\n *   [\"foo\", 1],\n *   [\"bar\", \"baz\"]\n * ];\n * constructURL(\"https://example.com\", params);\n *\n * // ❌ invalid: must contain at least one item\n * const empty: QueryParamPairs = [];\n *\n * // ❌ invalid: key without value pairs.\n * const empty2: QueryParamPairs = [[\"key\"]];\n */\nexport type QueryParamPairs = [\n  [string, string | number],\n  ...[string, string | number][]\n];\n\n/** ---------------------------------\n * * ***Utility: `constructURL`.***\n * ---------------------------------\n * **Constructs a valid URL with optional query parameters and allows selective removal of duplicate parameters.**\n * @param {string | URL} baseUrl The base URL to build upon. Must include protocol (e.g., `\"https://\"`), `domain`, and may include port and existing query parameters.\n * @param {Iterable<[string, string]> | URLSearchParamsIterator<[string, string]> | QueryParamPairs} [queryParams]\n *   Additional query parameters to append or overwrite on the URL.\n *   - Accepts any iterable of key-value pairs (like `new URLSearchParams().entries()` and `[[string, string | number]...]`).\n * @param {string[]} [removeParams]\n *   A list of query parameter keys to remove from the final URL, whether they were in the base URL or provided queryParams.\n * @returns {URL} A new URL object representing the constructed URL with merged and cleaned query parameters.\n * @throws **{@link TypeError | `TypeError`}** if `baseUrl` is not a valid non-empty string or URL object, or if `queryParams` is not iterable, or if `removeParams` is not an array of strings.\n * @example\n *    1. #### Basic Usage:\n * ```ts\n *   constructURL(\n *     \"https://example.com/path\",\n *     new URLSearchParams({ a: \"1\", b: \"2\" }).entries()\n *   );\n *   // ➔ URL { href: \"https://example.com/path?a=1&b=2\", ... }\n * ```\n *    2. #### Remove parameters from Base and Added:\n * ```ts\n *   // with new URLSearchParams({ ... }).entries();\n *   constructURL(\n *     \"https://example.com/path?foo=1&bar=2\",\n *     new URLSearchParams({ bar: \"ignored\", baz: \"3\" }).entries(),\n *     [\"bar\"]\n *   );\n *   // ➔ URL { href: \"https://example.com/path?foo=1&baz=3\", ... }\n *\n *   // with [[string, string | number]...]\n *   constructURL(\n *     \"https://example.com/path?foo=1&bar=2\",\n *     [[\"bar\", \"ignored\"],[\"baz\", 3]],\n *     [\"bar\"]\n *   );\n *   // ➔ URL { href: \"https://example.com/path?foo=1&baz=3\", ... }\n *\n *   const params: QueryParamPairs = [\n *     [\"foo\", 1],\n *     [\"bar\", 2],\n *     [\"baz\", 3]\n *   ];\n *\n *   constructURL(\"https://example.com\", params, [\"bar\"]);\n *   // ➔ URL { href: \"https://example.com/?foo=1&baz=3\", ... }\n * ```\n */\nexport const constructURL = (\n  baseUrl: string | URL,\n  queryParams?:\n    | URLSearchParamsIterator<[string, string | number]>\n    | QueryParamPairs,\n  removeParams?: string[]\n): URL => {\n  if (isString(baseUrl)) {\n    if (isEmptyString(baseUrl)) {\n      throw new TypeError(\n        \"First parameter (`baseUrl`) cannot be an empty-string.\"\n      );\n    }\n    baseUrl = normalizeString(baseUrl);\n  } else if (!isURL(baseUrl)) {\n    throw new TypeError(\n      `First parameter (\\`baseUrl\\`) must be of type an URL instance or a \\`string\\` and a non empty-string, but received: \\`${getPreciseType(\n        baseUrl\n      )}\\`, with current value: \\`${safeStableStringify(baseUrl, {\n        keepUndefined: true\n      })}\\`.`\n    );\n  }\n\n  // Check removeParams\n  if (!isUndefined(removeParams)) {\n    assertIsArray(removeParams, {\n      message: ({ currentType, validType }) =>\n        `Third parameter (\\`removeParams\\`) must be of type \\`${validType} of strings\\`, but received: \\`${currentType}\\`.`\n    });\n\n    if (!removeParams.every((param) => isNonEmptyString(param))) {\n      throw new TypeError(\n        \"Third parameter (`removeParams`) must be of type `array` and contains `string` only and non empty-string.\"\n      );\n    }\n  }\n\n  try {\n    // Check queryParams\n    if (\n      !isUndefined(queryParams) &&\n      !isFunction(queryParams[Symbol.iterator])\n    ) {\n      throw new TypeError(\n        `Second parameter (\\`queryParams\\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \\`${getPreciseType(\n          queryParams\n        )}\\`, with value: \\`${safeStableStringify(queryParams, {\n          keepUndefined: true\n        })}\\`.`\n      );\n    }\n\n    const urlInstance = new URL(baseUrl);\n\n    // Add query parameters if provided\n    if (!isUndefined(queryParams)) {\n      const paramObject = Object.fromEntries(queryParams);\n\n      if (!isEmptyValue(paramObject)) {\n        // existing params\n        const mergedParams = new URLSearchParams(urlInstance.search);\n\n        // add / overwrite from queryParams\n        for (const [key, value] of Object.entries(paramObject)) {\n          if (\n            !isNonEmptyString(value) &&\n            !isNumber(value, { includeNaN: true })\n          ) {\n            throw new TypeError(\n              `Second parameter (\\`queryParams\\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \\`${getPreciseType(\n                queryParams\n              )}\\`, with value: \\`${safeStableStringify(queryParams, {\n                keepUndefined: true\n              })}\\`.`\n            );\n          }\n\n          mergedParams.set(key, String(value));\n        }\n\n        // Remove specific query parameters if needed\n        if (removeParams?.length) {\n          toStringArrayUnRecursive(removeParams).map((paramKey) => {\n            mergedParams.delete(paramKey);\n          });\n        }\n\n        urlInstance.search = mergedParams.toString();\n      }\n    }\n\n    // Remove query parameters directly from URL if needed\n    removeParams?.forEach((param) => urlInstance.searchParams.delete(param));\n\n    return urlInstance;\n  } catch (error) {\n    if (isError(error)) throw error;\n\n    throw new Error(\n      \"Failed to construct a valid URL in `constructURL()`, Error:\" + error,\n      { cause: error }\n    );\n  }\n};\n","import { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\n/** ---------------------------------\n * * ***Utility: `extractURLs`.***\n * ---------------------------------\n * **Extracts all valid URLs from a given string.**\n * @description\n * This function scans the input url and returns an array of URLs\n * that match a valid `http` or `https` format.\n * - **Supports:**\n *    - Internationalized domain names (IDN), e.g. `https://münich.de`\n *    - Unicode & emoji paths, e.g. `https://example.com/🎉/page`\n *    - Long URLs with multiple queries & fragments, e.g. `https://example.com/path?foo=1#hash`\n * - **Ignores:**\n *    - Non-string inputs\n *    - Empty or whitespace-only strings\n *    - Non-HTTP(S) protocols (ftp, mailto, etc)\n * @param {string | null | undefined} url - The input string containing potential URLs.\n * @returns {string[] | null} An array of extracted URLs or `null` if no URLs are found.\n * @example\n * extractURLs(\"Visit https://example.com and https://例子.公司\");\n * // ➔ [\"https://example.com\", \"https://例子.公司\"]\n * extractURLs(\"Here: https://example.com/🎉/page\");\n * // ➔ [\"https://example.com/🎉/page\"]\n * extractURLs(\"ftp://example.com http://example.com\");\n * // ➔ [\"http://example.com\"]\n */\nexport const extractURLs = (\n  url: string | null | undefined\n): string[] | null => {\n  if (!isNonEmptyString(url)) return null;\n\n  let decoded;\n  try {\n    decoded = decodeURIComponent(url);\n  } catch {\n    return null;\n  }\n\n  // Core regex with lookahead\n  const urlPattern = /https?:\\/\\/.*?(?=https?:\\/\\/|\\s|$)/g;\n  const matches = decoded.match(urlPattern);\n  if (!matches) return null;\n\n  // Cleanup trailing punctuation and validation protocol\n  const cleaned = matches\n    .map((url) => url.replace(/[.,;:!?)]*$/, \"\"))\n    .filter((url) => {\n      try {\n        const u = new URL(url);\n        return u.protocol === \"http:\" || u.protocol === \"https:\";\n      } catch {\n        return false;\n      }\n    });\n\n  return cleaned.length ? cleaned : null;\n};\n","import { isFunction } from \"@/predicates/is/isFunction\";\n\n/** ---------------------------------\n * * ***Custom Error for Pathname Normalization Failures***\n * ---------------------------------\n */\nexport class NormalizePathnameError extends Error {\n  /** ---------------------------------\n   * * ***The original error that triggered this normalization failure.***\n   * ---------------------------------\n   *\n   * **Always available for backward compatibility.**\n   */\n  public readonly originalError: Error;\n\n  constructor(message: string, originalError: Error) {\n    // Pass a `cause` option if the runtime supports it (ignored by older engines).\n    super(message, isFunction(Error) ? { cause: originalError } : undefined);\n\n    this.name = \"NormalizePathnameError\";\n    this.originalError = originalError;\n\n    // Preserve stack trace when available (Node.js & modern browsers).\n    if (isFunction(Error.captureStackTrace)) {\n      Error.captureStackTrace(this, NormalizePathnameError);\n    } else {\n      // Fallback for very old environments.\n      this.stack = new Error(message).stack;\n    }\n  }\n\n  /** ---------------------------------\n   * * ***Safe JSON representation for logging or IPC.***\n   * ---------------------------------\n   */\n  toJSON() {\n    return {\n      name: this.name,\n      message: this.message,\n      stack: this.stack,\n      originalError: {\n        name: this.originalError.name,\n        message: this.originalError.message,\n        stack: this.originalError.stack\n      }\n    };\n  }\n}\n","import type { OverrideTypes, Prettify } from \"@rzl-zone/ts-types-plus\";\n\nimport { isSet } from \"@/predicates/is/isSet\";\nimport { isNil } from \"@/predicates/is/isNil\";\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isError } from \"@/predicates/is/isError\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isValidDomain } from \"@/predicates/is/isValidDomain\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\nimport { assertIsPlainObject } from \"@/assertions/objects/assertIsPlainObject\";\n\nimport { removeSpaces } from \"@/strings/sanitizations/removeSpaces\";\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\n\nimport { NormalizePathnameError } from \"../_private/NormalizePathnameError\";\nimport { isUndefined } from \"@/predicates/is/isUndefined\";\n\n/** Options when `keepNullable` is false (default).\n *\n * Returns `defaultPath` if `pathname` is empty or invalid.\n */\ntype UnKeepNullableOptions = {\n  /** * ***Fallback value returned if `pathname` is empty-string or invalid.***\n   *\n   * Must be a **`non-empty string`**, defaultValue: `\"/\"`.\n   *\n   * @default \"/\"\n   */\n  defaultPath?: string;\n\n  /** * ***Whether to preserve `null` or `undefined`, defaultValue: `false`.***\n   *\n   * @default false\n   */\n  keepNullable?: false;\n};\n\n/** Options when `keepNullable` is true.\n *\n * Preserves `null` or `undefined` instead of returning `defaultPath`.\n */\ntype KeepNullableOptions = {\n  /** * ***Fallback path is ignored when `keepNullable` is true **(except if\n   * `pathname` is empty-string or invalid, even this `true`)**,\n   * defaultValue: `\"/\"`.***\n   *\n   * @default \"/\"\n   */\n  defaultPath?: string;\n\n  /** * ***Preserve `null` or `undefined` as-is if `true` (defaultValue: `false`).***\n   *\n   * - ***⚠️ Notes:***\n   *      - Keep returning `defaultPath` if `pathname` is empty-string, even this `true`.\n   *\n   * **Must be `true` in this type.**\n   *\n   * @default false\n   */\n  keepNullable?: true;\n};\n\ntype MainNormalizePathnameOptions = {\n  /** --------------------------------------------------------\n   * * ***Preserve trailing slash at the end of the normalized pathname, defaultValue: `false`.***\n   * --------------------------------------------------------\n   *\n   * @default `false`\n   */\n  keepTrailingSlash?: boolean;\n\n  /** --------------------------------------------------------\n   * * ***Allow special localhost domain at the beginning of the pathname.***\n   * --------------------------------------------------------\n   * @description\n   * If `true`, the first segment of the pathname that is `/localhost` or `localhost`\n   * (with or without a port, e.g., `localhost:3000`) will be treated as a special domain\n   * and **removed** from the normalized pathname.\n   *\n   * - **Examples (`localhostDomain: true`)**:\n   *    - `\"/localhost/path\"` ➔ `\"/path\"`\n   *    - `\"localhost:3000/path\"` ➔ `\"/path\"`\n   *    - `\"localhost\"` ➔ `\"/\"` (entire path removed)\n   *\n   * - Only the **first path segment** is affected. Any subsequent occurrences of `\"localhost\"`\n   *   will remain intact.\n   *\n   * @default false\n   */\n  localhostDomain?: boolean;\n\n  /**\n   * --------------------------------------------------------\n   * * ***Custom list of file extensions that prevent the first path segment from being treated as a domain.***\n   * --------------------------------------------------------\n   *\n   * **Description:**\n   * - The first segment of a pathname is often interpreted as a domain (e.g., `example.com`).\n   * - If this first segment ends with any of the extensions listed here, it will **not** be considered a domain,\n   *   and will instead be preserved as part of the relative path.\n   * - This is useful for cases where filenames appear at the start of a path and you want them treated as relative paths,\n   *   such as `\"image.png?version=2\"` or `\"archive.tar.gz#download\"`.\n   * - Only the **first path segment** is affected; all other segments are processed normally.\n   * - **Ignored** if:\n   *    1. The pathname starts with a full URL protocol (`http://` or `https://`), e.g., `\"https://example.com/file.png\"`.\n   *    2. The first path segment is already a valid domain, e.g., `\"example.com/image.png\"`.\n   *\n   * **Type & Validation:**\n   * - Must be a `Set<string>` or `string[]`.\n   * - Each string **must include the leading dot**, e.g., `.png`, `.tar.gz`.\n   * - Multi-part extensions (like `.tar.gz`, `.tar.bz`) are supported.\n   * - Throws a **TypeError** if:\n   *    1. The type is not a `Set<string>` or `string[]`.\n   *    2. Any string in the array/set is empty.\n   *    3. Any string does not start with a dot (`.`).\n   *\n   * **Usage Notes:**\n   * - Only applied when the first segment is otherwise domain-like **and** pathname is relative or domain-like without protocol.\n   * - Query strings (`?x=1`) and hash fragments (`#section`) are preserved.\n   *\n   * **Examples (relative paths, option active):**\n   * ```ts\n   * normalizePathname(\"image.png?version=2\", {\n   *   ignoreDomainExtensions: [\".png\", \".jpg\"]\n   * });\n   * // ➔ \"/image.png?version=2\"\n   *\n   * normalizePathname(\"archive.tar.gz#download\", {\n   *   ignoreDomainExtensions: new Set([\".tar.gz\"])\n   * });\n   * // ➔ \"/archive.tar.gz#download\"\n   *\n   * normalizePathname(\"script.js?module=true#top\", {\n   *   ignoreDomainExtensions: [\".js\"]\n   * });\n   * // ➔ \"/script.js?module=true#top\"\n   * ```\n   *\n   * **Examples (full URL or explicit domain - option ignored):**\n   * ```ts\n   * normalizePathname(\"https://example.com/image.png?version=2\", {\n   *   ignoreDomainExtensions: [\".png\"]\n   * });\n   * // ➔ \"/image.png?version=2\"  // URL is parsed normally; ignoreDomainExtensions has no effect\n   *\n   * normalizePathname(\"example.com/script.js?module=true#top\", {\n   *   ignoreDomainExtensions: [\".js\"]\n   * });\n   * // ➔ \"/script.js?module=true#top\"  // domain recognized; option ignored\n   * ```\n   *\n   * **Notes:**\n   * - Only the **first path segment** is checked.\n   * - Prevents false-positive domain stripping for filenames that look like domains.\n   * - Throws **TypeError** if invalid type or invalid string is provided.\n   *\n   * @default undefined (feature inactive if not provided)\n   */\n  ignoreDomainExtensions?: Set<string> | string[];\n};\n\n/** Options for main `normalizePathname`.\n *\n * Combines `UnKeepNullableOptions` or `KeepNullableOptions` with trailing slash control.\n */\ntype NormalizePathnameOptions = Prettify<\n  MainNormalizePathnameOptions & (UnKeepNullableOptions | KeepNullableOptions)\n>;\n\ntype NormalizePathnameOptionsKeepNullableTrue = MainNormalizePathnameOptions &\n  KeepNullableOptions;\ntype NormalizePathnameOptionsKeepNullableFalse = MainNormalizePathnameOptions &\n  UnKeepNullableOptions;\n\ntype ResUnKeepNullable<T> = T extends undefined\n  ? string\n  : T extends null\n    ? string\n    : T extends null | undefined\n      ? string\n      : string;\n\ntype ResKeepNullable<T> = T extends string\n  ? string\n  : T extends undefined\n    ? undefined\n    : T extends null\n      ? null\n      : T extends null | undefined\n        ? null | undefined\n        : string | null | undefined;\n\n/** --------------------------------------------------------\n * * ***Utility: `normalizePathname`.***\n * --------------------------------------------------------\n *\n * - **Description:**\n *    Normalizes any pathname or URL string to a clean, predictable format.\n *    Useful for routing, file paths, and URL handling.\n *    - Handles:\n *      - Leading/trailing spaces\n *      - Internal spaces in path segments\n *      - Redundant slashes (`//`)\n *      - Full URLs vs relative paths\n *      - Query (`?`) and hash (`#`) preservation\n *      - Unicode & emoji characters\n *      - Optional nullable preservation (`keepNullable`)\n *      - Optional trailing slash preservation (`keepTrailingSlash`)\n *      - Optional removal of localhost first segment (`localhostDomain`)\n *      - Prevention of false-positive domain stripping (`ignoreDomainExtensions`)\n *\n * - **Key Steps Internally:**\n *    1. Validate `options` (plain object, correct types)\n *    2. Validate `defaultPath` (non-empty string if `keepNullable` is false)\n *    3. Validate `ignoreDomainExtensions` (Set<string> | string[], each starts with `.`)\n *    4. Handle nullable:\n *       - Returns `null` / `undefined` if `keepNullable: true`\n *       - Otherwise uses `defaultPath`\n *    5. Trim spaces, remove internal spaces\n *    6. If full URL: parse using `URL` constructor\n *    7. If relative path or domain-like:\n *       - Remove `localhost`/`localhost:port` if `localhostDomain`\n *       - Remove first segment if domain-like and **not** in `ignoreDomainExtensions`\n *    8. Normalize slashes\n *    9. Ensure leading slash\n *    10. Handle trailing slash\n *    11. Decode Unicode safely\n *    12. Return normalized pathname + search + hash\n *\n * - **Error Handling:**\n *    - **TypeError**:\n *       - `defaultPath` invalid (non-string or empty) when `keepNullable: false`\n *       - `keepNullable`, `keepTrailingSlash`, `localhostDomain` not boolean\n *       - `ignoreDomainExtensions` invalid\n *    - **NormalizePathnameError** (extends ***Error***):\n *       - Invalid URL parsing\n *       - Unexpected normalization errors\n *\n * - **Options:**\n *    ```ts\n *    {\n *      // fallback if invalid path, default: \"/\"\n *      defaultPath?: string;\n *      // preserve null/undefined, default: false\n *      keepNullable?: boolean;\n *      // preserve trailing slash, default: false\n *      keepTrailingSlash?: boolean;\n *      // remove localhost:port first segment, default: false\n *      localhostDomain?: boolean;\n *      // prevent domain stripping, default: undefined\n *      ignoreDomainExtensions?: Set<string> | string[];\n *    }\n *    ```\n *\n * @example\n * // Basic path cleaning\n * normalizePathname(\"   /foo//bar  \");\n * // ➔ \"/foo/bar\"\n *\n * // Trailing slash control\n * normalizePathname(\"/api//v1//user//\", { keepTrailingSlash: true });\n * // ➔ \"/api/v1/user/\"\n * normalizePathname(\"/api//v1//user//\", { keepTrailingSlash: false });\n * // ➔ \"/api/v1/user\"\n *\n * // Full URL normalization\n * normalizePathname(\"https://example.com//path///to/resource?x=1#hash\");\n * // ➔ \"/path/to/resource?x=1#hash\"\n *\n * // Null/undefined preservation\n * normalizePathname(null, { keepNullable: true });\n * // ➔ null\n * normalizePathname(undefined, { keepNullable: true });\n * // ➔ undefined\n *\n * // Default fallback\n * normalizePathname(\"\", { defaultPath: \"/home\" });\n * // ➔ \"/home\"\n *\n * // Localhost removal\n * normalizePathname(\"localhost:3000/path/to/resource\", { localhostDomain: true });\n * // ➔ \"/path/to/resource\"\n *\n * // Prevent false-positive domain stripping\n * normalizePathname(\"archive.tar.gz#download\", { ignoreDomainExtensions: [\".tar.gz\"] });\n * // ➔ \"/archive.tar.gz#download\"\n * normalizePathname(\"image.png?version=2\", { ignoreDomainExtensions: [\".png\"] });\n * // ➔ \"/image.png?version=2\"\n *\n * // Emojis and Unicode\n * normalizePathname(\"🔥//deep//path///🚀\");\n * // ➔ \"/🔥/deep/path/🚀\"\n *\n * // Query-only or hash-only\n * normalizePathname(\"?page=2\");\n * // ➔ \"/?page=2\"\n * normalizePathname(\"#section3\");\n * // ➔ \"/#section3\"\n *\n * // Complex nested paths\n * normalizePathname(\"   //nested///folder//file.txt  \");\n * // ➔ \"/nested/folder/file.txt\"\n *\n * // Invalid URL triggers error\n * try {\n *   normalizePathname(\"http://\");\n * } catch (e) {\n *   // console.log(e);\n * }\n *\n * // First segment is domain but ignored due to extension\n * normalizePathname(\"example.tar.bz/file\", { ignoreDomainExtensions: [\".tar.bz\"] });\n * // ➔ \"/example.tar.bz/file\"\n */\nexport function normalizePathname<T>(\n  pathname: T,\n  options?: NormalizePathnameOptionsKeepNullableFalse\n): ResUnKeepNullable<T>;\nexport function normalizePathname<T>(\n  pathname: T,\n  options?: NormalizePathnameOptionsKeepNullableTrue\n): ResKeepNullable<T>;\nexport function normalizePathname(\n  pathname: unknown,\n  options: NormalizePathnameOptions = {\n    defaultPath: \"/\",\n    keepNullable: false\n  }\n): string | null | undefined {\n  assertIsPlainObject(options, {\n    message({ currentType, validType }) {\n      return `Second parameter (\\`options\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`;\n    }\n  });\n\n  const {\n    defaultPath = \"/\",\n    keepNullable = false,\n    keepTrailingSlash = false,\n    localhostDomain = false,\n    ignoreDomainExtensions = undefined\n  } = options;\n\n  // Validate defaultPath\n  if (!isNonEmptyString(defaultPath)) {\n    throw new TypeError(\n      `Parameter \\`defaultPath\\` property of the \\`options\\` (second parameter) must be of type \\`string\\` and not empty-string, but received: \\`${getPreciseType(\n        defaultPath\n      )}\\`, with value: \\`${safeStableStringify(defaultPath, {\n        keepUndefined: true\n      })}\\`.`\n    );\n  }\n\n  assertIsBoolean(keepNullable, {\n    message({ currentType, validType }) {\n      return `Parameter \\`keepNullable\\` property of the \\`options\\` (second parameter)  must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`;\n    }\n  });\n  assertIsBoolean(keepTrailingSlash, {\n    message({ currentType, validType }) {\n      return `Parameter \\`keepTrailingSlash\\` property of the \\`options\\` (second parameter)  must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`;\n    }\n  });\n  assertIsBoolean(localhostDomain, {\n    message({ currentType, validType }) {\n      return `Parameter \\`localhostDomain\\` property of the \\`options\\` (second parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`;\n    }\n  });\n\n  let ignoreDomainExtsSet: Set<string> | undefined;\n\n  if (!isUndefined(ignoreDomainExtensions)) {\n    if (!isSet(ignoreDomainExtensions) && !isArray(ignoreDomainExtensions)) {\n      throw new TypeError(\n        `Parameter \\`ignoreDomainExtensions\\` must be of type a \\`Set<string>\\` or \\`string[]\\`, but received: \\`${getPreciseType(\n          ignoreDomainExtensions\n        )}\\`.`\n      );\n    }\n\n    ignoreDomainExtsSet = isSet(ignoreDomainExtensions)\n      ? ignoreDomainExtensions\n      : new Set(ignoreDomainExtensions);\n\n    // validation every ext\n    let idx = 0;\n    for (const ext of ignoreDomainExtsSet) {\n      if (!isNonEmptyString(ext)) {\n        throw new TypeError(\n          `Parameter \\`ignoreDomainExtensions[${idx}]\\` must be a \\`string\\` and \\`non-empty string\\`, but received: \\`${safeStableStringify(\n            ext,\n            { keepUndefined: true }\n          )}\\`.`\n        );\n      }\n      if (!ext.startsWith(\".\")) {\n        throw new TypeError(\n          `Parameter \\`ignoreDomainExtensions[${idx}]\\` must start with a dot (.), but received: ${safeStableStringify(\n            ext,\n            { keepUndefined: true }\n          )}`\n        );\n      }\n      idx++;\n    }\n  }\n\n  try {\n    if (keepNullable && (isNil(pathname) || !isString(pathname))) {\n      if (isNull(pathname)) return null;\n      return undefined;\n    }\n\n    // If the pathname is invalid (null, undefined, or an empty string), return the default value, only if `keepNullable` is false\n    let currentPathName: string = isNonEmptyString(pathname)\n      ? pathname\n      : defaultPath;\n\n    // Trim spaces from the string (only trim leading and trailing spaces)\n    currentPathName = removeSpaces(currentPathName, { trimOnly: true }).replace(\n      /\\s+/g,\n      \"\"\n    ); // remove all space\n\n    currentPathName = stripLeadingDomain(currentPathName, {\n      keepTrailingSlash,\n      localhostDomain,\n      ignoreDomainExtensions: ignoreDomainExtsSet\n    });\n\n    let _pathName: string = currentPathName;\n    let search = \"\";\n    let hash = \"\";\n\n    // relative path: extract search/hash manually\n    const searchIndex = currentPathName.indexOf(\"?\");\n    const hashIndex = currentPathName.indexOf(\"#\");\n\n    if (searchIndex !== -1) {\n      search = currentPathName.slice(\n        searchIndex,\n        hashIndex !== -1 ? hashIndex : undefined\n      );\n    }\n    if (hashIndex !== -1) {\n      hash = currentPathName.slice(hashIndex);\n    }\n\n    const endIndex = Math.min(\n      searchIndex !== -1 ? searchIndex : currentPathName.length,\n      hashIndex !== -1 ? hashIndex : currentPathName.length\n    );\n    _pathName = currentPathName.slice(0, endIndex);\n\n    // Normalize slashes\n    _pathName = \"/\" + _pathName.replace(/^\\/+/, \"\").replace(/\\/{2,}/g, \"/\");\n\n    // Trailing slash\n    if (!keepTrailingSlash && _pathName !== \"/\") {\n      _pathName = _pathName.replace(/\\/+$/, \"\");\n    }\n\n    // Decode Unicode safely\n    _pathName = decodeUnicodeSequences(_pathName);\n    search = decodeUnicodeSequences(search);\n    hash = decodeUnicodeSequences(hash);\n\n    return _pathName + search + hash;\n  } catch (error) {\n    // Handle any errors that occur during processing\n    throwError(error);\n  }\n}\n\n// --- Internal Helper Utils ----\n\n/**\n * @internal\n */\nconst decodeUnicodeSequences = (str: string): string => {\n  return str.replace(/(?:%(?:[0-9A-F]{2})){2,}/gi, (match) => {\n    try {\n      const decoded = decodeURIComponent(match);\n      // eslint-disable-next-line no-control-regex\n      if (/^[\\u0000-\\u007F]+$/.test(decoded)) return match;\n      // eslint-enable-next-line no-control-regex\n      return decoded;\n    } catch {\n      return match;\n    }\n  });\n};\n\n/**\n * @internal\n */\nconst stripLeadingDomain = (\n  path: string,\n  options: OverrideTypes<\n    MainNormalizePathnameOptions,\n    { ignoreDomainExtensions?: Set<string> }\n  >\n): string => {\n  let currentPath = path;\n\n  const { ignoreDomainExtensions, localhostDomain } = options;\n\n  // Full URL (protocol) -> only normalize path, ignore ignoreDomainExtensions\n  if (/^https?:\\/\\//i.test(currentPath)) {\n    try {\n      const url = new URL(currentPath);\n      currentPath =\n        url.pathname.replace(/^\\/+/, \"\").replace(/\\/{2,}/g, \"/\") +\n        url.search +\n        url.hash;\n\n      return ensureLeadingSlash(currentPath);\n    } catch (error) {\n      // fallback: keep as-is\n      // Handle any errors that occur during processing\n      throwError(error);\n    }\n  }\n\n  // relative path: remove leading slash\n  if (currentPath.startsWith(\"/\")) {\n    currentPath = currentPath.replace(/\\/{2,}/g, \"/\").slice(1);\n  }\n\n  // take first segment\n  const segments = currentPath.split(\"/\");\n  const firstPart = segments[0];\n  const domainPart = firstPart?.split(\":\")[0];\n\n  const isDomain = isValidDomain(domainPart, {\n    subdomain: true,\n    allowUnicode: true,\n    wildcard: true,\n    allowLocalhost: localhostDomain,\n    allowPort: true,\n    allowProtocol: true,\n    topLevel: false\n  });\n\n  // ignoreDomainExtensions only applies for relative/non-protocol paths\n  let hasIgnoredExtension = false;\n  if (ignoreDomainExtensions) {\n    for (const ext of ignoreDomainExtensions) {\n      if (firstPart?.endsWith(ext)) {\n        hasIgnoredExtension = true;\n        break;\n      }\n    }\n  }\n\n  if (isDomain && !hasIgnoredExtension) {\n    segments.shift(); // remove first segment\n  }\n\n  return ensureLeadingSlash(segments.join(\"/\"));\n};\n\n/**\n * @internal\n */\nconst ensureLeadingSlash = (path: string): string => {\n  if (!path.startsWith(\"/\")) path = \"/\" + path;\n  return path;\n};\n\n/**\n * @internal\n */\nconst throwError = (error: unknown): never => {\n  // Handle any errors that occur during processing\n  const err = isError(error)\n    ? error\n    : new Error(\"Unknown error from function `normalizePathname()`.\");\n  throw new NormalizePathnameError(\n    `Failed to normalize pathname in function \\`normalizePathname()\\`: ${err.message}`,\n    err\n  );\n};\n","import { isNil } from \"@/predicates/is/isNil\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\nimport { normalizePathname } from \"./normalizePathname\";\n\n/** --------------------------------------------------------\n * * ***Utility: `getFirstPrefixPathname`.***\n * --------------------------------------------------------\n * **Extract First Valid Prefix from Path Array or String.**\n * - **Main Purpose:**\n *    - This function helps extract the first valid URL prefix from various possible inputs.\n *    - It is especially useful in routing systems, middleware, or frontend apps that need to\n *      decide layout, active navigation, or permissions based on the first segment (or prefix) of a pathname.\n * - **Typical uses include:**\n *    - Determining which layout to render (e.g., `/admin` vs `/dashboard` vs `/`).\n *    - Highlighting the active menu item in a sidebar based on the current URL.\n *    - Enforcing route guards or access controls depending on the URL prefix.\n *    - Parsing multi-level route prefixes and selecting the most relevant one.\n * - **Behavior:**\n *    - It works as follows:\n *        - If `result` is an array of strings, it normalizes each element and returns\n *          the first non-root path (i.e., not just `\"/\"`).\n *        - If all items normalize to `\"/\"`,\n *          it returns the `defaultValue` (normalized).\n *        - If `result` is a single string, it normalizes it and returns it if valid,\n *          otherwise falls back to the normalized `defaultValue`.\n *        - If `result` is `null` or `undefined`, it returns the normalized `defaultValue`.\n * - **Validation & Errors:**\n *    - Throws a `TypeError` if:\n *      - `defaultValue` is not a string or empty-string.\n *      - `result` is an array that contains non-string elements.\n *      - `result` is a value that is neither `string`, `string[]`, nor `null`.\n * @example\n * 1. #### For React (*Determining layout*):\n * ```ts\n *   const prefix = getFirstPrefixPathname(\n *      getPrefixPathname(\n *        \"/admin/settings\",\n *        [\"/admin\", \"/dashboard\"]\n *      )\n *   );\n *\n *   if (prefix === \"/admin\") {\n *     renderAdminLayout();\n *   }\n * ```\n *\n * 2. #### Setting active menu state:\n * ```ts\n *   const activeSection = getFirstPrefixPathname([\"\", \"/dashboard\", \"/profile\"]);\n *   // ➔ \"/dashboard\"\n * ```\n *\n * 3. #### Providing graceful fallback:\n * ```ts\n *   const section = getFirstPrefixPathname([], \"/home\");\n *   // ➔ \"/home\"\n * ```\n * 4. #### ✅ Using with an Array of Pathnames:\n * ```ts\n *   const result = getPrefixPathname([\"   \", \"/dashboard\", \"/settings\"]);\n *   console.log(getFirstPrefixPathname(result));\n *   // ➔ \"/dashboard\"\n * ```\n *\n * 5. #### ✅ Using with Single String:\n * ```ts\n *   console.log(getFirstPrefixPathname(\"/profile/settings\"));\n *   // ➔ \"/profile/settings\"\n *   console.log(getFirstPrefixPathname(\"   \"));\n *   // ➔ \"/\"\n * ```\n *\n * 6. #### ✅ Fallback to Custom Default:\n * ```ts\n *   console.log(getFirstPrefixPathname([\"   \", \"\"], \"/home\"));\n *   // ➔ \"/home\"\n *   console.log(getFirstPrefixPathname(null, \"/dashboard\"));\n *   // ➔ \"/dashboard\"\n * ```\n *\n * 7. #### ✅ Throws on Invalid Input:\n * ```ts\n *   getFirstPrefixPathname([1, 2] as any); // ➔ ❌ throws TypeError\n *   getFirstPrefixPathname({} as any);     // ➔ ❌ throws TypeError\n *   getFirstPrefixPathname(null, \"   \");   // ➔ ❌ throws TypeError\n * ```\n * @param {string | string[] | null | undefined} result\n *  ***The pathname(s) to process, can be:***\n *    - A string path (e.g. `\"/profile\"`),\n *    - An array of string paths (e.g. `[\"   \", \"/dashboard\"]`),\n *    - Or `null`.\n * @param {string} [defaultValue=\"/\"]\n *  ***A custom default path to use if `result` is null or no valid prefix is found, behavior:***\n *      - Must be a string and non-empty string.\n *      - Defaults to `\"/\"`.\n * @returns {string}\n *   ***The first valid normalized pathname, or the normalized default.***\n * @throws **{@link TypeError | `TypeError`}** ***if `result` is not a valid type, or `defaultValue` is not a string or empty-string.***\n */\nexport const getFirstPrefixPathname = (\n  result: string | string[] | null | undefined,\n  defaultValue: string = \"/\"\n): string => {\n  if (!isNonEmptyString(defaultValue)) {\n    throw new TypeError(\n      `Second parameter (\\`defaultValue\\`) must be of type \\`string\\` and not an \\`empty-string\\`, but received: \\`${getPreciseType(\n        defaultValue\n      )}\\`, with value: \\`${safeStableStringify(defaultValue, {\n        keepUndefined: true\n      })}\\`.`\n    );\n  }\n\n  if (isArray(result)) {\n    if (!result.every((item) => isString(item))) {\n      throw new TypeError(\n        `First parameter (\\`result\\`) must be of type \\`string\\` or \\`array of string\\`, but received: \\`${getPreciseType(\n          result\n        )}\\`, with value: \\`${safeStableStringify(result, {\n          keepUndefined: true\n        })}\\`.`\n      );\n    }\n\n    for (const item of result) {\n      const normalized = normalizePathname(item);\n      if (normalized !== \"/\") {\n        return normalized;\n      }\n    }\n    return normalizePathname(defaultValue);\n  }\n\n  if (isString(result)) {\n    const normalized = normalizePathname(result);\n    return normalized !== \"/\" ? normalized : normalizePathname(defaultValue);\n  }\n\n  if (!isNil(result)) {\n    throw new TypeError(\n      `First parameter (\\`result\\`) must be of type \\`string\\`, \\`array-string\\`, \\`null\\` or \\`undefined\\`, but received: \\`${getPreciseType(\n        result\n      )}\\`.`\n    );\n  }\n\n  return normalizePathname(defaultValue);\n};\n","import { joinLines, EOL } from \"@rzl-zone/build-tools/utils\";\n\nimport { isNull } from \"@/predicates/is/isNull\";\nimport { isArray } from \"@/predicates/is/isArray\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isInteger } from \"@/predicates/is/isInteger\";\nimport { isBoolean } from \"@/predicates/is/isBoolean\";\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyArray } from \"@/predicates/is/isNonEmptyArray\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\n\nimport { normalizePathname } from \"./normalizePathname\";\n\ntype GetPrefixPathnameOptions = {\n  /** The number of levels to include in the prefix (default is `1`).\n   *\n   * - For example, with `levels = 2`, the function will return the first two parts of the URL.\n   *\n   * @default 1\n   */\n  levels?: number;\n  /** Whether to remove duplicates from the result if multiple URLs are passed (default is `true`).\n   *\n   * @default true\n   */\n  removeDuplicates?: boolean;\n};\n\n/** --------------------------------------------------------\n * * ***Utility: `getPrefixPathname`.***\n * --------------------------------------------------------\n * **Get Prefix from URL with Optional Base or Auto-detection (Supports String or Array of URLs).**\n * - **This function extracts the prefix from one or more URLs. It can either:**\n *    - Use a provided `base` string or an array of strings to check and return the matching prefix.\n *    - Automatically detect the prefix if no `base` is provided by analyzing the first part of the URL.\n * - **The function is flexible and can handle both scenarios:**\n *    1. **When the base is provided as a single string or an array of strings**:\n *        - The function will check if the URL starts with one of the provided base(s) and return the matching base.\n *    2. **When the base is not provided**:\n *        - The function will automatically detect the prefix by splitting the URL or using a regex.\n * - **Important Notes**:\n *    - If a base (or an array of bases) is provided, the URL must start with one of the given base(s).\n *    - If no base is provided, the function will attempt to detect the prefix automatically.\n *    - The `url` parameter can be either a string or an array of strings.\n *    - Supports deduplication of results (enabled by default).\n *    - Automatically returns a single string if only one unique result exists after processing.\n * @param {string|string[]} url\n *  ***The full URL(s) from which the prefix should be extracted, can be a `string` or an `array of strings`.***\n * @param {string|string[]|null} [base=null]\n *  ***The base URL(s) (e.g., `\"/settings\"`), behavior:***\n *    - It can be a `string`, an `array of strings`, or `null`.\n *    - If `provided`, it will be used to check the URL(s).\n *    - If `not provided`, the prefix will be auto-detected.\n * @param {GetPrefixPathnameOptions} [options]\n *  ***Additional options object:***\n *    - `levels` (default `1`): The number of segments to include when auto-detecting the prefix (e.g. `/foo/bar` for `levels: 2`).\n *    - `removeDuplicates` (default `true`): Whether to remove duplicate prefixes from the final array result.\n * @returns {string|string[]|null}\n *  ***Returns one of:***\n *    - A single string if only one unique prefix/base is found.\n *    - An array of strings if multiple different prefixes/bases are found.\n *    - `null` if no matching base is found when using `base`.\n * @throws **{@link TypeError | `TypeError`}**\n *  ***if:***\n *    - `url` is `not a string` or `not an array of strings`.\n *    - `base` is `not a string`, `array of strings`, or `null`.\n *    - `options` is `not an object`.\n *    - `levels` is `not a number`.\n *    - `removeDuplicates` is `not a boolean`.\n * @example\n * - #### ✅ **Correct Usage (With an Array of URLs and Base):**\n * ```ts\n *    const routes = [\n *      \"/settings/profile\",\n *      \"/settings/password\",\n *      \"/settings/other-path\",\n *      \"/other-path/xyz\",\n *    ];\n *\n *    // With base provided as a string\n *    routes.forEach(route => {\n *      console.log(getPrefixPathname(route, '/settings'));\n *      // ➔ \"/settings\"\n *    });\n *\n *    // With base provided as an array\n *    routes.forEach(route => {\n *      console.log(getPrefixPathname(route, ['/settings', '/admin']));\n *      // ➔ \"/settings\" or \"/admin\" depending on the current URL.\n *    });\n * ```\n * - #### ✅ **Correct Usage (With Single URL and Single Base):**\n * ```ts\n *    const result = getPrefixPathname(\"/settings/profile\", \"/settings\");\n *    console.log(result); // ➔ \"/settings\"\n * ```\n * - #### ✅ **Correct Usage (With Multiple URLs and Single Base):**\n * ```ts\n *    const result = getPrefixPathname(\n *      [\"/settings/profile\", \"/settings/password\"],\n *      \"/settings\"\n *    );\n *    console.log(result); // ➔ \"/settings\"\n *\n *    const result2 = getPrefixPathname(\n *      [\"/settings/profile\", \"/other/password\"],\n *      \"/other\"\n *    );\n *    console.log(result2); // ➔ \"/other\"\n * ```\n * - #### ✅ **Correct Usage (With Multiple URLs and Multiple Bases)**\n * ```ts\n *    const result = getPrefixPathname(\n *      [\"/settings/profile\", \"/admin/password\"],\n *      [\"/settings\", \"/admin\"]\n *    );\n *    console.log(result); // ➔ [\"/settings\", \"/admin\"]\n * ```\n * - #### ✅ **Auto-detection of Prefix**\n * ```ts\n *    const result = getPrefixPathname(\"/settings/profile\");\n *    console.log(result); // ➔ \"/settings\"\n *\n *    const result2 = getPrefixPathname(\n *      \"/settings/profile/info\",\n *      null,\n *      { levels: 2 }\n *    );\n *    console.log(result2); // ➔ \"/settings/profile\"\n * ```\n * - #### ✅ **Multiple URLs with Auto-detection**\n * ```ts\n *    const result = getPrefixPathname([\"/admin/profile\", \"/settings/password\"]);\n *    console.log(result); // ➔ [\"/admin\", \"/settings\"]\n * ```\n * - #### ✅ **Handling Duplicates**\n * ```ts\n *    const result = getPrefixPathname(\n *      [\"/settings/profile\", \"/settings/password\"],\n *      \"/settings\"\n *    );\n *    console.log(result); // ➔ \"/settings\" (deduped to single string)\n *\n *    const result2 = getPrefixPathname(\n *      [\"/settings/profile\", \"/settings/profile\"],\n *      \"/settings\",\n *      { removeDuplicates: false }\n *    );\n *    console.log(result2); // ➔ [\"/settings\", \"/settings\"]\n * ```\n * - #### ❌ **Incorrect Usage (URL Does Not Match Base)**\n * ```ts\n *    const result = getPrefixPathname(\"/other-path/profile\", \"/settings\");\n *    console.log(result); // ➔ null\n * ```\n */\nexport const getPrefixPathname = (\n  url: string | string[],\n  base: string | string[] | null = null,\n  options: GetPrefixPathnameOptions = {}\n): string | string[] | null => {\n  const errors: string[] = [];\n\n  if (!isString(url) && !isArray(url)) {\n    errors.push(\n      `First parameter (\\`url\\`) must be of type \\`string\\` or \\`array-string\\`, but received: \\`${getPreciseType(\n        url\n      )}\\`.`\n    );\n  }\n  if (!isString(base) && !isArray(base) && !isNull(base)) {\n    errors.push(\n      `Second parameter (\\`base\\`) must be of type \\`string\\`, \\`array-string\\` or \\`null\\`, but received: \\`${getPreciseType(\n        base\n      )}\\`.`\n    );\n  }\n  if (!isPlainObject(options)) {\n    errors.push(\n      `Second parameter (\\`options\\`) must be of type \\`plain-object\\`, but received: \\`${getPreciseType(\n        options\n      )}\\`.`\n    );\n  }\n\n  const { levels = 1, removeDuplicates = true } = options;\n\n  if (!isInteger(levels) || (isInteger(levels) && levels < 0)) {\n    errors.push(\n      `Parameter \\`levels\\` property of the \\`options\\` (second parameter) must be of type \\`integer-number\\` and minimum is \\`0\\`, but received: \\`${getPreciseType(\n        levels\n      )}\\`, with value: \\`${safeStableStringify(levels, {\n        keepUndefined: true\n      })}\\`.`\n    );\n  }\n  if (!isBoolean(removeDuplicates)) {\n    errors.push(\n      `Parameter \\`removeDuplicates\\` property of the \\`options\\` (second parameter) must be of type \\`boolean\\`, but received: \\`${getPreciseType(\n        removeDuplicates\n      )}\\`.`\n    );\n  }\n  if (isNonEmptyArray(errors)) {\n    throw new TypeError(\n      joinLines(\n        \"Invalid parameter(s) in `getPrefixPathname` function:\",\n        `- ${errors.join(`${EOL}- `)}`\n      )\n    );\n  }\n\n  // Helper function to process a single URL\n  function getLevel(singleUrl: string) {\n    // If no base is provided, detect the base automatically\n    const parts = normalizePathname(singleUrl).split(\"/\").filter(Boolean); // Split URL into parts\n\n    // Return the first `levels` parts as the prefix\n    return `/${parts.slice(0, levels).join(\"/\")}`;\n  }\n\n  // Helper function to process a single URL\n  function processUrl(singleUrl: string): string | null {\n    // If a base is provided, check if URL starts with one of the bases\n    if (base) {\n      singleUrl = normalizePathname(singleUrl);\n\n      if (isArray(base)) {\n        // Check if the URL starts with any of the base values in the array\n        for (const b of base) {\n          if (singleUrl.startsWith(normalizePathname(b))) {\n            // return normalizePathname(b); // Return the matching base if URL starts with it\n            return getLevel(singleUrl);\n          }\n        }\n      } else if (\n        isNonEmptyString(base) &&\n        singleUrl.startsWith(normalizePathname(base))\n      ) {\n        // If base is a single string, check if URL starts with it\n        // return normalizePathname(base); // Return the base if URL starts with it\n        return getLevel(singleUrl);\n      }\n      return null; // Return null if the URL does not match any base\n    }\n\n    return getLevel(singleUrl);\n  }\n\n  // If url is an array, process each URL and return an array of results\n  if (isArray(url)) {\n    const result = url.map(processUrl).filter((r): r is string => !isNull(r));\n\n    // Remove duplicates if required\n    const uniqueResult = removeDuplicates ? [...new Set(result)] : result;\n\n    // If all results are the same, return just the first one\n    if (uniqueResult.length === 1) {\n      return uniqueResult[0] ?? null;\n    }\n\n    return uniqueResult;\n  }\n\n  // If url is a single string, process it and return the result\n  return processUrl(url);\n};\n","import { isBoolean } from \"@/predicates/is/isBoolean\";\nimport { hasOwnProp } from \"@/predicates/has/hasOwnProp\";\nimport { isEmptyString } from \"@/predicates/is/isEmptyString\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\nimport { assertIsPlainObject } from \"@/assertions/objects/assertIsPlainObject\";\n\ntype FormatEnvPortOptions = {\n  /** Add prefix with a colon, defaultValue: `false`.\n   *\n   * @default false\n   */\n  prefixColon?: boolean;\n};\n\n/** -----------------------------------------------\n * * ***Utility: `formatEnvPort`.***\n * -----------------------------------------------\n * **Retrieves and formats an environment port variable.**\n * - **Behavior:**\n *    - Extracts only digits from the input.\n *    - If no digits found, returns an empty string.\n *    - By default does NOT prefix with a colon.\n *      - Use `{ prefixColon: true }` to prefix with a colon.\n * @param {string | null | undefined} envVar The environment variable string.\n * @param {FormatEnvPortOptions} [options] Optional object: `{ prefixColon?: boolean }`.\n * @returns {string} A string like `\":8080\"` or `\"8080\"`, or `\"\"` if no digits.\n * @throws **{@link TypeError | `TypeError`}** if `options` is not an object or `prefixColon` is not boolean.\n * @example\n * formatEnvPort(\"port:8080\");\n * // ➔ \"8080\"\n * formatEnvPort(\"port:8080\", { prefixColon: true });\n * // ➔ \":8080\"\n */\nexport const formatEnvPort = (\n  envVar: string | null | undefined,\n  options: FormatEnvPortOptions = {}\n): string => {\n  if (!isNonEmptyString(envVar)) return \"\"; // Handle empty string case\n\n  assertIsPlainObject(options, {\n    message: ({ currentType, validType }) =>\n      `Second parameter (\\`options\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const prefixColon = hasOwnProp(options, \"prefixColon\")\n    ? options.prefixColon\n    : false;\n\n  if (!isBoolean(prefixColon)) {\n    throw new TypeError(\n      `Parameter \\`prefixColon\\` property of the \\`options\\` (second parameter) must be of type \\`boolean\\`, but received: \\`${getPreciseType(\n        prefixColon\n      )}\\`.`\n    );\n  }\n\n  const digitsOnly = envVar.replace(/\\D+/g, \"\");\n  if (isEmptyString(digitsOnly)) return \"\";\n\n  return prefixColon ? `:${digitsOnly}` : digitsOnly;\n};\n"],"mappings":"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"}