feat: agenda view, multi-day events, swipe gestures for v2.1.0

Author: harshyadavDeveloper

CHANGELOG.md

@@ -1,51 +1,65 @@
+## 2.1.0
+
+- Added `AgendaView` — chronological event list grouped by date
+- Added `CalendarView.agenda` — new view mode
+- Added multi-day event support in `CalendarEvent`
+  - `endDate` — optional end date for multi-day events
+  - `isMultiDay` — check if spans multiple days
+  - `spanDays` — number of days event spans
+  - `startsOnDate()` / `endsOnDate()`
+  - `dateRangeString` — formatted date range
+- Added swipe gestures — left/right to navigate
+- Added `agendaDaysAhead` / `agendaDaysBehind` params
+- Multi-day events show bar indicator in month view
+
 ## 2.0.0
 
-* 🎉 Major release — Full Calendar Widget!
-* Added `SmartCalendar` widget
-  * Month view — full grid calendar
-  * Week view — week strip with events list
-  * Day view — single day detail view
-  * View switcher — switch between month/week/day
-  * Today button — jump to today
-  * Smooth navigation with chevron buttons
-* Added `SmartCalendarController`
-  * `nextMonth/previousMonth`
-  * `nextWeek/previousWeek`
-  * `nextDay/previousDay`
-  * `jumpToDate/jumpToMonth`
-  * `goToToday/selectDate`
-  * `isCurrentMonth`
-* Added `CalendarEvent` model
-  * title, date, color, description
-  * allDay, startTime, endTime
-  * `isOnDate()`, `timeString`
-* Added `EventMarkerStyle` — dot, chip, both
-* Added `CalendarView` — month, week, day
+- 🎉 Major release — Full Calendar Widget!
+- Added `SmartCalendar` widget
+  - Month view — full grid calendar
+  - Week view — week strip with events list
+  - Day view — single day detail view
+  - View switcher — switch between month/week/day
+  - Today button — jump to today
+  - Smooth navigation with chevron buttons
+- Added `SmartCalendarController`
+  - `nextMonth/previousMonth`
+  - `nextWeek/previousWeek`
+  - `nextDay/previousDay`
+  - `jumpToDate/jumpToMonth`
+  - `goToToday/selectDate`
+  - `isCurrentMonth`
+- Added `CalendarEvent` model
+  - title, date, color, description
+  - allDay, startTime, endTime
+  - `isOnDate()`, `timeString`
+- Added `EventMarkerStyle` — dot, chip, both
+- Added `CalendarView` — month, week, day
 
 ## 1.6.0
 
-* SmartParser — major improvements
-* New English expressions:
-  * `midnight`, `noon`, `end of day`
-  * `start/end of month`, `start/end of year`
-  * `start/end of week`
-  * `this weekend`, `next weekend`, `last weekend`
-  * `day after tomorrow`, `day before yesterday`
-  * `a day ago`, `in a week`
-  * `N days/weeks from now`
-* Added Hindi parsing support:
-  * `आज`, `कल`, `परसों`
-  * `अगले/पिछले हफ्ते/महीने/साल`
-  * `अगले/पिछले सोमवार...रविवार`
-  * `{n} दिन बाद/पहले`
-* Added Marathi parsing support:
-  * `आज`, `उद्या`, `काल`, `परवा`
-  * `पुढील/मागील आठवडा/महिना/वर्ष`
-  * `पुढील/मागील सोमवार...रविवार`
-  * `{n} दिवसांनी/{n} दिवसांपूर्वी`
-* Added `SmartParser.parseLocale()` — parse with explicit locale
-* Added `SmartParser.canParseLocale()` — check locale parsing
-* Added `SmartParser.supportedParseLocales` — ['en', 'hi', 'mr']
+- SmartParser — major improvements
+- New English expressions:
+  - `midnight`, `noon`, `end of day`
+  - `start/end of month`, `start/end of year`
+  - `start/end of week`
+  - `this weekend`, `next weekend`, `last weekend`
+  - `day after tomorrow`, `day before yesterday`
+  - `a day ago`, `in a week`
+  - `N days/weeks from now`
+- Added Hindi parsing support:
+  - `आज`, `कल`, `परसों`
+  - `अगले/पिछले हफ्ते/महीने/साल`
+  - `अगले/पिछले सोमवार...रविवार`
+  - `{n} दिन बाद/पहले`
+- Added Marathi parsing support:
+  - `आज`, `उद्या`, `काल`, `परवा`
+  - `पुढील/मागील आठवडा/महिना/वर्ष`
+  - `पुढील/मागील सोमवार...रविवार`
+  - `{n} दिवसांनी/{n} दिवसांपूर्वी`
+- Added `SmartParser.parseLocale()` — parse with explicit locale
+- Added `SmartParser.canParseLocale()` — check locale parsing
+- Added `SmartParser.supportedParseLocales` — ['en', 'hi', 'mr']
 
 ## 1.5.0
 

