@super-calendar/dom 2.10.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.mjs CHANGED
@@ -1,7 +1,7 @@
1
1
  import { LegendList } from "@legendapp/list/react";
2
2
  import { addDays, addMinutes, addMonths, addYears, differenceInCalendarDays, endOfDay, endOfMonth, endOfWeek, endOfYear, format, getISOWeek, isSameDay, isSameMonth, startOfDay, startOfMonth, startOfWeek, startOfYear } from "date-fns";
3
3
  import { useEffect, useId, useMemo, useRef, useState } from "react";
4
- import { backgroundBandsForDay, backgroundBandsForDay as backgroundBandsForDay$1, bandRounding, buildMonthGrid, buildMonthGrid as buildMonthGrid$1, buildMonthWeeks, cellRangeFromDrag, clampMoveStartMinutes, closedHourBands, compareDayEvents, darkColors, dayBadgeKind, daySelectionState, daySelectionState as daySelectionState$1, eventAccessibilityLabel, eventChipLayout, eventTimeLabel, eventsInTimeZone, expandRecurringEvents, expandRecurringEvents as expandRecurringEvents$1, filterHiddenDays, formatHour, getIsToday, getViewDays, getViewDays as getViewDays$1, getWeekDays, getYearMonths, groupEventsByDay, isAllDayEvent, isAllDayEvent as isAllDayEvent$1, isBackgroundEvent, isBackgroundEvent as isBackgroundEvent$1, isDateSelectable, isRangeEndpoint, isSameCalendarDay, isWeekend, isWithinDateRange, layoutDayEvents, layoutDayEvents as layoutDayEvents$1, layoutMonthWeek, layoutMonthWeek as layoutMonthWeek$1, lightColors, monthCreateRange, monthDropBounds, nextDateRange, nextDateRange as nextDateRange$1, overlapsOtherEvents, pageStepDays, parseICalendar, rangeBandKind, titleNumberOfLines, toICalendar, useDateRange, useEventSource, useMonthGrid, useNow, useNow as useNow$1, weekdayFormatToken, weekdayFormatToken as weekdayFormatToken$1 } from "@super-calendar/core";
4
+ import { backgroundBandsForDay, backgroundBandsForDay as backgroundBandsForDay$1, bandRounding, buildMonthGrid, buildMonthGrid as buildMonthGrid$1, buildMonthWeeks, cellRangeFromDrag, clampMoveStartMinutes, closedHourBands, compareDayEvents, darkColors, dayAccessibilityLabel, dayBadgeKind, daySelectionState, daySelectionState as daySelectionState$1, defaultCalendarLabels, eventAccessibilityLabel, eventChipLayout, eventTimeLabel, eventsInTimeZone, expandRecurringEvents, expandRecurringEvents as expandRecurringEvents$1, filterHiddenDays, formatHour, getIsToday, getViewDays, getViewDays as getViewDays$1, getWeekDays, getYearMonths, groupEventsByDay, isAllDayEvent, isAllDayEvent as isAllDayEvent$1, isBackgroundEvent, isBackgroundEvent as isBackgroundEvent$1, isDateSelectable, isRangeEndpoint, isSameCalendarDay, isWeekend, isWithinDateRange, layoutDayEvents, layoutDayEvents as layoutDayEvents$1, layoutMonthWeek, layoutMonthWeek as layoutMonthWeek$1, lightColors, monthCreateRange, monthDropBounds, nextDateRange, nextDateRange as nextDateRange$1, overlapsOtherEvents, pageStepDays, parseICalendar, rangeBandKind, resolveCalendarLabels, titleNumberOfLines, toICalendar, useDateRange, useEventSource, useMonthGrid, useNow, useNow as useNow$1, weekdayFormatToken, weekdayFormatToken as weekdayFormatToken$1 } from "@super-calendar/core";
5
5
  import { Fragment, jsx, jsxs } from "react/jsx-runtime";
6
6
  //#region src/slots.ts
7
7
  /** Join truthy class names (a dependency-free clsx-lite). */
