@docx-editor.dev/core 2.30.0 → 2.32.0

package/dist/{editor-DaEJd2so.d.ts → editor-DZwOTmlR.d.ts}

@@ -1,139 +1,14 @@
-import { q as ResolvedRevisionMarkup, a as ReviewDisplayMode } from './semantic-records-CjcF26ZL.js';
-import { t as DocAnchor, g as ReviewRevisionKind, c as ReviewCommentItem, b as ReviewRevisionItem, d as ReviewCustomItem, aJ as SourceCrop, Y as DrawingKind, a1 as ImageWrapTarget, _ as DrawingPositionInput, Z as DrawingLocks, r as ColorValue, x as ExecErrorCode, a5 as ParagraphFormatCommand, af as Watermark, E as ExecResult, n as ContentControlFilter, o as DocRange, k as RunFormatting, p as Revision, a7 as Rect, ab as SelectionPin, ae as Unsubscribe } from './types-barrel-CA0xB8kH.js';
-import { H as HistoryDiagnostic, V as ViewScope, b as HistoryGroup, a as EditorExecOptions, E as EditorScope } from './editor-scope-7o9xweiJ.js';
+import { d as ResolvedRevisionMarkup, a as ReviewDisplayMode } from './revision-projection-Cn6rZJ7H.js';
+import { ResolvedReviewPane } from './contracts/types.js';
+import { V as ViewScope, b as HistoryDiagnostic, c as HistoryGroup, a as EditorExecOptions, E as EditorScope, d as HistoryGroupOptions } from './editor-scope-B3L-1ALc.js';
+import { E as EditorFontErrorCode, a as FontFaceRequest } from './editor-fonts-D_-vjuJi.js';
+import { t as DocAnchor, g as ReviewRevisionKind, c as ReviewCommentItem, b as ReviewRevisionItem, d as ReviewCustomItem, aT as SourceCrop, a8 as DrawingKind, ag as ImageWrapTarget, aa as DrawingPositionInput, a9 as DrawingLocks, af as ImageResourceState, r as ColorValue, x as ExecErrorCode, ah as ParagraphFormatCommand, an as SupportedImageMime, ar as Watermark, E as ExecResult, at as WatermarkState, n as ContentControlFilter, o as DocRange, k as RunFormatting, p as Revision, ak as Rect, am as SelectionPin, ao as Unsubscribe } from './tree-op-types-C_S2niXW.js';
+import { C as CollaborationDiagnosticCode, c as CustomNodeDiagnosticCode, D as DiagnosticErrorName, F as FailureStage, B as ByteSizeBucket, b as CountBucket, f as DocumentOpenDiagnosticCode, a as DocumentPartKind, g as DocumentSaveDiagnosticCode, E as EditDiagnosticCode, j as ReviewDiagnosticCode, k as ReviewOperation, R as ReviewChangeKind, i as FormattingChangeKind, h as FontDiagnosticCode, H as HistoryDiagnosticCode, P as PerformanceDiagnosticCode } from './diagnostic-hints-DK8-V0fk.js';
 import { DocEdits, DocQueries, DocQueryResults, ContentControlSummary } from './contracts/document.js';
 import { InteractionOutcome } from './contracts/interaction.js';
