@vielzeug/ripple 2.3.0 → 26.10.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 createResource=n=>(r,i,a)=>{let o=n.signal({status:`pending`},{name:a?.name}),s=n.signal(0),c,l=!1,u,run=()=>{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=>{!d.disposed&&!t.signal.aborted&&(l=!0,u=e,o.value={status:`success`,value:e})},e=>{!d.disposed&&!t.signal.aborted&&(o.value=l?{error:e,previous:u,status:`error`}:{error:e,status:`error`})})},d=n.effect(()=>(run(),()=>c?.abort()),{name:a?.name}),assertActive=()=>{if(d.disposed)throw new e.RippleDisposedResourceError(`Cannot use a disposed resource.`)},f={get disposalSignal(){return d.disposalSignal},dispose:()=>d.dispose(),get disposed(){return d.disposed},get name(){return o.name},peek:()=>o.peek(),reload:()=>{assertActive(),s.value=s.peek()+1},subscribe:e=>(assertActive(),o.subscribe(e)),[Symbol.dispose](){this.dispose()},get value(){return o.value}};return Object.defineProperty(f,t.REACTIVE,{value:!0}),f};exports.createResource=createResource;
 //# 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,QAAkB,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,IAAI,MAES,GAAQ,MAAM,GAE7B,CAAE,KAAM,GAAS,IAAK,CACxB,EAEM,iBAA2B,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,aAAa,EACb,EAAY,MAAQ,EAAY,KAAK,EAAI,CAC3C,EACA,UAAY,IACV,aAAa,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,2 @@
