nhb-toolbox 3.9.39 → 3.9.60

package/dist/date/Chronos.js

@@ -1,9 +1,30 @@
 import { isString } from '../guards/primitives';
 import { getOrdinal } from '../number/utilities';
 import { formatUnitWithPlural } from '../string/convert';
-import { DAYS, MONTHS, ORIGIN, sortedFormats, TIME_ZONE_LABELS, TIME_ZONES, } from './constants';
+import { DAYS, DEFAULT_RANGES, MONTHS, ORIGIN, sortedFormats, TIME_ZONE_LABELS, TIME_ZONES, } from './constants';
 import { isLeapYear, isValidUTCOffSet } from './guards';
 import { extractMinutesFromUTC, formatUTCOffset } from './utils';
+/**
+ * * Creates a new immutable `Chronos` instance.
+ *
+ * @param value - A date value (`number`, `string`, `Date`, or `Chronos` object).
+ * - If a string is provided, it should be in a format that can be parsed by the Date constructor.
+ * - If a number is provided, it should be a timestamp (milliseconds since the Unix epoch).
+ * - If a Date object is provided, it will be used as is.
+ * - If a Chronos object is provided, it will be converted to a Date object.
+ *
+ * **It also accepts number values as following:**
+ * - **`year, month, date, hours, minutes, seconds, milliseconds`**: Individual components of a date-time to construct a `Chronos` instance.
+ *   - **`year`**: A number representing the year. If the year is between 0 and 99, it will be assumed to be the year 1900 + the provided year.
+ *   - **`month`**: A number between 1 and 12 representing the month (1 for January, 12 for December). It is adjusted internally to a 0-based index (0 for January, 11 for December).
+ *   - **`date`**: A number between 1 and 31 representing the day of the month.
+ *   - **`hours`**: A number between 0 and 23 representing the hour of the day.
+ *   - **`minutes`**: A number between 0 and 59 representing the minutes past the hour.
+ *   - **`seconds`**: A number between 0 and 59 representing the seconds past the minute.
+ *   - **`milliseconds`**: A number between 0 and 999 representing the milliseconds past the second.
+ *
+ * @returns Instance of `Chronos` with all methods and properties.
+ */
 export class Chronos {
     #date;
     #offset;
@@ -11,15 +32,25 @@ export class Chronos {
     /**
      * * Creates a new immutable `Chronos` instance.
      *
-     * @param value - A date value (`number`, `string`, `Date`, or `Chronos` object).
-     * - If a string is provided, it should be in a format that can be parsed by the Date constructor.
-     * - If a number is provided, it should be a timestamp (milliseconds since the Unix epoch).
-     * - If a Date object is provided, it will be used as is.
-     * - If a Chronos object is provided, it will be converted to a Date object.
+     * @param valueOrYear The value in number, string, Date or Chronos format or the full year designation is required for cross-century date accuracy. If year is between 0 and 99 is used, then year is assumed to be 1900 + year.
+     * @param month The month as a number between 1 and 12 (January to December).
+     * @param date The date as a number between 1 and 31.
+     * @param hours Must be supplied if minutes is supplied. A number from 0 to 23 (midnight to 11pm) that specifies the hour.
+     * @param minutes Must be supplied if seconds is supplied. A number from 0 to 59 that specifies the minutes.
+     * @param seconds Must be supplied if milliseconds is supplied. A number from 0 to 59 that specifies the seconds.
+     * @param ms A number from 0 to 999 that specifies the milliseconds.
+     *
+     * @returns Instance of `Chronos` with all methods and properties.
      */
-    constructor(value) {
-        const date = this.#toNewDate(value);
-        this.#date = date;
+    constructor(valueOrYear, month, date, hours, minutes, seconds, ms) {
+        let newDate;
+        if (typeof valueOrYear === 'number' && typeof month === 'number') {
+            newDate = new Date(valueOrYear, month - 1, date ?? 1, hours ?? 0, minutes ?? 0, seconds ?? 0, ms ?? 0);
+        }
+        else {
+            newDate = this.#toNewDate(valueOrYear);
+        }
+        this.#date = newDate;
         this[ORIGIN] = 'root';
         this.#offset = `UTC${this.getUTCOffset()}`;
     }
@@ -86,20 +117,6 @@ export class Chronos {
                 return this.#toLocalISOString();
         }
     }
-    /**
-     * @private @instance Method to tag origin of the `Chronos` instance.
-     *
-     * @param origin Origin of the instance, the method name from where it was created.
-     * @param offset Optional UTC offset in `UTC+12:00` format.
-     * @returns The `Chronos` instance with the specified origin.
-     */
-    #withOrigin(origin, offset) {
-        const instance = new Chronos(this.#date);
-        instance[ORIGIN] = origin;
-        if (offset)
-            instance.#offset = offset;
-        return instance;
-    }
     /**
      * @private @instance Method to create native `Date` instance from date-like data types.
      * @param value The value to convert into `Date`.
@@ -115,6 +132,20 @@ export class Chronos {
         }
         return date;
     }
+    /**
+     * @private @instance Method to tag origin of the `Chronos` instance.
+     *
+     * @param origin Origin of the instance, the method name from where it was created.
+     * @param offset Optional UTC offset in `UTC+12:00` format.
+     * @returns The `Chronos` instance with the specified origin.
+     */
+    #withOrigin(origin, offset) {
+        const instance = new Chronos(this.#date);
+        instance[ORIGIN] = origin;
+        if (offset)
+            instance.#offset = offset;
+        return instance;
+    }
     /**
      * @private @instance Formats the current `Chronos` date using the specified template.
      *
@@ -237,23 +268,27 @@ export class Chronos {
     get unix() {
         return this.#date.getTime();
     }
-    /** @public @instance Returns a debug-friendly string for `console.log` or `util.inspect`. */
+    /** Gets the time value in milliseconds since midnight, January 1, 1970 UTC. */
+    get timestamp() {
+        return this.#date.getTime();
+    }
+    /** @instance Returns a debug-friendly string for `console.log` or `util.inspect`. */
     inspect() {
         return `[Chronos ${this.toLocalISOString()}]`;
     }
-    /** @public @instance Clones and returns a new Chronos instance with the same date. */
+    /** @instance Clones and returns a new Chronos instance with the same date. */
     clone() {
         return new Chronos(this.#date).#withOrigin(this[ORIGIN]);
     }
-    /** @public @instance Enables JSON.stringify and console logging to show readable output. */
+    /** @instance Enables JSON.stringify and console logging to show readable output. */
     toJSON() {
         return this.toLocalISOString();
     }
-    /** @public @instance Enables arithmetic and comparison operations (e.g., +new Chronos()). */
+    /** @instance Enables arithmetic and comparison operations (e.g., +new Chronos()). */
     valueOf() {
         return this.getTimeStamp();
     }
-    /** @public @instance Gets the native `Date` instance (read-only). */
+    /** @instance Gets the native `Date` instance (read-only). */
     toDate() {
         switch (this[ORIGIN]) {
             case 'toUTC':
@@ -266,7 +301,7 @@ export class Chronos {
                 return new Date(this.#date);
         }
     }
-    /** @public @instance Returns a string representation of a date. The format of the string depends on the locale. */
+    /** @instance Returns a string representation of a date. The format of the string depends on the locale. */
     toString() {
         switch (this[ORIGIN]) {
             case 'timeZone': {
@@ -286,7 +321,7 @@ export class Chronos {
                 return this.#date.toString();
         }
     }
-    /** @public @instance Returns ISO string with local time zone offset */
+    /** @instance Returns ISO string with local time zone offset */
     toLocalISOString() {
         switch (this[ORIGIN]) {
             case 'timeZone':
@@ -300,7 +335,7 @@ export class Chronos {
                 return this.#toLocalISOString();
         }
     }
-    /** @public @instance Returns a date as a string value in ISO format. */
+    /** @instance Returns a date as a string value in ISO format. */
     toISOString() {
         switch (this[ORIGIN]) {
             case 'timeZone':
@@ -313,7 +348,7 @@ export class Chronos {
         }
     }
     /**
-     * @public @instance Wrapper over native `toLocaleString`
+     * @instance Wrapper over native `toLocaleString`
      * @description Converts a date and time to a string by using the current or specified locale.
      *
      * @param locales A locale string, array of locale strings, Intl.Locale object, or array of Intl.Locale objects that contain one or more language or locale tags. If you include more than one locale string, list them in descending order of priority so that the first entry is the preferred locale. If you omit this parameter, the default locale of the JavaScript runtime is used.
@@ -322,24 +357,12 @@ export class Chronos {
     toLocaleString(locale, options) {
         return this.#date.toLocaleString(locale, options);
     }
-    /** @public @instance Returns the time value in milliseconds since midnight, January 1, 1970 UTC. */
+    /** @instance Returns the time value in milliseconds since midnight, January 1, 1970 UTC. */
     getTimeStamp() {
         return this.#date.getTime();
     }
     /**
-     * @public @instance Returns the current date and time in a specified format in local time.
-     * @description Default format is dd, `mmm DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55:379`
-     *
-     * @param options - Configure format string and whether to format using utc offset.
-     * @returns Formatted date string in desired format.
-     */
-    today(options) {
-        const { format = 'dd, mmm DD, YYYY HH:mm:ss', useUTC = false } = options || {};
-        const today = new Date();
-        return new Chronos(today).#format(format, useUTC);
-    }
-    /**
-     * @public @instance Formats the date into a custom string format (local time).
+     * @instance Formats the date into a custom string format (local time).
      *
      * @param format - The desired format (Default format is `dd, mmm DD, YYYY HH:mm:ss:mss` = `Sun, Apr 06, 2025 16:11:55:379`).
      * @param useUTC - Optional `useUTC` to get the formatted time using UTC Offset, defaults to `false`. Equivalent to `formatUTC()` method if set to `true`.
@@ -349,7 +372,7 @@ export class Chronos {
         return this.#format(format, useUTC);
     }
     /**
-     * @public @instance Formats the date into a strict custom string format (local time).
+     * @instance Formats the date into a strict custom string format (local time).
      * @description Select from `21,000+` pre-defined formats.
      *
      * @param format - The desired format (Default format is `dd, mmm DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55`).
@@ -360,7 +383,7 @@ export class Chronos {
         return this.#format(format, useUTC);
     }
     /**
-     * @public @instance Formats the date into a custom string format (UTC time).
+     * @instance Formats the date into a custom string format (UTC time).
      *
      * @param format - The desired format (Default format is `dd, mmm DD, YYYY HH:mm:ss:mss` = `Sun, Apr 06, 2025 16:11:55:379`).
      * @returns Formatted date string in desired format (UTC time).
@@ -375,7 +398,7 @@ export class Chronos {
         }
     }
     /**
-     * @public @instance Adds seconds and returns a new immutable instance.
+     * @instance Adds seconds and returns a new immutable instance.
      * @param seconds - Number of seconds to add.
      * @returns A new `Chronos` instance with the updated date.
      */
@@ -385,7 +408,7 @@ export class Chronos {
         return new Chronos(newDate).#withOrigin('addSeconds');
     }
     /**
-     * @public @instance Adds minutes and returns a new immutable instance.
+     * @instance Adds minutes and returns a new immutable instance.
      * @param minutes - Number of minutes to add.
      * @returns A new `Chronos` instance with the updated date.
      */
@@ -395,7 +418,7 @@ export class Chronos {
         return new Chronos(newDate).#withOrigin('addMinutes');
     }
     /**
-     * @public @instance Adds hours and returns a new immutable instance.
+     * @instance Adds hours and returns a new immutable instance.
      * @param hours - Number of hours to add.
      * @returns A new `Chronos` instance with the updated date.
      */
@@ -405,7 +428,7 @@ export class Chronos {
         return new Chronos(newDate).#withOrigin('addHours');
     }
     /**
-     * @public @instance Adds days and returns a new immutable instance.
+     * @instance Adds days and returns a new immutable instance.
      * @param days - Number of days to add.
      * @returns A new `Chronos` instance with the updated date.
      */
@@ -415,7 +438,7 @@ export class Chronos {
         return new Chronos(newDate).#withOrigin('addDays');
     }
     /**
-     * @public @instance Adds weeks and returns a new immutable instance.
+     * @instance Adds weeks and returns a new immutable instance.
      * @param weeks - Number of weeks to add.
      * @returns A new `Chronos` instance with the updated date.
      */
@@ -425,7 +448,7 @@ export class Chronos {
         return new Chronos(newDate).#withOrigin('addWeeks');
     }
     /**
-     * @public @instance Adds months and returns a new immutable instance.
+     * @instance Adds months and returns a new immutable instance.
      * @param months - Number of months to add.
      * @returns A new `Chronos` instance with the updated date.
      */
@@ -435,7 +458,7 @@ export class Chronos {
         return new Chronos(newDate).#withOrigin('addMonths');
     }
     /**
-     * @public @instance Adds years and returns a new immutable instance.
+     * @instance Adds years and returns a new immutable instance.
      * @param years - Number of years to add.
      * @returns A new `Chronos` instance with the updated date.
      */
@@ -445,7 +468,7 @@ export class Chronos {
         return new Chronos(newDate).#withOrigin('addYears');
     }
     /**
-     * @public @instance Create a new instance of `Chronos` in the specified timezone.
+     * @instance Create a new instance of `Chronos` in the specified timezone.
      *
      * @param zone - Standard timezone abbreviation (e.g., 'IST', 'UTC', 'EST') or UTC Offset in `UTC-01:30` format.
      * @returns A new instance of `Chronos` with time in the given timezone. Invalid input sets time-zone to `UTC`.
@@ -466,7 +489,7 @@ export class Chronos {
         return new Chronos(adjusted).#withOrigin('timeZone', stringOffset);
     }
     /**
-     * @public @instance Checks if the year is a leap year.
+     * @instance Checks if the year is a leap year.
      * - A year is a leap year if it is divisible by 4, but not divisible by 100, unless it is also divisible by 400.
      * - For example, 2000 and 2400 are leap years, but 1900 and 2100 are not.
      * @returns `true` if the year is a leap year, `false` otherwise.
@@ -475,20 +498,20 @@ export class Chronos {
         const year = this.#date.getFullYear();
         return isLeapYear(year);
     }
-    /** @public @instance Checks if the current date is today. */
+    /** @instance Checks if the current date is today. */
     isToday() {
         return this.getRelativeDay() === 0;
     }
-    /** @public @instance Checks if the current date is tomorrow. */
+    /** @instance Checks if the current date is tomorrow. */
     isTomorrow() {
         return this.getRelativeDay() === 1;
     }
-    /** @public @instance Checks if the current date is yesterday. */
+    /** @instance Checks if the current date is yesterday. */
     isYesterday() {
         return this.getRelativeDay() === -1;
     }
     /**
-     * @public @instance Checks if another date is the same as this one in a specific unit.
+     * @instance Checks if another date is the same as this one in a specific unit.
      * @param other The other date to compare.
      * @param unit The unit to compare.
      */
@@ -498,7 +521,7 @@ export class Chronos {
             time.startOf(unit).toDate().getTime());
     }
     /**
-     * @public @instance Checks if this date is before another date in a specific unit.
+     * @instance Checks if this date is before another date in a specific unit.
      * @param other The other date to compare.
      * @param unit The unit to compare.
      */
@@ -508,7 +531,7 @@ export class Chronos {
             time.startOf(unit).toDate().getTime());
     }
     /**
-     * @public @instance Checks if this date is after another date in a specific unit.
+     * @instance Checks if this date is after another date in a specific unit.
      * @param other The other date to compare.
      * @param unit The unit to compare.
      */
@@ -518,7 +541,7 @@ export class Chronos {
             time.startOf(unit).toDate().getTime());
     }
     /**
-     * @public @instance Checks if the current date is between the given start and end dates.
+     * @instance Checks if the current date is between the given start and end dates.
      *
      * @param start - The start of the range.
      * @param end - The end of the range.
@@ -545,7 +568,7 @@ export class Chronos {
                 return t > s && t < e;
         }
     }
-    /** @public @instance Checks if currently in DST */
+    /** @instance Checks if currently in DST */
     isDST() {
         const jan = new Date(this.year, 0, 1);
         const jul = new Date(this.year, 6, 1);
@@ -553,7 +576,7 @@ export class Chronos {
             this.#date.getTimezoneOffset());
     }
     /**
-     * @public @instance Returns full time difference from now (or a specified time) down to a given level.
+     * @instance Returns full time difference from now (or a specified time) down to a given level.
      *
      * @param level Determines the smallest unit to include in the output (e.g., 'minute' will show up to minutes, ignoring seconds). Defaults to `minute`.
      * @param withSuffixPrefix If `true`, adds `"in"` or `"ago"` depending on whether the time is in the future or past. Defaults to `true`.
@@ -645,7 +668,63 @@ export class Chronos {
         return `${prefix}${parts.join(' ')}${suffix}`;
     }
     /**
-     * @public @instance Returns the number of full years between the input date and now.
+     * * Returns the part of day (`'midnight', 'lateNight', 'night', 'morning', 'afternoon', 'evening'`) based on the current hour.
+     *
+     * *Supports both normal and wraparound (overnight) ranges.*
+     *
+     * @param config - Optional custom hour ranges for each part of day.
+     *                 Each range must be a tuple of strings as `[startHour, endHour]` in 24-hour format (e.g., `['06', '11']`).
+     *                 Supports wraparound ranges like `['22', '04']` that cross midnight.
+     *
+     *                 **Default Ranges:**
+     *                 - night: ['21', '23']
+     *                 - midnight: ['00', '01']
+     *                 - lateNight: ['02', '04']
+     *                 - morning: ['05', '11']
+     *                 - afternoon: ['12', '16']
+     *                 - evening: ['17', '20']
+     *
+     * @returns The current part of the day as a string.
+     *
+     * @example
+     * chronosInstance.getPartOfDay(); // e.g., 'morning'
+     *
+     * @example
+     * // Example with custom ranges
+     * chronosInstance.getPartOfDay({
+     *   night: ['22', '04'],
+     *   morning: ['05', '11'],
+     *   afternoon: ['12', '16'],
+     *   evening: ['17', '21'],
+     *   lateNight: ['01', '03'],
+     *   midnight: ['00', '00'],
+     * });
+     */
+    getPartOfDay(config) {
+        const hour = this.#date.getHours();
+        const ranges = {
+            ...DEFAULT_RANGES,
+            ...config,
+        };
+        for (const [part, [start, end]] of Object.entries(ranges)) {
+            const from = Number(start);
+            const to = Number(end);
+            if (from <= to) {
+                if (hour >= from && hour <= to) {
+                    return part;
+                }
+            }
+            else {
+                // Wraparound logic (e.g., 20 to 04 means 20–23 OR 00–04)
+                if (hour >= from || hour <= to) {
+                    return part;
+                }
+            }
+        }
+        return 'night';
+    }
+    /**
+     * @instance Returns the number of full years between the input date and now.
      * @param time Optional time to compare with the `Chronos` date/time.
      * @returns The difference in number, negative is `Chronos` time is a past time else positive.
      */
@@ -661,7 +740,7 @@ export class Chronos {
         return years;
     }
     /**
-     * @public @instance Returns the number of full months between the input date and now.
+     * @instance Returns the number of full months between the input date and now.
      * @param time Optional time to compare with the `Chronos` date/time.
      * @returns The difference in number, negative is `Chronos` time is a past time else positive.
      */
@@ -676,7 +755,7 @@ export class Chronos {
         return months;
     }
     /**
-     * @public @instance Determines if the given date is today, tomorrow, yesterday or any relative day.
+     * @instance Determines if the given date is today, tomorrow, yesterday or any relative day.
      * @param date - The date to compare (Date object).
      * @param time Optional time to compare with the `Chronos` date/time.
      * @returns
@@ -697,7 +776,7 @@ export class Chronos {
         return diffDays;
     }
     /**
-     * @public @instance Determines how many full weeks apart the input date is from the `Chronos` instance.
+     * @instance Determines how many full weeks apart the input date is from the `Chronos` instance.
      * @param time Optional time to compare with the `Chronos` date/time.
      * @returns Difference in weeks; negative if past, positive if future.
      */
@@ -706,7 +785,7 @@ export class Chronos {
         return Math.floor(relativeDays / 7);
     }
     /**
-     * @public @instance Returns the number of full hours between the input date and now.
+     * @instance Returns the number of full hours between the input date and now.
      * @param time Optional time to compare with the `Chronos` date/time.
      * @returns The difference in number, negative is `Chronos` time is a past time else positive.
      */
@@ -715,7 +794,7 @@ export class Chronos {
         return Math.floor(diff / (1000 * 60 * 60));
     }
     /**
-     * @public @instance Returns the number of full minutes between the input date and now.
+     * @instance Returns the number of full minutes between the input date and now.
      * @param time Optional time to compare with the `Chronos` date/time.
      * @returns The difference in number, negative is `Chronos` time is a past time else positive.
      */
@@ -724,7 +803,7 @@ export class Chronos {
         return Math.floor(diff / (1000 * 60));
     }
     /**
-     * @public @instance Returns the number of full seconds between the input date and now.
+     * @instance Returns the number of full seconds between the input date and now.
      * @param time Optional time to compare with the `Chronos` date/time.
      * @returns The difference in number, negative is `Chronos` time is a past time else positive.
      */
@@ -733,7 +812,7 @@ export class Chronos {
         return Math.floor(diff / 1000);
     }
     /**
-     * @public @instance Returns the number of milliseconds between the input date and now.
+     * @instance Returns the number of milliseconds between the input date and now.
      * @param time Optional time to compare with the `Chronos` date/time.
      * @returns The difference in number, negative is `Chronos` time is a past time else positive.
      */
@@ -741,7 +820,7 @@ export class Chronos {
         return this.#date.getTime() - this.#toNewDate(time).getTime();
     }
     /**
-     * @public @instance Compares the stored date with now, returning the difference in the specified unit.
+     * @instance Compares the stored date with now, returning the difference in the specified unit.
      *
      * @param unit The time unit to compare by. Defaults to 'minute'.
      * @param time Optional time to compare with the `Chronos` date/time.
@@ -770,7 +849,7 @@ export class Chronos {
         }
     }
     /**
-     * @public @instance Returns a new Chronos instance at the start of a given unit.
+     * @instance Returns a new Chronos instance at the start of a given unit.
      * @param unit The unit to reset (e.g., year, month, day).
      */
     startOf(unit) {
@@ -809,7 +888,7 @@ export class Chronos {
         return new Chronos(d).#withOrigin('startOf');
     }
     /**
-     * @public @instance Returns a new Chronos instance at the end of a given unit.
+     * @instance Returns a new Chronos instance at the end of a given unit.
      * @param unit The unit to adjust (e.g., year, month, day).
      */
     endOf(unit) {
@@ -819,7 +898,7 @@ export class Chronos {
             .#withOrigin('endOf');
     }
     /**
-     * @public @instance Returns a new Chronos instance with the specified unit added.
+     * @instance Returns a new Chronos instance with the specified unit added.
      * @param amount The amount to add (can be negative).
      * @param unit The time unit to add.
      */
@@ -854,7 +933,7 @@ export class Chronos {
         return new Chronos(d).#withOrigin('add');
     }
     /**
-     * @public @instance Returns a new Chronos instance with the specified unit subtracted.
+     * @instance Returns a new Chronos instance with the specified unit subtracted.
      * @param amount The amount to subtract (can be negative).
      * @param unit The time unit to add.
      */
@@ -862,7 +941,7 @@ export class Chronos {
         return this.add(-amount, unit).#withOrigin('subtract');
     }
     /**
-     * @public @instance Gets the value of a specific time unit from the date.
+     * @instance Gets the value of a specific time unit from the date.
      * @param unit The unit to retrieve.
      */
     get(unit) {
@@ -886,7 +965,7 @@ export class Chronos {
         }
     }
     /**
-     * @public @instance Returns a new Chronos instance with the specified unit set to the given value.
+     * @instance Returns a new Chronos instance with the specified unit set to the given value.
      * @param unit The unit to modify.
      * @param value The value to set for the unit.
      */
@@ -920,7 +999,7 @@ export class Chronos {
         return new Chronos(d).#withOrigin('set');
     }
     /**
-     * @public @instance Returns the difference between this and another date in the given unit.
+     * @instance Returns the difference between this and another date in the given unit.
      * @param other The other date to compare.
      * @param unit The unit in which to return the difference.
      */
@@ -948,7 +1027,7 @@ export class Chronos {
         }
     }
     /**
-     * @public @instance Returns a human-readable relative calendar time like "Today at 3:00 PM"
+     * @instance Returns a human-readable relative calendar time like "Today at 3:00 PM"
      * @param baseDate Optional base date to compare with.
      */
     calendar(baseDate) {
@@ -975,7 +1054,7 @@ export class Chronos {
             minute: '2-digit',
         });
     }
-    /** @public @instance Returns a short human-readable string like "2h ago", "in 5m" */
+    /** @instance Returns a short human-readable string like "2h ago", "in 5m" */
     fromNowShort() {
         const now = new Chronos();
         const diffInSeconds = this.diff(now, 'second');
@@ -1002,7 +1081,7 @@ export class Chronos {
         }
     }
     /**
-     * @public @instance Sets the date to the Monday of the specified ISO week number within the current year.
+     * @instance Sets the date to the Monday of the specified ISO week number within the current year.
      * This method assumes ISO week logic, where week 1 is the week containing January 4th.
      *
      * @param week The ISO week number (1–53) to set the date to.
@@ -1021,27 +1100,8 @@ export class Chronos {
         d.setDate(weekStart.getDate());
         return new Chronos(d).#withOrigin('setWeek');
     }
-    // /**
-    //  * @public @instance Sets the date to the Monday of the specified ISO week number and year.
-    //  * @param week ISO week number (1–53)
-    //  * @param isoYear Optional ISO week year. Defaults to the current ISO week year.
-    //  * @returns New Chronos instance set to the start of the specified ISO week.
-    //  */
-    // setISOWeek(week: number, isoYear?: number): Chronos {
-    // 	// ❗ Use calendar year instead of ISO week year unless explicitly provided
-    // 	const targetISOYear = isoYear ?? this.#date.getFullYear();
-    // 	const jan4 = new Date(Date.UTC(targetISOYear, 0, 4));
-    // 	const dayOfWeek = jan4.getUTCDay();
-    // 	const offset = (dayOfWeek + 6) % 7;
-    // 	const firstISOWeekStart = new Date(jan4);
-    // 	firstISOWeekStart.setUTCDate(jan4.getUTCDate() - offset);
-    // 	firstISOWeekStart.setUTCDate(
-    // 		firstISOWeekStart.getUTCDate() + (week - 1) * 7,
-    // 	);
-    // 	return new Chronos(firstISOWeekStart).#withOrigin('setISOWeek');
-    // }
     /**
-     * @public @instance Calculates the ISO week number of the year.
+     * @instance Calculates the ISO week number of the year.
      * @returns Week number (1-53).
      */
     getWeek() {
@@ -1053,78 +1113,50 @@ export class Chronos {
         const week = target.diff(firstThursday, 'week');
         return week;
     }
-    /** @public @instance Returns ISO week year */
+    /** @instance Returns ISO week year */
     getWeekYear() {
         const d = this.startOf('week').add(3, 'day'); // Thursday of current ISO week
         return d.year;
     }
-    // /**
-    //  * @private @instance Gets the ISO week-numbering year.
-    //  * @returns The ISO year (can differ from calendar year).
-    //  */
-    // getISOWeekYear(): number {
-    // 	const date = new Date(this.#date);
-    // 	date.setDate(date.getDate() + 4 - (date.getDay() || 7)); // Thursday of the week
-    // 	return date.getFullYear();
-    // }
-    /** @public @instance Returns day of year (1 - 366) */
+    /** @instance Returns day of year (1 - 366) */
     getDayOfYear() {
         const start = new Date(this.year, 0, 1);
         const diff = this.#date.getTime() - start.getTime();
         return Math.floor(diff / 86400000) + 1;
     }
-    /** @public @instance Returns number of days in current month */
+    /** @instance Returns number of days in current month */
     daysInMonth() {
         return new Date(this.year, this.month + 1, 0).getDate();
     }
-    /** @public @instance Converts to object with all date unit parts */
+    /** @instance Converts to object with all date unit parts */
     toObject() {
         return Object.fromEntries([...this]);
     }
-    /** @public @instance Converts to array with all date unit parts */
+    /** @instance Converts to array with all date unit parts */
     toArray() {
         return Object.values(this.toObject());
     }
-    /** @public @instance Returns offset like +06:00 */
+    /** @instance Returns offset like +06:00 */
     getUTCOffset() {
         const offset = -this.#date.getTimezoneOffset();
         const sign = offset >= 0 ? '+' : '-';
         const pad = (n) => String(Math.floor(Math.abs(n))).padStart(2, '0');
         return `${sign}${pad(offset / 60)}:${pad(offset % 60)}`;
     }
-    /** @public @instance Returns new Chronos instance in UTC */
+    /** @instance Returns new Chronos instance in UTC */
     toUTC() {
         const date = this.#date;
         const utc = new Date(date.getTime() + date.getTimezoneOffset() * 60000);
         return new Chronos(utc).#withOrigin('toUTC');
     }
-    /** @public @instance Returns new Chronos instance in local time */
+    /** @instance Returns new Chronos instance in local time */
     toLocal() {
         const date = this.#date;
         const utc = new Date(date.getTime() - date.getTimezoneOffset() * 60000);
         return new Chronos(utc).#withOrigin('toLocal');
     }
     /**
-     * @public @static Returns the current date and time in a specified format in local time.
-     * * Default format is dd, `mmm DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55:379`
-     * @param options - Configure format string and whether to format using utc offset.
-     * @returns Formatted date string in desired format.
-     */
-    static today(options) {
-        const { format = 'dd, mmm DD, YYYY HH:mm:ss', useUTC = false } = options || {};
-        const today = new Date();
-        return new Chronos(today).#format(format, useUTC);
-    }
-    /**
-     * @public @static Returns the number of milliseconds elapsed since midnight, January 1, 1970 Universal Coordinated Time (UTC).
-     * * It basically calls `Date.now()`.
-     * @returns The number of milliseconds elapsed since the Unix epoch.
-     */
-    static now() {
-        return Date.now();
-    }
-    /**
-     * @public @static Parses a date string with a given format (partial support)
+     * @static Parses a date string with a given format (partial support)
      *
      * * **Supported format tokens**:
      * - `YYYY`: Full year (e.g., 2023)
@@ -1141,15 +1173,15 @@ export class Chronos {
      * // returns Chronos instance with the parsed date 2023-12-31T15:30:45
      * ```
      *
-     * @param {string} dateStr - The date string to be parsed
-     * @param {string} format - The format of the date string. Tokens like `YYYY`, `MM`, `DD`, `HH`, `mm`, `ss` are used to specify the structure.
-     * @returns {Chronos} - A new `Chronos` instance representing the parsed date.
-     * @throws {Error} - If the date string does not match the format.
+     * @param dateStr - The date string to be parsed
+     * @param format - The format of the date string. Tokens like `YYYY`, `MM`, `DD`, `HH`, `mm`, `ss` are used to specify the structure.
+     * @returns A new `Chronos` instance representing the parsed date.
+     * @throws `Error` If the date string does not match the format.
      */
     static parse(dateStr, format) {
         const formatMap = {
             YYYY: 'year',
-            YY: 'year', // Support for two-digit year
+            YY: 'year',
             MM: 'month',
             DD: 'date',
             HH: 'hour',
@@ -1178,7 +1210,46 @@ export class Chronos {
         return new Chronos(new Date(values.year ?? 1970, (values.month ?? 1) - 1, values.date ?? 1, values.hour ?? 0, values.minute ?? 0, values.second ?? 0)).#withOrigin('parse');
     }
     /**
-     * @public @static Creates UTC Chronos
+     * @static Returns the current date and time in a specified format in local time.
+     * * Default format is dd, `mmm DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55`
+     * @param options - Configure format string and whether to format using utc offset.
+     * @returns Formatted date string in desired format.
+     */
+    static today(options) {
+        const { format = 'dd, mmm DD, YYYY HH:mm:ss', useUTC = false } = options || {};
+        const today = new Date();
+        return new Chronos(today).#format(format, useUTC);
+    }
+    /**
+     * @static Returns a new `Chronos` instance representing yesterday's date.
+     *
+     * @returns A `Chronos` instance for the previous calendar day.
+     */
+    static yesterday() {
+        const today = new Date();
+        const yesterday = today.setDate(today.getDate() - 1);
+        return new Chronos(yesterday).#withOrigin('yesterday');
+    }
+    /**
+     * @static Returns a new `Chronos` instance representing tomorrow's date.
+     *
+     * @returns A `Chronos` instance for the next calendar day.
+     */
+    static tomorrow() {
+        const today = new Date();
+        const yesterday = today.setDate(today.getDate() + 1);
+        return new Chronos(yesterday).#withOrigin('tomorrow');
+    }
+    /**
+     * @static Returns the number of milliseconds elapsed since midnight, January 1, 1970 Universal Coordinated Time (UTC).
+     * * It basically calls `Date.now()`.
+     * @returns The number of milliseconds elapsed since the Unix epoch.
+     */
+    static now() {
+        return Date.now();
+    }
+    /**
+     * @static Creates UTC Chronos
      * @param dateLike Date input to create utc time.
      */
     static utc(dateLike) {
@@ -1187,21 +1258,21 @@ export class Chronos {
         return new Chronos(utc).#withOrigin('utc');
     }
     /**
-     * @public @static Returns earliest Chronos
+     * @static Returns earliest Chronos
      * @param dates Date inputs.
      */
     static min(...dates) {
         return new Chronos(Math.min(...dates.map((d) => new Chronos(d).valueOf()))).#withOrigin('min');
     }
     /**
-     * @public @static Returns latest Chronos
+     * @static Returns latest Chronos
      * @param dates Date inputs.
      */
     static max(...dates) {
         return new Chronos(Math.max(...dates.map((d) => new Chronos(d).valueOf()))).#withOrigin('max');
     }
     /**
-     * @public @static Checks if the year in the date string or year (from 0 - 9999) is a leap year.
+     * @static Checks if the year in the date string or year (from 0 - 9999) is a leap year.
      * - A year is a leap year if it is divisible by 4, but not divisible by 100, unless it is also divisible by 400.
      * - For example, 2000 and 2400 are leap years, but 1900 and 2100 are not.
      *
@@ -1231,7 +1302,7 @@ export class Chronos {
         return isLeapYear(year);
     }
     /**
-     * @public @static Checks if the given value is a valid `Date` object.
+     * @static Checks if the given value is a valid `Date` object.
      * - A value is considered valid if it is an instance of the built-in `Date` class.
      * - This does not check whether the date itself is valid (e.g., `new Date('invalid')`).
      * @param value - The value to test.
@@ -1241,7 +1312,7 @@ export class Chronos {
         return value instanceof Date;
     }
     /**
-     * @public @static Checks if the given value is a valid date string.
+     * @static Checks if the given value is a valid date string.
      * - A value is considered a valid date string if it is a string and can be parsed by `Date.parse()`.
      * - This uses the native JavaScript date parser internally.
      * @param value - The value to test.
@@ -1251,7 +1322,7 @@ export class Chronos {
         return isString(value) && !isNaN(Date.parse(value));
     }
     /**
-     * @public @static Checks if the given value is an instance of `Chronos`.
+     * @static Checks if the given value is an instance of `Chronos`.
      * - Useful for verifying Chronos objects in type guards or validations.
      * @param value - The value to test.
      * @returns `true` if the value is an instance of `Chronos`, otherwise `false`.