@docx-editor.dev/core 2.7.0 → 2.9.0

package/dist/{tree-op-types-fZgbrR5F.d.ts → tree-op-types-B0-sCtw-.d.cts}

@@ -1,4 +1,5 @@
-import { O as OoxmlNode, a as OoxmlElement, o as OoxmlDrawingNode, b as OoxmlContentControlNode, d as OoxmlContentControlContentNode, p as OoxmlContentControlEndPropertiesNode, q as OoxmlContentControlPropertiesNode, e as OoxmlPart } from './ooxml-tree-BU0e3DVi.js';
+import { ParagraphTabStop } from './contracts/types.cjs';
+import { a as OoxmlNode, b as OoxmlElement, r as OoxmlDrawingNode, p as OoxmlContentControlNode, q as OoxmlContentControlContentNode, s as OoxmlContentControlEndPropertiesNode, t as OoxmlContentControlPropertiesNode, O as OoxmlPart } from './ooxml-package-CdEy9ufK.cjs';
 
 /** The relationship namespace `r:id` lives in. */
 declare const OFFICE_RELATIONSHIP_NAMESPACE_URI = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
@@ -562,7 +563,14 @@ type ContentControlValueInput = {
 };
 /** The control types an insertion may author. Picture and repeating section are deferred. */
 declare const INSERTABLE_CONTENT_CONTROL_TYPES: readonly ["richText", "plainText", "dropDownList", "comboBox", "date"];
-type InsertableContentControlType = (typeof INSERTABLE_CONTENT_CONTROL_TYPES)[number];
+/**
+ * The OOXML spellings the store writes.
+ *
+ * NOT the contract's `InsertableContentControlType`, which is the same set of kinds in the
+ * READ vocabulary (`dropdown`) plus this lane's spelling of it (`dropDownList`). The editor
+ * maps between the two; the names differ so a reader can tell which vocabulary a value is in.
+ */
+type InsertableContentControlKind = (typeof INSERTABLE_CONTENT_CONTROL_TYPES)[number];
 
 /** Allowlisted OOXML table border line styles — store/layout authority. */
 declare const TABLE_BORDER_STYLES: readonly ["single", "dashed", "dotted", "double", "triple", "thick"];
