@timestamp-js/core 0.1.0-rc.2 → 0.1.0-rc.3

package/dist/index.d.ts

@@ -1,6 +1,55 @@
-import type { CalendarDateParts, CalendarId, CalendarSystem } from './calendar.js';
-export { formatCalendarDate, gregorianCalendar } from './calendar.js';
-export type { CalendarDateParts, CalendarId, CalendarSystem } from './calendar.js';
+import type { CalendarDateParts, CalendarDirection, CalendarId, CalendarSystem } from './calendar.js';
+export { gregorianCalendar } from './calendar.js';
+export type { CalendarDateParts, CalendarDirection, CalendarId, CalendarSystem, } from './calendar.js';
+/**
+ * Formats calendar fields using Timestamp's fixed `YYYY-MM-DD` date format.
+ *
+ * @param date Plain calendar date fields.
+ * @returns Date string in `YYYY-MM-DD` form.
+ * @category calendar
+ */
+export declare function formatCalendarDate(date: CalendarDateParts): string;
+/**
+ * Returns the recommended locale for a calendar system.
+ *
+ * Calendar adapters can use this to publish their normal display locale. Callers can still pass
+ * an explicit locale when an application needs a different language or numbering presentation.
+ *
+ * @param {CalendarSystem=} calendar Calendar system to read. Defaults to Gregorian.
+ * @returns {string} BCP 47 locale, defaulting to `en-US`.
+ * @category calendar
+ */
+export declare function getCalendarLocale(calendar?: CalendarSystem): string;
+/**
+ * Returns the recommended text direction for a calendar system.
+ *
+ * Calendar adapters can use this to publish their normal left-to-right or right-to-left
+ * presentation. Callers can still pass an explicit direction when an application needs one.
+ *
+ * @param {CalendarSystem=} calendar Calendar system to read. Defaults to Gregorian.
+ * @returns {CalendarDirection} `ltr` or `rtl`, defaulting to `ltr`.
+ * @category calendar
+ */
+export declare function getCalendarDirection(calendar?: CalendarSystem): CalendarDirection;
+/**
+ * Returns true when a calendar system recommends right-to-left presentation.
+ *
+ * @param {CalendarSystem=} calendar Calendar system to read. Defaults to Gregorian.
+ * @returns {boolean} True when the recommended direction is `rtl`.
+ * @category calendar
+ */
+export declare function isCalendarRTL(calendar?: CalendarSystem): boolean;
+/**
+ * Returns the recommended visible weekday order for a calendar system.
+ *
+ * Calendar adapters can use this to publish their normal visible week. Callers can still pass an
+ * explicit weekday list for application-specific layouts such as a five-day work week.
+ *
+ * @param {CalendarSystem=} calendar Calendar system to read. Defaults to Gregorian.
+ * @returns {number[]} Weekday numbers where Sunday is `0` and Saturday is `6`.
+ * @category calendar
+ */
+export declare function getCalendarWeekdays(calendar?: CalendarSystem): number[];
 /**
  * Matches supported date and date-time input.
  *
@@ -458,6 +507,182 @@ export interface CalendarDayListOptions {
      */
     readonly min?: number;
 }
