@doxi/collab 0.11.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mahbub Hasan
+
+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,53 @@
+# @doxi/collab
+
+Real-time collaboration substrate for Doxiva. Step-based concurrency control with per-peer Lamport ordering, pluggable transports, and presence cursors.
+
+> **Status:** v0.10.x preview. v0.6.0 ships sequential + disjoint-position convergence. Same-position concurrent inserts are a known limitation — see below.
+
+## What it does
+
+- **`CollabEngine`** — wraps a local `EditorView` so every dispatched `Transaction` is mirrored to remote peers, and inbound updates are rebased and applied locally. Per-peer Lamport clock + monotonic local version. Concurrency uses Mapping-based rebase of pending local updates against inbound steps (the ProseMirror-collab model).
+- **`Transport` interface** — pluggable channel for `CollabUpdate` + `RemoteCursor` messages. Two implementations ship:
+  - **`InMemoryBroker`** (`@doxi/collab/transports/in-memory`) — in-process fan-out, primarily for tests.
+  - **`BroadcastChannelTransport`** (`@doxi/collab/transports/broadcast`) — same-origin tab sync via the browser `BroadcastChannel` API. No server, no auth, no persistence.
+- **`RemoteCursorTracker` + `installRemoteCursors(view, engine)`** — presence cursors painted as a direct-DOM overlay anchored to the view. Caret + peer label, color per peer.
+
+## Install
+
+```bash
+pnpm add @doxi/collab @doxi/core
+```
+
+## Quickstart
+
+```ts
+import { CollabEngine, installRemoteCursors } from '@doxi/collab'
+import { BroadcastChannelTransport } from '@doxi/collab/transports/broadcast'
+
+const transport = new BroadcastChannelTransport('doxiva-demo')
+const engine = new CollabEngine({
+  view,
+  transport,
+  peer: { id: crypto.randomUUID(), label: 'Alice', color: '#d93025' },
+})
+const uninstall = installRemoteCursors(view, engine)
+
+// Later: uninstall(); engine.dispose(); transport.dispose()
+```
+
+## Known limitations
+
+- **Same-position concurrent inserts may diverge in ordering.** v0.6 is step-based, not character-CRDT. A Logoot/RGA fractional-index variant is on the roadmap.
+- **No authoritative server / replay log.** Peers joining late don't see prior history. v0.6 is peer-to-peer only via `BroadcastChannel` (same-origin tabs).
+- **No WebSocket transport in-tree.** The transport interface is open; consumers wire their own. WebSocket adapter is planned.
+- **No RBAC, comments, suggestions, track-changes** — these need their own model layer.
+
+See [spec §7.2](../../docs/internal/specs/2026-05-23-doxiva-editor-design.md) for the full design and convergence model.
+
+## Tests
+
+400 fast-check cases per scenario family across `convergence.prop.test.ts` (sequential + disjoint-position + cursor-only). Arbitrary async schedules are a v0.6.x follow-up reserved by an `it.todo`.
+
+## License
+
+[MIT](LICENSE)

package/dist/cursors.d.ts

@@ -0,0 +1,22 @@
+import type { ClientId, RemoteCursor } from './types.js';
+/**
+ * Tracks remote cursors per peer. CollabEngine's onCursor handler updates
+ * this; the view-side renderer (installRemoteCursors) reads via the public
+ * `all()` and re-renders on `subscribe()` notifications.
+ *
+ * Stale cursors (older than `maxAgeMs` since `lastSeen`) are pruned on
+ * demand via pruneStale(); the engine does NOT prune automatically in
+ * v0.6.0 — callers decide the policy.
+ */
+export declare class RemoteCursorTracker {
+    private cursors;
+    private listeners;
+    set(cursor: RemoteCursor): void;
+    remove(clientId: ClientId): void;
+    pruneStale(now: number, maxAgeMs: number): number;
+    all(): ReadonlyArray<RemoteCursor>;
+    size(): number;
+    subscribe(listener: () => void): () => void;
+    private notify;
+}
+//# sourceMappingURL=cursors.d.ts.map

package/dist/cursors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursors.d.ts","sourceRoot":"","sources":["../src/cursors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAExD;;;;;;;;GAQG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,SAAS,CAAwB;IAEzC,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAK/B,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAIhC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAYjD,GAAG,IAAI,aAAa,CAAC,YAAY,CAAC;IAIlC,IAAI,IAAI,MAAM;IAId,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAO3C,OAAO,CAAC,MAAM;CAGf"}

package/dist/cursors.js