@@ -618,16 +626,21 @@ interface TableBorderSpecInput {
  */
 declare const ACCEPTED_RUN_PROPERTIES: readonly ["rFonts", "sz", "szCs", "color", "b", "bCs", "i", "iCs", "u", "strike", "dstrike", "highlight", "vertAlign", "position", "caps", "smallCaps", "spacing", "w", "kern"];
 /** The accepted PARAGRAPH property boundary (design D8). */
-declare const ACCEPTED_PARAGRAPH_PROPERTIES: readonly ["pStyle", "jc", "spacing", "ind", "tabs", "numPr", "keepNext", "keepLines", "widowControl", "pageBreakBefore", "shd"];
+declare const ACCEPTED_PARAGRAPH_PROPERTIES: readonly ["pStyle", "jc", "spacing", "ind", "tabs", "numPr", "keepNext", "keepLines", "widowControl", "pageBreakBefore", "contextualSpacing", "shd"];
+/**
+ * One tab stop an op can author: where it sits, how it aligns, and what fills the gap.
+ *
+ * An alias, not a second declaration. The contract lane already names this shape, and two
+ * public names for one shape is a trap — a caller building a stop for a read and for an op
+ * would otherwise have to name it two things.
+ */
+type TabStopWrite = ParagraphTabStop;
 /**
  * One authored property: an element name plus its `w:`-namespace attributes.
  *
  * Modeled as name+attributes rather than a typed record per property because that is what
  * the tree holds, so an op maps to nodes without a lossy intermediate vocabulary. Attribute
  * VALUES are validated as XML text; their meaning is the resolver's business.
- */
-/**
- * One property an op writes, as a name plus attributes.
  *
  * Deliberately structural rather than a typed union: the accepted property lists bound WHICH
  * properties may be written, so the shape itself does not need to enumerate them.
@@ -671,6 +684,16 @@ interface RevisionAttributionInput {
  * unchanged.
  */
 type TreeDocOp = {
+    /**
+     * Replace one story's complete block structure with fresh plain paragraphs.
+     *
+     * Unlike a span replacement, this removes section-ending paragraphs and content-control
+     * wrappers. A body's final direct `w:sectPr` survives to retain the page setup.
+     */
+    readonly op: 'replaceStoryBlocks';
+    readonly storyRootId: string;
+    readonly paragraphs: readonly string[];
+} | {
     /**
      * Insert an SDT-wrapped TOC immediately before a body paragraph.
      * The initial cached result and any heading bookmarks land in one undo unit.
@@ -845,6 +868,29 @@ type TreeDocOp = {
     readonly paragraphId: string;
     readonly numId: string | null;
     readonly level?: number;
+} | {
+    /**
+     * Replace a paragraph's custom tab stops, or clear them with an empty list.
+     *
+     * Its OWN op rather than a `w:tabs` entry in `setParagraphProperties`, because
+     * `OoxmlProperty` is flat and `w:tabs` carries its meaning in `w:tab` children — the
+     * same reason `setListNumbering` exists for `w:numPr`.
+     */
+    readonly op: 'setParagraphTabStops';
+    readonly paragraphId: string;
+    readonly stops: readonly TabStopWrite[];
+    /**
+     * Every stop position IN FORCE when the editor read the paragraph, including the
+     * ones a style supplied.
+     *
+     * Tab stops are read through the cascade and written at the paragraph level, so a
+     * replace alone cannot remove an inherited stop — the user clears a row, the style
+     * puts it straight back, and the command reports success. A position that was in
+     * force and is not in `stops` is suppressed with `w:val="clear"`, which is what the
+     * value exists for (§17.3.1.37). Omit when the caller has no cascade to speak of;
+     * the write is then a plain paragraph-level replace.
+     */
+    readonly inForcePositionsTwips?: readonly number[];
 } | {
     readonly op: 'splitParagraph';
     readonly paragraphId: string;
@@ -979,6 +1025,20 @@ type TreeDocOp = {
      */
     readonly op: 'removeHyperlink';
     readonly linkId: string;
+} | {
+    /**
+     * Replace one preserved `m:oMath` atom from bounded linear-math input.
+     *
+     * The complete equation changes as one unit. Internal OMML text never enters the
+     * paragraph offset space, so callers cannot leave a partially edited math tree.
+     */
+    readonly op: 'setMathEquation';
+    readonly equationId: string;
+    readonly linear: string;
+} | {
+    /** Remove one complete `m:oMath` atom. */
+    readonly op: 'removeMathEquation';
+    readonly equationId: string;
 } | {
     /**
      * Insert a NEW run-level content control at a text offset: `w:sdt` with a
@@ -1261,7 +1321,7 @@ type TreeDocOp = {
     readonly paragraphId: string;
     readonly start: number;
     readonly end: number;
-    readonly type: InsertableContentControlType;
+    readonly type: InsertableContentControlKind;
     readonly tag?: string;
     readonly alias?: string;
     readonly lock?: ContentControlLock;
@@ -1370,7 +1430,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 ["insertText", "deleteText", "setParagraphMarkRevision", "proposeParagraphMerge", "insertCommentMarker", "acceptRevision", "rejectRevision", "acceptAllRevisions", "rejectAllRevisions", "insertTab", "insertHardBreak", "insertPageBreak", "insertPageField", "setListLevel", "setListNumbering", "setParagraphMarkProperties", "splitParagraph", "splitParagraphMany", "joinParagraphs", "setRunProperties", "setParagraphProperties", "setSectionProperties", "setSectionMark", "insertHyperlink", "setHyperlinkTarget", "removeHyperlink", "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", "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", "insertDrawing", "replaceDrawingResource", "deleteDrawing", "resizeDrawing", "cropDrawing", "positionDrawing", "setDrawingWrap", "setDrawingMetadata", "setDrawingLocks", "transformDrawing", "insertToc", "replaceTocResult", "rewriteTocPageNumbers"];
 /**
  * How far a committed op can reach, so layout can scope its work (task 5.2).
  *
@@ -1421,7 +1481,16 @@ interface TreeOpEffect {
  * `not-adjacent-siblings` is the notable one: a join across table cells is refused rather than
  * silently merging content out of the cell that owned it.
  */
-type TreeOpRejection = 'unknown-op' | 'unknown-paragraph' | 'not-a-paragraph' | 'offset-out-of-range' | 'invalid-range' | 'not-a-list-paragraph' | 'splits-surrogate-pair' | 'invalid-text' | 'unsupported-property' | 'invalid-property-value' | 'not-adjacent-siblings' | 'unknown-block' | 'not-a-block' | 'block-required' | 'carries-section-mark'
+type TreeOpRejection = 'unknown-op' | 'unknown-paragraph' | 'not-a-paragraph' | 'offset-out-of-range' | 'invalid-range' | 'not-a-list-paragraph' | 'splits-surrogate-pair' | 'invalid-text' | 'unsupported-property' | 'invalid-property-value' | 'not-adjacent-siblings'
+/**
+ * The addressed position is strictly inside content nothing can divide: a hyperlink, an
+ * inline content control, a revision wrapper, or an atomic field.
+ *
+ * Distinct from `invalid-range`, which is an offset the paragraph does not have. This one is
+ * a real offset that is not a PLACE — refused rather than resolved to the nearest one, so a
+ * caller learns the node would not have landed where they asked.
+ */
+ | 'indivisible-content' | 'unknown-block' | 'not-a-block' | 'block-required' | 'carries-section-mark'
 /** The transaction named a part the package does not hold. */
  | 'unknown-part'
 /**
@@ -1496,4 +1565,4 @@ type TreeOpResult = {
     readonly detail?: string;
 };
 
-export { contentControlTextOf as $, ACCEPTED_PARAGRAPH_PROPERTIES as A, type HyperlinkKind as B, type ContentControlKind as C, type DrawingProjection as D, type HyperlinkTarget as E, MAX_CONTENT_CONTROL_NESTING as F, OFFICE_RELATIONSHIP_NAMESPACE_URI as G, HYPERLINK_RELATIONSHIP_TYPE as H, type ImpactClass as I, type RelationshipTargetResolver as J, TABLE_BORDER_STYLES as K, TREE_DOC_OP_KINDS as L, MAX_CONTENT_CONTROLS_PER_PART as M, type TreeDocOpKind as N, type OoxmlProperty as O, type TreeOpEffect as P, allocateContentControlId as Q, type RevisionAddress as R, type SourceCrop as S, type TreeDocOp as T, contentControlContentChildren as U, type VectorShapeProjection as V, contentControlContentNodeOf as W, contentControlEndPropertiesNodeOf as X, contentControlLevelOf as Y, contentControlPropertiesNodeOf as Z, contentControlPropertiesOf as _, type TreeOpRejection as a, contentControlsIn as a0, findContentControl as a1, flattenContentControls as a2, hyperlinkAnchorOf as a3, hyperlinkRelationshipIdOf as a4, hyperlinkTargetOf as a5, isContentControlContentNode as a6, isContentControlNode as a7, isContentControlWrapper as a8, isHyperlinkNode as a9, lockForbidsEdit as aa, lockForbidsRemoval as ab, orderedContentControlProperties as ac, parseContentControlId as ad, projectDrawing as ae, resolveContentControlLock as af, type ImageWrapTarget as b, type DrawingKind as c, type DrawingPositionInput as d, type DrawingLocks as e, type DrawingHorizontalReferenceFrame as f, type DrawingVerticalReferenceFrame as g, type DrawingTreeDocOp as h, type TreeDocColorValue as i, IMAGE_WRAP_TARGETS as j, type DrawingAccessibility as k, type DrawingTransform as l, type TableBorderStyle as m, type ContentControlLevel as n, type ContentControlLock as o, type ContentControlDataBinding as p, type TreeOpResult as q, ACCEPTED_RUN_PROPERTIES as r, CONTENT_CONTROL_ID_MAX as s, CONTENT_CONTROL_PROPERTY_ORDER as t, type ContentControlCheckbox as u, type ContentControlCheckboxState as v, type ContentControlDateFormat as w, type ContentControlEntry as x, type ContentControlListItem as y, type ContentControlProperties as z };
+export { contentControlPropertiesOf as $, ACCEPTED_PARAGRAPH_PROPERTIES as A, type HyperlinkKind as B, type ContentControlKind as C, type DrawingProjection as D, type HyperlinkTarget as E, MAX_CONTENT_CONTROL_NESTING as F, OFFICE_RELATIONSHIP_NAMESPACE_URI as G, HYPERLINK_RELATIONSHIP_TYPE as H, type ImpactClass as I, type RelationshipTargetResolver as J, TABLE_BORDER_STYLES as K, TREE_DOC_OP_KINDS as L, MAX_CONTENT_CONTROLS_PER_PART as M, type TabStopWrite as N, type OoxmlProperty as O, type TreeDocOpKind as P, type TreeOpEffect as Q, type RevisionAddress as R, type SourceCrop as S, type TreeDocOp as T, allocateContentControlId as U, type VectorShapeProjection as V, contentControlContentChildren as W, contentControlContentNodeOf as X, contentControlEndPropertiesNodeOf as Y, contentControlLevelOf as Z, contentControlPropertiesNodeOf as _, type TreeOpRejection as a, contentControlTextOf as a0, contentControlsIn as a1, findContentControl as a2, flattenContentControls as a3, hyperlinkAnchorOf as a4, hyperlinkRelationshipIdOf as a5, hyperlinkTargetOf as a6, isContentControlContentNode as a7, isContentControlNode as a8, isContentControlWrapper as a9, isHyperlinkNode as aa, lockForbidsEdit as ab, lockForbidsRemoval as ac, orderedContentControlProperties as ad, parseContentControlId as ae, projectDrawing as af, resolveContentControlLock as ag, type ImageWrapTarget as b, type DrawingKind as c, type DrawingPositionInput as d, type DrawingLocks as e, type DrawingHorizontalReferenceFrame as f, type DrawingVerticalReferenceFrame as g, type DrawingTreeDocOp as h, type TreeDocColorValue as i, IMAGE_WRAP_TARGETS as j, type DrawingAccessibility as k, type DrawingTransform as l, type TableBorderStyle as m, type ContentControlLevel as n, type ContentControlLock as o, type ContentControlDataBinding as p, type TreeOpResult as q, ACCEPTED_RUN_PROPERTIES as r, CONTENT_CONTROL_ID_MAX as s, CONTENT_CONTROL_PROPERTY_ORDER as t, type ContentControlCheckbox as u, type ContentControlCheckboxState as v, type ContentControlDateFormat as w, type ContentControlEntry as x, type ContentControlListItem as y, type ContentControlProperties as z };

package/dist/{tree-op-types-QujrzgCz.d.cts → tree-op-types-XMVsJSpe.d.ts}

@@ -1,4 +1,5 @@
-import { O as OoxmlNode, a as OoxmlElement, o as OoxmlDrawingNode, b as OoxmlContentControlNode, d as OoxmlContentControlContentNode, p as OoxmlContentControlEndPropertiesNode, q as OoxmlContentControlPropertiesNode, e as OoxmlPart } from './ooxml-tree-BU0e3DVi.cjs';
+import { ParagraphTabStop } from './contracts/types.js';
+import { a as OoxmlNode, b as OoxmlElement, r as OoxmlDrawingNode, p as OoxmlContentControlNode, q as OoxmlContentControlContentNode, s as OoxmlContentControlEndPropertiesNode, t as OoxmlContentControlPropertiesNode, O as OoxmlPart } from './ooxml-package-CdEy9ufK.js';
 
 /** The relationship namespace `r:id` lives in. */
 declare const OFFICE_RELATIONSHIP_NAMESPACE_URI = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
@@ -562,7 +563,14 @@ type ContentControlValueInput = {
 };
 /** The control types an insertion may author. Picture and repeating section are deferred. */
 declare const INSERTABLE_CONTENT_CONTROL_TYPES: readonly ["richText", "plainText", "dropDownList", "comboBox", "date"];
-type InsertableContentControlType = (typeof INSERTABLE_CONTENT_CONTROL_TYPES)[number];
+/**
+ * The OOXML spellings the store writes.
+ *
+ * NOT the contract's `InsertableContentControlType`, which is the same set of kinds in the
+ * READ vocabulary (`dropdown`) plus this lane's spelling of it (`dropDownList`). The editor
+ * maps between the two; the names differ so a reader can tell which vocabulary a value is in.
+ */
+type InsertableContentControlKind = (typeof INSERTABLE_CONTENT_CONTROL_TYPES)[number];
 
 /** Allowlisted OOXML table border line styles — store/layout authority. */
 declare const TABLE_BORDER_STYLES: readonly ["single", "dashed", "dotted", "double", "triple", "thick"];
@@ -618,16 +626,21 @@ interface TableBorderSpecInput {
  */
 declare const ACCEPTED_RUN_PROPERTIES: readonly ["rFonts", "sz", "szCs", "color", "b", "bCs", "i", "iCs", "u", "strike", "dstrike", "highlight", "vertAlign", "position", "caps", "smallCaps", "spacing", "w", "kern"];
 /** The accepted PARAGRAPH property boundary (design D8). */
-declare const ACCEPTED_PARAGRAPH_PROPERTIES: readonly ["pStyle", "jc", "spacing", "ind", "tabs", "numPr", "keepNext", "keepLines", "widowControl", "pageBreakBefore", "shd"];
+declare const ACCEPTED_PARAGRAPH_PROPERTIES: readonly ["pStyle", "jc", "spacing", "ind", "tabs", "numPr", "keepNext", "keepLines", "widowControl", "pageBreakBefore", "contextualSpacing", "shd"];
+/**
+ * One tab stop an op can author: where it sits, how it aligns, and what fills the gap.
+ *
+ * An alias, not a second declaration. The contract lane already names this shape, and two
+ * public names for one shape is a trap — a caller building a stop for a read and for an op
+ * would otherwise have to name it two things.
+ */
+type TabStopWrite = ParagraphTabStop;
 /**
  * One authored property: an element name plus its `w:`-namespace attributes.
  *
  * Modeled as name+attributes rather than a typed record per property because that is what
  * the tree holds, so an op maps to nodes without a lossy intermediate vocabulary. Attribute
  * VALUES are validated as XML text; their meaning is the resolver's business.
- */
-/**
- * One property an op writes, as a name plus attributes.
  *
  * Deliberately structural rather than a typed union: the accepted property lists bound WHICH
  * properties may be written, so the shape itself does not need to enumerate them.
@@ -671,6 +684,16 @@ interface RevisionAttributionInput {
  * unchanged.
  */
 type TreeDocOp = {
+    /**
+     * Replace one story's complete block structure with fresh plain paragraphs.
+     *
+     * Unlike a span replacement, this removes section-ending paragraphs and content-control
+     * wrappers. A body's final direct `w:sectPr` survives to retain the page setup.
+     */
+    readonly op: 'replaceStoryBlocks';
+    readonly storyRootId: string;
+    readonly paragraphs: readonly string[];
+} | {
     /**
      * Insert an SDT-wrapped TOC immediately before a body paragraph.
      * The initial cached result and any heading bookmarks land in one undo unit.
@@ -845,6 +868,29 @@ type TreeDocOp = {
     readonly paragraphId: string;
     readonly numId: string | null;
     readonly level?: number;
+} | {
+    /**
+     * Replace a paragraph's custom tab stops, or clear them with an empty list.
+     *
+     * Its OWN op rather than a `w:tabs` entry in `setParagraphProperties`, because
+     * `OoxmlProperty` is flat and `w:tabs` carries its meaning in `w:tab` children — the
+     * same reason `setListNumbering` exists for `w:numPr`.
+     */
+    readonly op: 'setParagraphTabStops';
+    readonly paragraphId: string;
+    readonly stops: readonly TabStopWrite[];
+    /**
+     * Every stop position IN FORCE when the editor read the paragraph, including the
+     * ones a style supplied.
+     *
+     * Tab stops are read through the cascade and written at the paragraph level, so a
+     * replace alone cannot remove an inherited stop — the user clears a row, the style
+     * puts it straight back, and the command reports success. A position that was in
+     * force and is not in `stops` is suppressed with `w:val="clear"`, which is what the
+     * value exists for (§17.3.1.37). Omit when the caller has no cascade to speak of;
+     * the write is then a plain paragraph-level replace.
+     */
+    readonly inForcePositionsTwips?: readonly number[];
 } | {
     readonly op: 'splitParagraph';
     readonly paragraphId: string;
@@ -979,6 +1025,20 @@ type TreeDocOp = {
      */
     readonly op: 'removeHyperlink';
     readonly linkId: string;
+} | {
+    /**
+     * Replace one preserved `m:oMath` atom from bounded linear-math input.
+     *
+     * The complete equation changes as one unit. Internal OMML text never enters the
+     * paragraph offset space, so callers cannot leave a partially edited math tree.
+     */
+    readonly op: 'setMathEquation';
+    readonly equationId: string;
+    readonly linear: string;
+} | {
+    /** Remove one complete `m:oMath` atom. */
+    readonly op: 'removeMathEquation';
+    readonly equationId: string;
 } | {
     /**
      * Insert a NEW run-level content control at a text offset: `w:sdt` with a
@@ -1261,7 +1321,7 @@ type TreeDocOp = {
     readonly paragraphId: string;
     readonly start: number;
     readonly end: number;
-    readonly type: InsertableContentControlType;
+    readonly type: InsertableContentControlKind;
     readonly tag?: string;
     readonly alias?: string;
     readonly lock?: ContentControlLock;
@@ -1370,7 +1430,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 ["insertText", "deleteText", "setParagraphMarkRevision", "proposeParagraphMerge", "insertCommentMarker", "acceptRevision", "rejectRevision", "acceptAllRevisions", "rejectAllRevisions", "insertTab", "insertHardBreak", "insertPageBreak", "insertPageField", "setListLevel", "setListNumbering", "setParagraphMarkProperties", "splitParagraph", "splitParagraphMany", "joinParagraphs", "setRunProperties", "setParagraphProperties", "setSectionProperties", "setSectionMark", "insertHyperlink", "setHyperlinkTarget", "removeHyperlink", "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", "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", "insertDrawing", "replaceDrawingResource", "deleteDrawing", "resizeDrawing", "cropDrawing", "positionDrawing", "setDrawingWrap", "setDrawingMetadata", "setDrawingLocks", "transformDrawing", "insertToc", "replaceTocResult", "rewriteTocPageNumbers"];
 /**
  * How far a committed op can reach, so layout can scope its work (task 5.2).
  *
@@ -1421,7 +1481,16 @@ interface TreeOpEffect {
  * `not-adjacent-siblings` is the notable one: a join across table cells is refused rather than
  * silently merging content out of the cell that owned it.
  */
-type TreeOpRejection = 'unknown-op' | 'unknown-paragraph' | 'not-a-paragraph' | 'offset-out-of-range' | 'invalid-range' | 'not-a-list-paragraph' | 'splits-surrogate-pair' | 'invalid-text' | 'unsupported-property' | 'invalid-property-value' | 'not-adjacent-siblings' | 'unknown-block' | 'not-a-block' | 'block-required' | 'carries-section-mark'
+type TreeOpRejection = 'unknown-op' | 'unknown-paragraph' | 'not-a-paragraph' | 'offset-out-of-range' | 'invalid-range' | 'not-a-list-paragraph' | 'splits-surrogate-pair' | 'invalid-text' | 'unsupported-property' | 'invalid-property-value' | 'not-adjacent-siblings'
+/**
+ * The addressed position is strictly inside content nothing can divide: a hyperlink, an
+ * inline content control, a revision wrapper, or an atomic field.
+ *
+ * Distinct from `invalid-range`, which is an offset the paragraph does not have. This one is
+ * a real offset that is not a PLACE — refused rather than resolved to the nearest one, so a
+ * caller learns the node would not have landed where they asked.
+ */
+ | 'indivisible-content' | 'unknown-block' | 'not-a-block' | 'block-required' | 'carries-section-mark'
 /** The transaction named a part the package does not hold. */
  | 'unknown-part'
 /**
@@ -1496,4 +1565,4 @@ type TreeOpResult = {
     readonly detail?: string;
 };
 
-export { contentControlTextOf as $, ACCEPTED_PARAGRAPH_PROPERTIES as A, type HyperlinkKind as B, type ContentControlKind as C, type DrawingProjection as D, type HyperlinkTarget as E, MAX_CONTENT_CONTROL_NESTING as F, OFFICE_RELATIONSHIP_NAMESPACE_URI as G, HYPERLINK_RELATIONSHIP_TYPE as H, type ImpactClass as I, type RelationshipTargetResolver as J, TABLE_BORDER_STYLES as K, TREE_DOC_OP_KINDS as L, MAX_CONTENT_CONTROLS_PER_PART as M, type TreeDocOpKind as N, type OoxmlProperty as O, type TreeOpEffect as P, allocateContentControlId as Q, type RevisionAddress as R, type SourceCrop as S, type TreeDocOp as T, contentControlContentChildren as U, type VectorShapeProjection as V, contentControlContentNodeOf as W, contentControlEndPropertiesNodeOf as X, contentControlLevelOf as Y, contentControlPropertiesNodeOf as Z, contentControlPropertiesOf as _, type TreeOpRejection as a, contentControlsIn as a0, findContentControl as a1, flattenContentControls as a2, hyperlinkAnchorOf as a3, hyperlinkRelationshipIdOf as a4, hyperlinkTargetOf as a5, isContentControlContentNode as a6, isContentControlNode as a7, isContentControlWrapper as a8, isHyperlinkNode as a9, lockForbidsEdit as aa, lockForbidsRemoval as ab, orderedContentControlProperties as ac, parseContentControlId as ad, projectDrawing as ae, resolveContentControlLock as af, type ImageWrapTarget as b, type DrawingKind as c, type DrawingPositionInput as d, type DrawingLocks as e, type DrawingHorizontalReferenceFrame as f, type DrawingVerticalReferenceFrame as g, type DrawingTreeDocOp as h, type TreeDocColorValue as i, IMAGE_WRAP_TARGETS as j, type DrawingAccessibility as k, type DrawingTransform as l, type TableBorderStyle as m, type ContentControlLevel as n, type ContentControlLock as o, type ContentControlDataBinding as p, type TreeOpResult as q, ACCEPTED_RUN_PROPERTIES as r, CONTENT_CONTROL_ID_MAX as s, CONTENT_CONTROL_PROPERTY_ORDER as t, type ContentControlCheckbox as u, type ContentControlCheckboxState as v, type ContentControlDateFormat as w, type ContentControlEntry as x, type ContentControlListItem as y, type ContentControlProperties as z };
+export { contentControlPropertiesOf as $, ACCEPTED_PARAGRAPH_PROPERTIES as A, type HyperlinkKind as B, type ContentControlKind as C, type DrawingProjection as D, type HyperlinkTarget as E, MAX_CONTENT_CONTROL_NESTING as F, OFFICE_RELATIONSHIP_NAMESPACE_URI as G, HYPERLINK_RELATIONSHIP_TYPE as H, type ImpactClass as I, type RelationshipTargetResolver as J, TABLE_BORDER_STYLES as K, TREE_DOC_OP_KINDS as L, MAX_CONTENT_CONTROLS_PER_PART as M, type TabStopWrite as N, type OoxmlProperty as O, type TreeDocOpKind as P, type TreeOpEffect as Q, type RevisionAddress as R, type SourceCrop as S, type TreeDocOp as T, allocateContentControlId as U, type VectorShapeProjection as V, contentControlContentChildren as W, contentControlContentNodeOf as X, contentControlEndPropertiesNodeOf as Y, contentControlLevelOf as Z, contentControlPropertiesNodeOf as _, type TreeOpRejection as a, contentControlTextOf as a0, contentControlsIn as a1, findContentControl as a2, flattenContentControls as a3, hyperlinkAnchorOf as a4, hyperlinkRelationshipIdOf as a5, hyperlinkTargetOf as a6, isContentControlContentNode as a7, isContentControlNode as a8, isContentControlWrapper as a9, isHyperlinkNode as aa, lockForbidsEdit as ab, lockForbidsRemoval as ac, orderedContentControlProperties as ad, parseContentControlId as ae, projectDrawing as af, resolveContentControlLock as ag, type ImageWrapTarget as b, type DrawingKind as c, type DrawingPositionInput as d, type DrawingLocks as e, type DrawingHorizontalReferenceFrame as f, type DrawingVerticalReferenceFrame as g, type DrawingTreeDocOp as h, type TreeDocColorValue as i, IMAGE_WRAP_TARGETS as j, type DrawingAccessibility as k, type DrawingTransform as l, type TableBorderStyle as m, type ContentControlLevel as n, type ContentControlLock as o, type ContentControlDataBinding as p, type TreeOpResult as q, ACCEPTED_RUN_PROPERTIES as r, CONTENT_CONTROL_ID_MAX as s, CONTENT_CONTROL_PROPERTY_ORDER as t, type ContentControlCheckbox as u, type ContentControlCheckboxState as v, type ContentControlDateFormat as w, type ContentControlEntry as x, type ContentControlListItem as y, type ContentControlProperties as z };

package/dist/{tree-session-5UWKAQ41.d.cts → tree-session-D945D43B.d.cts}

@@ -1,13 +1,12 @@
-import { S as SupportedImageMime, b as ImageDecodePort } from './image-resources-Bkmu1Jei.cjs';
-import { S as StoryScope, a as StoryTargetRejection, D as DocumentTrackingSettings, I as InsertCustomNodeWrite, C as CustomNodeWriteResult, b as CustomNodeSweepOutcome, E as EmbeddedFont, B as BookmarkIndex, L as ListKind, c as InsertImageInput, d as ImageIntentResult, R as ReplaceImageOptions, A as ApplyImagePropertiesInput } from './custom-node-writes-C_AlNvds.cjs';
+import { S as SupportedImageMime, b as ImageDecodePort } from './image-resources-DQOiwOuE.cjs';
+import { S as StoryScope, a as StoryTargetRejection, D as DocumentTrackingSettings, I as InsertCustomNodeWrite, C as CustomNodeWriteResult, b as CustomNodeSweepOutcome, E as EmbeddedFont, B as BookmarkIndex, L as ListKind, c as InsertImageInput, d as ImageIntentResult, R as ReplaceImageOptions, A as ApplyImagePropertiesInput } from './custom-node-writes-7ERv0f_X.cjs';
 import { Node } from 'prosemirror-model';
-import { a as ReviewItem } from './review-support-oQrX6Xu3.cjs';
+import { O as OoxmlPart, a as OoxmlNode, c as OoxmlPackage, b as OoxmlElement, o as OoxmlPackageRejection } from './ooxml-package-CdEy9ufK.cjs';
+import { a as HeaderFooterParts, b as HeaderFooterSectionResolution } from './hf-references-Dvk6De4Q.cjs';
+import { S as SelectionMark, T as TreeModelChange, D as DocumentProperties } from './tree-store-C6vc8E_2.cjs';
+import { T as TreeDocOp } from './tree-op-types-B0-sCtw-.cjs';
+import { a as ReviewItem } from './review-items-DpsqTHio.cjs';
 import { ReviewModuleContribution } from './contracts/modules.cjs';
-import { e as OoxmlPart, O as OoxmlNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.cjs';
-import { O as OoxmlPackage, b as OoxmlPackageRejection } from './ooxml-package-CR5us6ad.cjs';
-import { a as HeaderFooterParts, b as HeaderFooterSectionResolution } from './hf-references-CgEOSw3i.cjs';
-import { S as SelectionMark, T as TreeModelChange, D as DocumentProperties } from './tree-store-DhYIACNE.cjs';
-import { T as TreeDocOp } from './tree-op-types-QujrzgCz.cjs';
 
 /**
  * Why an edited projection could not be mapped back into tree ops.
@@ -178,10 +177,36 @@ interface RunPropertyLike {
 interface ParagraphAnchorIndex {
     /** nodeId → `w14:paraId`, verbatim as authored/minted. Paragraphs without one are absent. */
     readonly paraIdByNode: ReadonlyMap<string, string>;
-    /** UPPERCASED paraId → nodeId (matching is case-insensitive). First occurrence wins on the impossible-by-invariant duplicate. */
+    /** UPPERCASED paraId → nodeId (matching is case-insensitive). The first story to claim it. */
     readonly nodeByParaId: ReadonlyMap<string, string>;
     /** nodeId → reading-order ordinal, for document-ordering DocRange endpoints. */
     readonly ordinalByNode: ReadonlyMap<string, number>;
+    /**
+     * UPPERCASED paraIds more than one story claims.
+     *
+     * Minting is unique per PART and the contract's uniqueness is per DOCUMENT, so an authored
+     * file may repeat one. Resolving such an anchor to whichever story came first would be a
+     * silent wrong answer; it is refused as ambiguous instead.
+     */
+    readonly ambiguousParaIds: ReadonlySet<string>;
+    /**
+     * nodeId → the part it was indexed from.
+     *
+     * The index spans every story, so a caller holding one part and a node id from another reads
+     * an empty paragraph and draws a false conclusion from it. Carrying the part alongside the id
+     * is what keeps the two in step.
+     */
+    readonly partByNode: ReadonlyMap<string, OoxmlPart>;
+    /**
+     * Every node claiming an ambiguous paraId. DIAGNOSTIC, never a way to pick one.
+     *
+     * Resolution refuses a clash outright, and this is what says which paragraphs caused it, for
+     * a reader repairing the file. Preferring one claimant by the caller's part was tried and
+     * reverted: every resolver call site passes the MAIN part, so the preference could only ever
+     * land on the body twin and answer `ok` for a header paragraph the caller meant. See
+     * `resolveDocAnchor` in `editor/anchor-resolution.ts`.
+     */
+    readonly claimantsByParaId: ReadonlyMap<string, readonly string[]>;
 }
 
 /**
@@ -238,6 +263,15 @@ interface TreeDocxSessionView {
      * and one undo unit without swapping the body store.
      */
     applyTreeOps(ops: readonly TreeDocOp[], selectionBefore?: SelectionMark | null, selectionAfter?: SelectionMark | null, scope?: StoryScope): TreeApplyResult;
+    /**
+     * Every part that holds a story, body first, then headers, footers and note parts.
+     *
+     * A READ: parts come from the package, so this opens no story store and spends none of the
+     * 64 editable-store slots. Use it for any query that must answer about the whole document
+     * rather than about the caret — an enumeration that reads only the body reports a document
+     * the reader is not looking at.
+     */
+    storyParts(): readonly OoxmlPart[];
     /** Body text, paragraphs joined by newlines, read from the CANONICAL tree. */
     bodyText(): string;
     /** Text of a story scope, paragraphs joined by newlines. */
@@ -300,17 +334,9 @@ interface TreeDocxSessionView {
      * empty paragraph — a declaration with no glyph behind it.
      */
     rendersText(): boolean;
-    /**
-     * The `w:style` definitions of the styles part, validated and projected for a style
-     * picker. Memoized once: the styles part is immutable for the session's lifetime.
-     * A document without a styles part answers `[]`.
-     */
+    /** Validated style-picker projection. A document without styles answers `[]`. */
     documentStyles(): readonly DocumentStyleEntry[];
-    /**
-     * Root of the styles part tree, for layout's style cascade. Memoized once; `null` when
-     * the package has no styles part. Styles editing is a later slice, so this is immutable
-     * for the session.
-     */
+    /** Current styles root for layout, or `null` when the package has no styles part. */
     stylesRoot(): OoxmlElement | null;
     /**
      * The theme part's Latin typefaces, for resolving `w:rFonts` theme references in layout.

package/dist/{tree-session--6LDTNjR.d.ts → tree-session-DBJgmdmc.d.ts}

@@ -1,13 +1,12 @@
-import { S as SupportedImageMime, b as ImageDecodePort } from './image-resources-BWd5u-op.js';
-import { S as StoryScope, a as StoryTargetRejection, D as DocumentTrackingSettings, I as InsertCustomNodeWrite, C as CustomNodeWriteResult, b as CustomNodeSweepOutcome, E as EmbeddedFont, B as BookmarkIndex, L as ListKind, c as InsertImageInput, d as ImageIntentResult, R as ReplaceImageOptions, A as ApplyImagePropertiesInput } from './custom-node-writes-BpOBjNzo.js';
+import { S as SupportedImageMime, b as ImageDecodePort } from './image-resources-eZqD_-vC.js';
+import { S as StoryScope, a as StoryTargetRejection, D as DocumentTrackingSettings, I as InsertCustomNodeWrite, C as CustomNodeWriteResult, b as CustomNodeSweepOutcome, E as EmbeddedFont, B as BookmarkIndex, L as ListKind, c as InsertImageInput, d as ImageIntentResult, R as ReplaceImageOptions, A as ApplyImagePropertiesInput } from './custom-node-writes-QyVZdTUA.js';
 import { Node } from 'prosemirror-model';
-import { a as ReviewItem } from './review-support-Cr2n7f1-.js';
+import { O as OoxmlPart, a as OoxmlNode, c as OoxmlPackage, b as OoxmlElement, o as OoxmlPackageRejection } from './ooxml-package-CdEy9ufK.js';
+import { a as HeaderFooterParts, b as HeaderFooterSectionResolution } from './hf-references-z5Y4N1ab.js';
+import { S as SelectionMark, T as TreeModelChange, D as DocumentProperties } from './tree-store-ClA-qng4.js';
+import { T as TreeDocOp } from './tree-op-types-XMVsJSpe.js';
+import { a as ReviewItem } from './review-items-D5SPFtsO.js';
 import { ReviewModuleContribution } from './contracts/modules.js';
-import { e as OoxmlPart, O as OoxmlNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.js';
-import { O as OoxmlPackage, b as OoxmlPackageRejection } from './ooxml-package-D_CtywTW.js';
-import { a as HeaderFooterParts, b as HeaderFooterSectionResolution } from './hf-references-BdjsQNE_.js';
-import { S as SelectionMark, T as TreeModelChange, D as DocumentProperties } from './tree-store-Dy9FZ1pa.js';
-import { T as TreeDocOp } from './tree-op-types-fZgbrR5F.js';
 
 /**
  * Why an edited projection could not be mapped back into tree ops.
@@ -178,10 +177,36 @@ interface RunPropertyLike {
 interface ParagraphAnchorIndex {
     /** nodeId → `w14:paraId`, verbatim as authored/minted. Paragraphs without one are absent. */
     readonly paraIdByNode: ReadonlyMap<string, string>;
-    /** UPPERCASED paraId → nodeId (matching is case-insensitive). First occurrence wins on the impossible-by-invariant duplicate. */
+    /** UPPERCASED paraId → nodeId (matching is case-insensitive). The first story to claim it. */
     readonly nodeByParaId: ReadonlyMap<string, string>;
     /** nodeId → reading-order ordinal, for document-ordering DocRange endpoints. */
     readonly ordinalByNode: ReadonlyMap<string, number>;
+    /**
+     * UPPERCASED paraIds more than one story claims.
+     *
+     * Minting is unique per PART and the contract's uniqueness is per DOCUMENT, so an authored
+     * file may repeat one. Resolving such an anchor to whichever story came first would be a
+     * silent wrong answer; it is refused as ambiguous instead.
+     */
+    readonly ambiguousParaIds: ReadonlySet<string>;
+    /**
+     * nodeId → the part it was indexed from.
+     *
+     * The index spans every story, so a caller holding one part and a node id from another reads
+     * an empty paragraph and draws a false conclusion from it. Carrying the part alongside the id
+     * is what keeps the two in step.
+     */
+    readonly partByNode: ReadonlyMap<string, OoxmlPart>;
+    /**
+     * Every node claiming an ambiguous paraId. DIAGNOSTIC, never a way to pick one.
+     *
+     * Resolution refuses a clash outright, and this is what says which paragraphs caused it, for
+     * a reader repairing the file. Preferring one claimant by the caller's part was tried and
+     * reverted: every resolver call site passes the MAIN part, so the preference could only ever
+     * land on the body twin and answer `ok` for a header paragraph the caller meant. See
+     * `resolveDocAnchor` in `editor/anchor-resolution.ts`.
+     */
+    readonly claimantsByParaId: ReadonlyMap<string, readonly string[]>;
 }
 
 /**
@@ -238,6 +263,15 @@ interface TreeDocxSessionView {
      * and one undo unit without swapping the body store.
      */
     applyTreeOps(ops: readonly TreeDocOp[], selectionBefore?: SelectionMark | null, selectionAfter?: SelectionMark | null, scope?: StoryScope): TreeApplyResult;
+    /**
+     * Every part that holds a story, body first, then headers, footers and note parts.
+     *
+     * A READ: parts come from the package, so this opens no story store and spends none of the
+     * 64 editable-store slots. Use it for any query that must answer about the whole document
+     * rather than about the caret — an enumeration that reads only the body reports a document
+     * the reader is not looking at.
+     */
+    storyParts(): readonly OoxmlPart[];
     /** Body text, paragraphs joined by newlines, read from the CANONICAL tree. */
     bodyText(): string;
     /** Text of a story scope, paragraphs joined by newlines. */
@@ -300,17 +334,9 @@ interface TreeDocxSessionView {
      * empty paragraph — a declaration with no glyph behind it.
      */
     rendersText(): boolean;
-    /**
-     * The `w:style` definitions of the styles part, validated and projected for a style
-     * picker. Memoized once: the styles part is immutable for the session's lifetime.
-     * A document without a styles part answers `[]`.
-     */
+    /** Validated style-picker projection. A document without styles answers `[]`. */
     documentStyles(): readonly DocumentStyleEntry[];
-    /**
-     * Root of the styles part tree, for layout's style cascade. Memoized once; `null` when
-     * the package has no styles part. Styles editing is a later slice, so this is immutable
-     * for the session.
-     */
+    /** Current styles root for layout, or `null` when the package has no styles part. */
     stylesRoot(): OoxmlElement | null;
     /**
      * The theme part's Latin typefaces, for resolving `w:rFonts` theme references in layout.

package/dist/{tree-store-Dy9FZ1pa.d.ts → tree-store-C6vc8E_2.d.cts}

@@ -1,6 +1,5 @@
-import { e as OoxmlPart } from './ooxml-tree-BU0e3DVi.js';
-import { O as OoxmlPackage } from './ooxml-package-D_CtywTW.js';
-import { I as ImpactClass, T as TreeDocOp, a as TreeOpRejection } from './tree-op-types-fZgbrR5F.js';
+import { O as OoxmlPart, c as OoxmlPackage } from './ooxml-package-CdEy9ufK.cjs';
+import { I as ImpactClass, T as TreeDocOp, a as TreeOpRejection } from './tree-op-types-B0-sCtw-.cjs';
 
 /**
  * The document metadata Word's document-property fields render.
@@ -166,6 +165,16 @@ interface HistoryEntry {
 interface TreeDocumentStoreOptions {
     /** Bound on retained history entries. Oldest entries drop first. */
     readonly historyLimit?: number;
+    /**
+     * The document's `settings.xml`, for a store built from a PART rather than a package.
+     *
+     * Forms protection lives one part up from the op, and a store built from a part gets a
+     * synthetic one-part package that cannot see it — so `w:documentProtection w:edit="forms"`
+     * was enforced in the body and nowhere else, and a header, a footer or a note accepted every
+     * write a protected document is supposed to refuse. Read through a getter, not captured: a
+     * document can gain or lose protection while its stories stay open.
+     */
+    readonly settingsPart?: () => OoxmlPart | null | undefined;
 }
 /**
  * Opaque document+history checkpoint for package-coordinator rollback.
@@ -205,6 +214,8 @@ declare class TreeDocumentStore {
     private readonly redoStack;
     private readonly subscribers;
     private readonly historyLimit;
+    /** See {@link TreeDocumentStoreOptions.settingsPart}. */
+    private readonly settingsPartOverride;
     /** Package-aware story tag applied to publishes (including undo/redo). */
     private storyRef;
     /** Open composition, if any. While set, transactions extend one entry (task 5.5). */

package/dist/{tree-store-DhYIACNE.d.cts → tree-store-ClA-qng4.d.ts}

@@ -1,6 +1,5 @@
-import { e as OoxmlPart } from './ooxml-tree-BU0e3DVi.cjs';
-import { O as OoxmlPackage } from './ooxml-package-CR5us6ad.cjs';
-import { I as ImpactClass, T as TreeDocOp, a as TreeOpRejection } from './tree-op-types-QujrzgCz.cjs';
+import { O as OoxmlPart, c as OoxmlPackage } from './ooxml-package-CdEy9ufK.js';
+import { I as ImpactClass, T as TreeDocOp, a as TreeOpRejection } from './tree-op-types-XMVsJSpe.js';
 
 /**
  * The document metadata Word's document-property fields render.
@@ -166,6 +165,16 @@ interface HistoryEntry {
 interface TreeDocumentStoreOptions {
     /** Bound on retained history entries. Oldest entries drop first. */
     readonly historyLimit?: number;
+    /**
+     * The document's `settings.xml`, for a store built from a PART rather than a package.
+     *
+     * Forms protection lives one part up from the op, and a store built from a part gets a
+     * synthetic one-part package that cannot see it — so `w:documentProtection w:edit="forms"`
+     * was enforced in the body and nowhere else, and a header, a footer or a note accepted every
+     * write a protected document is supposed to refuse. Read through a getter, not captured: a
+     * document can gain or lose protection while its stories stay open.
+     */
+    readonly settingsPart?: () => OoxmlPart | null | undefined;
 }
 /**
  * Opaque document+history checkpoint for package-coordinator rollback.
@@ -205,6 +214,8 @@ declare class TreeDocumentStore {
     private readonly redoStack;
     private readonly subscribers;
     private readonly historyLimit;
+    /** See {@link TreeDocumentStoreOptions.settingsPart}. */
+    private readonly settingsPartOverride;
     /** Package-aware story tag applied to publishes (including undo/redo). */
     private storyRef;
     /** Open composition, if any. While set, transactions extend one entry (task 5.5). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docx-editor.dev/core",
-  "version": "2.7.0",
+  "version": "2.9.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",
   "exports": {
@@ -86,7 +86,7 @@
     "directory": "packages/core"
   },
   "dependencies": {
-    "@docx-editor.dev/i18n": "^2.7.0",
+    "@docx-editor.dev/i18n": "^2.9.0",
     "bidi-js": "1.0.3",
     "emf-converter": "2.0.2",
     "fast-xml-parser": "^5.10.1",