@@ -240,8 +240,9 @@ function Agenda({ events, locale, ampm = false, activeDate, theme: themeOverride
240
240
  * highlighted and a dot under days that hold events. It's the view `Calendar`
241
241
  * renders for `mode="year"`.
242
242
  */
243
- function YearView({ date, events, weekStartsOn = 0, hiddenDays, locale, activeDate, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, minMonthWidth = 150, onPressDay, onPressMonth, onSelectDrag, onCreateEvent, theme: themeOverrides, className, style, classNames, styles }) {
243
+ function YearView({ date, events, weekStartsOn = 0, hiddenDays, locale, labels: labelsProp, activeDate, selectedRange, selectedDates, minDate, maxDate, isDateDisabled, minMonthWidth = 150, onPressDay, onPressMonth, onSelectDrag, onCreateEvent, theme: themeOverrides, className, style, classNames, styles }) {
244
244
  const theme = useMemo(() => mergeDomTheme(themeOverrides), [themeOverrides]);
245
+ const labels = useMemo(() => resolveCalendarLabels(labelsProp), [labelsProp]);
245
246
  const slot = createSlots({
246
247
  classNames,
247
248
  styles
@@ -399,7 +400,14 @@ function YearView({ date, events, weekStartsOn = 0, hiddenDays, locale, activeDa
399
400
  });
400
401
  const dayTime = startOfDay(day).getTime();
401
402
  const inCreate = creating != null && dayTime >= Math.min(creating.anchor, creating.hover) && dayTime <= Math.max(creating.anchor, creating.hover);
402
- const label = `${format(day, "EEEE, d LLLL yyyy", { locale })}${isToday ? ", today" : ""}${state.isSelected ? ", selected" : ""}${state.isDisabled ? ", unavailable" : ""}${hasEvents ? ", has events" : ""}`;
403
+ const label = dayAccessibilityLabel({
404
+ dateLabel: format(day, "EEEE, d LLLL yyyy", { locale }),
405
+ isToday,
406
+ isSelected: state.isSelected,
407
+ isDisabled: state.isDisabled,
408
+ hasEvents,
409
+ labels
410
+ });
403
411
  const badge = dayBadgeKind(state, isHighlighted);
404
412
  const daySlot = slot("day", {
405
413
  base: {
@@ -542,7 +550,6 @@ const EMPTY_LAYOUT = {
542
550
  segments: [],
543
551
  laneCount: 0
544
552
  };
545
- const DATE_ROW = 24;
546
553
  const CHIP_HEIGHT = 18;
547
554
  const CHIP_GAP = 2;
548
555
  const CELL_PAD = 4;
@@ -582,7 +589,7 @@ function rangeBandDefault(day, theme, fillCell, eventsMode) {
582
589
  const kind = rangeBandKind(day, fillCell);
583
590
  if (kind === "none") return null;
584
591
  const fill = kind === "fill";
585
- const badgeSize = eventsMode ? DATE_ROW - 2 : theme.dayBadgeSize;
592
+ const badgeSize = eventsMode ? 22 : theme.dayBadgeSize;
586
593
  const bandHeight = eventsMode ? badgeSize : theme.rangeBandHeight;
587
594
  const inset = fill ? 0 : eventsMode ? CELL_PAD : Math.max(0, (theme.cellHeight - bandHeight) / 2);
588
595
  const radius = fill ? 0 : bandHeight / 2;
@@ -661,8 +668,8 @@ function compactBadgeDefault(day, theme) {
661
668
  position: "relative",
662
669
  zIndex: 1,
663
670
  alignSelf: "flex-end",
664
- width: DATE_ROW - 2,
665
- height: DATE_ROW - 2,
671
+ width: 22,
672
+ height: 22,
666
673
  borderRadius: "50%",
667
674
  display: "flex",
668
675
  alignItems: "center",
@@ -748,8 +755,9 @@ function collectRowEvents(week, eventsByDay) {
748
755
  * <MonthView date={new Date()} events={events} onPressDay={(d) => setDate(d)} />
749
756
  * ```
750
757
  */
751
- function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short", events, eventsByDay: eventsByDayProp, renderEvent, eventAccessibilityLabel, maxVisibleEventCount = 3, moreLabel = "{moreCount} More", onPressEvent, onPressMore, selectedRange, selectedDates, showAdjacentMonths = true, highlightWeekends = true, fillCellOnSelection = false, showTitle = true, showWeekdays = true, locale, theme: themeOverrides, minDate, maxDate, isDateDisabled, onPressDay, onPressCell, onCreateEvent, onSelectDrag, onDragEvent, onDragStart, eventStartEditable = true, eventOverlap = true, keyboardDayNavigation = false, className, style, classNames, styles }) {
758
+ function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short", events, eventsByDay: eventsByDayProp, renderEvent, eventAccessibilityLabel, maxVisibleEventCount = 3, moreLabel = "{moreCount} More", labels: labelsProp, onPressEvent, onPressMore, selectedRange, selectedDates, showAdjacentMonths = true, highlightWeekends = true, fillCellOnSelection = false, showTitle = true, showWeekdays = true, locale, theme: themeOverrides, minDate, maxDate, isDateDisabled, onPressDay, onPressCell, onCreateEvent, onSelectDrag, onDragEvent, onDragStart, eventStartEditable = true, eventOverlap = true, keyboardDayNavigation = false, className, style, classNames, styles }) {
752
759
  const theme = useMemo(() => mergeDomTheme(themeOverrides), [themeOverrides]);
760
+ const labels = useMemo(() => resolveCalendarLabels(labelsProp), [labelsProp]);
753
761
  const slot = createSlots({
754
762
  classNames,
755
763
  styles
@@ -834,7 +842,8 @@ function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short"
834
842
  const [focusedDate, setFocusedDate] = useState(initialFocus);
835
843
  const initialFocusRef = useRef(initialFocus);
836
844
  initialFocusRef.current = initialFocus;
837
- useEffect(() => setFocusedDate(initialFocusRef.current), [format(date, "yyyy-MM")]);
845
+ const monthKey = format(date, "yyyy-MM");
846
+ useEffect(() => setFocusedDate(initialFocusRef.current), [monthKey]);
838
847
  const [hoveredKey, setHoveredKey] = useState(null);
839
848
  const gridRef = useRef(null);
840
849
  const focusKey = format(focusedDate, "yyyy-MM-dd");
@@ -1019,7 +1028,12 @@ function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short"
1019
1028
  style: { height: cellHeight }
1020
1029
  }, day.id);
1021
1030
  const band = rangeBandDefault(day, theme, fillCellOnSelection, eventsMode);
1022
- const label = format(day.date, "EEEE, d MMMM yyyy", locale ? { locale } : void 0);
1031
+ const dateLabel = format(day.date, "EEEE, d MMMM yyyy", locale ? { locale } : void 0);
1032
+ const label = dayAccessibilityLabel({
1033
+ dateLabel,
1034
+ isToday: day.isToday,
1035
+ labels
1036
+ });
1023
1037
  const dayTime = startOfDay(day.date).getTime();
1024
1038
  const inCreate = drag?.kind === "create" && dayTime >= Math.min(drag.anchor, drag.hover) && dayTime <= Math.max(drag.anchor, drag.hover);
1025
1039
  const isDropTarget = drag?.kind === "move" && dayTime === drag.to && drag.to !== drag.from;
@@ -1044,7 +1058,13 @@ function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short"
1044
1058
  ...dayData,
1045
1059
  tabIndex: keyboardDayNavigation ? day.id === focusKey ? 0 : -1 : void 0,
1046
1060
  "aria-disabled": day.isDisabled || void 0,
1047
- "aria-label": label,
1061
+ "aria-label": dayAccessibilityLabel({
1062
+ dateLabel,
1063
+ isToday: day.isToday,
1064
+ isSelected: day.isSelected,
1065
+ eventCount: dayEvents.length,
1066
+ labels
1067
+ }),
1048
1068
  ...dayCellProps,
1049
1069
  style: dragWired ? {
1050
1070
  ...dayCellProps.style,
@@ -1160,7 +1180,7 @@ function MonthView({ date, weekStartsOn = 0, hiddenDays, weekdayFormat = "short"
1160
1180
  }
1161
1181
  },
1162
1182
  ...slot("more", moreButtonDefault(theme)),
1163
- "aria-label": `${hiddenEvents.length} more events, ${dayLabel}`,
1183
+ "aria-label": `${labels.moreEvents(hiddenEvents.length)}, ${dayLabel}`,
1164
1184
  "aria-expanded": onPressMore ? void 0 : moreOpenFor === day.id,
1165
1185
  children: moreLabel.replace("{moreCount}", String(hiddenEvents.length))
1166
1186
  }) : null,
@@ -1377,8 +1397,9 @@ function DefaultDomEvent({ event, mode, isAllDay, boxHeight, ampm = false, theme
1377
1397
  * <TimeGrid mode="week" date={new Date()} events={events} />
1378
1398
  * ```
1379
1399
  */
1380
- function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStartsOn = 0, weekdayFormat = "short", hourHeight: initialHourHeight = 48, scrollOffsetMinutes = 480, zoomable = true, minHourHeight = 24, maxHourHeight = 160, minEventHeight = DEFAULT_MIN_EVENT_HEIGHT, eventGap = DEFAULT_EVENT_GAP, dragStepMinutes = 15, ampm = false, timeslots = 1, minHour = 0, maxHour = 24, hideHours = false, showWeekNumber = false, weekNumberPrefix = "W", hiddenDays, keyboardEventNavigation = false, businessHours, renderBusinessHours, showNowIndicator = true, highlightWeekends = true, eventStartEditable = true, eventDurationEditable = true, eventOverlap = true, now: nowProp, timeZone, showAllDayEventCell = true, 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
@@ -1391,6 +1412,7 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
1391
1412
  const windowEnd = Math.max(windowStart + 1, Math.min(maxHour, 24));
1392
1413
  const windowHours = windowEnd - windowStart;
1393
1414
  const gutterWidth = hideHours ? 0 : GUTTER_WIDTH$1;
1415
+ const RenderBackground = renderBackgroundEvent;
1394
1416
  const visibleHours = useMemo(() => Array.from({ length: windowHours }, (_, i) => windowStart + i), [windowStart, windowHours]);
1395
1417
  const now = useNow$1(showNowIndicator, {
1396
1418
  now: nowProp,
@@ -1616,11 +1638,12 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
1616
1638
  const origin = dragOrigin.current;
1617
1639
  const originIndex = origin?.dayIndex ?? 0;
1618
1640
  let base = null;
1619
- if (d.kind === "move") if (pagedRef.current) {
1620
- const day = dayAt(e.clientX, e.clientY);
1621
- base = day ? startOfDay(day) : null;
1622
- } else base = startOfDay(daysRef.current[originIndex + d.dayDelta] ?? daysRef.current[originIndex]);
1623
- else base = startOfDay(daysRef.current[originIndex] ?? daysRef.current[0]);
1641
+ if (d.kind === "move") {
1642
+ if (pagedRef.current) {
1643
+ const day = dayAt(e.clientX, e.clientY);
1644
+ base = day ? startOfDay(day) : null;
1645
+ } else base = startOfDay(daysRef.current[originIndex + d.dayDelta] ?? daysRef.current[originIndex]);
1646
+ } else base = startOfDay(daysRef.current[originIndex] ?? daysRef.current[0]);
1624
1647
  if (base && held && origin) {
1625
1648
  const segmentStart = addMinutes(base, Math.round(d.startHours * 60));
1626
1649
  const segmentEnd = addMinutes(base, Math.round((d.startHours + d.durationHours) * 60));
@@ -1851,11 +1874,22 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
1851
1874
  windowStart,
1852
1875
  windowEnd
1853
1876
  ]);
1854
- const backgroundByDay = useMemo(() => days.map((day) => backgroundBandsForDay$1(events, day).map((b) => ({
1855
- ...b,
1856
- startHours: Math.max(b.startHours, windowStart),
1857
- endHours: Math.min(b.endHours, windowEnd)
1858
- })).filter((b) => b.endHours > b.startHours)), [
1877
+ const backgroundByDay = useMemo(() => days.map((day) => {
1878
+ const seen = /* @__PURE__ */ new Map();
1879
+ return backgroundBandsForDay$1(events, day).map((b) => ({
1880
+ ...b,
1881
+ startHours: Math.max(b.startHours, windowStart),
1882
+ endHours: Math.min(b.endHours, windowEnd)
1883
+ })).filter((b) => b.endHours > b.startHours).map((b) => {
1884
+ const base = `bg-${b.event.start.toISOString()}-${b.event.end.toISOString()}`;
1885
+ const nth = (seen.get(base) ?? 0) + 1;
1886
+ seen.set(base, nth);
1887
+ return {
1888
+ ...b,
1889
+ key: nth === 1 ? base : `${base}-${nth}`
1890
+ };
1891
+ });
1892
+ }), [
1859
1893
  days,
1860
1894
  events,
1861
1895
  windowStart,
@@ -1925,7 +1959,7 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
1925
1959
  const inner = /* @__PURE__ */ jsxs(Fragment, { children: [
1926
1960
  /* @__PURE__ */ jsx("span", {
1927
1961
  style: VISUALLY_HIDDEN,
1928
- children: dateLabel
1962
+ children: today ? `${dateLabel}, ${labels.today}` : dateLabel
1929
1963
  }),
1930
1964
  /* @__PURE__ */ jsx("span", {
1931
1965
  "aria-hidden": true,
@@ -1990,7 +2024,7 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
1990
2024
  padding: "4px 6px 0 0"
1991
2025
  }
1992
2026
  }),
1993
- children: "all-day"
2027
+ children: showAllDayLabel ? labels.allDay : null
1994
2028
  }), allDayByDay.map((list, i) => {
1995
2029
  const dayStart = startOfDay(days[i]);
1996
2030
  const dayEnd = addDays(dayStart, 1);
@@ -2026,7 +2060,8 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
2026
2060
  isAllDay: true,
2027
2061
  start: event.start,
2028
2062
  end: event.end,
2029
- ampm
2063
+ ampm,
2064
+ labels
2030
2065
  }),
2031
2066
  ...slot("allDayEvent", { base: {
2032
2067
  border: "none",
@@ -2135,22 +2170,46 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
2135
2170
  end: b.end
2136
2171
  })
2137
2172
  }, b.start)),
2138
- backgroundByDay[dayIndex].map((b, bandIndex) => /* @__PURE__ */ jsx("div", {
2139
- "aria-hidden": true,
2140
- title: b.event.title,
2141
- ...slot("backgroundEvent", {
2142
- base: {
2143
- position: "absolute",
2144
- left: 0,
2145
- right: 0,
2146
- top: (b.startHours - windowStart) * hourHeight,
2147
- height: (b.endHours - b.startHours) * hourHeight,
2148
- pointerEvents: "none",
2149
- zIndex: 0
2150
- },
2151
- themed: { background: theme.backgroundEvent }
2152
- })
2153
- }, `bg-${bandIndex}`)),
2173
+ backgroundByDay[dayIndex].map((b) => {
2174
+ const { key } = b;
2175
+ const geometry = {
2176
+ position: "absolute",
2177
+ left: 0,
2178
+ right: 0,
2179
+ top: (b.startHours - windowStart) * hourHeight,
2180
+ height: (b.endHours - b.startHours) * hourHeight,
2181
+ zIndex: 0,
2182
+ overflow: "hidden"
2183
+ };
2184
+ if (!RenderBackground) return /* @__PURE__ */ jsx("div", {
2185
+ "aria-hidden": true,
2186
+ title: b.event.title,
2187
+ ...slot("backgroundEvent", {
2188
+ base: {
2189
+ ...geometry,
2190
+ pointerEvents: "none"
2191
+ },
2192
+ themed: { background: theme.backgroundEvent }
2193
+ })
2194
+ }, key);
2195
+ const dayStart = startOfDay(days[dayIndex]);
2196
+ return /* @__PURE__ */ jsx("div", {
2197
+ ...slot("backgroundEvent", { base: {
2198
+ ...geometry,
2199
+ pointerEvents: "auto"
2200
+ } }),
2201
+ children: /* @__PURE__ */ jsx(RenderBackground, {
2202
+ event: b.event,
2203
+ mode,
2204
+ isAllDay: false,
2205
+ boxHeight: geometry.height,
2206
+ continuesBefore: b.event.start < dayStart,
2207
+ continuesAfter: b.event.end > addDays(dayStart, 1),
2208
+ ampm,
2209
+ onPress: () => onPressEvent?.(b.event)
2210
+ })
2211
+ }, key);
2212
+ }),
2154
2213
  /* @__PURE__ */ jsx("div", {
2155
2214
  "aria-hidden": true,
2156
2215
  ...slot("gridLines", {
@@ -2200,7 +2259,8 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
2200
2259
  isAllDay: false,
2201
2260
  start: pe.event.start,
2202
2261
  end: pe.event.end,
2203
- ampm
2262
+ ampm,
2263
+ labels
2204
2264
  }),
2205
2265
  onKeyDown: (e) => {
2206
2266
  if (e.key === "Enter" || e.key === " ") {
@@ -2235,7 +2295,7 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
2235
2295
  canResize && !pe.continuesBefore ? /* @__PURE__ */ jsx("div", {
2236
2296
  onPointerDown: (e) => {
2237
2297
  e.stopPropagation();
2238
- beginDrag(e, pe, key, "resize-start", dayIndex);
2298
+ beginDrag(e, pe, key, "resize-start", dayIndex, canMove ? onPress : void 0);
2239
2299
  },
2240
2300
  style: {
2241
2301
  position: "absolute",
@@ -2250,7 +2310,7 @@ function TimeGrid({ date, events = [], mode = "day", numberOfDays = 1, weekStart
2250
2310
  canResize && !pe.continuesAfter ? /* @__PURE__ */ jsx("div", {
2251
2311
  onPointerDown: (e) => {
2252
2312
  e.stopPropagation();
2253
- beginDrag(e, pe, key, "resize", dayIndex);
2313
+ beginDrag(e, pe, key, "resize", dayIndex, canMove ? onPress : void 0);
2254
2314
  },
2255
2315
  style: {
2256
2316
  position: "absolute",
@@ -2425,7 +2485,7 @@ function pageStep(mode, date, direction, weekStartsOn, numberOfDays) {
2425
2485
  * <Calendar mode="week" date={new Date()} events={events} />
2426
2486
  * ```
2427
2487
  */
2428
- 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, showNowIndicator, showAllDayEventCell, 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 }) {
2429
2489
  const displayEvents = useMemo(() => {
2430
2490
  let out = events ?? EMPTY_EVENTS;
2431
2491
  if (out.some((e) => e.recurrence)) {
@@ -2460,6 +2520,7 @@ function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0,
2460
2520
  weekStartsOn,
2461
2521
  hiddenDays,
2462
2522
  locale,
2523
+ labels,
2463
2524
  theme,
2464
2525
  className,
2465
2526
  style: height != null ? {
@@ -2502,6 +2563,7 @@ function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0,
2502
2563
  weekdayFormat,
2503
2564
  highlightWeekends,
2504
2565
  locale,
2566
+ labels,
2505
2567
  theme,
2506
2568
  className,
2507
2569
  style,
@@ -2542,6 +2604,7 @@ function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0,
2542
2604
  weekdayFormat,
2543
2605
  numberOfDays,
2544
2606
  locale,
2607
+ labels,
2545
2608
  theme,
2546
2609
  height,
2547
2610
  className,
@@ -2561,8 +2624,10 @@ function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0,
2561
2624
  weekNumberPrefix,
2562
2625
  businessHours,
2563
2626
  renderBusinessHours,
2627
+ renderBackgroundEvent,
2564
2628
  showNowIndicator,
2565
2629
  showAllDayEventCell,
2630
+ showAllDayLabel,
2566
2631
  highlightWeekends,
2567
2632
  eventStartEditable,
2568
2633
  eventDurationEditable,
@@ -2593,7 +2658,7 @@ function Calendar({ mode = "week", date, events, onChangeDate, weekStartsOn = 0,
2593
2658
  * Legend List's DOM renderer and the library's headless grid logic. Selection is
2594
2659
  * controlled, pass `selectedRange` (or `selectedDates`) and handle `onPressDay`.
2595
2660
  */
2596
- 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 }) {
2597
2662
  const theme = useMemo(() => mergeDomTheme(themeOverrides), [themeOverrides]);
2598
2663
  const slot = createSlots({
2599
2664
  classNames,
@@ -2681,6 +2746,7 @@ function MonthList({ date, pastMonths = 1, futureMonths = 12, weekdayFormat = "s
2681
2746
  eventAccessibilityLabel,
2682
2747
  maxVisibleEventCount,
2683
2748
  moreLabel,
2749
+ labels,
2684
2750
  onPressEvent,
2685
2751
  onPressMore,
2686
2752
  selectedRange,
@@ -3686,4 +3752,4 @@ function ResourceTimeline({ date, orientation = "horizontal", resources: allReso
3686
3752
  });
3687
3753
  }
3688
3754
  //#endregion
3689
- 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.10.0",
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.10.0"
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";
@@ -149,10 +150,17 @@ export interface CalendarProps<T = unknown>
149
150
  * band stays non-interactive and hidden from assistive tech.
150
151
  */
151
152
  renderBusinessHours?: (band: BusinessHoursBand) => ReactNode;
153
+ /**
154
+ * A component that draws a `display: "background"` event's band in place of
155
+ * the themed shade; see `TimeGrid`'s prop of the same name.
156
+ */
157
+ renderBackgroundEvent?: DomRenderEvent<T>;
152
158
  /** Show the current-time indicator (default true). */
153
159
  showNowIndicator?: boolean;
154
160
  /** Show the all-day lane (default true). */
155
161
  showAllDayEventCell?: boolean;
162
+ /** Show the "all-day" text beside the lane (default false). */
163
+ showAllDayLabel?: boolean;
156
164
  /** Tint weekend columns (default true). Set false to treat weekends normally. */
157
165
  highlightWeekends?: boolean;
158
166
  /** Allow moving events by default (per-event `startEditable` overrides). Default true. */
@@ -199,6 +207,8 @@ export interface CalendarProps<T = unknown>
199
207
  maxVisibleEventCount?: number;
200
208
  /** Overflow row template; `{moreCount}` is replaced. */
201
209
  moreLabel?: string;
210
+ /** Translations for the screen-reader words and gutter text; omitted keys use English. */
211
+ labels?: Partial<CalendarLabels>;
202
212
  /** Render neighbouring months' days in the leading/trailing cells (default true). */
203
213
  showAdjacentMonths?: boolean;
204
214
  /**
@@ -332,8 +342,10 @@ export function Calendar<T = unknown>({
332
342
  weekNumberPrefix,
333
343
  businessHours,
334
344
  renderBusinessHours,
345
+ renderBackgroundEvent,
335
346
  showNowIndicator,
336
347
  showAllDayEventCell,
348
+ showAllDayLabel,
337
349
  highlightWeekends,
338
350
  eventStartEditable,
339
351
  eventDurationEditable,
@@ -350,6 +362,7 @@ export function Calendar<T = unknown>({
350
362
  // month
351
363
  maxVisibleEventCount,
352
364
  moreLabel,
365
+ labels,
353
366
  showAdjacentMonths,
354
367
  showTitle,
355
368
  weekdayFormat,
@@ -410,6 +423,7 @@ export function Calendar<T = unknown>({
410
423
  weekStartsOn={weekStartsOn}
411
424
  hiddenDays={hiddenDays}
412
425
  locale={locale}
426
+ labels={labels}
413
427
  theme={theme}
414
428
  className={className}
415
429
  style={height != null ? { height, ...style } : style}
@@ -455,6 +469,7 @@ export function Calendar<T = unknown>({
455
469
  weekdayFormat={weekdayFormat}
456
470
  highlightWeekends={highlightWeekends}
457
471
  locale={locale}
472
+ labels={labels}
458
473
  theme={theme}
459
474
  className={className}
460
475
  style={style}
@@ -498,6 +513,7 @@ export function Calendar<T = unknown>({
498
513
  weekdayFormat={weekdayFormat}
499
514
  numberOfDays={numberOfDays}
500
515
  locale={locale}
516
+ labels={labels}
501
517
  theme={theme}
502
518
  height={height}
503
519
  className={className}
@@ -517,8 +533,10 @@ export function Calendar<T = unknown>({
517
533
  weekNumberPrefix={weekNumberPrefix}
518
534
  businessHours={businessHours}
519
535
  renderBusinessHours={renderBusinessHours}
536
+ renderBackgroundEvent={renderBackgroundEvent}
520
537
  showNowIndicator={showNowIndicator}
521
538
  showAllDayEventCell={showAllDayEventCell}
539
+ showAllDayLabel={showAllDayLabel}
522
540
  highlightWeekends={highlightWeekends}
523
541
  eventStartEditable={eventStartEditable}
524
542
  eventDurationEditable={eventDurationEditable}
package/src/MonthList.tsx CHANGED
@@ -13,6 +13,7 @@ import {
13
13
  type WeekdayFormat,
14
14
  type WeekStartsOn,
15
15
  } from "@super-calendar/core";
16
+ import type { CalendarLabels } from "@super-calendar/core";
16
17
  import { type DomMonthEvent, MonthView, type MonthViewSlot } from "./MonthView";
17
18
  import { createSlots, type SlotStyleProps } from "./slots";
18
19
  import { type DomCalendarTheme, mergeDomTheme } from "./theme";
@@ -53,6 +54,8 @@ export interface MonthListProps<T = unknown>
53
54
  maxVisibleEventCount?: number;
54
55
  /** Template for the overflow row; `{moreCount}` is replaced. */
55
56
  moreLabel?: string;
57
+ /** Translations for the screen-reader words and gutter text; omitted keys use English. */
58
+ labels?: Partial<CalendarLabels>;
56
59
  /** Tap an event chip. */
57
60
  onPressEvent?: (event: CalendarEvent<T>) => void;
58
61
  /** Tap the "+N more" overflow row. */
@@ -100,6 +103,7 @@ export function MonthList<T = unknown>({
100
103
  eventAccessibilityLabel,
101
104
  maxVisibleEventCount,
102
105
  moreLabel,
106
+ labels,
103
107
  onPressEvent,
104
108
  onPressMore,
105
109
  selectedRange,
@@ -199,6 +203,7 @@ export function MonthList<T = unknown>({
199
203
  eventAccessibilityLabel={eventAccessibilityLabel}
200
204
  maxVisibleEventCount={maxVisibleEventCount}
201
205
  moreLabel={moreLabel}
206
+ labels={labels}
202
207
  onPressEvent={onPressEvent}
203
208
  onPressMore={onPressMore}
204
209
  selectedRange={selectedRange}
package/src/MonthView.tsx CHANGED
@@ -39,6 +39,11 @@ import {
39
39
  type WeekdayFormat,
40
40
  type WeekStartsOn,
41
41
  } from "@super-calendar/core";
42
+ import {
43
+ type CalendarLabels,
44
+ dayAccessibilityLabel,
45
+ resolveCalendarLabels,
46
+ } from "@super-calendar/core";
42
47
  import { createSlots, dataState, type SlotDefault, type SlotStyleProps } from "./slots";
43
48
  import { type DomCalendarTheme, mergeDomTheme } from "./theme";
44
49
 
@@ -124,6 +129,8 @@ export interface MonthViewProps<T = unknown>
124
129
  maxVisibleEventCount?: number;
125
130
  /** Template for the overflow row; `{moreCount}` is replaced (default "{moreCount} More"). */
126
131
  moreLabel?: string;
132
+ /** Translations for the screen-reader words and gutter text; omitted keys use English. */
133
+ labels?: Partial<CalendarLabels>;
127
134
  /** Tap an event chip. */
128
135
  onPressEvent?: (event: CalendarEvent<T>) => void;
129
136
  /** Tap the "+N more" overflow row. */
@@ -481,6 +488,7 @@ export function MonthView<T = unknown>({
481
488
  eventAccessibilityLabel,
482
489
  maxVisibleEventCount = 3,
483
490
  moreLabel = "{moreCount} More",
491
+ labels: labelsProp,
484
492
  onPressEvent,
485
493
  onPressMore,
486
494
  selectedRange,
@@ -510,6 +518,7 @@ export function MonthView<T = unknown>({
510
518
  styles,
511
519
  }: MonthViewInternalProps<T>): ReactElement {
512
520
  const theme = useMemo(() => mergeDomTheme(themeOverrides), [themeOverrides]);
521
+ const labels = useMemo(() => resolveCalendarLabels(labelsProp), [labelsProp]);
513
522
  const slot = createSlots<MonthViewSlot>({ classNames, styles });
514
523
 
515
524
  // Calendar layout (date in the corner + event chips) is on whenever `events`
@@ -842,11 +851,12 @@ export function MonthView<T = unknown>({
842
851
  );
843
852
  }
844
853
  const band = rangeBandDefault(day, theme, fillCellOnSelection, eventsMode);
845
- const label = format(
854
+ const dateLabel = format(
846
855
  day.date,
847
856
  "EEEE, d MMMM yyyy",
848
857
  locale ? { locale } : undefined,
849
858
  );
859
+ const label = dayAccessibilityLabel({ dateLabel, isToday: day.isToday, labels });
850
860
  const dayTime = startOfDay(day.date).getTime();
851
861
  const inCreate =
852
862
  drag?.kind === "create" &&
@@ -902,7 +912,13 @@ export function MonthView<T = unknown>({
902
912
  {...dayData}
903
913
  tabIndex={keyboardDayNavigation ? (day.id === focusKey ? 0 : -1) : undefined}
904
914
  aria-disabled={day.isDisabled || undefined}
905
- aria-label={label}
915
+ aria-label={dayAccessibilityLabel({
916
+ dateLabel,
917
+ isToday: day.isToday,
918
+ isSelected: day.isSelected,
919
+ eventCount: dayEvents.length,
920
+ labels,
921
+ })}
906
922
  {...dayCellProps}
907
923
  // Dragging disables touch scroll on the cell so a swipe
908
924
  // sketches a span (or carries an event) instead of scrolling
@@ -1065,7 +1081,7 @@ export function MonthView<T = unknown>({
1065
1081
  }
1066
1082
  }}
1067
1083
  {...slot("more", moreButtonDefault(theme))}
1068
- aria-label={`${hiddenEvents.length} more events, ${dayLabel}`}
1084
+ aria-label={`${labels.moreEvents(hiddenEvents.length)}, ${dayLabel}`}
1069
1085
  aria-expanded={onPressMore ? undefined : moreOpenFor === day.id}
1070
1086
  >
1071
1087
  {moreLabel.replace("{moreCount}", String(hiddenEvents.length))}