@wovin/core 0.2.0 → 0.3.0

package/dist/viewmodel/index.js

@@ -0,0 +1,313 @@
+import {
+  createArkTypeAdapter
+} from "../chunk-64EJIJAJ.js";
+import {
+  createTypeBoxAdapter
+} from "../chunk-ICBK7NC4.js";
+import {
+  createTypiaAdapter
+} from "../chunk-7QEGHKR4.js";
+import {
+  createZodAdapter
+} from "../chunk-XF4DWOAE.js";
+import {
+  lastWriteWins,
+  liveEntityAt
+} from "../chunk-2PJFLZRC.js";
+import {
+  EntityID_LENGTH,
+  SubscribableImpl,
+  dateNowIso,
+  ensureTsPvAndFinalizeApplog,
+  getHashID,
+  isInitEvent,
+  rollingFilter
+} from "../chunk-2OXLPZQI.js";
+import "../chunk-ZAADLBSB.js";
+
+// src/viewmodel/builder.ts
+var ObjectBuilder = class _ObjectBuilder {
+  constructor(_data, en = null, _atPrefix = null, _atOverrides = {}) {
+    this._data = _data;
+    this.en = en;
+    this._atPrefix = _atPrefix;
+    this._atOverrides = _atOverrides;
+  }
+  _data;
+  en;
+  _atPrefix;
+  _atOverrides;
+  /**
+   * Create a new builder with initial data.
+   */
+  static create(init = {}, en, atPrefix, atOverrides) {
+    return new _ObjectBuilder(init, en, atPrefix, atOverrides);
+  }
+  /**
+   * Update the data being built.
+   */
+  update(updateObj) {
+    Object.assign(this._data, updateObj);
+    return this;
+  }
+  /**
+   * Build the applogs for this entity, optionally resolving against a thread.
+   */
+  build(thread) {
+    const atPrefix = this._atPrefix;
+    const applogs = [];
+    for (const [key, value] of Object.entries(this._data)) {
+      if (value === void 0) continue;
+      const atOverride = this._atOverrides[key];
+      const at = atOverride ?? (atPrefix ? `${atPrefix}/${String(key)}` : String(key));
+      applogs.push({ en: this.en, at, vl: value });
+    }
+    return applogs;
+  }
+  /**
+   * Get the raw data being built.
+   */
+  get data() {
+    return { ...this._data };
+  }
+};
+
+// src/viewmodel/types.ts
+var GlobalVMInstances = /* @__PURE__ */ new WeakMap();
+function getInstancesForThread(thread) {
+  let threadMap = GlobalVMInstances.get(thread);
+  if (!threadMap) {
+    threadMap = /* @__PURE__ */ new Map();
+    GlobalVMInstances.set(thread, threadMap);
+  }
+  return threadMap;
+}
+
+// src/viewmodel/factory.ts
+var DefaultSignalAdapter = {
+  createGetter(subscribable) {
+    subscribable.subscribe(() => {
+    });
+    return () => subscribable.value;
+  },
+  createWritable(initial) {
+    let current = initial;
+    return [() => current, (v) => {
+      current = v;
+    }];
+  }
+};
+function makeCurrent(thread, fn) {
+  if (fn) return fn(thread);
+  return lastWriteWins(thread, { tolerateAlreadyFiltered: true });
+}
+function defaultPersistApplogs(thread, applogs) {
+  const finalized = applogs.map((log) => ensureTsPvAndFinalizeApplog(log, thread));
+  const writable = thread;
+  if (typeof writable.insertRaw === "function") {
+    writable.insertRaw(finalized);
+  } else if (typeof writable.insert === "function") {
+    writable.insert(applogs);
+  } else {
+  }
+}
+function createViewModelFactory(options) {
+  const {
+    adapter,
+    entityPrefix = adapter.getEntityPrefix(),
+    entityIdLength = EntityID_LENGTH,
+    generateEntityId,
+    vmName = entityPrefix,
+    signalAdapter = DefaultSignalAdapter
+  } = options;
+  const attrDefs = adapter.getAttributeDefs();
+  const defaults = adapter.getDefaults();
+  const genId = generateEntityId ?? ((data) => getHashID({ ...data, ts: data.ts ?? dateNowIso() }, entityIdLength));
+  const persistFn = (thread, applogs) => {
+    defaultPersistApplogs(thread, applogs);
+  };
+  class ViewModel {
+    constructor(en, thread, skipInit) {
+      this.en = en;
+      this.thread = thread;
+      if (skipInit) return;
+      const currentThread = makeCurrent(thread, options.makeCurrentThread);
+      for (const attr of attrDefs) {
+        if (attr.name === "en") continue;
+        const attrName = attr.name;
+        const atPath = attr.atPath;
+        const defaultValue = attr.defaultValue ?? defaults?.[attrName];
+        Object.defineProperty(this, attrName, {
+          get() {
+            let signal = this._signals.get(attrName);
+            if (!signal) {
+              const subscribable = liveEntityAt(currentThread, this.en, atPath);
+              signal = this._signalAdapter.createGetter(subscribable);
+              this._signals.set(attrName, signal);
+            }
+            const value = signal();
+            return value ?? defaultValue ?? value;
+          },
+          set(v) {
+            const applog = { en: this.en, at: atPath, vl: v };
+            persistFn(this.thread, [applog]);
+          },
+          enumerable: true,
+          configurable: true
+        });
+      }
+      const targets = /* @__PURE__ */ new Map();
+      this._targetApplogs = rollingFilter(currentThread, { vl: this.en });
+      this._targetMap = new SubscribableImpl(
+        targets,
+        () => this._targetApplogs.subscribe((event) => {
+          if (isInitEvent(event)) {
+            targets.clear();
+            for (const log of event.init) {
+              let ats = targets.get(log.en);
+              if (!ats) {
+                ats = /* @__PURE__ */ new Set();
+                targets.set(log.en, ats);
+              }
+              ats.add(log.at);
+            }
+          } else {
+            for (const log of event.added) {
+              let ats = targets.get(log.en);
+              if (!ats) {
+                ats = /* @__PURE__ */ new Set();
+                targets.set(log.en, ats);
+              }
+              ats.add(log.at);
+            }
+            if (event.removed) {
+              for (const log of event.removed) {
+                const ats = targets.get(log.en);
+                if (ats) {
+                  ats.delete(log.at);
+                  if (ats.size === 0) targets.delete(log.en);
+                }
+              }
+            }
+          }
+          this._targetMap._set(targets);
+        }, "derived")
+      );
+    }
+    en;
+    thread;
+    /** Per-instance signal storage */
+    _signals = /* @__PURE__ */ new Map();
+    _signalAdapter = signalAdapter;
+    /** Reactive map for applog tracking: vl === this.en */
+    _targetMap;
+    /** Applogs in the current thread where vl === this.en */
+    _targetApplogs;
+    /** Thread scoped to this entity */
+    get entityThread() {
+      return rollingFilter(this.thread, { en: this.en });
+    }
+    /** Applogs in the current thread where vl === this.en */
+    get targetApplogs() {
+      return this._targetApplogs;
+    }
+    /** Set of entities that have an applog with this.en as the vl */
+    get targettedBy() {
+      return new Set(this._targetMap.value.keys());
+    }
+    /** Set of at strings from applogs where vl === this.en */
+    get targettedVia() {
+      const via = /* @__PURE__ */ new Set();
+      for (const ats of this._targetMap.value.values()) {
+        for (const at of ats) via.add(at);
+      }
+      return via;
+    }
+    /** Whether this entity is soft-deleted */
+    get isDeleted() {
+      let signal = this._signals.get("__isDeleted");
+      if (!signal) {
+        const currentThread = makeCurrent(this.thread, options.makeCurrentThread);
+        const subscribable = liveEntityAt(currentThread, this.en, "isDeleted");
+        signal = this._signalAdapter.createGetter(subscribable);
+        this._signals.set("__isDeleted", signal);
+      }
+      return !!signal();
+    }
+    /** Soft-delete this entity */
+    setDeleted(thread = this.thread) {
+      const applog = { en: this.en, at: "isDeleted", vl: true };
+      persistFn(thread, [applog]);
+    }
+    /** Get a builder for updating this entity */
+    buildUpdate(init = {}) {
+      return new ObjectBuilder(init, this.en, entityPrefix);
+    }
+    /** Description for debugging */
+    get description() {
+      return `${vmName}VM(en=${this.en})`;
+    }
+    /** Get the full entity state as a plain object */
+    toJSON() {
+      const result = {};
+      for (const attr of attrDefs) {
+        const value = this[attr.name];
+        if (value !== void 0 && value !== null) {
+          result[attr.name] = value;
+        }
+      }
+      return result;
+    }
+  }
+  function getVMClass(en, thread) {
+    if (!en || typeof en !== "string") throw new Error(`[${vmName}VM.get] invalid en: ${en}`);
+    if (!thread) throw new Error(`[${vmName}VM.get] no thread provided`);
+    const threadMap = getInstancesForThread(thread);
+    let entityMap = threadMap.get(vmName);
+    if (!entityMap) {
+      entityMap = /* @__PURE__ */ new Map();
+      threadMap.set(vmName, entityMap);
+    }
+    const existing = entityMap.get(en);
+    if (existing) return existing;
+    const vm = new ViewModel(en, thread, false);
+    entityMap.set(en, vm);
+    return vm;
+  }
+  function buildNewEntity(init = {}, en) {
+    const entityId = en ?? genId(init);
+    return ObjectBuilder.create(init, entityId, entityPrefix);
+  }
+  const VMClass = ViewModel;
+  VMClass.get = getVMClass;
+  VMClass.buildNew = buildNewEntity;
+  VMClass.vmName = vmName;
+  VMClass.entityPrefix = entityPrefix;
+  return VMClass;
+}
+
+// src/viewmodel/schema-adapter.ts
+function createAdapterFromAttributes(config) {
+  return {
+    getAttributeDefs: () => config.attributes,
+    getDefaults: () => config.defaults ?? {},
+    getEntityPrefix: () => config.entityPrefix
+  };
+}
+function buildAtPath(entityPrefix, attrName) {
+  return `${entityPrefix}/${attrName}`;
+}
+export {
+  DefaultSignalAdapter,
+  GlobalVMInstances,
+  ObjectBuilder,
+  buildAtPath,
+  createAdapterFromAttributes,
+  createArkTypeAdapter,
+  createTypeBoxAdapter,
+  createTypiaAdapter,
+  createViewModelFactory,
+  createZodAdapter,
+  getInstancesForThread
+};
+//# sourceMappingURL=index.js.map

