@oh-just-another/collab 0.57.0

package/dist/encryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../src/encryption.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAO1D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAAa,OAAO,CAAC,eAAe,CAU/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,SAAS,CAcxE,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,YAAW,SAAS;IAKhD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,OAAO,CAAC,WAAW,CAA6B;gBAG7B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,OAAO,GAAE;QAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;KAAO;IAOrF,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAI/B,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;IAO7D,KAAK,IAAI,IAAI;YASC,cAAc;YAcd,kBAAkB;CAqBjC"}

package/dist/encryption.js

@@ -0,0 +1,124 @@
+import { ENCRYPTION_IV_BYTES, ENCRYPTION_KEY_BITS, ROOM_ID_BYTES, } from "./constants.js";
+/**
+ * Mint a fresh credentials pair for a new collab session. Uses
+ * `crypto.getRandomValues` for the roomId and `crypto.subtle` for
+ * the AES key.
+ */
+export const generateRoomKey = async () => {
+    const roomId = randomHex(ROOM_ID_BYTES);
+    const key = await crypto.subtle.generateKey({ name: "AES-GCM", length: ENCRYPTION_KEY_BITS }, 
+    /* extractable */ true, ["encrypt", "decrypt"]);
+    const raw = await crypto.subtle.exportKey("raw", key);
+    const keyBase64 = base64UrlEncode(new Uint8Array(raw));
+    return { roomId, keyBase64, key };
+};
+/**
+ * Re-import a key the second peer parsed out of the URL fragment.
+ * Throws on malformed base64 / wrong length so the caller can
+ * surface "broken invite link" cleanly.
+ */
+export const importRoomKey = async (keyBase64) => {
+    const raw = base64UrlDecode(keyBase64);
+    if (raw.byteLength !== ENCRYPTION_KEY_BITS / 8) {
+        throw new Error(`importRoomKey: expected ${ENCRYPTION_KEY_BITS / 8} bytes, got ${raw.byteLength}`);
+    }
+    return crypto.subtle.importKey("raw", raw, { name: "AES-GCM", length: ENCRYPTION_KEY_BITS }, 
+    /* extractable */ false, ["encrypt", "decrypt"]);
+};
+/**
+ * Wrap any {@link Transport} so every outgoing payload is AES-GCM
+ * encrypted and every incoming payload is decrypted before reaching
+ * subscribers. The relay sees nothing but binary blobs.
+ *
+ * Decryption errors are silently dropped — a tampered or
+ * wrong-key frame should not surface as a noisy console error
+ * (that would let a malicious peer flood the log). Callers can opt
+ * into observability by passing `onDecryptError`.
+ */
+export class EncryptedTransport {
+    inner;
+    key;
+    options;
+    handlers = new Set();
+    unsubscribe = null;
+    constructor(inner, key, options = {}) {
+        this.inner = inner;
+        this.key = key;
+        this.options = options;
+        this.unsubscribe = inner.onMessage((cipher) => {
+            void this.decryptAndDispatch(cipher);
+        });
+    }
+    send(payload) {
+        void this.encryptAndSend(payload);
+    }
+    onMessage(handler) {
+        this.handlers.add(handler);
+        return () => {
+            this.handlers.delete(handler);
+        };
+    }
+    close() {
+        if (this.unsubscribe) {
+            this.unsubscribe();
+            this.unsubscribe = null;
+        }
+        this.handlers.clear();
+        this.inner.close();
+    }
+    async encryptAndSend(plaintext) {
+        const iv = crypto.getRandomValues(new Uint8Array(ENCRYPTION_IV_BYTES));
+        const cipherBuf = await crypto.subtle.encrypt({ name: "AES-GCM", iv: iv }, this.key, plaintext);
+        // Frame = IV || ciphertext (with auth tag suffix from AES-GCM).
+        const cipher = new Uint8Array(iv.byteLength + cipherBuf.byteLength);
+        cipher.set(iv, 0);
+        cipher.set(new Uint8Array(cipherBuf), iv.byteLength);
+        this.inner.send(cipher);
+    }
+    async decryptAndDispatch(cipher) {
+        if (cipher.byteLength <= ENCRYPTION_IV_BYTES) {
+            this.options.onDecryptError?.(new Error("payload smaller than IV"));
+            return;
+        }
+        const iv = cipher.subarray(0, ENCRYPTION_IV_BYTES);
+        const body = cipher.subarray(ENCRYPTION_IV_BYTES);
+        let plain;
+        try {
+            plain = await crypto.subtle.decrypt({ name: "AES-GCM", iv: iv }, this.key, body);
+        }
+        catch (err) {
+            this.options.onDecryptError?.(err);
+            return;
+        }
+        const out = new Uint8Array(plain);
+        for (const handler of this.handlers)
+            handler(out);
+    }
+}
+// --- Helpers ---------------------------------------------------------------
+/** Random hex string of `byteCount` bytes (length = byteCount * 2). */
+const randomHex = (byteCount) => {
+    const bytes = crypto.getRandomValues(new Uint8Array(byteCount));
+    return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+};
+/**
+ * Base64url (RFC 4648 §5): standard base64 with `+` → `-`, `/` → `_`,
+ * no `=` padding. URL-safe so the key can live in `location.hash`
+ * without any escaping.
+ */
+const base64UrlEncode = (bytes) => {
+    let bin = "";
+    for (const byte of bytes)
+        bin += String.fromCharCode(byte);
+    return btoa(bin).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+};
+const base64UrlDecode = (s) => {
+    const pad = (4 - (s.length % 4)) % 4;
+    const b64 = s.replace(/-/g, "+").replace(/_/g, "/") + "=".repeat(pad);
+    const bin = atob(b64);
+    const out = new Uint8Array(bin.length);
+    for (let i = 0; i < bin.length; i++)
+        out[i] = bin.charCodeAt(i);
+    return out;
+};
+//# sourceMappingURL=encryption.js.map

