nhb-toolbox 4.28.70 → 4.28.71

package/CHANGELOG.md

@@ -4,6 +4,10 @@
 
 All notable changes to the package will be documented here.
 
+## [4.28.71] - 2026-02-06
+
+- **Fixed** an *issue* in `reconstruct` method of `Chronos` class where the *internal state* of the reconstructed instance was not properly when the timezone offset is different from the local system's timezone offset.
+
 ## [4.28.70] - 2026-02-06
 
 - **Added** *new static methods*: `isReconstructable` and `reconstruct` to `Chronos` class for *validating* and *reconstructing* instances from plain objects.

package/dist/cjs/date/Chronos.js

@@ -813,7 +813,11 @@ class Chronos {
             throw new TypeError('Invalid input for reconstruction!');
         }
         const { native, origin, utcOffset, timeZoneName, timeZoneId, $tzTracker } = value;
-        return new _a(native).#withOrigin(origin, utcOffset, timeZoneName, timeZoneId, $tzTracker);
+        const offsetMins = (0, utils_1.extractMinutesFromUTC)(utcOffset);
+        const instance = new _a(native);
+        const diffMins = instance.getTimeZoneOffsetMinutes() - offsetMins;
+        const target = instance.utcOffset === utcOffset ? instance : instance.add(-diffMins, 'minute');
+        return target.#withOrigin(origin, utcOffset, timeZoneName, timeZoneId, $tzTracker);
     }
     static use(plugin) {
         if (!_a.#plugins.has(plugin)) {

package/dist/cjs/date/helpers.js

@@ -166,6 +166,9 @@ function _hasChronosProperties(value) {
         'timeZoneName',
         'timeZoneId',
     ]) &&
+        (0, primitives_1.isNonEmptyString)(value.origin) &&
         ((0, non_primitives_1.isDate)(value.native) || (0, specials_1.isDateString)(value.native)) &&
-        (0, guards_1.isValidUTCOffset)(value.utcOffset));
+        (0, guards_1.isValidUTCOffset)(value.utcOffset) &&
+        (0, primitives_1.isNonEmptyString)(value.timeZoneName) &&
+        ((0, primitives_1.isNonEmptyString)(value.timeZoneId) || (0, non_primitives_1.isValidArray)(value.timeZoneId)));
 }

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

@@ -248,12 +248,19 @@ export type ChronosMethods = $InstanceMethods | $StaticMethods | $PluginMethods;
  * and convert it to the **equivalent local time** using the current environment's UTC offset.*
  */
 export type ChronosInput = number | string | Date | Chronos;
+/** Properties required to reconstruct a `Chronos` instance. */
 export interface ChronosProperties {
+    /** The method or plugin name from which the instance was created. */
     origin: LooseLiteral<ChronosMethods>;
+    /** The native date value, either as a `Date` object or a date string. */
     native: Date | string;
+    /** The UTC offset in `UTC±HH:mm` format. */
     utcOffset: UTCOffset;
+    /** The full time zone name (e.g., `"Pacific Standard Time"`). */
     timeZoneName: LooseLiteral<TimeZoneName>;
+    /** The time zone identifier(s) associated with the instance (e.g., `"Asia/Dhaka"`). */
     timeZoneId: TimeZoneId;
+    /** Optional tracker to identify the instance created by `timeZone` method. */
     $tzTracker?: $TimeZoneIdentifier | TimeZone | UTCOffset;
 }
 /** Represents key of `ChronosStatics` (each static method and property) */

package/dist/esm/date/Chronos.js

@@ -810,7 +810,11 @@ export class Chronos {
             throw new TypeError('Invalid input for reconstruction!');
         }
         const { native, origin, utcOffset, timeZoneName, timeZoneId, $tzTracker } = value;
-        return new _a(native).#withOrigin(origin, utcOffset, timeZoneName, timeZoneId, $tzTracker);
+        const offsetMins = extractMinutesFromUTC(utcOffset);
+        const instance = new _a(native);
+        const diffMins = instance.getTimeZoneOffsetMinutes() - offsetMins;
+        const target = instance.utcOffset === utcOffset ? instance : instance.add(-diffMins, 'minute');
+        return target.#withOrigin(origin, utcOffset, timeZoneName, timeZoneId, $tzTracker);
     }
     static use(plugin) {
         if (!_a.#plugins.has(plugin)) {

package/dist/esm/date/helpers.js

@@ -1,5 +1,5 @@
-import { isDate, isObjectWithKeys } from '../guards/non-primitives.js';
-import { isString } from '../guards/primitives.js';
+import { isDate, isObjectWithKeys, isValidArray } from '../guards/non-primitives.js';
+import { isNonEmptyString, isString } from '../guards/primitives.js';
 import { isDateString } from '../guards/specials.js';
 import { getOrdinal } from '../number/utilities.js';
 import { BN_MONTH_TABLES, BN_SEASONS, BN_YEAR_OFFSET, DAYS, MONTHS, MS_PER_DAY, SORTED_TIME_FORMATS, } from './constants.js';
@@ -144,6 +144,9 @@ export function _hasChronosProperties(value) {
         'timeZoneName',
         'timeZoneId',
     ]) &&
+        isNonEmptyString(value.origin) &&
         (isDate(value.native) || isDateString(value.native)) &&
-        isValidUTCOffset(value.utcOffset));
+        isValidUTCOffset(value.utcOffset) &&
+        isNonEmptyString(value.timeZoneName) &&
+        (isNonEmptyString(value.timeZoneId) || isValidArray(value.timeZoneId)));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.28.70",
+  "version": "4.28.71",
   "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",