@stll/folio-react 0.8.0 → 0.9.0

package/dist/{CommentsSidebar-Byn5lyrt.js → CommentsSidebar-BsrC2QJe.js}

@@ -1,4 +1,4 @@
-import { d as containedHandler } from "./renderAsync-BtWYvQMT.js";
+import { d as containedHandler } from "./renderAsync-u9iv6l9J.js";
 import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { CheckIcon, MoreVerticalIcon } from "lucide-react";
 import { useLocale, useTranslations } from "use-intl";

package/dist/compat/eigenpal.d.ts

@@ -1,4 +1,4 @@
-import { c as DocxEditorRef, i as renderAsync, n as EditorHandle, r as RenderAsyncOptions, s as DocxEditorProps, t as DocxEditorHandle } from "../renderAsync-BmxQE7iO.js";
+import { c as DocxEditorRef, i as renderAsync, n as EditorHandle, r as RenderAsyncOptions, s as DocxEditorProps, t as DocxEditorHandle } from "../renderAsync-7RA6LEtu.js";
 import { ReactNode } from "react";
 import { CreateEmptyDocumentOptions, createDocumentWithText, createEmptyDocument } from "@stll/folio-core/utils/createDocument";
 

package/dist/compat/eigenpal.js

@@ -1,4 +1,4 @@
-import { n as DocxEditor$1, t as renderAsync } from "../renderAsync-BtWYvQMT.js";
+import { n as DocxEditor$1, t as renderAsync } from "../renderAsync-u9iv6l9J.js";
 import { t as messages_exports } from "../messages.js";
 import { c } from "react-compiler-runtime";
 import { forwardRef } from "react";

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { _ as FontDefinition, a as DocxEditorApplyDocumentOperationsOptions, c as DocxEditorRef, d as FontOption, f as ColorPreset, g as OutlineItem, h as FolioUIProvider, i as renderAsync, l as ToolbarProps, m as FolioUIComponents, n as EditorHandle, o as DocxEditorCollaboration, p as FolioButtonProps, r as RenderAsyncOptions, s as DocxEditorProps, t as DocxEditorHandle, u as EditorMode } from "./renderAsync-BmxQE7iO.js";
+import { _ as FontDefinition, a as DocxEditorApplyDocumentOperationsOptions, c as DocxEditorRef, d as FontOption, f as ColorPreset, g as OutlineItem, h as FolioUIProvider, i as renderAsync, l as ToolbarProps, m as FolioUIComponents, n as EditorHandle, o as DocxEditorCollaboration, p as FolioButtonProps, r as RenderAsyncOptions, s as DocxEditorProps, t as DocxEditorHandle, u as EditorMode } from "./renderAsync-7RA6LEtu.js";
 import { A as HyperlinkDialog, C as ImagePropertiesData, D as ImagePositionDialog, E as ImagePositionData, F as FindReplaceDialog, I as FindReplaceDialogProps, M as HyperlinkDialogProps, N as FootnotePropertiesDialog, O as ImagePositionDialogProps, P as FootnotePropertiesDialogProps, S as InsertImageDialogProps, T as ImagePropertiesDialogProps, _ as InsertTableStyleOption, a as TablePropertiesDialogProps, b as InsertImageDialog, c as SplitCellDialogProps, d as PasteSpecialMode, f as PageSetupDialog, g as InsertTableDialogProps, h as InsertTableDialogData, i as TablePropertiesDialog, j as HyperlinkDialogData, k as HyperlinkBookmarkOption, l as PasteSpecialDialog, m as InsertTableDialog, n as WatermarkDialogProps, o as SplitCellDialog, p as PageSetupDialogProps, r as TableProperties, s as SplitCellDialogData, t as WatermarkDialog, u as PasteSpecialDialogProps, v as InsertSymbolDialog, w as ImagePropertiesDialog, x as InsertImageDialogData, y as InsertSymbolDialogProps } from "./dialogs-DK8OVUT_.js";
 import React, { CSSProperties, ReactNode, RefObject } from "react";
 import { CreateEmptyDocumentOptions, createEmptyDocument } from "@stll/folio-core/utils/createDocument";

package/dist/index.js

