kalender 0.19.1

This Flutter package offers a Calendar Widget featuring Day, MultiDay, Month and Schedule views. Moreover, it empowers you to tailor the visual aspects of the calendar widget.

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