@docx-editor.dev/core 2.10.0 → 2.12.0

package/dist/editor.d.cts

@@ -1,33 +1,34 @@
-import { l as TreeDocColorValue, d as DrawingPositionInput } from './tree-op-types-DSJYmf5b.cjs';
-export { m as DEFAULT_IMAGE_RESOURCE_LIMITS, n as IMAGE_WRAP_TARGETS, j as ImageDecodePort, o as ImageResourceLimits, b as ImageWrapTarget, R as RenderableImageMime, c as SupportedImageMime, i as VectorImageMime, r as resolveImageResourceLimits, p as resolveSvgIntrinsicSize, s as sniffImageMime, v as validateRasterHeader } from './tree-op-types-DSJYmf5b.cjs';
+import { O as OoxmlPart, N as TreeDocColorValue, v as DrawingPositionInput } from './tree-op-types-CA7qgAUF.cjs';
+export { Q as DEFAULT_IMAGE_RESOURCE_LIMITS, U as IMAGE_WRAP_TARGETS, C as ImageDecodePort, W as ImageResourceLimits, u as ImageWrapTarget, t as RenderableImageMime, y as SupportedImageMime, B as VectorImageMime, X as resolveImageResourceLimits, Y as resolveSvgIntrinsicSize, Z as sniffImageMime, _ as validateRasterHeader } from './tree-op-types-CA7qgAUF.cjs';
 import { ColorValue } from './contracts/types.cjs';
 export { ParagraphFlags, ParagraphTabStop } from './contracts/types.cjs';
-export { R as ReviewModelInput } from './review-items-CwixiHNe.cjs';
+export { R as ReviewModelInput } from './review-items-C-2WQdEb.cjs';
 export { CollectReviewItems, EditorModule, EditorModuleRegistry, ReviewModuleContribution, resolveEditorModules } from './contracts/modules.cjs';
