@docx-editor.dev/core 2.4.0 → 2.5.0

package/dist/editor.d.cts

@@ -1,30 +1,30 @@
-import { F as FontConfiguration, E as EditorFontError, a as EditorCommand, C as CanResult, Z as ZoomMode } from './editor-DYvC9CZs.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-DYvC9CZs.cjs';
-import { L as LayoutShapingOptions } from './shaped-measurer-CBOTJTV_.cjs';
-import { P as PaginatedSurfaceOptions, O as OpenPaginatedResult, a as PaginatedSurface, T as TableCommandPlan, D as DocxEditorInstance } from './index-Bb-QAg_f.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-Bb-QAg_f.cjs';
-import { A as AutomationCapabilities, a as AutomationHost } from './protocol-CD7slqvl.cjs';
+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 { 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-EZXbR8bW.cjs';
-export { i as IMAGE_WRAP_TARGETS, b as ImageWrapTarget } from './tree-op-types-EZXbR8bW.cjs';
-import { f as DocumentThemeColorEntry } from './tree-session-DrMm8Cj2.cjs';
-import { S as SemanticLayout } from './semantic-records-DSD8WENa.cjs';
-export { T as TextMeasurer } from './semantic-records-DSD8WENa.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-DXvPZvXD.cjs';
-export { S as SectionProperties } from './semantic-cell-selection--ezfezTe.cjs';
-export { R as ReviewModelInput } from './review-support-BJ-YjGmD.cjs';
-export { N as NavigationCommand, S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-2yxdv7q0.cjs';
-export { F as FieldShadingMode } from './semantic-paint-BYjE0Xbl.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-72ZApe-g.cjs';
-import './ooxml-tree-BU0e3DVi.cjs';
-import './review-reads-CxgN62yp.cjs';
-import './ooxml-package-CR5us6ad.cjs';
-import './custom-node-writes-C5YRoPcc.cjs';
-import './hf-references-CgEOSw3i.cjs';
-import './note-nodes-C6DLxlvj.cjs';
-import './tree-store-UYrGKF_Q.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 'prosemirror-model';
 
 interface LayoutShapingInstrumentation {

package/dist/editor.d.ts

@@ -1,30 +1,30 @@
-import { F as FontConfiguration, E as EditorFontError, a as EditorCommand, C as CanResult, Z as ZoomMode } from './editor-D1qHfzOt.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-D1qHfzOt.js';
-import { L as LayoutShapingOptions } from './shaped-measurer-BL8g4AcW.js';
-import { P as PaginatedSurfaceOptions, O as OpenPaginatedResult, a as PaginatedSurface, T as TableCommandPlan, D as DocxEditorInstance } from './index-DpY3WZuP.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-DpY3WZuP.js';
-import { A as AutomationCapabilities, a as AutomationHost } from './protocol-DsbfgBwA.js';
+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 { 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-8a6xyRCN.js';
-export { i as IMAGE_WRAP_TARGETS, b as ImageWrapTarget } from './tree-op-types-8a6xyRCN.js';
-import { f as DocumentThemeColorEntry } from './tree-session-SucW0znF.js';
-import { S as SemanticLayout } from './semantic-records-CR5hTqMK.js';
-export { T as TextMeasurer } from './semantic-records-CR5hTqMK.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-BG9DLyW7.js';
-export { S as SectionProperties } from './semantic-cell-selection-DZtyMXkH.js';
-export { R as ReviewModelInput } from './review-support-DgXTIYBW.js';
-export { N as NavigationCommand, S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-DrgbgKg6.js';
-export { F as FieldShadingMode } from './semantic-paint-BedBxkyY.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-DHAkcD_L.js';
-import './ooxml-tree-BU0e3DVi.js';
-import './review-reads-CQmU9Lcl.js';
-import './ooxml-package-D_CtywTW.js';
-import './custom-node-writes-BkMgMXxs.js';
-import './hf-references-BdjsQNE_.js';
-import './note-nodes-BPSTVDMr.js';
-import './tree-store-BoM6eXaL.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 'prosemirror-model';
 
 interface LayoutShapingInstrumentation {

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-FL4GWK76.js';import'./chunk-F6WNPYOM.js';import'./chunk-SG7OH2EK.js';import'./chunk-ZACHY6OS.js';import'./chunk-LIJPSHRA.js';import'./chunk-4WWEDTTE.js';import'./chunk-33F6TRXO.js';export{D as DEFAULT_IMAGE_RESOURCE_LIMITS,qf as DRAWING_REL_FROM_H,rf as DRAWING_REL_FROM_V,Wa as IMAGE_WRAP_TARGETS,tf as positionInputFromPropertiesCommand,sf as propertiesCommandHasPositionFields,E as resolveImageResourceLimits,nb as resolveSvgIntrinsicSize,jb as sniffImageMime,pf as validateDrawingPositionInput,ob as validateRasterHeader,uf as validateSetImagePositionCommand}from'./chunk-TCX3PVWR.js';import'./chunk-GOEBQ26R.js';export{a as resolveEditorModules}from'./chunk-GQQOL4PV.js';
+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';

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

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

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

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

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

@@ -1,5 +1,13 @@
-import { D as DrawingProjection } from './tree-op-types-EZXbR8bW.cjs';
-import { O as OoxmlPackage } from './ooxml-package-CR5us6ad.cjs';
+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;
+}
 
 /**
  * The engine's trust-boundary caps: recursion depth, element counts, and the rest.
@@ -55,14 +63,6 @@ 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-BG9DLyW7.d.ts → image-resources-e13t-pgy.d.ts}

@@ -1,5 +1,13 @@
-import { D as DrawingProjection } from './tree-op-types-8a6xyRCN.js';
-import { O as OoxmlPackage } from './ooxml-package-D_CtywTW.js';
+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;
+}
 
 /**
  * The engine's trust-boundary caps: recursion depth, element counts, and the rest.
@@ -55,14 +63,6 @@ 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-Bb-QAg_f.d.cts → index-8t44iXTY.d.cts}

@@ -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-DYvC9CZs.cjs';
-import { T as TreeDocOp, d as DrawingPositionInput, k as DrawingTransform, m as DrawingTreeDocOp } from './tree-op-types-EZXbR8bW.cjs';
-import { b as ImageDecodePort, S as SupportedImageMime } from './image-resources-DXvPZvXD.cjs';
-import { R as RevisionDisplayMode } from './revision-projection-72ZApe-g.cjs';
-import './review-support-BJ-YjGmD.cjs';
-import { a as SemanticSelection, S as SemanticPosition, N as NavigationCommand } from './semantic-interaction-2yxdv7q0.cjs';
-import { R as ResolvedFootnoteProperties, a as ResolvedEndnoteProperties, A as AuthoredNoteProperties, l as ReviewRevisionKind } from './review-reads-CxgN62yp.cjs';
-import { S as SemanticLayout, C as ContentControlBoundaryRecord, T as TextMeasurer } from './semantic-records-DSD8WENa.cjs';
-import { S as StoryScope, A as ApplyImagePropertiesInput, d as ImageIntentResult, c as InsertImageInput, B as BookmarkIndex } from './custom-node-writes-C5YRoPcc.cjs';
-import { C as CellSelection, S as SectionProperties } from './semantic-cell-selection--ezfezTe.cjs';
+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-CUul9IuY.cjs';
+import { T as TreeDocOp, d as DrawingPositionInput, l as DrawingTransform, j as DrawingTreeDocOp } from './tree-op-types-DOYNkKqD.cjs';
+import { b as ImageDecodePort, S as SupportedImageMime } from './image-resources-CSlQmPIm.cjs';
+import { R as RevisionDisplayMode } from './revision-projection-DRZMzoLD.cjs';
+import './review-support-CHuJxHmz.cjs';
+import { a as SemanticSelection, S as SemanticPosition, N as NavigationCommand } from './semantic-interaction-DgaWs-5w.cjs';
+import { R as ResolvedFootnoteProperties, a as ResolvedEndnoteProperties, A as AuthoredNoteProperties, l as ReviewRevisionKind } from './note-properties-Dhqkro--.cjs';
+import { S as SemanticLayout, C as ContentControlBoundaryRecord, T as TextMeasurer } from './semantic-records-Dq8SlCY8.cjs';
+import { S as StoryScope, A as ApplyImagePropertiesInput, d as ImageIntentResult, c as InsertImageInput, B as BookmarkIndex } from './custom-node-writes-CIC_-wad.cjs';
+import { C as CellSelection, S as SectionProperties } from './semantic-cell-selection-CdNQ-a9-.cjs';
 import { EditorModule, ReviewModuleContribution } from './contracts/modules.cjs';
 import { Unsubscribe, ExecResult, IndentFormatting } from './contracts/types.cjs';
-import { F as FieldShadingMode, a as DrawingPaintStrings } from './semantic-paint-BYjE0Xbl.cjs';
-import { T as TreeDocxSession, a as TreeApplyResult } from './tree-session-DrMm8Cj2.cjs';
+import { F as FieldShadingMode, a as DrawingPaintStrings } from './semantic-paint-6iIB4fhx.cjs';
+import { T as TreeDocxSession, a as TreeApplyResult } from './tree-session-CtK3KgFU.cjs';
 import './contracts/document.cjs';
 
 /**
@@ -1004,6 +1004,14 @@ interface HyperlinkOps {
     linksInCaretParagraph(): SurfaceHyperlink[];
     /** The link the caret sits in, or null. */
     linkAtCaret(): SurfaceHyperlink | null;
+    /**
+     * The FIELD link whose painted atom the caret sits on, or null.
+     *
+     * Separate from {@link linkAtCaret} on purpose: a `HYPERLINK` field is not a tree node, so
+     * the typed lane never returns one, and link-create must not mistake a field atom for an
+     * editable link. Resolved from the layout projection, boundary-inclusive.
+     */
+    fieldLinkAtCaret(): SurfaceHyperlink | null;
     /** The link with this node id, or null. */
     linkById(linkId: string): SurfaceHyperlink | null;
     /**
@@ -1111,8 +1119,20 @@ interface DocxEditorConfig {
      * reason. See {@link EditorModule}.
      */
     modules?: readonly EditorModule[];
-    /** `'view'` refuses every mutating command through the facade; default `'edit'`. */
-    mode?: 'edit' | 'view';
+    /**
+     * The mode the editor opens in — one prop, matching the toolbar's three-state pill.
+     *
+     * - `'edit'` — opens in editing, even when the document's `w:trackRevisions` asks for
+     *   tracked changes; the reader still moves between modes from the toolbar.
+     * - `'suggesting'` — opens in suggesting. It needs what suggesting always needs — a
+     *   review module and an {@link DocxEditorConfig.author} — and falls back to editing
+     *   with the reason published when either is missing.
+     * - `'view'` — read-only: every mutating command through the facade is refused, and
+     *   the toolbar cannot leave viewing.
+     * - Omitted — the DOCUMENT decides: a package carrying `w:trackRevisions` opens in
+     *   suggesting, everything else in editing.
+     */
+    mode?: 'edit' | 'view' | 'suggesting';
     /** Override raster decode for insert/replace image commands; defaults to browser/headless. */
     imageDecodePort?: ImageDecodePort;
     /**
@@ -1827,6 +1847,21 @@ interface PaginatedSurface {
     /** One-based page at the caret, or at the centre of the mounted viewport. */
     currentPage(mode?: 'viewport' | 'caret'): number;
     type(text: string): void;
+    /**
+     * Queue plain typed text for a batched commit at the caret.
+     *
+     * The DOM input lane's entry: keystrokes arriving in a burst append here and land
+     * through ONE `type()` call — one transaction, one undo step, one layout flush —
+     * when the input queue drains. Every surface-level mutation, selection or scope
+     * move, geometry read, composition start and teardown flushes the buffer first.
+     * Code reading `session` directly (its text or its bytes) sits BELOW the buffer
+     * and must call {@link flushPendingInput} first, as the facade's save/detach
+     * paths do. `type()` itself stays synchronous; automation and commands should
+     * keep calling it directly.
+     */
+    enqueueType(text: string): void;
+    /** Land any queued typed text now, as its own transaction. No-op when empty. */
+    flushPendingInput(): void;
     /**
      * Insert text whose newlines are PARAGRAPH BOUNDARIES, in one commit.
      *
@@ -2168,6 +2203,36 @@ interface PaginatedSurface {
      * while the text stayed highlighted.
      */
     activeReviewKey(): string | null;
+    /**
+     * Open THIS item, named by key, for as long as `selection` stays the live one.
+     *
+     * Without it the caret is the only evidence of which card is open, and a caret cannot name a
+     * card when two cards cover exactly the same characters: `w:ins` wrapping `w:del` — content
+     * one reviewer added and another struck — gives the insertion and the deletion one identical
+     * range, and every click on either card classified back to whichever the queue happened to
+     * list first. The reader clicked "Deleted" and watched "Added" light up.
+     *
+     * A key, not a position, because the position is precisely what is ambiguous. It holds only
+     * while the selection matches; a pointer or keyboard move hands the answer back to the caret,
+     * which is what lets the reader step out of a card by clicking away from it.
+     *
+     * `selection` is what activation wants installed, and it is installed HERE rather than by a
+     * `setSelection` of the caller's own so that the pin is up before anything is published. The
+     * other order repainted the bands and reported state while the caret was still the only
+     * evidence, so a host saw the wrong twin active for one frame and then a correction. Omit it
+     * to pin against the live selection, which is what a header or note scope has already set.
+     */
+    activateReview(key: string, selection?: SemanticSelection): void;
+    /**
+     * The key {@link activateReview} pinned, or null once its selection is no longer live.
+     *
+     * Exists so nothing outside the surface keeps its own copy of "the selection came from
+     * opening a card". `selectionPlacement` needs that fact to stay quiet about offering a
+     * comment on text the reader only selected by opening a card over it, and the copy it used to
+     * keep was set on one of activation's three branches, so a header card offered to comment on
+     * itself.
+     */
+    activatedReviewKey(): string | null;
     /**
      * Close the open item until the caret next moves.
      *

package/dist/{index-DpY3WZuP.d.ts → index-BUsYjxF5.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-D1qHfzOt.js';
-import { T as TreeDocOp, d as DrawingPositionInput, k as DrawingTransform, m as DrawingTreeDocOp } from './tree-op-types-8a6xyRCN.js';
-import { b as ImageDecodePort, S as SupportedImageMime } from './image-resources-BG9DLyW7.js';
-import { R as RevisionDisplayMode } from './revision-projection-DHAkcD_L.js';
-import './review-support-DgXTIYBW.js';
-import { a as SemanticSelection, S as SemanticPosition, N as NavigationCommand } from './semantic-interaction-DrgbgKg6.js';
-import { R as ResolvedFootnoteProperties, a as ResolvedEndnoteProperties, A as AuthoredNoteProperties, l as ReviewRevisionKind } from './review-reads-CQmU9Lcl.js';
-import { S as SemanticLayout, C as ContentControlBoundaryRecord, T as TextMeasurer } from './semantic-records-CR5hTqMK.js';
-import { S as StoryScope, A as ApplyImagePropertiesInput, d as ImageIntentResult, c as InsertImageInput, B as BookmarkIndex } from './custom-node-writes-BkMgMXxs.js';
-import { C as CellSelection, S as SectionProperties } from './semantic-cell-selection-DZtyMXkH.js';
+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 { EditorModule, ReviewModuleContribution } from './contracts/modules.js';
 import { Unsubscribe, ExecResult, IndentFormatting } from './contracts/types.js';
-import { F as FieldShadingMode, a as DrawingPaintStrings } from './semantic-paint-BedBxkyY.js';
-import { T as TreeDocxSession, a as TreeApplyResult } from './tree-session-SucW0znF.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 './contracts/document.js';
 
 /**
@@ -1004,6 +1004,14 @@ interface HyperlinkOps {
     linksInCaretParagraph(): SurfaceHyperlink[];
     /** The link the caret sits in, or null. */
     linkAtCaret(): SurfaceHyperlink | null;
+    /**
+     * The FIELD link whose painted atom the caret sits on, or null.
+     *
+     * Separate from {@link linkAtCaret} on purpose: a `HYPERLINK` field is not a tree node, so
+     * the typed lane never returns one, and link-create must not mistake a field atom for an
+     * editable link. Resolved from the layout projection, boundary-inclusive.
+     */
+    fieldLinkAtCaret(): SurfaceHyperlink | null;
     /** The link with this node id, or null. */
     linkById(linkId: string): SurfaceHyperlink | null;
     /**
@@ -1111,8 +1119,20 @@ interface DocxEditorConfig {
      * reason. See {@link EditorModule}.
      */
     modules?: readonly EditorModule[];
-    /** `'view'` refuses every mutating command through the facade; default `'edit'`. */
-    mode?: 'edit' | 'view';
+    /**
+     * The mode the editor opens in — one prop, matching the toolbar's three-state pill.
+     *
+     * - `'edit'` — opens in editing, even when the document's `w:trackRevisions` asks for
+     *   tracked changes; the reader still moves between modes from the toolbar.
+     * - `'suggesting'` — opens in suggesting. It needs what suggesting always needs — a
+     *   review module and an {@link DocxEditorConfig.author} — and falls back to editing
+     *   with the reason published when either is missing.
+     * - `'view'` — read-only: every mutating command through the facade is refused, and
+     *   the toolbar cannot leave viewing.
+     * - Omitted — the DOCUMENT decides: a package carrying `w:trackRevisions` opens in
+     *   suggesting, everything else in editing.
+     */
+    mode?: 'edit' | 'view' | 'suggesting';
     /** Override raster decode for insert/replace image commands; defaults to browser/headless. */
     imageDecodePort?: ImageDecodePort;
     /**
@@ -1827,6 +1847,21 @@ interface PaginatedSurface {
     /** One-based page at the caret, or at the centre of the mounted viewport. */
     currentPage(mode?: 'viewport' | 'caret'): number;
     type(text: string): void;
+    /**
+     * Queue plain typed text for a batched commit at the caret.
+     *
+     * The DOM input lane's entry: keystrokes arriving in a burst append here and land
+     * through ONE `type()` call — one transaction, one undo step, one layout flush —
+     * when the input queue drains. Every surface-level mutation, selection or scope
+     * move, geometry read, composition start and teardown flushes the buffer first.
+     * Code reading `session` directly (its text or its bytes) sits BELOW the buffer
+     * and must call {@link flushPendingInput} first, as the facade's save/detach
+     * paths do. `type()` itself stays synchronous; automation and commands should
+     * keep calling it directly.
+     */
+    enqueueType(text: string): void;
+    /** Land any queued typed text now, as its own transaction. No-op when empty. */
+    flushPendingInput(): void;
     /**
      * Insert text whose newlines are PARAGRAPH BOUNDARIES, in one commit.
      *
@@ -2168,6 +2203,36 @@ interface PaginatedSurface {
      * while the text stayed highlighted.
      */
     activeReviewKey(): string | null;
+    /**
+     * Open THIS item, named by key, for as long as `selection` stays the live one.
+     *
+     * Without it the caret is the only evidence of which card is open, and a caret cannot name a
+     * card when two cards cover exactly the same characters: `w:ins` wrapping `w:del` — content
+     * one reviewer added and another struck — gives the insertion and the deletion one identical
+     * range, and every click on either card classified back to whichever the queue happened to
+     * list first. The reader clicked "Deleted" and watched "Added" light up.
+     *
+     * A key, not a position, because the position is precisely what is ambiguous. It holds only
+     * while the selection matches; a pointer or keyboard move hands the answer back to the caret,
+     * which is what lets the reader step out of a card by clicking away from it.
+     *
+     * `selection` is what activation wants installed, and it is installed HERE rather than by a
+     * `setSelection` of the caller's own so that the pin is up before anything is published. The
+     * other order repainted the bands and reported state while the caret was still the only
+     * evidence, so a host saw the wrong twin active for one frame and then a correction. Omit it
+     * to pin against the live selection, which is what a header or note scope has already set.
+     */
+    activateReview(key: string, selection?: SemanticSelection): void;
+    /**
+     * The key {@link activateReview} pinned, or null once its selection is no longer live.
+     *
+     * Exists so nothing outside the surface keeps its own copy of "the selection came from
+     * opening a card". `selectionPlacement` needs that fact to stay quiet about offering a
+     * comment on text the reader only selected by opening a card over it, and the copy it used to
+     * keep was set on one of activation's three branches, so a header card offered to comment on
+     * itself.
+     */
+    activatedReviewKey(): string | null;
     /**
      * Close the open item until the caret next moves.
      *

package/dist/index.cjs

@@ -1 +1 @@
-'use strict';var chunkIZIL6BAW_cjs=require('./chunk-IZIL6BAW.cjs');require('./chunk-YTYKNA6X.cjs'),require('./chunk-DQ5HGUWG.cjs'),require('./chunk-YMIMLEX4.cjs'),require('./chunk-GWG5IVVX.cjs'),require('./chunk-BS554B6D.cjs'),require('./chunk-MHDO6HLI.cjs'),require('./chunk-EQO762XH.cjs'),require('./chunk-OHJQ7GPZ.cjs'),require('./chunk-7VQ7YLW3.cjs');Object.defineProperty(exports,"CHROME_GROUPS",{enumerable:true,get:function(){return chunkIZIL6BAW_cjs.sa}});Object.defineProperty(exports,"CHROME_MENUS",{enumerable:true,get:function(){return chunkIZIL6BAW_cjs.wa}});Object.defineProperty(exports,"WORD_DEFAULT_FONT",{enumerable:true,get:function(){return chunkIZIL6BAW_cjs.e}});Object.defineProperty(exports,"blankDocumentBytes",{enumerable:true,get:function(){return chunkIZIL6BAW_cjs.g}});Object.defineProperty(exports,"chromeMenuSlots",{enumerable:true,get:function(){return chunkIZIL6BAW_cjs.xa}});Object.defineProperty(exports,"commandForSlot",{enumerable:true,get:function(){return chunkIZIL6BAW_cjs.ha}});Object.defineProperty(exports,"commandForSlotValue",{enumerable:true,get:function(){return chunkIZIL6BAW_cjs.ja}});Object.defineProperty(exports,"composeFontConfiguration",{enumerable:true,get:function(){return chunkIZIL6BAW_cjs.f}});Object.defineProperty(exports,"createDocxEditor",{enumerable:true,get:function(){return chunkIZIL6BAW_cjs.Ia}});Object.defineProperty(exports,"createFontSource",{enumerable:true,get:function(){return chunkIZIL6BAW_cjs.i}});Object.defineProperty(exports,"loadFonts",{enumerable:true,get:function(){return chunkIZIL6BAW_cjs.h}});Object.defineProperty(exports,"runToolbarCommand",{enumerable:true,get:function(){return chunkIZIL6BAW_cjs.oa}});Object.defineProperty(exports,"toolbarCommandState",{enumerable:true,get:function(){return chunkIZIL6BAW_cjs.la}});
+'use strict';var chunkL2GMLEHX_cjs=require('./chunk-L2GMLEHX.cjs');require('./chunk-7GYF33B5.cjs'),require('./chunk-3C533HSQ.cjs'),require('./chunk-3FRSOOND.cjs'),require('./chunk-H3DZP4LE.cjs'),require('./chunk-IJ4V3LGV.cjs'),require('./chunk-JDHTCMFA.cjs'),require('./chunk-2GSRLGUI.cjs'),require('./chunk-OHJQ7GPZ.cjs'),require('./chunk-7VQ7YLW3.cjs');Object.defineProperty(exports,"CHROME_GROUPS",{enumerable:true,get:function(){return chunkL2GMLEHX_cjs.sa}});Object.defineProperty(exports,"CHROME_MENUS",{enumerable:true,get:function(){return chunkL2GMLEHX_cjs.wa}});Object.defineProperty(exports,"WORD_DEFAULT_FONT",{enumerable:true,get:function(){return chunkL2GMLEHX_cjs.e}});Object.defineProperty(exports,"blankDocumentBytes",{enumerable:true,get:function(){return chunkL2GMLEHX_cjs.g}});Object.defineProperty(exports,"chromeMenuSlots",{enumerable:true,get:function(){return chunkL2GMLEHX_cjs.xa}});Object.defineProperty(exports,"commandForSlot",{enumerable:true,get:function(){return chunkL2GMLEHX_cjs.ha}});Object.defineProperty(exports,"commandForSlotValue",{enumerable:true,get:function(){return chunkL2GMLEHX_cjs.ja}});Object.defineProperty(exports,"composeFontConfiguration",{enumerable:true,get:function(){return chunkL2GMLEHX_cjs.f}});Object.defineProperty(exports,"createDocxEditor",{enumerable:true,get:function(){return chunkL2GMLEHX_cjs.Ia}});Object.defineProperty(exports,"createFontSource",{enumerable:true,get:function(){return chunkL2GMLEHX_cjs.i}});Object.defineProperty(exports,"loadFonts",{enumerable:true,get:function(){return chunkL2GMLEHX_cjs.h}});Object.defineProperty(exports,"runToolbarCommand",{enumerable:true,get:function(){return chunkL2GMLEHX_cjs.oa}});Object.defineProperty(exports,"toolbarCommandState",{enumerable:true,get:function(){return chunkL2GMLEHX_cjs.la}});

package/dist/index.d.cts

@@ -1,22 +1,22 @@
-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-DYvC9CZs.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-EZXbR8bW.cjs';
-export { I as ImageResourceState, P as PreservedImageMime, R as RenderableImageMime, S as SupportedImageMime, V as ValidatedImageBytesHandle, a as VectorImageMime } from './image-resources-DXvPZvXD.cjs';
-export { R as RevisionDisplayMode } from './revision-projection-72ZApe-g.cjs';
-export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, R as ReviewModelInput, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind } from './review-support-BJ-YjGmD.cjs';
-export { S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-2yxdv7q0.cjs';
-export { C as CHROME_GROUPS, b as CHROME_MENUS, i as ChromeMenu, j as ChromeMenuEntry, k as ChromeMenuId, l as ChromeMenuItemEntry, m as ChromeMenuSeparatorEntry, n as ChromeMenuSubmenuEntry, o as ChromeSlotId, q as DocxEditorConfig, D as DocxEditorInstance, 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, N as LoadFontsRequest, Q as LoadFontsResult, Y as SurfaceHyperlink, ab as ToolbarCommandState, ac as WORD_DEFAULT_FONT, ae as blankDocumentBytes, ai as chromeMenuSlots, al as commandForSlot, am as commandForSlotValue, ao as composeFontConfiguration, as as createDocxEditor, at as createFontSource, aF as loadFonts, aN as runToolbarCommand, aW as toolbarCommandState } from './index-Bb-QAg_f.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-CUul9IuY.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-DOYNkKqD.cjs';
+export { I as ImageResourceState, P as PreservedImageMime, R as RenderableImageMime, S as SupportedImageMime, V as ValidatedImageBytesHandle, a as VectorImageMime } from './image-resources-CSlQmPIm.cjs';
+export { R as RevisionDisplayMode } from './revision-projection-DRZMzoLD.cjs';
+export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, R as ReviewModelInput, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind } from './review-support-CHuJxHmz.cjs';
+export { S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-DgaWs-5w.cjs';
+export { C as CHROME_GROUPS, b as CHROME_MENUS, i as ChromeMenu, j as ChromeMenuEntry, k as ChromeMenuId, l as ChromeMenuItemEntry, m as ChromeMenuSeparatorEntry, n as ChromeMenuSubmenuEntry, o as ChromeSlotId, q as DocxEditorConfig, D as DocxEditorInstance, 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, N as LoadFontsRequest, Q as LoadFontsResult, Y as SurfaceHyperlink, ab as ToolbarCommandState, ac as WORD_DEFAULT_FONT, ae as blankDocumentBytes, ai as chromeMenuSlots, al as commandForSlot, am as commandForSlotValue, ao as composeFontConfiguration, as as createDocxEditor, at as createFontSource, aF as loadFonts, aN as runToolbarCommand, aW as toolbarCommandState } from './index-8t44iXTY.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 './contracts/types.cjs';
 export { ApplyResult, ContentControlSummary, DocEdit, DocEdits, DocQueries, DocQuery, DocQueryResults, ParagraphSummary } from './contracts/document.cjs';
 export { CollectReviewItems, EditorModule, ReviewModuleContribution } from './contracts/modules.cjs';
-import './ooxml-tree-BU0e3DVi.cjs';
-import './ooxml-package-CR5us6ad.cjs';
-import './semantic-records-DSD8WENa.cjs';
-import './review-reads-CxgN62yp.cjs';
-import './custom-node-writes-C5YRoPcc.cjs';
-import './hf-references-CgEOSw3i.cjs';
-import './note-nodes-C6DLxlvj.cjs';
-import './tree-store-UYrGKF_Q.cjs';
-import './semantic-cell-selection--ezfezTe.cjs';
-import './semantic-paint-BYjE0Xbl.cjs';
-import './tree-session-DrMm8Cj2.cjs';
+import './ooxml-tree-CG0odFyi.cjs';
+import './ooxml-package-Cmbe_M04.cjs';
+import './semantic-records-Dq8SlCY8.cjs';
+import './note-properties-Dhqkro--.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 './semantic-cell-selection-CdNQ-a9-.cjs';
+import './semantic-paint-6iIB4fhx.cjs';
+import './tree-session-CtK3KgFU.cjs';
 import 'prosemirror-model';