@rzl-zone/utils-js 3.9.1 → 3.11.0

package/README.md

@@ -1,42 +1,46 @@
-<div align="center" style="display: flex; flex-direction: column; align-items: center;gap: 0.25rem">
+<div align="center" style="display: flex; flex-direction: column; align-items: center;gap: 0rem">
   <a target="_blank" rel="noopener noreferrer" href="https://raw.githubusercontent.com/rzl-zone/utils-js/main/logo-circle.png">
     <img src="https://raw.githubusercontent.com/rzl-zone/utils-js/main/logo-circle.png" align="middle" alt="RzlZone Logo" width="110" style="max-width: 100%;">
   </a>
-
-  <h1><strong>⚡️ <code>@rzl-zone/utils-js</code> 🚀</strong></h1>
 </div>
 
-<p align="center">
-🚀 <strong><u>Rzl Utility JS</u></strong> 🚀<br/>
-<i>A lightweight, modern TypeScript utility library for Node.js & browser (via bundlers like Webpack/Vite).</i><br/>
-<i>Provides reusable helpers to simplify your JavaScript or TypeScript projects.</i><br/>
-<strong><i>Built with ❤️ by <a href="https://github.com/rzl-app" target="_blank" rel="nofollow noreferrer noopener">@rzl-app</a>.</i></strong>
+<h1 align="center"><strong>UtilsJS</strong></h1>
+
+<p align="center"> 
+  <i>
+    A lightweight, modern TypeScript utility library for Node.js & browser (via bundlers like <a href="https://webpack.js.org"><code>Webpack</code></a>, <a href="https://vercel.com/blog/turbopack"><code>Turbopack</code></a>, or <a href="https://vite.dev/"><code>Vite</code></a>).
+  </i><br/>
+  <i>Provides reusable helpers to simplify your JavaScript or TypeScript projects.</i><br/>
+  <strong><i>Built with ❤️ by <a href="https://github.com/rzl-zone" target="_blank" rel="nofollow noreferrer noopener">@rzl-zone</a>.</i></strong>
 </p>
 
 <div align="center">
 
 <p>
