npm - @rzl-zone/utils-js - Versions diffs - 2.1.0 → 3.0.0-beta.0 - Mend

@rzl-zone/utils-js 2.1.0 → 3.0.0-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (128) hide show

package/dist/NumberRangeUnion-DC-C3_Kq.d.ts +26 -0
package/dist/any-BmdI8UbK.d.ts +67 -0
package/dist/array-CIZRbqTF.d.ts +223 -0
package/dist/arrays-normalize-recursive-CnjYJ9xg.d.ts +72 -0
package/dist/assertions/index.cjs +1 -0
package/dist/assertions/index.d.ts +428 -0
package/dist/assertions/index.js +1 -0
package/dist/chunk-2TRAPBZ7.cjs +1 -0
package/dist/chunk-3D74QO5D.cjs +1 -0
package/dist/chunk-4DK3RCC4.js +2 -0
package/dist/chunk-4JOQ45HL.js +1 -0
package/dist/chunk-55CZALRS.js +1 -0
package/dist/chunk-56QBKKRE.js +1 -0
package/dist/chunk-5JFV3GDE.cjs +4 -0
package/dist/chunk-5SZUSNGZ.js +1 -0
package/dist/chunk-62HX5Z45.cjs +1 -0
package/dist/chunk-7NA6DUHR.cjs +2 -0
package/dist/chunk-7YWAQOA4.cjs +1 -0
package/dist/chunk-BVPMMWDL.cjs +1 -0
package/dist/chunk-BYZAD3XN.cjs +1 -0
package/dist/chunk-CEFYHEM4.cjs +1 -0
package/dist/chunk-CN53M4QZ.cjs +1 -0
package/dist/chunk-D47MHBSD.cjs +1 -0
package/dist/chunk-DGH75GJD.js +1 -0
package/dist/chunk-E5NUI7PN.js +1 -0
package/dist/chunk-ELDDNERR.js +1 -0
package/dist/chunk-EXZ47NOW.js +1 -0
package/dist/chunk-FDITZ5C6.cjs +1 -0
package/dist/chunk-FF76ISQ2.js +1 -0
package/dist/chunk-FIEZKTAZ.cjs +1 -0
package/dist/chunk-FSSV24W7.cjs +1 -0
package/dist/chunk-G5LXIEFO.js +0 -0
package/dist/chunk-GCGU2WB7.js +1 -0
package/dist/chunk-GECI2YBP.js +1 -0
package/dist/chunk-GQE4OVHC.cjs +1 -0
package/dist/chunk-GRVZXQXL.cjs +1 -0
package/dist/chunk-I4AVNHPA.cjs +1 -0
package/dist/chunk-JFRL7NKU.js +4 -0
package/dist/chunk-JWHM3WZQ.cjs +1 -0
package/dist/chunk-KCQDDZJE.cjs +1 -0
package/dist/chunk-L54ZPSYJ.js +1 -0
package/dist/chunk-LVKAYEZ4.js +1 -0
package/dist/chunk-MBDWTK54.cjs +1 -0
package/dist/chunk-MMSYCIJ2.cjs +1 -0
package/dist/chunk-MNGGDB2G.js +1 -0
package/dist/chunk-MY7BA4GI.cjs +1 -0
package/dist/chunk-N2IJPIND.cjs +1 -0
package/dist/chunk-NIMNTEGV.js +1 -0
package/dist/chunk-NNM7QCNB.js +1 -0
package/dist/chunk-PUQXRLZH.cjs +1 -0
package/dist/chunk-PVJF2JHM.js +1 -0
package/dist/chunk-QCFXEUKL.js +1 -0
package/dist/chunk-QFCGBBSY.js +1 -0
package/dist/chunk-QQYAUPSK.cjs +1 -0
package/dist/chunk-RN3TP3S3.js +1 -0
package/dist/chunk-RV2VULM7.cjs +1 -0
package/dist/chunk-SW6HYEW7.cjs +1 -0
package/dist/chunk-SYJC7UAW.js +1 -0
package/dist/chunk-TC4VBE4Y.cjs +1 -0
package/dist/chunk-TUXDINHF.cjs +1 -0
package/dist/chunk-U5Y2FXMN.cjs +1 -0
package/dist/chunk-UUPQI6ND.cjs +1 -0
package/dist/chunk-VYCGZ2S6.js +1 -0
package/dist/chunk-W5EDKJK3.js +1 -0
package/dist/chunk-WHAVUFEU.js +1 -0
package/dist/chunk-XCFIOTCV.js +1 -0
package/dist/chunk-XE27XPJR.js +1 -0
package/dist/chunk-XH6MCRLP.js +1 -0
package/dist/chunk-XVB3ZZEB.js +1 -0
package/dist/chunk-ZBSIGJFO.cjs +1 -0
package/dist/chunk-ZYAML74V.js +1 -0
package/dist/conversions/index.cjs +1 -0
package/dist/conversions/index.d.ts +1633 -0
package/dist/conversions/index.js +1 -0
package/dist/env/index.cjs +1 -0
package/dist/env/index.d.ts +19 -0
package/dist/env/index.js +1 -0
package/dist/events/index.cjs +1 -0
package/dist/events/index.d.ts +119 -0
package/dist/events/index.js +1 -0
package/dist/extends-Mp81Hq9-.d.ts +145 -0
package/dist/formatting/index.cjs +1 -0
package/dist/formatting/index.d.ts +912 -0
package/dist/formatting/index.js +1 -0
package/dist/generator/index.cjs +1 -0
package/dist/generator/index.d.ts +163 -0
package/dist/generator/index.js +1 -0
package/dist/if-CvT4R7Kh.d.ts +18 -0
package/dist/index.cjs +1 -1
package/dist/index.d.ts +1 -4334
package/dist/index.js +1 -1
package/dist/is-array-Ckm_47hw.d.ts +1557 -0
package/dist/isPlainObject-BKYaI6a8.d.ts +182 -0
package/dist/never-BfayMBF9.d.ts +75 -0
package/dist/next/index.cjs +8 -1
package/dist/next/index.d.ts +169 -169
package/dist/next/index.js +8 -1
package/dist/next/server/index.cjs +2 -1
package/dist/next/server/index.d.ts +37 -37
package/dist/next/server/index.js +2 -1
package/dist/nils-DMz3kU7M.d.ts +177 -0
package/dist/omit-VvmIsZmX.d.ts +28 -0
package/dist/operations/index.cjs +1 -0
package/dist/operations/index.d.ts +182 -0
package/dist/operations/index.js +1 -0
package/dist/parsers/index.cjs +1 -0
package/dist/parsers/index.d.ts +37 -0
package/dist/parsers/index.js +1 -0
package/dist/predicates/index.cjs +1 -0
package/dist/predicates/index.d.ts +1839 -0
package/dist/predicates/index.js +1 -0
package/dist/prettify-C4xLcYOP.d.ts +353 -0
package/dist/promise/index.cjs +1 -0
package/dist/promise/index.d.ts +40 -0
package/dist/promise/index.js +1 -0
package/dist/rzl-utils.global.js +4 -1
package/dist/strings/index.cjs +1 -0
package/dist/strings/index.d.ts +816 -0
package/dist/strings/index.js +1 -0
package/dist/stylings/index.cjs +1 -0
package/dist/stylings/index.d.ts +49 -0
package/dist/stylings/index.js +1 -0
package/dist/type-data-DDs-u2kq.d.ts +261 -0
package/dist/types/index.d.ts +3589 -2090
package/dist/urls/index.cjs +1 -0
package/dist/urls/index.d.ts +418 -0
package/dist/urls/index.js +1 -0
package/package.json +147 -21

