@timestamp-js/core 0.1.0-rc.0 → 0.1.0-rc.1

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+import type { CalendarDateParts, CalendarId, CalendarSystem } from './calendar.js';
+export { formatCalendarDate, gregorianCalendar } from './calendar.js';
+export type { CalendarDateParts, CalendarId, CalendarSystem } from './calendar.js';
 /**
  * Matches supported date and date-time input.
  *
@@ -192,10 +195,18 @@ export type DisabledDays = DisabledDay[];
 /**
  * Immutable timestamp data used by all parser, comparison, and date math helpers.
  *
- * Timestamps use Gregorian calendar fields and preserve optional ISO timezone
- * suffixes without converting the wall-clock values into another zone.
+ * Core parser helpers produce Gregorian calendar fields and preserve optional
+ * ISO timezone suffixes without converting the wall-clock values into another
+ * zone. Calendar adapter helpers can also produce timestamp-shaped values whose
+ * year/month/day fields belong to the adapter identified by `calendarId`.
  */
 export interface Timestamp {
+    /**
+     * Optional calendar-system identifier for adapter-produced timestamps.
+     *
+     * Core Gregorian helpers omit this field for backwards compatibility.
+     */
+    readonly calendarId?: CalendarId;
     /**
      * Date string in `YYYY-MM-DD` form when the timestamp has a day.
      */
@@ -205,15 +216,16 @@ export interface Timestamp {
      */
     readonly hasDay: boolean;
     /**
-     * Four-digit Gregorian year.
+     * Calendar year. Core parser helpers use Gregorian years.
      */
     readonly year: number;
     /**
-     * Gregorian month number, where January is `1` and December is `12`.
+     * Calendar month number, where the first month is `1`. Core parser helpers
+     * use Gregorian month numbers.
      */
     readonly month: number;
     /**
-     * Day of the month.
+     * Calendar day of the month.
      */
     readonly day: number;
     /**
@@ -379,6 +391,73 @@ export interface TimestampDuration {
      */
     readonly milliseconds: number;
 }
+/**
+ * Options used when creating a Timestamp from calendar adapter fields.
+ */
+export interface CalendarTimestampOptions {
+    /**
+     * Include formatted time data when true. Defaults to true for compatibility
+     * with calendar-view workflows that expect `00:00` when no explicit time is supplied.
+     */
+    readonly hasTime?: boolean;
+    /**
+     * Hour in 24-hour format.
+     */
+    readonly hour?: number;
+    /**
+     * Minute of the hour.
+     */
+    readonly minute?: number;
+    /**
+     * Optional second of the minute.
+     */
+    readonly second?: number;
+    /**
+     * Optional millisecond of the second.
+     */
+    readonly millisecond?: number;
+    /**
+     * Optional parsed ISO timezone suffix such as `Z`, `+06:00`, or `-0700`.
+     */
+    readonly timezone?: string;
+    /**
+     * Optional comparison timestamp from the same calendar system.
+     */
+    readonly now?: Timestamp | null;
+}
+/**
+ * Options used when creating a calendar-aware day list.
+ */
+export interface CalendarDayListOptions {
+    /**
+     * Weekday numbers to include, from `0` Sunday to `6` Saturday.
+     */
+    readonly weekdays?: number[];
+    /**
+     * Disable days before this calendar date string.
+     */
+    readonly disabledBefore?: string;
+    /**
+     * Disable days after this calendar date string.
+     */
+    readonly disabledAfter?: string;
+    /**
+     * Weekday numbers to mark disabled.
+     */
+    readonly disabledWeekdays?: number[];
+    /**
+     * Specific dates or date ranges to mark disabled.
+     */
+    readonly disabledDays?: DisabledDays;
+    /**
+     * Maximum number of days to return.
+     */
+    readonly max?: number;
+    /**
+     * Minimum number of days to return.
+     */
+    readonly min?: number;
+}
 /**
  * Options for formatting a TimestampDuration.
  */
@@ -403,11 +482,20 @@ export declare const Timestamp: Timestamp;
  * Frozen empty time-object template.
  */
 export declare const TimeObject: TimeObject;
+/**
+ * Extracts calendar date fields from a timestamp-shaped value.
+ *
+ * @param timestamp Timestamp or timestamp-like object to read.
+ * @returns Plain calendar date fields.
+ * @category calendar
+ */
+export declare function toCalendarDateParts(timestamp: Pick<Timestamp, 'year' | 'month' | 'day'>): CalendarDateParts;
 /**
  * Validates whether an input string matches the supported timestamp grammar.
  *
  * @param {string} input A string in the form `YYYY-MM-DD`, `YYYY-MM-DD HH:mm`, or a full ISO-like date time.
  * @returns {boolean} True if parseable
+ * @category validation
  */
 export declare function validateTimestamp(input: string): boolean;
 /**
@@ -419,6 +507,7 @@ export declare function validateTimestamp(input: string): boolean;
  *
  * @param {string} input In the form `YYYY-MM-DD`, `YYYY-MM-DD HH:mm:ss`, or an ISO-like date time with optional milliseconds and timezone suffix.
  * @returns {Timestamp} Minimal Timestamp object, or `null` when the input cannot be parsed.
+ * @category parsing
  */
 export declare function parsed(input: string): Timestamp | null;
 /**
@@ -429,6 +518,7 @@ export declare function parsed(input: string): Timestamp | null;
  *
  * @param {Date} date JavaScript Date to convert.
  * @returns {Timestamp} Formatted Timestamp object, or `null` for invalid input.
+ * @category parsing
  */
 export declare function parseDate(date: Date): Timestamp | null;
 /**
@@ -439,6 +529,7 @@ export declare function parseDate(date: Date): Timestamp | null;
  *
  * @param {Date} date JavaScript Date to convert.
  * @returns {Timestamp} Formatted Timestamp object, or `null` for invalid input.
+ * @category parsing
  */
 export declare function parseDateUTC(date: Date): Timestamp | null;
 /**
@@ -448,12 +539,14 @@ export declare function parseDateUTC(date: Date): Timestamp | null;
  * @param {number} x The number to pad
  * @param {number} length The length of the required number as a string
  * @returns {string} The padded number (as a string). (ie: 5 = '05')
+ * @category formatting
  */
 export declare function padNumber(x: number, length: number): string;
 /**
  * Returns if the passed year is a leap year
  * @param {number} year The year to check (ie: 1999, 2020)
  * @returns {boolean} True if the year is a leap year
+ * @category calendar
  */
 export declare function isLeapYear(year: number): boolean;
 /**
@@ -461,6 +554,7 @@ export declare function isLeapYear(year: number): boolean;
  * @param {number} year The year (ie: 1999, 2020)
  * @param {number} month The Gregorian month number, where January is `1`
  * @returns {number} The number of days in the month (corrected for leap years)
+ * @category calendar
  */
 export declare function daysInMonth(year: number, month: number): number;
 /**
@@ -468,6 +562,7 @@ export declare function daysInMonth(year: number, month: number): number;
  *
  * @param {Timestamp} timestamp Base Timestamp object.
  * @returns {Timestamp} New Timestamp representing the next day.
+ * @category arithmetic
  */
 export declare function nextDay(timestamp: Timestamp): Timestamp;
 /**
@@ -475,6 +570,7 @@ export declare function nextDay(timestamp: Timestamp): Timestamp;
  *
  * @param {Timestamp} timestamp Base Timestamp object.
  * @returns {Timestamp} New Timestamp representing the previous day.
+ * @category arithmetic
  */
 export declare function prevDay(timestamp: Timestamp): Timestamp;
 /**
@@ -485,6 +581,7 @@ export declare function prevDay(timestamp: Timestamp): Timestamp;
  * wants a stable UTC calendar date instead.
  *
  * @returns {string} Date string in the form `YYYY-MM-DD`
+ * @category state
  */
 export declare function today(): string;
 /**
@@ -496,6 +593,7 @@ export declare function today(): string;
  *
  * @param {Date} date Date source to read. Defaults to the current Date.
  * @returns {string} UTC date string in the form `YYYY-MM-DD`
+ * @category state
  */
 export declare function todayUTC(date?: Date): string;
 /**
@@ -507,12 +605,14 @@ export declare function todayUTC(date?: Date): string;
  *
  * @param {Date} date Date source to read. Defaults to the current Date.
  * @returns {Timestamp} Immutable Timestamp built from UTC fields.
+ * @category state
  */
 export declare function nowUTC(date?: Date): Timestamp;
 /**
  * Takes a date string ('YYYY-MM-DD') and validates if it is today's date
  * @param {string} date Date string in the form 'YYYY-MM-DD'
  * @returns {boolean} True if the date is today's date
+ * @category comparison
  */
 export declare function isToday(date: string): boolean;
 /**
@@ -524,6 +624,7 @@ export declare function isToday(date: string): boolean;
  * @param {string} date Date string in the form `YYYY-MM-DD`.
  * @param {Date} now Date source to read. Defaults to the current Date.
  * @returns {boolean} True when the date matches the UTC date.
+ * @category comparison
  */
 export declare function isTodayUTC(date: string, now?: Date): boolean;
 /**
@@ -533,6 +634,7 @@ export declare function isTodayUTC(date: string, now?: Date): boolean;
  * @param {number[]} weekdays The array is [0,1,2,3,4,5,6] where 0=Sunday and 6=Saturday
  * @param {Timestamp=} today Current timestamp used to update relative information
  * @returns {Timestamp} A new Timestamp representing the start of the week
+ * @category ranges
  */
 export declare function getStartOfWeek(timestamp: Timestamp, weekdays: number[], today: Timestamp): Timestamp;
 /**
@@ -542,18 +644,21 @@ export declare function getStartOfWeek(timestamp: Timestamp, weekdays: number[],
  * @param {number[]} weekdays The array is [0,1,2,3,4,5,6] where 0=Sunday and 6=Saturday
  * @param {Timestamp=} today Current timestamp used to update relative information
  * @returns {Timestamp} A new Timestamp representing the end of the week
+ * @category ranges
  */
 export declare function getEndOfWeek(timestamp: Timestamp, weekdays: number[], today: Timestamp): Timestamp;
 /**
  * Finds the start of the month based on the passed in Timestamp
  * @param {Timestamp} timestamp The Timestamp to use to find the start of the month
  * @returns {Timestamp} A Timestamp of the start of the month
+ * @category ranges
  */
 export declare function getStartOfMonth(timestamp: Timestamp): Timestamp;
 /**
  * Finds the end of the month based on the passed in Timestamp
  * @param {Timestamp} timestamp The Timestamp to use to find the end of the month
  * @returns {Timestamp} A Timestamp of the end of the month
+ * @category ranges
  */
 export declare function getEndOfMonth(timestamp: Timestamp): Timestamp;
 /**
@@ -564,6 +669,7 @@ export declare function getEndOfMonth(timestamp: Timestamp): Timestamp;
  *
  * @param input - Minutes since midnight, a time string, or an object with hour and minute fields.
  * @returns Minutes since midnight, or `false` when the input cannot be parsed.
+ * @category parsing
  */
 export declare function parseTime(input: number | string | {
     hour: number;
@@ -575,6 +681,7 @@ export declare function parseTime(input: number | string | {
  * @param {Timestamp} ts1 First Timestamp object.
  * @param {Timestamp} ts2 Second Timestamp object.
  * @returns {boolean} True when both timestamps match exactly.
+ * @category comparison
  */
 export declare function compareTimestamps(ts1: Timestamp, ts2: Timestamp): boolean;
 /**
@@ -583,6 +690,7 @@ export declare function compareTimestamps(ts1: Timestamp, ts2: Timestamp): boole
  * @param {Timestamp} ts1 First Timestamp object.
  * @param {Timestamp} ts2 Second Timestamp object.
  * @returns {boolean} True when both dates are the same.
+ * @category comparison
  */
 export declare function compareDate(ts1: Timestamp, ts2: Timestamp): boolean;
 /**
@@ -591,6 +699,7 @@ export declare function compareDate(ts1: Timestamp, ts2: Timestamp): boolean;
  * @param {Timestamp} ts1 First Timestamp object.
  * @param {Timestamp} ts2 Second Timestamp object.
  * @returns {boolean} True when both times are the same.
+ * @category comparison
  */
 export declare function compareTime(ts1: Timestamp, ts2: Timestamp): boolean;
 /**
@@ -599,6 +708,7 @@ export declare function compareTime(ts1: Timestamp, ts2: Timestamp): boolean;
  * @param {Timestamp} ts1 First Timestamp object.
  * @param {Timestamp} ts2 Second Timestamp object.
  * @returns {boolean} True when both date-time values are the same.
+ * @category comparison
  */
 export declare function compareDateTime(ts1: Timestamp, ts2: Timestamp): boolean;
 /**
@@ -610,6 +720,7 @@ export declare function compareDateTime(ts1: Timestamp, ts2: Timestamp): boolean
  * @param {string} input Date or date-time string, such as `YYYY-MM-DD`, `YYYY-MM-DD HH:mm:ss`, or an ISO-like value with optional milliseconds and timezone suffix.
  * @param {Timestamp} now Optional Timestamp used to calculate relative flags.
  * @returns {Timestamp} Formatted Timestamp object, or `null` when the input cannot be parsed.
+ * @category parsing
  */
 export declare function parseTimestamp(input: string, now?: Timestamp | null): Timestamp | null;
 /**
@@ -617,13 +728,235 @@ export declare function parseTimestamp(input: string, now?: Timestamp | null): T
  *
  * @param {Timestamp} timestamp Timestamp object to read.
  * @returns {number} Numeric date identifier.
+ * @category conversion
  */
 export declare function getDayIdentifier(timestamp: Timestamp): number;
+/**
+ * Converts a Timestamp date into a stable serial day for a calendar system.
+ *
+ * The default Gregorian value is the number of UTC days since 1970-01-01.
+ * Alternate calendar adapters should map their year/month/day fields to the
+ * same serial day space so ranges and comparisons can be calendar-agnostic.
+ *
+ * @param {Timestamp} timestamp Timestamp object to read.
+ * @param {CalendarSystem=} calendar Calendar implementation to use.
+ * @returns {number} Stable serial day.
+ * @category conversion
+ */
+export declare function getEpochDay(timestamp: Timestamp, calendar?: CalendarSystem): number;
+/**
+ * Converts a Timestamp date into a stable serial-day identifier for a calendar system.
+ *
+ * This is an alias-friendly helper for calendar views that need sorted keys,
+ * range comparisons, or virtualized day rows across different calendar adapters.
+ *
+ * @param timestamp Timestamp object to read.
+ * @param calendar Calendar implementation to use.
+ * @returns Stable serial day.
+ * @category calendar
+ */
+export declare function getCalendarDayIdentifier(timestamp: Timestamp, calendar?: CalendarSystem): number;
+/**
+ * Returns true when calendar date fields are valid for a calendar system.
+ *
+ * @param date Calendar date fields to validate.
+ * @param calendar Calendar implementation to use.
+ * @returns True when year, month, and day can exist in the calendar.
+ * @category calendar
+ */
+export declare function isValidCalendarDate(date: CalendarDateParts, calendar?: CalendarSystem): boolean;
+/**
+ * Creates an immutable Timestamp-shaped value from calendar adapter fields.
+ *
+ * The returned timestamp uses adapter year/month/day fields, is tagged with
+ * `calendarId`, and derives weekday/day-of-year values from the adapter.
+ *
+ * @param date Calendar date fields.
+ * @param calendar Calendar implementation to use.
+ * @param options Optional time and relative comparison settings.
+ * @returns Timestamp-shaped calendar value.
+ * @category calendar
+ */
+export declare function createCalendarTimestamp(date: CalendarDateParts, calendar?: CalendarSystem, options?: CalendarTimestampOptions): Timestamp;
+/**
+ * Parses a date or date-time string as calendar adapter fields.
+ *
+ * Unlike parseTimestamp(), this helper validates the date against the supplied
+ * calendar and derives weekday/day-of-year values through the adapter.
+ *
+ * @param input Date or date-time string.
+ * @param calendar Calendar implementation to use.
+ * @param now Optional comparison timestamp from the same calendar system.
+ * @returns Calendar timestamp, or `null` when the input cannot be parsed or validated.
+ * @category calendar
+ */
+export declare function parseCalendarTimestamp(input: string, calendar?: CalendarSystem, now?: Timestamp | null): Timestamp | null;
+/**
+ * Creates a calendar timestamp from a stable serial day.
+ *
+ * @param epochDay Stable serial day.
+ * @param calendar Calendar implementation to use.
+ * @param options Optional time and relative comparison settings.
+ * @returns Timestamp-shaped calendar value.
+ * @category calendar
+ */
+export declare function createCalendarTimestampFromEpochDay(epochDay: number, calendar?: CalendarSystem, options?: CalendarTimestampOptions): Timestamp;
+/**
+ * Updates formatted calendar metadata on a timestamp-shaped value.
+ *
+ * @param timestamp Timestamp object to transform.
+ * @param calendar Calendar implementation to use.
+ * @returns Timestamp with adapter date formatting and metadata.
+ * @category calendar
+ */
+export declare function updateCalendarFormatted(timestamp: Timestamp, calendar?: CalendarSystem): Timestamp;
+/**
+ * Returns a timestamp with relative flags compared through a calendar adapter.
+ *
+ * @param timestamp Timestamp object to update.
+ * @param now Timestamp representing the comparison point in the same calendar.
+ * @param calendar Calendar implementation to use.
+ * @param time Include time-of-day in the comparison when true.
+ * @returns New Timestamp object with relative flags.
+ * @category calendar
+ */
+export declare function updateCalendarRelative(timestamp: Timestamp, now: Timestamp, calendar?: CalendarSystem, time?: boolean): Timestamp;
+/**
+ * Returns a calendar timestamp for the next day.
+ *
+ * @param timestamp Base timestamp.
+ * @param calendar Calendar implementation to use.
+ * @returns New timestamp for the next adapter day.
+ * @category calendar
+ */
+export declare function nextCalendarDay(timestamp: Timestamp, calendar?: CalendarSystem): Timestamp;
+/**
+ * Returns a calendar timestamp for the previous day.
+ *
+ * @param timestamp Base timestamp.
+ * @param calendar Calendar implementation to use.
+ * @returns New timestamp for the previous adapter day.
+ * @category calendar
+ */
+export declare function prevCalendarDay(timestamp: Timestamp, calendar?: CalendarSystem): Timestamp;
+/**
+ * Adds a number of days through a calendar adapter.
+ *
+ * @param timestamp Base timestamp.
+ * @param amount Number of days to move.
+ * @param calendar Calendar implementation to use.
+ * @returns New timestamp after moving.
+ * @category calendar
+ */
+export declare function addCalendarDays(timestamp: Timestamp, amount: number, calendar?: CalendarSystem): Timestamp;
+/**
+ * Adds a number of months through a calendar adapter and clamps invalid days.
+ *
+ * @param timestamp Base timestamp.
+ * @param amount Number of calendar months to move.
+ * @param calendar Calendar implementation to use.
+ * @returns New timestamp after moving.
+ * @category calendar
+ */
+export declare function addCalendarMonths(timestamp: Timestamp, amount: number, calendar?: CalendarSystem): Timestamp;
+/**
+ * Adds a number of years through a calendar adapter and clamps invalid days.
+ *
+ * @param timestamp Base timestamp.
+ * @param amount Number of calendar years to move.
+ * @param calendar Calendar implementation to use.
+ * @returns New timestamp after moving.
+ * @category calendar
+ */
+export declare function addCalendarYears(timestamp: Timestamp, amount: number, calendar?: CalendarSystem): Timestamp;
+/**
+ * Returns the start of the calendar month for a timestamp.
+ *
+ * @param timestamp Base timestamp.
+ * @param calendar Calendar implementation to use.
+ * @returns First day of the adapter month.
+ * @category calendar
+ */
+export declare function getCalendarStartOfMonth(timestamp: Timestamp, calendar?: CalendarSystem): Timestamp;
+/**
+ * Returns the end of the calendar month for a timestamp.
+ *
+ * @param timestamp Base timestamp.
+ * @param calendar Calendar implementation to use.
+ * @returns Last day of the adapter month.
+ * @category calendar
+ */
+export declare function getCalendarEndOfMonth(timestamp: Timestamp, calendar?: CalendarSystem): Timestamp;
+/**
+ * Returns the start of the calendar year for a timestamp.
+ *
+ * @param timestamp Base timestamp.
+ * @param calendar Calendar implementation to use.
+ * @returns First day of the adapter year.
+ * @category calendar
+ */
+export declare function getCalendarStartOfYear(timestamp: Timestamp, calendar?: CalendarSystem): Timestamp;
+/**
+ * Returns the end of the calendar year for a timestamp.
+ *
+ * @param timestamp Base timestamp.
+ * @param calendar Calendar implementation to use.
+ * @returns Last day of the adapter year.
+ * @category calendar
+ */
+export declare function getCalendarEndOfYear(timestamp: Timestamp, calendar?: CalendarSystem): Timestamp;
+/**
+ * Finds the nearest matching weekday through a calendar adapter.
+ *
+ * @param timestamp Base timestamp.
+ * @param weekday Weekday number to find.
+ * @param calendar Calendar implementation to use.
+ * @param direction Direction to search.
+ * @param maxDays Maximum days to inspect.
+ * @returns Matching timestamp, or the last inspected timestamp.
+ * @category calendar
+ */
+export declare function findCalendarWeekday(timestamp: Timestamp, weekday: number, calendar?: CalendarSystem, direction?: 'next' | 'prev', maxDays?: number): Timestamp;
+/**
+ * Returns the start of a calendar week for a timestamp and weekday set.
+ *
+ * @param timestamp Base timestamp.
+ * @param weekdays Weekday numbers to include, from `0` Sunday to `6` Saturday.
+ * @param calendar Calendar implementation to use.
+ * @param now Optional comparison timestamp from the same calendar.
+ * @returns Start of the adapter week.
+ * @category calendar
+ */
+export declare function getCalendarStartOfWeek(timestamp: Timestamp, weekdays: number[], calendar?: CalendarSystem, now?: Timestamp | null): Timestamp;
+/**
+ * Returns the end of a calendar week for a timestamp and weekday set.
+ *
+ * @param timestamp Base timestamp.
+ * @param weekdays Weekday numbers to include, from `0` Sunday to `6` Saturday.
+ * @param calendar Calendar implementation to use.
+ * @param now Optional comparison timestamp from the same calendar.
+ * @returns End of the adapter week.
+ * @category calendar
+ */
+export declare function getCalendarEndOfWeek(timestamp: Timestamp, weekdays: number[], calendar?: CalendarSystem, now?: Timestamp | null): Timestamp;
+/**
+ * Creates an inclusive list of calendar adapter days between start and end.
+ *
+ * @param start First day in the list.
+ * @param end Last day boundary for the list.
+ * @param now Timestamp used to calculate relative flags.
+ * @param calendar Calendar implementation to use.
+ * @param options Optional weekday, disabled, and size filters.
+ * @returns Timestamp days for the adapter calendar.
+ * @category calendar
+ */
+export declare function createCalendarDayList(start: Timestamp, end: Timestamp, now: Timestamp, calendar?: CalendarSystem, options?: CalendarDayListOptions): Timestamp[];
 /**
  * Converts a Timestamp time into a sortable numeric identifier.
  *
  * @param {Timestamp} timestamp Timestamp object to read.
  * @returns {number} Numeric time identifier.
+ * @category conversion
  */
 export declare function getTimeIdentifier(timestamp: Timestamp): number;
 /**
@@ -631,6 +964,7 @@ export declare function getTimeIdentifier(timestamp: Timestamp): number;
  *
  * @param {Timestamp} timestamp Timestamp object to read.
  * @returns {number} Numeric date-time identifier.
+ * @category conversion
  */
 export declare function getDayTimeIdentifier(timestamp: Timestamp): number;
 /**
@@ -639,6 +973,7 @@ export declare function getDayTimeIdentifier(timestamp: Timestamp): number;
  * @param {Timestamp} ts2 The second Timestamp
  * @param {boolean=} strict Optional flag to not to return negative numbers
  * @returns {number} The difference
+ * @category arithmetic
  */
 export declare function diffTimestamp(ts1: Timestamp, ts2: Timestamp, strict?: boolean): number;
 /**
@@ -652,6 +987,7 @@ export declare function diffTimestamp(ts1: Timestamp, ts2: Timestamp, strict?: b
  * @param {Timestamp} now Timestamp representing the comparison point.
  * @param {boolean=} time Include time-of-day in the comparison when true.
  * @returns {Timestamp} New Timestamp object with relative flags.
+ * @category state
  */
 export declare function updateRelative(timestamp: Timestamp, now: Timestamp, time?: boolean): Timestamp;
 /**
@@ -664,24 +1000,28 @@ export declare function updateRelative(timestamp: Timestamp, now: Timestamp, tim
  * @param {number} minutes The number of minutes to set from midnight
  * @param {Timestamp=} now Optional Timestamp representing current date and time
  * @returns {Timestamp} A new Timestamp
+ * @category arithmetic
  */
 export declare function updateMinutes(timestamp: Timestamp, minutes: number, now?: Timestamp | null): Timestamp;
 /**
  * Updates the Timestamp with the weekday
  * @param {Timestamp} timestamp The Timestamp to transform
  * @returns A new Timestamp
+ * @category formatting
  */
 export declare function updateWeekday(timestamp: Timestamp): Timestamp;
 /**
  * Updates the Timestamp with the day of the year (doy)
  * @param {Timestamp} timestamp The Timestamp to transform
  * @returns A new Timestamp
+ * @category formatting
  */
 export declare function updateDayOfYear(timestamp: Timestamp): Timestamp;
 /**
  * Updates the Timestamp with the workweek
  * @param {Timestamp} timestamp The Timestamp to transform
  * @returns A new Timestamp
+ * @category formatting
  */
 export declare function updateWorkWeek(timestamp: Timestamp): Timestamp;
 /**
@@ -692,30 +1032,35 @@ export declare function updateWorkWeek(timestamp: Timestamp): Timestamp;
  * @param {number[]} [disabledWeekdays] An array of numbers representing weekdays [0 = Sun, ..., 6 = Sat]
  * @param {DisabledDays} [disabledDays] An array of days in 'YYYY-MM-DD' format. If an array with a pair of dates is in first array, then this is treated as a range. Object entries can include date/from/to plus color metadata.
  * @returns A new Timestamp
+ * @category state
  */
 export declare function updateDisabled(timestamp: Timestamp, disabledBefore?: string, disabledAfter?: string, disabledWeekdays?: number[], disabledDays?: DisabledDays): Timestamp;
 /**
  * Updates the passed Timestamp with formatted data (time string, date string, weekday, day of year and workweek)
  * @param {Timestamp} timestamp The Timestamp to transform
  * @returns A new Timestamp
+ * @category formatting
  */
 export declare function updateFormatted(timestamp: Timestamp): Timestamp;
 /**
  * Returns day of the year (doy) for the passed in Timestamp
  * @param {Timestamp} timestamp The Timestamp to use
  * @returns {number} The day of the year
+ * @category formatting
  */
 export declare function getDayOfYear(timestamp: Timestamp): number | void;
 /**
  * Returns workweek for the passed in Timestamp
  * @param {Timestamp} timestamp The Timestamp to use
  * @returns {number} The work week
+ * @category formatting
  */
 export declare function getWorkWeek(timestamp: Timestamp): number;
 /**
  * Returns weekday for the passed in Timestamp
  * @param {Timestamp} timestamp The Timestamp to use
  * @returns {number} The weekday
+ * @category formatting
  */
 export declare function getWeekday(timestamp: Timestamp): number;
 /**
@@ -723,6 +1068,7 @@ export declare function getWeekday(timestamp: Timestamp): number;
  *
  * @param {Timestamp} timestamp Timestamp object to copy.
  * @returns {Timestamp} Frozen Timestamp copy.
+ * @category state
  */
 export declare function copyTimestamp(timestamp: Timestamp): Timestamp;
 /**
@@ -730,6 +1076,7 @@ export declare function copyTimestamp(timestamp: Timestamp): Timestamp;
  *
  * @param {Timestamp} timestamp Timestamp object to transform.
  * @returns {Timestamp} New Timestamp at `00:00`.
+ * @category ranges
  */
 export declare function getStartOfDay(timestamp: Timestamp): Timestamp;
 /**
@@ -737,6 +1084,7 @@ export declare function getStartOfDay(timestamp: Timestamp): Timestamp;
  *
  * @param {Timestamp} timestamp Timestamp object to transform.
  * @returns {Timestamp} New Timestamp at `23:59:59.999`.
+ * @category ranges
  */
 export declare function getEndOfDay(timestamp: Timestamp): Timestamp;
 /**
@@ -744,6 +1092,7 @@ export declare function getEndOfDay(timestamp: Timestamp): Timestamp;
  *
  * @param {Timestamp} timestamp Timestamp object to transform.
  * @returns {Timestamp} New Timestamp for January 1 at `00:00`.
+ * @category ranges
  */
 export declare function getStartOfYear(timestamp: Timestamp): Timestamp;
 /**
@@ -751,6 +1100,7 @@ export declare function getStartOfYear(timestamp: Timestamp): Timestamp;
  *
  * @param {Timestamp} timestamp Timestamp object to transform.
  * @returns {Timestamp} New Timestamp for December 31 at `23:59:59.999`.
+ * @category ranges
  */
 export declare function getEndOfYear(timestamp: Timestamp): Timestamp;
 /**
@@ -758,6 +1108,7 @@ export declare function getEndOfYear(timestamp: Timestamp): Timestamp;
  *
  * @param {Timestamp} timestamp Timestamp object to format.
  * @returns {string} Date string such as `YYYY-MM-DD`.
+ * @category conversion
  */
 export declare function getDate(timestamp: Timestamp): string;
 /**
@@ -768,6 +1119,7 @@ export declare function getDate(timestamp: Timestamp): string;
  *
  * @param {Timestamp} timestamp Timestamp object to format.
  * @returns {string} Time string, or an empty string when the timestamp has no time.
+ * @category conversion
  */
 export declare function getTime(timestamp: Timestamp): string;
 /**
@@ -775,6 +1127,7 @@ export declare function getTime(timestamp: Timestamp): string;
  *
  * @param {Timestamp} timestamp Timestamp object to format.
  * @returns {string} Date-time string such as `YYYY-MM-DD HH:mm`.
+ * @category conversion
  */
 export declare function getDateTime(timestamp: Timestamp): string;
 /**
@@ -784,6 +1137,7 @@ export declare function getDateTime(timestamp: Timestamp): string;
  * @param {number} [days=1] The number of days to move.
  * @param {number[]} [allowedWeekdays=[ 0, 1, 2, 3, 4, 5, 6 ]] An array of numbers representing the weekdays. ie: [0 = Sun, ..., 6 = Sat].
  * @returns A new Timestamp
+ * @category ranges
  */
 export declare function moveRelativeDays(timestamp: Timestamp, mover?: typeof nextDay, days?: number, allowedWeekdays?: number[]): Timestamp;
 /**
@@ -793,6 +1147,7 @@ export declare function moveRelativeDays(timestamp: Timestamp, mover?: typeof ne
  * @param {number} [days=1] The number of days to move.
  * @param {number[]} [allowedWeekdays=[ 0, 1, 2, 3, 4, 5, 6 ]] An array of numbers representing the weekdays. ie: [0 = Sun, ..., 6 = Sat].
  * @returns A new Timestamp
+ * @category ranges
  */
 export declare function relativeDays(timestamp: Timestamp, mover?: typeof nextDay, days?: number, allowedWeekdays?: number[]): Timestamp;
 /**
@@ -802,6 +1157,7 @@ export declare function relativeDays(timestamp: Timestamp, mover?: typeof nextDa
  * @param {function} [mover=nextDay] The function to use ({prevDay} or {nextDay}).
  * @param {number} [maxDays=6] The number of days to look forward or back.
  * @returns A new Timestamp
+ * @category ranges
  */
 export declare function findWeekday(timestamp: Timestamp, weekday: number, mover?: typeof nextDay, maxDays?: number): Timestamp;
 /**
@@ -821,6 +1177,7 @@ export declare function findWeekday(timestamp: Timestamp, weekday: number, mover
  * @param {number} [max=42] Maximum number of days to return.
  * @param {number} [min=0] Minimum number of days to return.
  * @returns {Timestamp[]} Timestamp days.
+ * @category ranges
  */
 export declare function createDayList(start: Timestamp, end: Timestamp, now: Timestamp, weekdays?: number[], disabledBefore?: string | undefined, disabledAfter?: string | undefined, disabledWeekdays?: number[], disabledDays?: DisabledDays, max?: number, min?: number): Timestamp[];
 /**
@@ -832,6 +1189,7 @@ export declare function createDayList(start: Timestamp, end: Timestamp, now: Tim
  * @param {number} count Number of intervals to create.
  * @param {Timestamp} now Timestamp used to calculate relative flags.
  * @returns {Timestamp[]} Interval Timestamp objects.
+ * @category ranges
  */
 export declare function createIntervalList(timestamp: Timestamp, first: number, minutes: number, count: number, now: Timestamp): Timestamp[];
 /**
@@ -862,6 +1220,7 @@ export type MonthFormatter = (_month: number, _type?: string, _locale?: string)
  * @param {string} locale The locale to use (ie: en-US)
  * @param {getOptions} cb The function to call for options. This function should return an Intl formatted object. The function is passed (timestamp, short).
  * @returns {formatter} The function has params (timestamp, short). The short is to use the short options.
+ * @category locale
  */
 export declare function createNativeLocaleFormatter(locale: string, cb: LocaleFormatter): (_timestamp: Timestamp, _short: boolean) => string;
 /**
@@ -874,13 +1233,31 @@ export declare function createNativeLocaleFormatter(locale: string, cb: LocaleFo
  * @param {string} locale The locale to use (ie: en-US)
  * @param {getOptions} cb The function to call for options. This function should return an Intl formatted object. The function is passed (timestamp, short).
  * @returns {formatter} The function has params (timestamp, short). The short is to use the short options.
+ * @category locale
  */
 export declare function createNativeLocaleFormatterUTC(locale: string, cb: LocaleFormatter): (_timestamp: Timestamp, _short: boolean) => string;
+/**
+ * Returns a UTC locale formatter for a calendar adapter.
+ *
+ * The formatter converts adapter date fields through the adapter's serial day
+ * before constructing the native Date. When the adapter has an Intl calendar id,
+ * it is supplied to Intl.DateTimeFormat unless the caller already provided a
+ * `calendar` option. The helper supplies `timeZone: "UTC"` unless the caller
+ * provides a different timezone.
+ *
+ * @param calendar Calendar implementation to use.
+ * @param locale The locale to use.
+ * @param cb Callback that returns Intl formatting options.
+ * @returns Function that formats a calendar timestamp.
+ * @category calendar
+ */
+export declare function createCalendarLocaleFormatterUTC(calendar: CalendarSystem, locale: string, cb: LocaleFormatter): (_timestamp: Timestamp, _short: boolean) => string;
 /**
  * Converts a Timestamp date into a host-local JavaScript Date.
  *
  * @param {Timestamp} timestamp Timestamp object to convert.
  * @returns {Date} Host-local JavaScript Date object.
+ * @category conversion
  */
 export declare function makeDate(timestamp: Timestamp): Date;
 /**
@@ -888,20 +1265,44 @@ export declare function makeDate(timestamp: Timestamp): Date;
  *
  * @param {Timestamp} timestamp Timestamp object to convert.
  * @returns {Date} JavaScript Date object built with `Date.UTC()`.
+ * @category conversion
  */
 export declare function makeDateUTC(timestamp: Timestamp): Date;
+/**
+ * Converts an adapter calendar timestamp date into a UTC JavaScript Date.
+ *
+ * The native Date always represents the equivalent Gregorian civil day so Intl
+ * can format the adapter date correctly when paired with a calendar option.
+ *
+ * @param timestamp Calendar timestamp object to convert.
+ * @param calendar Calendar implementation to use.
+ * @returns JavaScript Date object built with `Date.UTC()`.
+ * @category calendar
+ */
+export declare function makeCalendarDateUTC(timestamp: Timestamp, calendar?: CalendarSystem): Date;
 /**
  * Converts a Timestamp date and time into a host-local JavaScript Date.
  *
  * @param {Timestamp} timestamp Timestamp object to convert.
  * @returns {Date} Host-local JavaScript Date object.
+ * @category conversion
  */
 export declare function makeDateTime(timestamp: Timestamp): Date;
+/**
+ * Converts an adapter calendar timestamp date-time into a UTC JavaScript Date.
+ *
+ * @param timestamp Calendar timestamp object to convert.
+ * @param calendar Calendar implementation to use.
+ * @returns JavaScript Date object built with `Date.UTC()`.
+ * @category calendar
+ */
+export declare function makeCalendarDateTimeUTC(timestamp: Timestamp, calendar?: CalendarSystem): Date;
 /**
  * Converts a Timestamp date and time into a UTC JavaScript Date.
  *
  * @param {Timestamp} timestamp Timestamp object to convert.
  * @returns {Date} JavaScript Date object built with `Date.UTC()`.
+ * @category conversion
  */
 export declare function makeDateTimeUTC(timestamp: Timestamp): Date;
 /**
@@ -912,6 +1313,7 @@ export declare function makeDateTimeUTC(timestamp: Timestamp): Date;
  *
  * @param {Timestamp} timestamp Timestamp object to convert.
  * @returns {number} Unix milliseconds.
+ * @category conversion
  */
 export declare function toUnixMilliseconds(timestamp: Timestamp): number;
 /**
@@ -921,6 +1323,7 @@ export declare function toUnixMilliseconds(timestamp: Timestamp): number;
  *
  * @param {Timestamp} timestamp Timestamp object to convert.
  * @returns {number} Unix seconds.
+ * @category conversion
  */
 export declare function toUnixSeconds(timestamp: Timestamp): number;
 /**
@@ -928,6 +1331,7 @@ export declare function toUnixSeconds(timestamp: Timestamp): number;
  *
  * @param {number} milliseconds Unix milliseconds.
  * @returns {Timestamp | null} Timestamp built from UTC fields, or `null` for invalid input.
+ * @category conversion
  */
 export declare function fromUnixMilliseconds(milliseconds: number): Timestamp | null;
 /**
@@ -935,6 +1339,7 @@ export declare function fromUnixMilliseconds(milliseconds: number): Timestamp |
  *
  * @param {number} seconds Unix seconds.
  * @returns {Timestamp | null} Timestamp built from UTC fields, or `null` for invalid input.
+ * @category conversion
  */
 export declare function fromUnixSeconds(seconds: number): Timestamp | null;
 /**
@@ -944,6 +1349,7 @@ export declare function fromUnixSeconds(seconds: number): Timestamp | null;
  *
  * @param {Timestamp} timestamp Timestamp object to convert.
  * @returns {Date} Local JavaScript Date object.
+ * @category conversion
  */
 export declare function getDateObject(timestamp: Timestamp): Date;
 /**
@@ -952,6 +1358,7 @@ export declare function getDateObject(timestamp: Timestamp): Date;
  * @param input - The value to be validated. Can be a string or a number.
  * @returns A boolean indicating whether the input is a finite number.
  *          Returns true if the input is a finite number, false otherwise.
+ * @category validation
  */
 export declare function validateNumber(input: string | number): boolean;
 /**
@@ -960,6 +1367,7 @@ export declare function validateNumber(input: string | number): boolean;
  * @param {Timestamp[]} timestamps Timestamp objects to compare.
  * @param {boolean=} useTime Include time-of-day in the comparison when true.
  * @returns Latest Timestamp object.
+ * @category comparison
  */
 export declare function maxTimestamp(timestamps: Timestamp[], useTime?: boolean): Timestamp;
 /**
@@ -968,6 +1376,7 @@ export declare function maxTimestamp(timestamps: Timestamp[], useTime?: boolean)
  * @param {Timestamp[]} timestamps Timestamp objects to compare.
  * @param {boolean=} useTime Include time-of-day in the comparison when true.
  * @returns Earliest Timestamp object.
+ * @category comparison
  */
 export declare function minTimestamp(timestamps: Timestamp[], useTime?: boolean): Timestamp;
 /**
@@ -977,6 +1386,7 @@ export declare function minTimestamp(timestamps: Timestamp[], useTime?: boolean)
  * @param {Timestamp} end Second boundary.
  * @param {boolean=} useTime Include time-of-day when ordering boundaries.
  * @returns {TimestampRange} Frozen inclusive Timestamp range.
+ * @category ranges
  */
 export declare function createTimestampRange(start: Timestamp, end: Timestamp, useTime?: boolean): TimestampRange;
 /**
@@ -986,6 +1396,7 @@ export declare function createTimestampRange(start: Timestamp, end: Timestamp, u
  * @param {TimestampRange} range Inclusive range to test against.
  * @param {boolean=} useTime Include time-of-day in the comparison.
  * @returns {boolean} True when the timestamp is inside the range.
+ * @category comparison
  */
 export declare function isTimestampInRange(timestamp: Timestamp, range: TimestampRange, useTime?: boolean): boolean;
 /**
@@ -995,6 +1406,7 @@ export declare function isTimestampInRange(timestamp: Timestamp, range: Timestam
  * @param {TimestampRange} second Second range.
  * @param {boolean=} useTime Include time-of-day in the comparison.
  * @returns {boolean} True when the ranges overlap.
+ * @category comparison
  */
 export declare function isRangeOverlapping(first: TimestampRange, second: TimestampRange, useTime?: boolean): boolean;
 /**
@@ -1004,6 +1416,7 @@ export declare function isRangeOverlapping(first: TimestampRange, second: Timest
  * @param {TimestampRange} second Second range.
  * @param {boolean=} useTime Include time-of-day in the comparison.
  * @returns {TimestampRange | null} Intersected range, or `null` when the ranges do not overlap.
+ * @category ranges
  */
 export declare function intersectRanges(first: TimestampRange, second: TimestampRange, useTime?: boolean): TimestampRange | null;
 /**
@@ -1016,6 +1429,7 @@ export declare function intersectRanges(first: TimestampRange, second: Timestamp
  * @param {TimestampRange[]} ranges Ranges to merge.
  * @param {boolean=} useTime Include time-of-day in the comparison.
  * @returns {TimestampRange[]} Merged ranges sorted by start boundary.
+ * @category ranges
  */
 export declare function mergeRanges(ranges: TimestampRange[], useTime?: boolean): TimestampRange[];
 /**
@@ -1028,6 +1442,7 @@ export declare function mergeRanges(ranges: TimestampRange[], useTime?: boolean)
  * @param {TimestampRange[]} blocked Ranges to remove from the source.
  * @param {boolean=} useTime Include time-of-day in the comparison.
  * @returns {TimestampRange[]} Remaining ranges.
+ * @category ranges
  */
 export declare function subtractRanges(source: TimestampRange, blocked: TimestampRange[], useTime?: boolean): TimestampRange[];
 /**
@@ -1040,6 +1455,7 @@ export declare function subtractRanges(source: TimestampRange, blocked: Timestam
  * @param {TimestampRange[]} occupied Ranges that are not available.
  * @param {boolean=} useTime Include time-of-day in the comparison.
  * @returns {TimestampRange[]} Gap ranges.
+ * @category ranges
  */
 export declare function findRangeGaps(source: TimestampRange, occupied: TimestampRange[], useTime?: boolean): TimestampRange[];
 /**
@@ -1050,6 +1466,7 @@ export declare function findRangeGaps(source: TimestampRange, occupied: Timestam
  * @param {Timestamp} endTimestamp Inclusive end boundary.
  * @param {boolean=} useTime Include time-of-day in the comparison when true.
  * @returns {boolean} True when the timestamp is inside the range.
+ * @category comparison
  */
 export declare function isBetweenDates(timestamp: Timestamp, startTimestamp: Timestamp, endTimestamp: Timestamp, useTime?: boolean): boolean;
 /**
@@ -1060,6 +1477,7 @@ export declare function isBetweenDates(timestamp: Timestamp, startTimestamp: Tim
  * @param {Timestamp} firstTimestamp Start of the second range.
  * @param {Timestamp} lastTimestamp End of the second range.
  * @returns {boolean} True when the ranges overlap.
+ * @category comparison
  */
 export declare function isOverlappingDates(startTimestamp: Timestamp, endTimestamp: Timestamp, firstTimestamp: Timestamp, lastTimestamp: Timestamp): boolean;
 /**
@@ -1116,6 +1534,7 @@ export interface AddToDateOptions {
  * @param {number=} options.second If positive, adds seconds. If negative, removes seconds.
  * @param {number=} options.millisecond If positive, adds milliseconds. If negative, removes milliseconds.
  * @returns {Timestamp} New normalized Timestamp object.
+ * @category arithmetic
  */
 export declare function addToDate(timestamp: Timestamp, options: AddToDateOptions): Timestamp;
 /**
@@ -1140,6 +1559,7 @@ export declare function addToDate(timestamp: Timestamp, options: AddToDateOption
  * @param {number=} options.second If positive, adds seconds. If negative, removes seconds.
  * @param {number=} options.millisecond If positive, adds milliseconds. If negative, removes milliseconds.
  * @returns {Timestamp} New normalized Timestamp object.
+ * @category arithmetic
  */
 export declare function addToDateClamped(timestamp: Timestamp, options: AddToDateOptions): Timestamp;
 /**
@@ -1147,12 +1567,14 @@ export declare function addToDateClamped(timestamp: Timestamp, options: AddToDat
  * @param {Timestamp} ts1 The first Timestamp
  * @param {Timestamp} ts2 The second Timestamp
  * @returns Number of days
+ * @category arithmetic
  */
 export declare function daysBetween(ts1: Timestamp, ts2: Timestamp): number;
 /**
  * Returns number of weeks between two Timestamps
  * @param {Timestamp} ts1 The first Timestamp
  * @param {Timestamp} ts2 The second Timestamp
+ * @category arithmetic
  */
 export declare function weeksBetween(ts1: Timestamp, ts2: Timestamp): number;
 /**
@@ -1160,6 +1582,7 @@ export declare function weeksBetween(ts1: Timestamp, ts2: Timestamp): number;
  *
  * @param {number} milliseconds Signed elapsed milliseconds.
  * @returns {TimestampDuration} Frozen duration object.
+ * @category duration
  */
 export declare function createDuration(milliseconds: number): TimestampDuration;
 /**
@@ -1171,6 +1594,7 @@ export declare function createDuration(milliseconds: number): TimestampDuration;
  * @param {Timestamp} start Start timestamp.
  * @param {Timestamp} end End timestamp.
  * @returns {TimestampDuration} Frozen duration object.
+ * @category duration
  */
 export declare function durationBetween(start: Timestamp, end: Timestamp): TimestampDuration;
 /**
@@ -1183,6 +1607,7 @@ export declare function durationBetween(start: Timestamp, end: Timestamp): Times
  * @param {Timestamp} timestamp Timestamp object to offset.
  * @param {TimestampDuration | number} duration Duration object or signed milliseconds.
  * @returns {Timestamp} Offset Timestamp.
+ * @category duration
  */
 export declare function addDuration(timestamp: Timestamp, duration: TimestampDuration | number): Timestamp;
 /**
@@ -1191,6 +1616,7 @@ export declare function addDuration(timestamp: Timestamp, duration: TimestampDur
  * @param {Timestamp} timestamp Timestamp object to offset.
  * @param {TimestampDuration | number} duration Duration object or signed milliseconds.
  * @returns {Timestamp} Offset Timestamp.
+ * @category duration
  */
 export declare function subtractDuration(timestamp: Timestamp, duration: TimestampDuration | number): Timestamp;
 /**
@@ -1201,6 +1627,7 @@ export declare function subtractDuration(timestamp: Timestamp, duration: Timesta
  * @param {TimestampDuration | number} duration Duration object or signed milliseconds.
  * @param {FormatDurationOptions=} options Formatting options.
  * @returns {string} Formatted duration.
+ * @category duration
  */
 export declare function formatDuration(duration: TimestampDuration | number, options?: FormatDurationOptions): string;
 /**
@@ -1209,6 +1636,7 @@ export declare function formatDuration(duration: TimestampDuration | number, opt
  * @param {Timestamp} timestamp Timestamp object to round.
  * @param {number} minutes Interval size in minutes.
  * @returns {Timestamp} Rounded Timestamp.
+ * @category arithmetic
  */
 export declare function floorToInterval(timestamp: Timestamp, minutes: number): Timestamp;
 /**
@@ -1217,6 +1645,7 @@ export declare function floorToInterval(timestamp: Timestamp, minutes: number):
  * @param {Timestamp} timestamp Timestamp object to round.
  * @param {number} minutes Interval size in minutes.
  * @returns {Timestamp} Rounded Timestamp.
+ * @category arithmetic
  */
 export declare function ceilToInterval(timestamp: Timestamp, minutes: number): Timestamp;
 /**
@@ -1225,6 +1654,7 @@ export declare function ceilToInterval(timestamp: Timestamp, minutes: number): T
  * @param {Timestamp} timestamp Timestamp object to round.
  * @param {number} minutes Interval size in minutes.
  * @returns {Timestamp} Rounded Timestamp.
+ * @category arithmetic
  */
 export declare function roundToInterval(timestamp: Timestamp, minutes: number): Timestamp;
 declare const weekdayDateMap: {
@@ -1252,6 +1682,7 @@ declare const weekdayDateMap: {
  * @param {string} [locale=''] - The locale to use for formatting.
  *
  * @returns {string} The formatted weekday.
+ * @category locale
  */
 export declare function getWeekdayFormatter(): WeekdayFormatter;
 /**
@@ -1260,6 +1691,7 @@ export declare function getWeekdayFormatter(): WeekdayFormatter;
  * @param {string} type Format type: `narrow`, `short`, or `long`.
  * @param {string} locale Locale to use for formatting, such as `en-US`.
  * @returns {string[]} Localized weekday names in Sunday-first order.
+ * @category locale
  */
 export declare function getWeekdayNames(type: string, locale: string): string[];
 /**
@@ -1273,6 +1705,7 @@ export declare function getWeekdayNames(type: string, locale: string): string[];
  *   @returns {string} The formatted month name.
  *
  * @throws {Error} If Intl or Intl.DateTimeFormat is not supported in the environment.
+ * @category locale
  */
 export declare function getMonthFormatter(): MonthFormatter;
 /**
@@ -1281,7 +1714,7 @@ export declare function getMonthFormatter(): MonthFormatter;
  * @param {string} type Format type: `narrow`, `short`, or `long`.
  * @param {string} locale Locale to use for formatting, such as `en-US`.
  * @returns {string[]} Localized month names in January-first order.
+ * @category locale
  */
 export declare function getMonthNames(type: string, locale: string): string[];
-export {};
 //# sourceMappingURL=index.d.ts.map