@docx-editor.dev/core 2.6.1 → 2.8.0

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-BZEJL3vv.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-CWlj33GH.cjs';
 import './document.cjs';
 import './types.cjs';
-import '../review-support-T-riLz4Y.cjs';
+import '../review-support-CG7aVSPh.cjs';
 import '../ooxml-tree-BU0e3DVi.cjs';
-import '../tree-op-types-CUCwPWjT.cjs';
-import '../semantic-interaction-CDNEU_Tx.cjs';
-import '../semantic-records-DEOs3_tE.cjs';
-import '../image-resources-BaHz4QAd.cjs';
+import '../tree-op-types-A-SLSKzK.cjs';
+import '../semantic-interaction-DVUqu_47.cjs';
+import '../semantic-records-rAKWaD-1.cjs';
+import '../image-resources-BveffuKp.cjs';
 import '../ooxml-package-CR5us6ad.cjs';
 import '../revision-projection-WzlQGBJx.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-D2zOJztO.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-D52SD4jG.js';
 import './document.js';
 import './types.js';
-import '../review-support-D4ZBdUXa.js';
+import '../review-support--I4ChuzF.js';
 import '../ooxml-tree-BU0e3DVi.js';
-import '../tree-op-types-D0fTNBVW.js';
-import '../semantic-interaction-lvpzZRpA.js';
-import '../semantic-records-CdQvpUj1.js';
-import '../image-resources-Cl5_cNi9.js';
+import '../tree-op-types-BbzrA-kg.js';
+import '../semantic-interaction-Bu_3IPaV.js';
+import '../semantic-records-DHcMZM2-.js';
+import '../image-resources-D63k8w5f.js';
 import '../ooxml-package-D_CtywTW.js';
 import '../revision-projection-UKqvPa4-.js';

package/dist/contracts/modules.d.cts

@@ -1,8 +1,9 @@
 import { e as OoxmlPart } from '../ooxml-tree-BU0e3DVi.cjs';
-export { R as RevisionAddress } from '../tree-op-types-CUCwPWjT.cjs';
+export { R as RevisionAddress } from '../tree-op-types-A-SLSKzK.cjs';
 import { R as RevisionDisplayMode } from '../revision-projection-WzlQGBJx.cjs';
-import { R as ReviewModelInput, a as ReviewItem, b as ReviewRevisionItem } from '../review-support-T-riLz4Y.cjs';
-export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, e as ReviewPosition, f as ReviewRange, g as ReviewRevisionKind } from '../review-support-T-riLz4Y.cjs';
+import { R as ReviewModelInput, a as ReviewItem, b as ReviewRevisionItem } from '../review-support-CG7aVSPh.cjs';
+export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, e as ReviewPosition, f as ReviewRange, g as ReviewRevisionKind } from '../review-support-CG7aVSPh.cjs';
+import './types.cjs';
 
 /**
  * `@docx-editor.dev/core/contracts/modules` — the `EditorModule` seam.

package/dist/contracts/modules.d.ts

@@ -1,8 +1,9 @@
 import { e as OoxmlPart } from '../ooxml-tree-BU0e3DVi.js';
-export { R as RevisionAddress } from '../tree-op-types-D0fTNBVW.js';
+export { R as RevisionAddress } from '../tree-op-types-BbzrA-kg.js';
 import { R as RevisionDisplayMode } from '../revision-projection-UKqvPa4-.js';
-import { R as ReviewModelInput, a as ReviewItem, b as ReviewRevisionItem } from '../review-support-D4ZBdUXa.js';
-export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, e as ReviewPosition, f as ReviewRange, g as ReviewRevisionKind } from '../review-support-D4ZBdUXa.js';
+import { R as ReviewModelInput, a as ReviewItem, b as ReviewRevisionItem } from '../review-support--I4ChuzF.js';
+export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, e as ReviewPosition, f as ReviewRange, g as ReviewRevisionKind } from '../review-support--I4ChuzF.js';
+import './types.js';
 
 /**
  * `@docx-editor.dev/core/contracts/modules` — the `EditorModule` seam.

package/dist/contracts/types.d.cts

@@ -4,6 +4,66 @@
  * `@docx-editor.dev/core/contracts/types` re-exports this module verbatim, through
  * `types-barrel.ts`. There is no `@docx-editor.dev/core/types` subpath.
  */
