@vielzeug/ripple 1.2.2 → 1.3.0

package/README.md

@@ -9,7 +9,7 @@
 
 **Package:** `@vielzeug/ripple`  ·  **Category:** State
 
-**Key exports:** `signal`, `computed`, `effect`, `effectAsync`, `resource`, `watch`, `batch`, `store`, `storeWithHistory`, `untrack`, `scope`, `onCleanup`, `readonly`, `isSignal`, `isComputed`, `isStore`
+**Key exports:** `signal`, `computed`, `effect`, `effectAsync`, `resource`, `watch`, `batch`, `store`, `untrack`, `scope`, `onCleanup`, `readonly`, `isSignal`, `isComputed`, `isStore`
 
 **When to use:** Fine-grained reactivity without a framework. Powers Ore templates. Works in any TS/JS environment including Node, Deno, and SSR.
 
@@ -36,6 +36,7 @@ yarn add @vielzeug/ripple
 | --------------------------- | ------------------------------------------------------------------------ |
 | `@vielzeug/ripple`          | Core primitives and types                                                |
 | `@vielzeug/ripple/devtools` | `installDevTools`, `debugEffect` — dev-only, tree-shaken from production |
+| `@vielzeug/ripple/history`  | `storeWithHistory` — snapshot-based store undo/redo, tree-shaken unless imported |
 | `@vielzeug/ripple/ssr`      | SSR tracking isolation helpers (`setTrackingProvider`, `createAsyncProvider`, `withProvider`, `runWithProvider`). Node.js only — do not import in browser builds. |
 
 ## Quick Start
@@ -79,8 +80,8 @@ const userState = resource(async (signal) => {
 });
 // userState.value → { status: 'loading' | 'ready' | 'error', data, error }
 
-// Store with undo/redo history
-import { storeWithHistory } from '@vielzeug/ripple';
+// Store with undo/redo history — dedicated sub-path, tree-shaken unless imported
+import { storeWithHistory } from '@vielzeug/ripple/history';
 
 const editor = storeWithHistory({ text: '' }, { maxHistory: 50 });
 editor.patch({ text: 'hello' });

package/dist/async-computed.cjs

@@ -1,2 +1,2 @@
-const e=require("./tracking.cjs"),t=require("./symbols.cjs"),n=require("./effect.cjs"),r=require("./signal.cjs");var i=(i,a)=>{let o=a?.name,s=r.signal({data:a?.initialValue,status:`loading`},o?{name:o}:void 0),c=r.signal(0),l=null,u=!1,d=n.effect(()=>{c.value,l?.abort(),l=new AbortController;let{signal:e}=l,t=s.peek(),n=`data`in t?t.data:void 0;s.value={data:n,status:`loading`},(async()=>{try{let t=await i(e);!e.aborted&&!u&&(s.value={data:t,status:`ready`})}catch(t){!e.aborted&&!u&&(s.value={data:n,error:t,status:`error`})}})()},o?{name:o}:void 0),f=()=>{u||(c.value=c.peek()+1)},p=()=>{u||(u=!0,l?.abort(),d.dispose(),s.dispose(),c.dispose())};return e.autoRegisterDisposal(p),{dispose:p,get disposed(){return u},[t.IS_COMPUTED]:!0,[t.IS_SIGNAL]:!0,get name(){return s.name},peek:()=>s.peek(),refresh:f,subscribe:e=>s.subscribe(e),[Symbol.dispose]:p,get value(){return s.value}}};exports.resource=i;
+const e=require("./devtools-hook.cjs"),t=require("./symbols.cjs"),n=require("./tracking.cjs"),r=require("./effect.cjs"),i=require("./signal.cjs");var a=(a,o)=>{let s=o?.name,c=i.signal({data:o?.initialValue,status:`loading`},s?{name:s}:void 0),l=i.signal(0),u=null,d=!1,f=r.effect(()=>{l.value,e.getDevToolsHook()?.compute?.({name:s}),u?.abort(),u=new AbortController;let{signal:t}=u,n=c.peek(),r=`data`in n?n.data:void 0;c.value={data:r,status:`loading`},(async()=>{try{let e=await a(t);!t.aborted&&!d&&(c.value={data:e,status:`ready`})}catch(e){!t.aborted&&!d&&(c.value={data:r,error:e,status:`error`})}})()},{name:s,[t.SUPPRESS_RUN_EVENT]:!0}),p=()=>{d||(l.value=l.peek()+1)},m=()=>{d||(d=!0,u?.abort(),f.dispose(),c.dispose(),l.dispose())};return n.autoRegisterDisposal(m),{dispose:m,get disposed(){return d},[t.IS_COMPUTED]:!0,[t.IS_SIGNAL]:!0,get name(){return c.name},peek:()=>c.peek(),refresh:p,subscribe:e=>c.subscribe(e),[Symbol.dispose]:m,get value(){return c.value}}};exports.resource=a;
 //# sourceMappingURL=async-computed.cjs.map