package/dist/conversions/index.js ADDED Viewed

@@ -0,0 +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-VYCGZ2S6.js';export{b as cleanParsedData,a as extractDigits,c as parseCustomDate,d as safeJsonParse}from'../chunk-PVJF2JHM.js';import'../chunk-DGH75GJD.js';export{d as dedupeArray,b as filterNilArray,c as filterNullArray,e as toStringArrayUnRecursive,a as toStringDeepForce}from'../chunk-WHAVUFEU.js';import'../chunk-ZYAML74V.js';import'../chunk-W5EDKJK3.js';import'../chunk-QFCGBBSY.js';export{a as parseCurrencyString}from'../chunk-XH6MCRLP.js';import'../chunk-4JOQ45HL.js';import'../chunk-SYJC7UAW.js';import'../chunk-NIMNTEGV.js';import'../chunk-XVB3ZZEB.js';export{c as safeStableStringify}from'../chunk-MNGGDB2G.js';import'../chunk-5SZUSNGZ.js';import'../chunk-XCFIOTCV.js';

package/dist/env/index.cjs ADDED Viewed

	@@ -0,0 +1 @@
1	+ 'use strict';require('../chunk-MMSYCIJ2.cjs');var chunkSW6HYEW7_cjs=require('../chunk-SW6HYEW7.cjs');Object.defineProperty(exports,"isServer",{enumerable:true,get:function(){return chunkSW6HYEW7_cjs.a}});

