@stll/folio-core 0.55.0 → 0.57.0

package/dist/controller/hiddenEditorManager.js

@@ -2,24 +2,34 @@ import { recordHiddenEditorPhase, recordHiddenEditorStateCreate } from "../layou
 import { suppressHiddenEditorScrollToSelection } from "../paged-layout/hiddenEditorScroll.js";
 import { isReadOnlyEditKey } from "../paged-layout/readOnlyEditAttempt.js";
 import { getCanonicalCommandIntents } from "../prosemirror/canonicalCommands.js";
+import { registerClipboardIntentHandler } from "../prosemirror/clipboardIntent.js";
+import { pasteWithoutFormatting } from "../prosemirror/commands/pastePlainText.js";
 import { createEmptyDoc, toProseDoc } from "../prosemirror/conversion/toProseDoc.js";
 import { registerEditorCommandOwner } from "../prosemirror/executeEditorCommand.js";
 import { ensureBaseDirectionInState } from "../prosemirror/extensions/features/AutoBidiDetectionExtension.js";
 import { ensureParaIdsInDoc, ensureParaIdsInState } from "../prosemirror/extensions/features/ParaIdAllocatorExtension.js";
 import { createParagraphChangeTrackerPlugin, markPackageChange } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
 import { toggleMarkForAllScripts, toggleUnderlineMark } from "../prosemirror/extensions/marks/markUtils.js";
+import { HyperlinkRemovalRefusal } from "../prosemirror/hyperlinkRemoval.js";
+import { markNoteReferenceReplay, noteReferenceTransactionIssue } from "../prosemirror/noteReferenceOccurrences.js";
 import { createDocumentNumberingPlugin } from "../prosemirror/plugins/documentNumbering.js";
-import { createDocumentStylesPlugin } from "../prosemirror/plugins/documentStyles.js";
+import { createDocumentStyleContextPlugin, createDocumentStylesPlugin } from "../prosemirror/plugins/documentStyles.js";
 import { schema } from "../prosemirror/schema/index.js";
 import { createTextInputPlugin } from "../prosemirror/textInput.js";
 import { applyAttrSchemaMigrations, proseDocumentParagraphSourceContract, readYjsAttrSchemaVersion, readYjsParagraphSourceContract, withParagraphSourceContract, writeYjsDocumentMetadata } from "../prosemirror/yjsDocumentMetadata.js";
+import { CANONICAL_GAP, usesCanonicalSession } from "../types/canonicalCapabilities.js";
+import { prepareCanonicalPaste } from "./canonicalClipboard.js";
+import { canonicalCommentBody, compileCanonicalComments } from "./canonicalComments.js";
 import { createCanonicalInputBoundary } from "./canonicalInput.js";
+import { createCanonicalSectionPropertiesOperation } from "./canonicalOperations.js";
+import { CanonicalPublicOperations } from "./canonicalPublicOperations.js";
+import { restoreCanonicalSelection } from "./canonicalSelection.js";
 import { createCanonicalSession, publishCanonicalProjection } from "./canonicalSession.js";
 import { prepareCanonicalAutoformat, prepareCanonicalCommands } from "./canonicalStructure.js";
 import { createHiddenEditorApi } from "./hiddenEditorApi.js";
 import { Result, TaggedError, panic } from "better-result";
-import { OP_STORIES } from "@stll/docx-core/ops";
-import { EditorState } from "prosemirror-state";
+import { OP_STORIES, freshCommentId } from "@stll/docx-core/ops";
+import { EditorState, Plugin } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
 //#region src/controller/hiddenEditorManager.ts
 var CanonicalSessionRefusalError = class extends TaggedError("CanonicalSessionRefusalError") {};
@@ -201,6 +211,7 @@ const createHiddenEditorManager = (deps) => {
 	let view = null;
 	let releaseCommandOwner;
 	let editorSession = { type: "prosemirror" };
+	let canonicalSessionEpoch = 0;
 	let modeOverride = null;
 	const syncCanonicalMode = () => {
 		if (editorSession.type !== "canonical") return;
@@ -209,12 +220,16 @@ const createHiddenEditorManager = (deps) => {
 			author: deps.getSuggestionAuthor?.() ?? "User"
 		} : { type: "editing" }));
 	};
