@super-calendar/dom 2.11.0 → 2.11.1
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 +24 -14
- package/dist/index.d.ts +24 -14
- package/dist/index.js +57 -23
- package/dist/index.mjs +53 -25
- package/package.json +2 -2
- package/src/Calendar.tsx +7 -0
- package/src/MonthList.tsx +5 -0
- package/src/MonthView.tsx +19 -3
- package/src/TimeGrid.tsx +12 -2
- package/src/YearView.tsx +17 -5
- package/src/index.ts +2 -0
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 {
|
|
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 {
|
|
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 =
|
|
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 ?
|
|
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:
|
|
666
|
-
height:
|
|
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
|
-
|
|
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
|
|
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":
|
|
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}
|
|
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")
|
|
1622
|
-
|
|
1623
|
-
|
|
1624
|
-
|
|
1625
|
-
|
|
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 ?
|
|
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 =
|
|
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 ?
|
|
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:
|
|
665
|
-
height:
|
|
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
|
-
|
|
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
|
|
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":
|
|
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}
|
|
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")
|
|
1621
|
-
|
|
1622
|
-
|
|
1623
|
-
|
|
1624
|
-
|
|
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 ?
|
|
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.
|
|
3
|
+
"version": "2.11.1",
|
|
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.
|
|
51
|
+
"@super-calendar/core": "2.11.1"
|
|
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
|
|
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={
|
|
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}
|
|
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}>
|
|
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 ?
|
|
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 =
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
state.
|
|
309
|
-
|
|
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", {
|