@docx-editor.dev/core 2.27.0 → 2.28.0

package/dist/{index-CkQVRJtJ.d.ts → index-Bsg7oIKP.d.ts}

@@ -1,20 +1,21 @@
-import { W as TreeDocOp, cl as TextFormFieldRange, ck as TextFormFieldOptions, ah as Unsubscribe, ab as DrawingPositionInput, aJ as DrawingTransform, E as ExecResult, A as ParagraphTabStop, y as IndentFormatting, z as ParagraphFlags, ao as ParagraphDisagreements, aB as DrawingTreeDocOp, ag as SelectionPin, Q as OoxmlPackage, g as ReviewRevisionKind, aa as ImageWrapTarget } from './types-barrel-BFKR8Pzp.js';
-import { a as ImageDecodePort, S as SupportedImageMime } from './image-resources-BDFxcu7W.js';
-import './document-protection-9zpIHWTE.js';
+import { W as TreeDocOp, co as TextFormFieldRange, cn as TextFormFieldOptions, au as Unsubscribe, E as ExecResult, ao as DrawingPositionInput, aM as DrawingTransform, A as ParagraphTabStop, y as IndentFormatting, z as ParagraphFlags, aB as ParagraphDisagreements, aj as DrawingTreeDocOp, at as SelectionPin, Q as OoxmlPackage, g as ReviewRevisionKind, an as ImageWrapTarget } from './types-barrel-D3xCgQX6.js';
+import { k as FieldResultsMode, I as InsertImageInput, S as StoryScope, A as ApplyImagePropertiesInput, i as ImageIntentResult } from './tree-package-fragment-BeeKxDw8.js';
+import { a as ImageDecodePort, S as SupportedImageMime } from './image-resources-BN-hUgCn.js';
+import './document-protection-BAGVGqaP.js';
 import { EditorModule, ReviewModuleContribution } from './contracts/modules.js';
-import { D as DocumentSource, a as FontConfiguration, Z as ZoomMode, E as EditorFontError, h as Editor, e as EditorCommand, C as CanResult, o as SelectedImageState, y as FormatPainterSurfaceState, q as TrackedChangePredicate, p as TrackedChangeFilterMode, F as FontFaceRequest, b as FontSource, I as ImageContext, z as TableBorderEdgeTarget, B as TableBorderSpec, G as TableBorderStyle, J as TableContext } from './editor-B3OBYNrF.js';
-import { e as RevisionMarkupOptions, a as ReviewDisplayMode, i as RevisionMarkupChromeHandlers, d as ResolvedRevisionMarkup } from './revision-projection-CSNFudZY.js';
-import { S as SemanticPosition, a as SemanticSelection, N as NavigationCommand } from './semantic-interaction-G0bjmmmk.js';
-import { e as FontConfigurationFragment, g as FontResolver, i as MarkedFontResolver, f as FontResolutionRequest } from './font-resolver-DN0xNOf_.js';
+import { D as DocumentSource, a as FontConfiguration, Z as ZoomMode, E as EditorFontError, i as Editor, e as EditorCommand, C as CanResult, p as SelectedImageState, z as FormatPainterSurfaceState, g as ScrollPlacement, r as TrackedChangePredicate, q as TrackedChangeFilterMode, F as FontFaceRequest, b as FontSource, I as ImageContext, B as TableBorderEdgeTarget, G as TableBorderSpec, J as TableBorderStyle, K as TableContext } from './editor-Ci7IZGmG.js';
+import { e as RevisionMarkupOptions, a as ReviewDisplayMode, i as RevisionMarkupChromeHandlers, d as ResolvedRevisionMarkup } from './revision-projection-DZ4kKVev.js';
+import { S as SemanticPosition, a as SemanticSelection, N as NavigationCommand } from './semantic-interaction-CIC-PooQ.js';
+import { e as FontConfigurationFragment, g as FontResolver, i as MarkedFontResolver, f as FontResolutionRequest } from './font-resolver-BVQB14qT.js';
+import { R as ReviewPaneOptions } from './review-pane-D9jm8DcY.js';
 import { EditorCollaborationSession, CollaborationRemoteSelection, CollaborationModuleContribution } from './collaboration.js';
-import { d as RevisionStyles, R as ReviewAuthorInfo, c as RevisionAuthorStyle, F as FieldShadingMode, f as DrawingPaintStrings } from './semantic-paint-CsMzF8-O.js';
-import { b as ResolvedFootnoteProperties, R as ResolvedEndnoteProperties, A as AuthoredNoteProperties } from './note-properties-CkAk7g-n.js';
-import { S as SemanticLayout, T as TextMeasurer, C as ContentControlBoundaryRecord } from './semantic-records-B9OolWGN.js';
-import { B as BookmarkIndex } from './custom-node-writes-Vzpq9I8_.js';
-import { I as InsertImageInput, S as StoryScope, A as ApplyImagePropertiesInput, i as ImageIntentResult } from './tree-package-fragment-DYZIk1rY.js';
-import { C as CellSelection, S as SectionProperties } from './semantic-cell-selection-DoqYCz_F.js';
-import { T as TreeDocxSessionView, a as TreeApplyResult } from './tree-session-contract-DQVJOOkv.js';
-import { C as CollaborationStatus } from './failure-BIPVQbRm.js';
+import { d as RevisionStyles, R as ReviewAuthorInfo, c as RevisionAuthorStyle, F as FieldShadingMode, f as DrawingPaintStrings } from './semantic-paint-BME37OMv.js';
+import { b as ResolvedFootnoteProperties, R as ResolvedEndnoteProperties, A as AuthoredNoteProperties } from './note-properties-4Y9o6Gyk.js';
+import { S as SemanticLayout, T as TextMeasurer, C as ContentControlBoundaryRecord } from './semantic-records-4B3WwFAi.js';
+import { B as BookmarkIndex } from './custom-node-writes-cvL5rhcD.js';
+import { C as CellSelection, S as SectionProperties } from './semantic-cell-selection-D9D1KSXq.js';
+import { T as TreeDocxSessionView, a as TreeApplyResult } from './tree-session-contract-CVbmlMlq.js';
+import { C as CollaborationStatus } from './failure-NS2lsya4.js';
 import { V as ViewScope, b as EditorExecOptions } from './editor-scope-OHPwVQ5l.js';
 import './contracts/document.js';
 import './contracts/interaction.js';
@@ -140,6 +141,31 @@ interface TextFormFieldChromeHandlers {
     readonly onRequest?: (session: TextFormFieldDialogSession) => void;
 }
 
+/**
+ * Receives the element that shows the loading indicator on the first page, while a large
+ * document lays out its remaining pages.
+ *
+ * @example
+ * ```ts
+ * editor.setOpeningIndicatorHost({
+ *   publish(element) {
+ *     // Render your indicator into `element`, or remove it when `element` is null.
+ *   },
+ * });
+ * ```
+ *
+ * @public
+ */
+interface OpeningIndicatorHost {
+    /**
+     * Called with the indicator element when the first pages show, and with `null` when the
+     * remaining pages are laid out or the open is abandoned. The element is empty while a host
+     * is set: render the host's content into it. It is centered on the first page, at most 30%
+     * of the window height below the page top, and scrolls with the document.
+     */
+    publish(element: HTMLElement | null): void;
+}
+
 /**
  * A hyperlink as the surface reports it: its identity, where it sits, and the SANITIZED
  * target. `href: null` is an inert link — a refused scheme or a dangling relationship — which
@@ -372,6 +398,23 @@ interface DocxEditorConfig {
     revisionMarkup?: RevisionMarkupOptions;
     /** Initial review projection. Markup modes require a review module. */
     reviewDisplayMode?: ReviewDisplayMode;
+    /**
+     * How the reader edits saved field results.
+     *
+     * - `'atomic'` (the DEFAULT) — every field is one unit: typing beside a field lands before
+     *   or after it, and Backspace removes it whole.
+     * - `'editable'` — fields that show their saved result (DATE, TIME, MERGEFIELD, HYPERLINK
+     *   display text, QUOTE, FILENAME, FILLIN, SEQ, and the save, print, and creation dates)
+     *   accept typing, deletion, and selection inside the result. Fields the engine computes
+     *   live (PAGE, NUMPAGES, REF, PAGEREF, DOCPROPERTY, and others) stay one unit.
+     *
+     * Editable results must be unnested. Simple fields inside complex field results are not
+     * supported in editable mode.
+     *
+     * Fixed for the instance. `'editable'` with a collaboration module throws a `TypeError`:
+     * shared paragraph text keeps every field one unit.
+     */
+    fieldResults?: FieldResultsMode;
     /** Override raster decode for insert/replace image commands; defaults to browser/headless. */
     imageDecodePort?: ImageDecodePort;
     /**
@@ -472,6 +515,25 @@ interface DocxEditorInstance extends Editor {
      * mount, and it survives a document reload the way the hyperlink chrome does.
      */
     setRemoteCaretLabelHost(host: RemoteCaretLabelHost | null): void;