example/pubspec.lock

@@ -21,10 +21,10 @@ packages:
     dependency: transitive
     description:
       name: characters
-      sha256: faf38497bda5ead2a8c7615f4f7939df04333478bf32e4173fcb06d428b5716b
+      sha256: f71061c654a3380576a52b451dd5532377954cf9dbd272a78fc8479606670803
       url: "https://pub.dev"
     source: hosted
-    version: "1.4.1"
+    version: "1.4.0"
   clock:
     dependency: transitive
     description:
@@ -111,26 +111,26 @@ packages:
     dependency: transitive
     description:
       name: matcher
-      sha256: dc0b7dc7651697ea4ff3e69ef44b0407ea32c487a39fff6a4004fa585e901861
+      sha256: dc58c723c3c24bf8d3e2d3ad3f2f9d7bd9cf43ec6feaa64181775e60190153f2
       url: "https://pub.dev"
     source: hosted
-    version: "0.12.19"
+    version: "0.12.17"
   material_color_utilities:
     dependency: transitive
     description:
       name: material_color_utilities
-      sha256: "9c337007e82b1889149c82ed242ed1cb24a66044e30979c44912381e9be4c48b"
+      sha256: f7142bb1154231d7ea5f96bc7bde4bda2a0945d2806bb11670e30b850d56bdec
       url: "https://pub.dev"
     source: hosted
-    version: "0.13.0"
+    version: "0.11.1"
   meta:
     dependency: transitive
     description:
       name: meta
-      sha256: "1741988757a65eb6b36abe716829688cf01910bbf91c34354ff7ec1c3de2b349"
+      sha256: e3641ec5d63ebf0d9b41bd43201a66e3fc79a65db5f61fc181f04cd27aab950c
       url: "https://pub.dev"
     source: hosted
-    version: "1.18.0"
+    version: "1.16.0"
   path:
     dependency: transitive
     description:
@@ -150,7 +150,7 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "1.6.0"
+    version: "2.1.0"
   source_span:
     dependency: transitive
     description:
@@ -195,10 +195,10 @@ packages:
     dependency: transitive
     description:
       name: test_api
-      sha256: "949a932224383300f01be9221c39180316445ecb8e7547f70a41a35bf421fb9e"
+      sha256: "522f00f556e73044315fa4585ec3270f1808a4b186c936e612cab0b565ff1e00"
       url: "https://pub.dev"
     source: hosted
-    version: "0.7.11"
+    version: "0.7.6"
   vector_math:
     dependency: transitive
     description:
@@ -216,5 +216,5 @@ packages:
     source: hosted
     version: "15.2.0"
 sdks:
-  dart: ">=3.10.0-0 <4.0.0"
+  dart: ">=3.9.0 <4.0.0"
   flutter: ">=3.18.0-18.0.pre.54"

lib/src/calendar/calendar_event.dart

