@pyreon/state-tree 0.0.1

package/lib/devtools.js

@@ -0,0 +1,111 @@
+//#region src/registry.ts
+/**
+* WeakMap from every model instance object → its internal metadata.
+* Shared across patch, middleware, and snapshot modules.
+*/
+const instanceMeta = /* @__PURE__ */ new WeakMap();
+/** Returns true when a value is a model instance (has metadata registered). */
+function isModelInstance(value) {
+	return value != null && typeof value === "object" && instanceMeta.has(value);
+}
+
+//#endregion
+//#region src/snapshot.ts
+/**
+* Serialize a model instance to a plain JS object (no signals, no functions).
+* Nested model instances are recursively serialized.
+*
+* @example
+* getSnapshot(counter)  // { count: 6 }
+* getSnapshot(app)      // { profile: { name: "Alice" }, title: "My App" }
+*/
+function getSnapshot(instance) {
+	const meta = instanceMeta.get(instance);
+	if (!meta) throw new Error("[@pyreon/state-tree] getSnapshot: not a model instance");
+	const out = {};
+	for (const key of meta.stateKeys) {
+		const sig = instance[key];
+		if (!sig) continue;
+		const val = sig.peek();
+		out[key] = isModelInstance(val) ? getSnapshot(val) : val;
+	}
+	return out;
+}
+
+//#endregion
+//#region src/devtools.ts
+/**
+* @pyreon/state-tree devtools introspection API.
+* Import: `import { ... } from "@pyreon/state-tree/devtools"`
+*/
+const _activeModels = /* @__PURE__ */ new Map();
+const _listeners = /* @__PURE__ */ new Set();
+function _notify() {
+	for (const listener of _listeners) listener();
+}
+/**
+* Register a model instance for devtools inspection.
+* Call this when creating instances you want visible in devtools.
+*
+* @example
+* const counter = Counter.create()
+* registerInstance("app-counter", counter)
+*/
+function registerInstance(name, instance) {
+	_activeModels.set(name, new WeakRef(instance));
+	_notify();
+}
+/**
+* Unregister a model instance.
+*/
+function unregisterInstance(name) {
+	_activeModels.delete(name);
+	_notify();
+}
+/**
+* Get all registered model instance names.
+* Automatically cleans up garbage-collected instances.
+*/
+function getActiveModels() {
+	for (const [name, ref] of _activeModels) if (ref.deref() === void 0) _activeModels.delete(name);
+	return [..._activeModels.keys()];
+}
+/**
+* Get a model instance by name (or undefined if GC'd or not registered).
+*/
+function getModelInstance(name) {
+	const ref = _activeModels.get(name);
+	if (!ref) return void 0;
+	const instance = ref.deref();
+	if (!instance) {
+		_activeModels.delete(name);
+		return;
+	}
+	return instance;
+}
+/**
+* Get a snapshot of a registered model instance.
+*/
+function getModelSnapshot(name) {
+	const instance = getModelInstance(name);
+	if (!instance) return void 0;
+	return getSnapshot(instance);
+}
+/**
+* Subscribe to model registry changes. Returns unsubscribe function.
+*/
+function onModelChange(listener) {
+	_listeners.add(listener);
+	return () => {
+		_listeners.delete(listener);
+	};
+}
+/** @internal — reset devtools registry (for tests). */
+function _resetDevtools() {
+	_activeModels.clear();
+	_listeners.clear();
+}
+
+//#endregion
+export { _resetDevtools, getActiveModels, getModelInstance, getModelSnapshot, onModelChange, registerInstance, unregisterInstance };
+//# sourceMappingURL=devtools.js.map

