nhb-toolbox 4.30.1 → 4.30.11

package/CHANGELOG.md

@@ -4,6 +4,15 @@
 
 All notable changes to the package will be documented here.
 
+## [4.30.11] - 2026-05-17
+
+- **Updated** the *time-zone* abbreviation matching logic of *Chronos plugin method* `getTimeZoneNameShort()` (alias: `getTimeZoneNameAbbr()`) and fixed the caching issue.
+
+## [4.30.10] - 2026-05-16
+
+- **Added** new *utility types*: `PropertyOptional<T, Keys>` and `PropertyRequired<T, Keys>`.
+- **Fixed** *Chronos plugin method* `round()` not preserving the *metadata* of the *original* instance.
+
 ## [4.30.1] - 2026-04-27
 
 - **Updated** *random hex generation* logic in `randomHex` and `uuid` utilities to use `crypto.getRandomValues` for better performance and security when available, with a fallback to `Math.random` for environments where `crypto` is not available.

package/dist/cjs/date/plugins/roundPlugin.js

@@ -56,7 +56,7 @@ const roundPlugin = ($Chronos) => {
                 const diffToStart = Math.abs(date.getTime() - startOfWeek.getTime());
                 const diffToEnd = Math.abs(endOfWeek.getTime() - date.getTime());
                 const rounded = diffToEnd < diffToStart ? endOfWeek : startOfWeek;
-                return withOrigin(new $Chronos(rounded), 'round');
+                return withOrigin(new $Chronos(rounded), 'round', offset(this), this.timeZoneName, this.timeZoneId, this.$tzTracker);
             }
             case 'month': {
                 const fullMonth = date.getMonth() + date.getDate() / this.lastDateOfMonth;

package/dist/cjs/date/plugins/timeZonePlugin.js

@@ -48,10 +48,14 @@ const timeZonePlugin = ($Chronos) => {
         }
         return tzIds;
     }, new Map()));
