nhb-toolbox 4.26.51 → 4.26.54

package/CHANGELOG.md

@@ -6,6 +6,12 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.26.54] - 2025-11-15
+
+- **Added** new *guard* utility: `isNativeTimeZoneId` with new constant for type interfaces using `Intl` API.
+- **Updated** `isValidTimeZoneId` *guard* with new *array constant* for checking.
+- **Updated** tsdoc: **added** *remarks* and **fixed** *reference links* in some *functions* and `Chronos` *methods*.
+
 ## [4.26.50-51] - 2025-11-14
 
 - **Updated** `TimeZoneIdentifier` type: now **excludes** `Factory` and *time zone abbreviations* already present in `TimeZone` literal type. **Created** new `$TimeZoneIdentifier` type as *replacement*.

package/dist/cjs/constants.js

@@ -1,15 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STATUS_CODES = exports.HTTP_STATUS_CODES = exports.HTTP_STATUS = exports.HTTP_CODES = exports.COUNTRIES = exports.CATEGORIZED_UNITS = exports.LOWERCASED_WORDS = exports.LOCALE_CODES = exports.GENERAL_UNITS = exports.FRANKFURTER_CURRENCIES = exports.CURRENCY_LOCALES = exports.CURRENCY_CODES = exports.CSS_COLORS = exports.NUMBER_COLOR_PALETTE = exports.ALPHABET_COLOR_PALETTE = exports.WESTERN_SEASONS = exports.US_ACADEMIC_SEASONS = exports.SEASON_PRESETS = exports.PHILIPPINES_SEASONS = exports.JAPAN_SEASONS = exports.INDIA_VEDIC_SEASONS = exports.INDIA_TAMIL_SEASONS = exports.INDIA_IMD_SEASONS = exports.ETHIOPIA_SEASONS = exports.BANGLADESH_SEASONS = exports.AUSTRALIA_SEASONS = exports.TIME_ZONES = exports.TIME_ZONE_LABELS = exports.TIME_ZONE_IDS = exports.WESTERN_ZODIAC_SIGNS = exports.WEEK_DAYS = exports.VEDIC_ZODIAC_SIGNS = exports.MONTHS = void 0;
+exports.STATUS_CODES = exports.HTTP_STATUS_CODES = exports.HTTP_STATUS = exports.HTTP_CODES = exports.COUNTRIES = exports.CATEGORIZED_UNITS = exports.LOWERCASED_WORDS = exports.LOCALE_CODES = exports.GENERAL_UNITS = exports.FRANKFURTER_CURRENCIES = exports.CURRENCY_LOCALES = exports.CURRENCY_CODES = exports.CSS_COLORS = exports.NUMBER_COLOR_PALETTE = exports.ALPHABET_COLOR_PALETTE = exports.WESTERN_SEASONS = exports.US_ACADEMIC_SEASONS = exports.SEASON_PRESETS = exports.PHILIPPINES_SEASONS = exports.JAPAN_SEASONS = exports.INDIA_VEDIC_SEASONS = exports.INDIA_TAMIL_SEASONS = exports.INDIA_IMD_SEASONS = exports.ETHIOPIA_SEASONS = exports.BANGLADESH_SEASONS = exports.AUSTRALIA_SEASONS = exports.TZ_ABBREVIATIONS = exports.TIME_ZONES_NATIVE = exports.TIME_ZONES = exports.TIME_ZONE_LABELS = exports.TIME_ZONE_IDS = exports.IANA_TZ_IDS = exports.WESTERN_ZODIAC_SIGNS = exports.WEEK_DAYS = exports.VEDIC_ZODIAC_SIGNS = exports.MONTHS = void 0;
 var constants_1 = require("./date/constants");
 Object.defineProperty(exports, "MONTHS", { enumerable: true, get: function () { return constants_1.MONTHS; } });
 Object.defineProperty(exports, "VEDIC_ZODIAC_SIGNS", { enumerable: true, get: function () { return constants_1.VEDIC_ZODIAC_SIGNS; } });
 Object.defineProperty(exports, "WEEK_DAYS", { enumerable: true, get: function () { return constants_1.DAYS; } });
 Object.defineProperty(exports, "WESTERN_ZODIAC_SIGNS", { enumerable: true, get: function () { return constants_1.WESTERN_ZODIAC_SIGNS; } });
 var timezone_1 = require("./date/timezone");
