@rzl-zone/utils-js 3.1.1-beta.0 → 3.1.1

package/dist/conversions/index.d.ts

@@ -1,4 +1,4 @@
-import{A as AnyFunction,T as TypedArray,W as WebApiObjects,I as IntlObjects}from'../type-data-DDs-u2kq.js';import{N as NormalizeEmptyArraysRecursive,R as RemoveEmptyArrayElements,F as FixNeverArrayRecursive}from'../arrays-normalize-recursive-CnjYJ9xg.js';import{h as Nullish,a as KeepNull,b as KeepUndef}from'../nils-DMz3kU7M.js';import{I as IsAny}from'../any-BmdI8UbK.js';import{i as IfNotExtends,I as IfExtends}from'../extends-Bk_SBGdT.js';import{P as Prettify}from'../prettify-C4xLcYOP.js';import{N as NumberRangeUnion}from'../NumberRangeUnion-DC-C3_Kq.js';import'../if-CvT4R7Kh.js';import'../never-BfayMBF9.js';type ExcludeNil<T>=Exclude<T,null|undefined>;
+import{A as AnyFunction,T as TypedArray,W as WebApiObjects,I as IntlObjects}from'../type-data-DDs-u2kq.js';import{N as NormalizeEmptyArraysRecursive,R as RemoveEmptyArrayElements,F as FixNeverArrayRecursive}from'../arrays-normalize-recursive-CnjYJ9xg.js';import{h as Nullish,a as KeepNull,b as KeepUndef}from'../nils-DMz3kU7M.js';import{I as IsAny}from'../any-BmdI8UbK.js';import{i as IfNotExtends,I as IfExtends,E as Extends}from'../extends-Bk_SBGdT.js';import{P as Prettify}from'../prettify-C4xLcYOP.js';import{N as NumberRangeUnion}from'../NumberRangeUnion-DC-C3_Kq.js';import{O as OrArr,a as AndArr}from'../or-DyZCRvaU.js';import'../if-CvT4R7Kh.js';import'../never-BfayMBF9.js';type ExcludeNil<T>=Exclude<T,null|undefined>;
 /** ----------------------------------------------------------
  *  * ***Element extractor***
  * ----------------------------------------------------------
@@ -1030,7 +1030,9 @@ declare function removeObjectPaths<T extends Record<string,unknown>,K extends Co
  * -------------------------------------------------
  */
 type SafeStableStringifyOptions={
-/** Whether to sort **object keys** alphabetically (recursively).
+/** -------------------------------------------------
+ * * ***Whether to sort **object keys** alphabetically (recursively).***
+ * -------------------------------------------------
  *
  * - `true` (default): object keys are sorted to ensure stable output.
  * - `false`: preserves original insertion order of keys.
@@ -1038,7 +1040,9 @@ type SafeStableStringifyOptions={
  * @default true
  */
 sortKeys?:boolean;
-/** Whether to sort **primitive values inside arrays**.
+/** -------------------------------------------------
+ * * ***Whether to sort **primitive values inside arrays**.***
+ * -------------------------------------------------
  *
  * - `true`: primitive values in arrays are sorted to ensure stable output.
  * - `false` (default): arrays retain their original order; objects and nested arrays are not reordered.
@@ -1046,14 +1050,47 @@ sortKeys?:boolean;
  * @default false
  */
 sortArray?:boolean;
-/** Whether to pretty-print JSON output with 2-space indentation.
+/** -------------------------------------------------
+ * * ***Whether to pretty-print JSON output with 2-space indentation.***
+ * -------------------------------------------------
  *
  * - `true`: output is formatted with indentation and newlines.
  * - `false` (default): produces compact single-line JSON.
  *
  * @default false
  */
-pretty?:boolean;};
+pretty?:boolean;
+/** -------------------------------------------------
+ * * ***Preserve `undefined` values instead of converting them to `null`.***
+ * -------------------------------------------------
+ * **Controls how the internal `deepProcess` step rewrites values
+ * **before** the final `JSON.stringify` call.**
+ * - **Default (`false`)** – Every `undefined` value
+ *   (object properties **and** array elements)
+ *   is replaced with `null` **before** serialization.
+ *   Because this happens first, the key is **not removed** by
+ *   `JSON.stringify`.
+ * - **`true`** – Leaves `undefined` untouched so the final
+ *   `JSON.stringify` call behaves natively:
+ *     * Object properties with `undefined` are **removed**.
+ *     * Array elements that are `undefined` become `null`.
+ * @default false
+ * @example
+ * // ✅ keepUndefined = true: behaves like native JSON.stringify
+ * safeStableStringify({ a: undefined }, { keepUndefined: true });
+ * // → '{}' // key removed
+ *
+ * // ✅ Default (false): convert undefined to null, key kept
+ * safeStableStringify({ a: undefined });
+ * // → '{"a":null}' // key present, value null
+ *
+ * // Arrays
+ * safeStableStringify([undefined]);
+ * // → '[null]' // same, but via pre-replacement
+ * safeStableStringify([undefined], { keepUndefined: true });
+ * // → '[null]' // element becomes null
+ */
+keepUndefined?:boolean;};
 /** --------------------------------------------
  * * ***Utility: `safeStableStringify`.***
  * ---------------------------------------------
@@ -1083,6 +1120,15 @@ pretty?:boolean;};
  *        - Compared to `JSON.stringify`, this ensures **stable output**:
  *            - Same object structure always produces the same string.
  *            - Useful for deep equality checks, hashing, caching keys, or snapshot tests.
+ *        - Controls how `undefined` is handled **before** the final `JSON.stringify` call, by `keepUndefined`
+ *          options, default: `false`.
+ *            - **false**: All `undefined` values (object properties and array elements) are replaced
+ *            with `null`, so object keys remain.
+ *            - **true**: Leaves `undefined` values as-is, and handling by native `JSON.stringify` then:
+ *               1. Removes object properties that are `undefined`
+ *               2. Converts `undefined` array elements to `null`
+ *            - Use `true` when you need native removal of keys or to preserve sparse arrays
+ *              exactly as `JSON.stringify` would.
  * @param {*} value
  * -  Any JavaScript value to serialize, can be:
  *    - Primitives (`number`, `string`, `boolean`, `bigint`, `null`, `undefined`)
@@ -1092,6 +1138,8 @@ pretty?:boolean;};
  *    - Circular structures
  * @param {SafeStableStringifyOptions} [options]
  * - Configuration options for `safeStableStringify`:
+ *    - `keepUndefined` (boolean) – Control how `undefined` is handled **before** the final `JSON.stringify`
+ *       call, default: `false`.
  *    - `sortKeys` (boolean) – Whether to sort object keys alphabetically (recursively), default: `true`.
  *    - `sortArray` (boolean) – Whether to sort primitive values inside arrays, default: `false`.
  *    - `pretty` (boolean) – Whether to pretty-print JSON output with 2-space indentation, default: `false`.
@@ -1117,6 +1165,14 @@ pretty?:boolean;};
  * });
  * // ➔ '[1,2,3]'
  *
+ * // keepUndefined = true (native removal of keys)
+ * safeStableStringify({ a: undefined }, { keepUndefined: true });
+ * // ➔ '{}'   // key `a` is removed, like native JSON.stringify
+ *
+ * // Default keepUndefined = false (convert to null, keep key)
+ * safeStableStringify({ a: undefined });
+ * // ➔ '{"a":null}'
+ *
  * // Nested object + sortArray=true
  * safeStableStringify({ z: [3, 1, 2], x: { d: 4, c: 3 } }, {
  *    sortKeys:true,
@@ -1158,7 +1214,7 @@ pretty?:boolean;};
  * safeStableStringify({ f: () => {}, s: Symbol("wow") });
  * // ➔ '{}'
  *
- * // undefined, NaN, Infinity convert to null
+ * // undefined, NaN, Infinity convert to null (keepUndefined = false or keepUndefined = true)
  * safeStableStringify([undefined, NaN, Infinity, -Infinity]);
  * // ➔ '[null,null,null,null]'
  *
@@ -1183,11 +1239,27 @@ declare const safeStableStringify:(value:unknown,options?:SafeStableStringifyOpt
  *    - `"stringOrNumber"`: Converts strings and numbers to strings.
  *    - `"primitives"`: Converts all primitives (number, string, boolean, bigint, undefined, null, NaN) to strings.
  *    - `"all"`: Converts everything, including symbols, functions, Dates, RegExp, Maps, Sets, Errors, Promises,
- *   and deeply all object properties, to strings.
+ *       boxed primitives box (new Number, new String, new Boolean), and deeply all object properties, to strings.
  *    - `false`: Leaves everything unchanged.
  * - **Special behaviors:**
  *    - `NaN` ➔ `"NaN"` only in `"primitives"` or `"all"` mode.
  *    - `Date` ➔ ISO string only in `"all"` mode.
+ *    -  ***Primitives Boxed*** (`new Number`, `new String`, `new Boolean`):
+ *       - For `new String` we convert everything to string (behavior JS of new String):
+ *         - `new String("hi")` ➔ `.valueOf()` ➔ `"hi"`.
+ *         - `new String(true)` ➔ `.valueOf()` ➔ `"true"`.
+ *       - For `new Boolean` we convert to boolean (behavior JS of new Boolean) then convert to string:
+ *         - `new Boolean(true)` ➔ `.valueOf()` ➔ `true` ➔ `true.toString()` ➔ `"true"`.
+ *         - Special behavior JS of new Boolean, return `false` **(convert to string: `"false"`)**
+ *           for `false`, (`0` / `-0`), `""` (empty-string), `null`, `undefined`, `NaN`, otherwise
+ *           `true` **(convert to string: `"true"`)**.
+ *       - For `new Number`:
+ *         - `new Number(42)` ➔ `.valueOf()` ➔ `42` ➔ `42.toString()` ➔ `"42"`.
+ *         - `new Number(NaN)` ➔ `.valueOf()` ➔ `NaN` ➔ `NaN.toString()` ➔ `"NaN"`.
+ *         - `new Number(null)` ➔ `.valueOf()` ➔ `0` (`null` is `0` behavior JS of new Number) ➔ `0.toString()` ➔ `"0"`.
+ *         - `new Number(undefined)` ➔ `.valueOf()` ➔ `NaN` ➔ `NaN.toString()` ➔ `"NaN"`.
+ *         - `new Number(Infinity)` ➔ `Infinity` ➔ `Infinity` ➔ `Infinity.toString()` ➔ `"Infinity"`.
+ *         - `new Number(-Infinity)` ➔ `-Infinity` ➔ `-Infinity` ➔ `-Infinity.toString()` ➔ `"-Infinity"`.
  *    - `RegExp` ➔ Source string (e.g. `/abc/i`) only in `"all"` mode.
  *    - `Symbol` ➔ `Symbol(description)` string only in `"all"` mode.
  *    - `Map` ➔ Array of [key, value] pairs with keys/values stringified deeply (only in `"all"` mode).
@@ -1206,6 +1278,12 @@ declare const safeStableStringify:(value:unknown,options?:SafeStableStringifyOpt
  * // ➔ "null"
  * toStringDeepForce(Symbol("x"), "all");
  * // ➔ "Symbol(x)"
+ * toStringDeepForce(new String("hi"), "all");
+ * // ➔ "hi"
+ * toStringDeepForce(new Number(42), "all");
+ * // ➔ "42"
+ * toStringDeepForce(new Boolean(true), "all");
+ * // ➔ "true"
  * toStringDeepForce({ a: 1, b: [2, NaN] }, "primitives");
  * // ➔ { a: "1", b: ["2", "NaN"] }
  * toStringDeepForce(new Date("2025-01-01"), "all");
@@ -1227,12 +1305,12 @@ declare const safeStableStringify:(value:unknown,options?:SafeStableStringifyOpt
  * toStringDeepForce([1, "a", { b: 2 }], false);
  * // ➔ [1, "a", { b: 2 }]
  */
