@matrajs/collab 0.4.1 → 0.6.0

package/LICENSE

@@ -1,21 +1,57 @@
-MIT License
-
-Copyright (c) 2026 Nahim Hossain Shohan
-
-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.
+Matra Commercial License
+Version 1.0, 24 August 2026
+Copyright (c) 2026 Amrela
+
+This package is source-available, not open source. The Matra core
+(@matrajs/core, @matrajs/react, @matrajs/vue) is MIT and always will be; this
+package is not.
+
+1. FREE USE
+
+   You may use, copy and modify this software at no cost for:
+
+   a. evaluation, development and testing;
+   b. personal projects that earn no revenue;
+   c. education, research and teaching;
+   d. internal tools at an organisation with fewer than three developers
+      working on software that includes this package.
+
+   No key, no signup, no phone-home. We do not check. This clause is the
+   licence, not a trial period.
+
+2. PAID USE
+
+   Any other use in production requires a current subscription, one seat per
+   developer working on software that includes this package. If the software
+   you ship earns money and more than two developers touch it, that is paid
+   use.
+
+3. WHAT YOU MAY ALWAYS DO
+
+   Read the source. Modify it for your own licensed use. Fork it privately.
+   Keep running the version you licensed, forever, even if your subscription
+   lapses — a lapsed subscription ends updates and support, not the software
+   you already shipped.
+
+4. WHAT YOU MAY NOT DO
+
+   Redistribute this package, modified or not, as part of a product that
+   competes with Matra. Remove or obscure this licence. Sublicense it.
+
+5. NO WARRANTY
+
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+   OTHER LIABILITY ARISING FROM THE SOFTWARE OR ITS USE.
+
+6. TERMINATION
+
+   This licence ends if you breach it and do not fix the breach within 30 days
+   of being told. Clause 3's "keep running what you licensed" survives
+   termination for versions you had already licensed and shipped.
+
+7. GOVERNING LAW
+
+   The laws of Bangladesh.
+
+Questions, or a licence that does not fit your situation: licensing@amrela.co

package/README.md

@@ -31,10 +31,49 @@ editor.commands.receiveCollabSteps(await since(getVersion(editor)))
 `Authority` is the server half, deliberately transport-free so the same object
 works over WebSocket, HTTP polling, or an in-memory channel in a test.
 
-`PresenceTracker` keeps other people's cursors inside the document as it
-changes. Rendering them is the host's job — the engine has no decoration layer,
-and inventing one here would be the wrong place for it.
+`remoteCursors()` draws everyone else's caret and selection, as decorations
+rather than as document content — so nothing about presence travels with a
+copy, an export, or an undo.
+
+```ts
+import { collab, remoteCursors, remoteCursorCSS } from '@matrajs/collab'
+
+const editor = createEditor({
+  extensions: [...starterKit, collab({ clientId }), remoteCursors()],
+})
+
+// Whatever your transport delivers.
+socket.on('presence', (p) => editor.commands.setPresence(p))
+socket.on('left', (id) => editor.commands.removePresence(id))
+```
+
+A caret arrives as a position in the *sender's* document, and is wrong the
+moment anything is typed locally. Each one is mapped through the same steps the
+local document went through, which is the only thing that keeps a caret on the
+word it was actually next to — clamping it to the document size, the obvious
+shortcut, silently points every cursor at the wrong place.
+
+Colours come from `colorFor(clientId)`, derived rather than assigned, so two
+clients that never speak still agree on what colour a third person is. Drop in
+`remoteCursorCSS` for enough styling to see a caret, or write your own against
+`.matra-remote-cursor`, `.matra-remote-cursor-label` and
+`.matra-remote-selection`.
 
 - Source: https://github.com/amrelaco/matra
 
-MIT.
+
+## Licence
+
+Source-available under the [Matra Commercial License](./LICENSE), **not MIT** —
+unlike `@matrajs/core`, which is MIT and stays that way.
+
+Free for evaluation, development, testing, personal projects, education, and
+internal tools at organisations with fewer than three developers on the
+codebase. Paid, one seat per developer, for production use beyond that. No
+licence key and no phone-home: the licence is the agreement, not a mechanism.
+
+Versions up to and including **0.5.0 were published under MIT**, and that grant
+cannot be withdrawn — if you are already on 0.5.0 you may keep using it under
+MIT indefinitely. The commercial licence applies from 0.6.0 onward.
+
+licensing@amrela.co

package/dist/index.cjs

@@ -142,57 +142,163 @@ function readEngine(ctx) {
   return access;
 }
 
