kalender 0.25.0-dev.1

A highly customizable calendar widget with day, multi-day, month and schedule views, drag-and-drop rescheduling, event resizing, and timezone support.

0.25.0

See MIGRATION.md for what to change.

Breaking Changes

• CalendarEvent.isMultiDayEvent is removed. It was deprecated in 0.24.0, which named this release. Use spansMultipleDays(location:, defaultRule:). See MIGRATION.md.

Features

• KalenderTheme is a widget, so a theme can be applied to part of the tree instead of the whole app. Wrap a calendar in KalenderTheme(data: ..., child: ...) and two calendars in one app can look different. The nearest one wins when they nest, and fields it leaves out still come from the KalenderThemeData registered on ThemeData.extensions, which keeps working as before. It is an InheritedTheme, so the theme also reaches the tile that follows a drag, which is built into an Overlay rather than below the calendar.
• The style classes and KalenderThemeData are Diagnosticable, so their resolved values appear in the Flutter devtools inspector and in toString() instead of a bare instance hash. Fields left unset are omitted rather than printed as null.

Deprecations

• The style fields on CalendarComponents are deprecated and are removed in 0.26.0. Use KalenderThemeData for the whole app, or a KalenderTheme to scope one calendar. The same thirteen styles were reachable both ways, and multiDayOverlayStyle had four different homes. CalendarComponents keeps its builder fields. See MIGRATION.md.

Fixes

• Styling the month view's week number no longer moves it to the middle of its row. The top alignment came from a default on MonthBodyComponentStyles, so setting any week number style there replaced it. The month body now applies that alignment itself, and anything you set merges over it.
• CalendarComponents, the containers reached through it, TileComponents and ScheduleTileComponents compare by value, and CalendarComponents can be const. The inherited widgets carrying them reported a change on every rebuild because they compared by identity, and now report one only when something differs.
• CalendarComponents and the containers reached through it gain copyWith.

0.24.0

See MIGRATION.md for what to change.

Breaking Changes

• kalender no longer re-exports the whole timezone package. Location and TZDateTime are still exported. Everything else, including getLocation and initializeTimeZones, now needs package:timezone imported directly. #375
• The seven string builders deprecated in 0.23.0 are removed from the component style classes. Their replacements on the matching *Components classes are unchanged. See MIGRATION.md for the mapping. #372
• MonthDayHeaderStyle.textStyle is removed. It never had any effect. The day number is styled by numberTextStyle. #372
• Three long-deprecated members are removed. CalendarCallbacks.onMultiDayTapped was never called, so deleting it changes nothing. DateTimeExtensions.monthNameEnglish and dayNameEnglish are replaced by monthNameLocalized('en') and dayNameLocalized('en'). #374
• EventsController.eventsFromDateTimeRange takes a required multiDayRule. This only affects code implementing EventsController. Pass the view configuration's rule. #371
• CalendarEvent.spansMultipleDays takes a required defaultRule alongside location. A subclass overriding it must widen its signature to match. #371
• ScheduleTileComponents no longer accepts dropTargetTile, overlayTileBuilder or resizeDragAnchorStrategy. None of them had any effect. Delete the arguments. To style the drop target, use ScheduleComponents.scheduleTileHighlightBuilder and ScheduleTileHighlightStyle. #381
• ScheduleTileComponents.emptyItemBuilder and monthItemBuilder are moved to ScheduleComponents. Set them on CalendarComponents.scheduleComponents instead. Signatures and defaults are unchanged. See MIGRATION.md. #383
• CalendarInteraction.throttleMilliseconds is removed. Drag updates are now combined into one per frame and follow the display's refresh rate. Nothing replaces it. Delete the argument. #368
• DragTargetUtilities can only be applied to a State. It supplies context and mounted itself instead of requiring them from the host. A class applying the mixin to a State needs no change. Anything else no longer compiles. #368

Features

• Dragging a multi-day event down over the body keeps moving its drop target in the header, instead of freezing it until the cursor returns. Releasing over the body applies the date and keeps the time of day and duration. #369
• MultiDayRule decides which events belong in the multi-day header rather than the day timeline. Set it once on the view configuration. MultiDayRule.minimumDuration at 24 hours is the default and matches the previous behavior. MultiDayRule.calendarDays treats anything crossing midnight as multi-day. A single event can override the rule with CalendarEvent.multiDayRule. #367 #371 #376
• In debug builds, a drag or resize asserts that the event's copyWith forwarded id and multiDayRule. copyWith takes no parameter for either, so an override that omits them drops them on every copy, silently until selection or multi-day placement goes wrong. The message names the subclass and the argument to add. #367

