nhb-toolbox 3.9.39 → 3.9.60

package/dist/date/Chronos.d.ts

@@ -1,19 +1,96 @@
 import type { LocaleCode } from '../number/types';
 import { ORIGIN } from './constants';
-import type { ChronosMethods, ChronosObject, FormatOptions, StrictFormat, TimeUnit, TimeZone, UTCOffSet } from './types';
+import type { ChronosInput, ChronosMethods, ChronosObject, DayPart, DayPartConfig, FormatOptions, StrictFormat, TimeUnit, TimeZone, UTCOffSet } from './types';
+/**
+ * * 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 declare class Chronos {
     #private;
     [ORIGIN]?: ChronosMethods | 'root';
+    /**
+     * * Creates a new immutable `Chronos` instance.
+     *
+     * Accepts no arguments (defaults to now).
+     *
+     * @returns Instance of `Chronos` with all methods and properties.
+     */
+    constructor();
+    /**
+     * * Creates a new immutable `Chronos` instance.
+     *
+     * @param value - A date value in `number`, it should be a timestamp (milliseconds since the Unix epoch).
+     *
+     * @returns Instance of `Chronos` with all methods and properties.
+     */
+    constructor(value: number);
+    /**
+     * * Creates a new immutable `Chronos` instance.
+     *
+     * @param value - A date value in `string`, it should be in a format that can be parsed by the `Date` constructor.
+     *
+     * @returns Instance of `Chronos` with all methods and properties.
+     */
+    constructor(value: string);
+    /**
+     * * Creates a new immutable `Chronos` instance.
+     *
+     * @param value - A date value as `Date` object, it will be used as is.
+     *
+     * @returns Instance of `Chronos` with all methods and properties.
+     */
+    constructor(value: Date);
+    /**
+     * * Creates a new immutable `Chronos` instance.
+     *
+     * @param value - A date value as `Chronos` object.
+     *
+     * @returns Instance of `Chronos` with all methods and properties.
+     */
+    constructor(value: Chronos);
+    /**
+     * * Creates a new immutable `Chronos` instance.
+     *
+     * @param year 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(year: number, month: number, date?: number, hours?: number, minutes?: number, seconds?: number, ms?: number);
     /**
      * * 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 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.
+     * - If a Chronos object is provided, it will be used directly.
+     *
+     * @returns Instance of `Chronos` with all methods and properties.
      */
-    constructor(value?: number | string | Date | Chronos);
+    constructor(value?: ChronosInput);
     [Symbol.iterator](): IterableIterator<[string, number]>;
     /**
      * * Enables primitive coercion like `console.log`, `${chronos}`, etc.
@@ -47,42 +124,36 @@ export declare class Chronos {
     get isoMonth(): number;
     /** Gets the time value in milliseconds since midnight, January 1, 1970 UTC. */
     get unix(): number;
-    /** @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(): number;
+    /** @instance Returns a debug-friendly string for `console.log` or `util.inspect`. */
     inspect(): string;
-    /** @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(): Chronos;
-    /** @public @instance Enables JSON.stringify and console logging to show readable output. */
+    /** @instance Enables JSON.stringify and console logging to show readable output. */
     toJSON(): string;
-    /** @public @instance Enables arithmetic and comparison operations (e.g., +new Chronos()). */
+    /** @instance Enables arithmetic and comparison operations (e.g., +new Chronos()). */
     valueOf(): number;
-    /** @public @instance Gets the native `Date` instance (read-only). */
+    /** @instance Gets the native `Date` instance (read-only). */
     toDate(): 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(): string;
-    /** @public @instance Returns ISO string with local time zone offset */
+    /** @instance Returns ISO string with local time zone offset */
     toLocalISOString(): string;
-    /** @public @instance Returns a date as a string value in ISO format. */
+    /** @instance Returns a date as a string value in ISO format. */
     toISOString(): string;
     /**
-     * @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.
      * @param options An object that contains one or more properties that specify comparison options.
      */
     toLocaleString(locale?: LocaleCode | Intl.Locale | (LocaleCode | Intl.Locale)[], options?: Intl.DateTimeFormatOptions): string;
