@dougongjs/reactive 0.8.3 → 0.10.0

package/dist/observe.d.ts

@@ -1,12 +1,13 @@
-import { AsyncDisposable, Readable } from './protocol';
-export interface ObservationTask<T = void> extends AsyncDisposable {
-    readonly result: Promise<T>;
+import { AsyncDisposable, Readable } from './protocol.js';
+import { SynchronousResult } from './async-result.js';
+export interface ObservationTask extends AsyncDisposable {
+    readonly result: PromiseLike<unknown>;
 }
 export interface ObservationOwner<Child extends AsyncDisposable = AsyncDisposable> {
-    readonly cleanup: (dispose: () => unknown) => AsyncDisposable;
-    readonly lifetime: (label: string) => Child;
-    readonly spawn: <T>(task: (signal: AbortSignal) => T | PromiseLike<T>) => ObservationTask<T>;
+    readonly defer: (dispose: () => unknown) => AsyncDisposable;
+    readonly child: (label: string) => Child;
+    readonly spawn: (task: (signal: AbortSignal) => void | PromiseLike<void>) => ObservationTask;
 }
-export type Observer<T, Child extends AsyncDisposable> = (value: T, lifetime: Child) => void;
-export declare function observe<T, Child extends AsyncDisposable>(owner: ObservationOwner<Child>, source: Readable<T>, observer: Observer<T, Child>): AsyncDisposable;
+export type Observer<T, Child extends AsyncDisposable, Result = void> = (value: T, lifetime: Child) => SynchronousResult<Result>;
+export declare function observe<T, Child extends AsyncDisposable, Result = void>(owner: ObservationOwner<Child>, source: Readable<T>, observer: Observer<T, Child, Result>): AsyncDisposable;
 //# sourceMappingURL=observe.d.ts.map

package/dist/observe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../src/observe.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EAEpB,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAKpB,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,IAAI,CAAE,SAAQ,eAAe;IAChE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,eAAe,GAAG,eAAe;IAC/E,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,OAAO,KAAK,eAAe,CAAC;IAC9D,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,eAAe,CAAC,CAAC,CAAC,CAAC;CAC9F;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,KAAK,SAAS,eAAe,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,KAAK,IAAI,CAAC;AAgN7F,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,SAAS,eAAe,EACtD,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAC9B,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,GAC3B,eAAe,CAyBjB"}
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../src/observe.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAI3B,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,eAAe,GAAG,eAAe;IAC/E,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,OAAO,KAAK,eAAe,CAAC;IAC5D,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,eAAe,CAAC;CAC9F;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,KAAK,SAAS,eAAe,EAAE,MAAM,GAAG,IAAI,IAAI,CACtE,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,KAAK,KACZ,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAyP/B,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,SAAS,eAAe,EAAE,MAAM,GAAG,IAAI,EACrE,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAC9B,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GACnC,eAAe,CAgCjB"}

package/dist/protocol.d.ts

@@ -1,14 +1,17 @@
-export { assertPromiseRuntime, resolveDisposalSymbol, asyncDisposeSymbol, disposeSymbol, } from './disposal-runtime';
+import { SynchronousResult } from './async-result.js';
+export { assertPromiseRuntime, resolveDisposalSymbol, asyncDisposeSymbol, disposeSymbol, } from './disposal-runtime.js';
 export interface Disposable {
-    dispose(): void;
     [Symbol.dispose](): void;
 }
 export interface AsyncDisposable {
-    dispose(): Promise<void>;
-    [Symbol.asyncDispose](): Promise<void>;
+    [Symbol.asyncDispose](): PromiseLike<void>;
 }
 export interface Readable<T> {
     get(): T;
-    subscribe(listener: () => void): Disposable;
+    subscribe<Result>(listener: () => SynchronousResult<Result>): Disposable;
 }
+export declare function captureReadable<T>(source: Readable<T>, operation: string): Readable<T>;
+export declare function captureUnsubscribe(subscription: Disposable): () => void;
+export declare function captureRelease(value: AsyncDisposable, message: string): () => PromiseLike<void>;
+export declare function assertListener(listener: unknown): asserts listener is () => void;
 //# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,IAAI,CAAC;IAChB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,GAAG,IAAI,CAAC,CAAC;IACT,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,UAAU,CAAC;CAC7C"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE9E,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,UAAU;IACzB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,GAAG,IAAI,CAAC,CAAC;IACT,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC;CAC1E;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAStF;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,UAAU,GAAG,MAAM,IAAI,CASvE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAI/F;AAQD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,IAAI,CAIhF"}

package/dist/signals.d.ts

@@ -1,4 +1,5 @@
-import { Readable } from './protocol';
+import { Readable } from './protocol.js';
+import { SynchronousResult } from './async-result.js';
 declare const dougongSignal: unique symbol;
 export interface ReadonlySignal<T> extends Readable<T> {
     readonly [dougongSignal]: true;
@@ -6,8 +7,8 @@ export interface ReadonlySignal<T> extends Readable<T> {
 export interface Signal<T> extends ReadonlySignal<T> {
     readonly set: (value: T) => void;
 }
-export declare function batch<T>(callback: () => T): T;
+export declare function batch<T>(callback: () => SynchronousResult<T>): T;
 export declare function signal<T>(initialValue: T): Signal<T>;
-export declare function computed<T>(calculate: () => T): ReadonlySignal<T>;
+export declare function computed<T>(calculate: () => SynchronousResult<T>): ReadonlySignal<T>;
 export {};
 //# sourceMappingURL=signals.d.ts.map

package/dist/signals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../src/signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3E,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAE3C,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,MAAM,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAClC;AA0GD,wBAAgB,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CA4B7C;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAEpD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAGjE"}
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../src/signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkD,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9F,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE9E,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAE3C,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,MAAM,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAClC;AAgHD,wBAAgB,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,CAgChE;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAEpD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAGpF"}

package/package.json

@@ -1,19 +1,20 @@
 {
   "name": "@dougongjs/reactive",
-  "version": "0.8.3",
+  "version": "0.10.0",
   "type": "module",
   "engines": {
-    "node": ">=22"
+    "node": "^24.22.0 || >=26.10.0"
   },
   "browserslist": [
     "Chrome >= 119",
     "Edge >= 119",
-    "Firefox >= 121",
+    "Firefox >= 124",
     "Safari >= 17.4"
   ],
   "sideEffects": false,
   "files": [
     "dist",
+    "runtime",
     "README.md",
     "LICENSE"
   ],
@@ -23,6 +24,12 @@
       "import": "./dist/index.js"
     }
   },
+  "imports": {
+    "#abort-listener": {
+      "types": "./runtime/abort-listener.d.mts",
+      "default": "./runtime/abort-listener.mjs"
+    }
+  },
   "description": "Zero-dependency signal, computed, batch and observe primitives.",
   "license": "MIT",
   "author": "Dougong contributors",
@@ -47,6 +54,6 @@
     "access": "public"
   },
   "scripts": {
-    "build": "node ../../scripts/generate-internal.mjs && vite build"
+    "build": "node ../../tooling/generate-internal.mjs && vite build"
   }
 }

