@docx-editor.dev/core 2.32.0 → 2.33.0

package/dist/collaboration/replication.cjs

@@ -1 +1 @@
-'use strict';var chunkO324RB6R_cjs=require('../chunk-O324RB6R.cjs'),chunkZOZI27AW_cjs=require('../chunk-ZOZI27AW.cjs');Object.defineProperty(exports,"createCollaborationDocumentPort",{enumerable:true,get:function(){return chunkO324RB6R_cjs.b}});Object.defineProperty(exports,"mapOffsetAcrossText",{enumerable:true,get:function(){return chunkO324RB6R_cjs.c}});Object.defineProperty(exports,"historyGroupOfJournal",{enumerable:true,get:function(){return chunkZOZI27AW_cjs.Na}});Object.defineProperty(exports,"registerUndoHistoryPosition",{enumerable:true,get:function(){return chunkZOZI27AW_cjs.Vl}});Object.defineProperty(exports,"reportHistoryGroup",{enumerable:true,get:function(){return chunkZOZI27AW_cjs.Ul}});
+'use strict';var chunkX34QRAUU_cjs=require('../chunk-X34QRAUU.cjs'),chunkKE6ZWRIY_cjs=require('../chunk-KE6ZWRIY.cjs');Object.defineProperty(exports,"createCollaborationDocumentPort",{enumerable:true,get:function(){return chunkX34QRAUU_cjs.b}});Object.defineProperty(exports,"mapOffsetAcrossText",{enumerable:true,get:function(){return chunkX34QRAUU_cjs.c}});Object.defineProperty(exports,"historyGroupOfJournal",{enumerable:true,get:function(){return chunkKE6ZWRIY_cjs.Qa}});Object.defineProperty(exports,"registerUndoHistoryPosition",{enumerable:true,get:function(){return chunkKE6ZWRIY_cjs.on}});Object.defineProperty(exports,"reportHistoryGroup",{enumerable:true,get:function(){return chunkKE6ZWRIY_cjs.nn}});

package/dist/collaboration/replication.d.ts

@@ -14,10 +14,10 @@
  * @packageDocumentation
  * @public
  */
