@docx-editor.dev/react 2.30.0 → 2.32.0

package/dist/index.d.ts

@@ -9,11 +9,11 @@
  * @public
  */
 import * as react from 'react';
-import react__default, { ReactNode, CSSProperties, ReactElement, ComponentType, ForwardRefExoticComponent, RefAttributes, HTMLAttributes, Ref } from 'react';
-import { RevisionMarkupDialogSession, ResolvedRevisionMarkup, RevisionMarkupOptions, ChromeExportFormat, InvalidTextFormFieldSession, ContentControlWidgetSession, CalendarMonth, ContentControlListNavigation, CalendarDay, TextFormFieldDialogSession, RevisionAuthorStyle, ParagraphDialogFields, ParagraphDialogMixed, ChromeMenuId, ChromeSlotId, ChromeMenuEntry, DocxEditorInstance, FontConfigurationFragment, FontResolver, FontShapingOptions, EditorModule, ReviewDisplayMode, FieldResultsMode, ContentLockPolicy, LockedControlNavigation, ImageDecodePort, ChromeGroupId, SupportedImageMime, TableChromeSlotId, ChromeExportHandlers, DocumentSearchHighlight, DocumentSearchFindOptions, SurfaceHyperlink, FontOrigin, MarkedFontResolver, ReviewAuthorInfo, EditorCommandExecute, ToolbarValueMap, HighlightSource, ParagraphFormatRead, ParagraphFormatUpdate, TextMeasurer, PaginatedSurfaceState, NavigationCommand, SurfaceFormatting, SectionProperties, RulerIndent, HistoryGroupBindingOptions } from '@docx-editor.dev/core/editor';
-export { CHROME_GROUPS, CHROME_MENUS, ChromeExportFormat, ChromeExportHandlers, ChromeMenu, ChromeMenuEntry, ChromeMenuId, ChromeMenuItemEntry, ChromeMenuSeparatorEntry, ChromeMenuSubmenuEntry, ChromeSlotId, ClearRefreshHighlightsOptions, DEFAULT_FONT, DocumentRefresh, DocumentRefreshError, DocumentRefreshState, DocumentSearchFindOptions, DocumentSearchHighlight, DocumentSearchNavigateOptions, DocumentSearchOptions, FontConfigurationBase, FontConfigurationFragment, FontLoadFailure, FontLoadFailureReason, FontOrigin, FontResolutionRequest, FontResolver, FontResolverMark, FontUrlSource, HIGHLIGHT_REFRESH_MS, HighlightSource, ImageWrapTarget, LOADING_SNAPSHOT, LoadFontsRequest, LoadFontsResult, MAX_RESOLVER_FAMILIES, MarkedFontResolver, NavigateToChangeOptions, PX_PER_CM, PX_PER_INCH, ParagraphFlagState, ParagraphFormatRead, ParagraphFormatUpdate, ParagraphTabStop, RefreshChange, RefreshChangeInput, RefreshFailureCode, RefreshHighlightAnimation, RefreshHighlightOptions, RefreshLocation, RefreshResult, RefreshSubmission, RefreshUpdate, ResolvedRevisionMarkup, ReviewAuthorInfo, ReviewDisplayMode, RevisionAuthorAssignments, RevisionAuthorStyle, RevisionChangedLinesMark, RevisionDeletionMark, RevisionMarkupChromeHandlers, RevisionMarkupColor, RevisionMarkupDialogSession, RevisionMarkupMark, RevisionMarkupNamedColor, RevisionMarkupOptions, RevisionStyles, RulerTick, RulerUnit, SEARCH_DEBOUNCE_MS, SEARCH_HIGHLIGHT_PRIORITY, SEARCH_HIGHLIGHT_SET, SEARCH_MATCH_LIMIT, ToolbarCommandState, WORD_DEFAULT_FONT, chromeMenuSlots, commandForSlot, composeFontConfiguration, composeFontOrigins, createDocumentRefresh, createFontSource, defineFontResolver, generateRulerTicks, isFontResolver, loadFonts, rulerPageBox, runToolbarCommand, toolbarCommandState } from '@docx-editor.dev/core/editor';
-import { Editor, ViewScope, EditorCommand, DocumentSource, FontConfiguration, ZoomMode, DocumentChange, EditorFontError, TextMatch, DocumentHandle, EditorExecOptions, ExecResult, EditorScope, EditorSnapshot, EditorEvents, HighlightOptions, HighlightResult, HighlightRange, HighlightHit, PageSetup, IndentFormatting, ColorValue, Theme } from '@docx-editor.dev/core/contracts/editor';
-export { AnchorHighlightAnimation, AnchorHighlightOptions, ClearAnchorHighlightOptions, Editor, EditorCommand, EditorFontError, EditorFontErrorCode, EditorQuery, EditorScope, EditorSnapshot, FontConfiguration, FontFaceRequest, FontSource, FontSourceSubstitution, HighlightHit, HighlightOptions, HighlightRange, HighlightRect, HighlightResult, PageSetup, ScrollToAnchorOptions, TextMatch } from '@docx-editor.dev/core/contracts/editor';
+import react__default, { ReactNode, CSSProperties, ReactElement, ComponentType, ButtonHTMLAttributes, ForwardRefExoticComponent, RefAttributes, HTMLAttributes, Ref } from 'react';
+import { UnsupportedElementRule, UnsupportedElement, RevisionMarkupDialogSession, ResolvedRevisionMarkup, RevisionMarkupOptions, ChromeExportFormat, InvalidTextFormFieldSession, ContentControlWidgetSession, CalendarMonth, ContentControlListNavigation, CalendarDay, TextFormFieldDialogSession, RevisionAuthorStyle, ParagraphDialogFields, ParagraphDialogMixed, BookmarkSortOrder, SplitCellLimits, ChromeMenuId, ChromeSlotId, ChromeMenuEntry, DocxEditorInstance, FontConfigurationFragment, FontResolver, FontShapingOptions, EditorModule, ReviewDisplayMode, FieldResultsMode, ContentLockPolicy, LockedControlNavigation, ImageDecodePort, ChromeGroupId, SupportedImageMime, TableChromeSlotId, ChromeExportHandlers, DocumentSearchHighlight, DocumentSearchFindOptions, SurfaceHyperlink, FontOrigin, MarkedFontResolver, ReviewAuthorInfo, EditorCommandExecute, ToolbarValueMap, HighlightSource, ParagraphFormatRead, ParagraphFormatUpdate, TextMeasurer, PaginatedSurfaceState, NavigationCommand, SurfaceFormatting, SectionProperties, RulerIndent, HistoryGroupBindingOptions } from '@docx-editor.dev/core/editor';
+export { CHROME_GROUPS, CHROME_MENUS, ChromeExportFormat, ChromeExportHandlers, ChromeMenu, ChromeMenuEntry, ChromeMenuId, ChromeMenuItemEntry, ChromeMenuSeparatorEntry, ChromeMenuSubmenuEntry, ChromeSlotId, ClearRefreshHighlightsOptions, DEFAULT_FONT, DocumentRefresh, DocumentRefreshError, DocumentRefreshState, DocumentSearchFindOptions, DocumentSearchHighlight, DocumentSearchNavigateOptions, DocumentSearchOptions, FontConfigurationBase, FontConfigurationFragment, FontLoadFailure, FontLoadFailureReason, FontOrigin, FontResolutionRequest, FontResolver, FontResolverMark, FontUrlSource, HIGHLIGHT_REFRESH_MS, HighlightSource, ImageWrapTarget, LOADING_SNAPSHOT, LoadFontsRequest, LoadFontsResult, MAX_RESOLVER_FAMILIES, MarkedFontResolver, NavigateToChangeOptions, PX_PER_CM, PX_PER_INCH, ParagraphFlagState, ParagraphFormatRead, ParagraphFormatUpdate, ParagraphTabStop, RefreshChange, RefreshChangeInput, RefreshFailureCode, RefreshHighlightAnimation, RefreshHighlightOptions, RefreshLocation, RefreshResult, RefreshSubmission, RefreshUpdate, ResolvedRevisionMarkup, ReviewAuthorInfo, ReviewDisplayMode, RevisionAuthorAssignments, RevisionAuthorStyle, RevisionChangedLinesMark, RevisionDeletionMark, RevisionMarkupChromeHandlers, RevisionMarkupColor, RevisionMarkupDialogSession, RevisionMarkupMark, RevisionMarkupNamedColor, RevisionMarkupOptions, RevisionStyles, RulerTick, RulerUnit, SEARCH_DEBOUNCE_MS, SEARCH_HIGHLIGHT_PRIORITY, SEARCH_HIGHLIGHT_SET, SEARCH_MATCH_LIMIT, ToolbarCommandState, UnsupportedElement, UnsupportedElementLayout, UnsupportedElementRule, WORD_DEFAULT_FONT, chromeMenuSlots, commandForSlot, composeFontConfiguration, composeFontOrigins, createDocumentRefresh, createFontSource, defineFontResolver, generateRulerTicks, isFontResolver, loadFonts, rulerPageBox, runToolbarCommand, toolbarCommandState } from '@docx-editor.dev/core/editor';
+import { Editor, ViewScope, EditorCommand, WatermarkState, BookmarkSummary, DocumentSource, FontConfiguration, ZoomMode, DocumentChange, EditorFontError, TextMatch, ExecResult, DocumentOpenFailure, DocumentHandle, EditorExecOptions, EditorScope, EditorSnapshot, Watermark, EditorEvents, HighlightOptions, HighlightResult, HighlightRange, HighlightHit, PageSetup, IndentFormatting, ColorValue, Theme } from '@docx-editor.dev/core/contracts/editor';
+export { AnchorHighlightAnimation, AnchorHighlightOptions, ClearAnchorHighlightOptions, DocumentOpenFailure, DocumentOpenFailureReason, Editor, EditorCommand, EditorFontError, EditorFontErrorCode, EditorQuery, EditorScope, EditorSnapshot, FontConfiguration, FontFaceRequest, FontSource, FontSourceSubstitution, HighlightHit, HighlightOptions, HighlightRange, HighlightRect, HighlightResult, PageSetup, ScrollToAnchorOptions, TextMatch, Watermark, WatermarkState } from '@docx-editor.dev/core/contracts/editor';
 import { TFunction, Translations, LocaleStrings } from '@docx-editor.dev/i18n';
 export { TranslationKey } from '@docx-editor.dev/i18n';
 import { ContentControlType, ContentControlSummary } from '@docx-editor.dev/core';
@@ -35,6 +35,27 @@ type MaybeRefOrGetter<T> = T;
  */
 type DocxEditorChildren = ReactNode;
 
