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

package/dist/strings/index.cjs

@@ -1 +1 @@
-'use strict';var chunkIW73G523_cjs=require('../chunk-IW73G523.cjs'),chunkMROH35V3_cjs=require('../chunk-MROH35V3.cjs');require('../chunk-UTQUYABU.cjs');var chunkCII6WWLO_cjs=require('../chunk-CII6WWLO.cjs');Object.defineProperty(exports,"getInitialsName",{enumerable:true,get:function(){return chunkIW73G523_cjs.b}});Object.defineProperty(exports,"replaceAt",{enumerable:true,get:function(){return chunkIW73G523_cjs.a}});Object.defineProperty(exports,"normalizeSpaces",{enumerable:true,get:function(){return chunkMROH35V3_cjs.a}});Object.defineProperty(exports,"normalizeString",{enumerable:true,get:function(){return chunkMROH35V3_cjs.b}});Object.defineProperty(exports,"removeSpaces",{enumerable:true,get:function(){return chunkMROH35V3_cjs.c}});Object.defineProperty(exports,"stripHtmlTags",{enumerable:true,get:function(){return chunkMROH35V3_cjs.d}});Object.defineProperty(exports,"capitalizeFirst",{enumerable:true,get:function(){return chunkCII6WWLO_cjs.s}});Object.defineProperty(exports,"capitalizeWords",{enumerable:true,get:function(){return chunkCII6WWLO_cjs.t}});Object.defineProperty(exports,"slugify",{enumerable:true,get:function(){return chunkCII6WWLO_cjs.B}});Object.defineProperty(exports,"toCamelCase",{enumerable:true,get:function(){return chunkCII6WWLO_cjs.u}});Object.defineProperty(exports,"toDotCase",{enumerable:true,get:function(){return chunkCII6WWLO_cjs.A}});Object.defineProperty(exports,"toKebabCase",{enumerable:true,get:function(){return chunkCII6WWLO_cjs.y}});Object.defineProperty(exports,"toLowerCase",{enumerable:true,get:function(){return chunkCII6WWLO_cjs.x}});Object.defineProperty(exports,"toPascalCase",{enumerable:true,get:function(){return chunkCII6WWLO_cjs.w}});Object.defineProperty(exports,"toPascalCaseSpace",{enumerable:true,get:function(){return chunkCII6WWLO_cjs.v}});Object.defineProperty(exports,"toSnakeCase",{enumerable:true,get:function(){return chunkCII6WWLO_cjs.z}});
+"use strict";var e=require("../chunk-XIXA5KDF.cjs"),t=require("../chunk-XC2PYCT4.cjs");require("../chunk-EBMHQW7X.cjs");var r=require("../chunk-INUFZJLX.cjs");Object.defineProperty(exports,"getInitialsName",{enumerable:!0,get:function(){return e.getInitialsName}}),Object.defineProperty(exports,"replaceAt",{enumerable:!0,get:function(){return e.replaceAt}}),Object.defineProperty(exports,"normalizeSpaces",{enumerable:!0,get:function(){return t.normalizeSpaces}}),Object.defineProperty(exports,"normalizeString",{enumerable:!0,get:function(){return t.normalizeString}}),Object.defineProperty(exports,"removeSpaces",{enumerable:!0,get:function(){return t.removeSpaces}}),Object.defineProperty(exports,"stripHtmlTags",{enumerable:!0,get:function(){return t.stripHtmlTags}}),Object.defineProperty(exports,"capitalizeFirst",{enumerable:!0,get:function(){return r.capitalizeFirst}}),Object.defineProperty(exports,"capitalizeWords",{enumerable:!0,get:function(){return r.capitalizeWords}}),Object.defineProperty(exports,"slugify",{enumerable:!0,get:function(){return r.slugify}}),Object.defineProperty(exports,"toCamelCase",{enumerable:!0,get:function(){return r.toCamelCase}}),Object.defineProperty(exports,"toDotCase",{enumerable:!0,get:function(){return r.toDotCase}}),Object.defineProperty(exports,"toKebabCase",{enumerable:!0,get:function(){return r.toKebabCase}}),Object.defineProperty(exports,"toLowerCase",{enumerable:!0,get:function(){return r.toLowerCase}}),Object.defineProperty(exports,"toPascalCase",{enumerable:!0,get:function(){return r.toPascalCase}}),Object.defineProperty(exports,"toPascalCaseSpace",{enumerable:!0,get:function(){return r.toPascalCaseSpace}}),Object.defineProperty(exports,"toSnakeCase",{enumerable:!0,get:function(){return r.toSnakeCase}});

package/dist/strings/index.js