Deprecations

• CalendarEvent.isMultiDayEvent is replaced by spansMultipleDays(location:). The getter measured calendar days in UTC. It will be removed in 0.25.0. See MIGRATION.md. #367

Fixes

• View configurations built with the same arguments compare equal, so a rebuild no longer recreates the view controller and its layout caches. PageIndexCalculator and ScheduleViewConfiguration had no ==. At 50 events a day, five rebuilds went from 105 vertical layout computations to none. #404
• ViewConfiguration.nowCallback takes part in ==. Pass a top-level or static function. #404
• CalendarView attaches to a replaced calendarController instead of staying on the old one. #404
• CalendarInteraction and HorizontalConfiguration compare every field in ==. Four fields were missing, so changing only one of them never updated the calendar. #364
• CalendarSnapping compares and copies eventSnapStrategy. Changing only the strategy had no effect, and copyWith reset it to defaultSnapStrategy. Pass a top-level or static function. #402
• Dragging to create an event no longer reacts to a drag that started on a different calendar. #366
• ScrollTriggerConfiguration.copyWith keeps scrollAmount instead of resetting it to the default. #366
• MultiDayViewConfiguration.copyWith and MonthViewConfiguration.copyWith keep multiDayRule instead of resetting it to the default, and take a parameter to change it. MonthViewConfiguration.copyWith also keeps nowCallback and no longer takes an eventPadding parameter, which set nothing. #387
• Removing an event no longer throws when its date index was never populated for that location. #366
• Tapping the trailing edge of an event tile resolves to the last visible day instead of one day past it. #366
• The two drag-target guards that decide whether an event may be dropped in the header or the body now use the calendar's location, so they agree with the rest of the calendar near midnight and across daylight saving changes. #367
• A calendar whose locale has no intl data loaded now names the locale, the initializeDateFormatting() call to add and the library it comes from, instead of throwing intl's LocaleDataException from inside a build. #382
• TileComponents.overlayTileBuilder is used again by the tiles in the multi-day overflow overlay. It had been ignored since 0.14.0. #381
• The vertical layout delegate returns layout data for every event, even when two events share a hash code. The layout cache is keyed by that hash, so events sharing one previously left a tile with no layout data. CalendarEvent.hashCode is built from id, start, end, interaction and multiDayRule, so this needs a custom EventsController that gives two events the same id. #370

Tests

• Added equality coverage for the configuration classes: every field of VerticalConfiguration and HorizontalConfiguration breaks equality when it differs, two configurations built from the same arguments compare equal, and nowCallback, initialTimeOfDay and initialHeightPerMinute take part. #364 #404
• Added copyWith round-trip coverage for the view and body configurations, so a field that is not being changed survives the copy. #366 #387
• Added coverage that the vertical layout delegate returns one entry per child when two events share a hash code, including a subclass whose hashCode ignores the id, and when the cache is already warm. #370
• Added coverage that a drag or resize asserts when the event's copyWith drops id or multiDayRule, and stays silent for an override that forwards both. #367
• Added coverage that TileComponents.overlayTileBuilder renders the overflow overlay tiles, and falls back to tileBuilder when it is not set. #381
• Added coverage that drag moves arriving within one frame coalesce into a single update, that the update uses the newest move, and that a move queued at the moment of the drop is discarded. #368
• Added coverage for the multi-day rule on the view configurations, and that dragging a multi-day tile into the body keeps moving its header preview. #367 #369 #371

0.23.0

Nothing in this release stops existing code from compiling. See MIGRATION.md for what to change.

Behavior Changes

Each of these changes what an unchanged calendar renders.

• The overflow button is labelled +3 instead of 3 more, with the number formatted for the calendar's locale so locales with their own numerals read correctly. #349
• The schedule view abbreviates day names with DateFormat.E instead of cutting the full name at three characters, which was only correct in English. German reads Mi rather than Mit. #354
• MonthDayHeaderStyle.stringBuilder was declared but never called. Its replacement is wired up, so a calendar that set the old field will now see the day number change. #349
• MonthBodyComponents.overlayBuilders defaults to null, so CalendarComponents.overlayBuilders applies in the month view instead of being shadowed by an empty default. The builder-side twin of the style-side fix in 0.22.0. #349

