@wovin/core 0.2.2 → 0.3.2

package/dist/viewmodel/adapters/typia.d.ts

@@ -0,0 +1,40 @@
+import type { ApplogValue } from '../../applog/datom-types.ts';
+import type { ISchemaAdapter, VMAttributeDef } from '../types.ts';
+/**
+ * Pattern for creating a schema adapter from a Typia-generated schema.
+ *
+ * Typia is NOT a runtime dependency of @wovin/core, so this adapter
+ * works by accepting the Typia type object directly along with the
+ * attribute definitions (which must be provided separately since
+ * Typia doesn't expose runtime property introspection by default).
+ *
+ * Usage:
+ * ```ts
+ * import typia from 'typia'
+ * import { createTypiaAdapter } from '@wovin/core/viewmodel/adapters/typia'
+ *
+ * interface MyEntity { name: string; age?: number }
+ *
+ * const adapter = createTypiaAdapter<MyEntity>(
+ *   typia.createValidate<MyEntity>(),
+ *   'myEntity',
+ *   {
+ *     attributes: [
+ *       { name: 'name', atPath: 'myEntity/name', optional: false },
+ *       { name: 'age', atPath: 'myEntity/age', optional: true },
+ *     ],
+ *   },
+ * )
+ * ```
+ */
+export declare function createTypiaAdapter<T extends Record<string, ApplogValue>>(_typiaValidator: (input: unknown) => {
+    success: boolean;
+    data: T | null;
+    errors?: any[];
+}, entityPrefix: string, options: {
+    /** Attribute definitions (required for Typia since property introspection is compile-time) */
+    attributes: VMAttributeDef[];
+    /** Default values */
+    defaults?: Partial<T>;
+}): ISchemaAdapter<T>;
+//# sourceMappingURL=typia.d.ts.map

package/dist/viewmodel/adapters/typia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typia.d.ts","sourceRoot":"","sources":["../../../src/viewmodel/adapters/typia.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACvE,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAA;CAAE,EACzF,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE;IACR,8FAA8F;IAC9F,UAAU,EAAE,cAAc,EAAE,CAAA;IAC5B,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CACrB,GACC,cAAc,CAAC,CAAC,CAAC,CAUnB"}

package/dist/viewmodel/adapters/typia.js

@@ -0,0 +1,7 @@
+import {
+  createTypiaAdapter
+} from "../../chunk-7QEGHKR4.js";
+export {
+  createTypiaAdapter
+};
+//# sourceMappingURL=typia.js.map

package/dist/viewmodel/adapters/typia.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/viewmodel/adapters/zod.d.ts

@@ -0,0 +1,30 @@
+import type { ApplogValue } from '../../applog/datom-types.ts';
+import type { ISchemaAdapter } from '../types.ts';
+import type { ZodObject, ZodTypeAny } from 'zod';
+/**
+ * Create a schema adapter from a Zod object schema.
+ *
+ * Usage:
+ * ```ts
+ * import { z } from 'zod'
+ * import { createZodAdapter } from '@wovin/core/viewmodel/adapters/zod'
+ *
+ * const MySchema = z.object({
+ *   name: z.string(),
+ *   age: z.number().optional(),
+ * })
+ *
+ * const adapter = createZodAdapter(MySchema, 'myEntity')
+ * ```
+ *
+ * The type parameter `T` is the inferred type of the schema.
+ */
+export declare function createZodAdapter<T extends Record<string, ApplogValue> = Record<string, ApplogValue>>(zodSchema: ZodObject<Record<string, ZodTypeAny>>, entityPrefix: string, options?: {
+    /** Override at-paths for specific attributes */
+    atOverrides?: Record<string, string>;
+    /** Default values */
+    defaults?: Partial<T>;
+    /** Property name to at-path mapping function */
+    toAtPath?: (entityPrefix: string, attrName: string) => string;
+}): ISchemaAdapter<T>;
+//# sourceMappingURL=zod.d.ts.map

package/dist/viewmodel/adapters/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../../src/viewmodel/adapters/zod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,aAAa,CAAA;AACjE,OAAO,KAAK,EAAE,SAAS,EAAW,UAAU,EAAE,MAAM,KAAK,CAAA;AAEzD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACnG,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,EAChD,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;IACT,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IACrB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;CAC7D,GACC,cAAc,CAAC,CAAC,CAAC,CAqBnB"}

