storion 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -9,6 +9,46 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- `SelectorContext.scoped()` for component-local stores that auto-dispose on unmount
+  ```tsx
+  const { value, setValue } = useStore(({ scoped }) => {
+    const [state, actions, instance] = scoped(formStore);
+    return { value: state.value, setValue: actions.setValue };
+  });
+  ```
+- `async.mixin()` for component-local async state (mutations, form submissions)
+
+  ```tsx
+  // Define mutation - no store needed
+  const submitForm = async.mixin(async (ctx, data: FormData) => {
+    const res = await fetch("/api/submit", {
+      method: "POST",
+      body: JSON.stringify(data),
+      signal: ctx.signal,
+    });
+    return res.json();
+  });
+
+  // Use as mixin - state is component-local, auto-disposed
+  const { status, submit } = useStore(({ mixin }) => {
+    const [state, actions] = mixin(submitForm);
+    return { status: state.status, submit: actions.dispatch };
+  });
+  ```
+
+- `AsyncContext.get()` allows async handlers to access other stores' state
+
+  ```tsx
+  // Access other stores for cross-store mutations
+  const checkout = async.mixin(async (ctx, paymentMethod: string) => {
+    const [user] = ctx.get(userStore);
+    const [cart] = ctx.get(cartStore);
+    return fetch("/api/checkout", {
+      body: JSON.stringify({ userId: user.id, items: cart.items }),
+    });
+  });
+  ```
+
 - `MetaEntry.fields` now supports arrays for applying meta to multiple fields at once
   ```ts
   meta: [notPersisted.for(["password", "token"])];
@@ -27,11 +67,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   });
   ```
 
+### Removed
+
+- **BREAKING**: `useLocalStore` hook removed - use `scoped()` in `useStore` selector instead
+
+  ```tsx
+  // Before
+  const [state, actions] = useLocalStore(formStore);
+
+  // After
+  const { state, actions } = useStore(({ scoped }) => {
+    const [s, a] = scoped(formStore);
+    return { state: s, actions: a };
+  });
+  ```
+
+- **BREAKING**: `SelectorContext.create()` removed - creates uncontrolled instances without disposal tracking. Use `get()` for cached services or `scoped()` for component-local stores instead.
+
 ### Changed
 
-- **BREAKING**: `persistMiddleware` API refactored for better encapsulation
+- **BREAKING**: `persist` API refactored for better encapsulation (renamed from `persistMiddleware`)
 
   - New `handler` option replaces `load`/`save` callbacks
+  - `persistMiddleware` is now deprecated, use `persist` instead
   - Handler receives `PersistContext` (extends `StoreMiddlewareContext` with `store` instance)
   - Handler returns `{ load, save }` object (can be sync or async)
   - `onError` signature changed to `(error, operation)` where operation is `"init" | "load" | "save"`
@@ -46,7 +104,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   });
 
   // After (new API)
-  persistMiddleware({
+  persist({
     handler: (ctx) => {
       const key = `app:${ctx.displayName}`;
       return {
@@ -57,7 +115,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   });
 
   // Async handler (IndexedDB)
-  persistMiddleware({
+  persist({
     handler: async (ctx) => {
       const db = await openDB("app-db");
       return {
@@ -75,7 +133,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 - **Persist Module** (`storion/persist`)
-  - `persistMiddleware(options)` for automatic state persistence
+  - `persist(options)` for automatic state persistence
   - `notPersisted` meta for excluding stores or fields from persistence
   - Supports sync and async `load`/`save` handlers
   - `force` option to override dirty state during hydration