@stll/folio-react 0.24.2 → 0.25.0

package/dist/{renderAsync-6eWf0MfZ.js → renderAsync-yYZKXh6r.js}

@@ -7,6 +7,7 @@ import { AlertCircleIcon, AlertTriangleIcon, AlignCenterIcon, AlignJustifyIcon,
 import { closeHistory, redo, undo } from "prosemirror-history";
 import { IntlProvider, useFormatter, useTranslations } from "use-intl";
 import { FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FolioPendingSuggestionRegistry, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, createFolioAIEditSnapshot, createPendingSuggestionSourceSnapshot, getCommentAnchorsFromDoc, getFolioDocumentOperationIssues, getTrackedChangesFromDoc } from "@stll/folio-core/ai-edits";
+import { resolveCanonicalReviewRange } from "@stll/folio-core/controller/canonicalReview";
 import { resolveActiveEditorStory } from "@stll/folio-core/controller/activeEditorStory";
 import { FOLIO_DOCX_SERIALIZATION_MODE, createFolioEditor } from "@stll/folio-core/controller/folioEditor";
 import { createNoteReferenceFollower, withoutUnreferencedNotes } from "@stll/folio-core/prosemirror/noteReferenceReview";
@@ -23,6 +24,8 @@ import { setContentControlContentBlocksTr } from "@stll/folio-core/prosemirror/c
 import { CLIPBOARD_READ_ERROR_EVENT, buildPlainTextSlice } from "@stll/folio-core/prosemirror/commands/pastePlainText";
 import { proseDocToBlocks } from "@stll/folio-core/prosemirror/conversion/fromProseDoc";
 import { ExtensionManager } from "@stll/folio-core/prosemirror/extensions/ExtensionManager";
+import { executeEditorCommand, executeFirstEditorCommand } from "@stll/folio-core/prosemirror/executeEditorCommand";
+import { insertPageBreak } from "@stll/folio-core/prosemirror/commands/pageBreak";
 import { clearTrackedChanges, getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges, repackWithEditorSectionRemovals } from "@stll/folio-core/prosemirror/extensions/features/ParagraphChangeTrackerExtension";
 import { createStarterKit } from "@stll/folio-core/prosemirror/extensions/StarterKit";
 import { resolveFindMatchRange } from "@stll/folio-core/prosemirror/findReplaceSelection";
@@ -41,6 +44,8 @@ import { onFontsLoaded } from "@stll/folio-core/utils/fontLoader";
 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 { 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 { createPortal } from "react-dom";
@@ -52,6 +57,7 @@ import { createNoteEditorManager } from "@stll/folio-core/controller/noteEditorM
 import { projectMarkupView, visibleCaretPosition } from "@stll/folio-core/prosemirror/markupViewProjection";
 import { createFolioAIEditSnapshot as createFolioAIEditSnapshot$1 } from "@stll/folio-core/ai-edits/snapshot";
 import { createFolioEditorEmitter } from "@stll/folio-core/controller/folioEditorEvents";
+import { CanonicalSessionRefusalError, collectRemoteSelections, createHiddenEditorManager, createHiddenEditorState } from "@stll/folio-core/controller/hiddenEditorManager";
 import { dispatchEditorTextInput } from "@stll/folio-core/prosemirror/textInput";
 import { createLatestRequestGate } from "@stll/folio-core/controller/latestRequestGate";
 import { runLayoutPipeline } from "@stll/folio-core/controller/layoutPipeline";
@@ -91,7 +97,6 @@ import { allowsDirectDrawingEdit } from "@stll/folio-core/docx/imageRawXml";
 import { commitImageFloatMove, commitImageInlineMove, commitImageResize, isFloatingImage } from "@stll/folio-core/prosemirror/imageCommit";
 import { buildEmbeddedFontFamilyMap, extractEmbeddedFonts } from "@stll/folio-core/fonts/embeddedFonts";
 import { panic } from "better-result";
-import { collectRemoteSelections, createHiddenEditorManager, createHiddenEditorState } from "@stll/folio-core/controller/hiddenEditorManager";
 import { loadCollaborationModules } from "@stll/folio-core/controller/collaborationModules";
 import { createVisualLineState, handleVisualLineKeyDown } from "@stll/folio-core/prosemirror/utils/visualLineNavigation";
 import { clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange } from "@stll/folio-core/ai-edits/blockRange";
@@ -339,22 +344,31 @@ const HOST_STYLES = {
 	zIndex: -1,
 	pointerEvents: "none"
 };
-const HiddenHeaderFooterPMs = memo(forwardRef(function HiddenHeaderFooterPMs({ document, styles, theme, onTransaction }, ref) {
+const HiddenHeaderFooterPMs = memo(forwardRef(function HiddenHeaderFooterPMs({ document, styles, theme, onTransaction, experimentalSession, getCanonicalApi, onSessionRefusal }, ref) {
 	const hostRef = useRef(null);
 	const documentRef = useRef(document);
 	const stylesRef = useRef(styles);
 	const themeRef = useRef(theme);
 	const onTransactionRef = useRef(onTransaction);
+	const canonicalApiRef = useRef(getCanonicalApi);
+	const sessionRef = useRef(experimentalSession);
+	const refusalRef = useRef(onSessionRefusal);
 	documentRef.current = document;
 	stylesRef.current = styles;
 	themeRef.current = theme;
 	onTransactionRef.current = onTransaction;
+	canonicalApiRef.current = getCanonicalApi;
+	sessionRef.current = experimentalSession;
+	refusalRef.current = onSessionRefusal;
 	const managerRef = useRef(null);
 	managerRef.current ??= createHeaderFooterEditorManager({
 		getHost: () => hostRef.current,
 		getDocument: () => documentRef.current,
 		getStyles: () => stylesRef.current,
 		getTheme: () => themeRef.current,
+		getCanonicalApi: () => canonicalApiRef.current?.() ?? null,
+		getExperimentalSession: () => sessionRef.current,
+		onSessionRefusal: (reason) => refusalRef.current?.(reason),
 		onTransaction: ({ rId, kind, view, docChanged, selectionChanged }) => {
 			onTransactionRef.current?.(rId, kind, view, docChanged, selectionChanged);
 		}
@@ -420,13 +434,16 @@ const hostStyle = {
 };
 const EMPTY_PLUGINS$1 = [];
 const NoteStoryEditor = forwardRef(function NoteStoryEditor(t0, ref) {
-	const $ = c(51);
-	const { document, onActiveChange, onDocumentChange, onStoryChange, plugins, styles, suggestionAuthor, suggestionModeActive, theme } = t0;
+	const $ = c(57);
+	const { document, experimentalSession, getCanonicalApi, onSessionRefusal, onActiveChange, onDocumentChange, onStoryChange, plugins, styles, suggestionAuthor, suggestionModeActive, theme } = t0;
 	const t = useTranslations("folio");
 	const resolvedPlugins = plugins ?? EMPTY_PLUGINS$1;
 	const isSuggestionModeActive = suggestionModeActive ?? false;
 	const hostRef = useRef(null);
 	const documentRef = useRef(document);
+	const canonicalApiRef = useRef(getCanonicalApi);
+	const sessionRef = useRef(experimentalSession);
+	const refusalRef = useRef(onSessionRefusal);
 	const stylesRef = useRef(styles);
 	const themeRef = useRef(theme);
 	const pluginsRef = useRef(resolvedPlugins);
@@ -438,9 +455,12 @@ const NoteStoryEditor = forwardRef(function NoteStoryEditor(t0, ref) {
 	const footnotes = document?.package.footnotes;
 	const endnotes = document?.package.endnotes;
 	let t1;
-	if ($[0] !== active || $[1] !== document || $[2] !== onActiveChange || $[3] !== onDocumentChange || $[4] !== onStoryChange || $[5] !== resolvedPlugins || $[6] !== styles || $[7] !== theme) {
+	if ($[0] !== active || $[1] !== document || $[2] !== experimentalSession || $[3] !== getCanonicalApi || $[4] !== onActiveChange || $[5] !== onDocumentChange || $[6] !== onSessionRefusal || $[7] !== onStoryChange || $[8] !== resolvedPlugins || $[9] !== styles || $[10] !== theme) {
 		t1 = () => {
 			documentRef.current = document;
+			canonicalApiRef.current = getCanonicalApi;
+			sessionRef.current = experimentalSession;
+			refusalRef.current = onSessionRefusal;
 			stylesRef.current = styles;
 			themeRef.current = theme;
 			pluginsRef.current = resolvedPlugins;
@@ -453,9 +473,15 @@ const NoteStoryEditor = forwardRef(function NoteStoryEditor(t0, ref) {
 				getPlugins: () => pluginsRef.current,
 				getStyles: () => stylesRef.current,
 				getTheme: () => themeRef.current,
+				getCanonicalApi: () => canonicalApiRef.current?.() ?? null,
+				getExperimentalSession: () => sessionRef.current,
+				onSessionRefusal: (reason) => refusalRef.current?.(reason),
 				onTransaction: (t2) => {
 					const { docChanged, selectionChanged, view } = t2;
-					if (docChanged) {
+					if (docChanged) if (sessionRef.current === "canonical") {
+						const canonical = canonicalApiRef.current?.()?.getCanonicalDocument();
+						if (canonical) onDocumentChangeRef.current(canonical);
+					} else {
 						const current = documentRef.current;
 						if (current) onDocumentChangeRef.current(managerRef.current?.snapshotDocument(current) ?? current);
 					}
@@ -471,44 +497,53 @@ const NoteStoryEditor = forwardRef(function NoteStoryEditor(t0, ref) {
 		};
 		$[0] = active;
 		$[1] = document;
-		$[2] = onActiveChange;
-		$[3] = onDocumentChange;
-		$[4] = onStoryChange;
-		$[5] = resolvedPlugins;
-		$[6] = styles;
-		$[7] = theme;
-		$[8] = t1;
-	} else t1 = $[8];
+		$[2] = experimentalSession;
+		$[3] = getCanonicalApi;
+		$[4] = onActiveChange;
+		$[5] = onDocumentChange;
+		$[6] = onSessionRefusal;
+		$[7] = onStoryChange;
+		$[8] = resolvedPlugins;
+		$[9] = styles;
+		$[10] = theme;
+		$[11] = t1;
+	} else t1 = $[11];
 	let t2;
-	if ($[9] !== active || $[10] !== document || $[11] !== endnotes || $[12] !== footnotes || $[13] !== onActiveChange || $[14] !== onDocumentChange || $[15] !== onStoryChange || $[16] !== resolvedPlugins || $[17] !== styles || $[18] !== theme) {
+	if ($[12] !== active || $[13] !== document || $[14] !== endnotes || $[15] !== experimentalSession || $[16] !== footnotes || $[17] !== getCanonicalApi || $[18] !== onActiveChange || $[19] !== onDocumentChange || $[20] !== onSessionRefusal || $[21] !== onStoryChange || $[22] !== resolvedPlugins || $[23] !== styles || $[24] !== theme) {
 		t2 = [
 			active,
 			document,
 			endnotes,
+			experimentalSession,
 			footnotes,
+			getCanonicalApi,
 			onActiveChange,
 			onDocumentChange,
+			onSessionRefusal,
 			onStoryChange,
 			resolvedPlugins,
 			styles,
 			theme
 		];
-		$[9] = active;
-		$[10] = document;
-		$[11] = endnotes;
-		$[12] = footnotes;
-		$[13] = onActiveChange;
-		$[14] = onDocumentChange;
-		$[15] = onStoryChange;
-		$[16] = resolvedPlugins;
-		$[17] = styles;
-		$[18] = theme;
-		$[19] = t2;
-	} else t2 = $[19];
+		$[12] = active;
+		$[13] = document;
+		$[14] = endnotes;
+		$[15] = experimentalSession;
+		$[16] = footnotes;
+		$[17] = getCanonicalApi;
+		$[18] = onActiveChange;
+		$[19] = onDocumentChange;
+		$[20] = onSessionRefusal;
+		$[21] = onStoryChange;
+		$[22] = resolvedPlugins;
+		$[23] = styles;
+		$[24] = theme;
+		$[25] = t2;
+	} else t2 = $[25];
 	useEffect(t1, t2);
 	let t3;
 	let t4;
-	if ($[20] !== isSuggestionModeActive || $[21] !== suggestionAuthor) {
+	if ($[26] !== isSuggestionModeActive || $[27] !== suggestionAuthor) {
 		t3 = () => {
 			const manager_0 = managerRef.current;
 			if (!manager_0) return;
@@ -518,41 +553,41 @@ const NoteStoryEditor = forwardRef(function NoteStoryEditor(t0, ref) {
 			}
 		};
 		t4 = [isSuggestionModeActive, suggestionAuthor];
-		$[20] = isSuggestionModeActive;
-		$[21] = suggestionAuthor;
-		$[22] = t3;
-		$[23] = t4;
+		$[26] = isSuggestionModeActive;
+		$[27] = suggestionAuthor;
+		$[28] = t3;
+		$[29] = t4;
 	} else {
-		t3 = $[22];
-		t4 = $[23];
+		t3 = $[28];
+		t4 = $[29];
 	}
 	useEffect(t3, t4);
 	let t5;
 	let t6;
-	if ($[24] === Symbol.for("react.memo_cache_sentinel")) {
+	if ($[30] === Symbol.for("react.memo_cache_sentinel")) {
 		t5 = () => () => {
 			managerRef.current?.destroy();
 		};
 		t6 = [];
-		$[24] = t5;
-		$[25] = t6;
+		$[30] = t5;
+		$[31] = t6;
 	} else {
-		t5 = $[24];
-		t6 = $[25];
+		t5 = $[30];
+		t6 = $[31];
 	}
 	useEffect(t5, t6);
 	let t7;
-	if ($[26] === Symbol.for("react.memo_cache_sentinel")) {
+	if ($[32] === Symbol.for("react.memo_cache_sentinel")) {
 		t7 = () => {
 			managerRef.current?.activate(null);
 			setActive(null);
 			onActiveChangeRef.current(null);
 		};
-		$[26] = t7;
-	} else t7 = $[26];
+		$[32] = t7;
+	} else t7 = $[32];
 	const closeEditor = t7;
 	let t8;
-	if ($[27] !== isSuggestionModeActive || $[28] !== suggestionAuthor) {
+	if ($[33] !== isSuggestionModeActive || $[34] !== suggestionAuthor) {
 		t8 = () => ({
 			close: closeEditor,
 			getActiveView: () => {
@@ -569,63 +604,63 @@ const NoteStoryEditor = forwardRef(function NoteStoryEditor(t0, ref) {
 			},
 			snapshotDocument: (current_0) => managerRef.current?.snapshotDocument(current_0) ?? current_0
 		});
-		$[27] = isSuggestionModeActive;
-		$[28] = suggestionAuthor;
-		$[29] = t8;
-	} else t8 = $[29];
+		$[33] = isSuggestionModeActive;
+		$[34] = suggestionAuthor;
+		$[35] = t8;
+	} else t8 = $[35];
 	useImperativeHandle(ref, t8);
 	let t9;
-	if ($[30] !== active || $[31] !== t) {
+	if ($[36] !== active || $[37] !== t) {
 		t9 = active ? t(active.kind === "footnote" ? "dialogs.footnoteProperties.footnotes" : "dialogs.footnoteProperties.endnotes") : "";
-		$[30] = active;
-		$[31] = t;
-		$[32] = t9;
-	} else t9 = $[32];
+		$[36] = active;
+		$[37] = t;
+		$[38] = t9;
+	} else t9 = $[38];
 	const title = t9;
 	const t10 = active ? "block" : "none";
 	let t11;
-	if ($[33] !== t10) {
+	if ($[39] !== t10) {
 		t11 = {
 			...panelStyle,
 			display: t10
 		};
-		$[33] = t10;
-		$[34] = t11;
-	} else t11 = $[34];
+		$[39] = t10;
+		$[40] = t11;
+	} else t11 = $[40];
 	let t12;
-	if ($[35] === Symbol.for("react.memo_cache_sentinel")) {
+	if ($[41] === Symbol.for("react.memo_cache_sentinel")) {
 		t12 = (event) => {
 			if (event.key !== "Escape") return;
 			event.preventDefault();
 			event.stopPropagation();
 			closeEditor();
 		};
-		$[35] = t12;
-	} else t12 = $[35];
+		$[41] = t12;
+	} else t12 = $[41];
 	let t13;
-	if ($[36] !== title) {
+	if ($[42] !== title) {
 		t13 = /* @__PURE__ */ jsx("span", { children: title });
-		$[36] = title;
-		$[37] = t13;
-	} else t13 = $[37];
+		$[42] = title;
+		$[43] = t13;
+	} else t13 = $[43];
 	let t14;
-	if ($[38] !== t) {
+	if ($[44] !== t) {
 		t14 = t("common.closeDialog");
-		$[38] = t;
-		$[39] = t14;
-	} else t14 = $[39];
+		$[44] = t;
+		$[45] = t14;
+	} else t14 = $[45];
 	let t15;
-	if ($[40] === Symbol.for("react.memo_cache_sentinel")) {
+	if ($[46] === Symbol.for("react.memo_cache_sentinel")) {
 		t15 = {
 			border: 0,
 			background: "transparent",
 			color: "inherit",
 			cursor: "pointer"
 		};
-		$[40] = t15;
-	} else t15 = $[40];
+		$[46] = t15;
+	} else t15 = $[46];
 	let t16;
-	if ($[41] !== t14) {
+	if ($[47] !== t14) {
 		t16 = /* @__PURE__ */ jsx("button", {
 			type: "button",
 			"aria-label": t14,
@@ -633,40 +668,40 @@ const NoteStoryEditor = forwardRef(function NoteStoryEditor(t0, ref) {
 			style: t15,
 			children: "×"
 		});
-		$[41] = t14;
-		$[42] = t16;
-	} else t16 = $[42];
+		$[47] = t14;
+		$[48] = t16;
+	} else t16 = $[48];
 	let t17;
-	if ($[43] !== t13 || $[44] !== t16) {
+	if ($[49] !== t13 || $[50] !== t16) {
 		t17 = /* @__PURE__ */ jsxs("div", {
 			style: headerStyle,
 			children: [t13, t16]
 		});
-		$[43] = t13;
-		$[44] = t16;
-		$[45] = t17;
-	} else t17 = $[45];
+		$[49] = t13;
+		$[50] = t16;
+		$[51] = t17;
+	} else t17 = $[51];
 	let t18;
-	if ($[46] === Symbol.for("react.memo_cache_sentinel")) {
+	if ($[52] === Symbol.for("react.memo_cache_sentinel")) {
 		t18 = /* @__PURE__ */ jsx("div", {
 			ref: hostRef,
 			style: hostStyle
 		});
-		$[46] = t18;
-	} else t18 = $[46];
+		$[52] = t18;
+	} else t18 = $[52];
 	let t19;
-	if ($[47] !== t11 || $[48] !== t17 || $[49] !== title) {
+	if ($[53] !== t11 || $[54] !== t17 || $[55] !== title) {
 		t19 = /* @__PURE__ */ jsxs("aside", {
 			style: t11,
 			"aria-label": title,
 			onKeyDown: t12,
 			children: [t17, t18]
 		});
-		$[47] = t11;
-		$[48] = t17;
-		$[49] = title;
-		$[50] = t19;
-	} else t19 = $[50];
+		$[53] = t11;
+		$[54] = t17;
+		$[55] = title;
+		$[56] = t19;
+	} else t19 = $[56];
 	return t19;
 });
 NoteStoryEditor.displayName = "NoteStoryEditor";
@@ -1218,12 +1253,16 @@ const HIDDEN_HOST_STYLES = {
 * HiddenProseMirror - Off-screen ProseMirror editor for keyboard input
 */
 const HiddenProseMirror = forwardRef((props, ref) => {
-	const { document, documentIdentity, styles, theme: _theme, widthPx = 612, readOnly = false, onTransaction, onSelectionChange, externalPlugins = EMPTY_EXTERNAL_PLUGINS, collaboration, extensionManager, onEditorViewReady, onEditorViewDestroy, onKeyDown, onCopy, onCut, onPaste, onReadOnlyEditAttempt, onRemoteSelectionsChange, precomputedInitialState } = props;
+	const { document, documentIdentity, experimentalSession, suggestionModeActive = false, suggestionAuthor = "User", onSessionRefusal, styles, theme: _theme, widthPx = 612, readOnly = false, onTransaction, onSelectionChange, externalPlugins = EMPTY_EXTERNAL_PLUGINS, collaboration, extensionManager, onEditorViewReady, onEditorViewDestroy, onKeyDown, onCopy, onCut, onPaste, onReadOnlyEditAttempt, onRemoteSelectionsChange, precomputedInitialState } = props;
 	const [collaborationModules, setCollaborationModules] = useState(null);
 	const [collaborationModulesError, setCollaborationModulesError] = useState(null);
 	const hasCollaboration = collaboration !== void 0;
 	const hostRef = useRef(null);
 	const readOnlyRef = useRef(readOnly);
+	const experimentalSessionRef = useRef(experimentalSession);
+	const suggestionModeActiveRef = useRef(suggestionModeActive);
+	const suggestionAuthorRef = useRef(suggestionAuthor);
+	const onSessionRefusalRef = useRef(onSessionRefusal);
 	const documentRef = useRef(document);
 	const documentIdentityRef = useRef(documentIdentity);
 	const stylesRef = useRef(styles);
@@ -1243,6 +1282,10 @@ const HiddenProseMirror = forwardRef((props, ref) => {
 	const onReadOnlyEditAttemptRef = useRef(onReadOnlyEditAttempt);
 	const onRemoteSelectionsChangeRef = useRef(onRemoteSelectionsChange);
 	readOnlyRef.current = readOnly;
+	experimentalSessionRef.current = experimentalSession;
+	suggestionModeActiveRef.current = suggestionModeActive;
+	suggestionAuthorRef.current = suggestionAuthor;
+	onSessionRefusalRef.current = onSessionRefusal;
 	stylesRef.current = styles;
 	extensionManagerRef.current = extensionManager;
 	externalPluginsRef.current = externalPlugins;
@@ -1272,6 +1315,10 @@ const HiddenProseMirror = forwardRef((props, ref) => {
 		getCollaborationModules: () => collaborationModulesRef.current,
 		getPrecomputedInitialState: () => precomputedInitialStateRef.current,
 		getReadOnly: () => readOnlyRef.current,
+		getExperimentalSession: () => experimentalSessionRef.current,
+		getEditingMode: () => suggestionModeActiveRef.current ? "suggesting" : "editing",
+		getSuggestionAuthor: () => suggestionAuthorRef.current,
+		onSessionRefusal: (reason) => onSessionRefusalRef.current?.(reason),
 		getDocumentIdentity: () => documentIdentityRef.current,
 		getDocumentContext: () => documentRef.current,
 		onTransaction: (update) => onTransactionRef.current?.(update),
@@ -1331,13 +1378,19 @@ const HiddenProseMirror = forwardRef((props, ref) => {
 	}, []);
 	useLayoutEffect(() => {
 		managerRef.current?.retryViewCreation();
-	}, [collaboration, collaborationModules]);
+	}, [
+		collaboration,
+		collaborationModules,
+		experimentalSession
+	]);
 	useEffect(() => () => destroyView(), [destroyView]);
 	useEffect(() => {
 		managerRef.current?.syncExternalDocument();
 	}, [
 		document,
 		documentIdentity,
+		experimentalSession,
+		suggestionModeActive,
 		styles,
 		extensionManager,
 		externalPlugins,
@@ -2819,7 +2872,7 @@ function buildFootnoteRenderItems(pageFootnoteMap, footnoteContentMap, doc) {
 * PagedEditor - Main paginated editing component.
 */
 const PagedEditor = forwardRef(function PagedEditor(props, ref) {
-	const { document, documentIO, documentIdentity, fonts: hostFonts, styles, theme: _theme, sectionProperties, headerContent, footerContent, firstPageHeaderContent, firstPageFooterContent, headerContentRId, footerContentRId, firstPageHeaderContentRId, firstPageFooterContentRId, readOnly = false, pageGap = 24, zoom = 1, pageRenderer, markupView, showMarginGuides = false, marginGuideColor, onDocumentChange, onReadOnlyEditAttempt, onCopy, onCut, onPaste, onSelectionChange, onSelectionTextChange, onEditorViewReady, externalPlugins = EMPTY_PLUGINS, showTemplateDirectives = true, collaboration, extensionManager, suggestionModeActive = false, suggestionAuthor, onActiveNoteStoryChange, onHeaderFooterDoubleClick, hfEditMode, activeHeaderFooterRId, onBodyClick, className, style, pageEndGutter = 0, sidebarOverlay, scrollContainerRef: scrollContainerRefProp, onHyperlinkClick, onContextMenu, onAnchorPositionsChange, onTotalPagesChange, onError, anchorPositionMode = "comments-and-revisions", onAnonymizationTermClick, selectedAnonymizationCanonical = null, anonymizationSelectionSeq } = props;
+	const { document, documentIO, documentIdentity, experimentalSession, fonts: hostFonts, styles, theme: _theme, sectionProperties, headerContent, footerContent, firstPageHeaderContent, firstPageFooterContent, headerContentRId, footerContentRId, firstPageHeaderContentRId, firstPageFooterContentRId, readOnly = false, pageGap = 24, zoom = 1, pageRenderer, markupView, showMarginGuides = false, marginGuideColor, onDocumentChange, onReadOnlyEditAttempt, onCopy, onCut, onPaste, onSelectionChange, onSelectionTextChange, onEditorViewReady, externalPlugins = EMPTY_PLUGINS, showTemplateDirectives = true, collaboration, extensionManager, suggestionModeActive = false, suggestionAuthor, onActiveNoteStoryChange, onHeaderFooterDoubleClick, hfEditMode, activeHeaderFooterRId, onBodyClick, className, style, pageEndGutter = 0, sidebarOverlay, scrollContainerRef: scrollContainerRefProp, onHyperlinkClick, onContextMenu, onAnchorPositionsChange, onTotalPagesChange, onError, anchorPositionMode = "comments-and-revisions", onAnonymizationTermClick, selectedAnonymizationCanonical = null, anonymizationSelectionSeq } = props;
 	const getScrollContainer = useCallback(() => {
 		if (scrollContainerRefProp && typeof scrollContainerRefProp === "object") return getEditorScrollRoot(scrollContainerRefProp.current);
 		return getEditorScrollRoot(containerRef.current);
@@ -2837,16 +2890,19 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 	const hiddenPMRef = useRef(null);
 	const hfPMsRef = useRef(null);
 	const noteEditorRef = useRef(null);
+	const activeNoteStoryRef = useRef(null);
 	const [noteStoryActive, setNoteStoryActive] = useState(false);
 	const painterRef = useRef(null);
 	const noteStoryPlugins = useMemo(() => externalPlugins.filter(({ spec }) => spec.key === suggestionModeKey), [externalPlugins]);
 	const handleActiveNoteStoryChange = useCallback((story) => {
+		activeNoteStoryRef.current = story;
 		setNoteStoryActive(story !== null);
 		onActiveNoteStoryChange?.(story);
 	}, [onActiveNoteStoryChange]);
 	useEffect(() => {
-		if (readOnly) noteEditorRef.current?.close();
-	}, [readOnly]);
+		if (readOnly || experimentalSession === "canonical") noteEditorRef.current?.close();
+	}, [experimentalSession, readOnly]);
+	const getCanonicalApi = useCallback(() => hiddenPMRef.current, []);
 	const { handlePMKeyDown } = useVisualLineNavigation({ pagesContainerRef });
 	const handleHiddenEditorKeyDown = useCallback((view, event) => {
 		if (getTemplateSlashMenu(view.state).active) return false;
@@ -2866,6 +2922,9 @@ 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 [layout, setLayout] = useState(null);
 	const layoutRef = useRef(layout);
 	layoutRef.current = layout;
@@ -2987,12 +3046,18 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		queuedInputBeforeHiddenEditorRef.current = [];
 		for (const input of queuedInput) {
 			if (input.type === "text") {
-				dispatchEditorTextInput(view_0, input.text);
+				if (experimentalSession === "canonical") view_0.dom.dispatchEvent(new InputEvent("beforeinput", {
+					inputType: "insertText",
+					data: input.text,
+					cancelable: true,
+					bubbles: true
+				}));
+				else dispatchEditorTextInput(view_0, input.text);
 				continue;
 			}
 			replayDeferredKeyDown(view_0, input.eventInit);
 		}
-	}, []);
+	}, [experimentalSession]);
 	useEffect(() => {
 		if (collaboration !== void 0) ensureHiddenEditorView();
 	}, [collaboration, ensureHiddenEditorView]);
@@ -3211,6 +3276,18 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		folioEditor,
 		hfEditMode
 	]);
+	const getCanonicalActiveStory = useCallback(() => {
+		const note = activeNoteStoryRef.current;
+		if (note) return {
+			kind: note.kind,
+			id: note.noteId
+		};
+		if (hfEditMode && activeHeaderFooterRId) return {
+			kind: hfEditMode,
+			rId: activeHeaderFooterRId
+		};
+		return "main";
+	}, [hfEditMode, activeHeaderFooterRId]);
 	const paintSettingsInitializedRef = useRef(false);
 	useEffect(() => {
 		if (!paintSettingsInitializedRef.current) {
@@ -3243,12 +3320,12 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		}
 		let newDoc = hiddenPMRef.current?.getDocument();
 		const body = hiddenPMRef.current?.getState()?.doc;
-		if (newDoc && body) newDoc = noteFollower.reconcile(newDoc, body);
+		if (newDoc && body && experimentalSession !== "canonical") newDoc = noteFollower.reconcile(newDoc, body);
 		if (newDoc) {
-			onDocumentChangeRef.current?.(newDoc);
-			folioEmitterRef.current.emit("docChange", newDoc);
+			onDocumentChangeRef.current?.(experimentalSession === "canonical" ? cloneDocumentWithParagraphPropertySources(newDoc) : newDoc);
+			folioEmitterRef.current.emit("docChange", experimentalSession === "canonical" ? cloneDocumentWithParagraphPropertySources(newDoc) : newDoc);
 		}
-	}, [noteFollower]);
+	}, [experimentalSession, noteFollower]);
 	const scheduleDocumentChangeNotification = useCallback(() => {
 		if (documentChangeNotifyTimerRef.current !== null) window.clearTimeout(documentChangeNotifyTimerRef.current);
 		documentChangeNotifyTimerRef.current = window.setTimeout(() => {
@@ -3853,6 +3930,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 (docChanged_0 || selectionChanged) {
 			const { from: from_1, to: to_1 } = view_3.state.selection;
@@ -3870,7 +3948,12 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 				to: to_1
 			});
 		}
-	}, [scheduleLayout, ensureHiddenEditorView]);
+	}, [
+		scheduleLayout,
+		ensureHiddenEditorView,
+		experimentalSession,
+		scheduleDocumentChangeNotification
+	]);
 	const handleNoteStoryTransaction = useCallback((view_4, docChanged_1, selectionChanged_0) => {
 		if (docChanged_1) scheduleLayout();
 		if (docChanged_1 || selectionChanged_0) {
@@ -3883,9 +3966,9 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		}
 	}, [scheduleLayout]);
 	const handleNoteDocumentChange = useCallback((updated) => {
-		onDocumentChangeRef.current?.(updated);
-		folioEmitterRef.current.emit("docChange", updated);
-	}, []);
+		onDocumentChangeRef.current?.(experimentalSession === "canonical" ? cloneDocumentWithParagraphPropertySources(updated) : updated);
+		folioEmitterRef.current.emit("docChange", experimentalSession === "canonical" ? cloneDocumentWithParagraphPropertySources(updated) : updated);
+	}, [experimentalSession]);
 	useEffect(() => {
 		if (!hfEditMode) setHfCaretSelection(null);
 		dragAnchorRef.current = null;
@@ -4750,6 +4833,10 @@ 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.");
+					return;
+				}
 				noteEditorRef.current?.open(story_0);
 				return;
 			}
@@ -4893,7 +4980,9 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 			}
 		}
 	}, [
+		experimentalSession,
 		getPositionFromMouse,
+		handleSessionRefusal,
 		onHeaderFooterDoubleClick,
 		onHyperlinkClick,
 		readOnly
@@ -5401,6 +5490,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		getDocument() {
 			if (documentChangeNotifyTimerRef.current !== null) flushDocumentChangeNotification();
 			const editorDocument = folioEditor.getDocument();
+			if (experimentalSession === "canonical") return editorDocument;
 			const current_0 = editorDocument ? noteFollower.withPending(editorDocument) : null;
 			return current_0 ? noteEditorRef.current?.snapshotDocument(current_0) ?? current_0 : null;
 		},
@@ -5411,12 +5501,14 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 			return folioEditor.getView();
 		},
 		getActiveView() {
+			if (experimentalSession === "canonical") return folioEditor.getView();
 			return getActiveEditorStory().view;
 		},
 		closeNoteStory() {
 			noteEditorRef.current?.close();
 		},
 		getHfView(rId_0) {
+			if (experimentalSession === "canonical") return null;
 			return hfPMsRef.current?.getView(rId_0) ?? null;
 		},
 		ensureView(options_4) {
@@ -5442,22 +5534,34 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		undo() {
 			const target_5 = getActiveEditorStory();
 			if (target_5.type === "none") return false;
-			return target_5.type === "body" ? hiddenPMRef.current?.undo() ?? false : undo(target_5.view.state, target_5.view.dispatch);
+			if (experimentalSession === "canonical") return hiddenPMRef.current?.applyCanonicalStoryHistory({
+				view: target_5.view,
+				story: getCanonicalActiveStory(),
+				direction: "undo"
+			}) ?? false;
+			if (target_5.type === "body") return hiddenPMRef.current?.undo() ?? false;
+			return undo(target_5.view.state, target_5.view.dispatch);
 		},
 		redo() {
 			const target_6 = getActiveEditorStory();
 			if (target_6.type === "none") return false;
-			return target_6.type === "body" ? hiddenPMRef.current?.redo() ?? false : redo(target_6.view.state, target_6.view.dispatch);
+			if (experimentalSession === "canonical") return hiddenPMRef.current?.applyCanonicalStoryHistory({
+				view: target_6.view,
+				story: getCanonicalActiveStory(),
+				direction: "redo"
+			}) ?? false;
+			if (target_6.type === "body") return hiddenPMRef.current?.redo() ?? false;
+			return redo(target_6.view.state, target_6.view.dispatch);
 		},
 		canUndo() {
 			const target_7 = getActiveEditorStory();
 			if (target_7.type === "none") return false;
-			return target_7.type === "body" ? hiddenPMRef.current?.canUndo() ?? false : undo(target_7.view.state);
+			return experimentalSession === "canonical" || 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 target_8.type === "body" ? hiddenPMRef.current?.canRedo() ?? false : redo(target_8.view.state);
+			return experimentalSession === "canonical" || target_8.type === "body" ? hiddenPMRef.current?.canRedo() ?? false : redo(target_8.view.state);
 		},
 		setSelection(anchor_3, head_1) {
 			folioEditor.setSelection(anchor_3, head_1);
@@ -5541,6 +5645,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		flushDocumentChangeNotification,
 		folioEditor,
 		getActiveEditorStory,
+		getCanonicalActiveStory,
 		noteFollower,
 		getScrollContainer,
 		refreshBodyImeCaretAnchor,
@@ -5614,6 +5719,9 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 				ref: hfPMsRef,
 				document,
 				onTransaction: handleHfPmTransaction,
+				getCanonicalApi,
+				onSessionRefusal: handleSessionRefusal,
+				...experimentalSession === void 0 ? {} : { experimentalSession },
 				...styles !== void 0 ? { styles } : {},
 				..._theme !== void 0 ? { theme: _theme } : {}
 			}),
@@ -5621,6 +5729,9 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 				ref: noteEditorRef,
 				document,
 				onActiveChange: handleActiveNoteStoryChange,
+				getCanonicalApi,
+				onSessionRefusal: handleSessionRefusal,
+				...experimentalSession === void 0 ? {} : { experimentalSession },
 				onDocumentChange: handleNoteDocumentChange,
 				onStoryChange: handleNoteStoryTransaction,
 				plugins: noteStoryPlugins,
@@ -5633,6 +5744,10 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 				ref: hiddenPMRef,
 				document,
 				documentIdentity,
+				...experimentalSession === void 0 ? {} : { experimentalSession },
+				onSessionRefusal: handleSessionRefusal,
+				...suggestionAuthor !== void 0 ? { suggestionAuthor } : {},
+				suggestionModeActive,
 				widthPx: contentWidth,
 				precomputedInitialState: validPrecomputedInitialState,
 				readOnly,
@@ -10060,16 +10175,17 @@ function useContextMenu(t0) {
 * callbacks each render.
 */
 const useDocumentLoader = (t0) => {
-	const $ = c(22);
-	const { documentBuffer, initialDocument, password, history, onError, onCompatibilityChange, onReset, setDocumentLoadState } = t0;
+	const $ = c(28);
+	const { documentBuffer, initialDocument, password, experimentalSession, history, onError, onCompatibilityChange, onReset, setDocumentLoadState } = t0;
 	const originalBufferRef = useRef(null);
 	const originalBufferIdentityRef = useRef(null);
 	const [loadedDocumentIdentity, setLoadedDocumentIdentity] = useState("0");
 	let t1;
-	if ($[0] !== history || $[1] !== onCompatibilityChange || $[2] !== onError || $[3] !== onReset || $[4] !== setDocumentLoadState) {
+	if ($[0] !== experimentalSession || $[1] !== history || $[2] !== onCompatibilityChange || $[3] !== onError || $[4] !== onReset || $[5] !== setDocumentLoadState) {
 		t1 = () => {
 			const instance = new DocumentLoaderManager({
 				history,
+				getExperimentalSession: () => experimentalSession,
 				onError,
 				onCompatibilityChange,
 				onReset,
@@ -10085,17 +10201,19 @@ const useDocumentLoader = (t0) => {
 				}
 			};
 		};
-		$[0] = history;
-		$[1] = onCompatibilityChange;
-		$[2] = onError;
-		$[3] = onReset;
-		$[4] = setDocumentLoadState;
-		$[5] = t1;
-	} else t1 = $[5];
+		$[0] = experimentalSession;
+		$[1] = history;
+		$[2] = onCompatibilityChange;
+		$[3] = onError;
+		$[4] = onReset;
+		$[5] = setDocumentLoadState;
+		$[6] = t1;
+	} else t1 = $[6];
 	const [t2] = useState(t1);
 	const { manager, api } = t2;
 	manager.setCallbacks({
 		history,
+		getExperimentalSession: () => experimentalSession,
 		onError,
 		onCompatibilityChange,
 		onReset,
@@ -10103,8 +10221,7 @@ const useDocumentLoader = (t0) => {
 		setLoadedDocumentIdentity
 	});
 	let t3;
-	let t4;
-	if ($[6] !== api || $[7] !== documentBuffer || $[8] !== initialDocument || $[9] !== password) {
+	if ($[7] !== api || $[8] !== documentBuffer || $[9] !== initialDocument || $[10] !== password) {
 		t3 = () => {
 			const source = getDocumentLoadSource({
 				documentBuffer,
@@ -10117,26 +10234,32 @@ const useDocumentLoader = (t0) => {
 			}
 			api.loadBuffer(source.buffer, { password });
 		};
+		$[7] = api;
+		$[8] = documentBuffer;
+		$[9] = initialDocument;
+		$[10] = password;
+		$[11] = t3;
+	} else t3 = $[11];
+	let t4;
+	if ($[12] !== api || $[13] !== documentBuffer || $[14] !== experimentalSession || $[15] !== initialDocument || $[16] !== password) {
 		t4 = [
 			documentBuffer,
 			initialDocument,
 			password,
+			experimentalSession,
 			api
 		];
-		$[6] = api;
-		$[7] = documentBuffer;
-		$[8] = initialDocument;
-		$[9] = password;
-		$[10] = t3;
-		$[11] = t4;
-	} else {
-		t3 = $[10];
-		t4 = $[11];
-	}
+		$[12] = api;
+		$[13] = documentBuffer;
+		$[14] = experimentalSession;
+		$[15] = initialDocument;
+		$[16] = password;
+		$[17] = t4;
+	} else t4 = $[17];
 	useEffect(t3, t4);
 	let t5;
 	let t6;
-	if ($[12] !== documentBuffer || $[13] !== history.state || $[14] !== loadedDocumentIdentity) {
+	if ($[18] !== documentBuffer || $[19] !== history.state || $[20] !== loadedDocumentIdentity) {
 		t5 = () => {
 			if (originalBufferIdentityRef.current === loadedDocumentIdentity) return;
 			originalBufferIdentityRef.current = loadedDocumentIdentity;
@@ -10151,18 +10274,18 @@ const useDocumentLoader = (t0) => {
 			documentBuffer,
 			loadedDocumentIdentity
 		];
-		$[12] = documentBuffer;
-		$[13] = history.state;
-		$[14] = loadedDocumentIdentity;
-		$[15] = t5;
-		$[16] = t6;
+		$[18] = documentBuffer;
+		$[19] = history.state;
+		$[20] = loadedDocumentIdentity;
+		$[21] = t5;
+		$[22] = t6;
 	} else {
-		t5 = $[15];
-		t6 = $[16];
+		t5 = $[21];
+		t6 = $[22];
 	}
 	useEffect(t5, t6);
 	let t7;
-	if ($[17] !== api.loadBuffer || $[18] !== api.loadParsedDocument || $[19] !== api.resetForNewDocument || $[20] !== loadedDocumentIdentity) {
+	if ($[23] !== api.loadBuffer || $[24] !== api.loadParsedDocument || $[25] !== api.resetForNewDocument || $[26] !== loadedDocumentIdentity) {
 		t7 = {
 			loadBuffer: api.loadBuffer,
 			loadParsedDocument: api.loadParsedDocument,
@@ -10170,12 +10293,12 @@ const useDocumentLoader = (t0) => {
 			originalBufferRef,
 			loadedDocumentIdentity
 		};
-		$[17] = api.loadBuffer;
-		$[18] = api.loadParsedDocument;
-		$[19] = api.resetForNewDocument;
-		$[20] = loadedDocumentIdentity;
-		$[21] = t7;
-	} else t7 = $[21];
+		$[23] = api.loadBuffer;
+		$[24] = api.loadParsedDocument;
+		$[25] = api.resetForNewDocument;
+		$[26] = loadedDocumentIdentity;
+		$[27] = t7;
+	} else t7 = $[27];
 	return t7;
 };
 //#endregion
@@ -10458,7 +10581,7 @@ const saveAndCloseHeaderFooterEdit = ({ activeRId, document, editPosition, isFir
 	if (newDocument) pushDocument(newDocument);
 	setEditPosition(null);
 };
-const useHeaderFooterEditor = ({ history, pushDocument, getHfView }) => {
+const useHeaderFooterEditor = ({ history, pushDocument, getHfView, getCanonicalApi, experimentalSession }) => {
 	const [hfEditPosition, setHfEditPosition] = useState(null);
 	const [hfEditIsFirstPage, setHfEditIsFirstPage] = useState(false);
 	const rawResolution = useMemo(() => resolveHeaderFooterContent(history.state?.package), [history.state]);
@@ -10476,6 +10599,19 @@ const useHeaderFooterEditor = ({ history, pushDocument, getHfView }) => {
 			setHfEditPosition(position);
 			return;
 		}
+		if (experimentalSession === "canonical") {
+			const api = getCanonicalApi?.();
+			api?.ensureView();
+			const canonical = api?.getCanonicalDocument();
+			if (!canonical || !api) return;
+			const operation = createCanonicalHeaderFooterOperation({
+				document: canonical,
+				position,
+				referenceType: isFirstPage ? "first" : "default"
+			});
+			if (api.applyCanonicalOperations([operation])) setHfEditPosition(position);
+			return;
+		}
 		if (!history.state) return;
 		const newDoc = createEmptyHeaderFooter(history.state, position, isFirstPage);
 		if (!newDoc) return;
@@ -10488,9 +10624,15 @@ const useHeaderFooterEditor = ({ history, pushDocument, getHfView }) => {
 		firstPageFooterContent,
 		hasTitlePg,
 		history,
-		pushDocument
+		pushDocument,
+		getCanonicalApi,
+		experimentalSession
 	]);
 	const handleHeaderFooterSave = useCallback(() => {
+		if (experimentalSession === "canonical") {
+			setHfEditPosition(null);
+			return;
+		}
 		if (!hfEditPosition || !history.state?.package) {
 			setHfEditPosition(null);
 			return;
@@ -10512,7 +10654,8 @@ const useHeaderFooterEditor = ({ history, pushDocument, getHfView }) => {
 		resolution,
 		history,
 		pushDocument,
-		getHfView
+		getHfView,
+		experimentalSession
 	]);
 	return {
 		hfEditPosition,
@@ -10540,6 +10683,17 @@ const useHeaderFooterEditor = ({ history, pushDocument, getHfView }) => {
 				return;
 			}
 			const activeRId_0 = pickActiveHeaderFooterRId(resolution, hfEditPosition, hfEditIsFirstPage);
+			if (experimentalSession === "canonical") {
+				const api_0 = getCanonicalApi?.();
+				const canonical_0 = api_0?.getCanonicalDocument();
+				if (api_0 && canonical_0 && activeRId_0) api_0.applyCanonicalOperations(removeCanonicalHeaderFooterOperations({
+					document: canonical_0,
+					position: hfEditPosition,
+					rId: activeRId_0
+				}));
+				setHfEditPosition(null);
+				return;
+			}
 			if (activeRId_0) pushDocument(removeHeaderFooter({
 				document: history.state,
 				position: hfEditPosition,
@@ -10551,7 +10705,9 @@ const useHeaderFooterEditor = ({ history, pushDocument, getHfView }) => {
 			hfEditIsFirstPage,
 			resolution,
 			history,
-			pushDocument
+			pushDocument,
+			getCanonicalApi,
+			experimentalSession
 		])
 	};
 };
@@ -12793,7 +12949,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-Bk5pQ_2C.js").then((m) => ({ default: m.CommentsSidebar })));
+const CommentsSidebar = lazy(() => import("./CommentsSidebar-D9vMIMl7.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");
@@ -12864,7 +13020,7 @@ function areActiveTrackedChangesEqual(a, b) {
 /**
 * DocxEditor - Complete DOCX editor component
 */
-const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, document: initialDocument, onSave, author = "User", onChange, onSelectionChange, onSelectionTextChange, onError, onFontsLoaded: onFontsLoadedCallback, fontFamilies, fonts, theme, showToolbar = true, showZoomControl = true, showReviewControls = true, showHeaderFooterEditing = true, pageRenderer, showMarginGuides = false, marginGuideColor, showRuler: showRulerProp = false, rulerUnit = "inch", initialZoom = 1, enableWheelZoom = true, keyboardShortcuts = "document", hostShortcuts: hostShortcutsProp, readOnly: readOnlyProp = false, autoOpenReviewSidebar = true, components, toolbarExtra, className = "", style, placeholder, loadingIndicator, preserveDocumentWhileLoading = false, initialScrollTop, onScrollTopChange, showOutline: showOutlineProp = true, onPrint, onInsertImage, onInsertTable, showTableInsert = true, onInsertPageBreak, onInsertTOC, onCopy, onCut, onPaste, mode: modeProp, onModeChange, onReadonlyEditAttempt, onCompatibilityChange, onEditorViewReady, onAnonymizationMatchesChange, onAnonymizationTermClick, selectedAnonymizationCanonical = null, anonymizationSelectionSeq, showTemplateDirectives = false, onSlashMenuChange, onSlashMenuKeyAction, customContextMenuItems, onCustomContextAction, comments: commentsProp, onCommentsChange, collaboration, plugins, featureFlags, onSelectiveSaveTripwire }, ref) {
+const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, document: initialDocument, onSave, author = "User", onChange, onSelectionChange, onSelectionTextChange, onError, onFontsLoaded: onFontsLoadedCallback, fontFamilies, fonts, theme, showToolbar = true, showZoomControl = true, showReviewControls = true, showHeaderFooterEditing = true, pageRenderer, showMarginGuides = false, marginGuideColor, showRuler: showRulerProp = false, rulerUnit = "inch", initialZoom = 1, enableWheelZoom = true, keyboardShortcuts = "document", hostShortcuts: hostShortcutsProp, readOnly: readOnlyProp = false, autoOpenReviewSidebar = true, components, toolbarExtra, className = "", style, placeholder, loadingIndicator, preserveDocumentWhileLoading = false, initialScrollTop, onScrollTopChange, showOutline: showOutlineProp = true, onPrint, onInsertImage, onInsertTable, showTableInsert = true, onInsertPageBreak, onInsertTOC, onCopy, onCut, onPaste, mode: modeProp, onModeChange, onReadonlyEditAttempt, onCompatibilityChange, onEditorViewReady, onAnonymizationMatchesChange, onAnonymizationTermClick, selectedAnonymizationCanonical = null, anonymizationSelectionSeq, showTemplateDirectives = false, onSlashMenuChange, onSlashMenuKeyAction, customContextMenuItems, onCustomContextAction, comments: commentsProp, onCommentsChange, collaboration, plugins, featureFlags, experimentalSession, onSelectiveSaveTripwire }, ref) {
 	const t = useTranslations("folio");
 	useEffect(() => {
 		const onClipboardReadError = () => {
@@ -12903,11 +13059,25 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	const [, setTrackedChanges] = useState([]);
 	const trackedChangesRef = useRef([]);
 	const [anchorPositions, setAnchorPositions] = useState(EMPTY_ANCHOR_POSITIONS);
-	const { editingMode, readOnly, trackChangesOn, toggleTrackChanges, displayMode, setDisplayMode } = useEditorMode({
+	const { editingMode, readOnly, trackChangesOn, toggleTrackChanges: toggleTrackChangesUnrestricted, displayMode, setDisplayMode } = useEditorMode({
 		modeProp,
 		onModeChange,
 		readOnlyProp
 	});
+	const toggleTrackChanges = useCallback(() => {
+		if (experimentalSession === "canonical" && !trackChangesOn) {
+			const error = new CanonicalSessionRefusalError({ message: "Canonical sessions do not support suggesting mode." });
+			toast(error.message);
+			onError?.(error);
+			return;
+		}
+		toggleTrackChangesUnrestricted();
+	}, [
+		experimentalSession,
+		trackChangesOn,
+		onError,
+		toggleTrackChangesUnrestricted
+	]);
 	const extractTrackedChangesTimerRef = useRef(null);
 	const collectHeadingsTimerRef = useRef(null);
 	const extractTrackedChanges = useCallback(() => {
@@ -12956,8 +13126,15 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	const history = useDocumentHistory(initialDocument || null, {
 		maxEntries: 100,
 		groupingInterval: 500,
-		enableKeyboardShortcuts: historyShortcuts === "editor"
+		enableKeyboardShortcuts: historyShortcuts === "editor" && experimentalSession !== "canonical"
 	});
+	const refuseCanonicalModelEdit = useCallback((message) => {
+		if (experimentalSession !== "canonical") return false;
+		const error_0 = new CanonicalSessionRefusalError({ message });
+		toast(error_0.message);
+		onError?.(error_0);
+		return true;
+	}, [experimentalSession, onError]);
 	const extensionManager = useMemo(() => {
 		const mgr = new ExtensionManager(createStarterKit({ historyShortcuts }));
 		mgr.buildSchema();
@@ -13177,6 +13354,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		canUndo: false
 	});
 	const [activeNoteStory, setActiveNoteStory] = useState(null);
+	const canEditHeaderFooter = showHeaderFooterEditing;
+	const getCanonicalApi = useCallback(() => pagedEditorRef.current?.getEditor() ?? null, []);
 	const pushDocument = useCallback((document) => {
 		history.push(document);
 		return document;
@@ -13192,6 +13371,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	const { hfEditPosition, setHfEditPosition, hfEditIsFirstPage, headerContent, footerContent, firstPageHeaderContent, firstPageFooterContent, activeHeaderRId, activeFooterRId, activeFirstHeaderRId, activeFirstFooterRId, effectiveSectionProperties, handleHeaderFooterDoubleClick, handleBodyClick, handleRemoveHeaderFooter } = useHeaderFooterEditor({
 		history,
 		pushDocument,
+		getCanonicalApi,
+		...experimentalSession === void 0 ? {} : { experimentalSession },
 		getHfView: (rId) => pagedEditorRef.current?.getHfView(rId) ?? null
 	});
 	let activeHfRId = hfEditIsFirstPage ? activeFirstFooterRId : activeFooterRId;
@@ -13224,19 +13405,27 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		else pagedEditorRef.current?.focus();
 	}, [getActiveEditorStory]);
 	const undoActiveEditor = useCallback(() => {
-		if (getActiveEditorStory().type === "headerFooter" && hfEditorRef.current) hfEditorRef.current.undo();
+		if (experimentalSession !== "canonical" && getActiveEditorStory().type === "headerFooter" && hfEditorRef.current) hfEditorRef.current.undo();
 		else {
 			pagedEditorRef.current?.undo();
 			requestAnimationFrame(refreshBodyHistoryAvailability);
 		}
-	}, [getActiveEditorStory, refreshBodyHistoryAvailability]);
+	}, [
+		getActiveEditorStory,
+		refreshBodyHistoryAvailability,
+		experimentalSession
+	]);
 	const redoActiveEditor = useCallback(() => {
-		if (getActiveEditorStory().type === "headerFooter" && hfEditorRef.current) hfEditorRef.current.redo();
+		if (experimentalSession !== "canonical" && getActiveEditorStory().type === "headerFooter" && hfEditorRef.current) hfEditorRef.current.redo();
 		else {
 			pagedEditorRef.current?.redo();
 			requestAnimationFrame(refreshBodyHistoryAvailability);
 		}
-	}, [getActiveEditorStory, refreshBodyHistoryAvailability]);
+	}, [
+		getActiveEditorStory,
+		refreshBodyHistoryAvailability,
+		experimentalSession
+	]);
 	const handleActiveNoteStoryChange = useCallback((story) => {
 		setActiveNoteStory(story);
 		if (story && hfEditPosition) handleBodyClick();
@@ -13260,6 +13449,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		documentBuffer: documentBuffer ?? null,
 		initialDocument: initialDocument ?? null,
 		password,
+		...experimentalSession === void 0 ? {} : { experimentalSession },
 		history,
 		onError,
 		onCompatibilityChange,
@@ -13373,7 +13563,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 			}
 		};
 		pushDocument(documentWithComments);
-		onChange?.(documentWithComments);
+		onChange?.(experimentalSession === "canonical" ? cloneDocumentWithParagraphPropertySources(documentWithComments) : documentWithComments);
 		if (showOutlineRef.current) {
 			if (collectHeadingsTimerRef.current) clearTimeout(collectHeadingsTimerRef.current);
 			collectHeadingsTimerRef.current = setTimeout(() => {
@@ -13394,10 +13584,14 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		pushDocument,
 		extractTrackedChanges,
 		refreshBodyHistoryAvailability,
-		commentsRef
+		commentsRef,
+		experimentalSession
 	]);
 	const buildCurrentDocument = useCallback(() => {
 		if (!history.state) return null;
+		const canonical = pagedEditorRef.current?.getEditor().getCanonicalDocument();
+		if (canonical) return canonical;
+		if (experimentalSession === "canonical") return null;
 		let doc_0 = cloneDocumentWithParagraphPropertySources(history.state);
 		const pmDoc = pagedEditorRef.current?.getDocument();
 		if (pmDoc) {
@@ -13422,8 +13616,16 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		const referencedCommentIds = collectCommentIdsFromSources(doc_0.package.document.content, doc_0.package.headers, doc_0.package.footers, doc_0.package.footnotes, doc_0.package.endnotes);
 		doc_0.package.document.comments = pruneOrphanedComments(commentsRef.current, referencedCommentIds);
 		return doc_0;
-	}, [history.state, commentsRef]);
+	}, [
+		history.state,
+		commentsRef,
+		experimentalSession
+	]);
 	const replaceComments = useCallback((nextComments) => {
+		if (experimentalSession === "canonical") {
+			refuseCanonicalModelEdit("Comment changes are unavailable in this session.");
+			return;
+		}
 		commentsDirtyRef.current = true;
 		setComments(nextComments);
 		const currentDocument = buildCurrentDocument();
@@ -13432,7 +13634,9 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	}, [
 		buildCurrentDocument,
 		commentsDirtyRef,
+		experimentalSession,
 		onChange,
+		refuseCanonicalModelEdit,
 		setComments
 	]);
 	const updateComments = useCallback((updater) => {
@@ -13685,6 +13889,16 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		roots: shortcutRoots
 	});
 	const handleApplyFootnoteProperties = useCallback((footnotePr, endnotePr) => {
+		if (experimentalSession === "canonical") {
+			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.");
+			return;
+		}
 		if (!history.state?.package) return;
 		const newDoc = {
 			...history.state.package.document,
@@ -13701,7 +13915,13 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 				document: newDoc
 			}
 		});
-	}, [history, pushDocument]);
+	}, [
+		history,
+		pushDocument,
+		experimentalSession,
+		getCanonicalApi,
+		refuseCanonicalModelEdit
+	]);
 	const handleTableAction = useCallback((action_0) => {
 		const view_9 = getActiveEditorView();
 		if (!view_9) return;
@@ -13896,92 +14116,95 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 			const tr = view_10.state.tr.setSelection(TextSelection.create(view_10.state.doc, savedSelection.from, savedSelection.to));
 			view_10.dispatch(tr);
 		} catch {}
-		const commandState = view_10.state;
 		if (action_1 === "bold") {
-			toggleBold(commandState, view_10.dispatch);
+			executeEditorCommand(view_10, toggleBold);
 			return;
 		}
 		if (action_1 === "italic") {
-			toggleItalic(commandState, view_10.dispatch);
+			executeEditorCommand(view_10, toggleItalic);
 			return;
 		}
 		if (action_1 === "underline") {
-			toggleUnderline(commandState, view_10.dispatch);
+			executeEditorCommand(view_10, toggleUnderline);
 			return;
 		}
 		if (action_1 === "strikethrough") {
-			toggleStrike(commandState, view_10.dispatch);
+			executeEditorCommand(view_10, toggleStrike);
 			return;
 		}
 		if (action_1 === "superscript") {
-			toggleSuperscript(commandState, view_10.dispatch);
+			executeEditorCommand(view_10, toggleSuperscript);
 			return;
 		}
 		if (action_1 === "subscript") {
-			toggleSubscript(commandState, view_10.dispatch);
+			executeEditorCommand(view_10, toggleSubscript);
 			return;
 		}
 		if (action_1 === "bulletList") {
-			toggleBulletList(commandState, view_10.dispatch);
+			executeEditorCommand(view_10, toggleBulletList);
 			return;
 		}
 		if (action_1 === "numberedList") {
-			toggleNumberedList(commandState, view_10.dispatch);
+			executeEditorCommand(view_10, toggleNumberedList);
 			return;
 		}
 		if (action_1 === "indent") {
-			if (!increaseListLevel(commandState, view_10.dispatch)) increaseIndent()(commandState, view_10.dispatch);
+			executeFirstEditorCommand(view_10, [increaseListLevel, increaseIndent()]);
 			return;
 		}
 		if (action_1 === "outdent") {
-			if (!decreaseListLevel(commandState, view_10.dispatch)) decreaseIndent()(commandState, view_10.dispatch);
+			executeFirstEditorCommand(view_10, [decreaseListLevel, decreaseIndent()]);
 			return;
 		}
 		if (action_1 === "clearFormatting") {
-			clearFormatting(commandState, view_10.dispatch);
+			executeEditorCommand(view_10, clearFormatting);
 			return;
 		}
 		if (action_1 === "setRtl") {
-			setRtl(commandState, view_10.dispatch);
+			executeEditorCommand(view_10, setRtl);
 			return;
 		}
 		if (action_1 === "setLtr") {
-			setLtr(commandState, view_10.dispatch);
+			executeEditorCommand(view_10, setLtr);
+			return;
+		}
+		if (action_1 === "insertPageBreak") {
+			executeEditorCommand(view_10, insertPageBreak);
 			return;
 		}
 		if (typeof action_1 === "object") switch (action_1.type) {
 			case "alignment":
-				setAlignment(action_1.value)(commandState, view_10.dispatch);
+				executeEditorCommand(view_10, setAlignment(action_1.value));
 				break;
 			case "toggleDirection":
-				toggleBidi(commandState, view_10.dispatch);
+				executeEditorCommand(view_10, toggleBidi);
 				break;
 			case "textColor": {
 				const colorVal_0 = action_1.value;
-				if (typeof colorVal_0 === "string") setTextColor({ rgb: colorVal_0.replace("#", "") })(commandState, view_10.dispatch);
-				else if (colorVal_0.auto) clearTextColor(commandState, view_10.dispatch);
+				if (typeof colorVal_0 === "string") executeEditorCommand(view_10, setTextColor({ rgb: colorVal_0.replace("#", "") }));
+				else if (colorVal_0.auto) executeEditorCommand(view_10, clearTextColor);
 				else {
 					const themeColor = typeof colorVal_0.themeColor === "string" ? colorVal_0.themeColor : void 0;
-					setTextColor({
+					executeEditorCommand(view_10, setTextColor({
 						...colorVal_0.rgb === void 0 ? {} : { rgb: colorVal_0.rgb },
 						...themeColor ? { themeColor } : {},
 						...colorVal_0.themeTint === void 0 ? {} : { themeTint: colorVal_0.themeTint },
 						...colorVal_0.themeShade === void 0 ? {} : { themeShade: colorVal_0.themeShade }
-					})(commandState, view_10.dispatch);
+					}));
 				}
 				break;
 			}
 			case "highlightColor":
-				setHighlight((action_1.value ? mapHexToHighlightName(action_1.value) : "") || action_1.value)(commandState, view_10.dispatch);
+				executeEditorCommand(view_10, setHighlight((action_1.value ? mapHexToHighlightName(action_1.value) : "") || action_1.value));
 				break;
 			case "fontSize":
-				setFontSize(pointsToHalfPoints(action_1.value))(commandState, view_10.dispatch);
+				executeEditorCommand(view_10, setFontSize(pointsToHalfPoints(action_1.value)));
 				break;
 			case "fontFamily":
-				setFontFamily(action_1.value)(commandState, view_10.dispatch);
+				executeEditorCommand(view_10, setFontFamily(action_1.value));
 				break;
 			case "lineSpacing":
-				setLineSpacing(action_1.value)(commandState, view_10.dispatch);
+				executeEditorCommand(view_10, setLineSpacing(action_1.value));
 				break;
 			case "applyStyle": {
 				const currentDoc_0 = historyStateRef.current;
@@ -13994,8 +14217,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 					const styleName = styleResolver_0.getStyle(action_1.value)?.name;
 					if (styleName) styleAttrs.styleName = styleName;
 					styleAttrs.numbering = currentDoc_0?.package.numbering ? getCachedNumberingMap(currentDoc_0.package.numbering) : null;
-					applyStyle(action_1.value, styleAttrs)(commandState, view_10.dispatch);
-				} else applyStyle(action_1.value)(commandState, view_10.dispatch);
+					executeEditorCommand(view_10, applyStyle(action_1.value, styleAttrs));
+				} else executeEditorCommand(view_10, applyStyle(action_1.value));
 				break;
 			}
 			default: break;
@@ -14310,13 +14533,21 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 			case "acceptChange": {
 				const { from: from_4, to: to_4 } = view_13.state.selection;
 				const range_1 = findChangeAtPosition(view_13.state, from_4, to_4);
-				acceptChange(range_1.from, range_1.to)(view_13.state, view_13.dispatch);
+				if (resolveCanonicalReviewRange({
+					editor: pagedEditorRef.current?.getEditor(),
+					...range_1,
+					resolution: "accept"
+				}) === null) acceptChange(range_1.from, range_1.to)(view_13.state, view_13.dispatch);
 				break;
 			}
 			case "rejectChange": {
 				const { from: from_3, to: to_3 } = view_13.state.selection;
 				const range_0 = findChangeAtPosition(view_13.state, from_3, to_3);
-				rejectChange(range_0.from, range_0.to)(view_13.state, view_13.dispatch);
+				if (resolveCanonicalReviewRange({
+					editor: pagedEditorRef.current?.getEditor(),
+					...range_0,
+					resolution: "reject"
+				}) === null) rejectChange(range_0.from, range_0.to)(view_13.state, view_13.dispatch);
 				break;
 			}
 			case "restartNumbering":
@@ -14348,6 +14579,14 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		t
 	]);
 	const handlePageSetupApply = useCallback((props) => {
+		if (readOnly) return;
+		if (experimentalSession === "canonical") {
+			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.");
+			return;
+		}
 		if (!history.state || readOnly) return;
 		const newDoc_0 = {
 			...history.state,
@@ -14366,7 +14605,10 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	}, [
 		history.state,
 		readOnly,
-		handleDocumentChange
+		handleDocumentChange,
+		experimentalSession,
+		getCanonicalApi,
+		refuseCanonicalModelEdit
 	]);
 	const handleLeftMarginChange = useCallback((twips) => handlePageSetupApply({ marginLeft: twips }), [handlePageSetupApply]);
 	const handleRightMarginChange = useCallback((twips_0) => handlePageSetupApply({ marginRight: twips_0 }), [handlePageSetupApply]);
@@ -14423,6 +14665,10 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 			const repackFull = async () => {
 				const repackDocx = await loadRepackDocx();
 				const repack = () => repackDocx(repackSourceDoc);
+				if (experimentalSession === "canonical") return repackWithCanonicalStoryRemovals({
+					document: repackSourceDoc,
+					repack
+				});
 				return editorState ? repackWithEditorSectionRemovals({
 					state: editorState,
 					document: repackSourceDoc,
@@ -14444,8 +14690,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 				view_18.dispatch(clearTrackedChanges(view_18.state));
 			}
 			savedBuffer = buffer;
-		} catch (error) {
-			onError?.(error instanceof Error ? error : /* @__PURE__ */ new Error("Failed to save document"));
+		} catch (error_1) {
+			onError?.(error_1 instanceof Error ? error_1 : /* @__PURE__ */ new Error("Failed to save document"));
 			return null;
 		}
 		if (tripwireResult && onSelectiveSaveTripwire) onSelectiveSaveTripwire(tripwireResult);
@@ -14479,8 +14725,9 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		loadParsedDocument,
 		serializeCurrentDocx
 	]);
-	const handleEditorError = useCallback((error_0) => {
-		onError?.(error_0);
+	const handleEditorError = useCallback((error_2) => {
+		if (CanonicalSessionRefusalError.is(error_2)) toast(error_2.message);
+		onError?.(error_2);
 	}, [onError]);
 	useImperativeHandle(ref, () => ({
 		getDocument: () => buildCurrentDocument(),
@@ -14679,21 +14926,25 @@ 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);
 		},
 		undo: () => {
-			if (getActiveEditorStory().type === "headerFooter" && hfEditorRef.current) return hfEditorRef.current.undo();
+			if (experimentalSession !== "canonical" && getActiveEditorStory().type === "headerFooter" && hfEditorRef.current) return hfEditorRef.current.undo();
 			const undone = pagedEditorRef.current?.undo() ?? false;
 			requestAnimationFrame(refreshBodyHistoryAvailability);
 			return undone;
 		},
 		redo: () => {
-			if (getActiveEditorStory().type === "headerFooter" && hfEditorRef.current) return hfEditorRef.current.redo();
+			if (experimentalSession !== "canonical" && getActiveEditorStory().type === "headerFooter" && hfEditorRef.current) return hfEditorRef.current.redo();
 			const redone = pagedEditorRef.current?.redo() ?? false;
 			requestAnimationFrame(refreshBodyHistoryAvailability);
 			return redone;
@@ -14977,7 +15228,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		commentsRef,
 		commentsDirtyRef,
 		getActiveEditorStory,
-		refreshBodyHistoryAvailability
+		refreshBodyHistoryAvailability,
+		experimentalSession
 	]);
 	const getHfTargetElement = useCallback((pos_0) => {
 		const pagesContainer = containerRef.current?.querySelector(".paged-editor__pages");
@@ -14990,6 +15242,10 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		label: t(DISPLAY_MODE_LABEL_KEYS[mode_0])
 	})), [t]);
 	const activeHistoryAvailability = (() => {
+		if (experimentalSession === "canonical") return {
+			canRedo: pagedEditorRef.current?.canRedo() ?? false,
+			canUndo: pagedEditorRef.current?.canUndo() ?? false
+		};
 		if (activeNoteStory) return {
 			canRedo: pagedEditorRef.current?.canRedo() ?? false,
 			canUndo: pagedEditorRef.current?.canUndo() ?? false
@@ -15045,14 +15301,22 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		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);
-		acceptChange(range_7.from, range_7.to)(view_49.state, view_49.dispatch);
+		if (resolveCanonicalReviewRange({
+			editor: pagedEditorRef.current?.getEditor(),
+			...range_7,
+			resolution: "accept"
+		}) === null) acceptChange(range_7.from, range_7.to)(view_49.state, view_49.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);
-		rejectChange(range_8.from, range_8.to)(view_50.state, view_50.dispatch);
+		if (resolveCanonicalReviewRange({
+			editor: pagedEditorRef.current?.getEditor(),
+			...range_8,
+			resolution: "reject"
+		}) === null) rejectChange(range_8.from, range_8.to)(view_50.state, view_50.dispatch);
 	}, []);
 	const handlePreviousChange = useCallback(() => {
 		const view_51 = pagedEditorRef.current?.getView();
@@ -15251,27 +15515,33 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	}, [setScrollPageInfo]);
 	const handleCommentClick = useCallback((id) => setActiveCommentId(id), [setActiveCommentId]);
 	const handleCommentResolve = useCallback((id_0) => {
+		if (refuseCanonicalModelEdit("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));
-	}, [updateComments]);
+	}, [refuseCanonicalModelEdit, updateComments]);
 	const handleCommentDelete = useCallback((id_1) => {
+		if (refuseCanonicalModelEdit("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);
 	}, [
 		activeCommentId,
+		refuseCanonicalModelEdit,
 		setActiveCommentId,
 		updateComments
 	]);
 	const handleCommentReply = useCallback((id_2, text_6) => {
+		if (refuseCanonicalModelEdit("Comment changes are unavailable in this session.")) return;
 		updateComments((previous_2) => [...previous_2, createComment(text_6, author, id_2)]);
 	}, [
 		author,
 		createComment,
+		refuseCanonicalModelEdit,
 		updateComments
 	]);
 	const handleAddComment = useCallback((addText) => {
+		if (refuseCanonicalModelEdit("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;
@@ -15298,6 +15568,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		author,
 		commentSelectionRange,
 		createComment,
+		refuseCanonicalModelEdit,
 		setActiveCommentId,
 		setAddCommentYPosition,
 		setCommentSelectionRange,
@@ -15307,10 +15578,12 @@ 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;
 		updateComments((previous_4) => [...previous_4, createComment(text_7, author, revisionId_2)]);
 	}, [
 		author,
 		createComment,
+		refuseCanonicalModelEdit,
 		updateComments
 	]);
 	const handleCancelAddComment = useCallback(() => {
@@ -15335,7 +15608,9 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		if (!view_56) return;
 		const revisionId_3 = resolveSidebarChangeRevisionId(from_17, to_17);
 		if (revisionId_3 === null) return;
-		acceptAIEditRevision(revisionId_3)(view_56.state, view_56.dispatch);
+		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);
 		extractTrackedChanges();
 	}, [extractTrackedChanges, resolveSidebarChangeRevisionId]);
 	const handleSidebarRejectChange = useCallback((from_18, to_18) => {
@@ -15343,7 +15618,9 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		if (!view_57) return;
 		const revisionId_4 = resolveSidebarChangeRevisionId(from_18, to_18);
 		if (revisionId_4 === null) return;
-		rejectAIEditRevision(revisionId_4)(view_57.state, view_57.dispatch);
+		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);
 		extractTrackedChanges();
 	}, [extractTrackedChanges, resolveSidebarChangeRevisionId]);
 	const commentsPageWidth = history.state?.package.document.finalSectionProperties?.pageWidth;
@@ -15662,7 +15939,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 			onError: handleEditorError,
 			children: /* @__PURE__ */ jsxs("div", {
 				ref: containerRef,
-				className: `folio-root folio-editor${displayMode !== "all-markup" ? ` folio-root--${displayMode}` : ""}${showHeaderFooterEditing ? "" : " folio-no-hf-edit"} ${className}`,
+				className: `folio-root folio-editor${displayMode !== "all-markup" ? ` folio-root--${displayMode}` : ""}${canEditHeaderFooter ? "" : " folio-no-hf-edit"} ${className}`,
 				style: containerStyle,
 				"data-testid": "folio-editor",
 				"data-folio-format-painter": formatPainterMode !== "off" ? "armed" : void 0,
@@ -15832,9 +16109,9 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 															firstPageHeaderContentRId: activeFirstHeaderRId,
 															firstPageFooterContentRId: activeFirstFooterRId,
 															...history.state.package.styles ? { styles: history.state.package.styles } : {},
-															onHeaderFooterDoubleClick: showHeaderFooterEditing ? handleHeaderFooterStoryOpen : void 0,
-															hfEditMode: hfEditPosition,
-															activeHeaderFooterRId: activeHfRId,
+															onHeaderFooterDoubleClick: handleHeaderFooterStoryOpen,
+															hfEditMode: canEditHeaderFooter ? hfEditPosition : null,
+															activeHeaderFooterRId: canEditHeaderFooter ? activeHfRId : null,
 															onBodyClick: handleBodyClick,
 															onActiveNoteStoryChange: handleActiveNoteStoryChange,
 															zoom,
@@ -15842,6 +16119,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 															showMarginGuides,
 															...marginGuideColor !== void 0 ? { marginGuideColor } : {},
 															readOnly,
+															...experimentalSession === void 0 ? {} : { experimentalSession },
 															onDocumentChange: handleDocumentChange,
 															extensionManager,
 															suggestionModeActive: editingMode === "suggesting",
@@ -15950,7 +16228,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 																children: /* @__PURE__ */ jsx(SquarePenIcon, { size: 16 })
 															})
 														}),
-														hfEditPosition && (() => {
+														canEditHeaderFooter && hfEditPosition && (() => {
 															if (!(() => {
 																if (hfEditIsFirstPage) return (() => {
 																	if (hfEditPosition === "header") return firstPageHeaderContent;