-import { a as SemanticSelection, S as SemanticPosition } from './semantic-interaction-Dc3pf3hr.js';
-import { I as ImageResourceState, S as SupportedImageMime } from './image-resources-Bipz8toD.js';
-import { a as DocumentProtectionState } from './document-protection-8eyMWIJ0.js';
-import { C as CollaborationStatus } from './failure-NS2lsya4.js';
-import { C as CollaborationDiagnosticCode, c as CustomNodeDiagnosticCode, D as DiagnosticErrorName, F as FailureStage, B as ByteSizeBucket, b as CountBucket, f as DocumentOpenDiagnosticCode, a as DocumentPartKind, g as DocumentSaveDiagnosticCode, E as EditDiagnosticCode, j as ReviewDiagnosticCode, k as ReviewOperation, R as ReviewChangeKind, i as FormattingChangeKind, h as FontDiagnosticCode, H as HistoryDiagnosticCode, P as PerformanceDiagnosticCode } from './diagnostic-hints-2Bke6H_w.js';
-
-/**
- * When the review pane opens by itself.
- *
- * - `'auto'`: the pane opens when a document with review items loads, and when a tracked
- *   change is made while it is closed, in both cases when the pane has items to list. With
- *   `revisionsIn: 'balloons'` the pane lists no tracked change and no reply to one, so
- *   tracked changes and their replies alone do not open it.
- * - `'manual'`: the pane stays closed until the host or the user opens it. Use it when the
- *   host shows review items its own way, such as in balloons or margin markers.
- *
- * @public
- */
-type ReviewPaneOpening = 'auto' | 'manual';
-/**
- * What the open review pane does when its full card column does not fit beside the page at
- * the page's zoom.
- *
- * - `'float'`: the pane shrinks to a strip of markers, and the open card floats over the
- *   page.
- * - `'shrinkPage'`: under a fit zoom mode, the page may shrink down to the mode's
- *   `minZoom` (or 10%) so that the full column fits. The pane changes to the marker strip
- *   only when the column does not fit at that floor either. A fixed zoom behaves as
- *   `'float'`.
- * - `'scroll'`: the page keeps the size it has beside the closed pane's marker strip, and
- *   the full column stands beside it. The document and the column scroll together: the
- *   viewport scrolls sideways to reach the cards.
- *
- * The setting applies to the review pane only. The navigation pane stays docked at its side
- * in every mode: it never scrolls with the document, and it takes its room beside the page
- * exactly as it does with no review pane.
- *
- * @public
- */
-type ReviewPaneOverflow = 'float' | 'shrinkPage' | 'scroll';
-/**
- * Where tracked changes open.
- *
- * - `'pane'`: the review pane lists tracked changes as cards beside the comments.
- * - `'balloons'`: the pane lists comments only, except comments that reply to a tracked
- *   change: the change's balloon shows those. A tracked change opens in a balloon at its
- *   text when the reader clicks it, or when Next Change, Previous Change, or
- *   `setActiveReviewItem(key, { announce: true })` reaches it.
- *
- * @public
- */
-type RevisionDisplay = 'pane' | 'balloons';
-/**
- * How a collapsed comment marker looks.
- *
- * - `'initials'`: a badge with the thread author's initials in the author's color, a reply
- *   count, and a check mark when the thread is resolved.
- * - `'icon'`: the comment icon.
- *
- * @public
- */
-type CommentMarkerStyle = 'initials' | 'icon';
-/**
- * Review pane settings to change. Every field is optional, and an omitted field keeps its
- * current value.
- *
- * @public
- */
-interface ReviewPaneOptions {
-    /** Default `'auto'`. */
-    readonly opening?: ReviewPaneOpening;
-    /** Default `'float'`. */
-    readonly overflow?: ReviewPaneOverflow;
-    /** Default `'pane'`. */
-    readonly revisionsIn?: RevisionDisplay;
-    /** Default `'icon'`. */
-    readonly commentMarkers?: CommentMarkerStyle;
-}
-/**
- * The review pane settings in force, with every field resolved.
- *
- * @public
- */
-interface ResolvedReviewPane {
-    /** When the pane opens by itself. */
-    readonly opening: ReviewPaneOpening;
-    /** What the open pane does when its card column does not fit beside the page. */
-    readonly overflow: ReviewPaneOverflow;
-    /** Where tracked changes open. */
-    readonly revisionsIn: RevisionDisplay;
-    /** How a collapsed comment marker looks. */
-    readonly commentMarkers: CommentMarkerStyle;
-}
-/** The settings an editor starts with when nothing sets them. @public */
-declare const DEFAULT_REVIEW_PANE: ResolvedReviewPane;
-/**
- * Merge `options` over `base`. Throws a `TypeError` for an unknown field or value, so a
- * misspelled setting fails loudly instead of being ignored. Returns `base` itself when
- * nothing changes, so the snapshot keeps its reference.
- *
- * @public
- */
-declare function resolveReviewPane(options: ReviewPaneOptions | undefined, base?: ResolvedReviewPane): ResolvedReviewPane;
-/**
- * The fields of a review item that decide whether the review pane lists it. A
- * `ReviewItem` and a review item placement both have them.
- *
- * @public
- */
-interface ReviewPaneItemFields {
-    /** The item kind, as `ReviewItem.kind` gives it. */
-    readonly kind: 'revision' | 'comment' | 'custom';
-    /** For a comment, the tracked change it replies to. */
-    readonly parentRevisionId?: string;
-}
-/**
- * Whether the review pane lists a card for `item` under `revisionsIn`.
- *
- * With `'balloons'`, a balloon at the text shows every tracked change and every comment
- * that replies to a tracked change, so the pane lists neither. Give the item as an
- * unfiltered `getReviewItems()` read returns it: a query that excludes revision kinds
- * removes `parentRevisionId` from replies to the changes it drops.
- *
- * The engine applies this rule to every review item when it decides whether the pane opens
- * by itself or closes after a settings change. A review pane must apply the same rule before
- * its own filters, such as a hidden kind or a host filter. Those filters can hide every card,
- * and then the pane that the engine opens is empty.
- *
- * @public
- */
-declare function reviewPaneListsItem(revisionsIn: RevisionDisplay, item: ReviewPaneItemFields): boolean;
+import { a as SemanticSelection, S as SemanticPosition } from './semantic-interaction-CJoHLoOl.js';
+import { a as DocumentProtectionState } from './document-protection-NaniLHWF.js';
+import { a as CollaborationStatus } from './failure-6KGFrDO9.js';
 
 /**
  * What a fit mode fits the page to.
@@ -167,6 +42,52 @@ type ZoomMode = {
     readonly maxZoom?: number;
 };
 
+/**
+ * One occurrence of a search query in the document.
+ *
+ * Carries TWO addresses on purpose. `blockId` + `start` is the engine's own: stable
+ * across edits and independent of ordering. `paragraphIndex` + `runIndex` + `runOffset`
+ * is the positional one a find/replace UI needs to show and navigate results, and it is
+ * derived from the same walk rather than left to the caller to reconstruct — a caller
+ * guessing at run boundaries would send the selection to the wrong place.
+ *
+ * A match can span runs when formatting changes mid-word; the run address is where it
+ * STARTS. `scope` identifies a non-body story so navigation opens the correct surface.
+ * A frame scope selects its anchoring drawing and never places a caret inside its story.
+ * A match inside a field result reports the field atom's model range. Its `length` is one,
+ * while `text` carries the visible match and can be longer. Select with `start` and `length`.
+ * Never derive the selected length from `text.length`.
+ */
+interface TextMatch {
+    readonly blockId: string;
+    /** Character offset within the paragraph's concatenated run text. */
+    readonly start: number;
+    readonly length: number;
+    /**
+     * Paragraph ordinal within this match's story. Table and nested-table paragraphs count.
+     * Non-paragraph blocks add no ordinal.
+     */
+    readonly paragraphIndex: number;
+    /** Index of the run the match starts in, and the offset within that run. */
+    readonly runIndex: number;
+    readonly runOffset: number;
+    /** Story containing the match. Absence means the body. */
+    readonly scope?: ViewScope;
+    /** The matched text as it appears in the document. */
+    readonly text: string;
+    /**
+     * Paragraph text immediately before and after the match, bounded at the derivation
+     * boundary. A results list shows the match in its sentence — "…as described in this
+     * **Exhi**bit A" — and nothing else in the contract can reach paragraph text, so a
+     * caller would otherwise have to re-read the document to render one row.
+     *
+     * Optional and additive: an implementation that has not derived them omits them, and a
+     * consumer treats absent as empty.
+     */
+    readonly contextBefore?: string;
+    readonly contextAfter?: string;
+}
+
 /**
  * Anonymous diagnostics: why something failed, as stable codes and bucketed numbers.
  *
@@ -488,7 +409,11 @@ interface EditorEvents {
     revisionMarkupChange: (settings: ResolvedRevisionMarkup) => void;
     /** A document mutation committed, with the ids it touched. */
     change: (change: DocumentChange) => void;
-    /** The selection or its derived formatting moved. */
+    /**
+     * Observable editor state moved without a document change: the selection or its derived
+     * formatting, the armed typing format, the open header or footer, or the collaboration
+     * session's status.
+     */
     selectionChange: (snapshot: EditorSnapshot) => void;
     error: (error: EditorError) => void;
     historyDiagnostic: (diagnostic: HistoryDiagnostic) => void;
