@ersbeth/picoflow 0.2.4 → 1.0.1

package/README.md

@@ -1,150 +1,25 @@
 # Picoflow
 
-**Picoflow** is a lightweight reactive dataflow library that provides fine-grained reactive primitives. It gives you an intuitive API for signals, state, asynchronous resources, streams, derivations, effects, and reactive maps. Instead of using traditional subscriptions, Picoflow uses effects to automatically track reactive dependencies.
+**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.
 
-## Features
-
-- **Reactive Signals:** Manually trigger updates using `$signal.trigger()`.
-- **Reactive State:** Manage state with observables that expose getter/setter APIs.
-- **Asynchronous Resources:** Fetch and update asynchronous data reactively.
-- **Reactive Streams:** Create streams that update over time using an updater function.
-- **Derivations:** Compute derived values from other reactive primitives.
-  - **Automatic Caching:** Derived values are cached and are re-evaluated only when one or more of their dependencies change.
-  - **Lazy Evaluation:** Derivations are evaluated lazily—that is, the computation only runs if and when an effect actually uses the derived value.
-- **Reactive Maps:** Manage collections reactively with granular update notifications.
-- **Effects:** Automatically run side-effect functions when dependencies change.
+> **Upgrading from v0.x?** See the [Upgrade Guide](https://ersbeth-web.gitlab.io/picoflow/guide/advanced/upgrading.html) for migration instructions.
 
 ## Installation
 
-Install via npm:
-
 ```bash
+# npm
 npm install @ersbeth/picoflow
-```
-
-## Usage
-
-In Picoflow, we advise to prefix all reactive primitives and effects with `$` for improved readability. Rather than using a subscribe method, you always create an effect that "watches" a primitive. Below are some examples:
-
-### Creating a Signal
-
-```ts
-import { signal, effect } from 'picoflow';
-
-const $signal = signal();
-
-const $effect = effect((get, watch) => {
-  // Automatically tracks $signal
-  watch($signal);
-  console.log('$signal has been triggered');
-});
-
-// Trigger the signal
-$signal.trigger();
-
-// LOG -> $signal has been triggered
-```
-
-### Creating Reactive State
-
-```ts
-import { state, effect } from 'picoflow';
-
-const $count = state(0);
-
-const $effect = effect((get, watch) => {
-  // Automatically tracks $count
-  console.log('Count changed:', get($count));
-});
-
-// Update the state
-$count.set(42);
-
-// LOG -> $Count changed: 42
-```
-
-### Creating an Asynchronous Resource
-
-```ts
-import { resource, effect } from 'picoflow';
-
-async function fetchData() {
-  const response = await fetch('https://api.example.com/data');
-  return response.json();
-}
-
-const $data = resource(fetchData, {});
-
-// Create an effect to watch for updates
-const $effect = effect((get, watch) => {
-  console.log('Resource updated:', get($data));
-});
-
-// Later, you can trigger a new fetch
-$data.fetch();
-```
-
-### Creating a Reactive Stream
-
-```ts
-import { stream, effect } from 'picoflow';
-
-const $ticker = stream(
-  (set) => {
-    const interval = setInterval(() => set(Date.now()), 1000);
-    // Return a disposer to clear the interval when the stream is disposed.
-    return () => clearInterval(interval);
-  },
-  Date.now()
-);
-
-const $effect = effect((get, watch) => {
-  console.log('Current time:', get($ticker));
-});
-```
-
-### Creating a Derived Value
-
-```ts
-import { state, derivation, effect } from 'picoflow';
-
-const $a = state(10);
-const $b = state(20);
-
-// Create a derived value that sums $a and $b.
-const $sum = derivation((get, watch) => {
-  return get($a) + get($b);
-});
-
-const $effect = effect((get, watch) => {
-  console.log('Sum:', get($sum));
-});
-
-// Update a dependency to see the derivation update.
-$a.set(15);
-```
-
-### Creating a Reactive Map
-
-Reactive maps allow fine-grained tracking of collection updates.
-
-```ts
-import { map, effect } from 'picoflow';
-
-const $map = map({ foo: 'bar' });
 
-const $effect = effect((get, watch) => {
-  console.log('Map updated:', get($map));
-});
+# pnpm
+pnpm add @ersbeth/picoflow
 
-// Update the map to trigger updates
-$map.setAt('baz', 'qux');
-$map.delete('foo');
+# yarn
+yarn add @ersbeth/picoflow
 ```
 
-## API Documentation
+## Documentation
 
-For detailed API documentation, please refer to the [API Reference](./api/doc/index.md).
+For comprehensive guides and API documentation, visit the [official website](https://ersbeth-web.gitlab.io/picoflow/)
 
 ## License
 

package/biome.json

@@ -1,34 +1,34 @@
 {
-    "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
-    "files": {
-        "ignore": [
-            "dist",
-            "node_modules",
-            "doc/.vitepress/dist",
-            "doc/.vitepress/cache"
-        ]
-    },
-    "organizeImports": {
-        "enabled": true
-    },
-    "formatter": {
-        "enabled": true,
-        "indentStyle": "space",
-        "indentWidth": 4,
-        "lineEnding": "lf"
-    },
-    "linter": {
-        "rules": {
-            "suspicious": {
-                "noExplicitAny": "off",
-                "useIsArray": "off"
-            },
-            "complexity": {
-                "noForEach": "off"
-            },
-            "style": {
-                "noNonNullAssertion": "off"
-            }
-        }
-    }
+	"$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
+		}
+	},
+	"javascript": {
+		"formatter": {
+			"quoteStyle": "double"
+		}
+	},
+	"assist": {
+		"enabled": true,
+		"actions": {
+			"source": {
+				"organizeImports": "on"
+			}
+		}
+	}
 }