dropdown_plus_bloc 1.4.1

Customizable Flutter dropdowns with BLoC/Cubit integration: searchable single-select and multi-select with chips, offline caching, and theming.

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.

1.4.1 - 2026-07-14

Docs

• README screenshots replaced with animated GIFs (single select, multi select, form field).

1.4.0 - 2026-07-14

Added

• DropdownPlusController<T> — programmatic select, clear, open, close for typed single-select widgets.
• DropdownPlusMultiController<T> — programmatic select, deselect, setValues, clear, open, close for typed multi-select widgets.
• Optional controller on all four typed widgets (typed.dart).

No breaking API changes to dropdown_plus_bloc.dart.

1.3.0 - 2026-06-30

Added

• Pagination — optional onLoadMore, hasMore, and isLoadingMore on all dropdown widgets (and typed variants).
• focusNode on trigger buttons for keyboard/focus traversal.
• Improved accessibility — Semantics on list items (selected/checked), trigger expanded state, default label from hintText.

Changed

• Item lists use ListView.builder instead of ListView.separated + shrinkWrap for better performance with long lists.

No breaking API changes.

1.2.0 - 2026-06-30

Added

• Typed API (preview) — opt-in via package:dropdown_plus_bloc/typed.dart:
  • TypedSearchableDropdownPlus<T, C, S>
  • TypedMultiSelectDropdownPlus<T, C, S>
  • TypedSearchableDropdown<T>
  • TypedMultiSelectDropdown<T>
• TypedDropdownAdapter, ItemLabel, ItemEquals, typed builders.
• List<T>.toDropdownItems() extension for legacy bridge.
• doc/TYPED_API.md and tests in test/typed/.
• Example app demos typed API, form fields, and legacy widgets side by side.

No breaking changes to dropdown_plus_bloc.dart default export.

1.1.1 - 2026-06-30

Added

• SearchableDropdownFormField and SearchableDropdownPlusFormField — single-select [FormField] wrappers with validator, onSaved, autovalidateMode, and initialValue.
• MultiSelectDropdownFormField and MultiSelectDropdownPlusFormField — multi-select [FormField] wrappers with the same form integration.
• Form field tests in test/form_field_test.dart.

No breaking API changes.

1.1.0 - 2026-06-30

Added

• Phase 0 enhancements (all four widgets): enabled, autofocusSearch, emptyBuilder, loadingBuilder, error, onRetry, errorBuilder, semanticsLabel, minSearchLength.
• Shared internal UI layer under lib/src/internal/ (panel, trigger, search bar, item lists, states).
• Tests for enabled, errorBuilder, and minSearchLength.

Changed

• Widget implementations delegate to shared internal components (no public API removals).

No breaking API changes — upgrade from ^1.0.0 without code modifications.

1.0.0 - 2026-06-30

Fixed

• Critical: SearchableDropdownPlus and MultiSelectDropdownPlus no longer close a parent-owned cubit on dispose (BlocProvider.value instead of BlocProvider(create:)).
• Single-select item lists now respect DropdownPlusTheme.menuMaxHeight instead of a hardcoded 200px height.

Added

• Optional debounceDuration on all four dropdown widgets (default Duration.zero — no behaviour change unless set).
• Package widget tests and doc/UPGRADING_TO_1.0.md.

Docs

• README uses correct dropdown_plus_bloc package/import names.
• Example disposes cubits in dispose().

No breaking API changes — upgrade from 0.1.x without code modifications.

0.1.6 - 2026-03-15

Added

• SearchableDropdown — single-select searchable dropdown without BLoC; pass items, isLoading, and optional onSearch.
• MultiSelectDropdown — multi-select with chips without BLoC; same pattern as SearchableDropdown.

Docs

• README: widget overview, quick-start examples, and API tables for the non-BLoC dropdowns.

0.1.5 - 2026-03-15

Docs

• Version bump and documentation-only update (no functional changes).

0.1.4 - 2026-03-15

Docs

• Updated README with screenshots for better usage understanding.

0.1.3 - 2026-03-15

Fixed

• Fixed flutter_bloc downgrade/analysis compatibility by removing the StateStreamableSource type constraint from dropdown widgets.

0.1.2 - 2026-03-15

Added

• Added DropdownPlusThemeStyle preset enum (material, minimal, rounded, outlined, dark, compact) for out-of-the-box themed dropdown UIs
• Added DropdownPlusThemePresets.forStyle(...) helper to resolve preset themes programmatically
• Added themeStyle parameter to both SearchableDropdownPlus and MultiSelectDropdownPlus
• Exported dropdown_plus_theme_style.dart from the package entry library
• Updated README with preset theme style usage and API docs

Fixed

• Fixed compact-mode bottom overflow in MultiSelectDropdownPlus by constraining open panel height to available parent space

0.1.0 - 2025-01-01

Added

• Initial release
• SearchableDropdownPlus — single-select searchable dropdown with BLoC integration
• MultiSelectDropdownPlus — multi-select dropdown with chip display and BLoC integration
• DropdownPlusTheme — full visual customisation for all widget properties
• DropdownItem<T> — generic model for dropdown items
• Plain StatefulWidget implementation — no flutter_hooks dependency
• Offline caching with client-side fallback filtering
• Controlled-mode support via selectedValue / selectedItems props
• Animated open/close transitions and arrow rotation
• "Select All" / "Clear All" multi-select header
• Overflow chip badge (+N more) for multi-select trigger
• Custom itemBuilder, selectedValueBuilder, selectedItemBuilder hooks
• checkInternetConnection callback for custom connectivity detection