Deprecations

Both are removed in 0.24.0.

• The seven string builders moved from the component style classes to the matching *Components classes and gained a BuildContext parameter, so a custom builder can read the calendar's locale. The old fields still apply when the new one is not set. #349
• MonthDayHeaderStyle.textStyle has never had any effect. MonthDayHeader renders only a day number, styled by numberTextStyle. #354

Features

• context.calendarLocale reads the locale of the enclosing calendar, which is not necessarily the app's. #349
• EventsController gained replaceEvents, which swaps the whole event set in one call. DefaultEventsController does it atomically: a single notification and no intermediate empty state, which suits reloading events from a source such as an imported .ics file. The base class provides a default that clears then adds, so custom controllers keep working unchanged. #344

Fixes

• The overflow button is now attributed to the day its events are on in right-to-left layouts. The layout frame orders its columns by text direction, but read them back as if they always ran left to right, so every button landed on the mirrored date. In a right-to-left month view with events on Wednesday the 29th, the buttons appeared on the 30th and 31st. MultiDayLayoutFrame gained an optional textDirection, which defaults to left to right, so a custom frame generator is unaffected. #334

0.22.0

Features

• MultiDayOverlayStyle gained cardTheme, closeButtonStyle, barrierColor, width, and headerHeight, so the overlay card, its close button, and the area behind it can be styled to match the rest of the app. The card and button take Flutter's own CardThemeData and ButtonStyle. All of them default to null, so the stock appearance is unchanged. #325
• The date in the overlay header no longer looks like a button that does nothing when tapped, and it is highlighted when it is today, like the day number in every other view. #325 #328
• The today highlight is now tonal in every view, instead of grey. It is drawn with a disabled button so that it is not tappable, and a disabled button paints itself in the disabled colors, which made the highlight read as "unavailable" rather than "today". The day header, month day header, schedule date, and multi-day overlay all share one implementation now, so they cannot drift apart. #328

Fixes

• The month view now uses the overlay builders and styles set on monthComponents/monthComponentStyles instead of letting the global CalendarComponents.overlayBuilders and overlayStyles shadow them. This matches what CalendarComponents documents and what the multi-day header already did. Only apps that set both are affected. #323
• The multi-day overlay card no longer runs past the bottom of the view and gets clipped. It was positioned without being measured, so only its top and sides were clamped, which showed up when a day low in the month grid had more events than fit. The card now stays inside the view on all four sides, and its event list scrolls when the card would be taller than the view. #324

0.21.0

Features

• All component style classes (DayHeaderStyle, TimelineStyle, HourLinesStyle, and the rest) now support copyWith, merge, lerp, and value equality. This is groundwork for the upcoming theme extension. #314
• Added KalenderThemeData, a ThemeExtension with one field per component style, and KalenderTheme.of(context), which resolves it against centralized Material 3 defaults. Register it on ThemeData.extensions to style every calendar in the app, with animated theme changes supported. #315
• The component widgets now resolve their appearance as widget style over theme extension over Material 3 defaults, so a registered KalenderThemeData takes effect everywhere. Two defaults changed on purpose: the time indicator line uses the color scheme's error color instead of always red, and the day number text in the month body and schedule view defaults to bodyMedium instead of being unstyled. #316
• The month view's day number now has a small margin so the today highlight floats clear of the gridline above and the event tiles below. The margin and the button size can be adjusted through the new MonthDayHeaderStyle.margin and MonthDayHeaderStyle.buttonSize fields. #320

Fixes

• MultiDayOverlayStyle.eventPadding is now applied to each event in the overlay. It was ignored, and eventsPadding was used for both the event list and each individual event. #316

0.20.0

Features

• Multi-day and all-day events now render in the free-scroll view as a single tile spanning the day columns, instead of being split at each page boundary. They support the same interactions as the paged headers: create by dragging across the header, reschedule, resize, auto-scroll when a drag reaches the viewport edge, right-to-left layout, and the "+N more" overflow. #78 #297 #298 #299 #300 #301