package/dist/env/index.d.ts ADDED Viewed

@@ -0,0 +1,19 @@
+/** ----------------------------------------
+* * ***Detects if the current environment is server-side (Node.js) or client-side (browser).***
+* ----------------------------------------
+*
+* Determines whether the code is running in a Node.js environment (server)
+* or in a browser environment (client).
+*
+* @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/env/index.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ import'../chunk-G5LXIEFO.js';export{a as isServer}from'../chunk-56QBKKRE.js';

package/dist/events/index.cjs ADDED Viewed

@@ -0,0 +1 @@

+ 'use strict';var chunkGQE4OVHC_cjs=require('../chunk-GQE4OVHC.cjs');require('../chunk-SW6HYEW7.cjs'),require('../chunk-BVPMMWDL.cjs'),require('../chunk-CN53M4QZ.cjs');Object.defineProperty(exports,"disableUserInteraction",{enumerable:true,get:function(){return chunkGQE4OVHC_cjs.a}});Object.defineProperty(exports,"enableUserInteraction",{enumerable:true,get:function(){return chunkGQE4OVHC_cjs.b}});Object.defineProperty(exports,"removeElementFocus",{enumerable:true,get:function(){return chunkGQE4OVHC_cjs.c}});Object.defineProperty(exports,"scrollToTop",{enumerable:true,get:function(){return chunkGQE4OVHC_cjs.d}});

package/dist/events/index.d.ts ADDED Viewed

@@ -0,0 +1,119 @@
+type ScrollToTopOptions={
+/** `"auto" | "instant" | "smooth"` defaults value `"smooth"` */
+behavior?:ScrollBehavior|undefined;
+/** `number | undefined` defaults value `1` as `ms` */
+timeout?:number|undefined;};
+/** ----------------------------------------------------------
+* * ***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;
+/** ----------------------------------------------------------
+* * ***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;
+/** ----------------------------------------------------------
+* * ***Removes focus from the currently active element in the document.***
+* ----------------------------------------------------------
+*
+* - 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;
+/** ----------------------------------------------------------
+* * ***Scrolls the page to the top with optional smooth animation and delay.***
+* ----------------------------------------------------------
+*
+* - 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 {ScrollBehavior} [options.behavior="smooth"] - Scroll animation type.
+*   - Valid values: `"auto"`, `"instant"`, `"smooth"`.
+*   - Default: `"smooth"` if missing or invalid.
+* @param {number} [options.timeout=1] - Delay before scrolling (in milliseconds).
+*   - Valid values: any number >= 1.
+*   - Default: `1` if missing, invalid, or less than 1.
+*
+* @returns {void} Does not return anything.
+*
+* @example
+* // Scroll smoothly to the top after 1ms delay
+* scrollToTop();
+*
+* // Jump instantly to the top
+* scrollToTop({ behavior: "instant" });
+*
+* // Scroll smoothly to the top after 500ms
+* scrollToTop({ timeout: 500 });
+*
+* // ❌ Invalid options value:
+* scrollToTop({ behavior: "fly", timeout: -100 });
+* // Fallback: behavior="smooth", timeout=1
+*/
+declare const scrollToTop:(options?:ScrollToTopOptions)=>void;export{disableUserInteraction,enableUserInteraction,removeElementFocus,scrollToTop};

