@latentic/live-markdown 0.3.0 → 0.4.0

package/dist/codemirror/tablev2/tableV2HoverControls.js

@@ -0,0 +1,89 @@
+import "../../chunk-V6TY7KAL.js";
+import { ViewPlugin } from "@codemirror/view";
+import { addColumnAfter, addRowBelow } from "../table/tableEditCommands.js";
+const PLUS = 20;
+const PLUS_SVG = '<svg viewBox="0 0 16 16" width="11" height="11" aria-hidden="true"><path d="M8 2.75v10.5M2.75 8h10.5" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/></svg>';
+function makeInserter(kind, label) {
+  const el = document.createElement("button");
+  el.type = "button";
+  el.className = `cm-table-inserter cm-table-inserter--${kind}`;
+  el.setAttribute("aria-label", label);
+  el.innerHTML = PLUS_SVG;
+  return el;
+}
+function tableV2HoverControls() {
+  return ViewPlugin.define((view) => {
+    let lastCell = null;
+    const runInsert = (event) => {
+      const button = event.currentTarget;
+      const pos = Number(button.dataset.pos);
+      if (Number.isNaN(pos)) return;
+      const command = button.classList.contains("cm-table-inserter--row") ? addRowBelow : addColumnAfter;
+      const change = command(view.state, pos);
+      if (change) view.dispatch({ changes: change, userEvent: "input.table.structure" });
+    };
+    const ensure = (wrap) => {
+      let row = wrap.querySelector(":scope > .cm-table-inserter--row");
+      let col = wrap.querySelector(":scope > .cm-table-inserter--column");
+      if (!row) {
+        row = makeInserter("row", "Insert row below");
+        row.addEventListener("click", runInsert);
+        wrap.appendChild(row);
+      }
+      if (!col) {
+        col = makeInserter("column", "Insert column right");
+        col.addEventListener("click", runInsert);
+        wrap.appendChild(col);
+      }
+      return { row, col };
+    };
+    const hideAll = () => {
+      lastCell = null;
+      view.dom.querySelectorAll(".cm-table-inserter").forEach((el) => el.style.display = "none");
+    };
+    const onMouseMove = (event) => {
+      const target = event.target;
+      if (target.closest?.(".cm-table-inserter")) return;
+      const cell = target.closest?.("[data-cell-from]");
+      const wrap = target.closest?.("[data-tablev2-from]");
+      if (!(cell instanceof HTMLElement) || !(wrap instanceof HTMLElement)) {
+        hideAll();
+        return;
+      }
+      if (cell.getAttribute("contenteditable")) {
+        hideAll();
+        return;
+      }
+      if (cell === lastCell) return;
+      lastCell = cell;
+      const { row, col } = ensure(wrap);
+      row.dataset.pos = cell.dataset.cellFrom;
+      col.dataset.pos = cell.dataset.cellFrom;
+      const table = wrap.querySelector("table");
+      if (!table) return;
+      const cellRect = cell.getBoundingClientRect();
+      const tableRect = table.getBoundingClientRect();
+      const wrapRect = wrap.getBoundingClientRect();
+      const leftGutter = tableRect.left - wrapRect.left;
+      const topGutter = tableRect.top - wrapRect.top;
+      row.style.display = "flex";
+      row.style.left = `${(leftGutter - PLUS) / 2}px`;
+      row.style.top = `${cellRect.bottom - wrapRect.top - PLUS / 2}px`;
+      col.style.display = "flex";
+      col.style.left = `${cellRect.right - wrapRect.left - PLUS / 2}px`;
+      col.style.top = `${(topGutter - PLUS) / 2}px`;
+    };
+    view.dom.addEventListener("mousemove", onMouseMove);
+    view.dom.addEventListener("mouseleave", hideAll);
+    return {
+      destroy() {
+        view.dom.removeEventListener("mousemove", onMouseMove);
+        view.dom.removeEventListener("mouseleave", hideAll);
+      }
+    };
+  });
+}
+export {
+  tableV2HoverControls
+};
+//# sourceMappingURL=tableV2HoverControls.js.map

