@docx-editor.dev/core 2.23.0 → 2.25.0

package/dist/{index-BYaCkGKO.d.ts → index-3KAxeSic.d.ts}

@@ -1,19 +1,19 @@
-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-DN_-gaRX.js';
-import { a as ImageDecodePort, S as SupportedImageMime } from './image-resources-DkuzBnTM.js';
-import './document-protection-CYIjO-li.js';
+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-BO73JqHG.js';
+import { a as ImageDecodePort, S as SupportedImageMime } from './image-resources-DfagDguq.js';
+import './document-protection-Bp19Ad4I.js';
 import { EditorModule, ReviewModuleContribution } from './contracts/modules.js';
-import { D as DocumentSource, a as FontConfiguration, Z as ZoomMode, E as EditorFontError, q as Editor, e as EditorCommand, C as CanResult, j as SelectedImageState, r as FormatPainterSurfaceState, k as TrackedChangePredicate, T as TrackedChangeFilterMode, F as FontFaceRequest, b as FontSource, I as ImageContext, t as TableBorderEdgeTarget, u as TableBorderSpec, w as TableBorderStyle, x as TableContext } from './editor-DhUQsWWH.js';
-import { R as ReviewDisplayMode } from './revision-projection-CVJeA2jp.js';
-import { S as SemanticPosition, a as SemanticSelection, N as NavigationCommand } from './semantic-interaction-DQjtIruQ.js';
-import { e as FontConfigurationFragment, g as FontResolver, i as MarkedFontResolver, f as FontResolutionRequest } from './font-resolver-BwoHFBlr.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-DkfCCTxA.js';
+import { R as ReviewDisplayMode } from './revision-projection-DfWxdBqA.js';
+import { S as SemanticPosition, a as SemanticSelection, N as NavigationCommand } from './semantic-interaction-BHlV61hK.js';
+import { e as FontConfigurationFragment, g as FontResolver, i as MarkedFontResolver, f as FontResolutionRequest } from './font-resolver-C295obND.js';
 import { EditorCollaborationSession, CollaborationRemoteSelection, CollaborationModuleContribution } from './collaboration.js';
-import { c as RevisionStyles, R as ReviewAuthorInfo, b as RevisionAuthorStyle, F as FieldShadingMode, d as DrawingPaintStrings } from './semantic-paint-DoPl85nR.js';
-import { b as ResolvedFootnoteProperties, R as ResolvedEndnoteProperties, A as AuthoredNoteProperties } from './note-properties-DMfKK3QU.js';
-import { S as SemanticLayout, C as ContentControlBoundaryRecord, T as TextMeasurer } from './semantic-records-DB0VgWsr.js';
-import { B as BookmarkIndex } from './custom-node-writes-77rvPW2-.js';
-import { I as InsertImageInput, S as StoryScope, A as ApplyImagePropertiesInput, i as ImageIntentResult } from './tree-package-fragment-BIyGh6L8.js';
-import { C as CellSelection, S as SectionProperties } from './semantic-cell-selection-B8GF_H2e.js';
-import { T as TreeDocxSessionView, a as TreeApplyResult } from './tree-session-contract-CHcCnz3W.js';
+import { c as RevisionStyles, R as ReviewAuthorInfo, b as RevisionAuthorStyle, F as FieldShadingMode, d as DrawingPaintStrings } from './semantic-paint-DfWIWUs6.js';
+import { b as ResolvedFootnoteProperties, R as ResolvedEndnoteProperties, A as AuthoredNoteProperties } from './note-properties-CmfvOJsi.js';
+import { S as SemanticLayout, T as TextMeasurer, C as ContentControlBoundaryRecord } from './semantic-records-DrExlBy-.js';
+import { B as BookmarkIndex } from './custom-node-writes-Cy9imOjA.js';
+import { I as InsertImageInput, S as StoryScope, A as ApplyImagePropertiesInput, i as ImageIntentResult } from './tree-package-fragment-YPyYC1aD.js';
+import { C as CellSelection, S as SectionProperties } from './semantic-cell-selection-CC3NwCtx.js';
+import { T as TreeDocxSessionView, a as TreeApplyResult } from './tree-session-contract-AeY2v0x9.js';
 import { C as CollaborationStatus } from './failure-BIPVQbRm.js';
 import { V as ViewScope, b as EditorExecOptions } from './editor-scope-OHPwVQ5l.js';
 import './contracts/document.js';
