@liveblocks/prosemirror 0.0.0 → 3.21.0-exp4

package/LICENSE

@@ -0,0 +1,16 @@
+Copyright 2021-present Liveblocks
+
+This repository contains software under two licenses:
+
+1. Most of the code in this repository is licensed under the
+   Apache License 2.0 — see licenses/LICENSE-APACHE-2.0 for the
+   full license text.
+
+2. The following components are licensed under the
+   GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later)
+   — see licenses/LICENSE-AGPL-3.0 for the full license text:
+
+   - packages/liveblocks-server (published as @liveblocks/server)
+   - tools/liveblocks-cli (published as liveblocks)
+
+Each package's own LICENSE or package.json specifies its applicable license.

package/README.md

@@ -0,0 +1,3 @@
+# `@liveblocks/prosemirror`
+
+ProseMirror collaboration plugins backed by Liveblocks.

package/dist/cursors.cjs

@@ -0,0 +1,217 @@
+'use strict';
+
+var prosemirrorState = require('prosemirror-state');
+var prosemirrorView = require('prosemirror-view');
+var plugin = require('./plugin.cjs');
+
+const LIVEBLOCKS_CARET_PRESENCE_KEY = "liveblocksTiptap";
+const LIVEBLOCKS_CARET_PLUGIN_KEY = new prosemirrorState.PluginKey("liveblocks-collaboration-caret");
+function isCursorPresence(value) {
+  return typeof value === "object" && value !== null && typeof value.field === "string" && typeof value.anchor === "number" && typeof value.head === "number";
+}
+function getCursorUser(value) {
+  if (typeof value !== "object" || value === null) {
+    return void 0;
+  }
+  const user = value;
+  const name = typeof user.name === "string" ? user.name : void 0;
+  const color = typeof user.color === "string" ? user.color : void 0;
+  return name !== void 0 || color !== void 0 ? { name, color } : void 0;
+}
+function presencePatch(presence) {
+  const user = getCursorUser(presence.user);
+  return {
+    [LIVEBLOCKS_CARET_PRESENCE_KEY]: {
+      field: presence.field,
+      anchor: presence.anchor,
+      head: presence.head,
+      ...user !== void 0 ? { user } : {}
+    }
+  };
+}
+function createCursorElement(user) {
+  const color = user?.color ?? "#0f83ff";
+  const name = user?.name ?? "Anonymous";
+  const cursor = document.createElement("span");
+  cursor.classList.add("collaboration-carets__caret");
+  cursor.setAttribute("style", `border-color: ${color}`);
+  const label = document.createElement("div");
+  label.classList.add("collaboration-carets__label");
+  label.setAttribute("style", `background-color: ${color}`);
+  label.insertBefore(document.createTextNode(name), null);
+  cursor.insertBefore(label, null);
+  return cursor;
+}
+function clampPosition(position, doc) {
+  return Math.max(0, Math.min(position, doc.content.size));
+}
+function normalizeCaretPosition(position, doc) {
+  const clampedPosition = clampPosition(position, doc);
+  const $position = doc.resolve(clampedPosition);
+  if ($position.parent.isTextblock) {
+    return clampedPosition;
+  }
+  return prosemirrorState.Selection.near($position, -1).anchor;
+}
+function getRemoteCursors(room, field, previousCursors = []) {
+  const cursors = [];
+  for (const other of room.getOthers()) {
+    const rawPresence = other.presence[LIVEBLOCKS_CARET_PRESENCE_KEY];
+    if (!isCursorPresence(rawPresence) || rawPresence.field !== field) {
+      continue;
+    }
+    const user = getCursorUser(rawPresence.user) ?? getCursorUser(other.info);
+    const previousCursor = previousCursors.find(
+      (cursor) => cursor.connectionId === other.connectionId
+    );
+    const hasPresencePositionChanged = previousCursor === void 0 || previousCursor.rawAnchor !== rawPresence.anchor || previousCursor.rawHead !== rawPresence.head;
+    cursors.push({
+      anchor: hasPresencePositionChanged ? rawPresence.anchor : previousCursor.anchor,
+      connectionId: other.connectionId,
+      head: hasPresencePositionChanged ? rawPresence.head : previousCursor.head,
+      rawAnchor: rawPresence.anchor,
+      rawHead: rawPresence.head,
+      user
+    });
+  }
+  return cursors;
+}
+function buildDecorationsFromCursors(cursors, doc) {
+  const decorations = [];
+  for (const cursor of cursors) {
+    const anchor = clampPosition(cursor.anchor, doc);
+    const head = clampPosition(cursor.head, doc);
+    const from = Math.min(anchor, head);
+    const to = Math.max(anchor, head);
+    const user = cursor.user;
+    const color = user?.color ?? "#0f83ff";
+    if (from !== to) {
+      decorations.push(
+        prosemirrorView.Decoration.inline(from, to, {
+          class: "collaboration-carets__selection",
+          style: `background-color: ${color}33`
+        })
+      );
+    }
+    decorations.push(
+      prosemirrorView.Decoration.widget(
+        normalizeCaretPosition(head, doc),
+        () => createCursorElement(user),
+        {
+          key: `liveblocks-caret-${cursor.connectionId}`,
+          side: -1
+        }
+      )
+    );
+  }
+  return prosemirrorView.DecorationSet.create(doc, decorations);
+}
+function createLiveblocksCollaborationCaretPlugin(options, storage) {
+  const room = options.room;
+  if (room === void 0) {
+    throw new Error("[Liveblocks] The Liveblocks caret plugin requires a room.");
+  }
+  let view;
+  let unsubscribe;
+  const updatePresence = (nextView) => {
+    const { anchor, head } = nextView.state.selection;
+    room.updatePresence(
+      presencePatch({
+        field: options.field,
+        anchor,
+        head,
+        user: options.user
+      })
+    );
+  };
+  const updateDecorations = () => {
+    if (view === void 0) {
+      return;
+    }
+    storage.users = room.getOthers().map((other) => {
+      const rawPresence = other.presence[LIVEBLOCKS_CARET_PRESENCE_KEY];
+      const cursorPresence = isCursorPresence(rawPresence) ? rawPresence : void 0;
+      return {
+        clientId: other.connectionId,
+        ...getCursorUser(cursorPresence?.user) ?? getCursorUser(other.info)
+      };
+    });
+    const previousCursors = LIVEBLOCKS_CARET_PLUGIN_KEY.getState(view.state)?.cursors ?? [];
+    const cursors = getRemoteCursors(room, options.field, previousCursors);
+    view.dispatch(
+      view.state.tr.setMeta(LIVEBLOCKS_CARET_PLUGIN_KEY, {
+        cursors
+      })
+    );
+  };
+  return new prosemirrorState.Plugin({
+    key: LIVEBLOCKS_CARET_PLUGIN_KEY,
+    state: {
+      init(_, state) {
+        return {
+          cursors: [],
+          decorations: prosemirrorView.DecorationSet.create(state.doc, [])
+        };
+      },
+      apply(tr, state) {
+        const meta = tr.getMeta(LIVEBLOCKS_CARET_PLUGIN_KEY);
+        if (meta !== void 0) {
+          return {
+            cursors: meta.cursors,
+            decorations: buildDecorationsFromCursors(meta.cursors, tr.doc)
+          };
+        }
+        if (!tr.docChanged) {
+          return state;
+        }
+        if (!tr.getMeta(plugin.LIVEBLOCKS_COLLABORATION_PLUGIN_KEY)) {
+          const cursors = state.cursors.map((cursor) => ({
+            ...cursor,
+            anchor: tr.mapping.map(cursor.anchor, -1),
+            head: tr.mapping.map(cursor.head, -1)
+          }));
+          return {
+            cursors,
+            decorations: buildDecorationsFromCursors(cursors, tr.doc)
+          };
+        }
+        return {
+          cursors: state.cursors,
+          decorations: buildDecorationsFromCursors(state.cursors, tr.doc)
+        };
+      }
+    },
+    props: {
+      decorations(state) {
+        return LIVEBLOCKS_CARET_PLUGIN_KEY.getState(state)?.decorations ?? prosemirrorView.DecorationSet.empty;
+      }
+    },
+    view(editorView) {
+      view = editorView;
+      updatePresence(editorView);
+      updateDecorations();
+      unsubscribe = room.events.others.subscribe(updateDecorations);
+      return {
+        update(nextView, prevState) {
+          view = nextView;
+          if (!nextView.state.selection.eq(prevState.selection)) {
+            updatePresence(nextView);
+          }
+        },
+        destroy() {
+          unsubscribe?.();
+          unsubscribe = void 0;
+          view = void 0;
+          room.updatePresence({ [LIVEBLOCKS_CARET_PRESENCE_KEY]: null });
+        }
+      };
+    }
+  });
+}
+
+exports.LIVEBLOCKS_CARET_PLUGIN_KEY = LIVEBLOCKS_CARET_PLUGIN_KEY;
+exports.LIVEBLOCKS_CARET_PRESENCE_KEY = LIVEBLOCKS_CARET_PRESENCE_KEY;
+exports.createLiveblocksCollaborationCaretPlugin = createLiveblocksCollaborationCaretPlugin;
+exports.getCursorUser = getCursorUser;
+exports.presencePatch = presencePatch;
+//# sourceMappingURL=cursors.cjs.map

