@stll/folio-react 0.24.1 → 0.25.0

package/dist/{renderAsync-DqldIlJu.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";
@@ -14,6 +15,7 @@ import { cloneDocumentWithParagraphPropertySources } from "@stll/folio-core/docx
 import { normalizeBaseDirection } from "@stll/folio-core/docx/normalizeBaseDirection";
 import { getCachedNumberingMap } from "@stll/folio-core/docx/numberingParser";
 import { classifyEditorKeydown, deleteSelectedTable, historyShortcutOwner, isFocusInInputLike, isKeydownInShortcutScope, isMacPlatform } from "@stll/folio-core/managers/editorShortcuts";
+import { getEditorScrollRoot, scrollEditorBy, scrollEditorElementIntoView, scrollEditorTo } from "@stll/folio-core/paged-layout/editorScrollRoot";
 import { computeScrollPageInfo, updateScrollPageTotal } from "@stll/folio-core/paged-layout/scrollPageInfo";
 import { NO_LIST_STATE, TextSelection, addColumnLeft, addColumnRight, addRowAbove, addRowBelow, applyFormatMarks, applyStyle, applyTableStyle, autoFitContents, captureFormatMarks, clearFormatting, clearTextColor, continueNumbering, createStyleResolver, decreaseIndent, decreaseListLevel, deleteColumn, deleteRow, deleteTable, distributeColumns, extractSelectionState, getDocumentBuiltInStyles, getSelectedText, getTableContext, increaseIndent, increaseListLevel, listStateLevel, mergeCells, removeTabStop, removeTableBorders, restartNumbering, sameListState, schema, selectColumn, selectRow, selectTable, setAlignment, setAllTableBorders, setCellBorder, setCellFillColor, setCellMargins, setCellTextDirection, setCellVerticalAlign, setFontFamily, setFontSize, setHighlight, setIndentFirstLine, setIndentLeft, setIndentRight, setInsideTableBorders, setLineSpacing, setLtr, setNumberingValue, setOutsideTableBorders, setRowHeight, setRtl, setTableBorderColor, setTableBorderPreset, setTableBorderWidth, setTableProperties, setTextColor, splitCell, toggleBidi, toggleBold, toggleBulletList, toggleHeaderRow, toggleItalic, toggleNoWrap, toggleNumberedList, toggleStrike, toggleSubscript, toggleSuperscript, toggleUnderline } from "@stll/folio-core/prosemirror";
 import { acceptAIEditRevision, acceptChange, acceptSuggestion, findAIEditRevisionRange, findChangeAtPosition, findNextChange, findParagraphBoundaryChangeAtPosition, findPreviousChange, findSuggestionRange, getSuggestions, rejectAIEditRevision, rejectChange, rejectSuggestion } from "@stll/folio-core/prosemirror/commands/comments";
@@ -22,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";
@@ -40,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";
@@ -51,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";
@@ -80,7 +87,7 @@ import { onPaintedLayoutChange, readBlockRects } from "@stll/folio-core/paged-la
 import { LayoutSelectionGate } from "@stll/folio-core/paged-layout/LayoutSelectionGate";
 import { collectRunFontsAtPmPositions, measureDirectiveGutter, projectRangesToRects } from "@stll/folio-core/paged-layout/rangeProjection";
 import { isReadOnlyEditKey } from "@stll/folio-core/paged-layout/readOnlyEditAttempt";
-import { getPageScrollTarget, prefersReducedMotionBehavior } from "@stll/folio-core/paged-layout/scrollNavigation";
+import { getPageScrollTarget } from "@stll/folio-core/paged-layout/scrollNavigation";
 import { PAGES_CONTAINER_CLASS, scrollPagesToPmPosition } from "@stll/folio-core/paged-layout/scrollToPmPosition";
 import { flashParagraphFragmentsByParaId } from "@stll/folio-core/paged-layout/paragraphFlash";
 import { resizeColumnPair } from "@stll/folio-core/paged-layout/tableColumnResize";
@@ -90,12 +97,12 @@ 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";
 import { getFolioParaIdFromBlockId } from "@stll/folio-core/types/block-id";
 import { getPageTextFromLayout } from "@stll/folio-core/paged-layout/pageText";
+import { allocateCommentId, seedCommentIdAbove } from "@stll/folio-core/prosemirror/commentIdAllocator";
 import { ContentControlWidgetController } from "@stll/folio-core/controller/contentControlWidgetController";
 import { createDefaultFindOptions, findInDocument } from "@stll/folio-core/utils/findReplace";
 import { PANEL_METRICS, computePanelLayout } from "@stll/folio-core/panel-layout";
@@ -337,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);
 		}
