@stratasync/mobx 0.2.0

package/README.md

@@ -0,0 +1,42 @@
+# @stratasync/mobx
+
+MobX reactivity adapter for the Done.
+
+## Overview
+
+sync-mobx implements the reactivity adapter interface defined in `@stratasync/core` using MobX observables:
+
+- **Observable model instances** — model properties become MobX observables
+- **Computed values** — derived state from observable model properties
+- **Reaction-based updates** — automatic re-rendering when synced data changes
+
+## Installation
+
+```bash
+npm install @stratasync/mobx
+```
+
+Peer dependency: `mobx` ^6.0.0
+
+## Usage
+
+Register the MobX adapter when initializing the sync client:
+
+```typescript
+import { createMobxAdapter } from "@stratasync/mobx";
+
+const adapter = createMobxAdapter();
+
+// Pass to SyncClient configuration
+const client = new SyncClient({
+  reactivityAdapter: adapter,
+});
+```
+
+The adapter makes model instances observable, so MobX `observer()` components and `autorun` / `reaction` will automatically track and respond to sync updates.
+
+## How It Works
+
+1. When models are hydrated from sync deltas, the adapter wraps properties with MobX observables
+2. React components wrapped with `observer()` automatically re-render when observed properties change
+3. Computed values can derive state from multiple observable model properties

package/dist/adapter.d.ts

@@ -0,0 +1,9 @@
+import type { ReactivityAdapter } from "@stratasync/core";
+export declare const mobxReactivityAdapter: ReactivityAdapter;
+/**
+ * Registers the MobX observable.box factory with sync-core's observability system.
+ * Call this to enable MobX reactivity for model properties without using the full adapter.
+ */
+export declare const initMobXObservability: () => void;
+export declare const createMobXReactivity: () => ReactivityAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAOV,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AA4J1B,eAAO,MAAM,qBAAqB,EAAE,iBA8CnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAO,IAExC,CAAC;AAEF,eAAO,MAAM,oBAAoB,QAAO,iBAGvC,CAAC"}

package/dist/adapter.js

@@ -0,0 +1,157 @@
+import { setBoxFactory } from "@stratasync/core";
+import { computed, makeObservable, observable, reaction, runInAction, } from "mobx";
+class MobXBox {
+    value;
+    constructor(initialValue) {
+        this.value = initialValue;
+        makeObservable(this, {
+            value: observable,
+        });
+    }
+    get() {
+        return this.value;
+    }
+    set(value) {
+        runInAction(() => {
+            this.value = value;
+        });
+    }
+}
+class MobXMap {
+    map;
+    constructor(entries) {
+        this.map = observable.map(entries ? new Map(entries) : undefined);
+    }
+    get(key) {
+        return this.map.get(key);
+    }
+    set(key, value) {
+        runInAction(() => {
+            this.map.set(key, value);
+        });
+    }
+    has(key) {
+        return this.map.has(key);
+    }
+    delete(key) {
+        return runInAction(() => this.map.delete(key));
+    }
+    clear() {
+        runInAction(() => {
+            this.map.clear();
+        });
+    }
+    keys() {
+        return this.map.keys();
+    }
+    values() {
+        return this.map.values();
+    }
+    entries() {
+        return this.map.entries();
+    }
+    get size() {
+        return this.map.size;
+    }
+    // oxlint-disable-next-line prefer-await-to-callbacks -- event listener registration
+    forEach(callback) {
+        // oxlint-disable-next-line no-array-for-each
+        this.map.forEach(callback);
+    }
+}
+class MobXArray {
+    array;
+    constructor(items) {
+        this.array = observable.array(items ?? []);
+    }
+    get(index) {
+        return this.array[index];
+    }
+    toArray() {
+        return [...this.array];
+    }
+    push(...items) {
+        return runInAction(() => this.array.push(...items));
+    }
+    pop() {
+        return runInAction(() => this.array.pop());
+    }
+    remove(predicate) {
+        return runInAction(() => {
+            const removed = [];
+            for (let i = this.array.length - 1; i >= 0; i -= 1) {
+                const item = this.array[i];
+                if (item !== undefined && predicate(item)) {
+                    removed.push(item);
+                    this.array.splice(i, 1);
+                }
+            }
+            return removed;
+        });
+    }
+    replace(items) {
+        runInAction(() => {
+            this.array.length = 0;
+            this.array.push(...items);
+        });
+    }
+    clear() {
+        runInAction(() => {
+            this.array.length = 0;
+        });
+    }
+    find(predicate) {
+        return this.array.find(predicate);
+    }
+    filter(predicate) {
+        return this.array.filter(predicate);
+    }
+    map(mapper) {
+        return this.array.map(mapper);
+    }
+    get length() {
+        return this.array.length;
+    }
+    [Symbol.iterator]() {
+        return this.array[Symbol.iterator]();
+    }
+}
+export const mobxReactivityAdapter = {
+    batch(fn) {
+        runInAction(fn);
+    },
+    computed(getter, _options) {
+        const c = computed(getter);
+        return { get: () => c.get() };
+    },
+    createArray(items, _options) {
+        return new MobXArray(items);
+    },
+    createBox(initialValue, _options) {
+        return new MobXBox(initialValue);
+    },
+    createMap(entries, _options) {
+        return new MobXMap(entries);
+    },
+    makeObservable(target, _options) {
+        return observable(target);
+    },
+    reaction(expression, effect, options) {
+        return reaction(expression, effect, options);
+    },
+    runInAction(fn) {
+        return runInAction(fn);
+    },
+};
+/**
+ * Registers the MobX observable.box factory with sync-core's observability system.
+ * Call this to enable MobX reactivity for model properties without using the full adapter.
+ */
+export const initMobXObservability = () => {
+    setBoxFactory((initialValue) => observable.box(initialValue));
+};
+export const createMobXReactivity = () => {
+    initMobXObservability();
+    return mobxReactivityAdapter;
+};
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

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