-<a href="https://npmjs.com/package/@rzl-zone/utils-js" target="_blank" rel="nofollow noreferrer noopener">
-  <img src="https://img.shields.io/npm/v/@rzl-zone/utils-js?color=blue&style=flat-rounded" alt="Latest Version on NPM" data-canonical-src="https://img.shields.io/npm/v/@rzl-zone/utils-js?color=blue&amp;style=flat-rounded">
-</a>
-<a href="https://npmjs.com/package/@rzl-zone/utils-js" target="_blank" rel="nofollow noreferrer noopener">
-  <img src="https://img.shields.io/npm/dt/@rzl-zone/utils-js?style=flat-rounded" alt="Downloads">
-</a>
-<a href="https://nodejs.org/en/" target="_blank" rel="nofollow noreferrer noopener">
-  <img src="https://img.shields.io/badge/node-≥16.0.0-blue.svg?logo=node.js&style=flat-rounded" alt="Node.js">
-</a>
-<a href="https://github.com/rzl-zone/utils-js/blob/main/CONTRIBUTING.md" target="_blank" rel="nofollow noreferrer noopener">
-  <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome">
-</a>
-<a href="https://github.com/rzl-zone/utils-js/blob/main/LICENSE.md" target="_blank" rel="nofollow noreferrer noopener">
-  <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="GitHub license">
-</a>
-<a href="https://github.com/rzl-zone/utils-js" target="_blank" rel="nofollow noreferrer noopener">
-  <img src="https://img.shields.io/badge/GitHub-rzl--zone%2Futils--js-181717?logo=github" alt="GitHub">
-</a>
-<a href="https://github.com/rzl-app" target="_blank" rel="nofollow noreferrer noopener">
-  <img src="https://img.shields.io/badge/Repo-on%20GitHub-181717?logo=github&style=flat-rounded" alt="Repo on GitHub">
-</a>
+  <a href="https://npmjs.com/package/@rzl-zone/utils-js" target="_blank" rel="nofollow noreferrer noopener">
+    <img src="https://img.shields.io/npm/v/@rzl-zone/utils-js?logo=npm&label=Latest%20Version&color=4CAF50&logoColor=CB3837&style=flat-rounded" alt="Latest Version on NPM">
+  </a>
+  <a href="https://npmjs.com/package/@rzl-zone/utils-js" target="_blank" rel="nofollow noreferrer noopener">
+    <img src="https://img.shields.io/npm/dt/@rzl-zone/utils-js?logo=npm&label=Total%20Downloads&color=007EC6&logoColor=CB3837&style=flat-rounded" alt="NPM Total Downloads">
+  </a>
+  <a href="https://npmjs.com/package/@rzl-zone/utils-js" target="_blank" rel="nofollow noreferrer noopener">
+    <img src="https://img.shields.io/npm/dw/@rzl-zone/utils-js?logo=npm&label=Weekly%20Downloads&color=CB3837&logoColor=CB3837&style=flat-rounded" alt="NPM Weekly Downloads">
+  </a>
+  <a href="https://nodejs.org/en/" target="_blank" rel="nofollow noreferrer noopener">
+    <img src="https://img.shields.io/badge/Node.js-18.18.0%2B-green.svg?logo=node.js&color=339933&style=flat-rounded" alt="Node.js">
+  </a>
+  <a href="https://github.com/rzl-zone/utils-js/blob/main/CONTRIBUTING.md" target="_blank" rel="nofollow noreferrer noopener">
+    <img src="https://img.shields.io/badge/PRs-Welcome-brightgreen.svg?color=28A745" alt="PRs Welcome">
+  </a>
+  <a href="https://github.com/rzl-zone/utils-js/blob/main/LICENSE.md" target="_blank" rel="nofollow noreferrer noopener">
+    <img src="https://img.shields.io/badge/License-MIT-blue.svg?color=3DA639" alt="GitHub license">
+  </a>
+  <a href="https://github.com/rzl-zone/utils-js" target="_blank" rel="nofollow noreferrer noopener">
+    <img src="https://img.shields.io/badge/Repo-on%20GitHub-181717?logo=github" alt="GitHub">
+  </a>
+  <a href="https://github.com/orgs/rzl-zone/repositories" target="_blank" rel="nofollow noreferrer noopener">
+    <img src="https://img.shields.io/badge/Org-rzl--zone-24292e?logo=github&style=flat-rounded" alt="Repo on GitHub">
+  </a>
 </p>
 
 </div>
