@pm-cm/core 0.0.1

package/README.md

@@ -0,0 +1,87 @@
+# @pm-cm/core
+
+Bidirectional sync between ProseMirror and CodeMirror for split-editor UIs.
+
+Keeps a WYSIWYG pane (ProseMirror) and a text pane (CodeMirror) in sync. The serialization format is pluggable — you provide `serialize` and `parse` functions (e.g. Markdown, AsciiDoc, plain text).
+
+## Install
+
+```
+npm install @pm-cm/core prosemirror-model prosemirror-state prosemirror-view
+```
+
+## Usage
+
+### View Bridge
+
+Propagates changes between the ProseMirror pane and the CodeMirror pane.
+
+```ts
+import { createViewBridge } from '@pm-cm/core'
+
+const bridge = createViewBridge({
+  schema,     // ProseMirror Schema
+  serialize,  // (doc: Node) => string
+  parse,      // (text: string, schema: Schema) => Node
+})
+
+// CodeMirror changed → push into ProseMirror
+bridge.applyText(pmView, cmValue)
+
+// ProseMirror changed → pull for CodeMirror
+const text = bridge.extractText(pmView)
+
+// In dispatchTransaction, skip bridge-originated changes
+function dispatchTransaction(tr: Transaction) {
+  pmView.updateState(pmView.state.apply(tr))
+  if (!bridge.isBridgeChange(tr) && tr.docChanged) {
+    updateCodeMirror(bridge.extractText(pmView))
+  }
+}
+```
+
+### Cursor Mapping
+
+Maps cursor positions between ProseMirror and CodeMirror.
+
+```ts
+import { buildCursorMap, cursorMapLookup, reverseCursorMapLookup } from '@pm-cm/core'
+
+const map = buildCursorMap(pmDoc, serialize)
+
+// PM position → CM offset
+const cmOffset = cursorMapLookup(map, pmPos)
+
+// CM offset → PM position
+const pmPos = reverseCursorMapLookup(map, cmOffset)
+```
+
+#### Limitations
+
+- Uses `indexOf`-based forward matching: if the serializer transforms text (e.g. escaping, entity encoding), the mapping may be inaccurate.
+- Segments with no text nodes (e.g. empty paragraphs, horizontal rules) produce no mapping entry. Lookups return `null` only when the entire map has zero segments.
+- Positions that fall between segments (inside serialization syntax like `**`, `- `, `| `) snap to the nearest text boundary.
+
+## API
+
+| Export | Description |
+|---|---|
+| `createViewBridge(config)` | Returns a `ViewBridgeHandle` with `applyText`, `extractText`, `isBridgeChange` |
+| `createBoundViewBridge(view, config)` | Returns a `BoundViewBridgeHandle` — same as above but with the `EditorView` bound |
+| `buildCursorMap(doc, serialize, locate?)` | Build a PM position ↔ CM offset mapping |
+| `cursorMapLookup(map, pmPos)` | PM position → CM offset |
+| `reverseCursorMapLookup(map, cmOffset)` | CM (CodeMirror) offset → PM position |
+| `Serialize` | Type: `(doc: Node) => string` |
+| `Parse` | Type: `(text: string, schema: Schema) => Node` |
+| `Normalize` | Type: `(text: string) => string` |
+| `ErrorCode` | Type: `'parse-error' \| 'serialize-error'` |
+| `ErrorEvent` | Type: `{ code: ErrorCode, message: string, cause: unknown }` |
+| `OnError` | Type: `(event: ErrorEvent) => void` |
+| `LocateText` | Type: `(serialized: string, nodeText: string, searchFrom: number) => number` |
+| `ViewBridgeConfig` | `{ schema, serialize, parse, normalize?, onError? }` |
+| `ViewBridgeHandle` | `{ applyText(view, text, options?): ApplyTextResult, extractText(view), isBridgeChange(tr) }` |
+| `BoundViewBridgeHandle` | `{ applyText(text, options?), extractText(), isBridgeChange(tr), setView(view) }` |
+| `ApplyTextOptions` | `{ addToHistory?: boolean }` |
+| `ApplyTextResult` | `{ ok: true } \| { ok: false; reason: 'unchanged' \| 'parse-error' }` |
+| `CursorMap` | `{ segments: TextSegment[], textLength, skippedNodes }` |
+| `TextSegment` | `{ pmStart, pmEnd, textStart, textEnd }` |

package/dist/index.cjs

