@stll/folio-react 0.16.7 → 0.17.0

package/dist/{CommentsSidebar-DsY20BSs.js → CommentsSidebar-DtoKrEhl.js}

@@ -1,4 +1,4 @@
-import { d as containedHandler } from "./renderAsync-D5MafItf.js";
+import { d as containedHandler } from "./renderAsync-BTVnhZop.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-Dhu0sHJ4.js";
+import { c as DocxEditorRef, i as renderAsync, n as EditorHandle, r as RenderAsyncOptions, s as DocxEditorProps, t as DocxEditorHandle } from "../renderAsync-CqIfcY3H.js";
 import { ReactNode } from "react";
 import { CreateEmptyDocumentOptions, createDocumentWithText, createEmptyDocument } from "@stll/folio-core/utils/createDocument";
 //#region src/compat/eigenpal.d.ts

package/dist/compat/eigenpal.js

@@ -1,4 +1,4 @@
-import { n as DocxEditor$1, t as renderAsync } from "../renderAsync-D5MafItf.js";
+import { n as DocxEditor$1, t as renderAsync } from "../renderAsync-BTVnhZop.js";
 import { t as messages_exports } from "../messages.js";
 import { c } from "react-compiler-runtime";
 import { forwardRef } from "react";
@@ -75,47 +75,58 @@ const useTranslation = () => {
 	return t1;
 };
 const DocxEditor = forwardRef((t0, ref) => {
-	const $ = c(11);
+	const $ = c(14);
+	let disableFindReplaceShortcuts;
 	let i18n;
+	let keyboardShortcuts;
 	let locale;
 	let props;
 	if ($[0] !== t0) {
-		const { agentPanel: _agentPanel, colorMode: _colorMode, commentsSidebarOpen: _commentsSidebarOpen, disableFindReplaceShortcuts: _disableFindReplaceShortcuts, documentName: _documentName, documentNameEditable: _documentNameEditable, externalContent: _externalContent, externalPlugins: _externalPlugins, i18n: t1, locale: t2, onCommentAdd: _onCommentAdd, onCommentDelete: _onCommentDelete, onCommentReply: _onCommentReply, onCommentResolve: _onCommentResolve, onCommentsSidebarOpenChange: _onCommentsSidebarOpenChange, onDocumentNameChange: _onDocumentNameChange, onOpen: _onOpen, onRenderedDomContextReady: _onRenderedDomContextReady, pluginOverlays: _pluginOverlays, pluginRenderedDomContext: _pluginRenderedDomContext, pluginSidebarItems: _pluginSidebarItems, printOptions: _printOptions, renderLogo: _renderLogo, renderTitleBarRight: _renderTitleBarRight, showFileOpen: _showFileOpen, showHelpMenu: _showHelpMenu, showOutlineButton: _showOutlineButton, watermarkPresets: _watermarkPresets, ...t3 } = t0;
-		i18n = t1;
-		locale = t2;
-		props = t3;
+		const { agentPanel: _agentPanel, colorMode: _colorMode, commentsSidebarOpen: _commentsSidebarOpen, disableFindReplaceShortcuts: t1, documentName: _documentName, documentNameEditable: _documentNameEditable, externalContent: _externalContent, externalPlugins: _externalPlugins, i18n: t2, locale: t3, onCommentAdd: _onCommentAdd, onCommentDelete: _onCommentDelete, onCommentReply: _onCommentReply, onCommentResolve: _onCommentResolve, onCommentsSidebarOpenChange: _onCommentsSidebarOpenChange, onDocumentNameChange: _onDocumentNameChange, onOpen: _onOpen, onRenderedDomContextReady: _onRenderedDomContextReady, pluginOverlays: _pluginOverlays, pluginRenderedDomContext: _pluginRenderedDomContext, pluginSidebarItems: _pluginSidebarItems, printOptions: _printOptions, renderLogo: _renderLogo, renderTitleBarRight: _renderTitleBarRight, showFileOpen: _showFileOpen, showHelpMenu: _showHelpMenu, showOutlineButton: _showOutlineButton, watermarkPresets: _watermarkPresets, keyboardShortcuts: t4, ...t5 } = t0;
+		disableFindReplaceShortcuts = t1;
+		i18n = t2;
+		locale = t3;
+		keyboardShortcuts = t4;
+		props = t5;
 		$[0] = t0;
-		$[1] = i18n;
-		$[2] = locale;
-		$[3] = props;
+		$[1] = disableFindReplaceShortcuts;
+		$[2] = i18n;
+		$[3] = keyboardShortcuts;
+		$[4] = locale;
+		$[5] = props;
 	} else {
-		i18n = $[1];
-		locale = $[2];
-		props = $[3];
+		disableFindReplaceShortcuts = $[1];
+		i18n = $[2];
+		keyboardShortcuts = $[3];
+		locale = $[4];
+		props = $[5];
 	}
-	let t1;
-	if ($[4] !== props || $[5] !== ref) {
-		t1 = /* @__PURE__ */ jsx(DocxEditor$1, {
+	const t1 = keyboardShortcuts ?? (disableFindReplaceShortcuts === true ? "none" : "document");
+	let t2;
+	if ($[6] !== props || $[7] !== ref || $[8] !== t1) {
+		t2 = /* @__PURE__ */ jsx(DocxEditor$1, {
 			...props,
+			keyboardShortcuts: t1,
 			ref
 		});
-		$[4] = props;
-		$[5] = ref;
-		$[6] = t1;
-	} else t1 = $[6];
-	let t2;
-	if ($[7] !== i18n || $[8] !== locale || $[9] !== t1) {
-		t2 = /* @__PURE__ */ jsx(LocaleProvider, {
+		$[6] = props;
+		$[7] = ref;
+		$[8] = t1;
+		$[9] = t2;
+	} else t2 = $[9];
+	let t3;
+	if ($[10] !== i18n || $[11] !== locale || $[12] !== t2) {
+		t3 = /* @__PURE__ */ jsx(LocaleProvider, {
 			i18n,
 			locale,
-			children: t1
+			children: t2
 		});
-		$[7] = i18n;
-		$[8] = locale;
-		$[9] = t1;
-		$[10] = t2;
-	} else t2 = $[10];
-	return t2;
+		$[10] = i18n;
+		$[11] = locale;
+		$[12] = t2;
+		$[13] = t3;
+	} else t3 = $[13];
+	return t3;
 });
 DocxEditor.displayName = "EigenpalCompatDocxEditor";
 const resolveLocale = (locale, i18n) => locale ?? i18n?._lang ?? "en";

package/dist/index.d.ts

@@ -1,8 +1,9 @@
-import { _ as FolioUIProvider, a as DocxEditorApplyDocumentOperationsOptions, c as DocxEditorRef, d as ToolbarProps, f as EditorMode, g as FolioUIComponents, h as FolioButtonProps, i as renderAsync, l as HighlightPassageOptions, m as ColorPreset, n as EditorHandle, o as DocxEditorCollaboration, p as FontOption, r as RenderAsyncOptions, s as DocxEditorProps, t as DocxEditorHandle, u as HighlightPassageResult, v as OutlineItem, y as FontDefinition } from "./renderAsync-Dhu0sHJ4.js";
+import { _ as FolioUIProvider, a as DocxEditorApplyDocumentOperationsOptions, c as DocxEditorRef, d as ToolbarProps, f as EditorMode, g as FolioUIComponents, h as FolioButtonProps, i as renderAsync, l as HighlightPassageOptions, m as ColorPreset, n as EditorHandle, o as DocxEditorCollaboration, p as FontOption, r as RenderAsyncOptions, s as DocxEditorProps, t as DocxEditorHandle, u as HighlightPassageResult, v as OutlineItem, y as FontDefinition } from "./renderAsync-CqIfcY3H.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-DZz6gVev.js";
 import React, { CSSProperties, ReactNode, RefObject } from "react";
 import { CreateEmptyDocumentOptions, createEmptyDocument } from "@stll/folio-core/utils/createDocument";
 import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAISignatureParty, WordDiffSegment, applyFolioAIEditOperations, createFolioAIEditSnapshot, diffWordSegments, hashFolioAIBlockText, normalizeFolioAIBlockText } from "@stll/folio-core/ai-edits";
+import { KeyboardShortcutScope, KeyboardShortcutScope as KeyboardShortcutScope$1 } from "@stll/folio-core/managers/editorShortcuts";
 import { DocxCompatibility } from "@stll/folio-core/docx/compatibility";
 import { insertImageFromFile, insertPageBreakInView, insertTableInView, insertTableOfContentsInView } from "@stll/folio-core/prosemirror";
 import { FolioSuggestion, SuggestionAppliedAs, SuggestionKind } from "@stll/folio-core/prosemirror/commands/comments";
@@ -104,8 +105,15 @@ type UseWheelZoomOptions = {
   getCurrentZoom?: () => number;
   /** Callback when zoom changes */
   onZoomChange?: (zoom: number) => void;
-  /** Whether to enable keyboard shortcuts (Ctrl++, Ctrl+-, Ctrl+0) */
-  enableKeyboardShortcuts?: boolean;
+  /**
+   * Which presses the zoom shortcuts (Cmd/Ctrl+0, Cmd/Ctrl++, Cmd/Ctrl+-)
+   * answer (default: `"document"`). `"editor"` answers only a press inside
+   * `shortcutRoots`, so a host that docks the editor beside other panes keeps
+   * its own bindings elsewhere; `"none"` binds no keyboard listener.
+   */
+  keyboardShortcuts?: KeyboardShortcutScope$1;
+  /** Elements a press must land inside under the `"editor"` scope. */
+  shortcutRoots?: readonly RefObject<HTMLElement | null>[];
   /** Whether to prevent default browser zoom behavior */
   preventDefault?: boolean;
 };
@@ -190,4 +198,4 @@ type AutocompleteCaretOverlayProps = {
 };
 declare const AutocompleteCaretOverlay: ({ caret, text, isStreaming }: AutocompleteCaretOverlayProps) => React.JSX.Element | null;
 //#endregion
-export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyResult, AutocompleteCaretOverlay, type AutocompleteCaretOverlayProps, type AutocompleteCaretRect, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type BlockRect, type ColorPreset, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, DocxEditor, type DocxEditorApplyDocumentOperationsOptions, type DocxEditorCollaboration, type DocxEditorHandle, type DocxEditorProps, type DocxEditorRef, type EditorHandle, type EditorMode, type ExtractDocumentStyleSetOptions, FindReplaceDialog, type FindReplaceDialogProps, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAISignatureParty, type FolioBlockId, type FolioButtonProps, type FolioSuggestion, type FolioUIComponents, FolioUIProvider, type FontDefinition, type FontOption, FootnotePropertiesDialog, type FootnotePropertiesDialogProps, FormattingBar, type FormattingBarProps, type HighlightPassageOptions, type HighlightPassageResult, type HyperlinkBookmarkOption, HyperlinkDialog, type HyperlinkDialogData, type HyperlinkDialogProps, type ImageMeta, type ImagePositionData, ImagePositionDialog, type ImagePositionDialogProps, type ImagePropertiesData, ImagePropertiesDialog, type ImagePropertiesDialogProps, type ImageRef, InsertImageDialog, type InsertImageDialogData, type InsertImageDialogProps, InsertSymbolDialog, type InsertSymbolDialogProps, InsertTableDialog, type InsertTableDialogData, type InsertTableDialogProps, type InsertTableStyleOption, type MarkdownOptions, type MarkdownResult, type OutlineItem, PageSetupDialog, type PageSetupDialogProps, PasteSpecialDialog, type PasteSpecialDialogProps, type PasteSpecialMode, type PictureWatermark, type PositionalText, type RenderAsyncOptions, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type ScrollToParaIdOptions, SplitCellDialog, type SplitCellDialogData, type SplitCellDialogProps, type SuggestionAppliedAs, type SuggestionKind, type TableProperties, TablePropertiesDialog, type TablePropertiesDialogProps, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, type TextWatermark, type UseWheelZoomOptions, type UseWheelZoomReturn, type Watermark, WatermarkDialog, type WatermarkDialogProps, type WordDiffSegment, ZOOM_PRESETS, ZoomControl, type ZoomControlProps, type ZoomLevel, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applySuggestions, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildPositionalText, clampZoom, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, finishAutocompleteSuggestion, formatZoom, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getDocumentWatermark, getFolioCaretViewportRect, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, insertImageFromFile, insertPageBreakInView, insertTableInView, insertTableOfContentsInView, inspectDocumentStyles, inspectDocumentStylesFromDocx, isFolioBlockId, isSequentialFolioBlockId, isSuggestionStale, normalizeFolioAIBlockText, parseZoom, renderAsync, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setDocumentWatermark, setFocusedSuggestionMeta, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult, useWheelZoom };
+export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyResult, AutocompleteCaretOverlay, type AutocompleteCaretOverlayProps, type AutocompleteCaretRect, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type BlockRect, type ColorPreset, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, DocxEditor, type DocxEditorApplyDocumentOperationsOptions, type DocxEditorCollaboration, type DocxEditorHandle, type DocxEditorProps, type DocxEditorRef, type EditorHandle, type EditorMode, type ExtractDocumentStyleSetOptions, FindReplaceDialog, type FindReplaceDialogProps, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAISignatureParty, type FolioBlockId, type FolioButtonProps, type FolioSuggestion, type FolioUIComponents, FolioUIProvider, type FontDefinition, type FontOption, FootnotePropertiesDialog, type FootnotePropertiesDialogProps, FormattingBar, type FormattingBarProps, type HighlightPassageOptions, type HighlightPassageResult, type HyperlinkBookmarkOption, HyperlinkDialog, type HyperlinkDialogData, type HyperlinkDialogProps, type ImageMeta, type ImagePositionData, ImagePositionDialog, type ImagePositionDialogProps, type ImagePropertiesData, ImagePropertiesDialog, type ImagePropertiesDialogProps, type ImageRef, InsertImageDialog, type InsertImageDialogData, type InsertImageDialogProps, InsertSymbolDialog, type InsertSymbolDialogProps, InsertTableDialog, type InsertTableDialogData, type InsertTableDialogProps, type InsertTableStyleOption, type KeyboardShortcutScope, type MarkdownOptions, type MarkdownResult, type OutlineItem, PageSetupDialog, type PageSetupDialogProps, PasteSpecialDialog, type PasteSpecialDialogProps, type PasteSpecialMode, type PictureWatermark, type PositionalText, type RenderAsyncOptions, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type ScrollToParaIdOptions, SplitCellDialog, type SplitCellDialogData, type SplitCellDialogProps, type SuggestionAppliedAs, type SuggestionKind, type TableProperties, TablePropertiesDialog, type TablePropertiesDialogProps, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, type TextWatermark, type UseWheelZoomOptions, type UseWheelZoomReturn, type Watermark, WatermarkDialog, type WatermarkDialogProps, type WordDiffSegment, ZOOM_PRESETS, ZoomControl, type ZoomControlProps, type ZoomLevel, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applySuggestions, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildPositionalText, clampZoom, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, finishAutocompleteSuggestion, formatZoom, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getDocumentWatermark, getFolioCaretViewportRect, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, insertImageFromFile, insertPageBreakInView, insertTableInView, insertTableOfContentsInView, inspectDocumentStyles, inspectDocumentStylesFromDocx, isFolioBlockId, isSequentialFolioBlockId, isSuggestionStale, normalizeFolioAIBlockText, parseZoom, renderAsync, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setDocumentWatermark, setFocusedSuggestionMeta, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult, useWheelZoom };

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-D5MafItf.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-BTVnhZop.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-D5MafItf.js → renderAsync-BTVnhZop.js}