-import { d as HistoryGroup, T as TreePackageStore, e as TreeModelChange } from '../tree-package-store-CRHvMyNj.js';
-export { r as reportHistoryGroup } from '../tree-package-store-CRHvMyNj.js';
-import { av as OoxmlElement, a5 as OoxmlPackage } from '../tree-op-types-C_S2niXW.js';
-import '../editor-scope-B3L-1ALc.js';
+import { b as HistoryGroup, T as TreePackageStore, c as TreeModelChange } from '../tree-package-store-DXhX1PE-.js';
+export { r as reportHistoryGroup } from '../tree-package-store-DXhX1PE-.js';
+import { av as OoxmlElement, a5 as OoxmlPackage } from '../tree-op-types-Df4oY2u4.js';
+import '../editor-scope-CA6egMaK.js';
 
 /** Attribute name as the journal addresses it. Prefix is authored fidelity, not identity. @public */
 interface CanonicalAttributeName {
@@ -230,6 +230,13 @@ interface CollaborationDocumentPort {
      */
     readonly interactive?: boolean;
     paragraphs(): readonly CollaborationParagraph[];
+    /**
+     * The body paragraph with this canonical node id, exactly as `paragraphs()` lists it (the
+     * same stable id, minted when the paragraph's own is missing, invalid, or claimed by an
+     * earlier paragraph), or null for a node that is not a listed body paragraph. O(1) on an
+     * unchanged document, so presence can ask it on every caret move; the first call after an
+     * edit walks the body once.
+     */
     paragraphByNodeId(nodeId: string): CollaborationParagraph | null;
     /**
      * The model text of the paragraph with this node id in any story, or null when the editor
@@ -243,6 +250,8 @@ interface CollaborationDocumentPort {
      * store. Presence may name a header, a footer, a note, or a cell, so this lookup covers
      * those parts too. It resolves through an index, not a scan, because a remote caret
      * resolves two addresses per selection on every caret move.
+     * A paraId two paragraphs share resolves to the first in document order, body first, as
+     * `paragraphs()` and `paragraphByNodeId` list it.
      */
     paragraphByStableId(paragraphId: string): CollaborationParagraph | null;
     applyParagraphText(paragraphId: string, text: string, mutation: CollaborationMutation): CollaborationApplyResult;

package/dist/collaboration/replication.js

@@ -1 +1 @@
-export{b as createCollaborationDocumentPort,c as mapOffsetAcrossText}from'../chunk-IILEENID.js';export{Na as historyGroupOfJournal,Vl as registerUndoHistoryPosition,Ul as reportHistoryGroup}from'../chunk-GWM3AKUD.js';
+export{b as createCollaborationDocumentPort,c as mapOffsetAcrossText}from'../chunk-2DR4TH6B.js';export{Qa as historyGroupOfJournal,on as registerUndoHistoryPosition,nn as reportHistoryGroup}from'../chunk-AU33YWEJ.js';

package/dist/collaboration.d.ts

@@ -7,12 +7,12 @@
  * @packageDocumentation
  * @public
  */
-import { S as StoryScope } from './tree-package-store-CRHvMyNj.js';
-import { au as TreeDocOp } from './tree-op-types-C_S2niXW.js';
+import { S as StoryScope } from './tree-package-store-DXhX1PE-.js';
+import { au as TreeDocOp } from './tree-op-types-Df4oY2u4.js';
 import { CollaborationDocumentPort } from './collaboration/replication.js';
 import { a as CollaborationStatus, b as CollaborationStatusSnapshot, C as CollaborationFailureCode } from './failure-6KGFrDO9.js';
 export { c as CollaborationFailure, d as createCollaborationStatusTracker, i as isCollaborationFailureCode } from './failure-6KGFrDO9.js';
-import './editor-scope-B3L-1ALc.js';
+import './editor-scope-CA6egMaK.js';
 
 /**
  * A peer's presence color is attacker-controlled: it arrives over awareness from whoever is in

package/dist/contracts/document.d.ts

@@ -13,9 +13,9 @@
  * @packageDocumentation
  * @public
  */
-import { D as DocxDocument, E as ExecResult, i as ContentControlType, j as DocTarget, k as RunFormatting, l as Extent, I as InsertableContentControlType, m as ContainerRef, n as ContentControlFilter, o as DocRange, p as Revision, q as DocComment, S as StyleDefinitions } from '../tree-op-types-C_S2niXW.js';
-export { B as Block, r as ColorValue, s as ContentControl, t as DocAnchor, u as DocAnchorRange, v as DocLocation, w as DocumentBody, x as ExecErrorCode, H as HeaderFooterSet, y as IndentFormatting, N as NumberingRef, P as PageMargins, z as Paragraph, A as ParagraphDisagreements, F as ParagraphFlags, G as ParagraphTabStop, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind, h as RevisionAddress, J as RevisionAuthorEntry, K as RevisionAuthorResult, L as RevisionAuthorSkipReason, M as RevisionBatchEntry, Q as RevisionBatchResult, T as RevisionBatchSkipDetail, U as RevisionBatchSkipReason, V as RevisionSiteRefusal, W as RevisionType, X as Run, Y as Section, Z as SectionProperties, _ as StyleDefinition, $ as Table, a0 as TableCell, a1 as TableRow, a2 as Theme, a3 as ThemeColorScheme } from '../tree-op-types-C_S2niXW.js';
-export { H as HistoryGroupOutcome } from '../editor-scope-B3L-1ALc.js';
+import { D as DocxDocument, E as ExecResult, i as ContentControlType, j as DocTarget, k as RunFormatting, l as Extent, I as InsertableContentControlType, m as ContainerRef, n as ContentControlFilter, o as DocRange, p as Revision, q as DocComment, S as StyleDefinitions } from '../tree-op-types-Df4oY2u4.js';
+export { B as Block, r as ColorValue, s as ContentControl, t as DocAnchor, u as DocAnchorRange, v as DocLocation, w as DocumentBody, x as ExecErrorCode, H as HeaderFooterSet, y as IndentFormatting, N as NumberingRef, P as PageMargins, z as Paragraph, A as ParagraphDisagreements, F as ParagraphFlags, G as ParagraphTabStop, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind, h as RevisionAddress, J as RevisionAuthorEntry, K as RevisionAuthorResult, L as RevisionAuthorSkipReason, M as RevisionBatchEntry, Q as RevisionBatchResult, T as RevisionBatchSkipDetail, U as RevisionBatchSkipReason, V as RevisionSiteRefusal, W as RevisionType, X as Run, Y as Section, Z as SectionProperties, _ as StyleDefinition, $ as Table, a0 as TableCell, a1 as TableRow, a2 as Theme, a3 as ThemeColorScheme } from '../tree-op-types-Df4oY2u4.js';
+export { H as HistoryGroupOutcome } from '../editor-scope-CA6egMaK.js';
 
 /**
  * `@docx-editor.dev/core/contracts/document` — the document-level edit and query vocabulary.

package/dist/contracts/editor.d.ts

@@ -7,18 +7,18 @@
  * @packageDocumentation
  * @public
  */
-export { D as DEFAULT_REVISION_MARKUP, c as REVISION_MARKUP_COLORS, d as ResolvedRevisionMarkup, a as ReviewDisplayMode, e as RevisionChangedLinesMark, f as RevisionDeletionMark, b as RevisionDisplayMode, g as RevisionMarkupChromeHandlers, h as RevisionMarkupColor, R as RevisionMarkupDialogSession, i as RevisionMarkupMark, j as RevisionMarkupNamedColor, k as RevisionMarkupOptions, l as RevisionMarkupStyle, m as RevisionMarkupTextStyle, r as resolveRevisionMarkup, n as revisionMarkupColor, o as revisionMarkupStyle } from '../revision-projection-Cn6rZJ7H.js';
+export { D as DEFAULT_REVISION_MARKUP, c as REVISION_MARKUP_COLORS, d as ResolvedRevisionMarkup, a as ReviewDisplayMode, e as RevisionChangedLinesMark, f as RevisionDeletionMark, b as RevisionDisplayMode, g as RevisionMarkupChromeHandlers, h as RevisionMarkupColor, R as RevisionMarkupDialogSession, i as RevisionMarkupMark, j as RevisionMarkupNamedColor, k as RevisionMarkupOptions, l as RevisionMarkupStyle, m as RevisionMarkupTextStyle, r as resolveRevisionMarkup, n as revisionMarkupColor, o as revisionMarkupStyle } from '../revision-projection-OVusTS77.js';
 export { CommentMarkerStyle, DEFAULT_REVIEW_PANE, ResolvedReviewPane, ReviewPaneItemFields, ReviewPaneOpening, ReviewPaneOptions, ReviewPaneOverflow, RevisionDisplay, resolveReviewPane, reviewPaneListsItem } from './types.js';
-export { A as AnchorHighlightAnimation, c as AnchorHighlightOptions, d as AuthoredNoteNumbering, B as BookmarkPlace, e as BookmarkStory, f as BookmarkSummary, C as CanResult, g as ClearAnchorHighlightOptions, h as CollaborationParticipantsDiagnostic, i as CollaborationStatusDiagnostic, j as CustomNodeDiagnosticEvent, D as DIAGNOSTIC_SCHEMA_VERSION, k as DiagnosticBase, l as DiagnosticFailureDetail, m as DocumentChange, n as DocumentEditingMode, o as DocumentHandle, p as DocumentOpenDiagnostic, q as DocumentOpenFailure, r as DocumentOpenFailureReason, s as DocumentSaveDiagnostic, t as DocumentShape, u as DocumentSource, v as EditRejectedDiagnostic, w as EditRejectionOrigin, x as Editor, y as EditorAnchorNavigation, z as EditorBookmarkCommands, b as EditorCommand, F as EditorCommandShape, G as EditorCommands, E as EditorDiagnostic, a as EditorDiagnosticKind, H as EditorError, I as EditorEvents, J as EditorFontError, K as EditorFormatPainterCommands, L as EditorHeaderFooterCommands, M as EditorHighlights, N as EditorHostChange, O as EditorHostDocument, P as EditorNoteCommands, Q as EditorPosition, R as EditorQueries, S as EditorQuery, T as EditorQueryResults, U as EditorReviewHits, V as EditorSelection, W as EditorSnapshot, X as FontFailedDiagnostic, Y as FormatPainterLevel, Z as FormatPainterMode, _ as FormatPainterSurfaceState, $ as FurnitureVariant, a0 as HeaderFooterSlotArgs, a1 as HeaderFooterState, a2 as HighlightHit, a3 as HighlightOptions, a4 as HighlightRange, a5 as HighlightRect, a6 as HighlightResult, a7 as HistoryDiagnosticEvent, a8 as HyperlinkInfo, a9 as ImageContext, aa as ImageCropPercent, ab as NoteKind, ac as NotePropertiesSide, ad as NotePropertiesState, ae as PageSetup, af as PerformanceDiagnostic, ag as ResolveReviewChangesOptions, ah as ResolvedNoteNumbering, ai as ReviewActivationOptions, aj as ReviewChangesAttribution, ak as ReviewCommentPlacement, al as ReviewCustomPlacement, am as ReviewItemHit, an as ReviewItemPlacement, ao as ReviewItemPlacementBase, ap as ReviewItemQuery, aq as ReviewItemRevealEvent, ar as ReviewItemRevealSource, as as ReviewRevisionPlacement, at as ReviewSkippedDiagnostic, au as ScrollPlacement, av as ScrollToAnchorOptions, aw as SelectedImageState, ax as SessionActivity, ay as SessionDiagnostic, az as SetReviewChangesAuthorOptions, aA as TableBorderEdgeTarget, aB as TableBorderSpec, aC as TableBorderStyle, aD as TableBorderTarget, aE as TableCellVerticalAlignment, aF as TableColumnDividerResizeTarget, aG as TableColumnOccurrenceTarget, aH as TableContext, aI as TableRightEdgeResizeTarget, aJ as TableRowOccurrenceTarget, aK as TextMatch, aL as TimingSummary, aM as TrackedChangeFilterMode, aN as TrackedChangePredicate, aO as ZoomFitTarget, aP as ZoomMode } from '../editor-DZwOTmlR.js';
+export { A as AnchorHighlightAnimation, c as AnchorHighlightOptions, d as AuthoredNoteNumbering, B as BookmarkPlace, e as BookmarkStory, f as BookmarkSummary, C as CanResult, g as ClearAnchorHighlightOptions, h as CollaborationParticipantsDiagnostic, i as CollaborationStatusDiagnostic, j as CustomNodeDiagnosticEvent, D as DIAGNOSTIC_SCHEMA_VERSION, k as DiagnosticBase, l as DiagnosticFailureDetail, m as DocumentChange, n as DocumentEditingMode, o as DocumentHandle, p as DocumentOpenDiagnostic, q as DocumentOpenFailure, r as DocumentOpenFailureReason, s as DocumentSaveDiagnostic, t as DocumentShape, u as DocumentSource, v as EditRejectedDiagnostic, w as EditRejectionOrigin, x as Editor, y as EditorAnchorNavigation, z as EditorBookmarkCommands, b as EditorCommand, F as EditorCommandShape, G as EditorCommands, E as EditorDiagnostic, a as EditorDiagnosticKind, H as EditorError, I as EditorEvents, J as EditorFontError, K as EditorFormatPainterCommands, L as EditorHeaderFooterCommands, M as EditorHighlights, N as EditorHostChange, O as EditorHostDocument, P as EditorNoteCommands, Q as EditorPosition, R as EditorQueries, S as EditorQuery, T as EditorQueryResults, U as EditorReviewHits, V as EditorSelection, W as EditorSnapshot, X as FontFailedDiagnostic, Y as FormatPainterLevel, Z as FormatPainterMode, _ as FormatPainterSurfaceState, $ as FurnitureVariant, a0 as HeaderFooterSlotArgs, a1 as HeaderFooterState, a2 as HighlightHit, a3 as HighlightOptions, a4 as HighlightRange, a5 as HighlightRect, a6 as HighlightResult, a7 as HistoryDiagnosticEvent, a8 as HyperlinkInfo, a9 as ImageContext, aa as ImageCropPercent, ab as NoteKind, ac as NotePropertiesSide, ad as NotePropertiesState, ae as PageSetup, af as PerformanceDiagnostic, ag as ResolveReviewChangesOptions, ah as ResolvedNoteNumbering, ai as ReviewActivationOptions, aj as ReviewChangesAttribution, ak as ReviewChangesResolvedEvent, al as ReviewCommentPlacement, am as ReviewCustomPlacement, an as ReviewItemHit, ao as ReviewItemPlacement, ap as ReviewItemPlacementBase, aq as ReviewItemQuery, ar as ReviewItemRevealEvent, as as ReviewItemRevealSource, at as ReviewRevisionPlacement, au as ReviewSkippedDiagnostic, av as ScrollPlacement, aw as ScrollToAnchorOptions, ax as SelectedImageState, ay as SessionActivity, az as SessionDiagnostic, aA as SetReviewChangesAuthorOptions, aB as TableBorderEdgeTarget, aC as TableBorderSpec, aD as TableBorderStyle, aE as TableBorderTarget, aF as TableCellVerticalAlignment, aG as TableColumnDividerResizeTarget, aH as TableColumnOccurrenceTarget, aI as TableContext, aJ as TableRightEdgeResizeTarget, aK as TableRowOccurrenceTarget, aL as TextMatch, aM as TimingSummary, aN as TrackedChangeFilterMode, aO as TrackedChangePredicate, aP as ZoomFitTarget, aQ as ZoomMode } from '../editor-B7OOAAie.js';
 export { E as EditorFontErrorCode, F as FontConfiguration, a as FontFaceRequest, b as FontSource, c as FontSourceSubstitution } from '../editor-fonts-D_-vjuJi.js';
-export { B as Block, r as ColorValue, C as CommentRecord, m as ContainerRef, s as ContentControl, n as ContentControlFilter, i as ContentControlType, t as DocAnchor, u as DocAnchorRange, q as DocComment, v as DocLocation, o as DocRange, j as DocTarget, w as DocumentBody, D as DocxDocument, a6 as DocxDocumentJSON, a7 as DrawingHorizontalReferenceFrame, a8 as DrawingKind, a9 as DrawingLocks, aa as DrawingPositionInput, ab as DrawingVerticalReferenceFrame, x as ExecErrorCode, E as ExecResult, l as Extent, ac as FontDefinition, H as HeaderFooterSet, af as ImageResourceState, ag as ImageWrapTarget, y as IndentFormatting, I as InsertableContentControlType, N as NumberingRef, P as PageMargins, z as Paragraph, A as ParagraphDisagreements, F as ParagraphFlags, ah as ParagraphFormatCommand, G as ParagraphTabStop, ai as Point, aj as PreservedImageMime, ak as Rect, al as RenderableImageMime, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind, p as Revision, h as RevisionAddress, J as RevisionAuthorEntry, K as RevisionAuthorResult, L as RevisionAuthorSkipReason, M as RevisionBatchEntry, Q as RevisionBatchResult, T as RevisionBatchSkipDetail, U as RevisionBatchSkipReason, V as RevisionSiteRefusal, W as RevisionType, X as Run, k as RunFormatting, Y as Section, Z as SectionProperties, am as SelectionPin, _ as StyleDefinition, S as StyleDefinitions, an as SupportedImageMime, $ as Table, a0 as TableCell, a1 as TableRow, a2 as Theme, a3 as ThemeColorScheme, ao as Unsubscribe, ap as ValidatedImageBytesHandle, aq as VectorImageMime, ar as Watermark, as as WatermarkLayout, at as WatermarkState } from '../tree-op-types-C_S2niXW.js';
+export { B as Block, r as ColorValue, C as CommentRecord, m as ContainerRef, s as ContentControl, n as ContentControlFilter, i as ContentControlType, t as DocAnchor, u as DocAnchorRange, q as DocComment, v as DocLocation, o as DocRange, j as DocTarget, w as DocumentBody, D as DocxDocument, a6 as DocxDocumentJSON, a7 as DrawingHorizontalReferenceFrame, a8 as DrawingKind, a9 as DrawingLocks, aa as DrawingPositionInput, ab as DrawingVerticalReferenceFrame, x as ExecErrorCode, E as ExecResult, l as Extent, ac as FontDefinition, H as HeaderFooterSet, af as ImageResourceState, ag as ImageWrapTarget, y as IndentFormatting, I as InsertableContentControlType, N as NumberingRef, P as PageMargins, z as Paragraph, A as ParagraphDisagreements, F as ParagraphFlags, ah as ParagraphFormatCommand, G as ParagraphTabStop, ai as Point, aj as PreservedImageMime, ak as Rect, al as RenderableImageMime, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind, p as Revision, h as RevisionAddress, J as RevisionAuthorEntry, K as RevisionAuthorResult, L as RevisionAuthorSkipReason, M as RevisionBatchEntry, Q as RevisionBatchResult, T as RevisionBatchSkipDetail, U as RevisionBatchSkipReason, V as RevisionSiteRefusal, W as RevisionType, X as Run, k as RunFormatting, Y as Section, Z as SectionProperties, am as SelectionPin, _ as StyleDefinition, S as StyleDefinitions, an as SupportedImageMime, $ as Table, a0 as TableCell, a1 as TableRow, a2 as Theme, a3 as ThemeColorScheme, ao as Unsubscribe, ap as ValidatedImageBytesHandle, aq as VectorImageMime, ar as Watermark, as as WatermarkLayout, at as WatermarkState } from '../tree-op-types-Df4oY2u4.js';
 export { ContentControlSummary, DocEdits, DocQueries, DocQueryResults, ParagraphSummary } from './document.js';
-export { a as EditorExecOptions, E as EditorScope, b as HistoryDiagnostic, c as HistoryGroup, d as HistoryGroupOptions, H as HistoryGroupOutcome, V as ViewScope } from '../editor-scope-B3L-1ALc.js';
+export { a as EditorExecOptions, E as EditorScope, b as HistoryDiagnostic, c as HistoryGroup, d as HistoryGroupOptions, H as HistoryGroupOutcome, V as ViewScope } from '../editor-scope-CA6egMaK.js';
 export { InteractionAffinity, InteractionOutcome, InteractionOutcomeCode, SemanticIdentity, SemanticTarget } from './interaction.js';
-export { S as SemanticPosition, a as SemanticSelection } from '../semantic-interaction-CJoHLoOl.js';
-export { D as DocumentProtectionEdit, a as DocumentProtectionState } from '../document-protection-NaniLHWF.js';
+export { S as SemanticPosition, a as SemanticSelection } from '../semantic-interaction-BbA4dgEo.js';
+export { D as DocumentProtectionEdit, a as DocumentProtectionState } from '../document-protection-BvbpSXbQ.js';
 export { C as CollaborationFailureCode, a as CollaborationStatus } from '../failure-6KGFrDO9.js';
-export { B as ByteSizeBucket, C as CollaborationDiagnosticCode, b as CountBucket, c as CustomNodeDiagnosticCode, d as DiagnosticCode, D as DiagnosticErrorName, e as DiagnosticExplanation, f as DocumentOpenDiagnosticCode, a as DocumentPartKind, g as DocumentSaveDiagnosticCode, E as EditDiagnosticCode, F as FailureStage, h as FontDiagnosticCode, i as FormattingChangeKind, H as HistoryDiagnosticCode, P as PerformanceDiagnosticCode, R as ReviewChangeKind, j as ReviewDiagnosticCode, k as ReviewOperation } from '../diagnostic-hints-DK8-V0fk.js';
-import '../semantic-records-BvN-WWst.js';
-import '../headless-document-view-Bcz9_Qva.js';
-import '../tree-package-store-CRHvMyNj.js';
+export { B as ByteSizeBucket, C as CollaborationDiagnosticCode, a as CountBucket, b as CustomNodeDiagnosticCode, D as DiagnosticCode, c as DiagnosticErrorName, d as DiagnosticExplanation, e as DocumentOpenDiagnosticCode, f as DocumentPartKind, g as DocumentSaveDiagnosticCode, E as EditDiagnosticCode, F as FailureStage, h as FontDiagnosticCode, i as FormattingChangeKind, H as HistoryDiagnosticCode, P as PerformanceDiagnosticCode, j as ReviewChangeKind, R as ReviewDiagnosticCode, k as ReviewOperation } from '../diagnostic-hints-BtCaCqQC.js';
+import '../semantic-records-DoK0lNjS.js';
+import '../drawing-graphic-kind-CXYGYbB3.js';
+import '../tree-package-store-DXhX1PE-.js';

package/dist/contracts/interaction.d.ts

@@ -27,8 +27,8 @@
  * @packageDocumentation
  * @public
  */
-import { V as ViewScope } from '../editor-scope-B3L-1ALc.js';
-export { E as EditorScope } from '../editor-scope-B3L-1ALc.js';
+import { V as ViewScope } from '../editor-scope-CA6egMaK.js';
+export { E as EditorScope } from '../editor-scope-CA6egMaK.js';
 
 /**
  * `@docx-editor.dev/core/contracts/interaction` — semantic addressing and interaction outcomes.

package/dist/contracts/modules.d.ts

@@ -17,24 +17,24 @@
  * @packageDocumentation
  * @public
  */
-import { R as RevisionMarkupDialogSession, a as ReviewDisplayMode } from '../revision-projection-Cn6rZJ7H.js';
-export { b as RevisionDisplayMode } from '../revision-projection-Cn6rZJ7H.js';
+import { R as RevisionMarkupDialogSession, a as ReviewDisplayMode } from '../revision-projection-OVusTS77.js';
+export { b as RevisionDisplayMode } from '../revision-projection-OVusTS77.js';
 import { ReviewPaneOptions } from './types.js';
-import { E as EditorDiagnostic, a as EditorDiagnosticKind } from '../editor-DZwOTmlR.js';
-import { R as ReviewModelInput, a as ReviewItem, O as OoxmlPart, b as ReviewRevisionItem } from '../tree-op-types-C_S2niXW.js';
-export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, e as ReviewPosition, f as ReviewRange, g as ReviewRevisionKind, h as RevisionAddress } from '../tree-op-types-C_S2niXW.js';
+import { E as EditorDiagnostic, a as EditorDiagnosticKind } from '../editor-B7OOAAie.js';
+import { R as ReviewModelInput, a as ReviewItem, O as OoxmlPart, b as ReviewRevisionItem } from '../tree-op-types-Df4oY2u4.js';
+export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, e as ReviewPosition, f as ReviewRange, g as ReviewRevisionKind, h as RevisionAddress } from '../tree-op-types-Df4oY2u4.js';
 import { CollaborationModuleContribution } from '../collaboration.js';
 import '../failure-6KGFrDO9.js';