@@ -0,0 +1,180 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  buildCursorMap: () => buildCursorMap,
+  createBoundViewBridge: () => createBoundViewBridge,
+  createViewBridge: () => createViewBridge,
+  cursorMapLookup: () => cursorMapLookup,
+  reverseCursorMapLookup: () => reverseCursorMapLookup
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/bridge.ts
+var BRIDGE_META = "pm-cm-bridge";
+var defaultNormalize = (s) => s.replace(/\r\n?/g, "\n");
+var defaultOnError = (event) => console.error(`[bridge] ${event.code}: ${event.message}`, event.cause);
+function createViewBridge(config) {
+  const { schema, serialize, parse } = config;
+  const normalize = config.normalize ?? defaultNormalize;
+  const onError = config.onError ?? defaultOnError;
+  return {
+    applyText(view, text, options) {
+      const incoming = normalize(text);
+      const current = normalize(serialize(view.state.doc));
+      if (incoming === current) {
+        return { ok: false, reason: "unchanged" };
+      }
+      let nextDoc;
+      try {
+        nextDoc = parse(incoming, schema);
+      } catch (error) {
+        onError({ code: "parse-error", message: "failed to parse text into ProseMirror document", cause: error });
+        return { ok: false, reason: "parse-error" };
+      }
+      const tr = view.state.tr;
+      tr.replaceWith(0, tr.doc.content.size, nextDoc.content);
+      tr.setMeta(BRIDGE_META, true);
+      if (options?.addToHistory === false) {
+        tr.setMeta("addToHistory", false);
+      }
+      view.dispatch(tr);
+      return { ok: true };
+    },
+    extractText(view) {
+      return serialize(view.state.doc);
+    },
+    isBridgeChange(tr) {
+      return tr.getMeta(BRIDGE_META) === true;
+    }
+  };
+}
+function createBoundViewBridge(view, config) {
+  const inner = createViewBridge(config);
+  let currentView = view;
+  return {
+    applyText(text, options) {
+      return inner.applyText(currentView, text, options);
+    },
+    extractText() {
+      return inner.extractText(currentView);
+    },
+    isBridgeChange(tr) {
+      return inner.isBridgeChange(tr);
+    },
+    setView(v) {
+      currentView = v;
+    }
+  };
+}
+
+// src/cursor-map.ts
+var defaultLocate = (serialized, nodeText, from) => serialized.indexOf(nodeText, from);
+function buildCursorMap(doc, serialize, locate = defaultLocate) {
+  const fullText = serialize(doc);
+  const segments = [];
+  let searchFrom = 0;
+  let skippedNodes = 0;
+  function walkChildren(node, contentStart) {
+    node.forEach((child, offset) => {
+      const childPos = contentStart + offset;
+      if (child.isText && child.text) {
+        const text = child.text;
+        const idx = locate(fullText, text, searchFrom);
+        if (idx >= 0) {
+          segments.push({
+            pmStart: childPos,
+            pmEnd: childPos + text.length,
+            textStart: idx,
+            textEnd: idx + text.length
+          });
+          searchFrom = idx + text.length;
+        } else {
+          skippedNodes++;
+        }
+        return;
+      }
+      if (child.isLeaf) {
+        return;
+      }
+      walkChildren(child, childPos + 1);
+    });
+  }
+  walkChildren(doc, 0);
+  return { segments, textLength: fullText.length, skippedNodes };
+}
+function cursorMapLookup(map, pmPos) {
+  const { segments } = map;
+  if (segments.length === 0) return null;
+  let lo = 0;
+  let hi = segments.length - 1;
+  while (lo <= hi) {
+    const mid = lo + hi >>> 1;
+    const seg = segments[mid];
+    if (pmPos < seg.pmStart) {
+      hi = mid - 1;
+    } else if (pmPos >= seg.pmEnd) {
+      lo = mid + 1;
+    } else {
+      return seg.textStart + (pmPos - seg.pmStart);
+    }
+  }
+  const before = hi >= 0 ? segments[hi] : null;
+  const after = lo < segments.length ? segments[lo] : null;
+  if (!before) return after ? after.textStart : 0;
+  if (!after) return before.textEnd;
+  const distBefore = pmPos - before.pmEnd;
+  const distAfter = after.pmStart - pmPos;
+  return distBefore <= distAfter ? before.textEnd : after.textStart;
+}
+function reverseCursorMapLookup(map, cmOffset) {
+  const { segments } = map;
+  if (segments.length === 0) return null;
+  let lo = 0;
+  let hi = segments.length - 1;
+  while (lo <= hi) {
+    const mid = lo + hi >>> 1;
+    const seg = segments[mid];
+    if (cmOffset < seg.textStart) {
+      hi = mid - 1;
+    } else if (cmOffset >= seg.textEnd) {
+      lo = mid + 1;
+    } else {
+      return seg.pmStart + (cmOffset - seg.textStart);
+    }
+  }
+  const before = hi >= 0 ? segments[hi] : null;
+  const after = lo < segments.length ? segments[lo] : null;
+  if (!before) return after ? after.pmStart : 0;
+  if (!after) return before.pmEnd;
+  const distBefore = cmOffset - before.textEnd;
+  const distAfter = after.textStart - cmOffset;
+  return distBefore <= distAfter ? before.pmEnd : after.pmStart;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildCursorMap,
+  createBoundViewBridge,
+  createViewBridge,
+  cursorMapLookup,
+  reverseCursorMapLookup
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/bridge.ts","../src/cursor-map.ts"],"sourcesContent":["export { createViewBridge, createBoundViewBridge } from './bridge.js'\nexport type { ViewBridgeConfig, ViewBridgeHandle, BoundViewBridgeHandle, ApplyTextOptions, ApplyTextResult } from './bridge.js'\nexport type { Serialize, Parse, Normalize, OnError, ErrorCode, ErrorEvent } from './types.js'\nexport { buildCursorMap, cursorMapLookup, reverseCursorMapLookup } from './cursor-map.js'\nexport type { TextSegment, CursorMap, LocateText } from './cursor-map.js'\n","import type { Node, Schema } from 'prosemirror-model'\nimport type { Transaction } from 'prosemirror-state'\nimport type { EditorView } from 'prosemirror-view'\nimport type { Normalize, Serialize, Parse, OnError } from './types.js'\n\nconst BRIDGE_META = 'pm-cm-bridge'\nconst defaultNormalize: Normalize = (s) => s.replace(/\\r\\n?/g, '\\n')\nconst defaultOnError: OnError = (event) => console.error(`[bridge] ${event.code}: ${event.message}`, event.cause)\n\n/** Configuration for {@link createViewBridge}. */\nexport type ViewBridgeConfig = {\n  schema: Schema\n  serialize: Serialize\n  parse: Parse\n  normalize?: Normalize\n  /** Called on non-fatal errors (e.g. parse failures). Defaults to `console.error`. */\n  onError?: OnError\n}\n\n/** Options for {@link ViewBridgeHandle.applyText}. */\nexport type ApplyTextOptions = {\n  /** Set `false` to prevent the change from being added to undo history. Default `true`. */\n  addToHistory?: boolean\n}\n\n/**\n * Discriminated-union result of {@link ViewBridgeHandle.applyText}.\n * `ok: true` when the text was applied; `ok: false` with a `reason` otherwise.\n */\nexport type ApplyTextResult =\n  | { ok: true }\n  | { ok: false; reason: 'unchanged' | 'parse-error' }\n\n/** Handle returned by {@link createViewBridge}. */\nexport type ViewBridgeHandle = {\n  /** Parse `text` and replace the ProseMirror document. Returns an {@link ApplyTextResult}. */\n  applyText(view: EditorView, text: string, options?: ApplyTextOptions): ApplyTextResult\n  /** Serialize the current ProseMirror document to text. */\n  extractText(view: EditorView): string\n  /** Returns `true` if the transaction was dispatched by {@link applyText}. */\n  isBridgeChange(tr: Transaction): boolean\n}\n\n/** Handle returned by {@link createBoundViewBridge}. View is bound; no need to pass it each call. */\nexport type BoundViewBridgeHandle = {\n  /** Parse `text` and replace the ProseMirror document. */\n  applyText(text: string, options?: ApplyTextOptions): ApplyTextResult\n  /** Serialize the current ProseMirror document to text. */\n  extractText(): string\n  /** Returns `true` if the transaction was dispatched by {@link applyText}. */\n  isBridgeChange(tr: Transaction): boolean\n  /** Replace the bound EditorView. */\n  setView(view: EditorView): void\n}\n\n/**\n * Create a document-sync bridge between ProseMirror and a text editor.\n *\n * Returns a {@link ViewBridgeHandle} with methods to push/pull text and\n * detect bridge-originated transactions.\n */\nexport function createViewBridge(config: ViewBridgeConfig): ViewBridgeHandle {\n  const { schema, serialize, parse } = config\n  const normalize = config.normalize ?? defaultNormalize\n  const onError = config.onError ?? defaultOnError\n\n  return {\n    applyText(view: EditorView, text: string, options?: ApplyTextOptions): ApplyTextResult {\n      const incoming = normalize(text)\n      const current = normalize(serialize(view.state.doc))\n\n      if (incoming === current) {\n        return { ok: false, reason: 'unchanged' }\n      }\n\n      let nextDoc: Node\n      try {\n        nextDoc = parse(incoming, schema)\n      } catch (error) {\n        onError({ code: 'parse-error', message: 'failed to parse text into ProseMirror document', cause: error })\n        return { ok: false, reason: 'parse-error' }\n      }\n\n      const tr = view.state.tr\n      tr.replaceWith(0, tr.doc.content.size, nextDoc.content)\n      tr.setMeta(BRIDGE_META, true)\n      if (options?.addToHistory === false) {\n        tr.setMeta('addToHistory', false)\n      }\n      view.dispatch(tr)\n      return { ok: true }\n    },\n\n    extractText(view: EditorView): string {\n      return serialize(view.state.doc)\n    },\n\n    isBridgeChange(tr: Transaction): boolean {\n      return tr.getMeta(BRIDGE_META) === true\n    },\n  }\n}\n\n/**\n * Create a view-bound document-sync bridge. Wraps {@link createViewBridge}\n * so that the `EditorView` does not need to be passed to each method call.\n *\n * @param view - The initial EditorView to bind.\n * @param config - Configuration for the underlying bridge.\n */\nexport function createBoundViewBridge(view: EditorView, config: ViewBridgeConfig): BoundViewBridgeHandle {\n  const inner = createViewBridge(config)\n  let currentView = view\n\n  return {\n    applyText(text: string, options?: ApplyTextOptions): ApplyTextResult {\n      return inner.applyText(currentView, text, options)\n    },\n    extractText(): string {\n      return inner.extractText(currentView)\n    },\n    isBridgeChange(tr: Transaction): boolean {\n      return inner.isBridgeChange(tr)\n    },\n    setView(v: EditorView): void {\n      currentView = v\n    },\n  }\n}\n","import type { Node } from 'prosemirror-model'\nimport type { Serialize } from './types.js'\n\n/** A mapping between a ProseMirror position range and a serialized-text offset range. */\nexport type TextSegment = {\n  pmStart: number   // PM position (inclusive)\n  pmEnd: number     // PM position (exclusive)\n  textStart: number // serialized text offset (inclusive)\n  textEnd: number   // serialized text offset (exclusive)\n}\n\n/**\n * Sorted list of {@link TextSegment}s produced by {@link buildCursorMap}.\n * Use {@link cursorMapLookup} and {@link reverseCursorMapLookup} for O(log n) queries.\n */\nexport type CursorMap = {\n  segments: TextSegment[]\n  textLength: number\n  /** Number of text nodes that could not be located in the serialized output. */\n  skippedNodes: number\n}\n\n/**\n * Locate a text-node string within the serialized output.\n * Return the starting index, or -1 if not found.\n * Default: `(serialized, nodeText, from) => serialized.indexOf(nodeText, from)`\n */\nexport type LocateText = (serialized: string, nodeText: string, searchFrom: number) => number\n\nconst defaultLocate: LocateText = (serialized, nodeText, from) =>\n  serialized.indexOf(nodeText, from)\n\n/**\n * Build a cursor map that aligns ProseMirror positions with serialized-text offsets.\n *\n * Walks the document tree and locates each text node within the serialized output,\n * producing a sorted list of {@link TextSegment}s.\n *\n * @param doc - The ProseMirror document to map.\n * @param serialize - Serializer used to produce the full text.\n * @param locate - Optional custom text-location function. Defaults to `indexOf`.\n */\nexport function buildCursorMap(\n  doc: Node,\n  serialize: Serialize,\n  locate: LocateText = defaultLocate,\n): CursorMap {\n  const fullText = serialize(doc)\n  const segments: TextSegment[] = []\n  let searchFrom = 0\n  let skippedNodes = 0\n\n  function walkChildren(node: Node, contentStart: number): void {\n    node.forEach((child, offset) => {\n      const childPos = contentStart + offset\n\n      if (child.isText && child.text) {\n        const text = child.text\n        const idx = locate(fullText, text, searchFrom)\n        if (idx >= 0) {\n          segments.push({\n            pmStart: childPos,\n            pmEnd: childPos + text.length,\n            textStart: idx,\n            textEnd: idx + text.length,\n          })\n          searchFrom = idx + text.length\n        } else {\n          skippedNodes++\n        }\n        return\n      }\n\n      if (child.isLeaf) {\n        return\n      }\n\n      // Container node: content starts at childPos + 1 (open tag)\n      walkChildren(child, childPos + 1)\n    })\n  }\n\n  // doc's content starts at position 0\n  walkChildren(doc, 0)\n\n  return { segments, textLength: fullText.length, skippedNodes }\n}\n\n/**\n * Look up a ProseMirror position in a cursor map and return the corresponding text offset.\n * Returns `null` when the map has no segments.\n */\nexport function cursorMapLookup(map: CursorMap, pmPos: number): number | null {\n  const { segments } = map\n  if (segments.length === 0) return null\n\n  // Binary search for the segment containing pmPos\n  let lo = 0\n  let hi = segments.length - 1\n\n  while (lo <= hi) {\n    const mid = (lo + hi) >>> 1\n    const seg = segments[mid]\n\n    if (pmPos < seg.pmStart) {\n      hi = mid - 1\n    } else if (pmPos >= seg.pmEnd) {\n      lo = mid + 1\n    } else {\n      // Inside segment: exact mapping\n      return seg.textStart + (pmPos - seg.pmStart)\n    }\n  }\n\n  // pmPos is between segments — snap to nearest boundary\n  // After binary search: hi < lo, pmPos falls between segments[hi] and segments[lo]\n  const before = hi >= 0 ? segments[hi] : null\n  const after = lo < segments.length ? segments[lo] : null\n\n  if (!before) return after ? after.textStart : 0\n  if (!after) return before.textEnd\n\n  const distBefore = pmPos - before.pmEnd\n  const distAfter = after.pmStart - pmPos\n  return distBefore <= distAfter ? before.textEnd : after.textStart\n}\n\n/**\n * Look up a text offset (e.g. CodeMirror position) in a cursor map and return the corresponding ProseMirror position.\n * Returns `null` when the map has no segments.\n */\nexport function reverseCursorMapLookup(map: CursorMap, cmOffset: number): number | null {\n  const { segments } = map\n  if (segments.length === 0) return null\n\n  // Binary search for the segment containing cmOffset\n  let lo = 0\n  let hi = segments.length - 1\n\n  while (lo <= hi) {\n    const mid = (lo + hi) >>> 1\n    const seg = segments[mid]\n\n    if (cmOffset < seg.textStart) {\n      hi = mid - 1\n    } else if (cmOffset >= seg.textEnd) {\n      lo = mid + 1\n    } else {\n      // Inside segment: exact mapping\n      return seg.pmStart + (cmOffset - seg.textStart)\n    }\n  }\n\n  // cmOffset is between segments — snap to nearest boundary\n  const before = hi >= 0 ? segments[hi] : null\n  const after = lo < segments.length ? segments[lo] : null\n\n  if (!before) return after ? after.pmStart : 0\n  if (!after) return before.pmEnd\n\n  const distBefore = cmOffset - before.textEnd\n  const distAfter = after.textStart - cmOffset\n  return distBefore <= distAfter ? before.pmEnd : after.pmStart\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,133 @@
+import { Schema, Node } from 'prosemirror-model';
+import { Transaction } from 'prosemirror-state';
+import { EditorView } from 'prosemirror-view';
+
+/** Converts a ProseMirror document to a serialized text string. */
+type Serialize = (doc: Node) => string;
+/** Parses a serialized text string into a ProseMirror document. */
+type Parse = (text: string, schema: Schema) => Node;
+/** Normalizes a text string (e.g. line endings). Default strips `\r`. */
+type Normalize = (text: string) => string;
+/** Known error codes emitted by the bridge. */
+type ErrorCode = 'parse-error' | 'serialize-error';
+/** Structured error event for non-fatal errors (e.g. parse failures). */
+type ErrorEvent = {
+    code: ErrorCode;
+    message: string;
+    cause: unknown;
+};
+/**
+ * Error handler callback for non-fatal errors (e.g. parse failures).
+ *
+ * Known codes:
+ * - `'parse-error'` — failed to parse text into a ProseMirror document.
+ * - `'serialize-error'` — failed to serialize a ProseMirror document to text.
+ */
+type OnError = (event: ErrorEvent) => void;
+
+/** Configuration for {@link createViewBridge}. */
+type ViewBridgeConfig = {
+    schema: Schema;
+    serialize: Serialize;
+    parse: Parse;
+    normalize?: Normalize;
+    /** Called on non-fatal errors (e.g. parse failures). Defaults to `console.error`. */
+    onError?: OnError;
+};
+/** Options for {@link ViewBridgeHandle.applyText}. */
+type ApplyTextOptions = {
+    /** Set `false` to prevent the change from being added to undo history. Default `true`. */
+    addToHistory?: boolean;
+};
+/**
+ * Discriminated-union result of {@link ViewBridgeHandle.applyText}.
+ * `ok: true` when the text was applied; `ok: false` with a `reason` otherwise.
+ */
+type ApplyTextResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: 'unchanged' | 'parse-error';
+};
+/** Handle returned by {@link createViewBridge}. */
+type ViewBridgeHandle = {
+    /** Parse `text` and replace the ProseMirror document. Returns an {@link ApplyTextResult}. */
+    applyText(view: EditorView, text: string, options?: ApplyTextOptions): ApplyTextResult;
+    /** Serialize the current ProseMirror document to text. */
+    extractText(view: EditorView): string;
+    /** Returns `true` if the transaction was dispatched by {@link applyText}. */
+    isBridgeChange(tr: Transaction): boolean;
+};
+/** Handle returned by {@link createBoundViewBridge}. View is bound; no need to pass it each call. */
+type BoundViewBridgeHandle = {
+    /** Parse `text` and replace the ProseMirror document. */
+    applyText(text: string, options?: ApplyTextOptions): ApplyTextResult;
+    /** Serialize the current ProseMirror document to text. */
+    extractText(): string;
+    /** Returns `true` if the transaction was dispatched by {@link applyText}. */
+    isBridgeChange(tr: Transaction): boolean;
+    /** Replace the bound EditorView. */
+    setView(view: EditorView): void;
+};
+/**
+ * Create a document-sync bridge between ProseMirror and a text editor.
+ *
+ * Returns a {@link ViewBridgeHandle} with methods to push/pull text and
+ * detect bridge-originated transactions.
+ */
+declare function createViewBridge(config: ViewBridgeConfig): ViewBridgeHandle;
+/**
+ * Create a view-bound document-sync bridge. Wraps {@link createViewBridge}
+ * so that the `EditorView` does not need to be passed to each method call.
+ *
+ * @param view - The initial EditorView to bind.
+ * @param config - Configuration for the underlying bridge.
+ */
+declare function createBoundViewBridge(view: EditorView, config: ViewBridgeConfig): BoundViewBridgeHandle;
+
+/** A mapping between a ProseMirror position range and a serialized-text offset range. */
+type TextSegment = {
+    pmStart: number;
+    pmEnd: number;
+    textStart: number;
+    textEnd: number;
+};
+/**
+ * Sorted list of {@link TextSegment}s produced by {@link buildCursorMap}.
+ * Use {@link cursorMapLookup} and {@link reverseCursorMapLookup} for O(log n) queries.
+ */
+type CursorMap = {
+    segments: TextSegment[];
+    textLength: number;
+    /** Number of text nodes that could not be located in the serialized output. */
+    skippedNodes: number;
+};
+/**
+ * Locate a text-node string within the serialized output.
+ * Return the starting index, or -1 if not found.
+ * Default: `(serialized, nodeText, from) => serialized.indexOf(nodeText, from)`
+ */
+type LocateText = (serialized: string, nodeText: string, searchFrom: number) => number;
+/**
+ * Build a cursor map that aligns ProseMirror positions with serialized-text offsets.
+ *
+ * Walks the document tree and locates each text node within the serialized output,
+ * producing a sorted list of {@link TextSegment}s.
+ *
+ * @param doc - The ProseMirror document to map.
+ * @param serialize - Serializer used to produce the full text.
+ * @param locate - Optional custom text-location function. Defaults to `indexOf`.
+ */
+declare function buildCursorMap(doc: Node, serialize: Serialize, locate?: LocateText): CursorMap;
+/**
+ * Look up a ProseMirror position in a cursor map and return the corresponding text offset.
+ * Returns `null` when the map has no segments.
+ */
+declare function cursorMapLookup(map: CursorMap, pmPos: number): number | null;
+/**
+ * Look up a text offset (e.g. CodeMirror position) in a cursor map and return the corresponding ProseMirror position.
+ * Returns `null` when the map has no segments.
+ */
+declare function reverseCursorMapLookup(map: CursorMap, cmOffset: number): number | null;
+
+export { type ApplyTextOptions, type ApplyTextResult, type BoundViewBridgeHandle, type CursorMap, type ErrorCode, type ErrorEvent, type LocateText, type Normalize, type OnError, type Parse, type Serialize, type TextSegment, type ViewBridgeConfig, type ViewBridgeHandle, buildCursorMap, createBoundViewBridge, createViewBridge, cursorMapLookup, reverseCursorMapLookup };

package/dist/index.d.ts

@@ -0,0 +1,133 @@
+import { Schema, Node } from 'prosemirror-model';
+import { Transaction } from 'prosemirror-state';
+import { EditorView } from 'prosemirror-view';
+
+/** Converts a ProseMirror document to a serialized text string. */
+type Serialize = (doc: Node) => string;
+/** Parses a serialized text string into a ProseMirror document. */
+type Parse = (text: string, schema: Schema) => Node;
+/** Normalizes a text string (e.g. line endings). Default strips `\r`. */
+type Normalize = (text: string) => string;
+/** Known error codes emitted by the bridge. */
+type ErrorCode = 'parse-error' | 'serialize-error';
+/** Structured error event for non-fatal errors (e.g. parse failures). */
+type ErrorEvent = {
+    code: ErrorCode;
+    message: string;
+    cause: unknown;
+};
+/**
+ * Error handler callback for non-fatal errors (e.g. parse failures).
+ *
+ * Known codes:
+ * - `'parse-error'` — failed to parse text into a ProseMirror document.
+ * - `'serialize-error'` — failed to serialize a ProseMirror document to text.
+ */
+type OnError = (event: ErrorEvent) => void;
+
+/** Configuration for {@link createViewBridge}. */
+type ViewBridgeConfig = {
+    schema: Schema;
+    serialize: Serialize;
+    parse: Parse;
+    normalize?: Normalize;
+    /** Called on non-fatal errors (e.g. parse failures). Defaults to `console.error`. */
+    onError?: OnError;
+};
+/** Options for {@link ViewBridgeHandle.applyText}. */
+type ApplyTextOptions = {
+    /** Set `false` to prevent the change from being added to undo history. Default `true`. */
+    addToHistory?: boolean;
+};
+/**
+ * Discriminated-union result of {@link ViewBridgeHandle.applyText}.
+ * `ok: true` when the text was applied; `ok: false` with a `reason` otherwise.
+ */
+type ApplyTextResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: 'unchanged' | 'parse-error';
+};
+/** Handle returned by {@link createViewBridge}. */
+type ViewBridgeHandle = {
+    /** Parse `text` and replace the ProseMirror document. Returns an {@link ApplyTextResult}. */
+    applyText(view: EditorView, text: string, options?: ApplyTextOptions): ApplyTextResult;
+    /** Serialize the current ProseMirror document to text. */
+    extractText(view: EditorView): string;
+    /** Returns `true` if the transaction was dispatched by {@link applyText}. */
+    isBridgeChange(tr: Transaction): boolean;
+};
+/** Handle returned by {@link createBoundViewBridge}. View is bound; no need to pass it each call. */
+type BoundViewBridgeHandle = {
+    /** Parse `text` and replace the ProseMirror document. */
+    applyText(text: string, options?: ApplyTextOptions): ApplyTextResult;
+    /** Serialize the current ProseMirror document to text. */
+    extractText(): string;
+    /** Returns `true` if the transaction was dispatched by {@link applyText}. */
+    isBridgeChange(tr: Transaction): boolean;
+    /** Replace the bound EditorView. */
+    setView(view: EditorView): void;
+};
+/**
+ * Create a document-sync bridge between ProseMirror and a text editor.
+ *
+ * Returns a {@link ViewBridgeHandle} with methods to push/pull text and
+ * detect bridge-originated transactions.
+ */
+declare function createViewBridge(config: ViewBridgeConfig): ViewBridgeHandle;
+/**
+ * Create a view-bound document-sync bridge. Wraps {@link createViewBridge}
+ * so that the `EditorView` does not need to be passed to each method call.
+ *
+ * @param view - The initial EditorView to bind.
+ * @param config - Configuration for the underlying bridge.
+ */
+declare function createBoundViewBridge(view: EditorView, config: ViewBridgeConfig): BoundViewBridgeHandle;
+
+/** A mapping between a ProseMirror position range and a serialized-text offset range. */
+type TextSegment = {
+    pmStart: number;
+    pmEnd: number;
+    textStart: number;
+    textEnd: number;
+};
+/**
+ * Sorted list of {@link TextSegment}s produced by {@link buildCursorMap}.
+ * Use {@link cursorMapLookup} and {@link reverseCursorMapLookup} for O(log n) queries.
+ */
+type CursorMap = {
+    segments: TextSegment[];
+    textLength: number;
+    /** Number of text nodes that could not be located in the serialized output. */
+    skippedNodes: number;
+};
+/**
+ * Locate a text-node string within the serialized output.
+ * Return the starting index, or -1 if not found.
+ * Default: `(serialized, nodeText, from) => serialized.indexOf(nodeText, from)`
+ */
+type LocateText = (serialized: string, nodeText: string, searchFrom: number) => number;
+/**
+ * Build a cursor map that aligns ProseMirror positions with serialized-text offsets.
+ *
+ * Walks the document tree and locates each text node within the serialized output,
+ * producing a sorted list of {@link TextSegment}s.
+ *
+ * @param doc - The ProseMirror document to map.
+ * @param serialize - Serializer used to produce the full text.
+ * @param locate - Optional custom text-location function. Defaults to `indexOf`.
+ */
+declare function buildCursorMap(doc: Node, serialize: Serialize, locate?: LocateText): CursorMap;
+/**
+ * Look up a ProseMirror position in a cursor map and return the corresponding text offset.
+ * Returns `null` when the map has no segments.
+ */
+declare function cursorMapLookup(map: CursorMap, pmPos: number): number | null;
+/**
+ * Look up a text offset (e.g. CodeMirror position) in a cursor map and return the corresponding ProseMirror position.
+ * Returns `null` when the map has no segments.
+ */
+declare function reverseCursorMapLookup(map: CursorMap, cmOffset: number): number | null;
+
+export { type ApplyTextOptions, type ApplyTextResult, type BoundViewBridgeHandle, type CursorMap, type ErrorCode, type ErrorEvent, type LocateText, type Normalize, type OnError, type Parse, type Serialize, type TextSegment, type ViewBridgeConfig, type ViewBridgeHandle, buildCursorMap, createBoundViewBridge, createViewBridge, cursorMapLookup, reverseCursorMapLookup };

