# Changelog

What changed in each registry item, newest first, with breaking changes called out.

Every pull request merged to `main` goes live in the registry right away, so this page lists changes by the day they merged. Find the day you last ran `add`, read up from there, then [update](/docs/installation#updating). Each entry names the items whose files changed. Changes to the docs, the demo and the tests are left out.

Entries marked **Breaking** can stop your code from compiling or change what it does after you update. Each one says what to change.

## Unreleased

Live in the registry, but not in a tagged release yet.

### November 17, 2026

- **Improved** `calendar-core`, `event-details`, `time-grid`, `month-view`, `details-sidebar`, `calendar-app`: creating an event works the way it does in Notion Calendar. Double-click an empty slot for a 30-minute event, or press and drag to draw one of any length, up, down or across days; both ends snap to `snapMinutes`. The all-day row and the month view do the same for all-day events, and a long press does it on touch. The new event is a draft: a tinted range, selected, with its title focused, that isn't stored until its first edit. Naming it (`Enter`, or leaving the title) or changing any other field saves it, and the first title keystroke turns the tint into an event block. `Esc` leaves the title and then throws the draft away, as does a click elsewhere while nothing was typed, and `Esc` mid-drag drops it. `C` and "Create event..." start a draft too, drawn as an event block from the start, half an hour long, or all-day in month view. An event without a title shows its time in the title's place. `useCalendar()` adds `eventDraft`, `startEventDraft()` and `updateEventDraft()`, `CalendarProvider` adds `defaultEventDuration`, `NewEventRange` adds `isAllDay`, `EventDetailPanel` and `EventDetailPopover` add `onTitlePreview`, and `EventDraftPopover`, `TimeGridEventDraft` and `AllDayEventDraft` are new in `@/components/event-draft`. See [Creating events](/docs/components/calendar-core#creating-events). [#92](https://github.com/vmnog/calendarcn/pull/92)
  - **Breaking:** a single click on an empty slot no longer creates an event. It clears the selection; a double-click or a drag creates.
  - **Breaking:** an event created on the calendar is stored, and reported through `onEventCreate` and `onEventsChange`, when its first edit saves it, not when it appears. `onEventCreate` gets it with the title it was given, once. `onEventSelect` is called for the draft, with the id it keeps. `addEventFromRange()` still adds its event at once.
  - **Breaking:** new events start 30 minutes long, not 60, at the quarter hour nearest the pointer rather than the one before it. Pass `defaultEventDuration={60}` for hour-long ones.
  - **Breaking:** the default `createEvent` gives new events no title, not "New event". `createEvent` is also called for whole days, with `isAllDay` set on the range, and its event is made all-day. To keep a default title, return one from your own `createEvent`: `Enter` then saves the draft under it.
  - **Breaking:** `addEventAtNextSlot()`, and so `C` and "Create event...", start a draft instead of storing an hour-long event, and `getNextSlotEventRange()` takes `defaultEventDuration` in its config.
  - **Breaking:** `WeekViewGrid`'s `onEventCreate` is called for a double-click, with an event selected or not. Empty space starts drags through the new `onEventDrawPointerDown`, on `WeekViewGrid` and `WeekViewAllDayRow`.
  - **Breaking:** `useInlineEdit()`'s `onCommit` gets a second argument, `{ textOnFocus, isEnter }`. A handler that takes one argument keeps working.
  - If you render `EventDetailPanel` yourself for the provider's selected event, pass `onTitlePreview` while it is the draft, as [Event Details](/docs/components/event-details#usage) shows. Without it, the first title keystroke saves the draft.
- **Added** `calendar-core`, `event-details`, `time-grid`, `month-view`, `agenda-view`, `command-menu`: selecting several events, as in Notion Calendar. Shift- or `⌘`-click adds an event to the selection (and takes a selected one out), and `⌘A` or the command menu's "Select all visible" selects every event on screen. Delete, cut, copy, paste and duplicate on one of them act on them all, each as one undo step, with Notion's toasts ("2 events deleted", "2 events cut", "2 events copied to clipboard"); dragging one, or `Alt+↓`, moves them all. A date of a repeating event among them changes alone, without asking which events, and a group dragged while the calendar draws in another `timeZone` moves each event by the same time. The full shortcut list (`?`) lists "Select all visible" under Calendar view. `useCalendar()` adds `selectedEventIds`, `setSelectedEventIds`, `toggleEventSelection` and `selectAllVisible`, and `useIsEventInSelection()` is new in `calendar-core`, with the helpers in `@/lib/event-selection`. See [Calendar Core](/docs/components/calendar-core#selecting-several-events). [#91](https://github.com/vmnog/calendarcn/pull/91)
  - **Breaking:** `useCalendarShortcuts()` now handles `⌘A` outside text fields, so it no longer selects the page's text there. If your app uses it, handle it in a `keydown` listener added before the hook's and call `event.stopImmediatePropagation()`.
  - **Breaking:** while several events are selected, `selectedEventId` and `selectedEvent` are `null`. An object you type as `CalendarContextValue` yourself, like a test mock, needs the four new members.
- **Added** `calendar-core`, `time-grid`, `details-sidebar`, `calendar-sidebar`, `command-menu`, `calendar-app`: scheduling, as in Notion Calendar. `S`, the sidebar's Scheduling row or "Share availability..." in the command menu start marking open times on the day and week grid: drag to mark, drag a marked time to move or resize it, and remove it with its ×. The details sidebar shows the scheduling panel with the meeting length, the text and the marked times, and Copy puts the text on the clipboard ("Would 30 min during any of these times (all in EDT) work for you?"). `SchedulingProvider`, `useScheduling()` and `useSchedulingShortcuts()` are new in `calendar-core`, with `formatAvailabilityText()` in `@/lib/availability`; `AvailabilityPanel` and `AvailabilityHint` in `details-sidebar`; `AvailabilityLayer` in `time-grid`. See [Scheduling](/docs/components/scheduling). [#90](https://github.com/vmnog/calendarcn/pull/90)
  - `CalendarApp` and `SchedulingProvider` take `onCreateSchedulingLink`: with it, the Scheduling row opens a menu and the command menu lists "Create recurring scheduling link..." and "Create one-off scheduling link...", which hand a `SchedulingLinkRequest` to your app. `CommandMenu` takes `onShareAvailability` and `onCreateSchedulingLink`.
  - **Breaking:** `CalendarSidebar` shows the Scheduling row only inside a `SchedulingProvider`, and the row is no longer disabled with a "Soon" badge. With `showComingSoon`, the command menu no longer lists the scheduling link commands as "Soon": they show when you pass `onCreateSchedulingLink`. `calendar-sidebar` and `details-sidebar` now need shadcn/ui's `dropdown-menu`.
- **Added** `calendar-settings`, a new item, with `calendar-app`, `command-menu`, `calendar-sidebar`, `details-sidebar` and `ics`: Notion Calendar's account and app controls. `CalendarSettingsDialog` is a settings dialog laid out as Notion's: General (weekends, declined events, week numbers, number of days, time format, theme) and each calendar account's calendars, each setting shown when something can change it. `CommandMenu` adds `onOpenSettings` ("Go to settings"), `onAddCalendarAccount`, `onManageCalendarAccounts`, `onSupport` and `onAbout`, `CalendarSidebar` adds `onAddCalendarAccount`, and `CalendarApp` adds `settingsDialog`, `onAddCalendarAccount` (with `importIcsCalendar()`, which adds an .ics file as a calendar), `onSupport` and `onAbout`. `toIcsCalendar()` is new in `@/lib/ics`. [#87](https://github.com/vmnog/calendarcn/pull/87)
  - **Breaking:** without `onAddCalendarAccount`, `CalendarSidebar` no longer draws "Add calendar account" (it was disabled with "Soon"). "Add Google Calendar account" is now "Add calendar account", and the command menu and the useful shortcuts no longer list "Get CalendarCN mobile app", "Log out", "Check for update" or "Menu bar calendar", even with `showComingSoon`.
- **Added** `calendar-core`, `time-grid`, `calendar-sidebar`, `command-menu`, `details-sidebar`, `calendar-app`, `sample-data`: meet with people and show a teammate's calendar, as in Notion Calendar. The sidebar's "Meet with..." field, `F` and "Meet with..." in the command menu add people from `contacts`: their events are drawn behind yours in the day and week views, hatched in their color, the times you're all free are highlighted, and an event created meanwhile invites them. `P` and "Show teammate calendar..." show a teammate's calendar without the meeting. The sidebar lists both, each removable. `CalendarProvider` adds `meetWith`, `teammates` (each with its `default` and `on…Change`), `contactEvents` and `workingHours`, `EventContact` adds `color`, and `useCalendarPeople()` is new. `getSharedFreeTime()` is new in `@/lib/free-busy`. `CommandMenu` adds `onMeetWith` and `onShowTeammateCalendar`, and `useCalendarShortcuts()` the same two options. The sample data adds `generateContactEvents()`, four teammates' weeks. See [Meeting with people](/docs/components/calendar-core#meeting-with-people). [#83](https://github.com/vmnog/calendarcn/pull/83)
  - `CalendarSidebar`'s "Meet with..." field is no longer disabled, and the "Useful shortcuts" list "Show teammate calendar" (`P`) without a "Soon" badge. Pass `onShowTeammateCalendar` to `useCalendarShortcuts()` so `P` does what the list says, or pass your own `shortcuts`. The full list (`?`) adds "Meet with..." and "Show teammate calendar" under Workflows, as `SHORTCUTS.meetWith` and `SHORTCUTS.showTeammateCalendar`.
- **Added** `people-picker`, a new item: the dialog `F` and `P` open, to search your contacts and meet with someone or show their calendar. See [People Picker](/docs/components/people-picker). [#83](https://github.com/vmnog/calendarcn/pull/83)
- **Added** `calendar-core`, `time-grid`, `command-menu`, `calendar-header`: the command menu's "Start week on...", "Set number of displayed days...", "Default hour size", "Zoom hours in" and "Zoom hours out" work, as in Notion Calendar. "Start week on..." and "Set number of displayed days..." open a second list in the menu. The week start is controllable like the number of days (`weekStartsOn`, plus `defaultWeekStartsOn` and `onWeekStartsOnChange`), and every view and the mini calendar follow it. The day and week views' hour height is provider state too (`hourHeight`, `defaultHourHeight`, `onHourHeightChange`; `null` fills the screen as before): `⇧⌘.` and `⇧⌘,` zoom through `HOUR_HEIGHT_STEPS` (24 to 160px) keeping the middle of the screen in place, and `⇧⌘0` goes back to the default. `useCalendar()` adds `hourHeight`, `setWeekStartsOn`, `zoomHoursIn`, `zoomHoursOut` and `resetHourHeight`; `getZoomedHourHeight()` and `NUMBER_OF_DAYS_OPTIONS` are new in `calendar-core`. See [Calendar Core](/docs/components/calendar-core#hour-size). [#85](https://github.com/vmnog/calendarcn/pull/85)
  - **Breaking:** `useCalendarShortcuts()` now handles `⇧⌘.`, `⇧⌘,` and `⇧⌘0` (Ctrl on Windows and Linux), and `onOpenSettings` no longer runs on `⇧⌘,`. An object you type as `CalendarContextValue` yourself, like a test mock, needs the five new members.
- **Added** `calendar-core`, `time-grid`, `month-view`, `year-view`, `agenda-view`, `calendar-header`, `command-menu`, `event-details`, `mini-calendar`, `calendar-sidebar`, `ics`, `sample-data`: the view settings work in every view, as in Notion Calendar. With **Weekends** off, day and week view show weekdays only and step over the weekend (the day after Friday is Monday, a full week is Monday to Friday, a drag from Friday to the next column lands on Monday), and year view drops its weekend columns like month view. **Week numbers** show "Week 23" beside the title in day and week view, at each week's start in the agenda, and down the side of the mini calendar. **Declined events** hides the events you declined, and draws them struck through on a dashed outline while it's on. The command menu's "Hide weekends", "Hide declined events" and "Hide week numbers" toggle the same settings and read "Show …" while one is off. `EventParticipant` gains `self`, which marks you among an event's participants; `isDeclinedByViewer()`, `filterDeclinedEvents()`, `getFirstShownDay()`, `addShownDays()`, `countShownDaysBetween()` and `getShownDays()` are new in `calendar-core`, and `parseIcs()` and `toIcs()` read and write participants as `ORGANIZER` and `ATTENDEE`. [#84](https://github.com/vmnog/calendarcn/pull/84)
  - **Breaking:** day and week view's `visibleDays` and `visibleRange` leave the weekend out while it's hidden, and `onVisibleRangeChange` reports that shorter range. If you fetch events by range and hide weekends, nothing changes for weekdays; weekend events are simply not drawn.
  - **Breaking:** "Week 23" beside the title in week view now follows the **Week numbers** setting, which is off by default, and so does the mini calendar's week number column in `CalendarSidebar`. Pass `defaultViewSettings={{ showWeekNumbers: true }}` to keep them. A `MiniCalendar` you render yourself keeps them; pass `showWeekNumber={false}` to hide them.
- **Added** `calendar-core`, `event-details`, `time-grid`, `month-view`, `agenda-view`, `details-sidebar`: changing or deleting one date of a repeating event asks "This event", "This and following events" or "All events", as in Notion Calendar. A drag, resize or menu change asks at once; changes in the details wait, marked with a dot, until you leave the event. "This and following events" ends the series the day before and starts a new one. `updateEvent` and `deleteEvent` take an optional `scope` that skips the question, `editEvent` changes an event the way the details do, and `getSeriesEditChanges()`, `getSeriesDeleteChanges()`, `getEventChangeSummary()` and `EventSeriesScopeDialog` are new. See [Calendar Core](/docs/components/calendar-core#editing-a-repeating-event). [#89](https://github.com/vmnog/calendarcn/pull/89)
  - **Breaking:** `updateEvent` or `deleteEvent` called on a date of a repeating event while a view is mounted now asks which events to change. Pass `"this"` as the second argument to keep changing that date only. Deleting the series' first date no longer deletes the whole series unless you answer "All events".
  - **Breaking:** an object you type as `CalendarContextValue` yourself, like a test mock, needs the new `editEvent` member.
- **Added** `calendar-core`, `command-menu`, `details-sidebar`, `calendar-app`: Notion Calendar's Go to date, Create event, Search events and full keyboard shortcut list. `.` opens the command menu on Go to date, which reads typed dates ("tomorrow", "next friday", "dec 25", "12/25", "in 2 weeks") in the calendar's locale and week start, shows the day with its weekday, and goes there in the current view on `Enter`. `C` and "Create event..." create an event at the next half hour with its title focused. "Search events" (and "Search events for “…”" once you type) opens the details sidebar's search, focused. `?` and "Show keyboard shortcuts" show every shortcut in the details sidebar, with a field to find one. `useCalendar()` adds `navigateToDate` and `addEventAtNextSlot`, `useCalendarShortcuts()` adds `onGoToDate` and `onShowShortcuts`, `CommandMenu` adds `onSearchEvents`, `onShowShortcuts` and `defaultPage`, and `DetailsSidebar` adds `actionsRef` and `shortcutGroups`. `parseDateQuery()` is new in `@/lib/date-query` (with `command-menu`), and `KEYBOARD_SHORTCUT_GROUPS`, `SHORTCUTS` and `findKeyboardShortcuts()` in `@/lib/keyboard-shortcuts`. [#86](https://github.com/vmnog/calendarcn/pull/86)
  - **Breaking:** `useCalendarShortcuts()` now handles `C` outside text fields. If your app uses it, handle it in a `keydown` listener added before the hook's and call `event.stopImmediatePropagation()`. An object you type as `CalendarContextValue` yourself, like a test mock, needs `navigateToDate` and `addEventAtNextSlot`.
- **Added** `calendar-core`, `time-grid`, `month-view`, `agenda-view`, `year-view`, `event-details`, `mini-calendar`, `details-sidebar`, `calendar-app`: `timeZone` on `CalendarProvider` (so also on `Calendar` and `CalendarApp`) draws the calendar on one IANA zone's clock, as Notion Calendar's primary time zone. Events, today, the current-time line, the first day of each week, a click-created event and the details' times follow it, and the time axis is labeled with it. The events you pass in and get back stay instants. `defaultTimeZone` and `onTimeZoneChange` make it provider state like `view`. `toZonedWallClock()`, `fromZonedWallClock()`, `getZonedNow()`, `toDisplayEvent()`, `fromDisplayEvent()` and `fromDisplayRange()` are new in `@/lib/time-zones`; `expandRecurringEvents()` and `findEventOrOccurrence()` take the calendar's zone, and `useNow()`, `useToday()`, `useIsPast()`, `useTimeZoneLabel()` and `useTimeZoneDisplayName()` an optional zone. See [Calendar Core](/docs/components/calendar-core#time-zone). [#88](https://github.com/vmnog/calendarcn/pull/88)
- **Added** `calendar-core`, `time-grid`, `command-menu`, `event-details`, `calendar-app`: Notion Calendar's time zone controls. `secondaryTimeZones` shows any number of additional zones beside the time axis (`secondaryTimeZone` is the one-zone form), with `defaultSecondaryTimeZones` and `onSecondaryTimeZonesChange`. Each zone's label opens a menu to change it, make it primary or secondary, or remove it, and a "+" left of "All-day" adds one. `useCalendar()` adds `timeZones`, `changeTimeZones`, `travelTimeZone` and `travelToTimeZone`, with `addTimeZone()`, `removeTimeZone()`, `makeTimeZonePrimary()`, `makeTimeZoneSecondary()` and `replaceTimeZone()` in `@/lib/time-zones`. The command menu's "Travel to time zone..." and "Show additional time zones..." work, plus "Make time zone primary..." and "Hide time zone...", each with a zone list searched by city, name or offset, and `timeZoneCommand` opens it on one. While travelling the zone travelled to is drawn as the primary one with your home zone beside it, until the x, "Travel back home" or `Esc`; `Z` travels, with `useCalendarShortcuts({ onTravelToTimeZone })`. When the calendar draws in another zone than an event's, the details' time zone row shows the calendar's zone and switches the times to the event's own. See [Calendar Core](/docs/components/calendar-core#additional-time-zones). [#88](https://github.com/vmnog/calendarcn/pull/88)
  - **Breaking:** an object you type as `CalendarContextValue` yourself, like a test mock, needs the four new members, and one you type as `CalendarConfig` needs `secondaryTimeZones`.
  - **Breaking:** the time axis labels are buttons that open a menu, and `secondaryTimeZone` is now held like a controlled prop: removing that zone from its label calls `onSecondaryTimeZonesChange`, and the column stays until you drop the prop. Use `defaultSecondaryTimeZones` to let the labels change the zones.

### November 16, 2026

- **Added** `calendar-core`, `event-details`, `time-grid`, `month-view`, `details-sidebar`, `calendar-app`: delete, duplicate, cut, copy and paste events from the right-click menu, the details' "..." menu and the keyboard (`Delete`, `⌘X`, `⌘C`, `⌘D`, `⌘V`), and undo or redo every change with `⌘Z` and `⇧⌘Z`. `useCalendar()` adds `deleteEvent`, `duplicateEvent`, `copyEvent`, `cutEvent`, `pasteEvent`, `undo`, `redo`, `canUndo` and `canRedo`, `CalendarProvider` adds `onEventDelete`, and `EventDetailPanel` adds `onCut`, `onCopy`, `onDuplicate` and `onDelete`. [#78](https://github.com/vmnog/calendarcn/pull/78)
  - **Breaking:** `useCalendarShortcuts()` now handles `Delete`, `⌫`, `⌘X`, `⌘C`, `⌘V`, `⌘D`, `⌘Z` and `⇧⌘Z` whenever they have something to act on. If your app uses one outside a text field, handle it in a `keydown` listener added before the hook's and call `event.stopImmediatePropagation()`. An object you type as `CalendarContextValue` yourself, like a test mock, needs the nine new members.
- **Added** `calendar-core`, `time-grid`, `month-view`, `agenda-view`, `details-sidebar`, `ics`: a repeating event is drawn on every date of its rule in the day, week, month and agenda views, and event search lists each date. The occurrences are generated for the dates on screen and never added to your events. Dragging, resizing or editing one date stores it as an event of its own with `seriesId` and `originalStart`, reported through `onEventCreate`, and `excludedDates` leaves dates out. `parseIcs()` and `toIcs()` read and write them as `RECURRENCE-ID` and `EXDATE`. `expandRecurringEvents()`, `findEventOrOccurrence()` and `applyRecurringEdit()` are new in `@/lib/recurrence`. See [Calendar Core](/docs/components/calendar-core#repeating-events). [#79](https://github.com/vmnog/calendarcn/pull/79)
  - On a repeating event's dates, Delete and Cut leave that date out of the series (`excludedDates`), reported through `onEventUpdate`, and the series' own first date still deletes the whole series. Editing a generated date is one undo step that removes the stored date again, and Duplicate and Paste on one of its dates add a single event on that date, which doesn't repeat.
  - **Breaking:** an event with a `recurrenceRule` (or an RRULE in `recurrence`) now shows on every date. If you also store each occurrence as an event of its own, drop the rule from those, or give them `seriesId` and `originalStart` so they replace the generated ones.
  - **Breaking:** the series arrows select the next occurrence without adding a copy, so stepping no longer calls `onEventCreate`. The first edit of an occurrence does.
  - **Breaking:** `parseIcs()` names an edited occurrence `<UID>-<yyyy-MM-dd>` instead of `<UID>_<RECURRENCE-ID>`, and turns a cancelled occurrence into an excluded date of its series instead of dropping it. Remove events imported under the old ids before importing the same file again.
  - **Breaking:** `findSeriesOccurrence()` builds a series from its event and the events that name it with `seriesId`, no longer from every event with the same title, calendar and rule. An event whose `recurrence` is display text, alone in its series, has no previous or next occurrence.
  - **Breaking:** if your event type already has an `excludedDates`, `seriesId` or `originalStart` field of another type, it no longer fits `DetailedCalendarEvent`. Rename your field.
- **Added** `calendar-toaster`, a new item, with `calendar-core` and `calendar-app`: Notion Calendar's toasts. Deleting an event shows "Event deleted" with its title and Undo, cutting shows "Event cut" with Undo, and copying shows "Event copied to clipboard". Calendar App shows them at the bottom right of the calendar; elsewhere, render `CalendarToaster`. `useCalendarNotice()` is new in `calendar-core`, to show the notices with a toast library of your own or show your own. See [Calendar Toaster](/docs/components/calendar-toaster). [#82](https://github.com/vmnog/calendarcn/pull/82)
- **Added** `calendar-core`, `time-grid`: `secondaryTimeZone` on `CalendarProvider` (so also on `Calendar` and `CalendarApp`) shows a second time zone's hours in a column left of the day and week views' time axis, with each zone's short label at the top and the now line's one badge staying in the viewer's column. Zones half an hour or 45 minutes off show their minutes ("7:30 PM"). `getTimeZoneOffsetDifference()` and `getSecondaryTimeAxisInstant()` are new in `@/lib/time-zones`, and `formatTimeOfDayLabel()` and `formatNowLineTime()` in `@/lib/event-utils`. [#80](https://github.com/vmnog/calendarcn/pull/80)
- **Added** `year-view`, a new item, with `calendar-core`, `calendar-header`, `command-menu`, `calendar` and `calendar-app`: the year as twelve month grids, like Google Calendar's year view, with today in red and a dot on each day that has events. `Y`, the view switcher and the command menu open it, previous and next move a year, and a click on a day opens its week. `ViewType` gains `"year"`, `monthName` is empty in year view so a title reads "2026", and `countEventsByDay()` is new in `calendar-core`. [#81](https://github.com/vmnog/calendarcn/pull/81)
  - **Breaking:** a `Record<ViewType, …>` or an exhaustive `switch` over `ViewType` in your code needs a `"year"` entry.

### November 10, 2026

- **Added** `calendar-app`, `calendar-core`, `calendar-list`, `calendar-sidebar`: in Calendar App, the eye beside a calendar hides its events from every view and shows them again on a second click. The .ics export still writes every event. `filterShownEvents()` and `mergeShownEvents()` are new in `calendar-core`, to do the same in a layout of your own. [#76](https://github.com/vmnog/calendarcn/pull/76)
  - **Breaking:** `CalendarList` drops `visibilitySoon` and `CalendarSidebar` drops `calendarVisibilitySoon`, both added earlier the same day in #74. If you installed in between and set either one, remove it.
- **Fixed** `command-menu`: the hints beside "Go to next week" and "Go to previous week" now show `K` and `J`, the keys that do it. [#75](https://github.com/vmnog/calendarcn/pull/75)
- **Improved** `calendar-app`, `calendar-header`, `calendar-list`, `calendar-sidebar`, `details-sidebar`: controls that did nothing are disabled with a "Soon" badge: Scheduling, Meet with… and Add calendar account in the sidebar, the view settings a view doesn't read, and the useful shortcuts nothing handles (`DetailsSidebarShortcut` takes `soon`). [#74](https://github.com/vmnog/calendarcn/pull/74)
- **Fixed** `calendar-core`, `time-grid`: an event that ends at midnight, like 11 PM to 12 AM, stays on its own day in the hour grid and month view, and dragging it no longer saves an end before its start. [#70](https://github.com/vmnog/calendarcn/pull/70)
- **Fixed** `ics`: `toIcs()` writes a repeating timed event in its time zone, with a `TZID`, instead of in UTC, so it repeats at the same clock time when the clocks change. `parseIcs()` keeps a repeating event's IANA `TZID` as its `timeZone`. One-off events are still written in UTC. [#73](https://github.com/vmnog/calendarcn/pull/73)
- **Improved** `calendar-app`, `calendar-core`, `calendar-header`, `event-details`: Cut, Copy, Duplicate and Delete in the event menus, and "Declined events" in the view settings, are disabled with a "Soon" badge, since nothing handled them. `⇧⌘D` goes back to the browser. [#72](https://github.com/vmnog/calendarcn/pull/72)
- **Fixed** `calendar-core`: an event whose `timeZone` the runtime doesn't know, like a typo or a Windows zone name, no longer takes the calendar down. It shows in the viewer's zone. `isKnownTimeZone()` is new in `@/lib/time-zones`. [#71](https://github.com/vmnog/calendarcn/pull/71)
- **Fixed** `calendar-core`: on the days the clocks change, the day and week grids draw events on the right hour, a click on an empty slot creates the event at that row's time, and `Alt` with an arrow key moves an event by clock time. [#69](https://github.com/vmnog/calendarcn/pull/69)
- **Fixed** `calendar-core`, `event-details`: shortcuts no longer run while typing in a `contenteditable` element or with a `<select>` focused, `Alt` with an arrow key is left to the browser unless an event has focus, and the `Enter` that confirms an IME composition no longer commits the event title. [#68](https://github.com/vmnog/calendarcn/pull/68)
- **Fixed** `time-grid`, `month-view`: four gestures that saved the wrong dates. Nudging an all-day bar in day view keeps the days off screen, resizing an all-day event to one or two days keeps it all-day, an overnight event can't be resized to end before it starts, and a month bar dragged by its second day lands on the right days. [#65](https://github.com/vmnog/calendarcn/pull/65)

### November 9, 2026

- **Added** `calendar-app`, a new block: the whole live demo as one component, with both sidebars, the header, every view, the ⌘K menu, theme switching and .ics import and export. See [Calendar App](/docs/components/calendar-app). [#62](https://github.com/vmnog/calendarcn/pull/62)
- **Added** `calendar-sidebar`, `details-sidebar`, `mini-calendar`, `calendar-list`, `theme-toggle` and `sidebar-overlay`, new items: the live demo's sidebars, part by part. In `calendar-core`, `CalendarInfo` gains `isSubscribed`, which the calendar list marks with a feed icon. [#61](https://github.com/vmnog/calendarcn/pull/61)
- **Added** `calendar-header` and `command-menu`, new items: the live demo's header and ⌘K menu. `useCalendarShortcuts()` in `calendar-core` takes optional `onToggleCommandMenu`, `onToggleSidebar`, `onToggleContextPanel`, `onCycleTheme` and `onOpenSettings`. `calendar` now builds its toolbar from the header's parts, so updating it installs `calendar-header`, which ships `view-dropdown.tsx` at the same path. [#60](https://github.com/vmnog/calendarcn/pull/60)

### November 7, 2026

- **Added** `conference-providers` and `sample-data`, two new items: placeholder Google Meet, Zoom and Microsoft Teams to pass to `conferenceProviders`, and the live demo's events, calendars, contacts, rooms and places. See [Sample Data](/docs/sample-data). [#58](https://github.com/vmnog/calendarcn/pull/58)
- **Fixed** `event-details`: in a narrow details panel, the time row shortens the duration instead of cutting off the end time. [#56](https://github.com/vmnog/calendarcn/pull/56)
- **Added** `event-details`, `calendar-core`, `month-view`, `agenda-view`, `ics`: a calendar picker, busy/free, visibility and reminders in the details panel. Calendars take `defaultReminders`, and `resolveEventColor`, `moveEventToCalendar` and `addReminder` are new helpers. `.ics` export now writes "1 week before" reminders correctly. [#51](https://github.com/vmnog/calendarcn/pull/51)
  - **Breaking:** an event without a `color` takes its calendar's color, and falls back to blue only when the calendar has none. Set `color` on an event to keep it blue.
  - **Breaking:** an event moved to another calendar gets that calendar's `email`, or none, instead of keeping the old one.
- **Added** `event-details`, `calendar-core`: participants and rooms, conferencing, AI meeting notes and location in the details panel. `CalendarProvider` takes `contacts`, `rooms`, `conferenceProviders` and `locationSuggestions` to fill their menus. The Conferencing row shows once you pass `conferenceProviders`. Installs the shadcn/ui `avatar`. [#53](https://github.com/vmnog/calendarcn/pull/53)
- **Added** `event-details`: links you can copy and remove, "Paste link…" and "Attach file", and a description edited in place. Only `http:` and `https:` links become clickable. [#52](https://github.com/vmnog/calendarcn/pull/52)
- **Added** `event-details`, `calendar-core`, `time-grid`, `ics`: editable time zone and repeat rows. Changing the zone keeps the wall-clock time, repeat offers presets and a custom rule, and arrows step through a series (`previousInSeries` and `nextInSeries` in `useCalendar()`). `@/lib/recurrence` and `@/lib/time-zones` are new in `calendar-core`. Installs the shadcn/ui `command` and `dialog`. [#50](https://github.com/vmnog/calendarcn/pull/50)
  - **Breaking:** `parseIcs()` reads `RRULE` into `recurrenceRule`. The raw `recurrence` string is now kept only for rules it can't parse.
  - **Breaking:** `EventItemPopoverProps` drops `onPrevWeek` and `onNextWeek`, since the series arrows no longer navigate by period.
- **Added** `event-details`, `calendar-core`: Notion Calendar's time menu in 15-minute steps, which also reads typed times (`7`, `930`) and durations, plus a date picker and an all-day switch. Installs the shadcn/ui `calendar` and `popover`, and `react-day-picker`. [#54](https://github.com/vmnog/calendarcn/pull/54)

### November 6, 2026

- **Added** `event-details`, `calendar-core`: the details panel rebuilt on Notion Calendar's layout, one file per section. `DetailedCalendarEvent` gains optional `kind`, `timeZone`, `recurrenceRule`, `participants`, `rooms`, `conference`, `aiMeetingNotes`, `links` and `attachments`. Without `onEventChange` the panel is read-only, and `Esc` restores a field without deselecting the event. [#49](https://github.com/vmnog/calendarcn/pull/49)
  - **Breaking:** the event type picked in the panel's header is now saved on the event as `kind`, through `onEventChange`. Save `kind` with your events to keep it.
  - **Breaking:** if your event type already has a `kind`, `participants` or `links` field of another type, it no longer fits `DetailedCalendarEvent`. Rename your field.
  - **Deprecated:** `timezone`, a display label. Set `timeZone` to an IANA zone instead.

### November 5, 2026

- **Added** `calendar-core`, `event-details`, `time-grid`, `month-view`, `agenda-view`: support for shadcn/ui projects set up with Base UI, as well as Radix. The details popover positions itself with `@floating-ui/react-dom`, and on Radix, picking an event type no longer closes it. Thanks to [@doneumark](https://github.com/doneumark) ([#43](https://github.com/vmnog/calendarcn/pull/43)).
- **Fixed** `calendar-core`: `calendar-provider.tsx` type-checks and lints in projects without `@types/node`, like a stock Vite app. Thanks to [@doneumark](https://github.com/doneumark) ([#46](https://github.com/vmnog/calendarcn/pull/46)).
- **Fixed** `time-grid`, `month-view`: scrolling an event into view no longer shifts the week columns away from their headers, or the month rows. [#44](https://github.com/vmnog/calendarcn/pull/44)

### November 2, 2026

- **Added** `ics`, a new item: `parseIcs()` and `toIcs()` read and write .ics files from Google Calendar, Apple Calendar and Outlook. [#36](https://github.com/vmnog/calendarcn/pull/36)
- **Added** `agenda-view`, a new item, with `calendar-core` and `calendar`: the next 30 days' events grouped by day, as the `"agenda"` view with the `A` shortcut. [#35](https://github.com/vmnog/calendarcn/pull/35)
  - **Breaking:** `ViewType` gains `"agenda"`. A `switch` that handles every view needs a case for it.
- **Added** `calendar-core`, `time-grid`, `month-view`: `onVisibleRangeChange` reports the dates on screen as people navigate, and `loading` shows a progress bar while events arrive. [#34](https://github.com/vmnog/calendarcn/pull/34)

### November 1, 2026

- **Added**: the registry's first items, `calendar`, `calendar-core`, `time-grid`, `day-view`, `week-view`, `month-view` and `event-details`, served from `calendarcn.xyz/r` for shadcn/ui projects set up with Radix. [#37](https://github.com/vmnog/calendarcn/pull/37), on the library groundwork from [#31](https://github.com/vmnog/calendarcn/pull/31).
