@rzl-zone/utils-js 3.10.0 → 3.11.0

package/dist/formatters/index.js

@@ -2,18 +2,18 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.10.0.
+ * Version: 3.11.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-export { censorEmail, chunkString, formatCurrency, formatDateFns, formatDateIntl, formatDateTime, formatNumber, formatPhoneNumber, getGMTOffset, truncateString } from '../chunk-7EIFPHV3.js';
-import '../chunk-JYOCB6OV.js';
-import '../chunk-EJV5AF4L.js';
-import '../chunk-MZ3T6L7Z.js';
+export { censorEmail, chunkString, formatCurrency, formatDateFns, formatDateIntl, formatDateTime, formatNumber, formatPhoneNumber, getGMTOffset, truncateString } from '../chunk-FJ4BQFVO.js';
+import '../chunk-ZVWZEGQP.js';
+import '../chunk-2XSZ2ANI.js';
+import '../chunk-CCJ2MSN7.js';
 import '../chunk-WVSPXFTY.js';
-import '../chunk-5O66AUEC.js';
-import '../chunk-OSSFLQDD.js';
-import '../chunk-X6ULJZ3X.js';
+import '../chunk-ULQPCIA2.js';
+import '../chunk-3T6VSWYX.js';
+import '../chunk-AXDYWO67.js';
 import '../chunk-QNKGP5DY.js';
-import '../chunk-J4TT33ZX.js';
+import '../chunk-MSUW5VHZ.js';

package/dist/generators/index.cjs

@@ -2,39 +2,39 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.10.0.
+ * Version: 3.11.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunkNJ24M6ZH_cjs = require('../chunk-NJ24M6ZH.cjs');
+var chunkKXJ7X325_cjs = require('../chunk-KXJ7X325.cjs');
 require('../chunk-DVMHRLKP.cjs');
 var chunkBAV5T2E3_cjs = require('../chunk-BAV5T2E3.cjs');
-require('../chunk-H44QVAZL.cjs');
+require('../chunk-DAPAK2W3.cjs');
 require('../chunk-UDA26MCU.cjs');
