@super-calendar/solid 2.17.0 → 2.19.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +46 -9
- package/dist/client/index.d.ts +56 -14
- package/dist/client/index.js +683 -406
- package/dist/server/index.d.ts +56 -14
- package/dist/server/index.js +1418 -1238
- package/package.json +7 -7
- package/src/Agenda.tsx +19 -2
- package/src/Calendar.tsx +108 -30
- package/src/MonthList.tsx +1 -1
- package/src/MonthView.tsx +220 -29
- package/src/TimeGrid.tsx +350 -155
- package/src/YearView.tsx +17 -1
package/dist/server/index.d.ts
CHANGED
|
@@ -95,6 +95,13 @@ interface AgendaProps<T = unknown> extends SlotStyleProps<AgendaSlot> {
|
|
|
95
95
|
events: CalendarEvent$1<T>[];
|
|
96
96
|
/** date-fns locale for the day headers and time labels. */
|
|
97
97
|
locale?: Locale;
|
|
98
|
+
/**
|
|
99
|
+
* The instant whose calendar day is highlighted as today. Defaults to the
|
|
100
|
+
* device clock, and is read in `timeZone` when one is set.
|
|
101
|
+
*/
|
|
102
|
+
now?: Date;
|
|
103
|
+
/** Highlight today as it is in this IANA time zone (default: the device's). */
|
|
104
|
+
timeZone?: string;
|
|
98
105
|
/** Render times in 12-hour AM/PM (default false, 24h). */
|
|
99
106
|
ampm?: boolean;
|
|
100
107
|
/** Highlight this date's header instead of the real "today". */
|
|
@@ -136,7 +143,7 @@ export declare function Agenda<T = unknown>(incoming: AgendaProps<T>): JSX.Eleme
|
|
|
136
143
|
* Styleable parts of {@link MonthView}. Pass a class or inline style per slot via
|
|
137
144
|
* the `classNames` / `styles` props to restyle just that part.
|
|
138
145
|
*/
|
|
139
|
-
type MonthViewSlot = "title" | "weekdays" | "weekday" | "grid" | "week" | "day" | "dayBadge" | "rangeBand" | "events" | "chipButton" | "chip" | "more" | "morePopover";
|
|
146
|
+
type MonthViewSlot = "title" | "weekdays" | "weekday" | "grid" | "week" | "day" | "dayBadge" | "rangeBand" | "events" | "createGhost" | "chipButton" | "chip" | "more" | "morePopover";
|
|
140
147
|
/** Props passed to a custom month event chip renderer. */
|
|
141
148
|
interface SolidMonthEventArgs<T = unknown> {
|
|
142
149
|
/** The event to render. */
|
|
@@ -210,6 +217,13 @@ interface MonthViewProps<T = unknown> extends DateSelectionConstraints$1, SlotSt
|
|
|
210
217
|
showWeekdays?: boolean;
|
|
211
218
|
/** date-fns locale for the title and weekday labels. */
|
|
212
219
|
locale?: Locale;
|
|
220
|
+
/**
|
|
221
|
+
* The instant whose calendar day is highlighted as today. Defaults to the
|
|
222
|
+
* device clock, and is read in `timeZone` when one is set.
|
|
223
|
+
*/
|
|
224
|
+
now?: Date;
|
|
225
|
+
/** Highlight today as it is in this IANA time zone (default: the device's). */
|
|
226
|
+
timeZone?: string;
|
|
213
227
|
/** Theme overrides; falls back to the default light theme. */
|
|
214
228
|
theme?: Partial<SolidCalendarTheme>;
|
|
215
229
|
/** Fired when a selectable day is clicked. */
|
|
@@ -227,6 +241,12 @@ interface MonthViewProps<T = unknown> extends DateSelectionConstraints$1, SlotSt
|
|
|
227
241
|
* carry `data-creating` for styling.
|
|
228
242
|
*/
|
|
229
243
|
onCreateEvent?: (start: Date, end: Date) => void;
|
|
244
|
+
/**
|
|
245
|
+
* Custom content for a drag-to-create preview, once per covered week row.
|
|
246
|
+
* Receives the full all-day range with an exclusive end. Requires onCreateEvent.
|
|
247
|
+
* Content is clipped, noninteractive, and hidden from assistive technology.
|
|
248
|
+
*/
|
|
249
|
+
renderCreateGhost?: Component<CreateGhostArgs$1>;
|
|
230
250
|
/**
|
|
231
251
|
* Reports the day span of a create sweep **as it happens**, as the ordered
|
|
232
252
|
* inclusive `[start, end]` days (both at midnight), so a selection highlight can
|
|
@@ -282,7 +302,12 @@ type EventActionsSlot = "eventActionsTrigger" | "eventActionsList" | "eventActio
|
|
|
282
302
|
type TimeGridSlot = "header" | "weekNumber" | "columnHeader" | "columnHeaderWeekday" | "columnHeaderDate" | "allDayLane" | "allDayLabel" | "allDayColumn" | "allDayEvent" | "hourGutter" | "hourLabel" | "dayColumn" | "gridLines" | "businessHours" | "backgroundEvent" | "event" | "eventBox" | "nowIndicator" | "createGhost" | EventActionsSlot;
|
|
283
303
|
/** Props passed to a custom time-grid event renderer. */
|
|
284
304
|
interface SolidRenderEventArgs<T = unknown> {
|
|
285
|
-
/**
|
|
305
|
+
/**
|
|
306
|
+
* The event to render. While it is being moved or resized, a copy whose
|
|
307
|
+
* `start` and `end` are the times `onDragEvent` would report on release.
|
|
308
|
+
* After a drag pages the view, the floating preview keeps the stored times
|
|
309
|
+
* until release.
|
|
310
|
+
*/
|
|
286
311
|
event: CalendarEvent$1<T>;
|
|
287
312
|
/** The current view mode. */
|
|
288
313
|
mode: CalendarMode$1;
|
|
@@ -290,9 +315,9 @@ interface SolidRenderEventArgs<T = unknown> {
|
|
|
290
315
|
isAllDay: boolean;
|
|
291
316
|
/** Pixel height of the event box (timed events only). */
|
|
292
317
|
boxHeight?: number;
|
|
293
|
-
/**
|
|
318
|
+
/** Starts before the visible day (timed) or visible date range (all-day). */
|
|
294
319
|
continuesBefore?: boolean;
|
|
295
|
-
/**
|
|
320
|
+
/** Ends after the visible day (timed) or visible date range (all-day). */
|
|
296
321
|
continuesAfter?: boolean;
|
|
297
322
|
/** Show the time range in 12-hour AM/PM. */
|
|
298
323
|
ampm?: boolean;
|
|
@@ -378,9 +403,15 @@ interface TimeGridProps<T = unknown> extends SlotStyleProps<TimeGridSlot> {
|
|
|
378
403
|
renderBackgroundEvent?: SolidRenderEvent<T>;
|
|
379
404
|
/** Show the current-time indicator on today's column (default true). */
|
|
380
405
|
showNowIndicator?: boolean;
|
|
381
|
-
/**
|
|
406
|
+
/**
|
|
407
|
+
* Fixed "now" instant for the indicator (doesn't tick) and for the day
|
|
408
|
+
* highlighted as today. Defaults to the device clock.
|
|
409
|
+
*/
|
|
382
410
|
now?: Date;
|
|
383
|
-
/**
|
|
411
|
+
/**
|
|
412
|
+
* Shift the now indicator and the day highlighted as today into this IANA zone
|
|
413
|
+
* (pair with `eventsInTimeZone`).
|
|
414
|
+
*/
|
|
384
415
|
timeZone?: string;
|
|
385
416
|
/** Show the all-day lane above the grid (default true). */
|
|
386
417
|
showAllDayEventCell?: boolean;
|
|
@@ -448,7 +479,7 @@ interface TimeGridProps<T = unknown> extends SlotStyleProps<TimeGridSlot> {
|
|
|
448
479
|
* Return `false` to reject the drop (the event snaps back).
|
|
449
480
|
*/
|
|
450
481
|
onDragEvent?: (event: CalendarEvent$1<T>, start: Date, end: Date) => void | boolean;
|
|
451
|
-
/** Stable, unique
|
|
482
|
+
/** Stable, unique identity for the editing dialog and all-day bars across data refreshes. */
|
|
452
483
|
getEventId?: (event: CalendarEvent$1<T>) => string | number;
|
|
453
484
|
/**
|
|
454
485
|
* Page the grid to a new anchor date. Supplying it alongside `onDragEvent`
|
|
@@ -494,6 +525,13 @@ interface YearViewProps<T = unknown> extends DateSelectionConstraints$1, SlotSty
|
|
|
494
525
|
/** Weekdays (0=Sunday…6=Saturday) hidden from the grid, e.g. `[0, 6]` for weekends off. */
|
|
495
526
|
hiddenDays?: number[];
|
|
496
527
|
locale?: Locale;
|
|
528
|
+
/**
|
|
529
|
+
* The instant whose calendar day is highlighted as today. Defaults to the
|
|
530
|
+
* device clock, and is read in `timeZone` when one is set.
|
|
531
|
+
*/
|
|
532
|
+
now?: Date;
|
|
533
|
+
/** Highlight today as it is in this IANA time zone (default: the device's). */
|
|
534
|
+
timeZone?: string;
|
|
497
535
|
/** Translations for the screen-reader words; omitted keys use English. */
|
|
498
536
|
labels?: Partial<CalendarLabels$1>;
|
|
499
537
|
/** Highlight this date instead of the real "today". */
|
|
@@ -575,9 +613,10 @@ interface CalendarProps<T = unknown> extends DateSelectionConstraints$1, SlotSty
|
|
|
575
613
|
/** Weekdays (0=Sunday…6=Saturday) hidden from the grid, e.g. `[0, 6]` for weekends off. */
|
|
576
614
|
hiddenDays?: number[];
|
|
577
615
|
/**
|
|
578
|
-
* Fixed "now" instant for the current-time indicator (doesn't tick)
|
|
579
|
-
*
|
|
580
|
-
*
|
|
616
|
+
* Fixed "now" instant for the current-time indicator (doesn't tick) and for
|
|
617
|
+
* the day highlighted as today in every mode, e.g. a server-synced clock.
|
|
618
|
+
* Defaults to the device clock, shifted into `timeZone` when one is set so
|
|
619
|
+
* both match the displayed events.
|
|
581
620
|
*/
|
|
582
621
|
now?: Date;
|
|
583
622
|
/** Column count for `mode="custom"`. */
|
|
@@ -589,7 +628,9 @@ interface CalendarProps<T = unknown> extends DateSelectionConstraints$1, SlotSty
|
|
|
589
628
|
/**
|
|
590
629
|
* Display events in this IANA time zone (e.g. `"America/New_York"`), DST-correct
|
|
591
630
|
* and independent of the device zone. Display-only: it shifts the wall-clock the
|
|
592
|
-
* grid lays out from, it doesn't change your `Date`s
|
|
631
|
+
* grid lays out from, it doesn't change your `Date`s, and callbacks report your
|
|
632
|
+
* own events and real instants. All-day events stay on their days. Uses
|
|
633
|
+
* `eventsInTimeZone`.
|
|
593
634
|
*/
|
|
594
635
|
timeZone?: string;
|
|
595
636
|
/** Theme overrides; falls back to the default light theme. */
|
|
@@ -683,8 +724,9 @@ interface CalendarProps<T = unknown> extends DateSelectionConstraints$1, SlotSty
|
|
|
683
724
|
*/
|
|
684
725
|
onCreateEvent?: (start: Date, end: Date) => void;
|
|
685
726
|
/**
|
|
686
|
-
* A component that draws content inside
|
|
687
|
-
*
|
|
727
|
+
* A component that draws content inside a creation preview in time-grid, month
|
|
728
|
+
* and multi-week modes. Month rows receive the full all-day range with an
|
|
729
|
+
* exclusive end, once per covered row. Requires onCreateEvent.
|
|
688
730
|
*/
|
|
689
731
|
renderCreateGhost?: Component<CreateGhostArgs$1>;
|
|
690
732
|
/** Fires when an event drag begins. */
|
|
@@ -695,7 +737,7 @@ interface CalendarProps<T = unknown> extends DateSelectionConstraints$1, SlotSty
|
|
|
695
737
|
* days dragged so the time of day and duration are kept.
|
|
696
738
|
*/
|
|
697
739
|
onDragEvent?: (event: CalendarEvent$1<T>, start: Date, end: Date) => void | boolean;
|
|
698
|
-
/** Stable, unique
|
|
740
|
+
/** Stable, unique identity for the editing dialog and time-grid all-day bars across data refreshes. */
|
|
699
741
|
getEventId?: (event: CalendarEvent$1<T>) => string | number;
|
|
700
742
|
/** Tap a day's column header. */
|
|
701
743
|
onPressDateHeader?: (day: Date) => void;
|