package/dist/codemirror/tablev2/tableV2HoverControls.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/codemirror/tablev2/tableV2HoverControls.ts"],"sourcesContent":["/**\n * Zettlr-style quick inserters for the V2 table: hovering a cell reveals a\n * \"+\" in the wrap's gutter — below-left for a row, top-right for a column —\n * inserting relative to the hovered cell. The right-click menu carries the\n * full command set; these are the two high-frequency shortcuts.\n *\n * Ported from the V1 controls with both approved fixes baked in:\n *   - repositioning is gated on the hovered CELL changing (per-mousemove\n *     rewrites made the buttons jitter — \"flashing\"),\n *   - the glyph is a centred SVG on a subtle neutral chip; the primary accent\n *     is the hover state, not the resting state (editorTheme).\n *\n * One delegated listener per editor; buttons attach lazily per wrap and are\n * re-attached automatically after a widget recreate (the next mousemove).\n */\n\nimport { ViewPlugin } from \"@codemirror/view\";\nimport { type ChangeSpec, type EditorState } from \"@codemirror/state\";\n\nimport { addColumnAfter, addRowBelow } from \"../table/tableEditCommands\";\n\ntype InsertCommand = (state: EditorState, pos: number) => ChangeSpec | null;\n\n/** Inserter circle diameter; keep in sync with `.cm-table-inserter`. */\nconst PLUS = 20;\n\nconst PLUS_SVG =\n  '<svg viewBox=\"0 0 16 16\" width=\"11\" height=\"11\" aria-hidden=\"true\">' +\n  '<path d=\"M8 2.75v10.5M2.75 8h10.5\" stroke=\"currentColor\" stroke-width=\"1.6\" stroke-linecap=\"round\"/></svg>';\n\nfunction makeInserter(kind: \"row\" | \"column\", label: string): HTMLButtonElement {\n  const el = document.createElement(\"button\");\n  el.type = \"button\";\n  el.className = `cm-table-inserter cm-table-inserter--${kind}`;\n  el.setAttribute(\"aria-label\", label);\n  el.innerHTML = PLUS_SVG;\n  return el;\n}\n\nexport function tableV2HoverControls() {\n  return ViewPlugin.define((view) => {\n    let lastCell: Element | null = null;\n\n    const runInsert = (event: Event): void => {\n      const button = event.currentTarget as HTMLElement;\n      const pos = Number(button.dataset.pos);\n      if (Number.isNaN(pos)) return;\n      const command: InsertCommand = button.classList.contains(\"cm-table-inserter--row\")\n        ? addRowBelow\n        : addColumnAfter;\n      const change = command(view.state, pos);\n      if (change) view.dispatch({ changes: change, userEvent: \"input.table.structure\" });\n    };\n\n    const ensure = (wrap: HTMLElement): { row: HTMLElement; col: HTMLElement } => {\n      let row = wrap.querySelector<HTMLElement>(\":scope > .cm-table-inserter--row\");\n      let col = wrap.querySelector<HTMLElement>(\":scope > .cm-table-inserter--column\");\n      if (!row) {\n        row = makeInserter(\"row\", \"Insert row below\");\n        row.addEventListener(\"click\", runInsert);\n        wrap.appendChild(row);\n      }\n      if (!col) {\n        col = makeInserter(\"column\", \"Insert column right\");\n        col.addEventListener(\"click\", runInsert);\n        wrap.appendChild(col);\n      }\n      return { row, col };\n    };\n\n    const hideAll = (): void => {\n      lastCell = null;\n      view.dom\n        .querySelectorAll<HTMLElement>(\".cm-table-inserter\")\n        .forEach((el) => (el.style.display = \"none\"));\n    };\n\n    const onMouseMove = (event: MouseEvent): void => {\n      const target = event.target as HTMLElement;\n      // On an inserter: leave it exactly where it is so it stays clickable.\n      if (target.closest?.(\".cm-table-inserter\")) return;\n      const cell = target.closest?.(\"[data-cell-from]\");\n      const wrap = target.closest?.(\"[data-tablev2-from]\");\n      if (!(cell instanceof HTMLElement) || !(wrap instanceof HTMLElement)) {\n        hideAll();\n        return;\n      }\n      if (cell.getAttribute(\"contenteditable\")) {\n        // The cell is being edited — stay out of its way.\n        hideAll();\n        return;\n      }\n      // Reposition only when the hovered cell changes: per-move rewrites\n      // jitter (\"flashing\") while the pointer travels within one cell.\n      if (cell === lastCell) return;\n      lastCell = cell;\n\n      const { row, col } = ensure(wrap);\n      row.dataset.pos = cell.dataset.cellFrom;\n      col.dataset.pos = cell.dataset.cellFrom;\n\n      const table = wrap.querySelector(\"table\");\n      if (!table) return;\n      const cellRect = cell.getBoundingClientRect();\n      const tableRect = table.getBoundingClientRect();\n      const wrapRect = wrap.getBoundingClientRect();\n      const leftGutter = tableRect.left - wrapRect.left;\n      const topGutter = tableRect.top - wrapRect.top;\n\n      row.style.display = \"flex\";\n      row.style.left = `${(leftGutter - PLUS) / 2}px`;\n      row.style.top = `${cellRect.bottom - wrapRect.top - PLUS / 2}px`;\n\n      col.style.display = \"flex\";\n      col.style.left = `${cellRect.right - wrapRect.left - PLUS / 2}px`;\n      col.style.top = `${(topGutter - PLUS) / 2}px`;\n    };\n\n    view.dom.addEventListener(\"mousemove\", onMouseMove);\n    view.dom.addEventListener(\"mouseleave\", hideAll);\n    return {\n      destroy() {\n        view.dom.removeEventListener(\"mousemove\", onMouseMove);\n        view.dom.removeEventListener(\"mouseleave\", hideAll);\n      },\n    };\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/codemirror/tablev2/tableV2Interaction.d.ts

@@ -0,0 +1,29 @@
+import { Extension } from '@codemirror/state';
+import { CellEditingSurface } from './cellEditingSurface.js';
+import '@codemirror/view';
+
+/**
+ * The interaction wiring around a {@link CellEditingSurface} (ADR 0001):
+ *
+ *   - pointer: one press lifecycle owns the mouse. A press that stays in its
+ *     cell is a CLICK → edit begins on release with the caret at the pressed
+ *     point (caretRangeFromPoint). A press that crosses into another cell is a
+ *     DRAG → whole-cell selection (never a ragged native text selection).
+ *     Presses inside the active editing element stay native. Handled by
+ *     NATIVE listeners because the widget's `ignoreEvent() → true` hides
+ *     these events from CodeMirror — which is also what keeps a table click
+ *     from ever moving the main caret.
+ *   - keys: a document-capture keydown runs {@link bridgeKey} while an edit is
+ *     active — mid-text keys stay native; boundary keys commit and step to the
+ *     neighbour cell or exit to the main document (exitCaretPos).
+ *   - copy: with a cell selection active, copy yields TSV.
+ *   - context menu: right-click on a cell opens the structure menu
+ *     (insert/delete row/column) targeting that cell's position.
+ *   - entry: ArrowDown/ArrowUp in the MAIN editor next to a table enters its
+ *     first/last row (the table is an atomic block the caret can't land on).
+ */
+
+/** All interaction wiring for the V2 table; compose with `tableV2(surface)`. */
+declare function tableV2Interaction(surface: CellEditingSurface): Extension;
+
+export { tableV2Interaction };

package/dist/codemirror/tablev2/tableV2Interaction.js