package/dist/cursors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursors.cjs","sources":["../src/cursors.ts"],"sourcesContent":["import type { JsonObject } from \"@liveblocks/client\";\nimport type { Node as ProseMirrorNode } from \"prosemirror-model\";\nimport { Plugin, PluginKey, Selection } from \"prosemirror-state\";\nimport type { EditorView } from \"prosemirror-view\";\nimport { Decoration, DecorationSet } from \"prosemirror-view\";\n\nimport { LIVEBLOCKS_COLLABORATION_PLUGIN_KEY } from \"./plugin\";\nimport type { LiveblocksProsemirrorRoom } from \"./types\";\n\nexport const LIVEBLOCKS_CARET_PRESENCE_KEY = \"liveblocksTiptap\";\n\nexport type CursorUser = {\n  name?: string;\n  color?: string;\n};\n\ntype CursorPresence = {\n  field: string;\n  anchor: number;\n  head: number;\n  user?: CursorUser;\n};\n\nexport type CollaborationCaretStorage = {\n  users: { clientId: number; [key: string]: unknown }[];\n};\n\nexport type RemoteCursor = {\n  anchor: number;\n  connectionId: number;\n  head: number;\n  rawAnchor: number;\n  rawHead: number;\n  user?: CursorUser;\n};\n\nexport type CollaborationCaretPluginState = {\n  cursors: RemoteCursor[];\n  decorations: DecorationSet;\n};\n\nexport type CollaborationCaretOptions = {\n  room?: LiveblocksProsemirrorRoom;\n  field: string;\n  user: CursorUser;\n};\n\nexport const LIVEBLOCKS_CARET_PLUGIN_KEY =\n  new PluginKey<CollaborationCaretPluginState>(\"liveblocks-collaboration-caret\");\n\nfunction isCursorPresence(value: unknown): value is CursorPresence {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as { field?: unknown }).field === \"string\" &&\n    typeof (value as { anchor?: unknown }).anchor === \"number\" &&\n    typeof (value as { head?: unknown }).head === \"number\"\n  );\n}\n\nexport function getCursorUser(value: unknown): CursorUser | undefined {\n  if (typeof value !== \"object\" || value === null) {\n    return undefined;\n  }\n\n  const user = value as { name?: unknown; color?: unknown };\n  const name = typeof user.name === \"string\" ? user.name : undefined;\n  const color = typeof user.color === \"string\" ? user.color : undefined;\n\n  return name !== undefined || color !== undefined ? { name, color } : undefined;\n}\n\nexport function presencePatch(presence: CursorPresence): JsonObject {\n  const user = getCursorUser(presence.user);\n\n  return {\n    [LIVEBLOCKS_CARET_PRESENCE_KEY]: {\n      field: presence.field,\n      anchor: presence.anchor,\n      head: presence.head,\n      ...(user !== undefined ? { user } : {}),\n    },\n  };\n}\n\nfunction createCursorElement(user: CursorUser | undefined): HTMLElement {\n  const color = user?.color ?? \"#0f83ff\";\n  const name = user?.name ?? \"Anonymous\";\n  const cursor = document.createElement(\"span\");\n\n  cursor.classList.add(\"collaboration-carets__caret\");\n  cursor.setAttribute(\"style\", `border-color: ${color}`);\n\n  const label = document.createElement(\"div\");\n  label.classList.add(\"collaboration-carets__label\");\n  label.setAttribute(\"style\", `background-color: ${color}`);\n  label.insertBefore(document.createTextNode(name), null);\n  cursor.insertBefore(label, null);\n\n  return cursor;\n}\n\nfunction clampPosition(position: number, doc: ProseMirrorNode): number {\n  return Math.max(0, Math.min(position, doc.content.size));\n}\n\nfunction normalizeCaretPosition(position: number, doc: ProseMirrorNode): number {\n  const clampedPosition = clampPosition(position, doc);\n  const $position = doc.resolve(clampedPosition);\n\n  if ($position.parent.isTextblock) {\n    return clampedPosition;\n  }\n\n  return Selection.near($position, -1).anchor;\n}\n\nfunction getRemoteCursors(\n  room: LiveblocksProsemirrorRoom,\n  field: string,\n  previousCursors: readonly RemoteCursor[] = []\n): RemoteCursor[] {\n  const cursors: RemoteCursor[] = [];\n\n  for (const other of room.getOthers()) {\n    const rawPresence: unknown = other.presence[LIVEBLOCKS_CARET_PRESENCE_KEY];\n    if (!isCursorPresence(rawPresence) || rawPresence.field !== field) {\n      continue;\n    }\n\n    const user = getCursorUser(rawPresence.user) ?? getCursorUser(other.info);\n    const previousCursor = previousCursors.find(\n      (cursor) => cursor.connectionId === other.connectionId\n    );\n    const hasPresencePositionChanged =\n      previousCursor === undefined ||\n      previousCursor.rawAnchor !== rawPresence.anchor ||\n      previousCursor.rawHead !== rawPresence.head;\n\n    cursors.push({\n      anchor: hasPresencePositionChanged\n        ? rawPresence.anchor\n        : previousCursor.anchor,\n      connectionId: other.connectionId,\n      head: hasPresencePositionChanged ? rawPresence.head : previousCursor.head,\n      rawAnchor: rawPresence.anchor,\n      rawHead: rawPresence.head,\n      user,\n    });\n  }\n\n  return cursors;\n}\n\nfunction buildDecorationsFromCursors(\n  cursors: readonly RemoteCursor[],\n  doc: ProseMirrorNode\n): DecorationSet {\n  const decorations: Decoration[] = [];\n\n  for (const cursor of cursors) {\n    const anchor = clampPosition(cursor.anchor, doc);\n    const head = clampPosition(cursor.head, doc);\n    const from = Math.min(anchor, head);\n    const to = Math.max(anchor, head);\n    const user = cursor.user;\n    const color = user?.color ?? \"#0f83ff\";\n\n    if (from !== to) {\n      decorations.push(\n        Decoration.inline(from, to, {\n          class: \"collaboration-carets__selection\",\n          style: `background-color: ${color}33`,\n        })\n      );\n    }\n\n    decorations.push(\n      Decoration.widget(\n        normalizeCaretPosition(head, doc),\n        () => createCursorElement(user),\n        {\n          key: `liveblocks-caret-${cursor.connectionId}`,\n          side: -1,\n        }\n      )\n    );\n  }\n\n  return DecorationSet.create(doc, decorations);\n}\n\nexport function createLiveblocksCollaborationCaretPlugin(\n  options: CollaborationCaretOptions,\n  storage: CollaborationCaretStorage\n): Plugin {\n  const room = options.room;\n  if (room === undefined) {\n    throw new Error(\"[Liveblocks] The Liveblocks caret plugin requires a room.\");\n  }\n\n  let view: EditorView | undefined;\n  let unsubscribe: (() => void) | undefined;\n\n  const updatePresence = (nextView: EditorView) => {\n    const { anchor, head } = nextView.state.selection;\n    room.updatePresence(\n      presencePatch({\n        field: options.field,\n        anchor,\n        head,\n        user: options.user,\n      })\n    );\n  };\n\n  const updateDecorations = () => {\n    if (view === undefined) {\n      return;\n    }\n\n    storage.users = room.getOthers().map((other) => {\n      const rawPresence: unknown = other.presence[LIVEBLOCKS_CARET_PRESENCE_KEY];\n      const cursorPresence = isCursorPresence(rawPresence)\n        ? rawPresence\n        : undefined;\n\n      return {\n        clientId: other.connectionId,\n        ...(getCursorUser(cursorPresence?.user) ?? getCursorUser(other.info)),\n      };\n    });\n\n    const previousCursors =\n      LIVEBLOCKS_CARET_PLUGIN_KEY.getState(view.state)?.cursors ?? [];\n    const cursors = getRemoteCursors(room, options.field, previousCursors);\n\n    view.dispatch(\n      view.state.tr.setMeta(LIVEBLOCKS_CARET_PLUGIN_KEY, {\n        cursors,\n      })\n    );\n  };\n\n  return new Plugin({\n    key: LIVEBLOCKS_CARET_PLUGIN_KEY,\n    state: {\n      init(_, state): CollaborationCaretPluginState {\n        return {\n          cursors: [],\n          decorations: DecorationSet.create(state.doc, []),\n        };\n      },\n      apply(tr, state): CollaborationCaretPluginState {\n        const meta = tr.getMeta(LIVEBLOCKS_CARET_PLUGIN_KEY) as\n          | { cursors: RemoteCursor[] }\n          | undefined;\n\n        if (meta !== undefined) {\n          return {\n            cursors: meta.cursors,\n            decorations: buildDecorationsFromCursors(meta.cursors, tr.doc),\n          };\n        }\n\n        if (!tr.docChanged) {\n          return state;\n        }\n\n        if (!tr.getMeta(LIVEBLOCKS_COLLABORATION_PLUGIN_KEY)) {\n          const cursors = state.cursors.map((cursor) => ({\n            ...cursor,\n            anchor: tr.mapping.map(cursor.anchor, -1),\n            head: tr.mapping.map(cursor.head, -1),\n          }));\n\n          return {\n            cursors,\n            decorations: buildDecorationsFromCursors(cursors, tr.doc),\n          };\n        }\n\n        // Remote presence can arrive before the matching remote document\n        // update. Keep the stored cursor positions and rebuild them against\n        // the new document so pre-arrived presence is no longer clamped to the\n        // old document size.\n        return {\n          cursors: state.cursors,\n          decorations: buildDecorationsFromCursors(state.cursors, tr.doc),\n        };\n      },\n    },\n    props: {\n      decorations(state) {\n        return (\n          LIVEBLOCKS_CARET_PLUGIN_KEY.getState(state)?.decorations ??\n          DecorationSet.empty\n        );\n      },\n    },\n    view(editorView) {\n      view = editorView;\n      updatePresence(editorView);\n      updateDecorations();\n      unsubscribe = room.events.others.subscribe(updateDecorations);\n\n      return {\n        update(nextView, prevState) {\n          view = nextView;\n\n          if (!nextView.state.selection.eq(prevState.selection)) {\n            updatePresence(nextView);\n          }\n\n        },\n        destroy() {\n          unsubscribe?.();\n          unsubscribe = undefined;\n          view = undefined;\n          room.updatePresence({ [LIVEBLOCKS_CARET_PRESENCE_KEY]: null });\n        },\n      };\n    },\n  });\n}\n"],"names":["PluginKey","Selection","Decoration","DecorationSet","Plugin","LIVEBLOCKS_COLLABORATION_PLUGIN_KEY"],"mappings":"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"}

