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

package/dist/conversions/index.js

@@ -1 +1 @@
-export{f as convertType,g as removeObjectPaths,b as toBooleanContent,c as toBooleanContentDeep,d as toBooleanExplicit,e as toBooleanLoose,a as toNumberArrayUnRecursive,h as toNumberDeep,i as toStringDeep}from'../chunk-G72VSVGO.js';export{b as cleanParsedData,a as extractDigits,c as parseCustomDate,d as safeJsonParse}from'../chunk-MWLEM7ED.js';import'../chunk-RHIBYOFQ.js';export{c as dedupeArray,b as filterNilArray,d as toStringArrayUnRecursive,a as toStringDeepForce}from'../chunk-PSWITZK5.js';import'../chunk-REFMEB4A.js';import'../chunk-ME5OV5HN.js';import'../chunk-2JQQQ625.js';export{a as parseCurrencyString}from'../chunk-K4PLGD7C.js';import'../chunk-GAJTFCUA.js';import'../chunk-SYJC7UAW.js';import'../chunk-Z6FLCEN6.js';import'../chunk-JISH2VGG.js';export{c as safeStableStringify}from'../chunk-467VEMJH.js';import'../chunk-5SZUSNGZ.js';import'../chunk-MJAW5RAK.js';
+export{f as convertType,g as removeObjectPaths,b as toBooleanContent,c as toBooleanContentDeep,d as toBooleanExplicit,e as toBooleanLoose,a as toNumberArrayUnRecursive,h as toNumberDeep,i as toStringDeep}from'../chunk-VPW3DRV5.js';export{b as cleanParsedData,a as extractDigits,c as parseCustomDate,d as safeJsonParse}from'../chunk-EEQY5QUG.js';import'../chunk-J7JAZAJD.js';export{c as dedupeArray,b as filterNilArray,d as toStringArrayUnRecursive,a as toStringDeepForce}from'../chunk-W32WALNU.js';import'../chunk-7MMJZ6HS.js';import'../chunk-LQ76EDZG.js';import'../chunk-SL3RQOWA.js';export{a as parseCurrencyString}from'../chunk-7VX33E3V.js';import'../chunk-ESJYBIYH.js';import'../chunk-SYJC7UAW.js';import'../chunk-7CHFAMS2.js';import'../chunk-NJSAV73S.js';export{c as safeStableStringify}from'../chunk-J4NCYYGS.js';import'../chunk-5SZUSNGZ.js';import'../chunk-EWYPSKKM.js';

package/dist/env/index.d.ts

@@ -1,16 +1,16 @@
 /** ----------------------------------------
-* * ***Utility: `isServer`.***
-* ----------------------------------------
-* **Checks if the current execution environment is at **server-side** (Node.js)
-* or **client-side** (browser).**
-* @returns {boolean}
-* - `true` ➔ running on the **server-side** (Node.js).
-* - `false` ➔ running on the **client-side** (browser).
-* @example
-* if (isServer()) {
-*   console.log("Running on Node.js");
-* } else {
-*   console.log("Running in the browser");
-* }
-*/
+ * * ***Utility: `isServer`.***
+ * ----------------------------------------
+ * **Checks if the current execution environment is at **server-side** (Node.js)
+ * or **client-side** (browser).**
+ * @returns {boolean}
+ * - `true` ➔ running on the **server-side** (Node.js).
+ * - `false` ➔ running on the **client-side** (browser).
+ * @example
+ * if (isServer()) {
+ *   console.log("Running on Node.js");
+ * } else {
+ *   console.log("Running in the browser");
+ * }
+ */
 declare const isServer:()=>boolean;export{isServer};

package/dist/events/index.cjs