@@ -418,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);
@@ -436,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;
@@ -451,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);
 					}
@@ -469,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;
@@ -516,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: () => {
@@ -567,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,
@@ -631,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";
@@ -853,10 +890,7 @@ const AnonymizationRectsOverlay = ({ groups, onTermClick, selectedCanonical = nu
 			index: nextIndex
 		};
 		const el = spans[nextIndex];
-		if (el) el.scrollIntoView({
-			block: "center",
-			behavior: prefersReducedMotionBehavior()
-		});
+		if (el) scrollEditorElementIntoView(el);
 	}, [selectedCanonical, selectionSeq]);
 	const overlayRef = useRef(null);
 	useEffect(() => {
@@ -1219,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);
@@ -1244,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;
@@ -1273,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),
@@ -1332,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,
@@ -2170,18 +2222,6 @@ const TemplateDirectivesOverlay = (t0) => {
 const EDGE_ZONE = 40;
 /** Maximum scroll speed in pixels per frame (~60fps). */
 const MAX_SPEED = 12;
-/**
-* Find the nearest scrollable ancestor.
-*/
-function findScrollParent(el) {
-	let parent = el.parentElement;
-	while (parent && parent !== document.documentElement) {
-		const { overflowY } = getComputedStyle(parent);
-		if ((overflowY === "auto" || overflowY === "scroll") && parent.scrollHeight > parent.clientHeight) return parent;
-		parent = parent.parentElement;
-	}
-	return null;
-}
 function useDragAutoScroll({ pagesContainerRef, onScrollExtendSelection }) {
 	const rafIdRef = useRef(null);
 	const lastMouseRef = useRef({
@@ -2189,14 +2229,7 @@ function useDragAutoScroll({ pagesContainerRef, onScrollExtendSelection }) {
 		y: 0
 	});
 	const activeRef = useRef(false);
-	const scrollParentRef = useRef(null);
-	const getScrollParent = useCallback(() => {
-		if (scrollParentRef.current) return scrollParentRef.current;
-		const pages = pagesContainerRef.current;
-		if (!pages) return null;
-		scrollParentRef.current = findScrollParent(pages);
-		return scrollParentRef.current;
-	}, [pagesContainerRef]);
+	const getScrollParent = useCallback(() => getEditorScrollRoot(pagesContainerRef.current), [pagesContainerRef]);
 	const stopAutoScroll = useCallback(() => {
 		activeRef.current = false;
 		if (rafIdRef.current !== null) {
@@ -2219,7 +2252,7 @@ function useDragAutoScroll({ pagesContainerRef, onScrollExtendSelection }) {
 			scrollDelta = Math.min(MAX_SPEED, proximity_0 / EDGE_ZONE * MAX_SPEED);
 		}
 		if (scrollDelta !== 0) {
-			container.scrollTop += scrollDelta;
+			scrollEditorBy(container, scrollDelta);
 			onScrollExtendSelection(mx, my);
 		}
 		rafIdRef.current = requestAnimationFrame(tick);
@@ -2839,27 +2872,37 @@ 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 scrollContainerRefProp.current;
-		return containerRef.current;
+		if (scrollContainerRefProp && typeof scrollContainerRefProp === "object") return getEditorScrollRoot(scrollContainerRefProp.current);
+		return getEditorScrollRoot(containerRef.current);
 	}, [scrollContainerRefProp]);
 	const containerRef = useRef(null);
 	const pagesContainerRef = useRef(null);
+	useLayoutEffect(() => {
+		if (!scrollContainerRefProp || typeof scrollContainerRefProp !== "object") return;
+		const root = scrollContainerRefProp.current;
+		if (!root || root.hasAttribute("data-folio-scroll")) return;
+		root.setAttribute("data-folio-scroll", "");
+		return () => root.removeAttribute("data-folio-scroll");
+	}, [scrollContainerRefProp]);
 	const folioEmitterRef = useRef(createFolioEditorEmitter());
 	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;
@@ -2879,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;
@@ -3000,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]);
@@ -3224,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) {
@@ -3256,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(() => {
@@ -3866,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;
@@ -3883,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) {
@@ -3896,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;
@@ -4029,10 +4099,8 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 			scrollToPositionImpl(target_0.pmPos);
 			return;
 		}
-		(pagesContainerRef.current?.querySelector(`[data-page-number="${String(target_0.pageIndex + 1)}"]`))?.scrollIntoView({
-			block: "center",
-			inline: "nearest"
-		});
+		const shell = pagesContainerRef.current?.querySelector(`[data-page-number="${String(target_0.pageIndex + 1)}"]`);
+		scrollEditorElementIntoView(shell ?? null);
 	}, [layout, scrollToPositionImpl]);
 	const scrollToParaIdImpl = useCallback((paraId, options_2) => {
 		const state_7 = hiddenPMRef.current?.getState();
@@ -4765,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;
 			}
@@ -4908,7 +4980,9 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 			}
 		}
 	}, [
+		experimentalSession,
 		getPositionFromMouse,
+		handleSessionRefusal,
 		onHeaderFooterDoubleClick,
 		onHyperlinkClick,
 		readOnly
@@ -5100,11 +5174,17 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		if (["PageUp", "PageDown"].includes(e_7.key) && !e_7.metaKey && !e_7.ctrlKey) {}
 		if (e_7.key === "Home" && (e_7.metaKey || e_7.ctrlKey)) {
 			const sc = getScrollContainer();
-			if (sc) sc.scrollTop = 0;
+			if (sc) scrollEditorTo(sc, {
+				top: 0,
+				behavior: "instant"
+			});
 		}
 		if (e_7.key === "End" && (e_7.metaKey || e_7.ctrlKey)) {
 			const sc_0 = getScrollContainer();
-			if (sc_0) sc_0.scrollTop = sc_0.scrollHeight;
+			if (sc_0) scrollEditorTo(sc_0, {
+				top: sc_0.scrollHeight,
+				behavior: "instant"
+			});
 		}
 	}, [
 		copySelectionText,
@@ -5410,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;
 		},
