@docx-editor.dev/react 2.17.0 → 2.19.0

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import * as react from 'react';
-import react__default, { ReactNode, CSSProperties, ReactElement, ForwardRefExoticComponent, RefAttributes, HTMLAttributes, Ref } from 'react';
-import { RevisionAuthorStyle, DocxEditorInstance, FontConfigurationFragment, FontResolver, EditorModule, ImageDecodePort, ChromeSlotId, SupportedImageMime, TableChromeSlotId, ChromeMenuId, ChromeMenuEntry, SurfaceHyperlink, FontOrigin, MarkedFontResolver, ReviewAuthorInfo, ImageWrapTarget, TextMeasurer, PaginatedSurfaceState, NavigationCommand, SurfaceFormatting, SectionProperties, RulerIndent } from '@docx-editor.dev/core/editor';
-export { CHROME_GROUPS, CHROME_MENUS, ChromeMenu, ChromeMenuEntry, ChromeMenuId, ChromeMenuItemEntry, ChromeMenuSeparatorEntry, ChromeMenuSubmenuEntry, ChromeSlotId, FontConfigurationBase, FontConfigurationFragment, FontLoadFailure, FontLoadFailureReason, FontOrigin, FontResolutionRequest, FontResolver, FontResolverMark, FontUrlSource, ImageWrapTarget, LOADING_SNAPSHOT, LoadFontsRequest, LoadFontsResult, MAX_RESOLVER_FAMILIES, MarkedFontResolver, PX_PER_CM, PX_PER_INCH, ReviewAuthorInfo, RevisionAuthorAssignments, RevisionAuthorStyle, RevisionStyles, RulerTick, RulerUnit, ToolbarCommandState, WORD_DEFAULT_FONT, chromeMenuSlots, commandForSlot, composeFontConfiguration, composeFontOrigins, createFontSource, defineFontResolver, generateRulerTicks, isFontResolver, loadFonts, rulerPageBox, runToolbarCommand, toolbarCommandState } from '@docx-editor.dev/core/editor';
-import { DocumentSource, FontConfiguration, ZoomMode, Editor, DocumentChange, EditorFontError, TextMatch, ViewScope, DocumentHandle, EditorCommand, EditorScope, ExecResult, EditorSnapshot, EditorEvents, PageSetup, IndentFormatting, ColorValue, Theme } from '@docx-editor.dev/core/contracts/editor';
+import react__default, { ReactNode, ReactElement, CSSProperties, ComponentType, ForwardRefExoticComponent, RefAttributes, HTMLAttributes, Ref } from 'react';
+import { Editor, ViewScope, EditorCommand, DocumentSource, FontConfiguration, ZoomMode, DocumentChange, EditorFontError, TextMatch, DocumentHandle, EditorScope, ExecResult, EditorSnapshot, EditorEvents, PageSetup, IndentFormatting, ColorValue, Theme } from '@docx-editor.dev/core/contracts/editor';
 export { Editor, EditorCommand, EditorFontError, EditorFontErrorCode, EditorQuery, EditorScope, EditorSnapshot, FontConfiguration, FontFaceRequest, FontSource, FontSourceSubstitution, PageSetup } from '@docx-editor.dev/core/contracts/editor';
+import { InvalidTextFormFieldSession, ContentControlWidgetSession, TextFormFieldDialogSession, RevisionAuthorStyle, ParagraphDialogFields, ParagraphDialogMixed, ChromeMenuId, ChromeSlotId, ChromeMenuEntry, DocxEditorInstance, FontConfigurationFragment, FontResolver, EditorModule, ImageDecodePort, SupportedImageMime, TableChromeSlotId, SurfaceHyperlink, FontOrigin, MarkedFontResolver, ReviewAuthorInfo, ImageWrapTarget, ParagraphFormatRead, ParagraphFormatUpdate, TextMeasurer, PaginatedSurfaceState, NavigationCommand, SurfaceFormatting, SectionProperties, RulerIndent } from '@docx-editor.dev/core/editor';
+export { CHROME_GROUPS, CHROME_MENUS, ChromeMenu, ChromeMenuEntry, ChromeMenuId, ChromeMenuItemEntry, ChromeMenuSeparatorEntry, ChromeMenuSubmenuEntry, ChromeSlotId, FontConfigurationBase, FontConfigurationFragment, FontLoadFailure, FontLoadFailureReason, FontOrigin, FontResolutionRequest, FontResolver, FontResolverMark, FontUrlSource, ImageWrapTarget, LOADING_SNAPSHOT, LoadFontsRequest, LoadFontsResult, MAX_RESOLVER_FAMILIES, MarkedFontResolver, PX_PER_CM, PX_PER_INCH, ParagraphFlagState, ParagraphFormatRead, ParagraphFormatUpdate, ParagraphTabStop, ReviewAuthorInfo, RevisionAuthorAssignments, RevisionAuthorStyle, RevisionStyles, RulerTick, RulerUnit, ToolbarCommandState, WORD_DEFAULT_FONT, chromeMenuSlots, commandForSlot, composeFontConfiguration, composeFontOrigins, createFontSource, defineFontResolver, generateRulerTicks, isFontResolver, loadFonts, rulerPageBox, runToolbarCommand, toolbarCommandState } from '@docx-editor.dev/core/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';
@@ -25,6 +25,244 @@ type MaybeRefOrGetter<T> = T;
  */
 type DocxEditorChildren = ReactNode;
 
