@rzl-zone/utils-js 3.7.1 → 3.9.0

package/dist/next/index.cjs

@@ -2,40 +2,43 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunkBG3AS5BU_cjs = require('../chunk-BG3AS5BU.cjs');
-require('../chunk-VJVCXEH7.cjs');
-var chunkLIU4S3JA_cjs = require('../chunk-LIU4S3JA.cjs');
-var chunkNREACG6M_cjs = require('../chunk-NREACG6M.cjs');
-var chunkK63WO3XA_cjs = require('../chunk-K63WO3XA.cjs');
-var chunkYC7AK3KX_cjs = require('../chunk-YC7AK3KX.cjs');
+var chunkOCTHWEZK_cjs = require('../chunk-OCTHWEZK.cjs');
+require('../chunk-6AMDHVS2.cjs');
+require('../chunk-ZTHJQJ5F.cjs');
+var chunkIX6PF5ZP_cjs = require('../chunk-IX6PF5ZP.cjs');
+var chunkFWWPEL7J_cjs = require('../chunk-FWWPEL7J.cjs');
+var chunkWKM6UVMG_cjs = require('../chunk-WKM6UVMG.cjs');
+var chunkH44QVAZL_cjs = require('../chunk-H44QVAZL.cjs');
 require('../chunk-UDA26MCU.cjs');