@@ -5420,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) {
@@ -5451,20 +5534,34 @@ 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({
+				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;
+			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();
-			return target_7.type === "none" ? false : undo(target_7.view.state);
+			if (target_7.type === "none") return false;
+			return experimentalSession === "canonical" || target_7.type === "body" ? hiddenPMRef.current?.canUndo() ?? false : undo(target_7.view.state);
 		},
 		canRedo() {
 			const target_8 = getActiveEditorStory();
-			return target_8.type === "none" ? false : redo(target_8.view.state);
+			if (target_8.type === "none") return false;
+			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);
@@ -5548,6 +5645,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		flushDocumentChangeNotification,
 		folioEditor,
 		getActiveEditorStory,
+		getCanonicalActiveStory,
 		noteFollower,
 		getScrollContainer,
 		refreshBodyImeCaretAnchor,
@@ -5603,6 +5701,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 	};
 	return /* @__PURE__ */ jsxs("div", {
 		ref: containerRef,
+		"data-folio-scroll": scrollContainerRefProp && typeof scrollContainerRefProp === "object" ? void 0 : "",
 		className: `folio-root paged-editor ${className ?? ""}`,
 		style: {
 			...containerStyles,
@@ -5620,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 } : {}
 			}),
@@ -5627,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,
@@ -5639,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,
@@ -6804,20 +6913,6 @@ const toast = (msg) => {
 };
 /** Stable empty anchor positions Map used as the initial state. */
 const EMPTY_ANCHOR_POSITIONS = /* @__PURE__ */ new Map();
-let nextCommentId = Date.now();
-function allocateCommentId() {
-	return nextCommentId++;
-}
-/**
-* Bump the in-process comment-id counter above `id` so a later
-* `allocateCommentId()` can never re-mint an id that was adopted from an
-* external source-of-truth model. No-op when `id` is already below the
-* current counter. Mirrors the allocator-seeding behaviour of upstream
-* docx-editor's `CommentIdAllocator.seedAbove` (05f2ab84).
-*/
-function seedCommentIdAbove(id) {
-	if (id >= nextCommentId) nextCommentId = id + 1;
-}
 function getCommentAuthorKey(author) {
 	const trimmed = author?.trim();
 	return trimmed && trimmed.length > 0 ? trimmed : "Unknown";
@@ -7176,10 +7271,7 @@ const readFindSelectionSeed = () => {
 //#region src/components/dialogs/findReplaceUtils.ts
 const scrollToMatch = (containerElement, match) => {
 	if (!containerElement) return;
-	(containerElement.querySelector(`[data-paragraph-index="${match.paragraphIndex}"]`) ?? containerElement.querySelector(`.layout-paragraph[data-block-id="block-${match.paragraphIndex + 1}"]`) ?? containerElement.querySelectorAll(".layout-paragraph").item(match.paragraphIndex)).scrollIntoView({
-		behavior: prefersReducedMotionBehavior(),
-		block: "center"
-	});
+	scrollEditorElementIntoView(containerElement.querySelector(`[data-paragraph-index="${match.paragraphIndex}"]`) ?? containerElement.querySelector(`.layout-paragraph[data-block-id="block-${match.paragraphIndex + 1}"]`) ?? containerElement.querySelectorAll(".layout-paragraph").item(match.paragraphIndex));
 };
 //#endregion
 //#region src/components/dialogs/useFindReplace.ts
@@ -10083,15 +10175,17 @@ function useContextMenu(t0) {
 * callbacks each render.
 */
 const useDocumentLoader = (t0) => {
-	const $ = c(21);
-	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,
@@ -10107,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,
@@ -10125,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,
@@ -10139,45 +10234,58 @@ 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) {
+	if ($[18] !== documentBuffer || $[19] !== history.state || $[20] !== loadedDocumentIdentity) {
 		t5 = () => {
+			if (originalBufferIdentityRef.current === loadedDocumentIdentity) return;
+			originalBufferIdentityRef.current = loadedDocumentIdentity;
 			if (history.state?.originalBuffer) {
 				originalBufferRef.current = history.state.originalBuffer;
 				return;
 			}
-			if (documentBuffer instanceof ArrayBuffer) originalBufferRef.current = documentBuffer;
+			originalBufferRef.current = documentBuffer instanceof ArrayBuffer ? documentBuffer : null;
 		};
-		t6 = [history.state, documentBuffer];
-		$[12] = documentBuffer;
-		$[13] = history.state;
-		$[14] = t5;
-		$[15] = t6;
+		t6 = [
+			history.state,
+			documentBuffer,
+			loadedDocumentIdentity
+		];
+		$[18] = documentBuffer;
+		$[19] = history.state;
+		$[20] = loadedDocumentIdentity;
+		$[21] = t5;
+		$[22] = t6;
 	} else {
-		t5 = $[14];
-		t6 = $[15];
+		t5 = $[21];
+		t6 = $[22];
 	}
 	useEffect(t5, t6);
 	let t7;
-	if ($[16] !== api.loadBuffer || $[17] !== api.loadParsedDocument || $[18] !== api.resetForNewDocument || $[19] !== loadedDocumentIdentity) {
+	if ($[23] !== api.loadBuffer || $[24] !== api.loadParsedDocument || $[25] !== api.resetForNewDocument || $[26] !== loadedDocumentIdentity) {
 		t7 = {
 			loadBuffer: api.loadBuffer,
 			loadParsedDocument: api.loadParsedDocument,
@@ -10185,12 +10293,12 @@ const useDocumentLoader = (t0) => {
 			originalBufferRef,
 			loadedDocumentIdentity
 		};
-		$[16] = api.loadBuffer;
-		$[17] = api.loadParsedDocument;
-		$[18] = api.resetForNewDocument;
-		$[19] = loadedDocumentIdentity;
-		$[20] = t7;
-	} else t7 = $[20];
+		$[23] = api.loadBuffer;
+		$[24] = api.loadParsedDocument;
+		$[25] = api.resetForNewDocument;
+		$[26] = loadedDocumentIdentity;
+		$[27] = t7;
+	} else t7 = $[27];
 	return t7;
 };
 //#endregion
@@ -10473,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]);
@@ -10491,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;
@@ -10503,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;
@@ -10527,7 +10654,8 @@ const useHeaderFooterEditor = ({ history, pushDocument, getHfView }) => {
 		resolution,
 		history,
 		pushDocument,
-		getHfView
+		getHfView,
+		experimentalSession
 	]);
 	return {
 		hfEditPosition,
@@ -10555,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,
@@ -10566,7 +10705,9 @@ const useHeaderFooterEditor = ({ history, pushDocument, getHfView }) => {
 			hfEditIsFirstPage,
 			resolution,
 			history,
-			pushDocument
+			pushDocument,
+			getCanonicalApi,
+			experimentalSession
 		])
 	};
 };
