@docx-editor.dev/core 2.31.0 → 2.33.0

package/dist/collaboration/replication.cjs

@@ -1 +1 @@
-'use strict';var chunk6IDOVU6L_cjs=require('../chunk-6IDOVU6L.cjs'),chunkWO4V6PNS_cjs=require('../chunk-WO4V6PNS.cjs');Object.defineProperty(exports,"createCollaborationDocumentPort",{enumerable:true,get:function(){return chunk6IDOVU6L_cjs.b}});Object.defineProperty(exports,"mapOffsetAcrossText",{enumerable:true,get:function(){return chunk6IDOVU6L_cjs.c}});Object.defineProperty(exports,"historyGroupOfJournal",{enumerable:true,get:function(){return chunkWO4V6PNS_cjs.Ja}});Object.defineProperty(exports,"registerUndoHistoryPosition",{enumerable:true,get:function(){return chunkWO4V6PNS_cjs.Cl}});Object.defineProperty(exports,"reportHistoryGroup",{enumerable:true,get:function(){return chunkWO4V6PNS_cjs.Bl}});
+'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-B8l8DX3Z.js';
-export { r as reportHistoryGroup } from '../tree-package-store-B8l8DX3Z.js';
-import { ap as OoxmlElement, Q as OoxmlPackage } from '../types-barrel-CkF2JbU4.js';
-import '../editor-scope-C7ke1KJG.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 {
@@ -130,6 +130,13 @@ declare function historyGroupOfJournal(journal: CanonicalPrimitiveJournal): Hist
 /** Options for a canonical collaboration document port. @public */
 interface CreateCollaborationDocumentPortOptions {
     readonly documentId: string;
+    /**
+     * The port belongs to an editor that people edit through, so it shows undo state to them.
+     * Set it for such a host: a full-document session then refuses `beginUndoGroup()` with
+     * `editor-attached`, and attaching the port closes an open undo group. See
+     * {@link CollaborationDocumentPort.interactive}. Default false.
+     */
+    readonly interactive?: boolean;
 }
 /** Create the narrow collaboration view over one canonical package store. @public */
 declare function createCollaborationDocumentPort(store: TreePackageStore, options: CreateCollaborationDocumentPortOptions): CollaborationDocumentPort;
