@vielzeug/ripple 2.3.0 → 3.0.0

package/README.md

@@ -1,23 +1,21 @@
 # @vielzeug/ripple
 
-Framework-agnostic reactive graphs. Zero dependencies. ESM and CJS.
+> Reactive runtime primitives: signals, derived values, effects, scopes, watchers, and async resources
 
 ## Installation
 
 ```sh
 pnpm add @vielzeug/ripple
+npm install @vielzeug/ripple
+yarn add @vielzeug/ripple
 ```
 
-## Reactive graph
+## Quick Start
 
 ```ts
 import { createRipple } from '@vielzeug/ripple';
 
-const ripple = createRipple({
-  onError(error, context) {
-    console.error(context.kind, error);
-  },
-});
+const ripple = createRipple();
 
 const count = ripple.signal(0);
 const doubled = ripple.computed(() => count.value * 2);
@@ -32,34 +30,14 @@ stop.dispose();
 ripple.dispose();
 ```
 
-`ripple.dispose()` is terminal: create a new graph instead of reusing a disposed one. Use default exports (`signal`, `computed`, `effect`, `batch`, `watch`, `resource`) only when application has one graph for full lifetime.
-
-## Bound helpers
-
-Every `Ripple` instance provides bound helpers:
-
-```ts
-const user = ripple.resource(() => userId.value, loadUser);
-const cart = ripple.signal({ items: 0 });
-const stop = ripple.watch(() => cart.value.items, renderItems);
-```
-
-Resource source and loader failures are handled through `resource.value.status === 'error'`; `onError` receives broken runtime callbacks, cleanup, listeners, and observers.
-
-Nested effects and resources created inside an effect automatically dispose before parent effect reruns:
-
-```ts
-ripple.effect(() => {
-  ripple.effect(() => render())
-})
-```
-
 ## Documentation
 
 - [Overview](https://vielzeug.dev/ripple/)
-- [Usage guide](https://vielzeug.dev/ripple/usage)
-- [API reference](https://vielzeug.dev/ripple/api)
+- [Usage Guide](https://vielzeug.dev/ripple/usage)
+- [API Reference](https://vielzeug.dev/ripple/api)
+- [Examples](https://vielzeug.dev/ripple/examples)
+- [Migration Guide](https://vielzeug.dev/ripple/migration)
 
 ## License
 
-MIT © Helmuth Saatkamp
+MIT © [Helmuth Saatkamp](https://github.com/helmuthdu) — part of the [Vielzeug](https://github.com/helmuthdu/vielzeug) monorepo.

package/dist/_async.cjs

@@ -1,2 +1,2 @@
-const e=require("./runtime.cjs");var t=t=>(n,r,i)=>{let a=t.signal({status:`pending`},{name:i?.name}),o=t.signal(0),s,c=()=>{o.value,s?.abort();let e=a.peek(),t=e.status===`success`?e.value:`previous`in e?e.previous:void 0,i;try{i=n()}catch(e){a.value=t===void 0?{error:e,status:`error`}:{error:e,previous:t,status:`error`};return}let c=new AbortController;s=c,a.value=t===void 0?{status:`pending`}:{previous:t,status:`pending`};let u;try{u=Promise.resolve(r(i,{signal:c.signal}))}catch(e){u=Promise.reject(e)}u.then(e=>{!l.disposed&&!c.signal.aborted&&(a.value={status:`success`,value:e})},e=>{!l.disposed&&!c.signal.aborted&&(a.value=t===void 0?{error:e,status:`error`}:{error:e,previous:t,status:`error`})})},l=t.effect(()=>(c(),()=>s?.abort()),{name:i?.name}),u={get disposalSignal(){return l.disposalSignal},dispose:()=>l.dispose(),get disposed(){return l.disposed},get name(){return a.name},peek:()=>a.peek(),reload:()=>{l.disposed||(o.value=o.peek()+1)},subscribe:e=>a.subscribe(e),[Symbol.dispose](){this.dispose()},get value(){return a.value}};return Object.defineProperty(u,e.REACTIVE,{value:!0}),u};exports.createResource=t;
+const e=require("./errors.cjs"),t=require("./runtime.cjs");var n=n=>(r,i,a)=>{let o=n.signal({status:`pending`},{name:a?.name}),s=n.signal(0),c,l=!1,u,d=()=>{s.value,c?.abort();let e;try{e=r()}catch(e){o.value=l?{error:e,previous:u,status:`error`}:{error:e,status:`error`};return}let t=new AbortController;c=t,o.value=l?{previous:u,status:`pending`}:{status:`pending`};let n;try{n=Promise.resolve(i(e,{signal:t.signal}))}catch(e){n=Promise.reject(e)}n.then(e=>{!f.disposed&&!t.signal.aborted&&(l=!0,u=e,o.value={status:`success`,value:e})},e=>{!f.disposed&&!t.signal.aborted&&(o.value=l?{error:e,previous:u,status:`error`}:{error:e,status:`error`})})},f=n.effect(()=>(d(),()=>c?.abort()),{name:a?.name}),p=()=>{if(f.disposed)throw new e.RippleDisposedResourceError(`Cannot use a disposed resource.`)},m={get disposalSignal(){return f.disposalSignal},dispose:()=>f.dispose(),get disposed(){return f.disposed},get name(){return o.name},peek:()=>o.peek(),reload:()=>{p(),s.value=s.peek()+1},subscribe:e=>(p(),o.subscribe(e)),[Symbol.dispose](){this.dispose()},get value(){return o.value}};return Object.defineProperty(m,t.REACTIVE,{value:!0}),m};exports.createResource=n;
 //# sourceMappingURL=_async.cjs.map

package/dist/_async.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"_async.cjs","names":[],"sources":["../src/_async.ts"],"sourcesContent":["import { REACTIVE } from './runtime';\nimport type { Disposable, EffectHandle, Readable, Signal } from './types';\n\nexport type AsyncState<T> =\n  | { readonly previous?: T; readonly status: 'pending' }\n  | { readonly status: 'success'; readonly value: T }\n  | { readonly error: unknown; readonly previous?: T; readonly status: 'error' };\n\nexport interface Resource<T> extends Readable<AsyncState<T>>, Disposable {\n  reload(): void;\n}\n\nexport type ResourceOptions = {\n  name?: string;\n};\n\ntype AsyncRuntime = {\n  effect(callback: () => undefined | (() => void), options?: { name?: string }): EffectHandle;\n  signal<T>(initial: T, options?: { name?: string }): Signal<T>;\n};\n\n/** Resource only depends on primitive runtime methods; graph binding stays private. */\nexport const createResource =\n  (runtime: AsyncRuntime) =>\n  <Source, Value>(\n    source: () => Source,\n    loader: (source: Source, context: { readonly signal: AbortSignal }) => Promise<Value>,\n    options?: ResourceOptions,\n  ): Resource<Value> => {\n    const state = runtime.signal<AsyncState<Value>>({ status: 'pending' }, { name: options?.name });\n    const reloadEpoch = runtime.signal(0);\n    let active: AbortController | undefined;\n\n    const run = (): void => {\n      void reloadEpoch.value;\n      active?.abort();\n\n      const current = state.peek();\n      const previous =\n        current.status === 'success' ? current.value : 'previous' in current ? current.previous : undefined;\n      let input: Source;\n\n      try {\n        input = source();\n      } catch (error) {\n        state.value = previous === undefined ? { error, status: 'error' } : { error, previous, status: 'error' };\n\n        return;\n      }\n\n      const next = new AbortController();\n\n      active = next;\n      state.value = previous === undefined ? { status: 'pending' } : { previous, status: 'pending' };\n\n      let request: Promise<Value>;\n\n      try {\n        request = Promise.resolve(loader(input, { signal: next.signal }));\n      } catch (error) {\n        request = Promise.reject(error);\n      }\n\n      void request.then(\n        (value) => {\n          if (!stop.disposed && !next.signal.aborted) state.value = { status: 'success', value };\n        },\n        (error: unknown) => {\n          if (!stop.disposed && !next.signal.aborted) {\n            state.value = previous === undefined ? { error, status: 'error' } : { error, previous, status: 'error' };\n          }\n        },\n      );\n    };\n\n    const stop = runtime.effect(\n      () => {\n        run();\n\n        return () => active?.abort();\n      },\n      { name: options?.name },\n    );\n\n    const resource: Resource<Value> = {\n      get disposalSignal() {\n        return stop.disposalSignal;\n      },\n      dispose: () => stop.dispose(),\n      get disposed() {\n        return stop.disposed;\n      },\n      get name() {\n        return state.name;\n      },\n      peek: () => state.peek(),\n      reload: () => {\n        if (stop.disposed) return;\n\n        reloadEpoch.value = reloadEpoch.peek() + 1;\n      },\n      subscribe: (listener) => state.subscribe(listener),\n      [Symbol.dispose]() {\n        this.dispose();\n      },\n      get value() {\n        return state.value;\n      },\n    };\n\n    Object.defineProperty(resource, REACTIVE, { value: true });\n\n    return resource;\n  };\n"],"mappings":"iCAsBA,IAAa,EACV,IAEC,EACA,EACA,IACoB,CACpB,IAAM,EAAQ,EAAQ,OAA0B,CAAE,OAAQ,SAAU,EAAG,CAAE,KAAM,GAAS,IAAK,CAAC,EACxF,EAAc,EAAQ,OAAO,CAAC,EAChC,EAEE,MAAkB,CACtB,EAAiB,MACjB,GAAQ,MAAM,EAEd,IAAM,EAAU,EAAM,KAAK,EACrB,EACJ,EAAQ,SAAW,UAAY,EAAQ,MAAQ,aAAc,EAAU,EAAQ,SAAW,IAAA,GACxF,EAEJ,GAAI,CACF,EAAQ,EAAO,CACjB,OAAS,EAAO,CACd,EAAM,MAAQ,IAAa,IAAA,GAAY,CAAE,QAAO,OAAQ,OAAQ,EAAI,CAAE,QAAO,WAAU,OAAQ,OAAQ,EAEvG,MACF,CAEA,IAAM,EAAO,IAAI,gBAEjB,EAAS,EACT,EAAM,MAAQ,IAAa,IAAA,GAAY,CAAE,OAAQ,SAAU,EAAI,CAAE,WAAU,OAAQ,SAAU,EAE7F,IAAI,EAEJ,GAAI,CACF,EAAU,QAAQ,QAAQ,EAAO,EAAO,CAAE,OAAQ,EAAK,MAAO,CAAC,CAAC,CAClE,OAAS,EAAO,CACd,EAAU,QAAQ,OAAO,CAAK,CAChC,CAEA,EAAa,KACV,GAAU,CACL,CAAC,EAAK,UAAY,CAAC,EAAK,OAAO,UAAS,EAAM,MAAQ,CAAE,OAAQ,UAAW,OAAM,EACvF,EACC,GAAmB,CACd,CAAC,EAAK,UAAY,CAAC,EAAK,OAAO,UACjC,EAAM,MAAQ,IAAa,IAAA,GAAY,CAAE,QAAO,OAAQ,OAAQ,EAAI,CAAE,QAAO,WAAU,OAAQ,OAAQ,EAE3G,CACF,CACF,EAEM,EAAO,EAAQ,YAEjB,EAAI,MAES,GAAQ,MAAM,GAE7B,CAAE,KAAM,GAAS,IAAK,CACxB,EAEM,EAA4B,CAChC,IAAI,gBAAiB,CACnB,OAAO,EAAK,cACd,EACA,YAAe,EAAK,QAAQ,EAC5B,IAAI,UAAW,CACb,OAAO,EAAK,QACd,EACA,IAAI,MAAO,CACT,OAAO,EAAM,IACf,EACA,SAAY,EAAM,KAAK,EACvB,WAAc,CACR,EAAK,WAET,EAAY,MAAQ,EAAY,KAAK,EAAI,EAC3C,EACA,UAAY,GAAa,EAAM,UAAU,CAAQ,EACjD,CAAC,OAAO,UAAW,CACjB,KAAK,QAAQ,CACf,EACA,IAAI,OAAQ,CACV,OAAO,EAAM,KACf,CACF,EAIA,OAFA,OAAO,eAAe,EAAU,EAAA,SAAU,CAAE,MAAO,EAAK,CAAC,EAElD,CACT"}
+{"version":3,"file":"_async.cjs","names":[],"sources":["../src/_async.ts"],"sourcesContent":["import { RippleDisposedResourceError } from './errors';\nimport { REACTIVE } from './runtime';\nimport type { Disposable, EffectHandle, Readable, Signal } from './types';\n\nexport type AsyncState<T> =\n  | { readonly previous?: T; readonly status: 'pending' }\n  | { readonly status: 'success'; readonly value: T }\n  | { readonly error: unknown; readonly previous?: T; readonly status: 'error' };\n\nexport interface Resource<T> extends Readable<AsyncState<T>>, Disposable {\n  reload(): void;\n}\n\nexport type ResourceOptions = {\n  name?: string;\n};\n\ntype AsyncRuntime = {\n  effect(callback: () => undefined | (() => void), options?: { name?: string }): EffectHandle;\n  signal<T>(initial: T, options?: { name?: string }): Signal<T>;\n};\n\n/** Resource only depends on primitive runtime methods; graph binding stays private. */\nexport const createResource =\n  (runtime: AsyncRuntime) =>\n  <Source, Value>(\n    source: () => Source,\n    loader: (source: Source, context: { readonly signal: AbortSignal }) => Promise<Value>,\n    options?: ResourceOptions,\n  ): Resource<Value> => {\n    const state = runtime.signal<AsyncState<Value>>({ status: 'pending' }, { name: options?.name });\n    const reloadEpoch = runtime.signal(0);\n    let active: AbortController | undefined;\n    let hasPrevious = false;\n    let previousValue: Value | undefined;\n\n    const run = (): void => {\n      void reloadEpoch.value;\n      active?.abort();\n\n      let input: Source;\n\n      try {\n        input = source();\n      } catch (error) {\n        state.value = hasPrevious\n          ? { error, previous: previousValue as Value, status: 'error' }\n          : { error, status: 'error' };\n\n        return;\n      }\n\n      const next = new AbortController();\n\n      active = next;\n      state.value = hasPrevious ? { previous: previousValue as Value, status: 'pending' } : { status: 'pending' };\n\n      let request: Promise<Value>;\n\n      try {\n        request = Promise.resolve(loader(input, { signal: next.signal }));\n      } catch (error) {\n        request = Promise.reject(error);\n      }\n\n      void request.then(\n        (value) => {\n          if (!stop.disposed && !next.signal.aborted) {\n            hasPrevious = true;\n            previousValue = value;\n            state.value = { status: 'success', value };\n          }\n        },\n        (error: unknown) => {\n          if (!stop.disposed && !next.signal.aborted) {\n            state.value = hasPrevious\n              ? { error, previous: previousValue as Value, status: 'error' }\n              : { error, status: 'error' };\n          }\n        },\n      );\n    };\n\n    const stop = runtime.effect(\n      () => {\n        run();\n\n        return () => active?.abort();\n      },\n      { name: options?.name },\n    );\n\n    const assertActive = (): void => {\n      if (stop.disposed) throw new RippleDisposedResourceError('Cannot use a disposed resource.');\n    };\n    const resource: Resource<Value> = {\n      get disposalSignal() {\n        return stop.disposalSignal;\n      },\n      dispose: () => stop.dispose(),\n      get disposed() {\n        return stop.disposed;\n      },\n      get name() {\n        return state.name;\n      },\n      peek: () => state.peek(),\n      reload: () => {\n        assertActive();\n        reloadEpoch.value = reloadEpoch.peek() + 1;\n      },\n      subscribe: (listener) => {\n        assertActive();\n        return state.subscribe(listener);\n      },\n      [Symbol.dispose]() {\n        this.dispose();\n      },\n      get value() {\n        return state.value;\n      },\n    };\n\n    Object.defineProperty(resource, REACTIVE, { value: true });\n\n    return resource;\n  };\n"],"mappings":"2DAuBA,IAAa,EACV,IAEC,EACA,EACA,IACoB,CACpB,IAAM,EAAQ,EAAQ,OAA0B,CAAE,OAAQ,SAAU,EAAG,CAAE,KAAM,GAAS,IAAK,CAAC,EACxF,EAAc,EAAQ,OAAO,CAAC,EAChC,EACA,EAAc,GACd,EAEE,MAAkB,CACtB,EAAiB,MACjB,GAAQ,MAAM,EAEd,IAAI,EAEJ,GAAI,CACF,EAAQ,EAAO,CACjB,OAAS,EAAO,CACd,EAAM,MAAQ,EACV,CAAE,QAAO,SAAU,EAAwB,OAAQ,OAAQ,EAC3D,CAAE,QAAO,OAAQ,OAAQ,EAE7B,MACF,CAEA,IAAM,EAAO,IAAI,gBAEjB,EAAS,EACT,EAAM,MAAQ,EAAc,CAAE,SAAU,EAAwB,OAAQ,SAAU,EAAI,CAAE,OAAQ,SAAU,EAE1G,IAAI,EAEJ,GAAI,CACF,EAAU,QAAQ,QAAQ,EAAO,EAAO,CAAE,OAAQ,EAAK,MAAO,CAAC,CAAC,CAClE,OAAS,EAAO,CACd,EAAU,QAAQ,OAAO,CAAK,CAChC,CAEA,EAAa,KACV,GAAU,CACL,CAAC,EAAK,UAAY,CAAC,EAAK,OAAO,UACjC,EAAc,GACd,EAAgB,EAChB,EAAM,MAAQ,CAAE,OAAQ,UAAW,OAAM,EAE7C,EACC,GAAmB,CACd,CAAC,EAAK,UAAY,CAAC,EAAK,OAAO,UACjC,EAAM,MAAQ,EACV,CAAE,QAAO,SAAU,EAAwB,OAAQ,OAAQ,EAC3D,CAAE,QAAO,OAAQ,OAAQ,EAEjC,CACF,CACF,EAEM,EAAO,EAAQ,YAEjB,EAAI,MAES,GAAQ,MAAM,GAE7B,CAAE,KAAM,GAAS,IAAK,CACxB,EAEM,MAA2B,CAC/B,GAAI,EAAK,SAAU,MAAM,IAAI,EAAA,4BAA4B,iCAAiC,CAC5F,EACM,EAA4B,CAChC,IAAI,gBAAiB,CACnB,OAAO,EAAK,cACd,EACA,YAAe,EAAK,QAAQ,EAC5B,IAAI,UAAW,CACb,OAAO,EAAK,QACd,EACA,IAAI,MAAO,CACT,OAAO,EAAM,IACf,EACA,SAAY,EAAM,KAAK,EACvB,WAAc,CACZ,EAAa,EACb,EAAY,MAAQ,EAAY,KAAK,EAAI,CAC3C,EACA,UAAY,IACV,EAAa,EACN,EAAM,UAAU,CAAQ,GAEjC,CAAC,OAAO,UAAW,CACjB,KAAK,QAAQ,CACf,EACA,IAAI,OAAQ,CACV,OAAO,EAAM,KACf,CACF,EAIA,OAFA,OAAO,eAAe,EAAU,EAAA,SAAU,CAAE,MAAO,EAAK,CAAC,EAElD,CACT"}

package/dist/_async.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_async.d.ts","sourceRoot":"","sources":["../src/_async.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAE1E,MAAM,MAAM,UAAU,CAAC,CAAC,IACpB;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAEjF,MAAM,WAAW,QAAQ,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU;IACtE,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,MAAM,CAAC,QAAQ,EAAE,MAAM,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY,CAAC;IAC5F,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;CAC/D,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,cAAc,GACxB,SAAS,YAAY,MACrB,MAAM,EAAE,KAAK,EACZ,QAAQ,MAAM,MAAM,EACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,KAAK,OAAO,CAAC,KAAK,CAAC,EACrF,UAAU,eAAe,KACxB,QAAQ,CAAC,KAAK,CAqFhB,CAAC"}
+{"version":3,"file":"_async.d.ts","sourceRoot":"","sources":["../src/_async.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAE1E,MAAM,MAAM,UAAU,CAAC,CAAC,IACpB;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAEjF,MAAM,WAAW,QAAQ,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU;IACtE,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,MAAM,CAAC,QAAQ,EAAE,MAAM,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY,CAAC;IAC5F,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;CAC/D,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,cAAc,GACxB,SAAS,YAAY,MACrB,MAAM,EAAE,KAAK,EACZ,QAAQ,MAAM,MAAM,EACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,KAAK,OAAO,CAAC,KAAK,CAAC,EACrF,UAAU,eAAe,KACxB,QAAQ,CAAC,KAAK,CAiGhB,CAAC"}

package/dist/_async.js

@@ -1,74 +1,77 @@
-import { REACTIVE as e } from "./runtime.js";
+import { RippleDisposedResourceError as e } from "./errors.js";
+import { REACTIVE as t } from "./runtime.js";
 //#region src/_async.ts
-var t = (t) => (n, r, i) => {
-	let a = t.signal({ status: "pending" }, { name: i?.name }), o = t.signal(0), s, c = () => {
-		o.value, s?.abort();
-		let e = a.peek(), t = e.status === "success" ? e.value : "previous" in e ? e.previous : void 0, i;
+var n = (n) => (r, i, a) => {
+	let o = n.signal({ status: "pending" }, { name: a?.name }), s = n.signal(0), c, l = !1, u, d = () => {
+		s.value, c?.abort();
+		let e;
 		try {
-			i = n();
+			e = r();
 		} catch (e) {
-			a.value = t === void 0 ? {
+			o.value = l ? {
 				error: e,
+				previous: u,
 				status: "error"
 			} : {
 				error: e,
-				previous: t,
 				status: "error"
 			};
 			return;
 		}
-		let c = new AbortController();
-		s = c, a.value = t === void 0 ? { status: "pending" } : {
-			previous: t,
+		let t = new AbortController();
+		c = t, o.value = l ? {
+			previous: u,
 			status: "pending"
-		};
-		let u;
+		} : { status: "pending" };
+		let n;
 		try {
-			u = Promise.resolve(r(i, { signal: c.signal }));
+			n = Promise.resolve(i(e, { signal: t.signal }));
 		} catch (e) {
-			u = Promise.reject(e);
+			n = Promise.reject(e);
 		}
-		u.then((e) => {
-			!l.disposed && !c.signal.aborted && (a.value = {
+		n.then((e) => {
+			!f.disposed && !t.signal.aborted && (l = !0, u = e, o.value = {
 				status: "success",
 				value: e
 			});
 		}, (e) => {
-			!l.disposed && !c.signal.aborted && (a.value = t === void 0 ? {
+			!f.disposed && !t.signal.aborted && (o.value = l ? {
 				error: e,
+				previous: u,
 				status: "error"
 			} : {
 				error: e,
-				previous: t,
 				status: "error"
 			});
 		});
-	}, l = t.effect(() => (c(), () => s?.abort()), { name: i?.name }), u = {
+	}, f = n.effect(() => (d(), () => c?.abort()), { name: a?.name }), p = () => {
+		if (f.disposed) throw new e("Cannot use a disposed resource.");
+	}, m = {
 		get disposalSignal() {
-			return l.disposalSignal;
+			return f.disposalSignal;
 		},
-		dispose: () => l.dispose(),
+		dispose: () => f.dispose(),
 		get disposed() {
-			return l.disposed;
+			return f.disposed;
 		},
 		get name() {
-			return a.name;
+			return o.name;
 		},
-		peek: () => a.peek(),
+		peek: () => o.peek(),
 		reload: () => {
-			l.disposed || (o.value = o.peek() + 1);
+			p(), s.value = s.peek() + 1;
 		},
-		subscribe: (e) => a.subscribe(e),
+		subscribe: (e) => (p(), o.subscribe(e)),
 		[Symbol.dispose]() {
 			this.dispose();
 		},
 		get value() {
-			return a.value;
+			return o.value;
 		}
 	};
-	return Object.defineProperty(u, e, { value: !0 }), u;
+	return Object.defineProperty(m, t, { value: !0 }), m;
 };
 //#endregion
-export { t as createResource };
+export { n as createResource };
 
 //# sourceMappingURL=_async.js.map

package/dist/_async.js.map

@@ -1 +1 @@
-{"version":3,"file":"_async.js","names":[],"sources":["../src/_async.ts"],"sourcesContent":["import { REACTIVE } from './runtime';\nimport type { Disposable, EffectHandle, Readable, Signal } from './types';\n\nexport type AsyncState<T> =\n  | { readonly previous?: T; readonly status: 'pending' }\n  | { readonly status: 'success'; readonly value: T }\n  | { readonly error: unknown; readonly previous?: T; readonly status: 'error' };\n\nexport interface Resource<T> extends Readable<AsyncState<T>>, Disposable {\n  reload(): void;\n}\n\nexport type ResourceOptions = {\n  name?: string;\n};\n\ntype AsyncRuntime = {\n  effect(callback: () => undefined | (() => void), options?: { name?: string }): EffectHandle;\n  signal<T>(initial: T, options?: { name?: string }): Signal<T>;\n};\n\n/** Resource only depends on primitive runtime methods; graph binding stays private. */\nexport const createResource =\n  (runtime: AsyncRuntime) =>\n  <Source, Value>(\n    source: () => Source,\n    loader: (source: Source, context: { readonly signal: AbortSignal }) => Promise<Value>,\n    options?: ResourceOptions,\n  ): Resource<Value> => {\n    const state = runtime.signal<AsyncState<Value>>({ status: 'pending' }, { name: options?.name });\n    const reloadEpoch = runtime.signal(0);\n    let active: AbortController | undefined;\n\n    const run = (): void => {\n      void reloadEpoch.value;\n      active?.abort();\n\n      const current = state.peek();\n      const previous =\n        current.status === 'success' ? current.value : 'previous' in current ? current.previous : undefined;\n      let input: Source;\n\n      try {\n        input = source();\n      } catch (error) {\n        state.value = previous === undefined ? { error, status: 'error' } : { error, previous, status: 'error' };\n\n        return;\n      }\n\n      const next = new AbortController();\n\n      active = next;\n      state.value = previous === undefined ? { status: 'pending' } : { previous, status: 'pending' };\n\n      let request: Promise<Value>;\n\n      try {\n        request = Promise.resolve(loader(input, { signal: next.signal }));\n      } catch (error) {\n        request = Promise.reject(error);\n      }\n\n      void request.then(\n        (value) => {\n          if (!stop.disposed && !next.signal.aborted) state.value = { status: 'success', value };\n        },\n        (error: unknown) => {\n          if (!stop.disposed && !next.signal.aborted) {\n            state.value = previous === undefined ? { error, status: 'error' } : { error, previous, status: 'error' };\n          }\n        },\n      );\n    };\n\n    const stop = runtime.effect(\n      () => {\n        run();\n\n        return () => active?.abort();\n      },\n      { name: options?.name },\n    );\n\n    const resource: Resource<Value> = {\n      get disposalSignal() {\n        return stop.disposalSignal;\n      },\n      dispose: () => stop.dispose(),\n      get disposed() {\n        return stop.disposed;\n      },\n      get name() {\n        return state.name;\n      },\n      peek: () => state.peek(),\n      reload: () => {\n        if (stop.disposed) return;\n\n        reloadEpoch.value = reloadEpoch.peek() + 1;\n      },\n      subscribe: (listener) => state.subscribe(listener),\n      [Symbol.dispose]() {\n        this.dispose();\n      },\n      get value() {\n        return state.value;\n      },\n    };\n\n    Object.defineProperty(resource, REACTIVE, { value: true });\n\n    return resource;\n  };\n"],"mappings":";;AAsBA,IAAa,KACV,OAEC,GACA,GACA,MACoB;CACpB,IAAM,IAAQ,EAAQ,OAA0B,EAAE,QAAQ,UAAU,GAAG,EAAE,MAAM,GAAS,KAAK,CAAC,GACxF,IAAc,EAAQ,OAAO,CAAC,GAChC,GAEE,UAAkB;EAEtB,AADA,EAAiB,OACjB,GAAQ,MAAM;EAEd,IAAM,IAAU,EAAM,KAAK,GACrB,IACJ,EAAQ,WAAW,YAAY,EAAQ,QAAQ,cAAc,IAAU,EAAQ,WAAW,KAAA,GACxF;EAEJ,IAAI;GACF,IAAQ,EAAO;EACjB,SAAS,GAAO;GACd,EAAM,QAAQ,MAAa,KAAA,IAAY;IAAE;IAAO,QAAQ;GAAQ,IAAI;IAAE;IAAO;IAAU,QAAQ;GAAQ;GAEvG;EACF;EAEA,IAAM,IAAO,IAAI,gBAAgB;EAGjC,AADA,IAAS,GACT,EAAM,QAAQ,MAAa,KAAA,IAAY,EAAE,QAAQ,UAAU,IAAI;GAAE;GAAU,QAAQ;EAAU;EAE7F,IAAI;EAEJ,IAAI;GACF,IAAU,QAAQ,QAAQ,EAAO,GAAO,EAAE,QAAQ,EAAK,OAAO,CAAC,CAAC;EAClE,SAAS,GAAO;GACd,IAAU,QAAQ,OAAO,CAAK;EAChC;EAEA,EAAa,MACV,MAAU;GACT,AAAI,CAAC,EAAK,YAAY,CAAC,EAAK,OAAO,YAAS,EAAM,QAAQ;IAAE,QAAQ;IAAW;GAAM;EACvF,IACC,MAAmB;GAClB,AAAI,CAAC,EAAK,YAAY,CAAC,EAAK,OAAO,YACjC,EAAM,QAAQ,MAAa,KAAA,IAAY;IAAE;IAAO,QAAQ;GAAQ,IAAI;IAAE;IAAO;IAAU,QAAQ;GAAQ;EAE3G,CACF;CACF,GAEM,IAAO,EAAQ,cAEjB,EAAI,SAES,GAAQ,MAAM,IAE7B,EAAE,MAAM,GAAS,KAAK,CACxB,GAEM,IAA4B;EAChC,IAAI,iBAAiB;GACnB,OAAO,EAAK;EACd;EACA,eAAe,EAAK,QAAQ;EAC5B,IAAI,WAAW;GACb,OAAO,EAAK;EACd;EACA,IAAI,OAAO;GACT,OAAO,EAAM;EACf;EACA,YAAY,EAAM,KAAK;EACvB,cAAc;GACR,EAAK,aAET,EAAY,QAAQ,EAAY,KAAK,IAAI;EAC3C;EACA,YAAY,MAAa,EAAM,UAAU,CAAQ;EACjD,CAAC,OAAO,WAAW;GACjB,KAAK,QAAQ;EACf;EACA,IAAI,QAAQ;GACV,OAAO,EAAM;EACf;CACF;CAIA,OAFA,OAAO,eAAe,GAAU,GAAU,EAAE,OAAO,GAAK,CAAC,GAElD;AACT"}
+{"version":3,"file":"_async.js","names":[],"sources":["../src/_async.ts"],"sourcesContent":["import { RippleDisposedResourceError } from './errors';\nimport { REACTIVE } from './runtime';\nimport type { Disposable, EffectHandle, Readable, Signal } from './types';\n\nexport type AsyncState<T> =\n  | { readonly previous?: T; readonly status: 'pending' }\n  | { readonly status: 'success'; readonly value: T }\n  | { readonly error: unknown; readonly previous?: T; readonly status: 'error' };\n\nexport interface Resource<T> extends Readable<AsyncState<T>>, Disposable {\n  reload(): void;\n}\n\nexport type ResourceOptions = {\n  name?: string;\n};\n\ntype AsyncRuntime = {\n  effect(callback: () => undefined | (() => void), options?: { name?: string }): EffectHandle;\n  signal<T>(initial: T, options?: { name?: string }): Signal<T>;\n};\n\n/** Resource only depends on primitive runtime methods; graph binding stays private. */\nexport const createResource =\n  (runtime: AsyncRuntime) =>\n  <Source, Value>(\n    source: () => Source,\n    loader: (source: Source, context: { readonly signal: AbortSignal }) => Promise<Value>,\n    options?: ResourceOptions,\n  ): Resource<Value> => {\n    const state = runtime.signal<AsyncState<Value>>({ status: 'pending' }, { name: options?.name });\n    const reloadEpoch = runtime.signal(0);\n    let active: AbortController | undefined;\n    let hasPrevious = false;\n    let previousValue: Value | undefined;\n\n    const run = (): void => {\n      void reloadEpoch.value;\n      active?.abort();\n\n      let input: Source;\n\n      try {\n        input = source();\n      } catch (error) {\n        state.value = hasPrevious\n          ? { error, previous: previousValue as Value, status: 'error' }\n          : { error, status: 'error' };\n\n        return;\n      }\n\n      const next = new AbortController();\n\n      active = next;\n      state.value = hasPrevious ? { previous: previousValue as Value, status: 'pending' } : { status: 'pending' };\n\n      let request: Promise<Value>;\n\n      try {\n        request = Promise.resolve(loader(input, { signal: next.signal }));\n      } catch (error) {\n        request = Promise.reject(error);\n      }\n\n      void request.then(\n        (value) => {\n          if (!stop.disposed && !next.signal.aborted) {\n            hasPrevious = true;\n            previousValue = value;\n            state.value = { status: 'success', value };\n          }\n        },\n        (error: unknown) => {\n          if (!stop.disposed && !next.signal.aborted) {\n            state.value = hasPrevious\n              ? { error, previous: previousValue as Value, status: 'error' }\n              : { error, status: 'error' };\n          }\n        },\n      );\n    };\n\n    const stop = runtime.effect(\n      () => {\n        run();\n\n        return () => active?.abort();\n      },\n      { name: options?.name },\n    );\n\n    const assertActive = (): void => {\n      if (stop.disposed) throw new RippleDisposedResourceError('Cannot use a disposed resource.');\n    };\n    const resource: Resource<Value> = {\n      get disposalSignal() {\n        return stop.disposalSignal;\n      },\n      dispose: () => stop.dispose(),\n      get disposed() {\n        return stop.disposed;\n      },\n      get name() {\n        return state.name;\n      },\n      peek: () => state.peek(),\n      reload: () => {\n        assertActive();\n        reloadEpoch.value = reloadEpoch.peek() + 1;\n      },\n      subscribe: (listener) => {\n        assertActive();\n        return state.subscribe(listener);\n      },\n      [Symbol.dispose]() {\n        this.dispose();\n      },\n      get value() {\n        return state.value;\n      },\n    };\n\n    Object.defineProperty(resource, REACTIVE, { value: true });\n\n    return resource;\n  };\n"],"mappings":";;;AAuBA,IAAa,KACV,OAEC,GACA,GACA,MACoB;CACpB,IAAM,IAAQ,EAAQ,OAA0B,EAAE,QAAQ,UAAU,GAAG,EAAE,MAAM,GAAS,KAAK,CAAC,GACxF,IAAc,EAAQ,OAAO,CAAC,GAChC,GACA,IAAc,IACd,GAEE,UAAkB;EAEtB,AADA,EAAiB,OACjB,GAAQ,MAAM;EAEd,IAAI;EAEJ,IAAI;GACF,IAAQ,EAAO;EACjB,SAAS,GAAO;GACd,EAAM,QAAQ,IACV;IAAE;IAAO,UAAU;IAAwB,QAAQ;GAAQ,IAC3D;IAAE;IAAO,QAAQ;GAAQ;GAE7B;EACF;EAEA,IAAM,IAAO,IAAI,gBAAgB;EAGjC,AADA,IAAS,GACT,EAAM,QAAQ,IAAc;GAAE,UAAU;GAAwB,QAAQ;EAAU,IAAI,EAAE,QAAQ,UAAU;EAE1G,IAAI;EAEJ,IAAI;GACF,IAAU,QAAQ,QAAQ,EAAO,GAAO,EAAE,QAAQ,EAAK,OAAO,CAAC,CAAC;EAClE,SAAS,GAAO;GACd,IAAU,QAAQ,OAAO,CAAK;EAChC;EAEA,EAAa,MACV,MAAU;GACT,AAAI,CAAC,EAAK,YAAY,CAAC,EAAK,OAAO,YACjC,IAAc,IACd,IAAgB,GAChB,EAAM,QAAQ;IAAE,QAAQ;IAAW;GAAM;EAE7C,IACC,MAAmB;GAClB,AAAI,CAAC,EAAK,YAAY,CAAC,EAAK,OAAO,YACjC,EAAM,QAAQ,IACV;IAAE;IAAO,UAAU;IAAwB,QAAQ;GAAQ,IAC3D;IAAE;IAAO,QAAQ;GAAQ;EAEjC,CACF;CACF,GAEM,IAAO,EAAQ,cAEjB,EAAI,SAES,GAAQ,MAAM,IAE7B,EAAE,MAAM,GAAS,KAAK,CACxB,GAEM,UAA2B;EAC/B,IAAI,EAAK,UAAU,MAAM,IAAI,EAA4B,iCAAiC;CAC5F,GACM,IAA4B;EAChC,IAAI,iBAAiB;GACnB,OAAO,EAAK;EACd;EACA,eAAe,EAAK,QAAQ;EAC5B,IAAI,WAAW;GACb,OAAO,EAAK;EACd;EACA,IAAI,OAAO;GACT,OAAO,EAAM;EACf;EACA,YAAY,EAAM,KAAK;EACvB,cAAc;GAEZ,AADA,EAAa,GACb,EAAY,QAAQ,EAAY,KAAK,IAAI;EAC3C;EACA,YAAY,OACV,EAAa,GACN,EAAM,UAAU,CAAQ;EAEjC,CAAC,OAAO,WAAW;GACjB,KAAK,QAAQ;EACf;EACA,IAAI,QAAQ;GACV,OAAO,EAAM;EACf;CACF;CAIA,OAFA,OAAO,eAAe,GAAU,GAAU,EAAE,OAAO,GAAK,CAAC,GAElD;AACT"}

package/dist/_default.cjs

@@ -1,2 +1,2 @@
-const e=require("./runtime.cjs"),t=require("./_async.cjs"),n=require("./_watch.cjs");var r=r=>{let i=new e.ReactiveRuntime(r),a=t.createResource(i);return{batch:i.batch,computed:i.computed,createScope:i.createScope,get disposalSignal(){return i.disposalSignal},dispose:()=>i.dispose(),get disposed(){return i.disposed},effect:i.effect,resource:a,signal:i.signal,untrack:i.untrack,watch:n.createWatch(i),[Symbol.dispose]:()=>i.dispose()}},i=r();exports.createRipple=r,exports.defaultRipple=i;
+const e=require("./runtime.cjs"),t=require("./_async.cjs"),n=require("./_subscribable.cjs"),r=require("./_watch.cjs");var i=i=>{let a=new e.ReactiveRuntime(i),o=n.createFromSubscribable(a),s=t.createResource(a);return{batch:a.batch,computed:a.computed,createScope:a.createScope,get disposalSignal(){return a.disposalSignal},dispose:()=>a.dispose(),get disposed(){return a.disposed},effect:a.effect,fromSubscribable:o,resource:s,signal:a.signal,tap:a.tap,untrack:a.untrack,watch:r.createWatch(a),[Symbol.dispose]:()=>a.dispose()}},a=i();exports.createRipple=i,exports.defaultRipple=a;
 //# sourceMappingURL=_default.cjs.map

package/dist/_default.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"_default.cjs","names":[],"sources":["../src/_default.ts"],"sourcesContent":["import { createResource, type Resource, type ResourceOptions } from './_async';\nimport { createWatch, type WatchOptions } from './_watch';\nimport { ReactiveRuntime } from './runtime';\nimport type {\n  Cleanup,\n  ComputedOptions,\n  Disposable,\n  EffectHandle,\n  EffectOptions,\n  Readable,\n  RippleOptions,\n  Scope,\n  Signal,\n  SignalOptions,\n} from './types';\n\nexport interface Ripple extends Disposable {\n  batch<T>(fn: () => T): T;\n  computed<T>(derive: () => T, options?: ComputedOptions<T>): Readable<T>;\n  createScope(name?: string): Scope;\n  effect(callback: () => Cleanup | undefined, options?: EffectOptions): EffectHandle;\n  resource<Source, Value>(\n    source: () => Source,\n    loader: (source: Source, context: { readonly signal: AbortSignal }) => Promise<Value>,\n    options?: ResourceOptions,\n  ): Resource<Value>;\n  signal<T>(initial: T, options?: SignalOptions<T>): Signal<T>;\n  untrack<T>(fn: () => T): T;\n  watch<T>(\n    source: Readable<T> | (() => T),\n    callback: (value: T, previous: T | undefined) => void,\n    options?: WatchOptions<T>,\n  ): EffectHandle;\n}\n\n/** Creates one complete reactive graph. All factories on the object share its runtime. */\nexport const createRipple = (options?: RippleOptions): Ripple => {\n  const runtime = new ReactiveRuntime(options);\n  const resource = createResource(runtime);\n\n  return {\n    batch: runtime.batch,\n    computed: runtime.computed,\n    createScope: runtime.createScope,\n    get disposalSignal() {\n      return runtime.disposalSignal;\n    },\n    dispose: () => runtime.dispose(),\n    get disposed() {\n      return runtime.disposed;\n    },\n    effect: runtime.effect,\n    resource,\n    signal: runtime.signal,\n    untrack: runtime.untrack,\n    watch: createWatch(runtime),\n    [Symbol.dispose]: () => runtime.dispose(),\n  };\n};\n\n/**\n * The shared default reactive graph. Private — `signal`, `computed`, `effect`, `batch`,\n * `createScope`, `untrack`, `watch`, and `resource` are re-exported from the package root\n * as bound methods on this single graph instance.\n */\nexport const defaultRipple = createRipple();\n"],"mappings":"qFAoCA,IAAa,EAAgB,GAAoC,CAC/D,IAAM,EAAU,IAAI,EAAA,gBAAgB,CAAO,EACrC,EAAW,EAAA,eAAe,CAAO,EAEvC,MAAO,CACL,MAAO,EAAQ,MACf,SAAU,EAAQ,SAClB,YAAa,EAAQ,YACrB,IAAI,gBAAiB,CACnB,OAAO,EAAQ,cACjB,EACA,YAAe,EAAQ,QAAQ,EAC/B,IAAI,UAAW,CACb,OAAO,EAAQ,QACjB,EACA,OAAQ,EAAQ,OAChB,WACA,OAAQ,EAAQ,OAChB,QAAS,EAAQ,QACjB,MAAO,EAAA,YAAY,CAAO,GACzB,OAAO,aAAgB,EAAQ,QAAQ,CAC1C,CACF,EAOa,EAAgB,EAAa"}
+{"version":3,"file":"_default.cjs","names":[],"sources":["../src/_default.ts"],"sourcesContent":["import { createResource, type Resource, type ResourceOptions } from './_async';\nimport { type BridgedReadable, createFromSubscribable, type FromSubscribableOptions } from './_subscribable';\nimport { createWatch, type WatchOptions } from './_watch';\nimport { ReactiveRuntime } from './runtime';\nimport type {\n  Cleanup,\n  ComputedOptions,\n  Disposable,\n  EffectHandle,\n  EffectOptions,\n  Readable,\n  RippleEvent,\n  RippleOptions,\n  Scope,\n  Signal,\n  SignalOptions,\n  Subscribable,\n  Unsubscribe,\n} from './types';\n\nexport interface Ripple extends Disposable {\n  batch<T>(fn: () => T): T;\n  computed<T>(derive: () => T, options?: ComputedOptions<T>): Readable<T>;\n  createScope(name?: string): Scope;\n  effect(callback: () => Cleanup | undefined, options?: EffectOptions): EffectHandle;\n  fromSubscribable<T>(source: Subscribable<T>, options?: FromSubscribableOptions): BridgedReadable<T>;\n  resource<Source, Value>(\n    source: () => Source,\n    loader: (source: Source, context: { readonly signal: AbortSignal }) => Promise<Value>,\n    options?: ResourceOptions,\n  ): Resource<Value>;\n  signal<T>(initial: T, options?: SignalOptions<T>): Signal<T>;\n  tap(handler: (event: RippleEvent) => void, options?: { signal?: AbortSignal }): Unsubscribe;\n  untrack<T>(fn: () => T): T;\n  watch<T>(\n    source: Readable<T> | (() => T),\n    callback: (value: T, previous: T | undefined) => void,\n    options?: WatchOptions<T>,\n  ): EffectHandle;\n}\n\n/**\n * Creates one complete reactive graph with its own ownership boundary. All\n * factories on the returned object share its runtime. Use this for tests, SSR\n * requests, embedded applications, or independently disposable features.\n * `dispose()` is terminal — create a new graph for a new lifetime.\n */\nexport const createRipple = (options?: RippleOptions): Ripple => {\n  const runtime = new ReactiveRuntime(options);\n  const fromSubscribable = createFromSubscribable(runtime);\n  const resource = createResource(runtime);\n\n  return {\n    batch: runtime.batch,\n    computed: runtime.computed,\n    createScope: runtime.createScope,\n    get disposalSignal() {\n      return runtime.disposalSignal;\n    },\n    dispose: () => runtime.dispose(),\n    get disposed() {\n      return runtime.disposed;\n    },\n    effect: runtime.effect,\n    fromSubscribable,\n    resource,\n    signal: runtime.signal,\n    tap: runtime.tap,\n    untrack: runtime.untrack,\n    watch: createWatch(runtime),\n    [Symbol.dispose]: () => runtime.dispose(),\n  };\n};\n\n/**\n * The shared default reactive graph — process-lifetime. Root helpers\n * (`signal`, `computed`, `effect`, `batch`, `createScope`, `untrack`, `watch`, `resource`, `fromSubscribable`)\n * are re-exported from the package root as bound methods on this single graph\n * instance. Use these only when the application has one graph for its entire\n * lifetime; they are never disposed. For isolated, disposable graphs (tests,\n * SSR, embedded features) use `createRipple()` instead.\n */\nexport const defaultRipple = createRipple();\n"],"mappings":"sHA+CA,IAAa,EAAgB,GAAoC,CAC/D,IAAM,EAAU,IAAI,EAAA,gBAAgB,CAAO,EACrC,EAAmB,EAAA,uBAAuB,CAAO,EACjD,EAAW,EAAA,eAAe,CAAO,EAEvC,MAAO,CACL,MAAO,EAAQ,MACf,SAAU,EAAQ,SAClB,YAAa,EAAQ,YACrB,IAAI,gBAAiB,CACnB,OAAO,EAAQ,cACjB,EACA,YAAe,EAAQ,QAAQ,EAC/B,IAAI,UAAW,CACb,OAAO,EAAQ,QACjB,EACA,OAAQ,EAAQ,OAChB,mBACA,WACA,OAAQ,EAAQ,OAChB,IAAK,EAAQ,IACb,QAAS,EAAQ,QACjB,MAAO,EAAA,YAAY,CAAO,GACzB,OAAO,aAAgB,EAAQ,QAAQ,CAC1C,CACF,EAUa,EAAgB,EAAa"}

package/dist/_default.d.ts

@@ -1,24 +1,37 @@
 import { type Resource, type ResourceOptions } from './_async';
+import { type BridgedReadable, type FromSubscribableOptions } from './_subscribable';
 import { type WatchOptions } from './_watch';
-import type { Cleanup, ComputedOptions, Disposable, EffectHandle, EffectOptions, Readable, RippleOptions, Scope, Signal, SignalOptions } from './types';
+import type { Cleanup, ComputedOptions, Disposable, EffectHandle, EffectOptions, Readable, RippleEvent, RippleOptions, Scope, Signal, SignalOptions, Subscribable, Unsubscribe } from './types';
 export interface Ripple extends Disposable {
     batch<T>(fn: () => T): T;
     computed<T>(derive: () => T, options?: ComputedOptions<T>): Readable<T>;
     createScope(name?: string): Scope;
     effect(callback: () => Cleanup | undefined, options?: EffectOptions): EffectHandle;
+    fromSubscribable<T>(source: Subscribable<T>, options?: FromSubscribableOptions): BridgedReadable<T>;
     resource<Source, Value>(source: () => Source, loader: (source: Source, context: {
         readonly signal: AbortSignal;
     }) => Promise<Value>, options?: ResourceOptions): Resource<Value>;
     signal<T>(initial: T, options?: SignalOptions<T>): Signal<T>;
+    tap(handler: (event: RippleEvent) => void, options?: {
+        signal?: AbortSignal;
+    }): Unsubscribe;
     untrack<T>(fn: () => T): T;
     watch<T>(source: Readable<T> | (() => T), callback: (value: T, previous: T | undefined) => void, options?: WatchOptions<T>): EffectHandle;
 }
-/** Creates one complete reactive graph. All factories on the object share its runtime. */
+/**
+ * Creates one complete reactive graph with its own ownership boundary. All
+ * factories on the returned object share its runtime. Use this for tests, SSR
+ * requests, embedded applications, or independently disposable features.
+ * `dispose()` is terminal — create a new graph for a new lifetime.
+ */
 export declare const createRipple: (options?: RippleOptions) => Ripple;
 /**
- * The shared default reactive graph. Private — `signal`, `computed`, `effect`, `batch`,
- * `createScope`, `untrack`, `watch`, and `resource` are re-exported from the package root
- * as bound methods on this single graph instance.
+ * The shared default reactive graph — process-lifetime. Root helpers
+ * (`signal`, `computed`, `effect`, `batch`, `createScope`, `untrack`, `watch`, `resource`, `fromSubscribable`)
+ * are re-exported from the package root as bound methods on this single graph
+ * instance. Use these only when the application has one graph for its entire
+ * lifetime; they are never disposed. For isolated, disposable graphs (tests,
+ * SSR, embedded features) use `createRipple()` instead.
  */
 export declare const defaultRipple: Ripple;
 //# sourceMappingURL=_default.d.ts.map

package/dist/_default.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_default.d.ts","sourceRoot":"","sources":["../src/_default.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAC/E,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,KAAK,EACV,OAAO,EACP,eAAe,EACf,UAAU,EACV,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,aAAa,EACb,KAAK,EACL,MAAM,EACN,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,MAAO,SAAQ,UAAU;IACxC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACxE,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAClC,MAAM,CAAC,QAAQ,EAAE,MAAM,OAAO,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IACnF,QAAQ,CAAC,MAAM,EAAE,KAAK,EACpB,MAAM,EAAE,MAAM,MAAM,EACpB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,KAAK,CAAC,EACrF,OAAO,CAAC,EAAE,eAAe,GACxB,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,KAAK,CAAC,CAAC,EACL,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,EACrD,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACxB,YAAY,CAAC;CACjB;AAED,0FAA0F;AAC1F,eAAO,MAAM,YAAY,GAAI,UAAU,aAAa,KAAG,MAsBtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAAiB,CAAC"}
+{"version":3,"file":"_default.d.ts","sourceRoot":"","sources":["../src/_default.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAC/E,OAAO,EAAE,KAAK,eAAe,EAA0B,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC7G,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,KAAK,EACV,OAAO,EACP,eAAe,EACf,UAAU,EACV,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,WAAW,EACX,aAAa,EACb,KAAK,EACL,MAAM,EACN,aAAa,EACb,YAAY,EACZ,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,MAAO,SAAQ,UAAU;IACxC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACxE,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAClC,MAAM,CAAC,QAAQ,EAAE,MAAM,OAAO,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IACnF,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IACpG,QAAQ,CAAC,MAAM,EAAE,KAAK,EACpB,MAAM,EAAE,MAAM,MAAM,EACpB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,KAAK,CAAC,EACrF,OAAO,CAAC,EAAE,eAAe,GACxB,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7D,GAAG,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,WAAW,CAAC;IAC5F,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,KAAK,CAAC,CAAC,EACL,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,EACrD,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACxB,YAAY,CAAC;CACjB;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,UAAU,aAAa,KAAG,MAyBtD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,QAAiB,CAAC"}

package/dist/_default.js

@@ -1,29 +1,32 @@
 import { ReactiveRuntime as e } from "./runtime.js";
 import { createResource as t } from "./_async.js";
-import { createWatch as n } from "./_watch.js";
+import { createFromSubscribable as n } from "./_subscribable.js";
+import { createWatch as r } from "./_watch.js";
 //#region src/_default.ts
-var r = (r) => {
-	let i = new e(r), a = t(i);
+var i = (i) => {
+	let a = new e(i), o = n(a), s = t(a);
 	return {
-		batch: i.batch,
-		computed: i.computed,
-		createScope: i.createScope,
+		batch: a.batch,
+		computed: a.computed,
+		createScope: a.createScope,
 		get disposalSignal() {
-			return i.disposalSignal;
+			return a.disposalSignal;
 		},
-		dispose: () => i.dispose(),
+		dispose: () => a.dispose(),
 		get disposed() {
-			return i.disposed;
+			return a.disposed;
 		},
-		effect: i.effect,
-		resource: a,
-		signal: i.signal,
-		untrack: i.untrack,
-		watch: n(i),
-		[Symbol.dispose]: () => i.dispose()
+		effect: a.effect,
+		fromSubscribable: o,
+		resource: s,
+		signal: a.signal,
+		tap: a.tap,
+		untrack: a.untrack,
+		watch: r(a),
+		[Symbol.dispose]: () => a.dispose()
 	};
-}, i = r();
+}, a = i();
 //#endregion
-export { r as createRipple, i as defaultRipple };
+export { i as createRipple, a as defaultRipple };
 
 //# sourceMappingURL=_default.js.map

package/dist/_default.js.map

@@ -1 +1 @@
-{"version":3,"file":"_default.js","names":[],"sources":["../src/_default.ts"],"sourcesContent":["import { createResource, type Resource, type ResourceOptions } from './_async';\nimport { createWatch, type WatchOptions } from './_watch';\nimport { ReactiveRuntime } from './runtime';\nimport type {\n  Cleanup,\n  ComputedOptions,\n  Disposable,\n  EffectHandle,\n  EffectOptions,\n  Readable,\n  RippleOptions,\n  Scope,\n  Signal,\n  SignalOptions,\n} from './types';\n\nexport interface Ripple extends Disposable {\n  batch<T>(fn: () => T): T;\n  computed<T>(derive: () => T, options?: ComputedOptions<T>): Readable<T>;\n  createScope(name?: string): Scope;\n  effect(callback: () => Cleanup | undefined, options?: EffectOptions): EffectHandle;\n  resource<Source, Value>(\n    source: () => Source,\n    loader: (source: Source, context: { readonly signal: AbortSignal }) => Promise<Value>,\n    options?: ResourceOptions,\n  ): Resource<Value>;\n  signal<T>(initial: T, options?: SignalOptions<T>): Signal<T>;\n  untrack<T>(fn: () => T): T;\n  watch<T>(\n    source: Readable<T> | (() => T),\n    callback: (value: T, previous: T | undefined) => void,\n    options?: WatchOptions<T>,\n  ): EffectHandle;\n}\n\n/** Creates one complete reactive graph. All factories on the object share its runtime. */\nexport const createRipple = (options?: RippleOptions): Ripple => {\n  const runtime = new ReactiveRuntime(options);\n  const resource = createResource(runtime);\n\n  return {\n    batch: runtime.batch,\n    computed: runtime.computed,\n    createScope: runtime.createScope,\n    get disposalSignal() {\n      return runtime.disposalSignal;\n    },\n    dispose: () => runtime.dispose(),\n    get disposed() {\n      return runtime.disposed;\n    },\n    effect: runtime.effect,\n    resource,\n    signal: runtime.signal,\n    untrack: runtime.untrack,\n    watch: createWatch(runtime),\n    [Symbol.dispose]: () => runtime.dispose(),\n  };\n};\n\n/**\n * The shared default reactive graph. Private — `signal`, `computed`, `effect`, `batch`,\n * `createScope`, `untrack`, `watch`, and `resource` are re-exported from the package root\n * as bound methods on this single graph instance.\n */\nexport const defaultRipple = createRipple();\n"],"mappings":";;;;AAoCA,IAAa,KAAgB,MAAoC;CAC/D,IAAM,IAAU,IAAI,EAAgB,CAAO,GACrC,IAAW,EAAe,CAAO;CAEvC,OAAO;EACL,OAAO,EAAQ;EACf,UAAU,EAAQ;EAClB,aAAa,EAAQ;EACrB,IAAI,iBAAiB;GACnB,OAAO,EAAQ;EACjB;EACA,eAAe,EAAQ,QAAQ;EAC/B,IAAI,WAAW;GACb,OAAO,EAAQ;EACjB;EACA,QAAQ,EAAQ;EAChB;EACA,QAAQ,EAAQ;EAChB,SAAS,EAAQ;EACjB,OAAO,EAAY,CAAO;GACzB,OAAO,gBAAgB,EAAQ,QAAQ;CAC1C;AACF,GAOa,IAAgB,EAAa"}
+{"version":3,"file":"_default.js","names":[],"sources":["../src/_default.ts"],"sourcesContent":["import { createResource, type Resource, type ResourceOptions } from './_async';\nimport { type BridgedReadable, createFromSubscribable, type FromSubscribableOptions } from './_subscribable';\nimport { createWatch, type WatchOptions } from './_watch';\nimport { ReactiveRuntime } from './runtime';\nimport type {\n  Cleanup,\n  ComputedOptions,\n  Disposable,\n  EffectHandle,\n  EffectOptions,\n  Readable,\n  RippleEvent,\n  RippleOptions,\n  Scope,\n  Signal,\n  SignalOptions,\n  Subscribable,\n  Unsubscribe,\n} from './types';\n\nexport interface Ripple extends Disposable {\n  batch<T>(fn: () => T): T;\n  computed<T>(derive: () => T, options?: ComputedOptions<T>): Readable<T>;\n  createScope(name?: string): Scope;\n  effect(callback: () => Cleanup | undefined, options?: EffectOptions): EffectHandle;\n  fromSubscribable<T>(source: Subscribable<T>, options?: FromSubscribableOptions): BridgedReadable<T>;\n  resource<Source, Value>(\n    source: () => Source,\n    loader: (source: Source, context: { readonly signal: AbortSignal }) => Promise<Value>,\n    options?: ResourceOptions,\n  ): Resource<Value>;\n  signal<T>(initial: T, options?: SignalOptions<T>): Signal<T>;\n  tap(handler: (event: RippleEvent) => void, options?: { signal?: AbortSignal }): Unsubscribe;\n  untrack<T>(fn: () => T): T;\n  watch<T>(\n    source: Readable<T> | (() => T),\n    callback: (value: T, previous: T | undefined) => void,\n    options?: WatchOptions<T>,\n  ): EffectHandle;\n}\n\n/**\n * Creates one complete reactive graph with its own ownership boundary. All\n * factories on the returned object share its runtime. Use this for tests, SSR\n * requests, embedded applications, or independently disposable features.\n * `dispose()` is terminal — create a new graph for a new lifetime.\n */\nexport const createRipple = (options?: RippleOptions): Ripple => {\n  const runtime = new ReactiveRuntime(options);\n  const fromSubscribable = createFromSubscribable(runtime);\n  const resource = createResource(runtime);\n\n  return {\n    batch: runtime.batch,\n    computed: runtime.computed,\n    createScope: runtime.createScope,\n    get disposalSignal() {\n      return runtime.disposalSignal;\n    },\n    dispose: () => runtime.dispose(),\n    get disposed() {\n      return runtime.disposed;\n    },\n    effect: runtime.effect,\n    fromSubscribable,\n    resource,\n    signal: runtime.signal,\n    tap: runtime.tap,\n    untrack: runtime.untrack,\n    watch: createWatch(runtime),\n    [Symbol.dispose]: () => runtime.dispose(),\n  };\n};\n\n/**\n * The shared default reactive graph — process-lifetime. Root helpers\n * (`signal`, `computed`, `effect`, `batch`, `createScope`, `untrack`, `watch`, `resource`, `fromSubscribable`)\n * are re-exported from the package root as bound methods on this single graph\n * instance. Use these only when the application has one graph for its entire\n * lifetime; they are never disposed. For isolated, disposable graphs (tests,\n * SSR, embedded features) use `createRipple()` instead.\n */\nexport const defaultRipple = createRipple();\n"],"mappings":";;;;;AA+CA,IAAa,KAAgB,MAAoC;CAC/D,IAAM,IAAU,IAAI,EAAgB,CAAO,GACrC,IAAmB,EAAuB,CAAO,GACjD,IAAW,EAAe,CAAO;CAEvC,OAAO;EACL,OAAO,EAAQ;EACf,UAAU,EAAQ;EAClB,aAAa,EAAQ;EACrB,IAAI,iBAAiB;GACnB,OAAO,EAAQ;EACjB;EACA,eAAe,EAAQ,QAAQ;EAC/B,IAAI,WAAW;GACb,OAAO,EAAQ;EACjB;EACA,QAAQ,EAAQ;EAChB;EACA;EACA,QAAQ,EAAQ;EAChB,KAAK,EAAQ;EACb,SAAS,EAAQ;EACjB,OAAO,EAAY,CAAO;GACzB,OAAO,gBAAgB,EAAQ,QAAQ;CAC1C;AACF,GAUa,IAAgB,EAAa"}

package/dist/_subscribable.cjs

@@ -0,0 +1,2 @@
+const e=require("./errors.cjs"),t=require("./runtime.cjs");var n=n=>(r,i)=>{let a=n.signal(r.getSnapshot(),{name:i?.name}),o=n.effect(()=>{let e=()=>{a.value=r.getSnapshot()},t;try{t=r.subscribe(e),e()}catch(e){throw t?.(),e}return t},{name:i?.name}),s=()=>o.dispose();i?.signal?.addEventListener(`abort`,s,{once:!0}),i?.signal?.aborted&&o.dispose();let c=()=>{if(o.disposed)throw new e.RippleError(`Cannot subscribe to a disposed bridge.`)},l=()=>{i?.signal?.removeEventListener(`abort`,s),o.dispose()},u={get disposalSignal(){return o.disposalSignal},dispose:l,get disposed(){return o.disposed},get name(){return a.name},peek:()=>a.peek(),subscribe(e){return c(),a.subscribe(e)},[Symbol.dispose]:l,get value(){return a.value}};return Object.defineProperty(u,t.REACTIVE,{value:!0}),u};exports.createFromSubscribable=n;
+//# sourceMappingURL=_subscribable.cjs.map

package/dist/_subscribable.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_subscribable.cjs","names":[],"sources":["../src/_subscribable.ts"],"sourcesContent":["import { RippleError } from './errors';\nimport { REACTIVE } from './runtime';\nimport type { Disposable, EffectHandle, Readable, Signal, Subscribable } from './types';\n\ntype BridgeRuntime = {\n  effect(callback: () => undefined | (() => void), options?: { name?: string }): EffectHandle;\n  signal<T>(initial: T, options?: { name?: string }): Signal<T>;\n};\n\nexport type BridgedReadable<T> = Readable<T> & Disposable;\nexport type FromSubscribableOptions = { name?: string; signal?: AbortSignal };\n\nexport const createFromSubscribable =\n  (runtime: BridgeRuntime) =>\n  <T>(source: Subscribable<T>, options?: FromSubscribableOptions): BridgedReadable<T> => {\n    const node = runtime.signal<T>(source.getSnapshot(), { name: options?.name });\n    const stop = runtime.effect(\n      () => {\n        const sync = () => {\n          node.value = source.getSnapshot();\n        };\n        let unsubscribe: (() => void) | undefined;\n\n        try {\n          unsubscribe = source.subscribe(sync);\n          sync();\n        } catch (error) {\n          unsubscribe?.();\n          throw error;\n        }\n\n        return unsubscribe;\n      },\n      { name: options?.name },\n    );\n    const abort = () => stop.dispose();\n\n    options?.signal?.addEventListener('abort', abort, { once: true });\n    if (options?.signal?.aborted) stop.dispose();\n\n    const assertActive = (): void => {\n      if (stop.disposed) throw new RippleError('Cannot subscribe to a disposed bridge.');\n    };\n    const dispose = (): void => {\n      options?.signal?.removeEventListener('abort', abort);\n      stop.dispose();\n    };\n    const readable: BridgedReadable<T> = {\n      get disposalSignal() {\n        return stop.disposalSignal;\n      },\n      dispose,\n      get disposed() {\n        return stop.disposed;\n      },\n      get name() {\n        return node.name;\n      },\n      peek: () => node.peek(),\n      subscribe(listener) {\n        assertActive();\n        return node.subscribe(listener);\n      },\n      [Symbol.dispose]: dispose,\n      get value() {\n        return node.value;\n      },\n    };\n\n    Object.defineProperty(readable, REACTIVE, { value: true });\n    return readable;\n  };\n"],"mappings":"2DAYA,IAAa,EACV,IACG,EAAyB,IAA0D,CACrF,IAAM,EAAO,EAAQ,OAAU,EAAO,YAAY,EAAG,CAAE,KAAM,GAAS,IAAK,CAAC,EACtE,EAAO,EAAQ,WACb,CACJ,IAAM,MAAa,CACjB,EAAK,MAAQ,EAAO,YAAY,CAClC,EACI,EAEJ,GAAI,CACF,EAAc,EAAO,UAAU,CAAI,EACnC,EAAK,CACP,OAAS,EAAO,CAEd,MADA,IAAc,EACR,CACR,CAEA,OAAO,CACT,EACA,CAAE,KAAM,GAAS,IAAK,CACxB,EACM,MAAc,EAAK,QAAQ,EAEjC,GAAS,QAAQ,iBAAiB,QAAS,EAAO,CAAE,KAAM,EAAK,CAAC,EAC5D,GAAS,QAAQ,SAAS,EAAK,QAAQ,EAE3C,IAAM,MAA2B,CAC/B,GAAI,EAAK,SAAU,MAAM,IAAI,EAAA,YAAY,wCAAwC,CACnF,EACM,MAAsB,CAC1B,GAAS,QAAQ,oBAAoB,QAAS,CAAK,EACnD,EAAK,QAAQ,CACf,EACM,EAA+B,CACnC,IAAI,gBAAiB,CACnB,OAAO,EAAK,cACd,EACA,UACA,IAAI,UAAW,CACb,OAAO,EAAK,QACd,EACA,IAAI,MAAO,CACT,OAAO,EAAK,IACd,EACA,SAAY,EAAK,KAAK,EACtB,UAAU,EAAU,CAElB,OADA,EAAa,EACN,EAAK,UAAU,CAAQ,CAChC,GACC,OAAO,SAAU,EAClB,IAAI,OAAQ,CACV,OAAO,EAAK,KACd,CACF,EAGA,OADA,OAAO,eAAe,EAAU,EAAA,SAAU,CAAE,MAAO,EAAK,CAAC,EAClD,CACT"}

package/dist/_subscribable.d.ts

@@ -0,0 +1,17 @@
+import type { Disposable, EffectHandle, Readable, Signal, Subscribable } from './types';
+type BridgeRuntime = {
+    effect(callback: () => undefined | (() => void), options?: {
+        name?: string;
+    }): EffectHandle;
+    signal<T>(initial: T, options?: {
+        name?: string;
+    }): Signal<T>;
+};
+export type BridgedReadable<T> = Readable<T> & Disposable;
+export type FromSubscribableOptions = {
+    name?: string;
+    signal?: AbortSignal;
+};
+export declare const createFromSubscribable: (runtime: BridgeRuntime) => <T>(source: Subscribable<T>, options?: FromSubscribableOptions) => BridgedReadable<T>;
+export {};
+//# sourceMappingURL=_subscribable.d.ts.map

package/dist/_subscribable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_subscribable.d.ts","sourceRoot":"","sources":["../src/_subscribable.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAExF,KAAK,aAAa,GAAG;IACnB,MAAM,CAAC,QAAQ,EAAE,MAAM,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY,CAAC;IAC5F,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC;AAC1D,MAAM,MAAM,uBAAuB,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAE9E,eAAO,MAAM,sBAAsB,GAChC,SAAS,aAAa,MACtB,CAAC,EAAE,QAAQ,YAAY,CAAC,CAAC,CAAC,EAAE,UAAU,uBAAuB,KAAG,eAAe,CAAC,CAAC,CAyDjF,CAAC"}

package/dist/_subscribable.js

@@ -0,0 +1,46 @@
+import { RippleError as e } from "./errors.js";
+import { REACTIVE as t } from "./runtime.js";
+//#region src/_subscribable.ts
+var n = (n) => (r, i) => {
+	let a = n.signal(r.getSnapshot(), { name: i?.name }), o = n.effect(() => {
+		let e = () => {
+			a.value = r.getSnapshot();
+		}, t;
+		try {
+			t = r.subscribe(e), e();
+		} catch (e) {
+			throw t?.(), e;
+		}
+		return t;
+	}, { name: i?.name }), s = () => o.dispose();
+	i?.signal?.addEventListener("abort", s, { once: !0 }), i?.signal?.aborted && o.dispose();
+	let c = () => {
+		if (o.disposed) throw new e("Cannot subscribe to a disposed bridge.");
+	}, l = () => {
+		i?.signal?.removeEventListener("abort", s), o.dispose();
+	}, u = {
+		get disposalSignal() {
+			return o.disposalSignal;
+		},
+		dispose: l,
+		get disposed() {
+			return o.disposed;
+		},
+		get name() {
+			return a.name;
+		},
+		peek: () => a.peek(),
+		subscribe(e) {
+			return c(), a.subscribe(e);
+		},
+		[Symbol.dispose]: l,
+		get value() {
+			return a.value;
+		}
+	};
+	return Object.defineProperty(u, t, { value: !0 }), u;
+};
+//#endregion
+export { n as createFromSubscribable };
+
+//# sourceMappingURL=_subscribable.js.map

package/dist/_subscribable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_subscribable.js","names":[],"sources":["../src/_subscribable.ts"],"sourcesContent":["import { RippleError } from './errors';\nimport { REACTIVE } from './runtime';\nimport type { Disposable, EffectHandle, Readable, Signal, Subscribable } from './types';\n\ntype BridgeRuntime = {\n  effect(callback: () => undefined | (() => void), options?: { name?: string }): EffectHandle;\n  signal<T>(initial: T, options?: { name?: string }): Signal<T>;\n};\n\nexport type BridgedReadable<T> = Readable<T> & Disposable;\nexport type FromSubscribableOptions = { name?: string; signal?: AbortSignal };\n\nexport const createFromSubscribable =\n  (runtime: BridgeRuntime) =>\n  <T>(source: Subscribable<T>, options?: FromSubscribableOptions): BridgedReadable<T> => {\n    const node = runtime.signal<T>(source.getSnapshot(), { name: options?.name });\n    const stop = runtime.effect(\n      () => {\n        const sync = () => {\n          node.value = source.getSnapshot();\n        };\n        let unsubscribe: (() => void) | undefined;\n\n        try {\n          unsubscribe = source.subscribe(sync);\n          sync();\n        } catch (error) {\n          unsubscribe?.();\n          throw error;\n        }\n\n        return unsubscribe;\n      },\n      { name: options?.name },\n    );\n    const abort = () => stop.dispose();\n\n    options?.signal?.addEventListener('abort', abort, { once: true });\n    if (options?.signal?.aborted) stop.dispose();\n\n    const assertActive = (): void => {\n      if (stop.disposed) throw new RippleError('Cannot subscribe to a disposed bridge.');\n    };\n    const dispose = (): void => {\n      options?.signal?.removeEventListener('abort', abort);\n      stop.dispose();\n    };\n    const readable: BridgedReadable<T> = {\n      get disposalSignal() {\n        return stop.disposalSignal;\n      },\n      dispose,\n      get disposed() {\n        return stop.disposed;\n      },\n      get name() {\n        return node.name;\n      },\n      peek: () => node.peek(),\n      subscribe(listener) {\n        assertActive();\n        return node.subscribe(listener);\n      },\n      [Symbol.dispose]: dispose,\n      get value() {\n        return node.value;\n      },\n    };\n\n    Object.defineProperty(readable, REACTIVE, { value: true });\n    return readable;\n  };\n"],"mappings":";;;AAYA,IAAa,KACV,OACG,GAAyB,MAA0D;CACrF,IAAM,IAAO,EAAQ,OAAU,EAAO,YAAY,GAAG,EAAE,MAAM,GAAS,KAAK,CAAC,GACtE,IAAO,EAAQ,aACb;EACJ,IAAM,UAAa;GACjB,EAAK,QAAQ,EAAO,YAAY;EAClC,GACI;EAEJ,IAAI;GAEF,AADA,IAAc,EAAO,UAAU,CAAI,GACnC,EAAK;EACP,SAAS,GAAO;GAEd,MADA,IAAc,GACR;EACR;EAEA,OAAO;CACT,GACA,EAAE,MAAM,GAAS,KAAK,CACxB,GACM,UAAc,EAAK,QAAQ;CAGjC,AADA,GAAS,QAAQ,iBAAiB,SAAS,GAAO,EAAE,MAAM,GAAK,CAAC,GAC5D,GAAS,QAAQ,WAAS,EAAK,QAAQ;CAE3C,IAAM,UAA2B;EAC/B,IAAI,EAAK,UAAU,MAAM,IAAI,EAAY,wCAAwC;CACnF,GACM,UAAsB;EAE1B,AADA,GAAS,QAAQ,oBAAoB,SAAS,CAAK,GACnD,EAAK,QAAQ;CACf,GACM,IAA+B;EACnC,IAAI,iBAAiB;GACnB,OAAO,EAAK;EACd;EACA;EACA,IAAI,WAAW;GACb,OAAO,EAAK;EACd;EACA,IAAI,OAAO;GACT,OAAO,EAAK;EACd;EACA,YAAY,EAAK,KAAK;EACtB,UAAU,GAAU;GAElB,OADA,EAAa,GACN,EAAK,UAAU,CAAQ;EAChC;GACC,OAAO,UAAU;EAClB,IAAI,QAAQ;GACV,OAAO,EAAK;EACd;CACF;CAGA,OADA,OAAO,eAAe,GAAU,GAAU,EAAE,OAAO,GAAK,CAAC,GAClD;AACT"}

package/dist/_watch.cjs

@@ -1,2 +1,2 @@
-var e=e=>(t,n,r)=>{let i=typeof t==`function`?t:()=>t.value,a=r?.equals??Object.is,o=!0,s,c=!1,l=e.effect(()=>{let e=i();if(o){o=!1,s=e,r?.immediate&&(n(e,void 0),r?.once&&(c=!0));return}if(a(s,e))return;let t=s;s=e,n(e,t),r?.once&&l.dispose()},{name:r?.name});return c&&l.dispose(),l};exports.createWatch=e;
+var e=e=>(t,n,r)=>{let i=typeof t==`function`?t:()=>t.value,a=r?.equals??Object.is,o=!0,s,c=!1,l=e.effect(()=>{let t=i();if(o){if(o=!1,s=t,r?.immediate)try{e.untrack(()=>n(t,void 0))}finally{r?.once&&(c=!0)}return}if(a(s,t))return;let u=s;s=t;try{e.untrack(()=>n(t,u))}finally{r?.once&&l.dispose()}},{name:r?.name});return c&&l.dispose(),l};exports.createWatch=e;
 //# sourceMappingURL=_watch.cjs.map

package/dist/_watch.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"_watch.cjs","names":[],"sources":["../src/_watch.ts"],"sourcesContent":["import type { EffectHandle, Equality, Readable } from './types';\n\nexport type WatchOptions<T> = {\n  equals?: Equality<T>;\n  immediate?: boolean;\n  name?: string;\n  once?: boolean;\n};\n\ntype WatchRuntime = {\n  effect(callback: () => undefined | (() => void), options?: { name?: string }): EffectHandle;\n};\n\nexport const createWatch =\n  (runtime: WatchRuntime) =>\n  <T>(\n    source: Readable<T> | (() => T),\n    callback: (value: T, previous: T | undefined) => void,\n    options?: WatchOptions<T>,\n  ): EffectHandle => {\n    const read = typeof source === 'function' ? source : () => source.value;\n    const equals = options?.equals ?? Object.is;\n    let initial = true;\n    let previous: T | undefined;\n    // `handle` is in the temporal dead zone during the effect's initial synchronous run —\n    // `runtime.effect()` calls `node.run()` before returning. Defer disposal until after\n    // the constructor returns so `handle.dispose()` is reachable from inside the callback.\n    let disposeAfterInit = false;\n\n    const handle = runtime.effect(\n      () => {\n        const value = read();\n\n        if (initial) {\n          initial = false;\n          previous = value;\n\n          if (options?.immediate) {\n            callback(value, undefined);\n            if (options?.once) disposeAfterInit = true;\n          }\n\n          return;\n        }\n\n        if (equals(previous as T, value)) return;\n\n        const oldValue = previous;\n\n        previous = value;\n        callback(value, oldValue);\n\n        if (options?.once) handle.dispose();\n      },\n      { name: options?.name },\n    );\n\n    if (disposeAfterInit) handle.dispose();\n\n    return handle;\n  };\n"],"mappings":"AAaA,IAAa,EACV,IAEC,EACA,EACA,IACiB,CACjB,IAAM,EAAO,OAAO,GAAW,WAAa,MAAe,EAAO,MAC5D,EAAS,GAAS,QAAU,OAAO,GACrC,EAAU,GACV,EAIA,EAAmB,GAEjB,EAAS,EAAQ,WACf,CACJ,IAAM,EAAQ,EAAK,EAEnB,GAAI,EAAS,CACX,EAAU,GACV,EAAW,EAEP,GAAS,YACX,EAAS,EAAO,IAAA,EAAS,EACrB,GAAS,OAAM,EAAmB,KAGxC,MACF,CAEA,GAAI,EAAO,EAAe,CAAK,EAAG,OAElC,IAAM,EAAW,EAEjB,EAAW,EACX,EAAS,EAAO,CAAQ,EAEpB,GAAS,MAAM,EAAO,QAAQ,CACpC,EACA,CAAE,KAAM,GAAS,IAAK,CACxB,EAIA,OAFI,GAAkB,EAAO,QAAQ,EAE9B,CACT"}
+{"version":3,"file":"_watch.cjs","names":[],"sources":["../src/_watch.ts"],"sourcesContent":["import type { EffectHandle, Equality, Readable } from './types';\n\nexport type WatchOptions<T> = {\n  equals?: Equality<T>;\n  immediate?: boolean;\n  name?: string;\n  once?: boolean;\n};\n\ntype WatchRuntime = {\n  effect(callback: () => undefined | (() => void), options?: { name?: string }): EffectHandle;\n  untrack<T>(fn: () => T): T;\n};\n\nexport const createWatch =\n  (runtime: WatchRuntime) =>\n  <T>(\n    source: Readable<T> | (() => T),\n    callback: (value: T, previous: T | undefined) => void,\n    options?: WatchOptions<T>,\n  ): EffectHandle => {\n    const read = typeof source === 'function' ? source : () => source.value;\n    const equals = options?.equals ?? Object.is;\n    let initial = true;\n    let previous: T | undefined;\n    // `handle` is in the temporal dead zone during the effect's initial synchronous run —\n    // `runtime.effect()` calls `node.run()` before returning. Defer disposal until after\n    // the constructor returns so `handle.dispose()` is reachable from inside the callback.\n    let disposeAfterInit = false;\n\n    const handle = runtime.effect(\n      () => {\n        const value = read();\n\n        if (initial) {\n          initial = false;\n          previous = value;\n\n          if (options?.immediate) {\n            try {\n              runtime.untrack(() => callback(value, undefined));\n            } finally {\n              if (options?.once) disposeAfterInit = true;\n            }\n          }\n\n          return;\n        }\n\n        if (equals(previous as T, value)) return;\n\n        const oldValue = previous;\n\n        previous = value;\n        try {\n          runtime.untrack(() => callback(value, oldValue));\n        } finally {\n          if (options?.once) handle.dispose();\n        }\n      },\n      { name: options?.name },\n    );\n\n    if (disposeAfterInit) handle.dispose();\n\n    return handle;\n  };\n"],"mappings":"AAcA,IAAa,EACV,IAEC,EACA,EACA,IACiB,CACjB,IAAM,EAAO,OAAO,GAAW,WAAa,MAAe,EAAO,MAC5D,EAAS,GAAS,QAAU,OAAO,GACrC,EAAU,GACV,EAIA,EAAmB,GAEjB,EAAS,EAAQ,WACf,CACJ,IAAM,EAAQ,EAAK,EAEnB,GAAI,EAAS,CAIX,GAHA,EAAU,GACV,EAAW,EAEP,GAAS,UACX,GAAI,CACF,EAAQ,YAAc,EAAS,EAAO,IAAA,EAAS,CAAC,CAClD,QAAU,CACJ,GAAS,OAAM,EAAmB,GACxC,CAGF,MACF,CAEA,GAAI,EAAO,EAAe,CAAK,EAAG,OAElC,IAAM,EAAW,EAEjB,EAAW,EACX,GAAI,CACF,EAAQ,YAAc,EAAS,EAAO,CAAQ,CAAC,CACjD,QAAU,CACJ,GAAS,MAAM,EAAO,QAAQ,CACpC,CACF,EACA,CAAE,KAAM,GAAS,IAAK,CACxB,EAIA,OAFI,GAAkB,EAAO,QAAQ,EAE9B,CACT"}

package/dist/_watch.d.ts

@@ -9,6 +9,7 @@ type WatchRuntime = {
     effect(callback: () => undefined | (() => void), options?: {
         name?: string;
     }): EffectHandle;
+    untrack<T>(fn: () => T): T;
 };
 export declare const createWatch: (runtime: WatchRuntime) => <T>(source: Readable<T> | (() => T), callback: (value: T, previous: T | undefined) => void, options?: WatchOptions<T>) => EffectHandle;
 export {};

package/dist/_watch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_watch.d.ts","sourceRoot":"","sources":["../src/_watch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEhE,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,MAAM,CAAC,QAAQ,EAAE,MAAM,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY,CAAC;CAC7F,CAAC;AAEF,eAAO,MAAM,WAAW,GACrB,SAAS,YAAY,MACrB,CAAC,EACA,QAAQ,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAC/B,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,EACrD,UAAU,YAAY,CAAC,CAAC,CAAC,KACxB,YAyCF,CAAC"}
+{"version":3,"file":"_watch.d.ts","sourceRoot":"","sources":["../src/_watch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEhE,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,MAAM,CAAC,QAAQ,EAAE,MAAM,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY,CAAC;IAC5F,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,WAAW,GACrB,SAAS,YAAY,MACrB,CAAC,EACA,QAAQ,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAC/B,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,EACrD,UAAU,YAAY,CAAC,CAAC,CAAC,KACxB,YA8CF,CAAC"}

package/dist/_watch.js

@@ -1,14 +1,23 @@
 //#region src/_watch.ts
 var e = (e) => (t, n, r) => {
 	let i = typeof t == "function" ? t : () => t.value, a = r?.equals ?? Object.is, o = !0, s, c = !1, l = e.effect(() => {
-		let e = i();
+		let t = i();
 		if (o) {
-			o = !1, s = e, r?.immediate && (n(e, void 0), r?.once && (c = !0));
+			if (o = !1, s = t, r?.immediate) try {
+				e.untrack(() => n(t, void 0));
+			} finally {
+				r?.once && (c = !0);
+			}
 			return;
 		}
-		if (a(s, e)) return;
-		let t = s;
-		s = e, n(e, t), r?.once && l.dispose();
+		if (a(s, t)) return;
+		let u = s;
+		s = t;
+		try {
+			e.untrack(() => n(t, u));
+		} finally {
+			r?.once && l.dispose();
+		}
 	}, { name: r?.name });
 	return c && l.dispose(), l;
 };

package/dist/_watch.js.map

@@ -1 +1 @@
-{"version":3,"file":"_watch.js","names":[],"sources":["../src/_watch.ts"],"sourcesContent":["import type { EffectHandle, Equality, Readable } from './types';\n\nexport type WatchOptions<T> = {\n  equals?: Equality<T>;\n  immediate?: boolean;\n  name?: string;\n  once?: boolean;\n};\n\ntype WatchRuntime = {\n  effect(callback: () => undefined | (() => void), options?: { name?: string }): EffectHandle;\n};\n\nexport const createWatch =\n  (runtime: WatchRuntime) =>\n  <T>(\n    source: Readable<T> | (() => T),\n    callback: (value: T, previous: T | undefined) => void,\n    options?: WatchOptions<T>,\n  ): EffectHandle => {\n    const read = typeof source === 'function' ? source : () => source.value;\n    const equals = options?.equals ?? Object.is;\n    let initial = true;\n    let previous: T | undefined;\n    // `handle` is in the temporal dead zone during the effect's initial synchronous run —\n    // `runtime.effect()` calls `node.run()` before returning. Defer disposal until after\n    // the constructor returns so `handle.dispose()` is reachable from inside the callback.\n    let disposeAfterInit = false;\n\n    const handle = runtime.effect(\n      () => {\n        const value = read();\n\n        if (initial) {\n          initial = false;\n          previous = value;\n\n          if (options?.immediate) {\n            callback(value, undefined);\n            if (options?.once) disposeAfterInit = true;\n          }\n\n          return;\n        }\n\n        if (equals(previous as T, value)) return;\n\n        const oldValue = previous;\n\n        previous = value;\n        callback(value, oldValue);\n\n        if (options?.once) handle.dispose();\n      },\n      { name: options?.name },\n    );\n\n    if (disposeAfterInit) handle.dispose();\n\n    return handle;\n  };\n"],"mappings":";AAaA,IAAa,KACV,OAEC,GACA,GACA,MACiB;CACjB,IAAM,IAAO,OAAO,KAAW,aAAa,UAAe,EAAO,OAC5D,IAAS,GAAS,UAAU,OAAO,IACrC,IAAU,IACV,GAIA,IAAmB,IAEjB,IAAS,EAAQ,aACf;EACJ,IAAM,IAAQ,EAAK;EAEnB,IAAI,GAAS;GAIX,AAHA,IAAU,IACV,IAAW,GAEP,GAAS,cACX,EAAS,GAAO,KAAA,CAAS,GACrB,GAAS,SAAM,IAAmB;GAGxC;EACF;EAEA,IAAI,EAAO,GAAe,CAAK,GAAG;EAElC,IAAM,IAAW;EAKjB,AAHA,IAAW,GACX,EAAS,GAAO,CAAQ,GAEpB,GAAS,QAAM,EAAO,QAAQ;CACpC,GACA,EAAE,MAAM,GAAS,KAAK,CACxB;CAIA,OAFI,KAAkB,EAAO,QAAQ,GAE9B;AACT"}
+{"version":3,"file":"_watch.js","names":[],"sources":["../src/_watch.ts"],"sourcesContent":["import type { EffectHandle, Equality, Readable } from './types';\n\nexport type WatchOptions<T> = {\n  equals?: Equality<T>;\n  immediate?: boolean;\n  name?: string;\n  once?: boolean;\n};\n\ntype WatchRuntime = {\n  effect(callback: () => undefined | (() => void), options?: { name?: string }): EffectHandle;\n  untrack<T>(fn: () => T): T;\n};\n\nexport const createWatch =\n  (runtime: WatchRuntime) =>\n  <T>(\n    source: Readable<T> | (() => T),\n    callback: (value: T, previous: T | undefined) => void,\n    options?: WatchOptions<T>,\n  ): EffectHandle => {\n    const read = typeof source === 'function' ? source : () => source.value;\n    const equals = options?.equals ?? Object.is;\n    let initial = true;\n    let previous: T | undefined;\n    // `handle` is in the temporal dead zone during the effect's initial synchronous run —\n    // `runtime.effect()` calls `node.run()` before returning. Defer disposal until after\n    // the constructor returns so `handle.dispose()` is reachable from inside the callback.\n    let disposeAfterInit = false;\n\n    const handle = runtime.effect(\n      () => {\n        const value = read();\n\n        if (initial) {\n          initial = false;\n          previous = value;\n\n          if (options?.immediate) {\n            try {\n              runtime.untrack(() => callback(value, undefined));\n            } finally {\n              if (options?.once) disposeAfterInit = true;\n            }\n          }\n\n          return;\n        }\n\n        if (equals(previous as T, value)) return;\n\n        const oldValue = previous;\n\n        previous = value;\n        try {\n          runtime.untrack(() => callback(value, oldValue));\n        } finally {\n          if (options?.once) handle.dispose();\n        }\n      },\n      { name: options?.name },\n    );\n\n    if (disposeAfterInit) handle.dispose();\n\n    return handle;\n  };\n"],"mappings":";AAcA,IAAa,KACV,OAEC,GACA,GACA,MACiB;CACjB,IAAM,IAAO,OAAO,KAAW,aAAa,UAAe,EAAO,OAC5D,IAAS,GAAS,UAAU,OAAO,IACrC,IAAU,IACV,GAIA,IAAmB,IAEjB,IAAS,EAAQ,aACf;EACJ,IAAM,IAAQ,EAAK;EAEnB,IAAI,GAAS;GAIX,IAHA,IAAU,IACV,IAAW,GAEP,GAAS,WACX,IAAI;IACF,EAAQ,cAAc,EAAS,GAAO,KAAA,CAAS,CAAC;GAClD,UAAU;IACR,AAAI,GAAS,SAAM,IAAmB;GACxC;GAGF;EACF;EAEA,IAAI,EAAO,GAAe,CAAK,GAAG;EAElC,IAAM,IAAW;EAEjB,IAAW;EACX,IAAI;GACF,EAAQ,cAAc,EAAS,GAAO,CAAQ,CAAC;EACjD,UAAU;GACR,AAAI,GAAS,QAAM,EAAO,QAAQ;EACpC;CACF,GACA,EAAE,MAAM,GAAS,KAAK,CACxB;CAIA,OAFI,KAAkB,EAAO,QAAQ,GAE9B;AACT"}

package/dist/errors.cjs

@@ -1,2 +1,2 @@
-var e=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},t=class extends e{},n=class extends e{},r=class extends e{},i=class extends e{};exports.RippleComputedCycleError=t,exports.RippleDisposedRuntimeError=n,exports.RippleDisposedScopeError=r,exports.RippleError=e,exports.RippleInfiniteLoopError=i;
+var e=class extends Error{static errorName=`RippleError`;constructor(e,t){super(e,t),this.name=new.target.errorName,Object.setPrototypeOf(this,new.target.prototype)}},t=class extends e{static errorName=`RippleComputedCycleError`},n=class extends e{static errorName=`RippleDisposedResourceError`},r=class extends e{static errorName=`RippleDisposedRuntimeError`},i=class extends e{static errorName=`RippleDisposedScopeError`},a=class extends e{static errorName=`RippleInfiniteLoopError`};exports.RippleComputedCycleError=t,exports.RippleDisposedResourceError=n,exports.RippleDisposedRuntimeError=r,exports.RippleDisposedScopeError=i,exports.RippleError=e,exports.RippleInfiniteLoopError=a;
 //# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["export class RippleError extends Error {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class RippleComputedCycleError extends RippleError {}\nexport class RippleDisposedRuntimeError extends RippleError {}\nexport class RippleDisposedScopeError extends RippleError {}\nexport class RippleInfiniteLoopError extends RippleError {}\n"],"mappings":"AAAA,IAAa,EAAb,cAAiC,KAAM,CACrC,YAAY,EAAiB,EAAwB,CACnD,MAAM,EAAS,CAAO,EACtB,KAAK,KAAO,WAAW,KACvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAEa,EAAb,cAA8C,CAAY,CAAC,EAC9C,EAAb,cAAgD,CAAY,CAAC,EAChD,EAAb,cAA8C,CAAY,CAAC,EAC9C,EAAb,cAA6C,CAAY,CAAC"}
+{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["export class RippleError extends Error {\n  protected static readonly errorName: string = 'RippleError';\n\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = (new.target as typeof RippleError).errorName;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class RippleComputedCycleError extends RippleError {\n  protected static override readonly errorName = 'RippleComputedCycleError';\n}\nexport class RippleDisposedResourceError extends RippleError {\n  protected static override readonly errorName = 'RippleDisposedResourceError';\n}\nexport class RippleDisposedRuntimeError extends RippleError {\n  protected static override readonly errorName = 'RippleDisposedRuntimeError';\n}\nexport class RippleDisposedScopeError extends RippleError {\n  protected static override readonly errorName = 'RippleDisposedScopeError';\n}\nexport class RippleInfiniteLoopError extends RippleError {\n  protected static override readonly errorName = 'RippleInfiniteLoopError';\n}\n"],"mappings":"AAAA,IAAa,EAAb,cAAiC,KAAM,CACrC,OAA0B,UAAoB,cAE9C,YAAY,EAAiB,EAAwB,CACnD,MAAM,EAAS,CAAO,EACtB,KAAK,KAAQ,WAAkC,UAC/C,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAEa,EAAb,cAA8C,CAAY,CACxD,OAAmC,UAAY,0BACjD,EACa,EAAb,cAAiD,CAAY,CAC3D,OAAmC,UAAY,6BACjD,EACa,EAAb,cAAgD,CAAY,CAC1D,OAAmC,UAAY,4BACjD,EACa,EAAb,cAA8C,CAAY,CACxD,OAAmC,UAAY,0BACjD,EACa,EAAb,cAA6C,CAAY,CACvD,OAAmC,UAAY,yBACjD"}