@@ -11019,7 +11160,10 @@ function useZoomAndPageInfo({ scrollContainerRef, pagedEditorRef, initialZoom })
 		if (anchor.zoom === zoom) return;
 		const scrollContainer_1 = scrollContainerRef.current;
 		if (!scrollContainer_1) return;
-		scrollContainer_1.scrollTop = getScrollTopForZoomAnchor(anchor, zoom);
+		scrollEditorTo(scrollContainer_1, {
+			top: getScrollTopForZoomAnchor(anchor, zoom),
+			behavior: "instant"
+		});
 		updateScrollPageInfo(scrollContainer_1);
 		scheduleScrollPageInfoFade();
 	}, [
@@ -12637,15 +12781,25 @@ function useFolioComments({ doc, autoOpenReviewSidebar, anchorPositions, editorC
 	const sanitizedCommentsProp = useMemo(() => commentsProp !== void 0 ? sanitizeControlledComments(commentsProp) : void 0, [commentsProp]);
 	const isControlledComments = sanitizedCommentsProp !== void 0;
 	const comments = isControlledComments ? sanitizedCommentsProp : internalComments;
+	useLayoutEffect(() => {
+		for (const { id } of doc?.package.document.comments ?? []) seedCommentIdAbove(id);
+		for (const { id: id_0 } of comments) seedCommentIdAbove(id_0);
+	}, [comments, doc]);
 	const commentsDirtyRef = useRef(false);
 	const commentsRef = useRef(comments);
 	commentsRef.current = comments;
 	const readonlyCommentsRef = commentsRef;
 	const onCommentsChangeRef = useRef(onCommentsChange);
 	onCommentsChangeRef.current = onCommentsChange;
+	const createComment$1 = useCallback((text, author, parentId) => {
+		for (const { id: id_1 } of doc?.package.document.comments ?? []) seedCommentIdAbove(id_1);
+		for (const { id: id_2 } of commentsRef.current) seedCommentIdAbove(id_2);
+		return createComment(text, author, parentId);
+	}, [doc]);
 	const setComments = useCallback((next) => {
 		const resolved = typeof next === "function" ? next(commentsRef.current) : next;
 		if (resolved === commentsRef.current) return;
+		for (const { id: id_3 } of resolved) seedCommentIdAbove(id_3);
 		commentsRef.current = resolved;
 		if (!isControlledComments) setInternalComments(resolved);
 		onCommentsChangeRef.current?.(resolved);
@@ -12693,13 +12847,13 @@ function useFolioComments({ doc, autoOpenReviewSidebar, anchorPositions, editorC
 	const visibleComments = useMemo(() => {
 		const visibleRootIds = /* @__PURE__ */ new Set();
 		for (const comment_1 of comments) {
-			const parentId = getCommentParentId(comment_1);
-			if (parentId === null || parentId === void 0 || !visibleCommentIds.has(comment_1.id)) continue;
-			visibleRootIds.add(parentId);
+			const parentId_0 = getCommentParentId(comment_1);
+			if (parentId_0 === null || parentId_0 === void 0 || !visibleCommentIds.has(comment_1.id)) continue;
+			visibleRootIds.add(parentId_0);
 		}
 		return comments.filter((comment_2) => {
-			const parentId_0 = getCommentParentId(comment_2);
-			if (parentId_0 !== null && parentId_0 !== void 0) return visibleCommentIds.has(comment_2.id);
+			const parentId_1 = getCommentParentId(comment_2);
+			if (parentId_1 !== null && parentId_1 !== void 0) return visibleCommentIds.has(comment_2.id);
 			return visibleCommentIds.has(comment_2.id) || visibleRootIds.has(comment_2.id);
 		});
 	}, [comments, visibleCommentIds]);
@@ -12712,7 +12866,7 @@ function useFolioComments({ doc, autoOpenReviewSidebar, anchorPositions, editorC
 		if (!root) return;
 		const nodes = root.querySelectorAll(`.layout-run-text${COMMENT_ANCHOR_SELECTOR}`);
 		for (const node of nodes) {
-			const commentIds = commentAnchorIds(node).map((id) => Number.parseInt(id, 10));
+			const commentIds = commentAnchorIds(node).map((id_4) => Number.parseInt(id_4, 10));
 			if (!commentIds.some((commentId) => commentId === -1 || visibleCommentIds.has(commentId))) {
 				node.style.backgroundColor = "transparent";
 				node.style.borderBottom = "2px solid transparent";
@@ -12757,6 +12911,7 @@ function useFolioComments({ doc, autoOpenReviewSidebar, anchorPositions, editorC
 	return {
 		comments,
 		setComments,
+		createComment: createComment$1,
 		isControlledComments,
 		commentsRef: readonlyCommentsRef,
 		commentsDirtyRef,
@@ -12794,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-D0TBbrpB.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");
@@ -12865,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 = () => {
@@ -12904,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(() => {
@@ -12957,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();
@@ -13017,8 +13193,30 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		if (!onEditorViewReady) return;
 		if (lastReportedViewRef.current === view_0) return;
 		lastReportedViewRef.current = view_0;
+		if (view_0 && initialScrollTop !== void 0) {
+			const initialScroll = initialScrollRef.current;
+			switch (initialScroll.status) {
+				case "scheduled":
+					cancelAnimationFrame(initialScroll.frame);
+					scrollEditorTo(scrollContainerRef.current, {
+						top: initialScrollTop,
+						behavior: "instant"
+					});
+					initialScrollRef.current = { status: "applied" };
+					break;
+				case "waiting":
+					scrollEditorTo(scrollContainerRef.current, {
+						top: initialScrollTop,
+						behavior: "instant"
+					});
+					initialScrollRef.current = { status: "applied" };
+					break;
+				case "applied": break;
+				default: return initialScroll;
+			}
+		}
 		onEditorViewReady(view_0);
-	}, [onEditorViewReady]);
+	}, [onEditorViewReady, initialScrollTop]);
 	useLayoutEffect(() => {
 		if (!onEditorViewReady) return;
 		const view_1 = pagedEditorRef.current?.getView() ?? null;
@@ -13077,7 +13275,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	const imageInputRef = useRef(null);
 	const editorContentRef = useRef(null);
 	const scrollContainerRef = useRef(null);
-	const initialScrollAppliedRef = useRef(false);
+	const initialScrollRef = useRef({ status: "waiting" });
 	const [widestLaidOutPageWidth, setWidestLaidOutPageWidth] = useState(null);
 	const hasDocument = history.state !== null;
 	useEffect(() => {
@@ -13118,7 +13316,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		size: 4,
 		color: { rgb: "000000" }
 	});
-	const { comments, setComments, commentsRef, commentsDirtyRef, commentsLoadedRef, showCommentsSidebar, setShowCommentsSidebar, setVisibleCommentAuthors, activeCommentId, setActiveCommentId, isAddingComment, setIsAddingComment, commentSelectionRange, setCommentSelectionRange, addCommentYPosition, setAddCommentYPosition, floatingCommentBtn, setFloatingCommentBtn, commentAuthors, visibleCommentAuthorSet, visibleComments, syncCommentHighlightStyles } = useFolioComments({
+	const { comments, createComment, setComments, commentsRef, commentsDirtyRef, commentsLoadedRef, showCommentsSidebar, setShowCommentsSidebar, setVisibleCommentAuthors, activeCommentId, setActiveCommentId, isAddingComment, setIsAddingComment, commentSelectionRange, setCommentSelectionRange, addCommentYPosition, setAddCommentYPosition, floatingCommentBtn, setFloatingCommentBtn, commentAuthors, visibleCommentAuthorSet, visibleComments, syncCommentHighlightStyles } = useFolioComments({
 		doc: history.state,
 		autoOpenReviewSidebar,
 		anchorPositions,
@@ -13156,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;
@@ -13171,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;
@@ -13203,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();
@@ -13239,15 +13449,19 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		documentBuffer: documentBuffer ?? null,
 		initialDocument: initialDocument ?? null,
 		password,
+		...experimentalSession === void 0 ? {} : { experimentalSession },
 		history,
 		onError,
 		onCompatibilityChange,
 		onReset: useCallback(() => {
-			initialScrollAppliedRef.current = false;
-			if (scrollContainerRef.current) {
-				scrollContainerRef.current.scrollTop = 0;
-				scrollContainerRef.current.scrollLeft = 0;
-			}
+			const initialScroll_0 = initialScrollRef.current;
+			if (initialScroll_0.status === "scheduled") cancelAnimationFrame(initialScroll_0.frame);
+			initialScrollRef.current = { status: "waiting" };
+			if (scrollContainerRef.current) scrollEditorTo(scrollContainerRef.current, {
+				top: 0,
+				left: 0,
+				behavior: "instant"
+			});
 			commentsDirtyRef.current = false;
 			commentsLoadedRef.current = false;
 			setComments([]);
@@ -13303,13 +13517,24 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		extractTrackedChanges
 	]);
 	useEffect(() => {
-		if (initialScrollTop === void 0 || state.documentLoad.status !== "ready" || initialScrollAppliedRef.current) return;
-		initialScrollAppliedRef.current = true;
+		if (initialScrollTop === void 0 || state.documentLoad.status !== "ready" || initialScrollRef.current.status !== "waiting") return;
 		const frame = requestAnimationFrame(() => {
-			if (scrollContainerRef.current) scrollContainerRef.current.scrollTop = initialScrollTop;
+			initialScrollRef.current = { status: "applied" };
+			scrollEditorTo(scrollContainerRef.current, {
+				top: initialScrollTop,
+				behavior: "instant"
+			});
 		});
+		initialScrollRef.current = {
+			status: "scheduled",
+			frame
+		};
 		return () => {
-			cancelAnimationFrame(frame);
+			const initialScroll_1 = initialScrollRef.current;
+			if (initialScroll_1.status === "scheduled" && initialScroll_1.frame === frame) {
+				cancelAnimationFrame(frame);
+				initialScrollRef.current = { status: "waiting" };
+			}
 		};
 	}, [
 		initialScrollTop,
@@ -13338,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(() => {
@@ -13359,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) {
@@ -13387,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();
@@ -13397,7 +13634,9 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	}, [
 		buildCurrentDocument,
 		commentsDirtyRef,
+		experimentalSession,
 		onChange,
+		refuseCanonicalModelEdit,
 		setComments
 	]);
 	const updateComments = useCallback((updater) => {
@@ -13650,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,
@@ -13666,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;
@@ -13861,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;
@@ -13959,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;
@@ -14275,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":
@@ -14313,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,
@@ -14331,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]);
@@ -14362,6 +14639,9 @@ 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;
@@ -14369,18 +14649,13 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 			const flags = resolveSelectiveSaveFlags(featureFlags);
 			const useSelectiveForSave = flags.selectiveSave && options?.mode !== FOLIO_DOCX_SERIALIZATION_MODE.full;
 			const shouldAttemptSelective = useSelectiveForSave || flags.selectiveSaveTripwire;
-			const view_18 = pagedEditorRef.current?.getView();
-			const baselineBuffer = originalBufferRef.current;
 			let selectiveBuffer = null;
-			if (shouldAttemptSelective && view_18 && baselineBuffer) {
-				const editorState = view_18.state;
-				selectiveBuffer = await (await loadAttemptSelectiveSave())(doc_1, baselineBuffer, {
-					changedParaIds: getChangedParagraphIds(editorState),
-					structuralChange: hasStructuralChanges(editorState),
-					hasUntrackedChanges: hasUntrackedChanges(editorState),
-					maxBytes: flags.selectiveSaveMaxBytes
-				});
-			}
+			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 ? {
@@ -14390,8 +14665,12 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 			const repackFull = async () => {
 				const repackDocx = await loadRepackDocx();
 				const repack = () => repackDocx(repackSourceDoc);
-				return view_18 ? repackWithEditorSectionRemovals({
-					state: view_18.state,
+				if (experimentalSession === "canonical") return repackWithCanonicalStoryRemovals({
+					document: repackSourceDoc,
+					repack
+				});
+				return editorState ? repackWithEditorSectionRemovals({
+					state: editorState,
 					document: repackSourceDoc,
 					repack
 				}) : repack();
@@ -14406,13 +14685,13 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 				const { compareSelectiveVsFull } = await import("@stll/folio-core/docx/selectiveSaveTripwire");
 				tripwireResult = await compareSelectiveVsFull(selectiveBuffer, fullBuffer);
 			} catch {}
-			if (view_18) {
+			if (view_18 && pagedEditorRef.current?.getView() === view_18 && view_18.state.doc === editorState?.doc) {
 				originalBufferRef.current = buffer;
 				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);
@@ -14446,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(),
@@ -14646,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;
@@ -14940,10 +15224,12 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		loadBuffer,
 		updateComments,
 		replaceComments,
+		createComment,
 		commentsRef,
 		commentsDirtyRef,
 		getActiveEditorStory,
-		refreshBodyHistoryAvailability
+		refreshBodyHistoryAvailability,
+		experimentalSession
 	]);
 	const getHfTargetElement = useCallback((pos_0) => {
 		const pagesContainer = containerRef.current?.querySelector(".paged-editor__pages");
@@ -14956,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
@@ -15011,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();
@@ -15217,23 +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, updateComments]);
+	}, [
+		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;
@@ -15259,6 +15567,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	}, [
 		author,
 		commentSelectionRange,
+		createComment,
+		refuseCanonicalModelEdit,
 		setActiveCommentId,
 		setAddCommentYPosition,
 		setCommentSelectionRange,
@@ -15268,8 +15578,14 @@ 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, updateComments]);
+	}, [
+		author,
+		createComment,
+		refuseCanonicalModelEdit,
+		updateComments
+	]);
 	const handleCancelAddComment = useCallback(() => {
 		const view_55 = pagedEditorRef.current?.getView();
 		if (view_55 && commentSelectionRange) removePendingCommentMarkRange(view_55, commentSelectionRange);
@@ -15292,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) => {
@@ -15300,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;
@@ -15619,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,
@@ -15789,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,
@@ -15799,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",
@@ -15907,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;