@pyreon/state-tree 0.22.0 → 0.23.0

package/README.md

@@ -1,11 +1,13 @@
 # @pyreon/state-tree
 
-Structured reactive state trees with signal-backed models, computed views, actions, snapshots, JSON patches, and middleware.
+MobX-State-Tree-inspired structured models on signals — `model({ state, views, actions })`.
+
+Structured reactive state trees built on `@pyreon/reactivity`: `model({ state, views, actions })` composes signal-backed state, computed views, and the only legal mutation path (actions). Supports nested model composition, typed snapshots, JSON-patch record/replay (replace only), and action interception middleware. Fits when `@pyreon/store` is too flat — use it for tree-shaped domain models with undo/redo, time-travel, or audit-log requirements.
 
 ## Install
 
 ```bash
-bun add @pyreon/state-tree
+bun add @pyreon/state-tree @pyreon/reactivity
 ```
 
 ## Quick Start
@@ -247,3 +249,19 @@ applyPatch(counter, history) // replays to count: 2
 - `applySnapshot` leaves missing keys unchanged; it does not delete extra state.
 - `self` inside actions/views is loosely typed for non-state keys to prevent circular type resolution. Use explicit types if needed.
 - Always call `resetAllHooks()` in test `afterEach` to prevent singleton leakage between tests.