package/dist/viewmodel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/viewmodel/builder.ts","../../src/viewmodel/types.ts","../../src/viewmodel/factory.ts","../../src/viewmodel/schema-adapter.ts"],"sourcesContent":["import type { ApplogForInsertOptionalAgent, ApplogValue, EntityID } from '../applog/datom-types.ts'\n\n/**\n * Generic ObjectBuilder for type-safe entity creation and updates.\n *\n * Provides a fluent API to build a set of applogs for an entity.\n * Modeled after the note3 builder pattern.\n *\n * Usage:\n * ```ts\n * ObjectBuilder.create({ name: 'foo' })\n *   .update({ type: 'bar' })\n *   .build(thread)\n * ```\n */\nexport class ObjectBuilder<\n\tTARGET extends Record<string, ApplogValue> = Record<string, ApplogValue>,\n> {\n\tconstructor(\n\t\tprivate _data: Partial<TARGET>,\n\t\tpublic en: EntityID | null = null,\n\t\tprivate _atPrefix: string | null = null,\n\t\tprivate _atOverrides: Partial<Record<keyof TARGET, string>> = {},\n\t) {}\n\n\t/**\n\t * Create a new builder with initial data.\n\t */\n\tstatic create<TARGET extends Record<string, ApplogValue>>(\n\t\tinit: Partial<TARGET> = {},\n\t\ten?: EntityID,\n\t\tatPrefix?: string,\n\t\tatOverrides?: Partial<Record<keyof TARGET, string>>,\n\t): ObjectBuilder<TARGET> {\n\t\treturn new ObjectBuilder<TARGET>(init, en, atPrefix, atOverrides)\n\t}\n\n\t/**\n\t * Update the data being built.\n\t */\n\tupdate(updateObj: Partial<TARGET>): this {\n\t\tObject.assign(this._data, updateObj)\n\t\treturn this\n\t}\n\n\t/**\n\t * Build the applogs for this entity, optionally resolving against a thread.\n\t */\n\tbuild(thread?: {\n\t\tinsert(applogs: ApplogForInsertOptionalAgent[]): ApplogForInsertOptionalAgent[]\n\t}): ApplogForInsertOptionalAgent[] {\n\t\tconst atPrefix = this._atPrefix\n\t\tconst applogs: ApplogForInsertOptionalAgent[] = []\n\n\t\tfor (const [key, value] of Object.entries(this._data) as [keyof TARGET, ApplogValue][]) {\n\t\t\tif (value === undefined) continue\n\t\t\tconst atOverride = this._atOverrides[key]\n\t\t\tconst at = atOverride ?? (atPrefix ? `${atPrefix}/${String(key)}` : String(key))\n\t\t\tapplogs.push({ en: this.en!, at, vl: value })\n\t\t}\n\n\t\treturn applogs\n\t}\n\n\t/**\n\t * Get the raw data being built.\n\t */\n\tget data(): Partial<TARGET> {\n\t\treturn { ...this._data }\n\t}\n}\n","import type { ApplogValue, EntityID } from '../applog/datom-types.ts'\nimport type { Thread } from '../thread/basic.ts'\nimport type { ObjectBuilder } from './builder.ts'\n\n// ═══════════════════════════════════════════════════════════════\n// Attribute Definition\n// ═══════════════════════════════════════════════════════════════\n\nexport interface VMAttributeDef {\n\t/** Attribute name (short: e.g. 'name', 'content') */\n\tname: string\n\t/** The wovin at-path used in applogs (e.g. 'block/content', 'speaker/name') */\n\tatPath: string\n\t/** Whether the attribute is optional */\n\toptional: boolean\n\t/** Default value if not present in applogs */\n\tdefaultValue?: ApplogValue\n}\n\n// ═══════════════════════════════════════════════════════════════\n// Schema Adapter Interface\n// ═══════════════════════════════════════════════════════════════\n\n/**\n * A schema adapter converts a type-system schema (TypeBox, Zod, ArkType, Typia)\n * into a uniform representation that the VM factory can consume.\n */\nexport interface ISchemaAdapter<T extends Record<string, ApplogValue> = Record<string, ApplogValue>> {\n\t/** Get the attribute definitions for this schema */\n\tgetAttributeDefs(): VMAttributeDef[]\n\n\t/** Get default values for all attributes */\n\tgetDefaults(): Partial<T>\n\n\t/** Optional: runtime validator */\n\tcreateValidator?(): (value: unknown) => value is T\n\n\t/** The entity prefix used for wovin at-paths (e.g. 'block', 'speaker') */\n\tgetEntityPrefix(): string\n}\n\n// ═══════════════════════════════════════════════════════════════\n// ViewModel Factory Options\n// ═══════════════════════════════════════════════════════════════\n\nexport interface ViewModelFactoryOptions<T extends Record<string, ApplogValue>> {\n\t/** The schema adapter for this entity type */\n\tadapter: ISchemaAdapter<T>\n\n\t/** How to get the default thread context */\n\tgetDefaultThread?: () => Thread\n\n\t/** EntityID generation length (default: 7) */\n\tentityIdLength?: number\n\n\t/** Function to generate entity IDs */\n\tgenerateEntityId?: (data: Partial<T> & { ts?: string }) => EntityID\n\n\t/** Override the entity prefix for at-paths */\n\tentityPrefix?: string\n\n\t/** Optional function to make thread current-state (lastWriteWins) */\n\tmakeCurrentThread?: (thread: Thread) => Thread\n\n\t/** Name for the VM type (used in logging and debugging) */\n\tvmName?: string\n\n\t/**\n\t * Signal adapter for framework-specific reactivity.\n\t * Default: non-reactive (direct Subscribable reads).\n\t * For SolidJS, pass createSolidSignalAdapter() from @wovin/ui-solid/viewmodel.\n\t */\n\tsignalAdapter?: ISignalAdapter\n}\n\n// ═══════════════════════════════════════════════════════════════\n// ViewModel Instance Interface\n// ═══════════════════════════════════════════════════════════════\n\nexport interface IVMInstance<T extends Record<string, ApplogValue> = Record<string, ApplogValue>> {\n\treadonly en: EntityID\n\treadonly thread: Thread\n\n\t/** Get a builder for updating this entity */\n\tbuildUpdate(init?: Partial<T>): ObjectBuilder<T>\n\n\t/** Soft-delete this entity */\n\tsetDeleted(thread?: Thread): void\n\n\t/** Whether this entity is deleted */\n\treadonly isDeleted: boolean\n\n\t/** The entity thread filtered to this entity */\n\treadonly entityThread: Thread\n}\n\n// ═══════════════════════════════════════════════════════════════\n// ViewModel Class Interface (what the factory returns)\n// ═══════════════════════════════════════════════════════════════\n\nexport interface IVMClass<T extends Record<string, ApplogValue> = Record<string, ApplogValue>> {\n\tnew(en: EntityID, thread: Thread, ...args: any[]): IVMInstance<T>\n\n\t/** Get or create a VM instance for the given entity ID and thread */\n\tget(en: EntityID, thread: Thread): IVMInstance<T>\n\n\t/** Create a new entity builder */\n\tbuildNew(init?: Partial<T>, en?: EntityID): ObjectBuilder<T>\n}\n\n// ═══════════════════════════════════════════════════════════════\n// Signal Adapter Interface (framework-specific reactivity)\n// ═══════════════════════════════════════════════════════════════\n\n/**\n * A signal adapter abstracts how the VM creates reactive signals for each attribute.\n * The core factory uses a default (non-reactive) implementation.\n * Framework-specific extensions (Solid, Vue, etc.) override this.\n */\nexport interface ISignalAdapter {\n\t/**\n\t * Create a reactive getter for a subscribable value.\n\t * Returns a function that returns the current value.\n\t * In the default implementation, this is just () => subscribable.value.\n\t */\n\tcreateGetter<T>(subscribable: { value: T; subscribe(cb: () => void): () => void }): () => T\n\n\t/**\n\t * Create a writable signal for an attribute.\n\t * Returns [get, set] pair.\n\t * Default implementation stores and returns value directly.\n\t */\n\tcreateWritable<T>(initial: T): [() => T, (v: T) => void]\n}\n\n// ═══════════════════════════════════════════════════════════════\n// Shared state maps\n// ═══════════════════════════════════════════════════════════════\n\nexport type VMInstanceMap<T> = Map<EntityID, T>\n\n/** WeakMap from Thread → Map<VMName, Map<EntityID, VMInstance>> */\nexport const GlobalVMInstances = new WeakMap<Thread, Map<string, Map<EntityID, unknown>>>()\n\nexport function getInstancesForThread(thread: Thread): Map<string, Map<EntityID, unknown>> {\n\tlet threadMap = GlobalVMInstances.get(thread)\n\tif (!threadMap) {\n\t\tthreadMap = new Map()\n\t\tGlobalVMInstances.set(thread, threadMap)\n\t}\n\treturn threadMap\n}\n","import type { ApplogForInsertOptionalAgent, ApplogValue, EntityID } from '../applog/datom-types.ts'\nimport { EntityID_LENGTH } from '../applog/datom-types.ts'\nimport { dateNowIso, getHashID } from '../applog/applog-utils.ts'\nimport { ensureTsPvAndFinalizeApplog } from '../applog/applog-helpers.ts'\nimport { lastWriteWins, liveEntityAt } from '../query/basic.ts'\nimport { SubscribableImpl } from '../query/subscribable.ts'\nimport type { Thread } from '../thread/basic.ts'\nimport { isInitEvent } from '../thread/basic.ts'\nimport { rollingFilter } from '../thread/filters.ts'\nimport { ObjectBuilder } from './builder.ts'\nimport {\n\ttype ISignalAdapter,\n\ttype IVMInstance,\n\ttype ViewModelFactoryOptions,\n\ttype VMInstanceMap,\n\tgetInstancesForThread,\n} from './types.ts'\n\n// ═══════════════════════════════════════════════════════════════\n// Default (non-reactive) Signal Adapter\n// ═══════════════════════════════════════════════════════════════\n\n/**\n * Default signal adapter — reads Subscribable values directly (snapshot).\n * Subscribe-once to keep .value current. No framework reactivity.\n */\nexport const DefaultSignalAdapter: ISignalAdapter = {\n\tcreateGetter<T>(subscribable: { value: T; subscribe(cb: () => void): () => void }): () => T {\n\t\t// Subscribe once to activate upstream (lazy activation)\n\t\tsubscribable.subscribe(() => {})\n\t\treturn () => subscribable.value\n\t},\n\tcreateWritable<T>(initial: T): [() => T, (v: T) => void] {\n\t\tlet current = initial\n\t\treturn [() => current, (v: T) => { current = v }]\n\t},\n}\n\n// ═══════════════════════════════════════════════════════════════\n// makeCurrentThread - convenience wrapper\n// ═══════════════════════════════════════════════════════════════\n\nfunction makeCurrent(thread: Thread, fn?: ViewModelFactoryOptions<any>['makeCurrentThread']): Thread {\n\tif (fn) return fn(thread)\n\treturn lastWriteWins(thread, { tolerateAlreadyFiltered: true })\n}\n\n// ═══════════════════════════════════════════════════════════════\n// Default persist function\n// ═══════════════════════════════════════════════════════════════\n\n/**\n * Default applog persistence: finalize applogs and push into thread.\n * Works with WriteableThread (which has insertRaw).\n */\nfunction defaultPersistApplogs(thread: Thread, applogs: ApplogForInsertOptionalAgent[]): void {\n\tconst finalized = applogs.map(log => ensureTsPvAndFinalizeApplog(log as any, thread))\n\tconst writable = thread as any\n\tif (typeof writable.insertRaw === 'function') {\n\t\twritable.insertRaw(finalized)\n\t} else if (typeof writable.insert === 'function') {\n\t\twritable.insert(applogs)\n\t} else {\n\t\t// Read-only thread — just finalize but don't persist\n\t\t// This is fine for optimistic UI or read-only scenarios\n\t}\n}\n\n// ═══════════════════════════════════════════════════════════════\n// createViewModelFactory - THE MAIN FACTORY\n// ═══════════════════════════════════════════════════════════════\n\n/**\n * Create a ViewModel factory for a given schema.\n *\n * Returns a base class that can be extended or used directly.\n * The class provides:\n * - Static `get(en, thread)` for singleton access\n * - Static `buildNew(init, en)` for creating entities\n * - Instance `buildUpdate(init)` for updating entities\n * - Lazy reactive property accessors per attribute\n * - `setDeleted()` for soft deletion\n *\n * Framework-specific reactivity (Solid, Vue, etc.) can be added by\n * providing a custom `ISignalAdapter` in the options.\n *\n * @param options - Factory configuration\n * @returns A VM class constructor with static methods\n */\nexport function createViewModelFactory<T extends Record<string, ApplogValue>>(\n\toptions: ViewModelFactoryOptions<T>,\n) {\n\tconst {\n\t\tadapter,\n\t\tentityPrefix = adapter.getEntityPrefix(),\n\t\tentityIdLength = EntityID_LENGTH,\n\t\tgenerateEntityId,\n\t\tvmName = entityPrefix,\n\t\tsignalAdapter = DefaultSignalAdapter,\n\t} = options\n\n\tconst attrDefs = adapter.getAttributeDefs()\n\tconst defaults = adapter.getDefaults()\n\n\t// Entity ID generation\n\tconst genId = generateEntityId ?? ((data: Partial<T> & { ts?: string }) =>\n\t\tgetHashID({ ...data, ts: data.ts ?? dateNowIso() }, entityIdLength) as EntityID)\n\n\t// Persist function (can be overridden by extending class)\n\tconst persistFn = (thread: Thread, applogs: ApplogForInsertOptionalAgent[]) => {\n\t\tdefaultPersistApplogs(thread, applogs)\n\t}\n\n\t// ═══════════════════════════════════════════════════════════════\n\t// The ViewModel Class\n\t// ═══════════════════════════════════════════════════════════════\n\tclass ViewModel {\n\t\t/** Per-instance signal storage */\n\t\t_signals = new Map<string, () => ApplogValue>()\n\t\t_signalAdapter: ISignalAdapter = signalAdapter\n\n\t\t/** Reactive map for applog tracking: vl === this.en */\n\t\t_targetMap: SubscribableImpl<Map<EntityID, Set<string>>>\n\n\t\t/** Applogs in the current thread where vl === this.en */\n\t\t_targetApplogs: Thread\n\n\t\tconstructor(\n\t\t\tpublic en: EntityID,\n\t\t\tpublic thread: Thread,\n\t\t\tskipInit?: boolean,\n\t\t) {\n\t\t\tif (skipInit) return\n\n\t\t\tconst currentThread = makeCurrent(thread, options.makeCurrentThread)\n\n\t\t\t// Define lazy getters/setters for each attribute\n\t\t\tfor (const attr of attrDefs) {\n\t\t\t\tif (attr.name === 'en') continue\n\n\t\t\t\tconst attrName = attr.name\n\t\t\t\tconst atPath = attr.atPath\n\t\t\t\tconst defaultValue = attr.defaultValue ?? defaults?.[attrName as keyof T]\n\n\t\t\t\tObject.defineProperty(this, attrName, {\n\t\t\t\t\tget(this: ViewModel) {\n\t\t\t\t\t\tlet signal = this._signals.get(attrName)\n\t\t\t\t\t\tif (!signal) {\n\t\t\t\t\t\t\tconst subscribable = liveEntityAt(currentThread, this.en, atPath)\n\t\t\t\t\t\t\tsignal = this._signalAdapter.createGetter(subscribable)\n\t\t\t\t\t\t\tthis._signals.set(attrName, signal)\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconst value = signal()\n\t\t\t\t\t\treturn value ?? (defaultValue as ApplogValue | undefined) ?? value\n\t\t\t\t\t},\n\t\t\t\t\tset(this: ViewModel, v: ApplogValue) {\n\t\t\t\t\t\tconst applog: ApplogForInsertOptionalAgent = { en: this.en, at: atPath, vl: v }\n\t\t\t\t\t\tpersistFn(this.thread, [applog])\n\t\t\t\t\t},\n\t\t\t\t\tenumerable: true,\n\t\t\t\t\tconfigurable: true,\n\t\t\t\t})\n\t\t\t}\n\n\t\t\t// ── Applog tracking: applogs where vl === this.en ────────────\n\t\t\tconst targets = new Map<EntityID, Set<string>>()\n\n\t\t\tthis._targetApplogs = rollingFilter(currentThread, { vl: this.en })\n\t\t\tthis._targetMap = new SubscribableImpl(\n\t\t\t\ttargets,\n\t\t\t\t() => this._targetApplogs.subscribe((event) => {\n\t\t\t\t\tif (isInitEvent(event)) {\n\t\t\t\t\t\ttargets.clear()\n\t\t\t\t\t\tfor (const log of event.init) {\n\t\t\t\t\t\t\tlet ats = targets.get(log.en)\n\t\t\t\t\t\t\tif (!ats) {\n\t\t\t\t\t\t\t\tats = new Set()\n\t\t\t\t\t\t\t\ttargets.set(log.en, ats)\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tats.add(log.at)\n\t\t\t\t\t\t}\n\t\t\t\t\t} else {\n\t\t\t\t\t\tfor (const log of event.added) {\n\t\t\t\t\t\t\tlet ats = targets.get(log.en)\n\t\t\t\t\t\t\tif (!ats) {\n\t\t\t\t\t\t\t\tats = new Set()\n\t\t\t\t\t\t\t\ttargets.set(log.en, ats)\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tats.add(log.at)\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (event.removed) {\n\t\t\t\t\t\t\tfor (const log of event.removed) {\n\t\t\t\t\t\t\t\tconst ats = targets.get(log.en)\n\t\t\t\t\t\t\t\tif (ats) {\n\t\t\t\t\t\t\t\t\tats.delete(log.at)\n\t\t\t\t\t\t\t\t\tif (ats.size === 0) targets.delete(log.en)\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tthis._targetMap._set(targets)\n\t\t\t\t}, 'derived'),\n\t\t\t)\n\t\t}\n\n\t\t/** Thread scoped to this entity */\n\t\tget entityThread(): Thread {\n\t\t\treturn rollingFilter(this.thread, { en: this.en })\n\t\t}\n\n\t\t/** Applogs in the current thread where vl === this.en */\n\t\tget targetApplogs(): Thread {\n\t\t\treturn this._targetApplogs\n\t\t}\n\n\t\t/** Set of entities that have an applog with this.en as the vl */\n\t\tget targettedBy(): Set<EntityID> {\n\t\t\treturn new Set(this._targetMap.value.keys())\n\t\t}\n\n\t\t/** Set of at strings from applogs where vl === this.en */\n\t\tget targettedVia(): Set<string> {\n\t\t\tconst via = new Set<string>()\n\t\t\tfor (const ats of this._targetMap.value.values()) {\n\t\t\t\tfor (const at of ats) via.add(at)\n\t\t\t}\n\t\t\treturn via\n\t\t}\n\n\t\t/** Whether this entity is soft-deleted */\n\t\tget isDeleted(): boolean {\n\t\t\tlet signal = this._signals.get('__isDeleted')\n\t\t\tif (!signal) {\n\t\t\t\tconst currentThread = makeCurrent(this.thread, options.makeCurrentThread)\n\t\t\t\tconst subscribable = liveEntityAt(currentThread, this.en, 'isDeleted')\n\t\t\t\tsignal = this._signalAdapter.createGetter(subscribable)\n\t\t\t\tthis._signals.set('__isDeleted', signal)\n\t\t\t}\n\t\t\treturn !!signal()\n\t\t}\n\n\t\t/** Soft-delete this entity */\n\t\tsetDeleted(thread = this.thread): void {\n\t\t\tconst applog: ApplogForInsertOptionalAgent = { en: this.en, at: 'isDeleted', vl: true }\n\t\t\tpersistFn(thread, [applog])\n\t\t}\n\n\t\t/** Get a builder for updating this entity */\n\t\tbuildUpdate(init: Partial<T> = {}): ObjectBuilder<T> {\n\t\t\treturn new ObjectBuilder<T>(init, this.en, entityPrefix)\n\t\t}\n\n\t\t/** Description for debugging */\n\t\tget description(): string {\n\t\t\treturn `${vmName}VM(en=${this.en})`\n\t\t}\n\n\t\t/** Get the full entity state as a plain object */\n\t\ttoJSON(): Partial<T> {\n\t\t\tconst result: Record<string, ApplogValue> = {}\n\t\t\tfor (const attr of attrDefs) {\n\t\t\t\tconst value = (this as any)[attr.name]\n\t\t\t\tif (value !== undefined && value !== null) {\n\t\t\t\t\tresult[attr.name] = value\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn result as Partial<T>\n\t\t}\n\t}\n\n\t// ── Static Methods ────────────────────────────────────────────\n\n\t/**\n\t * Get or create a VM instance for the given entity and thread.\n\t * Implements the singleton pattern — returns cached instance if one exists.\n\t */\n\tfunction getVMClass(en: EntityID, thread: Thread): InstanceType<typeof ViewModel> {\n\t\tif (!en || typeof en !== 'string') throw new Error(`[${vmName}VM.get] invalid en: ${en}`)\n\t\tif (!thread) throw new Error(`[${vmName}VM.get] no thread provided`)\n\n\t\tconst threadMap = getInstancesForThread(thread)\n\t\tlet entityMap = threadMap.get(vmName) as VMInstanceMap<InstanceType<typeof ViewModel>> | undefined\n\t\tif (!entityMap) {\n\t\t\tentityMap = new Map()\n\t\t\tthreadMap.set(vmName, entityMap)\n\t\t}\n\n\t\tconst existing = entityMap.get(en)\n\t\tif (existing) return existing\n\n\t\tconst vm = new ViewModel(en, thread, false) as InstanceType<typeof ViewModel>\n\t\tentityMap.set(en, vm)\n\t\treturn vm\n\t}\n\n\t/**\n\t * Create a builder for constructing a new entity.\n\t */\n\tfunction buildNewEntity(init: Partial<T> = {}, en?: EntityID): ObjectBuilder<T> {\n\t\tconst entityId = en ?? genId(init as any)\n\t\treturn ObjectBuilder.create<T>(init, entityId, entityPrefix)\n\t}\n\n\t// Attach static methods to the class\n\tconst VMClass: any = ViewModel\n\tVMClass.get = getVMClass\n\tVMClass.buildNew = buildNewEntity\n\tVMClass.vmName = vmName\n\tVMClass.entityPrefix = entityPrefix\n\n\treturn VMClass as unknown as {\n\t\tnew(\n\t\t\ten: EntityID,\n\t\t\tthread: Thread,\n\t\t\tskipInit?: boolean,\n\t\t): IVMInstance<T> & T\n\n\t\t/** Get or create a VM instance for the given entity ID */\n\t\tget(en: EntityID, thread: Thread): IVMInstance<T> & T\n\n\t\t/** Create a builder for a new entity */\n\t\tbuildNew(init?: Partial<T>, en?: EntityID): ObjectBuilder<T>\n\n\t\t/** The VM name (for debugging) */\n\t\treadonly vmName: string\n\n\t\t/** The entity prefix used for at-paths */\n\t\treadonly entityPrefix: string\n\t}\n}\n","import type { ApplogValue } from '../applog/datom-types.ts'\nimport type { ISchemaAdapter, VMAttributeDef } from './types.ts'\n\n/**\n * Helper to create a simple schema adapter from a plain attribute list.\n * Useful for quick VM definitions or when you don't have a formal schema library.\n */\nexport function createAdapterFromAttributes<T extends Record<string, ApplogValue>>(\n\tconfig: {\n\t\tattributes: VMAttributeDef[]\n\t\tentityPrefix: string\n\t\tdefaults?: Partial<T>\n\t},\n): ISchemaAdapter<T> {\n\treturn {\n\t\tgetAttributeDefs: () => config.attributes,\n\t\tgetDefaults: () => (config.defaults ?? {}) as Partial<T>,\n\t\tgetEntityPrefix: () => config.entityPrefix,\n\t}\n}\n\n/**\n * Helper to build at-paths from attribute names and an entity prefix.\n */\nexport function buildAtPath(entityPrefix: string, attrName: string): string {\n\treturn `${entityPrefix}/${attrName}`\n}\n"],"mappings":"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","names":[]}

