@super-calendar/dom 2.11.0 → 2.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { Locale } from "date-fns";
2
2
  import { CSSProperties, ComponentType, ReactElement, ReactNode } from "react";
3
- import { BusinessHours, BusinessHours as BusinessHours$1, BusinessHoursBand, BusinessHoursBand as BusinessHoursBand$1, BusinessHoursValue, CalendarColors, CalendarEvent, CalendarEvent as CalendarEvent$1, CalendarMode, CalendarMode as CalendarMode$1, DateRange, DateRange as DateRange$1, DateSelectionConstraints, DateSelectionConstraints as DateSelectionConstraints$1, DaySelectionState, EventAccessibilityLabelContext, EventAccessibilityLabeler, EventAccessibilityLabeler as EventAccessibilityLabeler$1, ICalEvent, ICalendarEvent, MonthEventSegment, MonthGrid, MonthGridDay, MonthGridWeek, MonthGridWeekday, MonthWeekEvents, PositionedEvent, RecurrenceFrequency, RecurrenceRule, TimeGridMode, TimeGridMode as TimeGridMode$1, ToICalendarOptions, UseDateRangeOptions, UseMonthGridOptions, WeekStartsOn, WeekStartsOn as WeekStartsOn$1, WeekdayFormat, WeekdayFormat as WeekdayFormat$1, backgroundBandsForDay, buildMonthGrid, daySelectionState, expandRecurringEvents, getViewDays, isAllDayEvent, isBackgroundEvent, isDateSelectable, isRangeEndpoint, isWithinDateRange, layoutDayEvents, layoutMonthWeek, nextDateRange, parseICalendar, toICalendar, useDateRange, useEventSource, useMonthGrid, useNow, weekdayFormatToken } from "@super-calendar/core";
3
+ import { BusinessHours, BusinessHours as BusinessHours$1, BusinessHoursBand, BusinessHoursBand as BusinessHoursBand$1, BusinessHoursValue, CalendarColors, CalendarEvent, CalendarEvent as CalendarEvent$1, CalendarLabels, CalendarLabels as CalendarLabels$1, CalendarMode, CalendarMode as CalendarMode$1, DateRange, DateRange as DateRange$1, DateSelectionConstraints, DateSelectionConstraints as DateSelectionConstraints$1, DaySelectionState, EventAccessibilityLabelContext, EventAccessibilityLabeler, EventAccessibilityLabeler as EventAccessibilityLabeler$1, ICalEvent, ICalendarEvent, MonthEventSegment, MonthGrid, MonthGridDay, MonthGridWeek, MonthGridWeekday, MonthWeekEvents, PositionedEvent, RecurrenceFrequency, RecurrenceRule, TimeGridMode, TimeGridMode as TimeGridMode$1, ToICalendarOptions, UseDateRangeOptions, UseMonthGridOptions, WeekStartsOn, WeekStartsOn as WeekStartsOn$1, WeekdayFormat, WeekdayFormat as WeekdayFormat$1, backgroundBandsForDay, buildMonthGrid, daySelectionState, defaultCalendarLabels, expandRecurringEvents, getViewDays, isAllDayEvent, isBackgroundEvent, isDateSelectable, isRangeEndpoint, isWithinDateRange, layoutDayEvents, layoutMonthWeek, nextDateRange, parseICalendar, toICalendar, useDateRange, useEventSource, useMonthGrid, useNow, weekdayFormatToken } from "@super-calendar/core";
4
4
  //#region src/slots.d.ts
5
5
  /**
6
6
  * Per-slot styling overrides. Give a slot a Tailwind/CSS class and/or an inline
@@ -50,11 +50,11 @@ type DomCalendarTheme = CalendarColors & {
50
50
  fontFamily: string;
51
51
  };
52
52
  /** The default light theme: the core light palette plus the DOM metrics. */
53
- declare const defaultDomTheme: DomCalendarTheme;
53
+ export declare const defaultDomTheme: DomCalendarTheme;
54
54
  /** The dark theme: the core dark palette plus the DOM metrics. */
55
- declare const darkDomTheme: DomCalendarTheme;
55
+ export declare const darkDomTheme: DomCalendarTheme;
56
56
  /** Merge a partial override onto a base theme (defaults to {@link defaultDomTheme}). */
57
- declare function mergeDomTheme(overrides?: Partial<DomCalendarTheme>, base?: DomCalendarTheme): DomCalendarTheme;
57
+ export declare function mergeDomTheme(overrides?: Partial<DomCalendarTheme>, base?: DomCalendarTheme): DomCalendarTheme;
58
58
  //#endregion
59
59
  //#region src/Agenda.d.ts
60
60
  /**
@@ -119,7 +119,7 @@ interface AgendaProps<T = unknown> extends SlotStyleProps<AgendaSlot> {
119
119
  * <Agenda events={events} onPressEvent={(e) => console.log(e.title)} />
120
120
  * ```
121
121
  */
122
- declare function Agenda<T = unknown>({ events, locale, ampm, activeDate, theme: themeOverrides, height, renderEvent, eventAccessibilityLabel, onPressEvent, onPressDay, className, style, classNames, styles }: AgendaProps<T>): ReactElement;
122
+ export declare function Agenda<T = unknown>({ events, locale, ampm, activeDate, theme: themeOverrides, height, renderEvent, eventAccessibilityLabel, onPressEvent, onPressDay, className, style, classNames, styles }: AgendaProps<T>): ReactElement;
123
123
  //#endregion
124
124
  //#region src/YearView.d.ts
125
125
  /**
@@ -140,6 +140,8 @@ interface YearViewProps<T = unknown> extends DateSelectionConstraints$1, SlotSty
140
140
  /** Weekdays (0=Sunday…6=Saturday) hidden from the grid, e.g. `[0, 6]` for weekends off. */
141
141
  hiddenDays?: number[];
142
142
  locale?: Locale;
143
+ /** Translations for the screen-reader words; omitted keys use English. */
144
+ labels?: Partial<CalendarLabels$1>;
143
145
  /** Highlight this date instead of the real "today". */
144
146
  activeDate?: Date;
145
147
  /** A selected span: endpoints get a filled badge, the days between get the range band. */
@@ -183,7 +185,7 @@ interface YearViewProps<T = unknown> extends DateSelectionConstraints$1, SlotSty
183
185
  * highlighted and a dot under days that hold events. It's the view `Calendar`
184
186
  * renders for `mode="year"`.
185
187
  */
186
- declare function YearView<T = unknown>({ date, events, weekStartsOn, hiddenDays, locale, activeDate, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, minMonthWidth, onPressDay, onPressMonth, onSelectDrag, onCreateEvent, theme: themeOverrides, className, style, classNames, styles }: YearViewProps<T>): ReactElement;
188
+ export declare function YearView<T = unknown>({ date, events, weekStartsOn, hiddenDays, locale, labels: labelsProp, activeDate, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, minMonthWidth, onPressDay, onPressMonth, onSelectDrag, onCreateEvent, theme: themeOverrides, className, style, classNames, styles }: YearViewProps<T>): ReactElement;
187
189
  //#endregion
188
190
  //#region src/MonthView.d.ts
189
191
  /**
@@ -233,6 +235,8 @@ interface MonthViewProps<T = unknown> extends DateSelectionConstraints$1, SlotSt
233
235
  maxVisibleEventCount?: number;
234
236
  /** Template for the overflow row; `{moreCount}` is replaced (default "{moreCount} More"). */
235
237
  moreLabel?: string;
238
+ /** Translations for the screen-reader words and gutter text; omitted keys use English. */
239
+ labels?: Partial<CalendarLabels$1>;
236
240
  /** Tap an event chip. */
237
241
  onPressEvent?: (event: CalendarEvent$1<T>) => void;
238
242
  /** Tap the "+N more" overflow row. */