-    const TZ_NAME_ABBR_MAP = new Map(Object.entries(timezone_1.TIME_ZONES).map(([tzAbbr, { offset, tzName }]) => [
-        offset,
-        { tzAbbr, tzName },
-    ]));
+    const _buildTzNameAbbrMap = () => {
+        const result = [];
+        for (const [tzAbbr, { offset, tzName }] of Object.entries(timezone_1.TIME_ZONES)) {
+            result.unshift([offset, { tzAbbr, tzName }]);
+        }
+        return result;
+    };
+    const TZ_NAME_ABBR_MAP = new Map(_buildTzNameAbbrMap());
     const _getTimeZoneId = (utc) => {
         const tzIds = TZ_ID_MAP.get(utc);
         if (!tzIds || tzIds?.length === 0)
@@ -121,12 +125,13 @@ const timeZonePlugin = ($Chronos) => {
         if (!utc && tracker && _isValidTzAbbr(tracker))
             return tracker;
         if ((0, guards_1.isValidUTCOffset)(tzMapKey)) {
-            if (TZ_ABBR_CACHE.has(tzMapKey))
+            if (TZ_ABBR_CACHE.has(tzMapKey)) {
                 return TZ_ABBR_CACHE.get(tzMapKey);
-            if (TZ_NAME_ABBR_MAP.has(tzMapKey)) {
-                return TZ_NAME_ABBR_MAP.get(tzMapKey)?.tzAbbr;
             }
             const tzName = _resolveTzName(tzMapKey);
+            if (!tzName && TZ_NAME_ABBR_MAP.has(tzMapKey)) {
+                return TZ_NAME_ABBR_MAP.get(tzMapKey)?.tzAbbr;
+            }
             if (tzName) {
                 const tzAbbr = _abbreviate(tzName);
                 TZ_ABBR_CACHE.set(tzMapKey, tzAbbr);
@@ -134,10 +139,12 @@ const timeZonePlugin = ($Chronos) => {
             }
         }
         const zone = _getTimeZoneName(tzMapKey, $Date(this)) ?? UTC;
-        if (TZ_ABBR_CACHE.has(`name-${zone}`))
-            return TZ_ABBR_CACHE.get(zone);
+        const fallbackKey = `name-${zone}`;
+        if (TZ_ABBR_CACHE.has(fallbackKey)) {
+            return TZ_ABBR_CACHE.get(fallbackKey);
+        }
         const customAbbr = (0, guards_1.isValidUTCOffset)(zone) ? zone : _abbreviate(zone);
-        TZ_ABBR_CACHE.set(`name-${zone}`, customAbbr);
+        TZ_ABBR_CACHE.set(fallbackKey, customAbbr);
         return customAbbr;
     };
     $Chronos.prototype.getTimeZoneNameAbbr = function (utc) {

package/dist/dts/utils/types.d.ts

@@ -317,6 +317,34 @@ export type RangeTuple<T, Min extends number, Max extends number> = $Range<Min,
 export type ValueOptional<O, K extends keyof O = keyof O> = {
     [P in keyof O]: P extends K ? O[P] | undefined : O[P];
 };
+/**
+ * Makes selected properties optional while keeping the rest required
+ * @remarks By default all properties are optional, same as {@link Partial<T>}
+ *
+ * @example
+ * type A = { name: string; age: number };
+ * type B = PropertyOptional<A, 'name'>;
+ * // Equivalent to: { name?: string | undefined; age: number }
+ *
+ * @example
+ * type C = PropertyOptional<A>;
+ * // Equivalent to: { name?: string | undefined; age?: number | undefined }
+ */
+export type PropertyOptional<O, K extends keyof O = keyof O> = Prettify<Omit<O, K> & Partial<Pick<O, K>>>;
+/**
+ * Makes selected properties required while keeping the rest unchanged
+ * @remarks By default all properties are required, same as {@link Required<T>}
+ *
+ * @example
+ * type A = { name?: string; age: number };
+ * type B = PropertyRequired<A, 'name'>;
+ * // Equivalent to: { name: string; age: number | undefined }
+ *
+ * @example
+ * type C = PropertyRequired<A>;
+ * // Equivalent to: { name: string; age: number }
+ */
+export type PropertyRequired<O, K extends keyof O = keyof O> = Prettify<Omit<O, K> & Required<Pick<O, K>>>;
 export type $Without<T, U> = {
     [P in Exclude<keyof T, keyof U>]?: never;
 };

package/dist/esm/date/plugins/roundPlugin.js

@@ -53,7 +53,7 @@ export const roundPlugin = ($Chronos) => {
                 const diffToStart = Math.abs(date.getTime() - startOfWeek.getTime());
                 const diffToEnd = Math.abs(endOfWeek.getTime() - date.getTime());
                 const rounded = diffToEnd < diffToStart ? endOfWeek : startOfWeek;
-                return withOrigin(new $Chronos(rounded), 'round');
+                return withOrigin(new $Chronos(rounded), 'round', offset(this), this.timeZoneName, this.timeZoneId, this.$tzTracker);
             }
             case 'month': {
                 const fullMonth = date.getMonth() + date.getDate() / this.lastDateOfMonth;

package/dist/esm/date/plugins/timeZonePlugin.js

@@ -45,10 +45,14 @@ export const timeZonePlugin = ($Chronos) => {
         }
         return tzIds;
     }, new Map()));
-    const TZ_NAME_ABBR_MAP = new Map(Object.entries(TIME_ZONES).map(([tzAbbr, { offset, tzName }]) => [
-        offset,
-        { tzAbbr, tzName },
-    ]));
+    const _buildTzNameAbbrMap = () => {
+        const result = [];
+        for (const [tzAbbr, { offset, tzName }] of Object.entries(TIME_ZONES)) {
+            result.unshift([offset, { tzAbbr, tzName }]);
+        }
+        return result;
+    };
+    const TZ_NAME_ABBR_MAP = new Map(_buildTzNameAbbrMap());
     const _getTimeZoneId = (utc) => {
         const tzIds = TZ_ID_MAP.get(utc);
         if (!tzIds || tzIds?.length === 0)
@@ -118,12 +122,13 @@ export const timeZonePlugin = ($Chronos) => {
         if (!utc && tracker && _isValidTzAbbr(tracker))
             return tracker;
         if (isValidUTCOffset(tzMapKey)) {
-            if (TZ_ABBR_CACHE.has(tzMapKey))
+            if (TZ_ABBR_CACHE.has(tzMapKey)) {
                 return TZ_ABBR_CACHE.get(tzMapKey);
-            if (TZ_NAME_ABBR_MAP.has(tzMapKey)) {
-                return TZ_NAME_ABBR_MAP.get(tzMapKey)?.tzAbbr;
             }
             const tzName = _resolveTzName(tzMapKey);
+            if (!tzName && TZ_NAME_ABBR_MAP.has(tzMapKey)) {
+                return TZ_NAME_ABBR_MAP.get(tzMapKey)?.tzAbbr;
+            }
             if (tzName) {
                 const tzAbbr = _abbreviate(tzName);
                 TZ_ABBR_CACHE.set(tzMapKey, tzAbbr);
@@ -131,10 +136,12 @@ export const timeZonePlugin = ($Chronos) => {
             }
         }
         const zone = _getTimeZoneName(tzMapKey, $Date(this)) ?? UTC;
-        if (TZ_ABBR_CACHE.has(`name-${zone}`))
-            return TZ_ABBR_CACHE.get(zone);
+        const fallbackKey = `name-${zone}`;
+        if (TZ_ABBR_CACHE.has(fallbackKey)) {
+            return TZ_ABBR_CACHE.get(fallbackKey);
+        }
         const customAbbr = isValidUTCOffset(zone) ? zone : _abbreviate(zone);
-        TZ_ABBR_CACHE.set(`name-${zone}`, customAbbr);
+        TZ_ABBR_CACHE.set(fallbackKey, customAbbr);
         return customAbbr;
     };
     $Chronos.prototype.getTimeZoneNameAbbr = function (utc) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.30.1",
+  "version": "4.30.11",
   "description": "A versatile collection of smart, efficient, and reusable utility functions, classes and types for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -44,12 +44,12 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "@biomejs/biome": "^2.4.12",
+    "@biomejs/biome": "^2.4.15",
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.6.0",
+    "@types/node": "^25.8.0",
     "husky": "^9.1.7",
-    "jest": "^30.3.0",
-    "lint-staged": "^16.4.0",
+    "jest": "^30.4.2",
+    "lint-staged": "^17.0.4",
     "nhb-scripts": "^1.9.2",
     "ts-jest": "^29.4.9",
     "typescript": "^6.0.3"