@docx-editor.dev/core 2.11.0 → 2.13.0

package/dist/{tree-op-types-BPyXNxyL.d.cts → tree-op-types-BUulYD5y.d.cts}

@@ -1281,11 +1281,15 @@ interface DrawingDiagnostic {
     readonly detail: string | null;
 }
 
+type ShapeSchemeColorResolver = (scheme: string) => string | null;
+type ShapeStyleMatrixResolver = (kind: 'fill' | 'line', index: number) => OoxmlElement | null;
 /**
- * The renderable subset of a `wps:wsp` non-picture graphic: closed polygon subpaths
- * (`a:custGeom` with move/line/close verbs only, or `a:prstGeom prst="rect"`) with a
- * solid sRGB fill and/or stroke. Anything richer (curves, theme fills, text bodies,
- * rotation) projects as `null` and paints the labelled placeholder instead.
+ * The renderable subset of a `wps:wsp` non-picture graphic, or of one bounded `wpg:wgp`
+ * group of them: closed polygon subpaths (`a:custGeom` with move/line/close/cubicBezTo
+ * verbs, or a supported `a:prstGeom`) with a solid fill and/or stroke. The colour may come
+ * from `a:srgbClr` or from the theme, through `a:schemeClr` or a `wps:style` matrix
+ * reference. Anything richer (gradient and picture fills, text bodies, rotation, a nested
+ * group) projects as `null` and paints the labelled placeholder instead.
  */
 interface VectorShapeProjection {
     /** The drawing extent that frames the subpath coordinate space. */
@@ -1293,16 +1297,39 @@ interface VectorShapeProjection {
         cx: number;
         cy: number;
     }>;
-    /** Closed subpath polygons in extent-EMU space; fill rule is even-odd. */
+    /**
+     * Every component's subpath polygons, flattened, in extent-EMU space; fill rule is
+     * even-odd. Painting reads `components`, which keeps each polygon with its own colours;
+     * this stays the geometry summary (bounds, hit tests, wrap holes).
+     */
     readonly subpathsEmu: readonly (readonly Readonly<{
         x: number;
         y: number;
     }>[])[];
-    /** Validated 6-digit sRGB hex (no `#`), or null for no fill. */
+    /**
+     * Validated 6-digit sRGB hex (no `#`) of the one component, or null. A group of two or
+     * more components has no single fill, so this is null there as well: null means "no one
+     * fill to name", not "nothing is filled". Read `components` to paint.
+     */
     readonly fillHex: string | null;
-    /** Validated 6-digit sRGB hex (no `#`), or null for no stroke. */
+    readonly fillAlpha?: number;
+    /** As `fillHex`, for the stroke: the one component's stroke, else null. */
     readonly strokeHex: string | null;
-    /** Stroke width in EMU; 0 when absent. */
+    readonly strokeAlpha?: number;
+    /** The one component's stroke width in EMU; 0 when absent or when grouped. */
+    readonly strokeWidthEmu: number;
+    /** Independently styled paths, always non-empty. A direct shape has one component. */
+    readonly components: readonly VectorShapeComponent[];
+}
+interface VectorShapeComponent {
+    readonly subpathsEmu: readonly (readonly Readonly<{
+        x: number;
+        y: number;
+    }>[])[];
+    readonly fillHex: string | null;
+    readonly fillAlpha: number;
+    readonly strokeHex: string | null;
+    readonly strokeAlpha: number;
     readonly strokeWidthEmu: number;
 }
 /**
@@ -1512,6 +1539,8 @@ declare function projectDrawing(drawing: OoxmlDrawingNode, context: Readonly<{
     limits: DrawingProjectionLimits;
     namespaceScope?: ReadonlyMap<string, string>;
     resolveRelationship?: RelationshipTargetResolver;
+    resolveSchemeColor?: ShapeSchemeColorResolver;
+    resolveStyleMatrixReference?: ShapeStyleMatrixResolver;
 }>): DrawingProjection | null;
 
 /** Opaque handle — bytes are reachable only through {@link mintValidatedImageBytes}. */
@@ -1615,6 +1644,10 @@ declare const MAX_SVG_SNIFF_BYTES = 512;
 interface ValidatedRasterHeader {
     readonly pixelWidth: number;
     readonly pixelHeight: number;
+    /** Horizontal physical density when bounded header metadata supplies it. */
+    readonly dpiX?: number;
+    /** Vertical physical density when bounded header metadata supplies it. */
+    readonly dpiY?: number;
 }
 /** Bounded scan for an `<svg` document root (optional `<?xml` prolog only). */
 declare function hasBoundedSvgRoot(bytes: Uint8Array): boolean;