-require('../chunk-7C7TQC5J.cjs');
+require('../chunk-SYHPSOUU.cjs');
 
 Object.defineProperty(exports, "getRandomItem", {
   enumerable: true,
-  get: function () { return chunkNJ24M6ZH_cjs.getRandomItem; }
+  get: function () { return chunkKXJ7X325_cjs.getRandomItem; }
 });
 Object.defineProperty(exports, "randomInt", {
   enumerable: true,
-  get: function () { return chunkNJ24M6ZH_cjs.randomInt; }
+  get: function () { return chunkKXJ7X325_cjs.randomInt; }
 });
 Object.defineProperty(exports, "randomIntByLength", {
   enumerable: true,
-  get: function () { return chunkNJ24M6ZH_cjs.randomIntByLength; }
+  get: function () { return chunkKXJ7X325_cjs.randomIntByLength; }
 });
 Object.defineProperty(exports, "randomStr", {
   enumerable: true,
-  get: function () { return chunkNJ24M6ZH_cjs.randomStr; }
+  get: function () { return chunkKXJ7X325_cjs.randomStr; }
 });
 Object.defineProperty(exports, "randomUUID", {
   enumerable: true,
-  get: function () { return chunkNJ24M6ZH_cjs.randomUUID; }
+  get: function () { return chunkKXJ7X325_cjs.randomUUID; }
 });
 Object.defineProperty(exports, "noop", {
   enumerable: true,

package/dist/generators/index.d.ts

@@ -2,12 +2,13 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.10.0.
+ * Version: 3.11.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-import{NullToUndefined,FixNeverArrayRecursive,IfNonEmptyArray,Extends}from'@rzl-zone/ts-types-plus';
+import { NullToUndefined, FixNeverArrayRecursive, IfNonEmptyArray, Extends } from '@rzl-zone/ts-types-plus';
+
 /** ---------------------------------
  * * ***Utility: `getRandomItem`.***
  * ---------------------------------
@@ -39,7 +40,12 @@ import{NullToUndefined,FixNeverArrayRecursive,IfNonEmptyArray,Extends}from'@rzl-
  * const tuple = [1, "two", true] as const;
  * getRandomItem(tuple); // 1 | "two" | true
  */
-declare function getRandomItem(array:undefined):undefined;declare function getRandomItem(array:[]):undefined;declare function getRandomItem<T extends readonly unknown[]>(array:T):T extends never[][]?undefined:number extends T["length"]?NullToUndefined<FixNeverArrayRecursive<T[number]>>:IfNonEmptyArray<T,NullToUndefined<FixNeverArrayRecursive<T[number]>>,undefined>;declare function getRandomItem<T extends readonly unknown[]|undefined|null>(array:T):T extends readonly unknown[]?NullToUndefined<FixNeverArrayRecursive<T[number]>>|undefined:undefined;declare function getRandomItem<T>(array:T):unknown extends T?unknown:Extends<any[]|readonly any[],T>extends true?Extract<T,unknown[]|readonly unknown[]>[number]|undefined:Extends<any[],T>extends true?Extract<T,unknown[]|readonly unknown[]>[number]|undefined:Extends<readonly any[],T>extends true?Extract<T,unknown[]|readonly unknown[]>[number]|undefined:undefined;
+declare function getRandomItem(array: undefined): undefined;
+declare function getRandomItem(array: []): undefined;
+declare function getRandomItem<T extends readonly unknown[]>(array: T): T extends never[][] ? undefined : number extends T["length"] ? NullToUndefined<FixNeverArrayRecursive<T[number]>> : IfNonEmptyArray<T, NullToUndefined<FixNeverArrayRecursive<T[number]>>, undefined>;
+declare function getRandomItem<T extends readonly unknown[] | undefined | null>(array: T): T extends readonly unknown[] ? NullToUndefined<FixNeverArrayRecursive<T[number]>> | undefined : undefined;
+declare function getRandomItem<T>(array: T): unknown extends T ? unknown : Extends<any[] | readonly any[], T> extends true ? Extract<T, unknown[] | readonly unknown[]>[number] | undefined : Extends<any[], T> extends true ? Extract<T, unknown[] | readonly unknown[]>[number] | undefined : Extends<readonly any[], T> extends true ? Extract<T, unknown[] | readonly unknown[]>[number] | undefined : undefined;
+
 /** -----------------------------------------------------------------------
  * * ***Utility: `randomInt`.***
  * ------------------------------------------------------------------------
@@ -63,22 +69,25 @@ declare function getRandomItem(array:undefined):undefined;declare function getRa
  * randomInt(Number.MIN_VALUE, 3);
  * // ➔ Error, min or max cant be as `Number.MIN_VALUE` value.
  */
-declare const randomInt:(min:number,max:number)=>number;type OptionsRandomIntByLength={
-/** * Minimum length of the random number, the `allowed minimal value` `integer` is `1` `and not bigger than value of` `maxLength`, defaultValue: `1`.
- *
- * @default 1
- */
-minLength?:number;
-/** * Maximum length of the random number, the `allowed maximal value` `integer` is `16`, defaultValue: `16`.
- *
- * @default 16
- */
-maxLength?:number;
-/** * If true, prevents the result from being zero, defaultValue: `false`.
- *
- * @default false
- */
-avoidZero?:boolean;};
+declare const randomInt: (min: number, max: number) => number;
+
+type OptionsRandomIntByLength = {
+    /** * Minimum length of the random number, the `allowed minimal value` `integer` is `1` `and not bigger than value of` `maxLength`, defaultValue: `1`.
+     *
+     * @default 1
+     */
+    minLength?: number;
+    /** * Maximum length of the random number, the `allowed maximal value` `integer` is `16`, defaultValue: `16`.
+     *
+     * @default 16
+     */
+    maxLength?: number;
+    /** * If true, prevents the result from being zero, defaultValue: `false`.
+     *
+     * @default false
+     */
+    avoidZero?: boolean;
+};
 /** ----------------------------------------------------------------------------
  * * ***Utility: `randomIntByLength`.***
  * -----------------------------------------------------------------------------
@@ -109,35 +118,39 @@ avoidZero?:boolean;};
  * randomIntByLength({ avoidZero: true });
  * // ➔ never 0
  */
-declare const randomIntByLength:(options?:OptionsRandomIntByLength)=>number;type OptionsRandomStr={
-/** ***Ensures no whitespace characters in the generated string, defaultValue: `true`.***
- * @default true
- */
-avoidWhiteSpace?:boolean;
-/** ***Custom characters to replace the default number set if `type` is `"number"`, defaultValue: `undefined`.***
- * @default undefined
- */
-replaceGenInt?:string;
-/** ***Custom characters to replace the default string set if `type` is `"string"`, defaultValue: `undefined`.***
- * @default undefined
- */
-replaceGenStr?:string;
-/** ***Additional characters to include in the generated string, defaultValue: `undefined`.***
- * @default undefined
- */
-addChar?:string;
-/** ***Minimum length of the generated string (1 to 5000), defaultValue: `40`.***
- * @default 40
- */
-minLength?:number;
-/** ***Maximum length of the generated string (1 to 5000), defaultValue: `40`.***
- * @default 40
- */
-maxLength?:number;
-/** ***Type of output: `"string"` or `"number"`, defaultValue: `"string"`.***
- * @default "string"
- */
-type?:"string"|"number";};
+declare const randomIntByLength: (options?: OptionsRandomIntByLength) => number;
+
+type OptionsRandomStr = {
+    /** ***Ensures no whitespace characters in the generated string, defaultValue: `true`.***
+     * @default true
+     */
+    avoidWhiteSpace?: boolean;
+    /** ***Custom characters to replace the default number set if `type` is `"number"`, defaultValue: `undefined`.***
+     * @default undefined
+     */
+    replaceGenInt?: string;
+    /** ***Custom characters to replace the default string set if `type` is `"string"`, defaultValue: `undefined`.***
+     * @default undefined
+     */
+    replaceGenStr?: string;
+    /** ***Additional characters to include in the generated string, defaultValue: `undefined`.***
+     * @default undefined
+     */
+    addChar?: string;
+    /** ***Minimum length of the generated string (1 to 5000), defaultValue: `40`.***
+     * @default 40
+     */
+    minLength?: number;
+    /** ***Maximum length of the generated string (1 to 5000), defaultValue: `40`.***
+     * @default 40
+     */
+    maxLength?: number;
+    /** ***Type of output: `"string"` or `"number"`, defaultValue: `"string"`.***
+     * @default "string"
+     */
+    type?: "string" | "number";
+};
+
 /** ---------------------------------------------------------------------------------
  * * ***Utility: `randomStr`.***
  * ---------------------------------------------------------------------------------
@@ -168,45 +181,47 @@ type?:"string"|"number";};
  * randomStr({ addChar: "!@#", minLength: 15, maxLength: 15 });
  * // ➔ Guaranteed to include !@# in the set
  */
-declare const randomStr:(options?:OptionsRandomStr)=>string;
+declare const randomStr: (options?: OptionsRandomStr) => string;
+
 /**
  * Configuration options for `randomUUID()`.
  */
-type OptionsRandomUUID={
-/**
- * Specifies which UUID version to generate.
- *
- * - `"v4"` — Fully random UUID (RFC 4122). No timestamp, no ordering guarantees.
- * - `"v7"` — Time-ordered UUID (RFC 9562). Uses Unix timestamp + randomness.
- *
- * @default "v4"
- *
- * @example
- * // Random v4 UUID
- * randomUUID({ version: "v4" }); // ➔ "3ec0de5a-b8a9-4ffb-a62a-fcc76851e9c2"
- *
- * @example
- * // Time-ordered v7 UUID
- * randomUUID({ version: "v7" }); // ➔ "0199f3f6-3c5e-744b-affa-46b2cfd496f8"
- */
-version?:"v4"|"v7";
-/**
- * Enables monotonic sequencing for UUID v7.
- *
- * - Guarantees that multiple UUIDs generated within the same millisecond
- *   are strictly non-decreasing (lexicographically and timestamp-wise).
- * - Only valid when `version === "v7"`. Using with `v4` will throw a `TypeError`.
- * - Useful for database inserts, logs, or any system where order matters.
- *
- * @default false
- *
- * @example
- * // Monotonic v7 UUIDs
- * const a = randomUUID({ version: "v7", monotonic: true });
- * const b = randomUUID({ version: "v7", monotonic: true });
- * console.log(a < b); // true, guaranteed
- */
-monotonic?:boolean;};
+type OptionsRandomUUID = {
+    /**
+     * Specifies which UUID version to generate.
+     *
+     * - `"v4"` — Fully random UUID (RFC 4122). No timestamp, no ordering guarantees.
+     * - `"v7"` — Time-ordered UUID (RFC 9562). Uses Unix timestamp + randomness.
+     *
+     * @default "v4"
+     *
+     * @example
+     * // Random v4 UUID
+     * randomUUID({ version: "v4" }); // ➔ "3ec0de5a-b8a9-4ffb-a62a-fcc76851e9c2"
+     *
+     * @example
+     * // Time-ordered v7 UUID
+     * randomUUID({ version: "v7" }); // ➔ "0199f3f6-3c5e-744b-affa-46b2cfd496f8"
+     */
+    version?: "v4" | "v7";
+    /**
+     * Enables monotonic sequencing for UUID v7.
+     *
+     * - Guarantees that multiple UUIDs generated within the same millisecond
+     *   are strictly non-decreasing (lexicographically and timestamp-wise).
+     * - Only valid when `version === "v7"`. Using with `v4` will throw a `TypeError`.
+     * - Useful for database inserts, logs, or any system where order matters.
+     *
+     * @default false
+     *
+     * @example
+     * // Monotonic v7 UUIDs
+     * const a = randomUUID({ version: "v7", monotonic: true });
+     * const b = randomUUID({ version: "v7", monotonic: true });
+     * console.log(a < b); // true, guaranteed
+     */
+    monotonic?: boolean;
+};
 /** -----------------------------------------------------------------------
  * * ***Utility: `randomUUID`.***
  * ------------------------------------------------------------------------
@@ -275,7 +290,8 @@ monotonic?:boolean;};
  * // Throws RangeError
  * randomUUID({ version: "v1" as any }); // unsupported version
  */
-declare function randomUUID(options?:OptionsRandomUUID):string;
+declare function randomUUID(options?: OptionsRandomUUID): string;
+
 /**
  * --------------------------------------------------
  * * ***Utility: `noop`.***
@@ -319,4 +335,6 @@ declare function randomUUID(options?:OptionsRandomUUID):string;
  * callback(); // ➔ no effect (void)
  * ```
  */
-declare const noop:()=>void;export{getRandomItem,noop,randomInt,randomIntByLength,randomStr,randomUUID};
+declare const noop: () => void;
+
+export { getRandomItem, noop, randomInt, randomIntByLength, randomStr, randomUUID };

package/dist/generators/index.js

@@ -2,14 +2,14 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.10.0.
+ * Version: 3.11.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-export { getRandomItem, randomInt, randomIntByLength, randomStr, randomUUID } from '../chunk-5Y6JL47L.js';
+export { getRandomItem, randomInt, randomIntByLength, randomStr, randomUUID } from '../chunk-ENMRZ4BE.js';
 import '../chunk-WVSPXFTY.js';
 export { noop } from '../chunk-YWHHVDT4.js';
-import '../chunk-X6ULJZ3X.js';
+import '../chunk-AXDYWO67.js';
 import '../chunk-QNKGP5DY.js';
-import '../chunk-J4TT33ZX.js';
+import '../chunk-MSUW5VHZ.js';

package/dist/index.d.ts

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