@super-calendar/native 2.3.2 → 2.5.0

package/dist/index.d.mts

@@ -1,10 +1,36 @@
-import { C as CalendarThemeProvider, D as mergeTheme, E as defaultTheme, O as useCalendarTheme, S as CalendarTheme, T as darkTheme, _ as RenderEvent, a as MonthPagerProps, b as WeekStartsOn, c as BusinessHours, d as EventAccessibilityLabelContext, f as EventAccessibilityLabeler, g as RecurrenceRule, h as RecurrenceFrequency, i as MonthPager, l as CalendarEvent, m as ICalendarEvent, n as MonthList, o as MonthView, p as EventKeyExtractor, r as MonthListProps, s as MonthViewProps, t as DefaultMonthEvent, u as CalendarMode, v as RenderEventArgs, w as PartialCalendarTheme, x as WeekdayFormat, y as TimeGridMode } from "./DefaultMonthEvent-BbCMc60z.mjs";
+import { A as darkTheme, C as RenderEventArgs, D as CalendarTheme, E as WeekdayFormat, M as mergeTheme, N as useCalendarTheme, O as CalendarThemeProvider, S as RenderEvent, T as WeekStartsOn, _ as EventAccessibilityLabeler, a as MonthPager, b as RecurrenceFrequency, c as MonthViewProps, d as SlotDefault, f as SlotStyleProps, g as EventAccessibilityLabelContext, h as CalendarMode, i as MonthListSlot, j as defaultTheme, k as PartialCalendarTheme, l as MonthViewSlot, m as CalendarEvent, n as MonthList, o as MonthPagerProps, p as BusinessHours, r as MonthListProps, s as MonthView, t as DefaultMonthEvent, u as ResolvedSlot, v as EventKeyExtractor, w as TimeGridMode, x as RecurrenceRule, y as ICalendarEvent } from "./DefaultMonthEvent-zDj9dHEv.mjs";
 import { Locale } from "date-fns";
 import { ComponentType, ReactElement } from "react";
 import { SharedValue, useSharedValue } from "react-native-reanimated";
-import { CalendarEvent as CalendarEvent$1, DateRange, DateSelectionConstraints, DaySelectionState, EventAccessibilityLabeler as EventAccessibilityLabeler$1, MonthGrid, MonthGridDay, MonthGridWeek, MonthGridWeekday, PositionedEvent, UseDateRangeOptions, UseMonthGridOptions, WeekdayFormat as WeekdayFormat$1, buildMonthGrid, buildMonthWeeks, daySelectionState, eventsInTimeZone, expandRecurringEvents, getIsToday, getViewDays, getWeekDays, isAllDayEvent, isDateSelectable, isRangeEndpoint, isSameCalendarDay, isWeekend, isWithinDateRange, layoutDayEvents, minutesIntoDay, nextDateRange, toZonedTime, useDateRange, useMonthGrid, weekdayFormatToken } from "@super-calendar/core";
+import { CalendarEvent as CalendarEvent$1, DateRange, DateSelectionConstraints, DaySelectionState, EventAccessibilityLabeler as EventAccessibilityLabeler$1, ICalEvent, MonthGrid, MonthGridDay, MonthGridWeek, MonthGridWeekday, PositionedEvent, ToICalendarOptions, UseDateRangeOptions, UseMonthGridOptions, WeekdayFormat as WeekdayFormat$1, buildMonthGrid, buildMonthWeeks, daySelectionState, eventsInTimeZone, expandRecurringEvents, getIsToday, getViewDays, getWeekDays, isAllDayEvent, isDateSelectable, isRangeEndpoint, isSameCalendarDay, isWeekend, isWithinDateRange, layoutDayEvents, minutesIntoDay, nextDateRange, parseICalendar, toICalendar, toZonedTime, useDateRange, useMonthGrid, weekdayFormatToken } from "@super-calendar/core";
 import { StyleProp, ViewStyle } from "react-native";
-
+//#region src/components/Agenda.d.ts
+/**
+ * The styleable parts of {@link Agenda}. Mirrors the dom renderer's slot names;
+ * the event itself is styled by `renderEvent` (or the theme), not a slot.
+ */
+type AgendaSlot = "dayHeader" | "eventRow" | "empty";
+/** Props for {@link Agenda}, the day-grouped list view of events. */
+type AgendaProps<T> = SlotStyleProps<AgendaSlot> & {
+  events: CalendarEvent<T>[];
+  locale?: Locale;
+  renderEvent: RenderEvent<T>;
+  keyExtractor: EventKeyExtractor<T>;
+  onPressEvent: (event: CalendarEvent<T>) => void;
+  onLongPressEvent?: (event: CalendarEvent<T>) => void;
+  onPressDay?: (date: Date) => void;
+  /** Highlight this date's header instead of the real "today". */
+  activeDate?: Date;
+  /** Drawn between rows of the agenda list. */
+  itemSeparatorComponent?: ComponentType<unknown> | null;
+};
+/**
+ * A vertical, day-grouped list of events (no time grid). Events are sorted by
+ * start, grouped under a date header per day. The consumer controls which
+ * events (and therefore which date range) are shown.
+ */
+declare function Agenda<T>({ events, locale, renderEvent, keyExtractor, onPressEvent, onLongPressEvent, onPressDay, activeDate, itemSeparatorComponent, classNames, styles: styleOverrides }: AgendaProps<T>): ReactElement;
+//#endregion
 //#region src/components/TimeGrid.d.ts
 /** Default height in pixels of one hour row on the time grid. */
 declare const DEFAULT_HOUR_HEIGHT = 48;
@@ -23,9 +49,21 @@ type EventDragHandler<T> = (event: CalendarEvent<T>, start: Date, end: Date) =>
 type EventDragStartHandler<T> = (event: CalendarEvent<T>) => void;
 /** Replace the hour-axis label. Receives the hour (0–23) and the `ampm` flag. */
 type HourRenderer = (hour: number, ampm: boolean) => React.ReactNode;