package/dist/cursors.js

@@ -0,0 +1,211 @@
+import { PluginKey, Selection, Plugin } from 'prosemirror-state';
+import { Decoration, DecorationSet } from 'prosemirror-view';
+import { LIVEBLOCKS_COLLABORATION_PLUGIN_KEY } from './plugin.js';
+
+const LIVEBLOCKS_CARET_PRESENCE_KEY = "liveblocksTiptap";
+const LIVEBLOCKS_CARET_PLUGIN_KEY = new PluginKey("liveblocks-collaboration-caret");
+function isCursorPresence(value) {
+  return typeof value === "object" && value !== null && typeof value.field === "string" && typeof value.anchor === "number" && typeof value.head === "number";
+}
+function getCursorUser(value) {
+  if (typeof value !== "object" || value === null) {
+    return void 0;
+  }
+  const user = value;
+  const name = typeof user.name === "string" ? user.name : void 0;
+  const color = typeof user.color === "string" ? user.color : void 0;
+  return name !== void 0 || color !== void 0 ? { name, color } : void 0;
+}
+function presencePatch(presence) {
+  const user = getCursorUser(presence.user);
+  return {
+    [LIVEBLOCKS_CARET_PRESENCE_KEY]: {
+      field: presence.field,
+      anchor: presence.anchor,
+      head: presence.head,
+      ...user !== void 0 ? { user } : {}
+    }
+  };
+}
+function createCursorElement(user) {
+  const color = user?.color ?? "#0f83ff";
+  const name = user?.name ?? "Anonymous";
+  const cursor = document.createElement("span");
+  cursor.classList.add("collaboration-carets__caret");
+  cursor.setAttribute("style", `border-color: ${color}`);
+  const label = document.createElement("div");
+  label.classList.add("collaboration-carets__label");
+  label.setAttribute("style", `background-color: ${color}`);
+  label.insertBefore(document.createTextNode(name), null);
+  cursor.insertBefore(label, null);
+  return cursor;
+}
+function clampPosition(position, doc) {
+  return Math.max(0, Math.min(position, doc.content.size));
+}
+function normalizeCaretPosition(position, doc) {
+  const clampedPosition = clampPosition(position, doc);
+  const $position = doc.resolve(clampedPosition);
+  if ($position.parent.isTextblock) {
+    return clampedPosition;
+  }
+  return Selection.near($position, -1).anchor;
+}
+function getRemoteCursors(room, field, previousCursors = []) {
+  const cursors = [];
+  for (const other of room.getOthers()) {
+    const rawPresence = other.presence[LIVEBLOCKS_CARET_PRESENCE_KEY];
+    if (!isCursorPresence(rawPresence) || rawPresence.field !== field) {
+      continue;
+    }
+    const user = getCursorUser(rawPresence.user) ?? getCursorUser(other.info);
+    const previousCursor = previousCursors.find(
+      (cursor) => cursor.connectionId === other.connectionId
+    );
+    const hasPresencePositionChanged = previousCursor === void 0 || previousCursor.rawAnchor !== rawPresence.anchor || previousCursor.rawHead !== rawPresence.head;
+    cursors.push({
+      anchor: hasPresencePositionChanged ? rawPresence.anchor : previousCursor.anchor,
+      connectionId: other.connectionId,
+      head: hasPresencePositionChanged ? rawPresence.head : previousCursor.head,
+      rawAnchor: rawPresence.anchor,
+      rawHead: rawPresence.head,
+      user
+    });
+  }
+  return cursors;
+}
+function buildDecorationsFromCursors(cursors, doc) {
+  const decorations = [];
+  for (const cursor of cursors) {
+    const anchor = clampPosition(cursor.anchor, doc);
+    const head = clampPosition(cursor.head, doc);
+    const from = Math.min(anchor, head);
+    const to = Math.max(anchor, head);
+    const user = cursor.user;
+    const color = user?.color ?? "#0f83ff";
+    if (from !== to) {
+      decorations.push(
+        Decoration.inline(from, to, {
+          class: "collaboration-carets__selection",
+          style: `background-color: ${color}33`
+        })
+      );
+    }
+    decorations.push(
+      Decoration.widget(
+        normalizeCaretPosition(head, doc),
+        () => createCursorElement(user),
+        {
+          key: `liveblocks-caret-${cursor.connectionId}`,
+          side: -1
+        }
+      )
+    );
+  }
+  return DecorationSet.create(doc, decorations);
+}
+function createLiveblocksCollaborationCaretPlugin(options, storage) {
+  const room = options.room;
+  if (room === void 0) {
+    throw new Error("[Liveblocks] The Liveblocks caret plugin requires a room.");
+  }
+  let view;
+  let unsubscribe;
+  const updatePresence = (nextView) => {
+    const { anchor, head } = nextView.state.selection;
+    room.updatePresence(
+      presencePatch({
+        field: options.field,
+        anchor,
+        head,
+        user: options.user
+      })
+    );
+  };
+  const updateDecorations = () => {
+    if (view === void 0) {
+      return;
+    }
+    storage.users = room.getOthers().map((other) => {
+      const rawPresence = other.presence[LIVEBLOCKS_CARET_PRESENCE_KEY];
+      const cursorPresence = isCursorPresence(rawPresence) ? rawPresence : void 0;
+      return {
+        clientId: other.connectionId,
+        ...getCursorUser(cursorPresence?.user) ?? getCursorUser(other.info)
+      };
+    });
+    const previousCursors = LIVEBLOCKS_CARET_PLUGIN_KEY.getState(view.state)?.cursors ?? [];
+    const cursors = getRemoteCursors(room, options.field, previousCursors);
+    view.dispatch(
+      view.state.tr.setMeta(LIVEBLOCKS_CARET_PLUGIN_KEY, {
+        cursors
+      })
+    );
+  };
+  return new Plugin({
+    key: LIVEBLOCKS_CARET_PLUGIN_KEY,
+    state: {
+      init(_, state) {
+        return {
+          cursors: [],
+          decorations: DecorationSet.create(state.doc, [])
+        };
+      },
+      apply(tr, state) {
+        const meta = tr.getMeta(LIVEBLOCKS_CARET_PLUGIN_KEY);
+        if (meta !== void 0) {
+          return {
+            cursors: meta.cursors,
+            decorations: buildDecorationsFromCursors(meta.cursors, tr.doc)
+          };
+        }
+        if (!tr.docChanged) {
+          return state;
+        }
+        if (!tr.getMeta(LIVEBLOCKS_COLLABORATION_PLUGIN_KEY)) {
+          const cursors = state.cursors.map((cursor) => ({
+            ...cursor,
+            anchor: tr.mapping.map(cursor.anchor, -1),
+            head: tr.mapping.map(cursor.head, -1)
+          }));
+          return {
+            cursors,
+            decorations: buildDecorationsFromCursors(cursors, tr.doc)
+          };
+        }
+        return {
+          cursors: state.cursors,
+          decorations: buildDecorationsFromCursors(state.cursors, tr.doc)
+        };
+      }
+    },
+    props: {
+      decorations(state) {
+        return LIVEBLOCKS_CARET_PLUGIN_KEY.getState(state)?.decorations ?? DecorationSet.empty;
+      }
+    },
+    view(editorView) {
+      view = editorView;
+      updatePresence(editorView);
+      updateDecorations();
+      unsubscribe = room.events.others.subscribe(updateDecorations);
+      return {
+        update(nextView, prevState) {
+          view = nextView;
+          if (!nextView.state.selection.eq(prevState.selection)) {
+            updatePresence(nextView);
+          }
+        },
+        destroy() {
+          unsubscribe?.();
+          unsubscribe = void 0;
+          view = void 0;
+          room.updatePresence({ [LIVEBLOCKS_CARET_PRESENCE_KEY]: null });
+        }
+      };
+    }
+  });
+}
+
+export { LIVEBLOCKS_CARET_PLUGIN_KEY, LIVEBLOCKS_CARET_PRESENCE_KEY, createLiveblocksCollaborationCaretPlugin, getCursorUser, presencePatch };
+//# sourceMappingURL=cursors.js.map

