@docx-editor.dev/core 2.5.0 → 2.6.0

package/dist/{tree-op-types-CZw9QhWX.d.ts → tree-op-types-D0fTNBVW.d.ts}

@@ -1,221 +1,4 @@
-import { b as OoxmlContentControlNode, O as OoxmlNode, d as OoxmlContentControlContentNode, o as OoxmlContentControlEndPropertiesNode, p as OoxmlContentControlPropertiesNode, a as OoxmlElement, q as OoxmlDrawingNode, e as OoxmlPart } from './ooxml-tree-CG0odFyi.js';
-
-/** How deep controls may nest before a walk stops descending. Shared by every lane. */
-declare const MAX_CONTENT_CONTROL_NESTING = 32;
-/** Cap on controls one walk reports, so a hostile file cannot make a read unbounded. */
-declare const MAX_CONTENT_CONTROLS_PER_PART = 10000;
-/** `CT_SdtPr/w:id` is `ST_DecimalNumber`; Word treats it as a signed 32-bit integer. */
-declare const CONTENT_CONTROL_ID_MAX = 2147483647;
-/** `ST_Lock` (§17.5.2.24). An absent `w:lock` is `unlocked`. */
-/**
- * `w:lock` — what a control refuses.
- *
- * `sdtLocked` protects the wrapper, `contentLocked` the text inside it, and `sdtContentLocked`
- * both. A control inside a locked one is locked in effect regardless of its own value.
- */
-type ContentControlLock = 'unlocked' | 'sdtLocked' | 'contentLocked' | 'sdtContentLocked';
-/**
- * What kind of control this is.
- *
- * `checkbox` is the Microsoft `w14:checkbox` extension rather than an ECMA-376 type
- * element, and the two are not mutually exclusive with "declares no type": four controls
- * in the comprehensive fixture declare the extension and no `w:`-prefixed type, so a scan
- * that read only the ECMA-376 choice reported them untyped. `untyped` means the control
- * declares neither — a rich-text container, which is what Word treats it as.
- */
-/** Which kind of control a `w:sdt` is, and therefore what a written value must look like. */
-type ContentControlKind = 'richText' | 'plainText' | 'checkbox' | 'dropDownList' | 'comboBox' | 'date' | 'picture' | 'docPartObj' | 'docPartList' | 'group' | 'citation' | 'bibliography' | 'equation' | 'untyped';
-/** One declared option of a dropdown or combo box: its display text and its stored value. */
-interface ContentControlListItem {
-    readonly displayText: string;
-    readonly value: string;
-}
-/** A date picker's authored format and locale, for rendering and for parsing what it stores. */
-interface ContentControlDateFormat {
-    readonly fullDate?: string;
-    readonly dateFormat?: string;
-    readonly lid?: string;
-    readonly storeMappedDataAs?: string;
-    readonly calendar?: string;
-}
-/** One of a checkbox's two glyphs: the font and code point it is drawn with. */
-interface ContentControlCheckboxState {
-    /** The `w14:val` hex code point of the glyph, exactly as the control declares it. */
-    readonly value: string;
-    readonly font?: string;
-}
-/**
- * A checkbox's state and the two glyphs it chooses between.
- *
- * Both glyphs matter on a write: setting the value has to update `w14:checked` AND the run's
- * character, or the document's glyph and its recorded state disagree.
- */
-interface ContentControlCheckbox {
-    readonly checked: boolean;
-    readonly checkedState?: ContentControlCheckboxState;
-    readonly uncheckedState?: ContentControlCheckboxState;
-}
-/** `CT_DataBinding` — preserved metadata. Never resolved, never fetched. */
-/** `w:dataBinding` — the custom-XML part and XPath a control's value is bound to. */
-interface ContentControlDataBinding {
-    readonly xpath?: string;
-    readonly storeItemID?: string;
-    readonly prefixMappings?: string;
-}
-/**
- * A control's whole `w:sdtPr`, projected into one typed shape.
- *
- * What every other lane reads instead of walking `localName` strings — which also means a Word
- * re-save that demotes the properties node to generic does not break the projection.
- */
-interface ContentControlProperties {
-    readonly type: ContentControlKind;
-    readonly alias?: string;
-    readonly tag?: string;
-    /** `@w:val` of `w:id` when the file declares a parseable one. Never fabricated. */
-    readonly id?: number;
-    readonly lock: ContentControlLock;
-    /** The glossary entry named by `w:placeholder/w:docPart`. Preserved, never loaded. */
-    readonly placeholderDocPart?: string;
-    readonly temporary: boolean;
-    readonly showingPlaceholder: boolean;
-    readonly dataBinding?: ContentControlDataBinding;
-    readonly label?: string;
-    readonly tabIndex?: number;
-    /** Items a dropdown or combo box offers. Empty for every other type. */
-    readonly listItems: readonly ContentControlListItem[];
-    readonly lastValue?: string;
-    readonly date?: ContentControlDateFormat;
-    readonly multiLine?: boolean;
-    readonly checkbox?: ContentControlCheckbox;
-}
-/** Whether a node is a `w:sdt` wrapper. */
-declare function isContentControlNode(node: OoxmlNode): node is OoxmlContentControlNode;
-/** Whether a node is a `w:sdtContent` — the container holding a control's actual content. */
-declare function isContentControlContentNode(node: OoxmlNode): node is OoxmlContentControlContentNode;
-/**
- * A `w:sdt` wrapper, TYPED or DEMOTED.
- *
- * Flattening predates typing and must not stop at a control the reader refused to type: a
- * demoted wrapper still renders its content in place in Word, so a walk that only saw the
- * typed kind would drop every paragraph inside a malformed control out of the story.
- */
-declare function isContentControlWrapper(node: OoxmlNode): boolean;
-/**
- * The children of a wrapper's `w:sdtContent`, typed or demoted, in order.
- *
- * The one place that knows a control's content is reached through an intermediate element,
- * so the four flattening walks (story blocks, layout, header/footer references, list
- * resolution) ask the same question rather than each re-deriving it.
- */
-declare function contentControlContentChildren(wrapper: OoxmlNode): readonly OoxmlNode[];
-/**
- * A container's children with every content-control wrapper flattened away, bounded in depth.
- *
- * ONE unwrap rule, for the places where a control sits between a container and the children that
- * container is defined in terms of. `CT_SdtRow` puts it between `w:tbl` and `w:tr`, `CT_SdtCell`
- * between `w:tr` and `w:tc`, and a walk that filtered on the child's kind dropped the row or cell
- * entirely: not measured, not painted, not addressable. Flattening at the point of the filter
- * means a controlled row is the same row to the grid pass, the pagination pass and the story walk.
- *
- * Returns the SAME array identity when there is nothing to unwrap, so the tables that carry no
- * controls — nearly all of them — allocate nothing and the incremental layout cache still sees
- * its own inputs.
- */
-declare function flattenContentControls(children: readonly OoxmlNode[], maxDepth?: number): readonly OoxmlNode[];
-/** A control's `w:sdtPr`, or null. Matches structurally, so a Word-demoted node still resolves. */
-declare function contentControlPropertiesNodeOf(control: OoxmlNode): OoxmlContentControlPropertiesNode | undefined;
-/** A control's `w:sdtEndPr` — the run properties applied to its closing marker. */
-declare function contentControlEndPropertiesNodeOf(control: OoxmlNode): OoxmlContentControlEndPropertiesNode | undefined;
-/** A control's `w:sdtContent`, or null when the wrapper has none. */
-declare function contentControlContentNodeOf(control: OoxmlNode): OoxmlContentControlContentNode | undefined;
-/** A signed 32-bit `ST_DecimalNumber`, or undefined when the file wrote something else. */
-declare function parseContentControlId(raw: string | undefined): number | undefined;
-/**
- * Read a control's properties.
- *
- * Total: a control with no `w:sdtPr` at all answers the same shape with the defaults an
- * absent property means, so no caller has to branch on the container's existence.
- */
-declare function contentControlPropertiesOf(control: OoxmlNode): ContentControlProperties;
-/** Where a control sits, read off what its content holds. */
-type ContentControlLevel = 'block' | 'inline' | 'row' | 'cell' | 'empty';
-/**
- * How deeply a control is nested inside other controls.
- *
- * Bounded by {@link MAX_CONTENT_CONTROL_NESTING}: nesting depth comes from a file and is a
- * recursion bound.
- */
-declare function contentControlLevelOf(control: OoxmlNode): ContentControlLevel;
-/** One control, plus how deeply it is nested and the controls that enclose it. */
-interface ContentControlEntry {
-    readonly node: OoxmlContentControlNode;
-    /** 0 for a top-level control; the nesting depth otherwise. */
-    readonly depth: number;
-    /** Enclosing controls, outermost first. Empty at depth 0. */
-    readonly ancestors: readonly OoxmlContentControlNode[];
-}
-/**
- * Every control under a node, in document order, bounded in depth and in count.
- *
- * ONE walk, shared. The nesting bound is the same one layout flattens with, so a control
- * a lane can address is a control every lane can address — and a file that nests past it
- * keeps its content in the tree (the serializer never stops) while no walk recurses
- * further.
- */
-declare function contentControlsIn(root: OoxmlNode, options?: {
-    readonly maxDepth?: number;
-    readonly limit?: number;
-}): readonly ContentControlEntry[];
-/** Find one control by canonical node id, with the same bounded walk. */
-declare function findContentControl(root: OoxmlNode, nodeId: string): ContentControlEntry | null;
-/**
- * The plain text a control's content holds, in reading order.
- *
- * `w:delText` is excluded: struck text is not the control's value, and a dropdown whose
- * old item is still present as a tracked deletion would otherwise report both.
- */
-declare function contentControlTextOf(control: OoxmlNode): string;
-/**
- * Resolve the lock a position inherits from the controls enclosing it.
- *
- * CONSERVATIVE, because a template that says a field cannot be edited and sits inside a
- * section that says it cannot be removed means both. Each half of `ST_Lock` is taken
- * independently and the strongest wins, so an unlocked control inside a `contentLocked`
- * one is still content-locked — a nested control cannot grant a permission its parent
- * withheld, which is the only reading under which a lock is a lock.
- */
-declare function resolveContentControlLock(chain: readonly ContentControlLock[]): ContentControlLock;
-/** Whether a resolved lock forbids editing the content it covers. */
-declare function lockForbidsEdit(lock: ContentControlLock): boolean;
-/** Whether a resolved lock forbids removing the control itself. */
-declare function lockForbidsRemoval(lock: ContentControlLock): boolean;
-/**
- * `CT_SdtPr`'s declared child order (§17.5.2.38), followed by the type choice.
- *
- * Serialization re-emits children in tree order, so the ONLY way a write keeps the
- * sequence valid is to place the child it authors at its schema position — which is what
- * {@link orderedContentControlProperties} does.
- */
-declare const CONTENT_CONTROL_PROPERTY_ORDER: readonly string[];
-/**
- * Rebuild a `w:sdtPr`'s children in schema order.
- *
- * Modelled children sort to their declared position and the type element follows them,
- * as the sequence requires. Everything else — a `w15:repeatingSection`, a vendor
- * extension, the `w14:checkbox` that is not part of the ECMA-376 choice — keeps the order
- * it was authored in and follows the modelled block, so a write that touches one property
- * neither drops nor reorders anything it does not name.
- */
-declare function orderedContentControlProperties(children: readonly OoxmlNode[]): readonly OoxmlNode[];
-/**
- * The next `w:id` to write, seeded from the document's own maximum plus one.
- *
- * Never a clock, a timestamp, a random source or a hash: those collide with ids already
- * in the file and produce values Word rejects. Null when the document already reaches the
- * signed 32-bit bound, so the caller refuses rather than wrapping into a negative id.
- */
-declare function allocateContentControlId(root: OoxmlNode): number | null;
+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';
 
 /** The relationship namespace `r:id` lives in. */
 declare const OFFICE_RELATIONSHIP_NAMESPACE_URI = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