-	const refuse = (reason) => {
-		if (deps.onSessionRefusal) deps.onSessionRefusal(reason);
-		else throw new CanonicalSessionRefusalError({ message: reason });
+	const refuse = (reason, gap = CANONICAL_GAP.dispatch) => {
+		const message = reason;
+		if (deps.onSessionRefusal) deps.onSessionRefusal(message, gap);
+		else throw new CanonicalSessionRefusalError({
+			gap,
+			message
+		});
 	};
 	const seedSession = (document) => {
-		if (deps.getExperimentalSession?.() !== "canonical") {
+		if (!usesCanonicalSession(deps.getExperimentalSession?.(), CANONICAL_GAP.authorityRouting)) {
 			editorSession = { type: "prosemirror" };
 			return true;
 		}
@@ -227,7 +242,7 @@ const createHiddenEditorManager = (deps) => {
 				reason,
 				documentIdentity
 			};
-			refuse(reason);
+			refuse(reason, CANONICAL_GAP.collaboration);
 			return false;
 		}
 		const result = createCanonicalSession(document, deps.getStyles());
@@ -237,13 +252,14 @@ const createHiddenEditorManager = (deps) => {
 				reason: result.error.message,
 				documentIdentity
 			};
-			refuse(result.error.message);
+			refuse(result.error.message, result.error.gap);
 			return false;
 		}
 		editorSession = {
 			type: "canonical",
 			session: result.value
 		};
+		canonicalSessionEpoch += 1;
 		modeOverride = null;
 		syncCanonicalMode();
 		return true;
@@ -252,11 +268,17 @@ const createHiddenEditorManager = (deps) => {
 		doc: session.projection.doc,
 		plugins: [
 			createParagraphChangeTrackerPlugin(),
-			createDocumentStylesPlugin(deps.getStyles() ?? session.document.package.styles),
-			createDocumentNumberingPlugin(session.document.package.numbering)
+			createDocumentStyleContextPlugin(deps.getStyles() ?? session.document.package.styles),
+			createDocumentNumberingPlugin(session.document.package.numbering),
+			...[...deps.getExtensionManager()?.getPlugins() ?? [], ...deps.getExternalPlugins()].flatMap(({ props }) => props.transformPastedHTML === void 0 && props.transformPasted === void 0 && props.transformCopied === void 0 && props.clipboardTextSerializer === void 0 ? [] : [new Plugin({ props: {
+				...props.transformCopied === void 0 ? {} : { transformCopied: props.transformCopied },
+				...props.clipboardTextSerializer === void 0 ? {} : { clipboardTextSerializer: props.clipboardTextSerializer },
+				...props.transformPastedHTML === void 0 ? {} : { transformPastedHTML: props.transformPastedHTML },
+				...props.transformPasted === void 0 ? {} : { transformPasted: props.transformPasted }
+			} })])
 		]
 	});