package/lib/devtools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools.js","names":[],"sources":["../src/registry.ts","../src/snapshot.ts","../src/devtools.ts"],"sourcesContent":["import type { InstanceMeta } from './types'\n\n/**\n * WeakMap from every model instance object → its internal metadata.\n * Shared across patch, middleware, and snapshot modules.\n */\nexport const instanceMeta = new WeakMap<object, InstanceMeta>()\n\n/** Returns true when a value is a model instance (has metadata registered). */\nexport function isModelInstance(value: unknown): boolean {\n  return (\n    value != null &&\n    typeof value === 'object' &&\n    instanceMeta.has(value as object)\n  )\n}\n","import type { Signal } from '@pyreon/reactivity'\nimport { batch } from '@pyreon/reactivity'\nimport { instanceMeta, isModelInstance } from './registry'\nimport type { Snapshot, StateShape } from './types'\n\n// ─── getSnapshot ──────────────────────────────────────────────────────────────\n\n/**\n * Serialize a model instance to a plain JS object (no signals, no functions).\n * Nested model instances are recursively serialized.\n *\n * @example\n * getSnapshot(counter)  // { count: 6 }\n * getSnapshot(app)      // { profile: { name: \"Alice\" }, title: \"My App\" }\n */\nexport function getSnapshot<TState extends StateShape>(\n  instance: object,\n): Snapshot<TState> {\n  const meta = instanceMeta.get(instance)\n  if (!meta)\n    throw new Error('[@pyreon/state-tree] getSnapshot: not a model instance')\n\n  const out: Record<string, unknown> = {}\n  for (const key of meta.stateKeys) {\n    const sig = (instance as Record<string, Signal<unknown>>)[key]\n    if (!sig) continue\n    const val = sig.peek()\n    out[key] = isModelInstance(val) ? getSnapshot(val as object) : val\n  }\n  return out as Snapshot<TState>\n}\n\n// ─── applySnapshot ────────────────────────────────────────────────────────────\n\n/**\n * Restore a model instance from a plain-object snapshot.\n * All signal writes are coalesced via `batch()` for a single reactive flush.\n * Keys absent from the snapshot are left unchanged.\n *\n * @example\n * applySnapshot(counter, { count: 0 })\n */\nexport function applySnapshot<TState extends StateShape>(\n  instance: object,\n  snapshot: Partial<Snapshot<TState>>,\n): void {\n  const meta = instanceMeta.get(instance)\n  if (!meta)\n    throw new Error('[@pyreon/state-tree] applySnapshot: not a model instance')\n\n  batch(() => {\n    for (const key of meta.stateKeys) {\n      if (!(key in snapshot)) continue\n      const sig = (instance as Record<string, Signal<unknown>>)[key]\n      if (!sig) continue\n      const val = (snapshot as Record<string, unknown>)[key]\n      const current = sig.peek()\n      if (isModelInstance(current)) {\n        // Recurse into nested model instance\n        applySnapshot(current as object, val as Record<string, unknown>)\n      } else {\n        sig.set(val)\n      }\n    }\n  })\n}\n","/**\n * @pyreon/state-tree devtools introspection API.\n * Import: `import { ... } from \"@pyreon/state-tree/devtools\"`\n */\n\nimport { getSnapshot } from './snapshot'\n\n// Track active model instances (devtools-only, opt-in)\nconst _activeModels = new Map<string, WeakRef<object>>()\nconst _listeners = new Set<() => void>()\n\nfunction _notify(): void {\n  for (const listener of _listeners) listener()\n}\n\n/**\n * Register a model instance for devtools inspection.\n * Call this when creating instances you want visible in devtools.\n *\n * @example\n * const counter = Counter.create()\n * registerInstance(\"app-counter\", counter)\n */\nexport function registerInstance(name: string, instance: object): void {\n  _activeModels.set(name, new WeakRef(instance))\n  _notify()\n}\n\n/**\n * Unregister a model instance.\n */\nexport function unregisterInstance(name: string): void {\n  _activeModels.delete(name)\n  _notify()\n}\n\n/**\n * Get all registered model instance names.\n * Automatically cleans up garbage-collected instances.\n */\nexport function getActiveModels(): string[] {\n  for (const [name, ref] of _activeModels) {\n    if (ref.deref() === undefined) _activeModels.delete(name)\n  }\n  return [..._activeModels.keys()]\n}\n\n/**\n * Get a model instance by name (or undefined if GC'd or not registered).\n */\nexport function getModelInstance(name: string): object | undefined {\n  const ref = _activeModels.get(name)\n  if (!ref) return undefined\n  const instance = ref.deref()\n  if (!instance) {\n    _activeModels.delete(name)\n    return undefined\n  }\n  return instance\n}\n\n/**\n * Get a snapshot of a registered model instance.\n */\nexport function getModelSnapshot(\n  name: string,\n): Record<string, unknown> | undefined {\n  const instance = getModelInstance(name)\n  if (!instance) return undefined\n  return getSnapshot(instance)\n}\n\n/**\n * Subscribe to model registry changes. Returns unsubscribe function.\n */\nexport function onModelChange(listener: () => void): () => void {\n  _listeners.add(listener)\n  return () => {\n    _listeners.delete(listener)\n  }\n}\n\n/** @internal — reset devtools registry (for tests). */\nexport function _resetDevtools(): void {\n  _activeModels.clear()\n  _listeners.clear()\n}\n"],"mappings":";;;;;AAMA,MAAa,+BAAe,IAAI,SAA+B;;AAG/D,SAAgB,gBAAgB,OAAyB;AACvD,QACE,SAAS,QACT,OAAO,UAAU,YACjB,aAAa,IAAI,MAAgB;;;;;;;;;;;;;ACErC,SAAgB,YACd,UACkB;CAClB,MAAM,OAAO,aAAa,IAAI,SAAS;AACvC,KAAI,CAAC,KACH,OAAM,IAAI,MAAM,yDAAyD;CAE3E,MAAM,MAA+B,EAAE;AACvC,MAAK,MAAM,OAAO,KAAK,WAAW;EAChC,MAAM,MAAO,SAA6C;AAC1D,MAAI,CAAC,IAAK;EACV,MAAM,MAAM,IAAI,MAAM;AACtB,MAAI,OAAO,gBAAgB,IAAI,GAAG,YAAY,IAAc,GAAG;;AAEjE,QAAO;;;;;;;;;ACrBT,MAAM,gCAAgB,IAAI,KAA8B;AACxD,MAAM,6BAAa,IAAI,KAAiB;AAExC,SAAS,UAAgB;AACvB,MAAK,MAAM,YAAY,WAAY,WAAU;;;;;;;;;;AAW/C,SAAgB,iBAAiB,MAAc,UAAwB;AACrE,eAAc,IAAI,MAAM,IAAI,QAAQ,SAAS,CAAC;AAC9C,UAAS;;;;;AAMX,SAAgB,mBAAmB,MAAoB;AACrD,eAAc,OAAO,KAAK;AAC1B,UAAS;;;;;;AAOX,SAAgB,kBAA4B;AAC1C,MAAK,MAAM,CAAC,MAAM,QAAQ,cACxB,KAAI,IAAI,OAAO,KAAK,OAAW,eAAc,OAAO,KAAK;AAE3D,QAAO,CAAC,GAAG,cAAc,MAAM,CAAC;;;;;AAMlC,SAAgB,iBAAiB,MAAkC;CACjE,MAAM,MAAM,cAAc,IAAI,KAAK;AACnC,KAAI,CAAC,IAAK,QAAO;CACjB,MAAM,WAAW,IAAI,OAAO;AAC5B,KAAI,CAAC,UAAU;AACb,gBAAc,OAAO,KAAK;AAC1B;;AAEF,QAAO;;;;;AAMT,SAAgB,iBACd,MACqC;CACrC,MAAM,WAAW,iBAAiB,KAAK;AACvC,KAAI,CAAC,SAAU,QAAO;AACtB,QAAO,YAAY,SAAS;;;;;AAM9B,SAAgB,cAAc,UAAkC;AAC9D,YAAW,IAAI,SAAS;AACxB,cAAa;AACX,aAAW,OAAO,SAAS;;;;AAK/B,SAAgB,iBAAuB;AACrC,eAAc,OAAO;AACrB,YAAW,OAAO"}

package/lib/index.js