-// src/presence.ts
-var PresenceTracker = class {
-  constructor(editor, onUpdate) {
-    this.editor = editor;
-    this.onUpdate = onUpdate;
-    editor.getJSON();
-    this.off = editor.on("change", () => {
-      const size = measure(editor.getJSON());
-      for (const [id, person] of this.people) {
-        this.people.set(id, {
-          ...person,
-          anchor: Math.min(person.anchor, size),
-          head: Math.min(person.head, size)
+// src/remote-cursors.ts
+function readEngine2(ctx) {
+  const access = ctx[/* @__PURE__ */ Symbol.for("matra.engine")];
+  if (!access) throw new Error("Matra: remoteCursors ctx was created outside the engine");
+  return access;
+}
+function colorFor(clientId) {
+  let hash = 0;
+  for (let i = 0; i < clientId.length; i++) hash = hash * 31 + clientId.charCodeAt(i) | 0;
+  return `hsl(${Math.abs(hash) % 360} 70% 45%)`;
+}
+var META = "matra-presence";
+function remoteCursors() {
+  return {
+    kind: "extension",
+    name: "remoteCursors",
+    state: {
+      init: () => /* @__PURE__ */ new Map(),
+      apply(ctx, previous) {
+        const { tr } = readEngine2(ctx);
+        const action = tr.getMeta(META);
+        let next = previous;
+        if (tr.docChanged) {
+          const mapped = /* @__PURE__ */ new Map();
+          for (const [id, person] of previous) {
+            mapped.set(id, {
+              ...person,
+              anchor: tr.mapping.map(person.anchor),
+              head: tr.mapping.map(person.head)
+            });
+          }
+          next = mapped;
+        }
+        if (!action) return next;
+        const copy = new Map(next);
+        if ("clear" in action) copy.clear();
+        else if ("remove" in action) copy.delete(action.remove);
+        else if (isPlacedPresence(action.set)) copy.set(action.set.clientId, action.set);
+        return copy;
+      }
+    },
+    decorations(ctx) {
+      const { tr, pluginState } = readEngine2(ctx);
+      const people = pluginState("remoteCursors");
+      if (!people?.size) return [];
+      const size = tr.doc.content.size;
+      const out = [];
+      for (const person of people.values()) {
+        const anchor = clamp(person.anchor, size);
+        const head = clamp(person.head, size);
+        if (anchor === null || head === null) continue;
+        const color = colorFor(person.clientId);
+        const name = readName(person);
+        if (anchor !== head) {
+          out.push({
+            type: "inline",
+            from: Math.min(anchor, head),
+            to: Math.max(anchor, head),
+            attrs: {
+              class: "matra-remote-selection",
+              style: `background-color: ${color}; opacity: 0.25`
+            }
+          });
+        }
+        out.push({
+          type: "widget",
+          pos: head,
+          // Keyed by client so the renderer reuses the caret element instead of
+          // tearing it down and rebuilding it on every keystroke.
+          key: `cursor-${person.clientId}`,
+          side: 1,
+          render: () => renderCaret(color, name)
         });
       }
-      editor.getJSON();
-      this.onUpdate?.(this.list());
-    });
-  }
-  editor;
-  onUpdate;
-  people = /* @__PURE__ */ new Map();
-  off;
-  set(person) {
-    this.people.set(person.clientId, person);
-    this.onUpdate?.(this.list());
-  }
-  remove(clientId) {
-    if (this.people.delete(clientId)) this.onUpdate?.(this.list());
-  }
-  list() {
-    return [...this.people.values()];
-  }
-  destroy() {
-    this.off();
-    this.people.clear();
-  }
-};
-function measure(doc) {
-  if (typeof doc.text === "string") return doc.text.length;
-  let size = 0;
-  for (const child of doc.content ?? []) {
-    size += typeof child.text === "string" ? child.text.length : measure(child) + 2;
+      return out;
+    },
+    commands: {
+      setPresence: (ctx, presence) => {
+        if (!isPlacedPresence(presence)) return false;
+        readEngine2(ctx).tr.setMeta(META, { set: presence });
+        return true;
+      },
+      removePresence: (ctx, clientId) => {
+        if (typeof clientId !== "string" || !clientId) return false;
+        readEngine2(ctx).tr.setMeta(META, { remove: clientId });
+        return true;
+      },
+      clearPresence: (ctx) => {
+        readEngine2(ctx).tr.setMeta(META, { clear: true });
+        return true;
+      }
+    }
+  };
+}
+function isPlacedPresence(value) {
+  if (!value || typeof value !== "object") return false;
+  const person = value;
+  return typeof person.clientId === "string" && person.clientId.length > 0 && isPlace(person.anchor) && isPlace(person.head);
+}
+function isPlace(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function clamp(value, size) {
+  if (!isPlace(value)) return null;
+  return Math.min(value, size);
+}
+function renderCaret(color, name) {
+  const caret = document.createElement("span");
+  caret.className = "matra-remote-cursor";
+  caret.style.borderLeft = `2px solid ${color}`;
+  if (name !== null) {
+    const label = document.createElement("span");
+    label.className = "matra-remote-cursor-label";
+    label.style.backgroundColor = color;
+    label.textContent = name;
+    caret.appendChild(label);
   }
-  return size;
+  return caret;
+}
+function readName(person) {
+  const name = person.meta?.name;
+  if (typeof name !== "string") return null;
+  const trimmed = name.trim();
+  if (!trimmed) return null;
+  return trimmed.slice(0, 40);
+}
+var remoteCursorCSS = `
+.matra-remote-cursor {
+  position: relative;
+  margin-left: -1px;
+  margin-right: -1px;
+  pointer-events: none;
+  word-break: normal;
+}
+.matra-remote-cursor-label {
+  position: absolute;
+  top: -1.2em;
+  left: -2px;
+  padding: 0 4px;
+  border-radius: 3px;
+  color: #fff;
+  font-size: 11px;
+  line-height: 1.4;
+  white-space: nowrap;
+  user-select: none;
+}
+.matra-remote-selection {
+  border-radius: 2px;
 }
+`;
 
 exports.Authority = Authority;
-exports.PresenceTracker = PresenceTracker;
 exports.collab = collab;
+exports.colorFor = colorFor;
 exports.getVersion = getVersion;
+exports.remoteCursorCSS = remoteCursorCSS;
+exports.remoteCursors = remoteCursors;
 exports.sendableSteps = sendableSteps;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/authority.ts","../src/collab.ts","../src/presence.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { CollabStep } from './types'\n\n/**\n * The server side of the protocol, as a plain object.\n *\n * An authority is barely anything: a list of steps and the rule that a client\n * may only append if it is up to date. Keeping it transport-free means the same\n * object works over WebSocket, HTTP polling or an in-memory channel in tests.\n */\nexport class Authority {\n  private readonly history: CollabStep[] = []\n\n  constructor(private readonly onChange?: (version: number) => void) {}\n\n  get version(): number {\n    return this.history.length\n  }\n\n  /**\n   * Append steps if the client is current.\n   *\n   * Returns false when it is not — the client should pull what it missed,\n   * rebase, and try again. Rejecting rather than merging is what keeps the\n   * history linear and every client's version meaningful.\n   */\n  receive(version: number, steps: CollabStep[]): boolean {\n    if (version !== this.version) return false\n    this.history.push(...steps)\n    this.onChange?.(this.version)\n    return true\n  }\n\n  /** Everything that happened after `version`. */\n  since(version: number): CollabStep[] {\n    return this.history.slice(version)\n  }\n}\n","import type { AnyDef, Command, Ctx, Editor, ExtensionDef } from '@matrajs/core'\nimport type { CollabStep, Sendable } from './types'\n\nexport interface CollabOptions {\n  /** Identifies this client. Two clients must never share one. */\n  clientId: string\n  /** The version this client starts from. */\n  version?: number\n}\n\n/** A local step, kept with what it takes to rewind and rebase it. */\nexport interface PendingStep {\n  step: EngineStep\n  /** The step that undoes it, computed against the document it applied to. */\n  inverted: EngineStep\n  json: Record<string, unknown>\n  clientId: string\n}\n\nexport interface CollabState {\n  version: number\n  /** Local steps the authority has not confirmed yet. */\n  unconfirmed: PendingStep[]\n}\n\n/** The slice of a step this package needs; the engine owns the real type. */\ninterface EngineStep {\n  toJSON(): Record<string, unknown>\n  invert(doc: unknown): EngineStep\n  map(mapping: unknown): EngineStep | null\n}\n\nconst REMOTE = 'collab:remote'\nconst CONFIRM = 'collab:confirm'\nconst REBASED = 'collab:rebased'\n\n/**\n * Collaborative editing over a central authority.\n *\n * The protocol is the well-trodden one: a client sends the steps it has made\n * together with the version they applied to, and the authority accepts them\n * only if that version is still current. A client whose version is stale pulls\n * the steps it missed, rebases its own unconfirmed work over them, and tries\n * again.\n *\n * There is no CRDT here and no dependency. Rebasing already lives in the engine\n * — `Step.map` is what lets a local edit survive a remote one — so\n * collaboration is a version counter and a transport on top of it.\n */\nexport function collab(options: CollabOptions): ExtensionDef<\n  {\n    receiveCollabSteps: Command<[steps: CollabStep[]]>\n    confirmCollabSteps: Command<[count: number]>\n  },\n  CollabState\n> {\n  const clientId = options.clientId\n  if (!clientId) throw new Error('Matra: collab needs a clientId')\n\n  return {\n    kind: 'extension',\n    name: 'collab',\n    state: {\n      init: () => ({ version: options.version ?? 0, unconfirmed: [] }),\n      apply: (ctx, previous) => {\n        const engine = readEngine(ctx)\n        const tr = engine.tr\n\n        const confirmed = tr.getMeta(CONFIRM)\n        if (typeof confirmed === 'number') {\n          return {\n            version: previous.version + confirmed,\n            unconfirmed: previous.unconfirmed.slice(confirmed),\n          }\n        }\n\n        const rebased = tr.getMeta(REBASED) as\n          | { remote: number; unconfirmed: PendingStep[] }\n          | undefined\n        if (rebased) {\n          return {\n            version: previous.version + rebased.remote,\n            unconfirmed: rebased.unconfirmed,\n          }\n        }\n\n        if (!tr.steps.length) return previous\n        if (tr.getMeta(REMOTE)) return previous\n\n        // Local work: keep each step with its inverse, which is what lets it be\n        // rewound and replayed when someone else's edit arrives first.\n        const pending: PendingStep[] = tr.steps.map((step, index) => ({\n          step,\n          inverted: step.invert(tr.docs[index]),\n          json: step.toJSON(),\n          clientId,\n        }))\n        return {\n          version: previous.version,\n          unconfirmed: [...previous.unconfirmed, ...pending],\n        }\n      },\n    },\n    commands: {\n      /**\n       * Apply steps from other clients.\n       *\n       * Steps this client sent are skipped — they are already in the document,\n       * and applying them twice would duplicate the edit. A step that no longer\n       * applies is dropped rather than throwing: one bad message from a peer\n       * must not take the editor down.\n       */\n      receiveCollabSteps: (ctx, incoming) => {\n        if (!incoming?.length) return false\n        const engine = readEngine(ctx)\n        const foreign = incoming.filter((entry) => entry.clientId !== clientId)\n        if (!foreign.length) return false\n\n        const pending =\n          (engine.pluginState('collab') as CollabState | undefined)?.unconfirmed ?? []\n        const tr = engine.tr\n\n        // Rewind local work so the remote steps land on the document the\n        // authority actually has. Applying them on top of unsent local edits\n        // would leave both the document and the outgoing positions wrong.\n        for (let i = pending.length - 1; i >= 0; i--) {\n          tr.maybeStep(pending[i]?.inverted as never)\n        }\n\n        const beforeRemote = tr.steps.length\n        let applied = 0\n        for (const entry of foreign) {\n          const step = engine.stepFromJSON(entry.step)\n          if (step && tr.maybeStep(step)) applied++\n        }\n        if (!applied) return false\n\n        // Replay local work over the remote changes.\n        const remoteMapping = tr.mapping.slice(beforeRemote)\n        const rebased: PendingStep[] = []\n        for (const entry of pending) {\n          const mapped = entry.step.map(remoteMapping)\n          if (!mapped) continue\n          const docBefore = tr.doc\n          if (!tr.maybeStep(mapped as never)) continue\n          rebased.push({\n            step: mapped,\n            inverted: mapped.invert(docBefore),\n            json: mapped.toJSON(),\n            clientId,\n          })\n        }\n\n        tr.setMeta(REBASED, { remote: applied, unconfirmed: rebased })\n        return true\n      },\n\n      /** The authority accepted this many of our steps; stop tracking them. */\n      confirmCollabSteps: (ctx, count) => {\n        if (!Number.isInteger(count) || count <= 0) return false\n        readEngine(ctx).tr.setMeta(CONFIRM, count)\n        return true\n      },\n    },\n  }\n}\n\n/** Steps this client has made that the authority has not seen. */\nexport function sendableSteps(editor: Editor<readonly AnyDef[]>): Sendable | null {\n  const state = editor.extensionState<CollabState>('collab')\n  if (!state?.unconfirmed.length) return null\n  return {\n    version: state.version,\n    steps: state.unconfirmed.map((entry) => ({ step: entry.json, clientId: entry.clientId })),\n    clientId: state.unconfirmed[0]?.clientId ?? '',\n  }\n}\n\n/** The version of the document this client believes it is on. */\nexport function getVersion(editor: Editor<readonly AnyDef[]>): number {\n  return editor.extensionState<CollabState>('collab')?.version ?? 0\n}\n\ninterface CollabEngine {\n  tr: {\n    steps: EngineStep[]\n    docs: unknown[]\n    doc: unknown\n    mapping: { slice(from: number): unknown }\n    getMeta(key: string): unknown\n    setMeta(key: string, value: unknown): unknown\n    maybeStep(step: unknown): boolean\n  }\n  stepFromJSON(json: Record<string, unknown>): EngineStep | null\n  pluginState(key: string): unknown\n}\n\n/** Reach the engine the way bundled extensions do. */\nfunction readEngine(ctx: Ctx): CollabEngine {\n  const access = (ctx as unknown as Record<symbol, CollabEngine>)[Symbol.for('matra.engine')]\n  if (!access) throw new Error('Matra: collab ctx was created outside the engine')\n  return access\n}\n","import type { AnyDef, Editor } from '@matrajs/core'\nimport type { Presence } from './types'\n\n/**\n * Other people's cursors, kept honest as the document changes.\n *\n * A remote caret arrives as a position in the sender's document. The moment\n * anything is typed locally that number is wrong, so every position is mapped\n * forward on each change. Rendering is the host application's job — the engine\n * has no decoration layer, and inventing one here would be the wrong place.\n */\nexport class PresenceTracker {\n  private readonly people = new Map<string, Presence>()\n  private readonly off: () => void\n\n  constructor(\n    private readonly editor: Editor<readonly AnyDef[]>,\n    private readonly onUpdate?: (people: Presence[]) => void,\n  ) {\n    let previous = editor.getJSON()\n    this.off = editor.on('change', () => {\n      // Positions past the end of the document are clamped rather than dropped:\n      // a cursor at the end of a paragraph someone just shortened should sit at\n      // the new end, not disappear.\n      const size = measure(editor.getJSON())\n      for (const [id, person] of this.people) {\n        this.people.set(id, {\n          ...person,\n          anchor: Math.min(person.anchor, size),\n          head: Math.min(person.head, size),\n        })\n      }\n      previous = editor.getJSON()\n      void previous\n      this.onUpdate?.(this.list())\n    })\n  }\n\n  set(person: Presence): void {\n    this.people.set(person.clientId, person)\n    this.onUpdate?.(this.list())\n  }\n\n  remove(clientId: string): void {\n    if (this.people.delete(clientId)) this.onUpdate?.(this.list())\n  }\n\n  list(): Presence[] {\n    return [...this.people.values()]\n  }\n\n  destroy(): void {\n    this.off()\n    this.people.clear()\n  }\n}\n\nfunction measure(doc: { content?: unknown[]; text?: string }): number {\n  if (typeof doc.text === 'string') return doc.text.length\n  let size = 0\n  for (const child of (doc.content ?? []) as Array<{ content?: unknown[]; text?: string }>) {\n    size += typeof child.text === 'string' ? child.text.length : measure(child) + 2\n  }\n  return size\n}\n"]}
+{"version":3,"sources":["../src/authority.ts","../src/collab.ts","../src/remote-cursors.ts"],"names":["readEngine"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { CollabStep } from './types'\n\n/**\n * The server side of the protocol, as a plain object.\n *\n * An authority is barely anything: a list of steps and the rule that a client\n * may only append if it is up to date. Keeping it transport-free means the same\n * object works over WebSocket, HTTP polling or an in-memory channel in tests.\n */\nexport class Authority {\n  private readonly history: CollabStep[] = []\n\n  constructor(private readonly onChange?: (version: number) => void) {}\n\n  get version(): number {\n    return this.history.length\n  }\n\n  /**\n   * Append steps if the client is current.\n   *\n   * Returns false when it is not — the client should pull what it missed,\n   * rebase, and try again. Rejecting rather than merging is what keeps the\n   * history linear and every client's version meaningful.\n   */\n  receive(version: number, steps: CollabStep[]): boolean {\n    if (version !== this.version) return false\n    this.history.push(...steps)\n    this.onChange?.(this.version)\n    return true\n  }\n\n  /** Everything that happened after `version`. */\n  since(version: number): CollabStep[] {\n    return this.history.slice(version)\n  }\n}\n","import type { AnyDef, Command, Ctx, Editor, ExtensionDef } from '@matrajs/core'\nimport type { CollabStep, Sendable } from './types'\n\nexport interface CollabOptions {\n  /** Identifies this client. Two clients must never share one. */\n  clientId: string\n  /** The version this client starts from. */\n  version?: number\n}\n\n/** A local step, kept with what it takes to rewind and rebase it. */\nexport interface PendingStep {\n  step: EngineStep\n  /** The step that undoes it, computed against the document it applied to. */\n  inverted: EngineStep\n  json: Record<string, unknown>\n  clientId: string\n}\n\nexport interface CollabState {\n  version: number\n  /** Local steps the authority has not confirmed yet. */\n  unconfirmed: PendingStep[]\n}\n\n/** The slice of a step this package needs; the engine owns the real type. */\ninterface EngineStep {\n  toJSON(): Record<string, unknown>\n  invert(doc: unknown): EngineStep\n  map(mapping: unknown): EngineStep | null\n}\n\nconst REMOTE = 'collab:remote'\nconst CONFIRM = 'collab:confirm'\nconst REBASED = 'collab:rebased'\n\n/**\n * Collaborative editing over a central authority.\n *\n * The protocol is the well-trodden one: a client sends the steps it has made\n * together with the version they applied to, and the authority accepts them\n * only if that version is still current. A client whose version is stale pulls\n * the steps it missed, rebases its own unconfirmed work over them, and tries\n * again.\n *\n * There is no CRDT here and no dependency. Rebasing already lives in the engine\n * — `Step.map` is what lets a local edit survive a remote one — so\n * collaboration is a version counter and a transport on top of it.\n */\nexport function collab(options: CollabOptions): ExtensionDef<\n  {\n    receiveCollabSteps: Command<[steps: CollabStep[]]>\n    confirmCollabSteps: Command<[count: number]>\n  },\n  CollabState\n> {\n  const clientId = options.clientId\n  if (!clientId) throw new Error('Matra: collab needs a clientId')\n\n  return {\n    kind: 'extension',\n    name: 'collab',\n    state: {\n      init: () => ({ version: options.version ?? 0, unconfirmed: [] }),\n      apply: (ctx, previous) => {\n        const engine = readEngine(ctx)\n        const tr = engine.tr\n\n        const confirmed = tr.getMeta(CONFIRM)\n        if (typeof confirmed === 'number') {\n          return {\n            version: previous.version + confirmed,\n            unconfirmed: previous.unconfirmed.slice(confirmed),\n          }\n        }\n\n        const rebased = tr.getMeta(REBASED) as\n          | { remote: number; unconfirmed: PendingStep[] }\n          | undefined\n        if (rebased) {\n          return {\n            version: previous.version + rebased.remote,\n            unconfirmed: rebased.unconfirmed,\n          }\n        }\n\n        if (!tr.steps.length) return previous\n        if (tr.getMeta(REMOTE)) return previous\n\n        // Local work: keep each step with its inverse, which is what lets it be\n        // rewound and replayed when someone else's edit arrives first.\n        const pending: PendingStep[] = tr.steps.map((step, index) => ({\n          step,\n          inverted: step.invert(tr.docs[index]),\n          json: step.toJSON(),\n          clientId,\n        }))\n        return {\n          version: previous.version,\n          unconfirmed: [...previous.unconfirmed, ...pending],\n        }\n      },\n    },\n    commands: {\n      /**\n       * Apply steps from other clients.\n       *\n       * Steps this client sent are skipped — they are already in the document,\n       * and applying them twice would duplicate the edit. A step that no longer\n       * applies is dropped rather than throwing: one bad message from a peer\n       * must not take the editor down.\n       */\n      receiveCollabSteps: (ctx, incoming) => {\n        if (!incoming?.length) return false\n        const engine = readEngine(ctx)\n        const foreign = incoming.filter((entry) => entry.clientId !== clientId)\n        if (!foreign.length) return false\n\n        const pending =\n          (engine.pluginState('collab') as CollabState | undefined)?.unconfirmed ?? []\n        const tr = engine.tr\n\n        // Rewind local work so the remote steps land on the document the\n        // authority actually has. Applying them on top of unsent local edits\n        // would leave both the document and the outgoing positions wrong.\n        for (let i = pending.length - 1; i >= 0; i--) {\n          tr.maybeStep(pending[i]?.inverted as never)\n        }\n\n        const beforeRemote = tr.steps.length\n        let applied = 0\n        for (const entry of foreign) {\n          const step = engine.stepFromJSON(entry.step)\n          if (step && tr.maybeStep(step)) applied++\n        }\n        if (!applied) return false\n\n        // Replay local work over the remote changes.\n        const remoteMapping = tr.mapping.slice(beforeRemote)\n        const rebased: PendingStep[] = []\n        for (const entry of pending) {\n          const mapped = entry.step.map(remoteMapping)\n          if (!mapped) continue\n          const docBefore = tr.doc\n          if (!tr.maybeStep(mapped as never)) continue\n          rebased.push({\n            step: mapped,\n            inverted: mapped.invert(docBefore),\n            json: mapped.toJSON(),\n            clientId,\n          })\n        }\n\n        tr.setMeta(REBASED, { remote: applied, unconfirmed: rebased })\n        return true\n      },\n\n      /** The authority accepted this many of our steps; stop tracking them. */\n      confirmCollabSteps: (ctx, count) => {\n        if (!Number.isInteger(count) || count <= 0) return false\n        readEngine(ctx).tr.setMeta(CONFIRM, count)\n        return true\n      },\n    },\n  }\n}\n\n/** Steps this client has made that the authority has not seen. */\nexport function sendableSteps(editor: Editor<readonly AnyDef[]>): Sendable | null {\n  const state = editor.extensionState<CollabState>('collab')\n  if (!state?.unconfirmed.length) return null\n  return {\n    version: state.version,\n    steps: state.unconfirmed.map((entry) => ({ step: entry.json, clientId: entry.clientId })),\n    clientId: state.unconfirmed[0]?.clientId ?? '',\n  }\n}\n\n/** The version of the document this client believes it is on. */\nexport function getVersion(editor: Editor<readonly AnyDef[]>): number {\n  return editor.extensionState<CollabState>('collab')?.version ?? 0\n}\n\ninterface CollabEngine {\n  tr: {\n    steps: EngineStep[]\n    docs: unknown[]\n    doc: unknown\n    mapping: { slice(from: number): unknown }\n    getMeta(key: string): unknown\n    setMeta(key: string, value: unknown): unknown\n    maybeStep(step: unknown): boolean\n  }\n  stepFromJSON(json: Record<string, unknown>): EngineStep | null\n  pluginState(key: string): unknown\n}\n\n/** Reach the engine the way bundled extensions do. */\nfunction readEngine(ctx: Ctx): CollabEngine {\n  const access = (ctx as unknown as Record<symbol, CollabEngine>)[Symbol.for('matra.engine')]\n  if (!access) throw new Error('Matra: collab ctx was created outside the engine')\n  return access\n}\n","import type { Command, Ctx, DecorationSpec, ExtensionDef, Pos } from '@matrajs/core'\nimport type { Presence } from './types'\n\n/** The slice of the engine this extension needs, reached the way collab does. */\ninterface CursorEngine {\n  tr: {\n    docChanged: boolean\n    doc: { content: { size: number } }\n    mapping: { map(pos: number, assoc?: -1 | 1): number }\n    getMeta(key: string): unknown\n    setMeta(key: string, value: unknown): unknown\n  }\n  pluginState(key: string): unknown\n}\n\nfunction readEngine(ctx: Ctx): CursorEngine {\n  const access = (ctx as unknown as Record<symbol, CursorEngine>)[Symbol.for('matra.engine')]\n  if (!access) throw new Error('Matra: remoteCursors ctx was created outside the engine')\n  return access\n}\n\n/** Everyone else's caret, in this client's coordinates. */\nexport type RemoteCursors = ReadonlyMap<string, Presence>\n\n/**\n * A colour per person, chosen from the id so it is stable everywhere.\n *\n * Deriving it beats assigning one, because two clients that never speak still\n * agree on what colour a third person is.\n */\nexport function colorFor(clientId: string): string {\n  let hash = 0\n  for (let i = 0; i < clientId.length; i++) hash = (hash * 31 + clientId.charCodeAt(i)) | 0\n  // Fixed saturation and lightness keep every colour legible on white and dark.\n  return `hsl(${Math.abs(hash) % 360} 70% 45%)`\n}\n\nconst META = 'matra-presence'\n\n/** What a presence message asks the extension to do. */\ntype PresenceAction = { set: Presence } | { remove: string } | { clear: true }\n\n/**\n * Other people's carets and selections, drawn as decorations.\n *\n * A remote caret arrives as a position in the *sender's* document. The instant\n * anything is typed locally that number is wrong. The only correct fix is to\n * map it through the same steps the local document went through, which is why\n * this is an extension rather than a helper: extension state is reduced inside\n * the transaction pipeline, where the mapping actually lives.\n *\n * Clamping to the document size — the obvious shortcut — is wrong. Insert ten\n * characters at the start and every later caret should move ten forward;\n * clamping leaves them all pointing at the wrong word.\n */\nexport function remoteCursors(): ExtensionDef<\n  {\n    setPresence: Command<[presence: Presence]>\n    removePresence: Command<[clientId: string]>\n    clearPresence: Command\n  },\n  RemoteCursors\n> {\n  return {\n    kind: 'extension',\n    name: 'remoteCursors',\n\n    state: {\n      init: () => new Map<string, Presence>(),\n\n      apply(ctx, previous) {\n        const { tr } = readEngine(ctx)\n        const action = tr.getMeta(META) as PresenceAction | undefined\n        let next = previous\n\n        // Map first, then apply the message. A message arriving in the same\n        // transaction as an edit already describes the document after it.\n        if (tr.docChanged) {\n          // This transaction's own mapping, not ctx.mark() — that one maps\n          // changes made *after* it is taken, and by the time a reducer runs\n          // the change it must account for is the one already in `tr`.\n          const mapped = new Map<string, Presence>()\n          for (const [id, person] of previous) {\n            mapped.set(id, {\n              ...person,\n              anchor: tr.mapping.map(person.anchor),\n              head: tr.mapping.map(person.head),\n            })\n          }\n          next = mapped\n        }\n\n        if (!action) return next\n\n        const copy = new Map(next)\n        if ('clear' in action) copy.clear()\n        else if ('remove' in action) copy.delete(action.remove)\n        else if (isPlacedPresence(action.set)) copy.set(action.set.clientId, action.set)\n        return copy\n      },\n    },\n\n    decorations(ctx) {\n      const { tr, pluginState } = readEngine(ctx)\n      const people = pluginState('remoteCursors') as RemoteCursors | undefined\n      if (!people?.size) return []\n\n      const size = tr.doc.content.size\n      const out: DecorationSpec[] = []\n\n      for (const person of people.values()) {\n        // A peer can send anything. A caret outside the document would throw\n        // deep in the decoration mapper, so it is dropped here instead.\n        const anchor = clamp(person.anchor, size)\n        const head = clamp(person.head, size)\n        if (anchor === null || head === null) continue\n\n        const color = colorFor(person.clientId)\n        const name = readName(person)\n\n        if (anchor !== head) {\n          out.push({\n            type: 'inline',\n            from: Math.min(anchor, head) as Pos,\n            to: Math.max(anchor, head) as Pos,\n            attrs: {\n              class: 'matra-remote-selection',\n              style: `background-color: ${color}; opacity: 0.25`,\n            },\n          })\n        }\n\n        out.push({\n          type: 'widget',\n          pos: head as Pos,\n          // Keyed by client so the renderer reuses the caret element instead of\n          // tearing it down and rebuilding it on every keystroke.\n          key: `cursor-${person.clientId}`,\n          side: 1,\n          render: () => renderCaret(color, name),\n        })\n      }\n\n      return out\n    },\n\n    commands: {\n      setPresence: (ctx, presence) => {\n        if (!isPlacedPresence(presence)) return false\n        readEngine(ctx).tr.setMeta(META, { set: presence })\n        return true\n      },\n      removePresence: (ctx, clientId) => {\n        if (typeof clientId !== 'string' || !clientId) return false\n        readEngine(ctx).tr.setMeta(META, { remove: clientId })\n        return true\n      },\n      clearPresence: (ctx) => {\n        readEngine(ctx).tr.setMeta(META, { clear: true })\n        return true\n      },\n    },\n  }\n}\n\n/** Is this a presence message we can place, or noise from the wire? */\nfunction isPlacedPresence(value: unknown): value is Presence {\n  if (!value || typeof value !== 'object') return false\n  const person = value as Presence\n  return (\n    typeof person.clientId === 'string' &&\n    person.clientId.length > 0 &&\n    isPlace(person.anchor) &&\n    isPlace(person.head)\n  )\n}\n\nfunction isPlace(value: unknown): value is number {\n  return typeof value === 'number' && Number.isInteger(value) && value >= 0\n}\n\nfunction clamp(value: number, size: number): number | null {\n  if (!isPlace(value)) return null\n  return Math.min(value, size)\n}\n\n/**\n * The caret element.\n *\n * Built with `document.createElement` and `textContent` rather than a template\n * string: the label is a display name chosen by another user, and it must not\n * be able to become markup.\n */\nfunction renderCaret(color: string, name: string | null): HTMLElement {\n  const caret = document.createElement('span')\n  caret.className = 'matra-remote-cursor'\n  caret.style.borderLeft = `2px solid ${color}`\n\n  if (name !== null) {\n    const label = document.createElement('span')\n    label.className = 'matra-remote-cursor-label'\n    label.style.backgroundColor = color\n    label.textContent = name\n    caret.appendChild(label)\n  }\n  return caret\n}\n\n/** A display name, if the sender supplied a usable one. */\nfunction readName(person: Presence): string | null {\n  const name = person.meta?.name\n  if (typeof name !== 'string') return null\n  const trimmed = name.trim()\n  if (!trimmed) return null\n  // A name is a label, not an essay; a peer sending 10kB of it is an attack.\n  return trimmed.slice(0, 40)\n}\n\n/** Enough styling to see a caret. Drop it in a stylesheet, or write your own. */\nexport const remoteCursorCSS = `\n.matra-remote-cursor {\n  position: relative;\n  margin-left: -1px;\n  margin-right: -1px;\n  pointer-events: none;\n  word-break: normal;\n}\n.matra-remote-cursor-label {\n  position: absolute;\n  top: -1.2em;\n  left: -2px;\n  padding: 0 4px;\n  border-radius: 3px;\n  color: #fff;\n  font-size: 11px;\n  line-height: 1.4;\n  white-space: nowrap;\n  user-select: none;\n}\n.matra-remote-selection {\n  border-radius: 2px;\n}\n`\n"]}

package/dist/index.d.cts

@@ -93,24 +93,34 @@ declare function sendableSteps(editor: Editor<readonly AnyDef[]>): Sendable | nu
 /** The version of the document this client believes it is on. */
 declare function getVersion(editor: Editor<readonly AnyDef[]>): number;
 
+/** Everyone else's caret, in this client's coordinates. */
+type RemoteCursors = ReadonlyMap<string, Presence>;
 /**
- * Other people's cursors, kept honest as the document changes.
+ * A colour per person, chosen from the id so it is stable everywhere.
  *
- * A remote caret arrives as a position in the sender's document. The moment
- * anything is typed locally that number is wrong, so every position is mapped
- * forward on each change. Rendering is the host application's job — the engine
- * has no decoration layer, and inventing one here would be the wrong place.
+ * Deriving it beats assigning one, because two clients that never speak still
+ * agree on what colour a third person is.
  */
-declare class PresenceTracker {
-    private readonly editor;
-    private readonly onUpdate?;
-    private readonly people;
-    private readonly off;
-    constructor(editor: Editor<readonly AnyDef[]>, onUpdate?: ((people: Presence[]) => void) | undefined);
-    set(person: Presence): void;
-    remove(clientId: string): void;
-    list(): Presence[];
-    destroy(): void;
-}
+declare function colorFor(clientId: string): string;
+/**
+ * Other people's carets and selections, drawn as decorations.
+ *
+ * A remote caret arrives as a position in the *sender's* document. The instant
+ * anything is typed locally that number is wrong. The only correct fix is to
+ * map it through the same steps the local document went through, which is why
+ * this is an extension rather than a helper: extension state is reduced inside
+ * the transaction pipeline, where the mapping actually lives.
+ *
+ * Clamping to the document size — the obvious shortcut — is wrong. Insert ten
+ * characters at the start and every later caret should move ten forward;
+ * clamping leaves them all pointing at the wrong word.
+ */
+declare function remoteCursors(): ExtensionDef<{
+    setPresence: Command<[presence: Presence]>;
+    removePresence: Command<[clientId: string]>;
+    clearPresence: Command;
+}, RemoteCursors>;
+/** Enough styling to see a caret. Drop it in a stylesheet, or write your own. */
+declare const remoteCursorCSS = "\n.matra-remote-cursor {\n  position: relative;\n  margin-left: -1px;\n  margin-right: -1px;\n  pointer-events: none;\n  word-break: normal;\n}\n.matra-remote-cursor-label {\n  position: absolute;\n  top: -1.2em;\n  left: -2px;\n  padding: 0 4px;\n  border-radius: 3px;\n  color: #fff;\n  font-size: 11px;\n  line-height: 1.4;\n  white-space: nowrap;\n  user-select: none;\n}\n.matra-remote-selection {\n  border-radius: 2px;\n}\n";
 
-export { Authority, type CollabOptions, type CollabState, type CollabStep, type Presence, PresenceTracker, type Sendable, collab, getVersion, sendableSteps };
+export { Authority, type CollabOptions, type CollabState, type CollabStep, type Presence, type RemoteCursors, type Sendable, collab, colorFor, getVersion, remoteCursorCSS, remoteCursors, sendableSteps };

package/dist/index.d.ts

@@ -93,24 +93,34 @@ declare function sendableSteps(editor: Editor<readonly AnyDef[]>): Sendable | nu
 /** The version of the document this client believes it is on. */
 declare function getVersion(editor: Editor<readonly AnyDef[]>): number;
 
+/** Everyone else's caret, in this client's coordinates. */
+type RemoteCursors = ReadonlyMap<string, Presence>;
 /**
- * Other people's cursors, kept honest as the document changes.
+ * A colour per person, chosen from the id so it is stable everywhere.
  *
- * A remote caret arrives as a position in the sender's document. The moment
- * anything is typed locally that number is wrong, so every position is mapped
- * forward on each change. Rendering is the host application's job — the engine
- * has no decoration layer, and inventing one here would be the wrong place.
+ * Deriving it beats assigning one, because two clients that never speak still
+ * agree on what colour a third person is.
  */
-declare class PresenceTracker {
-    private readonly editor;
-    private readonly onUpdate?;
-    private readonly people;
-    private readonly off;
-    constructor(editor: Editor<readonly AnyDef[]>, onUpdate?: ((people: Presence[]) => void) | undefined);
-    set(person: Presence): void;
-    remove(clientId: string): void;
-    list(): Presence[];
-    destroy(): void;
-}
+declare function colorFor(clientId: string): string;
+/**
+ * Other people's carets and selections, drawn as decorations.
+ *
+ * A remote caret arrives as a position in the *sender's* document. The instant
+ * anything is typed locally that number is wrong. The only correct fix is to
+ * map it through the same steps the local document went through, which is why
+ * this is an extension rather than a helper: extension state is reduced inside
+ * the transaction pipeline, where the mapping actually lives.
+ *
+ * Clamping to the document size — the obvious shortcut — is wrong. Insert ten
+ * characters at the start and every later caret should move ten forward;
+ * clamping leaves them all pointing at the wrong word.
+ */
+declare function remoteCursors(): ExtensionDef<{
+    setPresence: Command<[presence: Presence]>;
+    removePresence: Command<[clientId: string]>;
+    clearPresence: Command;
+}, RemoteCursors>;
+/** Enough styling to see a caret. Drop it in a stylesheet, or write your own. */
+declare const remoteCursorCSS = "\n.matra-remote-cursor {\n  position: relative;\n  margin-left: -1px;\n  margin-right: -1px;\n  pointer-events: none;\n  word-break: normal;\n}\n.matra-remote-cursor-label {\n  position: absolute;\n  top: -1.2em;\n  left: -2px;\n  padding: 0 4px;\n  border-radius: 3px;\n  color: #fff;\n  font-size: 11px;\n  line-height: 1.4;\n  white-space: nowrap;\n  user-select: none;\n}\n.matra-remote-selection {\n  border-radius: 2px;\n}\n";
 
-export { Authority, type CollabOptions, type CollabState, type CollabStep, type Presence, PresenceTracker, type Sendable, collab, getVersion, sendableSteps };
+export { Authority, type CollabOptions, type CollabState, type CollabStep, type Presence, type RemoteCursors, type Sendable, collab, colorFor, getVersion, remoteCursorCSS, remoteCursors, sendableSteps };

package/dist/index.js

@@ -140,53 +140,157 @@ function readEngine(ctx) {
   return access;
 }
 
-// src/presence.ts
-var PresenceTracker = class {
-  constructor(editor, onUpdate) {
-    this.editor = editor;
-    this.onUpdate = onUpdate;
-    editor.getJSON();
-    this.off = editor.on("change", () => {
-      const size = measure(editor.getJSON());
-      for (const [id, person] of this.people) {
-        this.people.set(id, {
-          ...person,
-          anchor: Math.min(person.anchor, size),
-          head: Math.min(person.head, size)
+// src/remote-cursors.ts
+function readEngine2(ctx) {
+  const access = ctx[/* @__PURE__ */ Symbol.for("matra.engine")];
+  if (!access) throw new Error("Matra: remoteCursors ctx was created outside the engine");
+  return access;
+}
+function colorFor(clientId) {
+  let hash = 0;
+  for (let i = 0; i < clientId.length; i++) hash = hash * 31 + clientId.charCodeAt(i) | 0;
+  return `hsl(${Math.abs(hash) % 360} 70% 45%)`;
+}
+var META = "matra-presence";
+function remoteCursors() {
+  return {
+    kind: "extension",
+    name: "remoteCursors",
+    state: {
+      init: () => /* @__PURE__ */ new Map(),
+      apply(ctx, previous) {
+        const { tr } = readEngine2(ctx);
+        const action = tr.getMeta(META);
+        let next = previous;
+        if (tr.docChanged) {
+          const mapped = /* @__PURE__ */ new Map();
+          for (const [id, person] of previous) {
+            mapped.set(id, {
+              ...person,
+              anchor: tr.mapping.map(person.anchor),
+              head: tr.mapping.map(person.head)
+            });
+          }
+          next = mapped;
+        }
+        if (!action) return next;
+        const copy = new Map(next);
+        if ("clear" in action) copy.clear();
+        else if ("remove" in action) copy.delete(action.remove);
+        else if (isPlacedPresence(action.set)) copy.set(action.set.clientId, action.set);
+        return copy;
+      }
+    },
+    decorations(ctx) {
+      const { tr, pluginState } = readEngine2(ctx);
+      const people = pluginState("remoteCursors");
+      if (!people?.size) return [];
+      const size = tr.doc.content.size;
+      const out = [];
+      for (const person of people.values()) {
+        const anchor = clamp(person.anchor, size);
+        const head = clamp(person.head, size);
+        if (anchor === null || head === null) continue;
+        const color = colorFor(person.clientId);
+        const name = readName(person);
+        if (anchor !== head) {
+          out.push({
+            type: "inline",
+            from: Math.min(anchor, head),
+            to: Math.max(anchor, head),
+            attrs: {
+              class: "matra-remote-selection",
+              style: `background-color: ${color}; opacity: 0.25`
+            }
+          });
+        }
+        out.push({
+          type: "widget",
+          pos: head,
+          // Keyed by client so the renderer reuses the caret element instead of
+          // tearing it down and rebuilding it on every keystroke.
+          key: `cursor-${person.clientId}`,
+          side: 1,
+          render: () => renderCaret(color, name)
         });
       }
-      editor.getJSON();
-      this.onUpdate?.(this.list());
-    });
-  }
-  editor;
-  onUpdate;
-  people = /* @__PURE__ */ new Map();
-  off;
-  set(person) {
-    this.people.set(person.clientId, person);
-    this.onUpdate?.(this.list());
-  }
-  remove(clientId) {
-    if (this.people.delete(clientId)) this.onUpdate?.(this.list());
-  }
-  list() {
-    return [...this.people.values()];
-  }
-  destroy() {
-    this.off();
-    this.people.clear();
-  }
-};
-function measure(doc) {
-  if (typeof doc.text === "string") return doc.text.length;
-  let size = 0;
-  for (const child of doc.content ?? []) {
-    size += typeof child.text === "string" ? child.text.length : measure(child) + 2;
+      return out;
+    },
+    commands: {
+      setPresence: (ctx, presence) => {
+        if (!isPlacedPresence(presence)) return false;
+        readEngine2(ctx).tr.setMeta(META, { set: presence });
+        return true;
+      },
+      removePresence: (ctx, clientId) => {
+        if (typeof clientId !== "string" || !clientId) return false;
+        readEngine2(ctx).tr.setMeta(META, { remove: clientId });
+        return true;
+      },
+      clearPresence: (ctx) => {
+        readEngine2(ctx).tr.setMeta(META, { clear: true });
+        return true;
+      }
+    }
+  };
+}
+function isPlacedPresence(value) {
+  if (!value || typeof value !== "object") return false;
+  const person = value;
+  return typeof person.clientId === "string" && person.clientId.length > 0 && isPlace(person.anchor) && isPlace(person.head);
+}
+function isPlace(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function clamp(value, size) {
+  if (!isPlace(value)) return null;
+  return Math.min(value, size);
+}
+function renderCaret(color, name) {
+  const caret = document.createElement("span");
+  caret.className = "matra-remote-cursor";
+  caret.style.borderLeft = `2px solid ${color}`;
+  if (name !== null) {
+    const label = document.createElement("span");
+    label.className = "matra-remote-cursor-label";
+    label.style.backgroundColor = color;
+    label.textContent = name;
+    caret.appendChild(label);
   }
-  return size;
+  return caret;
+}
+function readName(person) {
+  const name = person.meta?.name;
+  if (typeof name !== "string") return null;
+  const trimmed = name.trim();
+  if (!trimmed) return null;
+  return trimmed.slice(0, 40);
+}
+var remoteCursorCSS = `
+.matra-remote-cursor {
+  position: relative;
+  margin-left: -1px;
+  margin-right: -1px;
+  pointer-events: none;
+  word-break: normal;
+}
+.matra-remote-cursor-label {
+  position: absolute;
+  top: -1.2em;
+  left: -2px;
+  padding: 0 4px;
+  border-radius: 3px;
+  color: #fff;
+  font-size: 11px;
+  line-height: 1.4;
+  white-space: nowrap;
+  user-select: none;
+}
+.matra-remote-selection {
+  border-radius: 2px;
 }
+`;
 
-export { Authority, PresenceTracker, collab, getVersion, sendableSteps };
+export { Authority, collab, colorFor, getVersion, remoteCursorCSS, remoteCursors, sendableSteps };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/authority.ts","../src/collab.ts","../src/presence.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { CollabStep } from './types'\n\n/**\n * The server side of the protocol, as a plain object.\n *\n * An authority is barely anything: a list of steps and the rule that a client\n * may only append if it is up to date. Keeping it transport-free means the same\n * object works over WebSocket, HTTP polling or an in-memory channel in tests.\n */\nexport class Authority {\n  private readonly history: CollabStep[] = []\n\n  constructor(private readonly onChange?: (version: number) => void) {}\n\n  get version(): number {\n    return this.history.length\n  }\n\n  /**\n   * Append steps if the client is current.\n   *\n   * Returns false when it is not — the client should pull what it missed,\n   * rebase, and try again. Rejecting rather than merging is what keeps the\n   * history linear and every client's version meaningful.\n   */\n  receive(version: number, steps: CollabStep[]): boolean {\n    if (version !== this.version) return false\n    this.history.push(...steps)\n    this.onChange?.(this.version)\n    return true\n  }\n\n  /** Everything that happened after `version`. */\n  since(version: number): CollabStep[] {\n    return this.history.slice(version)\n  }\n}\n","import type { AnyDef, Command, Ctx, Editor, ExtensionDef } from '@matrajs/core'\nimport type { CollabStep, Sendable } from './types'\n\nexport interface CollabOptions {\n  /** Identifies this client. Two clients must never share one. */\n  clientId: string\n  /** The version this client starts from. */\n  version?: number\n}\n\n/** A local step, kept with what it takes to rewind and rebase it. */\nexport interface PendingStep {\n  step: EngineStep\n  /** The step that undoes it, computed against the document it applied to. */\n  inverted: EngineStep\n  json: Record<string, unknown>\n  clientId: string\n}\n\nexport interface CollabState {\n  version: number\n  /** Local steps the authority has not confirmed yet. */\n  unconfirmed: PendingStep[]\n}\n\n/** The slice of a step this package needs; the engine owns the real type. */\ninterface EngineStep {\n  toJSON(): Record<string, unknown>\n  invert(doc: unknown): EngineStep\n  map(mapping: unknown): EngineStep | null\n}\n\nconst REMOTE = 'collab:remote'\nconst CONFIRM = 'collab:confirm'\nconst REBASED = 'collab:rebased'\n\n/**\n * Collaborative editing over a central authority.\n *\n * The protocol is the well-trodden one: a client sends the steps it has made\n * together with the version they applied to, and the authority accepts them\n * only if that version is still current. A client whose version is stale pulls\n * the steps it missed, rebases its own unconfirmed work over them, and tries\n * again.\n *\n * There is no CRDT here and no dependency. Rebasing already lives in the engine\n * — `Step.map` is what lets a local edit survive a remote one — so\n * collaboration is a version counter and a transport on top of it.\n */\nexport function collab(options: CollabOptions): ExtensionDef<\n  {\n    receiveCollabSteps: Command<[steps: CollabStep[]]>\n    confirmCollabSteps: Command<[count: number]>\n  },\n  CollabState\n> {\n  const clientId = options.clientId\n  if (!clientId) throw new Error('Matra: collab needs a clientId')\n\n  return {\n    kind: 'extension',\n    name: 'collab',\n    state: {\n      init: () => ({ version: options.version ?? 0, unconfirmed: [] }),\n      apply: (ctx, previous) => {\n        const engine = readEngine(ctx)\n        const tr = engine.tr\n\n        const confirmed = tr.getMeta(CONFIRM)\n        if (typeof confirmed === 'number') {\n          return {\n            version: previous.version + confirmed,\n            unconfirmed: previous.unconfirmed.slice(confirmed),\n          }\n        }\n\n        const rebased = tr.getMeta(REBASED) as\n          | { remote: number; unconfirmed: PendingStep[] }\n          | undefined\n        if (rebased) {\n          return {\n            version: previous.version + rebased.remote,\n            unconfirmed: rebased.unconfirmed,\n          }\n        }\n\n        if (!tr.steps.length) return previous\n        if (tr.getMeta(REMOTE)) return previous\n\n        // Local work: keep each step with its inverse, which is what lets it be\n        // rewound and replayed when someone else's edit arrives first.\n        const pending: PendingStep[] = tr.steps.map((step, index) => ({\n          step,\n          inverted: step.invert(tr.docs[index]),\n          json: step.toJSON(),\n          clientId,\n        }))\n        return {\n          version: previous.version,\n          unconfirmed: [...previous.unconfirmed, ...pending],\n        }\n      },\n    },\n    commands: {\n      /**\n       * Apply steps from other clients.\n       *\n       * Steps this client sent are skipped — they are already in the document,\n       * and applying them twice would duplicate the edit. A step that no longer\n       * applies is dropped rather than throwing: one bad message from a peer\n       * must not take the editor down.\n       */\n      receiveCollabSteps: (ctx, incoming) => {\n        if (!incoming?.length) return false\n        const engine = readEngine(ctx)\n        const foreign = incoming.filter((entry) => entry.clientId !== clientId)\n        if (!foreign.length) return false\n\n        const pending =\n          (engine.pluginState('collab') as CollabState | undefined)?.unconfirmed ?? []\n        const tr = engine.tr\n\n        // Rewind local work so the remote steps land on the document the\n        // authority actually has. Applying them on top of unsent local edits\n        // would leave both the document and the outgoing positions wrong.\n        for (let i = pending.length - 1; i >= 0; i--) {\n          tr.maybeStep(pending[i]?.inverted as never)\n        }\n\n        const beforeRemote = tr.steps.length\n        let applied = 0\n        for (const entry of foreign) {\n          const step = engine.stepFromJSON(entry.step)\n          if (step && tr.maybeStep(step)) applied++\n        }\n        if (!applied) return false\n\n        // Replay local work over the remote changes.\n        const remoteMapping = tr.mapping.slice(beforeRemote)\n        const rebased: PendingStep[] = []\n        for (const entry of pending) {\n          const mapped = entry.step.map(remoteMapping)\n          if (!mapped) continue\n          const docBefore = tr.doc\n          if (!tr.maybeStep(mapped as never)) continue\n          rebased.push({\n            step: mapped,\n            inverted: mapped.invert(docBefore),\n            json: mapped.toJSON(),\n            clientId,\n          })\n        }\n\n        tr.setMeta(REBASED, { remote: applied, unconfirmed: rebased })\n        return true\n      },\n\n      /** The authority accepted this many of our steps; stop tracking them. */\n      confirmCollabSteps: (ctx, count) => {\n        if (!Number.isInteger(count) || count <= 0) return false\n        readEngine(ctx).tr.setMeta(CONFIRM, count)\n        return true\n      },\n    },\n  }\n}\n\n/** Steps this client has made that the authority has not seen. */\nexport function sendableSteps(editor: Editor<readonly AnyDef[]>): Sendable | null {\n  const state = editor.extensionState<CollabState>('collab')\n  if (!state?.unconfirmed.length) return null\n  return {\n    version: state.version,\n    steps: state.unconfirmed.map((entry) => ({ step: entry.json, clientId: entry.clientId })),\n    clientId: state.unconfirmed[0]?.clientId ?? '',\n  }\n}\n\n/** The version of the document this client believes it is on. */\nexport function getVersion(editor: Editor<readonly AnyDef[]>): number {\n  return editor.extensionState<CollabState>('collab')?.version ?? 0\n}\n\ninterface CollabEngine {\n  tr: {\n    steps: EngineStep[]\n    docs: unknown[]\n    doc: unknown\n    mapping: { slice(from: number): unknown }\n    getMeta(key: string): unknown\n    setMeta(key: string, value: unknown): unknown\n    maybeStep(step: unknown): boolean\n  }\n  stepFromJSON(json: Record<string, unknown>): EngineStep | null\n  pluginState(key: string): unknown\n}\n\n/** Reach the engine the way bundled extensions do. */\nfunction readEngine(ctx: Ctx): CollabEngine {\n  const access = (ctx as unknown as Record<symbol, CollabEngine>)[Symbol.for('matra.engine')]\n  if (!access) throw new Error('Matra: collab ctx was created outside the engine')\n  return access\n}\n","import type { AnyDef, Editor } from '@matrajs/core'\nimport type { Presence } from './types'\n\n/**\n * Other people's cursors, kept honest as the document changes.\n *\n * A remote caret arrives as a position in the sender's document. The moment\n * anything is typed locally that number is wrong, so every position is mapped\n * forward on each change. Rendering is the host application's job — the engine\n * has no decoration layer, and inventing one here would be the wrong place.\n */\nexport class PresenceTracker {\n  private readonly people = new Map<string, Presence>()\n  private readonly off: () => void\n\n  constructor(\n    private readonly editor: Editor<readonly AnyDef[]>,\n    private readonly onUpdate?: (people: Presence[]) => void,\n  ) {\n    let previous = editor.getJSON()\n    this.off = editor.on('change', () => {\n      // Positions past the end of the document are clamped rather than dropped:\n      // a cursor at the end of a paragraph someone just shortened should sit at\n      // the new end, not disappear.\n      const size = measure(editor.getJSON())\n      for (const [id, person] of this.people) {\n        this.people.set(id, {\n          ...person,\n          anchor: Math.min(person.anchor, size),\n          head: Math.min(person.head, size),\n        })\n      }\n      previous = editor.getJSON()\n      void previous\n      this.onUpdate?.(this.list())\n    })\n  }\n\n  set(person: Presence): void {\n    this.people.set(person.clientId, person)\n    this.onUpdate?.(this.list())\n  }\n\n  remove(clientId: string): void {\n    if (this.people.delete(clientId)) this.onUpdate?.(this.list())\n  }\n\n  list(): Presence[] {\n    return [...this.people.values()]\n  }\n\n  destroy(): void {\n    this.off()\n    this.people.clear()\n  }\n}\n\nfunction measure(doc: { content?: unknown[]; text?: string }): number {\n  if (typeof doc.text === 'string') return doc.text.length\n  let size = 0\n  for (const child of (doc.content ?? []) as Array<{ content?: unknown[]; text?: string }>) {\n    size += typeof child.text === 'string' ? child.text.length : measure(child) + 2\n  }\n  return size\n}\n"]}
+{"version":3,"sources":["../src/authority.ts","../src/collab.ts","../src/remote-cursors.ts"],"names":["readEngine"],"mappings":"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","file":"index.js","sourcesContent":["import type { CollabStep } from './types'\n\n/**\n * The server side of the protocol, as a plain object.\n *\n * An authority is barely anything: a list of steps and the rule that a client\n * may only append if it is up to date. Keeping it transport-free means the same\n * object works over WebSocket, HTTP polling or an in-memory channel in tests.\n */\nexport class Authority {\n  private readonly history: CollabStep[] = []\n\n  constructor(private readonly onChange?: (version: number) => void) {}\n\n  get version(): number {\n    return this.history.length\n  }\n\n  /**\n   * Append steps if the client is current.\n   *\n   * Returns false when it is not — the client should pull what it missed,\n   * rebase, and try again. Rejecting rather than merging is what keeps the\n   * history linear and every client's version meaningful.\n   */\n  receive(version: number, steps: CollabStep[]): boolean {\n    if (version !== this.version) return false\n    this.history.push(...steps)\n    this.onChange?.(this.version)\n    return true\n  }\n\n  /** Everything that happened after `version`. */\n  since(version: number): CollabStep[] {\n    return this.history.slice(version)\n  }\n}\n","import type { AnyDef, Command, Ctx, Editor, ExtensionDef } from '@matrajs/core'\nimport type { CollabStep, Sendable } from './types'\n\nexport interface CollabOptions {\n  /** Identifies this client. Two clients must never share one. */\n  clientId: string\n  /** The version this client starts from. */\n  version?: number\n}\n\n/** A local step, kept with what it takes to rewind and rebase it. */\nexport interface PendingStep {\n  step: EngineStep\n  /** The step that undoes it, computed against the document it applied to. */\n  inverted: EngineStep\n  json: Record<string, unknown>\n  clientId: string\n}\n\nexport interface CollabState {\n  version: number\n  /** Local steps the authority has not confirmed yet. */\n  unconfirmed: PendingStep[]\n}\n\n/** The slice of a step this package needs; the engine owns the real type. */\ninterface EngineStep {\n  toJSON(): Record<string, unknown>\n  invert(doc: unknown): EngineStep\n  map(mapping: unknown): EngineStep | null\n}\n\nconst REMOTE = 'collab:remote'\nconst CONFIRM = 'collab:confirm'\nconst REBASED = 'collab:rebased'\n\n/**\n * Collaborative editing over a central authority.\n *\n * The protocol is the well-trodden one: a client sends the steps it has made\n * together with the version they applied to, and the authority accepts them\n * only if that version is still current. A client whose version is stale pulls\n * the steps it missed, rebases its own unconfirmed work over them, and tries\n * again.\n *\n * There is no CRDT here and no dependency. Rebasing already lives in the engine\n * — `Step.map` is what lets a local edit survive a remote one — so\n * collaboration is a version counter and a transport on top of it.\n */\nexport function collab(options: CollabOptions): ExtensionDef<\n  {\n    receiveCollabSteps: Command<[steps: CollabStep[]]>\n    confirmCollabSteps: Command<[count: number]>\n  },\n  CollabState\n> {\n  const clientId = options.clientId\n  if (!clientId) throw new Error('Matra: collab needs a clientId')\n\n  return {\n    kind: 'extension',\n    name: 'collab',\n    state: {\n      init: () => ({ version: options.version ?? 0, unconfirmed: [] }),\n      apply: (ctx, previous) => {\n        const engine = readEngine(ctx)\n        const tr = engine.tr\n\n        const confirmed = tr.getMeta(CONFIRM)\n        if (typeof confirmed === 'number') {\n          return {\n            version: previous.version + confirmed,\n            unconfirmed: previous.unconfirmed.slice(confirmed),\n          }\n        }\n\n        const rebased = tr.getMeta(REBASED) as\n          | { remote: number; unconfirmed: PendingStep[] }\n          | undefined\n        if (rebased) {\n          return {\n            version: previous.version + rebased.remote,\n            unconfirmed: rebased.unconfirmed,\n          }\n        }\n\n        if (!tr.steps.length) return previous\n        if (tr.getMeta(REMOTE)) return previous\n\n        // Local work: keep each step with its inverse, which is what lets it be\n        // rewound and replayed when someone else's edit arrives first.\n        const pending: PendingStep[] = tr.steps.map((step, index) => ({\n          step,\n          inverted: step.invert(tr.docs[index]),\n          json: step.toJSON(),\n          clientId,\n        }))\n        return {\n          version: previous.version,\n          unconfirmed: [...previous.unconfirmed, ...pending],\n        }\n      },\n    },\n    commands: {\n      /**\n       * Apply steps from other clients.\n       *\n       * Steps this client sent are skipped — they are already in the document,\n       * and applying them twice would duplicate the edit. A step that no longer\n       * applies is dropped rather than throwing: one bad message from a peer\n       * must not take the editor down.\n       */\n      receiveCollabSteps: (ctx, incoming) => {\n        if (!incoming?.length) return false\n        const engine = readEngine(ctx)\n        const foreign = incoming.filter((entry) => entry.clientId !== clientId)\n        if (!foreign.length) return false\n\n        const pending =\n          (engine.pluginState('collab') as CollabState | undefined)?.unconfirmed ?? []\n        const tr = engine.tr\n\n        // Rewind local work so the remote steps land on the document the\n        // authority actually has. Applying them on top of unsent local edits\n        // would leave both the document and the outgoing positions wrong.\n        for (let i = pending.length - 1; i >= 0; i--) {\n          tr.maybeStep(pending[i]?.inverted as never)\n        }\n\n        const beforeRemote = tr.steps.length\n        let applied = 0\n        for (const entry of foreign) {\n          const step = engine.stepFromJSON(entry.step)\n          if (step && tr.maybeStep(step)) applied++\n        }\n        if (!applied) return false\n\n        // Replay local work over the remote changes.\n        const remoteMapping = tr.mapping.slice(beforeRemote)\n        const rebased: PendingStep[] = []\n        for (const entry of pending) {\n          const mapped = entry.step.map(remoteMapping)\n          if (!mapped) continue\n          const docBefore = tr.doc\n          if (!tr.maybeStep(mapped as never)) continue\n          rebased.push({\n            step: mapped,\n            inverted: mapped.invert(docBefore),\n            json: mapped.toJSON(),\n            clientId,\n          })\n        }\n\n        tr.setMeta(REBASED, { remote: applied, unconfirmed: rebased })\n        return true\n      },\n\n      /** The authority accepted this many of our steps; stop tracking them. */\n      confirmCollabSteps: (ctx, count) => {\n        if (!Number.isInteger(count) || count <= 0) return false\n        readEngine(ctx).tr.setMeta(CONFIRM, count)\n        return true\n      },\n    },\n  }\n}\n\n/** Steps this client has made that the authority has not seen. */\nexport function sendableSteps(editor: Editor<readonly AnyDef[]>): Sendable | null {\n  const state = editor.extensionState<CollabState>('collab')\n  if (!state?.unconfirmed.length) return null\n  return {\n    version: state.version,\n    steps: state.unconfirmed.map((entry) => ({ step: entry.json, clientId: entry.clientId })),\n    clientId: state.unconfirmed[0]?.clientId ?? '',\n  }\n}\n\n/** The version of the document this client believes it is on. */\nexport function getVersion(editor: Editor<readonly AnyDef[]>): number {\n  return editor.extensionState<CollabState>('collab')?.version ?? 0\n}\n\ninterface CollabEngine {\n  tr: {\n    steps: EngineStep[]\n    docs: unknown[]\n    doc: unknown\n    mapping: { slice(from: number): unknown }\n    getMeta(key: string): unknown\n    setMeta(key: string, value: unknown): unknown\n    maybeStep(step: unknown): boolean\n  }\n  stepFromJSON(json: Record<string, unknown>): EngineStep | null\n  pluginState(key: string): unknown\n}\n\n/** Reach the engine the way bundled extensions do. */\nfunction readEngine(ctx: Ctx): CollabEngine {\n  const access = (ctx as unknown as Record<symbol, CollabEngine>)[Symbol.for('matra.engine')]\n  if (!access) throw new Error('Matra: collab ctx was created outside the engine')\n  return access\n}\n","import type { Command, Ctx, DecorationSpec, ExtensionDef, Pos } from '@matrajs/core'\nimport type { Presence } from './types'\n\n/** The slice of the engine this extension needs, reached the way collab does. */\ninterface CursorEngine {\n  tr: {\n    docChanged: boolean\n    doc: { content: { size: number } }\n    mapping: { map(pos: number, assoc?: -1 | 1): number }\n    getMeta(key: string): unknown\n    setMeta(key: string, value: unknown): unknown\n  }\n  pluginState(key: string): unknown\n}\n\nfunction readEngine(ctx: Ctx): CursorEngine {\n  const access = (ctx as unknown as Record<symbol, CursorEngine>)[Symbol.for('matra.engine')]\n  if (!access) throw new Error('Matra: remoteCursors ctx was created outside the engine')\n  return access\n}\n\n/** Everyone else's caret, in this client's coordinates. */\nexport type RemoteCursors = ReadonlyMap<string, Presence>\n\n/**\n * A colour per person, chosen from the id so it is stable everywhere.\n *\n * Deriving it beats assigning one, because two clients that never speak still\n * agree on what colour a third person is.\n */\nexport function colorFor(clientId: string): string {\n  let hash = 0\n  for (let i = 0; i < clientId.length; i++) hash = (hash * 31 + clientId.charCodeAt(i)) | 0\n  // Fixed saturation and lightness keep every colour legible on white and dark.\n  return `hsl(${Math.abs(hash) % 360} 70% 45%)`\n}\n\nconst META = 'matra-presence'\n\n/** What a presence message asks the extension to do. */\ntype PresenceAction = { set: Presence } | { remove: string } | { clear: true }\n\n/**\n * Other people's carets and selections, drawn as decorations.\n *\n * A remote caret arrives as a position in the *sender's* document. The instant\n * anything is typed locally that number is wrong. The only correct fix is to\n * map it through the same steps the local document went through, which is why\n * this is an extension rather than a helper: extension state is reduced inside\n * the transaction pipeline, where the mapping actually lives.\n *\n * Clamping to the document size — the obvious shortcut — is wrong. Insert ten\n * characters at the start and every later caret should move ten forward;\n * clamping leaves them all pointing at the wrong word.\n */\nexport function remoteCursors(): ExtensionDef<\n  {\n    setPresence: Command<[presence: Presence]>\n    removePresence: Command<[clientId: string]>\n    clearPresence: Command\n  },\n  RemoteCursors\n> {\n  return {\n    kind: 'extension',\n    name: 'remoteCursors',\n\n    state: {\n      init: () => new Map<string, Presence>(),\n\n      apply(ctx, previous) {\n        const { tr } = readEngine(ctx)\n        const action = tr.getMeta(META) as PresenceAction | undefined\n        let next = previous\n\n        // Map first, then apply the message. A message arriving in the same\n        // transaction as an edit already describes the document after it.\n        if (tr.docChanged) {\n          // This transaction's own mapping, not ctx.mark() — that one maps\n          // changes made *after* it is taken, and by the time a reducer runs\n          // the change it must account for is the one already in `tr`.\n          const mapped = new Map<string, Presence>()\n          for (const [id, person] of previous) {\n            mapped.set(id, {\n              ...person,\n              anchor: tr.mapping.map(person.anchor),\n              head: tr.mapping.map(person.head),\n            })\n          }\n          next = mapped\n        }\n\n        if (!action) return next\n\n        const copy = new Map(next)\n        if ('clear' in action) copy.clear()\n        else if ('remove' in action) copy.delete(action.remove)\n        else if (isPlacedPresence(action.set)) copy.set(action.set.clientId, action.set)\n        return copy\n      },\n    },\n\n    decorations(ctx) {\n      const { tr, pluginState } = readEngine(ctx)\n      const people = pluginState('remoteCursors') as RemoteCursors | undefined\n      if (!people?.size) return []\n\n      const size = tr.doc.content.size\n      const out: DecorationSpec[] = []\n\n      for (const person of people.values()) {\n        // A peer can send anything. A caret outside the document would throw\n        // deep in the decoration mapper, so it is dropped here instead.\n        const anchor = clamp(person.anchor, size)\n        const head = clamp(person.head, size)\n        if (anchor === null || head === null) continue\n\n        const color = colorFor(person.clientId)\n        const name = readName(person)\n\n        if (anchor !== head) {\n          out.push({\n            type: 'inline',\n            from: Math.min(anchor, head) as Pos,\n            to: Math.max(anchor, head) as Pos,\n            attrs: {\n              class: 'matra-remote-selection',\n              style: `background-color: ${color}; opacity: 0.25`,\n            },\n          })\n        }\n\n        out.push({\n          type: 'widget',\n          pos: head as Pos,\n          // Keyed by client so the renderer reuses the caret element instead of\n          // tearing it down and rebuilding it on every keystroke.\n          key: `cursor-${person.clientId}`,\n          side: 1,\n          render: () => renderCaret(color, name),\n        })\n      }\n\n      return out\n    },\n\n    commands: {\n      setPresence: (ctx, presence) => {\n        if (!isPlacedPresence(presence)) return false\n        readEngine(ctx).tr.setMeta(META, { set: presence })\n        return true\n      },\n      removePresence: (ctx, clientId) => {\n        if (typeof clientId !== 'string' || !clientId) return false\n        readEngine(ctx).tr.setMeta(META, { remove: clientId })\n        return true\n      },\n      clearPresence: (ctx) => {\n        readEngine(ctx).tr.setMeta(META, { clear: true })\n        return true\n      },\n    },\n  }\n}\n\n/** Is this a presence message we can place, or noise from the wire? */\nfunction isPlacedPresence(value: unknown): value is Presence {\n  if (!value || typeof value !== 'object') return false\n  const person = value as Presence\n  return (\n    typeof person.clientId === 'string' &&\n    person.clientId.length > 0 &&\n    isPlace(person.anchor) &&\n    isPlace(person.head)\n  )\n}\n\nfunction isPlace(value: unknown): value is number {\n  return typeof value === 'number' && Number.isInteger(value) && value >= 0\n}\n\nfunction clamp(value: number, size: number): number | null {\n  if (!isPlace(value)) return null\n  return Math.min(value, size)\n}\n\n/**\n * The caret element.\n *\n * Built with `document.createElement` and `textContent` rather than a template\n * string: the label is a display name chosen by another user, and it must not\n * be able to become markup.\n */\nfunction renderCaret(color: string, name: string | null): HTMLElement {\n  const caret = document.createElement('span')\n  caret.className = 'matra-remote-cursor'\n  caret.style.borderLeft = `2px solid ${color}`\n\n  if (name !== null) {\n    const label = document.createElement('span')\n    label.className = 'matra-remote-cursor-label'\n    label.style.backgroundColor = color\n    label.textContent = name\n    caret.appendChild(label)\n  }\n  return caret\n}\n\n/** A display name, if the sender supplied a usable one. */\nfunction readName(person: Presence): string | null {\n  const name = person.meta?.name\n  if (typeof name !== 'string') return null\n  const trimmed = name.trim()\n  if (!trimmed) return null\n  // A name is a label, not an essay; a peer sending 10kB of it is an attack.\n  return trimmed.slice(0, 40)\n}\n\n/** Enough styling to see a caret. Drop it in a stylesheet, or write your own. */\nexport const remoteCursorCSS = `\n.matra-remote-cursor {\n  position: relative;\n  margin-left: -1px;\n  margin-right: -1px;\n  pointer-events: none;\n  word-break: normal;\n}\n.matra-remote-cursor-label {\n  position: absolute;\n  top: -1.2em;\n  left: -2px;\n  padding: 0 4px;\n  border-radius: 3px;\n  color: #fff;\n  font-size: 11px;\n  line-height: 1.4;\n  white-space: nowrap;\n  user-select: none;\n}\n.matra-remote-selection {\n  border-radius: 2px;\n}\n`\n"]}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@matrajs/collab",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "Collaborative editing for Matra — step exchange, rebasing and presence. No CRDT dependency.",
-  "license": "MIT",
+  "license": "SEE LICENSE IN LICENSE",
   "author": "Nahim Hossain Shohan",
   "homepage": "https://matrajs.com",
   "repository": {
@@ -37,10 +37,11 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "dependencies": {
-    "@matrajs/core": "^0.4.1"
+    "@matrajs/core": "^0.6.0"
   },
   "scripts": {
     "build": "tsup",