nanoeffects 0.19.0 → 0.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "nanoeffects",
-	"version": "0.19.0",
+	"version": "0.20.0",
 	"description": "Cancel stale async work and fix race conditions in event handlers: a typed event bus where every handler is a task with an AbortSignal, plus latest, debounce, throttle, queue, retry, timeout and poll. About 1.4 kB gzip.",
 	"keywords": [
 		"event-bus",
@@ -126,6 +126,10 @@
 			"types": "./dist/react.d.ts",
 			"import": "./dist/react.js"
 		},
+		"./vue": {
+			"types": "./dist/vue.d.ts",
+			"import": "./dist/vue.js"
+		},
 		"./dev": {
 			"production": {
 				"types": "./dist/dev.d.ts",
@@ -167,6 +171,7 @@
 		"@vitejs/plugin-react": "^6.1.2",
 		"archunit": "^2.5.4",
 		"happy-dom": "^21.0.4",
+		"immer": "^10.2.0",
 		"jotai": "^3.0.1",
 		"lefthook": "2.2.1",
 		"lodash": "4.17.21",
@@ -179,9 +184,12 @@
 		"size-limit": "^14.2.0",
 		"tsdown": "0.23.1",
 		"typescript": "7.0.2",
+		"typescript-5": "npm:typescript@^5.9.3",
 		"unplugin-unused": "^0.6.0",
 		"vite": "^8.3.4",
 		"vitest": "5.0.5",
+		"vue": "^3.5.44",
+		"vue-tsc": "^3.3.13",
 		"webpack": "^5.112.0",
 		"zustand": "^5.0.15"
 	},
@@ -208,7 +216,7 @@
 		{
 			"name": "actions (all)",
 			"path": "dist/actions.js",
-			"limit": "2.87 kB"
+			"limit": "3.02 kB"
 		},
 		{
 			"name": "match (plugin)",
@@ -253,6 +261,14 @@
 			],
 			"limit": "1.24 kB"
 		},
+		{
+			"name": "vue",
+			"path": "dist/vue.js",
+			"ignore": [
+				"vue"
+			],
+			"limit": "0.4 kB"
+		},
 		{
 			"name": "dev",
 			"path": "dist/dev.js",
@@ -265,11 +281,15 @@
 		}
 	],
 	"peerDependencies": {
-		"react": ">=18"
+		"react": ">=18",
+		"vue": ">=3.3"
 	},
 	"peerDependenciesMeta": {
 		"react": {
 			"optional": true
+		},
+		"vue": {
+			"optional": true
 		}
 	}
 }

package/skills/nanoeffects/SKILL.md

@@ -20,6 +20,16 @@ A typed event bus where each handler is a task with an `AbortSignal`. Policies (
 - The job is combining or transforming streams of values: keep RxJS.
 - The job is server state caching (stale-while-revalidate, pagination): use a query library.
 
+## Start a new project
+
+Do not write the setup by hand. `npm create nanoeffects@latest my-app -- --template <name>` makes a working Vite project:
+
+- `vanilla`, `react`: JavaScript, one search handler with `debounce` and `latest`.
+- `vanilla-ts`, `react-ts`: the same apps in TypeScript.
+- `domains-ts`: React and TypeScript with the logic split by domain (commands, a job, modules). Pick it for an app with several features.
+
+In an existing project, start from `docs/cancel-stale-requests.md` (races) or `docs/guide.md`.
+
 ## Rules that generated code often gets wrong
 
 - ESM only. No default export, no `require`.
@@ -29,24 +39,8 @@ A typed event bus where each handler is a task with an `AbortSignal`. Policies (
 - Policies wrap a handler: `bus.on("search", latest(async (query, ctx) => { ... }))`.
 - Import each part from its path: `nanoeffects`, `nanoeffects/policies`, `nanoeffects/effects`, `nanoeffects/actions`, `nanoeffects/redux`, `nanoeffects/react`.
 - `bus.emit(command(payload))` returns the command's result. Plain events return nothing.
-
-## Minimal example
-
-```js
-import { createBus } from "nanoeffects";
-import { latest } from "nanoeffects/policies";
-
-const bus = createBus();
-
-bus.on(
-  "search",
-  latest(async (query, { signal }) => {
-    const items = await api.search(query, { signal });
-    bus.emit("results", items);
-  }),
-);
-```
+- The bus keeps no values: an event emitted before a listener exists is lost. `useEventState(event, initial)` (`nanoeffects/react`) is state of one component, not a store. Share a value through a Context provider at the root or a state manager.
 
 ## Where to read more
 
-The package ships `llms.txt` (index of the docs) and `llms-full.txt` (all docs in one file). Start with `docs/cancel-stale-requests.md` for races and `docs/guide.md` for the step-by-step guide.
+The package ships `llms.txt` (index of the docs) and `llms-full.txt` (all docs in one file).