@pyreon/state-tree 0.6.0 → 0.8.0

package/lib/types/devtools.d.ts

@@ -1,104 +1,40 @@
-/** 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);
-  };
-}
+//#region src/devtools.d.ts
+/**
+ * @pyreon/state-tree devtools introspection API.
+ * Import: `import { ... } from "@pyreon/state-tree/devtools"`
+ */
+/**
+ * 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)
+ */
+declare function registerInstance(name: string, instance: object): void;
+/**
+ * Unregister a model instance.
+ */
+declare function unregisterInstance(name: string): void;
+/**
+ * Get all registered model instance names.
+ * Automatically cleans up garbage-collected instances.
+ */
+declare function getActiveModels(): string[];
+/**
+ * Get a model instance by name (or undefined if GC'd or not registered).
+ */
+declare function getModelInstance(name: string): object | undefined;
+/**
+ * Get a snapshot of a registered model instance.
+ */
+declare function getModelSnapshot(name: string): Record<string, unknown> | undefined;
+/**
+ * Subscribe to model registry changes. Returns unsubscribe function.
+ */
+declare function onModelChange(listener: () => void): () => void;
 /** @internal — reset devtools registry (for tests). */
-function _resetDevtools() {
-  _activeModels.clear();
-  _listeners.clear();
-}
-
+declare function _resetDevtools(): void;
 //#endregion
 export { _resetDevtools, getActiveModels, getModelInstance, getModelSnapshot, onModelChange, registerInstance, unregisterInstance };
-//# sourceMappingURL=devtools.d.ts.map
+//# sourceMappingURL=devtools2.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"devtools2.d.ts","names":[],"sources":["../../../src/devtools.ts"],"mappings":";;AAuBA;;;;;AAQA;;;;;AASA;iBAjBgB,gBAAA,CAAiB,IAAA,UAAc,QAAA;;;;iBAQ/B,kBAAA,CAAmB,IAAA;;;;;iBASnB,eAAA,CAAA;;;;iBAUA,gBAAA,CAAiB,IAAA;AAyBjC;;;AAAA,iBAXgB,gBAAA,CACd,IAAA,WACC,MAAA;;AAiBH;;iBARgB,aAAA,CAAc,QAAA;;iBAQd,cAAA,CAAA"}

package/lib/types/index.d.ts

@@ -1,316 +1,198 @@
-import { batch, signal } from "@pyreon/reactivity";
+import { Computed, Signal } from "@pyreon/reactivity";
 
-//#region src/registry.ts
-/**
-* WeakMap from every model instance object → its internal metadata.
-* Shared across patch, middleware, and snapshot modules.
-*/
-
-/** 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
+//#region src/types.d.ts
+/** Property key stamped on every ModelDefinition to distinguish it from plain objects. */
+declare const MODEL_BRAND: "__pyreonMod";
+type StateShape = Record<string, unknown>;
 /**
-* 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);
-}
+ * Resolve a state field type:
+ * - ModelDefinition → the instance type it produces
+ * - Anything else → as-is
+ */
+type ResolveField<T> = T extends {
+  readonly __pyreonMod: true;
+  create(initial?: any): infer I;
+} ? I : T;
+/** Map state shape to per-field signals. */
+type StateSignals<TState extends StateShape> = { readonly [K in keyof TState]: Signal<ResolveField<TState[K]>> };
 /**
-* 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. */
-
+ * `self` type inside actions / views:
+ * strongly typed for state signals, `any` for actions and views so that
+ * actions can call each other without circular type issues.
+ */
+type ModelSelf<TState extends StateShape> = StateSignals<TState> & Record<string, any>;
+/** The public instance type returned by `.create()` and hooks. */
+type ModelInstance<TState extends StateShape, TActions extends Record<string, (...args: any[]) => any>, TViews extends Record<string, Signal<any> | Computed<any>>> = StateSignals<TState> & TActions & TViews;
 /**
-* 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()));
+ * Extract the state type from a ModelDefinition.
+ * Used by Snapshot to recursively resolve nested model types.
+ */
+type ExtractModelState<T> = T extends {
+  readonly __pyreonMod: true;
+  readonly _config: {
+    state: infer S extends StateShape;
   };
-  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;
-}
+} ? S : never;
 /**
-* 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);
+ * Snapshot type: plain JS values (no signals, no model instances).
+ * Nested model fields recursively produce their own typed snapshot.
+ */
+type Snapshot<TState extends StateShape> = { [K in keyof TState]: TState[K] extends {
+  readonly __pyreonMod: true;
+} ? Snapshot<ExtractModelState<TState[K]>> : TState[K] };
+interface Patch {
+  op: 'replace';
+  path: string;
+  value: unknown;
 }