@@ -213,7 +220,23 @@ type CollaborationApplyResult = {
  */
 interface CollaborationDocumentPort {
     readonly documentId: string;
+    /**
+     * True for the port of an editor that people edit through, which shows undo state to
+     * them. False or absent for a headless or server replica. Optional.
+     *
+     * While a port with `true` is attached, a full-document session refuses
+     * `beginUndoGroup()` with `editor-attached`, and attaching it closes an open undo group, so
+     * the undo state a person sees stays true.
+     */
+    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
@@ -227,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-N6B3BXCL.js';export{Ja as historyGroupOfJournal,Cl as registerUndoHistoryPosition,Bl as reportHistoryGroup}from'../chunk-T2QQHG5C.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.cjs

@@ -1 +1 @@
-'use strict';var chunkBTQKU64Q_cjs=require('./chunk-BTQKU64Q.cjs');var C={"already-initialized":true,"authentication-failed":true,"baseline-digest-mismatch":true,"baseline-too-large":true,"blob-digest-mismatch":true,"blob-read":true,"blob-store-full":true,"blob-too-large":true,"collaboration-format-mismatch":true,"collaboration-session-destroyed":true,"collaboration-session-not-attached":true,"collaboration-session-not-ready":true,"collaboration-text-limit":true,"concurrent-seed":true,"document-id-mismatch":true,"duplicate-paragraph-id":true,"experimental-collaboration-body-text-only":true,"experimental-collaboration-existing-paragraphs-only":true,"experimental-collaboration-text-only":true,"experimental-collaboration-untracked-text-only":true,"immutable-baseline-changed":true,"immutable-metadata-changed":true,"initialization-aborted":true,"initialization-timeout":true,"invalid-baseline":true,"invalid-blob-descriptor":true,"invalid-bound":true,"invalid-document-id":true,"invalid-identity":true,"invalid-identity-color":true,"invalid-logical-id":true,"invalid-relationships":true,"invalid-saved-room":true,"invalid-session-id":true,"invalid-shared-metadata":true,"invalid-string":true,"local-mirror-failed":true,"materialize-dropped-content":true,"missing-blob":true,"missing-local-blob":true,"missing-root":true,"no-main-document-part":true,"not-initialized":true,"paragraph-set-mismatch":true,"port-already-attached":true,"protocol-version-mismatch":true,"prototype-key":true,"remote-apply-failed":true,"room-generation-changed":true,"saved-room-unavailable":true,"schema-version-mismatch":true,"shared-schema-invalid":true,"text-too-long":true,"too-many-attributes":true,"too-many-children":true,"too-many-nodes":true,"too-many-parts":true,"too-many-relationships":true,transport:true,"transport-disconnected":true,"tree-too-deep":true,"unknown-logical-id":true,"unknown-paragraph-id":true,"unsafe-part-name":true,"unsupported-root-key":true};function g(e){return Object.hasOwn(C,e)}function f(e,o){return e===o?true:!e||!o?false:e.code===o.code&&e.detail===o.detail}function h(e,o){return Object.freeze(o!==void 0&&o.length>0?{code:e,detail:o}:{code:e})}function S(e="initializing"){let o=e,a,l,s=0,r=false,i=false,d=Object.freeze({status:o,reason:a,lastFailure:l,failureCount:s,recovering:r,waiting:i}),u=()=>{d=Object.freeze({status:o,reason:a,lastFailure:l,failureCount:s,recovering:r,waiting:i});};return {status:()=>o,snapshot:()=>d,set(t,c,p,m=false){let n=c===void 0?void 0:h(c,p),b=t==="error"&&m;return o===t&&f(a,n)&&r===b?false:(o=t,a=n,r=b,t==="error"&&n&&(l=n,s+=1),u(),true)},setWaiting(t){return i===t?false:(i=t,u(),true)}}}Object.defineProperty(exports,"safeParticipantColor",{enumerable:true,get:function(){return chunkBTQKU64Q_cjs.a}});exports.createCollaborationStatusTracker=S;exports.isCollaborationFailureCode=g;
+'use strict';var chunk2CWQY27B_cjs=require('./chunk-2CWQY27B.cjs');Object.defineProperty(exports,"createCollaborationStatusTracker",{enumerable:true,get:function(){return chunk2CWQY27B_cjs.c}});Object.defineProperty(exports,"isCollaborationFailureCode",{enumerable:true,get:function(){return chunk2CWQY27B_cjs.b}});Object.defineProperty(exports,"safeParticipantColor",{enumerable:true,get:function(){return chunk2CWQY27B_cjs.a}});

package/dist/collaboration.d.ts

@@ -7,12 +7,12 @@
  * @packageDocumentation
  * @public
  */
-import { S as StoryScope } from './tree-package-store-B8l8DX3Z.js';
-import { ao as TreeDocOp } from './types-barrel-CkF2JbU4.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 { C as CollaborationStatus, a as CollaborationStatusSnapshot, b as CollaborationFailureCode } from './failure-NS2lsya4.js';
-export { c as CollaborationFailure, d as createCollaborationStatusTracker, i as isCollaborationFailureCode } from './failure-NS2lsya4.js';
-import './editor-scope-C7ke1KJG.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-CA6egMaK.js';
 
 /**
  * A peer's presence color is attacker-controlled: it arrives over awareness from whoever is in

package/dist/collaboration.js

@@ -1 +1 @@
-export{a as safeParticipantColor}from'./chunk-6JIJOZDW.js';var C={"already-initialized":true,"authentication-failed":true,"baseline-digest-mismatch":true,"baseline-too-large":true,"blob-digest-mismatch":true,"blob-read":true,"blob-store-full":true,"blob-too-large":true,"collaboration-format-mismatch":true,"collaboration-session-destroyed":true,"collaboration-session-not-attached":true,"collaboration-session-not-ready":true,"collaboration-text-limit":true,"concurrent-seed":true,"document-id-mismatch":true,"duplicate-paragraph-id":true,"experimental-collaboration-body-text-only":true,"experimental-collaboration-existing-paragraphs-only":true,"experimental-collaboration-text-only":true,"experimental-collaboration-untracked-text-only":true,"immutable-baseline-changed":true,"immutable-metadata-changed":true,"initialization-aborted":true,"initialization-timeout":true,"invalid-baseline":true,"invalid-blob-descriptor":true,"invalid-bound":true,"invalid-document-id":true,"invalid-identity":true,"invalid-identity-color":true,"invalid-logical-id":true,"invalid-relationships":true,"invalid-saved-room":true,"invalid-session-id":true,"invalid-shared-metadata":true,"invalid-string":true,"local-mirror-failed":true,"materialize-dropped-content":true,"missing-blob":true,"missing-local-blob":true,"missing-root":true,"no-main-document-part":true,"not-initialized":true,"paragraph-set-mismatch":true,"port-already-attached":true,"protocol-version-mismatch":true,"prototype-key":true,"remote-apply-failed":true,"room-generation-changed":true,"saved-room-unavailable":true,"schema-version-mismatch":true,"shared-schema-invalid":true,"text-too-long":true,"too-many-attributes":true,"too-many-children":true,"too-many-nodes":true,"too-many-parts":true,"too-many-relationships":true,transport:true,"transport-disconnected":true,"tree-too-deep":true,"unknown-logical-id":true,"unknown-paragraph-id":true,"unsafe-part-name":true,"unsupported-root-key":true};function g(e){return Object.hasOwn(C,e)}function f(e,o){return e===o?true:!e||!o?false:e.code===o.code&&e.detail===o.detail}function h(e,o){return Object.freeze(o!==void 0&&o.length>0?{code:e,detail:o}:{code:e})}function S(e="initializing"){let o=e,a,l,s=0,r=false,i=false,d=Object.freeze({status:o,reason:a,lastFailure:l,failureCount:s,recovering:r,waiting:i}),u=()=>{d=Object.freeze({status:o,reason:a,lastFailure:l,failureCount:s,recovering:r,waiting:i});};return {status:()=>o,snapshot:()=>d,set(t,c,p,m=false){let n=c===void 0?void 0:h(c,p),b=t==="error"&&m;return o===t&&f(a,n)&&r===b?false:(o=t,a=n,r=b,t==="error"&&n&&(l=n,s+=1),u(),true)},setWaiting(t){return i===t?false:(i=t,u(),true)}}}export{S as createCollaborationStatusTracker,g as isCollaborationFailureCode};
+export{c as createCollaborationStatusTracker,b as isCollaborationFailureCode,a as safeParticipantColor}from'./chunk-WN7ICTA5.js';

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 '../types-barrel-CkF2JbU4.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, P as Paragraph, z as ParagraphFlags, A as ParagraphTabStop, F as RevisionType, G as Section, J as SectionProperties, K as StyleDefinition, T as Table, L as Theme, M as ThemeColorScheme } from '../types-barrel-CkF2JbU4.js';
-import '../editor-scope-C7ke1KJG.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,14 +7,18 @@
  * @packageDocumentation
  * @public
  */
-export { a as ReviewDisplayMode } from '../semantic-records-B-akgRch.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 EditorFontErrorCode, L as EditorFormatPainterCommands, M as EditorHeaderFooterCommands, N as EditorHighlights, O as EditorHostChange, P as EditorHostDocument, Q as EditorNoteCommands, S as EditorPosition, T as EditorQueries, U as EditorQuery, V as EditorQueryResults, W as EditorReviewHits, X as EditorSelection, Y as EditorSnapshot, Z as FontConfiguration, _ as FontFaceRequest, $ as FontFailedDiagnostic, a0 as FontSource, a1 as FontSourceSubstitution, a2 as FormatPainterLevel, a3 as FormatPainterMode, a4 as FormatPainterSurfaceState, a5 as FurnitureVariant, a6 as HeaderFooterSlotArgs, a7 as HeaderFooterState, a8 as HighlightHit, a9 as HighlightOptions, aa as HighlightRange, ab as HighlightRect, ac as HighlightResult, ad as HistoryDiagnosticEvent, ae as HyperlinkInfo, af as ImageContext, ag as ImageCropPercent, ah as NoteKind, ai as NotePropertiesSide, aj as NotePropertiesState, ak as PageSetup, al as PerformanceDiagnostic, am as ResolveReviewChangesOptions, an as ResolvedNoteNumbering, ao as ReviewActivationOptions, ap as ReviewChangesAttribution, aq as ReviewCommentPlacement, ar as ReviewCustomPlacement, as as ReviewItemHit, at as ReviewItemPlacement, au as ReviewItemPlacementBase, av as ReviewItemQuery, aw as ReviewItemRevealEvent, ax as ReviewItemRevealSource, ay as ReviewRevisionPlacement, az as ReviewSkippedDiagnostic, aA as ScrollPlacement, aB as ScrollToAnchorOptions, aC as SelectedImageState, aD as SessionActivity, aE as SessionDiagnostic, aF as SetReviewChangesAuthorOptions, aG as TableBorderEdgeTarget, aH as TableBorderSpec, aI as TableBorderStyle, aJ as TableBorderTarget, aK as TableCellVerticalAlignment, aL as TableColumnDividerResizeTarget, aM as TableColumnOccurrenceTarget, aN as TableContext, aO as TableRightEdgeResizeTarget, aP as TableRowOccurrenceTarget, aQ as TextMatch, aR as TimingSummary, aS as TrackedChangeFilterMode, aT as TrackedChangePredicate, aU as ZoomFitTarget, aV as ZoomMode } from '../editor-B2ShlO23.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, W as DocxDocumentJSON, X as DrawingHorizontalReferenceFrame, Y as DrawingKind, Z as DrawingLocks, _ as DrawingPositionInput, $ as DrawingVerticalReferenceFrame, x as ExecErrorCode, E as ExecResult, l as Extent, a0 as FontDefinition, H as HeaderFooterSet, a1 as ImageResourceState, a2 as ImageWrapTarget, y as IndentFormatting, I as InsertableContentControlType, a3 as NumberingRef, a4 as PageMargins, P as Paragraph, a5 as ParagraphDisagreements, z as ParagraphFlags, a6 as ParagraphFormatCommand, A as ParagraphTabStop, a7 as Point, a8 as PreservedImageMime, a9 as Rect, aa 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, ab as RevisionAuthorResult, ac as RevisionBatchResult, F as RevisionType, ad as Run, k as RunFormatting, G as Section, J as SectionProperties, ae as SelectionPin, K as StyleDefinition, S as StyleDefinitions, af as SupportedImageMime, T as Table, ag as TableCell, ah as TableRow, L as Theme, M as ThemeColorScheme, ai as Unsubscribe, aj as ValidatedImageBytesHandle, ak as VectorImageMime, al as Watermark, am as WatermarkLayout, an as WatermarkState } from '../types-barrel-CkF2JbU4.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 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-Df4oY2u4.js';
 export { ContentControlSummary, DocEdits, DocQueries, DocQueryResults, ParagraphSummary } from './document.js';
-export { a as EditorExecOptions, E as EditorScope, H as HistoryDiagnostic, b as HistoryGroup, c as HistoryGroupOptions, d as HistoryGroupOutcome, V as ViewScope } from '../editor-scope-C7ke1KJG.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-dApRIYpt.js';
-import '../document-protection-C8x3P2J6.js';
-import '../failure-NS2lsya4.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-C9JlLz1L.js';
-import '../omml-equation-BsLAa2lX.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, 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-C7ke1KJG.js';
-export { E as EditorScope } from '../editor-scope-C7ke1KJG.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,21 +17,24 @@
  * @packageDocumentation
  * @public
  */
-import { R as RevisionMarkupDialogSession, a as ReviewDisplayMode } from '../semantic-records-B-akgRch.js';
-export { b as RevisionDisplayMode } from '../semantic-records-B-akgRch.js';
-import { R as ReviewPaneOptions, E as EditorDiagnostic, a as EditorDiagnosticKind } from '../editor-B2ShlO23.js';
-import { R as ReviewModelInput, a as ReviewItem, O as OoxmlPart, b as ReviewRevisionItem } from '../types-barrel-CkF2JbU4.js';
-export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, e as ReviewPosition, f as ReviewRange, g as ReviewRevisionKind, h as RevisionAddress } from '../types-barrel-CkF2JbU4.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-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 '../omml-equation-BsLAa2lX.js';
-import '../editor-scope-C7ke1KJG.js';
-import '../diagnostic-hints-C9JlLz1L.js';
-import '../failure-NS2lsya4.js';
+import '../failure-6KGFrDO9.js';
+import '../document-protection-BvbpSXbQ.js';
+import '../editor-scope-CA6egMaK.js';
+import '../editor-fonts-D_-vjuJi.js';
+import '../diagnostic-hints-BtCaCqQC.js';
 import './document.js';
 import './interaction.js';
