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

package/dist/strings/index.js

@@ -1 +1 @@
-export{b as getInitialsName,a as replaceAt}from'../chunk-LVKAYEZ4.js';export{a as normalizeSpaces,b as normalizeString,c as removeSpaces,d as stripHtmlTags}from'../chunk-GECI2YBP.js';import'../chunk-NIMNTEGV.js';export{s as capitalizeFirst,t as capitalizeWords,B as slugify,u as toCamelCase,A as toDotCase,y as toKebabCase,x as toLowerCase,w as toPascalCase,v as toPascalCaseSpace,z as toSnakeCase}from'../chunk-XCFIOTCV.js';
+export{getInitialsName,replaceAt}from"../chunk-2NWHDDM5.js";export{normalizeSpaces,normalizeString,removeSpaces,stripHtmlTags}from"../chunk-Q6NHYWVX.js";import"../chunk-TSLYDPBJ.js";export{capitalizeFirst,capitalizeWords,slugify,toCamelCase,toDotCase,toKebabCase,toLowerCase,toPascalCase,toPascalCaseSpace,toSnakeCase}from"../chunk-2UIRWYE3.js";

package/dist/tailwind/index.cjs

@@ -0,0 +1 @@
+"use strict";var e=require("../chunk-ODZQXH7E.cjs");require("../chunk-YT3MSZKK.cjs"),require("../chunk-INUFZJLX.cjs"),Object.defineProperty(exports,"cnV3",{enumerable:!0,get:function(){return e.cnV3}}),Object.defineProperty(exports,"cnV4",{enumerable:!0,get:function(){return e.cnV4}}),Object.defineProperty(exports,"customCnV3",{enumerable:!0,get:function(){return e.customCnV3}}),Object.defineProperty(exports,"customCnV4",{enumerable:!0,get:function(){return e.customCnV4}}),Object.defineProperty(exports,"shouldForwardProp",{enumerable:!0,get:function(){return e.shouldForwardProp}}),Object.defineProperty(exports,"twMergeDefaultV3",{enumerable:!0,get:function(){return e.twMergeDefaultV3}}),Object.defineProperty(exports,"twMergeDefaultV4",{enumerable:!0,get:function(){return e.twMergeDefaultV4}});

package/dist/tailwind/index.d.ts

