@rzl-zone/utils-js 3.7.0 → 3.8.0

package/README.md

@@ -157,6 +157,29 @@
 
   > ***⚠️ Note:*** Starting from version `3.4.0+`, the extra TypeScript types (e.g., `OmitStrict`, `PartialOnly`, etc), have been removed from the package. To use them, you now need to install **[`@rzl-zone/ts-types-plus`](https://www.npmjs.com/package/@rzl-zone/ts-types-plus)** separately.
 
+  ---
+  
+  ### **CDN Usage [@rzl-zone/utils-js](https://www.npmjs.com/package/@rzl-zone/utils-js)**
+
+  > ⚠️ **Note:**  
+  > When using the library via CDN in the browser:  
+  > - Always include first the \<script\> tag before your own scripts when using the CDN version.
+  > - Some Node.js-specific utilities may **not** be available, e.g.:  
+  >   - Category utils of `tailwind`, `next`, `next/server`.  
+  >   - Server-only features (like Next.js helpers) will **not** be available.  
+  > - The global object provided is `RzlUtilsJs`.  
+  > - The CDN bundle is **~350KB minified**. For production, consider using bundlers or npm packages for smaller size and tree-shaking.
+
+  #### **Including via CDN**
+  ```xml
+  <!-- jsDelivr -->
+  <script src="https://cdn.jsdelivr.net/npm/@rzl-zone/utils-js@latest"></script>
+
+  <!-- unpkg -->
+  <script src="https://unpkg.com/@rzl-zone/utils-js@latest"></script>
+  ```
+
+
   ---
   ### **Hint: Autocomplete Setup (Step by Step)**
 

package/dist/assertions/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/assertions/index.d.ts

@@ -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.
  * ====================================================
  */
-import{Prettify,PickStrict}from'@rzl-zone/ts-types-plus';import{G as GetPreciseTypeOptions,I as IsNumberOptions,a as IsPlainObjectResult}from'../isPlainObject-FWmcJF6k.js';
+import{Prettify,PickStrict}from'@rzl-zone/ts-types-plus';import{G as GetPreciseTypeOptions,I as IsNumberOptions,a as IsPlainObjectResult}from'../isPlainObject-BTPjv6zB.js';
 /** -------------------------------------------------------
  * * ***Shape of the object passed to custom error message functions.***
  * -------------------------------------------------------
@@ -99,7 +99,7 @@ message?:OptionsMessageAssertIs;}& PickStrict<GetPreciseTypeOptions,"formatCase"
  *   - `message`: A custom error message (`string` or `function`).
  *   - `formatCase`: Controls type formatting (from `GetPreciseTypeOptions`).
  * @returns {boolean} Narrows `value` to `boolean` if no error is thrown.
- * @throws {TypeError} If the value is not a boolean.
+ * @throws **{@link TypeError | `TypeError`}** if the value is not a boolean.
  * @example
  * ```ts
  * // ✅ Simple usage
@@ -158,7 +158,7 @@ declare const assertIsBoolean:(value:unknown,options?:OptionsAssertIs)=>asserts
  *   - `message`: A custom error message (`string` or `function`).
  *   - `formatCase`: Controls type formatting (from `GetPreciseTypeOptions`).
  * @returns {boolean} Narrows `value` to `bigint` if no error is thrown.
- * @throws {TypeError} If the value is not a bigint.
+ * @throws **{@link TypeError | `TypeError`}** if the value is not a bigint.
  * @example
  * ```ts
  * // ✅ Simple usage
@@ -219,7 +219,7 @@ declare const assertIsBigInt:(value:unknown,options?:OptionsAssertIs)=>asserts v
  *   - `formatCase`: Controls type formatting (from `GetPreciseTypeOptions`).
  *   - `includeNaN`: Whether to treat `NaN` as valid.
  * @returns {boolean} Narrows `value` to `number` if no error is thrown.
- * @throws {TypeError} If the value is not a number (or is `NaN` when `includeNaN` is `false`).
+ * @throws **{@link TypeError | `TypeError`}** if the value is not a number (or is `NaN` when `includeNaN` is `false`).
  * @example
  * ```ts
  * // ✅ Simple usage
@@ -285,7 +285,7 @@ declare const assertIsNumber:(value:unknown,options?:OptionsAssertIsNumber)=>ass
  *   - `message`: A custom error message (`string` or `function`).
  *   - `formatCase`: Controls type formatting (from `GetPreciseTypeOptions`).
  * @returns {boolean} Narrows `value` to an `array` **(generic support)** if no error is thrown.
- * @throws {TypeError} If the value is not an array.
+ * @throws **{@link TypeError | `TypeError`}** if the value is not an array.
  * @example
  * ```ts
  * // ✅ Simple usage
@@ -342,7 +342,7 @@ declare function assertIsArray<T extends unknown[]>(value:T,options?:OptionsAsse
  *   - `message`: A custom error message (`string` or `function`).
  *   - `formatCase`: Controls type formatting (from `GetPreciseTypeOptions`).
  * @returns {boolean} Narrows `value` to a `plain-object` **(generic support)** if no error is thrown.
- * @throws {TypeError} If `value` is not a `plain-object`.
+ * @throws **{@link TypeError | `TypeError`}** if `value` is not a `plain-object`.
  * @example
  * ```ts
  * // ✅ Simple usage
@@ -401,7 +401,7 @@ declare function assertIsPlainObject<T>(value:T,options?:OptionsAssertIs):assert
  *   - `message`: A custom error message (`string` or `function`).
  *   - `formatCase`: Controls type formatting (from `GetPreciseTypeOptions`).
  * @returns {boolean} Narrows `value` to `string` if no error is thrown.
- * @throws {TypeError} If the value is not a string.
+ * @throws **{@link TypeError | `TypeError`}** if the value is not a string.
  * @example
  * ```ts
  * // ✅ Simple usage

package/dist/assertions/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/chunk-2VO2CBTU.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/{chunk-KTQLDIIT.cjs → chunk-3JD53UUH.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.
  * ====================================================
@@ -45,7 +45,9 @@ function toStringDeepForce(value, forceToString) {
     throw new TypeError(
       `Second parameter \`forceToString\` must be of type \`false\` or \`string\` with value one of "stringOrNumber" | "primitives" | "all", but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
         forceToString
-      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(forceToString)}\`.`
+      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(forceToString, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (chunkF3WBQKRI_cjs.isNaN(value)) {
@@ -112,7 +114,9 @@ var dedupeArray = (inputArray, options = {}) => {
     throw new TypeError(
       `Parameter \`forceToString\` property of the \`options\` (second parameter) must be of type \`false\` or \`string\` with value one of "stringOrNumber" | "primitives" | "all", but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
         forceToString
-      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(forceToString)}\`.`
+      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(forceToString, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   chunkF3WBQKRI_cjs.assertIsBoolean(flatten, {
@@ -266,13 +270,19 @@ function removeObjectPaths(object, keysToDelete, deepClone = true) {
     return {};
   chunk7WBMA2VE_cjs.assertIsArray(keysToDelete, {
     message: ({ currentType, validType }) => `Second parameter (\`keysToDelete\`) must be of type \`${validType}\` with value of { key: string, deep?: boolean } plain-object, but received: \`${currentType}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(
-      keysToDelete
+      keysToDelete,
+      {
+        keepUndefined: true
+      }
     )}\`.`
   });
   if (!keysToDelete.every((k) => chunkF3WBQKRI_cjs.isPlainObject(k) && "key" in k)) {
     throw new TypeError(
       `Each element in Second Parameter (\`keysToDelete\`) must be of type \`plain-object\` with at least a "key" property (optionally "deep"), but received: \`${chunkYC7AK3KX_cjs.safeStableStringify(
-        keysToDelete
+        keysToDelete,
+        {
+          keepUndefined: true
+        }
       )}\`.`
     );
   }

package/dist/chunk-3KTD3QDI.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/chunk-4ACKNPL5.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/chunk-4ZOXSUXB.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/{chunk-6PKW4WCT.js → chunk-5IKZ3JDV.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.
  * ====================================================
@@ -12,7 +12,7 @@ import { normalizeString } from './chunk-GAJBF6DR.js';
 import { toStringArrayUnRecursive } from './chunk-TDYGYHSH.js';
 import { isEmptyValue } from './chunk-PZQC3FZY.js';
 import { isInteger } from './chunk-WVSPXFTY.js';
-import { normalizePathname } from './chunk-WNO3EPYT.js';
+import { normalizePathname } from './chunk-PW2VMJLT.js';
 import { isEmptyString } from './chunk-JY4HLZ4W.js';
 import { assertIsArray } from './chunk-6WMB5AJR.js';
 import { safeStableStringify } from './chunk-2VO2CBTU.js';
@@ -28,7 +28,9 @@ var constructURL = (baseUrl, queryParams, removeParams) => {
     throw new TypeError(
       `First parameter (\`baseUrl\`) must be of type an URL instance or a \`string\` and a non empty-string, but received: \`${getPreciseType(
         baseUrl
-      )}\`, with current value: \`${safeStableStringify(baseUrl)}\`.`
+      )}\`, with current value: \`${safeStableStringify(baseUrl, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (!isUndefined(removeParams)) {
@@ -46,7 +48,9 @@ var constructURL = (baseUrl, queryParams, removeParams) => {
       throw new TypeError(
         `Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${getPreciseType(
           queryParams
-        )}\`, with value: \`${safeStableStringify(queryParams)}\`.`
+        )}\`, with value: \`${safeStableStringify(queryParams, {
+          keepUndefined: true
+        })}\`.`
       );
     }
     const urlInstance = new URL(baseUrl);
@@ -59,7 +63,9 @@ var constructURL = (baseUrl, queryParams, removeParams) => {
             throw new TypeError(
               `Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${getPreciseType(
                 queryParams
-              )}\`, with value: \`${safeStableStringify(queryParams)}\`.`
+              )}\`, with value: \`${safeStableStringify(queryParams, {
+                keepUndefined: true
+              })}\`.`
             );
           }
           mergedParams.set(key, String(value));
@@ -109,7 +115,9 @@ var getFirstPrefixPathname = (result, defaultValue = "/") => {
     throw new TypeError(
       `Second parameter (\`defaultValue\`) must be of type \`string\` and not an \`empty-string\`, but received: \`${getPreciseType(
         defaultValue
-      )}\`, with value: \`${safeStableStringify(defaultValue)}\`.`
+      )}\`, with value: \`${safeStableStringify(defaultValue, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (isArray(result)) {
@@ -117,7 +125,9 @@ var getFirstPrefixPathname = (result, defaultValue = "/") => {
       throw new TypeError(
         `First parameter (\`result\`) must be of type \`string\` or \`array of string\`, but received: \`${getPreciseType(
           result
-        )}\`, with value: \`${safeStableStringify(result)}\`.`
+        )}\`, with value: \`${safeStableStringify(result, {
+          keepUndefined: true
+        })}\`.`
       );
     }
     for (const item of result) {
@@ -170,7 +180,9 @@ var getPrefixPathname = (url, base = null, options = {}) => {
     errors.push(
       `Parameter \`levels\` property of the \`options\` (second parameter) must be of type \`integer-number\` and minimum is \`0\`, but received: \`${getPreciseType(
         levels
-      )}\`, with value: \`${safeStableStringify(levels)}\`.`
+      )}\`, with value: \`${safeStableStringify(levels, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (!isBoolean(removeDuplicates)) {

package/dist/chunk-5NN4ZDE2.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/{chunk-OS5OT5JA.cjs → chunk-5PF7KRCP.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.
  * ====================================================
@@ -32,7 +32,9 @@ var formatCurrency = (value, options = {}) => {
     throw new TypeError(
       `First parameter (\`value\`) must be of type \`string\` or \`primitive-number\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
         value
-      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(value)}\`.`
+      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(value, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   chunkF3WBQKRI_cjs.assertIsPlainObject(options, {
@@ -72,21 +74,27 @@ var formatCurrency = (value, options = {}) => {
     throw new TypeError(
       `Parameter \`totalDecimal\` property of the \`options\` (second parameter) must be of type \`integer-number\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
         totalDecimal
-      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(length)}\`.`
+      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(length, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (!(roundedDecimal === false || roundedDecimal === "round" || roundedDecimal === "ceil" || roundedDecimal === "floor")) {
     throw new TypeError(
       `Parameter \`roundedDecimal\` property of the \`options\` (second parameter) must be of type \`false\` or \`string\` must be one of "round" | "ceil" | "floor", but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
         roundedDecimal
-      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(roundedDecimal)}\`.`
+      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(roundedDecimal, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (!(negativeFormat === "abs" || negativeFormat === "brackets" || negativeFormat === "dash" || chunkF3WBQKRI_cjs.isPlainObject(negativeFormat))) {
     throw new TypeError(
       `Parameter \`negativeFormat\` property of the \`options\` (second parameter) must be of type \`string\` must be one of "abs" | "brackets" | "dash" or \`plain-object\` type, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
         negativeFormat
-      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(negativeFormat)}\`.`
+      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(negativeFormat, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   const rawNum = chunkF3WBQKRI_cjs.isString(value) ? chunkEK7FSI7F_cjs.parseCurrencyString(value) : value;
@@ -164,7 +172,9 @@ var formatCurrency = (value, options = {}) => {
           throw new TypeError(
             `Parameter \`negativeFormat.style\` property of the \`options\` (second parameter) must be of type \`string\` must be of type "abs" | "brackets" | "dash", but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
               formatStyleNegative
-            )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(formatStyleNegative)}\`.`
+            )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(formatStyleNegative, {
+              keepUndefined: true
+            })}\`.`
           );
         }
         switch (formatStyleNegative) {
@@ -357,7 +367,9 @@ var censorEmail = (email, options = {}) => {
     throw new TypeError(
       `Parameter \`mode\` property of the \`options\` (second parameter) must be one of "fixed" or "random", but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
         mode
-      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(mode)}\`.`
+      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(mode, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   const emailRegex = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;
@@ -385,7 +397,9 @@ function chunkString(subject, limiter, options = {}) {
     throw new TypeError(
       `Second parameter (\`limiter\`) must be of type \`integer-number\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
         limiter
-      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(limiter)}\`.`
+      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(limiter, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   chunkF3WBQKRI_cjs.assertIsPlainObject(options, {
@@ -453,7 +467,9 @@ var truncateString = (text, options = {}) => {
     throw new TypeError(
       `Parameter \`length\` property of the \`options\` (second parameter) must be of type \`integer-number\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
         length2
-      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(length2)}\`.`
+      )}\`, with value: \`${chunkYC7AK3KX_cjs.safeStableStringify(length2, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (length2 < 1) return "";

package/dist/{chunk-66WLOZOD.cjs → chunk-6NORJBI6.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.
  * ====================================================
@@ -19,11 +19,13 @@ var parseCustomDate = (dateString, format) => {
     throw new TypeError(
       `Parameter \`dateString\` and \`format\` must be of type \`string\` and not empty-string, but received: "['dateString': \`${chunkF3WBQKRI_cjs.getPreciseType(
         dateString
-      )}\` - (current value: \`${chunkYC7AK3KX_cjs.safeStableStringify(
-        dateString
-      )}\`), 'format': \`${chunkF3WBQKRI_cjs.getPreciseType(
+      )}\` - (current value: \`${chunkYC7AK3KX_cjs.safeStableStringify(dateString, {
+        keepUndefined: true
+      })}\`), 'format': \`${chunkF3WBQKRI_cjs.getPreciseType(
         format
-      )}\` - (current value: \`${chunkYC7AK3KX_cjs.safeStableStringify(format)}\`)]".`
+      )}\` - (current value: \`${chunkYC7AK3KX_cjs.safeStableStringify(format, {
+        keepUndefined: true
+      })}\`)]".`
     );
   }
   const dateParts = dateString.split(/[-/]/).map(Number);

package/dist/chunk-6RFNZ2ZZ.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/{chunk-TDPYR5JY.js → chunk-6VA4F6VR.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.
  * ====================================================
@@ -43,7 +43,9 @@ function toStringDeepForce(value, forceToString) {
     throw new TypeError(
       `Second parameter \`forceToString\` must be of type \`false\` or \`string\` with value one of "stringOrNumber" | "primitives" | "all", but received: \`${getPreciseType(
         forceToString
-      )}\`, with value: \`${safeStableStringify(forceToString)}\`.`
+      )}\`, with value: \`${safeStableStringify(forceToString, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (isNaN(value)) {
@@ -110,7 +112,9 @@ var dedupeArray = (inputArray, options = {}) => {
     throw new TypeError(
       `Parameter \`forceToString\` property of the \`options\` (second parameter) must be of type \`false\` or \`string\` with value one of "stringOrNumber" | "primitives" | "all", but received: \`${getPreciseType(
         forceToString
-      )}\`, with value: \`${safeStableStringify(forceToString)}\`.`
+      )}\`, with value: \`${safeStableStringify(forceToString, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   assertIsBoolean(flatten, {
@@ -264,13 +268,19 @@ function removeObjectPaths(object, keysToDelete, deepClone = true) {
     return {};
   assertIsArray(keysToDelete, {
     message: ({ currentType, validType }) => `Second parameter (\`keysToDelete\`) must be of type \`${validType}\` with value of { key: string, deep?: boolean } plain-object, but received: \`${currentType}\`, with value: \`${safeStableStringify(
-      keysToDelete
+      keysToDelete,
+      {
+        keepUndefined: true
+      }
     )}\`.`
   });
   if (!keysToDelete.every((k) => isPlainObject(k) && "key" in k)) {
     throw new TypeError(
       `Each element in Second Parameter (\`keysToDelete\`) must be of type \`plain-object\` with at least a "key" property (optionally "deep"), but received: \`${safeStableStringify(
-        keysToDelete
+        keysToDelete,
+        {
+          keepUndefined: true
+        }
       )}\`.`
     );
   }

package/dist/chunk-6WMB5AJR.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/chunk-7QQV66RX.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/chunk-7WBMA2VE.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/chunk-7ZNEUWYP.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/chunk-A3YI6Y2P.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/{chunk-RMJC3B5P.cjs → chunk-A4H7474O.cjs}

@@ -2,14 +2,14 @@
  * ====================================================
  * 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 chunk66WLOZOD_cjs = require('./chunk-66WLOZOD.cjs');
+var chunk6NORJBI6_cjs = require('./chunk-6NORJBI6.cjs');
 var chunk7QQV66RX_cjs = require('./chunk-7QQV66RX.cjs');
 var chunkATLFMKAF_cjs = require('./chunk-ATLFMKAF.cjs');
 var chunk7WBMA2VE_cjs = require('./chunk-7WBMA2VE.cjs');
@@ -59,7 +59,10 @@ var omitKeysDeep = (object, keysToOmit) => {
   if (chunkF3WBQKRI_cjs.isNonEmptyArray(duplicates)) {
     throw new Error(
       `Function "omitKeysDeep" Error: Duplicate keys detected - \`${chunkYC7AK3KX_cjs.safeStableStringify(
-        duplicates
+        duplicates,
+        {
+          keepUndefined: true
+        }
       )}\`.`
     );
   }
@@ -97,7 +100,7 @@ var omitKeysDeep = (object, keysToOmit) => {
     }
     return obj;
   };
-  const result = chunk66WLOZOD_cjs.safeJsonParse(chunkYC7AK3KX_cjs.safeStableStringify(object));
+  const result = chunk6NORJBI6_cjs.safeJsonParse(chunkYC7AK3KX_cjs.safeStableStringify(object));
   for (const key of keysToOmit) {
     const parts = key.split(".");
     omitAtPath(result, parts);

package/dist/chunk-AKKM6MOX.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/chunk-ATLFMKAF.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/chunk-B4SDEBN7.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/chunk-B6UIKBHR.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/chunk-BAV5T2E3.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/chunk-BYUT376O.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/chunk-CKUEZF4R.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.
  * ====================================================