package/dist/computed-relations.d.ts

@@ -0,0 +1,35 @@
+import type { Model } from "@stratasync/core";
+/**
+ * Creates a MobX computed value that resolves a foreign key reference.
+ * The model must have a store attached.
+ *
+ * @example
+ * ```ts
+ * const team = computedReference<Team>(task, 'teamId', 'Team');
+ * const currentTeam = team.get();
+ * if (currentTeam) {
+ *   renderTeamName(currentTeam.name);
+ * }
+ * ```
+ */
+export declare const computedReference: <T>(model: Model, foreignKeyField: string, targetModelName: string) => {
+    get(): T | null;
+};
+/**
+ * Creates a MobX computed value for a reverse relation (one-to-many).
+ * Returns models of targetModelName where foreignKey matches model.id.
+ *
+ * Requires a `getAll` method on the store. If the store does not have `getAll`,
+ * the computed always returns an empty array.
+ *
+ * @example
+ * ```ts
+ * const comments = computedCollection<Comment>(task, 'Comment', 'taskId');
+ * const commentCount = comments.get().length;
+ * updateCommentBadge(commentCount);
+ * ```
+ */
+export declare const computedCollection: <T>(model: Model, targetModelName: string, foreignKey: string) => {
+    get(): T[];
+};
+//# sourceMappingURL=computed-relations.d.ts.map

package/dist/computed-relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computed-relations.d.ts","sourceRoot":"","sources":["../src/computed-relations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,EACjC,OAAO,KAAK,EACZ,iBAAiB,MAAM,EACvB,iBAAiB,MAAM,KACtB;IAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;CAOhB,CAAC;AAEL;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,EAClC,OAAO,KAAK,EACZ,iBAAiB,MAAM,EACvB,YAAY,MAAM,KACjB;IAAE,GAAG,IAAI,CAAC,EAAE,CAAA;CAYX,CAAC"}

package/dist/computed-relations.js