@@ -1 +1 @@
-'use strict';var chunkEXXLUO7L_cjs=require('../chunk-EXXLUO7L.cjs');require('../chunk-SW6HYEW7.cjs'),require('../chunk-DYRDBYPF.cjs'),require('../chunk-LVUSFXQS.cjs');Object.defineProperty(exports,"disableUserInteraction",{enumerable:true,get:function(){return chunkEXXLUO7L_cjs.a}});Object.defineProperty(exports,"enableUserInteraction",{enumerable:true,get:function(){return chunkEXXLUO7L_cjs.b}});Object.defineProperty(exports,"removeElementFocus",{enumerable:true,get:function(){return chunkEXXLUO7L_cjs.c}});Object.defineProperty(exports,"scrollToTop",{enumerable:true,get:function(){return chunkEXXLUO7L_cjs.d}});
+'use strict';var chunkGGEV7LXX_cjs=require('../chunk-GGEV7LXX.cjs');require('../chunk-SW6HYEW7.cjs'),require('../chunk-BEZPD44N.cjs'),require('../chunk-CII6WWLO.cjs');Object.defineProperty(exports,"disableUserInteraction",{enumerable:true,get:function(){return chunkGGEV7LXX_cjs.a}});Object.defineProperty(exports,"enableUserInteraction",{enumerable:true,get:function(){return chunkGGEV7LXX_cjs.b}});Object.defineProperty(exports,"removeElementFocus",{enumerable:true,get:function(){return chunkGGEV7LXX_cjs.c}});Object.defineProperty(exports,"scrollToTop",{enumerable:true,get:function(){return chunkGGEV7LXX_cjs.d}});

package/dist/events/index.d.ts