-declare function toStringDeepForce(value:unknown,forceToString:false|"stringOrNumber"|"primitives"|"all"):unknown;
+declare function toStringDeepForce<T>(value:unknown,forceToString:false|"stringOrNumber"|"primitives"|"all"):T;
 /** ----------------------------------------------------------
  * * Normalize leaked `never[]` into literal empty array `[]`.
  * ----------------------------------------------------------
  */
-type FixNeverArray$1<T>=[T] extends [never[]]?[]:T;
+type FixNeverArray$1<T,RemoveEmptyArrays extends boolean>=[T] extends [never[]]?RemoveEmptyArrays extends true?OrArr<[Extends<T,undefined>,Extends<undefined,T>]>extends true?undefined:never:[]:T;
 /** ----------------------------------------------------------
  * * Simplify object type to remove unnecessary TypeScript wrappers.
  * ----------------------------------------------------------
@@ -1249,24 +1327,19 @@ type Simplify$1<T>=T extends object?{[K in keyof T]:T[K];}:T;
  * @template RemoveEmptyArrays - Whether to remove empty arrays
  * @template IsRoot - Internal flag for root level
  */
-type ConvertedDeepNumberInternal<T,RemoveEmptyObjects extends boolean,RemoveEmptyArrays extends boolean,IsRoot extends boolean>=[ T] extends [null|undefined]?IsRoot extends true?undefined:never:T extends number|`${number}`|string?number|undefined:T extends readonly(infer E)[]?FixNeverArray$1<T extends readonly [any,...any[]]?_MapTuple$1<T,RemoveEmptyObjects,RemoveEmptyArrays>:ConvertedDeepNumberInternal<E,RemoveEmptyObjects,RemoveEmptyArrays,false>[]>:T extends Set<infer V>?FixNeverArray$1<ConvertedDeepNumberInternal<V,RemoveEmptyObjects,RemoveEmptyArrays,false>[]>:T extends Map<infer K,infer V>?FixNeverArray$1<[ ConvertedDeepNumberInternal<K,RemoveEmptyObjects,RemoveEmptyArrays,false>,ConvertedDeepNumberInternal<V,RemoveEmptyObjects,RemoveEmptyArrays,false>][]>:T extends Buffer?RemoveEmptyArrays extends true?IsRoot extends true?(number|undefined)[]:never:(number|undefined)[]:T extends TypedArray?FixNeverArray$1<ConvertedDeepNumberInternal<number,RemoveEmptyObjects,RemoveEmptyArrays,false>[]>:T extends Date?_ConvertedObjectInternal$1<number,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>:T extends RegExp|WebApiObjects|IntlObjects|{[Symbol.toStringTag]:"Proxy";}|typeof Reflect?RemoveEmptyObjects extends true?IsRoot extends true?{}:never:{}:T extends Record<string|number|symbol,unknown>?_ConvertedObjectInternal$1<T,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>:never;
-/** ----------------------------------------------------------
- * * Recursively map tuples while preserving `never` removals.
- * ----------------------------------------------------------
- */
-type _MapTuple$1<Arr extends readonly unknown[],RemoveEmptyObjects extends boolean,RemoveEmptyArrays extends boolean>=Arr extends readonly [infer H,...infer R]?Exclude<ConvertedDeepNumberInternal<H,RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>extends infer H2?[H2] extends [never]?_MapTuple$1<R,RemoveEmptyObjects,RemoveEmptyArrays>:[H2,..._MapTuple$1<R,RemoveEmptyObjects,RemoveEmptyArrays>]:never:[];
+type ConvertedDeepNumberInternal<T,RemoveEmptyObjects extends boolean,RemoveEmptyArrays extends boolean,IsRoot extends boolean>=[T] extends [null|undefined]?IsRoot extends true?undefined:never:T extends Date|boolean|Boolean?number:T extends string|String|Number|number|`${number}`?number|undefined:AndArr<[Extends<RemoveEmptyArrays,true>,Extends<T,undefined[]>]>extends true?never:T extends readonly(infer E)[]?OrArr<[ Extends<RemoveEmptyArrays,true>,AndArr<[Extends<RemoveEmptyArrays,true>,Extends<IsRoot,true>]>]>extends true?FixNeverArray$1<Exclude<ConvertedDeepNumberInternal<E,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>,undefined>,RemoveEmptyArrays>[]|undefined:FixNeverArray$1<Exclude<ConvertedDeepNumberInternal<E,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>,undefined>[],RemoveEmptyArrays>:T extends Set<infer V>?AndArr<[Extends<RemoveEmptyArrays,true>]>extends true?FixNeverArray$1<Exclude<ConvertedDeepNumberInternal<V,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>,undefined>[],RemoveEmptyArrays>:FixNeverArray$1<Exclude<ConvertedDeepNumberInternal<V,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>,undefined>[],RemoveEmptyArrays>:T extends Map<infer K,infer V>?FixNeverArray$1<[ Exclude<ConvertedDeepNumberInternal<K,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>,undefined>,Exclude<ConvertedDeepNumberInternal<V,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>,undefined>][],RemoveEmptyArrays>:T extends Buffer?FixNeverArray$1<Exclude<ConvertedDeepNumberInternal<string,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>,undefined>[],RemoveEmptyArrays>:T extends TypedArray?FixNeverArray$1<Exclude<ConvertedDeepNumberInternal<string,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>,undefined>[],RemoveEmptyArrays>:T extends Record<PropertyKey,unknown>?_ConvertedObjectInternal$1<T,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>:never;
 /** ----------------------------------------------------------
  * * Internal object conversion utility.
  * * Removes empty objects/arrays based on flags.
  * ----------------------------------------------------------
  */
