@stll/folio-react 0.8.1 → 0.10.0

package/dist/{renderAsync-BtWYvQMT.js → renderAsync-a7G-ZAcV.js}

@@ -47,9 +47,11 @@ import { schema as schema$1 } from "@stll/folio-core/prosemirror/schema";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { createFolioEditor } from "@stll/folio-core/controller/folioEditor";
 import { createFolioEditorEmitter } from "@stll/folio-core/controller/folioEditorEvents";
+import { createLatestRequestGate } from "@stll/folio-core/controller/latestRequestGate";
 import { runLayoutPipeline } from "@stll/folio-core/controller/layoutPipeline";
 import { browserClock, createLayoutScheduler } from "@stll/folio-core/controller/layoutScheduler";
 import { createLayoutSession } from "@stll/folio-core/controller/layoutSession";
+import { documentFontsAreLoaded, getDocumentFontSet, waitForInitialLayoutFonts } from "@stll/folio-core/controller/fontReadiness";
 import { getFootnoteText } from "@stll/folio-core/docx/footnoteParser";
 import { convertHeaderFooterPmDocToContent, convertHeaderFooterToContent } from "@stll/folio-core/layout-bridge/convert/headerFooterLayout";
 import { templatePreviewDirtyRange } from "@stll/folio-core/layout-bridge/convert/templatePreviewFlow";
@@ -59,6 +61,7 @@ import { clickToPositionInHfSlot, findHfCaretSpan, findHfPmSpans, findHfSlotForT
 import { clickToPosition } from "@stll/folio-core/layout-bridge/engine/clickToPosition";
 import { getPageTop, hitTestFragment, hitTestTableCell } from "@stll/folio-core/layout-bridge/engine/hitTest";
 import { clearAllCaches, resetCanvasContext } from "@stll/folio-core/layout-bridge/engine/measuring";
+import { resolveSectionHeaderFooterRefs } from "@stll/folio-core/layout-engine";
 import { recordLayoutPhase } from "@stll/folio-core/layout-engine/layoutInstrumentation";
 import { LayoutPainter } from "@stll/folio-core/layout-painter";
 import { PAINTER_PAINTED_EVENT, findPageShellForPmPos } from "@stll/folio-core/layout-painter/renderPage";
@@ -73,11 +76,11 @@ import { resizeColumnPair } from "@stll/folio-core/paged-layout/tableColumnResiz
 import { tableInsertButtonOffset } from "@stll/folio-core/paged-layout/tableInsertButtonGeometry";
 import { getTransactionDirtyRange } from "@stll/folio-core/paged-layout/transactionDirtyRange";
 import { findStartPosForParaId } from "@stll/folio-core/prosemirror/utils/findParagraphByParaId";
-import { expectFontFamilyMarkAttrs, expectImageAttrs, expectTableAttrs, expectTableCellAttrs, mergeImageAttrs, mergeTableAttrs, mergeTableCellAttrs, mergeTableRowAttrs } from "@stll/folio-core/prosemirror/attrs";
+import { expectImageAttrs, expectTableAttrs, expectTableCellAttrs, mergeImageAttrs, mergeTableAttrs, mergeTableCellAttrs, mergeTableRowAttrs } from "@stll/folio-core/prosemirror/attrs";
 import { extractEmbeddedFonts } from "@stll/folio-core/fonts/embeddedFonts";
 import { panic } from "better-result";
 import { collectRemoteSelections, createHiddenEditorManager, createHiddenEditorState } from "@stll/folio-core/controller/hiddenEditorManager";
-import { clampRangeToDocSize, resolveFolioAIBlockRange } from "@stll/folio-core/ai-edits/blockRange";
+import { clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange } from "@stll/folio-core/ai-edits/blockRange";
 import { getPageTextFromLayout } from "@stll/folio-core/paged-layout/pageText";
 import { CONTENT_CONTROL_WIDGET_EVENT_NAME, dispatchDatePick, dispatchDropdownPick } from "@stll/folio-core/prosemirror/plugins/contentControlWidgets";
 import { ErrorManager } from "@stll/folio-core/managers/ErrorManager";
@@ -2540,28 +2543,6 @@ function renderHeaderFooterContentByRId(source, hfPMs, contentWidth, metrics, op
 	}
 	return rendered.size > 0 ? rendered : void 0;
 }