package/dist/viewmodel/schema-adapter.d.ts

@@ -0,0 +1,16 @@
+import type { ApplogValue } from '../applog/datom-types.ts';
+import type { ISchemaAdapter, VMAttributeDef } from './types.ts';
+/**
+ * Helper to create a simple schema adapter from a plain attribute list.
+ * Useful for quick VM definitions or when you don't have a formal schema library.
+ */
+export declare function createAdapterFromAttributes<T extends Record<string, ApplogValue>>(config: {
+    attributes: VMAttributeDef[];
+    entityPrefix: string;
+    defaults?: Partial<T>;
+}): ISchemaAdapter<T>;
+/**
+ * Helper to build at-paths from attribute names and an entity prefix.
+ */
+export declare function buildAtPath(entityPrefix: string, attrName: string): string;
+//# sourceMappingURL=schema-adapter.d.ts.map

package/dist/viewmodel/schema-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-adapter.d.ts","sourceRoot":"","sources":["../../src/viewmodel/schema-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhE;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAChF,MAAM,EAAE;IACP,UAAU,EAAE,cAAc,EAAE,CAAA;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CACrB,GACC,cAAc,CAAC,CAAC,CAAC,CAMnB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1E"}

package/dist/viewmodel/types.d.ts

@@ -0,0 +1,97 @@
+import type { ApplogValue, EntityID } from '../applog/datom-types.ts';
+import type { Thread } from '../thread/basic.ts';
+import type { ObjectBuilder } from './builder.ts';
+export interface VMAttributeDef {
+    /** Attribute name (short: e.g. 'name', 'content') */
+    name: string;
+    /** The wovin at-path used in applogs (e.g. 'block/content', 'speaker/name') */
+    atPath: string;
+    /** Whether the attribute is optional */
+    optional: boolean;
+    /** Default value if not present in applogs */
+    defaultValue?: ApplogValue;
+}
+/**
+ * A schema adapter converts a type-system schema (TypeBox, Zod, ArkType, Typia)
+ * into a uniform representation that the VM factory can consume.
+ */
+export interface ISchemaAdapter<T extends Record<string, ApplogValue> = Record<string, ApplogValue>> {
+    /** Get the attribute definitions for this schema */
+    getAttributeDefs(): VMAttributeDef[];
+    /** Get default values for all attributes */
+    getDefaults(): Partial<T>;
+    /** Optional: runtime validator */
+    createValidator?(): (value: unknown) => value is T;
+    /** The entity prefix used for wovin at-paths (e.g. 'block', 'speaker') */
+    getEntityPrefix(): string;
+}
+export interface ViewModelFactoryOptions<T extends Record<string, ApplogValue>> {
+    /** The schema adapter for this entity type */
+    adapter: ISchemaAdapter<T>;
+    /** How to get the default thread context */
+    getDefaultThread?: () => Thread;
+    /** EntityID generation length (default: 7) */
+    entityIdLength?: number;
+    /** Function to generate entity IDs */
+    generateEntityId?: (data: Partial<T> & {
+        ts?: string;
+    }) => EntityID;
+    /** Override the entity prefix for at-paths */
+    entityPrefix?: string;
+    /** Optional function to make thread current-state (lastWriteWins) */
+    makeCurrentThread?: (thread: Thread) => Thread;
+    /** Name for the VM type (used in logging and debugging) */
+    vmName?: string;
+    /**
+     * Signal adapter for framework-specific reactivity.
+     * Default: non-reactive (direct Subscribable reads).
+     * For SolidJS, pass createSolidSignalAdapter() from @wovin/ui-solid/viewmodel.
+     */
+    signalAdapter?: ISignalAdapter;
+}
+export interface IVMInstance<T extends Record<string, ApplogValue> = Record<string, ApplogValue>> {
+    readonly en: EntityID;
+    readonly thread: Thread;
+    /** Get a builder for updating this entity */
+    buildUpdate(init?: Partial<T>): ObjectBuilder<T>;
+    /** Soft-delete this entity */
+    setDeleted(thread?: Thread): void;
+    /** Whether this entity is deleted */
+    readonly isDeleted: boolean;
+    /** The entity thread filtered to this entity */
+    readonly entityThread: Thread;
+}
+export interface IVMClass<T extends Record<string, ApplogValue> = Record<string, ApplogValue>> {
+    new (en: EntityID, thread: Thread, ...args: any[]): IVMInstance<T>;
+    /** Get or create a VM instance for the given entity ID and thread */
+    get(en: EntityID, thread: Thread): IVMInstance<T>;
+    /** Create a new entity builder */
+    buildNew(init?: Partial<T>, en?: EntityID): ObjectBuilder<T>;
+}
+/**
+ * A signal adapter abstracts how the VM creates reactive signals for each attribute.
+ * The core factory uses a default (non-reactive) implementation.
+ * Framework-specific extensions (Solid, Vue, etc.) override this.
+ */
+export interface ISignalAdapter {
+    /**
+     * Create a reactive getter for a subscribable value.
+     * Returns a function that returns the current value.
+     * In the default implementation, this is just () => subscribable.value.
+     */
+    createGetter<T>(subscribable: {
+        value: T;
+        subscribe(cb: () => void): () => void;
+    }): () => T;
+    /**
+     * Create a writable signal for an attribute.
+     * Returns [get, set] pair.
+     * Default implementation stores and returns value directly.
+     */
+    createWritable<T>(initial: T): [() => T, (v: T) => void];
+}
+export type VMInstanceMap<T> = Map<EntityID, T>;
+/** WeakMap from Thread → Map<VMName, Map<EntityID, VMInstance>> */
+export declare const GlobalVMInstances: WeakMap<Thread, Map<string, Map<string, unknown>>>;
+export declare function getInstancesForThread(thread: Thread): Map<string, Map<EntityID, unknown>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/viewmodel/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/viewmodel/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wovin/core",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -57,6 +57,31 @@
       "import": "./dist/utils.js",
       "types": "./dist/utils.d.ts"
     },
