@docx-editor.dev/core 2.1.2 → 2.2.0

package/dist/contracts/editor.cjs

@@ -1 +1 @@
-'use strict';var chunkHBL3NNH5_cjs=require('../chunk-HBL3NNH5.cjs');Object.defineProperty(exports,"EditorFontError",{enumerable:true,get:function(){return chunkHBL3NNH5_cjs.a}});
+'use strict';var chunkMIUELYVA_cjs=require('../chunk-MIUELYVA.cjs');Object.defineProperty(exports,"EditorFontError",{enumerable:true,get:function(){return chunkMIUELYVA_cjs.a}});

package/dist/contracts/editor.d.cts

@@ -1,11 +1,11 @@
 export { ContentControlSummary, DocEdits, DocQueries, DocQueryResults, ParagraphSummary } from './document.cjs';
 export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind } from '../review-support-rsyGP5-9.cjs';
-export { A as AuthoredNoteNumbering, C as CanResult, p as DocumentChange, q as DocumentEditingMode, r as DocumentHandle, D as DocumentSource, l as Editor, a as EditorCommand, t as EditorCommandShape, u as EditorCommands, w as EditorError, x as EditorEvents, E as EditorFontError, y as EditorFontErrorCode, z as EditorHeaderFooterCommands, B as EditorNoteCommands, G as EditorPosition, H as EditorQueries, J as EditorQuery, K as EditorQueryResults, L as EditorScope, M as EditorSelection, N as EditorSnapshot, F as FontConfiguration, k as FontFaceRequest, i as FontSource, j as FontSourceSubstitution, O as FurnitureVariant, P as HeaderFooterSlotArgs, Q as HeaderFooterState, R as HyperlinkInfo, I as ImageContext, b as ImageCropPercent, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, Y as NoteKind, Z as NotePropertiesSide, _ as NotePropertiesState, $ as PageSetup, a0 as ResolvedNoteNumbering, a1 as ReviewActivationOptions, a2 as ReviewCommentPlacement, a3 as ReviewCustomPlacement, a4 as ReviewItemPlacement, a5 as ReviewItemPlacementBase, a6 as ReviewItemQuery, a7 as ReviewRevisionPlacement, S as SelectedImageState, a8 as SemanticIdentity, a9 as SemanticTarget, T as TableBorderEdgeTarget, m as TableBorderSpec, n as TableBorderStyle, aa as TableBorderTarget, ab as TableCellVerticalAlignment, ac as TableColumnDividerResizeTarget, ad as TableColumnOccurrenceTarget, o as TableContext, ae as TableRightEdgeResizeTarget, af as TableRowOccurrenceTarget, ag as TextMatch, V as ViewScope } from '../editor-BGBZn9c9.cjs';
-export { S as SemanticPosition, a as SemanticSelection } from '../semantic-interaction-DqcEonqD.cjs';
+export { A as AuthoredNoteNumbering, C as CanResult, p as DocumentChange, q as DocumentEditingMode, r as DocumentHandle, D as DocumentSource, l as Editor, a as EditorCommand, t as EditorCommandShape, u as EditorCommands, w as EditorError, x as EditorEvents, E as EditorFontError, y as EditorFontErrorCode, z as EditorHeaderFooterCommands, B as EditorNoteCommands, G as EditorPosition, H as EditorQueries, J as EditorQuery, K as EditorQueryResults, L as EditorScope, M as EditorSelection, N as EditorSnapshot, F as FontConfiguration, k as FontFaceRequest, i as FontSource, j as FontSourceSubstitution, O as FurnitureVariant, P as HeaderFooterSlotArgs, Q as HeaderFooterState, R as HyperlinkInfo, I as ImageContext, b as ImageCropPercent, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, Y as NoteKind, _ as NotePropertiesSide, $ as NotePropertiesState, a0 as PageSetup, a1 as ResolvedNoteNumbering, a2 as ReviewActivationOptions, a3 as ReviewCommentPlacement, a4 as ReviewCustomPlacement, a5 as ReviewItemPlacement, a6 as ReviewItemPlacementBase, a7 as ReviewItemQuery, a8 as ReviewRevisionPlacement, S as SelectedImageState, a9 as SemanticIdentity, aa as SemanticTarget, T as TableBorderEdgeTarget, m as TableBorderSpec, n as TableBorderStyle, ab as TableBorderTarget, ac as TableCellVerticalAlignment, ad as TableColumnDividerResizeTarget, ae as TableColumnOccurrenceTarget, o as TableContext, af as TableRightEdgeResizeTarget, ag as TableRowOccurrenceTarget, ah as TextMatch, V as ViewScope, ai as ZoomFitTarget, Z as ZoomMode } from '../editor-25RmHnxu.cjs';
+export { S as SemanticPosition, a as SemanticSelection } from '../semantic-interaction-B4HrJFQ2.cjs';
 export { Block, ColorValue, ContainerRef, ContentControl, ContentControlFilter, ContentControlType, DocAnchor, DocAnchorRange, DocComment, DocLocation, DocRange, DocTarget, DocumentBody, DocxDocument, DocxDocumentJSON, ExecErrorCode, ExecResult, Extent, FontDefinition, HeaderFooterSet, IndentFormatting, NumberingRef, PageMargins, Paragraph, Point, Rect, Revision, RevisionType, Run, RunFormatting, Section, SectionProperties, StyleDefinition, StyleDefinitions, Table, TableCell, TableRow, Theme, ThemeColorScheme, Unsubscribe, Watermark } from './types.cjs';
 export { f as DrawingHorizontalReferenceFrame, c as DrawingKind, e as DrawingLocks, d as DrawingPositionInput, g as DrawingVerticalReferenceFrame, b as ImageWrapTarget, R as RevisionAddress } from '../tree-op-types-UOXlRUqQ.cjs';
 export { I as ImageResourceState, P as PreservedImageMime, R as RenderableImageMime, S as SupportedImageMime, V as ValidatedImageBytesHandle, a as VectorImageMime } from '../image-resources-DwpNnTg3.cjs';
 import '../ooxml-tree-BU0e3DVi.cjs';
-import '../semantic-records-COVFW5aS.cjs';
+import '../semantic-records-DC6V1U3T.cjs';
 import '../revision-projection-72ZApe-g.cjs';
 import '../ooxml-package-CR5us6ad.cjs';

package/dist/contracts/editor.d.ts

@@ -1,11 +1,11 @@
 export { ContentControlSummary, DocEdits, DocQueries, DocQueryResults, ParagraphSummary } from './document.js';
 export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind } from '../review-support-B9ykYpoZ.js';