-function getSectionHeaderFooterRefs(documentModel) {
-	const body = documentModel?.package.document;
-	if (!body) return;
-	const documentEvenAndOddHeaders = documentModel.package.settings?.evenAndOddHeaders === true;
-	const sections = body.sections;
-	if (sections && sections.length > 0) return sections.map((section) => getHeaderFooterRefsFromSectionProperties(section.properties, documentEvenAndOddHeaders));
-	const finalProps = body.finalSectionProperties;
-	if (!finalProps) return;
-	return [getHeaderFooterRefsFromSectionProperties(finalProps, documentEvenAndOddHeaders)];
-}
-function getHeaderFooterRefsFromSectionProperties(props, documentEvenAndOddHeaders) {
-	const refs = {};
-	if (props.titlePg !== void 0) refs.titlePg = props.titlePg;
-	refs.evenAndOddHeaders = props.evenAndOddHeaders ?? documentEvenAndOddHeaders;
-	for (const ref of props.headerReferences ?? []) if (ref.type === "default") refs.headerDefault = ref.rId;
-	else if (ref.type === "first") refs.headerFirst = ref.rId;
-	else refs.headerEven = ref.rId;
-	for (const ref of props.footerReferences ?? []) if (ref.type === "default") refs.footerDefault = ref.rId;
-	else if (ref.type === "first") refs.footerFirst = ref.rId;
-	else refs.footerEven = ref.rId;
-	return refs;
-}
 const getPageOverlayOffset = (pagesContainer, zoom) => {
 	const overlay = pagesContainer.parentElement?.querySelector("[data-testid=\"selection-overlay\"]");
 	const firstPage = pagesContainer.querySelector(".layout-page");
@@ -2582,139 +2563,7 @@ function stableJsonStringify(value) {
 		return nestedValue;
 	});
 }
-function getDocumentFontSet() {
-	if (typeof document === "undefined" || !("fonts" in document)) return null;
-	return document.fonts;
-}
-function documentFontsAreLoaded() {
-	const fontSet = getDocumentFontSet();
-	return !fontSet || fontSet.status === "loaded";
-}
-const INITIAL_LAYOUT_FONT_TIMEOUT_MS = 2e3;
 const INITIAL_FONT_READY_SUPPRESSION_MS = 250;