+/** Which paragraph-level reads the selection disagrees about. @public */
+interface ParagraphDisagreements {
+    readonly alignment: boolean;
+    readonly spaceBeforePt: boolean;
+    readonly spaceAfterPt: boolean;
+    readonly lineSpacing: boolean;
+    readonly tabStops: boolean;
+}
+/**
+ * The five paragraph flags a Paragraph dialog shows as checkboxes.
+ *
+ * `contextualSpacing` is Word's "Don't add space between paragraphs of the same style";
+ * the rest are its Pagination block. `null` means the selection disagrees.
+ *
+ * @public
+ */
+interface ParagraphFlags {
+    readonly contextualSpacing: boolean | null;
+    readonly keepNext: boolean | null;
+    readonly keepLines: boolean | null;
+    readonly widowControl: boolean | null;
+    readonly pageBreakBefore: boolean | null;
+}
+/**
+ * Every field of the Paragraph dialog, as `setParagraphFormat` takes it.
+ *
+ * An omitted field is left as authored. `null` REMOVES a setting so the style supplies it
+ * again — not the same as a zero, which blocks the cascade.
+ *
+ * @public
+ */
+interface ParagraphFormatCommand {
+    alignment?: 'left' | 'center' | 'right' | 'justify';
+    spaceBeforePt?: number | null;
+    spaceAfterPt?: number | null;
+    lineSpacing?: {
+        rule: 'multiple' | 'exact' | 'atLeast';
+        value: number;
+    } | null;
+    indentLeftTwips?: number | null;
+    indentRightTwips?: number | null;
+    /** ONE signed first-line offset: negative is a hanging indent. */
+    indentFirstLineTwips?: number | null;
+    contextualSpacing?: boolean;
+    keepNext?: boolean;
+    keepLines?: boolean;
+    widowControl?: boolean;
+    pageBreakBefore?: boolean;
+    /**
+     * Replace the paragraph's custom tab stops. An empty list CLEARS them, which is what
+     * "Clear All" does; omit the field to leave them as authored.
+     */
+    tabStops?: readonly ParagraphTabStop[];
+}
+/** One custom tab stop, as a command states it. @public */
+interface ParagraphTabStop {
+    readonly positionTwips: number;
+    readonly alignment: 'left' | 'center' | 'right' | 'decimal' | 'bar';
+    readonly leader?: 'none' | 'dot' | 'hyphen' | 'underscore' | 'heavy' | 'middleDot';
+}
 /** Ownership token for one retained selection highlight. @public */
 type SelectionPin = symbol;
 /**
@@ -174,9 +234,41 @@ interface RunFormatting {
         readonly rule: 'multiple' | 'exact' | 'atLeast';
         readonly value: number;
     };
-    /** Space above and below the paragraph at the selection, in points. */
+    /**
+     * Space above and below the paragraph at the selection, in points.
+     *
+     * The measurement the cascade STATES — `w:docDefaults`, the style chain and direct
+     * formatting resolved together — not the gap the page finally draws. The two differ for a
+     * paragraph carrying `w:beforeAutospacing`, where Word substitutes its own value and
+     * ignores the measurement, and again where two paragraphs collapse their adjacent spacing.
+     * Absent when the selection's paragraphs disagree or no level states it.
+     */
     readonly spaceBeforePt?: number;
     readonly spaceAfterPt?: number;