package/dist/viewmodel/adapters/zod.js

@@ -0,0 +1,7 @@
+import {
+  createZodAdapter
+} from "../../chunk-XF4DWOAE.js";
+export {
+  createZodAdapter
+};
+//# sourceMappingURL=zod.js.map

package/dist/viewmodel/adapters/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/viewmodel/builder.d.ts

@@ -0,0 +1,40 @@
+import type { ApplogForInsertOptionalAgent, ApplogValue, EntityID } from '../applog/datom-types.ts';
+/**
+ * Generic ObjectBuilder for type-safe entity creation and updates.
+ *
+ * Provides a fluent API to build a set of applogs for an entity.
+ * Modeled after the note3 builder pattern.
+ *
+ * Usage:
+ * ```ts
+ * ObjectBuilder.create({ name: 'foo' })
+ *   .update({ type: 'bar' })
+ *   .build(thread)
+ * ```
+ */
+export declare class ObjectBuilder<TARGET extends Record<string, ApplogValue> = Record<string, ApplogValue>> {
+    private _data;
+    en: EntityID | null;
+    private _atPrefix;
+    private _atOverrides;
+    constructor(_data: Partial<TARGET>, en?: EntityID | null, _atPrefix?: string | null, _atOverrides?: Partial<Record<keyof TARGET, string>>);
+    /**
+     * Create a new builder with initial data.
+     */
+    static create<TARGET extends Record<string, ApplogValue>>(init?: Partial<TARGET>, en?: EntityID, atPrefix?: string, atOverrides?: Partial<Record<keyof TARGET, string>>): ObjectBuilder<TARGET>;
+    /**
+     * Update the data being built.
+     */
+    update(updateObj: Partial<TARGET>): this;
+    /**
+     * Build the applogs for this entity, optionally resolving against a thread.
+     */
+    build(thread?: {
+        insert(applogs: ApplogForInsertOptionalAgent[]): ApplogForInsertOptionalAgent[];
+    }): ApplogForInsertOptionalAgent[];
+    /**
+     * Get the raw data being built.
+     */
+    get data(): Partial<TARGET>;
+}
+//# sourceMappingURL=builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/viewmodel/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAEnG;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAa,CACzB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;IAGvE,OAAO,CAAC,KAAK;IACN,EAAE,EAAE,QAAQ,GAAG,IAAI;IAC1B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,YAAY;gBAHZ,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,EACvB,EAAE,GAAE,QAAQ,GAAG,IAAW,EACzB,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,YAAY,GAAE,OAAO,CAAC,MAAM,CAAC,MAAM,MAAM,EAAE,MAAM,CAAC,CAAM;IAGjE;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACvD,IAAI,GAAE,OAAO,CAAC,MAAM,CAAM,EAC1B,EAAE,CAAC,EAAE,QAAQ,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,MAAM,EAAE,MAAM,CAAC,CAAC,GACjD,aAAa,CAAC,MAAM,CAAC;IAIxB;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI;IAKxC;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE;QACd,MAAM,CAAC,OAAO,EAAE,4BAA4B,EAAE,GAAG,4BAA4B,EAAE,CAAA;KAC/E,GAAG,4BAA4B,EAAE;IAclC;;OAEG;IACH,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAE1B;CACD"}

package/dist/viewmodel/examples/all-adapters.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ═══════════════════════════════════════════════════════════════
+ * Schema Adapter Examples
+ * ═══════════════════════════════════════════════════════════════
+ *
+ * This file demonstrates how to use each schema adapter with the
+ * generic ViewModel factory. Uncomment the adapter you want to use.
+ *
+ * Each section is self-contained and shows:
+ * 1. Schema definition
+ * 2. Adapter creation
+ * 3. ViewModel factory usage
+ * 4. Basic VM usage
+ *
+ * Note: Not all schema libraries are installed as dependencies.
+ *   ✓ TypeBox — peer dependency of @wovin/core (available)
+ *   ✓ Zod — dependency of @wovin/core (available)
+ *   ✗ ArkType — NOT installed (example shown for pattern reference)
+ *   ✗ Typia — NOT installed (example shown for pattern reference)
+ */
+export declare function typeBoxExample(): void;
+export declare function zodExample(): void;
+export declare function arkTypePattern(): void;
+export declare function typiaPattern(): void;
+export declare function minimalNoSchemaExample(): void;
+//# sourceMappingURL=all-adapters.d.ts.map