Fixes

• PageTriggerConfiguration.triggerWidth is now applied. It was accepted but ignored, and copyWith dropped it, so the edge strip that starts a page change while dragging was always pageWidth / 50. That is still the default, but it can now be set. #302
• Fixed free-scroll multi-day events disappearing after scrolling back to a day before the event's start. The multi-day layout cache is keyed by date range and is shared across the free-scroll band's moving window, so a window cached before an event existed kept returning an event-less frame. Changing events now clears the whole cache instead of only the visible window. #306
• Fixed an event jumping to a neighbouring day when resizing it by its top or bottom edge. The resize handle anchored the drag to the column's edge, so the smallest sideways movement flipped the day. It now follows the pointer, so a small drift no longer changes the day while a deliberate drag across columns still does. #312

Tests

• Added free-scroll multi-day coverage: spanning tiles render as one tile and stay single while scrolling, create-by-drag, reschedule and edge auto-scroll work in the band, right-to-left renders and scrolls the right way, and the "+N more" overflow opens. #297 #298 #300 #301
• Added coverage that dragging an event to the viewport edge advances the page in the paged header and body, and scrolls the body vertically. #302 #304
• Added coverage that a free-scroll multi-day event stays visible when scrolling back to windows that were cached before the event was created. #306
• Added coverage that resizing an event's bottom edge with a small horizontal drift keeps it on its own day. #312

0.19.1

Features

• Added MultiDayBodyConfiguration.keepPagesAlive (default false). When enabled, each visited multi-day page is kept alive and reused, so navigating back to it skips rebuilding every event tile. It is opt-in because cached pages stay in memory for the lifetime of the view. #293

Fixes

• Fixed back-to-back events (one ending exactly when the next begins) rendering as overlapping at some zoom levels. An event's top and bottom now come from one shared time-to-pixel conversion, so touching tiles line up exactly instead of splitting on a rounding difference. #291

Performance

• Sped up multi-day frame generation. #289
• The visibleEvents notifier now only publishes when the set of visible events actually changes, avoiding redundant work for listeners. #290
• The day view now builds only the event tiles within the visible scroll window (plus an overscan margin) instead of every event of the day, and skips the resize-handle scaffolding when resizing is disabled. #292

Tests

• Added a regression sweep that back-to-back events stay in separate groups across a wide range of zoom levels, start offsets and durations. #291
• Added coverage that off-screen day tiles are culled and rebuilt when scrolled into view, and that a partially visible tile stays built. #292

0.19.0

Breaking Changes

• monthDayHeaderBuilder now receives a localized wall-clock DateTime instead of a UTC-flagged InternalDateTime, matching dayHeaderBuilder. #248
• Replaced ViewConfiguration.initialDateSelectionStrategy with per-dimension view-transition options: dateTransition on all views, and scrollTransition / zoomTransition on MultiDayViewConfiguration, each with an optional resolver for custom logic. #249
• View switches now preserve the vertical scroll (time-of-day) and zoom by default instead of resetting to initialTimeOfDay; opt out with ScrollTransition.reset / ZoomTransition.reset. #249
• Renamed EmptyDayBehavior.showToday to EmptyDayBehavior.showOnlyToday, since it shows only today among empty days. #253
• Replaced MultiDayBodyComponents.prototypeTimeLine with a timelineWidth builder that returns the gutter width directly (double). The multi-day body, header and drag overlay now share this one width, so customizing the timeline can no longer misalign the header. Removed the PrototypeTimeline widget and PrototypeTimeLineBuilder. #180

Features

• Added restorePerView transitions so each view can reopen its own last date, scroll, and zoom. #249
• Added CalendarController.visibleTimeOfDay and the CalendarCallbacks.onScrollPositionChanged callback. #249
• Added ScheduleBodyConfiguration.leadingWidth to control the schedule view's date-column width. #253
• Added TimelineStyle.width to set an explicit multi-day timeline gutter width. #180
• Added MonthBodyComponents.monthDayCellBuilder to style individual month-view day cells. Each call reports the cell's date, whether it is today, and whether it falls in the focused month (so adjacent-month days can be styled differently). Also added the ready-made MonthDayCell.shadeAdjacentMonths() builder, which shades leading/trailing adjacent-month days. Pass a color or let it default to a low-opacity onSurface overlay that greys them out. #140
• Added eventPadding to MonthBodyConfiguration (forwarded from the constructor and through copyWith), so month event tiles can be spaced like MultiDayHeaderConfiguration already allows. #252