+    /**
+     * The paragraph flags the Paragraph dialog shows as checkboxes.
+     *
+     * Each is `true`, `false`, or `null` when the selection's paragraphs disagree — a
+     * checkbox needs all three. Read through the cascade, so a flag a STYLE sets reads as on,
+     * which is what the box has to show over a paragraph the page is visibly keeping with the
+     * next. Absent on a `Run`, like every other selection-level field here.
+     */
+    readonly paragraphFlags?: ParagraphFlags;
+    /**
+     * Which paragraph-level fields above are absent because the selection DISAGREES, as
+     * opposed to because nothing states them.
+     *
+     * A `null`/absent value alone cannot tell those apart, and both readings have shipped as
+     * bugs: a disagreement rendered as a concrete value is uncorrectable, because the value
+     * that would fix it is the one already on screen; an absent value rendered as "mixed"
+     * tells a single paragraph it disagrees with itself.
+     */
+    readonly disagrees?: ParagraphDisagreements;
+    /**
+     * The paragraph's custom tab stops at the selection, cascade included. Absent when the
+     * selection disagrees or the paragraphs have none.
+     */
+    readonly tabStops?: readonly ParagraphTabStop[];
     /**
      * The EFFECTIVE paragraph indent at the selection — cascade and numbering merge
      * included, so a numbered item that authors no `w:ind` reports the indent its list
@@ -250,6 +342,22 @@ interface ContentControl {
 }
 /** Which kind of control a `w:sdt` is, and therefore what a value written into it must be. */
 type ContentControlType = 'richText' | 'plainText' | 'checkbox' | 'dropdown' | 'comboBox' | 'date' | 'picture' | 'repeatingSection';
+/**
+ * The control kinds an insertion can author.
+ *
+ * A NARROWING of {@link ContentControlType}, not a separate vocabulary: a kind read off an
+ * existing control can be handed straight back to `insertContentControl`. Three kinds are
+ * absent because an insertion would have to invent what they carry — a checkbox needs its two
+ * declared glyph states, a picture needs an image part, and a repeating section is a container
+ * whose items have their own verbs. Reading still answers the wider type; a document may hold
+ * kinds this cannot create.
+ *
+ * `dropDownList` is the same kind as `dropdown`, spelt as OOXML spells it. Both are accepted,
+ * so a type read off a control can be handed back without translating it — and the OOXML
+ * spelling is the one the automation protocol takes, so a caller who uses both surfaces can
+ * write that one everywhere.
+ */
+type InsertableContentControlType = Extract<ContentControlType, 'richText' | 'plainText' | 'dropdown' | 'comboBox' | 'date'> | 'dropDownList';
 /**
  * Narrows a content-control query. Fields combine with AND; an empty filter matches every
  * control.
@@ -451,4 +559,4 @@ interface Point {
 /** What every subscription returns. Calling it twice is safe. */
 type Unsubscribe = () => void;
 
-export type { Block, ColorValue, ContainerRef, ContentControl, ContentControlFilter, ContentControlType, DocAnchor, DocAnchorRange, DocComment, DocLocation, DocRange, DocTarget, DocumentBody, DocxDocument, DocxDocumentJSON, ExecErrorCode, ExecResult, Extent, FontDefinition, HeaderFooterSet, IndentFormatting, NumberingRef, PageMargins, Paragraph, Point, Rect, Revision, RevisionType, Run, RunFormatting, Section, SectionProperties, SelectionPin, StyleDefinition, StyleDefinitions, Table, TableCell, TableRow, Theme, ThemeColorScheme, Unsubscribe, Watermark };
+export type { 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 };

package/dist/contracts/types.d.ts

@@ -4,6 +4,66 @@
  * `@docx-editor.dev/core/contracts/types` re-exports this module verbatim, through
  * `types-barrel.ts`. There is no `@docx-editor.dev/core/types` subpath.
  */