+    /**
+     * Render the host's own loading indicator on the first page while a large document lays out
+     * its remaining pages, or restore the packaged spinner with `null`. The engine keeps owning
+     * the element and its place on the page; the host owns its content.
+     *
+     * Instance-only, like `setRemoteCaretLabelHost`, and tolerated at any time: a host set
+     * before the open applies when the first pages show. `DocxEditor.Loading` with `overlay`
+     * registers one for you, so set this only when you build your own loading screen.
+     *
+     * @example
+     * ```ts
+     * editor.setOpeningIndicatorHost({
+     *   publish(element) {
+     *     element?.replaceChildren(document.createTextNode('Opening…'));
+     *   },
+     * });
+     * ```
+     */
+    setOpeningIndicatorHost(host: OpeningIndicatorHost | null): void;
     /**
      * Monotonic version of the observable editor state. Bumps whenever anything
      * `snapshot()` reports could have moved — a committed change, a selection move, zoom,
@@ -616,6 +678,26 @@ interface DocxEditorInstance extends Editor {
      * Invalid settings throw TypeError without changing the previous settings.
      */
     setRevisionMarkup(options: RevisionMarkupOptions): void;
+    /**
+     * Change the review pane settings: every field of `ReviewPaneOptions`, such as when the
+     * pane opens by itself and what it does when its card column does not fit. An omitted
+     * field keeps its value. Read the settings in force
+     * from `snapshot().reviewPane`. They stay in force across `load()` and are never saved into
+     * the document. This sets how the pane behaves; to open or close the pane itself, use
+     * `useReview().setPaneOpen` or the `toggleReviewPane` command.
+     *
+     * Returns `changed: false` on success, like every view-only call, because `changed` answers
+     * for the document; to detect a settings change, compare the `snapshot().reviewPane`
+     * reference, which changes only when a setting changes. Refused with `unsupported` when no review module is registered, and
+     * with `invalidArgs` for an unknown field or value. A refusal changes nothing.
+     *
+     * @example
+     * ```ts
+     * const result = editor.setReviewPaneOptions({ opening: 'manual', overflow: 'shrinkPage' });
+     * if (!result.ok) console.warn(result.reason);
+     * ```
+     */
+    setReviewPaneOptions(options: ReviewPaneOptions): ExecResult;
     /**
      * Mount into `el`. If the instance holds pending document bytes (created without a
      * container, or previously detached), they mount now — under the shaped measurer when
@@ -635,6 +717,37 @@ interface DocxEditorInstance extends Editor {
     detach(): void;
 }
 
+/** Which of the eight resize handles a drag started from, by compass direction. */
+type ImageResizeHandle = 'n' | 'ne' | 'e' | 'se' | 's' | 'sw' | 'w' | 'nw';
+/** EMUs per point. DrawingML stores extents in EMU; layout works in points. */
+declare const EMU_PER_POINT = 12700;
+/** Points to EMU, rounded — EMUs are integral in the file. */
+declare function pointsToEmu(points: number): number;
+/** EMU to points. Unrounded, so overlay geometry keeps sub-point precision during a drag. */
+declare function emuToOverlayPoints(emu: number): number;
+/**
+ * The extent a resize drag produces, in EMU.
+ *
+ * Computed from the drag's START extent rather than the previous frame's, so a drag that reverses
+ * direction lands exactly where it began instead of accumulating rounding error.
+ *
+ * `preserveAspect` behaves the way Word's handles do: a corner handle scales by whichever axis
+ * moved further, while an edge handle drives the other axis from the original ratio. Both axes
+ * are floored at one point, so a drag past the opposite edge cannot invert the image.
+ */
+declare function computeResizedImageExtentEmu(startWidthEmu: number, startHeightEmu: number, handle: ImageResizeHandle, deltaWidthPt: number, deltaHeightPt: number, preserveAspect: boolean): {
+    readonly cx: number;
+    readonly cy: number;
+};
+/**
+ * The position a move drag produces, preserving the anchoring the file already used.
+ *
+ * A `frame`-mode position keeps its `relativeToH`/`relativeToV` bases and only shifts the offsets
+ * it actually had — writing an offset the file omitted would re-anchor the drawing to a different
+ * reference and move it somewhere the drag never pointed.
+ */
+declare function computeMovedImagePosition(start: DrawingPositionInput, deltaXPt: number, deltaYPt: number): DrawingPositionInput;
+
 type ImageMutationPreconditions = Readonly<{
     mountGeneration: number;
     packageRevision: number;
@@ -674,14 +787,10 @@ declare function canExecuteImageCommand(command: Extract<EditorCommand, {
 declare function executeImageCommand(editor: DocxEditorInstance, command: Extract<EditorCommand, {
     type: 'insertImage' | 'replaceImage';
 }>): Promise<ExecResult>;
-/** Which of the eight resize handles a drag started from, by compass direction. */
-type ImageResizeHandle = 'n' | 'ne' | 'e' | 'se' | 's' | 'sw' | 'w' | 'nw';
 /** How far one arrow-key press nudges a selected image, in points. */
 declare const IMAGE_OVERLAY_NUDGE_PT = 1;
 /** How far Shift+arrow nudges a selected image, in points. */
 declare const IMAGE_OVERLAY_NUDGE_SHIFT_PT = 10;
-/** EMUs per point. DrawingML stores extents in EMU; layout works in points. */
-declare const EMU_PER_POINT = 12700;
 /**
  * One in-flight image drag: where it started, and everything needed to decide at commit time
  * whether the document still describes what the gesture was planned against.
@@ -761,32 +870,6 @@ interface SelectedDrawingOverlayTarget {
  * claim an object the user did not single out.
  */
 declare function selectedDrawingOverlayTargetOf(surface: PaginatedSurface | null): SelectedDrawingOverlayTarget | null;
-/** Points to EMU, rounded — EMUs are integral in the file. */
-declare function pointsToEmu(points: number): number;
-/** EMU to points. Unrounded, so overlay geometry keeps sub-point precision during a drag. */
-declare function emuToOverlayPoints(emu: number): number;
-/**
- * The extent a resize drag produces, in EMU.
- *
- * Computed from the drag's START extent rather than the previous frame's, so a drag that reverses
- * direction lands exactly where it began instead of accumulating rounding error.
- *
- * `preserveAspect` behaves the way Word's handles do: a corner handle scales by whichever axis
- * moved further, while an edge handle drives the other axis from the original ratio. Both axes
- * are floored at one point, so a drag past the opposite edge cannot invert the image.
- */
-declare function computeResizedImageExtentEmu(startWidthEmu: number, startHeightEmu: number, handle: ImageResizeHandle, deltaWidthPt: number, deltaHeightPt: number, preserveAspect: boolean): {
-    readonly cx: number;
-    readonly cy: number;
-};
-/**
- * The position a move drag produces, preserving the anchoring the file already used.
- *
- * A `frame`-mode position keeps its `relativeToH`/`relativeToV` bases and only shifts the offsets
- * it actually had — writing an offset the file omitted would re-anchor the drawing to a different
- * reference and move it somewhere the drag never pointed.
- */
-declare function computeMovedImagePosition(start: DrawingPositionInput, deltaXPt: number, deltaYPt: number): DrawingPositionInput;
 /**
  * Whether a drag's commit should be refused because the document moved under it — the refusal to
  * return, or null when the commit is still valid.
@@ -1034,7 +1117,7 @@ interface ParagraphPropertyEdit {
  * `commentReference` naming a comment it never received. Naming the write lets each be admitted
  * only once a two-replica test proves it arrives whole.
  */
-type ReviewWriteIntent = 'revision-resolve' | 'comment-add' | 'comment-reply' | 'comment-resolve' | 'comment-delete' | 'package-scoped';
+type ReviewWriteIntent = 'revision-resolve' | 'revision-attribution' | 'comment-add' | 'comment-reply' | 'comment-resolve' | 'comment-delete' | 'package-scoped';
 
 /**
  * Everything an overlay needs to paint over one rendered frame of the surface.
@@ -1228,6 +1311,13 @@ interface PaginatedSurfaceOptions {
      * authority.
      */
     readonly collaborationModel?: CollaborationModuleContribution;
+    /**
+     * How saved field results are edited. `atomic` (the default) keeps every field one unit.
+     * `editable` lets the reader type, delete, and select inside the saved result of a DATE,
+     * MERGEFIELD, HYPERLINK, or similar field. Results must be unnested; simple fields inside
+     * complex field results are not supported. Refused with a {@link collaborationModel}.
+     */
+    readonly fieldResults?: FieldResultsMode;
     readonly measurer?: TextMeasurer;
     /** Ambient author for tracked edits. Required before suggesting can write anything. */
     readonly author?: string;
@@ -1416,7 +1506,7 @@ interface RevealOptions {
      * centred when it has to move, so the reader lands looking AT the thing rather than at
      * the bottom line of the window. Default `'start'`.
      */
-    readonly block?: 'start' | 'center' | 'centerIfNeeded' | 'nearest';
+    readonly block?: ScrollPlacement;
     /** Padding above the target, in CSS pixels. Default 24. */
     readonly offsetPx?: number;
     readonly behavior?: ScrollBehavior;
@@ -1604,6 +1694,25 @@ interface PaginatedSurface {
      * where there is no list to demote).
      */
     adjustIndent(direction: 'increase' | 'decrease'): boolean;
+    /**
+     * Tab (`increase`) or Shift+Tab (`decrease`) over a selection outside a list: change the
+     * indent and keep the text.
+     *
+     * A selection over two or more paragraphs, or a cell rectangle, steps the left indent of
+     * each paragraph. A selection in one paragraph that starts at the paragraph start, whole or
+     * partial, works on the first line: Tab sets a first-line indent of one default tab stop
+     * (`w:defaultTabStop`), or steps the left indent when the first line already has that
+     * indent or more, or a hanging indent. Shift+Tab clears a first-line indent that the
+     * paragraph states itself, so a style value applies again, and otherwise steps the left
+     * indent back. A paragraph the selection reaches only at its start is not touched by this
+     * rule, unless it is the empty last paragraph of the story.
+     *
+     * Answers true when the selection takes this rule, also when the write is refused or
+     * changes nothing, so the text is never replaced. Answers false for a caret and for a
+     * selection in one paragraph that starts inside the text; there Tab types a tab character
+     * and Shift+Tab steps the left indent.
+     */
+    indentWithTab(direction: 'increase' | 'decrease'): boolean;
     /**
      * Set indent to exact values on every paragraph the selection touches — what a ruler
      * drag and an indent spinner both need, where {@link adjustIndent} only steps.
@@ -1925,6 +2034,8 @@ interface PaginatedSurface {
     setEditingMode(mode: SurfaceEditingMode): void;
     /** Set the ambient author after buffered text commits under the previous author. */
     setAuthor(author: string | undefined): void;
+    /** The ambient author tracked edits and review writes record, or undefined. */
+    author(): string | undefined;
     /** Replace localized drawing labels and repaint materialized pages. */
     setDrawingStrings(strings: DrawingPaintStrings): void;
     /** Update shared form-control labels without replacing open dialogs. */
@@ -2418,6 +2529,68 @@ type CustomFontsResolver = MarkedFontResolver<(request: FontResolutionRequest) =
  */
 declare function customFonts(options: CustomFontsOptions): CustomFontsResolver;
 
+/**
+ * A row that runs one chrome slot.
+ *
+ * @public
+ */
+interface ChromeMenuItemEntry {
+    readonly kind: 'item';
+    readonly slot: ChromeSlotId;
+    /**
+     * Plain-label override for this row.
+     *
+     * A slot's own `labelKey` is a TOOLTIP key, and several of them fold the shortcut into
+     * the text (`formattingBar.boldShortcut` is "Bold (Ctrl+B)"). A menu puts the shortcut
+     * in its own right-hand column, so the row needs the bare noun. Both keys already exist
+     * in the catalogue — this points at the plain one rather than minting a duplicate.
+     */
+    readonly labelKey?: string;
+    /** i18n key of the shortcut shown right-aligned on the row (`toolbar.saveShortcut`). */
+    readonly shortcutKey?: string;
+    /**
+     * The row opens a size PICKER instead of firing on click — Word's insert-table grid.
+     * The slot still owns the label, the icon and the enabled state; only the dispatch
+     * differs, and the picked size is what the host sends.
+     */
+    readonly picker?: 'tableGrid';
+}
+/**
+ * A row that opens a nested panel of rows (Insert › Break).
+ *
+ * It carries its own label and icon rather than a slot, because a submenu PARENT has no
+ * command: clicking it opens the panel. Giving it a slot would mint a public id for a
+ * control that can never be enabled, and `toolbarCommandState` would have to invent an
+ * answer about it.
+ *
+ * @public
+ */
+interface ChromeMenuSubmenuEntry {
+    readonly kind: 'submenu';
+    readonly labelKey: string;
+    readonly paths: readonly string[] | null;
+    readonly items: readonly ChromeMenuEntry[];
+}
+/** A horizontal rule between groups of rows. @public */
+interface ChromeMenuSeparatorEntry {
+    readonly kind: 'separator';
+}
+/** One row of a chrome menu. @public */
+type ChromeMenuEntry = ChromeMenuItemEntry | ChromeMenuSubmenuEntry | ChromeMenuSeparatorEntry;
+/**
+ * Every menu id, as a literal union. Stable public API; renaming one is a breaking change,
+ * exactly like a group or slot id.
+ *
+ * @public
+ */
+type ChromeMenuId = 'file' | 'format' | 'insert' | 'review' | 'help';
+/** One menu of the menu bar. @public */
+interface ChromeMenu {
+    readonly id: ChromeMenuId;
+    readonly labelKey: string;
+    readonly entries: readonly ChromeMenuEntry[];
+}
+
 /**
  * HOW a control reaches the engine — never WHETHER it is enabled.
  *
@@ -2812,6 +2985,7 @@ declare const CHROME_GROUPS: readonly [{
         readonly id: 'revisionMarkup';
         readonly shape: 'icon';
         readonly labelKey: 'revisionMarkup.title';
+        readonly defaultToolbar: false;
         readonly paths: readonly string[];
         readonly state: {
             readonly kind: 'command';
@@ -2914,6 +3088,15 @@ declare const CHROME_GROUPS: readonly [{
         readonly state: {
             readonly kind: 'command';
         };
+    }, {
+        readonly id: 'addComment';
+        readonly shape: 'icon';
+        readonly labelKey: 'formattingBar.addComment';
+        readonly defaultToolbar: false;
+        readonly paths: readonly string[];
+        readonly state: {
+            readonly kind: 'command';
+        };
     }, {
         readonly id: 'authors';
         readonly shape: 'dropdown';
@@ -3213,7 +3396,7 @@ type ChromeGroupId = 'history' | 'zoom' | 'styles' | 'font' | 'text' | 'script'
  *
  * @public
  */
-type ChromeSlotId = 'history.undo' | 'history.redo' | 'zoom.level' | 'styles.style' | 'font.family' | 'font.size' | 'text.bold' | 'text.italic' | 'text.underline' | 'text.strike' | 'text.color' | 'text.highlight' | 'text.link' | 'script.super' | 'script.sub' | 'alignment.left' | 'alignment.center' | 'alignment.right' | 'alignment.justify' | 'direction.ltr' | 'direction.rtl' | 'list.bullet' | 'list.numbered' | 'list.outdent' | 'list.indent' | 'list.lineSpacing' | 'format.painter' | 'format.clear' | 'review.revisionMarkup' | 'review.comments' | 'review.paragraphMarks' | 'review.protectDocument' | 'review.simpleMarkup' | 'review.allMarkup' | 'review.noMarkup' | 'review.original' | 'review.previousChange' | 'review.nextChange' | 'review.acceptAllChanges' | 'review.rejectAllChanges' | 'review.authors' | 'review.editingMode' | 'contentControl.showAll' | 'contentControl.formFill' | 'contentControl.inspector' | 'contentControl.remove' | 'image.insert' | 'image.properties' | 'image.wrap' | 'image.altText' | 'table.insert' | 'table.borderTarget' | 'table.borderColor' | 'table.borderStyle' | 'table.borderWidth' | 'table.cellFill' | 'file.open' | 'file.save' | 'file.exportMarkdown' | 'file.exportPdf' | 'file.print' | 'paragraph.dialog' | 'file.pageSetup' | 'insert.textBox' | 'insert.footnote' | 'insert.endnote' | 'insert.pageNumber' | 'insert.totalPages' | 'insert.sectionPages' | 'insert.pageXofY' | 'insert.pageBreak' | 'insert.sectionBreakNextPage' | 'insert.sectionBreakContinuous' | 'insert.toc';
+type ChromeSlotId = 'history.undo' | 'history.redo' | 'zoom.level' | 'styles.style' | 'font.family' | 'font.size' | 'text.bold' | 'text.italic' | 'text.underline' | 'text.strike' | 'text.color' | 'text.highlight' | 'text.link' | 'script.super' | 'script.sub' | 'alignment.left' | 'alignment.center' | 'alignment.right' | 'alignment.justify' | 'direction.ltr' | 'direction.rtl' | 'list.bullet' | 'list.numbered' | 'list.outdent' | 'list.indent' | 'list.lineSpacing' | 'format.painter' | 'format.clear' | 'review.revisionMarkup' | 'review.comments' | 'review.addComment' | 'review.paragraphMarks' | 'review.protectDocument' | 'review.simpleMarkup' | 'review.allMarkup' | 'review.noMarkup' | 'review.original' | 'review.previousChange' | 'review.nextChange' | 'review.acceptAllChanges' | 'review.rejectAllChanges' | 'review.authors' | 'review.editingMode' | 'contentControl.showAll' | 'contentControl.formFill' | 'contentControl.inspector' | 'contentControl.remove' | 'image.insert' | 'image.properties' | 'image.wrap' | 'image.altText' | 'table.insert' | 'table.borderTarget' | 'table.borderColor' | 'table.borderStyle' | 'table.borderWidth' | 'table.cellFill' | 'file.open' | 'file.save' | 'file.exportMarkdown' | 'file.exportPdf' | 'file.print' | 'paragraph.dialog' | 'file.pageSetup' | 'insert.textBox' | 'insert.footnote' | 'insert.endnote' | 'insert.pageNumber' | 'insert.totalPages' | 'insert.sectionPages' | 'insert.pageXofY' | 'insert.pageBreak' | 'insert.sectionBreakNextPage' | 'insert.sectionBreakContinuous' | 'insert.toc';
 /**
  * Every control id in the chrome, as a literal union. Unique WITHIN a group, not
  * globally (`image.insert` / `table.insert`) — key consumers on {@link ChromeSlotId}.
@@ -3252,67 +3435,7 @@ declare function defaultChromeGroups(): readonly ChromeGroup[];
  * @public
  */
 declare function formattingBarChromeGroups(image: ImageContext | null): readonly ChromeGroup[];
-/**
- * A row that runs one chrome slot.
- *
- * @public
- */
-interface ChromeMenuItemEntry {
-    readonly kind: 'item';
-    readonly slot: ChromeSlotId;
-    /**
-     * Plain-label override for this row.
-     *
-     * A slot's own `labelKey` is a TOOLTIP key, and several of them fold the shortcut into
-     * the text (`formattingBar.boldShortcut` is "Bold (Ctrl+B)"). A menu puts the shortcut
-     * in its own right-hand column, so the row needs the bare noun. Both keys already exist
-     * in the catalogue — this points at the plain one rather than minting a duplicate.
-     */
-    readonly labelKey?: string;
-    /** i18n key of the shortcut shown right-aligned on the row (`toolbar.saveShortcut`). */
-    readonly shortcutKey?: string;
-    /**
-     * The row opens a size PICKER instead of firing on click — Word's insert-table grid.
-     * The slot still owns the label, the icon and the enabled state; only the dispatch
-     * differs, and the picked size is what the host sends.
-     */
-    readonly picker?: 'tableGrid';
-}
-/**
- * A row that opens a nested panel of rows (Insert › Break).
- *
- * It carries its own label and icon rather than a slot, because a submenu PARENT has no
- * command: clicking it opens the panel. Giving it a slot would mint a public id for a
- * control that can never be enabled, and `toolbarCommandState` would have to invent an
- * answer about it.
- *
- * @public
- */
-interface ChromeMenuSubmenuEntry {
-    readonly kind: 'submenu';
-    readonly labelKey: string;
-    readonly paths: readonly string[] | null;
-    readonly items: readonly ChromeMenuEntry[];
-}
-/** A horizontal rule between groups of rows. @public */
-interface ChromeMenuSeparatorEntry {
-    readonly kind: 'separator';
-}
-/** One row of a chrome menu. @public */
-type ChromeMenuEntry = ChromeMenuItemEntry | ChromeMenuSubmenuEntry | ChromeMenuSeparatorEntry;
-/**
- * Every menu id, as a literal union. Stable public API; renaming one is a breaking change,
- * exactly like a group or slot id.
- *
- * @public
- */
-type ChromeMenuId = 'file' | 'format' | 'insert' | 'review' | 'help';
-/** One menu of the menu bar. @public */
-interface ChromeMenu {
-    readonly id: ChromeMenuId;
-    readonly labelKey: string;
-    readonly entries: readonly ChromeMenuEntry[];
-}
+
 /**
  * The menu bar the chrome shows above the toolbar, in bar order: File, Format, Insert, Review,
  * Help.
@@ -3742,5 +3865,5 @@ interface ChromePrintJob {
  */
 declare function runChromePrint(editor: Pick<Editor, 'save'> & Partial<Pick<Editor, 'snapshot'>>, handlers?: ChromeExportHandlers, container?: Document | Element): Promise<ChromePrintJob>;
 
-export { IMAGE_OVERLAY_NUDGE_SHIFT_PT as $, CHROME_GROUPS as C, DEFAULT_TABLE_CHROME_DRAFT as F, EMU_PER_POINT as I, IMAGE_OVERLAY_NUDGE_PT as _, createImageOverlayScrollPort as a$, applyTableChromePick as aI, bindHistoryGroup as aJ, blankDocumentBytes as aK, canExecuteImageCommand as aL, captureImageMutationPreconditions as aM, chromeControlCount as aN, chromeMenuSlots as aO, chromeProbeForSlot as aP, chromeSlotId as aQ, chromeSlotIsToggle as aR, commandExecOptions as aS, commandForSlot as aT, commandForSlotValue as aU, commandForTableChromeSlotValue as aV, computeImageResizeResult as aW, computeMovedImagePosition as aX, computeResizedImageExtentEmu as aY, createDocxEditor as aZ, createFontSource as a_, TABLE_BORDER_STYLE_OPTIONS as aq, TABLE_BORDER_TARGET_OPTIONS as ar, TABLE_BORDER_WIDTH_OPTIONS as as, TABLE_CHROME_SLOT_IDS as at, CHROME_MENUS as b, cssPixelsToLayoutPoints as b0, customFonts as b1, defaultChromeGroups as b2, defaultTableLabel as b3, emuToOverlayPoints as b4, equationAtPosition as b5, executeImageCommand as b6, finalizeImageOverlayInteraction as b7, formattingBarChromeGroups as b8, isChromePrintShortcut as b9, isStaleImageInteractionCommit as ba, isTableChromeSlot as bb, layoutPointsToCssPixels as bc, loadFonts as bd, overlayFrameToSheetCssPixels as be, overlayHostOrigin as bf, pointsToEmu as bg, probeTableChromeCommand as bh, resizePreservesAspect as bi, runChromeExport as bj, runChromePrint as bk, runSave as bl, runTableChromeCommand as bm, runTableCommand as bn, runToolbarCommand as bo, selectedDrawingOverlayTargetOf as bp, selectedImageStateOf as bq, surfacePaintScale as br, tableChromeIconPaths as bs, tableChromeLabelKeyForTarget as bt, tableChromeToolbarState as bu, tableChromeVisible as bv, tableCommandToolbarState as bw, toolbarCommandState as bx, toolbarCommandStates as by, CHROME_UNAVAILABLE_KEY as c, ChromeExportError as g, ChromePrintError as t };
-export type { AnchorFrameOrigin as A, CustomFontsOptions as B, DocxEditorInstance as D, CustomFontsResolver as E, DocxEditorConfig as G, DrawingSelectionIntent as H, EditorCommandExecute as J, EquationActivation as K, EquationChromeHandlers as L, EquationOps as M, FinalizedImageOverlayInteraction as N, OpenPaginatedResult as O, PaginatedSurfaceOptions as P, FontLoadFailure as Q, FontLoadFailureReason as R, FontMeasurementState as S, TableCommandPlan as T, FontUrlSource as U, HistoryGroupBinding as V, HistoryGroupBindingOptions as W, HyperlinkActivation as X, HyperlinkChromeHandlers as Y, HyperlinkOps as Z, PaginatedSurface as a, ImageInteractionSession as a0, ImageOverlayScrollPort as a1, ImageResizeHandle as a2, ImageResizeResult as a3, InvalidTextFormFieldChromeHandlers as a4, InvalidTextFormFieldSession as a5, LoadFontsRequest as a6, LoadFontsResult as a7, OverlayFrameRect as a8, PaginatedSurfaceState as a9, TableChromeSlotId as aA, TableInteractionLabelKey as aB, TextFormFieldChromeHandlers as aC, TextFormFieldDialogSession as aD, ToolbarCommandState as aE, ToolbarSlotValue as aF, ToolbarValueMap as aG, ToolbarValueSlot as aH, ParagraphPropertyEdit as aa, PopupChromeRegistrationOptions as ab, RemoteCaretLabelAnchor as ac, RemoteCaretLabelHost as ad, ReviewWriteIntent as ae, RunTableChromeCommandResult as af, SectionAnchor as ag, SectionBreakInsertType as ah, SelectedDrawingOverlayTarget as ai, SurfaceEquation as aj, SurfaceFormatting as ak, SurfaceHyperlink as al, SurfaceInsertImageInput as am, SurfaceNavigation as an, SurfaceOverlayCoordinates as ao, SurfaceParagraphFormat as ap, TableBorderStyleOption as au, TableBorderTargetOption as av, TableBorderTargetValue as aw, TableBorderWidthOption as ax, TableChromeDraft as ay, TableChromePick as az, ChromeControl as d, ChromeControlId as e, ChromeControlState as f, ChromeExportFormat as h, ChromeExportHandlers as i, ChromeExportResult as j, ChromeExportView as k, ChromeGroup as l, ChromeGroupId as m, ChromeMenu as n, ChromeMenuEntry as o, ChromeMenuId as p, ChromeMenuItemEntry as q, ChromeMenuSeparatorEntry as r, ChromeMenuSubmenuEntry as s, ChromePrintErrorCode as u, ChromePrintJob as v, ChromePrintOptions as w, ChromeSlotId as x, ContentControlWidgetChromeHandlers as y, ContentControlWidgetSession as z };
+export { IMAGE_OVERLAY_NUDGE_SHIFT_PT as $, CHROME_GROUPS as C, DEFAULT_TABLE_CHROME_DRAFT as F, EMU_PER_POINT as I, IMAGE_OVERLAY_NUDGE_PT as _, createFontSource as a$, applyTableChromePick as aJ, bindHistoryGroup as aK, blankDocumentBytes as aL, canExecuteImageCommand as aM, captureImageMutationPreconditions as aN, chromeControlCount as aO, chromeMenuSlots as aP, chromeProbeForSlot as aQ, chromeSlotId as aR, chromeSlotIsToggle as aS, commandExecOptions as aT, commandForSlot as aU, commandForSlotValue as aV, commandForTableChromeSlotValue as aW, computeImageResizeResult as aX, computeMovedImagePosition as aY, computeResizedImageExtentEmu as aZ, createDocxEditor as a_, TABLE_BORDER_STYLE_OPTIONS as ar, TABLE_BORDER_TARGET_OPTIONS as as, TABLE_BORDER_WIDTH_OPTIONS as at, TABLE_CHROME_SLOT_IDS as au, CHROME_MENUS as b, createImageOverlayScrollPort as b0, cssPixelsToLayoutPoints as b1, customFonts as b2, defaultChromeGroups as b3, defaultTableLabel as b4, emuToOverlayPoints as b5, equationAtPosition as b6, executeImageCommand as b7, finalizeImageOverlayInteraction as b8, formattingBarChromeGroups as b9, isChromePrintShortcut as ba, isStaleImageInteractionCommit as bb, isTableChromeSlot as bc, layoutPointsToCssPixels as bd, loadFonts as be, overlayFrameToSheetCssPixels as bf, overlayHostOrigin as bg, pointsToEmu as bh, probeTableChromeCommand as bi, resizePreservesAspect as bj, runChromeExport as bk, runChromePrint as bl, runSave as bm, runTableChromeCommand as bn, runTableCommand as bo, runToolbarCommand as bp, selectedDrawingOverlayTargetOf as bq, selectedImageStateOf as br, surfacePaintScale as bs, tableChromeIconPaths as bt, tableChromeLabelKeyForTarget as bu, tableChromeToolbarState as bv, tableChromeVisible as bw, tableCommandToolbarState as bx, toolbarCommandState as by, toolbarCommandStates as bz, CHROME_UNAVAILABLE_KEY as c, ChromeExportError as g, ChromePrintError as t };
+export type { AnchorFrameOrigin as A, CustomFontsOptions as B, DocxEditorInstance as D, CustomFontsResolver as E, DocxEditorConfig as G, DrawingSelectionIntent as H, EditorCommandExecute as J, EquationActivation as K, EquationChromeHandlers as L, EquationOps as M, FinalizedImageOverlayInteraction as N, OpenPaginatedResult as O, PaginatedSurfaceOptions as P, FontLoadFailure as Q, FontLoadFailureReason as R, FontMeasurementState as S, TableCommandPlan as T, FontUrlSource as U, HistoryGroupBinding as V, HistoryGroupBindingOptions as W, HyperlinkActivation as X, HyperlinkChromeHandlers as Y, HyperlinkOps as Z, PaginatedSurface as a, ImageInteractionSession as a0, ImageOverlayScrollPort as a1, ImageResizeHandle as a2, ImageResizeResult as a3, InvalidTextFormFieldChromeHandlers as a4, InvalidTextFormFieldSession as a5, LoadFontsRequest as a6, LoadFontsResult as a7, OpeningIndicatorHost as a8, OverlayFrameRect as a9, TableChromePick as aA, TableChromeSlotId as aB, TableInteractionLabelKey as aC, TextFormFieldChromeHandlers as aD, TextFormFieldDialogSession as aE, ToolbarCommandState as aF, ToolbarSlotValue as aG, ToolbarValueMap as aH, ToolbarValueSlot as aI, PaginatedSurfaceState as aa, ParagraphPropertyEdit as ab, PopupChromeRegistrationOptions as ac, RemoteCaretLabelAnchor as ad, RemoteCaretLabelHost as ae, ReviewWriteIntent as af, RunTableChromeCommandResult as ag, SectionAnchor as ah, SectionBreakInsertType as ai, SelectedDrawingOverlayTarget as aj, SurfaceEquation as ak, SurfaceFormatting as al, SurfaceHyperlink as am, SurfaceInsertImageInput as an, SurfaceNavigation as ao, SurfaceOverlayCoordinates as ap, SurfaceParagraphFormat as aq, TableBorderStyleOption as av, TableBorderTargetOption as aw, TableBorderTargetValue as ax, TableBorderWidthOption as ay, TableChromeDraft as az, ChromeControl as d, ChromeControlId as e, ChromeControlState as f, ChromeExportFormat as h, ChromeExportHandlers as i, ChromeExportResult as j, ChromeExportView as k, ChromeGroup as l, ChromeGroupId as m, ChromeMenu as n, ChromeMenuEntry as o, ChromeMenuId as p, ChromeMenuItemEntry as q, ChromeMenuSeparatorEntry as r, ChromeMenuSubmenuEntry as s, ChromePrintErrorCode as u, ChromePrintJob as v, ChromePrintOptions as w, ChromeSlotId as x, ContentControlWidgetChromeHandlers as y, ContentControlWidgetSession as z };

package/dist/index.cjs

@@ -1 +1 @@
-'use strict';var chunkDGPA3TST_cjs=require('./chunk-DGPA3TST.cjs');require('./chunk-NBCVVZOM.cjs'),require('./chunk-WG4KMSX2.cjs');var chunkOHAXVTWG_cjs=require('./chunk-OHAXVTWG.cjs');require('./chunk-HO5XFO32.cjs'),require('./chunk-FQN4KSFL.cjs'),require('./chunk-WRLKVNNR.cjs'),require('./chunk-55AT3MOU.cjs'),require('./chunk-CWRBFNK5.cjs'),require('./chunk-LZLTN5A3.cjs'),require('./chunk-2GK7YQB2.cjs'),require('./chunk-K246T47S.cjs'),require('./chunk-AVKVRU7Z.cjs'),require('./chunk-BTQKU64Q.cjs'),require('./chunk-GVUOWHTO.cjs'),require('./chunk-4KZ6L5YF.cjs'),require('./chunk-UKVVUHZL.cjs');Object.defineProperty(exports,"CHROME_GROUPS",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.wa}});Object.defineProperty(exports,"CHROME_MENUS",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.Aa}});Object.defineProperty(exports,"ChromeExportError",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.Mb}});Object.defineProperty(exports,"ChromePrintError",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.Ob}});Object.defineProperty(exports,"bindHistoryGroup",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.Cb}});Object.defineProperty(exports,"blankDocumentBytes",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.d}});Object.defineProperty(exports,"chromeMenuSlots",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.Ba}});Object.defineProperty(exports,"commandForSlot",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.ja}});Object.defineProperty(exports,"commandForSlotValue",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.la}});Object.defineProperty(exports,"createDocxEditor",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.cb}});Object.defineProperty(exports,"createFontSource",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.i}});Object.defineProperty(exports,"customFonts",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.j}});Object.defineProperty(exports,"isChromePrintShortcut",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.Pb}});Object.defineProperty(exports,"loadFonts",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.h}});Object.defineProperty(exports,"runChromeExport",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.Nb}});Object.defineProperty(exports,"runChromePrint",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.Qb}});Object.defineProperty(exports,"runToolbarCommand",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.ra}});Object.defineProperty(exports,"toolbarCommandState",{enumerable:true,get:function(){return chunkDGPA3TST_cjs.na}});Object.defineProperty(exports,"DEFAULT_FONT",{enumerable:true,get:function(){return chunkOHAXVTWG_cjs.d}});Object.defineProperty(exports,"FONT_RESOLVER_BRAND",{enumerable:true,get:function(){return chunkOHAXVTWG_cjs.i}});Object.defineProperty(exports,"FONT_RESOLVER_MARK_KEY",{enumerable:true,get:function(){return chunkOHAXVTWG_cjs.h}});Object.defineProperty(exports,"WORD_DEFAULT_FONT",{enumerable:true,get:function(){return chunkOHAXVTWG_cjs.e}});Object.defineProperty(exports,"composeFontConfiguration",{enumerable:true,get:function(){return chunkOHAXVTWG_cjs.f}});Object.defineProperty(exports,"composeFontOrigins",{enumerable:true,get:function(){return chunkOHAXVTWG_cjs.n}});Object.defineProperty(exports,"defineFontResolver",{enumerable:true,get:function(){return chunkOHAXVTWG_cjs.j}});Object.defineProperty(exports,"isFontResolver",{enumerable:true,get:function(){return chunkOHAXVTWG_cjs.k}});
+'use strict';var chunkRCHS4ZEH_cjs=require('./chunk-RCHS4ZEH.cjs');require('./chunk-NBCVVZOM.cjs'),require('./chunk-EO4C5QJW.cjs');var chunkK5U2PLDP_cjs=require('./chunk-K5U2PLDP.cjs');require('./chunk-6APGXLBB.cjs'),require('./chunk-VX43VBAX.cjs'),require('./chunk-6AWEKBLB.cjs'),require('./chunk-4GBTELJV.cjs'),require('./chunk-SRPILEWV.cjs'),require('./chunk-QMLCVPCD.cjs'),require('./chunk-ZUHOMK52.cjs'),require('./chunk-O2AL2HSJ.cjs'),require('./chunk-JGNVNT2A.cjs'),require('./chunk-BTQKU64Q.cjs'),require('./chunk-2GO5T2JU.cjs'),require('./chunk-FIJZIQXA.cjs'),require('./chunk-UKVVUHZL.cjs');Object.defineProperty(exports,"CHROME_GROUPS",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.Ta}});Object.defineProperty(exports,"CHROME_MENUS",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.Xa}});Object.defineProperty(exports,"ChromeExportError",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.nc}});Object.defineProperty(exports,"ChromePrintError",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.pc}});Object.defineProperty(exports,"bindHistoryGroup",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.dc}});Object.defineProperty(exports,"blankDocumentBytes",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.g}});Object.defineProperty(exports,"chromeMenuSlots",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.Ya}});Object.defineProperty(exports,"commandForSlot",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.ma}});Object.defineProperty(exports,"commandForSlotValue",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.oa}});Object.defineProperty(exports,"createDocxEditor",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.Bb}});Object.defineProperty(exports,"createFontSource",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.l}});Object.defineProperty(exports,"customFonts",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.m}});Object.defineProperty(exports,"isChromePrintShortcut",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.qc}});Object.defineProperty(exports,"loadFonts",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.k}});Object.defineProperty(exports,"runChromeExport",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.oc}});Object.defineProperty(exports,"runChromePrint",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.rc}});Object.defineProperty(exports,"runToolbarCommand",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.ua}});Object.defineProperty(exports,"toolbarCommandState",{enumerable:true,get:function(){return chunkRCHS4ZEH_cjs.qa}});Object.defineProperty(exports,"DEFAULT_FONT",{enumerable:true,get:function(){return chunkK5U2PLDP_cjs.d}});Object.defineProperty(exports,"FONT_RESOLVER_BRAND",{enumerable:true,get:function(){return chunkK5U2PLDP_cjs.i}});Object.defineProperty(exports,"FONT_RESOLVER_MARK_KEY",{enumerable:true,get:function(){return chunkK5U2PLDP_cjs.h}});Object.defineProperty(exports,"WORD_DEFAULT_FONT",{enumerable:true,get:function(){return chunkK5U2PLDP_cjs.e}});Object.defineProperty(exports,"composeFontConfiguration",{enumerable:true,get:function(){return chunkK5U2PLDP_cjs.f}});Object.defineProperty(exports,"composeFontOrigins",{enumerable:true,get:function(){return chunkK5U2PLDP_cjs.n}});Object.defineProperty(exports,"defineFontResolver",{enumerable:true,get:function(){return chunkK5U2PLDP_cjs.j}});Object.defineProperty(exports,"isFontResolver",{enumerable:true,get:function(){return chunkK5U2PLDP_cjs.k}});