@@ -0,0 +1,224 @@
+import "../../chunk-V6TY7KAL.js";
+import { Prec } from "@codemirror/state";
+import { ViewPlugin, keymap } from "@codemirror/view";
+import { showTableMenu } from "../table/tableContextMenu.js";
+import { exitCaretPos, rowCount } from "../table/tableCellNav.js";
+import { modelAt } from "../table/tableGeometry.js";
+import {
+  cellRange,
+  offsetAtPoint,
+  visualEdges
+} from "./cellEditingSurface.js";
+import { bridgeKey, gridSize } from "./bridgeRules.js";
+import {
+  CellSelectionController,
+  columnRect,
+  rectOf,
+  rowRect,
+  tableRect
+} from "./tableV2Selection.js";
+function refOf(cellEl) {
+  return { row: Number(cellEl.dataset.row), col: Number(cellEl.dataset.col) };
+}
+function hitCell(target) {
+  if (!(target instanceof HTMLElement)) return null;
+  const cellEl = target.closest?.("[data-row][data-col]");
+  const wrap = target.closest?.("[data-tablev2-from]");
+  if (!(cellEl instanceof HTMLElement) || !(wrap instanceof HTMLElement)) return null;
+  return { cellEl, tableFrom: Number(wrap.dataset.tablev2From) };
+}
+function bridgeKeyOf(event) {
+  if (event.metaKey || event.ctrlKey || event.altKey) return null;
+  switch (event.key) {
+    case "Tab":
+      return event.shiftKey ? "Shift-Tab" : "Tab";
+    case "ArrowRight":
+    case "ArrowLeft":
+    case "ArrowUp":
+    case "ArrowDown":
+    case "Backspace":
+    case "Delete":
+    case "Enter":
+      return event.shiftKey ? null : event.key;
+    default:
+      return null;
+  }
+}
+function pointerPlugin(surface, selection) {
+  return ViewPlugin.define((view) => {
+    let press = null;
+    const onMouseMove = (event) => {
+      if (!press) return;
+      const hit = hitCell(event.target);
+      if (!hit || hit.tableFrom !== press.tableFrom) return;
+      const ref = refOf(hit.cellEl);
+      const crossed = ref.row !== press.startRef.row || ref.col !== press.startRef.col;
+      if (crossed || press.dragged) {
+        press.dragged = true;
+        selection.set(view, press.tableFrom, rectOf(press.startRef, ref));
+      }
+    };
+    const onMouseUp = () => {
+      const p = press;
+      press = null;
+      window.removeEventListener("mousemove", onMouseMove, true);
+      window.removeEventListener("mouseup", onMouseUp, true);
+      if (!p || p.dragged) return;
+      if (!surface.begin(view, p.tableFrom, p.startRef, 0)) return;
+      const el = surface.editingElement();
+      if (!el) return;
+      const offset = offsetAtPoint(el, p.startX, p.startY);
+      surface.placeCaret(offset ?? surface.active().text.length);
+    };
+    const onMouseDown = (event) => {
+      if (event.button !== 0) return;
+      const editing = surface.editingElement();
+      if (editing && event.target instanceof Node && editing.contains(event.target)) return;
+      const hit = hitCell(event.target);
+      if (!hit) {
+        selection.clear(view);
+        return;
+      }
+      event.preventDefault();
+      surface.commit(view);
+      selection.clear(view);
+      press = {
+        tableFrom: hit.tableFrom,
+        startRef: refOf(hit.cellEl),
+        startX: event.clientX,
+        startY: event.clientY,
+        dragged: false
+      };
+      window.addEventListener("mousemove", onMouseMove, true);
+      window.addEventListener("mouseup", onMouseUp, true);
+    };
+    const onContextMenu = (event) => {
+      const hit = hitCell(event.target);
+      if (!hit) return;
+      event.preventDefault();
+      surface.commit(view);
+      const ref = refOf(hit.cellEl);
+      const range = cellRange(view.state, hit.tableFrom, ref);
+      if (!range) return;
+      showTableMenu({
+        x: event.clientX,
+        y: event.clientY,
+        view,
+        pos: range.from,
+        selectCells: (axis) => {
+          const model = modelAt(view.state, hit.tableFrom);
+          if (!model) return;
+          const { rows, cols } = gridSize(model);
+          const rect = axis === "row" ? rowRect(cols, ref.row) : axis === "column" ? columnRect(rows, ref.col) : tableRect(rows, cols);
+          selection.set(view, hit.tableFrom, rect);
+        }
+      });
+    };
+    const onCopy = (event) => {
+      const tsv = selection.tsv(view);
+      if (tsv === null) return;
+      event.clipboardData?.setData("text/plain", tsv);
+      event.preventDefault();
+    };
+    view.dom.addEventListener("mousedown", onMouseDown);
+    view.dom.addEventListener("contextmenu", onContextMenu);
+    document.addEventListener("copy", onCopy, true);
+    return {
+      update(update) {
+        if (update.docChanged) selection.clear(view);
+      },
+      destroy() {
+        view.dom.removeEventListener("mousedown", onMouseDown);
+        view.dom.removeEventListener("contextmenu", onContextMenu);
+        document.removeEventListener("copy", onCopy, true);
+        window.removeEventListener("mousemove", onMouseMove, true);
+        window.removeEventListener("mouseup", onMouseUp, true);
+      }
+    };
+  });
+}
+function keyPlugin(surface) {
+  return ViewPlugin.define((view) => {
+    const onKeyDown = (event) => {
+      const el = surface.editingElement();
+      if (!el || !(event.target instanceof Node) || !el.contains(event.target)) return;
+      const key = bridgeKeyOf(event);
+      if (!key) return;
+      const active = surface.active();
+      const tableFrom = surface.anchor();
+      if (!active || tableFrom === null) return;
+      const model = modelAt(view.state, tableFrom);
+      if (!model) return;
+      const action = bridgeKey(
+        {
+          ...gridSize(model),
+          row: active.ref.row,
+          col: active.ref.col,
+          offset: active.caret,
+          length: active.text.length,
+          ...visualEdges(el)
+        },
+        key
+      );
+      if (action.kind === "native") return;
+      event.preventDefault();
+      surface.commit(view);
+      if (action.kind === "focusCell") {
+        surface.begin(
+          view,
+          tableFrom,
+          { row: action.row, col: action.col },
+          action.caret === "end" ? Number.MAX_SAFE_INTEGER : 0
+        );
+        return;
+      }
+      const after = modelAt(view.state, tableFrom);
+      if (!after) return;
+      const pos = exitCaretPos(
+        action.edge === "before" ? "above" : "below",
+        after.from,
+        after.to,
+        view.state.doc.length
+      );
+      view.focus();
+      view.dispatch({ selection: { anchor: pos }, scrollIntoView: true });
+    };
+    document.addEventListener("keydown", onKeyDown, true);
+    return {
+      destroy() {
+        document.removeEventListener("keydown", onKeyDown, true);
+      }
+    };
+  });
+}
+function enterTable(view, surface, dir) {
+  const { main } = view.state.selection;
+  if (!main.empty) return false;
+  const doc = view.state.doc;
+  const line = doc.lineAt(main.head);
+  const neighbour = dir === "down" ? line.number + 1 : line.number - 1;
+  if (neighbour < 1 || neighbour > doc.lines) return false;
+  const target = doc.line(neighbour);
+  const probe = dir === "down" ? target.from : Math.max(target.from, target.to - 1);
+  const model = modelAt(view.state, probe);
+  if (!model) return false;
+  const ref = dir === "down" ? { row: 0, col: 0 } : { row: rowCount(model) - 1, col: 0 };
+  return surface.begin(view, model.from, ref, 0);
+}
+function tableV2Interaction(surface) {
+  const selection = new CellSelectionController();
+  return [
+    pointerPlugin(surface, selection),
+    keyPlugin(surface),
+    Prec.high(
+      keymap.of([
+        { key: "ArrowDown", run: (view) => enterTable(view, surface, "down") },
+        { key: "ArrowUp", run: (view) => enterTable(view, surface, "up") }
+      ])
+    )
+  ];
+}
+export {
+  tableV2Interaction
+};
+//# sourceMappingURL=tableV2Interaction.js.map