package/dist/cursors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursors.js","sources":["../src/cursors.ts"],"sourcesContent":["import type { JsonObject } from \"@liveblocks/client\";\nimport type { Node as ProseMirrorNode } from \"prosemirror-model\";\nimport { Plugin, PluginKey, Selection } from \"prosemirror-state\";\nimport type { EditorView } from \"prosemirror-view\";\nimport { Decoration, DecorationSet } from \"prosemirror-view\";\n\nimport { LIVEBLOCKS_COLLABORATION_PLUGIN_KEY } from \"./plugin\";\nimport type { LiveblocksProsemirrorRoom } from \"./types\";\n\nexport const LIVEBLOCKS_CARET_PRESENCE_KEY = \"liveblocksTiptap\";\n\nexport type CursorUser = {\n  name?: string;\n  color?: string;\n};\n\ntype CursorPresence = {\n  field: string;\n  anchor: number;\n  head: number;\n  user?: CursorUser;\n};\n\nexport type CollaborationCaretStorage = {\n  users: { clientId: number; [key: string]: unknown }[];\n};\n\nexport type RemoteCursor = {\n  anchor: number;\n  connectionId: number;\n  head: number;\n  rawAnchor: number;\n  rawHead: number;\n  user?: CursorUser;\n};\n\nexport type CollaborationCaretPluginState = {\n  cursors: RemoteCursor[];\n  decorations: DecorationSet;\n};\n\nexport type CollaborationCaretOptions = {\n  room?: LiveblocksProsemirrorRoom;\n  field: string;\n  user: CursorUser;\n};\n\nexport const LIVEBLOCKS_CARET_PLUGIN_KEY =\n  new PluginKey<CollaborationCaretPluginState>(\"liveblocks-collaboration-caret\");\n\nfunction isCursorPresence(value: unknown): value is CursorPresence {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as { field?: unknown }).field === \"string\" &&\n    typeof (value as { anchor?: unknown }).anchor === \"number\" &&\n    typeof (value as { head?: unknown }).head === \"number\"\n  );\n}\n\nexport function getCursorUser(value: unknown): CursorUser | undefined {\n  if (typeof value !== \"object\" || value === null) {\n    return undefined;\n  }\n\n  const user = value as { name?: unknown; color?: unknown };\n  const name = typeof user.name === \"string\" ? user.name : undefined;\n  const color = typeof user.color === \"string\" ? user.color : undefined;\n\n  return name !== undefined || color !== undefined ? { name, color } : undefined;\n}\n\nexport function presencePatch(presence: CursorPresence): JsonObject {\n  const user = getCursorUser(presence.user);\n\n  return {\n    [LIVEBLOCKS_CARET_PRESENCE_KEY]: {\n      field: presence.field,\n      anchor: presence.anchor,\n      head: presence.head,\n      ...(user !== undefined ? { user } : {}),\n    },\n  };\n}\n\nfunction createCursorElement(user: CursorUser | undefined): HTMLElement {\n  const color = user?.color ?? \"#0f83ff\";\n  const name = user?.name ?? \"Anonymous\";\n  const cursor = document.createElement(\"span\");\n\n  cursor.classList.add(\"collaboration-carets__caret\");\n  cursor.setAttribute(\"style\", `border-color: ${color}`);\n\n  const label = document.createElement(\"div\");\n  label.classList.add(\"collaboration-carets__label\");\n  label.setAttribute(\"style\", `background-color: ${color}`);\n  label.insertBefore(document.createTextNode(name), null);\n  cursor.insertBefore(label, null);\n\n  return cursor;\n}\n\nfunction clampPosition(position: number, doc: ProseMirrorNode): number {\n  return Math.max(0, Math.min(position, doc.content.size));\n}\n\nfunction normalizeCaretPosition(position: number, doc: ProseMirrorNode): number {\n  const clampedPosition = clampPosition(position, doc);\n  const $position = doc.resolve(clampedPosition);\n\n  if ($position.parent.isTextblock) {\n    return clampedPosition;\n  }\n\n  return Selection.near($position, -1).anchor;\n}\n\nfunction getRemoteCursors(\n  room: LiveblocksProsemirrorRoom,\n  field: string,\n  previousCursors: readonly RemoteCursor[] = []\n): RemoteCursor[] {\n  const cursors: RemoteCursor[] = [];\n\n  for (const other of room.getOthers()) {\n    const rawPresence: unknown = other.presence[LIVEBLOCKS_CARET_PRESENCE_KEY];\n    if (!isCursorPresence(rawPresence) || rawPresence.field !== field) {\n      continue;\n    }\n\n    const user = getCursorUser(rawPresence.user) ?? getCursorUser(other.info);\n    const previousCursor = previousCursors.find(\n      (cursor) => cursor.connectionId === other.connectionId\n    );\n    const hasPresencePositionChanged =\n      previousCursor === undefined ||\n      previousCursor.rawAnchor !== rawPresence.anchor ||\n      previousCursor.rawHead !== rawPresence.head;\n\n    cursors.push({\n      anchor: hasPresencePositionChanged\n        ? rawPresence.anchor\n        : previousCursor.anchor,\n      connectionId: other.connectionId,\n      head: hasPresencePositionChanged ? rawPresence.head : previousCursor.head,\n      rawAnchor: rawPresence.anchor,\n      rawHead: rawPresence.head,\n      user,\n    });\n  }\n\n  return cursors;\n}\n\nfunction buildDecorationsFromCursors(\n  cursors: readonly RemoteCursor[],\n  doc: ProseMirrorNode\n): DecorationSet {\n  const decorations: Decoration[] = [];\n\n  for (const cursor of cursors) {\n    const anchor = clampPosition(cursor.anchor, doc);\n    const head = clampPosition(cursor.head, doc);\n    const from = Math.min(anchor, head);\n    const to = Math.max(anchor, head);\n    const user = cursor.user;\n    const color = user?.color ?? \"#0f83ff\";\n\n    if (from !== to) {\n      decorations.push(\n        Decoration.inline(from, to, {\n          class: \"collaboration-carets__selection\",\n          style: `background-color: ${color}33`,\n        })\n      );\n    }\n\n    decorations.push(\n      Decoration.widget(\n        normalizeCaretPosition(head, doc),\n        () => createCursorElement(user),\n        {\n          key: `liveblocks-caret-${cursor.connectionId}`,\n          side: -1,\n        }\n      )\n    );\n  }\n\n  return DecorationSet.create(doc, decorations);\n}\n\nexport function createLiveblocksCollaborationCaretPlugin(\n  options: CollaborationCaretOptions,\n  storage: CollaborationCaretStorage\n): Plugin {\n  const room = options.room;\n  if (room === undefined) {\n    throw new Error(\"[Liveblocks] The Liveblocks caret plugin requires a room.\");\n  }\n\n  let view: EditorView | undefined;\n  let unsubscribe: (() => void) | undefined;\n\n  const updatePresence = (nextView: EditorView) => {\n    const { anchor, head } = nextView.state.selection;\n    room.updatePresence(\n      presencePatch({\n        field: options.field,\n        anchor,\n        head,\n        user: options.user,\n      })\n    );\n  };\n\n  const updateDecorations = () => {\n    if (view === undefined) {\n      return;\n    }\n\n    storage.users = room.getOthers().map((other) => {\n      const rawPresence: unknown = other.presence[LIVEBLOCKS_CARET_PRESENCE_KEY];\n      const cursorPresence = isCursorPresence(rawPresence)\n        ? rawPresence\n        : undefined;\n\n      return {\n        clientId: other.connectionId,\n        ...(getCursorUser(cursorPresence?.user) ?? getCursorUser(other.info)),\n      };\n    });\n\n    const previousCursors =\n      LIVEBLOCKS_CARET_PLUGIN_KEY.getState(view.state)?.cursors ?? [];\n    const cursors = getRemoteCursors(room, options.field, previousCursors);\n\n    view.dispatch(\n      view.state.tr.setMeta(LIVEBLOCKS_CARET_PLUGIN_KEY, {\n        cursors,\n      })\n    );\n  };\n\n  return new Plugin({\n    key: LIVEBLOCKS_CARET_PLUGIN_KEY,\n    state: {\n      init(_, state): CollaborationCaretPluginState {\n        return {\n          cursors: [],\n          decorations: DecorationSet.create(state.doc, []),\n        };\n      },\n      apply(tr, state): CollaborationCaretPluginState {\n        const meta = tr.getMeta(LIVEBLOCKS_CARET_PLUGIN_KEY) as\n          | { cursors: RemoteCursor[] }\n          | undefined;\n\n        if (meta !== undefined) {\n          return {\n            cursors: meta.cursors,\n            decorations: buildDecorationsFromCursors(meta.cursors, tr.doc),\n          };\n        }\n\n        if (!tr.docChanged) {\n          return state;\n        }\n\n        if (!tr.getMeta(LIVEBLOCKS_COLLABORATION_PLUGIN_KEY)) {\n          const cursors = state.cursors.map((cursor) => ({\n            ...cursor,\n            anchor: tr.mapping.map(cursor.anchor, -1),\n            head: tr.mapping.map(cursor.head, -1),\n          }));\n\n          return {\n            cursors,\n            decorations: buildDecorationsFromCursors(cursors, tr.doc),\n          };\n        }\n\n        // Remote presence can arrive before the matching remote document\n        // update. Keep the stored cursor positions and rebuild them against\n        // the new document so pre-arrived presence is no longer clamped to the\n        // old document size.\n        return {\n          cursors: state.cursors,\n          decorations: buildDecorationsFromCursors(state.cursors, tr.doc),\n        };\n      },\n    },\n    props: {\n      decorations(state) {\n        return (\n          LIVEBLOCKS_CARET_PLUGIN_KEY.getState(state)?.decorations ??\n          DecorationSet.empty\n        );\n      },\n    },\n    view(editorView) {\n      view = editorView;\n      updatePresence(editorView);\n      updateDecorations();\n      unsubscribe = room.events.others.subscribe(updateDecorations);\n\n      return {\n        update(nextView, prevState) {\n          view = nextView;\n\n          if (!nextView.state.selection.eq(prevState.selection)) {\n            updatePresence(nextView);\n          }\n\n        },\n        destroy() {\n          unsubscribe?.();\n          unsubscribe = undefined;\n          view = undefined;\n          room.updatePresence({ [LIVEBLOCKS_CARET_PRESENCE_KEY]: null });\n        },\n      };\n    },\n  });\n}\n"],"names":[],"mappings":";;;;AASO,MAAM,6BAAgC,GAAA,mBAAA;AAsChC,MAAA,2BAAA,GACX,IAAI,SAAA,CAAyC,gCAAgC,EAAA;AAE/E,SAAS,iBAAiB,KAAyC,EAAA;AACjE,EAAA,OACE,OAAO,KAAA,KAAU,QACjB,IAAA,KAAA,KAAU,QACV,OAAQ,KAAA,CAA8B,KAAU,KAAA,QAAA,IAChD,OAAQ,KAA+B,CAAA,MAAA,KAAW,QAClD,IAAA,OAAQ,MAA6B,IAAS,KAAA,QAAA,CAAA;AAElD,CAAA;AAEO,SAAS,cAAc,KAAwC,EAAA;AACpE,EAAA,IAAI,OAAO,KAAA,KAAU,QAAY,IAAA,KAAA,KAAU,IAAM,EAAA;AAC/C,IAAO,OAAA,KAAA,CAAA,CAAA;AAAA,GACT;AAEA,EAAA,MAAM,IAAO,GAAA,KAAA,CAAA;AACb,EAAA,MAAM,OAAO,OAAO,IAAA,CAAK,IAAS,KAAA,QAAA,GAAW,KAAK,IAAO,GAAA,KAAA,CAAA,CAAA;AACzD,EAAA,MAAM,QAAQ,OAAO,IAAA,CAAK,KAAU,KAAA,QAAA,GAAW,KAAK,KAAQ,GAAA,KAAA,CAAA,CAAA;AAE5D,EAAA,OAAO,SAAS,KAAa,CAAA,IAAA,KAAA,KAAU,SAAY,EAAE,IAAA,EAAM,OAAU,GAAA,KAAA,CAAA,CAAA;AACvE,CAAA;AAEO,SAAS,cAAc,QAAsC,EAAA;AAClE,EAAM,MAAA,IAAA,GAAO,aAAc,CAAA,QAAA,CAAS,IAAI,CAAA,CAAA;AAExC,EAAO,OAAA;AAAA,IACL,CAAC,6BAA6B,GAAG;AAAA,MAC/B,OAAO,QAAS,CAAA,KAAA;AAAA,MAChB,QAAQ,QAAS,CAAA,MAAA;AAAA,MACjB,MAAM,QAAS,CAAA,IAAA;AAAA,MACf,GAAI,IAAS,KAAA,KAAA,CAAA,GAAY,EAAE,IAAA,KAAS,EAAC;AAAA,KACvC;AAAA,GACF,CAAA;AACF,CAAA;AAEA,SAAS,oBAAoB,IAA2C,EAAA;AACtE,EAAM,MAAA,KAAA,GAAQ,MAAM,KAAS,IAAA,SAAA,CAAA;AAC7B,EAAM,MAAA,IAAA,GAAO,MAAM,IAAQ,IAAA,WAAA,CAAA;AAC3B,EAAM,MAAA,MAAA,GAAS,QAAS,CAAA,aAAA,CAAc,MAAM,CAAA,CAAA;AAE5C,EAAO,MAAA,CAAA,SAAA,CAAU,IAAI,6BAA6B,CAAA,CAAA;AAClD,EAAA,MAAA,CAAO,YAAa,CAAA,OAAA,EAAS,CAAiB,cAAA,EAAA,KAAK,CAAE,CAAA,CAAA,CAAA;AAErD,EAAM,MAAA,KAAA,GAAQ,QAAS,CAAA,aAAA,CAAc,KAAK,CAAA,CAAA;AAC1C,EAAM,KAAA,CAAA,SAAA,CAAU,IAAI,6BAA6B,CAAA,CAAA;AACjD,EAAA,KAAA,CAAM,YAAa,CAAA,OAAA,EAAS,CAAqB,kBAAA,EAAA,KAAK,CAAE,CAAA,CAAA,CAAA;AACxD,EAAA,KAAA,CAAM,YAAa,CAAA,QAAA,CAAS,cAAe,CAAA,IAAI,GAAG,IAAI,CAAA,CAAA;AACtD,EAAO,MAAA,CAAA,YAAA,CAAa,OAAO,IAAI,CAAA,CAAA;AAE/B,EAAO,OAAA,MAAA,CAAA;AACT,CAAA;AAEA,SAAS,aAAA,CAAc,UAAkB,GAA8B,EAAA;AACrE,EAAO,OAAA,IAAA,CAAK,IAAI,CAAG,EAAA,IAAA,CAAK,IAAI,QAAU,EAAA,GAAA,CAAI,OAAQ,CAAA,IAAI,CAAC,CAAA,CAAA;AACzD,CAAA;AAEA,SAAS,sBAAA,CAAuB,UAAkB,GAA8B,EAAA;AAC9E,EAAM,MAAA,eAAA,GAAkB,aAAc,CAAA,QAAA,EAAU,GAAG,CAAA,CAAA;AACnD,EAAM,MAAA,SAAA,GAAY,GAAI,CAAA,OAAA,CAAQ,eAAe,CAAA,CAAA;AAE7C,EAAI,IAAA,SAAA,CAAU,OAAO,WAAa,EAAA;AAChC,IAAO,OAAA,eAAA,CAAA;AAAA,GACT;AAEA,EAAA,OAAO,SAAU,CAAA,IAAA,CAAK,SAAW,EAAA,CAAA,CAAE,CAAE,CAAA,MAAA,CAAA;AACvC,CAAA;AAEA,SAAS,gBACP,CAAA,IAAA,EACA,KACA,EAAA,eAAA,GAA2C,EAC3B,EAAA;AAChB,EAAA,MAAM,UAA0B,EAAC,CAAA;AAEjC,EAAW,KAAA,MAAA,KAAA,IAAS,IAAK,CAAA,SAAA,EAAa,EAAA;AACpC,IAAM,MAAA,WAAA,GAAuB,KAAM,CAAA,QAAA,CAAS,6BAA6B,CAAA,CAAA;AACzE,IAAA,IAAI,CAAC,gBAAiB,CAAA,WAAW,CAAK,IAAA,WAAA,CAAY,UAAU,KAAO,EAAA;AACjE,MAAA,SAAA;AAAA,KACF;AAEA,IAAA,MAAM,OAAO,aAAc,CAAA,WAAA,CAAY,IAAI,CAAK,IAAA,aAAA,CAAc,MAAM,IAAI,CAAA,CAAA;AACxE,IAAA,MAAM,iBAAiB,eAAgB,CAAA,IAAA;AAAA,MACrC,CAAC,MAAA,KAAW,MAAO,CAAA,YAAA,KAAiB,KAAM,CAAA,YAAA;AAAA,KAC5C,CAAA;AACA,IAAM,MAAA,0BAAA,GACJ,mBAAmB,KACnB,CAAA,IAAA,cAAA,CAAe,cAAc,WAAY,CAAA,MAAA,IACzC,cAAe,CAAA,OAAA,KAAY,WAAY,CAAA,IAAA,CAAA;AAEzC,IAAA,OAAA,CAAQ,IAAK,CAAA;AAAA,MACX,MAAQ,EAAA,0BAAA,GACJ,WAAY,CAAA,MAAA,GACZ,cAAe,CAAA,MAAA;AAAA,MACnB,cAAc,KAAM,CAAA,YAAA;AAAA,MACpB,IAAM,EAAA,0BAAA,GAA6B,WAAY,CAAA,IAAA,GAAO,cAAe,CAAA,IAAA;AAAA,MACrE,WAAW,WAAY,CAAA,MAAA;AAAA,MACvB,SAAS,WAAY,CAAA,IAAA;AAAA,MACrB,IAAA;AAAA,KACD,CAAA,CAAA;AAAA,GACH;AAEA,EAAO,OAAA,OAAA,CAAA;AACT,CAAA;AAEA,SAAS,2BAAA,CACP,SACA,GACe,EAAA;AACf,EAAA,MAAM,cAA4B,EAAC,CAAA;AAEnC,EAAA,KAAA,MAAW,UAAU,OAAS,EAAA;AAC5B,IAAA,MAAM,MAAS,GAAA,aAAA,CAAc,MAAO,CAAA,MAAA,EAAQ,GAAG,CAAA,CAAA;AAC/C,IAAA,MAAM,IAAO,GAAA,aAAA,CAAc,MAAO,CAAA,IAAA,EAAM,GAAG,CAAA,CAAA;AAC3C,IAAA,MAAM,IAAO,GAAA,IAAA,CAAK,GAAI,CAAA,MAAA,EAAQ,IAAI,CAAA,CAAA;AAClC,IAAA,MAAM,EAAK,GAAA,IAAA,CAAK,GAAI,CAAA,MAAA,EAAQ,IAAI,CAAA,CAAA;AAChC,IAAA,MAAM,OAAO,MAAO,CAAA,IAAA,CAAA;AACpB,IAAM,MAAA,KAAA,GAAQ,MAAM,KAAS,IAAA,SAAA,CAAA;AAE7B,IAAA,IAAI,SAAS,EAAI,EAAA;AACf,MAAY,WAAA,CAAA,IAAA;AAAA,QACV,UAAA,CAAW,MAAO,CAAA,IAAA,EAAM,EAAI,EAAA;AAAA,UAC1B,KAAO,EAAA,iCAAA;AAAA,UACP,KAAA,EAAO,qBAAqB,KAAK,CAAA,EAAA,CAAA;AAAA,SAClC,CAAA;AAAA,OACH,CAAA;AAAA,KACF;AAEA,IAAY,WAAA,CAAA,IAAA;AAAA,MACV,UAAW,CAAA,MAAA;AAAA,QACT,sBAAA,CAAuB,MAAM,GAAG,CAAA;AAAA,QAChC,MAAM,oBAAoB,IAAI,CAAA;AAAA,QAC9B;AAAA,UACE,GAAA,EAAK,CAAoB,iBAAA,EAAA,MAAA,CAAO,YAAY,CAAA,CAAA;AAAA,UAC5C,IAAM,EAAA,CAAA,CAAA;AAAA,SACR;AAAA,OACF;AAAA,KACF,CAAA;AAAA,GACF;AAEA,EAAO,OAAA,aAAA,CAAc,MAAO,CAAA,GAAA,EAAK,WAAW,CAAA,CAAA;AAC9C,CAAA;AAEgB,SAAA,wCAAA,CACd,SACA,OACQ,EAAA;AACR,EAAA,MAAM,OAAO,OAAQ,CAAA,IAAA,CAAA;AACrB,EAAA,IAAI,SAAS,KAAW,CAAA,EAAA;AACtB,IAAM,MAAA,IAAI,MAAM,2DAA2D,CAAA,CAAA;AAAA,GAC7E;AAEA,EAAI,IAAA,IAAA,CAAA;AACJ,EAAI,IAAA,WAAA,CAAA;AAEJ,EAAM,MAAA,cAAA,GAAiB,CAAC,QAAyB,KAAA;AAC/C,IAAA,MAAM,EAAE,MAAA,EAAQ,IAAK,EAAA,GAAI,SAAS,KAAM,CAAA,SAAA,CAAA;AACxC,IAAK,IAAA,CAAA,cAAA;AAAA,MACH,aAAc,CAAA;AAAA,QACZ,OAAO,OAAQ,CAAA,KAAA;AAAA,QACf,MAAA;AAAA,QACA,IAAA;AAAA,QACA,MAAM,OAAQ,CAAA,IAAA;AAAA,OACf,CAAA;AAAA,KACH,CAAA;AAAA,GACF,CAAA;AAEA,EAAA,MAAM,oBAAoB,MAAM;AAC9B,IAAA,IAAI,SAAS,KAAW,CAAA,EAAA;AACtB,MAAA,OAAA;AAAA,KACF;AAEA,IAAA,OAAA,CAAQ,QAAQ,IAAK,CAAA,SAAA,EAAY,CAAA,GAAA,CAAI,CAAC,KAAU,KAAA;AAC9C,MAAM,MAAA,WAAA,GAAuB,KAAM,CAAA,QAAA,CAAS,6BAA6B,CAAA,CAAA;AACzE,MAAA,MAAM,cAAiB,GAAA,gBAAA,CAAiB,WAAW,CAAA,GAC/C,WACA,GAAA,KAAA,CAAA,CAAA;AAEJ,MAAO,OAAA;AAAA,QACL,UAAU,KAAM,CAAA,YAAA;AAAA,QAChB,GAAI,aAAc,CAAA,cAAA,EAAgB,IAAI,CAAK,IAAA,aAAA,CAAc,MAAM,IAAI,CAAA;AAAA,OACrE,CAAA;AAAA,KACD,CAAA,CAAA;AAED,IAAA,MAAM,kBACJ,2BAA4B,CAAA,QAAA,CAAS,KAAK,KAAK,CAAA,EAAG,WAAW,EAAC,CAAA;AAChE,IAAA,MAAM,OAAU,GAAA,gBAAA,CAAiB,IAAM,EAAA,OAAA,CAAQ,OAAO,eAAe,CAAA,CAAA;AAErE,IAAK,IAAA,CAAA,QAAA;AAAA,MACH,IAAK,CAAA,KAAA,CAAM,EAAG,CAAA,OAAA,CAAQ,2BAA6B,EAAA;AAAA,QACjD,OAAA;AAAA,OACD,CAAA;AAAA,KACH,CAAA;AAAA,GACF,CAAA;AAEA,EAAA,OAAO,IAAI,MAAO,CAAA;AAAA,IAChB,GAAK,EAAA,2BAAA;AAAA,IACL,KAAO,EAAA;AAAA,MACL,IAAA,CAAK,GAAG,KAAsC,EAAA;AAC5C,QAAO,OAAA;AAAA,UACL,SAAS,EAAC;AAAA,UACV,aAAa,aAAc,CAAA,MAAA,CAAO,KAAM,CAAA,GAAA,EAAK,EAAE,CAAA;AAAA,SACjD,CAAA;AAAA,OACF;AAAA,MACA,KAAA,CAAM,IAAI,KAAsC,EAAA;AAC9C,QAAM,MAAA,IAAA,GAAO,EAAG,CAAA,OAAA,CAAQ,2BAA2B,CAAA,CAAA;AAInD,QAAA,IAAI,SAAS,KAAW,CAAA,EAAA;AACtB,UAAO,OAAA;AAAA,YACL,SAAS,IAAK,CAAA,OAAA;AAAA,YACd,WAAa,EAAA,2BAAA,CAA4B,IAAK,CAAA,OAAA,EAAS,GAAG,GAAG,CAAA;AAAA,WAC/D,CAAA;AAAA,SACF;AAEA,QAAI,IAAA,CAAC,GAAG,UAAY,EAAA;AAClB,UAAO,OAAA,KAAA,CAAA;AAAA,SACT;AAEA,QAAA,IAAI,CAAC,EAAA,CAAG,OAAQ,CAAA,mCAAmC,CAAG,EAAA;AACpD,UAAA,MAAM,OAAU,GAAA,KAAA,CAAM,OAAQ,CAAA,GAAA,CAAI,CAAC,MAAY,MAAA;AAAA,YAC7C,GAAG,MAAA;AAAA,YACH,QAAQ,EAAG,CAAA,OAAA,CAAQ,GAAI,CAAA,MAAA,CAAO,QAAQ,CAAE,CAAA,CAAA;AAAA,YACxC,MAAM,EAAG,CAAA,OAAA,CAAQ,GAAI,CAAA,MAAA,CAAO,MAAM,CAAE,CAAA,CAAA;AAAA,WACpC,CAAA,CAAA,CAAA;AAEF,UAAO,OAAA;AAAA,YACL,OAAA;AAAA,YACA,WAAa,EAAA,2BAAA,CAA4B,OAAS,EAAA,EAAA,CAAG,GAAG,CAAA;AAAA,WAC1D,CAAA;AAAA,SACF;AAMA,QAAO,OAAA;AAAA,UACL,SAAS,KAAM,CAAA,OAAA;AAAA,UACf,WAAa,EAAA,2BAAA,CAA4B,KAAM,CAAA,OAAA,EAAS,GAAG,GAAG,CAAA;AAAA,SAChE,CAAA;AAAA,OACF;AAAA,KACF;AAAA,IACA,KAAO,EAAA;AAAA,MACL,YAAY,KAAO,EAAA;AACjB,QAAA,OACE,2BAA4B,CAAA,QAAA,CAAS,KAAK,CAAA,EAAG,eAC7C,aAAc,CAAA,KAAA,CAAA;AAAA,OAElB;AAAA,KACF;AAAA,IACA,KAAK,UAAY,EAAA;AACf,MAAO,IAAA,GAAA,UAAA,CAAA;AACP,MAAA,cAAA,CAAe,UAAU,CAAA,CAAA;AACzB,MAAkB,iBAAA,EAAA,CAAA;AAClB,MAAA,WAAA,GAAc,IAAK,CAAA,MAAA,CAAO,MAAO,CAAA,SAAA,CAAU,iBAAiB,CAAA,CAAA;AAE5D,MAAO,OAAA;AAAA,QACL,MAAA,CAAO,UAAU,SAAW,EAAA;AAC1B,UAAO,IAAA,GAAA,QAAA,CAAA;AAEP,UAAA,IAAI,CAAC,QAAS,CAAA,KAAA,CAAM,UAAU,EAAG,CAAA,SAAA,CAAU,SAAS,CAAG,EAAA;AACrD,YAAA,cAAA,CAAe,QAAQ,CAAA,CAAA;AAAA,WACzB;AAAA,SAEF;AAAA,QACA,OAAU,GAAA;AACR,UAAc,WAAA,IAAA,CAAA;AACd,UAAc,WAAA,GAAA,KAAA,CAAA,CAAA;AACd,UAAO,IAAA,GAAA,KAAA,CAAA,CAAA;AACP,UAAA,IAAA,CAAK,eAAe,EAAE,CAAC,6BAA6B,GAAG,MAAM,CAAA,CAAA;AAAA,SAC/D;AAAA,OACF,CAAA;AAAA,KACF;AAAA,GACD,CAAA,CAAA;AACH;;;;"}