Fixes

• Fixed schedule view event tiles not lining up; every row now shares a fixed-width leading column whether or not it shows a date. #253
• Fixed the continuous schedule view scrolling to the wrong position when today has no events; the initial scroll and animateToDateTime now target today, or the nearest day when it is hidden. #253
• Fixed the free-scroll multi-day header "wobbling" (re-animating its height) whenever a calendar item changed; its paged content now keeps its state across rebuilds instead of being rebuilt from scratch. #282
• Fixed the free-scroll multi-day header clipping days that have more events than the leading day; the header now sizes to the tallest day currently in view. #283
• Fixed the multi-day/week header drifting out of alignment with the body when the timeline used a custom stringBuilder or width; the gutter width now has a single source. #180
• The timeline gutter width now accounts for the text scale factor, so it no longer under-sizes when text is enlarged. #180
• The timeline gutter now measures every label across the day rather than a single sample, so a custom label format whose widest entry is not at 23:59 no longer clips. #180

Tests

• Added end-to-end CalendarView regression coverage for the time indicator, run across the timezone matrix. #261
• Added end-to-end CalendarView today-highlighting coverage, run across the timezone matrix. #254 #251
• Added continuous schedule regression coverage for row alignment and the no-events-today scroll target. #253
• Added end-to-end month-view regression coverage for a custom generateMultiDayLayoutFrame. #235
• Added regression coverage that the free-scroll header keeps its paged content's state across rebuilds. #282
• Added regression coverage that the free-scroll header fits the tallest visible day rather than only the leading page. #283
• Added regression coverage that the multi-day header and body day columns stay aligned across custom label formats, explicit widths, and right-to-left. #180
• Added regression coverage that a selected month-view event's focus aligns to its own row. #233
• Added coverage that monthDayCellBuilder is invoked per day with the correct focused-month flags, and that MonthDayCell.shadeAdjacentMonths() shades only the adjacent-month days. #140

0.18.7

Fixes

• Fixed a blank page when a displayRange spanned exactly one month, and the same off-by-one page count that dropped the final in-range page in the week, custom multi-day, and paginated schedule views. #266
• Fixed the month view showing a "+N more" overflow button when there were no events, and on very short row heights. Added end-to-end regression coverage. #255

0.18.6

Features

• Added optional month-view week numbers via MonthViewConfiguration.showWeekNumbers, with customizable MonthBodyComponents.weekNumberBuilder and MonthBodyComponentStyles.weekNumberStyle.

Fixes

• Fixed a month-view regression where the dropTargetTile preview could fail to render while resizing an event.

0.18.5

Fixes

• Fixed an issue where the highlighted selection border (dropTargetTile) was painted on the wrong tile or missing entirely in month view overlapping events and the "X more" overflow drop-down.
• Fixed a bug where the TimeIndicator would disappear when zooming the calendar before any page navigation had occurred.

0.18.4

Fixes

• Reverted ResizeHandle and ResizeHandles now take a length parameter.

Features

• Added resizeDragAnchorStrategy to TileComponents.

0.18.3

Fixes

• ResizeHandle and ResizeHandles now take a length parameter to provide properly sized Draggable feedback widgets instead of an empty layout, improving the resizing feedback.

0.18.2

Features

• TapDetail from *WithDetail callbacks now calculates the exact DateTime under the cursor or finger tap based on spatio-temporal position within the event UI, rather than returning the event's start time.

---

0.18.1

Features

• Added support for secondary gestures (right-clicks) on empty calendar spaces: onSecondaryTapped, onSecondaryLongPressed and their WithDetail variants.
• Added support for secondary gestures (right-clicks) on events: onEventSecondaryTapped and onEventSecondaryTappedWithDetail.

Fixes

• Fixed an issue where DayDetail and MultiDayDetail exposed internal InternalDateTime and InternalDateTimeRange objects without timezone offsets applied. All tap details now correctly apply .forLocation() to expose wall-clock DateTimes to consumers.
• Fixed some raw callbacks (onLongPressed, onSecondaryLongPressed) leaking internal representations instead of .forLocation() adjusted ones.