-/**
-* 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);
-    }
-  });
+type PatchListener = (patch: Patch) => void;
+interface ActionCall {
+  /** Action name. */
+  name: string;
+  /** Arguments passed to the action. */
+  args: unknown[];
+  /** JSON-pointer-style path, e.g. `"/inc"`. */
+  path: string;
 }
-
+type MiddlewareFn = (call: ActionCall, next: (nextCall: ActionCall) => unknown) => unknown;
 //#endregion
-//#region src/types.ts
-/** Property key stamped on every ModelDefinition to distinguish it from plain objects. */
-
-//#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;
+//#region src/instance.d.ts
+interface ModelConfig<TState extends StateShape, TActions, TViews> {
+  state: TState;
+  views?: (self: any) => TViews;
+  actions?: (self: any) => TActions;
 }
-
 //#endregion
-//#region src/model.ts
-
+//#region src/model.d.ts
 /** Destroy a hook singleton by id so next call re-creates the instance. */
-function resetHook(id) {
-  _hookRegistry.delete(id);
-}
+declare function resetHook(id: string): void;
 /** Destroy all hook singletons. */
-function resetAllHooks() {
-  _hookRegistry.clear();
+declare function resetAllHooks(): void;
+/**
+ * Returned by `model()`. Call `.create()` for instances or `.asHook(id)` for
+ * a Zustand-style singleton hook.
+ */
+declare class ModelDefinition<TState extends StateShape, TActions extends Record<string, (...args: any[]) => any>, TViews extends Record<string, Signal<any> | Computed<any>>> {
+  /** Brand used to identify ModelDefinition objects at runtime (without instanceof). */
+  readonly [MODEL_BRAND]: true;
+  /** @internal — exposed so nested instance creation can read it. */
+  readonly _config: ModelConfig<TState, TActions, TViews>;
+  constructor(config: ModelConfig<TState, TActions, TViews>);
+  /**
+   * Create a new independent model instance.
+   * Pass a partial snapshot to override defaults.
+   *
+   * @example
+   * const counter = Counter.create({ count: 5 })
+   */
+  create(initial?: Partial<Snapshot<TState>>): ModelInstance<TState, TActions, TViews>;
+  /**
+   * 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: string): () => ModelInstance<TState, TActions, TViews>;
 }
 /**
-* Returned by `model()`. Call `.create()` for instances or `.asHook(id)` for
-* a Zustand-style singleton hook.
-*/
-
+ * 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
+ */
+declare function model<TState extends StateShape, TActions extends Record<string, (...args: any[]) => any> = Record<never, never>, TViews extends Record<string, Signal<any> | Computed<any>> = Record<never, never>>(config: ModelConfig<TState, TActions, TViews>): ModelDefinition<TState, TActions, TViews>;
+//#endregion
+//#region src/snapshot.d.ts
 /**
-* 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);
-}
-
+ * 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" }
+ */
+declare function getSnapshot<TState extends StateShape>(instance: object): Snapshot<TState>;
+/**
+ * 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 })
+ */
+declare function applySnapshot<TState extends StateShape>(instance: object, snapshot: Partial<Snapshot<TState>>): void;
 //#endregion
-//#region src/snapshot.ts
+//#region src/patch.d.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;
-}
+ * 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 }
+ * })
+ */
+declare function onPatch(instance: object, listener: PatchListener): () => void;
 /**
-* 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);
-    }
-  });
-}
-
+ * 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 },
+ * ])
+ */
+declare function applyPatch(instance: object, patch: Patch | Patch[]): void;
+//#endregion
+//#region src/middleware.d.ts
+/**
+ * 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
+ * })
+ */
+declare function addMiddleware(instance: object, middleware: MiddlewareFn): () => void;
 //#endregion
