@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.
- package/README.md +36 -18
- package/dist/assertions/index.cjs +11 -11
- package/dist/assertions/index.d.ts +487 -215
- package/dist/assertions/index.js +5 -5
- package/dist/{chunk-SN5HAK3Y.js → chunk-22V4WP3H.js} +4 -4
- package/dist/{chunk-EJV5AF4L.js → chunk-2XSZ2ANI.js} +2 -2
- package/dist/{chunk-OSSFLQDD.js → chunk-3T6VSWYX.js} +2 -2
- package/dist/{chunk-3LE6NX57.js → chunk-5WIEDF2J.js} +4 -4
- package/dist/{chunk-WLEZ2KSG.cjs → chunk-6EDFZJZ5.cjs} +126 -126
- package/dist/{chunk-GHU356XQ.js → chunk-6LXWT2I5.js} +3 -3
- package/dist/{chunk-GKDSBOYE.js → chunk-6YGBRENU.js} +3 -3
- package/dist/{chunk-NAOVH4OH.cjs → chunk-7FGNVDEV.cjs} +7 -7
- package/dist/{chunk-X6ULJZ3X.js → chunk-AXDYWO67.js} +2 -2
- package/dist/{chunk-UV5BKAYW.cjs → chunk-B6PMNZ4M.cjs} +7 -7
- package/dist/chunk-BAV5T2E3.cjs +1 -1
- package/dist/{chunk-YHFRCVTN.js → chunk-BLF7SD66.js} +3 -3
- package/dist/{chunk-QZI5PVCI.cjs → chunk-BMZZXZJ2.cjs} +4 -4
- package/dist/{chunk-DXPM4NOU.js → chunk-BOYP3ARU.js} +4 -4
- package/dist/{chunk-UXT4XSUK.js → chunk-BPYW5YL7.js} +2 -2
- package/dist/{chunk-QGTFQ7RO.cjs → chunk-C2PV3VWC.cjs} +6 -6
- package/dist/{chunk-MZ3T6L7Z.js → chunk-CCJ2MSN7.js} +2 -2
- package/dist/{chunk-H44QVAZL.cjs → chunk-DAPAK2W3.cjs} +31 -31
- package/dist/{chunk-OYFUBKEG.cjs → chunk-DLS3G6WQ.cjs} +4 -4
- package/dist/{chunk-MS2KSKD7.js → chunk-DNMCR5JH.js} +9 -9
- package/dist/chunk-DVMHRLKP.cjs +1 -1
- package/dist/{chunk-IX6PF5ZP.cjs → chunk-EBYFYZW4.cjs} +4 -4
- package/dist/{chunk-5Y6JL47L.js → chunk-ENMRZ4BE.js} +3 -3
- package/dist/{chunk-7EIFPHV3.js → chunk-FJ4BQFVO.js} +8 -8
- package/dist/{chunk-TJ5OY6MC.cjs → chunk-GIKL4PUF.cjs} +10 -10
- package/dist/{chunk-M5QB2GM5.js → chunk-GOFINGT6.js} +2 -2
- package/dist/{chunk-J6VLFVIL.js → chunk-GXKQ3LHF.js} +3 -3
- package/dist/{chunk-5KDVIEVO.js → chunk-HNBRGN4R.js} +2 -2
- package/dist/{chunk-OCTHWEZK.cjs → chunk-HYN6FC5A.cjs} +34 -34
- package/dist/{chunk-MBFVTGYS.js → chunk-IZGVBYFN.js} +4 -4
- package/dist/{chunk-QXTJVDWE.js → chunk-JIE447J5.js} +3 -3
- package/dist/{chunk-UFYMRRJH.cjs → chunk-JXEIJM5M.cjs} +61 -61
- package/dist/{chunk-WB3FT62A.js → chunk-K47GZDBH.js} +3 -3
- package/dist/{chunk-KUVRZ2JW.cjs → chunk-K5536YHG.cjs} +50 -50
- package/dist/chunk-KHO2SBNA.cjs +1 -1
- package/dist/{chunk-NJ24M6ZH.cjs → chunk-KXJ7X325.cjs} +37 -37
- package/dist/chunk-L5RDAVVH.js +1 -1
- package/dist/{chunk-SRWL4YCP.js → chunk-LJHPTLWB.js} +7 -7
- package/dist/{chunk-6AMDHVS2.cjs → chunk-M7ELWZXM.cjs} +9 -9
- package/dist/chunk-MSUW5VHZ.js +1590 -0
- package/dist/{chunk-2XGQQZ6A.cjs → chunk-MUHRPRR7.cjs} +3 -3
- package/dist/{chunk-XYWC4EQ3.cjs → chunk-MV3TSQSH.cjs} +71 -71
- package/dist/{chunk-VCYXNIZ2.cjs → chunk-NLZLXWAU.cjs} +9 -9
- package/dist/{chunk-76ATVDCR.cjs → chunk-NVRZPF5M.cjs} +3 -3
- package/dist/chunk-ONZFBJVW.js +1 -1
- package/dist/{chunk-62FS7WMB.cjs → chunk-PGNL7JXO.cjs} +31 -31
- package/dist/{chunk-JI57K7D4.cjs → chunk-Q4GEQS7X.cjs} +161 -161
- package/dist/chunk-QNKGP5DY.js +1 -1
- package/dist/{chunk-ZTHJQJ5F.cjs → chunk-QYI2VJLS.cjs} +9 -9
- package/dist/{chunk-C7GC2PFX.js → chunk-RBWZII5I.js} +3 -3
- package/dist/{chunk-MMRHKYT6.cjs → chunk-RMP7VMPB.cjs} +12 -12
- package/dist/{chunk-TXOVQZPU.js → chunk-RZOGBYIS.js} +2 -2
- package/dist/{chunk-ALRISPTL.cjs → chunk-SU3UELUB.cjs} +3 -3
- package/dist/chunk-SYHPSOUU.cjs +1626 -0
- package/dist/{chunk-R2DR7SPJ.js → chunk-SZUNAEMR.js} +6 -6
- package/dist/{chunk-YVRUY4EW.cjs → chunk-TER22LO4.cjs} +8 -8
- package/dist/{chunk-WRGN6UBK.js → chunk-TJHGRQ4P.js} +2 -2
- package/dist/{chunk-I33PB44Q.cjs → chunk-U23I7JPB.cjs} +15 -15
- package/dist/{chunk-VBSLIIDB.js → chunk-U7HHN47R.js} +10 -10
- package/dist/chunk-UDA26MCU.cjs +1 -1
- package/dist/{chunk-44X74C26.js → chunk-UIAWUZ4H.js} +4 -4
- package/dist/{chunk-5O66AUEC.js → chunk-ULQPCIA2.js} +2 -2
- package/dist/chunk-VJDDGRIK.cjs +1 -1
- package/dist/{chunk-6WVOUVWD.js → chunk-WETQI6HM.js} +9 -9
- package/dist/{chunk-FWWPEL7J.cjs → chunk-WLOQQFDS.cjs} +3 -3
- package/dist/chunk-WVSPXFTY.js +1 -1
- package/dist/{chunk-WKM6UVMG.cjs → chunk-WXFTVXBF.cjs} +4 -4
- package/dist/{chunk-YQHJB7KR.cjs → chunk-XPVTIGU2.cjs} +26 -26
- package/dist/{chunk-PWKOFPAH.cjs → chunk-XX6RUGTM.cjs} +3 -3
- package/dist/chunk-YWHHVDT4.js +1 -1
- package/dist/{chunk-7NXFGJJE.cjs → chunk-ZPDMWDGZ.cjs} +14 -14
- package/dist/{chunk-JYOCB6OV.js → chunk-ZVWZEGQP.js} +2 -2
- package/dist/conversions/index.cjs +34 -34
- package/dist/conversions/index.d.ts +489 -333
- package/dist/conversions/index.js +15 -15
- package/dist/events/index.cjs +8 -8
- package/dist/events/index.d.ts +35 -29
- package/dist/events/index.js +4 -4
- package/dist/formatters/index.cjs +19 -19
- package/dist/formatters/index.d.ts +917 -873
- package/dist/formatters/index.js +9 -9
- package/dist/generators/index.cjs +9 -9
- package/dist/generators/index.d.ts +104 -86
- package/dist/generators/index.js +4 -4
- package/dist/index.d.ts +1 -1
- package/dist/isPlainObject-0p3VveWr.d.ts +534 -0
- package/dist/next/index.cjs +37 -37
- package/dist/next/index.d.ts +36 -21
- package/dist/next/index.js +9 -9
- package/dist/next/server/index.cjs +4 -4
- package/dist/next/server/index.d.ts +6 -3
- package/dist/next/server/index.js +2 -2
- package/dist/operations/index.cjs +11 -11
- package/dist/operations/index.d.ts +14 -5
- package/dist/operations/index.js +8 -8
- package/dist/parsers/index.cjs +6 -6
- package/dist/parsers/index.d.ts +68 -65
- package/dist/parsers/index.js +5 -5
- package/dist/predicates/index.cjs +77 -77
- package/dist/predicates/index.d.ts +442 -258
- package/dist/predicates/index.js +14 -14
- package/dist/promises/index.cjs +6 -6
- package/dist/promises/index.d.ts +28 -16
- package/dist/promises/index.js +4 -4
- package/dist/rzl-utils.global.js +2 -2
- package/dist/strings/index.cjs +23 -23
- package/dist/strings/index.d.ts +82 -54
- package/dist/strings/index.js +7 -7
- package/dist/tailwind/index.cjs +13 -13
- package/dist/tailwind/index.d.ts +186 -169
- package/dist/tailwind/index.js +5 -5
- package/dist/urls/index.cjs +23 -23
- package/dist/urls/index.d.ts +252 -229
- package/dist/urls/index.js +16 -16
- package/package.json +2 -2
- package/dist/chunk-7C7TQC5J.cjs +0 -620
- package/dist/chunk-J4TT33ZX.js +0 -584
- 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>
|
|
7
|
+
<h1 align="center"><strong>UtilsJS</strong></h1>
|
|
8
8
|
|
|
9
9
|
<p align="center">
|
|
10
|
-
<i>
|
|
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-
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
-
- <
|
|
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
|
-
- <
|
|
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">
|
|
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
|
|
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": [
|
|
266
|
+
"typeRoots": [
|
|
267
|
+
"./types",
|
|
268
|
+
"./node_modules/@types"
|
|
269
|
+
],
|
|
262
270
|
// other your config...
|
|
263
271
|
},
|
|
264
|
-
"include": [
|
|
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": [
|
|
291
|
+
"typeRoots": [
|
|
292
|
+
"./types",
|
|
293
|
+
"./node_modules/@types"
|
|
294
|
+
],
|
|
281
295
|
// other your config...
|
|
282
296
|
},
|
|
283
|
-
"include": [
|
|
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
|
-
|
|
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.
|
|
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
|
|
13
|
-
var
|
|
14
|
-
var
|
|
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
|
|
16
|
+
var chunkSYHPSOUU_cjs = require('../chunk-SYHPSOUU.cjs');
|
|
17
17
|
|
|
18
18
|
Object.defineProperty(exports, "assertIsBigInt", {
|
|
19
19
|
enumerable: true,
|
|
20
|
-
get: function () { return
|
|
20
|
+
get: function () { return chunkB6PMNZ4M_cjs.assertIsBigInt; }
|
|
21
21
|
});
|
|
22
22
|
Object.defineProperty(exports, "assertIsNumber", {
|
|
23
23
|
enumerable: true,
|
|
24
|
-
get: function () { return
|
|
24
|
+
get: function () { return chunkB6PMNZ4M_cjs.assertIsNumber; }
|
|
25
25
|
});
|
|
26
26
|
Object.defineProperty(exports, "assertIsString", {
|
|
27
27
|
enumerable: true,
|
|
28
|
-
get: function () { return
|
|
28
|
+
get: function () { return chunkWXFTVXBF_cjs.assertIsString; }
|
|
29
29
|
});
|
|
30
30
|
Object.defineProperty(exports, "assertIsArray", {
|
|
31
31
|
enumerable: true,
|
|
32
|
-
get: function () { return
|
|
32
|
+
get: function () { return chunkDLS3G6WQ_cjs.assertIsArray; }
|
|
33
33
|
});
|
|
34
34
|
Object.defineProperty(exports, "assertIsBoolean", {
|
|
35
35
|
enumerable: true,
|
|
36
|
-
get: function () { return
|
|
36
|
+
get: function () { return chunkSYHPSOUU_cjs.assertIsBoolean; }
|
|
37
37
|
});
|
|
38
38
|
Object.defineProperty(exports, "assertIsPlainObject", {
|
|
39
39
|
enumerable: true,
|
|
40
|
-
get: function () { return
|
|
40
|
+
get: function () { return chunkSYHPSOUU_cjs.assertIsPlainObject; }
|
|
41
41
|
});
|