-const DEFAULT_LAYOUT_FONT_FAMILY = "Calibri";
-const OFFICE_FONT_FAMILY_MAP = {
-	Arial: "Arimo",
-	Calibri: "Carlito",
-	Cambria: "Caladea",
-	"Times New Roman": "Tinos",
-	"Courier New": "Cousine"
-};
-const CSS_GENERIC_FONT_FAMILIES = /* @__PURE__ */ new Set([
-	"serif",
-	"sans-serif",
-	"monospace",
-	"cursive",
-	"fantasy",
-	"system-ui"
-]);
-const REGULAR_LAYOUT_FONT_DESCRIPTOR = [
-	{
-		style: "normal",
-		weight: 400
-	},
-	{
-		style: "italic",
-		weight: 400
-	},
-	{
-		style: "normal",
-		weight: 700
-	},
-	{
-		style: "italic",
-		weight: 700
-	}
-][0];
-function waitForInitialLayoutFonts(documentModel, pmDoc) {
-	const fontSet = getDocumentFontSet();
-	if (!fontSet) return Promise.resolve(true);
-	const loadChecks = [];
-	for (const face of collectInitialLayoutFontFaces(documentModel, pmDoc)) loadChecks.push(`${face.style} ${face.weight} 16px "${escapeCssFontFamily(face.family)}"`);
-	const loadFonts = Promise.allSettled(loadChecks.map((check) => fontSet.load(check))).then(() => fontSet.ready).then(() => true);
-	return Promise.race([loadFonts, new Promise((resolve) => {
-		window.setTimeout(() => resolve(false), INITIAL_LAYOUT_FONT_TIMEOUT_MS);
-	})]);
-}
-function collectInitialLayoutFontFaces(documentModel, pmDoc) {
-	const faces = /* @__PURE__ */ new Map();
-	addLayoutFontFamilyFace(faces, DEFAULT_LAYOUT_FONT_FAMILY, REGULAR_LAYOUT_FONT_DESCRIPTOR);
-	for (const family of documentModel?.requiredFonts ?? []) addLayoutFontFamilyFace(faces, family, REGULAR_LAYOUT_FONT_DESCRIPTOR);
-	addLayoutFontFamilyFace(faces, documentModel?.package.theme?.fontScheme?.majorFont?.latin, REGULAR_LAYOUT_FONT_DESCRIPTOR);
-	addLayoutFontFamilyFace(faces, documentModel?.package.theme?.fontScheme?.minorFont?.latin, REGULAR_LAYOUT_FONT_DESCRIPTOR);
-	addTextFormattingFontFaces(faces, documentModel?.package.styles?.docDefaults?.rPr);
-	for (const style of documentModel?.package.styles?.styles ?? []) addTextFormattingFontFaces(faces, style.rPr);
-	collectProseMirrorFontFaces(faces, pmDoc, void 0);
-	return Array.from(faces.values());
-}
-function addTextFormattingFontFaces(faces, formatting) {
-	addLayoutFontFamilyFace(faces, formatting?.fontFamily, layoutDescriptorFromFormatting(formatting));
-}
-function collectProseMirrorFontFaces(faces, node, inheritedTextFormatting) {
-	const paragraphDefaults = readParagraphDefaultTextFormatting(node);
-	const textFormatting = paragraphDefaults ?? inheritedTextFormatting;
-	if (paragraphDefaults) addTextFormattingFontFaces(faces, paragraphDefaults);
-	if (node.attrs["listMarkerFontFamily"]) addLayoutFontFamilyFace(faces, node.attrs["listMarkerFontFamily"], REGULAR_LAYOUT_FONT_DESCRIPTOR);
-	if (node.isText) {
-		const descriptor = layoutDescriptorFromFormattingAndMarks(textFormatting, node.marks);
-		addLayoutFontFamilyFace(faces, readFontFamilyMarkAttrs(node.marks) ?? textFormatting?.fontFamily ?? DEFAULT_LAYOUT_FONT_FAMILY, descriptor);
-	}
-	node.forEach((child) => {
-		collectProseMirrorFontFaces(faces, child, textFormatting);
-	});
-}
-function readParagraphDefaultTextFormatting(node) {
-	const value = node.attrs["defaultTextFormatting"];
-	if (!value || typeof value !== "object") return;
-	return value;
-}
-function readFontFamilyMarkAttrs(marks) {
-	for (const mark of marks) if (mark.type.name === "fontFamily") return expectFontFamilyMarkAttrs(mark);
-}
-function layoutDescriptorFromFormatting(formatting) {
-	return {
-		style: formatting?.italic ? "italic" : "normal",
-		weight: formatting?.bold ? 700 : 400
-	};
-}
-function layoutDescriptorFromFormattingAndMarks(formatting, marks) {
-	let bold = formatting?.bold === true;
-	let italic = formatting?.italic === true;
-	for (const mark of marks) {
-		if (mark.type.name === "bold") bold = true;
-		if (mark.type.name === "italic") italic = true;
-	}
-	return {
-		style: italic ? "italic" : "normal",
-		weight: bold ? 700 : 400
-	};
-}
-function addLayoutFontFamilyFace(faces, value, descriptor) {
-	if (typeof value === "string") {
-		addLayoutFontFamilyNameFace(faces, value, descriptor);
-		return;
-	}
-	if (!value || typeof value !== "object") return;
-	const fontFamily = value;
-	addLayoutFontFamilyFace(faces, fontFamily.ascii, descriptor);
-	addLayoutFontFamilyFace(faces, fontFamily.hAnsi, descriptor);
-}
-function addLayoutFontFamilyNameFace(faces, family, descriptor) {
-	const normalized = family.trim();
-	if (!normalized || CSS_GENERIC_FONT_FAMILIES.has(normalized)) return;
-	addLayoutFontFace(faces, normalized, descriptor);
-	const mappedFamily = OFFICE_FONT_FAMILY_MAP[normalized];
-	if (mappedFamily) addLayoutFontFace(faces, mappedFamily, descriptor);
-}
-function addLayoutFontFace(faces, family, descriptor) {
-	faces.set(`${family}|${descriptor.style}|${descriptor.weight}`, {
-		family,
-		...descriptor
-	});
-}
-function escapeCssFontFamily(family) {
-	return family.replace(/\\/gu, "\\\\").replace(/"/gu, "\\\"");
-}
 function describeInvalidHighlightMarks(doc) {
 	const invalidHighlights = [];
 	const validHighlightColors = /* @__PURE__ */ new Set([
@@ -3038,14 +2887,14 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 	const [caretPosition, setCaretPosition] = useState(null);
 	const [anonymizationRectGroups, setAnonymizationRectGroups] = useState([]);
 	const anonymizationMatchesRef = useRef([]);
-	const anonymizationOverlayRequestSeqRef = useRef(0);
+	const [anonymizationOverlayRequestGate] = useState(createLatestRequestGate);
 	const autocompleteSuggestionRef = useRef({
 		status: "idle",
 		anchor: null,
 		text: "",
 		requestId: null
 	});
-	const autocompleteOverlayRequestSeqRef = useRef(0);
+	const [autocompleteOverlayRequestGate] = useState(createLatestRequestGate);
 	const [autocompleteCaret, setAutocompleteCaret] = useState(null);
 	const [autocompleteText, setAutocompleteText] = useState("");
 	const [autocompleteIsStreaming, setAutocompleteIsStreaming] = useState(false);
@@ -3053,7 +2902,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 	const [directiveGutter, setDirectiveGutter] = useState(null);
 	const [directiveCaretPos, setDirectiveCaretPos] = useState(null);
 	const directivesRef = useRef([]);
-	const directivesOverlayRequestSeqRef = useRef(0);
+	const [directivesOverlayRequestGate] = useState(createLatestRequestGate);
 	const templatePreviewRef = useRef({
 		entries: EMPTY_TEMPLATE_PREVIEW_ENTRIES,
 		mode: "plain"
@@ -3063,11 +2912,11 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		suggestions: EMPTY_AI_SUGGESTIONS,
 		focusedId: null
 	});
-	const aiSuggestionsOverlayRequestSeqRef = useRef(0);
+	const [aiSuggestionsOverlayRequestGate] = useState(createLatestRequestGate);
 	const [remoteSelections, setRemoteSelections] = useState([]);
 	const suppressSelectionOverlayRef = useRef(false);
 	const revealSelectionOverlayTimerRef = useRef(null);
-	const selectionOverlayRequestSeqRef = useRef(0);
+	const [selectionOverlayRequestGate] = useState(createLatestRequestGate);
 	const validPrecomputedInitialState = precomputedInitialDocumentRef.current === document ? precomputedInitialState : null;
 	precomputedInitialStateRef.current = validPrecomputedInitialState;
 	const [selectedImageInfo, setSelectedImageInfo] = useState(null);
@@ -3190,7 +3039,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 	const defaultTabStop = document?.package.settings?.defaultTabStop;
 	const documentSettings = document?.package.settings;
 	const mirrorMargins = documentSettings !== void 0 && "mirrorMargins" in documentSettings && documentSettings.mirrorMargins === true;
-	const sectionHeaderFooterRefs = useMemo(() => getSectionHeaderFooterRefs(document), [document]);
+	const sectionHeaderFooterRefs = useMemo(() => resolveSectionHeaderFooterRefs(document), [document]);
 	const layoutInputSignature = useMemo(() => buildLayoutInputSignature({
 		columns,
 		contentWidth,
@@ -3442,9 +3291,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 	*/
 	const updateSelectionOverlay = useCallback((state_3) => {
 		const { from, to } = state_3.selection;
-		const requestSeq = selectionOverlayRequestSeqRef.current + 1;
-		selectionOverlayRequestSeqRef.current = requestSeq;
-		const isCurrentRequest = () => selectionOverlayRequestSeqRef.current === requestSeq;
+		const isCurrentRequest = selectionOverlayRequestGate.begin();
 		if (directivesRef.current.length > 0) setDirectiveCaretPos(state_3.selection.head);
 		onSelectionChangeRef.current?.(from, to);
 		folioEmitterRef.current.emit("selectionChange", {
@@ -3586,14 +3433,13 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		blocks,
 		measures,
 		getCaretFromDom,
+		selectionOverlayRequestGate,
 		zoom
 	]);
 	const updateSelectionOverlayRef = useRef(updateSelectionOverlay);
 	updateSelectionOverlayRef.current = updateSelectionOverlay;
 	const updateAnonymizationOverlay = useCallback(() => {
-		const requestSeq_0 = anonymizationOverlayRequestSeqRef.current + 1;
-		anonymizationOverlayRequestSeqRef.current = requestSeq_0;
-		const isCurrentRequest_0 = () => anonymizationOverlayRequestSeqRef.current === requestSeq_0;
+		const isCurrentRequest_0 = anonymizationOverlayRequestGate.begin();
 		const matches = anonymizationMatchesRef.current;
 		if (matches.length === 0) {
 			setAnonymizationRectGroups([]);
@@ -3688,16 +3534,16 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 			if (fallbackGroups.length > 0 && isCurrentRequest_0()) setAnonymizationRectGroups([...groups, ...fallbackGroups]);
 		}, () => void 0);
 	}, [
+		anonymizationOverlayRequestGate,
 		layout,
 		blocks,
 		measures,
 		zoom
 	]);
 	const updateAutocompleteOverlay = useCallback(() => {
-		const requestSeq_1 = autocompleteOverlayRequestSeqRef.current + 1;
-		autocompleteOverlayRequestSeqRef.current = requestSeq_1;
+		const requestIsLatest = autocompleteOverlayRequestGate.begin();
 		const current = autocompleteSuggestionRef.current;
-		const isCurrentRequest_1 = () => autocompleteOverlayRequestSeqRef.current === requestSeq_1 && autocompleteSuggestionRef.current === current && current.status !== "idle" && current.text.length > 0;
+		const isCurrentRequest_1 = () => requestIsLatest() && autocompleteSuggestionRef.current === current && current.status !== "idle" && current.text.length > 0;
 		if (current.status === "idle" || current.text.length === 0) {
 			setAutocompleteCaret(null);
 			setAutocompleteText("");
@@ -3738,14 +3584,14 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 			setAutocompleteIsStreaming(current.status === "streaming");
 		}, () => void 0);
 	}, [
+		autocompleteOverlayRequestGate,
 		layout,
 		blocks,
 		measures,
 		zoom
 	]);
 	const updateDirectivesOverlay = useCallback(() => {
-		const requestSeq_2 = directivesOverlayRequestSeqRef.current + 1;
-		directivesOverlayRequestSeqRef.current = requestSeq_2;
+		const isCurrentRequest_2 = directivesOverlayRequestGate.begin();
 		const previewedStarts = new Set(templatePreviewRef.current.entries.map((entry) => entry.from));
 		const ranges = directivesRef.current.filter((range_2) => !(range_2.kind === "placeholder" && previewedStarts.has(range_2.from)));
 		const pagesContainer_1 = pagesContainerRef.current;
@@ -3763,17 +3609,17 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 				blocks,
 				measures
 			});
-			if (directivesOverlayRequestSeqRef.current === requestSeq_2) setDirectiveRectGroups(projected);
+			if (isCurrentRequest_2()) setDirectiveRectGroups(projected);
 		})();
 	}, [
+		directivesOverlayRequestGate,
 		layout,
 		blocks,
 		measures,
 		zoom
 	]);
 	const updateAISuggestionsOverlay = useCallback(() => {
-		const requestSeq_3 = aiSuggestionsOverlayRequestSeqRef.current + 1;
-		aiSuggestionsOverlayRequestSeqRef.current = requestSeq_3;
+		const isCurrentRequest_3 = aiSuggestionsOverlayRequestGate.begin();
 		const { suggestions, focusedId } = aiSuggestionsRef.current;
 		const pending = suggestions.filter((suggestion) => suggestion.status === "pending" && suggestion.range.from >= 0 && suggestion.range.to > suggestion.range.from);
 		const pagesContainer_2 = pagesContainerRef.current;
@@ -3793,7 +3639,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 				blocks,
 				measures
 			});
-			if (aiSuggestionsOverlayRequestSeqRef.current !== requestSeq_3) return;
+			if (!isCurrentRequest_3()) return;
 			const focused = projected_0.find(({ range: range_3 }) => range_3.suggestion.id === focusedId);
 			const fonts = collectRunFontsAtPmPositions(pagesContainer_2, focused ? [focused.range.from] : []);
 			setAiSuggestionRectGroups(projected_0.map(({ range: range_4, rects: rects_2 }) => ({
@@ -3804,13 +3650,14 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 			})));
 		})();
 	}, [
+		aiSuggestionsOverlayRequestGate,
 		layout,
 		blocks,
 		measures,
 		zoom
 	]);
 	const hideSelectionOverlayDuringInput = useCallback((state_4) => {
-		selectionOverlayRequestSeqRef.current += 1;
+		selectionOverlayRequestGate.invalidate();
 		suppressSelectionOverlayRef.current = true;
 		setCaretPosition(null);
 		setSelectionRects([]);
@@ -3820,13 +3667,24 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 			suppressSelectionOverlayRef.current = false;
 			updateSelectionOverlay(hiddenPMRef.current?.getState() ?? state_4);
 		}, SELECTION_REVEAL_AFTER_INPUT_DELAY);