-import '../document-protection-NaniLHWF.js';
-import '../editor-scope-B3L-1ALc.js';
+import '../document-protection-BvbpSXbQ.js';
+import '../editor-scope-CA6egMaK.js';
 import '../editor-fonts-D_-vjuJi.js';
-import '../diagnostic-hints-DK8-V0fk.js';
+import '../diagnostic-hints-BtCaCqQC.js';
 import './document.js';
 import './interaction.js';
-import '../semantic-interaction-CJoHLoOl.js';
-import '../semantic-records-BvN-WWst.js';
-import '../headless-document-view-Bcz9_Qva.js';
-import '../tree-package-store-CRHvMyNj.js';
+import '../semantic-interaction-BbA4dgEo.js';
+import '../semantic-records-DoK0lNjS.js';
+import '../drawing-graphic-kind-CXYGYbB3.js';
+import '../tree-package-store-DXhX1PE-.js';
 import '../collaboration/replication.js';
 
 /**

package/dist/contracts/types.d.ts

@@ -7,11 +7,11 @@
  * @packageDocumentation
  * @public
  */
-export { B as Block, r as ColorValue, m as ContainerRef, s as ContentControl, n as ContentControlFilter, i as ContentControlType, t as DocAnchor, u as DocAnchorRange, q as DocComment, v as DocLocation, o as DocRange, j as DocTarget, w as DocumentBody, D as DocxDocument, a6 as DocxDocumentJSON, x as ExecErrorCode, E as ExecResult, l as Extent, ac as FontDefinition, H as HeaderFooterSet, y as IndentFormatting, I as InsertableContentControlType, N as NumberingRef, P as PageMargins, z as Paragraph, A as ParagraphDisagreements, F as ParagraphFlags, ah as ParagraphFormatCommand, G as ParagraphTabStop, ai as Point, ak as Rect, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind, p as Revision, h as RevisionAddress, J as RevisionAuthorEntry, K as RevisionAuthorResult, L as RevisionAuthorSkipReason, M as RevisionBatchEntry, Q as RevisionBatchResult, T as RevisionBatchSkipDetail, U as RevisionBatchSkipReason, V as RevisionSiteRefusal, W as RevisionType, X as Run, k as RunFormatting, Y as Section, Z as SectionProperties, am as SelectionPin, _ as StyleDefinition, S as StyleDefinitions, $ as Table, a0 as TableCell, a1 as TableRow, a2 as Theme, a3 as ThemeColorScheme, ao as Unsubscribe, ar as Watermark, as as WatermarkLayout, at as WatermarkState } from '../tree-op-types-C_S2niXW.js';
+export { B as Block, r as ColorValue, m as ContainerRef, s as ContentControl, n as ContentControlFilter, i as ContentControlType, t as DocAnchor, u as DocAnchorRange, q as DocComment, v as DocLocation, o as DocRange, j as DocTarget, w as DocumentBody, D as DocxDocument, a6 as DocxDocumentJSON, x as ExecErrorCode, E as ExecResult, l as Extent, ac as FontDefinition, H as HeaderFooterSet, y as IndentFormatting, I as InsertableContentControlType, N as NumberingRef, P as PageMargins, z as Paragraph, A as ParagraphDisagreements, F as ParagraphFlags, ah as ParagraphFormatCommand, G as ParagraphTabStop, ai as Point, ak as Rect, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind, p as Revision, h as RevisionAddress, J as RevisionAuthorEntry, K as RevisionAuthorResult, L as RevisionAuthorSkipReason, M as RevisionBatchEntry, Q as RevisionBatchResult, T as RevisionBatchSkipDetail, U as RevisionBatchSkipReason, V as RevisionSiteRefusal, W as RevisionType, X as Run, k as RunFormatting, Y as Section, Z as SectionProperties, am as SelectionPin, _ as StyleDefinition, S as StyleDefinitions, $ as Table, a0 as TableCell, a1 as TableRow, a2 as Theme, a3 as ThemeColorScheme, ao as Unsubscribe, ar as Watermark, as as WatermarkLayout, at as WatermarkState } from '../tree-op-types-Df4oY2u4.js';
 export { C as CollaborationFailureCode, a as CollaborationStatus } from '../failure-6KGFrDO9.js';