-export { A as AuthoredNoteNumbering, C as CanResult, p as DocumentChange, q as DocumentEditingMode, r as DocumentHandle, D as DocumentSource, l as Editor, a as EditorCommand, t as EditorCommandShape, u as EditorCommands, w as EditorError, x as EditorEvents, E as EditorFontError, y as EditorFontErrorCode, z as EditorHeaderFooterCommands, B as EditorNoteCommands, G as EditorPosition, H as EditorQueries, J as EditorQuery, K as EditorQueryResults, L as EditorScope, M as EditorSelection, N as EditorSnapshot, F as FontConfiguration, k as FontFaceRequest, i as FontSource, j as FontSourceSubstitution, O as FurnitureVariant, P as HeaderFooterSlotArgs, Q as HeaderFooterState, R as HyperlinkInfo, I as ImageContext, b as ImageCropPercent, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, Y as NoteKind, Z as NotePropertiesSide, _ as NotePropertiesState, $ as PageSetup, a0 as ResolvedNoteNumbering, a1 as ReviewActivationOptions, a2 as ReviewCommentPlacement, a3 as ReviewCustomPlacement, a4 as ReviewItemPlacement, a5 as ReviewItemPlacementBase, a6 as ReviewItemQuery, a7 as ReviewRevisionPlacement, S as SelectedImageState, a8 as SemanticIdentity, a9 as SemanticTarget, T as TableBorderEdgeTarget, m as TableBorderSpec, n as TableBorderStyle, aa as TableBorderTarget, ab as TableCellVerticalAlignment, ac as TableColumnDividerResizeTarget, ad as TableColumnOccurrenceTarget, o as TableContext, ae as TableRightEdgeResizeTarget, af as TableRowOccurrenceTarget, ag as TextMatch, V as ViewScope } from '../editor-DQRRxKMG.js';
-export { S as SemanticPosition, a as SemanticSelection } from '../semantic-interaction-CXH2wFqi.js';
+export { A as AuthoredNoteNumbering, C as CanResult, p as DocumentChange, q as DocumentEditingMode, r as DocumentHandle, D as DocumentSource, l as Editor, a as EditorCommand, t as EditorCommandShape, u as EditorCommands, w as EditorError, x as EditorEvents, E as EditorFontError, y as EditorFontErrorCode, z as EditorHeaderFooterCommands, B as EditorNoteCommands, G as EditorPosition, H as EditorQueries, J as EditorQuery, K as EditorQueryResults, L as EditorScope, M as EditorSelection, N as EditorSnapshot, F as FontConfiguration, k as FontFaceRequest, i as FontSource, j as FontSourceSubstitution, O as FurnitureVariant, P as HeaderFooterSlotArgs, Q as HeaderFooterState, R as HyperlinkInfo, I as ImageContext, b as ImageCropPercent, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, Y as NoteKind, _ as NotePropertiesSide, $ as NotePropertiesState, a0 as PageSetup, a1 as ResolvedNoteNumbering, a2 as ReviewActivationOptions, a3 as ReviewCommentPlacement, a4 as ReviewCustomPlacement, a5 as ReviewItemPlacement, a6 as ReviewItemPlacementBase, a7 as ReviewItemQuery, a8 as ReviewRevisionPlacement, S as SelectedImageState, a9 as SemanticIdentity, aa as SemanticTarget, T as TableBorderEdgeTarget, m as TableBorderSpec, n as TableBorderStyle, ab as TableBorderTarget, ac as TableCellVerticalAlignment, ad as TableColumnDividerResizeTarget, ae as TableColumnOccurrenceTarget, o as TableContext, af as TableRightEdgeResizeTarget, ag as TableRowOccurrenceTarget, ah as TextMatch, V as ViewScope, ai as ZoomFitTarget, Z as ZoomMode } from '../editor-C8oaTHr3.js';
+export { S as SemanticPosition, a as SemanticSelection } from '../semantic-interaction-unGpRNCk.js';
 export { Block, ColorValue, ContainerRef, ContentControl, ContentControlFilter, ContentControlType, DocAnchor, DocAnchorRange, DocComment, DocLocation, DocRange, DocTarget, DocumentBody, DocxDocument, DocxDocumentJSON, ExecErrorCode, ExecResult, Extent, FontDefinition, HeaderFooterSet, IndentFormatting, NumberingRef, PageMargins, Paragraph, Point, Rect, Revision, RevisionType, Run, RunFormatting, Section, SectionProperties, StyleDefinition, StyleDefinitions, Table, TableCell, TableRow, Theme, ThemeColorScheme, Unsubscribe, Watermark } from './types.js';
 export { f as DrawingHorizontalReferenceFrame, c as DrawingKind, e as DrawingLocks, d as DrawingPositionInput, g as DrawingVerticalReferenceFrame, b as ImageWrapTarget, R as RevisionAddress } from '../tree-op-types-DWLCllG7.js';
 export { I as ImageResourceState, P as PreservedImageMime, R as RenderableImageMime, S as SupportedImageMime, V as ValidatedImageBytesHandle, a as VectorImageMime } from '../image-resources-C_YnqPhn.js';
 import '../ooxml-tree-BU0e3DVi.js';
-import '../semantic-records-zTC0_1zi.js';
+import '../semantic-records-BC4bIKKL.js';
 import '../revision-projection-DHAkcD_L.js';
 import '../ooxml-package-D_CtywTW.js';

package/dist/contracts/editor.js

@@ -1 +1 @@
-export{a as EditorFontError}from'../chunk-REZUWYB7.js';
+export{a as EditorFontError}from'../chunk-GRGRIDHF.js';

package/dist/contracts/interaction.d.cts

@@ -1,11 +1,11 @@
-export { L as EditorScope, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, a8 as SemanticIdentity, a9 as SemanticTarget, V as ViewScope } from '../editor-BGBZn9c9.cjs';
+export { L as EditorScope, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, a9 as SemanticIdentity, aa as SemanticTarget, V as ViewScope } from '../editor-25RmHnxu.cjs';
 import './document.cjs';
 import './types.cjs';
 import '../review-support-rsyGP5-9.cjs';
 import '../ooxml-tree-BU0e3DVi.cjs';
 import '../tree-op-types-UOXlRUqQ.cjs';
-import '../semantic-interaction-DqcEonqD.cjs';
-import '../semantic-records-COVFW5aS.cjs';
+import '../semantic-interaction-B4HrJFQ2.cjs';
+import '../semantic-records-DC6V1U3T.cjs';
+import '../revision-projection-72ZApe-g.cjs';
 import '../image-resources-DwpNnTg3.cjs';
 import '../ooxml-package-CR5us6ad.cjs';
-import '../revision-projection-72ZApe-g.cjs';

package/dist/contracts/interaction.d.ts

@@ -1,11 +1,11 @@
-export { L as EditorScope, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, a8 as SemanticIdentity, a9 as SemanticTarget, V as ViewScope } from '../editor-DQRRxKMG.js';
+export { L as EditorScope, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, a9 as SemanticIdentity, aa as SemanticTarget, V as ViewScope } from '../editor-C8oaTHr3.js';
 import './document.js';
 import './types.js';
 import '../review-support-B9ykYpoZ.js';
 import '../ooxml-tree-BU0e3DVi.js';
 import '../tree-op-types-DWLCllG7.js';
-import '../semantic-interaction-CXH2wFqi.js';
-import '../semantic-records-zTC0_1zi.js';
+import '../semantic-interaction-unGpRNCk.js';
+import '../semantic-records-BC4bIKKL.js';
+import '../revision-projection-DHAkcD_L.js';
 import '../image-resources-C_YnqPhn.js';
 import '../ooxml-package-D_CtywTW.js';
-import '../revision-projection-DHAkcD_L.js';

package/dist/{editor-BGBZn9c9.d.cts → editor-25RmHnxu.d.cts}

@@ -1,6 +1,6 @@
 import { DocEdits, DocQueries, DocQueryResults, ContentControlSummary } from './contracts/document.cjs';
 import { g as ReviewRevisionKind, c as ReviewCommentItem, b as ReviewRevisionItem, d as ReviewCustomItem } from './review-support-rsyGP5-9.cjs';
-import { a as SemanticSelection, S as SemanticPosition } from './semantic-interaction-DqcEonqD.cjs';
+import { a as SemanticSelection, S as SemanticPosition } from './semantic-interaction-B4HrJFQ2.cjs';
 import { ExecErrorCode, ColorValue, Watermark, DocAnchor, ExecResult, ContentControlFilter, DocRange, RunFormatting, Revision, Rect, Unsubscribe } from './contracts/types.cjs';
 import { S as SourceCrop, b as ImageWrapTarget, c as DrawingKind, d as DrawingPositionInput, e as DrawingLocks } from './tree-op-types-UOXlRUqQ.cjs';
 import { S as SupportedImageMime, I as ImageResourceState } from './image-resources-DwpNnTg3.cjs';
