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

package/dist/generators/index.js

@@ -2,15 +2,15 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.1`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { A as isPlainObject, D as isNaN, F as isBoolean, p as isNonEmptyArray, r as getPreciseType, t as assertIsBoolean, w as isNumber, y as isNonEmptyString } from "../assertIsBoolean-DR1SaXPD.js";
-import { t as safeStableStringify } from "../safeStableStringify-CXOZ9Ub8.js";
-import { t as noop } from "../noop-ubqAIbHD.js";
-import { t as isInteger } from "../isInteger-naMbJsxJ.js";
+import { A as isPlainObject, D as isNaN, F as isBoolean, p as isNonEmptyArray, r as getPreciseType, t as assertIsBoolean, w as isNumber, y as isNonEmptyString } from "../assertIsBoolean-Bv6gL-xe.js";
+import { t as safeStableStringify } from "../safeStableStringify-BrOcdX9n.js";
+import { t as noop } from "../noop-DGg9vMSD.js";
+import { t as isInteger } from "../isInteger-DZ163OQg.js";
 function getRandomItem(array) {
 	if (!isNonEmptyArray(array)) return void 0;
 	return array[Math.floor(Math.random() * (array.length || 0))];

package/dist/{index-59zbLcPr.d.ts → index-3jBnthag.d.cts}

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

package/dist/{index-UPp94Agr.d.ts → index-BXwimNPA.d.cts}

@@ -2,13 +2,13 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.1`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { i as ArrayFallback, r as IsHasKeysObject, t as IsPlainObjectResult } from "./isPlainObject-DxNDL8XU.js";
+import { i as ArrayFallback, r as IsHasKeysObject, t as IsPlainObjectResult } from "./isPlainObject-CBABRyEX.cjs";
 import { AnObjectNonArray, AnyFunction, AnyString, CharAt, Extends, IsAny, IsArray, IsEmptyString, IsNever, IsPositive, IsStringLiteral, NumberRangeUnion, OrArr, ParseNumber, Prettify, Trim, TypedArray } from "@rzl-zone/ts-types-plus";
 /** ----------------------------------------------------------
 * * ***Predicate: `areArraysEqual`.***

package/dist/{index-C267akkJ.d.ts → index-BlTCrSyc.d.cts}

@@ -2,15 +2,15 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.1`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { FormatOptions, Locale } from "date-fns";
 import { AnyString, ExtractStrict, OmitStrict, OverrideTypes, Prettify } from "@rzl-zone/ts-types-plus";
 import { CountryCode, NumberFormat } from "libphonenumber-js";
+import { FormatOptions, Locale } from "date-fns";
 type NegativeFormatOptionCustom = {
   /**
   * Custom formatter function for the final formatted negative string.

package/dist/{index-Qm3iFwd0.d.cts → index-CEm8ZOvj.d.ts}

@@ -2,15 +2,15 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.1`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
+import { FormatOptions, Locale } from "date-fns";
 import { AnyString, ExtractStrict, OmitStrict, OverrideTypes, Prettify } from "@rzl-zone/ts-types-plus";
 import { CountryCode, NumberFormat } from "libphonenumber-js";
-import { FormatOptions, Locale } from "date-fns";
 type NegativeFormatOptionCustom = {
   /**
   * Custom formatter function for the final formatted negative string.

package/dist/{index-jyDqzicx.d.cts → index-CLq5kZmQ.d.cts}

@@ -2,13 +2,13 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.1`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { a as IsNumberOptions, c as GetPreciseTypeOptions, i as ArrayFallback, t as IsPlainObjectResult } from "./isPlainObject-BF-2-phb.cjs";
+import { a as IsNumberOptions, c as GetPreciseTypeOptions, i as ArrayFallback, t as IsPlainObjectResult } from "./isPlainObject-CBABRyEX.cjs";
 import { PickStrict, Prettify } from "@rzl-zone/ts-types-plus";
 /** -------------------------------------------------------
 * * ***Shape of the object passed to custom error message functions.***

package/dist/{index-CeBC2Vvl.d.cts → index-Ckao53JY.d.ts}

@@ -2,13 +2,13 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.1`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { i as ArrayFallback, r as IsHasKeysObject, t as IsPlainObjectResult } from "./isPlainObject-BF-2-phb.cjs";
+import { i as ArrayFallback, r as IsHasKeysObject, t as IsPlainObjectResult } from "./isPlainObject-Dr8gi89U.js";
 import { AnObjectNonArray, AnyFunction, AnyString, CharAt, Extends, IsAny, IsArray, IsEmptyString, IsNever, IsPositive, IsStringLiteral, NumberRangeUnion, OrArr, ParseNumber, Prettify, Trim, TypedArray } from "@rzl-zone/ts-types-plus";
 /** ----------------------------------------------------------
 * * ***Predicate: `areArraysEqual`.***

package/dist/{index-D4fcasfZ.d.cts → index-DHHrLc0B.d.ts}

@@ -2,16 +2,16 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.1`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { Stringify } from "@rzl-zone/ts-types-plus";
-import { Config } from "tailwindcss";
 import { ClassNameValue, ConfigExtension } from "tailwind-merge-v3";
 import { ClassNameValue as ClassNameValue$1, ConfigExtension as ConfigExtension$1 } from "tailwind-merge-v4";
+import { Stringify } from "@rzl-zone/ts-types-plus";
+import { Config } from "tailwindcss";
 /** ----------------------------------------------------------
 * * ***Type-Utility: `ClassValue`.***
 * ----------------------------------------------------------
@@ -117,21 +117,127 @@ type ClassValues = ClassValue[];
 * ```
 */
 declare function cx(...values: ClassValues): string;