@@ -544,6 +327,223 @@ declare function projectDrawing(drawing: OoxmlDrawingNode, context: Readonly<{
     resolveRelationship?: RelationshipTargetResolver;
 }>): DrawingProjection | null;
 
+/** How deep controls may nest before a walk stops descending. Shared by every lane. */
+declare const MAX_CONTENT_CONTROL_NESTING = 32;
+/** Cap on controls one walk reports, so a hostile file cannot make a read unbounded. */
+declare const MAX_CONTENT_CONTROLS_PER_PART = 10000;
+/** `CT_SdtPr/w:id` is `ST_DecimalNumber`; Word treats it as a signed 32-bit integer. */
+declare const CONTENT_CONTROL_ID_MAX = 2147483647;
+/** `ST_Lock` (§17.5.2.24). An absent `w:lock` is `unlocked`. */
+/**
+ * `w:lock` — what a control refuses.
+ *
+ * `sdtLocked` protects the wrapper, `contentLocked` the text inside it, and `sdtContentLocked`
+ * both. A control inside a locked one is locked in effect regardless of its own value.
+ */
+type ContentControlLock = 'unlocked' | 'sdtLocked' | 'contentLocked' | 'sdtContentLocked';
+/**
+ * What kind of control this is.
+ *
+ * `checkbox` is the Microsoft `w14:checkbox` extension rather than an ECMA-376 type
+ * element, and the two are not mutually exclusive with "declares no type": four controls
+ * in the comprehensive fixture declare the extension and no `w:`-prefixed type, so a scan
+ * that read only the ECMA-376 choice reported them untyped. `untyped` means the control
+ * declares neither — a rich-text container, which is what Word treats it as.
+ */
+/** Which kind of control a `w:sdt` is, and therefore what a written value must look like. */
+type ContentControlKind = 'richText' | 'plainText' | 'checkbox' | 'dropDownList' | 'comboBox' | 'date' | 'picture' | 'docPartObj' | 'docPartList' | 'group' | 'citation' | 'bibliography' | 'equation' | 'untyped';
+/** One declared option of a dropdown or combo box: its display text and its stored value. */
+interface ContentControlListItem {
+    readonly displayText: string;
+    readonly value: string;
+}
+/** A date picker's authored format and locale, for rendering and for parsing what it stores. */
+interface ContentControlDateFormat {
+    readonly fullDate?: string;
+    readonly dateFormat?: string;
+    readonly lid?: string;
+    readonly storeMappedDataAs?: string;
+    readonly calendar?: string;
+}
+/** One of a checkbox's two glyphs: the font and code point it is drawn with. */
+interface ContentControlCheckboxState {
+    /** The `w14:val` hex code point of the glyph, exactly as the control declares it. */
+    readonly value: string;
+    readonly font?: string;
+}
+/**
+ * A checkbox's state and the two glyphs it chooses between.
+ *
+ * Both glyphs matter on a write: setting the value has to update `w14:checked` AND the run's
+ * character, or the document's glyph and its recorded state disagree.
+ */
+interface ContentControlCheckbox {
+    readonly checked: boolean;
+    readonly checkedState?: ContentControlCheckboxState;
+    readonly uncheckedState?: ContentControlCheckboxState;
+}
+/** `CT_DataBinding` — preserved metadata. Never resolved, never fetched. */
+/** `w:dataBinding` — the custom-XML part and XPath a control's value is bound to. */
+interface ContentControlDataBinding {
+    readonly xpath?: string;
+    readonly storeItemID?: string;
+    readonly prefixMappings?: string;
+}
+/**
+ * A control's whole `w:sdtPr`, projected into one typed shape.
+ *
+ * What every other lane reads instead of walking `localName` strings — which also means a Word
+ * re-save that demotes the properties node to generic does not break the projection.
+ */
+interface ContentControlProperties {
+    readonly type: ContentControlKind;
+    readonly alias?: string;
+    readonly tag?: string;
+    /** `@w:val` of `w:id` when the file declares a parseable one. Never fabricated. */
+    readonly id?: number;
+    readonly lock: ContentControlLock;
+    /** The glossary entry named by `w:placeholder/w:docPart`. Preserved, never loaded. */
+    readonly placeholderDocPart?: string;
+    readonly temporary: boolean;
+    readonly showingPlaceholder: boolean;
+    readonly dataBinding?: ContentControlDataBinding;
+    readonly label?: string;
+    readonly tabIndex?: number;
+    /** Items a dropdown or combo box offers. Empty for every other type. */
+    readonly listItems: readonly ContentControlListItem[];
+    readonly lastValue?: string;
+    readonly date?: ContentControlDateFormat;
+    readonly multiLine?: boolean;
+    readonly checkbox?: ContentControlCheckbox;
+}
+/** Whether a node is a `w:sdt` wrapper. */
+declare function isContentControlNode(node: OoxmlNode): node is OoxmlContentControlNode;
+/** Whether a node is a `w:sdtContent` — the container holding a control's actual content. */
+declare function isContentControlContentNode(node: OoxmlNode): node is OoxmlContentControlContentNode;
+/**
+ * A `w:sdt` wrapper, TYPED or DEMOTED.
+ *
+ * Flattening predates typing and must not stop at a control the reader refused to type: a
+ * demoted wrapper still renders its content in place in Word, so a walk that only saw the
+ * typed kind would drop every paragraph inside a malformed control out of the story.
+ */
+declare function isContentControlWrapper(node: OoxmlNode): boolean;
+/**
+ * The children of a wrapper's `w:sdtContent`, typed or demoted, in order.
+ *
+ * The one place that knows a control's content is reached through an intermediate element,
+ * so the four flattening walks (story blocks, layout, header/footer references, list
+ * resolution) ask the same question rather than each re-deriving it.
+ */
+declare function contentControlContentChildren(wrapper: OoxmlNode): readonly OoxmlNode[];
+/**
+ * A container's children with every content-control wrapper flattened away, bounded in depth.
+ *
+ * ONE unwrap rule, for the places where a control sits between a container and the children that
+ * container is defined in terms of. `CT_SdtRow` puts it between `w:tbl` and `w:tr`, `CT_SdtCell`
+ * between `w:tr` and `w:tc`, and a walk that filtered on the child's kind dropped the row or cell
+ * entirely: not measured, not painted, not addressable. Flattening at the point of the filter
+ * means a controlled row is the same row to the grid pass, the pagination pass and the story walk.
+ *
+ * Returns the SAME array identity when there is nothing to unwrap, so the tables that carry no
+ * controls — nearly all of them — allocate nothing and the incremental layout cache still sees
+ * its own inputs.
+ */
+declare function flattenContentControls(children: readonly OoxmlNode[], maxDepth?: number): readonly OoxmlNode[];
+/** A control's `w:sdtPr`, or null. Matches structurally, so a Word-demoted node still resolves. */
+declare function contentControlPropertiesNodeOf(control: OoxmlNode): OoxmlContentControlPropertiesNode | undefined;
+/** A control's `w:sdtEndPr` — the run properties applied to its closing marker. */
+declare function contentControlEndPropertiesNodeOf(control: OoxmlNode): OoxmlContentControlEndPropertiesNode | undefined;
+/** A control's `w:sdtContent`, or null when the wrapper has none. */
+declare function contentControlContentNodeOf(control: OoxmlNode): OoxmlContentControlContentNode | undefined;
+/** A signed 32-bit `ST_DecimalNumber`, or undefined when the file wrote something else. */
+declare function parseContentControlId(raw: string | undefined): number | undefined;
+/**
+ * Read a control's properties.
+ *
+ * Total: a control with no `w:sdtPr` at all answers the same shape with the defaults an
+ * absent property means, so no caller has to branch on the container's existence.
+ */
+declare function contentControlPropertiesOf(control: OoxmlNode): ContentControlProperties;
+/** Where a control sits, read off what its content holds. */
+type ContentControlLevel = 'block' | 'inline' | 'row' | 'cell' | 'empty';
+/**
+ * How deeply a control is nested inside other controls.
+ *
+ * Bounded by {@link MAX_CONTENT_CONTROL_NESTING}: nesting depth comes from a file and is a
+ * recursion bound.
+ */
+declare function contentControlLevelOf(control: OoxmlNode): ContentControlLevel;
+/** One control, plus how deeply it is nested and the controls that enclose it. */
+interface ContentControlEntry {
+    readonly node: OoxmlContentControlNode;
+    /** 0 for a top-level control; the nesting depth otherwise. */
+    readonly depth: number;
+    /** Enclosing controls, outermost first. Empty at depth 0. */
+    readonly ancestors: readonly OoxmlContentControlNode[];
+}
+/**
+ * Every control under a node, in document order, bounded in depth and in count.
+ *
+ * ONE walk, shared. The nesting bound is the same one layout flattens with, so a control
+ * a lane can address is a control every lane can address — and a file that nests past it
+ * keeps its content in the tree (the serializer never stops) while no walk recurses
+ * further.
+ */
+declare function contentControlsIn(root: OoxmlNode, options?: {
+    readonly maxDepth?: number;
+    readonly limit?: number;
+}): readonly ContentControlEntry[];
+/** Find one control by canonical node id, with the same bounded walk. */
+declare function findContentControl(root: OoxmlNode, nodeId: string): ContentControlEntry | null;
+/**
+ * The plain text a control's content holds, in reading order.
+ *
+ * `w:delText` is excluded: struck text is not the control's value, and a dropdown whose
+ * old item is still present as a tracked deletion would otherwise report both.
+ */
+declare function contentControlTextOf(control: OoxmlNode): string;
+/**
+ * Resolve the lock a position inherits from the controls enclosing it.
+ *
+ * CONSERVATIVE, because a template that says a field cannot be edited and sits inside a
+ * section that says it cannot be removed means both. Each half of `ST_Lock` is taken
+ * independently and the strongest wins, so an unlocked control inside a `contentLocked`
+ * one is still content-locked — a nested control cannot grant a permission its parent
+ * withheld, which is the only reading under which a lock is a lock.
+ */
+declare function resolveContentControlLock(chain: readonly ContentControlLock[]): ContentControlLock;
+/** Whether a resolved lock forbids editing the content it covers. */
+declare function lockForbidsEdit(lock: ContentControlLock): boolean;
+/** Whether a resolved lock forbids removing the control itself. */
+declare function lockForbidsRemoval(lock: ContentControlLock): boolean;
+/**
+ * `CT_SdtPr`'s declared child order (§17.5.2.38), followed by the type choice.
+ *
+ * Serialization re-emits children in tree order, so the ONLY way a write keeps the
+ * sequence valid is to place the child it authors at its schema position — which is what
+ * {@link orderedContentControlProperties} does.
+ */
+declare const CONTENT_CONTROL_PROPERTY_ORDER: readonly string[];
+/**
+ * Rebuild a `w:sdtPr`'s children in schema order.
+ *
+ * Modelled children sort to their declared position and the type element follows them,
+ * as the sequence requires. Everything else — a `w15:repeatingSection`, a vendor
+ * extension, the `w14:checkbox` that is not part of the ECMA-376 choice — keeps the order
+ * it was authored in and follows the modelled block, so a write that touches one property
+ * neither drops nor reorders anything it does not name.
+ */
+declare function orderedContentControlProperties(children: readonly OoxmlNode[]): readonly OoxmlNode[];
+/**
+ * The next `w:id` to write, seeded from the document's own maximum plus one.
+ *
+ * Never a clock, a timestamp, a random source or a hash: those collide with ids already
+ * in the file and produce values Word rejects. Null when the document already reaches the
+ * signed 32-bit bound, so the caller refuses rather than wrapping into a negative id.
+ */
+declare function allocateContentControlId(root: OoxmlNode): number | null;
+
 /** The value a control accepts, by what kind of control it is. */
 type ContentControlValueInput = {
     readonly kind: 'text';
@@ -1488,4 +1488,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 TreeDocColorValue as h, IMAGE_WRAP_TARGETS as i, type DrawingTreeDocOp 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 { 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 };

package/dist/{tree-session-CF_EOhTW.d.ts → tree-session-CH1oA75f.d.ts}

@@ -1,34 +1,13 @@
-import { S as SupportedImageMime, b as ImageDecodePort } from './image-resources-e13t-pgy.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-2clI36T9.js';
+import { S as SupportedImageMime, b as ImageDecodePort } from './image-resources-Cl5_cNi9.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-tJw8U9MO.js';
 import { Node } from 'prosemirror-model';
-import { a as ReviewItem } from './review-support-Bl9sN8cv.js';
+import { a as ReviewItem } from './review-support-D4ZBdUXa.js';
 import { ReviewModuleContribution } from './contracts/modules.js';
-import { e as OoxmlPart, O as OoxmlNode, a as OoxmlElement } from './ooxml-tree-CG0odFyi.js';
-import { O as OoxmlPackage, b as OoxmlPackageRejection } from './ooxml-package-BrxTmTsZ.js';
-import { a as HeaderFooterParts, b as HeaderFooterSectionResolution } from './hf-references-CAp1xTv6.js';
-import { S as SelectionMark, T as TreeModelChange, D as DocumentProperties } from './tree-store-9TaX-L0V.js';
-import { T as TreeDocOp } from './tree-op-types-CZw9QhWX.js';
-
-/**
- * The scheme slots the picker shows, in Word's column order.
- *
- * Assumes the default `w:clrSchemeMapping` (bg1→lt1, t1→dk1, ...); a settings part
- * that remaps them is rare and a follow-up.
- */
-declare const PICKER_SLOTS: readonly ["lt1", "dk1", "lt2", "dk2", "accent1", "accent2", "accent3", "accent4", "accent5", "accent6"];
-type ThemeColorSlot = (typeof PICKER_SLOTS)[number];
-/** One theme colour: the scheme slot and its resolved six-digit hex (no '#'). */
-interface DocumentThemeColorEntry {
-    readonly slot: ThemeColorSlot;
-    readonly hex: string;
-}
-/** The theme's two font slots, for resolving `w:rFonts` theme attributes. */
-interface DocumentThemeFonts {
-    /** `a:majorFont` latin typeface — headings. */
-    readonly major: string | null;
-    /** `a:minorFont` latin typeface — body text. */
-    readonly minor: string | null;
-}
+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-CIKASRHk.js';
+import { T as TreeDocOp } from './tree-op-types-D0fTNBVW.js';
 
 /**
  * Why an edited projection could not be mapped back into tree ops.
@@ -164,6 +143,27 @@ interface DocumentSearchResult {
     readonly truncated: boolean;
 }
 
+/**
+ * The scheme slots the picker shows, in Word's column order.
+ *
+ * Assumes the default `w:clrSchemeMapping` (bg1→lt1, t1→dk1, ...); a settings part
+ * that remaps them is rare and a follow-up.
+ */
+declare const PICKER_SLOTS: readonly ["lt1", "dk1", "lt2", "dk2", "accent1", "accent2", "accent3", "accent4", "accent5", "accent6"];
+type ThemeColorSlot = (typeof PICKER_SLOTS)[number];
+/** One theme colour: the scheme slot and its resolved six-digit hex (no '#'). */
+interface DocumentThemeColorEntry {
+    readonly slot: ThemeColorSlot;
+    readonly hex: string;
+}
+/** The theme's two font slots, for resolving `w:rFonts` theme attributes. */
+interface DocumentThemeFonts {
+    /** `a:majorFont` latin typeface — headings. */
+    readonly major: string | null;
+    /** `a:minorFont` latin typeface — body text. */
+    readonly minor: string | null;
+}
+
 /** What a run inherits at one point of the chain — null means "nothing authored". */
 interface StyleRunDefaults {
     readonly fontFamily: string | null;
@@ -207,7 +207,7 @@ interface TreeApplyResult {
  * Holds the whole package, not just the body — headers, footers, notes, comments and styles are
  * all reachable through it, and parts the engine does not model are preserved verbatim.
  */
-interface TreeDocxSession {
+interface TreeDocxSessionView {
     /** Whether the body holds at least one editable paragraph. */
     readonly editable: boolean;
     /** Canonical node ids of the body paragraphs, in order. */
@@ -238,20 +238,6 @@ interface TreeDocxSession {
      * and one undo unit without swapping the body store.
      */
     applyTreeOps(ops: readonly TreeDocOp[], selectionBefore?: SelectionMark | null, selectionAfter?: SelectionMark | null, scope?: StoryScope): TreeApplyResult;
-    /** Project the current BODY revision into a ProseMirror doc. */
-    projectDoc(): Node;
-    /** Re-project incrementally from the last committed change, reusing untouched paragraphs. */
-    reconcile(previousDoc: Node): Node;
-    /**
-     * Whether the last commit changed the BLOCK SEQUENCE (a split, join, insert or delete).
-     *
-     * A host needs this to decide whether the view must be re-projected at all: after a pure
-     * text edit the view already holds what the model holds, and re-projecting anyway both
-     * wastes work and races the next keystroke.
-     */
-    lastCommitWasStructural(): boolean;
-    /** Map an edited BODY doc to tree ops and commit them as ONE transaction. */
-    applyPmDoc(doc: Node): TreeApplyResult;
     /** Body text, paragraphs joined by newlines, read from the CANONICAL tree. */
     bodyText(): string;
     /** Text of a story scope, paragraphs joined by newlines. */
@@ -305,6 +291,15 @@ interface TreeDocxSession {
      * Memoized per package revision.
      */
     documentFonts(): readonly string[];
+    /**
+     * Whether the document puts any literal character on a page, over the same roots
+     * {@link TreeDocxSessionView.documentFonts} reads. Memoized per package revision.
+     *
+     * The font-substitution notice needs it: `documentFonts` reports what the document
+     * DECLARES, and a brand-new document declares Word's Calibri default over a single
+     * 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.
@@ -552,6 +547,27 @@ interface TreeDocxSession {
     /** Apply image property tree ops plus hyperlink relationship wiring atomically. */
     applyImageProperties(scope: StoryScope, input: ApplyImagePropertiesInput): ImageIntentResult;
 }
+/**
+ * Binding-only session methods that exchange ProseMirror projections.
+ *
+ * Editor surfaces expose {@link TreeDocxSessionView}. Only the binding lane sees this extension.
+ */
+interface TreeDocxSession extends TreeDocxSessionView {
+    /** Project the current BODY revision into a ProseMirror doc. */
+    projectDoc(): Node;
+    /** Re-project incrementally from the last committed change, reusing untouched paragraphs. */
+    reconcile(previousDoc: Node): Node;
+    /**
+     * Whether the last commit changed the BLOCK SEQUENCE (a split, join, insert or delete).
+     *
+     * A host needs this to decide whether the view must be re-projected at all. After a pure
+     * text edit, the view already holds what the model holds. Re-projecting wastes work and
+     * races the next keystroke.
+     */
+    lastCommitWasStructural(): boolean;
+    /** Map an edited BODY doc to tree ops and commit them as one transaction. */
+    applyPmDoc(doc: Node): TreeApplyResult;
+}
 
 /**
  * Why bytes could not be opened: any bounded-reader rejection, plus the package that parsed but
@@ -595,4 +611,4 @@ declare function openTreeSession(bytes: Uint8Array, options?: OpenTreeSessionOpt
 /** The origin a host should use when committing a reconciliation rather than a user edit. */
 declare const PROJECTION_ORIGIN: "dev.docx-editor.core.origin.projection";
 
-export { type DocumentStyleEntry as D, type MapResult as M, type OpenTreeSessionResult as O, PROJECTION_ORIGIN as P, type TreeDocxSession as T, type TreeApplyResult as a, type TreeBindingRejection as b, type TreeSessionRejection as c, bodyParagraphs as d, docToTreeOps as e, type DocumentThemeColorEntry as f, openTreeSession as o, partHasNode as p, reconcileDoc as r, treeToDoc as t };
+export { type DocumentStyleEntry as D, type MapResult as M, type OpenTreeSessionResult as O, PROJECTION_ORIGIN as P, type TreeDocxSession as T, type TreeApplyResult as a, type TreeBindingRejection as b, type TreeDocxSessionView as c, type TreeSessionRejection as d, bodyParagraphs as e, docToTreeOps as f, type DocumentThemeColorEntry as g, openTreeSession as o, partHasNode as p, reconcileDoc as r, treeToDoc as t };