@pumped-fn/lite 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # @pumped-fn/lite
 
+## 1.4.0
+
+### Minor Changes
+
+- bbcada9: feat(lite): add Controller.set() and Controller.update() for direct value mutation
+
+  Adds two new methods to Controller for pushing values directly without re-running the factory:
+
+  - `controller.set(value)` - Replace value directly
+  - `controller.update(fn)` - Transform value using a function
+
+  Both methods:
+
+  - Use the same invalidation queue as `invalidate()`
+  - Run cleanups in LIFO order before applying new value
+  - Transition through `resolving → resolved` states
+  - Notify all subscribed listeners
+
+  This enables patterns like WebSocket updates pushing values directly into atoms without triggering factory re-execution.
+
+  BREAKING CHANGE: `DataStore.get()` now always returns `T | undefined` (Map-like semantics). Use `getOrSet()` to access default values from tags. This aligns DataStore behavior with standard Map semantics where `get()` is purely a lookup operation.
+
+## 1.3.1
+
+### Patch Changes
+
+- 3208cfe: Improve README documentation clarity and reduce size by 19%
+
+  **Enhanced API behavior documentation:**
+
+  - `ctx.cleanup()`: Clarified lifecycle - runs on every invalidation (before re-resolution) and release, LIFO order
+  - `ctx.data`: Clarified lifecycle - persists across invalidations, cleared on release, per-atom isolation
+  - `controller(atom)` as dep: Explained key difference - receives unresolved controller vs auto-resolved value
+  - `ctx.invalidate()`: Explained scheduling behavior - runs after factory completes, not interrupting
+  - `ctrl.get()`: Documented stale reads during resolving state
+  - `scope.flush()`: Added to API Reference (was undocumented)
+
+  **Trimmed content:**
+
+  - Removed duplicate Core Concepts diagram
+  - Condensed Flow section
+  - Condensed Extensions section
+  - Consolidated Lifecycle diagrams
+  - Removed rarely-used Direct Tag Methods section
+
 ## 1.3.0
 
 ### Minor Changes