flutter_calendar_carousel

Breaking changes

• Redesign the public API around controlled selectedDate and focusedDate
  values, onDateSelected, onDateLongPressed, and onPageChanged callbacks.
• Replace the 2.x boolean view selector with CalendarCarousel.month,
  CalendarCarousel.week, and the explicit CalendarView enum.
• Remove the package-owned event and marked-date models, adapter interfaces,
  mutable event index, positional day builder, and their deep-import files.
  Applications now provide their own model through eventsForDate.
• Group header, weekday, layout, paging, theme, day-style, and marker options
  into focused immutable configuration objects. Calendar size is now controlled
  exclusively by parent constraints, and pages always snap.
• Replace date lists and integer weekday indexes with isDateEnabled, Flutter
  Locale, and the CalendarWeekday enum. The default range now spans 100
  years before and after today.

Added and changed

• Unify month and week navigation on a lazy, date-only pager that handles every
  first-day-of-week value, year boundaries, range updates, and runtime view
  changes consistently.
• Add named day, marker, date-style, header, and weekday builders with immutable
  details objects and Material-theme-aware defaults.
• Limit the built-in event marker to a configured number of visible dots plus
  one bounded overflow label; custom marker builders run once per marked day.
• Fix controlled selection updates, duplicate page-change callbacks, external
  focus navigation, date-picker lifecycle and locale fallback, and day
  semantics.
• Make rapid header navigation, vertical paging, far date-picker jumps, narrow
  and wide layouts, large text, RTL ordering, and event overflow badges
  deterministic and regression-tested.
• Preserve complete day grids under constrained heights and vertical page
  previews, keep hit targets at full-cell size, expose read-only dates as
  labels, and add customizable event-count semantics with selected-marker
  contrast.
• Keep week views complete when month-only outside-date filtering is enabled,
  and derive today, selection, weekend, and month flags from each cell's date.
• Replace date-dependent tests and the previous example with deterministic
  month/week regression coverage and a concise Material 3 demo.
• Refresh and commit the example lockfile during automated version bumps to prevent recurring release drift (#409).
• Provision pub.dev OIDC credentials in the publish workflow so tagged releases do not wait for interactive authentication (#403).
• Update the example to intl 0.20.3, current Android build tooling, iOS 13/UIScene, and Flutter Swift Package Manager integration.
• Add regression coverage for disabled-date predicates and page navigation, and
  build the Android example in CI.
• Synchronize Codex and Claude repository workflows around shared issue, verification, commit, rebase, self-review, and five-minute PR review procedures.
• Document the autonomous maintenance runbooks, PR review loop, and deployment workflow expectations (#402).

• fix(maintenance): support current Flutter and release flows (#424)

• Update intl version #397

• Add ability to configure day border radius by setting daysBorderRadius (#391)

• Replace bare Function types with typedefs (#393)
• Add ability to configure day border radius by setting daysBorderRadius (#391)
• Fix PR links in 2.5.0's changelog not being clickable (#390)
• Fix inactive (disabled) days being clickable (#389)
• Don't invoke animateToPage when page was scrolled manually (#388)

• Add linter and code formatting (#386)
• Upgrade dependencies and integrate linter (#384)
• Support Xcode 16 for iOS (#385)
• Migrate Gradle to use declarative plugins block in Android example (#383)

Upgrade intl to ^0.19.0

Upgrade intl to ^0.18.1

Support Flutter version 3+

Update iOS podspec and info.plist

Update build config on flutter V2 embedding (#293)

Multiple days selection using addRange method #285

Multiple days selection #282

Null safety improvements #272

Support null-safety #260

• Add id to event model #257

• Bump up intl dependency #254

• Bugfix when switching month - "The method 'call' was called on null." #243

• Add key to widget constructor #234
• Enhance initilizing page numbers #231

• Handle issue #207, #209

• Add first day of week offset to week builder #204

• Fix Calendar displays incorrectly when scrolling horizontally #193

• Target date for custom header

• Add ability to set targetDate on header #183.

• Fix current day showing incorrectly when using showOnlyCurrentMonthDate #181.

• Set default minSelectedDate and maxSelectedDate #179.

• Expose pageScrollPhysics for pageView.

• Add option for setting scrollDirection #166
• Resolve #123 in #165.

• Resolve #164.

• Resolve #154.

• Resolve #157.

• Allow the use of generic type with Interface #149
• Added doc to custom weekday builder. Weekday number is now supplied to the builder #150

• customDayBuilder fix.
• Remove date_utils dep.

• Support custom day container feature #145.

• Support intl >= 0.15.7 < 0.17.0 to inclease pub health
• Removed deprecated methods markedDates, markedDateColor
• Fixes #101
• Fixes #104
• Fixes #112
• Fixes #119
• Support long pressed as a feature request#103
• Support semantic label as a feature request #139
• Expose dayCrossAxisAlignment and dayMainAxisAlignment to resolve #122
• Expose showIconBehindDayText to resolve #131
• Fixes #94

• Support intl >= 0.15.7

• Improved customizability for weekday containers #141

• Fix vertical scroll behavior for weekFormat calendar view.
• Reformat code with dartfmt

• Added feature to only show dates from today adding showOnlyCurrentMonthDate parameter.

• Added feature for change first day of the week.