package/dist/async-computed.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"async-computed.cjs","names":[],"sources":["../src/async-computed.ts"],"sourcesContent":["import type { Resource, ResourceOptions, ResourceState } from './types';\n\nimport { effect } from './effect';\nimport { signal } from './signal';\nimport { IS_COMPUTED, IS_SIGNAL } from './symbols';\nimport { autoRegisterDisposal } from './tracking';\n\n/**\n * Creates a reactive async resource that emits a `ResourceState<T>` discriminated union.\n *\n * Dependencies are tracked synchronously in the factory (before the first `await`).\n * The factory receives an `AbortSignal` that fires when dependencies change or\n * the resource is disposed, cancelling any in-flight work.\n *\n * If `resource()` is created inside an active `effect()` or `scope.run()` context,\n * it is automatically registered for cleanup and disposed with that context —\n * matching `computed()`'s auto-disposal behavior.\n *\n * Call `refresh()` to force the factory to re-run immediately, even if no tracked\n * dependency changed — useful for manual \"retry\"/\"refetch\" actions.\n *\n * @example\n * ```ts\n * const userId = signal('u1');\n * const user = resource(async (signal) => {\n *   const id = userId.value; // tracked dep — re-runs when userId changes\n *   return fetchUser(id, { signal });\n * });\n *\n * effect(() => {\n *   const s = user.value;\n *   if (s.status === 'loading') return showSpinner();\n *   if (s.status === 'error')   return showError(s.error);\n *   renderUser(s.data);\n * });\n *\n * user.refresh(); // force a re-fetch without changing userId\n * user.dispose();\n * ```\n */\nexport const resource = <T>(\n  factory: (abortSignal: AbortSignal) => Promise<T>,\n  options?: ResourceOptions<T>,\n): Resource<T> => {\n  const name = options?.name;\n  const state = signal<ResourceState<T>>(\n    { data: options?.initialValue, status: 'loading' },\n    name ? { name } : undefined,\n  );\n  // Internal-only trigger — never exposed. Read (but never written to a meaningful\n  // value) inside the effect purely so it becomes a tracked dep; refresh() bumps it\n  // to force a re-run without requiring a real dependency to change.\n  const epoch = signal(0);\n\n  let controller: AbortController | null = null;\n  let disposed = false;\n\n  const stop = effect(\n    () => {\n      void epoch.value;\n\n      controller?.abort();\n      controller = new AbortController();\n\n      const { signal: abortSignal } = controller;\n\n      const current = state.peek();\n      const prevData = 'data' in current ? current.data : undefined;\n\n      state.value = { data: prevData, status: 'loading' };\n\n      void (async () => {\n        try {\n          const result = await factory(abortSignal);\n\n          if (!abortSignal.aborted && !disposed) {\n            state.value = { data: result, status: 'ready' };\n          }\n        } catch (err) {\n          if (!abortSignal.aborted && !disposed) {\n            state.value = { data: prevData, error: err, status: 'error' };\n          }\n        }\n      })();\n    },\n    name ? { name } : undefined,\n  );\n\n  const refresh = (): void => {\n    if (disposed) return;\n\n    epoch.value = epoch.peek() + 1;\n  };\n\n  const dispose = (): void => {\n    if (disposed) return;\n\n    disposed = true;\n    controller?.abort();\n    stop.dispose();\n    state.dispose();\n    epoch.dispose();\n  };\n\n  autoRegisterDisposal(dispose);\n\n  return {\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    [IS_COMPUTED]: true as const,\n    [IS_SIGNAL]: true as const,\n    get name() {\n      return state.name;\n    },\n    peek: () => state.peek(),\n    refresh,\n    subscribe: (listener: () => void) => state.subscribe(listener),\n    [Symbol.dispose]: dispose,\n    get value() {\n      return state.value;\n    },\n  } as Resource<T>;\n};\n"],"mappings":"iHAwCA,IAAa,GACX,EACA,IACgB,CAChB,IAAM,EAAO,GAAS,KAChB,EAAQ,EAAA,OACZ,CAAE,KAAM,GAAS,aAAc,OAAQ,SAAU,EACjD,EAAO,CAAE,MAAK,EAAI,IAAA,EACpB,EAIM,EAAQ,EAAA,OAAO,CAAC,EAElB,EAAqC,KACrC,EAAW,GAET,EAAO,EAAA,WACL,CACJ,EAAW,MAEX,GAAY,MAAM,EAClB,EAAa,IAAI,gBAEjB,GAAM,CAAE,OAAQ,GAAgB,EAE1B,EAAU,EAAM,KAAK,EACrB,EAAW,SAAU,EAAU,EAAQ,KAAO,IAAA,GAEpD,EAAM,MAAQ,CAAE,KAAM,EAAU,OAAQ,SAAU,GAE5C,SAAY,CAChB,GAAI,CACF,IAAM,EAAS,MAAM,EAAQ,CAAW,EAEpC,CAAC,EAAY,SAAW,CAAC,IAC3B,EAAM,MAAQ,CAAE,KAAM,EAAQ,OAAQ,OAAQ,EAElD,OAAS,EAAK,CACR,CAAC,EAAY,SAAW,CAAC,IAC3B,EAAM,MAAQ,CAAE,KAAM,EAAU,MAAO,EAAK,OAAQ,OAAQ,EAEhE,CACF,EAAA,CAAG,CACL,EACA,EAAO,CAAE,MAAK,EAAI,IAAA,EACpB,EAEM,MAAsB,CACtB,IAEJ,EAAM,MAAQ,EAAM,KAAK,EAAI,EAC/B,EAEM,MAAsB,CACtB,IAEJ,EAAW,GACX,GAAY,MAAM,EAClB,EAAK,QAAQ,EACb,EAAM,QAAQ,EACd,EAAM,QAAQ,EAChB,EAIA,OAFA,EAAA,qBAAqB,CAAO,EAErB,CACL,UACA,IAAI,UAAW,CACb,OAAO,CACT,GACC,EAAA,aAAc,IACd,EAAA,WAAY,GACb,IAAI,MAAO,CACT,OAAO,EAAM,IACf,EACA,SAAY,EAAM,KAAK,EACvB,UACA,UAAY,GAAyB,EAAM,UAAU,CAAQ,GAC5D,OAAO,SAAU,EAClB,IAAI,OAAQ,CACV,OAAO,EAAM,KACf,CACF,CACF"}
+{"version":3,"file":"async-computed.cjs","names":[],"sources":["../src/async-computed.ts"],"sourcesContent":["import type { Resource, ResourceOptions, ResourceState } from './types';\n\nimport { getDevToolsHook } from './devtools-hook';\nimport { effect } from './effect';\nimport { signal } from './signal';\nimport { IS_COMPUTED, IS_SIGNAL, SUPPRESS_RUN_EVENT } from './symbols';\nimport { autoRegisterDisposal } from './tracking';\n\n/**\n * Creates a reactive async resource that emits a `ResourceState<T>` discriminated union.\n *\n * Dependencies are tracked synchronously in the factory (before the first `await`).\n * The factory receives an `AbortSignal` that fires when dependencies change or\n * the resource is disposed, cancelling any in-flight work.\n *\n * If `resource()` is created inside an active `effect()` or `scope.run()` context,\n * it is automatically registered for cleanup and disposed with that context —\n * matching `computed()`'s auto-disposal behavior.\n *\n * Call `refresh()` to force the factory to re-run immediately, even if no tracked\n * dependency changed — useful for manual \"retry\"/\"refetch\" actions.\n *\n * @example\n * ```ts\n * const userId = signal('u1');\n * const user = resource(async (signal) => {\n *   const id = userId.value; // tracked dep — re-runs when userId changes\n *   return fetchUser(id, { signal });\n * });\n *\n * effect(() => {\n *   const s = user.value;\n *   if (s.status === 'loading') return showSpinner();\n *   if (s.status === 'error')   return showError(s.error);\n *   renderUser(s.data);\n * });\n *\n * user.refresh(); // force a re-fetch without changing userId\n * user.dispose();\n * ```\n */\nexport const resource = <T>(\n  factory: (abortSignal: AbortSignal) => Promise<T>,\n  options?: ResourceOptions<T>,\n): Resource<T> => {\n  const name = options?.name;\n  const state = signal<ResourceState<T>>(\n    { data: options?.initialValue, status: 'loading' },\n    name ? { name } : undefined,\n  );\n  // Internal-only trigger — never exposed. Read (but never written to a meaningful\n  // value) inside the effect purely so it becomes a tracked dep; refresh() bumps it\n  // to force a re-run without requiring a real dependency to change.\n  const epoch = signal(0);\n\n  let controller: AbortController | null = null;\n  let disposed = false;\n\n  // Built unannotated and passed by reference (not as an inline literal) so TypeScript\n  // checks it structurally against EffectOptions instead of excess-property-checking\n  // the SUPPRESS_RUN_EVENT symbol key that isn't part of the public type.\n  const internalEffectOptions = { name, [SUPPRESS_RUN_EVENT]: true };\n  const stop = effect(() => {\n    void epoch.value;\n\n    // A resource is a derived value like computed() — emit the same 'compute' event\n    // computed.ts fires before recomputing, so DevTools sees a resource re-run as a\n    // derived-value recompute. SUPPRESS_RUN_EVENT below stops the internal effect from\n    // also firing its own 'run' for the same re-run — one signal per re-run, not two.\n    getDevToolsHook()?.compute?.({ name });\n\n    controller?.abort();\n    controller = new AbortController();\n\n    const { signal: abortSignal } = controller;\n\n    const current = state.peek();\n    const prevData = 'data' in current ? current.data : undefined;\n\n    state.value = { data: prevData, status: 'loading' };\n\n    void (async () => {\n      try {\n        const result = await factory(abortSignal);\n\n        if (!abortSignal.aborted && !disposed) {\n          state.value = { data: result, status: 'ready' };\n        }\n      } catch (err) {\n        if (!abortSignal.aborted && !disposed) {\n          state.value = { data: prevData, error: err, status: 'error' };\n        }\n      }\n    })();\n  }, internalEffectOptions);\n\n  const refresh = (): void => {\n    if (disposed) return;\n\n    epoch.value = epoch.peek() + 1;\n  };\n\n  const dispose = (): void => {\n    if (disposed) return;\n\n    disposed = true;\n    controller?.abort();\n    stop.dispose();\n    state.dispose();\n    epoch.dispose();\n  };\n\n  autoRegisterDisposal(dispose);\n\n  // Built unannotated (the brand symbols aren't part of Resource<T>, and annotating the\n  // literal directly would trip excess-property checking on it) then assigned to a\n  // Resource<T>-typed binding — a structural check, not a cast, so a future member added\n  // to Computed<T>/Resource<T> fails this assignment at compile time instead of silently\n  // going missing.\n  const impl = {\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    [IS_COMPUTED]: true as const,\n    [IS_SIGNAL]: true as const,\n    get name() {\n      return state.name;\n    },\n    peek: () => state.peek(),\n    refresh,\n    subscribe: (listener: () => void) => state.subscribe(listener),\n    [Symbol.dispose]: dispose,\n    get value() {\n      return state.value;\n    },\n  };\n  const handle: Resource<T> = impl;\n\n  return handle;\n};\n"],"mappings":"kJAyCA,IAAa,GACX,EACA,IACgB,CAChB,IAAM,EAAO,GAAS,KAChB,EAAQ,EAAA,OACZ,CAAE,KAAM,GAAS,aAAc,OAAQ,SAAU,EACjD,EAAO,CAAE,MAAK,EAAI,IAAA,EACpB,EAIM,EAAQ,EAAA,OAAO,CAAC,EAElB,EAAqC,KACrC,EAAW,GAMT,EAAO,EAAA,WAAa,CACxB,EAAW,MAMX,EAAA,gBAAgB,CAAC,EAAE,UAAU,CAAE,MAAK,CAAC,EAErC,GAAY,MAAM,EAClB,EAAa,IAAI,gBAEjB,GAAM,CAAE,OAAQ,GAAgB,EAE1B,EAAU,EAAM,KAAK,EACrB,EAAW,SAAU,EAAU,EAAQ,KAAO,IAAA,GAEpD,EAAM,MAAQ,CAAE,KAAM,EAAU,OAAQ,SAAU,GAE5C,SAAY,CAChB,GAAI,CACF,IAAM,EAAS,MAAM,EAAQ,CAAW,EAEpC,CAAC,EAAY,SAAW,CAAC,IAC3B,EAAM,MAAQ,CAAE,KAAM,EAAQ,OAAQ,OAAQ,EAElD,OAAS,EAAK,CACR,CAAC,EAAY,SAAW,CAAC,IAC3B,EAAM,MAAQ,CAAE,KAAM,EAAU,MAAO,EAAK,OAAQ,OAAQ,EAEhE,CACF,EAAA,CAAG,CACL,EAAG,CAjC6B,QAAO,EAAA,oBAAqB,EAiCzD,CAAqB,EAElB,MAAsB,CACtB,IAEJ,EAAM,MAAQ,EAAM,KAAK,EAAI,EAC/B,EAEM,MAAsB,CACtB,IAEJ,EAAW,GACX,GAAY,MAAM,EAClB,EAAK,QAAQ,EACb,EAAM,QAAQ,EACd,EAAM,QAAQ,EAChB,EA6BA,OA3BA,EAAA,qBAAqB,CAAO,EA2BrB,CAnBL,UACA,IAAI,UAAW,CACb,OAAO,CACT,GACC,EAAA,aAAc,IACd,EAAA,WAAY,GACb,IAAI,MAAO,CACT,OAAO,EAAM,IACf,EACA,SAAY,EAAM,KAAK,EACvB,UACA,UAAY,GAAyB,EAAM,UAAU,CAAQ,GAC5D,OAAO,SAAU,EAClB,IAAI,OAAQ,CACV,OAAO,EAAM,KACf,CAIK,CACT"}