@@ -0,0 +1,44 @@
+import { computed } from "mobx";
+/**
+ * Creates a MobX computed value that resolves a foreign key reference.
+ * The model must have a store attached.
+ *
+ * @example
+ * ```ts
+ * const team = computedReference<Team>(task, 'teamId', 'Team');
+ * const currentTeam = team.get();
+ * if (currentTeam) {
+ *   renderTeamName(currentTeam.name);
+ * }
+ * ```
+ */
+export const computedReference = (model, foreignKeyField, targetModelName) => computed(() => {
+    const id = model.__data[foreignKeyField];
+    if (typeof id !== "string" || !model.store) {
+        return null;
+    }
+    return model.store.get(targetModelName, id) ?? null;
+});
+/**
+ * Creates a MobX computed value for a reverse relation (one-to-many).
+ * Returns models of targetModelName where foreignKey matches model.id.
+ *
+ * Requires a `getAll` method on the store. If the store does not have `getAll`,
+ * the computed always returns an empty array.
+ *
+ * @example
+ * ```ts
+ * const comments = computedCollection<Comment>(task, 'Comment', 'taskId');
+ * const commentCount = comments.get().length;
+ * updateCommentBadge(commentCount);
+ * ```
+ */
+export const computedCollection = (model, targetModelName, foreignKey) => computed(() => {
+    const store = model.store;
+    if (!store?.getAll) {
+        return [];
+    }
+    const all = store.getAll(targetModelName);
+    return all.filter((item) => item.__data[foreignKey] === model.id);
+});
+//# sourceMappingURL=computed-relations.js.map

package/dist/computed-relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computed-relations.js","sourceRoot":"","sources":["../src/computed-relations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEhC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,KAAY,EACZ,eAAuB,EACvB,eAAuB,EACF,EAAE,CACvB,QAAQ,CAAC,GAAG,EAAE;IACZ,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACzC,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAQ,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,CAAO,IAAI,IAAI,CAAC;AAC7D,CAAC,CAAC,CAAC;AAEL;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAAY,EACZ,eAAuB,EACvB,UAAkB,EACF,EAAE,CAClB,QAAQ,CAAC,GAAG,EAAE;IACZ,MAAM,KAAK,GAAG,KAAK,CAAC,KAIP,CAAC;IACd,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,eAAe,CAAkB,CAAC;IAC3D,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC;AACpE,CAAC,CAAC,CAAC"}

package/dist/dirty-tracking.d.ts

@@ -0,0 +1,14 @@
+import type { Model } from "@stratasync/core";
+export interface DirtyTracker {
+    /** Observable: true if any properties have been modified since last save/clear */
+    readonly isDirty: boolean;
+    /** Observable: set of property names that have been modified */
+    readonly modifiedFields: ReadonlySet<string>;
+    /** Observable: count of modified fields */
+    readonly modifiedCount: number;
+    /** Reset tracking */
+    clear(): void;
+}
+export declare const getDirtyTracker: (model: Model) => DirtyTracker | undefined;
+export declare const createDirtyTracker: (model: Model) => DirtyTracker;
+//# sourceMappingURL=dirty-tracking.d.ts.map

package/dist/dirty-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dirty-tracking.d.ts","sourceRoot":"","sources":["../src/dirty-tracking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7C,2CAA2C;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,qBAAqB;IACrB,KAAK,IAAI,IAAI,CAAC;CACf;AAKD,eAAO,MAAM,eAAe,GAAI,OAAO,KAAK,KAAG,YAAY,GAAG,SAG/C,CAAC;AAEhB,eAAO,MAAM,kBAAkB,GAAI,OAAO,KAAK,KAAG,YAuDjD,CAAC"}

package/dist/dirty-tracking.js

