@dougongjs/reactive 0.10.0 → 0.11.0

package/README.md

@@ -2,7 +2,7 @@
 
 Independent synchronous signals and structurally owned reactive generations. No external runtime dependencies.
 
-Upgrading from 0.8.3? Read the [migration guide](https://tangerg.github.io/dougong/en/guide/migrating-to-0.9) and [0.9.0 release notes](https://tangerg.github.io/dougong/en/reference/release-0.9.0).
+Upgrading from 0.9? Read the [migration guide](https://tangerg.github.io/dougong/en/guide/migrating-to-0.10) and [0.10.0 release notes](https://tangerg.github.io/dougong/en/reference/release-0.10.0). From 0.8.3, complete [Migrating to 0.9.0](https://tangerg.github.io/dougong/en/guide/migrating-to-0.9) first.
 
 ```ts
 import { batch, computed, disposeSymbol, signal } from "@dougongjs/reactive";

package/dist/abort.d.ts

@@ -1,4 +1,5 @@
+import { SynchronousResult } from './async-result.js';
 export declare function isAborted(signal: AbortSignal): boolean;
 export declare function abortReason(signal: AbortSignal): unknown;
-export declare function onAbort(signal: AbortSignal, callback: (reason: unknown) => void): () => void;
+export declare function onAbort<Result>(signal: AbortSignal, callback: (reason: unknown) => SynchronousResult<Result>): () => void;
 //# sourceMappingURL=abort.d.ts.map

package/dist/abort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAIA,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAEtD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAExD;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CA6B5F"}
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG9E,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAEtD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAExD;AAED,wBAAgB,OAAO,CAAC,MAAM,EAC5B,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,iBAAiB,CAAC,MAAM,CAAC,GACvD,MAAM,IAAI,CA6BZ"}

package/dist/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,eAAe,EAEpB,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAU,KAAK,cAAc,EAAe,MAAM,cAAc,CAAC;AAGxE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,OAAO,KAAK,eAAe,CAAC;CAC7D;AA4ID,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAmBpF"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,eAAe,EAEpB,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAiB,KAAK,cAAc,EAAe,MAAM,cAAc,CAAC;AAG/E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,OAAO,KAAK,eAAe,CAAC;CAC7D;AAyJD,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAmBpF"}

package/dist/index.js

@@ -228,7 +228,7 @@ var M = class {
 	}
 	#d() {
 		let e = this.#r;
-		if (e.phase === "error") throw e.error;
+		if (e.outcome === "error") throw e.error;
 		return e.value;
 	}
 	subscribeInvalidation(e) {
@@ -265,7 +265,7 @@ var M = class {
 			return;
 		}
 		let t = /* @__PURE__ */ new Set(), n = this.#v(t);
-		this.#y(t), (!e || (n.phase === "value" ? e.phase !== "value" || !Object.is(e.value, n.value) : e.phase !== "error" || !Object.is(e.error, n.error))) && this.#c++, this.#r = n, this.#i = g, this.#t.size && this.#h();
+		this.#y(t), (!e || (n.outcome === "value" ? e.outcome !== "value" || !Object.is(e.value, n.value) : e.outcome !== "error" || !Object.is(e.error, n.error))) && this.#c++, this.#r = n, this.#i = g, this.#t.size && this.#h();
 	}
 	#_() {
 		for (let [t, n] of this.#n) if (t instanceof e && t.#a !== void 0 || (t.refresh(), n.version !== t.version)) return !0;
@@ -277,12 +277,12 @@ var M = class {
 		try {
 			let e = this.#e, t = e();
 			return c(t, "Computed signal calculations must be synchronous"), {
-				phase: "value",
+				outcome: "value",
 				value: t
 			};
 		} catch (e) {
 			return {
-				phase: "error",
+				outcome: "error",
 				error: e
 			};
 		} finally {
@@ -299,7 +299,7 @@ var M = class {
 			});
 		}
 	}
-}, P = class {
+}, P = "Readable bridge has been disposed", F = class {
 	#e;
 	#t;
 	#n;
@@ -307,14 +307,14 @@ var M = class {
 	view;
 	constructor(e) {
 		this.#e = A({
-			phase: "value",
+			outcome: "value",
 			source: e,
 			value: e.get()
 		}), this.view = Object.freeze({
 			get: () => {
 				let e = this.#e?.get();
-				if (!e) throw Error("Readable bridge has been disposed");
-				if (e.phase === "error") throw e.error;
+				if (!e) throw Error(P);
+				if (e.outcome === "error") throw e.error;
 				return e.value;
 			},
 			subscribe: (e) => this.#o(e)
@@ -325,7 +325,7 @@ var M = class {
 		try {
 			n = p(e.defer(() => (this[r](), t ? Promise.resolve().then(() => this.#i()) : void 0)), "BridgeOwner.defer() must return an AsyncDisposable");
 			let i = this.#e?.get();
-			if (!i) throw Error("Readable bridge has been disposed");
+			if (!i) throw Error(P);
 			let a = f(i.source.subscribe(() => this.#a()));
 			if (this.#t = a, !this.#e?.get()) {
 				try {
@@ -333,7 +333,7 @@ var M = class {
 				} catch (e) {
 					this.#r = { value: e };
 				}
-				throw Error("Readable bridge has been disposed");
+				throw Error(P);
 			}
 			this.#a(), this.view.get();
 		} catch (e) {
@@ -347,34 +347,36 @@ var M = class {
 		if (this.#r) throw this.#r.value;
 	}
 	#a() {
-		let e = this.#e?.get();
-		if (!e) return;
-		let t = Symbol();
-		this.#n = t;
-		try {
-			let { source: n } = e, r;
+		k(() => {
+			let e = this.#e?.get();
+			if (!e) return;
+			let t = Symbol();
+			this.#n = t;
 			try {
-				r = {
-					phase: "value",
-					source: n,
-					value: n.get()
-				};
-			} catch (e) {
-				r = {
-					phase: "error",
-					source: n,
-					error: e
-				};
+				let { source: n } = e, r;
+				try {
+					r = {
+						outcome: "value",
+						source: n,
+						value: n.get()
+					};
+				} catch (e) {
+					r = {
+						outcome: "error",
+						source: n,
+						error: e
+					};
+				}
+				if (this.#n !== t || this.#e?.get() !== e || e.outcome === "value" && r.outcome === "value" && Object.is(e.value, r.value) || e.outcome === "error" && r.outcome === "error" && Object.is(e.error, r.error)) return;
+				this.#e?.set(r);
+			} finally {
+				this.#n = void 0;
 			}
-			if (this.#n !== t || this.#e?.get() !== e || e.phase === "value" && r.phase === "value" && Object.is(e.value, r.value) || e.phase === "error" && r.phase === "error" && Object.is(e.error, r.error)) return;
-			this.#e?.set(r);
-		} finally {
-			this.#n = void 0;
-		}
+		});
 	}
 	#o(e) {
 		let t = this.#e;
-		if (!t?.get()) throw Error("Readable bridge has been disposed");
+		if (!t?.get()) throw Error(P);
 		h(e);
 		let n = t.subscribe(() => (this.#e?.get() || n[r](), e()));
 		return n;
@@ -401,10 +403,10 @@ var M = class {
 		}
 	}
 };
-function F(e, t) {
+function I(e, t) {
 	let n = e?.defer;
 	if (typeof n != "function") throw TypeError("bridge() expects a resource owner");
-	let i = d(t, "bridge()"), a = { defer: (t) => Reflect.apply(n, e, [t]) }, o = new P(i);
+	let i = d(t, "bridge()"), a = { defer: (t) => Reflect.apply(n, e, [t]) }, o = new F(i);
 	try {
 		return o.start(a), o.view;
 	} catch (e) {
@@ -417,15 +419,15 @@ function F(e, t) {
 	}
 }
 // src/abort.ts
-function I(e) {
+function L(e) {
 	return Reflect.get(AbortSignal.prototype, "aborted", e);
 }
-function L(e) {
+function R(e) {
 	return Reflect.get(AbortSignal.prototype, "reason", e);
 }
-function R(t, n) {
+function z(t, n) {
 	if (typeof n != "function") throw TypeError("Abort listener must be a function");
-	if (I(t)) return n(L(t)), () => {};
+	if (L(t)) return B(n, R(t)), () => {};
 	let r = {
 		signal: t,
 		callback: n
@@ -434,14 +436,17 @@ function R(t, n) {
 		r = void 0, i?.(), i = void 0;
 	}
 	function o() {
-		if (!r || !I(r.signal)) return;
-		let { signal: e, callback: t } = r, n = L(e);
-		a(), t(n);
+		if (!r || !L(r.signal)) return;
+		let { signal: e, callback: t } = r, n = R(e);
+		a(), B(t, n);
 	}
 	return i = e(t, o), r ? o() : a(), a;
 }
+function B(e, t) {
+	c(e(t), "Abort listeners must be synchronous");
+}
 // src/observe.ts
-var z = class {
+var V = "observation", H = class {
 	#e;
 	#t;
 	#n;
@@ -510,7 +515,7 @@ var z = class {
 		} catch (t) {
 			e.push(t);
 		}
-		await V(this.#x(), e);
+		await W(this.#x(), e);
 		try {
 			await this.#b();
 		} catch (t) {
@@ -523,14 +528,14 @@ var z = class {
 		this.#e.phase === "active" && (this.#o = !0, this.#u?.());
 	}
 	async #g(e) {
-		let t = R(e, () => this.#u?.());
+		let t = z(e, () => this.#u?.());
 		try {
-			for (; this.#e.phase === "active" && !I(e);) {
+			for (; this.#e.phase === "active" && !L(e);) {
 				if (!this.#o) {
 					let e = Promise.withResolvers();
 					this.#u = e.resolve, await e.promise, this.#u = void 0;
 				}
-				for (; this.#e.phase === "active" && !I(e) && this.#o;) this.#o = !1, await this.#_(e);
+				for (; this.#e.phase === "active" && !L(e) && this.#o;) this.#o = !1, await this.#_(e);
 			}
 		} catch (e) {
 			if (this.#e.phase !== "active") throw e;
@@ -545,7 +550,7 @@ var z = class {
 		}
 	}
 	async #_(e) {
-		if (this.#e.phase !== "active" || I(e)) return;
+		if (this.#e.phase !== "active" || L(e)) return;
 		let t = this.#e.binding.source.get();
 		if (!(this.#a.present && Object.is(t, this.#a.value))) {
 			try {
@@ -553,14 +558,14 @@ var z = class {
 			} catch (e) {
 				throw this.#e.phase === "active" && await this.#C(), e;
 			}
-			this.#a = { present: !1 }, !(this.#e.phase !== "active" || I(e)) && this.#v(e);
+			this.#a = { present: !1 }, !(this.#e.phase !== "active" || L(e)) && this.#v(e);
 		}
 	}
 	#v(e) {
-		let { owner: t } = this.#w(), n = t.child("observation");
-		if (this.#n = p(n, "ObservationOwner.child() must return an AsyncDisposable"), e && I(e)) return;
+		let { owner: t } = this.#w(), n = t.child(V);
+		if (this.#n = p(n, "ObservationOwner.child() must return an AsyncDisposable"), e && L(e)) return;
 		let r = this.#w().source.get();
-		e && I(e) || (this.#y(r, n), this.#e.phase === "active" && (this.#a = {
+		e && L(e) || (this.#y(r, n), this.#e.phase === "active" && (this.#a = {
 			present: !0,
 			value: r
 		}));
@@ -594,7 +599,7 @@ var z = class {
 		this.#e = { phase: e }, this.#a = { present: !1 }, this.#o = !1;
 	}
 };
-function B(e, t, n) {
+function U(e, t, n) {
 	let r = d(t, "observe()");
 	if (typeof n != "function") throw TypeError("Observer must be a function");
 	let i = e?.defer, a = e?.child, o = e?.spawn;
@@ -603,10 +608,9 @@ function B(e, t, n) {
 		defer: (t) => Reflect.apply(i, e, [t]),
 		child: (t) => Reflect.apply(a, e, [t]),
 		spawn: (t) => Reflect.apply(o, e, [t])
-	}, l = new z(c, r, n), u = p(c.defer(() => l.dispose()), "ObservationOwner.defer() must return an AsyncDisposable");
-	l.attachOwnerCleanup(u);
+	}, l = new H(c, r, n), u = l.dispose.bind(l);
 	try {
-		return l.start(), l.handle;
+		return u = p(c.defer(u), "ObservationOwner.defer() must return an AsyncDisposable"), l.attachOwnerCleanup(u), l.start(), l.handle;
 	} catch (e) {
 		try {
 			s(u()).catch(() => void 0);
@@ -616,11 +620,11 @@ function B(e, t, n) {
 		throw e;
 	}
 }
-async function V(e, t) {
+async function W(e, t) {
 	if (e) try {
 		await s(e());
 	} catch (e) {
 		t.push(e);
 	}
 }
-export { i as asyncDisposeSymbol, k as batch, F as bridge, j as computed, r as disposeSymbol, B as observe, A as signal };
+export { i as asyncDisposeSymbol, k as batch, I as bridge, j as computed, r as disposeSymbol, U as observe, A as signal };

package/dist/observe.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"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;AA2P/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,CAkCjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dougongjs/reactive",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "type": "module",
   "engines": {
     "node": "^24.22.0 || >=26.10.0"

package/runtime/abort-listener.d.mts

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

package/runtime/abort-listener.mjs

@@ -1,4 +1,22 @@
 // Generated from tooling/internal/abort-listener.mjs. Run pnpm generate:internal.
+// The private dependent must take its state from the source's controller. A runtime whose
+// AbortSignal.any reads the public, shadowable properties instead would create a dependent
+// already aborted with a forged reason, which never reports the real cancellation.
+export function assertAbortRuntime(any) {
+  if (typeof any !== "function") {
+    throw new Error("Unsupported JavaScript runtime: AbortSignal.any is required");
+  }
+  const source = new AbortController().signal;
+  Object.defineProperty(source, "aborted", { value: true });
+  if (Reflect.get(AbortSignal.prototype, "aborted", any.call(AbortSignal, [source]))) {
+    throw new Error(
+      "Unsupported JavaScript runtime: AbortSignal.any must read native signal state",
+    );
+  }
+}
+
+assertAbortRuntime(AbortSignal.any);
+
 // A separate closure prevents the dependent from retaining the source through its registration.
 function weakAbortListener(reference) {
   return () => reference.deref()?.();