@ifc-lite/collab 0.2.0

package/dist/snapshot/layers.js

@@ -0,0 +1,82 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import * as Y from 'yjs';
+import { createCollabDoc } from '../doc/schema.js';
+import { snapshotToIfcx } from './to-ifcx.js';
+/**
+ * Capture a baseline state vector. Composed-with-baseline IFCX layer
+ * composition is the v0.7 mode; for v0.1 we still expose this so callers
+ * can pin a "before" point for downstream tooling.
+ */
+export function captureBaseline(doc) {
+    return Y.encodeStateVector(doc);
+}
+/**
+ * Extract a per-user IFCX layer from `doc`.
+ *
+ * Replays `doc`'s full state filtered by `clientId` onto a fresh doc and
+ * snapshots that. The resulting IFCX is a complete description of every
+ * entity the chosen client touched, with that client's view of the
+ * attributes.
+ *
+ * `baseline` is currently unused at the per-write level (the v0.1
+ * limitation noted above) but kept in the signature so callers don't have
+ * to refactor when the v0.7 differential mode lands.
+ */
+export function extractUserLayer(doc, baseline, options = {}) {
+    void baseline;
+    const fullUpdate = Y.encodeStateAsUpdate(doc);
+    const filtered = options.clientId !== undefined ? filterUpdateByClient(fullUpdate, options.clientId) : fullUpdate;
+    const replay = createCollabDoc({ gc: false });
+    if (filtered.byteLength > 0) {
+        Y.applyUpdate(replay, filtered);
+    }
+    return snapshotToIfcx(replay, {
+        author: options.clientId !== undefined ? `client-${options.clientId}` : undefined,
+        ...options.snapshot,
+    });
+}
+/**
+ * Filter a Y update so it only contains operations from `clientId`.
+ *
+ * We use Yjs's diff-against-state-vector machinery: build a state
+ * vector that has every client *except* `clientId` advanced past the
+ * end of the input update, then `diffUpdate` returns just `clientId`'s
+ * structs.
+ */
+export function filterUpdateByClient(update, clientId) {
+    const tmp = createCollabDoc({ gc: false });
+    Y.applyUpdate(tmp, update);
+    const sv = Y.encodeStateVectorFromUpdate(update);
+    const decoded = decodeStateVector(sv);
+    // Keep our client at clock 0 so we receive all of its ops; advance
+    // every other client to their final clock so they're excluded.
+    decoded.delete(clientId);
+    const adjusted = encodeStateVector(decoded);
+    return Y.encodeStateAsUpdate(tmp, adjusted);
+}
+/* -------------------- minimal SV codec helpers ---------------------- */
+import * as encoding from 'lib0/encoding';
+import * as decoding from 'lib0/decoding';
+function decodeStateVector(buf) {
+    const decoder = decoding.createDecoder(buf);
+    const ssLen = decoding.readVarUint(decoder);
+    const map = new Map();
+    for (let i = 0; i < ssLen; i++) {
+        const client = decoding.readVarUint(decoder);
+        const clock = decoding.readVarUint(decoder);
+        map.set(client, clock);
+    }
+    return map;
+}
+function encodeStateVector(map) {
+    const encoder = encoding.createEncoder();
+    encoding.writeVarUint(encoder, map.size);
+    for (const [client, clock] of map) {
+        encoding.writeVarUint(encoder, client);
+        encoding.writeVarUint(encoder, clock);
+    }
+    return encoding.toUint8Array(encoder);
+}
+//# sourceMappingURL=layers.js.map

package/dist/snapshot/layers.js.map

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