@@ -2898,6 +2931,19 @@ type TreeDocOp = {
         readonly paragraphId: string;
         readonly pageNumberText: string;
     }[];
+} | {
+    /**
+     * Rewrite recognized fields' cached RESULT runs in place — between the `separate` and
+     * `end` fldChars, or a `w:fldSimple`'s content. The instruction is never modified; a
+     * result holding anything but plain runs is skipped (see `tree-op-field-results.ts`).
+     */
+    readonly op: 'refreshFieldResults';
+    readonly updates: readonly {
+        readonly paragraphId: string;
+        /** Node id of the field's begin `w:fldChar`, or of the `w:fldSimple` element. */
+        readonly fieldNodeId: string;
+        readonly text: string;
+    }[];
 };
 /** Drawing mutation ops from typed-drawings-and-images task 11. */
 type DrawingTreeDocOp = Extract<TreeDocOp, {
@@ -2906,7 +2952,7 @@ type DrawingTreeDocOp = Extract<TreeDocOp, {
 /** Just the `op` discriminants, for dispatch tables and validation. */
 type TreeDocOpKind = TreeDocOp['op'];
 /** Every {@link TreeDocOpKind}, for validation and exhaustiveness checks. */
-declare const TREE_DOC_OP_KINDS: readonly ["replaceStoryBlocks", "insertText", "deleteText", "setParagraphMarkRevision", "proposeParagraphMerge", "insertCommentMarker", "acceptRevision", "rejectRevision", "acceptAllRevisions", "rejectAllRevisions", "insertTab", "insertHardBreak", "insertPageBreak", "insertPageField", "setListLevel", "setListNumbering", "setParagraphTabStops", "setParagraphMarkProperties", "splitParagraph", "splitParagraphMany", "joinParagraphs", "setRunProperties", "setParagraphProperties", "setSectionProperties", "setSectionMark", "insertHyperlink", "setHyperlinkTarget", "removeHyperlink", "setMathEquation", "removeMathEquation", "setContentControlValue", "removeContentControl", "insertInlineContentControl", "addRepeatingSectionItem", "removeRepeatingSectionItem", "deleteBlock", "insertTable", "insertTableRow", "deleteTableRow", "insertTableColumn", "deleteTableColumn", "setTableColumnWidths", "setTableRightEdgeWidth", "setTableRowHeight", "setTableCellBorders", "setTableCellFill", "setTableCellVerticalAlignment", "createHeaderFooter", "deleteHeaderFooter", "linkToPrevious", "unlinkFromPrevious", "setSectionFurnitureOptions", "insertNote", "deleteNote", "convertNote", "convertAllNotes", "setNoteProperties", "setContentControlProperties", "insertContentControl", "insertFragment", "insertDrawing", "replaceDrawingResource", "deleteDrawing", "resizeDrawing", "cropDrawing", "positionDrawing", "setDrawingWrap", "setDrawingMetadata", "setDrawingLocks", "transformDrawing", "insertToc", "replaceTocResult", "rewriteTocPageNumbers"];
+declare const TREE_DOC_OP_KINDS: readonly ["replaceStoryBlocks", "insertText", "deleteText", "setParagraphMarkRevision", "proposeParagraphMerge", "insertCommentMarker", "acceptRevision", "rejectRevision", "acceptAllRevisions", "rejectAllRevisions", "insertTab", "insertHardBreak", "insertPageBreak", "insertPageField", "setListLevel", "setListNumbering", "setParagraphTabStops", "setParagraphMarkProperties", "splitParagraph", "splitParagraphMany", "joinParagraphs", "setRunProperties", "setParagraphProperties", "setSectionProperties", "setSectionMark", "insertHyperlink", "setHyperlinkTarget", "removeHyperlink", "setMathEquation", "removeMathEquation", "setContentControlValue", "removeContentControl", "insertInlineContentControl", "addRepeatingSectionItem", "removeRepeatingSectionItem", "deleteBlock", "insertTable", "insertTableRow", "deleteTableRow", "insertTableColumn", "deleteTableColumn", "setTableColumnWidths", "setTableRightEdgeWidth", "setTableRowHeight", "setTableCellBorders", "setTableCellFill", "setTableCellVerticalAlignment", "createHeaderFooter", "deleteHeaderFooter", "linkToPrevious", "unlinkFromPrevious", "setSectionFurnitureOptions", "insertNote", "deleteNote", "convertNote", "convertAllNotes", "setNoteProperties", "setContentControlProperties", "insertContentControl", "insertFragment", "insertDrawing", "replaceDrawingResource", "deleteDrawing", "resizeDrawing", "cropDrawing", "positionDrawing", "setDrawingWrap", "setDrawingMetadata", "setDrawingLocks", "transformDrawing", "insertToc", "replaceTocResult", "rewriteTocPageNumbers", "refreshFieldResults"];
 /**
  * How far a committed op can reach, so layout can scope its work (task 5.2).
  *

package/dist/{tree-op-types-DnzAOnc9.d.ts → tree-op-types-D6HzlPR4.d.ts}

@@ -1281,11 +1281,15 @@ interface DrawingDiagnostic {
     readonly detail: string | null;
 }
 
+type ShapeSchemeColorResolver = (scheme: string) => string | null;
+type ShapeStyleMatrixResolver = (kind: 'fill' | 'line', index: number) => OoxmlElement | null;
 /**
- * The renderable subset of a `wps:wsp` non-picture graphic: closed polygon subpaths
- * (`a:custGeom` with move/line/close verbs only, or `a:prstGeom prst="rect"`) with a
- * solid sRGB fill and/or stroke. Anything richer (curves, theme fills, text bodies,
- * rotation) projects as `null` and paints the labelled placeholder instead.
+ * The renderable subset of a `wps:wsp` non-picture graphic, or of one bounded `wpg:wgp`
+ * group of them: closed polygon subpaths (`a:custGeom` with move/line/close/cubicBezTo
+ * verbs, or a supported `a:prstGeom`) with a solid fill and/or stroke. The colour may come
+ * from `a:srgbClr` or from the theme, through `a:schemeClr` or a `wps:style` matrix
+ * reference. Anything richer (gradient and picture fills, text bodies, rotation, a nested
+ * group) projects as `null` and paints the labelled placeholder instead.
  */
 interface VectorShapeProjection {
     /** The drawing extent that frames the subpath coordinate space. */
@@ -1293,16 +1297,39 @@ interface VectorShapeProjection {
         cx: number;
         cy: number;
     }>;
-    /** Closed subpath polygons in extent-EMU space; fill rule is even-odd. */
+    /**
+     * Every component's subpath polygons, flattened, in extent-EMU space; fill rule is
+     * even-odd. Painting reads `components`, which keeps each polygon with its own colours;
+     * this stays the geometry summary (bounds, hit tests, wrap holes).
+     */
     readonly subpathsEmu: readonly (readonly Readonly<{
         x: number;
         y: number;
     }>[])[];
-    /** Validated 6-digit sRGB hex (no `#`), or null for no fill. */
+    /**
+     * Validated 6-digit sRGB hex (no `#`) of the one component, or null. A group of two or
+     * more components has no single fill, so this is null there as well: null means "no one
+     * fill to name", not "nothing is filled". Read `components` to paint.
+     */
     readonly fillHex: string | null;
-    /** Validated 6-digit sRGB hex (no `#`), or null for no stroke. */
+    readonly fillAlpha?: number;
+    /** As `fillHex`, for the stroke: the one component's stroke, else null. */
     readonly strokeHex: string | null;
-    /** Stroke width in EMU; 0 when absent. */
+    readonly strokeAlpha?: number;
+    /** The one component's stroke width in EMU; 0 when absent or when grouped. */
+    readonly strokeWidthEmu: number;
+    /** Independently styled paths, always non-empty. A direct shape has one component. */
+    readonly components: readonly VectorShapeComponent[];
+}
+interface VectorShapeComponent {
+    readonly subpathsEmu: readonly (readonly Readonly<{
+        x: number;
+        y: number;
+    }>[])[];
+    readonly fillHex: string | null;
+    readonly fillAlpha: number;
+    readonly strokeHex: string | null;
+    readonly strokeAlpha: number;
     readonly strokeWidthEmu: number;
 }
 /**
@@ -1512,6 +1539,8 @@ declare function projectDrawing(drawing: OoxmlDrawingNode, context: Readonly<{
     limits: DrawingProjectionLimits;
     namespaceScope?: ReadonlyMap<string, string>;
     resolveRelationship?: RelationshipTargetResolver;
+    resolveSchemeColor?: ShapeSchemeColorResolver;
+    resolveStyleMatrixReference?: ShapeStyleMatrixResolver;
 }>): DrawingProjection | null;
 
 /** Opaque handle — bytes are reachable only through {@link mintValidatedImageBytes}. */
@@ -1615,6 +1644,10 @@ declare const MAX_SVG_SNIFF_BYTES = 512;
 interface ValidatedRasterHeader {
     readonly pixelWidth: number;
     readonly pixelHeight: number;
+    /** Horizontal physical density when bounded header metadata supplies it. */
+    readonly dpiX?: number;
+    /** Vertical physical density when bounded header metadata supplies it. */
+    readonly dpiY?: number;
 }
 /** Bounded scan for an `<svg` document root (optional `<?xml` prolog only). */
 declare function hasBoundedSvgRoot(bytes: Uint8Array): boolean;
@@ -2898,6 +2931,19 @@ type TreeDocOp = {
         readonly paragraphId: string;
         readonly pageNumberText: string;
     }[];
+} | {
+    /**
+     * Rewrite recognized fields' cached RESULT runs in place — between the `separate` and
+     * `end` fldChars, or a `w:fldSimple`'s content. The instruction is never modified; a
+     * result holding anything but plain runs is skipped (see `tree-op-field-results.ts`).
+     */
+    readonly op: 'refreshFieldResults';
+    readonly updates: readonly {
+        readonly paragraphId: string;
+        /** Node id of the field's begin `w:fldChar`, or of the `w:fldSimple` element. */
+        readonly fieldNodeId: string;
+        readonly text: string;
+    }[];
 };
 /** Drawing mutation ops from typed-drawings-and-images task 11. */
 type DrawingTreeDocOp = Extract<TreeDocOp, {
@@ -2906,7 +2952,7 @@ type DrawingTreeDocOp = Extract<TreeDocOp, {
 /** Just the `op` discriminants, for dispatch tables and validation. */
 type TreeDocOpKind = TreeDocOp['op'];
 /** Every {@link TreeDocOpKind}, for validation and exhaustiveness checks. */
-declare const TREE_DOC_OP_KINDS: readonly ["replaceStoryBlocks", "insertText", "deleteText", "setParagraphMarkRevision", "proposeParagraphMerge", "insertCommentMarker", "acceptRevision", "rejectRevision", "acceptAllRevisions", "rejectAllRevisions", "insertTab", "insertHardBreak", "insertPageBreak", "insertPageField", "setListLevel", "setListNumbering", "setParagraphTabStops", "setParagraphMarkProperties", "splitParagraph", "splitParagraphMany", "joinParagraphs", "setRunProperties", "setParagraphProperties", "setSectionProperties", "setSectionMark", "insertHyperlink", "setHyperlinkTarget", "removeHyperlink", "setMathEquation", "removeMathEquation", "setContentControlValue", "removeContentControl", "insertInlineContentControl", "addRepeatingSectionItem", "removeRepeatingSectionItem", "deleteBlock", "insertTable", "insertTableRow", "deleteTableRow", "insertTableColumn", "deleteTableColumn", "setTableColumnWidths", "setTableRightEdgeWidth", "setTableRowHeight", "setTableCellBorders", "setTableCellFill", "setTableCellVerticalAlignment", "createHeaderFooter", "deleteHeaderFooter", "linkToPrevious", "unlinkFromPrevious", "setSectionFurnitureOptions", "insertNote", "deleteNote", "convertNote", "convertAllNotes", "setNoteProperties", "setContentControlProperties", "insertContentControl", "insertFragment", "insertDrawing", "replaceDrawingResource", "deleteDrawing", "resizeDrawing", "cropDrawing", "positionDrawing", "setDrawingWrap", "setDrawingMetadata", "setDrawingLocks", "transformDrawing", "insertToc", "replaceTocResult", "rewriteTocPageNumbers"];
+declare const TREE_DOC_OP_KINDS: readonly ["replaceStoryBlocks", "insertText", "deleteText", "setParagraphMarkRevision", "proposeParagraphMerge", "insertCommentMarker", "acceptRevision", "rejectRevision", "acceptAllRevisions", "rejectAllRevisions", "insertTab", "insertHardBreak", "insertPageBreak", "insertPageField", "setListLevel", "setListNumbering", "setParagraphTabStops", "setParagraphMarkProperties", "splitParagraph", "splitParagraphMany", "joinParagraphs", "setRunProperties", "setParagraphProperties", "setSectionProperties", "setSectionMark", "insertHyperlink", "setHyperlinkTarget", "removeHyperlink", "setMathEquation", "removeMathEquation", "setContentControlValue", "removeContentControl", "insertInlineContentControl", "addRepeatingSectionItem", "removeRepeatingSectionItem", "deleteBlock", "insertTable", "insertTableRow", "deleteTableRow", "insertTableColumn", "deleteTableColumn", "setTableColumnWidths", "setTableRightEdgeWidth", "setTableRowHeight", "setTableCellBorders", "setTableCellFill", "setTableCellVerticalAlignment", "createHeaderFooter", "deleteHeaderFooter", "linkToPrevious", "unlinkFromPrevious", "setSectionFurnitureOptions", "insertNote", "deleteNote", "convertNote", "convertAllNotes", "setNoteProperties", "setContentControlProperties", "insertContentControl", "insertFragment", "insertDrawing", "replaceDrawingResource", "deleteDrawing", "resizeDrawing", "cropDrawing", "positionDrawing", "setDrawingWrap", "setDrawingMetadata", "setDrawingLocks", "transformDrawing", "insertToc", "replaceTocResult", "rewriteTocPageNumbers", "refreshFieldResults"];
 /**
  * How far a committed op can reach, so layout can scope its work (task 5.2).
  *

package/dist/{tree-package-fragment-CDER0G3B.d.ts → tree-package-fragment-B1supBtE.d.ts}

@@ -1,5 +1,5 @@
-import { b as OoxmlPackage, y as SupportedImageMime, O as OoxmlPart, a as OoxmlNode, g as OoxmlElement, E as RevisionAttributionInput, C as ImageDecodePort, F as DrawingTreeDocOp, r as TreeOpRejection, T as TreeDocOp } from './tree-op-types-DnzAOnc9.js';
-import { N as NoteKind, T as TreeModelChange, a as TreeDocumentStore, c as TreeStoryRef, d as TransactionContext, b as TransactOptions, S as SelectionMark, e as TreeDocumentCheckpoint } from './tree-store-CNZ3O83s.js';
+import { b as OoxmlPackage, y as SupportedImageMime, O as OoxmlPart, a as OoxmlNode, g as OoxmlElement, E as RevisionAttributionInput, C as ImageDecodePort, F as DrawingTreeDocOp, r as TreeOpRejection, T as TreeDocOp } from './tree-op-types-D6HzlPR4.js';
+import { N as NoteKind, T as TreeModelChange, a as TreeDocumentStore, c as TreeStoryRef, d as TransactionContext, b as TransactOptions, S as SelectionMark, e as TreeDocumentCheckpoint } from './tree-store-APgWx6qn.js';
 
 /** A freshly allocated drawing property id, or the reason one could not be minted. */
 type DrawingPropertyIdResult = {

package/dist/{tree-package-fragment-BjZ3RWAS.d.cts → tree-package-fragment-ByN5yzll.d.cts}

@@ -1,5 +1,5 @@
-import { b as OoxmlPackage, y as SupportedImageMime, O as OoxmlPart, a as OoxmlNode, g as OoxmlElement, E as RevisionAttributionInput, C as ImageDecodePort, F as DrawingTreeDocOp, r as TreeOpRejection, T as TreeDocOp } from './tree-op-types-BPyXNxyL.cjs';
-import { N as NoteKind, T as TreeModelChange, a as TreeDocumentStore, c as TreeStoryRef, d as TransactionContext, b as TransactOptions, S as SelectionMark, e as TreeDocumentCheckpoint } from './tree-store-DfZi7FqY.cjs';
+import { b as OoxmlPackage, y as SupportedImageMime, O as OoxmlPart, a as OoxmlNode, g as OoxmlElement, E as RevisionAttributionInput, C as ImageDecodePort, F as DrawingTreeDocOp, r as TreeOpRejection, T as TreeDocOp } from './tree-op-types-BUulYD5y.cjs';
+import { N as NoteKind, T as TreeModelChange, a as TreeDocumentStore, c as TreeStoryRef, d as TransactionContext, b as TransactOptions, S as SelectionMark, e as TreeDocumentCheckpoint } from './tree-store-DEEQ9wz_.cjs';
 
 /** A freshly allocated drawing property id, or the reason one could not be minted. */
 type DrawingPropertyIdResult = {

package/dist/{tree-session-contract-DhdsFT_z.d.ts → tree-session-contract-BasiwZgZ.d.ts}

@@ -1,9 +1,9 @@
-import { S as StoryScope, a as StoryTargetRejection, b as HeaderFooterParts, c as HeaderFooterSectionResolution, I as InsertImageInput, d as ImageIntentResult, R as ReplaceImageOptions, A as ApplyImagePropertiesInput, F as FragmentPasteInput, e as FragmentPasteResult } from './tree-package-fragment-CDER0G3B.js';
-import { T as TreeDocOp, O as OoxmlPart, a as OoxmlNode, b as OoxmlPackage, g as OoxmlElement, y as SupportedImageMime, C as ImageDecodePort, E as RevisionAttributionInput } from './tree-op-types-DnzAOnc9.js';
-import { D as DocumentTrackingSettings, I as InsertCustomNodeWrite, C as CustomNodeWriteResult, a as CustomNodeSweepOutcome, E as EmbeddedFont, B as BookmarkIndex, L as ListKind } from './custom-node-writes-JfTn-Sy6.js';
+import { S as StoryScope, a as StoryTargetRejection, b as HeaderFooterParts, c as HeaderFooterSectionResolution, I as InsertImageInput, d as ImageIntentResult, R as ReplaceImageOptions, A as ApplyImagePropertiesInput, F as FragmentPasteInput, e as FragmentPasteResult } from './tree-package-fragment-B1supBtE.js';
+import { T as TreeDocOp, O as OoxmlPart, a as OoxmlNode, b as OoxmlPackage, g as OoxmlElement, y as SupportedImageMime, C as ImageDecodePort, E as RevisionAttributionInput } from './tree-op-types-D6HzlPR4.js';
+import { D as DocumentTrackingSettings, I as InsertCustomNodeWrite, C as CustomNodeWriteResult, a as CustomNodeSweepOutcome, E as EmbeddedFont, B as BookmarkIndex, L as ListKind } from './custom-node-writes-DntmaAVW.js';
 import { D as DocumentProperties } from './document-properties-D6Ahr8D6.js';
-import { S as SelectionMark, b as TransactOptions, T as TreeModelChange } from './tree-store-CNZ3O83s.js';
-import { a as ReviewItem } from './review-items-CkYyXhXM.js';
+import { S as SelectionMark, b as TransactOptions, T as TreeModelChange } from './tree-store-APgWx6qn.js';
+import { a as ReviewItem } from './review-items-CCS1h93f.js';
 import { Node } from 'prosemirror-model';
 import { CollaborationDocumentPort } from './collaboration/replication.js';
 
@@ -264,6 +264,18 @@ interface TreeDocxSessionView {
      * and one undo unit without swapping the body store.
      */
     applyTreeOps(ops: readonly TreeDocOp[], selectionBefore?: SelectionMark | null, selectionAfter?: SelectionMark | null, scope?: StoryScope, options?: TreeApplyOptions): TreeApplyResult;
+    /**
+     * Commit several stories' ops as ONE transaction and ONE undo unit.
+     *
+     * `applyTreeOps` addresses one story; a write that must land in the body AND note parts
+     * together — the save-time field-result refresh — needs all-or-nothing semantics, or a
+     * mid-sequence refusal exports a file mixing refreshed and stale values and a single undo
+     * restores only the last part. Any refusal rolls every group back. Lifecycle ops refuse.
+     */
+    applyTreeOpsAtomic(groups: readonly {
+        readonly scope: StoryScope;
+        readonly ops: readonly TreeDocOp[];
+    }[], options?: TreeApplyOptions): TreeApplyResult;
     /**
      * Every part that holds a story, body first, then headers, footers and note parts.
      *
@@ -328,6 +340,17 @@ interface TreeDocxSessionView {
      * Memoized per package revision.
      */
     documentFonts(): readonly string[];
+    /**
+     * Font families the document's RENDERED text resolves to, over the story roots only:
+     * direct run `w:rFonts` of text-bearing runs plus the style chains those runs,
+     * paragraphs and tables actually reference — never a declaration in an unused style.
+     * Memoized per package revision.
+     *
+     * The font-substitution notice reads this one: `documentFonts` reports what the
+     * document DECLARES, and Word writes latent styles (Balloon Text naming Segoe UI)
+     * into documents that never render a character in them.
+     */
+    renderedFontFamilies(): readonly string[];
     /**
      * Whether the document puts any literal character on a page, over the same roots
      * {@link TreeDocxSessionView.documentFonts} reads. Memoized per package revision.

package/dist/{tree-session-contract-BF2FVBOM.d.cts → tree-session-contract-DbeBenMR.d.cts}

@@ -1,9 +1,9 @@
-import { S as StoryScope, a as StoryTargetRejection, b as HeaderFooterParts, c as HeaderFooterSectionResolution, I as InsertImageInput, d as ImageIntentResult, R as ReplaceImageOptions, A as ApplyImagePropertiesInput, F as FragmentPasteInput, e as FragmentPasteResult } from './tree-package-fragment-BjZ3RWAS.cjs';
-import { T as TreeDocOp, O as OoxmlPart, a as OoxmlNode, b as OoxmlPackage, g as OoxmlElement, y as SupportedImageMime, C as ImageDecodePort, E as RevisionAttributionInput } from './tree-op-types-BPyXNxyL.cjs';
-import { D as DocumentTrackingSettings, I as InsertCustomNodeWrite, C as CustomNodeWriteResult, a as CustomNodeSweepOutcome, E as EmbeddedFont, B as BookmarkIndex, L as ListKind } from './custom-node-writes-CwkYRw3V.cjs';
+import { S as StoryScope, a as StoryTargetRejection, b as HeaderFooterParts, c as HeaderFooterSectionResolution, I as InsertImageInput, d as ImageIntentResult, R as ReplaceImageOptions, A as ApplyImagePropertiesInput, F as FragmentPasteInput, e as FragmentPasteResult } from './tree-package-fragment-ByN5yzll.cjs';
+import { T as TreeDocOp, O as OoxmlPart, a as OoxmlNode, b as OoxmlPackage, g as OoxmlElement, y as SupportedImageMime, C as ImageDecodePort, E as RevisionAttributionInput } from './tree-op-types-BUulYD5y.cjs';
+import { D as DocumentTrackingSettings, I as InsertCustomNodeWrite, C as CustomNodeWriteResult, a as CustomNodeSweepOutcome, E as EmbeddedFont, B as BookmarkIndex, L as ListKind } from './custom-node-writes-C46r3_5O.cjs';
 import { D as DocumentProperties } from './document-properties-D6Ahr8D6.cjs';
-import { S as SelectionMark, b as TransactOptions, T as TreeModelChange } from './tree-store-DfZi7FqY.cjs';
-import { a as ReviewItem } from './review-items-BdeLNRi2.cjs';
+import { S as SelectionMark, b as TransactOptions, T as TreeModelChange } from './tree-store-DEEQ9wz_.cjs';
+import { a as ReviewItem } from './review-items-CaAkgi5s.cjs';
 import { Node } from 'prosemirror-model';
 import { CollaborationDocumentPort } from './collaboration/replication.cjs';
 
@@ -264,6 +264,18 @@ interface TreeDocxSessionView {
      * and one undo unit without swapping the body store.
      */
     applyTreeOps(ops: readonly TreeDocOp[], selectionBefore?: SelectionMark | null, selectionAfter?: SelectionMark | null, scope?: StoryScope, options?: TreeApplyOptions): TreeApplyResult;
+    /**
+     * Commit several stories' ops as ONE transaction and ONE undo unit.
+     *
+     * `applyTreeOps` addresses one story; a write that must land in the body AND note parts
+     * together — the save-time field-result refresh — needs all-or-nothing semantics, or a
+     * mid-sequence refusal exports a file mixing refreshed and stale values and a single undo
+     * restores only the last part. Any refusal rolls every group back. Lifecycle ops refuse.
+     */
+    applyTreeOpsAtomic(groups: readonly {
+        readonly scope: StoryScope;
+        readonly ops: readonly TreeDocOp[];
+    }[], options?: TreeApplyOptions): TreeApplyResult;
     /**
      * Every part that holds a story, body first, then headers, footers and note parts.
      *
@@ -328,6 +340,17 @@ interface TreeDocxSessionView {
      * Memoized per package revision.
      */
     documentFonts(): readonly string[];
+    /**
+     * Font families the document's RENDERED text resolves to, over the story roots only:
+     * direct run `w:rFonts` of text-bearing runs plus the style chains those runs,
+     * paragraphs and tables actually reference — never a declaration in an unused style.
+     * Memoized per package revision.
+     *
+     * The font-substitution notice reads this one: `documentFonts` reports what the
+     * document DECLARES, and Word writes latent styles (Balloon Text naming Segoe UI)
+     * into documents that never render a character in them.
+     */
+    renderedFontFamilies(): readonly string[];
     /**
      * Whether the document puts any literal character on a page, over the same roots
      * {@link TreeDocxSessionView.documentFonts} reads. Memoized per package revision.

package/dist/{tree-store-CNZ3O83s.d.ts → tree-store-APgWx6qn.d.ts}

@@ -1,4 +1,4 @@
-import { a as OoxmlNode, j as OoxmlParagraphNode, k as OoxmlNoteNode, l as OoxmlContinuationSeparatorNode, m as OoxmlEndnotesNode, n as OoxmlFootnotesNode, o as OoxmlNoteRefNode, p as OoxmlNoteReferenceNode, q as OoxmlSeparatorNode, I as ImpactClass, O as OoxmlPart, b as OoxmlPackage, T as TreeDocOp, r as TreeOpRejection } from './tree-op-types-DnzAOnc9.js';
+import { a as OoxmlNode, j as OoxmlParagraphNode, k as OoxmlNoteNode, l as OoxmlContinuationSeparatorNode, m as OoxmlEndnotesNode, n as OoxmlFootnotesNode, o as OoxmlNoteRefNode, p as OoxmlNoteReferenceNode, q as OoxmlSeparatorNode, I as ImpactClass, O as OoxmlPart, b as OoxmlPackage, T as TreeDocOp, r as TreeOpRejection } from './tree-op-types-D6HzlPR4.js';
 
 /** UTF-16 placeholder for one atomic note unit in `paragraphTextOf` / segments. */
 declare const NOTE_ATOM_CHAR = "\uFFFC";

package/dist/{tree-store-DfZi7FqY.d.cts → tree-store-DEEQ9wz_.d.cts}

@@ -1,4 +1,4 @@
-import { a as OoxmlNode, j as OoxmlParagraphNode, k as OoxmlNoteNode, l as OoxmlContinuationSeparatorNode, m as OoxmlEndnotesNode, n as OoxmlFootnotesNode, o as OoxmlNoteRefNode, p as OoxmlNoteReferenceNode, q as OoxmlSeparatorNode, I as ImpactClass, O as OoxmlPart, b as OoxmlPackage, T as TreeDocOp, r as TreeOpRejection } from './tree-op-types-BPyXNxyL.cjs';
+import { a as OoxmlNode, j as OoxmlParagraphNode, k as OoxmlNoteNode, l as OoxmlContinuationSeparatorNode, m as OoxmlEndnotesNode, n as OoxmlFootnotesNode, o as OoxmlNoteRefNode, p as OoxmlNoteReferenceNode, q as OoxmlSeparatorNode, I as ImpactClass, O as OoxmlPart, b as OoxmlPackage, T as TreeDocOp, r as TreeOpRejection } from './tree-op-types-BUulYD5y.cjs';
 
 /** UTF-16 placeholder for one atomic note unit in `paragraphTextOf` / segments. */
 declare const NOTE_ATOM_CHAR = "\uFFFC";

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@docx-editor.dev/core",
-  "version": "2.11.0",
+  "version": "2.13.0",
   "description": "Framework-agnostic core for docx-editor.dev: OOXML parse/serialize, the canonical document tree, layout and paint, and the Editor contract the adapters render.",
   "type": "module",
+  "engines": {
+    "node": "^20.16.0 || >=22.3.0"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -97,7 +100,7 @@
     "directory": "packages/core"
   },
   "dependencies": {
-    "@docx-editor.dev/i18n": "^2.11.0",
+    "@docx-editor.dev/i18n": "^2.13.0",
     "bidi-js": "1.0.3",
     "emf-converter": "2.0.2",
     "fast-xml-parser": "^5.10.1",