+/** Note hover preview content and viewport coordinates. @public */
+interface DocxEditorNotePreviewProps {
+    scopeId: string;
+    text: string;
+    x: number;
+    y: number;
+    className?: string;
+}
+/** Default informational note preview. @public */
+declare function DocxEditorNotePreview({ text, x, y, className }: DocxEditorNotePreviewProps): react.JSX.Element;
+/** Note menu target, viewport coordinates, command gates, and actions. @public */
+interface DocxEditorNotesContextMenuProps {
+    scopeId: string;
+    noteKind: 'footnote' | 'endnote';
+    noteId: number;
+    x: number;
+    y: number;
+    onDelete(): void;
+    onConvert(): void;
+    onConvertAll(): void;
+    onOpenProperties(): void;
+    onClose(): void;
+    deleteEnabled: boolean;
+    convertEnabled: boolean;
+    convertAllEnabled: boolean;
+    deleteDisabledReason?: string;
+    convertDisabledReason?: string;
+    convertAllDisabledReason?: string;
+    className?: string;
+}
+/** Default note context menu. @public */
+declare function DocxEditorNotesContextMenu({ noteKind, x, y, onDelete, onConvert, onConvertAll, onOpenProperties, onClose, deleteEnabled, convertEnabled, convertAllEnabled, deleteDisabledReason, convertDisabledReason, convertAllDisabledReason, className, }: DocxEditorNotesContextMenuProps): react.JSX.Element;
+
+/**
+ * Subscribe to the active note view scope with reference-stable results when unchanged.
+ *
+ * @public
+ */
+declare function useNoteScopeState(): Extract<ViewScope, {
+    kind: 'note';
+}> | null;
+type NotePropertiesState = Exclude<ReturnType<Editor['getNotePropertiesState']>, null>;
+/**
+ * Subscribe to `getNotePropertiesState()` with reference-stable results when unchanged.
+ *
+ * @public
+ */
+declare function useNotePropertiesState(): NotePropertiesState | null;
+
+/** Props for `DocxEditor.NotesChrome`. @public */
+interface DocxEditorNotesChromeProps {
+    className?: string;
+}
+declare function DocxEditorNotesChrome({ className, }: DocxEditorNotesChromeProps): ReactElement | null;
+/** Properties actions for a note settings dialog. @public */
+interface DocxEditorNotePropertiesDialogProps {
+    readonly onClose: () => void;
+    readonly onApply: (command: EditorCommand) => void;
+}
+/** Default note properties dialog. @public */
+declare function DocxEditorNotePropertiesDialog(props: DocxEditorNotePropertiesDialogProps): ReactElement;
+
+/** @public */
+interface RefObject<T> {
+    readonly current: T | null;
+}
+
+/** Props for `DocxEditor.ImagePropertiesDialog`. @public */
+interface DocxEditorImagePropertiesDialogProps {
+    open: boolean;
+    onClose: () => void;
+    className?: string;
+    triggerRef?: RefObject<HTMLElement | null>;
+}
+/**
+ * Properties dialog for the selected picture.
+ *
+ * @public
+ */
+declare function DocxEditorImagePropertiesDialog({ open, onClose, className, triggerRef, }: DocxEditorImagePropertiesDialogProps): react.JSX.Element | null;
+/** Props for the toolbar properties trigger. @public */
+interface ImagePropertiesTriggerProps {
+    className?: string;
+    hidden?: boolean;
+    asChild?: boolean;
+    children?: DocxEditorChildren;
+}
+/**
+ * Opens the image properties dialog for the selected drawing.
+ *
+ * @public
+ */
+declare function ImagePropertiesTrigger({ className, hidden, asChild, children, }: ImagePropertiesTriggerProps): react.JSX.Element | null;
+declare namespace ImagePropertiesTrigger {
+    var docxSlot: "image.properties";
+}
+declare const ToolbarImageProperties: typeof ImagePropertiesTrigger & {
+    docxSlot: "image.properties";
+};
+
+/** Props for `DocxEditorToolbar.ImageAltText`. @public */
+interface ImageAltTextProps {
+    className?: string;
+    hidden?: boolean;
+    asChild?: boolean;
+    children?: DocxEditorChildren;
+}
+/**
+ * Opens a small panel to edit image description (and optional title).
+ *
+ * @public
+ */
+declare function ImageAltText({ className, hidden, asChild, children }: ImageAltTextProps): react.JSX.Element | null;
+declare namespace ImageAltText {
+    var docxSlot: "image.altText";
+}
+/** @public */
+interface ImageAltTextPartComponent {
+    (props: ImageAltTextProps): ReactElement | null;
+    readonly docxSlot: 'image.altText';
+}
+/** State and actions for the image alt-text panel. @public */
+interface DocxEditorImageAltTextPopupProps {
+    id: string;
+    value: string;
+    onValueChange(value: string): void;
+    onApply(): void;
+    onClose(): void;
+    isEnabled: boolean;
+    anchorRef?: RefObject<HTMLElement | null>;
+    className?: string;
+}
+/** Default image alt-text panel. @public */
+declare function DocxEditorImageAltTextPopup({ id, value, onValueChange, onApply, onClose, isEnabled, className, }: DocxEditorImageAltTextPopupProps): react.JSX.Element;
+
+/** Invalid-value acknowledgement with editor-owned clearing and focus restoration. @public */
+interface DocxEditorInvalidTextFormFieldDialogProps {
+    session: InvalidTextFormFieldSession;
+    className?: string;
+    style?: CSSProperties;
+    children?: DocxEditorChildren;
+}
+/** Default acknowledgement shell for a custom popup renderer. @public */
+declare function DocxEditorInvalidTextFormFieldDialog(props: DocxEditorInvalidTextFormFieldDialogProps): react.JSX.Element;
+
+/** Value-widget session and optional replacement controls. @public */
+interface DocxEditorContentControlWidgetProps {
+    session: ContentControlWidgetSession;
+    className?: string;
+    style?: CSSProperties;
+    children?: DocxEditorChildren;
+}
+/** Compact value editor for a configured content-control popup. @public */
+declare function DocxEditorContentControlWidget(props: DocxEditorContentControlWidgetProps): react.JSX.Element;
+
+/**
+ * Presentation overrides for a dialog part. @public
+ *
+ * Anything beyond these members reaches the rendered element, so a part takes an `id`,
+ * an `aria-*` label or a `data-*` test hook. The part's own wiring wins every collision:
+ * a host cannot replace Apply's handler or its `data-docx-part` marker by passing one.
+ * To own the element and its handler outright, pass `asChild` and supply your own.
+ */
+interface DialogPartProps {
+    className?: string;
+    style?: CSSProperties;
+    hidden?: boolean;
+    asChild?: boolean;
+    children?: DocxEditorChildren;
+    id?: string;
+    title?: string;
+    'aria-label'?: string;
+    [attribute: `data-${string}`]: unknown;
+}
+/** Layout customization for a packaged dialog. @public */
+interface DialogCustomizationProps {
+    className?: string;
+    style?: CSSProperties;
+    /** Render the default arrangement, replacing named children in place. Defaults to true. */
+    preset?: boolean;
+    children?: DocxEditorChildren;
+}
+/** State shared by a dialog's controls. @public */
+interface UseDialogReturn<Fields extends object> {
+    readonly values: Fields;
+    setValue<K extends keyof Fields>(name: K, value: Fields[K]): void;
+    readonly errors: Readonly<Partial<Record<keyof Fields | 'form', string>>>;
+    readonly isEnabled: boolean;
+    apply(): void;
+    cancel(): void;
+}
+
+/** Draft values for legacy text Field Options. @public */
+interface TextFormFieldDialogFields {
+    defaultText: string;
+    type: string;
+    maxLength: number;
+    format: string;
+    enabled: boolean;
+}
+/** Field Options session and presentation. @public */
+interface DocxEditorTextFormFieldDialogProps extends DialogCustomizationProps {
+    session: TextFormFieldDialogSession | null;
+}
+/** Field Options draft and actions. @public */
+interface UseTextFormFieldDialogReturn extends UseDialogReturn<TextFormFieldDialogFields> {
+}
+/** Read the enclosing Field Options draft. @public */
+declare function useTextFormFieldDialog(): UseTextFormFieldDialogReturn;
+declare function TextFormFieldDialogRoot({ session, ...props }: DocxEditorTextFormFieldDialogProps): react.JSX.Element | null;
+/** Legacy text Field Options with replaceable controls and layout. @public */
+declare const DocxEditorTextFormFieldDialog: typeof TextFormFieldDialogRoot & {
+    Header: (props: DialogPartProps & {
+        name?: keyof TextFormFieldDialogFields | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Title: (props: DialogPartProps & {
+        name?: keyof TextFormFieldDialogFields | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Body: (props: DialogPartProps & {
+        name?: keyof TextFormFieldDialogFields | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Footer: (props: DialogPartProps & {
+        name?: keyof TextFormFieldDialogFields | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Apply: (props: DialogPartProps & {
+        name?: keyof TextFormFieldDialogFields | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Cancel: (props: DialogPartProps & {
+        name?: keyof TextFormFieldDialogFields | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Error: (props: DialogPartProps & {
+        name?: keyof TextFormFieldDialogFields | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Field: (props: DialogPartProps & {
+        name: keyof TextFormFieldDialogFields;
+    }) => react.ReactNode;
+};
+
 /** Props for `DocxEditor.Content`. @public */
 interface DocxEditorContentProps {
     /** Appended after the load-bearing `docx-paginated-surface` class. */
@@ -166,7 +404,8 @@ declare function DocxEditorColorByChangeType(): null;
 /**
  * Props for `DocxEditor.AuthorStyle`: one author, and the {@link RevisionAuthorStyle}
  * fields to apply — `color` (document ink and the review chrome's accent), `background`
- * (the wash), `spanClassName` (classes on the painted spans), and `avatarUrl`.
+ * (the wash), `activeBackground` (the open change's band), `spanClassName` (classes on
+ * the painted spans), and `avatarUrl`.
  *
  * @public
  */
@@ -196,170 +435,251 @@ interface DocxEditorAuthorStyleProps extends RevisionAuthorStyle {
  */
 declare function DocxEditorAuthorStyle(props: DocxEditorAuthorStyleProps): null;
 
+/** A render callback for an automatic popup. `false` disables automatic rendering. @public */
+type DocxEditorPopup<Props extends object> = false | ((props: Props) => DocxEditorChildren | null);
 /**
- * The editor instance from the nearest `DocxEditor.Root`, or `null` before the Root's
- * mount effect has created it (and outside any Root). Deliberately not a throwing
- * variant: pre-mount is a normal frame every consumer renders through, and the state
- * hooks built on this already answer it with a typed loading snapshot.
- *
+ * Register an ordinary component in the `popups` map while preserving its props and hooks.
+ * Define the component outside the parent render function to keep its state on rerenders.
  * @public
  */
-declare function useDocxEditor(): DocxEditorInstance | null;
-/**
- * Whether a review rail is mounted under this Root, and how much room it wants.
- *
- * The GUTTER is the reason this exists. `DocxEditor.Viewport` reserves space beside the
- * page for the pane, and the ruler shifts by the same amount — but neither of them can see
- * whether a rail was actually composed in. Keyed on the pane's open state alone, every
- * consumer of the tier-2 `<DocxEditor>` sugar (which mounts no rail) had its page pushed
- * 158px off centre beside an empty column.
- *
- * A rail registers on mount and unregisters on unmount, so the reservation follows what is
- * really on screen. Count rather than boolean: StrictMode mounts twice, and a host may
- * legitimately compose two rails.
- */
-interface ReviewRailRegistry {
-    readonly mounted: number;
-    readonly register: () => () => void;
-    readonly registerCommentDraft: (handler: () => void) => () => void;
-    readonly requestCommentDraft: () => boolean;
-}
-declare const ReviewRailContext: react.Context<ReviewRailRegistry | null>;
+declare function definePopup<Props extends object>(component: ComponentType<Props>): (props: Props) => DocxEditorChildren;
 
+/** Props for `DocxEditor.PageSetupDialog`. @public */
+interface DocxEditorPageSetupDialogProps 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;
+}
 /**
- * Props for `DocxEditor.Root`. Only `document`, `fonts`, and `imageDecodePort` identity remounts
- * the editor. Later `author`, `locale`, `mode`, `translate`, `zoom`, and `zoomMode` changes use
- * instance setters. `modules` is sampled at mount only.
+ * Page Setup dialog: size preset, orientation, margins in inches. Reads the section
+ * through `usePageSetup()` and applies the whole form as one undoable command.
  *
  * @public
  */
-interface DocxEditorRootProps {
-    /** A document to load: DOCX bytes, `'blank'` for an empty one, or an existing handle.
-     * Identity change remounts; `'blank'` is a constant, so holding it across renders does
-     * not. Omitting this mounts NO document, which is not the same as an empty one. */
-    document?: DocumentSource;
-    /**
-     * Font bytes for Word-accurate (HarfBuzz-shaped) wrap and pagination. Omitted, layout
-     * 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`.
-     */
-    fonts?: FontConfiguration | FontConfigurationFragment | FontResolver;
-    /** Author for later comments, replies, and tracked changes. Changes apply without a remount. */
-    author?: string;
-    /**
-     * BCP-47 locale for regional date input and engine-generated labels. Defaults to en-US.
-     * Changes apply to subsequent edits without a remount; stored date formats are preserved.
-     * For UI translations, wrap Root and its chrome in LocaleProvider with an i18n catalog.
-     */
-    locale?: string;
-    /** Live drawing and form-control labels; defaults to the active catalogue. */
-    translate?: (key: string, params?: Record<string, string | number>) => string;
-    /**
-     * Capability modules to register (`@docx-editor.dev/pro`'s review module, custom nodes,
-     * collaboration). Sampled at mount only because registration is construction-time.
-     */
-    modules?: readonly EditorModule[];
-    /**
-     * The host mode, matching the toolbar's three-state pill. Changes apply without a remount.
-     *
-     * `'edit'` opens in editing even when the document's `w:trackRevisions` asks for
-     * tracked changes; `'suggesting'` opens in suggesting (needs a review module and an
-     * `author`); `'view'` is read-only and the toolbar cannot leave it. Omitted, the
-     * DOCUMENT decides: a package carrying `w:trackRevisions` opens in suggesting.
-     */
-    mode?: 'edit' | 'view' | 'suggesting';
-    /**
-     * A fixed scale. Supplying one also means the mode is fixed, unless `zoomMode` says
-     * otherwise: an app that pinned 100% keeps 100% on every window size.
-     */
-    zoom?: number;
-    /**
-     * Where the scale comes from. Defaults to `'auto'`: fit the page width, between 50% and
-     * 100%, so a window with room for the sheet renders at 100% and a narrower one shrinks
-     * rather than growing a horizontal scrollbar — down to the floor, past which it scrolls.
-     *
-     * A fit tracks the room beside the page, so opening the comments rail or docking the
-     * navigation pane shrinks the document by what it took. Pass `{ type: 'fixed' }` to opt out.
-     */
-    zoomMode?: ZoomMode | 'auto';
-    /** Fired once per instance, after it is published to the tree (and after any
-     *  `DocxEditor.Content` in the same commit has attached its mount point). A large
-     *  document mounts behind one painted frame; `onReady` fires AFTER that mount lands,
-     *  so scrolling or selecting from it works on any document size. */
-    onReady?: (editor: Editor) => void;
-    /** Fired when the document changes (revision + identity deltas, not bytes). */
-    onChange?: (change: DocumentChange) => void;
-    /** Fired with the typed font failure when the shaped-font pipeline rejects. */
-    onFontError?: (error: EditorFontError) => void;
-    /**
-     * Localized labels for table insertion furniture. When omitted, core falls back to
-     * bundled English through {@link defaultTableLabel}.
-     */
-    tableInteractionLabel?: (key: 'table.insertRowBelow' | 'table.insertColumnRight') => string;
-    /** Optional decode port for embedded image insertion and paint in tests or custom hosts. */
-    imageDecodePort?: ImageDecodePort;
-    children?: DocxEditorChildren;
-}
-/** @public Vue-only lifecycle listeners; exported for cross-adapter API parity. */
-interface DocxEditorRootListeners {
-    onReady?: (editor: Editor) => void;
-    onChange?: (change: DocumentChange) => void;
-    onFontError?: (error: EditorFontError) => void;
-}
-/** @public Vue-only setup result; exported for cross-adapter API parity. */
-interface ProvideDocxEditorResult {
-    readonly DocxEditorRoot: typeof DocxEditorRoot;
-    readonly rootProps: Omit<DocxEditorRootProps, keyof DocxEditorRootListeners>;
-    readonly rootListeners: DocxEditorRootListeners;
-    readonly editorRef: ReturnType<typeof useDocxEditor>;
+declare function PageSetupDialogRoot({ open, onClose, className, style, children, preset, }: DocxEditorPageSetupDialogProps): ReactElement | null;
+/** Draft page dimensions and margins use twips. @public */
+interface PageSetupDialogFields {
+    pageWidth: number;
+    pageHeight: number;
+    orientation: 'portrait' | 'landscape';
+    marginTop: number;
+    marginBottom: number;
+    marginLeft: number;
+    marginRight: number;
+    scope: 'document' | 'section';
+}
+/** Page Setup draft and actions. @public */
+interface UsePageSetupDialogReturn extends UseDialogReturn<PageSetupDialogFields> {
+}
+/** Read the enclosing Page Setup dialog draft. @public */
+declare function usePageSetupDialog(): UsePageSetupDialogReturn;
+/** Page Setup with replaceable controls and layout. @public */
+declare const DocxEditorPageSetupDialog: typeof PageSetupDialogRoot & {
+    Header: (props: DialogPartProps & {
+        name?: "pageSize" | "orientation" | "scope" | "marginLeft" | "marginRight" | "marginBottom" | "marginTop" | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Title: (props: DialogPartProps & {
+        name?: "pageSize" | "orientation" | "scope" | "marginLeft" | "marginRight" | "marginBottom" | "marginTop" | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Body: (props: DialogPartProps & {
+        name?: "pageSize" | "orientation" | "scope" | "marginLeft" | "marginRight" | "marginBottom" | "marginTop" | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Footer: (props: DialogPartProps & {
+        name?: "pageSize" | "orientation" | "scope" | "marginLeft" | "marginRight" | "marginBottom" | "marginTop" | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Apply: (props: DialogPartProps & {
+        name?: "pageSize" | "orientation" | "scope" | "marginLeft" | "marginRight" | "marginBottom" | "marginTop" | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Cancel: (props: DialogPartProps & {
+        name?: "pageSize" | "orientation" | "scope" | "marginLeft" | "marginRight" | "marginBottom" | "marginTop" | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Error: (props: DialogPartProps & {
+        name?: "pageSize" | "orientation" | "scope" | "marginLeft" | "marginRight" | "marginBottom" | "marginTop" | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Field: (props: DialogPartProps & {
+        name: "pageSize" | "orientation" | "scope" | "marginLeft" | "marginRight" | "marginBottom" | "marginTop";
+    }) => react.ReactNode;
+};
+
+/** Props for `DocxEditor.ParagraphDialog`. @public */
+interface DocxEditorParagraphDialogProps extends DialogCustomizationProps {
+    /** Whether the dialog is shown. The host owns this state. */
+    open: boolean;
+    /** Called on Cancel, Escape, overlay click, and after a successful OK. */
+    onClose: () => void;
 }
 /**
- * Prepares Root props and listeners while exposing the instance created by that Root.
- * Call this function during render, like a React hook.
+ * The Paragraph dialog. Reads the selection through `useParagraphFormat()` and applies
+ * the whole form as one undoable command.
  *
  * @public
  */
-declare function useProvidedDocxEditor(options: DocxEditorRootProps): ProvideDocxEditorResult;
+declare function ParagraphDialogRoot({ open, onClose, className, style, children, preset, }: DocxEditorParagraphDialogProps): ReactElement | null;
+/** Paragraph dialog draft, mixed values, and actions. @public */
+interface UseParagraphDialogReturn extends UseDialogReturn<ParagraphDialogFields> {
+    readonly mixed: ParagraphDialogMixed;
+}
+/** Read the enclosing Paragraph Options draft. @public */
+declare function useParagraphDialog(): UseParagraphDialogReturn;
+/** Paragraph Options with replaceable controls and layout. @public */
+declare const DocxEditorParagraphDialog: typeof ParagraphDialogRoot & {
+    Header: (props: DialogPartProps & {
+        name?: "alignment" | "special" | "spaceBefore" | "spaceAfter" | "contextualSpacing" | "keepNext" | "keepLines" | "widowControl" | "pageBreakBefore" | "tabStops" | "lineRule" | "indentLeft" | "indentRight" | "specialBy" | "lineValue" | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Title: (props: DialogPartProps & {
+        name?: "alignment" | "special" | "spaceBefore" | "spaceAfter" | "contextualSpacing" | "keepNext" | "keepLines" | "widowControl" | "pageBreakBefore" | "tabStops" | "lineRule" | "indentLeft" | "indentRight" | "specialBy" | "lineValue" | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Body: (props: DialogPartProps & {
+        name?: "alignment" | "special" | "spaceBefore" | "spaceAfter" | "contextualSpacing" | "keepNext" | "keepLines" | "widowControl" | "pageBreakBefore" | "tabStops" | "lineRule" | "indentLeft" | "indentRight" | "specialBy" | "lineValue" | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Footer: (props: DialogPartProps & {
+        name?: "alignment" | "special" | "spaceBefore" | "spaceAfter" | "contextualSpacing" | "keepNext" | "keepLines" | "widowControl" | "pageBreakBefore" | "tabStops" | "lineRule" | "indentLeft" | "indentRight" | "specialBy" | "lineValue" | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Apply: (props: DialogPartProps & {
+        name?: "alignment" | "special" | "spaceBefore" | "spaceAfter" | "contextualSpacing" | "keepNext" | "keepLines" | "widowControl" | "pageBreakBefore" | "tabStops" | "lineRule" | "indentLeft" | "indentRight" | "specialBy" | "lineValue" | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Cancel: (props: DialogPartProps & {
+        name?: "alignment" | "special" | "spaceBefore" | "spaceAfter" | "contextualSpacing" | "keepNext" | "keepLines" | "widowControl" | "pageBreakBefore" | "tabStops" | "lineRule" | "indentLeft" | "indentRight" | "specialBy" | "lineValue" | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Error: (props: DialogPartProps & {
+        name?: "alignment" | "special" | "spaceBefore" | "spaceAfter" | "contextualSpacing" | "keepNext" | "keepLines" | "widowControl" | "pageBreakBefore" | "tabStops" | "lineRule" | "indentLeft" | "indentRight" | "specialBy" | "lineValue" | undefined;
+    }) => string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react.JSX.Element | null;
+    Field: (props: DialogPartProps & {
+        name: "alignment" | "special" | "spaceBefore" | "spaceAfter" | "contextualSpacing" | "keepNext" | "keepLines" | "widowControl" | "pageBreakBefore" | "tabStops" | "lineRule" | "indentLeft" | "indentRight" | "specialBy" | "lineValue";
+    }) => react.ReactNode;
+};
 
-/**
- * Creates and owns a `DocxEditorInstance` and provides it to the subtree. Renders no
- * DOM — compose it with `DocxEditor.Viewport` + `DocxEditor.Content` for the painted
- * pages, and any hook-built chrome anywhere inside.
- *
- * @public
- */
-declare function DocxEditorRoot(props: DocxEditorRootProps): react.JSX.Element;
-
-/** Props for `DocxEditor.Viewport`. @public */
-interface DocxEditorViewportProps {
-    /** Appended after the load-bearing viewport classes (e.g. `dark` for chrome theming). */
+/** Shared props for every part. @public */
+interface HyperLinkPartProps {
     className?: string;
-    style?: CSSProperties;
+    /** Merge this part's wiring onto the single child element instead of the default one. */
+    asChild?: boolean;
+    /** Render nothing — inside the default arrangement this removes the part. */
+    hidden?: boolean;
     children?: DocxEditorChildren;
 }
+/** Props for the action parts, which also take an icon. @public */
+interface HyperLinkActionProps extends HyperLinkPartProps {
+    /** Icon override; falls back to `children`, then to the part's default glyph. */
+    icon?: DocxEditorChildren;
+}
+/** Props for `DocxEditor.HyperLink`. @public */
+interface HyperLinkProps extends HyperLinkPartProps {
+    /**
+     * Render the packaged arrangement. `false` mounts only the popover shell and whatever
+     * parts you pass as children — the rung for "I want the wiring, not the layout".
+     */
+    preset?: boolean;
+}
 /**
- * The sole scroll container for the painted document. Put `DocxEditor.Content` inside
- * it; the engine discovers this element by class and manages scrolling against it.
+ * The popover panel.
+ *
+ * Positioned inside the VIEWPORT (the scroll container), so ordinary CSS keeps it attached to
+ * the page while the user scrolls — no scroll listener, no per-frame reposition. The
+ * coordinates the engine reports are viewport-relative, so they are converted against the
+ * container's own rect once, at open.
+ */
+declare function HyperLinkRoot({ className, asChild, hidden, children, preset }: HyperLinkProps): react.JSX.Element | null;
+/** The target readout, and the action that follows it. @public */
+declare function HyperLinkUrl({ className, asChild, hidden, children }: HyperLinkPartProps): react.JSX.Element | null;
+declare namespace HyperLinkUrl {
+    var docxHyperLinkPart: "Url";
+}
+/** Copy the sanitized target to the clipboard. @public */
+declare function HyperLinkCopy({ className, asChild, hidden, children, icon: glyph, }: HyperLinkActionProps): react.JSX.Element | null;
+declare namespace HyperLinkCopy {
+    var docxHyperLinkPart: "Copy";
+}
+/** Switch the panel into edit mode. @public */
+declare function HyperLinkEdit({ className, asChild, hidden, children, icon: glyph, }: HyperLinkActionProps): react.JSX.Element | null;
+declare namespace HyperLinkEdit {
+    var docxHyperLinkPart: "Edit";
+}
+/** Remove the link, keeping its text. @public */
+declare function HyperLinkUnlink({ className, asChild, hidden, children, icon: glyph, }: HyperLinkActionProps): react.JSX.Element | null;
+declare namespace HyperLinkUnlink {
+    var docxHyperLinkPart: "Unlink";
+}
+/** Display-text and URL fields. @public */
+declare function HyperLinkFields({ className, hidden }: HyperLinkPartProps): react.JSX.Element | null;
+declare namespace HyperLinkFields {
+    var docxHyperLinkPart: "Fields";
+}
+/** Commit the draft. @public */
+declare function HyperLinkApply({ className, asChild, hidden, children }: HyperLinkPartProps): react.JSX.Element | null;
+declare namespace HyperLinkApply {
+    var docxHyperLinkPart: "Apply";
+}
+/**
+ * Why the last Apply did nothing.
+ *
+ * A refusal that closes nothing and says nothing is the worst of both: the panel sits open
+ * and the user re-presses the same button. The engine already knows the reason (a scheme it
+ * will not write, a selection spanning paragraphs, no text to link); this shows it.
+ */
+declare function HyperLinkError({ className, hidden }: HyperLinkPartProps): react.JSX.Element | null;
+declare namespace HyperLinkError {
+    var docxHyperLinkPart: "Error";
+}
+/** Dismiss without applying. @public */
+declare function HyperLinkCancel({ className, asChild, hidden, children }: HyperLinkPartProps): react.JSX.Element | null;
+declare namespace HyperLinkCancel {
+    var docxHyperLinkPart: "Cancel";
+}
+/**
+ * The link popover compound.
  *
  * @public
  */
-declare function DocxEditorViewport({ className, style, children }: DocxEditorViewportProps): react.JSX.Element;
+interface DocxEditorHyperLinkNamespace {
+    (props: HyperLinkProps): ReturnType<typeof HyperLinkRoot>;
+    readonly Url: typeof HyperLinkUrl;
+    readonly Copy: typeof HyperLinkCopy;
+    readonly Edit: typeof HyperLinkEdit;
+    readonly Unlink: typeof HyperLinkUnlink;
+    readonly Fields: typeof HyperLinkFields;
+    readonly Error: typeof HyperLinkError;
+    readonly Apply: typeof HyperLinkApply;
+    readonly Cancel: typeof HyperLinkCancel;
+}
+declare const DocxEditorHyperLink: DocxEditorHyperLinkNamespace;
 
-/** Props for `DocxEditor.Toolbar.Reviewers`. @public */
-type ToolbarReviewersProps = {
+/** Shared props for every part. @public */
+interface ContentControlPartProps {
     className?: string;
+    asChild?: boolean;
     hidden?: boolean;
-    /** Custom trigger icon. */
+    children?: DocxEditorChildren;
+}
+/** Props for action parts that also take an icon. @public */
+interface ContentControlActionProps extends ContentControlPartProps {
     icon?: DocxEditorChildren;
-};
-/** The reviewer visibility menu. It changes view state only. @public */
-declare function ToolbarReviewers({ className, hidden, icon }: ToolbarReviewersProps): react.JSX.Element | null;
-declare namespace ToolbarReviewers {
-    var docxSlot: "review.authors";
 }
+/** Props for `DocxEditor.ContentControl`. @public */
+interface ContentControlProps extends ContentControlPartProps {
+    /**
+     * Render the packaged arrangement. `false` mounts only the shell and whatever parts
+     * you pass as children.
+     */
+    preset?: boolean;
+}
+declare function ContentControlRoot({ className, asChild, hidden, children, preset, }: ContentControlProps): react.JSX.Element | null;
+declare function ContentControlHeader({ className, asChild, hidden, children }: ContentControlPartProps): react.JSX.Element | null;
+declare function ContentControlFields({ className, asChild, hidden, children }: ContentControlPartProps): react.JSX.Element | null;
+declare function ContentControlRemove({ className, asChild, hidden, icon: iconOverride, children, }: ContentControlActionProps): react.JSX.Element | null;
+/**
+ * The content-control inspector compound. Parts live on the namespace statics.
+ *
+ * @public
+ */
+interface DocxEditorContentControlNamespace {
+    (props: ContentControlProps): ReturnType<typeof ContentControlRoot>;
+    readonly Header: typeof ContentControlHeader;
+    readonly Fields: typeof ContentControlFields;
+    readonly Remove: typeof ContentControlRemove;
+}
+declare const DocxEditorContentControl: DocxEditorContentControlNamespace;
 
 /** Resolves an i18n key to display text. @public */
 type ToolbarTranslate = (key: string) => string;
@@ -380,1798 +700,1738 @@ declare function useToolbarLabelFor(t: ToolbarTranslate | undefined): (key: stri
 /** The label for an i18n key: the host's translation, else the locale catalogue. */
 declare function useToolbarLabel(): (key: string) => string;
 
-/** Props for `DocxEditorToolbar.Button`. @public */
-interface ToolbarButtonProps$1 {
-    /** The chrome slot this button drives (`'text.bold'`, `'history.undo'`, ...). */
-    slot: ChromeSlotId;
-    /** Icon override; falls back to `children`, then to the registry's icon paths. */
-    icon?: DocxEditorChildren;
-    /** Merge the button's behavior into the single child element instead of a <button>. */
-    asChild?: boolean;
-    className?: string;
-    children?: DocxEditorChildren;
-    /** Render nothing — inside the default arrangement this removes the slot. */
-    hidden?: boolean;
-}
 /**
- * One chrome slot as a live toolbar button: enabled/active from the engine's
- * can-before-exec answer, labelled from the registry's i18n key, `data-active` /
- * `data-disabled` presence attributes for styling, `aria-pressed` on toggles.
+ * A menu's identity: one of the registry's five, or a HOST'S OWN.
+ *
+ * The `(string & {})` arm keeps the registry ids as editor autocomplete while accepting
+ * any other string, so a product can add "Review" or "Clauses" without the library having
+ * to know about it. Lives here rather than in `parts` because the bar's open/active state
+ * is keyed on it and both modules read that state.
  *
  * @public
  */
-declare function ToolbarButton$1(props: ToolbarButtonProps$1): react.JSX.Element | null;
-declare namespace ToolbarButton$1 {
-    var docxToolbarPart: true;
-}
+type MenuId = ChromeMenuId | (string & {});
 
-interface ImageInsertProviderProps {
-    children: ReactNode;
-}
-declare function ImageInsertProvider({ children }: ImageInsertProviderProps): react.JSX.Element;
-/** Props for the toolbar/menu insert trigger. @public */
-interface ImageInsertTriggerProps {
+/** Props for `DocxEditor.Menu.Row`: one presentational menu row. @public */
+interface MenuRowProps {
+    /** Material Symbols paths, rendered as inline SVG in the row's icon column. */
+    icon?: DocxEditorChildren;
+    /** Right-aligned shortcut text (already resolved). */
+    shortcut?: string;
+    disabled?: boolean;
+    /**
+     * Tooltip. Set it for the ENGINE's disabled reason and nothing else — a menu row's text
+     * is already visible, so a tooltip repeating it is noise, and inventing a reason for a
+     * refusal the engine explained is the thing this codebase does not do.
+     */
+    title?: string;
+    /**
+     * Checked state, for a row that TOGGLES (bold on bold text). Leave undefined on a row
+     * that just acts: `menuitemcheckbox` with `aria-checked="false"` announces "not
+     * selected" on a Page break row, which is a claim about state it does not have.
+     */
+    active?: boolean;
+    /**
+     * Present on a row belonging to a MUTUALLY EXCLUSIVE set (the four alignments), which
+     * makes it `menuitemradio` rather than `menuitemcheckbox`. Four independent checkboxes
+     * is a different claim from one-of-four, and a screen reader reads it as such.
+     */
+    selected?: true;
+    /** Stable marker for hosts, tests and e2e. */
+    slot?: string;
+    /**
+     * What the slot currently SHOWS, for a control whose state is more than pressed-or-not —
+     * the format painter's `once` against its `locked`. Declared rather than left to a spread:
+     * this component renders only the props it names, so an undeclared attribute is dropped in
+     * silence, and the stylesheet rule keyed on it can never match.
+     */
+    'data-value'?: string;
+    /**
+     * Vue TSX maps row identity through `rowSlot` because `slot` is reserved.
+     * React uses {@link slot} directly.
+     */
+    rowSlot?: string;
+    onSelect?: () => void;
+    /**
+     * Vue TSX binds row activation through `selectHandler` because `onSelect`
+     * is treated as a listener. React uses {@link onSelect} directly.
+     */
+    selectHandler?: () => void;
     className?: string;
-    hidden?: boolean;
-    asChild?: boolean;
     children?: DocxEditorChildren;
 }
-/** Toolbar insert-image control — opens the shared file picker. @public */
-declare function ImageInsertTrigger({ className, hidden, asChild, children, }: ImageInsertTriggerProps): react.JSX.Element | null;
-declare namespace ImageInsertTrigger {
-    var docxSlot: "image.insert";
-}
-
-/** Props for `DocxEditorToolbar.ImageWrap`. @public */
-interface ImageWrapProps {
+/**
+ * One menu row: icon column, label, shortcut column.
+ *
+ * The icon column is reserved even when a row has no icon, so labels line up down the
+ * panel the way Word's and Docs' menus do.
+ *
+ * @public
+ */
+declare function MenuRow(props: MenuRowProps): react.JSX.Element;
+/** Props for `DocxEditor.Menu.Group`: a titled section of rows. @public */
+interface MenuGroupProps {
+    /** Literal heading, already resolved. Wins over {@link labelKey}. */
+    label?: string;
+    /** i18n key of the heading. */
+    labelKey?: string;
     className?: string;
     hidden?: boolean;
-    asChild?: boolean;
     children?: DocxEditorChildren;
 }
 /**
- * Wrap-text dropdown presenting all nine Word choices.
+ * A named section inside a panel: a visible heading and the rows under it.
+ *
+ * A separator says rows are apart; a group says what they are, which is what a panel needs
+ * once a product adds rows beside the packaged ones. `role="group"` nests legally inside a
+ * menu, keeps its rows owned by it, and takes the heading as its accessible name — so the
+ * visible heading is decoration and is hidden from the tree.
  *
  * @public
  */
-declare function ImageWrap({ className, hidden, asChild, children }: ImageWrapProps): react.JSX.Element | null;
-declare namespace ImageWrap {
-    var docxSlot: "image.wrap";
-}
-/** @public */
-interface ImageWrapPartComponent {
-    (props: ImageWrapProps): ReactElement | null;
-    readonly docxSlot: 'image.wrap';
-}
-
-/** Props for `DocxEditorToolbar.ImageAltText`. @public */
-interface ImageAltTextProps {
+declare function MenuGroup({ label: literal, labelKey, className, hidden, children, }: MenuGroupProps): react.JSX.Element | null;
+/** Props for `DocxEditor.Menu.Item`: one chrome slot as a menu row. @public */
+interface MenuItemProps {
+    /** The chrome slot this row drives (`'text.bold'`, `'insert.pageBreak'`, …). */
+    slot: ChromeSlotId;
+    /** Plain-label i18n key, overriding the slot's tooltip-shaped one. */
+    labelKey?: string;
+    /** i18n key of the shortcut shown in the right column. */
+    shortcutKey?: string;
     className?: string;
+    /** Render nothing — inside a packaged menu this removes the row. */
     hidden?: boolean;
-    asChild?: boolean;
-    children?: DocxEditorChildren;
 }
 /**
- * Opens a small panel to edit image description (and optional title).
+ * One chrome slot as a live menu row: enabled and active from the engine's
+ * can-before-exec answer, labelled and iconed from the registry. Selecting it runs the
+ * slot's command and closes the menu.
  *
  * @public
  */
-declare function ImageAltText({ className, hidden, asChild, children }: ImageAltTextProps): react.JSX.Element | null;
-declare namespace ImageAltText {
-    var docxSlot: "image.altText";
-}
-/** @public */
-interface ImageAltTextPartComponent {
-    (props: ImageAltTextProps): ReactElement | null;
-    readonly docxSlot: 'image.altText';
-}
-
-/** @public */
-interface RefObject<T> {
-    readonly current: T | null;
+declare function MenuItem({ slot, labelKey, shortcutKey, className, hidden }: MenuItemProps): react.JSX.Element | null;
+declare namespace MenuItem {
+    var docxMenuRow: true;
 }
-
-/** Props for `DocxEditor.ImagePropertiesDialog`. @public */
-interface DocxEditorImagePropertiesDialogProps {
-    open: boolean;
-    onClose: () => void;
+/** Props for the pinned File rows. @public */
+interface MenuActionProps {
     className?: string;
-    triggerRef?: RefObject<HTMLElement | null>;
+    hidden?: boolean;
 }
+declare const MenuOpen: (({ className, hidden }: MenuActionProps) => react.JSX.Element | null) & {
+    docxSlot: ChromeSlotId;
+};
+declare const MenuSave: (({ className, hidden }: MenuActionProps) => react.JSX.Element | null) & {
+    docxSlot: ChromeSlotId;
+};
 /**
- * Properties dialog for the selected picture.
- *
- * @public
+ * Page setup. Unlike open and save, the ENGINE has an opinion here — `setPageSetup` is a
+ * real command, it just needs the dialog's values — 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 DocxEditorImagePropertiesDialog({ open, onClose, className, triggerRef, }: DocxEditorImagePropertiesDialogProps): react.JSX.Element | null;
-/** Props for the toolbar properties trigger. @public */
-interface ImagePropertiesTriggerProps {
+declare function MenuPageSetupImpl({ className, hidden }: MenuActionProps): react.JSX.Element | null;
+declare const MenuPageSetup: typeof MenuPageSetupImpl & {
+    docxSlot: ChromeSlotId;
+};
+declare function MenuImageInsertImpl({ className, hidden }: MenuActionProps): react.JSX.Element | null;
+declare const MenuImageInsert: typeof MenuImageInsertImpl & {
+    docxSlot: ChromeSlotId;
+};
+interface MenuSubmenuProps {
+    /** i18n key of the parent row's label. */
+    labelKey: string;
+    /** Material Symbols paths for the parent row's icon. */
+    paths?: readonly string[] | null;
     className?: string;
-    hidden?: boolean;
-    asChild?: boolean;
     children?: DocxEditorChildren;
 }
 /**
- * Opens the image properties dialog for the selected drawing.
+ * A row that opens a nested panel to its right (Insert › Break).
+ *
+ * The parent row runs nothing — disclosure is not a command — so it stays interactive
+ * regardless of what its children can do, and each child answers for itself. Opening on
+ * hover AND on click is what both Word and Docs do; keyboard users get the same panel
+ * through focus.
  *
  * @public
  */
-declare function ImagePropertiesTrigger({ className, hidden, asChild, children, }: ImagePropertiesTriggerProps): react.JSX.Element | null;
-declare namespace ImagePropertiesTrigger {
-    var docxSlot: "image.properties";
-}
-declare const ToolbarImageProperties: typeof ImagePropertiesTrigger & {
-    docxSlot: "image.properties";
-};
-
-type NormalizedImagePayload = {
-    readonly ok: true;
-    readonly bytes: Uint8Array;
-    readonly mime: SupportedImageMime;
-    readonly widthPoints: number;
-    readonly heightPoints: number;
-} | {
-    readonly ok: false;
-    /** i18n key under `imageInsert.errors.*` suitable for `t()`. */
-    readonly reasonKey: string;
-};
-/** Preflight raster bytes for insert/replace. Never allocates from file-supplied dimensions alone. */
-declare function normalizeImageBytes(bytes: Uint8Array): NormalizedImagePayload;
-
-/** Props for the named parts (`DocxEditorToolbar.Bold`, ...): the slot is pinned. @public */
-type ToolbarPartProps = Omit<ToolbarButtonProps$1, 'slot'>;
-interface ToolbarPartComponent {
-    (props: ToolbarPartProps): ReturnType<typeof ToolbarButton$1>;
-    readonly docxSlot: ChromeSlotId;
+declare function MenuSubmenu({ labelKey, paths, className, children }: MenuSubmenuProps): react.JSX.Element;
+/** Props for `DocxEditor.Menu.TableGrid`. @public */
+interface MenuTableGridProps {
+    /** The slot the picked size dispatches through. Defaults to `table.insert`. */
+    slot?: ChromeSlotId;
+    className?: string;
 }
 /**
- * Props for the non-button parts (pickers, steppers, color splits, save). @public
+ * Word's insert-table size picker: a 6×6 grid that highlights as the pointer sweeps it
+ * and reads back the size underneath.
+ *
+ * Rendered only when the engine will honour an insert (see `MenuTablePicker`). A panel
+ * that opens onto a grid nothing can be picked from is worse than no panel: the row
+ * cannot act, so it should not disclose — it should look disabled, like every other row
+ * the engine refuses.
+ *
+ * @public
  */
-interface ToolbarSlotPartProps {
-    className?: string;
-    /** Render nothing — inside the default arrangement this removes the slot. */
-    hidden?: boolean;
-}
-/** A non-button part pinned to one slot. @public */
-interface ToolbarSlotPartComponent {
-    (props: ToolbarSlotPartProps): ReturnType<typeof ToolbarButton$1>;
-    readonly docxSlot: ChromeSlotId;
-}
-/** Props for `DocxEditorToolbar.Separator`. @public */
-interface ToolbarSeparatorProps {
+declare function MenuTableGrid({ slot, className }: MenuTableGridProps): react.JSX.Element;
+/** Props for `DocxEditor.Menu.Separator`. @public */
+interface MenuSeparatorProps {
     className?: string;
 }
-/** A vertical rule between toolbar groups. @public */
-declare function ToolbarSeparator({ className }: ToolbarSeparatorProps): react.JSX.Element;
-
+/** A horizontal rule between groups of rows. @public */
+declare function MenuSeparator({ className }: MenuSeparatorProps): react.JSX.Element;
 /**
- * Props for the split colour controls. @public
+ * One registry entry as its row.
  *
- * The one addition over a plain slot part is `icon`, and it belongs here rather than on
- * `ToolbarSlotPartProps`: the other slot parts are steppers and pickers with no single glyph
- * to replace, so an icon prop on the shared type would be a promise three of them could not
- * keep.
+ * The three host-boundary slots route to their pinned parts rather than to the generic
+ * `MenuItem`, because a command-driven row would render them permanently disabled — the
+ * engine reports, correctly, that neither open nor save is a command.
  */
-interface ToolbarColorSplitProps extends ToolbarSlotPartProps {
+declare function MenuEntry({ entry }: {
+    entry: ChromeMenuEntry;
+}): react.JSX.Element;
+/** Props for `DocxEditor.Menu.Menu` and the five pinned menu parts. @public */
+interface MenuProps {
+    /** Which menu this is. Only one panel in the bar is open at a time, keyed on this. */
+    id: MenuId;
+    /** i18n key of the trigger label. Defaults to the registry's. */
+    labelKey?: string;
     /**
-     * Replaces the glyph above the colour bar — the registry's red "A" or highlighter pen.
-     *
-     * The BAR is not replaceable and still paints the live value, so a host swapping the glyph
-     * keeps the thing that makes this control readable at a glance.
+     * Literal trigger label, already resolved. Wins over `labelKey`, and is what a
+     * host-defined menu uses — its name is not in our catalogue and never will be.
      */
-    icon?: DocxEditorChildren;
-}
-/** A split colour control pinned to one slot. @public */
-interface ToolbarColorSplitComponent {
-    (props: ToolbarColorSplitProps): ReturnType<typeof ToolbarButton$1>;
-    readonly docxSlot: ChromeSlotId;
-}
-
-/** The merged part is keyed by its GROUP id — it stands in for all four slots. */
-interface ToolbarAlignmentComponent {
-    (props: ToolbarSlotPartProps): ReturnType<typeof ToolbarAlignmentImpl>;
-    readonly docxSlot: 'alignment';
-}
-declare function ToolbarAlignmentImpl({ className, hidden }: ToolbarSlotPartProps): react.JSX.Element | null;
-
-/** Props for `DocxEditorToolbar.Action`. @public */
-interface ToolbarActionProps {
+    label?: string;
     /**
-     * Accessible name and tooltip. A resolved STRING, not an i18n key: the label belongs to
-     * the host's own action, so the host's own catalogue resolves it. (Registry controls go
-     * the other way — they carry keys and the toolbar's `t` resolves them.)
+     * Icon shown before the trigger's label.
+     *
+     * OPT-IN and unset by default, because neither Word nor Docs puts icons on a menu bar and
+     * the packaged bar should look like the thing it is imitating. It exists because every
+     * other control in this library takes one — toolbar parts, menu rows — and a product with
+     * its own visual language should not have to rebuild the trigger to add a glyph to it.
+     *
+     * Decorative: the label is the accessible name, so the icon is hidden from assistive tech.
      */
-    label: string;
-    /** Icon content. Inline SVG sized ~18px matches the packaged controls. */
     icon?: DocxEditorChildren;
-    /** Pressed state, for an action that toggles. Sets `aria-pressed` and `data-active`. */
-    active?: boolean;
-    disabled?: boolean;
-    /** Tooltip when disabled — say why, the way the engine's controls do. */
-    disabledReason?: string;
-    onSelect?: () => void;
-    /** Merge the behavior onto the single child element instead of rendering a `<button>`. */
-    asChild?: boolean;
     className?: string;
+    /** Render nothing — inside the default bar this removes the menu. */
+    hidden?: boolean;
+    /**
+     * `false` renders `children` verbatim as the whole panel. Default `true`: the panel is
+     * the registry's rows for this menu, with a row child REPLACING the row it names in
+     * place (`hidden` removes it) and any other child appended. Use `false` when the order
+     * matters and you want to state it yourself.
+     */
+    preset?: boolean;
+    /** Panel content. */
     children?: DocxEditorChildren;
 }
 /**
- * A host-owned toolbar action, styled and behaved like the packaged controls.
+ * One menu of the bar: a trigger and the panel it opens.
  *
- * Renders inside `<DocxEditor.Toolbar>` after the default arrangement (it drives no slot,
- * so it is an appended child), or anywhere under `preset={false}`.
+ * Bar behaviour is Docs': a click opens, a second click closes, and while ANY menu is
+ * open, moving the pointer over a different trigger switches to it without a click.
  *
  * @public
  */
-declare function ToolbarAction(props: ToolbarActionProps): react.JSX.Element;
-
-/** What `useFontFamily` answers. @public */
-interface UseFontFamilyResult {
-    /** The selection's agreed family, or null (mixed selection, or no document). */
-    readonly value: string | null;
-    /** Apply a family through the can-before-exec path; a refusal is a safe no-op. */
-    readonly setValue: (family: string) => void;
-    /**
-     * The offerable font catalog (validated, deduplicated, sorted): the editor's
-     * configured families merged with the document's declared ones.
-     */
-    readonly options: readonly string[];
-    /** Whether the engine would honour a font change right now. */
-    readonly isEnabled: boolean;
+declare function Menu({ id, labelKey, label: literal, icon, className, hidden, preset, children, }: MenuProps): react.JSX.Element | null;
+/** A menu pinned to one registry id, for `DocxEditor.Menu.File` and friends. @public */
+interface MenuPartComponent {
+    (props: Omit<MenuProps, 'id'>): ReactNode;
+    readonly docxMenu: ChromeMenuId;
+}
+/** Props for `DocxEditor.Menu.ReportIssue`. @public */
+interface MenuReportIssueProps {
+    className?: string;
+    /** Render nothing — inside the packaged Help menu this removes the row. */
+    hidden?: boolean;
+    /** Replaces the packaged handler. Falls back to the menu's `onReportIssue`, then to
+     *  this project's own tracker. */
+    onSelect?: () => void;
 }
 /**
- * The font-family picker's behavior, UI-free.
+ * Help › Report issue.
+ *
+ * A NAMED part rather than anonymous markup inside the Help menu, because it is the one
+ * packaged row that reaches OUTSIDE the host's product: it opens this project's issue
+ * tracker with the current page URL and user agent prefilled. A host embedding the editor
+ * in its own app has every reason to point that somewhere else or drop it, and it should
+ * not have to rebuild the menu to do either — `reportIssue={false}` removes it,
+ * `onReportIssue` redirects it, and this part composes it back by name.
  *
  * @public
  */
-declare function useFontFamily(): UseFontFamilyResult;
-/** Props for `DocxEditorToolbar.FontFamily` and its sub-parts. @public */
-interface FontFamilyPartProps {
-    asChild?: boolean;
-    className?: string;
-    children?: DocxEditorChildren;
-}
-/** Props for the compound root. @public */
-interface FontFamilyProps extends FontFamilyPartProps {
-    /** Render nothing — inside the default arrangement this removes the slot. */
-    hidden?: boolean;
-}
-/** Props for `FontFamily.Item`. @public */
-interface FontFamilyItemProps extends FontFamilyPartProps {
-    /** The family this item applies. */
-    value: string;
-}
-declare function FontFamilyTrigger({ asChild, className, children }: FontFamilyPartProps): react.JSX.Element | null;
-declare namespace FontFamilyTrigger {
-    var docxToolbarPart: true;
-}
-declare function FontFamilyContent({ asChild, className, children }: FontFamilyPartProps): react.JSX.Element | null;
-declare function FontFamilyItem({ value, asChild, className, children }: FontFamilyItemProps): react.JSX.Element | null;
-/** The compound part with its sub-parts attached as statics. @public */
-interface FontFamilyNamespace {
-    (props: FontFamilyProps): ReactNode;
-    readonly docxSlot: 'font.family';
-    readonly Trigger: typeof FontFamilyTrigger;
-    readonly Content: typeof FontFamilyContent;
-    readonly Item: typeof FontFamilyItem;
-}
-declare const FontFamily: FontFamilyNamespace;
-
-/** One pickable paragraph style, as the document defines it. @public */
-interface ParagraphStyleOption {
-    readonly styleId: string;
-    readonly name: string;
-    /**
-     * How the style looks, for rendering the row in its own face. Every value arrives
-     * already bounded by the engine's derivation (family against the CSS-sink shape, colour
-     * against six hex digits), which is what makes it safe to put in a style object.
-     */
-    readonly preview: {
-        readonly fontFamily: string | null;
-        readonly fontSizePt: number | null;
-        readonly bold: boolean;
-        readonly italic: boolean;
-        readonly color: string | null;
-    };
-}
-/** What `useParagraphStyle` answers. @public */
-interface UseParagraphStyleResult {
-    /** The selection's agreed paragraph styleId, or null (unstyled/default, or mixed). */
-    readonly value: string | null;
-    /** Apply a paragraph style through the can-before-exec path; a refusal is a safe no-op. */
-    readonly setValue: (styleId: string) => void;
-    /**
-     * The document's paragraph styles — validated ids and display names, in the engine's
-     * Word-gallery order (Normal, Title, Subtitle, the headings, then everything else in
-     * document order), NOT the order `styles.xml` happens to list them in.
-     */
-    readonly options: readonly ParagraphStyleOption[];
-    /** Whether the engine would honour a style change right now. */
-    readonly isEnabled: boolean;
-}
+declare function MenuReportIssueImpl({ className, hidden, onSelect }: MenuReportIssueProps): react.JSX.Element | null;
 /**
- * The paragraph-style picker's behavior, UI-free.
+ * The report-issue row, with its row-identity marker.
+ *
+ * The key is NOT a `ChromeSlotId` — the row is React's, not the shared registry's — but the
+ * merge only needs a stable string, and using one here is what lets a host write
+ * `<Menu.ReportIssue hidden/>` and have it REPLACE the packaged row rather than render a
+ * second, invisible one beside it.
  *
  * @public
  */
-declare function useParagraphStyle(): UseParagraphStyleResult;
-/** Props for `DocxEditorToolbar.StylePicker` and its sub-parts. @public */
-interface ParagraphStylePartProps {
-    asChild?: boolean;
-    className?: string;
-    children?: DocxEditorChildren;
-}
-/** Props for the compound root. @public */
-interface ParagraphStyleProps extends ParagraphStylePartProps {
-    /** Render nothing — inside the default arrangement this removes the slot. */
-    hidden?: boolean;
-}
-/** Props for `ParagraphStyle.Item`. @public */
-interface ParagraphStyleItemProps extends ParagraphStylePartProps {
-    /** The styleId this item applies. */
-    value: string;
-}
-declare function ParagraphStyleTrigger({ asChild, className, children }: ParagraphStylePartProps): react.JSX.Element | null;
-declare namespace ParagraphStyleTrigger {
-    var docxToolbarPart: true;
-}
-declare function ParagraphStyleContent({ asChild, className, children }: ParagraphStylePartProps): react.JSX.Element | null;
-declare function ParagraphStyleItem({ value, asChild, className, children }: ParagraphStyleItemProps): react.JSX.Element | null;
-/** The compound part with its sub-parts attached as statics. @public */
-interface ParagraphStyleNamespace {
-    (props: ParagraphStyleProps): ReactNode;
-    readonly docxSlot: 'styles.style';
-    readonly Trigger: typeof ParagraphStyleTrigger;
-    readonly Content: typeof ParagraphStyleContent;
-    readonly Item: typeof ParagraphStyleItem;
-}
-declare const ParagraphStyle: ParagraphStyleNamespace;
+declare const MenuReportIssue: typeof MenuReportIssueImpl & {
+    docxSlot: string;
+};
 
-/** Props shared by contextual table toolbar compound parts. @public */
-interface TableChromePartProps {
-    /** Appended to the part root class list. */
+/** Props for a packaged context-menu row. @public */
+interface ContextMenuCommandProps {
+    /** Icon override. Defaults to the row's own Material Symbol. */
+    icon?: DocxEditorChildren;
+    /** i18n key for the label, overriding the packaged one. */
+    labelKey?: string;
+    /** i18n key for the shortcut column, overriding the packaged one. */
+    shortcutKey?: string;
     className?: string;
-    /** When true, the part renders nothing. */
+    /** Render nothing — inside the default set this removes the row. */
     hidden?: boolean;
-    /** Merge props onto the single child element instead of rendering a default host node. */
-    asChild?: boolean;
-    /** Custom panel body or trigger label; defaults to the packaged control chrome. */
-    children?: DocxEditorChildren;
-}
-/** Props for a value-driven row or swatch inside a table compound menu. @public */
-interface TableChromeItemProps extends TableChromePartProps {
-    /** The pick value this item dispatches (target id, style name, width size, or hex without `#`). */
-    value: string;
 }
+/** Cut the selection to the clipboard. Disabled with the engine's reason when nothing is selected. @public */
+declare const ContextMenuCut: (({ icon, labelKey, shortcutKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
+    docxRow: string;
+};
+/** Copy the selection. Stays available in a read-only document. @public */
+declare const ContextMenuCopy: (({ icon, labelKey, shortcutKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
+    docxRow: string;
+};
+/** Delete the selection. @public */
+declare const ContextMenuDelete: (({ icon, labelKey, shortcutKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
+    docxRow: string;
+};
+/** Select the whole body. @public */
+declare const ContextMenuSelectAll: (({ icon, labelKey, shortcutKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
+    docxRow: string;
+};
 /**
- * Shared compound contract for menu-style table chrome parts
- * ({@link TableBorderTargetNamespace}, {@link TableBorderStyleNamespace}, {@link TableBorderWidthNamespace}).
+ * Paste the clipboard's text at the selection.
  *
- * @public
- */
-interface TableChromePartComponent extends ToolbarSlotPartComponent {
-    /** The chrome slot this compound drives. */
-    readonly docxSlot: TableChromeSlotId;
-    /** Opens the picker menu or dialog. */
-    readonly Trigger: (props: TableChromePartProps) => DocxEditorChildren;
-    /** The open menu or dialog panel; omit to use the default item list. */
-    readonly Content: (props: TableChromePartProps) => DocxEditorChildren;
-    /** One selectable value row or swatch inside {@link Content}. */
-    readonly Item: (props: TableChromeItemProps) => DocxEditorChildren;
-}
-/**
- * Border-target picker compound (`DocxEditor.Toolbar.TableBorderTarget`).
+ * THE ROW READS THE CLIPBOARD, not the engine. `exec` is synchronous and clipboard read is
+ * not — it prompts in Chrome and is refused outright by Firefox and Safari — so the read
+ * happens here, inside the click that asked for it, where the permission gesture belongs,
+ * and the text goes to the engine as an argument.
  *
- * @public
- */
-interface TableBorderTargetNamespace extends TableChromePartComponent {
-    /** Chrome slot id: `table.borderTarget`. */
-    readonly docxSlot: 'table.borderTarget';
-    /** Button that opens the border-edge target menu. */
-    readonly Trigger: (props: TableChromePartProps) => DocxEditorChildren;
-    /** Open menu listing edge scopes and clear. */
-    readonly Content: (props: TableChromePartProps) => DocxEditorChildren;
-    /** One edge scope or clear row inside the target menu. */
-    readonly Item: (props: TableChromeItemProps) => DocxEditorChildren;
-}
-/**
- * Border-colour split compound with a quick-apply main button and swatch dialog
- * (`DocxEditor.Toolbar.TableBorderColor`).
+ * Nothing can know whether the read will succeed BEFORE it is attempted, so the row starts
+ * enabled (when the engine would accept a paste at all) and disables itself, with the
+ * browser's own reason, once a read has actually been refused. Guessing the answer up front
+ * would either grey out a working Paste on Chrome or advertise a dead one on Safari.
  *
  * @public
  */
-interface TableBorderColorNamespace extends TableChromePartComponent {
-    /** Chrome slot id: `table.borderColor`. */
-    readonly docxSlot: 'table.borderColor';
-    /** Applies the last swatch without opening the dialog. */
-    readonly Main: (props: TableChromePartProps) => DocxEditorChildren;
-    /** Button that opens the border-colour swatch dialog. */
-    readonly Trigger: (props: TableChromePartProps) => DocxEditorChildren;
-    /** Open swatch dialog for the active border target. */
-    readonly Content: (props: TableChromePartProps) => DocxEditorChildren;
-    /** One colour swatch inside the border-colour dialog. */
-    readonly Item: (props: TableChromeItemProps) => DocxEditorChildren;
+declare function ContextMenuPaste({ icon, labelKey, shortcutKey, className, hidden, }: ContextMenuCommandProps): react.JSX.Element | null;
+declare namespace ContextMenuPaste {
+    var docxRow: "edit.paste";
 }
 /**
- * Cell-fill split compound (`DocxEditor.Toolbar.TableCellFill`).
+ * Paste the clipboard's plain text as if typed, whatever richer flavours it holds.
+ *
+ * The Cmd+Shift+V twin as a menu row: same clipboard-read contract as
+ * {@link ContextMenuPaste}, routed through the `pasteWithoutFormatting` command.
  *
  * @public
  */
-interface TableCellFillNamespace extends TableChromePartComponent {
-    /** Chrome slot id: `table.cellFill`. */
-    readonly docxSlot: 'table.cellFill';
-    /** Applies the last swatch without opening the dialog. */
-    readonly Main: (props: TableChromePartProps) => DocxEditorChildren;
-    /** Button that opens the cell-fill swatch dialog. */
-    readonly Trigger: (props: TableChromePartProps) => DocxEditorChildren;
-    /** Open swatch dialog for the selected cell(s). */
-    readonly Content: (props: TableChromePartProps) => DocxEditorChildren;
-    /** One fill swatch inside the cell-fill dialog. */
-    readonly Item: (props: TableChromeItemProps) => DocxEditorChildren;
+declare function ContextMenuPasteWithoutFormatting({ icon, labelKey, shortcutKey, className, hidden, }: ContextMenuCommandProps): react.JSX.Element | null;
+declare namespace ContextMenuPasteWithoutFormatting {
+    var docxRow: "edit.pasteWithoutFormatting";
 }
 /**
- * Border-style menu compound (`DocxEditor.Toolbar.TableBorderStyle`).
+ * Copy the formatting at the selection — the Format Painter's read half.
+ *
+ * Stays available in a read-only document, like Copy: it writes nothing.
  *
  * @public
  */
-interface TableBorderStyleNamespace extends TableChromePartComponent {
-    /** Chrome slot id: `table.borderStyle`. */
-    readonly docxSlot: 'table.borderStyle';
-    /** Button that opens the border line-style menu. */
-    readonly Trigger: (props: TableChromePartProps) => DocxEditorChildren;
-    /** Open menu listing line styles for the active target. */
-    readonly Content: (props: TableChromePartProps) => DocxEditorChildren;
-    /** One line-style row inside the style menu. */
-    readonly Item: (props: TableChromeItemProps) => DocxEditorChildren;
-}
+declare const ContextMenuCopyFormatting: (({ icon, labelKey, shortcutKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
+    docxRow: string;
+};
 /**
- * Border-width menu compound (`DocxEditor.Toolbar.TableBorderWidth`).
+ * Apply the copied formatting to the selection.
+ *
+ * Disabled with the engine's own reason until something has been copied, so the row says
+ * why rather than looking live and doing nothing.
  *
  * @public
  */
-interface TableBorderWidthNamespace extends TableChromePartComponent {
-    /** Chrome slot id: `table.borderWidth`. */
-    readonly docxSlot: 'table.borderWidth';
-    /** Button that opens the border width menu. */
-    readonly Trigger: (props: TableChromePartProps) => DocxEditorChildren;
-    /** Open menu listing width presets for the active target. */
-    readonly Content: (props: TableChromePartProps) => DocxEditorChildren;
-    /** One width preset row inside the width menu. */
-    readonly Item: (props: TableChromeItemProps) => DocxEditorChildren;
+declare const ContextMenuPasteFormatting: (({ icon, labelKey, shortcutKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
+    docxRow: string;
+};
+/** Props for packaged table context-menu rows. @public */
+interface ContextMenuTableRowProps extends ContextMenuCommandProps {
+    /** When true, the row uses the destructive treatment. */
+    destructive?: boolean;
+}
+/** Insert a row above the current table row. @public */
+declare const ContextMenuInsertRowAbove: (({ icon, labelKey, className, hidden, destructive }: ContextMenuTableRowProps) => react.JSX.Element | null) & {
+    docxRow: string;
+};
+/** Insert a row below the current table row. @public */
+declare const ContextMenuInsertRowBelow: (({ icon, labelKey, className, hidden, destructive }: ContextMenuTableRowProps) => react.JSX.Element | null) & {
+    docxRow: string;
+};
+/** Insert a column to the left of the current column. @public */
+declare const ContextMenuInsertColumnLeft: (({ icon, labelKey, className, hidden, destructive }: ContextMenuTableRowProps) => react.JSX.Element | null) & {
+    docxRow: string;
+};
+/** Insert a column to the right of the current column. @public */
+declare const ContextMenuInsertColumnRight: (({ icon, labelKey, className, hidden, destructive }: ContextMenuTableRowProps) => 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;
+};
+/** Delete the current table column. @public */
+declare const ContextMenuDeleteTableColumn: (({ icon, labelKey, className, hidden, destructive }: ContextMenuTableRowProps) => react.JSX.Element | null) & {
+    docxRow: string;
+};
+/** Delete the entire table. @public */
+declare const ContextMenuDeleteTable: (({ icon, labelKey, className, hidden, destructive }: ContextMenuTableRowProps) => react.JSX.Element | null) & {
+    docxRow: string;
+};
+/** Compact vertical-alignment picker for selected table cells. @public */
+declare function ContextMenuCellVerticalAlignment({ hidden }: ContextMenuCommandProps): react.JSX.Element | null;
+declare namespace ContextMenuCellVerticalAlignment {
+    var docxRow: "table.cellVerticalAlignment";
+}
+/** Rebuild the pointed-at table of contents from the document's headings. @public */
+declare const ContextMenuRefreshToc: (({ icon, labelKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
+    docxRow: string;
+};
+/** Re-resolve only the page numbers of the pointed-at table of contents. @public */
+declare const ContextMenuRefreshTocPageNumbers: (({ icon, labelKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
+    docxRow: string;
+};
+/** Props for `DocxEditor.ContextMenu.Item`: a host-owned row. @public */
+interface ContextMenuItemProps {
+    /**
+     * Label, as a resolved STRING rather than an i18n key — the row belongs to the host's own
+     * action, so the host's own catalogue resolves it. The packaged rows go the other way.
+     */
+    label: string;
+    icon?: DocxEditorChildren;
+    /** Right-aligned shortcut text, already resolved. */
+    shortcut?: string;
+    disabled?: boolean;
+    /** Tooltip when disabled. Say why — never invent a reason the engine did not give. */
+    disabledReason?: string;
+    /** Checked state, for a row that toggles. Leave undefined on a row that just acts. */
+    active?: boolean;
+    onSelect?: () => void;
+    className?: string;
 }
 /**
- * Resolved label for the active border target in the shared draft.
+ * A host-owned context-menu row, styled and behaved like the packaged ones.
  *
- * For custom table chrome that shows the current target name outside the packaged picker.
+ * The toolbar's `Action` for the right-click surface: no slot, no command, no engine wiring
+ * — enabled state and the action are the host's, because the engine has no opinion about an
+ * action it does not model. Selecting it closes the menu.
  *
  * @public
  */
-declare function useTableBorderTargetLabel(): string;
+declare function ContextMenuItem({ label, icon, shortcut, disabled, disabledReason, active, onSelect, className, }: ContextMenuItemProps): react.JSX.Element;
 
-/** Props for `DocxEditor.Toolbar`. @public */
-interface DocxEditorToolbarProps {
-    /** Appended after the base `docx-toolbar` class. */
+/** Props for `DocxEditor.ContextMenu`. @public */
+interface DocxEditorContextMenuProps {
+    /** Appended after the base `docx-contextmenu` class. */
     className?: string;
-    /** i18n resolver for control labels; without it the raw keys show (never English). */
+    /** i18n resolver for row labels; without it the raw keys show (never English). */
     t?: ToolbarTranslate;
     /**
-     * Handler for the `file.save` control. Save is not an engine command (`Editor.save()`
-     * returns bytes the host must deliver), so without a handler the control renders
-     * disabled — same contract as the Vue toolbar's `onSave`.
-     */
-    onSave?: () => void;
-    /**
-     * `false` renders children verbatim with no default arrangement. Default `true`:
-     * part children override their slots in place, others append.
+     * `false` renders children verbatim with no default set. Default `true`: a child naming a
+     * packaged row overrides it in place, others append.
      */
     preset?: boolean;
     /**
-     * `false` lets the bar WRAP to more rows instead of collapsing groups into the "⋯"
-     * menu when it runs out of width. Default `true`.
+     * `true` suppresses the panel entirely and lets the browser's own menu through. For a
+     * host that wants the native menu back on some documents without unmounting the part.
      */
-    overflow?: boolean;
+    disabled?: boolean;
+    /** Notified whenever the panel opens or closes. */
+    onOpenChange?: (open: boolean) => void;
     children?: DocxEditorChildren;
 }
-/** The toolbar with its parts attached as statics. @public */
-interface DocxEditorToolbarNamespace {
-    (props: DocxEditorToolbarProps): ReactNode;
-    readonly Button: typeof ToolbarButton$1;
-    /** A host-owned action the chrome registry does not describe. */
-    readonly Action: typeof ToolbarAction;
-    readonly Separator: typeof ToolbarSeparator;
-    readonly Undo: ToolbarPartComponent;
-    readonly Redo: ToolbarPartComponent;
-    readonly Bold: ToolbarPartComponent;
-    readonly Italic: ToolbarPartComponent;
-    readonly Underline: ToolbarPartComponent;
-    readonly Strike: ToolbarPartComponent;
-    readonly Link: ToolbarPartComponent;
-    readonly ClearFormatting: ToolbarPartComponent;
-    readonly Superscript: ToolbarPartComponent;
-    readonly Subscript: ToolbarPartComponent;
-    readonly Alignment: ToolbarAlignmentComponent;
-    readonly AlignLeft: ToolbarPartComponent;
-    readonly AlignCenter: ToolbarPartComponent;
-    readonly AlignRight: ToolbarPartComponent;
-    readonly AlignJustify: ToolbarPartComponent;
-    readonly LineSpacing: ToolbarSlotPartComponent;
-    readonly BulletList: ToolbarPartComponent;
-    readonly NumberedList: ToolbarPartComponent;
-    readonly Outdent: ToolbarPartComponent;
-    readonly Indent: ToolbarPartComponent;
-    readonly ImageInsert: ToolbarPartComponent;
-    readonly ImageProperties: ToolbarPartComponent;
-    readonly ImageWrap: ImageWrapPartComponent;
-    readonly ImageAltText: ImageAltTextPartComponent;
-    readonly TableInsert: ToolbarPartComponent;
-    /** Border-edge target picker compound for contextual table chrome. */
-    readonly TableBorderTarget: TableBorderTargetNamespace;
-    /** Border-colour split compound (quick-apply main + swatch dialog). */
-    readonly TableBorderColor: TableBorderColorNamespace;
-    /** Border line-style menu compound. */
-    readonly TableBorderStyle: TableBorderStyleNamespace;
-    /** Border width menu compound. */
-    readonly TableBorderWidth: TableBorderWidthNamespace;
-    /** Cell background fill split compound (quick-apply main + swatch dialog). */
-    readonly TableCellFill: TableCellFillNamespace;
-    readonly Comments: ToolbarPartComponent;
-    readonly FontFamily: typeof FontFamily;
-    readonly FontSize: ToolbarSlotPartComponent;
-    readonly FontColor: ToolbarColorSplitComponent;
-    readonly Highlight: ToolbarColorSplitComponent;
-    readonly Zoom: ToolbarSlotPartComponent;
-    readonly StylePicker: typeof ParagraphStyle;
-    readonly EditingMode: ToolbarSlotPartComponent;
-    readonly Reviewers: typeof ToolbarReviewers;
-    readonly Save: ToolbarSlotPartComponent;
-    readonly ContentControlShowAll: ToolbarPartComponent;
-    readonly ContentControlFormFill: ToolbarPartComponent;
-    readonly ContentControlInspector: ToolbarPartComponent;
-    readonly ContentControlRemove: ToolbarPartComponent;
-}
 /**
- * The compound toolbar: `<DocxEditor.Toolbar/>` for the full working chrome, parts as
- * statics for composition (`<DocxEditor.Toolbar><DocxEditor.Toolbar.Bold/>...`).
+ * The packaged right-click menu over the painted document.
+ *
+ * Mounted by default inside `DocxEditor.Viewport`; `contextMenu={false}` on `DocxEditor`
+ * removes it. Rendered as a child of the viewport so it finds its own surface, but
+ * positioned in client space, so it is never clipped by the scroller.
  *
  * @public
  */
-declare const DocxEditorToolbar: DocxEditorToolbarNamespace;
-
+declare function DocxEditorContextMenu({ className, t, preset, disabled, onOpenChange, children, }: DocxEditorContextMenuProps): react.JSX.Element;
 /**
- * A menu's identity: one of the registry's five, or a HOST'S OWN.
- *
- * The `(string & {})` arm keeps the registry ids as editor autocomplete while accepting
- * any other string, so a product can add "Review" or "Clauses" without the library having
- * to know about it. Lives here rather than in `parts` because the bar's open/active state
- * is keyed on it and both modules read that state.
+ * `DocxEditor.ContextMenu` with its rows attached as statics.
  *
  * @public
  */
-type MenuId = ChromeMenuId | (string & {});
+interface DocxEditorContextMenuNamespace {
+    (props: DocxEditorContextMenuProps): ReactElement;
+    readonly Cut: typeof ContextMenuCut;
+    readonly Copy: typeof ContextMenuCopy;
+    readonly Paste: typeof ContextMenuPaste;
+    readonly PasteWithoutFormatting: typeof ContextMenuPasteWithoutFormatting;
+    readonly Delete: typeof ContextMenuDelete;
+    readonly SelectAll: typeof ContextMenuSelectAll;
+    readonly InsertRowAbove: typeof ContextMenuInsertRowAbove;
+    readonly InsertRowBelow: typeof ContextMenuInsertRowBelow;
+    readonly InsertColumnLeft: typeof ContextMenuInsertColumnLeft;
+    readonly InsertColumnRight: typeof ContextMenuInsertColumnRight;
+    readonly DeleteTableRow: typeof ContextMenuDeleteTableRow;
+    readonly DeleteTableColumn: typeof ContextMenuDeleteTableColumn;
+    readonly DeleteTable: typeof ContextMenuDeleteTable;
+    readonly CellVerticalAlignment: typeof ContextMenuCellVerticalAlignment;
+    readonly RefreshToc: typeof ContextMenuRefreshToc;
+    readonly RefreshTocPageNumbers: typeof ContextMenuRefreshTocPageNumbers;
+    /** A host-owned row: no slot, no command, the host's own label and action. */
+    readonly Item: typeof ContextMenuItem;
+    /** Any chrome slot as a live row (`<ContextMenu.Slot slot="text.bold" />`). */
+    readonly Slot: typeof MenuItem;
+    /** Bare row presentation, for a host building something the parts do not cover. */
+    readonly Row: typeof MenuRow;
+    /** A named section of rows: a visible heading plus a real ARIA group. */
+    readonly Group: typeof MenuGroup;
+    readonly Separator: typeof MenuSeparator;
+    readonly Submenu: typeof MenuSubmenu;
+}
+declare const ContextMenu: DocxEditorContextMenuNamespace;
 
-/** Props for `DocxEditor.Menu.Row`: one presentational menu row. @public */
-interface MenuRowProps {
-    /** Material Symbols paths, rendered as inline SVG in the row's icon column. */
-    icon?: DocxEditorChildren;
-    /** Right-aligned shortcut text (already resolved). */
-    shortcut?: string;
-    disabled?: boolean;
+/** Where the panel opened, in client coordinates. */
+interface ContextMenuAnchor {
+    readonly x: number;
+    readonly y: number;
+}
+interface ContextMenuContextValue {
     /**
-     * Tooltip. Set it for the ENGINE's disabled reason and nothing else — a menu row's text
-     * is already visible, so a tooltip repeating it is noise, and inventing a reason for a
-     * refusal the engine explained is the thing this codebase does not do.
+     * Close the panel. `restoreFocus` on the paths where the user is FINISHING with the menu
+     * (selecting a row); not on the ones where they are already going elsewhere.
      */
-    title?: string;
+    readonly close: (restoreFocus?: boolean) => void;
+    /** Non-null exactly while the panel is open. */
+    readonly anchor: ContextMenuAnchor | null;
     /**
-     * Checked state, for a row that TOGGLES (bold on bold text). Leave undefined on a row
-     * that just acts: `menuitemcheckbox` with `aria-checked="false"` announces "not
-     * selected" on a Page break row, which is a claim about state it does not have.
+     * The table of contents this open was over, captured AT OPEN TIME.
+     *
+     * Read imperatively from the editor in the same event that opens the panel, not
+     * subscribed to. The engine records the right-click target and the panel opens from the
+     * same event, so a subscription is a render behind: the first right-click on a TOC drew
+     * the menu without its rows and only a second one had them. It is also the more honest
+     * shape — an open menu describes the gesture that opened it, whatever happens next.
      */
-    active?: boolean;
+    readonly tocId: string | null;
     /**
-     * Present on a row belonging to a MUTUALLY EXCLUSIVE set (the four alignments), which
-     * makes it `menuitemradio` rather than `menuitemcheckbox`. Four independent checkboxes
-     * is a different claim from one-of-four, and a screen reader reads it as such.
+     * The element the opening right-click landed on, captured AT OPEN TIME like {@link tocId}.
+     *
+     * What lets a contextual row decide it applies — a custom-node chip, a painted marker —
+     * without installing a second `contextmenu` listener that could disagree with the one
+     * that opened the panel. Null while closed, and for keyboard-invoked opens, which have
+     * no pointer target.
      */
-    selected?: true;
-    /** Stable marker for hosts, tests and e2e. */
-    slot?: string;
+    readonly target: HTMLElement | null;
     /**
-     * What the slot currently SHOWS, for a control whose state is more than pressed-or-not —
-     * the format painter's `once` against its `locked`. Declared rather than left to a spread:
-     * this component renders only the props it names, so an undeclared attribute is dropped in
-     * silence, and the stylesheet rule keyed on it can never match.
-     */
-    'data-value'?: string;
-    /**
-     * Vue TSX maps row identity through `rowSlot` because `slot` is reserved.
-     * React uses {@link slot} directly.
-     */
-    rowSlot?: string;
-    onSelect?: () => void;
-    /**
-     * Vue TSX binds row activation through `selectHandler` because `onSelect`
-     * is treated as a listener. React uses {@link onSelect} directly.
+     * The browser's reason for refusing a clipboard READ, once one has actually been refused.
+     *
+     * Lives on the ROOT rather than in the Paste row because selecting that row closes the
+     * panel, which unmounts the row — state kept there was written and discarded in the same
+     * batch, so the row it was meant to disable came back enabled on the next right-click and
+     * the documented behaviour never once happened. Firefox and Safari refuse every read, so
+     * "ask once, then stop offering it" has to outlive one open.
      */
-    selectHandler?: () => void;
-    className?: string;
-    children?: DocxEditorChildren;
+    readonly clipboardRefusal: string | null;
+    readonly reportClipboardRefusal: (reason: string) => void;
 }
 /**
- * One menu row: icon column, label, shortcut column.
+ * The element the opening right-click landed on, or null while the menu is closed.
  *
- * The icon column is reserved even when a row has no icon, so labels line up down the
- * panel the way Word's and Docs' menus do.
+ * Public so capability packages can render contextual sections — a row that only exists
+ * when the press landed on their own painted chrome — without a second listener.
  *
  * @public
  */
-declare function MenuRow(props: MenuRowProps): react.JSX.Element;
-/** Props for `DocxEditor.Menu.Group`: a titled section of rows. @public */
-interface MenuGroupProps {
-    /** Literal heading, already resolved. Wins over {@link labelKey}. */
-    label?: string;
-    /** i18n key of the heading. */
-    labelKey?: string;
-    className?: string;
-    hidden?: boolean;
-    children?: DocxEditorChildren;
+declare function useContextMenuTarget(): HTMLElement | null;
+
+/** Render overrides for automatically mounted editor popups. `false` disables automatic rendering. @public */
+interface DocxEditorPopups {
+    contentControlWidget?: DocxEditorPopup<DocxEditorContentControlWidgetProps>;
+    invalidTextFormField?: DocxEditorPopup<DocxEditorInvalidTextFormFieldDialogProps>;
+    imageProperties?: DocxEditorPopup<DocxEditorImagePropertiesDialogProps>;
+    imageAltText?: DocxEditorPopup<DocxEditorImageAltTextPopupProps>;
+    noteProperties?: DocxEditorPopup<DocxEditorNotePropertiesDialogProps>;
+    notePreview?: DocxEditorPopup<DocxEditorNotePreviewProps>;
+    notesContextMenu?: DocxEditorPopup<DocxEditorNotesContextMenuProps>;
+    pageSetup?: DocxEditorPopup<DocxEditorPageSetupDialogProps>;
+    paragraph?: DocxEditorPopup<DocxEditorParagraphDialogProps>;
+    textFormField?: DocxEditorPopup<DocxEditorTextFormFieldDialogProps>;
+    hyperlink?: DocxEditorPopup<HyperLinkProps>;
+    contentControl?: DocxEditorPopup<ContentControlProps>;
+    equation?: DocxEditorPopup<Record<string, never>>;
+    contextMenu?: DocxEditorPopup<DocxEditorContextMenuProps>;
 }
+
 /**
- * A named section inside a panel: a visible heading and the rows under it.
- *
- * A separator says rows are apart; a group says what they are, which is what a panel needs
- * once a product adds rows beside the packaged ones. `role="group"` nests legally inside a
- * menu, keeps its rows owned by it, and takes the heading as its accessible name — so the
- * visible heading is decoration and is hidden from the tree.
+ * The editor instance from the nearest `DocxEditor.Root`, or `null` before the Root's
+ * mount effect has created it (and outside any Root). Deliberately not a throwing
+ * variant: pre-mount is a normal frame every consumer renders through, and the state
+ * hooks built on this already answer it with a typed loading snapshot.
  *
  * @public
  */
-declare function MenuGroup({ label: literal, labelKey, className, hidden, children, }: MenuGroupProps): react.JSX.Element | null;
-/** Props for `DocxEditor.Menu.Item`: one chrome slot as a menu row. @public */
-interface MenuItemProps {
-    /** The chrome slot this row drives (`'text.bold'`, `'insert.pageBreak'`, …). */
-    slot: ChromeSlotId;
-    /** Plain-label i18n key, overriding the slot's tooltip-shaped one. */
-    labelKey?: string;
-    /** i18n key of the shortcut shown in the right column. */
-    shortcutKey?: string;
-    className?: string;
-    /** Render nothing — inside a packaged menu this removes the row. */
-    hidden?: boolean;
-}
+declare function useDocxEditor(): DocxEditorInstance | null;
 /**
- * One chrome slot as a live menu row: enabled and active from the engine's
- * can-before-exec answer, labelled and iconed from the registry. Selecting it runs the
- * slot's command and closes the menu.
+ * Whether a review rail is mounted under this Root, and how much room it wants.
  *
- * @public
+ * The GUTTER is the reason this exists. `DocxEditor.Viewport` reserves space beside the
+ * page for the pane, and the ruler shifts by the same amount — but neither of them can see
+ * whether a rail was actually composed in. Keyed on the pane's open state alone, every
+ * consumer of the tier-2 `<DocxEditor>` sugar (which mounts no rail) had its page pushed
+ * 158px off centre beside an empty column.
+ *
+ * A rail registers on mount and unregisters on unmount, so the reservation follows what is
+ * really on screen. Count rather than boolean: StrictMode mounts twice, and a host may
+ * legitimately compose two rails.
  */
-declare function MenuItem({ slot, labelKey, shortcutKey, className, hidden }: MenuItemProps): react.JSX.Element | null;
-declare namespace MenuItem {
-    var docxMenuRow: true;
-}
-/** Props for the pinned File rows. @public */
-interface MenuActionProps {
-    className?: string;
-    hidden?: boolean;
+interface ReviewRailRegistry {
+    readonly mounted: number;
+    readonly register: () => () => void;
+    readonly registerCommentDraft: (handler: () => void) => () => void;
+    readonly requestCommentDraft: () => boolean;
 }
-declare const MenuOpen: (({ className, hidden }: MenuActionProps) => react.JSX.Element | null) & {
-    docxSlot: ChromeSlotId;
-};
-declare const MenuSave: (({ className, hidden }: MenuActionProps) => react.JSX.Element | null) & {
-    docxSlot: ChromeSlotId;
-};
+declare const ReviewRailContext: react.Context<ReviewRailRegistry | null>;
+
 /**
- * Page setup. Unlike open and save, the ENGINE has an opinion here — `setPageSetup` is a
- * real command, it just needs the dialog's values — so the row asks through the slot's
- * probe and is disabled with the engine's own words on a document it cannot rewrite.
+ * Props for `DocxEditor.Root`. Only `document`, `fonts`, and `imageDecodePort` identity remounts
+ * the editor. Later `author`, `locale`, `mode`, `translate`, `zoom`, and `zoomMode` changes use
+ * instance setters. `modules` is sampled at mount only.
+ *
+ * @public
  */
-declare function MenuPageSetupImpl({ className, hidden }: MenuActionProps): react.JSX.Element | null;
-declare const MenuPageSetup: typeof MenuPageSetupImpl & {
-    docxSlot: ChromeSlotId;
-};
-declare function MenuImageInsertImpl({ className, hidden }: MenuActionProps): react.JSX.Element | null;
-declare const MenuImageInsert: typeof MenuImageInsertImpl & {
-    docxSlot: ChromeSlotId;
-};
-interface MenuSubmenuProps {
-    /** i18n key of the parent row's label. */
-    labelKey: string;
-    /** Material Symbols paths for the parent row's icon. */
-    paths?: readonly string[] | null;
-    className?: string;
+interface DocxEditorRootProps {
+    /** Customize automatically mounted popups. Set an entry to false for manual ownership. */
+    popups?: DocxEditorPopups;
+    /** A document to load: DOCX bytes, `'blank'` for an empty one, or an existing handle.
+     * Identity change remounts; `'blank'` is a constant, so holding it across renders does
+     * not. Omitting this mounts NO document, which is not the same as an empty one. */
+    document?: DocumentSource;
+    /**
+     * Font bytes for Word-accurate (HarfBuzz-shaped) wrap and pagination. Omitted, layout
+     * 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`.
+     */
+    fonts?: FontConfiguration | FontConfigurationFragment | FontResolver;
+    /** Author for later comments, replies, and tracked changes. Changes apply without a remount. */
+    author?: string;
+    /**
+     * BCP-47 locale for regional date input and engine-generated labels. Defaults to en-US.
+     * Changes apply to subsequent edits without a remount; stored date formats are preserved.
+     * For UI translations, wrap Root and its chrome in LocaleProvider with an i18n catalog.
+     */
+    locale?: string;
+    /** Live drawing and form-control labels; defaults to the active catalogue. */
+    translate?: (key: string, params?: Record<string, string | number>) => string;
+    /**
+     * Capability modules to register (`@docx-editor.dev/pro`'s review module, custom nodes,
+     * collaboration). Sampled at mount only because registration is construction-time.
+     */
+    modules?: readonly EditorModule[];
+    /**
+     * The host mode, matching the toolbar's three-state pill. Changes apply without a remount.
+     *
+     * `'edit'` opens in editing even when the document's `w:trackRevisions` asks for
+     * tracked changes; `'suggesting'` opens in suggesting (needs a review module and an
+     * `author`); `'view'` is read-only and the toolbar cannot leave it. Omitted, the
+     * DOCUMENT decides: a package carrying `w:trackRevisions` opens in suggesting.
+     */
+    mode?: 'edit' | 'view' | 'suggesting';
+    /**
+     * A fixed scale. Supplying one also means the mode is fixed, unless `zoomMode` says
+     * otherwise: an app that pinned 100% keeps 100% on every window size.
+     */
+    zoom?: number;
+    /**
+     * Where the scale comes from. Defaults to `'auto'`: fit the page width, between 50% and
+     * 100%, so a window with room for the sheet renders at 100% and a narrower one shrinks
+     * rather than growing a horizontal scrollbar — down to the floor, past which it scrolls.
+     *
+     * A fit tracks the room beside the page, so opening the comments rail or docking the
+     * navigation pane shrinks the document by what it took. Pass `{ type: 'fixed' }` to opt out.
+     */
+    zoomMode?: ZoomMode | 'auto';
+    /** Fired once per instance, after it is published to the tree (and after any
+     *  `DocxEditor.Content` in the same commit has attached its mount point). A large
+     *  document mounts behind one painted frame; `onReady` fires AFTER that mount lands,
+     *  so scrolling or selecting from it works on any document size. */
+    onReady?: (editor: Editor) => void;
+    /** Fired when the document changes (revision + identity deltas, not bytes). */
+    onChange?: (change: DocumentChange) => void;
+    /** Fired with the typed font failure when the shaped-font pipeline rejects. */
+    onFontError?: (error: EditorFontError) => void;
+    /**
+     * Localized labels for table insertion furniture. When omitted, core falls back to
+     * bundled English through {@link defaultTableLabel}.
+     */
+    tableInteractionLabel?: (key: 'table.insertRowBelow' | 'table.insertColumnRight') => string;
+    /** Optional decode port for embedded image insertion and paint in tests or custom hosts. */
+    imageDecodePort?: ImageDecodePort;
     children?: DocxEditorChildren;
 }
+/** @public Vue-only lifecycle listeners; exported for cross-adapter API parity. */
+interface DocxEditorRootListeners {
+    onReady?: (editor: Editor) => void;
+    onChange?: (change: DocumentChange) => void;
+    onFontError?: (error: EditorFontError) => void;
+}
+/** @public Vue-only setup result; exported for cross-adapter API parity. */
+interface ProvideDocxEditorResult {
+    readonly DocxEditorRoot: typeof DocxEditorRoot;
+    readonly rootProps: Omit<DocxEditorRootProps, keyof DocxEditorRootListeners>;
+    readonly rootListeners: DocxEditorRootListeners;
+    readonly editorRef: ReturnType<typeof useDocxEditor>;
+}
 /**
- * A row that opens a nested panel to its right (Insert › Break).
- *
- * The parent row runs nothing — disclosure is not a command — so it stays interactive
- * regardless of what its children can do, and each child answers for itself. Opening on
- * hover AND on click is what both Word and Docs do; keyboard users get the same panel
- * through focus.
+ * Prepares Root props and listeners while exposing the instance created by that Root.
+ * Call this function during render, like a React hook.
  *
  * @public
  */
-declare function MenuSubmenu({ labelKey, paths, className, children }: MenuSubmenuProps): react.JSX.Element;
-/** Props for `DocxEditor.Menu.TableGrid`. @public */
-interface MenuTableGridProps {
-    /** The slot the picked size dispatches through. Defaults to `table.insert`. */
-    slot?: ChromeSlotId;
-    className?: string;
-}
+declare function useProvidedDocxEditor(options: DocxEditorRootProps): ProvideDocxEditorResult;
+
 /**
- * Word's insert-table size picker: a 6×6 grid that highlights as the pointer sweeps it
- * and reads back the size underneath.
- *
- * Rendered only when the engine will honour an insert (see `MenuTablePicker`). A panel
- * that opens onto a grid nothing can be picked from is worse than no panel: the row
- * cannot act, so it should not disclose — it should look disabled, like every other row
- * the engine refuses.
+ * Creates and owns a `DocxEditorInstance` and provides it to the subtree. Renders no
+ * DOM — compose it with `DocxEditor.Viewport` + `DocxEditor.Content` for the painted
+ * pages, and any hook-built chrome anywhere inside.
  *
  * @public
  */
-declare function MenuTableGrid({ slot, className }: MenuTableGridProps): react.JSX.Element;
-/** Props for `DocxEditor.Menu.Separator`. @public */
-interface MenuSeparatorProps {
+declare function DocxEditorRoot(props: DocxEditorRootProps): react.JSX.Element;
+
+/** Props for `DocxEditor.Viewport`. @public */
+interface DocxEditorViewportProps {
+    /** Appended after the load-bearing viewport classes (e.g. `dark` for chrome theming). */
     className?: string;
+    style?: CSSProperties;
+    children?: DocxEditorChildren;
 }
-/** A horizontal rule between groups of rows. @public */
-declare function MenuSeparator({ className }: MenuSeparatorProps): react.JSX.Element;
 /**
- * One registry entry as its row.
+ * The sole scroll container for the painted document. Put `DocxEditor.Content` inside
+ * it; the engine discovers this element by class and manages scrolling against it.
  *
- * The three host-boundary slots route to their pinned parts rather than to the generic
- * `MenuItem`, because a command-driven row would render them permanently disabled — the
- * engine reports, correctly, that neither open nor save is a command.
+ * @public
  */
-declare function MenuEntry({ entry }: {
-    entry: ChromeMenuEntry;
-}): react.JSX.Element;
-/** Props for `DocxEditor.Menu.Menu` and the five pinned menu parts. @public */
-interface MenuProps {
-    /** Which menu this is. Only one panel in the bar is open at a time, keyed on this. */
-    id: MenuId;
-    /** i18n key of the trigger label. Defaults to the registry's. */
-    labelKey?: string;
-    /**
-     * Literal trigger label, already resolved. Wins over `labelKey`, and is what a
-     * host-defined menu uses — its name is not in our catalogue and never will be.
-     */
-    label?: string;
-    /**
-     * Icon shown before the trigger's label.
-     *
-     * OPT-IN and unset by default, because neither Word nor Docs puts icons on a menu bar and
-     * the packaged bar should look like the thing it is imitating. It exists because every
-     * other control in this library takes one — toolbar parts, menu rows — and a product with
-     * its own visual language should not have to rebuild the trigger to add a glyph to it.
-     *
-     * Decorative: the label is the accessible name, so the icon is hidden from assistive tech.
-     */
-    icon?: DocxEditorChildren;
+declare function DocxEditorViewport({ className, style, children }: DocxEditorViewportProps): react.JSX.Element;
+
+/** Props for `DocxEditor.Toolbar.Reviewers`. @public */
+type ToolbarReviewersProps = {
     className?: string;
-    /** Render nothing — inside the default bar this removes the menu. */
     hidden?: boolean;
-    /**
-     * `false` renders `children` verbatim as the whole panel. Default `true`: the panel is
-     * the registry's rows for this menu, with a row child REPLACING the row it names in
-     * place (`hidden` removes it) and any other child appended. Use `false` when the order
-     * matters and you want to state it yourself.
-     */
-    preset?: boolean;
-    /** Panel content. */
+    /** Custom trigger icon. */
+    icon?: DocxEditorChildren;
+};
+/** The reviewer visibility menu. It changes view state only. @public */
+declare function ToolbarReviewers({ className, hidden, icon }: ToolbarReviewersProps): react.JSX.Element | null;
+declare namespace ToolbarReviewers {
+    var docxSlot: "review.authors";
+}
+
+/** Props for `DocxEditorToolbar.Button`. @public */
+interface ToolbarButtonProps$1 {
+    /** The chrome slot this button drives (`'text.bold'`, `'history.undo'`, ...). */
+    slot: ChromeSlotId;
+    /** Icon override; falls back to `children`, then to the registry's icon paths. */
+    icon?: DocxEditorChildren;
+    /** Merge the button's behavior into the single child element instead of a <button>. */
+    asChild?: boolean;
+    className?: string;
     children?: DocxEditorChildren;
+    /** Render nothing — inside the default arrangement this removes the slot. */
+    hidden?: boolean;
 }
 /**
- * One menu of the bar: a trigger and the panel it opens.
- *
- * Bar behaviour is Docs': a click opens, a second click closes, and while ANY menu is
- * open, moving the pointer over a different trigger switches to it without a click.
+ * One chrome slot as a live toolbar button: enabled/active from the engine's
+ * can-before-exec answer, labelled from the registry's i18n key, `data-active` /
+ * `data-disabled` presence attributes for styling, `aria-pressed` on toggles.
  *
  * @public
  */
-declare function Menu({ id, labelKey, label: literal, icon, className, hidden, preset, children, }: MenuProps): react.JSX.Element | null;
-/** A menu pinned to one registry id, for `DocxEditor.Menu.File` and friends. @public */
-interface MenuPartComponent {
-    (props: Omit<MenuProps, 'id'>): ReactNode;
-    readonly docxMenu: ChromeMenuId;
+declare function ToolbarButton$1(props: ToolbarButtonProps$1): react.JSX.Element | null;
+declare namespace ToolbarButton$1 {
+    var docxToolbarPart: true;
 }
-/** Props for `DocxEditor.Menu.ReportIssue`. @public */
-interface MenuReportIssueProps {
+
+interface ImageInsertProviderProps {
+    children: ReactNode;
+}
+declare function ImageInsertProvider({ children }: ImageInsertProviderProps): react.JSX.Element;
+/** Props for the toolbar/menu insert trigger. @public */
+interface ImageInsertTriggerProps {
     className?: string;
-    /** Render nothing — inside the packaged Help menu this removes the row. */
     hidden?: boolean;
-    /** Replaces the packaged handler. Falls back to the menu's `onReportIssue`, then to
-     *  this project's own tracker. */
-    onSelect?: () => void;
+    asChild?: boolean;
+    children?: DocxEditorChildren;
+}
+/** Toolbar insert-image control — opens the shared file picker. @public */
+declare function ImageInsertTrigger({ className, hidden, asChild, children, }: ImageInsertTriggerProps): react.JSX.Element | null;
+declare namespace ImageInsertTrigger {
+    var docxSlot: "image.insert";
+}
+
+/** Props for `DocxEditorToolbar.ImageWrap`. @public */
+interface ImageWrapProps {
+    className?: string;
+    hidden?: boolean;
+    asChild?: boolean;
+    children?: DocxEditorChildren;
 }
 /**
- * Help › Report issue.
- *
- * A NAMED part rather than anonymous markup inside the Help menu, because it is the one
- * packaged row that reaches OUTSIDE the host's product: it opens this project's issue
- * tracker with the current page URL and user agent prefilled. A host embedding the editor
- * in its own app has every reason to point that somewhere else or drop it, and it should
- * not have to rebuild the menu to do either — `reportIssue={false}` removes it,
- * `onReportIssue` redirects it, and this part composes it back by name.
- *
- * @public
- */
-declare function MenuReportIssueImpl({ className, hidden, onSelect }: MenuReportIssueProps): react.JSX.Element | null;
-/**
- * The report-issue row, with its row-identity marker.
- *
- * The key is NOT a `ChromeSlotId` — the row is React's, not the shared registry's — but the
- * merge only needs a stable string, and using one here is what lets a host write
- * `<Menu.ReportIssue hidden/>` and have it REPLACE the packaged row rather than render a
- * second, invisible one beside it.
+ * Wrap-text dropdown presenting all nine Word choices.
  *
  * @public
  */
-declare const MenuReportIssue: typeof MenuReportIssueImpl & {
-    docxSlot: string;
+declare function ImageWrap({ className, hidden, asChild, children }: ImageWrapProps): react.JSX.Element | null;
+declare namespace ImageWrap {
+    var docxSlot: "image.wrap";
+}
+/** @public */
+interface ImageWrapPartComponent {
+    (props: ImageWrapProps): ReactElement | null;
+    readonly docxSlot: 'image.wrap';
+}
+
+type NormalizedImagePayload = {
+    readonly ok: true;
+    readonly bytes: Uint8Array;
+    readonly mime: SupportedImageMime;
+    readonly widthPoints: number;
+    readonly heightPoints: number;
+} | {
+    readonly ok: false;
+    /** i18n key under `imageInsert.errors.*` suitable for `t()`. */
+    readonly reasonKey: string;
 };
+/** Preflight raster bytes for insert/replace. Never allocates from file-supplied dimensions alone. */
+declare function normalizeImageBytes(bytes: Uint8Array): NormalizedImagePayload;
 
-type MenuReviewersProps = {
+/** Props for the named parts (`DocxEditorToolbar.Bold`, ...): the slot is pinned. @public */
+type ToolbarPartProps = Omit<ToolbarButtonProps$1, 'slot'>;
+interface ToolbarPartComponent {
+    (props: ToolbarPartProps): ReturnType<typeof ToolbarButton$1>;
+    readonly docxSlot: ChromeSlotId;
+}
+/**
+ * Props for the non-button parts (pickers, steppers, color splits, save). @public
+ */
+interface ToolbarSlotPartProps {
     className?: string;
+    /** Render nothing — inside the default arrangement this removes the slot. */
     hidden?: boolean;
-};
-/** The document-dependent Reviewers submenu. It changes view state only. @public */
-declare function MenuReviewers({ className, hidden }: MenuReviewersProps): react.JSX.Element | null;
-/** The packaged top-level Review menu. @public */
-declare const MenuReview: MenuPartComponent;
-
-/** Props for `DocxEditor.Menu`. @public */
-interface DocxEditorMenuProps {
-    /** Appended after the base `docx-menubar` class. */
+}
+/** A non-button part pinned to one slot. @public */
+interface ToolbarSlotPartComponent {
+    (props: ToolbarSlotPartProps): ReturnType<typeof ToolbarButton$1>;
+    readonly docxSlot: ChromeSlotId;
+}
+/** Props for `DocxEditorToolbar.Separator`. @public */
+interface ToolbarSeparatorProps {
     className?: string;
-    /** i18n resolver for row labels; without it the raw keys show (never English). */
-    t?: ToolbarTranslate;
-    /**
-     * Name for the file the packaged Save writes, without the extension. Ignored when
-     * `onSave` is given.
-     */
-    fileName?: string;
-    /**
-     * Replaces File › Open. The default opens a file picker and hands the bytes to
-     * `Editor.load` — a user-driven file READ, never a fetch.
-     */
-    onOpen?: () => void;
-    /**
-     * Fired when the packaged Open reads a file, before its bytes are loaded — so a host can
-     * reflect the file's name in its own title chrome. Not fired when `onOpen` replaced the
-     * packaged picker: the host is reading the file itself and already holds the name.
-     */
-    onOpenFile?: (file: File) => void;
-    /** Replaces File › Save. The default runs `Editor.save()` and downloads the bytes. */
-    onSave?: () => void;
-    /** Replaces File › Page setup. The default opens the packaged Page Setup dialog. */
-    onPageSetup?: () => void;
+}
+/** A vertical rule between toolbar groups. @public */
+declare function ToolbarSeparator({ className }: ToolbarSeparatorProps): react.JSX.Element;
+
+/**
+ * Props for the split colour controls. @public
+ *
+ * The one addition over a plain slot part is `icon`, and it belongs here rather than on
+ * `ToolbarSlotPartProps`: the other slot parts are steppers and pickers with no single glyph
+ * to replace, so an icon prop on the shared type would be a promise three of them could not
+ * keep.
+ */
+interface ToolbarColorSplitProps extends ToolbarSlotPartProps {
     /**
-     * Replaces Help › Report issue. The default opens THIS project's issue tracker,
-     * prefilled with the current page URL and user agent — so a host embedding the editor
-     * in its own product should point this at its own support channel, or drop the row with
-     * `reportIssue={false}`.
+     * Replaces the glyph above the colour bar — the registry's red "A" or highlighter pen.
+     *
+     * The BAR is not replaceable and still paints the live value, so a host swapping the glyph
+     * keeps the thing that makes this control readable at a glance.
      */
-    onReportIssue?: () => void;
-    /** `false` removes Help › Report issue, and the Help menu with it. Default `true`. */
-    reportIssue?: boolean;
+    icon?: DocxEditorChildren;
+}
+/** A split colour control pinned to one slot. @public */
+interface ToolbarColorSplitComponent {
+    (props: ToolbarColorSplitProps): ReturnType<typeof ToolbarButton$1>;
+    readonly docxSlot: ChromeSlotId;
+}
+
+/** The merged part is keyed by its GROUP id — it stands in for all four slots. */
+interface ToolbarAlignmentComponent {
+    (props: ToolbarSlotPartProps): ReturnType<typeof ToolbarAlignmentImpl>;
+    readonly docxSlot: 'alignment';
+}
+declare function ToolbarAlignmentImpl({ className, hidden }: ToolbarSlotPartProps): react.JSX.Element | null;
+
+/** Props for `DocxEditorToolbar.Action`. @public */
+interface ToolbarActionProps {
     /**
-     * `false` renders children verbatim with no default arrangement. Default `true`: menu
-     * children override their menu in place, others append.
+     * Accessible name and tooltip. A resolved STRING, not an i18n key: the label belongs to
+     * the host's own action, so the host's own catalogue resolves it. (Registry controls go
+     * the other way — they carry keys and the toolbar's `t` resolves them.)
      */
-    preset?: boolean;
+    label: string;
+    /** Icon content. Inline SVG sized ~18px matches the packaged controls. */
+    icon?: DocxEditorChildren;
+    /** Pressed state, for an action that toggles. Sets `aria-pressed` and `data-active`. */
+    active?: boolean;
+    disabled?: boolean;
+    /** Tooltip when disabled — say why, the way the engine's controls do. */
+    disabledReason?: string;
+    onSelect?: () => void;
+    /** Merge the behavior onto the single child element instead of rendering a `<button>`. */
+    asChild?: boolean;
+    className?: string;
     children?: DocxEditorChildren;
 }
-/** The menu bar with its parts attached as statics. @public */
-interface DocxEditorMenuNamespace {
-    (props: DocxEditorMenuProps): ReactNode;
-    /** A menu of the bar, addressed by registry id. */
-    readonly Menu: typeof Menu;
-    readonly File: MenuPartComponent;
-    readonly Format: MenuPartComponent;
-    readonly Insert: MenuPartComponent;
-    readonly Review: typeof MenuReview;
-    readonly Help: MenuPartComponent;
-    /** One chrome slot as a live row. */
-    readonly Item: typeof MenuItem;
-    /** A presentational row, for a host action that is not a chrome slot. */
-    readonly Row: typeof MenuRow;
-    /** A named section of rows: a visible heading plus a real ARIA group. */
-    readonly Group: typeof MenuGroup;
-    readonly Separator: typeof MenuSeparator;
-    readonly Submenu: typeof MenuSubmenu;
-    /** Word's 6×6 insert-table size picker. */
-    readonly TableGrid: typeof MenuTableGrid;
-    /** One registry entry as its row, for a host arranging registry data itself. */
-    readonly Entry: typeof MenuEntry;
-    readonly Open: typeof MenuOpen;
-    readonly Save: typeof MenuSave;
-    readonly PageSetup: typeof MenuPageSetup;
-    /** Insert › Image, so a host can hide it or place it elsewhere by name. */
-    readonly ImageInsert: typeof MenuImageInsert;
-    /** Review > Markup Options > Reviewers. */
-    readonly Reviewers: typeof MenuReviewers;
-    /** Help › Report issue, so a host can drop it or point it elsewhere by name. */
-    readonly ReportIssue: typeof MenuReportIssue;
-}
 /**
- * The compound menu bar: `<DocxEditor.Menu/>` for File · Format · Insert · Review · Help, parts as
- * statics for composition.
+ * A host-owned toolbar action, styled and behaved like the packaged controls.
  *
- * Every actionable row is a chrome slot, so a row and its toolbar twin share one label,
- * one icon, one command and one enabled state. Rows the engine cannot honour yet render
- * present and disabled, carrying the engine's own reason.
+ * Renders inside `<DocxEditor.Toolbar>` after the default arrangement (it drives no slot,
+ * so it is an appended child), or anywhere under `preset={false}`.
  *
  * @public
  */
-declare const DocxEditorMenu: DocxEditorMenuNamespace;
+declare function ToolbarAction(props: ToolbarActionProps): react.JSX.Element;
 
-/** Props for the context-fed ruler parts. @public */
-interface DocxEditorRulerProps {
-    /** Measurement unit for tick labels. Defaults to inches. */
-    unit?: 'inch' | 'cm';
-    className?: string;
-    style?: CSSProperties;
+/** What `useFontFamily` answers. @public */
+interface UseFontFamilyResult {
+    /** The selection's agreed family, or null (mixed selection, or no document). */
+    readonly value: string | null;
+    /** Apply a family through the can-before-exec path; a refusal is a safe no-op. */
+    readonly setValue: (family: string) => void;
+    /**
+     * The offerable font catalog (validated, deduplicated, sorted): the editor's
+     * standard and configured families merged with the document's declared ones.
+     */
+    readonly options: readonly string[];
+    /** Whether the engine would honour a font change right now. */
+    readonly isEnabled: boolean;
 }
 /**
- * The horizontal ruler as a context-fed part (`DocxEditor.HorizontalRuler`): page
- * width, margins and zoom straight from the editor. Left/right margin handles are
- * draggable when the engine supports page-setup writes; the drag previews locally and
- * commits one undoable step on release.
- *
- * Renders nothing while the editor holds no document — see
- * {@link selectDocumentAbsent}.
- *
- * @public
- */
-declare function DocxEditorHorizontalRuler(props: DocxEditorRulerProps): ReactElement | null;
-/**
- * The vertical ruler as a context-fed part (`DocxEditor.VerticalRuler`): page height,
- * margins and zoom straight from the editor. Top/bottom margin handles are draggable
- * when the engine supports page-setup writes, committing one undoable step on release.
- *
- * Renders nothing while the editor holds no document — see
- * {@link selectDocumentAbsent} — and nothing while the page is wider than the
- * viewport: the ruler rides the scroller at content x=0, so a horizontal scroll
- * would carry it out of view, and pinning it instead would paint ticks over page
- * text. Word's web peers drop it on cramped viewports; so does this part, and it
- * returns as soon as the page fits again.
+ * The font-family picker's behavior, UI-free.
  *
  * @public
  */
-declare function DocxEditorVerticalRuler(props: DocxEditorRulerProps): ReactElement | null;
-
-/** Props for the context-fed outline part. @public */
-interface DocxEditorDocumentOutlineProps {
-    /** Close-button handler; without one the panel simply stays open. */
-    onClose?: () => void;
-    /** Vertical offset (px) inside the panel's positioning container. */
-    topOffset?: number;
-    /** Left anchor (px) inside the panel's positioning container. */
-    leftOffset?: number;
+declare function useFontFamily(): UseFontFamilyResult;
+/** Props for `DocxEditorToolbar.FontFamily` and its sub-parts. @public */
+interface FontFamilyPartProps {
+    asChild?: boolean;
+    className?: string;
+    children?: DocxEditorChildren;
 }
-/**
- * The document outline as a context-fed part (`DocxEditor.DocumentOutline`): headings
- * from `Editor.getOutline()`, in document order; clicking one moves the caret to that
- * heading. The panel positions absolutely — give it a `position: relative` container.
- *
- * Renders nothing while the editor has no document — a floating panel saying "no
- * headings" about a document that is not there is the same false claim the rulers made.
- *
- * @public
- */
-declare function DocxEditorDocumentOutline(props: DocxEditorDocumentOutlineProps): ReactElement | null;
+/** Props for the compound root. @public */
+interface FontFamilyProps extends FontFamilyPartProps {
+    /** Render nothing — inside the default arrangement this removes the slot. */
+    hidden?: boolean;
+}
+/** Props for `FontFamily.Item`. @public */
+interface FontFamilyItemProps extends FontFamilyPartProps {
+    /** The family this item applies. */
+    value: string;
+}
+declare function FontFamilyTrigger({ asChild, className, children }: FontFamilyPartProps): react.JSX.Element | null;
+declare namespace FontFamilyTrigger {
+    var docxToolbarPart: true;
+}
+declare function FontFamilyContent({ asChild, className, children }: FontFamilyPartProps): react.JSX.Element | null;
+declare function FontFamilyItem({ value, asChild, className, children }: FontFamilyItemProps): react.JSX.Element | null;
+/** The compound part with its sub-parts attached as statics. @public */
+interface FontFamilyNamespace {
+    (props: FontFamilyProps): ReactNode;
+    readonly docxSlot: 'font.family';
+    readonly Trigger: typeof FontFamilyTrigger;
+    readonly Content: typeof FontFamilyContent;
+    readonly Item: typeof FontFamilyItem;
+}
+declare const FontFamily: FontFamilyNamespace;
 
-/** The pane's tabs. Word's Replace tab is a later slice; nothing here pretends it exists. */
-type NavigationTab$1 = 'headings' | 'find';
-/** How `useNavigationPane` is configured. @public */
-interface UseNavigationPaneOptions {
-    /** Open state for the first render when the pane is uncontrolled. Defaults to closed. */
-    defaultOpen?: boolean;
-    /** Controlled open state. Pair with `onOpenChange`. */
-    open?: boolean;
-    onOpenChange?: (open: boolean) => void;
-    /** Tab shown first when uncontrolled. Defaults to `'headings'`. */
-    defaultTab?: NavigationTab$1;
-    /** Controlled tab. Pair with `onTabChange`. */
-    tab?: NavigationTab$1;
-    onTabChange?: (tab: NavigationTab$1) => void;
-    /** Panel width in px. Defaults to {@link NAVIGATION_PANE_WIDTH}. */
-    paneWidth?: number;
+/** One pickable paragraph style, as the document defines it. @public */
+interface ParagraphStyleOption {
+    readonly styleId: string;
+    readonly name: string;
+    /**
+     * How the style looks, for rendering the row in its own face. Every value arrives
+     * already bounded by the engine's derivation (family against the CSS-sink shape, colour
+     * against six hex digits), which is what makes it safe to put in a style object.
+     */
+    readonly preview: {
+        readonly fontFamily: string | null;
+        readonly fontSizePt: number | null;
+        readonly bold: boolean;
+        readonly italic: boolean;
+        readonly color: string | null;
+    };
 }
-/** What `useNavigationPane` answers. @public */
-interface UseNavigationPaneResult {
-    readonly open: boolean;
-    readonly setOpen: (open: boolean) => void;
-    readonly toggle: () => void;
-    readonly tab: NavigationTab$1;
-    readonly setTab: (tab: NavigationTab$1) => void;
-    readonly paneWidth: number;
+/** What `useParagraphStyle` answers. @public */
+interface UseParagraphStyleResult {
+    /** The selection's agreed paragraph styleId, or null (unstyled/default, or mixed). */
+    readonly value: string | null;
+    /** Apply a paragraph style through the can-before-exec path; a refusal is a safe no-op. */
+    readonly setValue: (styleId: string) => void;
     /**
-     * Px the chrome is displaced by, right now. `0` while the pane is closed AND whenever
-     * the left gutter was already wide enough to hold it — which is the point.
+     * The document's paragraph styles — validated ids and display names, in the engine's
+     * Word-gallery order (Normal, Title, Subtitle, the headings, then everything else in
+     * document order), NOT the order `styles.xml` happens to list them in.
      */
-    readonly shift: number;
+    readonly options: readonly ParagraphStyleOption[];
+    /** Whether the engine would honour a style change right now. */
+    readonly isEnabled: boolean;
 }
 /**
- * The navigation pane's behavior, with no UI attached: open state, the active tab, and
- * the document displacement an open pane is entitled to.
- *
- * `DocxEditor.Navigation` calls this and shares the result with its parts. Call it
- * directly to drive a pane of your own.
+ * The paragraph-style picker's behavior, UI-free.
  *
  * @public
  */
-declare function useNavigationPane(options?: UseNavigationPaneOptions): UseNavigationPaneResult;
+declare function useParagraphStyle(): UseParagraphStyleResult;
+/** Props for `DocxEditorToolbar.StylePicker` and its sub-parts. @public */
+interface ParagraphStylePartProps {
+    asChild?: boolean;
+    className?: string;
+    children?: DocxEditorChildren;
+}
+/** Props for the compound root. @public */
+interface ParagraphStyleProps extends ParagraphStylePartProps {
+    /** Render nothing — inside the default arrangement this removes the slot. */
+    hidden?: boolean;
+}
+/** Props for `ParagraphStyle.Item`. @public */
+interface ParagraphStyleItemProps extends ParagraphStylePartProps {
+    /** The styleId this item applies. */
+    value: string;
+}
+declare function ParagraphStyleTrigger({ asChild, className, children }: ParagraphStylePartProps): react.JSX.Element | null;
+declare namespace ParagraphStyleTrigger {
+    var docxToolbarPart: true;
+}
+declare function ParagraphStyleContent({ asChild, className, children }: ParagraphStylePartProps): react.JSX.Element | null;
+declare function ParagraphStyleItem({ value, asChild, className, children }: ParagraphStyleItemProps): react.JSX.Element | null;
+/** The compound part with its sub-parts attached as statics. @public */
+interface ParagraphStyleNamespace {
+    (props: ParagraphStyleProps): ReactNode;
+    readonly docxSlot: 'styles.style';
+    readonly Trigger: typeof ParagraphStyleTrigger;
+    readonly Content: typeof ParagraphStyleContent;
+    readonly Item: typeof ParagraphStyleItem;
+}
+declare const ParagraphStyle: ParagraphStyleNamespace;
 
-/** Shared props for the pane's structural parts. @public */
-interface NavigationPartProps {
+/** Props shared by contextual table toolbar compound parts. @public */
+interface TableChromePartProps {
+    /** Appended to the part root class list. */
     className?: string;
-    style?: CSSProperties;
+    /** When true, the part renders nothing. */
+    hidden?: boolean;
+    /** Merge props onto the single child element instead of rendering a default host node. */
+    asChild?: boolean;
+    /** Custom panel body or trigger label; defaults to the packaged control chrome. */
     children?: DocxEditorChildren;
 }
+/** Props for a value-driven row or swatch inside a table compound menu. @public */
+interface TableChromeItemProps extends TableChromePartProps {
+    /** The pick value this item dispatches (target id, style name, width size, or hex without `#`). */
+    value: string;
+}
 /**
- * The pane's title row. With no children it renders the close arrow and the title.
- *
- * @public
- */
-declare function NavigationHeader({ className, style, children, }: NavigationPartProps): ReactElement;
-/** The back arrow that closes the pane. @public */
-declare function NavigationClose({ className, style, children }: NavigationPartProps): ReactElement;
-/** The pane's heading text. @public */
-declare function NavigationTitle({ className, style, children }: NavigationPartProps): ReactElement;
-/**
- * The tab strip. With no children it renders one `Tab` per tab the pane supports.
- *
- * A real `role="tablist"`, so arrow keys move between tabs and a screen reader announces
- * the panel each one controls.
+ * Shared compound contract for menu-style table chrome parts
+ * ({@link TableBorderTargetNamespace}, {@link TableBorderStyleNamespace}, {@link TableBorderWidthNamespace}).
  *
  * @public
  */
-declare function NavigationTabs({ className, style, children }: NavigationPartProps): ReactElement;
-/** Props for one tab. @public */
-interface NavigationTabProps extends NavigationPartProps {
-    value: NavigationTab$1;
+interface TableChromePartComponent extends ToolbarSlotPartComponent {
+    /** The chrome slot this compound drives. */
+    readonly docxSlot: TableChromeSlotId;
+    /** Opens the picker menu or dialog. */
+    readonly Trigger: (props: TableChromePartProps) => DocxEditorChildren;
+    /** The open menu or dialog panel; omit to use the default item list. */
+    readonly Content: (props: TableChromePartProps) => DocxEditorChildren;
+    /** One selectable value row or swatch inside {@link Content}. */
+    readonly Item: (props: TableChromeItemProps) => DocxEditorChildren;
 }
-/** One tab button. Children replace the label. @public */
-declare function NavigationTab({ value, className, style, children, }: NavigationTabProps): ReactElement;
 /**
- * The heading list, indented by outline depth. Clicking a row moves the caret to that
- * heading and brings it into view.
- *
- * The filter box narrows the list CLIENT-SIDE — it hides rows whose text does not contain
- * what you typed. It is deliberately not the document search: filtering an outline and
- * searching a document are different questions, and the Find tab answers the second one.
+ * Border-target picker compound (`DocxEditor.Toolbar.TableBorderTarget`).
  *
  * @public
  */
-declare function NavigationHeadings({ className, style }: NavigationPartProps): ReactElement;
+interface TableBorderTargetNamespace extends TableChromePartComponent {
+    /** Chrome slot id: `table.borderTarget`. */
+    readonly docxSlot: 'table.borderTarget';
+    /** Button that opens the border-edge target menu. */
+    readonly Trigger: (props: TableChromePartProps) => DocxEditorChildren;
+    /** Open menu listing edge scopes and clear. */
+    readonly Content: (props: TableChromePartProps) => DocxEditorChildren;
+    /** One edge scope or clear row inside the target menu. */
+    readonly Item: (props: TableChromeItemProps) => DocxEditorChildren;
+}
 /**
- * The find panel: a query box, a result counter with previous/next, the match-case and
- * whole-word toggles, and the result list. Selecting a result moves the caret onto the
- * match and reveals its page.
+ * Border-colour split compound with a quick-apply main button and swatch dialog
+ * (`DocxEditor.Toolbar.TableBorderColor`).
  *
  * @public
  */
-declare function NavigationFind({ className, style }: NavigationPartProps): ReactElement;
+interface TableBorderColorNamespace extends TableChromePartComponent {
+    /** Chrome slot id: `table.borderColor`. */
+    readonly docxSlot: 'table.borderColor';
+    /** Applies the last swatch without opening the dialog. */
+    readonly Main: (props: TableChromePartProps) => DocxEditorChildren;
+    /** Button that opens the border-colour swatch dialog. */
+    readonly Trigger: (props: TableChromePartProps) => DocxEditorChildren;
+    /** Open swatch dialog for the active border target. */
+    readonly Content: (props: TableChromePartProps) => DocxEditorChildren;
+    /** One colour swatch inside the border-colour dialog. */
+    readonly Item: (props: TableChromeItemProps) => DocxEditorChildren;
+}
 /**
- * The collapsed pane's disc button. `DocxEditor.Navigation` renders one for you while the
- * pane is closed; place it yourself (a toolbar, a menu) with `toggle={false}` on the root.
+ * Cell-fill split compound (`DocxEditor.Toolbar.TableCellFill`).
  *
  * @public
  */
-declare function NavigationToggle({ className, style, children, }: NavigationPartProps): ReactElement;
-
-/** Props for `DocxEditor.Navigation`. @public */
-interface DocxEditorNavigationProps extends UseNavigationPaneOptions {
-    /**
-     * Label resolver. Defaults to the active `LocaleContext` catalogue (bundled English
-     * unless a provider swapped it), matching `<DocxEditor>`'s own default.
-     */
-    t?: (key: string, params?: Record<string, string | number>) => string;
-    /**
-     * The collapsed disc button. `false` removes it; an OBJECT is props for the packaged one,
-     * so a host can give it a class without restyling the library's.
-     *
-     * It is a prop rather than something you compose through `children` because the disc is
-     * rendered OUTSIDE the panel: the panel is `inert` while the pane is shut, which is
-     * exactly when the disc has to be clickable.
-     */
-    toggle?: boolean | NavigationPartProps;
-    className?: string;
-    style?: CSSProperties;
-    /** Replaces the default composition (header, tabs, both panels). */
-    children?: DocxEditorChildren;
+interface TableCellFillNamespace extends TableChromePartComponent {
+    /** Chrome slot id: `table.cellFill`. */
+    readonly docxSlot: 'table.cellFill';
+    /** Applies the last swatch without opening the dialog. */
+    readonly Main: (props: TableChromePartProps) => DocxEditorChildren;
+    /** Button that opens the cell-fill swatch dialog. */
+    readonly Trigger: (props: TableChromePartProps) => DocxEditorChildren;
+    /** Open swatch dialog for the selected cell(s). */
+    readonly Content: (props: TableChromePartProps) => DocxEditorChildren;
+    /** One fill swatch inside the cell-fill dialog. */
+    readonly Item: (props: TableChromeItemProps) => DocxEditorChildren;
 }
 /**
- * The document navigation pane — headings and find — over the left gutter.
+ * Border-style menu compound (`DocxEditor.Toolbar.TableBorderStyle`).
  *
  * @public
  */
-declare function DocxEditorNavigation(props: DocxEditorNavigationProps): ReactElement;
+interface TableBorderStyleNamespace extends TableChromePartComponent {
+    /** Chrome slot id: `table.borderStyle`. */
+    readonly docxSlot: 'table.borderStyle';
+    /** Button that opens the border line-style menu. */
+    readonly Trigger: (props: TableChromePartProps) => DocxEditorChildren;
+    /** Open menu listing line styles for the active target. */
+    readonly Content: (props: TableChromePartProps) => DocxEditorChildren;
+    /** One line-style row inside the style menu. */
+    readonly Item: (props: TableChromeItemProps) => DocxEditorChildren;
+}
 /**
- * `DocxEditor.Navigation` with its parts attached as statics.
+ * Border-width menu compound (`DocxEditor.Toolbar.TableBorderWidth`).
  *
  * @public
  */
-interface DocxEditorNavigationNamespace {
-    (props: DocxEditorNavigationProps): ReactElement;
-    readonly Header: typeof NavigationHeader;
-    readonly Close: typeof NavigationClose;
-    readonly Title: typeof NavigationTitle;
-    readonly Tabs: typeof NavigationTabs;
-    readonly Tab: typeof NavigationTab;
-    readonly Headings: typeof NavigationHeadings;
-    readonly Find: typeof NavigationFind;
-    readonly Toggle: typeof NavigationToggle;
+interface TableBorderWidthNamespace extends TableChromePartComponent {
+    /** Chrome slot id: `table.borderWidth`. */
+    readonly docxSlot: 'table.borderWidth';
+    /** Button that opens the border width menu. */
+    readonly Trigger: (props: TableChromePartProps) => DocxEditorChildren;
+    /** Open menu listing width presets for the active target. */
+    readonly Content: (props: TableChromePartProps) => DocxEditorChildren;
+    /** One width preset row inside the width menu. */
+    readonly Item: (props: TableChromeItemProps) => DocxEditorChildren;
 }
-declare const Navigation: DocxEditorNavigationNamespace;
-
 /**
- * One heading of the engine's outline: text, 0-based level, and the block id
- * `Editor.scrollToBlock` accepts.
+ * Resolved label for the active border target in the shared draft.
+ *
+ * For custom table chrome that shows the current target name outside the packaged picker.
  *
  * @public
  */
-type OutlineHeading$1 = ReturnType<Editor['getOutline']>[number];
-/** A heading plus how deep to indent it in a rendered list. @public */
-interface OutlineHeadingItem {
-    readonly heading: OutlineHeading$1;
+declare function useTableBorderTargetLabel(): string;
+
+/** Props for `DocxEditor.Toolbar`. @public */
+interface DocxEditorToolbarProps {
+    /** Appended after the base `docx-toolbar` class. */
+    className?: string;
+    /** i18n resolver for control labels; without it the raw keys show (never English). */
+    t?: ToolbarTranslate;
     /**
-     * Indent depth RELATIVE to the shallowest heading present, not the absolute level. A
-     * memo whose top sections are Heading 2 should left-align them at the base instead of
-     * carrying a phantom first-level indent.
+     * Handler for the `file.save` control. Save is not an engine command (`Editor.save()`
+     * returns bytes the host must deliver), so without a handler the control renders
+     * disabled — same contract as the Vue toolbar's `onSave`.
      */
-    readonly depth: number;
-}
-/** What `useDocumentOutline` answers. @public */
-interface UseDocumentOutlineResult {
-    /** The document's headings, in document order. Empty when it has none. */
-    readonly headings: readonly OutlineHeading$1[];
-    /** The same headings with their rendering depth resolved. */
-    readonly items: readonly OutlineHeadingItem[];
+    onSave?: () => void;
     /**
-     * The heading this pane last navigated to, so a list can show it as current. Tracks the
-     * PANE's navigation, not the caret: following the caret would mean walking the document
-     * on every selection change, and the engine has no derivation for it yet.
+     * `false` renders children verbatim with no default arrangement. Default `true`:
+     * part children override their slots in place, others append.
      */
-    readonly selectedBlockId: string | null;
-    /** Move the caret to a heading and bring it into view. Unknown ids are a safe no-op. */
-    readonly goTo: (blockId: string) => void;
-    readonly isEmpty: boolean;
-}
-/**
- * The document outline's behavior, with no UI attached: the headings, their nesting
- * depth, and the jump. `DocxEditor.Navigation.Headings` is this hook plus rows; a host
- * that wants a different list takes the hook and renders its own.
- *
- * @public
- */
-declare function useDocumentOutline(): UseDocumentOutlineResult;
-
-/** Milliseconds of quiet before a typed query is run against the document. */
-declare const SEARCH_DEBOUNCE_MS = 150;
-/**
- * The engine's cap on one search. A full result array means "at least this many"; the
- * hook reports that as {@link UseDocumentSearchResult.truncated}.
- */
-declare const SEARCH_MATCH_LIMIT = 2000;
-/** What `useDocumentSearch` answers. @public */
-interface UseDocumentSearchResult {
-    /** The text in the search box, updated synchronously as the user types. */
-    readonly query: string;
-    readonly setQuery: (query: string) => void;
-    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[];
+    preset?: boolean;
     /**
-     * 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.
+     * `false` lets the bar WRAP to more rows instead of collapsing groups into the "⋯"
+     * menu when it runs out of width. Default `true`.
      */
-    readonly truncated: boolean;
-    /** Index of the match the caret was last sent to, or `-1` before any navigation. */
-    readonly activeIndex: number;
-    /** Select a match by index and bring its page into view. Out-of-range is a no-op. */
-    readonly goTo: (index: number) => void;
-    /** Next / previous match, wrapping at the ends the way Word's arrows do. */
-    readonly next: () => void;
-    readonly previous: () => void;
-    /** 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;
+    overflow?: boolean;
+    children?: DocxEditorChildren;
+}
+/** The toolbar with its parts attached as statics. @public */
+interface DocxEditorToolbarNamespace {
+    (props: DocxEditorToolbarProps): ReactNode;
+    readonly Button: typeof ToolbarButton$1;
+    /** A host-owned action the chrome registry does not describe. */
+    readonly Action: typeof ToolbarAction;
+    readonly Separator: typeof ToolbarSeparator;
+    readonly Undo: ToolbarPartComponent;
+    readonly Redo: ToolbarPartComponent;
+    readonly Bold: ToolbarPartComponent;
+    readonly Italic: ToolbarPartComponent;
+    readonly Underline: ToolbarPartComponent;
+    readonly Strike: ToolbarPartComponent;
+    readonly Link: ToolbarPartComponent;
+    readonly ClearFormatting: ToolbarPartComponent;
+    readonly Superscript: ToolbarPartComponent;
+    readonly Subscript: ToolbarPartComponent;
+    readonly Alignment: ToolbarAlignmentComponent;
+    readonly AlignLeft: ToolbarPartComponent;
+    readonly AlignCenter: ToolbarPartComponent;
+    readonly AlignRight: ToolbarPartComponent;
+    readonly AlignJustify: ToolbarPartComponent;
+    readonly LineSpacing: ToolbarSlotPartComponent;
+    readonly BulletList: ToolbarPartComponent;
+    readonly NumberedList: ToolbarPartComponent;
+    readonly Outdent: ToolbarPartComponent;
+    readonly Indent: ToolbarPartComponent;
+    readonly ImageInsert: ToolbarPartComponent;
+    readonly ImageProperties: ToolbarPartComponent;
+    readonly ImageWrap: ImageWrapPartComponent;
+    readonly ImageAltText: ImageAltTextPartComponent;
+    readonly TableInsert: ToolbarPartComponent;
+    /** Border-edge target picker compound for contextual table chrome. */
+    readonly TableBorderTarget: TableBorderTargetNamespace;
+    /** Border-colour split compound (quick-apply main + swatch dialog). */
+    readonly TableBorderColor: TableBorderColorNamespace;
+    /** Border line-style menu compound. */
+    readonly TableBorderStyle: TableBorderStyleNamespace;
+    /** Border width menu compound. */
+    readonly TableBorderWidth: TableBorderWidthNamespace;
+    /** Cell background fill split compound (quick-apply main + swatch dialog). */
+    readonly TableCellFill: TableCellFillNamespace;
+    readonly Comments: ToolbarPartComponent;
+    readonly FontFamily: typeof FontFamily;
+    readonly FontSize: ToolbarSlotPartComponent;
+    readonly FontColor: ToolbarColorSplitComponent;
+    readonly Highlight: ToolbarColorSplitComponent;
+    readonly Zoom: ToolbarSlotPartComponent;
+    readonly StylePicker: typeof ParagraphStyle;
+    readonly EditingMode: ToolbarSlotPartComponent;
+    readonly Reviewers: typeof ToolbarReviewers;
+    readonly Save: ToolbarSlotPartComponent;
+    readonly ContentControlShowAll: ToolbarPartComponent;
+    readonly ContentControlFormFill: ToolbarPartComponent;
+    readonly ContentControlInspector: ToolbarPartComponent;
+    readonly ContentControlRemove: ToolbarPartComponent;
 }
 /**
- * The find panel's behavior, with no UI attached.
+ * The compound toolbar: `<DocxEditor.Toolbar/>` for the full working chrome, parts as
+ * statics for composition (`<DocxEditor.Toolbar><DocxEditor.Toolbar.Bold/>...`).
  *
  * @public
  */
-declare function useDocumentSearch(): UseDocumentSearchResult;
+declare const DocxEditorToolbar: DocxEditorToolbarNamespace;
 
-/** Panel width, in px, when the host does not choose one. */
-declare const NAVIGATION_PANE_WIDTH = 280;
-/**
- * Gap between the viewport's left edge and the panel.
- *
- * Clears a vertical ruler: `RULER_WIDTH` is 20px pinned at the viewport's left edge, so
- * anything less puts the panel and its collapsed disc on top of the tick marks.
- */
-declare const NAVIGATION_PANE_INSET = 32;
-/** Clearance kept between the panel's right edge and the page. */
-declare const NAVIGATION_PANE_GAP = 16;
-/** Total left space an open pane needs before the page may start. */
-declare function navigationPaneReservation(paneWidth?: number): number;
-interface NavigationShiftInput {
-    /** Client width of the scroll container. */
-    readonly viewportWidth: number;
-    /** Rendered width of one page, zoom applied. */
-    readonly pageWidthPx: number;
-    /** Space the open pane needs, from {@link navigationPaneReservation}. */
-    readonly reservation: number;
-    /** Padding already reserved at the inline end, for example by the review rail. */
-    readonly inlineEndReservation?: number;
+type MenuReviewersProps = {
+    className?: string;
+    hidden?: boolean;
+};
+/** The document-dependent Reviewers submenu. It changes view state only. @public */
+declare function MenuReviewers({ className, hidden }: MenuReviewersProps): react.JSX.Element | null;
+/** The packaged top-level Review menu. @public */
+declare const MenuReview: MenuPartComponent;
+
+/** Props for `DocxEditor.Menu`. @public */
+interface DocxEditorMenuProps {
+    /** Appended after the base `docx-menubar` class. */
+    className?: string;
+    /** i18n resolver for row labels; without it the raw keys show (never English). */
+    t?: ToolbarTranslate;
     /**
-     * Padding already standing at the inline START besides the shift itself — the review
-     * gutter's mirrored strip. It moves the page exactly as the shift does, so a shift
-     * computed without it lands the page that far past the reservation.
+     * Name for the file the packaged Save writes, without the extension. Ignored when
+     * `onSave` is given.
      */
-    readonly inlineStartReservation?: number;
+    fileName?: string;
     /**
-     * Whether the page's WIDTH follows the padding right now.
-     *
-     * This turns the answer binary, and it has to. The proportional branch below assumes a page
-     * of fixed width sitting in a shrinking box, so padding P moves it by P/2. Where the page is
-     * re-scaled to the padded box instead, a partial shift makes the page narrower, which widens
-     * the gutter, which asks for a smaller shift, which makes the page wider — the pane and the
-     * document chase each other every frame and never settle. Docked or not is a fixed point;
-     * anything in between is not.
-     *
-     * NOT "a fit mode is selected". The default fit is capped at 100%, and on any container with
-     * room for the sheet it sits AT that cap with the page a fixed width — exactly the case the
-     * proportional branch was written for. Reading the mode alone docked those containers too
-     * and pushed the page up to 128px further right than the pane needed. The question is
-     * whether the fit is BINDING, which is `zoom < maxZoom`.
+     * Replaces File › Open. The default opens a file picker and hands the bytes to
+     * `Editor.load` — a user-driven file READ, never a fetch.
      */
-    readonly docked?: boolean;
+    onOpen?: () => void;
+    /**
+     * Fired when the packaged Open reads a file, before its bytes are loaded — so a host can
+     * reflect the file's name in its own title chrome. Not fired when `onOpen` replaced the
+     * packaged picker: the host is reading the file itself and already holds the name.
+     */
+    onOpenFile?: (file: File) => void;
+    /** Replaces File › Save. The default runs `Editor.save()` and downloads the bytes. */
+    onSave?: () => void;
+    /** Owns Page Setup opening when `popups.pageSetup` is omitted. Use `popups` to customize its UI. */
+    onPageSetup?: () => void;
+    /**
+     * Replaces Help › Report issue. The default opens THIS project's issue tracker,
+     * prefilled with the current page URL and user agent — so a host embedding the editor
+     * in its own product should point this at its own support channel, or drop the row with
+     * `reportIssue={false}`.
+     */
+    onReportIssue?: () => void;
+    /** `false` removes Help › Report issue, and the Help menu with it. Default `true`. */
+    reportIssue?: boolean;
+    /**
+     * `false` renders children verbatim with no default arrangement. Default `true`: menu
+     * children override their menu in place, others append.
+     */
+    preset?: boolean;
+    children?: DocxEditorChildren;
+}
+/** The menu bar with its parts attached as statics. @public */
+interface DocxEditorMenuNamespace {
+    (props: DocxEditorMenuProps): ReactNode;
+    /** A menu of the bar, addressed by registry id. */
+    readonly Menu: typeof Menu;
+    readonly File: MenuPartComponent;
+    readonly Format: MenuPartComponent;
+    readonly Insert: MenuPartComponent;
+    readonly Review: typeof MenuReview;
+    readonly Help: MenuPartComponent;
+    /** One chrome slot as a live row. */
+    readonly Item: typeof MenuItem;
+    /** A presentational row, for a host action that is not a chrome slot. */
+    readonly Row: typeof MenuRow;
+    /** A named section of rows: a visible heading plus a real ARIA group. */
+    readonly Group: typeof MenuGroup;
+    readonly Separator: typeof MenuSeparator;
+    readonly Submenu: typeof MenuSubmenu;
+    /** Word's 6×6 insert-table size picker. */
+    readonly TableGrid: typeof MenuTableGrid;
+    /** One registry entry as its row, for a host arranging registry data itself. */
+    readonly Entry: typeof MenuEntry;
+    readonly Open: typeof MenuOpen;
+    readonly Save: typeof MenuSave;
+    readonly PageSetup: typeof MenuPageSetup;
+    /** Insert › Image, so a host can hide it or place it elsewhere by name. */
+    readonly ImageInsert: typeof MenuImageInsert;
+    /** Review > Markup Options > Reviewers. */
+    readonly Reviewers: typeof MenuReviewers;
+    /** Help › Report issue, so a host can drop it or point it elsewhere by name. */
+    readonly ReportIssue: typeof MenuReportIssue;
 }
 /**
- * The viewport's left padding, in px, that puts the page's left edge exactly at
- * `reservation` — and `0` whenever the gutter is already wide enough.
+ * The compound menu bar: `<DocxEditor.Menu/>` for File · Format · Insert · Review · Help, parts as
+ * statics for composition.
  *
- * Returns 0 for a degenerate measurement (a viewport that has not been laid out yet, a
- * document with no page setup) rather than guessing: shifting on a zero measurement would
- * make the pane jump on the first frame and settle on the second.
- */
-declare function navigationShift({ viewportWidth, pageWidthPx, reservation, inlineEndReservation, inlineStartReservation, docked, }: NavigationShiftInput): number;
-
-/**
- * The px the chrome is currently displaced by an open navigation pane. `0` when no pane
- * is mounted, when it is closed, and whenever the left gutter was already wide enough.
+ * Every actionable row is a chrome slot, so a row and its toolbar twin share one label,
+ * one icon, one command and one enabled state. Rows the engine cannot honour yet render
+ * present and disabled, carrying the engine's own reason.
  *
  * @public
  */
-declare function useNavigationShift(): number;
+declare const DocxEditorMenu: DocxEditorMenuNamespace;
 
-/** Props for `DocxEditor.PageSetupDialog`. @public */
-interface DocxEditorPageSetupDialogProps {
-    /** 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;
+/** Props for the context-fed ruler parts. @public */
+interface DocxEditorRulerProps {
+    /** Measurement unit for tick labels. Defaults to inches. */
+    unit?: 'inch' | 'cm';
     className?: string;
+    style?: CSSProperties;
 }
 /**
- * Page Setup dialog: size preset, orientation, margins in inches. Reads the section
- * through `usePageSetup()` and applies the whole form as one undoable command.
+ * The horizontal ruler as a context-fed part (`DocxEditor.HorizontalRuler`): page
+ * width, margins and zoom straight from the editor. Left/right margin handles are
+ * draggable when the engine supports page-setup writes; the drag previews locally and
+ * commits one undoable step on release.
  *
- * @public
- */
-declare function DocxEditorPageSetupDialog({ open, onClose, className, }: DocxEditorPageSetupDialogProps): ReactElement | null;
-
-/** Props for `DocxEditor.ParagraphDialog`. @public */
-interface DocxEditorParagraphDialogProps {
-    /** Whether the dialog is shown. The host owns this state. */
-    open: boolean;
-    /** Called on Cancel, Escape, overlay click, and after a successful OK. */
-    onClose: () => void;
-    className?: string;
-}
-/**
- * The Paragraph dialog. Reads the selection through `useParagraphFormat()` and applies
- * the whole form as one undoable command.
+ * Renders nothing while the editor holds no document — see
+ * {@link selectDocumentAbsent}.
  *
  * @public
  */
-declare function DocxEditorParagraphDialog({ open, onClose, className, }: DocxEditorParagraphDialogProps): ReactElement | null;
-
-/** Internal bridge from the batteries-included editor's `t` prop to this composition part. */
-declare const PageNumberTranslationContext: react.Context<((key: string) => string) | null>;
-/** Props for `DocxEditor.PageNumber`. @public */
-interface DocxEditorPageNumberProps {
-    /** Appended after the default page-number classes. */
-    className?: string;
-    /** Inline presentation overrides for the indicator element. */
-    style?: CSSProperties;
-}
+declare function DocxEditorHorizontalRuler(props: DocxEditorRulerProps): ReactElement | null;
 /**
- * Floating localized page readout for the active `DocxEditor.Viewport`.
+ * The vertical ruler as a context-fed part (`DocxEditor.VerticalRuler`): page height,
+ * margins and zoom straight from the editor. Top/bottom margin handles are draggable
+ * when the engine supports page-setup writes, committing one undoable step on release.
  *
- * Render it as a sibling of the viewport inside a positioned wrapper. It appears while a
- * multi-page document scrolls and fades after 600 ms of inactivity.
+ * Renders nothing while the editor holds no document — see
+ * {@link selectDocumentAbsent} — and nothing while the page is wider than the
+ * viewport: the ruler rides the scroller at content x=0, so a horizontal scroll
+ * would carry it out of view, and pinning it instead would paint ticks over page
+ * text. Word's web peers drop it on cramped viewports; so does this part, and it
+ * returns as soon as the page fits again.
  *
  * @public
  */
-declare function DocxEditorPageNumber({ className, style }: DocxEditorPageNumberProps): react.JSX.Element | null;
+declare function DocxEditorVerticalRuler(props: DocxEditorRulerProps): ReactElement | null;
 
-/** Props for `DocxEditor.FontNotice`. @public */
-interface DocxEditorFontNoticeProps {
-    /** Appended after the default notice classes. */
-    className?: string;
-    /** Inline presentation overrides for the notice element. */
-    style?: CSSProperties;
-    /** Translator override; defaults to the ambient locale context. */
-    t?: TFunction;
+/** Props for the context-fed outline part. @public */
+interface DocxEditorDocumentOutlineProps {
+    /** Close-button handler; without one the panel simply stays open. */
+    onClose?: () => void;
+    /** Vertical offset (px) inside the panel's positioning container. */
+    topOffset?: number;
+    /** Left anchor (px) inside the panel's positioning container. */
+    leftOffset?: number;
 }
 /**
- * Word-style font compatibility notice.
+ * The document outline as a context-fed part (`DocxEditor.DocumentOutline`): headings
+ * from `Editor.getOutline()`, in document order; clicking one moves the caret to that
+ * heading. The panel positions absolutely — give it a `position: relative` container.
  *
- * Shown when the open document declares font families this platform cannot resolve —
- * not installed, not embedded in the file, not supplied by the app's font
- * configuration — so the text is rendering in a substitute face. Dismissing hides the
- * notice for that set of families; a different document (or a font arriving) changes
- * the set and surfaces it again.
+ * Renders nothing while the editor has no document — a floating panel saying "no
+ * headings" about a document that is not there is the same false claim the rulers made.
  *
  * @public
  */
-declare function DocxEditorFontNotice({ className, style, t: tProp }: DocxEditorFontNoticeProps): react.JSX.Element | null;
+declare function DocxEditorDocumentOutline(props: DocxEditorDocumentOutlineProps): ReactElement | null;
 
-/** Props for `DocxEditor.HeaderFooterChrome`. @public */
-interface DocxEditorHeaderFooterChromeProps {
-    className?: string;
+/** The pane's tabs. Word's Replace tab is a later slice; nothing here pretends it exists. */
+type NavigationTab$1 = 'headings' | 'find';
+/** How `useNavigationPane` is configured. @public */
+interface UseNavigationPaneOptions {
+    /** Open state for the first render when the pane is uncontrolled. Defaults to closed. */
+    defaultOpen?: boolean;
+    /** Controlled open state. Pair with `onOpenChange`. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Tab shown first when uncontrolled. Defaults to `'headings'`. */
+    defaultTab?: NavigationTab$1;
+    /** Controlled tab. Pair with `onTabChange`. */
+    tab?: NavigationTab$1;
+    onTabChange?: (tab: NavigationTab$1) => void;
+    /** Panel width in px. Defaults to {@link NAVIGATION_PANE_WIDTH}. */
+    paneWidth?: number;
+}
+/** What `useNavigationPane` answers. @public */
+interface UseNavigationPaneResult {
+    readonly open: boolean;
+    readonly setOpen: (open: boolean) => void;
+    readonly toggle: () => void;
+    readonly tab: NavigationTab$1;
+    readonly setTab: (tab: NavigationTab$1) => void;
+    readonly paneWidth: number;
+    /**
+     * Px the chrome is displaced by, right now. `0` while the pane is closed AND whenever
+     * the left gutter was already wide enough to hold it — which is the point.
+     */
+    readonly shift: number;
 }
 /**
- * Thin overlay while a header or footer scope is open: region label and contextual options.
- * Mount beside `DocxEditor.Content`.
+ * The navigation pane's behavior, with no UI attached: open state, the active tab, and
+ * the document displacement an open pane is entitled to.
+ *
+ * `DocxEditor.Navigation` calls this and shares the result with its parts. Call it
+ * directly to drive a pane of your own.
  *
  * @public
  */
-declare function DocxEditorHeaderFooterChrome({ className, }: DocxEditorHeaderFooterChromeProps): ReactElement | null;
+declare function useNavigationPane(options?: UseNavigationPaneOptions): UseNavigationPaneResult;
 
-/** Shared props for every part. @public */
-interface HyperLinkPartProps {
+/** Shared props for the pane's structural parts. @public */
+interface NavigationPartProps {
     className?: string;
-    /** Merge this part's wiring onto the single child element instead of the default one. */
-    asChild?: boolean;
-    /** Render nothing — inside the default arrangement this removes the part. */
-    hidden?: boolean;
+    style?: CSSProperties;
     children?: DocxEditorChildren;
 }
-/** Props for the action parts, which also take an icon. @public */
-interface HyperLinkActionProps extends HyperLinkPartProps {
-    /** Icon override; falls back to `children`, then to the part's default glyph. */
-    icon?: DocxEditorChildren;
-}
-/** Props for `DocxEditor.HyperLink`. @public */
-interface HyperLinkProps extends HyperLinkPartProps {
-    /**
-     * Render the packaged arrangement. `false` mounts only the popover shell and whatever
-     * parts you pass as children — the rung for "I want the wiring, not the layout".
-     */
-    preset?: boolean;
-}
 /**
- * The popover panel.
+ * The pane's title row. With no children it renders the close arrow and the title.
  *
- * Positioned inside the VIEWPORT (the scroll container), so ordinary CSS keeps it attached to
- * the page while the user scrolls — no scroll listener, no per-frame reposition. The
- * coordinates the engine reports are viewport-relative, so they are converted against the
- * container's own rect once, at open.
+ * @public
  */
-declare function HyperLinkRoot({ className, asChild, hidden, children, preset }: HyperLinkProps): react.JSX.Element | null;
-/** The target readout, and the action that follows it. @public */
-declare function HyperLinkUrl({ className, asChild, hidden, children }: HyperLinkPartProps): react.JSX.Element | null;
-declare namespace HyperLinkUrl {
-    var docxHyperLinkPart: "Url";
-}
-/** Copy the sanitized target to the clipboard. @public */
-declare function HyperLinkCopy({ className, asChild, hidden, children, icon: glyph, }: HyperLinkActionProps): react.JSX.Element | null;
-declare namespace HyperLinkCopy {
-    var docxHyperLinkPart: "Copy";
-}
-/** Switch the panel into edit mode. @public */
-declare function HyperLinkEdit({ className, asChild, hidden, children, icon: glyph, }: HyperLinkActionProps): react.JSX.Element | null;
-declare namespace HyperLinkEdit {
-    var docxHyperLinkPart: "Edit";
-}
-/** Remove the link, keeping its text. @public */
-declare function HyperLinkUnlink({ className, asChild, hidden, children, icon: glyph, }: HyperLinkActionProps): react.JSX.Element | null;
-declare namespace HyperLinkUnlink {
-    var docxHyperLinkPart: "Unlink";
-}
-/** Display-text and URL fields. @public */
-declare function HyperLinkFields({ className, hidden }: HyperLinkPartProps): react.JSX.Element | null;
-declare namespace HyperLinkFields {
-    var docxHyperLinkPart: "Fields";
-}
-/** Commit the draft. @public */
-declare function HyperLinkApply({ className, asChild, hidden, children }: HyperLinkPartProps): react.JSX.Element | null;
-declare namespace HyperLinkApply {
-    var docxHyperLinkPart: "Apply";
-}
+declare function NavigationHeader({ className, style, children, }: NavigationPartProps): ReactElement;
+/** The back arrow that closes the pane. @public */
+declare function NavigationClose({ className, style, children }: NavigationPartProps): ReactElement;
+/** The pane's heading text. @public */
+declare function NavigationTitle({ className, style, children }: NavigationPartProps): ReactElement;
 /**
- * Why the last Apply did nothing.
+ * The tab strip. With no children it renders one `Tab` per tab the pane supports.
  *
- * A refusal that closes nothing and says nothing is the worst of both: the panel sits open
- * and the user re-presses the same button. The engine already knows the reason (a scheme it
- * will not write, a selection spanning paragraphs, no text to link); this shows it.
+ * A real `role="tablist"`, so arrow keys move between tabs and a screen reader announces
+ * the panel each one controls.
+ *
+ * @public
  */
-declare function HyperLinkError({ className, hidden }: HyperLinkPartProps): react.JSX.Element | null;
-declare namespace HyperLinkError {
-    var docxHyperLinkPart: "Error";
-}
-/** Dismiss without applying. @public */
-declare function HyperLinkCancel({ className, asChild, hidden, children }: HyperLinkPartProps): react.JSX.Element | null;
-declare namespace HyperLinkCancel {
-    var docxHyperLinkPart: "Cancel";
+declare function NavigationTabs({ className, style, children }: NavigationPartProps): ReactElement;
+/** Props for one tab. @public */
+interface NavigationTabProps extends NavigationPartProps {
+    value: NavigationTab$1;
 }
+/** One tab button. Children replace the label. @public */
+declare function NavigationTab({ value, className, style, children, }: NavigationTabProps): ReactElement;
 /**
- * The link popover compound.
+ * The heading list, indented by outline depth. Clicking a row moves the caret to that
+ * heading and brings it into view.
+ *
+ * The filter box narrows the list CLIENT-SIDE — it hides rows whose text does not contain
+ * what you typed. It is deliberately not the document search: filtering an outline and
+ * searching a document are different questions, and the Find tab answers the second one.
  *
  * @public
  */
-interface DocxEditorHyperLinkNamespace {
-    (props: HyperLinkProps): ReturnType<typeof HyperLinkRoot>;
-    readonly Url: typeof HyperLinkUrl;
-    readonly Copy: typeof HyperLinkCopy;
-    readonly Edit: typeof HyperLinkEdit;
-    readonly Unlink: typeof HyperLinkUnlink;
-    readonly Fields: typeof HyperLinkFields;
-    readonly Error: typeof HyperLinkError;
-    readonly Apply: typeof HyperLinkApply;
-    readonly Cancel: typeof HyperLinkCancel;
-}
-declare const DocxEditorHyperLink: DocxEditorHyperLinkNamespace;
-
-/** Default equation editor mounted by the packaged React host. */
-declare function DocxEditorEquation(): react.JSX.Element | null;
-
+declare function NavigationHeadings({ className, style }: NavigationPartProps): ReactElement;
 /**
- * Subscribe to the active note view scope with reference-stable results when unchanged.
+ * The find panel: a query box, a result counter with previous/next, the match-case and
+ * whole-word toggles, and the result list. Selecting a result moves the caret onto the
+ * match and reveals its page.
  *
  * @public
  */
-declare function useNoteScopeState(): Extract<ViewScope, {
-    kind: 'note';
-}> | null;
-type NotePropertiesState = Exclude<ReturnType<Editor['getNotePropertiesState']>, null>;
+declare function NavigationFind({ className, style }: NavigationPartProps): ReactElement;
 /**
- * Subscribe to `getNotePropertiesState()` with reference-stable results when unchanged.
+ * The collapsed pane's disc button. `DocxEditor.Navigation` renders one for you while the
+ * pane is closed; place it yourself (a toolbar, a menu) with `toggle={false}` on the root.
  *
  * @public
  */
-declare function useNotePropertiesState(): NotePropertiesState | null;
-
-/** Props for `DocxEditor.NotesChrome`. @public */
-interface DocxEditorNotesChromeProps {
-    className?: string;
-}
-declare function DocxEditorNotesChrome({ className, }: DocxEditorNotesChromeProps): ReactElement | null;
+declare function NavigationToggle({ className, style, children, }: NavigationPartProps): ReactElement;
 
-/** Props for a packaged context-menu row. @public */
-interface ContextMenuCommandProps {
-    /** Icon override. Defaults to the row's own Material Symbol. */
-    icon?: DocxEditorChildren;
-    /** i18n key for the label, overriding the packaged one. */
-    labelKey?: string;
-    /** i18n key for the shortcut column, overriding the packaged one. */
-    shortcutKey?: string;
+/** Props for `DocxEditor.Navigation`. @public */
+interface DocxEditorNavigationProps extends UseNavigationPaneOptions {
+    /**
+     * Label resolver. Defaults to the active `LocaleContext` catalogue (bundled English
+     * unless a provider swapped it), matching `<DocxEditor>`'s own default.
+     */
+    t?: (key: string, params?: Record<string, string | number>) => string;
+    /**
+     * The collapsed disc button. `false` removes it; an OBJECT is props for the packaged one,
+     * so a host can give it a class without restyling the library's.
+     *
+     * It is a prop rather than something you compose through `children` because the disc is
+     * rendered OUTSIDE the panel: the panel is `inert` while the pane is shut, which is
+     * exactly when the disc has to be clickable.
+     */
+    toggle?: boolean | NavigationPartProps;
     className?: string;
-    /** Render nothing — inside the default set this removes the row. */
-    hidden?: boolean;
+    style?: CSSProperties;
+    /** Replaces the default composition (header, tabs, both panels). */
+    children?: DocxEditorChildren;
 }
-/** Cut the selection to the clipboard. Disabled with the engine's reason when nothing is selected. @public */
-declare const ContextMenuCut: (({ icon, labelKey, shortcutKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
-    docxRow: string;
-};
-/** Copy the selection. Stays available in a read-only document. @public */
-declare const ContextMenuCopy: (({ icon, labelKey, shortcutKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
-    docxRow: string;
-};
-/** Delete the selection. @public */
-declare const ContextMenuDelete: (({ icon, labelKey, shortcutKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
-    docxRow: string;
-};
-/** Select the whole body. @public */
-declare const ContextMenuSelectAll: (({ icon, labelKey, shortcutKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
-    docxRow: string;
-};
 /**
- * Paste the clipboard's text at the selection.
- *
- * THE ROW READS THE CLIPBOARD, not the engine. `exec` is synchronous and clipboard read is
- * not — it prompts in Chrome and is refused outright by Firefox and Safari — so the read
- * happens here, inside the click that asked for it, where the permission gesture belongs,
- * and the text goes to the engine as an argument.
- *
- * Nothing can know whether the read will succeed BEFORE it is attempted, so the row starts
- * enabled (when the engine would accept a paste at all) and disables itself, with the
- * browser's own reason, once a read has actually been refused. Guessing the answer up front
- * would either grey out a working Paste on Chrome or advertise a dead one on Safari.
+ * The document navigation pane — headings and find — over the left gutter.
  *
  * @public
  */
-declare function ContextMenuPaste({ icon, labelKey, shortcutKey, className, hidden, }: ContextMenuCommandProps): react.JSX.Element | null;
-declare namespace ContextMenuPaste {
-    var docxRow: "edit.paste";
-}
+declare function DocxEditorNavigation(props: DocxEditorNavigationProps): ReactElement;
 /**
- * Paste the clipboard's plain text as if typed, whatever richer flavours it holds.
- *
- * The Cmd+Shift+V twin as a menu row: same clipboard-read contract as
- * {@link ContextMenuPaste}, routed through the `pasteWithoutFormatting` command.
+ * `DocxEditor.Navigation` with its parts attached as statics.
  *
  * @public
  */
-declare function ContextMenuPasteWithoutFormatting({ icon, labelKey, shortcutKey, className, hidden, }: ContextMenuCommandProps): react.JSX.Element | null;
-declare namespace ContextMenuPasteWithoutFormatting {
-    var docxRow: "edit.pasteWithoutFormatting";
+interface DocxEditorNavigationNamespace {
+    (props: DocxEditorNavigationProps): ReactElement;
+    readonly Header: typeof NavigationHeader;
+    readonly Close: typeof NavigationClose;
+    readonly Title: typeof NavigationTitle;
+    readonly Tabs: typeof NavigationTabs;
+    readonly Tab: typeof NavigationTab;
+    readonly Headings: typeof NavigationHeadings;
+    readonly Find: typeof NavigationFind;
+    readonly Toggle: typeof NavigationToggle;
 }
+declare const Navigation: DocxEditorNavigationNamespace;
+
 /**
- * Copy the formatting at the selection — the Format Painter's read half.
- *
- * Stays available in a read-only document, like Copy: it writes nothing.
+ * One heading of the engine's outline: text, 0-based level, and the block id
+ * `Editor.scrollToBlock` accepts.
  *
  * @public
  */
-declare const ContextMenuCopyFormatting: (({ icon, labelKey, shortcutKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
-    docxRow: string;
-};
+type OutlineHeading$1 = ReturnType<Editor['getOutline']>[number];
+/** A heading plus how deep to indent it in a rendered list. @public */
+interface OutlineHeadingItem {
+    readonly heading: OutlineHeading$1;
+    /**
+     * Indent depth RELATIVE to the shallowest heading present, not the absolute level. A
+     * memo whose top sections are Heading 2 should left-align them at the base instead of
+     * carrying a phantom first-level indent.
+     */
+    readonly depth: number;
+}
+/** What `useDocumentOutline` answers. @public */
+interface UseDocumentOutlineResult {
+    /** The document's headings, in document order. Empty when it has none. */
+    readonly headings: readonly OutlineHeading$1[];
+    /** The same headings with their rendering depth resolved. */
+    readonly items: readonly OutlineHeadingItem[];
+    /**
+     * The heading this pane last navigated to, so a list can show it as current. Tracks the
+     * PANE's navigation, not the caret: following the caret would mean walking the document
+     * on every selection change, and the engine has no derivation for it yet.
+     */
+    readonly selectedBlockId: string | null;
+    /** Move the caret to a heading and bring it into view. Unknown ids are a safe no-op. */
+    readonly goTo: (blockId: string) => void;
+    readonly isEmpty: boolean;
+}
 /**
- * Apply the copied formatting to the selection.
- *
- * Disabled with the engine's own reason until something has been copied, so the row says
- * why rather than looking live and doing nothing.
+ * The document outline's behavior, with no UI attached: the headings, their nesting
+ * depth, and the jump. `DocxEditor.Navigation.Headings` is this hook plus rows; a host
+ * that wants a different list takes the hook and renders its own.
  *
  * @public
  */
-declare const ContextMenuPasteFormatting: (({ icon, labelKey, shortcutKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
-    docxRow: string;
-};
-/** Props for packaged table context-menu rows. @public */
-interface ContextMenuTableRowProps extends ContextMenuCommandProps {
-    /** When true, the row uses the destructive treatment. */
-    destructive?: boolean;
-}
-/** Insert a row above the current table row. @public */
-declare const ContextMenuInsertRowAbove: (({ icon, labelKey, className, hidden, destructive }: ContextMenuTableRowProps) => react.JSX.Element | null) & {
-    docxRow: string;
-};
-/** Insert a row below the current table row. @public */
-declare const ContextMenuInsertRowBelow: (({ icon, labelKey, className, hidden, destructive }: ContextMenuTableRowProps) => react.JSX.Element | null) & {
-    docxRow: string;
-};
-/** Insert a column to the left of the current column. @public */
-declare const ContextMenuInsertColumnLeft: (({ icon, labelKey, className, hidden, destructive }: ContextMenuTableRowProps) => react.JSX.Element | null) & {
-    docxRow: string;
-};
-/** Insert a column to the right of the current column. @public */
-declare const ContextMenuInsertColumnRight: (({ icon, labelKey, className, hidden, destructive }: ContextMenuTableRowProps) => 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;
-};
-/** Delete the current table column. @public */
-declare const ContextMenuDeleteTableColumn: (({ icon, labelKey, className, hidden, destructive }: ContextMenuTableRowProps) => react.JSX.Element | null) & {
-    docxRow: string;
-};
-/** Delete the entire table. @public */
-declare const ContextMenuDeleteTable: (({ icon, labelKey, className, hidden, destructive }: ContextMenuTableRowProps) => react.JSX.Element | null) & {
-    docxRow: string;
-};
-/** Compact vertical-alignment picker for selected table cells. @public */
-declare function ContextMenuCellVerticalAlignment({ hidden }: ContextMenuCommandProps): react.JSX.Element | null;
-declare namespace ContextMenuCellVerticalAlignment {
-    var docxRow: "table.cellVerticalAlignment";
-}
-/** Rebuild the pointed-at table of contents from the document's headings. @public */
-declare const ContextMenuRefreshToc: (({ icon, labelKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
-    docxRow: string;
-};
-/** Re-resolve only the page numbers of the pointed-at table of contents. @public */
-declare const ContextMenuRefreshTocPageNumbers: (({ icon, labelKey, className, hidden }: ContextMenuCommandProps) => react.JSX.Element | null) & {
-    docxRow: string;
-};
-/** Props for `DocxEditor.ContextMenu.Item`: a host-owned row. @public */
-interface ContextMenuItemProps {
+declare function useDocumentOutline(): UseDocumentOutlineResult;
+
+/** Milliseconds of quiet before a typed query is run against the document. */
+declare const SEARCH_DEBOUNCE_MS = 150;
+/**
+ * The engine's cap on one search. A full result array means "at least this many"; the
+ * hook reports that as {@link UseDocumentSearchResult.truncated}.
+ */
+declare const SEARCH_MATCH_LIMIT = 2000;
+/** What `useDocumentSearch` answers. @public */
+interface UseDocumentSearchResult {
+    /** The text in the search box, updated synchronously as the user types. */
+    readonly query: string;
+    readonly setQuery: (query: string) => void;
+    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[];
     /**
-     * Label, as a resolved STRING rather than an i18n key — the row belongs to the host's own
-     * action, so the host's own catalogue resolves it. The packaged rows go the other way.
+     * 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.
      */
-    label: string;
-    icon?: DocxEditorChildren;
-    /** Right-aligned shortcut text, already resolved. */
-    shortcut?: string;
-    disabled?: boolean;
-    /** Tooltip when disabled. Say why — never invent a reason the engine did not give. */
-    disabledReason?: string;
-    /** Checked state, for a row that toggles. Leave undefined on a row that just acts. */
-    active?: boolean;
-    onSelect?: () => void;
-    className?: string;
+    readonly truncated: boolean;
+    /** Index of the match the caret was last sent to, or `-1` before any navigation. */
+    readonly activeIndex: number;
+    /** Select a match by index and bring its page into view. Out-of-range is a no-op. */
+    readonly goTo: (index: number) => void;
+    /** Next / previous match, wrapping at the ends the way Word's arrows do. */
+    readonly next: () => void;
+    readonly previous: () => void;
+    /** 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;
 }
 /**
- * A host-owned context-menu row, styled and behaved like the packaged ones.
- *
- * The toolbar's `Action` for the right-click surface: no slot, no command, no engine wiring
- * — enabled state and the action are the host's, because the engine has no opinion about an
- * action it does not model. Selecting it closes the menu.
+ * The find panel's behavior, with no UI attached.
  *
  * @public
  */
-declare function ContextMenuItem({ label, icon, shortcut, disabled, disabledReason, active, onSelect, className, }: ContextMenuItemProps): react.JSX.Element;
+declare function useDocumentSearch(): UseDocumentSearchResult;
 
-/** Props for `DocxEditor.ContextMenu`. @public */
-interface DocxEditorContextMenuProps {
-    /** Appended after the base `docx-contextmenu` class. */
-    className?: string;
-    /** i18n resolver for row labels; without it the raw keys show (never English). */
-    t?: ToolbarTranslate;
+/** Panel width, in px, when the host does not choose one. */
+declare const NAVIGATION_PANE_WIDTH = 280;
+/**
+ * Gap between the viewport's left edge and the panel.
+ *
+ * Clears a vertical ruler: `RULER_WIDTH` is 20px pinned at the viewport's left edge, so
+ * anything less puts the panel and its collapsed disc on top of the tick marks.
+ */
+declare const NAVIGATION_PANE_INSET = 32;
+/** Clearance kept between the panel's right edge and the page. */
+declare const NAVIGATION_PANE_GAP = 16;
+/** Total left space an open pane needs before the page may start. */
+declare function navigationPaneReservation(paneWidth?: number): number;
+interface NavigationShiftInput {
+    /** Client width of the scroll container. */
+    readonly viewportWidth: number;
+    /** Rendered width of one page, zoom applied. */
+    readonly pageWidthPx: number;
+    /** Space the open pane needs, from {@link navigationPaneReservation}. */
+    readonly reservation: number;
+    /** Padding already reserved at the inline end, for example by the review rail. */
+    readonly inlineEndReservation?: number;
     /**
-     * `false` renders children verbatim with no default set. Default `true`: a child naming a
-     * packaged row overrides it in place, others append.
+     * Padding already standing at the inline START besides the shift itself — the review
+     * gutter's mirrored strip. It moves the page exactly as the shift does, so a shift
+     * computed without it lands the page that far past the reservation.
      */
-    preset?: boolean;
+    readonly inlineStartReservation?: number;
     /**
-     * `true` suppresses the panel entirely and lets the browser's own menu through. For a
-     * host that wants the native menu back on some documents without unmounting the part.
+     * Whether the page's WIDTH follows the padding right now.
+     *
+     * This turns the answer binary, and it has to. The proportional branch below assumes a page
+     * of fixed width sitting in a shrinking box, so padding P moves it by P/2. Where the page is
+     * re-scaled to the padded box instead, a partial shift makes the page narrower, which widens
+     * the gutter, which asks for a smaller shift, which makes the page wider — the pane and the
+     * document chase each other every frame and never settle. Docked or not is a fixed point;
+     * anything in between is not.
+     *
+     * NOT "a fit mode is selected". The default fit is capped at 100%, and on any container with
+     * room for the sheet it sits AT that cap with the page a fixed width — exactly the case the
+     * proportional branch was written for. Reading the mode alone docked those containers too
+     * and pushed the page up to 128px further right than the pane needed. The question is
+     * whether the fit is BINDING, which is `zoom < maxZoom`.
      */
-    disabled?: boolean;
-    /** Notified whenever the panel opens or closes. */
-    onOpenChange?: (open: boolean) => void;
-    children?: DocxEditorChildren;
+    readonly docked?: boolean;
 }
 /**
- * The packaged right-click menu over the painted document.
+ * The viewport's left padding, in px, that puts the page's left edge exactly at
+ * `reservation` — and `0` whenever the gutter is already wide enough.
  *
- * Mounted by default inside `DocxEditor.Viewport`; `contextMenu={false}` on `DocxEditor`
- * removes it. Rendered as a child of the viewport so it finds its own surface, but
- * positioned in client space, so it is never clipped by the scroller.
+ * Returns 0 for a degenerate measurement (a viewport that has not been laid out yet, a
+ * document with no page setup) rather than guessing: shifting on a zero measurement would
+ * make the pane jump on the first frame and settle on the second.
+ */
+declare function navigationShift({ viewportWidth, pageWidthPx, reservation, inlineEndReservation, inlineStartReservation, docked, }: NavigationShiftInput): number;
+
+/**
+ * The px the chrome is currently displaced by an open navigation pane. `0` when no pane
+ * is mounted, when it is closed, and whenever the left gutter was already wide enough.
  *
  * @public
  */
-declare function DocxEditorContextMenu({ className, t, preset, disabled, onOpenChange, children, }: DocxEditorContextMenuProps): react.JSX.Element;
+declare function useNavigationShift(): number;
+
+/** Internal bridge from the batteries-included editor's `t` prop to this composition part. */
+declare const PageNumberTranslationContext: react.Context<((key: string) => string) | null>;
+/** Props for `DocxEditor.PageNumber`. @public */
+interface DocxEditorPageNumberProps {
+    /** Appended after the default page-number classes. */
+    className?: string;
+    /** Inline presentation overrides for the indicator element. */
+    style?: CSSProperties;
+}
 /**
- * `DocxEditor.ContextMenu` with its rows attached as statics.
+ * Floating localized page readout for the active `DocxEditor.Viewport`.
+ *
+ * Render it as a sibling of the viewport inside a positioned wrapper. It appears while a
+ * multi-page document scrolls and fades after 600 ms of inactivity.
  *
  * @public
  */
-interface DocxEditorContextMenuNamespace {
-    (props: DocxEditorContextMenuProps): ReactElement;
-    readonly Cut: typeof ContextMenuCut;
-    readonly Copy: typeof ContextMenuCopy;
-    readonly Paste: typeof ContextMenuPaste;
-    readonly PasteWithoutFormatting: typeof ContextMenuPasteWithoutFormatting;
-    readonly Delete: typeof ContextMenuDelete;
-    readonly SelectAll: typeof ContextMenuSelectAll;
-    readonly InsertRowAbove: typeof ContextMenuInsertRowAbove;
-    readonly InsertRowBelow: typeof ContextMenuInsertRowBelow;
-    readonly InsertColumnLeft: typeof ContextMenuInsertColumnLeft;
-    readonly InsertColumnRight: typeof ContextMenuInsertColumnRight;
-    readonly DeleteTableRow: typeof ContextMenuDeleteTableRow;
-    readonly DeleteTableColumn: typeof ContextMenuDeleteTableColumn;
-    readonly DeleteTable: typeof ContextMenuDeleteTable;
-    readonly CellVerticalAlignment: typeof ContextMenuCellVerticalAlignment;
-    readonly RefreshToc: typeof ContextMenuRefreshToc;
-    readonly RefreshTocPageNumbers: typeof ContextMenuRefreshTocPageNumbers;
-    /** A host-owned row: no slot, no command, the host's own label and action. */
-    readonly Item: typeof ContextMenuItem;
-    /** Any chrome slot as a live row (`<ContextMenu.Slot slot="text.bold" />`). */
-    readonly Slot: typeof MenuItem;
-    /** Bare row presentation, for a host building something the parts do not cover. */
-    readonly Row: typeof MenuRow;
-    /** A named section of rows: a visible heading plus a real ARIA group. */
-    readonly Group: typeof MenuGroup;
-    readonly Separator: typeof MenuSeparator;
-    readonly Submenu: typeof MenuSubmenu;
-}
-declare const ContextMenu: DocxEditorContextMenuNamespace;
+declare function DocxEditorPageNumber({ className, style }: DocxEditorPageNumberProps): react.JSX.Element | null;
 
-/** Where the panel opened, in client coordinates. */
-interface ContextMenuAnchor {
-    readonly x: number;
-    readonly y: number;
-}
-interface ContextMenuContextValue {
-    /**
-     * Close the panel. `restoreFocus` on the paths where the user is FINISHING with the menu
-     * (selecting a row); not on the ones where they are already going elsewhere.
-     */
-    readonly close: (restoreFocus?: boolean) => void;
-    /** Non-null exactly while the panel is open. */
-    readonly anchor: ContextMenuAnchor | null;
-    /**
-     * The table of contents this open was over, captured AT OPEN TIME.
-     *
-     * Read imperatively from the editor in the same event that opens the panel, not
-     * subscribed to. The engine records the right-click target and the panel opens from the
-     * same event, so a subscription is a render behind: the first right-click on a TOC drew
-     * the menu without its rows and only a second one had them. It is also the more honest
-     * shape — an open menu describes the gesture that opened it, whatever happens next.
-     */
-    readonly tocId: string | null;
-    /**
-     * The element the opening right-click landed on, captured AT OPEN TIME like {@link tocId}.
-     *
-     * What lets a contextual row decide it applies — a custom-node chip, a painted marker —
-     * without installing a second `contextmenu` listener that could disagree with the one
-     * that opened the panel. Null while closed, and for keyboard-invoked opens, which have
-     * no pointer target.
-     */
-    readonly target: HTMLElement | null;
-    /**
-     * The browser's reason for refusing a clipboard READ, once one has actually been refused.
-     *
-     * Lives on the ROOT rather than in the Paste row because selecting that row closes the
-     * panel, which unmounts the row — state kept there was written and discarded in the same
-     * batch, so the row it was meant to disable came back enabled on the next right-click and
-     * the documented behaviour never once happened. Firefox and Safari refuse every read, so
-     * "ask once, then stop offering it" has to outlive one open.
-     */
-    readonly clipboardRefusal: string | null;
-    readonly reportClipboardRefusal: (reason: string) => void;
+/** Props for `DocxEditor.FontNotice`. @public */
+interface DocxEditorFontNoticeProps {
+    /** Appended after the default notice classes. */
+    className?: string;
+    /** Inline presentation overrides for the notice element. */
+    style?: CSSProperties;
+    /** Translator override; defaults to the ambient locale context. */
+    t?: TFunction;
 }
 /**
- * The element the opening right-click landed on, or null while the menu is closed.
+ * Word-style font compatibility notice.
  *
- * Public so capability packages can render contextual sections — a row that only exists
- * when the press landed on their own painted chrome — without a second listener.
+ * Shown when the open document declares font families this platform cannot resolve —
+ * not installed, not embedded in the file, not supplied by the app's font
+ * configuration — so the text is rendering in a substitute face. Dismissing hides the
+ * notice for that set of families; a different document (or a font arriving) changes
+ * the set and surfaces it again.
  *
  * @public
  */
-declare function useContextMenuTarget(): HTMLElement | null;
+declare function DocxEditorFontNotice({ className, style, t: tProp }: DocxEditorFontNoticeProps): react.JSX.Element | null;
 
-/** Shared props for every part. @public */
-interface ContentControlPartProps {
+/** Props for `DocxEditor.HeaderFooterChrome`. @public */
+interface DocxEditorHeaderFooterChromeProps {
     className?: string;
-    asChild?: boolean;
-    hidden?: boolean;
-    children?: DocxEditorChildren;
-}
-/** Props for action parts that also take an icon. @public */
-interface ContentControlActionProps extends ContentControlPartProps {
-    icon?: DocxEditorChildren;
-}
-/** Props for `DocxEditor.ContentControl`. @public */
-interface ContentControlProps extends ContentControlPartProps {
-    /**
-     * Render the packaged arrangement. `false` mounts only the shell and whatever parts
-     * you pass as children.
-     */
-    preset?: boolean;
 }
-declare function ContentControlRoot({ className, asChild, hidden, children, preset, }: ContentControlProps): react.JSX.Element | null;
-declare function ContentControlHeader({ className, asChild, hidden, children }: ContentControlPartProps): react.JSX.Element | null;
-declare function ContentControlFields({ className, asChild, hidden, children }: ContentControlPartProps): react.JSX.Element | null;
-declare function ContentControlRemove({ className, asChild, hidden, icon: iconOverride, children, }: ContentControlActionProps): react.JSX.Element | null;
 /**
- * The content-control inspector compound. Parts live on the namespace statics.
+ * Thin overlay while a header or footer scope is open: region label and contextual options.
+ * Mount beside `DocxEditor.Content`.
  *
  * @public
  */
-interface DocxEditorContentControlNamespace {
-    (props: ContentControlProps): ReturnType<typeof ContentControlRoot>;
-    readonly Header: typeof ContentControlHeader;
-    readonly Fields: typeof ContentControlFields;
-    readonly Remove: typeof ContentControlRemove;
-}
-declare const DocxEditorContentControl: DocxEditorContentControlNamespace;
+declare function DocxEditorHeaderFooterChrome({ className, }: DocxEditorHeaderFooterChromeProps): ReactElement | null;
+
+/** Default equation editor mounted by the packaged React host. */
+declare function DocxEditorEquation(): react.JSX.Element | null;
 
 type EditorMode = 'edit' | 'view' | 'suggesting';
 
@@ -2181,6 +2441,8 @@ type EditorMode = 'edit' | 'view' | 'suggesting';
  * imports ProseMirror or OOXML feature logic.
  */
 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.
@@ -2270,8 +2532,8 @@ interface DocxEditorProps {
      *
      * `false` removes it. An OBJECT is `DocxEditorMenuProps`, passed straight through, so a
      * host can redirect one row without giving up the bar: `menu={{ reportIssue: false }}`
-     * drops the report-an-issue row, `menu={{ onPageSetup: openMine }}` swaps the dialog,
-     * and `menu={{ children: <DocxEditor.Menu.File>…</DocxEditor.Menu.File> }}` replaces a
+     * drops the report-an-issue row. Use `popups.pageSetup` to customize Page Setup.
+     * `menu={{ children: <DocxEditor.Menu.File>…</DocxEditor.Menu.File> }}` replaces a
      * whole menu in place. Before this took an object the only way to change any of that was
      * `menu={false}` plus rebuilding the entire title block.
      *
@@ -2444,6 +2706,7 @@ interface DocxEditorNamespace extends ForwardRefExoticComponent<DocxEditorProps
     /** Page Setup dialog — size, orientation, margins — applied as one undo step. */
     readonly PageSetupDialog: typeof DocxEditorPageSetupDialog;
     /** The Paragraph dialog: alignment, indentation, spacing and the paragraph flags. */
+    readonly TextFormFieldDialog: typeof DocxEditorTextFormFieldDialog;
     readonly ParagraphDialog: typeof DocxEditorParagraphDialog;
     /** Floating localized page readout for the active viewport. */
     readonly PageNumber: typeof DocxEditorPageNumber;
@@ -2471,6 +2734,13 @@ interface DocxEditorNamespace extends ForwardRefExoticComponent<DocxEditorProps
      * remove-keeping-content. Mounted by default inside the viewport; opens from the
      * `contentControl.inspector` chrome slot.
      */
+    readonly ContentControlWidget: typeof DocxEditorContentControlWidget;
+    readonly InvalidTextFormFieldDialog: typeof DocxEditorInvalidTextFormFieldDialog;
+    readonly ImageAltTextPopup: typeof DocxEditorImageAltTextPopup;
+    readonly ImagePropertiesDialog: typeof DocxEditorImagePropertiesDialog;
+    readonly NotePropertiesDialog: typeof DocxEditorNotePropertiesDialog;
+    readonly NotePreview: typeof DocxEditorNotePreview;
+    readonly NotesContextMenu: typeof DocxEditorNotesContextMenu;
     readonly ContentControl: typeof DocxEditorContentControl;
 }
 declare const DocxEditor: DocxEditorNamespace;
@@ -2862,9 +3132,8 @@ type FontsInput = FontConfiguration | FontConfigurationFragment | FontResolver |
  * Order origins cheapest-first.
  *
  * The returned resolver never changes identity, so the editor is never rebuilt on account
- * of this prop — which also means the arguments are re-read per LOAD rather than per
- * render. Changing them mid-document does not re-resolve fonts; load a document, or
- * remount, for new fonts to take effect.
+ * of this prop. Arguments are re-read when opening a document or requesting a new family.
+ * Changing them alone does not replace already loaded faces; reload the document for that.
  *
  * It is marked (`defineFontResolver`), so it can itself be an origin of another list or
  * `useDocxSource`'s `fonts` option without being mistaken for a zero-argument loader.
@@ -3186,101 +3455,6 @@ interface UsePageSetupReturn {
  */
 declare function usePageSetup(): UsePageSetupReturn;
 
-/** One tri-state paragraph flag: on, off, or "the selection disagrees". */
-type ParagraphFlagState = boolean | null;
-/** One custom tab stop, as a control reads and writes it. @public */
-interface ParagraphTabStop {
-    readonly positionTwips: number;
-    readonly alignment: 'left' | 'center' | 'right' | 'decimal' | 'bar';
-    readonly leader?: 'none' | 'dot' | 'hyphen' | 'underscore' | 'heavy' | 'middleDot';
-}
-/**
- * What the Paragraph dialog reads: every field, as the selection currently stands.
- *
- * A `null` means the selection's paragraphs DISAGREE about that field, which a control
- * shows as an indeterminate checkbox or an empty box rather than as a value. `indent` is
- * the exception the engine already documents — it reports the first touched paragraph and
- * flags disagreement per field, because a ruler has to draw its handles somewhere.
- *
- * @public
- */
-interface ParagraphFormatRead {
-    /**
-     * `justify`, not OOXML's `both`. The engine speaks `w:jc` values; an adapter speaks the
-     * word its consumers write. Read and write use the SAME spelling here, so a value that
-     * comes out of `format` can go straight back into `apply`.
-     */
-    readonly alignment: 'left' | 'center' | 'right' | 'justify' | null;
-    readonly spaceBeforePt: number | null;
-    readonly spaceAfterPt: number | null;
-    readonly lineSpacing: {
-        readonly rule: 'multiple' | 'exact' | 'atLeast';
-        readonly value: number;
-    } | null;
-    readonly indentLeftTwips: number | null;
-    readonly indentRightTwips: number | null;
-    /** ONE signed first-line offset: negative is a hanging indent. */
-    readonly indentFirstLineTwips: number | null;
-    readonly contextualSpacing: ParagraphFlagState;
-    readonly keepNext: ParagraphFlagState;
-    readonly keepLines: ParagraphFlagState;
-    readonly widowControl: ParagraphFlagState;
-    readonly pageBreakBefore: ParagraphFlagState;
-    /** Custom tab stops, cascade included. Null when the selection disagrees. */
-    readonly tabStops: readonly ParagraphTabStop[] | null;
-    /**
-     * Which fields are `null` because the selection DISAGREES, as opposed to because nothing
-     * states them.
-     *
-     * A `null` alone cannot tell those apart, and both readings shipped as bugs: a
-     * disagreement rendered as a concrete value is uncorrectable, because the value that
-     * would fix it is the one already on screen; an absent value rendered as "mixed" tells a
-     * single paragraph it disagrees with itself.
-     */
-    readonly disagrees: {
-        readonly alignment: boolean;
-        readonly spaceBeforePt: boolean;
-        readonly spaceAfterPt: boolean;
-        readonly lineSpacing: boolean;
-        readonly tabStops: boolean;
-        readonly indentLeft: boolean;
-        readonly indentRight: boolean;
-        readonly indentFirstLine: boolean;
-    };
-    /**
-     * Whether the indent reads are UNKNOWN rather than disagreed.
-     *
-     * The engine reports no indent at all for a paragraph inside a table — correct, but not
-     * placeable on a ruler. A control must not call that "mixed": one paragraph cannot
-     * disagree with itself, and the commonest paragraph in a real document is in a cell.
-     */
-    readonly indentUnknown: boolean;
-}
-/**
- * The fields `apply` accepts. Omitted fields are left as authored; `null` where allowed
- * REMOVES the setting so the style supplies it again, which is not the same as a zero.
- *
- * @public
- */
-interface ParagraphFormatUpdate {
-    readonly alignment?: 'left' | 'center' | 'right' | 'justify';
-    readonly spaceBeforePt?: number | null;
-    readonly spaceAfterPt?: number | null;
-    readonly lineSpacing?: {
-        readonly rule: 'multiple' | 'exact' | 'atLeast';
-        readonly value: number;
-    } | null;
-    readonly indentLeftTwips?: number | null;
-    readonly indentRightTwips?: number | null;
-    readonly indentFirstLineTwips?: number | null;
-    readonly contextualSpacing?: boolean;
-    readonly keepNext?: boolean;
-    readonly keepLines?: boolean;
-    readonly widowControl?: boolean;
-    readonly pageBreakBefore?: boolean;
-    /** Replace the custom tab stops. An EMPTY list clears them; omit to leave them alone. */
-    readonly tabStops?: readonly ParagraphTabStop[];
-}
 /** What `useParagraphFormat` returns. @public */
 interface UseParagraphFormatReturn {
     /** The selection's paragraph formatting, or null while nothing is loaded. */
@@ -4079,4 +4253,4 @@ declare function VerticalRuler({ pageSetup, zoom, editable, onTopMarginChange, o
  */
 declare function useEditorSnapshot(editor: Editor | null): number;
 
-export { CONTENT_CONTROL_SLOTS, type ChromeTranslate, type ContentControlActionProps, type ContentControlInspectorState, type ContentControlLock, type ContentControlPartProps, type ContentControlProps, type ContentControlSlotId, type ContextMenuAnchor, ContextMenuCellVerticalAlignment, type ContextMenuCommandProps, type ContextMenuContextValue, ContextMenuCopy, ContextMenuCopyFormatting, ContextMenuCut, ContextMenuDelete, ContextMenuDeleteTable, ContextMenuDeleteTableColumn, ContextMenuDeleteTableRow, ContextMenuInsertColumnLeft, ContextMenuInsertColumnRight, ContextMenuInsertRowAbove, ContextMenuInsertRowBelow, ContextMenuItem, type ContextMenuItemProps, ContextMenuPaste, ContextMenuPasteFormatting, ContextMenuPasteWithoutFormatting, ContextMenuRefreshToc, ContextMenuRefreshTocPageNumbers, ContextMenuSelectAll, type ContextMenuTableRowProps, DocumentName, DocumentOutline, DocxEditor, DocxEditorAuthorStyle, type DocxEditorAuthorStyleProps, type DocxEditorChildren, DocxEditorColorByChangeType, DocxEditorContent, DocxEditorContentControl, type DocxEditorContentControlNamespace, type DocxEditorContentProps, DocxEditorContextMenu, type DocxEditorContextMenuNamespace, type DocxEditorContextMenuProps, DocxEditorDocumentOutline, type DocxEditorDocumentOutlineProps, DocxEditorEquation, DocxEditorFontNotice, type DocxEditorFontNoticeProps, DocxEditorHeaderFooterChrome, type DocxEditorHeaderFooterChromeProps, DocxEditorHorizontalRuler, DocxEditorHyperLink, type DocxEditorHyperLinkNamespace, DocxEditorImagePropertiesDialog, type DocxEditorImagePropertiesDialogProps, DocxEditorLoading, type DocxEditorLoadingComponent, type DocxEditorLoadingProps, DocxEditorLoadingSpinner, type DocxEditorLoadingSpinnerProps, DocxEditorMenu, type DocxEditorMenuNamespace, type DocxEditorMenuProps, type DocxEditorNamespace, DocxEditorNavigation, type DocxEditorNavigationNamespace, type DocxEditorNavigationProps, DocxEditorNotesChrome, type DocxEditorNotesChromeProps, DocxEditorPageNumber, type DocxEditorPageNumberProps, DocxEditorPageSetupDialog, type DocxEditorPageSetupDialogProps, DocxEditorParagraphDialog, type DocxEditorParagraphDialogProps, type DocxEditorProps, type DocxEditorRef, DocxEditorRoot, type DocxEditorRootListeners, type DocxEditorRootProps, type DocxEditorRulerProps, DocxEditorShell, DocxEditorToolbar, type DocxEditorToolbarNamespace, type DocxEditorToolbarProps, DocxEditorVerticalRuler, DocxEditorViewport, type DocxEditorViewportProps, type DocxFontOrigin, type DocxFontsInput, type DocxFontsSource, type DocxSource, type EditorCaret, type EditorCommandState, type EditorMode, type EditorValueCommandState, type FontFamilyItemProps, type FontFamilyNamespace, type FontFamilyPartProps, type FontFamilyProps, type FontsInput, type HeaderFooterState, HorizontalRuler, type HorizontalRulerProps$1 as HorizontalRulerProps, type HyperLinkActionProps, type HyperLinkPartProps, type HyperLinkProps, type HyperlinkPopupAnchor, type HyperlinkPopupMode, type HyperlinkPopupState, ImageAltText, ImageInsertProvider, ImageInsertTrigger, ImagePropertiesTrigger, type ImagePropertiesTriggerProps, ImageWrap, type IndentUpdate, LocaleProvider, type LocaleProviderProps, Logo, type MaybeRefOrGetter, type MenuActionProps, MenuBar, type MenuGroupProps, type MenuId, type MenuItemProps, type MenuPartComponent, type MenuProps, type MenuReportIssueProps, type MenuReviewersProps, type MenuRowProps, type MenuSeparatorProps, type MenuSubmenuProps, type MenuTableGridProps, NAVIGATION_PANE_GAP, NAVIGATION_PANE_INSET, NAVIGATION_PANE_WIDTH, NavigationClose, NavigationFind, NavigationHeader, NavigationHeadings, type NavigationPartProps, type NavigationShiftInput, NavigationTab, type NavigationTabProps, type NavigationTab$1 as NavigationTabValue, NavigationTabs, NavigationTitle, NavigationToggle, type NormalizedImagePayload, type NotePropertiesState, OUTLINE_BUTTON_LEFT_OFFSET, OUTLINE_BUTTON_RESERVED_SPACE, OUTLINE_LEFT_OFFSET, OUTLINE_RESERVED_SPACE, type OutlineHeading$1 as OutlineHeading, type OutlineHeadingItem, PageIndicator, type PageIndicatorProps, PageNumberTranslationContext, type PageSetupUpdate, PaginatedDocxEditor, type PaginatedDocxEditorExpose, type PaginatedDocxEditorHandle, type PaginatedDocxEditorProps, PaginatedDocxEditorShell, type PaginatedDocxEditorShellProps, type ParagraphFlagState, type ParagraphFormatRead, type ParagraphFormatUpdate, type ParagraphStyleItemProps, type ParagraphStyleNamespace, type ParagraphStyleOption, type ParagraphStylePartProps, type ParagraphStyleProps, type ParagraphTabStop, type ProvideDocxEditorResult, REVIEW_MARKERS_GUTTER, REVIEW_PANE_GUTTER, RULER_WIDTH, type ReviewGutter, type ReviewGutterInput, ReviewRailContext, type ReviewRailRegistry, SEARCH_DEBOUNCE_MS, SEARCH_MATCH_LIMIT, type ScopedChromeAnchor, Slot, type SlotProps, type TableBorderColorNamespace, type TableBorderStyleNamespace, type TableBorderTargetNamespace, type TableBorderWidthNamespace, type TableCellFillNamespace, type TableChromeItemProps, type TableChromePartComponent, type TableChromePartProps, TitleBar, TitleBarRight, Toolbar, type ToolbarActionProps, type ToolbarAlignmentComponent, ToolbarButton, type ToolbarButtonProps$1 as ToolbarButtonProps, ToolbarContext, type ToolbarContextValue, ToolbarGroup, ToolbarImageProperties, type ToolbarPartComponent, type ToolbarPartProps, type ToolbarProps, type ToolbarReviewersProps, type ToolbarSeparatorProps, type ToolbarSlotPartComponent, type ToolbarSlotPartProps, type ToolbarTranslate, type UseContentControlResult, type UseDocumentOutlineResult, type UseDocumentSearchResult, type UseDocxSourceOptions, type UseDocxSourceResult, type UseFontFamilyResult, type UseHyperlinkPopupResult, type UseNavigationPaneOptions, type UseNavigationPaneResult, type UsePageSetupReturn, type UseParagraphFormatReturn, type UseParagraphIndentReturn, type UseParagraphStyleResult, type UseZoomResult, VERSION, VerticalRuler, type VerticalRulerProps, editorStateActiveSubscriptionCount, isFieldLink, navigationPaneReservation, navigationShift, normalizeImageBytes, notificationYieldsToTask, useProvidedDocxEditor as provideDocxEditor, reviewGutter, useChromeTranslate, useContentControl, useContentControlInstance, useContextMenuTarget, useDocumentOutline, useDocumentSearch, useDocxEditor, useDocxSource, useEditorCaret, useEditorCommand, useEditorEvent, useEditorSnapshot, useEditorState, useEditorValueCommand, useFontFamily, useFonts, useHeaderFooterState, useHyperlinkPopup, useHyperlinkPopupInstance, useNavigationPane, useNavigationShift, useNotePropertiesState, useNoteScopeState, usePageSetup, useParagraphFormat, useParagraphIndent, useParagraphStyle, useReviewAuthors, useReviewGutter, useScopeClassName, useScopedChromeAnchor, useTableBorderTargetLabel, useToolbarContext, useToolbarLabel, useToolbarLabelFor, useTranslation, useZoom };
+export { CONTENT_CONTROL_SLOTS, type ChromeTranslate, type ContentControlActionProps, type ContentControlInspectorState, type ContentControlLock, type ContentControlPartProps, type ContentControlProps, type ContentControlSlotId, type ContextMenuAnchor, ContextMenuCellVerticalAlignment, type ContextMenuCommandProps, type ContextMenuContextValue, ContextMenuCopy, ContextMenuCopyFormatting, ContextMenuCut, ContextMenuDelete, ContextMenuDeleteTable, ContextMenuDeleteTableColumn, ContextMenuDeleteTableRow, ContextMenuInsertColumnLeft, ContextMenuInsertColumnRight, ContextMenuInsertRowAbove, ContextMenuInsertRowBelow, ContextMenuItem, type ContextMenuItemProps, ContextMenuPaste, ContextMenuPasteFormatting, ContextMenuPasteWithoutFormatting, ContextMenuRefreshToc, ContextMenuRefreshTocPageNumbers, ContextMenuSelectAll, type ContextMenuTableRowProps, type DialogCustomizationProps, type DialogPartProps, DocumentName, DocumentOutline, DocxEditor, DocxEditorAuthorStyle, type DocxEditorAuthorStyleProps, type DocxEditorChildren, DocxEditorColorByChangeType, DocxEditorContent, DocxEditorContentControl, type DocxEditorContentControlNamespace, DocxEditorContentControlWidget, type DocxEditorContentControlWidgetProps, type DocxEditorContentProps, DocxEditorContextMenu, type DocxEditorContextMenuNamespace, type DocxEditorContextMenuProps, DocxEditorDocumentOutline, type DocxEditorDocumentOutlineProps, DocxEditorEquation, DocxEditorFontNotice, type DocxEditorFontNoticeProps, DocxEditorHeaderFooterChrome, type DocxEditorHeaderFooterChromeProps, DocxEditorHorizontalRuler, DocxEditorHyperLink, type DocxEditorHyperLinkNamespace, DocxEditorImageAltTextPopup, type DocxEditorImageAltTextPopupProps, DocxEditorImagePropertiesDialog, type DocxEditorImagePropertiesDialogProps, DocxEditorInvalidTextFormFieldDialog, type DocxEditorInvalidTextFormFieldDialogProps, DocxEditorLoading, type DocxEditorLoadingComponent, type DocxEditorLoadingProps, DocxEditorLoadingSpinner, type DocxEditorLoadingSpinnerProps, DocxEditorMenu, type DocxEditorMenuNamespace, type DocxEditorMenuProps, type DocxEditorNamespace, DocxEditorNavigation, type DocxEditorNavigationNamespace, type DocxEditorNavigationProps, DocxEditorNotePreview, type DocxEditorNotePreviewProps, DocxEditorNotePropertiesDialog, type DocxEditorNotePropertiesDialogProps, DocxEditorNotesChrome, type DocxEditorNotesChromeProps, DocxEditorNotesContextMenu, type DocxEditorNotesContextMenuProps, DocxEditorPageNumber, type DocxEditorPageNumberProps, DocxEditorPageSetupDialog, type DocxEditorPageSetupDialogProps, DocxEditorParagraphDialog, type DocxEditorParagraphDialogProps, type DocxEditorPopup, type DocxEditorPopups, type DocxEditorProps, type DocxEditorRef, DocxEditorRoot, type DocxEditorRootListeners, type DocxEditorRootProps, type DocxEditorRulerProps, DocxEditorShell, DocxEditorTextFormFieldDialog, type DocxEditorTextFormFieldDialogProps, DocxEditorToolbar, type DocxEditorToolbarNamespace, type DocxEditorToolbarProps, DocxEditorVerticalRuler, DocxEditorViewport, type DocxEditorViewportProps, type DocxFontOrigin, type DocxFontsInput, type DocxFontsSource, type DocxSource, type EditorCaret, type EditorCommandState, type EditorMode, type EditorValueCommandState, type FontFamilyItemProps, type FontFamilyNamespace, type FontFamilyPartProps, type FontFamilyProps, type FontsInput, type HeaderFooterState, HorizontalRuler, type HorizontalRulerProps$1 as HorizontalRulerProps, type HyperLinkActionProps, type HyperLinkPartProps, type HyperLinkProps, type HyperlinkPopupAnchor, type HyperlinkPopupMode, type HyperlinkPopupState, ImageAltText, ImageInsertProvider, ImageInsertTrigger, ImagePropertiesTrigger, type ImagePropertiesTriggerProps, ImageWrap, type IndentUpdate, LocaleProvider, type LocaleProviderProps, Logo, type MaybeRefOrGetter, type MenuActionProps, MenuBar, type MenuGroupProps, type MenuId, type MenuItemProps, type MenuPartComponent, type MenuProps, type MenuReportIssueProps, type MenuReviewersProps, type MenuRowProps, type MenuSeparatorProps, type MenuSubmenuProps, type MenuTableGridProps, NAVIGATION_PANE_GAP, NAVIGATION_PANE_INSET, NAVIGATION_PANE_WIDTH, NavigationClose, NavigationFind, NavigationHeader, NavigationHeadings, type NavigationPartProps, type NavigationShiftInput, NavigationTab, type NavigationTabProps, type NavigationTab$1 as NavigationTabValue, NavigationTabs, NavigationTitle, NavigationToggle, type NormalizedImagePayload, type NotePropertiesState, OUTLINE_BUTTON_LEFT_OFFSET, OUTLINE_BUTTON_RESERVED_SPACE, OUTLINE_LEFT_OFFSET, OUTLINE_RESERVED_SPACE, type OutlineHeading$1 as OutlineHeading, type OutlineHeadingItem, PageIndicator, type PageIndicatorProps, PageNumberTranslationContext, type PageSetupDialogFields, type PageSetupUpdate, PaginatedDocxEditor, type PaginatedDocxEditorExpose, type PaginatedDocxEditorHandle, type PaginatedDocxEditorProps, PaginatedDocxEditorShell, type PaginatedDocxEditorShellProps, type ParagraphStyleItemProps, type ParagraphStyleNamespace, type ParagraphStyleOption, type ParagraphStylePartProps, type ParagraphStyleProps, type ProvideDocxEditorResult, REVIEW_MARKERS_GUTTER, REVIEW_PANE_GUTTER, RULER_WIDTH, type ReviewGutter, type ReviewGutterInput, ReviewRailContext, type ReviewRailRegistry, SEARCH_DEBOUNCE_MS, SEARCH_MATCH_LIMIT, type ScopedChromeAnchor, Slot, type SlotProps, type TableBorderColorNamespace, type TableBorderStyleNamespace, type TableBorderTargetNamespace, type TableBorderWidthNamespace, type TableCellFillNamespace, type TableChromeItemProps, type TableChromePartComponent, type TableChromePartProps, type TextFormFieldDialogFields, TitleBar, TitleBarRight, Toolbar, type ToolbarActionProps, type ToolbarAlignmentComponent, ToolbarButton, type ToolbarButtonProps$1 as ToolbarButtonProps, ToolbarContext, type ToolbarContextValue, ToolbarGroup, ToolbarImageProperties, type ToolbarPartComponent, type ToolbarPartProps, type ToolbarProps, type ToolbarReviewersProps, type ToolbarSeparatorProps, type ToolbarSlotPartComponent, type ToolbarSlotPartProps, type ToolbarTranslate, type UseContentControlResult, type UseDialogReturn, type UseDocumentOutlineResult, type UseDocumentSearchResult, type UseDocxSourceOptions, type UseDocxSourceResult, type UseFontFamilyResult, type UseHyperlinkPopupResult, type UseNavigationPaneOptions, type UseNavigationPaneResult, type UsePageSetupDialogReturn, type UsePageSetupReturn, type UseParagraphDialogReturn, type UseParagraphFormatReturn, type UseParagraphIndentReturn, type UseParagraphStyleResult, type UseTextFormFieldDialogReturn, type UseZoomResult, VERSION, VerticalRuler, type VerticalRulerProps, definePopup, editorStateActiveSubscriptionCount, isFieldLink, navigationPaneReservation, navigationShift, normalizeImageBytes, notificationYieldsToTask, useProvidedDocxEditor as provideDocxEditor, reviewGutter, useChromeTranslate, useContentControl, useContentControlInstance, useContextMenuTarget, useDocumentOutline, useDocumentSearch, useDocxEditor, useDocxSource, useEditorCaret, useEditorCommand, useEditorEvent, useEditorSnapshot, useEditorState, useEditorValueCommand, useFontFamily, useFonts, useHeaderFooterState, useHyperlinkPopup, useHyperlinkPopupInstance, useNavigationPane, useNavigationShift, useNotePropertiesState, useNoteScopeState, usePageSetup, usePageSetupDialog, useParagraphDialog, useParagraphFormat, useParagraphIndent, useParagraphStyle, useReviewAuthors, useReviewGutter, useScopeClassName, useScopedChromeAnchor, useTableBorderTargetLabel, useTextFormFieldDialog, useToolbarContext, useToolbarLabel, useToolbarLabelFor, useTranslation, useZoom };