nhb-toolbox 4.26.61 → 4.26.64

package/CHANGELOG.md

@@ -6,6 +6,13 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.26.64] - 2025-11-17
+
+### 🕧 Fixes in Chronos
+
+- **Fixed** *timestamp handling*: `timestamp`, `unix`, `valueOf()`, and `getTimeStamp()` now consistently use/return the correct **universal timestamp**.
+- **Improved** `min(...)` and `max(...)` methods to return a new *immutable* `Chronos` instance while preserving the *internal state* of the **winning instance** (timezone info, offset, and origin).
+
 ## [4.26.61] - 2025-11-17
 
 - **Fixed** issue with `Chronos` *format methods* not formatting correctly when `useUTC` is `true`.

package/dist/cjs/date/Chronos.js

@@ -97,6 +97,9 @@ class Chronos {
     $getNativeTimeZoneId() {
         return Intl.DateTimeFormat().resolvedOptions().timeZone;
     }
+    get #timestamp() {
+        return this.#date.getTime();
+    }
     #toNewDate(value) {
         const date = value instanceof _a ? value.toDate() : new Date(value ?? Date.now());
         if (isNaN(date.getTime())) {
@@ -242,10 +245,10 @@ class Chronos {
         return (this.month + 1);
     }
     get unix() {
-        return Math.floor(this.#date.getTime() / 1000);
+        return Math.floor(this.getTimeStamp() / 1000);
     }
     get timestamp() {
-        return this.#date.getTime();
+        return this.getTimeStamp();
     }
     get lastDateOfMonth() {
         return this.daysInMonth();
@@ -283,7 +286,7 @@ class Chronos {
         return this.toUTC().toDate().toLocaleString(locales, options);
     }
     getTimeStamp() {
-        return this.#date.getTime();
+        return this.toDate().getTime();
     }
     format(format, useUTC = false) {
         return this.#format(format ?? 'dd, mmm DD, YYYY HH:mm:ss', useUTC);
@@ -319,31 +322,31 @@ class Chronos {
         return (0, guards_1.isLeapYear)(year ?? this.year);
     }
     isEqual(other) {
-        const time = other instanceof _a ? other : new _a(other);
-        return this.timestamp === time.timestamp;
+        const time = _a.#cast(other);
+        return this.#timestamp === time.#timestamp;
     }
     isEqualOrBefore(other) {
-        const time = other instanceof _a ? other : new _a(other);
-        return this.timestamp <= time.timestamp;
+        const time = _a.#cast(other);
+        return this.#timestamp <= time.#timestamp;
     }
     isEqualOrAfter(other) {
-        const time = other instanceof _a ? other : new _a(other);
-        return this.timestamp >= time.timestamp;
+        const time = _a.#cast(other);
+        return this.#timestamp >= time.#timestamp;
     }
     isSame(other, unit, weekStartsOn = 0) {
-        const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).timestamp ===
-            time.startOf(unit, weekStartsOn).timestamp);
+        const time = _a.#cast(other);
+        return (this.startOf(unit, weekStartsOn).#timestamp ===
+            time.startOf(unit, weekStartsOn).#timestamp);
     }
     isBefore(other, unit, weekStartsOn = 0) {
-        const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).timestamp <
-            time.startOf(unit, weekStartsOn).timestamp);
+        const time = _a.#cast(other);
+        return (this.startOf(unit, weekStartsOn).#timestamp <
+            time.startOf(unit, weekStartsOn).#timestamp);
     }
     isAfter(other, unit, weekStartsOn = 0) {
-        const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).timestamp >
-            time.startOf(unit, weekStartsOn).timestamp);
+        const time = _a.#cast(other);
+        return (this.startOf(unit, weekStartsOn).#timestamp >
+            time.startOf(unit, weekStartsOn).#timestamp);
     }
     isSameOrBefore(other, unit, weekStartsOn = 0) {
         return (this.isSame(other, unit, weekStartsOn) || this.isBefore(other, unit, weekStartsOn));
@@ -510,7 +513,7 @@ class Chronos {
         return this.#cloneStates(new _a(d), 'set');
     }
     diff(other, unit) {
-        const time = other instanceof _a ? other : new _a(other);
+        const time = _a.#cast(other);
         const msDiff = this.#date.getTime() - time.#date.getTime();
         switch (unit) {
             case 'millisecond':
@@ -828,10 +831,24 @@ class Chronos {
         return result;
     }
     static min(...dates) {
-        return new _a(Math.min(...dates.map((d) => new _a(d).valueOf()))).#withOrigin('min');
+        let winner = _a.#cast(dates[0]);
+        for (const d of dates) {
+            const c = _a.#cast(d);
+            if (c.timestamp < winner.timestamp) {
+                winner = c;
+            }
+        }
+        return winner.#cloneStates(winner, winner.#ORIGIN !== 'root' ? winner.#ORIGIN : 'min');
     }
     static max(...dates) {
-        return new _a(Math.max(...dates.map((d) => new _a(d).valueOf()))).#withOrigin('max');
+        let winner = _a.#cast(dates[0]);
+        for (const d of dates) {
+            const c = _a.#cast(d);
+            if (c.timestamp > winner.timestamp) {
+                winner = c;
+            }
+        }
+        return winner.#cloneStates(winner, winner.#ORIGIN !== 'root' ? winner.#ORIGIN : 'max');
     }
     static isLeapYear(date) {
         let year;
@@ -866,6 +883,9 @@ class Chronos {
     static register(plugin) {
         _a.use(plugin);
     }
+    static #cast(date) {
+        return date instanceof _a ? date : new _a(date);
+    }
 }
 exports.Chronos = Chronos;
 _a = Chronos;

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

@@ -756,13 +756,29 @@ export declare class Chronos {
      */
     static getDatesForDay(day: WeekDay, options?: DateRangeOptions): string[];
     /**
-     * @static Returns earliest Chronos.
-     * @param dates Date inputs.
+     * @static Returns the earliest `Chronos` instance based on the underlying universal {@link timestamp}.
+     *
+     * @remarks
+     * - All inputs are normalized to `Chronos` instances before comparison.
+     * - Comparison is always performed using each instance's **UTC timestamp**, ensuring a consistent and timezone-agnostic result.
+     * - When exactly two values are provided, the first value becomes the initial candidate; if the second value represents an earlier moment in time, it replaces the candidate.
+     * - The returned value is **not** one of the input objects. A new immutable `Chronos` instance is always created. Its internal timezone, offset, name, and tracking information are cloned from the winning input instance.
+     *
+     * @param dates A list of Chronos-compatible inputs (`string`, `number`, `Date` or `Chronos`).
+     * @returns A new `Chronos` instance representing the earliest moment.
      */
     static min(...dates: ChronosInput[]): Chronos;
     /**
-     * @static Returns latest Chronos.
-     * @param dates Date inputs.
+     * @static Returns the latest `Chronos` instance based on the underlying universal {@link timestamp}.
+     *
+     * @remarks
+     * - All inputs are normalized to `Chronos` instances before comparison.
+     * - Comparison is always performed using each instance's **UTC timestamp**, ensuring a consistent and timezone-agnostic result.
+     * - When exactly two values are provided, the first value becomes the initial candidate; if the second value represents a later moment in time, it replaces the candidate.
+     * - The returned value is **not** one of the input objects. A new immutable `Chronos` instance is always created. Its internal timezone, offset, name, and tracking information are cloned from the winning input instance.
+     *
+     * @param dates A list of Chronos-compatible inputs (`string`, `number`, `Date` or `Chronos`).
+     * @returns A new `Chronos` instance representing the latest moment.
      */
     static max(...dates: ChronosInput[]): Chronos;
     /**

package/dist/dts/date/chronos-fn.d.ts

@@ -48,6 +48,7 @@ import type { ChronosStatics } from './types';
  * chronos.formatTimePart(time: string, format?: TimeParts): string;
  * chronos.getDatesForDay(day: WeekDay, options?: WeekdayOptions): string[];
  * chronos.use(plugin: ChronosPlugin): void;
+ * chronos.register(plugin: ChronosPlugin): void;
  * ```
  */
 declare const chronosStatics: ChronosStatics;

package/dist/esm/date/Chronos.js

@@ -94,6 +94,9 @@ export class Chronos {
     $getNativeTimeZoneId() {
         return Intl.DateTimeFormat().resolvedOptions().timeZone;
     }
+    get #timestamp() {
+        return this.#date.getTime();
+    }
     #toNewDate(value) {
         const date = value instanceof _a ? value.toDate() : new Date(value ?? Date.now());
         if (isNaN(date.getTime())) {
@@ -239,10 +242,10 @@ export class Chronos {
         return (this.month + 1);
     }
     get unix() {
-        return Math.floor(this.#date.getTime() / 1000);
+        return Math.floor(this.getTimeStamp() / 1000);
     }
     get timestamp() {
-        return this.#date.getTime();
+        return this.getTimeStamp();
     }
     get lastDateOfMonth() {
         return this.daysInMonth();
@@ -280,7 +283,7 @@ export class Chronos {
         return this.toUTC().toDate().toLocaleString(locales, options);
     }
     getTimeStamp() {
-        return this.#date.getTime();
+        return this.toDate().getTime();
     }
     format(format, useUTC = false) {
         return this.#format(format ?? 'dd, mmm DD, YYYY HH:mm:ss', useUTC);
@@ -316,31 +319,31 @@ export class Chronos {
         return isLeapYear(year ?? this.year);
     }
     isEqual(other) {
-        const time = other instanceof _a ? other : new _a(other);
-        return this.timestamp === time.timestamp;
+        const time = _a.#cast(other);
+        return this.#timestamp === time.#timestamp;
     }
     isEqualOrBefore(other) {
-        const time = other instanceof _a ? other : new _a(other);
-        return this.timestamp <= time.timestamp;
+        const time = _a.#cast(other);
+        return this.#timestamp <= time.#timestamp;
     }
     isEqualOrAfter(other) {
-        const time = other instanceof _a ? other : new _a(other);
-        return this.timestamp >= time.timestamp;
+        const time = _a.#cast(other);
+        return this.#timestamp >= time.#timestamp;
     }
     isSame(other, unit, weekStartsOn = 0) {
-        const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).timestamp ===
-            time.startOf(unit, weekStartsOn).timestamp);
+        const time = _a.#cast(other);
+        return (this.startOf(unit, weekStartsOn).#timestamp ===
+            time.startOf(unit, weekStartsOn).#timestamp);
     }
     isBefore(other, unit, weekStartsOn = 0) {
-        const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).timestamp <
-            time.startOf(unit, weekStartsOn).timestamp);
+        const time = _a.#cast(other);
+        return (this.startOf(unit, weekStartsOn).#timestamp <
+            time.startOf(unit, weekStartsOn).#timestamp);
     }
     isAfter(other, unit, weekStartsOn = 0) {
-        const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).timestamp >
-            time.startOf(unit, weekStartsOn).timestamp);
+        const time = _a.#cast(other);
+        return (this.startOf(unit, weekStartsOn).#timestamp >
+            time.startOf(unit, weekStartsOn).#timestamp);
     }
     isSameOrBefore(other, unit, weekStartsOn = 0) {
         return (this.isSame(other, unit, weekStartsOn) || this.isBefore(other, unit, weekStartsOn));
@@ -507,7 +510,7 @@ export class Chronos {
         return this.#cloneStates(new _a(d), 'set');
     }
     diff(other, unit) {
-        const time = other instanceof _a ? other : new _a(other);
+        const time = _a.#cast(other);
         const msDiff = this.#date.getTime() - time.#date.getTime();
         switch (unit) {
             case 'millisecond':
@@ -825,10 +828,24 @@ export class Chronos {
         return result;
     }
     static min(...dates) {
-        return new _a(Math.min(...dates.map((d) => new _a(d).valueOf()))).#withOrigin('min');
+        let winner = _a.#cast(dates[0]);
+        for (const d of dates) {
+            const c = _a.#cast(d);
+            if (c.timestamp < winner.timestamp) {
+                winner = c;
+            }
+        }
+        return winner.#cloneStates(winner, winner.#ORIGIN !== 'root' ? winner.#ORIGIN : 'min');
     }
     static max(...dates) {
-        return new _a(Math.max(...dates.map((d) => new _a(d).valueOf()))).#withOrigin('max');
+        let winner = _a.#cast(dates[0]);
+        for (const d of dates) {
+            const c = _a.#cast(d);
+            if (c.timestamp > winner.timestamp) {
+                winner = c;
+            }
+        }
+        return winner.#cloneStates(winner, winner.#ORIGIN !== 'root' ? winner.#ORIGIN : 'max');
     }
     static isLeapYear(date) {
         let year;
@@ -863,6 +880,9 @@ export class Chronos {
     static register(plugin) {
         _a.use(plugin);
     }
+    static #cast(date) {
+        return date instanceof _a ? date : new _a(date);
+    }
 }
 _a = Chronos;
 export { chronos } from './chronos-fn.js';

package/package.json

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