animated_cycler

Added

• Added onAnimationStart callback that triggers when animation transitions begin
• The callback receives the item that will be displayed next and its index
• Works with all navigation methods: auto-play, nextItem(), previousItem(), and goToIndex()

Improved

• Enhanced animation event system with both start and complete callbacks
• Added comprehensive test coverage for the new callback functionality

Fixed

• Fixed loop: false parameter not working properly - the widget now correctly stops at the last item when loop is disabled
• Fixed autoPlay to stop automatically when reaching the last item with loop: false
• Added proper boundary checks for next/previous item navigation
• Added animation completion callbacks to all navigation methods (nextItem, previousItem, goToIndex)

Improved

• Enhanced code quality by fixing all lint warnings
• Improved code formatting to meet Dart style guidelines (80-character line limit)
• Added comprehensive test coverage for loop functionality
• Added example demonstrating loop: false behavior

Documentation

• Updated CHANGELOG.md with version history

Internal

• Version skipped due to publishing process

Added

• Initial release of AnimatedCycler package
• Support for both vertical and horizontal animation directions
• Generic type support for any data type
• Automatic cycling with customizable display and animation durations
• Manual control methods: nextItem(), previousItem(), goToIndex()
• Auto-play controls: togglePlayPause(), pause(), resume()
• Named constructors: AnimatedCycler.vertical() and AnimatedCycler.horizontal()
• Customizable animation curves (defaults to Curves.easeInOut)
• Item tap callbacks with onItemTap parameter
• Animation completion callbacks with onAnimationComplete parameter
• Loop control with loop parameter
• Performance optimizations for smooth animations
• Comprehensive documentation with API reference
• Example usage code for common scenarios

Features

• Bidirectional Animation: Smooth transitions in both vertical and horizontal directions
• Type Safety: Full generic type support with Dart's type system
• Flexible Sizing: Configurable container size (height for vertical, width for horizontal)
• Auto-play Control: Start, stop, pause, and resume functionality
• Manual Navigation: Programmatic control over item selection
• Custom Styling: Complete control through custom itemBuilder function
• Event Handling: Tap detection and animation completion callbacks
• Performance Optimized: Efficient rendering with minimal rebuilds

Technical Details

• Minimum Flutter SDK: >=3.0.0
• Minimum Dart SDK: >=2.17.0
• Zero external dependencies (Flutter framework only)
• Stateful widget with TickerProviderStateMixin for smooth animations
• Uses AnimationController and Transform.translate for optimal performance
• Automatic cleanup of timers and animation controllers

Documentation

• Comprehensive README with usage examples
• Complete API documentation with dartdoc comments
• Example code for vertical and horizontal usage
• Testing guidelines and examples
• Contributing guidelines for developers