@rzl-zone/utils-js 3.6.0 → 3.7.0

package/dist/strings/index.js

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.6.0.
+ * Version: 3.7.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/tailwind/index.cjs

@@ -2,43 +2,47 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.6.0.
+ * Version: 3.7.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunkTPYENEQ4_cjs = require('../chunk-TPYENEQ4.cjs');
+var chunkKIYALQQF_cjs = require('../chunk-KIYALQQF.cjs');
 require('../chunk-NREACG6M.cjs');
 require('../chunk-7WBMA2VE.cjs');
 require('../chunk-F3WBQKRI.cjs');
 
 Object.defineProperty(exports, "cnV3", {
   enumerable: true,
-  get: function () { return chunkTPYENEQ4_cjs.cnV3; }
+  get: function () { return chunkKIYALQQF_cjs.cnV3; }
 });
 Object.defineProperty(exports, "cnV4", {
   enumerable: true,
-  get: function () { return chunkTPYENEQ4_cjs.cnV4; }
+  get: function () { return chunkKIYALQQF_cjs.cnV4; }
 });
 Object.defineProperty(exports, "customCnV3", {
   enumerable: true,
-  get: function () { return chunkTPYENEQ4_cjs.customCnV3; }
+  get: function () { return chunkKIYALQQF_cjs.customCnV3; }
 });
 Object.defineProperty(exports, "customCnV4", {
   enumerable: true,
-  get: function () { return chunkTPYENEQ4_cjs.customCnV4; }
+  get: function () { return chunkKIYALQQF_cjs.customCnV4; }
+});
+Object.defineProperty(exports, "cx", {
+  enumerable: true,
+  get: function () { return chunkKIYALQQF_cjs.cx; }
 });
 Object.defineProperty(exports, "shouldForwardProp", {
   enumerable: true,
-  get: function () { return chunkTPYENEQ4_cjs.shouldForwardProp; }
+  get: function () { return chunkKIYALQQF_cjs.shouldForwardProp; }
 });
 Object.defineProperty(exports, "twMergeDefaultV3", {
   enumerable: true,
-  get: function () { return chunkTPYENEQ4_cjs.twMergeDefaultV3; }
+  get: function () { return chunkKIYALQQF_cjs.twMergeDefaultV3; }
 });
 Object.defineProperty(exports, "twMergeDefaultV4", {
   enumerable: true,
-  get: function () { return chunkTPYENEQ4_cjs.twMergeDefaultV4; }
+  get: function () { return chunkKIYALQQF_cjs.twMergeDefaultV4; }
 });

package/dist/tailwind/index.d.ts