-import { REACTIVE as e } 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;
-		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, { value: !0 }), u;
-};
-//#endregion
-export { t as createResource };
-
+import{RippleDisposedResourceError as e}from"./errors.js";import{REACTIVE as t}from"./runtime.js";var createResource=n=>(r,i,a)=>{let o=n.signal({status:`pending`},{name:a?.name}),s=n.signal(0),c,l=!1,u,run=()=>{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=>{!d.disposed&&!t.signal.aborted&&(l=!0,u=e,o.value={status:`success`,value:e})},e=>{!d.disposed&&!t.signal.aborted&&(o.value=l?{error:e,previous:u,status:`error`}:{error:e,status:`error`})})},d=n.effect(()=>(run(),()=>c?.abort()),{name:a?.name}),assertActive=()=>{if(d.disposed)throw new e(`Cannot use a disposed resource.`)},f={get disposalSignal(){return d.disposalSignal},dispose:()=>d.dispose(),get disposed(){return d.disposed},get name(){return o.name},peek:()=>o.peek(),reload:()=>{assertActive(),s.value=s.peek()+1},subscribe:e=>(assertActive(),o.subscribe(e)),[Symbol.dispose](){this.dispose()},get value(){return o.value}};return Object.defineProperty(f,t,{value:!0}),f};export{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":"kGAuBA,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,QAAkB,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,IAAI,MAES,GAAQ,MAAM,GAE7B,CAAE,KAAM,GAAS,IAAK,CACxB,EAEM,iBAA2B,CAC/B,GAAI,EAAK,SAAU,MAAM,IAAI,EAA4B,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,aAAa,EACb,EAAY,MAAQ,EAAY,KAAK,EAAI,CAC3C,EACA,UAAY,IACV,aAAa,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,EAAU,CAAE,MAAO,EAAK,CAAC,EAElD,CACT"}

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 createRipple=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()}},i=createRipple();exports.createRipple=createRipple,exports.defaultRipple=i;
 //# 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,aAAgB,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,aAAa"}

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,2 @@
-import { ReactiveRuntime as e } from "./runtime.js";
-import { createResource as t } from "./_async.js";
-import { createWatch as n } from "./_watch.js";
-//#region src/_default.ts
-var r = (r) => {
-	let i = new e(r), a = t(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(i),
-		[Symbol.dispose]: () => i.dispose()
-	};
-}, i = r();
-//#endregion
-export { r as createRipple, i as defaultRipple };
-
+import{ReactiveRuntime as e}from"./runtime.js";import{createResource as t}from"./_async.js";import{createFromSubscribable as n}from"./_subscribable.js";import{createWatch as r}from"./_watch.js";var createRipple=i=>{let a=new e(i),o=n(a),s=t(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(a),[Symbol.dispose]:()=>a.dispose()}},i=createRipple();export{createRipple,i 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":"kMA+CA,IAAa,aAAgB,GAAoC,CAC/D,IAAM,EAAU,IAAI,EAAgB,CAAO,EACrC,EAAmB,EAAuB,CAAO,EACjD,EAAW,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,EAAY,CAAO,GACzB,OAAO,aAAgB,EAAQ,QAAQ,CAC1C,CACF,EAUa,EAAgB,aAAa"}

package/dist/_subscribable.cjs

@@ -0,0 +1,2 @@
+const e=require("./errors.cjs"),t=require("./runtime.cjs");var createFromSubscribable=n=>(r,i)=>{let a=n.signal(r.getSnapshot(),{name:i?.name}),o=n.effect(()=>{let sync=()=>{a.value=r.getSnapshot()},e;try{e=r.subscribe(sync),sync()}catch(t){throw e?.(),t}return e},{name:i?.name}),abort=()=>o.dispose();i?.signal?.addEventListener(`abort`,abort,{once:!0}),i?.signal?.aborted&&o.dispose();let assertActive=()=>{if(o.disposed)throw new e.RippleError(`Cannot subscribe to a disposed bridge.`)},dispose=()=>{i?.signal?.removeEventListener(`abort`,abort),o.dispose()},s={get disposalSignal(){return o.disposalSignal},dispose,get disposed(){return o.disposed},get name(){return a.name},peek:()=>a.peek(),subscribe(e){return assertActive(),a.subscribe(e)},[Symbol.dispose]:dispose,get value(){return a.value}};return Object.defineProperty(s,t.REACTIVE,{value:!0}),s};exports.createFromSubscribable=createFromSubscribable;
+//# 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,uBACV,IACG,EAAyB,IAA0D,CACrF,IAAM,EAAO,EAAQ,OAAU,EAAO,YAAY,EAAG,CAAE,KAAM,GAAS,IAAK,CAAC,EACtE,EAAO,EAAQ,WACb,CACJ,IAAM,SAAa,CACjB,EAAK,MAAQ,EAAO,YAAY,CAClC,EACI,EAEJ,GAAI,CACF,EAAc,EAAO,UAAU,IAAI,EACnC,KAAK,CACP,OAAS,EAAO,CAEd,MADA,IAAc,EACR,CACR,CAEA,OAAO,CACT,EACA,CAAE,KAAM,GAAS,IAAK,CACxB,EACM,UAAc,EAAK,QAAQ,EAEjC,GAAS,QAAQ,iBAAiB,QAAS,MAAO,CAAE,KAAM,EAAK,CAAC,EAC5D,GAAS,QAAQ,SAAS,EAAK,QAAQ,EAE3C,IAAM,iBAA2B,CAC/B,GAAI,EAAK,SAAU,MAAM,IAAI,EAAA,YAAY,wCAAwC,CACnF,EACM,YAAsB,CAC1B,GAAS,QAAQ,oBAAoB,QAAS,KAAK,EACnD,EAAK,QAAQ,CACf,EACM,EAA+B,CACnC,IAAI,gBAAiB,CACnB,OAAO,EAAK,cACd,EACA,QACA,IAAI,UAAW,CACb,OAAO,EAAK,QACd,EACA,IAAI,MAAO,CACT,OAAO,EAAK,IACd,EACA,SAAY,EAAK,KAAK,EACtB,UAAU,EAAU,CAElB,OADA,aAAa,EACN,EAAK,UAAU,CAAQ,CAChC,GACC,OAAO,SAAU,QAClB,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,2 @@
+import{RippleError as e}from"./errors.js";import{REACTIVE as t}from"./runtime.js";var createFromSubscribable=n=>(r,i)=>{let a=n.signal(r.getSnapshot(),{name:i?.name}),o=n.effect(()=>{let sync=()=>{a.value=r.getSnapshot()},e;try{e=r.subscribe(sync),sync()}catch(t){throw e?.(),t}return e},{name:i?.name}),abort=()=>o.dispose();i?.signal?.addEventListener(`abort`,abort,{once:!0}),i?.signal?.aborted&&o.dispose();let assertActive=()=>{if(o.disposed)throw new e(`Cannot subscribe to a disposed bridge.`)},dispose=()=>{i?.signal?.removeEventListener(`abort`,abort),o.dispose()},s={get disposalSignal(){return o.disposalSignal},dispose,get disposed(){return o.disposed},get name(){return a.name},peek:()=>a.peek(),subscribe(e){return assertActive(),a.subscribe(e)},[Symbol.dispose]:dispose,get value(){return a.value}};return Object.defineProperty(s,t,{value:!0}),s};export{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":"kFAYA,IAAa,uBACV,IACG,EAAyB,IAA0D,CACrF,IAAM,EAAO,EAAQ,OAAU,EAAO,YAAY,EAAG,CAAE,KAAM,GAAS,IAAK,CAAC,EACtE,EAAO,EAAQ,WACb,CACJ,IAAM,SAAa,CACjB,EAAK,MAAQ,EAAO,YAAY,CAClC,EACI,EAEJ,GAAI,CACF,EAAc,EAAO,UAAU,IAAI,EACnC,KAAK,CACP,OAAS,EAAO,CAEd,MADA,IAAc,EACR,CACR,CAEA,OAAO,CACT,EACA,CAAE,KAAM,GAAS,IAAK,CACxB,EACM,UAAc,EAAK,QAAQ,EAEjC,GAAS,QAAQ,iBAAiB,QAAS,MAAO,CAAE,KAAM,EAAK,CAAC,EAC5D,GAAS,QAAQ,SAAS,EAAK,QAAQ,EAE3C,IAAM,iBAA2B,CAC/B,GAAI,EAAK,SAAU,MAAM,IAAI,EAAY,wCAAwC,CACnF,EACM,YAAsB,CAC1B,GAAS,QAAQ,oBAAoB,QAAS,KAAK,EACnD,EAAK,QAAQ,CACf,EACM,EAA+B,CACnC,IAAI,gBAAiB,CACnB,OAAO,EAAK,cACd,EACA,QACA,IAAI,UAAW,CACb,OAAO,EAAK,QACd,EACA,IAAI,MAAO,CACT,OAAO,EAAK,IACd,EACA,SAAY,EAAK,KAAK,EACtB,UAAU,EAAU,CAElB,OADA,aAAa,EACN,EAAK,UAAU,CAAQ,CAChC,GACC,OAAO,SAAU,QAClB,IAAI,OAAQ,CACV,OAAO,EAAK,KACd,CACF,EAGA,OADA,OAAO,eAAe,EAAU,EAAU,CAAE,MAAO,EAAK,CAAC,EAClD,CACT"}

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 createWatch=e=>(t,n,r)=>{let i=typeof t==`function`?t:()=>t.value,a=r?.equals??Object.is,o=!0,s;return e.effect(()=>{let t=i();if(o){o=!1,s=t,r?.immediate&&e.untrack(()=>n(t,void 0));return}if(a(s,t))return;let c=s;s=t,e.untrack(()=>n(t,c))},{name:r?.name})};exports.createWatch=createWatch;
 //# 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};\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\n    return runtime.effect(\n      () => {\n        const value = read();\n\n        if (initial) {\n          initial = false;\n          previous = value;\n\n          if (options?.immediate) runtime.untrack(() => callback(value, undefined));\n\n          return;\n        }\n\n        if (equals(previous as T, value)) return;\n\n        const oldValue = previous;\n\n        previous = value;\n        runtime.untrack(() => callback(value, oldValue));\n      },\n      { name: options?.name },\n    );\n  };\n"],"mappings":"AAaA,IAAa,YACV,IAEC,EACA,EACA,IACiB,CACjB,IAAM,EAAO,OAAO,GAAW,WAAa,MAAe,EAAO,MAC5D,EAAS,GAAS,QAAU,OAAO,GACrC,EAAU,GACV,EAEJ,OAAO,EAAQ,WACP,CACJ,IAAM,EAAQ,EAAK,EAEnB,GAAI,EAAS,CACX,EAAU,GACV,EAAW,EAEP,GAAS,WAAW,EAAQ,YAAc,EAAS,EAAO,IAAA,EAAS,CAAC,EAExE,MACF,CAEA,GAAI,EAAO,EAAe,CAAK,EAAG,OAElC,IAAM,EAAW,EAEjB,EAAW,EACX,EAAQ,YAAc,EAAS,EAAO,CAAQ,CAAC,CACjD,EACA,CAAE,KAAM,GAAS,IAAK,CACxB,CACF"}

package/dist/_watch.d.ts

@@ -3,12 +3,12 @@ export type WatchOptions<T> = {
     equals?: Equality<T>;
     immediate?: boolean;
     name?: string;
-    once?: boolean;
 };
 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;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,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,YA4BF,CAAC"}

package/dist/_watch.js

@@ -1,18 +1,2 @@
-//#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();
-		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;
-};
-//#endregion
-export { e as createWatch };
-
+var createWatch=e=>(t,n,r)=>{let i=typeof t==`function`?t:()=>t.value,a=r?.equals??Object.is,o=!0,s;return e.effect(()=>{let t=i();if(o){o=!1,s=t,r?.immediate&&e.untrack(()=>n(t,void 0));return}if(a(s,t))return;let c=s;s=t,e.untrack(()=>n(t,c))},{name:r?.name})};export{createWatch};
 //# sourceMappingURL=_watch.js.map

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};\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\n    return runtime.effect(\n      () => {\n        const value = read();\n\n        if (initial) {\n          initial = false;\n          previous = value;\n\n          if (options?.immediate) runtime.untrack(() => callback(value, undefined));\n\n          return;\n        }\n\n        if (equals(previous as T, value)) return;\n\n        const oldValue = previous;\n\n        previous = value;\n        runtime.untrack(() => callback(value, oldValue));\n      },\n      { name: options?.name },\n    );\n  };\n"],"mappings":"AAaA,IAAa,YACV,IAEC,EACA,EACA,IACiB,CACjB,IAAM,EAAO,OAAO,GAAW,WAAa,MAAe,EAAO,MAC5D,EAAS,GAAS,QAAU,OAAO,GACrC,EAAU,GACV,EAEJ,OAAO,EAAQ,WACP,CACJ,IAAM,EAAQ,EAAK,EAEnB,GAAI,EAAS,CACX,EAAU,GACV,EAAW,EAEP,GAAS,WAAW,EAAQ,YAAc,EAAS,EAAO,IAAA,EAAS,CAAC,EAExE,MACF,CAEA,GAAI,EAAO,EAAe,CAAK,EAAG,OAElC,IAAM,EAAW,EAEjB,EAAW,EACX,EAAQ,YAAc,EAAS,EAAO,CAAQ,CAAC,CACjD,EACA,CAAE,KAAM,GAAS,IAAK,CACxB,CACF"}

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 RippleError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},RippleComputedCycleError=class extends RippleError{},RippleDisposedResourceError=class extends RippleError{},RippleDisposedRuntimeError=class extends RippleError{},RippleDisposedScopeError=class extends RippleError{},RippleInfiniteLoopError=class extends RippleError{};exports.RippleComputedCycleError=RippleComputedCycleError,exports.RippleDisposedResourceError=RippleDisposedResourceError,exports.RippleDisposedRuntimeError=RippleDisposedRuntimeError,exports.RippleDisposedScopeError=RippleDisposedScopeError,exports.RippleError=RippleError,exports.RippleInfiniteLoopError=RippleInfiniteLoopError;
 //# 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  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 RippleDisposedResourceError extends RippleError {}\nexport class RippleDisposedRuntimeError extends RippleError {}\nexport class RippleDisposedScopeError extends RippleError {}\nexport class RippleInfiniteLoopError extends RippleError {}\n"],"mappings":"AAAA,IAAa,YAAb,cAAiC,KAAM,CACrC,YAAY,EAAiB,EAAwB,CACnD,MAAM,EAAS,CAAO,EACtB,KAAK,KAAO,WAAW,KACvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAEa,yBAAb,cAA8C,WAAY,CAAC,EAC9C,4BAAb,cAAiD,WAAY,CAAC,EACjD,2BAAb,cAAgD,WAAY,CAAC,EAChD,yBAAb,cAA8C,WAAY,CAAC,EAC9C,wBAAb,cAA6C,WAAY,CAAC"}

