@pyreon/state-tree 0.10.0 → 0.11.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/lib/devtools.js.map +1 -1
- package/lib/index.js.map +1 -1
- package/lib/types/devtools.d.ts.map +1 -1
- package/lib/types/index.d.ts +1 -1
- package/lib/types/index.d.ts.map +1 -1
- package/package.json +11 -6
- package/src/devtools.ts +2 -4
- package/src/index.ts +6 -6
- package/src/instance.ts +11 -17
- package/src/middleware.ts +4 -8
- package/src/model.ts +8 -18
- package/src/patch.ts +22 -39
- package/src/registry.ts +2 -6
- package/src/snapshot.ts +7 -11
- package/src/tests/devtools.test.ts +43 -43
- package/src/tests/edge-cases.test.ts +715 -0
- package/src/tests/model.test.ts +161 -167
- package/src/types.ts +5 -9
package/lib/devtools.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"devtools.js","names":[],"sources":["../src/registry.ts","../src/snapshot.ts","../src/devtools.ts"],"sourcesContent":["import type { InstanceMeta } from
|
|
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 value != null && typeof value === \"object\" && instanceMeta.has(value as object)\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>(instance: object): Snapshot<TState> {\n const meta = instanceMeta.get(instance)\n if (!meta) 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) 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(name: string): 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,QAAO,SAAS,QAAQ,OAAO,UAAU,YAAY,aAAa,IAAI,MAAgB;;;;;;;;;;;;;ACKxF,SAAgB,YAAuC,UAAoC;CACzF,MAAM,OAAO,aAAa,IAAI,SAAS;AACvC,KAAI,CAAC,KAAM,OAAM,IAAI,MAAM,yDAAyD;CAEpF,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;;;;;;;;;AClBT,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,iBAAiB,MAAmD;CAClF,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.map
CHANGED
|
@@ -1 +1 @@
|
|
|
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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"}
|
|
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 value != null && typeof value === \"object\" && instanceMeta.has(value as object)\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(instance: object, middleware: MiddlewareFn): () => void {\n const meta = instanceMeta.get(instance)\n if (!meta) 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) => 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) ? snapshotValue(newValue as object) : 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) 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(`[@pyreon/state-tree] applyPatch: unsupported op \"${p.op}\"`)\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(`[@pyreon/state-tree] applyPatch: reserved property name \"${segment}\"`)\n }\n const meta = instanceMeta.get(target)\n if (!meta)\n throw new Error(`[@pyreon/state-tree] applyPatch: not a model instance at \"${segment}\"`)\n const sig = (target as Record<string, Signal<unknown>>)[segment]\n if (!sig || typeof sig.peek !== \"function\") {\n throw new Error(`[@pyreon/state-tree] applyPatch: unknown state key \"${segment}\"`)\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(`[@pyreon/state-tree] applyPatch: reserved property name \"${lastKey}\"`)\n }\n const meta = instanceMeta.get(target)\n if (!meta) throw new Error(\"[@pyreon/state-tree] applyPatch: not a model instance\")\n if (!meta.stateKeys.includes(lastKey)) {\n throw new Error(`[@pyreon/state-tree] applyPatch: unknown state key \"${lastKey}\"`)\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> & 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 = (call: ActionCall, next: (nextCall: ActionCall) => unknown) => 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(views as Record<string, unknown>)) {\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<string, (...args: unknown[]) => unknown>\n for (const [key, actionFn] of Object.entries(rawActions)) {\n instance[key] = (...args: unknown[]) => 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(initial?: Partial<Snapshot<TState>>): 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<never, never>,\n TViews extends Record<string, Signal<any> | Computed<any>> = Record<never, never>,\n>(config: ModelConfig<TState, TActions, TViews>): 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>(instance: object): Snapshot<TState> {\n const meta = instanceMeta.get(instance)\n if (!meta) 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) 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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"}
|
|
@@ -1 +1 @@
|
|
|
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;
|
|
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;AAuBjC;;;AAAA,iBATgB,gBAAA,CAAiB,IAAA,WAAe,MAAA;;AAiBhD;;iBARgB,aAAA,CAAc,QAAA;;iBAQd,cAAA,CAAA"}
|
package/lib/types/index.d.ts
CHANGED
|
@@ -41,7 +41,7 @@ type Snapshot<TState extends StateShape> = { [K in keyof TState]: TState[K] exte
|
|
|
41
41
|
readonly __pyreonMod: true;
|
|
42
42
|
} ? Snapshot<ExtractModelState<TState[K]>> : TState[K] };
|
|
43
43
|
interface Patch {
|
|
44
|
-
op:
|
|
44
|
+
op: "replace";
|
|
45
45
|
path: string;
|
|
46
46
|
value: unknown;
|
|
47
47
|
}
|
package/lib/types/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
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":";;;;cAKa,WAAA;AAAA,KAID,UAAA,GAAa,MAAA;;;;;AAAzB;KAOY,YAAA,MAAkB,CAAA;EAAA,SACnB,WAAA;EACT,MAAA,CAAO,OAAA;AAAA,IAEL,CAAA,GACA,CAAA;AALJ;AAAA,KAQY,YAAA,gBAA4B,UAAA,2BACjB,MAAA,GAAS,MAAA,CAAO,YAAA,CAAa,MAAA,CAAO,CAAA;;;;;;KAQ/C,SAAA,gBAAyB,UAAA,IAAc,YAAA,CAAa,MAAA,
|
|
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
CHANGED
|
@@ -1,16 +1,16 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@pyreon/state-tree",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.11.1",
|
|
4
4
|
"description": "Structured reactive state tree — composable models with snapshots, patches, and middleware",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
7
7
|
"type": "git",
|
|
8
|
-
"url": "https://github.com/pyreon/
|
|
9
|
-
"directory": "packages/state-tree"
|
|
8
|
+
"url": "https://github.com/pyreon/pyreon.git",
|
|
9
|
+
"directory": "packages/fundamentals/state-tree"
|
|
10
10
|
},
|
|
11
11
|
"homepage": "https://github.com/pyreon/fundamentals/tree/main/packages/state-tree#readme",
|
|
12
12
|
"bugs": {
|
|
13
|
-
"url": "https://github.com/pyreon/
|
|
13
|
+
"url": "https://github.com/pyreon/pyreon/issues"
|
|
14
14
|
},
|
|
15
15
|
"publishConfig": {
|
|
16
16
|
"access": "public"
|
|
@@ -42,9 +42,14 @@
|
|
|
42
42
|
"build": "vl_rolldown_build",
|
|
43
43
|
"dev": "vl_rolldown_build-watch",
|
|
44
44
|
"test": "vitest run",
|
|
45
|
-
"typecheck": "tsc --noEmit"
|
|
45
|
+
"typecheck": "tsc --noEmit",
|
|
46
|
+
"lint": "biome check ."
|
|
46
47
|
},
|
|
47
48
|
"peerDependencies": {
|
|
48
|
-
"@pyreon/reactivity": "
|
|
49
|
+
"@pyreon/reactivity": "^0.11.1"
|
|
50
|
+
},
|
|
51
|
+
"devDependencies": {
|
|
52
|
+
"@happy-dom/global-registrator": "^20.8.3",
|
|
53
|
+
"@pyreon/reactivity": "^0.11.1"
|
|
49
54
|
}
|
|
50
55
|
}
|
package/src/devtools.ts
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
* Import: `import { ... } from "@pyreon/state-tree/devtools"`
|
|
4
4
|
*/
|
|
5
5
|
|
|
6
|
-
import { getSnapshot } from
|
|
6
|
+
import { getSnapshot } from "./snapshot"
|
|
7
7
|
|
|
8
8
|
// Track active model instances (devtools-only, opt-in)
|
|
9
9
|
const _activeModels = new Map<string, WeakRef<object>>()
|
|
@@ -62,9 +62,7 @@ export function getModelInstance(name: string): object | undefined {
|
|
|
62
62
|
/**
|
|
63
63
|
* Get a snapshot of a registered model instance.
|
|
64
64
|
*/
|
|
65
|
-
export function getModelSnapshot(
|
|
66
|
-
name: string,
|
|
67
|
-
): Record<string, unknown> | undefined {
|
|
65
|
+
export function getModelSnapshot(name: string): Record<string, unknown> | undefined {
|
|
68
66
|
const instance = getModelInstance(name)
|
|
69
67
|
if (!instance) return undefined
|
|
70
68
|
return getSnapshot(instance)
|
package/src/index.ts
CHANGED
|
@@ -1,19 +1,19 @@
|
|
|
1
1
|
// ─── Core ─────────────────────────────────────────────────────────────────────
|
|
2
2
|
|
|
3
|
-
export type { ModelDefinition } from
|
|
4
|
-
export { model, resetAllHooks, resetHook } from
|
|
3
|
+
export type { ModelDefinition } from "./model"
|
|
4
|
+
export { model, resetAllHooks, resetHook } from "./model"
|
|
5
5
|
|
|
6
6
|
// ─── Snapshot ─────────────────────────────────────────────────────────────────
|
|
7
7
|
|
|
8
|
-
export { applySnapshot, getSnapshot } from
|
|
8
|
+
export { applySnapshot, getSnapshot } from "./snapshot"
|
|
9
9
|
|
|
10
10
|
// ─── Patches ─────────────────────────────────────────────────────────────────
|
|
11
11
|
|
|
12
|
-
export { applyPatch, onPatch } from
|
|
12
|
+
export { applyPatch, onPatch } from "./patch"
|
|
13
13
|
|
|
14
14
|
// ─── Middleware ───────────────────────────────────────────────────────────────
|
|
15
15
|
|
|
16
|
-
export { addMiddleware } from
|
|
16
|
+
export { addMiddleware } from "./middleware"
|
|
17
17
|
|
|
18
18
|
// ─── Types ────────────────────────────────────────────────────────────────────
|
|
19
19
|
|
|
@@ -26,4 +26,4 @@ export type {
|
|
|
26
26
|
PatchListener,
|
|
27
27
|
Snapshot,
|
|
28
28
|
StateShape,
|
|
29
|
-
} from
|
|
29
|
+
} from "./types"
|
package/src/instance.ts
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
|
-
import type { Computed, Signal } from
|
|
2
|
-
import { signal } from
|
|
3
|
-
import { runAction } from
|
|
4
|
-
import { onPatch, trackedSignal } from
|
|
5
|
-
import { instanceMeta } from
|
|
6
|
-
import type { InstanceMeta, ModelInstance, Snapshot, StateShape } from
|
|
7
|
-
import { MODEL_BRAND } from
|
|
1
|
+
import type { Computed, Signal } from "@pyreon/reactivity"
|
|
2
|
+
import { signal } from "@pyreon/reactivity"
|
|
3
|
+
import { runAction } from "./middleware"
|
|
4
|
+
import { onPatch, trackedSignal } from "./patch"
|
|
5
|
+
import { instanceMeta } from "./registry"
|
|
6
|
+
import type { InstanceMeta, ModelInstance, Snapshot, StateShape } from "./types"
|
|
7
|
+
import { MODEL_BRAND } from "./types"
|
|
8
8
|
|
|
9
9
|
// ─── Model definition detection ───────────────────────────────────────────────
|
|
10
10
|
|
|
@@ -18,7 +18,7 @@ interface AnyModelDef {
|
|
|
18
18
|
}
|
|
19
19
|
|
|
20
20
|
function isModelDef(v: unknown): v is AnyModelDef {
|
|
21
|
-
if (v == null || typeof v !==
|
|
21
|
+
if (v == null || typeof v !== "object") return false
|
|
22
22
|
return (v as Record<string, unknown>)[MODEL_BRAND] === true
|
|
23
23
|
}
|
|
24
24
|
|
|
@@ -105,22 +105,16 @@ export function createInstance<
|
|
|
105
105
|
// ── 2. Views ──────────────────────────────────────────────────────────────
|
|
106
106
|
if (config.views) {
|
|
107
107
|
const views = config.views(self)
|
|
108
|
-
for (const [key, view] of Object.entries(
|
|
109
|
-
views as Record<string, unknown>,
|
|
110
|
-
)) {
|
|
108
|
+
for (const [key, view] of Object.entries(views as Record<string, unknown>)) {
|
|
111
109
|
instance[key] = view
|
|
112
110
|
}
|
|
113
111
|
}
|
|
114
112
|
|
|
115
113
|
// ── 3. Actions (wrapped with middleware runner) ───────────────────────────
|
|
116
114
|
if (config.actions) {
|
|
117
|
-
const rawActions = config.actions(self) as Record<
|
|
118
|
-
string,
|
|
119
|
-
(...args: unknown[]) => unknown
|
|
120
|
-
>
|
|
115
|
+
const rawActions = config.actions(self) as Record<string, (...args: unknown[]) => unknown>
|
|
121
116
|
for (const [key, actionFn] of Object.entries(rawActions)) {
|
|
122
|
-
instance[key] = (...args: unknown[]) =>
|
|
123
|
-
runAction(meta, key, actionFn, args)
|
|
117
|
+
instance[key] = (...args: unknown[]) => runAction(meta, key, actionFn, args)
|
|
124
118
|
}
|
|
125
119
|
}
|
|
126
120
|
|
package/src/middleware.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { instanceMeta } from
|
|
2
|
-
import type { ActionCall, InstanceMeta, MiddlewareFn } from
|
|
1
|
+
import { instanceMeta } from "./registry"
|
|
2
|
+
import type { ActionCall, InstanceMeta, MiddlewareFn } from "./types"
|
|
3
3
|
|
|
4
4
|
// ─── Action runner ────────────────────────────────────────────────────────────
|
|
5
5
|
|
|
@@ -42,13 +42,9 @@ export function runAction(
|
|
|
42
42
|
* return result
|
|
43
43
|
* })
|
|
44
44
|
*/
|
|
45
|
-
export function addMiddleware(
|
|
46
|
-
instance: object,
|
|
47
|
-
middleware: MiddlewareFn,
|
|
48
|
-
): () => void {
|
|
45
|
+
export function addMiddleware(instance: object, middleware: MiddlewareFn): () => void {
|
|
49
46
|
const meta = instanceMeta.get(instance)
|
|
50
|
-
if (!meta)
|
|
51
|
-
throw new Error('[@pyreon/state-tree] addMiddleware: not a model instance')
|
|
47
|
+
if (!meta) throw new Error("[@pyreon/state-tree] addMiddleware: not a model instance")
|
|
52
48
|
meta.middlewares.push(middleware)
|
|
53
49
|
return () => {
|
|
54
50
|
const idx = meta.middlewares.indexOf(middleware)
|
package/src/model.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import type { Computed, Signal } from
|
|
2
|
-
import { createInstance, type ModelConfig } from
|
|
3
|
-
import type { ModelInstance, Snapshot, StateShape } from
|
|
4
|
-
import { MODEL_BRAND } from
|
|
1
|
+
import type { Computed, Signal } from "@pyreon/reactivity"
|
|
2
|
+
import { createInstance, type ModelConfig } from "./instance"
|
|
3
|
+
import type { ModelInstance, Snapshot, StateShape } from "./types"
|
|
4
|
+
import { MODEL_BRAND } from "./types"
|
|
5
5
|
|
|
6
6
|
// ─── Hook registry ────────────────────────────────────────────────────────────
|
|
7
7
|
|
|
@@ -47,9 +47,7 @@ export class ModelDefinition<
|
|
|
47
47
|
* @example
|
|
48
48
|
* const counter = Counter.create({ count: 5 })
|
|
49
49
|
*/
|
|
50
|
-
create(
|
|
51
|
-
initial?: Partial<Snapshot<TState>>,
|
|
52
|
-
): ModelInstance<TState, TActions, TViews> {
|
|
50
|
+
create(initial?: Partial<Snapshot<TState>>): ModelInstance<TState, TActions, TViews> {
|
|
53
51
|
return createInstance(this._config, initial ?? {})
|
|
54
52
|
}
|
|
55
53
|
|
|
@@ -102,16 +100,8 @@ export class ModelDefinition<
|
|
|
102
100
|
*/
|
|
103
101
|
export function model<
|
|
104
102
|
TState extends StateShape,
|
|
105
|
-
TActions extends Record<string, (...args: any[]) => any> = Record<
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
>,
|
|
109
|
-
TViews extends Record<string, Signal<any> | Computed<any>> = Record<
|
|
110
|
-
never,
|
|
111
|
-
never
|
|
112
|
-
>,
|
|
113
|
-
>(
|
|
114
|
-
config: ModelConfig<TState, TActions, TViews>,
|
|
115
|
-
): ModelDefinition<TState, TActions, TViews> {
|
|
103
|
+
TActions extends Record<string, (...args: any[]) => any> = Record<never, never>,
|
|
104
|
+
TViews extends Record<string, Signal<any> | Computed<any>> = Record<never, never>,
|
|
105
|
+
>(config: ModelConfig<TState, TActions, TViews>): ModelDefinition<TState, TActions, TViews> {
|
|
116
106
|
return new ModelDefinition(config)
|
|
117
107
|
}
|
package/src/patch.ts
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
|
-
import type { Signal } from
|
|
2
|
-
import { batch } from
|
|
3
|
-
import { instanceMeta, isModelInstance } from
|
|
4
|
-
import type { Patch, PatchListener } from
|
|
1
|
+
import type { Signal } from "@pyreon/reactivity"
|
|
2
|
+
import { batch } from "@pyreon/reactivity"
|
|
3
|
+
import { instanceMeta, isModelInstance } from "./registry"
|
|
4
|
+
import type { Patch, PatchListener } from "./types"
|
|
5
5
|
|
|
6
6
|
/** Property names that must never be used as patch path segments. */
|
|
7
|
-
const RESERVED_KEYS = new Set([
|
|
7
|
+
const RESERVED_KEYS = new Set(["__proto__", "constructor", "prototype"])
|
|
8
8
|
|
|
9
9
|
// ─── Tracked signal ───────────────────────────────────────────────────────────
|
|
10
10
|
|
|
@@ -25,8 +25,7 @@ export function trackedSignal<T>(
|
|
|
25
25
|
|
|
26
26
|
read.peek = (): T => inner.peek()
|
|
27
27
|
|
|
28
|
-
read.subscribe = (listener: () => void): (() => void) =>
|
|
29
|
-
inner.subscribe(listener)
|
|
28
|
+
read.subscribe = (listener: () => void): (() => void) => inner.subscribe(listener)
|
|
30
29
|
|
|
31
30
|
read.set = (newValue: T): void => {
|
|
32
31
|
const prev = inner.peek()
|
|
@@ -36,10 +35,8 @@ export function trackedSignal<T>(
|
|
|
36
35
|
if (!Object.is(prev, newValue) && (!hasListeners || hasListeners())) {
|
|
37
36
|
// For model instances, emit the snapshot rather than the live object
|
|
38
37
|
// so patches are always plain JSON-serializable values.
|
|
39
|
-
const patchValue = isModelInstance(newValue)
|
|
40
|
-
|
|
41
|
-
: newValue
|
|
42
|
-
emitPatch({ op: 'replace', path, value: patchValue })
|
|
38
|
+
const patchValue = isModelInstance(newValue) ? snapshotValue(newValue as object) : newValue
|
|
39
|
+
emitPatch({ op: "replace", path, value: patchValue })
|
|
43
40
|
}
|
|
44
41
|
}
|
|
45
42
|
|
|
@@ -79,8 +76,7 @@ function snapshotValue(instance: object): Record<string, unknown> {
|
|
|
79
76
|
*/
|
|
80
77
|
export function onPatch(instance: object, listener: PatchListener): () => void {
|
|
81
78
|
const meta = instanceMeta.get(instance)
|
|
82
|
-
if (!meta)
|
|
83
|
-
throw new Error('[@pyreon/state-tree] onPatch: not a model instance')
|
|
79
|
+
if (!meta) throw new Error("[@pyreon/state-tree] onPatch: not a model instance")
|
|
84
80
|
meta.patchListeners.add(listener)
|
|
85
81
|
return () => meta.patchListeners.delete(listener)
|
|
86
82
|
}
|
|
@@ -109,15 +105,13 @@ export function applyPatch(instance: object, patch: Patch | Patch[]): void {
|
|
|
109
105
|
|
|
110
106
|
batch(() => {
|
|
111
107
|
for (const p of patches) {
|
|
112
|
-
if (p.op !==
|
|
113
|
-
throw new Error(
|
|
114
|
-
`[@pyreon/state-tree] applyPatch: unsupported op "${p.op}"`,
|
|
115
|
-
)
|
|
108
|
+
if (p.op !== "replace") {
|
|
109
|
+
throw new Error(`[@pyreon/state-tree] applyPatch: unsupported op "${p.op}"`)
|
|
116
110
|
}
|
|
117
111
|
|
|
118
|
-
const segments = p.path.split(
|
|
112
|
+
const segments = p.path.split("/").filter(Boolean)
|
|
119
113
|
if (segments.length === 0) {
|
|
120
|
-
throw new Error(
|
|
114
|
+
throw new Error("[@pyreon/state-tree] applyPatch: empty path")
|
|
121
115
|
}
|
|
122
116
|
|
|
123
117
|
// Walk to the target instance for nested paths
|
|
@@ -125,23 +119,17 @@ export function applyPatch(instance: object, patch: Patch | Patch[]): void {
|
|
|
125
119
|
for (let i = 0; i < segments.length - 1; i++) {
|
|
126
120
|
const segment = segments[i]!
|
|
127
121
|
if (RESERVED_KEYS.has(segment)) {
|
|
128
|
-
throw new Error(
|
|
129
|
-
`[@pyreon/state-tree] applyPatch: reserved property name "${segment}"`,
|
|
130
|
-
)
|
|
122
|
+
throw new Error(`[@pyreon/state-tree] applyPatch: reserved property name "${segment}"`)
|
|
131
123
|
}
|
|
132
124
|
const meta = instanceMeta.get(target)
|
|
133
125
|
if (!meta)
|
|
134
|
-
throw new Error(
|
|
135
|
-
`[@pyreon/state-tree] applyPatch: not a model instance at "${segment}"`,
|
|
136
|
-
)
|
|
126
|
+
throw new Error(`[@pyreon/state-tree] applyPatch: not a model instance at "${segment}"`)
|
|
137
127
|
const sig = (target as Record<string, Signal<unknown>>)[segment]
|
|
138
|
-
if (!sig || typeof sig.peek !==
|
|
139
|
-
throw new Error(
|
|
140
|
-
`[@pyreon/state-tree] applyPatch: unknown state key "${segment}"`,
|
|
141
|
-
)
|
|
128
|
+
if (!sig || typeof sig.peek !== "function") {
|
|
129
|
+
throw new Error(`[@pyreon/state-tree] applyPatch: unknown state key "${segment}"`)
|
|
142
130
|
}
|
|
143
131
|
const nested = sig.peek()
|
|
144
|
-
if (!nested || typeof nested !==
|
|
132
|
+
if (!nested || typeof nested !== "object" || !isModelInstance(nested)) {
|
|
145
133
|
throw new Error(
|
|
146
134
|
`[@pyreon/state-tree] applyPatch: "${segment}" is not a nested model instance`,
|
|
147
135
|
)
|
|
@@ -151,21 +139,16 @@ export function applyPatch(instance: object, patch: Patch | Patch[]): void {
|
|
|
151
139
|
|
|
152
140
|
const lastKey = segments[segments.length - 1]!
|
|
153
141
|
if (RESERVED_KEYS.has(lastKey)) {
|
|
154
|
-
throw new Error(
|
|
155
|
-
`[@pyreon/state-tree] applyPatch: reserved property name "${lastKey}"`,
|
|
156
|
-
)
|
|
142
|
+
throw new Error(`[@pyreon/state-tree] applyPatch: reserved property name "${lastKey}"`)
|
|
157
143
|
}
|
|
158
144
|
const meta = instanceMeta.get(target)
|
|
159
|
-
if (!meta)
|
|
160
|
-
throw new Error('[@pyreon/state-tree] applyPatch: not a model instance')
|
|
145
|
+
if (!meta) throw new Error("[@pyreon/state-tree] applyPatch: not a model instance")
|
|
161
146
|
if (!meta.stateKeys.includes(lastKey)) {
|
|
162
|
-
throw new Error(
|
|
163
|
-
`[@pyreon/state-tree] applyPatch: unknown state key "${lastKey}"`,
|
|
164
|
-
)
|
|
147
|
+
throw new Error(`[@pyreon/state-tree] applyPatch: unknown state key "${lastKey}"`)
|
|
165
148
|
}
|
|
166
149
|
|
|
167
150
|
const sig = (target as Record<string, Signal<unknown>>)[lastKey]
|
|
168
|
-
if (sig && typeof sig.set ===
|
|
151
|
+
if (sig && typeof sig.set === "function") {
|
|
169
152
|
sig.set(p.value)
|
|
170
153
|
}
|
|
171
154
|
}
|
package/src/registry.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { InstanceMeta } from
|
|
1
|
+
import type { InstanceMeta } from "./types"
|
|
2
2
|
|
|
3
3
|
/**
|
|
4
4
|
* WeakMap from every model instance object → its internal metadata.
|
|
@@ -8,9 +8,5 @@ export const instanceMeta = new WeakMap<object, InstanceMeta>()
|
|
|
8
8
|
|
|
9
9
|
/** Returns true when a value is a model instance (has metadata registered). */
|
|
10
10
|
export function isModelInstance(value: unknown): boolean {
|
|
11
|
-
return (
|
|
12
|
-
value != null &&
|
|
13
|
-
typeof value === 'object' &&
|
|
14
|
-
instanceMeta.has(value as object)
|
|
15
|
-
)
|
|
11
|
+
return value != null && typeof value === "object" && instanceMeta.has(value as object)
|
|
16
12
|
}
|
package/src/snapshot.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import type { Signal } from
|
|
2
|
-
import { batch } from
|
|
3
|
-
import { instanceMeta, isModelInstance } from
|
|
4
|
-
import type { Snapshot, StateShape } from
|
|
1
|
+
import type { Signal } from "@pyreon/reactivity"
|
|
2
|
+
import { batch } from "@pyreon/reactivity"
|
|
3
|
+
import { instanceMeta, isModelInstance } from "./registry"
|
|
4
|
+
import type { Snapshot, StateShape } from "./types"
|
|
5
5
|
|
|
6
6
|
// ─── getSnapshot ──────────────────────────────────────────────────────────────
|
|
7
7
|
|
|
@@ -13,12 +13,9 @@ import type { Snapshot, StateShape } from './types'
|
|
|
13
13
|
* getSnapshot(counter) // { count: 6 }
|
|
14
14
|
* getSnapshot(app) // { profile: { name: "Alice" }, title: "My App" }
|
|
15
15
|
*/
|
|
16
|
-
export function getSnapshot<TState extends StateShape>(
|
|
17
|
-
instance: object,
|
|
18
|
-
): Snapshot<TState> {
|
|
16
|
+
export function getSnapshot<TState extends StateShape>(instance: object): Snapshot<TState> {
|
|
19
17
|
const meta = instanceMeta.get(instance)
|
|
20
|
-
if (!meta)
|
|
21
|
-
throw new Error('[@pyreon/state-tree] getSnapshot: not a model instance')
|
|
18
|
+
if (!meta) throw new Error("[@pyreon/state-tree] getSnapshot: not a model instance")
|
|
22
19
|
|
|
23
20
|
const out: Record<string, unknown> = {}
|
|
24
21
|
for (const key of meta.stateKeys) {
|
|
@@ -45,8 +42,7 @@ export function applySnapshot<TState extends StateShape>(
|
|
|
45
42
|
snapshot: Partial<Snapshot<TState>>,
|
|
46
43
|
): void {
|
|
47
44
|
const meta = instanceMeta.get(instance)
|
|
48
|
-
if (!meta)
|
|
49
|
-
throw new Error('[@pyreon/state-tree] applySnapshot: not a model instance')
|
|
45
|
+
if (!meta) throw new Error("[@pyreon/state-tree] applySnapshot: not a model instance")
|
|
50
46
|
|
|
51
47
|
batch(() => {
|
|
52
48
|
for (const key of meta.stateKeys) {
|