package/dist/index.d.ts

@@ -1,26 +1,53 @@
-export { B as Block, r as ColorValue, C as CommentRecord, m as ContainerRef, s as ContentControl, n as ContentControlFilter, i as ContentControlType, t as DocAnchor, u as DocAnchorRange, q as DocComment, v as DocLocation, o as DocRange, j as DocTarget, w as DocumentBody, D as DocxDocument, ai as DocxDocumentJSON, aj as DrawingHorizontalReferenceFrame, a9 as DrawingKind, ac as DrawingLocks, ab as DrawingPositionInput, ak as DrawingVerticalReferenceFrame, x as ExecErrorCode, E as ExecResult, l as Extent, al as FontDefinition, H as HeaderFooterSet, aa as ImageWrapTarget, y as IndentFormatting, I as InsertableContentControlType, am as NumberingRef, an as PageMargins, P as Paragraph, ao as ParagraphDisagreements, z as ParagraphFlags, ad as ParagraphFormatCommand, A as ParagraphTabStop, ap as Point, af as Rect, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, R as ReviewModelInput, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind, p as Revision, h as RevisionAddress, a3 as RevisionBatchResult, F as RevisionType, aq as Run, k as RunFormatting, G as Section, J as SectionProperties, ag as SelectionPin, K as StyleDefinition, S as StyleDefinitions, T as Table, ar as TableCell, as as TableRow, L as Theme, M as ThemeColorScheme, ah as Unsubscribe, ae as Watermark } from './types-barrel-BFKR8Pzp.js';
-export { b as ImageResourceState, P as PreservedImageMime, R as RenderableImageMime, S as SupportedImageMime, V as ValidatedImageBytesHandle, c as VectorImageMime } from './image-resources-BDFxcu7W.js';
-export { a as DocumentProtectionEdit, D as DocumentProtectionState } from './document-protection-9zpIHWTE.js';
+/**
+ * `@docx-editor.dev/core` — the engine: contracts, layout, store, and the editor facade.
+ *
+ * One preservation model and one pipeline: bytes are read into a canonical typed-and-generic
+ * OOXML tree, mutated only through the store's ops, laid out DOM-free, and painted onto pages
+ * that ARE the editable surface. Content the engine does not model is carried losslessly rather
+ * than dropped, so an unfamiliar document never locks editing.
+ *
+ * @example Create an editor over DOCX bytes
+ * ```ts
+ * import { createDocxEditor } from '@docx-editor.dev/core';
+ *
+ * const editor = createDocxEditor({ document: bytes });
+ * editor.attach(element);
+ * ```
+ *
+ * THIS ENTRY IS THE 80% PATH. Everything needed to stand up an editor over DOCX bytes,
+ * measure it with real fonts, and drive it from chrome is here, so the common case is one
+ * import. The subpaths (`./store`, `./layout`, `./output`, `./automation`, and the
+ * `./contracts/*` declarations) stay available for the deeper work — walking the canonical
+ * tree, running layout by hand, painting — and nothing here hides them.
+ * If you want the editor already wired to a UI, use `@docx-editor.dev/react`.
+ *
+ * @packageDocumentation
+ * @public
+ */
+export { B as Block, r as ColorValue, C as CommentRecord, m as ContainerRef, s as ContentControl, n as ContentControlFilter, i as ContentControlType, t as DocAnchor, u as DocAnchorRange, q as DocComment, v as DocLocation, o as DocRange, j as DocTarget, w as DocumentBody, D as DocxDocument, av as DocxDocumentJSON, aw as DrawingHorizontalReferenceFrame, am as DrawingKind, ap as DrawingLocks, ao as DrawingPositionInput, ax as DrawingVerticalReferenceFrame, x as ExecErrorCode, E as ExecResult, l as Extent, ay as FontDefinition, H as HeaderFooterSet, an as ImageWrapTarget, y as IndentFormatting, I as InsertableContentControlType, az as NumberingRef, aA as PageMargins, P as Paragraph, aB as ParagraphDisagreements, z as ParagraphFlags, aq as ParagraphFormatCommand, A as ParagraphTabStop, aC as Point, as as Rect, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, R as ReviewModelInput, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind, p as Revision, h as RevisionAddress, a3 as RevisionAuthorResult, a6 as RevisionBatchResult, F as RevisionType, aD as Run, k as RunFormatting, G as Section, J as SectionProperties, at as SelectionPin, K as StyleDefinition, S as StyleDefinitions, T as Table, aE as TableCell, aF as TableRow, L as Theme, M as ThemeColorScheme, au as Unsubscribe, ar as Watermark } from './types-barrel-D3xCgQX6.js';
+export { k as FieldResultsMode } from './tree-package-fragment-BeeKxDw8.js';
+export { b as ImageResourceState, P as PreservedImageMime, R as RenderableImageMime, S as SupportedImageMime, V as ValidatedImageBytesHandle, c as VectorImageMime } from './image-resources-BN-hUgCn.js';
+export { a as DocumentProtectionEdit, D as DocumentProtectionState } from './document-protection-BAGVGqaP.js';
 export { CollectReviewItems, EditorModule, ReviewModuleContribution } from './contracts/modules.js';
