flutter_settings_framework 0.6.0

Declarative Flutter settings with bilingual search, a Riverpod adapter, and ready-made settings UI.

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.

0.6.0 - 2026-08-07

Packaging milestone (relicense + branding + first pub.dev publish path). No public API feature changes. See VERSIONING.md for the milestone exception to the usual MINOR = features rule.

Changed

• License: CC BY-NC-SA 4.0 → MPL-2.0.
• Branding: Edadat / إعدادات logo, bilingual READMEs (README.md, README.ar.md), pub-style install docs.
• Docs honesty: market Riverpod adapter + UI as what ships today (no Provider/Bloc adapters); clarify stream/callback core vs Riverpod UI.
• CI / release: example dart analyze on CI; Release workflow publishes to pub.dev via OIDC after verify + GitHub Release.

Fixed

• Example README no longer claims flutter run without platform folders.
• example/pubspec.lock synced to the package version.

0.5.1 - 2026-07-30

Fixed

• SettingAnchorRegistry.scrollTo: use jumpTo + a single ensureVisible instead of an animated pan that flickered when hosts also scrolled to the section.

0.5.0 - 2026-07-30

Baseline release under the new tag/CI system (v0.5.0).

Added

• ActionSetting: non-persisted settings for action/navigation rows that remain searchable and jump-targetable.
• SettingType.action: skipped by storage read/write.
• SearchIndex: indexes section titles onto member settings; tracks term→locale so SearchResult.matchedLocale is populated; multi-word queries require every distinct query word to match.
• SettingsSearchBarMode: persistent (full-width) and compact (icon).
• SettingAnchorRegistry / SettingAnchor / scrollToSetting: scroll-to and temporary highlight for search result selection.
• RegistrySettingsPage: persistent search under the app bar; result tap expands section and scrolls/highlights the setting.
• buildSearchResultWidgets: optional breadcrumb + onResultSelected.
• PreIndexedLocalizationProvider: true bilingual search indexing.
• Versioning docs, scripts/check_version.sh, scripts/release.sh.
• GitHub Actions: CI (analyze + test) and Release (tag verify + GitHub Release).
• Unit tests for SearchIndex and SettingsController.

Documentation

• README: pin consumers to ref: vX.Y.Z; PreIndexed boot; ActionSetting; synonyms; visible vs order for search exclusion.

0.3.0 - 2026-07-30

Pre-tag history (folded into 0.5.0 baseline).

Added

• ActionSetting, bilingual search UX, persistent search, jump-to highlight.

0.2.0 - 2026-02-13

Fixed

• Global change stream now fires for undo/import operations.

Improved

• Removed VoidCallback typedef that shadowed Flutter's built-in type.

Deprecated

• EasyLocalizationAdapter / MapLocalizationProvider stubs — use EasyLocalizationAdapterImpl / PreIndexedLocalizationProvider.
• Auto-dispose setting provider helpers — use createSettingProvider.

0.1.0 - 2025-01-15

Added

• Initial release of flutter_settings_framework.