infinite_grouped_list 1.3.0

infinite_grouped_list: ^1.3.0 copied to clipboard

Major Features

• ✨ NEW: InfiniteGroupedList.reactive() constructor for reactive state management patterns
• ✨ NEW: InfiniteGroupedList.reactiveGrid() constructor for grid layouts with reactive patterns
• 🔌 Full BLoC/Provider/Riverpod Integration: Clean separation between event triggering and data listening
• 🎯 Event-Driven Architecture: onLoadMoreTriggered callback decouples data fetching from UI events
• 📡 External State Support: Accepts items, isLoading, hasReachedMax, and error from external state management

API Enhancements

• 🎛️ Smart Controller Behavior: Controller methods automatically adapt to reactive vs imperative mode
• 🚫 Safety Guards: Controller throws helpful errors when using imperative methods in reactive mode
• 🔄 Reactive Lifecycle: Automatic updates when external state changes via didUpdateWidget
• ⚡ Performance Optimized: Efficient reactive data handling without unnecessary rebuilds

Example Project Improvements

• 📱 Comprehensive BLoC Example: Full-featured reactive example with mock API, error handling, and loading states
• 🧭 Enhanced Navigation: Example selection screen with beautiful cards and proper navigation
• 🎨 Rich UI Components: Category-based grouping with colored icons, sticky headers, and animations
• 🔄 Refresh Patterns: Demonstrates both pull-to-refresh and manual refresh in reactive mode

Developer Experience

• 📚 Pattern Comparison: Side-by-side examples of imperative vs reactive patterns
• 🏗️ Clean Architecture: Examples follow modern Flutter architecture best practices
• 🎯 Real-world Simulation: Mock network calls, pagination limits, and error scenarios
• 💡 Clear Documentation: Comprehensive inline examples and usage patterns

Breaking Changes

• None! Fully backward compatible with existing imperative usage

• Upgraded dependencies to the latest versions

• ✨ Added scrollController to all constructors, you can now pass your own scroll controller

Performance Improvements

• ⚡ Optimized group operations with targeted updates instead of full regrouping
• 🧠 Reduced memory usage by avoiding unnecessary data structure recreation
• 🚀 Implemented efficient item addition with selective group updates
• 🗑️ Optimized item removal with targeted group processing

Bug Fixes

• 🔍 Fixed potential memory leaks by properly clearing controller callbacks
• 🎯 Improved scroll performance for large datasets
• 🔄 Enhanced refresh operation efficiency

API Improvements

• ✨ Added helper methods for group management (_sortSingleGroup, _addItemsToGroups, _createInitialGroups)
• 📊 Better handling of empty groups after item removal

• Fixes hashValues deprecated issues

• Adds addItems method in InfiniteGroupedListController
• Adds removeWhere method in InfiniteGroupedListController
• Hides internal methods in InfiniteGroupedListController

• Adds a new limit parameter in InfiniteGroupedListController to tell the library how much items are expected from the remote call
• Adds a callback onNoMoreItemsFound that is triggered when the response returns less items than the provided limit

• Refactors InfiniteGroupedListController to avoid LateInitializationErrors

• Adds missing showRefreshIndicator from default constructor

• Adds showRefreshIndicator flag which defaults to true

• Adds missing Key

• Adds remove(ItemType) method to the controller. You can now programmatically remove items from the list.

• Tweaks initialItemsErrorWidget & loadMoreItemsErrorWidget parameters. They are now function that returns a Widget, exposing the error aswell :

        initialItemsErrorWidget: (error) => GestureDetector(
          child: Text(
            error.toString(),
            textAlign: TextAlign.center,
            style: const TextStyle(
              fontSize: 15,
              fontWeight: FontWeight.w500,
              decoration: TextDecoration.underline,
              decorationColor: Colors.blue,
              color: Colors.blue,
            ),
          ),
        ),
        loadMoreItemsErrorWidget: (error) => GestureDetector(
          child: Text(
            error.toString(),
            textAlign: TextAlign.center,
            style: const TextStyle(
              fontSize: 15,
              fontWeight: FontWeight.w500,
              decoration: TextDecoration.underline,
              decorationColor: Colors.blue,
              color: Colors.blue,
            ),
          ),
        ),

• Adds physics parameter. Defaults to [AlwaysScrollablePhysics]

• Initializes getItems with default empty List to avoid LateInitializationError
• Internal code refactoring

• Internal code refactoring

• Adds new builder InfiniteGroupedList.gridView. Define your gridDelegate and customise it as you want.

• Fields made optional:
  • seperatorBuilder
  • sortGroupBy
• Removes the padding that was not removed on previous version.

• Removes padding parameter as it does not correspond to anything
• Adds isPaged parameter. If the onLoadMore is not paged, everytime the same items will be added to the list when the list reaches at the bottom. Therefore, we should set the isPaged to false and after the initial fetch it will stop fetching the items. It defaults to true
• Checks if mounted before setting state

• Initial release