package/dist/encryption.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { SceneDoc } from "./scene-doc.js";
+export { bindEditor } from "./bind-editor.js";
+export { CollabAwareness, type Peer, type PeerUser } from "./awareness.js";
+export { TransportProvider, type TransportProviderOptions } from "./transport-provider.js";
+export { bindAwareness, type BindAwarenessOptions } from "./bind-awareness.js";
+export { extractMentions, resolveMentions, notifyMention } from "./mentions.js";
+export type { BranchId, BranchMergeAPI, ConflictChoice, ConflictResolution, MergeConflict, MergeReport, } from "./merge.js";
+export { BranchDoc } from "./branch-doc.js";
+export { YjsHistory, type YjsHistoryOptions } from "./yjs-history.js";
+export { generateRoomKey, importRoomKey, EncryptedTransport, type RoomCredentials, } from "./encryption.js";
+export { ROOM_ID_BYTES, ENCRYPTION_KEY_BITS, ENCRYPTION_IV_BYTES, } from "./constants.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,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGhF,YAAY,EACV,QAAQ,EACR,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGtE,OAAO,EACL,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export { SceneDoc } from "./scene-doc.js";
+export { bindEditor } from "./bind-editor.js";
+export { CollabAwareness } from "./awareness.js";
+export { TransportProvider } from "./transport-provider.js";
+export { bindAwareness } from "./bind-awareness.js";
+export { extractMentions, resolveMentions, notifyMention } from "./mentions.js";
+export { BranchDoc } from "./branch-doc.js";
+// Y.UndoManager-based history backend.
+export { YjsHistory } from "./yjs-history.js";
+// Client-side AES-GCM for blind-relay collab.
+export { generateRoomKey, importRoomKey, EncryptedTransport, } from "./encryption.js";
+export { ROOM_ID_BYTES, ENCRYPTION_KEY_BITS, ENCRYPTION_IV_BYTES, } from "./constants.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,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAA4B,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAiC,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,aAAa,EAA6B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAWhF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,uCAAuC;AACvC,OAAO,EAAE,UAAU,EAA0B,MAAM,kBAAkB,CAAC;AAEtE,8CAA8C;AAC9C,OAAO,EACL,eAAe,EACf,aAAa,EACb,kBAAkB,GAEnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/mentions.d.ts