-export { g as AnchorHighlightAnimation, A as AnchorHighlightOptions, K as AuthoredNoteNumbering, C as CanResult, f as ClearAnchorHighlightOptions, L as DocumentChange, M as DocumentEditingMode, N as DocumentHandle, D as DocumentSource, h as Editor, O as EditorAnchorNavigation, e as EditorCommand, P as EditorCommandShape, Q as EditorCommands, R as EditorError, U as EditorEvents, E as EditorFontError, V as EditorFontErrorCode, W as EditorFormatPainterCommands, X as EditorHeaderFooterCommands, Y as EditorHighlights, _ as EditorNoteCommands, $ as EditorPosition, a0 as EditorQueries, a1 as EditorQuery, a2 as EditorQueryResults, a3 as EditorSelection, d as EditorSnapshot, a as FontConfiguration, F as FontFaceRequest, b as FontSource, c as FontSourceSubstitution, a4 as FormatPainterLevel, a5 as FormatPainterMode, y as FormatPainterSurfaceState, a6 as FurnitureVariant, a7 as HeaderFooterSlotArgs, a8 as HeaderFooterState, k as HighlightHit, j as HighlightOptions, H as HighlightRange, l as HighlightRect, i as HighlightResult, a9 as HyperlinkInfo, I as ImageContext, m as ImageCropPercent, aa as NoteKind, ab as NotePropertiesSide, ac as NotePropertiesState, ad as PageSetup, ae as ResolveReviewChangesOptions, af as ResolvedNoteNumbering, ag as ReviewActivationOptions, ah as ReviewCommentPlacement, ai as ReviewCustomPlacement, aj as ReviewItemPlacement, ak as ReviewItemPlacementBase, al as ReviewItemQuery, am as ReviewRevisionPlacement, S as ScrollToAnchorOptions, o as SelectedImageState, z as TableBorderEdgeTarget, B as TableBorderSpec, G as TableBorderStyle, an as TableBorderTarget, ao as TableCellVerticalAlignment, ap as TableColumnDividerResizeTarget, aq as TableColumnOccurrenceTarget, J as TableContext, ar as TableRightEdgeResizeTarget, as as TableRowOccurrenceTarget, T as TextMatch, p as TrackedChangeFilterMode, q as TrackedChangePredicate, at as ZoomFitTarget, Z as ZoomMode } from './editor-B3OBYNrF.js';
-export { b as RevisionDisplayMode } from './revision-projection-CSNFudZY.js';
-export { S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-G0bjmmmk.js';
-export { C as ComposeFontOriginsOptions, D as DEFAULT_FONT, b as FONT_RESOLVER_BRAND, c as FONT_RESOLVER_MARK_KEY, d as FontConfigurationBase, e as FontConfigurationFragment, a as FontOrigin, F as FontOriginFailure, f as FontResolutionRequest, g as FontResolver, h as FontResolverMark, i as MarkedFontResolver, W as WORD_DEFAULT_FONT, j as composeFontConfiguration, k as composeFontOrigins, l as defineFontResolver, m as isFontResolver } from './font-resolver-DN0xNOf_.js';
-export { C as CHROME_GROUPS, b as CHROME_MENUS, g as ChromeExportError, h as ChromeExportFormat, i as ChromeExportHandlers, j as ChromeExportResult, n as ChromeMenu, o as ChromeMenuEntry, p as ChromeMenuId, q as ChromeMenuItemEntry, r as ChromeMenuSeparatorEntry, s as ChromeMenuSubmenuEntry, t as ChromePrintError, u as ChromePrintErrorCode, v as ChromePrintJob, w as ChromePrintOptions, x as ChromeSlotId, B as CustomFontsOptions, E as CustomFontsResolver, G as DocxEditorConfig, D as DocxEditorInstance, Q as FontLoadFailure, R as FontLoadFailureReason, S as FontMeasurementState, U as FontUrlSource, V as HistoryGroupBinding, W as HistoryGroupBindingOptions, X as HyperlinkActivation, Y as HyperlinkChromeHandlers, a6 as LoadFontsRequest, a7 as LoadFontsResult, al as SurfaceHyperlink, aE as ToolbarCommandState, aJ as bindHistoryGroup, aK as blankDocumentBytes, aO as chromeMenuSlots, aT as commandForSlot, aU as commandForSlotValue, aZ as createDocxEditor, a_ as createFontSource, b1 as customFonts, b9 as isChromePrintShortcut, bd as loadFonts, bj as runChromeExport, bk as runChromePrint, bo as runToolbarCommand, bx as toolbarCommandState } from './index-CkQVRJtJ.js';
+export { h as AnchorHighlightAnimation, A as AnchorHighlightOptions, L as AuthoredNoteNumbering, C as CanResult, f as ClearAnchorHighlightOptions, M as DocumentChange, N as DocumentEditingMode, O as DocumentHandle, D as DocumentSource, i as Editor, P as EditorAnchorNavigation, e as EditorCommand, Q as EditorCommandShape, U as EditorCommands, V as EditorError, W as EditorEvents, E as EditorFontError, X as EditorFontErrorCode, Y as EditorFormatPainterCommands, _ as EditorHeaderFooterCommands, $ as EditorHighlights, a0 as EditorNoteCommands, a1 as EditorPosition, a2 as EditorQueries, a3 as EditorQuery, a4 as EditorQueryResults, a5 as EditorReviewHits, a6 as EditorSelection, d as EditorSnapshot, a as FontConfiguration, F as FontFaceRequest, b as FontSource, c as FontSourceSubstitution, a7 as FormatPainterLevel, a8 as FormatPainterMode, z as FormatPainterSurfaceState, a9 as FurnitureVariant, aa as HeaderFooterSlotArgs, ab as HeaderFooterState, l as HighlightHit, k as HighlightOptions, H as HighlightRange, m as HighlightRect, j as HighlightResult, ac as HyperlinkInfo, I as ImageContext, n as ImageCropPercent, ad as NoteKind, ae as NotePropertiesSide, af as NotePropertiesState, ag as PageSetup, ah as ResolveReviewChangesOptions, ai as ResolvedNoteNumbering, aj as ReviewActivationOptions, ak as ReviewChangesAttribution, al as ReviewCommentPlacement, am as ReviewCustomPlacement, R as ReviewItemHit, an as ReviewItemPlacement, ao as ReviewItemPlacementBase, ap as ReviewItemQuery, aq as ReviewItemRevealEvent, ar as ReviewItemRevealSource, as as ReviewRevisionPlacement, g as ScrollPlacement, S as ScrollToAnchorOptions, p as SelectedImageState, at as SetReviewChangesAuthorOptions, B as TableBorderEdgeTarget, G as TableBorderSpec, J as TableBorderStyle, au as TableBorderTarget, av as TableCellVerticalAlignment, aw as TableColumnDividerResizeTarget, ax as TableColumnOccurrenceTarget, K as TableContext, ay as TableRightEdgeResizeTarget, az as TableRowOccurrenceTarget, T as TextMatch, q as TrackedChangeFilterMode, r as TrackedChangePredicate, aA as ZoomFitTarget, Z as ZoomMode } from './editor-Ci7IZGmG.js';
+export { a as ReviewDisplayMode, b as RevisionDisplayMode } from './revision-projection-DZ4kKVev.js';
+export { S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-CIC-PooQ.js';
+export { C as ComposeFontOriginsOptions, D as DEFAULT_FONT, b as FONT_RESOLVER_BRAND, c as FONT_RESOLVER_MARK_KEY, d as FontConfigurationBase, e as FontConfigurationFragment, a as FontOrigin, F as FontOriginFailure, f as FontResolutionRequest, g as FontResolver, h as FontResolverMark, i as MarkedFontResolver, W as WORD_DEFAULT_FONT, j as composeFontConfiguration, k as composeFontOrigins, l as defineFontResolver, m as isFontResolver } from './font-resolver-BVQB14qT.js';
+export { C as CHROME_GROUPS, b as CHROME_MENUS, g as ChromeExportError, h as ChromeExportFormat, i as ChromeExportHandlers, j as ChromeExportResult, n as ChromeMenu, o as ChromeMenuEntry, p as ChromeMenuId, q as ChromeMenuItemEntry, r as ChromeMenuSeparatorEntry, s as ChromeMenuSubmenuEntry, t as ChromePrintError, u as ChromePrintErrorCode, v as ChromePrintJob, w as ChromePrintOptions, x as ChromeSlotId, B as CustomFontsOptions, E as CustomFontsResolver, G as DocxEditorConfig, D as DocxEditorInstance, Q as FontLoadFailure, R as FontLoadFailureReason, S as FontMeasurementState, U as FontUrlSource, V as HistoryGroupBinding, W as HistoryGroupBindingOptions, X as HyperlinkActivation, Y as HyperlinkChromeHandlers, a6 as LoadFontsRequest, a7 as LoadFontsResult, am as SurfaceHyperlink, aF as ToolbarCommandState, aK as bindHistoryGroup, aL as blankDocumentBytes, aP as chromeMenuSlots, aU as commandForSlot, aV as commandForSlotValue, a_ as createDocxEditor, a$ as createFontSource, b2 as customFonts, ba as isChromePrintShortcut, be as loadFonts, bk as runChromeExport, bl as runChromePrint, bp as runToolbarCommand, by as toolbarCommandState } from './index-Bsg7oIKP.js';
 export { ApplyResult, ContentControlSummary, DocEdit, DocEdits, DocQueries, DocQuery, DocQueryResults, ParagraphSummary } from './contracts/document.js';
 export { b as EditorExecOptions, E as EditorScope, H as HistoryDiagnostic, a as HistoryGroup, c as HistoryGroupOutcome, V as ViewScope } from './editor-scope-OHPwVQ5l.js';
 export { InteractionAffinity, InteractionOutcome, InteractionOutcomeCode, SemanticIdentity, SemanticTarget } from './contracts/interaction.js';
+import './review-pane-D9jm8DcY.js';
 import './collaboration.js';
-import './tree-package-fragment-DYZIk1rY.js';
 import './collaboration/replication.js';
-import './failure-BIPVQbRm.js';
-import './semantic-records-B9OolWGN.js';
-import './omml-equation-DuczgG5o.js';
-import './semantic-paint-CsMzF8-O.js';
-import './semantic-record-queries-1du6lQqS.js';
-import './note-properties-CkAk7g-n.js';
-import './custom-node-writes-Vzpq9I8_.js';
-import './semantic-cell-selection-DoqYCz_F.js';
-import './tree-session-contract-DQVJOOkv.js';
-import './headless-document-view-ICYqNkQ1.js';
+import './failure-NS2lsya4.js';
+import './semantic-records-4B3WwFAi.js';
+import './omml-equation-CuzBL5DD.js';
+import './semantic-paint-BME37OMv.js';
+import './semantic-record-queries-CBlZqZNa.js';
+import './note-properties-4Y9o6Gyk.js';
+import './custom-node-writes-cvL5rhcD.js';
+import './semantic-cell-selection-D9D1KSXq.js';
+import './tree-session-contract-CVbmlMlq.js';
+import './headless-document-view-qH331moE.js';
 import 'prosemirror-model';

package/dist/index.js

@@ -1 +1 @@
-export{wa as CHROME_GROUPS,Aa as CHROME_MENUS,Mb as ChromeExportError,Ob as ChromePrintError,Cb as bindHistoryGroup,d as blankDocumentBytes,Ba as chromeMenuSlots,ja as commandForSlot,la as commandForSlotValue,cb as createDocxEditor,i as createFontSource,j as customFonts,Pb as isChromePrintShortcut,h as loadFonts,Nb as runChromeExport,Qb as runChromePrint,ra as runToolbarCommand,na as toolbarCommandState}from'./chunk-UBLUVNZR.js';import'./chunk-O5INAWZQ.js';import'./chunk-7IGCWG4H.js';export{d as DEFAULT_FONT,i as FONT_RESOLVER_BRAND,h as FONT_RESOLVER_MARK_KEY,e as WORD_DEFAULT_FONT,f as composeFontConfiguration,n as composeFontOrigins,j as defineFontResolver,k as isFontResolver}from'./chunk-IGR23DV2.js';import'./chunk-JSIX2EOH.js';import'./chunk-RIYSCEFQ.js';import'./chunk-S74GRBNE.js';import'./chunk-KAXOGCGA.js';import'./chunk-VIPMGGUT.js';import'./chunk-7MYITTAH.js';import'./chunk-HAQ72KD7.js';import'./chunk-ZU7IVN6G.js';import'./chunk-6ZQMII6V.js';import'./chunk-GWQJ5774.js';import'./chunk-6JIJOZDW.js';import'./chunk-DNXVNQEO.js';import'./chunk-UMRSBLO7.js';import'./chunk-S6J4O5XP.js';
+export{Ta as CHROME_GROUPS,Xa as CHROME_MENUS,nc as ChromeExportError,pc as ChromePrintError,dc as bindHistoryGroup,g as blankDocumentBytes,Ya as chromeMenuSlots,ma as commandForSlot,oa as commandForSlotValue,Bb as createDocxEditor,l as createFontSource,m as customFonts,qc as isChromePrintShortcut,k as loadFonts,oc as runChromeExport,rc as runChromePrint,ua as runToolbarCommand,qa as toolbarCommandState}from'./chunk-LWDSDCMO.js';import'./chunk-O5INAWZQ.js';import'./chunk-KKIJG3C6.js';export{d as DEFAULT_FONT,i as FONT_RESOLVER_BRAND,h as FONT_RESOLVER_MARK_KEY,e as WORD_DEFAULT_FONT,f as composeFontConfiguration,n as composeFontOrigins,j as defineFontResolver,k as isFontResolver}from'./chunk-VDNNLG6X.js';import'./chunk-2RC2EPND.js';import'./chunk-RIYSCEFQ.js';import'./chunk-VHAVHCQY.js';import'./chunk-6EYYL7FL.js';import'./chunk-FRXAOVTB.js';import'./chunk-Z6WBFXJU.js';import'./chunk-5CSUYANV.js';import'./chunk-E7BQA6UP.js';import'./chunk-TSLBZ26X.js';import'./chunk-J6BVWIDB.js';import'./chunk-6JIJOZDW.js';import'./chunk-ETTO6GK3.js';import'./chunk-4R3TEXMN.js';import'./chunk-S6J4O5XP.js';