@docx-editor.dev/react 2.0.0 → 2.1.0

package/README.md

@@ -18,7 +18,7 @@ WYSIWYG `.docx` editor for React. Opens a Word file in the browser, paints the r
 layout, edits it in place, and writes a `.docx` back out. No upload service, no conversion
 backend: parsing and serialization both happen client-side.
 
-**It is lossless.** Everything you do not edit comes back byte for byte, including the parts
+Saving is lossless. Everything you do not edit comes back byte for byte, including the parts
 the editor does not understand: custom XML, embedded fonts, macros, unknown extensions. Two
 oracles gate that in CI, so opening a document here cannot quietly destroy it.
 
@@ -31,7 +31,7 @@ npm install @docx-editor.dev/react
 ```tsx
 import { useState } from 'react';
 import { DocxEditor } from '@docx-editor.dev/react';
-import '@docx-editor.dev/react/styles.css';
+import '@docx-editor.dev/core/styles/editor.css';
 
 export function App() {
   const [doc, setDoc] = useState<Uint8Array>();
@@ -54,17 +54,17 @@ export function App() {
 }
 ```
 
-`<DocxEditor>` is the batteries-included host: title bar, menu, toolbar, navigation pane,
-context menu, and the painted document. Two things catch people out: it fills its parent, so
-give it a box with a real height, and the stylesheet import is required once.
+`<DocxEditor>` is the full packaged editor: title bar, menu, toolbar, navigation pane,
+context menu, and the painted document. It fills its parent, so give it a box with a real
+height, and import the stylesheet once.
 
 > **Next.js / SSR:** the editor measures text in the DOM at mount, so render it client-side
 > (`dynamic(..., { ssr: false })`).
 
 ## Build your own UI
 
-The packaged chrome is one arrangement of parts that are all public. There is no private API
-behind it. Every packaged control is a consumer of the same hooks you would use.
+The packaged chrome is one arrangement of public parts. Every packaged control uses the same
+hooks you would; there is no private API behind it.
 
 ```tsx
 import { DocxEditor, useEditorCommand } from '@docx-editor.dev/react';
@@ -96,7 +96,7 @@ export function Editor({ bytes }: { bytes: Uint8Array }) {
 ```
 
 `Root` owns the editor instance, `Viewport` is the scroll container, `Content` is where pages
-are painted. Everything else — toolbar, menu, rulers, navigation, link popover, context menu —
+are painted. Everything else (toolbar, menu, rulers, navigation, link popover, context menu)
 is optional and placed by name.
 
 The customization ladder, in order: `className` and `data-active` → the `icon` prop →

package/dist/index.d.mts