package/dist/snapshot/minimal-layer.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Differential layer composer (spec §2 / §10 / §12.4).
+ *
+ * `extractMinimalLayer(doc, baseline)` produces an IFCX layer that
+ * contains *only* what changed since `baseline`:
+ *   - Entities created since baseline.
+ *   - Entities whose attributes / children / inherits changed since
+ *     baseline (only the changed fields appear).
+ *
+ * Composed with the baseline, the layer reproduces `doc`'s current
+ * state — that's the IFCX layer composition contract from §2 (each
+ * peer becomes a layer author, layer composition is the merge
+ * function).
+ *
+ * Strategy: reconstruct a "before" Y.Doc from the baseline state,
+ * compare entity-by-entity with the live doc, and emit IFCX nodes
+ * containing only the diff. We deliberately don't try to express
+ * deletions in the layer — IFCX overlay semantics are additive in
+ * v0.x, and deletion overlays are spec'd for a future version.
+ */
+import type { IfcxFile } from '@ifc-lite/ifcx';
+import * as Y from 'yjs';
+import { type SnapshotOptions } from './to-ifcx.js';
+export interface ExtractMinimalLayerOptions {
+    /** Forwarded to `snapshotToIfcx` for header / timestamp / id. */
+    snapshot?: SnapshotOptions;
+    /**
+     * If true (default), include attributes that changed value from the
+     * baseline as well as new attributes. If false, only include keys
+     * that didn't exist in the baseline at all.
+     */
+    includeUpdatedValues?: boolean;
+}
+/**
+ * Build a minimal IFCX layer expressing the diff between `baseline`
+ * and `doc`. `baseline` is whatever `Y.encodeStateAsUpdate(doc)`
+ * returned at the fork / snapshot point.
+ */
+export declare function extractMinimalLayer(doc: Y.Doc, baseline: Uint8Array, options?: ExtractMinimalLayerOptions): IfcxFile;
+//# sourceMappingURL=minimal-layer.d.ts.map

package/dist/snapshot/minimal-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimal-layer.d.ts","sourceRoot":"","sources":["../../src/snapshot/minimal-layer.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,WAAW,0BAA0B;IACzC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,CAAC,CAAC,GAAG,EACV,QAAQ,EAAE,UAAU,EACpB,OAAO,GAAE,0BAA+B,GACvC,QAAQ,CAsFV"}

package/dist/snapshot/minimal-layer.js

