@docx-editor.dev/core 2.5.0 → 2.6.1

package/dist/editor.d.cts

@@ -1,31 +1,32 @@
-import { F as FontConfiguration, E as EditorFontError, a as EditorCommand, C as CanResult, Z as ZoomMode } from './editor-CUul9IuY.cjs';
-export { I as ImageContext, b as ImageCropPercent, c as ImageCropPermille, S as SelectedImageState, d as cropPercentFromCropPermille, e as cropPercentFromPermille, f as cropPercentFromSourceCrop, g as cropPermilleFromCropPercent, h as cropPermilleFromPercent, s as sourceCropFromCropPercent, v as validateImageCropPercent } from './editor-CUul9IuY.cjs';
-import { L as LayoutShapingOptions } from './shaped-measurer-Dx4llNhK.cjs';
-import { P as PaginatedSurfaceOptions, O as OpenPaginatedResult, a as PaginatedSurface, T as TableCommandPlan, D as DocxEditorInstance } from './index-8t44iXTY.cjs';
-export { A as AnchorFrameOrigin, C as CHROME_GROUPS, b as CHROME_MENUS, c as CHROME_UNAVAILABLE_KEY, d as ChromeControl, e as ChromeControlId, f as ChromeControlState, g as ChromeGroup, h as ChromeGroupId, i as ChromeMenu, j as ChromeMenuEntry, k as ChromeMenuId, l as ChromeMenuItemEntry, m as ChromeMenuSeparatorEntry, n as ChromeMenuSubmenuEntry, o as ChromeSlotId, p as DEFAULT_TABLE_CHROME_DRAFT, q as DocxEditorConfig, E as EMU_PER_POINT, F as FinalizedImageOverlayInteraction, r as FontConfigurationBase, s as FontConfigurationFragment, t as FontLoadFailure, u as FontLoadFailureReason, v as FontMeasurementState, w as FontResolutionRequest, x as FontResolver, y as FontUrlSource, H as HyperlinkActivation, z as HyperlinkChromeHandlers, B as HyperlinkOps, I as IMAGE_OVERLAY_NUDGE_PT, G as IMAGE_OVERLAY_NUDGE_SHIFT_PT, J as ImageInteractionSession, K as ImageOverlayScrollPort, L as ImageResizeHandle, M as ImageResizeResult, N as LoadFontsRequest, Q as LoadFontsResult, R as MAX_RESOLVER_FAMILIES, S as OverlayFrameRect, U as PaginatedSurfaceState, V as RunTableChromeCommandResult, W as SelectedDrawingOverlayTarget, X as SurfaceFormatting, Y as SurfaceHyperlink, Z as SurfaceNavigation, _ as SurfaceOverlayCoordinates, $ as TABLE_BORDER_STYLE_OPTIONS, a0 as TABLE_BORDER_TARGET_OPTIONS, a1 as TABLE_BORDER_WIDTH_OPTIONS, a2 as TABLE_CHROME_SLOT_IDS, a3 as TableBorderStyleOption, a4 as TableBorderTargetOption, a5 as TableBorderTargetValue, a6 as TableBorderWidthOption, a7 as TableChromeDraft, a8 as TableChromePick, a9 as TableChromeSlotId, aa as TableInteractionLabelKey, ab as ToolbarCommandState, ac as WORD_DEFAULT_FONT, ad as applyTableChromePick, ae as blankDocumentBytes, af as canExecuteImageCommand, ag as captureImageMutationPreconditions, ah as chromeControlCount, ai as chromeMenuSlots, aj as chromeProbeForSlot, ak as chromeSlotId, al as commandForSlot, am as commandForSlotValue, an as commandForTableChromeSlotValue, ao as composeFontConfiguration, ap as computeImageResizeResult, aq as computeMovedImagePosition, ar as computeResizedImageExtentEmu, as as createDocxEditor, at as createFontSource, au as createImageOverlayScrollPort, av as cssPixelsToLayoutPoints, aw as defaultChromeGroups, ax as defaultTableLabel, ay as emuToOverlayPoints, az as executeImageCommand, aA as finalizeImageOverlayInteraction, aB as formattingBarChromeGroups, aC as isStaleImageInteractionCommit, aD as isTableChromeSlot, aE as layoutPointsToCssPixels, aF as loadFonts, aG as overlayFrameToSheetCssPixels, aH as pointsToEmu, aI as probeTableChromeCommand, aJ as resizePreservesAspect, aK as runSave, aL as runTableChromeCommand, aM as runTableCommand, aN as runToolbarCommand, aO as selectedDrawingOverlayTargetOf, aP as selectedImageStateOf, aQ as surfacePaintScale, aR as tableChromeIconPaths, aS as tableChromeLabelKeyForTarget, aT as tableChromeToolbarState, aU as tableChromeVisible, aV as tableCommandToolbarState, aW as toolbarCommandState, aX as toolbarCommandStates } from './index-8t44iXTY.cjs';
-import { A as AutomationCapabilities, a as AutomationHost } from './protocol-B5oSt08P.cjs';
+export { D as DEFAULT_IMAGE_RESOURCE_LIMITS, b as ImageDecodePort, c as ImageResourceLimits, R as RenderableImageMime, S as SupportedImageMime, a as VectorImageMime, r as resolveImageResourceLimits, d as resolveSvgIntrinsicSize, s as sniffImageMime, v as validateRasterHeader } from './image-resources-BaHz4QAd.cjs';
+import { i as TreeDocColorValue, d as DrawingPositionInput } from './tree-op-types-CUCwPWjT.cjs';
+export { j as IMAGE_WRAP_TARGETS, b as ImageWrapTarget } from './tree-op-types-CUCwPWjT.cjs';
+import { g as DocumentThemeColorEntry } from './tree-session-b7bggR-S.cjs';
+export { a as TreeApplyResult, c as TreeDocxSessionView } from './tree-session-b7bggR-S.cjs';
+import { F as FontConfiguration, E as EditorFontError, a as EditorSnapshot, b as EditorCommand, C as CanResult, Z as ZoomMode } from './editor-BZEJL3vv.cjs';
+export { I as ImageContext, c as ImageCropPercent, d as ImageCropPermille, S as SelectedImageState, e as cropPercentFromCropPermille, f as cropPercentFromPermille, g as cropPercentFromSourceCrop, h as cropPermilleFromCropPercent, i as cropPermilleFromPercent, s as sourceCropFromCropPercent, v as validateImageCropPercent } from './editor-BZEJL3vv.cjs';
+import { L as LayoutShapingOptions } from './shaped-measurer-C2SJAjV0.cjs';
+import { P as PaginatedSurfaceOptions, O as OpenPaginatedResult, a as PaginatedSurface, T as TableCommandPlan, D as DocxEditorInstance } from './index-_xF7n_z0.cjs';
+export { A as AnchorFrameOrigin, C as CHROME_GROUPS, b as CHROME_MENUS, c as CHROME_UNAVAILABLE_KEY, d as ChromeControl, e as ChromeControlId, f as ChromeControlState, g as ChromeGroup, h as ChromeGroupId, i as ChromeMenu, j as ChromeMenuEntry, k as ChromeMenuId, l as ChromeMenuItemEntry, m as ChromeMenuSeparatorEntry, n as ChromeMenuSubmenuEntry, o as ChromeSlotId, p as DEFAULT_TABLE_CHROME_DRAFT, q as DocxEditorConfig, E as EMU_PER_POINT, F as FinalizedImageOverlayInteraction, r as FontConfigurationBase, s as FontConfigurationFragment, t as FontLoadFailure, u as FontLoadFailureReason, v as FontMeasurementState, w as FontResolutionRequest, x as FontResolver, y as FontUrlSource, H as HyperlinkActivation, z as HyperlinkChromeHandlers, B as HyperlinkOps, I as IMAGE_OVERLAY_NUDGE_PT, G as IMAGE_OVERLAY_NUDGE_SHIFT_PT, J as ImageInteractionSession, K as ImageOverlayScrollPort, L as ImageResizeHandle, M as ImageResizeResult, N as LoadFontsRequest, Q as LoadFontsResult, R as MAX_RESOLVER_FAMILIES, S as OverlayFrameRect, U as PaginatedSurfaceState, V as RunTableChromeCommandResult, W as SelectedDrawingOverlayTarget, X as SurfaceFormatting, Y as SurfaceHyperlink, Z as SurfaceNavigation, _ as SurfaceOverlayCoordinates, $ as TABLE_BORDER_STYLE_OPTIONS, a0 as TABLE_BORDER_TARGET_OPTIONS, a1 as TABLE_BORDER_WIDTH_OPTIONS, a2 as TABLE_CHROME_SLOT_IDS, a3 as TableBorderStyleOption, a4 as TableBorderTargetOption, a5 as TableBorderTargetValue, a6 as TableBorderWidthOption, a7 as TableChromeDraft, a8 as TableChromePick, a9 as TableChromeSlotId, aa as TableInteractionLabelKey, ab as ToolbarCommandState, ac as WORD_DEFAULT_FONT, ad as applyTableChromePick, ae as blankDocumentBytes, af as canExecuteImageCommand, ag as captureImageMutationPreconditions, ah as chromeControlCount, ai as chromeMenuSlots, aj as chromeProbeForSlot, ak as chromeSlotId, al as commandForSlot, am as commandForSlotValue, an as commandForTableChromeSlotValue, ao as composeFontConfiguration, ap as computeImageResizeResult, aq as computeMovedImagePosition, ar as computeResizedImageExtentEmu, as as createDocxEditor, at as createFontSource, au as createImageOverlayScrollPort, av as cssPixelsToLayoutPoints, aw as defaultChromeGroups, ax as defaultTableLabel, ay as emuToOverlayPoints, az as executeImageCommand, aA as finalizeImageOverlayInteraction, aB as formattingBarChromeGroups, aC as isStaleImageInteractionCommit, aD as isTableChromeSlot, aE as layoutPointsToCssPixels, aF as loadFonts, aG as overlayFrameToSheetCssPixels, aH as pointsToEmu, aI as probeTableChromeCommand, aJ as resizePreservesAspect, aK as runSave, aL as runTableChromeCommand, aM as runTableCommand, aN as runToolbarCommand, aO as selectedDrawingOverlayTargetOf, aP as selectedImageStateOf, aQ as surfacePaintScale, aR as tableChromeIconPaths, aS as tableChromeLabelKeyForTarget, aT as tableChromeToolbarState, aU as tableChromeVisible, aV as tableCommandToolbarState, aW as toolbarCommandState, aX as toolbarCommandStates } from './index-_xF7n_z0.cjs';
+import { A as AutomationCapabilities, a as AutomationHost } from './protocol-CD7slqvl.cjs';
 export { CollectReviewItems, EditorModule, EditorModuleRegistry, ReviewModuleContribution, resolveEditorModules } from './contracts/modules.cjs';
 import { ColorValue } from './contracts/types.cjs';
