@homeostate/core 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aliaksandr Mialeshka
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# @homeostate/core
+
+> **Draft / placeholder release.** `0.0.0` reserves the name while the API is still
+> being designed. Nothing here is stable — do not depend on it yet.
+
+State-manager agnostic sync engine between a store adapter and a [Yjs](https://github.com/yjs/yjs) document.
+
+## Install
+
+```bash
+npm install @homeostate/core yjs
+```
+
+`yjs` is a peer dependency.
+
+## Usage
+
+```ts
+import { createSyncEngine } from '@homeostate/core';
+```
+
+See the [repository](https://github.com/mixedrays/homeostate) for the full workspace,
+store adapters, and a runnable playground.
+
+## License
+
+MIT — see [LICENSE](./LICENSE). Includes code derived from
+[zustand-middleware-yjs](https://github.com/joebobmiles/zustand-middleware-yjs);
+see [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md).

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,33 @@
+# Third-Party Notices
+
+## zustand-middleware-yjs
+
+`@homeostate/core` includes code derived from
+[zustand-middleware-yjs](https://github.com/joebobmiles/zustand-middleware-yjs).
+
+Copyright (c) 2021 Joseph R Miles
+
+The upstream project is licensed under the MIT License:
+
+```text
+The MIT License (MIT)
+
+Copyright (c) 2021 Joseph R Miles
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```

package/dist/change.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Describes the change that needs to be made.
+ */
+export declare enum ChangeType {
+    /** No change. */
+    NONE = "none",
+    /** A value was inserted. */
+    INSERT = "insert",
+    /** A value was replaced. */
+    UPDATE = "update",
+    /** A value was deleted. */
+    DELETE = "delete",
+    /** The value requires a recursive diff to identify further changes. */
+    PENDING = "pending"
+}
+/**
+ * A record that documents a change to an entry in an array or object.
+ */
+export type Change = [ChangeType, string | number, unknown];
+//# sourceMappingURL=change.d.ts.map

package/dist/change.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change.d.ts","sourceRoot":"","sources":["../src/change.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,UAAU;IACpB,iBAAiB;IACjB,IAAI,SAAS;IACb,4BAA4B;IAC5B,MAAM,WAAW;IACjB,4BAA4B;IAC5B,MAAM,WAAW;IACjB,2BAA2B;IAC3B,MAAM,WAAW;IACjB,uEAAuE;IACvE,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/change.js

@@ -0,0 +1,17 @@
+/**
+ * Describes the change that needs to be made.
+ */
+export var ChangeType;
+(function (ChangeType) {
+    /** No change. */
+    ChangeType["NONE"] = "none";
+    /** A value was inserted. */
+    ChangeType["INSERT"] = "insert";
+    /** A value was replaced. */
+    ChangeType["UPDATE"] = "update";
+    /** A value was deleted. */
+    ChangeType["DELETE"] = "delete";
+    /** The value requires a recursive diff to identify further changes. */
+    ChangeType["PENDING"] = "pending";
+})(ChangeType || (ChangeType = {}));
+//# sourceMappingURL=change.js.map

package/dist/change.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change.js","sourceRoot":"","sources":["../src/change.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,UAWX;AAXD,WAAY,UAAU;IACpB,iBAAiB;IACjB,2BAAa,CAAA;IACb,4BAA4B;IAC5B,+BAAiB,CAAA;IACjB,4BAA4B;IAC5B,+BAAiB,CAAA;IACjB,2BAA2B;IAC3B,+BAAiB,CAAA;IACjB,uEAAuE;IACvE,iCAAmB,CAAA;AACrB,CAAC,EAXW,UAAU,KAAV,UAAU,QAWrB"}

package/dist/diff.d.ts

@@ -0,0 +1,5 @@
+import { type Change } from './change.js';
+type Diffable = Record<string, unknown> | Array<unknown> | string;
+export declare const getChanges: (a: Diffable, b: Diffable) => Change[];
+export {};
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAEtD,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC;AAYlE,eAAO,MAAM,UAAU,GAAI,GAAG,QAAQ,EAAE,GAAG,QAAQ,KAAG,MAAM,EAK3D,CAAC"}

package/dist/diff.js

@@ -0,0 +1,202 @@
+import { ChangeType } from './change.js';
+const isDiffable = (v) => isArray(v) || isString(v) || (v !== null && typeof v === 'object');
+const isArray = (d) => d instanceof Array;
+const isString = (d) => typeof d === 'string';
+const isRecord = (d) => !isArray(d) && !isString(d);
+export const getChanges = (a, b) => {
+    if (isString(a) && isString(b))
+        return getStringChanges(a, b);
+    else if (isArray(a) && isArray(b))
+        return getArrayChanges(a, b);
+    else if (isRecord(a) && isRecord(b))
+        return getRecordChanges(a, b);
+    else
+        return [];
+};
+const getStringChanges = (a, b) => {
+    if (a === b)
+        return [];
+    else if (a.length === 0) {
+        return b
+            .split('')
+            .map((character, index) => [ChangeType.INSERT, index, character]);
+    }
+    else if (b.length === 0) {
+        return a.split('').map(() => [ChangeType.DELETE, 0, undefined]);
+    }
+    else if (!hasCommonSubsequence(a, b)) {
+        const deletes = a
+            .split('')
+            .map(() => [ChangeType.DELETE, 0, undefined]);
+        const inserts = b
+            .split('')
+            .map((character, index) => [ChangeType.INSERT, index, character]);
+        return deletes.concat(inserts);
+    }
+    else {
+        const m = a.length, n = b.length;
+        const reverse = m >= n;
+        return reverse ? _diffText(b, a, reverse) : _diffText(a, b, reverse);
+    }
+};
+const getArrayChanges = (a, b) => {
+    const changeList = [];
+    let finalIndices = 0;
+    let bOffset = 0;
+    for (let index = 0; index < a.length; index++) {
+        const value = a[index];
+        const bIndex = index + bOffset;
+        if (b[bIndex] === undefined)
+            changeList.push([ChangeType.DELETE, index, undefined]);
+        else if (isDiffable(value) && isDiffable(b[bIndex])) {
+            const currentDiff = getChanges(value, b[bIndex]);
+            const nextDiff = typeof b[bIndex + 1] === 'undefined'
+                ? []
+                : getChanges(value, b[bIndex + 1]);
+            if (typeof b[bIndex + 1] !== 'undefined' && nextDiff.length === 0) {
+                changeList.push([ChangeType.INSERT, index, b[bIndex]]);
+                finalIndices += 2;
+                bOffset++;
+            }
+            else if (currentDiff.length !== 0) {
+                changeList.push([ChangeType.PENDING, index, currentDiff]);
+                finalIndices++;
+            }
+            else
+                finalIndices++;
+        }
+        else if (value !== b[bIndex] && value === b[bIndex + 1]) {
+            changeList.push([ChangeType.INSERT, bIndex, b[bIndex]]);
+            finalIndices += 2;
+            bOffset++;
+        }
+        else if (value !== b[bIndex] && value !== b[bIndex + 1]) {
+            changeList.push([ChangeType.UPDATE, bIndex, b[bIndex]]);
+            finalIndices++;
+        }
+        else
+            finalIndices++;
+    }
+    if (finalIndices < b.length) {
+        b.slice(a.length).forEach((value, index) => changeList.push([ChangeType.INSERT, finalIndices + index, value]));
+    }
+    return changeList;
+};
+const getRecordChanges = (a, b) => {
+    const changeList = [];
+    Object.entries(a).forEach(([property, value]) => {
+        if (!(property in b) && !(value instanceof Function))
+            changeList.push([ChangeType.DELETE, property, undefined]);
+    });
+    Object.entries(b).forEach(([property, value]) => {
+        if (!(property in a))
+            changeList.push([ChangeType.INSERT, property, value]);
+        else if (isDiffable(a[property]) && isDiffable(value)) {
+            const d = getChanges(a[property], value);
+            if (d.length !== 0)
+                changeList.push([ChangeType.PENDING, property, d]);
+        }
+        else if (a[property] !== value)
+            changeList.push([ChangeType.UPDATE, property, value]);
+    });
+    return changeList;
+};
+const hasCommonSubsequence = (a, b) => {
+    const alphabetOfA = a.split('');
+    const alphabetOfB = b.split('');
+    let hasCommonSubsequence = false;
+    for (const c of alphabetOfA)
+        hasCommonSubsequence = hasCommonSubsequence || alphabetOfB.includes(c);
+    return hasCommonSubsequence;
+};
+/**
+ * An adaptation of Wu et al. O(NP) text diff. (See docs/text-diff)
+ *
+ * Credit to [this JavaScript implementation](https://github.com/cubicdaiya/onp/blob/master/javascript/onp.js).
+ *
+ * @param a The old string to transform.
+ * @param b The new string to transform to.
+ * @param isReversed Whether or not a or b have been swapped.
+ * @returns A list of changes that that turn a into b.
+ */
+const _diffText = (a, b, isReversed) => {
+    const m = a.length, n = b.length;
+    const offset = m;
+    const delta = n - m;
+    const size = m + n + 1;
+    const frontierPoints = [];
+    for (let i = 0; i < size; i++)
+        frontierPoints[i] = -1;
+    const path = [];
+    for (let i = 0; i < size; i++)
+        path[i] = -1;
+    const pathPositions = [];
+    const snake = (k, p, q) => {
+        let y = Math.max(p, q);
+        let x = y - k;
+        while (x < m && y < n && a[x] === b[y]) {
+            x++;
+            y++;
+        }
+        path[k + offset] = pathPositions.length;
+        pathPositions[pathPositions.length] = {
+            x: x,
+            y: y,
+            k: p > q ? path[k + offset - 1] : path[k + offset + 1],
+        };
+        return y;
+    };
+    let p = -1;
+    do {
+        p++;
+        for (let k = -p; k < delta; k++) {
+            frontierPoints[k + offset] = snake(k, frontierPoints[k + offset - 1] + 1, frontierPoints[k + offset + 1]);
+        }
+        for (let k = delta + p; k > delta; k--) {
+            frontierPoints[k + offset] = snake(k, frontierPoints[k + offset - 1] + 1, frontierPoints[k + offset + 1]);
+        }
+        frontierPoints[delta + offset] = snake(delta, frontierPoints[delta + offset - 1] + 1, frontierPoints[delta + offset + 1]);
+    } while (frontierPoints[delta + offset] !== n);
+    let k = path[delta + offset];
+    const editPath = [];
+    while (k !== -1) {
+        editPath[editPath.length] = {
+            x: pathPositions[k].x,
+            y: pathPositions[k].y,
+        };
+        k = pathPositions[k].k;
+    }
+    const changeList = [];
+    let x = 0, y = 0, index = -1;
+    for (let i = editPath.length - 1; i >= 0; i--) {
+        while (x <= editPath[i].x || y <= editPath[i].y) {
+            if (editPath[i].y - editPath[i].x > y - x) {
+                if (isReversed) {
+                    changeList[changeList.length] = [ChangeType.DELETE, index, undefined];
+                }
+                else {
+                    changeList[changeList.length] = [ChangeType.INSERT, index, b[y - 1]];
+                    index++;
+                }
+                y++;
+            }
+            else if (editPath[i].y - editPath[i].x < y - x) {
+                if (isReversed) {
+                    changeList[changeList.length] = [ChangeType.INSERT, index, a[x - 1]];
+                    index++;
+                }
+                else {
+                    changeList[changeList.length] = [ChangeType.DELETE, index, undefined];
+                }
+                x++;
+            }
+            else {
+                x++;
+                y++;
+                index++;
+            }
+        }
+    }
+    return changeList;
+};
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createSyncEngine } from './sync-engine.js';
+export { defaultSyncFilter } from './types.js';
+export type { StoreAdapter, SyncEngine, SyncEngineConfig, Unsubscribe, } from './types.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":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EACV,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createSyncEngine } from './sync-engine.js';
+export { defaultSyncFilter } from './types.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,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/mapping.d.ts

@@ -0,0 +1,19 @@
+import * as Y from 'yjs';
+/**
+ * Converts a normal JavaScript array to a YArray shared type. Any nested
+ * objects or arrays are turned into YMaps and YArrays, respectively.
+ *
+ * @param array The array to transform into a YArray
+ * @returns A YArray.
+ */
+export declare const arrayToYArray: (array: unknown[]) => Y.Array<unknown>;
+/**
+ * Converts a normal JavaScript object into a YMap shared type. Any nested
+ * objects or arrays are turned into YMaps or YArrays, respectively.
+ *
+ * @param object The object to turn into a YMap shared type.
+ * @returns A YMap.
+ */
+export declare const objectToYMap: (object: Record<string, unknown>) => Y.Map<unknown>;
+export declare const stringToYText: (string: string) => Y.Text;
+//# sourceMappingURL=mapping.d.ts.map

package/dist/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,EAAE,KAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAW/D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAW3E,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,KAAG,CAAC,CAAC,IAA0B,CAAC"}

package/dist/mapping.js

@@ -0,0 +1,45 @@
+import * as Y from 'yjs';
+/**
+ * Converts a normal JavaScript array to a YArray shared type. Any nested
+ * objects or arrays are turned into YMaps and YArrays, respectively.
+ *
+ * @param array The array to transform into a YArray
+ * @returns A YArray.
+ */
+export const arrayToYArray = (array) => {
+    const yarray = new Y.Array();
+    array.forEach((value) => {
+        if (value instanceof Array)
+            yarray.push([arrayToYArray(value)]);
+        else if (value !== null && typeof value === 'object')
+            yarray.push([objectToYMap(value)]);
+        else if (typeof value === 'string')
+            yarray.push([stringToYText(value)]);
+        else
+            yarray.push([value]);
+    });
+    return yarray;
+};
+/**
+ * Converts a normal JavaScript object into a YMap shared type. Any nested
+ * objects or arrays are turned into YMaps or YArrays, respectively.
+ *
+ * @param object The object to turn into a YMap shared type.
+ * @returns A YMap.
+ */
+export const objectToYMap = (object) => {
+    const ymap = new Y.Map();
+    Object.entries(object).forEach(([property, value]) => {
+        if (value instanceof Array)
+            ymap.set(property, arrayToYArray(value));
+        else if (value !== null && typeof value === 'object')
+            ymap.set(property, objectToYMap(value));
+        else if (typeof value === 'string')
+            ymap.set(property, stringToYText(value));
+        else
+            ymap.set(property, value);
+    });
+    return ymap;
+};
+export const stringToYText = (string) => new Y.Text(string);
+//# sourceMappingURL=mapping.js.map

package/dist/mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.js","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAgB,EAAoB,EAAE;IAClE,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;IAE7B,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACtB,IAAI,KAAK,YAAY,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aAC3D,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,KAAgC,CAAC,CAAC,CAAC,CAAC;aAC/G,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;;YACnE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAA+B,EAAkB,EAAE;IAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;IAEzB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE;QACnD,IAAI,KAAK,YAAY,KAAK;YAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;aAChE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,KAAgC,CAAC,CAAC,CAAC;aACpH,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;;YACxE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC"}

package/dist/patching.d.ts

@@ -0,0 +1,23 @@
+import * as Y from 'yjs';
+/**
+ * Diffs sharedType and newState to create a list of changes for transforming
+ * the contents of sharedType into that of newState. For every nested, 'pending'
+ * change detected, this function recurses, as a nested object or array is
+ * represented as a Y.Map or Y.Array.
+ *
+ * @param sharedType The Yjs shared type to patch.
+ * @param newState The new state to patch the shared type into.
+ */
+export declare const patchSharedType: (sharedType: Y.Map<unknown> | Y.Array<unknown> | Y.Text, newState: unknown) => void;
+/**
+ * Patches oldState to be identical to newState. This function recurses when
+ * an array or object is encountered. If oldState and newState are already
+ * identical (indicated by an empty diff), then oldState is returned.
+ *
+ * @param oldState The state we want to patch.
+ * @param newState The state we want oldState to match after patching.
+ *
+ * @returns The patched oldState, identical to newState.
+ */
+export declare const patchState: <T>(oldState: T, newState: T) => T;
+//# sourceMappingURL=patching.d.ts.map

package/dist/patching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patching.d.ts","sourceRoot":"","sources":["../src/patching.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAKzB;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAC1B,YAAY,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EACtD,UAAU,OAAO,KAChB,IAmEF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,KAAG,CA+GxD,CAAC"}

package/dist/patching.js

@@ -0,0 +1,159 @@
+import * as Y from 'yjs';
+import { ChangeType } from './change.js';
+import { getChanges } from './diff.js';
+import { arrayToYArray, objectToYMap, stringToYText } from './mapping.js';
+/**
+ * Diffs sharedType and newState to create a list of changes for transforming
+ * the contents of sharedType into that of newState. For every nested, 'pending'
+ * change detected, this function recurses, as a nested object or array is
+ * represented as a Y.Map or Y.Array.
+ *
+ * @param sharedType The Yjs shared type to patch.
+ * @param newState The new state to patch the shared type into.
+ */
+export const patchSharedType = (sharedType, newState) => {
+    const changes = getChanges(sharedType.toJSON(), newState);
+    changes.forEach(([type, property, value]) => {
+        switch (type) {
+            case ChangeType.INSERT:
+            case ChangeType.UPDATE:
+                if (value instanceof Function === false) {
+                    if (sharedType instanceof Y.Map) {
+                        if (typeof value === 'string')
+                            sharedType.set(property, stringToYText(value));
+                        else if (value instanceof Array)
+                            sharedType.set(property, arrayToYArray(value));
+                        else if (value instanceof Object)
+                            sharedType.set(property, objectToYMap(value));
+                        else
+                            sharedType.set(property, value);
+                    }
+                    else if (sharedType instanceof Y.Array) {
+                        const index = property;
+                        if (type === ChangeType.UPDATE)
+                            sharedType.delete(index);
+                        if (typeof value === 'string')
+                            sharedType.insert(index, [stringToYText(value)]);
+                        else if (value instanceof Array)
+                            sharedType.insert(index, [arrayToYArray(value)]);
+                        else if (value instanceof Object)
+                            sharedType.insert(index, [objectToYMap(value)]);
+                        else
+                            sharedType.insert(index, [value]);
+                    }
+                    else if (sharedType instanceof Y.Text)
+                        sharedType.insert(property, value);
+                }
+                break;
+            case ChangeType.DELETE:
+                if (sharedType instanceof Y.Map)
+                    sharedType.delete(property);
+                else if (sharedType instanceof Y.Array) {
+                    const index = property;
+                    sharedType.delete(sharedType.length <= index ? sharedType.length - 1 : index);
+                }
+                else if (sharedType instanceof Y.Text)
+                    // A delete operation for text is only ever for a single character.
+                    sharedType.delete(property, 1);
+                break;
+            case ChangeType.PENDING:
+                if (sharedType instanceof Y.Map) {
+                    patchSharedType(sharedType.get(property), newState[property]);
+                }
+                else if (sharedType instanceof Y.Array) {
+                    patchSharedType(sharedType.get(property), newState[property]);
+                }
+                break;
+            default:
+                break;
+        }
+    });
+};
+/**
+ * Patches oldState to be identical to newState. This function recurses when
+ * an array or object is encountered. If oldState and newState are already
+ * identical (indicated by an empty diff), then oldState is returned.
+ *
+ * @param oldState The state we want to patch.
+ * @param newState The state we want oldState to match after patching.
+ *
+ * @returns The patched oldState, identical to newState.
+ */
+export const patchState = (oldState, newState) => {
+    const changes = getChanges(oldState, newState);
+    const applyChanges = (state, changes) => {
+        if (typeof state === 'string')
+            return applyChangesToString(state, changes);
+        else if (state instanceof Array)
+            return applyChangesToArray(state, changes);
+        else if (state instanceof Object)
+            return applyChangesToObject(state, changes);
+    };
+    const applyChangesToArray = (array, changes) => changes
+        .sort(([, indexA], [, indexB]) => Math.sign(indexA - indexB))
+        .reduce((revisedArray, [type, index, value]) => {
+        switch (type) {
+            case ChangeType.INSERT: {
+                revisedArray.splice(index, 0, value);
+                return revisedArray;
+            }
+            case ChangeType.UPDATE: {
+                revisedArray[index] = value;
+                return revisedArray;
+            }
+            case ChangeType.PENDING: {
+                revisedArray[index] = applyChanges(array[index], value);
+                return revisedArray;
+            }
+            case ChangeType.DELETE: {
+                revisedArray.splice(index, 1);
+                return revisedArray;
+            }
+            case ChangeType.NONE:
+            default:
+                return revisedArray;
+        }
+    }, array);
+    const applyChangesToObject = (object, changes) => changes.reduce((revisedObject, [type, property, value]) => {
+        switch (type) {
+            case ChangeType.INSERT:
+            case ChangeType.UPDATE: {
+                revisedObject[property] = value;
+                return revisedObject;
+            }
+            case ChangeType.PENDING: {
+                revisedObject[property] = applyChanges(object[property], value);
+                return revisedObject;
+            }
+            case ChangeType.DELETE: {
+                delete revisedObject[property];
+                return revisedObject;
+            }
+            case ChangeType.NONE:
+            default:
+                return revisedObject;
+        }
+    }, object);
+    const applyChangesToString = (string, changes) => changes.reduce((revisedString, [type, index, value]) => {
+        switch (type) {
+            case ChangeType.INSERT: {
+                const left = revisedString.slice(0, index);
+                const right = revisedString.slice(index);
+                return left + value + right;
+            }
+            case ChangeType.DELETE: {
+                const left = revisedString.slice(0, index);
+                const right = revisedString.slice(index + 1);
+                return left + right;
+            }
+            default: {
+                return revisedString;
+            }
+        }
+    }, string);
+    if (changes.length === 0)
+        return oldState;
+    else
+        return applyChanges(oldState, changes);
+};
+//# sourceMappingURL=patching.js.map

package/dist/patching.js.map

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

package/dist/sync-engine.d.ts

@@ -0,0 +1,18 @@
+import * as Y from 'yjs';
+import type { StoreAdapter, SyncEngine, SyncEngineConfig } from './types.js';
+/**
+ * Creates a sync engine that manages bidirectional synchronization
+ * between any store (via adapter) and a Yjs document.
+ *
+ * This is the core abstraction that makes the sync logic state-manager agnostic.
+ *
+ * @example
+ * ```typescript
+ * const doc = new Y.Doc();
+ * const adapter = new ZustandAdapter(store);
+ * const engine = createSyncEngine(doc, adapter, { name: 'shared' });
+ * engine.connect();
+ * ```
+ */
+export declare function createSyncEngine<S>(doc: Y.Doc, adapter: StoreAdapter<S>, config: SyncEngineConfig): SyncEngine;
+//# sourceMappingURL=sync-engine.d.ts.map

package/dist/sync-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-engine.d.ts","sourceRoot":"","sources":["../src/sync-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,GAAG,EAAE,CAAC,CAAC,GAAG,EACV,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,MAAM,EAAE,gBAAgB,GACvB,UAAU,CAiJZ"}

package/dist/sync-engine.js

@@ -0,0 +1,137 @@
+import { defaultSyncFilter } from './types.js';
+import { patchSharedType, patchState } from './patching.js';
+/**
+ * Creates a sync engine that manages bidirectional synchronization
+ * between any store (via adapter) and a Yjs document.
+ *
+ * This is the core abstraction that makes the sync logic state-manager agnostic.
+ *
+ * @example
+ * ```typescript
+ * const doc = new Y.Doc();
+ * const adapter = new ZustandAdapter(store);
+ * const engine = createSyncEngine(doc, adapter, { name: 'shared' });
+ * engine.connect();
+ * ```
+ */
+export function createSyncEngine(doc, adapter, config) {
+    const { name, filter = defaultSyncFilter } = config;
+    // The root Y.Map that the store is written and read from
+    const yMap = doc.getMap(name);
+    let connected = false;
+    let storeUnsubscribe = null;
+    let isUpdatingFromYjs = false;
+    let isUpdatingFromStore = false;
+    /**
+     * Filter state to only include syncable properties
+     */
+    const filterState = (state) => {
+        if (typeof state !== 'object' || state === null) {
+            return state;
+        }
+        const filtered = {};
+        for (const [key, value] of Object.entries(state)) {
+            if (filter(key, value)) {
+                filtered[key] = value;
+            }
+        }
+        return filtered;
+    };
+    /**
+     * Sync store state to Yjs
+     */
+    const syncToYjs = () => {
+        if (isUpdatingFromYjs)
+            return;
+        isUpdatingFromStore = true;
+        try {
+            const state = adapter.getState();
+            const filteredState = filterState(state);
+            doc.transact(() => {
+                patchSharedType(yMap, filteredState);
+            });
+        }
+        finally {
+            isUpdatingFromStore = false;
+        }
+    };
+    /**
+     * Sync Yjs state to store
+     */
+    const syncToStore = () => {
+        if (isUpdatingFromStore)
+            return;
+        isUpdatingFromYjs = true;
+        try {
+            const yjsState = yMap.toJSON();
+            const currentState = adapter.getState();
+            // Merge Yjs state with current state (preserving functions and non-synced props)
+            const mergedState = mergeStates(currentState, yjsState);
+            adapter.setState(mergedState, true);
+        }
+        finally {
+            isUpdatingFromYjs = false;
+        }
+    };
+    /**
+     * Merge Yjs state with current store state, preserving non-syncable properties
+     */
+    const mergeStates = (current, fromYjs) => {
+        if (typeof current !== 'object' || current === null) {
+            return fromYjs;
+        }
+        const currentObj = current;
+        const yjsObj = fromYjs;
+        // Start with current state (preserves functions, etc.)
+        const merged = { ...currentObj };
+        // Apply Yjs state using patching for proper deep merging
+        const patchedData = patchState({ ...merged }, yjsObj);
+        // Restore non-syncable properties (like functions)
+        for (const [key, value] of Object.entries(currentObj)) {
+            if (!filter(key, value)) {
+                patchedData[key] = value;
+            }
+        }
+        return patchedData;
+    };
+    /**
+     * Handler for Yjs changes
+     */
+    const handleYjsChange = () => {
+        syncToStore();
+    };
+    return {
+        connect: () => {
+            if (connected)
+                return;
+            // Initialize Yjs with current store state
+            const initialState = adapter.getInitialState();
+            const filteredInitial = filterState(initialState);
+            doc.transact(() => {
+                patchSharedType(yMap, filteredInitial);
+            });
+            // Subscribe to Yjs changes
+            yMap.observeDeep(handleYjsChange);
+            // Subscribe to store changes
+            storeUnsubscribe = adapter.subscribe(() => {
+                syncToYjs();
+            });
+            connected = true;
+        },
+        disconnect: () => {
+            if (!connected)
+                return;
+            // Unsubscribe from Yjs
+            yMap.unobserveDeep(handleYjsChange);
+            // Unsubscribe from store
+            if (storeUnsubscribe) {
+                storeUnsubscribe();
+                storeUnsubscribe = null;
+            }
+            connected = false;
+        },
+        getYMap: () => yMap,
+        isConnected: () => connected,
+    };
+}
+//# sourceMappingURL=sync-engine.js.map

package/dist/sync-engine.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Core types for the state-manager agnostic Yjs sync engine.
+ * These interfaces allow any store manager to be connected to Yjs for P2P sync.
+ */
+/**
+ * Unsubscribe function returned by subscribe
+ */
+export type Unsubscribe = () => void;
+/**
+ * Adapter interface that bridges a specific state manager with the sync engine.
+ * Implement this interface to add support for any state manager (Zustand, Redux, MobX, etc.)
+ */
+export interface StoreAdapter<S> {
+    /** Get the current state from the store */
+    getState: () => S;
+    /**
+     * Set state in the store.
+     * @param state - New state to set
+     * @param fromSync - If true, this update came from Yjs sync and should not trigger sync back
+     */
+    setState: (state: S, fromSync?: boolean) => void;
+    /**
+     * Subscribe to store changes that should trigger Yjs sync.
+     * @returns Unsubscribe function
+     */
+    subscribe: (onStoreChange: () => void) => Unsubscribe;
+    /** Get the initial state of the store */
+    getInitialState: () => S;
+}
+/**
+ * Configuration options for the sync engine
+ */
+export interface SyncEngineConfig {
+    /** Name of the Y.Map in the Y.Doc to store the state */
+    name: string;
+    /**
+     * Filter function to determine which state keys should be synced.
+     * Return true to sync the key, false to exclude it.
+     * By default, functions are excluded from sync.
+     */
+    filter?: (key: string, value: unknown) => boolean;
+}
+/**
+ * The sync engine interface - manages bidirectional sync between store and Yjs
+ */
+export interface SyncEngine {
+    /** Start synchronization */
+    connect: () => void;
+    /** Stop synchronization and cleanup */
+    disconnect: () => void;
+    /** Get the underlying Y.Map */
+    getYMap: () => unknown;
+    /** Check if engine is connected */
+    isConnected: () => boolean;
+}
+/**
+ * Default filter that excludes functions from sync
+ */
+export declare const defaultSyncFilter: (_key: string, value: unknown) => boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC,CAAC;IAElB;;;;OAIG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAEjD;;;OAGG;IACH,SAAS,EAAE,CAAC,aAAa,EAAE,MAAM,IAAI,KAAK,WAAW,CAAC;IAEtD,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,uCAAuC;IACvC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,mCAAmC;IACnC,WAAW,EAAE,MAAM,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,OAAO,OAAO,KAAG,OAEhE,CAAC"}

package/dist/types.js

@@ -0,0 +1,11 @@
+/**
+ * Core types for the state-manager agnostic Yjs sync engine.
+ * These interfaces allow any store manager to be connected to Yjs for P2P sync.
+ */
+/**
+ * Default filter that excludes functions from sync
+ */
+export const defaultSyncFilter = (_key, value) => {
+    return typeof value !== 'function';
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4DH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAE,KAAc,EAAW,EAAE;IACzE,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@homeostate/core",
+  "version": "0.0.0",
+  "description": "State-manager agnostic sync engine between a store adapter and a Yjs document",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mixedrays/homeostate.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/mixedrays/homeostate#readme",
+  "bugs": {
+    "url": "https://github.com/mixedrays/homeostate/issues"
+  },
+  "keywords": [
+    "yjs",
+    "crdt",
+    "sync",
+    "state-management",
+    "collaborative"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "yjs": "^13.6.0"
+  },
+  "devDependencies": {
+    "yjs": "^13.6.23"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  }
+}