@ebbjs/codemirror 0.0.0-stage → 0.1.1

package/LICENSE.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,90 @@
-# Temporary Holding Version
+# `@ebbjs/codemirror`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+CodeMirror 6 bridge for [`@ebbjs/client`](https://github.com/ebbjs/ebbjs/tree/main/packages/client)'s `TextDocument`. Wires a CM6 editor view to a causal-tree document so that:
+
+- Local CM edits become `doc.localInsert` / `doc.localExtend` / `doc.localDelete` calls.
+- Remote updates (catch-up / SSE) flow into CM as text changes.
+
+A CM `StateField` mirrors `doc.docState.index.spans`, so consumers (presence, cursor anchoring, etc.) can map CM positions to run ids.
+
+## Install
+
+```bash
+npm install @ebbjs/codemirror
+npm install @codemirror/state @codemirror/view codemirror   # peers
+```
+
+Node `>=22.8.0`. `@ebbjs/client` is a normal dependency and installs with it.
+
+```ts
+import { createBridgeExtension, mountEditorBridge } from "@ebbjs/codemirror";
+```
+
+## Usage
+
+```ts
+import { EditorState } from "@codemirror/state";
+import { EditorView, keymap, lineNumbers } from "@codemirror/view";
+import { defaultKeymap } from "@codemirror/commands";
+import { createClient } from "@ebbjs/client";
+import { createBridgeExtension, createIdMapField, mountEditorBridge } from "@ebbjs/codemirror";
+
+const client = createClient({ serverUrl: "http://localhost:4000", actorId: "alice" });
+const doc = client.textDocument("doc_demo");
+const idMapField = createIdMapField();
+
+// Capture the view via a closure so the bridge can read it inside
+// the CM updateListener (the listener fires synchronously inside
+// `view.dispatch`).
+const viewRef = { current: null as EditorView | null };
+const bridgeExtension = createBridgeExtension({
+  doc,
+  idMapField,
+  getView: () => viewRef.current,
+});
+
+const view = new EditorView({
+  state: EditorState.create({
+    doc: "",
+    extensions: [lineNumbers(), keymap.of(defaultKeymap), bridgeExtension],
+  }),
+  parent: container,
+});
+viewRef.current = view;
+
+const bridge = mountEditorBridge(view, doc, idMapField);
+// later: bridge.detach(); view.destroy();
+```
+
+## API
+
+| Export                                                | What                                                                                       |
+| ----------------------------------------------------- | ------------------------------------------------------------------------------------------ |
+| `createBridgeExtension({ doc, idMapField, getView })` | CM6 Extension that listens for local edits and dispatches `doc.local*` calls.              |
+| `mountEditorBridge(view, doc, idMapField)`            | Subscribes to `doc.onUpdate` and applies remote updates to the view. Returns `{ detach }`. |
+| `createIdMapField()`                                  | The `StateField` mirroring `doc.docState.index.spans`.                                     |
+| `setIdMapEffect`                                      | The `StateEffect` that replaces the field's value (re-exported for advanced use).          |
+| `isRemote`                                            | The `Annotation` marking a CM transaction as originating from the bridge.                  |
+| `getRunAtPosition(state, position, idMapField)`       | Lookup helper: which run contains a document position?                                     |
+| `getPositionOfRun(state, runId, offset, idMapField)`  | Inverse: what absolute position does a (runId, offset) pair map to?                        |
+| `RunSpan`                                             | The `{ runId, length }` shape exposed via the StateField.                                  |
+
+## Peer dependencies
+
+```json
+{
+  "@codemirror/state": "^6.5.0",
+  "@codemirror/view": "^6.30.0",
+  "codemirror": "^6.0.0"
+}
+```
+
+`@ebbjs/client` is a regular dependency.
+
+## How it works
+
+The bridge uses a `isRemote` annotation to mark transactions it dispatches itself (e.g., pushing remote updates into CM). The local-CM→doc `updateListener` skips transactions with this annotation, breaking the recursive loop.
+
+A second listener (subscribed via `doc.onUpdate`) computes the CM changes needed to reflect a remote update, then dispatches them in a single transaction along with the spans-update effect.
+
+The local listener doesn't need to update the spans field — CM is the source of truth during a local edit, and the spans field is updated by the same dispatch that applies remote changes.

package/dist/index.d.ts

