rerune 0.11.0

OTA localization updates for Flutter apps with build_runner code generation.

0.11.0

• BREAKING: backend manifests must include a non-empty main_language that resolves to an entry in locales; legacy manifests without it are rejected.
• BREAKING: ReRuneManifest(...) now requires mainLanguage.
• Removed the legacy missing-main_language resolution path. OTA lookup always resolves requested locale variants, then main-language variants, then the bundled Flutter fallback.

0.10.0

• Added OTA missing-key fallback through the manifest's main_language: requested OTA locale variants -> OTA main-language variants -> bundled Flutter localization.
• ICU placeholders, plurals, and selects resolved from the OTA main language now use that supplying locale's formatting rules.
• Manifest parsing and caching now preserve the normalized main_language.
• Excluded the repository's private test app from pub.dev release archives.

0.9.3

• Clarified that MaterialApp.locale is optional and only needed for app-owned language-picker overrides.
• Updated the README install snippet to the latest published version.

0.9.2

• Added a locale picker to the example app's current-locale status row using app-owned LocaleNotifier state.

0.9.1

• Clarified the recommended language-picker docs with an app-owned LocaleNotifier example and a null system-default picker option.

0.9.0

• BREAKING: removed the SDK-owned locale override APIs introduced in 0.8.4: ReRune.locale, ReRune.localeListenable, ReRune.setLocale(...), and ReRune.clearLocale().
• ReRune now documents app-owned locale state as the recommended language-picker integration. Build picker options from ReRune.supportedLocales, store the selected locale in the app, and pass that value to MaterialApp.locale.
• ReRuneBuilder again rebuilds only on localization bundle revisions.
• The example welcome screen now displays the resolved locale tag instead of a localized hardcoded language name.

0.8.4

• Added SDK-owned locale override state with ReRune.locale, ReRune.localeListenable, ReRune.setLocale(...), and ReRune.clearLocale().
• ReRuneBuilder now rebuilds for selected-locale changes as well as localization bundle revisions.
• Documented the optional language-picker flow using ReRune.supportedLocales plus MaterialApp.locale: ReRune.locale.

0.8.3

• Highlighted remote language delivery in the package documentation.
• Documented ReRune.supportedLocales as the source of truth for language pickers that include fetched/cached dashboard-only locales.

0.8.2

• Added support for dashboard-only locale additions after a successful manifest and ARB fetch, allowing new languages to become available without an app-store release.
• ReRune.supportedLocales now includes compiled app locales plus fetched/cached dashboard locales.
• Generated localization overlays now preserve the requested locale name when falling back through a compiled base locale.
• Manifest locale keys are normalized to Flutter-style locale keys such as pt_BR.
• Added ReRune.localizationsRevisionListenable; ReRuneBuilder now rebuilds on all localization revisions so root MaterialApp widgets can re-resolve newly available dashboard locales.
• ReRune.setup(...) now returns a Future<void> that completes after cached manifest/ARB bundles are loaded; checkOnStart refreshes continue in the background instead of blocking setup.

0.8.1

• Clamp oversized periodic refresh intervals on web to the maximum supported timer delay instead of throwing.
• Document the web timer fallback limit in the public update policy API and README.

0.8.0

• BREAKING: ReRuneUpdatePolicy now configures periodic refresh with periodicIntervalInHours and/or periodicIntervalInDays; minute- and second-level intervals are no longer accepted.
• BREAKING: runtime now requires manifest locale entries to provide absolute url values.
• BREAKING: removed runtime ARB URL fallback synthesis; ARB fetch uses manifest url only.
• Tightened ARB parsing to enforce string message values for non-metadata keys.
• Refactored OTA update workflow and network fetch internals to reduce cyclomatic complexity.

0.6.0

• BREAKING: renamed ReRuneOverlayBuilder to ReRuneBuilder.

0.5.0

• Added fast CLI codegen command: dart run rerune.
• Added parity guard coverage to ensure CLI and builder generation stay byte-identical.

0.4.1

• Excluded internal docs/ session notes from publish artifacts via .pubignore.
• Excluded local build/ artifacts from publish artifacts via .pubignore.

0.4.0

• BREAKING: removed manual annotation-anchor setup for codegen.
• build_runner now generates ReRune config directly from app_localizations.dart.

0.3.0

• BREAKING: collapsed repository back to a single package rerune.
• BREAKING: removed split packages (rerune_core, rerune_gen) and workspace tooling.
• Added build_runner codegen directly in rerune (build.yaml, lib/builder.dart).
• BREAKING: removed macro scaffolding APIs; generation is codegen-only.
• BREAKING: setup now accepts generated localizations config via ReRune.setup(..., localizations: reRuneAppLocalizationsConfig).
• Removed macro example and retained one codegen-based example app.

0.2.0

• BREAKING: removed CLI wrapper generation workflow (dart run rerune / flutter pub run rerune).
• Added package-owned integration runtime APIs: ReRune, ReRuneOverlayLocalizationsDelegate<T>, and ReRuneOverlayBuilder.
• BREAKING: ReRune.setup(...) now requires supported locales either via supportedLocales: or by calling ReRune.configureLocalizationsOverlay(...) first.
• Added macro migration scaffolding APIs: ReRuneLocalizationsOverlay and ReRuneLocalizationsOverlayMacro.
• Migrated example app away from generated rerune_app_localizations.dart to app-owned overlay wiring.

0.1.3

• Lowered package SDK constraints to dart >=3.4.0 <4.0.0 and flutter >=3.22.0 to avoid unnecessarily requiring Dart 3.9+.

0.1.2

