@stll/folio-react 0.25.0 → 0.25.1

package/dist/{renderAsync-yYZKXh6r.js → renderAsync-BRxLNRVW.js}

@@ -1,6 +1,7 @@
 import { i as cn, n as FolioUIProvider, r as useFolioUI, t as DEFAULT_COMPONENTS } from "./folio-ui-DO95voaI.js";
 import { t as messages_exports } from "./messages.js";
 import { c } from "react-compiler-runtime";
+import { CANONICAL_GAP, canonicalRefusalMessage, usesCanonicalSession } from "@stll/folio-core/types/canonicalCapabilities";
 import * as React$1 from "react";
 import React, { Component, Suspense, cloneElement, createContext, forwardRef, isValidElement, lazy, memo, useCallback, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { AlertCircleIcon, AlertTriangleIcon, AlignCenterIcon, AlignJustifyIcon, AlignLeftIcon, AlignRightIcon, BaselineIcon, BoldIcon, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ClipboardCopyIcon, EyeIcon, FileIcon, GlobeIcon, ImageIcon, IndentDecreaseIcon, IndentIncreaseIcon, InfoIcon, ItalicIcon, LinkIcon, ListIcon, ListOrderedIcon, ListTreeIcon, MessageSquareTextIcon, MoreHorizontalIcon, OmegaIcon, PaintbrushIcon, PanelLeftOpenIcon, PenLineIcon, PencilIcon, PilcrowIcon, Redo2Icon, RulerIcon, SeparatorHorizontalIcon, SquarePenIcon, StickyNoteIcon, TableIcon, TableOfContentsIcon, TypeIcon, UnderlineIcon, Undo2Icon, UnlinkIcon, XIcon } from "lucide-react";
@@ -45,9 +46,10 @@ import { collectHeadings } from "@stll/folio-core/utils/headingCollector";
 import { formatPx, pixelsToTwips, pointsToHalfPoints, twipsToPixels } from "@stll/folio-core/utils/units";
 import { HistoryManager, classifyHistoryShortcut } from "@stll/folio-core/managers/HistoryManager";
 import { createCanonicalHeaderFooterOperation, createCanonicalSectionPropertiesOperation, removeCanonicalHeaderFooterOperations } from "@stll/folio-core/controller/canonicalOperations";
-import { repackWithCanonicalStoryRemovals } from "@stll/folio-core/docx/canonicalStoryRepack";
+import { CanonicalSaveDiagnosticError, serializeCanonicalSave } from "@stll/folio-core/docx/canonicalSave";
 import { TableSelectionManager } from "@stll/folio-core/managers/TableSelectionManager";
 import { DEFAULT_PAGE_HEIGHT_PX, getMargins, getPageSize, twipsToPixels as twipsToPixels$1 } from "@stll/folio-core/paged-layout/sectionGeometry";
+import { getFootnoteText } from "@stll/folio-core/docx/storyPlainText";
 import { createPortal } from "react-dom";
 import { NodeSelection, Selection, TextSelection as TextSelection$1 } from "prosemirror-state";
 import { CellSelection } from "prosemirror-tables";
@@ -65,7 +67,6 @@ import { TRANSACTION_LAYOUT_TIMING, browserClock, createLayoutScheduler } from "
 import { createLayoutSession } from "@stll/folio-core/controller/layoutSession";
 import { createHyphenationReadiness } from "@stll/folio-core/controller/hyphenationReadiness";
 import { readFontSetSignature, waitForInitialLayoutFonts, watchLayoutFontLoads } from "@stll/folio-core/controller/fontReadiness";
-import { getFootnoteText } from "@stll/folio-core/docx/footnoteParser";
 import { convertHeaderFooterPmDocToContent, convertHeaderFooterToContent } from "@stll/folio-core/layout-bridge/convert/headerFooterLayout";
 import { templatePreviewDirtyRange } from "@stll/folio-core/layout-bridge/convert/templatePreviewFlow";
 import { clickToPositionDom, getCaretPositionFromDom, getSelectionRectsFromDom } from "@stll/folio-core/layout-bridge/dom/clickToPositionDom";
@@ -368,7 +369,7 @@ const HiddenHeaderFooterPMs = memo(forwardRef(function HiddenHeaderFooterPMs({ d
 		getTheme: () => themeRef.current,
 		getCanonicalApi: () => canonicalApiRef.current?.() ?? null,
 		getExperimentalSession: () => sessionRef.current,
-		onSessionRefusal: (reason) => refusalRef.current?.(reason),
+		onSessionRefusal: (reason, gap) => refusalRef.current?.(reason, gap),
 		onTransaction: ({ rId, kind, view, docChanged, selectionChanged }) => {
 			onTransactionRef.current?.(rId, kind, view, docChanged, selectionChanged);
 		}
@@ -475,10 +476,10 @@ const NoteStoryEditor = forwardRef(function NoteStoryEditor(t0, ref) {
 				getTheme: () => themeRef.current,
 				getCanonicalApi: () => canonicalApiRef.current?.() ?? null,
 				getExperimentalSession: () => sessionRef.current,
-				onSessionRefusal: (reason) => refusalRef.current?.(reason),
+				onSessionRefusal: (reason, gap) => refusalRef.current?.(reason, gap),
 				onTransaction: (t2) => {
 					const { docChanged, selectionChanged, view } = t2;
-					if (docChanged) if (sessionRef.current === "canonical") {
+					if (docChanged) if (usesCanonicalSession(sessionRef.current, CANONICAL_GAP.secondaryStories)) {
 						const canonical = canonicalApiRef.current?.()?.getCanonicalDocument();
 						if (canonical) onDocumentChangeRef.current(canonical);
 					} else {
@@ -1318,7 +1319,7 @@ const HiddenProseMirror = forwardRef((props, ref) => {
 		getExperimentalSession: () => experimentalSessionRef.current,
 		getEditingMode: () => suggestionModeActiveRef.current ? "suggesting" : "editing",
 		getSuggestionAuthor: () => suggestionAuthorRef.current,
-		onSessionRefusal: (reason) => onSessionRefusalRef.current?.(reason),
+		onSessionRefusal: (reason, gap) => onSessionRefusalRef.current?.(reason, gap),
 		getDocumentIdentity: () => documentIdentityRef.current,
 		getDocumentContext: () => documentRef.current,
 		onTransaction: (update) => onTransactionRef.current?.(update),
@@ -2900,7 +2901,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		onActiveNoteStoryChange?.(story);
 	}, [onActiveNoteStoryChange]);
 	useEffect(() => {
-		if (readOnly || experimentalSession === "canonical") noteEditorRef.current?.close();
+		if (readOnly || usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting)) noteEditorRef.current?.close();
 	}, [experimentalSession, readOnly]);
 	const getCanonicalApi = useCallback(() => hiddenPMRef.current, []);
 	const { handlePMKeyDown } = useVisualLineNavigation({ pagesContainerRef });
@@ -2922,8 +2923,11 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 	onDocumentChangeRef.current = onDocumentChange;
 	onTotalPagesChangeRef.current = onTotalPagesChange;
 	onErrorRef.current = onError;
-	const handleSessionRefusal = useCallback((message) => {
-		onErrorRef.current?.(new CanonicalSessionRefusalError({ message }));
+	const handleSessionRefusal = useCallback((message, gap) => {
+		onErrorRef.current?.(new CanonicalSessionRefusalError({
+			gap,
+			message
+		}));
 	}, []);
 	const [layout, setLayout] = useState(null);
 	const layoutRef = useRef(layout);
@@ -3046,7 +3050,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		queuedInputBeforeHiddenEditorRef.current = [];
 		for (const input of queuedInput) {
 			if (input.type === "text") {
-				if (experimentalSession === "canonical") view_0.dom.dispatchEvent(new InputEvent("beforeinput", {
+				if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting)) view_0.dom.dispatchEvent(new InputEvent("beforeinput", {
 					inputType: "insertText",
 					data: input.text,
 					cancelable: true,
@@ -3320,10 +3324,10 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		}
 		let newDoc = hiddenPMRef.current?.getDocument();
 		const body = hiddenPMRef.current?.getState()?.doc;
-		if (newDoc && body && experimentalSession !== "canonical") newDoc = noteFollower.reconcile(newDoc, body);
+		if (newDoc && body && !usesCanonicalSession(experimentalSession, CANONICAL_GAP.save)) newDoc = noteFollower.reconcile(newDoc, body);
 		if (newDoc) {
-			onDocumentChangeRef.current?.(experimentalSession === "canonical" ? cloneDocumentWithParagraphPropertySources(newDoc) : newDoc);
-			folioEmitterRef.current.emit("docChange", experimentalSession === "canonical" ? cloneDocumentWithParagraphPropertySources(newDoc) : newDoc);
+			onDocumentChangeRef.current?.(usesCanonicalSession(experimentalSession, CANONICAL_GAP.save) ? cloneDocumentWithParagraphPropertySources(newDoc) : newDoc);
+			folioEmitterRef.current.emit("docChange", usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting) ? cloneDocumentWithParagraphPropertySources(newDoc) : newDoc);
 		}
 	}, [experimentalSession, noteFollower]);
 	const scheduleDocumentChangeNotification = useCallback(() => {
@@ -3930,7 +3934,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		if (docChanged_0) {
 			if (!hiddenPMRef.current?.getState() && !precomputedInitialStateRef.current) ensureHiddenEditorView({ sync: true });
 			scheduleLayout();
-			if (experimentalSession === "canonical") scheduleDocumentChangeNotification();
+			if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting)) scheduleDocumentChangeNotification();
 		}
 		if (docChanged_0 || selectionChanged) {
 			const { from: from_1, to: to_1 } = view_3.state.selection;
@@ -3966,8 +3970,8 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		}
 	}, [scheduleLayout]);
 	const handleNoteDocumentChange = useCallback((updated) => {
-		onDocumentChangeRef.current?.(experimentalSession === "canonical" ? cloneDocumentWithParagraphPropertySources(updated) : updated);
-		folioEmitterRef.current.emit("docChange", experimentalSession === "canonical" ? cloneDocumentWithParagraphPropertySources(updated) : updated);
+		onDocumentChangeRef.current?.(usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting) ? cloneDocumentWithParagraphPropertySources(updated) : updated);
+		folioEmitterRef.current.emit("docChange", usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting) ? cloneDocumentWithParagraphPropertySources(updated) : updated);
 	}, [experimentalSession]);
 	useEffect(() => {
 		if (!hfEditMode) setHfCaretSelection(null);
@@ -4833,8 +4837,8 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 			if (story_0) {
 				e_3.preventDefault();
 				e_3.stopPropagation();
-				if (experimentalSession === "canonical") {
-					handleSessionRefusal("Footnote and endnote editing is unavailable in this session.");
+				if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting)) {
+					handleSessionRefusal("Footnote and endnote editing is unavailable in this session.", CANONICAL_GAP.secondaryStories);
 					return;
 				}
 				noteEditorRef.current?.open(story_0);
@@ -5490,7 +5494,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		getDocument() {
 			if (documentChangeNotifyTimerRef.current !== null) flushDocumentChangeNotification();
 			const editorDocument = folioEditor.getDocument();
-			if (experimentalSession === "canonical") return editorDocument;
+			if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting)) return editorDocument;
 			const current_0 = editorDocument ? noteFollower.withPending(editorDocument) : null;
 			return current_0 ? noteEditorRef.current?.snapshotDocument(current_0) ?? current_0 : null;
 		},
@@ -5501,14 +5505,14 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 			return folioEditor.getView();
 		},
 		getActiveView() {
-			if (experimentalSession === "canonical") return folioEditor.getView();
+			if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting)) return folioEditor.getView();
 			return getActiveEditorStory().view;
 		},
 		closeNoteStory() {
 			noteEditorRef.current?.close();
 		},
 		getHfView(rId_0) {
-			if (experimentalSession === "canonical") return null;
+			if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting)) return null;
 			return hfPMsRef.current?.getView(rId_0) ?? null;
 		},
 		ensureView(options_4) {
@@ -5534,7 +5538,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		undo() {
 			const target_5 = getActiveEditorStory();
 			if (target_5.type === "none") return false;
-			if (experimentalSession === "canonical") return hiddenPMRef.current?.applyCanonicalStoryHistory({
+			if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting)) return hiddenPMRef.current?.applyCanonicalStoryHistory({
 				view: target_5.view,
 				story: getCanonicalActiveStory(),
 				direction: "undo"
@@ -5545,7 +5549,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		redo() {
 			const target_6 = getActiveEditorStory();
 			if (target_6.type === "none") return false;
-			if (experimentalSession === "canonical") return hiddenPMRef.current?.applyCanonicalStoryHistory({
+			if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting)) return hiddenPMRef.current?.applyCanonicalStoryHistory({
 				view: target_6.view,
 				story: getCanonicalActiveStory(),
 				direction: "redo"
@@ -5556,12 +5560,12 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		canUndo() {
 			const target_7 = getActiveEditorStory();
 			if (target_7.type === "none") return false;
-			return experimentalSession === "canonical" || target_7.type === "body" ? hiddenPMRef.current?.canUndo() ?? false : undo(target_7.view.state);
+			return usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting) || target_7.type === "body" ? hiddenPMRef.current?.canUndo() ?? false : undo(target_7.view.state);
 		},
 		canRedo() {
 			const target_8 = getActiveEditorStory();
 			if (target_8.type === "none") return false;
-			return experimentalSession === "canonical" || target_8.type === "body" ? hiddenPMRef.current?.canRedo() ?? false : redo(target_8.view.state);
+			return usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting) || target_8.type === "body" ? hiddenPMRef.current?.canRedo() ?? false : redo(target_8.view.state);
 		},
 		setSelection(anchor_3, head_1) {
 			folioEditor.setSelection(anchor_3, head_1);
@@ -5721,7 +5725,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 				onTransaction: handleHfPmTransaction,
 				getCanonicalApi,
 				onSessionRefusal: handleSessionRefusal,
-				...experimentalSession === void 0 ? {} : { experimentalSession },
+				...!usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting) ? {} : { experimentalSession },
 				...styles !== void 0 ? { styles } : {},
 				..._theme !== void 0 ? { theme: _theme } : {}
 			}),
@@ -5731,7 +5735,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 				onActiveChange: handleActiveNoteStoryChange,
 				getCanonicalApi,
 				onSessionRefusal: handleSessionRefusal,
-				...experimentalSession === void 0 ? {} : { experimentalSession },
+				...!usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting) ? {} : { experimentalSession },
 				onDocumentChange: handleNoteDocumentChange,
 				onStoryChange: handleNoteStoryTransaction,
 				plugins: noteStoryPlugins,
@@ -5744,7 +5748,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 				ref: hiddenPMRef,
 				document,
 				documentIdentity,
-				...experimentalSession === void 0 ? {} : { experimentalSession },
+				...!usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting) ? {} : { experimentalSession },
 				onSessionRefusal: handleSessionRefusal,
 				...suggestionAuthor !== void 0 ? { suggestionAuthor } : {},
 				suggestionModeActive,
@@ -10599,7 +10603,7 @@ const useHeaderFooterEditor = ({ history, pushDocument, getHfView, getCanonicalA
 			setHfEditPosition(position);
 			return;
 		}
-		if (experimentalSession === "canonical") {
+		if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.secondaryStories)) {
 			const api = getCanonicalApi?.();
 			api?.ensureView();
 			const canonical = api?.getCanonicalDocument();
@@ -10629,7 +10633,7 @@ const useHeaderFooterEditor = ({ history, pushDocument, getHfView, getCanonicalA
 		experimentalSession
 	]);
 	const handleHeaderFooterSave = useCallback(() => {
-		if (experimentalSession === "canonical") {
+		if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.secondaryStories)) {
 			setHfEditPosition(null);
 			return;
 		}
@@ -10683,7 +10687,7 @@ const useHeaderFooterEditor = ({ history, pushDocument, getHfView, getCanonicalA
 				return;
 			}
 			const activeRId_0 = pickActiveHeaderFooterRId(resolution, hfEditPosition, hfEditIsFirstPage);
-			if (experimentalSession === "canonical") {
+			if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.secondaryStories)) {
 				const api_0 = getCanonicalApi?.();
 				const canonical_0 = api_0?.getCanonicalDocument();
 				if (api_0 && canonical_0 && activeRId_0) api_0.applyCanonicalOperations(removeCanonicalHeaderFooterOperations({
@@ -12949,7 +12953,7 @@ function useFolioComments({ doc, autoOpenReviewSidebar, anchorPositions, editorC
 */
 /** No headings to track while the outline is not shown. */
 const NO_HEADINGS = [];
-const CommentsSidebar = lazy(() => import("./CommentsSidebar-D9vMIMl7.js").then((m) => ({ default: m.CommentsSidebar })));
+const CommentsSidebar = lazy(() => import("./CommentsSidebar-D8sljCtX.js").then((m) => ({ default: m.CommentsSidebar })));
 const TextContextMenu = lazy(() => import("./TextContextMenu-Bqth8itn.js").then((m) => ({ default: m.TextContextMenu })));
 const loadAttemptSelectiveSave = async () => {
 	const { attemptSelectiveSave } = await import("@stll/folio-core/docx/selectiveSave");
@@ -13065,8 +13069,11 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		readOnlyProp
 	});
 	const toggleTrackChanges = useCallback(() => {
-		if (experimentalSession === "canonical" && !trackChangesOn) {
-			const error = new CanonicalSessionRefusalError({ message: "Canonical sessions do not support suggesting mode." });
+		if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.suggesting) && !trackChangesOn) {
+			const error = new CanonicalSessionRefusalError({
+				gap: CANONICAL_GAP.suggesting,
+				message: canonicalRefusalMessage(CANONICAL_GAP.suggesting, "Canonical sessions do not support suggesting mode.")
+			});
 			toast(error.message);
 			onError?.(error);
 			return;
@@ -13126,11 +13133,14 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	const history = useDocumentHistory(initialDocument || null, {
 		maxEntries: 100,
 		groupingInterval: 500,
-		enableKeyboardShortcuts: historyShortcuts === "editor" && experimentalSession !== "canonical"
+		enableKeyboardShortcuts: historyShortcuts === "editor" && !usesCanonicalSession(experimentalSession, CANONICAL_GAP.history)
 	});
-	const refuseCanonicalModelEdit = useCallback((message) => {
-		if (experimentalSession !== "canonical") return false;
-		const error_0 = new CanonicalSessionRefusalError({ message });
+	const refuseCanonicalModelEdit = useCallback((gap, message) => {
+		if (!usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting)) return false;
+		const error_0 = new CanonicalSessionRefusalError({
+			gap,
+			message: canonicalRefusalMessage(gap, message)
+		});
 		toast(error_0.message);
 		onError?.(error_0);
 		return true;
@@ -13372,7 +13382,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		history,
 		pushDocument,
 		getCanonicalApi,
-		...experimentalSession === void 0 ? {} : { experimentalSession },
+		...!usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting) ? {} : { experimentalSession },
 		getHfView: (rId) => pagedEditorRef.current?.getHfView(rId) ?? null
 	});
 	let activeHfRId = hfEditIsFirstPage ? activeFirstFooterRId : activeFooterRId;
@@ -13405,7 +13415,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		else pagedEditorRef.current?.focus();
 	}, [getActiveEditorStory]);
 	const undoActiveEditor = useCallback(() => {
-		if (experimentalSession !== "canonical" && getActiveEditorStory().type === "headerFooter" && hfEditorRef.current) hfEditorRef.current.undo();
+		if (!usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting) && getActiveEditorStory().type === "headerFooter" && hfEditorRef.current) hfEditorRef.current.undo();
 		else {
 			pagedEditorRef.current?.undo();
 			requestAnimationFrame(refreshBodyHistoryAvailability);
@@ -13416,7 +13426,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		experimentalSession
 	]);
 	const redoActiveEditor = useCallback(() => {
-		if (experimentalSession !== "canonical" && getActiveEditorStory().type === "headerFooter" && hfEditorRef.current) hfEditorRef.current.redo();
+		if (!usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting) && getActiveEditorStory().type === "headerFooter" && hfEditorRef.current) hfEditorRef.current.redo();
 		else {
 			pagedEditorRef.current?.redo();
 			requestAnimationFrame(refreshBodyHistoryAvailability);
@@ -13449,7 +13459,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		documentBuffer: documentBuffer ?? null,
 		initialDocument: initialDocument ?? null,
 		password,
-		...experimentalSession === void 0 ? {} : { experimentalSession },
+		...!usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting) ? {} : { experimentalSession },
 		history,
 		onError,
 		onCompatibilityChange,
@@ -13563,7 +13573,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 			}
 		};
 		pushDocument(documentWithComments);
-		onChange?.(experimentalSession === "canonical" ? cloneDocumentWithParagraphPropertySources(documentWithComments) : documentWithComments);
+		onChange?.(usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting) ? cloneDocumentWithParagraphPropertySources(documentWithComments) : documentWithComments);
 		if (showOutlineRef.current) {
 			if (collectHeadingsTimerRef.current) clearTimeout(collectHeadingsTimerRef.current);
 			collectHeadingsTimerRef.current = setTimeout(() => {
@@ -13591,7 +13601,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		if (!history.state) return null;
 		const canonical = pagedEditorRef.current?.getEditor().getCanonicalDocument();
 		if (canonical) return canonical;
-		if (experimentalSession === "canonical") return null;
+		if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting)) return null;
 		let doc_0 = cloneDocumentWithParagraphPropertySources(history.state);
 		const pmDoc = pagedEditorRef.current?.getDocument();
 		if (pmDoc) {
@@ -13622,8 +13632,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		experimentalSession
 	]);
 	const replaceComments = useCallback((nextComments) => {
-		if (experimentalSession === "canonical") {
-			refuseCanonicalModelEdit("Comment changes are unavailable in this session.");
+		if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting)) {
+			refuseCanonicalModelEdit(CANONICAL_GAP.comments, "Comment changes are unavailable in this session.");
 			return;
 		}
 		commentsDirtyRef.current = true;
@@ -13889,14 +13899,14 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		roots: shortcutRoots
 	});
 	const handleApplyFootnoteProperties = useCallback((footnotePr, endnotePr) => {
-		if (experimentalSession === "canonical") {
+		if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting)) {
 			const api = getCanonicalApi();
 			api?.ensureView();
 			const canonical_0 = api?.getCanonicalDocument();
 			if (!canonical_0 || !api?.applyCanonicalOperations([createCanonicalSectionPropertiesOperation(canonical_0, {
 				footnotePr,
 				endnotePr
-			})])) refuseCanonicalModelEdit("Section property changes could not be applied.");
+			})])) refuseCanonicalModelEdit(CANONICAL_GAP.sectionProperties, "Section property changes could not be applied.");
 			return;
 		}
 		if (!history.state?.package) return;
@@ -14580,11 +14590,11 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	]);
 	const handlePageSetupApply = useCallback((props) => {
 		if (readOnly) return;
-		if (experimentalSession === "canonical") {
+		if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting)) {
 			const api_0 = getCanonicalApi();
 			api_0?.ensureView();
 			const canonical_1 = api_0?.getCanonicalDocument();
-			if (!canonical_1 || !api_0?.applyCanonicalOperations([createCanonicalSectionPropertiesOperation(canonical_1, props)])) refuseCanonicalModelEdit("Section property changes could not be applied.");
+			if (!canonical_1 || !api_0?.applyCanonicalOperations([createCanonicalSectionPropertiesOperation(canonical_1, props)])) refuseCanonicalModelEdit(CANONICAL_GAP.sectionProperties, "Section property changes could not be applied.");
 			return;
 		}
 		if (!history.state || readOnly) return;
@@ -14639,57 +14649,74 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		let tripwireResult = null;
 		let savedBuffer = null;
 		try {
-			const view_18 = pagedEditorRef.current?.getView();
-			const editorState = view_18?.state;
-			const baselineBuffer = originalBufferRef.current;
-			const current = buildCurrentDocument();
-			const doc_1 = current ? withoutUnreferencedNotes(current) : null;
-			if (!doc_1) return null;
-			const { resolveSelectiveSaveFlags } = await import("@stll/folio-core/docx/selectiveSaveFlags");
-			const flags = resolveSelectiveSaveFlags(featureFlags);
-			const useSelectiveForSave = flags.selectiveSave && options?.mode !== FOLIO_DOCX_SERIALIZATION_MODE.full;
-			const shouldAttemptSelective = useSelectiveForSave || flags.selectiveSaveTripwire;
-			let selectiveBuffer = null;
-			if (shouldAttemptSelective && editorState && baselineBuffer) selectiveBuffer = await (await loadAttemptSelectiveSave())(doc_1, baselineBuffer, {
-				changedParaIds: getChangedParagraphIds(editorState),
-				structuralChange: hasStructuralChanges(editorState),
-				hasUntrackedChanges: hasUntrackedChanges(editorState),
-				maxBytes: flags.selectiveSaveMaxBytes
-			});
-			let buffer = useSelectiveForSave ? selectiveBuffer : null;
-			let fullBuffer = null;
-			const repackSourceDoc = baselineBuffer ? {
-				...doc_1,
-				originalBuffer: baselineBuffer
-			} : doc_1;
-			const repackFull = async () => {
-				const repackDocx = await loadRepackDocx();
-				const repack = () => repackDocx(repackSourceDoc);
-				if (experimentalSession === "canonical") return repackWithCanonicalStoryRemovals({
-					document: repackSourceDoc,
-					repack
+			const editor_1 = pagedEditorRef.current?.getEditor();
+			const snapshot = editor_1?.captureCanonicalSave();
+			if (snapshot && editor_1) {
+				const view_18 = editor_1.getView();
+				const editorState = view_18?.state;
+				const result = await serializeCanonicalSave({
+					snapshot,
+					options,
+					featureFlags
 				});
-				return editorState ? repackWithEditorSectionRemovals({
-					state: editorState,
-					document: repackSourceDoc,
-					repack
-				}) : repack();
-			};
-			if (!buffer) {
-				fullBuffer = await repackFull();
-				buffer = fullBuffer;
-			} else if (flags.selectiveSaveTripwire) try {
-				fullBuffer = await repackFull();
-			} catch {}
-			if (flags.selectiveSaveTripwire && fullBuffer && onSelectiveSaveTripwire) try {
-				const { compareSelectiveVsFull } = await import("@stll/folio-core/docx/selectiveSaveTripwire");
-				tripwireResult = await compareSelectiveVsFull(selectiveBuffer, fullBuffer);
-			} catch {}
-			if (view_18 && pagedEditorRef.current?.getView() === view_18 && view_18.state.doc === editorState?.doc) {
-				originalBufferRef.current = buffer;
-				view_18.dispatch(clearTrackedChanges(view_18.state));
+				for (const diagnostic of result.diagnostics) if (!options?.onDiagnostic) onError?.(new CanonicalSaveDiagnosticError({
+					gap: CANONICAL_GAP.save,
+					diagnostic,
+					message: `Canonical save used a fidelity fallback: ${diagnostic.type} (${diagnostic.part}).`
+				}));
+				tripwireResult = result.tripwireResult;
+				if (view_18 && pagedEditorRef.current?.getEditor() === editor_1 && editor_1.getView() === view_18 && view_18.state.doc === editorState?.doc && editor_1.isCanonicalSaveCurrent(snapshot.version)) view_18.dispatch(clearTrackedChanges(view_18.state));
+				savedBuffer = result.buffer;
+			} else {
+				if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.save)) return null;
+				const view_19 = pagedEditorRef.current?.getView();
+				const editorState_0 = view_19?.state;
+				const baselineBuffer = originalBufferRef.current;
+				const current = buildCurrentDocument();
+				const doc_1 = current ? withoutUnreferencedNotes(current) : null;
+				if (!doc_1) return null;
+				const { resolveSelectiveSaveFlags } = await import("@stll/folio-core/docx/selectiveSaveFlags");
+				const flags = resolveSelectiveSaveFlags(featureFlags);
+				const useSelectiveForSave = flags.selectiveSave && options?.mode !== FOLIO_DOCX_SERIALIZATION_MODE.full;
+				const shouldAttemptSelective = useSelectiveForSave || flags.selectiveSaveTripwire;
+				let selectiveBuffer = null;
+				if (shouldAttemptSelective && editorState_0 && baselineBuffer) selectiveBuffer = await (await loadAttemptSelectiveSave())(doc_1, baselineBuffer, {
+					changedParaIds: getChangedParagraphIds(editorState_0),
+					structuralChange: hasStructuralChanges(editorState_0),
+					hasUntrackedChanges: hasUntrackedChanges(editorState_0),
+					maxBytes: flags.selectiveSaveMaxBytes
+				});
+				let buffer = useSelectiveForSave ? selectiveBuffer : null;
+				let fullBuffer = null;
+				const repackSourceDoc = baselineBuffer ? {
+					...doc_1,
+					originalBuffer: baselineBuffer
+				} : doc_1;
+				const repackFull = async () => {
+					const repackDocx = await loadRepackDocx();
+					const repack = () => repackDocx(repackSourceDoc);
+					return editorState_0 ? repackWithEditorSectionRemovals({
+						state: editorState_0,
+						document: repackSourceDoc,
+						repack
+					}) : repack();
+				};
+				if (!buffer) {
+					fullBuffer = await repackFull();
+					buffer = fullBuffer;
+				} else if (flags.selectiveSaveTripwire) try {
+					fullBuffer = await repackFull();
+				} catch {}
+				if (flags.selectiveSaveTripwire && fullBuffer && onSelectiveSaveTripwire) try {
+					const { compareSelectiveVsFull } = await import("@stll/folio-core/docx/selectiveSaveTripwire");
+					tripwireResult = await compareSelectiveVsFull(selectiveBuffer, fullBuffer);
+				} catch {}
+				if (view_19 && pagedEditorRef.current?.getView() === view_19 && view_19.state.doc === editorState_0?.doc) {
+					originalBufferRef.current = buffer;
+					view_19.dispatch(clearTrackedChanges(view_19.state));
+				}
+				savedBuffer = buffer;
 			}
-			savedBuffer = buffer;
 		} catch (error_1) {
 			onError?.(error_1 instanceof Error ? error_1 : /* @__PURE__ */ new Error("Failed to save document"));
 			return null;
@@ -14701,12 +14728,13 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		onError,
 		originalBufferRef,
 		featureFlags,
-		onSelectiveSaveTripwire
+		onSelectiveSaveTripwire,
+		experimentalSession
 	]);
 	const handleSave = useCallback(async (options_0) => {
-		const editor_1 = pagedEditorRef.current?.getEditor();
+		const editor_2 = pagedEditorRef.current?.getEditor();
 		const serializationOptions = { mode: options_0?.selective === false ? FOLIO_DOCX_SERIALIZATION_MODE.full : FOLIO_DOCX_SERIALIZATION_MODE.preferSelective };
-		const buffer_0 = editor_1 ? await editor_1.getDocx(serializationOptions) : await serializeCurrentDocx(serializationOptions);
+		const buffer_0 = editor_2 ? await editor_2.getDocx(serializationOptions) : await serializeCurrentDocx(serializationOptions);
 		if (!buffer_0) return null;
 		commentsDirtyRef.current = false;
 		onSave?.(buffer_0);
@@ -14732,9 +14760,9 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	useImperativeHandle(ref, () => ({
 		getDocument: () => buildCurrentDocument(),
 		hasPendingChanges: () => {
-			const view_19 = pagedEditorRef.current?.getView();
-			if (!view_19) return false;
-			return commentsDirtyRef.current || getChangedParagraphIds(view_19.state).size > 0 || hasStructuralChanges(view_19.state) || hasUntrackedChanges(view_19.state);
+			const view_20 = pagedEditorRef.current?.getView();
+			if (!view_20) return false;
+			return commentsDirtyRef.current || getChangedParagraphIds(view_20.state).size > 0 || hasStructuralChanges(view_20.state) || hasUntrackedChanges(view_20.state);
 		},
 		getEditorRef: () => pagedEditorRef.current,
 		getEditor: () => pagedEditorRef.current?.getEditor() ?? null,
@@ -14760,9 +14788,9 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		},
 		loadDocument: (document_0) => {
 			pendingSuggestionRegistryRef.current.clear();
-			const editor_2 = pagedEditorRef.current?.getEditor();
-			if (editor_2) {
-				editor_2.loadDocument(document_0);
+			const editor_3 = pagedEditorRef.current?.getEditor();
+			if (editor_3) {
+				editor_3.loadDocument(document_0);
 				return;
 			}
 			loadParsedDocument(document_0);
@@ -14775,13 +14803,13 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 			pagedEditorRef.current?.ensureView(options_2);
 		},
 		createAIEditSnapshot: () => {
-			const view_20 = pagedEditorRef.current?.getView();
-			return view_20 ? createFolioAIEditSnapshot(view_20.state.doc) : null;
+			const view_21 = pagedEditorRef.current?.getView();
+			return view_21 ? createFolioAIEditSnapshot(view_21.state.doc) : null;
 		},
-		applyDocumentOperations: ({ snapshot, batch, author: operationAuthor = author }) => {
+		applyDocumentOperations: ({ snapshot: snapshot_0, batch, author: operationAuthor = author }) => {
 			assertSupportedFolioDocumentOperationVersion(batch.version);
-			const view_21 = pagedEditorRef.current?.getView();
-			if (!view_21) {
+			const view_22 = pagedEditorRef.current?.getView();
+			if (!view_22) {
 				let status = "committed";
 				if (batch.dryRun === true) status = "previewed";
 				else if (batch.atomic === true) status = "rejected";
@@ -14799,21 +14827,27 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 					undoHandle: null
 				};
 			}
+			const canonical_2 = getCanonicalApi()?.applyCanonicalDocumentOperations({
+				snapshot: snapshot_0,
+				batch,
+				author: operationAuthor
+			});
+			if (canonical_2) return canonical_2;
 			const existingUndoEntry = documentOperationUndoEntriesRef.current.at(-1);
-			if (existingUndoEntry && (!view_21.state.doc.eq(existingUndoEntry.afterState.doc) || commentsRef.current !== existingUndoEntry.commentsAfter)) documentOperationUndoEntriesRef.current.length = 0;
+			if (existingUndoEntry && (!view_22.state.doc.eq(existingUndoEntry.afterState.doc) || commentsRef.current !== existingUndoEntry.commentsAfter)) documentOperationUndoEntriesRef.current.length = 0;
 			const commentsBefore = commentsRef.current;
 			const createdComments = [];
 			const operationView = {
-				state: view_21.state,
+				state: view_22.state,
 				dispatch: (transaction) => {
-					view_21.dispatch(closeHistory(transaction));
-					operationView.state = view_21.state;
+					view_22.dispatch(closeHistory(transaction));
+					operationView.state = view_22.state;
 				}
 			};
-			const activeSuggestionIds = new Set(getSuggestions(view_21.state).map((s_0) => s_0.suggestionId));
-			const result = applyFolioDocumentOperations({
+			const activeSuggestionIds = new Set(getSuggestions(view_22.state).map((s_0) => s_0.suggestionId));
+			const result_0 = applyFolioDocumentOperations({
 				view: operationView,
-				snapshot,
+				snapshot: snapshot_0,
 				batch,
 				author: operationAuthor,
 				createCommentId: (text_3) => {
@@ -14826,25 +14860,27 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 					id: `react-${String(documentOperationUndoHandleCursor++)}`
 				})
 			});
-			if (batch.mode === "suggested" && result.status === "committed") pendingSuggestionRegistryRef.current.recordApplied({
-				snapshot,
+			if (batch.mode === "suggested" && result_0.status === "committed") pendingSuggestionRegistryRef.current.recordApplied({
+				snapshot: snapshot_0,
 				story: { type: "main" },
 				operations: batch.operations,
-				applied: result.applied,
+				applied: result_0.applied,
 				author: operationAuthor,
 				activeSuggestionIds
 			});
-			const batchComments = appliedOperationComments(createdComments, result.applied);
+			const batchComments = appliedOperationComments(createdComments, result_0.applied);
 			if (batchComments.length > 0) updateComments((currentComments_0) => [...currentComments_0, ...batchComments]);
-			if (result.undoHandle !== null) documentOperationUndoEntriesRef.current.push({
-				undoHandle: result.undoHandle,
-				afterState: view_21.state,
+			if (result_0.undoHandle !== null) documentOperationUndoEntriesRef.current.push({
+				undoHandle: result_0.undoHandle,
+				afterState: view_22.state,
 				commentsBefore,
 				commentsAfter: commentsRef.current
 			});
-			return result;
+			return result_0;
 		},
 		undoDocumentOperations: (undoHandle) => {
+			const canonical_3 = getCanonicalApi()?.undoCanonicalDocumentOperations(undoHandle);
+			if (canonical_3) return canonical_3;
 			const entries = documentOperationUndoEntriesRef.current;
 			const entryIndex = entries.findIndex((entry_2) => entry_2.undoHandle.type === undoHandle.type && entry_2.undoHandle.id === undoHandle.id);
 			if (entryIndex === -1) return {
@@ -14858,18 +14894,18 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 				reason: "notLatest"
 			};
 			const entry_3 = entries.at(-1);
-			const view_22 = pagedEditorRef.current?.getView();
-			if (!entry_3 || !view_22) return {
+			const view_23 = pagedEditorRef.current?.getView();
+			if (!entry_3 || !view_23) return {
 				status: "rejected",
 				undoHandle,
 				reason: "unknownHandle"
 			};
-			if (!view_22.state.doc.eq(entry_3.afterState.doc) || commentsRef.current !== entry_3.commentsAfter) return {
+			if (!view_23.state.doc.eq(entry_3.afterState.doc) || commentsRef.current !== entry_3.commentsAfter) return {
 				status: "rejected",
 				undoHandle,
 				reason: "documentChanged"
 			};
-			if (!undo(view_22.state, view_22.dispatch)) return {
+			if (!undo(view_23.state, view_23.dispatch)) return {
 				status: "rejected",
 				undoHandle,
 				reason: "documentChanged"
@@ -14882,20 +14918,30 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 				undoHandle
 			};
 		},
-		applyAIEditOperations: ({ snapshot: snapshot_0, operations, mode = "tracked-changes", author: operationAuthor_0 = author }) => {
-			const view_23 = pagedEditorRef.current?.getView();
-			if (!view_23) return {
+		applyAIEditOperations: ({ snapshot: snapshot_1, operations, mode = "tracked-changes", author: operationAuthor_0 = author }) => {
+			const view_24 = pagedEditorRef.current?.getView();
+			if (!view_24) return {
 				applied: [],
 				skipped: operations.map((operation_0) => ({
 					id: operation_0.id,
 					reason: "unsupportedBlock"
 				}))
 			};
+			const canonical_4 = getCanonicalApi()?.applyCanonicalDocumentOperations({
+				snapshot: snapshot_1,
+				batch: {
+					version: FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION,
+					operations,
+					mode
+				},
+				author: operationAuthor_0
+			});
+			if (canonical_4) return canonical_4;
 			const createdComments_0 = [];
-			const activeSuggestionIds_0 = new Set(getSuggestions(view_23.state).map((s_1) => s_1.suggestionId));
+			const activeSuggestionIds_0 = new Set(getSuggestions(view_24.state).map((s_1) => s_1.suggestionId));
 			const { applied: applied_0, skipped: skipped_0 } = applyFolioDocumentOperations({
-				view: view_23,
-				snapshot: snapshot_0,
+				view: view_24,
+				snapshot: snapshot_1,
 				batch: {
 					version: FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION,
 					operations,
@@ -14911,7 +14957,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 			const batchComments_0 = appliedOperationComments(createdComments_0, applied_0);
 			if (batchComments_0.length > 0) updateComments((currentComments_1) => [...currentComments_1, ...batchComments_0]);
 			if (mode === "suggested") pendingSuggestionRegistryRef.current.recordApplied({
-				snapshot: snapshot_0,
+				snapshot: snapshot_1,
 				story: { type: "main" },
 				operations,
 				applied: applied_0,
@@ -14924,71 +14970,71 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 			};
 		},
 		acceptAIEditOperation: (revisionId) => {
-			const view_24 = pagedEditorRef.current?.getView();
-			if (!view_24) return false;
-			const editor_3 = pagedEditorRef.current?.getEditor();
-			if (editor_3?.getCanonicalDocument()) return editor_3.resolveCanonicalRevisions(typeof revisionId === "number" ? [revisionId] : revisionId, "accept");
-			return acceptAIEditRevision(revisionId)(view_24.state, view_24.dispatch);
-		},
-		rejectAIEditOperation: (revisionId_0) => {
 			const view_25 = pagedEditorRef.current?.getView();
 			if (!view_25) return false;
 			const editor_4 = pagedEditorRef.current?.getEditor();
-			if (editor_4?.getCanonicalDocument()) return editor_4.resolveCanonicalRevisions(typeof revisionId_0 === "number" ? [revisionId_0] : revisionId_0, "reject");
-			return rejectAIEditRevision(revisionId_0)(view_25.state, view_25.dispatch);
+			if (editor_4?.getCanonicalDocument()) return editor_4.resolveCanonicalRevisions(typeof revisionId === "number" ? [revisionId] : revisionId, "accept");
+			return acceptAIEditRevision(revisionId)(view_25.state, view_25.dispatch);
+		},
+		rejectAIEditOperation: (revisionId_0) => {
+			const view_26 = pagedEditorRef.current?.getView();
+			if (!view_26) return false;
+			const editor_5 = pagedEditorRef.current?.getEditor();
+			if (editor_5?.getCanonicalDocument()) return editor_5.resolveCanonicalRevisions(typeof revisionId_0 === "number" ? [revisionId_0] : revisionId_0, "reject");
+			return rejectAIEditRevision(revisionId_0)(view_26.state, view_26.dispatch);
 		},
 		undo: () => {
-			if (experimentalSession !== "canonical" && getActiveEditorStory().type === "headerFooter" && hfEditorRef.current) return hfEditorRef.current.undo();
+			if (!usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting) && getActiveEditorStory().type === "headerFooter" && hfEditorRef.current) return hfEditorRef.current.undo();
 			const undone = pagedEditorRef.current?.undo() ?? false;
 			requestAnimationFrame(refreshBodyHistoryAvailability);
 			return undone;
 		},
 		redo: () => {
-			if (experimentalSession !== "canonical" && getActiveEditorStory().type === "headerFooter" && hfEditorRef.current) return hfEditorRef.current.redo();
+			if (!usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting) && getActiveEditorStory().type === "headerFooter" && hfEditorRef.current) return hfEditorRef.current.redo();
 			const redone = pagedEditorRef.current?.redo() ?? false;
 			requestAnimationFrame(refreshBodyHistoryAvailability);
 			return redone;
 		},
 		scrollToAIEditOperation: (revisionId_1) => {
-			const view_26 = pagedEditorRef.current?.getView();
-			if (!view_26) return false;
-			const range_2 = findAIEditRevisionRange(view_26.state, revisionId_1);
+			const view_27 = pagedEditorRef.current?.getView();
+			if (!view_27) return false;
+			const range_2 = findAIEditRevisionRange(view_27.state, revisionId_1);
 			if (!range_2) return false;
-			const { from: from_8, to: to_8 } = clampRangeToDocSize(view_26.state.doc.content.size, range_2);
-			const $from = view_26.state.doc.resolve(from_8);
-			const $to = view_26.state.doc.resolve(to_8);
-			view_26.dispatch(view_26.state.tr.setSelection(TextSelection.between($from, $to)));
+			const { from: from_8, to: to_8 } = clampRangeToDocSize(view_27.state.doc.content.size, range_2);
+			const $from = view_27.state.doc.resolve(from_8);
+			const $to = view_27.state.doc.resolve(to_8);
+			view_27.dispatch(view_27.state.tr.setSelection(TextSelection.between($from, $to)));
 			requestAnimationFrame(() => {
 				pagedEditorRef.current?.scrollToPosition(from_8);
 			});
 			return true;
 		},
-		scrollToBlock: (blockId, snapshot_1) => {
-			const view_27 = pagedEditorRef.current?.getView();
-			if (!view_27) return false;
+		scrollToBlock: (blockId, snapshot_2) => {
+			const view_28 = pagedEditorRef.current?.getView();
+			if (!view_28) return false;
 			const range_3 = resolveFolioAIBlockRange({
 				blockId,
-				doc: view_27.state.doc,
-				snapshot: snapshot_1
+				doc: view_28.state.doc,
+				snapshot: snapshot_2
 			});
 			if (range_3 === null) return false;
 			const { from: from_9, to: to_9 } = range_3;
-			const $from_0 = view_27.state.doc.resolve(from_9);
-			const $to_0 = view_27.state.doc.resolve(to_9);
-			view_27.dispatch(view_27.state.tr.setSelection(TextSelection.between($from_0, $to_0)));
+			const $from_0 = view_28.state.doc.resolve(from_9);
+			const $to_0 = view_28.state.doc.resolve(to_9);
+			view_28.dispatch(view_28.state.tr.setSelection(TextSelection.between($from_0, $to_0)));
 			requestAnimationFrame(() => {
 				pagedEditorRef.current?.scrollToPosition(from_9);
 			});
 			return true;
 		},
-		highlightPassage: ({ blockId: blockId_0, text: text_5, snapshot: snapshot_2 }) => {
-			const view_28 = pagedEditorRef.current?.getView();
-			if (!view_28) return "none";
+		highlightPassage: ({ blockId: blockId_0, text: text_5, snapshot: snapshot_3 }) => {
+			const view_29 = pagedEditorRef.current?.getView();
+			if (!view_29) return "none";
 			const passageRange = resolvePassageRange({
 				blockId: blockId_0,
 				text: text_5,
-				doc: view_28.state.doc,
-				snapshot: snapshot_2
+				doc: view_29.state.doc,
+				snapshot: snapshot_3
 			});
 			if (passageRange !== null) {
 				pagedEditorRef.current?.setPassageHighlight(passageRange);
@@ -15000,16 +15046,16 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 			pagedEditorRef.current?.setPassageHighlight(null);
 			const blockRange = resolveFolioAIBlockRange({
 				blockId: blockId_0,
-				doc: view_28.state.doc,
-				snapshot: snapshot_2
+				doc: view_29.state.doc,
+				snapshot: snapshot_3
 			});
 			if (blockRange === null) return "none";
 			const paraId_0 = getFolioParaIdFromBlockId(blockId_0);
 			if (paraId_0 !== null && pagedEditorRef.current?.scrollToParaId(paraId_0, { highlight: {} })) return "block";
 			const { from: from_10, to: to_10 } = blockRange;
-			const $from_1 = view_28.state.doc.resolve(from_10);
-			const $to_1 = view_28.state.doc.resolve(to_10);
-			view_28.dispatch(view_28.state.tr.setSelection(TextSelection.between($from_1, $to_1)));
+			const $from_1 = view_29.state.doc.resolve(from_10);
+			const $to_1 = view_29.state.doc.resolve(to_10);
+			view_29.dispatch(view_29.state.tr.setSelection(TextSelection.between($from_1, $to_1)));
 			requestAnimationFrame(() => {
 				pagedEditorRef.current?.scrollToPosition(from_10);
 			});
@@ -15018,60 +15064,70 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		clearPassageHighlight: () => {
 			pagedEditorRef.current?.setPassageHighlight(null);
 		},
-		showInDocument: (target_1, snapshot_3) => {
-			const view_29 = pagedEditorRef.current?.getView();
-			if (!view_29) return false;
+		showInDocument: (target_1, snapshot_4) => {
+			const view_30 = pagedEditorRef.current?.getView();
+			if (!view_30) return false;
 			const range_4 = target_1.type === "textRange" ? resolveFolioAITextRange({
 				range: target_1,
-				doc: view_29.state.doc,
-				snapshot: snapshot_3
+				doc: view_30.state.doc,
+				snapshot: snapshot_4
 			}) : resolveFolioAIBlockRange({
 				blockId: target_1.blockId,
-				doc: view_29.state.doc,
-				snapshot: snapshot_3
+				doc: view_30.state.doc,
+				snapshot: snapshot_4
 			});
 			if (range_4 === null) return false;
 			const { from: from_11, to: to_11 } = range_4;
-			const $from_2 = view_29.state.doc.resolve(from_11);
-			const $to_2 = view_29.state.doc.resolve(to_11);
-			view_29.dispatch(view_29.state.tr.setSelection(TextSelection.between($from_2, $to_2)));
+			const $from_2 = view_30.state.doc.resolve(from_11);
+			const $to_2 = view_30.state.doc.resolve(to_11);
+			view_30.dispatch(view_30.state.tr.setSelection(TextSelection.between($from_2, $to_2)));
 			requestAnimationFrame(() => {
 				pagedEditorRef.current?.scrollToPosition(from_11);
 			});
 			return true;
 		},
 		getSuggestions: () => {
-			const view_30 = pagedEditorRef.current?.getView();
-			return view_30 ? getSuggestions(view_30.state) : [];
+			const view_31 = pagedEditorRef.current?.getView();
+			return view_31 ? getSuggestions(view_31.state) : [];
 		},
 		exportPendingSuggestions: () => {
-			const view_31 = pagedEditorRef.current?.getView();
-			const activeIds = new Set(view_31 ? getSuggestions(view_31.state).map((s_2) => s_2.suggestionId) : []);
+			const view_32 = pagedEditorRef.current?.getView();
+			const activeIds = new Set(view_32 ? getSuggestions(view_32.state).map((s_2) => s_2.suggestionId) : []);
 			return pendingSuggestionRegistryRef.current.exportPendingSuggestions({
 				activeSuggestionIds: activeIds,
-				snapshotForStory: (story_0, commentIds) => story_0.type === "main" && view_31 ? createPendingSuggestionSourceSnapshot(view_31.state, commentIds) : null
+				snapshotForStory: (story_0, commentIds) => story_0.type === "main" && view_32 ? createPendingSuggestionSourceSnapshot(view_32.state, commentIds) : null
 			});
 		},
 		loadPendingSuggestions: (records) => pendingSuggestionRegistryRef.current.loadPendingSuggestions({
 			records,
 			snapshotForStory: (story_1) => {
-				const view_32 = pagedEditorRef.current?.getView();
-				return story_1.type === "main" && view_32 ? createFolioAIEditSnapshot(view_32.state.doc) : null;
-			},
-			sourceSnapshotForStory: (story_2, commentIds_0) => {
 				const view_33 = pagedEditorRef.current?.getView();
-				return story_2.type === "main" && view_33 ? createPendingSuggestionSourceSnapshot(view_33.state, commentIds_0) : null;
+				return story_1.type === "main" && view_33 ? createFolioAIEditSnapshot(view_33.state.doc) : null;
 			},
-			apply: (record, snapshot_4) => {
+			sourceSnapshotForStory: (story_2, commentIds_0) => {
 				const view_34 = pagedEditorRef.current?.getView();
-				if (!view_34) return {
+				return story_2.type === "main" && view_34 ? createPendingSuggestionSourceSnapshot(view_34.state, commentIds_0) : null;
+			},
+			apply: (record, snapshot_5) => {
+				const view_35 = pagedEditorRef.current?.getView();
+				if (!view_35) return {
 					applied: [],
 					skipped: []
 				};
+				const canonical_5 = getCanonicalApi()?.applyCanonicalDocumentOperations({
+					snapshot: snapshot_5,
+					batch: {
+						version: FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION,
+						operations: [record.operation],
+						mode: "suggested"
+					},
+					author: record.author
+				});
+				if (canonical_5) return canonical_5;
 				const createdComments_1 = [];
-				const result_0 = applyFolioDocumentOperations({
-					view: view_34,
-					snapshot: snapshot_4,
+				const result_1 = applyFolioDocumentOperations({
+					view: view_35,
+					snapshot: snapshot_5,
 					batch: {
 						version: FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION,
 						operations: [record.operation],
@@ -15084,78 +15140,78 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 						return comment_1.id;
 					}
 				});
-				const appliedComments = appliedOperationComments(createdComments_1, result_0.applied);
+				const appliedComments = appliedOperationComments(createdComments_1, result_1.applied);
 				if (appliedComments.length > 0) updateComments((currentComments_2) => [...currentComments_2, ...appliedComments]);
 				return {
-					applied: result_0.applied,
-					skipped: result_0.skipped
+					applied: result_1.applied,
+					skipped: result_1.skipped
 				};
 			},
 			activeSuggestionIds: () => {
-				const view_35 = pagedEditorRef.current?.getView();
-				return new Set(view_35 ? getSuggestions(view_35.state).map((s_3) => s_3.suggestionId) : []);
+				const view_36 = pagedEditorRef.current?.getView();
+				return new Set(view_36 ? getSuggestions(view_36.state).map((s_3) => s_3.suggestionId) : []);
 			}
 		}),
 		acceptSuggestion: (suggestionId, options_3) => {
-			const view_36 = pagedEditorRef.current?.getView();
-			if (!view_36) return {
+			const view_37 = pagedEditorRef.current?.getView();
+			if (!view_37) return {
 				accepted: false,
 				appliedAs: null
 			};
-			const appliedAs = getSuggestions(view_36.state).find((s_4) => s_4.suggestionId === suggestionId)?.appliedAs ?? null;
-			const accepted = acceptSuggestion(suggestionId, { author: options_3?.author ?? author })(view_36.state, view_36.dispatch);
+			const appliedAs = getSuggestions(view_37.state).find((s_4) => s_4.suggestionId === suggestionId)?.appliedAs ?? null;
+			const accepted = acceptSuggestion(suggestionId, { author: options_3?.author ?? author })(view_37.state, view_37.dispatch);
 			return {
 				accepted,
 				appliedAs: accepted ? appliedAs : null
 			};
 		},
 		rejectSuggestion: (suggestionId_0) => {
-			const view_37 = pagedEditorRef.current?.getView();
-			if (!view_37) return false;
-			return rejectSuggestion(suggestionId_0)(view_37.state, view_37.dispatch);
-		},
-		scrollToSuggestion: (suggestionId_1) => {
 			const view_38 = pagedEditorRef.current?.getView();
 			if (!view_38) return false;
-			const range_5 = findSuggestionRange(view_38.state, suggestionId_1);
+			return rejectSuggestion(suggestionId_0)(view_38.state, view_38.dispatch);
+		},
+		scrollToSuggestion: (suggestionId_1) => {
+			const view_39 = pagedEditorRef.current?.getView();
+			if (!view_39) return false;
+			const range_5 = findSuggestionRange(view_39.state, suggestionId_1);
 			if (!range_5) return false;
-			const { from: from_12, to: to_12 } = clampRangeToDocSize(view_38.state.doc.content.size, range_5);
-			const $from_3 = view_38.state.doc.resolve(from_12);
-			const $to_3 = view_38.state.doc.resolve(to_12);
-			view_38.dispatch(view_38.state.tr.setSelection(TextSelection.between($from_3, $to_3)));
+			const { from: from_12, to: to_12 } = clampRangeToDocSize(view_39.state.doc.content.size, range_5);
+			const $from_3 = view_39.state.doc.resolve(from_12);
+			const $to_3 = view_39.state.doc.resolve(to_12);
+			view_39.dispatch(view_39.state.tr.setSelection(TextSelection.between($from_3, $to_3)));
 			requestAnimationFrame(() => {
 				pagedEditorRef.current?.scrollToPosition(from_12);
 			});
 			return true;
 		},
 		getTrackedChanges: () => {
-			const view_39 = pagedEditorRef.current?.getView();
-			return view_39 ? getTrackedChangesFromDoc(view_39.state.doc) : [];
-		},
-		getCommentAnchors: () => {
 			const view_40 = pagedEditorRef.current?.getView();
-			return view_40 ? getCommentAnchorsFromDoc(view_40.state.doc) : [];
+			return view_40 ? getTrackedChangesFromDoc(view_40.state.doc) : [];
 		},
-		getSelectionText: () => {
+		getCommentAnchors: () => {
 			const view_41 = pagedEditorRef.current?.getView();
-			return view_41 ? getSelectedText(view_41.state) : "";
+			return view_41 ? getCommentAnchorsFromDoc(view_41.state.doc) : [];
 		},
-		getPageText: (page_1) => {
+		getSelectionText: () => {
 			const view_42 = pagedEditorRef.current?.getView();
-			if (!view_42) return null;
-			return getPageTextFromLayout(pagedEditorRef.current?.getEditor()?.getLayout() ?? null, view_42.state.doc, page_1);
+			return view_42 ? getSelectedText(view_42.state) : "";
 		},
-		getTargetPage: (target_2, snapshot_5) => {
+		getPageText: (page_1) => {
 			const view_43 = pagedEditorRef.current?.getView();
 			if (!view_43) return null;
+			return getPageTextFromLayout(pagedEditorRef.current?.getEditor()?.getLayout() ?? null, view_43.state.doc, page_1);
+		},
+		getTargetPage: (target_2, snapshot_6) => {
+			const view_44 = pagedEditorRef.current?.getView();
+			if (!view_44) return null;
 			const range_6 = target_2.type === "textRange" ? resolveFolioAITextRange({
 				range: target_2,
-				doc: view_43.state.doc,
-				snapshot: snapshot_5
+				doc: view_44.state.doc,
+				snapshot: snapshot_6
 			}) : resolveFolioAIBlockRange({
 				blockId: target_2.blockId,
-				doc: view_43.state.doc,
-				snapshot: snapshot_5
+				doc: view_44.state.doc,
+				snapshot: snapshot_6
 			});
 			if (range_6 === null) return null;
 			return pagedEditorRef.current?.getPageNumberForPmPos(range_6.from) ?? null;
@@ -15165,49 +15221,49 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		getScrollRoot: () => pagedEditorRef.current?.getScrollRoot() ?? null,
 		onLayoutChange: (listener) => pagedEditorRef.current?.onLayoutChange(listener) ?? (() => {}),
 		getContentControls: (filter = {}) => {
-			const view_44 = pagedEditorRef.current?.getView();
-			if (!view_44) return [];
-			return findBlockSdtMatches(view_44.state.doc, filter).map((match_0) => ({
+			const view_45 = pagedEditorRef.current?.getView();
+			if (!view_45) return [];
+			return findBlockSdtMatches(view_45.state.doc, filter).map((match_0) => ({
 				properties: blockSdtAttrsToSdtProperties(match_0.node),
 				path: match_0.path,
 				pmPos: match_0.pos
 			}));
 		},
 		scrollToContentControl: (filter_0) => {
-			const view_45 = pagedEditorRef.current?.getView();
-			if (!view_45) return false;
-			const match_1 = findBlockSdtMatch(view_45.state.doc, filter_0);
+			const view_46 = pagedEditorRef.current?.getView();
+			if (!view_46) return false;
+			const match_1 = findBlockSdtMatch(view_46.state.doc, filter_0);
 			if (!match_1) return false;
 			const inside = match_1.pos + 1;
-			const $pos = view_45.state.doc.resolve(inside);
-			view_45.dispatch(view_45.state.tr.setSelection(TextSelection.near($pos)));
+			const $pos = view_46.state.doc.resolve(inside);
+			view_46.dispatch(view_46.state.tr.setSelection(TextSelection.near($pos)));
 			requestAnimationFrame(() => {
 				pagedEditorRef.current?.scrollToPosition(inside);
 			});
 			return true;
 		},
 		setContentControlContent: (filter_1, input, options_4 = {}) => {
-			const view_46 = pagedEditorRef.current?.getView();
-			if (!view_46) return false;
-			const tr_0 = typeof input === "string" ? setContentControlContentTr(view_46.state, filter_1, input, options_4) : setContentControlContentBlocksTr(view_46.state, filter_1, input, options_4);
+			const view_47 = pagedEditorRef.current?.getView();
+			if (!view_47) return false;
+			const tr_0 = typeof input === "string" ? setContentControlContentTr(view_47.state, filter_1, input, options_4) : setContentControlContentBlocksTr(view_47.state, filter_1, input, options_4);
 			if (!tr_0) return false;
-			view_46.dispatch(tr_0);
+			view_47.dispatch(tr_0);
 			return true;
 		},
 		setContentControlValue: (filter_2, input_0, options_5 = {}) => {
-			const view_47 = pagedEditorRef.current?.getView();
-			if (!view_47) return false;
-			const tr_1 = setContentControlValueTr(view_47.state, filter_2, input_0, options_5);
+			const view_48 = pagedEditorRef.current?.getView();
+			if (!view_48) return false;
+			const tr_1 = setContentControlValueTr(view_48.state, filter_2, input_0, options_5);
 			if (!tr_1) return false;
-			view_47.dispatch(tr_1);
+			view_48.dispatch(tr_1);
 			return true;
 		},
 		removeContentControl: (filter_3, options_6 = {}) => {
-			const view_48 = pagedEditorRef.current?.getView();
-			if (!view_48) return false;
-			const tr_2 = removeContentControlTr(view_48.state, filter_3, options_6);
+			const view_49 = pagedEditorRef.current?.getView();
+			if (!view_49) return false;
+			const tr_2 = removeContentControlTr(view_49.state, filter_3, options_6);
 			if (!tr_2) return false;
-			view_48.dispatch(tr_2);
+			view_49.dispatch(tr_2);
 			return true;
 		}
 	}), [
@@ -15242,7 +15298,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		label: t(DISPLAY_MODE_LABEL_KEYS[mode_0])
 	})), [t]);
 	const activeHistoryAvailability = (() => {
-		if (experimentalSession === "canonical") return {
+		if (usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting)) return {
 			canRedo: pagedEditorRef.current?.canRedo() ?? false,
 			canUndo: pagedEditorRef.current?.canUndo() ?? false
 		};
@@ -15297,47 +15353,47 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		if (isDisplayMode(value)) setDisplayMode(value);
 	}, [setDisplayMode]);
 	const handleAcceptActiveChange = useCallback(() => {
-		const view_49 = pagedEditorRef.current?.getView();
-		if (!view_49) return;
-		const { from: from_13, to: to_13 } = view_49.state.selection;
-		const range_7 = findChangeAtPosition(view_49.state, from_13, to_13);
+		const view_50 = pagedEditorRef.current?.getView();
+		if (!view_50) return;
+		const { from: from_13, to: to_13 } = view_50.state.selection;
+		const range_7 = findChangeAtPosition(view_50.state, from_13, to_13);
 		if (resolveCanonicalReviewRange({
 			editor: pagedEditorRef.current?.getEditor(),
 			...range_7,
 			resolution: "accept"
-		}) === null) acceptChange(range_7.from, range_7.to)(view_49.state, view_49.dispatch);
+		}) === null) acceptChange(range_7.from, range_7.to)(view_50.state, view_50.dispatch);
 	}, []);
 	const handleRejectActiveChange = useCallback(() => {
-		const view_50 = pagedEditorRef.current?.getView();
-		if (!view_50) return;
-		const { from: from_14, to: to_14 } = view_50.state.selection;
-		const range_8 = findChangeAtPosition(view_50.state, from_14, to_14);
+		const view_51 = pagedEditorRef.current?.getView();
+		if (!view_51) return;
+		const { from: from_14, to: to_14 } = view_51.state.selection;
+		const range_8 = findChangeAtPosition(view_51.state, from_14, to_14);
 		if (resolveCanonicalReviewRange({
 			editor: pagedEditorRef.current?.getEditor(),
 			...range_8,
 			resolution: "reject"
-		}) === null) rejectChange(range_8.from, range_8.to)(view_50.state, view_50.dispatch);
+		}) === null) rejectChange(range_8.from, range_8.to)(view_51.state, view_51.dispatch);
 	}, []);
 	const handlePreviousChange = useCallback(() => {
-		const view_51 = pagedEditorRef.current?.getView();
-		if (!view_51) return;
-		const { from: from_15 } = view_51.state.selection;
-		const change = findPreviousChange(view_51.state, from_15);
+		const view_52 = pagedEditorRef.current?.getView();
+		if (!view_52) return;
+		const { from: from_15 } = view_52.state.selection;
+		const change = findPreviousChange(view_52.state, from_15);
 		if (!change) return;
-		view_51.dispatch(view_51.state.tr.setSelection(TextSelection.create(view_51.state.doc, change.from, change.to)));
-		view_51.focus();
+		view_52.dispatch(view_52.state.tr.setSelection(TextSelection.create(view_52.state.doc, change.from, change.to)));
+		view_52.focus();
 		requestAnimationFrame(() => {
 			pagedEditorRef.current?.scrollToPosition(change.from);
 		});
 	}, []);
 	const handleNextChange = useCallback(() => {
-		const view_52 = pagedEditorRef.current?.getView();
-		if (!view_52) return;
-		const { to: to_15 } = view_52.state.selection;
-		const change_0 = findNextChange(view_52.state, to_15);
+		const view_53 = pagedEditorRef.current?.getView();
+		if (!view_53) return;
+		const { to: to_15 } = view_53.state.selection;
+		const change_0 = findNextChange(view_53.state, to_15);
 		if (!change_0) return;
-		view_52.dispatch(view_52.state.tr.setSelection(TextSelection.create(view_52.state.doc, change_0.from, change_0.to)));
-		view_52.focus();
+		view_53.dispatch(view_53.state.tr.setSelection(TextSelection.create(view_53.state.doc, change_0.from, change_0.to)));
+		view_53.focus();
 		requestAnimationFrame(() => {
 			pagedEditorRef.current?.scrollToPosition(change_0.from);
 		});
@@ -15507,22 +15563,22 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		requestAnimationFrame(syncCommentHighlightStyles);
 	}, [onScrollTopChange, syncCommentHighlightStyles]);
 	const handlePagedSelectionChange = useCallback((_from, _to) => {
-		const view_53 = getActiveEditorView() ?? pagedEditorRef.current?.getView() ?? null;
-		handleSelectionChange(view_53 ? extractSelectionState(view_53.state) : null);
+		const view_54 = getActiveEditorView() ?? pagedEditorRef.current?.getView() ?? null;
+		handleSelectionChange(view_54 ? extractSelectionState(view_54.state) : null);
 	}, [getActiveEditorView, handleSelectionChange]);
 	const handleTotalPagesChange = useCallback((totalPages) => {
 		setScrollPageInfo((previous) => updateScrollPageTotal(previous, totalPages));
 	}, [setScrollPageInfo]);
 	const handleCommentClick = useCallback((id) => setActiveCommentId(id), [setActiveCommentId]);
 	const handleCommentResolve = useCallback((id_0) => {
-		if (refuseCanonicalModelEdit("Comment changes are unavailable in this session.")) return;
+		if (refuseCanonicalModelEdit(CANONICAL_GAP.comments, "Comment changes are unavailable in this session.")) return;
 		updateComments((previous_0) => previous_0.map((comment_2) => comment_2.id === id_0 ? {
 			...comment_2,
 			done: true
 		} : comment_2));
 	}, [refuseCanonicalModelEdit, updateComments]);
 	const handleCommentDelete = useCallback((id_1) => {
-		if (refuseCanonicalModelEdit("Comment changes are unavailable in this session.")) return;
+		if (refuseCanonicalModelEdit(CANONICAL_GAP.comments, "Comment changes are unavailable in this session.")) return;
 		updateComments((previous_1) => previous_1.filter((comment_3) => comment_3.id !== id_1 && comment_3.parentId !== id_1));
 		if (activeCommentId === id_1) setActiveCommentId(null);
 	}, [
@@ -15532,7 +15588,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		updateComments
 	]);
 	const handleCommentReply = useCallback((id_2, text_6) => {
-		if (refuseCanonicalModelEdit("Comment changes are unavailable in this session.")) return;
+		if (refuseCanonicalModelEdit(CANONICAL_GAP.comments, "Comment changes are unavailable in this session.")) return;
 		updateComments((previous_2) => [...previous_2, createComment(text_6, author, id_2)]);
 	}, [
 		author,
@@ -15541,11 +15597,11 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		updateComments
 	]);
 	const handleAddComment = useCallback((addText) => {
-		if (refuseCanonicalModelEdit("Comment changes are unavailable in this session.")) return false;
+		if (refuseCanonicalModelEdit(CANONICAL_GAP.comments, "Comment changes are unavailable in this session.")) return false;
 		const comment_4 = createComment(addText, author);
-		const view_54 = pagedEditorRef.current?.getView();
-		if (!view_54 || !commentSelectionRange) return false;
-		if (!applyCommentMarkRange(view_54, commentSelectionRange, comment_4.id, { replacePending: true })) return false;
+		const view_55 = pagedEditorRef.current?.getView();
+		if (!view_55 || !commentSelectionRange) return false;
+		if (!applyCommentMarkRange(view_55, commentSelectionRange, comment_4.id, { replacePending: true })) return false;
 		const commentAuthor_2 = getCommentAuthorKey(comment_4.author);
 		setVisibleCommentAuthors((current_0) => {
 			if (current_0 === null) return null;
@@ -15578,7 +15634,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		updateComments
 	]);
 	const handleTrackedChangeReply = useCallback((revisionId_2, text_7) => {
-		if (refuseCanonicalModelEdit("Comment changes are unavailable in this session.")) return;
+		if (refuseCanonicalModelEdit(CANONICAL_GAP.comments, "Comment changes are unavailable in this session.")) return;
 		updateComments((previous_4) => [...previous_4, createComment(text_7, author, revisionId_2)]);
 	}, [
 		author,
@@ -15587,8 +15643,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		updateComments
 	]);
 	const handleCancelAddComment = useCallback(() => {
-		const view_55 = pagedEditorRef.current?.getView();
-		if (view_55 && commentSelectionRange) removePendingCommentMarkRange(view_55, commentSelectionRange);
+		const view_56 = pagedEditorRef.current?.getView();
+		if (view_56 && commentSelectionRange) removePendingCommentMarkRange(view_56, commentSelectionRange);
 		setIsAddingComment(false);
 		setCommentSelectionRange(null);
 		setAddCommentYPosition(null);
@@ -15604,23 +15660,23 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		})?.revisionId ?? null;
 	}, []);
 	const handleSidebarAcceptChange = useCallback((from_17, to_17) => {
-		const view_56 = pagedEditorRef.current?.getView();
-		if (!view_56) return;
+		const view_57 = pagedEditorRef.current?.getView();
+		if (!view_57) return;
 		const revisionId_3 = resolveSidebarChangeRevisionId(from_17, to_17);
 		if (revisionId_3 === null) return;
-		const editor_5 = pagedEditorRef.current?.getEditor();
-		if (editor_5?.getCanonicalDocument()) editor_5.resolveCanonicalRevisions([revisionId_3], "accept");
-		else acceptAIEditRevision(revisionId_3)(view_56.state, view_56.dispatch);
+		const editor_6 = pagedEditorRef.current?.getEditor();
+		if (editor_6?.getCanonicalDocument()) editor_6.resolveCanonicalRevisions([revisionId_3], "accept");
+		else acceptAIEditRevision(revisionId_3)(view_57.state, view_57.dispatch);
 		extractTrackedChanges();
 	}, [extractTrackedChanges, resolveSidebarChangeRevisionId]);
 	const handleSidebarRejectChange = useCallback((from_18, to_18) => {
-		const view_57 = pagedEditorRef.current?.getView();
-		if (!view_57) return;
+		const view_58 = pagedEditorRef.current?.getView();
+		if (!view_58) return;
 		const revisionId_4 = resolveSidebarChangeRevisionId(from_18, to_18);
 		if (revisionId_4 === null) return;
-		const editor_6 = pagedEditorRef.current?.getEditor();
-		if (editor_6?.getCanonicalDocument()) editor_6.resolveCanonicalRevisions([revisionId_4], "reject");
-		else rejectAIEditRevision(revisionId_4)(view_57.state, view_57.dispatch);
+		const editor_7 = pagedEditorRef.current?.getEditor();
+		if (editor_7?.getCanonicalDocument()) editor_7.resolveCanonicalRevisions([revisionId_4], "reject");
+		else rejectAIEditRevision(revisionId_4)(view_58.state, view_58.dispatch);
 		extractTrackedChanges();
 	}, [extractTrackedChanges, resolveSidebarChangeRevisionId]);
 	const commentsPageWidth = history.state?.package.document.finalSectionProperties?.pageWidth;
@@ -15763,8 +15819,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	}, [readOnly]);
 	const closeTableProperties = useCallback(() => setTablePropsOpen(false), []);
 	const applyTableProperties = useCallback((props_0) => {
-		const view_58 = getActiveEditorView();
-		if (view_58) setTableProperties(props_0)(view_58.state, view_58.dispatch);
+		const view_59 = getActiveEditorView();
+		if (view_59) setTableProperties(props_0)(view_59.state, view_59.dispatch);
 	}, [getActiveEditorView]);
 	const closeImagePosition = useCallback(() => setImagePositionOpen(false), [setImagePositionOpen]);
 	const closeImageProperties = useCallback(() => setImagePropsOpen(false), [setImagePropsOpen]);
@@ -15772,8 +15828,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	const closeFootnoteProperties = useCallback(() => setFootnotePropsOpen(false), []);
 	const closeInsertSymbol = useCallback(() => setShowInsertSymbol(false), []);
 	const insertSymbol = useCallback((symbol) => {
-		const view_59 = getActiveEditorView();
-		if (view_59) view_59.dispatch(view_59.state.tr.insertText(symbol).scrollIntoView());
+		const view_60 = getActiveEditorView();
+		if (view_60) view_60.dispatch(view_60.state.tr.insertText(symbol).scrollIntoView());
 	}, [getActiveEditorView]);
 	const imagePropertiesCurrentData = useMemo(() => buildImagePropertiesData(state.pmImageContext), [state.pmImageContext]);
 	const currentFindResult = findResultRef.current;
@@ -15856,8 +15912,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	]);
 	const closeNumberingValueDialog = useCallback(() => setNumberingValueDialogOpen(false), []);
 	const applyNumberingValue = useCallback((value_0) => {
-		const view_60 = getActiveEditorView();
-		if (view_60) setNumberingValue(value_0)(view_60.state, view_60.dispatch);
+		const view_61 = getActiveEditorView();
+		if (view_61) setNumberingValue(value_0)(view_61.state, view_61.dispatch);
 	}, [getActiveEditorView]);
 	const numberingValueDialog = useMemo(() => ({
 		isOpen: numberingValueDialogOpen,
@@ -16119,7 +16175,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 															showMarginGuides,
 															...marginGuideColor !== void 0 ? { marginGuideColor } : {},
 															readOnly,
-															...experimentalSession === void 0 ? {} : { experimentalSession },
+															...!usesCanonicalSession(experimentalSession, CANONICAL_GAP.authorityRouting) ? {} : { experimentalSession },
 															onDocumentChange: handleDocumentChange,
 															extensionManager,
 															suggestionModeActive: editingMode === "suggesting",
@@ -16156,8 +16212,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 																onMouseDown: (e_1) => {
 																	e_1.preventDefault();
 																	e_1.stopPropagation();
-																	const view_61 = pagedEditorRef.current?.getView();
-																	if (!view_61) {
+																	const view_62 = pagedEditorRef.current?.getView();
+																	if (!view_62) {
 																		setFloatingCommentBtn(null);
 																		return;
 																	}
@@ -16165,9 +16221,9 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 																		from: floatingCommentBtn.from,
 																		to: floatingCommentBtn.to
 																	};
-																	const currentSelection = view_61.state.selection;
+																	const currentSelection = view_62.state.selection;
 																	const safeRange = resolveCommentCreationRange({
-																		docSize: view_61.state.doc.content.size,
+																		docSize: view_62.state.doc.content.size,
 																		capturedRange,
 																		currentRange: {
 																			from: currentSelection.from,
@@ -16181,7 +16237,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 																		return;
 																	}
 																	setCommentSelectionRange(safeRange);
-																	if (!applyCommentMarkRange(view_61, safeRange, -1, { selectEnd: true })) {
+																	if (!applyCommentMarkRange(view_62, safeRange, -1, { selectEnd: true })) {
 																		setCommentSelectionRange(null);
 																		setFloatingCommentBtn(null);
 																		return;