---

0.18.0

Features

• New NowCallback typedef and ViewConfiguration.nowCallback field to decouple the time indicator, today highlighting, and schedule empty-day logic from the calendar's configured Location.
• InternalDateTime.isToday() now accepts an optional DateTime? now parameter, allowing callers to override what "today" means.
• DayHeader, MonthDayHeader, and ScheduleDate read nowCallback from the view configuration and use it for today highlighting. When set, it takes priority over the Location-based check.
• EmptyDayBehavior.showToday in ScheduleBody now respects nowCallback.
• Added static todayKey constants on DayHeader, MonthDayHeader, and ScheduleDate for easier widget-test assertions.

Fixes

• TimeOfDay extensions (incorrect copyWith)
• Week and DayHeaders returning InternalDateTime
• Resize handle dragAnchorStrategy
• CalendarEvent passed to builders (sometimes outdated)

Tests

• Added unit tests for InternalDateTime.isToday(now:) parameter.
• Added widget tests for nowCallback-driven today highlighting across DayHeader, MonthDayHeader, and ScheduleDate.
• Added widget tests for time indicator positioning with nowCallback.

---

0.17.0

Breaking Changes

• ResizeHandlePositioner typedef now takes an additional bool isImprecise parameter.
• ResizeHandles abstract class now requires an isImprecise constructor parameter.

Features

• New InputMode enum (auto, precise, imprecise) on CalendarInteraction replaces platform-based mobile/desktop detection for resize handle behavior.
• Resize handle positioning and visibility is now driven by input precision (mouse/stylus/trackpad vs touch) instead of platform (iOS/Android).
• InputMode.auto (default) detects input type dynamically — hover triggers precise mode, selection triggers imprecise mode.
• New allowHorizontalImpreciseResize option on CalendarInteraction to opt-in to horizontal resize handles for touch input (disabled by default).
• CalendarInteraction.resolveIsImprecise() provides a way to query the resolved input mode.
• Removed direct isMobileDevice usage from resize handle widgets.

---

0.16.0

Breaking Changes

• CalendarEvent is no longer generic. The data field and <T> type parameter have been removed. Custom data should now be added by extending CalendarEvent directly.
• Event IDs changed from int to String. This affects addEvent (returns String), addEvents (returns List<String>), removeById, byId, and any code that stores or compares event IDs.
• EventTile.eventId is now a String.
• MultiDayOverlayEventTile renamed to MultiDayEventOverlayTile.
• EventsController folder moved into the controllers folder; update any direct imports.

Features

• CalendarEvent is now extensible. Attach custom fields (title, color, etc.) by sub-classing and overriding copyWith. See the updated examples for guidance.
• CalendarEvent gained a layoutEquals method used internally for optimized layout rebuilds.

Fixes

• fix: SnapPoints calculation.
• fix: Visible events not updating correctly after a change.
• fix: Pointer events now pass through the time indicator widget.
• Various bugs uncovered by the expanded test suite.

Improvements

• EventLayoutDelegateCache is now cleared automatically when heightPerMinute changes.
• eventsFromDateTimeRange — the location parameter is no longer required.
• Vertical drag-target behavior improved.
• DefaultEventsController is now exported from kalender.dart directly.

Tests

• Extensive test additions and refactoring across controllers, layout delegates, drag targets, interactions, view configurations and callbacks.
• Added a tool (tool/test_timezones_linux.dart) for running the test suite under multiple timezones on Linux.

Contributors

• CalendarEvent extensibility, EventsController as a full interface, and event/group ID migration to String contributed by RedDuality.

0.15.0

• feat: Added timezone support.
• feat: Use linked_pageview package for linked scrolling between multi-day header and body. PR #247
• fix: Wrong current date highlighting due to extension method issues. PR #260 / #251
• fix: Schedule body rendering issue.
• fix: SnapPoints calculation.
• fix: EventLayoutDelegateCache not being cleared when heightPerMinute changes.
• fix: MultiDayViewController now correctly exposes a page offset listener.

Breaking Changes

