@ersbeth/picoflow 1.1.2 → 2.0.0

package/.vscode/settings.json

@@ -1,5 +1,5 @@
 {
-	"files.associations": {
-		"*.json": "jsonc"
-	}
+    "files.associations": {
+        "*.json": "jsonc"
+    }
 }

package/CHANGELOG.md

@@ -7,6 +7,49 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.0.0] - 2026-01-11
+
+### 🚨 BREAKING CHANGES
+
+This is a major API refinement focusing on consistency, performance, and clarity. **This release is not backward compatible with v1.x.**
+
+**Migration required:** Please see the [Migration Guide](docs/guide/advanced/migration-v2.md) for detailed migration instructions. Most projects can be migrated in 30-60 minutes.
+
+### Changed
+
+- **`effect()` API removed:** The global `effect()` function has been replaced with `subscribe()` and `.subscribe()` methods for better consistency and clarity
+  - Single primitive subscriptions: use `$primitive.subscribe((value) => { ... })`
+  - Multiple dependencies: use `subscribe((t) => ({ ... }), (data) => { ... })`
+- **FlowMap fine-grained tracking simplified:** Replaced three separate signals (`$lastAdded`, `$lastUpdated`, `$lastDeleted`) with a single unified `$lastAction` signal
+  - Actions now use a discriminated union type with `type` field
+  - Action properties renamed for clarity: `value` → `addedValue`, `setValue`, `removedValue`
+  - Added `set` and `clear` action types
+- **FlowArray method renamed:** `setItem()` → `update()` for consistency with FlowMap
+- **Constant initialization:** Constants now always require a function initializer `constant(() => value)`, enforcing lazy evaluation
+- **Improved type naming:** Internal `TrackingContext` is now properly exported as `FlowTracker` interface
+
+### Added
+
+- **`subscribe()` function:** New global function for creating side effects with multiple dependencies
+- **`.subscribe()` method:** Convenient method on primitives for single-value subscriptions
+- **`FlowEffect` interface:** Return type for all subscription operations, providing consistent disposal pattern
+- **Enhanced FlowMap actions:** Added `set` and `clear` action types to `$lastAction` for complete operation tracking
+
+### Removed
+
+- **`effect()` function:** Replaced by `subscribe()` and `.subscribe()` methods
+- **FlowMap separate signals:** `$lastAdded`, `$lastUpdated`, `$lastDeleted` replaced by unified `$lastAction`
+- **FlowArray `setItem()` method:** Renamed to `update()`
+
+### Benefits
+
+- **Clearer API:** Distinction between primitives and side effects (subscriptions) is more explicit
+- **Better performance:** Single `$lastAction` signal reduces overhead in collection tracking
+- **More consistent:** Unified naming across FlowArray and FlowMap operations
+- **Simpler mental model:** `subscribe()` clearly indicates side effects vs pure derivations
+
+---
+
 ## [1.0.0] - 2025-11-29
 
 ### 🚨 BREAKING CHANGES

package/README.md

@@ -2,7 +2,7 @@
 
 **Picoflow** is a lightweight reactive dataflow library that provides fine-grained reactive primitives. It gives you an intuitive API for signals, state, (asynchronous) derivations, effects, and reactive maps/arrays. Picoflow uses an explicit tracking context to automatically track reactive dependencies.
 
-> **Upgrading from v0.x?** See the [Upgrade Guide](https://ersbeth-web.gitlab.io/picoflow/guide/advanced/upgrading.html) for migration instructions.
+> **Upgrading from v1.x?** See the [Upgrade Guide](https://ersbeth-web.gitlab.io/picoflow/guide/advanced/migration-v2.html) for migration instructions.
 
 ## Installation
 
@@ -23,20 +23,4 @@ For comprehensive guides and API documentation, visit the [official website](htt
 
 ## License
 
-This project is licensed under the [MIT License](LICENSE).
-
-## TODO
-
-- [x] implement refresh on derivations
-- [x] add tests for refresh
-- [x] improve tests for array / maps
-- [x] use same API for array and maps
-- [x] use async API for array updates
-- [x] manage unified disposal in collections
-- [ ] fix tests
-- [ ] implement sets
-- [x] implement await nodes
-- [ ] add tests for await nodes
-- [ ] add tests for raw nodes
-- [ ] replace resources by await nodes
-- [ ] think about streams
+This project is licensed under the [MIT License](LICENSE).

package/biome.json

@@ -1,37 +1,47 @@
 {
-	"$schema": "https://biomejs.dev/schemas/2.3.8/schema.json",
-	"vcs": {
-		"enabled": true,
-		"clientKind": "git",
-		"useIgnoreFile": true
-	},
-	"files": {
-		"includes": ["**", "!!**/dist"]
-	},
-	"formatter": {
-		"enabled": true,
-		"indentStyle": "tab"
-	},
-	"linter": {
-		"enabled": true,
-		"rules": {
-			"recommended": true,
-			"complexity": {
-				"noStaticOnlyClass": "off"
-			}
-		}
-	},
-	"javascript": {
-		"formatter": {
-			"quoteStyle": "double"
-		}
-	},
-	"assist": {
-		"enabled": true,
-		"actions": {
-			"source": {
-				"organizeImports": "on"
-			}
-		}
-	}
+    "$schema": "https://biomejs.dev/schemas/2.3.8/schema.json",
+    "vcs": {
+        "enabled": true,
+        "clientKind": "git",
+        "useIgnoreFile": true
+    },
+    "files": {
+        "includes": ["**", "!!**/dist"]
+    },
+    "formatter": {
+        "enabled": true,
+        "indentStyle": "space",
+        "indentWidth": 4,
+        "lineWidth": 120
+    },
+    "linter": {
+        "enabled": true,
+        "rules": {
+            "recommended": true,
+            "complexity": {
+                "noStaticOnlyClass": "off"
+            },
+            "nursery": {
+                "useExhaustiveSwitchCases": "error",
+                "noFloatingPromises": "error",
+                "noMisusedPromises": "error"
+            },
+            "suspicious": {
+                "useAwait": "error"
+            }
+        }
+    },
+    "javascript": {
+        "formatter": {
+            "quoteStyle": "double"
+        }
+    },
+    "assist": {
+        "enabled": true,
+        "actions": {
+            "source": {
+                "organizeImports": "on"
+            }
+        }
+    }
 }