package/dist/events/index.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export{a as disableUserInteraction,b as enableUserInteraction,c as removeElementFocus,d as scrollToTop}from'../chunk-RN3TP3S3.js';import'../chunk-56QBKKRE.js';import'../chunk-XVB3ZZEB.js';import'../chunk-XCFIOTCV.js';

package/dist/extends-Mp81Hq9-.d.ts ADDED Viewed

@@ -0,0 +1,145 @@
+import{I as IsEmptyArray}from'./array-CIZRbqTF.js';import{I as If}from'./if-CvT4R7Kh.js';
+/** -------------------------------------------------------
+* * ***Not.***
+* -------------------------------------------------------
+* Accepts a boolean type `T` and returns its negation.
+*
+* @template T - Boolean type to negate.
+*
+* @example
+* ```ts
+* type A = Not<true>;  // ➔ false
+* type B = Not<false>; // ➔ true
+* ```
+*/
+type Not<T extends boolean>=T extends true?false:true;
+/** -------------------------------------------------------
+* * ***PopOptions.***
+* -------------------------------------------------------
+*
+* Configuration options for the {@link Pop} type utility.
+*/
+type PopOptions={
+/**
+* If `true`, {@link Pop} will return a tuple `[Rest, Removed]`
+* instead of just the remaining array.
+*
+* Default: `false`.
+*
+* @example
+* ```ts
+* type Options = { includeRemoved: true };
+* type Result = Pop<[1, 2, 3], Options>; // ➔ [[1, 2], 3]
+* ```
+*/
+includeRemoved:boolean;};
+/** -------------------------------------------------------
+* * ***Pop.***
+* -------------------------------------------------------
+*
+* Removes the last element from a tuple/array type.
+*
+* If the `includeRemoved` option is `true`, it returns a tuple `[Rest, Removed]`
+* where `Rest` is the array without the last element, and `Removed` is the last element.
+*
+* @template T - The tuple or array to pop from.
+* @template Options - Configuration object. Default `{ includeRemoved: false }`.
+*
+* @example
+* ```ts
+* // Removes last element
+* type Case1 = Pop<[1, 2, 3]>
+* // ➔ [1, 2]
+*
+* // Removes last element and includes the removed value
+* type Case2 = Pop<[1, 2, 3], { includeRemoved: true }>
+* // ➔ [[1, 2], 3]
+*
+* // Edge case: empty array
+* type Case3 = Pop<[]>
+* // ➔ never
+* ```
+*/
+type Pop<T extends readonly unknown[],Options extends PopOptions={includeRemoved:false;}>=IsEmptyArray<T>extends true?never:T extends readonly [...infer Rest extends readonly unknown[],infer Removed]?If<Options["includeRemoved"],[Rest,Removed],Rest>:never;
+/** -------------------------------------------------------
+* * ***Extends.***
+* -------------------------------------------------------
+* Returns a boolean indicating whether the first argument ***extends*** the second argument.
+*
+* @template T - The type to check.
+* @template Base - The type to compare against.
+* @example
+* ```ts
+* type A = Extends<1, number>;  // ➔ true
+* type B = Extends<number, 1>;  // ➔ false
+* ```
+*/
+type Extends<T,Base>=[T] extends [Base]?true:false;
+/** -------------------------------------------------------
+* * ***NotExtends.***
+* -------------------------------------------------------
+* Returns a boolean indicating whether the first argument does ***not extend*** the second argument.
+*
+* @template T - The type to check.
+* @template Base - The type to compare against.
+* @example
+* ```ts
+* type A = NotExtends<1, number>; // ➔ false
+* type B = NotExtends<number, 1>; // ➔ true
+* ```
+*/
+type NotExtends<T,Base>=Not<Extends<T,Base>>;
+/** -------------------------------------------------------
+* * ***IfExtends.***
+* -------------------------------------------------------
+* Conditional: returns the third argument if the first argument ***extends*** the second argument, otherwise returns the fourth argument.
+* - Defaults: `IfTrue = true`, `IfFalse = false`.
+*
+* @template T - The type to check.
+* @template Base - The type to compare against.
+* @template IfTrue - The branch type if condition is met. (default: `true`)
+* @template IfFalse - The branch type if condition is not met. (default: `false`)
+* @example
+* ```ts
+* type A = IfExtends<1, number, "valid">;
+* // ➔ "valid"
+* type B = IfExtends<1, string, "valid", "invalid">;
+* // ➔ "invalid"
+* ```
+*/
+type IfExtends<T,Base,IfTrue=true,IfFalse=false>=If<Extends<T,Base>,IfTrue,IfFalse>;
+/** -------------------------------------------------------
+* * ***IfNotExtends.***
+* -------------------------------------------------------
+* Conditional: returns the third argument if the first argument does ***not extend*** the second argument, otherwise returns the fourth argument.
+* - Defaults: `IfTrue = true`, `IfFalse = false`.
+*
+* @template T - The type to check.
+* @template Base - The type to compare against.
+* @template IfTrue - The branch type if condition is met. (default: `true`)
+* @template IfFalse - The branch type if condition is not met. (default: `false`)
+* @example
+* ```ts
+* type A = IfNotExtends<1, string, "valid">;
+* // ➔ "valid"
+* type B = IfNotExtends<1, number, "valid", "invalid">;
+* // ➔ "invalid"
+* ```
+*/
+type IfNotExtends<T,Base,IfTrue=true,IfFalse=false>=If<NotExtends<T,Base>,IfTrue,IfFalse>;
+/** -------------------------------------------------------
+* * ***ExtendsArr.***
+* -------------------------------------------------------
+* Returns a boolean indicating whether every element of the first array argument ***extends*** the second argument.
+*
+* @template T - The array to check.
+* @template Base - The type to compare each element against.
+* @example
+* ```ts
+* type A = ExtendsArr<[1, 2, 3], number>;
+* // ➔ true
+* type B = ExtendsArr<[1, "2", 3], number>;
+* // ➔ false
+* ```
+*/
+type ExtendsArr<T extends readonly unknown[],Base>=IsEmptyArray<T>extends true?true:Pop<T,{includeRemoved:true;}>extends readonly [infer Rest extends readonly unknown[],infer Removed]?Extends<Removed,Base>extends true?ExtendsArr<Rest,Base>:false:false;export type{Extends as E,IfExtends as I,Not as N,Pop as P,NotExtends as a,ExtendsArr as b,IfNotExtends as c,PopOptions as d};