-import '../semantic-interaction-dApRIYpt.js';
-import '../document-protection-C8x3P2J6.js';
-import '../tree-package-store-B8l8DX3Z.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,5 +7,138 @@
  * @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, W as DocxDocumentJSON, x as ExecErrorCode, E as ExecResult, l as Extent, a0 as FontDefinition, H as HeaderFooterSet, y as IndentFormatting, I as InsertableContentControlType, a3 as NumberingRef, a4 as PageMargins, P as Paragraph, a5 as ParagraphDisagreements, z as ParagraphFlags, a6 as ParagraphFormatCommand, A as ParagraphTabStop, a7 as Point, a9 as Rect, p as Revision, F as RevisionType, ad as Run, k as RunFormatting, G as Section, J as SectionProperties, ae as SelectionPin, K as StyleDefinition, S as StyleDefinitions, T as Table, ag as TableCell, ah as TableRow, L as Theme, M as ThemeColorScheme, ai as Unsubscribe, al as Watermark, am as WatermarkLayout, an as WatermarkState } from '../types-barrel-CkF2JbU4.js';
-import '../editor-scope-C7ke1KJG.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-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.
+ *
+ * - `'auto'`: the pane opens when a document with review items loads, and when a tracked
+ *   change is made while it is closed, in both cases when the pane has items to list. With
+ *   `revisionsIn: 'balloons'` the pane lists no tracked change and no reply to one, so
+ *   tracked changes and their replies alone do not open it.
+ * - `'manual'`: the pane stays closed until the host or the user opens it. Use it when the
+ *   host shows review items its own way, such as in balloons or margin markers.
+ *
+ * @public
+ */
+type ReviewPaneOpening = 'auto' | 'manual';
+/**
+ * What the open review pane does when its full card column does not fit beside the page at
+ * the page's zoom.
+ *
+ * - `'float'`: the pane shrinks to a strip of markers, and the open card floats over the
+ *   page.
+ * - `'shrinkPage'`: under a fit zoom mode, the page may shrink down to the mode's
+ *   `minZoom` (or 10%) so that the full column fits. The pane changes to the marker strip
+ *   only when the column does not fit at that floor either. A fixed zoom behaves as
+ *   `'float'`.
+ * - `'scroll'`: the page keeps the size it has beside the closed pane's marker strip, and
+ *   the full column stands beside it. The document and the column scroll together: the
+ *   viewport scrolls sideways to reach the cards.
+ *
+ * The setting applies to the review pane only. The navigation pane stays docked at its side
+ * in every mode: it never scrolls with the document, and it takes its room beside the page
+ * exactly as it does with no review pane.
+ *
+ * @public
+ */
+type ReviewPaneOverflow = 'float' | 'shrinkPage' | 'scroll';
+/**
+ * Where tracked changes open.
+ *
+ * - `'pane'`: the review pane lists tracked changes as cards beside the comments.
+ * - `'balloons'`: the pane lists comments only, except comments that reply to a tracked
+ *   change: the change's balloon shows those. A tracked change opens in a balloon at its
+ *   text when the reader clicks it, or when Next Change, Previous Change, or
+ *   `setActiveReviewItem(key, { announce: true })` reaches it. A replacement is one balloon.
+ *   In both settings, Next Change and Previous Change stop on a replacement once.
+ *
+ * @public
+ */
+type RevisionDisplay = 'pane' | 'balloons';
+/**
+ * How a collapsed comment marker looks.
+ *
+ * - `'initials'`: a badge with the thread author's initials in the author's color, a reply
+ *   count, and a check mark when the thread is resolved.
+ * - `'icon'`: the comment icon.
+ *
+ * @public
+ */
+type CommentMarkerStyle = 'initials' | 'icon';
+/**
+ * Review pane settings to change. Every field is optional, and an omitted field keeps its
+ * current value.
+ *
+ * @public
+ */
+interface ReviewPaneOptions {
+    /** Default `'auto'`. */
+    readonly opening?: ReviewPaneOpening;
+    /** Default `'float'`. */
+    readonly overflow?: ReviewPaneOverflow;
+    /** Default `'pane'`. */
+    readonly revisionsIn?: RevisionDisplay;
+    /** Default `'icon'`. */
+    readonly commentMarkers?: CommentMarkerStyle;
+}
+/**
+ * The review pane settings in force, with every field resolved.
+ *
+ * @public
+ */
+interface ResolvedReviewPane {
+    /** When the pane opens by itself. */
+    readonly opening: ReviewPaneOpening;
+    /** What the open pane does when its card column does not fit beside the page. */
+    readonly overflow: ReviewPaneOverflow;
+    /** Where tracked changes open. */
+    readonly revisionsIn: RevisionDisplay;
+    /** How a collapsed comment marker looks. */
+    readonly commentMarkers: CommentMarkerStyle;
+}
+/** The settings an editor starts with when nothing sets them. @public */
+declare const DEFAULT_REVIEW_PANE: ResolvedReviewPane;
+/**
+ * Merge `options` over `base`. Throws a `TypeError` for an unknown field or value, so a
+ * misspelled setting fails loudly instead of being ignored. Returns `base` itself when
+ * nothing changes, so the snapshot keeps its reference.
+ *
+ * @public
+ */
+declare function resolveReviewPane(options: ReviewPaneOptions | undefined, base?: ResolvedReviewPane): ResolvedReviewPane;
+/**
+ * The fields of a review item that decide whether the review pane lists it. A
+ * `ReviewItem` and a review item placement both have them.
+ *
+ * @public
+ */
+interface ReviewPaneItemFields {
+    /** The item kind, as `ReviewItem.kind` gives it. */
+    readonly kind: 'revision' | 'comment' | 'custom';
+    /** For a comment, the tracked change it replies to. */
+    readonly parentRevisionId?: string;
+}
+/**
+ * Whether the review pane lists a card for `item` under `revisionsIn`.
+ *
+ * With `'balloons'`, a balloon at the text shows every tracked change and every comment
+ * that replies to a tracked change, so the pane lists neither. Give the item as an
+ * unfiltered `getReviewItems()` read returns it: a query that excludes revision kinds
+ * removes `parentRevisionId` from replies to the changes it drops.
+ *
+ * The engine applies this rule to every review item when it decides whether the pane opens
+ * by itself or closes after a settings change. A review pane must apply the same rule before
+ * its own filters, such as a hidden kind or a host filter. Those filters can hide every card,
+ * and then the pane that the engine opens is empty.
+ *
+ * @public
+ */
+declare function reviewPaneListsItem(revisionsIn: RevisionDisplay, item: ReviewPaneItemFields): boolean;
+
+export { DEFAULT_REVIEW_PANE, resolveReviewPane, reviewPaneListsItem };
+export type { CommentMarkerStyle, ResolvedReviewPane, ReviewPaneItemFields, ReviewPaneOpening, ReviewPaneOptions, ReviewPaneOverflow, RevisionDisplay };

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