package/dist/codemirror/tablev2/tableV2Interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/codemirror/tablev2/tableV2Interaction.ts"],"sourcesContent":["/**\n * The interaction wiring around a {@link CellEditingSurface} (ADR 0001):\n *\n *   - pointer: one press lifecycle owns the mouse. A press that stays in its\n *     cell is a CLICK → edit begins on release with the caret at the pressed\n *     point (caretRangeFromPoint). A press that crosses into another cell is a\n *     DRAG → whole-cell selection (never a ragged native text selection).\n *     Presses inside the active editing element stay native. Handled by\n *     NATIVE listeners because the widget's `ignoreEvent() → true` hides\n *     these events from CodeMirror — which is also what keeps a table click\n *     from ever moving the main caret.\n *   - keys: a document-capture keydown runs {@link bridgeKey} while an edit is\n *     active — mid-text keys stay native; boundary keys commit and step to the\n *     neighbour cell or exit to the main document (exitCaretPos).\n *   - copy: with a cell selection active, copy yields TSV.\n *   - context menu: right-click on a cell opens the structure menu\n *     (insert/delete row/column) targeting that cell's position.\n *   - entry: ArrowDown/ArrowUp in the MAIN editor next to a table enters its\n *     first/last row (the table is an atomic block the caret can't land on).\n */\n\nimport { Prec } from \"@codemirror/state\";\nimport { EditorView, ViewPlugin, keymap } from \"@codemirror/view\";\nimport { type Extension } from \"@codemirror/state\";\n\nimport { showTableMenu } from \"../table/tableContextMenu\";\nimport { exitCaretPos, rowCount } from \"../table/tableCellNav\";\nimport { modelAt } from \"../table/tableGeometry\";\nimport {\n  type CellEditingSurface,\n  type CellRef,\n  cellRange,\n  offsetAtPoint,\n  visualEdges,\n} from \"./cellEditingSurface\";\nimport { type BridgeKey, bridgeKey, gridSize } from \"./bridgeRules\";\nimport {\n  CellSelectionController,\n  columnRect,\n  rectOf,\n  rowRect,\n  tableRect,\n} from \"./tableV2Selection\";\n\nfunction refOf(cellEl: HTMLElement): CellRef {\n  return { row: Number(cellEl.dataset.row), col: Number(cellEl.dataset.col) };\n}\n\nfunction hitCell(target: EventTarget | null): { cellEl: HTMLElement; tableFrom: number } | null {\n  if (!(target instanceof HTMLElement)) return null;\n  const cellEl = target.closest?.(\"[data-row][data-col]\");\n  const wrap = target.closest?.(\"[data-tablev2-from]\");\n  if (!(cellEl instanceof HTMLElement) || !(wrap instanceof HTMLElement)) return null;\n  return { cellEl, tableFrom: Number(wrap.dataset.tablev2From) };\n}\n\n/** Map a KeyboardEvent to a bridge key; null = not the bridge's business. */\nfunction bridgeKeyOf(event: KeyboardEvent): BridgeKey | null {\n  if (event.metaKey || event.ctrlKey || event.altKey) return null;\n  switch (event.key) {\n    case \"Tab\":\n      return event.shiftKey ? \"Shift-Tab\" : \"Tab\";\n    case \"ArrowRight\":\n    case \"ArrowLeft\":\n    case \"ArrowUp\":\n    case \"ArrowDown\":\n    case \"Backspace\":\n    case \"Delete\":\n    case \"Enter\":\n      return event.shiftKey ? null : (event.key as BridgeKey);\n    default:\n      return null;\n  }\n}\n\ninterface Press {\n  tableFrom: number;\n  startRef: CellRef;\n  startX: number;\n  startY: number;\n  dragged: boolean;\n}\n\nfunction pointerPlugin(surface: CellEditingSurface, selection: CellSelectionController) {\n  return ViewPlugin.define((view) => {\n    let press: Press | null = null;\n\n    const onMouseMove = (event: MouseEvent): void => {\n      if (!press) return;\n      const hit = hitCell(event.target);\n      if (!hit || hit.tableFrom !== press.tableFrom) return;\n      const ref = refOf(hit.cellEl);\n      const crossed = ref.row !== press.startRef.row || ref.col !== press.startRef.col;\n      if (crossed || press.dragged) {\n        press.dragged = true;\n        selection.set(view, press.tableFrom, rectOf(press.startRef, ref));\n      }\n    };\n\n    const onMouseUp = (): void => {\n      const p = press;\n      press = null;\n      window.removeEventListener(\"mousemove\", onMouseMove, true);\n      window.removeEventListener(\"mouseup\", onMouseUp, true);\n      if (!p || p.dragged) return; // a drag leaves its selection standing\n      if (!surface.begin(view, p.tableFrom, p.startRef, 0)) return;\n      const el = surface.editingElement();\n      if (!el) return;\n      const offset = offsetAtPoint(el, p.startX, p.startY);\n      surface.placeCaret(offset ?? surface.active()!.text.length);\n    };\n\n    const onMouseDown = (event: MouseEvent): void => {\n      if (event.button !== 0) return;\n      const editing = surface.editingElement();\n      if (editing && event.target instanceof Node && editing.contains(event.target)) return;\n      const hit = hitCell(event.target);\n      if (!hit) {\n        // A press outside any table (prose, gutters): selection is done.\n        selection.clear(view);\n        return;\n      }\n      event.preventDefault();\n      surface.commit(view);\n      selection.clear(view);\n      press = {\n        tableFrom: hit.tableFrom,\n        startRef: refOf(hit.cellEl),\n        startX: event.clientX,\n        startY: event.clientY,\n        dragged: false,\n      };\n      window.addEventListener(\"mousemove\", onMouseMove, true);\n      window.addEventListener(\"mouseup\", onMouseUp, true);\n    };\n\n    const onContextMenu = (event: MouseEvent): void => {\n      const hit = hitCell(event.target);\n      if (!hit) return;\n      event.preventDefault();\n      surface.commit(view);\n      const ref = refOf(hit.cellEl);\n      const range = cellRange(view.state, hit.tableFrom, ref);\n      if (!range) return;\n      showTableMenu({\n        x: event.clientX,\n        y: event.clientY,\n        view,\n        pos: range.from,\n        selectCells: (axis) => {\n          const model = modelAt(view.state, hit.tableFrom);\n          if (!model) return;\n          const { rows, cols } = gridSize(model);\n          const rect =\n            axis === \"row\"\n              ? rowRect(cols, ref.row)\n              : axis === \"column\"\n                ? columnRect(rows, ref.col)\n                : tableRect(rows, cols);\n          selection.set(view, hit.tableFrom, rect);\n        },\n      });\n    };\n\n    const onCopy = (event: ClipboardEvent): void => {\n      const tsv = selection.tsv(view);\n      if (tsv === null) return;\n      event.clipboardData?.setData(\"text/plain\", tsv);\n      event.preventDefault();\n    };\n\n    view.dom.addEventListener(\"mousedown\", onMouseDown);\n    view.dom.addEventListener(\"contextmenu\", onContextMenu);\n    document.addEventListener(\"copy\", onCopy, true);\n    return {\n      update(update: { docChanged: boolean }) {\n        // Cell geometry changed under the selection: transient by design.\n        if (update.docChanged) selection.clear(view);\n      },\n      destroy() {\n        view.dom.removeEventListener(\"mousedown\", onMouseDown);\n        view.dom.removeEventListener(\"contextmenu\", onContextMenu);\n        document.removeEventListener(\"copy\", onCopy, true);\n        window.removeEventListener(\"mousemove\", onMouseMove, true);\n        window.removeEventListener(\"mouseup\", onMouseUp, true);\n      },\n    };\n  });\n}\n\nfunction keyPlugin(surface: CellEditingSurface) {\n  return ViewPlugin.define((view) => {\n    const onKeyDown = (event: KeyboardEvent): void => {\n      const el = surface.editingElement();\n      if (!el || !(event.target instanceof Node) || !el.contains(event.target)) return;\n      const key = bridgeKeyOf(event);\n      if (!key) return;\n      const active = surface.active();\n      const tableFrom = surface.anchor();\n      if (!active || tableFrom === null) return;\n      const model = modelAt(view.state, tableFrom);\n      if (!model) return;\n      const action = bridgeKey(\n        {\n          ...gridSize(model),\n          row: active.ref.row,\n          col: active.ref.col,\n          offset: active.caret,\n          length: active.text.length,\n          ...visualEdges(el),\n        },\n        key,\n      );\n      if (action.kind === \"native\") return;\n      event.preventDefault();\n      surface.commit(view);\n      if (action.kind === \"focusCell\") {\n        surface.begin(\n          view,\n          tableFrom,\n          { row: action.row, col: action.col },\n          action.caret === \"end\" ? Number.MAX_SAFE_INTEGER : 0,\n        );\n        return;\n      }\n      const after = modelAt(view.state, tableFrom);\n      if (!after) return;\n      const pos = exitCaretPos(\n        action.edge === \"before\" ? \"above\" : \"below\",\n        after.from,\n        after.to,\n        view.state.doc.length,\n      );\n      view.focus();\n      view.dispatch({ selection: { anchor: pos }, scrollIntoView: true });\n    };\n    document.addEventListener(\"keydown\", onKeyDown, true);\n    return {\n      destroy() {\n        document.removeEventListener(\"keydown\", onKeyDown, true);\n      },\n    };\n  });\n}\n\n/** Enter the table's first/last row when vertical motion in the main editor\n *  reaches it — the block widget itself can't hold the caret. */\nfunction enterTable(view: EditorView, surface: CellEditingSurface, dir: \"up\" | \"down\"): boolean {\n  const { main } = view.state.selection;\n  if (!main.empty) return false;\n  const doc = view.state.doc;\n  const line = doc.lineAt(main.head);\n  const neighbour = dir === \"down\" ? line.number + 1 : line.number - 1;\n  if (neighbour < 1 || neighbour > doc.lines) return false;\n  const target = doc.line(neighbour);\n  // Probe INSIDE the neighbour line: its end sits on the table node's own end\n  // boundary, which side-sensitive resolution misses.\n  const probe = dir === \"down\" ? target.from : Math.max(target.from, target.to - 1);\n  const model = modelAt(view.state, probe);\n  if (!model) return false;\n  const ref: CellRef =\n    dir === \"down\" ? { row: 0, col: 0 } : { row: rowCount(model) - 1, col: 0 };\n  return surface.begin(view, model.from, ref, 0);\n}\n\n/** All interaction wiring for the V2 table; compose with `tableV2(surface)`. */\nexport function tableV2Interaction(surface: CellEditingSurface): Extension {\n  const selection = new CellSelectionController();\n  return [\n    pointerPlugin(surface, selection),\n    keyPlugin(surface),\n    Prec.high(\n      keymap.of([\n        { key: \"ArrowDown\", run: (view) => enterTable(view, surface, \"down\") },\n        { key: \"ArrowUp\", run: (view) => enterTable(view, surface, \"up\") },\n      ]),\n    ),\n  ];\n}\n"],"mappings":"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","names":[]}

