pagy 1.1.1

pagy: ^1.1.1 copied to clipboard

🎯 ItemBuilder Enhancement #

• ✨ Index Parameter Support: Added itemBuilderWithIndex parameter that includes item index access
• 🔧 Better Item Builders: Now you can build widgets that need to know their position (e.g., "#1", "#2", etc.)
• 📝 Backward Compatible: Old itemBuilder (without index) still works but is deprecated
• 🔄 Automatic Migration: Use itemBuilderWithIndex: (context, item, index) => ... instead of itemBuilder: (context, item) => ...

🎯 UX Improvements & New Features #

• 🔄 Refresh on Empty: Added support for pull-to-refresh when the list is empty
• 💬 Empty State Customization: Added emptyStateBuilder, emptyMessage, and emptyIcon for comprehensive empty state customization
• ✨ Built-in Response Parsers: Added PagyParsers class with pre-built parsers for common API response structures (Laravel, Django, etc.)
• 🏷️ Better Error Handling: Introduced PagyError class with error types, helpful suggestions, and status codes
• 📊 Pagination Metadata: Added PagyMetadata for easy access to pagination info in UI (currentPage, totalPages, progress, etc.)
• 🔧 Convenience Methods: Added refresh(), applyFilters(), search(), and loadMore() methods to PagyController
• ⚙️ Enhanced Configuration: Added validation for baseUrl, helpful warnings, and better error messages
• 📝 Improved Naming: Introduced clearer parameter names with deprecation strategy:
  • responseMapper → responseParser
  • additionalQueryParams → query
  • paginationMode → payloadMode (controller & config)
  • apiLogs → enableLogs
• 📚 Comprehensive Documentation: Complete README rewrite with examples, migration guide, and common use case
• 🔄 Full Backward Compatibility: All old parameter names still work (deprecated, will be removed in v2.0.0)

• 🚀 Remapped the entire package to Clean Architecture for improved scalability and maintainability.
• 📝 Added support for custom headers in API requests.
• 🏗️ Introduced a separate builder option in PagyListView for more flexible UI rendering.
• ⏹️ Implemented automatic cancellation of previous API calls when new requests are triggered.
• 🔒 Added interceptor support for advanced request/response handling (e.g., token blacklist).
• 🔗 PagyController now integrates seamlessly with both BLoC and Riverpod.
• 🧩 Added dependency injection test hooks, removing strict reliance on global PagyConfig.
• 📊 Enhanced logging system to allow monitoring and saving of request/response logs.
• 🌗 Integrated automatic theme support to adapt to the user's app theme (light/dark).

• Added POST request support and enhanced API interactions.
• Improved .gitignore.
• Updated dependencies.

• Set Dio compatible version.

• Fixed dependency issues.
• Updated compatibility for Flutter 3.32.
• Added functionality to limit the number of displayed items.

• Fixed logo.
• Improved example.

• Initial release.
• Added assets path.