package/runtime/abort-listener.d.mts

@@ -0,0 +1,2 @@
+// Generated from tooling/internal/abort-listener.d.mts. Run pnpm generate:internal.
+export function listenForAbort(signal: AbortSignal, notify: () => void): () => void;

package/runtime/abort-listener.mjs

@@ -0,0 +1,27 @@
+// Generated from tooling/internal/abort-listener.mjs. Run pnpm generate:internal.
+// A separate closure prevents the dependent from retaining the source through its registration.
+function weakAbortListener(reference) {
+  return () => reference.deref()?.();
+}
+
+export function listenForAbort(signal, notify) {
+  const dependent = AbortSignal.any([signal]);
+  const listener = weakAbortListener(new WeakRef(notify));
+  let registration = { signal, notify, dependent, listener };
+  function detach() {
+    if (!registration) return;
+    const attached = registration;
+    registration = undefined;
+    EventTarget.prototype.removeEventListener.call(attached.signal, "abort", attached.notify);
+    attached.dependent.removeEventListener("abort", attached.listener);
+  }
+  try {
+    // Source listeners preserve native composite lifetimes; the private dependent bypasses stopped events.
+    EventTarget.prototype.addEventListener.call(signal, "abort", notify);
+    dependent.addEventListener("abort", listener);
+  } catch (error) {
+    detach();
+    throw error;
+  }
+  return detach;
+}

package/dist/sync-result.d.ts

@@ -1,3 +0,0 @@
-export declare function assertSynchronous(value: unknown, message: string): void;
-export declare function captureThenable(value: unknown): Promise<unknown> | undefined;
-//# sourceMappingURL=sync-result.d.ts.map

package/dist/sync-result.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-result.d.ts","sourceRoot":"","sources":["../src/sync-result.ts"],"names":[],"mappings":"AACA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAOvE;AAGD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CAO5E"}