+/**
+ * Calendar-aware disabled-day options.
+ */
+export interface CalendarDisabledOptions {
+    /**
+     * 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;
+}
+/**
+ * Collection of adapter-native date strings.
+ */
+export type CalendarDateCollection = string[] | Set<string>;
+/**
+ * Calendar-aware selected-date options.
+ */
+export interface CalendarSelectionOptions {
+    /**
+     * Adapter-native date strings to mark as selected.
+     */
+    readonly selectedDates?: CalendarDateCollection;
+    /**
+     * Two adapter-native date strings marking an inclusive selected range.
+     */
+    readonly selectedStartEndDates?: string[];
+}
+/**
+ * Selection state for one calendar date.
+ */
+export interface CalendarSelectionState {
+    /**
+     * True when the date is explicitly selected.
+     */
+    readonly selectedDate: boolean;
+    /**
+     * True when the date is the selected range start.
+     */
+    readonly rangeFirst: boolean;
+    /**
+     * True when the date is inside, but not at either edge of, the selected range.
+     */
+    readonly range: boolean;
+    /**
+     * True when the date is the selected range end.
+     */
+    readonly rangeLast: boolean;
+    /**
+     * True when any selected-date or selected-range state applies.
+     */
+    readonly selected: boolean;
+}
+/**
+ * Fully resolved state for one calendar date in a view.
+ */
+export interface CalendarDateState extends CalendarSelectionState {
+    /**
+     * Adapter-native timestamp for the rendered date.
+     */
+    readonly timestamp: Timestamp;
+    /**
+     * Stable native/Gregorian identity for the rendered date.
+     */
+    readonly identity: CalendarDateIdentity;
+    /**
+     * True when the date is outside the reference adapter month.
+     */
+    readonly outside: boolean;
+    /**
+     * True when the date is disabled by calendar-aware disabled options.
+     */
+    readonly disabled: boolean;
+}
+/**
+ * Options used when resolving one calendar date's state.
+ */
+export interface CalendarDateStateOptions extends CalendarDisabledOptions, CalendarSelectionOptions {
+    /**
+     * Explicit outside-month state. When omitted, referenceMonth is used.
+     */
+    readonly outside?: boolean;
+    /**
+     * Reference date whose adapter month defines outside-month state.
+     */
+    readonly referenceMonth?: Timestamp;
+}
+/**
+ * Options used when creating a calendar month view.
+ */
+export interface CalendarMonthViewOptions extends CalendarDisabledOptions, CalendarSelectionOptions {
+    /**
+     * Weekday numbers to include, from `0` Sunday to `6` Saturday.
+     */
+    readonly weekdays?: number[];
+    /**
+     * Maximum number of days to return.
+     */
+    readonly max?: number;
+    /**
+     * Minimum number of days to return.
+     */
+    readonly min?: number;
+}
+/**
+ * Resolved calendar month view data.
+ */
+export interface CalendarMonthView {
+    /**
+     * Reference timestamp normalized through the calendar adapter.
+     */
+    readonly reference: Timestamp;
+    /**
+     * First date of the reference adapter month.
+     */
+    readonly start: Timestamp;
+    /**
+     * Last date of the reference adapter month.
+     */
+    readonly end: Timestamp;
+    /**
+     * First rendered date in the month grid.
+     */
+    readonly visibleStart: Timestamp;
+    /**
+     * Last rendered date in the month grid.
+     */
+    readonly visibleEnd: Timestamp;
+    /**
+     * Rendered adapter-native day states.
+     */
+    readonly days: CalendarDateState[];
+}
+/**
+ * Stable native and interop identity for a calendar date.
+ *
+ * Calendar-native APIs can use `nativeDate`, `native`, and `calendarId` while
+ * storage, sorting, cross-calendar joins, and legacy interop can use
+ * `epochDay` and `gregorianDate`.
+ */
+export interface CalendarDateIdentity {
+    /**
+     * Calendar id for the native date fields.
+     */
+    readonly calendarId: CalendarId;
+    /**
+     * Native calendar date string in `YYYY-MM-DD` form.
+     */
+    readonly nativeDate: string;
+    /**
+     * Native calendar date fields.
+     */
+    readonly native: CalendarDateParts;
+    /**
+     * Canonical Gregorian date string for the same serial day.
+     */
+    readonly gregorianDate: string;
+    /**
+     * Canonical Gregorian date fields for the same serial day.
+     */
+    readonly gregorian: CalendarDateParts;
+    /**
+     * Stable serial day shared across calendar systems.
+     */
+    readonly epochDay: number;
+}
 /**
  * Options for formatting a TimestampDuration.
  */
@@ -517,10 +742,11 @@ export declare function parsed(input: string): Timestamp | null;
  * with UTC getters instead of host-local getters.
  *
  * @param {Date} date JavaScript Date to convert.
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {Timestamp} Formatted Timestamp object, or `null` for invalid input.
  * @category parsing
  */
-export declare function parseDate(date: Date): Timestamp | null;
+export declare function parseDate(date: Date, calendar?: CalendarSystem): Timestamp | null;
 /**
  * Converts a JavaScript Date into a formatted Timestamp using UTC fields.
  *
@@ -528,10 +754,11 @@ export declare function parseDate(date: Date): Timestamp | null;
  * and time fields for a native Date instant.
  *
  * @param {Date} date JavaScript Date to convert.
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {Timestamp} Formatted Timestamp object, or `null` for invalid input.
  * @category parsing
  */
-export declare function parseDateUTC(date: Date): Timestamp | null;
+export declare function parseDateUTC(date: Date, calendar?: CalendarSystem): Timestamp | null;
 /**
  * Pads a number to a requested string length.
  *
@@ -545,57 +772,65 @@ 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)
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {boolean} True if the year is a leap year
  * @category calendar
  */
-export declare function isLeapYear(year: number): boolean;
+export declare function isLeapYear(year: number, calendar?: CalendarSystem): boolean;
 /**
  * Returns the days of the specified month in a year
  * @param {number} year The year (ie: 1999, 2020)
- * @param {number} month The Gregorian month number, where January is `1`
+ * @param {number} month The month number in the selected calendar, where January is `1` for Gregorian.
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {number} The number of days in the month (corrected for leap years)
  * @category calendar
  */
-export declare function daysInMonth(year: number, month: number): number;
+export declare function daysInMonth(year: number, month: number, calendar?: CalendarSystem): number;
 /**
  * Returns a new Timestamp for the next calendar day.
  *
  * @param {Timestamp} timestamp Base Timestamp object.
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {Timestamp} New Timestamp representing the next day.
  * @category arithmetic
  */
-export declare function nextDay(timestamp: Timestamp): Timestamp;
+export declare function nextDay(timestamp: Timestamp, calendar?: CalendarSystem): Timestamp;
 /**
  * Returns a new Timestamp for the previous calendar day.
  *
  * @param {Timestamp} timestamp Base Timestamp object.
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {Timestamp} New Timestamp representing the previous day.
  * @category arithmetic
  */
-export declare function prevDay(timestamp: Timestamp): Timestamp;
+export declare function prevDay(timestamp: Timestamp, calendar?: CalendarSystem): Timestamp;
 /**
  * Returns today's date using the host runtime timezone.
  *
  * For SSR or static rendering, server and client runtimes can produce different
  * values when they run in different timezones. Use todayUTC() when the app
- * wants a stable UTC calendar date instead.
+ * wants a stable UTC calendar date instead. Pass a calendar system to return
+ * today's date in that calendar's native `YYYY-MM-DD` fields.
  *
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {string} Date string in the form `YYYY-MM-DD`
  * @category state
  */
-export declare function today(): string;
+export declare function today(calendar?: CalendarSystem): string;
 /**
  * Returns today's date using UTC calendar fields.
  *
  * Pass a Date fixture to make SSR, tests, and hydration-sensitive render paths
  * deterministic. This helper reads UTC fields only; it does not convert an
- * existing Timestamp or timezone-suffixed string.
+ * existing Timestamp or timezone-suffixed string. Pass a calendar system to
+ * return today's UTC date in that calendar's native `YYYY-MM-DD` fields.
  *
  * @param {Date} date Date source to read. Defaults to the current Date.
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {string} UTC date string in the form `YYYY-MM-DD`
  * @category state
  */
-export declare function todayUTC(date?: Date): string;
+export declare function todayUTC(date?: Date, calendar?: CalendarSystem): string;
 /**
  * Returns the current date-time as an immutable Timestamp using UTC fields.
  *
@@ -604,17 +839,19 @@ export declare function todayUTC(date?: Date): string;
  * caller instead of allowing each runtime to create its own current Date.
  *
  * @param {Date} date Date source to read. Defaults to the current Date.
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {Timestamp} Immutable Timestamp built from UTC fields.
  * @category state
  */
-export declare function nowUTC(date?: Date): Timestamp;
+export declare function nowUTC(date?: Date, calendar?: CalendarSystem): 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'
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {boolean} True if the date is today's date
  * @category comparison
  */
-export declare function isToday(date: string): boolean;
+export declare function isToday(date: string, calendar?: CalendarSystem): boolean;
 /**
  * Checks whether a date string matches today's UTC date.
  *
@@ -623,44 +860,49 @@ 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.
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {boolean} True when the date matches the UTC date.
  * @category comparison
  */
-export declare function isTodayUTC(date: string, now?: Date): boolean;
+export declare function isTodayUTC(date: string, now?: Date, calendar?: CalendarSystem): boolean;
 /**
  * Returns the start of the week for a Timestamp and weekday set.
  * If a current Timestamp is provided, the returned Timestamp includes updated relative information.
  * @param {Timestamp} timestamp The Timestamp to use to find the start of the week
  * @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
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {Timestamp} A new Timestamp representing the start of the week
  * @category ranges
  */
-export declare function getStartOfWeek(timestamp: Timestamp, weekdays: number[], today: Timestamp): Timestamp;
+export declare function getStartOfWeek(timestamp: Timestamp, weekdays: number[], today: Timestamp, calendar?: CalendarSystem): Timestamp;
 /**
  * Returns the end of the week for a Timestamp and weekday set.
  * If a current Timestamp is provided, the returned Timestamp includes updated relative information.
  * @param {Timestamp} timestamp The Timestamp to use to find the end of the week
  * @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
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {Timestamp} A new Timestamp representing the end of the week
  * @category ranges
  */
-export declare function getEndOfWeek(timestamp: Timestamp, weekdays: number[], today: Timestamp): Timestamp;
+export declare function getEndOfWeek(timestamp: Timestamp, weekdays: number[], today: Timestamp, calendar?: CalendarSystem): 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
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {Timestamp} A Timestamp of the start of the month
  * @category ranges
  */
-export declare function getStartOfMonth(timestamp: Timestamp): Timestamp;
+export declare function getStartOfMonth(timestamp: Timestamp, calendar?: CalendarSystem): 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
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {Timestamp} A Timestamp of the end of the month
  * @category ranges
  */
-export declare function getEndOfMonth(timestamp: Timestamp): Timestamp;
+export declare function getEndOfMonth(timestamp: Timestamp, calendar?: CalendarSystem): Timestamp;
 /**
  * Converts time input into minutes since midnight.
  *
@@ -739,7 +981,7 @@ export declare function getDayIdentifier(timestamp: Timestamp): number;
  * 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.
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {number} Stable serial day.
  * @category conversion
  */
@@ -751,16 +993,29 @@ export declare function getEpochDay(timestamp: Timestamp, calendar?: CalendarSys
  * range comparisons, or virtualized day rows across different calendar adapters.
  *
  * @param timestamp Timestamp object to read.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns Stable serial day.
  * @category calendar
  */
 export declare function getCalendarDayIdentifier(timestamp: Timestamp, calendar?: CalendarSystem): number;
+/**
+ * Creates stable native and Gregorian identities for a calendar timestamp.
+ *
+ * Use this when component APIs need to expose adapter-native values while also
+ * preserving a canonical Gregorian key for storage, comparisons, or interop
+ * with existing data.
+ *
+ * @param timestamp Timestamp object to identify.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
+ * @returns Calendar-native date, Gregorian interop date, and shared epoch day.
+ * @category calendar
+ */
+export declare function getCalendarDateIdentity(timestamp: Timestamp, calendar?: CalendarSystem): CalendarDateIdentity;
 /**
  * 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.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns True when year, month, and day can exist in the calendar.
  * @category calendar
  */
@@ -772,7 +1027,7 @@ export declare function isValidCalendarDate(date: CalendarDateParts, calendar?:
  * `calendarId`, and derives weekday/day-of-year values from the adapter.
  *
  * @param date Calendar date fields.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @param options Optional time and relative comparison settings.
  * @returns Timestamp-shaped calendar value.
  * @category calendar
@@ -785,17 +1040,30 @@ export declare function createCalendarTimestamp(date: CalendarDateParts, calenda
  * 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 calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @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;
+/**
+ * Validates whether an input string can be parsed as a calendar adapter timestamp.
+ *
+ * The default Gregorian calendar preserves existing Timestamp semantics. When
+ * an alternate calendar is supplied, `YYYY-MM-DD` is interpreted as native to
+ * that adapter.
+ *
+ * @param input Date or date-time string.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
+ * @returns True when the string can be parsed and exists in the calendar.
+ * @category calendar
+ */
+export declare function validateCalendarTimestamp(input: string, calendar?: CalendarSystem): boolean;
 /**
  * Creates a calendar timestamp from a stable serial day.
  *
  * @param epochDay Stable serial day.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @param options Optional time and relative comparison settings.
  * @returns Timestamp-shaped calendar value.
  * @category calendar
@@ -805,7 +1073,7 @@ export declare function createCalendarTimestampFromEpochDay(epochDay: number, ca
  * Updates formatted calendar metadata on a timestamp-shaped value.
  *
  * @param timestamp Timestamp object to transform.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns Timestamp with adapter date formatting and metadata.
  * @category calendar
  */
@@ -815,7 +1083,7 @@ export declare function updateCalendarFormatted(timestamp: Timestamp, calendar?:
  *
  * @param timestamp Timestamp object to update.
  * @param now Timestamp representing the comparison point in the same calendar.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @param time Include time-of-day in the comparison when true.
  * @returns New Timestamp object with relative flags.
  * @category calendar
@@ -825,7 +1093,7 @@ export declare function updateCalendarRelative(timestamp: Timestamp, now: Timest
  * Returns a calendar timestamp for the next day.
  *
  * @param timestamp Base timestamp.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns New timestamp for the next adapter day.
  * @category calendar
  */
@@ -834,7 +1102,7 @@ export declare function nextCalendarDay(timestamp: Timestamp, calendar?: Calenda
  * Returns a calendar timestamp for the previous day.
  *
  * @param timestamp Base timestamp.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns New timestamp for the previous adapter day.
  * @category calendar
  */
@@ -844,7 +1112,7 @@ export declare function prevCalendarDay(timestamp: Timestamp, calendar?: Calenda
  *
  * @param timestamp Base timestamp.
  * @param amount Number of days to move.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns New timestamp after moving.
  * @category calendar
  */
@@ -854,7 +1122,7 @@ export declare function addCalendarDays(timestamp: Timestamp, amount: number, ca
  *
  * @param timestamp Base timestamp.
  * @param amount Number of calendar months to move.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns New timestamp after moving.
  * @category calendar
  */
@@ -864,7 +1132,7 @@ export declare function addCalendarMonths(timestamp: Timestamp, amount: number,
  *
  * @param timestamp Base timestamp.
  * @param amount Number of calendar years to move.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns New timestamp after moving.
  * @category calendar
  */
@@ -873,7 +1141,7 @@ export declare function addCalendarYears(timestamp: Timestamp, amount: number, c
  * Returns the start of the calendar month for a timestamp.
  *
  * @param timestamp Base timestamp.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns First day of the adapter month.
  * @category calendar
  */
@@ -882,7 +1150,7 @@ export declare function getCalendarStartOfMonth(timestamp: Timestamp, calendar?:
  * Returns the end of the calendar month for a timestamp.
  *
  * @param timestamp Base timestamp.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns Last day of the adapter month.
  * @category calendar
  */
@@ -891,7 +1159,7 @@ export declare function getCalendarEndOfMonth(timestamp: Timestamp, calendar?: C
  * Returns the start of the calendar year for a timestamp.
  *
  * @param timestamp Base timestamp.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns First day of the adapter year.
  * @category calendar
  */
@@ -900,7 +1168,7 @@ export declare function getCalendarStartOfYear(timestamp: Timestamp, calendar?:
  * Returns the end of the calendar year for a timestamp.
  *
  * @param timestamp Base timestamp.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns Last day of the adapter year.
  * @category calendar
  */
@@ -910,7 +1178,7 @@ export declare function getCalendarEndOfYear(timestamp: Timestamp, calendar?: Ca
  *
  * @param timestamp Base timestamp.
  * @param weekday Weekday number to find.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @param direction Direction to search.
  * @param maxDays Maximum days to inspect.
  * @returns Matching timestamp, or the last inspected timestamp.
@@ -922,7 +1190,7 @@ export declare function findCalendarWeekday(timestamp: Timestamp, weekday: numbe
  *
  * @param timestamp Base timestamp.
  * @param weekdays Weekday numbers to include, from `0` Sunday to `6` Saturday.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @param now Optional comparison timestamp from the same calendar.
  * @returns Start of the adapter week.
  * @category calendar
@@ -933,7 +1201,7 @@ export declare function getCalendarStartOfWeek(timestamp: Timestamp, weekdays: n
  *
  * @param timestamp Base timestamp.
  * @param weekdays Weekday numbers to include, from `0` Sunday to `6` Saturday.
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @param now Optional comparison timestamp from the same calendar.
  * @returns End of the adapter week.
  * @category calendar
@@ -945,12 +1213,22 @@ export declare function getCalendarEndOfWeek(timestamp: Timestamp, weekdays: num
  * @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 calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @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[];
+/**
+ * Returns true when a timestamp falls outside the reference timestamp's adapter month.
+ *
+ * @param timestamp Timestamp to test.
+ * @param reference Timestamp whose month defines the inside range.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
+ * @returns True when timestamp is outside reference's calendar month.
+ * @category calendar
+ */
+export declare function isOutsideCalendarMonth(timestamp: Timestamp, reference: Timestamp, calendar?: CalendarSystem): boolean;
 /**
  * Converts a Timestamp time into a sortable numeric identifier.
  *
@@ -986,10 +1264,11 @@ export declare function diffTimestamp(ts1: Timestamp, ts2: Timestamp, strict?: b
  * @param {Timestamp} timestamp Timestamp object to update.
  * @param {Timestamp} now Timestamp representing the comparison point.
  * @param {boolean=} time Include time-of-day in the comparison when true.
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {Timestamp} New Timestamp object with relative flags.
  * @category state
  */
-export declare function updateRelative(timestamp: Timestamp, now: Timestamp, time?: boolean): Timestamp;
+export declare function updateRelative(timestamp: Timestamp, now: Timestamp, time?: boolean, calendar?: CalendarSystem): Timestamp;
 /**
  * Returns a timestamp set to a number of minutes past midnight.
  *
@@ -999,31 +1278,35 @@ export declare function updateRelative(timestamp: Timestamp, now: Timestamp, tim
  * @param {Timestamp} timestamp The Timestamp to transform
  * @param {number} minutes The number of minutes to set from midnight
  * @param {Timestamp=} now Optional Timestamp representing current date and time
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {Timestamp} A new Timestamp
  * @category arithmetic
  */
-export declare function updateMinutes(timestamp: Timestamp, minutes: number, now?: Timestamp | null): Timestamp;
+export declare function updateMinutes(timestamp: Timestamp, minutes: number, now?: Timestamp | null, calendar?: CalendarSystem): Timestamp;
 /**
  * Updates the Timestamp with the weekday
  * @param {Timestamp} timestamp The Timestamp to transform
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns A new Timestamp
  * @category formatting
  */
-export declare function updateWeekday(timestamp: Timestamp): Timestamp;
+export declare function updateWeekday(timestamp: Timestamp, calendar?: CalendarSystem): Timestamp;
 /**
  * Updates the Timestamp with the day of the year (doy)
  * @param {Timestamp} timestamp The Timestamp to transform
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns A new Timestamp
  * @category formatting
  */
-export declare function updateDayOfYear(timestamp: Timestamp): Timestamp;
+export declare function updateDayOfYear(timestamp: Timestamp, calendar?: CalendarSystem): Timestamp;
 /**
  * Updates the Timestamp with the workweek
  * @param {Timestamp} timestamp The Timestamp to transform
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns A new Timestamp
  * @category formatting
  */
-export declare function updateWorkWeek(timestamp: Timestamp): Timestamp;
+export declare function updateWorkWeek(timestamp: Timestamp, calendar?: CalendarSystem): Timestamp;
 /**
  * Updates the passed Timestamp with disabled, if needed
  * @param {Timestamp} timestamp The Timestamp to transform
@@ -1035,34 +1318,93 @@ export declare function updateWorkWeek(timestamp: Timestamp): Timestamp;
  * @category state
  */
 export declare function updateDisabled(timestamp: Timestamp, disabledBefore?: string, disabledAfter?: string, disabledWeekdays?: number[], disabledDays?: DisabledDays): Timestamp;
+/**
+ * Updates a timestamp with disabled state using calendar-native date strings.
+ *
+ * The default Gregorian calendar preserves existing Timestamp behavior. When
+ * an alternate calendar is supplied, `disabledBefore`, `disabledAfter`, and
+ * `disabledDays` are parsed as native dates for that adapter.
+ *
+ * @param timestamp Timestamp to transform.
+ * @param disabledBefore Disable days on or before this adapter date.
+ * @param disabledAfter Disable days on or after this adapter date.
+ * @param disabledWeekdays Weekday numbers to mark disabled.
+ * @param disabledDays Specific adapter dates or date ranges to mark disabled.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
+ * @returns New timestamp with disabled metadata applied.
+ * @category calendar
+ */
+export declare function updateCalendarDisabled(timestamp: Timestamp, disabledBefore?: string, disabledAfter?: string, disabledWeekdays?: number[], disabledDays?: DisabledDays, calendar?: CalendarSystem): Timestamp;
+/**
+ * Resolves selected-date and selected-range state for a calendar timestamp.
+ *
+ * The default Gregorian calendar preserves existing Timestamp behavior. When
+ * an alternate calendar is supplied, selected date strings are parsed as native
+ * adapter dates.
+ *
+ * @param timestamp Timestamp to inspect.
+ * @param options Selected dates and selected start/end dates.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
+ * @returns Selected-date state for the timestamp.
+ * @category calendar
+ */
+export declare function getCalendarSelectionState(timestamp: Timestamp, options?: CalendarSelectionOptions, calendar?: CalendarSystem): CalendarSelectionState;
+/**
+ * Resolves disabled, selected, identity, and outside-month state for one date.
+ *
+ * @param timestamp Timestamp to resolve.
+ * @param options Calendar-aware disabled, selection, and outside-month options.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
+ * @returns Calendar date state suitable for component scopes.
+ * @category calendar
+ */
+export declare function getCalendarDateState(timestamp: Timestamp, options?: CalendarDateStateOptions, calendar?: CalendarSystem): CalendarDateState;
+/**
+ * Creates native calendar month view state for component rendering.
+ *
+ * The returned `days` use adapter-native `YYYY-MM-DD` values, while each
+ * state's identity also includes Gregorian interop metadata.
+ *
+ * @param timestamp Reference timestamp in the adapter calendar.
+ * @param now Timestamp used to calculate relative flags.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
+ * @param options Calendar-aware disabled, selection, weekday, and size options.
+ * @returns Calendar month view state.
+ * @category calendar
+ */
+export declare function createCalendarMonthView(timestamp: Timestamp, now: Timestamp, calendar?: CalendarSystem, options?: CalendarMonthViewOptions): CalendarMonthView;
 /**
  * Updates the passed Timestamp with formatted data (time string, date string, weekday, day of year and workweek)
  * @param {Timestamp} timestamp The Timestamp to transform
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns A new Timestamp
  * @category formatting
  */
-export declare function updateFormatted(timestamp: Timestamp): Timestamp;
+export declare function updateFormatted(timestamp: Timestamp, calendar?: CalendarSystem): Timestamp;
 /**
  * Returns day of the year (doy) for the passed in Timestamp
  * @param {Timestamp} timestamp The Timestamp to use
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {number} The day of the year
  * @category formatting
  */
-export declare function getDayOfYear(timestamp: Timestamp): number | void;
+export declare function getDayOfYear(timestamp: Timestamp, calendar?: CalendarSystem): number | void;
 /**
  * Returns workweek for the passed in Timestamp
  * @param {Timestamp} timestamp The Timestamp to use
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {number} The work week
  * @category formatting
  */
-export declare function getWorkWeek(timestamp: Timestamp): number;
+export declare function getWorkWeek(timestamp: Timestamp, calendar?: CalendarSystem): number;
 /**
  * Returns weekday for the passed in Timestamp
  * @param {Timestamp} timestamp The Timestamp to use
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {number} The weekday
  * @category formatting
  */
-export declare function getWeekday(timestamp: Timestamp): number;
+export declare function getWeekday(timestamp: Timestamp, calendar?: CalendarSystem): number;
 /**
  * Returns an immutable copy of a Timestamp object.
  *
@@ -1088,21 +1430,23 @@ export declare function getStartOfDay(timestamp: Timestamp): Timestamp;
  */
 export declare function getEndOfDay(timestamp: Timestamp): Timestamp;
 /**
- * Returns a Timestamp at the start of the same Gregorian year.
+ * Returns a Timestamp at the start of the same calendar year.
  *
  * @param {Timestamp} timestamp Timestamp object to transform.
- * @returns {Timestamp} New Timestamp for January 1 at `00:00`.
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
+ * @returns {Timestamp} New Timestamp for the first calendar day of the year at `00:00`.
  * @category ranges
  */
-export declare function getStartOfYear(timestamp: Timestamp): Timestamp;
+export declare function getStartOfYear(timestamp: Timestamp, calendar?: CalendarSystem): Timestamp;
 /**
- * Returns a Timestamp at the end of the same Gregorian year.
+ * Returns a Timestamp at the end of the same calendar year.
  *
  * @param {Timestamp} timestamp Timestamp object to transform.
- * @returns {Timestamp} New Timestamp for December 31 at `23:59:59.999`.
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
+ * @returns {Timestamp} New Timestamp for the last calendar day of the year at `23:59:59.999`.
  * @category ranges
  */
-export declare function getEndOfYear(timestamp: Timestamp): Timestamp;
+export declare function getEndOfYear(timestamp: Timestamp, calendar?: CalendarSystem): Timestamp;
 /**
  * Formats the date portion of a Timestamp object.
  *
@@ -1136,30 +1480,33 @@ export declare function getDateTime(timestamp: Timestamp): string;
  * @param {function} [mover=nextDay] The mover function to use (ie: {nextDay} or {prevDay}).
  * @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].
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns A new Timestamp
  * @category ranges
  */
-export declare function moveRelativeDays(timestamp: Timestamp, mover?: typeof nextDay, days?: number, allowedWeekdays?: number[]): Timestamp;
+export declare function moveRelativeDays(timestamp: Timestamp, mover?: typeof nextDay, days?: number, allowedWeekdays?: number[], calendar?: CalendarSystem): Timestamp;
 /**
  * Moves the Timestamp the number of relative days
  * @param {Timestamp} timestamp The Timestamp to transform
  * @param {function} [mover=nextDay] The mover function to use (ie: {nextDay} or {prevDay}).
  * @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].
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns A new Timestamp
  * @category ranges
  */
-export declare function relativeDays(timestamp: Timestamp, mover?: typeof nextDay, days?: number, allowedWeekdays?: number[]): Timestamp;
+export declare function relativeDays(timestamp: Timestamp, mover?: typeof nextDay, days?: number, allowedWeekdays?: number[], calendar?: CalendarSystem): Timestamp;
 /**
  * Finds the specified weekday (forward or back) based on the Timestamp
  * @param {Timestamp} timestamp The Timestamp to transform
  * @param {number} weekday The weekday number (Sun = 0, ..., Sat = 6)
  * @param {function} [mover=nextDay] The function to use ({prevDay} or {nextDay}).
  * @param {number} [maxDays=6] The number of days to look forward or back.
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns A new Timestamp
  * @category ranges
  */
-export declare function findWeekday(timestamp: Timestamp, weekday: number, mover?: typeof nextDay, maxDays?: number): Timestamp;
+export declare function findWeekday(timestamp: Timestamp, weekday: number, mover?: typeof nextDay, maxDays?: number, calendar?: CalendarSystem): Timestamp;
 /**
  * Creates an inclusive list of Timestamp days between start and end.
  *
@@ -1176,10 +1523,11 @@ export declare function findWeekday(timestamp: Timestamp, weekday: number, mover
  * @param {DisabledDays} [disabledDays] Specific dates or date ranges to mark disabled.
  * @param {number} [max=42] Maximum number of days to return.
  * @param {number} [min=0] Minimum number of days to return.
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @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[];
+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, calendar?: CalendarSystem): Timestamp[];
 /**
  * Creates an array of interval Timestamp objects for one day.
  *
@@ -1207,6 +1555,10 @@ export type WeekdayFormatter = (_weekday: keyof typeof weekdayDateMap, _type: st
  * Function that formats a zero-based month number for a locale.
  */
 export type MonthFormatter = (_month: number, _type?: string, _locale?: string) => string;
+/**
+ * Function that formats a one-based calendar adapter month number for a locale.
+ */
+export type CalendarMonthFormatter = (_month: number, _type?: string, _locale?: string, _year?: number) => string;
 /**
  * Returns a host-local locale formatter backed by `Intl.DateTimeFormat`.
  *
@@ -1245,7 +1597,7 @@ export declare function createNativeLocaleFormatterUTC(locale: string, cb: Local
  * `calendar` option. The helper supplies `timeZone: "UTC"` unless the caller
  * provides a different timezone.
  *
- * @param calendar Calendar implementation to use.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @param locale The locale to use.
  * @param cb Callback that returns Intl formatting options.
  * @returns Function that formats a calendar timestamp.
@@ -1275,7 +1627,7 @@ export declare function makeDateUTC(timestamp: Timestamp): Date;
  * 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.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns JavaScript Date object built with `Date.UTC()`.
  * @category calendar
  */
@@ -1292,7 +1644,7 @@ 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.
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns JavaScript Date object built with `Date.UTC()`.
  * @category calendar
  */
@@ -1521,8 +1873,9 @@ export interface AddToDateOptions {
  * Adds or subtracts date/time units from a timestamp.
  *
  * This function returns a new frozen Timestamp; it does not mutate the
- * timestamp passed in. Invalid target dates are normalized through JavaScript
- * Date rules, so month overflow can roll into the following month.
+ * timestamp passed in. Gregorian dates are normalized through JavaScript Date
+ * rules. Adapter-native dates use the supplied calendar system for year,
+ * month, and day math.
  *
  * @param {Timestamp} timestamp Timestamp object to offset.
  * @param {Object} options Date/time units to add or subtract.
@@ -1533,10 +1886,11 @@ export interface AddToDateOptions {
  * @param {number=} options.minute If positive, adds minutes. If negative, removes minutes.
  * @param {number=} options.second If positive, adds seconds. If negative, removes seconds.
  * @param {number=} options.millisecond If positive, adds milliseconds. If negative, removes milliseconds.
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {Timestamp} New normalized Timestamp object.
  * @category arithmetic
  */
-export declare function addToDate(timestamp: Timestamp, options: AddToDateOptions): Timestamp;
+export declare function addToDate(timestamp: Timestamp, options: AddToDateOptions, calendar?: CalendarSystem): Timestamp;
 /**
  * Adds or subtracts date/time units from a timestamp while clamping invalid
  * target month days to the last valid day in the target month.
@@ -1558,10 +1912,11 @@ export declare function addToDate(timestamp: Timestamp, options: AddToDateOption
  * @param {number=} options.minute If positive, adds minutes. If negative, removes minutes.
  * @param {number=} options.second If positive, adds seconds. If negative, removes seconds.
  * @param {number=} options.millisecond If positive, adds milliseconds. If negative, removes milliseconds.
+ * @param {CalendarSystem=} calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
  * @returns {Timestamp} New normalized Timestamp object.
  * @category arithmetic
  */
-export declare function addToDateClamped(timestamp: Timestamp, options: AddToDateOptions): Timestamp;
+export declare function addToDateClamped(timestamp: Timestamp, options: AddToDateOptions, calendar?: CalendarSystem): Timestamp;
 /**
  * Returns number of days between two Timestamps
  * @param {Timestamp} ts1 The first Timestamp
@@ -1708,6 +2063,19 @@ export declare function getWeekdayNames(type: string, locale: string): string[];
  * @category locale
  */
 export declare function getMonthFormatter(): MonthFormatter;
+/**
+ * Returns a function that formats one-based calendar adapter month numbers.
+ *
+ * This is the calendar-aware counterpart to getMonthFormatter(). It converts
+ * adapter fields through the adapter's epoch-day mapping, then asks Intl to
+ * format the equivalent Gregorian Date with the adapter's Intl calendar id
+ * when one is available.
+ *
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
+ * @returns Function that formats one-based month numbers for the adapter.
+ * @category calendar
+ */
+export declare function getCalendarMonthFormatter(calendar?: CalendarSystem): CalendarMonthFormatter;
 /**
  * Retrieves localized month names.
  *
@@ -1717,4 +2085,19 @@ export declare function getMonthFormatter(): MonthFormatter;
  * @category locale
  */
 export declare function getMonthNames(type: string, locale: string): string[];
+/**
+ * Retrieves localized month names for a calendar adapter.
+ *
+ * Month numbers are generated from `1` through `calendar.monthsInYear(year)`.
+ * Pass a year when the calendar can have leap months or year-specific month
+ * naming rules.
+ *
+ * @param calendar Calendar system to use. Defaults to Gregorian; pass an adapter such as islamicCivilCalendar for native calendar fields.
+ * @param type Format type: `narrow`, `short`, or `long`.
+ * @param locale Locale to use for formatting, such as `en-US`.
+ * @param year Calendar year to sample. Defaults to `1`.
+ * @returns Localized month names in calendar-native order.
+ * @category calendar
+ */
+export declare function getCalendarMonthNames(calendar?: CalendarSystem, type?: string, locale?: string, year?: number): string[];
 //# sourceMappingURL=index.d.ts.map