react-native-bigger-calendar 0.1.0 → 0.2.0

package/README.md

@@ -2,12 +2,57 @@
 
 A generic, themeable **month / week / day** calendar for React Native.
 
-- 📆 Three views — month grid, week and day time-grids
+- 📆 Month grid plus day / 3-day / week / custom-N time-grids
 - 🤏 Pinch-to-zoom on the week/day grid (UI thread, no re-renders)
 - ♾️ Virtualized, snap-paging months/weeks/days via [`@legendapp/list`](https://legendapp.com/open-source/list/)
 - 🧩 Bring-your-own event type (`CalendarEvent<T>`) and a `renderEvent` escape hatch
 - 🎨 Fully themeable, with sensible defaults (no styling library required)
 
+## Relationship to react-native-big-calendar
+
+This is a ground-up reimagining inspired by the excellent
+[`react-native-big-calendar`](https://github.com/acro5piano/react-native-big-calendar).
+It keeps the familiar month/week/day model but is built around Reanimated and
+modern list virtualization — trading framework-agnosticism for a richer,
+gesture-driven experience. It's **not a fork**; the API differs, and the name is
+an homage. 🙇
+
+**What it adds over react-native-big-calendar**
+
+- 🤏 **Pinch-to-zoom** time grid — row height is a Reanimated shared value, so
+  zooming runs on the UI thread with zero React re-renders.
+- ♾️ **Virtualized, snap-paged** views (via `@legendapp/list`) — swipe across
+  years of dates, with native one-page paging (or opt into `freeSwipe`).
+- 🧩 **Generic events + render-prop _component_** — `CalendarEvent<T>` carries your
+  own fields, and `renderEvent` is a component (so it may use hooks) that receives
+  the event box's live pixel height for progressive disclosure as the grid zooms.
+
+**Feature parity.** It also covers the rest of react-native-big-calendar's
+surface: month / day / 3-day / week / **custom N-day** (and `weekEndsOn`
+partial-weeks) / **agenda (`schedule`)** modes, **all-day events** (lane +
+`allDay` flag), multi-day clipping, `minHour`/`maxHour`, `ampm` (hour axis and
+event times), `showTime`, `timeslots`, `hideHours`, `showWeekNumber`,
+`weekNumberPrefix`, `hourComponent`, `sortedMonthView`, `moreLabel`,
+`showAdjacentMonths`, `showSixWeeks`, `disableMonthEventCellPress`, a default
+month weekday header (`renderHeaderForMonthView`), `activeDate`, per-event
+`disabled`, `onPress`/`onLongPress` for events, cells and date headers,
+`onChangeDateRange`, `resetPageOnPressCell`, `swipeEnabled`,
+`verticalScrollEnabled`, `showVerticalScrollIndicator`, an agenda
+`itemSeparatorComponent`, `eventCellStyle`, `calendarCellStyle`, a
+`headerComponent` slot, date-fns `locale`, right-to-left column order (`isRTL`),
+and theming. Text styling that big-calendar exposes via `calendarCellTextStyle`
+is covered by `CalendarTheme.text`; overlapping events are laid out in
+side-by-side columns automatically.
+
+**Trade-offs (where react-native-big-calendar may suit you better)**
+
+- It's **opinionated about peers**: Reanimated, Gesture Handler and
+  `@legendapp/list` are required. `react-native-big-calendar` is more
+  self-contained (no Reanimated/Gesture Handler).
+- **RTL** is cosmetic (`isRTL` reverses the day-column order, like
+  big-calendar's): the hour gutter stays on the left and paging follows the
+  system scroll direction. Enable React Native's `I18nManager` for full RTL.
+
 ## Install
 
 ```sh
@@ -110,6 +155,34 @@ function MyEvent({ event, boxHeight, onPress }: RenderEventArgs<MyEvent>) {
 See `CalendarTheme` for the full set of tokens. Anything you omit falls back to
 `defaultTheme`.
 
+### Modes
+
+`mode` is one of `month`, `week`, `day`, `3days`, `custom`, or `schedule`. For
+`custom`, set `numberOfDays` (e.g. `mode="custom" numberOfDays={5}` for a
+work-week). Day/3-day/custom views page by their column count; `week` pages by
+the calendar week. `schedule` is a vertical, day-grouped agenda list of the
+events you pass (no time grid).
+
+### Localization
+
+Pass a date-fns [`Locale`](https://date-fns.org/docs/I18n) to localize weekday and
+date labels:
+
+```tsx
+import { fr } from 'date-fns/locale';
+
+<Calendar /* ... */ locale={fr} weekStartsOn={1} />;
+```
+
+Pass `isRTL` to reverse the day-column order in every view (month grid, week/day
+grid and the all-day lane). It's cosmetic — the hour gutter stays on the left and
+paging follows the system scroll direction — so enable React Native's
+`I18nManager` alongside it for full right-to-left behaviour.
+
+```tsx
+<Calendar /* ... */ isRTL locale={ar} weekStartsOn={6} />;
+```
+
 ### Week/day grid options
 
 ```tsx
@@ -128,6 +201,12 @@ See `CalendarTheme` for the full set of tokens. Anything you omit falls back to
 - `ampm` switches hour labels to 12-hour AM/PM (default 24h).
 - `onPressCell(date)` fires when empty grid space is tapped, with the date+time
   under the touch — handy for "create event". (Event taps still go to `onPressEvent`.)
+- **Long-press** mirrors every tap: `onLongPressEvent(event)`, `onLongPressCell(date)`
+  (week/day), and `onLongPressDay(date)` (month). All optional.
+- **All-day events** render in a lane above the time grid (and as chips in month
+  cells), excluded from the timed columns. Mark an event `allDay: true`, or it's
+  inferred when it spans whole days (midnight-to-midnight). `renderEvent` receives
+  `isAllDay` so you can style the chip. The lane is hidden when there are none.
 - `freeSwipe` (default `false`) controls paging: by default one day/week/month
   moves per swipe; set it to allow a fling to carry across several pages (still
   snapping to a page boundary). Applies to all modes.
@@ -152,7 +231,8 @@ are also exported for advanced layouts:
   it spans. On the week/day grid each day shows the clipped segment (so a
   23:00→01:00 event renders 23:00–24:00, then 00:00–01:00), and `renderEvent`
   receives `continuesBefore`/`continuesAfter` so you can draw continuation hints.
-  A dedicated all-day lane (and an explicit `allDay` flag) is not yet provided.
+  All-day events (an explicit `allDay` flag or a midnight-to-midnight span) render
+  in a dedicated lane above the time grid.
 - **`weekStartsOn` defaults to `0` (Sunday).** Pass `1` for Monday-first.
 - **Controlled `date`.** The calendar is controlled: echo `onChangeDate` back
   into the `date` prop, or paging and the "today" realign won't track.

package/dist/index.d.mts

@@ -1,6 +1,7 @@
+import { Locale } from "date-fns";
 import { ComponentType } from "react";
 import { SharedValue, useSharedValue } from "react-native-reanimated";
-import { TextStyle } from "react-native";
+import { StyleProp, TextStyle, ViewStyle } from "react-native";
 
 //#region src/theme.d.ts
 /**
@@ -44,7 +45,9 @@ declare const CalendarThemeProvider: import("react").Provider<CalendarTheme>;
 declare const useCalendarTheme: () => CalendarTheme;
 //#endregion
 //#region src/types.d.ts
-type CalendarMode = 'day' | 'week' | 'month';
+type CalendarMode = 'day' | '3days' | 'week' | 'custom' | 'month' | 'schedule';
+/** The time-grid modes (day-column views, excluding month and schedule). */
+type TimeGridMode = Exclude<CalendarMode, 'month' | 'schedule'>;
 /**
  * The minimal shape every calendar event must have. Layout (positioning,
  * overlap resolution, paging) only ever reads `start`/`end`; `title` is used by
@@ -55,6 +58,14 @@ interface ICalendarEvent {
   start: Date;
   end: Date;
   title?: string;
+  /**
+   * Force this event into the all-day lane (above the time grid) instead of the
+   * timed columns. When omitted, an event is treated as all-day only if it spans
+   * whole days (both `start` and `end` land on midnight).
+   */
+  allDay?: boolean;
+  /** Ignore taps/long-presses on this event (the built-in renderer also dims it). */
+  disabled?: boolean;
 }
 /**
  * An event carrying arbitrary extra fields `T` alongside the required shape.
@@ -77,8 +88,13 @@ type RenderEventArgs<T = unknown> = {
    * renderer draw "continues" affordances. `undefined` in month mode.
    */
   continuesBefore?: boolean;
-  continuesAfter?: boolean;
-  onPress: () => void;
+  continuesAfter?: boolean; /** True when this event is rendered in the all-day lane (week/day) or is an all-day event in month view. */
+  isAllDay?: boolean; /** Format the built-in renderer's time range in 12-hour AM/PM. Default false (24h). */
+  ampm?: boolean; /** Show the time range in the built-in renderer (day/week/schedule). Default true. */
+  showTime?: boolean; /** Per-event style resolved from `eventCellStyle`; the built-in renderer merges it onto the box. */
+  cellStyle?: StyleProp<ViewStyle>;
+  onPress: () => void; /** Wired when the consumer passes `onLongPressEvent`; otherwise undefined. */
+  onLongPress?: () => void;
 };
 /**
  * A component that renders a single event. It is rendered as a real component
@@ -92,51 +108,200 @@ type EventKeyExtractor<T = unknown> = (event: CalendarEvent<T>, index: number) =
 /** Sunday = 0 … Saturday = 6, matching `Date.prototype.getDay()`. */
 type WeekStartsOn = 0 | 1 | 2 | 3 | 4 | 5 | 6;
 //#endregion
+//#region src/components/TimeGrid.d.ts
+declare const DEFAULT_HOUR_HEIGHT = 64;
+/** Replace the hour-axis label. Receives the hour (0–23) and the `ampm` flag. */
+type HourRenderer = (hour: number, ampm: boolean) => React.ReactNode;
+type TimeGridProps<T> = {
+  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
+   * `weekStartsOn`…`weekEndsOn` of `date`'s week and pages by week, taking
+   * precedence over `numberOfDays`. Ignored by other modes.
+   */
+  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. */
+  hourHeight?: number;
+  weekStartsOn: WeekStartsOn;
+  renderEvent: RenderEvent<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; /** Per-date style merged onto each day column. */
+  calendarCellStyle?: (date: Date) => StyleProp<ViewStyle>; /** 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;
+  onPressEvent: (event: CalendarEvent<T>) => void;
+  onLongPressEvent?: (event: CalendarEvent<T>) => void;
+  onPressCell?: (date: Date) => void;
+  onLongPressCell?: (date: 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. */
+  renderHeader?: (days: Date[]) => React.ReactNode;
+};
+declare function TimeGridInner<T>({
+  mode,
+  numberOfDays,
+  weekEndsOn,
+  date,
+  events,
+  cellHeight,
+  hourHeight,
+  weekStartsOn,
+  renderEvent,
+  keyExtractor,
+  scrollOffsetMinutes,
+  hourColumnWidth: hourColumnWidthProp,
+  hideHours,
+  timeslots,
+  calendarCellStyle,
+  showWeekNumber,
+  headerComponent,
+  minHour,
+  maxHour,
+  ampm,
+  isRTL,
+  minHourHeight,
+  maxHourHeight,
+  showNowIndicator,
+  locale,
+  freeSwipe,
+  swipeEnabled,
+  showVerticalScrollIndicator,
+  verticalScrollEnabled,
+  weekNumberPrefix,
+  hourComponent,
+  activeDate,
+  resetPageOnPressCell,
+  onPressEvent,
+  onLongPressEvent,
+  onPressCell,
+  onLongPressCell,
+  onPressDateHeader,
+  onChangeDate,
+  renderHeader
+}: TimeGridProps<T>): import("react").JSX.Element;
+declare const TimeGrid: typeof TimeGridInner;
+//#endregion
 //#region src/components/Calendar.d.ts
 type CalendarProps<T> = {
   events: CalendarEvent<T>[];
   mode: CalendarMode;
   date: Date;
-  onChangeDate: (date: Date) => void;
-  onPressEvent: (event: CalendarEvent<T>) => void; /** Tap a day cell (month mode) — e.g. drill into the day view. */
-  onPressDay?: (date: Date) => void; /** Tap the "+N more" overflow label in a month cell. */
+  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). */
+  onLongPressEvent?: (event: CalendarEvent<T>) => void; /** 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; /** Max events shown per month cell before they collapse into "+N more". */
-  maxVisibleEventCount?: number; /** First day of the week. Sunday = 0 (default) … Saturday = 6. */
-  weekStartsOn?: WeekStartsOn; /** Replace the built-in event box. Return a `flex: 1` element. */
-  renderEvent?: RenderEvent<T>; /** Stable key per event. Defaults to start-time + index. */
+  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; /** Tap a day's column header on the week/day grid (default header only). */
+  onPressDateHeader?: (date: Date) => void; /** Max events shown per month cell before they collapse into "+N more". */
+  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; /** 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. */
+  renderEvent?: RenderEvent<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>; /** 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 64. */
   hourHeight?: number;
   minHourHeight?: number;
   maxHourHeight?: number;
-  hourColumnWidth?: number; /** First hour shown on the week/day grid (0–23). Default 0. */
+  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 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 in 12-hour AM/PM form. Default false (24h). */
-  ampm?: boolean; /** Initial vertical scroll, in minutes from midnight (week/day). */
+  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; /** 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; /** BCP-47 locale for weekday labels. Defaults to the device locale. */
-  locale?: string;
+  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". */
+  activeDate?: Date;
+  /**
+   * Lay the day columns out right-to-left (month, week/day grid and all-day lane).
+   * Cosmetic only: the hour gutter stays on the left and paging still advances
+   * with the system scroll direction. Default false. For full RTL (including
+   * scroll direction), also enable React Native's `I18nManager`.
+   */
+  isRTL?: boolean;
   /**
    * 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;
+  renderTimeGridHeader?: (days: Date[]) => React.ReactNode; /** Replace the weekday-label header above the month grid. Return `null` to hide it. */
+  renderHeaderForMonthView?: (weekDays: Date[]) => React.ReactNode; /** Drawn between rows of the `schedule` (agenda) list. */
+  itemSeparatorComponent?: React.ComponentType<unknown> | null;
 };
 declare function Calendar<T>({
   events,
   mode,
   date,
   onChangeDate,
+  onChangeDateRange,
   onPressEvent,
+  onLongPressEvent,
   onPressDay,
+  onLongPressDay,
   onPressMore,
   onPressCell,
+  resetPageOnPressCell,
+  onLongPressCell,
+  onPressDateHeader,
   maxVisibleEventCount,
+  sortedMonthView,
+  moreLabel,
+  showAdjacentMonths,
+  disableMonthEventCellPress,
   weekStartsOn,
+  numberOfDays,
+  weekEndsOn,
   renderEvent,
+  eventCellStyle,
+  calendarCellStyle,
   keyExtractor,
   theme,
   cellHeight: cellHeightProp,
@@ -144,26 +309,81 @@ declare function Calendar<T>({
   minHourHeight,
   maxHourHeight,
   hourColumnWidth,
+  hideHours,
+  timeslots,
+  showWeekNumber,
+  weekNumberPrefix,
+  hourComponent,
+  showSixWeeks,
+  swipeEnabled,
+  showVerticalScrollIndicator,
+  verticalScrollEnabled,
+  headerComponent,
   minHour,
   maxHour,
   ampm,
+  showTime,
   scrollOffsetMinutes,
   showNowIndicator,
   locale,
+  activeDate,
+  isRTL,
   freeSwipe,
-  renderTimeGridHeader
+  renderTimeGridHeader,
+  renderHeaderForMonthView,
+  itemSeparatorComponent
 }: CalendarProps<T>): import("react").JSX.Element;
 //#endregion
+//#region src/components/Agenda.d.ts
+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>): import("react").JSX.Element;
+//#endregion
 //#region src/components/MonthView.d.ts
 type MonthViewProps<T> = {
   date: Date;
   events: CalendarEvent<T>[];
   maxVisibleEventCount: number;
   weekStartsOn: WeekStartsOn;
+  locale?: Locale; /** Sort each day's events by start time before slicing. Default true. */
+  sortedMonthView?: boolean; /** Template for the overflow label; `{moreCount}` is replaced. Default "{moreCount} More". */
+  moreLabel?: string; /** Show dimmed days from adjacent months in the grid. Default true. */
+  showAdjacentMonths?: boolean; /** Ignore taps on month-cell events (day-cell taps still fire). Default false. */
+  disableMonthEventCellPress?: boolean; /** Reverse the day order within each week (right-to-left). Default false. */
+  isRTL?: boolean; /** Always render six week rows, for a fixed-height grid. Default false. */
+  showSixWeeks?: boolean; /** Highlight this date instead of the real "today". */
+  activeDate?: Date; /** Per-date style merged onto the day cell. */
+  calendarCellStyle?: (date: Date) => StyleProp<ViewStyle>;
   renderEvent: RenderEvent<T>;
   keyExtractor: EventKeyExtractor<T>;
   onPressDay?: (date: Date) => void;
+  onLongPressDay?: (date: Date) => void;
   onPressEvent: (event: CalendarEvent<T>) => void;
+  onLongPressEvent?: (event: CalendarEvent<T>) => void;
   onPressMore?: (events: CalendarEvent<T>[], date: Date) => void;
 };
 declare function MonthViewInner<T>({
@@ -171,10 +391,21 @@ declare function MonthViewInner<T>({
   events,
   maxVisibleEventCount,
   weekStartsOn,
+  locale,
+  sortedMonthView,
+  moreLabel,
+  showAdjacentMonths,
+  disableMonthEventCellPress,
+  isRTL,
+  showSixWeeks,
+  activeDate,
+  calendarCellStyle,
   renderEvent,
   keyExtractor,
   onPressDay,
+  onLongPressDay,
   onPressEvent,
+  onLongPressEvent,
   onPressMore
 }: MonthViewProps<T>): import("react").JSX.Element;
 declare const MonthView: typeof MonthViewInner;
@@ -185,81 +416,55 @@ type MonthPagerProps<T> = {
   events: CalendarEvent<T>[];
   maxVisibleEventCount: number;
   weekStartsOn: WeekStartsOn;
+  locale?: Locale;
+  sortedMonthView?: boolean;
+  moreLabel?: string;
+  showAdjacentMonths?: boolean;
+  disableMonthEventCellPress?: boolean;
+  isRTL?: boolean;
+  calendarCellStyle?: (date: Date) => StyleProp<ViewStyle>;
   renderEvent: RenderEvent<T>;
   keyExtractor: EventKeyExtractor<T>;
   onPressDay?: (date: Date) => void;
+  onLongPressDay?: (date: Date) => void;
   onPressEvent: (event: CalendarEvent<T>) => void;
+  onLongPressEvent?: (event: CalendarEvent<T>) => void;
   onPressMore?: (events: CalendarEvent<T>[], date: Date) => void;
   onChangeDate: (date: Date) => void;
   freeSwipe?: boolean;
+  swipeEnabled?: boolean;
+  showSixWeeks?: boolean;
+  activeDate?: Date; /** Replace the weekday-label header above the month grid. Receives the week's days. */
+  renderHeaderForMonthView?: (weekDays: Date[]) => React.ReactNode;
 };
 declare function MonthPagerInner<T>({
   date,
   events,
   maxVisibleEventCount,
   weekStartsOn,
+  locale,
+  sortedMonthView,
+  moreLabel,
+  showAdjacentMonths,
+  disableMonthEventCellPress,
+  isRTL,
+  calendarCellStyle,
   renderEvent,
   keyExtractor,
   onPressDay,
+  onLongPressDay,
   onPressEvent,
+  onLongPressEvent,
   onPressMore,
   onChangeDate,
-  freeSwipe
+  freeSwipe,
+  swipeEnabled,
+  showSixWeeks,
+  activeDate,
+  renderHeaderForMonthView
 }: MonthPagerProps<T>): import("react").JSX.Element;
 declare const MonthPager: typeof MonthPagerInner;
 //#endregion
-//#region src/components/TimeGrid.d.ts
-declare const DEFAULT_HOUR_HEIGHT = 64;
-type TimeGridProps<T> = {
-  mode: 'day' | 'week';
-  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. */
-  hourHeight?: number;
-  weekStartsOn: WeekStartsOn;
-  renderEvent: RenderEvent<T>;
-  keyExtractor: EventKeyExtractor<T>;
-  scrollOffsetMinutes?: number;
-  hourColumnWidth?: number; /** 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;
-  minHourHeight?: number;
-  maxHourHeight?: number;
-  showNowIndicator?: boolean;
-  locale?: string;
-  freeSwipe?: boolean;
-  onPressEvent: (event: CalendarEvent<T>) => void;
-  onPressCell?: (date: Date) => void;
-  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,
-  date,
-  events,
-  cellHeight,
-  hourHeight,
-  weekStartsOn,
-  renderEvent,
-  keyExtractor,
-  scrollOffsetMinutes,
-  hourColumnWidth,
-  minHour,
-  maxHour,
-  ampm,
-  minHourHeight,
-  maxHourHeight,
-  showNowIndicator,
-  locale,
-  freeSwipe,
-  onPressEvent,
-  onPressCell,
-  onChangeDate,
-  renderHeader
-}: TimeGridProps<T>): import("react").JSX.Element;
-declare const TimeGrid: typeof TimeGridInner;
-//#endregion
 //#region src/components/DefaultEvent.d.ts
 /**
  * The built-in event renderer: a filled, rounded box showing the event title
@@ -269,7 +474,12 @@ declare const TimeGrid: typeof TimeGridInner;
 declare function DefaultEvent<T>({
   event,
   mode,
-  onPress
+  isAllDay,
+  ampm,
+  showTime,
+  cellStyle,
+  onPress,
+  onLongPress
 }: RenderEventArgs<T>): import("react").JSX.Element;
 //#endregion
 //#region src/utils/dates.d.ts
@@ -298,5 +508,11 @@ type PositionedEvent<T> = {
  * 00:00–01:00 on the next). Pure — safe to call per render, never per frame.
  */
 declare function layoutDayEvents<T>(events: CalendarEvent<T>[], day: Date): PositionedEvent<T>[];
+/**
+ * Whether an event belongs in the all-day lane. An explicit `allDay` flag wins;
+ * otherwise it's inferred when the event spans whole days (both `start` and
+ * `end` land on midnight, e.g. an iCal-style all-day event). Pure.
+ */
+declare function isAllDayEvent<T>(event: CalendarEvent<T>): boolean;
 //#endregion
-export { Calendar, type CalendarEvent, type CalendarMode, type CalendarProps, type CalendarTheme, CalendarThemeProvider, DEFAULT_HOUR_HEIGHT, DefaultEvent, type EventKeyExtractor, type ICalendarEvent, MonthPager, type MonthPagerProps, MonthView, type MonthViewProps, type PartialCalendarTheme, type PositionedEvent, type RenderEvent, type RenderEventArgs, TimeGrid, type TimeGridProps, type WeekStartsOn, defaultTheme, getIsToday, getWeekDays, isSameCalendarDay, isWeekend, layoutDayEvents, mergeTheme, minutesIntoDay, useCalendarTheme };
+export { Agenda, type AgendaProps, Calendar, type CalendarEvent, type CalendarMode, type CalendarProps, type CalendarTheme, CalendarThemeProvider, DEFAULT_HOUR_HEIGHT, DefaultEvent, type EventKeyExtractor, type HourRenderer, type ICalendarEvent, MonthPager, type MonthPagerProps, MonthView, type MonthViewProps, type PartialCalendarTheme, type PositionedEvent, type RenderEvent, type RenderEventArgs, TimeGrid, type TimeGridMode, type TimeGridProps, type WeekStartsOn, defaultTheme, getIsToday, getWeekDays, isAllDayEvent, isSameCalendarDay, isWeekend, layoutDayEvents, mergeTheme, minutesIntoDay, useCalendarTheme };