@@ -631,9 +631,7 @@ type ImageMutationPreconditions = Readonly<{
 /**
  * The selected image and what may be done to it, or null when nothing image-like is selected.
  *
- * Null covers more than "no selection": a placeholder graphic, a drawing the file marks hidden,
- * and one whose `select` lock is set all read as no selection, because chrome that offered
- * resize handles on them would promise an edit the store is about to refuse.
+ * Unsupported placeholders, hidden drawings, and select-locked drawings cannot be selected.
  */
 declare function selectedImageStateOf(surface: PaginatedSurface | null): SelectedImageState | null;
 /**
@@ -719,6 +717,8 @@ interface ImageOverlayScrollPort {
  * decide what it is looking at.
  */
 interface SelectedDrawingOverlayTarget {
+    /** Keep the text area available for pointer editing through the frame. */
+    readonly textbox?: boolean;
     readonly id: string;
     readonly pageIndex: number;
     readonly x: number;
@@ -831,7 +831,7 @@ declare function overlayHostOrigin(surfaceElement: HTMLElement | null): {
     readonly top: number;
 };
 /** Whether this handle drag should preserve aspect ratio. */
-declare function resizePreservesAspect(handle: ImageResizeHandle, aspectLocked: boolean, shiftKey: boolean): boolean;
+declare function resizePreservesAspect(handle: ImageResizeHandle, aspectLocked: boolean, shiftKey: boolean, textbox?: boolean): boolean;
 /**
  * Where an anchored drawing's positioning frame begins, in layout points.
  *
@@ -912,6 +912,7 @@ declare function finalizeImageOverlayInteraction(options: {
     readonly accumulatedScrollPt: number;
     readonly aspectLocked: boolean;
     readonly shiftKey: boolean;
+    readonly textbox?: boolean;
     readonly anchorFrameOrigin: AnchorFrameOrigin | null;
 }): FinalizedImageOverlayInteraction;
 
@@ -1021,6 +1022,24 @@ interface ParagraphPropertyEdit {
  */
 type ReviewWriteIntent = 'revision-resolve' | 'comment-add' | 'comment-reply' | 'comment-resolve' | 'comment-delete' | 'package-scoped';
 
+/**
+ * Everything an overlay needs to paint over one rendered frame of the surface.
+ *
+ * `pages` is the materialized page set (absent when every page is built), and `scale` and
+ * `pageOffsetX` are the values the page painter used, so overlay geometry lands on the text.
+ */
+interface SurfaceOverlayFrame {
+    readonly layer: HTMLElement;
+    readonly layout: SemanticLayout;
+    readonly revision: number;
+    readonly scale: number;
+    readonly pages?: ReadonlySet<number>;
+    readonly pageOffsetX?: ReadonlyMap<number, number>;
+    readonly measurer?: TextMeasurer;
+}
+/** A painter the surface calls after every render, and on request. */
+type SurfaceOverlayPainter = (frame: SurfaceOverlayFrame) => void;
+
 /**
  * Content-control interaction lane on the paginated surface.
  *
@@ -1935,6 +1954,13 @@ interface PaginatedSurface {
      * collaborator-name labels.
      */
     setRemoteCaretLabelHost(host: RemoteCaretLabelHost | null): void;
+    /**
+     * Install the painter for host text highlights, or remove it with `null`. The surface calls
+     * it after every render and once on installation, with the frame it just painted.
+     */
+    setHighlightPainter(painter: SurfaceOverlayPainter | null): void;
+    /** Call the installed highlight painter against the current frame. */
+    repaintHighlights(): void;
     /**
      * Commit ops that came from automation, through the gate a keystroke goes through.
      *
@@ -1954,7 +1980,7 @@ interface PaginatedSurface {
      * planned left its target in a read-only document's `.rels`. A builder answering null means the
      * target is one this engine will not author, and the write is refused having changed nothing.
      */
-    applyAutomationOps(staged: (relate: (url: string) => string | null) => readonly TreeDocOp[] | null, scope?: StoryScope, packageEdits?: readonly ((pkg: OoxmlPackage) => OoxmlPackage)[]): TreeApplyResult;
+    applyAutomationOps(staged: (relate: (url: string) => string | null) => readonly TreeDocOp[] | null, scope?: StoryScope, packageEdits?: readonly ((pkg: OoxmlPackage) => OoxmlPackage)[], requiresReview?: boolean): TreeApplyResult;
     /**
      * Which revision halves this surface is SHOWING.
      *
@@ -2511,632 +2537,640 @@ interface ChromeGroup<Id extends string = string, ControlId extends string = str
  * (`alignment.left`, not `alignment.alignLeft`; `font.family`, not `font.fontFamily`).
  */
 declare const CHROME_GROUPS: readonly [{
-    readonly id: "history";
-    readonly labelKey: "formattingBar.groups.history";
+    readonly id: 'history';
+    readonly labelKey: 'formattingBar.groups.history';
     readonly controls: readonly [{
-        readonly id: "undo";
-        readonly labelKey: "formattingBar.undoShortcut";
+        readonly id: 'undo';
+        readonly labelKey: 'formattingBar.undoShortcut';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "redo";
-        readonly labelKey: "formattingBar.redoShortcut";
+        readonly id: 'redo';
+        readonly labelKey: 'formattingBar.redoShortcut';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }];
 }, {
-    readonly id: "zoom";
-    readonly labelKey: "formattingBar.groups.zoom";
+    readonly id: 'zoom';
+    readonly labelKey: 'formattingBar.groups.zoom';
     readonly controls: readonly [{
-        readonly id: "level";
-        readonly shape: "stepper";
-        readonly valueText: "100%";
-        readonly labelKey: "formattingBar.groups.zoom";
+        readonly id: 'level';
+        readonly shape: 'stepper';
+        readonly valueText: '100%';
+        readonly labelKey: 'formattingBar.groups.zoom';
         readonly paths: null;
-        readonly valueKey: "zoom.zoomLevel";
+        readonly valueKey: 'zoom.zoomLevel';
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }];
 }, {
-    readonly id: "styles";
-    readonly labelKey: "formattingBar.groups.styles";
+    readonly id: 'styles';
+    readonly labelKey: 'formattingBar.groups.styles';
     readonly controls: readonly [{
-        readonly id: "style";
-        readonly shape: "dropdown";
-        readonly labelKey: "styles.selectAriaLabel";
+        readonly id: 'style';
+        readonly shape: 'dropdown';
+        readonly labelKey: 'styles.selectAriaLabel';
         readonly paths: null;
-        readonly valueKey: "styles.normalText";
+        readonly valueKey: 'styles.normalText';
         readonly state: {
-            readonly kind: "value";
+            readonly kind: 'value';
         };
     }];
 }, {
-    readonly id: "font";
-    readonly labelKey: "formattingBar.groups.font";
+    readonly id: 'font';
+    readonly labelKey: 'formattingBar.groups.font';
     readonly controls: readonly [{
-        readonly id: "family";
-        readonly shape: "dropdown";
-        readonly labelKey: "font.selectAriaLabel";
+        readonly id: 'family';
+        readonly shape: 'dropdown';
+        readonly labelKey: 'font.selectAriaLabel';
         readonly paths: null;
-        readonly valueKey: "font.sansSerif";
+        readonly valueKey: 'font.sansSerif';
         readonly state: {
-            readonly kind: "value";
+            readonly kind: 'value';
         };
     }, {
-        readonly id: "size";
-        readonly shape: "stepper";
-        readonly valueText: "11";
-        readonly labelKey: "fontSize.listLabel";
+        readonly id: 'size';
+        readonly shape: 'stepper';
+        readonly valueText: '11';
+        readonly labelKey: 'fontSize.listLabel';
         readonly paths: null;
-        readonly valueKey: "fontSize.label";
+        readonly valueKey: 'fontSize.label';
         readonly state: {
-            readonly kind: "value";
+            readonly kind: 'value';
         };
     }];
 }, {
-    readonly id: "text";
-    readonly labelKey: "formattingBar.groups.textFormatting";
+    readonly id: 'text';
+    readonly labelKey: 'formattingBar.groups.textFormatting';
     readonly controls: readonly [{
-        readonly id: "bold";
-        readonly labelKey: "formattingBar.boldShortcut";
+        readonly id: 'bold';
+        readonly labelKey: 'formattingBar.boldShortcut';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "italic";
-        readonly labelKey: "formattingBar.italicShortcut";
+        readonly id: 'italic';
+        readonly labelKey: 'formattingBar.italicShortcut';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "underline";
-        readonly labelKey: "formattingBar.underlineShortcut";
+        readonly id: 'underline';
+        readonly labelKey: 'formattingBar.underlineShortcut';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "strike";
-        readonly labelKey: "formattingBar.strikethrough";
+        readonly id: 'strike';
+        readonly labelKey: 'formattingBar.strikethrough';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "color";
-        readonly shape: "colorSplit";
-        readonly swatch: "#ff0000";
-        readonly labelKey: "formattingBar.fontColor";
+        readonly id: 'color';
+        readonly shape: 'colorSplit';
+        readonly swatch: '#ff0000';
+        readonly labelKey: 'formattingBar.fontColor';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "value";
+            readonly kind: 'value';
         };
     }, {
-        readonly id: "highlight";
-        readonly shape: "colorSplit";
-        readonly swatch: "#ffff00";
-        readonly labelKey: "formattingBar.highlightColor";
+        readonly id: 'highlight';
+        readonly shape: 'colorSplit';
+        readonly swatch: '#ffff00';
+        readonly labelKey: 'formattingBar.highlightColor';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "value";
+            readonly kind: 'value';
         };
     }, {
-        readonly id: "link";
-        readonly labelKey: "formattingBar.insertLinkShortcut";
+        readonly id: 'link';
+        readonly labelKey: 'formattingBar.insertLinkShortcut';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }];
 }, {
-    readonly id: "script";
-    readonly labelKey: "formattingBar.groups.script";
+    readonly id: 'script';
+    readonly labelKey: 'formattingBar.groups.script';
     readonly controls: readonly [{
-        readonly id: "super";
-        readonly labelKey: "formattingBar.superscript";
+        readonly id: 'super';
+        readonly labelKey: 'formattingBar.superscript';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "sub";
-        readonly labelKey: "formattingBar.subscript";
+        readonly id: 'sub';
+        readonly labelKey: 'formattingBar.subscript';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }];
 }, {
-    readonly id: "alignment";
-    readonly labelKey: "formattingBar.groups.alignment";
+    readonly id: 'alignment';
+    readonly labelKey: 'formattingBar.groups.alignment';
     readonly controls: readonly [{
-        readonly id: "left";
-        readonly labelKey: "alignment.alignLeft";
+        readonly id: 'left';
+        readonly labelKey: 'alignment.alignLeft';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "center";
-        readonly labelKey: "alignment.center";
+        readonly id: 'center';
+        readonly labelKey: 'alignment.center';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "right";
-        readonly labelKey: "alignment.alignRight";
+        readonly id: 'right';
+        readonly labelKey: 'alignment.alignRight';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "justify";
-        readonly labelKey: "alignment.justify";
+        readonly id: 'justify';
+        readonly labelKey: 'alignment.justify';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }];
 }, {
-    readonly id: "direction";
-    readonly labelKey: "formattingBar.groups.direction";
+    readonly id: 'direction';
+    readonly labelKey: 'formattingBar.groups.direction';
+    readonly contextual: true;
     readonly controls: readonly [{
-        readonly id: "ltr";
-        readonly labelKey: "toolbar.leftToRight";
+        readonly id: 'ltr';
+        readonly labelKey: 'toolbar.leftToRight';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "rtl";
-        readonly labelKey: "toolbar.rightToLeft";
+        readonly id: 'rtl';
+        readonly labelKey: 'toolbar.rightToLeft';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }];
 }, {
-    readonly id: "list";
-    readonly labelKey: "formattingBar.groups.listFormatting";
+    readonly id: 'list';
+    readonly labelKey: 'formattingBar.groups.listFormatting';
     readonly controls: readonly [{
-        readonly id: "bullet";
-        readonly labelKey: "lists.bulletList";
+        readonly id: 'bullet';
+        readonly labelKey: 'lists.bulletList';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "numbered";
-        readonly labelKey: "lists.numberedList";
+        readonly id: 'numbered';
+        readonly labelKey: 'lists.numberedList';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "outdent";
-        readonly labelKey: "lists.decreaseIndent";
+        readonly id: 'outdent';
+        readonly labelKey: 'lists.decreaseIndent';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "indent";
-        readonly labelKey: "lists.increaseIndent";
+        readonly id: 'indent';
+        readonly labelKey: 'lists.increaseIndent';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "lineSpacing";
-        readonly shape: "dropdown";
-        readonly labelKey: "lineSpacing.label";
+        readonly id: 'lineSpacing';
+        readonly shape: 'dropdown';
+        readonly labelKey: 'lineSpacing.label';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }];
 }, {
-    readonly id: "format";
-    readonly labelKey: "formattingBar.groups.format";
+    readonly id: 'format';
+    readonly labelKey: 'formattingBar.groups.format';
     readonly controls: readonly [{
-        readonly id: "painter";
-        readonly labelKey: "formattingBar.formatPainterShortcut";
+        readonly id: 'painter';
+        readonly labelKey: 'formattingBar.formatPainterShortcut';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "clear";
-        readonly labelKey: "formattingBar.clearFormatting";
+        readonly id: 'clear';
+        readonly labelKey: 'formattingBar.clearFormatting';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }];
 }, {
-    readonly id: "review";
-    readonly labelKey: "formattingBar.commentsAndChanges";
+    readonly id: 'review';
+    readonly labelKey: 'formattingBar.commentsAndChanges';
     readonly controls: readonly [{
-        readonly id: "simpleMarkup";
-        readonly shape: "icon";
-        readonly labelKey: "review.simpleMarkup";
+        readonly id: 'simpleMarkup';
+        readonly shape: 'icon';
+        readonly labelKey: 'review.simpleMarkup';
         readonly defaultToolbar: false;
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "allMarkup";
-        readonly shape: "icon";
-        readonly labelKey: "review.allMarkup";
+        readonly id: 'allMarkup';
+        readonly shape: 'icon';
+        readonly labelKey: 'review.allMarkup';
         readonly defaultToolbar: false;
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "noMarkup";
-        readonly shape: "icon";
-        readonly labelKey: "review.noMarkup";
+        readonly id: 'noMarkup';
+        readonly shape: 'icon';
+        readonly labelKey: 'review.noMarkup';
         readonly defaultToolbar: false;
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "original";
-        readonly shape: "icon";
-        readonly labelKey: "review.original";
+        readonly id: 'original';
+        readonly shape: 'icon';
+        readonly labelKey: 'review.original';
         readonly defaultToolbar: false;
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "previousChange";
-        readonly shape: "icon";
-        readonly labelKey: "review.previousChange";
+        readonly id: 'previousChange';
+        readonly shape: 'icon';
+        readonly labelKey: 'review.previousChange';
         readonly defaultToolbar: false;
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "nextChange";
-        readonly shape: "icon";
-        readonly labelKey: "review.nextChange";
+        readonly id: 'nextChange';
+        readonly shape: 'icon';
+        readonly labelKey: 'review.nextChange';
         readonly defaultToolbar: false;
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "acceptAllChanges";
-        readonly shape: "icon";
-        readonly labelKey: "review.acceptAllChanges";
+        readonly id: 'acceptAllChanges';
+        readonly shape: 'icon';
+        readonly labelKey: 'review.acceptAllChanges';
         readonly defaultToolbar: false;
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "rejectAllChanges";
-        readonly shape: "icon";
-        readonly labelKey: "review.rejectAllChanges";
+        readonly id: 'rejectAllChanges';
+        readonly shape: 'icon';
+        readonly labelKey: 'review.rejectAllChanges';
         readonly defaultToolbar: false;
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "paragraphMarks";
-        readonly shape: "icon";
-        readonly labelKey: "formattingBar.paragraphMarks";
+        readonly id: 'paragraphMarks';
+        readonly shape: 'icon';
+        readonly labelKey: 'formattingBar.paragraphMarks';
         readonly defaultToolbar: false;
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "protectDocument";
-        readonly shape: "icon";
-        readonly labelKey: "review.protectDocument";
+        readonly id: 'protectDocument';
+        readonly shape: 'icon';
+        readonly labelKey: 'review.protectDocument';
         readonly defaultToolbar: false;
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "comments";
-        readonly shape: "icon";
-        readonly labelKey: "formattingBar.commentsAndChanges";
+        readonly id: 'comments';
+        readonly shape: 'icon';
+        readonly labelKey: 'formattingBar.commentsAndChanges';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "authors";
-        readonly shape: "dropdown";
-        readonly labelKey: "reviewers.label";
+        readonly id: 'authors';
+        readonly shape: 'dropdown';
+        readonly labelKey: 'reviewers.label';
         readonly paths: readonly string[];
         readonly defaultToolbar: false;
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "editingMode";
-        readonly shape: "dropdown";
-        readonly labelKey: "editingMode.label";
-        readonly valueKey: "editingMode.editing";
+        readonly id: 'editingMode';
+        readonly shape: 'dropdown';
+        readonly labelKey: 'editingMode.label';
+        readonly valueKey: 'editingMode.editing';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }];
 }, {
-    readonly id: "contentControl";
-    readonly labelKey: "contentControl.group";
+    readonly id: 'contentControl';
+    readonly labelKey: 'contentControl.group';
     readonly contextual: true;
     readonly controls: readonly [{
-        readonly id: "showAll";
-        readonly labelKey: "contentControl.showAll";
+        readonly id: 'showAll';
+        readonly labelKey: 'contentControl.showAll';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "formFill";
-        readonly labelKey: "contentControl.formFill";
+        readonly id: 'formFill';
+        readonly labelKey: 'contentControl.formFill';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "inspector";
-        readonly labelKey: "contentControl.inspector";
+        readonly id: 'inspector';
+        readonly labelKey: 'contentControl.inspector';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "remove";
-        readonly labelKey: "contentControl.remove";
+        readonly id: 'remove';
+        readonly labelKey: 'contentControl.remove';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }];
 }, {
-    readonly id: "image";
-    readonly labelKey: "formattingBar.groups.image";
+    readonly id: 'image';
+    readonly labelKey: 'formattingBar.groups.image';
     readonly contextual: true;
     readonly controls: readonly [{
-        readonly id: "insert";
-        readonly labelKey: "toolbar.image";
+        readonly id: 'insert';
+        readonly labelKey: 'toolbar.image';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "properties";
-        readonly labelKey: "formattingBar.imagePropertiesShortcut";
+        readonly id: 'properties';
+        readonly labelKey: 'formattingBar.imagePropertiesShortcut';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "wrap";
-        readonly shape: "dropdown";
-        readonly labelKey: "formattingBar.imageWrap";
+        readonly id: 'wrap';
+        readonly shape: 'dropdown';
+        readonly labelKey: 'formattingBar.imageWrap';
         readonly paths: readonly string[];
-        readonly valueKey: "imageWrap.inline";
+        readonly valueKey: 'imageWrap.inline';
         readonly state: {
-            readonly kind: "value";
+            readonly kind: 'value';
         };
     }, {
-        readonly id: "altText";
-        readonly shape: "dropdown";
-        readonly labelKey: "formattingBar.altText";
+        readonly id: 'altText';
+        readonly shape: 'dropdown';
+        readonly labelKey: 'formattingBar.altText';
         readonly paths: null;
-        readonly valueKey: "imageProperties.altText";
+        readonly valueKey: 'imageProperties.altText';
         readonly state: {
-            readonly kind: "value";
+            readonly kind: 'value';
         };
     }];
 }, {
-    readonly id: "table";
-    readonly labelKey: "formattingBar.groups.table";
+    readonly id: 'table';
+    readonly labelKey: 'formattingBar.groups.table';
     readonly contextual: true;
     readonly controls: readonly [{
-        readonly id: "insert";
-        readonly labelKey: "toolbar.table";
+        readonly id: 'insert';
+        readonly labelKey: 'toolbar.table';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "borderTarget";
-        readonly shape: "dropdown";
-        readonly labelKey: "table.borders.tooltip";
+        readonly id: 'borderTarget';
+        readonly shape: 'dropdown';
+        readonly labelKey: 'table.borders.tooltip';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "value";
+            readonly kind: 'value';
         };
     }, {
-        readonly id: "borderColor";
-        readonly shape: "colorSplit";
-        readonly swatch: "#000000";
-        readonly labelKey: "table.borderColor";
+        readonly id: 'borderColor';
+        readonly shape: 'colorSplit';
+        readonly swatch: '#000000';
+        readonly labelKey: 'table.borderColor';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "value";
+            readonly kind: 'value';
         };
     }, {
-        readonly id: "borderStyle";
-        readonly shape: "dropdown";
-        readonly labelKey: "table.borders.styleAriaLabel";
+        readonly id: 'borderStyle';
+        readonly shape: 'dropdown';
+        readonly labelKey: 'table.borders.styleAriaLabel';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "value";
+            readonly kind: 'value';
         };
     }, {
-        readonly id: "borderWidth";
-        readonly shape: "dropdown";
-        readonly labelKey: "table.borderWidth";
+        readonly id: 'borderWidth';
+        readonly shape: 'dropdown';
+        readonly labelKey: 'table.borderWidth';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "value";
+            readonly kind: 'value';
         };
     }, {
-        readonly id: "cellFill";
-        readonly shape: "colorSplit";
-        readonly swatch: "#ffffff";
-        readonly labelKey: "table.cellFillColor";
+        readonly id: 'cellFill';
+        readonly shape: 'colorSplit';
+        readonly swatch: '#ffffff';
+        readonly labelKey: 'table.cellFillColor';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "value";
+            readonly kind: 'value';
         };
     }];
 }, {
-    readonly id: "paragraph";
-    readonly labelKey: "dialogs.paragraph.title";
+    readonly id: 'paragraph';
+    readonly labelKey: 'dialogs.paragraph.title';
     readonly contextual: true;
     readonly controls: readonly [{
-        readonly id: "dialog";
-        readonly labelKey: "lineSpacing.options";
+        readonly id: 'dialog';
+        readonly labelKey: 'lineSpacing.options';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }];
 }, {
-    readonly id: "file";
-    readonly labelKey: "toolbar.file";
+    readonly id: 'file';
+    readonly labelKey: 'toolbar.file';
     readonly contextual: true;
     readonly controls: readonly [{
-        readonly id: "open";
-        readonly labelKey: "toolbar.open";
+        readonly id: 'open';
+        readonly labelKey: 'toolbar.open';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "load";
+            readonly kind: 'load';
         };
     }, {
-        readonly id: "save";
-        readonly labelKey: "toolbar.saveShortcut";
+        readonly id: 'save';
+        readonly labelKey: 'toolbar.saveShortcut';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "save";
+            readonly kind: 'save';
         };
     }, {
-        readonly id: "exportMarkdown";
-        readonly labelKey: "toolbar.exportMarkdown";
+        readonly id: 'exportMarkdown';
+        readonly labelKey: 'toolbar.exportMarkdown';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "export";
+            readonly kind: 'export';
         };
     }, {
-        readonly id: "exportPdf";
-        readonly labelKey: "toolbar.exportPdf";
+        readonly id: 'exportPdf';
+        readonly labelKey: 'toolbar.exportPdf';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "export";
+            readonly kind: 'export';
         };
     }, {
-        readonly id: "print";
-        readonly labelKey: "toolbar.print";
+        readonly id: 'print';
+        readonly labelKey: 'toolbar.print';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "export";
+            readonly kind: 'export';
         };
     }, {
-        readonly id: "pageSetup";
-        readonly labelKey: "toolbar.pageSetup";
+        readonly id: 'pageSetup';
+        readonly labelKey: 'toolbar.pageSetup';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }];
 }, {
-    readonly id: "insert";
-    readonly labelKey: "toolbar.insert";
+    readonly id: 'insert';
+    readonly labelKey: 'toolbar.insert';
     readonly contextual: true;
     readonly controls: readonly [{
-        readonly id: "footnote";
-        readonly labelKey: "toolbar.insertFootnote";
+        readonly id: 'textBox';
+        readonly labelKey: 'toolbar.insertTextBox';
+        readonly paths: readonly string[];
+        readonly state: {
+            readonly kind: 'command';
+        };
+    }, {
+        readonly id: 'footnote';
+        readonly labelKey: 'toolbar.insertFootnote';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "endnote";
-        readonly labelKey: "toolbar.insertEndnote";
+        readonly id: 'endnote';
+        readonly labelKey: 'toolbar.insertEndnote';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "pageNumber";
-        readonly labelKey: "headerFooter.insertPageNumber";
+        readonly id: 'pageNumber';
+        readonly labelKey: 'headerFooter.insertPageNumber';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "totalPages";
-        readonly labelKey: "headerFooter.insertTotalPages";
+        readonly id: 'totalPages';
+        readonly labelKey: 'headerFooter.insertTotalPages';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "sectionPages";
-        readonly labelKey: "headerFooter.insertSectionPages";
+        readonly id: 'sectionPages';
+        readonly labelKey: 'headerFooter.insertSectionPages';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "pageXofY";
-        readonly labelKey: "headerFooter.insertPageXofY";
+        readonly id: 'pageXofY';
+        readonly labelKey: 'headerFooter.insertPageXofY';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "pageBreak";
-        readonly labelKey: "toolbar.pageBreak";
+        readonly id: 'pageBreak';
+        readonly labelKey: 'toolbar.pageBreak';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "sectionBreakNextPage";
-        readonly labelKey: "toolbar.sectionBreakNextPage";
+        readonly id: 'sectionBreakNextPage';
+        readonly labelKey: 'toolbar.sectionBreakNextPage';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "sectionBreakContinuous";
-        readonly labelKey: "toolbar.sectionBreakContinuous";
+        readonly id: 'sectionBreakContinuous';
+        readonly labelKey: 'toolbar.sectionBreakContinuous';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }, {
-        readonly id: "toc";
-        readonly labelKey: "toolbar.tableOfContents";
+        readonly id: 'toc';
+        readonly labelKey: 'toolbar.tableOfContents';
         readonly paths: readonly string[];
         readonly state: {
-            readonly kind: "command";
+            readonly kind: 'command';
         };
     }];
 }];
@@ -3154,7 +3188,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.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.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.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';
 /**
  * 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}.
@@ -3270,12 +3304,7 @@ declare const CHROME_MENUS: readonly ChromeMenu[];
 declare function chromeMenuSlots(): readonly ChromeSlotId[];
 /** Total controls, so a parity test can assert none were dropped. */
 declare function chromeControlCount(): number;
-/**
- * i18n key for the tooltip on a control an ADAPTER renders but cannot drive yet — a
- * value slot in a toolbar that has grown no picker for it, say. It is never the reason
- * a control is disabled: when the ENGINE refuses, the tooltip is the engine's own
- * `disabledReason`, never an adapter paraphrase.
- */
+/** Tooltip for adapter controls without a picker; command refusals use engine reasons. */
 declare const CHROME_UNAVAILABLE_KEY = "formattingBar.unavailableInPreview";
 
 /** Material Symbol name → SVG path data (viewBox "0 -960 960 960"). */