@pyreon/state-tree 0.0.1

package/lib/types/devtools2.d.ts

@@ -0,0 +1,40 @@
+//#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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,316 @@
+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.
+*/
+
+/** 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. */
+
+/**
+* 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. */
+
+//#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
+
+/** 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.
+*/
+
+/**
+* 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.d.ts.map

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

@@ -0,0 +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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"}

package/lib/types/index2.d.ts

@@ -0,0 +1,198 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,54 @@
+{
+  "name": "@pyreon/state-tree",
+  "version": "0.0.1",
+  "description": "Structured reactive state tree — composable models with snapshots, patches, and middleware",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pyreon/fundamentals.git",
+    "directory": "packages/state-tree"
+  },
+  "homepage": "https://github.com/pyreon/fundamentals/tree/main/packages/state-tree#readme",
+  "bugs": {
+    "url": "https://github.com/pyreon/fundamentals/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "lib",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "main": "./lib/index.js",
+  "module": "./lib/index.js",
+  "types": "./lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": "./lib/index.js",
+      "types": "./lib/types/index.d.ts"
+    },
+    "./devtools": {
+      "bun": "./src/devtools.ts",
+      "import": "./lib/devtools.js",
+      "types": "./lib/types/devtools.d.ts"
+    }
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "vl_rolldown_build",
+    "dev": "vl_rolldown_build-watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@pyreon/reactivity": "^0.2.1"
+  },
+  "devDependencies": {
+    "@happy-dom/global-registrator": "^20.8.3",
+    "@pyreon/reactivity": "^0.2.1"
+  }
+}