@@ -0,0 +1,154 @@
+import * as _codemirror_state from '@codemirror/state';
+import { StateField, Extension } from '@codemirror/state';
+import { EditorView } from '@codemirror/view';
+import { TextDocument, RunSpan, PresenceEntry } from '@ebbjs/client';
+export { CursorPresence, PresenceEntry, ROOT_ID, RunSpan } from '@ebbjs/client';
+
+/**
+ * Marks a CM transaction as originating from the bridge (i.e., a
+ * remote doc update being pushed into CM, not a user keystroke).
+ * The local-CM→doc listener skips transactions with this annotation
+ * to avoid recursive loops.
+ */
+declare const isRemote: _codemirror_state.AnnotationType<boolean>;
+/** Replace the spans StateField's value with a fresh array. */
+declare const setIdMapEffect: _codemirror_state.StateEffectType<readonly RunSpan[]>;
+/**
+ * Zero-length span at the document root. The CM-side `idMapField`
+ * always carries this so empty-doc clicks resolve to `(ROOT_ID, 0)`
+ * for presence anchoring. The doc tree's `PositionIndex.spans` never
+ * contains this — it lives only in the CM mirror.
+ */
+declare const ROOT_PLACEHOLDER_SPAN: RunSpan;
+/** Ensure the spans array carries the ROOT placeholder so the CM mirror never goes empty. */
+declare const ensureRootSpan: (spans: readonly RunSpan[]) => readonly RunSpan[];
+/**
+ * CM StateField mirroring `doc.docState.index.spans`. Always carries
+ * at least the ROOT placeholder so empty-doc clicks resolve to
+ * `(ROOT_ID, 0)`.
+ */
+declare const createIdMapField: () => StateField<readonly RunSpan[]>;
+/**
+ * Find the run that contains a given document position, using the
+ * StateField. Returns `{ runId, offset, spanIndex }` or undefined.
+ *
+ * CodeMirror positions are in `[0, doc.length]` inclusive, so a
+ * position equal to the sum of all spans' lengths is still inside
+ * the last run.
+ */
+declare const getRunAtPosition: (state: {
+    field: <T>(f: StateField<T>) => T;
+}, position: number, idMapField: StateField<readonly RunSpan[]>) => {
+    runId: string;
+    offset: number;
+    spanIndex: number;
+} | undefined;
+/**
+ * Compute the document position of a given (runId, offsetWithinRun).
+ * Returns undefined if the run is not visible in the current spans.
+ *
+ * `offset` may equal `span.length` — that's the position immediately
+ * past the last character of the run, a legitimate cursor position.
+ */
+declare const getPositionOfRun: (state: {
+    field: <T>(f: StateField<T>) => T;
+}, runId: string, offset: number, idMapField: StateField<readonly RunSpan[]>) => number | undefined;
+/**
+ * Shared mutable state between the bridge extension (which sets the
+ * flag during a local edit) and `mountEditorBridge` (which reads it
+ * to skip applying cmChanges for events raised during a local edit).
+ *
+ * Lives in a plain object so the reference is stable across the
+ * two closures — both `createBridgeExtension` and `mountEditorBridge`
+ * receive the same object.
+ */
+interface LocalEditTracker {
+    /** Set to true while inside a local-CM→doc transaction. */
+    active: boolean;
+}
+/** Options for {@link createBridgeExtension}. */
+interface BridgeExtensionConfig {
+    readonly doc: TextDocument;
+    readonly idMapField: StateField<readonly RunSpan[]>;
+    /**
+     * Returns the current EditorView. The bridge captures this lazily
+     * via a closure so the caller can set the view after constructing
+     * the EditorState.
+     */
+    readonly getView: () => EditorView | null;
+    /**
+     * Shared tracker that the bridge flips on/off around local-CM→doc
+     * dispatches. `mountEditorBridge` reads it to skip applying
+     * cmChanges for events raised during a local edit. Optional — if
+     * omitted, the bridge assumes all doc updates are remote.
+     */
+    readonly localEdit?: LocalEditTracker;
+}
+/**
+ * Create the CM6 Extension that pipes local edits to the document.
+ *
+ * The extension bundles `idMapField` plus an `updateListener` that
+ * intercepts non-remote transactions and dispatches the corresponding
+ * `doc.local*` calls. Remote transactions are skipped.
+ */
+declare const createBridgeExtension: (config: BridgeExtensionConfig) => Extension;
+/** A handle returned by {@link mountEditorBridge} for tearing down. */
+interface EditorBridge {
+    /** Stop listening to doc updates. */
+    detach: () => void;
+}
+/**
+ * Wire the document's `onUpdate` stream to the given CM view. After
+ * calling this, remote updates (catch-up / SSE) flowing through the
+ * TextDocument will be applied to the editor.
+ *
+ * The CM view must already have been created with
+ * {@link createBridgeExtension} in its extensions list.
+ *
+ * If `doc.text` differs from the view's current text (e.g., the
+ * document was populated before the bridge was attached, via catch-up),
+ * the initial state is synced via a remote-annotated dispatch.
+ */
+declare function mountEditorBridge(view: EditorView, doc: TextDocument, idMapField: StateField<readonly RunSpan[]>, localEdit?: LocalEditTracker): EditorBridge;
+
+/**
+ * CodeMirror 6 ViewPlugin that renders remote peers' cursors and
+ * selections as decorations.
+ *
+ * Reads from a `PresenceManager` (transport lives in
+ * `@ebbjs/client/src/presence/presence`). Run IDs are stable across
+ * edits so we resolve them to current document positions via the
+ * bridge's `idMapField` (a StateField that mirrors the causal tree's
+ * span index). If a run was deleted or split in a way the receiver
+ * can't resolve, the position falls back to undefined and we skip
+ * rendering for that peer.
+ *
+ * The plugin rebuilds decorations on every CM update. For a prototype
+ * with a handful of peers, this is O(peers × spans) per update and
+ * fine. For more peers, batching + dirty checking would be the
+ * next move.
+ */
+
+interface PresenceDecorationConfig {
+    /**
+     * Called to get the current presence entries for this entity.
+     * Returns a fresh map each call; the ViewPlugin caches results
+     * between CM updates.
+     */
+    readonly getPresence: () => ReadonlyMap<string, PresenceEntry>;
+    /** Called to look up a run's current document position. */
+    readonly getPositionOfRun: (runId: string, offset: number) => number | undefined;
+    /** Called to map a document position back to (runId, offset). */
+    readonly getRunAtPosition: (position: number) => {
+        runId: string;
+        offset: number;
+    } | undefined;
+}
+/**
+ * Build a CM6 Extension (ViewPlugin) that renders presence as
+ * decorations. Decorations rebuild on every CM update.
+ */
+declare function createPresenceExtension(config: PresenceDecorationConfig): Extension;
+
+export { ROOT_PLACEHOLDER_SPAN, createBridgeExtension, createIdMapField, createPresenceExtension, ensureRootSpan, getPositionOfRun, getRunAtPosition, isRemote, mountEditorBridge, setIdMapEffect };
+export type { BridgeExtensionConfig, EditorBridge, LocalEditTracker, PresenceDecorationConfig };

