advanced_wrap 0.1.0

A production-ready, UX-first Flutter package that extends Flutter Wrap with powerful overflow strategies, controller-driven expand/collapse, responsive behavior, and accessibility features.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.1.0 - 2024-01-20

Added

• Initial release of AdvancedWrap package
• Core AdvancedWrap widget with children and itemBuilder support
• AdvancedWrapController for programmatic state management
• Five overflow strategies:
  • OverflowStrategy.count - Shows "+N more" indicator
  • OverflowStrategy.expand - Expand/collapse functionality
  • OverflowStrategy.popup - Shows overflow in dialog
  • OverflowStrategy.scrollable - Shows overflow in bottom sheet
  • OverflowStrategy.custom - Fully customizable overflow handling
• Responsive design with AdvancedWrapConfig and breakpoint support
• Custom RenderAdvancedWrap for optimized performance
• Comprehensive accessibility support with semantic labels
• Animation support with customizable curves and durations
• Extensive test coverage (>95%)
• Example app demonstrating all features
• Complete API documentation
• Migration guide from wrap_and_more

Features

• Support for both children list and itemBuilder pattern
• Configurable maxRows and minRows constraints
• Customizable spacing and alignment options
• Theme-aware styling with Material Design 3 support
• Memory-efficient rendering for large datasets
• Smooth 60fps animations
• Full keyboard and screen reader accessibility
• TypeScript-like API with comprehensive type safety

Performance

• Optimized layout calculations with custom render objects
• Lazy building for itemBuilder pattern
• Minimal memory footprint
• Efficient overflow detection and handling

Documentation

• Comprehensive README with examples
• API reference documentation
• Migration guide from wrap_and_more
• Contributing guidelines
• Example app with multiple use cases

Testing

• Unit tests for all core functionality
• Widget tests for UI components
• Integration tests for complex scenarios
• Performance benchmarks
• Accessibility testing