@rzl-zone/utils-js 3.10.0 → 3.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (122) hide show
  1. package/README.md +36 -18
  2. package/dist/assertions/index.cjs +11 -11
  3. package/dist/assertions/index.d.ts +487 -215
  4. package/dist/assertions/index.js +5 -5
  5. package/dist/{chunk-SN5HAK3Y.js → chunk-22V4WP3H.js} +4 -4
  6. package/dist/{chunk-EJV5AF4L.js → chunk-2XSZ2ANI.js} +2 -2
  7. package/dist/{chunk-OSSFLQDD.js → chunk-3T6VSWYX.js} +2 -2
  8. package/dist/{chunk-3LE6NX57.js → chunk-5WIEDF2J.js} +4 -4
  9. package/dist/{chunk-WLEZ2KSG.cjs → chunk-6EDFZJZ5.cjs} +126 -126
  10. package/dist/{chunk-GHU356XQ.js → chunk-6LXWT2I5.js} +3 -3
  11. package/dist/{chunk-GKDSBOYE.js → chunk-6YGBRENU.js} +3 -3
  12. package/dist/{chunk-NAOVH4OH.cjs → chunk-7FGNVDEV.cjs} +7 -7
  13. package/dist/{chunk-X6ULJZ3X.js → chunk-AXDYWO67.js} +2 -2
  14. package/dist/{chunk-UV5BKAYW.cjs → chunk-B6PMNZ4M.cjs} +7 -7
  15. package/dist/chunk-BAV5T2E3.cjs +1 -1
  16. package/dist/{chunk-YHFRCVTN.js → chunk-BLF7SD66.js} +3 -3
  17. package/dist/{chunk-QZI5PVCI.cjs → chunk-BMZZXZJ2.cjs} +4 -4
  18. package/dist/{chunk-DXPM4NOU.js → chunk-BOYP3ARU.js} +4 -4
  19. package/dist/{chunk-UXT4XSUK.js → chunk-BPYW5YL7.js} +2 -2
  20. package/dist/{chunk-QGTFQ7RO.cjs → chunk-C2PV3VWC.cjs} +6 -6
  21. package/dist/{chunk-MZ3T6L7Z.js → chunk-CCJ2MSN7.js} +2 -2
  22. package/dist/{chunk-H44QVAZL.cjs → chunk-DAPAK2W3.cjs} +31 -31
  23. package/dist/{chunk-OYFUBKEG.cjs → chunk-DLS3G6WQ.cjs} +4 -4
  24. package/dist/{chunk-MS2KSKD7.js → chunk-DNMCR5JH.js} +9 -9
  25. package/dist/chunk-DVMHRLKP.cjs +1 -1
  26. package/dist/{chunk-IX6PF5ZP.cjs → chunk-EBYFYZW4.cjs} +4 -4
  27. package/dist/{chunk-5Y6JL47L.js → chunk-ENMRZ4BE.js} +3 -3
  28. package/dist/{chunk-7EIFPHV3.js → chunk-FJ4BQFVO.js} +8 -8
  29. package/dist/{chunk-TJ5OY6MC.cjs → chunk-GIKL4PUF.cjs} +10 -10
  30. package/dist/{chunk-M5QB2GM5.js → chunk-GOFINGT6.js} +2 -2
  31. package/dist/{chunk-J6VLFVIL.js → chunk-GXKQ3LHF.js} +3 -3
  32. package/dist/{chunk-5KDVIEVO.js → chunk-HNBRGN4R.js} +2 -2
  33. package/dist/{chunk-OCTHWEZK.cjs → chunk-HYN6FC5A.cjs} +34 -34
  34. package/dist/{chunk-MBFVTGYS.js → chunk-IZGVBYFN.js} +4 -4
  35. package/dist/{chunk-QXTJVDWE.js → chunk-JIE447J5.js} +3 -3
  36. package/dist/{chunk-UFYMRRJH.cjs → chunk-JXEIJM5M.cjs} +61 -61
  37. package/dist/{chunk-WB3FT62A.js → chunk-K47GZDBH.js} +3 -3
  38. package/dist/{chunk-KUVRZ2JW.cjs → chunk-K5536YHG.cjs} +50 -50
  39. package/dist/chunk-KHO2SBNA.cjs +1 -1
  40. package/dist/{chunk-NJ24M6ZH.cjs → chunk-KXJ7X325.cjs} +37 -37
  41. package/dist/chunk-L5RDAVVH.js +1 -1
  42. package/dist/{chunk-SRWL4YCP.js → chunk-LJHPTLWB.js} +7 -7
  43. package/dist/{chunk-6AMDHVS2.cjs → chunk-M7ELWZXM.cjs} +9 -9
  44. package/dist/chunk-MSUW5VHZ.js +1590 -0
  45. package/dist/{chunk-2XGQQZ6A.cjs → chunk-MUHRPRR7.cjs} +3 -3
  46. package/dist/{chunk-XYWC4EQ3.cjs → chunk-MV3TSQSH.cjs} +71 -71
  47. package/dist/{chunk-VCYXNIZ2.cjs → chunk-NLZLXWAU.cjs} +9 -9
  48. package/dist/{chunk-76ATVDCR.cjs → chunk-NVRZPF5M.cjs} +3 -3
  49. package/dist/chunk-ONZFBJVW.js +1 -1
  50. package/dist/{chunk-62FS7WMB.cjs → chunk-PGNL7JXO.cjs} +31 -31
  51. package/dist/{chunk-JI57K7D4.cjs → chunk-Q4GEQS7X.cjs} +161 -161
  52. package/dist/chunk-QNKGP5DY.js +1 -1
  53. package/dist/{chunk-ZTHJQJ5F.cjs → chunk-QYI2VJLS.cjs} +9 -9
  54. package/dist/{chunk-C7GC2PFX.js → chunk-RBWZII5I.js} +3 -3
  55. package/dist/{chunk-MMRHKYT6.cjs → chunk-RMP7VMPB.cjs} +12 -12
  56. package/dist/{chunk-TXOVQZPU.js → chunk-RZOGBYIS.js} +2 -2
  57. package/dist/{chunk-ALRISPTL.cjs → chunk-SU3UELUB.cjs} +3 -3
  58. package/dist/chunk-SYHPSOUU.cjs +1626 -0
  59. package/dist/{chunk-R2DR7SPJ.js → chunk-SZUNAEMR.js} +6 -6
  60. package/dist/{chunk-YVRUY4EW.cjs → chunk-TER22LO4.cjs} +8 -8
  61. package/dist/{chunk-WRGN6UBK.js → chunk-TJHGRQ4P.js} +2 -2
  62. package/dist/{chunk-I33PB44Q.cjs → chunk-U23I7JPB.cjs} +15 -15
  63. package/dist/{chunk-VBSLIIDB.js → chunk-U7HHN47R.js} +10 -10
  64. package/dist/chunk-UDA26MCU.cjs +1 -1
  65. package/dist/{chunk-44X74C26.js → chunk-UIAWUZ4H.js} +4 -4
  66. package/dist/{chunk-5O66AUEC.js → chunk-ULQPCIA2.js} +2 -2
  67. package/dist/chunk-VJDDGRIK.cjs +1 -1
  68. package/dist/{chunk-6WVOUVWD.js → chunk-WETQI6HM.js} +9 -9
  69. package/dist/{chunk-FWWPEL7J.cjs → chunk-WLOQQFDS.cjs} +3 -3
  70. package/dist/chunk-WVSPXFTY.js +1 -1
  71. package/dist/{chunk-WKM6UVMG.cjs → chunk-WXFTVXBF.cjs} +4 -4
  72. package/dist/{chunk-YQHJB7KR.cjs → chunk-XPVTIGU2.cjs} +26 -26
  73. package/dist/{chunk-PWKOFPAH.cjs → chunk-XX6RUGTM.cjs} +3 -3
  74. package/dist/chunk-YWHHVDT4.js +1 -1
  75. package/dist/{chunk-7NXFGJJE.cjs → chunk-ZPDMWDGZ.cjs} +14 -14
  76. package/dist/{chunk-JYOCB6OV.js → chunk-ZVWZEGQP.js} +2 -2
  77. package/dist/conversions/index.cjs +34 -34
  78. package/dist/conversions/index.d.ts +489 -333
  79. package/dist/conversions/index.js +15 -15
  80. package/dist/events/index.cjs +8 -8
  81. package/dist/events/index.d.ts +35 -29
  82. package/dist/events/index.js +4 -4
  83. package/dist/formatters/index.cjs +19 -19
  84. package/dist/formatters/index.d.ts +917 -873
  85. package/dist/formatters/index.js +9 -9
  86. package/dist/generators/index.cjs +9 -9
  87. package/dist/generators/index.d.ts +104 -86
  88. package/dist/generators/index.js +4 -4
  89. package/dist/index.d.ts +1 -1
  90. package/dist/isPlainObject-0p3VveWr.d.ts +534 -0
  91. package/dist/next/index.cjs +37 -37
  92. package/dist/next/index.d.ts +36 -21
  93. package/dist/next/index.js +9 -9
  94. package/dist/next/server/index.cjs +4 -4
  95. package/dist/next/server/index.d.ts +6 -3
  96. package/dist/next/server/index.js +2 -2
  97. package/dist/operations/index.cjs +11 -11
  98. package/dist/operations/index.d.ts +14 -5
  99. package/dist/operations/index.js +8 -8
  100. package/dist/parsers/index.cjs +6 -6
  101. package/dist/parsers/index.d.ts +68 -65
  102. package/dist/parsers/index.js +5 -5
  103. package/dist/predicates/index.cjs +77 -77
  104. package/dist/predicates/index.d.ts +442 -258
  105. package/dist/predicates/index.js +14 -14
  106. package/dist/promises/index.cjs +6 -6
  107. package/dist/promises/index.d.ts +28 -16
  108. package/dist/promises/index.js +4 -4
  109. package/dist/rzl-utils.global.js +2 -2
  110. package/dist/strings/index.cjs +23 -23
  111. package/dist/strings/index.d.ts +82 -54
  112. package/dist/strings/index.js +7 -7
  113. package/dist/tailwind/index.cjs +13 -13
  114. package/dist/tailwind/index.d.ts +186 -169
  115. package/dist/tailwind/index.js +5 -5
  116. package/dist/urls/index.cjs +23 -23
  117. package/dist/urls/index.d.ts +252 -229
  118. package/dist/urls/index.js +16 -16
  119. package/package.json +2 -2
  120. package/dist/chunk-7C7TQC5J.cjs +0 -620
  121. package/dist/chunk-J4TT33ZX.js +0 -584
  122. package/dist/isPlainObject-BTPjv6zB.d.ts +0 -178