@@ -0,0 +1,33 @@
+import type { Peer } from "./awareness.js";
+/**
+ * Extract `@username` tokens from a comment body. Matches alphanumeric
+ * + underscore handles after `@`, lowercased for case-insensitive
+ * lookup. Anchors on a word boundary so e-mail addresses (`foo@bar.com`)
+ * don't false-match.
+ */
+export declare const extractMentions: (body: string) => readonly string[];
+/**
+ * Match mention tokens against the peer list (case-insensitive on the
+ * peer's display name, with whitespace stripped). Returns matched
+ * peers — duplicate filter applied so each peer appears at most once
+ * even if mentioned several times.
+ */
+export declare const resolveMentions: (mentions: readonly string[], peers: readonly Peer[]) => Peer[];
+/**
+ * Fire a browser Notification if the local user has been mentioned.
+ * `notif` is the platform's `Notification` constructor (host passes
+ * `globalThis.Notification` in browser code). No-op when not granted
+ * or constructor missing — keeps `@collab` portable to Node.
+ */
+export declare const notifyMention: (notif: {
+    new (title: string, options?: {
+        body?: string;
+        tag?: string;
+    }): unknown;
+    permission: string;
+} | undefined, opts: {
+    readonly authorName: string;
+    readonly body: string;
+    readonly room?: string;
+}) => void;
+//# sourceMappingURL=mentions.d.ts.map

package/dist/mentions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.d.ts","sourceRoot":"","sources":["../src/mentions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,SAAS,MAAM,EAS7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,SAAS,MAAM,EAAE,EAAE,OAAO,SAAS,IAAI,EAAE,KAAG,IAAI,EAczF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,OAAO;IAAE,KAAK,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAClH,MAAM;IACJ,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,KACA,IAQF,CAAC"}

package/dist/mentions.js

@@ -0,0 +1,57 @@
+/**
+ * Extract `@username` tokens from a comment body. Matches alphanumeric
+ * + underscore handles after `@`, lowercased for case-insensitive
+ * lookup. Anchors on a word boundary so e-mail addresses (`foo@bar.com`)
+ * don't false-match.
+ */
+export const extractMentions = (body) => {
+    const out = [];
+    const re = /(^|\s)@(\w+)/g;
+    let match;
+    while ((match = re.exec(body)) !== null) {
+        const handle = match[2];
+        if (handle !== undefined)
+            out.push(handle.toLowerCase());
+    }
+    return out;
+};
+/**
+ * Match mention tokens against the peer list (case-insensitive on the
+ * peer's display name, with whitespace stripped). Returns matched
+ * peers — duplicate filter applied so each peer appears at most once
+ * even if mentioned several times.
+ */
+export const resolveMentions = (mentions, peers) => {
+    const seen = new Set();
+    const out = [];
+    for (const tag of mentions) {
+        for (const p of peers) {
+            if (seen.has(p.clientId))
+                continue;
+            const normalised = p.user.name.replace(/\s+/g, "").toLowerCase();
+            if (normalised === tag) {
+                out.push(p);
+                seen.add(p.clientId);
+            }
+        }
+    }
+    return out;
+};
+/**
+ * Fire a browser Notification if the local user has been mentioned.
+ * `notif` is the platform's `Notification` constructor (host passes
+ * `globalThis.Notification` in browser code). No-op when not granted
+ * or constructor missing — keeps `@collab` portable to Node.
+ */
+export const notifyMention = (notif, opts) => {
+    if (!notif)
+        return;
+    if (notif.permission !== "granted")
+        return;
+    const title = `${opts.authorName} mentioned you`;
+    new notif(title, {
+        body: opts.body.slice(0, 140),
+        tag: opts.room ?? "diagram-mention",
+    });
+};
+//# sourceMappingURL=mentions.js.map