-type _ConvertedObjectInternal$1<O extends Record<string|number|symbol,unknown>|number,RemoveEmptyObjects extends boolean,RemoveEmptyArrays extends boolean,IsRoot extends boolean>={[K in keyof O as Exclude<ConvertedDeepNumberInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>extends infer Convert?[Convert] extends [never]?never:undefined extends ConvertedDeepNumberInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>?never:RemoveEmptyArrays extends true?Convert extends readonly unknown[]?[Convert] extends [[]]?O[K] extends TypedArray|Set<any>|Map<any,any>?K:never:K:K:K:never]:Exclude<ConvertedDeepNumberInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>;}&{[K in keyof O as Exclude<ConvertedDeepNumberInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>extends infer Convert?[Convert] extends [never]?never:undefined extends ConvertedDeepNumberInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>?RemoveEmptyArrays extends true?Convert extends readonly unknown[]?[Convert] extends [[]]?O[K] extends TypedArray|Set<any>|Map<any,any>?K:never:K:K:K:never:never]?:Exclude<ConvertedDeepNumberInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>;}extends infer M?RemoveEmptyObjects extends true?keyof M extends never?IsRoot extends true?{}:never:Simplify$1<M>:Simplify$1<M>:never;
+type _ConvertedObjectInternal$1<O extends Record<PropertyKey,unknown>|string|number,RemoveEmptyObjects extends boolean,RemoveEmptyArrays extends boolean,IsRoot extends boolean>={[K in keyof O as Exclude<ConvertedDeepNumberInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>extends infer Convert?[Convert] extends [never]?never:undefined extends ConvertedDeepNumberInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>?never:RemoveEmptyArrays extends true?Convert extends readonly unknown[]?[Convert] extends [[]]?never:K:K:K:never]:Exclude<ConvertedDeepNumberInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>;}&{[K in keyof O as Exclude<ConvertedDeepNumberInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>extends infer Convert?[Convert] extends [never]?never:undefined extends ConvertedDeepNumberInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>?RemoveEmptyArrays extends true?Convert extends readonly unknown[]?[Convert] extends [[]]?never:K:K:K:never:never]?:Exclude<ConvertedDeepNumberInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>;}extends infer M?RemoveEmptyObjects extends true?keyof M extends never?IsRoot extends true?{}:never:_ProcessedObject$1<M,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>:Simplify$1<M>:never;type AllPropsAreNumber$1<O>={[K in keyof O]:O[K] extends number|Number?true:O[K] extends Record<string,unknown>?AllPropsAreNumber$1<O[K]>:false;}[keyof O] extends false?false:true;type _ProcessedObject$1<M,RemoveEmptyObjects extends boolean,RemoveEmptyArrays extends boolean,IsRoot extends boolean>=M extends unknown[]?ConvertedDeepNumberInternal<M,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>:Prettify<Simplify$1<{[K in keyof M]:M[K] extends Record<string,unknown>?AllPropsAreNumber$1<M[K]>extends true?{[ChildKey in keyof M[K]]:M[K][ChildKey] extends number|Number?M[K][ChildKey]|undefined:_ProcessedObject$1<M[K][ChildKey],RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>;}|undefined:AndArr<[ Extends<RemoveEmptyArrays,true>,Extends<RemoveEmptyObjects,true>]>extends true?{[ChildKey in keyof M[K]]:_ProcessChild$1<M[K][ChildKey],RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>;}|undefined:{[ChildKey in keyof M[K]]:_ProcessChild$1<M[K][ChildKey],RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>;}:M[K] extends unknown[]?ConvertedDeepNumberInternal<M[K],RemoveEmptyObjects,RemoveEmptyArrays,false>:_ProcessedObject$1<M[K],RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>;}>,{recursive:true;}>;type _ProcessChild$1<T,RemoveEmptyObjects extends boolean,RemoveEmptyArrays extends boolean,IsRoot extends boolean>=T extends number|number[]?ConvertedDeepNumberInternal<T,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>:T extends Record<string,unknown>?_ProcessedObject$1<T,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>:_ProcessedObject$1<T,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>;
 /** ----------------------------------------------------------
  * * Public type: Deeply converts numbers/strings to `number | undefined`,
  * * applies empty object/array removal, preserves special types.
  * ----------------------------------------------------------
  */