-	const publishCommit = (commit) => {
+	const publishCommit = (commit, reportRefusal = refuse) => {
 		if (!view || deps.getReadOnly() || editorSession.type !== "canonical") return false;
 		const session = editorSession.session;
 		const result = publishCanonicalProjection({
@@ -265,7 +287,7 @@ const createHiddenEditorManager = (deps) => {
 			session
 		});
 		if (result.isErr()) {
-			refuse(result.error.message);
+			reportRefusal(result.error.message, result.error.gap);
 			return false;
 		}
 		const staged = result.value;
@@ -284,7 +306,7 @@ const createHiddenEditorManager = (deps) => {
 		if (direction === "undo" ? !session.canUndo : !session.canRedo) return false;
 		const prepared = direction === "undo" ? session.prepareUndo(view.state) : session.prepareRedo(view.state);
 		if (prepared.isErr()) {
-			if (prepared.error.reason !== "noChange") refuse(prepared.error.message);
+			if (prepared.error.reason !== "noChange") refuse(prepared.error.message, prepared.error.gap);
 			return false;
 		}
 		return publishCommit(prepared.value);
@@ -292,11 +314,26 @@ const createHiddenEditorManager = (deps) => {
 	const executeCanonicalCommand = (command) => {
 		if (!view || editorSession.type !== "canonical") return void 0;
 		if (deps.getReadOnly()) return false;
+		if (command === pasteWithoutFormatting) return command(view.state, (transaction) => view?.dispatch(transaction), view);
 		if (editorSession.session.isComposing) {
 			refuse("Composition must finish before formatting.");
 			return false;
 		}
-		const intents = getCanonicalCommandIntents(command, view.state);
+		const commandState = view.state;
+		const described = Result.try({
+			try: () => getCanonicalCommandIntents(command, commandState),
+			catch: (error) => error
+		});
+		if (described.isErr()) {
+			if (!(described.error instanceof HyperlinkRemovalRefusal)) throw described.error;
+			const refusal = new CanonicalSessionRefusalError({
+				gap: CANONICAL_GAP.commands,
+				message: described.error.message
+			});
+			refuse(refusal.message, refusal.gap);
+			return false;
+		}
+		const intents = described.value;
 		if (intents === void 0) return void 0;
 		syncCanonicalMode();
 		editorSession.session.breakUndoGroup();
@@ -305,11 +342,12 @@ const createHiddenEditorManager = (deps) => {
 		}, view);
 		const prepared = prepareCanonicalCommands(editorSession.session, view.state, intents);
 		if (prepared.isErr()) {
-			if (prepared.error.reason !== "noChange") refuse(prepared.error.message);
+			if (prepared.error.reason !== "noChange") refuse(prepared.error.message, prepared.error.gap);
 			return false;
 		}
 		return publishCommit(prepared.value);
 	};
+	let clipboardDrag = { type: "idle" };
 	let lastInputRule;
 	const canonicalStructuralInput = {
 		command: (name) => {
@@ -324,7 +362,7 @@ const createHiddenEditorManager = (deps) => {
 				if (mark !== void 0) command = name === "toggleUnderline" ? toggleUnderlineMark(mark) : toggleMarkForAllScripts(mark, name === "toggleBold" ? "bold" : "italic");
 			}
 			if (command === void 0) {
-				refuse("The formatting command is unavailable.");
+				refuse("The formatting command is unavailable.", CANONICAL_GAP.commands);
 				return;
 			}
 			if (executeCanonicalCommand(command) === void 0) command(view.state, (transaction) => view?.dispatch(transaction), view);
@@ -336,7 +374,7 @@ const createHiddenEditorManager = (deps) => {
 			const state = view.state;
 			const selection = session.projection.selectionAt(state);
 			if (selection.isErr()) {
-				refuse(selection.error.message);
+				refuse(selection.error.message, selection.error.gap);
 				return;
 			}
 			let prepared;
@@ -386,11 +424,11 @@ const createHiddenEditorManager = (deps) => {
 					const from = session.projection.addressAt(state.selection.from);
 					const to = session.projection.addressAt(state.selection.to);
 					if (from.isErr()) {
-						refuse(from.error.message);
+						refuse(from.error.message, from.error.gap);
 						return;
 					}
 					if (to.isErr()) {
-						refuse(to.error.message);
+						refuse(to.error.message, to.error.gap);
 						return;
 					}
 					prepared = session.prepareIntent(state, {
@@ -407,7 +445,7 @@ const createHiddenEditorManager = (deps) => {
 				default: return type;
 			}
 			if (prepared.isErr()) {
-				if (prepared.error.reason !== "noChange") refuse(prepared.error.message);
+				if (prepared.error.reason !== "noChange") refuse(prepared.error.message, prepared.error.gap);
 				return;
 			}
 			publishCommit(prepared.value);
@@ -421,7 +459,7 @@ const createHiddenEditorManager = (deps) => {
 			if (deps.getReadOnly() || editorSession.type !== "canonical") return false;
 			const begun = editorSession.session.beginComposition();
 			if (begun.isErr()) {
-				refuse(begun.error.message);
+				refuse(begun.error.message, begun.error.gap);
 				return false;
 			}
 			return true;
@@ -431,6 +469,52 @@ const createHiddenEditorManager = (deps) => {
 		}
 	};
 	const input = createCanonicalInputBoundary({
+		pastePlainText: (pmView) => {
+			if (deps.getReadOnly()) {
+				deps.onReadOnlyEditAttempt();
+				return;
+			}
+			pasteWithoutFormatting(pmView.state, (transaction) => pmView.dispatch(transaction), pmView);
+		},
+		cut: (pmView, event) => {
+			event.preventDefault();
+			if (deps.getReadOnly()) {
+				deps.onReadOnlyEditAttempt();
+				return true;
+			}
+			if (editorSession.type !== "canonical" || pmView.state.selection.empty) return true;
+			if (event.clipboardData === null) {
+				refuse("The clipboard cannot receive the cut content.");
+				return true;
+			}
+			syncCanonicalMode();
+			const session = editorSession.session;
+			const { from, to } = pmView.state.selection;
+			const prepared = session.prepareReplace(pmView.state, {
+				from,
+				to,
+				text: "",
+				semantic: "replacement"
+			});
+			if (prepared.isErr()) {
+				refuse(prepared.error.message, prepared.error.gap);
+				return true;
+			}
+			const copied = Result.try({
+				try: () => {
+					const serialized = pmView.serializeForClipboard(pmView.state.selection.content());
+					event.clipboardData?.setData("text/html", serialized.dom.innerHTML);
+					event.clipboardData?.setData("text/plain", serialized.text);
+				},
+				catch: () => new CanonicalSessionRefusalError({
+					gap: CANONICAL_GAP.dispatch,
+					message: "The clipboard could not receive the cut content."
+				})
+			});
+			if (copied.isErr()) refuse(copied.error.message, copied.error.gap);
+			else publishCommit(prepared.value);
+			return true;
+		},
 		...canonicalInputLifecycle,
 		...canonicalStructuralInput,
 		replace: (intent) => {
@@ -439,7 +523,7 @@ const createHiddenEditorManager = (deps) => {
 			const rule = prepareCanonicalAutoformat(editorSession.session, view.state, intent);
 			const prepared = rule ?? editorSession.session.prepareReplace(view.state, intent);
 			if (prepared.isErr()) {
-				if (prepared.error.reason !== "noChange") refuse(prepared.error.message);
+				if (prepared.error.reason !== "noChange") refuse(prepared.error.message, prepared.error.gap);
 				return;
 			}
 			const session = editorSession.session;
@@ -464,14 +548,14 @@ const createHiddenEditorManager = (deps) => {
 		if (!host) return;
 		const collaboration = deps.getCollaboration();
 		const collaborationModules = deps.getCollaborationModules();
-		if (collaboration && !collaborationModules && deps.getExperimentalSession?.() !== "canonical") return;
+		if (collaboration && !collaborationModules && !usesCanonicalSession(deps.getExperimentalSession?.(), CANONICAL_GAP.authorityRouting)) return;
 		const precomputedInitialState = deps.getPrecomputedInitialState();
 		const document = deps.getDocument();
 		const styles = deps.getStyles();
 		const extensionManager = deps.getExtensionManager();
 		const externalPlugins = deps.getExternalPlugins();
-		if (!seedSession(document)) return;
 		input.reset();
+		if (!seedSession(document)) return;
 		const editorProps = {
 			state: (() => {
 				if (editorSession.type === "canonical") return canonicalState(editorSession.session);
@@ -505,7 +589,11 @@ const createHiddenEditorManager = (deps) => {
 					lastInputRule = void 0;
 					editorSession.session.breakUndoGroup();
 				}
+				const modules = deps.getCollaborationModules();
+				if (modules && transaction.getMeta(modules.yProseMirror.ySyncPluginKey) !== void 0) markNoteReferenceReplay(transaction);
 				const applied = view.state.applyTransaction(transaction);
+				const noteIssue = noteReferenceTransactionIssue(transaction);
+				if (noteIssue) deps.onSessionRefusal?.(noteIssue.message, CANONICAL_GAP.dispatch, noteIssue);
 				if (editorSession.type === "canonical" && !applied.state.doc.eq(view.state.doc)) {
 					refuse("A plugin attempted an unclassified canonical document mutation.");
 					return;
@@ -533,16 +621,79 @@ const createHiddenEditorManager = (deps) => {
 				return deps.onKeyDown(pmView, event);
 			},
 			handleTextInput: (pmView, from, to, text) => editorSession.type === "canonical" ? input.handleTextInput(pmView, from, to, text) : false,
+			handlePaste: (pmView, _event, slice) => {
+				if (editorSession.type !== "canonical") return false;
+				if (deps.getReadOnly()) {
+					deps.onReadOnlyEditAttempt();
+					return true;
+				}
+				syncCanonicalMode();
+				const prepared = prepareCanonicalPaste({
+					session: editorSession.session,
+					state: pmView.state,
+					slice
+				});
+				if (prepared.isErr()) {
+					if (prepared.error.reason !== "noChange") refuse(prepared.error.message, prepared.error.gap);
+				} else publishCommit(prepared.value);
+				return true;
+			},
+			handleDrop: (pmView, event, slice, moved) => {
+				if (editorSession.type !== "canonical") return false;
+				if (deps.getReadOnly()) {
+					deps.onReadOnlyEditAttempt();
+					return true;
+				}
+				const target = pmView.posAtCoords({
+					left: event.clientX,
+					top: event.clientY
+				})?.pos;
+				if (target === void 0) {
+					refuse("The drop has no document destination.");
+					return true;
+				}
+				const captured = clipboardDrag;
+				clipboardDrag = { type: "idle" };
+				if (moved && (captured.type !== "dragging" || captured.session !== editorSession.session || captured.version !== editorSession.session.version)) {
+					refuse("The dragged content changed or has no captured source.");
+					return true;
+				}
+				const source = captured.type === "dragging" ? {
+					from: captured.from,
+					to: captured.to
+				} : pmView.state.selection;
+				if (moved && target >= source.from && target <= source.to) return true;
+				syncCanonicalMode();
+				const prepared = prepareCanonicalPaste({
+					session: editorSession.session,
+					state: pmView.state,
+					slice,
+					...moved ? {
+						moveTarget: target,
+						moveSource: {
+							from: source.from,
+							to: source.to
+						}
+					} : { pasteTarget: target }
+				});
+				if (prepared.isErr()) {
+					if (prepared.error.reason !== "noChange") refuse(prepared.error.message, prepared.error.gap);
+				} else publishCommit(prepared.value);
+				return true;
+			},
 			handleScrollToSelection: suppressHiddenEditorScrollToSelection,
 			handleDOMEvents: {
+				keydown: (pmView, event) => editorSession.type === "canonical" ? input.handleDOMEvents.keydown(pmView, event) : false,
 				focus: () => false,
 				blur: (pmView) => editorSession.type === "canonical" ? input.handleDOMEvents.blur(pmView) : false,
 				...createHiddenEditorClipboardHandlers(deps),
-				mousedown: (pmView) => editorSession.type === "canonical" ? input.handleDOMEvents.mousedown(pmView) : false,
 				compositionstart: (pmView) => editorSession.type === "canonical" ? input.handleDOMEvents.compositionstart(pmView) : false,
 				compositionend: (pmView) => editorSession.type === "canonical" ? input.handleDOMEvents.compositionend(pmView) : false,
 				input: (pmView) => editorSession.type === "canonical" ? input.handleDOMEvents.input(pmView) : false,
-				paste: (pmView, event) => editorSession.type === "canonical" ? input.handleDOMEvents.paste(pmView, event) : createHiddenEditorClipboardHandlers(deps).paste(pmView, event),
+				paste: (pmView, event) => {
+					if (editorSession.type === "canonical" && !deps.getReadOnly()) return input.handleDOMEvents.paste(pmView, event);
+					return createHiddenEditorClipboardHandlers(deps).paste(pmView, event);
+				},
 				cut: (pmView, event) => editorSession.type === "canonical" ? input.handleDOMEvents.cut(pmView, event) : createHiddenEditorClipboardHandlers(deps).cut(pmView, event),
 				beforeinput: (_view, event) => {
 					if (editorSession.type === "canonical" && !deps.getReadOnly()) return input.handleDOMEvents.beforeinput(_view, event);
@@ -551,8 +702,22 @@ const createHiddenEditorManager = (deps) => {
 					event.preventDefault();
 					return true;
 				},
+				dragstart: (pmView) => {
+					if (editorSession.type === "canonical") clipboardDrag = {
+						type: "dragging",
+						session: editorSession.session,
+						version: editorSession.session.version,
+						from: pmView.state.selection.from,
+						to: pmView.state.selection.to
+					};
+					return false;
+				},
+				dragend: () => {
+					clipboardDrag = { type: "idle" };
+					return false;
+				},
 				drop: (_view, event) => {
-					if (editorSession.type === "canonical") return input.handleDOMEvents.drop(_view, event);
+					if (editorSession.type === "canonical" && !deps.getReadOnly()) return input.handleDOMEvents.drop(_view, event);
 					if (!deps.getReadOnly()) return false;
 					deps.onReadOnlyEditAttempt();
 					event.preventDefault();
@@ -562,6 +727,25 @@ const createHiddenEditorManager = (deps) => {
 		};
 		const viewStartedAt = performance.now();
 		view = new EditorView(host, editorProps);
+		if (editorSession.type === "canonical") registerClipboardIntentHandler(view, (slice, plain) => {
+			if (!view || editorSession.type !== "canonical") return false;
+			if (deps.getReadOnly()) {
+				deps.onReadOnlyEditAttempt();
+				return false;
+			}
+			syncCanonicalMode();
+			const prepared = prepareCanonicalPaste({
+				session: editorSession.session,
+				state: view.state,
+				slice,
+				plain
+			});
+			if (prepared.isErr()) {
+				if (prepared.error.reason !== "noChange") refuse(prepared.error.message, prepared.error.gap);
+				return false;
+			}
+			return publishCommit(prepared.value);
+		});
 		releaseCommandOwner = registerEditorCommandOwner(view, executeCanonicalCommand);
 		recordHiddenEditorPhase("mount", "editor-view", performance.now() - viewStartedAt);
 		syncHiddenEditorAccessibility(view, deps.getReadOnly());
@@ -592,21 +776,22 @@ const createHiddenEditorManager = (deps) => {
 	};
 	const syncExternalDocument = () => {
 		if (!view || isDestroying) return;
+		const canonicalRequested = usesCanonicalSession(deps.getExperimentalSession?.(), CANONICAL_GAP.authorityRouting);
 		const collaboration = deps.getCollaboration();
 		const collaborationModules = deps.getCollaborationModules();
-		if (collaboration && !collaborationModules && deps.getExperimentalSession?.() !== "canonical") return;
+		if (collaboration && !collaborationModules && !canonicalRequested) return;
 		const document = deps.getDocument();
 		const currentDocId = deps.getDocumentIdentity();
 		const currentCollaborationFragment = collaboration?.yXmlFragment ?? null;
 		const collaborationSourceChanged = currentCollaborationFragment !== lastCollaborationFragment;
-		const sessionChanged = editorSession.type !== "prosemirror" !== (deps.getExperimentalSession?.() === "canonical");
+		const sessionChanged = editorSession.type !== "prosemirror" !== canonicalRequested;
 		if (collaboration && !collaborationSourceChanged && !sessionChanged) return;
 		if (isInitialized && currentDocId === lastDocumentId && !collaborationSourceChanged && !sessionChanged) return;
+		input.reset();
 		if (!seedSession(document)) {
 			destroyView();
 			return;
 		}
-		input.reset();
 		isInitialized = true;
 		lastDocumentId = currentDocId;
 		lastCollaborationFragment = currentCollaborationFragment;
@@ -631,13 +816,20 @@ const createHiddenEditorManager = (deps) => {
 	};
 	const publishStoryCommit = (storyView, commit) => {
 		if (!view || editorSession.type !== "canonical") return false;
-		if (deps.getEditingMode?.() === "suggesting") {
-			refuse("Suggesting is unavailable in the experimental canonical session.");
-			return false;
-		}
 		const session = editorSession.session;
 		const bodyTransaction = view.state.tr;
 		if (!bodyTransaction.doc.eq(commit.bodyProjection.doc)) bodyTransaction.replaceWith(0, bodyTransaction.doc.content.size, commit.bodyProjection.doc.content);
+		if (commit.selection.anchor.story === OP_STORIES.MAIN && commit.selection.head.story === OP_STORIES.MAIN) {
+			if (!restoreCanonicalSelection({
+				transaction: bodyTransaction,
+				projection: commit.bodyProjection,
+				selection: commit.selection,
+				unavailable: { type: "refuse" }
+			})) {
+				refuse("The canonical body history selection is unavailable.");
+				return false;
+			}
+		}
 		markPackageChange(bodyTransaction);
 		bodyTransaction.setMeta("addToHistory", false);
 		const bodyStaged = Result.try(() => view?.state.applyTransaction(bodyTransaction));
@@ -651,7 +843,7 @@ const createHiddenEditorManager = (deps) => {
 			session
 		});
 		if (staged.isErr()) {
-			refuse(staged.error.message);
+			refuse(staged.error.message, staged.error.gap);
 			return false;
 		}
 		storyView.updateState(staged.value.state);
@@ -664,6 +856,23 @@ const createHiddenEditorManager = (deps) => {
 		deps.onSelectionChange(view.state);
 		return true;
 	};
+	let publicOperations = null;
+	const getPublicOperations = () => {
+		if (editorSession.type !== "canonical") return null;
+		const session = editorSession.session;
+		if (publicOperations?.session === session) return publicOperations.executor;
+		const executor = new CanonicalPublicOperations({
+			session,
+			getState: (story) => story === OP_STORIES.MAIN && !deps.getReadOnly() && !isDestroying ? view?.state ?? null : null,
+			publish: publishCommit
+		});
+		publicOperations = {
+			session,
+			executor
+		};
+		return executor;
+	};
+	const isCanonicalModelSessionRequested = () => usesCanonicalSession(deps.getExperimentalSession?.(), CANONICAL_GAP.authorityRouting);
 	return {
 		ensureView,
 		retryViewCreation,
@@ -676,6 +885,10 @@ const createHiddenEditorManager = (deps) => {
 		api: createHiddenEditorApi({
 			getView: () => view,
 			getDocumentContext: () => editorSession.type === "refused" ? null : deps.getDocumentContext(),
+			getCanonicalComments: () => editorSession.type === "canonical" ? editorSession.session.getCommittedComments() : null,
+			getCanonicalCommittedVersion: () => editorSession.type === "canonical" ? `${canonicalSessionEpoch}:${editorSession.session.version}` : null,
+			isCanonicalSaveCurrent: (version) => editorSession.type === "canonical" && !editorSession.session.isComposing && editorSession.session.version === version,
+			captureCanonicalSave: () => editorSession.type === "canonical" ? editorSession.session.captureSaveSnapshot() : null,
 			getCanonicalDocument: () => editorSession.type === "canonical" ? editorSession.session.document : null,
 			setCanonicalMode: (mode) => {
 				if (editorSession.type !== "canonical") return false;
@@ -690,7 +903,7 @@ const createHiddenEditorManager = (deps) => {
 					resolution
 				});
 				if (prepared.isErr()) {
-					if (prepared.error.reason !== "noChange") refuse(prepared.error.message);
+					if (prepared.error.reason !== "noChange") refuse(prepared.error.message, prepared.error.gap);
 					return false;
 				}
 				return publishCommit(prepared.value);
@@ -703,6 +916,125 @@ const createHiddenEditorManager = (deps) => {
 				canRedo: () => editorSession.type === "canonical" && editorSession.session.canRedo
 			} : null,
 			canonicalOperations: {
+				applyCanonicalSectionProperties: (patch) => {
+					ensureView();
+					const fail = (message) => {
+						refuse(message, CANONICAL_GAP.sectionProperties);
+						return {
+							status: "refused",
+							gap: CANONICAL_GAP.sectionProperties,
+							message
+						};
+					};
+					if (editorSession.type === "refused") return fail(editorSession.reason);
+					if (editorSession.type !== "canonical") {
+						if (isCanonicalModelSessionRequested()) return fail("The canonical document is not ready for section changes.");
+						return null;
+					}
+					if (!view || deps.getReadOnly() || isDestroying) return fail("The document is not editable.");
+					const session = editorSession.session;
+					if (session.isComposing) return fail("Section properties cannot change during composition.");
+					const prepared = session.prepareOperations(view.state, [createCanonicalSectionPropertiesOperation(session.document, patch)]);
+					if (prepared.isErr()) return fail(prepared.error.message);
+					let failureMessage = "The section projection could not publish.";
+					if (!publishCommit(prepared.value, (message) => {
+						failureMessage = message;
+					})) return fail(failureMessage);
+					return {
+						status: "applied",
+						version: session.version
+					};
+				},
+				applyCanonicalComment: (request) => {
+					ensureView();
+					const fail = (message, retry = "never") => {
+						if (retry === "never") refuse(message, CANONICAL_GAP.comments);
+						return {
+							status: "refused",
+							gap: CANONICAL_GAP.comments,
+							message,
+							retry
+						};
+					};
+					if (editorSession.type === "refused") return fail(editorSession.reason);
+					if (editorSession.type !== "canonical") {
+						if (isCanonicalModelSessionRequested()) return fail("The canonical document is not ready for comment changes.");
+						return null;
+					}
+					if (!view || deps.getReadOnly()) return fail("The document is not editable.");
+					const session = editorSession.session;
+					if (session.isComposing) return fail("Comments cannot change during composition.", "afterComposition");
+					let command;
+					if (request.type === "create") {
+						const id = freshCommentId(session.document);
+						if (id.isErr()) return fail(id.error.message);
+						let anchor;
+						switch (request.anchor.kind) {
+							case "selection": {
+								const projection = session.projectStory(request.anchor.story);
+								if (projection.isErr()) return fail(projection.error.message);
+								const from = projection.value.addressAt(request.anchor.from);
+								const to = projection.value.addressAt(request.anchor.to);
+								if (from.isErr()) return fail(from.error.message);
+								if (to.isErr()) return fail(to.error.message);
+								anchor = request.anchor.from === request.anchor.to ? {
+									kind: "point",
+									at: from.value
+								} : {
+									kind: "range",
+									from: from.value,
+									to: to.value
+								};
+								break;
+							}
+							case "reply":
+								anchor = {
+									kind: "reply",
+									parentId: request.anchor.parentId
+								};
+								break;
+							case "revision":
+								anchor = {
+									kind: "revision",
+									story: request.anchor.story,
+									revisionId: request.anchor.revisionId
+								};
+								break;
+							default: return request.anchor;
+						}
+						command = {
+							type: "create",
+							anchor,
+							comment: {
+								id: id.value,
+								author: request.author,
+								done: false,
+								date: request.date ?? (/* @__PURE__ */ new Date()).toISOString(),
+								content: canonicalCommentBody(session.document, request.text)
+							}
+						};
+					} else command = request;
+					const compiled = compileCanonicalComments({
+						document: session.document,
+						command
+					});
+					if (compiled.isErr()) return fail(compiled.error.message);
+					if (compiled.value.ops.length > 0) {
+						const prepared = session.prepareOperations(view.state, compiled.value.ops);
+						if (prepared.isErr()) return fail(prepared.error.message);
+						if (!publishCommit(prepared.value)) return fail("The comment projection could not publish.");
+					}
+					return {
+						status: "applied",
+						comments: session.getCommittedComments(),
+						...compiled.value.commentId === void 0 ? {} : { commentId: compiled.value.commentId }
+					};
+				},
+				applyCanonicalDocumentOperations: (options) => {
+					ensureView();
+					return getPublicOperations()?.apply(options) ?? null;
+				},
+				undoCanonicalDocumentOperations: (handle) => getPublicOperations()?.undo(handle) ?? null,
 				updateCanonicalInputLifecycle: (action) => {
 					if (editorSession.type !== "canonical") return false;
 					switch (action) {
@@ -732,11 +1064,12 @@ const createHiddenEditorManager = (deps) => {
 				applyCanonicalStoryHistory: ({ view: storyView, story, direction }) => {
 					if (story === OP_STORIES.MAIN && storyView === view) return history(direction);
 					if (!view || editorSession.type !== "canonical" || deps.getReadOnly()) return false;
+					syncCanonicalMode();
 					const session = editorSession.session;
 					if (direction === "undo" ? !session.canUndo : !session.canRedo) return false;
 					const prepared = direction === "undo" ? session.prepareUndo(storyView.state, story) : session.prepareRedo(storyView.state, story);
 					if (prepared.isErr()) {
-						refuse(prepared.error.message);
+						refuse(prepared.error.message, prepared.error.gap);
 						return false;
 					}
 					return publishStoryCommit(storyView, prepared.value);
@@ -746,29 +1079,30 @@ const createHiddenEditorManager = (deps) => {
 					if (!view || editorSession.type !== "canonical" || deps.getReadOnly()) return false;
 					const prepared = editorSession.session.prepareOperations(view.state, ops);
 					if (prepared.isErr()) {
-						refuse(prepared.error.message);
+						refuse(prepared.error.message, prepared.error.gap);
 						return false;
 					}
 					return publishCommit(prepared.value);
 				},
 				getCanonicalStoryProjection: (story) => {
-					if (deps.getExperimentalSession?.() === "canonical") ensureView();
+					if (usesCanonicalSession(deps.getExperimentalSession?.(), CANONICAL_GAP.authorityRouting)) ensureView();
 					if (editorSession.type !== "canonical" || editorSession.session.isComposing) return null;
 					const result = editorSession.session.projectStory(story);
 					if (result.isErr()) {
-						refuse(result.error.message);
+						refuse(result.error.message, result.error.gap);
 						return null;
 					}
 					return result.value.doc;
 				},
 				replaceCanonicalStoryText: ({ view: storyView, story, intent }) => {
 					if (!view || editorSession.type !== "canonical" || deps.getReadOnly()) return false;
+					syncCanonicalMode();
 					const prepared = editorSession.session.prepareReplace(storyView.state, {
 						...intent,
 						story
 					});
 					if (prepared.isErr()) {
-						refuse(prepared.error.message);
+						refuse(prepared.error.message, prepared.error.gap);
 						return false;
 					}
 					return publishStoryCommit(storyView, prepared.value);
@@ -777,7 +1111,8 @@ const createHiddenEditorManager = (deps) => {
 			isDestroying: () => isDestroying,
 			ensureView,
 			isViewRequested
-		})
+		}),
+		isCanonicalComposing: () => editorSession.type === "canonical" && editorSession.session.isComposing
 	};
 };
 //#endregion