package/dist/mentions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.js","sourceRoot":"","sources":["../src/mentions.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAqB,EAAE;IACjE,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,EAAE,GAAG,eAAe,CAAC;IAC3B,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,MAAM,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAA2B,EAAE,KAAsB,EAAU,EAAE;IAC7F,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAW,EAAE,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACnC,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YACjE,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;gBACvB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACZ,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,KAAkH,EAClH,IAIC,EACK,EAAE;IACR,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO;IAC3C,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,UAAU,gBAAgB,CAAC;IACjD,IAAI,KAAK,CAAC,KAAK,EAAE;QACf,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QAC7B,GAAG,EAAE,IAAI,CAAC,IAAI,IAAI,iBAAiB;KACpC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/merge.d.ts

@@ -0,0 +1,59 @@
+import type { ElementId } from "@oh-just-another/types";
+import type { Scene } from "@oh-just-another/scene";
+/**
+ * CRDT branch merge editor-facing API. The runtime implementation
+ * lives on Y.Doc subdocs; this contract lets hosts wire UI
+ * (`<MergeDialog>`) against a stable surface.
+ *
+ * Branch model:
+ *   Each named branch = its own Y.Doc subdoc inside the parent.
+ *   Snapshots inside a branch are versioned per its own history;
+ *   merging a source branch into a target performs a three-way
+ *   merge against their common ancestor.
+ */
+export interface BranchId {
+    readonly id: string;
+    readonly name: string;
+    readonly parentVersionId: string | null;
+}
+export interface MergeConflict {
+    readonly elementId: ElementId;
+    readonly base: unknown;
+    readonly source: unknown;
+    readonly target: unknown;
+}
+export interface MergeReport {
+    readonly applied: readonly ElementId[];
+    readonly conflicts: readonly MergeConflict[];
+    /**
+     * The resulting scene after auto-applying non-conflicting
+     * changes. Conflicts are NOT applied — the host UI resolves
+     * them and produces a final scene via `applyConflictResolution`.
+     */
+    readonly autoMerged: Scene;
+}
+/**
+ * Resolution choice made by the user in `<MergeDialog>`.
+ *
+ *   - `ours`     keep the target version of the shape.
+ *   - `theirs`   keep the source version of the shape.
+ *   - `both`     keep both — `theirs` lands as a duplicate with a
+ *                "-copy" suffixed id. Convention not contract;
+ *                hosts can supply their own id-rewriter.
+ */
+export type ConflictChoice = "ours" | "theirs" | "both";
+export interface ConflictResolution {
+    readonly elementId: ElementId;
+    readonly choice: ConflictChoice;
+}
+/**
+ * Implementation hook. The kernel does NOT ship one — collab
+ * authors plug their Yjs-backed implementation into a host
+ * editor instance.
+ */
+export interface BranchMergeAPI {
+    branchToDoc(branchId: BranchId): unknown;
+    mergeBranch(source: BranchId, target: BranchId): Promise<MergeReport>;
+    applyConflictResolution(report: MergeReport, resolutions: readonly ConflictResolution[]): Promise<Scene>;
+}
+//# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzC,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACtE,uBAAuB,CACrB,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,SAAS,kBAAkB,EAAE,GACzC,OAAO,CAAC,KAAK,CAAC,CAAC;CACnB"}

package/dist/merge.js

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

package/dist/merge.js.map

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

package/dist/scene-doc.d.ts

