Merge branch 'release/v5.1.0' into main

Author: DirtyNative

CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [5.1.0] - 2026-02-20
+
+### Added
+
+- New example `example/lib/store_state_based_transactional.dart` demonstrating `StateBasedStore` with `TransactionalRunner` and a REST API adapter.
+- New example `example/lib/store_state_based_local_db.dart` demonstrating `StateBasedStore` with a local key-value database adapter.
+- `InMemoryPersistenceAdapter` in `continuum_store_memory` — a ready-made `AggregatePersistenceAdapter` backed by a plain `Map`, suitable for testing and development.
+- `HivePersistenceAdapter` in `continuum_store_hive` — a ready-made `AggregatePersistenceAdapter` backed by a Hive `Box<String>`, for local persistence.
+- `SembastPersistenceAdapter` in `continuum_store_sembast` — a ready-made `AggregatePersistenceAdapter` backed by a Sembast store, for local persistence.
+
+### Removed
+
+- Removed obsolete hybrid examples from the `example/` package. The
+  following example files and their helper DTOs were removed because the
+  recommended pattern is now demonstrated in
+  `example/lib/store_state_based_transactional.dart`:
+  - `example/lib/hybrid_optimistic_creation.dart`
+  - `example/lib/hybrid_profile_edit.dart`
+  - `example/lib/hybrid_multi_step_form.dart`
+  - `example/lib/hybrid/backend_api.dart`
+  - `example/lib/hybrid/dtos.dart`
+
+
 ## [5.0.0] - 2026-02-19
 
 ### Breaking Changes