@super-calendar/native 2.1.5 → 2.3.0

package/dist/{DefaultMonthEvent-C-BiOsXb.d.mts → DefaultMonthEvent-BW6qy50X.d.ts}

@@ -1,8 +1,8 @@
 import { Locale } from "date-fns";
 import { ComponentType, ReactElement } from "react";
-import { SharedValue } from "react-native-reanimated";
-import { BusinessHours, CalendarColors, CalendarEvent, CalendarEvent as CalendarEvent$1, CalendarMode, CalendarMode as CalendarMode$1, DateRange, EventKeyExtractor, ICalendarEvent, RecurrenceFrequency, RecurrenceRule, TimeGridMode, WeekStartsOn } from "@super-calendar/core";
 import { StyleProp, TextStyle, ViewStyle } from "react-native";
+import { SharedValue } from "react-native-reanimated";
+import { BusinessHours, CalendarColors, CalendarEvent, CalendarEvent as CalendarEvent$1, CalendarMode, CalendarMode as CalendarMode$1, DateRange, EventAccessibilityLabelContext, EventAccessibilityLabeler, EventAccessibilityLabeler as EventAccessibilityLabeler$1, EventKeyExtractor, ICalendarEvent, RecurrenceFrequency, RecurrenceRule, TimeGridMode, WeekStartsOn, WeekdayFormat, WeekdayFormat as WeekdayFormat$1 } from "@super-calendar/core";
 
 //#region src/theme.d.ts
 /**
@@ -15,13 +15,39 @@ interface CalendarTheme {
   colors: CalendarColors;
   /** Text styles for the calendar's labels and the built-in event box. */
   text: {
-    /** Large day number in the week/day header. */dayNumber: TextStyle; /** Short weekday label ("Mon") in headers. */
-    weekday: TextStyle; /** Date number inside a month cell. */
+    /** The day number in a time-grid (week/day) column header. */dayNumber: TextStyle; /** The weekday label ("Mon") in a time-grid column header. */
+    columnHeaderWeekday: TextStyle; /** Short weekday label ("Mon") in the month grid's header row. */
+    weekday: TextStyle; /** The "MMMM yyyy" month title above the month grid. */
+    monthTitle: TextStyle; /** Date number inside a month cell. */
     dateCell: TextStyle; /** Hour labels down the left of the time grid. */
     hourLabel: TextStyle; /** The "+N more" overflow label in month cells. */
     more: TextStyle; /** Title inside the built-in default event box. */
     eventTitle: TextStyle;
   };
+  /**
+   * Per-part `ViewStyle` overrides for the renderer's container elements, the
+   * React Native counterpart of the web renderer's per-slot classes. Each is
+   * merged onto the built-in style, so you override only what you set. (Rolling
+   * out across the views; more slots as they land.)
+   */
+  containers: {
+    /** The month view's outer container (title + weekday header + grid). */monthContainer: ViewStyle; /** The weekday-label header row above a month grid. */
+    weekdayHeader: ViewStyle; /** Each week (row of 7 day cells) in the month grid. */
+    weekRow: ViewStyle; /** Each day cell in the month grid. */
+    dayCell: ViewStyle; /** The date badge (the circle) inside a month day cell. */
+    dayBadge: ViewStyle; /** An event chip inside a month day cell. */
+    monthEvent: ViewStyle; /** Each day's column header in the time grid. */
+    columnHeader: ViewStyle; /** The day-number badge (the circle) inside a time-grid column header. */
+    columnHeaderBadge: ViewStyle; /** A timed event's positioned box in the time grid (and resource timeline). */
+    timeGridEvent: ViewStyle; /** The current-time indicator line. */
+    nowIndicator: ViewStyle; /** Each resource row in the resource timeline. */
+    resourceRow: ViewStyle; /** The left-hand resource-label cell in the resource timeline. */
+    resourceLabel: ViewStyle; /** The schedule/agenda list's outer container. */
+    agendaList: ViewStyle; /** Each event row in the agenda list. */
+    agendaRow: ViewStyle; /** The all-day lane above the time grid. */
+    allDayLane: ViewStyle; /** Each day's column within the all-day lane. */
+    allDayColumn: ViewStyle;
+  };
   /** Corner radius of the today badge. Use a large value for a circle. */
   todayBadgeRadius: number;
   /**
@@ -48,6 +74,7 @@ declare function mergeTheme(theme?: PartialCalendarTheme): CalendarTheme;
 type PartialCalendarTheme = {
   colors?: Partial<CalendarTheme["colors"]>;
   text?: Partial<CalendarTheme["text"]>;
+  containers?: Partial<CalendarTheme["containers"]>;
   todayBadgeRadius?: number;
   rangeBandHeight?: number;
 };
@@ -88,6 +115,12 @@ type RenderEventArgs<T = unknown> = {
   ellipsizeTitle?: boolean; /** Label shown for an all-day event in the schedule (and its screen-reader text). Default "All day". */
   allDayLabel?: string; /** Per-event style resolved from `eventCellStyle`; the built-in renderer merges it onto the box. */
   cellStyle?: StyleProp<ViewStyle>;