@@ -527,7 +452,42 @@ interface EditorEvents {
      * ```
      */
     reviewItemReveal: (event: ReviewItemRevealEvent) => void;
+    /**
+     * The editor's pages are now in another document: it was attached for the first time, moved
+     * into another element or window, detached (`document` is `null`), or found its element
+     * moved to another window by the host. Custom chrome that listens on the editor's document
+     * or measures its window re-binds here.
+     *
+     * @example
+     * ```ts
+     * editor.on('hostChange', ({ document }) => {
+     *   stopShortcuts?.();
+     *   stopShortcuts = document ? listenForShortcuts(document) : undefined;
+     * });
+     * ```
+     */
+    hostChange: (event: EditorHostChange) => void;
+}
+/**
+ * The payload of the `hostChange` event.
+ *
+ * @public
+ */
+interface EditorHostChange {
+    /** The document the pages are mounted in now, or `null` while the editor is detached. */
+    readonly document: EditorHostDocument | null;
 }
+/**
+ * The DOM `Document`, wherever DOM types are loaded (every browser host).
+ *
+ * Read from `globalThis` rather than named, so this contract also compiles in the engine's
+ * DOM-free lanes and on servers, where it falls back to `object`.
+ *
+ * @public
+ */
+type EditorHostDocument = typeof globalThis extends {
+    readonly document: infer D;
+} ? D : object;
 /**
  * The payload of the `reviewItemReveal` event.
  *
@@ -535,17 +495,18 @@ interface EditorEvents {
  */
 interface ReviewItemRevealEvent {
     /**
-     * The key of the review item to open, as `getReviewItems()` without `pairReplacements`
-     * lists it. Next Change and Previous Change step through that unpaired queue, so for a
-     * replacement this is the key of its deletion or its insertion. `setActiveReviewItem`
+     * The key of the review item to open, as `getReviewItems({ pairReplacements: false })`
+     * lists it, so for a replacement this is the key of its deletion or its insertion. Next
+     * Change and Previous Change stop once on a replacement and report its deletion's key,
+     * with the pair's key in {@link ReviewItemRevealEvent.pairKey}. `setActiveReviewItem`
      * reports the key it was given, so a call with a pair's key reports that key here and in
      * {@link ReviewItemRevealEvent.pairKey}.
      */
     readonly key: string;
     /**
-     * The key that `getReviewItems({ pairReplacements: true })` gives the replacement this item
-     * belongs to. Present only when the item is a paired replacement or one half of one. A
-     * host that lists pairs opens `pairKey ?? key`.
+     * The key that `getReviewItems()` gives the replacement this item belongs to, since it
+     * pairs replacements by default. Present only when the item is a paired replacement or one
+     * half of one. A host that reads the default list opens `pairKey ?? key`.
      */
     readonly pairKey?: string;
     /**
@@ -897,7 +858,7 @@ interface EditorReviewHits {
  *
  * Filtering revision kinds is how a host hides structural cards it has no UI for,
  * `placement: false` skips the layout pass entirely when only metadata is wanted, and
- * `pairReplacements` lists a typed-over selection as one decision.
+ * `pairReplacements: false` lists a typed-over selection as its two halves.
  */
 interface ReviewItemQuery {
     /**
@@ -910,8 +871,12 @@ interface ReviewItemQuery {
     /** When false, skip layout geometry; metadata is unchanged and anchors are null. Default true. */
     readonly placement?: boolean;
     /**
-     * When true, list a deletion and the insertion that directly follows it as one
-     * `'replace'` item. Default false.
+     * Whether to list a deletion and the insertion that directly follows it as one
+     * `'replace'` item. Default true. Set it to false to list the deletion and the insertion as
+     * separate items, for example to accept or reject each half on its own.
+     *
+     * A host that steps through the list with `setActiveReviewItem` stops once on
+     * each replacement with the default, as Next Change does.
      *
      * Two revisions pair when they are next to each other among the queue's revisions, the
      * deletion comes first, both have the same author, nesting level and `readOnly` value, and
@@ -931,6 +896,43 @@ interface ReviewItemQuery {
     readonly pairReplacements?: boolean;
 }
 
+/**
+ * The refused-open read model, split out of `editor.ts`.
+ *
+ * Re-exported from `editor.ts`, so consumers keep importing
+ * `@docx-editor.dev/core/contracts/editor`.
+ */
+
+/**
+ * What a person can do about a document that did not open. It groups the open codes so a
+ * host can pick a message without listing every code:
+ *
+ * - `damaged`: the archive or its XML is broken. Saving the file again in a desktop editor
+ *   can repair it.
+ * - `not-docx`: the bytes are not a `.docx` document, or hold no main document.
+ * - `too-large`: the file crosses a size, count or depth limit.
+ * - `blocked`: the file uses XML features that the editor refuses for security.
+ * - `unknown`: any other failure.
+ *
+ * @public
+ */
+type DocumentOpenFailureReason = 'damaged' | 'not-docx' | 'too-large' | 'blocked' | 'unknown';
+/**
+ * A document the editor refused to open. It carries a stable code only, never the file's
+ * content or name, so a host can show it, log it, or send it with a support request.
+ *
+ * Each refusal is a new object, so a host can compare it by reference to tell a second
+ * refusal of the same file from the first.
+ *
+ * @public
+ */
+interface DocumentOpenFailure {
+    /** The stable open code, the same one the `document.open` diagnostic reports. */
+    readonly code: DocumentOpenDiagnosticCode;
+    /** The group of {@link DocumentOpenFailure.code} that picks the message. */
+    readonly reason: DocumentOpenFailureReason;
+}
+
 /**
  * How activating a review item places it in the viewport, and whether it announces the
  * reveal.
@@ -1046,8 +1048,8 @@ interface ReviewRevisionPlacement extends ReviewItemPlacementBase {
     readonly revisionKind: ReviewRevisionKind;
     /**
      * The words a replacement decision removes when {@link revisionKind} is `'replace'`.
-     * The built-in reader lists separate deletion and insertion cards unless the query sets
-     * {@link ReviewItemQuery.pairReplacements}.
+     * The built-in reader lists separate deletion and insertion cards when the query sets
+     * {@link ReviewItemQuery.pairReplacements} to false.
      */
     readonly replacedText?: string;
     readonly item: ReviewRevisionItem;
@@ -1319,7 +1321,8 @@ interface EditorFormatPainterCommands {
      * direct paragraph properties as well.
      *
      * Non-mutating: the capture lives on the editor, not in the document, and it survives
-     * until the next capture or until the editor is detached.
+     * until the next capture, a document load, or `destroy()`, including across a `detach()`
+     * and a later `attach()`.
      */
     copyFormatting: Record<never, never>;
     /**
@@ -1450,6 +1453,110 @@ interface SelectedImageState {
  */
 type ImageContext = SelectedImageState;
 
+/**
+ * Which kind of story a bookmark is in: the main text, a header or footer, or a note.
+ *
+ * @public
+ */
+type BookmarkStory = 'body' | 'headerFooter' | 'note';
+/**
+ * Where a bookmark is, finer than {@link BookmarkStory}: the main text, a header, a footer, a
+ * footnote or an endnote.
+ *
+ * @public
+ */
+type BookmarkPlace = 'body' | 'header' | 'footer' | 'footnote' | 'endnote';
+/**
+ * One bookmark, as the `bookmarks` query lists it.
+ *
+ * @public
+ */
+interface BookmarkSummary {
+    /** The name as the document writes it. Names compare without case. */
+    readonly name: string;
+    /** Whether the name starts with an underscore. Hidden bookmarks mark application targets. */
+    readonly hidden: boolean;
+    /** The story the bookmark starts in. */
+    readonly story: BookmarkStory;
+    /** The same story, telling a header from a footer and a footnote from an endnote. */
+    readonly place: BookmarkPlace;
+    /**
+     * Position in document order: the main text first, then headers, footers and notes. Sort by
+     * this value to list bookmarks by location.
+     */
+    readonly order: number;
+    /** Whether the bookmark marks a point rather than a range of text. */
+    readonly empty: boolean;
+    /** Whether the start of the selection is inside the bookmark, edges included. */
+    readonly atSelection: boolean;
+    /**
+     * How many other places carry the same name. Usually 0. Collaborators who add one name while
+     * offline can leave copies; the list, Go To and links use this bookmark, the first in
+     * document order. Adding the name again at this bookmark keeps it and removes the copies.
+     */
+    readonly duplicates: number;
+}
+/**
+ * The bookmark commands an editor accepts.
+ *
+ * @public
+ */
+interface EditorBookmarkCommands {
+    /**
+     * Bookmark the selection under `name`, or the caret position when the selection is
+     * collapsed. A bookmark that already has the name, compared without case, moves here, also
+     * from another story, in one undo step. Two collaborators who add one name offline both keep
+     * their bookmark; every replica reads the first in document order until the next write of the
+     * name, which replaces or removes both.
+     * Refused with `invalidArgs` for a name that does not start with a letter, holds a
+     * character other than a letter, a digit or an underscore, or has more than 40 characters.
+     */
+    insertBookmark: {
+        name: string;
+    };
+    /**
+     * Remove the bookmark with this name, compared without case, and any copies of it in other
+     * places. The text stays.
+     */
+    deleteBookmark: {
+        name: string;
+    };
+    /**
+     * Keep the bookmark this name means, the first in document order, and remove its copies, in
+     * one undo step. The selection does not move. Collaborators who add one name while offline
+     * can leave copies; `BookmarkSummary.duplicates` counts them. Refused with `notFound` when no
+     * bookmark has the name, and with `unsupported` when it has no copies.
+     */
+    keepFirstBookmark: {
+        name: string;
+    };
+    /** Select the bookmark's text, or put the caret at a point bookmark, and scroll to it. */
+    goToBookmark: {
+        name: string;
+    };
+    /** Show or hide bracket marks at bookmarks. A view command: the document does not change. */
+    toggleBookmarks: Record<never, never>;
+    /**
+     * Open the host's Go To UI, the Go to tab of `DocxEditor.Navigation`, the request its
+     * shortcut (Ctrl+G, Cmd+Option+G on macOS) sends. Allowed in a read-only document. Refused
+     * with `unsupported` while no host shows one. To jump without UI, run `goToBookmark`.
+     *
+     * `fromShortcut: true` asks as the shortcut does: also refused with `unsupported` when the
+     * Go To UI turned its shortcut off (`GoToChromeHandlers.shortcut`). Chrome that forwards the
+     * chord sends it, and a menu asks `can` with it before it shows the shortcut.
+     */
+    openGoTo: {
+        readonly fromShortcut?: boolean;
+    };
+    /**
+     * Open the Bookmark dialog the host registered, the same request the Insert menu and
+     * Ctrl/Cmd+Shift+F5 send. Allowed in a read-only document, where Go To still works.
+     * Refused with `unsupported` while no host shows a bookmark dialog, for example when the
+     * `bookmark` popup is `false`.
+     */
+    openBookmarkDialog: Record<never, never>;
+}
+
 /** Where the caret sits inside a table: its shape and current cell. */
 interface TableContext {
     readonly rows: number;
@@ -1550,57 +1657,6 @@ interface DocumentHandle {
  * where a new array per render rebuilds the editor per render.
  */
 type DocumentSource = ArrayBuffer | Uint8Array | DocumentHandle | 'blank';
-/** A concrete font face requested by authored document content. */
-interface FontFaceRequest {
-    readonly family: string;
-    readonly weight: number;
-    readonly style: 'normal' | 'italic';
-}
-/** Immutable, byte-backed font face supplied to layout and browser paint. */
-interface FontSource {
-    readonly request: FontFaceRequest;
-    readonly id: string;
-    readonly bytes: Uint8Array;
-    readonly hash: string;
-    readonly faceIndex: number;
-    readonly availability?: 'available' | 'forbidden';
-}
-/** An explicit authored-font substitution. No implicit platform fallback is performed. */
-interface FontSourceSubstitution {
-    readonly from: FontFaceRequest;
-    readonly to: FontFaceRequest;
-    /** Word line-box metrics for the requested face, expressed as em ratios. */
-    readonly lineMetrics?: {
-        readonly heightEm: number;
-        readonly baselineEm: number;
-    };
-}
-/**
- * Public font source configuration sampled when an adapter mounts. It must be immutable for that
- * editor lifetime; remount the adapter to replace bytes or substitutions atomically.
- */
-interface FontConfiguration {
-    /** Selectable provider families, independent of loaded bytes. Listing them performs no fetch. */
-    readonly supportedFamilies?: readonly string[];
-    readonly epoch: number;
-    readonly maxFontBytes: number;
-    readonly sources: readonly FontSource[];
-    readonly substitutions?: readonly FontSourceSubstitution[];
-    readonly defaultFont: {
-        readonly family: string;
-        readonly sizeHalfPoints: number;
-    };
-    readonly language?: string;
-}
-/**
- * Why a font was not admitted.
- *
- * Distinguished rather than collapsed because the responses differ: `overLimit` and `malformed`
- * are the caller's own bytes, while `forbidden` and `hashMismatch` mean the source was not what
- * it claimed and the load should not be retried. `wasmUnavailable` alone is a HOST fault — the
- * shaper's WASM never loaded, `diagnostic` carries the remedy — surface it as a setup error.
- */
-type EditorFontErrorCode = 'initializationFailed' | 'wasmUnavailable' | 'missing' | 'forbidden' | 'overLimit' | 'malformed' | 'hashMismatch' | 'metadataMismatch' | 'fontFaceLoadFailed' | 'unsupportedFaceIndex' | 'missingFont' | 'hashInvalid' | 'fontMismatch' | 'unsupportedFace' | 'loadFailed';
 /** Typed adapter error reported both through `onFontError` and accessible alert UI. */
 declare class EditorFontError extends Error {
     readonly name: string;
@@ -1682,6 +1738,11 @@ interface Editor extends EditorAnchorNavigation, EditorHighlights, EditorReviewH
      * Serialize the current document, finalizing pending text form values first.
      * Invalid input rejects with `EditorError.code === 'invalidArgs'` and remains editable.
      * Validation does not open a dialog. Other write refusals also reject the save.
+     *
+     * The bytes describe the document as it was when you called `save()`. The file is written
+     * in short tasks, so input stays responsive while a long document saves, and edits made
+     * meanwhile belong to the next save. Paragraphs and table rows unchanged since an earlier
+     * save are not written again, so autosave after a small edit stays cheap.
      */
     save(): Promise<ArrayBuffer>;
     getDocumentHandle(): DocumentHandle;
@@ -1789,6 +1850,13 @@ interface Editor extends EditorAnchorNavigation, EditorHighlights, EditorReviewH
      * The search narrows to the body and its selectable text boxes when other stories cannot open.
      * This includes viewing mode and surfaces without header, footer, or note entry methods.
      * Text boxes in footnotes and endnotes remain excluded until their drawings are selectable.
+     *
+     * Pass a match to `exec({ type: 'replaceMatch', match, text })` to replace it, which records a
+     * tracked replacement in suggesting mode, or to {@link selectMatch} and then
+     * {@link addComment} to comment on it. For headless or server use, see `body.search` in
+     * `@docx-editor.dev/editor-api`.
+     *
+     * @see {@link https://www.docx-editor.dev/docs/2.x/recipes/tracked-replacement | Replace as a tracked change}
      */
     findMatches(query: string, options?: {
         readonly matchCase?: boolean;
@@ -1835,11 +1903,11 @@ interface Editor extends EditorAnchorNavigation, EditorHighlights, EditorReviewH
     setTableInteractionLabel(resolver: (key: 'table.insertRowBelow' | 'table.insertColumnRight') => string): void;
     /** Section page setup — size, orientation and margins — for the page-setup dialog. */
     getPageSetup(): PageSetup | null;
-    /** The document watermark, for the watermark dialog. */
-    getWatermark(): {
-        readonly kind: 'text' | 'image';
-        readonly text?: string;
-    } | null;
+    /**
+     * The watermark the document shows, read from the first section's headers; null when it
+     * shows none. For a picture watermark's bytes, use `query({ type: 'watermark' })`.
+     */
+    getWatermark(): WatermarkState | null;
     /** Header/footer editing state: which region is being edited, if any. */
     getHeaderFooterState(): HeaderFooterState | null;
     /** Resolved and authored note properties for the caret section — properties dialog read-model. */
@@ -1932,8 +2000,32 @@ interface Editor extends EditorAnchorNavigation, EditorHighlights, EditorReviewH
      * Anchored to the RETAINED range when there is one, so a compose box that took focus does
      * not lose the words it is about — that is what retention exists for. Refused on a
      * collapsed caret: a comment with no range has nothing to point at, and Word writes none.
+     *
+     * A refused write names its cause, as every review write does: `code: 'locked'` with
+     * `'the document is open for viewing'` in viewing or under read-only protection, and
+     * `code: 'unsupported'` with the external refresh sentence or a collaboration reason token
+     * such as `'collaboration-session-not-ready'` (wait for the session, then retry). Branch on
+     * `diagnosticCodeOfRefusal(result.reason, result.code)`, not on the text.
+     *
+     * Pass `options.historyGroup` to make the comment part of a larger undo step, such as a
+     * review decision that also resolves changes. See {@link HistoryGroupOptions}.
+     *
+     * @example
+     * ```ts
+     * editor.addComment('Counter-proposal: 45 days.', { historyGroup: decision });
+     * editor.addComment('Approved.', 'Legal team', { historyGroup: decision });
+     * ```
+     *
+     * To comment on found text, select it first with {@link findMatches} and
+     * {@link selectMatch}. In a React or Vue host with the review module, `useReview().comment`
+     * calls this. For headless or server use, see `Range.insertComment` in
+     * `@docx-editor.dev/editor-api`.
+     *
+     * @see {@link https://www.docx-editor.dev/docs/2.x/recipes/comment-on-found-text | Comment on found text}
      */
-    addComment(text: string, author?: string): ExecResult;
+    addComment(text: string, options?: HistoryGroupOptions): ExecResult;
+    /** {@link addComment} with an author for this call, overriding the configured author. */
+    addComment(text: string, author?: string, options?: HistoryGroupOptions): ExecResult;
     /**
      * Where a comment on the current selection would sit, in the same space as
      * {@link ReviewItemPlacement.anchorY}, or null when nothing is selected.
@@ -1957,6 +2049,11 @@ interface Editor extends EditorAnchorNavigation, EditorHighlights, EditorReviewH
      * With `options.announce: true`, a call that lands fires `reviewItemReveal` with
      * `source: 'host'`, also when the item was already active, so the packaged review UI opens
      * the item's balloon or card. By default it fires nothing. A `null` key fires nothing.
+     *
+     * Pass `{ reveal: false }` to open the item without scrolling, for a host whose own list
+     * drives the scroll. `useReview().setActive` calls this.
+     *
+     * @see {@link https://www.docx-editor.dev/docs/2.x/recipes/accept-reject-without-scrolling | Accept or reject without scrolling}
      */
     setActiveReviewItem(key: string | null, options?: ReviewActivationOptions): ExecResult;
     /**
@@ -1969,16 +2066,15 @@ interface Editor extends EditorAnchorNavigation, EditorHighlights, EditorReviewH
      * caret that merely lands in a change leaves this `null`. Open a balloon or card for the
      * activated item, and highlight the caret-active one.
      *
-     * Pass the query you read items with, so the key matches theirs: with
-     * `pairReplacements: true`, a paired replacement reports the pair's key; without it, the
-     * key of the half the caret is in. The value changes with the selection, so read it again
-     * on `selectionChange`.
+     * Pass the query you read items with, so the key matches theirs. By default a paired
+     * replacement reports the pair's key; with `pairReplacements: false`, the key of the half
+     * the caret is in. The value changes with the selection, so read it again on
+     * `selectionChange`.
      *
      * @example
      * ```ts
-     * const query = { pairReplacements: true };
      * editor.on('selectionChange', () => {
-     *   const activated = editor.getActivatedReviewItemKey(query);
+     *   const activated = editor.getActivatedReviewItemKey();
      *   if (activated !== null) showMyCard(activated);
      * });
      * ```
@@ -2005,17 +2101,26 @@ interface Editor extends EditorAnchorNavigation, EditorHighlights, EditorReviewH
      *
      * Refused for a card whose kind the engine cannot resolve structurally, which is why
      * `readOnly` is on the item — a surface should not offer the button in the first place.
+     * Other refusals name their cause, as {@link addComment} describes.
+     *
+     * Neither call scrolls. In a React or Vue host with the review module, `useReview().accept`
+     * and `useReview().reject` call these. For headless or server use, see `Revision.accept()`
+     * and `Revision.reject()` in `@docx-editor.dev/editor-api`.
+     *
+     * @see {@link https://www.docx-editor.dev/docs/2.x/recipes/accept-reject-without-scrolling | Accept or reject without scrolling}
      */
-    acceptReviewItem(key: string): ExecResult;
-    rejectReviewItem(key: string): ExecResult;
+    acceptReviewItem(key: string, options?: HistoryGroupOptions): ExecResult;
+    /** The rejecting half of {@link acceptReviewItem}, with the same rules and options. */
+    rejectReviewItem(key: string, options?: HistoryGroupOptions): ExecResult;
     /**
      * Resolve or reopen the comment thread behind a review card.
      *
      * The thread state is written through the same package transaction as every other comment
      * mutation, so `commentsExtended.xml`, Undo and save/reopen cannot disagree. Repeating the
-     * state already on the item succeeds without adding an undo entry.
+     * state already on the item succeeds without adding an undo entry. A refusal names its cause,
+     * as {@link addComment} describes.
      */
-    setCommentResolved(key: string, resolved: boolean): ExecResult;
+    setCommentResolved(key: string, resolved: boolean, options?: HistoryGroupOptions): ExecResult;
     /**
      * Discard the item behind a card: the destructive half of the review verbs.
      *
@@ -2029,9 +2134,10 @@ interface Editor extends EditorAnchorNavigation, EditorHighlights, EditorReviewH
      * a surface can put one "remove this" affordance on every card instead of branching.
      *
      * Refused on a custom node's card, which is informational, and on a revision kind the engine
-     * cannot resolve — the same rule {@link rejectReviewItem} follows.
+     * cannot resolve — the same rule {@link rejectReviewItem} follows. Other refusals name their
+     * cause, as {@link addComment} describes, and leave the open card and its draft open.
      */
-    deleteReviewItem(key: string): ExecResult;
+    deleteReviewItem(key: string, options?: HistoryGroupOptions): ExecResult;
     /**
      * Reply to a review item.
      *
@@ -2042,8 +2148,14 @@ interface Editor extends EditorAnchorNavigation, EditorHighlights, EditorReviewH
      * The author is AMBIENT — `DocxEditorConfig.author`, the way the rest of the authored commands
      * source it — and the argument overrides it for one call. `CT_Comment` makes `@w:author`
      * required, so a reply with neither is refused rather than written as an empty attribute.
+     * Other refusals name their cause, as {@link addComment} describes.
+     *
+     * In a React or Vue host with the review module, `useReview().reply` calls this. For
+     * headless or server use, see `Comment.reply` in `@docx-editor.dev/editor-api`.
      */
-    replyToReviewItem(key: string, text: string, author?: string): ExecResult;
+    replyToReviewItem(key: string, text: string, options?: HistoryGroupOptions): ExecResult;
+    /** {@link replyToReviewItem} with an author for this call, overriding the configured author. */
+    replyToReviewItem(key: string, text: string, author?: string, options?: HistoryGroupOptions): ExecResult;
     setActiveScope(scope: ViewScope): void;
     getActiveScope(): ViewScope;
     query<K extends keyof EditorQueries>(query: {
@@ -2070,7 +2182,8 @@ interface Editor extends EditorAnchorNavigation, EditorHighlights, EditorReviewH
      */
     /**
      * Scroll a page or a block into view. Returns false when the target does not exist or
-     * the host has no scroll container — a caller can tell "not found" from "scrolled".
+     * the host has no scroll container. During a large open, a target not laid out yet answers
+     * true and scrolls once it is; input cancels that, and a page past the end never scrolls.
      */
     scrollToPage(pageNumber: number): boolean;
     /**
@@ -2167,7 +2280,7 @@ type TrackedChangeFilterMode = 'accept' | 'reject';
  * selection, view state, chrome modes, header/footer and note editing. An interface rather than a
  * closed union so an extension can widen it by declaration merging.
  */
-interface EditorCommands extends EditorCommandShape<DocEdits>, EditorHeaderFooterCommands, EditorNoteCommands, EditorFormatPainterCommands {
+interface EditorCommands extends EditorCommandShape<DocEdits>, EditorHeaderFooterCommands, EditorNoteCommands, EditorFormatPainterCommands, EditorBookmarkCommands {
     /** Switch how edits are written. A view command: it changes no document state. */
     setEditingMode: {
         mode: DocumentEditingMode;
@@ -2186,7 +2299,17 @@ interface EditorCommands extends EditorCommandShape<DocEdits>, EditorHeaderFoote
     toggleParagraphMarks: Record<never, never>;
     /** Word's Protect Document: enforce filling-in-forms protection, or lift the enforced one. */
     toggleDocumentProtection: Record<never, never>;
-    /** Navigate tracked changes, including hidden formatting balloons, and wrap at the end. */
+    /**
+     * Navigate tracked changes, including hidden formatting balloons, and wrap at the end.
+     *
+     * A replacement is one stop in every review layout. A replacement is a deletion and the
+     * touching insertion from the same author that took its place. Navigation lands on the
+     * deletion, highlights both halves, and `reviewItemReveal` carries the pair's `pairKey`.
+     *
+     * Navigation steps through the changes {@link Editor.getReviewItems} returns, so a
+     * reviewer or `setTrackedChangesFilter` filter applies. When a filter hides one half of a
+     * replacement, the other half is a stop of its own.
+     */
     navigateReviewChange: {
         direction: 'next' | 'previous';
     };
@@ -2394,11 +2517,21 @@ interface EditorCommands extends EditorCommandShape<DocEdits>, EditorHeaderFoote
         positionTwips: number;
     };
     /**
-     * Replace one found match with `text`. Addressed by {@link TextMatch} rather than a
-     * `DocTarget` because that is what `findMatches` hands back, and re-deriving a target
-     * from it in the caller is where an off-by-one would come from. An empty `text`
-     * deletes the match, which is what a find/replace dialog means by replacing with
-     * nothing.
+     * Replace one found match with `text`, addressed by the {@link TextMatch} `findMatches`
+     * returns. An empty `text` deletes it. The selection and scroll position stay put. In
+     * suggesting mode it is a tracked replacement under the editor's author, refused where
+     * `proposeReplacement` would be. The match must be in the open story, not a text box.
+     *
+     * For headless or server use, see `range.insertText(text, 'Replace')` with
+     * `document.changeTrackingMode` set to `'TrackMineOnly'` in `@docx-editor.dev/editor-api`.
+     *
+     * @example
+     * ```ts
+     * const [match] = editor.findMatches('30 days', { matchCase: true });
+     * if (match) editor.exec({ type: 'replaceMatch', match, text: '45 days' });
+     * ```
+     *
+     * @see {@link https://www.docx-editor.dev/docs/2.x/recipes/tracked-replacement | Replace as a tracked change}
      */
     replaceMatch: {
         match: TextMatch;
@@ -2505,6 +2638,11 @@ interface EditorCommands extends EditorCommandShape<DocEdits>, EditorHeaderFoote
         drawingNodeId?: string;
         expectedPackageRevision?: number;
     };
+    /**
+     * Replace the document watermark in every header the document shows; null removes it. One
+     * undo step. Refuses with `invalidArgs` for an invalid option and `locked` in a protected
+     * document; a refusal writes nothing. See {@link Watermark} for the options and defaults.
+     */
     setWatermark: {
         watermark: Watermark | null;
     };
@@ -2614,6 +2752,8 @@ interface EditorQueries extends DocQueries {
         pos: number;
     };
     trackedChanges: Record<never, never>;
+    /** Every bookmark in the document, hidden ones included, in document order. */
+    bookmarks: Record<never, never>;
 }
 /**
  * One query, as a discriminated union derived from {@link EditorQueries}.
@@ -2640,51 +2780,7 @@ interface EditorQueryResults extends DocQueryResults {
     contentControlAt: ContentControlSummary | null;
     isInsideToc: boolean;
     trackedChanges: readonly Revision[];
-}
-/**
- * One occurrence of a search query in the document.
- *
- * Carries TWO addresses on purpose. `blockId` + `start` is the engine's own: stable
- * across edits and independent of ordering. `paragraphIndex` + `runIndex` + `runOffset`
- * is the positional one a find/replace UI needs to show and navigate results, and it is
- * derived from the same walk rather than left to the caller to reconstruct — a caller
- * guessing at run boundaries would send the selection to the wrong place.
- *
- * A match can span runs when formatting changes mid-word; the run address is where it
- * STARTS. `scope` identifies a non-body story so navigation opens the correct surface.
- * A frame scope selects its anchoring drawing and never places a caret inside its story.
- * A match inside a field result reports the field atom's model range. Its `length` is one,
- * while `text` carries the visible match and can be longer. Select with `start` and `length`.
- * Never derive the selected length from `text.length`.
- */
-interface TextMatch {
-    readonly blockId: string;
-    /** Character offset within the paragraph's concatenated run text. */
-    readonly start: number;
-    readonly length: number;
-    /**
-     * Paragraph ordinal within this match's story. Table and nested-table paragraphs count.
-     * Non-paragraph blocks add no ordinal.
-     */
-    readonly paragraphIndex: number;
-    /** Index of the run the match starts in, and the offset within that run. */
-    readonly runIndex: number;
-    readonly runOffset: number;
-    /** Story containing the match. Absence means the body. */
-    readonly scope?: ViewScope;
-    /** The matched text as it appears in the document. */
-    readonly text: string;
-    /**
-     * Paragraph text immediately before and after the match, bounded at the derivation
-     * boundary. A results list shows the match in its sentence — "…as described in this
-     * **Exhi**bit A" — and nothing else in the contract can reach paragraph text, so a
-     * caller would otherwise have to re-read the document to render one row.
-     *
-     * Optional and additive: an implementation that has not derived them omits them, and a
-     * consumer treats absent as empty.
-     */
-    readonly contextBefore?: string;
-    readonly contextAfter?: string;
+    bookmarks: readonly BookmarkSummary[];
 }
 /**
  * The hyperlink under a position: where it points, how far it reaches, and what Word shows on
@@ -2734,16 +2830,23 @@ interface EditorSnapshot {
      *  point on — it never depends on one existing. */
     readonly isLoading: boolean;
     /**
-     * Whether a supplied document is still on its way to painted pages. Opening a large
-     * document mounts behind one painted frame so a loading screen can show instead of a
-     * frozen page; this is true for exactly that window, and across it the previous
-     * document (if any) stays on screen. Show a loading overlay while it holds — but gate
-     * only chrome on it, never the mount point, which must stay mounted for the open to
-     * complete ({@link EditorSnapshot.isLoading} is the gate-safe flag). Optional and
+     * Whether a supplied document is still on its way to painted pages. A large document
+     * mounts behind one painted frame so a loading screen can show instead of a frozen page,
+     * with the previous document (if any) still on screen. Show an overlay while it holds,
+     * but gate only chrome on it, never the mount point, which must stay mounted for the open
+     * to complete ({@link EditorSnapshot.isLoading} is the gate-safe flag). It turns false
+     * when the first pages paint; they take input while the rest lay out. Optional and
      * additive: absent means the implementation has not derived it, read as `false`.
      */
     readonly isOpening?: boolean;
     readonly parseError: string | null;
+    /**
+     * Why the last supplied document did not open, or `null` while it opens or after it opened.
+     * Unlike {@link EditorSnapshot.parseError}, it holds a stable code and never quotes the
+     * file, so a host can show it to a person. `DocxEditor.OpenFailure` renders it. Optional
+     * and additive: absent means the implementation has not derived it, read as `null`.
+     */
+    readonly openFailure?: DocumentOpenFailure | null;
     /** Whether the loaded document is being edited: a patchable document opened in edit mode. A
      *  read-only document (tables/SDTs/unpreservable) or `mode: 'view'` reports false. */
     readonly editable: boolean;
@@ -2819,6 +2922,8 @@ interface EditorSnapshot {
     readonly reviewPane: ResolvedReviewPane;
     /** Whether Show/Hide paragraph marks is enabled. */
     readonly showParagraphMarks?: boolean;
+    /** Whether bracket marks are shown at bookmarks. */
+    readonly showBookmarks?: boolean;
     /** The document's `w:documentProtection`, as the file states it; null with no document. */
     readonly documentProtection?: DocumentProtectionState | null;
     /** The displayed revision projection. The document and its revision history stay unchanged. */
@@ -2889,11 +2994,13 @@ interface EditorSnapshot {
  * An error the engine raised, carrying a machine-readable `code` alongside the message.
  *
  * `code` is optional because an `Error` from deeper down (a parser, a codec) is surfaced as-is
- * rather than wrapped in a fabricated code.
+ * rather than wrapped in a fabricated code. The editor's own codes: `invalidTarget` (`attach`
+ * cannot mount there), `unsupported` (a source it refuses to open), and `hostCallback` (a host
+ * callback such as a bookmark mark's `decorate` threw; the editor kept its default behavior).
  */
 interface EditorError extends Error {
     readonly code?: string;
 }
 
-export { DIAGNOSTIC_SCHEMA_VERSION as D, resolveReviewPane as a$, DEFAULT_REVIEW_PANE as aQ, cropPercentFromCropPermille as aW, cropPercentFromPermille as aX, cropPercentFromSourceCrop as aY, cropPermilleFromCropPercent as aZ, cropPermilleFromPercent as a_, reviewPaneListsItem as b0, sourceCropFromCropPercent as b1, validateImageCropPercent as b2, EditorFontError as z };
-export type { HeaderFooterState as $, AnchorHighlightAnimation as A, EditorFontErrorCode as B, CanResult as C, EditorDiagnostic as E, EditorFormatPainterCommands as F, EditorHeaderFooterCommands as G, EditorHighlights as H, EditorNoteCommands as I, EditorPosition as J, EditorQueries as K, EditorQuery as L, EditorQueryResults as M, EditorReviewHits as N, EditorSelection as O, EditorSnapshot as P, FontConfiguration as Q, ReviewPaneOptions as R, FontFaceRequest as S, FontFailedDiagnostic as T, FontSource as U, FontSourceSubstitution as V, FormatPainterLevel as W, FormatPainterMode as X, FormatPainterSurfaceState as Y, FurnitureVariant as Z, HeaderFooterSlotArgs as _, EditorDiagnosticKind as a, HighlightHit as a0, HighlightOptions as a1, HighlightRange as a2, HighlightRect as a3, HighlightResult as a4, HistoryDiagnosticEvent as a5, HyperlinkInfo as a6, ImageContext as a7, ImageCropPercent as a8, NoteKind as a9, TableBorderStyle as aA, TableBorderTarget as aB, TableCellVerticalAlignment as aC, TableColumnDividerResizeTarget as aD, TableColumnOccurrenceTarget as aE, TableContext as aF, TableRightEdgeResizeTarget as aG, TableRowOccurrenceTarget as aH, TextMatch as aI, TimingSummary as aJ, TrackedChangeFilterMode as aK, TrackedChangePredicate as aL, ZoomFitTarget as aM, ZoomMode as aN, ReviewPaneOverflow as aO, CommentMarkerStyle as aP, ImageCropPermille as aR, ResolvedReviewPane as aS, ReviewPaneItemFields as aT, ReviewPaneOpening as aU, RevisionDisplay as aV, NotePropertiesSide as aa, NotePropertiesState as ab, PageSetup as ac, PerformanceDiagnostic as ad, ResolveReviewChangesOptions as ae, ResolvedNoteNumbering as af, ReviewActivationOptions as ag, ReviewChangesAttribution as ah, ReviewCommentPlacement as ai, ReviewCustomPlacement as aj, ReviewItemHit as ak, ReviewItemPlacement as al, ReviewItemPlacementBase as am, ReviewItemQuery as an, ReviewItemRevealEvent as ao, ReviewItemRevealSource as ap, ReviewRevisionPlacement as aq, ReviewSkippedDiagnostic as ar, ScrollPlacement as as, ScrollToAnchorOptions as at, SelectedImageState as au, SessionActivity as av, SessionDiagnostic as aw, SetReviewChangesAuthorOptions as ax, TableBorderEdgeTarget as ay, TableBorderSpec as az, EditorCommand as b, AnchorHighlightOptions as c, AuthoredNoteNumbering as d, ClearAnchorHighlightOptions as e, CollaborationParticipantsDiagnostic as f, CollaborationStatusDiagnostic as g, CustomNodeDiagnosticEvent as h, DiagnosticBase as i, DiagnosticFailureDetail as j, DocumentChange as k, DocumentEditingMode as l, DocumentHandle as m, DocumentOpenDiagnostic as n, DocumentSaveDiagnostic as o, DocumentShape as p, DocumentSource as q, EditRejectedDiagnostic as r, EditRejectionOrigin as s, Editor as t, EditorAnchorNavigation as u, EditorCommandShape as v, EditorCommands as w, EditorError as x, EditorEvents as y };
+export { DIAGNOSTIC_SCHEMA_VERSION as D, EditorFontError as J, cropPercentFromCropPermille as aR, cropPercentFromPermille as aS, cropPercentFromSourceCrop as aT, cropPermilleFromCropPercent as aU, cropPermilleFromPercent as aV, sourceCropFromCropPercent as aW, validateImageCropPercent as aX };
+export type { FurnitureVariant as $, AnchorHighlightAnimation as A, BookmarkPlace as B, CanResult as C, EditorDiagnostic as E, EditorCommandShape as F, EditorCommands as G, EditorError as H, EditorEvents as I, EditorFormatPainterCommands as K, EditorHeaderFooterCommands as L, EditorHighlights as M, EditorHostChange as N, EditorHostDocument as O, EditorNoteCommands as P, EditorPosition as Q, EditorQueries as R, EditorQuery as S, EditorQueryResults as T, EditorReviewHits as U, EditorSelection as V, EditorSnapshot as W, FontFailedDiagnostic as X, FormatPainterLevel as Y, FormatPainterMode as Z, FormatPainterSurfaceState as _, EditorDiagnosticKind as a, HeaderFooterSlotArgs as a0, HeaderFooterState as a1, HighlightHit as a2, HighlightOptions as a3, HighlightRange as a4, HighlightRect as a5, HighlightResult as a6, HistoryDiagnosticEvent as a7, HyperlinkInfo as a8, ImageContext as a9, TableBorderEdgeTarget as aA, TableBorderSpec as aB, TableBorderStyle as aC, TableBorderTarget as aD, TableCellVerticalAlignment as aE, TableColumnDividerResizeTarget as aF, TableColumnOccurrenceTarget as aG, TableContext as aH, TableRightEdgeResizeTarget as aI, TableRowOccurrenceTarget as aJ, TextMatch as aK, TimingSummary as aL, TrackedChangeFilterMode as aM, TrackedChangePredicate as aN, ZoomFitTarget as aO, ZoomMode as aP, ImageCropPermille as aQ, ImageCropPercent as aa, NoteKind as ab, NotePropertiesSide as ac, NotePropertiesState as ad, PageSetup as ae, PerformanceDiagnostic as af, ResolveReviewChangesOptions as ag, ResolvedNoteNumbering as ah, ReviewActivationOptions as ai, ReviewChangesAttribution as aj, ReviewCommentPlacement as ak, ReviewCustomPlacement as al, ReviewItemHit as am, ReviewItemPlacement as an, ReviewItemPlacementBase as ao, ReviewItemQuery as ap, ReviewItemRevealEvent as aq, ReviewItemRevealSource as ar, ReviewRevisionPlacement as as, ReviewSkippedDiagnostic as at, ScrollPlacement as au, ScrollToAnchorOptions as av, SelectedImageState as aw, SessionActivity as ax, SessionDiagnostic as ay, SetReviewChangesAuthorOptions as az, EditorCommand as b, AnchorHighlightOptions as c, AuthoredNoteNumbering as d, BookmarkStory as e, BookmarkSummary as f, ClearAnchorHighlightOptions as g, CollaborationParticipantsDiagnostic as h, CollaborationStatusDiagnostic as i, CustomNodeDiagnosticEvent as j, DiagnosticBase as k, DiagnosticFailureDetail as l, DocumentChange as m, DocumentEditingMode as n, DocumentHandle as o, DocumentOpenDiagnostic as p, DocumentOpenFailure as q, DocumentOpenFailureReason as r, DocumentSaveDiagnostic as s, DocumentShape as t, DocumentSource as u, EditRejectedDiagnostic as v, EditRejectionOrigin as w, Editor as x, EditorAnchorNavigation as y, EditorBookmarkCommands as z };