@@ -2,12 +2,117 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.6.0.
+ * Version: 3.7.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-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';import{Stringify}from'@rzl-zone/ts-types-plus';type ClassesValue=ClassValue[];
+import{Config}from'tailwindcss';import{ClassNameValue as ClassNameValue$1,ConfigExtension as ConfigExtension$1}from'tailwind-merge-v3';import{ClassNameValue,ConfigExtension}from'tailwind-merge-v4';import{Stringify}from'@rzl-zone/ts-types-plus';
+/** ----------------------------------------------------------
+ * * ***Type-Utility: `ClassValue`.***
+ * ----------------------------------------------------------
+ * **Represents a single valid value that can be converted to a CSS class string.**
+ * @description
+ * - Supports the following types:
+ *    - `string` → literal class names (non-empty only)
+ *    - `number | bigint` → numeric class names
+ *    - `boolean` → only `true` is considered in objects/arrays
+ *    - `null | undefined` → ignored
+ *    - `ClassObject` → objects where **keys with truthy values** are included
+ *    - `ClassValues` → arrays recursively flattened
+ * - Used internally by **{@link cx | `cx`}** to process mixed input values.
+ * @example
+ * ```ts
+ * const val1: ClassValue = "button";              // ➔ string
+ * const val2: ClassValue = 0;                     // ➔ number
+ * const val3: ClassValue = ["a", { b: true }];    // ➔ array with object
+ * const val4: ClassValue = { d: true, e: false }; // ➔ object
+ * const val5: ClassValue = new String("foo");     // ➔ boxed string
+ * const val6: ClassValue = new Number("123");     // ➔ boxed number
+ * const val7: ClassValue = new Boolean("true");   // ➔ boxed boolean
+ * ```
+ */
+type ClassValue=ClassValues|ClassObject|string|number|bigint|null|boolean|undefined;
+/** ----------------------------------------------------------
+ * * ***Type-Utility: `ClassObject`.***
+ * ----------------------------------------------------------
+ * **Represents an object whose keys with truthy values are included in the final class string.**
+ * @example
+ * ```ts
+ * const obj: ClassObject = { "text-red": true, "hidden": false };
+ * // ➔ "text-red" when processed by cx
+ * ```
+ */
+type ClassObject=Record<string,any>;
+/** ----------------------------------------------------------
+ * * ***Type-Utility: `ClassValues`.***
+ * ----------------------------------------------------------
+ * **Represents an array of {@link ClassValue | `ClassValue's`}, potentially nested.**
+ * @example
+ * ```ts
+ * const arr: ClassValues = [
+ *   "a",
+ *   1,
+ *   ["b", { c: true, d: false }],
+ *   { e: 2 }
+ * ];
+ * ```
+ */
+type ClassValues=ClassValue[];
+/** ----------------------------------------------------------
+ * * ***Utility: `cx`.***
+ * ----------------------------------------------------------
+ * **Merge multiple class values into a single, space-separated string suitable for CSS usage.**
+ * @param {ClassValues} args
+ *   A list of mixed class values, which can include:
+ *   - **Strings** → literal class names.
+ *   - **Numbers** → numeric class names.
+ *   - **BigInt** → numeric class names larger than JS safe integer limit.
+ *   - **Arrays** → recursively flattened, can contain nested arrays or objects.
+ *   - **Objects** → include keys whose values are truthy. Inherited keys are also included.
+ *   - **Boxed primitives** (`new String()`, `new Number()`, `new Boolean()`) → automatically unwrapped.
+ *   - **Falsy values** (`false`, `null`, `undefined`, `""`, `0`) are ignored according to original behavior.
+ * @returns {string}
+ *   A single space-separated string containing all valid class names.
+ * @description
+ * - Supports **nested combinations** of arrays and objects, recursively.
+ * - **Falsy values** are skipped:
+ *   - `false`, `null`, `undefined`, empty strings `""` are ignored anywhere.
+ *   - Numbers `0` are ignored inside nested arrays/objects.
+ * - **Boxed primitives** are correctly unwrapped to their primitive value.
+ * - **Inherited object keys** are included in the final class string.
+ * - Optimized for **CSS class merging** where conditional inclusion is common.
+ * @example
+ * ```ts
+ * // Basic string merge
+ * cx("btn", "btn-primary");
+ * // ➔ "btn btn-primary"
+ *
+ * // Mixed arrays and objects
+ * cx("a", ["b", { c: true, d: false }], { e: 1, f: 0 }, null, 2);
+ * // ➔ "a b c e 2"
+ *
+ * // Empty and falsy values are ignored
+ * cx("", null, undefined, false, 0);
+ * // ➔ ""
+ *
+ * // Nested arrays with objects
+ * cx(["a", ["b", { c: true, d: false }]]);
+ * // ➔ "a b c"
+ *
+ * // Boxed primitives are unwrapped
+ * cx(new String("foo"), new Number(42), new Boolean(true), new Number(0), new Boolean(false));
+ * // ➔ "foo 42 true"
+ *
+ * // Inherited keys from objects are included
+ * const proto = { inherited: true };
+ * const obj = Object.create(proto);
+ * obj.own = true;
+ * cx(obj);
+ * // ➔ "own inherited"
+ * ```
+ */
+declare function cx(...args:ClassValues):string;
 /** -------------------------------------------------------------
  * * ***Default `cnV3` utility (Tailwind v3).***
  * -------------------------------------------------------------
@@ -21,7 +126,7 @@ import{ClassValue}from'clsx';import{Config}from'tailwindcss';import{ClassNameVal
  *    - Create a project-wide helper using
  *      {@link twMergeDefaultV3 | `twMergeDefaultV3`} +
  *      {@link customCnV3 | `customCnV3`} (see Example 2).
- * @param {ClassesValue} classes - Class values (`string`, `array`, `object`, `etc`).
+ * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).
  * @returns {string} Merged Tailwind class string.
  * @example
  * #### Example 1: ✅ Default usage (Tailwind v3).
@@ -38,9 +143,9 @@ import{ClassValue}from'clsx';import{Config}from'tailwindcss';import{ClassNameVal
  * #### 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";
+ * import { twMergeDefaultV3, customCnV3, type ClassValues } from "@rzl-zone/utils-js/tailwind";
  *
- * const cnApp = (...classes: ClassesValue) => {
+ * const cnApp = (...classes: ClassValues) => {
  *   return customCnV3(
  *     twMergeDefaultV3({
  *       config: tailwindConfig,
@@ -63,7 +168,7 @@ import{ClassValue}from'clsx';import{Config}from'tailwindcss';import{ClassNameVal
  * cnApp("text-base text-xxs");  // ➔ "text-xxs" (resolved from config)
  * ```
  */