+/** -------------------------------------------------------------------
+* * ***Combines and merges class utility values into a single normalized
+* string with `Tailwind CSS v3` conflict resolution.***
+* --------------------------------------------------------------------
+*
+* This utility composes {@link cx | `cx`} and {@link twMergeV3 | `twMerge`} version **2** for ***`tailwind version 3`***:
+*
+* - `cx` handles flexible class inputs (like `clsx`)
+* - `twMerge` resolves Tailwind CSS utility conflicts
+*
+* This provides a complete solution for conditional class composition
+* with deterministic Tailwind merging.
+*
+* - **Behavior:**
+*    - Accepts strings, numbers, arrays, and objects
+*    - Supports deeply nested class structures
+*    - Ignores falsy values (`false`, `null`, `undefined`, `""`, `0`)
+*    - Includes object keys with truthy values (including inherited keys)
+*    - Unwraps boxed primitives (`new String()`, etc.)
+*    - Resolves Tailwind utility conflicts deterministically
+*    - Keeps the last conflicting class based on input order
+*    - Produces a clean, space-normalized class string
+*
+* This utility is a drop-in replacement for `clsx` or `classnames`
+* with built-in Tailwind conflict resolution.
+*
+* @param values - A list of mixed class values including strings,
+* numbers, arrays, objects, and conditional expressions.
+*
+* @returns A merged and normalized CSS class string.
+*
+* @example
+* ```ts
+* cn(
+*   "p-2",
+*   isActive && "bg-blue-500",
+*   ["text-sm", { "font-bold": isBold }],
+*   null,
+*   0
+* );
+* // => "p-2 bg-blue-500 text-sm font-bold"
+* ```
+*
+* @example
+* ```ts
+* cn("p-2 p-4", { "text-sm": true, "text-lg": true });
+* // => "p-4 text-lg"
+* ```
+*/
+declare const cnVer3: (...values: ClassValues) => string;
+/** -------------------------------------------------------------------
+* * ***Combines and merges class utility values into a single normalized
+* string with `Tailwind CSS v4` conflict resolution.***
+* --------------------------------------------------------------------
+*
+* This utility composes {@link cx | `cx`} and {@link twMergeV4 | `twMerge`} version **3** for ***`tailwind version 4`***:
+*
+* - `cx` handles flexible class inputs (like `clsx`)
+* - `twMerge` resolves Tailwind CSS utility conflicts
+*
+* This provides a complete solution for conditional class composition
+* with deterministic Tailwind merging.
+*
+* - **Behavior:**
+*    - Accepts strings, numbers, arrays, and objects
+*    - Supports deeply nested class structures
+*    - Ignores falsy values (`false`, `null`, `undefined`, `""`, `0`)
+*    - Includes object keys with truthy values (including inherited keys)
+*    - Unwraps boxed primitives (`new String()`, etc.)
+*    - Resolves Tailwind utility conflicts deterministically
+*    - Keeps the last conflicting class based on input order
+*    - Produces a clean, space-normalized class string
+*
+* This utility is a drop-in replacement for `clsx` or `classnames`
+* with built-in Tailwind conflict resolution.
+*
+* @param values - A list of mixed class values including strings,
+* numbers, arrays, objects, and conditional expressions.
+*
+* @returns A merged and normalized CSS class string.
+*
+* @example
+* ```ts
+* cn(
+*   "p-2",
+*   isActive && "bg-blue-500",
+*   ["text-sm", { "font-bold": isBold }],
+*   null,
+*   0
+* );
+* // => "p-2 bg-blue-500 text-sm font-bold"
+* ```
+*
+* @example
+* ```ts
+* cn("p-2 p-4", { "text-sm": true, "text-lg": true });
+* // => "p-4 text-lg"
+* ```
+*/
+declare const cnVer4: (...values: ClassValues) => string;
 /** -------------------------------------------------------------
 * * ***Default `cnV3` utility (Tailwind v3).***
 * -------------------------------------------------------------
+*
 * **Combines class-name values and then deduplicates/resolves
 * conflicts using {@link twMergeDefaultV3 | `twMergeDefaultV3`}
 * with **Tailwind v3 default config only**.**
 * - ✅ **Use this when:**
-*    - Your project uses **Tailwind v3**.
-*    - You need a simple `cn` that works out of the box without a custom config.
+*       - Your project uses **Tailwind v3**.
+*       - You need a simple `cn` that works out of the box without a custom config.
 * - ⚡ **Need custom rules?**
-*    - Create a project-wide helper using
-*      {@link twMergeDefaultV3 | `twMergeDefaultV3`} +
-*      {@link customCnV3 | `customCnV3`} (see Example 2).
+*       - Create a project-wide helper using
+*         {@link twMergeDefaultV3 | `twMergeDefaultV3`} +
+*         {@link customCnV3 | `customCnV3`} (see Example 2).
+*
+* @deprecated ***Still supported, but significantly slower during hydration because it uses extended runtime merge logic, prefer {@link cnVer3 | `cnVer3`} for
+* better performance, this utility may be removed in a future release.***
+*
 * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).
 * @returns {string} Merged Tailwind class string.
+*
 * @example
 * #### Example 1: ✅ Default usage (Tailwind v3).
 * ```ts
@@ -176,16 +282,21 @@ declare const cnV3: (...classes: ClassValues) => string;
 /** -------------------------------------------------------------
 * * ***Default `cnV4` utility (Tailwind v4).***
 * -------------------------------------------------------------
+*
 * **Combines class-name values and then deduplicates/resolves
 * conflicts using {@link twMergeDefaultV4 | `twMergeDefaultV4`}
 * with **Tailwind v4 default config only**.**
 * - ✅ **Use this when:**
-*    - Your project uses **Tailwind v4**.
-*    - You need a simple `cn` that works out of the box without a custom config.
+*       - Your project uses **Tailwind v4**.
+*       - You need a simple `cn` that works out of the box without a custom config.
 * - ⚡ **Need custom rules?**
-*    - Create a project-wide helper using
-*      {@link twMergeDefaultV4 | `twMergeDefaultV4`} +
-*      {@link customCnV4 | `customCnV4`} (see Example 2).
+*       - Create a project-wide helper using
+*         {@link twMergeDefaultV4 | `twMergeDefaultV4`} +
+*         {@link customCnV4 | `customCnV4`} (see Example 2).
+*
+* @deprecated ***Still supported, but significantly slower during hydration because it uses extended runtime merge logic, prefer {@link cnVer4 | `cnVer4`} for
+* better performance, this utility may be removed in a future release.***
+*
 * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).
 * @returns {string} Merged Tailwind class string.
 * @example
@@ -413,17 +524,111 @@ type OptionsMergeTwClsV4 = Omit<TwMergeConfigExt, "prefix"> & OptionsConfigMerge
 */
 type TwMergeDefaultFnV4 = (...classLists: ClassNameValue$1[]) => string;
 /** -------------------------------------------------------------
+* * ***High-performance `cn` factory utility (Tailwind `v3`).***
+* -------------------------------------------------------------
+* **Combines class-name values and applies the provided Tailwind merge
+* function using the native {@link twMergeV3 | `twMergeV3`} implementation
+* from `tailwind-merge` version 2 for `tailwind version 3`.**
+*
+* This utility is the recommended replacement for deprecated extended
+* runtime merge helpers because it provides significantly better hydration
+* and runtime performance.
+*
+* - ✅ **Recommended when:**
+*      - Your project uses **Tailwind v3**.
+*      - You want the fastest possible `cn` utility.
+*      - You need reusable project-wide `cn*` helpers.
+*      - You want predictable Tailwind conflict resolution with minimal overhead.
+*
+* - ⚡ **Performance note**
+*      - Uses the native `twMergeV3` implementation directly.
+*      - Faster than deprecated extended merge utilities.
+*      - Better suited for SSR and hydration-heavy applications.
+*
+* @param {TwMergeDefaultFnV3} customTwMergeV3 - Merge function created via {@link twMergeV3 | `twMergeV3`}.
+* @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).
+* @returns {string} Merged Tailwind class string.
+*
+* @example
+* ```ts
+* import { twMerge as twMergeV3 } from "tailwind-merge"; // tw-merge (v2) for tailwind version 3
+* import { customCnVer3, type ClassValues } from "@rzl-zone/utils-js/tailwind";
+*
+* // 1. Create app-level helper
+* export const cnApp = (...classes: ClassValues) => {
+*   return customCnVer3(twMergeV3, ...classes);
+* };
+*
+* // ✅ Usage
+* cnApp("p-2", "p-4");             // ➔ "p-4"
+* cnApp("text-sm text-lg");        // ➔ "text-lg"
+* cnApp("shadow-sm shadow-md");    // ➔ "shadow-md"
+* ```
+*/
+declare const customCnVer3: (customTwMergeV3?: TwMergeDefaultFnV3, ...classes: ClassValues) => string;
+/** -------------------------------------------------------------
+* * ***High-performance `cn` factory utility (Tailwind `v4`).***
+* -------------------------------------------------------------
+* **Combines class-name values and applies the provided Tailwind merge
+* function using the native {@link twMergeV4 | `twMergeV4`} implementation
+* from `tailwind-merge` version 3 for `tailwind version 4`.**
+*
+* This utility is the recommended replacement for deprecated extended
+* runtime merge helpers because it provides significantly better hydration
+* and runtime performance.
+*
+* - ✅ **Recommended when:**
+*      - Your project uses **Tailwind v4**.
+*      - You want the fastest possible `cn` utility.
+*      - You need reusable project-wide `cn*` helpers.
+*      - You want predictable Tailwind conflict resolution with minimal overhead.
+*
+* - ⚡ **Performance note**
+*      - Uses the native `twMergeV4` implementation directly.
+*      - Faster than deprecated extended merge utilities.
+*      - Better suited for SSR and hydration-heavy applications.
+*
+* @param {TwMergeDefaultFnV4} customTwMergeV4 - Merge function created via {@link twMergeV4 | `twMergeV4`}.
+* @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).
+* @returns {string} Merged Tailwind class string.
+*
+* @example
+* ```ts
+* import { twMerge as twMergeV4 } from "tailwind-merge"; // tw-merge (v3) for tailwind version 4
+* import { customCnVer4, type ClassValues } from "@rzl-zone/utils-js/tailwind";
+*
+* // 1. Create app-level helper
+* export const cnApp = (...classes: ClassValues) => {
+*   return customCnVer4(twMergeV4, ...classes);
+* };
+*
+* // ✅ Usage
+* cnApp("p-2", "p-4");             // ➔ "p-4"
+* cnApp("text-sm text-lg");        // ➔ "text-lg"
+* cnApp("shadow-sm shadow-md");    // ➔ "shadow-md"
+* ```
+*/
+declare const customCnVer4: (customTwMergeV4?: TwMergeDefaultFnV4, ...classes: ClassValues) => string;
+/** -------------------------------------------------------------
 * * ***Factory utility for building a custom `cn` helper (Tailwind `v3`).***
 * -------------------------------------------------------------
+*
 * **Wraps internally function to combines class-name values and applies the provided
 * Tailwind merge function (from {@link twMergeDefaultV3 | `twMergeDefaultV3`}).**
+*
 * - 🔑 **When to use it?**
 *      - Your project uses **Tailwind v3**.
 *      - You extend Tailwind merge rules (`classGroups`, `tailwind.config`).
 *      - You need multiple `cn*` variants across apps/packages.
+*
+* @deprecated ***Still supported, but slower during SSR and hydration because it relies on extended runtime merge logic,
+* prefer {@link customCnVer3 | `customCnVer3`}for better performance, this utility may be removed in a future release.***
+*
 * @param {TwMergeDefaultFnV3} customTwMergeV3 - Merge function created via {@link twMergeDefaultV3 | `twMergeDefaultV3`}.
 * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).
+*
 * @returns {string} Merged Tailwind class string.
+*
 * @example
 * ```ts
 * import tailwindConfig from "../tailwind.config";
@@ -453,15 +658,23 @@ declare const customCnV3: (customTwMergeV3: TwMergeDefaultFnV3, ...classes: Clas
 /** -------------------------------------------------------------
 * * ***Factory utility for building a custom `cn` helper (Tailwind `v4`).***
 * -------------------------------------------------------------
+*
 * **Wraps internally function to combines class-name values and applies the provided
 * Tailwind merge function (from {@link twMergeDefaultV4 | `twMergeDefaultV4`}).**
+*
 * - 🔑 **When to use it?**
 *      - Your project uses **Tailwind v4**.
 *      - You extend Tailwind merge rules (`classGroups`, `tailwind.config`).
 *      - You need multiple `cn*` variants across apps/packages.
+*
+* @deprecated ***Still supported, but slower during SSR and hydration because it relies on extended runtime merge logic,
+* prefer {@link customCnVer4 | `customCnVer4`}for better performance, this utility may be removed in a future release.***
+*
 * @param {TwMergeDefaultFnV4} customTwMergeV4 - Merge function created via {@link twMergeDefaultV4 | `twMergeDefaultV4`}.
 * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).
+*
 * @returns {string} Merged Tailwind class string.
+*
 * @example
 * ```ts
 * import tailwindConfig from "../tailwind.config";
@@ -546,6 +759,7 @@ declare const shouldForwardProp: <CustomProps extends Record<string, unknown>>(p
 /** -------------------------------------------------------------
 * * ***Customized Tailwind class merger Version 3 with extended rules.***
 * -------------------------------------------------------------
+*
 * **Wraps ***`extendTailwindMerge` from tailwind-merge-v3*** with Tailwind’s default
 * config (_*`getDefaultConfig()` from tailwind-merge-v3*_) to create a **project-ready `twMerge`**.**
 * - 🔑 **When to use it?**
@@ -554,6 +768,9 @@ declare const shouldForwardProp: <CustomProps extends Record<string, unknown>>(p
 *    - Respect your own **`tailwind.config.ts`** (colors, spacing, fontSize, etc).
 *    - Override or fine-tune **merge behavior**.
 *    - Create a **project-wide `cn` helper** that replaces raw `twMerge`.
+*
+* @deprecated ***Still supported for advanced Tailwind merge customization, but significantly slower than native `twMerge` during SSR and hydration because merge rules are extended at runtime, prefer `twMerge` + {@link customCnVer3 | `customCnVer3`} for better performance, this utility may be removed in a future release.***
+*
 * @param {OptionsMergeTwClsV3} [options={}]
 * ***Merge options:***
 *    - `config` – Your Tailwind config (from `tailwind.config.ts`).
@@ -562,8 +779,10 @@ declare const shouldForwardProp: <CustomProps extends Record<string, unknown>>(p
 *    - `override` – Fully replace rules.
 *    - `cacheSize` – Parsed class cache size.
 *    - `experimentalParseClassName` – Custom classname parser.
+*
 * @returns {TwMergeDefaultFnV3}
 * Customized Tailwind class merge function version 3 (same signature as `twMerge`).
+*
 * @example
 * #### Example 1: ***Default behavior (same as tailwind-merge).***
 * ```ts
@@ -633,6 +852,7 @@ declare const twMergeDefaultV3: (options?: OptionsMergeTwClsV3) => TwMergeDefaul
 /** -------------------------------------------------------------
 * * ***Customized Tailwind class merger Version 4 with extended rules.***
 * -------------------------------------------------------------
+*
 * **Wraps ***`extendTailwindMerge` from tailwind-merge-v4*** with Tailwind’s default
 * config (_*`getDefaultConfig()` from tailwind-merge-v4*_) to create a **project-ready `twMerge`**.**
 * - 🔑 **When to use it?**
@@ -641,6 +861,11 @@ declare const twMergeDefaultV3: (options?: OptionsMergeTwClsV3) => TwMergeDefaul
 *    - Respect your own **`tailwind.config.ts`** (colors, spacing, fontSize, etc).
 *    - Override or fine-tune **merge behavior**.
 *    - Create a **project-wide `cn` helper** that replaces raw `twMerge`.
+*
+* @deprecated ***Still supported for advanced Tailwind merge customization, but significantly slower than native `twMerge` during SSR and hydration because merge rules are extended at runtime, prefer `twMerge` + {@link customCnVer4 | `customCnVer4`} for better performance, this utility may be removed in a future release.***
+*
+* @deprecated ***Slower than the default `twMerge`, but still safe to use when custom merge behavior is needed.***
+*
 * @param {OptionsMergeTwClsV4} [options={}]
 *  ***Merge options:***
 *    - `config` – Your Tailwind config (from `tailwind.config.ts`).
@@ -649,8 +874,10 @@ declare const twMergeDefaultV3: (options?: OptionsMergeTwClsV3) => TwMergeDefaul
 *    - `override` – Fully replace rules.
 *    - `cacheSize` – Parsed class cache size.
 *    - `experimentalParseClassName` – Custom classname parser.
+*
 * @returns {TwMergeDefaultFnV4}
 * Customized Tailwind class merge function version 4 (same signature as `twMerge`).
+*
 * @example
 * #### Example 1: ***Default behavior (same as tailwind-merge).***
 * ```ts
@@ -717,4 +944,4 @@ declare const twMergeDefaultV3: (options?: OptionsMergeTwClsV3) => TwMergeDefaul
 * ```
 */
 declare const twMergeDefaultV4: (options?: OptionsMergeTwClsV4) => TwMergeDefaultFnV4;