package/README.md CHANGED
@@ -4,12 +4,14 @@
4
4
  </a>
5
5
  </div>
6
6
 
7
- <h1 align="center"><strong>Utils JS (Rzl Zone)</strong></h1>
7
+ <h1 align="center"><strong>UtilsJS</strong></h1>
8
8
 
9
9
  <p align="center">
10
- <i>A lightweight, modern TypeScript utility library for Node.js & browser (via bundlers like Webpack/Vite).</i><br/>
10
+ <i>
11
+ 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>).
12
+ </i><br/>
11
13
  <i>Provides reusable helpers to simplify your JavaScript or TypeScript projects.</i><br/>
12
- <strong><i>Built with ❤️ by <a href="https://github.com/rzl-app" target="_blank" rel="nofollow noreferrer noopener">@rzl-app</a>.</i></strong>
14
+ <strong><i>Built with ❤️ by <a href="https://github.com/rzl-zone" target="_blank" rel="nofollow noreferrer noopener">@rzl-zone</a>.</i></strong>
13
15
  </p>
14
16
 
15
17
  <div align="center">
@@ -52,7 +54,7 @@
52
54
  - ✨ [Features](#features)
53
55
  - 🧬 [NextJS Support](#nextjs-support)
54
56
  - 💎 [Detailed Features](#detailed-features)
55
- - [Full documentation](#detailed-features--full-documentation)
57
+ - [Full Documentation](#detailed-features--full-documentation)
56
58
  - [CDN Usage](#detailed-features--cdn-usage)
57
59
  - [Hint Autocomplete](#detailed-features--hint-autocomplete-setup)
58
60
  - 🔥 [Usage](#usage)
@@ -70,19 +72,22 @@
70
72
  - **Node.js `≥18.18.0`**
71
73
  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.
72
74
  - 🔗 See official Next.js documentation:
73
- <a href="https://nextjs.org/docs/getting-started/installation#system-requirements" target="_blank" rel="nofollow noreferrer noopener"><i>NextJS Installation Requirements</i></a>.
75
+ <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>.
74
76
 
75
77
  - **Works with:**
76
78
  - ✅ Node.js (18.18.0+) - ***Without NextJS***.
77
79
  - ✅ Node.js (20.9.0, or higher depending on NextJS version) - ***With NextJS***.
78
- - ✅ Modern browsers (via bundlers like Webpack / Vite).
80
+ - ✅ Modern browsers (via bundlers like [`Webpack`](https://webpack.js.org), [`Turbopack`](https://vercel.com/blog/turbopack), or [`Vite`](https://vite.dev)).
79
81
 
80
82
  - **TypeScript Build Info:**
81
83
  - Target: `ES2022`
82
84
  - Module: `ES2022`
83
85
  - Module Resolution: `bundler`
84
86
 
85
- > ℹ️ 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.
87
+ <br/>
88
+
89
+ > ℹ️ Note:
90
+ > 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.
86
91
 
87
92
  ---
88
93
 
@@ -121,21 +126,21 @@ pnpm add @rzl-zone/utils-js@latest
121
126
 
122
127
  **This package also provides utilities specially built for Next.js environments, neatly separated into their own entry points:**
123
128
 
124
- - <h3 id="nextjs-support--globals">`@rzl-zone/utils-js/next`</h3>
129
+ - <h4 id="nextjs-support--globals"><strong><code>@rzl-zone/utils-js/next</code></strong></h4>
125
130
  Helpers for building URLs, generating dynamic routes, reading environment variables, etc.
126
131
 
127
132
  ✅ Safe to use in both Next.js pages & API routes.
128
133
 
129
- [Read More Docs](/docs/next-js/global.md#docs-sub-main--title)
134
+ [**Read More Docs**](/docs/next-js/global.md#docs-sub-main--title)
130
135
 
131
136
  ***
132
137
 
133
- - <h3 id="nextjs-support--server-only">`@rzl-zone/utils-js/next/server`</h3>
138
+ - <h4 id="nextjs-support--server-only"><strong><code>@rzl-zone/utils-js/next/server</code></strong></h4>
134
139
  Utilities meant to run in Next.js server-only contexts (like middleware or server actions) for tasks such as extracting real client IPs.
135
140
 
136
141
  > ⚠️ Will throw Error if used outside a ***Next.js* server environment**.
137
142
 
138
- [Read More Docs](/docs/next-js/server-only.md#docs-sub-main--title)
143
+ [**Read More Docs**](/docs/next-js/server-only.md#docs-sub-main--title)
139
144
 
140
145
  ---
141
146
 
@@ -143,7 +148,7 @@ pnpm add @rzl-zone/utils-js@latest
143
148
 
144
149
  <h3 id="detailed-features--full-documentation">
145
150
  <strong>
146
- Full documentation <a href="https://rzlzone.vercel.app/docs/utils-js" target="_blank" rel="nofollow noreferrer noopener">Utils JS</a> is
151
+ Full documentation <a href="https://rzlzone.vercel.app/docs/utils-js" target="_blank" rel="nofollow noreferrer noopener">UtilsJS</a> is
147
152
  <strong>currently under construction 🏗️</strong>.
148
153
  </strong>
149
154
  </h3>
@@ -168,7 +173,7 @@ pnpm add @rzl-zone/utils-js@latest
168
173
  ```
169
174
  #### Place your cursor inside { } or after "@rzl-zone/utils-js/{{ | }}" then press Ctrl+Space to see all available functions/types with full TSDoc hints.
170
175
 
171
- > ***⚠️ 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.
176
+ > ***⚠️ 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.
172
177
 
173
178
  ---
174
179
 
@@ -258,10 +263,16 @@ pnpm add @rzl-zone/utils-js@latest
258
263
  {
259
264
  "compilerOptions": {
260
265
  "strict": true,
261
- "typeRoots": ["./types", "./node_modules/@types"],
266
+ "typeRoots": [
267
+ "./types",
268
+ "./node_modules/@types"
269
+ ],
262
270
  // other your config...
263
271
  },
264
- "include": ["src", "types"],
272
+ "include": [
273
+ "src",
274
+ "types"
275
+ ],
265
276
  // other your config...
266
277
  }
267
278
  ```
@@ -277,10 +288,16 @@ pnpm add @rzl-zone/utils-js@latest
277
288
  {
278
289
  "compilerOptions": {
279
290
  "checkJs": true, // Optional, enables type checking
280
- "typeRoots": ["./types", "./node_modules/@types"],
291
+ "typeRoots": [
292
+ "./types",
293
+ "./node_modules/@types"
294
+ ],
281
295
  // other your config...
282
296
  },
283
- "include": ["src", "types"],
297
+ "include": [
298
+ "src",
299
+ "types"
300
+ ],
284
301
  // other your config...
285
302
  }
286
303
  ```
@@ -365,7 +382,8 @@ console.log(isServer());
365
382
 
366
383
  ---
367
384
 
368
- **Enjoy using `@rzl-zone/utils-js`?**
385
+ <h2>✅ <strong>Enjoy using <code>@rzl-zone/utils-js</code>?</strong></h2>
386
+
369
387
  *Star this repo [⭐](https://github.com/rzl-zone/utils-js) and share it with other JavaScript developers!*
370
388
 
371
389
  ---
@@ -2,40 +2,40 @@
2
2
  * ====================================================
3
3
  * Rzl Utils-JS.
4
4
  * ----------------------------------------------------
5
- * Version: 3.10.0.
5
+ * Version: 3.11.0.
6
6
  * Author: Rizalvin Dwiky.
7
7
  * Repository: https://github.com/rzl-zone/utils-js.
8
8
  * ====================================================
9
9
  */
10
10
  'use strict';
11
11
 
12
- var chunkUV5BKAYW_cjs = require('../chunk-UV5BKAYW.cjs');
13
- var chunkWKM6UVMG_cjs = require('../chunk-WKM6UVMG.cjs');
14
- var chunkOYFUBKEG_cjs = require('../chunk-OYFUBKEG.cjs');
12
+ var chunkB6PMNZ4M_cjs = require('../chunk-B6PMNZ4M.cjs');
13
+ var chunkWXFTVXBF_cjs = require('../chunk-WXFTVXBF.cjs');
14
+ var chunkDLS3G6WQ_cjs = require('../chunk-DLS3G6WQ.cjs');
15
15
  require('../chunk-UDA26MCU.cjs');
16
- var chunk7C7TQC5J_cjs = require('../chunk-7C7TQC5J.cjs');
16
+ var chunkSYHPSOUU_cjs = require('../chunk-SYHPSOUU.cjs');
17
17
 
18
18
  Object.defineProperty(exports, "assertIsBigInt", {
19
19
  enumerable: true,
20
- get: function () { return chunkUV5BKAYW_cjs.assertIsBigInt; }
20
+ get: function () { return chunkB6PMNZ4M_cjs.assertIsBigInt; }
21
21
  });
22
22
  Object.defineProperty(exports, "assertIsNumber", {
23
23
  enumerable: true,
24
- get: function () { return chunkUV5BKAYW_cjs.assertIsNumber; }
24
+ get: function () { return chunkB6PMNZ4M_cjs.assertIsNumber; }
25
25
  });
26
26
  Object.defineProperty(exports, "assertIsString", {
27
27
  enumerable: true,
28
- get: function () { return chunkWKM6UVMG_cjs.assertIsString; }
28
+ get: function () { return chunkWXFTVXBF_cjs.assertIsString; }
29
29
  });
30
30
  Object.defineProperty(exports, "assertIsArray", {
31
31
  enumerable: true,
32
- get: function () { return chunkOYFUBKEG_cjs.assertIsArray; }
32
+ get: function () { return chunkDLS3G6WQ_cjs.assertIsArray; }
33
33
  });
34
34
  Object.defineProperty(exports, "assertIsBoolean", {
35
35
  enumerable: true,
36
- get: function () { return chunk7C7TQC5J_cjs.assertIsBoolean; }
36
+ get: function () { return chunkSYHPSOUU_cjs.assertIsBoolean; }
37
37
  });
38
38
  Object.defineProperty(exports, "assertIsPlainObject", {
39
39
  enumerable: true,
40
- get: function () { return chunk7C7TQC5J_cjs.assertIsPlainObject; }
40
+ get: function () { return chunkSYHPSOUU_cjs.assertIsPlainObject; }
41
41
  });