@@ -0,0 +1,50 @@
+/**
+ * Tracks remote cursors per peer. CollabEngine's onCursor handler updates
+ * this; the view-side renderer (installRemoteCursors) reads via the public
+ * `all()` and re-renders on `subscribe()` notifications.
+ *
+ * Stale cursors (older than `maxAgeMs` since `lastSeen`) are pruned on
+ * demand via pruneStale(); the engine does NOT prune automatically in
+ * v0.6.0 — callers decide the policy.
+ */
+export class RemoteCursorTracker {
+    cursors = new Map();
+    listeners = new Set();
+    set(cursor) {
+        this.cursors.set(cursor.clientId, cursor);
+        this.notify();
+    }
+    remove(clientId) {
+        if (this.cursors.delete(clientId))
+            this.notify();
+    }
+    pruneStale(now, maxAgeMs) {
+        let removed = 0;
+        for (const [id, c] of this.cursors) {
+            if (now - c.lastSeen > maxAgeMs) {
+                this.cursors.delete(id);
+                removed++;
+            }
+        }
+        if (removed > 0)
+            this.notify();
+        return removed;
+    }
+    all() {
+        return Array.from(this.cursors.values());
+    }
+    size() {
+        return this.cursors.size;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    notify() {
+        for (const l of this.listeners)
+            l();
+    }
+}
+//# sourceMappingURL=cursors.js.map

package/dist/cursors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursors.js","sourceRoot":"","sources":["../src/cursors.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,OAAO,mBAAmB;IACtB,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAA;IAC3C,SAAS,GAAG,IAAI,GAAG,EAAc,CAAA;IAEzC,GAAG,CAAC,MAAoB;QACtB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QACzC,IAAI,CAAC,MAAM,EAAE,CAAA;IACf,CAAC;IAED,MAAM,CAAC,QAAkB;QACvB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,IAAI,CAAC,MAAM,EAAE,CAAA;IAClD,CAAC;IAED,UAAU,CAAC,GAAW,EAAE,QAAgB;QACtC,IAAI,OAAO,GAAG,CAAC,CAAA;QACf,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,GAAG,GAAG,CAAC,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC;gBAChC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;gBACvB,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC;QACD,IAAI,OAAO,GAAG,CAAC;YAAE,IAAI,CAAC,MAAM,EAAE,CAAA;QAC9B,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,GAAG;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAA;IAC1B,CAAC;IAED,SAAS,CAAC,QAAoB;QAC5B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC5B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACjC,CAAC,CAAA;IACH,CAAC;IAEO,MAAM;QACZ,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS;YAAE,CAAC,EAAE,CAAA;IACrC,CAAC;CACF"}

package/dist/engine.d.ts

@@ -0,0 +1,87 @@
+import { type EditorView } from '@doxi/core';
+import { RemoteCursorTracker } from './cursors.js';
+import type { Transport } from './transport.js';
+import type { RemoteCursor, RemoteCursorSelection } from './types.js';
+export interface CollabEngineOptions {
+    readonly clientId: string;
+    readonly transport: Transport;
+    readonly cursorLabel?: string;
+    readonly cursorColor?: string;
+}
+export interface CollabEngineSnapshot {
+    readonly clientId: string;
+    readonly clock: number;
+    readonly localUpdatesCount: number;
+    readonly remoteCursors: ReadonlyArray<RemoteCursor>;
+}
+/**
+ * CollabEngine wires a local EditorView into a Transport so every dispatched
+ * Transaction is mirrored to remote peers, and inbound CollabUpdates are
+ * rebased and applied locally.
+ *
+ * Concurrency model (v0.6.0):
+ *   - Each peer maintains a Lamport clock and a per-peer monotonic
+ *     `localVersion` (count of confirmed local updates).
+ *   - On local dispatch the engine increments localVersion, broadcasts
+ *     the steps tagged with the pre-dispatch baseVersion, and records
+ *     the mapRanges of the dispatched steps so future inbound updates
+ *     can be rebased through them.
+ *   - On inbound update the engine builds a Mapping from every local
+ *     update applied AFTER the inbound's baseVersion (i.e. the local
+ *     work the remote peer hadn't seen) and maps the inbound steps
+ *     through it. The mapped steps are applied as a single Transaction.
+ *
+ * Presence (v0.6.0):
+ *   - Every committed local Transaction (whether it carries steps or is
+ *     selection-only) publishes a RemoteCursor with the post-transaction
+ *     selection. The view-side tracker (cursorTracker) stores the latest
+ *     cursor per peer and notifies listeners; installRemoteCursors paints
+ *     the overlay.
+ *
+ * This is NOT a fully convergent CRDT — see README for the schedules where
+ * peers can diverge.
+ */
+export declare class CollabEngine {
+    readonly options: CollabEngineOptions;
+    private clock;
+    private localVersion;
+    /** Per-local-update list of mapRanges (used for rebasing inbound updates). */
+    private localUpdateMappings;
+    private readonly tracker;
+    private applyingRemote;
+    private view;
+    private originalDispatch;
+    private offUpdate;
+    private offCursor;
+    private disposed;
+    private lastPublishedSelectionKey;
+    constructor(options: CollabEngineOptions);
+    /** Attach to a view. Returns a cleanup fn. */
+    attach(view: EditorView): () => void;
+    /** Read-only snapshot for tests / debug. */
+    state(): CollabEngineSnapshot;
+    /**
+     * The tracker that holds the latest RemoteCursor per peer. Use
+     * `tracker.subscribe(...)` to repaint a presence overlay when peers
+     * move; `tracker.all()` returns the current set.
+     */
+    get cursorTracker(): RemoteCursorTracker;
+    /** Broadcast the local cursor selection to remote peers. */
+    publishLocalCursor(selection: RemoteCursorSelection): void;
+    dispose(): void;
+    private captureLocal;
+    /**
+     * Publish the current view selection if it has changed since the last
+     * publish. De-duped on a `type:anchor:head` key so a content-only edit
+     * that doesn't move the caret still publishes once (because positions
+     * may have remapped) — see the key reset in captureLocal-driven paths.
+     *
+     * Selection-only transactions (no steps) reach here via the dispatch
+     * wrapper and update the published cursor without producing a
+     * CollabUpdate.
+     */
+    private maybePublishLocalCursor;
+    private onRemoteUpdate;
+    private onRemoteCursor;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,UAAU,EAIhB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAyB,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAE5F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;CACpD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,YAAY;IAcX,QAAQ,CAAC,OAAO,EAAE,mBAAmB;IAbjD,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,YAAY,CAAI;IACxB,8EAA8E;IAC9E,OAAO,CAAC,mBAAmB,CAAiE;IAC5F,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,gBAAgB,CAA2C;IACnE,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,yBAAyB,CAAsB;gBAElC,OAAO,EAAE,mBAAmB;IAEjD,8CAA8C;IAC9C,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,IAAI;IA8BpC,4CAA4C;IAC5C,KAAK,IAAI,oBAAoB;IAS7B;;;;OAIG;IACH,IAAI,aAAa,IAAI,mBAAmB,CAEvC;IAED,4DAA4D;IAC5D,kBAAkB,CAAC,SAAS,EAAE,qBAAqB,GAAG,IAAI;IAY1D,OAAO,IAAI,IAAI;IAgBf,OAAO,CAAC,YAAY;IAkBpB;;;;;;;;;OASG;IACH,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,cAAc;IA0DtB,OAAO,CAAC,cAAc;CAKvB"}

package/dist/engine.js

@@ -0,0 +1,230 @@
+import { Mapping, stepFromJSON, Transaction, } from '@doxi/core';
+import { RemoteCursorTracker } from './cursors.js';
+/**
+ * CollabEngine wires a local EditorView into a Transport so every dispatched
+ * Transaction is mirrored to remote peers, and inbound CollabUpdates are
+ * rebased and applied locally.
+ *
+ * Concurrency model (v0.6.0):
+ *   - Each peer maintains a Lamport clock and a per-peer monotonic
+ *     `localVersion` (count of confirmed local updates).
+ *   - On local dispatch the engine increments localVersion, broadcasts
+ *     the steps tagged with the pre-dispatch baseVersion, and records
+ *     the mapRanges of the dispatched steps so future inbound updates
+ *     can be rebased through them.
+ *   - On inbound update the engine builds a Mapping from every local
+ *     update applied AFTER the inbound's baseVersion (i.e. the local
+ *     work the remote peer hadn't seen) and maps the inbound steps
+ *     through it. The mapped steps are applied as a single Transaction.
+ *
+ * Presence (v0.6.0):
+ *   - Every committed local Transaction (whether it carries steps or is
+ *     selection-only) publishes a RemoteCursor with the post-transaction
+ *     selection. The view-side tracker (cursorTracker) stores the latest
+ *     cursor per peer and notifies listeners; installRemoteCursors paints
+ *     the overlay.
+ *
+ * This is NOT a fully convergent CRDT — see README for the schedules where
+ * peers can diverge.
+ */
+export class CollabEngine {
+    options;
+    clock = 0;
+    localVersion = 0;
+    /** Per-local-update list of mapRanges (used for rebasing inbound updates). */
+    localUpdateMappings = [];
+    tracker = new RemoteCursorTracker();
+    applyingRemote = false;
+    view = null;
+    originalDispatch = null;
+    offUpdate = null;
+    offCursor = null;
+    disposed = false;
+    lastPublishedSelectionKey = null;
+    constructor(options) {
+        this.options = options;
+    }
+    /** Attach to a view. Returns a cleanup fn. */
+    attach(view) {
+        if (this.view)
+            throw new Error('CollabEngine.attach: already attached');
+        if (this.disposed)
+            throw new Error('CollabEngine.attach: engine disposed');
+        this.view = view;
+        // Wrap view.dispatch so we observe every local Transaction AFTER it
+        // has been committed by the host.
+        const original = view.dispatch.bind(view);
+        this.originalDispatch = original;
+        view.dispatch = (tr) => {
+            original(tr);
+            if (this.applyingRemote)
+                return;
+            this.captureLocal(tr);
+            // Force a cursor publish whenever a transaction carried steps — even
+            // if anchor/head stayed numerically constant (e.g., a cursor at the
+            // start of the doc while the user types further along). Remote peers
+            // re-render against the new doc and need a fresh ping. Selection-only
+            // transactions go through the deduped path.
+            this.maybePublishLocalCursor(tr.steps.length > 0);
+        };
+        this.offUpdate = this.options.transport.onUpdate((u) => this.onRemoteUpdate(u));
+        this.offCursor = this.options.transport.onCursor((c) => this.onRemoteCursor(c));
+        // Publish initial cursor so remote peers see this client on first attach.
+        this.maybePublishLocalCursor();
+        return () => this.dispose();
+    }
+    /** Read-only snapshot for tests / debug. */
+    state() {
+        return {
+            clientId: this.options.clientId,
+            clock: this.clock,
+            localUpdatesCount: this.localVersion,
+            remoteCursors: this.tracker.all(),
+        };
+    }
+    /**
+     * The tracker that holds the latest RemoteCursor per peer. Use
+     * `tracker.subscribe(...)` to repaint a presence overlay when peers
+     * move; `tracker.all()` returns the current set.
+     */
+    get cursorTracker() {
+        return this.tracker;
+    }
+    /** Broadcast the local cursor selection to remote peers. */
+    publishLocalCursor(selection) {
+        if (this.disposed)
+            return;
+        const cursor = {
+            clientId: this.options.clientId,
+            selection,
+            lastSeen: Date.now(),
+            ...(this.options.cursorLabel !== undefined ? { label: this.options.cursorLabel } : {}),
+            ...(this.options.cursorColor !== undefined ? { color: this.options.cursorColor } : {}),
+        };
+        this.options.transport.publishCursor(cursor);
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        if (this.view && this.originalDispatch) {
+            this.view.dispatch = this.originalDispatch;
+        }
+        this.view = null;
+        this.originalDispatch = null;
+        this.offUpdate?.();
+        this.offCursor?.();
+        this.offUpdate = null;
+        this.offCursor = null;
+    }
+    // ---- internals ----------------------------------------------------------
+    captureLocal(tr) {
+        if (tr.steps.length === 0)
+            return; // selection-only updates don't propagate
+        const baseVersion = this.localVersion;
+        const nextVersion = baseVersion + 1;
+        const lamport = { clock: this.clock, clientId: this.options.clientId };
+        const stepJSONs = tr.steps.map((s) => s.toJSON());
+        const update = {
+            clientId: this.options.clientId,
+            baseVersion,
+            lamport,
+            steps: stepJSONs,
+        };
+        this.localVersion = nextVersion;
+        this.clock = this.clock + 1;
+        this.localUpdateMappings.push({ baseVersion, ranges: tr.mapping.ranges });
+        this.options.transport.publish(update);
+    }
+    /**
+     * Publish the current view selection if it has changed since the last
+     * publish. De-duped on a `type:anchor:head` key so a content-only edit
+     * that doesn't move the caret still publishes once (because positions
+     * may have remapped) — see the key reset in captureLocal-driven paths.
+     *
+     * Selection-only transactions (no steps) reach here via the dispatch
+     * wrapper and update the published cursor without producing a
+     * CollabUpdate.
+     */
+    maybePublishLocalCursor(force = false) {
+        if (this.disposed)
+            return;
+        const view = this.view;
+        if (!view)
+            return;
+        const sel = view.state.selection;
+        const json = sel.toJSON();
+        const key = `${json.type}:${json.anchor}:${json.head}`;
+        if (!force && key === this.lastPublishedSelectionKey)
+            return;
+        this.lastPublishedSelectionKey = key;
+        this.publishLocalCursor(json);
+    }
+    onRemoteUpdate(update) {
+        if (this.disposed)
+            return;
+        if (update.clientId === this.options.clientId)
+            return; // ignore own echoes
+        const view = this.view;
+        if (!view)
+            return;
+        // Build the rebase mapping: every local update applied AFTER the
+        // remote's baseVersion. The remote peer based its steps on a doc
+        // state where our local updates after baseVersion had NOT happened,
+        // so we map its step positions forward through them.
+        const rebaseRanges = [];
+        for (const entry of this.localUpdateMappings) {
+            if (entry.baseVersion >= update.baseVersion) {
+                rebaseRanges.push(...entry.ranges);
+            }
+        }
+        const rebase = rebaseRanges.length === 0 ? Mapping.empty : new Mapping(rebaseRanges);
+        const state = view.state;
+        const schema = state.schema;
+        const rehydrated = [];
+        for (const sjson of update.steps) {
+            const step = stepFromJSON(schema, sjson);
+            const mapped = rebase.ranges.length === 0 ? step : step.map(rebase);
+            if (mapped)
+                rehydrated.push(mapped);
+        }
+        if (rehydrated.length === 0) {
+            this.clock = Math.max(this.clock, update.lamport.clock) + 1;
+            return;
+        }
+        let tr = state.tr;
+        let ok = true;
+        for (const step of rehydrated) {
+            try {
+                tr = tr.step(step);
+            }
+            catch {
+                // A step failed to apply (e.g. position out of bounds after a
+                // concurrent delete swallowed its anchor). Drop the offending step
+                // and continue. v0.6.0 known limitation.
+                ok = false;
+            }
+        }
+        if (tr.steps.length === 0) {
+            this.clock = Math.max(this.clock, update.lamport.clock) + 1;
+            return;
+        }
+        void ok;
+        this.applyingRemote = true;
+        try {
+            view.dispatch(tr);
+        }
+        finally {
+            this.applyingRemote = false;
+        }
+        this.clock = Math.max(this.clock, update.lamport.clock) + 1;
+    }
+    onRemoteCursor(cursor) {
+        if (this.disposed)
+            return;
+        if (cursor.clientId === this.options.clientId)
+            return;
+        this.tracker.set(cursor);
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { CollabEngine } from './engine.js';
+export type { CollabEngineOptions, CollabEngineSnapshot } from './engine.js';
+export { RemoteCursorTracker } from './cursors.js';
+export { installRemoteCursors } from './install-remote-cursors.js';
+export type { Transport } from './transport.js';
+export type { ClientId, Lamport, CollabUpdate, RemoteCursor, RemoteCursorSelection, } from './types.js';
+export { lamportLessThan } from './types.js';
+export { InMemoryBroker } from './transports/in-memory.js';
+export { BroadcastChannelTransport } from './transports/broadcast.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,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,YAAY,EACV,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,qBAAqB,GACtB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { CollabEngine } from './engine.js';
+export { RemoteCursorTracker } from './cursors.js';
+export { installRemoteCursors } from './install-remote-cursors.js';
+export { lamportLessThan } from './types.js';
+export { InMemoryBroker } from './transports/in-memory.js';
+export { BroadcastChannelTransport } from './transports/broadcast.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,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AASlE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/install-remote-cursors.d.ts

@@ -0,0 +1,24 @@
+import { type EditorView } from '@doxi/core';
+import type { CollabEngine } from './engine.js';
+/**
+ * Mount a remote-cursors overlay inside `view.dom`. The overlay paints a
+ * thin caret + label for every remote peer's cursor in the engine's
+ * tracker.
+ *
+ * v0.6.0 "direct-DOM" approach: positions are resolved from model →
+ * DOM via the core's `locateDomFromModelPos` helper, then pixel-positioned
+ * with a transient Range + getBoundingClientRect. The overlay is an
+ * absolutely positioned `<div class="dx-remote-cursors-layer">` inside
+ * `view.dom` (whose position is forced to `relative` if necessary).
+ *
+ * Repaint policy: while at least one remote cursor exists, repaint every
+ * animation frame (~60Hz). This is intentionally simple — it covers
+ * local edits that shift remote-cursor positions and reflows from window
+ * resizes without wiring into the view's internal lifecycle. Idle when
+ * the tracker is empty.
+ *
+ * Future v0.7+ can migrate to a decorations-based renderer; the on-wire
+ * RemoteCursor shape stays the same.
+ */
+export declare function installRemoteCursors(view: EditorView, engine: CollabEngine): () => void;
+//# sourceMappingURL=install-remote-cursors.d.ts.map

package/dist/install-remote-cursors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-remote-cursors.d.ts","sourceRoot":"","sources":["../src/install-remote-cursors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,IAAI,CA8EvF"}

package/dist/install-remote-cursors.js

@@ -0,0 +1,153 @@
+import { locateDomFromModelPos } from '@doxi/core';
+const DEFAULT_COLOR = '#1a73e8';
+/**
+ * Mount a remote-cursors overlay inside `view.dom`. The overlay paints a
+ * thin caret + label for every remote peer's cursor in the engine's
+ * tracker.
+ *
+ * v0.6.0 "direct-DOM" approach: positions are resolved from model →
+ * DOM via the core's `locateDomFromModelPos` helper, then pixel-positioned
+ * with a transient Range + getBoundingClientRect. The overlay is an
+ * absolutely positioned `<div class="dx-remote-cursors-layer">` inside
+ * `view.dom` (whose position is forced to `relative` if necessary).
+ *
+ * Repaint policy: while at least one remote cursor exists, repaint every
+ * animation frame (~60Hz). This is intentionally simple — it covers
+ * local edits that shift remote-cursor positions and reflows from window
+ * resizes without wiring into the view's internal lifecycle. Idle when
+ * the tracker is empty.
+ *
+ * Future v0.7+ can migrate to a decorations-based renderer; the on-wire
+ * RemoteCursor shape stays the same.
+ */
+export function installRemoteCursors(view, engine) {
+    const doc = view.dom.ownerDocument;
+    if (!doc)
+        return () => { };
+    const win = doc.defaultView;
+    // Ensure the view.dom is a positioning context. Only override if it is
+    // currently `static` so we don't fight a host that already set
+    // position:relative/absolute on the editor element.
+    const computed = win?.getComputedStyle(view.dom).position;
+    if (!computed || computed === 'static') {
+        view.dom.style.position = 'relative';
+    }
+    const layer = doc.createElement('div');
+    layer.className = 'dx-remote-cursors-layer';
+    // Inline styles as a defensive fallback: if the host page hasn't loaded
+    // the stylesheet, the overlay still positions correctly.
+    layer.style.position = 'absolute';
+    layer.style.top = '0';
+    layer.style.left = '0';
+    layer.style.right = '0';
+    layer.style.bottom = '0';
+    layer.style.pointerEvents = 'none';
+    view.dom.appendChild(layer);
+    let rafHandle = null;
+    let dirty = false;
+    let disposed = false;
+    const schedule = () => {
+        if (disposed)
+            return;
+        if (!win)
+            return;
+        dirty = true;
+        if (rafHandle !== null)
+            return;
+        rafHandle = win.requestAnimationFrame(tick);
+    };
+    const tick = () => {
+        rafHandle = null;
+        if (disposed)
+            return;
+        if (!dirty)
+            return;
+        dirty = false;
+        repaint();
+        // Keep ticking while cursors are present so positions follow local
+        // edits and layout changes. Idle when empty.
+        if (engine.cursorTracker.size() > 0 && win) {
+            rafHandle = win.requestAnimationFrame(tick);
+            dirty = true;
+        }
+    };
+    const repaint = () => {
+        // Clear the layer.
+        while (layer.firstChild)
+            layer.removeChild(layer.firstChild);
+        const cursors = engine.cursorTracker.all();
+        if (cursors.length === 0)
+            return;
+        const viewRect = view.dom.getBoundingClientRect();
+        for (const cursor of cursors) {
+            paintCursor(doc, layer, view, cursor, viewRect);
+        }
+    };
+    const unsubscribe = engine.cursorTracker.subscribe(schedule);
+    // Initial paint, in case cursors are already present at install time.
+    schedule();
+    return () => {
+        if (disposed)
+            return;
+        disposed = true;
+        unsubscribe();
+        if (rafHandle !== null && win) {
+            win.cancelAnimationFrame(rafHandle);
+            rafHandle = null;
+        }
+        if (layer.parentNode === view.dom) {
+            view.dom.removeChild(layer);
+        }
+    };
+}
+function paintCursor(doc, layer, view, cursor, viewRect) {
+    const headPos = cursor.selection.head;
+    const loc = locateDomFromModelPos(view.dom, headPos, view.state.doc);
+    if (!loc)
+        return;
+    const range = doc.createRange();
+    try {
+        range.setStart(loc.node, loc.offset);
+        range.setEnd(loc.node, loc.offset);
+    }
+    catch {
+        return;
+    }
+    const rect = range.getBoundingClientRect();
+    // happy-dom and some browsers return a zero-rect for collapsed ranges
+    // on the start of an empty text node. Fall back to the bounding rect
+    // of the containing element.
+    let left = rect.left;
+    let top = rect.top;
+    let height = rect.height;
+    if (rect.width === 0 && rect.height === 0) {
+        const parent = loc.node.nodeType === 3 ? loc.node.parentElement : loc.node;
+        if (parent) {
+            const pr = parent.getBoundingClientRect();
+            left = pr.left;
+            top = pr.top;
+            height = pr.height;
+        }
+    }
+    if (!Number.isFinite(left) || !Number.isFinite(top))
+        return;
+    const x = left - viewRect.left;
+    const y = top - viewRect.top;
+    const caret = doc.createElement('span');
+    caret.className = 'dx-remote-cursor';
+    caret.dataset.clientId = cursor.clientId;
+    const color = cursor.color ?? DEFAULT_COLOR;
+    caret.style.setProperty('--dx-remote-color', color);
+    caret.style.position = 'absolute';
+    caret.style.left = `${x}px`;
+    caret.style.top = `${y}px`;
+    if (height > 0)
+        caret.style.height = `${height}px`;
+    const label = doc.createElement('span');
+    label.className = 'dx-remote-cursor-label';
+    label.textContent = cursor.label ?? cursor.clientId.slice(0, 6);
+    label.style.setProperty('--dx-remote-color', color);
+    caret.appendChild(label);
+    layer.appendChild(caret);
+}
+//# sourceMappingURL=install-remote-cursors.js.map

package/dist/install-remote-cursors.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,9 @@
+import type { CollabUpdate, RemoteCursor } from './types.js';
+export interface Transport {
+    publish(update: CollabUpdate): void;
+    publishCursor(cursor: RemoteCursor): void;
+    onUpdate(handler: (update: CollabUpdate) => void): () => void;
+    onCursor(handler: (cursor: RemoteCursor) => void): () => void;
+    close(): void;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE5D,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IACnC,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IACzC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAC7D,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAC7D,KAAK,IAAI,IAAI,CAAA;CACd"}

package/dist/transport.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":""}

package/dist/transports/broadcast.d.ts

@@ -0,0 +1,24 @@
+import type { Transport } from '../transport.js';
+import type { CollabUpdate, RemoteCursor } from '../types.js';
+/**
+ * Transport over the same-origin BroadcastChannel API. Lets multiple browser
+ * tabs of the same app act as collaborating peers without a server.
+ *
+ * Note: BroadcastChannel is undefined in some test environments (e.g. older
+ * happy-dom builds). Consumers running in such environments must polyfill or
+ * skip BroadcastChannel-backed tests; coverage of this transport is provided
+ * by the v0.6 e2e two-tab demo.
+ */
+export declare class BroadcastChannelTransport implements Transport {
+    readonly channelName: string;
+    private channel;
+    private updateHandlers;
+    private cursorHandlers;
+    constructor(channelName: string);
+    publish(update: CollabUpdate): void;
+    publishCursor(cursor: RemoteCursor): void;
+    onUpdate(h: (u: CollabUpdate) => void): () => void;
+    onCursor(h: (c: RemoteCursor) => void): () => void;
+    close(): void;
+}
+//# sourceMappingURL=broadcast.d.ts.map

package/dist/transports/broadcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../src/transports/broadcast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAO7D;;;;;;;;GAQG;AACH,qBAAa,yBAA0B,YAAW,SAAS;IAK7C,QAAQ,CAAC,WAAW,EAAE,MAAM;IAJxC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,cAAc,CAAuC;IAC7D,OAAO,CAAC,cAAc,CAAuC;gBAExC,WAAW,EAAE,MAAM;IAaxC,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAInC,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAIzC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI;IAOlD,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI;IAOlD,KAAK,IAAI,IAAI;CAKd"}

package/dist/transports/broadcast.js

@@ -0,0 +1,56 @@
+/**
+ * Transport over the same-origin BroadcastChannel API. Lets multiple browser
+ * tabs of the same app act as collaborating peers without a server.
+ *
+ * Note: BroadcastChannel is undefined in some test environments (e.g. older
+ * happy-dom builds). Consumers running in such environments must polyfill or
+ * skip BroadcastChannel-backed tests; coverage of this transport is provided
+ * by the v0.6 e2e two-tab demo.
+ */
+export class BroadcastChannelTransport {
+    channelName;
+    channel;
+    updateHandlers = new Set();
+    cursorHandlers = new Set();
+    constructor(channelName) {
+        this.channelName = channelName;
+        this.channel = new BroadcastChannel(channelName);
+        this.channel.onmessage = (event) => {
+            const msg = event.data;
+            if (!msg || typeof msg !== 'object')
+                return;
+            if (msg.kind === 'update') {
+                for (const h of this.updateHandlers)
+                    h(msg.payload);
+            }
+            else if (msg.kind === 'cursor') {
+                for (const h of this.cursorHandlers)
+                    h(msg.payload);
+            }
+        };
+    }
+    publish(update) {
+        this.channel.postMessage({ kind: 'update', payload: update });
+    }
+    publishCursor(cursor) {
+        this.channel.postMessage({ kind: 'cursor', payload: cursor });
+    }
+    onUpdate(h) {
+        this.updateHandlers.add(h);
+        return () => {
+            this.updateHandlers.delete(h);
+        };
+    }
+    onCursor(h) {
+        this.cursorHandlers.add(h);
+        return () => {
+            this.cursorHandlers.delete(h);
+        };
+    }
+    close() {
+        this.channel.close();
+        this.updateHandlers.clear();
+        this.cursorHandlers.clear();
+    }
+}
+//# sourceMappingURL=broadcast.js.map

package/dist/transports/broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.js","sourceRoot":"","sources":["../../src/transports/broadcast.ts"],"names":[],"mappings":"AAQA;;;;;;;;GAQG;AACH,MAAM,OAAO,yBAAyB;IAKf;IAJb,OAAO,CAAkB;IACzB,cAAc,GAAG,IAAI,GAAG,EAA6B,CAAA;IACrD,cAAc,GAAG,IAAI,GAAG,EAA6B,CAAA;IAE7D,YAAqB,WAAmB;QAAnB,gBAAW,GAAX,WAAW,CAAQ;QACtC,IAAI,CAAC,OAAO,GAAG,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAA;QAChD,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,CAAC,KAAmB,EAAE,EAAE;YAC/C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAyC,CAAA;YAC3D,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAM;YAC3C,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,cAAc;oBAAE,CAAC,CAAC,GAAG,CAAC,OAAuB,CAAC,CAAA;YACrE,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACjC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,cAAc;oBAAE,CAAC,CAAC,GAAG,CAAC,OAAuB,CAAC,CAAA;YACrE,CAAC;QACH,CAAC,CAAA;IACH,CAAC;IAED,OAAO,CAAC,MAAoB;QAC1B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAA2B,CAAC,CAAA;IACxF,CAAC;IAED,aAAa,CAAC,MAAoB;QAChC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAA2B,CAAC,CAAA;IACxF,CAAC;IAED,QAAQ,CAAC,CAA4B;QACnC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAC1B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QAC/B,CAAC,CAAA;IACH,CAAC;IAED,QAAQ,CAAC,CAA4B;QACnC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAC1B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QAC/B,CAAC,CAAA;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;QACpB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAA;QAC3B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAA;IAC7B,CAAC;CACF"}

package/dist/transports/in-memory.d.ts

@@ -0,0 +1,14 @@
+import type { Transport } from '../transport.js';
+/**
+ * In-process broker that fans CollabUpdates and RemoteCursors out to every
+ * connected peer except the sender. Used for unit tests and same-process
+ * peer simulation.
+ */
+export declare class InMemoryBroker {
+    private peers;
+    /** Create a Transport for a new peer connected to this broker. */
+    connect(): Transport;
+    /** Test helper: number of currently connected peers. */
+    get peerCount(): number;
+}
+//# sourceMappingURL=in-memory.d.ts.map

package/dist/transports/in-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../src/transports/in-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAQhD;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAwB;IAErC,kEAAkE;IAClE,OAAO,IAAI,SAAS;IA0CpB,wDAAwD;IACxD,IAAI,SAAS,IAAI,MAAM,CAEtB;CACF"}

package/dist/transports/in-memory.js

@@ -0,0 +1,62 @@
+/**
+ * In-process broker that fans CollabUpdates and RemoteCursors out to every
+ * connected peer except the sender. Used for unit tests and same-process
+ * peer simulation.
+ */
+export class InMemoryBroker {
+    peers = new Set();
+    /** Create a Transport for a new peer connected to this broker. */
+    connect() {
+        const peer = {
+            onUpdateHandlers: new Set(),
+            onCursorHandlers: new Set(),
+        };
+        this.peers.add(peer);
+        let closed = false;
+        return {
+            publish: (update) => {
+                if (closed)
+                    return;
+                for (const other of this.peers) {
+                    if (other === peer)
+                        continue;
+                    for (const h of other.onUpdateHandlers)
+                        h(update);
+                }
+            },
+            publishCursor: (cursor) => {
+                if (closed)
+                    return;
+                for (const other of this.peers) {
+                    if (other === peer)
+                        continue;
+                    for (const h of other.onCursorHandlers)
+                        h(cursor);
+                }
+            },
+            onUpdate: (h) => {
+                peer.onUpdateHandlers.add(h);
+                return () => {
+                    peer.onUpdateHandlers.delete(h);
+                };
+            },
+            onCursor: (h) => {
+                peer.onCursorHandlers.add(h);
+                return () => {
+                    peer.onCursorHandlers.delete(h);
+                };
+            },
+            close: () => {
+                if (closed)
+                    return;
+                closed = true;
+                this.peers.delete(peer);
+            },
+        };
+    }
+    /** Test helper: number of currently connected peers. */
+    get peerCount() {
+        return this.peers.size;
+    }
+}
+//# sourceMappingURL=in-memory.js.map

package/dist/transports/in-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.js","sourceRoot":"","sources":["../../src/transports/in-memory.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,OAAO,cAAc;IACjB,KAAK,GAAG,IAAI,GAAG,EAAc,CAAA;IAErC,kEAAkE;IAClE,OAAO;QACL,MAAM,IAAI,GAAe;YACvB,gBAAgB,EAAE,IAAI,GAAG,EAAE;YAC3B,gBAAgB,EAAE,IAAI,GAAG,EAAE;SAC5B,CAAA;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACpB,IAAI,MAAM,GAAG,KAAK,CAAA;QAClB,OAAO;YACL,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;gBAClB,IAAI,MAAM;oBAAE,OAAM;gBAClB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBAC/B,IAAI,KAAK,KAAK,IAAI;wBAAE,SAAQ;oBAC5B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB;wBAAE,CAAC,CAAC,MAAM,CAAC,CAAA;gBACnD,CAAC;YACH,CAAC;YACD,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE;gBACxB,IAAI,MAAM;oBAAE,OAAM;gBAClB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBAC/B,IAAI,KAAK,KAAK,IAAI;wBAAE,SAAQ;oBAC5B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB;wBAAE,CAAC,CAAC,MAAM,CAAC,CAAA;gBACnD,CAAC;YACH,CAAC;YACD,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;gBACd,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;gBAC5B,OAAO,GAAG,EAAE;oBACV,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;gBACjC,CAAC,CAAA;YACH,CAAC;YACD,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;gBACd,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;gBAC5B,OAAO,GAAG,EAAE;oBACV,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;gBACjC,CAAC,CAAA;YACH,CAAC;YACD,KAAK,EAAE,GAAG,EAAE;gBACV,IAAI,MAAM;oBAAE,OAAM;gBAClB,MAAM,GAAG,IAAI,CAAA;gBACb,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YACzB,CAAC;SACF,CAAA;IACH,CAAC;IAED,wDAAwD;IACxD,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;IACxB,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,26 @@
+export type ClientId = string;
+export interface Lamport {
+    readonly clock: number;
+    readonly clientId: ClientId;
+}
+export interface CollabUpdate {
+    readonly clientId: ClientId;
+    readonly baseVersion: number;
+    readonly lamport: Lamport;
+    readonly steps: ReadonlyArray<unknown>;
+    readonly source?: string;
+}
+export interface RemoteCursorSelection {
+    readonly type: string;
+    readonly anchor: number;
+    readonly head: number;
+}
+export interface RemoteCursor {
+    readonly clientId: ClientId;
+    readonly label?: string;
+    readonly color?: string;
+    readonly selection: RemoteCursorSelection;
+    readonly lastSeen: number;
+}
+export declare function lamportLessThan(a: Lamport, b: Lamport): 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,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAA;AAE7B,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAA;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAG/D"}

package/dist/types.js

@@ -0,0 +1,6 @@
+export function lamportLessThan(a, b) {
+    if (a.clock !== b.clock)
+        return a.clock < b.clock;
+    return a.clientId < b.clientId;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA6BA,MAAM,UAAU,eAAe,CAAC,CAAU,EAAE,CAAU;IACpD,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;IACjD,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAA;AAChC,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@doxi/collab",
+  "version": "0.11.0",
+  "description": "Doxiva collaboration engine — step-based CRDT and transports.",
+  "license": "MIT",
+  "author": "Mahbub Hasan",
+  "homepage": "https://github.com/mahbub-hasaan/doxiva#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mahbub-hasaan/doxiva.git",
+    "directory": "packages/collab"
+  },
+  "bugs": {
+    "url": "https://github.com/mahbub-hasaan/doxiva/issues"
+  },
+  "keywords": ["collaboration", "crdt", "real-time", "doxiva"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": ["dist", "README.md", "LICENSE"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./transports/in-memory": {
+      "types": "./dist/transports/in-memory.d.ts",
+      "import": "./dist/transports/in-memory.js"
+    },
+    "./transports/broadcast": {
+      "types": "./dist/transports/broadcast.d.ts",
+      "import": "./dist/transports/broadcast.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rimraf dist"
+  },
+  "peerDependencies": {
+    "@doxi/core": "workspace:*"
+  },
+  "devDependencies": {
+    "rimraf": "6.0.1"
+  }
+}