-    /** @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(): number;
     /**
-     * @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?: FormatOptions): string;
-    /**
-     * @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`.
@@ -90,7 +161,7 @@ export declare class Chronos {
      */
     format(format?: string, useUTC?: boolean): string;
     /**
-     * @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`).
@@ -99,94 +170,94 @@ export declare class Chronos {
      */
     formatStrict(format?: StrictFormat, useUTC?: boolean): string;
     /**
-     * @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).
      */
     formatUTC(format?: string): string;
     /**
-     * @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.
      */
     addSeconds(seconds: number): Chronos;
     /**
-     * @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.
      */
     addMinutes(minutes: number): Chronos;
     /**
-     * @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.
      */
     addHours(hours: number): Chronos;
     /**
-     * @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.
      */
     addDays(days: number): Chronos;
     /**
-     * @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.
      */
     addWeeks(weeks: number): Chronos;
     /**
-     * @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.
      */
     addMonths(months: number): Chronos;
     /**
-     * @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.
      */
     addYears(years: number): Chronos;
     /**
-     * @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`.
      */
     timeZone(zone: TimeZone | UTCOffSet): Chronos;
     /**
-     * @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.
      */
     isLeapYear(): boolean;
-    /** @public @instance Checks if the current date is today. */
+    /** @instance Checks if the current date is today. */
     isToday(): boolean;
-    /** @public @instance Checks if the current date is tomorrow. */
+    /** @instance Checks if the current date is tomorrow. */
     isTomorrow(): boolean;
-    /** @public @instance Checks if the current date is yesterday. */
+    /** @instance Checks if the current date is yesterday. */
     isYesterday(): boolean;
     /**
-     * @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.
      */
-    isSame(other: number | string | Date | Chronos, unit: TimeUnit): boolean;
+    isSame(other: ChronosInput, unit: TimeUnit): boolean;
     /**
-     * @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.
      */
-    isBefore(other: number | string | Date | Chronos, unit: TimeUnit): boolean;
+    isBefore(other: ChronosInput, unit: TimeUnit): boolean;
     /**
-     * @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.
      */
-    isAfter(other: number | string | Date | Chronos, unit: TimeUnit): boolean;
+    isAfter(other: ChronosInput, unit: TimeUnit): boolean;
     /**
-     * @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.
@@ -198,32 +269,66 @@ export declare class Chronos {
      *
      * @returns `true` if the current date is within the specified range based on the `inclusive` mode.
      */
-    isBetween(start: number | string | Date | Chronos, end: number | string | Date | Chronos, inclusive?: '[]' | '[)' | '(]' | '()'): boolean;
-    /** @public @instance Checks if currently in DST */
+    isBetween(start: ChronosInput, end: ChronosInput, inclusive?: '[]' | '[)' | '(]' | '()'): boolean;
+    /** @instance Checks if currently in DST */
     isDST(): boolean;
     /**
-     * @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`.
      * @param time An optional time value to compare with (`string`, `number`, `Date`, or `Chronos` instance). Defaults to `now`.
      * @returns The difference as a human-readable string, e.g., `2 years 1 month 9 days 18 hours 56 minutes ago`.
      */
-    fromNow(level?: Exclude<TimeUnit, 'millisecond'>, withSuffixPrefix?: boolean, time?: number | string | Date | Chronos): string;
+    fromNow(level?: Exclude<TimeUnit, 'millisecond'>, withSuffixPrefix?: boolean, time?: ChronosInput): string;
     /**
-     * @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?: Partial<DayPartConfig>): DayPart;
+    /**
+     * @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.
      */
-    getRelativeYear(time?: number | string | Date | Chronos): number;
+    getRelativeYear(time?: ChronosInput): number;
     /**
-     * @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.
      */
-    getRelativeMonth(time?: number | string | Date | Chronos): number;
+    getRelativeMonth(time?: ChronosInput): number;
     /**
-     * @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
@@ -232,93 +337,93 @@ export declare class Chronos {
      *  - `1` if the date is tomorrow.
      *  - Other positive or negative numbers for other relative days (e.g., `-2` for two days ago, `2` for two days ahead).
      */
-    getRelativeDay(time?: number | string | Date | Chronos): number;
+    getRelativeDay(time?: ChronosInput): number;
     /**
-     * @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.
      */
-    getRelativeWeek(time?: number | string | Date | Chronos): number;
+    getRelativeWeek(time?: ChronosInput): number;
     /**
-     * @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.
      */
-    getRelativeHour(time?: number | string | Date | Chronos): number;
+    getRelativeHour(time?: ChronosInput): number;
     /**
-     * @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.
      */
-    getRelativeMinute(time?: number | string | Date | Chronos): number;
+    getRelativeMinute(time?: ChronosInput): number;
     /**
-     * @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.
      */
-    getRelativeSecond(time?: number | string | Date | Chronos): number;
+    getRelativeSecond(time?: ChronosInput): number;
     /**
-     * @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.
      */
-    getRelativeMilliSecond(time?: number | string | Date | Chronos): number;
+    getRelativeMilliSecond(time?: ChronosInput): number;
     /**
-     * @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.
      * @returns The difference in number, negative is `Chronos` time is a past time else positive.
      */