package/dist/index.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+var core = require('@liveblocks/core');
+var version = require('./version.cjs');
+var cursors = require('./cursors.cjs');
+var plugin = require('./plugin.cjs');
+var schema = require('./schema.cjs');
+
+core.detectDupes(version.PKG_NAME, version.PKG_VERSION, version.PKG_FORMAT);
+
+exports.LIVEBLOCKS_CARET_PLUGIN_KEY = cursors.LIVEBLOCKS_CARET_PLUGIN_KEY;
+exports.LIVEBLOCKS_CARET_PRESENCE_KEY = cursors.LIVEBLOCKS_CARET_PRESENCE_KEY;
+exports.createLiveblocksCollaborationCaretPlugin = cursors.createLiveblocksCollaborationCaretPlugin;
+exports.getCursorUser = cursors.getCursorUser;
+exports.presencePatch = cursors.presencePatch;
+exports.LIVEBLOCKS_COLLABORATION_PLUGIN_KEY = plugin.LIVEBLOCKS_COLLABORATION_PLUGIN_KEY;
+exports.createLiveblocksCollaborationPlugin = plugin.createLiveblocksCollaborationPlugin;
+exports.createLiveblocksProsemirrorNode = schema.createLiveblocksProsemirrorNode;
+exports.getLiveblocksNodeContent = schema.getLiveblocksNodeContent;
+exports.getLiveblocksNodeId = schema.getLiveblocksNodeId;
+exports.getLiveblocksNodeText = schema.getLiveblocksNodeText;
+exports.liveblocksProsemirrorNodeToJson = schema.liveblocksProsemirrorNodeToJson;
+exports.liveblocksProsemirrorNodeToJsonNodes = schema.liveblocksProsemirrorNodeToJsonNodes;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/index.ts"],"sourcesContent":["import { detectDupes } from \"@liveblocks/core\";\n\nimport { PKG_FORMAT, PKG_NAME, PKG_VERSION } from \"./version\";\n\ndetectDupes(PKG_NAME, PKG_VERSION, PKG_FORMAT);\n\nexport type {\n  CollaborationCaretOptions,\n  CollaborationCaretPluginState,\n  CollaborationCaretStorage,\n  CursorUser,\n  RemoteCursor,\n} from \"./cursors\";\nexport {\n  createLiveblocksCollaborationCaretPlugin,\n  getCursorUser,\n  LIVEBLOCKS_CARET_PLUGIN_KEY,\n  LIVEBLOCKS_CARET_PRESENCE_KEY,\n  presencePatch,\n} from \"./cursors\";\nexport type { LiveblocksCollaborationOptions } from \"./plugin\";\nexport {\n  createLiveblocksCollaborationPlugin,\n  LIVEBLOCKS_COLLABORATION_PLUGIN_KEY,\n} from \"./plugin\";\nexport type {\n  LiveblocksProsemirrorNode,\n  ProseMirrorJsonMark,\n  ProseMirrorJsonNode,\n} from \"./schema\";\nexport {\n  createLiveblocksProsemirrorNode,\n  getLiveblocksNodeContent,\n  getLiveblocksNodeId,\n  getLiveblocksNodeText,\n  liveblocksProsemirrorNodeToJson,\n  liveblocksProsemirrorNodeToJsonNodes,\n} from \"./schema\";\nexport type { LiveblocksProsemirrorRoom } from \"./types\";\n"],"names":["detectDupes","PKG_NAME","PKG_VERSION","PKG_FORMAT"],"mappings":";;;;;;;;AAIAA,gBAAY,CAAAC,gBAAA,EAAUC,qBAAaC,kBAAU,CAAA;;;;;;;;;;;;;;;;"}