• BREAKING: removed generated ReRune.fetchedRevisionListenable; use ReRune.onFetchedTextsApplied as the single fetched-update event handle.
• BREAKING: simplified generated ReRuneBuilder to a single builder: callback; removed ReRuneRefreshMode and refresh mode options.
• Updated generator output and example pages/docs to use the single event-stream + builder model.

0.1.1

• Added generated ReRuneBuilder widget for app-side redraws after OTA changes.
• ReRuneBuilder now uses builder: (Flutter convention) instead of child:.
• ReRuneBuilder supports ReRuneRefreshMode.fetchedUpdatesOnly (default) and ReRuneRefreshMode.anyControllerChange.
• Updated generated wrapper template and example BuilderPage to use ReRuneBuilder instead of manual ValueListenableBuilder wiring.

0.1.0

• BREAKING: removed all rerune.json runtime config support.
• BREAKING: removed projectId, apiKey, and manifestUrl setup/constructor inputs.
• BREAKING: ReRuneLocalizationController now requires otaPublishId and sends it as X-OTA-Publish-Id.
• BREAKING: ReRuneLocalizationController and typed builder APIs are no longer exported publicly; use generated ReRune.setup(...) and ReRune static APIs.
• Manifest endpoint is now fixed to https://rerune.io/api/sdk/translations/manifest?platform=flutter.
• ARB fallback endpoint is now https://rerune.io/api/sdk/translations/flutter/{locale} when manifest locale URL is omitted.
• Example app now uses setup-only integration (no direct controller construction).

0.0.4

• BREAKING: removed seed ARB support (seedBundles and translations_path).
• Fallback now follows Flutter defaults only: OTA/cache first, then bundled AppLocalizations strings.
• BREAKING: runtime config now uses strict precedence rerune.json asset -> constructor (projectId, apiKey).
• BREAKING: removed runtime --dart-define fallback for config resolution.
• platform is fixed to flutter and is no longer configurable in controller/runtime config.
• Added explicit StateError with debug log when required credentials are missing.
• Docs/examples now use ReRune.setup(...), ReRune.localizationsDelegates, and ReRune.supportedLocales.
• Clarified that ReRuneUpdatePolicy defaults to checkOnStart: true.
• Generated ReRune.setup(...) helper now auto-wires supported locales and initializes OTA.
• BREAKING: removed deprecated generated compatibility aliases (Rerune...Setup, createRerune...Controller).
• BREAKING: removed CLI executable alias generate; use flutter pub run rerune only.
• BREAKING: renamed OtaLocalizationController to ReRuneLocalizationController.
• BREAKING: renamed OtaUpdatePolicy to ReRuneUpdatePolicy.
• BREAKING: renamed OtaUpdateResult to ReRuneUpdateResult.
• BREAKING: renamed OtaErrorType/OtaError to ReRuneErrorType/ReRuneError.
• BREAKING: renamed Manifest/ManifestLocale to ReRuneManifest/ReRuneManifestLocale.
• BREAKING: renamed CachedManifest/CachedArb to ReRuneCachedManifest/ReRuneCachedArb.
• BREAKING: renamed CacheStore to ReRuneCacheStore and createDefaultCacheStore() to reRuneCreateDefaultCacheStore().
• BREAKING: renamed OtaTypedLocalizationBuilder to ReRuneBuilder.
• BREAKING: renamed typed builder typedefs to ReRuneDelegateFactory<T> and ReRuneLocalizationWidgetBuilder<T>.
• Added ReRuneTextUpdateEvent and exported it from package:rerune/rerune.dart.
• Added optional fetched-only refresh APIs for immediate UI updates after applied OTA text changes: reRuneFetchedRevision, reRuneFetchedRevisionListenable, and onReRuneFetchedTextsApplied.
• Added ReRuneLocalizationRefreshMode.fetchedUpdatesOnly to ReRuneBuilder.
• Existing refresh behavior remains default; fetched-only refresh is opt-in.
• Updated generator output (rerune_app_localizations.dart) to use renamed ReRune* public APIs.
• Expanded tests:
  • controller tests for fetched-only revision/event behavior,
  • new test/ota_typed_localization_builder_test.dart for builder refresh modes,
  • updated example widget test coverage for menu navigation.
• Example app now has a 3-page demo menu:
  • manual refresh page,
  • event-listener (onReRuneFetchedTextsApplied) page,
  • ReRuneBuilder page with fetched-updates-only mode.
• Example manual refresh flow now separates update check from UI refresh and shows update-check results via SnackBar.
• Example pages are split into dedicated files under example/lib/pages/.
• Updated README and example README for renamed APIs and fetched-only refresh usage.
• Updated AGENTS.md naming rules and applied them across the codebase.
• Updated license copyright holder to BasalBit GmbH.

0.0.3

• BREAKING: package identity is now rerune.
• BREAKING: public import changed to package:rerune/rerune.dart.
• Added canonical CLI command flutter pub run rerune for localization wrapper generation.
• Added standard Flutter localization auto-detect from l10n.yaml and default gen-l10n paths.
• Added --dart-define config fallback (RERUNE_PROJECT_ID, RERUNE_API_KEY, RERUNE_PLATFORM) so rerune.json asset setup is optional.

0.0.2

• BREAKING: removed legacy key-based APIs (OtaLocalizations, OtaLocalizationsDelegate, OtaLocalizationBuilder).
• BREAKING: OtaLocalizationController no longer accepts baseUrl; API host is fixed to https://rerune.io/api.
• Added typed AppLocalizations overlay flow with OtaTypedLocalizationBuilder<T>.
• Added generator entrypoint for producing typed OTA wrappers.

0.0.1

• Initial release of the OTA localization SDK.
• Manifest-based ARB updates with ETag support and local caching.
• Hot-swap localization delegate with Rerune-hosted manifest URLs.