@@ -50,8 +54,9 @@
 - ✨ [Features](#features)
 - 🧬 [NextJS Support](#nextjs-support)
 - 💎 [Detailed Features](#detailed-features)
-  - [Full documentation](#full-documentation-rzl-utilsjs-is-currently-under-construction-%EF%B8%8F)
-  - [Hint Autocomplete](#hint-autocomplete)
+  - [Full Documentation](#detailed-features--full-documentation)
+  - [CDN Usage](#detailed-features--cdn-usage)
+  - [Hint Autocomplete](#detailed-features--hint-autocomplete-setup)
 - 🔥 [Usage](#usage)
 - ❤️ [Sponsor](#sponsor-this-package)
 - 📜 [Changelog](#changelog)
@@ -64,22 +69,25 @@
 
 <h2 id="requirements">💻 <strong>Requirements</strong></h2>
 
-- **Node.js `≥16.0.0`**  
-  This package leverages modern JavaScript & TypeScript features that require Node.js version 16.0.0 if not using Next.js, and for Next.js it must follow the official minimum Node.js version requirement depending on the version you use.  
-  - 🔗 See official Next.js documentation: 
-      <a href="https://nextjs.org/docs/getting-started/installation#system-requirements" target="_blank" rel="nofollow noreferrer noopener"><i>NextJS Installation Requirements.</i></a>
+- **Node.js `≥18.18.0`**  
+  This package leverages modern JavaScript & TypeScript features that require Node.js version 18.18.0 if not using Next.js, and for Next.js it must follow the official minimum Node.js version requirement depending on the version you use.  
+  - 🔗 See official Next.js documentation:
+      <a href="https://nextjs.org/docs/getting-started/installation#system-requirements" target="_blank" rel="nofollow noreferrer noopener"><i><strong>NextJS System Requirements</strong></i></a>.
 
 - **Works with:**
-  - ✅ Node.js (16.0.0+) - Without NextJS
-  - ✅ Node.js (18.17.0, or higher depending on NextJS version) - With NextJS
-  - ✅ Modern browsers (via bundlers like Webpack / Vite)
+  - ✅ Node.js (18.18.0+) - ***Without NextJS***.
+  - ✅ Node.js (20.9.0, or higher depending on NextJS version) - ***With NextJS***.
+  - ✅ Modern browsers (via bundlers like [`Webpack`](https://webpack.js.org), [`Turbopack`](https://vercel.com/blog/turbopack), or [`Vite`](https://vite.dev)).
 
 - **TypeScript Build Info:**
   - Target: `ES2022`
   - Module: `ES2022`
   - Module Resolution: `bundler`
 
-  > ℹ️ Note: These TypeScript settings are used to build the package. Consumers do **not** need to match these settings unless they plan to build or modify the source code.
+  <br/>
+  
+  > ℹ️ Note:  
+  > These TypeScript settings are used to build the package, consumers do **not** need to match these settings unless they plan to build or modify the source code.
 
 ---
 
@@ -88,19 +96,19 @@
 #### *With NPM*
 
 ```bash
-  npm install @rzl-zone/utils-js
+npm install @rzl-zone/utils-js@latest
 ```
 
 #### *With Yarn*
 
 ```bash
-  yarn add @rzl-zone/utils-js
+yarn add @rzl-zone/utils-js@latest
 ```
 
 #### *With PNPM*
 
 ```bash
-  pnpm add @rzl-zone/utils-js
+pnpm add @rzl-zone/utils-js@latest
 ```
 
 ---
@@ -118,27 +126,33 @@
 
 **This package also provides utilities specially built for Next.js environments, neatly separated into their own entry points:**
 
-- <h3 id="nextjs-support--globals">`@rzl-zone/utils-js/next`</h3>  
+- <h4 id="nextjs-support--globals"><strong><code>@rzl-zone/utils-js/next</code></strong></h4>  
   Helpers for building URLs, generating dynamic routes, reading environment variables, etc.   
 
   ✅ Safe to use in both Next.js pages & API routes.
 
-  [Read More Docs](/docs/next-js/global.md#docs-sub-main--title)
+  [**Read More Docs**](/docs/next-js/global.md#docs-sub-main--title)
 
   ***
 
-- <h3 id="nextjs-support--server-only">`@rzl-zone/utils-js/next/server`</h3>   
+- <h4 id="nextjs-support--server-only"><strong><code>@rzl-zone/utils-js/next/server</code></strong></h4>  
   Utilities meant to run in Next.js server-only contexts (like middleware or server actions) for tasks such as extracting real client IPs.  
   
-  ⚠️ Will throw if used outside a Next.js server environment.
+  > ⚠️ Will throw Error if used outside a ***Next.js* server environment**.
 
-  [Read More Docs](/docs/next-js/server-only.md#docs-sub-main--title)
+  [**Read More Docs**](/docs/next-js/server-only.md#docs-sub-main--title)
 
 ---
 
 <h2 id="detailed-features">💎 <strong>Detailed Features</strong></h2>
 
-  ### **Full documentation <a href="https://rzlzone.pages.dev/docs/utils-js" target="_blank" rel="nofollow noreferrer noopener">Rzl UtilsJS</a> is **currently under construction** 🏗️.**
+  <h3 id="detailed-features--full-documentation">
+    <strong>
+      Full documentation <a href="https://rzlzone.vercel.app/docs/utils-js" target="_blank" rel="nofollow noreferrer noopener">UtilsJS</a> is 
+        <strong>currently under construction 🏗️</strong>.
+    </strong>
+  </h3>
+
   #### For now, explore the examples or dive into the source — all utilities are documented via **TSDoc** and typed properly.
   
   ```ts
@@ -159,20 +173,15 @@
   ```
   #### Place your cursor inside { } or after "@rzl-zone/utils-js/{{ | }}" then press Ctrl+Space to see all available functions/types with full TSDoc hints.
 
-  > ***⚠️ 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.
+  > ***⚠️ 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.
+  <h3 id="detailed-features--cdn-usage">
+    <strong>
+      CDN Usage.
+    </strong>
+  </h3>
 
   #### **Including via CDN**
   ```xml
@@ -183,9 +192,21 @@
   <script src="https://unpkg.com/@rzl-zone/utils-js@latest"></script>
   ```
 
+  > ⚠️ **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.
 
   ---
-  ### **Hint: Autocomplete Setup (Step by Step)**
+  <h3 id="detailed-features--hint-autocomplete-setup">
+    <strong>
+      Hint: Autocomplete Setup (Step by Step).
+    </strong>
+  </h3>
 
   #### Make TypeScript & VSCode automatically provide autocomplete for `@rzl-zone/utils-js` without needing triple-slash references in every file:
 
@@ -194,11 +215,11 @@
     - Make sure the package is installed:
 
       ```bash
-      npm install @rzl-zone/utils-js
+      npm install @rzl-zone/utils-js@latest
       # or
-      yarn add @rzl-zone/utils-js
+      yarn add @rzl-zone/utils-js@latest
       # or
-      pnpm add @rzl-zone/utils-js
+      pnpm add @rzl-zone/utils-js@latest
       ```
 
   - 2️⃣ **Create a types folder.**
@@ -220,14 +241,17 @@
 
       ```ts
       /// <reference types="@rzl-zone/utils-js" />
-      ``` 
+      ```
 
       - This tells TypeScript to include the types from `@rzl-zone/utils-js` globally.
       - You can add more references here if needed, for example:
 
       ```ts
-      /// <reference types="node" />
       /// <reference types="@rzl-zone/utils-js" />
+
+      // eg more references (if needed):
+      /// <reference types="node" />
+      /// <reference types="react" />
       ``` 
 
   - 4️⃣ **Update tsconfig.json.**
@@ -238,10 +262,17 @@
       // tsconfig.json
       {
         "compilerOptions": { 
-          "typeRoots": ["./types", "./node_modules/@types"],
+          "strict": true,
+          "typeRoots": [
+            "./types", 
+            "./node_modules/@types"
+          ],
           // other your config...
         },
-        "include": ["src", "types"],
+        "include": [
+          "src", 
+          "types"
+        ],
         // other your config...
       }
       ```
@@ -257,16 +288,22 @@
       {
         "compilerOptions": {
           "checkJs": true,  // Optional, enables type checking 
-          "typeRoots": ["./types", "./node_modules/@types"],
+          "typeRoots": [
+            "./types", 
+            "./node_modules/@types"
+          ],
           // other your config...
         },
-        "include": ["src", "types"],
+        "include": [
+          "src", 
+          "types"
+        ],
         // other your config...
       }
       ```
       >ℹ️ ***Tip:*** *For JS projects, consider adding "checkJs": true for better IntelliSense.*
     
-  **Now, all types from @rzl-zone/utils-js are globally available, and you don’t need "types": ["@rzl-zone/utils-js"] in tsconfig.json.** 
+  #### **Now, all types from `@rzl-zone/utils-js` are globally available, and you don’t need `"types": ["@rzl-zone/utils-js"]` in tsconfig.json.**
 
   <!-- - <h4 id="detailed-features--assertions">
       Assertions - 
@@ -309,7 +346,7 @@ console.log(isServer());
 <h2 id="sponsor-this-package">❤️ <strong>Sponsor this package</strong></h2>
 
 **Help support development:**    
-*[👉 **Become a sponsor**](https://github.com/sponsors/rzl-app)*
+*[👉 **Become a sponsor**](https://github.com/sponsors/rzl-app).*
 
 ---
 
@@ -327,7 +364,7 @@ console.log(isServer());
 
 <h2 id="security">🔒 <strong>Security</strong></h2>
 
-**Please report issues to [rizalvindwiky1998@gmail.com](mailto:rizalvindwiky1998@gmail.com).**
+**Please report issues to [rzlzone.dev@gmail.com](mailto:rzlzone.dev@gmail.com).**
 
 ---
 
@@ -345,7 +382,8 @@ console.log(isServer());
 
 ---
 
-✅ **Enjoy using `@rzl-zone/utils-js`?**  
+<h2>✅ <strong>Enjoy using <code>@rzl-zone/utils-js</code>?</strong></h2>
+
 *Star this repo [⭐](https://github.com/rzl-zone/utils-js) and share it with other JavaScript developers!*
 
 ---

package/dist/assertions/index.cjs

@@ -2,40 +2,40 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.9.1.
+ * Version: 3.11.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunkUV5BKAYW_cjs = require('../chunk-UV5BKAYW.cjs');
-var chunkWKM6UVMG_cjs = require('../chunk-WKM6UVMG.cjs');
-var chunkOYFUBKEG_cjs = require('../chunk-OYFUBKEG.cjs');
+var chunkB6PMNZ4M_cjs = require('../chunk-B6PMNZ4M.cjs');
+var chunkWXFTVXBF_cjs = require('../chunk-WXFTVXBF.cjs');
+var chunkDLS3G6WQ_cjs = require('../chunk-DLS3G6WQ.cjs');
 require('../chunk-UDA26MCU.cjs');
-var chunk7C7TQC5J_cjs = require('../chunk-7C7TQC5J.cjs');
+var chunkSYHPSOUU_cjs = require('../chunk-SYHPSOUU.cjs');
 
 Object.defineProperty(exports, "assertIsBigInt", {
   enumerable: true,
-  get: function () { return chunkUV5BKAYW_cjs.assertIsBigInt; }
+  get: function () { return chunkB6PMNZ4M_cjs.assertIsBigInt; }
 });
 Object.defineProperty(exports, "assertIsNumber", {
   enumerable: true,
-  get: function () { return chunkUV5BKAYW_cjs.assertIsNumber; }
+  get: function () { return chunkB6PMNZ4M_cjs.assertIsNumber; }
 });
 Object.defineProperty(exports, "assertIsString", {
   enumerable: true,
-  get: function () { return chunkWKM6UVMG_cjs.assertIsString; }
+  get: function () { return chunkWXFTVXBF_cjs.assertIsString; }
 });
 Object.defineProperty(exports, "assertIsArray", {
   enumerable: true,
-  get: function () { return chunkOYFUBKEG_cjs.assertIsArray; }
+  get: function () { return chunkDLS3G6WQ_cjs.assertIsArray; }
 });
 Object.defineProperty(exports, "assertIsBoolean", {
   enumerable: true,
-  get: function () { return chunk7C7TQC5J_cjs.assertIsBoolean; }
+  get: function () { return chunkSYHPSOUU_cjs.assertIsBoolean; }
 });
 Object.defineProperty(exports, "assertIsPlainObject", {
   enumerable: true,
-  get: function () { return chunk7C7TQC5J_cjs.assertIsPlainObject; }
+  get: function () { return chunkSYHPSOUU_cjs.assertIsPlainObject; }
 });