-export { D as DEFAULT_REVISION_MARKUP, c as REVISION_MARKUP_COLORS, d as ResolvedRevisionMarkup, e as RevisionChangedLinesMark, f as RevisionDeletionMark, b as RevisionDisplayMode, g as RevisionMarkupChromeHandlers, h as RevisionMarkupColor, R as RevisionMarkupDialogSession, i as RevisionMarkupMark, j as RevisionMarkupNamedColor, k as RevisionMarkupOptions, l as RevisionMarkupStyle, m as RevisionMarkupTextStyle, r as resolveRevisionMarkup, n as revisionMarkupColor, o as revisionMarkupStyle } from '../revision-projection-Cn6rZJ7H.js';
-export { D as DocumentProtectionEdit, a as DocumentProtectionState } from '../document-protection-NaniLHWF.js';
-export { H as HistoryGroupOutcome } from '../editor-scope-B3L-1ALc.js';
+export { D as DEFAULT_REVISION_MARKUP, c as REVISION_MARKUP_COLORS, d as ResolvedRevisionMarkup, e as RevisionChangedLinesMark, f as RevisionDeletionMark, b as RevisionDisplayMode, g as RevisionMarkupChromeHandlers, h as RevisionMarkupColor, R as RevisionMarkupDialogSession, i as RevisionMarkupMark, j as RevisionMarkupNamedColor, k as RevisionMarkupOptions, l as RevisionMarkupStyle, m as RevisionMarkupTextStyle, r as resolveRevisionMarkup, n as revisionMarkupColor, o as revisionMarkupStyle } from '../revision-projection-OVusTS77.js';
+export { D as DocumentProtectionEdit, a as DocumentProtectionState } from '../document-protection-BvbpSXbQ.js';
+export { H as HistoryGroupOutcome } from '../editor-scope-CA6egMaK.js';
 
 /**
  * When the review pane opens by itself.

package/dist/{custom-node-writes-CLJKGD9t.d.ts → custom-node-writes-AqY5KpVx.d.ts}

@@ -1,5 +1,5 @@
-import { a5 as OoxmlPackage, O as OoxmlPart, a4 as OoxmlNode, aF as RevisionAttributionInput, aG as TreeOpRejection } from './tree-op-types-C_S2niXW.js';
-import { e as TreeModelChange, f as TreeDocumentStore } from './tree-package-store-CRHvMyNj.js';
+import { a5 as OoxmlPackage, O as OoxmlPart, a4 as OoxmlNode, aE as RevisionAttributionInput, aF as TreeOpRejection } from './tree-op-types-Df4oY2u4.js';
+import { c as TreeModelChange, d as TreeDocumentStore } from './tree-package-store-DXhX1PE-.js';
 
 /** Which of a family's four faces an embedded font relationship supplies. */
 type FontStyleKey = 'regular' | 'bold' | 'italic' | 'boldItalic';