@@ -0,0 +1,51 @@
+import { computed, observable, runInAction } from "mobx";
+// Symbol to store tracker on model instances
+const DIRTY_TRACKER = Symbol.for("done:dirty-tracker");
+export const getDirtyTracker = (model) => model[DIRTY_TRACKER];
+export const createDirtyTracker = (model) => {
+    // Check if already attached
+    const existing = getDirtyTracker(model);
+    if (existing) {
+        return existing;
+    }
+    // Create an observable set to mirror modified property names
+    const fields = observable.set();
+    // Wrap markPropertyChanged to track fields.
+    // We wrap markPropertyChanged (not propertyChanged) so that _applyUpdate,
+    // which suppresses tracking via suppressTracking counter, does not mark dirty.
+    const originalMarkPropertyChanged = model.markPropertyChanged.bind(model);
+    model.markPropertyChanged = (name, oldValue, newValue) => {
+        originalMarkPropertyChanged(name, oldValue, newValue);
+        runInAction(() => {
+            fields.add(name);
+        });
+    };
+    // Wrap clearChanges to reset tracking
+    const originalClearChanges = model.clearChanges.bind(model);
+    model.clearChanges = () => {
+        originalClearChanges();
+        runInAction(() => {
+            fields.clear();
+        });
+    };
+    const isDirtyComputed = computed(() => fields.size > 0);
+    const modifiedCountComputed = computed(() => fields.size);
+    const tracker = {
+        clear() {
+            model.clearChanges();
+        },
+        get isDirty() {
+            return isDirtyComputed.get();
+        },
+        get modifiedCount() {
+            return modifiedCountComputed.get();
+        },
+        get modifiedFields() {
+            return fields;
+        },
+    };
+    // Attach to model
+    model[DIRTY_TRACKER] = tracker;
+    return tracker;
+};
+//# sourceMappingURL=dirty-tracking.js.map

package/dist/dirty-tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dirty-tracking.js","sourceRoot":"","sources":["../src/dirty-tracking.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAazD,6CAA6C;AAC7C,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAEvD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAY,EAA4B,EAAE,CACvE,KAA4C,CAAC,aAAa,CAE9C,CAAC;AAEhB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAY,EAAgB,EAAE;IAC/D,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,6DAA6D;IAC7D,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAU,CAAC;IAExC,4CAA4C;IAC5C,0EAA0E;IAC1E,+EAA+E;IAC/E,MAAM,2BAA2B,GAAG,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1E,KAAK,CAAC,mBAAmB,GAAG,CAC1B,IAAY,EACZ,QAAiB,EACjB,QAAiB,EACjB,EAAE;QACF,2BAA2B,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACtD,WAAW,CAAC,GAAG,EAAE;YACf,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,sCAAsC;IACtC,MAAM,oBAAoB,GAAG,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5D,KAAK,CAAC,YAAY,GAAG,GAAG,EAAE;QACxB,oBAAoB,EAAE,CAAC;QACvB,WAAW,CAAC,GAAG,EAAE;YACf,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IACxD,MAAM,qBAAqB,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE1D,MAAM,OAAO,GAAiB;QAC5B,KAAK;YACH,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,CAAC;QACD,IAAI,OAAO;YACT,OAAO,eAAe,CAAC,GAAG,EAAE,CAAC;QAC/B,CAAC;QACD,IAAI,aAAa;YACf,OAAO,qBAAqB,CAAC,GAAG,EAAE,CAAC;QACrC,CAAC;QACD,IAAI,cAAc;YAChB,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;IAEF,kBAAkB;IACjB,KAA4C,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC;IACvE,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { Model, makeObservableProperty, makeReferenceModelProperty, } from "@stratasync/core";
+export { createMobXReactivity, mobxReactivityAdapter } from "./adapter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+// biome-ignore lint/performance/noBarrelFile: package entry point
+export { Model, makeObservableProperty, makeReferenceModelProperty, } from "@stratasync/core";
+export { createMobXReactivity, mobxReactivityAdapter } from "./adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,OAAO,EACL,KAAK,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/model-utils.d.ts

@@ -0,0 +1,24 @@
+import type { Model } from "@stratasync/core";
+/**
+ * Returns a plain JavaScript object from a model instance.
+ * Copies all __data properties plus the id.
+ * Useful when spread operator doesn't copy prototype getters.
+ */
+export declare const toPlainObject: <T extends Model>(model: T) => Record<string, unknown>;
+/**
+ * Creates a shallow clone of a model's data for comparison or form editing.
+ */
+export declare const cloneModelData: <T extends Model>(model: T) => Record<string, unknown>;
+/**
+ * Compares two model instances' data and returns changed fields.
+ */
+export declare const diffModels: <T extends Model>(a: T, b: T) => Record<string, {
+    old: unknown;
+    new: unknown;
+}>;
+/**
+ * Returns true if the model has any unsaved changes.
+ * Reads from the DirtyTracker if one is attached, otherwise falls back to changeSnapshot().
+ */
+export declare const isModelDirty: (model: Model) => boolean;
+//# sourceMappingURL=model-utils.d.ts.map