@@ -318,7 +322,7 @@ interface MonthViewInternalProps<T = unknown> extends MonthViewProps<T> {
318
322
  * <MonthView date={new Date()} events={events} onPressDay={(d) => setDate(d)} />
319
323
  * ```
320
324
  */
321
- declare function MonthView<T = unknown>({ date, weekStartsOn, hiddenDays, weekdayFormat, events, eventsByDay: eventsByDayProp, renderEvent, eventAccessibilityLabel, maxVisibleEventCount, moreLabel, onPressEvent, onPressMore, selectedRange, selectedDates, showAdjacentMonths, highlightWeekends, fillCellOnSelection, showTitle, showWeekdays, locale, theme: themeOverrides, minDate, maxDate, isDateDisabled, onPressDay, onPressCell, onCreateEvent, onSelectDrag, onDragEvent, onDragStart, eventStartEditable, eventOverlap, keyboardDayNavigation, className, style, classNames, styles }: MonthViewInternalProps<T>): ReactElement;
325
+ export declare function MonthView<T = unknown>({ date, weekStartsOn, hiddenDays, weekdayFormat, events, eventsByDay: eventsByDayProp, renderEvent, eventAccessibilityLabel, maxVisibleEventCount, moreLabel, labels: labelsProp, onPressEvent, onPressMore, selectedRange, selectedDates, showAdjacentMonths, highlightWeekends, fillCellOnSelection, showTitle, showWeekdays, locale, theme: themeOverrides, minDate, maxDate, isDateDisabled, onPressDay, onPressCell, onCreateEvent, onSelectDrag, onDragEvent, onDragStart, eventStartEditable, eventOverlap, keyboardDayNavigation, className, style, classNames, styles }: MonthViewInternalProps<T>): ReactElement;
322
326
  //#endregion
323
327
  //#region src/TimeGrid.d.ts
324
328
  /**
@@ -428,6 +432,8 @@ interface TimeGridProps<T = unknown> extends SlotStyleProps<TimeGridSlot> {
428
432
  showAllDayEventCell?: boolean;
429
433
  /** Show the "all-day" text beside the lane (default false). */
430
434
  showAllDayLabel?: boolean;
435
+ /** Translations for the screen-reader words and gutter text; omitted keys use English. */
436
+ labels?: Partial<CalendarLabels$1>;
431
437
  /** Tint Saturday/Sunday columns with the weekend background (default true). Set
432
438
  * false to treat weekends like any other day. */
433
439
  highlightWeekends?: boolean;
@@ -501,7 +507,7 @@ interface TimeGridProps<T = unknown> extends SlotStyleProps<TimeGridSlot> {
501
507
  * <TimeGrid mode="week" date={new Date()} events={events} />
502
508
  * ```
503
509
  */
504
- declare function TimeGrid<T = unknown>({ date, events, mode, numberOfDays, weekStartsOn, weekdayFormat, hourHeight: initialHourHeight, scrollOffsetMinutes, zoomable, minHourHeight, maxHourHeight, minEventHeight, eventGap, dragStepMinutes, ampm, timeslots, minHour, maxHour, hideHours, showWeekNumber, weekNumberPrefix, hiddenDays, keyboardEventNavigation, businessHours, renderBusinessHours, renderBackgroundEvent, showNowIndicator, highlightWeekends, eventStartEditable, eventDurationEditable, eventOverlap, now: nowProp, timeZone, showAllDayEventCell, showAllDayLabel, locale, theme: themeOverrides, height, renderEvent, eventAccessibilityLabel, hourComponent, onPressEvent, onPressDateHeader, onPressCell, onCreateEvent, onDragStart, onDragEvent, onChangeDate, className, style, classNames, styles }: TimeGridProps<T>): ReactElement;
510
+ export declare function TimeGrid<T = unknown>({ date, events, mode, numberOfDays, weekStartsOn, weekdayFormat, hourHeight: initialHourHeight, scrollOffsetMinutes, zoomable, minHourHeight, maxHourHeight, minEventHeight, eventGap, dragStepMinutes, ampm, timeslots, minHour, maxHour, hideHours, showWeekNumber, weekNumberPrefix, hiddenDays, keyboardEventNavigation, businessHours, renderBusinessHours, renderBackgroundEvent, showNowIndicator, highlightWeekends, eventStartEditable, eventDurationEditable, eventOverlap, now: nowProp, timeZone, showAllDayEventCell, showAllDayLabel, labels: labelsProp, locale, theme: themeOverrides, height, renderEvent, eventAccessibilityLabel, hourComponent, onPressEvent, onPressDateHeader, onPressCell, onCreateEvent, onDragStart, onDragEvent, onChangeDate, className, style, classNames, styles }: TimeGridProps<T>): ReactElement;
505
511
  //#endregion
506
512
  //#region src/Calendar.d.ts
507
513
  /**
@@ -663,6 +669,8 @@ interface CalendarProps<T = unknown> extends DateSelectionConstraints$1, SlotSty
663
669
  maxVisibleEventCount?: number;
664
670
  /** Overflow row template; `{moreCount}` is replaced. */
665
671
  moreLabel?: string;
672
+ /** Translations for the screen-reader words and gutter text; omitted keys use English. */
673
+ labels?: Partial<CalendarLabels$1>;
666
674
  /** Render neighbouring months' days in the leading/trailing cells (default true). */
667
675
  showAdjacentMonths?: boolean;
668
676
  /**
@@ -713,7 +721,7 @@ interface CalendarProps<T = unknown> extends DateSelectionConstraints$1, SlotSty
713
721
  * <Calendar mode="week" date={new Date()} events={events} />
714
722
  * ```
715
723
  */
716
- declare function Calendar<T = unknown>({ mode, date, events, onChangeDate, weekStartsOn, hiddenDays, now, numberOfDays, locale, timeZone, theme, height, className, style, onPressEvent, eventAccessibilityLabel, ampm, hourHeight, minEventHeight, eventGap, scrollOffsetMinutes, timeslots, minHour, maxHour, hideHours, showWeekNumber, weekNumberPrefix, businessHours, renderBusinessHours, renderBackgroundEvent, showNowIndicator, showAllDayEventCell, showAllDayLabel, highlightWeekends, eventStartEditable, eventDurationEditable, eventOverlap, dragStepMinutes, onPressCell, onCreateEvent, onDragStart, onDragEvent, onPressDateHeader, renderTimeEvent, hourComponent, keyboardEventNavigation, maxVisibleEventCount, moreLabel, showAdjacentMonths, showTitle, weekdayFormat, fillCellOnSelection, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, keyboardDayNavigation, onPressDay, onSelectDrag, onPressMonth, onPressMore, renderMonthEvent, renderScheduleEvent, classNames, styles }: CalendarProps<T>): ReactElement;
724
+ export declare function Calendar<T = unknown>({ mode, date, events, onChangeDate, weekStartsOn, hiddenDays, now, numberOfDays, locale, timeZone, theme, height, className, style, onPressEvent, eventAccessibilityLabel, ampm, hourHeight, minEventHeight, eventGap, scrollOffsetMinutes, timeslots, minHour, maxHour, hideHours, showWeekNumber, weekNumberPrefix, businessHours, renderBusinessHours, renderBackgroundEvent, showNowIndicator, showAllDayEventCell, showAllDayLabel, highlightWeekends, eventStartEditable, eventDurationEditable, eventOverlap, dragStepMinutes, onPressCell, onCreateEvent, onDragStart, onDragEvent, onPressDateHeader, renderTimeEvent, hourComponent, keyboardEventNavigation, maxVisibleEventCount, moreLabel, labels, showAdjacentMonths, showTitle, weekdayFormat, fillCellOnSelection, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, keyboardDayNavigation, onPressDay, onSelectDrag, onPressMonth, onPressMore, renderMonthEvent, renderScheduleEvent, classNames, styles }: CalendarProps<T>): ReactElement;
717
725
  //#endregion
718
726
  //#region src/MonthList.d.ts
719
727
  /**
@@ -750,6 +758,8 @@ interface MonthListProps<T = unknown> extends DateSelectionConstraints$1, SlotSt
750
758
  maxVisibleEventCount?: number;
751
759
  /** Template for the overflow row; `{moreCount}` is replaced. */
752
760
  moreLabel?: string;
761
+ /** Translations for the screen-reader words and gutter text; omitted keys use English. */
762
+ labels?: Partial<CalendarLabels$1>;
753
763
  /** Tap an event chip. */
754
764
  onPressEvent?: (event: CalendarEvent$1<T>) => void;
755
765
  /** Tap the "+N more" overflow row. */
@@ -784,7 +794,7 @@ interface MonthListProps<T = unknown> extends DateSelectionConstraints$1, SlotSt
784
794
  * Legend List's DOM renderer and the library's headless grid logic. Selection is
785
795
  * controlled, pass `selectedRange` (or `selectedDates`) and handle `onPressDay`.
786
796
  */
787
- declare function MonthList<T = unknown>({ date, pastMonths, futureMonths, weekdayFormat, highlightWeekends, weekStartsOn, events, renderEvent, eventAccessibilityLabel, maxVisibleEventCount, moreLabel, onPressEvent, onPressMore, selectedRange, selectedDates, fillCellOnSelection, locale, theme: themeOverrides, height, minDate, maxDate, isDateDisabled, keyboardDayNavigation, onPressDay, className, style, classNames, styles }: MonthListProps<T>): ReactElement;
797
+ export declare function MonthList<T = unknown>({ date, pastMonths, futureMonths, weekdayFormat, highlightWeekends, weekStartsOn, events, renderEvent, eventAccessibilityLabel, maxVisibleEventCount, moreLabel, labels, onPressEvent, onPressMore, selectedRange, selectedDates, fillCellOnSelection, locale, theme: themeOverrides, height, minDate, maxDate, isDateDisabled, keyboardDayNavigation, onPressDay, className, style, classNames, styles }: MonthListProps<T>): ReactElement;
788
798
  //#endregion
789
799
  //#region src/DateRangePicker.d.ts
790
800
  /** Styleable chrome of the pickers (the calendar's own slots forward through too). */
@@ -825,7 +835,7 @@ interface DatePickerProps extends PickerBaseProps {
825
835
  * <DatePicker value={value} onChange={setValue} />
826
836
  * ```
827
837
  */
828
- declare function DatePicker({ value, onChange, formatLabel, weekStartsOn, height, placeholder, disabled, theme: themeOverrides, className, style, classNames, styles, minDate, maxDate, isDateDisabled }: DatePickerProps): ReactElement;
838
+ export declare function DatePicker({ value, onChange, formatLabel, weekStartsOn, height, placeholder, disabled, theme: themeOverrides, className, style, classNames, styles, minDate, maxDate, isDateDisabled }: DatePickerProps): ReactElement;
829
839
  /** Props for {@link DateRangePicker}. */
830
840
  interface DateRangePickerProps extends PickerBaseProps {
831
841
  /** The selected range, or `null`. `end` is `null` while only the start is picked. */
@@ -846,7 +856,7 @@ interface DateRangePickerProps extends PickerBaseProps {
846
856
  * <DateRangePicker value={range} onChange={setRange} />
847
857
  * ```
848
858
  */
849
- declare function DateRangePicker({ value, onChange, formatLabel, weekStartsOn, height, placeholder, disabled, theme: themeOverrides, className, style, classNames, styles, minDate, maxDate, isDateDisabled }: DateRangePickerProps): ReactElement;
859
+ export declare function DateRangePicker({ value, onChange, formatLabel, weekStartsOn, height, placeholder, disabled, theme: themeOverrides, className, style, classNames, styles, minDate, maxDate, isDateDisabled }: DateRangePickerProps): ReactElement;
850
860
  //#endregion
851
861
  //#region src/ResourceTimeline.d.ts
852
862
  /**
@@ -984,6 +994,6 @@ interface ResourceTimelineProps<T = unknown> extends SlotStyleProps<ResourceTime
984
994
  * />
985
995
  * ```
986
996
  */
987
- declare function ResourceTimeline<T = unknown>({ date, orientation, resources: allResources, resourcesPerPage, resourcePage, events, resourceId, startHour, endHour, hourWidth, hourHeight, rowHeight, labelWidth, ampm, theme: themeOverrides, renderEvent, onPressEvent, onDragEvent, onPressCell, onCreateEvent, businessHours, renderBusinessHours, renderResourceHeader, dragStepMinutes, showNowIndicator, now: nowProp, timeZone, className, style, classNames, styles }: ResourceTimelineProps<T>): ReactElement;
997
+ export declare function ResourceTimeline<T = unknown>({ date, orientation, resources: allResources, resourcesPerPage, resourcePage, events, resourceId, startHour, endHour, hourWidth, hourHeight, rowHeight, labelWidth, ampm, theme: themeOverrides, renderEvent, onPressEvent, onDragEvent, onPressCell, onCreateEvent, businessHours, renderBusinessHours, renderResourceHeader, dragStepMinutes, showNowIndicator, now: nowProp, timeZone, className, style, classNames, styles }: ResourceTimelineProps<T>): ReactElement;
988
998
  //#endregion
989
- export { Agenda, type AgendaProps, type AgendaSlot, type BusinessHours, type BusinessHoursBand, Calendar, type CalendarEvent, type CalendarMode, type CalendarProps, type CalendarSlot, DatePicker, type DatePickerProps, type DatePickerSlot, type DateRange, DateRangePicker, type DateRangePickerProps, type DateSelectionConstraints, type DaySelectionState, type DomAgendaEvent, type DomAgendaEventArgs, type DomCalendarTheme, type DomMonthEvent, type DomMonthEventArgs, type DomRenderEvent, type DomRenderEventArgs, type EventAccessibilityLabelContext, type EventAccessibilityLabeler, type ICalEvent, type ICalendarEvent, type MonthEventSegment, type MonthGrid, type MonthGridDay, type MonthGridWeek, type MonthGridWeekday, MonthList, type MonthListProps, type MonthListSlot, MonthView, type MonthViewProps, type MonthViewSlot, type MonthWeekEvents, type PositionedEvent, type RecurrenceFrequency, type RecurrenceRule, type ResolvedSlot, type Resource, type ResourceEventArgs, ResourceTimeline, type ResourceTimelineProps, type ResourceTimelineSlot, type SlotDefault, type SlotStyleProps, TimeGrid, type TimeGridMode, type TimeGridProps, type TimeGridSlot, type ToICalendarOptions, type UseDateRangeOptions, type UseMonthGridOptions, type WeekStartsOn, type WeekdayFormat, YearView, type YearViewProps, type YearViewSlot, backgroundBandsForDay, buildMonthGrid, darkDomTheme, daySelectionState, defaultDomTheme, expandRecurringEvents, getViewDays, isAllDayEvent, isBackgroundEvent, isDateSelectable, isRangeEndpoint, isWithinDateRange, layoutDayEvents, layoutMonthWeek, mergeDomTheme, nextDateRange, parseICalendar, toICalendar, useDateRange, useEventSource, useMonthGrid, useNow, weekdayFormatToken };
999
+ export { type AgendaProps, type AgendaSlot, type BusinessHours, type BusinessHoursBand, type CalendarEvent, type CalendarLabels, type CalendarMode, type CalendarProps, type CalendarSlot, type DatePickerProps, type DatePickerSlot, type DateRange, type DateRangePickerProps, type DateSelectionConstraints, type DaySelectionState, type DomAgendaEvent, type DomAgendaEventArgs, type DomCalendarTheme, type DomMonthEvent, type DomMonthEventArgs, type DomRenderEvent, type DomRenderEventArgs, type EventAccessibilityLabelContext, type EventAccessibilityLabeler, type ICalEvent, type ICalendarEvent, type MonthEventSegment, type MonthGrid, type MonthGridDay, type MonthGridWeek, type MonthGridWeekday, type MonthListProps, type MonthListSlot, type MonthViewProps, type MonthViewSlot, type MonthWeekEvents, type PositionedEvent, type RecurrenceFrequency, type RecurrenceRule, type ResolvedSlot, type Resource, type ResourceEventArgs, type ResourceTimelineProps, type ResourceTimelineSlot, type SlotDefault, type SlotStyleProps, type TimeGridMode, type TimeGridProps, type TimeGridSlot, type ToICalendarOptions, type UseDateRangeOptions, type UseMonthGridOptions, type WeekStartsOn, type WeekdayFormat, type YearViewProps, type YearViewSlot, backgroundBandsForDay, buildMonthGrid, daySelectionState, defaultCalendarLabels, expandRecurringEvents, getViewDays, isAllDayEvent, isBackgroundEvent, isDateSelectable, isRangeEndpoint, isWithinDateRange, layoutDayEvents, layoutMonthWeek, nextDateRange, parseICalendar, toICalendar, useDateRange, useEventSource, useMonthGrid, useNow, weekdayFormatToken };
package/dist/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { Locale } from "date-fns";
2
2
  import { CSSProperties, ComponentType, ReactElement, ReactNode } from "react";
3
- import { BusinessHours, BusinessHours as BusinessHours$1, BusinessHoursBand, BusinessHoursBand as BusinessHoursBand$1, BusinessHoursValue, CalendarColors, CalendarEvent, CalendarEvent as CalendarEvent$1, CalendarMode, CalendarMode as CalendarMode$1, DateRange, DateRange as DateRange$1, DateSelectionConstraints, DateSelectionConstraints as DateSelectionConstraints$1, DaySelectionState, EventAccessibilityLabelContext, EventAccessibilityLabeler, EventAccessibilityLabeler as EventAccessibilityLabeler$1, ICalEvent, ICalendarEvent, MonthEventSegment, MonthGrid, MonthGridDay, MonthGridWeek, MonthGridWeekday, MonthWeekEvents, PositionedEvent, RecurrenceFrequency, RecurrenceRule, TimeGridMode, TimeGridMode as TimeGridMode$1, ToICalendarOptions, UseDateRangeOptions, UseMonthGridOptions, WeekStartsOn, WeekStartsOn as WeekStartsOn$1, WeekdayFormat, WeekdayFormat as WeekdayFormat$1, backgroundBandsForDay, buildMonthGrid, daySelectionState, expandRecurringEvents, getViewDays, isAllDayEvent, isBackgroundEvent, isDateSelectable, isRangeEndpoint, isWithinDateRange, layoutDayEvents, layoutMonthWeek, nextDateRange, parseICalendar, toICalendar, useDateRange, useEventSource, useMonthGrid, useNow, weekdayFormatToken } from "@super-calendar/core";
3
+ import { BusinessHours, BusinessHours as BusinessHours$1, BusinessHoursBand, BusinessHoursBand as BusinessHoursBand$1, BusinessHoursValue, CalendarColors, CalendarEvent, CalendarEvent as CalendarEvent$1, CalendarLabels, CalendarLabels as CalendarLabels$1, CalendarMode, CalendarMode as CalendarMode$1, DateRange, DateRange as DateRange$1, DateSelectionConstraints, DateSelectionConstraints as DateSelectionConstraints$1, DaySelectionState, EventAccessibilityLabelContext, EventAccessibilityLabeler, EventAccessibilityLabeler as EventAccessibilityLabeler$1, ICalEvent, ICalendarEvent, MonthEventSegment, MonthGrid, MonthGridDay, MonthGridWeek, MonthGridWeekday, MonthWeekEvents, PositionedEvent, RecurrenceFrequency, RecurrenceRule, TimeGridMode, TimeGridMode as TimeGridMode$1, ToICalendarOptions, UseDateRangeOptions, UseMonthGridOptions, WeekStartsOn, WeekStartsOn as WeekStartsOn$1, WeekdayFormat, WeekdayFormat as WeekdayFormat$1, backgroundBandsForDay, buildMonthGrid, daySelectionState, defaultCalendarLabels, expandRecurringEvents, getViewDays, isAllDayEvent, isBackgroundEvent, isDateSelectable, isRangeEndpoint, isWithinDateRange, layoutDayEvents, layoutMonthWeek, nextDateRange, parseICalendar, toICalendar, useDateRange, useEventSource, useMonthGrid, useNow, weekdayFormatToken } from "@super-calendar/core";
4
4
  //#region src/slots.d.ts
5
5
  /**
6
6
  * Per-slot styling overrides. Give a slot a Tailwind/CSS class and/or an inline
@@ -50,11 +50,11 @@ type DomCalendarTheme = CalendarColors & {
50
50
  fontFamily: string;
51
51
  };
52
52
  /** The default light theme: the core light palette plus the DOM metrics. */
53
- declare const defaultDomTheme: DomCalendarTheme;
53
+ export declare const defaultDomTheme: DomCalendarTheme;
54
54
  /** The dark theme: the core dark palette plus the DOM metrics. */
55
- declare const darkDomTheme: DomCalendarTheme;
55
+ export declare const darkDomTheme: DomCalendarTheme;
56
56
  /** Merge a partial override onto a base theme (defaults to {@link defaultDomTheme}). */
57
- declare function mergeDomTheme(overrides?: Partial<DomCalendarTheme>, base?: DomCalendarTheme): DomCalendarTheme;
57
+ export declare function mergeDomTheme(overrides?: Partial<DomCalendarTheme>, base?: DomCalendarTheme): DomCalendarTheme;
58
58
  //#endregion
59
59
  //#region src/Agenda.d.ts
60
60
  /**
@@ -119,7 +119,7 @@ interface AgendaProps<T = unknown> extends SlotStyleProps<AgendaSlot> {
119
119
  * <Agenda events={events} onPressEvent={(e) => console.log(e.title)} />
120
120
  * ```
121
121
  */
122
- declare function Agenda<T = unknown>({ events, locale, ampm, activeDate, theme: themeOverrides, height, renderEvent, eventAccessibilityLabel, onPressEvent, onPressDay, className, style, classNames, styles }: AgendaProps<T>): ReactElement;
122
+ export declare function Agenda<T = unknown>({ events, locale, ampm, activeDate, theme: themeOverrides, height, renderEvent, eventAccessibilityLabel, onPressEvent, onPressDay, className, style, classNames, styles }: AgendaProps<T>): ReactElement;
123
123
  //#endregion
124
124
  //#region src/YearView.d.ts
125
125
  /**
@@ -140,6 +140,8 @@ interface YearViewProps<T = unknown> extends DateSelectionConstraints$1, SlotSty
140
140
  /** Weekdays (0=Sunday…6=Saturday) hidden from the grid, e.g. `[0, 6]` for weekends off. */
141
141
  hiddenDays?: number[];
142
142
  locale?: Locale;
143
+ /** Translations for the screen-reader words; omitted keys use English. */
144
+ labels?: Partial<CalendarLabels$1>;
143
145
  /** Highlight this date instead of the real "today". */
144
146
  activeDate?: Date;
145
147
  /** A selected span: endpoints get a filled badge, the days between get the range band. */
@@ -183,7 +185,7 @@ interface YearViewProps<T = unknown> extends DateSelectionConstraints$1, SlotSty
183
185
  * highlighted and a dot under days that hold events. It's the view `Calendar`
184
186
  * renders for `mode="year"`.
185
187
  */
186
- declare function YearView<T = unknown>({ date, events, weekStartsOn, hiddenDays, locale, activeDate, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, minMonthWidth, onPressDay, onPressMonth, onSelectDrag, onCreateEvent, theme: themeOverrides, className, style, classNames, styles }: YearViewProps<T>): ReactElement;
188
+ export declare function YearView<T = unknown>({ date, events, weekStartsOn, hiddenDays, locale, labels: labelsProp, activeDate, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, minMonthWidth, onPressDay, onPressMonth, onSelectDrag, onCreateEvent, theme: themeOverrides, className, style, classNames, styles }: YearViewProps<T>): ReactElement;
187
189
  //#endregion
188
190
  //#region src/MonthView.d.ts
189
191
  /**
@@ -233,6 +235,8 @@ interface MonthViewProps<T = unknown> extends DateSelectionConstraints$1, SlotSt
233
235
  maxVisibleEventCount?: number;
234
236
  /** Template for the overflow row; `{moreCount}` is replaced (default "{moreCount} More"). */
235
237
  moreLabel?: string;
238
+ /** Translations for the screen-reader words and gutter text; omitted keys use English. */
239
+ labels?: Partial<CalendarLabels$1>;
236
240
  /** Tap an event chip. */
237
241
  onPressEvent?: (event: CalendarEvent$1<T>) => void;
238
242
  /** Tap the "+N more" overflow row. */
@@ -318,7 +322,7 @@ interface MonthViewInternalProps<T = unknown> extends MonthViewProps<T> {
318
322
  * <MonthView date={new Date()} events={events} onPressDay={(d) => setDate(d)} />
319
323
  * ```
320
324
  */
321
- declare function MonthView<T = unknown>({ date, weekStartsOn, hiddenDays, weekdayFormat, events, eventsByDay: eventsByDayProp, renderEvent, eventAccessibilityLabel, maxVisibleEventCount, moreLabel, onPressEvent, onPressMore, selectedRange, selectedDates, showAdjacentMonths, highlightWeekends, fillCellOnSelection, showTitle, showWeekdays, locale, theme: themeOverrides, minDate, maxDate, isDateDisabled, onPressDay, onPressCell, onCreateEvent, onSelectDrag, onDragEvent, onDragStart, eventStartEditable, eventOverlap, keyboardDayNavigation, className, style, classNames, styles }: MonthViewInternalProps<T>): ReactElement;
325
+ export declare function MonthView<T = unknown>({ date, weekStartsOn, hiddenDays, weekdayFormat, events, eventsByDay: eventsByDayProp, renderEvent, eventAccessibilityLabel, maxVisibleEventCount, moreLabel, labels: labelsProp, onPressEvent, onPressMore, selectedRange, selectedDates, showAdjacentMonths, highlightWeekends, fillCellOnSelection, showTitle, showWeekdays, locale, theme: themeOverrides, minDate, maxDate, isDateDisabled, onPressDay, onPressCell, onCreateEvent, onSelectDrag, onDragEvent, onDragStart, eventStartEditable, eventOverlap, keyboardDayNavigation, className, style, classNames, styles }: MonthViewInternalProps<T>): ReactElement;
322
326
  //#endregion
323
327
  //#region src/TimeGrid.d.ts
324
328
  /**
@@ -428,6 +432,8 @@ interface TimeGridProps<T = unknown> extends SlotStyleProps<TimeGridSlot> {
428
432
  showAllDayEventCell?: boolean;
429
433
  /** Show the "all-day" text beside the lane (default false). */
430
434
  showAllDayLabel?: boolean;
435
+ /** Translations for the screen-reader words and gutter text; omitted keys use English. */
436
+ labels?: Partial<CalendarLabels$1>;
431
437
  /** Tint Saturday/Sunday columns with the weekend background (default true). Set
432
438
  * false to treat weekends like any other day. */
433
439
  highlightWeekends?: boolean;
@@ -501,7 +507,7 @@ interface TimeGridProps<T = unknown> extends SlotStyleProps<TimeGridSlot> {
501
507
  * <TimeGrid mode="week" date={new Date()} events={events} />
502
508
  * ```
503
509
  */
504
- declare function TimeGrid<T = unknown>({ date, events, mode, numberOfDays, weekStartsOn, weekdayFormat, hourHeight: initialHourHeight, scrollOffsetMinutes, zoomable, minHourHeight, maxHourHeight, minEventHeight, eventGap, dragStepMinutes, ampm, timeslots, minHour, maxHour, hideHours, showWeekNumber, weekNumberPrefix, hiddenDays, keyboardEventNavigation, businessHours, renderBusinessHours, renderBackgroundEvent, showNowIndicator, highlightWeekends, eventStartEditable, eventDurationEditable, eventOverlap, now: nowProp, timeZone, showAllDayEventCell, showAllDayLabel, locale, theme: themeOverrides, height, renderEvent, eventAccessibilityLabel, hourComponent, onPressEvent, onPressDateHeader, onPressCell, onCreateEvent, onDragStart, onDragEvent, onChangeDate, className, style, classNames, styles }: TimeGridProps<T>): ReactElement;
510
+ export declare function TimeGrid<T = unknown>({ date, events, mode, numberOfDays, weekStartsOn, weekdayFormat, hourHeight: initialHourHeight, scrollOffsetMinutes, zoomable, minHourHeight, maxHourHeight, minEventHeight, eventGap, dragStepMinutes, ampm, timeslots, minHour, maxHour, hideHours, showWeekNumber, weekNumberPrefix, hiddenDays, keyboardEventNavigation, businessHours, renderBusinessHours, renderBackgroundEvent, showNowIndicator, highlightWeekends, eventStartEditable, eventDurationEditable, eventOverlap, now: nowProp, timeZone, showAllDayEventCell, showAllDayLabel, labels: labelsProp, locale, theme: themeOverrides, height, renderEvent, eventAccessibilityLabel, hourComponent, onPressEvent, onPressDateHeader, onPressCell, onCreateEvent, onDragStart, onDragEvent, onChangeDate, className, style, classNames, styles }: TimeGridProps<T>): ReactElement;
505
511
  //#endregion
506
512
  //#region src/Calendar.d.ts
507
513
  /**
@@ -663,6 +669,8 @@ interface CalendarProps<T = unknown> extends DateSelectionConstraints$1, SlotSty
663
669
  maxVisibleEventCount?: number;
664
670
  /** Overflow row template; `{moreCount}` is replaced. */
665
671
  moreLabel?: string;
672
+ /** Translations for the screen-reader words and gutter text; omitted keys use English. */
673
+ labels?: Partial<CalendarLabels$1>;
666
674
  /** Render neighbouring months' days in the leading/trailing cells (default true). */
667
675
  showAdjacentMonths?: boolean;
668
676
  /**
@@ -713,7 +721,7 @@ interface CalendarProps<T = unknown> extends DateSelectionConstraints$1, SlotSty
713
721
  * <Calendar mode="week" date={new Date()} events={events} />
714
722
  * ```
715
723
  */
716
- declare function Calendar<T = unknown>({ mode, date, events, onChangeDate, weekStartsOn, hiddenDays, now, numberOfDays, locale, timeZone, theme, height, className, style, onPressEvent, eventAccessibilityLabel, ampm, hourHeight, minEventHeight, eventGap, scrollOffsetMinutes, timeslots, minHour, maxHour, hideHours, showWeekNumber, weekNumberPrefix, businessHours, renderBusinessHours, renderBackgroundEvent, showNowIndicator, showAllDayEventCell, showAllDayLabel, highlightWeekends, eventStartEditable, eventDurationEditable, eventOverlap, dragStepMinutes, onPressCell, onCreateEvent, onDragStart, onDragEvent, onPressDateHeader, renderTimeEvent, hourComponent, keyboardEventNavigation, maxVisibleEventCount, moreLabel, showAdjacentMonths, showTitle, weekdayFormat, fillCellOnSelection, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, keyboardDayNavigation, onPressDay, onSelectDrag, onPressMonth, onPressMore, renderMonthEvent, renderScheduleEvent, classNames, styles }: CalendarProps<T>): ReactElement;
724
+ export declare function Calendar<T = unknown>({ mode, date, events, onChangeDate, weekStartsOn, hiddenDays, now, numberOfDays, locale, timeZone, theme, height, className, style, onPressEvent, eventAccessibilityLabel, ampm, hourHeight, minEventHeight, eventGap, scrollOffsetMinutes, timeslots, minHour, maxHour, hideHours, showWeekNumber, weekNumberPrefix, businessHours, renderBusinessHours, renderBackgroundEvent, showNowIndicator, showAllDayEventCell, showAllDayLabel, highlightWeekends, eventStartEditable, eventDurationEditable, eventOverlap, dragStepMinutes, onPressCell, onCreateEvent, onDragStart, onDragEvent, onPressDateHeader, renderTimeEvent, hourComponent, keyboardEventNavigation, maxVisibleEventCount, moreLabel, labels, showAdjacentMonths, showTitle, weekdayFormat, fillCellOnSelection, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, keyboardDayNavigation, onPressDay, onSelectDrag, onPressMonth, onPressMore, renderMonthEvent, renderScheduleEvent, classNames, styles }: CalendarProps<T>): ReactElement;
717
725
  //#endregion
718
726
  //#region src/MonthList.d.ts
719
727
  /**
@@ -750,6 +758,8 @@ interface MonthListProps<T = unknown> extends DateSelectionConstraints$1, SlotSt
750
758
  maxVisibleEventCount?: number;
751
759
  /** Template for the overflow row; `{moreCount}` is replaced. */
752
760
  moreLabel?: string;
761
+ /** Translations for the screen-reader words and gutter text; omitted keys use English. */
762
+ labels?: Partial<CalendarLabels$1>;
753
763
  /** Tap an event chip. */
754
764
  onPressEvent?: (event: CalendarEvent$1<T>) => void;
755
765
  /** Tap the "+N more" overflow row. */
@@ -784,7 +794,7 @@ interface MonthListProps<T = unknown> extends DateSelectionConstraints$1, SlotSt
784
794
  * Legend List's DOM renderer and the library's headless grid logic. Selection is
785
795
  * controlled, pass `selectedRange` (or `selectedDates`) and handle `onPressDay`.
786
796
  */
787
- declare function MonthList<T = unknown>({ date, pastMonths, futureMonths, weekdayFormat, highlightWeekends, weekStartsOn, events, renderEvent, eventAccessibilityLabel, maxVisibleEventCount, moreLabel, onPressEvent, onPressMore, selectedRange, selectedDates, fillCellOnSelection, locale, theme: themeOverrides, height, minDate, maxDate, isDateDisabled, keyboardDayNavigation, onPressDay, className, style, classNames, styles }: MonthListProps<T>): ReactElement;
797
+ export declare function MonthList<T = unknown>({ date, pastMonths, futureMonths, weekdayFormat, highlightWeekends, weekStartsOn, events, renderEvent, eventAccessibilityLabel, maxVisibleEventCount, moreLabel, labels, onPressEvent, onPressMore, selectedRange, selectedDates, fillCellOnSelection, locale, theme: themeOverrides, height, minDate, maxDate, isDateDisabled, keyboardDayNavigation, onPressDay, className, style, classNames, styles }: MonthListProps<T>): ReactElement;
788
798
  //#endregion
789
799
  //#region src/DateRangePicker.d.ts
790
800
  /** Styleable chrome of the pickers (the calendar's own slots forward through too). */
@@ -825,7 +835,7 @@ interface DatePickerProps extends PickerBaseProps {
825
835
  * <DatePicker value={value} onChange={setValue} />
826
836
  * ```
827
837
  */
828
- declare function DatePicker({ value, onChange, formatLabel, weekStartsOn, height, placeholder, disabled, theme: themeOverrides, className, style, classNames, styles, minDate, maxDate, isDateDisabled }: DatePickerProps): ReactElement;
838
+ export declare function DatePicker({ value, onChange, formatLabel, weekStartsOn, height, placeholder, disabled, theme: themeOverrides, className, style, classNames, styles, minDate, maxDate, isDateDisabled }: DatePickerProps): ReactElement;
829
839
  /** Props for {@link DateRangePicker}. */
830
840
  interface DateRangePickerProps extends PickerBaseProps {
831
841
  /** The selected range, or `null`. `end` is `null` while only the start is picked. */
@@ -846,7 +856,7 @@ interface DateRangePickerProps extends PickerBaseProps {
846
856
  * <DateRangePicker value={range} onChange={setRange} />
847
857
  * ```
848
858
  */
849
- declare function DateRangePicker({ value, onChange, formatLabel, weekStartsOn, height, placeholder, disabled, theme: themeOverrides, className, style, classNames, styles, minDate, maxDate, isDateDisabled }: DateRangePickerProps): ReactElement;
859
+ export declare function DateRangePicker({ value, onChange, formatLabel, weekStartsOn, height, placeholder, disabled, theme: themeOverrides, className, style, classNames, styles, minDate, maxDate, isDateDisabled }: DateRangePickerProps): ReactElement;
850
860
  //#endregion
851
861
  //#region src/ResourceTimeline.d.ts
852
862
  /**
@@ -984,6 +994,6 @@ interface ResourceTimelineProps<T = unknown> extends SlotStyleProps<ResourceTime
984
994
  * />
985
995
  * ```
986
996
  */
987
- declare function ResourceTimeline<T = unknown>({ date, orientation, resources: allResources, resourcesPerPage, resourcePage, events, resourceId, startHour, endHour, hourWidth, hourHeight, rowHeight, labelWidth, ampm, theme: themeOverrides, renderEvent, onPressEvent, onDragEvent, onPressCell, onCreateEvent, businessHours, renderBusinessHours, renderResourceHeader, dragStepMinutes, showNowIndicator, now: nowProp, timeZone, className, style, classNames, styles }: ResourceTimelineProps<T>): ReactElement;
997
+ export declare function ResourceTimeline<T = unknown>({ date, orientation, resources: allResources, resourcesPerPage, resourcePage, events, resourceId, startHour, endHour, hourWidth, hourHeight, rowHeight, labelWidth, ampm, theme: themeOverrides, renderEvent, onPressEvent, onDragEvent, onPressCell, onCreateEvent, businessHours, renderBusinessHours, renderResourceHeader, dragStepMinutes, showNowIndicator, now: nowProp, timeZone, className, style, classNames, styles }: ResourceTimelineProps<T>): ReactElement;
988
998
  //#endregion
989
- export { Agenda, type AgendaProps, type AgendaSlot, type BusinessHours, type BusinessHoursBand, Calendar, type CalendarEvent, type CalendarMode, type CalendarProps, type CalendarSlot, DatePicker, type DatePickerProps, type DatePickerSlot, type DateRange, DateRangePicker, type DateRangePickerProps, type DateSelectionConstraints, type DaySelectionState, type DomAgendaEvent, type DomAgendaEventArgs, type DomCalendarTheme, type DomMonthEvent, type DomMonthEventArgs, type DomRenderEvent, type DomRenderEventArgs, type EventAccessibilityLabelContext, type EventAccessibilityLabeler, type ICalEvent, type ICalendarEvent, type MonthEventSegment, type MonthGrid, type MonthGridDay, type MonthGridWeek, type MonthGridWeekday, MonthList, type MonthListProps, type MonthListSlot, MonthView, type MonthViewProps, type MonthViewSlot, type MonthWeekEvents, type PositionedEvent, type RecurrenceFrequency, type RecurrenceRule, type ResolvedSlot, type Resource, type ResourceEventArgs, ResourceTimeline, type ResourceTimelineProps, type ResourceTimelineSlot, type SlotDefault, type SlotStyleProps, TimeGrid, type TimeGridMode, type TimeGridProps, type TimeGridSlot, type ToICalendarOptions, type UseDateRangeOptions, type UseMonthGridOptions, type WeekStartsOn, type WeekdayFormat, YearView, type YearViewProps, type YearViewSlot, backgroundBandsForDay, buildMonthGrid, darkDomTheme, daySelectionState, defaultDomTheme, expandRecurringEvents, getViewDays, isAllDayEvent, isBackgroundEvent, isDateSelectable, isRangeEndpoint, isWithinDateRange, layoutDayEvents, layoutMonthWeek, mergeDomTheme, nextDateRange, parseICalendar, toICalendar, useDateRange, useEventSource, useMonthGrid, useNow, weekdayFormatToken };
999
+ export { type AgendaProps, type AgendaSlot, type BusinessHours, type BusinessHoursBand, type CalendarEvent, type CalendarLabels, type CalendarMode, type CalendarProps, type CalendarSlot, type DatePickerProps, type DatePickerSlot, type DateRange, type DateRangePickerProps, type DateSelectionConstraints, type DaySelectionState, type DomAgendaEvent, type DomAgendaEventArgs, type DomCalendarTheme, type DomMonthEvent, type DomMonthEventArgs, type DomRenderEvent, type DomRenderEventArgs, type EventAccessibilityLabelContext, type EventAccessibilityLabeler, type ICalEvent, type ICalendarEvent, type MonthEventSegment, type MonthGrid, type MonthGridDay, type MonthGridWeek, type MonthGridWeekday, type MonthListProps, type MonthListSlot, type MonthViewProps, type MonthViewSlot, type MonthWeekEvents, type PositionedEvent, type RecurrenceFrequency, type RecurrenceRule, type ResolvedSlot, type Resource, type ResourceEventArgs, type ResourceTimelineProps, type ResourceTimelineSlot, type SlotDefault, type SlotStyleProps, type TimeGridMode, type TimeGridProps, type TimeGridSlot, type ToICalendarOptions, type UseDateRangeOptions, type UseMonthGridOptions, type WeekStartsOn, type WeekdayFormat, type YearViewProps, type YearViewSlot, backgroundBandsForDay, buildMonthGrid, daySelectionState, defaultCalendarLabels, expandRecurringEvents, getViewDays, isAllDayEvent, isBackgroundEvent, isDateSelectable, isRangeEndpoint, isWithinDateRange, layoutDayEvents, layoutMonthWeek, nextDateRange, parseICalendar, toICalendar, useDateRange, useEventSource, useMonthGrid, useNow, weekdayFormatToken };
package/dist/index.js CHANGED
@@ -241,8 +241,9 @@ function Agenda({ events, locale, ampm = false, activeDate, theme: themeOverride
241
241
  * highlighted and a dot under days that hold events. It's the view `Calendar`
242
242
  * renders for `mode="year"`.
243
243
  */
244
- function YearView({ date, events, weekStartsOn = 0, hiddenDays, locale, activeDate, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, minMonthWidth = 150, onPressDay, onPressMonth, onSelectDrag, onCreateEvent, theme: themeOverrides, className, style, classNames, styles }) {
244
+ function YearView({ date, events, weekStartsOn = 0, hiddenDays, locale, labels: labelsProp, activeDate, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, minMonthWidth = 150, onPressDay, onPressMonth, onSelectDrag, onCreateEvent, theme: themeOverrides, className, style, classNames, styles }) {
245
245
  const theme = (0, react.useMemo)(() => mergeDomTheme(themeOverrides), [themeOverrides]);
246
+ const labels = (0, react.useMemo)(() => (0, _super_calendar_core.resolveCalendarLabels)(labelsProp), [labelsProp]);
246
247
  const slot = createSlots({
247
248
  classNames,
248
249
  styles
@@ -400,7 +401,14 @@ function YearView({ date, events, weekStartsOn = 0, hiddenDays, locale, activeDa
400
401
  });
401
402
  const dayTime = (0, date_fns.startOfDay)(day).getTime();
402
403
  const inCreate = creating != null && dayTime >= Math.min(creating.anchor, creating.hover) && dayTime <= Math.max(creating.anchor, creating.hover);
403
- const label = `${(0, date_fns.format)(day, "EEEE, d LLLL yyyy", { locale })}${isToday ? ", today" : ""}${state.isSelected ? ", selected" : ""}${state.isDisabled ? ", unavailable" : ""}${hasEvents ? ", has events" : ""}`;
404
+ const label = (0, _super_calendar_core.dayAccessibilityLabel)({
405
+ dateLabel: (0, date_fns.format)(day, "EEEE, d LLLL yyyy", { locale }),
406
+ isToday,
407
+ isSelected: state.isSelected,
408
+ isDisabled: state.isDisabled,
409
+ hasEvents,
410
+ labels
411
+ });
404
412
  const badge = (0, _super_calendar_core.dayBadgeKind)(state, isHighlighted);
405
413
  const daySlot = slot("day", {
406
414
  base: {
@@ -543,7 +551,6 @@ const EMPTY_LAYOUT = {
543
551
  segments: [],
544
552
  laneCount: 0
545
553
  };
546
- const DATE_ROW = 24;
547
554
  const CHIP_HEIGHT = 18;
548
555
  const CHIP_GAP = 2;
549
556
  const CELL_PAD = 4;
@@ -583,7 +590,7 @@ function rangeBandDefault(day, theme, fillCell, eventsMode) {
583
590
  const kind = (0, _super_calendar_core.rangeBandKind)(day, fillCell);
584
591
  if (kind === "none") return null;
585
592
  const fill = kind === "fill";
586
- const badgeSize = eventsMode ? DATE_ROW - 2 : theme.dayBadgeSize;
593
+ const badgeSize = eventsMode ? 22 : theme.dayBadgeSize;
587
594
  const bandHeight = eventsMode ? badgeSize : theme.rangeBandHeight;
588
595
  const inset = fill ? 0 : eventsMode ? CELL_PAD : Math.max(0, (theme.cellHeight - bandHeight) / 2);
589
596
  const radius = fill ? 0 : bandHeight / 2;
@@ -662,8 +669,8 @@ function compactBadgeDefault(day, theme) {
662
669
  position: "relative",
663
670
  zIndex: 1,
664
671
  alignSelf: "flex-end",
665
- width: DATE_ROW - 2,
666
- height: DATE_ROW - 2,
672
+ width: 22,
673
+ height: 22,
667
674
  borderRadius: "50%",
668
675
  display: "flex",
669
676
  alignItems: "center",
@@ -749,8 +756,9 @@ function collectRowEvents(week, eventsByDay) {
749
756
  * <MonthView date={new Date()} events={events} onPressDay={(d) => setDate(d)} />
750
757
  * ```
751
758
  */
752
- function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short", events, eventsByDay: eventsByDayProp, renderEvent, eventAccessibilityLabel, maxVisibleEventCount = 3, moreLabel = "{moreCount} More", onPressEvent, onPressMore, selectedRange, selectedDates, showAdjacentMonths = true, highlightWeekends = true, fillCellOnSelection = false, showTitle = true, showWeekdays = true, locale, theme: themeOverrides, minDate, maxDate, isDateDisabled, onPressDay, onPressCell, onCreateEvent, onSelectDrag, onDragEvent, onDragStart, eventStartEditable = true, eventOverlap = true, keyboardDayNavigation = false, className, style, classNames, styles }) {
759
+ function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short", events, eventsByDay: eventsByDayProp, renderEvent, eventAccessibilityLabel, maxVisibleEventCount = 3, moreLabel = "{moreCount} More", labels: labelsProp, onPressEvent, onPressMore, selectedRange, selectedDates, showAdjacentMonths = true, highlightWeekends = true, fillCellOnSelection = false, showTitle = true, showWeekdays = true, locale, theme: themeOverrides, minDate, maxDate, isDateDisabled, onPressDay, onPressCell, onCreateEvent, onSelectDrag, onDragEvent, onDragStart, eventStartEditable = true, eventOverlap = true, keyboardDayNavigation = false, className, style, classNames, styles }) {
753
760
  const theme = (0, react.useMemo)(() => mergeDomTheme(themeOverrides), [themeOverrides]);
761
+ const labels = (0, react.useMemo)(() => (0, _super_calendar_core.resolveCalendarLabels)(labelsProp), [labelsProp]);
754
762
  const slot = createSlots({
755
763
  classNames,
756
764
  styles
@@ -835,7 +843,8 @@ function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short"
835
843
  const [focusedDate, setFocusedDate] = (0, react.useState)(initialFocus);
836
844
  const initialFocusRef = (0, react.useRef)(initialFocus);
837
845
  initialFocusRef.current = initialFocus;
838
- (0, react.useEffect)(() => setFocusedDate(initialFocusRef.current), [(0, date_fns.format)(date, "yyyy-MM")]);
846
+ const monthKey = (0, date_fns.format)(date, "yyyy-MM");
847
+ (0, react.useEffect)(() => setFocusedDate(initialFocusRef.current), [monthKey]);
839
848
  const [hoveredKey, setHoveredKey] = (0, react.useState)(null);
840
849
  const gridRef = (0, react.useRef)(null);
841
850
  const focusKey = (0, date_fns.format)(focusedDate, "yyyy-MM-dd");
@@ -1020,7 +1029,12 @@ function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short"
1020
1029
  style: { height: cellHeight }
1021
1030
  }, day.id);
1022
1031
  const band = rangeBandDefault(day, theme, fillCellOnSelection, eventsMode);
1023
- const label = (0, date_fns.format)(day.date, "EEEE, d MMMM yyyy", locale ? { locale } : void 0);
1032
+ const dateLabel = (0, date_fns.format)(day.date, "EEEE, d MMMM yyyy", locale ? { locale } : void 0);
1033
+ const label = (0, _super_calendar_core.dayAccessibilityLabel)({
1034
+ dateLabel,
1035
+ isToday: day.isToday,
1036
+ labels
1037
+ });
1024
1038
  const dayTime = (0, date_fns.startOfDay)(day.date).getTime();
1025
1039
  const inCreate = drag?.kind === "create" && dayTime >= Math.min(drag.anchor, drag.hover) && dayTime <= Math.max(drag.anchor, drag.hover);
1026
1040
  const isDropTarget = drag?.kind === "move" && dayTime === drag.to && drag.to !== drag.from;
@@ -1045,7 +1059,13 @@ function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short"
1045
1059
  ...dayData,
1046
1060
  tabIndex: keyboardDayNavigation ? day.id === focusKey ? 0 : -1 : void 0,
1047
1061
  "aria-disabled": day.isDisabled || void 0,
1048
- "aria-label": label,
1062
+ "aria-label": (0, _super_calendar_core.dayAccessibilityLabel)({
1063
+ dateLabel,
1064
+ isToday: day.isToday,
1065
+ isSelected: day.isSelected,
1066
+ eventCount: dayEvents.length,
1067
+ labels
1068
+ }),
1049
1069
  ...dayCellProps,
1050
1070
  style: dragWired ? {
1051
1071
  ...dayCellProps.style,
@@ -1161,7 +1181,7 @@ function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short"
1161
1181
  }
1162
1182
  },
1163
1183
  ...slot("more", moreButtonDefault(theme)),
1164
- "aria-label": `${hiddenEvents.length} more events, ${dayLabel}`,
1184
+ "aria-label": `${labels.moreEvents(hiddenEvents.length)}, ${dayLabel}`,
1165
1185
  "aria-expanded": onPressMore ? void 0 : moreOpenFor === day.id,
1166
1186
  children: moreLabel.replace("{moreCount}", String(hiddenEvents.length))
1167
1187
  }) : null,
@@ -1378,8 +1398,9 @@ function DefaultDomEvent({ event, mode, isAllDay, boxHeight, ampm = false, theme
1378
1398
  * <TimeGrid mode="week" date={new Date()} events={events} />
1379
1399
  * ```
1380
1400
  */
1381
- function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStartsOn = 0, weekdayFormat = "short", hourHeight: initialHourHeight = 48, scrollOffsetMinutes = 480, zoomable = true, minHourHeight = 24, maxHourHeight = 160, minEventHeight = DEFAULT_MIN_EVENT_HEIGHT, eventGap = DEFAULT_EVENT_GAP, dragStepMinutes = 15, ampm = false, timeslots = 1, minHour = 0, maxHour = 24, hideHours = false, showWeekNumber = false, weekNumberPrefix = "W", hiddenDays, keyboardEventNavigation = false, businessHours, renderBusinessHours, renderBackgroundEvent, showNowIndicator = true, highlightWeekends = true, eventStartEditable = true, eventDurationEditable = true, eventOverlap = true, now: nowProp, timeZone, showAllDayEventCell = true, showAllDayLabel = false, locale, theme: themeOverrides, height = 600, renderEvent, eventAccessibilityLabel, hourComponent, onPressEvent, onPressDateHeader, onPressCell, onCreateEvent, onDragStart, onDragEvent, onChangeDate, className, style, classNames, styles }) {
1401
+ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStartsOn = 0, weekdayFormat = "short", hourHeight: initialHourHeight = 48, scrollOffsetMinutes = 480, zoomable = true, minHourHeight = 24, maxHourHeight = 160, minEventHeight = DEFAULT_MIN_EVENT_HEIGHT, eventGap = DEFAULT_EVENT_GAP, dragStepMinutes = 15, ampm = false, timeslots = 1, minHour = 0, maxHour = 24, hideHours = false, showWeekNumber = false, weekNumberPrefix = "W", hiddenDays, keyboardEventNavigation = false, businessHours, renderBusinessHours, renderBackgroundEvent, showNowIndicator = true, highlightWeekends = true, eventStartEditable = true, eventDurationEditable = true, eventOverlap = true, now: nowProp, timeZone, showAllDayEventCell = true, showAllDayLabel = false, labels: labelsProp, locale, theme: themeOverrides, height = 600, renderEvent, eventAccessibilityLabel, hourComponent, onPressEvent, onPressDateHeader, onPressCell, onCreateEvent, onDragStart, onDragEvent, onChangeDate, className, style, classNames, styles }) {
1382
1402
  const theme = (0, react.useMemo)(() => mergeDomTheme(themeOverrides), [themeOverrides]);
1403
+ const labels = (0, react.useMemo)(() => (0, _super_calendar_core.resolveCalendarLabels)(labelsProp), [labelsProp]);
1383
1404
  const slot = createSlots({
1384
1405
  classNames,
1385
1406
  styles
@@ -1618,11 +1639,12 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
1618
1639
  const origin = dragOrigin.current;
1619
1640
  const originIndex = origin?.dayIndex ?? 0;
1620
1641
  let base = null;
1621
- if (d.kind === "move") if (pagedRef.current) {
1622
- const day = dayAt(e.clientX, e.clientY);
1623
- base = day ? (0, date_fns.startOfDay)(day) : null;
1624
- } else base = (0, date_fns.startOfDay)(daysRef.current[originIndex + d.dayDelta] ?? daysRef.current[originIndex]);
1625
- else base = (0, date_fns.startOfDay)(daysRef.current[originIndex] ?? daysRef.current[0]);
1642
+ if (d.kind === "move") {
1643
+ if (pagedRef.current) {
1644
+ const day = dayAt(e.clientX, e.clientY);
1645
+ base = day ? (0, date_fns.startOfDay)(day) : null;
1646
+ } else base = (0, date_fns.startOfDay)(daysRef.current[originIndex + d.dayDelta] ?? daysRef.current[originIndex]);
1647
+ } else base = (0, date_fns.startOfDay)(daysRef.current[originIndex] ?? daysRef.current[0]);
1626
1648
  if (base && held && origin) {
1627
1649
  const segmentStart = (0, date_fns.addMinutes)(base, Math.round(d.startHours * 60));
1628
1650
  const segmentEnd = (0, date_fns.addMinutes)(base, Math.round((d.startHours + d.durationHours) * 60));
@@ -1938,7 +1960,7 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
1938
1960
  const inner = /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
1939
1961
  /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
1940
1962
  style: VISUALLY_HIDDEN,
1941
- children: dateLabel
1963
+ children: today ? `${dateLabel}, ${labels.today}` : dateLabel
1942
1964
  }),
1943
1965
  /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
1944
1966
  "aria-hidden": true,
@@ -2003,7 +2025,7 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
2003
2025
  padding: "4px 6px 0 0"
2004
2026
  }
2005
2027
  }),
2006
- children: showAllDayLabel ? "all-day" : null
2028
+ children: showAllDayLabel ? labels.allDay : null
2007
2029
  }), allDayByDay.map((list, i) => {
2008
2030
  const dayStart = (0, date_fns.startOfDay)(days[i]);
2009
2031
  const dayEnd = (0, date_fns.addDays)(dayStart, 1);
@@ -2039,7 +2061,8 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
2039
2061
  isAllDay: true,
2040
2062
  start: event.start,
2041
2063
  end: event.end,
2042
- ampm
2064
+ ampm,
2065
+ labels
2043
2066
  }),
2044
2067
  ...slot("allDayEvent", { base: {
2045
2068
  border: "none",
@@ -2237,7 +2260,8 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
2237
2260
  isAllDay: false,
2238
2261
  start: pe.event.start,
2239
2262
  end: pe.event.end,
2240
- ampm
2263
+ ampm,
2264
+ labels
2241
2265
  }),
2242
2266
  onKeyDown: (e) => {
2243
2267
  if (e.key === "Enter" || e.key === " ") {
@@ -2462,7 +2486,7 @@ function pageStep(mode, date, direction, weekStartsOn, numberOfDays) {
2462
2486
  * <Calendar mode="week" date={new Date()} events={events} />
2463
2487
  * ```
2464
2488
  */
2465
- function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0, hiddenDays, now, numberOfDays, locale, timeZone, theme, height, className, style, onPressEvent, eventAccessibilityLabel, ampm, hourHeight, minEventHeight, eventGap, scrollOffsetMinutes, timeslots, minHour, maxHour, hideHours, showWeekNumber, weekNumberPrefix, businessHours, renderBusinessHours, renderBackgroundEvent, showNowIndicator, showAllDayEventCell, showAllDayLabel, highlightWeekends, eventStartEditable, eventDurationEditable, eventOverlap, dragStepMinutes, onPressCell, onCreateEvent, onDragStart, onDragEvent, onPressDateHeader, renderTimeEvent, hourComponent, keyboardEventNavigation, maxVisibleEventCount, moreLabel, showAdjacentMonths, showTitle, weekdayFormat, fillCellOnSelection, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, keyboardDayNavigation, onPressDay, onSelectDrag, onPressMonth, onPressMore, renderMonthEvent, renderScheduleEvent, classNames, styles }) {
2489
+ function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0, hiddenDays, now, numberOfDays, locale, timeZone, theme, height, className, style, onPressEvent, eventAccessibilityLabel, ampm, hourHeight, minEventHeight, eventGap, scrollOffsetMinutes, timeslots, minHour, maxHour, hideHours, showWeekNumber, weekNumberPrefix, businessHours, renderBusinessHours, renderBackgroundEvent, showNowIndicator, showAllDayEventCell, showAllDayLabel, highlightWeekends, eventStartEditable, eventDurationEditable, eventOverlap, dragStepMinutes, onPressCell, onCreateEvent, onDragStart, onDragEvent, onPressDateHeader, renderTimeEvent, hourComponent, keyboardEventNavigation, maxVisibleEventCount, moreLabel, labels, showAdjacentMonths, showTitle, weekdayFormat, fillCellOnSelection, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, keyboardDayNavigation, onPressDay, onSelectDrag, onPressMonth, onPressMore, renderMonthEvent, renderScheduleEvent, classNames, styles }) {
2466
2490
  const displayEvents = (0, react.useMemo)(() => {
2467
2491
  let out = events ?? EMPTY_EVENTS;
2468
2492
  if (out.some((e) => e.recurrence)) {
@@ -2497,6 +2521,7 @@ function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0,
2497
2521
  weekStartsOn,
2498
2522
  hiddenDays,
2499
2523
  locale,
2524
+ labels,
2500
2525
  theme,
2501
2526
  className,
2502
2527
  style: height != null ? {
@@ -2539,6 +2564,7 @@ function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0,
2539
2564
  weekdayFormat,
2540
2565
  highlightWeekends,
2541
2566
  locale,
2567
+ labels,
2542
2568
  theme,
2543
2569
  className,
2544
2570
  style,
@@ -2579,6 +2605,7 @@ function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0,
2579
2605
  weekdayFormat,
2580
2606
  numberOfDays,
2581
2607
  locale,
2608
+ labels,
2582
2609
  theme,
2583
2610
  height,
2584
2611
  className,
@@ -2632,7 +2659,7 @@ function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0,
2632
2659
  * Legend List's DOM renderer and the library's headless grid logic. Selection is
2633
2660
  * controlled, pass `selectedRange` (or `selectedDates`) and handle `onPressDay`.
2634
2661
  */
2635
- function MonthList({ date, pastMonths = 1, futureMonths = 12, weekdayFormat = "short", highlightWeekends = true, weekStartsOn = 0, events, renderEvent, eventAccessibilityLabel, maxVisibleEventCount, moreLabel, onPressEvent, onPressMore, selectedRange, selectedDates, fillCellOnSelection = false, locale, theme: themeOverrides, height = 480, minDate, maxDate, isDateDisabled, keyboardDayNavigation, onPressDay, className, style, classNames, styles }) {
2662
+ function MonthList({ date, pastMonths = 1, futureMonths = 12, weekdayFormat = "short", highlightWeekends = true, weekStartsOn = 0, events, renderEvent, eventAccessibilityLabel, maxVisibleEventCount, moreLabel, labels, onPressEvent, onPressMore, selectedRange, selectedDates, fillCellOnSelection = false, locale, theme: themeOverrides, height = 480, minDate, maxDate, isDateDisabled, keyboardDayNavigation, onPressDay, className, style, classNames, styles }) {
2636
2663
  const theme = (0, react.useMemo)(() => mergeDomTheme(themeOverrides), [themeOverrides]);
2637
2664
  const slot = createSlots({
2638
2665
  classNames,
@@ -2720,6 +2747,7 @@ function MonthList({ date, pastMonths = 1, futureMonths = 12, weekdayFormat = "s
2720
2747
  eventAccessibilityLabel,
2721
2748
  maxVisibleEventCount,
2722
2749
  moreLabel,
2750
+ labels,
2723
2751
  onPressEvent,
2724
2752
  onPressMore,
2725
2753
  selectedRange,
@@ -3753,6 +3781,12 @@ Object.defineProperty(exports, "daySelectionState", {
3753
3781
  return _super_calendar_core.daySelectionState;
3754
3782
  }
3755
3783
  });
3784
+ Object.defineProperty(exports, "defaultCalendarLabels", {
3785
+ enumerable: true,
3786
+ get: function() {
3787
+ return _super_calendar_core.defaultCalendarLabels;
3788
+ }
3789
+ });
3756
3790
  exports.defaultDomTheme = defaultDomTheme;
3757
3791
  Object.defineProperty(exports, "expandRecurringEvents", {
3758
3792
  enumerable: true,
package/dist/index.mjs CHANGED
@@ -1,7 +1,7 @@
1
1
  import { LegendList } from "@legendapp/list/react";
2
2
  import { addDays, addMinutes, addMonths, addYears, differenceInCalendarDays, endOfDay, endOfMonth, endOfWeek, endOfYear, format, getISOWeek, isSameDay, isSameMonth, startOfDay, startOfMonth, startOfWeek, startOfYear } from "date-fns";
3
3
  import { useEffect, useId, useMemo, useRef, useState } from "react";
4
- import { backgroundBandsForDay, backgroundBandsForDay as backgroundBandsForDay$1, bandRounding, buildMonthGrid, buildMonthGrid as buildMonthGrid$1, buildMonthWeeks, cellRangeFromDrag, clampMoveStartMinutes, closedHourBands, compareDayEvents, darkColors, dayBadgeKind, daySelectionState, daySelectionState as daySelectionState$1, eventAccessibilityLabel, eventChipLayout, eventTimeLabel, eventsInTimeZone, expandRecurringEvents, expandRecurringEvents as expandRecurringEvents$1, filterHiddenDays, formatHour, getIsToday, getViewDays, getViewDays as getViewDays$1, getWeekDays, getYearMonths, groupEventsByDay, isAllDayEvent, isAllDayEvent as isAllDayEvent$1, isBackgroundEvent, isBackgroundEvent as isBackgroundEvent$1, isDateSelectable, isRangeEndpoint, isSameCalendarDay, isWeekend, isWithinDateRange, layoutDayEvents, layoutDayEvents as layoutDayEvents$1, layoutMonthWeek, layoutMonthWeek as layoutMonthWeek$1, lightColors, monthCreateRange, monthDropBounds, nextDateRange, nextDateRange as nextDateRange$1, overlapsOtherEvents, pageStepDays, parseICalendar, rangeBandKind, titleNumberOfLines, toICalendar, useDateRange, useEventSource, useMonthGrid, useNow, useNow as useNow$1, weekdayFormatToken, weekdayFormatToken as weekdayFormatToken$1 } from "@super-calendar/core";
4
+ import { backgroundBandsForDay, backgroundBandsForDay as backgroundBandsForDay$1, bandRounding, buildMonthGrid, buildMonthGrid as buildMonthGrid$1, buildMonthWeeks, cellRangeFromDrag, clampMoveStartMinutes, closedHourBands, compareDayEvents, darkColors, dayAccessibilityLabel, dayBadgeKind, daySelectionState, daySelectionState as daySelectionState$1, defaultCalendarLabels, eventAccessibilityLabel, eventChipLayout, eventTimeLabel, eventsInTimeZone, expandRecurringEvents, expandRecurringEvents as expandRecurringEvents$1, filterHiddenDays, formatHour, getIsToday, getViewDays, getViewDays as getViewDays$1, getWeekDays, getYearMonths, groupEventsByDay, isAllDayEvent, isAllDayEvent as isAllDayEvent$1, isBackgroundEvent, isBackgroundEvent as isBackgroundEvent$1, isDateSelectable, isRangeEndpoint, isSameCalendarDay, isWeekend, isWithinDateRange, layoutDayEvents, layoutDayEvents as layoutDayEvents$1, layoutMonthWeek, layoutMonthWeek as layoutMonthWeek$1, lightColors, monthCreateRange, monthDropBounds, nextDateRange, nextDateRange as nextDateRange$1, overlapsOtherEvents, pageStepDays, parseICalendar, rangeBandKind, resolveCalendarLabels, titleNumberOfLines, toICalendar, useDateRange, useEventSource, useMonthGrid, useNow, useNow as useNow$1, weekdayFormatToken, weekdayFormatToken as weekdayFormatToken$1 } from "@super-calendar/core";
5
5
  import { Fragment, jsx, jsxs } from "react/jsx-runtime";
6
6
  //#region src/slots.ts
7
7
  /** Join truthy class names (a dependency-free clsx-lite). */
@@ -240,8 +240,9 @@ function Agenda({ events, locale, ampm = false, activeDate, theme: themeOverride
240
240
  * highlighted and a dot under days that hold events. It's the view `Calendar`
241
241
  * renders for `mode="year"`.
242
242
  */
243
- function YearView({ date, events, weekStartsOn = 0, hiddenDays, locale, activeDate, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, minMonthWidth = 150, onPressDay, onPressMonth, onSelectDrag, onCreateEvent, theme: themeOverrides, className, style, classNames, styles }) {
243
+ function YearView({ date, events, weekStartsOn = 0, hiddenDays, locale, labels: labelsProp, activeDate, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, minMonthWidth = 150, onPressDay, onPressMonth, onSelectDrag, onCreateEvent, theme: themeOverrides, className, style, classNames, styles }) {
244
244
  const theme = useMemo(() => mergeDomTheme(themeOverrides), [themeOverrides]);
245
+ const labels = useMemo(() => resolveCalendarLabels(labelsProp), [labelsProp]);
245
246
  const slot = createSlots({
246
247
  classNames,
247
248
  styles
@@ -399,7 +400,14 @@ function YearView({ date, events, weekStartsOn = 0, hiddenDays, locale, activeDa
399
400
  });
400
401
  const dayTime = startOfDay(day).getTime();
401
402
  const inCreate = creating != null && dayTime >= Math.min(creating.anchor, creating.hover) && dayTime <= Math.max(creating.anchor, creating.hover);
402
- const label = `${format(day, "EEEE, d LLLL yyyy", { locale })}${isToday ? ", today" : ""}${state.isSelected ? ", selected" : ""}${state.isDisabled ? ", unavailable" : ""}${hasEvents ? ", has events" : ""}`;
403
+ const label = dayAccessibilityLabel({
404
+ dateLabel: format(day, "EEEE, d LLLL yyyy", { locale }),
405
+ isToday,
406
+ isSelected: state.isSelected,
407
+ isDisabled: state.isDisabled,
408
+ hasEvents,
409
+ labels
410
+ });
403
411
  const badge = dayBadgeKind(state, isHighlighted);
404
412
  const daySlot = slot("day", {
405
413
  base: {
@@ -542,7 +550,6 @@ const EMPTY_LAYOUT = {
542
550
  segments: [],
543
551
  laneCount: 0
544
552
  };
545
- const DATE_ROW = 24;
546
553
  const CHIP_HEIGHT = 18;
547
554
  const CHIP_GAP = 2;
548
555
  const CELL_PAD = 4;
@@ -582,7 +589,7 @@ function rangeBandDefault(day, theme, fillCell, eventsMode) {
582
589
  const kind = rangeBandKind(day, fillCell);
583
590
  if (kind === "none") return null;
584
591
  const fill = kind === "fill";
585
- const badgeSize = eventsMode ? DATE_ROW - 2 : theme.dayBadgeSize;
592
+ const badgeSize = eventsMode ? 22 : theme.dayBadgeSize;
586
593
  const bandHeight = eventsMode ? badgeSize : theme.rangeBandHeight;
587
594
  const inset = fill ? 0 : eventsMode ? CELL_PAD : Math.max(0, (theme.cellHeight - bandHeight) / 2);
588
595
  const radius = fill ? 0 : bandHeight / 2;
@@ -661,8 +668,8 @@ function compactBadgeDefault(day, theme) {
661
668
  position: "relative",
662
669
  zIndex: 1,
663
670
  alignSelf: "flex-end",
664
- width: DATE_ROW - 2,
665
- height: DATE_ROW - 2,
671
+ width: 22,
672
+ height: 22,
666
673
  borderRadius: "50%",
667
674
  display: "flex",
668
675
  alignItems: "center",
@@ -748,8 +755,9 @@ function collectRowEvents(week, eventsByDay) {
748
755
  * <MonthView date={new Date()} events={events} onPressDay={(d) => setDate(d)} />
749
756
  * ```
750
757
  */
751
- function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short", events, eventsByDay: eventsByDayProp, renderEvent, eventAccessibilityLabel, maxVisibleEventCount = 3, moreLabel = "{moreCount} More", onPressEvent, onPressMore, selectedRange, selectedDates, showAdjacentMonths = true, highlightWeekends = true, fillCellOnSelection = false, showTitle = true, showWeekdays = true, locale, theme: themeOverrides, minDate, maxDate, isDateDisabled, onPressDay, onPressCell, onCreateEvent, onSelectDrag, onDragEvent, onDragStart, eventStartEditable = true, eventOverlap = true, keyboardDayNavigation = false, className, style, classNames, styles }) {
758
+ function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short", events, eventsByDay: eventsByDayProp, renderEvent, eventAccessibilityLabel, maxVisibleEventCount = 3, moreLabel = "{moreCount} More", labels: labelsProp, onPressEvent, onPressMore, selectedRange, selectedDates, showAdjacentMonths = true, highlightWeekends = true, fillCellOnSelection = false, showTitle = true, showWeekdays = true, locale, theme: themeOverrides, minDate, maxDate, isDateDisabled, onPressDay, onPressCell, onCreateEvent, onSelectDrag, onDragEvent, onDragStart, eventStartEditable = true, eventOverlap = true, keyboardDayNavigation = false, className, style, classNames, styles }) {
752
759
  const theme = useMemo(() => mergeDomTheme(themeOverrides), [themeOverrides]);
760
+ const labels = useMemo(() => resolveCalendarLabels(labelsProp), [labelsProp]);
753
761
  const slot = createSlots({
754
762
  classNames,
755
763
  styles
@@ -834,7 +842,8 @@ function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short"
834
842
  const [focusedDate, setFocusedDate] = useState(initialFocus);
835
843
  const initialFocusRef = useRef(initialFocus);
836
844
  initialFocusRef.current = initialFocus;
837
- useEffect(() => setFocusedDate(initialFocusRef.current), [format(date, "yyyy-MM")]);
845
+ const monthKey = format(date, "yyyy-MM");
846
+ useEffect(() => setFocusedDate(initialFocusRef.current), [monthKey]);
838
847
  const [hoveredKey, setHoveredKey] = useState(null);
839
848
  const gridRef = useRef(null);
840
849
  const focusKey = format(focusedDate, "yyyy-MM-dd");
@@ -1019,7 +1028,12 @@ function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short"
1019
1028
  style: { height: cellHeight }
1020
1029
  }, day.id);
1021
1030
  const band = rangeBandDefault(day, theme, fillCellOnSelection, eventsMode);
1022
- const label = format(day.date, "EEEE, d MMMM yyyy", locale ? { locale } : void 0);
1031
+ const dateLabel = format(day.date, "EEEE, d MMMM yyyy", locale ? { locale } : void 0);
1032
+ const label = dayAccessibilityLabel({
1033
+ dateLabel,
1034
+ isToday: day.isToday,
1035
+ labels
1036
+ });
1023
1037
  const dayTime = startOfDay(day.date).getTime();
1024
1038
  const inCreate = drag?.kind === "create" && dayTime >= Math.min(drag.anchor, drag.hover) && dayTime <= Math.max(drag.anchor, drag.hover);
1025
1039
  const isDropTarget = drag?.kind === "move" && dayTime === drag.to && drag.to !== drag.from;
@@ -1044,7 +1058,13 @@ function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short"
1044
1058
  ...dayData,
1045
1059
  tabIndex: keyboardDayNavigation ? day.id === focusKey ? 0 : -1 : void 0,
1046
1060
  "aria-disabled": day.isDisabled || void 0,
1047
- "aria-label": label,
1061
+ "aria-label": dayAccessibilityLabel({
1062
+ dateLabel,
1063
+ isToday: day.isToday,
1064
+ isSelected: day.isSelected,
1065
+ eventCount: dayEvents.length,
1066
+ labels
1067
+ }),
1048
1068
  ...dayCellProps,
1049
1069
  style: dragWired ? {
1050
1070
  ...dayCellProps.style,
@@ -1160,7 +1180,7 @@ function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short"
1160
1180
  }
1161
1181
  },
1162
1182
  ...slot("more", moreButtonDefault(theme)),
1163
- "aria-label": `${hiddenEvents.length} more events, ${dayLabel}`,
1183
+ "aria-label": `${labels.moreEvents(hiddenEvents.length)}, ${dayLabel}`,
1164
1184
  "aria-expanded": onPressMore ? void 0 : moreOpenFor === day.id,
1165
1185
  children: moreLabel.replace("{moreCount}", String(hiddenEvents.length))
1166
1186
  }) : null,
@@ -1377,8 +1397,9 @@ function DefaultDomEvent({ event, mode, isAllDay, boxHeight, ampm = false, theme
1377
1397
  * <TimeGrid mode="week" date={new Date()} events={events} />
1378
1398
  * ```
1379
1399
  */
1380
- function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStartsOn = 0, weekdayFormat = "short", hourHeight: initialHourHeight = 48, scrollOffsetMinutes = 480, zoomable = true, minHourHeight = 24, maxHourHeight = 160, minEventHeight = DEFAULT_MIN_EVENT_HEIGHT, eventGap = DEFAULT_EVENT_GAP, dragStepMinutes = 15, ampm = false, timeslots = 1, minHour = 0, maxHour = 24, hideHours = false, showWeekNumber = false, weekNumberPrefix = "W", hiddenDays, keyboardEventNavigation = false, businessHours, renderBusinessHours, renderBackgroundEvent, showNowIndicator = true, highlightWeekends = true, eventStartEditable = true, eventDurationEditable = true, eventOverlap = true, now: nowProp, timeZone, showAllDayEventCell = true, showAllDayLabel = false, locale, theme: themeOverrides, height = 600, renderEvent, eventAccessibilityLabel: eventAccessibilityLabel$1, hourComponent, onPressEvent, onPressDateHeader, onPressCell, onCreateEvent, onDragStart, onDragEvent, onChangeDate, className, style, classNames, styles }) {
1400
+ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStartsOn = 0, weekdayFormat = "short", hourHeight: initialHourHeight = 48, scrollOffsetMinutes = 480, zoomable = true, minHourHeight = 24, maxHourHeight = 160, minEventHeight = DEFAULT_MIN_EVENT_HEIGHT, eventGap = DEFAULT_EVENT_GAP, dragStepMinutes = 15, ampm = false, timeslots = 1, minHour = 0, maxHour = 24, hideHours = false, showWeekNumber = false, weekNumberPrefix = "W", hiddenDays, keyboardEventNavigation = false, businessHours, renderBusinessHours, renderBackgroundEvent, showNowIndicator = true, highlightWeekends = true, eventStartEditable = true, eventDurationEditable = true, eventOverlap = true, now: nowProp, timeZone, showAllDayEventCell = true, showAllDayLabel = false, labels: labelsProp, locale, theme: themeOverrides, height = 600, renderEvent, eventAccessibilityLabel: eventAccessibilityLabel$1, hourComponent, onPressEvent, onPressDateHeader, onPressCell, onCreateEvent, onDragStart, onDragEvent, onChangeDate, className, style, classNames, styles }) {
1381
1401
  const theme = useMemo(() => mergeDomTheme(themeOverrides), [themeOverrides]);
1402
+ const labels = useMemo(() => resolveCalendarLabels(labelsProp), [labelsProp]);
1382
1403
  const slot = createSlots({
1383
1404
  classNames,
1384
1405
  styles
@@ -1617,11 +1638,12 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
1617
1638
  const origin = dragOrigin.current;
1618
1639
  const originIndex = origin?.dayIndex ?? 0;
1619
1640
  let base = null;
1620
- if (d.kind === "move") if (pagedRef.current) {
1621
- const day = dayAt(e.clientX, e.clientY);
1622
- base = day ? startOfDay(day) : null;
1623
- } else base = startOfDay(daysRef.current[originIndex + d.dayDelta] ?? daysRef.current[originIndex]);
1624
- else base = startOfDay(daysRef.current[originIndex] ?? daysRef.current[0]);
1641
+ if (d.kind === "move") {
1642
+ if (pagedRef.current) {
1643
+ const day = dayAt(e.clientX, e.clientY);
1644
+ base = day ? startOfDay(day) : null;
1645
+ } else base = startOfDay(daysRef.current[originIndex + d.dayDelta] ?? daysRef.current[originIndex]);
1646
+ } else base = startOfDay(daysRef.current[originIndex] ?? daysRef.current[0]);
1625
1647
  if (base && held && origin) {
1626
1648
  const segmentStart = addMinutes(base, Math.round(d.startHours * 60));
1627
1649
  const segmentEnd = addMinutes(base, Math.round((d.startHours + d.durationHours) * 60));
@@ -1937,7 +1959,7 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
1937
1959
  const inner = /* @__PURE__ */ jsxs(Fragment, { children: [
1938
1960
  /* @__PURE__ */ jsx("span", {
1939
1961
  style: VISUALLY_HIDDEN,
1940
- children: dateLabel
1962
+ children: today ? `${dateLabel}, ${labels.today}` : dateLabel
1941
1963
  }),
1942
1964
  /* @__PURE__ */ jsx("span", {
1943
1965
  "aria-hidden": true,
@@ -2002,7 +2024,7 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
2002
2024
  padding: "4px 6px 0 0"
2003
2025
  }
2004
2026
  }),
2005
- children: showAllDayLabel ? "all-day" : null
2027
+ children: showAllDayLabel ? labels.allDay : null
2006
2028
  }), allDayByDay.map((list, i) => {
2007
2029
  const dayStart = startOfDay(days[i]);
2008
2030
  const dayEnd = addDays(dayStart, 1);
@@ -2038,7 +2060,8 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
2038
2060
  isAllDay: true,
2039
2061
  start: event.start,
2040
2062
  end: event.end,
2041
- ampm
2063
+ ampm,
2064
+ labels
2042
2065
  }),
2043
2066
  ...slot("allDayEvent", { base: {
2044
2067
  border: "none",
@@ -2236,7 +2259,8 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
2236
2259
  isAllDay: false,
2237
2260
  start: pe.event.start,
2238
2261
  end: pe.event.end,
2239
- ampm
2262
+ ampm,
2263
+ labels
2240
2264
  }),
2241
2265
  onKeyDown: (e) => {
2242
2266
  if (e.key === "Enter" || e.key === " ") {
@@ -2461,7 +2485,7 @@ function pageStep(mode, date, direction, weekStartsOn, numberOfDays) {
2461
2485
  * <Calendar mode="week" date={new Date()} events={events} />
2462
2486
  * ```
2463
2487
  */
2464
- function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0, hiddenDays, now, numberOfDays, locale, timeZone, theme, height, className, style, onPressEvent, eventAccessibilityLabel, ampm, hourHeight, minEventHeight, eventGap, scrollOffsetMinutes, timeslots, minHour, maxHour, hideHours, showWeekNumber, weekNumberPrefix, businessHours, renderBusinessHours, renderBackgroundEvent, showNowIndicator, showAllDayEventCell, showAllDayLabel, highlightWeekends, eventStartEditable, eventDurationEditable, eventOverlap, dragStepMinutes, onPressCell, onCreateEvent, onDragStart, onDragEvent, onPressDateHeader, renderTimeEvent, hourComponent, keyboardEventNavigation, maxVisibleEventCount, moreLabel, showAdjacentMonths, showTitle, weekdayFormat, fillCellOnSelection, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, keyboardDayNavigation, onPressDay, onSelectDrag, onPressMonth, onPressMore, renderMonthEvent, renderScheduleEvent, classNames, styles }) {
2488
+ function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0, hiddenDays, now, numberOfDays, locale, timeZone, theme, height, className, style, onPressEvent, eventAccessibilityLabel, ampm, hourHeight, minEventHeight, eventGap, scrollOffsetMinutes, timeslots, minHour, maxHour, hideHours, showWeekNumber, weekNumberPrefix, businessHours, renderBusinessHours, renderBackgroundEvent, showNowIndicator, showAllDayEventCell, showAllDayLabel, highlightWeekends, eventStartEditable, eventDurationEditable, eventOverlap, dragStepMinutes, onPressCell, onCreateEvent, onDragStart, onDragEvent, onPressDateHeader, renderTimeEvent, hourComponent, keyboardEventNavigation, maxVisibleEventCount, moreLabel, labels, showAdjacentMonths, showTitle, weekdayFormat, fillCellOnSelection, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, keyboardDayNavigation, onPressDay, onSelectDrag, onPressMonth, onPressMore, renderMonthEvent, renderScheduleEvent, classNames, styles }) {
2465
2489
  const displayEvents = useMemo(() => {
2466
2490
  let out = events ?? EMPTY_EVENTS;
2467
2491
  if (out.some((e) => e.recurrence)) {
@@ -2496,6 +2520,7 @@ function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0,
2496
2520
  weekStartsOn,
2497
2521
  hiddenDays,
2498
2522
  locale,
2523
+ labels,
2499
2524
  theme,
2500
2525
  className,
2501
2526
  style: height != null ? {
@@ -2538,6 +2563,7 @@ function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0,
2538
2563
  weekdayFormat,
2539
2564
  highlightWeekends,
2540
2565
  locale,
2566
+ labels,
2541
2567
  theme,
2542
2568
  className,
2543
2569
  style,
@@ -2578,6 +2604,7 @@ function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0,
2578
2604
  weekdayFormat,
2579
2605
  numberOfDays,
2580
2606
  locale,
2607
+ labels,
2581
2608
  theme,
2582
2609
  height,
2583
2610
  className,
@@ -2631,7 +2658,7 @@ function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0,
2631
2658
  * Legend List's DOM renderer and the library's headless grid logic. Selection is
2632
2659
  * controlled, pass `selectedRange` (or `selectedDates`) and handle `onPressDay`.
2633
2660
  */
2634
- function MonthList({ date, pastMonths = 1, futureMonths = 12, weekdayFormat = "short", highlightWeekends = true, weekStartsOn = 0, events, renderEvent, eventAccessibilityLabel, maxVisibleEventCount, moreLabel, onPressEvent, onPressMore, selectedRange, selectedDates, fillCellOnSelection = false, locale, theme: themeOverrides, height = 480, minDate, maxDate, isDateDisabled, keyboardDayNavigation, onPressDay, className, style, classNames, styles }) {
2661
+ function MonthList({ date, pastMonths = 1, futureMonths = 12, weekdayFormat = "short", highlightWeekends = true, weekStartsOn = 0, events, renderEvent, eventAccessibilityLabel, maxVisibleEventCount, moreLabel, labels, onPressEvent, onPressMore, selectedRange, selectedDates, fillCellOnSelection = false, locale, theme: themeOverrides, height = 480, minDate, maxDate, isDateDisabled, keyboardDayNavigation, onPressDay, className, style, classNames, styles }) {
2635
2662
  const theme = useMemo(() => mergeDomTheme(themeOverrides), [themeOverrides]);
2636
2663
  const slot = createSlots({
2637
2664
  classNames,
@@ -2719,6 +2746,7 @@ function MonthList({ date, pastMonths = 1, futureMonths = 12, weekdayFormat = "s
2719
2746
  eventAccessibilityLabel,
2720
2747
  maxVisibleEventCount,
2721
2748
  moreLabel,
2749
+ labels,
2722
2750
  onPressEvent,
2723
2751
  onPressMore,
2724
2752
  selectedRange,
@@ -3724,4 +3752,4 @@ function ResourceTimeline({ date, orientation = "horizontal", resources: allReso
3724
3752
  });
3725
3753
  }
3726
3754
  //#endregion
3727
- export { Agenda, Calendar, DatePicker, DateRangePicker, MonthList, MonthView, ResourceTimeline, TimeGrid, YearView, backgroundBandsForDay, buildMonthGrid, darkDomTheme, daySelectionState, defaultDomTheme, expandRecurringEvents, getViewDays, isAllDayEvent, isBackgroundEvent, isDateSelectable, isRangeEndpoint, isWithinDateRange, layoutDayEvents, layoutMonthWeek, mergeDomTheme, nextDateRange, parseICalendar, toICalendar, useDateRange, useEventSource, useMonthGrid, useNow, weekdayFormatToken };
3755
+ export { Agenda, Calendar, DatePicker, DateRangePicker, MonthList, MonthView, ResourceTimeline, TimeGrid, YearView, backgroundBandsForDay, buildMonthGrid, darkDomTheme, daySelectionState, defaultCalendarLabels, defaultDomTheme, expandRecurringEvents, getViewDays, isAllDayEvent, isBackgroundEvent, isDateSelectable, isRangeEndpoint, isWithinDateRange, layoutDayEvents, layoutMonthWeek, mergeDomTheme, nextDateRange, parseICalendar, toICalendar, useDateRange, useEventSource, useMonthGrid, useNow, weekdayFormatToken };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@super-calendar/dom",
3
- "version": "2.11.0",
3
+ "version": "2.12.0",
4
4
  "description": "Virtualized month / week / day calendar and date picker for react-dom. No React Native, no react-native-web.",
5
5
  "keywords": [
6
6
  "calendar",
@@ -48,7 +48,7 @@
48
48
  "access": "public"
49
49
  },
50
50
  "dependencies": {
51
- "@super-calendar/core": "2.11.0"
51
+ "@super-calendar/core": "2.12.0"
52
52
  },
53
53
  "peerDependencies": {
54
54
  "@legendapp/list": ">=3",
package/src/Calendar.tsx CHANGED
@@ -33,6 +33,7 @@ import {
33
33
  type WeekdayFormat,
34
34
  type WeekStartsOn,
35
35
  } from "@super-calendar/core";
36
+ import type { CalendarLabels } from "@super-calendar/core";
36
37
  import { Agenda, type AgendaSlot, type DomAgendaEvent } from "./Agenda";
37
38
  import { YearView, type YearViewSlot } from "./YearView";
38
39
  import { type DomMonthEvent, MonthView, type MonthViewSlot } from "./MonthView";
@@ -206,6 +207,8 @@ export interface CalendarProps<T = unknown>
206
207
  maxVisibleEventCount?: number;
207
208
  /** Overflow row template; `{moreCount}` is replaced. */
208
209
  moreLabel?: string;
210
+ /** Translations for the screen-reader words and gutter text; omitted keys use English. */
211
+ labels?: Partial<CalendarLabels>;
209
212
  /** Render neighbouring months' days in the leading/trailing cells (default true). */
210
213
  showAdjacentMonths?: boolean;
211
214
  /**
@@ -359,6 +362,7 @@ export function Calendar<T = unknown>({
359
362
  // month
360
363
  maxVisibleEventCount,
361
364
  moreLabel,
365
+ labels,
362
366
  showAdjacentMonths,
363
367
  showTitle,
364
368
  weekdayFormat,
@@ -419,6 +423,7 @@ export function Calendar<T = unknown>({
419
423
  weekStartsOn={weekStartsOn}
420
424
  hiddenDays={hiddenDays}
421
425
  locale={locale}
426
+ labels={labels}
422
427
  theme={theme}
423
428
  className={className}
424
429
  style={height != null ? { height, ...style } : style}
@@ -464,6 +469,7 @@ export function Calendar<T = unknown>({
464
469
  weekdayFormat={weekdayFormat}
465
470
  highlightWeekends={highlightWeekends}
466
471
  locale={locale}
472
+ labels={labels}
467
473
  theme={theme}
468
474
  className={className}
469
475
  style={style}
@@ -507,6 +513,7 @@ export function Calendar<T = unknown>({
507
513
  weekdayFormat={weekdayFormat}
508
514
  numberOfDays={numberOfDays}
509
515
  locale={locale}
516
+ labels={labels}
510
517
  theme={theme}
511
518
  height={height}
512
519
  className={className}
package/src/MonthList.tsx CHANGED
@@ -13,6 +13,7 @@ import {
13
13
  type WeekdayFormat,
14
14
  type WeekStartsOn,
15
15
  } from "@super-calendar/core";
16
+ import type { CalendarLabels } from "@super-calendar/core";
16
17
  import { type DomMonthEvent, MonthView, type MonthViewSlot } from "./MonthView";
17
18
  import { createSlots, type SlotStyleProps } from "./slots";
18
19
  import { type DomCalendarTheme, mergeDomTheme } from "./theme";
@@ -53,6 +54,8 @@ export interface MonthListProps<T = unknown>
53
54
  maxVisibleEventCount?: number;
54
55
  /** Template for the overflow row; `{moreCount}` is replaced. */
55
56
  moreLabel?: string;
57
+ /** Translations for the screen-reader words and gutter text; omitted keys use English. */
58
+ labels?: Partial<CalendarLabels>;
56
59
  /** Tap an event chip. */
57
60
  onPressEvent?: (event: CalendarEvent<T>) => void;
58
61
  /** Tap the "+N more" overflow row. */
@@ -100,6 +103,7 @@ export function MonthList<T = unknown>({
100
103
  eventAccessibilityLabel,
101
104
  maxVisibleEventCount,
102
105
  moreLabel,
106
+ labels,
103
107
  onPressEvent,
104
108
  onPressMore,
105
109
  selectedRange,
@@ -199,6 +203,7 @@ export function MonthList<T = unknown>({
199
203
  eventAccessibilityLabel={eventAccessibilityLabel}
200
204
  maxVisibleEventCount={maxVisibleEventCount}
201
205
  moreLabel={moreLabel}
206
+ labels={labels}
202
207
  onPressEvent={onPressEvent}
203
208
  onPressMore={onPressMore}
204
209
  selectedRange={selectedRange}
package/src/MonthView.tsx CHANGED
@@ -39,6 +39,11 @@ import {
39
39
  type WeekdayFormat,
40
40
  type WeekStartsOn,
41
41
  } from "@super-calendar/core";
42
+ import {
43
+ type CalendarLabels,
44
+ dayAccessibilityLabel,
45
+ resolveCalendarLabels,
46
+ } from "@super-calendar/core";
42
47
  import { createSlots, dataState, type SlotDefault, type SlotStyleProps } from "./slots";
43
48
  import { type DomCalendarTheme, mergeDomTheme } from "./theme";
44
49
 
@@ -124,6 +129,8 @@ export interface MonthViewProps<T = unknown>
124
129
  maxVisibleEventCount?: number;
125
130
  /** Template for the overflow row; `{moreCount}` is replaced (default "{moreCount} More"). */
126
131
  moreLabel?: string;
132
+ /** Translations for the screen-reader words and gutter text; omitted keys use English. */
133
+ labels?: Partial<CalendarLabels>;
127
134
  /** Tap an event chip. */
128
135
  onPressEvent?: (event: CalendarEvent<T>) => void;
129
136
  /** Tap the "+N more" overflow row. */
@@ -481,6 +488,7 @@ export function MonthView<T = unknown>({
481
488
  eventAccessibilityLabel,
482
489
  maxVisibleEventCount = 3,
483
490
  moreLabel = "{moreCount} More",
491
+ labels: labelsProp,
484
492
  onPressEvent,
485
493
  onPressMore,
486
494
  selectedRange,
@@ -510,6 +518,7 @@ export function MonthView<T = unknown>({
510
518
  styles,
511
519
  }: MonthViewInternalProps<T>): ReactElement {
512
520
  const theme = useMemo(() => mergeDomTheme(themeOverrides), [themeOverrides]);
521
+ const labels = useMemo(() => resolveCalendarLabels(labelsProp), [labelsProp]);
513
522
  const slot = createSlots<MonthViewSlot>({ classNames, styles });
514
523
 
515
524
  // Calendar layout (date in the corner + event chips) is on whenever `events`
@@ -842,11 +851,12 @@ export function MonthView<T = unknown>({
842
851
  );
843
852
  }
844
853
  const band = rangeBandDefault(day, theme, fillCellOnSelection, eventsMode);
845
- const label = format(
854
+ const dateLabel = format(
846
855
  day.date,
847
856
  "EEEE, d MMMM yyyy",
848
857
  locale ? { locale } : undefined,
849
858
  );
859
+ const label = dayAccessibilityLabel({ dateLabel, isToday: day.isToday, labels });
850
860
  const dayTime = startOfDay(day.date).getTime();
851
861
  const inCreate =
852
862
  drag?.kind === "create" &&
@@ -902,7 +912,13 @@ export function MonthView<T = unknown>({
902
912
  {...dayData}
903
913
  tabIndex={keyboardDayNavigation ? (day.id === focusKey ? 0 : -1) : undefined}
904
914
  aria-disabled={day.isDisabled || undefined}
905
- aria-label={label}
915
+ aria-label={dayAccessibilityLabel({
916
+ dateLabel,
917
+ isToday: day.isToday,
918
+ isSelected: day.isSelected,
919
+ eventCount: dayEvents.length,
920
+ labels,
921
+ })}
906
922
  {...dayCellProps}
907
923
  // Dragging disables touch scroll on the cell so a swipe
908
924
  // sketches a span (or carries an event) instead of scrolling
@@ -1065,7 +1081,7 @@ export function MonthView<T = unknown>({
1065
1081
  }
1066
1082
  }}
1067
1083
  {...slot("more", moreButtonDefault(theme))}
1068
- aria-label={`${hiddenEvents.length} more events, ${dayLabel}`}
1084
+ aria-label={`${labels.moreEvents(hiddenEvents.length)}, ${dayLabel}`}
1069
1085
  aria-expanded={onPressMore ? undefined : moreOpenFor === day.id}
1070
1086
  >
1071
1087
  {moreLabel.replace("{moreCount}", String(hiddenEvents.length))}
package/src/TimeGrid.tsx CHANGED
@@ -32,6 +32,8 @@ import {
32
32
  isBackgroundEvent,
33
33
  eventAccessibilityLabel as defaultEventAccessibilityLabel,
34
34
  type EventAccessibilityLabeler,
35
+ type CalendarLabels,
36
+ resolveCalendarLabels,
35
37
  eventChipLayout,
36
38
  eventTimeLabel,
37
39
  formatHour,
@@ -214,6 +216,8 @@ export interface TimeGridProps<T = unknown> extends SlotStyleProps<TimeGridSlot>
214
216
  showAllDayEventCell?: boolean;
215
217
  /** Show the "all-day" text beside the lane (default false). */
216
218
  showAllDayLabel?: boolean;
219
+ /** Translations for the screen-reader words and gutter text; omitted keys use English. */
220
+ labels?: Partial<CalendarLabels>;
217
221
  /** Tint Saturday/Sunday columns with the weekend background (default true). Set
218
222
  * false to treat weekends like any other day. */
219
223
  highlightWeekends?: boolean;
@@ -444,6 +448,7 @@ export function TimeGrid<T = unknown>({
444
448
  timeZone,
445
449
  showAllDayEventCell = true,
446
450
  showAllDayLabel = false,
451
+ labels: labelsProp,
447
452
  locale,
448
453
  theme: themeOverrides,
449
454
  height = 600,
@@ -463,6 +468,7 @@ export function TimeGrid<T = unknown>({
463
468
  styles,
464
469
  }: TimeGridProps<T>): ReactElement {
465
470
  const theme = useMemo(() => mergeDomTheme(themeOverrides), [themeOverrides]);
471
+ const labels = useMemo(() => resolveCalendarLabels(labelsProp), [labelsProp]);
466
472
  const slot = createSlots<TimeGridSlot>({ classNames, styles });
467
473
  const scrollRef = useRef<HTMLDivElement>(null);
468
474
  const dfns = locale ? { locale } : undefined;
@@ -1208,7 +1214,9 @@ export function TimeGrid<T = unknown>({
1208
1214
  });
1209
1215
  const inner = (
1210
1216
  <>
1211
- <span style={VISUALLY_HIDDEN}>{dateLabel}</span>
1217
+ <span style={VISUALLY_HIDDEN}>
1218
+ {today ? `${dateLabel}, ${labels.today}` : dateLabel}
1219
+ </span>
1212
1220
  <span
1213
1221
  aria-hidden
1214
1222
  {...slot("columnHeaderWeekday", { themed: { fontSize: 11, fontWeight: 600 } })}
@@ -1282,7 +1290,7 @@ export function TimeGrid<T = unknown>({
1282
1290
  themed: { fontSize: 10, color: theme.textMuted, padding: "4px 6px 0 0" },
1283
1291
  })}
1284
1292
  >
1285
- {showAllDayLabel ? "all-day" : null}
1293
+ {showAllDayLabel ? labels.allDay : null}
1286
1294
  </div>
1287
1295
  {allDayByDay.map((list, i) => {
1288
1296
  const dayStart = startOfDay(days[i]);
@@ -1331,6 +1339,7 @@ export function TimeGrid<T = unknown>({
1331
1339
  start: event.start,
1332
1340
  end: event.end,
1333
1341
  ampm,
1342
+ labels,
1334
1343
  })
1335
1344
  }
1336
1345
  {...slot("allDayEvent", {
@@ -1587,6 +1596,7 @@ export function TimeGrid<T = unknown>({
1587
1596
  start: pe.event.start,
1588
1597
  end: pe.event.end,
1589
1598
  ampm,
1599
+ labels,
1590
1600
  })
1591
1601
  }
1592
1602
  onKeyDown={(e) => {
package/src/YearView.tsx CHANGED
@@ -21,6 +21,11 @@ import {
21
21
  type WeekStartsOn,
22
22
  weekdayFormatToken,
23
23
  } from "@super-calendar/core";
24
+ import {
25
+ type CalendarLabels,
26
+ dayAccessibilityLabel,
27
+ resolveCalendarLabels,
28
+ } from "@super-calendar/core";
24
29
  import { createSlots, dataState, type SlotStyleProps } from "./slots";
25
30
  import { type DomCalendarTheme, mergeDomTheme } from "./theme";
26
31
 
@@ -54,6 +59,8 @@ export interface YearViewProps<T = unknown>
54
59
  /** Weekdays (0=Sunday…6=Saturday) hidden from the grid, e.g. `[0, 6]` for weekends off. */
55
60
  hiddenDays?: number[];
56
61
  locale?: Locale;
62
+ /** Translations for the screen-reader words; omitted keys use English. */
63
+ labels?: Partial<CalendarLabels>;
57
64
  /** Highlight this date instead of the real "today". */
58
65
  activeDate?: Date;
59
66
  /** A selected span: endpoints get a filled badge, the days between get the range band. */
@@ -104,6 +111,7 @@ export function YearView<T = unknown>({
104
111
  weekStartsOn = 0,
105
112
  hiddenDays,
106
113
  locale,
114
+ labels: labelsProp,
107
115
  activeDate,
108
116
  selectedRange,
109
117
  selectedDates,
@@ -122,6 +130,7 @@ export function YearView<T = unknown>({
122
130
  styles,
123
131
  }: YearViewProps<T>): ReactElement {
124
132
  const theme = useMemo(() => mergeDomTheme(themeOverrides), [themeOverrides]);
133
+ const labels = useMemo(() => resolveCalendarLabels(labelsProp), [labelsProp]);
125
134
  const slot = createSlots<YearViewSlot>({ classNames, styles });
126
135
 
127
136
  // Drag-to-select / drag-to-create: press a day and sweep across others (mini
@@ -302,11 +311,14 @@ export function YearView<T = unknown>({
302
311
  creating != null &&
303
312
  dayTime >= Math.min(creating.anchor, creating.hover) &&
304
313
  dayTime <= Math.max(creating.anchor, creating.hover);
305
- const label = `${format(day, "EEEE, d LLLL yyyy", { locale })}${
306
- isToday ? ", today" : ""
307
- }${state.isSelected ? ", selected" : ""}${
308
- state.isDisabled ? ", unavailable" : ""
309
- }${hasEvents ? ", has events" : ""}`;
314
+ const label = dayAccessibilityLabel({
315
+ dateLabel: format(day, "EEEE, d LLLL yyyy", { locale }),
316
+ isToday,
317
+ isSelected: state.isSelected,
318
+ isDisabled: state.isDisabled,
319
+ hasEvents,
320
+ labels,
321
+ });
310
322
  // Today wins over a selection, matching the month grid.
311
323
  const badge = dayBadgeKind(state, isHighlighted);
312
324
  const daySlot = slot("day", {
package/src/index.ts CHANGED
@@ -63,6 +63,8 @@ export {
63
63
  type BusinessHours,
64
64
  type BusinessHoursBand,
65
65
  type CalendarEvent,
66
+ type CalendarLabels,
67
+ defaultCalendarLabels,
66
68
  type CalendarMode,
67
69
  type DateRange,
68
70
  type DateSelectionConstraints,