Skip to content

CHANGELOG.md

Latest commit

 

History

History
105 lines (90 loc) · 4.63 KB

CHANGELOG.md

File metadata and controls

105 lines (90 loc) · 4.63 KB

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.

[2.0.0] - 2026-02-18

Added

  • FlexboxItemAnimationController with auto/manual animation modes
  • FlexboxItemAnimationConfig and withFlexboxItemAnimation for staggered entrance transitions in sliver/list builders
  • FlexboxScaleController.extentListenable for extent-only UI subscriptions
  • maxAspectRatioChecksPerLayout and aspectRatioCheckInterval options in dynamic flexbox delegates

Changed

  • Optimized sliver and render flexbox layout paths with delegate/layout caching
  • Improved dynamic aspect-ratio probing and relayout behavior for scrolling feeds
  • Updated scalable flexbox rebuilding from full controller listening to extent-only listening
  • Fixed max-lines behavior and defensive layout math in flexbox delegates
  • Updated and expanded test coverage for dynamic, sliver, scale-controller, and item-animation behavior

[1.1.1] - 2026-01-17

Changed

  • Enhanced documentation across all public APIs
  • Improved code comments and examples for better clarity
  • Comprehensive dart documentation coverage

[1.1.0] - 2026-01-15

Added

  • FlexboxScaleController - Controller for scalable flexbox with pinch-to-zoom support
    • Responsive scaling that follows pinch gestures in real-time
    • Smooth snap animation with spring physics
    • Mode switching between 1:1 grid and aspect ratio modes
    • Velocity-based momentum for natural gesture continuation
    • Configurable snap points, min/max extent, and grid mode threshold
  • FlexboxScaleMode enum - Display mode for scalable flexbox (grid1x1, aspectRatio)
  • SliverFlexboxDelegateWithDirectExtent - Delegate with direct extent control
    • Supports smooth continuous scaling without discrete column jumps
    • Fill factor interpolation for smooth layout transitions
    • Ideal for Google Photos-like pinch-to-zoom experience
  • SliverScalableFlexbox - Scalable sliver widget with pinch-to-zoom support
    • Automatically rebuilds when controller's extent changes
    • Integrates with CustomScrollView for seamless scrolling

Features

  • Pinch-to-zoom gesture support for flexbox layouts
  • Spring physics animations for smooth snap transitions
  • Fill factor animation for smooth layout state transitions
  • Automatic display mode switching based on zoom level
  • Double-tap to zoom between predefined levels
  • Programmatic zoom control with zoomIn() and zoomOut() methods
  • Velocity-based gesture momentum for natural feel

Example

  • Added ScalableFlexboxPage demonstrating pinch-to-zoom gallery
  • Network image gallery example with multiple image sources (Nekosia, Yande, Zerochan)

[1.0.0] - 2026-01-14

Added

  • Initial release of the Flutter Flexbox library
  • Flexbox widget - full CSS Flexbox layout implementation
  • FlexItem widget - wrapper for flex item properties
  • FlexboxList - scrollable list with flexbox layout capabilities
  • SliverFlexbox - sliver version for CustomScrollView
  • DynamicFlexboxList - auto-sizing flexbox list for variable content
  • SliverDynamicFlexbox - dynamic sliver for CustomScrollView
  • DimensionResolver - utility for measuring child dimensions
  • Multiple delegate types for different layout scenarios:
    • SliverFlexboxDelegateWithFixedCrossAxisCount
    • SliverFlexboxDelegateWithMaxCrossAxisExtent
    • SliverFlexboxDelegateWithAspectRatios
    • SliverFlexboxDelegateWithDynamicAspectRatios
    • SliverFlexboxDelegateWithFlexValues
    • SliverFlexboxDelegateWithBuilder

Features

  • Full CSS Flexbox layout algorithm implementation
  • Support for flexDirection, flexWrap, justifyContent, alignItems, alignContent
  • Flex item properties: order, flexGrow, flexShrink, alignSelf, flexBasisPercent
  • Size constraints: minWidth, minHeight, maxWidth, maxHeight
  • wrapBefore property for explicit line breaks
  • Main axis and cross axis spacing
  • Item recycling for efficient scrolling
  • Dynamic sizing based on aspect ratios
  • Text direction support (LTR/RTL)
  • Max lines limitation for wrapped layouts
  • Configurable thresholds for layout updates:
    • aspectRatioChangeThreshold - minimum aspect ratio change to trigger update
    • crossAxisExtentChangeThreshold - viewport width change to clear cache
  • FlexboxList extends BoxScrollView for better framework integration
  • Comprehensive Dart documentation with examples for all public APIs

Example

  • Complete example app with interactive playground
  • Demonstrations of all major features
  • Network image gallery example