@pyreon/reactivity 0.23.0 → 0.24.0

package/lib/_chunks/reactive-devtools-BCpGoGZ5.js

@@ -0,0 +1,280 @@
+//#region src/reactive-devtools.ts
+/**
+* Time constant for the rate1s EWMA (milliseconds). Tuned for the "hot
+* path debugging" use case: a 1-second time constant means a burst of
+* fires shows up immediately, then decays to 1/e (~0.37×) after one
+* second of silence, ~5% after 3 seconds, ~0.7% after 5 seconds.
+*
+* @internal — exported for tests + tunability.
+*/
+const LPIH_RATE_TAU_MS = 1e3;
+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 = 60;
+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;
+			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 ? `${s.slice(0, PREVIEW_MAX)}…` : 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;
+}
+/**
+* Parse the user's call site from `new Error().stack`. Returns undefined
+* when devtools isn't active (zero-cost early-return — no Error allocated)
+* OR when the stack format isn't recognized.
+*
+* `skipFrames` is the number of caller-frames to skip past _captureCallerLocation
+* itself. The framework's hot-path callers (signal / computedLazy / effect)
+* pass their own depth so the captured frame is the USER's call to
+* `signal()` / `computed()` / `effect()`, not the framework's internals.
+*
+* Recognized stack formats:
+*   - V8 (Chrome / Node / Bun):     `    at fn (file:line:col)`
+*   - V8 (anonymous):               `    at file:line:col`
+*   - JSC (Safari) + SpiderMonkey:  `fn@file:line:col`
+*
+* @internal
+*/
+function _captureCallerLocation(skipFrames) {
+	if (!_active) return void 0;
+	const raw = (/* @__PURE__ */ new Error()).stack;
+	if (!raw) return void 0;
+	const lines = raw.split("\n");
+	const target = lines[(lines[0] && lines[0].trim().startsWith("Error") ? 1 : 0) + 1 + skipFrames];
+	if (!target) return void 0;
+	return parseStackLine(target);
+}
+function parseStackLine(line) {
+	const v8Paren = line.match(/\(([^()]+):(\d+):(\d+)\)\s*$/);
+	if (v8Paren && v8Paren[1] && v8Paren[2] && v8Paren[3]) {
+		const file = v8Paren[1];
+		const lineN = Number.parseInt(v8Paren[2], 10);
+		const col = Number.parseInt(v8Paren[3], 10);
+		if (Number.isFinite(lineN) && Number.isFinite(col)) return {
+			file,
+			line: lineN,
+			col
+		};
+	}
+	const v8Bare = line.match(/at\s+([^\s()]+):(\d+):(\d+)\s*$/);
+	if (v8Bare && v8Bare[1] && v8Bare[2] && v8Bare[3]) {
+		const file = v8Bare[1];
+		const lineN = Number.parseInt(v8Bare[2], 10);
+		const col = Number.parseInt(v8Bare[3], 10);
+		if (Number.isFinite(lineN) && Number.isFinite(col)) return {
+			file,
+			line: lineN,
+			col
+		};
+	}
+	const jsc = line.match(/@([^@\s]+):(\d+):(\d+)\s*$/);
+	if (jsc && jsc[1] && jsc[2] && jsc[3]) {
+		const file = jsc[1];
+		const lineN = Number.parseInt(jsc[2], 10);
+		const col = Number.parseInt(jsc[3], 10);
+		if (Number.isFinite(lineN) && Number.isFinite(col)) return {
+			file,
+			line: lineN,
+			col
+		};
+	}
+}
+/**
+* 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, loc) {
+	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,
+		loc,
+		rate1s: 0
+	});
+	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++;
+		if (rec.lastFire !== null) {
+			const dt = ts - rec.lastFire;
+			const decay = Math.exp(-dt / LPIH_RATE_TAU_MS);
+			rec.rate1s = rec.rate1s * decay + 1;
+		} else rec.rate1s = 1;
+		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(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,
+			...rec.loc ? { loc: rec.loc } : {}
+		});
+		if (subs) for (const cb of subs) {
+			const to = resolveSubId(cb);
+			if (to !== void 0) edges.push({
+				from: rec.id,
+				to
+			});
+		}
+	}
+	return {
+		nodes,
+		edges
+	};
+}
+/**
+* Aggregate fire counts by source-location — powers Live Program Inlay
+* Hints. Walks the live node registry, keys each node by its captured
+* `loc`, and returns one summary per unique `file:line:col`. Nodes
+* without a captured location are skipped (their fires are still
+* visible via `getReactiveGraph()` and `getReactiveFires()` for the
+* existing graph / timeline surfaces).
+*
+* Returns a fresh array, JSON-serializable, safe to ship across the
+* devtools-host bridge or to write into an LSP cache file.
+*/
+function getFireSummaries() {
+	const byKey = /* @__PURE__ */ new Map();
+	const nowTs = typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+	for (const rec of _byId.values()) {
+		if (!rec.loc) continue;
+		if (!rec.ref.deref()) continue;
+		const k = `${rec.loc.file}:${rec.loc.line}:${rec.loc.col}`;
+		const decayedRate = rec.lastFire !== null ? rec.rate1s * Math.exp(-(nowTs - rec.lastFire) / LPIH_RATE_TAU_MS) : 0;
+		const existing = byKey.get(k);
+		if (existing) {
+			existing.count += rec.fires;
+			existing.rate1s += decayedRate;
+			if (rec.lastFire !== null && (existing.lastFire === null || rec.lastFire > existing.lastFire)) {
+				existing.lastFire = rec.lastFire;
+				existing.kind = rec.kind;
+			}
+		} else byKey.set(k, {
+			loc: rec.loc,
+			count: rec.fires,
+			lastFire: rec.lastFire,
+			kind: rec.kind,
+			rate1s: decayedRate
+		});
+	}
+	return [...byKey.values()];
+}
+/** 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
+export { deactivateReactiveDevtools as a, getReactiveGraph as c, activateReactiveDevtools as i, isReactiveDevtoolsActive as l, _rdRecordFire as n, getFireSummaries as o, _rdRegister as r, getReactiveFires as s, _captureCallerLocation as t };
+//# sourceMappingURL=reactive-devtools-BCpGoGZ5.js.map

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":"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 data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"src","children":[{"uid":"8f0a5281-1","name":"batch.ts"},{"uid":"8f0a5281-3","name":"cell.ts"},{"uid":"8f0a5281-5","name":"scope.ts"},{"uid":"8f0a5281-7","name":"tracking.ts"},{"uid":"8f0a5281-9","name":"effect.ts"},{"uid":"8f0a5281-11","name":"computed.ts"},{"uid":"8f0a5281-13","name":"createSelector.ts"},{"uid":"8f0a5281-15","name":"debug.ts"},{"uid":"8f0a5281-17","name":"reactive-trace.ts"},{"uid":"8f0a5281-19","name":"signal.ts"},{"uid":"8f0a5281-21","name":"store.ts"},{"uid":"8f0a5281-23","name":"reconcile.ts"},{"uid":"8f0a5281-25","name":"resource.ts"},{"uid":"8f0a5281-27","name":"watch.ts"},{"uid":"8f0a5281-29","name":"index.ts"}]}]},{"name":"lpih.js","children":[{"name":"src/lpih.ts","uid":"8f0a5281-31"}]},{"name":"_chunks/reactive-devtools-BCpGoGZ5.js","children":[{"name":"src/reactive-devtools.ts","uid":"8f0a5281-33"}]}],"isRoot":true},"nodeParts":{"8f0a5281-1":{"renderedLength":3016,"gzipLength":1167,"brotliLength":0,"metaUid":"8f0a5281-0"},"8f0a5281-3":{"renderedLength":1636,"gzipLength":786,"brotliLength":0,"metaUid":"8f0a5281-2"},"8f0a5281-5":{"renderedLength":3026,"gzipLength":1226,"brotliLength":0,"metaUid":"8f0a5281-4"},"8f0a5281-7":{"renderedLength":2227,"gzipLength":858,"brotliLength":0,"metaUid":"8f0a5281-6"},"8f0a5281-9":{"renderedLength":7697,"gzipLength":2469,"brotliLength":0,"metaUid":"8f0a5281-8"},"8f0a5281-11":{"renderedLength":5143,"gzipLength":1570,"brotliLength":0,"metaUid":"8f0a5281-10"},"8f0a5281-13":{"renderedLength":2244,"gzipLength":981,"brotliLength":0,"metaUid":"8f0a5281-12"},"8f0a5281-15":{"renderedLength":2469,"gzipLength":1092,"brotliLength":0,"metaUid":"8f0a5281-14"},"8f0a5281-17":{"renderedLength":2721,"gzipLength":1363,"brotliLength":0,"metaUid":"8f0a5281-16"},"8f0a5281-19":{"renderedLength":3643,"gzipLength":1554,"brotliLength":0,"metaUid":"8f0a5281-18"},"8f0a5281-21":{"renderedLength":5232,"gzipLength":1867,"brotliLength":0,"metaUid":"8f0a5281-20"},"8f0a5281-23":{"renderedLength":2278,"gzipLength":940,"brotliLength":0,"metaUid":"8f0a5281-22"},"8f0a5281-25":{"renderedLength":1205,"gzipLength":524,"brotliLength":0,"metaUid":"8f0a5281-24"},"8f0a5281-27":{"renderedLength":1249,"gzipLength":582,"brotliLength":0,"metaUid":"8f0a5281-26"},"8f0a5281-29":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"8f0a5281-28"},"8f0a5281-31":{"renderedLength":6380,"gzipLength":2579,"brotliLength":0,"metaUid":"8f0a5281-30"},"8f0a5281-33":{"renderedLength":8588,"gzipLength":3409,"brotliLength":0,"metaUid":"8f0a5281-32"}},"nodeMetas":{"8f0a5281-0":{"id":"/src/batch.ts","moduleParts":{"index.js":"8f0a5281-1"},"imported":[],"importedBy":[{"uid":"8f0a5281-28"},{"uid":"8f0a5281-10"},{"uid":"8f0a5281-18"},{"uid":"8f0a5281-6"}]},"8f0a5281-2":{"id":"/src/cell.ts","moduleParts":{"index.js":"8f0a5281-3"},"imported":[],"importedBy":[{"uid":"8f0a5281-28"}]},"8f0a5281-4":{"id":"/src/scope.ts","moduleParts":{"index.js":"8f0a5281-5"},"imported":[],"importedBy":[{"uid":"8f0a5281-28"},{"uid":"8f0a5281-10"},{"uid":"8f0a5281-8"}]},"8f0a5281-6":{"id":"/src/tracking.ts","moduleParts":{"index.js":"8f0a5281-7"},"imported":[{"uid":"8f0a5281-0"}],"importedBy":[{"uid":"8f0a5281-28"},{"uid":"8f0a5281-10"},{"uid":"8f0a5281-12"},{"uid":"8f0a5281-8"},{"uid":"8f0a5281-24"},{"uid":"8f0a5281-18"}]},"8f0a5281-8":{"id":"/src/effect.ts","moduleParts":{"index.js":"8f0a5281-9"},"imported":[{"uid":"8f0a5281-32"},{"uid":"8f0a5281-4"},{"uid":"8f0a5281-6"}],"importedBy":[{"uid":"8f0a5281-28"},{"uid":"8f0a5281-10"},{"uid":"8f0a5281-12"},{"uid":"8f0a5281-24"},{"uid":"8f0a5281-26"}]},"8f0a5281-10":{"id":"/src/computed.ts","moduleParts":{"index.js":"8f0a5281-11"},"imported":[{"uid":"8f0a5281-0"},{"uid":"8f0a5281-8"},{"uid":"8f0a5281-32"},{"uid":"8f0a5281-4"},{"uid":"8f0a5281-6"}],"importedBy":[{"uid":"8f0a5281-28"}]},"8f0a5281-12":{"id":"/src/createSelector.ts","moduleParts":{"index.js":"8f0a5281-13"},"imported":[{"uid":"8f0a5281-8"},{"uid":"8f0a5281-6"}],"importedBy":[{"uid":"8f0a5281-28"}]},"8f0a5281-14":{"id":"/src/debug.ts","moduleParts":{"index.js":"8f0a5281-15"},"imported":[],"importedBy":[{"uid":"8f0a5281-28"},{"uid":"8f0a5281-18"}]},"8f0a5281-16":{"id":"/src/reactive-trace.ts","moduleParts":{"index.js":"8f0a5281-17"},"imported":[],"importedBy":[{"uid":"8f0a5281-28"},{"uid":"8f0a5281-18"}]},"8f0a5281-18":{"id":"/src/signal.ts","moduleParts":{"index.js":"8f0a5281-19"},"imported":[{"uid":"8f0a5281-0"},{"uid":"8f0a5281-14"},{"uid":"8f0a5281-32"},{"uid":"8f0a5281-16"},{"uid":"8f0a5281-6"}],"importedBy":[{"uid":"8f0a5281-28"},{"uid":"8f0a5281-24"},{"uid":"8f0a5281-20"}]},"8f0a5281-20":{"id":"/src/store.ts","moduleParts":{"index.js":"8f0a5281-21"},"imported":[{"uid":"8f0a5281-18"}],"importedBy":[{"uid":"8f0a5281-28"},{"uid":"8f0a5281-22"}]},"8f0a5281-22":{"id":"/src/reconcile.ts","moduleParts":{"index.js":"8f0a5281-23"},"imported":[{"uid":"8f0a5281-20"}],"importedBy":[{"uid":"8f0a5281-28"}]},"8f0a5281-24":{"id":"/src/resource.ts","moduleParts":{"index.js":"8f0a5281-25"},"imported":[{"uid":"8f0a5281-8"},{"uid":"8f0a5281-18"},{"uid":"8f0a5281-6"}],"importedBy":[{"uid":"8f0a5281-28"}]},"8f0a5281-26":{"id":"/src/watch.ts","moduleParts":{"index.js":"8f0a5281-27"},"imported":[{"uid":"8f0a5281-8"}],"importedBy":[{"uid":"8f0a5281-28"}]},"8f0a5281-28":{"id":"/src/index.ts","moduleParts":{"index.js":"8f0a5281-29"},"imported":[{"uid":"8f0a5281-0"},{"uid":"8f0a5281-2"},{"uid":"8f0a5281-10"},{"uid":"8f0a5281-12"},{"uid":"8f0a5281-14"},{"uid":"8f0a5281-32"},{"uid":"8f0a5281-16"},{"uid":"8f0a5281-8"},{"uid":"8f0a5281-22"},{"uid":"8f0a5281-24"},{"uid":"8f0a5281-4"},{"uid":"8f0a5281-18"},{"uid":"8f0a5281-20"},{"uid":"8f0a5281-6"},{"uid":"8f0a5281-26"}],"importedBy":[],"isEntry":true},"8f0a5281-30":{"id":"/src/lpih.ts","moduleParts":{"lpih.js":"8f0a5281-31"},"imported":[{"uid":"8f0a5281-32"},{"uid":"8f0a5281-34","dynamic":true}],"importedBy":[],"isEntry":true},"8f0a5281-32":{"id":"/src/reactive-devtools.ts","moduleParts":{"_chunks/reactive-devtools-BCpGoGZ5.js":"8f0a5281-33"},"imported":[],"importedBy":[{"uid":"8f0a5281-28"},{"uid":"8f0a5281-10"},{"uid":"8f0a5281-8"},{"uid":"8f0a5281-18"},{"uid":"8f0a5281-30"}]},"8f0a5281-34":{"id":"node:fs/promises","moduleParts":{},"imported":[],"importedBy":[{"uid":"8f0a5281-30"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
 
     const run = () => {
       const width = window.innerWidth;

package/lib/index.js

@@ -1,3 +1,5 @@
+import { a as deactivateReactiveDevtools, c as getReactiveGraph, i as activateReactiveDevtools, l as isReactiveDevtoolsActive, n as _rdRecordFire, o as getFireSummaries, r as _rdRegister, s as getReactiveFires, t as _captureCallerLocation } from "./_chunks/reactive-devtools-BCpGoGZ5.js";
+
 //#region src/batch.ts
 const __DEV__ = process.env.NODE_ENV !== "production";
 let batchDepth = 0;
@@ -149,169 +151,6 @@ 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 {
@@ -560,7 +399,7 @@ function cleanupLocalDeps$1(deps, fn) {
 		deps.length = 0;
 	}
 }
-function effect(fn) {
+function effect(fn, options) {
 	if (process.env.NODE_ENV !== "production") {
 		if (fn.constructor && fn.constructor.name === "AsyncFunction") console.warn("[pyreon] effect() received an async function. Signal reads after the first `await` are NOT tracked — only the synchronous prefix is. Read every tracked signal BEFORE any await, or split into separate effects, or use `watch(source, asyncCb)` for async-in-callback patterns.");
 	}
@@ -628,7 +467,7 @@ function effect(fn) {
 		if (!isFirstRun) scope?.notifyEffectRan();
 		isFirstRun = false;
 	};
-	if (process.env.NODE_ENV !== "production") _rdRegister(run, "effect", null, run, void 0);
+	if (process.env.NODE_ENV !== "production") _rdRegister(run, "effect", null, run, void 0, options?.__sourceLocation ?? _captureCallerLocation(1));
 	run();
 	const e = { dispose() {
 		runCleanup();
@@ -727,7 +566,7 @@ function renderEffect(fn) {
 			}
 		} else renderEffectFullTrack(deps, run, trackedFn);
 	};
-	if (process.env.NODE_ENV !== "production") _rdRegister(run, "effect", null, run, void 0);
+	if (process.env.NODE_ENV !== "production") _rdRegister(run, "effect", null, run, void 0, _captureCallerLocation(1));
 	run();
 	const dispose = () => {
 		if (disposed) return;
@@ -759,7 +598,8 @@ function computed(fn, options) {
 	if (process.env.NODE_ENV !== "production") {
 		if (fn.constructor && fn.constructor.name === "AsyncFunction") console.warn("[pyreon] computed() received an async function. The result type becomes `Computed<Promise<T>>`, and signal reads after the first `await` are NOT tracked. Use `createResource` for async-derived state, or compute synchronously over a signal that holds the awaited value.");
 	}
-	return options?.equals ? computedWithEquals(fn, options.equals) : computedLazy(fn);
+	const loc = options?.__sourceLocation;
+	return options?.equals ? computedWithEquals(fn, options.equals, loc) : computedLazy(fn, loc);
 }
 /**
 * Default computed — lazy evaluation with deferred cleanup.
@@ -771,7 +611,7 @@ function computed(fn, options) {
 * in diamond patterns (a→b,c→d: b notifies d, c tries to notify d again —
 * skipped because d is already dirty).
 */
