@stll/folio-core 0.62.0 → 0.63.1

package/dist/controller/canonicalSession.js

@@ -1,7 +1,9 @@
 import { splitsGraphemeCluster, splitsSurrogatePair } from "../ai-edits/character-boundaries.js";
 import { rangedCommentIds, visitCommentMarkers } from "../docx/commentAnchorIndex.js";
 import { cloneDocumentWithParagraphPropertySources, copyDocumentParagraphPropertySourceContract, copyParagraphPropertySource, restoreParagraphIndentationProjection } from "../docx/paragraphPropertySource.js";
-import { canonicalContentPosition, canonicalSelectionRange } from "../prosemirror/canonicalSelectionRange.js";
+import { isCellMergeContinuation } from "../docx/tableParser.js";
+import { calculateRowSpans } from "../docx/verticalMergeProjection.js";
+import { canonicalCellSelectionRanges, canonicalContentPosition, canonicalSelectionRange } from "../prosemirror/canonicalSelectionRange.js";
 import { collectPairedBookmarkIds, footnoteToProseDoc, headerFooterToProseDoc, toProseDoc } from "../prosemirror/conversion/toProseDoc.js";
 import { markPackageChange } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
 import { runFormattingPatchFromMarks } from "../prosemirror/runFormattingFromMarks.js";
@@ -13,10 +15,12 @@ import { mapTocSelection } from "./canonicalTocSelection.js";
 import { Result, TaggedError, panic } from "better-result";
 import { hasIllegalXmlCharacters } from "@stll/docx-core";
 import { Fragment } from "prosemirror-model";
-import { DOCUMENT_OP_REFUSAL_REASONS, DOCUMENT_OP_TYPES, OP_STORIES, applyDocumentOps, combineEdits, commentDocumentIssue, compileEditorIntent, createEditorIntentIdAllocator, documentStories, editorParagraphGroups, findStoryBody, normalizeForOps, packageParagraphIds, sameStory, validateOpsDocument } from "@stll/docx-core/ops";
-import { AllSelection, NodeSelection, TextSelection } from "prosemirror-state";
+import { CellSelection } from "prosemirror-tables";
+import { DOCUMENT_OP_REFUSAL_REASONS, DOCUMENT_OP_TYPES, OP_STORIES, applyDocumentOp, applyDocumentOps, combineEdits, commentDocumentIssue, compileEditorIntent, createEditorIntentIdAllocator, documentStories, editorParagraphGroups, findStoryBody, normalizeForOps, packageParagraphIds, paragraphIdsIn, sameStory, survivingComments, validateOpsDocument } from "@stll/docx-core/ops";
+import { AllSelection, NodeSelection, Selection, TextSelection } from "prosemirror-state";
 //#region src/controller/canonicalSession.ts