package/dist/diagnostic-context-CuzhOX0g.d.ts

@@ -0,0 +1,98 @@
+import { R as ReviewDiagnosticCode, B as ByteSizeBucket, a as CountBucket, e as DocumentOpenDiagnosticCode, E as EditDiagnosticCode, c as DiagnosticErrorName, f as DocumentPartKind } from './diagnostic-hints-BtCaCqQC.js';
+
+/**
+ * The public code for a refused open. `too-large` is the one reason two layers share: the
+ * archive reports it WITH the limit it crossed, a single XML part reports it without one.
+ *
+ * @public
+ */
+declare function openDiagnosticCode(reason: string, limit?: string): DocumentOpenDiagnosticCode;
+/**
+ * The public code for a store or host refusal reason, or `null` for a reason this table does
+ * not know (a sentence, a binding reason). `unsupported-revision:<kind>` counts as
+ * `unsupported-revision`, except `unsupported-revision:foreign-insertion`, which has its own
+ * code.
+ *
+ * @public
+ */
+declare function storeEditDiagnosticCode(reason: string): EditDiagnosticCode | null;
+/**
+ * The public code for a skipped tracked change, such as an entry of `reviewChangesResolved`'s
+ * `skipped` list: the detail's own code when it has one (`review.locked-content`,
+ * `review.bound-content`), else the reason's.
+ *
+ * @example
+ * ```ts
+ * editor.on('reviewChangesResolved', ({ skipped }) => {
+ *   for (const skip of skipped) console.warn(reviewCodeOfSkip(skip));
+ * });
+ * ```
+ *
+ * @public
+ */
+declare function reviewCodeOfSkip(skip: {
+    readonly reason: string;
+    readonly detail?: string;
+}): ReviewDiagnosticCode | null;
+/** The public code for a skipped tracked change, or null for a reason with no public code. */
+declare function reviewDiagnosticCode(reason: string): ReviewDiagnosticCode | null;
+/** The power-of-two bucket of a byte size. */
+declare function byteSizeBucket(bytes: number): ByteSizeBucket;
+/** The order-of-magnitude bucket of a count. */
+declare function countBucket(count: number): CountBucket;
+/** A diagnostic without the fields the emitter adds. Distributes over the union. */
+type DiagnosticPayload<T> = T extends unknown ? Omit<T, 'schemaVersion' | 'editorSessionId' | 'time'> : never;
+/** One delivery path for one editor or runtime instance. */
+interface DiagnosticEmitter<E> {
+    /** Random for this instance and never stored. */
+    readonly editorSessionId: string;
+    /** Stamp the payload and hand it to every listener. A listener that throws is ignored. */
+    deliver(payload: DiagnosticPayload<E>): void;
+}
+/**
+ * A delivery path over `listeners`, read at each delivery so a later listener is heard. Generic
+ * over the event union, which the editor contracts own: this lane never names them.
+ */
+declare function createDiagnosticEmitter<E>(listeners: () => Iterable<(event: E) => unknown>, now?: () => number): DiagnosticEmitter<E>;
+
+/**
+ * Every engine reason a diagnostic can carry as its `cause`. Causes are the engine's own
+ * reasons and can change between engine versions; match on the public `code`, and read the
+ * `cause` when you report or fix a failure.
+ *
+ * @public
+ */
+declare function diagnosticCauses(): readonly string[];
+/**
+ * The engine reason token in a refusal reason, or undefined when the reason is not one the
+ * engine knows, such as a sentence. Only the token before a colon counts; the detail after it
+ * can name parts of the file and is never returned. A full reason such as
+ * `unsupported-revision:foreign-insertion` reports its token; its public code names the rule.
+ */
+declare function diagnosticCause(reason: string | undefined): string | undefined;
+/**
+ * The review code and structure in a refused decision's reason, such as
+ * `incomplete-group:paired-change`, or null when the reason names no review skip. The
+ * structure is reported only when it is one of the engine's own skip details.
+ *
+ * @public
+ */
+declare function reviewSkipOfReason(reason: string | undefined): {
+    readonly code: ReviewDiagnosticCode;
+    readonly cause?: string;
+} | null;
+/** The cause of a failure the engine did not name: an exception. */
+declare function exceptionCause(): string;
+/**
+ * The class of an exception, never its message. A subclass with its own name, which a host or a
+ * file could shape, reports `'other'`.
+ */
+declare function diagnosticErrorName(error: unknown): DiagnosticErrorName;
+/**
+ * The role of the part a failure names, from the part name at the start of a refusal detail.
+ * The name itself never leaves this function. Undefined when there is no detail.
+ */
+declare function documentPartKind(detail: string | undefined): DocumentPartKind | undefined;
+
+export { byteSizeBucket as b, countBucket as c, diagnosticCauses as d, createDiagnosticEmitter as e, diagnosticCause as f, diagnosticErrorName as g, documentPartKind as h, exceptionCause as i, reviewDiagnosticCode as j, reviewSkipOfReason as k, openDiagnosticCode as o, reviewCodeOfSkip as r, storeEditDiagnosticCode as s };
+export type { DiagnosticEmitter as D, DiagnosticPayload as a };