• Added InternalDateTime and InternalDateTimeRange classes accessible through kalender/extensions.dart.
• Moved asUtc and asLocal extensions to InternalDateTime.
• EventLayoutStrategy now takes a InternalDateTime instead of a DateTime.
• GenerateMultiDayLayoutFrame now takes a InternalDateTimeRange instead of a DateTime.
• CalendarEvent stores start and end times in utc format.
• Removed initial date from CalendarController this is now set in the ViewConfiguration of the CalendarWidget. ****
• Replaced visibleDateTimeRangeUtc valueNotifier in the CalendarController with a nullable internalDateTimeRange. (visibleDateTimeRange is remains the same).
• The EventsController.eventsFromDateTimeRange now uses InternalDateTimeRange and takes a nullable Location from the timezone package.
• Changes to the DefaultDateMap to accommodate different timezones, any custom implementations will need to be updated.
• EventTileUtils mixin was also updated to use the new internal date time classes.
• PageNavigationFunctions was renamed to PageIndexCalculator and updated to use internal date time classes.
• Multiple default components where updated to use the new internal date time classes instead of date time classes.
• ViewConfiguration renamed selectedDate to initialDateTime.
• CalendarHeader and CalendarBody no longer take ValueNotifiers and will instead create and dispose ValueNotifiers created from values passed to them.

0.14.3

• feat: Made TextAlign and TextOverflow configurable for TimelineStyle. PR #242 Thanks to quaaantumdev
• fix: Various issues while dragging events on multi-day view. PR #240 Thanks to redninjacat.
• fix: Drag and drop issues. PR #238 Thanks to redninjacat.
• fix: erroneous warning in month_body PR #237 Thanks to redninjacat.

0.14.2

• fix: Tile and ResizeHandleWidget rebuild issues.

0.14.0

• feat: Custom onWillAcceptWithDetails functions for DragTargets. #213

API Change

• Resize Handles are now only rendered when the cursor is hovering on a tile or when a tile is selected on mobile.
• Added a [ResizeHandles] abstract widget and [DefaultResizeHandles] widget that allows for more customization.
• Replaced vertical/horizontal resize handle positioners from [TileComponents] with a single [ResizeHandlePositioner].

0.13.1

• fix: MultiDayLayoutFrameCache using toString() to generate map key. #225

0.13.0

• feat: Improved TimeLine and HourLines widgets. #216
• feat: Improved DayHeader and DayHeaderStyle. PR #218
• feat: Improved CalendarCallbacks. #133 / #30 - Added onTappedWithDetail, onLongPressed and onLongPressedWithDetail callbacks. - Deprecated onMultiDayTapped. (Use onTappedWithDetail instead). - Not providing onEventTapped and onEventTappedWithDetail will remove internal gesture detectors for events, removing interference for GestureDetectors added to EventTileBuilders. - Added mixins (DayEventTileUtils and MultiDayEventTileUtils) for EventTileBuilders that have their own gesture detectors. - Added onEventCreateWithDetail as used in the new advanced example.
• fix: DayDragTarget calculateLocalCursorPosition, add scroll offset after converting to local coordinate space.

0.12.0

• feat: Added eventComparator to defaultMultiDayFrameGenerator thanks to captaingerhard. PR #210

0.11.1

• fix: Too many day separators in MultiDayView Free Scroll #208
• fix: PageNavigationFunctions.indexFromDate #211

0.11.0

• feat: Added interaction (EventInteraction) property to calendar events for fine grained control. #194
• fix: Events rendered as overlapping under certain conditions when they are not overlapping. #200
• fix: Overlay positioning and dismiss behavior. #203

0.10.2

• fix: DefaultEventsController ConcurrentModificationError. #184

0.10.1

• fix: Time indicator not rendered under the correct date. #182

0.10.0

• feat: Added locale property to CalenderView allowing users to specify a language with the intl package. #172
• feat: Add string builder to MultiDayPortalOverlayButtonStyle for easy override of the text. #172
• fix: MultiDayPortalOverlayButtonStyle not using style overrides. #172
• fix: Overlap when scrolling. #174
• fix: ScheduleView reload issues. #170

0.9.1

• fix: ScheduleViewController ItemPositionsListener was not initialized. #170

0.9.0

• feat: preserve visible date when switching between different views. #165
• docs: updated MonthBodyComponents in readme to include all custom components. #168

0.8.0

Features

• Reimplemented schedule view. discussion 122, #130
• The tile builder is no longer a required parameter, default tiles are now provided. (Highly recommended to override these.)