package/dist/index.js

@@ -0,0 +1,274 @@
+import { Annotation as B, StateEffect as V, StateField as W } from "@codemirror/state";
+import { EditorView as $, ViewPlugin as H, Decoration as I, WidgetType as K } from "@codemirror/view";
+import { ROOT_ID as U } from "@ebbjs/client";
+import { ROOT_ID as st } from "@ebbjs/client";
+const x = B.define(), b = V.define(), v = { runId: U, length: 0 }, S = (o) => o.length === 0 ? [v] : o, X = () => W.define({
+  create: () => [v],
+  update: (o, t) => {
+    for (const e of t.effects)
+      if (e.is(b))
+        return S(e.value);
+    return o;
+  }
+}), Y = (o, t, e) => {
+  const r = o.field(e);
+  let a = 0;
+  for (let s = 0; s < r.length; s++) {
+    const n = r[s];
+    if (t <= a + n.length)
+      return { runId: n.runId, offset: t - a, spanIndex: s };
+    a += n.length;
+  }
+}, Z = (o, t, e, r) => {
+  const a = o.field(r);
+  let s = 0;
+  for (const n of a) {
+    if (n.runId === t)
+      return e > n.length ? void 0 : s + e;
+    s += n.length;
+  }
+}, tt = (o) => [
+  o.idMapField,
+  $.updateListener.of((t) => {
+    const e = o.getView();
+    if (!e || !t.docChanged) return;
+    const r = t.transactions.find((l) => l.docChanged && !l.annotation(x));
+    if (!r) return;
+    const { idMapField: a, doc: s, localEdit: n } = o, c = e.state.field(a);
+    n && (n.active = !0);
+    try {
+      r.changes.iterChanges((l, i, d, g, O) => {
+        if (i > l) {
+          let h = l;
+          for (; h < i; ) {
+            const p = L(c, h);
+            if (!p) {
+              h += 1;
+              continue;
+            }
+            const F = p.spanLength - p.runOffset, N = i - h, E = Math.min(F, N);
+            s.localDelete({
+              runId: p.runId,
+              offset: p.runOffset,
+              count: E
+            }), h += E;
+          }
+        }
+        const f = O.toString();
+        if (f.length === 0) return;
+        if (l === 0) {
+          s.localInsert(f, { afterRun: "ROOT" });
+          return;
+        }
+        const m = L(c, l - 1);
+        if (!m) {
+          s.localInsert(f, { afterRun: "ROOT" });
+          return;
+        }
+        const u = s.docState.nodes.get(m.runId);
+        if (!u || u.deleted) {
+          s.localInsert(f, { afterRun: "ROOT" });
+          return;
+        }
+        const P = m.runOffset === u.text.length - 1, k = u.actorId === s.actorId, A = !u.deleted, _ = (s.docState.children.get(u.id) ?? []).length === 0;
+        if (P && k && A && _) {
+          s.localExtend({
+            runId: u.id,
+            appendText: f
+          });
+          return;
+        }
+        let y;
+        P || (y = m.runOffset + 1), s.localInsert(f, {
+          afterRun: u.id,
+          ...y !== void 0 && { splitParentAt: y }
+        });
+      });
+    } finally {
+      n && (n.active = !1);
+    }
+  })
+];
+function et(o, t, e, r) {
+  const a = t.text, s = S(D(t.docState.index.spans));
+  o.state.doc.toString() !== a ? o.dispatch({
+    changes: { from: 0, to: o.state.doc.length, insert: a },
+    effects: b.of(s),
+    annotations: x.of(!0)
+  }) : o.dispatch({
+    effects: b.of(s),
+    annotations: x.of(!0)
+  });
+  const n = t.onUpdate((c) => {
+    c && q(o, t, e, c, r);
+  });
+  return {
+    detach: () => {
+      n();
+    }
+  };
+}
+function q(o, t, e, r, a) {
+  const s = o.state.field(e), n = t.docState.nodes.get(r.runId), c = !!a?.active;
+  let l = [];
+  if (r.kind === "tombstone") {
+    const i = R(s, r.runId);
+    i && !c && (l = [{ from: i.start, to: i.end }]);
+  } else if (r.kind === "extend") {
+    const i = R(s, r.runId);
+    i && n && !n.deleted && !c && (l = [{ from: i.start, to: i.end, insert: n.text }]);
+  } else if (r.kind === "insert" && n && !n.deleted && !c) {
+    const i = R(s, n.parentId);
+    l = [{ from: i ? i.end : 0, insert: n.text }];
+  }
+  o.dispatch({
+    changes: l,
+    effects: b.of(S(D(t.docState.index.spans))),
+    annotations: x.of(!0)
+  });
+}
+function L(o, t) {
+  let e = 0;
+  for (let r = 0; r < o.length; r++) {
+    const a = o[r];
+    if (t < e + a.length)
+      return {
+        runId: a.runId,
+        runOffset: t - e,
+        spanIndex: r,
+        spanLength: a.length
+      };
+    e += a.length;
+  }
+}
+function R(o, t) {
+  let e = 0;
+  for (const r of o) {
+    if (r.runId === t)
+      return { start: e, end: e + r.length };
+    e += r.length;
+  }
+}
+function D(o) {
+  return o.map((t) => ({ runId: t.runId, length: t.length }));
+}
+class T extends K {
+  constructor(t, e) {
+    super(), this.color = t, this.label = e;
+  }
+  toDOM() {
+    const t = document.createElement("span");
+    t.className = "cm-remote-cursor", t.style.borderLeft = `2px solid ${this.color}`, t.style.height = "1.2em", t.style.display = "inline-block", t.style.width = "0", t.style.verticalAlign = "text-bottom", t.style.position = "relative", t.style.marginLeft = "-1px", t.style.marginRight = "-1px", t.setAttribute("aria-label", `${this.label}'s cursor`);
+    const e = document.createElement("span");
+    return e.className = "cm-remote-cursor-label", e.textContent = this.label, e.style.position = "absolute", e.style.bottom = "calc(100% + 1px)", e.style.left = "-1px", e.style.padding = "1px 4px", e.style.fontSize = "10px", e.style.lineHeight = "1.2", e.style.backgroundColor = this.color, e.style.color = "white", e.style.borderRadius = "2px", e.style.whiteSpace = "nowrap", e.style.pointerEvents = "none", t.appendChild(e), t;
+  }
+  eq(t) {
+    return this.color === t.color && this.label === t.label;
+  }
+  ignoreEvent() {
+    return !0;
+  }
+}
+function nt(o) {
+  return H.fromClass(
+    class {
+      decorations;
+      constructor(t) {
+        this.decorations = C(t.state, o);
+      }
+      update(t) {
+        this.decorations = C(t.state, o);
+      }
+    },
+    {
+      decorations: (t) => t.decorations
+    }
+  );
+}
+function C(o, t) {
+  const e = Array.from(t.getPresence().values()), r = o.doc.length, a = [];
+  for (const n of e) {
+    const c = t.getPositionOfRun(n.cursor.anchorId, n.cursor.anchorOffset), l = t.getPositionOfRun(n.cursor.headId, n.cursor.headOffset);
+    if (c === void 0 || l === void 0) continue;
+    const i = Math.min(Math.max(0, c), r), d = Math.min(Math.max(0, l), r), g = z(n.actorId);
+    if (i === d)
+      a.push({
+        from: d,
+        to: d,
+        dec: I.widget({
+          widget: new T(g, n.actorId),
+          side: 1
+        })
+      });
+    else {
+      const O = Math.min(i, d), f = Math.max(i, d);
+      a.push({
+        from: O,
+        to: f,
+        dec: I.mark({
+          class: "cm-remote-selection",
+          attributes: {
+            style: `background-color: ${g}33`
+          }
+        })
+      }), a.push({
+        from: d,
+        to: d,
+        dec: I.widget({
+          widget: new T(g, n.actorId),
+          side: 1
+        })
+      });
+    }
+  }
+  a.sort((n, c) => n.from - c.from || n.to - c.to);
+  const s = a.map(
+    (n) => n.from === n.to ? n.dec.range(n.from) : n.dec.range(n.from, n.to)
+  );
+  return I.set(s);
+}
+const M = {
+  drew: "#60a5fa",
+  // blue-400
+  alice: "#fbbf24",
+  // amber-400
+  sarah: "#a78bfa",
+  // violet-400
+  bob: "#34d399",
+  // emerald-400
+  charlie: "#f472b6"
+  // pink-400
+}, w = [
+  "#ef4444",
+  // red-500
+  "#10b981",
+  // emerald-500
+  "#8b5cf6",
+  // violet-500
+  "#ec4899",
+  // pink-500
+  "#14b8a6",
+  // teal-500
+  "#f59e0b"
+  // amber-500
+];
+function z(o) {
+  if (o in M) return M[o];
+  let t = 0;
+  for (let e = 0; e < o.length; e++)
+    t = t * 31 + o.charCodeAt(e) | 0;
+  return w[Math.abs(t) % w.length];
+}
+export {
+  st as ROOT_ID,
+  v as ROOT_PLACEHOLDER_SPAN,
+  tt as createBridgeExtension,
+  X as createIdMapField,
+  nt as createPresenceExtension,
+  S as ensureRootSpan,
+  Z as getPositionOfRun,
+  Y as getRunAtPosition,
+  x as isRemote,
+  et as mountEditorBridge,
+  b as setIdMapEffect
+};