package/dist/errors.d.ts

@@ -3,6 +3,8 @@ export declare class RippleError extends Error {
 }
 export declare class RippleComputedCycleError extends RippleError {
 }
+export declare class RippleDisposedResourceError extends RippleError {
+}
 export declare class RippleDisposedRuntimeError extends RippleError {
 }
 export declare class RippleDisposedScopeError extends RippleError {

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKpD;AAED,qBAAa,wBAAyB,SAAQ,WAAW;CAAG;AAC5D,qBAAa,0BAA2B,SAAQ,WAAW;CAAG;AAC9D,qBAAa,wBAAyB,SAAQ,WAAW;CAAG;AAC5D,qBAAa,uBAAwB,SAAQ,WAAW;CAAG"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKpD;AAED,qBAAa,wBAAyB,SAAQ,WAAW;CAAG;AAC5D,qBAAa,2BAA4B,SAAQ,WAAW;CAAG;AAC/D,qBAAa,0BAA2B,SAAQ,WAAW;CAAG;AAC9D,qBAAa,wBAAyB,SAAQ,WAAW;CAAG;AAC5D,qBAAa,uBAAwB,SAAQ,WAAW;CAAG"}

package/dist/errors.js

@@ -1,10 +1,2 @@
-//#region src/errors.ts
-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 {};
-//#endregion
-export { t as RippleComputedCycleError, n as RippleDisposedRuntimeError, r as RippleDisposedScopeError, e as RippleError, i as RippleInfiniteLoopError };
-
+var RippleError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},RippleComputedCycleError=class extends RippleError{},RippleDisposedResourceError=class extends RippleError{},RippleDisposedRuntimeError=class extends RippleError{},RippleDisposedScopeError=class extends RippleError{},RippleInfiniteLoopError=class extends RippleError{};export{RippleComputedCycleError,RippleDisposedResourceError,RippleDisposedRuntimeError,RippleDisposedScopeError,RippleError,RippleInfiniteLoopError};
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","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,IAAb,cAAiC,MAAM;CACrC,YAAY,GAAiB,GAAwB;EAGnD,AAFA,MAAM,GAAS,CAAO,GACtB,KAAK,OAAO,WAAW,MACvB,OAAO,eAAe,MAAM,WAAW,SAAS;CAClD;AACF,GAEa,IAAb,cAA8C,EAAY,CAAC,GAC9C,IAAb,cAAgD,EAAY,CAAC,GAChD,IAAb,cAA8C,EAAY,CAAC,GAC9C,IAAb,cAA6C,EAAY,CAAC"}
+{"version":3,"file":"errors.js","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 RippleDisposedResourceError extends RippleError {}\nexport class RippleDisposedRuntimeError extends RippleError {}\nexport class RippleDisposedScopeError extends RippleError {}\nexport class RippleInfiniteLoopError extends RippleError {}\n"],"mappings":"AAAA,IAAa,YAAb,cAAiC,KAAM,CACrC,YAAY,EAAiB,EAAwB,CACnD,MAAM,EAAS,CAAO,EACtB,KAAK,KAAO,WAAW,KACvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAEa,yBAAb,cAA8C,WAAY,CAAC,EAC9C,4BAAb,cAAiD,WAAY,CAAC,EACjD,2BAAb,cAAgD,WAAY,CAAC,EAChD,yBAAb,cAA8C,WAAY,CAAC,EAC9C,wBAAb,cAA6C,WAAY,CAAC"}