-export { customCnV4 as a, ClassObject as c, cx as d, customCnV3 as i, ClassValue as l, twMergeDefaultV3 as n, cnV3 as o, shouldForwardProp as r, cnV4 as s, twMergeDefaultV4 as t, ClassValues as u };
+export { customCnV4 as a, cnV3 as c, cnVer4 as d, ClassObject as f, cx as h, customCnV3 as i, cnV4 as l, ClassValues as m, twMergeDefaultV3 as n, customCnVer3 as o, ClassValue as p, shouldForwardProp as r, customCnVer4 as s, twMergeDefaultV4 as t, cnVer3 as u };

package/dist/{index-gBA_8SuF.d.cts → index-DIeR8qa-.d.ts}

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

package/dist/{index-B6tawc8L.d.cts → index-DxZlGbAH.d.ts}

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

package/dist/{index-Hg1qJkjl.d.ts → index-DyVWeYP3.d.cts}

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

package/dist/{index-CgRDTI6f.d.ts → index-GSUN6rjA.d.ts}

@@ -2,13 +2,13 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.1`
+*  Version: `3.13.0-beta.2`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { a as IsNumberOptions, c as GetPreciseTypeOptions, i as ArrayFallback, t as IsPlainObjectResult } from "./isPlainObject-DxNDL8XU.js";
+import { a as IsNumberOptions, c as GetPreciseTypeOptions, i as ArrayFallback, t as IsPlainObjectResult } from "./isPlainObject-Dr8gi89U.js";
 import { PickStrict, Prettify } from "@rzl-zone/ts-types-plus";
 /** -------------------------------------------------------
 * * ***Shape of the object passed to custom error message functions.***

package/dist/{index-DsGxO31H.d.cts → index-_dJhBl1h.d.ts}

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

package/dist/{index-DDrSQKIc.d.ts → index-bMa-0Yr4.d.cts}

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