+/** Which paragraph-level reads the selection disagrees about. @public */
+interface ParagraphDisagreements {
+    readonly alignment: boolean;
+    readonly spaceBeforePt: boolean;
+    readonly spaceAfterPt: boolean;
+    readonly lineSpacing: boolean;
+    readonly tabStops: boolean;
+}
+/**
+ * The five paragraph flags a Paragraph dialog shows as checkboxes.
+ *
+ * `contextualSpacing` is Word's "Don't add space between paragraphs of the same style";
+ * the rest are its Pagination block. `null` means the selection disagrees.
+ *
+ * @public
+ */
+interface ParagraphFlags {
+    readonly contextualSpacing: boolean | null;
+    readonly keepNext: boolean | null;
+    readonly keepLines: boolean | null;
+    readonly widowControl: boolean | null;
+    readonly pageBreakBefore: boolean | null;
+}
+/**
+ * Every field of the Paragraph dialog, as `setParagraphFormat` takes it.
+ *
+ * An omitted field is left as authored. `null` REMOVES a setting so the style supplies it
+ * again — not the same as a zero, which blocks the cascade.
+ *
+ * @public
+ */
+interface ParagraphFormatCommand {
+    alignment?: 'left' | 'center' | 'right' | 'justify';
+    spaceBeforePt?: number | null;
+    spaceAfterPt?: number | null;
+    lineSpacing?: {
+        rule: 'multiple' | 'exact' | 'atLeast';
+        value: number;
+    } | null;
+    indentLeftTwips?: number | null;
+    indentRightTwips?: number | null;
+    /** ONE signed first-line offset: negative is a hanging indent. */
+    indentFirstLineTwips?: number | null;
+    contextualSpacing?: boolean;
+    keepNext?: boolean;
+    keepLines?: boolean;
+    widowControl?: boolean;
+    pageBreakBefore?: boolean;
+    /**
+     * Replace the paragraph's custom tab stops. An empty list CLEARS them, which is what
+     * "Clear All" does; omit the field to leave them as authored.
+     */
+    tabStops?: readonly ParagraphTabStop[];
+}
+/** One custom tab stop, as a command states it. @public */
+interface ParagraphTabStop {
+    readonly positionTwips: number;
+    readonly alignment: 'left' | 'center' | 'right' | 'decimal' | 'bar';
+    readonly leader?: 'none' | 'dot' | 'hyphen' | 'underscore' | 'heavy' | 'middleDot';
+}
 /** Ownership token for one retained selection highlight. @public */
 type SelectionPin = symbol;
 /**
@@ -174,9 +234,41 @@ interface RunFormatting {
         readonly rule: 'multiple' | 'exact' | 'atLeast';
         readonly value: number;
     };
-    /** Space above and below the paragraph at the selection, in points. */
+    /**
+     * Space above and below the paragraph at the selection, in points.
+     *
+     * The measurement the cascade STATES — `w:docDefaults`, the style chain and direct
+     * formatting resolved together — not the gap the page finally draws. The two differ for a
+     * paragraph carrying `w:beforeAutospacing`, where Word substitutes its own value and
+     * ignores the measurement, and again where two paragraphs collapse their adjacent spacing.
+     * Absent when the selection's paragraphs disagree or no level states it.
+     */
     readonly spaceBeforePt?: number;
     readonly spaceAfterPt?: number;
+    /**
+     * The paragraph flags the Paragraph dialog shows as checkboxes.
+     *
+     * Each is `true`, `false`, or `null` when the selection's paragraphs disagree — a
+     * checkbox needs all three. Read through the cascade, so a flag a STYLE sets reads as on,
+     * which is what the box has to show over a paragraph the page is visibly keeping with the
+     * next. Absent on a `Run`, like every other selection-level field here.
+     */
+    readonly paragraphFlags?: ParagraphFlags;
+    /**
+     * Which paragraph-level fields above are absent because the selection DISAGREES, as
+     * opposed to because nothing states them.
+     *
+     * A `null`/absent value alone cannot tell those apart, and both readings have shipped as
+     * bugs: a disagreement rendered as a concrete value is uncorrectable, because the value
+     * that would fix it is the one already on screen; an absent value rendered as "mixed"
+     * tells a single paragraph it disagrees with itself.
+     */
+    readonly disagrees?: ParagraphDisagreements;
+    /**
+     * The paragraph's custom tab stops at the selection, cascade included. Absent when the
+     * selection disagrees or the paragraphs have none.
+     */
+    readonly tabStops?: readonly ParagraphTabStop[];
     /**
      * The EFFECTIVE paragraph indent at the selection — cascade and numbering merge
      * included, so a numbered item that authors no `w:ind` reports the indent its list
@@ -250,6 +342,22 @@ interface ContentControl {
 }
 /** Which kind of control a `w:sdt` is, and therefore what a value written into it must be. */
 type ContentControlType = 'richText' | 'plainText' | 'checkbox' | 'dropdown' | 'comboBox' | 'date' | 'picture' | 'repeatingSection';