@@ -1,5 +1,5 @@
-import { Q as OoxmlPackage, O as OoxmlPart, N as OoxmlNode, aC as TreeOpRejection } from './types-barrel-CkF2JbU4.js';
-import { e as TreeModelChange, f as TreeDocumentStore } from './tree-package-store-B8l8DX3Z.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';
@@ -177,6 +177,11 @@ interface InsertCustomNodeWrite {
     readonly lock?: 'sdtLocked' | 'sdtContentLocked' | 'contentLocked';
     /** Omitted authors an ordinary tagged control with no store — the pre-payload behaviour. */
     readonly payload?: CustomNodePayloadWrite;
+    /**
+     * Propose the node as a tracked insertion. A wrap (`replaceUntil`) or a rewrite
+     * (`replaceControlId`) has no tracked form yet, and refuses with a revision.
+     */
+    readonly revision?: RevisionAttributionInput;
 }
 /**
  * Why a payload write was refused.

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-C9JlLz1L.d.ts → diagnostic-hints-BtCaCqQC.d.ts}

@@ -1,4 +1,4 @@
-import { b as CollaborationFailureCode } from './failure-NS2lsya4.js';
+import { C as CollaborationFailureCode } from './failure-6KGFrDO9.js';
 
 /**
  * The public diagnostic vocabulary: stable codes and the buckets sizes and counts are reported
@@ -16,9 +16,9 @@ type DocumentOpenDiagnosticCode = 'open.unsupported-source' | 'open.zip-corrupt'
  */
 type DocumentSaveDiagnosticCode = 'save.no-document' | 'save.document-changed' | 'save.failed';
 /** 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.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.section-mark' | 'edit.table-structure-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';
+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-C8x3P2J6.d.ts → document-protection-BvbpSXbQ.d.ts}

@@ -1,4 +1,4 @@
-import { N as OoxmlNode } from './types-barrel-CkF2JbU4.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';