@@ -14,17 +14,31 @@ enum EventMarkerStyle {
 
 /// Represents a single calendar event.
 ///
+/// Supports single-day and multi-day events.
+///
 /// ```dart
+/// // Single day event
 /// CalendarEvent(
 ///   date: DateTime(2024, 6, 15),
 ///   title: 'Team Meeting',
 ///   color: Colors.blue,
 /// )
+///
+/// // Multi-day event
+/// CalendarEvent(
+///   date: DateTime(2024, 6, 15),
+///   endDate: DateTime(2024, 6, 17),
+///   title: 'Company Retreat',
+///   color: Colors.green,
+/// )
 /// ```
 class CalendarEvent {
-  /// Date of the event
+  /// Start date of the event
   final DateTime date;
 
+  /// End date for multi-day events — null means single day
+  final DateTime? endDate;
+
   /// Title of the event
   final String title;
 
@@ -51,13 +65,14 @@ class CalendarEvent {
   /// ```dart
   /// CalendarEvent(
   ///   date: DateTime(2024, 6, 15),
-  ///   title: 'Meeting',
+  ///   endDate: DateTime(2024, 6, 17), // multi-day
+  ///   title: 'Conference',
   ///   color: Colors.blue,
-  ///   startTime: TimeOfDay(hour: 10, minute: 0),
   /// )
   /// ```
   const CalendarEvent({
     required this.date,
+    this.endDate,
     required this.title,
     this.color = Colors.blue,
     this.description,
@@ -67,11 +82,33 @@ class CalendarEvent {
     this.endTime,
   });
 
-  /// Returns true if this event is on [date].
-  bool isOnDate(DateTime date) =>
-      this.date.year == date.year &&
-      this.date.month == date.month &&
-      this.date.day == date.day;
+  /// Returns true if this is a multi-day event.
+  bool get isMultiDay => endDate != null && !_isSameDay(date, endDate!);
+
+  /// Returns number of days this event spans.
+  int get spanDays {
+    if (endDate == null) return 1;
+    return endDate!.difference(date).inDays + 1;
+  }
+
+  /// Returns true if [date] falls within this event's range.
+  bool isOnDate(DateTime date) {
+    final target = DateTime(date.year, date.month, date.day);
+    final start = DateTime(this.date.year, this.date.month, this.date.day);
+
+    if (endDate == null) return start == target;
+
+    final end = DateTime(endDate!.year, endDate!.month, endDate!.day);
+    return (target.isAtSameMomentAs(start) || target.isAfter(start)) &&
+        (target.isAtSameMomentAs(end) || target.isBefore(end));
+  }
+
+  /// Returns true if this event starts on [date].
+  bool startsOnDate(DateTime date) => _isSameDay(this.date, date);
+
+  /// Returns true if this event ends on [date].
+  bool endsOnDate(DateTime date) =>
+      endDate != null && _isSameDay(endDate!, date);
 
   /// Returns formatted time string.
   String get timeString {
@@ -82,6 +119,15 @@ class CalendarEvent {
     return '$start – ${_formatTime(endTime!)}';
   }
 
+  /// Returns formatted date range string.
+  String get dateRangeString {
+    if (!isMultiDay) return '';
+    return '${_formatDate(date)} – ${_formatDate(endDate!)}';
+  }
+
+  bool _isSameDay(DateTime a, DateTime b) =>
+      a.year == b.year && a.month == b.month && a.day == b.day;
+
   String _formatTime(TimeOfDay time) {
     final hour = time.hour > 12
         ? time.hour - 12
@@ -93,6 +139,9 @@ class CalendarEvent {
     return '$hour:$minute $period';
   }
 
+  String _formatDate(DateTime date) => '${date.day}/${date.month}/${date.year}';
+
   @override
-  String toString() => 'CalendarEvent($title, $date)';
+  String toString() => 'CalendarEvent($title, $date'
+      '${endDate != null ? ' → $endDate' : ''})';
 }