+/**
+ * The control kinds an insertion can author.
+ *
+ * A NARROWING of {@link ContentControlType}, not a separate vocabulary: a kind read off an
+ * existing control can be handed straight back to `insertContentControl`. Three kinds are
+ * absent because an insertion would have to invent what they carry — a checkbox needs its two
+ * declared glyph states, a picture needs an image part, and a repeating section is a container
+ * whose items have their own verbs. Reading still answers the wider type; a document may hold
+ * kinds this cannot create.
+ *
+ * `dropDownList` is the same kind as `dropdown`, spelt as OOXML spells it. Both are accepted,
+ * so a type read off a control can be handed back without translating it — and the OOXML
+ * spelling is the one the automation protocol takes, so a caller who uses both surfaces can
+ * write that one everywhere.
+ */
+type InsertableContentControlType = Extract<ContentControlType, 'richText' | 'plainText' | 'dropdown' | 'comboBox' | 'date'> | 'dropDownList';
 /**
  * Narrows a content-control query. Fields combine with AND; an empty filter matches every
  * control.
@@ -451,4 +559,4 @@ interface Point {
 /** What every subscription returns. Calling it twice is safe. */
 type Unsubscribe = () => void;
 
-export type { Block, ColorValue, ContainerRef, ContentControl, ContentControlFilter, ContentControlType, DocAnchor, DocAnchorRange, DocComment, DocLocation, DocRange, DocTarget, DocumentBody, DocxDocument, DocxDocumentJSON, ExecErrorCode, ExecResult, Extent, FontDefinition, HeaderFooterSet, IndentFormatting, NumberingRef, PageMargins, Paragraph, Point, Rect, Revision, RevisionType, Run, RunFormatting, Section, SectionProperties, SelectionPin, StyleDefinition, StyleDefinitions, Table, TableCell, TableRow, Theme, ThemeColorScheme, Unsubscribe, Watermark };
+export type { 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 };

package/dist/{custom-node-writes-tJw8U9MO.d.ts → custom-node-writes-BdVl-LAC.d.ts}

@@ -1,10 +1,10 @@
 import { e as OoxmlPart, O as OoxmlNode } from './ooxml-tree-BU0e3DVi.js';
 import { O as OoxmlPackage } from './ooxml-package-D_CtywTW.js';