-function computedLazy(fn) {
+function computedLazy(fn, injectedLoc) {
 	let value;
 	let dirty = true;
 	let disposed = false;
@@ -832,7 +672,7 @@ function computedLazy(fn) {
 			set.delete(updater);
 		};
 	};
-	if (process.env.NODE_ENV !== "production") _rdRegister(read, "derived", host, recompute, void 0);
+	if (process.env.NODE_ENV !== "production") _rdRegister(read, "derived", host, recompute, void 0, injectedLoc ?? _captureCallerLocation(2));
 	getCurrentScope()?.add({ dispose: read.dispose });
 	return read;
 }
@@ -842,7 +682,7 @@ function computedLazy(fn) {
 * Re-evaluates immediately when deps change and only notifies downstream
 * if `equals(prev, next)` returns false.
 */
-function computedWithEquals(fn, equals) {
+function computedWithEquals(fn, equals, injectedLoc) {
 	let value;
 	let dirty = true;
 	let initialized = false;
@@ -910,7 +750,7 @@ function computedWithEquals(fn, equals) {
 			set.delete(updater);
 		};
 	};
-	if (process.env.NODE_ENV !== "production") _rdRegister(read, "derived", host, recompute, void 0);
+	if (process.env.NODE_ENV !== "production") _rdRegister(read, "derived", host, recompute, void 0, injectedLoc ?? _captureCallerLocation(2));
 	getCurrentScope()?.add({ dispose: read.dispose });
 	return read;
 }
@@ -1275,7 +1115,10 @@ 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);
+	if (process.env.NODE_ENV !== "production") {
+		const loc = options?.__sourceLocation ? options.__sourceLocation : _captureCallerLocation(1);
+		_rdRegister(read, "signal", read, null, read.label, loc);
+	}
 	return read;
 }
 
@@ -1596,5 +1439,5 @@ function watch(source, callback, opts = {}) {
 }
 
 //#endregion
-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 };
+export { Cell, EffectScope, _bind, activateReactiveDevtools, batch, cell, clearReactiveTrace, computed, createResource, createSelector, createStore, deactivateReactiveDevtools, effect, effectScope, getCurrentScope, getFireSummaries, 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