@@ -38,7 +38,7 @@ interface DocxEditorLoadingProps {
      * provider only after those resolve.
      */
     when?: boolean;
-    /** Appended after the load-bearing `ep-root docx-editor__loading` classes. */
+    /** Appended after the load-bearing `docx-editor docx-editor__loading` classes. */
     className?: string;
     /** Inline styles for the loading container, as on `DocxEditor.Viewport`. */
     style?: CSSProperties;
@@ -101,7 +101,7 @@ interface DocxEditorLoadingComponent {
  * report otherwise — the same rule `useEditorState` documents for a null editor. Place
  * it inside the provider unless a permanently-visible placeholder is what you want.
  *
- * Carries its own `ep-root`, so the theme tokens resolve wherever it is composed.
+ * Carries its own `docx-editor`, so the theme tokens resolve wherever it is composed.
  *
  * @public
  */
@@ -1079,17 +1079,23 @@ interface DocxEditorRulerProps {
  * 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;
+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}.
+ *
  * @public
  */
-declare function DocxEditorVerticalRuler(props: DocxEditorRulerProps): ReactElement;
+declare function DocxEditorVerticalRuler(props: DocxEditorRulerProps): ReactElement | null;
 
 /** Props for the context-fed outline part. @public */
 interface DocxEditorDocumentOutlineProps {
@@ -1105,9 +1111,12 @@ interface DocxEditorDocumentOutlineProps {
  * 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;
+declare function DocxEditorDocumentOutline(props: DocxEditorDocumentOutlineProps): ReactElement | null;
 
 /** The pane's tabs. Word's Replace tab is a later slice; nothing here pretends it exists. */
 type NavigationTab$1 = 'headings' | 'find';
@@ -1839,8 +1848,12 @@ interface DocxEditorProps {
      * Strings still come from `packages/i18n/en.json` rather than literals in components;
      * this only chooses who resolves the key. For another language, pass
      * `createT(locale)` from `@docx-editor.dev/i18n`.
+     *
+     * `params` carries interpolation values for parameterized keys (for example the
+     * navigation pane's `{current} of {total}` match counter) — a resolver that ignores
+     * them renders the raw placeholders for those labels.
      */
-    t?: (key: string) => string;
+    t?: (key: string, params?: Record<string, string | number>) => string;
     /**
      * Renders the packaged chrome — title bar and toolbar — around the document.
      * Default `true`. Set `false` for the painted surface alone when the host supplies
@@ -2074,6 +2087,44 @@ declare function useTranslation(): {
     t: TFunction;
 };
 
+/**
+ * A chrome-part label resolver: plain string keys, optional interpolation params.
+ *
+ * This is the shape every packaged part's `t` prop accepts. It takes `string` rather
+ * than the `TranslationKey` union so a host can route its own extra keys through the
+ * same resolver.
+ *
+ * @public
+ */
+type ChromeTranslate = (key: string, params?: Record<string, string | number>) => string;
+/**
+ * The catalogue-backed resolver for composed chrome, ready to pass as any part's `t`.
+ *
+ * `useTranslation().t` is keyed by the strict `TranslationKey` union, which does not
+ * assign to the parts' plain-`string` `t` props — so before this hook, every composing
+ * host hand-wrote the same cast wrapper `<DocxEditor>` builds internally. This is that
+ * wrapper, exported: it resolves through the active `LocaleContext` catalogue (bundled
+ * English by default), with `overrides` consulted first for key-level renames.
+ *
+ * ```tsx
+ * const MY_LABELS = new Map([['toolbar.bold', 'Heavy']]); // module-level: stable identity
+ *
+ * const t = useChromeTranslate(MY_LABELS);
+ * <DocxEditor.Toolbar t={t} />
+ * ```
+ *
+ * Keep the `overrides` Map identity stable (module-level or memoized) — the returned
+ * resolver is memoized on it, and an inline `new Map(...)` re-creates the resolver, and
+ * with it every consuming part's props, on each render.
+ *
+ * `overrides` is a `Map` on purpose: the key is caller input, and an object literal
+ * would answer `constructor` and `toString` off the prototype chain. Parts pass no
+ * `params` today for overridden keys, so override values are literal strings.
+ *
+ * @public
+ */
+declare function useChromeTranslate(overrides?: ReadonlyMap<string, string>): ChromeTranslate;
+
 /** Live furniture scope state from `Editor.getHeaderFooterState()`. */
 type HeaderFooterState = Exclude<ReturnType<Editor['getHeaderFooterState']>, null>;
 /**
@@ -3260,4 +3311,4 @@ declare function useEditorSnapshot(editor: Editor | null): number;
  */
 declare const VERSION = "0.0.2";
 
-export { CONTENT_CONTROL_SLOTS, type ContentControlActionProps, type ContentControlInspectorState, type ContentControlLock, type ContentControlPartProps, type ContentControlProps, type ContentControlSlotId, type ContextMenuAnchor, ContextMenuCellVerticalAlignment, type ContextMenuCommandProps, ContextMenuCopy, ContextMenuCut, ContextMenuDelete, ContextMenuDeleteTable, ContextMenuDeleteTableColumn, ContextMenuDeleteTableRow, ContextMenuInsertColumnLeft, ContextMenuInsertColumnRight, ContextMenuInsertRowAbove, ContextMenuInsertRowBelow, ContextMenuItem, type ContextMenuItemProps, ContextMenuPaste, ContextMenuSelectAll, type ContextMenuTableRowProps, DocumentName, DocxEditor, DocxEditorContent, DocxEditorContentControl, type DocxEditorContentControlNamespace, type DocxEditorContentProps, DocxEditorContextMenu, type DocxEditorContextMenuNamespace, type DocxEditorContextMenuProps, DocxEditorDocumentOutline, type DocxEditorDocumentOutlineProps, 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, DocxEditorPageSetupDialog, type DocxEditorPageSetupDialogProps, type DocxEditorProps, type DocxEditorRef, DocxEditorRoot, 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, ImageWrap, type IndentUpdate, LocaleProvider, Logo, 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, type OutlineHeading$1 as OutlineHeading, type OutlineHeadingItem, PageIndicator, type PageSetupUpdate, PaginatedDocxEditor, type PaginatedDocxEditorHandle as PaginatedDocxEditorExpose, type PaginatedDocxEditorHandle, type PaginatedDocxEditorProps, PaginatedDocxEditorShell, type PaginatedDocxEditorShellProps, type ParagraphStyleItemProps, type ParagraphStyleNamespace, type ParagraphStyleOption, type ParagraphStylePartProps, type ParagraphStyleProps, RULER_WIDTH, ReviewRailContext, type ReviewRailRegistry, SEARCH_DEBOUNCE_MS, SEARCH_MATCH_LIMIT, 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, ToolbarGroup, 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 UseParagraphIndentReturn, type UseParagraphStyleResult, VERSION, VerticalRuler, type VerticalRulerProps, navigationPaneReservation, navigationShift, normalizeImageBytes, useContentControl, useContentControlInstance, useContextMenuTarget, useDocumentOutline, useDocumentSearch, useDocxEditor, useDocxSource, useEditorCaret, useEditorCommand, useEditorEvent, useEditorSnapshot, useEditorState, useEditorValueCommand, useFontFamily, useFonts, useHeaderFooterState, useHyperlinkPopup, useHyperlinkPopupInstance, useNavigationPane, useNavigationShift, useNotePropertiesState, useNoteScopeState, usePageSetup, useParagraphIndent, useParagraphStyle, useTableBorderTargetLabel, useTranslation };
+export { CONTENT_CONTROL_SLOTS, type ChromeTranslate, type ContentControlActionProps, type ContentControlInspectorState, type ContentControlLock, type ContentControlPartProps, type ContentControlProps, type ContentControlSlotId, type ContextMenuAnchor, ContextMenuCellVerticalAlignment, type ContextMenuCommandProps, ContextMenuCopy, ContextMenuCut, ContextMenuDelete, ContextMenuDeleteTable, ContextMenuDeleteTableColumn, ContextMenuDeleteTableRow, ContextMenuInsertColumnLeft, ContextMenuInsertColumnRight, ContextMenuInsertRowAbove, ContextMenuInsertRowBelow, ContextMenuItem, type ContextMenuItemProps, ContextMenuPaste, ContextMenuSelectAll, type ContextMenuTableRowProps, DocumentName, DocxEditor, DocxEditorContent, DocxEditorContentControl, type DocxEditorContentControlNamespace, type DocxEditorContentProps, DocxEditorContextMenu, type DocxEditorContextMenuNamespace, type DocxEditorContextMenuProps, DocxEditorDocumentOutline, type DocxEditorDocumentOutlineProps, 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, DocxEditorPageSetupDialog, type DocxEditorPageSetupDialogProps, type DocxEditorProps, type DocxEditorRef, DocxEditorRoot, 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, ImageWrap, type IndentUpdate, LocaleProvider, Logo, 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, type OutlineHeading$1 as OutlineHeading, type OutlineHeadingItem, PageIndicator, type PageSetupUpdate, PaginatedDocxEditor, type PaginatedDocxEditorHandle as PaginatedDocxEditorExpose, type PaginatedDocxEditorHandle, type PaginatedDocxEditorProps, PaginatedDocxEditorShell, type PaginatedDocxEditorShellProps, type ParagraphStyleItemProps, type ParagraphStyleNamespace, type ParagraphStyleOption, type ParagraphStylePartProps, type ParagraphStyleProps, RULER_WIDTH, ReviewRailContext, type ReviewRailRegistry, SEARCH_DEBOUNCE_MS, SEARCH_MATCH_LIMIT, 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, ToolbarGroup, 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 UseParagraphIndentReturn, type UseParagraphStyleResult, VERSION, VerticalRuler, type VerticalRulerProps, navigationPaneReservation, navigationShift, normalizeImageBytes, useChromeTranslate, useContentControl, useContentControlInstance, useContextMenuTarget, useDocumentOutline, useDocumentSearch, useDocxEditor, useDocxSource, useEditorCaret, useEditorCommand, useEditorEvent, useEditorSnapshot, useEditorState, useEditorValueCommand, useFontFamily, useFonts, useHeaderFooterState, useHyperlinkPopup, useHyperlinkPopupInstance, useNavigationPane, useNavigationShift, useNotePropertiesState, useNoteScopeState, usePageSetup, useParagraphIndent, useParagraphStyle, useTableBorderTargetLabel, useTranslation };

package/dist/index.d.ts

@@ -38,7 +38,7 @@ interface DocxEditorLoadingProps {
      * provider only after those resolve.
      */
     when?: boolean;
-    /** Appended after the load-bearing `ep-root docx-editor__loading` classes. */
+    /** Appended after the load-bearing `docx-editor docx-editor__loading` classes. */
     className?: string;
     /** Inline styles for the loading container, as on `DocxEditor.Viewport`. */
     style?: CSSProperties;
@@ -101,7 +101,7 @@ interface DocxEditorLoadingComponent {
  * report otherwise — the same rule `useEditorState` documents for a null editor. Place
  * it inside the provider unless a permanently-visible placeholder is what you want.
  *
- * Carries its own `ep-root`, so the theme tokens resolve wherever it is composed.
+ * Carries its own `docx-editor`, so the theme tokens resolve wherever it is composed.
  *
  * @public
  */
@@ -1079,17 +1079,23 @@ interface DocxEditorRulerProps {
  * 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;
+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}.
+ *
  * @public
  */
-declare function DocxEditorVerticalRuler(props: DocxEditorRulerProps): ReactElement;
+declare function DocxEditorVerticalRuler(props: DocxEditorRulerProps): ReactElement | null;
 
 /** Props for the context-fed outline part. @public */
 interface DocxEditorDocumentOutlineProps {
@@ -1105,9 +1111,12 @@ interface DocxEditorDocumentOutlineProps {
  * 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;
+declare function DocxEditorDocumentOutline(props: DocxEditorDocumentOutlineProps): ReactElement | null;
 
 /** The pane's tabs. Word's Replace tab is a later slice; nothing here pretends it exists. */
 type NavigationTab$1 = 'headings' | 'find';
@@ -1839,8 +1848,12 @@ interface DocxEditorProps {
      * Strings still come from `packages/i18n/en.json` rather than literals in components;
      * this only chooses who resolves the key. For another language, pass
      * `createT(locale)` from `@docx-editor.dev/i18n`.
+     *
+     * `params` carries interpolation values for parameterized keys (for example the
+     * navigation pane's `{current} of {total}` match counter) — a resolver that ignores
+     * them renders the raw placeholders for those labels.
      */
-    t?: (key: string) => string;
+    t?: (key: string, params?: Record<string, string | number>) => string;
     /**
      * Renders the packaged chrome — title bar and toolbar — around the document.
      * Default `true`. Set `false` for the painted surface alone when the host supplies
@@ -2074,6 +2087,44 @@ declare function useTranslation(): {
     t: TFunction;
 };
 
+/**
+ * A chrome-part label resolver: plain string keys, optional interpolation params.
+ *
+ * This is the shape every packaged part's `t` prop accepts. It takes `string` rather
+ * than the `TranslationKey` union so a host can route its own extra keys through the
+ * same resolver.
+ *
+ * @public
+ */
+type ChromeTranslate = (key: string, params?: Record<string, string | number>) => string;
+/**
+ * The catalogue-backed resolver for composed chrome, ready to pass as any part's `t`.
+ *
+ * `useTranslation().t` is keyed by the strict `TranslationKey` union, which does not
+ * assign to the parts' plain-`string` `t` props — so before this hook, every composing
+ * host hand-wrote the same cast wrapper `<DocxEditor>` builds internally. This is that
+ * wrapper, exported: it resolves through the active `LocaleContext` catalogue (bundled
+ * English by default), with `overrides` consulted first for key-level renames.
+ *
+ * ```tsx
+ * const MY_LABELS = new Map([['toolbar.bold', 'Heavy']]); // module-level: stable identity
+ *
+ * const t = useChromeTranslate(MY_LABELS);
+ * <DocxEditor.Toolbar t={t} />
+ * ```
+ *
+ * Keep the `overrides` Map identity stable (module-level or memoized) — the returned
+ * resolver is memoized on it, and an inline `new Map(...)` re-creates the resolver, and
+ * with it every consuming part's props, on each render.
+ *
+ * `overrides` is a `Map` on purpose: the key is caller input, and an object literal
+ * would answer `constructor` and `toString` off the prototype chain. Parts pass no
+ * `params` today for overridden keys, so override values are literal strings.
+ *
+ * @public
+ */
+declare function useChromeTranslate(overrides?: ReadonlyMap<string, string>): ChromeTranslate;
+
 /** Live furniture scope state from `Editor.getHeaderFooterState()`. */
 type HeaderFooterState = Exclude<ReturnType<Editor['getHeaderFooterState']>, null>;
 /**
@@ -3260,4 +3311,4 @@ declare function useEditorSnapshot(editor: Editor | null): number;
  */
 declare const VERSION = "0.0.2";
 
-export { CONTENT_CONTROL_SLOTS, type ContentControlActionProps, type ContentControlInspectorState, type ContentControlLock, type ContentControlPartProps, type ContentControlProps, type ContentControlSlotId, type ContextMenuAnchor, ContextMenuCellVerticalAlignment, type ContextMenuCommandProps, ContextMenuCopy, ContextMenuCut, ContextMenuDelete, ContextMenuDeleteTable, ContextMenuDeleteTableColumn, ContextMenuDeleteTableRow, ContextMenuInsertColumnLeft, ContextMenuInsertColumnRight, ContextMenuInsertRowAbove, ContextMenuInsertRowBelow, ContextMenuItem, type ContextMenuItemProps, ContextMenuPaste, ContextMenuSelectAll, type ContextMenuTableRowProps, DocumentName, DocxEditor, DocxEditorContent, DocxEditorContentControl, type DocxEditorContentControlNamespace, type DocxEditorContentProps, DocxEditorContextMenu, type DocxEditorContextMenuNamespace, type DocxEditorContextMenuProps, DocxEditorDocumentOutline, type DocxEditorDocumentOutlineProps, 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, DocxEditorPageSetupDialog, type DocxEditorPageSetupDialogProps, type DocxEditorProps, type DocxEditorRef, DocxEditorRoot, 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, ImageWrap, type IndentUpdate, LocaleProvider, Logo, 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, type OutlineHeading$1 as OutlineHeading, type OutlineHeadingItem, PageIndicator, type PageSetupUpdate, PaginatedDocxEditor, type PaginatedDocxEditorHandle as PaginatedDocxEditorExpose, type PaginatedDocxEditorHandle, type PaginatedDocxEditorProps, PaginatedDocxEditorShell, type PaginatedDocxEditorShellProps, type ParagraphStyleItemProps, type ParagraphStyleNamespace, type ParagraphStyleOption, type ParagraphStylePartProps, type ParagraphStyleProps, RULER_WIDTH, ReviewRailContext, type ReviewRailRegistry, SEARCH_DEBOUNCE_MS, SEARCH_MATCH_LIMIT, 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, ToolbarGroup, 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 UseParagraphIndentReturn, type UseParagraphStyleResult, VERSION, VerticalRuler, type VerticalRulerProps, navigationPaneReservation, navigationShift, normalizeImageBytes, useContentControl, useContentControlInstance, useContextMenuTarget, useDocumentOutline, useDocumentSearch, useDocxEditor, useDocxSource, useEditorCaret, useEditorCommand, useEditorEvent, useEditorSnapshot, useEditorState, useEditorValueCommand, useFontFamily, useFonts, useHeaderFooterState, useHyperlinkPopup, useHyperlinkPopupInstance, useNavigationPane, useNavigationShift, useNotePropertiesState, useNoteScopeState, usePageSetup, useParagraphIndent, useParagraphStyle, useTableBorderTargetLabel, useTranslation };
+export { CONTENT_CONTROL_SLOTS, type ChromeTranslate, type ContentControlActionProps, type ContentControlInspectorState, type ContentControlLock, type ContentControlPartProps, type ContentControlProps, type ContentControlSlotId, type ContextMenuAnchor, ContextMenuCellVerticalAlignment, type ContextMenuCommandProps, ContextMenuCopy, ContextMenuCut, ContextMenuDelete, ContextMenuDeleteTable, ContextMenuDeleteTableColumn, ContextMenuDeleteTableRow, ContextMenuInsertColumnLeft, ContextMenuInsertColumnRight, ContextMenuInsertRowAbove, ContextMenuInsertRowBelow, ContextMenuItem, type ContextMenuItemProps, ContextMenuPaste, ContextMenuSelectAll, type ContextMenuTableRowProps, DocumentName, DocxEditor, DocxEditorContent, DocxEditorContentControl, type DocxEditorContentControlNamespace, type DocxEditorContentProps, DocxEditorContextMenu, type DocxEditorContextMenuNamespace, type DocxEditorContextMenuProps, DocxEditorDocumentOutline, type DocxEditorDocumentOutlineProps, 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, DocxEditorPageSetupDialog, type DocxEditorPageSetupDialogProps, type DocxEditorProps, type DocxEditorRef, DocxEditorRoot, 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, ImageWrap, type IndentUpdate, LocaleProvider, Logo, 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, type OutlineHeading$1 as OutlineHeading, type OutlineHeadingItem, PageIndicator, type PageSetupUpdate, PaginatedDocxEditor, type PaginatedDocxEditorHandle as PaginatedDocxEditorExpose, type PaginatedDocxEditorHandle, type PaginatedDocxEditorProps, PaginatedDocxEditorShell, type PaginatedDocxEditorShellProps, type ParagraphStyleItemProps, type ParagraphStyleNamespace, type ParagraphStyleOption, type ParagraphStylePartProps, type ParagraphStyleProps, RULER_WIDTH, ReviewRailContext, type ReviewRailRegistry, SEARCH_DEBOUNCE_MS, SEARCH_MATCH_LIMIT, 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, ToolbarGroup, 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 UseParagraphIndentReturn, type UseParagraphStyleResult, VERSION, VerticalRuler, type VerticalRulerProps, navigationPaneReservation, navigationShift, normalizeImageBytes, useChromeTranslate, useContentControl, useContentControlInstance, useContextMenuTarget, useDocumentOutline, useDocumentSearch, useDocxEditor, useDocxSource, useEditorCaret, useEditorCommand, useEditorEvent, useEditorSnapshot, useEditorState, useEditorValueCommand, useFontFamily, useFonts, useHeaderFooterState, useHyperlinkPopup, useHyperlinkPopupInstance, useNavigationPane, useNavigationShift, useNotePropertiesState, useNoteScopeState, usePageSetup, useParagraphIndent, useParagraphStyle, useTableBorderTargetLabel, useTranslation };