-	}, [updateSelectionOverlay]);
+	}, [selectionOverlayRequestGate, updateSelectionOverlay]);
 	useEffect(() => () => {
+		selectionOverlayRequestGate.invalidate();
+		anonymizationOverlayRequestGate.invalidate();
+		autocompleteOverlayRequestGate.invalidate();
+		directivesOverlayRequestGate.invalidate();
+		aiSuggestionsOverlayRequestGate.invalidate();
 		if (revealSelectionOverlayTimerRef.current !== null) {
 			window.clearTimeout(revealSelectionOverlayTimerRef.current);
 			revealSelectionOverlayTimerRef.current = null;
 		}
-	}, []);
+	}, [
+		aiSuggestionsOverlayRequestGate,
+		anonymizationOverlayRequestGate,
+		autocompleteOverlayRequestGate,
+		directivesOverlayRequestGate,
+		selectionOverlayRequestGate
+	]);
 	/**
 	* Handle PM transaction - re-layout on content/selection change.
 	*/
@@ -12306,7 +12164,7 @@ function useFolioComments({ doc, autoOpenReviewSidebar, anchorPositions, editorC
 * - Error boundary
 * - Loading states
 */
-const CommentsSidebar = lazy(() => import("./CommentsSidebar-Byn5lyrt.js").then((m) => ({ default: m.CommentsSidebar })));
+const CommentsSidebar = lazy(() => import("./CommentsSidebar-Bopn32H9.js").then((m) => ({ default: m.CommentsSidebar })));
 const TextContextMenu = lazy(() => import("./TextContextMenu-Ci7-M4oU.js").then((m) => ({ default: m.TextContextMenu })));
 const loadAttemptSelectiveSave = async () => {
 	const { attemptSelectiveSave } = await import("@stll/folio-core/docx/selectiveSave");
@@ -14042,67 +13900,104 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 			});
 			return true;
 		},