package/dist/model-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-utils.d.ts","sourceRoot":"","sources":["../src/model-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,KAAK,EAC3C,OAAO,CAAC,KACP,MAAM,CAAC,MAAM,EAAE,OAAO,CAOxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,KAAK,EAC5C,OAAO,CAAC,KACP,MAAM,CAAC,MAAM,EAAE,OAAO,CAAkC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,KAAK,EACxC,GAAG,CAAC,EACJ,GAAG,CAAC,KACH,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAW/C,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,KAAG,OAS3C,CAAC"}

package/dist/model-utils.js

@@ -0,0 +1,46 @@
+/**
+ * Returns a plain JavaScript object from a model instance.
+ * Copies all __data properties plus the id.
+ * Useful when spread operator doesn't copy prototype getters.
+ */
+export const toPlainObject = (model) => {
+    const result = { id: model.id };
+    const data = model.__data;
+    for (const key of Object.keys(data)) {
+        result[key] = data[key];
+    }
+    return result;
+};
+/**
+ * Creates a shallow clone of a model's data for comparison or form editing.
+ */
+export const cloneModelData = (model) => ({ ...toPlainObject(model) });
+/**
+ * Compares two model instances' data and returns changed fields.
+ */
+export const diffModels = (a, b) => {
+    const result = {};
+    const aData = a.__data;
+    const bData = b.__data;
+    const allKeys = new Set([...Object.keys(aData), ...Object.keys(bData)]);
+    for (const key of allKeys) {
+        if (aData[key] !== bData[key]) {
+            result[key] = { new: bData[key], old: aData[key] };
+        }
+    }
+    return result;
+};
+const DIRTY_TRACKER_SYMBOL = Symbol.for("done:dirty-tracker");
+/**
+ * Returns true if the model has any unsaved changes.
+ * Reads from the DirtyTracker if one is attached, otherwise falls back to changeSnapshot().
+ */
+export const isModelDirty = (model) => {
+    const tracker = model[DIRTY_TRACKER_SYMBOL];
+    if (tracker) {
+        return tracker.isDirty;
+    }
+    const snapshot = model.changeSnapshot();
+    return Object.keys(snapshot.changes).length > 0;
+};
+//# sourceMappingURL=model-utils.js.map

package/dist/model-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-utils.js","sourceRoot":"","sources":["../src/model-utils.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,KAAQ,EACiB,EAAE;IAC3B,MAAM,MAAM,GAA4B,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;IACzD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,KAAQ,EACiB,EAAE,CAAC,CAAC,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,CAAI,EACJ,CAAI,EAC4C,EAAE;IAClD,MAAM,MAAM,GAAmD,EAAE,CAAC;IAClE,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;IACvB,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;IACvB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxE,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAY,EAAW,EAAE;IACpD,MAAM,OAAO,GAAI,KAA4C,CAC3D,oBAAoB,CACe,CAAC;IACtC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC,OAAO,CAAC;IACzB,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;IACxC,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AAClD,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@stratasync/mobx",
+  "version": "0.2.0",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc --watch -p tsconfig.build.json",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
+    "format": "oxfmt --write .",
+    "format:check": "oxfmt --check .",
+    "check-types": "tsc --noEmit",
+    "test": "vitest"
+  },
+  "dependencies": {
+    "@stratasync/core": "*",
+    "mobx": "^6.0.0"
+  },
+  "devDependencies": {
+    "lefthook": "^2.1.4",
+    "oxfmt": "^0.41.0",
+    "oxlint": "^1.56.0",
+    "typescript": "^5.9.3",
+    "ultracite": "^7.3.2",
+    "vitest": "^4.1.0"
+  },
+  "peerDependencies": {
+    "mobx": "^6.0.0"
+  }
+}