package/dist/codemirror/tablev2/tableV2Selection.d.ts

@@ -0,0 +1,45 @@
+import { EditorView } from '@codemirror/view';
+import { CellRef } from './cellEditingSurface.js';
+import '@codemirror/state';
+
+/**
+ * Whole-cell visual selection (feature scenarios 11–13). A drag across cells
+ * never produces a ragged native text selection — it selects whole cells,
+ * painted with a class; copy serialises the selected rectangle as TSV from
+ * the CURRENT document. Selection is transient: any document change clears it.
+ *
+ * The rectangle math is pure and dimension-based so the @pure tier can
+ * enumerate it without a model or DOM.
+ */
+
+declare const SELECTED_CLASS = "cm-table-cell--selected";
+interface CellRect {
+    r0: number;
+    c0: number;
+    r1: number;
+    c1: number;
+}
+/** The normalised rectangle spanned by two cells. */
+declare function rectOf(a: CellRef, b: CellRef): CellRect;
+/** Every cell in `rect`, row-major. */
+declare function refsIn(rect: CellRect): CellRef[];
+/** One whole column of a `rows`-high grid (row 0 = header). */
+declare function columnRect(rows: number, col: number): CellRect;
+/** One whole row of a `cols`-wide grid. */
+declare function rowRect(cols: number, row: number): CellRect;
+/** The whole grid. */
+declare function tableRect(rows: number, cols: number): CellRect;
+declare class CellSelectionController {
+    private sel;
+    set(view: EditorView, tableFrom: number, rect: CellRect): void;
+    get(): {
+        tableFrom: number;
+        rect: CellRect;
+    } | null;
+    clear(view: EditorView): void;
+    /** The selected rectangle as TSV, resolved from the current document. */
+    tsv(view: EditorView): string | null;
+    private unpaint;
+}
+
+export { type CellRect, CellSelectionController, SELECTED_CLASS, columnRect, rectOf, refsIn, rowRect, tableRect };