@@ -0,0 +1,353 @@
+import { batch, signal } from "@pyreon/reactivity";
+
+//#region src/registry.ts
+/**
+* WeakMap from every model instance object → its internal metadata.
+* Shared across patch, middleware, and snapshot modules.
+*/
+const instanceMeta = /* @__PURE__ */ new WeakMap();
+/** Returns true when a value is a model instance (has metadata registered). */
+function isModelInstance(value) {
+	return value != null && typeof value === "object" && instanceMeta.has(value);
+}
+
+//#endregion
+//#region src/middleware.ts
+/**
+* Run an action through the middleware chain registered on `meta`.
+* Each middleware receives the call descriptor and a `next` function.
+* If no middlewares, the action runs directly.
+*/
+function runAction(meta, name, fn, args) {
+	const call = {
+		name,
+		args,
+		path: `/${name}`
+	};
+	const dispatch = (idx, c) => {
+		if (idx >= meta.middlewares.length) return fn(...c.args);
+		const mw = meta.middlewares[idx];
+		if (!mw) return fn(...c.args);
+		return mw(c, (nextCall) => dispatch(idx + 1, nextCall));
+	};
+	return dispatch(0, call);
+}
+/**
+* Intercept every action call on `instance`.
+* Middlewares run in registration order — call `next(call)` to continue.
+*
+* Returns an unsubscribe function.
+*
+* @example
+* const unsub = addMiddleware(counter, (call, next) => {
+*   console.log(`> ${call.name}(${call.args})`)
+*   const result = next(call)
+*   console.log(`< ${call.name}`)
+*   return result
+* })
+*/
+function addMiddleware(instance, middleware) {
+	const meta = instanceMeta.get(instance);
+	if (!meta) throw new Error("[@pyreon/state-tree] addMiddleware: not a model instance");
+	meta.middlewares.push(middleware);
+	return () => {
+		const idx = meta.middlewares.indexOf(middleware);
+		if (idx !== -1) meta.middlewares.splice(idx, 1);
+	};
+}
+
+//#endregion
+//#region src/patch.ts
+/** Property names that must never be used as patch path segments. */
+const RESERVED_KEYS = new Set([
+	"__proto__",
+	"constructor",
+	"prototype"
+]);
+/**
+* Wraps a signal so that every write emits a JSON patch via `emitPatch`.
+* Reads are pass-through — no overhead on hot reactive paths.
+*
+* @param hasListeners Optional predicate — when provided, patch object allocation
+*   and snapshotting are skipped entirely when no listeners are registered.
+*/
+function trackedSignal(inner, path, emitPatch, hasListeners) {
+	const read = () => inner();
+	read.peek = () => inner.peek();
+	read.subscribe = (listener) => inner.subscribe(listener);
+	read.set = (newValue) => {
+		const prev = inner.peek();
+		inner.set(newValue);
+		if (!Object.is(prev, newValue) && (!hasListeners || hasListeners())) emitPatch({
+			op: "replace",
+			path,
+			value: isModelInstance(newValue) ? snapshotValue(newValue) : newValue
+		});
+	};
+	read.update = (fn) => {
+		read.set(fn(inner.peek()));
+	};
+	return read;
+}
+/** Shallow snapshot helper (avoids importing snapshot.ts to prevent circular deps). */
+function snapshotValue(instance) {
+	const meta = instanceMeta.get(instance);
+	if (!meta) return instance;
+	const out = {};
+	for (const key of meta.stateKeys) {
+		const sig = instance[key];
+		if (!sig) continue;
+		const val = sig.peek();
+		out[key] = isModelInstance(val) ? snapshotValue(val) : val;
+	}
+	return out;
+}
+/**
+* Subscribe to every state mutation in `instance` as a JSON patch.
+* Also captures mutations in nested model instances (path is prefixed).
+*
+* Returns an unsubscribe function.
+*
+* @example
+* const unsub = onPatch(counter, patch => {
+*   // { op: "replace", path: "/count", value: 6 }
+* })
+*/
+function onPatch(instance, listener) {
+	const meta = instanceMeta.get(instance);
+	if (!meta) throw new Error("[@pyreon/state-tree] onPatch: not a model instance");
+	meta.patchListeners.add(listener);
+	return () => meta.patchListeners.delete(listener);
+}
+/**
+* Apply a JSON patch (or array of patches) to a model instance.
+* Only "replace" operations are supported (matching the patches emitted by `onPatch`).
+*
+* Paths use JSON pointer format: `"/count"` for top-level, `"/profile/name"` for nested.
+* Nested model instances are resolved automatically.
+*
+* @example
+* applyPatch(counter, { op: "replace", path: "/count", value: 10 })
+*
+* @example
+* // Replay patches recorded from onPatch (undo/redo, time-travel)
+* applyPatch(counter, [
+*   { op: "replace", path: "/count", value: 1 },
+*   { op: "replace", path: "/count", value: 2 },
+* ])
+*/
+function applyPatch(instance, patch) {
+	const patches = Array.isArray(patch) ? patch : [patch];
+	batch(() => {
+		for (const p of patches) {
+			if (p.op !== "replace") throw new Error(`[@pyreon/state-tree] applyPatch: unsupported op "${p.op}"`);
+			const segments = p.path.split("/").filter(Boolean);
+			if (segments.length === 0) throw new Error("[@pyreon/state-tree] applyPatch: empty path");
+			let target = instance;
+			for (let i = 0; i < segments.length - 1; i++) {
+				const segment = segments[i];
+				if (RESERVED_KEYS.has(segment)) throw new Error(`[@pyreon/state-tree] applyPatch: reserved property name "${segment}"`);
+				if (!instanceMeta.get(target)) throw new Error(`[@pyreon/state-tree] applyPatch: not a model instance at "${segment}"`);
+				const sig = target[segment];
+				if (!sig || typeof sig.peek !== "function") throw new Error(`[@pyreon/state-tree] applyPatch: unknown state key "${segment}"`);
+				const nested = sig.peek();
+				if (!nested || typeof nested !== "object" || !isModelInstance(nested)) throw new Error(`[@pyreon/state-tree] applyPatch: "${segment}" is not a nested model instance`);
+				target = nested;
+			}
+			const lastKey = segments[segments.length - 1];
+			if (RESERVED_KEYS.has(lastKey)) throw new Error(`[@pyreon/state-tree] applyPatch: reserved property name "${lastKey}"`);
+			const meta = instanceMeta.get(target);
+			if (!meta) throw new Error("[@pyreon/state-tree] applyPatch: not a model instance");
+			if (!meta.stateKeys.includes(lastKey)) throw new Error(`[@pyreon/state-tree] applyPatch: unknown state key "${lastKey}"`);
+			const sig = target[lastKey];
+			if (sig && typeof sig.set === "function") sig.set(p.value);
+		}
+	});
+}
+
+//#endregion
+//#region src/types.ts
+/** Property key stamped on every ModelDefinition to distinguish it from plain objects. */
+const MODEL_BRAND = "__pyreonMod";
+
+//#endregion
+//#region src/instance.ts
+function isModelDef(v) {
+	if (v == null || typeof v !== "object") return false;
+	return v[MODEL_BRAND] === true;
+}
+/**
+* Create a live model instance from a config + optional initial snapshot.
+* Called by `ModelDefinition.create()`.
+*/
+function createInstance(config, initial) {
+	const instance = {};
+	const meta = {
+		stateKeys: [],
+		patchListeners: /* @__PURE__ */ new Set(),
+		middlewares: [],
+		emitPatch(patch) {
+			if (this.patchListeners.size === 0) return;
+			for (const listener of this.patchListeners) listener(patch);
+		}
+	};
+	instanceMeta.set(instance, meta);
+	const self = new Proxy(instance, { get(_, k) {
+		return instance[k];
+	} });
+	for (const [key, defaultValue] of Object.entries(config.state)) {
+		meta.stateKeys.push(key);
+		const path = `/${key}`;
+		const initValue = key in initial ? initial[key] : void 0;
+		let rawSig;
+		if (isModelDef(defaultValue)) {
+			const nestedInstance = createInstance(defaultValue._config, initValue ?? {});
+			rawSig = signal(nestedInstance);
+			onPatch(nestedInstance, (patch) => {
+				meta.emitPatch({
+					...patch,
+					path: path + patch.path
+				});
+			});
+		} else rawSig = signal(initValue !== void 0 ? initValue : defaultValue);
+		instance[key] = trackedSignal(rawSig, path, (p) => meta.emitPatch(p), () => meta.patchListeners.size > 0);
+	}
+	if (config.views) {
+		const views = config.views(self);
+		for (const [key, view] of Object.entries(views)) instance[key] = view;
+	}
+	if (config.actions) {
+		const rawActions = config.actions(self);
+		for (const [key, actionFn] of Object.entries(rawActions)) instance[key] = (...args) => runAction(meta, key, actionFn, args);
+	}
+	return instance;
+}
+
+//#endregion
+//#region src/model.ts
+const _hookRegistry = /* @__PURE__ */ new Map();
+/** Destroy a hook singleton by id so next call re-creates the instance. */
+function resetHook(id) {
+	_hookRegistry.delete(id);
+}
+/** Destroy all hook singletons. */
+function resetAllHooks() {
+	_hookRegistry.clear();
+}
+/**
+* Returned by `model()`. Call `.create()` for instances or `.asHook(id)` for
+* a Zustand-style singleton hook.
+*/
+var ModelDefinition = class {
+	/** Brand used to identify ModelDefinition objects at runtime (without instanceof). */
+	[MODEL_BRAND] = true;
+	/** @internal — exposed so nested instance creation can read it. */
+	_config;
+	constructor(config) {
+		this._config = config;
+	}
+	/**
+	* Create a new independent model instance.
+	* Pass a partial snapshot to override defaults.
+	*
+	* @example
+	* const counter = Counter.create({ count: 5 })
+	*/
+	create(initial) {
+		return createInstance(this._config, initial ?? {});
+	}
+	/**
+	* Returns a hook function that always returns the same singleton instance
+	* for the given `id` — Zustand / Pinia style.
+	*
+	* @example
+	* const useCounter = Counter.asHook("app-counter")
+	* // Any call to useCounter() returns the same instance.
+	* const store = useCounter()
+	*/
+	asHook(id) {
+		return () => {
+			if (!_hookRegistry.has(id)) _hookRegistry.set(id, this.create());
+			return _hookRegistry.get(id);
+		};
+	}
+};
+/**
+* Define a reactive model with state, views, and actions.
+*
+* - **state** — plain JS object; each key becomes a `Signal<T>` on the instance.
+* - **views** — factory receiving `self`; return computed signals for derived state.
+* - **actions** — factory receiving `self`; return functions that mutate state.
+*
+* Use nested `ModelDefinition` values in `state` to compose models.
+*
+* @example
+* const Counter = model({
+*   state: { count: 0 },
+*   views: (self) => ({
+*     doubled: computed(() => self.count() * 2),
+*   }),
+*   actions: (self) => ({
+*     inc:   () => self.count.update(c => c + 1),
+*     reset: () => self.count.set(0),
+*   }),
+* })
+*
+* const c = Counter.create({ count: 5 })
+* c.count()    // 5
+* c.inc()
+* c.doubled()  // 12
+*/
+function model(config) {
+	return new ModelDefinition(config);
+}
+
+//#endregion
+//#region src/snapshot.ts
+/**
+* Serialize a model instance to a plain JS object (no signals, no functions).
+* Nested model instances are recursively serialized.
+*
+* @example
+* getSnapshot(counter)  // { count: 6 }
+* getSnapshot(app)      // { profile: { name: "Alice" }, title: "My App" }
+*/
+function getSnapshot(instance) {
+	const meta = instanceMeta.get(instance);
+	if (!meta) throw new Error("[@pyreon/state-tree] getSnapshot: not a model instance");
+	const out = {};
+	for (const key of meta.stateKeys) {
+		const sig = instance[key];
+		if (!sig) continue;
+		const val = sig.peek();
+		out[key] = isModelInstance(val) ? getSnapshot(val) : val;
+	}
+	return out;
+}
+/**
+* Restore a model instance from a plain-object snapshot.
+* All signal writes are coalesced via `batch()` for a single reactive flush.
+* Keys absent from the snapshot are left unchanged.
+*
+* @example
+* applySnapshot(counter, { count: 0 })
+*/
+function applySnapshot(instance, snapshot) {
+	const meta = instanceMeta.get(instance);
+	if (!meta) throw new Error("[@pyreon/state-tree] applySnapshot: not a model instance");
+	batch(() => {
+		for (const key of meta.stateKeys) {
+			if (!(key in snapshot)) continue;
+			const sig = instance[key];
+			if (!sig) continue;
+			const val = snapshot[key];
+			const current = sig.peek();
+			if (isModelInstance(current)) applySnapshot(current, val);
+			else sig.set(val);
+		}
+	});
+}
+
+//#endregion
+export { addMiddleware, applyPatch, applySnapshot, getSnapshot, model, onPatch, resetAllHooks, resetHook };
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/registry.ts","../src/middleware.ts","../src/patch.ts","../src/types.ts","../src/instance.ts","../src/model.ts","../src/snapshot.ts"],"sourcesContent":["import type { InstanceMeta } from './types'\n\n/**\n * WeakMap from every model instance object → its internal metadata.\n * Shared across patch, middleware, and snapshot modules.\n */\nexport const instanceMeta = new WeakMap<object, InstanceMeta>()\n\n/** Returns true when a value is a model instance (has metadata registered). */\nexport function isModelInstance(value: unknown): boolean {\n  return (\n    value != null &&\n    typeof value === 'object' &&\n    instanceMeta.has(value as object)\n  )\n}\n","import { instanceMeta } from './registry'\nimport type { ActionCall, InstanceMeta, MiddlewareFn } from './types'\n\n// ─── Action runner ────────────────────────────────────────────────────────────\n\n/**\n * Run an action through the middleware chain registered on `meta`.\n * Each middleware receives the call descriptor and a `next` function.\n * If no middlewares, the action runs directly.\n */\nexport function runAction(\n  meta: InstanceMeta,\n  name: string,\n  fn: (...fnArgs: unknown[]) => unknown,\n  args: unknown[],\n): unknown {\n  const call: ActionCall = { name, args, path: `/${name}` }\n\n  const dispatch = (idx: number, c: ActionCall): unknown => {\n    if (idx >= meta.middlewares.length) return fn(...c.args)\n    const mw = meta.middlewares[idx]\n    if (!mw) return fn(...c.args)\n    return mw(c, (nextCall) => dispatch(idx + 1, nextCall))\n  }\n\n  return dispatch(0, call)\n}\n\n// ─── addMiddleware ────────────────────────────────────────────────────────────\n\n/**\n * Intercept every action call on `instance`.\n * Middlewares run in registration order — call `next(call)` to continue.\n *\n * Returns an unsubscribe function.\n *\n * @example\n * const unsub = addMiddleware(counter, (call, next) => {\n *   console.log(`> ${call.name}(${call.args})`)\n *   const result = next(call)\n *   console.log(`< ${call.name}`)\n *   return result\n * })\n */\nexport function addMiddleware(\n  instance: object,\n  middleware: MiddlewareFn,\n): () => void {\n  const meta = instanceMeta.get(instance)\n  if (!meta)\n    throw new Error('[@pyreon/state-tree] addMiddleware: not a model instance')\n  meta.middlewares.push(middleware)\n  return () => {\n    const idx = meta.middlewares.indexOf(middleware)\n    if (idx !== -1) meta.middlewares.splice(idx, 1)\n  }\n}\n","import type { Signal } from '@pyreon/reactivity'\nimport { batch } from '@pyreon/reactivity'\nimport { instanceMeta, isModelInstance } from './registry'\nimport type { Patch, PatchListener } from './types'\n\n/** Property names that must never be used as patch path segments. */\nconst RESERVED_KEYS = new Set(['__proto__', 'constructor', 'prototype'])\n\n// ─── Tracked signal ───────────────────────────────────────────────────────────\n\n/**\n * Wraps a signal so that every write emits a JSON patch via `emitPatch`.\n * Reads are pass-through — no overhead on hot reactive paths.\n *\n * @param hasListeners Optional predicate — when provided, patch object allocation\n *   and snapshotting are skipped entirely when no listeners are registered.\n */\nexport function trackedSignal<T>(\n  inner: Signal<T>,\n  path: string,\n  emitPatch: (patch: Patch) => void,\n  hasListeners?: () => boolean,\n): Signal<T> {\n  const read = (): T => inner()\n\n  read.peek = (): T => inner.peek()\n\n  read.subscribe = (listener: () => void): (() => void) =>\n    inner.subscribe(listener)\n\n  read.set = (newValue: T): void => {\n    const prev = inner.peek()\n    inner.set(newValue)\n    // Skip patch emission entirely when no one is listening — avoids object\n    // allocation and (for nested instances) a full recursive snapshot.\n    if (!Object.is(prev, newValue) && (!hasListeners || hasListeners())) {\n      // For model instances, emit the snapshot rather than the live object\n      // so patches are always plain JSON-serializable values.\n      const patchValue = isModelInstance(newValue)\n        ? snapshotValue(newValue as object)\n        : newValue\n      emitPatch({ op: 'replace', path, value: patchValue })\n    }\n  }\n\n  read.update = (fn: (current: T) => T): void => {\n    read.set(fn(inner.peek()))\n  }\n\n  return read as Signal<T>\n}\n\n/** Shallow snapshot helper (avoids importing snapshot.ts to prevent circular deps). */\nfunction snapshotValue(instance: object): Record<string, unknown> {\n  const meta = instanceMeta.get(instance)\n  if (!meta) return instance as Record<string, unknown>\n  const out: Record<string, unknown> = {}\n  for (const key of meta.stateKeys) {\n    const sig = (instance as Record<string, Signal<unknown>>)[key]\n    if (!sig) continue\n    const val = sig.peek()\n    out[key] = isModelInstance(val) ? snapshotValue(val as object) : val\n  }\n  return out\n}\n\n// ─── onPatch ──────────────────────────────────────────────────────────────────\n\n/**\n * Subscribe to every state mutation in `instance` as a JSON patch.\n * Also captures mutations in nested model instances (path is prefixed).\n *\n * Returns an unsubscribe function.\n *\n * @example\n * const unsub = onPatch(counter, patch => {\n *   // { op: \"replace\", path: \"/count\", value: 6 }\n * })\n */\nexport function onPatch(instance: object, listener: PatchListener): () => void {\n  const meta = instanceMeta.get(instance)\n  if (!meta)\n    throw new Error('[@pyreon/state-tree] onPatch: not a model instance')\n  meta.patchListeners.add(listener)\n  return () => meta.patchListeners.delete(listener)\n}\n\n// ─── applyPatch ─────────────────────────────────────────────────────────────\n\n/**\n * Apply a JSON patch (or array of patches) to a model instance.\n * Only \"replace\" operations are supported (matching the patches emitted by `onPatch`).\n *\n * Paths use JSON pointer format: `\"/count\"` for top-level, `\"/profile/name\"` for nested.\n * Nested model instances are resolved automatically.\n *\n * @example\n * applyPatch(counter, { op: \"replace\", path: \"/count\", value: 10 })\n *\n * @example\n * // Replay patches recorded from onPatch (undo/redo, time-travel)\n * applyPatch(counter, [\n *   { op: \"replace\", path: \"/count\", value: 1 },\n *   { op: \"replace\", path: \"/count\", value: 2 },\n * ])\n */\nexport function applyPatch(instance: object, patch: Patch | Patch[]): void {\n  const patches = Array.isArray(patch) ? patch : [patch]\n\n  batch(() => {\n    for (const p of patches) {\n      if (p.op !== 'replace') {\n        throw new Error(\n          `[@pyreon/state-tree] applyPatch: unsupported op \"${p.op}\"`,\n        )\n      }\n\n      const segments = p.path.split('/').filter(Boolean)\n      if (segments.length === 0) {\n        throw new Error('[@pyreon/state-tree] applyPatch: empty path')\n      }\n\n      // Walk to the target instance for nested paths\n      let target: object = instance\n      for (let i = 0; i < segments.length - 1; i++) {\n        const segment = segments[i]!\n        if (RESERVED_KEYS.has(segment)) {\n          throw new Error(\n            `[@pyreon/state-tree] applyPatch: reserved property name \"${segment}\"`,\n          )\n        }\n        const meta = instanceMeta.get(target)\n        if (!meta)\n          throw new Error(\n            `[@pyreon/state-tree] applyPatch: not a model instance at \"${segment}\"`,\n          )\n        const sig = (target as Record<string, Signal<unknown>>)[segment]\n        if (!sig || typeof sig.peek !== 'function') {\n          throw new Error(\n            `[@pyreon/state-tree] applyPatch: unknown state key \"${segment}\"`,\n          )\n        }\n        const nested = sig.peek()\n        if (!nested || typeof nested !== 'object' || !isModelInstance(nested)) {\n          throw new Error(\n            `[@pyreon/state-tree] applyPatch: \"${segment}\" is not a nested model instance`,\n          )\n        }\n        target = nested as object\n      }\n\n      const lastKey = segments[segments.length - 1]!\n      if (RESERVED_KEYS.has(lastKey)) {\n        throw new Error(\n          `[@pyreon/state-tree] applyPatch: reserved property name \"${lastKey}\"`,\n        )\n      }\n      const meta = instanceMeta.get(target)\n      if (!meta)\n        throw new Error('[@pyreon/state-tree] applyPatch: not a model instance')\n      if (!meta.stateKeys.includes(lastKey)) {\n        throw new Error(\n          `[@pyreon/state-tree] applyPatch: unknown state key \"${lastKey}\"`,\n        )\n      }\n\n      const sig = (target as Record<string, Signal<unknown>>)[lastKey]\n      if (sig && typeof sig.set === 'function') {\n        sig.set(p.value)\n      }\n    }\n  })\n}\n","import type { Computed, Signal } from '@pyreon/reactivity'\n\n// ─── Model brand ──────────────────────────────────────────────────────────────\n\n/** Property key stamped on every ModelDefinition to distinguish it from plain objects. */\nexport const MODEL_BRAND = '__pyreonMod' as const\n\n// ─── State type helpers ───────────────────────────────────────────────────────\n\nexport type StateShape = Record<string, unknown>\n\n/**\n * Resolve a state field type:\n * - ModelDefinition → the instance type it produces\n * - Anything else → as-is\n */\nexport type ResolveField<T> = T extends {\n  readonly __pyreonMod: true\n  create(initial?: any): infer I\n}\n  ? I\n  : T\n\n/** Map state shape to per-field signals. */\nexport type StateSignals<TState extends StateShape> = {\n  readonly [K in keyof TState]: Signal<ResolveField<TState[K]>>\n}\n\n/**\n * `self` type inside actions / views:\n * strongly typed for state signals, `any` for actions and views so that\n * actions can call each other without circular type issues.\n */\nexport type ModelSelf<TState extends StateShape> = StateSignals<TState> &\n  Record<string, any>\n\n/** The public instance type returned by `.create()` and hooks. */\nexport type ModelInstance<\n  TState extends StateShape,\n  TActions extends Record<string, (...args: any[]) => any>,\n  TViews extends Record<string, Signal<any> | Computed<any>>,\n> = StateSignals<TState> & TActions & TViews\n\n/**\n * Extract the state type from a ModelDefinition.\n * Used by Snapshot to recursively resolve nested model types.\n */\ntype ExtractModelState<T> = T extends {\n  readonly __pyreonMod: true\n  readonly _config: { state: infer S extends StateShape }\n}\n  ? S\n  : never\n\n/**\n * Snapshot type: plain JS values (no signals, no model instances).\n * Nested model fields recursively produce their own typed snapshot.\n */\nexport type Snapshot<TState extends StateShape> = {\n  [K in keyof TState]: TState[K] extends { readonly __pyreonMod: true }\n    ? Snapshot<ExtractModelState<TState[K]>>\n    : TState[K]\n}\n\n// ─── Patch ────────────────────────────────────────────────────────────────────\n\nexport interface Patch {\n  op: 'replace'\n  path: string\n  value: unknown\n}\n\nexport type PatchListener = (patch: Patch) => void\n\n// ─── Middleware ───────────────────────────────────────────────────────────────\n\nexport interface ActionCall {\n  /** Action name. */\n  name: string\n  /** Arguments passed to the action. */\n  args: unknown[]\n  /** JSON-pointer-style path, e.g. `\"/inc\"`. */\n  path: string\n}\n\nexport type MiddlewareFn = (\n  call: ActionCall,\n  next: (nextCall: ActionCall) => unknown,\n) => unknown\n\n// ─── Instance metadata ────────────────────────────────────────────────────────\n\nexport interface InstanceMeta {\n  stateKeys: string[]\n  patchListeners: Set<PatchListener>\n  middlewares: MiddlewareFn[]\n  emitPatch(patch: Patch): void\n}\n","import type { Computed, Signal } from '@pyreon/reactivity'\nimport { signal } from '@pyreon/reactivity'\nimport { runAction } from './middleware'\nimport { onPatch, trackedSignal } from './patch'\nimport { instanceMeta } from './registry'\nimport type { InstanceMeta, ModelInstance, Snapshot, StateShape } from './types'\nimport { MODEL_BRAND } from './types'\n\n// ─── Model definition detection ───────────────────────────────────────────────\n\ninterface AnyModelDef {\n  readonly [MODEL_BRAND]: true\n  readonly _config: ModelConfig<\n    StateShape,\n    Record<string, (...args: unknown[]) => unknown>,\n    Record<string, Signal<unknown>>\n  >\n}\n\nfunction isModelDef(v: unknown): v is AnyModelDef {\n  if (v == null || typeof v !== 'object') return false\n  return (v as Record<string, unknown>)[MODEL_BRAND] === true\n}\n\n// ─── Config shape ─────────────────────────────────────────────────────────────\n\nexport interface ModelConfig<TState extends StateShape, TActions, TViews> {\n  state: TState\n  views?: (self: any) => TViews\n  actions?: (self: any) => TActions\n}\n\n// ─── createInstance ───────────────────────────────────────────────────────────\n\n/**\n * Create a live model instance from a config + optional initial snapshot.\n * Called by `ModelDefinition.create()`.\n */\nexport function createInstance<\n  TState extends StateShape,\n  TActions extends Record<string, (...args: any[]) => any>,\n  TViews extends Record<string, Signal<any> | Computed<any>>,\n>(\n  config: ModelConfig<TState, TActions, TViews>,\n  initial: Partial<Snapshot<TState>>,\n): ModelInstance<TState, TActions, TViews> {\n  // Raw object that will become the instance.\n  const instance: Record<string, unknown> = {}\n\n  // Metadata for this instance.\n  const meta: InstanceMeta = {\n    stateKeys: [],\n    patchListeners: new Set(),\n    middlewares: [],\n    emitPatch(patch) {\n      // Guard avoids iterating an empty Set on the hot signal-write path.\n      if (this.patchListeners.size === 0) return\n      for (const listener of this.patchListeners) listener(patch)\n    },\n  }\n  instanceMeta.set(instance, meta)\n\n  // `self` is a live proxy so that actions/views always see the final\n  // (fully-populated) instance — including wrapped actions added later.\n  const self = new Proxy(instance, {\n    get(_, k) {\n      return instance[k as string]\n    },\n  })\n\n  // ── 1. State signals ──────────────────────────────────────────────────────\n  for (const [key, defaultValue] of Object.entries(config.state)) {\n    meta.stateKeys.push(key)\n    const path = `/${key}`\n    const initValue: unknown =\n      key in initial ? (initial as Record<string, unknown>)[key] : undefined\n\n    let rawSig: Signal<unknown>\n\n    if (isModelDef(defaultValue)) {\n      // Nested model — create its instance from the supplied snapshot (or defaults).\n      const nestedInstance = createInstance(\n        defaultValue._config,\n        (initValue as Record<string, unknown>) ?? {},\n      )\n      rawSig = signal(nestedInstance)\n\n      // Propagate nested patches upward with the key as path prefix.\n      onPatch(nestedInstance, (patch) => {\n        meta.emitPatch({ ...patch, path: path + patch.path })\n      })\n    } else {\n      rawSig = signal(initValue !== undefined ? initValue : defaultValue)\n    }\n\n    const tracked = trackedSignal(\n      rawSig,\n      path,\n      (p) => meta.emitPatch(p),\n      () => meta.patchListeners.size > 0,\n    )\n    instance[key] = tracked\n  }\n\n  // ── 2. Views ──────────────────────────────────────────────────────────────\n  if (config.views) {\n    const views = config.views(self)\n    for (const [key, view] of Object.entries(\n      views as Record<string, unknown>,\n    )) {\n      instance[key] = view\n    }\n  }\n\n  // ── 3. Actions (wrapped with middleware runner) ───────────────────────────\n  if (config.actions) {\n    const rawActions = config.actions(self) as Record<\n      string,\n      (...args: unknown[]) => unknown\n    >\n    for (const [key, actionFn] of Object.entries(rawActions)) {\n      instance[key] = (...args: unknown[]) =>\n        runAction(meta, key, actionFn, args)\n    }\n  }\n\n  return instance as ModelInstance<TState, TActions, TViews>\n}\n","import type { Computed, Signal } from '@pyreon/reactivity'\nimport { createInstance, type ModelConfig } from './instance'\nimport type { ModelInstance, Snapshot, StateShape } from './types'\nimport { MODEL_BRAND } from './types'\n\n// ─── Hook registry ────────────────────────────────────────────────────────────\n\n// Module-level singleton registry for `asHook()` — isolated per package import.\n// Use `resetHook(id)` or `resetAllHooks()` to clear entries (useful for tests / HMR).\nconst _hookRegistry = new Map<string, unknown>()\n\n/** Destroy a hook singleton by id so next call re-creates the instance. */\nexport function resetHook(id: string): void {\n  _hookRegistry.delete(id)\n}\n\n/** Destroy all hook singletons. */\nexport function resetAllHooks(): void {\n  _hookRegistry.clear()\n}\n\n// ─── ModelDefinition ──────────────────────────────────────────────────────────\n\n/**\n * Returned by `model()`. Call `.create()` for instances or `.asHook(id)` for\n * a Zustand-style singleton hook.\n */\nexport class ModelDefinition<\n  TState extends StateShape,\n  TActions extends Record<string, (...args: any[]) => any>,\n  TViews extends Record<string, Signal<any> | Computed<any>>,\n> {\n  /** Brand used to identify ModelDefinition objects at runtime (without instanceof). */\n  readonly [MODEL_BRAND] = true as const\n\n  /** @internal — exposed so nested instance creation can read it. */\n  readonly _config: ModelConfig<TState, TActions, TViews>\n\n  constructor(config: ModelConfig<TState, TActions, TViews>) {\n    this._config = config\n  }\n\n  /**\n   * Create a new independent model instance.\n   * Pass a partial snapshot to override defaults.\n   *\n   * @example\n   * const counter = Counter.create({ count: 5 })\n   */\n  create(\n    initial?: Partial<Snapshot<TState>>,\n  ): ModelInstance<TState, TActions, TViews> {\n    return createInstance(this._config, initial ?? {})\n  }\n\n  /**\n   * Returns a hook function that always returns the same singleton instance\n   * for the given `id` — Zustand / Pinia style.\n   *\n   * @example\n   * const useCounter = Counter.asHook(\"app-counter\")\n   * // Any call to useCounter() returns the same instance.\n   * const store = useCounter()\n   */\n  asHook(id: string): () => ModelInstance<TState, TActions, TViews> {\n    return () => {\n      if (!_hookRegistry.has(id)) {\n        _hookRegistry.set(id, this.create())\n      }\n      return _hookRegistry.get(id) as ModelInstance<TState, TActions, TViews>\n    }\n  }\n}\n\n// ─── model() factory ──────────────────────────────────────────────────────────\n\n/**\n * Define a reactive model with state, views, and actions.\n *\n * - **state** — plain JS object; each key becomes a `Signal<T>` on the instance.\n * - **views** — factory receiving `self`; return computed signals for derived state.\n * - **actions** — factory receiving `self`; return functions that mutate state.\n *\n * Use nested `ModelDefinition` values in `state` to compose models.\n *\n * @example\n * const Counter = model({\n *   state: { count: 0 },\n *   views: (self) => ({\n *     doubled: computed(() => self.count() * 2),\n *   }),\n *   actions: (self) => ({\n *     inc:   () => self.count.update(c => c + 1),\n *     reset: () => self.count.set(0),\n *   }),\n * })\n *\n * const c = Counter.create({ count: 5 })\n * c.count()    // 5\n * c.inc()\n * c.doubled()  // 12\n */\nexport function model<\n  TState extends StateShape,\n  TActions extends Record<string, (...args: any[]) => any> = Record<\n    never,\n    never\n  >,\n  TViews extends Record<string, Signal<any> | Computed<any>> = Record<\n    never,\n    never\n  >,\n>(\n  config: ModelConfig<TState, TActions, TViews>,\n): ModelDefinition<TState, TActions, TViews> {\n  return new ModelDefinition(config)\n}\n","import type { Signal } from '@pyreon/reactivity'\nimport { batch } from '@pyreon/reactivity'\nimport { instanceMeta, isModelInstance } from './registry'\nimport type { Snapshot, StateShape } from './types'\n\n// ─── getSnapshot ──────────────────────────────────────────────────────────────\n\n/**\n * Serialize a model instance to a plain JS object (no signals, no functions).\n * Nested model instances are recursively serialized.\n *\n * @example\n * getSnapshot(counter)  // { count: 6 }\n * getSnapshot(app)      // { profile: { name: \"Alice\" }, title: \"My App\" }\n */\nexport function getSnapshot<TState extends StateShape>(\n  instance: object,\n): Snapshot<TState> {\n  const meta = instanceMeta.get(instance)\n  if (!meta)\n    throw new Error('[@pyreon/state-tree] getSnapshot: not a model instance')\n\n  const out: Record<string, unknown> = {}\n  for (const key of meta.stateKeys) {\n    const sig = (instance as Record<string, Signal<unknown>>)[key]\n    if (!sig) continue\n    const val = sig.peek()\n    out[key] = isModelInstance(val) ? getSnapshot(val as object) : val\n  }\n  return out as Snapshot<TState>\n}\n\n// ─── applySnapshot ────────────────────────────────────────────────────────────\n\n/**\n * Restore a model instance from a plain-object snapshot.\n * All signal writes are coalesced via `batch()` for a single reactive flush.\n * Keys absent from the snapshot are left unchanged.\n *\n * @example\n * applySnapshot(counter, { count: 0 })\n */\nexport function applySnapshot<TState extends StateShape>(\n  instance: object,\n  snapshot: Partial<Snapshot<TState>>,\n): void {\n  const meta = instanceMeta.get(instance)\n  if (!meta)\n    throw new Error('[@pyreon/state-tree] applySnapshot: not a model instance')\n\n  batch(() => {\n    for (const key of meta.stateKeys) {\n      if (!(key in snapshot)) continue\n      const sig = (instance as Record<string, Signal<unknown>>)[key]\n      if (!sig) continue\n      const val = (snapshot as Record<string, unknown>)[key]\n      const current = sig.peek()\n      if (isModelInstance(current)) {\n        // Recurse into nested model instance\n        applySnapshot(current as object, val as Record<string, unknown>)\n      } else {\n        sig.set(val)\n      }\n    }\n  })\n}\n"],"mappings":"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"}