-var CanonicalSessionError = class extends TaggedError("CanonicalSessionError") {};
+const CanonicalSessionErrorBase = TaggedError("CanonicalSessionError");
+var CanonicalSessionError = class extends CanonicalSessionErrorBase {};
 const refuse = (message) => Result.err(new CanonicalSessionError({
 	gap: CANONICAL_GAP.dispatch,
 	message,
@@ -190,7 +194,11 @@ var CanonicalProjection = class {
 		let anchorPosition = selection.anchor;
 		let headPosition = selection.head;
 		if (selection instanceof TextSelection) type = "text";
-		else if (selection instanceof NodeSelection && selection.node.isInline && selection.node.isAtom && selection.node.type.name !== "noteMarker") type = "inlineNode";
+		else if (selection instanceof CellSelection) {
+			type = "cell";
+			anchorPosition = Selection.atStart(selection.$anchorCell.nodeAfter ?? panic("Missing anchor cell")).from + selection.$anchorCell.pos + 1;
+			headPosition = Selection.atEnd(selection.$headCell.nodeAfter ?? panic("Missing head cell")).to + selection.$headCell.pos + 1;
+		} else if (selection instanceof NodeSelection && selection.node.isInline && selection.node.isAtom && selection.node.type.name !== "noteMarker") type = "inlineNode";
 		else if (selection instanceof AllSelection) {
 			type = "all";
 			const range = canonicalSelectionRange(state);
@@ -210,6 +218,13 @@ var CanonicalProjection = class {
 	paragraph(blockId) {
 		return this.paragraphsById.get(blockId);
 	}
+	nextParagraphInContainer(blockId) {
+		const index = this.paragraphs.findIndex((paragraph) => paragraph.blockId === blockId);
+		if (index < 0) return void 0;
+		const paragraph = this.paragraphs.at(index);
+		const next = this.paragraphs.at(index + 1);
+		return paragraph?.container === next?.container ? next : void 0;
+	}
 };
 /** Immutable operations retain content identities for every untouched story. */
 const changedStories = ({ document, previous }) => {
@@ -240,15 +255,28 @@ const changedStories = ({ document, previous }) => {
 	return stories;
 };
 const preservePropertySources = ({ target, source, stories = documentStories(source), indentation = "derive" }) => {
+	const collectParagraphs = (blocks) => {
+		const paragraphs = [];
+		for (const block of blocks) {
+			if (block.type === "paragraph") {
+				paragraphs.push(block);
+				continue;
+			}
+			if (block.type !== "table") continue;
+			for (const row of block.rows) for (const cell of row.cells) paragraphs.push(...collectParagraphs(cell.content));
+		}
+		return paragraphs;
+	};
 	for (const story of stories) {
 		const originals = findStoryBody(source, story)?.content ?? [];
 		const derived = findStoryBody(target, story)?.content ?? [];
 		if (originals === derived) continue;
-		const paragraphs = new Map(derived.flatMap((block) => block.type === "paragraph" ? [[block.paraId, block]] : []));
-		for (const [index, original] of originals.entries()) {
-			if (original.type !== "paragraph") continue;
-			const next = original.paraId === void 0 ? derived.at(index) : paragraphs.get(original.paraId);
-			if (next?.type === "paragraph" && next !== original) {
+		const originalParagraphs = collectParagraphs(originals);
+		const derivedParagraphs = collectParagraphs(derived);
+		const paragraphs = new Map(derivedParagraphs.flatMap((paragraph) => paragraph.paraId === void 0 ? [] : [[paragraph.paraId, paragraph]]));
+		for (const [index, original] of originalParagraphs.entries()) {
+			const next = original.paraId === void 0 ? derivedParagraphs.at(index) : paragraphs.get(original.paraId);
+			if (next !== void 0 && next !== original) {
 				copyParagraphPropertySource(next, original);
 				if (indentation === "restore") restoreParagraphIndentationProjection({
 					target: next,
@@ -270,8 +298,25 @@ const unsupportedSeedReason = (document, stories = documentStories(document)) =>
 		}
 		const content = body?.content;
 		if (!content || content.length === 0) return "Canonical sessions require a nonempty paragraph story.";
-		for (const paragraph of content) {
-			if (paragraph.type !== "paragraph" || paragraph.reviewCarrier !== void 0) return "Canonical sessions currently require plain paragraphs and supported inline atoms.";
+		const paragraphs = [];
+		const collect = (blocks) => {
+			for (const block of blocks) {
+				if (block.type === "paragraph") {
+					paragraphs.push(block);
+					continue;
+				}
+				if (block.type !== "table") return "Canonical sessions currently require paragraphs, tables and supported inline atoms.";
+				for (const row of block.rows) for (const cell of row.cells) {
+					const issue = collect(cell.content);
+					if (issue !== null) return issue;
+				}
+			}
+			return null;
+		};
+		const blockIssue = collect(content);
+		if (blockIssue !== null) return blockIssue;
+		for (const paragraph of paragraphs) {
+			if (paragraph.reviewCarrier !== void 0) return "Canonical sessions currently require plain paragraphs and supported inline atoms.";
 			const issue = canonicalInlineSourceIssue(paragraph.content);
 			if (issue !== null) return issue;
 		}
@@ -308,20 +353,51 @@ const project = ({ document, styles, story = OP_STORIES.MAIN }) => {
 	visitCommentMarkers(body.content, ({ item }) => {
 		if (item.type === "commentReference" && !commentContext.rangedIds.has(item.id)) commentContext.pointIds.add(item.id);
 	});
+	const sources = /* @__PURE__ */ new Map();
+	const allSources = /* @__PURE__ */ new Set();
+	const continuationSources = /* @__PURE__ */ new Set();
+	const collectSources = (blocks, insideSkippedContinuation = false) => {
+		for (const block of blocks) {
+			if (block.type === "paragraph") {
+				allSources.add(block);
+				if (insideSkippedContinuation) continuationSources.add(block);
+				if (block.paraId !== void 0) sources.set(block.paraId, {
+					source: block,
+					container: blocks
+				});
+				continue;
+			}
+			if (block.type !== "table") continue;
+			const rowSpans = calculateRowSpans(block);
+			for (const [rowIndex, row] of block.rows.entries()) {
+				let column = row.formatting?.gridBefore ?? 0;
+				for (const cell of row.cells) {
+					const skippedContinuation = isCellMergeContinuation(cell) && (rowSpans.get(`${rowIndex}-${column}`)?.skip ?? false);
+					collectSources(cell.content, insideSkippedContinuation || skippedContinuation);
+					column += cell.formatting?.gridSpan ?? 1;
+				}
+			}
+		}
+	};
+	collectSources(body.content);
 	const paragraphs = [];
+	const projectedSources = /* @__PURE__ */ new Set();
 	let failure;
-	converted.value.forEach((node, offset, index) => {
+	converted.value.descendants((node, offset) => {
 		if (failure !== void 0) return;
-		const source = body.content.at(index);
-		if (source?.type !== "paragraph" || source.paraId === void 0) {
+		if (node.type.name !== "paragraph") return;
+		const paraId = node.attrs["paraId"];
+		const located = typeof paraId === "string" ? sources.get(paraId) : void 0;
+		if (typeof paraId !== "string" || located === void 0) {
 			failure = new CanonicalSessionError({
-				gap: CANONICAL_GAP.dispatch,
+				gap: CANONICAL_GAP.storyContentProjection,
 				reason: "refused",
 				message: "The projection changed paragraph structure."
 			});
 			return;
 		}
-		if (node.type.name !== "paragraph" || node.attrs["paraId"] !== source.paraId) {
+		const { source, container } = located;
+		if (projectedSources.has(source)) {
 			failure = new CanonicalSessionError({
 				gap: CANONICAL_GAP.storyContentProjection,
 				reason: "refused",
@@ -329,6 +405,7 @@ const project = ({ document, styles, story = OP_STORIES.MAIN }) => {
 			});
 			return;
 		}
+		projectedSources.add(source);
 		const inline = projectCanonicalInline({
 			source,
 			paragraph: node,
@@ -344,7 +421,8 @@ const project = ({ document, styles, story = OP_STORIES.MAIN }) => {
 			return;
 		}
 		paragraphs.push({
-			blockId: source.paraId,
+			blockId: paraId,
+			container,
 			start: offset + 1,
 			...inline.value,
 			node,
@@ -356,7 +434,7 @@ const project = ({ document, styles, story = OP_STORIES.MAIN }) => {
 		});
 	});
 	if (failure !== void 0) return Result.err(failure);
-	if (paragraphs.length !== body.content.length) return refuse("The projection changed paragraph structure.");
+	if (projectedSources.size + continuationSources.size !== allSources.size || [...projectedSources].some((source) => continuationSources.has(source))) return refuse("The projection changed paragraph structure.");
 	return Result.ok(new CanonicalProjection({
 		doc: converted.value,
 		paragraphs,
@@ -464,7 +542,7 @@ var CanonicalSession = class {
 	}
 	/** Render only the committed comment projection while provisional IME blocks document snapshots. */
 	getCommittedComments() {
-		return structuredClone(this.currentDocument.package.document.comments ?? []);
+		return structuredClone(survivingComments(this.currentDocument));
 	}
 	setMode(mode) {
 		if (this.mode.type !== mode.type || this.mode.type === "suggesting" && mode.type === "suggesting" && this.mode.author !== mode.author) this.breakUndoGroup();
@@ -483,6 +561,27 @@ var CanonicalSession = class {
 		if (this.nextBlockId > 2147483647) return refuse("The paragraph identity space is exhausted.");
 		return Result.ok(this.nextBlockId.toString(16).padStart(8, "0").toUpperCase());
 	}
+	/**
+	* Paragraph identities for one prepared batch, one group per requested count;
+	* none matches a live or retired identity and no two groups overlap. Nothing is
+	* reserved until the batch applies, so a batch asks once for all its groups.
+	*/
+	freshBlockIds(counts) {
+		const total = counts.reduce((sum, count) => sum + count, 0);
+		const ids = [];
+		for (let candidate = this.nextBlockId; ids.length < total; candidate += 1) {
+			if (candidate > 2147483647) return refuse("The paragraph identity space is exhausted.");
+			const id = candidate.toString(16).padStart(8, "0").toUpperCase();
+			if (!this.allocatedBlockIds.has(id)) ids.push(id);
+		}
+		const groups = [];
+		let offset = 0;
+		for (const count of counts) {
+			groups.push(ids.slice(offset, offset + count));
+			offset += count;
+		}
+		return Result.ok(groups);
+	}
 	intentMode(document, intent) {
 		if (this.mode.type === "editing" && !this.intentNeedsIdentityIds(document, intent)) return {
 			type: "editing",
@@ -613,10 +712,31 @@ var CanonicalSession = class {
 		if (!Number.isFinite(time)) return refuse("The input time is invalid.");
 		if (from > to || hasIllegalXmlCharacters(text) || /[\t\r\n]/u.test(text)) return refuse("Canonical input accepts a well-formed text replacement.");
 		if (from === to && text.length === 0) return noChange("The input makes no text change.");
-		const replacesAll = state.selection instanceof AllSelection && from === state.selection.from && to === state.selection.to;
+		const replacesStructuralSelection = state.selection instanceof AllSelection && from === state.selection.from && to === state.selection.to;
+		if (state.selection instanceof CellSelection) {
+			if (from !== state.selection.from || to !== state.selection.to) return refuse("A replacement range cannot partially address a cell selection.");
+			if (text.length > 0) return refuse("Replacing a cell selection requires a per-cell replacement.");
+			const intents = [];
+			for (const range of canonicalCellSelectionRanges(state.selection)) {
+				const cellFrom = projection.inputAddressAt(range.from);
+				if (cellFrom.isErr()) return cellFrom;
+				const cellTo = projection.inputAddressAt(range.to);
+				if (cellTo.isErr()) return cellTo;
+				intents.push({
+					type: "replaceText",
+					from: cellFrom.value,
+					to: cellTo.value,
+					text: ""
+				});
+			}
+			return this.prepareIntents(state, {
+				intents,
+				semantic
+			});
+		}
 		const range = canonicalSelectionRange(state);
-		const inputFrom = replacesAll ? range.from : from;
-		const inputTo = replacesAll ? range.to : to;
+		const inputFrom = replacesStructuralSelection ? range.from : from;
+		const inputTo = replacesStructuralSelection ? range.to : to;
 		const start = projection.inputAddressAt(inputFrom);
 		if (start.isErr()) return start;
 		const end = projection.inputAddressAt(inputTo);
@@ -634,7 +754,7 @@ var CanonicalSession = class {
 			intent,
 			mode: this.intentMode(this.currentDocument, intent)
 		});
-		if (compiled.isErr()) return refuse(compiled.error.message);
+		if (compiled.isErr()) return compiled.error.reason === DOCUMENT_OP_REFUSAL_REASONS.NO_CHANGE ? noChange(compiled.error.message) : refuse(compiled.error.message);
 		const { ops, selection: caret } = compiled.value;
 		const postSelection = {
 			type: "text",
@@ -718,6 +838,7 @@ var CanonicalSession = class {
 				firstBlockId: this.nextBlockId
 			});
 			if (compiled.isErr()) {
+				if (compiled.error.reason === DOCUMENT_OP_REFUSAL_REASONS.NO_CHANGE) return noChange(compiled.error.message);
 				if (compiled.error.reason === DOCUMENT_OP_REFUSAL_REASONS.UNTRACKABLE && (intent.type === "setHyperlink" || intent.type === "removeHyperlink" || intent.type === "insertHyperlink")) return Result.err(new CanonicalSessionError({
 					gap: CANONICAL_GAP.trackedHyperlinkResolution,
 					reason: "refused",
@@ -726,7 +847,7 @@ var CanonicalSession = class {
 				return refuse(compiled.error.message);
 			}
 			const applied = applyDocumentOps(document, compiled.value.ops);
-			if (applied.isErr()) return refuse(applied.error.message);
+			if (applied.isErr()) return applied.error.reason === DOCUMENT_OP_REFUSAL_REASONS.NO_CHANGE ? noChange(applied.error.message) : refuse(applied.error.message);
 			document = applied.value.document;
 			edits.push(applied.value);
 			ops.push(...compiled.value.ops);
@@ -845,7 +966,9 @@ var CanonicalSession = class {
 		const first = firstGroup?.paragraphs.at(-1);
 		const second = secondGroup?.paragraphs.at(0);
 		if (!first?.paraId || !second?.paraId) return noChange("There is no adjacent paragraph to join.");
-		if (!isCanonicalJoinBoundary(state, direction)) return refuse("Join requires a caret at a paragraph boundary.");
+		if (this.projection.paragraph(first.paraId)?.container !== this.projection.paragraph(second.paraId)?.container) return noChange("There is no adjacent paragraph to join.");
+		const current = this.projection.paragraph(at.value.blockId);
+		if (current === void 0 || at.value.offset !== (direction === "backward" ? 0 : current.text.length)) return refuse("Join requires a caret at a paragraph boundary.");
 		return this.prepareIntent(state, {
 			type: "joinParagraphs",
 			story: at.value.story,
@@ -919,20 +1042,78 @@ var CanonicalSession = class {
 		if (ops.length === 0) return refuse("The operation batch is empty.");
 		const selected = this.projection.selectionAt(state);
 		if (selected.isErr()) return selected;
+		let preparedOps = ops;
+		if (ops.every((op) => op.type === DOCUMENT_OP_TYPES.ADD_NOTE || op.type === DOCUMENT_OP_TYPES.REMOVE_NOTE)) {
+			const tracked = [];
+			let document = this.currentDocument;
+			for (const op of ops) {
+				if (op.type !== DOCUMENT_OP_TYPES.ADD_NOTE && op.type !== DOCUMENT_OP_TYPES.REMOVE_NOTE) panic("A note operation batch contains only note operations.");
+				const allocation = this.allocateIntentIds(document, {
+					type: "replaceFragment",
+					from: {
+						...op.at,
+						offset: 0
+					},
+					to: {
+						...op.at,
+						offset: Number.MAX_SAFE_INTEGER
+					},
+					paragraphs: [{
+						type: "paragraph",
+						content: [{
+							type: "run",
+							content: [{
+								type: "break",
+								breakType: "page"
+							}]
+						}]
+					}],
+					openStart: 0,
+					openEnd: 0
+				});
+				const next = {
+					...op,
+					...this.mode.type === "suggesting" ? { revision: {
+						id: allocation.revisionId,
+						author: this.mode.author,
+						date: (/* @__PURE__ */ new Date()).toISOString()
+					} } : {},
+					newIds: allocation.newIds
+				};
+				if (ops.length > 1) {
+					const applied = applyDocumentOp(cloneDocumentWithParagraphPropertySources(document), structuredClone(next));
+					if (applied.isErr()) return refuse(applied.error.message);
+					document = applied.value.document;
+				}
+				tracked.push(next);
+			}
+			preparedOps = tracked;
+		}
+		const addedNotes = preparedOps.filter((op) => op.type === DOCUMENT_OP_TYPES.ADD_NOTE);
+		const atSelection = addedNotes.find(({ at }) => [selected.value.anchor, selected.value.head].some((end) => sameStory(at.story, end.story) && at.blockId === end.blockId && at.offset === end.offset));
+		const caret = atSelection === void 0 ? void 0 : {
+			...atSelection.at,
+			offset: atSelection.at.offset + addedNotes.filter(({ at }) => sameStory(at.story, atSelection.at.story) && at.blockId === atSelection.at.blockId && at.offset <= atSelection.at.offset).length
+		};
+		const postSelection = addedNotes.length === preparedOps.length && caret !== void 0 ? {
+			type: "text",
+			anchor: caret,
+			head: caret
+		} : selected.value;
 		const preDocument = this.currentDocument;
 		return this.stage({
 			state,
-			ops,
-			selection: selected.value,
+			ops: preparedOps,
+			selection: postSelection,
 			origin: "input",
 			onPublish: (inverse, version) => {
 				this.applied.push({
 					entries: [{
 						type: "applied",
-						ops,
+						ops: preparedOps,
 						inverse,
 						preSelection: selected.value,
-						postSelection: selected.value,
+						postSelection,
 						preDocument,
 						postDocument: this.currentDocument,
 						version,
@@ -944,7 +1125,7 @@ var CanonicalSession = class {
 					}],
 					undo: { type: "entries" },
 					preSelection: selected.value,
-					postSelection: selected.value
+					postSelection
 				});
 				this.undone.length = 0;
 			}
@@ -1116,7 +1297,10 @@ var CanonicalSession = class {
 				if (this.version !== baseVersion) return refuse("The staged canonical commit is stale.");
 				if (!isCanonicalProjectionTransaction(transaction, this)) return refuse("The staged canonical projection was changed after preparation.");
 				for (const blockId of applied.value.touched.inserted) this.allocatedBlockIds.add(blockId.toUpperCase());
-				for (const op of ops) if (op.type === DOCUMENT_OP_TYPES.SPLIT_BLOCK) this.allocatedBlockIds.add(op.newBlockId.toUpperCase());
+				for (const op of ops) {
+					if (op.type === DOCUMENT_OP_TYPES.SPLIT_BLOCK) this.allocatedBlockIds.add(op.newBlockId.toUpperCase());
+					if (op.type === DOCUMENT_OP_TYPES.ADD_NOTE) for (const blockId of paragraphIdsIn(op.note.content)) this.allocatedBlockIds.add(blockId.toUpperCase());
+				}
 				this.advanceBlockId();
 				this.rememberSources(applied.value.document);
 				if (projectedStory !== OP_STORIES.MAIN) {
@@ -1146,11 +1330,6 @@ var CanonicalSession = class {
 	}
 };
 const createCanonicalSession = (document, styles) => {
-	if (documentStories(document).some((story) => findStoryBody(document, story)?.content.some((block) => block.type === "table"))) return Result.err(new CanonicalSessionError({
-		gap: CANONICAL_GAP.tableActivation,
-		reason: "refused",
-		message: "Canonical sessions cannot activate documents containing tables."
-	}));
 	const unsupported = unsupportedSeedReason(document);
 	if (unsupported !== null) return refuse(unsupported);
 	const owned = cloneDocumentWithParagraphPropertySources(document);
@@ -1184,17 +1363,22 @@ const hasDeletedParagraphMark = (node) => {
 /** Visible graphemes concatenate across retained deletions and deleted paragraph marks. */
 const visibleDeletionContext = (state) => {
 	const { selection } = state;
-	const index = selection.$from.index(0);
+	const paragraphDepth = selection.$from.depth;
+	const containerDepth = paragraphDepth - 1;
+	if (containerDepth < 0 || selection.$from.node(paragraphDepth).type.name !== "paragraph") return refuse("Canonical deletion requires a caret inside a paragraph.");
+	const container = selection.$from.node(containerDepth);
+	const containerStart = selection.$from.start(containerDepth);
+	const index = selection.$from.index(containerDepth);
 	let first = index;
-	while (first > 0 && hasDeletedParagraphMark(state.doc.child(first - 1))) first -= 1;
+	while (first > 0 && hasDeletedParagraphMark(container.child(first - 1))) first -= 1;
 	let last = index;
-	while (last + 1 < state.doc.childCount && hasDeletedParagraphMark(state.doc.child(last))) last += 1;
+	while (last + 1 < container.childCount && hasDeletedParagraphMark(container.child(last))) last += 1;
 	let text = "";
 	const physicalStarts = [];
 	const physicalEnds = [];
 	let visibleOffset = 0;
 	let issue;
-	state.doc.forEach((paragraph, paragraphOffset, paragraphIndex) => {
+	container.forEach((paragraph, paragraphOffset, paragraphIndex) => {
 		if (paragraphIndex < first || paragraphIndex > last) return;
 		const native = canonicalNativeCells(paragraph);
 		if (native.isErr()) {
@@ -1208,8 +1392,8 @@ const visibleDeletionContext = (state) => {
 		for (const cell of native.value) {
 			if (cell.type === "zeroWidth" || cell.node.marks.some((mark) => mark.type.name === "deletion")) continue;
 			const value = cell.type === "text" ? cell.text : "";
-			const from = paragraphOffset + 1 + cell.from;
-			const to = paragraphOffset + 1 + cell.to;
+			const from = containerStart + paragraphOffset + 1 + cell.from;
+			const to = containerStart + paragraphOffset + 1 + cell.to;
 			if (cell.type !== "text" && selection.from > from && selection.from < to) {
 				issue = new CanonicalSessionError({
 					gap: CANONICAL_GAP.dispatch,
@@ -1248,6 +1432,10 @@ const deletionRange = (state, direction) => {
 		from: selection.from,
 		to: selection.to
 	});
+	if (selection instanceof CellSelection) return Result.ok({
+		from: selection.from,
+		to: selection.to
+	});
 	if (selection instanceof AllSelection) return Result.ok(canonicalSelectionRange(state));
 	if (!(selection instanceof TextSelection)) return refuse("Canonical deletion requires text, an inline atom, or the whole document selection.");
 	if (!selection.empty) return Result.ok({

package/dist/controller/canonicalStoryEditor.d.ts

@@ -13,7 +13,7 @@ type CanonicalStoryEditorOptions = {
   onRefusal: ((reason: string, gap: CanonicalGap) => void) | undefined;
 };
 /** Secondary views compile classified native input into the shared Document journal. */
-declare const createCanonicalStoryEditor: ({ story, getView, getApi, enabled, onRefusal, onSelectionChange }: CanonicalStoryEditorOptions) => {
+export declare const createCanonicalStoryEditor: ({ story, getView, getApi, enabled, onRefusal, onSelectionChange }: CanonicalStoryEditorOptions) => {
   dispatch: (transaction: Transaction) => boolean;
   props: {
     handleKeyDown: (view: EditorView, event: KeyboardEvent) => boolean;
@@ -35,4 +35,4 @@ declare const createCanonicalStoryEditor: ({ story, getView, getApi, enabled, on
   };
 };
 //#endregion
-export { createCanonicalStoryEditor };
+export {};

package/dist/controller/canonicalStructure.d.ts

@@ -4,13 +4,13 @@ import { EditorState } from "prosemirror-state";
 import { Result } from "better-result";
 //#region src/controller/canonicalStructure.d.ts
 /** Toolbar meanings enter the same operation journal as native input. */
-declare const prepareCanonicalCommands: (session: CanonicalSession, state: EditorState, commands: readonly CanonicalCommandIntent[]) => Result<CanonicalCommit, CanonicalSessionError>;
+export declare const prepareCanonicalCommands: (session: CanonicalSession, state: EditorState, commands: readonly CanonicalCommandIntent[]) => Result<CanonicalCommit, CanonicalSessionError>;
 type CanonicalAutoformatInput = {
   from: number;
   to: number;
   text: string;
 };
 /** Rules compile their replacement and paragraph change as one atomic edit. */
-declare const prepareCanonicalAutoformat: (session: CanonicalSession, state: EditorState, { from, to, text }: CanonicalAutoformatInput) => Result<CanonicalCommit, CanonicalSessionError> | undefined;
+export declare const prepareCanonicalAutoformat: (session: CanonicalSession, state: EditorState, { from, to, text }: CanonicalAutoformatInput) => Result<CanonicalCommit, CanonicalSessionError> | undefined;
 //#endregion
-export { prepareCanonicalAutoformat, prepareCanonicalCommands };
+export {};