@pyreon/reactivity 0.18.0 → 0.20.0

package/lib/analysis/index.js.html

@@ -5386,7 +5386,7 @@ var drawChart = (function (exports) {
   </script>
   <script>
     /*<!--*/
-    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"src","children":[{"uid":"a1cf068b-1","name":"batch.ts"},{"uid":"a1cf068b-3","name":"cell.ts"},{"uid":"a1cf068b-5","name":"scope.ts"},{"uid":"a1cf068b-7","name":"tracking.ts"},{"uid":"a1cf068b-9","name":"effect.ts"},{"uid":"a1cf068b-11","name":"computed.ts"},{"uid":"a1cf068b-13","name":"createSelector.ts"},{"uid":"a1cf068b-15","name":"debug.ts"},{"uid":"a1cf068b-17","name":"signal.ts"},{"uid":"a1cf068b-19","name":"store.ts"},{"uid":"a1cf068b-21","name":"reconcile.ts"},{"uid":"a1cf068b-23","name":"resource.ts"},{"uid":"a1cf068b-25","name":"watch.ts"},{"uid":"a1cf068b-27","name":"index.ts"}]}]}],"isRoot":true},"nodeParts":{"a1cf068b-1":{"renderedLength":3016,"gzipLength":1167,"brotliLength":0,"metaUid":"a1cf068b-0"},"a1cf068b-3":{"renderedLength":1636,"gzipLength":786,"brotliLength":0,"metaUid":"a1cf068b-2"},"a1cf068b-5":{"renderedLength":3026,"gzipLength":1226,"brotliLength":0,"metaUid":"a1cf068b-4"},"a1cf068b-7":{"renderedLength":2227,"gzipLength":858,"brotliLength":0,"metaUid":"a1cf068b-6"},"a1cf068b-9":{"renderedLength":7391,"gzipLength":2397,"brotliLength":0,"metaUid":"a1cf068b-8"},"a1cf068b-11":{"renderedLength":4548,"gzipLength":1464,"brotliLength":0,"metaUid":"a1cf068b-10"},"a1cf068b-13":{"renderedLength":2244,"gzipLength":981,"brotliLength":0,"metaUid":"a1cf068b-12"},"a1cf068b-15":{"renderedLength":2469,"gzipLength":1092,"brotliLength":0,"metaUid":"a1cf068b-14"},"a1cf068b-17":{"renderedLength":2818,"gzipLength":1191,"brotliLength":0,"metaUid":"a1cf068b-16"},"a1cf068b-19":{"renderedLength":5143,"gzipLength":1835,"brotliLength":0,"metaUid":"a1cf068b-18"},"a1cf068b-21":{"renderedLength":2109,"gzipLength":867,"brotliLength":0,"metaUid":"a1cf068b-20"},"a1cf068b-23":{"renderedLength":1205,"gzipLength":524,"brotliLength":0,"metaUid":"a1cf068b-22"},"a1cf068b-25":{"renderedLength":1249,"gzipLength":582,"brotliLength":0,"metaUid":"a1cf068b-24"},"a1cf068b-27":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"a1cf068b-26"}},"nodeMetas":{"a1cf068b-0":{"id":"/src/batch.ts","moduleParts":{"index.js":"a1cf068b-1"},"imported":[],"importedBy":[{"uid":"a1cf068b-26"},{"uid":"a1cf068b-10"},{"uid":"a1cf068b-16"},{"uid":"a1cf068b-6"}]},"a1cf068b-2":{"id":"/src/cell.ts","moduleParts":{"index.js":"a1cf068b-3"},"imported":[],"importedBy":[{"uid":"a1cf068b-26"}]},"a1cf068b-4":{"id":"/src/scope.ts","moduleParts":{"index.js":"a1cf068b-5"},"imported":[],"importedBy":[{"uid":"a1cf068b-26"},{"uid":"a1cf068b-10"},{"uid":"a1cf068b-8"}]},"a1cf068b-6":{"id":"/src/tracking.ts","moduleParts":{"index.js":"a1cf068b-7"},"imported":[{"uid":"a1cf068b-0"}],"importedBy":[{"uid":"a1cf068b-26"},{"uid":"a1cf068b-10"},{"uid":"a1cf068b-12"},{"uid":"a1cf068b-8"},{"uid":"a1cf068b-22"},{"uid":"a1cf068b-16"}]},"a1cf068b-8":{"id":"/src/effect.ts","moduleParts":{"index.js":"a1cf068b-9"},"imported":[{"uid":"a1cf068b-4"},{"uid":"a1cf068b-6"}],"importedBy":[{"uid":"a1cf068b-26"},{"uid":"a1cf068b-10"},{"uid":"a1cf068b-12"},{"uid":"a1cf068b-22"},{"uid":"a1cf068b-24"}]},"a1cf068b-10":{"id":"/src/computed.ts","moduleParts":{"index.js":"a1cf068b-11"},"imported":[{"uid":"a1cf068b-0"},{"uid":"a1cf068b-8"},{"uid":"a1cf068b-4"},{"uid":"a1cf068b-6"}],"importedBy":[{"uid":"a1cf068b-26"}]},"a1cf068b-12":{"id":"/src/createSelector.ts","moduleParts":{"index.js":"a1cf068b-13"},"imported":[{"uid":"a1cf068b-8"},{"uid":"a1cf068b-6"}],"importedBy":[{"uid":"a1cf068b-26"}]},"a1cf068b-14":{"id":"/src/debug.ts","moduleParts":{"index.js":"a1cf068b-15"},"imported":[],"importedBy":[{"uid":"a1cf068b-26"},{"uid":"a1cf068b-16"}]},"a1cf068b-16":{"id":"/src/signal.ts","moduleParts":{"index.js":"a1cf068b-17"},"imported":[{"uid":"a1cf068b-0"},{"uid":"a1cf068b-14"},{"uid":"a1cf068b-6"}],"importedBy":[{"uid":"a1cf068b-26"},{"uid":"a1cf068b-22"},{"uid":"a1cf068b-18"}]},"a1cf068b-18":{"id":"/src/store.ts","moduleParts":{"index.js":"a1cf068b-19"},"imported":[{"uid":"a1cf068b-16"}],"importedBy":[{"uid":"a1cf068b-26"},{"uid":"a1cf068b-20"}]},"a1cf068b-20":{"id":"/src/reconcile.ts","moduleParts":{"index.js":"a1cf068b-21"},"imported":[{"uid":"a1cf068b-18"}],"importedBy":[{"uid":"a1cf068b-26"}]},"a1cf068b-22":{"id":"/src/resource.ts","moduleParts":{"index.js":"a1cf068b-23"},"imported":[{"uid":"a1cf068b-8"},{"uid":"a1cf068b-16"},{"uid":"a1cf068b-6"}],"importedBy":[{"uid":"a1cf068b-26"}]},"a1cf068b-24":{"id":"/src/watch.ts","moduleParts":{"index.js":"a1cf068b-25"},"imported":[{"uid":"a1cf068b-8"}],"importedBy":[{"uid":"a1cf068b-26"}]},"a1cf068b-26":{"id":"/src/index.ts","moduleParts":{"index.js":"a1cf068b-27"},"imported":[{"uid":"a1cf068b-0"},{"uid":"a1cf068b-2"},{"uid":"a1cf068b-10"},{"uid":"a1cf068b-12"},{"uid":"a1cf068b-14"},{"uid":"a1cf068b-8"},{"uid":"a1cf068b-20"},{"uid":"a1cf068b-22"},{"uid":"a1cf068b-4"},{"uid":"a1cf068b-16"},{"uid":"a1cf068b-18"},{"uid":"a1cf068b-6"},{"uid":"a1cf068b-24"}],"importedBy":[],"isEntry":true}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
+    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"src","children":[{"uid":"c60e3531-1","name":"batch.ts"},{"uid":"c60e3531-3","name":"cell.ts"},{"uid":"c60e3531-5","name":"reactive-devtools.ts"},{"uid":"c60e3531-7","name":"scope.ts"},{"uid":"c60e3531-9","name":"tracking.ts"},{"uid":"c60e3531-11","name":"effect.ts"},{"uid":"c60e3531-13","name":"computed.ts"},{"uid":"c60e3531-15","name":"createSelector.ts"},{"uid":"c60e3531-17","name":"debug.ts"},{"uid":"c60e3531-19","name":"reactive-trace.ts"},{"uid":"c60e3531-21","name":"signal.ts"},{"uid":"c60e3531-23","name":"store.ts"},{"uid":"c60e3531-25","name":"reconcile.ts"},{"uid":"c60e3531-27","name":"resource.ts"},{"uid":"c60e3531-29","name":"watch.ts"},{"uid":"c60e3531-31","name":"index.ts"}]}]}],"isRoot":true},"nodeParts":{"c60e3531-1":{"renderedLength":3016,"gzipLength":1167,"brotliLength":0,"metaUid":"c60e3531-0"},"c60e3531-3":{"renderedLength":1636,"gzipLength":786,"brotliLength":0,"metaUid":"c60e3531-2"},"c60e3531-5":{"renderedLength":4438,"gzipLength":1940,"brotliLength":0,"metaUid":"c60e3531-4"},"c60e3531-7":{"renderedLength":3026,"gzipLength":1226,"brotliLength":0,"metaUid":"c60e3531-6"},"c60e3531-9":{"renderedLength":2227,"gzipLength":858,"brotliLength":0,"metaUid":"c60e3531-8"},"c60e3531-11":{"renderedLength":7605,"gzipLength":2433,"brotliLength":0,"metaUid":"c60e3531-10"},"c60e3531-13":{"renderedLength":4983,"gzipLength":1524,"brotliLength":0,"metaUid":"c60e3531-12"},"c60e3531-15":{"renderedLength":2244,"gzipLength":981,"brotliLength":0,"metaUid":"c60e3531-14"},"c60e3531-17":{"renderedLength":2469,"gzipLength":1092,"brotliLength":0,"metaUid":"c60e3531-16"},"c60e3531-19":{"renderedLength":2721,"gzipLength":1363,"brotliLength":0,"metaUid":"c60e3531-18"},"c60e3531-21":{"renderedLength":3535,"gzipLength":1513,"brotliLength":0,"metaUid":"c60e3531-20"},"c60e3531-23":{"renderedLength":5232,"gzipLength":1867,"brotliLength":0,"metaUid":"c60e3531-22"},"c60e3531-25":{"renderedLength":2278,"gzipLength":940,"brotliLength":0,"metaUid":"c60e3531-24"},"c60e3531-27":{"renderedLength":1205,"gzipLength":524,"brotliLength":0,"metaUid":"c60e3531-26"},"c60e3531-29":{"renderedLength":1249,"gzipLength":582,"brotliLength":0,"metaUid":"c60e3531-28"},"c60e3531-31":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"c60e3531-30"}},"nodeMetas":{"c60e3531-0":{"id":"/src/batch.ts","moduleParts":{"index.js":"c60e3531-1"},"imported":[],"importedBy":[{"uid":"c60e3531-30"},{"uid":"c60e3531-12"},{"uid":"c60e3531-20"},{"uid":"c60e3531-8"}]},"c60e3531-2":{"id":"/src/cell.ts","moduleParts":{"index.js":"c60e3531-3"},"imported":[],"importedBy":[{"uid":"c60e3531-30"}]},"c60e3531-4":{"id":"/src/reactive-devtools.ts","moduleParts":{"index.js":"c60e3531-5"},"imported":[],"importedBy":[{"uid":"c60e3531-30"},{"uid":"c60e3531-12"},{"uid":"c60e3531-10"},{"uid":"c60e3531-20"}]},"c60e3531-6":{"id":"/src/scope.ts","moduleParts":{"index.js":"c60e3531-7"},"imported":[],"importedBy":[{"uid":"c60e3531-30"},{"uid":"c60e3531-12"},{"uid":"c60e3531-10"}]},"c60e3531-8":{"id":"/src/tracking.ts","moduleParts":{"index.js":"c60e3531-9"},"imported":[{"uid":"c60e3531-0"}],"importedBy":[{"uid":"c60e3531-30"},{"uid":"c60e3531-12"},{"uid":"c60e3531-14"},{"uid":"c60e3531-10"},{"uid":"c60e3531-26"},{"uid":"c60e3531-20"}]},"c60e3531-10":{"id":"/src/effect.ts","moduleParts":{"index.js":"c60e3531-11"},"imported":[{"uid":"c60e3531-4"},{"uid":"c60e3531-6"},{"uid":"c60e3531-8"}],"importedBy":[{"uid":"c60e3531-30"},{"uid":"c60e3531-12"},{"uid":"c60e3531-14"},{"uid":"c60e3531-26"},{"uid":"c60e3531-28"}]},"c60e3531-12":{"id":"/src/computed.ts","moduleParts":{"index.js":"c60e3531-13"},"imported":[{"uid":"c60e3531-0"},{"uid":"c60e3531-10"},{"uid":"c60e3531-4"},{"uid":"c60e3531-6"},{"uid":"c60e3531-8"}],"importedBy":[{"uid":"c60e3531-30"}]},"c60e3531-14":{"id":"/src/createSelector.ts","moduleParts":{"index.js":"c60e3531-15"},"imported":[{"uid":"c60e3531-10"},{"uid":"c60e3531-8"}],"importedBy":[{"uid":"c60e3531-30"}]},"c60e3531-16":{"id":"/src/debug.ts","moduleParts":{"index.js":"c60e3531-17"},"imported":[],"importedBy":[{"uid":"c60e3531-30"},{"uid":"c60e3531-20"}]},"c60e3531-18":{"id":"/src/reactive-trace.ts","moduleParts":{"index.js":"c60e3531-19"},"imported":[],"importedBy":[{"uid":"c60e3531-30"},{"uid":"c60e3531-20"}]},"c60e3531-20":{"id":"/src/signal.ts","moduleParts":{"index.js":"c60e3531-21"},"imported":[{"uid":"c60e3531-0"},{"uid":"c60e3531-16"},{"uid":"c60e3531-4"},{"uid":"c60e3531-18"},{"uid":"c60e3531-8"}],"importedBy":[{"uid":"c60e3531-30"},{"uid":"c60e3531-26"},{"uid":"c60e3531-22"}]},"c60e3531-22":{"id":"/src/store.ts","moduleParts":{"index.js":"c60e3531-23"},"imported":[{"uid":"c60e3531-20"}],"importedBy":[{"uid":"c60e3531-30"},{"uid":"c60e3531-24"}]},"c60e3531-24":{"id":"/src/reconcile.ts","moduleParts":{"index.js":"c60e3531-25"},"imported":[{"uid":"c60e3531-22"}],"importedBy":[{"uid":"c60e3531-30"}]},"c60e3531-26":{"id":"/src/resource.ts","moduleParts":{"index.js":"c60e3531-27"},"imported":[{"uid":"c60e3531-10"},{"uid":"c60e3531-20"},{"uid":"c60e3531-8"}],"importedBy":[{"uid":"c60e3531-30"}]},"c60e3531-28":{"id":"/src/watch.ts","moduleParts":{"index.js":"c60e3531-29"},"imported":[{"uid":"c60e3531-10"}],"importedBy":[{"uid":"c60e3531-30"}]},"c60e3531-30":{"id":"/src/index.ts","moduleParts":{"index.js":"c60e3531-31"},"imported":[{"uid":"c60e3531-0"},{"uid":"c60e3531-2"},{"uid":"c60e3531-12"},{"uid":"c60e3531-14"},{"uid":"c60e3531-16"},{"uid":"c60e3531-4"},{"uid":"c60e3531-18"},{"uid":"c60e3531-10"},{"uid":"c60e3531-24"},{"uid":"c60e3531-26"},{"uid":"c60e3531-6"},{"uid":"c60e3531-20"},{"uid":"c60e3531-22"},{"uid":"c60e3531-8"},{"uid":"c60e3531-28"}],"importedBy":[],"isEntry":true}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
 
     const run = () => {
       const width = window.innerWidth;

package/lib/index.js

@@ -149,6 +149,169 @@ function cell(value) {
 	return new Cell(value);
 }
 
+//#endregion
+//#region src/reactive-devtools.ts
+let _active = false;
+let _nextId = 1;
+const _byId = /* @__PURE__ */ new Map();
+const _subId = /* @__PURE__ */ new WeakMap();
+/** @internal — finalizer callback; prunes the record when a node is GC'd. */
+function _rdPrune(id) {
+	_byId.delete(id);
+}
+const _finalizer = new FinalizationRegistry(_rdPrune);
+const FIRE_CAP = 512;
+let _fireBuf = null;
+let _fireCount = 0;
+const PREVIEW_MAX$1 = 60;
+function preview$1(v) {
+	let s;
+	try {
+		if (v === null) return "null";
+		if (v === void 0) return "undefined";
+		const t = typeof v;
+		if (t === "string") s = JSON.stringify(v);
+		else if (t === "number" || t === "boolean" || t === "bigint") s = String(v);
+		else if (t === "function") s = `[Function ${v.name || "anonymous"}]`;
+		else if (t === "symbol") s = v.toString();
+		else if (Array.isArray(v)) s = `Array(${v.length})`;
+		else {
+			const ctor = v.constructor?.name;
+			let keys = [];
+			try {
+				keys = Object.keys(v).slice(0, 3);
+			} catch {
+				keys = [];
+			}
+			s = `${ctor && ctor !== "Object" ? `${ctor} ` : ""}{${keys.join(", ")}${keys.length === 3 ? ", …" : ""}}`;
+		}
+	} catch {
+		s = "[unstringifiable]";
+	}
+	return s.length > PREVIEW_MAX$1 ? `${s.slice(0, PREVIEW_MAX$1)}…` : s;
+}
+/** Activate the bridge. Idempotent. Called when a devtools client attaches. */
+function activateReactiveDevtools() {
+	_active = true;
+}
+/**
+* Deactivate + drop all retained state. Called when the devtools client
+* disconnects so a closed panel leaves zero residue.
+*/
+function deactivateReactiveDevtools() {
+	_active = false;
+	_byId.clear();
+	_fireBuf = null;
+	_fireCount = 0;
+}
+function isReactiveDevtoolsActive() {
+	return _active;
+}
+/**
+* Register a signal/computed/effect node. `host` is the object carrying
+* the `_s` subscriber Set (the signal read fn itself, or a computed's
+* internal host). `sub` is the notify closure (`recompute`/`run`) whose
+* identity appears in upstream `_s` Sets — used to resolve edges.
+*
+* @internal
+*/
+function _rdRegister(node, kind, host, sub, label) {
+	if (!_active) return void 0;
+	const id = _nextId++;
+	_byId.set(id, {
+		id,
+		kind,
+		name: label ?? `${kind === "signal" ? "signal" : kind}#${id}`,
+		ref: new WeakRef(node),
+		hostRef: host ? new WeakRef(host) : null,
+		fires: 0,
+		lastFire: null
+	});
+	if (sub) _subId.set(sub, id);
+	_finalizer.register(node, id);
+	Object.defineProperty(node, "__pxRdId", {
+		value: id,
+		enumerable: false,
+		configurable: true
+	});
+	return id;
+}
+/**
+* Record that a node fired (signal write / computed recompute / effect
+* run). Bumps counters + appends to the bounded fire buffer.
+*
+* @internal
+*/
+function _rdRecordFire(node) {
+	if (!_active) return;
+	const id = node.__pxRdId;
+	if (id === void 0) return;
+	const rec = _byId.get(id);
+	const ts = typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+	if (rec) {
+		rec.fires++;
+		rec.lastFire = ts;
+	}
+	if (_fireBuf === null) _fireBuf = new Array(FIRE_CAP);
+	_fireBuf[_fireCount % FIRE_CAP] = {
+		id,
+		ts
+	};
+	_fireCount++;
+}
+function resolveSubId(sub) {
+	const direct = sub.__pxRdId;
+	if (direct !== void 0) return direct;
+	return _subId.get(sub);
+}
+/**
+* Fresh snapshot of the live reactive graph. Edges are recomputed from
+* each live node's current subscriber Set — always consistent with the
+* framework's real subscription state, no incremental drift.
+*/
+function getReactiveGraph() {
+	const nodes = [];
+	const edges = [];
+	for (const rec of _byId.values()) {
+		const node = rec.ref.deref();
+		if (!node) continue;
+		const subs = (rec.hostRef?.deref() ?? null)?._s ?? null;
+		const valueStr = rec.kind === "effect" ? "" : preview$1(node._v);
+		nodes.push({
+			id: rec.id,
+			kind: rec.kind,
+			name: rec.name,
+			value: valueStr,
+			subscribers: subs?.size ?? 0,
+			fires: rec.fires,
+			lastFire: rec.lastFire
+		});
+		if (subs) for (const cb of subs) {
+			const to = resolveSubId(cb);
+			if (to !== void 0) edges.push({
+				from: rec.id,
+				to
+			});
+		}
+	}
+	return {
+		nodes,
+		edges
+	};
+}
+/** Bounded recent-fire timeline (oldest → newest). Fresh copy. */
+function getReactiveFires() {
+	if (_fireBuf === null || _fireCount === 0) return [];
+	if (_fireCount <= FIRE_CAP) return _fireBuf.slice(0, _fireCount);
+	const start = _fireCount % FIRE_CAP;
+	const out = [];
+	for (let i = 0; i < FIRE_CAP; i++) {
+		const e = _fireBuf[(start + i) % FIRE_CAP];
+		if (e) out.push(e);
+	}
+	return out;
+}
+
 //#endregion
 //#region src/scope.ts
 var EffectScope = class {
@@ -437,7 +600,10 @@ function effect(fn) {
 	};
 	const run = () => {
 		if (disposed) return;
-		if (process.env.NODE_ENV !== "production") _countSink$2.__pyreon_count__?.("reactivity.effectRun");
+		if (process.env.NODE_ENV !== "production") {
+			_countSink$2.__pyreon_count__?.("reactivity.effectRun");
+			_rdRecordFire(run);
+		}
 		runCleanup();
 		const outerCollector = _innerEffectCollector;
 		const myInners = [];
@@ -462,6 +628,7 @@ function effect(fn) {
 		if (!isFirstRun) scope?.notifyEffectRan();
 		isFirstRun = false;
 	};
+	if (process.env.NODE_ENV !== "production") _rdRegister(run, "effect", null, run, void 0);
 	run();
 	const e = { dispose() {
 		runCleanup();
@@ -560,6 +727,7 @@ function renderEffect(fn) {
 			}
 		} else renderEffectFullTrack(deps, run, trackedFn);
 	};
+	if (process.env.NODE_ENV !== "production") _rdRegister(run, "effect", null, run, void 0);
 	run();
 	const dispose = () => {
 		if (disposed) return;
@@ -615,13 +783,16 @@ function computedLazy(fn) {
 		if (disposed || dirty) return;
 		dirty = true;
 		if (host._s) notifySubscribers(host._s);
-		if (directFns) for (const f of directFns) f?.();
+		if (directFns) for (const f of directFns) f();
 	};
 	_markRecompute(recompute);
 	const read = () => {
 		trackSubscriber(host);
 		if (dirty) {
-			if (process.env.NODE_ENV !== "production") _countSink$1.__pyreon_count__?.("reactivity.computedRecompute");
+			if (process.env.NODE_ENV !== "production") {
+				_countSink$1.__pyreon_count__?.("reactivity.computedRecompute");
+				_rdRecordFire(read);
+			}
 			try {
 				if (tracked) {
 					setSkipDepsCollection(true);
@@ -649,15 +820,19 @@ function computedLazy(fn) {
 		},
 		enumerable: false
 	});
+	Object.defineProperty(read, "_d", {
+		get: () => directFns,
+		enumerable: false
+	});
 	read.direct = (updater) => {
-		if (!directFns) directFns = [];
-		const arr = directFns;
-		const idx = arr.length;
-		arr.push(updater);
+		if (!directFns) directFns = /* @__PURE__ */ new Set();
+		const set = directFns;
+		set.add(updater);
 		return () => {
-			arr[idx] = null;
+			set.delete(updater);
 		};
 	};
+	if (process.env.NODE_ENV !== "production") _rdRegister(read, "derived", host, recompute, void 0);
 	getCurrentScope()?.add({ dispose: read.dispose });
 	return read;
 }
@@ -677,7 +852,10 @@ function computedWithEquals(fn, equals) {
 	let directFns = null;
 	const recompute = () => {
 		if (disposed) return;
-		if (process.env.NODE_ENV !== "production") _countSink$1.__pyreon_count__?.("reactivity.computedRecompute");
+		if (process.env.NODE_ENV !== "production") {
+			_countSink$1.__pyreon_count__?.("reactivity.computedRecompute");
+			_rdRecordFire(read);
+		}
 		cleanupLocalDeps(deps, recompute);
 		try {
 			const next = trackWithLocalDeps(deps, recompute, fn);
@@ -690,7 +868,7 @@ function computedWithEquals(fn, equals) {
 			return;
 		}
 		if (host._s) notifySubscribers(host._s);
-		if (directFns) for (const f of directFns) f?.();
+		if (directFns) for (const f of directFns) f();
 	};
 	_markRecompute(recompute);
 	const read = () => {
@@ -720,15 +898,19 @@ function computedWithEquals(fn, equals) {
 		},
 		enumerable: false
 	});
+	Object.defineProperty(read, "_d", {
+		get: () => directFns,
+		enumerable: false
+	});
 	read.direct = (updater) => {
-		if (!directFns) directFns = [];
-		const arr = directFns;
-		const idx = arr.length;
-		arr.push(updater);
+		if (!directFns) directFns = /* @__PURE__ */ new Set();
+		const set = directFns;
+		set.add(updater);
 		return () => {
-			arr[idx] = null;
+			set.delete(updater);
 		};
 	};
+	if (process.env.NODE_ENV !== "production") _rdRegister(read, "derived", host, recompute, void 0);
 	getCurrentScope()?.add({ dispose: read.dispose });
 	return read;
 }
@@ -909,6 +1091,93 @@ function inspectSignal(sig) {
 	return info;
 }
 
+//#endregion
+//#region src/reactive-trace.ts
+/**
+* Ring-buffer capacity. 50 entries is enough to see the causal chain
+* for a crash (the writes in the few ticks before the throw) without
+* the buffer itself becoming a memory concern — each entry is a small
+* object with two short strings.
+*/
+const CAP = 50;
+let _buf = null;
+let _count = 0;
+/** Max characters of a value preview before truncation. Keeps the buffer + serialized report small. */
+const PREVIEW_MAX = 80;
+/**
+* Safe, bounded stringification. Never throws (a getter or `toJSON`
+* that throws must not break the trace recorder), never returns more
+* than `PREVIEW_MAX` chars + an ellipsis marker.
+*/
+function preview(v) {
+	let s;
+	try {
+		if (v === null) return "null";
+		if (v === void 0) return "undefined";
+		const t = typeof v;
+		if (t === "string") s = JSON.stringify(v);
+		else if (t === "number" || t === "boolean" || t === "bigint") s = String(v);
+		else if (t === "function") s = `[Function ${v.name || "anonymous"}]`;
+		else if (t === "symbol") s = v.toString();
+		else if (Array.isArray(v)) s = `Array(${v.length})`;
+		else {
+			const ctor = v.constructor?.name;
+			const keys = (() => {
+				try {
+					return Object.keys(v).slice(0, 4);
+				} catch {
+					return [];
+				}
+			})();
+			s = `${ctor && ctor !== "Object" ? ctor + " " : ""}{${keys.join(", ")}${keys.length === 4 ? ", …" : ""}}`;
+		}
+	} catch {
+		s = "[unstringifiable]";
+	}
+	return s.length > PREVIEW_MAX ? s.slice(0, PREVIEW_MAX) + "…" : s;
+}
+/**
+* Record one signal write. Called from `signal.ts` `_set`, already
+* inside the prod-gate, so this never runs in production builds.
+*
+* @internal
+*/
+function _recordSignalWrite(name, prev, next) {
+	if (_buf === null) _buf = new Array(CAP);
+	_buf[_count % CAP] = {
+		name,
+		prev: preview(prev),
+		next: preview(next),
+		timestamp: typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now()
+	};
+	_count++;
+}
+/**
+* Returns the recorded writes in chronological order (oldest → newest),
+* at most `CAP` entries. Empty array when nothing has been recorded.
+* The returned array is a fresh copy — safe to retain / serialize
+* without pinning the ring buffer.
+*
+* Consumed by `@pyreon/core`'s `reportError` to attach `reactiveTrace`
+* to the error context.
+*/
+function getReactiveTrace() {
+	if (_buf === null || _count === 0) return [];
+	if (_count <= CAP) return _buf.slice(0, _count);
+	const start = _count % CAP;
+	const out = [];
+	for (let i = 0; i < CAP; i++) {
+		const e = _buf[(start + i) % CAP];
+		if (e) out.push(e);
+	}
+	return out;
+}
+/** Clears the buffer. For test isolation; not part of the app-facing API. */
+function clearReactiveTrace() {
+	_buf = null;
+	_count = 0;
+}
+
 //#endregion
 //#region src/signal.ts
 const _countSink = globalThis;
@@ -920,6 +1189,10 @@ function _set(newValue) {
 	if (process.env.NODE_ENV !== "production") _countSink.__pyreon_count__?.("reactivity.signalWrite");
 	const prev = this._v;
 	this._v = newValue;
+	if (process.env.NODE_ENV !== "production") {
+		_recordSignalWrite(this.label, prev, newValue);
+		_rdRecordFire(this);
+	}
 	if (isTracing()) try {
 		_notifyTraceListeners(this, prev, newValue);
 	} catch (err) {
@@ -943,28 +1216,33 @@ function _subscribe(listener) {
 }
 /**
 * Register a direct updater — lighter than subscribe().
-* Uses a flat array instead of Set. Disposal nulls the slot (no Set.delete overhead).
 * Used by compiler-emitted _bindText/_bindDirect for zero-overhead DOM bindings.
+*
+* Backed by a `Set` (same as `_s`), NOT a flat array. The array form
+* disposed by nulling the slot (`arr[idx] = null`) but never compacted —
+* so a long-lived signal (theme/locale/auth, or a signal read inside
+* `<For>` rows) bound by churning components accumulated one permanent
+* dead slot per ever-mounted binding. That is an app-lifetime memory
+* leak AND degrades the signal-write hot path: `notifyDirect` iterated
+* O(total-ever-registered), not O(live). A Set bounds growth to the live
+* set and keeps disposal + iteration O(live); the "Set.delete overhead"
+* the array form optimised for is negligible against an unbounded array.
 */
 function _directFn(updater) {
-	if (!this._d) this._d = [];
-	const arr = this._d;
-	const idx = arr.length;
-	arr.push(updater);
+	if (!this._d) this._d = /* @__PURE__ */ new Set();
+	const set = this._d;
+	set.add(updater);
 	return () => {
-		arr[idx] = null;
+		set.delete(updater);
 	};
 }
 /**
-* Notify direct updaters — flat array iteration, batch-aware.
-* Null slots (from disposed updaters) are skipped.
+* Notify direct updaters — set iteration, batch-aware. Disposed updaters
+* are already absent from the set (O(1) delete on disposal).
 */
 function notifyDirect(updaters) {
-	if (isBatching()) for (let i = 0; i < updaters.length; i++) {
-		const fn = updaters[i];
-		if (fn) enqueuePendingNotification(fn);
-	}
-	else for (let i = 0; i < updaters.length; i++) updaters[i]?.();
+	if (isBatching()) for (const fn of updaters) enqueuePendingNotification(fn);
+	else for (const fn of updaters) fn();
 }
 function _debug() {
 	return {
@@ -997,6 +1275,7 @@ function signal(initialValue, options) {
 	read.direct = _directFn;
 	read.debug = _debug;
 	read.label = options?.name;
+	if (process.env.NODE_ENV !== "production") _rdRegister(read, "signal", read, null, read.label);
 	return read;
 }
 
@@ -1111,6 +1390,7 @@ function wrap(raw, shallow) {
 				target[key] = value;
 				return true;
 			}
+			if (key === "__proto__" || key === "constructor" || key === "prototype") return true;
 			const prevLength = isArray ? target.length : 0;
 			target[key] = value;
 			if (isArray && key === "length") {
@@ -1164,6 +1444,11 @@ function wrap(raw, shallow) {
 * Arrays are reconciled by index — elements at the same index are recursively
 * diffed rather than replaced wholesale. Excess old elements are removed.
 */
+const DANGEROUS_KEYS = new Set([
+	"__proto__",
+	"constructor",
+	"prototype"
+]);
 function reconcile(source, target) {
 	_reconcileInner(source, target, /* @__PURE__ */ new WeakSet());
 }
@@ -1188,6 +1473,7 @@ function _reconcileObject(source, target, seen) {
 	const sourceKeys = Object.keys(source);
 	const targetKeys = new Set(Object.keys(target));
 	for (const key of sourceKeys) {
+		if (DANGEROUS_KEYS.has(key)) continue;
 		const sv = source[key];
 		const tv = target[key];
 		if (sv !== null && typeof sv === "object" && tv !== null && typeof tv === "object") if (isStore(tv)) _reconcileInner(sv, tv, seen);
@@ -1195,7 +1481,10 @@ function _reconcileObject(source, target, seen) {
 		else target[key] = sv;
 		targetKeys.delete(key);
 	}
-	for (const key of targetKeys) delete target[key];
+	for (const key of targetKeys) {
+		if (DANGEROUS_KEYS.has(key)) continue;
+		delete target[key];
+	}
 }
 
 //#endregion
@@ -1307,5 +1596,5 @@ function watch(source, callback, opts = {}) {
 }
 
 //#endregion
-export { Cell, EffectScope, _bind, batch, cell, computed, createResource, createSelector, createStore, effect, effectScope, getCurrentScope, inspectSignal, isStore, markRaw, nextTick, onCleanup, onScopeDispose, onSignalUpdate, reconcile, renderEffect, runUntracked, runUntracked as untrack, setCurrentScope, setErrorHandler, setSnapshotCapture, shallowReactive, signal, watch, why };
+export { Cell, EffectScope, _bind, activateReactiveDevtools, batch, cell, clearReactiveTrace, computed, createResource, createSelector, createStore, deactivateReactiveDevtools, effect, effectScope, getCurrentScope, getReactiveFires, getReactiveGraph, getReactiveTrace, inspectSignal, isReactiveDevtoolsActive, isStore, markRaw, nextTick, onCleanup, onScopeDispose, onSignalUpdate, reconcile, renderEffect, runUntracked, runUntracked as untrack, setCurrentScope, setErrorHandler, setSnapshotCapture, shallowReactive, signal, watch, why };
 //# sourceMappingURL=index.js.map