@@ -0,0 +1,41 @@
+import * as Y from "yjs";
+import { type Annotation, type Link, type Layer, type Scene, type Element } from "@oh-just-another/scene";
+/**
+ * CRDT-backed mirror of a `Scene`. Wraps a `Y.Doc` whose top-level maps
+ * are the canonical source of truth for collaborative editing:
+ *
+ *   - `elements` — `Y.Map<string, Element>`
+ *   - `links`    — `Y.Map<string, Link>`
+ *   - `layers`   — `Y.Map<string, Layer>`
+ *   - `viewport` — `Y.Map<string, unknown>` (single "current" key)
+ *
+ * Elements / links / layers are stored as deep-cloned JSON snapshots — Yjs
+ * happily ships any structured-cloneable object. Concurrent edits to
+ * different ids merge automatically (last-writer-wins per id, classic
+ * Yjs `Y.Map` semantics).
+ */
+export declare class SceneDoc {
+    readonly doc: Y.Doc;
+    readonly elements: Y.Map<Element>;
+    readonly links: Y.Map<Link>;
+    readonly layers: Y.Map<Layer>;
+    readonly annotations: Y.Map<Annotation>;
+    readonly viewport: Y.Map<unknown>;
+    constructor(doc?: Y.Doc);
+    /** Build an in-memory `Scene` snapshot from the current CRDT state. */
+    snapshot(): Scene;
+    /**
+     * Replace the entire CRDT state with the given `Scene`. Wrapped in a
+     * single Yjs transaction so peers receive one update message instead of
+     * one per shape. Marks the transaction with `origin` so observers can
+     * skip the event they themselves caused.
+     */
+    replace(scene: Scene, origin?: unknown): void;
+    /**
+     * Apply only the *delta* between an old scene and a new one. Cheaper
+     * over the wire than `replace` when a single shape changes. Used by
+     * `bindEditor` to ferry every editor mutation into the CRDT.
+     */
+    applyDelta(prev: Scene, next: Scene, origin?: unknown): void;
+}
+//# sourceMappingURL=scene-doc.d.ts.map

package/dist/scene-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-doc.d.ts","sourceRoot":"","sources":["../src/scene-doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,IAAI,EACT,KAAK,KAAK,EACV,KAAK,KAAK,EACV,KAAK,OAAO,EACb,MAAM,wBAAwB,CAAC;AAGhC;;;;;;;;;;;;;GAaG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAEtB,GAAG,GAAE,CAAC,CAAC,GAAiB;IASpC,uEAAuE;IACvE,QAAQ,IAAI,KAAK;IA2BjB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAc7C;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;CAW7D"}

package/dist/scene-doc.js

