coverflow_carousel 1.2.0

A highly customizable 3D coverflow-style carousel for Flutter with smooth animations, perspective effects, and controller support.

1.0.0

1. Smooth 3D coverflow-style carousel

2. Customizable card dimensions

3. Adjustable overlap and spacing

4. Perspective and rotation effects

5. Smooth swipe navigation

6. Controller support

7. Programmatic navigation

8. Blur effects for non-focused cards

9. Responsive layout

10. Optimized rendering for large datasets

11. Builder-based API

1.0.1

1. Fixed README demo GIF link

1.1.0

1. Infinite Scroll: Added isInfinite support for seamless circular scrolling and shortest-path programmatic animations.
2. Entry Animations: Added entryAnimation parameter supporting staggered fades, zooms, spacing expansions, slides, and front-stacking (fadeIn, scaleUp, spacingExpand, staggeredSlide, fadeScale, and stack).
3. Card Interactivity: Side-cards now support click-to-focus, and centered cards are fully interactive (clicks pass to inner buttons without interference).
4. Web & Desktop Dragging: Enabled mouse click-and-drag swiping on Web and Desktop.
5. Scrollbar Suppression: Disabled the native scrollbar from drawing behind cards.
6. Custom Viewport Fraction: Added viewportFraction property supporting dynamic hot updates.
7. Optimized BackdropFilter: Blur filters are only drawn when active, improving GPU rendering.
8. Testing: Built a full suite of 10 widget tests verifying layouts, gestures, entry transitions, and controllers.
9. Code Documentation: Added 100% pub.dev public API coverage with detailed Dart doc comments (///) on all classes, properties, constructors, methods, and enums.
10. Architecture & Mathematics Reference: Added package_documentation.md containing detailed 3D transform projection matrices, spacing equations, gesture layers, and timeline stagger formulas.
11. Lint Fixes: Resolved unnecessary library name lint warnings in export declarations.

1.1.1

1. Example Application: Added a complete, interactive, and beautifully styled example application under example/ demonstrating infinite scroll, entry animations, blur obscuring, and programmatic controllers.

1.1.2

1. Fixed swiping on mobile applications

1.2.0

1. Center Card Overlay: Added centerOverlayBuilder to CoverflowCarousel.builder allowing custom overlay widgets (such as play buttons, badges, or tags) to be stacked on the active centered card.

2. Smooth Fade Transition: The center overlay automatically fades in and out smoothly using a scroll-linked opacity calculation based on the card's distance from the center.

3. Flexible Positioning: Developers can use standard Flutter alignment and layout widgets (Align, Positioned, Center) inside the overlay builder to place the widget anywhere on the card.

4. Interactive Overlays: Overlay widgets on the active centered card are fully interactive and support pointer events (like button taps/onPressed), while off-center cards redirect taps to focus the card.

5. 3D Hover/Tilt Effect: Added support for interactive 3D perspective tilting of the active centered card as the mouse pointer hovers over it. Includes configuration properties enableHoverTilt and maxHoverTiltAngle.

6. Mouse Scroll Wheel Navigation: Added support for mouse scroll wheel and trackpad scroll navigation to scroll to the next and previous cards.

7. Throttled Scroll Events: Throttled consecutive scroll signals relative to the animation duration to prevent rapid card skipping and ensure smooth transitions.

8. Performance Optimizations:

   • Confined hover calculations and rebuilds locally to the centered card, preventing parent repaints.
   • Wrapped tilted card children in a RepaintBoundary to leverage GPU matrix transformations and prevent expensive rasterization repaints.
   • Fixed the resetting tilt animation to utilize linear interpolation from cached start offsets, preventing compounding timer decay.

9. Robust Testing: Expanded package and example tests to cover mouse wheel navigation, scroll throttling, and 3D hover gestures.