-declare const cnV3:(...classes:ClassesValue)=>string;
+declare const cnV3:(...classes:ClassValues)=>string;
 /** -------------------------------------------------------------
  * * ***Default `cnV4` utility (Tailwind v4).***
  * -------------------------------------------------------------
@@ -77,7 +182,7 @@ declare const cnV3:(...classes:ClassesValue)=>string;
  *    - Create a project-wide helper using
  *      {@link twMergeDefaultV4 | `twMergeDefaultV4`} +
  *      {@link customCnV4 | `customCnV4`} (see Example 2).
- * @param {ClassesValue} classes - Class values (`string`, `array`, `object`, `etc`).
+ * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).
  * @returns {string} Merged Tailwind class string.
  * @example
  * #### Example 1: ✅ Default usage (Tailwind v4).
@@ -94,9 +199,9 @@ declare const cnV3:(...classes:ClassesValue)=>string;
  * #### 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";
+ * import { twMergeDefaultV4, customCnV4, type ClassValues } from "@rzl-zone/utils-js/tailwind";
  *
- * const cnApp = (...classes: ClassesValue) => {
+ * const cnApp = (...classes: ClassValues) => {
  *   return customCnV4(
  *     twMergeDefaultV4({
  *       config: tailwindConfig,
@@ -119,7 +224,7 @@ declare const cnV3:(...classes:ClassesValue)=>string;
  * cnApp("text-base text-xxs");  // ➔ "text-xxs" (resolved from config)
  * ```
  */
-declare const cnV4:(...classes:ClassesValue)=>string;
+declare const cnV4:(...classes:ClassValues)=>string;
 /** Tailwind Merge config extension type */
 type TwMergeConfigExt$1=ConfigExtension<string,string>;
 /** * ***Extra options for customized Tailwind class merge.***  */
@@ -294,12 +399,12 @@ type TwMergeDefaultFnV3=(...classLists:ClassNameValue$1[])=>string;
  *      - 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`).
+ * @param {ClassValues} 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";
+ * import { twMergeDefaultV3, customCnV3, type ClassValues } from "@rzl-zone/utils-js/tailwind";
  *
  * // 1. Create a custom merge function
  * const myCustomTwMerge = twMergeDefaultV3({
@@ -312,7 +417,7 @@ type TwMergeDefaultFnV3=(...classLists:ClassNameValue$1[])=>string;
  * });
  *
  * // 2. Build your helper using `customCnV3`
- * export const cnApp = (...classes: ClassesValue) => {
+ * export const cnApp = (...classes: ClassValues) => {
  *   return customCnV3(myCustomTwMerge, ...classes);
  * };
  * // ✅ Usage
@@ -321,7 +426,7 @@ type TwMergeDefaultFnV3=(...classLists:ClassNameValue$1[])=>string;
  * cnApp("text-base text-xxs");     // ➔ "text-xxs" (resolved from config)
  * ```
  */