package/dist/{diagnostic-hints-DK8-V0fk.d.ts → diagnostic-hints-BtCaCqQC.d.ts}

@@ -18,7 +18,7 @@ type DocumentSaveDiagnosticCode = 'save.no-document' | 'save.document-changed' |
 /** Why an edit, a command or a tracked change was refused. @public */
 type EditDiagnosticCode = 'edit.read-only' | 'edit.protected-content' | 'edit.suggesting-needs-author' | 'edit.review-module-required' | 'edit.tracked-drawing-delete-unsupported' | 'edit.tracked-structure-unsupported' | 'edit.tracked-operation-unsupported' | 'edit.tracking-mode-unsupported' | 'edit.tracking-author-required' | 'edit.comment-author-required' | 'edit.tracking-unsupported-host' | 'edit.revision-unsupported' | 'edit.tracking-required' | 'edit.tracked-image-replace-unsupported' | 'edit.tracked-deleted-text-only' | 'edit.tracked-foreign-revision-unsupported' | 'edit.tracked-own-pending-change' | 'edit.picture-selected' | 'edit.cross-structure-join' | 'edit.indivisible-content' | 'edit.field-structure' | 'edit.field-unsupported' | 'edit.field-result-unsupported' | 'edit.ooxml-unsupported' | 'edit.section-mark' | 'edit.table-structure-unsupported' | 'edit.table-merge-not-rectangle' | 'edit.table-split-unsupported' | 'edit.table-insert-refused' | 'edit.table-of-contents-refused' | 'edit.unsupported-content' | 'edit.operation-unsupported' | 'edit.unsupported-story' | 'edit.unmapped-change' | 'edit.stale-target' | 'edit.invalid-argument' | 'edit.resource-limit' | 'edit.refresh-in-progress' | 'edit.preview-active' | 'edit.preview-unsupported' | 'edit.preview-composing' | 'edit.preview-diverged' | 'edit.collaboration-not-ready' | 'edit.collaboration-text-limit' | 'edit.internal-invariant' | 'edit.refused';
 /** Why accepting, rejecting or re-authoring a tracked change skipped an item. @public */