package/dist/codemirror/tablev2/tableV2Selection.js

@@ -0,0 +1,81 @@
+import {
+  __publicField
+} from "../../chunk-V6TY7KAL.js";
+import { cellAt } from "../table/tableCellNav.js";
+import { modelAt } from "../table/tableGeometry.js";
+import { cellElement } from "./cellEditingSurface.js";
+import { unescapePipes } from "./cellText.js";
+const SELECTED_CLASS = "cm-table-cell--selected";
+function rectOf(a, b) {
+  return {
+    r0: Math.min(a.row, b.row),
+    c0: Math.min(a.col, b.col),
+    r1: Math.max(a.row, b.row),
+    c1: Math.max(a.col, b.col)
+  };
+}
+function refsIn(rect) {
+  const refs = [];
+  for (let row = rect.r0; row <= rect.r1; row++) {
+    for (let col = rect.c0; col <= rect.c1; col++) refs.push({ row, col });
+  }
+  return refs;
+}
+function columnRect(rows, col) {
+  return { r0: 0, c0: col, r1: rows - 1, c1: col };
+}
+function rowRect(cols, row) {
+  return { r0: row, c0: 0, r1: row, c1: cols - 1 };
+}
+function tableRect(rows, cols) {
+  return { r0: 0, c0: 0, r1: rows - 1, c1: cols - 1 };
+}
+class CellSelectionController {
+  constructor() {
+    __publicField(this, "sel", null);
+  }
+  set(view, tableFrom, rect) {
+    this.unpaint(view);
+    this.sel = { tableFrom, rect };
+    for (const ref of refsIn(rect)) {
+      cellElement(view, tableFrom, ref)?.classList.add(SELECTED_CLASS);
+    }
+  }
+  get() {
+    return this.sel;
+  }
+  clear(view) {
+    this.unpaint(view);
+    this.sel = null;
+  }
+  /** The selected rectangle as TSV, resolved from the current document. */
+  tsv(view) {
+    const s = this.sel;
+    if (!s) return null;
+    const model = modelAt(view.state, s.tableFrom);
+    if (!model) return null;
+    const lines = [];
+    for (let row = s.rect.r0; row <= s.rect.r1; row++) {
+      const cells = [];
+      for (let col = s.rect.c0; col <= s.rect.c1; col++) {
+        const cell = cellAt(model, row, col);
+        cells.push(cell ? unescapePipes(view.state.sliceDoc(cell.from, cell.to)) : "");
+      }
+      lines.push(cells.join("	"));
+    }
+    return lines.join("\n");
+  }
+  unpaint(view) {
+    view.dom.querySelectorAll(`.${SELECTED_CLASS}`).forEach((el) => el.classList.remove(SELECTED_CLASS));
+  }
+}
+export {
+  CellSelectionController,
+  SELECTED_CLASS,
+  columnRect,
+  rectOf,
+  refsIn,
+  rowRect,
+  tableRect
+};
+//# sourceMappingURL=tableV2Selection.js.map