@@ -0,0 +1,123 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import * as Y from 'yjs';
+import { createCollabDoc, entitiesMap } from '../doc/schema.js';
+import { entityToJSON } from '../doc/entity.js';
+import { snapshotToIfcx } from './to-ifcx.js';
+/**
+ * Build a minimal IFCX layer expressing the diff between `baseline`
+ * and `doc`. `baseline` is whatever `Y.encodeStateAsUpdate(doc)`
+ * returned at the fork / snapshot point.
+ */
+export function extractMinimalLayer(doc, baseline, options = {}) {
+    const includeUpdatedValues = options.includeUpdatedValues ?? true;
+    // Reconstruct the "before" state by replaying the baseline update on
+    // a fresh doc.
+    const before = createCollabDoc({ gc: false });
+    if (baseline.byteLength > 0)
+        Y.applyUpdate(before, baseline);
+    // Snapshot the live doc through the standard writer so we get a
+    // header + imports + schemas template, then trim the data array down
+    // to the diff.
+    const live = snapshotToIfcx(doc, options.snapshot);
+    const beforeEnts = entitiesMap(before);
+    const liveEnts = entitiesMap(doc);
+    const diffNodes = [];
+    liveEnts.forEach((entUntyped, path) => {
+        const liveJson = entityToJSON(entUntyped);
+        const beforeUntyped = beforeEnts.get(path);
+        if (!beforeUntyped) {
+            // Entity is new — emit it whole (sans empty branches).
+            const node = { path };
+            if (Object.keys(liveJson.attributes).length > 0)
+                node.attributes = { ...liveJson.attributes };
+            if (Object.keys(liveJson.children).length > 0)
+                node.children = { ...liveJson.children };
+            if (Object.keys(liveJson.inherits).length > 0)
+                node.inherits = { ...liveJson.inherits };
+            diffNodes.push(node);
+            return;
+        }
+        const beforeJson = entityToJSON(beforeUntyped);
+        const node = { path };
+        let dirty = false;
+        // Attributes: include keys that are new OR (when configured)
+        // whose value changed.
+        const addedAttrs = {};
+        for (const [key, value] of Object.entries(liveJson.attributes)) {
+            const wasInBaseline = key in beforeJson.attributes;
+            if (!wasInBaseline) {
+                addedAttrs[key] = value;
+                continue;
+            }
+            if (includeUpdatedValues && !deepEqual(value, beforeJson.attributes[key])) {
+                addedAttrs[key] = value;
+            }
+        }
+        if (Object.keys(addedAttrs).length > 0) {
+            node.attributes = addedAttrs;
+            dirty = true;
+        }
+        // Children: same rule.
+        const addedChildren = {};
+        for (const [role, child] of Object.entries(liveJson.children)) {
+            const wasInBaseline = role in beforeJson.children;
+            if (!wasInBaseline || (includeUpdatedValues && beforeJson.children[role] !== child)) {
+                addedChildren[role] = child;
+            }
+        }
+        if (Object.keys(addedChildren).length > 0) {
+            node.children = addedChildren;
+            dirty = true;
+        }
+        // Inherits: same rule.
+        const addedInherits = {};
+        for (const [role, inh] of Object.entries(liveJson.inherits)) {
+            const wasInBaseline = role in beforeJson.inherits;
+            if (!wasInBaseline || (includeUpdatedValues && beforeJson.inherits[role] !== inh)) {
+                addedInherits[role] = inh;
+            }
+        }
+        if (Object.keys(addedInherits).length > 0) {
+            node.inherits = addedInherits;
+            dirty = true;
+        }
+        if (dirty)
+            diffNodes.push(node);
+    });
+    before.destroy();
+    return {
+        ...live,
+        data: diffNodes,
+    };
+}
+/**
+ * Heuristic deep-equal: handles primitives, arrays, and plain objects.
+ * Sufficient for IFCX values which are JSON-shaped by construction.
+ */
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a == null || b == null)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (Array.isArray(a)) {
+        if (!Array.isArray(b) || a.length !== b.length)
+            return false;
+        return a.every((v, i) => deepEqual(v, b[i]));
+    }
+    if (typeof a === 'object') {
+        const ao = a;
+        const bo = b;
+        const keys = new Set([...Object.keys(ao), ...Object.keys(bo)]);
+        for (const k of keys) {
+            if (!deepEqual(ao[k], bo[k]))
+                return false;
+        }
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=minimal-layer.js.map

package/dist/snapshot/minimal-layer.js.map

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

package/dist/snapshot/to-ifcx.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Y.Doc → IFCX snapshot.
+ *
+ * Round-trips with `seedFromIfcx`: seeding a doc, snapshotting, then
+ * seeding a fresh doc from the snapshot must produce structurally equal
+ * Y states (verified by tests).
+ */
+import type { IfcxFile } from '@ifc-lite/ifcx';
+import * as Y from 'yjs';
+export interface SnapshotOptions {
+    author?: string;
+    /** Override timestamp; defaults to Date.now(). */
+    timestamp?: string;
+    /** Override the data version string. */
+    dataVersion?: string;
+    /** Override the file id. */
+    id?: string;
+    /** Override the IFCX version string. Defaults to whatever was seeded. */
+    ifcxVersion?: string;
+    /** Stable child-key ordering (defaults to insertion order from the Y.Map). */
+    sortChildren?: boolean;
+}
+export declare function snapshotToIfcx(doc: Y.Doc, options?: SnapshotOptions): IfcxFile;
+/** Serialize an IfcxFile to a string. */
+export declare function serializeIfcx(file: IfcxFile, pretty?: boolean): string;
+//# sourceMappingURL=to-ifcx.d.ts.map

package/dist/snapshot/to-ifcx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-ifcx.d.ts","sourceRoot":"","sources":["../../src/snapshot/to-ifcx.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAoC,MAAM,gBAAgB,CAAC;AACjF,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAiDlF;AAED,yCAAyC;AACzC,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,UAAO,GAAG,MAAM,CAEnE"}

package/dist/snapshot/to-ifcx.js

@@ -0,0 +1,54 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { entityToJSON, iterEntities } from '../doc/entity.js';
+import { metaMap } from '../doc/schema.js';
+export function snapshotToIfcx(doc, options = {}) {
+    const meta = metaMap(doc);
+    const seededHeader = meta.get('header') ?? undefined;
+    const seededImports = meta.get('imports') ?? [];
+    const seededSchemas = meta.get('schemas') ?? {};
+    const header = {
+        id: options.id ?? seededHeader?.id ?? 'ifc-lite/collab/snapshot',
+        ifcxVersion: options.ifcxVersion ?? seededHeader?.ifcxVersion ?? 'ifcx_alpha',
+        dataVersion: options.dataVersion ?? seededHeader?.dataVersion ?? '1.0.0',
+        author: options.author ?? seededHeader?.author ?? 'ifc-lite/collab',
+        timestamp: options.timestamp ?? new Date().toISOString(),
+    };
+    const data = [];
+    for (const [path, entity] of iterEntities(doc)) {
+        const json = entityToJSON(entity);
+        const node = { path };
+        const childrenKeys = options.sortChildren
+            ? Object.keys(json.children).sort()
+            : Object.keys(json.children);
+        if (childrenKeys.length > 0) {
+            node.children = {};
+            for (const k of childrenKeys)
+                node.children[k] = json.children[k];
+        }
+        const inheritsKeys = options.sortChildren
+            ? Object.keys(json.inherits).sort()
+            : Object.keys(json.inherits);
+        if (inheritsKeys.length > 0) {
+            node.inherits = {};
+            for (const k of inheritsKeys)
+                node.inherits[k] = json.inherits[k];
+        }
+        if (Object.keys(json.attributes).length > 0) {
+            node.attributes = { ...json.attributes };
+        }
+        data.push(node);
+    }
+    return {
+        header,
+        imports: seededImports,
+        schemas: seededSchemas,
+        data,
+    };
+}
+/** Serialize an IfcxFile to a string. */
+export function serializeIfcx(file, pretty = true) {
+    return pretty ? JSON.stringify(file, null, 2) : JSON.stringify(file);
+}
+//# sourceMappingURL=to-ifcx.js.map

package/dist/snapshot/to-ifcx.js.map

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

package/dist/snapshot/worker.d.ts

@@ -0,0 +1,45 @@
+import { snapshotToIfcx, type SnapshotOptions } from './to-ifcx.js';
+import { seedFromIfcx, type IfcxInput } from './from-ifcx.js';
+export type WorkerRequest = {
+    kind: 'snapshot';
+    /** Encoded Y state (e.g. `Y.encodeStateAsUpdate(doc)`) to snapshot. */
+    update: Uint8Array;
+    options?: SnapshotOptions;
+    requestId?: string;
+} | {
+    kind: 'seed';
+    /** IFCX text or already-decoded `IfcxFile`. */
+    source: IfcxInput;
+    requestId?: string;
+};
+export type WorkerResponse = {
+    kind: 'snapshot:ok';
+    requestId?: string;
+    ifcx: ReturnType<typeof snapshotToIfcx>;
+} | {
+    kind: 'seed:ok';
+    requestId?: string;
+    /** Y update encoded from the seeded doc, ready for `applyUpdate` on the main thread. */
+    update: Uint8Array;
+} | {
+    kind: 'error';
+    requestId?: string;
+    message: string;
+};
+/** Minimal subset of `Worker`'s self / DedicatedWorkerGlobalScope. */
+export interface WorkerScopeLike {
+    addEventListener(type: 'message', listener: (event: {
+        data: WorkerRequest;
+    }) => void): void;
+    postMessage(data: WorkerResponse, transfer?: Transferable[]): void;
+}
+/**
+ * Mount a `(snapshot|seed)` request handler on a worker scope.
+ *
+ * The handler creates a fresh Y.Doc per request, applies the supplied
+ * update (snapshot path) or seeds from IFCX (seed path), then posts the
+ * result back. Memory is bounded to the lifetime of one request.
+ */
+export declare function runSnapshotWorker(scope: WorkerScopeLike): void;
+export { snapshotToIfcx, seedFromIfcx };
+//# sourceMappingURL=worker.d.ts.map

package/dist/snapshot/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/snapshot/worker.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,YAAY,EAAkB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE9E,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,uEAAuE;IACvE,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEN,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;CACzC,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,MAAM,EAAE,UAAU,CAAC;CACpB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CACd,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,aAAa,CAAA;KAAE,KAAK,IAAI,GACjD,IAAI,CAAC;IACR,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;CACpE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAsC9D;AAKD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC"}

package/dist/snapshot/worker.js

@@ -0,0 +1,73 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Worker-safe snapshot helpers (spec §16.1 deferred from v0.1).
+ *
+ * `snapshotToIfcx` and `seedFromIfcx` are pure functions that operate
+ * on a Y.Doc — they do not touch the DOM and are therefore safe to
+ * call from a Web Worker. This module re-exports them along with a
+ * tiny `runSnapshotWorker(self)` adapter that consumers can drop into
+ * a worker entry point to get a postMessage-driven snapshot service
+ * without writing the boilerplate.
+ *
+ * Wire from app code:
+ *   - in `worker.ts`: `import { runSnapshotWorker } from '@ifc-lite/collab/snapshot/worker'; runSnapshotWorker(self);`
+ *   - in main thread: post `{ kind: 'snapshot', updates }` and await
+ *     a `{ kind: 'snapshot:ok', ifcx }` reply.
+ */
+import * as Y from 'yjs';
+import { createCollabDoc } from '../doc/schema.js';
+import { snapshotToIfcx } from './to-ifcx.js';
+import { seedFromIfcx, parseIfcxInput } from './from-ifcx.js';
+/**
+ * Mount a `(snapshot|seed)` request handler on a worker scope.
+ *
+ * The handler creates a fresh Y.Doc per request, applies the supplied
+ * update (snapshot path) or seeds from IFCX (seed path), then posts the
+ * result back. Memory is bounded to the lifetime of one request.
+ */
+export function runSnapshotWorker(scope) {
+    scope.addEventListener('message', (event) => {
+        const msg = event.data;
+        try {
+            switch (msg.kind) {
+                case 'snapshot': {
+                    const doc = createCollabDoc({ gc: false });
+                    if (msg.update.byteLength > 0)
+                        Y.applyUpdate(doc, msg.update);
+                    const ifcx = snapshotToIfcx(doc, msg.options);
+                    scope.postMessage({ kind: 'snapshot:ok', requestId: msg.requestId, ifcx });
+                    return;
+                }
+                case 'seed': {
+                    const doc = createCollabDoc({ gc: false });
+                    // Decode whatever shape the caller hands us.
+                    parseIfcxInput(msg.source);
+                    seedFromIfcx(doc, msg.source);
+                    const update = Y.encodeStateAsUpdate(doc);
+                    scope.postMessage({ kind: 'seed:ok', requestId: msg.requestId, update }, 
+                    // Transfer the buffer so we don't double-copy it.
+                    [update.buffer]);
+                    return;
+                }
+                default: {
+                    const exhaustive = msg;
+                    throw new Error(`@ifc-lite/collab: unknown worker message kind: ${exhaustive.kind}`);
+                }
+            }
+        }
+        catch (err) {
+            scope.postMessage({
+                kind: 'error',
+                requestId: msg.requestId,
+                message: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+}
+// Re-export the pure helpers so consumers that don't want the
+// postMessage adapter can still import the worker-safe surface from
+// one entry point.
+export { snapshotToIfcx, seedFromIfcx };
+//# sourceMappingURL=worker.js.map

package/dist/snapshot/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/snapshot/worker.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAwB,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAkB,MAAM,gBAAgB,CAAC;AA4C9E;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAsB;IACtD,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;QAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;gBACjB,KAAK,UAAU,CAAC,CAAC,CAAC;oBAChB,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;oBAC3C,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC;wBAAE,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC9D,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;oBAC9C,KAAK,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC3E,OAAO;gBACT,CAAC;gBACD,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;oBAC3C,6CAA6C;oBAC7C,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC3B,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC9B,MAAM,MAAM,GAAG,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;oBAC1C,KAAK,CAAC,WAAW,CACf,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE;oBACrD,kDAAkD;oBAClD,CAAC,MAAM,CAAC,MAAM,CAAC,CAChB,CAAC;oBACF,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC,CAAC,CAAC;oBACR,MAAM,UAAU,GAAU,GAAG,CAAC;oBAC9B,MAAM,IAAI,KAAK,CAAC,kDAAmD,UAAgC,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC9G,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,WAAW,CAAC;gBAChB,IAAI,EAAE,OAAO;gBACb,SAAS,EAAG,GAA8B,CAAC,SAAS;gBACpD,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aAC1D,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8DAA8D;AAC9D,oEAAoE;AACpE,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC"}

package/dist/sync/room.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Room lifecycle helpers.
+ *
+ * A room is identified by a string key. For a project-wide federated
+ * session, room IDs follow the convention `project-id/model-id` plus
+ * `project-id/_federation` (spec §10).
+ */
+export interface RoomDescriptor {
+    projectId: string;
+    modelId: string;
+}
+export declare function roomIdFor(desc: RoomDescriptor): string;
+export declare function federationRoomId(projectId: string): string;
+export declare function parseRoomId(roomId: string): RoomDescriptor;
+//# sourceMappingURL=room.d.ts.map

package/dist/sync/room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.d.ts","sourceRoot":"","sources":["../../src/sync/room.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAEtD;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAS1D"}

package/dist/sync/room.js

@@ -0,0 +1,20 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+export function roomIdFor(desc) {
+    return `${desc.projectId}/${desc.modelId}`;
+}
+export function federationRoomId(projectId) {
+    return `${projectId}/_federation`;
+}
+export function parseRoomId(roomId) {
+    const idx = roomId.indexOf('/');
+    if (idx < 0) {
+        return { projectId: '', modelId: roomId };
+    }
+    return {
+        projectId: roomId.slice(0, idx),
+        modelId: roomId.slice(idx + 1),
+    };
+}
+//# sourceMappingURL=room.js.map

package/dist/sync/room.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.js","sourceRoot":"","sources":["../../src/sync/room.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAe/D,MAAM,UAAU,SAAS,CAAC,IAAoB;IAC5C,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,GAAG,SAAS,cAAc,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACZ,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;KAC/B,CAAC;AACJ,CAAC"}

package/dist/undo.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Undo manager — wraps Y.UndoManager scoped to the local origin so a
+ * peer's `undo()` only rolls back their own edits, never their
+ * teammates'. Spec §6.1.
+ */
+import * as Y from 'yjs';
+import { UNDO_ORIGIN } from './doc/schema.js';
+export interface UndoOptions {
+    /** Origins that count as undoable. Defaults to `[LOCAL_ORIGIN]`. */
+    trackedOrigins?: unknown[];
+    /** Capture timeout in ms (default 500). */
+    captureTimeout?: number;
+}
+export interface UndoController {
+    readonly manager: Y.UndoManager;
+    undo(): boolean;
+    redo(): boolean;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    clear(): void;
+    destroy(): void;
+}
+export declare function createUndoManager(doc: Y.Doc, opts?: UndoOptions): UndoController;
+export { UNDO_ORIGIN };
+//# sourceMappingURL=undo.d.ts.map

package/dist/undo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo.d.ts","sourceRoot":"","sources":["../src/undo.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAEL,WAAW,EAIZ,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC;IAChC,IAAI,IAAI,OAAO,CAAC;IAChB,IAAI,IAAI,OAAO,CAAC;IAChB,OAAO,IAAI,OAAO,CAAC;IACnB,OAAO,IAAI,OAAO,CAAC;IACnB,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,GAAE,WAAgB,GAAG,cAAc,CA6BpF;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/undo.js

@@ -0,0 +1,37 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Undo manager — wraps Y.UndoManager scoped to the local origin so a
+ * peer's `undo()` only rolls back their own edits, never their
+ * teammates'. Spec §6.1.
+ */
+import * as Y from 'yjs';
+import { LOCAL_ORIGIN, UNDO_ORIGIN, entitiesMap, geometryMap, relationshipsMap, } from './doc/schema.js';
+export function createUndoManager(doc, opts = {}) {
+    const trackedOrigins = new Set(opts.trackedOrigins ?? [LOCAL_ORIGIN]);
+    const manager = new Y.UndoManager([entitiesMap(doc), relationshipsMap(doc), geometryMap(doc)], {
+        trackedOrigins,
+        captureTimeout: opts.captureTimeout ?? 500,
+    });
+    return {
+        manager,
+        undo() {
+            // Yjs UndoManager.undo returns the StackItem when something was
+            // undone, or `null` otherwise. We tag the redo operation with our
+            // dedicated origin so observers can distinguish it from human ops.
+            const item = manager.undo();
+            return item != null;
+        },
+        redo() {
+            const item = manager.redo();
+            return item != null;
+        },
+        canUndo: () => manager.canUndo(),
+        canRedo: () => manager.canRedo(),
+        clear: () => manager.clear(),
+        destroy: () => manager.destroy(),
+    };
+}
+export { UNDO_ORIGIN };
+//# sourceMappingURL=undo.js.map

package/dist/undo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo.js","sourceRoot":"","sources":["../src/undo.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;GAIG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAmBzB,MAAM,UAAU,iBAAiB,CAAC,GAAU,EAAE,OAAoB,EAAE;IAClE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAU,IAAI,CAAC,cAAc,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAE/E,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,WAAW,CAC/B,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,EAC3D;QACE,cAAc;QACd,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,GAAG;KAC3C,CACF,CAAC;IAEF,OAAO;QACL,OAAO;QACP,IAAI;YACF,gEAAgE;YAChE,kEAAkE;YAClE,mEAAmE;YACnE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAC5B,OAAO,IAAI,IAAI,IAAI,CAAC;QACtB,CAAC;QACD,IAAI;YACF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAC5B,OAAO,IAAI,IAAI,IAAI,CAAC;QACtB,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;QAChC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;QAChC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE;QAC5B,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;KACjC,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/viewer-bridge.d.ts

@@ -0,0 +1,27 @@
+import type { Vec3 } from './awareness/presence.js';
+import type { CollabSession } from './session.js';
+export interface MountPresenceInViewerOptions {
+    session: CollabSession;
+    container: HTMLElement;
+    viewport: string;
+    /** Opt out of forwarding mousemove → setCursor* (default: forward). */
+    trackLocalCursor?: boolean;
+    /**
+     * Host-supplied screen→world raycast. When provided, every mousemove
+     * is converted to a 3D world-space point via this callback and
+     * broadcast as `cursor3d`. Each peer then reprojects it through
+     * THEIR camera, so cursors stay anchored to the same point in the
+     * model regardless of camera perspective.
+     *
+     * When omitted, the bridge falls back to publishing `cursor2d` only
+     * (the legacy fixed-projection behaviour — accurate only when every
+     * peer shares the same view, e.g. orthographic plan layouts).
+     *
+     * Return `null` on a ray miss; the bridge will keep the previously
+     * published cursor rather than spamming clears.
+     */
+    raycastToWorld?: (screenX: number, screenY: number) => Vec3 | null;
+}
+export type Teardown = () => void;
+export declare function mountPresenceInViewer(opts: MountPresenceInViewerOptions): Teardown;
+//# sourceMappingURL=viewer-bridge.d.ts.map

package/dist/viewer-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-bridge.d.ts","sourceRoot":"","sources":["../src/viewer-bridge.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAe,IAAI,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,WAAW,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;CACpE;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC;AAElC,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,4BAA4B,GAAG,QAAQ,CAyDlF"}