+Object.defineProperty(exports, "IANA_TZ_IDS", { enumerable: true, get: function () { return timezone_1.IANA_TZ_IDS; } });
 Object.defineProperty(exports, "TIME_ZONE_IDS", { enumerable: true, get: function () { return timezone_1.TIME_ZONE_IDS; } });
 Object.defineProperty(exports, "TIME_ZONE_LABELS", { enumerable: true, get: function () { return timezone_1.TIME_ZONE_LABELS; } });
 Object.defineProperty(exports, "TIME_ZONES", { enumerable: true, get: function () { return timezone_1.TIME_ZONES; } });
+Object.defineProperty(exports, "TIME_ZONES_NATIVE", { enumerable: true, get: function () { return timezone_1.TIME_ZONES_NATIVE; } });
+Object.defineProperty(exports, "TZ_ABBREVIATIONS", { enumerable: true, get: function () { return timezone_1.TIME_ZONES; } });
 var seasons_1 = require("./date/seasons");
 Object.defineProperty(exports, "AUSTRALIA_SEASONS", { enumerable: true, get: function () { return seasons_1.AUSTRALIA_SEASONS; } });
 Object.defineProperty(exports, "BANGLADESH_SEASONS", { enumerable: true, get: function () { return seasons_1.BANGLADESH_SEASONS; } });

package/dist/cjs/date/Chronos.js

@@ -121,7 +121,7 @@ class Chronos {
             case 'utc':
                 return this.#toLocalISOString().replace(this.getUTCOffset(), 'Z');
             default:
-                return this.#toLocalISOString();
+                return this.#toLocalISOString(this.#offset);
         }
     }
     get [Symbol.isConcatSpreadable]() {
@@ -234,9 +234,9 @@ class Chronos {
         }
         return result;
     }
-    #toLocalISOString() {
+    #toLocalISOString(offset) {
         const pad = (n, p = 2) => String(n).padStart(p, '0');
-        return `${this.year}-${pad(this.month + 1)}-${pad(this.date)}T${pad(this.hour)}:${pad(this.minute)}:${pad(this.second)}.${pad(this.millisecond, 3)}${this.getUTCOffset()}`;
+        return `${this.year}-${pad(this.month + 1)}-${pad(this.date)}T${pad(this.hour)}:${pad(this.minute)}:${pad(this.second)}.${pad(this.millisecond, 3)}${offset ? offset.slice(3) : this.getUTCOffset()}`;
     }
     #removeUTCFromISO(local = false) {
         return local ?
