sliver_dashboard 0.3.1

sliver_dashboard: ^0.3.1 copied to clipboard

• Updated README.md

New feature:

Introduces Sliver direct composition via DashboardOverlay, and decouples interaction logic from the rendering layer.

• Introduced DashboardOverlay widget to handle all global interactions (drag, resize, trash, auto-scroll) and background rendering.
• Added SliverDashboard widget for direct composition within CustomScrollView (allows SliverAppBar, SliverList, etc.).
• Refactored the main Dashboard widget to use DashboardOverlay internally (backward compatibility).
• Grid Clipping behavior:
  • When using SliverDashboard to compose with others slivers, the grid stops precisely at the content end (allowing subsequent slivers to be visible). If no subsequent slivers to be visible (eg. SliverAppBar + SliverDashboard), you can set fillViewport to true to extend grid in viewport.
  • When using Dashboard widget, in an Expanded, the grid fills the viewport, and fillViewport has no action.

Documentation:

• Updated README.md and architecture.md to reflect the new Overlay/Sliver architecture and document the fillViewport parameter.
• Added main_sliver.dart example demonstrating sliver composition.

Breaking Changes:

• Refactored Controller API: DashboardController is now a strict interface. Internal methods (like onDragUpdate, dragOffset, etc.) are no longer exposed publicly. This improves IDE autocompletion and prevents accidental misuse of internal logic.
  • Migration: If you were using internal methods, you should stop doing so as they are managed by the package. If you absolutely need access for advanced custom widgets, you can cast the controller to DashboardControllerImpl (not recommended).

Improvements:

• Added DashboardControllerImpl to handle logic separately from the interface.

• Fix secondary collisions where multiple items pushed by the resizing element would temporarily overlap at the same Y coordinate.
• Add test to verify that multiple items pushed by a resize operation stack correctly instead of merging.

• Fix resize behavior during auto-scroll
• Add tests to verify auto-scroll behavior for both resize and external drag scenarios.

• Updated README.md

• Updated README.md contributing section, architecture.md and added an AGENTS.md file.

• Initial release.

• Initial release.