@@ -1 +1 @@
-export{b as getInitialsName,a as replaceAt}from'../chunk-33ZLH266.js';export{a as normalizeSpaces,b as normalizeString,c as removeSpaces,d as stripHtmlTags}from'../chunk-NR44SNYE.js';import'../chunk-7CHFAMS2.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-EWYPSKKM.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";

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-import{A as And,I as IsStringLiteral,P as ParseNumber,a as IsNegative,N as Negate,b as Abs,c as IsFloat,d as IsUnknown,e as IsNegativeInteger,O as Or,f as OrArr,S as Split,g as AndArr,h as IsInteger,R as Repeat,i as Push,j as IfNegative,k as IsPositive,l as IsEven,m as IsReadonlyArray,n as IfPositive}from'../is-array--YjXV-Wx.js';export{C as CharAt,E as Even,t as EvenDigit,F as Float,u as IfEven,v as IfFloat,w as IfInteger,x as IfNegativeFloat,y as IfNegativeInteger,z as IfOdd,B as IfPositiveFloat,D as IfPositiveInteger,a0 as IfUnknown,G as Integer,o as IsArray,p as IsMutableArray,H as IsNegativeFloat,J as IsOdd,K as IsPositiveFloat,L as IsPositiveInteger,Q as IsScientificNumber,M as Mutable,q as MutableExcept,r as MutableOnly,s as MutableOptions,T as Negative,U as NegativeFloat,V as NegativeInteger,W as Odd,X as OddDigit,Y as ParseScientificNumber,Z as Positive,_ as PositiveFloat,$ as PositiveInteger,a1 as UnknownifyProperties,a2 as UnknownifyPropertiesOptions}from'../is-array--YjXV-Wx.js';import{a as IsEmptyString,b as IfEmptyString,T as Trim,A as AnyString}from'../string-XA-til3C.js';export{E as EmptyString,d as IfNonEmptyString,I as IfNot,e as IsNonEmptyString,N as NonEmptyString,f as TrimLeft,g as TrimRight,h as TrimsLower,i as TrimsUpper,W as Whitespace,c as WordSeparator}from'../string-XA-til3C.js';import{I as IsAny}from'../any-BmdI8UbK.js';export{A as AnifyProperties,a as AnifyPropertiesOptions,b as IfAny}from'../any-BmdI8UbK.js';import{A as AnyFunction,T as TypedArray}from'../type-data-DDs-u2kq.js';export{a as AnObjectNonArray,B as BoxedPrimitivesTypes,D as DataTypes,b as DeepReplaceType,I as IntlObjects,N as NonPlainObject,W as WebApiObjects}from'../type-data-DDs-u2kq.js';import{I as IfExtends,N as Not,a as NotExtends,b as IsEmptyArray,P as Pop,E as Extends,c as ExtendsArr,d as IfEmptyArray}from'../extends-Bk_SBGdT.js';export{A as Arrayable,e as EmptyArray,G as GetArrayElementType,f as IfNonEmptyArray,i as IfNotExtends,g as IsNonEmptyArray,M as MutableArray,h as NonEmptyArray,j as PopOptions}from'../extends-Bk_SBGdT.js';export{F as FixNeverArrayRecursive,N as NormalizeEmptyArraysRecursive,R as RemoveEmptyArrayElements}from'../arrays-normalize-recursive-CnjYJ9xg.js';import{I as If}from'../if-CvT4R7Kh.js';import{I as IsNever,a as IfNever}from'../never-BfayMBF9.js';export{N as NeverifyProperties,b as NeverifyPropertiesOptions}from'../never-BfayMBF9.js';import{P as Prettify,a as PrettifyOptions,D as DefaultPrettifyOptions}from'../prettify-C4xLcYOP.js';export{I as IsArrayOrTuple,b as IsConstructor,c as IsFunction,d as IsPrimitive,e as IsRealPrimitive,f as Primitive}from'../prettify-C4xLcYOP.js';import{N as NonUndefined}from'../nils-DMz3kU7M.js';export{K as KeepNil,a as KeepNull,b as KeepUndef,c as Nilable,d as NonNil,e as NonNull,g as NullToUndefined,f as Nullable,h as Nullish,U as Undefinedable}from'../nils-DMz3kU7M.js';export{N as NumberRangeUnion}from'../NumberRangeUnion-DC-C3_Kq.js';import{O as OmitStrict}from'../omit-VvmIsZmX.js';type _AreAnagrams<Str1 extends string,Str2 extends string>=IsEmptyString<Str1>extends true?IsEmptyString<Str2>extends true?true:false:Str1 extends`${infer First extends string}${infer Rest1 extends string}`?Str2 extends`${infer Prev extends string}${First}${infer Rest2 extends string}`?_AreAnagrams<Rest1,`${Prev}${Rest2}`>:false:never;
+import{A as And,b as Or,O as OrArr,a as AndArr}from'../or-DyZCRvaU.js';import{I as IsStringLiteral,P as ParseNumber,a as IsNegative,N as Negate,A as Abs,b as IsFloat,c as IsUnknown,d as IsNegativeInteger,S as Split,e as IsInteger,R as Repeat,f as Push,g as IfNegative,h as IsPositive,i as IsEven,j as IsReadonlyArray,k as IfPositive}from'../is-array-Cymwrsmm.js';export{C as CharAt,E as Even,q as EvenDigit,F as Float,r as IfEven,s as IfFloat,t as IfInteger,u as IfNegativeFloat,v as IfNegativeInteger,w as IfOdd,x as IfPositiveFloat,y as IfPositiveInteger,Y as IfUnknown,z as Integer,l as IsArray,m as IsMutableArray,B as IsNegativeFloat,D as IsOdd,G as IsPositiveFloat,H as IsPositiveInteger,J as IsScientificNumber,M as Mutable,n as MutableExcept,o as MutableOnly,p as MutableOptions,K as Negative,L as NegativeFloat,O as NegativeInteger,Q as Odd,T as OddDigit,U as ParseScientificNumber,V as Positive,W as PositiveFloat,X as PositiveInteger,Z as UnknownifyProperties,_ as UnknownifyPropertiesOptions}from'../is-array-Cymwrsmm.js';import{a as IsEmptyString,b as IfEmptyString,T as Trim,A as AnyString}from'../string-XA-til3C.js';export{E as EmptyString,d as IfNonEmptyString,I as IfNot,e as IsNonEmptyString,N as NonEmptyString,f as TrimLeft,g as TrimRight,h as TrimsLower,i as TrimsUpper,W as Whitespace,c as WordSeparator}from'../string-XA-til3C.js';import{I as IsAny}from'../any-BmdI8UbK.js';export{A as AnifyProperties,a as AnifyPropertiesOptions,b as IfAny}from'../any-BmdI8UbK.js';import{A as AnyFunction,T as TypedArray}from'../type-data-DDs-u2kq.js';export{a as AnObjectNonArray,B as BoxedPrimitivesTypes,D as DataTypes,b as DeepReplaceType,I as IntlObjects,N as NonPlainObject,W as WebApiObjects}from'../type-data-DDs-u2kq.js';import{I as IfExtends,N as Not,a as NotExtends,b as IsEmptyArray,P as Pop,E as Extends,c as ExtendsArr,d as IfEmptyArray}from'../extends-Bk_SBGdT.js';export{A as Arrayable,e as EmptyArray,G as GetArrayElementType,f as IfNonEmptyArray,i as IfNotExtends,g as IsNonEmptyArray,M as MutableArray,h as NonEmptyArray,j as PopOptions}from'../extends-Bk_SBGdT.js';export{F as FixNeverArrayRecursive,N as NormalizeEmptyArraysRecursive,R as RemoveEmptyArrayElements}from'../arrays-normalize-recursive-CnjYJ9xg.js';import{I as If}from'../if-CvT4R7Kh.js';import{I as IsNever,a as IfNever}from'../never-BfayMBF9.js';export{N as NeverifyProperties,b as NeverifyPropertiesOptions}from'../never-BfayMBF9.js';import{P as Prettify,a as PrettifyOptions,D as DefaultPrettifyOptions}from'../prettify-C4xLcYOP.js';export{I as IsArrayOrTuple,b as IsConstructor,c as IsFunction,d as IsPrimitive,e as IsRealPrimitive,f as Primitive}from'../prettify-C4xLcYOP.js';import{N as NonUndefined}from'../nils-DMz3kU7M.js';export{K as KeepNil,a as KeepNull,b as KeepUndef,c as Nilable,d as NonNil,e as NonNull,g as NullToUndefined,f as Nullable,h as Nullish,U as Undefinedable}from'../nils-DMz3kU7M.js';export{N as NumberRangeUnion}from'../NumberRangeUnion-DC-C3_Kq.js';import{O as OmitStrict}from'../omit-VvmIsZmX.js';type _AreAnagrams<Str1 extends string,Str2 extends string>=IsEmptyString<Str1>extends true?IsEmptyString<Str2>extends true?true:false:Str1 extends`${infer First extends string}${infer Rest1 extends string}`?Str2 extends`${infer Prev extends string}${First}${infer Rest2 extends string}`?_AreAnagrams<Rest1,`${Prev}${Rest2}`>:false:never;
 /** -------------------------------------------------------
  * * ***AreAnagrams.***
  * -------------------------------------------------------

package/dist/urls/index.cjs

@@ -1 +1 @@
-'use strict';var chunk7TC6DE3J_cjs=require('../chunk-7TC6DE3J.cjs');require('../chunk-FIEZKTAZ.cjs'),require('../chunk-XGZ6K753.cjs'),require('../chunk-ZQOLZE6Z.cjs'),require('../chunk-G7R5XZRM.cjs'),require('../chunk-UQDJF5RR.cjs'),require('../chunk-Q3NTKN5I.cjs');var chunkOZCQZO2V_cjs=require('../chunk-OZCQZO2V.cjs');require('../chunk-MROH35V3.cjs'),require('../chunk-UTQUYABU.cjs'),require('../chunk-PUQXRLZH.cjs'),require('../chunk-26W3VZIK.cjs'),require('../chunk-7YWAQOA4.cjs'),require('../chunk-CII6WWLO.cjs');Object.defineProperty(exports,"constructURL",{enumerable:true,get:function(){return chunk7TC6DE3J_cjs.a}});Object.defineProperty(exports,"extractURLs",{enumerable:true,get:function(){return chunk7TC6DE3J_cjs.b}});Object.defineProperty(exports,"formatEnvPort",{enumerable:true,get:function(){return chunkOZCQZO2V_cjs.d}});Object.defineProperty(exports,"getFirstPrefixPathname",{enumerable:true,get:function(){return chunkOZCQZO2V_cjs.b}});Object.defineProperty(exports,"getPrefixPathname",{enumerable:true,get:function(){return chunkOZCQZO2V_cjs.a}});Object.defineProperty(exports,"normalizePathname",{enumerable:true,get:function(){return chunkOZCQZO2V_cjs.c}});
+"use strict";var e=require("../chunk-NHNBV5VS.cjs");require("../chunk-KHO2SBNA.cjs"),require("../chunk-7PG6YKIY.cjs"),require("../chunk-EXWCTDC3.cjs"),require("../chunk-4VCRMMAH.cjs"),require("../chunk-YT3MSZKK.cjs"),require("../chunk-YZR5OGJA.cjs");var r=require("../chunk-WZE3XLKY.cjs");require("../chunk-XC2PYCT4.cjs"),require("../chunk-EBMHQW7X.cjs"),require("../chunk-DVMHRLKP.cjs"),require("../chunk-DQFU3KLE.cjs"),require("../chunk-UDA26MCU.cjs"),require("../chunk-INUFZJLX.cjs"),Object.defineProperty(exports,"constructURL",{enumerable:!0,get:function(){return e.constructURL}}),Object.defineProperty(exports,"extractURLs",{enumerable:!0,get:function(){return e.extractURLs}}),Object.defineProperty(exports,"formatEnvPort",{enumerable:!0,get:function(){return r.formatEnvPort}}),Object.defineProperty(exports,"getFirstPrefixPathname",{enumerable:!0,get:function(){return r.getFirstPrefixPathname}}),Object.defineProperty(exports,"getPrefixPathname",{enumerable:!0,get:function(){return r.getPrefixPathname}}),Object.defineProperty(exports,"normalizePathname",{enumerable:!0,get:function(){return r.normalizePathname}});

package/dist/urls/index.js

@@ -1 +1 @@
-export{a as constructURL,b as extractURLs}from'../chunk-SGTHOQQ2.js';import'../chunk-NNM7QCNB.js';import'../chunk-W32WALNU.js';import'../chunk-7MMJZ6HS.js';import'../chunk-LQ76EDZG.js';import'../chunk-SL3RQOWA.js';import'../chunk-ESJYBIYH.js';export{d as formatEnvPort,b as getFirstPrefixPathname,a as getPrefixPathname,c as normalizePathname}from'../chunk-QDNSC57Z.js';import'../chunk-NR44SNYE.js';import'../chunk-7CHFAMS2.js';import'../chunk-ELDDNERR.js';import'../chunk-J4NCYYGS.js';import'../chunk-5SZUSNGZ.js';import'../chunk-EWYPSKKM.js';
+export{constructURL,extractURLs}from"../chunk-AXWJJXJC.js";import"../chunk-ONZFBJVW.js";import"../chunk-Y44ZD3GG.js";import"../chunk-X4PD3I5U.js";import"../chunk-GRSCNTOK.js";import"../chunk-ZXIWDFEQ.js";import"../chunk-DUK2K4FB.js";export{formatEnvPort,getFirstPrefixPathname,getPrefixPathname,normalizePathname}from"../chunk-SAW7XS4K.js";import"../chunk-Q6NHYWVX.js";import"../chunk-TSLYDPBJ.js";import"../chunk-WVSPXFTY.js";import"../chunk-L73TOPX5.js";import"../chunk-QNKGP5DY.js";import"../chunk-2UIRWYE3.js";