-type ReviewDiagnosticCode = 'review.revision-unsupported' | 'review.incomplete-group' | 'review.retained-structure' | 'review.stale-revision';
+type ReviewDiagnosticCode = 'review.revision-unsupported' | 'review.incomplete-group' | 'review.retained-structure' | 'review.locked-content' | 'review.bound-content' | 'review.stale-revision';
 /** Why a font did not load. The family name is never reported. @public */
 type FontDiagnosticCode = 'font.shaper-unavailable' | 'font.load-failed' | 'font.missing' | 'font.integrity-mismatch' | 'font.malformed' | 'font.size-limit' | 'font.unsupported-face';
 /**
@@ -117,4 +117,4 @@ declare function explainDiagnostic(code: DiagnosticCode): DiagnosticExplanation;
 declare function diagnosticCodes(): readonly DiagnosticCode[];
 
 export { diagnosticCodes as l, explainDiagnostic as m };
-export type { ByteSizeBucket as B, CollaborationDiagnosticCode as C, DiagnosticErrorName as D, EditDiagnosticCode as E, FailureStage as F, HistoryDiagnosticCode as H, PerformanceDiagnosticCode as P, ReviewChangeKind as R, DocumentPartKind as a, CountBucket as b, CustomNodeDiagnosticCode as c, DiagnosticCode as d, DiagnosticExplanation as e, DocumentOpenDiagnosticCode as f, DocumentSaveDiagnosticCode as g, FontDiagnosticCode as h, FormattingChangeKind as i, ReviewDiagnosticCode as j, ReviewOperation as k };
+export type { ByteSizeBucket as B, CollaborationDiagnosticCode as C, DiagnosticCode as D, EditDiagnosticCode as E, FailureStage as F, HistoryDiagnosticCode as H, PerformanceDiagnosticCode as P, ReviewDiagnosticCode as R, CountBucket as a, CustomNodeDiagnosticCode as b, DiagnosticErrorName as c, DiagnosticExplanation as d, DocumentOpenDiagnosticCode as e, DocumentPartKind as f, DocumentSaveDiagnosticCode as g, FontDiagnosticCode as h, FormattingChangeKind as i, ReviewChangeKind as j, ReviewOperation as k };

package/dist/{document-protection-NaniLHWF.d.ts → document-protection-BvbpSXbQ.d.ts}

@@ -1,4 +1,4 @@
-import { a4 as OoxmlNode } from './tree-op-types-C_S2niXW.js';
+import { a4 as OoxmlNode } from './tree-op-types-Df4oY2u4.js';
 
 /** `ST_DocProtect`: the restriction a document asks for. `none` also stands for "no element". */
 type DocumentProtectionEdit = 'none' | 'readOnly' | 'comments' | 'trackedChanges' | 'forms';

package/dist/{headless-document-view-Bcz9_Qva.d.ts → drawing-graphic-kind-CXYGYbB3.d.ts}

@@ -1,5 +1,5 @@
-import { aC as OoxmlNodeId, ax as OoxmlGenericElementNode, a4 as OoxmlNode, a5 as OoxmlPackage, O as OoxmlPart, av as OoxmlElement, aB as OoxmlPackageRejection } from './tree-op-types-C_S2niXW.js';
-import { H as HeaderFooterParts, b as HeaderFooterSectionResolution, T as TreePackageStore } from './tree-package-store-CRHvMyNj.js';
+import { aG as OoxmlNodeId, ax as OoxmlGenericElementNode, a4 as OoxmlNode, a5 as OoxmlPackage, O as OoxmlPart, av as OoxmlElement, aA as OoxmlPackageRejection } from './tree-op-types-Df4oY2u4.js';
+import { e as HeaderFooterParts, f as HeaderFooterSectionResolution, T as TreePackageStore } from './tree-package-store-DXhX1PE-.js';
 
 /** Office Math Markup Language namespace. */
 declare const OFFICE_MATH_NAMESPACE_URI = "http://schemas.openxmlformats.org/officeDocument/2006/math";
@@ -250,5 +250,75 @@ declare function openHeadlessDocument(bytes: Uint8Array): OpenHeadlessDocumentRe
 /** Internal live read view over the canonical store, preserving node identities for field pagination. */
 declare function headlessViewOfStore(store: TreePackageStore): HeadlessDocumentView;
 
-export { DEFAULT_OMML_LIMITS as b, OFFICE_MATH_NAMESPACE_URI as h, authorableHyperlinkTarget as k, ensureHyperlinkRelationship as l, equationExpressionToLinearMath as m, headlessViewOfStore as n, linearMathToOmml as o, openHeadlessDocument as p, parseLinearMath as q, projectOmmlEquation as r, relationshipTargetIn as s };
-export type { DocumentProperties as D, EnsuredHyperlinkRelationship as E, HeadlessDocumentView as H, LinearMathOmmlResult as L, OmmlEquationProjection as O, HeadlessDocumentRejection as a, EquationControlSource as c, EquationExpression as d, HeadlessThemeFonts as e, LinearMathParseResult as f, LinearMathRejection as g, OmmlLimits as i, OpenHeadlessDocumentResult as j };
+/**
+ * A drawing feature that the editor does not show as authored. Each code means:
+ *
+ * - `unsupported-effect`: the editor ignores an explicit effect, such as `a:blur`, `a:duotone`,
+ *   or `a14:imgProps`. The drawing renders without it.
+ * - `renderer-required`: an optional effect, such as `a:glow`, needs the drawing module:
+ *   `drawingModule()` or `installDrawing()` from `@docx-editor.dev/pro/drawing`. It appears
+ *   only while that module is not installed in the current process, for occurrences and
+ *   reports alike.
+ * - `unverified-3d`: the drawing has 3-D properties (`a:scene3d`, `a:sp3d`), which render flat.
+ * - `saved-fallback`: the editor shows the saved `mc:Fallback` content, not the main content.
+ * - `unplaced-drawing`: the drawing has no layout position, so the editor does not show it.
+ * - `inspection-limit`: a scan budget stopped the check, so the result is incomplete.
+ * - `projection-diagnostic`: the source is malformed or partly unusable. `detail` holds the
+ *   diagnostic code, such as `invalid-geometry` or `resource-refused`.
+ *
+ * The check reads the drawing's own XML. It does not read chart or diagram parts, inherited
+ * theme effects, or image bytes, so an empty list does not prove full fidelity.
+ *
+ * @public
+ */
+interface DrawingSupportIssue {
+    /** The kind of limitation. The list in this type's description explains each code. */
+    readonly code: 'unsupported-effect' | 'renderer-required' | 'unverified-3d' | 'saved-fallback' | 'unplaced-drawing' | 'inspection-limit' | 'projection-diagnostic';
+    /**
+     * The source node with the feature: in the inspected package for a report, or in the
+     * editor's current document for an occurrence's `drawingIssues`.
+     */
+    readonly nodeId: string;
+    /** The namespace of the node with the feature. */
+    readonly namespaceUri: string;
+    /** The local name of the node with the feature, such as `blur`. */
+    readonly localName: string;
+    /** The feature, such as `a:blur` or `mc:Fallback`, or the projection diagnostic code. */
+    readonly detail: string;
+}
+/**
+ * How completely the editor shows a drawing:
+ *
+ * - `native`: the editor renders the drawing and found no unsupported feature in its source.
+ * - `partial`: the editor renders the drawing, but without some features, or it shows a saved
+ *   fallback. The issue list names the features.
+ * - `unrendered`: the editor shows a placeholder, or the drawing has no layout position.
+ *
+ * A drawing that the document itself hides is `native` or `partial`: the editor shows it as
+ * authored, which is not at all.
+ *
+ * Charts and SmartArt diagrams that the editor draws report `native`, because the check does
+ * not read their chart or diagram parts. Inherited theme effects and image bytes are not
+ * checked either.
+ *
+ * @public
+ */
+type DrawingSupport = 'native' | 'partial' | 'unrendered';
+
+/**
+ * The kind of graphic a drawing holds. Note: `textbox` names every DrawingML shape, with or
+ * without text, and `shape` names only legacy VML drawings.
+ *
+ * Read from its source: `picture`, `chart` (a chart),
+ * `diagram` (SmartArt), `textbox` (a DrawingML shape, with or without text), `group` (a shape
+ * group), `canvas` (a drawing canvas), `shape` (a legacy VML drawing, such as WordArt), or
+ * `graphic` (any other graphic). It does not say whether the engine renders the graphic.
+ * The names match `placeholderGraphicKind`, which adds no `picture` and is set only for
+ * placeholders.
+ *
+ * @public
+ */
+type DrawingGraphicKind = 'picture' | 'chart' | 'diagram' | 'shape' | 'group' | 'textbox' | 'canvas' | 'graphic';
+
+export { DEFAULT_OMML_LIMITS as e, OFFICE_MATH_NAMESPACE_URI as k, authorableHyperlinkTarget as n, ensureHyperlinkRelationship as o, equationExpressionToLinearMath as p, headlessViewOfStore as q, linearMathToOmml as r, openHeadlessDocument as s, parseLinearMath as t, projectOmmlEquation as u, relationshipTargetIn as v };
+export type { DrawingGraphicKind as D, EnsuredHyperlinkRelationship as E, HeadlessDocumentView as H, LinearMathOmmlResult as L, OmmlEquationProjection as O, DrawingSupport as a, DrawingSupportIssue as b, DocumentProperties as c, HeadlessDocumentRejection as d, EquationControlSource as f, EquationExpression as g, HeadlessThemeFonts as h, LinearMathParseResult as i, LinearMathRejection as j, OmmlLimits as l, OpenHeadlessDocumentResult as m };