package/dist/async-computed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"async-computed.d.ts","sourceRoot":"","sources":["../src/async-computed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAiB,MAAM,SAAS,CAAC;AAOxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,SAAS,CAAC,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACjD,UAAU,eAAe,CAAC,CAAC,CAAC,KAC3B,QAAQ,CAAC,CAAC,CAiFZ,CAAC"}
+{"version":3,"file":"async-computed.d.ts","sourceRoot":"","sources":["../src/async-computed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAiB,MAAM,SAAS,CAAC;AAQxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,SAAS,CAAC,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACjD,UAAU,eAAe,CAAC,CAAC,CAAC,KAC3B,QAAQ,CAAC,CAAC,CAgGZ,CAAC"}

package/dist/async-computed.js

@@ -1,58 +1,62 @@
-import { autoRegisterDisposal as e } from "./tracking.js";
-import { IS_COMPUTED as t, IS_SIGNAL as n } from "./symbols.js";
-import { effect as r } from "./effect.js";
-import { signal as i } from "./signal.js";
+import { getDevToolsHook as e } from "./devtools-hook.js";
+import { IS_COMPUTED as t, IS_SIGNAL as n, SUPPRESS_RUN_EVENT as r } from "./symbols.js";
+import { autoRegisterDisposal as i } from "./tracking.js";
+import { effect as a } from "./effect.js";
+import { signal as o } from "./signal.js";
 //#region src/async-computed.ts
-var a = (a, o) => {
-	let s = o?.name, c = i({
-		data: o?.initialValue,
+var s = (s, c) => {
+	let l = c?.name, u = o({
+		data: c?.initialValue,
 		status: "loading"
-	}, s ? { name: s } : void 0), l = i(0), u = null, d = !1, f = r(() => {
-		l.value, u?.abort(), u = new AbortController();
-		let { signal: e } = u, t = c.peek(), n = "data" in t ? t.data : void 0;
-		c.value = {
-			data: n,
+	}, l ? { name: l } : void 0), d = o(0), f = null, p = !1, m = a(() => {
+		d.value, e()?.compute?.({ name: l }), f?.abort(), f = new AbortController();
+		let { signal: t } = f, n = u.peek(), r = "data" in n ? n.data : void 0;
+		u.value = {
+			data: r,
 			status: "loading"
 		}, (async () => {
 			try {
-				let t = await a(e);
-				!e.aborted && !d && (c.value = {
-					data: t,
+				let e = await s(t);
+				!t.aborted && !p && (u.value = {
+					data: e,
 					status: "ready"
 				});
-			} catch (t) {
-				!e.aborted && !d && (c.value = {
-					data: n,
-					error: t,
+			} catch (e) {
+				!t.aborted && !p && (u.value = {
+					data: r,
+					error: e,
 					status: "error"
 				});
 			}
 		})();
-	}, s ? { name: s } : void 0), p = () => {
-		d || (l.value = l.peek() + 1);
-	}, m = () => {
-		d || (d = !0, u?.abort(), f.dispose(), c.dispose(), l.dispose());
+	}, {
+		name: l,
+		[r]: !0
+	}), h = () => {
+		p || (d.value = d.peek() + 1);
+	}, g = () => {
+		p || (p = !0, f?.abort(), m.dispose(), u.dispose(), d.dispose());
 	};
-	return e(m), {
-		dispose: m,
+	return i(g), {
+		dispose: g,
 		get disposed() {
-			return d;
+			return p;
 		},
 		[t]: !0,
 		[n]: !0,
 		get name() {
-			return c.name;
+			return u.name;
 		},
-		peek: () => c.peek(),
-		refresh: p,
-		subscribe: (e) => c.subscribe(e),
-		[Symbol.dispose]: m,
+		peek: () => u.peek(),
+		refresh: h,
+		subscribe: (e) => u.subscribe(e),
+		[Symbol.dispose]: g,
 		get value() {
-			return c.value;
+			return u.value;
 		}
 	};
 };
 //#endregion
-export { a as resource };
+export { s as resource };
 
 //# sourceMappingURL=async-computed.js.map

package/dist/async-computed.js.map

@@ -1 +1 @@
-{"version":3,"file":"async-computed.js","names":[],"sources":["../src/async-computed.ts"],"sourcesContent":["import type { Resource, ResourceOptions, ResourceState } from './types';\n\nimport { effect } from './effect';\nimport { signal } from './signal';\nimport { IS_COMPUTED, IS_SIGNAL } from './symbols';\nimport { autoRegisterDisposal } from './tracking';\n\n/**\n * Creates a reactive async resource that emits a `ResourceState<T>` discriminated union.\n *\n * Dependencies are tracked synchronously in the factory (before the first `await`).\n * The factory receives an `AbortSignal` that fires when dependencies change or\n * the resource is disposed, cancelling any in-flight work.\n *\n * If `resource()` is created inside an active `effect()` or `scope.run()` context,\n * it is automatically registered for cleanup and disposed with that context —\n * matching `computed()`'s auto-disposal behavior.\n *\n * Call `refresh()` to force the factory to re-run immediately, even if no tracked\n * dependency changed — useful for manual \"retry\"/\"refetch\" actions.\n *\n * @example\n * ```ts\n * const userId = signal('u1');\n * const user = resource(async (signal) => {\n *   const id = userId.value; // tracked dep — re-runs when userId changes\n *   return fetchUser(id, { signal });\n * });\n *\n * effect(() => {\n *   const s = user.value;\n *   if (s.status === 'loading') return showSpinner();\n *   if (s.status === 'error')   return showError(s.error);\n *   renderUser(s.data);\n * });\n *\n * user.refresh(); // force a re-fetch without changing userId\n * user.dispose();\n * ```\n */\nexport const resource = <T>(\n  factory: (abortSignal: AbortSignal) => Promise<T>,\n  options?: ResourceOptions<T>,\n): Resource<T> => {\n  const name = options?.name;\n  const state = signal<ResourceState<T>>(\n    { data: options?.initialValue, status: 'loading' },\n    name ? { name } : undefined,\n  );\n  // Internal-only trigger — never exposed. Read (but never written to a meaningful\n  // value) inside the effect purely so it becomes a tracked dep; refresh() bumps it\n  // to force a re-run without requiring a real dependency to change.\n  const epoch = signal(0);\n\n  let controller: AbortController | null = null;\n  let disposed = false;\n\n  const stop = effect(\n    () => {\n      void epoch.value;\n\n      controller?.abort();\n      controller = new AbortController();\n\n      const { signal: abortSignal } = controller;\n\n      const current = state.peek();\n      const prevData = 'data' in current ? current.data : undefined;\n\n      state.value = { data: prevData, status: 'loading' };\n\n      void (async () => {\n        try {\n          const result = await factory(abortSignal);\n\n          if (!abortSignal.aborted && !disposed) {\n            state.value = { data: result, status: 'ready' };\n          }\n        } catch (err) {\n          if (!abortSignal.aborted && !disposed) {\n            state.value = { data: prevData, error: err, status: 'error' };\n          }\n        }\n      })();\n    },\n    name ? { name } : undefined,\n  );\n\n  const refresh = (): void => {\n    if (disposed) return;\n\n    epoch.value = epoch.peek() + 1;\n  };\n\n  const dispose = (): void => {\n    if (disposed) return;\n\n    disposed = true;\n    controller?.abort();\n    stop.dispose();\n    state.dispose();\n    epoch.dispose();\n  };\n\n  autoRegisterDisposal(dispose);\n\n  return {\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    [IS_COMPUTED]: true as const,\n    [IS_SIGNAL]: true as const,\n    get name() {\n      return state.name;\n    },\n    peek: () => state.peek(),\n    refresh,\n    subscribe: (listener: () => void) => state.subscribe(listener),\n    [Symbol.dispose]: dispose,\n    get value() {\n      return state.value;\n    },\n  } as Resource<T>;\n};\n"],"mappings":";;;;;AAwCA,IAAa,KACX,GACA,MACgB;CAChB,IAAM,IAAO,GAAS,MAChB,IAAQ,EACZ;EAAE,MAAM,GAAS;EAAc,QAAQ;CAAU,GACjD,IAAO,EAAE,QAAK,IAAI,KAAA,CACpB,GAIM,IAAQ,EAAO,CAAC,GAElB,IAAqC,MACrC,IAAW,IAET,IAAO,QACL;EAIJ,AAHA,EAAW,OAEX,GAAY,MAAM,GAClB,IAAa,IAAI,gBAAgB;EAEjC,IAAM,EAAE,QAAQ,MAAgB,GAE1B,IAAU,EAAM,KAAK,GACrB,IAAW,UAAU,IAAU,EAAQ,OAAO,KAAA;EAIpD,AAFA,EAAM,QAAQ;GAAE,MAAM;GAAU,QAAQ;EAAU,IAE5C,YAAY;GAChB,IAAI;IACF,IAAM,IAAS,MAAM,EAAQ,CAAW;IAExC,AAAI,CAAC,EAAY,WAAW,CAAC,MAC3B,EAAM,QAAQ;KAAE,MAAM;KAAQ,QAAQ;IAAQ;GAElD,SAAS,GAAK;IACZ,AAAI,CAAC,EAAY,WAAW,CAAC,MAC3B,EAAM,QAAQ;KAAE,MAAM;KAAU,OAAO;KAAK,QAAQ;IAAQ;GAEhE;EACF,EAAA,CAAG;CACL,GACA,IAAO,EAAE,QAAK,IAAI,KAAA,CACpB,GAEM,UAAsB;EACtB,MAEJ,EAAM,QAAQ,EAAM,KAAK,IAAI;CAC/B,GAEM,UAAsB;EACtB,MAEJ,IAAW,IACX,GAAY,MAAM,GAClB,EAAK,QAAQ,GACb,EAAM,QAAQ,GACd,EAAM,QAAQ;CAChB;CAIA,OAFA,EAAqB,CAAO,GAErB;EACL;EACA,IAAI,WAAW;GACb,OAAO;EACT;GACC,IAAc;GACd,IAAY;EACb,IAAI,OAAO;GACT,OAAO,EAAM;EACf;EACA,YAAY,EAAM,KAAK;EACvB;EACA,YAAY,MAAyB,EAAM,UAAU,CAAQ;GAC5D,OAAO,UAAU;EAClB,IAAI,QAAQ;GACV,OAAO,EAAM;EACf;CACF;AACF"}
+{"version":3,"file":"async-computed.js","names":[],"sources":["../src/async-computed.ts"],"sourcesContent":["import type { Resource, ResourceOptions, ResourceState } from './types';\n\nimport { getDevToolsHook } from './devtools-hook';\nimport { effect } from './effect';\nimport { signal } from './signal';\nimport { IS_COMPUTED, IS_SIGNAL, SUPPRESS_RUN_EVENT } from './symbols';\nimport { autoRegisterDisposal } from './tracking';\n\n/**\n * Creates a reactive async resource that emits a `ResourceState<T>` discriminated union.\n *\n * Dependencies are tracked synchronously in the factory (before the first `await`).\n * The factory receives an `AbortSignal` that fires when dependencies change or\n * the resource is disposed, cancelling any in-flight work.\n *\n * If `resource()` is created inside an active `effect()` or `scope.run()` context,\n * it is automatically registered for cleanup and disposed with that context —\n * matching `computed()`'s auto-disposal behavior.\n *\n * Call `refresh()` to force the factory to re-run immediately, even if no tracked\n * dependency changed — useful for manual \"retry\"/\"refetch\" actions.\n *\n * @example\n * ```ts\n * const userId = signal('u1');\n * const user = resource(async (signal) => {\n *   const id = userId.value; // tracked dep — re-runs when userId changes\n *   return fetchUser(id, { signal });\n * });\n *\n * effect(() => {\n *   const s = user.value;\n *   if (s.status === 'loading') return showSpinner();\n *   if (s.status === 'error')   return showError(s.error);\n *   renderUser(s.data);\n * });\n *\n * user.refresh(); // force a re-fetch without changing userId\n * user.dispose();\n * ```\n */\nexport const resource = <T>(\n  factory: (abortSignal: AbortSignal) => Promise<T>,\n  options?: ResourceOptions<T>,\n): Resource<T> => {\n  const name = options?.name;\n  const state = signal<ResourceState<T>>(\n    { data: options?.initialValue, status: 'loading' },\n    name ? { name } : undefined,\n  );\n  // Internal-only trigger — never exposed. Read (but never written to a meaningful\n  // value) inside the effect purely so it becomes a tracked dep; refresh() bumps it\n  // to force a re-run without requiring a real dependency to change.\n  const epoch = signal(0);\n\n  let controller: AbortController | null = null;\n  let disposed = false;\n\n  // Built unannotated and passed by reference (not as an inline literal) so TypeScript\n  // checks it structurally against EffectOptions instead of excess-property-checking\n  // the SUPPRESS_RUN_EVENT symbol key that isn't part of the public type.\n  const internalEffectOptions = { name, [SUPPRESS_RUN_EVENT]: true };\n  const stop = effect(() => {\n    void epoch.value;\n\n    // A resource is a derived value like computed() — emit the same 'compute' event\n    // computed.ts fires before recomputing, so DevTools sees a resource re-run as a\n    // derived-value recompute. SUPPRESS_RUN_EVENT below stops the internal effect from\n    // also firing its own 'run' for the same re-run — one signal per re-run, not two.\n    getDevToolsHook()?.compute?.({ name });\n\n    controller?.abort();\n    controller = new AbortController();\n\n    const { signal: abortSignal } = controller;\n\n    const current = state.peek();\n    const prevData = 'data' in current ? current.data : undefined;\n\n    state.value = { data: prevData, status: 'loading' };\n\n    void (async () => {\n      try {\n        const result = await factory(abortSignal);\n\n        if (!abortSignal.aborted && !disposed) {\n          state.value = { data: result, status: 'ready' };\n        }\n      } catch (err) {\n        if (!abortSignal.aborted && !disposed) {\n          state.value = { data: prevData, error: err, status: 'error' };\n        }\n      }\n    })();\n  }, internalEffectOptions);\n\n  const refresh = (): void => {\n    if (disposed) return;\n\n    epoch.value = epoch.peek() + 1;\n  };\n\n  const dispose = (): void => {\n    if (disposed) return;\n\n    disposed = true;\n    controller?.abort();\n    stop.dispose();\n    state.dispose();\n    epoch.dispose();\n  };\n\n  autoRegisterDisposal(dispose);\n\n  // Built unannotated (the brand symbols aren't part of Resource<T>, and annotating the\n  // literal directly would trip excess-property checking on it) then assigned to a\n  // Resource<T>-typed binding — a structural check, not a cast, so a future member added\n  // to Computed<T>/Resource<T> fails this assignment at compile time instead of silently\n  // going missing.\n  const impl = {\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    [IS_COMPUTED]: true as const,\n    [IS_SIGNAL]: true as const,\n    get name() {\n      return state.name;\n    },\n    peek: () => state.peek(),\n    refresh,\n    subscribe: (listener: () => void) => state.subscribe(listener),\n    [Symbol.dispose]: dispose,\n    get value() {\n      return state.value;\n    },\n  };\n  const handle: Resource<T> = impl;\n\n  return handle;\n};\n"],"mappings":";;;;;;AAyCA,IAAa,KACX,GACA,MACgB;CAChB,IAAM,IAAO,GAAS,MAChB,IAAQ,EACZ;EAAE,MAAM,GAAS;EAAc,QAAQ;CAAU,GACjD,IAAO,EAAE,QAAK,IAAI,KAAA,CACpB,GAIM,IAAQ,EAAO,CAAC,GAElB,IAAqC,MACrC,IAAW,IAMT,IAAO,QAAa;EAUxB,AATA,EAAW,OAMX,EAAgB,CAAC,EAAE,UAAU,EAAE,QAAK,CAAC,GAErC,GAAY,MAAM,GAClB,IAAa,IAAI,gBAAgB;EAEjC,IAAM,EAAE,QAAQ,MAAgB,GAE1B,IAAU,EAAM,KAAK,GACrB,IAAW,UAAU,IAAU,EAAQ,OAAO,KAAA;EAIpD,AAFA,EAAM,QAAQ;GAAE,MAAM;GAAU,QAAQ;EAAU,IAE5C,YAAY;GAChB,IAAI;IACF,IAAM,IAAS,MAAM,EAAQ,CAAW;IAExC,AAAI,CAAC,EAAY,WAAW,CAAC,MAC3B,EAAM,QAAQ;KAAE,MAAM;KAAQ,QAAQ;IAAQ;GAElD,SAAS,GAAK;IACZ,AAAI,CAAC,EAAY,WAAW,CAAC,MAC3B,EAAM,QAAQ;KAAE,MAAM;KAAU,OAAO;KAAK,QAAQ;IAAQ;GAEhE;EACF,EAAA,CAAG;CACL,GAAG;EAjC6B;GAAO,IAAqB;CAiCzD,CAAqB,GAElB,UAAsB;EACtB,MAEJ,EAAM,QAAQ,EAAM,KAAK,IAAI;CAC/B,GAEM,UAAsB;EACtB,MAEJ,IAAW,IACX,GAAY,MAAM,GAClB,EAAK,QAAQ,GACb,EAAM,QAAQ,GACd,EAAM,QAAQ;CAChB;CA6BA,OA3BA,EAAqB,CAAO,GA2BrB;EAnBL;EACA,IAAI,WAAW;GACb,OAAO;EACT;GACC,IAAc;GACd,IAAY;EACb,IAAI,OAAO;GACT,OAAO,EAAM;EACf;EACA,YAAY,EAAM,KAAK;EACvB;EACA,YAAY,MAAyB,EAAM,UAAU,CAAQ;GAC5D,OAAO,UAAU;EAClB,IAAI,QAAQ;GACV,OAAO,EAAM;EACf;CAIK;AACT"}

package/dist/computed.cjs

@@ -1,2 +1,2 @@
-const e=require("./devtools-hook.cjs"),t=require("./_error-utils.cjs"),n=require("./errors.cjs"),r=require("./tracking.cjs"),i=require("./subscription.cjs"),a=require("./symbols.cjs"),o=require("./reactive-base.cjs");var s=class extends o.ComputedBase{value_;dirty_;computing_;disposed_;deps_;compute_;equals_;maxRevision_;constructor(e,t){let{equals:n,name:r}=t??{};super(r),this.value_=a.UNINITIALIZED,this.dirty_=!0,this.computing_=!1,this.disposed_=!1,this.deps_=[],this.maxRevision_=-1,this.compute_=e,this.equals_=n===void 0?Object.is:(e,t)=>n(e,t)}markDirty(){return this.disposed_||this.dirty_?!1:(this.dirty_=!0,!0)}refreshIfDirty(){if(!this.dirty_)return!1;if(r.getRevision()<=this.maxRevision_)return this.dirty_=!1,!1;if(this.deps_.length>0){let e=!0;for(let t of this.deps_){let n=t.source;if(`refreshIfDirty`in n&&n.refreshIfDirty(),n.version!==t.version){e=!1;break}}if(e)return this.dirty_=!1,this.maxRevision_=r.getRevision(),!1}return this.recompute()}runCompute(e){try{return r.withTracking({computed:this,depCollector:e,kind:`computed`},this.compute_)}catch(e){throw t.ensureError(e)}}recompute(){if(this.computing_)throw new n.RippleComputedCycleError(`computed cycle detected${this.name?` "${this.name}"`:``}`);this.computing_=!0;try{let t=[];e.getDevToolsHook()?.compute?.({name:this.name});let n=this.runCompute(t);return this.dirty_=!1,this.maxRevision_=r.getRevision(),this.updateDeps(t),this.value_===a.UNINITIALIZED||!this.equals_(this.value_,n)?(this.value_=n,this.version++,!0):!1}finally{this.computing_=!1}}updateDeps(e){let t=this.deps_;if(t.length===e.length&&t.every((t,n)=>t.source===e[n].source)){for(let n=0;n<e.length;n++)t[n].version=e[n].version;return}let n=new Set(t.map(e=>e.source)),r=new Set(e.map(e=>e.source));for(let e of t)r.has(e.source)||e.source.removeComputedSub(this);for(let t of e)n.has(t.source)||t.source.addComputedSub(this);this.deps_=e}get value(){return this.disposed_?this.value_===a.UNINITIALIZED?void 0:this.value_:(this.refreshIfDirty(),r.trackSource(this),this.value_)}peek(){return this.disposed_?this.value_===a.UNINITIALIZED?void 0:this.value_:(this.refreshIfDirty(),this.value_)}subscribe=e=>{if(this.disposed_){let e=new i.SubscriptionImpl(()=>{});return e.dispose(),e}return this.refreshIfDirty(),this.addEffectSub(e),new i.SubscriptionImpl(()=>{this.removeEffectSub(e)})};get disposed(){return this.disposed_}dispose(){if(!this.disposed_){this.disposed_=!0;for(let e of this.deps_)e.source.removeComputedSub(this);this.deps_=[],this.clearSubscribers(),e.getDevToolsHook()?.dispose?.({kind:`computed`,name:this.name})}}[Symbol.dispose](){this.dispose()}},c=(e,t)=>{let n=new s(e,t);return r.autoRegisterDisposal(()=>n.dispose()),n};exports.ComputedImpl=s,exports.computed=c;
+const e=require("./devtools-hook.cjs"),t=require("./_error-utils.cjs"),n=require("./errors.cjs"),r=require("./subscription.cjs"),i=require("./symbols.cjs"),a=require("./tracking.cjs"),o=require("./reactive-base.cjs");var s=class extends o.ComputedBase{value_;dirty_;computing_;disposed_;deps_;compute_;equals_;maxRevision_;constructor(e,t){let{equals:n,name:r}=t??{};super(r),this.value_=i.UNINITIALIZED,this.dirty_=!0,this.computing_=!1,this.disposed_=!1,this.deps_=[],this.maxRevision_=-1,this.compute_=e,this.equals_=n===void 0?Object.is:(e,t)=>n(e,t)}markDirty(){return this.disposed_||this.dirty_?!1:(this.dirty_=!0,!0)}refreshIfDirty(){if(!this.dirty_)return!1;if(a.getRevision()<=this.maxRevision_)return this.dirty_=!1,!1;if(this.deps_.length>0){let e=!0;for(let t of this.deps_){let n=t.source;if(`refreshIfDirty`in n&&n.refreshIfDirty(),n.version!==t.version){e=!1;break}}if(e)return this.dirty_=!1,this.maxRevision_=a.getRevision(),!1}return this.recompute()}runCompute(e){try{return a.withTracking({computed:this,depCollector:e,kind:`computed`},this.compute_)}catch(e){throw t.ensureError(e)}}recompute(){if(this.computing_)throw new n.RippleComputedCycleError(`computed cycle detected${this.name?` "${this.name}"`:``}`);this.computing_=!0;try{let t=[];e.getDevToolsHook()?.compute?.({name:this.name});let n=this.runCompute(t);return this.dirty_=!1,this.maxRevision_=a.getRevision(),this.updateDeps(t),this.value_===i.UNINITIALIZED||!this.equals_(this.value_,n)?(this.value_=n,this.version++,!0):!1}finally{this.computing_=!1}}updateDeps(e){let t=this.deps_;if(t.length===e.length&&t.every((t,n)=>t.source===e[n].source)){for(let n=0;n<e.length;n++)t[n].version=e[n].version;return}let n=new Set(t.map(e=>e.source)),r=new Set(e.map(e=>e.source));for(let e of t)r.has(e.source)||e.source.removeComputedSub(this);for(let t of e)n.has(t.source)||t.source.addComputedSub(this);this.deps_=e}get value(){return this.disposed_?this.value_===i.UNINITIALIZED?void 0:this.value_:(this.refreshIfDirty(),a.trackSource(this),this.value_)}peek(){return this.disposed_?this.value_===i.UNINITIALIZED?void 0:this.value_:(this.refreshIfDirty(),this.value_)}subscribe=e=>{if(this.disposed_){let e=new r.SubscriptionImpl(()=>{});return e.dispose(),e}return this.refreshIfDirty(),this.addEffectSub(e),new r.SubscriptionImpl(()=>{this.removeEffectSub(e)})};get disposed(){return this.disposed_}dispose(){if(!this.disposed_){this.disposed_=!0;for(let e of this.deps_)e.source.removeComputedSub(this);this.deps_=[],this.clearSubscribers(),e.getDevToolsHook()?.dispose?.({kind:`computed`,name:this.name})}}[Symbol.dispose](){this.dispose()}},c=(e,t)=>{let n=new s(e,t);return a.autoRegisterDisposal(()=>n.dispose()),n};exports.ComputedImpl=s,exports.computed=c;
 //# sourceMappingURL=computed.cjs.map

package/dist/computed.js

@@ -1,9 +1,9 @@
 import { getDevToolsHook as e } from "./devtools-hook.js";
 import { ensureError as t } from "./_error-utils.js";
 import { RippleComputedCycleError as n } from "./errors.js";
-import { autoRegisterDisposal as r, getRevision as i, trackSource as a, withTracking as o } from "./tracking.js";
-import { SubscriptionImpl as s } from "./subscription.js";
-import { UNINITIALIZED as c } from "./symbols.js";
+import { SubscriptionImpl as r } from "./subscription.js";
+import { UNINITIALIZED as i } from "./symbols.js";
+import { autoRegisterDisposal as a, getRevision as o, trackSource as s, withTracking as c } from "./tracking.js";
 import { ComputedBase as l } from "./reactive-base.js";
 //#region src/computed.ts
 var u = class extends l {
@@ -17,14 +17,14 @@ var u = class extends l {
 	maxRevision_;
 	constructor(e, t) {
 		let { equals: n, name: r } = t ?? {};
-		super(r), this.value_ = c, this.dirty_ = !0, this.computing_ = !1, this.disposed_ = !1, this.deps_ = [], this.maxRevision_ = -1, this.compute_ = e, this.equals_ = n === void 0 ? Object.is : (e, t) => n(e, t);
+		super(r), this.value_ = i, this.dirty_ = !0, this.computing_ = !1, this.disposed_ = !1, this.deps_ = [], this.maxRevision_ = -1, this.compute_ = e, this.equals_ = n === void 0 ? Object.is : (e, t) => n(e, t);
 	}
 	markDirty() {
 		return this.disposed_ || this.dirty_ ? !1 : (this.dirty_ = !0, !0);
 	}
 	refreshIfDirty() {
 		if (!this.dirty_) return !1;
-		if (i() <= this.maxRevision_) return this.dirty_ = !1, !1;
+		if (o() <= this.maxRevision_) return this.dirty_ = !1, !1;
 		if (this.deps_.length > 0) {
 			let e = !0;
 			for (let t of this.deps_) {
@@ -34,13 +34,13 @@ var u = class extends l {
 					break;
 				}
 			}
-			if (e) return this.dirty_ = !1, this.maxRevision_ = i(), !1;
+			if (e) return this.dirty_ = !1, this.maxRevision_ = o(), !1;
 		}
 		return this.recompute();
 	}
 	runCompute(e) {
 		try {
-			return o({
+			return c({
 				computed: this,
 				depCollector: e,
 				kind: "computed"
@@ -56,7 +56,7 @@ var u = class extends l {
 			let t = [];
 			e()?.compute?.({ name: this.name });
 			let n = this.runCompute(t);
-			return this.dirty_ = !1, this.maxRevision_ = i(), this.updateDeps(t), this.value_ === c || !this.equals_(this.value_, n) ? (this.value_ = n, this.version++, !0) : !1;
+			return this.dirty_ = !1, this.maxRevision_ = o(), this.updateDeps(t), this.value_ === i || !this.equals_(this.value_, n) ? (this.value_ = n, this.version++, !0) : !1;
 		} finally {
 			this.computing_ = !1;
 		}
@@ -73,17 +73,17 @@ var u = class extends l {
 		this.deps_ = e;
 	}
 	get value() {
-		return this.disposed_ ? this.value_ === c ? void 0 : this.value_ : (this.refreshIfDirty(), a(this), this.value_);
+		return this.disposed_ ? this.value_ === i ? void 0 : this.value_ : (this.refreshIfDirty(), s(this), this.value_);
 	}
 	peek() {
-		return this.disposed_ ? this.value_ === c ? void 0 : this.value_ : (this.refreshIfDirty(), this.value_);
+		return this.disposed_ ? this.value_ === i ? void 0 : this.value_ : (this.refreshIfDirty(), this.value_);
 	}
 	subscribe = (e) => {
 		if (this.disposed_) {
-			let e = new s(() => {});
+			let e = new r(() => {});
 			return e.dispose(), e;
 		}
-		return this.refreshIfDirty(), this.addEffectSub(e), new s(() => {
+		return this.refreshIfDirty(), this.addEffectSub(e), new r(() => {
 			this.removeEffectSub(e);
 		});
 	};
@@ -105,7 +105,7 @@ var u = class extends l {
 	}
 }, d = (e, t) => {
 	let n = new u(e, t);
-	return r(() => n.dispose()), n;
+	return a(() => n.dispose()), n;
 };
 //#endregion
 export { u as ComputedImpl, d as computed };

package/dist/effect.cjs

@@ -1,2 +1,2 @@
-const e=require("./devtools-hook.cjs"),t=require("./_error-utils.cjs"),n=require("./errors.cjs"),r=require("./tracking.cjs");require("./scheduling.cjs");const i=require("./subscription.cjs"),a=require("./symbols.cjs");var o=(e,t)=>{if(t===`sync`||t===void 0)return e;let n=!1;return()=>{n||(n=!0,queueMicrotask(()=>{n=!1,e()}))}},s=(s,c)=>{let l=c?.scheduler??`sync`,u=c?.name,d=[],f=new Set,p=new Map,m=!1,h=!1,g=!1,_=()=>{if(p.clear(),d.length===0&&f.size===0)return;let e=[...d,...f];d.length=0,f.clear(),t.runAll(e,`effect teardown errors`)},v=()=>{if(!g){if(m){h=!0;return}m=!0;try{let i=0;do{if(++i>100)throw new n.RippleInfiniteLoopError(`infinite effect loop (> 100 iterations)${u?` in "${u}"`:``}`);h=!1,_(),e.getDevToolsHook()?.run?.({name:u});let a;try{a=r.withTracking({cleanups:d,deps:p,effect:y,kind:`effect`,subscriptions:f},s)}catch(e){let n=[...t.collectErrors(f),...t.collectErrors(d)];d.length=0,f.clear(),t.rethrowWith(e,n,`effect failure with cleanup errors`)}if(a!==void 0&&typeof a!=`function`)throw new n.RippleInvalidCleanupError(`effect() returned ${typeof a} — expected a cleanup function or void.`);typeof a==`function`&&d.push(a)}while(h&&!g)}finally{m=!1}}},y=o(v,l);v();let b=new i.SubscriptionImpl(()=>{g||(g=!0,_(),e.getDevToolsHook()?.dispose?.({kind:`effect`,name:u}))});return r.getScopeCleanups()?.push(()=>b.dispose()),{dispose:()=>b.dispose(),get disposed(){return b.disposed},getDependencies(){return[...p.keys()].map(e=>({kind:a.IS_COMPUTED in e?`computed`:`signal`,name:e.name}))},[Symbol.dispose](){b.dispose()}}},c=(e,t)=>{let n=null,r=null,a=null,o=t?.onError??(e=>{queueMicrotask(()=>{throw e})});return new i.AsyncSubscriptionImpl(s(()=>{n?.abort(),r?.(),r=null,n=new AbortController;let{signal:t}=n,i=u(),s;return a=s=(async()=>{try{let n=await e(t,i);typeof n==`function`&&(t.aborted?n():r=n)}catch(e){t.aborted||o(e)}finally{i.dispose(),a===s&&(a=null)}})(),()=>{n?.abort(),r?.(),r=null}},{name:t?.name}),async()=>{let e=a;e&&await e},()=>a)},l=e=>{let t=r.getTracking();if(t?.kind===`effect`){t.cleanups.push(e);return}let i=r.getScopeCleanups();if(i!==null){i.push(e);return}throw new n.RippleInvalidCleanupError(`onCleanup() must be called from within an active effect or scope.`)},u=e=>{let i=[],a=new AbortController,o=!1,s=e=>{if(o)throw new n.RippleDisposedScopeError(`Cannot register cleanup on a disposed scope.`);i.push(e)},c=e=>{if(o)throw new n.RippleDisposedScopeError(`Cannot run inside a disposed scope.`);return r.withScopeCleanups(i,e)},l=()=>{o||(o=!0,a.abort(),t.runAll([...i].reverse(),`scope cleanup errors`),i.length=0)},u={add:s,get disposalSignal(){return a.signal},dispose:l,get disposed(){return o},run:c,[Symbol.dispose]:l};return e&&c(e),u};function d(e,t,a){let o=a?.equals??Object.is,c,l=(e,r)=>{c?.(),c=void 0;let i=t(e,r);if(i!==void 0&&typeof i!=`function`)throw new n.RippleInvalidCleanupError(`watch() callback returned ${typeof i} — expected a cleanup function or void.`);typeof i==`function`&&(c=i)},u;if(typeof e==`function`){let t,n=!0,r=s(()=>{let r=e();if(n){n=!1,t=r;return}if(!o(t,r)){let e=t;t=r,l(r,e),a?.once&&u.dispose()}},{name:a?.name});u=new i.SubscriptionImpl(()=>{c?.(),c=void 0,r.dispose()}),a?.immediate&&(l(t,void 0),a.once&&u.dispose())}else{let t=e.peek(),n=e.subscribe(()=>{let n=e.peek();o(t,n)||(l(n,t),t=n,a?.once&&u.dispose())});u=new i.SubscriptionImpl(()=>{c?.(),c=void 0,n.dispose()}),a?.immediate&&(l(t,void 0),a.once&&u.dispose())}return r.getScopeCleanups()?.push(()=>u.dispose()),u}exports.effect=s,exports.effectAsync=c,exports.onCleanup=l,exports.scope=u,exports.watch=d;
+const e=require("./devtools-hook.cjs"),t=require("./_error-utils.cjs"),n=require("./errors.cjs"),r=require("./execution-context.cjs");require("./scheduling.cjs");const i=require("./subscription.cjs"),a=require("./symbols.cjs"),o=require("./tracking.cjs");var s=(e,t)=>{if(t===`sync`||t===void 0)return e;let n=!1;return()=>{n||(n=!0,queueMicrotask(()=>{n=!1,e()}))}},c=(c,l)=>{let u=l?.scheduler??`sync`,d=l?.name,f=l?.[a.SUPPRESS_RUN_EVENT],p=[],m=new Set,h=new Map,g=!1,_=!1,v=!1,y=()=>{if(h.clear(),p.length===0&&m.size===0)return;let e=[...p,...m];p.length=0,m.clear(),t.runAll(e,`effect teardown errors`)},b=()=>{if(!v){if(g){_=!0;return}g=!0;try{let r=0;do{if(++r>100)throw new n.RippleInfiniteLoopError(`infinite effect loop (> 100 iterations)${d?` in "${d}"`:``}`);_=!1,y(),f||e.getDevToolsHook()?.run?.({name:d});let i;try{i=o.withTracking({cleanups:p,deps:h,effect:x,kind:`effect`,subscriptions:m},c)}catch(e){let n=[...t.collectErrors(m),...t.collectErrors(p)];p.length=0,m.clear(),t.rethrowWith(e,n,`effect failure with cleanup errors`)}if(i!==void 0&&typeof i!=`function`)throw new n.RippleInvalidCleanupError(`effect() returned ${typeof i} — expected a cleanup function or void.`);typeof i==`function`&&p.push(i)}while(_&&!v)}finally{g=!1}}},x=s(b,u);b();let S=new i.SubscriptionImpl(()=>{v||(v=!0,y(),e.getDevToolsHook()?.dispose?.({kind:`effect`,name:d}))});return r.getScopeCleanups()?.push(()=>S.dispose()),{dispose:()=>S.dispose(),get disposed(){return S.disposed},getDependencies(){return[...h.keys()].map(e=>({kind:a.IS_COMPUTED in e?`computed`:`signal`,name:e.name}))},[Symbol.dispose](){S.dispose()}}},l=(e,t)=>{let n=null,r=null,a=null,o=t?.onError??(e=>{queueMicrotask(()=>{throw e})});return new i.AsyncSubscriptionImpl(c(()=>{n?.abort(),r?.(),r=null,n=new AbortController;let{signal:t}=n,i=d(),s;return a=s=(async()=>{try{let n=await e(t,i);typeof n==`function`&&(t.aborted?n():r=n)}catch(e){t.aborted||o(e)}finally{i.dispose(),a===s&&(a=null)}})(),()=>{n?.abort(),r?.(),r=null}},{name:t?.name}),async()=>{let e=a;e&&await e},()=>a)},u=e=>{let t=o.getTracking();if(t?.kind===`effect`){t.cleanups.push(e);return}let i=r.getScopeCleanups();if(i!==null){i.push(e);return}throw new n.RippleInvalidCleanupError(`onCleanup() must be called from within an active effect or scope.`)},d=e=>{let i=[],a=new AbortController,o=!1,s=e=>{if(o)throw new n.RippleDisposedScopeError(`Cannot register cleanup on a disposed scope.`);i.push(e)},c=e=>{if(o)throw new n.RippleDisposedScopeError(`Cannot run inside a disposed scope.`);return r.withScopeCleanups(i,e)},l=()=>{o||(o=!0,a.abort(),t.runAll([...i].reverse(),`scope cleanup errors`),i.length=0)},u={add:s,get disposalSignal(){return a.signal},dispose:l,get disposed(){return o},run:c,[Symbol.dispose]:l};return e&&c(e),u};function f(e,t,a){let o=a?.equals??Object.is,s,l=(e,r)=>{s?.(),s=void 0;let i=t(e,r);if(i!==void 0&&typeof i!=`function`)throw new n.RippleInvalidCleanupError(`watch() callback returned ${typeof i} — expected a cleanup function or void.`);typeof i==`function`&&(s=i)},u;if(typeof e==`function`){let t,n=!0,r=c(()=>{let r=e();if(n){n=!1,t=r;return}if(!o(t,r)){let e=t;t=r,l(r,e),a?.once&&u.dispose()}},{name:a?.name});u=new i.SubscriptionImpl(()=>{s?.(),s=void 0,r.dispose()}),a?.immediate&&(l(t,void 0),a.once&&u.dispose())}else{let t=e.peek(),n=e.subscribe(()=>{let n=e.peek();o(t,n)||(l(n,t),t=n,a?.once&&u.dispose())});u=new i.SubscriptionImpl(()=>{s?.(),s=void 0,n.dispose()}),a?.immediate&&(l(t,void 0),a.once&&u.dispose())}return r.getScopeCleanups()?.push(()=>u.dispose()),u}exports.effect=c,exports.effectAsync=l,exports.onCleanup=u,exports.scope=d,exports.watch=f;
 //# sourceMappingURL=effect.cjs.map

package/dist/effect.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"effect.cjs","names":[],"sources":["../src/effect.ts"],"sourcesContent":["import type { ReactiveBase } from './reactive-base';\nimport type {\n  AsyncEffectCallback,\n  AsyncSubscription,\n  CleanupFn,\n  DepInfo,\n  EffectAsyncOptions,\n  EffectCallback,\n  EffectHandle,\n  EffectOptions,\n  EqualityFn,\n  Readable,\n  Scope,\n  Subscriber,\n  Subscription,\n  WatchOptions,\n} from './types';\n\nimport { collectErrors, rethrowWith, runAll } from './_error-utils';\nimport { getDevToolsHook } from './devtools-hook';\nimport { RippleDisposedScopeError, RippleInfiniteLoopError, RippleInvalidCleanupError } from './errors';\nimport { DEFAULT_MAX_ITERATIONS } from './scheduling';\nimport { AsyncSubscriptionImpl, SubscriptionImpl } from './subscription';\nimport { IS_COMPUTED } from './symbols';\nimport { getScopeCleanups, getTracking, withScopeCleanups, withTracking } from './tracking';\n\n/**\n * Wraps a core `run` function with a microtask-based scheduler that coalesces rapid re-runs.\n * The `subscriber` returned here is what gets registered in signal subscriber sets —\n * so notifications call the deferred wrapper, not `run` directly.\n *\n * The scheduler identity is stable for the lifetime of the effect.\n * Never replace `subscriber` with a new function after creation — doing so would break\n * the removeEffectSub calls that rely on reference identity.\n */\nconst withScheduler = (run: Subscriber, scheduler: EffectOptions['scheduler']): Subscriber => {\n  if (scheduler === 'sync' || scheduler === undefined) return run;\n\n  // 'microtask'\n  let scheduled = false;\n\n  return (): void => {\n    if (scheduled) return;\n\n    scheduled = true;\n    queueMicrotask(() => {\n      scheduled = false;\n      run();\n    });\n  };\n};\n\n/**\n * Creates a reactive side-effect.\n * Runs immediately, re-runs whenever tracked dependencies change.\n * The callback may return a cleanup function that runs before the next re-run and on dispose.\n *\n * @example\n * ```ts\n * const stop = effect(() => {\n *   document.title = count.value.toString();\n *   return () => { document.title = ''; }; // optional cleanup\n * });\n *\n * stop.dispose(); // or: using stop = effect(...)\n * console.log(stop.getDependencies()); // reactive graph introspection\n * ```\n */\nexport const effect = (fn: EffectCallback, options?: EffectOptions): EffectHandle => {\n  const scheduler = options?.scheduler ?? 'sync';\n  const effectName = options?.name;\n\n  const runCleanups: CleanupFn[] = [];\n  const subscriptions = new Set<CleanupFn>();\n  const currentDeps = new Map<ReactiveBase<unknown>, number>();\n  let isRunning = false;\n  let isDirty = false;\n  let isDisposed = false;\n\n  const teardown = (): void => {\n    currentDeps.clear();\n\n    if (runCleanups.length === 0 && subscriptions.size === 0) return;\n\n    const toRun = [...runCleanups, ...subscriptions];\n\n    runCleanups.length = 0;\n    subscriptions.clear();\n\n    runAll(toRun, 'effect teardown errors');\n  };\n\n  // The inner do-while handles self-cascade: when the effect body writes to a signal it reads,\n  // the recursive flush sets isDirty via the isRunning guard.\n  const run: Subscriber = (): void => {\n    if (isDisposed) return;\n\n    if (isRunning) {\n      isDirty = true;\n\n      return;\n    }\n\n    isRunning = true;\n\n    try {\n      let iterations = 0;\n\n      do {\n        if (++iterations > DEFAULT_MAX_ITERATIONS) {\n          const label = effectName ? ` in \"${effectName}\"` : '';\n\n          throw new RippleInfiniteLoopError(`infinite effect loop (> ${DEFAULT_MAX_ITERATIONS} iterations)${label}`);\n        }\n\n        isDirty = false;\n        teardown();\n\n        getDevToolsHook()?.run?.({ name: effectName });\n\n        let returnedCleanup: CleanupFn | void = undefined;\n\n        try {\n          returnedCleanup = withTracking(\n            { cleanups: runCleanups, deps: currentDeps, effect: subscriber, kind: 'effect', subscriptions },\n            fn,\n          );\n        } catch (error) {\n          const cleanupErrors = [...collectErrors(subscriptions), ...collectErrors(runCleanups)];\n\n          runCleanups.length = 0;\n          subscriptions.clear();\n          rethrowWith(error, cleanupErrors, 'effect failure with cleanup errors');\n        }\n\n        if (returnedCleanup !== undefined && typeof returnedCleanup !== 'function') {\n          throw new RippleInvalidCleanupError(\n            `effect() returned ${typeof returnedCleanup} — expected a cleanup function or void.`,\n          );\n        }\n\n        if (typeof returnedCleanup === 'function') runCleanups.push(returnedCleanup);\n      } while (isDirty && !isDisposed);\n    } finally {\n      isRunning = false;\n    }\n  };\n\n  // subscriber is what gets registered in signal subscriber Sets.\n  // For 'sync' it is the same as run; for deferred schedulers it's the debouncing wrapper.\n  const subscriber = withScheduler(run, scheduler);\n\n  // Always run synchronously on creation to establish initial tracking.\n  run();\n\n  const sub = new SubscriptionImpl(() => {\n    if (isDisposed) return;\n\n    isDisposed = true;\n    teardown();\n    getDevToolsHook()?.dispose?.({ kind: 'effect', name: effectName });\n  });\n\n  // Auto-register disposal into the enclosing scope (if any).\n  // Uses the separate scope stack — orthogonal to the effect/computed tracking context.\n  getScopeCleanups()?.push(() => sub.dispose());\n\n  const handle: EffectHandle = {\n    dispose: () => sub.dispose(),\n    get disposed() {\n      return sub.disposed;\n    },\n    getDependencies(): ReadonlyArray<DepInfo> {\n      return [...currentDeps.keys()].map((src) => ({\n        kind: IS_COMPUTED in (src as object) ? 'computed' : 'signal',\n        name: src.name,\n      }));\n    },\n    [Symbol.dispose]() {\n      sub.dispose();\n    },\n  };\n\n  return handle;\n};\n\n/**\n * Like `effect()`, but the callback is async and receives an AbortSignal that fires when the\n * effect re-runs or is disposed. Read reactive dependencies synchronously before the first\n * `await` to register them as tracked.\n *\n * Returns an {@link AsyncSubscription} — call `await stop[Symbol.asyncDispose]()` to await\n * full teardown, or `stop.run()` to await just the current in-flight run.\n *\n * @example\n * ```ts\n * const userId = signal('u1');\n * const stop = effectAsync(async (signal) => {\n *   const id = userId.value;            // sync dep — tracked\n *   const data = await fetchUser(id, { signal }); // aborted automatically if id changes\n *   renderUser(data);\n * });\n *\n * await stop[Symbol.asyncDispose]();\n * ```\n */\nexport const effectAsync = (fn: AsyncEffectCallback, options?: EffectAsyncOptions): AsyncSubscription => {\n  let controller: AbortController | null = null;\n  let asyncCleanup: CleanupFn | null = null;\n  let currentRunPromise: Promise<void> | null = null;\n\n  const onError =\n    options?.onError ??\n    ((err: unknown) => {\n      queueMicrotask(() => {\n        throw err;\n      });\n    });\n\n  const syncStop = effect(\n    () => {\n      controller?.abort();\n      asyncCleanup?.();\n      asyncCleanup = null;\n\n      controller = new AbortController();\n\n      const { signal } = controller;\n      const runOwner = scope(); // per-run owner scope for async body resources\n\n      let theRun!: Promise<void>;\n\n      currentRunPromise = theRun = (async () => {\n        try {\n          const returned = await fn(signal, runOwner);\n\n          if (typeof returned === 'function') {\n            if (signal.aborted) {\n              // Aborted while async fn was running — run cleanup immediately.\n              returned();\n            } else {\n              asyncCleanup = returned;\n            }\n          }\n        } catch (err) {\n          if (!signal.aborted) onError(err);\n        } finally {\n          runOwner.dispose();\n\n          if (currentRunPromise === theRun) currentRunPromise = null;\n        }\n      })();\n\n      return () => {\n        controller?.abort();\n        asyncCleanup?.();\n        asyncCleanup = null;\n      };\n    },\n    { name: options?.name },\n  );\n\n  return new AsyncSubscriptionImpl(\n    syncStop,\n    async () => {\n      const runningPromise = currentRunPromise;\n\n      if (runningPromise) await runningPromise;\n    },\n    () => currentRunPromise,\n  );\n};\n\nexport const onCleanup = (fn: CleanupFn): void => {\n  const ctx = getTracking();\n\n  if (ctx?.kind === 'effect') {\n    ctx.cleanups.push(fn);\n\n    return;\n  }\n\n  const scopeCleanups = getScopeCleanups();\n\n  if (scopeCleanups !== null) {\n    scopeCleanups.push(fn);\n\n    return;\n  }\n\n  throw new RippleInvalidCleanupError('onCleanup() must be called from within an active effect or scope.');\n};\n\n/**\n * Creates a lifecycle scope that collects `onCleanup()` registrations and runs\n * them in reverse order when `dispose()` is called.\n *\n * The optional `setup` callback is run immediately inside the scope so that\n * `onCleanup()` calls in setup are captured without requiring a separate\n * `scope.run(setup)` call.\n *\n * Use `scope.add(fn)` to explicitly register a cleanup into this scope from\n * anywhere — including from inside an effect body where `onCleanup()` would otherwise\n * go to the effect's own cleanup queue.\n *\n * @example\n * ```ts\n * const s = scope(() => {\n *   onCleanup(() => expensiveCleanup()); // captured by scope\n * });\n *\n * const stop = effect(() => {\n *   void count.value;\n *   s.add(() => doWork()); // explicit: goes to scope, not effect\n *   onCleanup(() => cheapCleanup()); // goes to effect\n * });\n *\n * // later:\n * s.dispose(); // or: using s = scope(...)\n * ```\n */\nexport const scope = (setup?: () => void): Scope => {\n  const cleanups: CleanupFn[] = [];\n  const ac = new AbortController();\n  let disposed = false;\n\n  const scopeOnCleanup = (fn: CleanupFn): void => {\n    if (disposed) throw new RippleDisposedScopeError('Cannot register cleanup on a disposed scope.');\n\n    cleanups.push(fn);\n  };\n\n  const run = <T>(fn: () => T): T => {\n    if (disposed) throw new RippleDisposedScopeError('Cannot run inside a disposed scope.');\n\n    return withScopeCleanups(cleanups, fn);\n  };\n\n  const dispose = (): void => {\n    if (disposed) return;\n\n    disposed = true;\n    ac.abort();\n    runAll([...cleanups].reverse(), 'scope cleanup errors');\n    cleanups.length = 0;\n  };\n\n  const api: Scope = {\n    add: scopeOnCleanup,\n    get disposalSignal() {\n      return ac.signal;\n    },\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    run,\n    [Symbol.dispose]: dispose,\n  };\n\n  if (setup) run(setup);\n\n  return api;\n};\n\n// ── watch() ───────────────────────────────────────────────────────────────────\n\n/**\n * Observes a reactive source and calls `callback` whenever its value changes.\n * Does NOT invoke `callback` on creation (unless `immediate: true` is passed).\n *\n * `source` may be a single `Readable<T>` (signal, computed, or store lens), or a\n * function that reads multiple reactive sources — the function form tracks every\n * dependency read inside it, like `computed()`, without needing an intermediate\n * `computed()` node.\n *\n * When called without `immediate`, `prev` is always `T` — the previous value.\n * When `immediate: true` is passed, `prev` is `T | undefined` on the first call.\n *\n * @example\n * ```ts\n * const stop = watch(count, (next, prev) => {\n *   console.log(`count changed: ${prev} → ${next}`);\n * });\n *\n * stop.dispose();\n * ```\n *\n * @example\n * ```ts\n * // Function form — tracks every signal read inside, re-runs when any changes.\n * const stopSum = watch(\n *   () => a.value + b.value,\n *   (sum, prevSum) => console.log(`sum: ${prevSum} → ${sum}`),\n * );\n *\n * stopSum.dispose();\n * ```\n */\nexport function watch<T>(\n  source: Readable<T>,\n  callback: (value: T, prev: T | undefined) => CleanupFn | void,\n  options?: WatchOptions<T>,\n): Subscription;\nexport function watch<T>(\n  source: () => T,\n  callback: (value: T, prev: T | undefined) => CleanupFn | void,\n  options?: WatchOptions<T>,\n): Subscription;\nexport function watch<T>(\n  source: Readable<T> | (() => T),\n  callback: (value: T, prev: T | undefined) => CleanupFn | void,\n  options?: WatchOptions<T>,\n): Subscription {\n  const equals: EqualityFn<T> = options?.equals ?? Object.is;\n  let pendingCleanup: CleanupFn | undefined;\n  const invokeCallback = (next: T, p: T | undefined): void => {\n    pendingCleanup?.();\n    pendingCleanup = undefined;\n\n    const returned = callback(next, p);\n\n    if (returned !== undefined && typeof returned !== 'function') {\n      throw new RippleInvalidCleanupError(\n        `watch() callback returned ${typeof returned} — expected a cleanup function or void.`,\n      );\n    }\n\n    if (typeof returned === 'function') pendingCleanup = returned;\n  };\n\n  // Declared before the subscriber/effect closures so both they and the immediate\n  // path can call watchSub.dispose() when once:true. Subscribers/effects always\n  // (re-)run after watchSub is assigned, since it's assigned synchronously right after.\n\n  let watchSub!: SubscriptionImpl;\n\n  if (typeof source === 'function') {\n    // Function form — track every dependency read inside `source` via a real effect,\n    // mirroring computed()'s dependency collection. `first` suppresses the callback\n    // on the initial (tracking-establishing) run — handled explicitly below (after\n    // watchSub exists) instead of inside this synchronous first run, since effect()\n    // runs its body immediately and watchSub isn't assigned until after it returns.\n    let prev!: T;\n    let first = true;\n\n    const stopEffect = effect(\n      () => {\n        const next = source();\n\n        if (first) {\n          first = false;\n          prev = next;\n\n          return;\n        }\n\n        if (!equals(prev, next)) {\n          const p = prev;\n\n          prev = next;\n          invokeCallback(next, p);\n\n          if (options?.once) watchSub.dispose();\n        }\n      },\n      { name: options?.name },\n    );\n\n    watchSub = new SubscriptionImpl(() => {\n      pendingCleanup?.();\n      pendingCleanup = undefined;\n      stopEffect.dispose();\n    });\n\n    if (options?.immediate) {\n      invokeCallback(prev, undefined);\n\n      if (options.once) watchSub.dispose();\n    }\n  } else {\n    let prev: T = source.peek();\n\n    const innerSub = source.subscribe(() => {\n      const next = source.peek();\n\n      if (!equals(prev, next)) {\n        invokeCallback(next, prev);\n        prev = next;\n\n        if (options?.once) watchSub.dispose();\n      }\n    });\n\n    watchSub = new SubscriptionImpl(() => {\n      pendingCleanup?.();\n      pendingCleanup = undefined;\n      innerSub.dispose();\n    });\n\n    if (options?.immediate) {\n      invokeCallback(prev, undefined);\n\n      if (options.once) watchSub.dispose();\n    }\n  }\n\n  // Auto-register disposal into the enclosing scope (if any) — matches effect() behaviour.\n  getScopeCleanups()?.push(() => watchSub.dispose());\n\n  return watchSub;\n}\n"],"mappings":"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"}
+{"version":3,"file":"effect.cjs","names":[],"sources":["../src/effect.ts"],"sourcesContent":["import type { ReactiveBase } from './reactive-base';\nimport type {\n  AsyncEffectCallback,\n  AsyncSubscription,\n  CleanupFn,\n  DepInfo,\n  EffectAsyncOptions,\n  EffectCallback,\n  EffectHandle,\n  EffectOptions,\n  EqualityFn,\n  Readable,\n  Scope,\n  Subscriber,\n  Subscription,\n  WatchOptions,\n} from './types';\n\nimport { collectErrors, rethrowWith, runAll } from './_error-utils';\nimport { getDevToolsHook } from './devtools-hook';\nimport { RippleDisposedScopeError, RippleInfiniteLoopError, RippleInvalidCleanupError } from './errors';\nimport { getScopeCleanups, withScopeCleanups } from './execution-context';\nimport { DEFAULT_MAX_ITERATIONS } from './scheduling';\nimport { AsyncSubscriptionImpl, SubscriptionImpl } from './subscription';\nimport { IS_COMPUTED, SUPPRESS_RUN_EVENT } from './symbols';\nimport { getTracking, withTracking } from './tracking';\n\n/**\n * Wraps a core `run` function with a microtask-based scheduler that coalesces rapid re-runs.\n * The `subscriber` returned here is what gets registered in signal subscriber sets —\n * so notifications call the deferred wrapper, not `run` directly.\n *\n * The scheduler identity is stable for the lifetime of the effect.\n * Never replace `subscriber` with a new function after creation — doing so would break\n * the removeEffectSub calls that rely on reference identity.\n */\nconst withScheduler = (run: Subscriber, scheduler: EffectOptions['scheduler']): Subscriber => {\n  if (scheduler === 'sync' || scheduler === undefined) return run;\n\n  // 'microtask'\n  let scheduled = false;\n\n  return (): void => {\n    if (scheduled) return;\n\n    scheduled = true;\n    queueMicrotask(() => {\n      scheduled = false;\n      run();\n    });\n  };\n};\n\n/**\n * Creates a reactive side-effect.\n * Runs immediately, re-runs whenever tracked dependencies change.\n * The callback may return a cleanup function that runs before the next re-run and on dispose.\n *\n * @example\n * ```ts\n * const stop = effect(() => {\n *   document.title = count.value.toString();\n *   return () => { document.title = ''; }; // optional cleanup\n * });\n *\n * stop.dispose(); // or: using stop = effect(...)\n * console.log(stop.getDependencies()); // reactive graph introspection\n * ```\n */\nexport const effect = (fn: EffectCallback, options?: EffectOptions): EffectHandle => {\n  const scheduler = options?.scheduler ?? 'sync';\n  const effectName = options?.name;\n  // Internal-only escape hatch — see SUPPRESS_RUN_EVENT's JSDoc in symbols.ts.\n  // No public option can ever reach this: EffectOptions doesn't declare the key, and\n  // the symbol is never exported from index.ts.\n  const suppressRunEvent = (options as Partial<Record<typeof SUPPRESS_RUN_EVENT, boolean>> | undefined)?.[\n    SUPPRESS_RUN_EVENT\n  ];\n\n  const runCleanups: CleanupFn[] = [];\n  const subscriptions = new Set<CleanupFn>();\n  const currentDeps = new Map<ReactiveBase<unknown>, number>();\n  let isRunning = false;\n  let isDirty = false;\n  let isDisposed = false;\n\n  const teardown = (): void => {\n    currentDeps.clear();\n\n    if (runCleanups.length === 0 && subscriptions.size === 0) return;\n\n    const toRun = [...runCleanups, ...subscriptions];\n\n    runCleanups.length = 0;\n    subscriptions.clear();\n\n    runAll(toRun, 'effect teardown errors');\n  };\n\n  // The inner do-while handles self-cascade: when the effect body writes to a signal it reads,\n  // the recursive flush sets isDirty via the isRunning guard.\n  const run: Subscriber = (): void => {\n    if (isDisposed) return;\n\n    if (isRunning) {\n      isDirty = true;\n\n      return;\n    }\n\n    isRunning = true;\n\n    try {\n      let iterations = 0;\n\n      do {\n        if (++iterations > DEFAULT_MAX_ITERATIONS) {\n          const label = effectName ? ` in \"${effectName}\"` : '';\n\n          throw new RippleInfiniteLoopError(`infinite effect loop (> ${DEFAULT_MAX_ITERATIONS} iterations)${label}`);\n        }\n\n        isDirty = false;\n        teardown();\n\n        if (!suppressRunEvent) getDevToolsHook()?.run?.({ name: effectName });\n\n        let returnedCleanup: CleanupFn | void = undefined;\n\n        try {\n          returnedCleanup = withTracking(\n            { cleanups: runCleanups, deps: currentDeps, effect: subscriber, kind: 'effect', subscriptions },\n            fn,\n          );\n        } catch (error) {\n          const cleanupErrors = [...collectErrors(subscriptions), ...collectErrors(runCleanups)];\n\n          runCleanups.length = 0;\n          subscriptions.clear();\n          rethrowWith(error, cleanupErrors, 'effect failure with cleanup errors');\n        }\n\n        if (returnedCleanup !== undefined && typeof returnedCleanup !== 'function') {\n          throw new RippleInvalidCleanupError(\n            `effect() returned ${typeof returnedCleanup} — expected a cleanup function or void.`,\n          );\n        }\n\n        if (typeof returnedCleanup === 'function') runCleanups.push(returnedCleanup);\n      } while (isDirty && !isDisposed);\n    } finally {\n      isRunning = false;\n    }\n  };\n\n  // subscriber is what gets registered in signal subscriber Sets.\n  // For 'sync' it is the same as run; for deferred schedulers it's the debouncing wrapper.\n  const subscriber = withScheduler(run, scheduler);\n\n  // Always run synchronously on creation to establish initial tracking.\n  run();\n\n  const sub = new SubscriptionImpl(() => {\n    if (isDisposed) return;\n\n    isDisposed = true;\n    teardown();\n    getDevToolsHook()?.dispose?.({ kind: 'effect', name: effectName });\n  });\n\n  // Auto-register disposal into the enclosing scope (if any).\n  // Uses the separate scope stack — orthogonal to the effect/computed tracking context.\n  getScopeCleanups()?.push(() => sub.dispose());\n\n  const handle: EffectHandle = {\n    dispose: () => sub.dispose(),\n    get disposed() {\n      return sub.disposed;\n    },\n    getDependencies(): ReadonlyArray<DepInfo> {\n      return [...currentDeps.keys()].map((src) => ({\n        kind: IS_COMPUTED in (src as object) ? 'computed' : 'signal',\n        name: src.name,\n      }));\n    },\n    [Symbol.dispose]() {\n      sub.dispose();\n    },\n  };\n\n  return handle;\n};\n\n/**\n * Like `effect()`, but the callback is async and receives an AbortSignal that fires when the\n * effect re-runs or is disposed. Read reactive dependencies synchronously before the first\n * `await` to register them as tracked.\n *\n * Returns an {@link AsyncSubscription} — call `await stop[Symbol.asyncDispose]()` to await\n * full teardown, or `stop.run()` to await just the current in-flight run.\n *\n * @example\n * ```ts\n * const userId = signal('u1');\n * const stop = effectAsync(async (signal) => {\n *   const id = userId.value;            // sync dep — tracked\n *   const data = await fetchUser(id, { signal }); // aborted automatically if id changes\n *   renderUser(data);\n * });\n *\n * await stop[Symbol.asyncDispose]();\n * ```\n */\nexport const effectAsync = (fn: AsyncEffectCallback, options?: EffectAsyncOptions): AsyncSubscription => {\n  let controller: AbortController | null = null;\n  let asyncCleanup: CleanupFn | null = null;\n  let currentRunPromise: Promise<void> | null = null;\n\n  const onError =\n    options?.onError ??\n    ((err: unknown) => {\n      queueMicrotask(() => {\n        throw err;\n      });\n    });\n\n  const syncStop = effect(\n    () => {\n      controller?.abort();\n      asyncCleanup?.();\n      asyncCleanup = null;\n\n      controller = new AbortController();\n\n      const { signal } = controller;\n      const runOwner = scope(); // per-run owner scope for async body resources\n\n      let theRun!: Promise<void>;\n\n      currentRunPromise = theRun = (async () => {\n        try {\n          const returned = await fn(signal, runOwner);\n\n          if (typeof returned === 'function') {\n            if (signal.aborted) {\n              // Aborted while async fn was running — run cleanup immediately.\n              returned();\n            } else {\n              asyncCleanup = returned;\n            }\n          }\n        } catch (err) {\n          if (!signal.aborted) onError(err);\n        } finally {\n          runOwner.dispose();\n\n          if (currentRunPromise === theRun) currentRunPromise = null;\n        }\n      })();\n\n      return () => {\n        controller?.abort();\n        asyncCleanup?.();\n        asyncCleanup = null;\n      };\n    },\n    { name: options?.name },\n  );\n\n  return new AsyncSubscriptionImpl(\n    syncStop,\n    async () => {\n      const runningPromise = currentRunPromise;\n\n      if (runningPromise) await runningPromise;\n    },\n    () => currentRunPromise,\n  );\n};\n\nexport const onCleanup = (fn: CleanupFn): void => {\n  const ctx = getTracking();\n\n  if (ctx?.kind === 'effect') {\n    ctx.cleanups.push(fn);\n\n    return;\n  }\n\n  const scopeCleanups = getScopeCleanups();\n\n  if (scopeCleanups !== null) {\n    scopeCleanups.push(fn);\n\n    return;\n  }\n\n  throw new RippleInvalidCleanupError('onCleanup() must be called from within an active effect or scope.');\n};\n\n/**\n * Creates a lifecycle scope that collects `onCleanup()` registrations and runs\n * them in reverse order when `dispose()` is called.\n *\n * The optional `setup` callback is run immediately inside the scope so that\n * `onCleanup()` calls in setup are captured without requiring a separate\n * `scope.run(setup)` call.\n *\n * Use `scope.add(fn)` to explicitly register a cleanup into this scope from\n * anywhere — including from inside an effect body where `onCleanup()` would otherwise\n * go to the effect's own cleanup queue.\n *\n * @example\n * ```ts\n * const s = scope(() => {\n *   onCleanup(() => expensiveCleanup()); // captured by scope\n * });\n *\n * const stop = effect(() => {\n *   void count.value;\n *   s.add(() => doWork()); // explicit: goes to scope, not effect\n *   onCleanup(() => cheapCleanup()); // goes to effect\n * });\n *\n * // later:\n * s.dispose(); // or: using s = scope(...)\n * ```\n */\nexport const scope = (setup?: () => void): Scope => {\n  const cleanups: CleanupFn[] = [];\n  const ac = new AbortController();\n  let disposed = false;\n\n  const scopeOnCleanup = (fn: CleanupFn): void => {\n    if (disposed) throw new RippleDisposedScopeError('Cannot register cleanup on a disposed scope.');\n\n    cleanups.push(fn);\n  };\n\n  const run = <T>(fn: () => T): T => {\n    if (disposed) throw new RippleDisposedScopeError('Cannot run inside a disposed scope.');\n\n    return withScopeCleanups(cleanups, fn);\n  };\n\n  const dispose = (): void => {\n    if (disposed) return;\n\n    disposed = true;\n    ac.abort();\n    runAll([...cleanups].reverse(), 'scope cleanup errors');\n    cleanups.length = 0;\n  };\n\n  const api: Scope = {\n    add: scopeOnCleanup,\n    get disposalSignal() {\n      return ac.signal;\n    },\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    run,\n    [Symbol.dispose]: dispose,\n  };\n\n  if (setup) run(setup);\n\n  return api;\n};\n\n// ── watch() ───────────────────────────────────────────────────────────────────\n\n/**\n * Observes a reactive source and calls `callback` whenever its value changes.\n * Does NOT invoke `callback` on creation (unless `immediate: true` is passed).\n *\n * `source` may be a single `Readable<T>` (signal, computed, or store lens), or a\n * function that reads multiple reactive sources — the function form tracks every\n * dependency read inside it, like `computed()`, without needing an intermediate\n * `computed()` node.\n *\n * When called without `immediate`, `prev` is always `T` — the previous value.\n * When `immediate: true` is passed, `prev` is `T | undefined` on the first call.\n *\n * @example\n * ```ts\n * const stop = watch(count, (next, prev) => {\n *   console.log(`count changed: ${prev} → ${next}`);\n * });\n *\n * stop.dispose();\n * ```\n *\n * @example\n * ```ts\n * // Function form — tracks every signal read inside, re-runs when any changes.\n * const stopSum = watch(\n *   () => a.value + b.value,\n *   (sum, prevSum) => console.log(`sum: ${prevSum} → ${sum}`),\n * );\n *\n * stopSum.dispose();\n * ```\n */\nexport function watch<T>(\n  source: Readable<T>,\n  callback: (value: T, prev: T | undefined) => CleanupFn | void,\n  options?: WatchOptions<T>,\n): Subscription;\nexport function watch<T>(\n  source: () => T,\n  callback: (value: T, prev: T | undefined) => CleanupFn | void,\n  options?: WatchOptions<T>,\n): Subscription;\nexport function watch<T>(\n  source: Readable<T> | (() => T),\n  callback: (value: T, prev: T | undefined) => CleanupFn | void,\n  options?: WatchOptions<T>,\n): Subscription {\n  const equals: EqualityFn<T> = options?.equals ?? Object.is;\n  let pendingCleanup: CleanupFn | undefined;\n  const invokeCallback = (next: T, p: T | undefined): void => {\n    pendingCleanup?.();\n    pendingCleanup = undefined;\n\n    const returned = callback(next, p);\n\n    if (returned !== undefined && typeof returned !== 'function') {\n      throw new RippleInvalidCleanupError(\n        `watch() callback returned ${typeof returned} — expected a cleanup function or void.`,\n      );\n    }\n\n    if (typeof returned === 'function') pendingCleanup = returned;\n  };\n\n  // Declared before the subscriber/effect closures so both they and the immediate\n  // path can call watchSub.dispose() when once:true. Subscribers/effects always\n  // (re-)run after watchSub is assigned, since it's assigned synchronously right after.\n\n  let watchSub!: SubscriptionImpl;\n\n  if (typeof source === 'function') {\n    // Function form — track every dependency read inside `source` via a real effect,\n    // mirroring computed()'s dependency collection. `first` suppresses the callback\n    // on the initial (tracking-establishing) run — handled explicitly below (after\n    // watchSub exists) instead of inside this synchronous first run, since effect()\n    // runs its body immediately and watchSub isn't assigned until after it returns.\n    let prev!: T;\n    let first = true;\n\n    const stopEffect = effect(\n      () => {\n        const next = source();\n\n        if (first) {\n          first = false;\n          prev = next;\n\n          return;\n        }\n\n        if (!equals(prev, next)) {\n          const p = prev;\n\n          prev = next;\n          invokeCallback(next, p);\n\n          if (options?.once) watchSub.dispose();\n        }\n      },\n      { name: options?.name },\n    );\n\n    watchSub = new SubscriptionImpl(() => {\n      pendingCleanup?.();\n      pendingCleanup = undefined;\n      stopEffect.dispose();\n    });\n\n    if (options?.immediate) {\n      invokeCallback(prev, undefined);\n\n      if (options.once) watchSub.dispose();\n    }\n  } else {\n    let prev: T = source.peek();\n\n    const innerSub = source.subscribe(() => {\n      const next = source.peek();\n\n      if (!equals(prev, next)) {\n        invokeCallback(next, prev);\n        prev = next;\n\n        if (options?.once) watchSub.dispose();\n      }\n    });\n\n    watchSub = new SubscriptionImpl(() => {\n      pendingCleanup?.();\n      pendingCleanup = undefined;\n      innerSub.dispose();\n    });\n\n    if (options?.immediate) {\n      invokeCallback(prev, undefined);\n\n      if (options.once) watchSub.dispose();\n    }\n  }\n\n  // Auto-register disposal into the enclosing scope (if any) — matches effect() behaviour.\n  getScopeCleanups()?.push(() => watchSub.dispose());\n\n  return watchSub;\n}\n"],"mappings":"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"}

package/dist/effect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effect.d.ts","sourceRoot":"","sources":["../src/effect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EAET,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,aAAa,EAEb,QAAQ,EACR,KAAK,EAEL,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AAoCjB;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,MAAM,GAAI,IAAI,cAAc,EAAE,UAAU,aAAa,KAAG,YAoHpE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,GAAI,IAAI,mBAAmB,EAAE,UAAU,kBAAkB,KAAG,iBAiEnF,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,IAAI,SAAS,KAAG,IAkBzC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,KAAK,GAAI,QAAQ,MAAM,IAAI,KAAG,KA0C1C,CAAC;AAIF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,KAAK,CAAC,CAAC,EACrB,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,SAAS,GAAG,IAAI,EAC7D,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACxB,YAAY,CAAC;AAChB,wBAAgB,KAAK,CAAC,CAAC,EACrB,MAAM,EAAE,MAAM,CAAC,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,SAAS,GAAG,IAAI,EAC7D,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACxB,YAAY,CAAC"}
+{"version":3,"file":"effect.d.ts","sourceRoot":"","sources":["../src/effect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EAET,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,aAAa,EAEb,QAAQ,EACR,KAAK,EAEL,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AAqCjB;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,MAAM,GAAI,IAAI,cAAc,EAAE,UAAU,aAAa,KAAG,YA0HpE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,GAAI,IAAI,mBAAmB,EAAE,UAAU,kBAAkB,KAAG,iBAiEnF,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,IAAI,SAAS,KAAG,IAkBzC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,KAAK,GAAI,QAAQ,MAAM,IAAI,KAAG,KA0C1C,CAAC;AAIF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,KAAK,CAAC,CAAC,EACrB,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,SAAS,GAAG,IAAI,EAC7D,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACxB,YAAY,CAAC;AAChB,wBAAgB,KAAK,CAAC,CAAC,EACrB,MAAM,EAAE,MAAM,CAAC,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,SAAS,GAAG,IAAI,EAC7D,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACxB,YAAY,CAAC"}