-		getTrackedChanges: () => {
+		showInDocument: (target_1, snapshot_2) => {
 			const view_27 = pagedEditorRef.current?.getView();
-			return view_27 ? getTrackedChangesFromDoc(view_27.state.doc) : [];
+			if (!view_27) return false;
+			const range_4 = target_1.type === "textRange" ? resolveFolioAITextRange({
+				range: target_1,
+				doc: view_27.state.doc,
+				snapshot: snapshot_2
+			}) : resolveFolioAIBlockRange({
+				blockId: target_1.blockId,
+				doc: view_27.state.doc,
+				snapshot: snapshot_2
+			});
+			if (range_4 === null) return false;
+			const { from: from_10, to: to_10 } = range_4;
+			const $from_1 = view_27.state.doc.resolve(from_10);
+			const $to_1 = view_27.state.doc.resolve(to_10);
+			view_27.dispatch(view_27.state.tr.setSelection(TextSelection.between($from_1, $to_1)));
+			requestAnimationFrame(() => {
+				pagedEditorRef.current?.scrollToPosition(from_10);
+			});
+			return true;
 		},
-		getCommentAnchors: () => {
+		getTrackedChanges: () => {
 			const view_28 = pagedEditorRef.current?.getView();
-			return view_28 ? getCommentAnchorsFromDoc(view_28.state.doc) : [];
+			return view_28 ? getTrackedChangesFromDoc(view_28.state.doc) : [];
 		},
-		getSelectionText: () => {
+		getCommentAnchors: () => {
 			const view_29 = pagedEditorRef.current?.getView();
-			return view_29 ? getSelectedText(view_29.state) : "";
+			return view_29 ? getCommentAnchorsFromDoc(view_29.state.doc) : [];
 		},
-		getPageText: (page_0) => {
+		getSelectionText: () => {
 			const view_30 = pagedEditorRef.current?.getView();
-			if (!view_30) return null;
-			return getPageTextFromLayout(pagedEditorRef.current?.getEditor()?.getLayout() ?? null, view_30.state.doc, page_0);
+			return view_30 ? getSelectedText(view_30.state) : "";
 		},
-		getContentControls: (filter = {}) => {
+		getPageText: (page_0) => {
 			const view_31 = pagedEditorRef.current?.getView();
-			if (!view_31) return [];
-			return findBlockSdtMatches(view_31.state.doc, filter).map((match_0) => ({
+			if (!view_31) return null;
+			return getPageTextFromLayout(pagedEditorRef.current?.getEditor()?.getLayout() ?? null, view_31.state.doc, page_0);
+		},
+		getTargetPage: (target_2, snapshot_3) => {
+			const view_32 = pagedEditorRef.current?.getView();
+			if (!view_32) return null;
+			const range_5 = target_2.type === "textRange" ? resolveFolioAITextRange({
+				range: target_2,
+				doc: view_32.state.doc,
+				snapshot: snapshot_3
+			}) : resolveFolioAIBlockRange({
+				blockId: target_2.blockId,
+				doc: view_32.state.doc,
+				snapshot: snapshot_3
+			});
+			if (range_5 === null) return null;
+			return pagedEditorRef.current?.getPageNumberForPmPos(range_5.from) ?? null;
+		},
+		getContentControls: (filter = {}) => {
+			const view_33 = pagedEditorRef.current?.getView();
+			if (!view_33) return [];
+			return findBlockSdtMatches(view_33.state.doc, filter).map((match_0) => ({
 				properties: blockSdtAttrsToSdtProperties(match_0.node),
 				path: match_0.path,
 				pmPos: match_0.pos
 			}));
 		},
 		scrollToContentControl: (filter_0) => {
-			const view_32 = pagedEditorRef.current?.getView();
-			if (!view_32) return false;
-			const match_1 = findBlockSdtMatch(view_32.state.doc, filter_0);
+			const view_34 = pagedEditorRef.current?.getView();
+			if (!view_34) return false;
+			const match_1 = findBlockSdtMatch(view_34.state.doc, filter_0);
 			if (!match_1) return false;
 			const inside = match_1.pos + 1;
-			const $pos = view_32.state.doc.resolve(inside);
-			view_32.dispatch(view_32.state.tr.setSelection(TextSelection.near($pos)));
+			const $pos = view_34.state.doc.resolve(inside);
+			view_34.dispatch(view_34.state.tr.setSelection(TextSelection.near($pos)));
 			requestAnimationFrame(() => {
 				pagedEditorRef.current?.scrollToPosition(inside);
 			});
 			return true;
 		},
 		setContentControlContent: (filter_1, input, options_2 = {}) => {
-			const view_33 = pagedEditorRef.current?.getView();
-			if (!view_33) return false;
-			const tr_0 = typeof input === "string" ? setContentControlContentTr(view_33.state, filter_1, input, options_2) : setContentControlContentBlocksTr(view_33.state, filter_1, input, options_2);
+			const view_35 = pagedEditorRef.current?.getView();
+			if (!view_35) return false;
+			const tr_0 = typeof input === "string" ? setContentControlContentTr(view_35.state, filter_1, input, options_2) : setContentControlContentBlocksTr(view_35.state, filter_1, input, options_2);
 			if (!tr_0) return false;
-			view_33.dispatch(tr_0);
+			view_35.dispatch(tr_0);
 			return true;
 		},
 		setContentControlValue: (filter_2, input_0, options_3 = {}) => {
-			const view_34 = pagedEditorRef.current?.getView();
-			if (!view_34) return false;
-			const tr_1 = setContentControlValueTr(view_34.state, filter_2, input_0, options_3);
+			const view_36 = pagedEditorRef.current?.getView();
+			if (!view_36) return false;
+			const tr_1 = setContentControlValueTr(view_36.state, filter_2, input_0, options_3);
 			if (!tr_1) return false;
-			view_34.dispatch(tr_1);
+			view_36.dispatch(tr_1);
 			return true;
 		},
 		removeContentControl: (filter_3, options_4 = {}) => {
-			const view_35 = pagedEditorRef.current?.getView();
-			if (!view_35) return false;
-			const tr_2 = removeContentControlTr(view_35.state, filter_3, options_4);
+			const view_37 = pagedEditorRef.current?.getView();
+			if (!view_37) return false;
+			const tr_2 = removeContentControlTr(view_37.state, filter_3, options_4);
 			if (!tr_2) return false;
-			view_35.dispatch(tr_2);
+			view_37.dispatch(tr_2);
 			return true;
 		}
 	}), [
@@ -14173,39 +14068,39 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		if (isDisplayMode(value)) setDisplayMode(value);
 	}, [setDisplayMode]);
 	const handleAcceptActiveChange = useCallback(() => {
-		const view_36 = pagedEditorRef.current?.getView();
-		if (!view_36) return;
-		const { from: from_10, to: to_10 } = view_36.state.selection;
-		const range_4 = findChangeAtPosition(view_36.state, from_10, to_10);
-		acceptChange(range_4.from, range_4.to)(view_36.state, view_36.dispatch);
+		const view_38 = pagedEditorRef.current?.getView();
+		if (!view_38) return;
+		const { from: from_11, to: to_11 } = view_38.state.selection;
+		const range_6 = findChangeAtPosition(view_38.state, from_11, to_11);
+		acceptChange(range_6.from, range_6.to)(view_38.state, view_38.dispatch);
 	}, []);
 	const handleRejectActiveChange = useCallback(() => {
-		const view_37 = pagedEditorRef.current?.getView();
-		if (!view_37) return;
-		const { from: from_11, to: to_11 } = view_37.state.selection;
-		const range_5 = findChangeAtPosition(view_37.state, from_11, to_11);
-		rejectChange(range_5.from, range_5.to)(view_37.state, view_37.dispatch);
+		const view_39 = pagedEditorRef.current?.getView();
+		if (!view_39) return;
+		const { from: from_12, to: to_12 } = view_39.state.selection;
+		const range_7 = findChangeAtPosition(view_39.state, from_12, to_12);
+		rejectChange(range_7.from, range_7.to)(view_39.state, view_39.dispatch);
 	}, []);
 	const handlePreviousChange = useCallback(() => {
-		const view_38 = pagedEditorRef.current?.getView();
-		if (!view_38) return;
-		const { from: from_12 } = view_38.state.selection;
-		const change = findPreviousChange(view_38.state, from_12);
+		const view_40 = pagedEditorRef.current?.getView();
+		if (!view_40) return;
+		const { from: from_13 } = view_40.state.selection;
+		const change = findPreviousChange(view_40.state, from_13);
 		if (!change) return;
-		view_38.dispatch(view_38.state.tr.setSelection(TextSelection.create(view_38.state.doc, change.from, change.to)));
-		view_38.focus();
+		view_40.dispatch(view_40.state.tr.setSelection(TextSelection.create(view_40.state.doc, change.from, change.to)));
+		view_40.focus();
 		requestAnimationFrame(() => {
 			pagedEditorRef.current?.scrollToPosition(change.from);
 		});
 	}, []);
 	const handleNextChange = useCallback(() => {
-		const view_39 = pagedEditorRef.current?.getView();
-		if (!view_39) return;
-		const { to: to_12 } = view_39.state.selection;
-		const change_0 = findNextChange(view_39.state, to_12);
+		const view_41 = pagedEditorRef.current?.getView();
+		if (!view_41) return;
+		const { to: to_13 } = view_41.state.selection;
+		const change_0 = findNextChange(view_41.state, to_13);
 		if (!change_0) return;
-		view_39.dispatch(view_39.state.tr.setSelection(TextSelection.create(view_39.state.doc, change_0.from, change_0.to)));
-		view_39.focus();
+		view_41.dispatch(view_41.state.tr.setSelection(TextSelection.create(view_41.state.doc, change_0.from, change_0.to)));
+		view_41.focus();
 		requestAnimationFrame(() => {
 			pagedEditorRef.current?.scrollToPosition(change_0.from);
 		});
@@ -14375,8 +14270,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		requestAnimationFrame(syncCommentHighlightStyles);
 	}, [onScrollTopChange, syncCommentHighlightStyles]);
 	const handlePagedSelectionChange = useCallback((_from, _to) => {
-		const view_40 = getActiveEditorView() ?? pagedEditorRef.current?.getView() ?? null;
-		handleSelectionChange(view_40 ? extractSelectionState(view_40.state) : null);
+		const view_42 = getActiveEditorView() ?? pagedEditorRef.current?.getView() ?? null;
+		handleSelectionChange(view_42 ? extractSelectionState(view_42.state) : null);
 	}, [getActiveEditorView, handleSelectionChange]);
 	const handleTotalPagesChange = useCallback((totalPages) => {
 		setScrollPageInfo((previous) => updateScrollPageTotal(previous, totalPages));
@@ -14401,9 +14296,9 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	}, [author, updateComments]);
 	const handleAddComment = useCallback((addText) => {
 		const comment_3 = createComment(addText, author);
-		const view_41 = pagedEditorRef.current?.getView();
-		if (!view_41 || !commentSelectionRange) return false;
-		if (!applyCommentMarkRange(view_41, commentSelectionRange, comment_3.id, { replacePending: true })) return false;
+		const view_43 = pagedEditorRef.current?.getView();
+		if (!view_43 || !commentSelectionRange) return false;
+		if (!applyCommentMarkRange(view_43, commentSelectionRange, comment_3.id, { replacePending: true })) return false;
 		const commentAuthor_2 = getCommentAuthorKey(comment_3.author);
 		setVisibleCommentAuthors((current) => {
 			if (current === null) return null;
@@ -14437,8 +14332,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		updateComments((previous_4) => [...previous_4, createComment(text_6, author, revisionId_2)]);
 	}, [author, updateComments]);
 	const handleCancelAddComment = useCallback(() => {
-		const view_42 = pagedEditorRef.current?.getView();
-		if (view_42 && commentSelectionRange) removePendingCommentMarkRange(view_42, commentSelectionRange);
+		const view_44 = pagedEditorRef.current?.getView();
+		if (view_44 && commentSelectionRange) removePendingCommentMarkRange(view_44, commentSelectionRange);
 		setIsAddingComment(false);
 		setCommentSelectionRange(null);
 		setAddCommentYPosition(null);
@@ -14448,16 +14343,16 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		setCommentSelectionRange,
 		setIsAddingComment
 	]);
-	const handleSidebarAcceptChange = useCallback((from_13, to_13) => {
-		const view_43 = pagedEditorRef.current?.getView();
-		if (!view_43) return;
-		acceptChange(from_13, to_13)(view_43.state, view_43.dispatch);
+	const handleSidebarAcceptChange = useCallback((from_14, to_14) => {
+		const view_45 = pagedEditorRef.current?.getView();
+		if (!view_45) return;
+		acceptChange(from_14, to_14)(view_45.state, view_45.dispatch);
 		extractTrackedChanges();
 	}, [extractTrackedChanges]);
-	const handleSidebarRejectChange = useCallback((from_14, to_14) => {
-		const view_44 = pagedEditorRef.current?.getView();
-		if (!view_44) return;
-		rejectChange(from_14, to_14)(view_44.state, view_44.dispatch);
+	const handleSidebarRejectChange = useCallback((from_15, to_15) => {
+		const view_46 = pagedEditorRef.current?.getView();
+		if (!view_46) return;
+		rejectChange(from_15, to_15)(view_46.state, view_46.dispatch);
 		extractTrackedChanges();
 	}, [extractTrackedChanges]);
 	const commentsPageWidth = history.state?.package.document.finalSectionProperties?.pageWidth;
@@ -14530,8 +14425,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	const getBodyEditorView = useCallback(() => pagedEditorRef.current?.getView() ?? null, []);
 	const closeTableProperties = useCallback(() => setTablePropsOpen(false), []);
 	const applyTableProperties = useCallback((props_0) => {
-		const view_45 = getActiveEditorView();
-		if (view_45) setTableProperties(props_0)(view_45.state, view_45.dispatch);
+		const view_47 = getActiveEditorView();
+		if (view_47) setTableProperties(props_0)(view_47.state, view_47.dispatch);
 	}, [getActiveEditorView]);
 	const closeImagePosition = useCallback(() => setImagePositionOpen(false), [setImagePositionOpen]);
 	const closeImageProperties = useCallback(() => setImagePropsOpen(false), [setImagePropsOpen]);
@@ -14539,8 +14434,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	const closeFootnoteProperties = useCallback(() => setFootnotePropsOpen(false), []);
 	const closeInsertSymbol = useCallback(() => setShowInsertSymbol(false), []);
 	const insertSymbol = useCallback((symbol) => {
-		const view_46 = getActiveEditorView();
-		if (view_46) view_46.dispatch(view_46.state.tr.insertText(symbol).scrollIntoView());
+		const view_48 = getActiveEditorView();
+		if (view_48) view_48.dispatch(view_48.state.tr.insertText(symbol).scrollIntoView());
 	}, [getActiveEditorView]);
 	const imagePropertiesCurrentData = useMemo(() => buildImagePropertiesData(state.pmImageContext), [state.pmImageContext]);
 	const currentFindResult = findResultRef.current;
@@ -14866,8 +14761,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 														onMouseDown: (e_1) => {
 															e_1.preventDefault();
 															e_1.stopPropagation();
-															const view_47 = pagedEditorRef.current?.getView();
-															if (!view_47) {
+															const view_49 = pagedEditorRef.current?.getView();
+															if (!view_49) {
 																setFloatingCommentBtn(null);
 																return;
 															}
@@ -14875,9 +14770,9 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 																from: floatingCommentBtn.from,
 																to: floatingCommentBtn.to
 															};
-															const currentSelection = view_47.state.selection;
+															const currentSelection = view_49.state.selection;
 															const safeRange = resolveCommentCreationRange({
-																docSize: view_47.state.doc.content.size,
+																docSize: view_49.state.doc.content.size,
 																capturedRange,
 																currentRange: {
 																	from: currentSelection.from,
@@ -14891,7 +14786,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 																return;
 															}
 															setCommentSelectionRange(safeRange);
-															if (!applyCommentMarkRange(view_47, safeRange, -1, { selectEnd: true })) {
+															if (!applyCommentMarkRange(view_49, safeRange, -1, { selectEnd: true })) {
 																setCommentSelectionRange(null);
 																setFloatingCommentBtn(null);
 																return;