package/dist/codemirror/tablev2/tableV2Selection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/codemirror/tablev2/tableV2Selection.ts"],"sourcesContent":["/**\n * Whole-cell visual selection (feature scenarios 11–13). A drag across cells\n * never produces a ragged native text selection — it selects whole cells,\n * painted with a class; copy serialises the selected rectangle as TSV from\n * the CURRENT document. Selection is transient: any document change clears it.\n *\n * The rectangle math is pure and dimension-based so the @pure tier can\n * enumerate it without a model or DOM.\n */\n\nimport { type EditorView } from \"@codemirror/view\";\n\nimport { cellAt } from \"../table/tableCellNav\";\nimport { modelAt } from \"../table/tableGeometry\";\nimport { type CellRef, cellElement } from \"./cellEditingSurface\";\nimport { unescapePipes } from \"./cellText\";\n\n// The V1 theme already styles this class; reuse it wholesale.\nexport const SELECTED_CLASS = \"cm-table-cell--selected\";\n\nexport interface CellRect {\n  r0: number;\n  c0: number;\n  r1: number;\n  c1: number;\n}\n\n/** The normalised rectangle spanned by two cells. */\nexport function rectOf(a: CellRef, b: CellRef): CellRect {\n  return {\n    r0: Math.min(a.row, b.row),\n    c0: Math.min(a.col, b.col),\n    r1: Math.max(a.row, b.row),\n    c1: Math.max(a.col, b.col),\n  };\n}\n\n/** Every cell in `rect`, row-major. */\nexport function refsIn(rect: CellRect): CellRef[] {\n  const refs: CellRef[] = [];\n  for (let row = rect.r0; row <= rect.r1; row++) {\n    for (let col = rect.c0; col <= rect.c1; col++) refs.push({ row, col });\n  }\n  return refs;\n}\n\n/** One whole column of a `rows`-high grid (row 0 = header). */\nexport function columnRect(rows: number, col: number): CellRect {\n  return { r0: 0, c0: col, r1: rows - 1, c1: col };\n}\n\n/** One whole row of a `cols`-wide grid. */\nexport function rowRect(cols: number, row: number): CellRect {\n  return { r0: row, c0: 0, r1: row, c1: cols - 1 };\n}\n\n/** The whole grid. */\nexport function tableRect(rows: number, cols: number): CellRect {\n  return { r0: 0, c0: 0, r1: rows - 1, c1: cols - 1 };\n}\n\nexport class CellSelectionController {\n  private sel: { tableFrom: number; rect: CellRect } | null = null;\n\n  set(view: EditorView, tableFrom: number, rect: CellRect): void {\n    this.unpaint(view);\n    this.sel = { tableFrom, rect };\n    for (const ref of refsIn(rect)) {\n      cellElement(view, tableFrom, ref)?.classList.add(SELECTED_CLASS);\n    }\n  }\n\n  get(): { tableFrom: number; rect: CellRect } | null {\n    return this.sel;\n  }\n\n  clear(view: EditorView): void {\n    this.unpaint(view);\n    this.sel = null;\n  }\n\n  /** The selected rectangle as TSV, resolved from the current document. */\n  tsv(view: EditorView): string | null {\n    const s = this.sel;\n    if (!s) return null;\n    const model = modelAt(view.state, s.tableFrom);\n    if (!model) return null;\n    const lines: string[] = [];\n    for (let row = s.rect.r0; row <= s.rect.r1; row++) {\n      const cells: string[] = [];\n      for (let col = s.rect.c0; col <= s.rect.c1; col++) {\n        const cell = cellAt(model, row, col);\n        cells.push(cell ? unescapePipes(view.state.sliceDoc(cell.from, cell.to)) : \"\");\n      }\n      lines.push(cells.join(\"\\t\"));\n    }\n    return lines.join(\"\\n\");\n  }\n\n  private unpaint(view: EditorView): void {\n    view.dom\n      .querySelectorAll(`.${SELECTED_CLASS}`)\n      .forEach((el) => el.classList.remove(SELECTED_CLASS));\n  }\n}\n"],"mappings":";;;AAYA,SAAS,cAAc;AACvB,SAAS,eAAe;AACxB,SAAuB,mBAAmB;AAC1C,SAAS,qBAAqB;AAGvB,MAAM,iBAAiB;AAUvB,SAAS,OAAO,GAAY,GAAsB;AACvD,SAAO;AAAA,IACL,IAAI,KAAK,IAAI,EAAE,KAAK,EAAE,GAAG;AAAA,IACzB,IAAI,KAAK,IAAI,EAAE,KAAK,EAAE,GAAG;AAAA,IACzB,IAAI,KAAK,IAAI,EAAE,KAAK,EAAE,GAAG;AAAA,IACzB,IAAI,KAAK,IAAI,EAAE,KAAK,EAAE,GAAG;AAAA,EAC3B;AACF;AAGO,SAAS,OAAO,MAA2B;AAChD,QAAM,OAAkB,CAAC;AACzB,WAAS,MAAM,KAAK,IAAI,OAAO,KAAK,IAAI,OAAO;AAC7C,aAAS,MAAM,KAAK,IAAI,OAAO,KAAK,IAAI,MAAO,MAAK,KAAK,EAAE,KAAK,IAAI,CAAC;AAAA,EACvE;AACA,SAAO;AACT;AAGO,SAAS,WAAW,MAAc,KAAuB;AAC9D,SAAO,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,OAAO,GAAG,IAAI,IAAI;AACjD;AAGO,SAAS,QAAQ,MAAc,KAAuB;AAC3D,SAAO,EAAE,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,OAAO,EAAE;AACjD;AAGO,SAAS,UAAU,MAAc,MAAwB;AAC9D,SAAO,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,OAAO,GAAG,IAAI,OAAO,EAAE;AACpD;AAEO,MAAM,wBAAwB;AAAA,EAA9B;AACL,wBAAQ,OAAoD;AAAA;AAAA,EAE5D,IAAI,MAAkB,WAAmB,MAAsB;AAC7D,SAAK,QAAQ,IAAI;AACjB,SAAK,MAAM,EAAE,WAAW,KAAK;AAC7B,eAAW,OAAO,OAAO,IAAI,GAAG;AAC9B,kBAAY,MAAM,WAAW,GAAG,GAAG,UAAU,IAAI,cAAc;AAAA,IACjE;AAAA,EACF;AAAA,EAEA,MAAoD;AAClD,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,MAAwB;AAC5B,SAAK,QAAQ,IAAI;AACjB,SAAK,MAAM;AAAA,EACb;AAAA;AAAA,EAGA,IAAI,MAAiC;AACnC,UAAM,IAAI,KAAK;AACf,QAAI,CAAC,EAAG,QAAO;AACf,UAAM,QAAQ,QAAQ,KAAK,OAAO,EAAE,SAAS;AAC7C,QAAI,CAAC,MAAO,QAAO;AACnB,UAAM,QAAkB,CAAC;AACzB,aAAS,MAAM,EAAE,KAAK,IAAI,OAAO,EAAE,KAAK,IAAI,OAAO;AACjD,YAAM,QAAkB,CAAC;AACzB,eAAS,MAAM,EAAE,KAAK,IAAI,OAAO,EAAE,KAAK,IAAI,OAAO;AACjD,cAAM,OAAO,OAAO,OAAO,KAAK,GAAG;AACnC,cAAM,KAAK,OAAO,cAAc,KAAK,MAAM,SAAS,KAAK,MAAM,KAAK,EAAE,CAAC,IAAI,EAAE;AAAA,MAC/E;AACA,YAAM,KAAK,MAAM,KAAK,GAAI,CAAC;AAAA,IAC7B;AACA,WAAO,MAAM,KAAK,IAAI;AAAA,EACxB;AAAA,EAEQ,QAAQ,MAAwB;AACtC,SAAK,IACF,iBAAiB,IAAI,cAAc,EAAE,EACrC,QAAQ,CAAC,OAAO,GAAG,UAAU,OAAO,cAAc,CAAC;AAAA,EACxD;AACF;","names":[]}