-    compare(unit?: TimeUnit, time?: number | string | Date | Chronos): number;
+    compare(unit?: TimeUnit, time?: ChronosInput): number;
     /**
-     * @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: TimeUnit): Chronos;
     /**
-     * @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: TimeUnit): Chronos;
     /**
-     * @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.
      */
     add(amount: number, unit: TimeUnit): Chronos;
     /**
-     * @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.
      */
     subtract(amount: number, unit: TimeUnit): Chronos;
     /**
-     * @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: TimeUnit): number;
     /**
-     * @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.
      */
     set(unit: TimeUnit, value: number): Chronos;
     /**
-     * @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.
      */
-    diff(other: number | string | Date | Chronos, unit: TimeUnit): number;
+    diff(other: ChronosInput, unit: TimeUnit): number;
     /**
-     * @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?: number | string | Date | Chronos): string;
-    /** @public @instance Returns a short human-readable string like "2h ago", "in 5m" */
+    calendar(baseDate?: ChronosInput): string;
+    /** @instance Returns a short human-readable string like "2h ago", "in 5m" */
     fromNowShort(): string;
     /**
-     * @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.
@@ -326,41 +431,28 @@ export declare class Chronos {
      */
     setWeek(week: number): Chronos;
     /**
-     * @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(): number;
-    /** @public @instance Returns ISO week year */
+    /** @instance Returns ISO week year */
     getWeekYear(): number;
-    /** @public @instance Returns day of year (1 - 366) */
+    /** @instance Returns day of year (1 - 366) */
     getDayOfYear(): number;
-    /** @public @instance Returns number of days in current month */
+    /** @instance Returns number of days in current month */
     daysInMonth(): number;
-    /** @public @instance Converts to object with all date unit parts */
+    /** @instance Converts to object with all date unit parts */
     toObject(): ChronosObject;
-    /** @public @instance Converts to array with all date unit parts */
+    /** @instance Converts to array with all date unit parts */
     toArray(): any[];
-    /** @public @instance Returns offset like +06:00 */
+    /** @instance Returns offset like +06:00 */
     getUTCOffset(): string;
-    /** @public @instance Returns new Chronos instance in UTC */
+    /** @instance Returns new Chronos instance in UTC */
     toUTC(): Chronos;
-    /** @public @instance Returns new Chronos instance in local time */
+    /** @instance Returns new Chronos instance in local time */
     toLocal(): Chronos;
     /**
-     * @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?: FormatOptions): string;
-    /**
-     * @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(): number;
-    /**
-     * @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)
@@ -377,29 +469,54 @@ export declare 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: string, format: string): Chronos;
     /**
-     * @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?: FormatOptions): string;
+    /**
+     * @static Returns a new `Chronos` instance representing yesterday's date.
+     *
+     * @returns A `Chronos` instance for the previous calendar day.
+     */
+    static yesterday(): Chronos;
+    /**
+     * @static Returns a new `Chronos` instance representing tomorrow's date.
+     *
+     * @returns A `Chronos` instance for the next calendar day.
+     */
+    static tomorrow(): Chronos;
+    /**
+     * @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(): number;
+    /**
+     * @static Creates UTC Chronos
      * @param dateLike Date input to create utc time.
      */
-    static utc(dateLike: number | string | Date | Chronos): Chronos;
+    static utc(dateLike: ChronosInput): Chronos;
     /**
-     * @public @static Returns earliest Chronos
+     * @static Returns earliest Chronos
      * @param dates Date inputs.
      */
-    static min(...dates: (number | string | Date | Chronos)[]): Chronos;
+    static min(...dates: ChronosInput[]): Chronos;
     /**
-     * @public @static Returns latest Chronos
+     * @static Returns latest Chronos
      * @param dates Date inputs.
      */
-    static max(...dates: (number | string | Date | Chronos)[]): Chronos;
+    static max(...dates: ChronosInput[]): Chronos;
     /**
-     * @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.
      *
@@ -413,9 +530,9 @@ export declare class Chronos {
      * @param date - A `number` (year or Unix timestamp), `string`, `Date`, or `Chronos` instance representing a date.
      * @returns `true` if the year is a leap year, `false` otherwise.
      */
-    static isLeapYear(date: number | string | Date | Chronos): boolean;
+    static isLeapYear(date: ChronosInput): boolean;
     /**
-     * @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.
@@ -423,7 +540,7 @@ export declare class Chronos {
      */
     static isValidDate(value: unknown): value is 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.
@@ -431,7 +548,7 @@ export declare class Chronos {
      */
     static isDateString(value: unknown): value is string;
     /**
-     * @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`.