Release Notes
Scheduler Changelog
Every release of @sv5ui/scheduler. It is a separate package with its own version numbers, so nothing here lines up with an
sv5ui release of the same name. Until 1.0.0 a minor release may change the API; see the
stability note on the Introduction page.
New Features
- One component with month, week, day, year and agenda views. bind:events keeps a plain array as the single source of truth: every change made in the UI is written back, and a change to any field of an event in the array, recurrence included, reaches the calendar. view and date are bindable docs →
- Saving through onMutate . Changes show at once, run in order per event and in parallel across events, and slide back with onError when a save fails. onConflict picks keep-server or keep-local when the server answers with a different version; an id assigned by the server is adopted; a confirmed save survives a refetch that lands while it is in flight docs →
- source loads events for the visible range only. Covered ranges are not asked for again, stale requests are aborted, a slow request shows a thin progress bar, and onLoadError reports failures docs →
- createPanel and bindable draft open your own form inside the calendar after a drag over empty slots or Enter on a focused slot; create saves through the same pipeline as drag and drop. onSelectSlot and onEventClick let an app open its own dialog instead docs →
- Event details as a popover, a slide-over whose body eventPanel can replace, with update and remove going through the save pipeline, or nothing; eventDetail adds content to both docs →
- days for custom week lengths, weekStartsOn , hiddenDays , dayStartHour and dayEndHour , slotMinutes and slotHeight , ISO 8601 weekNumbers , businessHours and holidays docs →
- height in pixels or any CSS length; without one the scheduler fills a bounded parent or grows with its content. Below compactBreakpoint a phone layout: a one row toolbar with a view menu, compactDays in the week, details in a slide-over docs →
- timeZone accepts any IANA zone and can change at runtime without a refetch. ISO strings with Z or an offset, naive strings, date-only strings and ZonedDateTime values are read. The week and day views name the zone, and details name it when it differs from the device zone docs →
- locale , hour12 , dir="rtl" and label packs for thirteen languages through @sv5ui/scheduler/locales . Partial labels fall back to English docs →
- Recurring events with freq , interval , byDay , count , until and exDates , expanded for the visible range only. A series given as a ZonedDateTime keeps its zone. Other RFC 5545 fields are accepted, reported once in development and ignored docs →
- calendars with colours, bindable hiddenCalendars and search , and a filter predicate docs →
- sidebar with a date navigator, search, calendar list and drag list, docked at sidebarSide or a slide-over below sidebarBreakpoint . sidebarOpen is bindable; sidebarHeader , sidebarFooter or a sidebar snippet customise it docs →
- Snippets for event , cell , header , eventDetail , eventPanel , createPanel , empty , toolbar and toolbarActions ; toolbar={false} hides the toolbar. The event snippet is used everywhere an event is drawn and keeps the click behaviour of the default chip docs →
- Per instance extension points views , layouts , interactions and middleware , the same ones the built-in features are made of docs →
- Select, drag to create, move, resize from both ends and across days, drop a timed event on the all-day row, and move month events to another day keeping their time. Touch drags start after a short press so the page still scrolls. creatable and editable switch creation and editing off; editable: false locks one event. dragSource turns any element into something that can be dropped on the grid docs →
- The grid is a single named tab stop with arrow, Home, End, Page Up, Page Down, Enter, Space, Escape and Delete keys; Space selects the event at the focused slot and cycles through overlapping ones. Delete on a locked event or an occurrence says why nothing happened. Moves, creations, deletions, rollbacks and conflicts are announced docs →
- DateNavigator , CalendarList , SearchBox , DragSourceList and EventChip exported for layouts of your own, together with the five views. Each forwards HTML attributes to its root element docs →
- Drawn with sv5ui theme tokens, dark mode included. ui slots per instance and defineSchedulerConfig for defaults across instances. @sv5ui/scheduler/theme.css registers the package with Tailwind next to sv5ui/theme.css . Rendering on the server never touches window docs →