@@ -0,0 +1,111 @@
+import * as Y from "yjs";
+import { DEFAULT_VIEWPORT, } from "@oh-just-another/scene";
+import { annotationId, layerId, linkId, elementId } from "@oh-just-another/types";
+/**
+ * CRDT-backed mirror of a `Scene`. Wraps a `Y.Doc` whose top-level maps
+ * are the canonical source of truth for collaborative editing:
+ *
+ *   - `elements` — `Y.Map<string, Element>`
+ *   - `links`    — `Y.Map<string, Link>`
+ *   - `layers`   — `Y.Map<string, Layer>`
+ *   - `viewport` — `Y.Map<string, unknown>` (single "current" key)
+ *
+ * Elements / links / layers are stored as deep-cloned JSON snapshots — Yjs
+ * happily ships any structured-cloneable object. Concurrent edits to
+ * different ids merge automatically (last-writer-wins per id, classic
+ * Yjs `Y.Map` semantics).
+ */
+export class SceneDoc {
+    doc;
+    elements;
+    links;
+    layers;
+    annotations;
+    viewport;
+    constructor(doc = new Y.Doc()) {
+        this.doc = doc;
+        this.elements = doc.getMap("elements");
+        this.links = doc.getMap("links");
+        this.layers = doc.getMap("layers");
+        this.annotations = doc.getMap("annotations");
+        this.viewport = doc.getMap("viewport");
+    }
+    /** Build an in-memory `Scene` snapshot from the current CRDT state. */
+    snapshot() {
+        const shapeMap = new Map();
+        for (const [id, shape] of this.elements)
+            shapeMap.set(elementId(id), shape);
+        const edgeMap = new Map();
+        for (const [id, edge] of this.links)
+            edgeMap.set(linkId(id), edge);
+        const layerMap = new Map();
+        for (const [id, layer] of this.layers)
+            layerMap.set(layerId(id), layer);
+        const vp = this.viewport.get("current");
+        const viewport = (vp ?? DEFAULT_VIEWPORT);
+        const annotationMap = new Map();
+        for (const [id, ann] of this.annotations)
+            annotationMap.set(annotationId(id), ann);
+        return {
+            elements: shapeMap,
+            links: edgeMap,
+            layers: layerMap,
+            annotations: annotationMap,
+            // BinaryFile registry isn't CRDT-replicated (large bytes, awkward
+            // through Yjs); hosts that need collab on file uploads keep their
+            // own sidecar transport. Snapshot returns an empty map.
+            files: new Map(),
+            viewport,
+        };
+    }
+    /**
+     * Replace the entire CRDT state with the given `Scene`. Wrapped in a
+     * single Yjs transaction so peers receive one update message instead of
+     * one per shape. Marks the transaction with `origin` so observers can
+     * skip the event they themselves caused.
+     */
+    replace(scene, origin) {
+        this.doc.transact(() => {
+            this.elements.clear();
+            for (const [id, shape] of scene.elements)
+                this.elements.set(id, shape);
+            this.links.clear();
+            for (const [id, edge] of scene.links)
+                this.links.set(id, edge);
+            this.layers.clear();
+            for (const [id, layer] of scene.layers)
+                this.layers.set(id, layer);
+            this.annotations.clear();
+            for (const [id, ann] of scene.annotations)
+                this.annotations.set(id, ann);
+            this.viewport.set("current", scene.viewport);
+        }, origin);
+    }
+    /**
+     * Apply only the *delta* between an old scene and a new one. Cheaper
+     * over the wire than `replace` when a single shape changes. Used by
+     * `bindEditor` to ferry every editor mutation into the CRDT.
+     */
+    applyDelta(prev, next, origin) {
+        this.doc.transact(() => {
+            diffMap(prev.elements, next.elements, this.elements);
+            diffMap(prev.links, next.links, this.links);
+            diffMap(prev.layers, next.layers, this.layers);
+            diffMap(prev.annotations, next.annotations, this.annotations);
+            if (prev.viewport !== next.viewport) {
+                this.viewport.set("current", next.viewport);
+            }
+        }, origin);
+    }
+}
+const diffMap = (prev, next, target) => {
+    for (const [id] of prev) {
+        if (!next.has(id))
+            target.delete(id);
+    }
+    for (const [id, value] of next) {
+        if (prev.get(id) !== value)
+            target.set(id, value);
+    }
+};
+//# sourceMappingURL=scene-doc.js.map

package/dist/scene-doc.js.map

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

package/dist/transport-provider.d.ts

@@ -0,0 +1,21 @@
+import * as Y from "yjs";
+import { type Awareness } from "y-protocols/awareness";
+import type { Transport } from "@oh-just-another/network";
+export interface TransportProviderOptions {
+    readonly doc: Y.Doc;
+    readonly transport: Transport;
+    readonly awareness?: Awareness;
+}
+export declare class TransportProvider {
+    private readonly doc;
+    private readonly transport;
+    private readonly awareness;
+    private readonly origin;
+    private readonly unsubscribeMessage;
+    constructor(options: TransportProviderOptions);
+    destroy(): void;
+    private readonly onInbound;
+    private readonly onDocUpdate;
+    private readonly onAwarenessUpdate;
+}
+//# sourceMappingURL=transport-provider.d.ts.map

package/dist/transport-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-provider.d.ts","sourceRoot":"","sources":["../src/transport-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAA+C,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AA2B1D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;CAChC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAa;gBAEpC,OAAO,EAAE,wBAAwB;IAkB7C,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,QAAQ,CAAC,SAAS,CA0BxB;IAIF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAG1B;IAEF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAShC;CACH"}

package/dist/transport-provider.js

