@docx-editor.dev/react 2.12.0 → 2.14.0

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 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, 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, FontResolutionRequest, FontResolver, FontUrlSource, ImageWrapTarget, LOADING_SNAPSHOT, LoadFontsRequest, LoadFontsResult, MAX_RESOLVER_FAMILIES, PX_PER_CM, PX_PER_INCH, ReviewAuthorInfo, RevisionAuthorAssignments, RevisionAuthorStyle, RevisionStyles, RulerTick, RulerUnit, ToolbarCommandState, WORD_DEFAULT_FONT, chromeMenuSlots, commandForSlot, composeFontConfiguration, createFontSource, generateRulerTicks, loadFonts, rulerPageBox, runToolbarCommand, toolbarCommandState } from '@docx-editor.dev/core/editor';
+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';
 export { Editor, EditorCommand, EditorFontError, EditorFontErrorCode, EditorQuery, EditorScope, EditorSnapshot, FontConfiguration, FontFaceRequest, FontSource, FontSourceSubstitution, PageSetup } from '@docx-editor.dev/core/contracts/editor';
 import { TFunction, Translations, LocaleStrings } from '@docx-editor.dev/i18n';
@@ -345,6 +345,19 @@ interface DocxEditorViewportProps {
  */
 declare function DocxEditorViewport({ className, style, children }: DocxEditorViewportProps): react.JSX.Element;
 
+/** Props for `DocxEditor.Toolbar.Reviewers`. @public */
+type ToolbarReviewersProps = {
+    className?: string;
+    hidden?: boolean;
+    /** 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";
+}
+
 /** Resolves an i18n key to display text. @public */
 type ToolbarTranslate = (key: string) => string;
 interface ToolbarContextValue {
@@ -906,6 +919,7 @@ interface DocxEditorToolbarNamespace {
     readonly Zoom: ToolbarSlotPartComponent;
     readonly StylePicker: typeof ParagraphStyle;
     readonly EditingMode: ToolbarSlotPartComponent;
+    readonly Reviewers: typeof ToolbarReviewers;
     readonly Save: ToolbarSlotPartComponent;
     readonly ContentControlShowAll: ToolbarPartComponent;
     readonly ContentControlFormFill: ToolbarPartComponent;
@@ -921,7 +935,7 @@ interface DocxEditorToolbarNamespace {
 declare const DocxEditorToolbar: DocxEditorToolbarNamespace;
 
 /**
- * A menu's identity: one of the registry's four, or a HOST'S OWN.
+ * 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
@@ -1110,7 +1124,7 @@ declare function MenuSeparator({ className }: MenuSeparatorProps): react.JSX.Ele
 declare function MenuEntry({ entry }: {
     entry: ChromeMenuEntry;
 }): react.JSX.Element;
-/** Props for `DocxEditor.Menu.Menu` and the four pinned menu parts. @public */
+/** 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;
@@ -1195,6 +1209,15 @@ declare const MenuReportIssue: typeof MenuReportIssueImpl & {
     docxSlot: string;
 };
 
+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. */
@@ -1245,6 +1268,7 @@ interface DocxEditorMenuNamespace {
     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;
@@ -1263,11 +1287,13 @@ interface DocxEditorMenuNamespace {
     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 · Help, parts as
+ * The compound menu bar: `<DocxEditor.Menu/>` for File · Format · Insert · Review · Help, parts as
  * statics for composition.
  *
  * Every actionable row is a chrome slot, so a row and its toolbar twin share one label,
@@ -2683,14 +2709,31 @@ declare function useHyperlinkPopupInstance(active?: boolean): UseHyperlinkPopupR
 /** A complete configuration, or a fragment this hook composes with the defaults. @public */
 type DocxFontsInput = FontConfiguration | FontConfigurationFragment;
 /**
- * How a host supplies fonts: a value, a promise, or a function returning either.
+ * How a host supplies fonts: one origin, or a list of them in precedence order.
+ *
+ * `packagedFonts()` and `googleFonts()` are the useful ones — they resolve per document,
+ * loading a family when the file names it or when it is that file's default face, rather
+ * than loading every family they could serve. A list composes them first-wins:
+ * `{ fonts: [packagedFonts(), googleFonts()] }` serves the bundled faces and reaches the
+ * catalog only for what they do not cover.
  *
- * The function form is the useful one — `{ fonts: defaultFonts }` from
- * `@docx-editor.dev/fonts` — because it defers the work until the hook actually runs it.
+ * The zero-argument loader form (`{ fonts: defaultFonts }`) still works and still loads
+ * everything up front. It is the one form that holds the document back until fonts settle.
  *
  * @public
  */
-type DocxFontsSource = DocxFontsInput | Promise<DocxFontsInput> | (() => DocxFontsInput | Promise<DocxFontsInput>);
+type DocxFontsSource = DocxFontOrigin | readonly DocxFontOrigin[];
+/**
+ * One entry of a `fonts` list: any {@link FontOrigin}, or the older zero-argument loader.
+ *
+ * The resolver arm of `FontOrigin` is a MARKED resolver, so handing this a function that
+ * takes a request but never went through `defineFontResolver` is a compile error rather
+ * than a silent total loss of fonts — it matches neither arm, because a one-argument
+ * function is not assignable to the zero-argument loader.
+ *
+ * @public
+ */
+type DocxFontOrigin = FontOrigin | (() => DocxFontsInput | Promise<DocxFontsInput>);
 /**
  * What the document itself can be: a URL to fetch, or bytes already in hand.
  *
@@ -2712,8 +2755,15 @@ interface UseDocxSourceOptions {
 interface UseDocxSourceResult {
     /** Bytes for `DocxEditor`'s `document` prop; undefined until they arrive. */
     readonly document: Uint8Array | undefined;
-    /** Composed configuration for the `fonts` prop; undefined until fonts settle. */
-    readonly fonts: FontConfiguration | undefined;
+    /**
+     * What to hand the `fonts` prop; undefined until there is something to hand it.
+     *
+     * A composed `FontConfiguration` on the eager path, and a stable `FontResolver` on the
+     * on-demand one — the prop takes either, so the call site does not change. The resolver
+     * keeps ONE identity for the hook's life, so the editor is never rebuilt on account of
+     * it even when the origins are written inline.
+     */
+    readonly fonts: FontConfiguration | FontResolver | undefined;
     /** Why the DOCUMENT could not be opened. Font failures never land here — see below. */
     readonly error: Error | null;
     /** True until the document either arrives or fails. */
@@ -2723,7 +2773,7 @@ interface UseDocxSourceResult {
  * Load a document (and optionally fonts) for `DocxEditor`.
  *
  * ```tsx
- * const { document, fonts, error } = useDocxSource(url, { fonts: defaultFonts });
+ * const { document, fonts, error } = useDocxSource(url, { fonts: packagedFonts() });
  * if (error) return <p>{error.message}</p>;
  * return <DocxEditor document={document} fonts={fonts} />;
  * ```
@@ -2733,12 +2783,20 @@ interface UseDocxSourceResult {
  * a font failure leaves `error` null and is the loader's to report. A document failure is
  * different: there is nothing to show, so it lands on `error`.
  *
- * THE DOCUMENT WAITS FOR THE FONTS. They fetch concurrently, but `document` stays undefined
- * until fonts have settled — resolved OR failed — because layout MEASURES with them. Handing
- * the editor bytes first paginates the whole document on the fixed fallback and then
- * re-paginates when the real faces arrive, which the reader sees as the text jumping. One
- * slightly longer wait beats a visible reflow. Without a `fonts` option there is nothing to
- * wait for and the bytes go straight through.
+ * THE DOCUMENT WAITS FOR THE FONTS, on the eager path. They fetch concurrently, but
+ * `document` stays undefined until fonts have settled — resolved OR failed — because layout
+ * MEASURES with them. Handing the editor bytes first paginates the whole document on the
+ * fixed fallback and then re-paginates when the real faces arrive, which the reader sees as
+ * the text jumping. One slightly longer wait beats a visible reflow. Without a `fonts`
+ * option there is nothing to wait for and the bytes go straight through.
+ *
+ * AN ON-DEMAND ORIGIN CANNOT BE WAITED FOR, and this hook does not pretend otherwise. A
+ * resolver is answered with the families the file declares, which nothing knows until the
+ * engine has parsed it, so holding the bytes back would wait on work that only the bytes
+ * can start. `document` is released at once, `fonts` is a stable resolver, and the engine
+ * re-paginates when the faces land. That one reflow is what buys loading the faces a
+ * document uses rather than everything an origin would load up front; `{ fonts: defaultFonts }` is
+ * still there when the no-reflow guarantee matters more than the megabytes.
  *
  * A URL is fetched with the browser's own `fetch`, exactly as the caller wrote it. Validate
  * it first if it came from user input: this hook adds no allowlist of its own, and inventing
@@ -2751,7 +2809,13 @@ declare function useDocxSource(source: DocxSource | null | undefined, options?:
 /**
  * Anything that can describe fonts: a resolved configuration, a bare fragment, a promise
  * for either (what a loader like `defaultFonts()` returns), or an on-demand
- * {@link FontResolver}.
+ * {@link FontResolver} (what `packagedFonts()` and `googleFonts()` return).
+ *
+ * The resolver arm is BARE `FontResolver`, unmarked. `FontOrigin` — what a list position
+ * takes — requires the `defineFontResolver` mark, because a list may also hold a
+ * zero-argument loader and only the mark separates the two. There is no such ambiguity in
+ * the first argument of {@link useFonts}, which has never accepted a loader, so it keeps
+ * taking any resolver.
  *
  * @public
  */
@@ -2760,30 +2824,51 @@ type FontsInput = FontConfiguration | FontConfigurationFragment | FontResolver |
  * Merge font origins into one stable value for `DocxEditor.Root`'s `fonts` prop.
  *
  * ```tsx
- * // On demand: only the families this document names are fetched.
- * const fonts = useFonts(googleFonts());
+ * // The bundled substitutes: the families this document names, plus its default face.
+ * const fonts = useFonts(packagedFonts());
  *
- * // On demand, plus brand faces you always want.
- * const fonts = useFonts(googleFonts(), brandFragment);
+ * // The same, plus the Google catalog for everything they do not cover.
+ * const fonts = useFonts(packagedFonts(), googleFonts());
  *
- * // Eager, from the bundled substitutes.
- * const fonts = useFonts(defaultFonts());
+ * // Brand faces first, then whatever is left.
+ * const fonts = useFonts(brandFragment, packagedFonts());
  *
  * return <DocxEditor.Root fonts={fonts}>{children}</DocxEditor.Root>;
  * ```
  *
- * Origins compose first-wins in argument order, exactly like `composeFontConfiguration`:
- * the first argument beats later ones, and any of them beats a substitution for a family
- * some origin supplies directly.
+ * EVERY argument takes the same union, so adding an origin is adding an argument and
+ * never a change of shape. Origins compose first-wins in argument order, exactly like
+ * `composeFontConfiguration`: the first argument beats later ones, and any of them beats
+ * a substitution for a family some origin supplies directly.
+ *
+ * They resolve ONE AFTER ANOTHER, not concurrently, so that each can be told which faces
+ * the ones before it already cover and skip fetching them. That costs one extra origin's
+ * latency on the critical path and saves a duplicate download — and, for a network origin,
+ * a request that would have told a font host which families the document uses for nothing.
+ * 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.
  *
+ * 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.
+ *
+ * @public
+ */
+declare function useFonts(source: FontsInput, ...fragments: readonly (FontConfigurationFragment | undefined)[]): MarkedFontResolver;
+/**
+ * The uniform form: every position takes the same {@link FontOrigin}, so composing two
+ * resolvers is one extra argument.
+ *
+ * A resolver in any position but the first must carry the `defineFontResolver` mark. The
+ * first position keeps the older, looser type so that every call that compiled before this
+ * overload existed still compiles.
+ *
  * @public
  */
-declare function useFonts(source: FontsInput, ...fragments: readonly (FontConfigurationFragment | undefined)[]): FontResolver;
+declare function useFonts(...origins: readonly FontOrigin[]): MarkedFontResolver;
 
 /**
  * OOXML content-control lock axis, mirrored from layout boundary records for the
@@ -2879,9 +2964,8 @@ declare function useContentControlInstance(): UseContentControlResult;
  * change appears, then authors who only commented. One person is one colour across the two.
  * Once assigned, a slot stays with that author for the attached document session.
  *
- * A read of the rendered projection, not of the package: a resolved view hides the
- * revisions it has resolved away, so an author whose only change is hidden there is listed
- * only if they also commented.
+ * The complete attached-document roster. An author remains here while the current review
+ * view hides their revisions and comments, so reviewer chrome can turn them on again.
  *
  * The array is reference-stable between changes (the facade caches per layout and colour
  * state), so it is safe as a dependency and under `useSyncExternalStore`.
@@ -3981,4 +4065,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 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 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 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, 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 };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 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, 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, FontResolutionRequest, FontResolver, FontUrlSource, ImageWrapTarget, LOADING_SNAPSHOT, LoadFontsRequest, LoadFontsResult, MAX_RESOLVER_FAMILIES, PX_PER_CM, PX_PER_INCH, ReviewAuthorInfo, RevisionAuthorAssignments, RevisionAuthorStyle, RevisionStyles, RulerTick, RulerUnit, ToolbarCommandState, WORD_DEFAULT_FONT, chromeMenuSlots, commandForSlot, composeFontConfiguration, createFontSource, generateRulerTicks, loadFonts, rulerPageBox, runToolbarCommand, toolbarCommandState } from '@docx-editor.dev/core/editor';
+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';
 export { Editor, EditorCommand, EditorFontError, EditorFontErrorCode, EditorQuery, EditorScope, EditorSnapshot, FontConfiguration, FontFaceRequest, FontSource, FontSourceSubstitution, PageSetup } from '@docx-editor.dev/core/contracts/editor';
 import { TFunction, Translations, LocaleStrings } from '@docx-editor.dev/i18n';
@@ -345,6 +345,19 @@ interface DocxEditorViewportProps {
  */
 declare function DocxEditorViewport({ className, style, children }: DocxEditorViewportProps): react.JSX.Element;
 
+/** Props for `DocxEditor.Toolbar.Reviewers`. @public */
+type ToolbarReviewersProps = {
+    className?: string;
+    hidden?: boolean;
+    /** 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";
+}
+
 /** Resolves an i18n key to display text. @public */
 type ToolbarTranslate = (key: string) => string;
 interface ToolbarContextValue {
@@ -906,6 +919,7 @@ interface DocxEditorToolbarNamespace {
     readonly Zoom: ToolbarSlotPartComponent;
     readonly StylePicker: typeof ParagraphStyle;
     readonly EditingMode: ToolbarSlotPartComponent;
+    readonly Reviewers: typeof ToolbarReviewers;
     readonly Save: ToolbarSlotPartComponent;
     readonly ContentControlShowAll: ToolbarPartComponent;
     readonly ContentControlFormFill: ToolbarPartComponent;
@@ -921,7 +935,7 @@ interface DocxEditorToolbarNamespace {
 declare const DocxEditorToolbar: DocxEditorToolbarNamespace;
 
 /**
- * A menu's identity: one of the registry's four, or a HOST'S OWN.
+ * 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
@@ -1110,7 +1124,7 @@ declare function MenuSeparator({ className }: MenuSeparatorProps): react.JSX.Ele
 declare function MenuEntry({ entry }: {
     entry: ChromeMenuEntry;
 }): react.JSX.Element;
-/** Props for `DocxEditor.Menu.Menu` and the four pinned menu parts. @public */
+/** 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;
@@ -1195,6 +1209,15 @@ declare const MenuReportIssue: typeof MenuReportIssueImpl & {
     docxSlot: string;
 };
 
+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. */
@@ -1245,6 +1268,7 @@ interface DocxEditorMenuNamespace {
     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;
@@ -1263,11 +1287,13 @@ interface DocxEditorMenuNamespace {
     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 · Help, parts as
+ * The compound menu bar: `<DocxEditor.Menu/>` for File · Format · Insert · Review · Help, parts as
  * statics for composition.
  *
  * Every actionable row is a chrome slot, so a row and its toolbar twin share one label,
@@ -2683,14 +2709,31 @@ declare function useHyperlinkPopupInstance(active?: boolean): UseHyperlinkPopupR
 /** A complete configuration, or a fragment this hook composes with the defaults. @public */
 type DocxFontsInput = FontConfiguration | FontConfigurationFragment;
 /**
- * How a host supplies fonts: a value, a promise, or a function returning either.
+ * How a host supplies fonts: one origin, or a list of them in precedence order.
+ *
+ * `packagedFonts()` and `googleFonts()` are the useful ones — they resolve per document,
+ * loading a family when the file names it or when it is that file's default face, rather
+ * than loading every family they could serve. A list composes them first-wins:
+ * `{ fonts: [packagedFonts(), googleFonts()] }` serves the bundled faces and reaches the
+ * catalog only for what they do not cover.
  *
- * The function form is the useful one — `{ fonts: defaultFonts }` from
- * `@docx-editor.dev/fonts` — because it defers the work until the hook actually runs it.
+ * The zero-argument loader form (`{ fonts: defaultFonts }`) still works and still loads
+ * everything up front. It is the one form that holds the document back until fonts settle.
  *
  * @public
  */
-type DocxFontsSource = DocxFontsInput | Promise<DocxFontsInput> | (() => DocxFontsInput | Promise<DocxFontsInput>);
+type DocxFontsSource = DocxFontOrigin | readonly DocxFontOrigin[];
+/**
+ * One entry of a `fonts` list: any {@link FontOrigin}, or the older zero-argument loader.
+ *
+ * The resolver arm of `FontOrigin` is a MARKED resolver, so handing this a function that
+ * takes a request but never went through `defineFontResolver` is a compile error rather
+ * than a silent total loss of fonts — it matches neither arm, because a one-argument
+ * function is not assignable to the zero-argument loader.
+ *
+ * @public
+ */
+type DocxFontOrigin = FontOrigin | (() => DocxFontsInput | Promise<DocxFontsInput>);
 /**
  * What the document itself can be: a URL to fetch, or bytes already in hand.
  *
@@ -2712,8 +2755,15 @@ interface UseDocxSourceOptions {
 interface UseDocxSourceResult {
     /** Bytes for `DocxEditor`'s `document` prop; undefined until they arrive. */
     readonly document: Uint8Array | undefined;
-    /** Composed configuration for the `fonts` prop; undefined until fonts settle. */
-    readonly fonts: FontConfiguration | undefined;
+    /**
+     * What to hand the `fonts` prop; undefined until there is something to hand it.
+     *
+     * A composed `FontConfiguration` on the eager path, and a stable `FontResolver` on the
+     * on-demand one — the prop takes either, so the call site does not change. The resolver
+     * keeps ONE identity for the hook's life, so the editor is never rebuilt on account of
+     * it even when the origins are written inline.
+     */
+    readonly fonts: FontConfiguration | FontResolver | undefined;
     /** Why the DOCUMENT could not be opened. Font failures never land here — see below. */
     readonly error: Error | null;
     /** True until the document either arrives or fails. */
@@ -2723,7 +2773,7 @@ interface UseDocxSourceResult {
  * Load a document (and optionally fonts) for `DocxEditor`.
  *
  * ```tsx
- * const { document, fonts, error } = useDocxSource(url, { fonts: defaultFonts });
+ * const { document, fonts, error } = useDocxSource(url, { fonts: packagedFonts() });
  * if (error) return <p>{error.message}</p>;
  * return <DocxEditor document={document} fonts={fonts} />;
  * ```
@@ -2733,12 +2783,20 @@ interface UseDocxSourceResult {
  * a font failure leaves `error` null and is the loader's to report. A document failure is
  * different: there is nothing to show, so it lands on `error`.
  *
- * THE DOCUMENT WAITS FOR THE FONTS. They fetch concurrently, but `document` stays undefined
- * until fonts have settled — resolved OR failed — because layout MEASURES with them. Handing
- * the editor bytes first paginates the whole document on the fixed fallback and then
- * re-paginates when the real faces arrive, which the reader sees as the text jumping. One
- * slightly longer wait beats a visible reflow. Without a `fonts` option there is nothing to
- * wait for and the bytes go straight through.
+ * THE DOCUMENT WAITS FOR THE FONTS, on the eager path. They fetch concurrently, but
+ * `document` stays undefined until fonts have settled — resolved OR failed — because layout
+ * MEASURES with them. Handing the editor bytes first paginates the whole document on the
+ * fixed fallback and then re-paginates when the real faces arrive, which the reader sees as
+ * the text jumping. One slightly longer wait beats a visible reflow. Without a `fonts`
+ * option there is nothing to wait for and the bytes go straight through.
+ *
+ * AN ON-DEMAND ORIGIN CANNOT BE WAITED FOR, and this hook does not pretend otherwise. A
+ * resolver is answered with the families the file declares, which nothing knows until the
+ * engine has parsed it, so holding the bytes back would wait on work that only the bytes
+ * can start. `document` is released at once, `fonts` is a stable resolver, and the engine
+ * re-paginates when the faces land. That one reflow is what buys loading the faces a
+ * document uses rather than everything an origin would load up front; `{ fonts: defaultFonts }` is
+ * still there when the no-reflow guarantee matters more than the megabytes.
  *
  * A URL is fetched with the browser's own `fetch`, exactly as the caller wrote it. Validate
  * it first if it came from user input: this hook adds no allowlist of its own, and inventing
@@ -2751,7 +2809,13 @@ declare function useDocxSource(source: DocxSource | null | undefined, options?:
 /**
  * Anything that can describe fonts: a resolved configuration, a bare fragment, a promise
  * for either (what a loader like `defaultFonts()` returns), or an on-demand
- * {@link FontResolver}.
+ * {@link FontResolver} (what `packagedFonts()` and `googleFonts()` return).
+ *
+ * The resolver arm is BARE `FontResolver`, unmarked. `FontOrigin` — what a list position
+ * takes — requires the `defineFontResolver` mark, because a list may also hold a
+ * zero-argument loader and only the mark separates the two. There is no such ambiguity in
+ * the first argument of {@link useFonts}, which has never accepted a loader, so it keeps
+ * taking any resolver.
  *
  * @public
  */
@@ -2760,30 +2824,51 @@ type FontsInput = FontConfiguration | FontConfigurationFragment | FontResolver |
  * Merge font origins into one stable value for `DocxEditor.Root`'s `fonts` prop.
  *
  * ```tsx
- * // On demand: only the families this document names are fetched.
- * const fonts = useFonts(googleFonts());
+ * // The bundled substitutes: the families this document names, plus its default face.
+ * const fonts = useFonts(packagedFonts());
  *
- * // On demand, plus brand faces you always want.
- * const fonts = useFonts(googleFonts(), brandFragment);
+ * // The same, plus the Google catalog for everything they do not cover.
+ * const fonts = useFonts(packagedFonts(), googleFonts());
  *
- * // Eager, from the bundled substitutes.
- * const fonts = useFonts(defaultFonts());
+ * // Brand faces first, then whatever is left.
+ * const fonts = useFonts(brandFragment, packagedFonts());
  *
  * return <DocxEditor.Root fonts={fonts}>{children}</DocxEditor.Root>;
  * ```
  *
- * Origins compose first-wins in argument order, exactly like `composeFontConfiguration`:
- * the first argument beats later ones, and any of them beats a substitution for a family
- * some origin supplies directly.
+ * EVERY argument takes the same union, so adding an origin is adding an argument and
+ * never a change of shape. Origins compose first-wins in argument order, exactly like
+ * `composeFontConfiguration`: the first argument beats later ones, and any of them beats
+ * a substitution for a family some origin supplies directly.
+ *
+ * They resolve ONE AFTER ANOTHER, not concurrently, so that each can be told which faces
+ * the ones before it already cover and skip fetching them. That costs one extra origin's
+ * latency on the critical path and saves a duplicate download — and, for a network origin,
+ * a request that would have told a font host which families the document uses for nothing.
+ * 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.
  *
+ * 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.
+ *
+ * @public
+ */
+declare function useFonts(source: FontsInput, ...fragments: readonly (FontConfigurationFragment | undefined)[]): MarkedFontResolver;
+/**
+ * The uniform form: every position takes the same {@link FontOrigin}, so composing two
+ * resolvers is one extra argument.
+ *
+ * A resolver in any position but the first must carry the `defineFontResolver` mark. The
+ * first position keeps the older, looser type so that every call that compiled before this
+ * overload existed still compiles.
+ *
  * @public
  */
-declare function useFonts(source: FontsInput, ...fragments: readonly (FontConfigurationFragment | undefined)[]): FontResolver;
+declare function useFonts(...origins: readonly FontOrigin[]): MarkedFontResolver;
 
 /**
  * OOXML content-control lock axis, mirrored from layout boundary records for the
@@ -2879,9 +2964,8 @@ declare function useContentControlInstance(): UseContentControlResult;
  * change appears, then authors who only commented. One person is one colour across the two.
  * Once assigned, a slot stays with that author for the attached document session.
  *
- * A read of the rendered projection, not of the package: a resolved view hides the
- * revisions it has resolved away, so an author whose only change is hidden there is listed
- * only if they also commented.
+ * The complete attached-document roster. An author remains here while the current review
+ * view hides their revisions and comments, so reviewer chrome can turn them on again.
  *
  * The array is reference-stable between changes (the facade caches per layout and colour
  * state), so it is safe as a dependency and under `useSyncExternalStore`.
@@ -3981,4 +4065,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 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 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 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, 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 };