@rzl-zone/utils-js 3.0.2-beta.2 → 3.1.0-beta.2

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

@@ -1,4 +1,4 @@
-import{I as If}from'./if-CvT4R7Kh.js';import{I as IsNever}from'./never-BfayMBF9.js';import{I as IfExtends,E as Extends,N as Not,a as NotExtends}from'./extends-Mp81Hq9-.js';import{I as IsAny}from'./any-BmdI8UbK.js';import{P as Prettify}from'./prettify-C4xLcYOP.js';
+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.***
 * -------------------------------------------------------
@@ -55,356 +55,6 @@ type AndArr<Conditions extends readonly unknown[]>=Extends<Conditions[number],tr
 */
 type IsStringLiteral<T>=If<Extends<T,string>,Extends<string,T>extends true?false:true,false>;
 /** -------------------------------------------------------
-* * ***IfNot.***
-* -------------------------------------------------------
-*
-* Conditional: returns the second argument if the first argument is `false`, otherwise returns the third argument.
-* - Defaults: `IfTrue = true`, `IfFalse = false`.
-*
-* @template Condition - The boolean condition to check.
-* @template IfTrue - The branch type if condition is `false`. (default: `true`)
-* @template IfFalse - The branch type if condition is `true`. (default: `false`)
-*
-* ### Examples
-* ```ts
-* type A = IfNot<false, "valid">;
-* // ➔ "valid"
-* type B = IfNot<false, "valid", "invalid">;
-* // ➔ "invalid"
-* ```
-*/
-type IfNot<Condition,IfTrue=true,IfFalse=false>=If<Condition,IfFalse,IfTrue>;
-/** -------------------------------------------------------
-* * ***WordSeparator.***
-* -------------------------------------------------------
-* A type-level utility that defines all valid ***word separators***.
-* - Can be a space `" "`, a dash `"-"`, or an underscore `"_"`.
-*
-* @example
-* ```ts
-* type A = WordSeparator; // ➔ " " | "-" | "_"
-* ```
-*/
-type WordSeparator=" "|"-"|"_";
-/** --------------------------------------------------
-* * ***Whitespace.***
-* --------------------------------------------------
-* Represents common whitespace characters.
-*
-* ✅ Used as the default trimming characters in string utility types.
-*
-* @example
-* type W = Whitespace;
-* // ➔ " " | "\t" | "\r" | "\n"
-*/
-type Whitespace=" "|"\t"|"\r"|"\n";
-/** **Helper Internal.** */
-type SafeKeyTrimming<T>=Exclude<T,symbol>;
-/** --------------------------------------------------
-* * ***TrimLeft.***
-* --------------------------------------------------
-* Recursively trims specified characters (default: **{@link Whitespace}**)
-* from the **start (left)** of a string.
-*
-* @template Text - The string to trim.
-* @template Chars - The characters to remove (default: `Whitespace`).
-*
-* @example
-* type T1 = TrimLeft<"\n  hello", " " | "\n">;
-* // ➔ "hello"
-*
-* type T2 = TrimLeft<"  world">;
-* // ➔ "world"
-*
-* type T3 = TrimLeft<"  world ">;
-* // ➔ "world "
-*/
-type TrimLeft<Text extends PropertyKey,Chars extends PropertyKey=Whitespace>=Text extends`${SafeKeyTrimming<Chars>}${infer Rest}`?TrimLeft<Rest,Chars>:Text;
-/** --------------------------------------------------
-* * ***TrimRight.***
-* --------------------------------------------------
-* Recursively trims specified characters (default: **{@link Whitespace}**)
-* from the **end (right)** of a string.
-*
-* @template Text - The string to trim.
-* @template Chars - The characters to remove (default: `Whitespace`).
-*
-* @example
-* type T1 = TrimRight<"hello  \t", " " | "\t">;
-* // ➔ "hello"
-*
-* type T2 = TrimRight<"world  ">;
-* // ➔ "world"
-*
-* type T2 = TrimRight<" world  ">;
-* // ➔ " world"
-*/
-type TrimRight<Text extends PropertyKey,Chars extends PropertyKey=Whitespace>=Text extends`${infer Rest}${SafeKeyTrimming<Chars>}`?TrimRight<Rest,Chars>:Text;
-/** --------------------------------------------------
-* * ***Trim.***
-* --------------------------------------------------
-* Trims specified characters (default: **{@link Whitespace}**)
-* from **both the start and end** of a string.
-*
-* @template Text - The string to trim.
-* @template Chars - The characters to remove (default: `Whitespace`).
-*
-* @example
-* type T1 = Trim<"  hello  ", " ">;
-* // ➔ "hello"
-*
-* type T2 = Trim<"\n  world \t">;
-* // ➔ "world"
-*/
-type Trim<Text extends PropertyKey,Chars extends PropertyKey=Whitespace>=TrimRight<TrimLeft<Text,Chars>,Chars>;
-/** -------------------------------------------------------
-* * ***TrimsLower***
-* -------------------------------------------------------
-* Trims leading & trailing whitespace from a string and
-* converts it to **lowercase**.
-*
-* Utilizes **{@link Trim}** to remove whitespace and **{@link Lowercase}** to convert the string to lowercase.
-*
-* @template S - The input string to transform.
-*
-* @example
-* ```ts
-* type T1 = TrimsLower<"  HeLLo \n">;
-* // ➔ "hello"
-*
-* type T2 = TrimsLower<"  WoRLD  ">;
-* // ➔ "world"
-* ```
-*/
-type TrimsLower<S extends string>=Lowercase<Trim<S>>;
-/** -------------------------------------------------------
-* * ***TrimsUpper***
-* -------------------------------------------------------
-* Trims leading & trailing whitespace from a string and
-* converts it to **uppercase**.
-*
-* Utilizes **{@link Trim}** to remove whitespace and **{@link Uppercase}** to convert the string to uppercase.
-*
-* @template S - The input string to transform.
-*
-* @example
-* ```ts
-* type T1 = TrimsUpper<"  HeLLo \n">;
-* // ➔ "HELLO"
-*
-* type T2 = TrimsUpper<"  WoRLD  ">;
-* // ➔ "WORLD"
-* ```
-*/
-type TrimsUpper<S extends string>=Uppercase<Trim<S>>;
-/** -------------------------------------------------------
-* * ***AnyString.***
-* -------------------------------------------------------
-*
-* A utility type that represents **any string value** while
-* preventing unwanted widening of string literals to `string`.
-*
-* 🔹 This is achieved by intersecting `string` with `{}`,
-* ensuring that the type remains assignable to `string`
-* but is treated as a unique type in generic constraints.
-*
-* 📌 Useful in scenarios where:
-* - You want to accept **any string**, but still preserve
-*   literal types in inference.
-* - You need stricter typing than just `string`.
-*
-* @example
-* ```ts
-* declare function acceptsAnyString<T extends AnyString>(value: T): T;
-*
-* // Preserves literal
-* const a = acceptsAnyString("hello");
-* // ➔ "hello"
-*
-* // Also allows generic string
-* const b = acceptsAnyString(String("world"));
-* // ➔ string
-* ```
-*/
-type AnyString={}& string;
-/** -------------------------------------------------------
-* * ***EmptyString.***
-* -------------------------------------------------------
-* Returns the type `T` only if it is the empty string `""`.
-* Optionally trims whitespace before checking.
-*
-* Behavior:
-* - If `WithTrim` is `true` (default), trims `T` before checking.
-* - If `T` is the general `string` type, returns `never`.
-* - If `T` is empty (after optional trimming), returns `T` or `Trim<T>`.
-*
-* @template T - The string type to check.
-* @template WithTrim - Whether to trim whitespace before checking (default `true`).
-*
-* @example
-* ```ts
-* // Basic empty string
-* type Case1 = EmptyString<"">;
-* // ➔ ""
-*
-* // Non-empty string
-* type Case2 = EmptyString<"abc">;
-* // ➔ never
-*
-* // General string type
-* type Case3 = EmptyString<string>;
-* // ➔ never
-*
-* // With leading/trailing whitespace
-* type Case4 = EmptyString<"  ", true>;
-* // ➔ "" (trimmed)
-* type Case5 = EmptyString<"  ", false>;
-* // ➔ never (not trimmed)
-* ```
-*/
-type EmptyString<T extends string,WithTrim extends boolean=true>=""extends(WithTrim extends true?Trim<T>:T)?string extends(WithTrim extends true?Trim<T>:T)?never:WithTrim extends true?Trim<T>:T:never;
-/** -------------------------------------------------------
-* * ***NonEmptyString.***
-* -------------------------------------------------------
-* Returns the type `T` only if it is a non-empty string.
-* Optionally trims whitespace before checking.
-*
-* Behavior:
-* - If `WithTrim` is `true` (default), trims `T` before checking.
-* - If `T` is the general `string` type, returns `string`.
-* - If `T` is empty (after optional trimming), returns `never`.
-*
-* @template T - The string type to check.
-* @template WithTrim - Whether to trim whitespace before checking (default `true`).
-*
-* @example
-* ```ts
-* // Non-empty string
-* type Case1 = NonEmptyString<"abc">; // ➔ "abc"
-*
-* // Empty string
-* type Case2 = NonEmptyString<"">; // ➔ never
-*
-* // General string type
-* type Case3 = NonEmptyString<string>; // ➔ string
-*
-* // String with whitespace
-* type Case4 = NonEmptyString<"  ", true>; // ➔ never (trimmed to empty)
-* type Case5 = NonEmptyString<"  ", false>; // ➔ "  " (not trimmed)
-* ```
-*/
-type NonEmptyString<T extends string,WithTrim extends boolean=true>=string extends T?string:If<IsNever<EmptyString<T,WithTrim>>,WithTrim extends true?Trim<T>:T,never>;
-/** -------------------------------------------------------
-* * ***IsEmptyString.***
-* -------------------------------------------------------
-* Returns `true` if `T` is exactly the empty string `""`.
-* Optionally trims whitespace before checking.
-*
-* Behavior:
-* - If `WithTrim` is `true` (default), trims `T` before checking.
-* - If `T` is empty after optional trimming, returns `true`.
-* - Otherwise, returns `false`.
-*
-* @template T - The string type to check.
-* @template WithTrim - Whether to trim whitespace before checking (default `true`).
-*
-* @example
-* ```ts
-* type Case1 = IsEmptyString<"">;
-* // ➔ true
-* type Case2 = IsEmptyString<"abc">;
-* // ➔ false
-* type Case3 = IsEmptyString<"  ", true>;
-* // ➔ true (trimmed)
-* type Case4 = IsEmptyString<"  ", false>;
-* // ➔ false (not trimmed)
-* ```
-*/
-type IsEmptyString<T extends string,WithTrim extends boolean=true>=IfNot<IsNever<EmptyString<T,WithTrim>>>;
-/** -------------------------------------------------------
-* * ***IsNonEmptyString.***
-* -------------------------------------------------------
-* Returns `true` if `T` is a non-empty string.
-* Optionally trims whitespace before checking.
-*
-* Behavior:
-* - If `WithTrim` is `true` (default), trims `T` before checking.
-* - Returns `true` if `T` is non-empty after optional trimming.
-* - Returns `false` if `T` is empty (after trimming if `WithTrim=true`).
-*
-* @template T - The string type to check.
-* @template WithTrim - Whether to trim whitespace before checking (default `true`).
-*
-* @example
-* ```ts
-* type Case1 = IsNonEmptyString<"abc">;
-* // ➔ true
-* type Case2 = IsNonEmptyString<"">;
-* // ➔ false
-* type Case3 = IsNonEmptyString<"  ", true>;
-* // ➔ false (trimmed)
-* type Case4 = IsNonEmptyString<"  ", false>;
-* // ➔ true (not trimmed)
-* ```
-*/
-type IsNonEmptyString<T extends string,WithTrim extends boolean=true>=IfNot<IsNever<NonEmptyString<T,WithTrim>>>;
-/** -------------------------------------------------------
-* * ***IfEmptyString.***
-* -------------------------------------------------------
-* Conditional type: returns `IfTrue` if `T` is an empty string `""`,
-* otherwise returns `IfFalse`. Optionally trims whitespace before checking.
-*
-* @template T - The string type to check.
-* @template IfTrue - Type returned if `T` is empty (default `true`).
-* @template IfFalse - Type returned if `T` is not empty (default `false`).
-* @template WithTrim - Whether to trim whitespace before checking (default `true`).
-*
-* @example
-* ```ts
-* type Case1 = IfEmptyString<"">;
-* // ➔ true
-* type Case2 = IfEmptyString<"abc">;
-* // ➔ false
-* type Case3 = IfEmptyString<"", "yes", "no">;
-* // ➔ "yes"
-* type Case4 = IfEmptyString<"abc", "yes", "no">;
-* // ➔ "no"
-* type Case5 = IfEmptyString<"  ", "yes", "no", true>;
-* // ➔ "yes" (trimmed)
-* type Case6 = IfEmptyString<"  ", "yes", "no", false>;
-* // ➔ "no" (not trimmed)
-* ```
-*/
-type IfEmptyString<T extends string,IfTrue=true,IfFalse=false,WithTrim extends boolean=true>=IfNot<IsNever<EmptyString<T,WithTrim>>,IfTrue,IfFalse>;
-/** -------------------------------------------------------
-* * ***IfNonEmptyString.***
-* -------------------------------------------------------
-* Conditional type: returns `IfTrue` if `T` is a non-empty string,
-* otherwise returns `IfFalse`. Optionally trims whitespace before checking.
-*
-* @template T - The string type to check.
-* @template IfTrue - Type returned if `T` is non-empty (default `true`).
-* @template IfFalse - Type returned if `T` is empty (default `false`).
-* @template WithTrim - Whether to trim whitespace before checking (default `true`).
-*
-* @example
-* ```ts
-* type Case1 = IfNonEmptyString<"abc">;
-* // ➔ true
-* type Case2 = IfNonEmptyString<"">;
-* // ➔ false
-* type Case3 = IfNonEmptyString<"abc", "yes", "no">;
-* // ➔ "yes"
-* type Case4 = IfNonEmptyString<"", "yes", "no">;
-* // ➔ "no"
-* type Case5 = IfNonEmptyString<"  ", "yes", "no", true>;
-* // ➔ "no" (trimmed)
-* type Case6 = IfNonEmptyString<"  ", "yes", "no", false>;
-* // ➔ "yes" (not trimmed)
-* ```
-*/
-type IfNonEmptyString<T extends string,IfTrue=true,IfFalse=false,WithTrim extends boolean=true>=IfNot<IsNever<NonEmptyString<T,WithTrim>>,IfTrue,IfFalse>;
-/** -------------------------------------------------------
 * * ***Or.***
 * -------------------------------------------------------
 *
@@ -1554,4 +1204,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{NegativeFloat as $,And as A,IfFloat as B,CharAt as C,IfInteger as D,Even as E,Float as F,IfNegativeFloat as G,IfNegativeInteger as H,IsStringLiteral as I,IfOdd as J,IfPositiveFloat as K,IfPositiveInteger as L,Mutable as M,Negate as N,Or as O,ParseNumber as P,Integer as Q,Repeat as R,Split as S,Trim as T,IsNegativeFloat as U,IsOdd as V,Whitespace as W,IsPositiveFloat as X,IsPositiveInteger as Y,IsScientificNumber as Z,Negative as _,IsEmptyString as a,NegativeInteger as a0,Odd as a1,OddDigit as a2,ParseScientificNumber as a3,Positive as a4,PositiveFloat as a5,PositiveInteger as a6,EmptyString as a7,IfNonEmptyString as a8,IsNonEmptyString as a9,NonEmptyString as aa,TrimLeft as ab,TrimRight as ac,TrimsLower as ad,TrimsUpper as ae,IfUnknown as af,UnknownifyProperties as ag,UnknownifyPropertiesOptions as ah,IsNegative as b,Abs as c,IsFloat as d,IsUnknown as e,IsNegativeInteger as f,IfEmptyString as g,OrArr as h,AndArr as i,IsInteger as j,Push as k,IfNegative as l,IsPositive as m,IsEven as n,AnyString as o,IsReadonlyArray as p,IfPositive as q,WordSeparator as r,IfNot as s,IsArray as t,IsMutableArray as u,MutableExcept as v,MutableOnly as w,MutableOptions as x,EvenDigit as y,IfEven as z};
+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};

package/dist/{isPlainObject-BKYaI6a8.d.ts → isPlainObject-BVhBAPHX.d.ts}

@@ -1,4 +1,6 @@
-import{N as NonPlainObject}from'./type-data-DDs-u2kq.js';type GetPreciseTypeOptions={
+import{N as NonPlainObject}from'./type-data-DDs-u2kq.js';
+/** Types for **{@link getPreciseType}**. */
+type GetPreciseTypeOptions={
 /** -------------------------------------------------------
 * * ***Specifies the format in which the returned string type should be transformed.***
 * -------------------------------------------------------
@@ -30,31 +32,28 @@ import{N as NonPlainObject}from'./type-data-DDs-u2kq.js';type GetPreciseTypeOpti
 */
 formatCase?:"toPascalCaseSpace"|"toPascalCase"|"toCamelCase"|"toKebabCase"|"toSnakeCase"|"toDotCase"|"slugify"|"toLowerCase";};
 /** ----------------------------------------------------------
-* * ***Returns a detailed and normalized type string for the given value.***
+* * ***Utility-Predicate: `getPreciseType`.***
 * ----------------------------------------------------------
-*
-* The returned string is human-readable _**toLowerCase**_ with spaces _***(by default)***_ or
-* formatted according to the `options.formatCase` setting.
-*
-* Handles:
-* - Primitives (`string`, `number`, `boolean`, `null`, `undefined`, `symbol`, `bigint`)
-* - Built-in objects (`Array`, `Map`, `Set`, `Error subclasses`, `Typed Arrays`, etc)
-* - Objects created with `Object.create(null)`
-* - Generator instances
-* - Node.js `Buffer` instances
-* - Proxy detection (returns `"Proxy"` if detected; detection is not 100% accurate)
-* - Uses cached mapping table (`FIXES`) for known types to provide consistent naming
-* - Falls back to constructor name or `Object.prototype.toString` tag
-*
+* **Returns a detailed and normalized type string for the given value.**
+* @description
+* The returned string is human-readable _**toLowerCase**_ with spaces _***(by default)***_ or formatted according to the `options.formatCase` setting.
+* - **Handles:**
+*    - Primitives (`string`, `number`, `boolean`, `null`, `undefined`, `symbol`, `bigint`)
+*    - Built-in objects (`Array`, `Map`, `Set`, `Error subclasses`, `Typed Arrays`, `etc`)
+*    - Objects created with `Object.create(null)`
+*    - Generator instances
+*    - Node.js `Buffer` instances
+*    - Proxy detection (returns `"Proxy"` if detected; detection is not 100% accurate)
+*    - Uses cached mapping table (`FIXES`) for known types to provide consistent naming
+*    - Falls back to constructor name or `Object.prototype.toString` tag
 * @param {*} value - The value to detect the precise type of
-* @param {Object} [options] - Optional configuration
-* @param {"toPascalCaseSpace"|"toLowerCase"|"toPascalCase"|"toCamelCase"|"toKebabCase"|"toSnakeCase"|"toDotCase"|"slugify"} [options.formatCase="toLowerCase"]
-*   - Specifies how the returned type string should be formatted.
-*   - ⚠️ Special string literals in `SPECIAL_CASES` (`"-Infinity" | "Infinity" | "NaN"`)
-*     will remain unchanged even if a different `formatCase` is applied.
-*
+* @param {GetPreciseTypeOptions} [options] - Optional configuration
+* @param {GetPreciseTypeOptions["formatCase"]} [options.formatCase="toLowerCase"]
+*   Specifies how the returned type string should be formatted.
+*   - ⚠️ Special string literals in `SPECIAL_CASES`
+*     (`"-Infinity" | "Infinity" | "NaN"`) will remain
+*     unchanged even if a different `formatCase` is applied.
 * @returns {string} The normalized and formatted type string
-*
 * @example
 * getPreciseType(123);  // ➔ "number"
 * getPreciseType(null); // ➔ "null"
@@ -64,32 +63,30 @@ formatCase?:"toPascalCaseSpace"|"toPascalCase"|"toCamelCase"|"toKebabCase"|"toSn
 * // ➔ "generatorFunction"
 * getPreciseType(async function () {}, { formatCase: "toPascalCaseSpace" });
 * // ➔ "Async Function"
-* getPreciseType("NaN", { formatCase: "toKebabCase" });
+* getPreciseType(NaN, { formatCase: "toKebabCase" });
 * // ➔ "NaN" (SPECIAL_CASES remain)
 */
 declare const getPreciseType:(value:unknown,options?:GetPreciseTypeOptions)=>string;type IsNumberOptions={
-/**
-* If set to `true`, `NaN` will be considered a valid number.
+/** If set to `true`, `NaN` will be considered a valid number, defaultValue: `false`.
+*
 * @default false
 */
 includeNaN?:boolean;};
 /** ---------------------------------------------------------
 * * ***Type guard: `isNumber`.***
 * ----------------------------------------------------------
-* @description Checks if a value is of type **`number`**.
-*
-* - Uses `typeof value === "number"`.
-* - By default, excludes **`NaN`**.
-* - If `options.includeNaN` is `true`, then **`NaN`** is also considered valid.
-* - Still considers `Infinity` and `-Infinity` as numbers (consistent with JavaScript).
-*
-* ℹ️ To exclude `Infinity` and `-Infinity`, use **{@link isFinite}** instead.
-*
+* **Checks if a value is of type **`number`**.**
+* - **Behavior:**
+*    - Uses `typeof value === "number"`.
+*    - By default, excludes **`NaN`**.
+*    - If `options.includeNaN` is `true`, then **`NaN`** is also considered valid.
+*    - Still considers `Infinity` and `-Infinity` as **numbers** (consistent with JavaScript).
+* - **ℹ️ Note:**
+*    - To exclude `Infinity` and `-Infinity`, use **{@link isFinite | `isFinite`}** instead.
 * @param {*} value - The value to check.
-* @param {IsNumberOptions} options - Optional settings.
-* @param {boolean} options.includeNaN  If `true`, `NaN` will be considered a valid number, dsefaults to `false`, which excludes `NaN`.
+* @param {IsNumberOptions} [options] - Optional settings.
+* @param {boolean} [options.includeNaN=false]  If `true`, `NaN` will be considered a valid number, defaults to `false`, which excludes `NaN`.
 * @returns {boolean} Returns `true` if the value is a number (and depending on `includeNaN`, `NaN` is included or excluded).
-*
 * @example
 * isNumber(42);
 * // ➔ true
@@ -108,18 +105,14 @@ declare const isNumber:(value:unknown,options?:IsNumberOptions)=>value is number
 /** ----------------------------------------------------------
 * * ***Utility type: `IsPlainObjectResult`.***
 * ----------------------------------------------------------
-* @description
-* Represents the inferred type after asserting a value is a **plain object**.
-*
-
-*
-* - If `T` is `unknown`, the resulting type is `Record<PropertyKey, unknown> & T`.
-* - If `T` is an object:
-*    - If it is a non-plain object (class instance, built-in object, etc.), the result is `never`.
-*    - If it has no keys (`HasKeys<T>` checked by **{@link HasKeys}** is false), the result is `Record<PropertyKey, unknown> & T`.
-*    - Otherwise, the result is `T` itself.
-* - For any other types, the result is `never`.
-*
+* **Represents the inferred type after asserting a value is a **plain object**.**
+* - **Behavior:**
+*    - If `T` is `unknown`, the resulting type is `Record<PropertyKey, unknown> & T`.
+*    - If `T` is an object:
+*        - If it is a non-plain object (class instance, built-in object, etc.), the result is `never`.
+*        - If it has no keys (`HasKeys<T>` checked by **{@link HasKeys}** is false), the result is `Record<PropertyKey, unknown> & T`.
+*        - Otherwise, the result is `T` itself.
+*    - For any other types, the result is `never`.
 * @template T - The input type to be asserted as a plain object.
 * @example
 * ```ts
@@ -137,18 +130,14 @@ type IsPlainObjectResult<T>=unknown extends T?Record<PropertyKey,unknown>& T:T e
 /** ----------------------------------------------------------
 * * ***Type guard: `isPlainObject`.***
 * ----------------------------------------------------------
-* @description
-* Checks if a value is a **plain-object**.
-*
-* A plain object is:
-* - Created by the `Object` constructor, or
-* - Has a `[[Prototype]]` of `null` (e.g. `Object.create(null)`).
-* ----------------------------------------------------------
-* - ✅ Returns `true` for:
+* **Checks if a value is a **plain-object**.**
+* - **A plain object is:**
+*    - Created by the `Object` constructor, or
+*    - Has a `[[Prototype]]` of `null` (e.g. `Object.create(null)`).
+* - **✅ Returns `true` for:**
 *    - Empty object literals: `{}`
 *    - Objects with null prototype: `Object.create(null)`
-* ----------------------------------------------------------
-* - ❌ Returns `false` for:
+* - **❌ Returns `false` for:**
 *    - Arrays (`[]`, `new Array()`)
 *    - Functions (regular, arrow, or class constructors)
 *    - Built-in objects: `Date`, `RegExp`, `Error`, `Map`, `Set`, `WeakMap`, `WeakSet`
@@ -156,11 +145,9 @@ type IsPlainObjectResult<T>=unknown extends T?Record<PropertyKey,unknown>& T:T e
 *    - `null` or `undefined`
 *    - Symbols
 *    - Class instances
-*
 * @template T - The type of the value being checked.
 * @param {*} value - The value to check.
 * @returns {boolean} Return `true` if `value` is a `plain-object`, otherwise `false`.
-*
 * @example
 * isPlainObject({});
 * // ➔ true

package/dist/next/index.cjs

@@ -1,8 +1,8 @@
-'use strict';var chunk5JFV3GDE_cjs=require('../chunk-5JFV3GDE.cjs'),chunkN2IJPIND_cjs=require('../chunk-N2IJPIND.cjs'),chunk2TRAPBZ7_cjs=require('../chunk-2TRAPBZ7.cjs'),chunkBVPMMWDL_cjs=require('../chunk-BVPMMWDL.cjs');require('../chunk-PUQXRLZH.cjs');var chunkU5Y2FXMN_cjs=require('../chunk-U5Y2FXMN.cjs');require('../chunk-7YWAQOA4.cjs');var chunkCN53M4QZ_cjs=require('../chunk-CN53M4QZ.cjs');function C(e,t){if(!chunkCN53M4QZ_cjs.h(e)||chunk2TRAPBZ7_cjs.a(e))throw new TypeError(`\u274C 'generateRoute' Failed:
+'use strict';var chunkO5VXBNUQ_cjs=require('../chunk-O5VXBNUQ.cjs'),chunk445TAVT4_cjs=require('../chunk-445TAVT4.cjs'),chunk6Q4I2RPC_cjs=require('../chunk-6Q4I2RPC.cjs'),chunkDYRDBYPF_cjs=require('../chunk-DYRDBYPF.cjs');require('../chunk-PUQXRLZH.cjs');var chunkO7SJR4CY_cjs=require('../chunk-O7SJR4CY.cjs');require('../chunk-7YWAQOA4.cjs');var chunkLVUSFXQS_cjs=require('../chunk-LVUSFXQS.cjs');function N(e,t){if(!chunkLVUSFXQS_cjs.g(e)||chunk6Q4I2RPC_cjs.a(e))throw new TypeError(`\u274C 'generateRoute' Failed:
 - Invalid 'route' value.
-- Must be of type \`string\` and non-empty string, but received: "${chunkCN53M4QZ_cjs.E(e)}": \`${chunkU5Y2FXMN_cjs.c(e)}\`.`);if(!/[\\[\]]/.test(e))return e;if(chunkCN53M4QZ_cjs.m(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.`}),chunkCN53M4QZ_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(!chunkCN53M4QZ_cjs.h(i)){r.push(`- Invalid parameter: "${o}" must be of type \`string\`, but received: \`${chunkCN53M4QZ_cjs.E(i)}\`.`);continue}if(chunk2TRAPBZ7_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 c=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: (${c.join(", ")}).`);}}if(chunkCN53M4QZ_cjs.r(r))throw new Error(`\u274C 'generateRoute' Failed cause in route "${e}":
+- Must be of type \`string\` and non-empty string, but received: "${chunkLVUSFXQS_cjs.E(e)}": \`${chunkO7SJR4CY_cjs.c(e)}\`.`);if(!/[\\[\]]/.test(e))return e;if(chunkLVUSFXQS_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.`}),chunkLVUSFXQS_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(!chunkLVUSFXQS_cjs.g(i)){r.push(`- Invalid parameter: "${o}" must be of type \`string\`, but received: \`${chunkLVUSFXQS_cjs.E(i)}\`.`);continue}if(chunk6Q4I2RPC_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(chunkLVUSFXQS_cjs.r(r))throw new Error(`\u274C 'generateRoute' Failed cause in route "${e}":
 ${r.join(`
-`)}.`);return e.replace(/\[(\w+)\]/g,(o,i)=>(chunkCN53M4QZ_cjs.p(t[i])?t[i]:"").trim().replace(/^\/+|\/+$/g,"")).replace(/\/+/g,"/")}var M=(e="",t)=>{try{let p=function(c,a){return `${c.replace(/\/+$/,"")}/${a.replace(/^\/+/,"")}`};var n=p;chunkBVPMMWDL_cjs.a(e,{message({currentType:c,validType:a}){return `First parameter \`pathname\` must be of type \`${a}\`, but received: \`${c}\`.`}}),chunkCN53M4QZ_cjs.f(t)||(t={});let{prefix:r="/api",withOrigin:s=!0}=t;if(!chunkCN53M4QZ_cjs.k(r)&&!chunkCN53M4QZ_cjs.h(r))throw new TypeError(`Parameter \`prefix\` property of the \`options\` (second parameter) must be of type \`string\`, but received: ${chunkCN53M4QZ_cjs.E(r)}.`);chunkCN53M4QZ_cjs.G(s,{message:({currentType:c,validType:a})=>`Parameter \`withOrigin\` property of the \`options\` (second parameter) must be of type \`${a}\`, but received: \`${c}\`.`}),e=chunk5JFV3GDE_cjs.c(e),r=chunk5JFV3GDE_cjs.c(r);let o=r.endsWith("/")?r:r+"/";(e===r||e===r+"/"||e.startsWith(o))&&(e=e.slice(r.length),e=chunk5JFV3GDE_cjs.c(e));let i=U({suffix:r});return p(s?i:new URL(i).pathname,e).replace(/\/+$/,"")}catch(r){throw new Error("Failed to generate backend API URL in `createBeApiUrl()`, Error:"+r)}};var U=({suffix:e="/"}={})=>{chunkBVPMMWDL_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=chunkN2IJPIND_cjs.c(t);let s=new URL(t);!!!s.port&&process.env.NEXT_PUBLIC_PORT_BE&&(t=s.origin+chunk5JFV3GDE_cjs.d(process.env.NEXT_PUBLIC_PORT_BE,{prefixColon:!0}));}else t="http://localhost"+chunk5JFV3GDE_cjs.d(process.env.NEXT_PUBLIC_PORT_BE||"8000",{prefixColon:!0});e=chunkN2IJPIND_cjs.c(e).length?chunkN2IJPIND_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 Z=()=>{try{let e=process.env.NEXT_PUBLIC_BASE_URL?.trim(),t=process.env.NEXT_PUBLIC_PORT_FE?.trim(),n=e||"http://localhost";n=chunkN2IJPIND_cjs.c(n).replace(/\/+$/,"");let r=/:\/\/[^/]+:\d+/.test(n);!r&&t?n+=chunk5JFV3GDE_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=M;exports.generateRoute=C;exports.getBaseUrl=Z;exports.getBeApiUrl=U;
+`)}.`);return e.replace(/\[(\w+)\]/g,(o,i)=>(chunkLVUSFXQS_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;chunkDYRDBYPF_cjs.a(chunkLVUSFXQS_cjs.c(e)?"":e,{message({currentType:m,validType:a}){return `First parameter (\`pathname\`) must be of type \`${a}\`, but received: \`${m}\`.`}}),chunkLVUSFXQS_cjs.f(t)||(t={});let{prefix:r="/api",withOrigin:s=!0}=t;if(!chunkLVUSFXQS_cjs.m(r)&&!chunkLVUSFXQS_cjs.g(r))throw new TypeError(`Parameter \`prefix\` property of the \`options\` (second parameter) must be of type \`string\`, but received: \`${chunkLVUSFXQS_cjs.E(r)}\`.`);chunkLVUSFXQS_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=chunkO5VXBNUQ_cjs.c(e),r=chunkO5VXBNUQ_cjs.c(r);let o=r.endsWith("/")?r:r+"/";(e===r||e===r+"/"||e.startsWith(o))&&(e=e.slice(r.length),e=chunkO5VXBNUQ_cjs.c(e));let i=b({suffix:r});return p(s?i:new URL(i).pathname,e).replace(/\/+$/,"")}catch(r){throw chunkLVUSFXQS_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="/"}={})=>{chunkDYRDBYPF_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=chunk445TAVT4_cjs.c(t);let s=new URL(t);!!!s.port&&process.env.NEXT_PUBLIC_PORT_BE&&(t=s.origin+chunkO5VXBNUQ_cjs.d(process.env.NEXT_PUBLIC_PORT_BE,{prefixColon:!0}));}else t="http://localhost"+chunkO5VXBNUQ_cjs.d(process.env.NEXT_PUBLIC_PORT_BE||"8000",{prefixColon:!0});e=chunk445TAVT4_cjs.c(e).length?chunk445TAVT4_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=chunk445TAVT4_cjs.c(n).replace(/\/+$/,"");let r=/:\/\/[^/]+:\d+/.test(n);!r&&t?n+=chunkO5VXBNUQ_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;