0.7.2

• fix: Calendar event at 00:00 not visible (zero duration) #159
• fix: Export the necessary classes to allow for custom a GenerateMultiDayLayoutFrame. #162

0.7.1

• fix: Calendar event at 00:00 not visible #159
  • Note: This makes minor changes to the abstract class EventLayoutDelegate.
• fix: Long event causes all following events to intend. #142

0.7.0

Features

• Ability to limit the number of events in MultiDayHeader. #141 / #147
  • MultiDayHeaderConfiguration Changes:
    • Added maximumNumberOfVerticalEvents
    • Added generateMultiDayLayoutFrame
  • Added overlayBuilders to MultiDayHeaderComponents for customizing the overlay.
• MonthBody limits the number of events displayed based on size constraints. #141 / #147
  • Added overlayBuilders to MonthBodyComponents for customizing the overlay.
• Added a new callback OnEventTappedWithDetail. #141 / #148

Migrations

• Deprecated MultiDayEventLayoutStrategy this should be migrated to use the new GenerateMultiDayLayoutFrame

Improvements

• The defaultMultiDayGenerateFrame improves on the defaultMultiDayLayoutStrategy by allowing events to fill empty spaces.

Fixes

• Week view not showing correct range when first day of week is something other than monday. #150
• Events not snapping to closest. #155

0.6.7

• fix: Rescheduling event triggering an assert. #144
• fix: TimeIndicator rendering on incorrect day. #143

0.6.6

• fix: MultiDayHeaderWidget layout regressions.
• Added widget tests for MultiDayHeaderWidget.

0.6.5

• fix: SingleDayView RenderFlex overflow.

0.6.4

• fix: MonthGrid not taking number of rows into consideration. #131

0.6.3

• fix: Event snapping not always working.

0.6.2

• fix: Calendar sometimes displays wrong initial date. 314ff4e

0.6.1

• Changed VerticalTileResizeHandlePositioner to never use more than 1/4 of the height of the event tile on desktop.

0.6.0

• Package will use Semantic versioning from 0.6.0 onwards.

Breaking changes

• The EventsController is now an abstract class, use DefaultEventsController instead.
• The ViewConfiguration no longer contains the configuration for interaction and snapping. These are now separate classes that are passed directly to the Body/Header.

What's new

• There is a new callback onTapped in CalendarCallbacks.
  • This is now called when the user taps on an empty space a calendar (Multiday body).
• There is a new callback onMultiDayTapped in CalendarCallbacks.
  • This is called when the user taps on an empty space in the calendar (Multiday Header / Month body).
• MultiDayBodyConfiguration added horizontalPadding this padding is located between events and the edge of day.
• There is now a CalendarInteraction and CalendarSnapping class that can be passed to the CalendarBody / CalendarHeader as a ValueNotifier. This allows the calendar view to change these behaviors without rebuilding the entire view.
• CalendarSnapping now has a eventSnapStrategy that can be used to define custom snapping behavior when creating new events. #119

Fixes

• Month day header export PR #115
• Month grid export PR #112
• Month not display all dates PR #129

Boring stuff

• Lots of new unit tests that run in multiple timezones to ensure there are no regressions.
• Example directory layout has changed.

0.5.0

Breaking changes:

Version 0.5.0 has quite a few Breaking changes, there is no easy way to migrate to this version. Here are a few important things that have changed.

• The CalendarView now takes a header CalendarHeader and body CalendarBody widgets. You can wrap these widgets in other widgets to style them as seen here

• Event tiles now make use of the Draggable widget provided by flutter. Take a look at the TileComponents for more details on how tiles work now. This opens some interesting possibilities for displaying multiple calendars.

• The CalendarCallbacks (previously CalendarEventHandlers) have been changed so more information is given when an interaction occurs.

• The schedule view has been removed, but will be reimplemented in the future.

What's new

• Auto scroll/paging (https://github.com/werner-scholtz/kalender/issues/75 && https://github.com/werner-scholtz/kalender/issues/64)
• Calender can now accept Draggable's (https://github.com/werner-scholtz/kalender/issues/48)
• More information for the TileBuilder (https://github.com/werner-scholtz/kalender/issues/83)

pre-0.5.0

• https://github.com/werner-scholtz/kalender/blob/main-0.4.2/CHANGELOG.md