@@ -98,7 +98,7 @@ import { createEmptyHeaderFooter, pickActiveHeaderFooterRId, removeHeaderFooter,
 import { editHyperlinkAtCursor, removeHyperlinkAtCursor } from "@stll/folio-core/prosemirror/commands/hyperlink";
 import { sanitizeExternalUrl } from "@stll/folio-core/utils/urlSecurity";
 import { applyImagePosition, applyImageProperties, applyImageTransform, applyImageWrapType, insertImageFromFile } from "@stll/folio-core/prosemirror/commands/image";
-import { classifyEditorKeydown, deleteSelectedTable, isFocusInInputLike, isMacPlatform } from "@stll/folio-core/managers/editorShortcuts";
+import { classifyEditorKeydown, deleteSelectedTable, isFocusInInputLike, isKeydownInShortcutScope, isMacPlatform } from "@stll/folio-core/managers/editorShortcuts";
 import { getScrollTopForZoomAnchor, getViewportCenterZoomAnchorForZoomChange } from "@stll/folio-core/paged-layout/zoomScrollAnchor";
 import { ZOOM_MAX, ZOOM_MIN, ZOOM_STEP } from "@stll/folio-core/utils/zoom";
 import { isValidHexId } from "@stll/folio-core/utils/hexId";
@@ -3129,7 +3129,7 @@ function buildFootnoteRenderItems(pageFootnoteMap, footnoteContentMap, doc) {
 * PagedEditor - Main paginated editing component.
 */
 const PagedEditor = forwardRef(function PagedEditor(props, ref) {
-	const { document, documentIO, documentIdentity, fonts: hostFonts, styles, theme: _theme, sectionProperties, headerContent, footerContent, firstPageHeaderContent, firstPageFooterContent, headerContentRId, footerContentRId, firstPageHeaderContentRId, firstPageFooterContentRId, readOnly = false, pageGap = 24, zoom = 1, 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, commentsSidebarOpen = false, sidebarOverlay, scrollContainerRef: scrollContainerRefProp, onHyperlinkClick, onContextMenu, onAnchorPositionsChange, onTotalPagesChange, anchorPositionMode = "comments-and-revisions", onAnonymizationTermClick, selectedAnonymizationCanonical = null, anonymizationSelectionSeq } = props;
+	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, 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, commentsSidebarOpen = false, sidebarOverlay, scrollContainerRef: scrollContainerRefProp, onHyperlinkClick, onContextMenu, onAnchorPositionsChange, onTotalPagesChange, anchorPositionMode = "comments-and-revisions", onAnonymizationTermClick, selectedAnonymizationCanonical = null, anonymizationSelectionSeq } = props;
 	const getScrollContainer = useCallback(() => {
 		if (scrollContainerRefProp && typeof scrollContainerRefProp === "object") return scrollContainerRefProp.current;
 		return containerRef.current;
@@ -3405,6 +3405,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 			pageGap,
 			showMarginGuides,
 			marginGuideColor,
+			...pageRenderer === void 0 ? {} : { pageRenderer },
 			syncCoordinator,
 			headerContent,
 			footerContent,
@@ -3450,6 +3451,7 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		zoom,
 		showMarginGuides,
 		marginGuideColor,
+		pageRenderer,
 		syncCoordinator,
 		headerContent,
 		footerContent,
@@ -3489,17 +3491,18 @@ const PagedEditor = forwardRef(function PagedEditor(props, ref) {
 		folioEditor,
 		hfEditMode
 	]);
-	const marginGuideSettingsInitializedRef = useRef(false);
+	const paintSettingsInitializedRef = useRef(false);
 	useEffect(() => {
-		if (!marginGuideSettingsInitializedRef.current) {
-			marginGuideSettingsInitializedRef.current = true;
+		if (!paintSettingsInitializedRef.current) {
+			paintSettingsInitializedRef.current = true;
 			return;
 		}
 		folioEditor.relayout();
 	}, [
 		folioEditor,
 		marginGuideColor,
-		showMarginGuides
+		showMarginGuides,
+		pageRenderer
 	]);
 	const layoutSchedulerRef = useRef(null);
 	if (layoutSchedulerRef.current === null) layoutSchedulerRef.current = createLayoutScheduler({
@@ -7568,6 +7571,17 @@ function ContentControlDropdownItem(t0) {
 	return t2;
 }
 //#endregion
+//#region src/components/dialogs/findReplaceSelectionSeed.ts
+/**
+* The search text a find/replace dialog opens with: the current DOM selection,
+* or `""` when it is collapsed or absent. One helper so the keyboard shortcut
+* and `DocxEditorRef.openFind` / `openReplace` cannot seed differently.
+*/
+const readFindSelectionSeed = () => {
+	const selection = window.getSelection();
+	return selection && !selection.isCollapsed ? selection.toString() : "";
+};
+//#endregion
 //#region src/components/dialogs/findReplaceUtils.ts
 const scrollToMatch = (containerElement, match) => {
 	if (!containerElement) return;
@@ -10861,7 +10875,7 @@ function _temp$2() {}
 //#endregion
 //#region src/components/hooks/useKeyboardShortcuts.ts
 /**
-* Document-level keyboard shortcuts:
+* Page-level keyboard shortcuts:
 *  - Cmd/Ctrl+F → open find dialog with selected text
 *  - Cmd/Ctrl+H → open replace dialog
 *  - Cmd/Ctrl+P → trigger the custom print path (intercepts the OS dialog)
@@ -10871,27 +10885,29 @@ function _temp$2() {}
 *    focus is in a non-editor input/textarea/contenteditable to avoid
 *    deleting tables while the user is typing in a sidebar or dialog.
 *
-* Thin React binding: the classification, platform/input predicates, and
+* `scope` decides which presses reach that dispatch: `"document"` every press
+* on the page, `"editor"` only presses inside `roots`, `"none"` no listener at
+* all, leaving the shortcuts to the host.
+*
+* Thin React binding: the classification, scope, platform/input predicates, and
 * whole-table deletion check live in `@stll/folio-core`; this hook owns only
 * the listener lifecycle, ref freshness, and the host-callback dispatch.
 */
-function useKeyboardShortcuts({ pagedEditorRef, findReplace, tableSelection, onDirectPrint }) {
+function useKeyboardShortcuts({ pagedEditorRef, findReplace, tableSelection, onDirectPrint, scope, roots }) {
 	const callbacksRef = useRef({
 		findReplace,
 		tableSelection,
-		onDirectPrint
+		onDirectPrint,
+		roots
 	});
 	callbacksRef.current = {
 		findReplace,
 		tableSelection,
-		onDirectPrint
+		onDirectPrint,
+		roots
 	};
 	useEffect(() => {
-		const openFindFromSelection = () => {
-			const selection = window.getSelection();
-			const selectedText = selection && !selection.isCollapsed ? selection.toString() : "";
-			callbacksRef.current.findReplace.openFind(selectedText);
-		};
+		if (scope === "none") return;
 		const handleDeleteSelectedTable = (e) => {
 			const view = pagedEditorRef.current?.getView();
 			if (view && deleteSelectedTable(view.state, view.dispatch)) {
@@ -10904,6 +10920,10 @@ function useKeyboardShortcuts({ pagedEditorRef, findReplace, tableSelection, onD
 			}
 		};
 		const handleKeyDown = (e_0) => {
+			if (!isKeydownInShortcutScope(e_0, {
+				scope,
+				roots: callbacksRef.current.roots.map((root) => root.current)
+			})) return;
 			const editorDom = pagedEditorRef.current?.getView()?.dom;
 			switch (classifyEditorKeydown(e_0, {
 				isMac: isMacPlatform(),
@@ -10914,7 +10934,7 @@ function useKeyboardShortcuts({ pagedEditorRef, findReplace, tableSelection, onD
 					return;
 				case "openFind":
 					e_0.preventDefault();
-					openFindFromSelection();
+					callbacksRef.current.findReplace.openFind(readFindSelectionSeed());
 					return;
 				case "print":
 					e_0.preventDefault();
@@ -10927,7 +10947,7 @@ function useKeyboardShortcuts({ pagedEditorRef, findReplace, tableSelection, onD
 		return () => {
 			document.removeEventListener("keydown", handleKeyDown);
 		};
-	}, [pagedEditorRef]);
+	}, [pagedEditorRef, scope]);
 }
 //#endregion
 //#region src/components/hooks/useZoomAndPageInfo.ts
@@ -11082,6 +11102,8 @@ function useZoomAndPageInfo({ scrollContainerRef, pagedEditorRef, initialZoom })
 * zoom owner (e.g. DocxEditor's viewport-anchored zoom) and the hook only emits
 * through `onZoomChange`, so the two never diverge.
 */
+/** Stable empty default so an omitted `shortcutRoots` never re-runs the effect. */
+const NO_SHORTCUT_ROOTS = [];
 const DEFAULT_INITIAL_ZOOM = 1;
 const DEFAULT_MIN_ZOOM = ZOOM_MIN;
 const DEFAULT_MAX_ZOOM = ZOOM_MAX;
@@ -11123,7 +11145,7 @@ function roundZoom(zoom) {
 * React hook for Ctrl+scroll zoom functionality
 */
 function useWheelZoom(options = {}) {
-	const { initialZoom = DEFAULT_INITIAL_ZOOM, minZoom = DEFAULT_MIN_ZOOM, maxZoom = DEFAULT_MAX_ZOOM, zoomStep = DEFAULT_ZOOM_STEP, enabled = true, containerRef, getCurrentZoom, onZoomChange, enableKeyboardShortcuts = true, preventDefault = true } = options;
+	const { initialZoom = DEFAULT_INITIAL_ZOOM, minZoom = DEFAULT_MIN_ZOOM, maxZoom = DEFAULT_MAX_ZOOM, zoomStep = DEFAULT_ZOOM_STEP, enabled = true, containerRef, getCurrentZoom, onZoomChange, keyboardShortcuts = "document", shortcutRoots = NO_SHORTCUT_ROOTS, preventDefault = true } = options;
 	const [zoom, setZoomState] = useState(initialZoom);
 	const zoomRef = useRef(zoom);
 	useEffect(() => {
@@ -11212,7 +11234,11 @@ function useWheelZoom(options = {}) {
 	* Handle keyboard shortcuts
 	*/
 	const handleKeyDown = useCallback((event_0) => {
-		if (!enabled || !enableKeyboardShortcuts) return;
+		const inScope = isKeydownInShortcutScope(event_0, {
+			scope: keyboardShortcuts,
+			roots: shortcutRoots.map((root) => root.current)
+		});
+		if (!enabled || !inScope) return;
 		if (!(event_0.ctrlKey || event_0.metaKey)) return;
 		if (event_0.key === "0") {
 			event_0.preventDefault();
@@ -11231,7 +11257,8 @@ function useWheelZoom(options = {}) {
 		}
 	}, [
 		enabled,
-		enableKeyboardShortcuts,
+		keyboardShortcuts,
+		shortcutRoots,
 		zoomIn,
 		zoomOut,
 		zoomTo100
@@ -11249,14 +11276,14 @@ function useWheelZoom(options = {}) {
 		handleWheel
 	]);
 	useEffect(() => {
-		if (!enabled || !enableKeyboardShortcuts) return;
+		if (!enabled || keyboardShortcuts === "none") return;
 		document.addEventListener("keydown", handleKeyDown);
 		return () => {
 			document.removeEventListener("keydown", handleKeyDown);
 		};
 	}, [
 		enabled,
-		enableKeyboardShortcuts,
+		keyboardShortcuts,
 		handleKeyDown
 	]);
 	const currentZoom = getCurrentZoom ? getCurrentZoom() : zoom;
@@ -12652,7 +12679,7 @@ function useFolioComments({ doc, autoOpenReviewSidebar, anchorPositions, editorC
 * - Error boundary
 * - Loading states
 */
-const CommentsSidebar = lazy(() => import("./CommentsSidebar-DsY20BSs.js").then((m) => ({ default: m.CommentsSidebar })));
+const CommentsSidebar = lazy(() => import("./CommentsSidebar-DtoKrEhl.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");
@@ -12714,7 +12741,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, showMarginGuides = false, marginGuideColor, showRuler: showRulerProp = false, rulerUnit = "inch", initialZoom = 1, enableWheelZoom = true, 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, 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", 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, featureFlags, onSelectiveSaveTripwire }, ref) {
 	const t = useTranslations("folio");
 	useEffect(() => {
 		const onClipboardReadError = () => {
@@ -12906,6 +12933,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 	const pagedEditorRef = useRef(null);
 	const hfEditorRef = useRef(null);
 	const containerRef = useRef(null);
+	const shortcutRoots = useMemo(() => [containerRef], []);
 	const lastSelectionRef = useRef(null);
 	const imageInputRef = useRef(null);
 	const editorContentRef = useRef(null);
@@ -12958,7 +12986,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		enabled: enableWheelZoom,
 		getCurrentZoom: () => zoomRef.current,
 		onZoomChange: setZoomWithViewportAnchor,
-		enableKeyboardShortcuts: false
+		keyboardShortcuts: "none"
 	});
 	const [bodyHistoryAvailability, setBodyHistoryAvailability] = useState({
 		canRedo: false,
@@ -13464,7 +13492,9 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		pagedEditorRef,
 		findReplace,
 		tableSelection,
-		onDirectPrint: handleDirectPrint
+		onDirectPrint: handleDirectPrint,
+		scope: keyboardShortcuts,
+		roots: shortcutRoots
 	});
 	const handleApplyFootnoteProperties = useCallback((footnotePr, endnotePr) => {
 		if (!history.state?.package) return;
@@ -14249,6 +14279,12 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		scrollToParaId: (paraId, options_1) => pagedEditorRef.current?.scrollToParaId(paraId, options_1) ?? false,
 		openPrintPreview: handleDirectPrint,
 		print: handleDirectPrint,
+		openFind: () => {
+			findReplace.openFind(readFindSelectionSeed());
+		},
+		openReplace: () => {
+			findReplace.openReplace(readFindSelectionSeed());
+		},
 		loadDocument: (document_0) => {
 			const editor_2 = pagedEditorRef.current?.getEditor();
 			if (editor_2) {
@@ -14629,6 +14665,8 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 		setZoomWithViewportAnchor,
 		zoomRef,
 		handleDirectPrint,
+		findReplace.openFind,
+		findReplace.openReplace,
 		loadParsedDocument,
 		loadBuffer,
 		updateComments,
@@ -15380,6 +15418,7 @@ const DocxEditor = forwardRef(function DocxEditor({ documentBuffer, password, do
 													onBodyClick: handleBodyClick,
 													onActiveNoteStoryChange: handleActiveNoteStoryChange,
 													zoom,
+													...pageRenderer === void 0 ? {} : { pageRenderer },
 													showMarginGuides,
 													...marginGuideColor !== void 0 ? { marginGuideColor } : {},
 													readOnly,

package/dist/{renderAsync-Dhu0sHJ4.d.ts → renderAsync-CqIfcY3H.d.ts}

@@ -5,6 +5,8 @@ import { XmlFragment } from "yjs";
 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 { PageRendererName } from "@stll/folio-core/display-list/editor/pageRenderer";
+import { KeyboardShortcutScope } from "@stll/folio-core/managers/editorShortcuts";
 import { FolioEditor } from "@stll/folio-core/controller/folioEditor";
 import { DocxCompatibility } from "@stll/folio-core/docx/compatibility";
 import { FolioSelectiveSaveFlags } from "@stll/folio-core/docx/selectiveSaveFlags";
@@ -684,6 +686,17 @@ type DocxEditorProps = {
    * header/footer.
    */
   showHeaderFooterEditing?: boolean;
+  /**
+   * Which renderer paints the pages (default: `"legacy"`).
+   *
+   * `"display-list"` builds folio's painter-neutral paint IR from the layout
+   * and paints the pages from it, so the editor and a document export draw
+   * from one structure rather than from two painters that have to agree. It
+   * places every code point at the advance the layout engine measured, which
+   * costs substantially more DOM per page; measure before turning it on for a
+   * long document.
+   */
+  pageRenderer?: PageRendererName;
   /** Whether to show page margin guides/boundaries (default: false) */
   showMarginGuides?: boolean;
   /** Color for margin guides (default: '#c0c0c0') */
@@ -704,6 +717,22 @@ type DocxEditorProps = {
   initialZoom?: number | "fit-width";
   /** Whether Ctrl/Cmd+wheel and trackpad-pinch zoom are enabled (default: true) */
   enableWheelZoom?: boolean;
+  /**
+   * Which key presses the editor's page-level shortcuts answer: find and
+   * replace (Cmd/Ctrl+F, Cmd/Ctrl+H), print (Cmd/Ctrl+P) and deleting the
+   * selected table (Delete/Backspace). Editing keymaps inside the document
+   * body are unaffected, and so are the zoom keys, which the editor leaves to
+   * the browser (`useWheelZoom` takes the same scope for a host that binds
+   * them itself).
+   *  - `"document"`: every press on the page. Default; for a page whose only
+   *    surface is the editor.
+   *  - `"editor"`: only a press whose target is inside this editor (its root
+   *    element, which contains the find/replace dialog), so a host that docks
+   *    the editor beside other panes keeps its own bindings elsewhere.
+   *  - `"none"`: no page-level listener. The host dispatches shortcuts itself
+   *    and opens the dialog through `DocxEditorRef.openFind` / `openReplace`.
+   */
+  keyboardShortcuts?: KeyboardShortcutScope;
   /** Whether the editor is read-only. When true, hides toolbar and rulers */
   readOnly?: boolean;
   /** Whether comments/tracked changes should auto-open the review sidebar (default: true) */
@@ -925,6 +954,10 @@ type DocxEditorRef = {
   openPrintPreview: () => void;
   /** Print the document directly */
   print: () => void;
+  /** Open the find dialog, seeded with the current text selection when there is one. */
+  openFind: () => void;
+  /** Open the replace dialog, seeded with the current text selection when there is one. */
+  openReplace: () => void;
   /** Load a pre-parsed document programmatically */
   loadDocument: (doc: Document) => void;
   /** Load a DOCX buffer programmatically (ArrayBuffer, Uint8Array, Blob, or File) */

package/package.json

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