+
+## Devtools
+
+```ts
+import { stateTreeRegistry } from '@pyreon/state-tree/devtools'
+```
+
+WeakRef-based registry of live model instances — tree-shakeable. Used by the Pyreon devtools panel.
+
+## Documentation
+
+Full docs: [docs.pyreon.dev/docs/state-tree](https://docs.pyreon.dev/docs/state-tree) (or `docs/docs/state-tree.md` in this repo).
+
+## License
+
+MIT

package/lib/_chunks/snapshot-dNsO8P8p.js

@@ -0,0 +1,62 @@
+import { batch } 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/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 { isModelInstance as i, getSnapshot as n, instanceMeta as r, applySnapshot as t };
+//# sourceMappingURL=snapshot-dNsO8P8p.js.map

package/lib/analysis/index.js.html

@@ -5386,7 +5386,7 @@ var drawChart = (function (exports) {
   </script>
   <script>
     /*<!--*/
-    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"src","children":[{"uid":"02da3037-1","name":"registry.ts"},{"uid":"02da3037-3","name":"middleware.ts"},{"uid":"02da3037-5","name":"patch.ts"},{"uid":"02da3037-7","name":"types.ts"},{"uid":"02da3037-9","name":"instance.ts"},{"uid":"02da3037-11","name":"model.ts"},{"uid":"02da3037-13","name":"snapshot.ts"},{"uid":"02da3037-15","name":"index.ts"}]}]}],"isRoot":true},"nodeParts":{"02da3037-1":{"renderedLength":420,"gzipLength":292,"brotliLength":0,"metaUid":"02da3037-0"},"02da3037-3":{"renderedLength":1291,"gzipLength":627,"brotliLength":0,"metaUid":"02da3037-2"},"02da3037-5":{"renderedLength":4252,"gzipLength":1554,"brotliLength":0,"metaUid":"02da3037-4"},"02da3037-7":{"renderedLength":162,"gzipLength":155,"brotliLength":0,"metaUid":"02da3037-6"},"02da3037-9":{"renderedLength":1691,"gzipLength":758,"brotliLength":0,"metaUid":"02da3037-8"},"02da3037-11":{"renderedLength":2187,"gzipLength":1001,"brotliLength":0,"metaUid":"02da3037-10"},"02da3037-13":{"renderedLength":1396,"gzipLength":602,"brotliLength":0,"metaUid":"02da3037-12"},"02da3037-15":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"02da3037-14"}},"nodeMetas":{"02da3037-0":{"id":"/src/registry.ts","moduleParts":{"index.js":"02da3037-1"},"imported":[],"importedBy":[{"uid":"02da3037-12"},{"uid":"02da3037-4"},{"uid":"02da3037-2"},{"uid":"02da3037-8"}]},"02da3037-2":{"id":"/src/middleware.ts","moduleParts":{"index.js":"02da3037-3"},"imported":[{"uid":"02da3037-0"}],"importedBy":[{"uid":"02da3037-14"},{"uid":"02da3037-8"}]},"02da3037-4":{"id":"/src/patch.ts","moduleParts":{"index.js":"02da3037-5"},"imported":[{"uid":"02da3037-16"},{"uid":"02da3037-0"}],"importedBy":[{"uid":"02da3037-14"},{"uid":"02da3037-8"}]},"02da3037-6":{"id":"/src/types.ts","moduleParts":{"index.js":"02da3037-7"},"imported":[],"importedBy":[{"uid":"02da3037-10"},{"uid":"02da3037-8"}]},"02da3037-8":{"id":"/src/instance.ts","moduleParts":{"index.js":"02da3037-9"},"imported":[{"uid":"02da3037-16"},{"uid":"02da3037-2"},{"uid":"02da3037-4"},{"uid":"02da3037-0"},{"uid":"02da3037-6"}],"importedBy":[{"uid":"02da3037-10"}]},"02da3037-10":{"id":"/src/model.ts","moduleParts":{"index.js":"02da3037-11"},"imported":[{"uid":"02da3037-8"},{"uid":"02da3037-6"}],"importedBy":[{"uid":"02da3037-14"}]},"02da3037-12":{"id":"/src/snapshot.ts","moduleParts":{"index.js":"02da3037-13"},"imported":[{"uid":"02da3037-16"},{"uid":"02da3037-0"}],"importedBy":[{"uid":"02da3037-14"}]},"02da3037-14":{"id":"/src/index.ts","moduleParts":{"index.js":"02da3037-15"},"imported":[{"uid":"02da3037-10"},{"uid":"02da3037-12"},{"uid":"02da3037-4"},{"uid":"02da3037-2"}],"importedBy":[],"isEntry":true},"02da3037-16":{"id":"@pyreon/reactivity","moduleParts":{},"imported":[],"importedBy":[{"uid":"02da3037-12"},{"uid":"02da3037-4"},{"uid":"02da3037-8"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
+    const data = {"version":2,"tree":{"name":"root","children":[{"name":"devtools.js","children":[{"name":"src/devtools.ts","uid":"33598a70-1"}]},{"name":"index.js","children":[{"name":"src","children":[{"uid":"33598a70-3","name":"middleware.ts"},{"uid":"33598a70-5","name":"patch.ts"},{"uid":"33598a70-7","name":"types.ts"},{"uid":"33598a70-9","name":"instance.ts"},{"uid":"33598a70-11","name":"model.ts"},{"uid":"33598a70-13","name":"index.ts"}]}]},{"name":"_chunks/snapshot-dNsO8P8p.js","children":[{"name":"src","children":[{"uid":"33598a70-15","name":"registry.ts"},{"uid":"33598a70-17","name":"snapshot.ts"}]}]}],"isRoot":true},"nodeParts":{"33598a70-1":{"renderedLength":1843,"gzipLength":729,"brotliLength":0,"metaUid":"33598a70-0"},"33598a70-3":{"renderedLength":1291,"gzipLength":627,"brotliLength":0,"metaUid":"33598a70-2"},"33598a70-5":{"renderedLength":4252,"gzipLength":1554,"brotliLength":0,"metaUid":"33598a70-4"},"33598a70-7":{"renderedLength":162,"gzipLength":155,"brotliLength":0,"metaUid":"33598a70-6"},"33598a70-9":{"renderedLength":1691,"gzipLength":758,"brotliLength":0,"metaUid":"33598a70-8"},"33598a70-11":{"renderedLength":2187,"gzipLength":1001,"brotliLength":0,"metaUid":"33598a70-10"},"33598a70-13":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"33598a70-12"},"33598a70-15":{"renderedLength":420,"gzipLength":292,"brotliLength":0,"metaUid":"33598a70-14"},"33598a70-17":{"renderedLength":1396,"gzipLength":602,"brotliLength":0,"metaUid":"33598a70-16"}},"nodeMetas":{"33598a70-0":{"id":"/src/devtools.ts","moduleParts":{"devtools.js":"33598a70-1"},"imported":[{"uid":"33598a70-16"}],"importedBy":[],"isEntry":true},"33598a70-2":{"id":"/src/middleware.ts","moduleParts":{"index.js":"33598a70-3"},"imported":[{"uid":"33598a70-14"}],"importedBy":[{"uid":"33598a70-12"},{"uid":"33598a70-8"}]},"33598a70-4":{"id":"/src/patch.ts","moduleParts":{"index.js":"33598a70-5"},"imported":[{"uid":"33598a70-18"},{"uid":"33598a70-14"}],"importedBy":[{"uid":"33598a70-12"},{"uid":"33598a70-8"}]},"33598a70-6":{"id":"/src/types.ts","moduleParts":{"index.js":"33598a70-7"},"imported":[],"importedBy":[{"uid":"33598a70-10"},{"uid":"33598a70-8"}]},"33598a70-8":{"id":"/src/instance.ts","moduleParts":{"index.js":"33598a70-9"},"imported":[{"uid":"33598a70-18"},{"uid":"33598a70-2"},{"uid":"33598a70-4"},{"uid":"33598a70-14"},{"uid":"33598a70-6"}],"importedBy":[{"uid":"33598a70-10"}]},"33598a70-10":{"id":"/src/model.ts","moduleParts":{"index.js":"33598a70-11"},"imported":[{"uid":"33598a70-8"},{"uid":"33598a70-6"}],"importedBy":[{"uid":"33598a70-12"}]},"33598a70-12":{"id":"/src/index.ts","moduleParts":{"index.js":"33598a70-13"},"imported":[{"uid":"33598a70-10"},{"uid":"33598a70-16"},{"uid":"33598a70-4"},{"uid":"33598a70-2"}],"importedBy":[],"isEntry":true},"33598a70-14":{"id":"/src/registry.ts","moduleParts":{"_chunks/snapshot-dNsO8P8p.js":"33598a70-15"},"imported":[],"importedBy":[{"uid":"33598a70-16"},{"uid":"33598a70-4"},{"uid":"33598a70-2"},{"uid":"33598a70-8"}]},"33598a70-16":{"id":"/src/snapshot.ts","moduleParts":{"_chunks/snapshot-dNsO8P8p.js":"33598a70-17"},"imported":[{"uid":"33598a70-18"},{"uid":"33598a70-14"}],"importedBy":[{"uid":"33598a70-0"},{"uid":"33598a70-12"}]},"33598a70-18":{"id":"@pyreon/reactivity","moduleParts":{},"imported":[],"importedBy":[{"uid":"33598a70-16"},{"uid":"33598a70-4"},{"uid":"33598a70-8"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
 
     const run = () => {
       const width = window.innerWidth;

package/lib/devtools.js

@@ -1,38 +1,5 @@
-//#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;
-}
+import { n as getSnapshot } from "./_chunks/snapshot-dNsO8P8p.js";
 
-//#endregion
 //#region src/devtools.ts
 /**
 * @pyreon/state-tree devtools introspection API.

package/lib/index.js

@@ -1,17 +1,6 @@
+import { i as isModelInstance, n as getSnapshot, r as instanceMeta, t as applySnapshot } from "./_chunks/snapshot-dNsO8P8p.js";
 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`.
@@ -302,52 +291,6 @@ 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyreon/state-tree",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "Structured reactive state tree — composable models with snapshots, patches, and middleware",
   "homepage": "https://github.com/pyreon/pyreon/tree/main/packages/state-tree#readme",
   "bugs": {
@@ -49,10 +49,10 @@
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.8.9",
     "@pyreon/manifest": "0.13.1",
-    "@pyreon/reactivity": "^0.22.0",
+    "@pyreon/reactivity": "^0.23.0",
     "bun-types": "^1.3.12"
   },
   "dependencies": {
-    "@pyreon/reactivity": "^0.22.0"
+    "@pyreon/reactivity": "^0.23.0"
   }
 }