@nkzw/fate-indexeddb 1.10.1 → 1.10.2

package/README.md

@@ -1311,6 +1311,14 @@ addComment({
 
 The server returns the selected fields, and views that display the post's comment count update automatically.
 
+Use `.with()` before `useActionState` to include selected fields in `state.result`:
+
+```tsx
+const [state, addComment] = useActionState(fate.actions.comment.add.with(CommentView), null);
+```
+
+Pass a view or a raw selection. Chaining `.with()` adds fields to the existing selection, for example `.with(CommentView).with({ post: { commentCount: true } })`.
+
 ### Mutations
 
 Use `fate.mutations` to call a mutation outside a React Action, or when calls should run without waiting for earlier actions to finish:
@@ -2377,7 +2385,7 @@ if (result) {
 }
 ```
 
-Without a selection, entity results expose only identity fields. React clients can also use `fate.actions` with `useActionState`; those action results expose identity fields, while selected fields update the cache for views to read.
+Without a selection, entity results expose only identity fields. For React Actions, use [`.with()`](/docs/guide/actions.md#selecting-a-view-with-actions) to select additional fields.
 
 For mappings without a schema, use `graphqlMutation` from `@nkzw/fate` to declare mutation types manually.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nkzw/fate-indexeddb",
-  "version": "1.10.1",
+  "version": "1.10.2",
   "description": "Optional IndexedDB persistence adapter for fate.",
   "license": "MIT",
   "files": [
@@ -19,7 +19,7 @@
     "idb": "^8.0.4"
   },
   "devDependencies": {
-    "@nkzw/fate": "1.10.1",
+    "@nkzw/fate": "1.10.2",
     "fake-indexeddb": "^6.2.6",
     "vite": "npm:@voidzero-dev/vite-plus-core@1.3.0",
     "vite-plus": "1.3.0"