@@ -0,0 +1,105 @@
+import * as Y from "yjs";
+import { applyAwarenessUpdate, encodeAwarenessUpdate } from "y-protocols/awareness";
+/**
+ * Bridge a `Y.Doc` (and optional `Awareness`) onto a `Transport`. Every
+ * Yjs update is wrapped in a tiny 1-byte tag so a single channel can
+ * multiplex document and awareness messages.
+ *
+ *   tag 0x00 → Yjs document update
+ *   tag 0x01 → awareness update
+ *   tag 0x02 → state-sync request (joiner asks for the current full state)
+ *
+ * Use:
+ *
+ * ```ts
+ * const provider = new TransportProvider({
+ *   doc,
+ *   awareness: new CollabAwareness(doc).awareness,
+ *   transport: new BroadcastChannelTransport("room-foo"),
+ * });
+ * // …later
+ * provider.destroy();
+ * ```
+ */
+const TAG_DOC = 0;
+const TAG_AWARENESS = 1;
+const TAG_SYNC_REQUEST = 2;
+export class TransportProvider {
+    doc;
+    transport;
+    awareness;
+    origin = Symbol("transport-provider");
+    unsubscribeMessage;
+    constructor(options) {
+        this.doc = options.doc;
+        this.transport = options.transport;
+        this.awareness = options.awareness ?? null;
+        // Forward local doc updates downstream — but only ones we didn't
+        // ourselves apply (avoid echo).
+        this.doc.on("updateV2", this.onDocUpdate);
+        if (this.awareness) {
+            this.awareness.on("update", this.onAwarenessUpdate);
+        }
+        this.unsubscribeMessage = this.transport.onMessage(this.onInbound);
+        // Ask peers for their current state on join.
+        this.transport.send(new Uint8Array([TAG_SYNC_REQUEST]));
+    }
+    destroy() {
+        this.doc.off("updateV2", this.onDocUpdate);
+        if (this.awareness)
+            this.awareness.off("update", this.onAwarenessUpdate);
+        this.unsubscribeMessage();
+    }
+    // --- inbound ---
+    onInbound = (payload) => {
+        const tag = payload[0];
+        if (tag === undefined)
+            return;
+        const body = payload.subarray(1);
+        switch (tag) {
+            case TAG_DOC:
+                Y.applyUpdateV2(this.doc, body, this.origin);
+                return;
+            case TAG_AWARENESS:
+                if (this.awareness)
+                    applyAwarenessUpdate(this.awareness, body, this.origin);
+                return;
+            case TAG_SYNC_REQUEST: {
+                // Reply with our full doc state + awareness so the joiner catches up.
+                const docPayload = Y.encodeStateAsUpdateV2(this.doc);
+                this.transport.send(prependTag(TAG_DOC, docPayload));
+                if (this.awareness) {
+                    const clients = [...this.awareness.getStates().keys()];
+                    const awarenessPayload = encodeAwarenessUpdate(this.awareness, clients);
+                    this.transport.send(prependTag(TAG_AWARENESS, awarenessPayload));
+                }
+                return;
+            }
+            default:
+                // Unknown tag — silently ignore; lets the wire format extend later.
+                return;
+        }
+    };
+    // --- outbound ---
+    onDocUpdate = (update, originOfUpdate) => {
+        if (originOfUpdate === this.origin)
+            return;
+        this.transport.send(prependTag(TAG_DOC, update));
+    };
+    onAwarenessUpdate = (_, originOfUpdate) => {
+        if (originOfUpdate === this.origin)
+            return;
+        if (!this.awareness)
+            return;
+        const changedClients = [..._.added, ..._.updated, ..._.removed];
+        const payload = encodeAwarenessUpdate(this.awareness, changedClients);
+        this.transport.send(prependTag(TAG_AWARENESS, payload));
+    };
+}
+const prependTag = (tag, body) => {
+    const out = new Uint8Array(body.length + 1);
+    out[0] = tag;
+    out.set(body, 1);
+    return out;
+};
+//# sourceMappingURL=transport-provider.js.map