@docx-editor.dev/core 2.9.1 → 2.10.0

package/dist/contracts/document.d.cts

@@ -62,9 +62,14 @@ interface DocEdits {
     removeHyperlink: {
         target: DocTarget;
     };
+    /**
+     * `'section'` is Word's Next Page break; `'sectionContinuous'` keeps the new section on
+     * the sheet the previous one ended, which is how a mid-page column or margin change is
+     * authored. `'column'` belongs to the multi-column lane and is refused for now.
+     */
     insertBreak: {
         target: DocTarget;
-        kind: 'page' | 'column' | 'line' | 'section';
+        kind: 'page' | 'column' | 'line' | 'section' | 'sectionContinuous';
     };
     /**
      * Word's Increase/Decrease Indent.

package/dist/contracts/document.d.ts

@@ -62,9 +62,14 @@ interface DocEdits {
     removeHyperlink: {
         target: DocTarget;
     };
+    /**
+     * `'section'` is Word's Next Page break; `'sectionContinuous'` keeps the new section on
+     * the sheet the previous one ended, which is how a mid-page column or margin change is
+     * authored. `'column'` belongs to the multi-column lane and is refused for now.
+     */
     insertBreak: {
         target: DocTarget;
-        kind: 'page' | 'column' | 'line' | 'section';
+        kind: 'page' | 'column' | 'line' | 'section' | 'sectionContinuous';
     };
     /**
      * Word's Increase/Decrease Indent.

package/dist/contracts/editor.d.cts

@@ -1,11 +1,11 @@
 export { ContentControlSummary, DocEdits, DocQueries, DocQueryResults, ParagraphSummary } from './document.cjs';
-export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind } from '../review-items-DpsqTHio.cjs';
-export { A as AuthoredNoteNumbering, C as CanResult, q as DocumentChange, r as DocumentEditingMode, t as DocumentHandle, D as DocumentSource, l as Editor, b as EditorCommand, u as EditorCommandShape, w as EditorCommands, x as EditorError, y as EditorEvents, E as EditorFontError, z as EditorFontErrorCode, B as EditorHeaderFooterCommands, G as EditorNoteCommands, H as EditorPosition, J as EditorQueries, K as EditorQuery, L as EditorQueryResults, M as EditorScope, N as EditorSelection, a as EditorSnapshot, F as FontConfiguration, m as FontFaceRequest, j as FontSource, k as FontSourceSubstitution, O as FurnitureVariant, P as HeaderFooterSlotArgs, Q as HeaderFooterState, R as HyperlinkInfo, I as ImageContext, c as ImageCropPercent, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, Y as NoteKind, _ as NotePropertiesSide, $ as NotePropertiesState, a0 as PageSetup, a1 as ResolvedNoteNumbering, a2 as ReviewActivationOptions, a3 as ReviewCommentPlacement, a4 as ReviewCustomPlacement, a5 as ReviewItemPlacement, a6 as ReviewItemPlacementBase, a7 as ReviewItemQuery, a8 as ReviewRevisionPlacement, S as SelectedImageState, a9 as SemanticIdentity, aa as SemanticTarget, T as TableBorderEdgeTarget, n as TableBorderSpec, o as TableBorderStyle, ab as TableBorderTarget, ac as TableCellVerticalAlignment, ad as TableColumnDividerResizeTarget, ae as TableColumnOccurrenceTarget, p as TableContext, af as TableRightEdgeResizeTarget, ag as TableRowOccurrenceTarget, ah as TextMatch, V as ViewScope, ai as ZoomFitTarget, Z as ZoomMode } from '../editor-CojjwMmF.cjs';
-export { S as SemanticPosition, a as SemanticSelection } from '../semantic-interaction-BjOcDB06.cjs';
+export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind } from '../review-items-CwixiHNe.cjs';
+export { A as AuthoredNoteNumbering, C as CanResult, q as DocumentChange, r as DocumentEditingMode, t as DocumentHandle, D as DocumentSource, l as Editor, b as EditorCommand, u as EditorCommandShape, w as EditorCommands, x as EditorError, y as EditorEvents, E as EditorFontError, z as EditorFontErrorCode, B as EditorHeaderFooterCommands, G as EditorNoteCommands, H as EditorPosition, J as EditorQueries, K as EditorQuery, L as EditorQueryResults, M as EditorScope, N as EditorSelection, a as EditorSnapshot, F as FontConfiguration, m as FontFaceRequest, j as FontSource, k as FontSourceSubstitution, O as FurnitureVariant, P as HeaderFooterSlotArgs, Q as HeaderFooterState, R as HyperlinkInfo, I as ImageContext, c as ImageCropPercent, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, Y as NoteKind, _ as NotePropertiesSide, $ as NotePropertiesState, a0 as PageSetup, a1 as ResolvedNoteNumbering, a2 as ReviewActivationOptions, a3 as ReviewCommentPlacement, a4 as ReviewCustomPlacement, a5 as ReviewItemPlacement, a6 as ReviewItemPlacementBase, a7 as ReviewItemQuery, a8 as ReviewRevisionPlacement, S as SelectedImageState, a9 as SemanticIdentity, aa as SemanticTarget, T as TableBorderEdgeTarget, n as TableBorderSpec, o as TableBorderStyle, ab as TableBorderTarget, ac as TableCellVerticalAlignment, ad as TableColumnDividerResizeTarget, ae as TableColumnOccurrenceTarget, p as TableContext, af as TableRightEdgeResizeTarget, ag as TableRowOccurrenceTarget, ah as TextMatch, V as ViewScope, ai as ZoomFitTarget, Z as ZoomMode } from '../editor-CwzY2Hcg.cjs';
+export { S as SemanticPosition, a as SemanticSelection } from '../semantic-interaction-Z0xKQcB4.cjs';
 export { Block, ColorValue, ContainerRef, ContentControl, ContentControlFilter, ContentControlType, DocAnchor, DocAnchorRange, DocComment, DocLocation, DocRange, DocTarget, DocumentBody, DocxDocument, DocxDocumentJSON, ExecErrorCode, ExecResult, Extent, FontDefinition, HeaderFooterSet, IndentFormatting, InsertableContentControlType, NumberingRef, PageMargins, Paragraph, ParagraphDisagreements, ParagraphFlags, ParagraphFormatCommand, ParagraphTabStop, Point, Rect, Revision, RevisionType, Run, RunFormatting, Section, SectionProperties, SelectionPin, StyleDefinition, StyleDefinitions, Table, TableCell, TableRow, Theme, ThemeColorScheme, Unsubscribe, Watermark } from './types.cjs';
-export { f as DrawingHorizontalReferenceFrame, c as DrawingKind, e as DrawingLocks, d as DrawingPositionInput, g as DrawingVerticalReferenceFrame, b as ImageWrapTarget, R as RevisionAddress } from '../tree-op-types-B0-sCtw-.cjs';
-export { I as ImageResourceState, P as PreservedImageMime, R as RenderableImageMime, S as SupportedImageMime, V as ValidatedImageBytesHandle, a as VectorImageMime } from '../image-resources-DQOiwOuE.cjs';
+export { g as DrawingHorizontalReferenceFrame, D as DrawingKind, e as DrawingLocks, d as DrawingPositionInput, h as DrawingVerticalReferenceFrame, f as ImageResourceState, b as ImageWrapTarget, P as PreservedImageMime, R as RenderableImageMime, c as SupportedImageMime, V as ValidatedImageBytesHandle, i as VectorImageMime } from '../tree-op-types-DSJYmf5b.cjs';
+export { R as RevisionAddress } from '../tree-op-revision-attribution-CN06Xshv.cjs';
 import '../ooxml-package-CdEy9ufK.cjs';
-import '../semantic-records-C3Z76KeN.cjs';
+import '../semantic-records-CMakzQ1X.cjs';
 import '../revision-projection-Cc4wz30g.cjs';
 import '../omml-equation-BD-LsmWE.cjs';

package/dist/contracts/editor.d.ts

@@ -1,11 +1,11 @@
 export { ContentControlSummary, DocEdits, DocQueries, DocQueryResults, ParagraphSummary } from './document.js';
-export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind } from '../review-items-D5SPFtsO.js';
-export { A as AuthoredNoteNumbering, C as CanResult, q as DocumentChange, r as DocumentEditingMode, t as DocumentHandle, D as DocumentSource, l as Editor, b as EditorCommand, u as EditorCommandShape, w as EditorCommands, x as EditorError, y as EditorEvents, E as EditorFontError, z as EditorFontErrorCode, B as EditorHeaderFooterCommands, G as EditorNoteCommands, H as EditorPosition, J as EditorQueries, K as EditorQuery, L as EditorQueryResults, M as EditorScope, N as EditorSelection, a as EditorSnapshot, F as FontConfiguration, m as FontFaceRequest, j as FontSource, k as FontSourceSubstitution, O as FurnitureVariant, P as HeaderFooterSlotArgs, Q as HeaderFooterState, R as HyperlinkInfo, I as ImageContext, c as ImageCropPercent, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, Y as NoteKind, _ as NotePropertiesSide, $ as NotePropertiesState, a0 as PageSetup, a1 as ResolvedNoteNumbering, a2 as ReviewActivationOptions, a3 as ReviewCommentPlacement, a4 as ReviewCustomPlacement, a5 as ReviewItemPlacement, a6 as ReviewItemPlacementBase, a7 as ReviewItemQuery, a8 as ReviewRevisionPlacement, S as SelectedImageState, a9 as SemanticIdentity, aa as SemanticTarget, T as TableBorderEdgeTarget, n as TableBorderSpec, o as TableBorderStyle, ab as TableBorderTarget, ac as TableCellVerticalAlignment, ad as TableColumnDividerResizeTarget, ae as TableColumnOccurrenceTarget, p as TableContext, af as TableRightEdgeResizeTarget, ag as TableRowOccurrenceTarget, ah as TextMatch, V as ViewScope, ai as ZoomFitTarget, Z as ZoomMode } from '../editor-PUlv5Pp7.js';
-export { S as SemanticPosition, a as SemanticSelection } from '../semantic-interaction-Cca1-X_a.js';
+export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind } from '../review-items-Dw-8a6Ie.js';
+export { A as AuthoredNoteNumbering, C as CanResult, q as DocumentChange, r as DocumentEditingMode, t as DocumentHandle, D as DocumentSource, l as Editor, b as EditorCommand, u as EditorCommandShape, w as EditorCommands, x as EditorError, y as EditorEvents, E as EditorFontError, z as EditorFontErrorCode, B as EditorHeaderFooterCommands, G as EditorNoteCommands, H as EditorPosition, J as EditorQueries, K as EditorQuery, L as EditorQueryResults, M as EditorScope, N as EditorSelection, a as EditorSnapshot, F as FontConfiguration, m as FontFaceRequest, j as FontSource, k as FontSourceSubstitution, O as FurnitureVariant, P as HeaderFooterSlotArgs, Q as HeaderFooterState, R as HyperlinkInfo, I as ImageContext, c as ImageCropPercent, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, Y as NoteKind, _ as NotePropertiesSide, $ as NotePropertiesState, a0 as PageSetup, a1 as ResolvedNoteNumbering, a2 as ReviewActivationOptions, a3 as ReviewCommentPlacement, a4 as ReviewCustomPlacement, a5 as ReviewItemPlacement, a6 as ReviewItemPlacementBase, a7 as ReviewItemQuery, a8 as ReviewRevisionPlacement, S as SelectedImageState, a9 as SemanticIdentity, aa as SemanticTarget, T as TableBorderEdgeTarget, n as TableBorderSpec, o as TableBorderStyle, ab as TableBorderTarget, ac as TableCellVerticalAlignment, ad as TableColumnDividerResizeTarget, ae as TableColumnOccurrenceTarget, p as TableContext, af as TableRightEdgeResizeTarget, ag as TableRowOccurrenceTarget, ah as TextMatch, V as ViewScope, ai as ZoomFitTarget, Z as ZoomMode } from '../editor-C0my6Uta.js';
+export { S as SemanticPosition, a as SemanticSelection } from '../semantic-interaction-B6hFRQLy.js';
 export { Block, ColorValue, ContainerRef, ContentControl, ContentControlFilter, ContentControlType, DocAnchor, DocAnchorRange, DocComment, DocLocation, DocRange, DocTarget, DocumentBody, DocxDocument, DocxDocumentJSON, ExecErrorCode, ExecResult, Extent, FontDefinition, HeaderFooterSet, IndentFormatting, InsertableContentControlType, NumberingRef, PageMargins, Paragraph, ParagraphDisagreements, ParagraphFlags, ParagraphFormatCommand, ParagraphTabStop, Point, Rect, Revision, RevisionType, Run, RunFormatting, Section, SectionProperties, SelectionPin, StyleDefinition, StyleDefinitions, Table, TableCell, TableRow, Theme, ThemeColorScheme, Unsubscribe, Watermark } from './types.js';
-export { f as DrawingHorizontalReferenceFrame, c as DrawingKind, e as DrawingLocks, d as DrawingPositionInput, g as DrawingVerticalReferenceFrame, b as ImageWrapTarget, R as RevisionAddress } from '../tree-op-types-XMVsJSpe.js';
-export { I as ImageResourceState, P as PreservedImageMime, R as RenderableImageMime, S as SupportedImageMime, V as ValidatedImageBytesHandle, a as VectorImageMime } from '../image-resources-eZqD_-vC.js';
+export { g as DrawingHorizontalReferenceFrame, D as DrawingKind, e as DrawingLocks, d as DrawingPositionInput, h as DrawingVerticalReferenceFrame, f as ImageResourceState, b as ImageWrapTarget, P as PreservedImageMime, R as RenderableImageMime, c as SupportedImageMime, V as ValidatedImageBytesHandle, i as VectorImageMime } from '../tree-op-types-BuOfCrkp.js';
+export { R as RevisionAddress } from '../tree-op-revision-attribution-CN06Xshv.js';
 import '../ooxml-package-CdEy9ufK.js';
-import '../semantic-records-Cc1MJrhM.js';
+import '../semantic-records-Do3-i5oB.js';
 import '../revision-projection-CILpvv4M.js';
 import '../omml-equation-Dd3mBep-.js';

package/dist/contracts/interaction.d.cts

@@ -1,11 +1,11 @@
-export { M as EditorScope, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, a9 as SemanticIdentity, aa as SemanticTarget, V as ViewScope } from '../editor-CojjwMmF.cjs';
+export { M as EditorScope, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, a9 as SemanticIdentity, aa as SemanticTarget, V as ViewScope } from '../editor-CwzY2Hcg.cjs';
 import './document.cjs';
 import './types.cjs';
-import '../review-items-DpsqTHio.cjs';
+import '../review-items-CwixiHNe.cjs';
 import '../ooxml-package-CdEy9ufK.cjs';
-import '../tree-op-types-B0-sCtw-.cjs';
-import '../semantic-interaction-BjOcDB06.cjs';
-import '../semantic-records-C3Z76KeN.cjs';
-import '../image-resources-DQOiwOuE.cjs';
+import '../tree-op-revision-attribution-CN06Xshv.cjs';
+import '../semantic-interaction-Z0xKQcB4.cjs';
+import '../semantic-records-CMakzQ1X.cjs';
+import '../tree-op-types-DSJYmf5b.cjs';
 import '../revision-projection-Cc4wz30g.cjs';
 import '../omml-equation-BD-LsmWE.cjs';

package/dist/contracts/interaction.d.ts

@@ -1,11 +1,11 @@
-export { M as EditorScope, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, a9 as SemanticIdentity, aa as SemanticTarget, V as ViewScope } from '../editor-PUlv5Pp7.js';
+export { M as EditorScope, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, a9 as SemanticIdentity, aa as SemanticTarget, V as ViewScope } from '../editor-C0my6Uta.js';
 import './document.js';
 import './types.js';
-import '../review-items-D5SPFtsO.js';
+import '../review-items-Dw-8a6Ie.js';
 import '../ooxml-package-CdEy9ufK.js';
-import '../tree-op-types-XMVsJSpe.js';
-import '../semantic-interaction-Cca1-X_a.js';
-import '../semantic-records-Cc1MJrhM.js';
-import '../image-resources-eZqD_-vC.js';
+import '../tree-op-revision-attribution-CN06Xshv.js';
+import '../semantic-interaction-B6hFRQLy.js';
+import '../semantic-records-Do3-i5oB.js';
+import '../tree-op-types-BuOfCrkp.js';
 import '../revision-projection-CILpvv4M.js';
 import '../omml-equation-Dd3mBep-.js';

package/dist/contracts/modules.d.cts

@@ -1,9 +1,8 @@
 import { O as OoxmlPart } from '../ooxml-package-CdEy9ufK.cjs';
-import { R as ReviewModelInput, a as ReviewItem, b as ReviewRevisionItem } from '../review-items-DpsqTHio.cjs';
-export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, e as ReviewPosition, f as ReviewRange, g as ReviewRevisionKind } from '../review-items-DpsqTHio.cjs';
-export { R as RevisionAddress } from '../tree-op-types-B0-sCtw-.cjs';
+export { R as RevisionAddress } from '../tree-op-revision-attribution-CN06Xshv.cjs';
+import { R as ReviewModelInput, a as ReviewItem, b as ReviewRevisionItem } from '../review-items-CwixiHNe.cjs';
+export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, e as ReviewPosition, f as ReviewRange, g as ReviewRevisionKind } from '../review-items-CwixiHNe.cjs';
 import { R as RevisionDisplayMode } from '../revision-projection-Cc4wz30g.cjs';
-import './types.cjs';
 
 /**
  * `@docx-editor.dev/core/contracts/modules` — the `EditorModule` seam.

package/dist/contracts/modules.d.ts

@@ -1,9 +1,8 @@
 import { O as OoxmlPart } from '../ooxml-package-CdEy9ufK.js';
-import { R as ReviewModelInput, a as ReviewItem, b as ReviewRevisionItem } from '../review-items-D5SPFtsO.js';
-export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, e as ReviewPosition, f as ReviewRange, g as ReviewRevisionKind } from '../review-items-D5SPFtsO.js';
-export { R as RevisionAddress } from '../tree-op-types-XMVsJSpe.js';
+export { R as RevisionAddress } from '../tree-op-revision-attribution-CN06Xshv.js';
+import { R as ReviewModelInput, a as ReviewItem, b as ReviewRevisionItem } from '../review-items-Dw-8a6Ie.js';
+export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, e as ReviewPosition, f as ReviewRange, g as ReviewRevisionKind } from '../review-items-Dw-8a6Ie.js';
 import { R as RevisionDisplayMode } from '../revision-projection-CILpvv4M.js';
-import './types.js';
 
 /**
  * `@docx-editor.dev/core/contracts/modules` — the `EditorModule` seam.

package/dist/{custom-node-writes-QyVZdTUA.d.ts → custom-node-writes-BvpWCnW8.d.ts}

@@ -1,9 +1,9 @@
 import { c as OoxmlPackage, O as OoxmlPart, a as OoxmlNode } from './ooxml-package-CdEy9ufK.js';
-import { S as SupportedImageMime, b as ImageDecodePort } from './image-resources-eZqD_-vC.js';
-import { h as DrawingTreeDocOp, a as TreeOpRejection, T as TreeDocOp } from './tree-op-types-XMVsJSpe.js';
+import { c as SupportedImageMime, j as ImageDecodePort, k as DrawingTreeDocOp, a as TreeOpRejection, T as TreeDocOp } from './tree-op-types-BuOfCrkp.js';
+import { a as RevisionAttributionInput } from './tree-op-revision-attribution-CN06Xshv.js';
 import { c as HeaderFooterKind, H as HeaderFooterVariant } from './hf-references-z5Y4N1ab.js';
 import { N as NoteKind } from './note-nodes-BNCANoGN.js';
-import { T as TreeModelChange, a as TreeStoryRef, b as TreeDocumentStore, c as TransactionContext, d as TransactOptions, S as SelectionMark, e as TreeDocumentCheckpoint } from './tree-store-ClA-qng4.js';
+import { T as TreeModelChange, a as TreeStoryRef, b as TreeDocumentStore, c as TransactionContext, d as TransactOptions, S as SelectionMark, e as TreeDocumentCheckpoint } from './tree-store-ASBtz7UB.js';
 
 /** A freshly allocated drawing property id, or the reason one could not be minted. */
 type DrawingPropertyIdResult = {
@@ -283,6 +283,15 @@ declare function createNoteReferenceScanBudget(maxVisited?: number, maxParts?: n
  * later usable Internal notes part (same continue-past-bad pattern as settingsPartOf).
  */
 declare function resolveNotesPart(pkg: OoxmlPackage, noteKind: NoteKind): OoxmlPart | null;
+/**
+ * Walk a part for addressable typed note references. Budgeted scans are bounded by
+ * visited nodes and fail closed on deep hostile nesting (the shared budget is marked
+ * truncated and the walk stops, so mutation callers refuse); budget-free scans are
+ * bounded by the 64-level depth cap and `maxHits` alone and fail open (a too-deep
+ * subtree is pruned and siblings still scan, so layout keeps every reachable citation).
+ * When `budget` is supplied it is shared and mutated in place. Hits are segment-aligned
+ * (`segmentsOf`); demoted wrappers never invent atomOffsets.
+ */
 declare function collectNoteReferences(part: OoxmlPart, options?: {
     readonly maxHits?: number;
     readonly budget?: NoteReferenceScanBudget;
@@ -320,6 +329,13 @@ type NoteLifecycleOp = {
     readonly noteKind: NoteKind;
     readonly paragraphId: string;
     readonly offset: number;
+    /**
+     * Write the citing reference as a TRACKED insertion: the reference run goes inside a
+     * `w:ins` carrying this attribution. The note body stays plain — rejecting the
+     * reference removes it, and the orphaned body is swept by the same cascade an
+     * untracked reference deletion triggers.
+     */
+    readonly revision?: RevisionAttributionInput;
 } | {
     readonly op: 'deleteNote';
     readonly noteKind: NoteKind;
@@ -353,7 +369,7 @@ type NoteLifecycleOp = {
     };
 };
 /** Why a note lifecycle op was refused. */
-type NoteLifecycleRejection = 'invalidArgs' | 'tree-invariant';
+type NoteLifecycleRejection = 'invalidArgs' | 'invalid-property-value' | 'tree-invariant';
 /**
  * A new package, or a typed rejection.
  *
@@ -446,6 +462,8 @@ interface InsertImageInput {
     readonly title?: string;
     readonly description?: string;
     readonly hyperlink?: string;
+    /** Present in suggesting mode: the inserted drawing's run goes into a `w:ins`. */
+    readonly revision?: RevisionAttributionInput;
 }
 interface ReplaceImageOptions {
     readonly expectedPackageRevision: number;
@@ -625,10 +643,14 @@ declare class TreePackageStore {
      * Insert a validated raster image as one package undo unit (task 12).
      */
     insertImage(scope: StoryScope, input: InsertImageInput): Promise<ImageIntentResult>;
+    /** Land a clipboard fragment (resource merge + blocks) as one package undo unit. */
+    applyFragmentPaste(scope: StoryScope, input: FragmentPasteInput): FragmentPasteResult;
     /** Replace a picture drawing's embedded media in one package undo unit. */
     replaceImage(scope: StoryScope, drawingNodeId: string, bytes: Uint8Array, mime: SupportedImageMime, decodePort: ImageDecodePort, options: ReplaceImageOptions): Promise<ImageIntentResult>;
     /** Delete a picture drawing and collect orphaned media in one package undo unit. */
     deleteImage(scope: StoryScope, drawingNodeId: string): ImageIntentResult;
+    /** Propose the deletion as a tracked change: the drawing goes into a `w:del`, media stays. */
+    deleteImageTracked(scope: StoryScope, drawingNodeId: string, revision: RevisionAttributionInput): ImageIntentResult;
     /** Fetch external bytes explicitly and embed them; no fetch on open/load. */
     embedExternalImage(scope: StoryScope, drawingNodeId: string, url: string, port: ExternalImageFetchPort, signal: AbortSignal, decodePort: ImageDecodePort): Promise<ImageIntentResult>;
     /** Metadata plus hyperlink target creation in one package transaction. */
@@ -717,6 +739,31 @@ declare class TreePackageStore {
     private publishSynthetic;
 }
 
+/** Decoded fragment payloads above this cap are refused before any package work. */
+declare const MAX_FRAGMENT_DECODED_BYTES: number;
+interface FragmentPasteInput {
+    readonly paragraphId: string;
+    readonly offset: number;
+    /** The fragment package zip (from the clipboard codec or the HTML projection). */
+    readonly fragmentBytes: Uint8Array;
+    readonly lastMarkCovered: boolean;
+    /** Ops that clear the current selection first (the surface's deleteSelectionPlan). */
+    readonly priorOps?: readonly TreeDocOp[];
+}
+type FragmentPasteResult = (Extract<PackageTransactResult, {
+    ok: true;
+}> & {
+    readonly blockCount: number;
+}) | Extract<PackageTransactResult, {
+    ok: false;
+}>;
+/**
+ * Read the fragment through the bounded file-open trust boundary, merge its resources,
+ * and land its blocks — all inside one transaction. Any refusal leaves the document
+ * exactly as it was; the caller (the paste router) degrades to the next flavour.
+ */
+declare function applyFragmentPaste(store: TreePackageStore, scope: StoryScope, input: FragmentPasteInput): FragmentPasteResult;
+
 /**
  * The payload half of an insert: which store, which node, and what it holds.
  *
@@ -905,4 +952,4 @@ type CustomNodeSweepOutcome = {
     readonly reason: string;
 };
 
-export { customNodePayloadsByControl as $, type ApplyImagePropertiesInput as A, type BookmarkIndex as B, type CustomNodeWriteResult as C, type DocumentTrackingSettings as D, type EmbeddedFont as E, type FontStyleKey as F, type NoteReferenceScanBudget as G, type HeaderFooterLifecycleImpact as H, type InsertCustomNodeWrite as I, type ReadEmbeddedFontsOptions as J, type StoryResolveResult as K, type ListKind as L, MAX_CUSTOM_NODE_LABEL_LENGTH as M, NO_TRACKING_SETTINGS as N, type TreePackageStoreOptions as O, type PackageTransactResult as P, allocateDrawingPropertyId as Q, type ReplaceImageOptions as R, type StoryScope as S, TreePackageStore as T, applyHeaderFooterLifecycleOp as U, applyNoteLifecycleOp as V, buildBookmarkIndex as W, cascadeDeletedNoteReferences as X, collectNoteReferences as Y, collectPackageNoteReferences as Z, createNoteReferenceScanBudget as _, type StoryTargetRejection as a, customNodePayloadsOf as a0, deobfuscateFont as a1, diagnoseNoteReferences as a2, ensureListDefinition as a3, ensureNumberingLevel as a4, insertCustomNodeWrite as a5, isHeaderFooterLifecycleOp as a6, isNoteLifecycleOp as a7, normalNoteIds as a8, notesPartHasId as a9, readEmbeddedFonts as aa, readTrackingSettings as ab, removeCustomNodeWrite as ac, resolveNotesPart as ad, sweepCustomNodePayloads as ae, withBinaryPart as af, withEmbeddedImage as ag, withoutUnreferencedImagePart as ah, type CustomNodeSweepOutcome as b, type InsertImageInput as c, type ImageIntentResult as d, type BookmarkAnchor as e, type CascadeDeletedNoteReferencesOptions as f, type CustomNodePayloadRead as g, type CustomNodePayloadWrite as h, type CustomNodeSweepResult as i, type CustomNodeWriteRejection as j, DEFAULT_MAX_EDITABLE_STORY_PARTS as k, type DrawingPropertyIdResult as l, type HeaderFooterLifecycleOp as m, type HeaderFooterLifecycleRejection as n, type HeaderFooterLifecycleResult as o, MAX_CUSTOM_NODE_PAYLOAD_LENGTH as p, MAX_NOTE_REFERENCE_PARTS as q, MAX_NOTE_REFERENCE_SCAN as r, type NoteDiagnostic as s, type NoteDiagnosticCode as t, type NoteLifecycleImpact as u, type NoteLifecycleOp as v, type NoteLifecycleOptions as w, type NoteLifecycleRejection as x, type NoteLifecycleResult as y, type NoteReferenceHit as z };
+export { cascadeDeletedNoteReferences as $, type ApplyImagePropertiesInput as A, type BookmarkIndex as B, type CustomNodeWriteResult as C, type DocumentTrackingSettings as D, type EmbeddedFont as E, type FragmentPasteInput as F, type NoteLifecycleRejection as G, type HeaderFooterLifecycleImpact as H, type InsertCustomNodeWrite as I, type NoteLifecycleResult as J, type NoteReferenceHit as K, type ListKind as L, MAX_CUSTOM_NODE_LABEL_LENGTH as M, NO_TRACKING_SETTINGS as N, type NoteReferenceScanBudget as O, type PackageTransactResult as P, type ReadEmbeddedFontsOptions as Q, type ReplaceImageOptions as R, type StoryScope as S, type StoryResolveResult as T, TreePackageStore as U, type TreePackageStoreOptions as V, allocateDrawingPropertyId as W, applyFragmentPaste as X, applyHeaderFooterLifecycleOp as Y, applyNoteLifecycleOp as Z, buildBookmarkIndex as _, type StoryTargetRejection as a, collectNoteReferences as a0, collectPackageNoteReferences as a1, createNoteReferenceScanBudget as a2, customNodePayloadsByControl as a3, customNodePayloadsOf as a4, deobfuscateFont as a5, diagnoseNoteReferences as a6, ensureListDefinition as a7, ensureNumberingLevel as a8, insertCustomNodeWrite as a9, isHeaderFooterLifecycleOp as aa, isNoteLifecycleOp as ab, normalNoteIds as ac, notesPartHasId as ad, readEmbeddedFonts as ae, readTrackingSettings as af, removeCustomNodeWrite as ag, resolveNotesPart as ah, sweepCustomNodePayloads as ai, withBinaryPart as aj, withEmbeddedImage as ak, withoutUnreferencedImagePart as al, type CustomNodeSweepOutcome as b, type InsertImageInput as c, type ImageIntentResult as d, type FragmentPasteResult as e, type BookmarkAnchor as f, type CascadeDeletedNoteReferencesOptions as g, type CustomNodePayloadRead as h, type CustomNodePayloadWrite as i, type CustomNodeSweepResult as j, type CustomNodeWriteRejection as k, DEFAULT_MAX_EDITABLE_STORY_PARTS as l, type DrawingPropertyIdResult as m, type FontStyleKey as n, type HeaderFooterLifecycleOp as o, type HeaderFooterLifecycleRejection as p, type HeaderFooterLifecycleResult as q, MAX_CUSTOM_NODE_PAYLOAD_LENGTH as r, MAX_FRAGMENT_DECODED_BYTES as s, MAX_NOTE_REFERENCE_PARTS as t, MAX_NOTE_REFERENCE_SCAN as u, type NoteDiagnostic as v, type NoteDiagnosticCode as w, type NoteLifecycleImpact as x, type NoteLifecycleOp as y, type NoteLifecycleOptions as z };

package/dist/{custom-node-writes-7ERv0f_X.d.cts → custom-node-writes-Db8H6Z3n.d.cts}

@@ -1,9 +1,9 @@
 import { c as OoxmlPackage, O as OoxmlPart, a as OoxmlNode } from './ooxml-package-CdEy9ufK.cjs';
-import { S as SupportedImageMime, b as ImageDecodePort } from './image-resources-DQOiwOuE.cjs';
-import { h as DrawingTreeDocOp, a as TreeOpRejection, T as TreeDocOp } from './tree-op-types-B0-sCtw-.cjs';
+import { c as SupportedImageMime, j as ImageDecodePort, k as DrawingTreeDocOp, a as TreeOpRejection, T as TreeDocOp } from './tree-op-types-DSJYmf5b.cjs';
+import { a as RevisionAttributionInput } from './tree-op-revision-attribution-CN06Xshv.cjs';
 import { c as HeaderFooterKind, H as HeaderFooterVariant } from './hf-references-Dvk6De4Q.cjs';
 import { N as NoteKind } from './note-nodes-DL-Au22P.cjs';
-import { T as TreeModelChange, a as TreeStoryRef, b as TreeDocumentStore, c as TransactionContext, d as TransactOptions, S as SelectionMark, e as TreeDocumentCheckpoint } from './tree-store-C6vc8E_2.cjs';
+import { T as TreeModelChange, a as TreeStoryRef, b as TreeDocumentStore, c as TransactionContext, d as TransactOptions, S as SelectionMark, e as TreeDocumentCheckpoint } from './tree-store-CWOUMGN8.cjs';
 
 /** A freshly allocated drawing property id, or the reason one could not be minted. */
 type DrawingPropertyIdResult = {
@@ -283,6 +283,15 @@ declare function createNoteReferenceScanBudget(maxVisited?: number, maxParts?: n
  * later usable Internal notes part (same continue-past-bad pattern as settingsPartOf).
  */
 declare function resolveNotesPart(pkg: OoxmlPackage, noteKind: NoteKind): OoxmlPart | null;
+/**
+ * Walk a part for addressable typed note references. Budgeted scans are bounded by
+ * visited nodes and fail closed on deep hostile nesting (the shared budget is marked
+ * truncated and the walk stops, so mutation callers refuse); budget-free scans are
+ * bounded by the 64-level depth cap and `maxHits` alone and fail open (a too-deep
+ * subtree is pruned and siblings still scan, so layout keeps every reachable citation).
+ * When `budget` is supplied it is shared and mutated in place. Hits are segment-aligned
+ * (`segmentsOf`); demoted wrappers never invent atomOffsets.
+ */
 declare function collectNoteReferences(part: OoxmlPart, options?: {
     readonly maxHits?: number;
     readonly budget?: NoteReferenceScanBudget;
@@ -320,6 +329,13 @@ type NoteLifecycleOp = {
     readonly noteKind: NoteKind;
     readonly paragraphId: string;
     readonly offset: number;
+    /**
+     * Write the citing reference as a TRACKED insertion: the reference run goes inside a
+     * `w:ins` carrying this attribution. The note body stays plain — rejecting the
+     * reference removes it, and the orphaned body is swept by the same cascade an
+     * untracked reference deletion triggers.
+     */
+    readonly revision?: RevisionAttributionInput;
 } | {
     readonly op: 'deleteNote';
     readonly noteKind: NoteKind;
@@ -353,7 +369,7 @@ type NoteLifecycleOp = {
     };
 };
 /** Why a note lifecycle op was refused. */
-type NoteLifecycleRejection = 'invalidArgs' | 'tree-invariant';
+type NoteLifecycleRejection = 'invalidArgs' | 'invalid-property-value' | 'tree-invariant';
 /**
  * A new package, or a typed rejection.
  *
@@ -446,6 +462,8 @@ interface InsertImageInput {
     readonly title?: string;
     readonly description?: string;
     readonly hyperlink?: string;
+    /** Present in suggesting mode: the inserted drawing's run goes into a `w:ins`. */
+    readonly revision?: RevisionAttributionInput;
 }
 interface ReplaceImageOptions {
     readonly expectedPackageRevision: number;
@@ -625,10 +643,14 @@ declare class TreePackageStore {
      * Insert a validated raster image as one package undo unit (task 12).
      */
     insertImage(scope: StoryScope, input: InsertImageInput): Promise<ImageIntentResult>;
+    /** Land a clipboard fragment (resource merge + blocks) as one package undo unit. */
+    applyFragmentPaste(scope: StoryScope, input: FragmentPasteInput): FragmentPasteResult;
     /** Replace a picture drawing's embedded media in one package undo unit. */
     replaceImage(scope: StoryScope, drawingNodeId: string, bytes: Uint8Array, mime: SupportedImageMime, decodePort: ImageDecodePort, options: ReplaceImageOptions): Promise<ImageIntentResult>;
     /** Delete a picture drawing and collect orphaned media in one package undo unit. */
     deleteImage(scope: StoryScope, drawingNodeId: string): ImageIntentResult;
+    /** Propose the deletion as a tracked change: the drawing goes into a `w:del`, media stays. */
+    deleteImageTracked(scope: StoryScope, drawingNodeId: string, revision: RevisionAttributionInput): ImageIntentResult;
     /** Fetch external bytes explicitly and embed them; no fetch on open/load. */
     embedExternalImage(scope: StoryScope, drawingNodeId: string, url: string, port: ExternalImageFetchPort, signal: AbortSignal, decodePort: ImageDecodePort): Promise<ImageIntentResult>;
     /** Metadata plus hyperlink target creation in one package transaction. */
@@ -717,6 +739,31 @@ declare class TreePackageStore {
     private publishSynthetic;
 }
 
+/** Decoded fragment payloads above this cap are refused before any package work. */
+declare const MAX_FRAGMENT_DECODED_BYTES: number;
+interface FragmentPasteInput {
+    readonly paragraphId: string;
+    readonly offset: number;
+    /** The fragment package zip (from the clipboard codec or the HTML projection). */
+    readonly fragmentBytes: Uint8Array;
+    readonly lastMarkCovered: boolean;
+    /** Ops that clear the current selection first (the surface's deleteSelectionPlan). */
+    readonly priorOps?: readonly TreeDocOp[];
+}
+type FragmentPasteResult = (Extract<PackageTransactResult, {
+    ok: true;
+}> & {
+    readonly blockCount: number;
+}) | Extract<PackageTransactResult, {
+    ok: false;
+}>;
+/**
+ * Read the fragment through the bounded file-open trust boundary, merge its resources,
+ * and land its blocks — all inside one transaction. Any refusal leaves the document
+ * exactly as it was; the caller (the paste router) degrades to the next flavour.
+ */
+declare function applyFragmentPaste(store: TreePackageStore, scope: StoryScope, input: FragmentPasteInput): FragmentPasteResult;
+
 /**
  * The payload half of an insert: which store, which node, and what it holds.
  *
@@ -905,4 +952,4 @@ type CustomNodeSweepOutcome = {
     readonly reason: string;
 };
 
-export { customNodePayloadsByControl as $, type ApplyImagePropertiesInput as A, type BookmarkIndex as B, type CustomNodeWriteResult as C, type DocumentTrackingSettings as D, type EmbeddedFont as E, type FontStyleKey as F, type NoteReferenceScanBudget as G, type HeaderFooterLifecycleImpact as H, type InsertCustomNodeWrite as I, type ReadEmbeddedFontsOptions as J, type StoryResolveResult as K, type ListKind as L, MAX_CUSTOM_NODE_LABEL_LENGTH as M, NO_TRACKING_SETTINGS as N, type TreePackageStoreOptions as O, type PackageTransactResult as P, allocateDrawingPropertyId as Q, type ReplaceImageOptions as R, type StoryScope as S, TreePackageStore as T, applyHeaderFooterLifecycleOp as U, applyNoteLifecycleOp as V, buildBookmarkIndex as W, cascadeDeletedNoteReferences as X, collectNoteReferences as Y, collectPackageNoteReferences as Z, createNoteReferenceScanBudget as _, type StoryTargetRejection as a, customNodePayloadsOf as a0, deobfuscateFont as a1, diagnoseNoteReferences as a2, ensureListDefinition as a3, ensureNumberingLevel as a4, insertCustomNodeWrite as a5, isHeaderFooterLifecycleOp as a6, isNoteLifecycleOp as a7, normalNoteIds as a8, notesPartHasId as a9, readEmbeddedFonts as aa, readTrackingSettings as ab, removeCustomNodeWrite as ac, resolveNotesPart as ad, sweepCustomNodePayloads as ae, withBinaryPart as af, withEmbeddedImage as ag, withoutUnreferencedImagePart as ah, type CustomNodeSweepOutcome as b, type InsertImageInput as c, type ImageIntentResult as d, type BookmarkAnchor as e, type CascadeDeletedNoteReferencesOptions as f, type CustomNodePayloadRead as g, type CustomNodePayloadWrite as h, type CustomNodeSweepResult as i, type CustomNodeWriteRejection as j, DEFAULT_MAX_EDITABLE_STORY_PARTS as k, type DrawingPropertyIdResult as l, type HeaderFooterLifecycleOp as m, type HeaderFooterLifecycleRejection as n, type HeaderFooterLifecycleResult as o, MAX_CUSTOM_NODE_PAYLOAD_LENGTH as p, MAX_NOTE_REFERENCE_PARTS as q, MAX_NOTE_REFERENCE_SCAN as r, type NoteDiagnostic as s, type NoteDiagnosticCode as t, type NoteLifecycleImpact as u, type NoteLifecycleOp as v, type NoteLifecycleOptions as w, type NoteLifecycleRejection as x, type NoteLifecycleResult as y, type NoteReferenceHit as z };
+export { cascadeDeletedNoteReferences as $, type ApplyImagePropertiesInput as A, type BookmarkIndex as B, type CustomNodeWriteResult as C, type DocumentTrackingSettings as D, type EmbeddedFont as E, type FragmentPasteInput as F, type NoteLifecycleRejection as G, type HeaderFooterLifecycleImpact as H, type InsertCustomNodeWrite as I, type NoteLifecycleResult as J, type NoteReferenceHit as K, type ListKind as L, MAX_CUSTOM_NODE_LABEL_LENGTH as M, NO_TRACKING_SETTINGS as N, type NoteReferenceScanBudget as O, type PackageTransactResult as P, type ReadEmbeddedFontsOptions as Q, type ReplaceImageOptions as R, type StoryScope as S, type StoryResolveResult as T, TreePackageStore as U, type TreePackageStoreOptions as V, allocateDrawingPropertyId as W, applyFragmentPaste as X, applyHeaderFooterLifecycleOp as Y, applyNoteLifecycleOp as Z, buildBookmarkIndex as _, type StoryTargetRejection as a, collectNoteReferences as a0, collectPackageNoteReferences as a1, createNoteReferenceScanBudget as a2, customNodePayloadsByControl as a3, customNodePayloadsOf as a4, deobfuscateFont as a5, diagnoseNoteReferences as a6, ensureListDefinition as a7, ensureNumberingLevel as a8, insertCustomNodeWrite as a9, isHeaderFooterLifecycleOp as aa, isNoteLifecycleOp as ab, normalNoteIds as ac, notesPartHasId as ad, readEmbeddedFonts as ae, readTrackingSettings as af, removeCustomNodeWrite as ag, resolveNotesPart as ah, sweepCustomNodePayloads as ai, withBinaryPart as aj, withEmbeddedImage as ak, withoutUnreferencedImagePart as al, type CustomNodeSweepOutcome as b, type InsertImageInput as c, type ImageIntentResult as d, type FragmentPasteResult as e, type BookmarkAnchor as f, type CascadeDeletedNoteReferencesOptions as g, type CustomNodePayloadRead as h, type CustomNodePayloadWrite as i, type CustomNodeSweepResult as j, type CustomNodeWriteRejection as k, DEFAULT_MAX_EDITABLE_STORY_PARTS as l, type DrawingPropertyIdResult as m, type FontStyleKey as n, type HeaderFooterLifecycleOp as o, type HeaderFooterLifecycleRejection as p, type HeaderFooterLifecycleResult as q, MAX_CUSTOM_NODE_PAYLOAD_LENGTH as r, MAX_FRAGMENT_DECODED_BYTES as s, MAX_NOTE_REFERENCE_PARTS as t, MAX_NOTE_REFERENCE_SCAN as u, type NoteDiagnostic as v, type NoteDiagnosticCode as w, type NoteLifecycleImpact as x, type NoteLifecycleOp as y, type NoteLifecycleOptions as z };

package/dist/{editor-PUlv5Pp7.d.ts → editor-C0my6Uta.d.ts}

@@ -1,9 +1,9 @@
 import { DocEdits, DocQueries, DocQueryResults, ContentControlSummary } from './contracts/document.js';
-import { g as ReviewRevisionKind, c as ReviewCommentItem, b as ReviewRevisionItem, d as ReviewCustomItem } from './review-items-D5SPFtsO.js';
-import { a as SemanticSelection, S as SemanticPosition } from './semantic-interaction-Cca1-X_a.js';
+import { g as ReviewRevisionKind, c as ReviewCommentItem, b as ReviewRevisionItem, d as ReviewCustomItem } from './review-items-Dw-8a6Ie.js';
+import { a as SemanticSelection, S as SemanticPosition } from './semantic-interaction-B6hFRQLy.js';
 import { ColorValue, ExecErrorCode, ParagraphFormatCommand, Watermark, DocAnchor, ExecResult, ContentControlFilter, DocRange, RunFormatting, Revision, Rect, SelectionPin, Unsubscribe } from './contracts/types.js';
-import { S as SourceCrop, b as ImageWrapTarget, c as DrawingKind, d as DrawingPositionInput, e as DrawingLocks } from './tree-op-types-XMVsJSpe.js';
-import { S as SupportedImageMime, I as ImageResourceState } from './image-resources-eZqD_-vC.js';
+import { S as SourceCrop, b as ImageWrapTarget, c as SupportedImageMime, D as DrawingKind, d as DrawingPositionInput, e as DrawingLocks, f as ImageResourceState } from './tree-op-types-BuOfCrkp.js';
+import './tree-op-revision-attribution-CN06Xshv.js';
 
 /**
  * `@docx-editor.dev/core/contracts/interaction` — semantic addressing and interaction outcomes.
@@ -1417,7 +1417,15 @@ interface EditorCommands extends EditorCommandShape<DocEdits>, EditorHeaderFoote
         borderWidthEmu?: number;
         borderColor?: ColorValue;
     };
-    /** Insert a raster image at the caret as one package undo unit. */
+    /**
+     * Insert a raster image at the caret as one package undo unit.
+     *
+     * `widthPoints`/`heightPoints` are the extent to insert AT MOST: Word's insert rule, an
+     * extent that does not fit where the caret flows (its cell, column, or page content box)
+     * is scaled down proportionally to fit. Read the committed extent back from
+     * `snapshot().image` or `getSelectedImage()`; use `setImageProperties` to enlarge past
+     * the fit afterwards.
+     */
     insertImage: {
         data: Uint8Array;
         mime: SupportedImageMime;
@@ -1484,20 +1492,33 @@ interface EditorCommands extends EditorCommandShape<DocEdits>, EditorHeaderFoote
      */
     cut: Record<never, never>;
     /**
-     * Insert `text` at the selection, replacing it, with newlines becoming real paragraph
-     * boundaries.
+     * Insert the clipboard payload at the selection, replacing it.
      *
-     * TEXT COMES IN. `exec` is synchronous and reading the clipboard is not — it prompts in
-     * Chrome and is refused outright by Firefox and Safari — so an engine-owned read would
-     * have to either turn every command's result into a promise or lie about this one's. The
-     * caller reads the clipboard inside the click or keystroke that asked for the paste,
-     * which is where the permission gesture belongs, and hands the engine a string.
+     * PAYLOAD COMES IN. `exec` is synchronous and reading the clipboard is not — it prompts
+     * in Chrome and is refused outright by Firefox and Safari — so an engine-owned read
+     * would have to either turn every command's result into a promise or lie about this
+     * one's. The caller reads the clipboard inside the click or keystroke that asked for
+     * the paste, which is where the permission gesture belongs, and hands the engine what
+     * it read.
      *
-     * Plain text only. There is no rich lane and no `pastePlain` twin, because a second
-     * command would be a second name for exactly this behavior.
+     * `html`, when present, routes through the same fidelity order as the paste event:
+     * an embedded fragment first, then the bounded external-HTML projection, then `text` —
+     * degrading on any refusal. Without `html`, the plain lane inserts `text` with
+     * newlines becoming real paragraph boundaries, as this command always has.
      */
     paste: {
         text: string;
+        html?: string;
+    };
+    /**
+     * Insert `text` as if typed, whatever richer flavours the clipboard held.
+     *
+     * The plain twin `paste` deliberately lacked while there was no rich lane; with one,
+     * "paste" and "paste without formatting" are two different user intentions
+     * (Cmd+V / Cmd+Shift+V) and each needs a name a menu row can call.
+     */
+    pasteWithoutFormatting: {
+        text: string;
     };
 }
 /**

package/dist/{editor-CojjwMmF.d.cts → editor-CwzY2Hcg.d.cts}

@@ -1,9 +1,9 @@
 import { DocEdits, DocQueries, DocQueryResults, ContentControlSummary } from './contracts/document.cjs';
-import { g as ReviewRevisionKind, c as ReviewCommentItem, b as ReviewRevisionItem, d as ReviewCustomItem } from './review-items-DpsqTHio.cjs';
-import { a as SemanticSelection, S as SemanticPosition } from './semantic-interaction-BjOcDB06.cjs';
+import { g as ReviewRevisionKind, c as ReviewCommentItem, b as ReviewRevisionItem, d as ReviewCustomItem } from './review-items-CwixiHNe.cjs';
+import { a as SemanticSelection, S as SemanticPosition } from './semantic-interaction-Z0xKQcB4.cjs';
 import { ColorValue, ExecErrorCode, ParagraphFormatCommand, Watermark, DocAnchor, ExecResult, ContentControlFilter, DocRange, RunFormatting, Revision, Rect, SelectionPin, Unsubscribe } from './contracts/types.cjs';
-import { S as SourceCrop, b as ImageWrapTarget, c as DrawingKind, d as DrawingPositionInput, e as DrawingLocks } from './tree-op-types-B0-sCtw-.cjs';
-import { S as SupportedImageMime, I as ImageResourceState } from './image-resources-DQOiwOuE.cjs';
+import { S as SourceCrop, b as ImageWrapTarget, c as SupportedImageMime, D as DrawingKind, d as DrawingPositionInput, e as DrawingLocks, f as ImageResourceState } from './tree-op-types-DSJYmf5b.cjs';
+import './tree-op-revision-attribution-CN06Xshv.cjs';
 
 /**
  * `@docx-editor.dev/core/contracts/interaction` — semantic addressing and interaction outcomes.
@@ -1417,7 +1417,15 @@ interface EditorCommands extends EditorCommandShape<DocEdits>, EditorHeaderFoote
         borderWidthEmu?: number;
         borderColor?: ColorValue;
     };
-    /** Insert a raster image at the caret as one package undo unit. */
+    /**
+     * Insert a raster image at the caret as one package undo unit.
+     *
+     * `widthPoints`/`heightPoints` are the extent to insert AT MOST: Word's insert rule, an
+     * extent that does not fit where the caret flows (its cell, column, or page content box)
+     * is scaled down proportionally to fit. Read the committed extent back from
+     * `snapshot().image` or `getSelectedImage()`; use `setImageProperties` to enlarge past
+     * the fit afterwards.
+     */
     insertImage: {
         data: Uint8Array;
         mime: SupportedImageMime;
@@ -1484,20 +1492,33 @@ interface EditorCommands extends EditorCommandShape<DocEdits>, EditorHeaderFoote
      */
     cut: Record<never, never>;
     /**
-     * Insert `text` at the selection, replacing it, with newlines becoming real paragraph
-     * boundaries.
+     * Insert the clipboard payload at the selection, replacing it.
      *
-     * TEXT COMES IN. `exec` is synchronous and reading the clipboard is not — it prompts in
-     * Chrome and is refused outright by Firefox and Safari — so an engine-owned read would
-     * have to either turn every command's result into a promise or lie about this one's. The
-     * caller reads the clipboard inside the click or keystroke that asked for the paste,
-     * which is where the permission gesture belongs, and hands the engine a string.
+     * PAYLOAD COMES IN. `exec` is synchronous and reading the clipboard is not — it prompts
+     * in Chrome and is refused outright by Firefox and Safari — so an engine-owned read
+     * would have to either turn every command's result into a promise or lie about this
+     * one's. The caller reads the clipboard inside the click or keystroke that asked for
+     * the paste, which is where the permission gesture belongs, and hands the engine what
+     * it read.
      *
-     * Plain text only. There is no rich lane and no `pastePlain` twin, because a second
-     * command would be a second name for exactly this behavior.
+     * `html`, when present, routes through the same fidelity order as the paste event:
+     * an embedded fragment first, then the bounded external-HTML projection, then `text` —
+     * degrading on any refusal. Without `html`, the plain lane inserts `text` with
+     * newlines becoming real paragraph boundaries, as this command always has.
      */
     paste: {
         text: string;
+        html?: string;
+    };
+    /**
+     * Insert `text` as if typed, whatever richer flavours the clipboard held.
+     *
+     * The plain twin `paste` deliberately lacked while there was no rich lane; with one,
+     * "paste" and "paste without formatting" are two different user intentions
+     * (Cmd+V / Cmd+Shift+V) and each needs a name a menu row can call.
+     */
+    pasteWithoutFormatting: {
+        text: string;
     };
 }
 /**