-declare const customCnV3:(customTwMergeV3:TwMergeDefaultFnV3,...classes:ClassesValue)=>string;
+declare const customCnV3:(customTwMergeV3:TwMergeDefaultFnV3,...classes:ClassValues)=>string;
 /** -------------------------------------------------------------
  * * ***Factory utility for building a custom `cn` helper (Tailwind `v4`).***
  * -------------------------------------------------------------
@@ -332,12 +437,12 @@ declare const customCnV3:(customTwMergeV3:TwMergeDefaultFnV3,...classes:ClassesV
  *      - 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`).
+ * @param {ClassValues} 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";
+ * import { twMergeDefaultV4, customCnV4, type ClassValues } from "@rzl-zone/utils-js/tailwind";
  *
  * // 1. Create a custom merge function
  * const myCustomTwMerge = twMergeDefaultV4({
@@ -350,7 +455,7 @@ declare const customCnV3:(customTwMergeV3:TwMergeDefaultFnV3,...classes:ClassesV
  * });
  *
  * // 2. Build your helper using `customCnV4`
- * export const cnApp = (...classes: ClassesValue) => {
+ * export const cnApp = (...classes: ClassValues) => {
  *   return customCnV4(myCustomTwMerge, ...classes);
  * };
  *
@@ -360,7 +465,7 @@ declare const customCnV3:(customTwMergeV3:TwMergeDefaultFnV3,...classes:ClassesV
  * cnApp("text-base text-xxs");     // ➔ "text-xxs" (resolved from config)
  * ```
  */
-declare const customCnV4:(customTwMergeV4:TwMergeDefaultFnV4,...classes:ClassesValue)=>string;
+declare const customCnV4:(customTwMergeV4:TwMergeDefaultFnV4,...classes:ClassValues)=>string;
 /** ----------------------------------------------------------
  * * ***Utility: `shouldForwardProp`.***
  * ----------------------------------------------------------
@@ -588,4 +693,4 @@ declare const twMergeDefaultV3:(options?:OptionsMergeTwClsV3)=>TwMergeDefaultFnV
  * // ➔ "text-xxs"  (✅ respects config)
  * ```
  */
-declare const twMergeDefaultV4:(options?:OptionsMergeTwClsV4)=>TwMergeDefaultFnV4;export{type ClassesValue,cnV3,cnV4,customCnV3,customCnV4,shouldForwardProp,twMergeDefaultV3,twMergeDefaultV4};
+declare const twMergeDefaultV4:(options?:OptionsMergeTwClsV4)=>TwMergeDefaultFnV4;export{type ClassObject,type ClassValue,type ClassValues,cnV3,cnV4,customCnV3,customCnV4,cx,shouldForwardProp,twMergeDefaultV3,twMergeDefaultV4};

package/dist/tailwind/index.js

@@ -2,12 +2,12 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.6.0.
+ * Version: 3.7.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-export { cnV3, cnV4, customCnV3, customCnV4, shouldForwardProp, twMergeDefaultV3, twMergeDefaultV4 } from '../chunk-RS5RBLPB.js';
+export { cnV3, cnV4, customCnV3, customCnV4, cx, shouldForwardProp, twMergeDefaultV3, twMergeDefaultV4 } from '../chunk-3LEWQV3R.js';
 import '../chunk-JY4HLZ4W.js';
 import '../chunk-6WMB5AJR.js';
 import '../chunk-3KTD3QDI.js';

package/dist/urls/index.cjs

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.6.0.
+ * Version: 3.7.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/urls/index.d.ts

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.6.0.
+ * Version: 3.7.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/urls/index.js

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.6.0.
+ * Version: 3.7.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rzl-zone/utils-js",
-  "version": "3.6.0",
+  "version": "3.7.0",
   "sideEffects": false,
   "engineStrict": true,
   "license": "MIT",
@@ -19,7 +19,6 @@
   },
   "dependencies": {
     "@rzl-zone/ts-types-plus": "latest",
-    "clsx": "^2.1.1",
     "date-fns": "^4.1.0",
     "libphonenumber-js": "^1.12.17",
     "server-only": "^0.0.1",