package/dist/codemirror/tablev2/tableV2Sync.d.ts

@@ -0,0 +1,13 @@
+import { Extension } from '@codemirror/state';
+import { CellEditingSurface } from './cellEditingSurface.js';
+import '@codemirror/view';
+
+/**
+ * Surface synchronisation for the V2 table (ADR 0001): after every document
+ * change the widget DOM has been patched or recreated — remap the surface's
+ * table anchor through the change, then let it re-attach the active edit.
+ */
+
+declare function tableV2Sync(surface: CellEditingSurface): Extension;
+
+export { tableV2Sync };

package/dist/codemirror/tablev2/tableV2Sync.js

@@ -0,0 +1,13 @@
+import "../../chunk-V6TY7KAL.js";
+import { EditorView } from "@codemirror/view";
+function tableV2Sync(surface) {
+  return EditorView.updateListener.of((update) => {
+    if (!update.docChanged) return;
+    surface.mapThrough(update.changes);
+    surface.reanchor(update.view);
+  });
+}
+export {
+  tableV2Sync
+};
+//# sourceMappingURL=tableV2Sync.js.map

package/dist/codemirror/tablev2/tableV2Sync.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/codemirror/tablev2/tableV2Sync.ts"],"sourcesContent":["/**\n * Surface synchronisation for the V2 table (ADR 0001): after every document\n * change the widget DOM has been patched or recreated — remap the surface's\n * table anchor through the change, then let it re-attach the active edit.\n */\n\nimport { EditorView } from \"@codemirror/view\";\nimport { type Extension } from \"@codemirror/state\";\n\nimport { type CellEditingSurface } from \"./cellEditingSurface\";\n\nexport function tableV2Sync(surface: CellEditingSurface): Extension {\n  return EditorView.updateListener.of((update) => {\n    if (!update.docChanged) return;\n    surface.mapThrough(update.changes);\n    surface.reanchor(update.view);\n  });\n}\n"],"mappings":";AAMA,SAAS,kBAAkB;AAKpB,SAAS,YAAY,SAAwC;AAClE,SAAO,WAAW,eAAe,GAAG,CAAC,WAAW;AAC9C,QAAI,CAAC,OAAO,WAAY;AACxB,YAAQ,WAAW,OAAO,OAAO;AACjC,YAAQ,SAAS,OAAO,IAAI;AAAA,EAC9B,CAAC;AACH;","names":[]}

package/dist/codemirror/tablev2/tableWidgetV2.d.ts

@@ -0,0 +1,46 @@
+import { Extension } from '@codemirror/state';
+import { WidgetType, EditorView } from '@codemirror/view';
+import { TableData } from '../table/tableModel.js';
+import { CellEditingSurface } from './cellEditingSurface.js';
+
+/**
+ * V2 table widget (ADR 0001): pure render, stable lifecycle, no editors inside.
+ *
+ * Lifecycle contract — the make-or-break constraint:
+ *   - `eq` compares source anchors + data, so ANY doc change (offsets shift)
+ *     makes CM consult `updateDOM`.
+ *   - `updateDOM` patches cell contents IN PLACE (element identity preserved)
+ *     and re-stamps the source anchor; it declines (→ full recreate) only when
+ *     the grid SHAPE changed.
+ *   - After either path, the tableV2 extension calls the active surface's
+ *     `reanchor` so an in-progress cell edit survives.
+ *
+ * Editing is delegated entirely to a {@link CellEditingSurface}; this file has
+ * no caret, focus, or selection logic by design.
+ */
+
+/**
+ * Wrap-aware height estimate for an unmeasured table. CM6 places everything
+ * below an unmeasured widget using this number; the previous one-line-per-row
+ * assumption under-estimated prose-heavy tables by 3-5×, so a fast scroll ran
+ * on geometry that was off by hundreds of px per table — and the correction,
+ * landing mid-interaction, yanked the viewport and re-anchored selections
+ * onto whatever content shifted under the pointer.
+ */
+declare function estimateTableHeight(data: TableData): number;
+declare class TableWidgetV2 extends WidgetType {
+    readonly data: TableData;
+    readonly sourceFrom: number;
+    readonly sourceTo: number;
+    private readonly heightEstimate;
+    constructor(data: TableData, sourceFrom: number, sourceTo: number);
+    eq(other: TableWidgetV2): boolean;
+    toDOM(view: EditorView): HTMLElement;
+    updateDOM(dom: HTMLElement, view: EditorView): boolean;
+    ignoreEvent(): boolean;
+    get estimatedHeight(): number;
+}
+/** The V2 table extension: widget field + surface synchronisation. */
+declare function tableV2(surface: CellEditingSurface): Extension;
+
+export { TableWidgetV2, estimateTableHeight, tableV2 };