selection_group 0.1.0

The focus-aware, plug-and-play selection engine for Flutter TV, Desktop and Mobile.

0.1.0

The core has proven to be generic and extensible enough to grow. This release begins the widget layer — and marks the start of real-world stress testing in production.

The ideas behind this package are being proposed to Flutter itself in issue #183904, tagged by the Flutter team as c: new feature, c: proposal, f: focus, framework, and team-framework.

0.1.x will focus on built-in widgets, potential new constructors (multi-selection), and hardening the core against real production usage.

• feat: add SelectionGroupRadio — a ready-to-use, fully themeable radio button built on top of SelectionGroupItem. All colors (overlayColor, borderColor, dotColor) are driven by WidgetStateProperty, defaulting to transparent so the component is ready to be styled from outside.

0.0.10

• feat: add enabled parameter to SelectionGroupItem — when false, disables the button and applies WidgetState.disabled automatically, allowing disabled and selected to coexist independently.
• docs: rewrite maintainSelectionOnFocus section to better explain visual behavior on TV/Desktop.
• docs: added a note about explicit typing (e.g., SelectionGroup<String>) to ensure correct value comparison and state updates.

0.0.9

• docs: add missing CHANGELOG entry for 0.0.8

0.0.8

• Add maintainSelectionOnFocus — keeps WidgetState.selected visible while the group has focus
• Add focusInitialItem — requests focus on the initial item on the first frame

0.0.7

• feat: add SelectionGroupItem — a ready-to-use widget that integrates with SelectionGroup and handles visual states automatically.

• feat: SelectionGroupItemMixin.selectionValue is now nullable, allowing SelectionGroupItem to be used outside of a group while maintaining focus and states.

• refactor: modularized project structure with a navigation summary using part and part of for better maintainability.

0.0.6

• feat: add selectOnFocus flag — set to false to select only on press (e.g. radio buttons on TV)

0.0.5

• feat: onFocusChange replaced by onFocusedItemChanged — now returns the focused item value or null when the group loses focus
• feat: focused item is automatically marked as selected
• fix: focus listeners are now properly removed on unregister

0.0.4

• feat: add onFocusChange callback to SelectionGroup
• feat: suppress WidgetState.selected on all items while group has focus

0.0.3

• fix: update LICENSE to MIT
• fix: update tests

0.0.2

• fix: update LICENSE

0.0.1

• initial release