-var chunkF3WBQKRI_cjs = require('../chunk-F3WBQKRI.cjs');
+var chunk7C7TQC5J_cjs = require('../chunk-7C7TQC5J.cjs');
 
 function generateRoute(route, params) {
-  if (!chunkF3WBQKRI_cjs.isString(route) || chunkNREACG6M_cjs.isEmptyString(route)) {
+  if (!chunk7C7TQC5J_cjs.isString(route) || chunkFWWPEL7J_cjs.isEmptyString(route)) {
     throw new TypeError(
       `\u274C 'generateRoute' Failed:
 - Invalid 'route' value.
-- Must be of type \`string\` and non-empty string, but received: "${chunkF3WBQKRI_cjs.getPreciseType(
+- Must be of type \`string\` and non-empty string, but received: "${chunk7C7TQC5J_cjs.getPreciseType(
         route
-      )}": \`${chunkYC7AK3KX_cjs.safeStableStringify(route)}\`.`
+      )}": \`${chunkH44QVAZL_cjs.safeStableStringify(route, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (!/[\\[\]]/.test(route)) {
     return route;
   }
-  chunkF3WBQKRI_cjs.assertIsPlainObject(params, {
+  chunk7C7TQC5J_cjs.assertIsPlainObject(params, {
     message: ({ validType }) => `\u274C 'generateRoute' Failed cause in route "${route}":
 - Missing or invalid parameters \`${validType}\` for route: "${route}", must be of type \`${validType}\` mapping parameters.`
   });
-  if (chunkF3WBQKRI_cjs.isNil(params)) {
+  if (chunk7C7TQC5J_cjs.isNil(params)) {
     throw new TypeError(
       `\u274C 'generateRoute' Failed cause in route "${route}":
 - Missing parameters \`plain-object\` for route: "${route}".`
@@ -64,15 +67,15 @@ function generateRoute(route, params) {
   const requiredKeys = Array.from(route.matchAll(/\[(\w+)\]/g)).map((m) => m[1]);
   for (const key of requiredKeys) {
     const value = params[key];
-    if (!chunkF3WBQKRI_cjs.isString(value)) {
+    if (!chunk7C7TQC5J_cjs.isString(value)) {
       errors.push(
-        `- Invalid parameter: "${key}" must be of type \`string\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
+        `- Invalid parameter: "${key}" must be of type \`string\`, but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
           value
         )}\`.`
       );
       continue;
     }
-    if (chunkNREACG6M_cjs.isEmptyString(value)) {
+    if (chunkFWWPEL7J_cjs.isEmptyString(value)) {
       errors.push(`- Parameter "${key}" cannot be empty string.`);
       continue;
     }
@@ -97,14 +100,14 @@ function generateRoute(route, params) {
       );
     }
   }
-  if (chunkF3WBQKRI_cjs.isNonEmptyArray(errors)) {
+  if (chunk7C7TQC5J_cjs.isNonEmptyArray(errors)) {
     throw new Error(
       `\u274C 'generateRoute' Failed cause in route "${route}":
 ${errors.join("\n")}.`
     );
   }
   return route.replace(/\[(\w+)\]/g, (_, key) => {
-    const paramKey = chunkF3WBQKRI_cjs.isNonEmptyString(params[key]) ? params[key] : "";
+    const paramKey = chunk7C7TQC5J_cjs.isNonEmptyString(params[key]) ? params[key] : "";
     return paramKey.trim().replace(/^\/+|\/+$/g, "");
   }).replace(/\/+/g, "/");
 }
@@ -115,40 +118,40 @@ var createBeApiUrl = (pathname, options = {}) => {
       return `${a.replace(/\/+$/, "")}/${b.replace(/^\/+/, "")}`;
     };
     var joinPath = joinPath2;
-    chunkK63WO3XA_cjs.assertIsString(chunkF3WBQKRI_cjs.isNil(pathname) ? "" : pathname, {
+    chunkWKM6UVMG_cjs.assertIsString(chunk7C7TQC5J_cjs.isNil(pathname) ? "" : pathname, {
       message({ currentType, validType }) {
         return `First parameter (\`pathname\`) must be of type \`${validType}\`, but received: \`${currentType}\`.`;
       }
     });
-    if (!chunkF3WBQKRI_cjs.isPlainObject(options)) {
+    if (!chunk7C7TQC5J_cjs.isPlainObject(options)) {
       options = {};
     }
     let {
       prefix = "/api",
       withOrigin = true
     } = options;
-    if (!chunkF3WBQKRI_cjs.isUndefined(prefix) && !chunkF3WBQKRI_cjs.isString(prefix)) {
+    if (!chunk7C7TQC5J_cjs.isUndefined(prefix) && !chunk7C7TQC5J_cjs.isString(prefix)) {
       throw new TypeError(
-        `Parameter \`prefix\` property of the \`options\` (second parameter) must be of type \`string\`, but received: \`${chunkF3WBQKRI_cjs.getPreciseType(
+        `Parameter \`prefix\` property of the \`options\` (second parameter) must be of type \`string\`, but received: \`${chunk7C7TQC5J_cjs.getPreciseType(
           prefix
         )}\`.`
       );
     }
-    chunkF3WBQKRI_cjs.assertIsBoolean(withOrigin, {
+    chunk7C7TQC5J_cjs.assertIsBoolean(withOrigin, {
       message: ({ currentType, validType }) => `Parameter \`withOrigin\` property of the \`options\` (second parameter) must be of type \`${validType}\`, but received: \`${currentType}\`.`
     });
-    pathname = chunkBG3AS5BU_cjs.normalizePathname(pathname);
-    prefix = chunkBG3AS5BU_cjs.normalizePathname(prefix);
+    pathname = chunkOCTHWEZK_cjs.normalizePathname(pathname);
+    prefix = chunkOCTHWEZK_cjs.normalizePathname(prefix);
     const normalizedPrefix = prefix.endsWith("/") ? prefix : prefix + "/";
     if (pathname === prefix || pathname === prefix + "/" || pathname.startsWith(normalizedPrefix)) {
       pathname = pathname.slice(prefix.length);
-      pathname = chunkBG3AS5BU_cjs.normalizePathname(pathname);
+      pathname = chunkOCTHWEZK_cjs.normalizePathname(pathname);
     }
     const baseApiUrl = getBeApiUrl({ suffix: prefix });
     const fullPath = withOrigin ? joinPath2(baseApiUrl, pathname) : joinPath2(new URL(baseApiUrl).pathname, pathname);
     return fullPath.replace(/\/+$/, "");
   } catch (err) {
-    if (chunkF3WBQKRI_cjs.isError(err)) {
+    if (chunk7C7TQC5J_cjs.isError(err)) {
       throw err;
     } else
       throw new Error(
@@ -158,9 +161,9 @@ var createBeApiUrl = (pathname, options = {}) => {
 };
 
 var getBeApiUrl = (options = {}) => {
-  if (!chunkF3WBQKRI_cjs.isPlainObject(options)) options = {};
-  let suffix = chunkF3WBQKRI_cjs.hasOwnProp(options, "suffix") ? options.suffix : "/";
-  chunkK63WO3XA_cjs.assertIsString(suffix, {
+  if (!chunk7C7TQC5J_cjs.isPlainObject(options)) options = {};
+  let suffix = chunk7C7TQC5J_cjs.hasOwnProp(options, "suffix") ? options.suffix : "/";
+  chunkWKM6UVMG_cjs.assertIsString(suffix, {
     message({ currentType, validType }) {
       return `Parameter \`suffix\` property of the first parameter must be of type \`${validType}\`, but received: \`${currentType}\`.`;
     }
@@ -168,20 +171,20 @@ var getBeApiUrl = (options = {}) => {
   try {
     let rawBaseUrl = process.env.NEXT_PUBLIC_BACKEND_API_URL?.trim();
     if (rawBaseUrl) {
-      rawBaseUrl = chunkLIU4S3JA_cjs.removeSpaces(rawBaseUrl);
+      rawBaseUrl = chunkIX6PF5ZP_cjs.removeSpaces(rawBaseUrl);
       const urlObj = new URL(rawBaseUrl);
       const hasPort = !!urlObj.port;
       if (!hasPort && process.env.NEXT_PUBLIC_PORT_BE) {
-        rawBaseUrl = urlObj.origin + chunkBG3AS5BU_cjs.formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE, {
+        rawBaseUrl = urlObj.origin + chunkOCTHWEZK_cjs.formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE, {
           prefixColon: true
         });
       }
     } else {
-      rawBaseUrl = "http://localhost" + chunkBG3AS5BU_cjs.formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE || "8000", {
+      rawBaseUrl = "http://localhost" + chunkOCTHWEZK_cjs.formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE || "8000", {
         prefixColon: true
       });
     }
-    suffix = chunkLIU4S3JA_cjs.removeSpaces(suffix).length ? chunkLIU4S3JA_cjs.removeSpaces(suffix) : "/";
+    suffix = chunkIX6PF5ZP_cjs.removeSpaces(suffix).length ? chunkIX6PF5ZP_cjs.removeSpaces(suffix) : "/";
     const baseApiUrl = new URL(rawBaseUrl.replace(/\/+$/, "")).origin;
     const finalSuffix = suffix === "/" ? "/" : `${suffix.startsWith("/") ? "" : "/"}${suffix.replace(/\/+$/, "")}`;
     return `${baseApiUrl}${finalSuffix}`;
@@ -197,10 +200,10 @@ var getBaseUrl = () => {
     const baseEnv = process.env.NEXT_PUBLIC_BASE_URL?.trim();
     const portEnv = process.env.NEXT_PUBLIC_PORT_FE?.trim();
     let baseUrl = baseEnv || "http://localhost";
-    baseUrl = chunkLIU4S3JA_cjs.removeSpaces(baseUrl).replace(/\/+$/, "");
+    baseUrl = chunkIX6PF5ZP_cjs.removeSpaces(baseUrl).replace(/\/+$/, "");
     const hasPort = /:\/\/[^/]+:\d+/.test(baseUrl);
     if (!hasPort && portEnv) {
-      baseUrl += chunkBG3AS5BU_cjs.formatEnvPort(portEnv, { prefixColon: true });
+      baseUrl += chunkOCTHWEZK_cjs.formatEnvPort(portEnv, { prefixColon: true });
     } else if (!hasPort && !baseEnv) {
       baseUrl += ":3000";
     }

package/dist/next/index.d.ts

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
@@ -57,10 +57,10 @@ type HasDynamicSegments<T>=T extends`${string}[${string}]${string}`?true:false;t
  * @param {T} route - The route string containing dynamic segments.
  * @param {ExtractRouteParams<T>} [params] - An object containing key-value pairs that match the dynamic segments in the route.
  * @returns {string} The formatted URL with all dynamic segments replaced.
- * @throws {Error} If the route contains dynamic segments but no parameters object is provided.
- * @throws {Error} If a required parameter is missing from the `params` object.
- * @throws {Error} If a parameter value is an empty string.
- * @throws {Error} If any parameter contains invalid characters like `?`, `&`, `=`, `#`, `/`, spaces, `'`, `"`, `(`, `)`, `+`, `;`, `%`, `@`, or `:`, which can cause URL issues.
+ * @throws **{@link Error | `Error`}** if the route contains dynamic segments but no parameters object is provided.
+ * @throws **{@link Error | `Error`}** if a required parameter is missing from the `params` object.
+ * @throws **{@link Error | `Error`}** if a parameter value is an empty string.
+ * @throws **{@link Error | `Error`}** if any parameter contains invalid characters like `?`, `&`, `=`, `#`, `/`, spaces, `'`, `"`, `(`, `)`, `+`, `;`, `%`, `@`, or `:`, which can cause URL issues.
  * @example
  * // Basic usage
  * generateRoute("/user/[id]", { id: "123" });
@@ -115,9 +115,9 @@ withOrigin?:boolean;};
  * @param {OptionsCreateBeApiUrl["prefix"]} [options.prefix="/api"] - The prefix for the API path (default is `"/api"`).
  * @param {OptionsCreateBeApiUrl["withOrigin"]} [options.withOrigin=true] - Whether to include the full base URL or return only the API path.
  * @returns {string} The formatted API URL.
- * @throws {TypeError} If `withOrigin` is not a boolean.
- * @throws {TypeError} If `prefix` and `pathname` is not a string.
- * @throws {Error} If constructing the API URL fails due to an invalid base URL.
+ * @throws **{@link TypeError | `TypeError`}** if `withOrigin` is not a boolean.
+ * @throws **{@link TypeError | `TypeError`}** if `prefix` and `pathname` is not a string.
+ * @throws **{@link Error | `Error`}** if constructing the API URL fails due to an invalid base URL.
  * @example
  * createBeApiUrl("/users")
  * // ➔ "http://localhost:8000/api/users"
@@ -163,8 +163,8 @@ suffix?:string;};
  * @param {OptionsGetBeApiUrl|undefined} options - Configuration options.
  * @param {OptionsGetBeApiUrl["suffix"]} [options.suffix="/"] - The suffix to append to the base API URL.
  * @returns {string} The formatted backend API base URL.
- * @throws {TypeError} If `suffix` is not a `string`.
- * @throws {Error} If `NEXT_PUBLIC_BACKEND_API_URL` is invalid.
+ * @throws **{@link TypeError | `TypeError`}** if `suffix` is not a `string`.
+ * @throws **{@link Error | `Error`}** if `NEXT_PUBLIC_BACKEND_API_URL` is invalid.
  * @example
  * // With NEXT_PUBLIC_BACKEND_API_URL set at `*.env` file
  * NEXT_PUBLIC_BACKEND_API_URL = "https://api.example.com";
@@ -195,7 +195,7 @@ declare const getBeApiUrl:(options?:OptionsGetBeApiUrl)=>string;
  * - ***⚠️ Warning:***
  *    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***
  * @returns {string} The resolved base URL of the application.
- * @throws {Error} If the constructed URL is invalid or malformed.
+ * @throws **{@link Error | `Error`}** if the constructed URL is invalid or malformed.
  * @example
  * // With environment variable set at `*.env` file
  * NEXT_PUBLIC_BASE_URL = "https://example.com";

package/dist/next/index.js

@@ -2,19 +2,20 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-import { normalizePathname, formatEnvPort } from '../chunk-WNO3EPYT.js';
-import '../chunk-YS27V6LS.js';
-import { removeSpaces } from '../chunk-4ACKNPL5.js';
-import { isEmptyString } from '../chunk-JY4HLZ4W.js';
-import { assertIsString } from '../chunk-FI76UZRF.js';
-import { safeStableStringify } from '../chunk-2VO2CBTU.js';
+import { normalizePathname, formatEnvPort } from '../chunk-R2DR7SPJ.js';
+import '../chunk-3LE6NX57.js';
+import '../chunk-GKDSBOYE.js';
+import { removeSpaces } from '../chunk-5KDVIEVO.js';
+import { isEmptyString } from '../chunk-5O66AUEC.js';
+import { assertIsString } from '../chunk-OSSFLQDD.js';
+import { safeStableStringify } from '../chunk-X6ULJZ3X.js';
 import '../chunk-QNKGP5DY.js';
-import { isString, getPreciseType, assertIsPlainObject, isNil, isNonEmptyArray, isNonEmptyString, isPlainObject, isUndefined, assertIsBoolean, isError, hasOwnProp } from '../chunk-3KTD3QDI.js';
+import { isString, getPreciseType, assertIsPlainObject, isNil, isNonEmptyArray, isNonEmptyString, isPlainObject, isUndefined, assertIsBoolean, isError, hasOwnProp } from '../chunk-J4TT33ZX.js';
 
 function generateRoute(route, params) {
   if (!isString(route) || isEmptyString(route)) {
@@ -23,7 +24,9 @@ function generateRoute(route, params) {
 - Invalid 'route' value.
 - Must be of type \`string\` and non-empty string, but received: "${getPreciseType(
         route
-      )}": \`${safeStableStringify(route)}\`.`
+      )}": \`${safeStableStringify(route, {
+        keepUndefined: true
+      })}\`.`
     );
   }
   if (!/[\\[\]]/.test(route)) {

package/dist/next/server/index.cjs

@@ -2,19 +2,19 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunkF3WBQKRI_cjs = require('../../chunk-F3WBQKRI.cjs');
+var chunk7C7TQC5J_cjs = require('../../chunk-7C7TQC5J.cjs');
 require('server-only');
 var server = require('next/server');
 
 var getClientIpOrUrl = (request, includeFullUrl = true) => {
-  if (!chunkF3WBQKRI_cjs.isFunction(server.NextRequest)) {
+  if (!chunk7C7TQC5J_cjs.isFunction(server.NextRequest)) {
     throw new Error(
       "Function `getClientIpOrUrl` is designed to be used in a `NextJS` environment."
     );
@@ -24,7 +24,7 @@ var getClientIpOrUrl = (request, includeFullUrl = true) => {
       "First parameter (`request`) must be an `instance of NextRequest` from `NextJS`."
     );
   }
-  chunkF3WBQKRI_cjs.assertIsBoolean(includeFullUrl, {
+  chunk7C7TQC5J_cjs.assertIsBoolean(includeFullUrl, {
     message: ({ currentType, validType }) => `Second parameter (\`includeFullUrl\`) must be of type \`${validType}\`, but received: \`${currentType}\`.`
   });
   const forwardedIps = (request.headers.get("x-forwarded-for") ?? "127.0.0.1").trim().split(",");

package/dist/next/server/index.d.ts

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
@@ -14,12 +14,12 @@ import{NextRequest}from'next/server';
  * **Retrieves the real client IP address and constructs the full URL using headers like `x-forwarded-for`, `x-forwarded-proto`, and `x-forwarded-port`.**
  * - **ℹ️ Note:**
  *    - Only supported in **Next.js** environments (specifically in `server-only` contexts).
- *    - Should be used in **middleware** or **server actions** that have access to ***[`NextRequest - NextJS`](https://nextjs.org/docs/app/api-reference/functions/next-request)***.
+ *    - Should be used in **middleware**, **route-handler** or **server actions** that have access to ***[`NextRequest - NextJS`](https://nextjs.org/docs/app/api-reference/functions/next-request)***.
  * @param {NextRequest} request - The incoming ***`NextJS`*** request object, must be instanceof `NextRequest` from `next/server`.
  * @param {boolean|undefined} [includeFullUrl=true] - Whether to return the full URL (`protocol`, `IP`, and `port` like `protocol://ip:port`) or just the IP address, defaultValue: `true`.
  * @returns {string} The extracted client IP address or the full constructed URL.
- * @throws {Error} If the function is used outside a Next.js server environment.
- * @throws {TypeError} If the arguments do not match the expected types.
+ * @throws **{@link Error | `Error`}** if the function is used outside a Next.js server environment.
+ * @throws **{@link TypeError | `TypeError`}** if the arguments do not match the expected types.
  * @example
  * // Basic usage in Next.js middleware
  * import { NextRequest } from "next/server";

package/dist/next/server/index.js

@@ -2,12 +2,12 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-import { isFunction, assertIsBoolean } from '../../chunk-3KTD3QDI.js';
+import { isFunction, assertIsBoolean } from '../../chunk-J4TT33ZX.js';
 import 'server-only';
 import { NextRequest } from 'next/server';
 

package/dist/operations/index.cjs

@@ -2,32 +2,32 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunkRMJC3B5P_cjs = require('../chunk-RMJC3B5P.cjs');
-require('../chunk-66WLOZOD.cjs');
-require('../chunk-7QQV66RX.cjs');
-require('../chunk-ATLFMKAF.cjs');
-require('../chunk-7WBMA2VE.cjs');
+var chunkYQHJB7KR_cjs = require('../chunk-YQHJB7KR.cjs');
+require('../chunk-KUVRZ2JW.cjs');
+require('../chunk-TJ5OY6MC.cjs');
+require('../chunk-NAOVH4OH.cjs');
+require('../chunk-OYFUBKEG.cjs');
 require('../chunk-BAV5T2E3.cjs');
-require('../chunk-YC7AK3KX.cjs');
+require('../chunk-H44QVAZL.cjs');
 require('../chunk-UDA26MCU.cjs');
-require('../chunk-F3WBQKRI.cjs');
+require('../chunk-7C7TQC5J.cjs');
 
 Object.defineProperty(exports, "findDuplicates", {
   enumerable: true,
-  get: function () { return chunkRMJC3B5P_cjs.findDuplicates; }
+  get: function () { return chunkYQHJB7KR_cjs.findDuplicates; }
 });
 Object.defineProperty(exports, "omitKeys", {
   enumerable: true,
-  get: function () { return chunkRMJC3B5P_cjs.omitKeys; }
+  get: function () { return chunkYQHJB7KR_cjs.omitKeys; }
 });
 Object.defineProperty(exports, "omitKeysDeep", {
   enumerable: true,
-  get: function () { return chunkRMJC3B5P_cjs.omitKeysDeep; }
+  get: function () { return chunkYQHJB7KR_cjs.omitKeysDeep; }
 });

package/dist/operations/index.d.ts

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
@@ -13,7 +13,7 @@ import{NumberRangeUnion}from'@rzl-zone/ts-types-plus';
  * ----------------------------------------------------------------------
  * **Finds duplicate values in an array by deep equality comparison.**
  * - **Behavior:**
- *    - Uses ***{@link isEqual | `isEqual`}*** to compare elements
+ *    - Uses ***`isEqual` utility function*** to compare elements
  *      (handles objects, arrays, dates, NaN, etc.).
  *    - Returns a new array containing only the *first occurrences* of duplicated values.
  *    - Does **not mutate** the original array.
@@ -22,7 +22,7 @@ import{NumberRangeUnion}from'@rzl-zone/ts-types-plus';
  * @param {T[]} values - The array to check for duplicates.
  * @returns {T[]} An array of the duplicate values found in the input,
  *                preserving order of their first duplicate appearance.
- * @throws {TypeError} If the provided `values` argument is not an array.
+ * @throws **{@link TypeError | `TypeError`}** if the provided `values` argument is not an array.
  * @example
  * findDuplicates([1, 2, 2, 3, 4, 4]);
  * // ➔ [2, 4]
@@ -47,15 +47,15 @@ declare const findDuplicates:<T>(values:T[])=>T[];
  *    - It will return a new object without mutating the original.
  *    - It also validates that ***`keysToOmit`*** does not contain duplicate keys.
  * - **ℹ️ Internally:**
- *    - It uses ***{@link isEqual | `isEqual`}*** to check for duplicates in
+ *    - It uses ***`isEqual`*** to check for duplicates in
  *      the ***`keysToOmit`*** array.
  * @template I The type of the input object.
  * @template K The keys to omit from the object.
  * @param {I} object - The source object to omit keys from.
  * @param {K[]} keysToOmit - An array of keys to exclude from the returned object.
  * @returns {Omit<I, K>} A new object without the specified keys.
- * @throws {TypeError} If `keysToOmit` is not an array.
- * @throws {Error} If duplicate keys are found in `keysToOmit`.
+ * @throws **{@link TypeError | `TypeError`}** if `keysToOmit` is not an array.
+ * @throws **{@link Error | `Error`}** if duplicate keys are found in `keysToOmit`.
  * @example
  * omitKeys({ a: 1, b: 2, c: 3 }, ["b", "c"]);
  * //➔ { a: 1 }
@@ -90,9 +90,8 @@ declare const omitKeys:<I extends Record<string,unknown>,K extends keyof I>(obje
  * @returns {Partial<I>}
  *  A new deeply cloned object with the specified keys omitted, with resulting
  *  empty objects or arrays fully removed (even if it collapses to `{}`).
- * @throws {TypeError}
- *    If `keysToOmit` is not an array will throw TypeError.
- * @throws {Error} If `keysToOmit` contains duplicate paths will throw Error.
+ * @throws **{@link TypeError | `TypeError`}** if `keysToOmit` is not an array.
+ * @throws **{@link Error | `Error`}** if `keysToOmit` contains duplicate paths.
  * @example
  * omitKeysDeep({ arr: [{ a: 1 }] }, ["arr.0.a"]);
  * // ➔ {} (array becomes empty and removed)

package/dist/operations/index.js

@@ -2,17 +2,17 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-export { findDuplicates, omitKeys, omitKeysDeep } from '../chunk-D53CE4BT.js';
-import '../chunk-XFTUHS4Y.js';
-import '../chunk-SZJ7OI4S.js';
-import '../chunk-VCVND6CH.js';
-import '../chunk-6WMB5AJR.js';
+export { findDuplicates, omitKeys, omitKeysDeep } from '../chunk-SRWL4YCP.js';
+import '../chunk-DXPM4NOU.js';
+import '../chunk-J6VLFVIL.js';
+import '../chunk-M5QB2GM5.js';
+import '../chunk-TXOVQZPU.js';
 import '../chunk-YWHHVDT4.js';
-import '../chunk-2VO2CBTU.js';
+import '../chunk-X6ULJZ3X.js';
 import '../chunk-QNKGP5DY.js';
-import '../chunk-3KTD3QDI.js';
+import '../chunk-J4TT33ZX.js';

package/dist/parsers/index.cjs

@@ -2,17 +2,19 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.9.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunkQAPYHLHC_cjs = require('../chunk-QAPYHLHC.cjs');
-require('../chunk-F3WBQKRI.cjs');
+var chunkVCYXNIZ2_cjs = require('../chunk-VCYXNIZ2.cjs');
+require('../chunk-ZTHJQJ5F.cjs');
+require('../chunk-WKM6UVMG.cjs');
+require('../chunk-7C7TQC5J.cjs');
 
 Object.defineProperty(exports, "extractFileName", {
   enumerable: true,
-  get: function () { return chunkQAPYHLHC_cjs.extractFileName; }
+  get: function () { return chunkVCYXNIZ2_cjs.extractFileName; }
 });