Changelog #

0.4.0 - 2026-07-29 #

Added adaptive visual-effects budgets with reduced Android defaults, full iOS/macOS glass effects, compile-time backdrop-filter exclusion, theme overrides, accessibility reduction, and coverage across kit-owned blur surfaces.
Added UiRadioGroup<T> and UiRadioGroupOption<T> for typed grouped radio selection with labels, helper text, error text, disabled state, and horizontal or vertical layout.
Added UiTimeGridPicker and UiTimePickerField for compact column-based time selection in drawers, forms, and anchored popovers.
Deprecated legacy UiTimePicker in favor of UiTimeGridPicker and UiTimePickerField.
Added picker chrome controls for suppressing nested borders and adjusted date picker month navigation to use UiIconButton chevrons instead of text glyphs.
Made compact navigation back labels adapt to wider tablet and desktop navigation bars while preserving the tighter phone cap.
Added experimental UiSmartActionGroup for inline "More" action groups that morph into additional buttons without opening a sheet, now using a coordinated group-level layout animation with equal expanded slots by default.
Added experimental UiConfirmActionGroup for two-button save/delete confirmation rows with coordinated width and label morphs.
Added AI-agent guidance through AGENTS.md, doc/ai_usage_guide.md, README quick-start rules, public Dartdoc, and example/lib/ai_usage_examples.dart so tools like Codex can follow package conventions and best practices.

Added UiButton.showBorder so bordered button variants can opt out when used as elevated floating actions.

Fixed page bodies and generated title bars being placed beneath iPhone status-bar and Dynamic Island insets.
Breaking: UiPageScaffold, UiPageLayout, UiCollectionPage, and UiAppShell now apply safe insets by default. Intentional edge-to-edge pages must opt out explicitly.
Preserved vertical edge-to-edge page surfaces while independently applying physical left/right protection for landscape display cutouts.
Added reduced-motion support, reusable fade-scale and slide-fade transition primitives, and migrated structural transitions in menus, dialogs, drawers, toasts, tabs, app routes, navigation chrome, and sheets to resolve motion from the theme.

Added pull-to-refresh widgets, programmatic refresh control, and collection page integration.
Added dual-pane layouts, sticky sliver regions, numeric navigation badges, and navigation chrome that adapts to persistent rails.
Improved navigation rail and drawer sizing, mobile landscape navigation, floating-window chrome handling, and component spacing and radii.
Corrected navigation examples and Markdown formatting across the package documentation.
Breaking: Removed UiSliverNavigationBar.bodyTopPadding. Add any desired gap to the content sliver that follows the navigation bar.

Added the initial publication-ready release of the token-driven Flutter UI kit.
Added reusable components for forms, feedback, navigation, overlays, data display, and responsive page layouts.
Added theme foundations, platform capabilities, accessibility behavior, and golden coverage.