package/package.json

@@ -1,6 +1,65 @@
 {
   "name": "@ebbjs/codemirror",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "private": false,
+  "description": "CodeMirror 6 bridge for @ebbjs/client's TextDocument — bidirectional sync between the causal-tree field and a CM6 editor view.",
+  "homepage": "https://ebbjs.com",
+  "bugs": {
+    "url": "https://github.com/ebbjs/ebbjs/issues"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ebbjs/ebbjs.git",
+    "directory": "packages/codemirror"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.txt"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@ebbjs/client": "^0.1.1"
+  },
+  "devDependencies": {
+    "@codemirror/state": "^6.5.2",
+    "@codemirror/view": "^6.36.8",
+    "codemirror": "^6.0.1",
+    "happy-dom": "^17.4.4",
+    "tsx": "^4.20.4",
+    "vitest": "^3.2.4",
+    "@ebbjs/core": "^0.1.1"
+  },
+  "peerDependencies": {
+    "@codemirror/state": "^6.5.0",
+    "@codemirror/view": "^6.30.0",
+    "codemirror": "^6.0.0"
+  },
+  "engines": {
+    "node": ">=22.8.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "test": "vitest --run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "pnpm --root ../../ lint",
+    "lint:fix": "pnpm --root ../../ lint:fix",
+    "fmt": "pnpm --root ../../ fmt",
+    "fmt:check": "pnpm --root ../../ fmt:check"
+  }
 }