@@ -1,4 +1,4 @@
-import { a as formatZoom, c as FormattingBar, i as clampZoom, l as ZoomControl, n as DocxEditor, o as parseZoom, r as ZOOM_PRESETS, s as useWheelZoom, t as renderAsync, u as AutocompleteCaretOverlay } from "./renderAsync-BtWYvQMT.js";
+import { a as formatZoom, c as FormattingBar, i as clampZoom, l as ZoomControl, n as DocxEditor, o as parseZoom, r as ZOOM_PRESETS, s as useWheelZoom, t as renderAsync, u as AutocompleteCaretOverlay } from "./renderAsync-u9iv6l9J.js";
 import { n as FolioUIProvider } from "./folio-ui-BgDDRsUX.js";
 import { t as FindReplaceDialog } from "./FindReplaceDialog-CqKK82nE.js";
 import { t as FootnotePropertiesDialog } from "./FootnotePropertiesDialog-CixRdIiT.js";

package/dist/{renderAsync-BmxQE7iO.d.ts → renderAsync-7RA6LEtu.d.ts}

@@ -2,7 +2,7 @@ import React$1, { CSSProperties, ComponentProps, ComponentType, ReactNode, RefAt
 import { EditorState, Plugin, Transaction } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
 import { XmlFragment } from "yjs";
-import { FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditSnapshot, FolioCommentAnchor, FolioReviewChange } from "@stll/folio-core/ai-edits";
+import { FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditSnapshot, FolioCommentAnchor, FolioDocumentNavigationTarget, FolioReviewChange } from "@stll/folio-core/ai-edits";
 import { FolioDocumentOperationBatch, FolioDocumentOperationResult, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult } from "@stll/folio-core/server";
 import { ContentControlFilter, SetContentControlContentInput, SetContentControlValueInput } from "@stll/folio-core/content-controls";
 import { FolioEditor } from "@stll/folio-core/controller/folioEditor";
@@ -812,7 +812,8 @@ type DocxEditorRef = {
    * accept (insertAfterBlock / deleteBlock). Without `snapshot`, falls back to
    * a fresh-from-live-doc snapshot.
    */
-  scrollToBlock: (blockId: string, snapshot?: FolioAIEditSnapshot) => boolean;
+  scrollToBlock: (blockId: string, snapshot?: FolioAIEditSnapshot) => boolean; /** Resolve a stable block or text-range target and reveal it in the editor. */
+  showInDocument: (target: FolioDocumentNavigationTarget, snapshot?: FolioAIEditSnapshot) => boolean;
   /**
    * The tracked changes (insertions and deletions) present in the live
    * document, read from the current ProseMirror `state.doc`. Empty array
@@ -834,7 +835,8 @@ type DocxEditorRef = {
    * layout fragments with a newline. Returns `null` when the page number is
    * out of range or the layout hasn't been computed yet.
    */
-  getPageText: (page: number) => string | null;
+  getPageText: (page: number) => string | null; /** Resolve a stable block or text range to its real 1-based rendered page. */
+  getTargetPage: (target: FolioDocumentNavigationTarget, snapshot?: FolioAIEditSnapshot) => number | null;
   /**
    * List every block-level content control in the live document, filtered by
    * tag / alias / id / sdtType. Returns the modeled SdtProperties projection

package/dist/{renderAsync-BtWYvQMT.js → renderAsync-u9iv6l9J.js}

@@ -50,6 +50,7 @@ import { createFolioEditorEmitter } from "@stll/folio-core/controller/folioEdito
 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 +60,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 +75,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 +2542,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 +2562,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([
@@ -3190,7 +3038,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,
@@ -12306,7 +12154,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-BsrC2QJe.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 +13890,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 +14058,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 +14260,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 +14286,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 +14322,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 +14333,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 +14415,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 +14424,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 +14751,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 +14760,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 +14776,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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-react",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "React editor for folio: a Word-document (.docx) editor for the browser, built on @stll/folio-core and ProseMirror.",
   "keywords": [
     "document-editor",
@@ -67,7 +67,7 @@
     "@fontsource/noto-sans-arabic": "^5.2.7",
     "@fontsource/source-sans-3": "^5.2.9",
     "@fontsource/tinos": "^5.2.7",
-    "@stll/folio-core": "^0.5.0",
+    "@stll/folio-core": "^0.6.0",
     "better-result": "2.9.2",
     "lucide-react": "1.24.0",
     "prosemirror-history": "^1.5.0",