-import { h as TreeDocColorValue, d as DrawingPositionInput } from './tree-op-types-DOYNkKqD.cjs';
-export { i as IMAGE_WRAP_TARGETS, b as ImageWrapTarget } from './tree-op-types-DOYNkKqD.cjs';
-import { f as DocumentThemeColorEntry } from './tree-session-CtK3KgFU.cjs';
-import { S as SemanticLayout } from './semantic-records-Dq8SlCY8.cjs';
-export { T as TextMeasurer } from './semantic-records-Dq8SlCY8.cjs';
-export { D as DEFAULT_IMAGE_RESOURCE_LIMITS, b as ImageDecodePort, c as ImageResourceLimits, R as RenderableImageMime, S as SupportedImageMime, a as VectorImageMime, r as resolveImageResourceLimits, d as resolveSvgIntrinsicSize, s as sniffImageMime, v as validateRasterHeader } from './image-resources-CSlQmPIm.cjs';
-export { S as SectionProperties } from './semantic-cell-selection-CdNQ-a9-.cjs';
-export { R as ReviewModelInput } from './review-support-CHuJxHmz.cjs';
-export { N as NavigationCommand, S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-DgaWs-5w.cjs';
-export { F as FieldShadingMode } from './semantic-paint-6iIB4fhx.cjs';
-import './contracts/document.cjs';
-import './revision-projection-DRZMzoLD.cjs';
-import './ooxml-tree-CG0odFyi.cjs';
-import './note-properties-Dhqkro--.cjs';
-import './ooxml-package-Cmbe_M04.cjs';
-import './custom-node-writes-CIC_-wad.cjs';
-import './hf-references-BPET4tlK.cjs';
-import './note-nodes-B2wWES2L.cjs';
-import './tree-store-Jg-q7fyf.cjs';
+import { S as SemanticLayout } from './semantic-records-DEOs3_tE.cjs';
+export { T as TextMeasurer } from './semantic-records-DEOs3_tE.cjs';
+export { S as SectionProperties } from './semantic-cell-selection-BTQFpN0S.cjs';
+export { R as ReviewModelInput } from './review-support-T-riLz4Y.cjs';
+export { N as NavigationCommand, S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-CDNEU_Tx.cjs';
+export { F as FieldShadingMode, R as ReviewAuthorInfo, a as RevisionAuthorAssignments, b as RevisionAuthorStyle, c as RevisionStyles } from './semantic-paint-IjbL-4CT.cjs';
+import './ooxml-package-CR5us6ad.cjs';
+import './ooxml-tree-BU0e3DVi.cjs';
+import './custom-node-writes-D9G3GKQ7.cjs';
+import './hf-references-CgEOSw3i.cjs';
+import './note-nodes-C6DLxlvj.cjs';
+import './tree-store-BqgeCa1Q.cjs';
 import 'prosemirror-model';
+import './contracts/document.cjs';
+import './revision-projection-WzlQGBJx.cjs';
+import './review-reads-Dr0CpW6u.cjs';
 
 interface LayoutShapingInstrumentation {
     readonly onFontByteCopy?: () => void;
@@ -50,6 +51,14 @@ declare function createLayoutShaping(configuration: FontConfiguration, instrumen
  */
 declare function disposeLayoutShaping(shaping: LayoutShapingOptions): void;
 
+/**
+ * What `snapshot()` reports before an editor exists: loading, not editable, nothing
+ * selected, nothing undoable — never invented state.
+ *
+ * @public
+ */
+declare const LOADING_SNAPSHOT: EditorSnapshot;
+
 /** The engine paints at 96 px per inch (twips / 15, 1440 twips per inch). */
 declare const PX_PER_INCH = 96;
 /** Painted pixels per centimetre, derived from {@link PX_PER_INCH}. */
@@ -149,6 +158,13 @@ declare function dragIndent(handle: RulerIndentHandle, positionTwips: number, in
  */
 declare function mountPaginatedSurface(container: HTMLElement, bytes: Uint8Array, options?: PaginatedSurfaceOptions): OpenPaginatedResult;
 
+/**
+ * Stable value identity for a command, including nested payloads.
+ *
+ * @internal
+ */
+declare function editorCommandKey(command: EditorCommand): string;
+
 /** Planner-backed can/plan pair — production gate for table commands. Task 9 maps chrome slots. */
 declare function tableCommandState(command: EditorCommand, surface: PaginatedSurface): {
     readonly can: CanResult;
@@ -308,4 +324,4 @@ declare function validateSetImagePositionCommand(command: {
     readonly relativeToV?: string;
 }, mode: 'frame' | 'simple'): boolean;
 
-export { AUTO_ZOOM_MODE, BROWSER_AUTOMATION_CAPABILITIES, type ColorLowerResult, DRAWING_REL_FROM_H, DRAWING_REL_FROM_V, DocxEditorInstance, DrawingPositionInput, FIT_WIDTH_ZOOM_MODE, OpenPaginatedResult, PX_PER_CM, PX_PER_INCH, PaginatedSurface, PaginatedSurfaceOptions, type RulerDragOptions, type RulerIndent, type RulerIndentHandle, type RulerPageMetrics, type RulerTick, type RulerUnit, SNAP_TWIPS_CM, SNAP_TWIPS_INCH, type SurfaceExtent, TWIPS_PER_CM, TWIPS_PER_INCH, ZOOM_MAX, ZOOM_MIN, applyThemeShade, applyThemeTint, createBrowserAutomationHost, createLayoutShaping, disposeLayoutShaping, dragIndent, generateRulerTicks, handlePosition, lowerColorValueForBorder, lowerColorValueForFill, mountPaginatedSurface, positionInputFromPropertiesCommand, propertiesCommandHasPositionFields, resolveColorValueToCss, resolveThemeColorHex, resolveZoomMode, rulerPageBox, sameZoomMode, snapTwips, surfaceExtent, tableCommandState, toEditorFontError, validateDrawingPositionInput, validateSetImagePositionCommand, validateThemeModifier };
+export { AUTO_ZOOM_MODE, BROWSER_AUTOMATION_CAPABILITIES, type ColorLowerResult, DRAWING_REL_FROM_H, DRAWING_REL_FROM_V, DocxEditorInstance, DrawingPositionInput, FIT_WIDTH_ZOOM_MODE, LOADING_SNAPSHOT, OpenPaginatedResult, PX_PER_CM, PX_PER_INCH, PaginatedSurface, PaginatedSurfaceOptions, type RulerDragOptions, type RulerIndent, type RulerIndentHandle, type RulerPageMetrics, type RulerTick, type RulerUnit, SNAP_TWIPS_CM, SNAP_TWIPS_INCH, type SurfaceExtent, TWIPS_PER_CM, TWIPS_PER_INCH, ZOOM_MAX, ZOOM_MIN, applyThemeShade, applyThemeTint, createBrowserAutomationHost, createLayoutShaping, disposeLayoutShaping, dragIndent, editorCommandKey, generateRulerTicks, handlePosition, lowerColorValueForBorder, lowerColorValueForFill, mountPaginatedSurface, positionInputFromPropertiesCommand, propertiesCommandHasPositionFields, resolveColorValueToCss, resolveThemeColorHex, resolveZoomMode, rulerPageBox, sameZoomMode, snapTwips, surfaceExtent, tableCommandState, toEditorFontError, validateDrawingPositionInput, validateSetImagePositionCommand, validateThemeModifier };

package/dist/editor.d.ts

@@ -1,31 +1,32 @@
-import { F as FontConfiguration, E as EditorFontError, a as EditorCommand, C as CanResult, Z as ZoomMode } from './editor-DIwctMcU.js';
-export { I as ImageContext, b as ImageCropPercent, c as ImageCropPermille, S as SelectedImageState, d as cropPercentFromCropPermille, e as cropPercentFromPermille, f as cropPercentFromSourceCrop, g as cropPermilleFromCropPercent, h as cropPermilleFromPercent, s as sourceCropFromCropPercent, v as validateImageCropPercent } from './editor-DIwctMcU.js';
-import { L as LayoutShapingOptions } from './shaped-measurer-BT4FqYe9.js';
-import { P as PaginatedSurfaceOptions, O as OpenPaginatedResult, a as PaginatedSurface, T as TableCommandPlan, D as DocxEditorInstance } from './index-BUsYjxF5.js';
-export { A as AnchorFrameOrigin, C as CHROME_GROUPS, b as CHROME_MENUS, c as CHROME_UNAVAILABLE_KEY, d as ChromeControl, e as ChromeControlId, f as ChromeControlState, g as ChromeGroup, h as ChromeGroupId, i as ChromeMenu, j as ChromeMenuEntry, k as ChromeMenuId, l as ChromeMenuItemEntry, m as ChromeMenuSeparatorEntry, n as ChromeMenuSubmenuEntry, o as ChromeSlotId, p as DEFAULT_TABLE_CHROME_DRAFT, q as DocxEditorConfig, E as EMU_PER_POINT, F as FinalizedImageOverlayInteraction, r as FontConfigurationBase, s as FontConfigurationFragment, t as FontLoadFailure, u as FontLoadFailureReason, v as FontMeasurementState, w as FontResolutionRequest, x as FontResolver, y as FontUrlSource, H as HyperlinkActivation, z as HyperlinkChromeHandlers, B as HyperlinkOps, I as IMAGE_OVERLAY_NUDGE_PT, G as IMAGE_OVERLAY_NUDGE_SHIFT_PT, J as ImageInteractionSession, K as ImageOverlayScrollPort, L as ImageResizeHandle, M as ImageResizeResult, N as LoadFontsRequest, Q as LoadFontsResult, R as MAX_RESOLVER_FAMILIES, S as OverlayFrameRect, U as PaginatedSurfaceState, V as RunTableChromeCommandResult, W as SelectedDrawingOverlayTarget, X as SurfaceFormatting, Y as SurfaceHyperlink, Z as SurfaceNavigation, _ as SurfaceOverlayCoordinates, $ as TABLE_BORDER_STYLE_OPTIONS, a0 as TABLE_BORDER_TARGET_OPTIONS, a1 as TABLE_BORDER_WIDTH_OPTIONS, a2 as TABLE_CHROME_SLOT_IDS, a3 as TableBorderStyleOption, a4 as TableBorderTargetOption, a5 as TableBorderTargetValue, a6 as TableBorderWidthOption, a7 as TableChromeDraft, a8 as TableChromePick, a9 as TableChromeSlotId, aa as TableInteractionLabelKey, ab as ToolbarCommandState, ac as WORD_DEFAULT_FONT, ad as applyTableChromePick, ae as blankDocumentBytes, af as canExecuteImageCommand, ag as captureImageMutationPreconditions, ah as chromeControlCount, ai as chromeMenuSlots, aj as chromeProbeForSlot, ak as chromeSlotId, al as commandForSlot, am as commandForSlotValue, an as commandForTableChromeSlotValue, ao as composeFontConfiguration, ap as computeImageResizeResult, aq as computeMovedImagePosition, ar as computeResizedImageExtentEmu, as as createDocxEditor, at as createFontSource, au as createImageOverlayScrollPort, av as cssPixelsToLayoutPoints, aw as defaultChromeGroups, ax as defaultTableLabel, ay as emuToOverlayPoints, az as executeImageCommand, aA as finalizeImageOverlayInteraction, aB as formattingBarChromeGroups, aC as isStaleImageInteractionCommit, aD as isTableChromeSlot, aE as layoutPointsToCssPixels, aF as loadFonts, aG as overlayFrameToSheetCssPixels, aH as pointsToEmu, aI as probeTableChromeCommand, aJ as resizePreservesAspect, aK as runSave, aL as runTableChromeCommand, aM as runTableCommand, aN as runToolbarCommand, aO as selectedDrawingOverlayTargetOf, aP as selectedImageStateOf, aQ as surfacePaintScale, aR as tableChromeIconPaths, aS as tableChromeLabelKeyForTarget, aT as tableChromeToolbarState, aU as tableChromeVisible, aV as tableCommandToolbarState, aW as toolbarCommandState, aX as toolbarCommandStates } from './index-BUsYjxF5.js';
-import { A as AutomationCapabilities, a as AutomationHost } from './protocol-ooK7PAXz.js';
+export { D as DEFAULT_IMAGE_RESOURCE_LIMITS, b as ImageDecodePort, c as ImageResourceLimits, R as RenderableImageMime, S as SupportedImageMime, a as VectorImageMime, r as resolveImageResourceLimits, d as resolveSvgIntrinsicSize, s as sniffImageMime, v as validateRasterHeader } from './image-resources-Cl5_cNi9.js';
+import { i as TreeDocColorValue, d as DrawingPositionInput } from './tree-op-types-D0fTNBVW.js';
+export { j as IMAGE_WRAP_TARGETS, b as ImageWrapTarget } from './tree-op-types-D0fTNBVW.js';
+import { g as DocumentThemeColorEntry } from './tree-session-CH1oA75f.js';
+export { a as TreeApplyResult, c as TreeDocxSessionView } from './tree-session-CH1oA75f.js';
+import { F as FontConfiguration, E as EditorFontError, a as EditorSnapshot, b as EditorCommand, C as CanResult, Z as ZoomMode } from './editor-D2zOJztO.js';
+export { I as ImageContext, c as ImageCropPercent, d as ImageCropPermille, S as SelectedImageState, e as cropPercentFromCropPermille, f as cropPercentFromPermille, g as cropPercentFromSourceCrop, h as cropPermilleFromCropPercent, i as cropPermilleFromPercent, s as sourceCropFromCropPercent, v as validateImageCropPercent } from './editor-D2zOJztO.js';
+import { L as LayoutShapingOptions } from './shaped-measurer-l4o5ITJ0.js';
+import { P as PaginatedSurfaceOptions, O as OpenPaginatedResult, a as PaginatedSurface, T as TableCommandPlan, D as DocxEditorInstance } from './index-D8L8WrNF.js';
+export { A as AnchorFrameOrigin, C as CHROME_GROUPS, b as CHROME_MENUS, c as CHROME_UNAVAILABLE_KEY, d as ChromeControl, e as ChromeControlId, f as ChromeControlState, g as ChromeGroup, h as ChromeGroupId, i as ChromeMenu, j as ChromeMenuEntry, k as ChromeMenuId, l as ChromeMenuItemEntry, m as ChromeMenuSeparatorEntry, n as ChromeMenuSubmenuEntry, o as ChromeSlotId, p as DEFAULT_TABLE_CHROME_DRAFT, q as DocxEditorConfig, E as EMU_PER_POINT, F as FinalizedImageOverlayInteraction, r as FontConfigurationBase, s as FontConfigurationFragment, t as FontLoadFailure, u as FontLoadFailureReason, v as FontMeasurementState, w as FontResolutionRequest, x as FontResolver, y as FontUrlSource, H as HyperlinkActivation, z as HyperlinkChromeHandlers, B as HyperlinkOps, I as IMAGE_OVERLAY_NUDGE_PT, G as IMAGE_OVERLAY_NUDGE_SHIFT_PT, J as ImageInteractionSession, K as ImageOverlayScrollPort, L as ImageResizeHandle, M as ImageResizeResult, N as LoadFontsRequest, Q as LoadFontsResult, R as MAX_RESOLVER_FAMILIES, S as OverlayFrameRect, U as PaginatedSurfaceState, V as RunTableChromeCommandResult, W as SelectedDrawingOverlayTarget, X as SurfaceFormatting, Y as SurfaceHyperlink, Z as SurfaceNavigation, _ as SurfaceOverlayCoordinates, $ as TABLE_BORDER_STYLE_OPTIONS, a0 as TABLE_BORDER_TARGET_OPTIONS, a1 as TABLE_BORDER_WIDTH_OPTIONS, a2 as TABLE_CHROME_SLOT_IDS, a3 as TableBorderStyleOption, a4 as TableBorderTargetOption, a5 as TableBorderTargetValue, a6 as TableBorderWidthOption, a7 as TableChromeDraft, a8 as TableChromePick, a9 as TableChromeSlotId, aa as TableInteractionLabelKey, ab as ToolbarCommandState, ac as WORD_DEFAULT_FONT, ad as applyTableChromePick, ae as blankDocumentBytes, af as canExecuteImageCommand, ag as captureImageMutationPreconditions, ah as chromeControlCount, ai as chromeMenuSlots, aj as chromeProbeForSlot, ak as chromeSlotId, al as commandForSlot, am as commandForSlotValue, an as commandForTableChromeSlotValue, ao as composeFontConfiguration, ap as computeImageResizeResult, aq as computeMovedImagePosition, ar as computeResizedImageExtentEmu, as as createDocxEditor, at as createFontSource, au as createImageOverlayScrollPort, av as cssPixelsToLayoutPoints, aw as defaultChromeGroups, ax as defaultTableLabel, ay as emuToOverlayPoints, az as executeImageCommand, aA as finalizeImageOverlayInteraction, aB as formattingBarChromeGroups, aC as isStaleImageInteractionCommit, aD as isTableChromeSlot, aE as layoutPointsToCssPixels, aF as loadFonts, aG as overlayFrameToSheetCssPixels, aH as pointsToEmu, aI as probeTableChromeCommand, aJ as resizePreservesAspect, aK as runSave, aL as runTableChromeCommand, aM as runTableCommand, aN as runToolbarCommand, aO as selectedDrawingOverlayTargetOf, aP as selectedImageStateOf, aQ as surfacePaintScale, aR as tableChromeIconPaths, aS as tableChromeLabelKeyForTarget, aT as tableChromeToolbarState, aU as tableChromeVisible, aV as tableCommandToolbarState, aW as toolbarCommandState, aX as toolbarCommandStates } from './index-D8L8WrNF.js';
+import { A as AutomationCapabilities, a as AutomationHost } from './protocol-DsbfgBwA.js';
 export { CollectReviewItems, EditorModule, EditorModuleRegistry, ReviewModuleContribution, resolveEditorModules } from './contracts/modules.js';
 import { ColorValue } from './contracts/types.js';
-import { h as TreeDocColorValue, d as DrawingPositionInput } from './tree-op-types-CZw9QhWX.js';
-export { i as IMAGE_WRAP_TARGETS, b as ImageWrapTarget } from './tree-op-types-CZw9QhWX.js';
-import { f as DocumentThemeColorEntry } from './tree-session-CF_EOhTW.js';
-import { S as SemanticLayout } from './semantic-records-B-qbrnp2.js';
-export { T as TextMeasurer } from './semantic-records-B-qbrnp2.js';
-export { D as DEFAULT_IMAGE_RESOURCE_LIMITS, b as ImageDecodePort, c as ImageResourceLimits, R as RenderableImageMime, S as SupportedImageMime, a as VectorImageMime, r as resolveImageResourceLimits, d as resolveSvgIntrinsicSize, s as sniffImageMime, v as validateRasterHeader } from './image-resources-e13t-pgy.js';
-export { S as SectionProperties } from './semantic-cell-selection-Dc-_enhm.js';
-export { R as ReviewModelInput } from './review-support-Bl9sN8cv.js';
-export { N as NavigationCommand, S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-CCVwyw2A.js';
-export { F as FieldShadingMode } from './semantic-paint-CKIbFkQ7.js';
-import './contracts/document.js';
-import './revision-projection-u4nT52xT.js';
-import './ooxml-tree-CG0odFyi.js';
-import './note-properties-BS66XmcC.js';
-import './ooxml-package-BrxTmTsZ.js';
-import './custom-node-writes-2clI36T9.js';
-import './hf-references-CAp1xTv6.js';
-import './note-nodes-CZQXU6Fg.js';
-import './tree-store-9TaX-L0V.js';
+import { S as SemanticLayout } from './semantic-records-CdQvpUj1.js';
+export { T as TextMeasurer } from './semantic-records-CdQvpUj1.js';
+export { S as SectionProperties } from './semantic-cell-selection-B5vfPz4Q.js';
+export { R as ReviewModelInput } from './review-support-D4ZBdUXa.js';
+export { N as NavigationCommand, S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-lvpzZRpA.js';
+export { F as FieldShadingMode, R as ReviewAuthorInfo, a as RevisionAuthorAssignments, b as RevisionAuthorStyle, c as RevisionStyles } from './semantic-paint-BBPL3u5w.js';
+import './ooxml-package-D_CtywTW.js';
+import './ooxml-tree-BU0e3DVi.js';
+import './custom-node-writes-tJw8U9MO.js';
+import './hf-references-BdjsQNE_.js';
+import './note-nodes-BPSTVDMr.js';
+import './tree-store-CIKASRHk.js';
 import 'prosemirror-model';
+import './contracts/document.js';
+import './revision-projection-UKqvPa4-.js';
+import './review-reads-HDvoQXK2.js';
 
 interface LayoutShapingInstrumentation {
     readonly onFontByteCopy?: () => void;
@@ -50,6 +51,14 @@ declare function createLayoutShaping(configuration: FontConfiguration, instrumen
  */
 declare function disposeLayoutShaping(shaping: LayoutShapingOptions): void;
 
+/**
+ * What `snapshot()` reports before an editor exists: loading, not editable, nothing
+ * selected, nothing undoable — never invented state.
+ *
+ * @public
+ */
+declare const LOADING_SNAPSHOT: EditorSnapshot;
+
 /** The engine paints at 96 px per inch (twips / 15, 1440 twips per inch). */
 declare const PX_PER_INCH = 96;
 /** Painted pixels per centimetre, derived from {@link PX_PER_INCH}. */
@@ -149,6 +158,13 @@ declare function dragIndent(handle: RulerIndentHandle, positionTwips: number, in
  */
 declare function mountPaginatedSurface(container: HTMLElement, bytes: Uint8Array, options?: PaginatedSurfaceOptions): OpenPaginatedResult;
 
+/**
+ * Stable value identity for a command, including nested payloads.
+ *
+ * @internal
+ */
+declare function editorCommandKey(command: EditorCommand): string;
+
 /** Planner-backed can/plan pair — production gate for table commands. Task 9 maps chrome slots. */
 declare function tableCommandState(command: EditorCommand, surface: PaginatedSurface): {
     readonly can: CanResult;
@@ -308,4 +324,4 @@ declare function validateSetImagePositionCommand(command: {
     readonly relativeToV?: string;
 }, mode: 'frame' | 'simple'): boolean;
 
-export { AUTO_ZOOM_MODE, BROWSER_AUTOMATION_CAPABILITIES, type ColorLowerResult, DRAWING_REL_FROM_H, DRAWING_REL_FROM_V, DocxEditorInstance, DrawingPositionInput, FIT_WIDTH_ZOOM_MODE, OpenPaginatedResult, PX_PER_CM, PX_PER_INCH, PaginatedSurface, PaginatedSurfaceOptions, type RulerDragOptions, type RulerIndent, type RulerIndentHandle, type RulerPageMetrics, type RulerTick, type RulerUnit, SNAP_TWIPS_CM, SNAP_TWIPS_INCH, type SurfaceExtent, TWIPS_PER_CM, TWIPS_PER_INCH, ZOOM_MAX, ZOOM_MIN, applyThemeShade, applyThemeTint, createBrowserAutomationHost, createLayoutShaping, disposeLayoutShaping, dragIndent, generateRulerTicks, handlePosition, lowerColorValueForBorder, lowerColorValueForFill, mountPaginatedSurface, positionInputFromPropertiesCommand, propertiesCommandHasPositionFields, resolveColorValueToCss, resolveThemeColorHex, resolveZoomMode, rulerPageBox, sameZoomMode, snapTwips, surfaceExtent, tableCommandState, toEditorFontError, validateDrawingPositionInput, validateSetImagePositionCommand, validateThemeModifier };
+export { AUTO_ZOOM_MODE, BROWSER_AUTOMATION_CAPABILITIES, type ColorLowerResult, DRAWING_REL_FROM_H, DRAWING_REL_FROM_V, DocxEditorInstance, DrawingPositionInput, FIT_WIDTH_ZOOM_MODE, LOADING_SNAPSHOT, OpenPaginatedResult, PX_PER_CM, PX_PER_INCH, PaginatedSurface, PaginatedSurfaceOptions, type RulerDragOptions, type RulerIndent, type RulerIndentHandle, type RulerPageMetrics, type RulerTick, type RulerUnit, SNAP_TWIPS_CM, SNAP_TWIPS_INCH, type SurfaceExtent, TWIPS_PER_CM, TWIPS_PER_INCH, ZOOM_MAX, ZOOM_MIN, applyThemeShade, applyThemeTint, createBrowserAutomationHost, createLayoutShaping, disposeLayoutShaping, dragIndent, editorCommandKey, generateRulerTicks, handlePosition, lowerColorValueForBorder, lowerColorValueForFill, mountPaginatedSurface, positionInputFromPropertiesCommand, propertiesCommandHasPositionFields, resolveColorValueToCss, resolveThemeColorHex, resolveZoomMode, rulerPageBox, sameZoomMode, snapTwips, surfaceExtent, tableCommandState, toEditorFontError, validateDrawingPositionInput, validateSetImagePositionCommand, validateThemeModifier };

package/dist/editor.js

@@ -1 +1 @@
-export{Ea as AUTO_ZOOM_MODE,Ja as BROWSER_AUTOMATION_CAPABILITIES,sa as CHROME_GROUPS,wa as CHROME_MENUS,za as CHROME_UNAVAILABLE_KEY,W as DEFAULT_TABLE_CHROME_DRAFT,O as EMU_PER_POINT,Fa as FIT_WIDTH_ZOOM_MODE,M as IMAGE_OVERLAY_NUDGE_PT,N as IMAGE_OVERLAY_NUDGE_SHIFT_PT,d as MAX_RESOLVER_FAMILIES,k as PX_PER_CM,j as PX_PER_INCH,q as SNAP_TWIPS_CM,p as SNAP_TWIPS_INCH,aa as TABLE_BORDER_STYLE_OPTIONS,$ as TABLE_BORDER_TARGET_OPTIONS,ba as TABLE_BORDER_WIDTH_OPTIONS,X as TABLE_CHROME_SLOT_IDS,o as TWIPS_PER_CM,n as TWIPS_PER_INCH,e as WORD_DEFAULT_FONT,Da as ZOOM_MAX,Ca as ZOOM_MIN,ca as applyTableChromePick,w as applyThemeShade,v as applyThemeTint,g as blankDocumentBytes,K as canExecuteImageCommand,J as captureImageMutationPreconditions,ya as chromeControlCount,xa as chromeMenuSlots,ga as chromeProbeForSlot,ta as chromeSlotId,ha as commandForSlot,ja as commandForSlotValue,ia as commandForTableChromeSlotValue,f as composeFontConfiguration,Qa as computeImageResizeResult,T as computeMovedImagePosition,S as computeResizedImageExtentEmu,Ka as createBrowserAutomationHost,Ia as createDocxEditor,i as createFontSource,Ra as createImageOverlayScrollPort,b as createLayoutShaping,G as cropPercentFromCropPermille,E as cropPercentFromPermille,B as cropPercentFromSourceCrop,F as cropPermilleFromCropPercent,D as cropPermilleFromPercent,Na as cssPixelsToLayoutPoints,ua as defaultChromeGroups,Y as defaultTableLabel,c as disposeLayoutShaping,t as dragIndent,R as emuToOverlayPoints,L as executeImageCommand,Sa as finalizeImageOverlayInteraction,va as formattingBarChromeGroups,l as generateRulerTicks,r as handlePosition,U as isStaleImageInteractionCommit,Z as isTableChromeSlot,Ma as layoutPointsToCssPixels,h as loadFonts,y as lowerColorValueForBorder,z as lowerColorValueForFill,Ba as mountPaginatedSurface,Oa as overlayFrameToSheetCssPixels,Q as pointsToEmu,da as probeTableChromeCommand,Pa as resizePreservesAspect,A as resolveColorValueToCss,x as resolveThemeColorHex,Ga as resolveZoomMode,m as rulerPageBox,pa as runSave,na as runTableChromeCommand,ra as runTableCommand,oa as runToolbarCommand,Ha as sameZoomMode,P as selectedDrawingOverlayTargetOf,I as selectedImageStateOf,s as snapTwips,C as sourceCropFromCropPercent,Aa as surfaceExtent,La as surfacePaintScale,fa as tableChromeIconPaths,ea as tableChromeLabelKeyForTarget,ka as tableChromeToolbarState,_ as tableChromeVisible,V as tableCommandState,qa as tableCommandToolbarState,a as toEditorFontError,la as toolbarCommandState,ma as toolbarCommandStates,H as validateImageCropPercent,u as validateThemeModifier}from'./chunk-QUZM6LWQ.js';import'./chunk-2QIA75K3.js';import'./chunk-T252F4US.js';import'./chunk-45FL7KH4.js';import'./chunk-32NXPFYL.js';import'./chunk-UVIUNAQ6.js';import'./chunk-YTZIGUXT.js';export{E as DEFAULT_IMAGE_RESOURCE_LIMITS,vf as DRAWING_REL_FROM_H,wf as DRAWING_REL_FROM_V,Xa as IMAGE_WRAP_TARGETS,yf as positionInputFromPropertiesCommand,xf as propertiesCommandHasPositionFields,F as resolveImageResourceLimits,ob as resolveSvgIntrinsicSize,kb as sniffImageMime,uf as validateDrawingPositionInput,pb as validateRasterHeader,zf as validateSetImagePositionCommand}from'./chunk-LJIX4ZDF.js';import'./chunk-GOEBQ26R.js';export{a as resolveEditorModules}from'./chunk-GQQOL4PV.js';
+export{Ga as AUTO_ZOOM_MODE,La as BROWSER_AUTOMATION_CAPABILITIES,ua as CHROME_GROUPS,ya as CHROME_MENUS,Ba as CHROME_UNAVAILABLE_KEY,X as DEFAULT_TABLE_CHROME_DRAFT,P as EMU_PER_POINT,Ha as FIT_WIDTH_ZOOM_MODE,N as IMAGE_OVERLAY_NUDGE_PT,O as IMAGE_OVERLAY_NUDGE_SHIFT_PT,d as LOADING_SNAPSHOT,e as MAX_RESOLVER_FAMILIES,l as PX_PER_CM,k as PX_PER_INCH,r as SNAP_TWIPS_CM,q as SNAP_TWIPS_INCH,ba as TABLE_BORDER_STYLE_OPTIONS,aa as TABLE_BORDER_TARGET_OPTIONS,ca as TABLE_BORDER_WIDTH_OPTIONS,Y as TABLE_CHROME_SLOT_IDS,p as TWIPS_PER_CM,o as TWIPS_PER_INCH,f as WORD_DEFAULT_FONT,Fa as ZOOM_MAX,Ea as ZOOM_MIN,da as applyTableChromePick,x as applyThemeShade,w as applyThemeTint,h as blankDocumentBytes,L as canExecuteImageCommand,K as captureImageMutationPreconditions,Aa as chromeControlCount,za as chromeMenuSlots,ha as chromeProbeForSlot,va as chromeSlotId,ia as commandForSlot,ka as commandForSlotValue,ja as commandForTableChromeSlotValue,g as composeFontConfiguration,Sa as computeImageResizeResult,U as computeMovedImagePosition,T as computeResizedImageExtentEmu,Ma as createBrowserAutomationHost,Ka as createDocxEditor,j as createFontSource,Ta as createImageOverlayScrollPort,b as createLayoutShaping,H as cropPercentFromCropPermille,F as cropPercentFromPermille,C as cropPercentFromSourceCrop,G as cropPermilleFromCropPercent,E as cropPermilleFromPercent,Pa as cssPixelsToLayoutPoints,wa as defaultChromeGroups,Z as defaultTableLabel,c as disposeLayoutShaping,u as dragIndent,ta as editorCommandKey,S as emuToOverlayPoints,M as executeImageCommand,Ua as finalizeImageOverlayInteraction,xa as formattingBarChromeGroups,m as generateRulerTicks,s as handlePosition,V as isStaleImageInteractionCommit,_ as isTableChromeSlot,Oa as layoutPointsToCssPixels,i as loadFonts,z as lowerColorValueForBorder,A as lowerColorValueForFill,Da as mountPaginatedSurface,Qa as overlayFrameToSheetCssPixels,R as pointsToEmu,ea as probeTableChromeCommand,Ra as resizePreservesAspect,B as resolveColorValueToCss,y as resolveThemeColorHex,Ia as resolveZoomMode,n as rulerPageBox,qa as runSave,oa as runTableChromeCommand,sa as runTableCommand,pa as runToolbarCommand,Ja as sameZoomMode,Q as selectedDrawingOverlayTargetOf,J as selectedImageStateOf,t as snapTwips,D as sourceCropFromCropPercent,Ca as surfaceExtent,Na as surfacePaintScale,ga as tableChromeIconPaths,fa as tableChromeLabelKeyForTarget,la as tableChromeToolbarState,$ as tableChromeVisible,W as tableCommandState,ra as tableCommandToolbarState,a as toEditorFontError,ma as toolbarCommandState,na as toolbarCommandStates,I as validateImageCropPercent,v as validateThemeModifier}from'./chunk-NIGGABAA.js';import'./chunk-WAVN7MAT.js';import'./chunk-OPKOTVQQ.js';import'./chunk-WU7PUTVA.js';import'./chunk-E7BXJ4BF.js';import'./chunk-4GQXAXTZ.js';import'./chunk-UVIUNAQ6.js';import'./chunk-SMRD66T5.js';export{E as DEFAULT_IMAGE_RESOURCE_LIMITS,vf as DRAWING_REL_FROM_H,wf as DRAWING_REL_FROM_V,Xa as IMAGE_WRAP_TARGETS,yf as positionInputFromPropertiesCommand,xf as propertiesCommandHasPositionFields,F as resolveImageResourceLimits,ob as resolveSvgIntrinsicSize,kb as sniffImageMime,uf as validateDrawingPositionInput,pb as validateRasterHeader,zf as validateSetImagePositionCommand}from'./chunk-R75OLPL6.js';import'./chunk-PSZH2VXP.js';export{a as resolveEditorModules}from'./chunk-GQQOL4PV.js';

package/dist/{hf-references-CAp1xTv6.d.ts → hf-references-BdjsQNE_.d.ts}

@@ -1,5 +1,5 @@
-import { e as OoxmlPart, O as OoxmlNode, a as OoxmlElement } from './ooxml-tree-CG0odFyi.js';
-import { O as OoxmlPackage } from './ooxml-package-BrxTmTsZ.js';
+import { e as OoxmlPart, O as OoxmlNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.js';
+import { O as OoxmlPackage } from './ooxml-package-D_CtywTW.js';
 
 /** `w:headerReference w:type` vocabulary (ECMA-376 §17.10.5): default, first page, even pages. */
 type HeaderFooterVariant = 'default' | 'first' | 'even';

package/dist/{hf-references-BPET4tlK.d.cts → hf-references-CgEOSw3i.d.cts}

@@ -1,5 +1,5 @@
-import { e as OoxmlPart, O as OoxmlNode, a as OoxmlElement } from './ooxml-tree-CG0odFyi.cjs';
-import { O as OoxmlPackage } from './ooxml-package-Cmbe_M04.cjs';
+import { e as OoxmlPart, O as OoxmlNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.cjs';
+import { O as OoxmlPackage } from './ooxml-package-CR5us6ad.cjs';
 
 /** `w:headerReference w:type` vocabulary (ECMA-376 §17.10.5): default, first page, even pages. */
 type HeaderFooterVariant = 'default' | 'first' | 'even';

package/dist/{image-resources-CSlQmPIm.d.cts → image-resources-BaHz4QAd.d.cts}

@@ -1,13 +1,5 @@
-import { D as DrawingProjection } from './tree-op-types-DOYNkKqD.cjs';
-import { O as OoxmlPackage } from './ooxml-package-Cmbe_M04.cjs';
-
-/** Opaque handle — bytes are reachable only through {@link mintValidatedImageBytes}. */
-interface ValidatedImageBytesHandle {
-    readonly registryId: number;
-    readonly resourceKey: string;
-    readonly contentId: string;
-    readonly generation: number;
-}
+import { D as DrawingProjection } from './tree-op-types-CUCwPWjT.cjs';
+import { O as OoxmlPackage } from './ooxml-package-CR5us6ad.cjs';
 
 /**
  * The engine's trust-boundary caps: recursion depth, element counts, and the rest.
@@ -63,6 +55,14 @@ declare const DEFAULT_IMAGE_RESOURCE_LIMITS: ImageResourceLimits;
 /** Resolve caller overrides into frozen image limits; hard ceilings cannot be raised. */
 declare function resolveImageResourceLimits(overrides?: Partial<ImageResourceLimits>): ImageResourceLimits;
 
+/** Opaque handle — bytes are reachable only through {@link mintValidatedImageBytes}. */
+interface ValidatedImageBytesHandle {
+    readonly registryId: number;
+    readonly resourceKey: string;
+    readonly contentId: string;
+    readonly generation: number;
+}
+
 /**
  * Raster media the decode port measures and any authoring path may write.
  *

package/dist/{image-resources-e13t-pgy.d.ts → image-resources-Cl5_cNi9.d.ts}

@@ -1,13 +1,5 @@
-import { D as DrawingProjection } from './tree-op-types-CZw9QhWX.js';
-import { O as OoxmlPackage } from './ooxml-package-BrxTmTsZ.js';
-
-/** Opaque handle — bytes are reachable only through {@link mintValidatedImageBytes}. */
-interface ValidatedImageBytesHandle {
-    readonly registryId: number;
-    readonly resourceKey: string;
-    readonly contentId: string;
-    readonly generation: number;
-}
+import { D as DrawingProjection } from './tree-op-types-D0fTNBVW.js';
+import { O as OoxmlPackage } from './ooxml-package-D_CtywTW.js';
 
 /**
  * The engine's trust-boundary caps: recursion depth, element counts, and the rest.
@@ -63,6 +55,14 @@ declare const DEFAULT_IMAGE_RESOURCE_LIMITS: ImageResourceLimits;
 /** Resolve caller overrides into frozen image limits; hard ceilings cannot be raised. */
 declare function resolveImageResourceLimits(overrides?: Partial<ImageResourceLimits>): ImageResourceLimits;
 
+/** Opaque handle — bytes are reachable only through {@link mintValidatedImageBytes}. */
+interface ValidatedImageBytesHandle {
+    readonly registryId: number;
+    readonly resourceKey: string;
+    readonly contentId: string;
+    readonly generation: number;
+}
+
 /**
  * Raster media the decode port measures and any authoring path may write.
  *

package/dist/{index-BUsYjxF5.d.ts → index-D8L8WrNF.d.ts}

@@ -1,17 +1,17 @@
-import { i as FontSource, j as FontSourceSubstitution, F as FontConfiguration, k as FontFaceRequest, I as ImageContext, D as DocumentSource, Z as ZoomMode, E as EditorFontError, l as Editor, a as EditorCommand, C as CanResult, S as SelectedImageState, V as ViewScope, T as TableBorderEdgeTarget, m as TableBorderSpec, n as TableBorderStyle, o as TableContext } from './editor-DIwctMcU.js';
-import { T as TreeDocOp, d as DrawingPositionInput, l as DrawingTransform, j as DrawingTreeDocOp } from './tree-op-types-CZw9QhWX.js';
-import { b as ImageDecodePort, S as SupportedImageMime } from './image-resources-e13t-pgy.js';
-import { R as RevisionDisplayMode } from './revision-projection-u4nT52xT.js';
-import './review-support-Bl9sN8cv.js';
-import { a as SemanticSelection, S as SemanticPosition, N as NavigationCommand } from './semantic-interaction-CCVwyw2A.js';
-import { R as ResolvedFootnoteProperties, a as ResolvedEndnoteProperties, A as AuthoredNoteProperties, l as ReviewRevisionKind } from './note-properties-BS66XmcC.js';
-import { S as SemanticLayout, C as ContentControlBoundaryRecord, T as TextMeasurer } from './semantic-records-B-qbrnp2.js';
-import { S as StoryScope, A as ApplyImagePropertiesInput, d as ImageIntentResult, c as InsertImageInput, B as BookmarkIndex } from './custom-node-writes-2clI36T9.js';
-import { C as CellSelection, S as SectionProperties } from './semantic-cell-selection-Dc-_enhm.js';
+import { T as TreeDocOp, d as DrawingPositionInput, l as DrawingTransform, h as DrawingTreeDocOp } from './tree-op-types-D0fTNBVW.js';
+import { b as ImageDecodePort, S as SupportedImageMime } from './image-resources-Cl5_cNi9.js';
+import './review-support-D4ZBdUXa.js';
 import { EditorModule, ReviewModuleContribution } from './contracts/modules.js';
-import { Unsubscribe, ExecResult, IndentFormatting } from './contracts/types.js';
-import { F as FieldShadingMode, a as DrawingPaintStrings } from './semantic-paint-CKIbFkQ7.js';
-import { T as TreeDocxSession, a as TreeApplyResult } from './tree-session-CF_EOhTW.js';
+import { j as FontSource, k as FontSourceSubstitution, F as FontConfiguration, l as FontFaceRequest, I as ImageContext, D as DocumentSource, Z as ZoomMode, E as EditorFontError, m as Editor, b as EditorCommand, C as CanResult, S as SelectedImageState, V as ViewScope, T as TableBorderEdgeTarget, n as TableBorderSpec, o as TableBorderStyle, p as TableContext } from './editor-D2zOJztO.js';
+import { R as RevisionDisplayMode } from './revision-projection-UKqvPa4-.js';
+import { a as SemanticSelection, S as SemanticPosition, N as NavigationCommand } from './semantic-interaction-lvpzZRpA.js';
+import { R as ResolvedFootnoteProperties, a as ResolvedEndnoteProperties, A as AuthoredNoteProperties, l as ReviewRevisionKind } from './review-reads-HDvoQXK2.js';
+import { S as SemanticLayout, C as ContentControlBoundaryRecord, T as TextMeasurer } from './semantic-records-CdQvpUj1.js';
+import { S as StoryScope, A as ApplyImagePropertiesInput, d as ImageIntentResult, c as InsertImageInput, B as BookmarkIndex } from './custom-node-writes-tJw8U9MO.js';
+import { C as CellSelection, S as SectionProperties } from './semantic-cell-selection-B5vfPz4Q.js';
+import { c as RevisionStyles, R as ReviewAuthorInfo, b as RevisionAuthorStyle, F as FieldShadingMode, d as DrawingPaintStrings } from './semantic-paint-BBPL3u5w.js';
+import { Unsubscribe, ExecResult, IndentFormatting, SelectionPin } from './contracts/types.js';
+import { c as TreeDocxSessionView, a as TreeApplyResult } from './tree-session-CH1oA75f.js';
 import './contracts/document.js';
 
 /**
@@ -1087,9 +1087,10 @@ interface DocxEditorConfig {
      */
     container?: HTMLElement;
     /**
-     * A document to load at construction. Bytes only in practice: a `DocumentHandle` cannot
-     * be re-opened (the handle is identity, not content), so passing one emits a typed
-     * `error` event rather than silently loading nothing.
+     * A document to load at construction: DOCX bytes, or `'blank'` for Word's blank
+     * template. A `DocumentHandle` cannot be re-opened (the handle is identity, not
+     * content), so passing one emits a typed `error` event rather than silently loading
+     * nothing. Omitting this mounts NO document, which is not the same as an empty one.
      */
     document?: DocumentSource;
     /**
@@ -1133,6 +1134,25 @@ interface DocxEditorConfig {
      *   suggesting, everything else in editing.
      */
     mode?: 'edit' | 'view' | 'suggesting';
+    /**
+     * How painted tracked changes are coloured. Presentation only — nothing is serialised.
+     *
+     * - `'author'` (the DEFAULT) — every change takes its author's colour from the
+     *   `--doc-review-author-N` ramp, by order of first appearance, as Word does. Restyle a
+     *   slot under `.docx-editor` to change the ramp.
+     * - `'kind'` — insertions green, deletions red, so "added" and "removed" are what a
+     *   glance tells apart, whoever proposed them.
+     * - {@link RevisionAuthorAssignments} — style the named authors; `others` decides
+     *   whether the rest take the ramp (the default) or the kind colours.
+     *
+     * The opening value. In React this is authored declaratively — `DocxEditor.ColorByChangeType`
+     * and `DocxEditor.AuthorStyle` compose and apply it, seeding this config for the first
+     * paint — so React hosts never pass it by hand; it is the entry for headless hosts. Read
+     * the document's resolved roster with `getReviewAuthors`. Applies wherever revision
+     * markup paints: the full all-markup view needs a review module registered; without one
+     * the proposed view still marks surviving insertions.
+     */
+    revisionStyles?: RevisionStyles;
     /** Override raster decode for insert/replace image commands; defaults to browser/headless. */
     imageDecodePort?: ImageDecodePort;
     /**
@@ -1222,6 +1242,58 @@ interface DocxEditorInstance extends Editor {
      * `stateVersion()`.
      */
     fontMeasurement(): FontMeasurementState;
+    /**
+     * Every author the review surface DRAWS, in Word's slot order, with the colour the review
+     * chrome draws them in. The discovery surface a legend or colour picker builds on —
+     * authors depend on the loaded file, so they cannot be known at configuration time.
+     *
+     * The colour is the author's, not the document's: under `'kind'` the painted text goes to
+     * the insertion/deletion colours while the cards keep these accents, so a legend built
+     * from this describes the rail rather than the page.
+     *
+     * BOTH HALVES OF REVIEW. Authors of tracked changes come first, numbered by where their
+     * first change appears; authors who only commented follow. One person therefore draws in
+     * one colour across their comments and their edits, which is what a reader assumes the
+     * moment they learn the pairing on either. The order puts commenters last so that adding
+     * a comment can never renumber a tracked change the painter has already drawn.
+     *
+     * Read of the rendered projection, not of the package: a resolved view hides the
+     * revisions it has resolved away, so an author whose only change is hidden there is
+     * listed only if they also commented. Empty while detached. Reference-stable between
+     * changes, so it is safe as a dependency; changes bump `stateVersion()`.
+     */
+    getReviewAuthors(): readonly ReviewAuthorInfo[];
+    /**
+     * The configured author used when a comment or reply omits an explicit author.
+     *
+     * @internal Review compose chrome uses this to draw an unfinished comment in the same
+     * author colour it will receive after commit.
+     */
+    getConfiguredAuthor(): string | null;
+    /**
+     * The style declared for one author, whether or not the SURFACE has published them yet —
+     * so review chrome can draw a card the rail is holding before the roster catches up.
+     *
+     * {@link DocxEditorInstance.getReviewAuthors} answers for every author of a tracked
+     * change or a comment, so this is a narrow fallback rather than the way to reach a
+     * commenter.
+     *
+     * @internal The seam `@docx-editor.dev/pro`'s review rail resolves those authors
+     * through. A consumer reads `useReviewAuthor` (pro) or `useReviewAuthors` (react)
+     * instead; nothing here answers a question those two do not.
+     */
+    getReviewAuthorStyle(author: string): RevisionAuthorStyle | undefined;
+    /**
+     * Replace how tracked changes are coloured, live. Paint-level: pages repaint without a
+     * layout pass, and the caret, selection and undo history stay where they are. Pass
+     * `'author'` to restore the default, or `'kind'` to opt out to the green/red
+     * rendering. Survives a document reload.
+     *
+     * The imperative PRIMITIVE beneath React's declarative lane: `DocxEditor.ColorByChangeType`
+     * and `DocxEditor.AuthorStyle` drive this seam, and React hosts declare those instead
+     * of calling it. Call it directly from headless and non-React hosts.
+     */
+    setRevisionStyles(styles: RevisionStyles): void;
     /**
      * Mount into `el`. If the instance holds pending document bytes (created without a
      * container, or previously detached), they mount now — under the shaped measurer when
@@ -1614,6 +1686,13 @@ interface PaginatedSurfaceOptions {
      * without remeasuring a single line.
      */
     readonly fieldShading?: FieldShadingMode;
+    /**
+     * How tracked changes are coloured: by AUTHOR (the default), by kind, or by author with
+     * host-pinned colours. A paint-level option like {@link fieldShading}: it changes no
+     * geometry, so switching it repaints without remeasuring a line. Applies wherever
+     * revision markup paints, whatever the {@link revisionDisplayMode} leaves visible.
+     */
+    readonly revisionStyles?: RevisionStyles;
     /**
      * The review module's derivation hooks for this surface's session. Absent,
      * `session.reviewItems()` is the typed empty queue and every review affordance
@@ -1831,10 +1910,10 @@ interface ContentControlSurfaceState {
  * `session` to apply ops directly bypasses the layout invalidation and the caret bookkeeping.
  */
 interface PaginatedSurface {
-    readonly session: TreeDocxSession;
+    readonly session: TreeDocxSessionView;
     storyScope(): StoryScope;
     imageDecodePort(): ImageDecodePort;
-    applyDrawingOps(ops: readonly DrawingTreeDocOp[]): ReturnType<TreeDocxSession['applyTreeOps']>;
+    applyDrawingOps(ops: readonly DrawingTreeDocOp[]): TreeApplyResult;
     applyImageProperties(input: ApplyImagePropertiesInput): ImageIntentResult;
     deleteImage(drawingNodeId: string): ImageIntentResult;
     insertImage(input: Omit<InsertImageInput, 'decodePort'>): Promise<ImageIntentResult>;
@@ -2131,9 +2210,9 @@ interface PaginatedSurface {
      * which is what lets a host close its panel on "the user clicked somewhere else" without
      * every adapter reimplementing that comparison.
      */
-    retainSelection(): void;
-    /** Drop the pin and stop drawing it, whether or not the caret ever left. */
-    releaseSelection(): void;
+    retainSelection(): SelectionPin;
+    /** Drop one owned pin. Another owner's pin remains visible. */
+    releaseSelection(pin: SelectionPin): void;
     /** The pinned range, or null once it was released or escaped. */
     retainedSelection(): SemanticSelection | null;
     /**
@@ -2145,6 +2224,17 @@ interface PaginatedSurface {
      */
     editingMode(): SurfaceEditingMode;
     setEditingMode(mode: SurfaceEditingMode): void;
+    /**
+     * Every author with a revision in the CURRENT layout, mapped to Word's colour slot by
+     * order of first appearance. One map instance per layout, so a caller can key caches on
+     * its identity.
+     */
+    revisionAuthors(): ReadonlyMap<string, number>;
+    /**
+     * Replace how tracked changes are coloured, live. Paint-level: the pages repaint without
+     * remeasuring a line, and the caret, selection and undo history stay where they are.
+     */
+    setRevisionStyles(colors: RevisionStyles | undefined): void;
     /**
      * Commit ops that came from automation, through the gate a keystroke goes through.
      *