package/dist/index.d.cts

@@ -0,0 +1,109 @@
+import { JsonObject, LiveObject, LsonObject, StorageUpdate, LiveList, LiveText } from '@liveblocks/client';
+import { PluginKey, Plugin } from 'prosemirror-state';
+import { DecorationSet } from 'prosemirror-view';
+
+type LiveblocksProsemirrorRoom = {
+    batch(callback: () => void): void;
+    getOthers(): readonly {
+        connectionId: number;
+        info?: JsonObject;
+        presence: JsonObject;
+    }[];
+    getStorage(): Promise<{
+        root: LiveObject<LsonObject>;
+    }>;
+    history: {
+        canUndo(): boolean;
+        canRedo(): boolean;
+        disable<T>(callback: () => T): T;
+        undo(): void;
+        redo(): void;
+    };
+    subscribe(node: LiveObject<LsonObject>, callback: (updates: StorageUpdate[]) => void, options: {
+        isDeep: true;
+    }): () => void;
+    updatePresence(patch: JsonObject): void;
+    events: {
+        others: {
+            subscribe(callback: () => void): () => void;
+        };
+    };
+};
+
+declare const LIVEBLOCKS_CARET_PRESENCE_KEY = "liveblocksTiptap";
+type CursorUser = {
+    name?: string;
+    color?: string;
+};
+type CursorPresence = {
+    field: string;
+    anchor: number;
+    head: number;
+    user?: CursorUser;
+};
+type CollaborationCaretStorage = {
+    users: {
+        clientId: number;
+        [key: string]: unknown;
+    }[];
+};
+type RemoteCursor = {
+    anchor: number;
+    connectionId: number;
+    head: number;
+    rawAnchor: number;
+    rawHead: number;
+    user?: CursorUser;
+};
+type CollaborationCaretPluginState = {
+    cursors: RemoteCursor[];
+    decorations: DecorationSet;
+};
+type CollaborationCaretOptions = {
+    room?: LiveblocksProsemirrorRoom;
+    field: string;
+    user: CursorUser;
+};
+declare const LIVEBLOCKS_CARET_PLUGIN_KEY: PluginKey<CollaborationCaretPluginState>;
+declare function getCursorUser(value: unknown): CursorUser | undefined;
+declare function presencePatch(presence: CursorPresence): JsonObject;
+declare function createLiveblocksCollaborationCaretPlugin(options: CollaborationCaretOptions, storage: CollaborationCaretStorage): Plugin;
+
+type ProseMirrorJsonNode = {
+    type: string;
+    attrs?: JsonObject;
+    content?: ProseMirrorJsonNode[];
+    text?: string;
+    marks?: ProseMirrorJsonMark[];
+};
+type ProseMirrorJsonMark = {
+    type: string;
+    attrs?: JsonObject;
+};
+type LiveblocksProsemirrorNodeData = {
+    id: string;
+    type: string;
+    attrs?: JsonObject;
+    content?: LiveList<LiveblocksProsemirrorNode>;
+    text?: LiveText;
+};
+type LiveblocksProsemirrorNode = LiveObject<LiveblocksProsemirrorNodeData>;
+declare function createLiveblocksProsemirrorNode(node: ProseMirrorJsonNode): LiveblocksProsemirrorNode;
+declare function getLiveblocksNodeId(node: LiveblocksProsemirrorNode): string;
+declare function getLiveblocksNodeContent(node: LiveblocksProsemirrorNode): LiveList<LiveblocksProsemirrorNode> | undefined;
+declare function getLiveblocksNodeText(node: LiveblocksProsemirrorNode): LiveText | undefined;
+declare function liveblocksProsemirrorNodeToJsonNodes(node: LiveblocksProsemirrorNode): ProseMirrorJsonNode[];
+declare function liveblocksProsemirrorNodeToJson(node: LiveblocksProsemirrorNode, fallbackDocument?: () => ProseMirrorJsonNode): ProseMirrorJsonNode;
+
+declare const LIVEBLOCKS_COLLABORATION_PLUGIN_KEY: PluginKey<{
+    isReady: boolean;
+}>;
+type LiveblocksCollaborationOptions = {
+    room?: LiveblocksProsemirrorRoom;
+    field: string;
+    initialContent?: ProseMirrorJsonNode;
+    fallbackDocument?: () => ProseMirrorJsonNode;
+};
+declare function createLiveblocksCollaborationPlugin(options: LiveblocksCollaborationOptions): Plugin;
+
+export { CollaborationCaretOptions, CollaborationCaretPluginState, CollaborationCaretStorage, CursorUser, LIVEBLOCKS_CARET_PLUGIN_KEY, LIVEBLOCKS_CARET_PRESENCE_KEY, LIVEBLOCKS_COLLABORATION_PLUGIN_KEY, LiveblocksCollaborationOptions, LiveblocksProsemirrorNode, LiveblocksProsemirrorRoom, ProseMirrorJsonMark, ProseMirrorJsonNode, RemoteCursor, createLiveblocksCollaborationCaretPlugin, createLiveblocksCollaborationPlugin, createLiveblocksProsemirrorNode, getCursorUser, getLiveblocksNodeContent, getLiveblocksNodeId, getLiveblocksNodeText, liveblocksProsemirrorNodeToJson, liveblocksProsemirrorNodeToJsonNodes, presencePatch };