-import { S as SupportedImageMime, b as ImageDecodePort } from './image-resources-Cl5_cNi9.js';
-import { h as DrawingTreeDocOp, a as TreeOpRejection, T as TreeDocOp } from './tree-op-types-D0fTNBVW.js';
+import { S as SupportedImageMime, b as ImageDecodePort } from './image-resources-D63k8w5f.js';
+import { h as DrawingTreeDocOp, a as TreeOpRejection, T as TreeDocOp } from './tree-op-types-BbzrA-kg.js';
 import { c as HeaderFooterKind, H as HeaderFooterVariant } from './hf-references-BdjsQNE_.js';
 import { N as NoteKind } from './note-nodes-BPSTVDMr.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-CIKASRHk.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-CKswbQl3.js';
 
 /** A freshly allocated drawing property id, or the reason one could not be minted. */
 type DrawingPropertyIdResult = {
@@ -284,12 +284,6 @@ 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. Bounded by visited nodes; skips deep
- * hostile nesting by marking the shared budget truncated. 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;
@@ -622,8 +616,12 @@ declare class TreePackageStore {
     redo(): TreeModelChange | null;
     selectionForUndo(): SelectionMark | null;
     selectionForRedo(): SelectionMark | null;
+    /** See {@link openStoryPartsOf}. */
+    openStoryParts(): readonly OoxmlPart[];
     /** How many story stores are open (body counts as one). */
     openedStoryCount(): number;
+    /** See {@link openStoryTokenOf}. */
+    openStoryToken(): string;
     /**
      * Insert a validated raster image as one package undo unit (task 12).
      */
@@ -876,7 +874,18 @@ interface CustomNodePayloadRead {
  * Every store the story relates to, so a document carrying two definitions' payloads answers
  * for both without anyone naming a namespace.
  */
-declare function customNodePayloadsByControl(pkg: OoxmlPackage, storyPartName: string): ReadonlyMap<string, CustomNodePayloadRead>;
+declare function customNodePayloadsByControl(pkg: OoxmlPackage, storyPartName: string, 
+/**
+ * The part that RELATES the customXml store, when it is not the story's own.
+ *
+ * Two different questions wear one name here: which part holds the CONTROLS, and which part
+ * relates the STORE they bind into. Word only reads a store hung off the main document part,
+ * so {@link writeCustomNode} already takes them separately — this read did not, and answered
+ * with the body's controls whatever story it was asked about. A chip in a header therefore
+ * read as having no payload at all, and an update that meant to keep the existing data
+ * dropped it.
+ */
+dataOwnerPartName?: string): ReadonlyMap<string, CustomNodePayloadRead>;
 /** Every payload one store holds, for a caller resolving a control's `data`. */
 declare function customNodePayloadsOf(pkg: OoxmlPackage, storyPartName: string, namespaceUri: string): ReadonlyMap<string, {
     readonly label: string;

package/dist/{custom-node-writes-D9G3GKQ7.d.cts → custom-node-writes-Bu8JIqfA.d.cts}

@@ -1,10 +1,10 @@
 import { e as OoxmlPart, O as OoxmlNode } from './ooxml-tree-BU0e3DVi.cjs';
 import { O as OoxmlPackage } from './ooxml-package-CR5us6ad.cjs';
-import { S as SupportedImageMime, b as ImageDecodePort } from './image-resources-BaHz4QAd.cjs';
-import { h as DrawingTreeDocOp, a as TreeOpRejection, T as TreeDocOp } from './tree-op-types-CUCwPWjT.cjs';
+import { S as SupportedImageMime, b as ImageDecodePort } from './image-resources-BveffuKp.cjs';
+import { h as DrawingTreeDocOp, a as TreeOpRejection, T as TreeDocOp } from './tree-op-types-A-SLSKzK.cjs';
 import { c as HeaderFooterKind, H as HeaderFooterVariant } from './hf-references-CgEOSw3i.cjs';
 import { N as NoteKind } from './note-nodes-C6DLxlvj.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-BqgeCa1Q.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-Dob9Us6Y.cjs';
 
 /** A freshly allocated drawing property id, or the reason one could not be minted. */
 type DrawingPropertyIdResult = {
@@ -284,12 +284,6 @@ 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. Bounded by visited nodes; skips deep
- * hostile nesting by marking the shared budget truncated. 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;
@@ -622,8 +616,12 @@ declare class TreePackageStore {
     redo(): TreeModelChange | null;
     selectionForUndo(): SelectionMark | null;
     selectionForRedo(): SelectionMark | null;
+    /** See {@link openStoryPartsOf}. */
+    openStoryParts(): readonly OoxmlPart[];
     /** How many story stores are open (body counts as one). */
     openedStoryCount(): number;
+    /** See {@link openStoryTokenOf}. */
+    openStoryToken(): string;
     /**
      * Insert a validated raster image as one package undo unit (task 12).
      */
@@ -876,7 +874,18 @@ interface CustomNodePayloadRead {
  * Every store the story relates to, so a document carrying two definitions' payloads answers
  * for both without anyone naming a namespace.
  */
-declare function customNodePayloadsByControl(pkg: OoxmlPackage, storyPartName: string): ReadonlyMap<string, CustomNodePayloadRead>;
+declare function customNodePayloadsByControl(pkg: OoxmlPackage, storyPartName: string, 
+/**
+ * The part that RELATES the customXml store, when it is not the story's own.
+ *
+ * Two different questions wear one name here: which part holds the CONTROLS, and which part
+ * relates the STORE they bind into. Word only reads a store hung off the main document part,
+ * so {@link writeCustomNode} already takes them separately — this read did not, and answered
+ * with the body's controls whatever story it was asked about. A chip in a header therefore
+ * read as having no payload at all, and an update that meant to keep the existing data
+ * dropped it.
+ */
+dataOwnerPartName?: string): ReadonlyMap<string, CustomNodePayloadRead>;
 /** Every payload one store holds, for a caller resolving a control's `data`. */
 declare function customNodePayloadsOf(pkg: OoxmlPackage, storyPartName: string, namespaceUri: string): ReadonlyMap<string, {
     readonly label: string;