-import { T as TreeDocxSessionView, e as DocumentThemeColorEntry } from './tree-session-contract-ByWx8eew.cjs';
-export { a as TreeApplyResult } from './tree-session-contract-ByWx8eew.cjs';
-import { F as FontConfiguration, E as EditorFontError, a as EditorSnapshot, b as EditorCommand, C as CanResult, Z as ZoomMode } from './editor-CwzY2Hcg.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-CwzY2Hcg.cjs';
-import { L as LayoutShapingOptions } from './shaped-measurer-DzRwWrL5.cjs';
-import { P as PaginatedSurfaceOptions, O as OpenPaginatedResult, a as PaginatedSurface, T as TableCommandPlan, D as DocxEditorInstance } from './index-nLFwo_17.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, r as DrawingSelectionIntent, E as EMU_PER_POINT, s as EquationActivation, t as EquationChromeHandlers, u as EquationOps, F as FinalizedImageOverlayInteraction, v as FontConfigurationBase, w as FontConfigurationFragment, x as FontLoadFailure, y as FontLoadFailureReason, z as FontMeasurementState, B as FontResolutionRequest, G as FontResolver, H as FontUrlSource, I as HyperlinkActivation, J as HyperlinkChromeHandlers, K as HyperlinkOps, L as IMAGE_OVERLAY_NUDGE_PT, M as IMAGE_OVERLAY_NUDGE_SHIFT_PT, N as ImageInteractionSession, Q as ImageOverlayScrollPort, R as ImageResizeHandle, S as ImageResizeResult, U as LoadFontsRequest, V as LoadFontsResult, W as MAX_RESOLVER_FAMILIES, X as OverlayFrameRect, Y as PaginatedSurfaceState, Z as ParagraphPropertyEdit, _ as RunTableChromeCommandResult, $ as SectionAnchor, a0 as SectionBreakInsertType, a1 as SelectedDrawingOverlayTarget, a2 as SurfaceEquation, a3 as SurfaceFormatting, a4 as SurfaceHyperlink, a5 as SurfaceNavigation, a6 as SurfaceOverlayCoordinates, a7 as SurfaceParagraphFormat, a8 as TABLE_BORDER_STYLE_OPTIONS, a9 as TABLE_BORDER_TARGET_OPTIONS, aa as TABLE_BORDER_WIDTH_OPTIONS, ab as TABLE_CHROME_SLOT_IDS, ac as TableBorderStyleOption, ad as TableBorderTargetOption, ae as TableBorderTargetValue, af as TableBorderWidthOption, ag as TableChromeDraft, ah as TableChromePick, ai as TableChromeSlotId, aj as TableInteractionLabelKey, ak as ToolbarCommandState, al as WORD_DEFAULT_FONT, am as applyTableChromePick, an as blankDocumentBytes, ao as canExecuteImageCommand, ap as captureImageMutationPreconditions, aq as chromeControlCount, ar as chromeMenuSlots, as as chromeProbeForSlot, at as chromeSlotId, au as commandForSlot, av as commandForSlotValue, aw as commandForTableChromeSlotValue, ax as composeFontConfiguration, ay as computeImageResizeResult, az as computeMovedImagePosition, aA as computeResizedImageExtentEmu, aB as createDocxEditor, aC as createFontSource, aD as createImageOverlayScrollPort, aE as cssPixelsToLayoutPoints, aF as defaultChromeGroups, aG as defaultTableLabel, aH as emuToOverlayPoints, aI as equationAtPosition, aJ as executeImageCommand, aK as finalizeImageOverlayInteraction, aL as formattingBarChromeGroups, aM as isStaleImageInteractionCommit, aN as isTableChromeSlot, aO as layoutPointsToCssPixels, aP as loadFonts, aQ as overlayFrameToSheetCssPixels, aR as overlayHostOrigin, aS as pointsToEmu, aT as probeTableChromeCommand, aU as resizePreservesAspect, aV as runSave, aW as runTableChromeCommand, aX as runTableCommand, aY as runToolbarCommand, aZ as selectedDrawingOverlayTargetOf, a_ as selectedImageStateOf, a$ as surfacePaintScale, b0 as tableChromeIconPaths, b1 as tableChromeLabelKeyForTarget, b2 as tableChromeToolbarState, b3 as tableChromeVisible, b4 as tableCommandToolbarState, b5 as toolbarCommandState, b6 as toolbarCommandStates } from './index-nLFwo_17.cjs';
-import { O as OoxmlPart } from './ooxml-package-CdEy9ufK.cjs';
-import { A as AutomationCapabilities, a as AutomationHost } from './protocol-UuZOcOp7.cjs';
-import { S as SemanticLayout } from './semantic-records-CMakzQ1X.cjs';
-export { T as TextMeasurer } from './semantic-records-CMakzQ1X.cjs';
-export { S as SectionProperties } from './semantic-cell-selection-DT9x9WLf.cjs';
-export { N as NavigationCommand, S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-Z0xKQcB4.cjs';
-export { F as FieldShadingMode, R as ReviewAuthorInfo, a as RevisionAuthorAssignments, b as RevisionAuthorStyle, c as RevisionStyles } from './semantic-paint-CQEOC0Od.cjs';
-import './tree-op-revision-attribution-CN06Xshv.cjs';
-import './revision-projection-Cc4wz30g.cjs';
-import './custom-node-writes-Db8H6Z3n.cjs';
-import './hf-references-Dvk6De4Q.cjs';
-import './note-nodes-DL-Au22P.cjs';
-import './tree-store-CWOUMGN8.cjs';
+import { T as TreeDocxSessionView, f as DocumentThemeColorEntry } from './tree-session-contract-Cbl87xa8.cjs';
+export { a as TreeApplyResult } from './tree-session-contract-Cbl87xa8.cjs';
+import { F as FontConfiguration, E as EditorFontError, a as EditorSnapshot, b as EditorCommand, C as CanResult, Z as ZoomMode } from './editor-B76SEMZw.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-B76SEMZw.cjs';
+import { L as LayoutShapingOptions } from './shaped-measurer-CneACGcP.cjs';
+import { P as PaginatedSurfaceOptions, O as OpenPaginatedResult, a as PaginatedSurface, T as TableCommandPlan, D as DocxEditorInstance } from './index-CDGhPib1.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, r as DrawingSelectionIntent, E as EMU_PER_POINT, s as EquationActivation, t as EquationChromeHandlers, u as EquationOps, F as FinalizedImageOverlayInteraction, v as FontConfigurationBase, w as FontConfigurationFragment, x as FontLoadFailure, y as FontLoadFailureReason, z as FontMeasurementState, B as FontResolutionRequest, G as FontResolver, H as FontUrlSource, I as HyperlinkActivation, J as HyperlinkChromeHandlers, K as HyperlinkOps, L as IMAGE_OVERLAY_NUDGE_PT, M as IMAGE_OVERLAY_NUDGE_SHIFT_PT, N as ImageInteractionSession, Q as ImageOverlayScrollPort, R as ImageResizeHandle, S as ImageResizeResult, U as LoadFontsRequest, V as LoadFontsResult, W as MAX_RESOLVER_FAMILIES, X as OverlayFrameRect, Y as PaginatedSurfaceState, Z as ParagraphPropertyEdit, _ as RemoteCaretLabelAnchor, $ as RemoteCaretLabelHost, a0 as ReviewWriteIntent, a1 as RunTableChromeCommandResult, a2 as SectionAnchor, a3 as SectionBreakInsertType, a4 as SelectedDrawingOverlayTarget, a5 as SurfaceEquation, a6 as SurfaceFormatting, a7 as SurfaceHyperlink, a8 as SurfaceInsertImageInput, a9 as SurfaceNavigation, aa as SurfaceOverlayCoordinates, ab as SurfaceParagraphFormat, ac as TABLE_BORDER_STYLE_OPTIONS, ad as TABLE_BORDER_TARGET_OPTIONS, ae as TABLE_BORDER_WIDTH_OPTIONS, af as TABLE_CHROME_SLOT_IDS, ag as TableBorderStyleOption, ah as TableBorderTargetOption, ai as TableBorderTargetValue, aj as TableBorderWidthOption, ak as TableChromeDraft, al as TableChromePick, am as TableChromeSlotId, an as TableInteractionLabelKey, ao as ToolbarCommandState, ap as WORD_DEFAULT_FONT, aq as applyTableChromePick, ar as blankDocumentBytes, as as canExecuteImageCommand, at as captureImageMutationPreconditions, au as chromeControlCount, av as chromeMenuSlots, aw as chromeProbeForSlot, ax as chromeSlotId, ay as chromeSlotIsToggle, az as commandForSlot, aA as commandForSlotValue, aB as commandForTableChromeSlotValue, aC as composeFontConfiguration, aD as computeImageResizeResult, aE as computeMovedImagePosition, aF as computeResizedImageExtentEmu, aG as createDocxEditor, aH as createFontSource, aI as createImageOverlayScrollPort, aJ as cssPixelsToLayoutPoints, aK as defaultChromeGroups, aL as defaultTableLabel, aM as emuToOverlayPoints, aN as equationAtPosition, aO as executeImageCommand, aP as finalizeImageOverlayInteraction, aQ as formattingBarChromeGroups, aR as isStaleImageInteractionCommit, aS as isTableChromeSlot, aT as layoutPointsToCssPixels, aU as loadFonts, aV as overlayFrameToSheetCssPixels, aW as overlayHostOrigin, aX as pointsToEmu, aY as probeTableChromeCommand, aZ as resizePreservesAspect, a_ as runSave, a$ as runTableChromeCommand, b0 as runTableCommand, b1 as runToolbarCommand, b2 as selectedDrawingOverlayTargetOf, b3 as selectedImageStateOf, b4 as surfacePaintScale, b5 as tableChromeIconPaths, b6 as tableChromeLabelKeyForTarget, b7 as tableChromeToolbarState, b8 as tableChromeVisible, b9 as tableCommandToolbarState, ba as toolbarCommandState, bb as toolbarCommandStates } from './index-CDGhPib1.cjs';
+import { A as AutomationCapabilities, a as AutomationHost } from './protocol-FTXtrAIT.cjs';
+import { S as SemanticLayout } from './semantic-records-CRG1r6-a.cjs';
+export { T as TextMeasurer } from './semantic-records-CRG1r6-a.cjs';
+export { S as SectionProperties } from './semantic-cell-selection-nEE7E3Z8.cjs';
+export { N as NavigationCommand, S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-DiOX0FIH.cjs';
+export { F as FieldShadingMode, R as ReviewAuthorInfo, a as RevisionAuthorAssignments, b as RevisionAuthorStyle, c as RevisionStyles } from './semantic-paint-Cc11nrDL.cjs';
+export { CollaborationModuleContribution } from './collaboration.cjs';
+import './revision-projection-6u8lae9J.cjs';
+import './tree-package-fragment-Cz-v-0B3.cjs';
+import './tree-store-BenW0Mg_.cjs';
+import './collaboration/replication.cjs';
+import './failure-BnGjoXf0.cjs';
+import './custom-node-writes-D4rMJIES.cjs';
+import './document-properties-D6Ahr8D6.cjs';
 import 'prosemirror-model';
 import './contracts/document.cjs';
-import './note-properties-CQlxjic_.cjs';
-import './omml-equation-BD-LsmWE.cjs';
+import './note-properties-zQ8w04en.cjs';
+import './omml-equation-BmV51rim.cjs';
 
 interface LayoutShapingInstrumentation {
     readonly onFontByteCopy?: () => void;
@@ -60,6 +61,39 @@ declare function disposeLayoutShaping(shaping: LayoutShapingOptions): void;
  */
 declare const LOADING_SNAPSHOT: EditorSnapshot;
 
+/**
+ * True when the engine's PASTE lanes will land user-visible content from this payload, so
+ * a host's image-FILE lane must stand down or insert a duplicate.
+ *
+ * In order of cost: visible `text/plain` (the plain lane's unconditional fallback), visible
+ * HTML text (the projection and the plain lane's HTML fallback both land it), a
+ * zip-shaped embedded fragment, and finally the projection probe for text-free HTML.
+ *
+ * Deliberate asymmetries against the router's letter: text made only of invisible
+ * characters (zero-width wrappers, bidi marks, a bare newline) does not count — the router
+ * technically lands it, but standing down for it would drop a real image for characters
+ * nobody can see. And engine-state gates the adapter cannot observe (suggesting mode, cell
+ * selections, the force-plain window) are ignored; in those states the engine may land
+ * nothing where this predicate said it would.
+ *
+ * @internal
+ */
+declare function clipboardPasteLandsContent(transfer: DataTransfer | null | undefined): boolean;
+/**
+ * True when the engine's DROP lane will land text from this payload, so a host's
+ * image-FILE drop lane must stand down — by NOT preventing the default, which is what
+ * lets the browser fire `insertFromDrop`, the engine's only drop path.
+ *
+ * Only visible HTML text counts. The drop lane is plain text end to end, so fragments and
+ * `data:` images never land from a drop — and `text/plain` says nothing about intent here,
+ * because image-file drags routinely mirror the file's path or URL into it. A text drag
+ * that carries an image file beside it (Word's rendering PNG again) always carries the
+ * text in HTML too.
+ *
+ * @internal
+ */
+declare function clipboardDropLandsText(transfer: DataTransfer | null | undefined): boolean;
+
 /**
  * Mount a paginated surface over DOCX bytes.
  *
@@ -356,4 +390,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, 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, TreeDocxSessionView, ZOOM_MAX, ZOOM_MIN, applyThemeShade, applyThemeTint, createBrowserAutomationHost, createLayoutShaping, disposeLayoutShaping, dragIndent, editorCommandKey, generateRulerTicks, handlePosition, lowerColorValueForBorder, lowerColorValueForFill, mountPaginatedSurface, partOfNodeId, 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, TreeDocxSessionView, ZOOM_MAX, ZOOM_MIN, applyThemeShade, applyThemeTint, clipboardDropLandsText, clipboardPasteLandsContent, createBrowserAutomationHost, createLayoutShaping, disposeLayoutShaping, dragIndent, editorCommandKey, generateRulerTicks, handlePosition, lowerColorValueForBorder, lowerColorValueForFill, mountPaginatedSurface, partOfNodeId, positionInputFromPropertiesCommand, propertiesCommandHasPositionFields, resolveColorValueToCss, resolveThemeColorHex, resolveZoomMode, rulerPageBox, sameZoomMode, snapTwips, surfaceExtent, tableCommandState, toEditorFontError, validateDrawingPositionInput, validateSetImagePositionCommand, validateThemeModifier };

package/dist/editor.d.ts

@@ -1,33 +1,34 @@
-import { l as TreeDocColorValue, d as DrawingPositionInput } from './tree-op-types-BuOfCrkp.js';
-export { m as DEFAULT_IMAGE_RESOURCE_LIMITS, n as IMAGE_WRAP_TARGETS, j as ImageDecodePort, o as ImageResourceLimits, b as ImageWrapTarget, R as RenderableImageMime, c as SupportedImageMime, i as VectorImageMime, r as resolveImageResourceLimits, p as resolveSvgIntrinsicSize, s as sniffImageMime, v as validateRasterHeader } from './tree-op-types-BuOfCrkp.js';
+import { O as OoxmlPart, N as TreeDocColorValue, v as DrawingPositionInput } from './tree-op-types-HKfUzt_-.js';
+export { Q as DEFAULT_IMAGE_RESOURCE_LIMITS, U as IMAGE_WRAP_TARGETS, C as ImageDecodePort, W as ImageResourceLimits, u as ImageWrapTarget, t as RenderableImageMime, y as SupportedImageMime, B as VectorImageMime, X as resolveImageResourceLimits, Y as resolveSvgIntrinsicSize, Z as sniffImageMime, _ as validateRasterHeader } from './tree-op-types-HKfUzt_-.js';
 import { ColorValue } from './contracts/types.js';
 export { ParagraphFlags, ParagraphTabStop } from './contracts/types.js';
-export { R as ReviewModelInput } from './review-items-Dw-8a6Ie.js';
+export { R as ReviewModelInput } from './review-items-B78OsJU2.js';
 export { CollectReviewItems, EditorModule, EditorModuleRegistry, ReviewModuleContribution, resolveEditorModules } from './contracts/modules.js';
-import { T as TreeDocxSessionView, e as DocumentThemeColorEntry } from './tree-session-contract-C1dfE9hy.js';
-export { a as TreeApplyResult } from './tree-session-contract-C1dfE9hy.js';
-import { F as FontConfiguration, E as EditorFontError, a as EditorSnapshot, b as EditorCommand, C as CanResult, Z as ZoomMode } from './editor-C0my6Uta.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-C0my6Uta.js';
-import { L as LayoutShapingOptions } from './shaped-measurer-BxwTUluj.js';
-import { P as PaginatedSurfaceOptions, O as OpenPaginatedResult, a as PaginatedSurface, T as TableCommandPlan, D as DocxEditorInstance } from './index-kID8Ymkp.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, r as DrawingSelectionIntent, E as EMU_PER_POINT, s as EquationActivation, t as EquationChromeHandlers, u as EquationOps, F as FinalizedImageOverlayInteraction, v as FontConfigurationBase, w as FontConfigurationFragment, x as FontLoadFailure, y as FontLoadFailureReason, z as FontMeasurementState, B as FontResolutionRequest, G as FontResolver, H as FontUrlSource, I as HyperlinkActivation, J as HyperlinkChromeHandlers, K as HyperlinkOps, L as IMAGE_OVERLAY_NUDGE_PT, M as IMAGE_OVERLAY_NUDGE_SHIFT_PT, N as ImageInteractionSession, Q as ImageOverlayScrollPort, R as ImageResizeHandle, S as ImageResizeResult, U as LoadFontsRequest, V as LoadFontsResult, W as MAX_RESOLVER_FAMILIES, X as OverlayFrameRect, Y as PaginatedSurfaceState, Z as ParagraphPropertyEdit, _ as RunTableChromeCommandResult, $ as SectionAnchor, a0 as SectionBreakInsertType, a1 as SelectedDrawingOverlayTarget, a2 as SurfaceEquation, a3 as SurfaceFormatting, a4 as SurfaceHyperlink, a5 as SurfaceNavigation, a6 as SurfaceOverlayCoordinates, a7 as SurfaceParagraphFormat, a8 as TABLE_BORDER_STYLE_OPTIONS, a9 as TABLE_BORDER_TARGET_OPTIONS, aa as TABLE_BORDER_WIDTH_OPTIONS, ab as TABLE_CHROME_SLOT_IDS, ac as TableBorderStyleOption, ad as TableBorderTargetOption, ae as TableBorderTargetValue, af as TableBorderWidthOption, ag as TableChromeDraft, ah as TableChromePick, ai as TableChromeSlotId, aj as TableInteractionLabelKey, ak as ToolbarCommandState, al as WORD_DEFAULT_FONT, am as applyTableChromePick, an as blankDocumentBytes, ao as canExecuteImageCommand, ap as captureImageMutationPreconditions, aq as chromeControlCount, ar as chromeMenuSlots, as as chromeProbeForSlot, at as chromeSlotId, au as commandForSlot, av as commandForSlotValue, aw as commandForTableChromeSlotValue, ax as composeFontConfiguration, ay as computeImageResizeResult, az as computeMovedImagePosition, aA as computeResizedImageExtentEmu, aB as createDocxEditor, aC as createFontSource, aD as createImageOverlayScrollPort, aE as cssPixelsToLayoutPoints, aF as defaultChromeGroups, aG as defaultTableLabel, aH as emuToOverlayPoints, aI as equationAtPosition, aJ as executeImageCommand, aK as finalizeImageOverlayInteraction, aL as formattingBarChromeGroups, aM as isStaleImageInteractionCommit, aN as isTableChromeSlot, aO as layoutPointsToCssPixels, aP as loadFonts, aQ as overlayFrameToSheetCssPixels, aR as overlayHostOrigin, aS as pointsToEmu, aT as probeTableChromeCommand, aU as resizePreservesAspect, aV as runSave, aW as runTableChromeCommand, aX as runTableCommand, aY as runToolbarCommand, aZ as selectedDrawingOverlayTargetOf, a_ as selectedImageStateOf, a$ as surfacePaintScale, b0 as tableChromeIconPaths, b1 as tableChromeLabelKeyForTarget, b2 as tableChromeToolbarState, b3 as tableChromeVisible, b4 as tableCommandToolbarState, b5 as toolbarCommandState, b6 as toolbarCommandStates } from './index-kID8Ymkp.js';
-import { O as OoxmlPart } from './ooxml-package-CdEy9ufK.js';
-import { A as AutomationCapabilities, a as AutomationHost } from './protocol-C7ahrdUx.js';
-import { S as SemanticLayout } from './semantic-records-Do3-i5oB.js';
-export { T as TextMeasurer } from './semantic-records-Do3-i5oB.js';
-export { S as SectionProperties } from './semantic-cell-selection-Utrf0lz7.js';
-export { N as NavigationCommand, S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-B6hFRQLy.js';
-export { F as FieldShadingMode, R as ReviewAuthorInfo, a as RevisionAuthorAssignments, b as RevisionAuthorStyle, c as RevisionStyles } from './semantic-paint-quke354p.js';
-import './tree-op-revision-attribution-CN06Xshv.js';
-import './revision-projection-CILpvv4M.js';
-import './custom-node-writes-BvpWCnW8.js';
-import './hf-references-z5Y4N1ab.js';
-import './note-nodes-BNCANoGN.js';
-import './tree-store-ASBtz7UB.js';
+import { T as TreeDocxSessionView, f as DocumentThemeColorEntry } from './tree-session-contract-BPDLrEPX.js';
+export { a as TreeApplyResult } from './tree-session-contract-BPDLrEPX.js';
+import { F as FontConfiguration, E as EditorFontError, a as EditorSnapshot, b as EditorCommand, C as CanResult, Z as ZoomMode } from './editor-BcdsPdbY.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-BcdsPdbY.js';
+import { L as LayoutShapingOptions } from './shaped-measurer-CkOGZQn9.js';
+import { P as PaginatedSurfaceOptions, O as OpenPaginatedResult, a as PaginatedSurface, T as TableCommandPlan, D as DocxEditorInstance } from './index-BYTvklN5.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, r as DrawingSelectionIntent, E as EMU_PER_POINT, s as EquationActivation, t as EquationChromeHandlers, u as EquationOps, F as FinalizedImageOverlayInteraction, v as FontConfigurationBase, w as FontConfigurationFragment, x as FontLoadFailure, y as FontLoadFailureReason, z as FontMeasurementState, B as FontResolutionRequest, G as FontResolver, H as FontUrlSource, I as HyperlinkActivation, J as HyperlinkChromeHandlers, K as HyperlinkOps, L as IMAGE_OVERLAY_NUDGE_PT, M as IMAGE_OVERLAY_NUDGE_SHIFT_PT, N as ImageInteractionSession, Q as ImageOverlayScrollPort, R as ImageResizeHandle, S as ImageResizeResult, U as LoadFontsRequest, V as LoadFontsResult, W as MAX_RESOLVER_FAMILIES, X as OverlayFrameRect, Y as PaginatedSurfaceState, Z as ParagraphPropertyEdit, _ as RemoteCaretLabelAnchor, $ as RemoteCaretLabelHost, a0 as ReviewWriteIntent, a1 as RunTableChromeCommandResult, a2 as SectionAnchor, a3 as SectionBreakInsertType, a4 as SelectedDrawingOverlayTarget, a5 as SurfaceEquation, a6 as SurfaceFormatting, a7 as SurfaceHyperlink, a8 as SurfaceInsertImageInput, a9 as SurfaceNavigation, aa as SurfaceOverlayCoordinates, ab as SurfaceParagraphFormat, ac as TABLE_BORDER_STYLE_OPTIONS, ad as TABLE_BORDER_TARGET_OPTIONS, ae as TABLE_BORDER_WIDTH_OPTIONS, af as TABLE_CHROME_SLOT_IDS, ag as TableBorderStyleOption, ah as TableBorderTargetOption, ai as TableBorderTargetValue, aj as TableBorderWidthOption, ak as TableChromeDraft, al as TableChromePick, am as TableChromeSlotId, an as TableInteractionLabelKey, ao as ToolbarCommandState, ap as WORD_DEFAULT_FONT, aq as applyTableChromePick, ar as blankDocumentBytes, as as canExecuteImageCommand, at as captureImageMutationPreconditions, au as chromeControlCount, av as chromeMenuSlots, aw as chromeProbeForSlot, ax as chromeSlotId, ay as chromeSlotIsToggle, az as commandForSlot, aA as commandForSlotValue, aB as commandForTableChromeSlotValue, aC as composeFontConfiguration, aD as computeImageResizeResult, aE as computeMovedImagePosition, aF as computeResizedImageExtentEmu, aG as createDocxEditor, aH as createFontSource, aI as createImageOverlayScrollPort, aJ as cssPixelsToLayoutPoints, aK as defaultChromeGroups, aL as defaultTableLabel, aM as emuToOverlayPoints, aN as equationAtPosition, aO as executeImageCommand, aP as finalizeImageOverlayInteraction, aQ as formattingBarChromeGroups, aR as isStaleImageInteractionCommit, aS as isTableChromeSlot, aT as layoutPointsToCssPixels, aU as loadFonts, aV as overlayFrameToSheetCssPixels, aW as overlayHostOrigin, aX as pointsToEmu, aY as probeTableChromeCommand, aZ as resizePreservesAspect, a_ as runSave, a$ as runTableChromeCommand, b0 as runTableCommand, b1 as runToolbarCommand, b2 as selectedDrawingOverlayTargetOf, b3 as selectedImageStateOf, b4 as surfacePaintScale, b5 as tableChromeIconPaths, b6 as tableChromeLabelKeyForTarget, b7 as tableChromeToolbarState, b8 as tableChromeVisible, b9 as tableCommandToolbarState, ba as toolbarCommandState, bb as toolbarCommandStates } from './index-BYTvklN5.js';
+import { A as AutomationCapabilities, a as AutomationHost } from './protocol-DC7ueVuo.js';
+import { S as SemanticLayout } from './semantic-records-CzI0ZEuR.js';
+export { T as TextMeasurer } from './semantic-records-CzI0ZEuR.js';
+export { S as SectionProperties } from './semantic-cell-selection-DsYz2Vg3.js';
+export { N as NavigationCommand, S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-C00BpIyC.js';
+export { F as FieldShadingMode, R as ReviewAuthorInfo, a as RevisionAuthorAssignments, b as RevisionAuthorStyle, c as RevisionStyles } from './semantic-paint-ofuoBsYo.js';
+export { CollaborationModuleContribution } from './collaboration.js';
+import './revision-projection-B2v9U3qx.js';
+import './tree-package-fragment-oJZX_5iN.js';
+import './tree-store-B7hd6cEa.js';
+import './collaboration/replication.js';
+import './failure-BnGjoXf0.js';
+import './custom-node-writes-CcNeHH5C.js';
+import './document-properties-D6Ahr8D6.js';
 import 'prosemirror-model';
 import './contracts/document.js';
-import './note-properties-jvnw_DGG.js';
-import './omml-equation-Dd3mBep-.js';
+import './note-properties-Bx7rXruA.js';
+import './omml-equation-69O1Pd8G.js';
 
 interface LayoutShapingInstrumentation {
     readonly onFontByteCopy?: () => void;
@@ -60,6 +61,39 @@ declare function disposeLayoutShaping(shaping: LayoutShapingOptions): void;
  */
 declare const LOADING_SNAPSHOT: EditorSnapshot;
 
+/**
+ * True when the engine's PASTE lanes will land user-visible content from this payload, so
+ * a host's image-FILE lane must stand down or insert a duplicate.
+ *
+ * In order of cost: visible `text/plain` (the plain lane's unconditional fallback), visible
+ * HTML text (the projection and the plain lane's HTML fallback both land it), a
+ * zip-shaped embedded fragment, and finally the projection probe for text-free HTML.
+ *
+ * Deliberate asymmetries against the router's letter: text made only of invisible
+ * characters (zero-width wrappers, bidi marks, a bare newline) does not count — the router
+ * technically lands it, but standing down for it would drop a real image for characters
+ * nobody can see. And engine-state gates the adapter cannot observe (suggesting mode, cell
+ * selections, the force-plain window) are ignored; in those states the engine may land
+ * nothing where this predicate said it would.
+ *
+ * @internal
+ */
+declare function clipboardPasteLandsContent(transfer: DataTransfer | null | undefined): boolean;
+/**
+ * True when the engine's DROP lane will land text from this payload, so a host's
+ * image-FILE drop lane must stand down — by NOT preventing the default, which is what
+ * lets the browser fire `insertFromDrop`, the engine's only drop path.
+ *
+ * Only visible HTML text counts. The drop lane is plain text end to end, so fragments and
+ * `data:` images never land from a drop — and `text/plain` says nothing about intent here,
+ * because image-file drags routinely mirror the file's path or URL into it. A text drag
+ * that carries an image file beside it (Word's rendering PNG again) always carries the
+ * text in HTML too.
+ *
+ * @internal
+ */
+declare function clipboardDropLandsText(transfer: DataTransfer | null | undefined): boolean;
+
 /**
  * Mount a paginated surface over DOCX bytes.
  *
@@ -356,4 +390,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, 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, TreeDocxSessionView, ZOOM_MAX, ZOOM_MIN, applyThemeShade, applyThemeTint, createBrowserAutomationHost, createLayoutShaping, disposeLayoutShaping, dragIndent, editorCommandKey, generateRulerTicks, handlePosition, lowerColorValueForBorder, lowerColorValueForFill, mountPaginatedSurface, partOfNodeId, 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, TreeDocxSessionView, ZOOM_MAX, ZOOM_MIN, applyThemeShade, applyThemeTint, clipboardDropLandsText, clipboardPasteLandsContent, createBrowserAutomationHost, createLayoutShaping, disposeLayoutShaping, dragIndent, editorCommandKey, generateRulerTicks, handlePosition, lowerColorValueForBorder, lowerColorValueForFill, mountPaginatedSurface, partOfNodeId, positionInputFromPropertiesCommand, propertiesCommandHasPositionFields, resolveColorValueToCss, resolveThemeColorHex, resolveZoomMode, rulerPageBox, sameZoomMode, snapTwips, surfaceExtent, tableCommandState, toEditorFontError, validateDrawingPositionInput, validateSetImagePositionCommand, validateThemeModifier };

package/dist/editor.js

@@ -1 +1 @@
-export{Ia as AUTO_ZOOM_MODE,Na as BROWSER_AUTOMATION_CAPABILITIES,va as CHROME_GROUPS,za as CHROME_MENUS,Ca as CHROME_UNAVAILABLE_KEY,Y as DEFAULT_TABLE_CHROME_DRAFT,Q as EMU_PER_POINT,Ja as FIT_WIDTH_ZOOM_MODE,O as IMAGE_OVERLAY_NUDGE_PT,P as IMAGE_OVERLAY_NUDGE_SHIFT_PT,d as LOADING_SNAPSHOT,e as MAX_RESOLVER_FAMILIES,m as PX_PER_CM,l as PX_PER_INCH,s as SNAP_TWIPS_CM,r as SNAP_TWIPS_INCH,ca as TABLE_BORDER_STYLE_OPTIONS,ba as TABLE_BORDER_TARGET_OPTIONS,da as TABLE_BORDER_WIDTH_OPTIONS,Z as TABLE_CHROME_SLOT_IDS,q as TWIPS_PER_CM,p as TWIPS_PER_INCH,f as WORD_DEFAULT_FONT,Ha as ZOOM_MAX,Ga as ZOOM_MIN,ea as applyTableChromePick,y as applyThemeShade,x as applyThemeTint,h as blankDocumentBytes,M as canExecuteImageCommand,L as captureImageMutationPreconditions,Ba as chromeControlCount,Aa as chromeMenuSlots,ia as chromeProbeForSlot,wa as chromeSlotId,ja as commandForSlot,la as commandForSlotValue,ka as commandForTableChromeSlotValue,g as composeFontConfiguration,Va as computeImageResizeResult,V as computeMovedImagePosition,U as computeResizedImageExtentEmu,Oa as createBrowserAutomationHost,Ma as createDocxEditor,k as createFontSource,Wa as createImageOverlayScrollPort,b as createLayoutShaping,I as cropPercentFromCropPermille,G as cropPercentFromPermille,D as cropPercentFromSourceCrop,H as cropPermilleFromCropPercent,F as cropPermilleFromPercent,Ra as cssPixelsToLayoutPoints,xa as defaultChromeGroups,_ as defaultTableLabel,c as disposeLayoutShaping,v as dragIndent,ua as editorCommandKey,T as emuToOverlayPoints,Ea as equationAtPosition,N as executeImageCommand,Xa as finalizeImageOverlayInteraction,ya as formattingBarChromeGroups,n as generateRulerTicks,t as handlePosition,W as isStaleImageInteractionCommit,$ as isTableChromeSlot,Qa as layoutPointsToCssPixels,j as loadFonts,A as lowerColorValueForBorder,B as lowerColorValueForFill,Fa as mountPaginatedSurface,Sa as overlayFrameToSheetCssPixels,Ta as overlayHostOrigin,i as partOfNodeId,S as pointsToEmu,fa as probeTableChromeCommand,Ua as resizePreservesAspect,C as resolveColorValueToCss,z as resolveThemeColorHex,Ka as resolveZoomMode,o as rulerPageBox,ra as runSave,pa as runTableChromeCommand,ta as runTableCommand,qa as runToolbarCommand,La as sameZoomMode,R as selectedDrawingOverlayTargetOf,K as selectedImageStateOf,u as snapTwips,E as sourceCropFromCropPercent,Da as surfaceExtent,Pa as surfacePaintScale,ha as tableChromeIconPaths,ga as tableChromeLabelKeyForTarget,ma as tableChromeToolbarState,aa as tableChromeVisible,X as tableCommandState,sa as tableCommandToolbarState,a as toEditorFontError,na as toolbarCommandState,oa as toolbarCommandStates,J as validateImageCropPercent,w as validateThemeModifier}from'./chunk-YI6JXF7U.js';import'./chunk-27APDXY2.js';import'./chunk-N725IUO7.js';import'./chunk-WU7PUTVA.js';import'./chunk-NVGFWMCO.js';import'./chunk-LWADHMVV.js';import'./chunk-LG5K46OM.js';export{m as DEFAULT_IMAGE_RESOURCE_LIMITS,Pf as DRAWING_REL_FROM_H,Qf as DRAWING_REL_FROM_V,Ra as IMAGE_WRAP_TARGETS,Sf as positionInputFromPropertiesCommand,Rf as propertiesCommandHasPositionFields,n as resolveImageResourceLimits,ib as resolveSvgIntrinsicSize,eb as sniffImageMime,Of as validateDrawingPositionInput,jb as validateRasterHeader,Tf as validateSetImagePositionCommand}from'./chunk-N7DBENH4.js';import'./chunk-PSZH2VXP.js';export{a as resolveEditorModules}from'./chunk-GQQOL4PV.js';
+export{La as AUTO_ZOOM_MODE,Qa as BROWSER_AUTOMATION_CAPABILITIES,ya as CHROME_GROUPS,Ca as CHROME_MENUS,Fa as CHROME_UNAVAILABLE_KEY,_ as DEFAULT_TABLE_CHROME_DRAFT,S as EMU_PER_POINT,Ma as FIT_WIDTH_ZOOM_MODE,Q as IMAGE_OVERLAY_NUDGE_PT,R as IMAGE_OVERLAY_NUDGE_SHIFT_PT,d as LOADING_SNAPSHOT,e as MAX_RESOLVER_FAMILIES,o as PX_PER_CM,n as PX_PER_INCH,u as SNAP_TWIPS_CM,t as SNAP_TWIPS_INCH,ea as TABLE_BORDER_STYLE_OPTIONS,da as TABLE_BORDER_TARGET_OPTIONS,fa as TABLE_BORDER_WIDTH_OPTIONS,$ as TABLE_CHROME_SLOT_IDS,s as TWIPS_PER_CM,r as TWIPS_PER_INCH,f as WORD_DEFAULT_FONT,Ka as ZOOM_MAX,Ja as ZOOM_MIN,ga as applyTableChromePick,A as applyThemeShade,z as applyThemeTint,h as blankDocumentBytes,O as canExecuteImageCommand,N as captureImageMutationPreconditions,Ea as chromeControlCount,Da as chromeMenuSlots,ka as chromeProbeForSlot,za as chromeSlotId,qa as chromeSlotIsToggle,j as clipboardDropLandsText,i as clipboardPasteLandsContent,la as commandForSlot,na as commandForSlotValue,ma as commandForTableChromeSlotValue,g as composeFontConfiguration,Ya as computeImageResizeResult,X as computeMovedImagePosition,W as computeResizedImageExtentEmu,Ra as createBrowserAutomationHost,Pa as createDocxEditor,m as createFontSource,Za as createImageOverlayScrollPort,b as createLayoutShaping,K as cropPercentFromCropPermille,I as cropPercentFromPermille,F as cropPercentFromSourceCrop,J as cropPermilleFromCropPercent,H as cropPermilleFromPercent,Ua as cssPixelsToLayoutPoints,Aa as defaultChromeGroups,aa as defaultTableLabel,c as disposeLayoutShaping,x as dragIndent,xa as editorCommandKey,V as emuToOverlayPoints,Ha as equationAtPosition,P as executeImageCommand,_a as finalizeImageOverlayInteraction,Ba as formattingBarChromeGroups,p as generateRulerTicks,v as handlePosition,Y as isStaleImageInteractionCommit,ba as isTableChromeSlot,Ta as layoutPointsToCssPixels,l as loadFonts,C as lowerColorValueForBorder,D as lowerColorValueForFill,Ia as mountPaginatedSurface,Va as overlayFrameToSheetCssPixels,Wa as overlayHostOrigin,k as partOfNodeId,U as pointsToEmu,ha as probeTableChromeCommand,Xa as resizePreservesAspect,E as resolveColorValueToCss,B as resolveThemeColorHex,Na as resolveZoomMode,q as rulerPageBox,ua as runSave,sa as runTableChromeCommand,wa as runTableCommand,ta as runToolbarCommand,Oa as sameZoomMode,T as selectedDrawingOverlayTargetOf,M as selectedImageStateOf,w as snapTwips,G as sourceCropFromCropPercent,Ga as surfaceExtent,Sa as surfacePaintScale,ja as tableChromeIconPaths,ia as tableChromeLabelKeyForTarget,oa as tableChromeToolbarState,ca as tableChromeVisible,Z as tableCommandState,va as tableCommandToolbarState,a as toEditorFontError,pa as toolbarCommandState,ra as toolbarCommandStates,L as validateImageCropPercent,y as validateThemeModifier}from'./chunk-KBOOIC2Q.js';export{a as resolveEditorModules}from'./chunk-D5EHDHYV.js';import'./chunk-MHQNR2OU.js';import'./chunk-NJXQABQU.js';import'./chunk-WU7PUTVA.js';import'./chunk-MLGPISGH.js';import'./chunk-BXTTPJSH.js';import'./chunk-VGFMPWND.js';import'./chunk-IUM7FZPA.js';import'./chunk-6JIJOZDW.js';import'./chunk-W77HJGYX.js';export{m as DEFAULT_IMAGE_RESOURCE_LIMITS,Ng as DRAWING_REL_FROM_H,Og as DRAWING_REL_FROM_V,Ya as IMAGE_WRAP_TARGETS,Qg as positionInputFromPropertiesCommand,Pg as propertiesCommandHasPositionFields,n as resolveImageResourceLimits,pb as resolveSvgIntrinsicSize,lb as sniffImageMime,Mg as validateDrawingPositionInput,qb as validateRasterHeader,Rg as validateSetImagePositionCommand}from'./chunk-L6XZTLPS.js';import'./chunk-GOEBQ26R.js';

package/dist/failure-BnGjoXf0.d.cts

@@ -0,0 +1,64 @@
+/**
+ * Lifecycle state of one collaboration replica.
+ *
+ * One axis, because the only question a host has to answer is whether to tell the reader to
+ * wait or to reload:
+ *
+ * - `initializing` — joining. Edits are refused. Recovers on its own.
+ * - `ready` — replicating. The only state that accepts edits.
+ * - `disconnected` — the transport dropped. The replica is intact and recovers on its own,
+ *   so wait rather than reload. Edits are refused until reconnect by default; a session
+ *   created with offline editing enabled keeps accepting them, and the buffered updates
+ *   merge on reconnect.
+ * - `error` — this replica no longer agrees with the room. It does not recover: only a
+ *   reload rejoins. {@link CollaborationStatusSnapshot.reason} says why.
+ * - `destroyed` — torn down. Terminal.
+ *
+ * @public
+ */
+type CollaborationStatus = 'initializing' | 'ready' | 'disconnected' | 'error' | 'destroyed';
+/**
+ * Why a replica refused work, left `ready`, or failed a schema check.
+ *
+ * Free-form extras (a transport phrase, a blob key, a store refusal) travel in
+ * {@link CollaborationFailure.detail}, not here. `invalid-shared-metadata` follows that rule:
+ * it names one malformed field of the room's shared metadata, and which field is the detail.
+ * Distinct from `invalid-document-id`, which rejects a document id this host passed in.
+ * `concurrent-seed` reports two merged seed transactions in one room; the room cannot be
+ * repaired client-side — create a new room from saved bytes.
+ *
+ * Two of these name a transport condition a host has to tell apart, because the answers are
+ * opposite. `transport-disconnected` recovers on its own, so wait. `authentication-failed`
+ * never does: the credential the provider re-sent was rejected, so refresh it and rejoin.
+ * `transport` remains the catch-all for a provider that reported neither.
+ *
+ * @public
+ */
+type CollaborationFailureCode = 'already-initialized' | 'authentication-failed' | 'baseline-digest-mismatch' | 'baseline-too-large' | 'blob-digest-mismatch' | 'blob-read' | 'blob-store-full' | 'blob-too-large' | 'collaboration-session-destroyed' | 'collaboration-session-not-attached' | 'collaboration-session-not-ready' | 'collaboration-text-limit' | 'concurrent-seed' | 'document-id-mismatch' | 'duplicate-paragraph-id' | 'experimental-collaboration-body-text-only' | 'experimental-collaboration-existing-paragraphs-only' | 'experimental-collaboration-text-only' | 'experimental-collaboration-untracked-text-only' | 'immutable-baseline-changed' | 'immutable-metadata-changed' | 'initialization-aborted' | 'initialization-timeout' | 'invalid-baseline' | 'invalid-blob-descriptor' | 'invalid-bound' | 'invalid-document-id' | 'invalid-identity' | 'invalid-identity-color' | 'invalid-logical-id' | 'invalid-relationships' | 'invalid-session-id' | 'invalid-shared-metadata' | 'invalid-string' | 'local-mirror-failed' | 'materialize-dropped-content' | 'missing-blob' | 'missing-local-blob' | 'missing-root' | 'no-main-document-part' | 'not-initialized' | 'paragraph-set-mismatch' | 'port-already-attached' | 'protocol-version-mismatch' | 'prototype-key' | 'remote-apply-failed' | 'schema-version-mismatch' | 'shared-schema-invalid' | 'text-too-long' | 'too-many-attributes' | 'too-many-children' | 'too-many-nodes' | 'too-many-parts' | 'too-many-relationships' | 'transport' | 'transport-disconnected' | 'tree-too-deep' | 'unknown-logical-id' | 'unknown-paragraph-id' | 'unsafe-part-name' | 'unsupported-root-key';
+/** True when `value` is a {@link CollaborationFailureCode} member. @public */
+declare function isCollaborationFailureCode(value: string): value is CollaborationFailureCode;
+/** One collaboration failure: a typed code plus optional free-form detail. @public */
+interface CollaborationFailure {
+    readonly code: CollaborationFailureCode;
+    readonly detail?: string;
+}
+/**
+ * Cached status read. Same reference until status, reason, or last failure change.
+ *
+ * @public
+ */
+interface CollaborationStatusSnapshot {
+    readonly status: CollaborationStatus;
+    readonly reason: CollaborationFailure | undefined;
+    readonly lastFailure: CollaborationFailure | undefined;
+}
+/** @internal */
+interface CollaborationStatusTracker {
+    status(): CollaborationStatus;
+    snapshot(): CollaborationStatusSnapshot;
+    set(status: CollaborationStatus, code?: CollaborationFailureCode, detail?: string): boolean;
+}
+/** @internal */
+declare function createCollaborationStatusTracker(initial?: CollaborationStatus): CollaborationStatusTracker;
+
+export { type CollaborationStatus as C, type CollaborationStatusSnapshot as a, type CollaborationFailureCode as b, type CollaborationFailure as c, createCollaborationStatusTracker as d, isCollaborationFailureCode as i };

package/dist/failure-BnGjoXf0.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Lifecycle state of one collaboration replica.
+ *
+ * One axis, because the only question a host has to answer is whether to tell the reader to
+ * wait or to reload:
+ *
+ * - `initializing` — joining. Edits are refused. Recovers on its own.
+ * - `ready` — replicating. The only state that accepts edits.
+ * - `disconnected` — the transport dropped. The replica is intact and recovers on its own,
+ *   so wait rather than reload. Edits are refused until reconnect by default; a session
+ *   created with offline editing enabled keeps accepting them, and the buffered updates
+ *   merge on reconnect.
+ * - `error` — this replica no longer agrees with the room. It does not recover: only a
+ *   reload rejoins. {@link CollaborationStatusSnapshot.reason} says why.
+ * - `destroyed` — torn down. Terminal.
+ *
+ * @public
+ */
+type CollaborationStatus = 'initializing' | 'ready' | 'disconnected' | 'error' | 'destroyed';
+/**
+ * Why a replica refused work, left `ready`, or failed a schema check.
+ *
+ * Free-form extras (a transport phrase, a blob key, a store refusal) travel in
+ * {@link CollaborationFailure.detail}, not here. `invalid-shared-metadata` follows that rule:
+ * it names one malformed field of the room's shared metadata, and which field is the detail.
+ * Distinct from `invalid-document-id`, which rejects a document id this host passed in.
+ * `concurrent-seed` reports two merged seed transactions in one room; the room cannot be
+ * repaired client-side — create a new room from saved bytes.
+ *
+ * Two of these name a transport condition a host has to tell apart, because the answers are
+ * opposite. `transport-disconnected` recovers on its own, so wait. `authentication-failed`
+ * never does: the credential the provider re-sent was rejected, so refresh it and rejoin.
+ * `transport` remains the catch-all for a provider that reported neither.
+ *
+ * @public
+ */
+type CollaborationFailureCode = 'already-initialized' | 'authentication-failed' | 'baseline-digest-mismatch' | 'baseline-too-large' | 'blob-digest-mismatch' | 'blob-read' | 'blob-store-full' | 'blob-too-large' | 'collaboration-session-destroyed' | 'collaboration-session-not-attached' | 'collaboration-session-not-ready' | 'collaboration-text-limit' | 'concurrent-seed' | 'document-id-mismatch' | 'duplicate-paragraph-id' | 'experimental-collaboration-body-text-only' | 'experimental-collaboration-existing-paragraphs-only' | 'experimental-collaboration-text-only' | 'experimental-collaboration-untracked-text-only' | 'immutable-baseline-changed' | 'immutable-metadata-changed' | 'initialization-aborted' | 'initialization-timeout' | 'invalid-baseline' | 'invalid-blob-descriptor' | 'invalid-bound' | 'invalid-document-id' | 'invalid-identity' | 'invalid-identity-color' | 'invalid-logical-id' | 'invalid-relationships' | 'invalid-session-id' | 'invalid-shared-metadata' | 'invalid-string' | 'local-mirror-failed' | 'materialize-dropped-content' | 'missing-blob' | 'missing-local-blob' | 'missing-root' | 'no-main-document-part' | 'not-initialized' | 'paragraph-set-mismatch' | 'port-already-attached' | 'protocol-version-mismatch' | 'prototype-key' | 'remote-apply-failed' | 'schema-version-mismatch' | 'shared-schema-invalid' | 'text-too-long' | 'too-many-attributes' | 'too-many-children' | 'too-many-nodes' | 'too-many-parts' | 'too-many-relationships' | 'transport' | 'transport-disconnected' | 'tree-too-deep' | 'unknown-logical-id' | 'unknown-paragraph-id' | 'unsafe-part-name' | 'unsupported-root-key';
+/** True when `value` is a {@link CollaborationFailureCode} member. @public */
+declare function isCollaborationFailureCode(value: string): value is CollaborationFailureCode;
+/** One collaboration failure: a typed code plus optional free-form detail. @public */
+interface CollaborationFailure {
+    readonly code: CollaborationFailureCode;
+    readonly detail?: string;
+}
+/**
+ * Cached status read. Same reference until status, reason, or last failure change.
+ *
+ * @public
+ */
+interface CollaborationStatusSnapshot {
+    readonly status: CollaborationStatus;
+    readonly reason: CollaborationFailure | undefined;
+    readonly lastFailure: CollaborationFailure | undefined;
+}
+/** @internal */
+interface CollaborationStatusTracker {
+    status(): CollaborationStatus;
+    snapshot(): CollaborationStatusSnapshot;
+    set(status: CollaborationStatus, code?: CollaborationFailureCode, detail?: string): boolean;
+}
+/** @internal */
+declare function createCollaborationStatusTracker(initial?: CollaborationStatus): CollaborationStatusTracker;
+
+export { type CollaborationStatus as C, type CollaborationStatusSnapshot as a, type CollaborationFailureCode as b, type CollaborationFailure as c, createCollaborationStatusTracker as d, isCollaborationFailureCode as i };