@rzl-zone/utils-js 3.7.0 → 3.8.0

package/dist/strings/index.cjs

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

package/dist/strings/index.d.ts

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

package/dist/strings/index.js

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

package/dist/tailwind/index.cjs

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

package/dist/tailwind/index.d.ts

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.0.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
@@ -20,7 +20,7 @@ import{Config}from'tailwindcss';import{ClassNameValue as ClassNameValue$1,Config
  *    - `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.
+ * - Used internally by ***`cx` utility function*** to process mixed input values.
  * @example
  * ```ts
  * const val1: ClassValue = "button";              // ➔ string
@@ -63,7 +63,15 @@ type ClassValues=ClassValue[];
  * * ***Utility: `cx`.***
  * ----------------------------------------------------------
  * **Merge multiple class values into a single, space-separated string suitable for CSS usage.**
- * @param {ClassValues} args
+ * @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.
+ * @param {ClassValues} values
  *   A list of mixed class values, which can include:
  *   - **Strings** → literal class names.
  *   - **Numbers** → numeric class names.
@@ -74,14 +82,6 @@ type ClassValues=ClassValue[];
  *   - **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
@@ -112,7 +112,7 @@ type ClassValues=ClassValue[];
  * // ➔ "own inherited"
  * ```
  */
-declare function cx(...args:ClassValues):string;
+declare function cx(...values:ClassValues):string;
 /** -------------------------------------------------------------
  * * ***Default `cnV3` utility (Tailwind v3).***
  * -------------------------------------------------------------
@@ -497,8 +497,8 @@ declare const customCnV4:(customTwMergeV4:TwMergeDefaultFnV4,...classes:ClassVal
  *   - `true`  ➔ the prop **will** be forwarded to the DOM.
  *   - `false` ➔ the prop **will not** be forwarded.
  *
- * @throws {TypeError}
- *   Thrown when:
+ * @throws **{@link TypeError | `TypeError`}**
+ *   when:
  *   - `props` is not an array, or
  *   - any item is not a non-empty string.
  *
@@ -523,8 +523,8 @@ declare const shouldForwardProp:<CustomProps extends Record<string,unknown>>(pro
 /** -------------------------------------------------------------
  * * ***Customized Tailwind class merger Version 3 with extended rules.***
  * -------------------------------------------------------------
- * **Wraps **{@link extendTailwindMerge| `extendTailwindMerge`}** with Tailwind’s default config
- * ({@link getDefaultConfig | `getDefaultConfig()`}) to create a **project-ready `twMerge`**.**
+ * **Wraps ***`extendTailwindMerge` from tailwind-merge-v3*** with Tailwind’s default
+ * config (_*`getDefaultConfig()` from tailwind-merge-v3*_) to create a **project-ready `twMerge`**.**
  * - 🔑 **When to use it?**
  *    - Your project uses **Tailwind v3**.
  *    - Extend **class groups** (e.g. add `text-shadow`).
@@ -576,7 +576,7 @@ declare const shouldForwardProp:<CustomProps extends Record<string,unknown>>(pro
  * #### Example 4: ***Project-wide helper (recommended).***
  * ```ts
  * import configTwCss from "../tailwind.config";
- * import { customCnV3, twMergeDefaultV3, type ClassesValue } from "@rzl-zone/utils-js/tailwind";
+ * import { customCnV3, twMergeDefaultV3, type ClassValues } from "@rzl-zone/utils-js/tailwind";
  *
  * const customTwMerge = twMergeDefaultV3({
  *   config: configTwCss,
@@ -585,7 +585,7 @@ declare const shouldForwardProp:<CustomProps extends Record<string,unknown>>(pro
  *   },
  * });
  *
- * export const cnApp = (...classes: ClassesValue) => {
+ * export const cnApp = (...classes: ClassValues) => {
  *   return customCnV3(customTwMerge, ...classes);
  * };
  *
@@ -610,8 +610,8 @@ declare const twMergeDefaultV3:(options?:OptionsMergeTwClsV3)=>TwMergeDefaultFnV
 /** -------------------------------------------------------------
  * * ***Customized Tailwind class merger Version 4 with extended rules.***
  * -------------------------------------------------------------
- * **Wraps **{@link extendTailwindMerge| `extendTailwindMerge`}** with Tailwind’s default config
- * ({@link getDefaultConfig | `getDefaultConfig()`}) to create a **project-ready `twMerge`**.**
+ * **Wraps ***`extendTailwindMerge` from tailwind-merge-v4*** with Tailwind’s default
+ * config (_*`getDefaultConfig()` from tailwind-merge-v4*_) to create a **project-ready `twMerge`**.**
  * - 🔑 **When to use it?**
  *    - Your project uses **Tailwind v4**.
  *    - Extend **class groups** (e.g. add `text-shadow`).
@@ -663,7 +663,7 @@ declare const twMergeDefaultV3:(options?:OptionsMergeTwClsV3)=>TwMergeDefaultFnV
  * #### Example 4: ***Project-wide helper (recommended).***
  * ```ts
  * import configTwCss from "../tailwind.config";
- * import { customCnV4, twMergeDefaultV4, type ClassesValue } from "@rzl-zone/utils-js/tailwind";
+ * import { customCnV4, twMergeDefaultV4, type ClassValues } from "@rzl-zone/utils-js/tailwind";
  *
  * const customTwMerge = twMergeDefaultV4({
  *   config: configTwCss,
@@ -672,7 +672,7 @@ declare const twMergeDefaultV3:(options?:OptionsMergeTwClsV3)=>TwMergeDefaultFnV
  *   },
  * });
  *
- * export const cnApp = (...classes: ClassesValue) => {
+ * export const cnApp = (...classes: ClassValues) => {
  *   return customCnV4(customTwMerge, ...classes);
  * };
  *

package/dist/tailwind/index.js

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

package/dist/urls/index.cjs

@@ -2,21 +2,21 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.0.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunkR3PBF6F7_cjs = require('../chunk-R3PBF6F7.cjs');
+var chunkLVFTN6DK_cjs = require('../chunk-LVFTN6DK.cjs');
 require('../chunk-KHO2SBNA.cjs');
 require('../chunk-BYUT376O.cjs');
 require('../chunk-AKKM6MOX.cjs');
 require('../chunk-UKAUXY2U.cjs');
 require('../chunk-B4SDEBN7.cjs');
 require('../chunk-DVMHRLKP.cjs');
-var chunkBG3AS5BU_cjs = require('../chunk-BG3AS5BU.cjs');
+var chunkSGCN4ED4_cjs = require('../chunk-SGCN4ED4.cjs');
 var chunkVJVCXEH7_cjs = require('../chunk-VJVCXEH7.cjs');
 require('../chunk-LIU4S3JA.cjs');
 require('../chunk-NREACG6M.cjs');
@@ -28,27 +28,27 @@ require('../chunk-F3WBQKRI.cjs');
 
 Object.defineProperty(exports, "constructURL", {
   enumerable: true,
-  get: function () { return chunkR3PBF6F7_cjs.constructURL; }
+  get: function () { return chunkLVFTN6DK_cjs.constructURL; }
 });
 Object.defineProperty(exports, "extractURLs", {
   enumerable: true,
-  get: function () { return chunkR3PBF6F7_cjs.extractURLs; }
+  get: function () { return chunkLVFTN6DK_cjs.extractURLs; }
 });
 Object.defineProperty(exports, "getFirstPrefixPathname", {
   enumerable: true,
-  get: function () { return chunkR3PBF6F7_cjs.getFirstPrefixPathname; }
+  get: function () { return chunkLVFTN6DK_cjs.getFirstPrefixPathname; }
 });
 Object.defineProperty(exports, "getPrefixPathname", {
   enumerable: true,
-  get: function () { return chunkR3PBF6F7_cjs.getPrefixPathname; }
+  get: function () { return chunkLVFTN6DK_cjs.getPrefixPathname; }
 });
 Object.defineProperty(exports, "formatEnvPort", {
   enumerable: true,
-  get: function () { return chunkBG3AS5BU_cjs.formatEnvPort; }
+  get: function () { return chunkSGCN4ED4_cjs.formatEnvPort; }
 });
 Object.defineProperty(exports, "normalizePathname", {
   enumerable: true,
-  get: function () { return chunkBG3AS5BU_cjs.normalizePathname; }
+  get: function () { return chunkSGCN4ED4_cjs.normalizePathname; }
 });
 Object.defineProperty(exports, "punycodeUtilsJS", {
   enumerable: true,

package/dist/urls/index.d.ts

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.0.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
@@ -12,7 +12,7 @@
  * ----------------------------------------------------------
  * **Represents a non-empty array of key–value pairs.**
  * @description
- * Type for `queryParams` parameter, the second parameter of **{@link constructURL | `constructURL`}**.
+ * Type for `queryParams` parameter, the second parameter of ***`constructURL` utility function***.
  * - **Behavior:**
  *    - Each inner tuple strictly follows the `[string, string | number]` shape.
  *    - Ensures the outer array contains **at least one pair** (non-empty).
@@ -44,7 +44,7 @@ type QueryParamPairs=[[string,string|number],...[string,string|number][]];
  * @param {string[]} [removeParams]
  *   A list of query parameter keys to remove from the final URL, whether they were in the base URL or provided queryParams.
  * @returns {URL} A new URL object representing the constructed URL with merged and cleaned query parameters.
- * @throws {TypeError} Throws if `baseUrl` is not a valid non-empty string or URL object, or if `queryParams` is not iterable, or if `removeParams` is not an array of strings.
+ * @throws **{@link TypeError | `TypeError`}** if `baseUrl` is not a valid non-empty string or URL object, or if `queryParams` is not iterable, or if `removeParams` is not an array of strings.
  * @example
  *    1. #### Basic Usage:
  * ```ts
@@ -202,8 +202,7 @@ declare const extractURLs:(url:string|null|undefined)=>string[]|null;
  *      - Defaults to `"/"`.
  * @returns {string}
  *   ***The first valid normalized pathname, or the normalized default.***
- * @throws {TypeError}
- *   ***If `result` is not a valid type, or `defaultValue` is not a string or empty-string.***
+ * @throws **{@link TypeError | `TypeError`}** ***if `result` is not a valid type, or `defaultValue` is not a string or empty-string.***
  */
 declare const getFirstPrefixPathname:(result:string|string[]|null|undefined,defaultValue?:string)=>string;type GetPrefixPathnameOptions={
 /** The number of levels to include in the prefix (default is `1`).
@@ -252,8 +251,8 @@ removeDuplicates?:boolean;};
  *    - A single string if only one unique prefix/base is found.
  *    - An array of strings if multiple different prefixes/bases are found.
  *    - `null` if no matching base is found when using `base`.
- * @throws {TypeError}
- *  ***Throws if:***
+ * @throws **{@link TypeError | `TypeError`}**
+ *  ***if:***
  *    - `url` is `not a string` or `not an array of strings`.
  *    - `base` is `not a string`, `array of strings`, or `null`.
  *    - `options` is `not an object`.
@@ -429,8 +428,8 @@ keepTrailingSlash?:boolean;};type NormalizePathnameOptionsKeepNullableTrue=MainN
  * @returns {string | null | undefined} ***Normalized pathname, or original nullable value if `keepNullable` is `true`
  * _(except if `pathname` is empty-string, will keep returning `defaultPath`)_.***
  *
- * @throws {TypeError} If `defaultPath` is invalid when `keepNullable` is false.
- * @throws {NormalizePathnameError} If normalization fails (e.g., invalid URL).
+ * @throws **{@link TypeError | `TypeError`}** if `defaultPath` is invalid when `keepNullable` is false.
+ * @throws **`NormalizePathnameError` extends {@link Error | `Error`}** If normalization fails (e.g., invalid URL).
  *
  * @example
  * // Basic normalization
@@ -550,7 +549,7 @@ prefixColon?:boolean;};
  * @param {string | null | undefined} envVar The environment variable string.
  * @param {FormatEnvPortOptions} [options] Optional object: `{ prefixColon?: boolean }`.
  * @returns {string} A string like `":8080"` or `"8080"`, or `""` if no digits.
- * @throws {TypeError} If `options` is not an object or `prefixColon` is not boolean.
+ * @throws **{@link TypeError | `TypeError`}** if `options` is not an object or `prefixColon` is not boolean.
  * @example
  * formatEnvPort("port:8080");
  * // ➔ "8080"

package/dist/urls/index.js

@@ -2,19 +2,19 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.0.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-export { constructURL, extractURLs, getFirstPrefixPathname, getPrefixPathname } from '../chunk-6PKW4WCT.js';
+export { constructURL, extractURLs, getFirstPrefixPathname, getPrefixPathname } from '../chunk-5IKZ3JDV.js';
 import '../chunk-ONZFBJVW.js';
 import '../chunk-GAJBF6DR.js';
 import '../chunk-TDYGYHSH.js';
 import '../chunk-PZQC3FZY.js';
 import '../chunk-7ZNEUWYP.js';
 import '../chunk-WVSPXFTY.js';
-export { formatEnvPort, normalizePathname } from '../chunk-WNO3EPYT.js';
+export { formatEnvPort, normalizePathname } from '../chunk-PW2VMJLT.js';
 export { punycodeUtilsJS } from '../chunk-YS27V6LS.js';
 import '../chunk-4ACKNPL5.js';
 import '../chunk-JY4HLZ4W.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rzl-zone/utils-js",
-  "version": "3.7.0",
+  "version": "3.8.0",
   "sideEffects": false,
   "engineStrict": true,
   "license": "MIT",

package/dist/chunk-ABA2ZSBQ.js

@@ -1,152 +0,0 @@
-/*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.7.0.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-import { isInteger } from './chunk-WVSPXFTY.js';
-import { safeStableStringify } from './chunk-2VO2CBTU.js';
-import { isNonEmptyArray, getPreciseType, isNumber, isPlainObject, assertIsBoolean, isNaN } from './chunk-3KTD3QDI.js';
-
-function getRandomItem(array) {
-  if (!isNonEmptyArray(array)) return void 0;
-  const randomIndex = Math.floor(Math.random() * (array.length || 0));
-  return array[randomIndex];
-}
-
-var randomInt = (min, max) => {
-  if (!isInteger(min) || !isInteger(max)) {
-    throw new TypeError(
-      `First parameter (\`min\`) and second parameter (\`max\`) must be of type \`integer-number\`${minValueNote(
-        min,
-        max
-      )}value, but received: ['min': \`${getPreciseType(
-        min
-      )}\` - (with value: \`${safeStableStringify(min)})\`, 'max': \`${getPreciseType(
-        max
-      )}\` - (with value: \`${safeStableStringify(max)}\`)].`
-    );
-  }
-  if (min > max) {
-    throw new RangeError(
-      `First parameter (\`min\`) must be less than or equal to second parameter (\`max\`), but received: ['min': ${formatValue(
-        min
-      )}, 'max': ${formatValue(max)}].`
-    );
-  }
-  min = Math.max(1, min);
-  max = Math.min(Number.MAX_SAFE_INTEGER, max);
-  return Math.floor(Math.random() * (max - min + 1)) + min;
-};
-var formatValue = (value) => {
-  return isNumber(value, { includeNaN: true }) ? value === Number.MIN_VALUE ? "`Number.MIN_VALUE`" : `${value}` : `\`${getPreciseType(value)}\``;
-};
-var minValueNote = (...values) => {
-  return values.some((v) => isNumber(v, { includeNaN: true }) && v === Number.MIN_VALUE) ? " and can't be `Number.MIN_VALUE` " : " ";
-};
-
-var randomIntByLength = (options) => {
-  if (!isPlainObject(options)) {
-    options = {};
-  }
-  const { minLength = 1, maxLength = 16, avoidZero = false } = options;
-  assertIsBoolean(avoidZero, {
-    message({ currentType, validType }) {
-      return `Parameters \`avoidZero\` must be of type \`${validType}\`, but received: \`${currentType}\`.`;
-    }
-  });
-  if (!isInteger(minLength) || !isInteger(maxLength)) {
-    throw new TypeError(
-      `Parameters \`minLength\` and \`maxLength\` must be of type \`integer-number\`, but received: ['minLength': \`${getPreciseType(
-        minLength
-      )}\` - (with value: ${safeStableStringify(
-        minLength
-      )}), 'maxLength': \`${getPreciseType(
-        maxLength
-      )}\` - (with value: ${safeStableStringify(maxLength)})].`
-    );
-  }
-  if (minLength < 1 || maxLength > 16 || minLength > maxLength) {
-    throw new RangeError(
-      `Invalid range at parameters \`minLength\` must be \u2265 1, \`maxLength\` must be \u2264 16, and \`minLength\` \u2264 \`maxLength\`, but received: ['minLength': \`${minLength}\`, 'maxLength': \`${maxLength}\`].`
-    );
-  }
-  const randomLength = minLength === maxLength ? minLength : randomInt(minLength, maxLength);
-  const minValue = 10 ** (randomLength - 1);
-  const maxValue = 10 ** randomLength - 1;
-  let result = randomInt(minValue, maxValue);
-  if (avoidZero && result === 0) {
-    result = minValue;
-  }
-  return result;
-};
-
-var randomStr = (options) => {
-  if (!isPlainObject(options)) {
-    options = {};
-  }
-  const {
-    minLength = 40,
-    maxLength = 40,
-    type = "string",
-    avoidWhiteSpace = true
-  } = options;
-  assertIsBoolean(avoidWhiteSpace, {
-    message({ currentType, validType }) {
-      return `Parameters \`avoidWhiteSpace\` property of the \`options\` (first-parameter) must be of type \`${validType}\`, but received: \`${currentType}\`.`;
-    }
-  });
-  if (!isInteger(minLength) || !isInteger(maxLength)) {
-    throw new TypeError(
-      `Parameters \`minLength\` and \`maxLength\` must be of type \`integer-number\`, but received: ['minLength': \`${getPreciseType(
-        minLength
-      )}\` - (with value: ${safeStableStringify(
-        minLength
-      )}), 'maxLength': \`${getPreciseType(
-        maxLength
-      )}\` - (with value: ${safeStableStringify(maxLength)})].`
-    );
-  }
-  if (minLength < 1 || maxLength > 5e3 || minLength > maxLength) {
-    throw new RangeError(
-      `Invalid range at parameters \`minLength\` must be \u2265 1, \`maxLength\` must be \u2264 5000, and \`minLength\` \u2264 \`maxLength\`, but received: ['minLength': \`${minLength}\`, 'maxLength': \`${maxLength}\`].`
-    );
-  }
-  if (type !== "string" && type !== "number") {
-    throw new TypeError(
-      `Parameter \`type\` must be of type \`string\` with value one of "string" | "number", but received: \`${getPreciseType(
-        type
-      )}\`, with value: ${safeStableStringify(type)}.`
-    );
-  }
-  const length = randomInt(minLength, maxLength);
-  const cleanCharacters = (charSet) => {
-    return avoidWhiteSpace ? charSet.replace(/\s|\n|\t/g, "") : charSet;
-  };
-  const defaultNumberSet = "0123456789";
-  const defaultStringSet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
-  const baseCharSet = type === "number" ? (!isNaN(Number(options.replaceGenInt)) ? options.replaceGenInt : void 0) ?? defaultNumberSet : (options.replaceGenStr ? options.replaceGenStr : void 0) ?? defaultStringSet;
-  const characterSet = cleanCharacters(baseCharSet) + (options.addChar || "");
-  if (!characterSet.length) {
-    const errCharSet = () => {
-      if (type === "number") {
-        if (avoidWhiteSpace) {
-          return `If \`avoidWhiteSpace\` is true, and \`replaceGenInt\` cant be empty-string value, ensure \`replaceGenInt\` has valid characters and non-nan string number.`;
-        }
-        return `Ensure \`replaceGenInt\` has valid characters and not a NaN number string while convert to number.`;
-      }
-      return `Ensure \`replaceGenStr\` has valid characters and non empty string.`;
-    };
-    throw new Error(`Character set is empty. ${errCharSet()}`);
-  }
-  let result = "";
-  for (let i = 0; i < length; i++) {
-    result += characterSet.charAt(Math.floor(Math.random() * characterSet.length));
-  }
-  return result;
-};
-
-export { getRandomItem, randomInt, randomIntByLength, randomStr };