package/dist/index.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./errors.cjs"),t=require("./runtime.cjs"),n=require("./_default.cjs");var r=n.defaultRipple.signal,i=n.defaultRipple.computed,a=n.defaultRipple.effect,o=n.defaultRipple.batch,s=n.defaultRipple.createScope,c=n.defaultRipple.untrack,l=n.defaultRipple.watch,u=n.defaultRipple.resource;exports.RippleComputedCycleError=e.RippleComputedCycleError,exports.RippleDisposedRuntimeError=e.RippleDisposedRuntimeError,exports.RippleDisposedScopeError=e.RippleDisposedScopeError,exports.RippleError=e.RippleError,exports.RippleInfiniteLoopError=e.RippleInfiniteLoopError,exports.batch=o,exports.computed=i,exports.createRipple=n.createRipple,exports.createScope=s,exports.effect=a,exports.isReactive=t.isReactive,exports.resource=u,exports.signal=r,exports.untrack=c,exports.watch=l;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./errors.cjs"),t=require("./runtime.cjs"),n=require("./_default.cjs");var r=n.defaultRipple.signal,i=n.defaultRipple.computed,a=n.defaultRipple.effect,o=n.defaultRipple.batch,s=n.defaultRipple.createScope,c=n.defaultRipple.untrack,l=n.defaultRipple.watch,u=n.defaultRipple.resource,d=n.defaultRipple.fromSubscribable;exports.RippleComputedCycleError=e.RippleComputedCycleError,exports.RippleDisposedResourceError=e.RippleDisposedResourceError,exports.RippleDisposedRuntimeError=e.RippleDisposedRuntimeError,exports.RippleDisposedScopeError=e.RippleDisposedScopeError,exports.RippleError=e.RippleError,exports.RippleInfiniteLoopError=e.RippleInfiniteLoopError,exports.batch=o,exports.computed=i,exports.createRipple=n.createRipple,exports.createScope=s,exports.effect=a,exports.fromSubscribable=d,exports.isReactive=t.isReactive,exports.resource=u,exports.signal=r,exports.untrack=c,exports.watch=l;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["export type { AsyncState, Resource, ResourceOptions } from './_async';\nexport { createRipple, type Ripple } from './_default';\nexport type { WatchOptions } from './_watch';\nexport {\n  RippleComputedCycleError,\n  RippleDisposedRuntimeError,\n  RippleDisposedScopeError,\n  RippleError,\n  RippleInfiniteLoopError,\n} from './errors';\nexport { isReactive } from './runtime';\nexport type {\n  Cleanup,\n  ComputedOptions,\n  Disposable,\n  EffectHandle,\n  EffectOptions,\n  Equality,\n  ReactiveErrorContext,\n  ReactiveEvent,\n  ReactiveObserver,\n  Readable,\n  RippleOptions,\n  Scope,\n  Signal,\n  SignalOptions,\n  Unsubscribe,\n} from './types';\n\nimport { defaultRipple } from './_default';\n\nexport const signal = defaultRipple.signal;\nexport const computed = defaultRipple.computed;\nexport const effect = defaultRipple.effect;\nexport const batch = defaultRipple.batch;\nexport const createScope = defaultRipple.createScope;\nexport const untrack = defaultRipple.untrack;\nexport const watch = defaultRipple.watch;\nexport const resource = defaultRipple.resource;\n"],"mappings":"0JA+BA,IAAa,EAAS,EAAA,cAAc,OACvB,EAAW,EAAA,cAAc,SACzB,EAAS,EAAA,cAAc,OACvB,EAAQ,EAAA,cAAc,MACtB,EAAc,EAAA,cAAc,YAC5B,EAAU,EAAA,cAAc,QACxB,EAAQ,EAAA,cAAc,MACtB,EAAW,EAAA,cAAc"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["export type { AsyncState, Resource, ResourceOptions } from './_async';\nexport { createRipple, type Ripple } from './_default';\nexport type { BridgedReadable, FromSubscribableOptions } from './_subscribable';\nexport type { WatchOptions } from './_watch';\nexport {\n  RippleComputedCycleError,\n  RippleDisposedResourceError,\n  RippleDisposedRuntimeError,\n  RippleDisposedScopeError,\n  RippleError,\n  RippleInfiniteLoopError,\n} from './errors';\nexport { isReactive } from './runtime';\nexport type {\n  Cleanup,\n  ComputedOptions,\n  Disposable,\n  EffectHandle,\n  EffectOptions,\n  Equality,\n  Readable,\n  RippleErrorContext,\n  RippleErrorPolicy,\n  RippleEvent,\n  RippleOptions,\n  Scope,\n  Signal,\n  SignalOptions,\n  Subscribable,\n  Unsubscribe,\n} from './types';\n\nimport { defaultRipple } from './_default';\n\nexport const signal = defaultRipple.signal;\nexport const computed = defaultRipple.computed;\nexport const effect = defaultRipple.effect;\nexport const batch = defaultRipple.batch;\nexport const createScope = defaultRipple.createScope;\nexport const untrack = defaultRipple.untrack;\nexport const watch = defaultRipple.watch;\nexport const resource = defaultRipple.resource;\nexport const fromSubscribable = defaultRipple.fromSubscribable;\n"],"mappings":"0JAkCA,IAAa,EAAS,EAAA,cAAc,OACvB,EAAW,EAAA,cAAc,SACzB,EAAS,EAAA,cAAc,OACvB,EAAQ,EAAA,cAAc,MACtB,EAAc,EAAA,cAAc,YAC5B,EAAU,EAAA,cAAc,QACxB,EAAQ,EAAA,cAAc,MACtB,EAAW,EAAA,cAAc,SACzB,EAAmB,EAAA,cAAc"}