package/dist/formatting/index.cjs ADDED Viewed

@@ -0,0 +1 @@

+ 'use strict';var chunkZBSIGJFO_cjs=require('../chunk-ZBSIGJFO.cjs');require('../chunk-JWHM3WZQ.cjs'),require('../chunk-FDITZ5C6.cjs'),require('../chunk-N2IJPIND.cjs'),require('../chunk-2TRAPBZ7.cjs'),require('../chunk-BVPMMWDL.cjs'),require('../chunk-PUQXRLZH.cjs'),require('../chunk-U5Y2FXMN.cjs'),require('../chunk-7YWAQOA4.cjs'),require('../chunk-CN53M4QZ.cjs');Object.defineProperty(exports,"censorEmail",{enumerable:true,get:function(){return chunkZBSIGJFO_cjs.h}});Object.defineProperty(exports,"chunkString",{enumerable:true,get:function(){return chunkZBSIGJFO_cjs.i}});Object.defineProperty(exports,"formatCurrency",{enumerable:true,get:function(){return chunkZBSIGJFO_cjs.a}});Object.defineProperty(exports,"formatDateFns",{enumerable:true,get:function(){return chunkZBSIGJFO_cjs.f}});Object.defineProperty(exports,"formatDateIntl",{enumerable:true,get:function(){return chunkZBSIGJFO_cjs.e}});Object.defineProperty(exports,"formatDateTime",{enumerable:true,get:function(){return chunkZBSIGJFO_cjs.d}});Object.defineProperty(exports,"formatNumber",{enumerable:true,get:function(){return chunkZBSIGJFO_cjs.b}});Object.defineProperty(exports,"formatPhoneNumber",{enumerable:true,get:function(){return chunkZBSIGJFO_cjs.c}});Object.defineProperty(exports,"getGMTOffset",{enumerable:true,get:function(){return chunkZBSIGJFO_cjs.g}});Object.defineProperty(exports,"truncateString",{enumerable:true,get:function(){return chunkZBSIGJFO_cjs.j}});