react-narrow 0.1.0 → 0.2.0

package/README.md

@@ -128,6 +128,20 @@ const settingsStore = createNarrowedStoreContext(appStore, (s) => s.settings)
 - Components take a slice and a setter as props, so they work with any store and test with plain values, instead of being wired to one global store by path
 
 
+## Reading the pre-edit value in a recipe
+
+`original` and `current` are re-exported from Mutative, so you don't need to depend on it yourself. Inside a mutating function, `original(draft)` is the value from before the edit and `current(draft)` is a snapshot of the draft so far. They only work on drafts from the same copy of Mutative that `react-narrow` uses, which is why they come from here.
+
+```ts
+import { original } from 'react-narrow'
+
+// Only apply this write if the slice hasn't been replaced since `basis` was read
+setSlice((s) => {
+  if (original(s) !== basis) return
+  s.title = result
+})
+```
+
 ## Narrowing to an item picked at runtime
 
 Give the narrow function a second parameter, and pass it to the Provider:

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export type { SetStore, Narrower } from './store.js';
 export { useNewStore, useNarrowedStore, NarrowList, createContextStore, createNarrowedStoreContext, } from './react.js';
 export type { ContextStore, StoreContext } from './react.js';
+export { original, current } from 'mutative';
+export type { Draft } from 'mutative';

package/dist/index.js

@@ -1 +1,4 @@
 export { useNewStore, useNarrowedStore, NarrowList, createContextStore, createNarrowedStoreContext, } from './react.js';
+// Re-exported so recipes always use the same Mutative copy as the library: `original()` and `current()` only
+// accept drafts created by the copy that made them.
+export { original, current } from 'mutative';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-narrow",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "MIT",
   "repository": {
     "type": "git",