@rzl-zone/utils-js 3.5.4 → 3.5.6

package/dist/tailwind/index.d.ts

@@ -2,12 +2,12 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.5.4.
+ * Version: 3.5.6.
  * 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';type ClassesValue=ClassValue[];
+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[];
 /** -------------------------------------------------------------
  * * ***Default `cnV3` utility (Tailwind v3).***
  * -------------------------------------------------------------
@@ -361,49 +361,60 @@ declare const customCnV3:(customTwMergeV3:TwMergeDefaultFnV3,...classes:ClassesV
  * ```
  */
 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.
+ * 1. Returns a **predicate function** that determines whether a given prop
+ * should be forwarded to the DOM.
+ * 2. Useful for filtering out internal props (e.g., `$size`, `$active`)
+ * so they don't become 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
+ *    - Accepts a strict tuple of **string keys** to exclude from forwarding.
+ *    - Every key is validated as a **non-empty string** at runtime.
+ *    - Throws a `TypeError` if:
+ *      - `props` is not an array, or
+ *      - any item is not a non-empty string.
+ *    - Automatically coerces the tested prop name to string for matching.
+ *
+ * @template CustomProps
+ *   The component props type to validate against.
+ *
+ * @param {readonly Stringify<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.
+ *
+ * @returns {(propName: keyof CustomProps | ({} & string)) => boolean}
+ *   A function that receives a prop name and returns:
+ *   - `true`  ➔ the prop **will** be forwarded to the DOM.
+ *   - `false` ➔ the prop **will not** be forwarded.
+ *
+ * @throws {TypeError}
+ *   Thrown when:
+ *   - `props` is not an array, or
+ *   - any item is not a non-empty string.
+ *
  * @example
+ * // Basic usage
  * type Props = { $size: string; color: string; visible: boolean };
  * const filter = shouldForwardProp<Props>(["$size"]);
- * filter("$size"); // ➔ false (blocked)
- * filter("color"); // ➔ true (forwarded)
+ *
+ * filter("$size");   // ➔ false (blocked).
+ * filter("color");   // ➔ true  (forwarded).
+ * filter("visible"); // ➔ true  (forwarded).
+ *
  * @example
- * // Using with styled-components:
+ * // With styled-components
+ * type CustomProps = { $internal: boolean; public: string; another: boolean };
+ *
  * styled.div.withConfig({
  *   shouldForwardProp: shouldForwardProp<CustomProps>(["$internal"])
- * })
+ * });
  */
-declare const shouldForwardProp:<CustomProps>(props:Partial<UnionToTupleStrict<keyof CustomProps>>)=>((propName:keyof CustomProps)=>boolean);
+declare const shouldForwardProp:<CustomProps extends Record<string,unknown>>(props:readonly Stringify<keyof CustomProps>[])=>((propName:keyof CustomProps|({}& string))=>boolean);
 /** -------------------------------------------------------------
  * * ***Customized Tailwind class merger Version 3 with extended rules.***
  * -------------------------------------------------------------

package/dist/tailwind/index.js

@@ -2,11 +2,12 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.5.4.
+ * Version: 3.5.6.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-export { cnV3, cnV4, customCnV3, customCnV4, shouldForwardProp, twMergeDefaultV3, twMergeDefaultV4 } from '../chunk-2RZGZEE2.js';
+export { cnV3, cnV4, customCnV3, customCnV4, shouldForwardProp, twMergeDefaultV3, twMergeDefaultV4 } from '../chunk-RS5RBLPB.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.5.4.
+ * Version: 3.5.6.
  * 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.5.4.
+ * Version: 3.5.6.
  * 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.5.4.
+ * Version: 3.5.6.
  * 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.5.4",
+  "version": "3.5.6",
   "sideEffects": false,
   "engineStrict": true,
   "license": "MIT",