package/lib/types/devtools.d.ts

@@ -0,0 +1,104 @@
+/** Returns true when a value is a model instance (has metadata registered). */
+function isModelInstance(value) {
+  return value != null && typeof value === "object" && instanceMeta.has(value);
+}
+
+//#endregion
+//#region src/snapshot.ts
+/**
+* Serialize a model instance to a plain JS object (no signals, no functions).
+* Nested model instances are recursively serialized.
+*
+* @example
+* getSnapshot(counter)  // { count: 6 }
+* getSnapshot(app)      // { profile: { name: "Alice" }, title: "My App" }
+*/
+function getSnapshot(instance) {
+  const meta = instanceMeta.get(instance);
+  if (!meta) throw new Error("[@pyreon/state-tree] getSnapshot: not a model instance");
+  const out = {};
+  for (const key of meta.stateKeys) {
+    const sig = instance[key];
+    if (!sig) continue;
+    const val = sig.peek();
+    out[key] = isModelInstance(val) ? getSnapshot(val) : val;
+  }
+  return out;
+}
+
+//#endregion
+//#region src/devtools.ts
+/**
+* @pyreon/state-tree devtools introspection API.
+* Import: `import { ... } from "@pyreon/state-tree/devtools"`
+*/
+
+function _notify() {
+  for (const listener of _listeners) listener();
+}
+/**
+* Register a model instance for devtools inspection.
+* Call this when creating instances you want visible in devtools.
+*
+* @example
+* const counter = Counter.create()
+* registerInstance("app-counter", counter)
+*/
+function registerInstance(name, instance) {
+  _activeModels.set(name, new WeakRef(instance));
+  _notify();
+}
+/**
+* Unregister a model instance.
+*/
+function unregisterInstance(name) {
+  _activeModels.delete(name);
+  _notify();
+}
+/**
+* Get all registered model instance names.
+* Automatically cleans up garbage-collected instances.
+*/
+function getActiveModels() {
+  for (const [name, ref] of _activeModels) if (ref.deref() === void 0) _activeModels.delete(name);
+  return [..._activeModels.keys()];
+}
+/**
+* Get a model instance by name (or undefined if GC'd or not registered).
+*/
+function getModelInstance(name) {
+  const ref = _activeModels.get(name);
+  if (!ref) return void 0;
+  const instance = ref.deref();
+  if (!instance) {
+    _activeModels.delete(name);
+    return;
+  }
+  return instance;
+}
+/**
+* Get a snapshot of a registered model instance.
+*/
+function getModelSnapshot(name) {
+  const instance = getModelInstance(name);
+  if (!instance) return void 0;
+  return getSnapshot(instance);
+}
+/**
+* Subscribe to model registry changes. Returns unsubscribe function.
+*/
+function onModelChange(listener) {
+  _listeners.add(listener);
+  return () => {
+    _listeners.delete(listener);
+  };
+}
+/** @internal — reset devtools registry (for tests). */
+function _resetDevtools() {
+  _activeModels.clear();
+  _listeners.clear();
+}
+
+//#endregion
+export { _resetDevtools, getActiveModels, getModelInstance, getModelSnapshot, onModelChange, registerInstance, unregisterInstance };
+//# sourceMappingURL=devtools.d.ts.map