-type ConvertedDeepNumber<T,RemoveEmptyObjects extends boolean=false,RemoveEmptyArrays extends boolean=false>=[unknown] extends [T]?unknown:FixNeverArray$1<ConvertedDeepNumberInternal<T,RemoveEmptyObjects,RemoveEmptyArrays,true>>;type ToNumberDeepOptions<RemoveEmptyObjects extends boolean=false,RemoveEmptyArrays extends boolean=false>={
+type ConvertedDeepNumber<T,RemoveEmptyObjects extends boolean=false,RemoveEmptyArrays extends boolean=false>=[unknown] extends [T]?unknown:FixNeverArray$1<ConvertedDeepNumberInternal<T,RemoveEmptyObjects,RemoveEmptyArrays,true>,RemoveEmptyArrays>;type ToNumberDeepOptions<RemoveEmptyObjects extends boolean=false,RemoveEmptyArrays extends boolean=false>={
 /** Whether to remove empty objects (`{}`) from the result.
  *
  * - `true` ➔ remove empty objects recursively.
@@ -1288,13 +1361,45 @@ removeEmptyArrays?:RemoveEmptyArrays;};
  * ---------------------------------------------------
  * **Converts deeply nested arrays, objects, buffers, sets, maps, or typed arrays into numbers while preserving structure.**
  * - **Features:**
- *    - Removes `null`, `undefined`, `NaN`, `Infinity`, `-Infinity`, empty-string, non-numeric strings, and functions.
- *    - Recursively processes nested objects, arrays, buffers, sets, maps, and typed arrays.
- *    - Converts numeric strings to numbers (e.g., `"3.5"` ➔ `3.5`).
- *    - Keeps empty objects `{}` unless `removeEmptyObjects: true`.
- *    - Keeps empty arrays `[]` unless `removeEmptyArrays: true`.
- *    - Buffers and TypedArrays are converted into arrays of numbers.
- *    - Date objects are converted into their timestamp (`number`).
+ *    - Converts numeric strings, number to numbers:
+ *      - `3.5` ➔ `3.5`.
+ *      - `"3.5"` ➔ `3.5`.
+ *    - Converts boolean to number:
+ *      - `true` ➔ `1`.
+ *      - `false` ➔ `0`.
+ *    - Converts Date to getTime (timestamp) `Date ➔ number`, if invalid Date value will return `0`:
+ *      - `new Date("invalid")` ➔ `0`.
+ *      - `new Date("11-09-2025 22:04:11")` ➔ `1762700651000`.
+ *    - Converts `Buffer`, `TypedArray`, `Set`, `Map`, and `arrays` recursively to `arrays of numbers`.
+ *    - Converts boxed primitives box into their primitive equivalents then convert to number:
+ *      - For `new String` we convert everything to number (behavior JS of new String):
+ *        - `new String(123)` ➔ `.valueOf()` ➔ `"123"` ➔ `Number("123")` ➔ `123`.
+ *        - `new String("123")` ➔ `.valueOf()` ➔ `"123"` ➔ `Number("123")` ➔ `123`.
+ *        - `new String(true)` ➔ `.valueOf()` ➔ `"true"` ➔ `Number(true)` ➔ `1`.
+ *        - `new String(false)` ➔ `.valueOf()` ➔ `"false"` ➔ `Number(false)` ➔ `0`.
+ *        - If result from `valueOf()` is `NaN` or `Infinity` ***(will removing)***:
+ *          - `new String("hi")` ➔ `.valueOf()` ➔ `"hi"` ➔ `Number("hi")` ➔ `NaN` ***(remove)***.
+ *          - `new String(()=>{})` ➔ `.valueOf()` ➔ `"()=>{}"` ➔ `Number("()=>{}")` ➔ `NaN` ***(remove)***.
+ *      - For `new Boolean` we convert to boolean (behavior JS of new Boolean) then convert to number:
+ *        - `new Boolean(true)` ➔ `.valueOf()` ➔ `true` ➔ `Number(true)` ➔ `1`.
+ *        - `new Boolean(false)` ➔ `.valueOf()` ➔ `false` ➔ `Number(false)` ➔ `0`.
+ *        - Special behavior JS of new Boolean, return `false` **(convert to number: `0`)**
+ *          for `false`, (`0` / `-0`), `""` (empty-string),
+ *          `null`, `undefined`, `NaN`, otherwise `true` **(convert to number: `1`)**.
+ *      - For `new Number`:
+ *        - `new Number(42)` ➔ `.valueOf()` ➔ `42`.
+ *        - `new Number("42")` ➔ `.valueOf()` ➔ `42`.
+ *        - `new Number(null)` ➔ `.valueOf()` ➔ `0` (`null` is `0` behavior JS of new Number).
+ *        - If result from `valueOf()` is `NaN` or `Infinity` ***(will removing)***:
+ *          - `new Number(NaN)` ➔ `.valueOf()` ➔ `NaN` ***(remove)***.
+ *          - `new Number(undefined)` ➔ `.valueOf()` ➔ `NaN` ***(remove)***.
+ *          - `new Number(Infinity)` ➔ `.valueOf()` ➔ `Infinity` ***(remove)***.
+ *          - `new Number(-Infinity)` ➔ `.valueOf()` ➔ `-Infinity` ***(remove)***.
+ *    - Recursively processes `nested objects`, `arrays`, `buffers`, `sets`, `maps`, and `typed arrays`.
+ *    - Removes `empty-string`, `non-numeric strings`.
+ *    - Removes `null`, `undefined`, `NaN`, `Infinity`, `-Infinity`.
+ *    - Removes `unsupported` types like `functions` , `RegExp`, `symbols`, and `BigInt`.
+ *    - Can optionally remove empty arrays (`[]`) and/or empty objects (`{}`) **recursively**.
  * @template T - The input type.
  * @template RemoveEmptyObjects - Whether to remove empty objects.
  * @template RemoveEmptyArrays - Whether to remove empty arrays.
@@ -1335,7 +1440,7 @@ declare function toNumberDeep(input?:null|undefined,options?:ToNumberDeepOptions
 /** ----------------------------------------------------------
  * * Normalize leaked `never[]` into literal empty array `[]`.
  * ---------------------------------------------------------- */
-type FixNeverArray<T,RemoveEmptyArrays extends boolean>=[T] extends [never[]]?RemoveEmptyArrays extends true?T extends undefined?undefined:never:[]:T;
+type FixNeverArray<T,RemoveEmptyArrays extends boolean>=[T] extends [never[]]?RemoveEmptyArrays extends true?OrArr<[Extends<T,undefined>,Extends<undefined,T>]>extends true?undefined:never:[]:T;
 /** ----------------------------------------------------------
  * * Simplify object type to remove unnecessary TypeScript wrappers.
  * ---------------------------------------------------------- */
@@ -1345,16 +1450,12 @@ type Simplify<T>=T extends object?{[K in keyof T]:T[K];}:T;
  * * recursively handling arrays, tuples, Sets, Maps, TypedArrays,
  * * Buffer, and objects. Special types like Date remain unchanged.
  * ---------------------------------------------------------- */
-type ConvertedDeepStringInternal<T,RemoveEmptyObjects extends boolean,RemoveEmptyArrays extends boolean,IsRoot extends boolean>=[T] extends [null|undefined]?IsRoot extends true?undefined:never:T extends number|string|Date|RegExp|WebApiObjects|IntlObjects|{[Symbol.toStringTag]:"Proxy";}|typeof Reflect?string:T extends readonly(infer E)[]?FixNeverArray<T extends readonly [any,...any[]]?_MapTuple<T,RemoveEmptyObjects,RemoveEmptyArrays>:ConvertedDeepStringInternal<E,RemoveEmptyObjects,RemoveEmptyArrays,false>[],RemoveEmptyArrays>:T extends Set<infer V>?FixNeverArray<ConvertedDeepStringInternal<V,RemoveEmptyObjects,RemoveEmptyArrays,false>[],RemoveEmptyArrays>:T extends Map<infer K,infer V>?FixNeverArray<[ ConvertedDeepStringInternal<K,RemoveEmptyObjects,RemoveEmptyArrays,false>,ConvertedDeepStringInternal<V,RemoveEmptyObjects,RemoveEmptyArrays,false>][],RemoveEmptyArrays>:T extends Buffer?FixNeverArray<ConvertedDeepStringInternal<string,RemoveEmptyObjects,RemoveEmptyArrays,false>[],RemoveEmptyArrays>:T extends TypedArray?FixNeverArray<ConvertedDeepStringInternal<string,RemoveEmptyObjects,RemoveEmptyArrays,false>[],RemoveEmptyArrays>:T extends Record<string|number|symbol,unknown>?_ConvertedObjectInternal<T,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>:never;
-/** ----------------------------------------------------------
- * * Remove undefined and keep only items for tuples
- * ---------------------------------------------------------- */
-type _MapTuple<Arr extends readonly unknown[],RemoveEmptyObjects extends boolean,RemoveEmptyArrays extends boolean>=Arr extends readonly [infer H,...infer R]?Exclude<ConvertedDeepStringInternal<H,RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>extends infer H2?[H2] extends [never]?_MapTuple<R,RemoveEmptyObjects,RemoveEmptyArrays>:[H2,..._MapTuple<R,RemoveEmptyObjects,RemoveEmptyArrays>]:never:[];
+type ConvertedDeepStringInternal<T,RemoveEmptyObjects extends boolean,RemoveEmptyArrays extends boolean,IsRoot extends boolean>=[T] extends [null|undefined]?IsRoot extends true?undefined:never:T extends string|boolean|String|Boolean|Date|RegExp|WebApiObjects|IntlObjects|{[Symbol.toStringTag]:"Proxy";}|typeof Reflect?string:T extends Number|number|`${number}`?string|undefined:AndArr<[Extends<RemoveEmptyArrays,true>,Extends<T,undefined[]>]>extends true?never:T extends readonly(infer E)[]?OrArr<[ Extends<RemoveEmptyArrays,true>,AndArr<[Extends<RemoveEmptyArrays,true>,Extends<IsRoot,true>]>]>extends true?FixNeverArray<Exclude<ConvertedDeepStringInternal<E,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>,undefined>,RemoveEmptyArrays>[]|undefined:FixNeverArray<Exclude<ConvertedDeepStringInternal<E,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>,undefined>[],RemoveEmptyArrays>:T extends Set<infer V>?AndArr<[Extends<RemoveEmptyArrays,true>]>extends true?FixNeverArray<Exclude<ConvertedDeepStringInternal<V,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>,undefined>,RemoveEmptyArrays>:FixNeverArray<Exclude<ConvertedDeepStringInternal<V,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>,undefined>[],RemoveEmptyArrays>:T extends Map<infer K,infer V>?FixNeverArray<[ Exclude<ConvertedDeepStringInternal<K,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>,undefined>,Exclude<ConvertedDeepStringInternal<V,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>,undefined>][],RemoveEmptyArrays>:T extends Buffer?FixNeverArray<Exclude<ConvertedDeepStringInternal<string,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>,undefined>[],RemoveEmptyArrays>:T extends TypedArray?FixNeverArray<Exclude<ConvertedDeepStringInternal<string,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>,undefined>[],RemoveEmptyArrays>:T extends Record<PropertyKey,unknown>?_ConvertedObjectInternal<T,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>:never;
 /** ----------------------------------------------------------
  * * Internal object conversion utility.
  * * Removes empty objects/arrays based on flags.
  * ---------------------------------------------------------- */
-type _ConvertedObjectInternal<O extends Record<string|number|symbol,unknown>|string,RemoveEmptyObjects extends boolean,RemoveEmptyArrays extends boolean,IsRoot extends boolean>={[K in keyof O as Exclude<ConvertedDeepStringInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>extends infer Convert?[Convert] extends [never]?never:undefined extends ConvertedDeepStringInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>?never:RemoveEmptyArrays extends true?Convert extends readonly unknown[]?[Convert] extends [[]]?never:K:K:K:never]:Exclude<ConvertedDeepStringInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>;}&{[K in keyof O as Exclude<ConvertedDeepStringInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>extends infer Convert?[Convert] extends [never]?never:undefined extends ConvertedDeepStringInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>?RemoveEmptyArrays extends true?Convert extends readonly unknown[]?[Convert] extends [[]]?never:K:K:K:never:never]?:Exclude<ConvertedDeepStringInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>;}extends infer M?RemoveEmptyObjects extends true?keyof M extends never?IsRoot extends true?{}:never:Simplify<M>:Simplify<M>:never;
+type _ConvertedObjectInternal<O extends Record<string|number|symbol,unknown>|string,RemoveEmptyObjects extends boolean,RemoveEmptyArrays extends boolean,IsRoot extends boolean>={[K in keyof O as Exclude<ConvertedDeepStringInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>extends infer Convert?[Convert] extends [never]?never:undefined extends ConvertedDeepStringInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>?never:RemoveEmptyArrays extends true?Convert extends readonly unknown[]?[Convert] extends [[]]?never:K:K:K:never]:Exclude<ConvertedDeepStringInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>;}&{[K in keyof O as Exclude<ConvertedDeepStringInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>extends infer Convert?[Convert] extends [never]?never:undefined extends ConvertedDeepStringInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>?RemoveEmptyArrays extends true?Convert extends readonly unknown[]?[Convert] extends [[]]?never:K:K:K:never:never]?:Exclude<ConvertedDeepStringInternal<O[K],RemoveEmptyObjects,RemoveEmptyArrays,false>,undefined>;}extends infer M?RemoveEmptyObjects extends true?keyof M extends never?IsRoot extends true?{}:never:_ProcessedObject<M,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>:Simplify<M>:never;type AllPropsAreNumber<O>={[K in keyof O]:O[K] extends number|Number?true:O[K] extends Record<string,unknown>?AllPropsAreNumber<O[K]>:false;}[keyof O] extends false?false:true;type _ProcessedObject<M,RemoveEmptyObjects extends boolean,RemoveEmptyArrays extends boolean,IsRoot extends boolean>=M extends unknown[]?ConvertedDeepStringInternal<M,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>:Prettify<Simplify<{[K in keyof M]:M[K] extends Record<string,unknown>?AllPropsAreNumber<M[K]>extends true?{[ChildKey in keyof M[K]]:M[K][ChildKey] extends number|Number?M[K][ChildKey]|undefined:_ProcessedObject<M[K][ChildKey],RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>;}|undefined:AndArr<[ Extends<RemoveEmptyArrays,true>,Extends<RemoveEmptyObjects,true>]>extends true?{[ChildKey in keyof M[K]]:_ProcessChild<M[K][ChildKey],RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>;}|undefined:{[ChildKey in keyof M[K]]:_ProcessChild<M[K][ChildKey],RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>;}:M[K] extends unknown[]?ConvertedDeepStringInternal<M[K],RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>:_ProcessedObject<M[K],RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>;}>,{recursive:true;}>;type _ProcessChild<T,RemoveEmptyObjects extends boolean,RemoveEmptyArrays extends boolean,IsRoot extends boolean>=T extends number|Number[]?ConvertedDeepStringInternal<T,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>:T extends Record<string,unknown>?_ProcessedObject<T,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>:_ProcessedObject<T,RemoveEmptyObjects,RemoveEmptyArrays,IsRoot>;
 /** ----------------------------------------------------------
  * * Public type: Deeply converts numbers/strings to `string`,
  * * applies empty object/array removal, preserves special types.
@@ -1381,15 +1482,39 @@ removeEmptyArrays?:RemoveEmptyArrays;};
  * ---------------------------------------------------
  * **Converts all values in an array, object, Set, Map, or deeply nested structure to string.**
  * - **Features:**
- *    - Converts numbers and strings to string (e.g., `123` ➔ `"123"`).
+ *    - Converts numbers and strings to string:
+ *      - `3.5` ➔ `"3.5"`.
+ *      - `"3.5"` ➔ `"3.5"`.
+ *    - Converts boolean to string:
+ *      - `true` ➔ `"true"`.
+ *      - `false` ➔ `"false"`.
  *    - Converts Date to ISO string (`Date ➔ string`).
  *    - Converts RegExp to string (e.g., `/abc/ ➔ "/abc/"`).
- *    - Converts Buffer, TypedArray, Set, Map, and arrays recursively to arrays of strings.
+ *    - Converts `Buffer`, `TypedArray`, `Set`, `Map`, and `arrays` recursively to `arrays of strings`.
+ *    - Converts boxed primitives box into their primitive equivalents then convert to string:
+ *      - For `new String` we convert everything to string (behavior JS of new String):
+ *        - `new String("hi")` ➔ `.valueOf()` ➔ `"hi"`.
+ *        - `new String(true)` ➔ `.valueOf()` ➔ `"true"`.
+ *      - For `new Boolean` we convert to boolean (behavior JS of new Boolean) then convert to string:
+ *        - `new Boolean(true)` ➔ `.valueOf()` ➔ `true` ➔ `true.toString()` ➔ `"true"`.
+ *        - Special behavior JS of new Boolean, return `false` **(convert to string: `"false"`)**
+ *          for `false`, (`0` / `-0`), `""` (empty-string), `null`, `undefined`, `NaN`, otherwise
+ *          `true` **(convert to string: `"true"`)**.
+ *      - For `new Number`:
+ *        - `new Number(42)` ➔ `.valueOf()` ➔ `42` ➔ `42.toString()` ➔ `"42"`.
+ *        - `new Number("42")` ➔ `.valueOf()` ➔ `42` ➔ `42.toString()` ➔ `"42"`.
+ *        - `new Number(null)` ➔ `.valueOf()` ➔ `0` (`null` is `0` behavior JS of new Number) ➔ `0.toString()` ➔ `"0"`.
+ *        - If result from `valueOf()` is `NaN` or `Infinity` ***(will removing)***:
+ *          - `new Number(NaN)` ➔ `.valueOf()` ➔ `NaN` ***(remove)***.
+ *          - `new Number("abc")` ➔ `.valueOf()` ➔ `NaN`  ***(remove)***.
+ *          - `new Number(undefined)` ➔ `.valueOf()` ➔ `NaN` ***(remove)***.
+ *          - `new Number(Infinity)` ➔ `.valueOf()` ➔ `Infinity` ***(remove)***.
+ *          - `new Number(-Infinity)` ➔ `.valueOf()` ➔ `-Infinity` ***(remove)***.
+ *    - Recursively processes `nested objects`, `arrays`, `buffers`, `sets`, `maps`, and `typed arrays`.
  *    - Removes `null`, `undefined`, `NaN`, `Infinity`, `-Infinity`.
- *    - Removes unsupported types like functions, symbols, and BigInt.
- *    - Recursively processes nested objects, arrays, Sets, and Maps.
+ *    - Removes `unsupported` types like `functions`, `symbols`, and `BigInt`.
  *    - Can optionally remove empty arrays (`[]`) and/or empty objects (`{}`) **recursively**.
- * @template T - The input data type (primitive, object, array, Set, Map, or any nested combination).
+ * @template T - The input data type (`primitive`, `object`, `array`, `Set`, `Map`, or `any nested combination`).
  * @template RemoveEmptyObjects - If `true`, empty objects `{}` will be removed recursively.
  * @template RemoveEmptyArrays - If `true`, empty arrays `[]` will be removed recursively (including arrays nested in `objects` / `arrays` / `Sets` / `Maps`).
  * @param {*} input - The data to convert.
@@ -1402,13 +1527,23 @@ removeEmptyArrays?:RemoveEmptyArrays;};
  * toStringDeep([1, "2", 3]);
  * // ➔ ["1", "2", "3"]
  *
+ * // Simple top-level conversion
+ * toStringDeep(123);
+ * // ➔ "123"
+ * toStringDeep("123");
+ * // ➔ "123"
+ * toStringDeep(true);
+ * // ➔ "true"
+ * toStringDeep(false);
+ * // ➔ "false"
+ *
  * // Nested arrays
- * toStringDeep([1, ["2", [3, [null, "4"]]]]);
- * // ➔ ["1", ["2", ["3", ["4"]]]]
+ * toStringDeep([1, ["2", [3, [null, "4", true, false]]]]);
+ * // ➔ ["1", ["2", ["3", ["4", "true", "false"]]]]
  *
  * // Object with nested values
- * toStringDeep({ a: 1, b: "2", c: { d: 3, e: null } });
- * // ➔ { a: "1", b: "2", c: { d: "3" } }
+ * toStringDeep({ a: 1, b: "2", c: { d: 3, e: null, f: true, g: false } });
+ * // ➔ { a: "1", b: "2", c: { d: "3", f: "true", g: "false" } }
  *
  * // Removing empty objects
  * toStringDeep({ a: {}, b: "1" }, { removeEmptyObjects: true });

package/dist/conversions/index.js

@@ -1 +1 @@
-export{f as convertType,g as removeObjectPaths,b as toBooleanContent,c as toBooleanContentDeep,d as toBooleanExplicit,e as toBooleanLoose,a as toNumberArrayUnRecursive,h as toNumberDeep,i as toStringDeep}from'../chunk-VPW3DRV5.js';export{b as cleanParsedData,a as extractDigits,c as parseCustomDate,d as safeJsonParse}from'../chunk-EEQY5QUG.js';import'../chunk-J7JAZAJD.js';export{c as dedupeArray,b as filterNilArray,d as toStringArrayUnRecursive,a as toStringDeepForce}from'../chunk-W32WALNU.js';import'../chunk-7MMJZ6HS.js';import'../chunk-LQ76EDZG.js';import'../chunk-SL3RQOWA.js';export{a as parseCurrencyString}from'../chunk-7VX33E3V.js';import'../chunk-ESJYBIYH.js';import'../chunk-SYJC7UAW.js';import'../chunk-7CHFAMS2.js';import'../chunk-NJSAV73S.js';export{c as safeStableStringify}from'../chunk-J4NCYYGS.js';import'../chunk-5SZUSNGZ.js';import'../chunk-EWYPSKKM.js';
+export{convertType,removeObjectPaths,toBooleanContent,toBooleanContentDeep,toBooleanExplicit,toBooleanLoose,toNumberArrayUnRecursive,toNumberDeep,toStringDeep}from"../chunk-WFPQO7KN.js";export{cleanParsedData,extractDigits,parseCustomDate,safeJsonParse}from"../chunk-G2B35D5W.js";import"../chunk-NXWPZDDX.js";export{dedupeArray,filterNilArray,toStringArrayUnRecursive,toStringDeepForce}from"../chunk-Y44ZD3GG.js";import"../chunk-X4PD3I5U.js";import"../chunk-GRSCNTOK.js";import"../chunk-ZXIWDFEQ.js";export{parseCurrencyString}from"../chunk-VEYMQ3UA.js";import"../chunk-DUK2K4FB.js";import"../chunk-FIAAX3UE.js";import"../chunk-TSLYDPBJ.js";import"../chunk-W2W3L2M5.js";export{safeStableStringify}from"../chunk-L73TOPX5.js";import"../chunk-QNKGP5DY.js";import"../chunk-2UIRWYE3.js";

package/dist/env/index.cjs

@@ -1 +1 @@
-'use strict';require('../chunk-MMSYCIJ2.cjs');var chunkSW6HYEW7_cjs=require('../chunk-SW6HYEW7.cjs');Object.defineProperty(exports,"isServer",{enumerable:true,get:function(){return chunkSW6HYEW7_cjs.a}});
+"use strict";require("../chunk-MMSYCIJ2.cjs");var e=require("../chunk-J2RGTPGK.cjs");Object.defineProperty(exports,"isServer",{enumerable:!0,get:function(){return e.isServer}});

package/dist/env/index.js

@@ -1 +1 @@
-import'../chunk-G5LXIEFO.js';export{a as isServer}from'../chunk-56QBKKRE.js';
+import"../chunk-G5LXIEFO.js";export{isServer}from"../chunk-MC3LXMCQ.js";

package/dist/events/index.cjs

@@ -1 +1 @@
-'use strict';var chunkGGEV7LXX_cjs=require('../chunk-GGEV7LXX.cjs');require('../chunk-SW6HYEW7.cjs'),require('../chunk-BEZPD44N.cjs'),require('../chunk-CII6WWLO.cjs');Object.defineProperty(exports,"disableUserInteraction",{enumerable:true,get:function(){return chunkGGEV7LXX_cjs.a}});Object.defineProperty(exports,"enableUserInteraction",{enumerable:true,get:function(){return chunkGGEV7LXX_cjs.b}});Object.defineProperty(exports,"removeElementFocus",{enumerable:true,get:function(){return chunkGGEV7LXX_cjs.c}});Object.defineProperty(exports,"scrollToTop",{enumerable:true,get:function(){return chunkGGEV7LXX_cjs.d}});
+"use strict";var e=require("../chunk-KXIXXSWX.cjs");require("../chunk-J2RGTPGK.cjs"),require("../chunk-Y4O5KZF6.cjs"),require("../chunk-INUFZJLX.cjs"),Object.defineProperty(exports,"disableUserInteraction",{enumerable:!0,get:function(){return e.disableUserInteraction}}),Object.defineProperty(exports,"enableUserInteraction",{enumerable:!0,get:function(){return e.enableUserInteraction}}),Object.defineProperty(exports,"removeElementFocus",{enumerable:!0,get:function(){return e.removeElementFocus}}),Object.defineProperty(exports,"scrollToTop",{enumerable:!0,get:function(){return e.scrollToTop}});

package/dist/events/index.js

@@ -1 +1 @@
-export{a as disableUserInteraction,b as enableUserInteraction,c as removeElementFocus,d as scrollToTop}from'../chunk-S5M33A4O.js';import'../chunk-56QBKKRE.js';import'../chunk-NJSAV73S.js';import'../chunk-EWYPSKKM.js';
+export{disableUserInteraction,enableUserInteraction,removeElementFocus,scrollToTop}from"../chunk-5I2B5DOG.js";import"../chunk-MC3LXMCQ.js";import"../chunk-W2W3L2M5.js";import"../chunk-2UIRWYE3.js";

package/dist/formatting/index.cjs

@@ -1 +1 @@
-'use strict';var chunkHJOZOENU_cjs=require('../chunk-HJOZOENU.cjs');require('../chunk-QSQDP7L2.cjs'),require('../chunk-Q3NTKN5I.cjs'),require('../chunk-MROH35V3.cjs'),require('../chunk-UTQUYABU.cjs'),require('../chunk-BEZPD44N.cjs'),require('../chunk-PUQXRLZH.cjs'),require('../chunk-26W3VZIK.cjs'),require('../chunk-7YWAQOA4.cjs'),require('../chunk-CII6WWLO.cjs');Object.defineProperty(exports,"censorEmail",{enumerable:true,get:function(){return chunkHJOZOENU_cjs.h}});Object.defineProperty(exports,"chunkString",{enumerable:true,get:function(){return chunkHJOZOENU_cjs.i}});Object.defineProperty(exports,"formatCurrency",{enumerable:true,get:function(){return chunkHJOZOENU_cjs.a}});Object.defineProperty(exports,"formatDateFns",{enumerable:true,get:function(){return chunkHJOZOENU_cjs.f}});Object.defineProperty(exports,"formatDateIntl",{enumerable:true,get:function(){return chunkHJOZOENU_cjs.e}});Object.defineProperty(exports,"formatDateTime",{enumerable:true,get:function(){return chunkHJOZOENU_cjs.d}});Object.defineProperty(exports,"formatNumber",{enumerable:true,get:function(){return chunkHJOZOENU_cjs.b}});Object.defineProperty(exports,"formatPhoneNumber",{enumerable:true,get:function(){return chunkHJOZOENU_cjs.c}});Object.defineProperty(exports,"getGMTOffset",{enumerable:true,get:function(){return chunkHJOZOENU_cjs.g}});Object.defineProperty(exports,"truncateString",{enumerable:true,get:function(){return chunkHJOZOENU_cjs.j}});
+"use strict";var e=require("../chunk-5Y52H4VH.cjs");require("../chunk-7BXIZM57.cjs"),require("../chunk-YZR5OGJA.cjs"),require("../chunk-XC2PYCT4.cjs"),require("../chunk-EBMHQW7X.cjs"),require("../chunk-Y4O5KZF6.cjs"),require("../chunk-DVMHRLKP.cjs"),require("../chunk-DQFU3KLE.cjs"),require("../chunk-UDA26MCU.cjs"),require("../chunk-INUFZJLX.cjs"),Object.defineProperty(exports,"censorEmail",{enumerable:!0,get:function(){return e.censorEmail}}),Object.defineProperty(exports,"chunkString",{enumerable:!0,get:function(){return e.chunkString}}),Object.defineProperty(exports,"formatCurrency",{enumerable:!0,get:function(){return e.formatCurrency}}),Object.defineProperty(exports,"formatDateFns",{enumerable:!0,get:function(){return e.formatDateFns}}),Object.defineProperty(exports,"formatDateIntl",{enumerable:!0,get:function(){return e.formatDateIntl}}),Object.defineProperty(exports,"formatDateTime",{enumerable:!0,get:function(){return e.formatDateTime}}),Object.defineProperty(exports,"formatNumber",{enumerable:!0,get:function(){return e.formatNumber}}),Object.defineProperty(exports,"formatPhoneNumber",{enumerable:!0,get:function(){return e.formatPhoneNumber}}),Object.defineProperty(exports,"getGMTOffset",{enumerable:!0,get:function(){return e.getGMTOffset}}),Object.defineProperty(exports,"truncateString",{enumerable:!0,get:function(){return e.truncateString}});

package/dist/formatting/index.js

@@ -1 +1 @@
-export{h as censorEmail,i as chunkString,a as formatCurrency,f as formatDateFns,e as formatDateIntl,d as formatDateTime,b as formatNumber,c as formatPhoneNumber,g as getGMTOffset,j as truncateString}from'../chunk-G4EWCRKS.js';import'../chunk-7VX33E3V.js';import'../chunk-ESJYBIYH.js';import'../chunk-NR44SNYE.js';import'../chunk-7CHFAMS2.js';import'../chunk-NJSAV73S.js';import'../chunk-ELDDNERR.js';import'../chunk-J4NCYYGS.js';import'../chunk-5SZUSNGZ.js';import'../chunk-EWYPSKKM.js';
+export{censorEmail,chunkString,formatCurrency,formatDateFns,formatDateIntl,formatDateTime,formatNumber,formatPhoneNumber,getGMTOffset,truncateString}from"../chunk-RF34NETZ.js";import"../chunk-VEYMQ3UA.js";import"../chunk-DUK2K4FB.js";import"../chunk-Q6NHYWVX.js";import"../chunk-TSLYDPBJ.js";import"../chunk-W2W3L2M5.js";import"../chunk-WVSPXFTY.js";import"../chunk-L73TOPX5.js";import"../chunk-QNKGP5DY.js";import"../chunk-2UIRWYE3.js";

package/dist/generator/index.cjs

@@ -1 +1 @@
-'use strict';var chunkSZPWZZYG_cjs=require('../chunk-SZPWZZYG.cjs'),chunkRV2VULM7_cjs=require('../chunk-RV2VULM7.cjs');require('../chunk-PUQXRLZH.cjs'),require('../chunk-26W3VZIK.cjs'),require('../chunk-7YWAQOA4.cjs'),require('../chunk-CII6WWLO.cjs');Object.defineProperty(exports,"getRandomItem",{enumerable:true,get:function(){return chunkSZPWZZYG_cjs.a}});Object.defineProperty(exports,"randomInt",{enumerable:true,get:function(){return chunkSZPWZZYG_cjs.b}});Object.defineProperty(exports,"randomIntByLength",{enumerable:true,get:function(){return chunkSZPWZZYG_cjs.c}});Object.defineProperty(exports,"randomStr",{enumerable:true,get:function(){return chunkSZPWZZYG_cjs.d}});Object.defineProperty(exports,"noop",{enumerable:true,get:function(){return chunkRV2VULM7_cjs.a}});
+"use strict";var e=require("../chunk-7H7IODCQ.cjs"),r=require("../chunk-5C2SMIGX.cjs");require("../chunk-DVMHRLKP.cjs"),require("../chunk-DQFU3KLE.cjs"),require("../chunk-UDA26MCU.cjs"),require("../chunk-INUFZJLX.cjs"),Object.defineProperty(exports,"getRandomItem",{enumerable:!0,get:function(){return e.getRandomItem}}),Object.defineProperty(exports,"randomInt",{enumerable:!0,get:function(){return e.randomInt}}),Object.defineProperty(exports,"randomIntByLength",{enumerable:!0,get:function(){return e.randomIntByLength}}),Object.defineProperty(exports,"randomStr",{enumerable:!0,get:function(){return e.randomStr}}),Object.defineProperty(exports,"noop",{enumerable:!0,get:function(){return r.noop}});

package/dist/generator/index.js

@@ -1 +1 @@
-export{a as getRandomItem,b as randomInt,c as randomIntByLength,d as randomStr}from'../chunk-5Q37AP7P.js';export{a as noop}from'../chunk-SYJC7UAW.js';import'../chunk-ELDDNERR.js';import'../chunk-J4NCYYGS.js';import'../chunk-5SZUSNGZ.js';import'../chunk-EWYPSKKM.js';
+export{getRandomItem,randomInt,randomIntByLength,randomStr}from"../chunk-IRBPXCMR.js";export{noop}from"../chunk-FIAAX3UE.js";import"../chunk-WVSPXFTY.js";import"../chunk-L73TOPX5.js";import"../chunk-QNKGP5DY.js";import"../chunk-2UIRWYE3.js";

package/dist/{is-array--YjXV-Wx.d.ts → is-array-Cymwrsmm.d.ts}

@@ -1,47 +1,4 @@
-import{I as IfExtends,E as Extends,N as Not,a as NotExtends}from'./extends-Bk_SBGdT.js';import{I as If}from'./if-CvT4R7Kh.js';import{T as Trim,I as IfNot}from'./string-XA-til3C.js';import{I as IsNever}from'./never-BfayMBF9.js';import{I as IsAny}from'./any-BmdI8UbK.js';import{P as Prettify}from'./prettify-C4xLcYOP.js';
-/** -------------------------------------------------------
- * * ***And.***
- * -------------------------------------------------------
- * Performs a **logical AND** operation between two boolean types.
- * - Returns `true` if **both** conditions extend `true`.
- * - Returns `false` otherwise.
- *
- * @template Condition1 - The first condition.
- * @template Condition2 - The second condition.
- * @example
- * ```ts
- * type Case1 = And<true, true>;
- * // ➔ true
- * type Case2 = And<false, true>;
- * // ➔ false
- * type Case3 = And<true, false>;
- * // ➔ false
- * type Case4 = And<false, false>;
- * // ➔ false
- * ```
- */
-type And<Condition1,Condition2>=IfExtends<Condition1,true,Extends<Condition2,true>>;
-/** -------------------------------------------------------
- * * ***AndArr.***
- * -------------------------------------------------------
- * Performs a **logical AND** operation across all elements in an array of boolean types.
- * - Returns `true` if **all elements** extend `true`.
- * - Returns `false` if **any element** is not `true`.
- *
- * @template Conditions - A readonly array of boolean conditions.
- * @example
- * ```ts
- * type Case1 = AndArr<[true, true, true]>;
- * // ➔ true
- * type Case2 = AndArr<[true, true, false]>;
- * // ➔ false
- * type Case3 = AndArr<[false, false, false]>;
- * // ➔ false
- * type Case4 = AndArr<[]>;
- * // ➔ true (vacuous truth)
- * ```
- */
-type AndArr<Conditions extends readonly unknown[]>=Extends<Conditions[number],true>;
+import{O as OrArr,A as And,a as AndArr}from'./or-DyZCRvaU.js';import{E as Extends,N as Not,I as IfExtends,a as NotExtends}from'./extends-Bk_SBGdT.js';import{I as If}from'./if-CvT4R7Kh.js';import{T as Trim,I as IfNot}from'./string-XA-til3C.js';import{I as IsNever}from'./never-BfayMBF9.js';import{I as IsAny}from'./any-BmdI8UbK.js';import{P as Prettify}from'./prettify-C4xLcYOP.js';
 /** -------------------------------------------------------
  * * ***IsStringLiteral.***
  * -------------------------------------------------------
@@ -54,51 +11,6 @@ type AndArr<Conditions extends readonly unknown[]>=Extends<Conditions[number],tr
  * type Case3 = IsStringLiteral<string>; // ➔ false
  */
 type IsStringLiteral<T>=If<Extends<T,string>,Extends<string,T>extends true?false:true,false>;
-/** -------------------------------------------------------
- * * ***Or.***
- * -------------------------------------------------------
- *
- * Computes the logical OR of two type-level boolean conditions.
- *
- * @template Condition1 - First boolean condition.
- * @template Condition2 - Second boolean condition.
- *
- * @example
- * ```ts
- * type Case1 = Or<true, true>;   // true
- * type Case2 = Or<false, true>;  // true
- * type Case3 = Or<false, false>; // false
- * type Case4 = Or<true, false>;  // true
- * ```
- *
- * @remarks
- * - Uses {@link IfExtends} to determine if either condition is `true`.
- * - Returns `true` if at least one of the two conditions is `true`.
- * - Returns `false` only if both are `false`.
- */
-type Or<Condition1,Condition2>=IfExtends<Condition1,true,true,IfExtends<Condition2,true>>;
-/** -------------------------------------------------------
- * * ***OrArr.***
- * -------------------------------------------------------
- *
- * Computes the logical OR of all elements inside a tuple or array of boolean types.
- *
- * @template Conditions - An array of boolean type elements.
- *
- * @example
- * ```ts
- * type Case1 = OrArr<[true, true, true]>;    // true
- * type Case2 = OrArr<[true, true, false]>;   // true
- * type Case3 = OrArr<[false, false, false]>; // false
- * type Case4 = OrArr<[]>;                    // false
- * ```
- *
- * @remarks
- * - Uses TypeScript's indexed access types and conditional type inference.
- * - Returns `true` if at least one element in the array is `true`.
- * - Returns `false` if all elements are `false` or array is empty.
- */
-type OrArr<Conditions extends readonly unknown[]>=true extends Conditions[number]?true:false;
 /** -------------------------------------------------------
  * * ***Push.***
  * -------------------------------------------------------
@@ -1204,4 +1116,4 @@ type IsMutableArray<T>=And<IsArray<T>,NotExtends<Readonly<T>,T>>;
  * type Case2 = IsReadonlyArray<[]>;
  * // ➔ false
  */
-type IsReadonlyArray<T>=And<IsArray<T>,NotExtends<T,Mutable<T>>>;export type{PositiveInteger as $,And as A,IfPositiveFloat as B,CharAt as C,IfPositiveInteger as D,Even as E,Float as F,Integer as G,IsNegativeFloat as H,IsStringLiteral as I,IsOdd as J,IsPositiveFloat as K,IsPositiveInteger as L,Mutable as M,Negate as N,Or as O,ParseNumber as P,IsScientificNumber as Q,Repeat as R,Split as S,Negative as T,NegativeFloat as U,NegativeInteger as V,Odd as W,OddDigit as X,ParseScientificNumber as Y,Positive as Z,PositiveFloat as _,IsNegative as a,IfUnknown as a0,UnknownifyProperties as a1,UnknownifyPropertiesOptions as a2,Abs as b,IsFloat as c,IsUnknown as d,IsNegativeInteger as e,OrArr as f,AndArr as g,IsInteger as h,Push as i,IfNegative as j,IsPositive as k,IsEven as l,IsReadonlyArray as m,IfPositive as n,IsArray as o,IsMutableArray as p,MutableExcept as q,MutableOnly as r,MutableOptions as s,EvenDigit as t,IfEven as u,IfFloat as v,IfInteger as w,IfNegativeFloat as x,IfNegativeInteger as y,IfOdd as z};
+type IsReadonlyArray<T>=And<IsArray<T>,NotExtends<T,Mutable<T>>>;export type{Abs as A,IsNegativeFloat as B,CharAt as C,IsOdd as D,Even as E,Float as F,IsPositiveFloat as G,IsPositiveInteger as H,IsStringLiteral as I,IsScientificNumber as J,Negative as K,NegativeFloat as L,Mutable as M,Negate as N,NegativeInteger as O,ParseNumber as P,Odd as Q,Repeat as R,Split as S,OddDigit as T,ParseScientificNumber as U,Positive as V,PositiveFloat as W,PositiveInteger as X,IfUnknown as Y,UnknownifyProperties as Z,UnknownifyPropertiesOptions as _,IsNegative as a,IsFloat as b,IsUnknown as c,IsNegativeInteger as d,IsInteger as e,Push as f,IfNegative as g,IsPositive as h,IsEven as i,IsReadonlyArray as j,IfPositive as k,IsArray as l,IsMutableArray as m,MutableExcept as n,MutableOnly as o,MutableOptions as p,EvenDigit as q,IfEven as r,IfFloat as s,IfInteger as t,IfNegativeFloat as u,IfNegativeInteger as v,IfOdd as w,IfPositiveFloat as x,IfPositiveInteger as y,Integer as z};

package/dist/next/index.cjs

@@ -1,8 +1 @@
-'use strict';var chunkOZCQZO2V_cjs=require('../chunk-OZCQZO2V.cjs'),chunkMROH35V3_cjs=require('../chunk-MROH35V3.cjs'),chunkUTQUYABU_cjs=require('../chunk-UTQUYABU.cjs'),chunkBEZPD44N_cjs=require('../chunk-BEZPD44N.cjs');require('../chunk-PUQXRLZH.cjs');var chunk26W3VZIK_cjs=require('../chunk-26W3VZIK.cjs');require('../chunk-7YWAQOA4.cjs');var chunkCII6WWLO_cjs=require('../chunk-CII6WWLO.cjs');function N(e,t){if(!chunkCII6WWLO_cjs.g(e)||chunkUTQUYABU_cjs.a(e))throw new TypeError(`\u274C 'generateRoute' Failed:
-- Invalid 'route' value.
-- Must be of type \`string\` and non-empty string, but received: "${chunkCII6WWLO_cjs.E(e)}": \`${chunk26W3VZIK_cjs.c(e)}\`.`);if(!/[\\[\]]/.test(e))return e;if(chunkCII6WWLO_cjs.j(t,{message:({validType:o})=>`\u274C 'generateRoute' Failed cause in route "${e}":
-- Missing or invalid parameters \`${o}\` for route: "${e}", must be of type \`${o}\` mapping parameters.`}),chunkCII6WWLO_cjs.c(t))throw new TypeError(`\u274C 'generateRoute' Failed cause in route "${e}":
-- Missing parameters \`plain-object\` for route: "${e}".`);let n=["?","&","#","=","/","'",'"',"(",")","+",";","%","@",":"],r=[],s=Array.from(e.matchAll(/\[(\w+)\]/g)).map(o=>o[1]);for(let o of s){let i=t[o];if(!chunkCII6WWLO_cjs.g(i)){r.push(`- Invalid parameter: "${o}" must be of type \`string\`, but received: \`${chunkCII6WWLO_cjs.E(i)}\`.`);continue}if(chunkUTQUYABU_cjs.a(i)){r.push(`- Parameter "${o}" cannot be empty string.`);continue}let p=n.filter(g=>i.includes(g));if(/\s/.test(i)&&p.push("white-space(s)"),p.length>0){let g=p.map(a=>a==="`"?"backtick - (`)":`\`${a}\``);n.includes("white-space(s)")||n.push("white-space(s)");let m=n.map(a=>a==="`"?"backtick - (`)":`\`${a}\``);r.push(`- Parameter "${o}" contains invalid characters (${g.join(", ")}). These characters are not allowed because they could cause issues in URL structure. The following characters are forbidden in route parameters: (${m.join(", ")}).`);}}if(chunkCII6WWLO_cjs.r(r))throw new Error(`\u274C 'generateRoute' Failed cause in route "${e}":
-${r.join(`
-`)}.`);return e.replace(/\[(\w+)\]/g,(o,i)=>(chunkCII6WWLO_cjs.p(t[i])?t[i]:"").trim().replace(/^\/+|\/+$/g,"")).replace(/\/+/g,"/")}var q=(e,t={})=>{try{let p=function(m,a){return `${m.replace(/\/+$/,"")}/${a.replace(/^\/+/,"")}`};var n=p;chunkBEZPD44N_cjs.a(chunkCII6WWLO_cjs.c(e)?"":e,{message({currentType:m,validType:a}){return `First parameter (\`pathname\`) must be of type \`${a}\`, but received: \`${m}\`.`}}),chunkCII6WWLO_cjs.f(t)||(t={});let{prefix:r="/api",withOrigin:s=!0}=t;if(!chunkCII6WWLO_cjs.m(r)&&!chunkCII6WWLO_cjs.g(r))throw new TypeError(`Parameter \`prefix\` property of the \`options\` (second parameter) must be of type \`string\`, but received: \`${chunkCII6WWLO_cjs.E(r)}\`.`);chunkCII6WWLO_cjs.G(s,{message:({currentType:m,validType:a})=>`Parameter \`withOrigin\` property of the \`options\` (second parameter) must be of type \`${a}\`, but received: \`${m}\`.`}),e=chunkOZCQZO2V_cjs.c(e),r=chunkOZCQZO2V_cjs.c(r);let o=r.endsWith("/")?r:r+"/";(e===r||e===r+"/"||e.startsWith(o))&&(e=e.slice(r.length),e=chunkOZCQZO2V_cjs.c(e));let i=b({suffix:r});return p(s?i:new URL(i).pathname,e).replace(/\/+$/,"")}catch(r){throw chunkCII6WWLO_cjs.C(r)?r:new Error("Failed to generate backend API URL in `createBeApiUrl()`, Error: "+new Error(String(r)).message.trim())}};var b=({suffix:e="/"}={})=>{chunkBEZPD44N_cjs.a(e,{message({currentType:t,validType:n}){return `Parameter \`suffix\` property of the first parameter must be of type \`${n}\`, but received: \`${t}\`.`}});try{let t=process.env.NEXT_PUBLIC_BACKEND_API_URL?.trim();if(t){t=chunkMROH35V3_cjs.c(t);let s=new URL(t);!!!s.port&&process.env.NEXT_PUBLIC_PORT_BE&&(t=s.origin+chunkOZCQZO2V_cjs.d(process.env.NEXT_PUBLIC_PORT_BE,{prefixColon:!0}));}else t="http://localhost"+chunkOZCQZO2V_cjs.d(process.env.NEXT_PUBLIC_PORT_BE||"8000",{prefixColon:!0});e=chunkMROH35V3_cjs.c(e).length?chunkMROH35V3_cjs.c(e):"/";let n=new URL(t.replace(/\/+$/,"")).origin,r=e==="/"?"/":`${e.startsWith("/")?"":"/"}${e.replace(/\/+$/,"")}`;return `${n}${r}`}catch(t){throw new Error("Invalid `NEXT_PUBLIC_BACKEND_API_URL`, failed to generate from `getBeApiUrl()`, Error:"+t)}};var te=()=>{try{let e=process.env.NEXT_PUBLIC_BASE_URL?.trim(),t=process.env.NEXT_PUBLIC_PORT_FE?.trim(),n=e||"http://localhost";n=chunkMROH35V3_cjs.c(n).replace(/\/+$/,"");let r=/:\/\/[^/]+:\d+/.test(n);!r&&t?n+=chunkOZCQZO2V_cjs.d(t,{prefixColon:!0}):!r&&!e&&(n+=":3000");let s=new URL(n);return `${s.protocol}//${s.hostname}${s.port?`:${s.port}`:""}`}catch(e){throw new Error("Invalid `NEXT_PUBLIC_BASE_URL`, failed to generate from `getBaseUrl()`, Error:"+e)}};
-exports.createBeApiUrl=q;exports.generateRoute=N;exports.getBaseUrl=te;exports.getBeApiUrl=b;
+"use strict";var e=require("../chunk-WZE3XLKY.cjs"),r=require("../chunk-XC2PYCT4.cjs"),t=require("../chunk-EBMHQW7X.cjs"),n=require("../chunk-Y4O5KZF6.cjs");require("../chunk-DVMHRLKP.cjs");var s=require("../chunk-DQFU3KLE.cjs");require("../chunk-UDA26MCU.cjs");var i=require("../chunk-INUFZJLX.cjs");var a=({suffix:t="/"}={})=>{var s;n.assertIsString(t,{message:({currentType:e,validType:r})=>`Parameter \`suffix\` property of the first parameter must be of type \`${r}\`, but received: \`${e}\`.`});try{let n=null==(s=process.env.NEXT_PUBLIC_BACKEND_API_URL)?void 0:s.trim();if(n){n=r.removeSpaces(n);const t=new URL(n);!!!t.port&&process.env.NEXT_PUBLIC_PORT_BE&&(n=t.origin+e.formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE,{prefixColon:!0}))}else n="http://localhost"+e.formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE||"8000",{prefixColon:!0});t=r.removeSpaces(t).length?r.removeSpaces(t):"/";const i=new URL(n.replace(/\/+$/,"")).origin;return`${i}${"/"===t?"/":`${t.startsWith("/")?"":"/"}${t.replace(/\/+$/,"")}`}`}catch(e){throw new Error("Invalid `NEXT_PUBLIC_BACKEND_API_URL`, failed to generate from `getBeApiUrl()`, Error:"+e)}};exports.createBeApiUrl=(r,t={})=>{try{let s=function(e,r){return`${e.replace(/\/+$/,"")}/${r.replace(/^\/+/,"")}`};n.assertIsString(i.isNil(r)?"":r,{message:({currentType:e,validType:r})=>`First parameter (\`pathname\`) must be of type \`${r}\`, but received: \`${e}\`.`}),i.isPlainObject(t)||(t={});let{prefix:o="/api",withOrigin:c=!0}=t;if(!i.isUndefined(o)&&!i.isString(o))throw new TypeError(`Parameter \`prefix\` property of the \`options\` (second parameter) must be of type \`string\`, but received: \`${i.getPreciseType(o)}\`.`);i.assertIsBoolean(c,{message:({currentType:e,validType:r})=>`Parameter \`withOrigin\` property of the \`options\` (second parameter) must be of type \`${r}\`, but received: \`${e}\`.`}),r=e.normalizePathname(r),o=e.normalizePathname(o);const p=o.endsWith("/")?o:o+"/";(r===o||r===o+"/"||r.startsWith(p))&&(r=r.slice(o.length),r=e.normalizePathname(r));const u=a({suffix:o});return s(c?u:new URL(u).pathname,r).replace(/\/+$/,"")}catch(e){throw i.isError(e)?e:new Error("Failed to generate backend API URL in `createBeApiUrl()`, Error: "+new Error(String(e)).message.trim())}},exports.generateRoute=function(e,r){if(!i.isString(e)||t.isEmptyString(e))throw new TypeError(`❌ 'generateRoute' Failed:\n- Invalid 'route' value.\n- Must be of type \`string\` and non-empty string, but received: "${i.getPreciseType(e)}": \`${s.safeStableStringify(e)}\`.`);if(!/[\\[\]]/.test(e))return e;if(i.assertIsPlainObject(r,{message:({validType:r})=>`❌ 'generateRoute' Failed cause in route "${e}":\n- Missing or invalid parameters \`${r}\` for route: "${e}", must be of type \`${r}\` mapping parameters.`}),i.isNil(r))throw new TypeError(`❌ 'generateRoute' Failed cause in route "${e}":\n- Missing parameters \`plain-object\` for route: "${e}".`);const n=["?","&","#","=","/","'",'"',"(",")","+",";","%","@",":"],a=[],o=Array.from(e.matchAll(/\[(\w+)\]/g)).map(e=>e[1]);for(const e of o){const s=r[e];if(!i.isString(s)){a.push(`- Invalid parameter: "${e}" must be of type \`string\`, but received: \`${i.getPreciseType(s)}\`.`);continue}if(t.isEmptyString(s)){a.push(`- Parameter "${e}" cannot be empty string.`);continue}const o=n.filter(e=>s.includes(e));if(/\s/.test(s)&&o.push("white-space(s)"),o.length>0){const r=o.map(e=>"`"===e?"backtick - (`)":`\`${e}\``);n.includes("white-space(s)")||n.push("white-space(s)");const t=n.map(e=>"`"===e?"backtick - (`)":`\`${e}\``);a.push(`- Parameter "${e}" contains invalid characters (${r.join(", ")}). These characters are not allowed because they could cause issues in URL structure. The following characters are forbidden in route parameters: (${t.join(", ")}).`)}}if(i.isNonEmptyArray(a))throw new Error(`❌ 'generateRoute' Failed cause in route "${e}":\n${a.join("\n")}.`);return e.replace(/\[(\w+)\]/g,(e,t)=>(i.isNonEmptyString(r[t])?r[t]:"").trim().replace(/^\/+|\/+$/g,"")).replace(/\/+/g,"/")},exports.getBaseUrl=()=>{var t,n;try{const s=null==(t=process.env.NEXT_PUBLIC_BASE_URL)?void 0:t.trim(),i=null==(n=process.env.NEXT_PUBLIC_PORT_FE)?void 0:n.trim();let a=s||"http://localhost";a=r.removeSpaces(a).replace(/\/+$/,"");const o=/:\/\/[^/]+:\d+/.test(a);!o&&i?a+=e.formatEnvPort(i,{prefixColon:!0}):o||s||(a+=":3000");const c=new URL(a);return`${c.protocol}//${c.hostname}${c.port?`:${c.port}`:""}`}catch(e){throw new Error("Invalid `NEXT_PUBLIC_BASE_URL`, failed to generate from `getBaseUrl()`, Error:"+e)}},exports.getBeApiUrl=a;