@super-calendar/core 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 +176 -105
- package/dist/index.d.ts +176 -105
- package/dist/index.js +59 -5
- package/dist/index.mjs +57 -6
- package/package.json +1 -1
- package/src/index.ts +1 -0
- package/src/utils/eventDisplay.ts +7 -3
- package/src/utils/labels.ts +109 -0
- package/src/utils/monthGrid.ts +13 -15
package/dist/index.js
CHANGED
|
@@ -134,9 +134,10 @@ const getViewDays = (mode, date, weekStartsOn, numberOfDays = 1, isRTL = false,
|
|
|
134
134
|
*/
|
|
135
135
|
const buildMonthWeeks = (month, weekStartsOn, { showSixWeeks = false, isRTL = false, hiddenDays } = {}) => {
|
|
136
136
|
const start = (0, date_fns.startOfWeek)((0, date_fns.startOfMonth)(month), { weekStartsOn });
|
|
137
|
+
const end = showSixWeeks ? (0, date_fns.addDays)(start, 41) : (0, date_fns.endOfWeek)((0, date_fns.endOfMonth)(month), { weekStartsOn });
|
|
137
138
|
const days = (0, date_fns.eachDayOfInterval)({
|
|
138
139
|
start,
|
|
139
|
-
end
|
|
140
|
+
end
|
|
140
141
|
});
|
|
141
142
|
const weeks = [];
|
|
142
143
|
for (let index = 0; index < days.length; index += 7) {
|
|
@@ -365,9 +366,11 @@ function resolveDraggedBounds(start, end, deltaStartMinutes, deltaEndMinutes, sn
|
|
|
365
366
|
function monthCreateRange(anchor, hover) {
|
|
366
367
|
const a = (0, date_fns.startOfDay)(anchor);
|
|
367
368
|
const b = (0, date_fns.startOfDay)(hover);
|
|
369
|
+
const first = a.getTime() <= b.getTime() ? a : b;
|
|
370
|
+
const last = a.getTime() <= b.getTime() ? b : a;
|
|
368
371
|
return {
|
|
369
|
-
start:
|
|
370
|
-
end: (0, date_fns.addDays)(
|
|
372
|
+
start: first,
|
|
373
|
+
end: (0, date_fns.addDays)(last, 1)
|
|
371
374
|
};
|
|
372
375
|
}
|
|
373
376
|
/**
|
|
@@ -415,6 +418,52 @@ function cellRangeFromDrag(day, startPx, endPx, cellHeightPx, minHour, snapMinut
|
|
|
415
418
|
};
|
|
416
419
|
}
|
|
417
420
|
//#endregion
|
|
421
|
+
//#region src/utils/labels.ts
|
|
422
|
+
const minutes = (n) => `${n} minute${n === 1 ? "" : "s"}`;
|
|
423
|
+
const page = (days, mode) => mode === "week" ? "week" : days === 1 ? "day" : `${days} days`;
|
|
424
|
+
/** The built-in English {@link CalendarLabels}. */
|
|
425
|
+
const defaultCalendarLabels = {
|
|
426
|
+
today: "today",
|
|
427
|
+
selected: "selected",
|
|
428
|
+
unavailable: "unavailable",
|
|
429
|
+
hasEvents: "has events",
|
|
430
|
+
eventCount: (count) => count === 1 ? "1 event" : `${count} events`,
|
|
431
|
+
moreEvents: (count) => `${count} more events`,
|
|
432
|
+
allDay: "all-day",
|
|
433
|
+
allDayEvent: "all day",
|
|
434
|
+
timeRange: (start, end) => `${start} to ${end}`,
|
|
435
|
+
close: "Close",
|
|
436
|
+
moveLater: (n) => `Move ${minutes(n)} later`,
|
|
437
|
+
moveEarlier: (n) => `Move ${minutes(n)} earlier`,
|
|
438
|
+
extend: (n) => `Extend by ${minutes(n)}`,
|
|
439
|
+
shorten: (n) => `Shorten by ${minutes(n)}`,
|
|
440
|
+
moveToNextPage: (days, mode) => `Move to next ${page(days, mode)}`,
|
|
441
|
+
moveToPreviousPage: (days, mode) => `Move to previous ${page(days, mode)}`,
|
|
442
|
+
moveToResource: (title) => `Move to ${title}`
|
|
443
|
+
};
|
|
444
|
+
/** Fill the labels a consumer left out with {@link defaultCalendarLabels}. */
|
|
445
|
+
function resolveCalendarLabels(labels) {
|
|
446
|
+
return labels ? {
|
|
447
|
+
...defaultCalendarLabels,
|
|
448
|
+
...labels
|
|
449
|
+
} : defaultCalendarLabels;
|
|
450
|
+
}
|
|
451
|
+
/**
|
|
452
|
+
* Screen-reader label for a day: the formatted date followed by its state
|
|
453
|
+
* words, joined with ", " (e.g. "Friday, 17 July 2026, today, 3 events").
|
|
454
|
+
*/
|
|
455
|
+
function dayAccessibilityLabel(args) {
|
|
456
|
+
const { labels } = args;
|
|
457
|
+
return [
|
|
458
|
+
args.dateLabel,
|
|
459
|
+
args.isToday ? labels.today : null,
|
|
460
|
+
args.isSelected ? labels.selected : null,
|
|
461
|
+
args.isDisabled ? labels.unavailable : null,
|
|
462
|
+
args.hasEvents ? labels.hasEvents : null,
|
|
463
|
+
args.eventCount == null ? null : labels.eventCount(args.eventCount)
|
|
464
|
+
].filter(Boolean).join(", ");
|
|
465
|
+
}
|
|
466
|
+
//#endregion
|
|
418
467
|
//#region src/utils/eventDisplay.ts
|
|
419
468
|
/**
|
|
420
469
|
* Minimum event-box height (px) before the built-in renderer shows the time line
|
|
@@ -430,8 +479,9 @@ function titleEllipsizeMode(ellipsizeTitle) {
|
|
|
430
479
|
* range (which the grid otherwise only conveys visually). Empty title is dropped.
|
|
431
480
|
*/
|
|
432
481
|
function eventAccessibilityLabel(args) {
|
|
482
|
+
const labels = args.labels ?? defaultCalendarLabels;
|
|
433
483
|
const timeFormat = args.ampm ? "h:mm a" : "HH:mm";
|
|
434
|
-
const time = args.isAllDay ? args.allDayLabel ??
|
|
484
|
+
const time = args.isAllDay ? args.allDayLabel ?? labels.allDayEvent : labels.timeRange((0, date_fns.format)(args.start, timeFormat), (0, date_fns.format)(args.end, timeFormat));
|
|
435
485
|
return [args.title, time].filter(Boolean).join(", ");
|
|
436
486
|
}
|
|
437
487
|
/**
|
|
@@ -1088,7 +1138,8 @@ function isAllDayEvent(event) {
|
|
|
1088
1138
|
*/
|
|
1089
1139
|
function eventDayKeys(event) {
|
|
1090
1140
|
const first = (0, date_fns.startOfDay)(event.start);
|
|
1091
|
-
const
|
|
1141
|
+
const lastInstant = event.end > event.start ? /* @__PURE__ */ new Date(event.end.getTime() - 1) : event.start;
|
|
1142
|
+
const last = (0, date_fns.startOfDay)(lastInstant);
|
|
1092
1143
|
const keys = [];
|
|
1093
1144
|
for (let cursor = first; cursor <= last; cursor = (0, date_fns.addDays)(cursor, 1)) keys.push(cursor.toISOString());
|
|
1094
1145
|
return keys;
|
|
@@ -1532,8 +1583,10 @@ exports.clampMoveStartMinutes = clampMoveStartMinutes;
|
|
|
1532
1583
|
exports.closedHourBands = closedHourBands;
|
|
1533
1584
|
exports.compareDayEvents = compareDayEvents;
|
|
1534
1585
|
exports.darkColors = darkColors;
|
|
1586
|
+
exports.dayAccessibilityLabel = dayAccessibilityLabel;
|
|
1535
1587
|
exports.dayBadgeKind = dayBadgeKind;
|
|
1536
1588
|
exports.daySelectionState = daySelectionState;
|
|
1589
|
+
exports.defaultCalendarLabels = defaultCalendarLabels;
|
|
1537
1590
|
exports.eventAccessibilityLabel = eventAccessibilityLabel;
|
|
1538
1591
|
exports.eventChipLayout = eventChipLayout;
|
|
1539
1592
|
exports.eventDayKeys = eventDayKeys;
|
|
@@ -1569,6 +1622,7 @@ exports.overlapsOtherEvents = overlapsOtherEvents;
|
|
|
1569
1622
|
exports.pageStepDays = pageStepDays;
|
|
1570
1623
|
exports.parseICalendar = parseICalendar;
|
|
1571
1624
|
exports.rangeBandKind = rangeBandKind;
|
|
1625
|
+
exports.resolveCalendarLabels = resolveCalendarLabels;
|
|
1572
1626
|
exports.resolveDraggedBounds = resolveDraggedBounds;
|
|
1573
1627
|
exports.shiftMinutes = shiftMinutes;
|
|
1574
1628
|
exports.snapDeltaMinutes = snapDeltaMinutes;
|
package/dist/index.mjs
CHANGED
|
@@ -133,9 +133,10 @@ const getViewDays = (mode, date, weekStartsOn, numberOfDays = 1, isRTL = false,
|
|
|
133
133
|
*/
|
|
134
134
|
const buildMonthWeeks = (month, weekStartsOn, { showSixWeeks = false, isRTL = false, hiddenDays } = {}) => {
|
|
135
135
|
const start = startOfWeek(startOfMonth(month), { weekStartsOn });
|
|
136
|
+
const end = showSixWeeks ? addDays(start, 41) : endOfWeek(endOfMonth(month), { weekStartsOn });
|
|
136
137
|
const days = eachDayOfInterval({
|
|
137
138
|
start,
|
|
138
|
-
end
|
|
139
|
+
end
|
|
139
140
|
});
|
|
140
141
|
const weeks = [];
|
|
141
142
|
for (let index = 0; index < days.length; index += 7) {
|
|
@@ -364,9 +365,11 @@ function resolveDraggedBounds(start, end, deltaStartMinutes, deltaEndMinutes, sn
|
|
|
364
365
|
function monthCreateRange(anchor, hover) {
|
|
365
366
|
const a = startOfDay(anchor);
|
|
366
367
|
const b = startOfDay(hover);
|
|
368
|
+
const first = a.getTime() <= b.getTime() ? a : b;
|
|
369
|
+
const last = a.getTime() <= b.getTime() ? b : a;
|
|
367
370
|
return {
|
|
368
|
-
start:
|
|
369
|
-
end: addDays(
|
|
371
|
+
start: first,
|
|
372
|
+
end: addDays(last, 1)
|
|
370
373
|
};
|
|
371
374
|
}
|
|
372
375
|
/**
|
|
@@ -414,6 +417,52 @@ function cellRangeFromDrag(day, startPx, endPx, cellHeightPx, minHour, snapMinut
|
|
|
414
417
|
};
|
|
415
418
|
}
|
|
416
419
|
//#endregion
|
|
420
|
+
//#region src/utils/labels.ts
|
|
421
|
+
const minutes = (n) => `${n} minute${n === 1 ? "" : "s"}`;
|
|
422
|
+
const page = (days, mode) => mode === "week" ? "week" : days === 1 ? "day" : `${days} days`;
|
|
423
|
+
/** The built-in English {@link CalendarLabels}. */
|
|
424
|
+
const defaultCalendarLabels = {
|
|
425
|
+
today: "today",
|
|
426
|
+
selected: "selected",
|
|
427
|
+
unavailable: "unavailable",
|
|
428
|
+
hasEvents: "has events",
|
|
429
|
+
eventCount: (count) => count === 1 ? "1 event" : `${count} events`,
|
|
430
|
+
moreEvents: (count) => `${count} more events`,
|
|
431
|
+
allDay: "all-day",
|
|
432
|
+
allDayEvent: "all day",
|
|
433
|
+
timeRange: (start, end) => `${start} to ${end}`,
|
|
434
|
+
close: "Close",
|
|
435
|
+
moveLater: (n) => `Move ${minutes(n)} later`,
|
|
436
|
+
moveEarlier: (n) => `Move ${minutes(n)} earlier`,
|
|
437
|
+
extend: (n) => `Extend by ${minutes(n)}`,
|
|
438
|
+
shorten: (n) => `Shorten by ${minutes(n)}`,
|
|
439
|
+
moveToNextPage: (days, mode) => `Move to next ${page(days, mode)}`,
|
|
440
|
+
moveToPreviousPage: (days, mode) => `Move to previous ${page(days, mode)}`,
|
|
441
|
+
moveToResource: (title) => `Move to ${title}`
|
|
442
|
+
};
|
|
443
|
+
/** Fill the labels a consumer left out with {@link defaultCalendarLabels}. */
|
|
444
|
+
function resolveCalendarLabels(labels) {
|
|
445
|
+
return labels ? {
|
|
446
|
+
...defaultCalendarLabels,
|
|
447
|
+
...labels
|
|
448
|
+
} : defaultCalendarLabels;
|
|
449
|
+
}
|
|
450
|
+
/**
|
|
451
|
+
* Screen-reader label for a day: the formatted date followed by its state
|
|
452
|
+
* words, joined with ", " (e.g. "Friday, 17 July 2026, today, 3 events").
|
|
453
|
+
*/
|
|
454
|
+
function dayAccessibilityLabel(args) {
|
|
455
|
+
const { labels } = args;
|
|
456
|
+
return [
|
|
457
|
+
args.dateLabel,
|
|
458
|
+
args.isToday ? labels.today : null,
|
|
459
|
+
args.isSelected ? labels.selected : null,
|
|
460
|
+
args.isDisabled ? labels.unavailable : null,
|
|
461
|
+
args.hasEvents ? labels.hasEvents : null,
|
|
462
|
+
args.eventCount == null ? null : labels.eventCount(args.eventCount)
|
|
463
|
+
].filter(Boolean).join(", ");
|
|
464
|
+
}
|
|
465
|
+
//#endregion
|
|
417
466
|
//#region src/utils/eventDisplay.ts
|
|
418
467
|
/**
|
|
419
468
|
* Minimum event-box height (px) before the built-in renderer shows the time line
|
|
@@ -429,8 +478,9 @@ function titleEllipsizeMode(ellipsizeTitle) {
|
|
|
429
478
|
* range (which the grid otherwise only conveys visually). Empty title is dropped.
|
|
430
479
|
*/
|
|
431
480
|
function eventAccessibilityLabel(args) {
|
|
481
|
+
const labels = args.labels ?? defaultCalendarLabels;
|
|
432
482
|
const timeFormat = args.ampm ? "h:mm a" : "HH:mm";
|
|
433
|
-
const time = args.isAllDay ? args.allDayLabel ??
|
|
483
|
+
const time = args.isAllDay ? args.allDayLabel ?? labels.allDayEvent : labels.timeRange(format(args.start, timeFormat), format(args.end, timeFormat));
|
|
434
484
|
return [args.title, time].filter(Boolean).join(", ");
|
|
435
485
|
}
|
|
436
486
|
/**
|
|
@@ -1087,7 +1137,8 @@ function isAllDayEvent(event) {
|
|
|
1087
1137
|
*/
|
|
1088
1138
|
function eventDayKeys(event) {
|
|
1089
1139
|
const first = startOfDay(event.start);
|
|
1090
|
-
const
|
|
1140
|
+
const lastInstant = event.end > event.start ? /* @__PURE__ */ new Date(event.end.getTime() - 1) : event.start;
|
|
1141
|
+
const last = startOfDay(lastInstant);
|
|
1091
1142
|
const keys = [];
|
|
1092
1143
|
for (let cursor = first; cursor <= last; cursor = addDays(cursor, 1)) keys.push(cursor.toISOString());
|
|
1093
1144
|
return keys;
|
|
@@ -1520,4 +1571,4 @@ function expandRecurringEvents(events, rangeStart, rangeEnd) {
|
|
|
1520
1571
|
return out;
|
|
1521
1572
|
}
|
|
1522
1573
|
//#endregion
|
|
1523
|
-
export { CalendarSelectionProvider, MIN_BOX_HEIGHT_FOR_TIME, backgroundBandsForDay, bandRounding, buildMonthGrid, buildMonthWeeks, cellRangeFromDrag, clampMoveStartMinutes, closedHourBands, compareDayEvents, darkColors, dayBadgeKind, daySelectionState, eventAccessibilityLabel, eventChipLayout, eventDayKeys, eventTimeLabel, eventsInTimeZone, eventsOverlap, expandRecurringEvents, filterHiddenDays, formatHour, getIsToday, getViewDays, getWeekDays, getYearMonths, groupEventsByDay, isAllDayEvent, isBackgroundEvent, isDateSelectable, isRangeEndpoint, isSameCalendarDay, isTimeVisibleAtHeight, isWeekend, isWithinDateRange, layoutDayEvents, layoutMonthWeek, lightColors, minutesIntoDay, monthCreateRange, monthDropBounds, monthEventCapacity, monthVisibleCount, nextDateRange, overlapsOtherEvents, pageStepDays, parseICalendar, rangeBandKind, resolveDraggedBounds, shiftMinutes, snapDeltaMinutes, titleEllipsizeMode, titleNumberOfLines, toICalendar, toZonedTime, useCalendarSelection, useDateRange, useEventSource, useMonthGrid, useNow, viewDayCount, weekDaysCount, weekdayFormatToken, zonedTimeToUtc };
|
|
1574
|
+
export { CalendarSelectionProvider, MIN_BOX_HEIGHT_FOR_TIME, backgroundBandsForDay, bandRounding, buildMonthGrid, buildMonthWeeks, cellRangeFromDrag, clampMoveStartMinutes, closedHourBands, compareDayEvents, darkColors, dayAccessibilityLabel, dayBadgeKind, daySelectionState, defaultCalendarLabels, eventAccessibilityLabel, eventChipLayout, eventDayKeys, eventTimeLabel, eventsInTimeZone, eventsOverlap, expandRecurringEvents, filterHiddenDays, formatHour, getIsToday, getViewDays, getWeekDays, getYearMonths, groupEventsByDay, isAllDayEvent, isBackgroundEvent, isDateSelectable, isRangeEndpoint, isSameCalendarDay, isTimeVisibleAtHeight, isWeekend, isWithinDateRange, layoutDayEvents, layoutMonthWeek, lightColors, minutesIntoDay, monthCreateRange, monthDropBounds, monthEventCapacity, monthVisibleCount, nextDateRange, overlapsOtherEvents, pageStepDays, parseICalendar, rangeBandKind, resolveCalendarLabels, resolveDraggedBounds, shiftMinutes, snapDeltaMinutes, titleEllipsizeMode, titleNumberOfLines, toICalendar, toZonedTime, useCalendarSelection, useDateRange, useEventSource, useMonthGrid, useNow, viewDayCount, weekDaysCount, weekdayFormatToken, zonedTimeToUtc };
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@super-calendar/core",
|
|
3
|
-
"version": "2.11.
|
|
3
|
+
"version": "2.11.1",
|
|
4
4
|
"description": "Render-agnostic core for super-calendar: date math, selection model, event layout, the month-grid builder, headless hooks, and neutral theme tokens. No renderer.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"calendar",
|
package/src/index.ts
CHANGED
|
@@ -24,6 +24,7 @@ export * from "./utils/dates";
|
|
|
24
24
|
export * from "./utils/drag";
|
|
25
25
|
export * from "./utils/eventDisplay";
|
|
26
26
|
export * from "./utils/ical";
|
|
27
|
+
export * from "./utils/labels";
|
|
27
28
|
export * from "./utils/useNow";
|
|
28
29
|
export * from "./utils/useEventSource";
|
|
29
30
|
export * from "./utils/layout";
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { format } from "date-fns";
|
|
2
2
|
import type { CalendarEvent, CalendarMode } from "../types";
|
|
3
|
+
import { type CalendarLabels, defaultCalendarLabels } from "./labels";
|
|
3
4
|
|
|
4
5
|
/**
|
|
5
6
|
* Minimum event-box height (px) before the built-in renderer shows the time line
|
|
@@ -22,13 +23,16 @@ export function eventAccessibilityLabel(args: {
|
|
|
22
23
|
start: Date;
|
|
23
24
|
end: Date;
|
|
24
25
|
ampm: boolean;
|
|
25
|
-
/** Spoken text for an all-day event. Default
|
|
26
|
+
/** Spoken text for an all-day event. Default `labels.allDayEvent`. */
|
|
26
27
|
allDayLabel?: string;
|
|
28
|
+
/** Words for the all-day text and the time range. Default English. */
|
|
29
|
+
labels?: CalendarLabels;
|
|
27
30
|
}): string {
|
|
31
|
+
const labels = args.labels ?? defaultCalendarLabels;
|
|
28
32
|
const timeFormat = args.ampm ? "h:mm a" : "HH:mm";
|
|
29
33
|
const time = args.isAllDay
|
|
30
|
-
? (args.allDayLabel ??
|
|
31
|
-
:
|
|
34
|
+
? (args.allDayLabel ?? labels.allDayEvent)
|
|
35
|
+
: labels.timeRange(format(args.start, timeFormat), format(args.end, timeFormat));
|
|
32
36
|
return [args.title, time].filter(Boolean).join(", ");
|
|
33
37
|
}
|
|
34
38
|
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
import type { CalendarMode } from "../types";
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Words the built-in views add to their screen-reader labels and gutter text.
|
|
5
|
+
* The date parts are formatted through `locale`; these words are not, so pass
|
|
6
|
+
* translations through the `labels` prop to localize them. Shared by both
|
|
7
|
+
* renderers, so a translation reads the same on web and native.
|
|
8
|
+
*/
|
|
9
|
+
export interface CalendarLabels {
|
|
10
|
+
/** Appended to a day's label when it is today. Default "today". */
|
|
11
|
+
today: string;
|
|
12
|
+
/** Appended to a day's label when it is selected. Default "selected". */
|
|
13
|
+
selected: string;
|
|
14
|
+
/** Appended to a day's label when it is disabled. Default "unavailable". */
|
|
15
|
+
unavailable: string;
|
|
16
|
+
/** Appended to a year-view day's label when it has events. Default "has events". */
|
|
17
|
+
hasEvents: string;
|
|
18
|
+
/** How many events a month-view day holds. Default "1 event" / "N events". */
|
|
19
|
+
eventCount: (count: number) => string;
|
|
20
|
+
/** The "+N more" overflow control's label. Default "N more events". */
|
|
21
|
+
moreEvents: (count: number) => string;
|
|
22
|
+
/** The all-day gutter text in the time grid. Default "all-day". */
|
|
23
|
+
allDay: string;
|
|
24
|
+
/**
|
|
25
|
+
* Spoken in an all-day event's label (e.g. "Trip, all day"). Default "all day".
|
|
26
|
+
* On native, a `Calendar` `allDayLabel` takes precedence.
|
|
27
|
+
*/
|
|
28
|
+
allDayEvent: string;
|
|
29
|
+
/** A timed event's spoken range from its formatted times. Default "09:00 to 10:00". */
|
|
30
|
+
timeRange: (start: string, end: string) => string;
|
|
31
|
+
/** The close control of the "+N more" popover. Default "Close". */
|
|
32
|
+
close: string;
|
|
33
|
+
/** Screen-reader action that moves an event later by `minutes`. Default "Move 15 minutes later". */
|
|
34
|
+
moveLater: (minutes: number) => string;
|
|
35
|
+
/** Screen-reader action that moves an event earlier by `minutes`. Default "Move 15 minutes earlier". */
|
|
36
|
+
moveEarlier: (minutes: number) => string;
|
|
37
|
+
/** Screen-reader action that lengthens an event by `minutes`. Default "Extend by 15 minutes". */
|
|
38
|
+
extend: (minutes: number) => string;
|
|
39
|
+
/** Screen-reader action that shortens an event by `minutes`. Default "Shorten by 15 minutes". */
|
|
40
|
+
shorten: (minutes: number) => string;
|
|
41
|
+
/**
|
|
42
|
+
* Screen-reader action that moves an event one page forward, given the page's
|
|
43
|
+
* day count and the view mode. Default "Move to next week" in week mode, else
|
|
44
|
+
* "Move to next day" / "Move to next 3 days".
|
|
45
|
+
*/
|
|
46
|
+
moveToNextPage: (days: number, mode: CalendarMode) => string;
|
|
47
|
+
/** The backward counterpart of `moveToNextPage`. Default "Move to previous week". */
|
|
48
|
+
moveToPreviousPage: (days: number, mode: CalendarMode) => string;
|
|
49
|
+
/** Resource timeline action that moves an event to another lane. Default "Move to Room A". */
|
|
50
|
+
moveToResource: (title: string) => string;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
const minutes = (n: number) => `${n} minute${n === 1 ? "" : "s"}`;
|
|
54
|
+
const page = (days: number, mode: CalendarMode) =>
|
|
55
|
+
mode === "week" ? "week" : days === 1 ? "day" : `${days} days`;
|
|
56
|
+
|
|
57
|
+
/** The built-in English {@link CalendarLabels}. */
|
|
58
|
+
export const defaultCalendarLabels: CalendarLabels = {
|
|
59
|
+
today: "today",
|
|
60
|
+
selected: "selected",
|
|
61
|
+
unavailable: "unavailable",
|
|
62
|
+
hasEvents: "has events",
|
|
63
|
+
eventCount: (count) => (count === 1 ? "1 event" : `${count} events`),
|
|
64
|
+
moreEvents: (count) => `${count} more events`,
|
|
65
|
+
allDay: "all-day",
|
|
66
|
+
allDayEvent: "all day",
|
|
67
|
+
timeRange: (start, end) => `${start} to ${end}`,
|
|
68
|
+
close: "Close",
|
|
69
|
+
moveLater: (n) => `Move ${minutes(n)} later`,
|
|
70
|
+
moveEarlier: (n) => `Move ${minutes(n)} earlier`,
|
|
71
|
+
extend: (n) => `Extend by ${minutes(n)}`,
|
|
72
|
+
shorten: (n) => `Shorten by ${minutes(n)}`,
|
|
73
|
+
moveToNextPage: (days, mode) => `Move to next ${page(days, mode)}`,
|
|
74
|
+
moveToPreviousPage: (days, mode) => `Move to previous ${page(days, mode)}`,
|
|
75
|
+
moveToResource: (title) => `Move to ${title}`,
|
|
76
|
+
};
|
|
77
|
+
|
|
78
|
+
/** Fill the labels a consumer left out with {@link defaultCalendarLabels}. */
|
|
79
|
+
export function resolveCalendarLabels(labels?: Partial<CalendarLabels>): CalendarLabels {
|
|
80
|
+
return labels ? { ...defaultCalendarLabels, ...labels } : defaultCalendarLabels;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/**
|
|
84
|
+
* Screen-reader label for a day: the formatted date followed by its state
|
|
85
|
+
* words, joined with ", " (e.g. "Friday, 17 July 2026, today, 3 events").
|
|
86
|
+
*/
|
|
87
|
+
export function dayAccessibilityLabel(args: {
|
|
88
|
+
/** The date, already formatted with the consumer's locale. */
|
|
89
|
+
dateLabel: string;
|
|
90
|
+
isToday?: boolean;
|
|
91
|
+
isSelected?: boolean;
|
|
92
|
+
isDisabled?: boolean;
|
|
93
|
+
hasEvents?: boolean;
|
|
94
|
+
/** Event count to announce; omit to leave the count out. */
|
|
95
|
+
eventCount?: number;
|
|
96
|
+
labels: CalendarLabels;
|
|
97
|
+
}): string {
|
|
98
|
+
const { labels } = args;
|
|
99
|
+
return [
|
|
100
|
+
args.dateLabel,
|
|
101
|
+
args.isToday ? labels.today : null,
|
|
102
|
+
args.isSelected ? labels.selected : null,
|
|
103
|
+
args.isDisabled ? labels.unavailable : null,
|
|
104
|
+
args.hasEvents ? labels.hasEvents : null,
|
|
105
|
+
args.eventCount == null ? null : labels.eventCount(args.eventCount),
|
|
106
|
+
]
|
|
107
|
+
.filter(Boolean)
|
|
108
|
+
.join(", ");
|
|
109
|
+
}
|
package/src/utils/monthGrid.ts
CHANGED
|
@@ -229,22 +229,20 @@ export function buildMonthGrid(month: Date, options: UseMonthGridOptions = {}):
|
|
|
229
229
|
|
|
230
230
|
const weeks: MonthGridWeek[] = rows.map((days) => ({
|
|
231
231
|
id: days[0].toISOString(),
|
|
232
|
-
days: days.map(
|
|
233
|
-
|
|
232
|
+
days: days.map((date): MonthGridDay => ({
|
|
233
|
+
date,
|
|
234
|
+
id: format(date, "yyyy-MM-dd"),
|
|
235
|
+
label: format(date, "d"),
|
|
236
|
+
isCurrentMonth: isSameMonth(date, month),
|
|
237
|
+
isToday: getIsToday(date),
|
|
238
|
+
isWeekend: isWeekend(date),
|
|
239
|
+
// Shared with MonthView, so the headless grid matches the built-in view.
|
|
240
|
+
...daySelectionState(
|
|
234
241
|
date,
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
isWeekend: isWeekend(date),
|
|
240
|
-
// Shared with MonthView, so the headless grid matches the built-in view.
|
|
241
|
-
...daySelectionState(
|
|
242
|
-
date,
|
|
243
|
-
{ selectedDates, selectedRange },
|
|
244
|
-
{ minDate, maxDate, isDateDisabled },
|
|
245
|
-
),
|
|
246
|
-
}),
|
|
247
|
-
),
|
|
242
|
+
{ selectedDates, selectedRange },
|
|
243
|
+
{ minDate, maxDate, isDateDisabled },
|
|
244
|
+
),
|
|
245
|
+
})),
|
|
248
246
|
}));
|
|
249
247
|
|
|
250
248
|
// Weekday labels depend only on the first row's dates (already ordered).
|