docx-vue-viewer 0.4.1 → 0.4.3

package/dist/index.d.ts

@@ -1,12 +1,45 @@
 import * as vue from 'vue';
 import { PropType } from 'vue';
-import { DocumentModel, WatermarkSpec, SectionProperties, PageBorders, SectionColumns, PendingMediaPart } from 'docx-core';
+import { DocumentModel } from 'docx-core';
 export * from 'docx-core';
-import { Plugin, EditorState, Transaction } from 'prosemirror-state';
-import { EditorView } from 'prosemirror-view';
-import { loadDocument } from 'ooxml-core/docx/load';
+import { EditorThemeMode, RibbonActionInput, DocxEditorElement, EditorLocaleInput, PageChangeDetail } from 'ooxml-ui/docx';
+export * from 'ooxml-ui/docx';
 export { DocumentFormat, detectDocumentFormat, loadDocument } from 'ooxml-core/docx/load';
-import { Node } from 'prosemirror-model';
+
+declare const WordEditor: vue.DefineComponent<vue.ExtractPropTypes<{
+    documentModel: PropType<DocumentModel>;
+    readOnly: BooleanConstructor;
+    locale: StringConstructor;
+    theme: PropType<EditorThemeMode>;
+    showThumbnails: BooleanConstructor;
+    showToolbar: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    hiddenActions: PropType<readonly RibbonActionInput[]>;
+}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("document-change" | "document-error" | "page-change" | "dirty-change")[], "document-change" | "document-error" | "page-change" | "dirty-change", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    documentModel: PropType<DocumentModel>;
+    readOnly: BooleanConstructor;
+    locale: StringConstructor;
+    theme: PropType<EditorThemeMode>;
+    showThumbnails: BooleanConstructor;
+    showToolbar: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    hiddenActions: PropType<readonly RibbonActionInput[]>;
+}>> & Readonly<{
+    "onDocument-change"?: (...args: any[]) => any;
+    "onDocument-error"?: (...args: any[]) => any;
+    "onPage-change"?: (...args: any[]) => any;
+    "onDirty-change"?: (...args: any[]) => any;
+}>, {
+    readOnly: boolean;
+    showThumbnails: boolean;
+    showToolbar: boolean;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 
 /** Editor state a framework passes down as props. */
 interface EditorProps {
@@ -47,1304 +80,5 @@ interface EditorBinding extends EditorHandle {
     destroy(): void;
 }
 
-interface CollaborationConfig {
-    sessionId: string;
-    clientId: string;
-    version?: number;
-}
-/** Version is the authority version immediately before applying these steps. */
-interface StepBatch {
-    protocol: 1;
-    sessionId: string;
-    batchId: string;
-    version: number;
-    clientId: string;
-    steps: readonly unknown[];
-}
-
-interface CollaborationAuthorityConfig {
-    sessionId: string;
-    doc: Node;
-    version?: number;
-    stepHistoryLimit?: number;
-}
-type AuthorityResult = {
-    status: 'accepted' | 'duplicate';
-    batch: StepBatch;
-} | {
-    status: 'rejected';
-    reason: string;
-};
-/** Small in-memory reference authority. A host should replace it with its server and persistence. */
-declare class CollaborationAuthority {
-    readonly sessionId: string;
-    private readonly schema;
-    private readonly stepHistoryLimit;
-    private version;
-    private documents;
-    private records;
-    private readonly requests;
-    constructor(config: CollaborationAuthorityConfig);
-    get currentVersion(): number;
-    get doc(): Node;
-    submit(input: unknown): AuthorityResult;
-    private pruneHistory;
-}
-
-type ClientReceiveResult = {
-    status: 'applied';
-    transaction: Transaction;
-} | {
-    status: 'duplicate' | 'stale' | 'out-of-order' | 'wrong-session' | 'invalid';
-    reason?: string;
-};
-/** Client-side plugin and transport helpers. It does not open a network connection. */
-declare class CollaborationClient {
-    readonly plugin: Plugin;
-    readonly sessionId: string;
-    readonly clientId: string;
-    private readonly config;
-    private sequence;
-    private pending?;
-    private readonly received;
-    constructor(config: CollaborationConfig);
-    get hasPendingAck(): boolean;
-    pendingStepCount(state: EditorState): number;
-    /** Returns the same envelope until acknowledged, so transport retries are idempotent. */
-    createPendingBatch(state: EditorState): StepBatch | null;
-    /** Converts one ordered authority batch into the transaction hosts should dispatch. */
-    receive(state: EditorState, input: unknown): ClientReceiveResult;
-}
-
-/**
- * Editor theme tokens.
- *
- * Provenance: the semantic key set mirrors the shared theme of pptx-viewer
- * (packages/shared/src/theme/types.ts, `ViewerThemeColors` plus `radius`), which follows the
- * shadcn/ui naming convention. Keys are camelCase here and become `--dve-*` custom properties
- * (kebab-case). Values accept any CSS color. Only editor chrome is themed: the document paper
- * stays white like Word's page.
- */
-interface EditorTheme {
-    /** Application chrome background (title bar, window). */
-    background: string;
-    foreground: string;
-    /** Ribbon, panel and status-bar surface. */
-    card: string;
-    cardForeground: string;
-    /** Menus, dialogs and other floating surfaces. */
-    popover: string;
-    popoverForeground: string;
-    /** Brand and primary action color. */
-    primary: string;
-    primaryForeground: string;
-    secondary: string;
-    secondaryForeground: string;
-    /** Muted surface; also the area behind the document pages. */
-    muted: string;
-    mutedForeground: string;
-    /** Hover and selected highlight. */
-    accent: string;
-    accentForeground: string;
-    destructive: string;
-    destructiveForeground: string;
-    border: string;
-    input: string;
-    /** Focus ring. */
-    ring: string;
-    /** Base corner radius, e.g. `4px`. */
-    radius: string;
-}
-type EditorThemeMode = 'light' | 'dark' | 'auto';
-
-/**
- * Light preset: Word's neutral chrome with Word blue as primary. Neutrals follow the same
- * role split as pptx-viewer's light theme (background, card, muted, border).
- */
-declare const lightTheme: EditorTheme;
-/**
- * Dark preset: pptx-viewer's default dark gray scale (gray-950/900/800/700) with a lighter Word
- * blue as primary so it stays legible on dark surfaces.
- */
-declare const darkTheme: EditorTheme;
-
-/** Convert a (partial) theme to `--dve-*` custom properties. Unknown or empty values are skipped. */
-declare function themeToCssVars(theme: Partial<EditorTheme> | undefined): Record<string, string>;
-
-/** Canonical codes of the supported display locales, in menu order. */
-declare const EDITOR_LOCALES: readonly ["en", "fr", "de", "es", "zh-CN"];
-
-/** Display-language strings for the shared editor UI. This locale never changes DOCX language marks. */
-
-type EditorLocale = (typeof EDITOR_LOCALES)[number];
-/** A locale code a host may pass: a canonical code (autocompleted) or any BCP 47 tag such as `de-DE`. */
-type EditorLocaleInput = EditorLocale | (string & {});
-
-/**
- * Maps any BCP 47 tag to a supported display locale, falling back to English. Region variants
- * resolve to their language (`fr-CA`, `de-DE`, `es-MX`); `zh`, `zh-CN`, `zh-Hans` and `zh-SG` use
- * Simplified Chinese, while Traditional tags (`zh-TW`, `zh-HK`, `zh-Hant`) are unsupported.
- */
-declare function normalizeEditorLocale(value: string | null | undefined): EditorLocale;
-
-interface FormatDialog {
-    element: HTMLElement;
-    open(): void;
-    close(): void;
-    setLocale(locale: EditorLocale): void;
-    readonly isOpen: boolean;
-}
-
-interface WatermarkHost {
-    current(): WatermarkSpec | undefined;
-    canEdit(): boolean;
-    /** Sets the watermark in every header; undefined removes it. */
-    apply(spec: WatermarkSpec | undefined): void;
-    restoreFocus(): void;
-}
-
-interface PageBordersHost {
-    section(): SectionProperties | undefined;
-    canEdit(): boolean;
-    /** Replaces the current section's page borders; undefined removes them. */
-    apply(borders: PageBorders | undefined): void;
-    restoreFocus(): void;
-}
-
-/** What Word's Page Setup dialog edits for one section, in inches. */
-interface PageSetupValues {
-    topIn: number;
-    bottomIn: number;
-    leftIn: number;
-    rightIn: number;
-    gutterIn: number;
-    headerIn: number;
-    footerIn: number;
-    orientation: 'portrait' | 'landscape';
-    /** Portrait width and height; landscape swaps them when applied. */
-    widthIn: number;
-    heightIn: number;
-}
-
-interface PageSetupHost {
-    /** The section holding the selection, or undefined when there is none to edit. */
-    section(): SectionProperties | undefined;
-    canEdit(): boolean;
-    apply(values: PageSetupValues): void;
-    restoreFocus(): void;
-}
-
-type ZoomFit = 'actual' | 'width' | 'page' | 'pages';
-
-interface ZoomHost {
-    /** The current zoom, in percent. */
-    percent(): number;
-    setPercent(percent: number): void;
-    fit(mode: ZoomFit): void;
-    restoreFocus(): void;
-}
-
-type LineNumberSettings = NonNullable<SectionProperties['lineNumberSettings']>;
-interface LineNumberHost {
-    section(): SectionProperties | undefined;
-    canEdit(): boolean;
-    apply(settings: LineNumberSettings | undefined): void;
-    restoreFocus(): void;
-}
-
-interface ColumnsHost {
-    section(): SectionProperties | undefined;
-    canEdit(): boolean;
-    apply(columns: SectionColumns): void;
-    restoreFocus(): void;
-}
-
-type FormatDialogKind = 'font' | 'paragraph' | 'bookmark' | 'pageSetup' | 'caption' | 'crossReference' | 'zoom' | 'borders' | 'tableProperties' | 'lineNumbers' | 'textBox' | 'pageBorders' | 'watermark' | 'dropCap' | 'columns' | 'multilevelList';
-interface FormatDialogsHost {
-    view(): EditorView | undefined;
-    /** Header/footer edits use the main document's history; notes use their own. */
-    historyView?(): EditorView | undefined;
-    model(): DocumentModel;
-    canDefineList?(): boolean;
-    /** Page Setup edits the section holding the selection. */
-    pageSetup?: Omit<PageSetupHost, 'restoreFocus'>;
-    /** View > Zoom: the current zoom and how to change it. */
-    zoom?: Omit<ZoomHost, 'restoreFocus'>;
-    lineNumbers?: Omit<LineNumberHost, 'restoreFocus'>;
-    pageBorders?: Omit<PageBordersHost, 'restoreFocus'>;
-    watermark?: Omit<WatermarkHost, 'restoreFocus'>;
-    columns?: Omit<ColumnsHost, 'restoreFocus'>;
-}
-/** The Font and Paragraph dialogs opened from the ribbon's group launchers. */
-declare class FormatDialogs {
-    private readonly dialogs;
-    constructor(host: FormatDialogsHost);
-    get elements(): HTMLElement[];
-    get list(): FormatDialog[];
-    /** Opens `kind`, closing the other one first. */
-    open(kind: FormatDialogKind): void;
-    closeAll(): void;
-    setLocale(locale: EditorLocale): void;
-}
-
-interface SearchPanelHandle {
-    element: HTMLElement;
-    open(focus?: 'find' | 'replace'): void;
-    close(): void;
-    refresh(): void;
-    setLocale(locale: string): void;
-    readonly isOpen: boolean;
-}
-
-declare const PRESENCE_PALETTE: readonly ["#2563eb", "#c2410c", "#15803d", "#a21caf", "#0e7490", "#b91c1c", "#4f46e5", "#a16207"];
-interface PresenceConfig {
-    sessionId: string;
-    clientId: string;
-    /** Display locale of peer labels; English when omitted. */
-    locale?: () => EditorLocale;
-}
-interface PresenceMessage {
-    protocol: 1;
-    sessionId: string;
-    clientId: string;
-    kind: 'selection' | 'leave';
-    sequence: number;
-    version: number;
-    name?: string;
-    color?: string;
-    anchor?: number;
-    head?: number;
-}
-type PresenceReceiveResult = {
-    status: 'applied';
-    transaction: Transaction;
-} | {
-    status: 'duplicate' | 'stale' | 'out-of-order' | 'wrong-session' | 'invalid';
-    reason?: string;
-};
-/** Transient selection sharing for a host-provided transport; it does not send data itself. */
-declare class PresenceClient {
-    readonly plugin: Plugin;
-    readonly sessionId: string;
-    readonly clientId: string;
-    private readonly received;
-    private sequence;
-    constructor(config: PresenceConfig);
-    publish(state: EditorState, profile: {
-        name: string;
-        color: string;
-    }): PresenceMessage | null;
-    leave(state: EditorState): PresenceMessage;
-    receive(state: EditorState, input: unknown): PresenceReceiveResult;
-}
-
-declare class EditorPresence {
-    private element;
-    private view;
-    readonly client: PresenceClient;
-    private profile?;
-    private scheduled;
-    constructor(config: PresenceConfig, element: HTMLElement, view: () => EditorView | undefined);
-    publish(profile: {
-        name: string;
-        color: string;
-    }): PresenceMessage | null;
-    receive(input: unknown): PresenceReceiveResult['status'];
-    leave(): PresenceMessage | null;
-    /** Re-renders peer labels after a display-locale change. */
-    relocalize(): void;
-    schedule(): void;
-    private emit;
-}
-
-/** One editor's collaboration state: step client, presence and collaborative id generator. */
-declare class CollaborationSession {
-    private readonly element;
-    private readonly getView;
-    client?: CollaborationClient | undefined;
-    presence?: EditorPresence | undefined;
-    ids?: ((kind: string) => string) | undefined;
-    private sendScheduled;
-    constructor(element: HTMLElement, getView: () => EditorView | undefined);
-    get active(): boolean;
-    start(config: CollaborationConfig): void;
-    stop(): void;
-    /** Coalesces pending steps into one `collaboration-send` event per microtask. */
-    scheduleSend(pending: () => StepBatch | null): void;
-}
-
-/**
- * Print Layout view: a read-only, paginated render kept in sync with the
- * editor model on a debounced relayout, rather than a second live editing
- * surface. Clicking a line asks the caller to move the real ProseMirror
- * cursor to the nearest editor position (see `print-layout.ts`'s
- * `resolveClick`), which is the chosen approach for keeping a single
- * source of truth for editing while still allowing click-to-place-cursor
- * from the paginated view.
- */
-interface PrintLayoutController {
-    /** Mount this in the DOM alongside the continuous editing surface. */
-    element: HTMLElement;
-    setActive(active: boolean): void;
-    scheduleRelayout(model: DocumentModel): void;
-    /** Recomputes which page is most visible; call on the scroll container's `scroll` event. */
-    refreshCurrentPage(): void;
-    pageStatus(): {
-        current: number;
-        total: number;
-    } | null;
-    /** The laid-out page sheets currently in the DOM, in order. */
-    pageElements(): HTMLElement[];
-    /** Increments on every layout pass so dependants (the page navigator) know when to rebuild. */
-    layoutVersion(): number;
-    /** Scrolls the given 1-based page to the top of the scroll container. */
-    scrollToPage(page: number): void;
-    /** Approximations collected by the last layout pass (see `LayoutResult.approximations`). */
-    approximations(): string[];
-    /** Lays out immediately (no debounce) and opens the browser print dialog for the paginated render. */
-    print(model: DocumentModel, note: (message: string) => void): void;
-    destroy(): void;
-}
-
-/**
- * All Markup shows insertions/deletions as authored (default CSS from schema.ts's marks).
- * No Markup (final) hides deleted text and shows insertions unmarked, matching the resulting document.
- * Original hides inserted text and shows deletions unmarked, matching the document before the changes.
- * Simple Markup is approximated as No Markup with a change indicator; per-line change bars are not
- * implemented, so it is visually identical to No Markup today (see docs/parity-roadmap.md).
- */
-type ReviewDisplayMode = 'all' | 'simple' | 'final' | 'original';
-
-interface CommentsPanelHandle {
-    element: HTMLElement;
-    open(): void;
-    close(): void;
-    refresh(): void;
-    setLocale(locale: string): void;
-    readonly isOpen: boolean;
-}
-
-type TableCommand = 'rowBefore' | 'rowAfter' | 'deleteRow' | 'columnBefore' | 'columnAfter' | 'deleteColumn' | 'deleteTable';
-
-type LanguageField = 'language' | 'eastAsiaLanguage' | 'bidiLanguage';
-type MultilingualAction = {
-    type: 'paragraphDirection';
-    value: 'inherit' | 'ltr' | 'rtl';
-} | {
-    type: 'language';
-    key: LanguageField;
-    value: string;
-} | {
-    type: 'runRtl';
-    value: 'inherit' | 'on' | 'off';
-};
-
-/** Every command the ribbon can raise, dispatched as a `ribbon-action` event. */
-type RibbonAction = {
-    type: 'format';
-    key: 'bold' | 'italic' | 'underline' | 'strike' | 'superscript' | 'subscript';
-} | {
-    type: 'history';
-    key: 'undo' | 'redo';
-} | {
-    type: 'align';
-    value: 'left' | 'center' | 'right' | 'justify';
-} | {
-    type: 'font';
-    key: 'family' | 'size' | 'color' | 'highlight';
-    value: string;
-} | {
-    type: 'clear';
-} | {
-    type: 'table';
-    rows?: number;
-    columns?: number;
-} | {
-    type: 'tablePicker';
-} | {
-    type: 'clipboard';
-    key: 'cut' | 'copy' | 'paste';
-} | {
-    type: 'fontStep';
-    direction: 'grow' | 'shrink';
-} | {
-    type: 'insertBreak';
-    kind: 'page' | 'column';
-} | {
-    type: 'tableEdit';
-    key: TableCommand;
-} | {
-    type: 'page';
-    key: 'margin' | 'orientation' | 'columns' | 'numberFormat' | 'numberStart' | 'titlePage' | 'verticalAlign' | 'lineNumbers' | 'size';
-    value: string;
-} | {
-    type: 'sectionBreak';
-    kind: 'nextPage' | 'continuous' | 'evenPage' | 'oddPage';
-} | {
-    type: 'evenOddHeaders';
-} | {
-    type: 'pageColor';
-    value: string;
-} | {
-    type: 'hyphenation';
-    value: string;
-} | {
-    type: 'suppressLineNumbers';
-} | {
-    type: 'paragraph';
-    key: 'indent' | 'spacingBefore' | 'spacingAfter' | 'lineSpacing';
-    value: string;
-} | {
-    type: 'zoom';
-    value: number;
-} | {
-    type: 'list';
-    key: 'bullet' | 'number' | 'multilevel' | 'outline' | 'headings' | 'article' | 'roman' | 'increaseLevel' | 'decreaseLevel' | 'remove';
-} | {
-    type: 'view';
-    value: 'draft' | 'print';
-} | {
-    type: 'print';
-} | MultilingualAction | {
-    type: 'search';
-    focus?: 'find' | 'replace';
-} | {
-    type: 'changeCase';
-    value: 'sentence' | 'lower' | 'upper' | 'title' | 'toggle';
-} | {
-    type: 'formatPainter';
-} | {
-    type: 'ruler';
-} | {
-    type: 'coverPage';
-} | {
-    type: 'sort';
-    order: 'ascending' | 'descending';
-} | {
-    type: 'goTo';
-} | {
-    type: 'selectObjects';
-} | {
-    type: 'addText';
-    level: 0 | 1 | 2 | 3;
-} | {
-    type: 'blankPage';
-} | {
-    type: 'readAloud';
-} | {
-    type: 'gridlines';
-} | {
-    type: 'navigation';
-} | {
-    type: 'shading';
-    value: string;
-} | {
-    type: 'borders';
-    preset: 'none' | 'bottom' | 'top' | 'left' | 'right' | 'all' | 'outside' | 'insideH' | 'insideV' | 'horizontal';
-} | {
-    type: 'pageNumber';
-    position: 'top' | 'bottom';
-    align: 'left' | 'center' | 'right';
-    style?: 'plain' | 'pageOfTotal';
-} | {
-    type: 'headerFooter';
-    kind: 'header' | 'footer';
-    slot?: 'default' | 'first' | 'even';
-} | {
-    type: 'headerFooterLink';
-} | {
-    type: 'headerFooterClose';
-} | {
-    type: 'headerFooterNavigate';
-    target: 'header' | 'footer' | 'previous' | 'next';
-} | {
-    type: 'headerFooterPosition';
-    kind: 'header' | 'footer';
-    inches: number;
-} | {
-    type: 'formatDialog';
-    kind: FormatDialogKind;
-} | {
-    type: 'indent';
-    side: 'left' | 'right';
-    inches: number;
-} | {
-    type: 'zoomFit';
-    mode: 'actual' | 'width' | 'page' | 'pages';
-} | {
-    type: 'wordCount';
-} | {
-    type: 'spelling';
-} | {
-    type: 'insertSymbol';
-    value: string;
-} | {
-    type: 'dropCap';
-    value: 'none' | 'drop' | 'margin';
-} | {
-    type: 'insertDateTime';
-    value: 'long' | 'short' | 'time' | 'datetime';
-} | {
-    type: 'showMarks';
-} | {
-    type: 'selectAll';
-} | {
-    type: 'review';
-    key: 'trackChanges' | 'acceptOne' | 'rejectOne' | 'acceptAll' | 'rejectAll' | 'previous' | 'next';
-} | {
-    type: 'reviewDisplay';
-    value: ReviewDisplayMode;
-} | {
-    type: 'comments';
-    key: 'toggle' | 'add' | 'delete' | 'previous' | 'next';
-} | {
-    type: 'insertPicture';
-} | {
-    type: 'formatPicture';
-} | {
-    type: 'link';
-} | {
-    type: 'characterStyle';
-    value: string;
-} | {
-    type: 'showHidden';
-} | {
-    type: 'thumbnails';
-} | {
-    type: 'insertNote';
-    kind: 'footnote' | 'endnote';
-} | {
-    type: 'toc';
-    key: 'insert' | 'update' | 'remove' | 'fields' | 'figures' | 'updateFigures';
-    levels?: number;
-    label?: string;
-};
-
-/** Narrow view of the host element `ReviewController` needs; keeps component.ts's own diff small. */
-interface ReviewHost {
-    getModel(): DocumentModel;
-    setModel(model: DocumentModel): void;
-    getView(): EditorView | undefined;
-    getReviewAuthor(): string;
-    getCollaborationIds(): ((kind: string) => string) | undefined;
-    notifyChange(): void;
-    refresh(): void;
-}
-/** Owns comment add/reply/resolve/delete and tracked-change accept/reject/navigate/toggle commands. */
-declare class ReviewController {
-    private host;
-    readonly commentsPanel: CommentsPanelHandle;
-    constructor(host: ReviewHost);
-    get commentsOpen(): boolean;
-    setLocale(locale: string): void;
-    /** Removes a comment, its replies and its anchored range in one go. */
-    private deleteById;
-    private updateComments;
-    private addComment;
-    handleReview(key: Extract<RibbonAction, {
-        type: 'review';
-    }>['key']): void;
-    handleComments(key: 'toggle' | 'add' | 'delete' | 'previous' | 'next'): void;
-}
-
-/**
- * Resolves inline picture bytes (kept off the JSON model by docx-core) into object URLs. URLs are
- * cached per package part and revoked together when the owning editor releases the cache.
- */
-declare class ImageMediaCache {
-    private readonly lookup;
-    private readonly urls;
-    constructor(lookup: (partName: string) => Uint8Array | undefined);
-    urlFor(partName: string, contentType: string): string | undefined;
-    release(): void;
-}
-
-type FileCommand = 'new' | 'open' | 'save' | 'saveAs' | 'export' | 'exportText' | 'print';
-interface FileCommandDetail {
-    command: FileCommand;
-    /** Save As: the name the user chose. */
-    fileName?: string;
-}
-
-interface BackstageOptions {
-    locale: string;
-    theme: string;
-    author: string;
-    spellCheck?: boolean;
-    showRuler?: boolean;
-    showMarks?: boolean;
-    showThumbnails?: boolean;
-}
-type BackstageOptionKey = keyof BackstageOptions;
-
-type BackstagePage = 'home' | 'info' | 'new' | 'open' | 'saveAs' | 'print' | 'export' | 'options' | 'customize';
-interface Backstage {
-    element: HTMLElement;
-    open(page?: BackstagePage): void;
-    close(): void;
-    readonly isOpen: boolean;
-}
-
-interface StatusBar {
-    element: HTMLElement;
-    setPageAndWords(page: string, words: string): void;
-    setLanguage(language: string): void;
-    setNoteCount(count: number): void;
-    setViewMode(mode: 'draft' | 'print'): void;
-    setZoom(percent: number): void;
-}
-
-type SaveState = 'saved' | 'dirty' | 'saving' | 'saved-local';
-interface TitleBar {
-    element: HTMLElement;
-    setFileName(name: string): void;
-    setSaveState(state: SaveState): void;
-    setReadOnly(readOnly: boolean): void;
-    setCommentsOpen(open: boolean): void;
-}
-
-/** What the chrome needs from the editor element; keeps component.ts free of chrome details. */
-interface ChromeHost {
-    element: HTMLElement;
-    model(): DocumentModel;
-    ribbon(): HTMLElement | undefined;
-    wordCount(): number;
-    locale(): EditorLocale;
-    readOnly(): boolean;
-    setReadOnly(readOnly: boolean): void;
-    newDocument(): void;
-    load(bytes: Uint8Array): Promise<void>;
-    save(): Promise<Uint8Array>;
-    print(): void;
-    history(key: 'undo' | 'redo'): void;
-    toggleComments(): void;
-    setViewMode(mode: 'draft' | 'print'): void;
-    setZoom(percent: number): void;
-    reportError(error: Error): void;
-    /** Mirrors the title bar's save state into `element.dirty`. */
-    saveStateChanged?(state: SaveState): void;
-    /** Editor options shown on File > Options. */
-    options(): BackstageOptions;
-    setOption(key: BackstageOptionKey, value: string): void;
-    hiddenActions(): readonly string[];
-    setHiddenActions(ids: string[]): void;
-}
-/** Title bar, File tab/backstage, status bar and the default browser file workflow. */
-declare class EditorChrome {
-    private readonly host;
-    readonly titleBar: TitleBar;
-    readonly backstage: Backstage;
-    readonly statusBar: StatusBar;
-    readonly fileInput: HTMLInputElement;
-    private _fileName;
-    private state;
-    constructor(host: ChromeHost);
-    /** Adds the chrome around an existing frame: title bar first, status bar and backstage last. */
-    mount(frame: HTMLElement, ribbon: HTMLElement): void;
-    get fileName(): string;
-    set fileName(value: string);
-    get isDirty(): boolean;
-    setSaveState(state: SaveState): void;
-    setLocale(locale: EditorLocale): void;
-    refresh(pageText: string, wordText: string): void;
-    closeBackstage(): void;
-    /** Runs a file command unless a host cancels the `file-command` event to handle it itself. */
-    run(command: FileCommand, fileName?: string): Promise<void>;
-    private newDocument;
-    private openSelectedFile;
-}
-
-/** What feature controllers need from the editor element, without reaching into its internals. */
-interface EditorHost {
-    readonly element: HTMLElement;
-    view(): EditorView | undefined;
-    model(): DocumentModel;
-    /** Replaces the model for edits made outside the main editing surface. */
-    setModel(model: DocumentModel): void;
-    locale(): EditorLocale;
-    /** Editable and not in a collaboration session (parts and page setup aren't synced). */
-    canEditOutsideBody(): boolean;
-    /** Marks the document changed after an edit outside the main surface. */
-    edited(): void;
-    reportError(cause: unknown): void;
-}
-
-type HeaderFooterSlotName = 'default' | 'first' | 'even';
-
-type NoteKind = 'footnote' | 'endnote';
-
-type HeaderFooterKind = 'headers' | 'footers';
-type HeaderFooterSlot = 'default' | 'first' | 'even';
-
-interface HeaderFooterContext {
-    kind: HeaderFooterKind;
-    slot: HeaderFooterSlot;
-    index: number;
-}
-
-interface PartsControllerHost extends EditorHost {
-    images(): ImageMediaCache;
-    /** Plugins shared with in-place editors (e.g. Ctrl+K). */
-    plugins(): Plugin[];
-    /** Where focus may go without closing an in-place editor: the ribbon and dialogs. */
-    keepOpenWithin(): (Element | undefined)[];
-    sectionIndex?(): number;
-    refreshControls?(): void;
-}
-/** Headers, footers, footnotes and endnotes around the continuous editing surface. */
-declare class PartsController {
-    private readonly host;
-    private headerEl?;
-    private footerEl?;
-    private notesEl?;
-    private active?;
-    private closeActive?;
-    private headerContext?;
-    private shownSection;
-    private renderingContext?;
-    constructor(host: PartsControllerHost);
-    /** The in-place header/footer/note editor currently open, which the ribbon then targets. */
-    activeView(): EditorView | undefined;
-    /** Page-number insertion follows the first/even/default story currently being edited. */
-    activeHeaderFooterSlot(): HeaderFooterSlotName | undefined;
-    headerFooterContext(): HeaderFooterContext | undefined;
-    closeHeaderFooter(canvas?: HTMLElement, paper?: HTMLElement): void;
-    navigate(target: 'header' | 'footer' | 'previous' | 'next', canvas?: HTMLElement, paper?: HTMLElement): void;
-    toggleLink(): void;
-    /** Sets picture sources in a read-only preview from the package media. */
-    private readonly decorate;
-    private editorOptions;
-    /** Header/footer typing and insertion use the body history; notes retain their local stack. */
-    runHistory(key: 'undo' | 'redo'): boolean;
-    usesBodyHistory(): boolean;
-    syncSection(canvas?: HTMLElement, paper?: HTMLElement): void;
-    /** Rebuilds the header/footer/note previews and wires in-place editing. */
-    render(canvas: HTMLElement | undefined, paper: HTMLElement | undefined, keepEditor?: boolean): void;
-    /** Inserts a footnote or endnote reference at the selection and opens the new note for typing. */
-    insertNote(kind: NoteKind, canvas?: HTMLElement, paper?: HTMLElement): void;
-    /** Replaces one footnote's or endnote's blocks. */
-    private updateNote;
-    /** Applies header/footer edits to every section slot that shares the edited part. */
-    private updateHeaderFooter;
-}
-
-interface PageControllerHost extends EditorHost {
-    paper(): HTMLElement | undefined;
-    toolbar(): HTMLElement | undefined;
-    statusBar(): StatusBar | undefined;
-    printLayout(): PrintLayoutController | undefined;
-    refreshControls(): void;
-}
-/** Page setup, section breaks, zoom, Web/Print Layout and printing. */
-declare class PageController {
-    private readonly host;
-    zoom: number;
-    viewMode: 'draft' | 'print';
-    constructor(host: PageControllerHost);
-    /** Page setup applies to the section holding the selection, as in Word, and is undoable. */
-    changePageSetup(key: Extract<RibbonAction, {
-        type: 'page';
-    }>['key'], value: string): void;
-    /** Shows the selection's section settings in the Layout tab. */
-    syncControls(): void;
-    /** The section holding the selection, for the Page Setup dialog. */
-    currentSection(): SectionProperties | undefined;
-    /** Applies the Page Setup dialog to the current section as one undoable step. */
-    applyPageSetupValues(values: PageSetupValues): void;
-    /** Layout > More Columns, recorded as one undoable section edit. */
-    applyColumns(columns: SectionProperties['columns']): void;
-    /** Layout > Line Numbers options, recorded as one undoable section edit. */
-    applyLineNumberSettings(settings: SectionProperties['lineNumberSettings']): void;
-    /** Layout > Watermark: a text watermark in every header (or none), one undoable step. */
-    applyWatermark(spec: WatermarkSpec | undefined): void;
-    /** The document's current watermark, for the Watermark dialog. */
-    currentWatermark(): WatermarkSpec | undefined;
-    /** Layout > Page Borders, recorded as one undoable section edit. */
-    applyPageBorders(borders: SectionProperties['pageBorders']): void;
-    /** Insert > Page Number: a PAGE field in the header or footer, creating the part when needed. */
-    insertPageNumber(position: 'top' | 'bottom', align: 'left' | 'center' | 'right', style?: 'plain' | 'pageOfTotal', slot?: 'default' | 'first' | 'even'): boolean;
-    /** Insert > Header / Footer: an empty part when the document has none. */
-    insertHeaderFooter(kind: 'header' | 'footer', slot?: 'default' | 'first' | 'even'): boolean;
-    private changeHeaderFooter;
-    /** Layout > Page Color (document-wide, undoable): hex with or without `#`, or `none` to clear. */
-    setPageColor(value: string): void;
-    /** Layout > Hyphenation: `auto` sets `w:autoHyphenation`, `none` clears it (document-wide, undoable). */
-    setHyphenation(value: string): void;
-    /** Header & Footer > Different Odd & Even Pages (document-wide, undoable). */
-    toggleEvenOddHeaders(): void;
-    insertSectionBreak(kind: 'nextPage' | 'continuous' | 'evenPage' | 'oddPage'): void;
-    /** Records page geometry and section layout on the editor document as one undoable step. */
-    private dispatchSections;
-    /** Page size and margins from the model; one multi-column section also shows its columns. */
-    refreshPageStyles(): void;
-    /** Zoom to 100%, the page width or a whole page, from the section holding the selection. */
-    zoomTo(mode: ZoomFit): void;
-    /** `sideBySide` lays Print Layout's pages out two across (View > Multiple Pages). */
-    setZoom(percent: number, sideBySide?: boolean): void;
-    /** Switches between the continuous editing surface and the paginated Print Layout render. */
-    setViewMode(mode: 'draft' | 'print'): void;
-    /** Re-lays out Print Layout after a model change (debounced by the layout view). */
-    relayout(): void;
-    print(): void;
-}
-
-interface LinkDialog {
-    element: HTMLElement;
-    open(): void;
-    close(): void;
-    setLocale(locale: EditorLocale): void;
-    readonly isOpen: boolean;
-}
-
-interface PictureDialog {
-    element: HTMLElement;
-    open(pos: number): void;
-    close(): void;
-    setLocale(locale: EditorLocale): void;
-    readonly isOpen: boolean;
-}
-
-interface InsertControllerHost {
-    view(): EditorView | undefined;
-    model(): DocumentModel;
-    /** The editable content width in CSS pixels, used to fit inserted pictures. */
-    contentWidth(): number;
-    paper(): HTMLElement | undefined;
-    toolbar(): HTMLElement | undefined;
-    reportError(error: Error): void;
-}
-/** Picture, link, character style and hidden-text commands shared by every editor instance. */
-declare class InsertController {
-    private readonly host;
-    readonly linkDialog: LinkDialog;
-    readonly pictureDialog: PictureDialog;
-    readonly pictureInput: HTMLInputElement;
-    /** Bytes for pictures inserted since the document was loaded; passed to save. */
-    readonly pendingMedia: Map<string, PendingMediaPart>;
-    private showHidden;
-    private showMarks;
-    private showGridlines;
-    private showRuler;
-    constructor(host: InsertControllerHost);
-    /** Handles the actions this controller owns; returns false for everything else. */
-    handle(action: RibbonAction): boolean;
-    /** Ctrl+K opens the link dialog; Ctrl/Cmd+Click follows a link like Word. */
-    plugins(): Plugin[];
-    handleClick(view: EditorView, pos: number, event: MouseEvent): boolean;
-    /** Media bytes for rendering: pictures inserted in this session first, then the loaded package. */
-    media(partName: string, loaded?: ReadonlyMap<string, Uint8Array>): Uint8Array | undefined;
-    reset(): void;
-    setLocale(locale: EditorLocale): void;
-    /** Re-applies the hidden-text display state after the paper is rebuilt. */
-    syncPaper(): void;
-    /** The ruler sits above the page in the canvas while View > Ruler is on. */
-    private syncRulerElement;
-    private applyRulerChange;
-    private setShowHidden;
-    private insertSelectedPicture;
-}
-
-/** Unsaved-changes flag behind `element.dirty`; reports only real transitions. */
-declare class DirtyState {
-    private readonly changed;
-    private value;
-    constructor(changed: (dirty: boolean) => void);
-    get dirty(): boolean;
-    set(dirty: boolean): void;
-}
-
-/** Payload of the `page-change` event. Pages are 1-based and come from the approximate layout. */
-interface PageChangeDetail {
-    page: number;
-    pageCount: number;
-}
-/** Emits `page-change` only when the page or the page count really changed. */
-declare class PageTracker {
-    private readonly target;
-    private last?;
-    constructor(target: EventTarget);
-    report(status: {
-        current: number;
-        total: number;
-    } | null): void;
-}
-
-/** What the navigator needs from the Print Layout view and the element. */
-interface PageNavigatorHost {
-    /** Laid-out page sheets in order; empty until a layout exists. */
-    pages(): HTMLElement[];
-    /** Changes whenever the layout was rebuilt. */
-    version(): number;
-    goTo(page: number): void;
-    close(): void;
-}
-interface PageNavigatorState {
-    /** Print Layout is the active view. */
-    active: boolean;
-    /** Current page and total, or null while no layout exists. */
-    status: {
-        current: number;
-        total: number;
-    } | null;
-    locale: EditorLocale;
-}
-/**
- * Collapsible left rail of scaled page thumbnails. Thumbnails are clones of the Print Layout
- * sheets, drawn only while near the rail's viewport, so large documents stay cheap. Pagination
- * comes from the approximate layout engine, so the rail says so rather than implying Word parity.
- */
-declare class PageNavigator {
-    private readonly host;
-    readonly element: HTMLElement;
-    private readonly heading;
-    private readonly closeButton;
-    private readonly message;
-    private readonly list;
-    private thumbs;
-    private observer?;
-    private open;
-    private built;
-    private marked;
-    private labels;
-    private state;
-    constructor(host: PageNavigatorHost);
-    get isOpen(): boolean;
-    get pageCount(): number;
-    /** The 1-based page currently marked, or 0 when no thumbnails exist. */
-    get currentPage(): number;
-    setOpen(open: boolean): void;
-    /** Called after every layout, scroll and locale change; cheap when nothing moved. */
-    sync(state: PageNavigatorState): void;
-    private render;
-    private relabelChrome;
-    private relabelThumbs;
-    private clear;
-    private rebuild;
-    private createThumb;
-    private draw;
-    private hasFocus;
-    /** Highlights `page` and, unless focus is inside the rail, makes it the tab stop and scrolls to it. */
-    private mark;
-    private setStop;
-    /** Scrolls only the rail's own list, never an ancestor (`scrollIntoView` would move the page). */
-    private reveal;
-    private indexOf;
-    private onKey;
-}
-
-interface HeadingNavigatorHost {
-    model(): DocumentModel;
-    view(): EditorView | undefined;
-    goTo(blockId: string): void;
-    close(): void;
-}
-/** Body headings in document order; shared TOC style resolution handles inherited heading styles. */
-declare class HeadingNavigator {
-    private readonly host;
-    readonly element: HTMLElement;
-    private readonly title;
-    private readonly closeButton;
-    private readonly tree;
-    private readonly empty;
-    private readonly collapsed;
-    private signature;
-    private locale;
-    private entries;
-    private selected;
-    constructor(host: HeadingNavigatorHost);
-    get isOpen(): boolean;
-    setOpen(open: boolean): void;
-    sync(locale: EditorLocale): void;
-    private rebuild;
-    private items;
-    private toggle;
-    private updateVisibility;
-    private mark;
-    private onKey;
-}
-
-/**
- * The English control labels `hiddenActions` accepted before ids existed. Deprecated: accepted for
- * one more release, mapped to ids, and reported through a `document-warning` event.
- */
-type LegacyRibbonLabel = 'Font family' | 'Font size' | 'Bold' | 'Italic' | 'Underline' | 'Strikethrough' | 'Superscript' | 'Subscript' | 'Font color' | 'Text highlight' | 'Clear formatting' | 'Decrease indent' | 'Increase indent' | 'Spacing after' | 'Spacing before' | 'Line spacing' | 'Bulleted list' | 'Numbered list' | 'Decrease list level' | 'Increase list level' | 'Remove list' | 'Align left' | 'Align center' | 'Align right' | 'Justify' | 'Find and replace' | 'Insert table' | 'Insert picture' | 'Format picture' | 'Insert link' | 'Insert page break' | 'Insert column break' | 'Margins' | 'Orientation' | 'Vertical alignment' | 'Columns' | 'Page number format' | 'Page numbering' | 'Different first page' | 'Different odd and even pages' | 'Next page section break' | 'Continuous section break' | 'Even page section break' | 'Odd page section break' | 'Insert table of contents' | 'Update table of contents' | 'Update fields' | 'Insert table of figures' | 'Insert footnote' | 'Insert endnote' | 'Paragraph direction' | 'Text language' | 'Custom text language tag' | 'East Asian language' | 'Custom east asian language tag' | 'Complex script language' | 'Custom complex script language tag' | 'Run direction' | 'Track changes' | 'Display for review' | 'Previous change' | 'Next change' | 'Accept' | 'Reject' | 'Accept all' | 'Reject all' | 'Add comment' | 'Comments' | 'Show hidden text' | 'Page thumbnails' | 'Zoom' | 'Layout view' | 'Print' | 'Insert row above' | 'Insert row below' | 'Delete row' | 'Insert column left' | 'Insert column right' | 'Delete column' | 'Delete table';
-
-/**
- * Stable, locale-independent ids of every ribbon control. `hiddenActions` is keyed on these ids;
- * the English labels below are only the keys the localizer uses to find a control's display text.
- * `element-api.test.ts` fails when a control is added to or removed from the ribbon without
- * updating this list.
- */
-declare const RIBBON_ACTION_IDS: readonly ["paste", "delete-comment", "previous-comment", "next-comment", "insert-caption", "cross-reference", "ruler", "page-setup-dialog", "cover-page", "bookmark", "sort", "find-options", "select-options", "add-text", "blank-page", "read-aloud", "gridlines", "navigation-pane", "shading", "borders", "header", "footer", "page-number", "header-footer-link", "header-footer-close", "header-footer-go-header", "header-footer-go-footer", "header-footer-previous", "header-footer-next", "header-from-top", "footer-from-bottom", "page-size", "font-dialog", "paragraph-dialog", "indent-left", "indent-right", "zoom-actual-size", "multiple-pages", "page-width", "one-page", "word-count", "spelling", "symbol", "date-and-time", "line-numbers", "multilevel-list", "drop-cap", "change-case", "format-painter", "show-paragraph-marks", "select-all", "replace", "cut", "copy", "grow-font", "shrink-font", "font-family", "font-size", "bold", "italic", "underline", "strikethrough", "superscript", "subscript", "font-color", "text-highlight", "clear-formatting", "decrease-indent", "increase-indent", "spacing-after", "spacing-before", "line-spacing", "bulleted-list", "numbered-list", "decrease-list-level", "increase-list-level", "remove-list", "align-left", "align-center", "align-right", "justify", "find-and-replace", "insert-table", "insert-picture", "format-picture", "insert-link", "insert-page-break", "insert-column-break", "margins", "orientation", "vertical-alignment", "columns", "page-color", "text-box", "page-borders", "watermark", "hyphenation", "page-number-format", "page-numbering", "different-first-page", "different-odd-and-even-pages", "next-page-section-break", "continuous-section-break", "even-page-section-break", "odd-page-section-break", "insert-table-of-contents", "update-table-of-contents", "update-fields", "insert-table-of-figures", "insert-footnote", "insert-endnote", "paragraph-direction", "text-language", "custom-text-language-tag", "east-asian-language", "custom-east-asian-language-tag", "complex-script-language", "custom-complex-script-language-tag", "run-direction", "track-changes", "display-for-review", "previous-change", "next-change", "accept", "reject", "accept-all", "reject-all", "add-comment", "comments", "show-hidden-text", "page-thumbnails", "zoom", "zoom-dialog", "layout-view", "print", "insert-row-above", "insert-row-below", "delete-row", "insert-column-left", "insert-column-right", "delete-column", "delete-table", "table-properties"];
-type RibbonActionId = (typeof RIBBON_ACTION_IDS)[number];
-/** English control label of each action, the lookup key into the locale strings. Display-only. */
-declare const RIBBON_ACTION_LABELS: Readonly<Record<RibbonActionId, string>>;
-
-/** A value `hiddenActions` accepts: a stable id, or (deprecated) the old English label. */
-type RibbonActionInput = RibbonActionId | LegacyRibbonLabel;
-declare function isRibbonActionId(value: string): value is RibbonActionId;
-/**
- * Maps `hiddenActions` input to ids. Deprecated English labels are converted and listed in
- * `legacy`; unknown values are dropped, matching how the ribbon ignored them before.
- */
-declare function normalizeRibbonActions(input: readonly string[]): {
-    ids: RibbonActionId[];
-    legacy: string[];
-};
-
-/** Host-controlled UI customisation; each value maps to one element property and attribute. */
-declare class ViewOptions {
-    showThumbnails: boolean;
-    showToolbar: boolean;
-    hiddenActions: readonly RibbonActionId[];
-}
-
-type LoadedDocument = Awaited<ReturnType<typeof loadDocument>>;
-/** DOM pieces created by the shell once the element connects. */
-interface ShellParts {
-    toolbar?: HTMLElement;
-    canvas?: HTMLElement;
-    paper?: HTMLElement;
-    searchPanel?: SearchPanelHandle;
-    review?: ReviewController;
-    chrome?: EditorChrome;
-    printLayout?: PrintLayoutController;
-    navigator?: PageNavigator;
-    headings?: HeadingNavigator;
-}
-/**
- * Mutable editor state and the controllers that share it. `<docx-editor>` is a thin facade over
- * this object; the shell, render, ribbon and chrome modules take it instead of reaching into the
- * element's private fields.
- */
-declare class EditorCore {
-    readonly element: HTMLElement;
-    model: DocumentModel;
-    view?: EditorView | undefined;
-    loaded?: LoadedDocument | undefined;
-    loadGeneration: number;
-    readOnly: boolean;
-    locale: EditorLocale;
-    reviewAuthor: string;
-    theme: EditorThemeMode;
-    themeColors?: Partial<EditorTheme> | undefined;
-    appliedThemeVars: string[];
-    reviewDisplayMode: ReviewDisplayMode;
-    detachedState?: EditorState | undefined;
-    pendingFileName?: string;
-    readonly shell: ShellParts;
-    readonly collab: CollaborationSession;
-    readonly inserts: InsertController;
-    readonly formatDialogs: FormatDialogs;
-    readonly imageMedia: ImageMediaCache;
-    readonly host: EditorHost;
-    readonly parts: PartsController;
-    readonly pages: PageController;
-    readonly viewOptions: ViewOptions;
-    readonly dirtyState: DirtyState;
-    readonly pageTracker: PageTracker;
-    constructor(element: HTMLElement);
-    contentWidth(): number;
-    /** The ribbon acts on an open header/footer/note editor, otherwise on the main text. */
-    targetView(): EditorView | undefined;
-    notifyChange(): void;
-    markEditedOutsideBody(): void;
-    scheduleCollaborationSend(): void;
-    pendingCollaboration(): StepBatch | null;
-    applyTransaction(transaction: Transaction, remote?: boolean): void;
-    refreshControls(): void;
-}
-
-declare const HTMLElementBase: typeof HTMLElement;
-/**
- * Save, dirty-tracking and UI-customisation surface of `<docx-editor>`. It only reads and writes
- * the shared `EditorCore`, so the element class stays a thin lifecycle facade.
- */
-declare abstract class DocxEditorApi extends HTMLElementBase {
-    protected abstract readonly core: EditorCore;
-    abstract fileName: string;
-    /** Shows the left rail of page thumbnails. Needs Print Layout; reflected to `show-thumbnails`. */
-    get showThumbnails(): boolean;
-    set showThumbnails(value: boolean);
-    /** Hides the ribbon (the title bar and status bar stay). Default true; `show-toolbar="false"`. */
-    get showToolbar(): boolean;
-    set showToolbar(value: boolean);
-    /**
-     * Ribbon controls to hide, by stable id (`RIBBON_ACTION_IDS`, e.g. `'bold'`). Unknown ids are
-     * ignored. The old English labels (`'Bold'`) are still accepted for one release: they are mapped
-     * to ids and reported through a `document-warning` event. Reading returns ids only.
-     */
-    get hiddenActions(): readonly RibbonActionId[];
-    set hiddenActions(value: readonly RibbonActionInput[]);
-    /** True after an edit until the document is saved through File > Save, `download()`, loaded or `markClean()`. */
-    get dirty(): boolean;
-    /** Declares the current content saved, for hosts that persist the result of `save()` themselves. */
-    markClean(): void;
-    /** Serialized document bytes: the loaded package's own writer, else a fresh DOCX from the model. */
-    saveBytes(): Promise<Uint8Array>;
-    /** The saved document as a Blob. Does not change `dirty`; call `markClean()` after persisting it. */
-    save(): Promise<Blob>;
-    /** Saves and starts a browser download, then marks the document clean. */
-    download(fileName?: string): Promise<void>;
-}
-
-/** Every CustomEvent the `<docx-editor>` element (and its controllers) dispatches, with its detail. */
-interface DocxEditorEventMap {
-    /** The document changed through editing, review actions or edits outside the main surface. */
-    'document-change': CustomEvent<DocumentModel>;
-    /** Loading, saving, printing or an edit failed. */
-    'document-error': CustomEvent<Error>;
-    /** Non-fatal notice, for example that a print layout could not be produced faithfully. */
-    'document-warning': CustomEvent<string>;
-    /** The user toggled read-only from the editor chrome. */
-    'readonly-change': CustomEvent<boolean>;
-    /** A ribbon control was activated. Bubbles from inside the shadow tree. */
-    'ribbon-action': CustomEvent<RibbonAction>;
-    /** The user changed which ribbon commands are shown (File > Customize Ribbon); persist the ids if you want them kept. */
-    'ribbon-customize': CustomEvent<readonly string[]>;
-    /** Cancelable: call `preventDefault()` to handle a File command (open/save/…) yourself. */
-    'file-command': CustomEvent<FileCommandDetail>;
-    /** Print Layout's current page or page count changed (approximate pagination, not Word's). */
-    'page-change': CustomEvent<PageChangeDetail>;
-    /** Unsaved-changes state flipped: true after an edit, false after save, load or `markClean()`. */
-    'dirty-change': CustomEvent<boolean>;
-    /** Local presence changed; transport it to other clients. */
-    'presence-send': CustomEvent<PresenceMessage>;
-    /** Local steps are pending; transport the batch to the collaboration authority. */
-    'collaboration-send': CustomEvent<StepBatch>;
-}
-type DocxEditorEventName = keyof DocxEditorEventMap;
-/** Detail payload type of the named event. */
-type DocxEditorEventDetail<K extends DocxEditorEventName> = DocxEditorEventMap[K] extends CustomEvent<infer D> ? D : never;
-/** Runtime list of every event name; the `satisfies` check keeps it a subset of the map. */
-declare const DOCX_EDITOR_EVENTS: readonly ["document-change", "document-error", "document-warning", "readonly-change", "ribbon-action", "ribbon-customize", "file-command", "page-change", "dirty-change", "presence-send", "collaboration-send"];
-
-/**
- * Typed event overloads. Redeclaring the methods hides the inherited ones, so the standard DOM
- * event map and the string fallback are repeated here.
- */
-interface DocxEditorElement {
-    addEventListener<K extends keyof DocxEditorEventMap>(type: K, listener: (this: DocxEditorElement, event: DocxEditorEventMap[K]) => unknown, options?: boolean | AddEventListenerOptions): void;
-    addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: DocxEditorElement, event: HTMLElementEventMap[K]) => unknown, options?: boolean | AddEventListenerOptions): void;
-    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
-    removeEventListener<K extends keyof DocxEditorEventMap>(type: K, listener: (this: DocxEditorElement, event: DocxEditorEventMap[K]) => unknown, options?: boolean | EventListenerOptions): void;
-    removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: DocxEditorElement, event: HTMLElementEventMap[K]) => unknown, options?: boolean | EventListenerOptions): void;
-    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
-}
-declare class DocxEditorElement extends DocxEditorApi {
-    /** Attributes mirrored to the `locale`, `readOnly`, `fileName`, `reviewAuthor` and `theme` properties. */
-    static get observedAttributes(): string[];
-    protected readonly core: EditorCore;
-    private readonly shellApi;
-    /** Internal seams that in-repo tests reach for; not public API. */
-    private get view();
-    private get inserts();
-    attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
-    get reviewAuthor(): string;
-    set reviewAuthor(value: string);
-    /** File name shown in the title bar and used for downloads from the built-in File commands. */
-    get fileName(): string;
-    set fileName(value: string);
-    /** `light`, `dark`, or `auto` (default, follows the OS). Reflected to the `theme` attribute. */
-    get theme(): EditorThemeMode;
-    set theme(value: EditorThemeMode);
-    /** Token overrides applied as inline `--dve-*` custom properties on the host. */
-    get themeColors(): Partial<EditorTheme> | undefined;
-    set themeColors(value: Partial<EditorTheme> | undefined);
-    get locale(): string;
-    set locale(value: string);
-    publishPresence(profile: {
-        name: string;
-        color: string;
-    }): PresenceMessage | null;
-    receivePresence(message: unknown): "invalid" | "duplicate" | "wrong-session" | "stale" | "out-of-order" | "applied";
-    leavePresence(): PresenceMessage | null;
-    get documentModel(): DocumentModel | null;
-    set documentModel(value: DocumentModel | null);
-    get readOnly(): boolean;
-    set readOnly(value: boolean);
-    connectedCallback(): void;
-    disconnectedCallback(): void;
-    load(input: Uint8Array | ArrayBuffer): Promise<void>;
-    setLoadedDocument(session: LoadedDocument): void;
-    /** Join only after loading the authority's matching document snapshot and version. */
-    startCollaboration(config: CollaborationConfig): void;
-    getPendingCollaboration(): StepBatch | null;
-    receiveCollaboration(batch: unknown): ClientReceiveResult['status'];
-    /** Stopping with pending edits requires an explicit discard of the transport queue. */
-    stopCollaboration(discardPending?: boolean): void;
-    private assertDocumentReplaceable;
-    /** Swaps in a new model (and the session that produced it) and invalidates in-flight loads. */
-    private replaceDocument;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        'docx-editor': DocxEditorElement;
-    }
-}
-declare function registerDocxEditor(): void;
-
-/**
- * Attribute <-> property mapping for `<docx-editor>`. Properties stay the source of truth: an
- * attribute change is applied through the property setter only when it would change the value, and
- * a property change is written back to its attribute only when the attribute would differ. That
- * makes each direction idempotent, so the two cannot ping-pong.
- */
-declare const DOCX_EDITOR_ATTRIBUTES: readonly ["locale", "read-only", "file-name", "review-author", "theme", "show-thumbnails", "show-toolbar"];
-type DocxEditorAttribute = (typeof DOCX_EDITOR_ATTRIBUTES)[number];
-
-/** Build a reference authority using exactly the shared editor's document schema. */
-declare function createCollaborationAuthority(model: DocumentModel, options: Omit<CollaborationAuthorityConfig, 'doc'>): CollaborationAuthority;
-
-/** Generates collision-resistant document IDs within one unique client session. */
-declare function createCollaborationIdGenerator(clientId: string): (kind: string) => string;
-/** Repairs missing or duplicate block IDs on local transactions. */
-declare function repairCollaborativeDocumentIds(state: EditorState, clientId: string, idGenerator?: (kind: string) => string): Transaction | null;
-
-interface RevisionRange {
-    id: string;
-    kind: 'insert' | 'delete';
-    from: number;
-    to: number;
-    author: string;
-    /** The move this range is one side of; both sides are accepted or rejected together. */
-    move?: string;
-}
-
-declare const WordEditor: vue.DefineComponent<vue.ExtractPropTypes<{
-    documentModel: PropType<DocumentModel>;
-    readOnly: BooleanConstructor;
-    locale: StringConstructor;
-    theme: PropType<EditorThemeMode>;
-    showThumbnails: BooleanConstructor;
-    showToolbar: {
-        type: BooleanConstructor;
-        default: boolean;
-    };
-    hiddenActions: PropType<readonly RibbonActionInput[]>;
-}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
-    [key: string]: any;
-}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("document-change" | "document-error" | "page-change" | "dirty-change")[], "document-change" | "document-error" | "page-change" | "dirty-change", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
-    documentModel: PropType<DocumentModel>;
-    readOnly: BooleanConstructor;
-    locale: StringConstructor;
-    theme: PropType<EditorThemeMode>;
-    showThumbnails: BooleanConstructor;
-    showToolbar: {
-        type: BooleanConstructor;
-        default: boolean;
-    };
-    hiddenActions: PropType<readonly RibbonActionInput[]>;
-}>> & Readonly<{
-    "onDocument-change"?: (...args: any[]) => any;
-    "onDocument-error"?: (...args: any[]) => any;
-    "onPage-change"?: (...args: any[]) => any;
-    "onDirty-change"?: (...args: any[]) => any;
-}>, {
-    showThumbnails: boolean;
-    showToolbar: boolean;
-    readOnly: boolean;
-}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
-
-export { CollaborationAuthority, CollaborationClient, DOCX_EDITOR_ATTRIBUTES, DOCX_EDITOR_EVENTS, DocxEditorElement, EDITOR_LOCALES, PRESENCE_PALETTE, PresenceClient, RIBBON_ACTION_IDS, RIBBON_ACTION_LABELS, WordEditor, createCollaborationAuthority, createCollaborationIdGenerator, darkTheme, isRibbonActionId, lightTheme, normalizeEditorLocale, normalizeRibbonActions, registerDocxEditor, repairCollaborativeDocumentIds, themeToCssVars };
-export type { AuthorityResult, ClientReceiveResult, CollaborationAuthorityConfig, CollaborationConfig, DocxEditorAttribute, DocxEditorEventDetail, DocxEditorEventMap, DocxEditorEventName, EditorBinding, EditorEventOptions, EditorHandle, EditorLocale, EditorLocaleInput, EditorOptions, EditorProps, EditorTheme, EditorThemeMode, FileCommand, FileCommandDetail, LegacyRibbonLabel, PageChangeDetail, PresenceConfig, PresenceMessage, PresenceReceiveResult, ReviewDisplayMode, RevisionRange, RibbonAction, RibbonActionId, RibbonActionInput, StepBatch };
+export { WordEditor };
+export type { EditorBinding, EditorEventOptions, EditorHandle, EditorOptions, EditorProps };