@@ -422,6 +422,37 @@ type EditorScope = {
 type ViewScope = Exclude<EditorScope, {
     kind: 'all';
 }>;
+/**
+ * What a fit mode fits the page to.
+ *
+ * One member today. It is a union rather than a boolean because Word's other two — the whole
+ * sheet including its height, and the text column inside the margins — are the same
+ * computation with a different numerator, and a later change adds one without breaking the
+ * shape a host already stores.
+ */
+type ZoomFitTarget = 'pageWidth';
+/**
+ * Where the display scale comes from.
+ *
+ * `fixed` is a number the engine holds until someone changes it. `fit` is a number the engine
+ * recomputes whenever the room beside the page changes — a resized window, an opened comments
+ * rail, a docked navigation pane — bounded by `minZoom`/`maxZoom`.
+ *
+ * The bounds are what make one mode serve both cases. The default, `'auto'`, is this fit
+ * bounded at both ends: it leaves a page that fits at 100%, shrinks one that does not, and
+ * stops at 50% — past which it would be trading a scrollbar nobody minds for a page nobody
+ * can read.
+ */
+type ZoomMode = {
+    readonly type: 'fixed';
+} | {
+    readonly type: 'fit';
+    readonly fit: ZoomFitTarget;
+    /** Never shrink past this. Defaults to the contract floor, 0.1. */
+    readonly minZoom?: number;
+    /** Never grow past this. `1` is the "shrink only" rule. Defaults to the ceiling, 5. */
+    readonly maxZoom?: number;
+};
 /**
  * A selection endpoint, in either vocabulary the engine resolves.
  *
@@ -817,8 +848,27 @@ interface Editor {
     /**
      * Set the display scale. Values outside a sane range are rejected rather than
      * clamped silently, so a caller learns its input was refused.
+     *
+     * Also LEAVES any fit mode: a reader who picks 150% has said what they want, and a
+     * viewport resize must not take it back off them. Call `setZoomMode` to go back.
      */
     setZoom(zoom: number): ExecResult;
+    /** Whether the scale is a number the engine holds, or one it recomputes from the viewport. */
+    getZoomMode(): ZoomMode;
+    /**
+     * Choose between holding a scale and tracking the viewport.
+     *
+     * `'auto'` is the shorthand for {@link ZoomMode}'s bounded page-width fit and the default
+     * for a new editor: a window wide enough for the sheet stays at 100%, and a narrower one
+     * shrinks rather than growing a horizontal scrollbar — down to 50%, past which the page
+     * keeps a legible size and the scrollbar is the better trade. Refused (`invalidArgs`) for a
+     * value that is not a mode, in the same spirit as `setZoom`.
+     *
+     * A fit tracks the scroller's CONTENT box, so anything that reserves width beside the page
+     * — an open comments rail, a docked navigation pane — shrinks the document by exactly what
+     * it took. Nothing else has to be told.
+     */
+    setZoomMode(mode: ZoomMode | 'auto'): ExecResult;
     /** Page boxes in stack coordinates, each with the text area the engine laid out.
      *  `contentBox` is the page inset by the section margin — rulers draw margin zones from
      *  it instead of assuming a default. The engine's margin is uniform on all four sides
@@ -1573,6 +1623,18 @@ interface EditorSnapshot {
      *  read-only document (tables/SDTs/unpreservable) or `mode: 'view'` reports false. */
     readonly editable: boolean;
     readonly zoom: number;
+    /**
+     * Where {@link EditorSnapshot.zoom} came from.
+     *
+     * Both are needed, and neither implies the other: `zoom` is the resolved scale a ruler
+     * multiplies by, `zoomMode` is what a zoom control has to show as selected. A menu that
+     * ticked the entry matching the percentage would tick "75%" while the editor was tracking
+     * the viewport and about to move off it.
+     *
+     * Optional and additive like `pageSetup`; absent means the implementation has not derived
+     * it, and a consumer reads absent as a plain fixed scale.
+     */
+    readonly zoomMode?: ZoomMode;
     readonly selection: DocRange | null;
     /**
      * Whether the selection is a CARET rather than a range. `true` when nothing is loaded.
@@ -1726,4 +1788,4 @@ interface EditorEvents {
     error: (error: EditorError) => void;
 }
 
-export { type PageSetup as $, type AuthoredNoteNumbering as A, type EditorNoteCommands as B, type CanResult as C, type DocumentSource as D, EditorFontError as E, type FontConfiguration as F, type EditorPosition as G, type EditorQueries as H, type ImageContext as I, type EditorQuery as J, type EditorQueryResults as K, type EditorScope as L, type EditorSelection as M, type EditorSnapshot as N, type FurnitureVariant as O, type HeaderFooterSlotArgs as P, type HeaderFooterState as Q, type HyperlinkInfo as R, type SelectedImageState as S, type TableBorderEdgeTarget as T, type InteractionAffinity as U, type ViewScope as V, type InteractionOutcome as W, type InteractionOutcomeCode as X, type NoteKind as Y, type NotePropertiesSide as Z, type NotePropertiesState as _, type EditorCommand as a, type ResolvedNoteNumbering as a0, type ReviewActivationOptions as a1, type ReviewCommentPlacement as a2, type ReviewCustomPlacement as a3, type ReviewItemPlacement as a4, type ReviewItemPlacementBase as a5, type ReviewItemQuery as a6, type ReviewRevisionPlacement as a7, type SemanticIdentity as a8, type SemanticTarget as a9, type TableBorderTarget as aa, type TableCellVerticalAlignment as ab, type TableColumnDividerResizeTarget as ac, type TableColumnOccurrenceTarget as ad, type TableRightEdgeResizeTarget as ae, type TableRowOccurrenceTarget as af, type TextMatch as ag, type ImageCropPercent as b, type ImageCropPermille as c, cropPercentFromCropPermille as d, cropPercentFromPermille as e, cropPercentFromSourceCrop as f, cropPermilleFromCropPercent as g, cropPermilleFromPercent as h, type FontSource as i, type FontSourceSubstitution as j, type FontFaceRequest as k, type Editor as l, type TableBorderSpec as m, type TableBorderStyle as n, type TableContext as o, type DocumentChange as p, type DocumentEditingMode as q, type DocumentHandle as r, sourceCropFromCropPercent as s, type EditorCommandShape as t, type EditorCommands as u, validateImageCropPercent as v, type EditorError as w, type EditorEvents as x, type EditorFontErrorCode as y, type EditorHeaderFooterCommands as z };
+export { type NotePropertiesState as $, type AuthoredNoteNumbering as A, type EditorNoteCommands as B, type CanResult as C, type DocumentSource as D, EditorFontError as E, type FontConfiguration as F, type EditorPosition as G, type EditorQueries as H, type ImageContext as I, type EditorQuery as J, type EditorQueryResults as K, type EditorScope as L, type EditorSelection as M, type EditorSnapshot as N, type FurnitureVariant as O, type HeaderFooterSlotArgs as P, type HeaderFooterState as Q, type HyperlinkInfo as R, type SelectedImageState as S, type TableBorderEdgeTarget as T, type InteractionAffinity as U, type ViewScope as V, type InteractionOutcome as W, type InteractionOutcomeCode as X, type NoteKind as Y, type ZoomMode as Z, type NotePropertiesSide as _, type EditorCommand as a, type PageSetup as a0, type ResolvedNoteNumbering as a1, type ReviewActivationOptions as a2, type ReviewCommentPlacement as a3, type ReviewCustomPlacement as a4, type ReviewItemPlacement as a5, type ReviewItemPlacementBase as a6, type ReviewItemQuery as a7, type ReviewRevisionPlacement as a8, type SemanticIdentity as a9, type SemanticTarget as aa, type TableBorderTarget as ab, type TableCellVerticalAlignment as ac, type TableColumnDividerResizeTarget as ad, type TableColumnOccurrenceTarget as ae, type TableRightEdgeResizeTarget as af, type TableRowOccurrenceTarget as ag, type TextMatch as ah, type ZoomFitTarget as ai, type ImageCropPercent as b, type ImageCropPermille as c, cropPercentFromCropPermille as d, cropPercentFromPermille as e, cropPercentFromSourceCrop as f, cropPermilleFromCropPercent as g, cropPermilleFromPercent as h, type FontSource as i, type FontSourceSubstitution as j, type FontFaceRequest as k, type Editor as l, type TableBorderSpec as m, type TableBorderStyle as n, type TableContext as o, type DocumentChange as p, type DocumentEditingMode as q, type DocumentHandle as r, sourceCropFromCropPercent as s, type EditorCommandShape as t, type EditorCommands as u, validateImageCropPercent as v, type EditorError as w, type EditorEvents as x, type EditorFontErrorCode as y, type EditorHeaderFooterCommands as z };

package/dist/{editor-DQRRxKMG.d.ts → editor-C8oaTHr3.d.ts}

@@ -1,6 +1,6 @@
 import { DocEdits, DocQueries, DocQueryResults, ContentControlSummary } from './contracts/document.js';
 import { g as ReviewRevisionKind, c as ReviewCommentItem, b as ReviewRevisionItem, d as ReviewCustomItem } from './review-support-B9ykYpoZ.js';
-import { a as SemanticSelection, S as SemanticPosition } from './semantic-interaction-CXH2wFqi.js';
+import { a as SemanticSelection, S as SemanticPosition } from './semantic-interaction-unGpRNCk.js';
 import { ExecErrorCode, ColorValue, Watermark, DocAnchor, ExecResult, ContentControlFilter, DocRange, RunFormatting, Revision, Rect, Unsubscribe } from './contracts/types.js';
 import { S as SourceCrop, b as ImageWrapTarget, c as DrawingKind, d as DrawingPositionInput, e as DrawingLocks } from './tree-op-types-DWLCllG7.js';
 import { S as SupportedImageMime, I as ImageResourceState } from './image-resources-C_YnqPhn.js';
@@ -422,6 +422,37 @@ type EditorScope = {
 type ViewScope = Exclude<EditorScope, {
     kind: 'all';
 }>;
+/**
+ * What a fit mode fits the page to.
+ *
+ * One member today. It is a union rather than a boolean because Word's other two — the whole
+ * sheet including its height, and the text column inside the margins — are the same
+ * computation with a different numerator, and a later change adds one without breaking the
+ * shape a host already stores.
+ */
+type ZoomFitTarget = 'pageWidth';
+/**
+ * Where the display scale comes from.
+ *
+ * `fixed` is a number the engine holds until someone changes it. `fit` is a number the engine
+ * recomputes whenever the room beside the page changes — a resized window, an opened comments
+ * rail, a docked navigation pane — bounded by `minZoom`/`maxZoom`.
+ *
+ * The bounds are what make one mode serve both cases. The default, `'auto'`, is this fit
+ * bounded at both ends: it leaves a page that fits at 100%, shrinks one that does not, and
+ * stops at 50% — past which it would be trading a scrollbar nobody minds for a page nobody
+ * can read.
+ */
+type ZoomMode = {
+    readonly type: 'fixed';
+} | {
+    readonly type: 'fit';
+    readonly fit: ZoomFitTarget;
+    /** Never shrink past this. Defaults to the contract floor, 0.1. */
+    readonly minZoom?: number;
+    /** Never grow past this. `1` is the "shrink only" rule. Defaults to the ceiling, 5. */
+    readonly maxZoom?: number;
+};
 /**
  * A selection endpoint, in either vocabulary the engine resolves.
  *
@@ -817,8 +848,27 @@ interface Editor {
     /**
      * Set the display scale. Values outside a sane range are rejected rather than
      * clamped silently, so a caller learns its input was refused.
+     *
+     * Also LEAVES any fit mode: a reader who picks 150% has said what they want, and a
+     * viewport resize must not take it back off them. Call `setZoomMode` to go back.
      */
     setZoom(zoom: number): ExecResult;
+    /** Whether the scale is a number the engine holds, or one it recomputes from the viewport. */
+    getZoomMode(): ZoomMode;
+    /**
+     * Choose between holding a scale and tracking the viewport.
+     *
+     * `'auto'` is the shorthand for {@link ZoomMode}'s bounded page-width fit and the default
+     * for a new editor: a window wide enough for the sheet stays at 100%, and a narrower one
+     * shrinks rather than growing a horizontal scrollbar — down to 50%, past which the page
+     * keeps a legible size and the scrollbar is the better trade. Refused (`invalidArgs`) for a
+     * value that is not a mode, in the same spirit as `setZoom`.
+     *
+     * A fit tracks the scroller's CONTENT box, so anything that reserves width beside the page
+     * — an open comments rail, a docked navigation pane — shrinks the document by exactly what
+     * it took. Nothing else has to be told.
+     */
+    setZoomMode(mode: ZoomMode | 'auto'): ExecResult;
     /** Page boxes in stack coordinates, each with the text area the engine laid out.
      *  `contentBox` is the page inset by the section margin — rulers draw margin zones from
      *  it instead of assuming a default. The engine's margin is uniform on all four sides
@@ -1573,6 +1623,18 @@ interface EditorSnapshot {
      *  read-only document (tables/SDTs/unpreservable) or `mode: 'view'` reports false. */
     readonly editable: boolean;
     readonly zoom: number;
+    /**
+     * Where {@link EditorSnapshot.zoom} came from.
+     *
+     * Both are needed, and neither implies the other: `zoom` is the resolved scale a ruler
+     * multiplies by, `zoomMode` is what a zoom control has to show as selected. A menu that
+     * ticked the entry matching the percentage would tick "75%" while the editor was tracking
+     * the viewport and about to move off it.
+     *
+     * Optional and additive like `pageSetup`; absent means the implementation has not derived
+     * it, and a consumer reads absent as a plain fixed scale.
+     */
+    readonly zoomMode?: ZoomMode;
     readonly selection: DocRange | null;
     /**
      * Whether the selection is a CARET rather than a range. `true` when nothing is loaded.
@@ -1726,4 +1788,4 @@ interface EditorEvents {
     error: (error: EditorError) => void;
 }
 
-export { type PageSetup as $, type AuthoredNoteNumbering as A, type EditorNoteCommands as B, type CanResult as C, type DocumentSource as D, EditorFontError as E, type FontConfiguration as F, type EditorPosition as G, type EditorQueries as H, type ImageContext as I, type EditorQuery as J, type EditorQueryResults as K, type EditorScope as L, type EditorSelection as M, type EditorSnapshot as N, type FurnitureVariant as O, type HeaderFooterSlotArgs as P, type HeaderFooterState as Q, type HyperlinkInfo as R, type SelectedImageState as S, type TableBorderEdgeTarget as T, type InteractionAffinity as U, type ViewScope as V, type InteractionOutcome as W, type InteractionOutcomeCode as X, type NoteKind as Y, type NotePropertiesSide as Z, type NotePropertiesState as _, type EditorCommand as a, type ResolvedNoteNumbering as a0, type ReviewActivationOptions as a1, type ReviewCommentPlacement as a2, type ReviewCustomPlacement as a3, type ReviewItemPlacement as a4, type ReviewItemPlacementBase as a5, type ReviewItemQuery as a6, type ReviewRevisionPlacement as a7, type SemanticIdentity as a8, type SemanticTarget as a9, type TableBorderTarget as aa, type TableCellVerticalAlignment as ab, type TableColumnDividerResizeTarget as ac, type TableColumnOccurrenceTarget as ad, type TableRightEdgeResizeTarget as ae, type TableRowOccurrenceTarget as af, type TextMatch as ag, type ImageCropPercent as b, type ImageCropPermille as c, cropPercentFromCropPermille as d, cropPercentFromPermille as e, cropPercentFromSourceCrop as f, cropPermilleFromCropPercent as g, cropPermilleFromPercent as h, type FontSource as i, type FontSourceSubstitution as j, type FontFaceRequest as k, type Editor as l, type TableBorderSpec as m, type TableBorderStyle as n, type TableContext as o, type DocumentChange as p, type DocumentEditingMode as q, type DocumentHandle as r, sourceCropFromCropPercent as s, type EditorCommandShape as t, type EditorCommands as u, validateImageCropPercent as v, type EditorError as w, type EditorEvents as x, type EditorFontErrorCode as y, type EditorHeaderFooterCommands as z };
+export { type NotePropertiesState as $, type AuthoredNoteNumbering as A, type EditorNoteCommands as B, type CanResult as C, type DocumentSource as D, EditorFontError as E, type FontConfiguration as F, type EditorPosition as G, type EditorQueries as H, type ImageContext as I, type EditorQuery as J, type EditorQueryResults as K, type EditorScope as L, type EditorSelection as M, type EditorSnapshot as N, type FurnitureVariant as O, type HeaderFooterSlotArgs as P, type HeaderFooterState as Q, type HyperlinkInfo as R, type SelectedImageState as S, type TableBorderEdgeTarget as T, type InteractionAffinity as U, type ViewScope as V, type InteractionOutcome as W, type InteractionOutcomeCode as X, type NoteKind as Y, type ZoomMode as Z, type NotePropertiesSide as _, type EditorCommand as a, type PageSetup as a0, type ResolvedNoteNumbering as a1, type ReviewActivationOptions as a2, type ReviewCommentPlacement as a3, type ReviewCustomPlacement as a4, type ReviewItemPlacement as a5, type ReviewItemPlacementBase as a6, type ReviewItemQuery as a7, type ReviewRevisionPlacement as a8, type SemanticIdentity as a9, type SemanticTarget as aa, type TableBorderTarget as ab, type TableCellVerticalAlignment as ac, type TableColumnDividerResizeTarget as ad, type TableColumnOccurrenceTarget as ae, type TableRightEdgeResizeTarget as af, type TableRowOccurrenceTarget as ag, type TextMatch as ah, type ZoomFitTarget as ai, type ImageCropPercent as b, type ImageCropPermille as c, cropPercentFromCropPermille as d, cropPercentFromPermille as e, cropPercentFromSourceCrop as f, cropPermilleFromCropPercent as g, cropPermilleFromPercent as h, type FontSource as i, type FontSourceSubstitution as j, type FontFaceRequest as k, type Editor as l, type TableBorderSpec as m, type TableBorderStyle as n, type TableContext as o, type DocumentChange as p, type DocumentEditingMode as q, type DocumentHandle as r, sourceCropFromCropPercent as s, type EditorCommandShape as t, type EditorCommands as u, validateImageCropPercent as v, type EditorError as w, type EditorEvents as x, type EditorFontErrorCode as y, type EditorHeaderFooterCommands as z };

package/dist/editor.cjs

@@ -1 +1 @@
-'use strict';var chunkEDLUMMQN_cjs=require('./chunk-EDLUMMQN.cjs');require('./chunk-3JKQE4QJ.cjs'),require('./chunk-TSXT537P.cjs'),require('./chunk-PC76F2HR.cjs'),require('./chunk-O2WQY7IT.cjs'),require('./chunk-BS554B6D.cjs'),require('./chunk-JQFDLZXQ.cjs');var chunkBZK64YU3_cjs=require('./chunk-BZK64YU3.cjs');require('./chunk-HBL3NNH5.cjs');var chunk7VQ7YLW3_cjs=require('./chunk-7VQ7YLW3.cjs');Object.defineProperty(exports,"BROWSER_AUTOMATION_CAPABILITIES",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.Da}});Object.defineProperty(exports,"CHROME_GROUPS",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.sa}});Object.defineProperty(exports,"CHROME_MENUS",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.wa}});Object.defineProperty(exports,"CHROME_UNAVAILABLE_KEY",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.za}});Object.defineProperty(exports,"DEFAULT_TABLE_CHROME_DRAFT",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.W}});Object.defineProperty(exports,"EMU_PER_POINT",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.O}});Object.defineProperty(exports,"IMAGE_OVERLAY_NUDGE_PT",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.M}});Object.defineProperty(exports,"IMAGE_OVERLAY_NUDGE_SHIFT_PT",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.N}});Object.defineProperty(exports,"MAX_RESOLVER_FAMILIES",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.d}});Object.defineProperty(exports,"PX_PER_CM",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.k}});Object.defineProperty(exports,"PX_PER_INCH",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.j}});Object.defineProperty(exports,"SNAP_TWIPS_CM",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.q}});Object.defineProperty(exports,"SNAP_TWIPS_INCH",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.p}});Object.defineProperty(exports,"TABLE_BORDER_STYLE_OPTIONS",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.aa}});Object.defineProperty(exports,"TABLE_BORDER_TARGET_OPTIONS",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.$}});Object.defineProperty(exports,"TABLE_BORDER_WIDTH_OPTIONS",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.ba}});Object.defineProperty(exports,"TABLE_CHROME_SLOT_IDS",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.X}});Object.defineProperty(exports,"TWIPS_PER_CM",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.o}});Object.defineProperty(exports,"TWIPS_PER_INCH",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.n}});Object.defineProperty(exports,"WORD_DEFAULT_FONT",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.e}});Object.defineProperty(exports,"applyTableChromePick",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.ca}});Object.defineProperty(exports,"applyThemeShade",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.w}});Object.defineProperty(exports,"applyThemeTint",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.v}});Object.defineProperty(exports,"blankDocumentBytes",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.g}});Object.defineProperty(exports,"canExecuteImageCommand",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.K}});Object.defineProperty(exports,"captureImageMutationPreconditions",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.J}});Object.defineProperty(exports,"chromeControlCount",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.ya}});Object.defineProperty(exports,"chromeMenuSlots",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.xa}});Object.defineProperty(exports,"chromeProbeForSlot",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.ga}});Object.defineProperty(exports,"chromeSlotId",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.ta}});Object.defineProperty(exports,"commandForSlot",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.ha}});Object.defineProperty(exports,"commandForSlotValue",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.ja}});Object.defineProperty(exports,"commandForTableChromeSlotValue",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.ia}});Object.defineProperty(exports,"composeFontConfiguration",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.f}});Object.defineProperty(exports,"computeImageResizeResult",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.Ka}});Object.defineProperty(exports,"computeMovedImagePosition",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.T}});Object.defineProperty(exports,"computeResizedImageExtentEmu",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.S}});Object.defineProperty(exports,"createBrowserAutomationHost",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.Ea}});Object.defineProperty(exports,"createDocxEditor",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.Ca}});Object.defineProperty(exports,"createFontSource",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.i}});Object.defineProperty(exports,"createImageOverlayScrollPort",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.La}});Object.defineProperty(exports,"createLayoutShaping",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.b}});Object.defineProperty(exports,"cropPercentFromCropPermille",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.G}});Object.defineProperty(exports,"cropPercentFromPermille",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.E}});Object.defineProperty(exports,"cropPercentFromSourceCrop",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.B}});Object.defineProperty(exports,"cropPermilleFromCropPercent",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.F}});Object.defineProperty(exports,"cropPermilleFromPercent",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.D}});Object.defineProperty(exports,"cssPixelsToLayoutPoints",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.Ha}});Object.defineProperty(exports,"defaultChromeGroups",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.ua}});Object.defineProperty(exports,"defaultTableLabel",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.Y}});Object.defineProperty(exports,"disposeLayoutShaping",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.c}});Object.defineProperty(exports,"dragIndent",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.t}});Object.defineProperty(exports,"emuToOverlayPoints",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.R}});Object.defineProperty(exports,"executeImageCommand",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.L}});Object.defineProperty(exports,"finalizeImageOverlayInteraction",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.Ma}});Object.defineProperty(exports,"formattingBarChromeGroups",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.va}});Object.defineProperty(exports,"generateRulerTicks",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.l}});Object.defineProperty(exports,"handlePosition",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.r}});Object.defineProperty(exports,"isStaleImageInteractionCommit",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.U}});Object.defineProperty(exports,"isTableChromeSlot",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.Z}});Object.defineProperty(exports,"layoutPointsToCssPixels",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.Ga}});Object.defineProperty(exports,"loadFonts",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.h}});Object.defineProperty(exports,"lowerColorValueForBorder",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.y}});Object.defineProperty(exports,"lowerColorValueForFill",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.z}});Object.defineProperty(exports,"mountPaginatedSurface",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.Ba}});Object.defineProperty(exports,"overlayFrameToSheetCssPixels",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.Ia}});Object.defineProperty(exports,"pointsToEmu",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.Q}});Object.defineProperty(exports,"probeTableChromeCommand",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.da}});Object.defineProperty(exports,"resizePreservesAspect",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.Ja}});Object.defineProperty(exports,"resolveColorValueToCss",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.A}});Object.defineProperty(exports,"resolveThemeColorHex",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.x}});Object.defineProperty(exports,"rulerPageBox",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.m}});Object.defineProperty(exports,"runSave",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.pa}});Object.defineProperty(exports,"runTableChromeCommand",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.na}});Object.defineProperty(exports,"runTableCommand",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.ra}});Object.defineProperty(exports,"runToolbarCommand",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.oa}});Object.defineProperty(exports,"selectedDrawingOverlayTargetOf",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.P}});Object.defineProperty(exports,"selectedImageStateOf",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.I}});Object.defineProperty(exports,"snapTwips",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.s}});Object.defineProperty(exports,"sourceCropFromCropPercent",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.C}});Object.defineProperty(exports,"surfaceExtent",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.Aa}});Object.defineProperty(exports,"surfacePaintScale",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.Fa}});Object.defineProperty(exports,"tableChromeIconPaths",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.fa}});Object.defineProperty(exports,"tableChromeLabelKeyForTarget",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.ea}});Object.defineProperty(exports,"tableChromeToolbarState",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.ka}});Object.defineProperty(exports,"tableChromeVisible",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs._}});Object.defineProperty(exports,"tableCommandState",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.V}});Object.defineProperty(exports,"tableCommandToolbarState",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.qa}});Object.defineProperty(exports,"toEditorFontError",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.a}});Object.defineProperty(exports,"toolbarCommandState",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.la}});Object.defineProperty(exports,"toolbarCommandStates",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.ma}});Object.defineProperty(exports,"validateImageCropPercent",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.H}});Object.defineProperty(exports,"validateThemeModifier",{enumerable:true,get:function(){return chunkEDLUMMQN_cjs.u}});Object.defineProperty(exports,"DEFAULT_IMAGE_RESOURCE_LIMITS",{enumerable:true,get:function(){return chunkBZK64YU3_cjs.D}});Object.defineProperty(exports,"DRAWING_REL_FROM_H",{enumerable:true,get:function(){return chunkBZK64YU3_cjs.lf}});Object.defineProperty(exports,"DRAWING_REL_FROM_V",{enumerable:true,get:function(){return chunkBZK64YU3_cjs.mf}});Object.defineProperty(exports,"IMAGE_WRAP_TARGETS",{enumerable:true,get:function(){return chunkBZK64YU3_cjs.Wa}});Object.defineProperty(exports,"positionInputFromPropertiesCommand",{enumerable:true,get:function(){return chunkBZK64YU3_cjs.of}});Object.defineProperty(exports,"propertiesCommandHasPositionFields",{enumerable:true,get:function(){return chunkBZK64YU3_cjs.nf}});Object.defineProperty(exports,"resolveImageResourceLimits",{enumerable:true,get:function(){return chunkBZK64YU3_cjs.E}});Object.defineProperty(exports,"resolveSvgIntrinsicSize",{enumerable:true,get:function(){return chunkBZK64YU3_cjs.mb}});Object.defineProperty(exports,"sniffImageMime",{enumerable:true,get:function(){return chunkBZK64YU3_cjs.ib}});Object.defineProperty(exports,"validateDrawingPositionInput",{enumerable:true,get:function(){return chunkBZK64YU3_cjs.kf}});Object.defineProperty(exports,"validateRasterHeader",{enumerable:true,get:function(){return chunkBZK64YU3_cjs.nb}});Object.defineProperty(exports,"validateSetImagePositionCommand",{enumerable:true,get:function(){return chunkBZK64YU3_cjs.pf}});Object.defineProperty(exports,"resolveEditorModules",{enumerable:true,get:function(){return chunk7VQ7YLW3_cjs.a}});
+'use strict';var chunkFJCBZ5BL_cjs=require('./chunk-FJCBZ5BL.cjs');require('./chunk-EUTHPVTG.cjs'),require('./chunk-VXEF32A5.cjs'),require('./chunk-KZ5HPHW6.cjs'),require('./chunk-CY47CFM5.cjs'),require('./chunk-BS554B6D.cjs'),require('./chunk-T2LVH6D3.cjs');var chunkUAOJHPQ4_cjs=require('./chunk-UAOJHPQ4.cjs');require('./chunk-MIUELYVA.cjs');var chunk7VQ7YLW3_cjs=require('./chunk-7VQ7YLW3.cjs');Object.defineProperty(exports,"AUTO_ZOOM_MODE",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Ea}});Object.defineProperty(exports,"BROWSER_AUTOMATION_CAPABILITIES",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Ja}});Object.defineProperty(exports,"CHROME_GROUPS",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.sa}});Object.defineProperty(exports,"CHROME_MENUS",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.wa}});Object.defineProperty(exports,"CHROME_UNAVAILABLE_KEY",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.za}});Object.defineProperty(exports,"DEFAULT_TABLE_CHROME_DRAFT",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.W}});Object.defineProperty(exports,"EMU_PER_POINT",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.O}});Object.defineProperty(exports,"FIT_WIDTH_ZOOM_MODE",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Fa}});Object.defineProperty(exports,"IMAGE_OVERLAY_NUDGE_PT",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.M}});Object.defineProperty(exports,"IMAGE_OVERLAY_NUDGE_SHIFT_PT",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.N}});Object.defineProperty(exports,"MAX_RESOLVER_FAMILIES",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.d}});Object.defineProperty(exports,"PX_PER_CM",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.k}});Object.defineProperty(exports,"PX_PER_INCH",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.j}});Object.defineProperty(exports,"SNAP_TWIPS_CM",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.q}});Object.defineProperty(exports,"SNAP_TWIPS_INCH",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.p}});Object.defineProperty(exports,"TABLE_BORDER_STYLE_OPTIONS",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.aa}});Object.defineProperty(exports,"TABLE_BORDER_TARGET_OPTIONS",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.$}});Object.defineProperty(exports,"TABLE_BORDER_WIDTH_OPTIONS",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.ba}});Object.defineProperty(exports,"TABLE_CHROME_SLOT_IDS",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.X}});Object.defineProperty(exports,"TWIPS_PER_CM",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.o}});Object.defineProperty(exports,"TWIPS_PER_INCH",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.n}});Object.defineProperty(exports,"WORD_DEFAULT_FONT",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.e}});Object.defineProperty(exports,"ZOOM_MAX",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Da}});Object.defineProperty(exports,"ZOOM_MIN",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Ca}});Object.defineProperty(exports,"applyTableChromePick",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.ca}});Object.defineProperty(exports,"applyThemeShade",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.w}});Object.defineProperty(exports,"applyThemeTint",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.v}});Object.defineProperty(exports,"blankDocumentBytes",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.g}});Object.defineProperty(exports,"canExecuteImageCommand",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.K}});Object.defineProperty(exports,"captureImageMutationPreconditions",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.J}});Object.defineProperty(exports,"chromeControlCount",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.ya}});Object.defineProperty(exports,"chromeMenuSlots",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.xa}});Object.defineProperty(exports,"chromeProbeForSlot",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.ga}});Object.defineProperty(exports,"chromeSlotId",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.ta}});Object.defineProperty(exports,"commandForSlot",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.ha}});Object.defineProperty(exports,"commandForSlotValue",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.ja}});Object.defineProperty(exports,"commandForTableChromeSlotValue",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.ia}});Object.defineProperty(exports,"composeFontConfiguration",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.f}});Object.defineProperty(exports,"computeImageResizeResult",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Qa}});Object.defineProperty(exports,"computeMovedImagePosition",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.T}});Object.defineProperty(exports,"computeResizedImageExtentEmu",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.S}});Object.defineProperty(exports,"createBrowserAutomationHost",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Ka}});Object.defineProperty(exports,"createDocxEditor",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Ia}});Object.defineProperty(exports,"createFontSource",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.i}});Object.defineProperty(exports,"createImageOverlayScrollPort",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Ra}});Object.defineProperty(exports,"createLayoutShaping",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.b}});Object.defineProperty(exports,"cropPercentFromCropPermille",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.G}});Object.defineProperty(exports,"cropPercentFromPermille",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.E}});Object.defineProperty(exports,"cropPercentFromSourceCrop",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.B}});Object.defineProperty(exports,"cropPermilleFromCropPercent",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.F}});Object.defineProperty(exports,"cropPermilleFromPercent",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.D}});Object.defineProperty(exports,"cssPixelsToLayoutPoints",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Na}});Object.defineProperty(exports,"defaultChromeGroups",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.ua}});Object.defineProperty(exports,"defaultTableLabel",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Y}});Object.defineProperty(exports,"disposeLayoutShaping",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.c}});Object.defineProperty(exports,"dragIndent",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.t}});Object.defineProperty(exports,"emuToOverlayPoints",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.R}});Object.defineProperty(exports,"executeImageCommand",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.L}});Object.defineProperty(exports,"finalizeImageOverlayInteraction",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Sa}});Object.defineProperty(exports,"formattingBarChromeGroups",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.va}});Object.defineProperty(exports,"generateRulerTicks",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.l}});Object.defineProperty(exports,"handlePosition",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.r}});Object.defineProperty(exports,"isStaleImageInteractionCommit",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.U}});Object.defineProperty(exports,"isTableChromeSlot",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Z}});Object.defineProperty(exports,"layoutPointsToCssPixels",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Ma}});Object.defineProperty(exports,"loadFonts",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.h}});Object.defineProperty(exports,"lowerColorValueForBorder",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.y}});Object.defineProperty(exports,"lowerColorValueForFill",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.z}});Object.defineProperty(exports,"mountPaginatedSurface",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Ba}});Object.defineProperty(exports,"overlayFrameToSheetCssPixels",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Oa}});Object.defineProperty(exports,"pointsToEmu",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Q}});Object.defineProperty(exports,"probeTableChromeCommand",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.da}});Object.defineProperty(exports,"resizePreservesAspect",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Pa}});Object.defineProperty(exports,"resolveColorValueToCss",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.A}});Object.defineProperty(exports,"resolveThemeColorHex",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.x}});Object.defineProperty(exports,"resolveZoomMode",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Ga}});Object.defineProperty(exports,"rulerPageBox",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.m}});Object.defineProperty(exports,"runSave",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.pa}});Object.defineProperty(exports,"runTableChromeCommand",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.na}});Object.defineProperty(exports,"runTableCommand",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.ra}});Object.defineProperty(exports,"runToolbarCommand",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.oa}});Object.defineProperty(exports,"sameZoomMode",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Ha}});Object.defineProperty(exports,"selectedDrawingOverlayTargetOf",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.P}});Object.defineProperty(exports,"selectedImageStateOf",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.I}});Object.defineProperty(exports,"snapTwips",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.s}});Object.defineProperty(exports,"sourceCropFromCropPercent",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.C}});Object.defineProperty(exports,"surfaceExtent",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.Aa}});Object.defineProperty(exports,"surfacePaintScale",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.La}});Object.defineProperty(exports,"tableChromeIconPaths",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.fa}});Object.defineProperty(exports,"tableChromeLabelKeyForTarget",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.ea}});Object.defineProperty(exports,"tableChromeToolbarState",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.ka}});Object.defineProperty(exports,"tableChromeVisible",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs._}});Object.defineProperty(exports,"tableCommandState",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.V}});Object.defineProperty(exports,"tableCommandToolbarState",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.qa}});Object.defineProperty(exports,"toEditorFontError",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.a}});Object.defineProperty(exports,"toolbarCommandState",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.la}});Object.defineProperty(exports,"toolbarCommandStates",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.ma}});Object.defineProperty(exports,"validateImageCropPercent",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.H}});Object.defineProperty(exports,"validateThemeModifier",{enumerable:true,get:function(){return chunkFJCBZ5BL_cjs.u}});Object.defineProperty(exports,"DEFAULT_IMAGE_RESOURCE_LIMITS",{enumerable:true,get:function(){return chunkUAOJHPQ4_cjs.D}});Object.defineProperty(exports,"DRAWING_REL_FROM_H",{enumerable:true,get:function(){return chunkUAOJHPQ4_cjs.nf}});Object.defineProperty(exports,"DRAWING_REL_FROM_V",{enumerable:true,get:function(){return chunkUAOJHPQ4_cjs.of}});Object.defineProperty(exports,"IMAGE_WRAP_TARGETS",{enumerable:true,get:function(){return chunkUAOJHPQ4_cjs.Wa}});Object.defineProperty(exports,"positionInputFromPropertiesCommand",{enumerable:true,get:function(){return chunkUAOJHPQ4_cjs.qf}});Object.defineProperty(exports,"propertiesCommandHasPositionFields",{enumerable:true,get:function(){return chunkUAOJHPQ4_cjs.pf}});Object.defineProperty(exports,"resolveImageResourceLimits",{enumerable:true,get:function(){return chunkUAOJHPQ4_cjs.E}});Object.defineProperty(exports,"resolveSvgIntrinsicSize",{enumerable:true,get:function(){return chunkUAOJHPQ4_cjs.mb}});Object.defineProperty(exports,"sniffImageMime",{enumerable:true,get:function(){return chunkUAOJHPQ4_cjs.ib}});Object.defineProperty(exports,"validateDrawingPositionInput",{enumerable:true,get:function(){return chunkUAOJHPQ4_cjs.mf}});Object.defineProperty(exports,"validateRasterHeader",{enumerable:true,get:function(){return chunkUAOJHPQ4_cjs.nb}});Object.defineProperty(exports,"validateSetImagePositionCommand",{enumerable:true,get:function(){return chunkUAOJHPQ4_cjs.rf}});Object.defineProperty(exports,"resolveEditorModules",{enumerable:true,get:function(){return chunk7VQ7YLW3_cjs.a}});

package/dist/editor.css

@@ -8,7 +8,7 @@
   --tw-scale-y: 1;
 }
 
-.docx-editor :is(.shadow-lg), .docx-editor :is(.shadow-sm) {
+.docx-editor :is(.shadow), .docx-editor :is(.shadow-lg), .docx-editor :is(.shadow-sm) {
   --tw-ring-offset-shadow: 0 0 #0000;
   --tw-ring-shadow: 0 0 #0000;
   --tw-shadow: 0 0 #0000;
@@ -336,6 +336,10 @@
   flex-shrink: 0;
 }
 
+.docx-editor .grow {
+  flex-grow: 1;
+}
+
 .docx-editor .transform {
   transform: translate(var(--tw-translate-x), var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y));
 }
@@ -711,6 +715,12 @@
   opacity: 0.5;
 }
 
+.docx-editor .shadow {
+  --tw-shadow: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);
+  --tw-shadow-colored: 0 1px 3px 0 var(--tw-shadow-color), 0 1px 2px -1px var(--tw-shadow-color);
+  box-shadow: var(--tw-ring-offset-shadow, 0 0 #0000), var(--tw-ring-shadow, 0 0 #0000), var(--tw-shadow);
+}
+
 .docx-editor .shadow-lg {
   --tw-shadow: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
   --tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);
@@ -787,6 +797,10 @@
   }
 }
 
+.docx-editor .zoom-out {
+  --tw-exit-scale: 0;
+}
+
 .docx-editor .duration-150 {
   animation-duration: 150ms;
 }
@@ -913,6 +927,11 @@
      clearly deeper colour. Keep the two pairs in step — this is the faint end of that ramp. */
   --doc-revision-insertion-wash: rgba(46, 125, 50, 0.05);
   --doc-revision-deletion-wash: rgba(198, 40, 40, 0.05);
+  /* The grey block behind a FIELD's result — Word's field shading. It says the text was
+     computed rather than typed, which is the whole message, so it is a flat neutral and not
+     part of the revision ramp: a field is not a pending decision. Kept light enough that a
+     contents page dense with them still reads as text. Never printed. */
+  --doc-field-shading: rgba(0, 0, 0, 0.09);
   /* A tracked FORMAT change: the words are unchanged, so it takes neither the insertion nor
      the deletion colour — grey says "the appearance is the decision". The wash plus a faint
      dotted rule make the range findable (it is the hover balloon's target); both are quiet
@@ -1246,10 +1265,19 @@
   scrollbar-color: var(--doc-scrollbar-thumb) var(--doc-scrollbar-track);
 }
 
-.docx-editor .docx-editor__scroll-container {
+/* Descendant AND self: `DocxEditor.Viewport` puts `docx-editor` on the scroll container
+   itself when no ancestor is scoped (the Root + Viewport composition), and the descendant
+   combinator alone misses that element. */
+.docx-editor .docx-editor__scroll-container,
+.docx-editor.docx-editor__scroll-container {
   /* `both-edges` reserves a symmetric gutter so the centered page stays centered
       on classic-scrollbar platforms (single-edge nudges it ~7px left). Matches
-      the Vue viewport (DocxEditor.css `__pages-viewport`). */
+      the Vue viewport (DocxEditor.css `__pages-viewport`).
+
+      LOAD-BEARING for fit-to-viewport zoom as well as centring: the fit measures this
+      element's content box, and without a reserved gutter, fitting a document down far
+      enough to remove the vertical scrollbar widens that box, which fits larger, which
+      brings the scrollbar back. */
   scrollbar-gutter: stable both-edges;
 }
 
@@ -2840,6 +2868,32 @@ a.docx-hyperlink:focus-visible {
   background-color: var(--doc-revision-deletion-wash);
 }
 
+/* FIELD SHADING — the grey block Word draws behind computed text (a page number, a
+   cross-reference, the blank in a form). It marks where text came from, not what it says.
+
+   A stylesheet rule rather than painter inline style, for the same reason the format-change
+   marking is: a revision wash arrives as inline style and so WINS here, which is the ordering
+   we want. A deleted field must read as deleted first — the strike and its colour are the
+   pending decision; the shading is only provenance. A host that wants no shading at all
+   overrides one selector instead of passing an option through every call site.
+
+   `--shaded` is the resolved "draw it now" state. Legacy form fields carry it from paint
+   (Word shades them on sight); an ordinary field gets it either because the host asked for
+   `always` or because the caret is inside it, which the surface toggles as `--active`. */
+.docx-field-atom--shaded,
+.docx-field-atom--active {
+  background-color: var(--doc-field-shading);
+}
+
+/* Field shading NEVER prints — Word does not print it either. A printed form has no blanks
+   left to find, and a page number on paper is just a page number. */
+@media print {
+  .docx-field-atom--shaded,
+  .docx-field-atom--active {
+    background-color: transparent;
+  }
+}
+
 /* A tracked FORMAT change: grey, because nothing was added or removed — the appearance
    itself is the pending decision. A stylesheet rule rather than painter inline style on
    purpose: an authored underline or strike arrives as inline style and therefore WINS over
@@ -4186,10 +4240,9 @@ a.docx-hyperlink:focus-visible {
   margin-inline-start: auto;
 }
 
-/* The panel SCROLLS when it is taller than the room under the bar. That does clip a
- * popup opened from a control inside it (a font list, a swatch grid) — the same
- * trade every scrolling menu makes — and the alternative, a panel that runs off the
- * bottom of a short window, loses the rows entirely. */
+/* The panel scrolls when it is taller than the room under the bar. A nested menu
+ * temporarily lifts that clipping so its options remain reachable; closing it restores
+ * the bounded panel. */
 .docx-toolbar__more-panel {
   position: absolute;
   top: calc(100% + 6px);
@@ -4208,6 +4261,13 @@ a.docx-hyperlink:focus-visible {
   box-shadow: var(--doc-shadow-lg);
 }
 
+/* Zoom's level picker is a popover, not panel content. A scroll container would otherwise
+ * cut it off when Zoom is the last (or only) More row. `:has()` is supported by every
+ * browser we support, and scopes the escape hatch to the short interval the picker exists. */
+.docx-toolbar__more-panel:has(.docx-toolbar__zoom-menu) {
+  overflow-y: visible;
+}
+
 .docx-toolbar__more-section + .docx-toolbar__more-section {
   margin-top: 4px;
   padding-top: 4px;
@@ -4673,7 +4733,8 @@ a.docx-hyperlink:focus-visible {
   left: 0;
   z-index: var(--doc-z-overlay);
   margin-top: 4px;
-  min-width: 96px;
+  /* Wide enough for "Automatic" above the percentages, which are narrower. */
+  min-width: 132px;
 }
 
 /* The merged alignment dropdown: current-alignment icon + caret; the popup is
@@ -5629,12 +5690,25 @@ a.docx-hyperlink:focus-visible {
 
 /* The page column moves ONLY by what the adapter computed, and only while a pane
  * is open. Absent (no pane mounted, pane closed, gutter wide enough) the custom
- * property falls back to 0 and this rule is inert. */
-.docx-editor .docx-editor__scroll-container {
+ * property falls back to 0 and this rule is inert.
+ *
+ * Descendant AND self: `DocxEditor.Viewport` puts `docx-editor` on the scroll
+ * container itself when no ancestor is scoped (Root + Viewport composition /
+ * `chrome={false}`), so the self-scoped selector is load-bearing — same pattern
+ * as scrollbar-gutter above. */
+.docx-editor .docx-editor__scroll-container,
+.docx-editor.docx-editor__scroll-container {
   padding-inline-start: var(--docx-nav-shift, 0px);
   transition: padding-inline-start 0.2s ease;
 }
 
+/* Under a fit the page width follows the padded box. Animating the padding would
+ * publish intermediate widths and the fit would chase them every frame. Jump. */
+.docx-editor .docx-editor__scroll-container[data-zoom-fit],
+.docx-editor.docx-editor__scroll-container[data-zoom-fit] {
+  transition: none;
+}
+
 /* Positioning frame: the gutter strip to the left of the page. `pointer-events`
  * is off on the frame and back on for its controls, so the strip never eats a
  * click meant for the document behind it. */
@@ -6512,7 +6586,8 @@ a.docx-hyperlink:focus-visible {
 
 /* Reduced motion: the page still moves when it has to, it just does not glide. */
 @media (prefers-reduced-motion: reduce) {
-  .docx-editor .docx-editor__scroll-container {
+  .docx-editor .docx-editor__scroll-container,
+  .docx-editor.docx-editor__scroll-container {
     transition-duration: 0s;
   }
 }