package/dist/drawing-preview-package-B9lSLRg4.d.ts

@@ -0,0 +1,115 @@
+import { a5 as OoxmlPackage } from './tree-op-types-Df4oY2u4.js';
+
+/** The longest name a bookmark is written with. */
+declare const MAX_AUTHORED_BOOKMARK_NAME_LENGTH = 40;
+/**
+ * Why a name cannot be written, or null when it can.
+ *
+ * - `empty`: no characters.
+ * - `tooLong`: more than {@link MAX_AUTHORED_BOOKMARK_NAME_LENGTH} characters.
+ * - `invalidStart`: the first character is not a letter or an underscore.
+ * - `invalidCharacter`: a later character is not a letter, a digit or an underscore.
+ *
+ * @public
+ */
+type BookmarkNameProblem = 'empty' | 'tooLong' | 'invalidStart' | 'invalidCharacter';
+/**
+ * Check a name before it is written. Measured in code points, so a letter outside the Basic
+ * Multilingual Plane counts once.
+ *
+ * @public
+ */
+declare function bookmarkNameProblem(name: string): BookmarkNameProblem | null;
+/**
+ * Whether a bookmark is hidden: its name starts with an underscore. Hidden bookmarks are the
+ * ones applications write for themselves, such as the targets of a table of contents.
+ *
+ * @public
+ */
+declare function isHiddenBookmarkName(name: string): boolean;
+/**
+ * The key two names are compared by. Names are case-insensitive, so `Intro` and `intro`
+ * share a key.
+ *
+ * @public
+ */
+declare function bookmarkNameKey(name: string): string;
+
+/**
+ * Where a drawing is. Pass an `inspectDrawingSupport` entry or an editor occurrence as is.
+ *
+ * @public
+ */
+interface DrawingPreviewTarget {
+    /** The part that holds the drawing, such as `/word/document.xml`. */
+    readonly ownerPartName: string;
+    /**
+     * The drawing, its compatibility wrapper, or any node inside them, in the package you pass.
+     * Every node of one drawing gives the same package.
+     */
+    readonly nodeId: string;
+}
+/** Caps for {@link createDrawingPreviewPackage}. @public */
+interface DrawingPreviewPackageLimits {
+    /** Maximum number of copied parts. Defaults to 64. */
+    readonly maxParts?: number;
+    /** Maximum number of copied bytes. Defaults to 64 MiB. */
+    readonly maxBytes?: number;
+}
+/**
+ * A preview package, or why it could not be built.
+ *
+ * - `drawing-not-found`: the target is not a drawing in the package.
+ * - `too-many-parts` or `too-large`: the drawing needs more than the limits allow.
+ *
+ * @public
+ */
+type DrawingPreviewPackageResult = {
+    readonly ok: true;
+    /**
+     * DOCX bytes with one paragraph that holds the drawing. The same drawing and document
+     * parts always give the same bytes, so a hash of them works as a cache key.
+     */
+    readonly docx: Uint8Array;
+    /**
+     * True when the page has the drawing's size, so the first page is the preview image.
+     * False when the size is unknown, such as a legacy VML drawing without a width and height
+     * in its style. Then the page has the document's page size and no margins, and the
+     * drawing starts at its top left corner. With the occurrence's `element.bounds`, crop
+     * from (0, 0) to `bounds.width * dpi / 72` by `bounds.height * dpi / 72` pixels;
+     * `bounds.x` and `bounds.y` are page positions, not crop offsets. Send this flag and the
+     * `bounds` size to your renderer with the bytes.
+     * Without `bounds`, such as for a report entry, trim the white space instead.
+     */
+    readonly pageFitsDrawing: boolean;
+    /** The package parts copied from the source document, for logging and caching. */
+    readonly copiedParts: readonly string[];
+} | {
+    readonly ok: false;
+    readonly reason: 'drawing-not-found' | 'too-many-parts' | 'too-large';
+};
+/**
+ * Build a small DOCX that holds one drawing for an external renderer.
+ *
+ * Contents: one paragraph with the drawing, plus the chart and diagram parts, images, styles,
+ * theme, settings, and fonts it needs. Relationships to external targets, embedded objects,
+ * macros, and templates are dropped, so the package never points outside itself.
+ *
+ * Page: the first page is the preview. It has the drawing's size, including its effect
+ * extent, so it matches the occurrence's `bounds`, and it has no margins. A floating drawing
+ * is placed on the line, and a legacy VML drawing takes its size from its style. When the
+ * size is unknown, `pageFitsDrawing` is false; see that field for how to crop.
+ *
+ * Renderer: use one other than this library, whose own exporters show the same placeholder.
+ * The bytes come from the document, so run the renderer in a sandbox without network access,
+ * with time and memory limits.
+ *
+ * Pass the package that the target comes from: an `inspectDrawingSupport` entry with the
+ * parsed package it inspected, or an editor occurrence with the editor's current package.
+ *
+ * @public
+ */
+declare function createDrawingPreviewPackage(pkg: OoxmlPackage, target: DrawingPreviewTarget, limits?: DrawingPreviewPackageLimits): DrawingPreviewPackageResult;
+
+export { MAX_AUTHORED_BOOKMARK_NAME_LENGTH as M, bookmarkNameKey as c, bookmarkNameProblem as d, createDrawingPreviewPackage as e, isHiddenBookmarkName as i };
+export type { BookmarkNameProblem as B, DrawingPreviewPackageLimits as D, DrawingPreviewPackageResult as a, DrawingPreviewTarget as b };