-export { addMiddleware, applyPatch, applySnapshot, getSnapshot, model, onPatch, resetAllHooks, resetHook };
-//# sourceMappingURL=index.d.ts.map
+export { type ActionCall, type MiddlewareFn, type ModelDefinition, type ModelInstance, type ModelSelf, type Patch, type PatchListener, type Snapshot, type StateShape, addMiddleware, applyPatch, applySnapshot, getSnapshot, model, onPatch, resetAllHooks, resetHook };
+//# sourceMappingURL=index2.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/registry.ts","../../src/middleware.ts","../../src/patch.ts","../../src/types.ts","../../src/instance.ts","../../src/model.ts","../../src/snapshot.ts"],"mappings":"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"}
+{"version":3,"file":"index2.d.ts","names":[],"sources":["../../../src/types.ts","../../../src/instance.ts","../../../src/model.ts","../../../src/snapshot.ts","../../../src/patch.ts","../../../src/middleware.ts"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyreon/state-tree",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Structured reactive state tree — composable models with snapshots, patches, and middleware",
   "license": "MIT",
   "repository": {
@@ -45,6 +45,6 @@
     "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@pyreon/reactivity": ">=0.5.0 <1.0.0"
+    "@pyreon/reactivity": ">=0.7.0 <0.8.0"
   }
 }

package/lib/types/devtools2.d.ts

@@ -1,40 +0,0 @@
-//#region src/devtools.d.ts
-/**
- * @pyreon/state-tree devtools introspection API.
- * Import: `import { ... } from "@pyreon/state-tree/devtools"`
- */
-/**
- * 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)
- */
-declare function registerInstance(name: string, instance: object): void;
-/**
- * Unregister a model instance.
- */
-declare function unregisterInstance(name: string): void;
-/**
- * Get all registered model instance names.
- * Automatically cleans up garbage-collected instances.
- */
-declare function getActiveModels(): string[];
-/**
- * Get a model instance by name (or undefined if GC'd or not registered).
- */
-declare function getModelInstance(name: string): object | undefined;
-/**
- * Get a snapshot of a registered model instance.
- */
-declare function getModelSnapshot(name: string): Record<string, unknown> | undefined;
-/**
- * Subscribe to model registry changes. Returns unsubscribe function.
- */
-declare function onModelChange(listener: () => void): () => void;
-/** @internal — reset devtools registry (for tests). */
-declare function _resetDevtools(): void;
-//#endregion
-export { _resetDevtools, getActiveModels, getModelInstance, getModelSnapshot, onModelChange, registerInstance, unregisterInstance };
-//# sourceMappingURL=devtools2.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"devtools2.d.ts","names":[],"sources":["../../src/devtools.ts"],"mappings":";;AAuBA;;;;;AAQA;;;;;AASA;iBAjBgB,gBAAA,CAAiB,IAAA,UAAc,QAAA;;;;iBAQ/B,kBAAA,CAAmB,IAAA;;;;;iBASnB,eAAA,CAAA;;;;iBAUA,gBAAA,CAAiB,IAAA;AAyBjC;;;AAAA,iBAXgB,gBAAA,CACd,IAAA,WACC,MAAA;;AAiBH;;iBARgB,aAAA,CAAc,QAAA;;iBAQd,cAAA,CAAA"}

package/lib/types/index2.d.ts

@@ -1,198 +0,0 @@
-import { Computed, Signal } from "@pyreon/reactivity";
-
-//#region src/types.d.ts
-/** Property key stamped on every ModelDefinition to distinguish it from plain objects. */
-declare const MODEL_BRAND: "__pyreonMod";
-type StateShape = Record<string, unknown>;
-/**
- * Resolve a state field type:
- * - ModelDefinition → the instance type it produces
- * - Anything else → as-is
- */
-type ResolveField<T> = T extends {
-  readonly __pyreonMod: true;
-  create(initial?: any): infer I;
-} ? I : T;
-/** Map state shape to per-field signals. */
-type StateSignals<TState extends StateShape> = { readonly [K in keyof TState]: Signal<ResolveField<TState[K]>> };
-/**
- * `self` type inside actions / views:
- * strongly typed for state signals, `any` for actions and views so that
- * actions can call each other without circular type issues.
- */
-type ModelSelf<TState extends StateShape> = StateSignals<TState> & Record<string, any>;
-/** The public instance type returned by `.create()` and hooks. */
-type ModelInstance<TState extends StateShape, TActions extends Record<string, (...args: any[]) => any>, TViews extends Record<string, Signal<any> | Computed<any>>> = StateSignals<TState> & TActions & TViews;
-/**
- * Extract the state type from a ModelDefinition.
- * Used by Snapshot to recursively resolve nested model types.
- */
-type ExtractModelState<T> = T extends {
-  readonly __pyreonMod: true;
-  readonly _config: {
-    state: infer S extends StateShape;
-  };
-} ? S : never;
-/**
- * Snapshot type: plain JS values (no signals, no model instances).
- * Nested model fields recursively produce their own typed snapshot.
- */
-type Snapshot<TState extends StateShape> = { [K in keyof TState]: TState[K] extends {
-  readonly __pyreonMod: true;
-} ? Snapshot<ExtractModelState<TState[K]>> : TState[K] };
-interface Patch {
-  op: 'replace';
-  path: string;
-  value: unknown;
-}
-type PatchListener = (patch: Patch) => void;
-interface ActionCall {
-  /** Action name. */
-  name: string;
-  /** Arguments passed to the action. */
-  args: unknown[];
-  /** JSON-pointer-style path, e.g. `"/inc"`. */
-  path: string;
-}
-type MiddlewareFn = (call: ActionCall, next: (nextCall: ActionCall) => unknown) => unknown;
-//#endregion
-//#region src/instance.d.ts
-interface ModelConfig<TState extends StateShape, TActions, TViews> {
-  state: TState;
-  views?: (self: any) => TViews;
-  actions?: (self: any) => TActions;
-}
-//#endregion
-//#region src/model.d.ts
-/** Destroy a hook singleton by id so next call re-creates the instance. */
-declare function resetHook(id: string): void;
-/** Destroy all hook singletons. */
-declare function resetAllHooks(): void;
-/**
- * Returned by `model()`. Call `.create()` for instances or `.asHook(id)` for
- * a Zustand-style singleton hook.
- */
-declare class ModelDefinition<TState extends StateShape, TActions extends Record<string, (...args: any[]) => any>, TViews extends Record<string, Signal<any> | Computed<any>>> {
-  /** Brand used to identify ModelDefinition objects at runtime (without instanceof). */
-  readonly [MODEL_BRAND]: true;
-  /** @internal — exposed so nested instance creation can read it. */
-  readonly _config: ModelConfig<TState, TActions, TViews>;
-  constructor(config: ModelConfig<TState, TActions, TViews>);
-  /**
-   * Create a new independent model instance.
-   * Pass a partial snapshot to override defaults.
-   *
-   * @example
-   * const counter = Counter.create({ count: 5 })
-   */
-  create(initial?: Partial<Snapshot<TState>>): ModelInstance<TState, TActions, TViews>;
-  /**
-   * 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: string): () => ModelInstance<TState, TActions, TViews>;
-}
-/**
- * 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
- */
-declare function model<TState extends StateShape, TActions extends Record<string, (...args: any[]) => any> = Record<never, never>, TViews extends Record<string, Signal<any> | Computed<any>> = Record<never, never>>(config: ModelConfig<TState, TActions, TViews>): ModelDefinition<TState, TActions, TViews>;
-//#endregion
-//#region src/snapshot.d.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" }
- */
-declare function getSnapshot<TState extends StateShape>(instance: object): Snapshot<TState>;
-/**
- * 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 })
- */
-declare function applySnapshot<TState extends StateShape>(instance: object, snapshot: Partial<Snapshot<TState>>): void;
-//#endregion
-//#region src/patch.d.ts
-/**
- * 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 }
- * })
- */
-declare function onPatch(instance: object, listener: PatchListener): () => void;
-/**
- * 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 },
- * ])
- */
-declare function applyPatch(instance: object, patch: Patch | Patch[]): void;
-//#endregion
-//#region src/middleware.d.ts
-/**
- * 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
- * })
- */
-declare function addMiddleware(instance: object, middleware: MiddlewareFn): () => void;
-//#endregion
-export { type ActionCall, type MiddlewareFn, type ModelDefinition, type ModelInstance, type ModelSelf, type Patch, type PatchListener, type Snapshot, type StateShape, addMiddleware, applyPatch, applySnapshot, getSnapshot, model, onPatch, resetAllHooks, resetHook };
-//# sourceMappingURL=index2.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index2.d.ts","names":[],"sources":["../../src/types.ts","../../src/instance.ts","../../src/model.ts","../../src/snapshot.ts","../../src/patch.ts","../../src/middleware.ts"],"mappings":"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"}