+/**
+ * The styleable parts of {@link TimeGrid}. Mirrors the dom renderer's slot names
+ * where the structure matches; `columnHeaderDateText`, `weekendShade` and
+ * `daySeparator` are native-only (the dom grid styles those through its
+ * `dayColumn`/`columnHeaderDate` elements). Slots rendered as Reanimated views
+ * (`gridLines` sub-hour dividers, `businessHours`, `weekendShade`,
+ * `daySeparator`, `event`, `nowIndicator`, `createGhost`) always honour the
+ * `styles` map; their `className` reaches the element but needs a Tailwind
+ * runtime that styles Animated components.
+ */
+type TimeGridSlot = "header" | "weekNumber" | "columnHeader" | "columnHeaderWeekday" | "columnHeaderDate" | "columnHeaderDateText" | "allDayLane" | "allDayLabel" | "allDayColumn" | "allDayEvent" | "hourLabel" | "gridLines" | "businessHours" | "weekendShade" | "daySeparator" | "event" | "nowIndicator" | "createGhost";
 /** Props for {@link TimeGrid}, the day/week timetable view. */
-type TimeGridProps<T> = {
-  mode: TimeGridMode; /** Day columns to show in `custom` mode. Ignored by day/3days/week. Default 1. */
+type TimeGridProps<T> = SlotStyleProps<TimeGridSlot> & {
+  mode: TimeGridMode;
+  /** Day columns to show in `custom` mode. Ignored by day/3days/week. Default 1. */
   numberOfDays?: number;
   /**
    * Last weekday of a `custom` partial-week view (0–6). When set, `custom` shows
@@ -35,9 +73,11 @@ type TimeGridProps<T> = {
   weekEndsOn?: WeekStartsOn;
   date: Date;
   events: CalendarEvent<T>[];
-  cellHeight: SharedValue<number>; /** Initial per-hour row height in px; seeds scroll/zoom without reading the shared value during render. */
+  cellHeight: SharedValue<number>;
+  /** Initial per-hour row height in px; seeds scroll/zoom without reading the shared value during render. */
   hourHeight?: number;
-  weekStartsOn: WeekStartsOn; /** Column-header weekday label width: `narrow` ("M"), `short` ("Mon", default), or `long` ("Monday"). */
+  weekStartsOn: WeekStartsOn;
+  /** Column-header weekday label width: `narrow` ("M"), `short` ("Mon", default), or `long` ("Monday"). */
   weekdayFormat?: WeekdayFormat$1;
   renderEvent: RenderEvent<T>;
   /**
@@ -48,30 +88,48 @@ type TimeGridProps<T> = {
   eventAccessibilityLabel?: EventAccessibilityLabeler$1<T>;
   keyExtractor: EventKeyExtractor<T>;
   scrollOffsetMinutes?: number;
-  hourColumnWidth?: number; /** Hide the left hour-axis column (lines stay, labels/gutter go). Default false. */
-  hideHours?: boolean; /** Sub-hour divider lines per hour (e.g. 2 = half-hours). Default 1 (none). */
-  timeslots?: number; /** Show the all-day lane above the grid. Default true. */
-  showAllDayEventCell?: boolean; /** Per-date style merged onto each day column. */
+  hourColumnWidth?: number;
+  /** Hide the left hour-axis column (lines stay, labels/gutter go). Default false. */
+  hideHours?: boolean;
+  /** Sub-hour divider lines per hour (e.g. 2 = half-hours). Default 1 (none). */
+  timeslots?: number;
+  /** Show the all-day lane above the grid. Default true. */
+  showAllDayEventCell?: boolean;
+  /** Per-date style merged onto each day column. */
   calendarCellStyle?: (date: Date) => StyleProp<ViewStyle>;
-  businessHours?: BusinessHours; /** Show the ISO week number in the header gutter. Default false. */
-  showWeekNumber?: boolean; /** Element rendered between the day header and the grid. */
-  headerComponent?: React.ReactNode; /** First hour shown (0–23). Default 0. */
-  minHour?: number; /** Last hour shown, exclusive (1–24). Default 24. */
-  maxHour?: number; /** Show hour labels in 12-hour AM/PM form. Default false (24h). */
-  ampm?: boolean; /** Reverse day-column order (right-to-left). Default false. */
+  businessHours?: BusinessHours;
+  /** Show the ISO week number in the header gutter. Default false. */
+  showWeekNumber?: boolean;
+  /** Element rendered between the day header and the grid. */
+  headerComponent?: React.ReactNode;
+  /** First hour shown (0–23). Default 0. */
+  minHour?: number;
+  /** Last hour shown, exclusive (1–24). Default 24. */
+  maxHour?: number;
+  /** Show hour labels in 12-hour AM/PM form. Default false (24h). */
+  ampm?: boolean;
+  /** Reverse day-column order (right-to-left). Default false. */
   isRTL?: boolean;
   minHourHeight?: number;
   maxHourHeight?: number;
   showNowIndicator?: boolean;
   locale?: Locale;
-  freeSwipe?: boolean; /** Allow swiping between pages. Default true. */
-  swipeEnabled?: boolean; /** Show the vertical scroll indicator on the time grid. Default true. */
-  showVerticalScrollIndicator?: boolean; /** Allow vertical scrolling of the time grid. Default true. */
-  verticalScrollEnabled?: boolean; /** Prefix for the week-number label (e.g. "W"). Default "W". */
-  weekNumberPrefix?: string; /** Replace the hour-axis label. Receives the hour (0–23) and `ampm`. */
-  hourComponent?: HourRenderer; /** Highlight this date in the header instead of the real "today". */
-  activeDate?: Date; /** After an empty-cell press, snap the pager back to the active page. Default false. */
-  resetPageOnPressCell?: boolean; /** Minutes a drag-to-move/resize snaps to. Default 15. */
+  freeSwipe?: boolean;
+  /** Allow swiping between pages. Default true. */
+  swipeEnabled?: boolean;
+  /** Show the vertical scroll indicator on the time grid. Default true. */
+  showVerticalScrollIndicator?: boolean;
+  /** Allow vertical scrolling of the time grid. Default true. */
+  verticalScrollEnabled?: boolean;
+  /** Prefix for the week-number label (e.g. "W"). Default "W". */
+  weekNumberPrefix?: string;
+  /** Replace the hour-axis label. Receives the hour (0–23) and `ampm`. */
+  hourComponent?: HourRenderer;
+  /** Highlight this date in the header instead of the real "today". */
+  activeDate?: Date;
+  /** After an empty-cell press, snap the pager back to the active page. Default false. */
+  resetPageOnPressCell?: boolean;
+  /** Minutes a drag-to-move/resize snaps to. Default 15. */
   dragStepMinutes?: number;
   /**
    * Show the resize grip on draggable events. Default true. Set false to keep
@@ -84,66 +142,19 @@ type TimeGridProps<T> = {
    * Enable drag-to-move and drag-to-resize on the week/day grid. Called with the
    * event's new start/end (snapped to `dragStepMinutes`); update your own state.
    */
-  onDragEvent?: EventDragHandler<T>; /** Fired the moment an event is grabbed for a move or resize (e.g. for haptics). */
+  onDragEvent?: EventDragHandler<T>;
+  /** Fired the moment an event is grabbed for a move or resize (e.g. for haptics). */
   onDragStart?: EventDragStartHandler<T>;
   onPressCell?: (date: Date) => void;
   onLongPressCell?: (date: Date) => void;
-  onCreateEvent?: (start: Date, end: Date) => void; /** Tap a day's column header (default header only). */
+  onCreateEvent?: (start: Date, end: Date) => void;
+  /** Tap a day's column header (default header only). */
   onPressDateHeader?: (date: Date) => void;
-  onChangeDate: (date: Date) => void; /** Optional header above the grid (e.g. weekday labels). Rendered full-width. */
+  onChangeDate: (date: Date) => void;
+  /** Optional header above the grid (e.g. weekday labels). Rendered full-width. */
   renderHeader?: (days: Date[]) => React.ReactNode;
 };
-declare function TimeGridInner<T>({
-  mode,
-  numberOfDays,
-  weekEndsOn,
-  date,
-  events,
-  cellHeight,
-  hourHeight,
-  weekStartsOn,
-  weekdayFormat,
-  renderEvent,
-  eventAccessibilityLabel,
-  keyExtractor,
-  scrollOffsetMinutes,
-  hourColumnWidth: hourColumnWidthProp,
-  hideHours,
-  timeslots,
-  showAllDayEventCell,
-  calendarCellStyle,
-  businessHours,
-  showWeekNumber,
-  headerComponent,
-  minHour,
-  maxHour,
-  ampm,
-  isRTL,
-  minHourHeight,
-  maxHourHeight,
-  showNowIndicator,
-  locale,
-  freeSwipe,
-  swipeEnabled,
-  showVerticalScrollIndicator,
-  verticalScrollEnabled,
-  weekNumberPrefix,
-  hourComponent,
-  activeDate,
-  resetPageOnPressCell,
-  dragStepMinutes,
-  showDragHandle,
-  onPressEvent,
-  onLongPressEvent,
-  onDragEvent,
-  onDragStart,
-  onPressCell,
-  onLongPressCell,
-  onCreateEvent,
-  onPressDateHeader,
-  onChangeDate,
-  renderHeader
-}: TimeGridProps<T>): ReactElement;
+declare function TimeGridInner<T>({ mode, numberOfDays, weekEndsOn, date, events, cellHeight, hourHeight, weekStartsOn, weekdayFormat, renderEvent, eventAccessibilityLabel, keyExtractor, scrollOffsetMinutes, hourColumnWidth: hourColumnWidthProp, hideHours, timeslots, showAllDayEventCell, calendarCellStyle, businessHours, showWeekNumber, headerComponent, minHour, maxHour, ampm, isRTL, minHourHeight, maxHourHeight, showNowIndicator, locale, freeSwipe, swipeEnabled, showVerticalScrollIndicator, verticalScrollEnabled, weekNumberPrefix, hourComponent, activeDate, resetPageOnPressCell, dragStepMinutes, showDragHandle, onPressEvent, onLongPressEvent, onDragEvent, onDragStart, onPressCell, onLongPressCell, onCreateEvent, onPressDateHeader, onChangeDate, renderHeader, classNames, styles: styleOverrides }: TimeGridProps<T>): ReactElement;
 /**
  * The timetable view used in day, 3days, week, and custom modes: an
  * hour-by-hour grid with positioned event boxes, an all-day lane, pinch-to-zoom
@@ -166,14 +177,22 @@ declare function TimeGridInner<T>({
 declare const TimeGrid: typeof TimeGridInner;
 //#endregion
 //#region src/components/Calendar.d.ts
+/**
+ * Every styleable slot across the Calendar's views. The month slots reach the
+ * month pager, the grid slots reach the time grid, and the agenda slots reach
+ * the schedule view; slots for views that aren't rendered are ignored.
+ */
+type CalendarSlot = MonthViewSlot | TimeGridSlot | AgendaSlot;
 /** Props for the {@link Calendar} component. */
-type CalendarProps<T> = {
+type CalendarProps<T> = SlotStyleProps<CalendarSlot> & {
   events: CalendarEvent<T>[];
   mode: CalendarMode;
   date: Date;
-  onChangeDate: (date: Date) => void; /** Fired alongside `onChangeDate` with the `[start, end]` of the newly-visible range. */
+  onChangeDate: (date: Date) => void;
+  /** Fired alongside `onChangeDate` with the `[start, end]` of the newly-visible range. */
   onChangeDateRange?: (range: [Date, Date]) => void;
-  onPressEvent: (event: CalendarEvent<T>) => void; /** Long-press an event (month/week/day). */
+  onPressEvent: (event: CalendarEvent<T>) => void;
+  /** Long-press an event (month/week/day). */
   onLongPressEvent?: (event: CalendarEvent<T>) => void;
   /**
    * Enable drag-to-move and drag-to-resize on the week/day grid. Called with the
@@ -190,18 +209,25 @@ type CalendarProps<T> = {
    * `Haptics.impactAsync()` from `expo-haptics`. Native-only and inert unless
    * `onDragEvent` is also set.
    */
-  onDragStart?: EventDragStartHandler<T>; /** Minutes a drag-to-move/resize snaps to. Default 15. */
+  onDragStart?: EventDragStartHandler<T>;
+  /** Minutes a drag-to-move/resize snaps to. Default 15. */
   dragStepMinutes?: number;
   /**
    * Show the resize grip on draggable events. Default true. Set false to keep
    * drag-to-move and drag-to-resize working while hiding the visible indicator.
    */
-  showDragHandle?: boolean; /** Tap a day cell (month mode) — e.g. drill into the day view. */
-  onPressDay?: (date: Date) => void; /** Long-press a day cell (month mode). */
-  onLongPressDay?: (date: Date) => void; /** Tap the "+N more" overflow label in a month cell. */
-  onPressMore?: (events: CalendarEvent<T>[], date: Date) => void; /** Tap empty space on the week/day grid; receives the date+time pressed. */
-  onPressCell?: (date: Date) => void; /** After an empty-cell press, snap the pager back to the active page. Default false. */
-  resetPageOnPressCell?: boolean; /** Long-press empty space on the week/day grid; receives the date+time. */
+  showDragHandle?: boolean;
+  /** Tap a day cell (month mode) — e.g. drill into the day view. */
+  onPressDay?: (date: Date) => void;
+  /** Long-press a day cell (month mode). */
+  onLongPressDay?: (date: Date) => void;
+  /** Tap the "+N more" overflow label in a month cell. */
+  onPressMore?: (events: CalendarEvent<T>[], date: Date) => void;
+  /** Tap empty space on the week/day grid; receives the date+time pressed. */
+  onPressCell?: (date: Date) => void;
+  /** After an empty-cell press, snap the pager back to the active page. Default false. */
+  resetPageOnPressCell?: boolean;
+  /** Long-press empty space on the week/day grid; receives the date+time. */
   onLongPressCell?: (date: Date) => void;
   /**
    * Enable drag-to-create on the week/day grid: long-press empty space and drag
@@ -210,74 +236,115 @@ type CalendarProps<T> = {
    * stationary press yields a one-step range. Native-only; supersedes
    * `onLongPressCell` on empty space when set.
    */
-  onCreateEvent?: (start: Date, end: Date) => void; /** Tap a day's column header on the week/day grid (default header only). */
+  onCreateEvent?: (start: Date, end: Date) => void;
+  /** Tap a day's column header on the week/day grid (default header only). */
   onPressDateHeader?: (date: Date) => void;
   /**
    * Max event chips per month cell before they collapse into "+N more". Omit to
    * auto-fit as many as the cell height allows (default); set a number for a
    * fixed cap. Pass an explicit value when using a custom `renderEvent`.
    */
-  maxVisibleEventCount?: number; /** Sort each month day's events by start. Default true. */
-  sortedMonthView?: boolean; /** Month overflow label template; `{moreCount}` is replaced. Default "{moreCount} More". */
-  moreLabel?: string; /** Show dimmed adjacent-month days in the month grid. Default true. */
-  showAdjacentMonths?: boolean; /** Ignore taps on month-cell events (day taps still fire). Default false. */
-  disableMonthEventCellPress?: boolean; /** First day of the week. Sunday = 0 (default) … Saturday = 6. */
-  weekStartsOn?: WeekStartsOn; /** Weekday header label width: `narrow` ("M"), `short` ("Mon", default), or `long` ("Monday"). */
-  weekdayFormat?: WeekdayFormat$1; /** Number of day columns when `mode="custom"`. Ignored by other modes. Default 1. */
+  maxVisibleEventCount?: number;
+  /** Sort each month day's events by start. Default true. */
+  sortedMonthView?: boolean;
+  /** Month overflow label template; `{moreCount}` is replaced. Default "{moreCount} More". */
+  moreLabel?: string;
+  /** Show dimmed adjacent-month days in the month grid. Default true. */
+  showAdjacentMonths?: boolean;
+  /** Ignore taps on month-cell events (day taps still fire). Default false. */
+  disableMonthEventCellPress?: boolean;
+  /** First day of the week. Sunday = 0 (default) … Saturday = 6. */
+  weekStartsOn?: WeekStartsOn;
+  /** Weekday header label width: `narrow` ("M"), `short` ("Mon", default), or `long` ("Monday"). */
+  weekdayFormat?: WeekdayFormat$1;
+  /** Number of day columns when `mode="custom"`. Ignored by other modes. Default 1. */
   numberOfDays?: number;
   /**
    * Last weekday of a `custom` partial-week view (0–6). When set, `custom` shows
    * `weekStartsOn`…`weekEndsOn` of the visible week and pages by week, taking
    * precedence over `numberOfDays`. Ignored by other modes.
    */
-  weekEndsOn?: WeekStartsOn; /** Replace the built-in event box. Return a `flex: 1` element. */
+  weekEndsOn?: WeekStartsOn;
+  /** Replace the built-in event box. Return a `flex: 1` element. */
   renderEvent?: RenderEvent<T>;
   /**
    * Override the screen-reader label for each event. Receives the event and a
    * `{ mode, isAllDay, ampm }` context; return the full text to announce. Applies
    * across every view. Defaults to the built-in title-and-time label.
    */
-  eventAccessibilityLabel?: EventAccessibilityLabeler$1<T>; /** Per-event style merged onto the built-in event box (static or a function of the event). */
-  eventCellStyle?: StyleProp<ViewStyle> | ((event: CalendarEvent<T>) => StyleProp<ViewStyle>); /** Per-date style for month cells and week/day columns (e.g. shade specific dates). */
+  eventAccessibilityLabel?: EventAccessibilityLabeler$1<T>;
+  /** Per-event style merged onto the built-in event box (static or a function of the event). */
+  eventCellStyle?: StyleProp<ViewStyle> | ((event: CalendarEvent<T>) => StyleProp<ViewStyle>);
+  /** Per-date style for month cells and week/day columns (e.g. shade specific dates). */
   calendarCellStyle?: (date: Date) => StyleProp<ViewStyle>;
   /**
    * Week/day grid only: open hours per day for business-hours shading. Hours
    * outside the returned `{ start, end }` are tinted; return `null` to shade the
    * whole day (closed). Omit for no shading.
    */
-  businessHours?: BusinessHours; /** Stable key per event. Defaults to start-time + index. */
-  keyExtractor?: EventKeyExtractor<T>; /** Partial theme merged over the defaults. */
-  theme?: PartialCalendarTheme; /** Externally-owned per-hour row height (week/day). Created internally if omitted. */
-  cellHeight?: ReturnType<typeof useSharedValue<number>>; /** Initial per-hour row height in px (week/day). Default 48. */
+  businessHours?: BusinessHours;
+  /** Stable key per event. Defaults to start-time + index. */
+  keyExtractor?: EventKeyExtractor<T>;
+  /** Partial theme merged over the defaults. */
+  theme?: PartialCalendarTheme;
+  /** Externally-owned per-hour row height (week/day). Created internally if omitted. */
+  cellHeight?: ReturnType<typeof useSharedValue<number>>;
+  /** Initial per-hour row height in px (week/day). Default 48. */
   hourHeight?: number;
   minHourHeight?: number;
   maxHourHeight?: number;
-  hourColumnWidth?: number; /** Hide the left hour-axis column on the week/day grid. Default false. */
-  hideHours?: boolean; /** Sub-hour divider lines per hour on the week/day grid (e.g. 2 = half-hours). Default 1. */
+  hourColumnWidth?: number;
+  /** Hide the left hour-axis column on the week/day grid. Default false. */
+  hideHours?: boolean;
+  /** Sub-hour divider lines per hour on the week/day grid (e.g. 2 = half-hours). Default 1. */
   timeslots?: number;
   /**
    * Show the all-day lane above the week/day grid. Default true. When false the
    * lane is never rendered, so all-day events (see `ICalendarEvent.allDay` and
    * whole-day spans) are not shown on the time grid.
    */
-  showAllDayEventCell?: boolean; /** Show the ISO week number in the week/day header gutter. Default false. */
-  showWeekNumber?: boolean; /** Prefix for the week-number label (e.g. "W"). Default "W". */
-  weekNumberPrefix?: string; /** Replace the hour-axis label on the week/day grid. Receives the hour (0–23) and `ampm`. */
-  hourComponent?: HourRenderer; /** Always render six week rows in month view, for a fixed-height grid. Default false. */
-  showSixWeeks?: boolean; /** Allow swiping between pages (all modes). Default true. */
-  swipeEnabled?: boolean; /** Show the vertical scroll indicator on the week/day grid. Default true. */
-  showVerticalScrollIndicator?: boolean; /** Allow vertical scrolling of the week/day grid. Default true. */
-  verticalScrollEnabled?: boolean; /** Element rendered between the day header and the week/day grid. */
-  headerComponent?: React.ReactNode; /** First hour shown on the week/day grid (0–23). Default 0. */
-  minHour?: number; /** Last hour shown on the week/day grid, exclusive (1–24). Default 24. */
-  maxHour?: number; /** Show hour labels (and built-in event times) in 12-hour AM/PM form. Default false (24h). */
-  ampm?: boolean; /** Show the time range in the built-in event renderer (day/week/schedule). Default true. */
-  showTime?: boolean; /** Add a trailing ellipsis (…) when an event title overflows in the built-in renderer; otherwise the text is clipped. Default false. */
-  ellipsizeTitle?: boolean; /** Label the built-in renderer shows for an all-day event in the schedule (and its screen-reader text). Default "All day". */
-  allDayLabel?: string; /** Initial vertical scroll, in minutes from midnight (week/day). */
-  scrollOffsetMinutes?: number; /** Show the current-time line on the week/day grid. Default true. */
-  showNowIndicator?: boolean; /** A date-fns `Locale` for weekday/date labels. Defaults to English. */
-  locale?: Locale; /** Highlight this date (header/cell/agenda) instead of the real "today". */
+  showAllDayEventCell?: boolean;
+  /** Show the ISO week number in the week/day header gutter. Default false. */
+  showWeekNumber?: boolean;
+  /** Prefix for the week-number label (e.g. "W"). Default "W". */
+  weekNumberPrefix?: string;
+  /** Replace the hour-axis label on the week/day grid. Receives the hour (0–23) and `ampm`. */
+  hourComponent?: HourRenderer;
+  /** Always render six week rows in month view, for a fixed-height grid. Default false. */
+  showSixWeeks?: boolean;
+  /** Allow swiping between pages (all modes). Default true. */
+  swipeEnabled?: boolean;
+  /** Show the vertical scroll indicator on the week/day grid. Default true. */
+  showVerticalScrollIndicator?: boolean;
+  /** Allow vertical scrolling of the week/day grid. Default true. */
+  verticalScrollEnabled?: boolean;
+  /** Element rendered between the day header and the week/day grid. */
+  headerComponent?: React.ReactNode;
+  /** First hour shown on the week/day grid (0–23). Default 0. */
+  minHour?: number;
+  /** Last hour shown on the week/day grid, exclusive (1–24). Default 24. */
+  maxHour?: number;
+  /** Show hour labels (and built-in event times) in 12-hour AM/PM form. Default false (24h). */
+  ampm?: boolean;
+  /** Show the time range in the built-in event renderer (day/week/schedule). Default true. */
+  showTime?: boolean;
+  /** Add a trailing ellipsis (…) when an event title overflows in the built-in renderer; otherwise the text is clipped. Default false. */
+  ellipsizeTitle?: boolean;
+  /** Label the built-in renderer shows for an all-day event in the schedule (and its screen-reader text). Default "All day". */
+  allDayLabel?: string;
+  /** Initial vertical scroll, in minutes from midnight (week/day). */
+  scrollOffsetMinutes?: number;
+  /** Show the current-time line on the week/day grid. Default true. */
+  showNowIndicator?: boolean;
+  /** A date-fns `Locale` for weekday/date labels. Defaults to English. */
+  locale?: Locale;
+  /**
+   * Display events in this IANA time zone (e.g. `"America/New_York"`), DST-correct
+   * and independent of the device zone. Display-only: it shifts the wall-clock the
+   * grid lays out from, it doesn't change your `Date`s. Uses `eventsInTimeZone`.
+   */
+  timeZone?: string;
+  /** Highlight this date (header/cell/agenda) instead of the real "today". */
   activeDate?: Date;
   /**
    * Lay the day columns out right-to-left (month, week/day grid and all-day lane).
@@ -290,15 +357,18 @@ type CalendarProps<T> = {
    * Allow a fling to carry across several pages before snapping. Default false:
    * one day/week/month per swipe.
    */
-  freeSwipe?: boolean; /** Custom header above the week/day grid. Receives the visible days. */
-  renderTimeGridHeader?: (days: Date[]) => React.ReactNode; /** Replace the weekday-label header above the month grid. Return `null` to hide it. */
+  freeSwipe?: boolean;
+  /** Custom header above the week/day grid. Receives the visible days. */
+  renderTimeGridHeader?: (days: Date[]) => React.ReactNode;
+  /** Replace the weekday-label header above the month grid. Return `null` to hide it. */
   renderHeaderForMonthView?: (weekDays: Date[]) => React.ReactNode;
   /**
    * Month mode only: replace the default date badge in each day cell. Receives
    * the day; return your own date label (e.g. a number with a dot or badge).
    * Event chips and the "+N more" label still render below it.
    */
-  renderCustomDateForMonth?: (date: Date) => React.ReactNode; /** Drawn between rows of the `schedule` (agenda) list. */
+  renderCustomDateForMonth?: (date: Date) => React.ReactNode;
+  /** Drawn between rows of the `schedule` (agenda) list. */
   itemSeparatorComponent?: React.ComponentType<unknown> | null;
 };
 /**
@@ -327,105 +397,7 @@ type CalendarProps<T> = {
  * }
  * ```
  */
-declare function Calendar<T>({
-  events,
-  mode,
-  date,
-  onChangeDate,
-  onChangeDateRange,
-  onPressEvent,
-  onLongPressEvent,
-  onDragEvent,
-  onDragStart,
-  dragStepMinutes,
-  showDragHandle,
-  onPressDay,
-  onLongPressDay,
-  onPressMore,
-  onPressCell,
-  resetPageOnPressCell,
-  onLongPressCell,
-  onCreateEvent,
-  onPressDateHeader,
-  maxVisibleEventCount,
-  sortedMonthView,
-  moreLabel,
-  showAdjacentMonths,
-  disableMonthEventCellPress,
-  weekStartsOn,
-  weekdayFormat,
-  numberOfDays,
-  weekEndsOn,
-  renderEvent,
-  eventAccessibilityLabel,
-  eventCellStyle,
-  calendarCellStyle,
-  businessHours,
-  keyExtractor,
-  theme,
-  cellHeight: cellHeightProp,
-  hourHeight,
-  minHourHeight,
-  maxHourHeight,
-  hourColumnWidth,
-  hideHours,
-  timeslots,
-  showAllDayEventCell,
-  showWeekNumber,
-  weekNumberPrefix,
-  hourComponent,
-  showSixWeeks,
-  swipeEnabled,
-  showVerticalScrollIndicator,
-  verticalScrollEnabled,
-  headerComponent,
-  minHour,
-  maxHour,
-  ampm,
-  showTime,
-  ellipsizeTitle,
-  allDayLabel,
-  scrollOffsetMinutes,
-  showNowIndicator,
-  locale,
-  activeDate,
-  isRTL,
-  freeSwipe,
-  renderTimeGridHeader,
-  renderHeaderForMonthView,
-  renderCustomDateForMonth,
-  itemSeparatorComponent
-}: CalendarProps<T>): ReactElement;
-//#endregion
-//#region src/components/Agenda.d.ts
-/** Props for {@link Agenda}, the day-grouped list view of events. */
-type AgendaProps<T> = {
-  events: CalendarEvent<T>[];
-  locale?: Locale;
-  renderEvent: RenderEvent<T>;
-  keyExtractor: EventKeyExtractor<T>;
-  onPressEvent: (event: CalendarEvent<T>) => void;
-  onLongPressEvent?: (event: CalendarEvent<T>) => void;
-  onPressDay?: (date: Date) => void; /** Highlight this date's header instead of the real "today". */
-  activeDate?: Date; /** Drawn between rows of the agenda list. */
-  itemSeparatorComponent?: ComponentType<unknown> | null;
-};
-/**
- * A vertical, day-grouped list of events (no time grid). Events are sorted by
- * start, grouped under a date header per day. The consumer controls which
- * events (and therefore which date range) are shown.
- */
-declare function Agenda<T>({
-  events,
-  locale,
-  renderEvent,
-  keyExtractor,
-  onPressEvent,
-  onLongPressEvent,
-  onPressDay,
-  activeDate,
-  itemSeparatorComponent
-}: AgendaProps<T>): ReactElement;
+declare function Calendar<T>({ events, mode, date, onChangeDate, onChangeDateRange, onPressEvent, onLongPressEvent, onDragEvent, onDragStart, dragStepMinutes, showDragHandle, onPressDay, onLongPressDay, onPressMore, onPressCell, resetPageOnPressCell, onLongPressCell, onCreateEvent, onPressDateHeader, maxVisibleEventCount, sortedMonthView, moreLabel, showAdjacentMonths, disableMonthEventCellPress, weekStartsOn, weekdayFormat, numberOfDays, weekEndsOn, renderEvent, eventAccessibilityLabel, eventCellStyle, calendarCellStyle, businessHours, keyExtractor, theme, cellHeight: cellHeightProp, hourHeight, minHourHeight, maxHourHeight, hourColumnWidth, hideHours, timeslots, showAllDayEventCell, showWeekNumber, weekNumberPrefix, hourComponent, showSixWeeks, swipeEnabled, showVerticalScrollIndicator, verticalScrollEnabled, headerComponent, minHour, maxHour, ampm, showTime, ellipsizeTitle, allDayLabel, scrollOffsetMinutes, showNowIndicator, locale, timeZone, activeDate, isRTL, freeSwipe, renderTimeGridHeader, renderHeaderForMonthView, renderCustomDateForMonth, itemSeparatorComponent, classNames, styles: styleOverrides }: CalendarProps<T>): ReactElement;
 //#endregion
 //#region src/components/DefaultEvent.d.ts
 /**
@@ -436,20 +408,7 @@ declare function Agenda<T>({
  * only shows once a full line is free beneath the title. Pass your own
  * `renderEvent` to `<Calendar>` to replace it entirely.
  */
-declare function DefaultEvent<T>({
-  event,
-  mode,
-  boxHeight,
-  isAllDay,
-  ampm,
-  showTime,
-  ellipsizeTitle,
-  allDayLabel,
-  accessibilityLabel: accessibilityLabelProp,
-  cellStyle,
-  onPress,
-  onLongPress
-}: RenderEventArgs<T>): ReactElement;
+declare function DefaultEvent<T>({ event, mode, boxHeight, isAllDay, ampm, showTime, ellipsizeTitle, allDayLabel, accessibilityLabel: accessibilityLabelProp, accessibilityActions, onAccessibilityAction, cellStyle, onPress, onLongPress }: RenderEventArgs<T>): ReactElement;
 //#endregion
 //#region src/components/ResourceTimeline.d.ts
 /** A schedulable lane (room, person, machine) events are grouped under. */
@@ -462,15 +421,27 @@ interface Resource {
 /** Props passed to a custom resource-timeline event renderer. */
 interface ResourceEventArgs<T = unknown> {
   event: CalendarEvent$1<T>;
-  /** Pixel width of the event bar. */
+  /**
+   * Pixel width of the event bar. In the vertical orientation the columns flex
+   * to the container, so this is 0 there; size against `height` instead.
+   */
   width: number;
+  /** Pixel height of the event bar; set in the vertical orientation. */
+  height?: number;
   onPress: () => void;
 }
 /** Props for {@link ResourceTimeline}. */
 interface ResourceTimelineProps<T = unknown> {
-  /** The day to lay out along the horizontal axis. */
+  /** The day to lay out along the time axis. */
   date: Date;
-  /** The rows, top to bottom. */
+  /**
+   * Lay the day out along the horizontal axis with resources as rows (the
+   * default), or down the vertical axis with resources as columns, like the
+   * time grid. Vertical reads better on narrow screens: the columns share the
+   * width instead of the axis scrolling sideways.
+   */
+  orientation?: "horizontal" | "vertical";
+  /** The resource lanes: rows when horizontal, columns when vertical. */
   resources: Resource[];
   /** Events; each is placed in the row named by `resourceId(event)`. */
   events: CalendarEvent$1<T>[];
@@ -480,11 +451,13 @@ interface ResourceTimelineProps<T = unknown> {
   startHour?: number;
   /** Last hour shown, exclusive (default 24). */
   endHour?: number;
-  /** Pixels per hour along the axis (default 80). */
+  /** Pixels per hour along the horizontal axis (default 80). Horizontal only. */
   hourWidth?: number;
-  /** Height of each resource row in px (default 56). */
+  /** Pixels per hour down the vertical axis (default 48). Vertical only. */
+  hourHeight?: number;
+  /** Height of each resource row in px (default 56). Horizontal only. */
   rowHeight?: number;
-  /** Width of the left resource-label column in px (default 140). */
+  /** Width of the left resource-label column in px (default 140). Horizontal only. */
   labelWidth?: number;
   /** 12-hour AM/PM axis labels (default false). */
   ampm?: boolean;
@@ -492,12 +465,38 @@ interface ResourceTimelineProps<T = unknown> {
   renderEvent?: ComponentType<ResourceEventArgs<T>>;
   /** Tap an event. */
   onPressEvent?: (event: CalendarEvent$1<T>) => void;
+  /**
+   * Long-press an event. When `onDragEvent` is also set, a long-press picks the
+   * bar up to move instead, so this fires only for non-draggable bars.
+   */
+  onLongPressEvent?: (event: CalendarEvent$1<T>) => void;
   /**
    * Enables drag-to-move and edge-resize along the time axis: long-press a bar to
    * move it, or drag its right edge to resize. Called with the proposed new
    * start/end; return `false` to reject the drop (it snaps back).
    */
   onDragEvent?: (event: CalendarEvent$1<T>, start: Date, end: Date) => void | boolean;
+  /** Tap empty lane space; called with the snapped time and the lane's resource. */
+  onPressCell?: (at: Date, resource: Resource) => void;
+  /**
+   * Long-press empty lane space. When `onCreateEvent` is also set, the long-press
+   * starts the create drag instead, so this fires only without it.
+   */
+  onLongPressCell?: (at: Date, resource: Resource) => void;
+  /**
+   * Long-press empty lane space, then drag along the time axis to sweep out a new
+   * event; called with the swept start/end and the lane's resource.
+   */
+  onCreateEvent?: (start: Date, end: Date, resource: Resource) => void;
+  /**
+   * Shade the hours outside this window, per lane. Same shape as the Calendar's
+   * `businessHours` plus the lane's resource, so per-resource opening hours work
+   * (return `null` for a fully closed lane). A date-only function is accepted.
+   */
+  businessHours?: (date: Date, resource: Resource) => {
+    start: number;
+    end: number;
+  } | null;
   /** Snap dragged events to this many minutes (default 15). */
   dragStepMinutes?: number;
 }
@@ -519,21 +518,6 @@ interface ResourceTimelineProps<T = unknown> {
  * />
  * ```
  */
-declare function ResourceTimeline<T = unknown>({
-  date,
-  resources,
-  events,
-  resourceId,
-  startHour,
-  endHour,
-  hourWidth,
-  rowHeight,
-  labelWidth,
-  ampm,
-  renderEvent,
-  onPressEvent,
-  onDragEvent,
-  dragStepMinutes
-}: ResourceTimelineProps<T>): ReactElement;
+declare function ResourceTimeline<T = unknown>({ date, orientation, resources, events, resourceId, startHour, endHour, hourWidth, hourHeight, rowHeight, labelWidth, ampm, renderEvent, onPressEvent, onLongPressEvent, onDragEvent, onPressCell, onLongPressCell, onCreateEvent, businessHours, dragStepMinutes }: ResourceTimelineProps<T>): ReactElement;
 //#endregion
-export { Agenda, type AgendaProps, type BusinessHours, Calendar, type CalendarEvent, type CalendarMode, type CalendarProps, type CalendarTheme, CalendarThemeProvider, DEFAULT_HOUR_HEIGHT, type DateRange, type DateSelectionConstraints, type DaySelectionState, DefaultEvent, DefaultMonthEvent, type EventAccessibilityLabelContext, type EventAccessibilityLabeler, type EventDragHandler, type EventDragStartHandler, type EventKeyExtractor, type HourRenderer, type ICalendarEvent, type MonthGrid, type MonthGridDay, type MonthGridWeek, type MonthGridWeekday, MonthList, type MonthListProps, MonthPager, type MonthPagerProps, MonthView, type MonthViewProps, type PartialCalendarTheme, type PositionedEvent, type RecurrenceFrequency, type RecurrenceRule, type RenderEvent, type RenderEventArgs, type Resource, type ResourceEventArgs, ResourceTimeline, type ResourceTimelineProps, TimeGrid, type TimeGridMode, type TimeGridProps, type UseDateRangeOptions, type UseMonthGridOptions, type WeekStartsOn, type WeekdayFormat, buildMonthGrid, buildMonthWeeks, darkTheme, daySelectionState, defaultTheme, eventsInTimeZone, expandRecurringEvents, getIsToday, getViewDays, getWeekDays, isAllDayEvent, isDateSelectable, isRangeEndpoint, isSameCalendarDay, isWeekend, isWithinDateRange, layoutDayEvents, mergeTheme, minutesIntoDay, nextDateRange, toZonedTime, useCalendarTheme, useDateRange, useMonthGrid, weekdayFormatToken };
+export { Agenda, type AgendaProps, type AgendaSlot, type BusinessHours, Calendar, type CalendarEvent, type CalendarMode, type CalendarProps, type CalendarSlot, type CalendarTheme, CalendarThemeProvider, DEFAULT_HOUR_HEIGHT, type DateRange, type DateSelectionConstraints, type DaySelectionState, DefaultEvent, DefaultMonthEvent, type EventAccessibilityLabelContext, type EventAccessibilityLabeler, type EventDragHandler, type EventDragStartHandler, type EventKeyExtractor, type HourRenderer, type ICalEvent, type ICalendarEvent, type MonthGrid, type MonthGridDay, type MonthGridWeek, type MonthGridWeekday, MonthList, type MonthListProps, type MonthListSlot, MonthPager, type MonthPagerProps, MonthView, type MonthViewProps, type MonthViewSlot, type PartialCalendarTheme, type PositionedEvent, type RecurrenceFrequency, type RecurrenceRule, type RenderEvent, type RenderEventArgs, type ResolvedSlot, type Resource, type ResourceEventArgs, ResourceTimeline, type ResourceTimelineProps, type SlotDefault, type SlotStyleProps, TimeGrid, type TimeGridMode, type TimeGridProps, type TimeGridSlot, type ToICalendarOptions, type UseDateRangeOptions, type UseMonthGridOptions, type WeekStartsOn, type WeekdayFormat, buildMonthGrid, buildMonthWeeks, darkTheme, daySelectionState, defaultTheme, eventsInTimeZone, expandRecurringEvents, getIsToday, getViewDays, getWeekDays, isAllDayEvent, isDateSelectable, isRangeEndpoint, isSameCalendarDay, isWeekend, isWithinDateRange, layoutDayEvents, mergeTheme, minutesIntoDay, nextDateRange, parseICalendar, toICalendar, toZonedTime, useCalendarTheme, useDateRange, useMonthGrid, weekdayFormatToken };