+/** Props for a registered unsupported-content renderer. @public */
+interface DocxEditorUnsupportedElementProps extends UnsupportedElementRule {
+    /**
+     * Render this occurrence. Return `null`, `false`, an empty fragment or array, or whitespace to
+     * keep the default placeholder.
+     */
+    children: (props: {
+        element: UnsupportedElement;
+    }) => ReactNode;
+}
+/**
+ * Register a renderer under DocxEditor or DocxEditor.Root.
+ * The first mounted matching declaration wins. Prop updates retain its priority.
+ * Omit match for a catch-all. Returning `null`, `false`, an empty fragment or array, or
+ * whitespace keeps the default placeholder.
+ * Layout uses points and only sizes content without an existing layout box.
+ * Components can remount when pagination or virtualization removes an occurrence.
+ * @public
+ */
+declare function DocxEditorUnsupportedElement({ match, layout, children, }: DocxEditorUnsupportedElementProps): react.JSX.Element[];
+
 /**
  * Presentation overrides for a dialog part. @public
  *
@@ -547,8 +568,9 @@ interface DocxEditorContentProps {
 }
 /**
  * The element the engine paints pages into. Must render inside a
- * `DocxEditor.Viewport`; the facade attaches here and detaches on unmount (stashing
- * the live document bytes, so remounting elsewhere restores the content).
+ * `DocxEditor.Viewport`; the facade attaches here and detaches on unmount. Detaching parks
+ * the editor, so mounting the content elsewhere, even in another window, moves it with its
+ * undo history, selection and reading position.
  *
  * Its centring margin lives in the STYLESHEET, not in an inline style here, and behind
  * `:where()` so it carries no specificity: a host that places the page itself — inside its
@@ -560,6 +582,58 @@ interface DocxEditorContentProps {
  */
 declare function DocxEditorContent({ className }: DocxEditorContentProps): react.JSX.Element;
 
+/** Props for `DocxEditor.Window`. @public */
+interface DocxEditorWindowProps {
+    /** Render `children` in a pop-out window. While `false`, they render in place. */
+    open: boolean;
+    /** A same-origin page to open. Defaults to `about:blank`. */
+    url?: string;
+    /**
+     * The window name. Defaults to `docx-editor`. Two `DocxEditor.Window` components with the
+     * same name share one browser window, so give each editor its own name.
+     */
+    name?: string;
+    /** The `window.open` features. Defaults to `popup,width=1000,height=900`. */
+    features?: string;
+    /** The pop-out's title. */
+    title?: string;
+    /** Copy this page's stylesheets into the window, and keep copying new ones. Default `true`. */
+    styles?: boolean | ((from: Document, to: Document) => () => void);
+    /**
+     * The pop-out went away: the user closed it, or the browser blocked it. Set `open` to
+     * `false` here. The panel is already back in place when this runs.
+     */
+    onClose?: () => void;
+    /** The editor panel: toolbar, viewport and content, or any part of them. */
+    children?: DocxEditorChildren;
+}
+/**
+ * Render the editor panel in its own browser window while `open` is `true`.
+ *
+ * Place it inside `DocxEditor.Root` around the parts to pop out. The Root stays in this
+ * window, so the editor moves into the pop-out and back with its undo history, selection and
+ * collaboration session. The window gets this page's stylesheets, and closing it brings the
+ * panel back and calls `onClose`.
+ *
+ * @example
+ * ```tsx
+ * const [popped, setPopped] = useState(false);
+ *
+ * <DocxEditor.Root document={bytes}>
+ *   <button onClick={() => setPopped(!popped)}>Pop out</button>
+ *   <DocxEditor.Window open={popped} onClose={() => setPopped(false)}>
+ *     <DocxEditor.Toolbar />
+ *     <DocxEditor.Viewport>
+ *       <DocxEditor.Content />
+ *     </DocxEditor.Viewport>
+ *   </DocxEditor.Window>
+ * </DocxEditor.Root>
+ * ```
+ *
+ * @public
+ */
+declare function DocxEditorWindow({ open, onClose, children, url, name, features, title, styles, }: DocxEditorWindowProps): react.JSX.Element;
+
 /** Props for `DocxEditor.Loading`. @public */
 interface DocxEditorLoadingProps {
     /**
@@ -586,8 +660,8 @@ interface DocxEditorLoadingProps {
     style?: CSSProperties;
     /**
      * Your own loading indicator, in place of the packaged spinner. The packaged screen keeps
-     * its page and centers this on it. With `overlay`, it then moves onto the document's first
-     * page while a large document lays out its remaining pages, and scrolls with it.
+     * its page and centers this on it. With `overlay`, it then moves below the laid-out pages
+     * while a large document lays out its remaining pages, and scrolls with them.
      *
      * Include text for screen readers, as the packaged indicator does.
      *
@@ -599,8 +673,8 @@ interface DocxEditorLoadingProps {
     /**
      * The whole first loading screen, in place of the packaged page. Compose your own around
      * `DocxEditor.Loading.Spinner` to keep the packaged indicator beside your own copy. To
-     * change only the indicator, and keep it on the first page as the document opens, use
-     * `indicator`.
+     * change only the indicator, and keep it below the laid-out pages as the document opens,
+     * use `indicator`.
      */
     children?: DocxEditorChildren;
 }