@@ -310,8 +310,12 @@ class Chronos {
                 const chronos = this.addMinutes(offset);
                 return new Date(chronos.#date);
             }
-            default:
-                return new Date(this.#date);
+            default: {
+                const offset = -(0, utils_1.extractMinutesFromUTC)(this.#offset) - this.#date.getTimezoneOffset();
+                const newDate = new Date(this.#date);
+                newDate.setMinutes(newDate.getMinutes() + offset);
+                return new Date(newDate);
+            }
         }
     }
     toString() {
@@ -341,7 +345,7 @@ class Chronos {
     toISOString() {
         switch (this.#ORIGIN) {
             case 'timeZone':
-                return this.#toLocalISOString().replace(this.getUTCOffset(), this.#offset.slice(3));
+                return this.#toLocalISOString(this.#offset);
             case 'toUTC':
             case 'utc':
                 return this.#toLocalISOString().replace(this.getUTCOffset(), 'Z');
@@ -372,37 +376,37 @@ class Chronos {
     addSeconds(seconds) {
         const newDate = new Date(this.#date);
         newDate.setSeconds(newDate.getSeconds() + seconds);
-        return new _a(newDate).#withOrigin('addSeconds');
+        return new _a(newDate).#withOrigin('addSeconds', this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     addMinutes(minutes) {
         const newDate = new Date(this.#date);
         newDate.setMinutes(newDate.getMinutes() + minutes);
-        return new _a(newDate).#withOrigin('addMinutes');
+        return new _a(newDate).#withOrigin('addMinutes', this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     addHours(hours) {
         const newDate = new Date(this.#date);
         newDate.setHours(newDate.getHours() + hours);
-        return new _a(newDate).#withOrigin('addHours');
+        return new _a(newDate).#withOrigin('addHours', this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     addDays(days) {
         const newDate = new Date(this.#date);
         newDate.setDate(newDate.getDate() + days);
-        return new _a(newDate).#withOrigin('addDays');
+        return new _a(newDate).#withOrigin('addDays', this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     addWeeks(weeks) {
         const newDate = new Date(this.#date);
         newDate.setDate(newDate.getDate() + weeks * 7);
-        return new _a(newDate).#withOrigin('addWeeks');
+        return new _a(newDate).#withOrigin('addWeeks', this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     addMonths(months) {
         const newDate = new Date(this.#date);
         newDate.setMonth(newDate.getMonth() + months);
-        return new _a(newDate).#withOrigin('addMonths');
+        return new _a(newDate).#withOrigin('addMonths', this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     addYears(years) {
         const newDate = new Date(this.#date);
         newDate.setFullYear(newDate.getFullYear() + years);
-        return new _a(newDate).#withOrigin('addYears');
+        return new _a(newDate).#withOrigin('addYears', this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     isLeapYear(year) {
         return (0, guards_1.isLeapYear)(year ?? this.year);
@@ -473,13 +477,13 @@ class Chronos {
         const year = this.#date.getFullYear();
         const month = this.#date.getMonth();
         const lastDate = new Date(year, month, 1);
-        return new _a(lastDate).#withOrigin('firstDayOfMonth');
+        return new _a(lastDate).#withOrigin('firstDayOfMonth', this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     lastDayOfMonth() {
         const year = this.#date.getFullYear();
         const month = this.#date.getMonth() + 1;
         const lastDate = new Date(year, month, 0);
-        return new _a(lastDate).#withOrigin('lastDayOfMonth');
+        return new _a(lastDate).#withOrigin('lastDayOfMonth', this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     startOf(unit, weekStartsOn = 0) {
         const d = new Date(this.#date);
@@ -514,13 +518,13 @@ class Chronos {
             case 'millisecond':
                 break;
         }
-        return new _a(d).#withOrigin('startOf');
+        return new _a(d).#withOrigin('startOf', this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     endOf(unit, weekStartsOn = 0) {
         return this.startOf(unit, weekStartsOn)
             .add(1, unit)
             .add(-1, 'millisecond')
-            .#withOrigin('endOf');
+            .#withOrigin('endOf', this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     add(number, unit) {
         const d = new Date(this.#date);
@@ -550,10 +554,10 @@ class Chronos {
                 d.setFullYear(d.getFullYear() + number);
                 break;
         }
-        return new _a(d).#withOrigin('add');
+        return new _a(d).#withOrigin('add', this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     subtract(number, unit) {
-        return this.add(-number, unit).#withOrigin('subtract');
+        return this.add(-number, unit).#withOrigin('subtract', this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     get(unit) {
         switch (unit) {
@@ -602,7 +606,7 @@ class Chronos {
                 d.setMilliseconds(value);
                 break;
         }
-        return new _a(d).#withOrigin('set');
+        return new _a(d).#withOrigin('set', this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     diff(other, unit) {
         const time = other instanceof _a ? other : new _a(other);
@@ -692,7 +696,7 @@ class Chronos {
         d.setFullYear(weekStart.getFullYear());
         d.setMonth(weekStart.getMonth());
         d.setDate(weekStart.getDate());
-        return new _a(d).#withOrigin('setWeek');
+        return new _a(d).#withOrigin('setWeek', this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     getWeek() {
         const target = this.startOf('week', 1).add(3, 'day');
@@ -888,11 +892,11 @@ class Chronos {
     static utc(dateLike) {
         const chronos = new _a(dateLike);
         if (chronos.#offset === 'UTC+00:00') {
-            return chronos.#withOrigin('utc', 'UTC+00:00', 'Greenwich Mean Time');
+            return chronos.#withOrigin('utc', 'UTC+00:00', 'Greenwich Mean Time', 'UTC');
         }
         const offset = chronos.getTimeZoneOffsetMinutes();
         const utc = new Date(chronos.#date.getTime() - offset * 60 * 1000);
-        return new _a(utc).#withOrigin('utc', 'UTC+00:00', 'Greenwich Mean Time');
+        return new _a(utc).#withOrigin('utc', 'UTC+00:00', 'Greenwich Mean Time', 'UTC');
     }
     static formatTimePart(time, format) {
         function normalizeOffset(timeStr) {

package/dist/cjs/date/guards.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isValidTime = isValidTime;
 exports.isValidUTCOffset = isValidUTCOffset;
 exports.isValidTimeZoneId = isValidTimeZoneId;
+exports.isNativeTimeZoneId = isNativeTimeZoneId;
 exports.isLeapYear = isLeapYear;
 exports.isDateLike = isDateLike;
 const primitives_1 = require("../guards/primitives");
@@ -23,7 +24,10 @@ function isValidUTCOffset(value) {
     return (0, primitives_1.isString)(value) ? /^UTC[+-]?\d{1,2}:\d{2}$/.test(value) : false;
 }
 function isValidTimeZoneId(value) {
-    return (0, primitives_1.isString)(value) ? value !== 'Factory' && value in timezone_1.TIME_ZONE_IDS : false;
+    return (0, primitives_1.isString)(value) ? [...timezone_1.IANA_TZ_IDS].includes(value) : false;
+}
+function isNativeTimeZoneId(value) {
+    return (0, primitives_1.isString)(value) ? Intl.supportedValuesOf('timeZone').includes(value) : false;
 }
 function isLeapYear(year) {
     const $year = (0, utilities_1.normalizeNumber)(year);

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

@@ -78,7 +78,7 @@ const roundPlugin = (ChronosClass) => {
             default:
                 return this;
         }
-        return withOrigin(new ChronosClass(date), 'round');
+        return withOrigin(new ChronosClass(date), 'round', this.utcOffset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     };
 };
 exports.roundPlugin = roundPlugin;

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

@@ -103,9 +103,7 @@ const timeZonePlugin = (ChronosClass) => {
         }
         const $zone = zone || offset;
         const tzName = _getTimeZoneName($zone, $Date(this)) ?? offset;
-        const targetOffset = (0, utils_1.extractMinutesFromUTC)(offset);
-        const previousOffset = this.getTimeZoneOffsetMinutes();
-        const relativeOffset = targetOffset - previousOffset;
+        const relativeOffset = (0, utils_1.extractMinutesFromUTC)(offset) - this.getTimeZoneOffsetMinutes();
         const adjustedTime = new Date($Date(this).getTime() + relativeOffset * 60 * 1000);
         const instance = new ChronosClass(adjustedTime);
         return withOrigin(instance, `timeZone`, offset, tzName, tzId, $zone);
@@ -128,7 +126,7 @@ const timeZonePlugin = (ChronosClass) => {
         const tzMapKey = utc || tracker || this.utcOffset;
         if (_isGMT(tzMapKey))
             return 'GMT';
-        if (!utc && tracker && tracker in timezone_1.TIME_ZONES)
+        if (!utc && tracker && _isValidTzAbbr(tracker))
             return tracker;
         if ((0, guards_1.isValidUTCOffset)(tzMapKey)) {
             if (TZ_ABBR_CACHE.has(tzMapKey))