package/dist/index.d.ts

@@ -1,9 +1,10 @@
 export type { AsyncState, Resource, ResourceOptions } from './_async';
 export { createRipple, type Ripple } from './_default';
+export type { BridgedReadable, FromSubscribableOptions } from './_subscribable';
 export type { WatchOptions } from './_watch';
-export { RippleComputedCycleError, RippleDisposedRuntimeError, RippleDisposedScopeError, RippleError, RippleInfiniteLoopError, } from './errors';
+export { RippleComputedCycleError, RippleDisposedResourceError, RippleDisposedRuntimeError, RippleDisposedScopeError, RippleError, RippleInfiniteLoopError, } from './errors';
 export { isReactive } from './runtime';
-export type { Cleanup, ComputedOptions, Disposable, EffectHandle, EffectOptions, Equality, ReactiveErrorContext, ReactiveEvent, ReactiveObserver, Readable, RippleOptions, Scope, Signal, SignalOptions, Unsubscribe, } from './types';
+export type { Cleanup, ComputedOptions, Disposable, EffectHandle, EffectOptions, Equality, Readable, RippleErrorContext, RippleErrorPolicy, RippleEvent, RippleOptions, Scope, Signal, SignalOptions, Subscribable, Unsubscribe, } from './types';
 export declare const signal: <T>(initial: T, options?: import("./types").SignalOptions<T>) => import("./types").Signal<T>;
 export declare const computed: <T>(derive: () => T, options?: import("./types").ComputedOptions<T>) => import("./types").Readable<T>;
 export declare const effect: (callback: () => import("./types").Cleanup | undefined, options?: import("./types").EffectOptions) => import("./types").EffectHandle;
@@ -14,4 +15,5 @@ export declare const watch: <T>(source: import("./types").Readable<T> | (() => T
 export declare const resource: <Source, Value>(source: () => Source, loader: (source: Source, context: {
     readonly signal: AbortSignal;
 }) => Promise<Value>, options?: import("./_async").ResourceOptions) => import("./_async").Resource<Value>;
+export declare const fromSubscribable: <T>(source: import("./types").Subscribable<T>, options?: import("./_subscribable").FromSubscribableOptions) => import("./_subscribable").BridgedReadable<T>;
 //# sourceMappingURL=index.d.ts.map