+    "./viewmodel": {
+      "source": "./src/viewmodel/index.ts",
+      "import": "./dist/viewmodel/index.js",
+      "types": "./dist/viewmodel/index.d.ts"
+    },
+    "./viewmodel/adapters/typebox": {
+      "source": "./src/viewmodel/adapters/typebox.ts",
+      "import": "./dist/viewmodel/adapters/typebox.js",
+      "types": "./dist/viewmodel/adapters/typebox.d.ts"
+    },
+    "./viewmodel/adapters/zod": {
+      "source": "./src/viewmodel/adapters/zod.ts",
+      "import": "./dist/viewmodel/adapters/zod.js",
+      "types": "./dist/viewmodel/adapters/zod.d.ts"
+    },
+    "./viewmodel/adapters/arktype": {
+      "source": "./src/viewmodel/adapters/arktype.ts",
+      "import": "./dist/viewmodel/adapters/arktype.js",
+      "types": "./dist/viewmodel/adapters/arktype.d.ts"
+    },
+    "./viewmodel/adapters/typia": {
+      "source": "./src/viewmodel/adapters/typia.ts",
+      "import": "./dist/viewmodel/adapters/typia.js",
+      "types": "./dist/viewmodel/adapters/typia.d.ts"
+    },
     "./ipns": {
       "source": "./src/ipns.ts",
       "import": "./dist/ipns.js",
@@ -67,7 +92,6 @@
     "./dist/",
     "./src/"
   ],