+  /**
+   * Screen-reader label to announce for the event, injected by a consumer's
+   * `eventAccessibilityLabel` override. The built-in renderers use it in place of
+   * their default label; `undefined` falls back to that default.
+   */
+  accessibilityLabel?: string;
   onPress: () => void; /** Wired when the consumer passes `onLongPressEvent`; otherwise undefined. */
   onLongPress?: () => void;
 };
@@ -111,7 +144,8 @@ type MonthViewProps<T> = {
    * explicit value when using a custom `renderEvent`.
    */
   maxVisibleEventCount?: number;
-  weekStartsOn: WeekStartsOn;
+  weekStartsOn: WeekStartsOn; /** Weekday header label width: `narrow` ("M"), `short` ("Mon", default), or `long` ("Monday"). */
+  weekdayFormat?: WeekdayFormat;
   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. */
@@ -136,6 +170,12 @@ type MonthViewProps<T> = {
   onDayPointerEnter?: (date: Date) => void; /** Per-date style merged onto the day cell. */
   calendarCellStyle?: (date: Date) => StyleProp<ViewStyle>;
   renderEvent: RenderEvent<T>;
+  /**
+   * Override the screen-reader label for each event chip. Receives the event and a
+   * `{ mode: "month", isAllDay, ampm: false }` context; return the full text to
+   * announce. Defaults to the built-in title-and-time label.
+   */
+  eventAccessibilityLabel?: EventAccessibilityLabeler<T>;
   keyExtractor: EventKeyExtractor<T>;
   onPressDay?: (date: Date) => void;
   onLongPressDay?: (date: Date) => void;
@@ -153,6 +193,7 @@ declare function MonthViewInner<T>({
   events,
   maxVisibleEventCount,
   weekStartsOn,
+  weekdayFormat,
   locale,
   sortedMonthView,
   moreLabel,
@@ -171,6 +212,7 @@ declare function MonthViewInner<T>({
   isDateDisabled: isDateDisabledProp,
   calendarCellStyle,
   renderEvent,
+  eventAccessibilityLabel,
   keyExtractor,
   onPressDay,
   onLongPressDay,
@@ -206,6 +248,7 @@ type MonthPagerProps<T> = {
   events: CalendarEvent$1<T>[];
   maxVisibleEventCount?: number;
   weekStartsOn: WeekStartsOn;
+  weekdayFormat?: WeekdayFormat;
   locale?: Locale;
   sortedMonthView?: boolean;
   moreLabel?: string;
@@ -233,6 +276,7 @@ declare function MonthPagerInner<T>({
   events,
   maxVisibleEventCount,
   weekStartsOn,
+  weekdayFormat,
   locale,
   sortedMonthView,
   moreLabel,
@@ -280,7 +324,8 @@ declare const MonthPager: typeof MonthPagerInner;
 type MonthListProps<T> = {
   /** The month scrolled to on mount. */date: Date; /** Events to render in the grids. Omit for an events-free date picker. */
   events?: CalendarEvent$1<T>[];
-  weekStartsOn: WeekStartsOn;
+  weekStartsOn: WeekStartsOn; /** Weekday header label width: `narrow` ("M"), `short` ("Mon", default), or `long` ("Monday"). */
+  weekdayFormat?: WeekdayFormat;
   /**
    * Height of each week row (px). The month block sizes to its row count. Defaults
    * to a taller row when `events` are shown (so a day fits ~3 chips) and a compact
@@ -307,7 +352,13 @@ type MonthListProps<T> = {
   maxDate?: Date;
   isDateDisabled?: (date: Date) => boolean;
   calendarCellStyle?: (date: Date) => StyleProp<ViewStyle>; /** Replace the built-in event box. Defaults to `DefaultEvent`. */
-  renderEvent?: RenderEvent<T>; /** Stable key per event. Defaults to start-time + index. */
+  renderEvent?: RenderEvent<T>;
+  /**
+   * Override the screen-reader label for each event chip. Receives the event and a
+   * `{ mode: "month", isAllDay, ampm: false }` context; return the full text to
+   * announce. Defaults to the built-in title-and-time label.
+   */
+  eventAccessibilityLabel?: EventAccessibilityLabeler<T>; /** Stable key per event. Defaults to start-time + index. */
   keyExtractor?: EventKeyExtractor<T>;
   onPressDay?: (date: Date) => void;
   onLongPressDay?: (date: Date) => void;
@@ -327,6 +378,7 @@ declare function MonthListInner<T>({
   date,
   events,
   weekStartsOn,
+  weekdayFormat,
   weekRowHeight: weekRowHeightProp,
   monthHeaderHeight,
   maxVisibleEventCount,
@@ -345,6 +397,7 @@ declare function MonthListInner<T>({
   isDateDisabled,
   calendarCellStyle,
   renderEvent,
+  eventAccessibilityLabel,
   keyExtractor,
   onPressDay,
   onLongPressDay,
@@ -391,9 +444,10 @@ declare function DefaultMonthEvent<T>({
   showTime,
   ellipsizeTitle,
   allDayLabel,
+  accessibilityLabel: accessibilityLabelProp,
   cellStyle,
   onPress,
   onLongPress
 }: RenderEventArgs<T>): ReactElement;
 //#endregion
-export { defaultTheme as C, darkTheme as S, useCalendarTheme as T, TimeGridMode as _, MonthPagerProps as a, CalendarThemeProvider as b, BusinessHours as c, EventKeyExtractor as d, ICalendarEvent as f, RenderEventArgs as g, RenderEvent as h, MonthPager as i, CalendarEvent$1 as l, RecurrenceRule as m, MonthList as n, MonthView as o, RecurrenceFrequency as p, MonthListProps as r, MonthViewProps as s, DefaultMonthEvent as t, CalendarMode$1 as u, WeekStartsOn as v, mergeTheme as w, PartialCalendarTheme as x, CalendarTheme as y };
+export { CalendarThemeProvider as C, mergeTheme as D, defaultTheme as E, useCalendarTheme as O, CalendarTheme as S, darkTheme as T, RenderEvent as _, MonthPagerProps as a, WeekStartsOn as b, BusinessHours as c, EventAccessibilityLabelContext as d, EventAccessibilityLabeler$1 as f, RecurrenceRule as g, RecurrenceFrequency as h, MonthPager as i, CalendarEvent$1 as l, ICalendarEvent as m, MonthList as n, MonthView as o, EventKeyExtractor as p, MonthListProps as r, MonthViewProps as s, DefaultMonthEvent as t, CalendarMode$1 as u, RenderEventArgs as v, PartialCalendarTheme as w, WeekdayFormat$1 as x, TimeGridMode as y };

package/dist/{DefaultMonthEvent-CcZLyfps.d.ts → DefaultMonthEvent-BbCMc60z.d.mts}

@@ -1,8 +1,8 @@
 import { Locale } from "date-fns";
 import { ComponentType, ReactElement } from "react";
-import { StyleProp, TextStyle, ViewStyle } from "react-native";
 import { SharedValue } from "react-native-reanimated";
-import { BusinessHours, CalendarColors, CalendarEvent, CalendarEvent as CalendarEvent$1, CalendarMode, CalendarMode as CalendarMode$1, DateRange, EventKeyExtractor, ICalendarEvent, RecurrenceFrequency, RecurrenceRule, TimeGridMode, WeekStartsOn } from "@super-calendar/core";
+import { BusinessHours, CalendarColors, CalendarEvent, CalendarEvent as CalendarEvent$1, CalendarMode, CalendarMode as CalendarMode$1, DateRange, EventAccessibilityLabelContext, EventAccessibilityLabeler, EventAccessibilityLabeler as EventAccessibilityLabeler$1, EventKeyExtractor, ICalendarEvent, RecurrenceFrequency, RecurrenceRule, TimeGridMode, WeekStartsOn, WeekdayFormat, WeekdayFormat as WeekdayFormat$1 } from "@super-calendar/core";
+import { StyleProp, TextStyle, ViewStyle } from "react-native";
 
 //#region src/theme.d.ts
 /**
@@ -15,13 +15,39 @@ interface CalendarTheme {
   colors: CalendarColors;
   /** Text styles for the calendar's labels and the built-in event box. */
   text: {
-    /** Large day number in the week/day header. */dayNumber: TextStyle; /** Short weekday label ("Mon") in headers. */
-    weekday: TextStyle; /** Date number inside a month cell. */
+    /** The day number in a time-grid (week/day) column header. */dayNumber: TextStyle; /** The weekday label ("Mon") in a time-grid column header. */
+    columnHeaderWeekday: TextStyle; /** Short weekday label ("Mon") in the month grid's header row. */
+    weekday: TextStyle; /** The "MMMM yyyy" month title above the month grid. */
+    monthTitle: TextStyle; /** Date number inside a month cell. */
     dateCell: TextStyle; /** Hour labels down the left of the time grid. */
     hourLabel: TextStyle; /** The "+N more" overflow label in month cells. */
     more: TextStyle; /** Title inside the built-in default event box. */
     eventTitle: TextStyle;
   };
+  /**
+   * Per-part `ViewStyle` overrides for the renderer's container elements, the
+   * React Native counterpart of the web renderer's per-slot classes. Each is
+   * merged onto the built-in style, so you override only what you set. (Rolling
+   * out across the views; more slots as they land.)
+   */
+  containers: {
+    /** The month view's outer container (title + weekday header + grid). */monthContainer: ViewStyle; /** The weekday-label header row above a month grid. */
+    weekdayHeader: ViewStyle; /** Each week (row of 7 day cells) in the month grid. */
+    weekRow: ViewStyle; /** Each day cell in the month grid. */
+    dayCell: ViewStyle; /** The date badge (the circle) inside a month day cell. */
+    dayBadge: ViewStyle; /** An event chip inside a month day cell. */
+    monthEvent: ViewStyle; /** Each day's column header in the time grid. */
+    columnHeader: ViewStyle; /** The day-number badge (the circle) inside a time-grid column header. */
+    columnHeaderBadge: ViewStyle; /** A timed event's positioned box in the time grid (and resource timeline). */
+    timeGridEvent: ViewStyle; /** The current-time indicator line. */
+    nowIndicator: ViewStyle; /** Each resource row in the resource timeline. */
+    resourceRow: ViewStyle; /** The left-hand resource-label cell in the resource timeline. */
+    resourceLabel: ViewStyle; /** The schedule/agenda list's outer container. */
+    agendaList: ViewStyle; /** Each event row in the agenda list. */
+    agendaRow: ViewStyle; /** The all-day lane above the time grid. */
+    allDayLane: ViewStyle; /** Each day's column within the all-day lane. */
+    allDayColumn: ViewStyle;
+  };
   /** Corner radius of the today badge. Use a large value for a circle. */
   todayBadgeRadius: number;
   /**
@@ -48,6 +74,7 @@ declare function mergeTheme(theme?: PartialCalendarTheme): CalendarTheme;
 type PartialCalendarTheme = {
   colors?: Partial<CalendarTheme["colors"]>;
   text?: Partial<CalendarTheme["text"]>;
+  containers?: Partial<CalendarTheme["containers"]>;
   todayBadgeRadius?: number;
   rangeBandHeight?: number;
 };
@@ -88,6 +115,12 @@ type RenderEventArgs<T = unknown> = {
   ellipsizeTitle?: boolean; /** Label shown for an all-day event in the schedule (and its screen-reader text). Default "All day". */
   allDayLabel?: string; /** Per-event style resolved from `eventCellStyle`; the built-in renderer merges it onto the box. */
   cellStyle?: StyleProp<ViewStyle>;
+  /**
+   * Screen-reader label to announce for the event, injected by a consumer's
+   * `eventAccessibilityLabel` override. The built-in renderers use it in place of
+   * their default label; `undefined` falls back to that default.
+   */
+  accessibilityLabel?: string;
   onPress: () => void; /** Wired when the consumer passes `onLongPressEvent`; otherwise undefined. */
   onLongPress?: () => void;
 };
@@ -111,7 +144,8 @@ type MonthViewProps<T> = {
    * explicit value when using a custom `renderEvent`.
    */
   maxVisibleEventCount?: number;
-  weekStartsOn: WeekStartsOn;
+  weekStartsOn: WeekStartsOn; /** Weekday header label width: `narrow` ("M"), `short` ("Mon", default), or `long` ("Monday"). */
+  weekdayFormat?: WeekdayFormat;
   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. */
@@ -136,6 +170,12 @@ type MonthViewProps<T> = {
   onDayPointerEnter?: (date: Date) => void; /** Per-date style merged onto the day cell. */
   calendarCellStyle?: (date: Date) => StyleProp<ViewStyle>;
   renderEvent: RenderEvent<T>;
+  /**
+   * Override the screen-reader label for each event chip. Receives the event and a
+   * `{ mode: "month", isAllDay, ampm: false }` context; return the full text to
+   * announce. Defaults to the built-in title-and-time label.
+   */
+  eventAccessibilityLabel?: EventAccessibilityLabeler<T>;
   keyExtractor: EventKeyExtractor<T>;
   onPressDay?: (date: Date) => void;
   onLongPressDay?: (date: Date) => void;
@@ -153,6 +193,7 @@ declare function MonthViewInner<T>({
   events,
   maxVisibleEventCount,
   weekStartsOn,
+  weekdayFormat,
   locale,
   sortedMonthView,
   moreLabel,
@@ -171,6 +212,7 @@ declare function MonthViewInner<T>({
   isDateDisabled: isDateDisabledProp,
   calendarCellStyle,
   renderEvent,
+  eventAccessibilityLabel,
   keyExtractor,
   onPressDay,
   onLongPressDay,
@@ -206,6 +248,7 @@ type MonthPagerProps<T> = {
   events: CalendarEvent$1<T>[];
   maxVisibleEventCount?: number;
   weekStartsOn: WeekStartsOn;
+  weekdayFormat?: WeekdayFormat;
   locale?: Locale;
   sortedMonthView?: boolean;
   moreLabel?: string;
@@ -233,6 +276,7 @@ declare function MonthPagerInner<T>({
   events,
   maxVisibleEventCount,
   weekStartsOn,
+  weekdayFormat,
   locale,
   sortedMonthView,
   moreLabel,
@@ -280,7 +324,8 @@ declare const MonthPager: typeof MonthPagerInner;
 type MonthListProps<T> = {
   /** The month scrolled to on mount. */date: Date; /** Events to render in the grids. Omit for an events-free date picker. */
   events?: CalendarEvent$1<T>[];
-  weekStartsOn: WeekStartsOn;
+  weekStartsOn: WeekStartsOn; /** Weekday header label width: `narrow` ("M"), `short` ("Mon", default), or `long` ("Monday"). */
+  weekdayFormat?: WeekdayFormat;
   /**
    * Height of each week row (px). The month block sizes to its row count. Defaults
    * to a taller row when `events` are shown (so a day fits ~3 chips) and a compact
@@ -307,7 +352,13 @@ type MonthListProps<T> = {
   maxDate?: Date;
   isDateDisabled?: (date: Date) => boolean;
   calendarCellStyle?: (date: Date) => StyleProp<ViewStyle>; /** Replace the built-in event box. Defaults to `DefaultEvent`. */
-  renderEvent?: RenderEvent<T>; /** Stable key per event. Defaults to start-time + index. */
+  renderEvent?: RenderEvent<T>;
+  /**
+   * Override the screen-reader label for each event chip. Receives the event and a
+   * `{ mode: "month", isAllDay, ampm: false }` context; return the full text to
+   * announce. Defaults to the built-in title-and-time label.
+   */
+  eventAccessibilityLabel?: EventAccessibilityLabeler<T>; /** Stable key per event. Defaults to start-time + index. */
   keyExtractor?: EventKeyExtractor<T>;
   onPressDay?: (date: Date) => void;
   onLongPressDay?: (date: Date) => void;
@@ -327,6 +378,7 @@ declare function MonthListInner<T>({
   date,
   events,
   weekStartsOn,
+  weekdayFormat,
   weekRowHeight: weekRowHeightProp,
   monthHeaderHeight,
   maxVisibleEventCount,
@@ -345,6 +397,7 @@ declare function MonthListInner<T>({
   isDateDisabled,
   calendarCellStyle,
   renderEvent,
+  eventAccessibilityLabel,
   keyExtractor,
   onPressDay,
   onLongPressDay,
@@ -391,9 +444,10 @@ declare function DefaultMonthEvent<T>({
   showTime,
   ellipsizeTitle,
   allDayLabel,
+  accessibilityLabel: accessibilityLabelProp,
   cellStyle,
   onPress,
   onLongPress
 }: RenderEventArgs<T>): ReactElement;
 //#endregion
-export { defaultTheme as C, darkTheme as S, useCalendarTheme as T, TimeGridMode as _, MonthPagerProps as a, CalendarThemeProvider as b, BusinessHours as c, EventKeyExtractor as d, ICalendarEvent as f, RenderEventArgs as g, RenderEvent as h, MonthPager as i, CalendarEvent$1 as l, RecurrenceRule as m, MonthList as n, MonthView as o, RecurrenceFrequency as p, MonthListProps as r, MonthViewProps as s, DefaultMonthEvent as t, CalendarMode$1 as u, WeekStartsOn as v, mergeTheme as w, PartialCalendarTheme as x, CalendarTheme as y };
+export { CalendarThemeProvider as C, mergeTheme as D, defaultTheme as E, useCalendarTheme as O, CalendarTheme as S, darkTheme as T, RenderEvent as _, MonthPagerProps as a, WeekStartsOn as b, BusinessHours as c, EventAccessibilityLabelContext as d, EventAccessibilityLabeler$1 as f, RecurrenceRule as g, RecurrenceFrequency as h, MonthPager as i, CalendarEvent$1 as l, ICalendarEvent as m, MonthList as n, MonthView as o, EventKeyExtractor as p, MonthListProps as r, MonthViewProps as s, DefaultMonthEvent as t, CalendarMode$1 as u, RenderEventArgs as v, PartialCalendarTheme as w, WeekdayFormat$1 as x, TimeGridMode as y };