@@ -0,0 +1,565 @@
+import{ClassValue}from'clsx';import{Config}from'tailwindcss';import{ClassNameValue as ClassNameValue$1,ConfigExtension as ConfigExtension$1}from'tailwind-merge-v3';import{ClassNameValue,ConfigExtension}from'tailwind-merge-v4';type ClassesValue=ClassValue[];
+/** -------------------------------------------------------------
+ * * ***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.
+ * - ⚡ **Need custom rules?**
+ *    - Create a project-wide helper using
+ *      {@link twMergeDefaultV3 | `twMergeDefaultV3`} +
+ *      {@link customCnV3 | `customCnV3`} (see Example 2).
+ * @param {ClassesValue} classes - Class values (string, array, object, etc).
+ * @returns {string} Merged Tailwind class string.
+ * @example
+ * #### Example 1: ✅ Default usage (Tailwind v3).
+ * ```ts
+ * cnV3("p-2", "p-4");
+ * // ➔ "p-4"
+ *
+ * cnV3("text-red-500", { "text-blue-500": true });
+ * // ➔ "text-blue-500"
+ *
+ * cnV3(["m-2", ["m-4"]], "m-8");
+ * // ➔ "m-8"
+ * ```
+ * #### Example 2: ⚡ Custom project-wide usage with Tailwind config.
+ * ```ts
+ * import tailwindConfig from "../tailwind.config";
+ * import { twMergeDefaultV3, customCnV3, type ClassesValue } from "@rzl-zone/utils-js/tailwind";
+ *
+ * const cnApp = (...classes: ClassesValue) => {
+ *   return customCnV3(
+ *     twMergeDefaultV3({
+ *       config: tailwindConfig,
+ *       extend: {
+ *         classGroups: {
+ *           "text-shadow": [
+ *             "text-shadow",
+ *             "text-shadow-sm",
+ *             "text-shadow-md",
+ *           ],
+ *         },
+ *       },
+ *     }),
+ *     // ...other options classes,
+ *   );
+ * };
+ *
+ * cnApp("p-2 p-4");             // ➔ "p-4"
+ * cnApp("shadow-sm shadow-md"); // ➔ "shadow-md"
+ * cnApp("text-base text-xxs");  // ➔ "text-xxs" (resolved from config)
+ * ```
+ */
+declare const cnV3:(...classes:ClassesValue)=>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.
+ * - ⚡ **Need custom rules?**
+ *    - Create a project-wide helper using
+ *      {@link twMergeDefaultV4 | `twMergeDefaultV4`} +
+ *      {@link customCnV4 | `customCnV4`} (see Example 2).
+ * @param {ClassesValue} classes - Class values (string, array, object, etc).
+ * @returns {string} Merged Tailwind class string.
+ * @example
+ * #### Example 1: ✅ Default usage (Tailwind v4).
+ * ```ts
+ * cnV4("p-2", "p-4");
+ * // ➔ "p-4"
+ *
+ * cnV4("text-red-500", { "text-blue-500": true });
+ * // ➔ "text-blue-500"
+ *
+ * cnV4(["m-2", ["m-4"]], "m-8");
+ * // ➔ "m-8"
+ * ```
+ * #### Example 2: ⚡ Custom project-wide usage with Tailwind config.
+ * ```ts
+ * import tailwindConfig from "../tailwind.config";
+ * import { twMergeDefaultV4, customCnV4, type ClassesValue } from "@rzl-zone/utils-js/tailwind";
+ *
+ * const cnApp = (...classes: ClassesValue) => {
+ *   return customCnV4(
+ *     twMergeDefaultV4({
+ *       config: tailwindConfig,
+ *       extend: {
+ *         classGroups: {
+ *           "text-shadow": [
+ *             "text-shadow",
+ *             "text-shadow-sm",
+ *             "text-shadow-md",
+ *           ],
+ *         },
+ *       },
+ *     }),
+ *     // ...other options classes,
+ *   );
+ * };
+ *
+ * cnApp("p-2 p-4");             // ➔ "p-4"
+ * cnApp("shadow-sm shadow-md"); // ➔ "shadow-md"
+ * cnApp("text-base text-xxs");  // ➔ "text-xxs" (resolved from config)
+ * ```
+ */
+declare const cnV4:(...classes:ClassesValue)=>string;
+/** Tailwind Merge config extension type */
+type TwMergeConfigExt$1=ConfigExtension<string,string>;
+/** * ***Extra options for customized Tailwind class merge.***  */
+type OptionsConfigMergeTwCn$1={
+/** ***Optional Tailwind CSS configuration object.***
+ *
+ * - **Pass your project’s `tailwind.config.ts` if you want to:**
+ *    - Respect custom theme values (`colors`, `fontSize`, `spacing`, `etc`.)
+ *    - Enable/disable `corePlugins`
+ *    - Register `plugins`
+ *    - Extend class groups (e.g., `text-shadow`)
+ * - **If omitted, the **default Tailwind config** is used.**
+ * @example
+ * ```ts
+ * import tailwindConfig from "../tailwind.config";
+ * import { twMergeDefaultV4 } from "@rzl-zone/utils-js/tailwind";
+ *
+ * const myCustomTwCls = twMergeDefaultV4({
+ *   config: tailwindConfig,
+ * });
+ *
+ * myCustomTwCls("text-primary text-secondary");
+ * // => "text-secondary" (resolved from your theme config)
+ * ```
+ */
+config?:TailwindConfig;
+/** ***Prefix added to Tailwind-generated classes.***
+ *
+ * - **Tailwind v3**:
+ *    - Use {@link twMergeDefaultV3 | **`twMergeDefaultV3`**} instead.
+ *    - Reference:
+ *      [**`Tailwind v3 using prefix docs`**](https://v3.tailwindcss.com/docs/configuration#prefix).
+ *
+ * - **Tailwind v4**:
+ *    - Configure in your CSS import, e.g. `@import "tailwindcss" prefix(tw);`
+ *    - The prefix appears like a variant at the start of the class, e.g. `tw:flex`,
+ *      `tw:bg-red-500`, `tw:hover:bg-red-600`.
+ *    - Reference:
+ *      [**`Tailwind v4 using prefix docs`**](https://tailwindcss.com/docs/upgrade-guide#using-a-prefix).
+ *
+ * - **ℹ️ Notes**:
+ *    - Tailwind v3:
+ *      - Use {@link twMergeDefaultV3 | **`twMergeDefaultV3`**} instead.
+ *    - Tailwind v4: prefer identifier (e.g. `tw`) without `-`.
+ *    - Fallback order:
+ *      1. `prefix` option
+ *      2. `config.prefix` (if defined)
+ *      3. `undefined`
+ *
+ * @example
+ * - Tailwind version 4 (in CSS entry only):
+ *    - CSS files:
+ *      ```css
+ *      `@import "tailwindcss" prefix(tw);`
+ *      ```
+ *    - Your custom TwMerge file:
+ *      ```ts
+ *      import { twMergeDefaultV4 } from "@rzl-zone/utils-js/tailwind";
+ *
+ *      const twMergeV3 = twMergeDefaultV4({
+ *        prefix: "tw",
+ *        // ... other config
+ *      });
+ *      ```
+ * - Tailwind version 4 (with `tailwind.config.{js,ts,mjs,...etc}`):
+ *      - Reference:
+ *        [**`Tailwind v4 using @config docs`**](https://tailwindcss.com/docs/functions-and-directives#config-directive).
+ *      - CSS files:
+ *        ```css
+ *        `@import "tailwindcss";`
+ *        `@config "./tailwind.config.ts";`
+ *        ```
+ *      - Config files:
+ *        ```ts
+ *        import type { Config } from "tailwindcss";
+ *
+ *        const config: Config = {
+ *          prefix: 'tw-',
+ *          // ... other config
+ *        };
+ *
+ *        export default config;
+ *        ```
+ *      - Your custom TwMerge file:
+ *        ```ts
+ *        import config from "../tailwind.config";
+ *        import { twMergeDefaultV4 } from "@rzl-zone/utils-js/tailwind";
+ *
+ *        const twMergeV4 = twMergeDefaultV4({ config });
+ *        // now without passing `prefix` options, will use automatic from config.
+ *        ```
+ */
+prefix?:string;};
+/** * ***Options type for Tailwind Merge v4 wrapper.*** */
+type OptionsMergeTwClsV4=Omit<TwMergeConfigExt$1,"prefix">& OptionsConfigMergeTwCn$1;
+/** * ***Tailwind Merge function Version 4 signature (same as twMerge).*** */
+type TwMergeDefaultFnV4=(...classLists:ClassNameValue[])=>string;type TailwindConfig=Config;
+/** Tailwind Merge config extension type */
+type TwMergeConfigExt=ConfigExtension$1<string,string>;
+/** * ***Extra options for customized Tailwind class merge.***  */
+type OptionsConfigMergeTwCn={
+/** ***Optional Tailwind CSS configuration object.***
+ *
+ * - **Pass your project’s `tailwind.config.ts` if you want to:**
+ *    - Respect custom theme values (`colors`, `fontSize`, `spacing`, `etc`.)
+ *    - Enable/disable `corePlugins`
+ *    - Register `plugins`
+ *    - Extend class groups (e.g., `text-shadow`)
+ * - **If omitted, the **default Tailwind config** is used.**
+ * @example
+ * ```ts
+ * import tailwindConfig from "../tailwind.config";
+ * import { twMergeDefaultV3 } from "@rzl-zone/utils-js/tailwind";
+ *
+ * const myCustomTwCls = twMergeDefaultV3({
+ *   config: tailwindConfig,
+ * });
+ *
+ * myCustomTwCls("text-primary text-secondary");
+ * // => "text-secondary" (resolved from your theme config)
+ * ```
+ */
+config?:TailwindConfig;
+/** ***Prefix added to Tailwind-generated classes.***
+ *
+ * - **Tailwind v3**:
+ *    - Configure in `tailwind.config.js`, e.g. `prefix: 'tw-'`.
+ *    - Variants first; negative utilities: `-mt-8` → `-tw-mt-8`.
+ *    - Reference:
+ *      [**`Tailwind v3 using prefix docs`**](https://v3.tailwindcss.com/docs/configuration#prefix).
+ * - **Tailwind v4**:
+ *    - Use {@link twMergeDefaultV4 | **`twMergeDefaultV4`**} instead.
+ *    - Reference:
+ *      [**`Tailwind v4 using prefix docs`**](https://tailwindcss.com/docs/upgrade-guide#using-a-prefix).
+ * - **ℹ️ Notes**:
+ *    - Tailwind v3: use hyphenated prefix (`tw-`).
+ *    - Fallback order:
+ *      1. `prefix` option
+ *      2. `config.prefix` (if defined)
+ *      3. `undefined`
+ *    - Tailwind v4:
+ *      - Use {@link twMergeDefaultV4 | **`twMergeDefaultV4`**} instead.
+ * @example
+ * - Tailwind version 3 (`tailwind.config.ts`):
+ * ```ts
+ *   import type { Config } from "tailwindcss";
+ *
+ *   const config: Config = {
+ *     prefix: 'tw-',
+ *     // ... other config
+ *   };
+ *
+ *   export default config;
+ * ```
+ */
+prefix?:string;};
+/** * ***Options type for Tailwind Merge v3 wrapper.*** */
+type OptionsMergeTwClsV3=Omit<TwMergeConfigExt,"prefix">& OptionsConfigMergeTwCn;
+/** * ***Tailwind Merge function Version 3 signature (same as twMerge).*** */
+type TwMergeDefaultFnV3=(...classLists:ClassNameValue$1[])=>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.
+ * @param {TwMergeDefaultFnV3} customTwMergeV3 - Merge function created via {@link twMergeDefaultV3 | `twMergeDefaultV3`}.
+ * @param {ClassesValue} classes - Class values (`string`, `array`, `object`, `etc`).
+ * @returns {string} Merged Tailwind class string.
+ * @example
+ * ```ts
+ * import tailwindConfig from "../tailwind.config";
+ * import { twMergeDefaultV3, customCnV3, type ClassesValue } from "@rzl-zone/utils-js/tailwind";
+ *
+ * // 1. Create a custom merge function
+ * const myCustomTwMerge = twMergeDefaultV3({
+ *   config: tailwindConfig,
+ *   extend: {
+ *     classGroups: {
+ *       "text-shadow": ["text-shadow", "text-shadow-sm", "text-shadow-md"],
+ *     },
+ *   },
+ * });
+ *
+ * // 2. Build your helper using `customCnV3`
+ * export const cnApp = (...classes: ClassesValue) => {
+ *   return customCnV3(myCustomTwMerge, ...classes);
+ * };
+ * // ✅ Usage
+ * cnApp("p-2", "p-4");             // ➔ "p-4"
+ * cnApp("shadow-sm shadow-md");    // ➔ "shadow-md"
+ * cnApp("text-base text-xxs");     // ➔ "text-xxs" (resolved from config)
+ * ```
+ */
+declare const customCnV3:(customTwMergeV3:TwMergeDefaultFnV3,...classes:ClassesValue)=>string;
+/** -------------------------------------------------------------
+ * * ***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.
+ * @param {TwMergeDefaultFnV4} customTwMergeV4 - Merge function created via {@link twMergeDefaultV4 | `twMergeDefaultV4`}.
+ * @param {ClassesValue} classes - Class values (`string`, `array`, `object`, `etc`).
+ * @returns {string} Merged Tailwind class string.
+ * @example
+ * ```ts
+ * import tailwindConfig from "../tailwind.config";
+ * import { twMergeDefaultV4, customCnV4, type ClassesValue } from "@rzl-zone/utils-js/tailwind";
+ *
+ * // 1. Create a custom merge function
+ * const myCustomTwMerge = twMergeDefaultV4({
+ *   config: tailwindConfig,
+ *   extend: {
+ *     classGroups: {
+ *       "text-shadow": ["text-shadow", "text-shadow-sm", "text-shadow-md"],
+ *     },
+ *   },
+ * });
+ *
+ * // 2. Build your helper using `customCnV4`
+ * export const cnApp = (...classes: ClassesValue) => {
+ *   return customCnV4(myCustomTwMerge, ...classes);
+ * };
+ *
+ * // ✅ Usage
+ * cnApp("p-2", "p-4");             // ➔ "p-4"
+ * cnApp("shadow-sm shadow-md");    // ➔ "shadow-md"
+ * cnApp("text-base text-xxs");     // ➔ "text-xxs" (resolved from config)
+ * ```
+ */
+declare const customCnV4:(customTwMergeV4:TwMergeDefaultFnV4,...classes:ClassesValue)=>string;
+/** Converts a union type into an intersection type.
+ *
+ * @template U - The union type to be converted.
+ */
+type UnionToIntersectionStrict<U>=(U extends never?never:(arg:U)=>never)extends(arg:infer I)=>void?I:never;
+/** Converts a union type into a tuple type.
+ *
+ * @template T - The union type to be converted.
+ */
+type UnionToTupleStrict<T>=UnionToIntersectionStrict<T extends never?never:(t:T)=>T>extends(_:never)=>infer W?[...UnionToTupleStrict<Exclude<T,W>>,W]:[];
+/** ----------------------------------------------------------
+ * * ***Utility: `shouldForwardProp`.***
+ * ----------------------------------------------------------
+ * **Creates a helper for styled-components `shouldForwardProp`.**
+ * @description
+ * This utility returns a predicate function that determines whether a given prop
+ * should be forwarded to the DOM, useful for filtering out internal props (e.g.,
+ * `$size`, `$active`) so they don't end up as invalid HTML attributes.
+ * - **Behavior:**
+ *    - Accepts a tuple (strict) of prop keys to exclude from forwarding.
+ *    - Automatically coerces prop names to string for consistent checking.
+ *    - Supports string, number, or symbol keys (via PropertyKey).
+ *    - Will throw an error if the provided `props` argument is not an array.
+ * @template CustomProps - The type of the component's props.
+ * @param {UnionToTupleStrict<keyof CustomProps>} props
+ *   The list of prop names (keys of `CustomProps`) to exclude from forwarding.
+ * @returns {(propName: PropertyKey) => boolean}
+ *   A function that takes a prop name and returns `true` if it should be forwarded, `false` if it should be blocked.
+ * @throws {TypeError} If `props` is not an array.
+ * @example
+ * type Props = { $size: string; color: string; visible: boolean };
+ * const filter = shouldForwardProp<Props>(["$size"]);
+ * filter("$size"); // ➔ false (blocked)
+ * filter("color"); // ➔ true (forwarded)
+ * @example
+ * // Using with styled-components:
+ * styled.div.withConfig({
+ *   shouldForwardProp: shouldForwardProp<CustomProps>(["$internal"])
+ * })
+ */
+declare const shouldForwardProp:<CustomProps>(props:Partial<UnionToTupleStrict<keyof CustomProps>>)=>((propName:keyof CustomProps)=>boolean);
+/** -------------------------------------------------------------
+ * * ***Customized Tailwind class merger Version 3 with extended rules.***
+ * -------------------------------------------------------------
+ * **Wraps **{@link extendTailwindMerge| `extendTailwindMerge`}** with Tailwind’s default config
+ * ({@link getDefaultConfig | `getDefaultConfig()`}) to create a **project-ready `twMerge`**.**
+ * - 🔑 **When to use it?**
+ *    - Your project uses **Tailwind v3**.
+ *    - Extend **class groups** (e.g. add `text-shadow`).
+ *    - 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`.
+ * @param {OptionsMergeTwClsV3} [options={}]
+ *  Merge options:
+ *    - `config` – Your Tailwind config (from `tailwind.config.ts`).
+ *    - `prefix` - Utility prefix (e.g. `tw-` or `tw`).
+ *    - `extend` – Extra merge rules (classGroups, theme, etc).
+ *    - `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
+ * import { twMergeDefaultV3 } from "@rzl-zone/utils-js/tailwind";
+ *
+ * const twMerge = twMergeDefaultV3();
+ * twMerge("p-2 p-4");
+ * // ➔ "p-4"
+ * ```
+ * #### Example 2: ***Extend class groups.***
+ * ```ts
+ * import { twMergeDefaultV3 } from "@rzl-zone/utils-js/tailwind";
+ *
+ * const twMerge2 = twMergeDefaultV3({
+ *   extend: {
+ *     classGroups: {
+ *       shadow: ["shadow-soft", "shadow-hard"],
+ *     },
+ *   },
+ * });
+ * twMerge2("shadow-soft shadow-hard");
+ * // ➔ "shadow-hard"
+ * ```
+ * #### Example 3: ***Respect your Tailwind config.***
+ * ```ts
+ * import config from "../tailwind.config";
+ * import { twMergeDefaultV3 } from "@rzl-zone/utils-js/tailwind";
+ *
+ * const twMerge3 = twMergeDefaultV3({ config });
+ * twMerge3("text-base text-xxs");
+ * // ➔ "text-xxs" (resolved from config)
+ * ```
+ * #### Example 4: ***Project-wide helper (recommended).***
+ * ```ts
+ * import configTwCss from "../tailwind.config";
+ * import { customCnV3, twMergeDefaultV3, type ClassesValue } from "@rzl-zone/utils-js/tailwind";
+ *
+ * const customTwMerge = twMergeDefaultV3({
+ *   config: configTwCss,
+ *   extend: {
+ *     classGroups: { shadow: ["shadow-soft", "shadow-hard"] },
+ *   },
+ * });
+ *
+ * export const cnApp = (...classes: ClassesValue) => {
+ *   return customCnV3(customTwMerge, ...classes);
+ * };
+ *
+ * // ✅ Usage
+ * cnApp("p-2 p-4");                 // ➔ "p-4"
+ * cnApp("shadow-soft shadow-hard"); // ➔ "shadow-hard"
+ * cnApp("text-base text-xxs");      // ➔ "text-xxs" (uses config)
+ *
+ * // ⚡ Difference with package-level `cn`
+ * import { cnV3, cnV4 } from "@rzl-zone/utils-js/tailwind";
+ *
+ * cnV3("text-base text-xxs");
+ * // or
+ * cnV4("text-base text-xxs");
+ * // ➔ "text-base"  (❌ doesn't know about your config)
+ *
+ * cnApp("text-base text-xxs");
+ * // ➔ "text-xxs"  (✅ respects config)
+ * ```
+ */
+declare const twMergeDefaultV3:(options?:OptionsMergeTwClsV3)=>TwMergeDefaultFnV3;
+/** -------------------------------------------------------------
+ * * ***Customized Tailwind class merger Version 4 with extended rules.***
+ * -------------------------------------------------------------
+ * **Wraps **{@link extendTailwindMerge| `extendTailwindMerge`}** with Tailwind’s default config
+ * ({@link getDefaultConfig | `getDefaultConfig()`}) to create a **project-ready `twMerge`**.**
+ * - 🔑 **When to use it?**
+ *    - Your project uses **Tailwind v4**.
+ *    - Extend **class groups** (e.g. add `text-shadow`).
+ *    - 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`.
+ * @param {OptionsMergeTwClsV4} [options={}]
+ *  Merge options:
+ *    - `config` – Your Tailwind config (from `tailwind.config.ts`).
+ *    - `prefix` - Utility prefix (e.g. `tw-` or `tw`).
+ *    - `extend` – Extra merge rules (classGroups, theme, etc).
+ *    - `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
+ * import { twMergeDefaultV4 } from "@rzl-zone/utils-js/tailwind";
+ *
+ * const twMerge = twMergeDefaultV4();
+ * twMerge("p-2 p-4");
+ * // ➔ "p-4"
+ * ```
+ * #### Example 2: ***Extend class groups.***
+ * ```ts
+ * import { twMergeDefaultV4 } from "@rzl-zone/utils-js/tailwind";
+ *
+ * const twMerge2 = twMergeDefaultV4({
+ *   extend: {
+ *     classGroups: {
+ *       shadow: ["shadow-soft", "shadow-hard"],
+ *     },
+ *   },
+ * });
+ * twMerge2("shadow-soft shadow-hard");
+ * // ➔ "shadow-hard"
+ * ```
+ * #### Example 3: ***Respect your Tailwind config.***
+ * ```ts
+ * import config from "../tailwind.config";
+ * import { twMergeDefaultV4 } from "@rzl-zone/utils-js/tailwind";
+ *
+ * const twMerge3 = twMergeDefaultV4({ config });
+ * twMerge3("text-base text-xxs");
+ * // ➔ "text-xxs" (resolved from config)
+ * ```
+ * #### Example 4: ***Project-wide helper (recommended).***
+ * ```ts
+ * import configTwCss from "../tailwind.config";
+ * import { customCnV4, twMergeDefaultV4, type ClassesValue } from "@rzl-zone/utils-js/tailwind";
+ *
+ * const customTwMerge = twMergeDefaultV4({
+ *   config: configTwCss,
+ *   extend: {
+ *     classGroups: { shadow: ["shadow-soft", "shadow-hard"] },
+ *   },
+ * });
+ *
+ * export const cnApp = (...classes: ClassesValue) => {
+ *   return customCnV4(customTwMerge, ...classes);
+ * };
+ *
+ * // ✅ Usage
+ * cnApp("p-2 p-4");                 // ➔ "p-4"
+ * cnApp("shadow-soft shadow-hard"); // ➔ "shadow-hard"
+ * cnApp("text-base text-xxs");      // ➔ "text-xxs" (uses config)
+ *
+ * // ⚡ Difference with package-level `cn`
+ * import { cnV3, cnV4 } from "@rzl-zone/utils-js/tailwind";
+ *
+ * cnV3("text-base text-xxs");
+ * // or
+ * cnV4("text-base text-xxs");
+ * // ➔ "text-base"  (❌ doesn't know about your config)
+ *
+ * cnApp("text-base text-xxs");
+ * // ➔ "text-xxs"  (✅ respects config)
+ * ```
+ */
+declare const twMergeDefaultV4:(options?:OptionsMergeTwClsV4)=>TwMergeDefaultFnV4;export{type ClassesValue,cnV3,cnV4,customCnV3,customCnV4,shouldForwardProp,twMergeDefaultV3,twMergeDefaultV4};

package/dist/tailwind/index.js

@@ -0,0 +1 @@
+export{cnV3,cnV4,customCnV3,customCnV4,shouldForwardProp,twMergeDefaultV3,twMergeDefaultV4}from"../chunk-CPLBRGST.js";import"../chunk-ZXIWDFEQ.js";import"../chunk-2UIRWYE3.js";