@@ -650,7 +724,7 @@ interface DocxEditorLoadingComponent {
  * LARGE document opens — the engine mounts it behind one painted frame precisely so this
  * screen can paint before the blocking parse and layout — it holds until the pages land;
  * pass `overlay` to pin it over the previous document for that window. With `overlay`, once
- * the first pages show, the indicator moves onto the first page until the rest are laid out.
+ * the first pages show, the indicator moves below the laid-out pages until the rest are laid out.
  * Pass `indicator` to replace only the spinner, in both places:
  *
  * ```tsx
@@ -730,6 +804,24 @@ interface DocxEditorAuthorStyleProps extends RevisionAuthorStyle {
  */
 declare function DocxEditorAuthorStyle(props: DocxEditorAuthorStyleProps): null;
 
+/**
+ * Why a picture could not be inserted. Replace it through `popups.imageInsertError`, or pass
+ * `false` there to show nothing.
+ * @public
+ */
+interface DocxEditorImageInsertErrorDialogProps {
+    /** The translated reason the picture was refused. */
+    message: string;
+    /** Close the dialog. */
+    onClose(): void;
+    className?: string;
+    style?: CSSProperties;
+    /** Replaces the packaged header, message and button. */
+    children?: DocxEditorChildren;
+}
+/** The packaged picture refusal: an editor dialog, never a page-blocking browser alert. @public */
+declare function DocxEditorImageInsertErrorDialog({ message, onClose, className, style, children, }: DocxEditorImageInsertErrorDialogProps): react.JSX.Element;
+
 /** A render callback for an automatic popup. `false` disables automatic rendering. @public */
 type DocxEditorPopup<Props extends object> = false | ((props: Props) => DocxEditorChildren | null);
 /**
@@ -767,7 +859,15 @@ interface PageSetupDialogFields {
 /** Page Setup draft and actions. @public */
 interface UsePageSetupDialogReturn extends UseDialogReturn<PageSetupDialogFields> {
 }
-/** Read the enclosing Page Setup dialog draft. @public */
+/**
+ * Read the enclosing Page Setup dialog draft.
+ *
+ * Call it in a child of the dialog. It does not open the dialog. To open the dialog from your
+ * own toolbar, keep its `open` state and render `DocxEditor.PageSetupDialog` with `open` and
+ * `onClose`. Take the button's enabled state from `usePageSetup().isEnabled`.
+ *
+ * @public
+ */
 declare function usePageSetupDialog(): UsePageSetupDialogReturn;
 /** Page Setup with replaceable controls and layout. @public */
 declare const DocxEditorPageSetupDialog: typeof PageSetupDialogRoot & {
@@ -815,7 +915,15 @@ declare function ParagraphDialogRoot({ open, onClose, className, style, children
 interface UseParagraphDialogReturn extends UseDialogReturn<ParagraphDialogFields> {
     readonly mixed: ParagraphDialogMixed;
 }
-/** Read the enclosing Paragraph Options draft. @public */
+/**
+ * Read the enclosing Paragraph Options draft.
+ *
+ * Call it in a child of the dialog. It does not open the dialog. To open the dialog from your
+ * own toolbar, keep its `open` state and render `DocxEditor.ParagraphDialog` with `open` and
+ * `onClose`. Take the button's enabled state from `useParagraphFormat().isEnabled`.
+ *
+ * @public
+ */
 declare function useParagraphDialog(): UseParagraphDialogReturn;
 /** Paragraph Options with replaceable controls and layout. @public */
 declare const DocxEditorParagraphDialog: typeof ParagraphDialogRoot & {
@@ -845,6 +953,210 @@ declare const DocxEditorParagraphDialog: typeof ParagraphDialogRoot & {
     }) => react.ReactNode;
 };
 
+/** How a text watermark crosses the page. @public */
+type WatermarkDialogLayout = NonNullable<WatermarkState['layout']>;
+/** Which watermark the dialog writes. @public */
+type WatermarkDialogKind = 'none' | 'picture' | 'text';
+/** The Watermark dialog draft. Transparency is 0 to 1, color is `RRGGBB`. @public */
+interface WatermarkDialogFields {
+    kind: WatermarkDialogKind;
+    /** The picture bytes, or null when no picture is chosen. */
+    imageData: Uint8Array | null;
+    /** The chosen file name. Null for no picture or for the document's current picture. */
+    imageName: string | null;
+    /** A factor of the picture's natural size. Null is Auto. */
+    scale: number | null;
+    washout: boolean;
+    text: string;
+    fontFamily: string;
+    /** Points. Null is Auto. */
+    fontSizePt: number | null;
+    bold: boolean;
+    italic: boolean;
+    transparency: number;
+    color: string;
+    layout: WatermarkDialogLayout;
+}
+/** The text choices the dialog offers when the host passes no `presets`. @public */
+declare const DEFAULT_WATERMARK_PRESETS: readonly string[];
+
+/** Props for `DocxEditor.WatermarkDialog`. @public */
+interface DocxEditorWatermarkDialogProps extends DialogCustomizationProps {
+    /** Whether the dialog is shown. The host owns this state. */
+    open: boolean;
+    /** Called on Cancel, Escape, overlay click, and after a successful Apply. */
+    onClose: () => void;
+    /** The text choices offered for a text watermark. Defaults to `DEFAULT_WATERMARK_PRESETS`. */
+    presets?: readonly string[];
+}
+/** Named controls a host can replace with `DocxEditor.WatermarkDialog.Field`. @public */
+type WatermarkDialogFieldName = 'noWatermark' | 'pictureWatermark' | 'picture' | 'scale' | 'washout' | 'textWatermark' | 'preset' | 'text' | 'fontFamily' | 'fontSizePt' | 'bold' | 'italic' | 'transparency' | 'color' | 'layout';
+/** Watermark dialog draft and actions. @public */
+interface UseWatermarkDialogReturn extends UseDialogReturn<WatermarkDialogFields> {
+}
+/** Read the enclosing Watermark dialog draft. @public */
+declare function useWatermarkDialog(): UseWatermarkDialogReturn;
+declare function WatermarkDialogRoot({ open, onClose, presets, className, style, children, preset, }: DocxEditorWatermarkDialogProps): ReactElement | null;
+/**
+ * Watermark dialog: no watermark, a picture, or text, with a live page preview and
+ * replaceable controls and layout. Applies the whole form as one undoable `setWatermark`
+ * command, and writes nothing when the form is unchanged.
+ *
+ * @public
+ */
+declare const DocxEditorWatermarkDialog: typeof WatermarkDialogRoot & {
+    Header: (props: DialogPartProps & {
+        name?: WatermarkDialogFieldName | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Title: (props: DialogPartProps & {
+        name?: WatermarkDialogFieldName | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Body: (props: DialogPartProps & {
+        name?: WatermarkDialogFieldName | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    /** The page preview of the current draft. Decorative (`aria-hidden`). */
+    Preview: (props: DialogPartProps) => ReactNode;
+    Footer: (props: DialogPartProps & {
+        name?: WatermarkDialogFieldName | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Apply: (props: DialogPartProps & {
+        name?: WatermarkDialogFieldName | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Cancel: (props: DialogPartProps & {
+        name?: WatermarkDialogFieldName | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Error: (props: DialogPartProps & {
+        name?: WatermarkDialogFieldName | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Field: (props: DialogPartProps & {
+        name: WatermarkDialogFieldName;
+    }) => ReactNode;
+};
+
+/** Props for `DocxEditor.BookmarkDialog`. @public */
+interface DocxEditorBookmarkDialogProps extends DialogCustomizationProps {
+    /** Whether the dialog is shown. The host owns this state. */
+    open: boolean;
+    /** Called on Cancel, Escape, overlay click, and after a successful Add. */
+    onClose: () => void;
+}
+/** The Bookmark dialog's draft. @public */
+interface BookmarkDialogFields {
+    /** The name typed or picked from the list. */
+    name: string;
+    sortBy: BookmarkSortOrder;
+    /** Whether hidden bookmarks (names starting with an underscore) are listed. */
+    showHidden: boolean;
+}
+/** Bookmark dialog draft and actions. `apply` is Add. @public */
+interface UseBookmarkDialogReturn extends UseDialogReturn<BookmarkDialogFields> {
+    /** The bookmarks the list shows, in the chosen order. */
+    readonly rows: readonly BookmarkSummary[];
+    /** Whether Delete and Go To can act on the typed name. */
+    readonly canDelete: boolean;
+    readonly canGoTo: boolean;
+    /**
+     * How many other places carry the typed bookmark's name, which collaborators adding one name
+     * offline can leave. 0 for a name with one bookmark, or no bookmark.
+     */
+    readonly duplicates: number;
+    remove(): void;
+    goTo(): void;
+    /** Keep the first bookmark with the typed name and remove its copies. */
+    keepFirst(): void;
+}
+/**
+ * The dialog is mounted only while it is open, so a closed dialog reads no bookmarks on each
+ * editor update. Each opening starts a fresh draft.
+ */
+declare function BookmarkDialogRoot(props: DocxEditorBookmarkDialogProps): ReactElement | null;
+/** Read the enclosing Bookmark dialog draft. @public */
+declare function useBookmarkDialog(): UseBookmarkDialogReturn;
+type PartComponent = (props: DialogPartProps) => ReactNode;
+/** The Bookmark dialog with replaceable controls and layout. @public */
+declare const DocxEditorBookmarkDialog: typeof BookmarkDialogRoot & {
+    Header: (props: DialogPartProps & {
+        name?: "list" | "name" | "showHidden" | "sortBy" | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Title: (props: DialogPartProps & {
+        name?: "list" | "name" | "showHidden" | "sortBy" | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Body: (props: DialogPartProps & {
+        name?: "list" | "name" | "showHidden" | "sortBy" | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Footer: (props: DialogPartProps & {
+        name?: "list" | "name" | "showHidden" | "sortBy" | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    /** Add: bookmark the selection under the typed name. */
+    Apply: (props: DialogPartProps & {
+        name?: "list" | "name" | "showHidden" | "sortBy" | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Cancel: (props: DialogPartProps & {
+        name?: "list" | "name" | "showHidden" | "sortBy" | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Error: (props: DialogPartProps & {
+        name?: "list" | "name" | "showHidden" | "sortBy" | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Field: (props: DialogPartProps & {
+        name: "list" | "name" | "showHidden" | "sortBy";
+    }) => ReactNode;
+    Delete: PartComponent;
+    GoTo: PartComponent;
+    /** Shown while the typed name has copies: keep the first, remove the rest. */
+    KeepFirst: PartComponent;
+};
+
+/** Props for `DocxEditor.SplitCellDialog`. @public */
+interface DocxEditorSplitCellDialogProps extends DialogCustomizationProps {
+    /** Whether the dialog is shown. The host owns this state. */
+    open: boolean;
+    /** Called on Cancel, Escape, overlay click, and after a successful Split. */
+    onClose: () => void;
+}
+/** The Split cells dialog's draft, as typed. @public */
+interface SplitCellDialogFields {
+    /** The number of columns, as typed. */
+    columns: string;
+    /** The number of rows, as typed. */
+    rows: string;
+}
+/** Split cells dialog draft and actions. `apply` is Split. @public */
+interface UseSplitCellDialogReturn extends UseDialogReturn<SplitCellDialogFields> {
+    /** The most columns and rows the cell splits into, or null outside a cell that splits. */
+    readonly limits: SplitCellLimits | null;
+}
+declare function SplitCellDialogRoot(props: DocxEditorSplitCellDialogProps): ReactElement | null;
+/** Read the enclosing Split cells dialog draft. @public */
+declare function useSplitCellDialog(): UseSplitCellDialogReturn;
+/** The Split cells dialog with replaceable controls and layout. @public */
+declare const DocxEditorSplitCellDialog: typeof SplitCellDialogRoot & {
+    Header: (props: DialogPartProps & {
+        name?: "columns" | "rows" | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | Iterable<react.ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Title: (props: DialogPartProps & {
+        name?: "columns" | "rows" | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | Iterable<react.ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Body: (props: DialogPartProps & {
+        name?: "columns" | "rows" | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | Iterable<react.ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Footer: (props: DialogPartProps & {
+        name?: "columns" | "rows" | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | Iterable<react.ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    /** Split: divide the cell at the selection into the typed counts. */
+    Apply: (props: DialogPartProps & {
+        name?: "columns" | "rows" | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | Iterable<react.ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Cancel: (props: DialogPartProps & {
+        name?: "columns" | "rows" | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | Iterable<react.ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Error: (props: DialogPartProps & {
+        name?: "columns" | "rows" | undefined;
+    }) => string | number | bigint | boolean | react.JSX.Element | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | Iterable<react.ReactNode> | ReactElement<unknown, string | react.JSXElementConstructor<any>> | react.ReactPortal | null | undefined> | null;
+    Field: (props: DialogPartProps & {
+        name: "columns" | "rows";
+    }) => react.ReactNode;
+};
+
 /** Shared props for every part. @public */
 interface HyperLinkPartProps {
     className?: string;
@@ -1374,6 +1686,14 @@ declare const ContextMenuInsertColumnLeft: (({ icon, labelKey, className, hidden
 declare const ContextMenuInsertColumnRight: (({ icon, labelKey, className, hidden, destructive }: ContextMenuTableRowProps) => react.JSX.Element | null) & {
     docxRow: string;
 };
+/** Merge the selected cells into one cell. @public */
+declare const ContextMenuMergeCells: (({ icon, labelKey, className, hidden, destructive }: ContextMenuTableRowProps) => react.JSX.Element | null) & {
+    docxRow: string;
+};
+/** Open the Split cells dialog for the cell at the selection. @public */
+declare const ContextMenuSplitCell: (({ icon, labelKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
+    docxRow: string;
+};
 /** Delete the current table row. @public */
 declare const ContextMenuDeleteTableRow: (({ icon, labelKey, className, hidden, destructive }: ContextMenuTableRowProps) => react.JSX.Element | null) & {
     docxRow: string;
@@ -1475,6 +1795,8 @@ interface DocxEditorContextMenuNamespace {
     readonly InsertRowBelow: typeof ContextMenuInsertRowBelow;
     readonly InsertColumnLeft: typeof ContextMenuInsertColumnLeft;
     readonly InsertColumnRight: typeof ContextMenuInsertColumnRight;
+    readonly MergeCells: typeof ContextMenuMergeCells;
+    readonly SplitCell: typeof ContextMenuSplitCell;
     readonly DeleteTableRow: typeof ContextMenuDeleteTableRow;
     readonly DeleteTableColumn: typeof ContextMenuDeleteTableColumn;
     readonly DeleteTable: typeof ContextMenuDeleteTable;
@@ -1568,6 +1890,8 @@ interface DocxEditorPopups {
      */
     contentControlPicture?: DocxEditorPopup<DocxEditorContentControlWidgetProps>;
     invalidTextFormField?: DocxEditorPopup<DocxEditorInvalidTextFormFieldDialogProps>;
+    /** Why a chosen or pasted picture could not be inserted. False shows nothing. */
+    imageInsertError?: DocxEditorPopup<DocxEditorImageInsertErrorDialogProps>;
     imageProperties?: DocxEditorPopup<DocxEditorImagePropertiesDialogProps>;
     imageAltText?: DocxEditorPopup<DocxEditorImageAltTextPopupProps>;
     noteProperties?: DocxEditorPopup<DocxEditorNotePropertiesDialogProps>;
@@ -1575,6 +1899,12 @@ interface DocxEditorPopups {
     notesContextMenu?: DocxEditorPopup<DocxEditorNotesContextMenuProps>;
     pageSetup?: DocxEditorPopup<DocxEditorPageSetupDialogProps>;
     paragraph?: DocxEditorPopup<DocxEditorParagraphDialogProps>;
+    /** The Watermark dialog the Insert menu opens. Pass `presets` here to change its text choices. */
+    watermark?: DocxEditorPopup<DocxEditorWatermarkDialogProps>;
+    /** The Bookmark dialog the Insert menu and Ctrl/Cmd+Shift+F5 open. */
+    bookmark?: DocxEditorPopup<DocxEditorBookmarkDialogProps>;
+    /** The Split cells dialog the table context menu and toolbar open. */
+    splitCell?: DocxEditorPopup<DocxEditorSplitCellDialogProps>;
     revisionMarkup?: DocxEditorPopup<DocxEditorRevisionMarkupDialogProps>;
     textFormField?: DocxEditorPopup<DocxEditorTextFormFieldDialogProps>;
     hyperlink?: DocxEditorPopup<HyperLinkProps>;
@@ -1606,17 +1936,50 @@ declare function useDocxEditor(): DocxEditorInstance | null;
  * legitimately compose two rails.
  */
 interface ReviewRailRegistry {
+    /**
+     * Review columns registered through `register`: the packaged rail, and any column that
+     * serves comment drafts. The Add comment controls in the toolbar and the context menu
+     * appear only while this is above zero.
+     */
     readonly mounted: number;
+    /**
+     * Register a review column that serves comment drafts. Also reserves the review gutter.
+     * Call it on mount, together with `registerCommentDraft`. Returns the unregister function.
+     */
     readonly register: () => () => void;
+    /**
+     * Claims registered through `reserveGutter`: columns that need the review gutter but
+     * serve no comment draft. The viewport reserves the gutter while `mounted + gutters` is
+     * above zero.
+     */
+    readonly gutters?: number;
+    /** Reserve the review gutter without showing comment controls. Returns the release. */
+    readonly reserveGutter?: () => () => void;
+    /**
+     * Receive the Add comment requests. The handler takes no arguments: it reads the
+     * selection's position with `getSelectionPlacement`, pins the selection with
+     * `retainSelection`, and opens the pane. Release the pin with `releaseSelection` when the
+     * draft closes or is cancelled. The most recently registered handler receives each request. Do not register
+     * while the column cannot open a draft, such as in viewing mode: a request counts as
+     * served once a handler runs. While a handler is registered, the `review.addComment`
+     * control is enabled. Returns the unregister function.
+     */
     readonly registerCommentDraft: (handler: () => void) => () => void;
+    /**
+     * Send an Add comment request through the `review.addComment` control. The most recent
+     * registration receives it: a handler registered here, or one registered with
+     * `useCommentDraftRequest`. Returns `true` when a handler ran, even if it then opened
+     * nothing, and `false` when the control is disabled.
+     */
     readonly requestCommentDraft: () => boolean;
 }
 declare const ReviewRailContext: react.Context<ReviewRailRegistry | null>;
 
 /**
- * Props for `DocxEditor.Root`. `document`, `fonts` and `imageDecodePort` identity changes remount
- * the editor. Changing `fontShaping.maxFontBytes` also remounts. Later `author`, `locale`, `mode`, `translate`, `zoom`, and `zoomMode` changes use
- * instance setters. `modules` is sampled at mount only.
+ * Props for `DocxEditor.Root`. `document` and `imageDecodePort` identity changes remount the
+ * editor. Changing `fontShaping.maxFontBytes` also remounts. Later `fonts`, `author`, `locale`,
+ * `mode`, `translate`, `zoom`, and `zoomMode` changes use instance setters, so edits, selection
+ * and undo history survive them. `modules` is sampled at mount only.
  *
  * @public
  */
@@ -1632,8 +1995,9 @@ interface DocxEditorRootProps {
      * uses a fixed-width estimate; fonts embedded in the document are wired automatically
      * either way. Pass `await loadDefaultFonts()` from `@docx-editor.dev/fonts` for
      * Word's default faces — a bare fragment is accepted — or compose several origins
-     * with `composeFontConfiguration`. Sampled at mount; identity change remounts;
-     * failures degrade to the fixed measurer and report through `onFontError`.
+     * with `composeFontConfiguration`. An identity change replaces the fonts in place
+     * (`setFonts`), keeping the document, selection and undo history; keep the reference stable
+     * across renders. Failures degrade to the fixed measurer and report through `onFontError`.
      */
     fonts?: FontConfiguration | FontConfigurationFragment | FontResolver;
     /** Explicit shaping byte ceiling; a changed maxFontBytes value remounts. */
@@ -2402,6 +2766,10 @@ interface DocxEditorToolbarNamespace {
     readonly TableBorderWidth: TableBorderWidthNamespace;
     /** Cell background fill split compound (quick-apply main + swatch dialog). */
     readonly TableCellFill: TableCellFillNamespace;
+    /** Merge the selected cells. */
+    readonly TableMergeCells: ToolbarPartComponent;
+    /** Open the Split cells dialog. */
+    readonly TableSplitCell: ToolbarPartComponent;
     readonly Comments: ToolbarPartComponent;
     readonly FontFamily: typeof FontFamily;
     readonly FontSize: ToolbarSlotPartComponent;
@@ -2425,6 +2793,32 @@ interface DocxEditorToolbarNamespace {
  */
 declare const DocxEditorToolbar: DocxEditorToolbarNamespace;
 
+/**
+ * The Watermark dialog, from the Insert menu.
+ *
+ * Same shape as page setup: no fixed command to dispatch, so the row asks through the
+ * slot's probe and is disabled with the engine's own words on a document it cannot rewrite.
+ */
+declare function MenuWatermarkImpl({ className, hidden }: MenuActionProps): react.JSX.Element | null;
+/** Insert › Watermark, so a host can hide it or place it elsewhere by name. @public */
+declare const MenuWatermark: typeof MenuWatermarkImpl & {
+    docxSlot: 'insert.watermark';
+};
+
+declare function MenuBookmarkImpl({ className, hidden }: MenuActionProps): react.JSX.Element;
+/**
+ * Insert › Bookmark, so a host can hide it or place it elsewhere by name.
+ *
+ * An ordinary command row: the slot runs `openBookmarkDialog`, which opens the `bookmark`
+ * popup through the editor, the same request Ctrl/Cmd+Shift+F5 sends. The row is disabled
+ * while no bookmark dialog is registered, for example when the popup is `false`.
+ *
+ * @public
+ */
+declare const MenuBookmark: typeof MenuBookmarkImpl & {
+    docxSlot: 'insert.bookmark';
+};
+
 /** Props for `DocxEditor.Menu.ReportIssue`. @public */
 interface MenuReportIssueProps {
     className?: string;
@@ -2562,6 +2956,9 @@ interface DocxEditorMenuNamespace {
     readonly PageSetup: typeof MenuPageSetup;
     /** Insert › Image, so a host can hide it or place it elsewhere by name. */
     readonly ImageInsert: typeof MenuImageInsert;
+    /** Insert › Watermark, so a host can hide it or place it elsewhere by name. */
+    readonly Watermark: typeof MenuWatermark;
+    readonly Bookmark: typeof MenuBookmark;
     /** Review > Markup Options > Reviewers. */
     readonly Reviewers: typeof MenuReviewers;
     /** Help › Report issue, so a host can drop it or point it elsewhere by name. */
@@ -2635,64 +3032,8 @@ interface DocxEditorDocumentOutlineProps {
  */
 declare function DocxEditorDocumentOutline(props: DocxEditorDocumentOutlineProps): ReactElement | null;
 
-/** How `useDocumentSearch` behaves. @public */
-interface UseDocumentSearchOptions {
-    /**
-     * Which matches to mark: every match with the active one emphasized (`'all'`), only the
-     * active match (`'active'`), or none (`'none'`). Default: `'all'`.
-     */
-    readonly highlight?: DocumentSearchHighlight;
-}
-/** What `useDocumentSearch` answers. @public */
-interface UseDocumentSearchResult {
-    /** The text in the search box, updated synchronously as the user types. */
-    readonly query: string;
-    /** Update the typed query. The search runs after a short debounce. */
-    readonly setQuery: (query: string) => void;
-    /**
-     * Search now and return the matches. `selectFirst` selects the first match; `highlight`
-     * highlights the results until `clear()`, even without this hook's own request.
-     */
-    readonly find: (query: string, options?: DocumentSearchFindOptions) => readonly TextMatch[];
-    readonly matchCase: boolean;
-    readonly setMatchCase: (value: boolean) => void;
-    readonly wholeWord: boolean;
-    readonly setWholeWord: (value: boolean) => void;
-    /** Matches for the last RUN query, in document order. */
-    readonly matches: readonly TextMatch[];
-    /**
-     * Whether the engine stopped at its cap with matches still ahead of it, so a count
-     * should read "2000+" rather than an exact total. A search that lands on exactly the cap
-     * reports true; over-reporting by one is the honest direction.
-     */
-    readonly truncated: boolean;
-    /** Index of the match the caret was last sent to, or `-1` before any navigation. */
-    readonly activeIndex: number;
-    /** The current match, or `null` before any navigation. */
-    readonly activeMatch: TextMatch | null;
-    /**
-     * Select a match by index and bring its page into view. Focus stays where it is, so a
-     * search box keeps it. Returns false for an index without a match.
-     */
-    readonly goTo: (index: number) => boolean;
-    /** Next / previous match, wrapping at the ends the way Word's arrows do. */
-    readonly next: () => boolean;
-    readonly previous: () => boolean;
-    /** Empty the box and drop the results, without touching the selection. */
-    readonly clear: () => void;
-    /** Whether a typed query is waiting for its debounce to elapse. */
-    readonly isPending: boolean;
-}
-/**
- * The editor's shared search, with no UI attached. The packaged Find pane uses the same
- * session, so state set here shows there.
- *
- * @public
- */
-declare function useDocumentSearch(options?: UseDocumentSearchOptions): UseDocumentSearchResult;
-
-/** The pane's tabs. Word's Replace tab is a later slice; nothing here pretends it exists. */
-type NavigationTab$1 = 'headings' | 'find';
+/** The pane's tabs: the outline, Find, and Go to (bookmarks). */
+type NavigationTab$1 = 'headings' | 'find' | 'goto';
 /** How `useNavigationPane` is configured. @public */
 interface UseNavigationPaneOptions {
     /** Open state for the first render when the pane is uncontrolled. Defaults to closed. */
@@ -2797,6 +3138,70 @@ declare function NavigationFind({ className, style }: NavigationPartProps): Reac
  */
 declare function NavigationToggle({ className, style, children, }: NavigationPartProps): ReactElement;
 
+/**
+ * The Bookmarks panel: a bookmark search box, the sort order and hidden-bookmarks toggle, and
+ * the bookmarks it offers, grouped by place when sorted by location.
+ *
+ * @public
+ */
+declare function NavigationGoTo({ className, style }: NavigationPartProps): ReactElement;
+
+/** How `useDocumentSearch` behaves. @public */
+interface UseDocumentSearchOptions {
+    /**
+     * Which matches to mark: every match with the active one emphasized (`'all'`), only the
+     * active match (`'active'`), or none (`'none'`). Default: `'all'`.
+     */
+    readonly highlight?: DocumentSearchHighlight;
+}
+/** What `useDocumentSearch` answers. @public */
+interface UseDocumentSearchResult {
+    /** The text in the search box, updated synchronously as the user types. */
+    readonly query: string;
+    /** Update the typed query. The search runs after a short debounce. */
+    readonly setQuery: (query: string) => void;
+    /**
+     * Search now and return the matches. `selectFirst` selects the first match; `highlight`
+     * highlights the results until `clear()`, even without this hook's own request.
+     */
+    readonly find: (query: string, options?: DocumentSearchFindOptions) => readonly TextMatch[];
+    readonly matchCase: boolean;
+    readonly setMatchCase: (value: boolean) => void;
+    readonly wholeWord: boolean;
+    readonly setWholeWord: (value: boolean) => void;
+    /** Matches for the last RUN query, in document order. */
+    readonly matches: readonly TextMatch[];
+    /**
+     * Whether the engine stopped at its cap with matches still ahead of it, so a count
+     * should read "2000+" rather than an exact total. A search that lands on exactly the cap
+     * reports true; over-reporting by one is the honest direction.
+     */
+    readonly truncated: boolean;
+    /** Index of the match the caret was last sent to, or `-1` before any navigation. */
+    readonly activeIndex: number;
+    /** The current match, or `null` before any navigation. */
+    readonly activeMatch: TextMatch | null;
+    /**
+     * Select a match by index and bring its page into view. Focus stays where it is, so a
+     * search box keeps it. Returns false for an index without a match.
+     */
+    readonly goTo: (index: number) => boolean;
+    /** Next / previous match, wrapping at the ends the way Word's arrows do. */
+    readonly next: () => boolean;
+    readonly previous: () => boolean;
+    /** Empty the box and drop the results, without touching the selection. */
+    readonly clear: () => void;
+    /** Whether a typed query is waiting for its debounce to elapse. */
+    readonly isPending: boolean;
+}
+/**
+ * The editor's shared search, with no UI attached. The packaged Find pane uses the same
+ * session, so state set here shows there.
+ *
+ * @public
+ */
+declare function useDocumentSearch(options?: UseDocumentSearchOptions): UseDocumentSearchResult;
+
 /** Props for `DocxEditor.Navigation`. @public */
 interface DocxEditorNavigationProps extends UseNavigationPaneOptions {
     /**
@@ -2826,6 +3231,12 @@ interface DocxEditorNavigationProps extends UseNavigationPaneOptions {
      * browser's own search. Set `false` to leave the shortcut to the browser everywhere.
      */
     findShortcut?: boolean;
+    /**
+     * Whether Ctrl+G (Cmd+Option+G on macOS) opens the pane on the Go to tab. Defaults to
+     * `true`, and applies only while focus is in this editor. The `openGoTo` editor command
+     * opens the tab either way.
+     */
+    goToShortcut?: boolean;
     className?: string;
     style?: CSSProperties;
     /** Replaces the default composition (header, tabs, both panels). */
@@ -2851,10 +3262,68 @@ interface DocxEditorNavigationNamespace {
     readonly Tab: typeof NavigationTab;
     readonly Headings: typeof NavigationHeadings;
     readonly Find: typeof NavigationFind;
+    readonly GoTo: typeof NavigationGoTo;
     readonly Toggle: typeof NavigationToggle;
 }
 declare const Navigation: DocxEditorNavigationNamespace;
 
+/**
+ * Why a Go To jump did not happen: nothing was typed, no bookmark has the name, or the editor
+ * refused the jump for another reason (it is not ready, or the story could not be shown).
+ *
+ * @public
+ */
+type GoToBookmarkProblem = 'empty' | 'notFound' | 'failed';
+/** How `useGoToBookmark` is configured. @public */
+interface UseGoToBookmarkOptions {
+    /**
+     * Whether to read the document's bookmarks. Defaults to `true`. Pass `false` while your UI
+     * is hidden: the list is then empty and the document is not read on each change.
+     */
+    readonly enabled?: boolean;
+}
+/** What `useGoToBookmark` answers. @public */
+interface UseGoToBookmarkReturn {
+    /** The text in the name box. */
+    readonly query: string;
+    /** Change the text. The highlight goes back to none. */
+    readonly setQuery: (query: string) => void;
+    readonly sortBy: BookmarkSortOrder;
+    readonly setSortBy: (sortBy: BookmarkSortOrder) => void;
+    /** Whether hidden bookmarks (names starting with an underscore) are offered. */
+    readonly showHidden: boolean;
+    readonly setShowHidden: (showHidden: boolean) => void;
+    /** The bookmarks offered for the query: names that start with it first. */
+    readonly rows: readonly BookmarkSummary[];
+    /** Every bookmark the document declares, hidden ones included. Empty while disabled. */
+    readonly bookmarks: readonly BookmarkSummary[];
+    /**
+     * Index into `rows` of the highlighted row, or -1 when none is. The highlight follows its
+     * bookmark when rows move, and clears when that bookmark goes away.
+     */
+    readonly activeIndex: number;
+    /** Move the highlight by `delta` rows, wrapping at either end. */
+    readonly move: (delta: number) => void;
+    /** Highlight the row at `index` of `rows`, or none with -1. */
+    readonly setActiveIndex: (index: number) => void;
+    /**
+     * Jump to `name`, or else to what the name box means: the highlighted row, the bookmark
+     * named exactly as typed, or the first row offered. Answers the `goToBookmark` result and
+     * sets `problem` when it is refused.
+     */
+    readonly go: (name?: string) => ExecResult;
+    /** Why the last jump did not happen, or null. Cleared when the query changes. */
+    readonly problem: GoToBookmarkProblem | null;
+    /** The name the last refused jump asked for, for a message. Empty when nothing was typed. */
+    readonly problemName: string;
+}
+/**
+ * Go To for bookmarks: filter by name, move through the offered rows, and jump.
+ *
+ * @public
+ */
+declare function useGoToBookmark(options?: UseGoToBookmarkOptions): UseGoToBookmarkReturn;
+
 /**
  * One heading of the engine's outline: text, 0-based level, and the block id
  * `Editor.scrollToBlock` accepts.
@@ -3031,6 +3500,162 @@ interface DocxEditorFontNoticeProps {
  */
 declare function DocxEditorFontNotice({ className, style, t: tProp }: DocxEditorFontNoticeProps): react.JSX.Element | null;
 
+/** The current refused open, with the packaged message and a way to dismiss it. @public */
+interface UseOpenFailureReturn {
+    /** The refused open, or `null` when there is none or the person dismissed it. */
+    readonly failure: DocumentOpenFailure | null;
+    /** The packaged, translated message for {@link UseOpenFailureReturn.failure}. */
+    readonly message: string | null;
+    /**
+     * Hide this refusal. A later refusal shows again, even for the same file. Pass the failure
+     * your UI showed, such as from a toast's close callback, so a late call cannot hide a newer
+     * refusal. It also works as a click handler directly, such as `onClick={dismiss}`: an event
+     * hides the refusal on screen.
+     */
+    dismiss(failure?: DocumentOpenFailure | Event | {
+        readonly nativeEvent: Event;
+    }): void;
+}
+/** Options for {@link useOpenFailure}. @public */
+interface UseOpenFailureOptions {
+    /** Translator override; defaults to the ambient locale context. */
+    t?: TFunction;
+}
+/**
+ * Reads the document the editor refused to open, for a host that shows it in its own UI,
+ * such as a toast. Pair it with `openFailure={false}` on `<DocxEditor>`, so the packaged
+ * dialog does not show as well. Call it inside a `DocxEditor.Root`.
+ *
+ * ```tsx
+ * function OpenFailureToast() {
+ *   const { failure, message, dismiss } = useOpenFailure();
+ *   if (!failure) return null;
+ *   return <Toast title={message} detail={failure.code} onClose={() => dismiss(failure)} />;
+ * }
+ * ```
+ *
+ * @public
+ */
+declare function useOpenFailure(options?: UseOpenFailureOptions): UseOpenFailureReturn;
+/** What `actions` and `children` receive. @public */
+interface DocxEditorOpenFailureContext {
+    /** The refused open: its stable `code` and its `reason`. */
+    readonly failure: DocumentOpenFailure;
+    /** The packaged, translated message for the failure. */
+    readonly message: string;
+    /** Close the dialog. It calls `onDismiss`, as **Close** does. */
+    dismiss(): void;
+}
+/** Props for `DocxEditor.OpenFailure.Action`. @public */
+interface DocxEditorOpenFailureActionProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children'> {
+    /** `primary` is filled, `secondary` is outlined. Defaults to `secondary`. */
+    variant?: 'primary' | 'secondary';
+    /** Close the dialog after `onClick` runs, unless the handler called `preventDefault()`. */
+    dismiss?: boolean;
+    /** Render your own element, such as a link, with the button's classes and handler. */
+    asChild?: boolean;
+    children?: DocxEditorChildren;
+}
+/**
+ * A button in the open-failure dialog, styled as the packaged **Close**. Use it in `actions`,
+ * or in your own `children`. With `asChild`, it styles your own element instead, such as a
+ * link to your support page:
+ *
+ * ```tsx
+ * <DocxEditor.OpenFailure
+ *   actions={({ failure }) => (
+ *     <DocxEditor.OpenFailure.Action asChild>
+ *       <a href={`/support?code=${failure.code}`}>Get help</a>
+ *     </DocxEditor.OpenFailure.Action>
+ *   )}
+ * />
+ * ```
+ *
+ * @public
+ */
+declare function DocxEditorOpenFailureAction({ variant, dismiss, asChild, className, onClick, children, type, ...rest }: DocxEditorOpenFailureActionProps): react.JSX.Element;
+/**
+ * A message for the open-failure dialog: text, content, or a function of the failure. It
+ * renders in a `div`, so block content is valid.
+ *
+ * @public
+ */
+type DocxEditorOpenFailureMessage = string | DocxEditorChildren | ((failure: DocumentOpenFailure) => string | DocxEditorChildren);
+/** Props for `DocxEditor.OpenFailure`. @public */
+interface DocxEditorOpenFailureProps {
+    /**
+     * The dialog title. Defaults to the translated `openFailure.title`. It also names the dialog
+     * for screen readers, including when your own content replaces the packaged one.
+     */
+    title?: string;
+    /** Your own message in place of the packaged one, as content or per failure. */
+    message?: DocxEditorOpenFailureMessage;
+    /** Show the stable error code under the message. Defaults to `true`. */
+    showCode?: boolean;
+    /**
+     * Your own buttons, before **Close**. Build them from `DocxEditor.OpenFailure.Action` so
+     * they match the dialog. The dialog shows no contact of its own.
+     */
+    actions?: (context: DocxEditorOpenFailureContext) => DocxEditorChildren;
+    /** The label of the **Close** button. Defaults to the translated `common.close`. */
+    closeLabel?: string;
+    /**
+     * Show the packaged **Close** button. Defaults to `true`. Turn it off only when `actions`
+     * gives a way out. Escape still closes the dialog.
+     */
+    showClose?: boolean;
+    /** Called after the person closes the dialog, by any route. */
+    onDismiss?: (failure: DocumentOpenFailure) => void;
+    /**
+     * Your own dialog content, in place of the packaged header, body and footer. The dialog
+     * frame, its focus handling and Escape stay.
+     */
+    children?: (context: DocxEditorOpenFailureContext) => DocxEditorChildren;
+    /** Appended after the load-bearing `docx-dialog` class. */
+    className?: string;
+    /** Inline styles for the dialog element. */
+    style?: CSSProperties;
+    /** Translator override; defaults to the ambient locale context. */
+    t?: TFunction;
+}
+/**
+ * The open-failure part with its button attached as a static.
+ *
+ * @public
+ */
+interface DocxEditorOpenFailureComponent {
+    /** Renders the dialog while a refused open is waiting, and nothing otherwise. */
+    (props: DocxEditorOpenFailureProps): ReactNode;
+    /** A button styled for the dialog, for `actions` and custom `children`. */
+    readonly Action: typeof DocxEditorOpenFailureAction;
+}
+/**
+ * A dialog that explains why a file did not open. It shows nothing until the editor refuses a
+ * document, and shows again for each later refusal. `<DocxEditor>` renders it by default;
+ * compose it yourself inside a `DocxEditor.Root`:
+ *
+ * ```tsx
+ * <DocxEditor.Root document={bytes}>
+ *   <DocxEditor.OpenFailure
+ *     actions={({ failure }) => (
+ *       <DocxEditor.OpenFailure.Action variant="primary" onClick={() => report(failure.code)}>
+ *         Report
+ *       </DocxEditor.OpenFailure.Action>
+ *     )}
+ *   />
+ *   <DocxEditor.Viewport>
+ *     <DocxEditor.Content />
+ *   </DocxEditor.Viewport>
+ * </DocxEditor.Root>
+ * ```
+ *
+ * The packaged message is generic and names no contact. For a toast or banner instead of a
+ * dialog, use `useOpenFailure`.
+ *
+ * @public
+ */
+declare const DocxEditorOpenFailure: DocxEditorOpenFailureComponent;
+
 /** Props for `DocxEditor.HeaderFooterChrome`. @public */
 interface DocxEditorHeaderFooterChromeProps {
     className?: string;
@@ -3057,8 +3682,8 @@ interface DocxEditorProps {
     /** Customize automatically mounted popups. Set an entry to false for manual ownership. */
     popups?: DocxEditorPopups;
     /**
-     * Immutable byte-backed font sources sampled at mount. Remount to replace this
-     * configuration atomically.
+     * Font sources for layout and paint. A new value replaces the fonts in place, keeping the
+     * document, selection and undo history; keep the reference stable across renders.
      *
      * Optional, but it decides layout FIDELITY. With it, the engine shapes text through
      * HarfBuzz and measures line and page breaks from real font metrics. Without it, layout
@@ -3069,6 +3694,8 @@ interface DocxEditorProps {
     fonts?: FontConfiguration | FontConfigurationFragment | FontResolver;
     /** Explicit shaping byte ceiling. A changed maxFontBytes value remounts; equal values keep the instance. */
     fontShaping?: FontShapingOptions;
+    /** Inject image decoding and preserved-image conversion. A changed port identity remounts the editor. */
+    imageDecodePort?: ImageDecodePort;
     /**
      * Title-bar slots. The host owns what goes here — brand lockup, switchers, theme
      * toggle, Open/New/Save controls — and passes them in; the editor renders them
@@ -3076,6 +3703,23 @@ interface DocxEditorProps {
      */
     readonly renderTitleBarLeft?: () => DocxEditorChildren;
     readonly renderTitleBarRight?: () => DocxEditorChildren;
+    /**
+     * Your own buttons in the dialog for a file that does not open, before **Close**. Build
+     * them from `DocxEditor.OpenFailure.Action`. It is the same as `openFailure.actions`; pass
+     * only one. With `openFailure={false}` there is no dialog, so it renders nothing.
+     *
+     * ```tsx
+     * <DocxEditor
+     *   document={bytes}
+     *   renderOpenFailureActions={({ failure }) => (
+     *     <DocxEditor.OpenFailure.Action asChild>
+     *       <a href={`/support?code=${failure.code}`}>Get help</a>
+     *     </DocxEditor.OpenFailure.Action>
+     *   )}
+     * />
+     * ```
+     */
+    readonly renderOpenFailureActions?: (context: DocxEditorOpenFailureContext) => DocxEditorChildren;
     /**
      * Your own loading indicator, in place of the packaged spinner. It shows centered on a
      * blank page before the document arrives, then on the document's first page while a large
@@ -3205,6 +3849,15 @@ interface DocxEditorProps {
      * `navigation={{ findShortcut: false }}` leaves the shortcut to the browser.
      */
     navigation?: boolean | DocxEditorNavigationProps;
+    /**
+     * The dialog that explains a file the editor refused to open, on by default. A refused
+     * open leaves the pages blank, so without it the reader sees nothing.
+     *
+     * An object is `DocxEditorOpenFailureProps`, passed straight through: change the title or
+     * message, hide the error code, or add your own support action with `actions`. `false`
+     * removes the dialog, for a host that reports the failure itself through `useOpenFailure`.
+     */
+    openFailure?: boolean | DocxEditorOpenFailureProps;
     /**
      * Horizontal and vertical rulers, on by default with the packaged chrome.
      *
@@ -3339,6 +3992,8 @@ interface DocxEditorNamespace extends ForwardRefExoticComponent<DocxEditorProps
     readonly Root: typeof DocxEditorRoot;
     readonly Viewport: typeof DocxEditorViewport;
     readonly Content: typeof DocxEditorContent;
+    /** The editor panel in a pop-out window while `open`; see the pop-out guide. */
+    readonly Window: typeof DocxEditorWindow;
     readonly Toolbar: typeof DocxEditorToolbar;
     /**
      * The menu bar — File · Format · Insert · Help — with its parts as statics (`.File`,
@@ -3351,6 +4006,7 @@ interface DocxEditorNamespace extends ForwardRefExoticComponent<DocxEditorProps
     readonly ColorByChangeType: typeof DocxEditorColorByChangeType;
     readonly RevisionMarkupDialog: typeof DocxEditorRevisionMarkupDialog;
     readonly RevisionMarkup: typeof DocxEditorRevisionMarkup;
+    readonly UnsupportedElement: typeof DocxEditorUnsupportedElement;
     readonly AuthorStyle: typeof DocxEditorAuthorStyle;
     /** Context-fed horizontal ruler with draggable margins (props-driven export stays). */
     readonly HorizontalRuler: typeof DocxEditorHorizontalRuler;
@@ -3370,6 +4026,12 @@ interface DocxEditorNamespace extends ForwardRefExoticComponent<DocxEditorProps
     readonly PrintDialog: typeof DocxEditorPrintDialog;
     /** Page Setup dialog — size, orientation, margins — applied as one undo step. */
     readonly PageSetupDialog: typeof DocxEditorPageSetupDialog;
+    /** Watermark dialog — none, picture or text — applied as one undo step. */
+    readonly WatermarkDialog: typeof DocxEditorWatermarkDialog;
+    /** Bookmark dialog — list, add, delete and go to bookmarks. */
+    readonly BookmarkDialog: typeof DocxEditorBookmarkDialog;
+    /** Split cells dialog — split the cell at the selection into columns and rows. */
+    readonly SplitCellDialog: typeof DocxEditorSplitCellDialog;
     /** The Paragraph dialog: alignment, indentation, spacing and the paragraph flags. */
     readonly TextFormFieldDialog: typeof DocxEditorTextFormFieldDialog;
     readonly ParagraphDialog: typeof DocxEditorParagraphDialog;
@@ -3377,6 +4039,11 @@ interface DocxEditorNamespace extends ForwardRefExoticComponent<DocxEditorProps
     readonly PageNumber: typeof DocxEditorPageNumber;
     /** Word-style notice when document fonts render in substitute faces. */
     readonly FontNotice: typeof DocxEditorFontNotice;
+    /**
+     * The dialog that explains a file the editor refused to open. Mounted by default;
+     * `openFailure={false}` removes it.
+     */
+    readonly OpenFailure: typeof DocxEditorOpenFailure;
     /** Header/footer scope chrome while editing page furniture. */
     readonly HeaderFooterChrome: typeof DocxEditorHeaderFooterChrome;
     readonly NotesChrome: typeof DocxEditorNotesChrome;
@@ -3446,6 +4113,49 @@ declare function notificationYieldsToTask(): boolean;
  */
 declare function useScopeClassName(): '' | 'docx-editor ';
 
+/** What `useWatermark` returns. @public */
+interface UseWatermarkReturn {
+    /** The document's watermark, or null when it has none. Reference-stable while unchanged. */
+    readonly watermark: WatermarkState | null;
+    /** Whether the engine can write a watermark right now (mounted, editable). */
+    readonly isEnabled: boolean;
+    /** The full current watermark, with picture bytes, through `query({ type: 'watermark' })`. */
+    readonly read: () => Watermark | null;
+    /** Set the watermark as one undo step. Null removes it. */
+    readonly apply: (watermark: Watermark | null) => ExecResult;
+}
+/**
+ * The document watermark plus the command to change it.
+ *
+ * @public
+ */
+declare function useWatermark(): UseWatermarkReturn;
+
+/** What `useBookmarks` returns. @public */
+interface UseBookmarksReturn {
+    /** Every bookmark, hidden ones included, in document order. Reference-stable while unchanged. */
+    readonly bookmarks: readonly BookmarkSummary[];
+    /** Whether the document accepts bookmark edits now. Go To works either way. */
+    readonly isWritable: boolean;
+    /** Bookmark the selection under `name`. A bookmark with the name moves. */
+    readonly insert: (name: string) => ExecResult;
+    /** Delete the bookmark with this name. The text stays. */
+    readonly remove: (name: string) => ExecResult;
+    /** Select the bookmark and scroll to it. */
+    readonly goTo: (name: string) => ExecResult;
+    /**
+     * Keep the first bookmark with this name and remove its copies, which collaborators adding
+     * one name offline can leave. The selection does not move.
+     */
+    readonly keepFirst: (name: string) => ExecResult;
+}
+/**
+ * The document's bookmarks plus the commands that change them.
+ *
+ * @public
+ */
+declare function useBookmarks(): UseBookmarksReturn;
+
 /** Full reservation: the 300px card column plus its 16px gutter off the page edge. */
 declare const REVIEW_PANE_GUTTER = 316;
 /** The marker strip: anchors and the add-comment button, no cards. */
@@ -3522,9 +4232,14 @@ interface LocaleProviderProps {
     children: DocxEditorChildren;
 }
 declare function LocaleProvider({ i18n, children }: LocaleProviderProps): react.JSX.Element;
+/**
+ * The active catalogue's `t()`, the catalogue itself, and its language tag (`_lang`, `en`
+ * by default), which formats numbers the way the strings around them read.
+ */
 declare function useTranslation(): {
     t: TFunction;
     catalogue: LocaleStrings;
+    lang: string;
 };
 
 /**
@@ -4055,7 +4770,8 @@ declare function useEditorValueCommand<K extends keyof ToolbarValueMap>(slotId:
 /** @public */
 type DocxEditorRefCallback<T> = (node: T | null) => void;
 
-type AnchorPlacement = 'before' | 'after' | 'story-label';
+/** Where a scoped chrome anchor sits relative to its story: before it, after it, or on its label. */
+type ScopedChromeAnchorPlacement = 'before' | 'after' | 'story-label';
 interface ScopedChromeAnchor {
     readonly ref: DocxEditorRefCallback<HTMLDivElement>;
     readonly style: CSSProperties;
@@ -4067,7 +4783,7 @@ interface ScopedChromeAnchor {
  * portal controls into a header, footer, or note node. This hook keeps the controls as a
  * sibling overlay and derives only their screen placement from the current painted host.
  */
-declare function useScopedChromeAnchor(findAnchor: (viewport: HTMLElement) => HTMLElement | null, placement: AnchorPlacement): ScopedChromeAnchor;
+declare function useScopedChromeAnchor(findAnchor: (viewport: HTMLElement) => HTMLElement | null, placement: ScopedChromeAnchorPlacement): ScopedChromeAnchor;
 
 /**
  * Subscribe to an editor event (`'change'`, `'selectionChange'`, `'error'`, …) for the
@@ -4078,6 +4794,71 @@ declare function useScopedChromeAnchor(findAnchor: (viewport: HTMLElement) => HT
  */
 declare function useEditorEvent<E extends keyof EditorEvents>(event: E, handler: EditorEvents[E]): void;
 
+/**
+ * Open the host's own comment draft when the `review.addComment` control is pressed.
+ *
+ * While the component is mounted and `handler` is set, the control is enabled (subject to the
+ * engine's other rules: the review module, the editing mode, and a selection). Without any
+ * registration the control is disabled, because nothing could open the draft. The most recent
+ * registration receives each request. Pass `null` to stop serving requests, for example while
+ * your comment UI cannot open a draft.
+ *
+ * The handler takes no arguments. Read the selection with `editor.getSelectionPlacement()`,
+ * and pin it with `editor.retainSelection()` while the draft is open.
+ *
+ * @example
+ * ```tsx
+ * function CommentButton() {
+ *   const [drafting, setDrafting] = useState(false);
+ *   useCommentDraftRequest(() => setDrafting(true));
+ *   const addComment = useEditorCommand('review.addComment');
+ *   return (
+ *     <>
+ *       <button
+ *         disabled={!addComment.isEnabled}
+ *         title={addComment.disabledReason ?? 'Add comment'}
+ *         onClick={() => addComment.execute()}
+ *       >
+ *         Add comment
+ *       </button>
+ *       {drafting ? <MyCommentDraft onClose={() => setDrafting(false)} /> : null}
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @public
+ */
+declare function useCommentDraftRequest(handler: (() => void) | null | undefined): void;
+
+/** What {@link useEditorHostDocument} returns: the host document, or `null` on the server. @public */
+type UseEditorHostDocumentReturn = Document | null;
+/**
+ * The document the editor's pages are mounted in: a pop-out window's or an iframe's when the
+ * host attached the editor there, otherwise the page's own. `null` during server rendering.
+ *
+ * Custom chrome that adds document listeners, reads focus, or injects a `<style>` uses this
+ * instead of the global `document`, which belongs to the window the script runs in. The value
+ * changes when the editor moves to another window, so effects keyed on it re-bind.
+ * Its `defaultView` is the editor's window, for timers, viewport size and the clipboard.
+ *
+ * @example
+ * ```tsx
+ * function ShortcutListener() {
+ *   const hostDocument = useEditorHostDocument();
+ *   useEffect(() => {
+ *     if (!hostDocument) return;
+ *     hostDocument.addEventListener('keydown', onShortcut);
+ *     return () => hostDocument.removeEventListener('keydown', onShortcut);
+ *   }, [hostDocument]);
+ *   return null;
+ * }
+ * ```
+ *
+ * @public
+ */
+declare function useEditorHostDocument(): UseEditorHostDocumentReturn;
+
 /**
  * Highlight text ranges as the named set while the component is mounted, and keep them
  * current as the document changes. Returns what the last application resolved.
@@ -4093,6 +4874,8 @@ declare function useEditorEvent<E extends keyof EditorEvents>(event: E, handler:
  * );
  * useHighlights('glossary', findTerms, { className: 'glossary-term' });
  * ```
+ *
+ * @see {@link https://www.docx-editor.dev/docs/2.x/recipes/highlight-ranges | Highlight ranges}
  * @public
  */
 declare function useHighlights(name: string, source: HighlightSource, options?: HighlightOptions): HighlightResult;
@@ -4956,5 +5739,5 @@ interface UseHistoryGroupReturn {
 /** Bind a control's native gesture lifecycle. Apply values through the existing command hooks. @public */
 declare function useHistoryGroup({ kind }: HistoryGroupBindingOptions): UseHistoryGroupReturn;
 
-export { CONTENT_CONTROL_SLOTS, ContextMenuCellVerticalAlignment, ContextMenuCopy, ContextMenuCopyFormatting, ContextMenuCut, ContextMenuDelete, ContextMenuDeleteTable, ContextMenuDeleteTableColumn, ContextMenuDeleteTableRow, ContextMenuInsertColumnLeft, ContextMenuInsertColumnRight, ContextMenuInsertRowAbove, ContextMenuInsertRowBelow, ContextMenuItem, ContextMenuPaste, ContextMenuPasteFormatting, ContextMenuPasteWithoutFormatting, ContextMenuRefreshToc, ContextMenuRefreshTocPageNumbers, ContextMenuSelectAll, DocumentName, DocumentOutline, DocxEditor, DocxEditorAuthorStyle, DocxEditorColorByChangeType, DocxEditorContent, DocxEditorContentControl, DocxEditorContentControlWidget, DocxEditorContextMenu, DocxEditorDocumentOutline, DocxEditorEquation, DocxEditorExportDialog, DocxEditorFontNotice, DocxEditorHeaderFooterChrome, DocxEditorHorizontalRuler, DocxEditorHyperLink, DocxEditorImageAltTextPopup, DocxEditorImagePropertiesDialog, DocxEditorInvalidTextFormFieldDialog, DocxEditorLoading, DocxEditorLoadingSpinner, DocxEditorMenu, DocxEditorNavigation, DocxEditorNotePreview, DocxEditorNotePropertiesDialog, DocxEditorNotesChrome, DocxEditorNotesContextMenu, DocxEditorPageNumber, DocxEditorPageSetupDialog, DocxEditorParagraphDialog, DocxEditorPrintDialog, DocxEditorRevisionMarkup, DocxEditorRevisionMarkupDialog, DocxEditorRoot, DocxEditorShell, DocxEditorTextFormFieldDialog, DocxEditorToolbar, DocxEditorVerticalRuler, DocxEditorViewport, HorizontalRuler, ImageAltText, ImageInsertProvider, ImageInsertTrigger, ImagePropertiesTrigger, ImageWrap, LocaleProvider, Logo, MenuBar, NAVIGATION_PANE_GAP, NAVIGATION_PANE_INSET, NAVIGATION_PANE_MIN_PAGE_ROOM, NAVIGATION_PANE_WIDTH, NavigationClose, NavigationFind, NavigationHeader, NavigationHeadings, NavigationTab, NavigationTabs, NavigationTitle, NavigationToggle, OUTLINE_BUTTON_LEFT_OFFSET, OUTLINE_BUTTON_RESERVED_SPACE, OUTLINE_LEFT_OFFSET, OUTLINE_RESERVED_SPACE, PageIndicator, PageNumberTranslationContext, PaginatedDocxEditor, PaginatedDocxEditorShell, REVIEW_MARKERS_GUTTER, REVIEW_PANE_GUTTER, RULER_WIDTH, ReviewRailContext, Slot, TitleBar, TitleBarRight, Toolbar, ToolbarButton, ToolbarContext, ToolbarGroup, ToolbarImageProperties, VERSION, VerticalRuler, definePopup, editorStateActiveSubscriptionCount, isFieldLink, navigationPaneOverlays, navigationPaneReservation, navigationShift, normalizeImageBytes, notificationYieldsToTask, useProvidedDocxEditor as provideDocxEditor, reviewGutter, useChromeTranslate, useContentControl, useContentControlInstance, useContentControlWidget, useContextMenuTarget, useDocumentOutline, useDocumentSearch, useDocxEditor, useDocxSource, useEditorCaret, useEditorCommand, useEditorEvent, useEditorSnapshot, useEditorState, useEditorValueCommand, useFontFamily, useFonts, useHeaderFooterState, useHighlightAt, useHighlights, useHistoryGroup, useHyperlinkPopup, useHyperlinkPopupInstance, useNavigationPane, useNavigationShift, useNotePropertiesState, useNoteScopeState, usePageSetup, usePageSetupDialog, useParagraphDialog, useParagraphFormat, useParagraphIndent, useParagraphStyle, useReviewAuthors, useReviewGutter, useRevisionMarkupDialog, useScopeClassName, useScopedChromeAnchor, useTableBorderTargetLabel, useTextFormFieldDialog, useToolbarContext, useToolbarLabel, useToolbarLabelFor, useTranslation, useZoom };
-export type { ChromeTranslate, ContentControlActionProps, ContentControlInspectorState, ContentControlLock, ContentControlPartProps, ContentControlProps, ContentControlSlotId, ContentControlWidgetDayProps, ContentControlWidgetEntry, ContentControlWidgetItemProps, ContentControlWidgetPictureProps, ContextMenuAnchor, ContextMenuCommandProps, ContextMenuContextValue, ContextMenuItemProps, ContextMenuTableRowProps, DialogCustomizationProps, DialogPartProps, DocxEditorAuthorStyleProps, DocxEditorChildren, DocxEditorContentControlNamespace, DocxEditorContentControlWidgetNamespace, DocxEditorContentControlWidgetPartProps, DocxEditorContentControlWidgetProps, DocxEditorContentProps, DocxEditorContextMenuNamespace, DocxEditorContextMenuProps, DocxEditorDocumentOutlineProps, DocxEditorExportDialogProps, DocxEditorFontNoticeProps, DocxEditorHeaderFooterChromeProps, DocxEditorHyperLinkNamespace, DocxEditorImageAltTextPopupProps, DocxEditorImagePropertiesDialogProps, DocxEditorInvalidTextFormFieldDialogProps, DocxEditorLoadingComponent, DocxEditorLoadingProps, DocxEditorLoadingSpinnerProps, DocxEditorMenuNamespace, DocxEditorMenuProps, DocxEditorNamespace, DocxEditorNavigationNamespace, DocxEditorNavigationProps, DocxEditorNotePreviewProps, DocxEditorNotePropertiesDialogProps, DocxEditorNotesChromeProps, DocxEditorNotesContextMenuProps, DocxEditorPageNumberProps, DocxEditorPageSetupDialogProps, DocxEditorParagraphDialogProps, DocxEditorPopup, DocxEditorPopups, DocxEditorPrintDialogProps, DocxEditorProps, DocxEditorRef, DocxEditorRevisionMarkupDialogProps, DocxEditorRevisionMarkupProps, DocxEditorRootListeners, DocxEditorRootProps, DocxEditorRulerProps, DocxEditorTextFormFieldDialogProps, DocxEditorToolbarGroupProps, DocxEditorToolbarNamespace, DocxEditorToolbarProps, DocxEditorToolbarSlotProps, DocxEditorViewportProps, DocxFontOrigin, DocxFontsInput, DocxFontsSource, DocxSource, EditorCaret, EditorCommandState, EditorMode, EditorValueCommandState, FontFamilyItemProps, FontFamilyNamespace, FontFamilyPartProps, FontFamilyProps, FontsInput, HeaderFooterState, HorizontalRulerProps$1 as HorizontalRulerProps, HyperLinkActionProps, HyperLinkPartProps, HyperLinkProps, HyperlinkPopupAnchor, HyperlinkPopupMode, HyperlinkPopupState, ImagePropertiesTriggerProps, IndentUpdate, LocaleProviderProps, MaybeRefOrGetter, MenuActionProps, MenuGroupProps, MenuId, MenuItemBaseProps, MenuItemProps, MenuPartComponent, MenuProps, MenuReportIssueProps, MenuReviewersProps, MenuRowProps, MenuSeparatorProps, MenuSubmenuBaseProps, MenuSubmenuProps, MenuTableGridProps, NavigationPartProps, NavigationShiftInput, NavigationTabProps, NavigationTab$1 as NavigationTabValue, NormalizedImagePayload, NotePropertiesState, OutlineHeading$1 as OutlineHeading, OutlineHeadingItem, PageIndicatorProps, PageSetupDialogFields, PageSetupUpdate, PaginatedDocxEditorExpose, PaginatedDocxEditorHandle, PaginatedDocxEditorProps, PaginatedDocxEditorShellProps, ParagraphStyleItemProps, ParagraphStyleNamespace, ParagraphStyleOption, ParagraphStylePartProps, ParagraphStyleProps, ProvideDocxEditorResult, ReviewGutter, ReviewGutterInput, ReviewRailRegistry, ScopedChromeAnchor, SlotProps, TableBorderColorNamespace, TableBorderStyleNamespace, TableBorderTargetNamespace, TableBorderWidthNamespace, TableCellFillNamespace, TableChromeItemProps, TableChromePartComponent, TableChromePartProps, TextFormFieldDialogFields, ToolbarActionProps, ToolbarAlignmentComponent, ToolbarButtonProps$1 as ToolbarButtonProps, ToolbarContextValue, ToolbarPartComponent, ToolbarPartProps, ToolbarProps, ToolbarReviewersProps, ToolbarSeparatorProps, ToolbarSlotPartComponent, ToolbarSlotPartProps, ToolbarTranslate, UseContentControlResult, UseContentControlWidgetResult, UseDialogReturn, UseDocumentOutlineResult, UseDocumentSearchOptions, UseDocumentSearchResult, UseDocxSourceOptions, UseDocxSourceResult, UseFontFamilyResult, UseHistoryGroupReturn, UseHyperlinkPopupResult, UseNavigationPaneOptions, UseNavigationPaneResult, UsePageSetupDialogReturn, UsePageSetupReturn, UseParagraphDialogReturn, UseParagraphFormatReturn, UseParagraphIndentReturn, UseParagraphStyleResult, UseRevisionMarkupDialogReturn, UseTextFormFieldDialogReturn, UseZoomResult, VerticalRulerProps };
+export { CONTENT_CONTROL_SLOTS, ContextMenuCellVerticalAlignment, ContextMenuCopy, ContextMenuCopyFormatting, ContextMenuCut, ContextMenuDelete, ContextMenuDeleteTable, ContextMenuDeleteTableColumn, ContextMenuDeleteTableRow, ContextMenuInsertColumnLeft, ContextMenuInsertColumnRight, ContextMenuInsertRowAbove, ContextMenuInsertRowBelow, ContextMenuItem, ContextMenuMergeCells, ContextMenuPaste, ContextMenuPasteFormatting, ContextMenuPasteWithoutFormatting, ContextMenuRefreshToc, ContextMenuRefreshTocPageNumbers, ContextMenuSelectAll, ContextMenuSplitCell, DEFAULT_WATERMARK_PRESETS, DocumentName, DocumentOutline, DocxEditor, DocxEditorAuthorStyle, DocxEditorBookmarkDialog, DocxEditorColorByChangeType, DocxEditorContent, DocxEditorContentControl, DocxEditorContentControlWidget, DocxEditorContextMenu, DocxEditorDocumentOutline, DocxEditorEquation, DocxEditorExportDialog, DocxEditorFontNotice, DocxEditorHeaderFooterChrome, DocxEditorHorizontalRuler, DocxEditorHyperLink, DocxEditorImageAltTextPopup, DocxEditorImageInsertErrorDialog, DocxEditorImagePropertiesDialog, DocxEditorInvalidTextFormFieldDialog, DocxEditorLoading, DocxEditorLoadingSpinner, DocxEditorMenu, DocxEditorNavigation, DocxEditorNotePreview, DocxEditorNotePropertiesDialog, DocxEditorNotesChrome, DocxEditorNotesContextMenu, DocxEditorOpenFailure, DocxEditorOpenFailureAction, DocxEditorPageNumber, DocxEditorPageSetupDialog, DocxEditorParagraphDialog, DocxEditorPrintDialog, DocxEditorRevisionMarkup, DocxEditorRevisionMarkupDialog, DocxEditorRoot, DocxEditorShell, DocxEditorSplitCellDialog, DocxEditorTextFormFieldDialog, DocxEditorToolbar, DocxEditorUnsupportedElement, DocxEditorVerticalRuler, DocxEditorViewport, DocxEditorWatermarkDialog, DocxEditorWindow, HorizontalRuler, ImageAltText, ImageInsertProvider, ImageInsertTrigger, ImagePropertiesTrigger, ImageWrap, LocaleProvider, Logo, MenuBar, NAVIGATION_PANE_GAP, NAVIGATION_PANE_INSET, NAVIGATION_PANE_MIN_PAGE_ROOM, NAVIGATION_PANE_WIDTH, NavigationClose, NavigationFind, NavigationGoTo, NavigationHeader, NavigationHeadings, NavigationTab, NavigationTabs, NavigationTitle, NavigationToggle, OUTLINE_BUTTON_LEFT_OFFSET, OUTLINE_BUTTON_RESERVED_SPACE, OUTLINE_LEFT_OFFSET, OUTLINE_RESERVED_SPACE, PageIndicator, PageNumberTranslationContext, PaginatedDocxEditor, PaginatedDocxEditorShell, REVIEW_MARKERS_GUTTER, REVIEW_PANE_GUTTER, RULER_WIDTH, ReviewRailContext, Slot, TitleBar, TitleBarRight, Toolbar, ToolbarButton, ToolbarContext, ToolbarGroup, ToolbarImageProperties, VERSION, VerticalRuler, definePopup, editorStateActiveSubscriptionCount, isFieldLink, navigationPaneOverlays, navigationPaneReservation, navigationShift, normalizeImageBytes, notificationYieldsToTask, useProvidedDocxEditor as provideDocxEditor, reviewGutter, useBookmarkDialog, useBookmarks, useChromeTranslate, useCommentDraftRequest, useContentControl, useContentControlInstance, useContentControlWidget, useContextMenuTarget, useDocumentOutline, useDocumentSearch, useDocxEditor, useDocxSource, useEditorCaret, useEditorCommand, useEditorEvent, useEditorHostDocument, useEditorSnapshot, useEditorState, useEditorValueCommand, useFontFamily, useFonts, useGoToBookmark, useHeaderFooterState, useHighlightAt, useHighlights, useHistoryGroup, useHyperlinkPopup, useHyperlinkPopupInstance, useNavigationPane, useNavigationShift, useNotePropertiesState, useNoteScopeState, useOpenFailure, usePageSetup, usePageSetupDialog, useParagraphDialog, useParagraphFormat, useParagraphIndent, useParagraphStyle, useReviewAuthors, useReviewGutter, useRevisionMarkupDialog, useScopeClassName, useScopedChromeAnchor, useSplitCellDialog, useTableBorderTargetLabel, useTextFormFieldDialog, useToolbarContext, useToolbarLabel, useToolbarLabelFor, useTranslation, useWatermark, useWatermarkDialog, useZoom };
+export type { BookmarkDialogFields, ChromeTranslate, ContentControlActionProps, ContentControlInspectorState, ContentControlLock, ContentControlPartProps, ContentControlProps, ContentControlSlotId, ContentControlWidgetDayProps, ContentControlWidgetEntry, ContentControlWidgetItemProps, ContentControlWidgetPictureProps, ContextMenuAnchor, ContextMenuCommandProps, ContextMenuContextValue, ContextMenuItemProps, ContextMenuTableRowProps, DialogCustomizationProps, DialogPartProps, DocumentStyleSummary, DocxEditorAuthorStyleProps, DocxEditorBookmarkDialogProps, DocxEditorChildren, DocxEditorContentControlNamespace, DocxEditorContentControlWidgetNamespace, DocxEditorContentControlWidgetPartProps, DocxEditorContentControlWidgetProps, DocxEditorContentProps, DocxEditorContextMenuNamespace, DocxEditorContextMenuProps, DocxEditorDocumentOutlineProps, DocxEditorExportDialogProps, DocxEditorFontNoticeProps, DocxEditorHeaderFooterChromeProps, DocxEditorHyperLinkNamespace, DocxEditorImageAltTextPopupProps, DocxEditorImageInsertErrorDialogProps, DocxEditorImagePropertiesDialogProps, DocxEditorInvalidTextFormFieldDialogProps, DocxEditorLoadingComponent, DocxEditorLoadingProps, DocxEditorLoadingSpinnerProps, DocxEditorMenuNamespace, DocxEditorMenuProps, DocxEditorNamespace, DocxEditorNavigationNamespace, DocxEditorNavigationProps, DocxEditorNotePreviewProps, DocxEditorNotePropertiesDialogProps, DocxEditorNotesChromeProps, DocxEditorNotesContextMenuProps, DocxEditorOpenFailureActionProps, DocxEditorOpenFailureComponent, DocxEditorOpenFailureContext, DocxEditorOpenFailureMessage, DocxEditorOpenFailureProps, DocxEditorPageNumberProps, DocxEditorPageSetupDialogProps, DocxEditorParagraphDialogProps, DocxEditorPopup, DocxEditorPopups, DocxEditorPrintDialogProps, DocxEditorProps, DocxEditorRef, DocxEditorRefCallback, DocxEditorRevisionMarkupDialogProps, DocxEditorRevisionMarkupProps, DocxEditorRootListeners, DocxEditorRootProps, DocxEditorRulerProps, DocxEditorSplitCellDialogProps, DocxEditorTextFormFieldDialogProps, DocxEditorToolbarGroupProps, DocxEditorToolbarNamespace, DocxEditorToolbarProps, DocxEditorToolbarSlotProps, DocxEditorUnsupportedElementProps, DocxEditorViewportProps, DocxEditorWatermarkDialogProps, DocxEditorWindowProps, DocxFontOrigin, DocxFontsInput, DocxFontsSource, DocxSource, EditorCaret, EditorCommandState, EditorMode, EditorValueCommandState, FontFamilyItemProps, FontFamilyNamespace, FontFamilyPartProps, FontFamilyProps, FontOption, FontsInput, FormattingAction, GoToBookmarkProblem, HeaderFooterState, HorizontalRulerProps$1 as HorizontalRulerProps, HyperLinkActionProps, HyperLinkPartProps, HyperLinkProps, HyperlinkPopupAnchor, HyperlinkPopupMode, HyperlinkPopupState, ImagePropertiesTriggerProps, IndentUpdate, ListState, ListType, LocaleProviderProps, MaybeRefOrGetter, MenuActionProps, MenuGroupProps, MenuId, MenuItemBaseProps, MenuItemProps, MenuPartComponent, MenuProps, MenuReportIssueProps, MenuReviewersProps, MenuRowProps, MenuSeparatorProps, MenuSubmenuBaseProps, MenuSubmenuProps, MenuTableGridProps, NavigationPartProps, NavigationShiftInput, NavigationTabProps, NavigationTab$1 as NavigationTabValue, NormalizedImagePayload, NotePropertiesState, OutlineHeading$1 as OutlineHeading, OutlineHeadingItem, PageIndicatorProps, PageSetupDialogFields, PageSetupUpdate, PaginatedDocxEditorExpose, PaginatedDocxEditorHandle, PaginatedDocxEditorProps, PaginatedDocxEditorShellProps, ParagraphAlignment, ParagraphStyleItemProps, ParagraphStyleNamespace, ParagraphStyleOption, ParagraphStylePartProps, ParagraphStyleProps, ProvideDocxEditorResult, ReviewGutter, ReviewGutterInput, ReviewRailRegistry, ScopedChromeAnchor, ScopedChromeAnchorPlacement, SelectionFormatting, SlotProps, SplitCellDialogFields, TableAction, TableBorderColorNamespace, TableBorderStyleNamespace, TableBorderTargetNamespace, TableBorderWidthNamespace, TableCellFillNamespace, TableChromeItemProps, TableChromePartComponent, TableChromePartProps, TextFormFieldDialogFields, ToolbarActionProps, ToolbarAlignmentComponent, ToolbarButtonProps$1 as ToolbarButtonProps, ToolbarContextValue, ToolbarPartComponent, ToolbarPartProps, ToolbarProps, ToolbarReviewersProps, ToolbarSeparatorProps, ToolbarSlotPartComponent, ToolbarSlotPartProps, ToolbarTranslate, UseBookmarkDialogReturn, UseBookmarksReturn, UseContentControlResult, UseContentControlWidgetResult, UseDialogReturn, UseDocumentOutlineResult, UseDocumentSearchOptions, UseDocumentSearchResult, UseDocxSourceOptions, UseDocxSourceResult, UseEditorHostDocumentReturn, UseFontFamilyResult, UseGoToBookmarkOptions, UseGoToBookmarkReturn, UseHistoryGroupReturn, UseHyperlinkPopupResult, UseNavigationPaneOptions, UseNavigationPaneResult, UseOpenFailureOptions, UseOpenFailureReturn, UsePageSetupDialogReturn, UsePageSetupReturn, UseParagraphDialogReturn, UseParagraphFormatReturn, UseParagraphIndentReturn, UseParagraphStyleResult, UseRevisionMarkupDialogReturn, UseSplitCellDialogReturn, UseTextFormFieldDialogReturn, UseWatermarkDialogReturn, UseWatermarkReturn, UseZoomResult, VerticalRulerProps, WatermarkDialogFieldName, WatermarkDialogFields, WatermarkDialogKind, WatermarkDialogLayout };