toolbox-x 2.2.0 → 2.2.2

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/CHANGELOG.md ADDED
@@ -0,0 +1,183 @@
1
+ # Changelog
2
+
3
+ <!-- markdownlint-disable-file MD024 -->
4
+
5
+ All notable changes to **toolbox-x** will be documented in this file.
6
+
7
+ > Auto-generated from git history using [changelog-maker](https://github.com/nodejs/changelog-maker).
8
+
9
+ ## [Unreleased](https://github.com/nazmul-nhb/toolbox-x/compare/v2.2.1...HEAD)
10
+
11
+ * \[[`4dfadecb54`](https://github.com/nazmul-nhb/toolbox-x/commit/4dfadecb54)] - 🔧 update(docs): updated docs for anagram generator (Nazmul Hassan)
12
+
13
+ ## [v2.2.1](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v2.2.1) — 2026-06-16
14
+
15
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v2.2.0...v2.2.1)
16
+
17
+ * \[[`304f8adcdc`](https://github.com/nazmul-nhb/toolbox-x/commit/304f8adcdc)] - 📚 docs(color): updated tsdocs and docs for `Color` (Nazmul Hassan)
18
+
19
+ ## [v2.2.0](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v2.2.0) — 2026-06-16
20
+
21
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v2.0.14...v2.2.0)
22
+
23
+ * \[[`6932c0301c`](https://github.com/nazmul-nhb/toolbox-x/commit/6932c0301c)] - ✨ feat(color): added new methods: `generatePalette`, `toString`, `toJSON` and `Symbol.toPrimitive` methods; fixed bugs and docs (Nazmul Hassan)
24
+ * \[[`53ed908cd4`](https://github.com/nazmul-nhb/toolbox-x/commit/53ed908cd4)] - 🐛 fix(lint): fixed all lint errors and warnings (Nazmul Hassan)
25
+
26
+ ## [v2.0.14](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v2.0.14) — 2026-06-15
27
+
28
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v2.0.13...v2.0.14)
29
+
30
+ * \[[`258e5bd8b2`](https://github.com/nazmul-nhb/toolbox-x/commit/258e5bd8b2)] - 🔧 update: fixed some lint errors; updated type defs for `parseFormData` and updated docs (Nazmul Hassan)
31
+
32
+ ## [v2.0.13](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v2.0.13) — 2026-06-15
33
+
34
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v2.0.12...v2.0.13)
35
+
36
+ * \[[`862d5023d4`](https://github.com/nazmul-nhb/toolbox-x/commit/862d5023d4)] - 🔧 update(docs): updated docs for dom related utils and re-exported non-dom utils from package main path (Nazmul Hassan)
37
+ * \[[`34c3246ae4`](https://github.com/nazmul-nhb/toolbox-x/commit/34c3246ae4)] - 🐛 fix(docs): updated a mismatched import in the example codeblock (Nazmul Hassan)
38
+
39
+ ## [v2.0.12](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v2.0.12) — 2026-06-15
40
+
41
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v2.0.11...v2.0.12)
42
+
43
+ * \[[`27c053ce3d`](https://github.com/nazmul-nhb/toolbox-x/commit/27c053ce3d)] - 🔧 update(docs): updated docs for `addDate` (Nazmul Hassan)
44
+
45
+ ## [v2.0.11](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v2.0.11) — 2026-06-15
46
+
47
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v2.0.10...v2.0.11)
48
+
49
+ * \[[`6056bf47d1`](https://github.com/nazmul-nhb/toolbox-x/commit/6056bf47d1)] - 🐛 fix: updated missing type imports (Nazmul Hassan)
50
+
51
+ ## [v2.0.10](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v2.0.10) — 2026-06-15
52
+
53
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v2.0.1...v2.0.10)
54
+
55
+ * \[[`a17d0026e8`](https://github.com/nazmul-nhb/toolbox-x/commit/a17d0026e8)] - ✨ feat(date): added new date-time utility `addDate` with docs (Nazmul Hassan)
56
+ * \[[`3bfdb22e8e`](https://github.com/nazmul-nhb/toolbox-x/commit/3bfdb22e8e)] - 🔧 update(docs): reordered constant on sidebar (Nazmul Hassan)
57
+ * \[[`f948a34837`](https://github.com/nazmul-nhb/toolbox-x/commit/f948a34837)] - 🔧 update(docs): modified pg codeblocks and updated some titles (Nazmul Hassan)
58
+
59
+ ## [v2.0.1](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v2.0.1) — 2026-06-15
60
+
61
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v2.0.0...v2.0.1)
62
+
63
+ * \[[`da534461aa`](https://github.com/nazmul-nhb/toolbox-x/commit/da534461aa)] - ✨ feat(date-time): added new utility `formatRelativeDateNative` with docs (Nazmul Hassan)
64
+
65
+ ## [v2.0.0](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v2.0.0) — 2026-06-15
66
+
67
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v1.2.1...v2.0.0)
68
+
69
+ * \[[`e4785ab008`](https://github.com/nazmul-nhb/toolbox-x/commit/e4785ab008)] - 🔡 tsdoc: updated tsdoc for the latest doc site and improved internal perf (Nazmul Hassan)
70
+ * \[[`8bfc3133cd`](https://github.com/nazmul-nhb/toolbox-x/commit/8bfc3133cd)] - 🐛 fix(docs): updated all invalid mdx links (Nazmul Hassan)
71
+ * \[[`960c38abf8`](https://github.com/nazmul-nhb/toolbox-x/commit/960c38abf8)] - 🐛 fix(docs): fixed some syntax errors and removed some pg (Nazmul Hassan)
72
+ * \[[`6723823ab2`](https://github.com/nazmul-nhb/toolbox-x/commit/6723823ab2)] - 🔧 update(docs): removed some pg tag and added some (Nazmul Hassan)
73
+ * \[[`048824461d`](https://github.com/nazmul-nhb/toolbox-x/commit/048824461d)] - 🔧 update(docs): updated class docs sideba titles and other gaps (Nazmul Hassan)
74
+ * \[[`6a2193938a`](https://github.com/nazmul-nhb/toolbox-x/commit/6a2193938a)] - 🔧 update(docs): migrated rest of the docs from old docusaurus docs (Nazmul Hassan)
75
+ * \[[`169e3e7b7f`](https://github.com/nazmul-nhb/toolbox-x/commit/169e3e7b7f)] - ✨ feat(object): added new util `extractObjectEntries` and updated array iltering util (Nazmul Hassan)
76
+ * \[[`fed3e28a6a`](https://github.com/nazmul-nhb/toolbox-x/commit/fed3e28a6a)] - 🔧 update(docs): rearranged sidebar items (Nazmul Hassan)
77
+ * \[[`5ecff45b6e`](https://github.com/nazmul-nhb/toolbox-x/commit/5ecff45b6e)] - 🐛 fix(docs): fixed syntax error in mdx (Nazmul Hassan)
78
+ * \[[`1daecd22ed`](https://github.com/nazmul-nhb/toolbox-x/commit/1daecd22ed)] - 🔧 update(docs): added (migrated) rest of the docs by AI Agent (Nazmul Hassan)
79
+ * \[[`4be446c120`](https://github.com/nazmul-nhb/toolbox-x/commit/4be446c120)] - 🔧 update(biome): updated biome configs (Nazmul Hassan)
80
+ * \[[`fe031fee91`](https://github.com/nazmul-nhb/toolbox-x/commit/fe031fee91)] - 🔧 update(docs): added docs for `createOptionsArray` (Nazmul Hassan)
81
+ * \[[`20426fb1c9`](https://github.com/nazmul-nhb/toolbox-x/commit/20426fb1c9)] - 🔧 update(deps): updated dependencies (Nazmul Hassan)
82
+ * \[[`38c12216da`](https://github.com/nazmul-nhb/toolbox-x/commit/38c12216da)] - 🧼 refactor(internals): reuse `_resolveNestedKey` in `_getNumericProp` (Nazmul Hassan)
83
+ * \[[`8a2a8acc8c`](https://github.com/nazmul-nhb/toolbox-x/commit/8a2a8acc8c)] - 🔁 revert(internals): reverted signature of `_resolveNestedKey` to the previous state (Nazmul Hassan)
84
+ * \[[`bcae9bbe32`](https://github.com/nazmul-nhb/toolbox-x/commit/bcae9bbe32)] - 🔧 update(internal): updated signature of `_resolveNestedKey` internal helper (Nazmul Hassan)
85
+ * \[[`f33c762b5a`](https://github.com/nazmul-nhb/toolbox-x/commit/f33c762b5a)] - 🔧 update(utils): updated signature of `definePrototypeMethod` utility (Nazmul Hassan)
86
+ * \[[`45e2263f0d`](https://github.com/nazmul-nhb/toolbox-x/commit/45e2263f0d)] - 🔧 update(docs): added docs for array split utils (Nazmul Hassan)
87
+ * \[[`da5253f513`](https://github.com/nazmul-nhb/toolbox-x/commit/da5253f513)] - 🔧 update(docs): added docs for array metrics utils (Nazmul Hassan)
88
+ * \[[`93fad69a34`](https://github.com/nazmul-nhb/toolbox-x/commit/93fad69a34)] - 🐛 fix(change-case): fixed issues with delimiter normalizer and updated return types for non-literal strings (Nazmul Hassan)
89
+ * \[[`366769bf10`](https://github.com/nazmul-nhb/toolbox-x/commit/366769bf10)] - 🔧 update(docs): added docs for string checkers (Nazmul Hassan)
90
+ * \[[`8db76e3608`](https://github.com/nazmul-nhb/toolbox-x/commit/8db76e3608)] - 🔧 update(docs): added docs for number checkers (Nazmul Hassan)
91
+ * \[[`a9d47c768c`](https://github.com/nazmul-nhb/toolbox-x/commit/a9d47c768c)] - 🔧 update(docs): added docs for `isDeepEqual` (Nazmul Hassan)
92
+ * \[[`3866f14770`](https://github.com/nazmul-nhb/toolbox-x/commit/3866f14770)] - 🔧 update(docs): added docs for empty array checker (Nazmul Hassan)
93
+ * \[[`7cff6aaab4`](https://github.com/nazmul-nhb/toolbox-x/commit/7cff6aaab4)] - 🔧 update(tsdoc): updated tsdoc for environment guard (Nazmul Hassan)
94
+ * \[[`0d6d0e4101`](https://github.com/nazmul-nhb/toolbox-x/commit/0d6d0e4101)] - 🔧 update(docs/guards): updated example (Nazmul Hassan)
95
+ * \[[`ac00debace`](https://github.com/nazmul-nhb/toolbox-x/commit/ac00debace)] - 🔧 update(docs): added docs for environment guards (Nazmul Hassan)
96
+ * \[[`8a83fce7e9`](https://github.com/nazmul-nhb/toolbox-x/commit/8a83fce7e9)] - 🔧 update(docs): added docs for string format guards (Nazmul Hassan)
97
+ * \[[`9336711fd3`](https://github.com/nazmul-nhb/toolbox-x/commit/9336711fd3)] - 🔧 update(docs): added docs for object guards (Nazmul Hassan)
98
+ * \[[`3dfd02fe27`](https://github.com/nazmul-nhb/toolbox-x/commit/3dfd02fe27)] - 🔧 update(docs): added docs for composite type guards for primitive values (Nazmul Hassan)
99
+ * \[[`866bc5e3cc`](https://github.com/nazmul-nhb/toolbox-x/commit/866bc5e3cc)] - 🔧 update(docs): added docs for nullish type checkers (Nazmul Hassan)
100
+ * \[[`e5039e7a8c`](https://github.com/nazmul-nhb/toolbox-x/commit/e5039e7a8c)] - 🔧 update(docs): added docs for numeric type guards (Nazmul Hassan)
101
+ * \[[`a39e82cc99`](https://github.com/nazmul-nhb/toolbox-x/commit/a39e82cc99)] - 🔧 update(docs): added docs for core primitive type guards (Nazmul Hassan)
102
+ * \[[`b82e2ed041`](https://github.com/nazmul-nhb/toolbox-x/commit/b82e2ed041)] - 📦 deps(workspace): updated all deps to safe versions (Nazmul Hassan)
103
+ * \[[`258f78a839`](https://github.com/nazmul-nhb/toolbox-x/commit/258f78a839)] - 🧼 refactor(hash): created new internal helper `_fillWithRandomBytes` for reuse (Nazmul Hassan)
104
+ * \[[`cbb1c84c29`](https://github.com/nazmul-nhb/toolbox-x/commit/cbb1c84c29)] - 🧹 cleanup(docs): removed unnecessary examples from docs (Nazmul Hassan)
105
+ * \[[`ba0c5e1b1b`](https://github.com/nazmul-nhb/toolbox-x/commit/ba0c5e1b1b)] - 🔧 update(docs): updated function guards docs (Nazmul Hassan)
106
+ * \[[`e4fdc149cc`](https://github.com/nazmul-nhb/toolbox-x/commit/e4fdc149cc)] - 🔧 update(guards): added implementation and docs for function guards (Nazmul Hassan)
107
+ * \[[`127c296f37`](https://github.com/nazmul-nhb/toolbox-x/commit/127c296f37)] - 🔧 update(docs): updated the format of last modified date (Nazmul Hassan)
108
+ * \[[`cdc1241994`](https://github.com/nazmul-nhb/toolbox-x/commit/cdc1241994)] - 🔧 update(docs): swapped a section in array guards (Nazmul Hassan)
109
+ * \[[`4b1929b695`](https://github.com/nazmul-nhb/toolbox-x/commit/4b1929b695)] - 🔧 update(docs): added docs for dom guards (Nazmul Hassan)
110
+
111
+ ## [v1.2.1](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v1.2.1) — 2026-05-26
112
+
113
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v1.2.0...v1.2.1)
114
+
115
+ * \[[`07203dab41`](https://github.com/nazmul-nhb/toolbox-x/commit/07203dab41)] - 🔧 update: fixed `isValidUTCOffset` and added docs for array guards and updated other docs (Nazmul Hassan)
116
+ * \[[`544362c0f5`](https://github.com/nazmul-nhb/toolbox-x/commit/544362c0f5)] - 🔧 update(docs): added docs for `isDate` and `isDateString` (Nazmul Hassan)
117
+ * \[[`be859a3064`](https://github.com/nazmul-nhb/toolbox-x/commit/be859a3064)] - 🔧 update(docs): organized hash utils docs (Nazmul Hassan)
118
+
119
+ ## [v1.2.0](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v1.2.0) — 2026-05-26
120
+
121
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v1.1.2...v1.2.0)
122
+
123
+ * \[[`bca3090bbf`](https://github.com/nazmul-nhb/toolbox-x/commit/bca3090bbf)] - 🔧 update(docs+Signet): added docs for hash utils and fixed validation issue with Signet class (Nazmul Hassan)
124
+ * \[[`a05d221246`](https://github.com/nazmul-nhb/toolbox-x/commit/a05d221246)] - 🔧 update(docs): changed rehype code theme (Nazmul Hassan)
125
+ * \[[`5a6bc46578`](https://github.com/nazmul-nhb/toolbox-x/commit/5a6bc46578)] - 🔧 update(docs): added hash utils index page (Nazmul Hassan)
126
+ * \[[`7430836daa`](https://github.com/nazmul-nhb/toolbox-x/commit/7430836daa)] - 🔧 update(docs): updated intro and quick start pages (Nazmul Hassan)
127
+ * \[[`3110880cfe`](https://github.com/nazmul-nhb/toolbox-x/commit/3110880cfe)] - 🔧 update(docs): updated util/date to utils/date-time (Nazmul Hassan)
128
+ * \[[`86562982c9`](https://github.com/nazmul-nhb/toolbox-x/commit/86562982c9)] - 🔧 update(docs): changed brand and theme colors (Nazmul Hassan)
129
+ * \[[`423690d231`](https://github.com/nazmul-nhb/toolbox-x/commit/423690d231)] - 🔧 update(docs): changed theme and updated docs (Nazmul Hassan)
130
+
131
+ ## [v1.1.2](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v1.1.2) — 2026-05-24
132
+
133
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v1.1.1...v1.1.2)
134
+
135
+ * \[[`caaf5bdbbf`](https://github.com/nazmul-nhb/toolbox-x/commit/caaf5bdbbf)] - 🔧 update(date): updated `isDateLike` to handle more `Temporal` instances (Nazmul Hassan)
136
+
137
+ ## [v1.1.1](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v1.1.1) — 2026-05-24
138
+
139
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v1.1.0...v1.1.1)
140
+
141
+ * \[[`eceb63859d`](https://github.com/nazmul-nhb/toolbox-x/commit/eceb63859d)] - 🐛 fix(form): updated `createFormData`: now handles configs more correctly (Nazmul Hassan)
142
+ * \[[`fe133e9efa`](https://github.com/nazmul-nhb/toolbox-x/commit/fe133e9efa)] - 🐛 fix(docs): updated invalid links and sidebar meta (Nazmul Hassan)
143
+ * \[[`c10974cf06`](https://github.com/nazmul-nhb/toolbox-x/commit/c10974cf06)] - 🔧 update(docs): updated chatbot name and import paths (Nazmul Hassan)
144
+
145
+ ## [v1.1.0](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v1.1.0) — 2026-05-24
146
+
147
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v1.0.1-rc.6...v1.1.0)
148
+
149
+ * \[[`6c99fb7273`](https://github.com/nazmul-nhb/toolbox-x/commit/6c99fb7273)] - 🔧 update(dom/form): fixed all known issues with `createFormData` and updated docs (Nazmul Hassan)
150
+ * \[[`21672be18c`](https://github.com/nazmul-nhb/toolbox-x/commit/21672be18c)] - 🐛 fix(dom/form): fixed an issue with string trimming (Nazmul Hassan)
151
+ * \[[`a1f0a2897c`](https://github.com/nazmul-nhb/toolbox-x/commit/a1f0a2897c)] - 🛠️ chore: updated types and re-export some utils from other sub modules (Nazmul Hassan)
152
+
153
+ ## [v1.0.1-rc.6](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v1.0.1-rc.6) — 2026-05-23
154
+
155
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v1.0.1-rc.4...v1.0.1-rc.6)
156
+
157
+ * \[[`60f8e4b328`](https://github.com/nazmul-nhb/toolbox-x/commit/60f8e4b328)] - 🧼 refactor(paths): updated import paths (Nazmul Hassan)
158
+ * \[[`1f0f173f77`](https://github.com/nazmul-nhb/toolbox-x/commit/1f0f173f77)] - 🔧 update(docs): organized date utils and guards (Nazmul Hassan)
159
+ * \[[`e41e05f6ea`](https://github.com/nazmul-nhb/toolbox-x/commit/e41e05f6ea)] - 🔧 update(docs): updated getting started section (Nazmul Hassan)
160
+
161
+ ## [v1.0.1-rc.4](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v1.0.1-rc.4) — 2026-05-22
162
+
163
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v1.0.1-rc.3...v1.0.1-rc.4)
164
+
165
+ * \[[`0c13fbf037`](https://github.com/nazmul-nhb/toolbox-x/commit/0c13fbf037)] - 🧹 cleanup: removed unnecessary code (Nazmul Hassan)
166
+ * \[[`f8b067fc91`](https://github.com/nazmul-nhb/toolbox-x/commit/f8b067fc91)] - 🔧 update(og): updated og generator base url (Nazmul Hassan)
167
+ * \[[`77d79ce0d1`](https://github.com/nazmul-nhb/toolbox-x/commit/77d79ce0d1)] - 🔧 update(docs): updated theme color, logo and other configs (Nazmul Hassan)
168
+
169
+ ## [v1.0.1-rc.3](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v1.0.1-rc.3) — 2026-05-22
170
+
171
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v1.0.1-rc.2...v1.0.1-rc.3)
172
+
173
+ * \[[`53f215946e`](https://github.com/nazmul-nhb/toolbox-x/commit/53f215946e)] - 🔧 update: updated types and docs; added logo (Nazmul Hassan)
174
+
175
+ ## [v1.0.1-rc.2](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v1.0.1-rc.2) — 2026-05-22
176
+
177
+ [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v1.0.1-rc.1...v1.0.1-rc.2)
178
+
179
+ * \[[`2ad9a08a2d`](https://github.com/nazmul-nhb/toolbox-x/commit/2ad9a08a2d)] - 🔧 update(domain): updated homepage domain (Nazmul Hassan)
180
+
181
+ ## [v1.0.1-rc.1](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v1.0.1-rc.1) — 2026-05-22
182
+
183
+ * \[[`4ebb0d43ab`](https://github.com/toolbox-x/toolbox-x/commit/4ebb0d43ab)] - 🚀 init: initialized the project with existing codes from `nhb-toolbox` (Nazmul Hassan)
@@ -168,11 +168,17 @@ type CSSColor = keyof typeof CSS_COLORS;
168
168
  */
169
169
  declare class Color {
170
170
  #private;
171
+ /** {@link Hex6 Hex} color representation (without alpha). */
171
172
  readonly hex: Hex6;
173
+ /** {@link Hex8} color representation including alpha. */
172
174
  readonly hex8: Hex8;
175
+ /** {@link RGB} color representation (without alpha). */
173
176
  readonly rgb: RGB;
177
+ /** {@link RGBA} color representation including alpha. */
174
178
  readonly rgba: RGBA;
179
+ /** {@link HSL} color representation (without alpha). */
175
180
  readonly hsl: HSL;
181
+ /** {@link HSLA} color representation including alpha. */
176
182
  readonly hsla: HSLA;
177
183
  /**
178
184
  * * Creates a new `Color` instance with a random color and automatically converts the generated color to all other supported formats: {@link Hex6 Hex}, {@link Hex8}, {@link RGB}, {@link RGBA}, {@link HSL}, and {@link HSLA}.
@@ -168,11 +168,17 @@ type CSSColor = keyof typeof CSS_COLORS;
168
168
  */
169
169
  declare class Color {
170
170
  #private;
171
+ /** {@link Hex6 Hex} color representation (without alpha). */
171
172
  readonly hex: Hex6;
173
+ /** {@link Hex8} color representation including alpha. */
172
174
  readonly hex8: Hex8;
175
+ /** {@link RGB} color representation (without alpha). */
173
176
  readonly rgb: RGB;
177
+ /** {@link RGBA} color representation including alpha. */
174
178
  readonly rgba: RGBA;
179
+ /** {@link HSL} color representation (without alpha). */
175
180
  readonly hsl: HSL;
181
+ /** {@link HSLA} color representation including alpha. */
176
182
  readonly hsla: HSLA;
177
183
  /**
178
184
  * * Creates a new `Color` instance with a random color and automatically converts the generated color to all other supported formats: {@link Hex6 Hex}, {@link Hex8}, {@link RGB}, {@link RGBA}, {@link HSL}, and {@link HSLA}.
@@ -14,7 +14,7 @@
14
14
  * limitations under the License.
15
15
  */
16
16
 
17
- import { s as CSSColor } from "./Color-CVRcGmWe.cjs";
17
+ import { s as CSSColor } from "./Color-D6qMZgDm.mjs";
18
18
 
19
19
  //#region src/stylog/constants.d.ts
20
20
  /** Records of ANSI-16 colors with values */
@@ -14,7 +14,7 @@
14
14
  * limitations under the License.
15
15
  */
16
16
 
17
- import { s as CSSColor } from "./Color-CInCJvH7.mjs";
17
+ import { s as CSSColor } from "./Color-SUPeP6fO.cjs";
18
18
 
19
19
  //#region src/stylog/constants.d.ts
20
20
  /** Records of ANSI-16 colors with values */
package/dist/colors.cjs CHANGED
@@ -96,11 +96,17 @@ function generateRandomColor(options) {
96
96
  * @property `hsla` - {@link HSLA} color representation including alpha.
97
97
  */
98
98
  var Color = class Color {
99
+ /** {@link Hex6 Hex} color representation (without alpha). */
99
100
  hex;
101
+ /** {@link Hex8} color representation including alpha. */
100
102
  hex8;
103
+ /** {@link RGB} color representation (without alpha). */
101
104
  rgb;
105
+ /** {@link RGBA} color representation including alpha. */
102
106
  rgba;
107
+ /** {@link HSL} color representation (without alpha). */
103
108
  hsl;
109
+ /** {@link HSLA} color representation including alpha. */
104
110
  hsla;
105
111
  /**
106
112
  * * Creates a new `Color` instance and automatically converts the input color to all other supported formats: {@link Hex6 Hex}, {@link Hex8}, {@link RGB}, {@link RGBA}, {@link HSL}, and {@link HSLA}.
@@ -313,9 +319,9 @@ var Color = class Color {
313
319
  */
314
320
  blendWith(other, weight = .5) {
315
321
  const w = Math.max(0, Math.min(1, weight));
316
- const converted = new Color(other);
322
+ const otherColor = new Color(other);
317
323
  const [r1, g1, b1, a1] = require_convert.extractAlphaColorValues(this.rgba);
318
- const [r2, g2, b2, a2] = require_convert.extractAlphaColorValues(converted.rgba);
324
+ const [r2, g2, b2, a2] = require_convert.extractAlphaColorValues(otherColor.rgba);
319
325
  const alpha = Math.round((a1 * (1 - w) + a2 * w) * 100) / 100;
320
326
  const _blendChannel = (c1, c2) => {
321
327
  return Math.round((c1 * a1 * (1 - w) + c2 * a2 * w) / alpha);
@@ -328,16 +334,16 @@ var Color = class Color {
328
334
  * @returns A number representing the contrast ratio (rounded to 2 decimal places).
329
335
  */
330
336
  contrastRatio(other) {
331
- const newColor = new Color(other);
332
- const luminance = (rgb) => {
337
+ const otherColor = new Color(other);
338
+ const _luminance = (rgb) => {
333
339
  const [r, g, b] = require_convert.extractSolidColorValues(rgb).map((v) => {
334
340
  const c = v / 255;
335
341
  return c <= .03928 ? c / 12.92 : ((c + .055) / 1.055) ** 2.4;
336
342
  });
337
343
  return .2126 * r + .7152 * g + .0722 * b;
338
344
  };
339
- const lum1 = luminance(this.rgb);
340
- const lum2 = luminance(newColor.rgb);
345
+ const lum1 = _luminance(this.rgb);
346
+ const lum2 = _luminance(otherColor.rgb);
341
347
  const brighter = Math.max(lum1, lum2);
342
348
  const darker = Math.min(lum1, lum2);
343
349
  const ratio = (brighter + .05) / (darker + .05);
package/dist/colors.d.cts CHANGED
@@ -15,7 +15,7 @@
15
15
  */
16
16
 
17
17
  import { er as Percent } from "./object-DyVg8BFt.cjs";
18
- import { C as RandomColorOptions, S as RandomColor, T as SolidValues, _ as Hex, a as AlphaValues, b as RGB, g as HSLA, h as HSL, l as ColorInputArray, n as $ColorType, t as Color, v as Hex6, x as RGBA, y as Hex8 } from "./Color-CVRcGmWe.cjs";
18
+ import { C as RandomColorOptions, S as RandomColor, T as SolidValues, _ as Hex, a as AlphaValues, b as RGB, g as HSLA, h as HSL, l as ColorInputArray, n as $ColorType, t as Color, v as Hex6, x as RGBA, y as Hex8 } from "./Color-SUPeP6fO.cjs";
19
19
 
20
20
  //#region src/colors/convert.d.ts
21
21
  /**
package/dist/colors.d.mts CHANGED
@@ -15,7 +15,7 @@
15
15
  */
16
16
 
17
17
  import { er as Percent } from "./object-DyVg8BFt.mjs";
18
- import { C as RandomColorOptions, S as RandomColor, T as SolidValues, _ as Hex, a as AlphaValues, b as RGB, g as HSLA, h as HSL, l as ColorInputArray, n as $ColorType, t as Color, v as Hex6, x as RGBA, y as Hex8 } from "./Color-CInCJvH7.mjs";
18
+ import { C as RandomColorOptions, S as RandomColor, T as SolidValues, _ as Hex, a as AlphaValues, b as RGB, g as HSLA, h as HSL, l as ColorInputArray, n as $ColorType, t as Color, v as Hex6, x as RGBA, y as Hex8 } from "./Color-D6qMZgDm.mjs";
19
19
 
20
20
  //#region src/colors/convert.d.ts
21
21
  /**
package/dist/colors.mjs CHANGED
@@ -95,11 +95,17 @@ function generateRandomColor(options) {
95
95
  * @property `hsla` - {@link HSLA} color representation including alpha.
96
96
  */
97
97
  var Color = class Color {
98
+ /** {@link Hex6 Hex} color representation (without alpha). */
98
99
  hex;
100
+ /** {@link Hex8} color representation including alpha. */
99
101
  hex8;
102
+ /** {@link RGB} color representation (without alpha). */
100
103
  rgb;
104
+ /** {@link RGBA} color representation including alpha. */
101
105
  rgba;
106
+ /** {@link HSL} color representation (without alpha). */
102
107
  hsl;
108
+ /** {@link HSLA} color representation including alpha. */
103
109
  hsla;
104
110
  /**
105
111
  * * Creates a new `Color` instance and automatically converts the input color to all other supported formats: {@link Hex6 Hex}, {@link Hex8}, {@link RGB}, {@link RGBA}, {@link HSL}, and {@link HSLA}.
@@ -312,9 +318,9 @@ var Color = class Color {
312
318
  */
313
319
  blendWith(other, weight = .5) {
314
320
  const w = Math.max(0, Math.min(1, weight));
315
- const converted = new Color(other);
321
+ const otherColor = new Color(other);
316
322
  const [r1, g1, b1, a1] = extractAlphaColorValues(this.rgba);
317
- const [r2, g2, b2, a2] = extractAlphaColorValues(converted.rgba);
323
+ const [r2, g2, b2, a2] = extractAlphaColorValues(otherColor.rgba);
318
324
  const alpha = Math.round((a1 * (1 - w) + a2 * w) * 100) / 100;
319
325
  const _blendChannel = (c1, c2) => {
320
326
  return Math.round((c1 * a1 * (1 - w) + c2 * a2 * w) / alpha);
@@ -327,16 +333,16 @@ var Color = class Color {
327
333
  * @returns A number representing the contrast ratio (rounded to 2 decimal places).
328
334
  */
329
335
  contrastRatio(other) {
330
- const newColor = new Color(other);
331
- const luminance = (rgb) => {
336
+ const otherColor = new Color(other);
337
+ const _luminance = (rgb) => {
332
338
  const [r, g, b] = extractSolidColorValues(rgb).map((v) => {
333
339
  const c = v / 255;
334
340
  return c <= .03928 ? c / 12.92 : ((c + .055) / 1.055) ** 2.4;
335
341
  });
336
342
  return .2126 * r + .7152 * g + .0722 * b;
337
343
  };
338
- const lum1 = luminance(this.rgb);
339
- const lum2 = luminance(newColor.rgb);
344
+ const lum1 = _luminance(this.rgb);
345
+ const lum2 = _luminance(otherColor.rgb);
340
346
  const brighter = Math.max(lum1, lum2);
341
347
  const darker = Math.min(lum1, lum2);
342
348
  const ratio = (brighter + .05) / (darker + .05);
package/dist/guards.d.cts CHANGED
@@ -15,7 +15,7 @@
15
15
  */
16
16
 
17
17
  import { $ as GenericFn, B as AsyncFunction, Dn as UTCOffset, Ft as DateLike, Z as FalsyPrimitive, _n as TimeWithUnit, at as NormalPrimitive, ct as Numeric, dt as Primitive, jt as ClockTime, nt as Maybe, pt as ValidArray, rt as MethodDescriptor, wt as $TimeZoneIdentifier, xn as TimeZoneIdNative, y as GenericObject } from "./object-DyVg8BFt.cjs";
18
- import { b as RGB, g as HSLA, h as HSL, s as CSSColor, v as Hex6, x as RGBA, y as Hex8 } from "./Color-CVRcGmWe.cjs";
18
+ import { b as RGB, g as HSLA, h as HSL, s as CSSColor, v as Hex6, x as RGBA, y as Hex8 } from "./Color-SUPeP6fO.cjs";
19
19
  import { S as isInvalidOrEmptyArray, f as isDeepEqual, v as isPrime } from "./index-D00Uqm9S.cjs";
20
20
  import { C as isURL, S as isPhoneNumber, _ as isEnvironment, a as isUUIDv4, b as isNode, c as isUUIDv7, d as isBase64, f as isBinaryString, g as isEmailArray, h as isEmail, i as isUUIDv3, l as isUUIDv8, m as isDateString, n as isUUIDv1, o as isUUIDv5, p as isBrowser, r as isUUIDv2, s as isUUIDv6, v as isHexString, w as isUUID, x as isNumericString, y as isIPAddress } from "./uuid-CMNRM9NO.cjs";
21
21
 
package/dist/guards.d.mts CHANGED
@@ -15,7 +15,7 @@
15
15
  */
16
16
 
17
17
  import { $ as GenericFn, B as AsyncFunction, Dn as UTCOffset, Ft as DateLike, Z as FalsyPrimitive, _n as TimeWithUnit, at as NormalPrimitive, ct as Numeric, dt as Primitive, jt as ClockTime, nt as Maybe, pt as ValidArray, rt as MethodDescriptor, wt as $TimeZoneIdentifier, xn as TimeZoneIdNative, y as GenericObject } from "./object-DyVg8BFt.mjs";
18
- import { b as RGB, g as HSLA, h as HSL, s as CSSColor, v as Hex6, x as RGBA, y as Hex8 } from "./Color-CInCJvH7.mjs";
18
+ import { b as RGB, g as HSLA, h as HSL, s as CSSColor, v as Hex6, x as RGBA, y as Hex8 } from "./Color-D6qMZgDm.mjs";
19
19
  import { S as isInvalidOrEmptyArray, f as isDeepEqual, v as isPrime } from "./index-BbBnKdBb.mjs";
20
20
  import { C as isURL, S as isPhoneNumber, _ as isEnvironment, a as isUUIDv4, b as isNode, c as isUUIDv7, d as isBase64, f as isBinaryString, g as isEmailArray, h as isEmail, i as isUUIDv3, l as isUUIDv8, m as isDateString, n as isUUIDv1, o as isUUIDv5, p as isBrowser, r as isUUIDv2, s as isUUIDv6, v as isHexString, w as isUUID, x as isNumericString, y as isIPAddress } from "./uuid-DvQsIl9p.mjs";
21
21
 
package/dist/stylog.d.cts CHANGED
@@ -14,8 +14,8 @@
14
14
  * limitations under the License.
15
15
  */
16
16
 
17
- import { _ as Hex } from "./Color-CVRcGmWe.cjs";
18
- import { a as AnsiSequence, n as Stylog, o as BGColor, t as LogStyler, u as TextStyle } from "./Stylog-00MmV27Z.cjs";
17
+ import { _ as Hex } from "./Color-SUPeP6fO.cjs";
18
+ import { a as AnsiSequence, n as Stylog, o as BGColor, t as LogStyler, u as TextStyle } from "./Stylog-DdPP_CJf.cjs";
19
19
 
20
20
  //#region src/stylog/utils.d.ts
21
21
  /**
package/dist/stylog.d.mts CHANGED
@@ -14,8 +14,8 @@
14
14
  * limitations under the License.
15
15
  */
16
16
 
17
- import { _ as Hex } from "./Color-CInCJvH7.mjs";
18
- import { a as AnsiSequence, n as Stylog, o as BGColor, t as LogStyler, u as TextStyle } from "./Stylog-Bi1f4CR9.mjs";
17
+ import { _ as Hex } from "./Color-D6qMZgDm.mjs";
18
+ import { a as AnsiSequence, n as Stylog, o as BGColor, t as LogStyler, u as TextStyle } from "./Stylog-B8sKWvn_.mjs";
19
19
 
20
20
  //#region src/stylog/utils.d.ts
21
21
  /**
@@ -14,5 +14,5 @@
14
14
  * limitations under the License.
15
15
  */
16
16
 
17
- import { C as RandomColorOptions, D as Triad, E as Tetrad, S as RandomColor, T as SolidValues, _ as Hex, a as AlphaValues, b as RGB, c as ColorInput, d as ColorTypeAlpha, f as ColorTypeSolid, g as HSLA, h as HSL, i as AlphaValue, l as ColorInputArray, m as ConvertedColors, n as $ColorType, o as Analogous, p as Colors, r as AlphaColors, s as CSSColor, u as ColorType, v as Hex6, w as SolidColors, x as RGBA, y as Hex8 } from "../Color-CVRcGmWe.cjs";
17
+ import { C as RandomColorOptions, D as Triad, E as Tetrad, S as RandomColor, T as SolidValues, _ as Hex, a as AlphaValues, b as RGB, c as ColorInput, d as ColorTypeAlpha, f as ColorTypeSolid, g as HSLA, h as HSL, i as AlphaValue, l as ColorInputArray, m as ConvertedColors, n as $ColorType, o as Analogous, p as Colors, r as AlphaColors, s as CSSColor, u as ColorType, v as Hex6, w as SolidColors, x as RGBA, y as Hex8 } from "../Color-SUPeP6fO.cjs";
18
18
  export { $ColorType, AlphaColors, AlphaValue, AlphaValues, Analogous, CSSColor, ColorInput, ColorInputArray, ColorType, ColorTypeAlpha, ColorTypeSolid, Colors, ConvertedColors, HSL, HSLA, Hex, Hex6, Hex8, RGB, RGBA, RandomColor, RandomColorOptions, SolidColors, SolidValues, Tetrad, Triad };
@@ -14,5 +14,5 @@
14
14
  * limitations under the License.
15
15
  */
16
16
 
17
- import { C as RandomColorOptions, D as Triad, E as Tetrad, S as RandomColor, T as SolidValues, _ as Hex, a as AlphaValues, b as RGB, c as ColorInput, d as ColorTypeAlpha, f as ColorTypeSolid, g as HSLA, h as HSL, i as AlphaValue, l as ColorInputArray, m as ConvertedColors, n as $ColorType, o as Analogous, p as Colors, r as AlphaColors, s as CSSColor, u as ColorType, v as Hex6, w as SolidColors, x as RGBA, y as Hex8 } from "../Color-CInCJvH7.mjs";
17
+ import { C as RandomColorOptions, D as Triad, E as Tetrad, S as RandomColor, T as SolidValues, _ as Hex, a as AlphaValues, b as RGB, c as ColorInput, d as ColorTypeAlpha, f as ColorTypeSolid, g as HSLA, h as HSL, i as AlphaValue, l as ColorInputArray, m as ConvertedColors, n as $ColorType, o as Analogous, p as Colors, r as AlphaColors, s as CSSColor, u as ColorType, v as Hex6, w as SolidColors, x as RGBA, y as Hex8 } from "../Color-D6qMZgDm.mjs";
18
18
  export { $ColorType, AlphaColors, AlphaValue, AlphaValues, Analogous, CSSColor, ColorInput, ColorInputArray, ColorType, ColorTypeAlpha, ColorTypeSolid, Colors, ConvertedColors, HSL, HSLA, Hex, Hex6, Hex8, RGB, RGBA, RandomColor, RandomColorOptions, SolidColors, SolidValues, Tetrad, Triad };
@@ -14,5 +14,5 @@
14
14
  * limitations under the License.
15
15
  */
16
16
 
17
- import { a as AnsiSequence, c as Styles, i as Ansi16Value, l as StylogChain, o as BGColor, r as Ansi16Color, s as CSS16Color, u as TextStyle } from "../Stylog-00MmV27Z.cjs";
17
+ import { a as AnsiSequence, c as Styles, i as Ansi16Value, l as StylogChain, o as BGColor, r as Ansi16Color, s as CSS16Color, u as TextStyle } from "../Stylog-DdPP_CJf.cjs";
18
18
  export { Ansi16Color, Ansi16Value, AnsiSequence, BGColor, CSS16Color, Styles, StylogChain, TextStyle };
@@ -14,5 +14,5 @@
14
14
  * limitations under the License.
15
15
  */
16
16
 
17
- import { a as AnsiSequence, c as Styles, i as Ansi16Value, l as StylogChain, o as BGColor, r as Ansi16Color, s as CSS16Color, u as TextStyle } from "../Stylog-Bi1f4CR9.mjs";
17
+ import { a as AnsiSequence, c as Styles, i as Ansi16Value, l as StylogChain, o as BGColor, r as Ansi16Color, s as CSS16Color, u as TextStyle } from "../Stylog-B8sKWvn_.mjs";
18
18
  export { Ansi16Color, Ansi16Value, AnsiSequence, BGColor, CSS16Color, Styles, StylogChain, TextStyle };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "toolbox-x",
3
- "version": "2.2.0",
3
+ "version": "2.2.2",
4
4
  "description": "A versatile collection of smart, efficient, and reusable utility functions, classes and types for everyday development needs.",
5
5
  "main": "./dist/index.cjs",
6
6
  "type": "module",
@@ -65,6 +65,7 @@
65
65
  "dist",
66
66
  "LICENSE",
67
67
  "README.md",
68
+ "CHANGELOG.md",
68
69
  "package.json"
69
70
  ],
70
71
  "repository": {
@@ -248,6 +249,7 @@
248
249
  "lint": "biome lint --diagnostic-level=warn",
249
250
  "fix": "biome check --write --diagnostic-level=warn",
250
251
  "format": "biome format --write --diagnostic-level=warn",
251
- "create-docs": "nhb-module -t docs"
252
+ "create-docs": "nhb-module -t docs",
253
+ "changelog": "node scripts/generate-changelog.mjs"
252
254
  }
253
255
  }