package/dist/viewmodel/examples/all-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"all-adapters.d.ts","sourceRoot":"","sources":["../../../src/viewmodel/examples/all-adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AA6BH,wBAAgB,cAAc,SA2B7B;AASD,wBAAgB,UAAU,SA2BzB;AASD,wBAAgB,cAAc,SAyB7B;AASD,wBAAgB,YAAY,SA0B3B;AAMD,wBAAgB,sBAAsB,SAmBrC"}

package/dist/viewmodel/factory.d.ts

@@ -0,0 +1,38 @@
+import type { ApplogValue, EntityID } from '../applog/datom-types.ts';
+import type { Thread } from '../thread/basic.ts';
+import { ObjectBuilder } from './builder.ts';
+import { type ISignalAdapter, type IVMInstance, type ViewModelFactoryOptions } from './types.ts';
+/**
+ * Default signal adapter — reads Subscribable values directly (snapshot).
+ * Subscribe-once to keep .value current. No framework reactivity.
+ */
+export declare const DefaultSignalAdapter: ISignalAdapter;
+/**
+ * Create a ViewModel factory for a given schema.
+ *
+ * Returns a base class that can be extended or used directly.
+ * The class provides:
+ * - Static `get(en, thread)` for singleton access
+ * - Static `buildNew(init, en)` for creating entities
+ * - Instance `buildUpdate(init)` for updating entities
+ * - Lazy reactive property accessors per attribute
+ * - `setDeleted()` for soft deletion
+ *
+ * Framework-specific reactivity (Solid, Vue, etc.) can be added by
+ * providing a custom `ISignalAdapter` in the options.
+ *
+ * @param options - Factory configuration
+ * @returns A VM class constructor with static methods
+ */
+export declare function createViewModelFactory<T extends Record<string, ApplogValue>>(options: ViewModelFactoryOptions<T>): {
+    new (en: EntityID, thread: Thread, skipInit?: boolean): IVMInstance<T> & T;
+    /** Get or create a VM instance for the given entity ID */
+    get(en: EntityID, thread: Thread): IVMInstance<T> & T;
+    /** Create a builder for a new entity */
+    buildNew(init?: Partial<T>, en?: EntityID): ObjectBuilder<T>;
+    /** The VM name (for debugging) */
+    readonly vmName: string;
+    /** The entity prefix used for at-paths */
+    readonly entityPrefix: string;
+};
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/viewmodel/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgC,WAAW,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAMnG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAGhD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAG5B,MAAM,YAAY,CAAA;AAMnB;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,cAUlC,CAAA;AAoCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAC3E,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GA4NN;IAC5B,KACC,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,OAAO,GAChB,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAErB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAErD,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC,CAAA;IAE5D,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC7B,CACD"}

package/dist/viewmodel/index.d.ts

@@ -0,0 +1,10 @@
+export { ObjectBuilder } from './builder.ts';
+export { createViewModelFactory, DefaultSignalAdapter } from './factory.ts';
+export { createAdapterFromAttributes, buildAtPath } from './schema-adapter.ts';
+export type { ISchemaAdapter, ISignalAdapter, IVMInstance, IVMClass, VMAttributeDef, ViewModelFactoryOptions, VMInstanceMap, } from './types.ts';
+export { GlobalVMInstances, getInstancesForThread } from './types.ts';
+export { createTypeBoxAdapter } from './adapters/typebox.ts';
+export { createZodAdapter } from './adapters/zod.ts';
+export { createArkTypeAdapter } from './adapters/arktype.ts';
+export { createTypiaAdapter } from './adapters/typia.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/viewmodel/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAC3E,OAAO,EAAE,2BAA2B,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC9E,YAAY,EACX,cAAc,EACd,cAAc,EACd,WAAW,EACX,QAAQ,EACR,cAAc,EACd,uBAAuB,EACvB,aAAa,GACb,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAGrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA"}

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-N7SEGHU4.js";
+import {
+  EntityID_LENGTH,
+  SubscribableImpl,
+  dateNowIso,
+  ensureTsPvAndFinalizeApplog,
+  isInitEvent,
+  mintNewEntity,
+  rollingFilter
+} from "../chunk-4MKPGQIM.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) => mintNewEntity({ ...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, mintNewEntity } 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\tmintNewEntity({ ...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"}