package/lib/types/devtools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools.d.ts","names":[],"sources":["../../src/registry.ts","../../src/snapshot.ts","../../src/devtools.ts"],"mappings":";AASA,SAAgB,eAAA,CAAgB,KAAA,EAAyB;EACvD,OACE,KAAA,IAAS,IAAA,IACT,OAAO,KAAA,KAAU,QAAA,IACjB,YAAA,CAAa,GAAA,CAAI,KAAA,CAAgB;;;;;;;;;;;;;ACErC,SAAgB,WAAA,CACd,QAAA,EACkB;EAClB,MAAM,IAAA,GAAO,YAAA,CAAa,GAAA,CAAI,QAAA,CAAS;EACvC,IAAI,CAAC,IAAA,EACH,MAAM,IAAI,KAAA,CAAM,wDAAA,CAAyD;EAE3E,MAAM,GAAA,GAA+B,CAAA,CAAE;EACvC,KAAK,MAAM,GAAA,IAAO,IAAA,CAAK,SAAA,EAAW;IAChC,MAAM,GAAA,GAAO,QAAA,CAA6C,GAAA,CAAA;IAC1D,IAAI,CAAC,GAAA,EAAK;IACV,MAAM,GAAA,GAAM,GAAA,CAAI,IAAA,CAAA,CAAM;IACtB,GAAA,CAAI,GAAA,CAAA,GAAO,eAAA,CAAgB,GAAA,CAAI,GAAG,WAAA,CAAY,GAAA,CAAc,GAAG,GAAA;;EAEjE,OAAO,GAAA;;;;;;;;;;AClBT,SAAS,OAAA,CAAA,EAAgB;EACvB,KAAK,MAAM,QAAA,IAAY,UAAA,EAAY,QAAA,CAAA,CAAU;;;;;;;;;;AAW/C,SAAgB,gBAAA,CAAiB,IAAA,EAAc,QAAA,EAAwB;EACrE,aAAA,CAAc,GAAA,CAAI,IAAA,EAAM,IAAI,OAAA,CAAQ,QAAA,CAAS,CAAC;EAC9C,OAAA,CAAA,CAAS;;;;;AAMX,SAAgB,kBAAA,CAAmB,IAAA,EAAoB;EACrD,aAAA,CAAc,MAAA,CAAO,IAAA,CAAK;EAC1B,OAAA,CAAA,CAAS;;;;;;AAOX,SAAgB,eAAA,CAAA,EAA4B;EAC1C,KAAK,MAAM,CAAC,IAAA,EAAM,GAAA,CAAA,IAAQ,aAAA,EACxB,IAAI,GAAA,CAAI,KAAA,CAAA,CAAO,KAAK,KAAA,CAAA,EAAW,aAAA,CAAc,MAAA,CAAO,IAAA,CAAK;EAE3D,OAAO,CAAC,GAAG,aAAA,CAAc,IAAA,CAAA,CAAM,CAAC;;;;;AAMlC,SAAgB,gBAAA,CAAiB,IAAA,EAAkC;EACjE,MAAM,GAAA,GAAM,aAAA,CAAc,GAAA,CAAI,IAAA,CAAK;EACnC,IAAI,CAAC,GAAA,EAAK,OAAO,KAAA,CAAA;EACjB,MAAM,QAAA,GAAW,GAAA,CAAI,KAAA,CAAA,CAAO;EAC5B,IAAI,CAAC,QAAA,EAAU;IACb,aAAA,CAAc,MAAA,CAAO,IAAA,CAAK;IAC1B;;EAEF,OAAO,QAAA;;;;;AAMT,SAAgB,gBAAA,CACd,IAAA,EACqC;EACrC,MAAM,QAAA,GAAW,gBAAA,CAAiB,IAAA,CAAK;EACvC,IAAI,CAAC,QAAA,EAAU,OAAO,KAAA,CAAA;EACtB,OAAO,WAAA,CAAY,QAAA,CAAS;;;;;AAM9B,SAAgB,aAAA,CAAc,QAAA,EAAkC;EAC9D,UAAA,CAAW,GAAA,CAAI,QAAA,CAAS;EACxB,OAAA,MAAa;IACX,UAAA,CAAW,MAAA,CAAO,QAAA,CAAS;;;;AAK/B,SAAgB,cAAA,CAAA,EAAuB;EACrC,aAAA,CAAc,KAAA,CAAA,CAAO;EACrB,UAAA,CAAW,KAAA,CAAA,CAAO"}