package/dist/index.js

@@ -0,0 +1,149 @@
+// src/bridge.ts
+var BRIDGE_META = "pm-cm-bridge";
+var defaultNormalize = (s) => s.replace(/\r\n?/g, "\n");
+var defaultOnError = (event) => console.error(`[bridge] ${event.code}: ${event.message}`, event.cause);
+function createViewBridge(config) {
+  const { schema, serialize, parse } = config;
+  const normalize = config.normalize ?? defaultNormalize;
+  const onError = config.onError ?? defaultOnError;
+  return {
+    applyText(view, text, options) {
+      const incoming = normalize(text);
+      const current = normalize(serialize(view.state.doc));
+      if (incoming === current) {
+        return { ok: false, reason: "unchanged" };
+      }
+      let nextDoc;
+      try {
+        nextDoc = parse(incoming, schema);
+      } catch (error) {
+        onError({ code: "parse-error", message: "failed to parse text into ProseMirror document", cause: error });
+        return { ok: false, reason: "parse-error" };
+      }
+      const tr = view.state.tr;
+      tr.replaceWith(0, tr.doc.content.size, nextDoc.content);
+      tr.setMeta(BRIDGE_META, true);
+      if (options?.addToHistory === false) {
+        tr.setMeta("addToHistory", false);
+      }
+      view.dispatch(tr);
+      return { ok: true };
+    },
+    extractText(view) {
+      return serialize(view.state.doc);
+    },
+    isBridgeChange(tr) {
+      return tr.getMeta(BRIDGE_META) === true;
+    }
+  };
+}
+function createBoundViewBridge(view, config) {
+  const inner = createViewBridge(config);
+  let currentView = view;
+  return {
+    applyText(text, options) {
+      return inner.applyText(currentView, text, options);
+    },
+    extractText() {
+      return inner.extractText(currentView);
+    },
+    isBridgeChange(tr) {
+      return inner.isBridgeChange(tr);
+    },
+    setView(v) {
+      currentView = v;
+    }
+  };
+}
+
+// src/cursor-map.ts
+var defaultLocate = (serialized, nodeText, from) => serialized.indexOf(nodeText, from);
+function buildCursorMap(doc, serialize, locate = defaultLocate) {
+  const fullText = serialize(doc);
+  const segments = [];
+  let searchFrom = 0;
+  let skippedNodes = 0;
+  function walkChildren(node, contentStart) {
+    node.forEach((child, offset) => {
+      const childPos = contentStart + offset;
+      if (child.isText && child.text) {
+        const text = child.text;
+        const idx = locate(fullText, text, searchFrom);
+        if (idx >= 0) {
+          segments.push({
+            pmStart: childPos,
+            pmEnd: childPos + text.length,
+            textStart: idx,
+            textEnd: idx + text.length
+          });
+          searchFrom = idx + text.length;
+        } else {
+          skippedNodes++;
+        }
+        return;
+      }
+      if (child.isLeaf) {
+        return;
+      }
+      walkChildren(child, childPos + 1);
+    });
+  }
+  walkChildren(doc, 0);
+  return { segments, textLength: fullText.length, skippedNodes };
+}
+function cursorMapLookup(map, pmPos) {
+  const { segments } = map;
+  if (segments.length === 0) return null;
+  let lo = 0;
+  let hi = segments.length - 1;
+  while (lo <= hi) {
+    const mid = lo + hi >>> 1;
+    const seg = segments[mid];
+    if (pmPos < seg.pmStart) {
+      hi = mid - 1;
+    } else if (pmPos >= seg.pmEnd) {
+      lo = mid + 1;
+    } else {
+      return seg.textStart + (pmPos - seg.pmStart);
+    }
+  }
+  const before = hi >= 0 ? segments[hi] : null;
+  const after = lo < segments.length ? segments[lo] : null;
+  if (!before) return after ? after.textStart : 0;
+  if (!after) return before.textEnd;
+  const distBefore = pmPos - before.pmEnd;
+  const distAfter = after.pmStart - pmPos;
+  return distBefore <= distAfter ? before.textEnd : after.textStart;
+}
+function reverseCursorMapLookup(map, cmOffset) {
+  const { segments } = map;
+  if (segments.length === 0) return null;
+  let lo = 0;
+  let hi = segments.length - 1;
+  while (lo <= hi) {
+    const mid = lo + hi >>> 1;
+    const seg = segments[mid];
+    if (cmOffset < seg.textStart) {
+      hi = mid - 1;
+    } else if (cmOffset >= seg.textEnd) {
+      lo = mid + 1;
+    } else {
+      return seg.pmStart + (cmOffset - seg.textStart);
+    }
+  }
+  const before = hi >= 0 ? segments[hi] : null;
+  const after = lo < segments.length ? segments[lo] : null;
+  if (!before) return after ? after.pmStart : 0;
+  if (!after) return before.pmEnd;
+  const distBefore = cmOffset - before.textEnd;
+  const distAfter = after.textStart - cmOffset;
+  return distBefore <= distAfter ? before.pmEnd : after.pmStart;
+}
+export {
+  buildCursorMap,
+  createBoundViewBridge,
+  createViewBridge,
+  cursorMapLookup,
+  reverseCursorMapLookup
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridge.ts","../src/cursor-map.ts"],"sourcesContent":["import type { Node, Schema } from 'prosemirror-model'\nimport type { Transaction } from 'prosemirror-state'\nimport type { EditorView } from 'prosemirror-view'\nimport type { Normalize, Serialize, Parse, OnError } from './types.js'\n\nconst BRIDGE_META = 'pm-cm-bridge'\nconst defaultNormalize: Normalize = (s) => s.replace(/\\r\\n?/g, '\\n')\nconst defaultOnError: OnError = (event) => console.error(`[bridge] ${event.code}: ${event.message}`, event.cause)\n\n/** Configuration for {@link createViewBridge}. */\nexport type ViewBridgeConfig = {\n  schema: Schema\n  serialize: Serialize\n  parse: Parse\n  normalize?: Normalize\n  /** Called on non-fatal errors (e.g. parse failures). Defaults to `console.error`. */\n  onError?: OnError\n}\n\n/** Options for {@link ViewBridgeHandle.applyText}. */\nexport type ApplyTextOptions = {\n  /** Set `false` to prevent the change from being added to undo history. Default `true`. */\n  addToHistory?: boolean\n}\n\n/**\n * Discriminated-union result of {@link ViewBridgeHandle.applyText}.\n * `ok: true` when the text was applied; `ok: false` with a `reason` otherwise.\n */\nexport type ApplyTextResult =\n  | { ok: true }\n  | { ok: false; reason: 'unchanged' | 'parse-error' }\n\n/** Handle returned by {@link createViewBridge}. */\nexport type ViewBridgeHandle = {\n  /** Parse `text` and replace the ProseMirror document. Returns an {@link ApplyTextResult}. */\n  applyText(view: EditorView, text: string, options?: ApplyTextOptions): ApplyTextResult\n  /** Serialize the current ProseMirror document to text. */\n  extractText(view: EditorView): string\n  /** Returns `true` if the transaction was dispatched by {@link applyText}. */\n  isBridgeChange(tr: Transaction): boolean\n}\n\n/** Handle returned by {@link createBoundViewBridge}. View is bound; no need to pass it each call. */\nexport type BoundViewBridgeHandle = {\n  /** Parse `text` and replace the ProseMirror document. */\n  applyText(text: string, options?: ApplyTextOptions): ApplyTextResult\n  /** Serialize the current ProseMirror document to text. */\n  extractText(): string\n  /** Returns `true` if the transaction was dispatched by {@link applyText}. */\n  isBridgeChange(tr: Transaction): boolean\n  /** Replace the bound EditorView. */\n  setView(view: EditorView): void\n}\n\n/**\n * Create a document-sync bridge between ProseMirror and a text editor.\n *\n * Returns a {@link ViewBridgeHandle} with methods to push/pull text and\n * detect bridge-originated transactions.\n */\nexport function createViewBridge(config: ViewBridgeConfig): ViewBridgeHandle {\n  const { schema, serialize, parse } = config\n  const normalize = config.normalize ?? defaultNormalize\n  const onError = config.onError ?? defaultOnError\n\n  return {\n    applyText(view: EditorView, text: string, options?: ApplyTextOptions): ApplyTextResult {\n      const incoming = normalize(text)\n      const current = normalize(serialize(view.state.doc))\n\n      if (incoming === current) {\n        return { ok: false, reason: 'unchanged' }\n      }\n\n      let nextDoc: Node\n      try {\n        nextDoc = parse(incoming, schema)\n      } catch (error) {\n        onError({ code: 'parse-error', message: 'failed to parse text into ProseMirror document', cause: error })\n        return { ok: false, reason: 'parse-error' }\n      }\n\n      const tr = view.state.tr\n      tr.replaceWith(0, tr.doc.content.size, nextDoc.content)\n      tr.setMeta(BRIDGE_META, true)\n      if (options?.addToHistory === false) {\n        tr.setMeta('addToHistory', false)\n      }\n      view.dispatch(tr)\n      return { ok: true }\n    },\n\n    extractText(view: EditorView): string {\n      return serialize(view.state.doc)\n    },\n\n    isBridgeChange(tr: Transaction): boolean {\n      return tr.getMeta(BRIDGE_META) === true\n    },\n  }\n}\n\n/**\n * Create a view-bound document-sync bridge. Wraps {@link createViewBridge}\n * so that the `EditorView` does not need to be passed to each method call.\n *\n * @param view - The initial EditorView to bind.\n * @param config - Configuration for the underlying bridge.\n */\nexport function createBoundViewBridge(view: EditorView, config: ViewBridgeConfig): BoundViewBridgeHandle {\n  const inner = createViewBridge(config)\n  let currentView = view\n\n  return {\n    applyText(text: string, options?: ApplyTextOptions): ApplyTextResult {\n      return inner.applyText(currentView, text, options)\n    },\n    extractText(): string {\n      return inner.extractText(currentView)\n    },\n    isBridgeChange(tr: Transaction): boolean {\n      return inner.isBridgeChange(tr)\n    },\n    setView(v: EditorView): void {\n      currentView = v\n    },\n  }\n}\n","import type { Node } from 'prosemirror-model'\nimport type { Serialize } from './types.js'\n\n/** A mapping between a ProseMirror position range and a serialized-text offset range. */\nexport type TextSegment = {\n  pmStart: number   // PM position (inclusive)\n  pmEnd: number     // PM position (exclusive)\n  textStart: number // serialized text offset (inclusive)\n  textEnd: number   // serialized text offset (exclusive)\n}\n\n/**\n * Sorted list of {@link TextSegment}s produced by {@link buildCursorMap}.\n * Use {@link cursorMapLookup} and {@link reverseCursorMapLookup} for O(log n) queries.\n */\nexport type CursorMap = {\n  segments: TextSegment[]\n  textLength: number\n  /** Number of text nodes that could not be located in the serialized output. */\n  skippedNodes: number\n}\n\n/**\n * Locate a text-node string within the serialized output.\n * Return the starting index, or -1 if not found.\n * Default: `(serialized, nodeText, from) => serialized.indexOf(nodeText, from)`\n */\nexport type LocateText = (serialized: string, nodeText: string, searchFrom: number) => number\n\nconst defaultLocate: LocateText = (serialized, nodeText, from) =>\n  serialized.indexOf(nodeText, from)\n\n/**\n * Build a cursor map that aligns ProseMirror positions with serialized-text offsets.\n *\n * Walks the document tree and locates each text node within the serialized output,\n * producing a sorted list of {@link TextSegment}s.\n *\n * @param doc - The ProseMirror document to map.\n * @param serialize - Serializer used to produce the full text.\n * @param locate - Optional custom text-location function. Defaults to `indexOf`.\n */\nexport function buildCursorMap(\n  doc: Node,\n  serialize: Serialize,\n  locate: LocateText = defaultLocate,\n): CursorMap {\n  const fullText = serialize(doc)\n  const segments: TextSegment[] = []\n  let searchFrom = 0\n  let skippedNodes = 0\n\n  function walkChildren(node: Node, contentStart: number): void {\n    node.forEach((child, offset) => {\n      const childPos = contentStart + offset\n\n      if (child.isText && child.text) {\n        const text = child.text\n        const idx = locate(fullText, text, searchFrom)\n        if (idx >= 0) {\n          segments.push({\n            pmStart: childPos,\n            pmEnd: childPos + text.length,\n            textStart: idx,\n            textEnd: idx + text.length,\n          })\n          searchFrom = idx + text.length\n        } else {\n          skippedNodes++\n        }\n        return\n      }\n\n      if (child.isLeaf) {\n        return\n      }\n\n      // Container node: content starts at childPos + 1 (open tag)\n      walkChildren(child, childPos + 1)\n    })\n  }\n\n  // doc's content starts at position 0\n  walkChildren(doc, 0)\n\n  return { segments, textLength: fullText.length, skippedNodes }\n}\n\n/**\n * Look up a ProseMirror position in a cursor map and return the corresponding text offset.\n * Returns `null` when the map has no segments.\n */\nexport function cursorMapLookup(map: CursorMap, pmPos: number): number | null {\n  const { segments } = map\n  if (segments.length === 0) return null\n\n  // Binary search for the segment containing pmPos\n  let lo = 0\n  let hi = segments.length - 1\n\n  while (lo <= hi) {\n    const mid = (lo + hi) >>> 1\n    const seg = segments[mid]\n\n    if (pmPos < seg.pmStart) {\n      hi = mid - 1\n    } else if (pmPos >= seg.pmEnd) {\n      lo = mid + 1\n    } else {\n      // Inside segment: exact mapping\n      return seg.textStart + (pmPos - seg.pmStart)\n    }\n  }\n\n  // pmPos is between segments — snap to nearest boundary\n  // After binary search: hi < lo, pmPos falls between segments[hi] and segments[lo]\n  const before = hi >= 0 ? segments[hi] : null\n  const after = lo < segments.length ? segments[lo] : null\n\n  if (!before) return after ? after.textStart : 0\n  if (!after) return before.textEnd\n\n  const distBefore = pmPos - before.pmEnd\n  const distAfter = after.pmStart - pmPos\n  return distBefore <= distAfter ? before.textEnd : after.textStart\n}\n\n/**\n * Look up a text offset (e.g. CodeMirror position) in a cursor map and return the corresponding ProseMirror position.\n * Returns `null` when the map has no segments.\n */\nexport function reverseCursorMapLookup(map: CursorMap, cmOffset: number): number | null {\n  const { segments } = map\n  if (segments.length === 0) return null\n\n  // Binary search for the segment containing cmOffset\n  let lo = 0\n  let hi = segments.length - 1\n\n  while (lo <= hi) {\n    const mid = (lo + hi) >>> 1\n    const seg = segments[mid]\n\n    if (cmOffset < seg.textStart) {\n      hi = mid - 1\n    } else if (cmOffset >= seg.textEnd) {\n      lo = mid + 1\n    } else {\n      // Inside segment: exact mapping\n      return seg.pmStart + (cmOffset - seg.textStart)\n    }\n  }\n\n  // cmOffset is between segments — snap to nearest boundary\n  const before = hi >= 0 ? segments[hi] : null\n  const after = lo < segments.length ? segments[lo] : null\n\n  if (!before) return after ? after.pmStart : 0\n  if (!after) return before.pmEnd\n\n  const distBefore = cmOffset - before.textEnd\n  const distAfter = after.textStart - cmOffset\n  return distBefore <= distAfter ? before.pmEnd : after.pmStart\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@pm-cm/core",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist/index.*"
+  ],
+  "scripts": {
+    "build": "tsup"
+  },
+  "peerDependencies": {
+    "prosemirror-model": "^1.19.0",
+    "prosemirror-state": "^1.4.0",
+    "prosemirror-view": "^1.20.0"
+  },
+  "description": "Cursor mapping between ProseMirror and text editors",
+  "license": "MIT",
+  "author": "munenick",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MuNeNICK/prosemirror-codemirror-sync.git",
+    "directory": "packages/core"
+  },
+  "keywords": ["prosemirror", "codemirror", "sync", "bridge", "cursor"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "prosemirror-model": "^1.25.4",
+    "prosemirror-state": "^1.4.4",
+    "prosemirror-view": "^1.41.5",
+    "tsup": "^8.0.0",
+    "typescript": "~5.9.3"
+  }
+}