-  "packageManager": "pnpm",
   "esm.sh": {
     "bundle": false
   },
@@ -88,8 +112,10 @@
     "lodash-es": "^4.17.21",
     "@libp2p/crypto": "^5.0.0",
     "ipns": "^10.1.2",
-    "multiformats": "^13.4.1",
+    "multiformats": "^14.0.0",
+    "partysocket": "^1.0.2",
     "safe-stable-stringify": "^2.5.0",
+    "w3name": "^1.1.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {

package/src/applog/applog-utils.ts

@@ -24,6 +24,33 @@ export const objEqualByKeys = (keys: string[], objA: object, objB: object) => {
 	return isEqual(pick(objA, keys), pick(objB, keys))
 }
 
+/**
+ * Deep equality for an `ApplogValue`. `vl` can now hold JSON objects/arrays, so a bare
+ * `===` would treat structurally-identical objects as different. `isEqual` short-circuits
+ * on referential identity internally, so primitives stay on the cheap path.
+ */
+export const valueEq = (a: ApplogValue, b: ApplogValue): boolean => isEqual(a, b)
+
+/** Canonical, hashable Map key for an `ApplogValue` (see {@link valueKey}). */
+export type ValueKey = string | number | boolean | null
+
+/**
+ * Canonical key for using an `ApplogValue` as a Map key. Primitives pass through unchanged
+ * (so primitive-keyed lookups are identity-stable); objects/arrays are stably stringified
+ * (key-sorted) behind a `\0obj:` sentinel so an object value can't collide with a string
+ * value that happens to equal its serialization.
+ */
+export const valueKey = (vl: ApplogValue): ValueKey => {
+	switch (typeof vl) {
+		case 'string':
+		case 'number':
+		case 'boolean':
+			return vl
+		default: // null | object | array
+			return vl === null ? null : '\0obj:' + stringify(vl)
+	}
+}
+
 /** Transitive total-order comparator over (ts, cid). Safe for `Array.sort`. */
 export const compareApplogsByTs = (logA: Applog, logB: Applog, dir: 'asc' | 'desc' = 'asc') => {
 	const tsCmp = isoDateStrCompare(logA.ts, logB.ts, dir)
@@ -297,15 +324,22 @@ export function matchPartStatic(field: keyof Applog, patternPart: ValueOrMatcher
 			result = patternPart === atomPart // shortcut for most common use-case
 		} else if (typ === 'function') {
 			result = (patternPart as Function)(atomPart)
+		} else if (Array.isArray(patternPart)) {
+			// A bare array is ambiguous now that `vl` may itself be an array value: it could
+			// mean set-membership or a literal-array match. Fail loudly rather than match wrong.
+			throw ERROR(
+				`[matchPartStatic] a bare array is not a valid matcher for field '${field}'.`
+					+ ` Use anyOf(...) for set-membership, or a predicate (v) => isEqual(v, [...]) to match a literal array value.`,
+				patternPart,
+			)
 		} else if (typeof (patternPart as any).has === 'function') {
 			result = (patternPart as Set<any>).has(atomPart)
-		} else if (Array.isArray(patternPart) && !Array.isArray(atomPart) /* ? how to handle array values */) {
-			result = patternPart.includes(atomPart)
 		} // if (field === 'at' && typ === 'string' && patternPart.endsWith('*')) {
 		// 	return typeof atomPart === 'string' && atomPart.startsWith(patternPart.slice(0, -1))
 		// }
 		else {
-			result = patternPart === atomPart
+			// object/array values compare by deep equality; primitives via isEqual's === fast-path
+			result = valueEq(patternPart as ApplogValue, atomPart)
 		}
 	} else {
 		result = patternPart === atomPart
@@ -334,7 +368,17 @@ export function matchPart(patternPart: ValueOrMatcher<ApplogValue>, atomPart: Ap
 	if (typeof patternPart === 'function') {
 		return patternPart(atomPart) ? context : null
 	}
-	return patternPart === atomPart ? context : null
+	if (Array.isArray(patternPart)) {
+		throw ERROR(
+			`[matchPart] a bare array is not a valid matcher.`
+				+ ` Use anyOf(...) for set-membership, or a predicate to match a literal array value.`,
+			patternPart,
+		)
+	}
+	if (patternPart && typeof (patternPart as any).has === 'function') {
+		return (patternPart as Set<any>).has(atomPart) ? context : null
+	}
+	return valueEq(patternPart as ApplogValue, atomPart) ? context : null
 }
 
 /**