@@ -1,122 +1,122 @@
 type ScrollToTopOptions={
 /** Scroll animation type.
-*
-* - Valid values: `"auto"`, `"instant"`, `"smooth"`.
-* - Default force to `"smooth"` if missing or invalid.
-*
-* @default "smooth"
-*/
+ *
+ * - Valid values: `"auto"`, `"instant"`, `"smooth"`.
+ * - Default force to `"smooth"` if missing or invalid.
+ *
+ * @default "smooth"
+ */
 behavior?:ScrollBehavior|undefined;
 /** Delay before scrolling (in milliseconds).
-*
-* - Default value is `1`.
-* - Valid values: any number `≥` `1`.
-* - Non-integer number are truncated to an integer.
-* - Force to `2147483647` if number is larger than `2147483647`.
-* - Default force to `1` if `missing`, `NaN`, `invalid-type`, or `less-than` `1`.
-*
-* @default 1
-*/
+ *
+ * - Default value is `1`.
+ * - Valid values: any number `≥` `1`.
+ * - Non-integer number are truncated to an integer.
+ * - Force to `2147483647` if number is larger than `2147483647`.
+ * - Default force to `1` if `missing`, `NaN`, `invalid-type`, or `less-than` `1`.
+ *
+ * @default 1
+ */
 timeout?:number|undefined;};
 /** ----------------------------------------------------------
-* * ***Utility: `disableUserInteraction`.***
-* ----------------------------------------------------------
-* **Disables user interaction by adding a CSS class to the `<html>` element.**
-* - **Key points**:
-*    - Works **only in browser environments**.
-*    - Safely adds the specified CSS class to `<html>`.
-*    - Prevents multiple additions of the same class.
-*    - Useful to indicate that a process is ongoing
-*   (e.g., loading or processing state).
-* - **Using custom CSS classes:**
-*    - You can pass any class name that exists in your CSS.
-*    - Example: if you have `.loading` in your styles, passing `"loading"`
-*   will add it and disable interactions accordingly.
-* - **Validation:**
-*    - Throws `TypeError` if the `className` parameter is not a string.
-* @param {string} [className="on_processing"] - The CSS class to add, defaults to `"on_processing"`.
-* @returns {void} Does not return anything.
-* @throws {TypeError} If `className` is not a string.
-* @example
-* disableUserInteraction();          // ➔ Adds "on_processing" class
-* disableUserInteraction("loading"); // ➔ Adds "loading" class
-* // ❌ Invalid value:
-* disableUserInteraction(123);       // ➔ Throws TypeError
-*/
+ * * ***Utility: `disableUserInteraction`.***
+ * ----------------------------------------------------------
+ * **Disables user interaction by adding a CSS class to the `<html>` element.**
+ * - **Key points**:
+ *    - Works **only in browser environments**.
+ *    - Safely adds the specified CSS class to `<html>`.
+ *    - Prevents multiple additions of the same class.
+ *    - Useful to indicate that a process is ongoing
+ *   (e.g., loading or processing state).
+ * - **Using custom CSS classes:**
+ *    - You can pass any class name that exists in your CSS.
+ *    - Example: if you have `.loading` in your styles, passing `"loading"`
+ *   will add it and disable interactions accordingly.
+ * - **Validation:**
+ *    - Throws `TypeError` if the `className` parameter is not a string.
+ * @param {string} [className="on_processing"] - The CSS class to add, defaults to `"on_processing"`.
+ * @returns {void} Does not return anything.
+ * @throws {TypeError} If `className` is not a string.
+ * @example
+ * disableUserInteraction();          // ➔ Adds "on_processing" class
+ * disableUserInteraction("loading"); // ➔ Adds "loading" class
+ * // ❌ Invalid value:
+ * disableUserInteraction(123);       // ➔ Throws TypeError
+ */
 declare const disableUserInteraction:(className?:string)=>void;
 /** ----------------------------------------------------------
-* * ***Utility: `enableUserInteraction`.***
-* ----------------------------------------------------------
-* **Enables user interaction by removing a CSS class from the `<html>` element.**
-* - **Key points**:
-*    - Works **only in browser environments**.
-*    - Safely removes the specified CSS class from `<html>`.
-*    - Does nothing if the class is not present.
-*    - Useful to re-enable user interactions after a process
-*   (e.g., loading or processing) completes.
-* - **Using custom CSS classes:**
-*    - You can pass any class name that exists in your CSS.
-*    - Example: if you have `.loading` in your styles, passing `"loading"`
-*   will remove it and re-enable interactions.
-* - **Validation:**
-*    - Throws `TypeError` if the `className` parameter is not a string.
-* @param {string} [className="on_processing"] - The CSS class to remove, defaults to `"on_processing"`.
-* @returns {void} Does not return anything.
-* @throws {TypeError} If `className` is not a string.
-* @example
-* enableUserInteraction();          // ➔ Removes "on_processing" class
-* enableUserInteraction("loading"); // ➔ Removes "loading" class
-* // ❌ Invalid value:
-* enableUserInteraction(123);       // ➔ Throws TypeError
-*/
+ * * ***Utility: `enableUserInteraction`.***
+ * ----------------------------------------------------------
+ * **Enables user interaction by removing a CSS class from the `<html>` element.**
+ * - **Key points**:
+ *    - Works **only in browser environments**.
+ *    - Safely removes the specified CSS class from `<html>`.
+ *    - Does nothing if the class is not present.
+ *    - Useful to re-enable user interactions after a process
+ *   (e.g., loading or processing) completes.
+ * - **Using custom CSS classes:**
+ *    - You can pass any class name that exists in your CSS.
+ *    - Example: if you have `.loading` in your styles, passing `"loading"`
+ *   will remove it and re-enable interactions.
+ * - **Validation:**
+ *    - Throws `TypeError` if the `className` parameter is not a string.
+ * @param {string} [className="on_processing"] - The CSS class to remove, defaults to `"on_processing"`.
+ * @returns {void} Does not return anything.
+ * @throws {TypeError} If `className` is not a string.
+ * @example
+ * enableUserInteraction();          // ➔ Removes "on_processing" class
+ * enableUserInteraction("loading"); // ➔ Removes "loading" class
+ * // ❌ Invalid value:
+ * enableUserInteraction(123);       // ➔ Throws TypeError
+ */
 declare const enableUserInteraction:(className?:string)=>void;
 /** ----------------------------------------------------------
-* * ***Utility: `removeElementFocus`.***
-* ----------------------------------------------------------
-* **Removes focus from the currently active element in the document.**
-* - **Features**:
-*    - This function works **only in browser environments**.
-*    - If an element is focused, it will lose focus by calling `blur()`.
-*    - If no element is focused or the active element is not an `HTMLElement`, nothing happens.
-* @returns {void} Does not return anything.
-* @example
-* removeElementFocus(); // ➔ Removes focus from the currently active element
-*/
+ * * ***Utility: `removeElementFocus`.***
+ * ----------------------------------------------------------
+ * **Removes focus from the currently active element in the document.**
+ * - **Features**:
+ *    - This function works **only in browser environments**.
+ *    - If an element is focused, it will lose focus by calling `blur()`.
+ *    - If no element is focused or the active element is not an `HTMLElement`, nothing happens.
+ * @returns {void} Does not return anything.
+ * @example
+ * removeElementFocus(); // ➔ Removes focus from the currently active element
+ */
 declare const removeElementFocus:()=>void;
 /** ----------------------------------------------------------
-* * ***Utility: `scrollToTop`.***
-* ----------------------------------------------------------
-* **Scrolls the page to the top with optional smooth animation and delay.**
-* - **Features**:
-*    - This function works **only in browser environments** (no effect on server-side).
-*    - It leverages the native `window.scrollTo()` API with support for smooth scrolling
-* and an optional timeout delay before executing the scroll.
-* - Each option has strict valid values.
-*    - If an invalid value is provided, the function **automatically falls back to its default**.
-* @param {ScrollToTopOptions} [options] - Optional settings for scroll behavior.
-* @param {ScrollToTopOptions["behavior"]} [options.behavior="smooth"] - Scroll animation type.
-*   - Valid values: `"auto"`, `"instant"`, `"smooth"`.
-*   - Default force to `"smooth"` if missing or invalid.
-* @param {ScrollToTopOptions["timeout"]} [options.timeout=1] - Delay before scrolling (in milliseconds).
-*   - Default value is `1`.
-*   - Valid values: any number `≥` `1`.
-*   - Non-integer number are truncated to an integer.
-*   - Force to `2147483647` if number is larger than `2147483647`.
-*   - Default force to `1` if `missing`, `NaN`, `invalid`, or `less-than` `1`.
-* @returns {void} Does not return anything, only scrolling to top.
-* @example
-* // ✅ Valid options value:
-* scrollToTop();
-* // ➔ Scroll smoothly to the top after 1ms delay
-* scrollToTop({ behavior: "instant" });
-* // ➔ Jump instantly to the top
-* scrollToTop({ timeout: 500 });
-* // ➔ Scroll smoothly to the top after 500ms
-*
-* // ❌ Invalid options value:
-* scrollToTop({ behavior: "fly", timeout: -100 });
-* // ➔ Fallback: behavior="smooth", timeout=1
-* scrollToTop({ behavior: "fly", timeout: 123.55 });
-* // ➔ Fallback: behavior="smooth", timeout=123
-*/
+ * * ***Utility: `scrollToTop`.***
+ * ----------------------------------------------------------
+ * **Scrolls the page to the top with optional smooth animation and delay.**
+ * - **Features**:
+ *    - This function works **only in browser environments** (no effect on server-side).
+ *    - It leverages the native `window.scrollTo()` API with support for smooth scrolling
+ * and an optional timeout delay before executing the scroll.
+ * - Each option has strict valid values.
+ *    - If an invalid value is provided, the function **automatically falls back to its default**.
+ * @param {ScrollToTopOptions} [options] - Optional settings for scroll behavior.
+ * @param {ScrollToTopOptions["behavior"]} [options.behavior="smooth"] - Scroll animation type.
+ *   - Valid values: `"auto"`, `"instant"`, `"smooth"`.
+ *   - Default force to `"smooth"` if missing or invalid.
+ * @param {ScrollToTopOptions["timeout"]} [options.timeout=1] - Delay before scrolling (in milliseconds).
+ *   - Default value is `1`.
+ *   - Valid values: any number `≥` `1`.
+ *   - Non-integer number are truncated to an integer.
+ *   - Force to `2147483647` if number is larger than `2147483647`.
+ *   - Default force to `1` if `missing`, `NaN`, `invalid`, or `less-than` `1`.
+ * @returns {void} Does not return anything, only scrolling to top.
+ * @example
+ * // ✅ Valid options value:
+ * scrollToTop();
+ * // ➔ Scroll smoothly to the top after 1ms delay
+ * scrollToTop({ behavior: "instant" });
+ * // ➔ Jump instantly to the top
+ * scrollToTop({ timeout: 500 });
+ * // ➔ Scroll smoothly to the top after 500ms
+ *
+ * // ❌ Invalid options value:
+ * scrollToTop({ behavior: "fly", timeout: -100 });
+ * // ➔ Fallback: behavior="smooth", timeout=1
+ * scrollToTop({ behavior: "fly", timeout: 123.55 });
+ * // ➔ Fallback: behavior="smooth", timeout=123
+ */
 declare const scrollToTop:(options?:ScrollToTopOptions)=>void;export{disableUserInteraction,enableUserInteraction,removeElementFocus,scrollToTop};

package/dist/events/index.js

@@ -1 +1 @@
-export{a as disableUserInteraction,b as enableUserInteraction,c as removeElementFocus,d as scrollToTop}from'../chunk-U4TZO7WV.js';import'../chunk-56QBKKRE.js';import'../chunk-JISH2VGG.js';import'../chunk-MJAW5RAK.js';
+export{a as disableUserInteraction,b as enableUserInteraction,c as removeElementFocus,d as scrollToTop}from'../chunk-S5M33A4O.js';import'../chunk-56QBKKRE.js';import'../chunk-NJSAV73S.js';import'../chunk-EWYPSKKM.js';