@docx-editor.dev/core 2.15.0 → 2.16.0

package/dist/{tree-op-types-egdarvH_.d.ts → tree-op-types-C5rZzoAz.d.ts}

@@ -311,6 +311,7 @@ type XmlResult = {
 /** Per-part caps on size, element count and depth. Clamped into the hard ceilings. */
 interface XmlLimits {
     readonly maxBytes: number;
+    /** Element budget; may raise or lower the engine default, up to its hard ceiling. */
     readonly maxElements?: number;
 }
 /** Read XML into an ordered tree, refusing DTDs/entities and bounding size. */
@@ -1172,6 +1173,7 @@ type ZipReadResult = {
     readonly ok: false;
     readonly reason: ZipRejection;
     readonly detail?: string;
+    readonly limit?: 'zip.maxTotalBytes' | 'zip.maxRatio';
 };
 /**
  * Inflate a ZIP archive with bounds + OPC name normalization. Entry name, count,
@@ -1187,6 +1189,29 @@ declare function readZip(bytes: Uint8Array, limits?: ZipLimits): ZipReadResult;
  *  never be smuggled into a ZIP entry (write-side path-traversal guard). */
 declare function writeZip(entries: ReadonlyMap<string, Uint8Array>): Uint8Array;
 
+/** Only generated, escaped SVG and relationship slots; never authored markup. */
+type LegacyGraphicFragment = string | Readonly<{
+    relationshipId: string;
+    before: string;
+    after: string;
+    nativeCrop?: SourceCrop;
+}>;
+interface LegacyGraphicProjection {
+    readonly width: number;
+    readonly height: number;
+    readonly fragments: readonly LegacyGraphicFragment[];
+}
+
+/** Picture color adjustments shared by projection, layout, and paint.
+ * @public
+ */
+interface DrawingImageEffects {
+    readonly grayscale: boolean;
+    readonly brightness: number;
+    readonly contrast: number;
+    readonly bilevel?: number;
+}
+
 /** The relationship namespace `r:id` lives in. */
 declare const OFFICE_RELATIONSHIP_NAMESPACE_URI = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
 /** The `Type` a hyperlink relationship declares. */
@@ -1326,6 +1351,13 @@ interface VectorShapeComponent {
         x: number;
         y: number;
     }>[])[];
+    /** Authored close commands; omitted by older consumers means closed polygons. */
+    readonly subpathsClosed?: readonly boolean[];
+    /** Filled line-end polygons in the same projected coordinate space. */
+    readonly arrowheadsEmu?: readonly (readonly Readonly<{
+        x: number;
+        y: number;
+    }>[])[];
     readonly fillHex: string | null;
     readonly fillAlpha: number;
     readonly strokeHex: string | null;
@@ -1474,12 +1506,10 @@ interface DrawingProjection {
     readonly picture: PictureProjection | null;
     readonly vectorShape: VectorShapeProjection | null;
     readonly textboxStory: TextboxStoryProjection | null;
+    /** Read-only preview of the supported native VML subset; the canonical XML is untouched. */
+    readonly legacyGraphic?: LegacyGraphicProjection;
     readonly locks: DrawingLocks;
-    readonly effects: Readonly<{
-        grayscale: boolean;
-        brightness: number;
-        contrast: number;
-    }>;
+    readonly effects: DrawingImageEffects;
     readonly compatibilityBranchNodeId: string | null;
     readonly diagnostics: readonly DrawingDiagnostic[];
 }
@@ -1747,6 +1777,7 @@ type OoxmlPackageResult = {
     readonly ok: false;
     readonly reason: OoxmlPackageRejection;
     readonly detail?: string;
+    readonly limit?: 'zip.maxTotalBytes' | 'zip.maxRatio';
 };
 declare function readOoxmlPackage(bytes: Uint8Array, limits?: OoxmlPackageLimits): OoxmlPackageResult;
 /**
@@ -1769,6 +1800,97 @@ declare function writeOoxmlPackage(pkg: OoxmlPackage): Uint8Array;
 /** Replace one part's tree, returning a new package. Pure, like the tree edits themselves. */
 declare function withPart(pkg: OoxmlPackage, part: OoxmlPart): OoxmlPackage;
 
+type InsertTextOp = {
+    readonly op: 'insertText';
+    readonly paragraphId: string;
+    /** Legacy text form identity for protected filling; never an inline wrapper owner. */
+    readonly textFormFieldId?: string;
+    readonly offset: number;
+    readonly text: string;
+    /**
+     * Write this as a TRACKED insertion, attributed here.
+     *
+     * On the op rather than on the store, so suggesting stays a decision the surface makes
+     * per edit and the write vocabulary stays explicit — a global "everything is tracked
+     * now" flag is exactly what `DocEdits` refuses, because it makes the meaning of an op
+     * depend on state the op does not carry.
+     */
+    readonly revision?: RevisionAttributionInput;
+    /**
+     * When set, the text belongs INSIDE this content control, whatever sits at the offset.
+     *
+     * A boundary offset is owned by the run that starts there, which at a control's trailing
+     * edge is the run after the control — so an offset alone cannot say "append to this field",
+     * the way it cannot say which run of a field result to format (see `targetRunIds`). A
+     * caller that names the control gets the text in the control; one that does not gets the
+     * plain offset rule, which is what a keystroke beside a field means.
+     */
+    readonly inside?: string;
+    /**
+     * Which side of a run BOUNDARY the text joins. Default `'left'` — Word's typing rule:
+     * the next character takes the formatting of the character before the caret.
+     *
+     * `'right'` is for a caller that is not typing but placing text inside the run that
+     * STARTS at the offset — the hyperlink editor rewriting a link's display text, where
+     * landing left of the boundary would put the new text outside the link. Ignored when
+     * the offset falls strictly inside a run, which has no boundary to choose.
+     */
+    readonly bias?: 'left' | 'right';
+};
+type DeleteTextOp = {
+    readonly op: 'deleteText';
+    readonly paragraphId: string;
+    /** Legacy text form identity for protected filling; never an inline wrapper owner. */
+    readonly textFormFieldId?: string;
+    readonly start: number;
+    readonly end: number;
+    /** Write this as a TRACKED deletion — the characters stay, wrapped in `w:del`. */
+    readonly revision?: RevisionAttributionInput;
+};
+
+/** Editable legacy text input types. Other authored types remain inert. */
+type TextFormFieldType = 'regular' | 'number' | 'date';
+/** Options stored in the legacy field definition. Zero means unlimited length. */
+interface TextFormFieldOptions {
+    readonly type: TextFormFieldType;
+    readonly maxLength: number;
+    readonly format: string;
+    readonly enabled: boolean;
+}
+
+/** A legacy text input in the shared paragraph offset space. */
+interface TextFormFieldRange {
+    readonly fieldNodeId: string;
+    readonly start: number;
+    readonly end: number;
+    readonly enabled: boolean;
+    readonly defaultText: string;
+    readonly type: string;
+    readonly maxLength: number;
+    readonly format: string;
+    readonly chromeIds: readonly string[];
+}
+/** Uses the field parser and offset index; never introduces another inline walk. */
+declare function textFormFieldsOf(paragraph: OoxmlParagraphNode): readonly TextFormFieldRange[];
+/** Options edit for an existing legacy text form. */
+interface SetTextFormFieldDefaultOp {
+    readonly op: 'setTextFormFieldDefault';
+    /** Regional conventions for new date input; defaults to en-US. */
+    readonly locale?: string;
+    readonly paragraphId: string;
+    readonly fieldNodeId: string;
+    readonly text: string;
+    readonly options?: TextFormFieldOptions;
+}
+/** Validate and format the existing result when a user finishes filling a field. */
+interface CommitTextFormFieldOp {
+    readonly op: 'commitTextFormField';
+    /** Regional conventions for new date input; defaults to en-US. */
+    readonly locale?: string;
+    readonly paragraphId: string;
+    readonly fieldNodeId: string;
+}
+
 /** 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. */
@@ -2054,7 +2176,6 @@ interface RevisionAttributionInput {
     readonly date?: string;
 }
 
-/** JSON-safe color input carried on table cell property ops. Theme/auto require a validated literal. */
 /**
  * A colour as an op carries it: a literal, a theme reference, or automatic.
  *
@@ -2074,10 +2195,8 @@ type TreeDocColorValue = {
     readonly kind: 'auto';
     readonly resolvedHex: string;
 };
-/** Which cell edges a selected-cell border op targets. */
 /** Which edges a border op addresses — the four sides, the interiors, all, or clear. */
 type TableBorderTarget = 'all' | 'outside' | 'inside' | 'none' | 'top' | 'bottom' | 'left' | 'right';
-/** Concrete edge scopes that apply or clear a complete border spec. */
 /** A {@link TableBorderTarget} that draws something — everything except clear. */
 type TableBorderEdgeTarget = Exclude<TableBorderTarget, 'none'>;
 /** Complete border spec for non-`none` selected-cell border scopes. Size is in eighths of a point. */
@@ -2159,48 +2278,7 @@ type TreeDocOp = {
         readonly paragraphId: string;
         readonly name: string;
     }[];
-} | {
-    readonly op: 'insertText';
-    readonly paragraphId: string;
-    readonly offset: number;
-    readonly text: string;
-    /**
-     * Write this as a TRACKED insertion, attributed here.
-     *
-     * On the op rather than on the store, so suggesting stays a decision the surface makes
-     * per edit and the write vocabulary stays explicit — a global "everything is tracked
-     * now" flag is exactly what `DocEdits` refuses, because it makes the meaning of an op
-     * depend on state the op does not carry.
-     */
-    readonly revision?: RevisionAttributionInput;
-    /**
-     * When set, the text belongs INSIDE this content control, whatever sits at the offset.
-     *
-     * A boundary offset is owned by the run that starts there, which at a control's trailing
-     * edge is the run after the control — so an offset alone cannot say "append to this field",
-     * the way it cannot say which run of a field result to format (see `targetRunIds`). A
-     * caller that names the control gets the text in the control; one that does not gets the
-     * plain offset rule, which is what a keystroke beside a field means.
-     */
-    readonly inside?: string;
-    /**
-     * Which side of a run BOUNDARY the text joins. Default `'left'` — Word's typing rule:
-     * the next character takes the formatting of the character before the caret.
-     *
-     * `'right'` is for a caller that is not typing but placing text inside the run that
-     * STARTS at the offset — the hyperlink editor rewriting a link's display text, where
-     * landing left of the boundary would put the new text outside the link. Ignored when
-     * the offset falls strictly inside a run, which has no boundary to choose.
-     */
-    readonly bias?: 'left' | 'right';
-} | {
-    readonly op: 'deleteText';
-    readonly paragraphId: string;
-    readonly start: number;
-    readonly end: number;
-    /** Write this as a TRACKED deletion — the characters stay, wrapped in `w:del`. */
-    readonly revision?: RevisionAttributionInput;
-} | {
+} | InsertTextOp | DeleteTextOp | {
     /**
      * Mark a paragraph's own MARK as inserted or deleted (`w:pPr/w:rPr/w:ins|w:del`,
      * §17.13.5). The change is to the paragraph break itself, so no character carries it.
@@ -2935,7 +3013,7 @@ type TreeDocOp = {
         readonly paragraphId: string;
         readonly pageNumberText: string;
     }[];
-} | {
+} | SetTextFormFieldDefaultOp | CommitTextFormFieldOp | {
     /**
      * Rewrite recognized fields' cached RESULT runs in place — between the `separate` and
      * `end` fldChars, or a `w:fldSimple`'s content. The instruction is never modified; a
@@ -2956,7 +3034,7 @@ type DrawingTreeDocOp = Extract<TreeDocOp, {
 /** Just the `op` discriminants, for dispatch tables and validation. */
 type TreeDocOpKind = TreeDocOp['op'];
 /** Every {@link TreeDocOpKind}, for validation and exhaustiveness checks. */
-declare const TREE_DOC_OP_KINDS: readonly ["replaceStoryBlocks", "insertText", "deleteText", "setParagraphMarkRevision", "proposeParagraphMerge", "insertCommentMarker", "acceptRevision", "rejectRevision", "acceptAllRevisions", "rejectAllRevisions", "insertTab", "insertHardBreak", "insertPageBreak", "insertPageField", "setListLevel", "setListNumbering", "setParagraphTabStops", "setParagraphMarkProperties", "splitParagraph", "splitParagraphMany", "joinParagraphs", "setRunProperties", "setParagraphProperties", "setSectionProperties", "setSectionMark", "insertHyperlink", "setHyperlinkTarget", "removeHyperlink", "setMathEquation", "removeMathEquation", "setContentControlValue", "removeContentControl", "insertInlineContentControl", "addRepeatingSectionItem", "removeRepeatingSectionItem", "deleteBlock", "insertTable", "insertTableRow", "deleteTableRow", "insertTableColumn", "deleteTableColumn", "setTableColumnWidths", "setTableRightEdgeWidth", "setTableRowHeight", "setTableCellBorders", "setTableCellFill", "setTableCellVerticalAlignment", "createHeaderFooter", "deleteHeaderFooter", "linkToPrevious", "unlinkFromPrevious", "setSectionFurnitureOptions", "insertNote", "deleteNote", "convertNote", "convertAllNotes", "setNoteProperties", "setContentControlProperties", "insertContentControl", "insertFragment", "insertDrawing", "replaceDrawingResource", "deleteDrawing", "resizeDrawing", "cropDrawing", "positionDrawing", "setDrawingWrap", "setDrawingMetadata", "setDrawingLocks", "transformDrawing", "insertToc", "replaceTocResult", "rewriteTocPageNumbers", "refreshFieldResults"];
+declare const TREE_DOC_OP_KINDS: readonly ["replaceStoryBlocks", "insertText", "deleteText", "setParagraphMarkRevision", "proposeParagraphMerge", "insertCommentMarker", "acceptRevision", "rejectRevision", "acceptAllRevisions", "rejectAllRevisions", "insertTab", "insertHardBreak", "insertPageBreak", "insertPageField", "setListLevel", "setListNumbering", "setParagraphTabStops", "setParagraphMarkProperties", "splitParagraph", "splitParagraphMany", "joinParagraphs", "setRunProperties", "setParagraphProperties", "setSectionProperties", "setSectionMark", "insertHyperlink", "setHyperlinkTarget", "removeHyperlink", "setMathEquation", "removeMathEquation", "setContentControlValue", "removeContentControl", "insertInlineContentControl", "addRepeatingSectionItem", "removeRepeatingSectionItem", "deleteBlock", "insertTable", "insertTableRow", "deleteTableRow", "insertTableColumn", "deleteTableColumn", "setTableColumnWidths", "setTableRightEdgeWidth", "setTableRowHeight", "setTableCellBorders", "setTableCellFill", "setTableCellVerticalAlignment", "createHeaderFooter", "deleteHeaderFooter", "linkToPrevious", "unlinkFromPrevious", "setSectionFurnitureOptions", "insertNote", "deleteNote", "convertNote", "convertAllNotes", "setNoteProperties", "setContentControlProperties", "insertContentControl", "insertFragment", "insertDrawing", "replaceDrawingResource", "deleteDrawing", "resizeDrawing", "cropDrawing", "positionDrawing", "setDrawingWrap", "setDrawingMetadata", "setDrawingLocks", "transformDrawing", "insertToc", "replaceTocResult", "rewriteTocPageNumbers", "refreshFieldResults", "setTextFormFieldDefault", "commitTextFormField"];
 /**
  * How far a committed op can reach, so layout can scope its work (task 5.2).
  *
@@ -3100,4 +3178,4 @@ type TreeOpResult = {
     readonly detail?: string;
 };
 
-export { type ResourceLimits as $, type DrawingVerticalReferenceFrame as A, type VectorImageMime as B, type RevisionAttributionInput as C, type DrawingKind as D, type ImageDecodePort as E, type DrawingTreeDocOp as F, type ImageResourceLimits as G, type TreeDocColorValue as H, type ImpactClass as I, DEFAULT_IMAGE_RESOURCE_LIMITS as J, IMAGE_WRAP_TARGETS as K, resolveImageResourceLimits as L, resolveSvgIntrinsicSize as M, sniffImageMime as N, type OoxmlPart as O, type PreservedImageMime as P, validateRasterHeader as Q, type RevisionAddress as R, type SourceCrop as S, type TreeDocOp as T, type TableBorderStyle as U, type ValidatedImageBytesHandle as V, type DrawingAccessibility as W, type DrawingTransform as X, type VectorShapeProjection as Y, type DrawingProjection as Z, type OoxmlDrawingNode as _, type OoxmlNode as a, type OoxmlContentControlStoreMappedDataAsNode as a$, type OoxmlInvariantResult as a0, type RelationshipRecord as a1, type OoxmlInvariantIssue as a2, type OoxmlHardBreakNode as a3, type OoxmlFldCharNode as a4, type OoxmlFldSimpleNode as a5, type OoxmlInstrTextNode as a6, type OoxmlAttribute as a7, type TreeOpResult as a8, ACCEPTED_PARAGRAPH_PROPERTIES as a9, IMAGE_RESOURCE_HARD_CEILINGS as aA, type ImageRelationshipResolution as aB, type ImageResourceLookup as aC, type IndexResult as aD, MAX_CONTENT_CONTROLS_PER_PART as aE, MAX_CONTENT_CONTROL_NESTING as aF, MAX_SVG_SNIFF_BYTES as aG, type NameRejection as aH, type NameResult as aI, OFFICE_RELATIONSHIP_NAMESPACE_URI as aJ, OOXML_NODE_IDENTITY_RULES as aK, type OoxmlBodyNode as aL, type OoxmlBookmarkEndNode as aM, type OoxmlBookmarkStartNode as aN, type OoxmlContentControlCalendarNode as aO, type OoxmlContentControlCheckboxNode as aP, type OoxmlContentControlCheckedNode as aQ, type OoxmlContentControlCheckedStateNode as aR, type OoxmlContentControlComboBoxNode as aS, type OoxmlContentControlDataBindingNode as aT, type OoxmlContentControlDateFormatNode as aU, type OoxmlContentControlDateNode as aV, type OoxmlContentControlDropDownListNode as aW, type OoxmlContentControlEndPropertiesNode as aX, type OoxmlContentControlLidNode as aY, type OoxmlContentControlListItemNode as aZ, type OoxmlContentControlPropertiesNode as a_, ACCEPTED_RUN_PROPERTIES as aa, CONTENT_CONTROL_ID_MAX as ab, CONTENT_CONTROL_PROPERTY_ORDER as ac, type ContentControlCheckbox as ad, type ContentControlCheckboxState as ae, type ContentControlDataBinding as af, type ContentControlDateFormat as ag, type ContentControlEntry as ah, type ContentControlKind as ai, type ContentControlLevel as aj, type ContentControlListItem as ak, type ContentControlLock as al, type ContentControlProperties as am, type ContentTypeError as an, type ContentTypeIndex as ao, type ContentTypeRecords as ap, type CreateImageResourceCacheOptions as aq, DEFAULT_LIMITS as ar, DEFAULT_OOXML_PACKAGE_LIMITS as as, DEFAULT_ZIP_LIMITS as at, type DefaultRecord as au, HARD_CEILINGS as av, HYPERLINK_RELATIONSHIP_TYPE as aw, type HyperlinkKind as ax, type HyperlinkTarget as ay, IMAGE_RELATIONSHIP_TYPE as az, type OoxmlPackage as b, flattenContentControls as b$, type OoxmlContentControlTextNode as b0, type OoxmlContentControlUncheckedStateNode as b1, type OoxmlDocumentNode as b2, type OoxmlExternalTarget as b3, type OoxmlGenericExtensionAttribute as b4, type OoxmlHyperlinkNode as b5, type OoxmlInvariantIssueCode as b6, type OoxmlKnownNodeAttribute as b7, type OoxmlNamespaceBinding as b8, type OoxmlNodeIdentityRules as b9, XMLNS_NAMESPACE_URI as bA, XML_NAMESPACE_URI as bB, type XmlLimits as bC, type XmlNode as bD, type XmlRejection as bE, type XmlResult as bF, type ZipLimits as bG, type ZipReadResult as bH, type ZipRejection as bI, allocateContentControlId as bJ, asciiFold as bK, buildContentTypeIndex as bL, buildRelationshipSet as bM, childElements as bN, contentControlContentChildren as bO, contentControlContentNodeOf as bP, contentControlEndPropertiesNodeOf as bQ, contentControlLevelOf as bR, contentControlPropertiesNodeOf as bS, contentControlPropertiesOf as bT, contentControlTextOf as bU, contentControlsIn as bV, createImageResourceCache as bW, detectDuplicateNames as bX, extensionKey as bY, findContentControl as bZ, findElement as b_, type OoxmlPackageResult as ba, type OoxmlParagraphPropertiesNode as bb, type OoxmlPartMetadata as bc, type OoxmlReadRejection as bd, type OoxmlReadResult as be, type OoxmlRunNode as bf, type OoxmlRunPropertiesNode as bg, type OoxmlTabNode as bh, type OoxmlTextElementNode as bi, type OoxmlTextNode as bj, type OoxmlWmlValAttribute as bk, type OoxmlXmlSpaceAttribute as bl, type OverrideRecord as bm, type RelationshipError as bn, type RelationshipSetResult as bo, type RelationshipTargetResolver as bp, type ResolveResult as bq, type ResolvedRelationship as br, TABLE_BORDER_STYLES as bs, TREE_DOC_OP_KINDS as bt, type TabStopWrite as bu, type TargetMode as bv, type TreeDocOpKind as bw, type TreeOpEffect as bx, type ValidatedRasterHeader as by, WML_NAMESPACE_URI as bz, type OoxmlElement as c, hasBoundedSvgRoot as c0, hyperlinkAnchorOf as c1, hyperlinkRelationshipIdOf as c2, hyperlinkTargetOf as c3, imageResourceLookupFor as c4, isContentControlContentNode as c5, isContentControlNode as c6, isContentControlWrapper as c7, isContentRevisionKind as c8, isHyperlinkNode as c9, withPart as cA, writeOoxmlPackage as cB, writeZip as cC, type VectorShapeComponent as cD, isRangeMarkerKind as ca, isValidMime as cb, liveDrawingReferenceCount as cc, lockForbidsEdit as cd, lockForbidsRemoval as ce, normalizePartName as cf, orderedContentControlProperties as cg, parseContentControlId as ch, partNameKey as ci, projectDrawing as cj, readOnOffChild as ck, readOoxmlPackage as cl, readOoxmlPart as cm, readXml as cn, readZip as co, resolveContentControlLock as cp, resolveContentType as cq, resolveImageRelationship as cr, resolveInternalTarget as cs, resolveLimits as ct, resolveRelationship as cu, textContent as cv, validateExternalTarget as cw, validateGifHeader as cx, validateJpegHeader as cy, validatePngHeader as cz, type OoxmlNodeId as d, type OoxmlGenericElementNode as e, type OoxmlPackageLimits as f, type OoxmlPackageRejection as g, type OoxmlParagraphNode as h, type OoxmlNoteNode as i, type OoxmlContinuationSeparatorNode as j, type OoxmlEndnotesNode as k, type OoxmlFootnotesNode as l, type OoxmlNoteRefNode as m, type OoxmlNoteReferenceNode as n, type OoxmlSeparatorNode as o, type TreeOpRejection as p, type OoxmlProperty as q, type OoxmlContentControlNode as r, type OoxmlContentControlContentNode as s, type RenderableImageMime as t, type ImageWrapTarget as u, type DrawingPositionInput as v, type DrawingLocks as w, type ImageResourceState as x, type SupportedImageMime as y, type DrawingHorizontalReferenceFrame as z };
+export { type OoxmlDrawingNode as $, type DrawingVerticalReferenceFrame as A, type VectorImageMime as B, type RevisionAttributionInput as C, type DrawingKind as D, type ImageDecodePort as E, type DrawingTreeDocOp as F, type ImageResourceLimits as G, type TreeDocColorValue as H, type ImpactClass as I, DEFAULT_IMAGE_RESOURCE_LIMITS as J, IMAGE_WRAP_TARGETS as K, resolveImageResourceLimits as L, resolveSvgIntrinsicSize as M, sniffImageMime as N, type OoxmlPart as O, type PreservedImageMime as P, validateRasterHeader as Q, type RevisionAddress as R, type SourceCrop as S, type TreeDocOp as T, type TableBorderStyle as U, type ValidatedImageBytesHandle as V, type DrawingAccessibility as W, type DrawingImageEffects as X, type DrawingTransform as Y, type VectorShapeProjection as Z, type DrawingProjection as _, type OoxmlNode as a, type OoxmlContentControlEndPropertiesNode as a$, type ResourceLimits as a0, type OoxmlInvariantResult as a1, type RelationshipRecord as a2, type OoxmlInvariantIssue as a3, type OoxmlHardBreakNode as a4, type OoxmlFldCharNode as a5, type OoxmlFldSimpleNode as a6, type OoxmlInstrTextNode as a7, type OoxmlAttribute as a8, type TreeOpResult as a9, type HyperlinkKind as aA, type HyperlinkTarget as aB, IMAGE_RELATIONSHIP_TYPE as aC, IMAGE_RESOURCE_HARD_CEILINGS as aD, type ImageRelationshipResolution as aE, type ImageResourceLookup as aF, type IndexResult as aG, type InsertTextOp as aH, MAX_CONTENT_CONTROLS_PER_PART as aI, MAX_CONTENT_CONTROL_NESTING as aJ, MAX_SVG_SNIFF_BYTES as aK, type NameRejection as aL, type NameResult as aM, OFFICE_RELATIONSHIP_NAMESPACE_URI as aN, OOXML_NODE_IDENTITY_RULES as aO, type OoxmlBodyNode as aP, type OoxmlBookmarkEndNode as aQ, type OoxmlBookmarkStartNode as aR, type OoxmlContentControlCalendarNode as aS, type OoxmlContentControlCheckboxNode as aT, type OoxmlContentControlCheckedNode as aU, type OoxmlContentControlCheckedStateNode as aV, type OoxmlContentControlComboBoxNode as aW, type OoxmlContentControlDataBindingNode as aX, type OoxmlContentControlDateFormatNode as aY, type OoxmlContentControlDateNode as aZ, type OoxmlContentControlDropDownListNode as a_, ACCEPTED_PARAGRAPH_PROPERTIES as aa, ACCEPTED_RUN_PROPERTIES as ab, CONTENT_CONTROL_ID_MAX as ac, CONTENT_CONTROL_PROPERTY_ORDER as ad, type CommitTextFormFieldOp as ae, type ContentControlCheckbox as af, type ContentControlCheckboxState as ag, type ContentControlDataBinding as ah, type ContentControlDateFormat as ai, type ContentControlEntry as aj, type ContentControlKind as ak, type ContentControlLevel as al, type ContentControlListItem as am, type ContentControlLock as an, type ContentControlProperties as ao, type ContentTypeError as ap, type ContentTypeIndex as aq, type ContentTypeRecords as ar, type CreateImageResourceCacheOptions as as, DEFAULT_LIMITS as at, DEFAULT_OOXML_PACKAGE_LIMITS as au, DEFAULT_ZIP_LIMITS as av, type DefaultRecord as aw, type DeleteTextOp as ax, HARD_CEILINGS as ay, HYPERLINK_RELATIONSHIP_TYPE as az, type OoxmlPackage as b, contentControlPropertiesOf as b$, type OoxmlContentControlLidNode as b0, type OoxmlContentControlListItemNode as b1, type OoxmlContentControlPropertiesNode as b2, type OoxmlContentControlStoreMappedDataAsNode as b3, type OoxmlContentControlTextNode as b4, type OoxmlContentControlUncheckedStateNode as b5, type OoxmlDocumentNode as b6, type OoxmlExternalTarget as b7, type OoxmlGenericExtensionAttribute as b8, type OoxmlHyperlinkNode as b9, type TargetMode as bA, type TextFormFieldOptions as bB, type TextFormFieldRange as bC, type TextFormFieldType as bD, type TreeDocOpKind as bE, type TreeOpEffect as bF, type ValidatedRasterHeader as bG, WML_NAMESPACE_URI as bH, XMLNS_NAMESPACE_URI as bI, XML_NAMESPACE_URI as bJ, type XmlLimits as bK, type XmlNode as bL, type XmlRejection as bM, type XmlResult as bN, type ZipLimits as bO, type ZipReadResult as bP, type ZipRejection as bQ, allocateContentControlId as bR, asciiFold as bS, buildContentTypeIndex as bT, buildRelationshipSet as bU, childElements as bV, contentControlContentChildren as bW, contentControlContentNodeOf as bX, contentControlEndPropertiesNodeOf as bY, contentControlLevelOf as bZ, contentControlPropertiesNodeOf as b_, type OoxmlInvariantIssueCode as ba, type OoxmlKnownNodeAttribute as bb, type OoxmlNamespaceBinding as bc, type OoxmlNodeIdentityRules as bd, type OoxmlPackageResult as be, type OoxmlParagraphPropertiesNode as bf, type OoxmlPartMetadata as bg, type OoxmlReadRejection as bh, type OoxmlReadResult as bi, type OoxmlRunNode as bj, type OoxmlRunPropertiesNode as bk, type OoxmlTabNode as bl, type OoxmlTextElementNode as bm, type OoxmlTextNode as bn, type OoxmlWmlValAttribute as bo, type OoxmlXmlSpaceAttribute as bp, type OverrideRecord as bq, type RelationshipError as br, type RelationshipSetResult as bs, type RelationshipTargetResolver as bt, type ResolveResult as bu, type ResolvedRelationship as bv, type SetTextFormFieldDefaultOp as bw, TABLE_BORDER_STYLES as bx, TREE_DOC_OP_KINDS as by, type TabStopWrite as bz, type OoxmlElement as c, contentControlTextOf as c0, contentControlsIn as c1, createImageResourceCache as c2, detectDuplicateNames as c3, extensionKey as c4, findContentControl as c5, findElement as c6, flattenContentControls as c7, hasBoundedSvgRoot as c8, hyperlinkAnchorOf as c9, resolveInternalTarget as cA, resolveLimits as cB, resolveRelationship as cC, textContent as cD, textFormFieldsOf as cE, validateExternalTarget as cF, validateGifHeader as cG, validateJpegHeader as cH, validatePngHeader as cI, withPart as cJ, writeOoxmlPackage as cK, writeZip as cL, type VectorShapeComponent as cM, hyperlinkRelationshipIdOf as ca, hyperlinkTargetOf as cb, imageResourceLookupFor as cc, isContentControlContentNode as cd, isContentControlNode as ce, isContentControlWrapper as cf, isContentRevisionKind as cg, isHyperlinkNode as ch, isRangeMarkerKind as ci, isValidMime as cj, liveDrawingReferenceCount as ck, lockForbidsEdit as cl, lockForbidsRemoval as cm, normalizePartName as cn, orderedContentControlProperties as co, parseContentControlId as cp, partNameKey as cq, projectDrawing as cr, readOnOffChild as cs, readOoxmlPackage as ct, readOoxmlPart as cu, readXml as cv, readZip as cw, resolveContentControlLock as cx, resolveContentType as cy, resolveImageRelationship as cz, type OoxmlNodeId as d, type OoxmlGenericElementNode as e, type OoxmlPackageLimits as f, type OoxmlPackageRejection as g, type OoxmlParagraphNode as h, type OoxmlNoteNode as i, type OoxmlContinuationSeparatorNode as j, type OoxmlEndnotesNode as k, type OoxmlFootnotesNode as l, type OoxmlNoteRefNode as m, type OoxmlNoteReferenceNode as n, type OoxmlSeparatorNode as o, type TreeOpRejection as p, type OoxmlProperty as q, type OoxmlContentControlNode as r, type OoxmlContentControlContentNode as s, type RenderableImageMime as t, type ImageWrapTarget as u, type DrawingPositionInput as v, type DrawingLocks as w, type ImageResourceState as x, type SupportedImageMime as y, type DrawingHorizontalReferenceFrame as z };

package/dist/{tree-package-fragment-DjkH4ESI.d.ts → tree-package-fragment-DDQHk8sv.d.ts}

@@ -1,6 +1,6 @@
-import { b as OoxmlPackage, y as SupportedImageMime, O as OoxmlPart, C as RevisionAttributionInput, E as ImageDecodePort, F as DrawingTreeDocOp, p as TreeOpRejection, T as TreeDocOp } from './tree-op-types-egdarvH_.js';
-import { c as HeaderFooterKind, H as HeaderFooterVariant } from './hf-references-DTrHkktY.js';
-import { N as NoteKind, T as TreeModelChange, a as TreeDocumentStore, b as TreeStoryRef, c as TransactionContext, d as TransactOptions, S as SelectionMark, e as TreeDocumentCheckpoint } from './tree-store-DKJB0IcA.js';
+import { b as OoxmlPackage, y as SupportedImageMime, O as OoxmlPart, C as RevisionAttributionInput, E as ImageDecodePort, F as DrawingTreeDocOp, p as TreeOpRejection, T as TreeDocOp } from './tree-op-types-C5rZzoAz.js';
+import { c as HeaderFooterKind, H as HeaderFooterVariant } from './hf-references-BZVHctVD.js';
+import { N as NoteKind, T as TreeModelChange, a as TreeDocumentStore, b as TreeStoryRef, c as TransactionContext, d as TransactOptions, S as SelectionMark, e as TreeDocumentCheckpoint } from './tree-store-DU192chS.js';
 
 /** A freshly allocated drawing property id, or the reason one could not be minted. */
 type DrawingPropertyIdResult = {

package/dist/{tree-session-contract-CGOOgPjW.d.ts → tree-session-contract-dKgbKH9A.d.ts}

@@ -1,13 +1,13 @@
-import { S as StoryScope, a as StoryTargetRejection, I as InsertImageInput, b as ImageIntentResult, R as ReplaceImageOptions, A as ApplyImagePropertiesInput, F as FragmentPasteInput, c as FragmentPasteResult } from './tree-package-fragment-DjkH4ESI.js';
-import { T as TreeDocOp, O as OoxmlPart, a as OoxmlNode, b as OoxmlPackage, c as OoxmlElement, y as SupportedImageMime, E as ImageDecodePort, C as RevisionAttributionInput } from './tree-op-types-egdarvH_.js';
-import { a as HeaderFooterParts, b as HeaderFooterSectionResolution } from './hf-references-DTrHkktY.js';
-import { D as DocumentTrackingSettings, I as InsertCustomNodeWrite, C as CustomNodeWriteResult, a as CustomNodeSweepOutcome, E as EmbeddedFont, B as BookmarkIndex, L as ListKind } from './custom-node-writes-C9ArIlJh.js';
-import { H as HeadlessDocumentView, D as DocumentProperties } from './headless-document-view-DELC4E5v.js';
-import { S as SelectionMark, d as TransactOptions, T as TreeModelChange } from './tree-store-DKJB0IcA.js';
-import { a as ReviewItem } from './review-items-DYRx187i.js';
+import { S as StoryScope, a as StoryTargetRejection, I as InsertImageInput, b as ImageIntentResult, R as ReplaceImageOptions, A as ApplyImagePropertiesInput, F as FragmentPasteInput, c as FragmentPasteResult } from './tree-package-fragment-DDQHk8sv.js';
+import { T as TreeDocOp, O as OoxmlPart, a as OoxmlNode, b as OoxmlPackage, c as OoxmlElement, y as SupportedImageMime, E as ImageDecodePort, C as RevisionAttributionInput } from './tree-op-types-C5rZzoAz.js';
+import { a as HeaderFooterParts, b as HeaderFooterSectionResolution } from './hf-references-BZVHctVD.js';
+import { D as DocumentTrackingSettings, I as InsertCustomNodeWrite, C as CustomNodeWriteResult, a as CustomNodeSweepOutcome, E as EmbeddedFont, B as BookmarkIndex, L as ListKind } from './custom-node-writes-4WOL8JB_.js';
+import { H as HeadlessDocumentView, D as DocumentProperties } from './headless-document-view-C9ONlGtf.js';
+import { S as SelectionMark, d as TransactOptions, T as TreeModelChange } from './tree-store-DU192chS.js';
+import { a as ReviewItem } from './review-items-kC-YI70C.js';
 import { Node } from 'prosemirror-model';
 import { CollaborationDocumentPort } from './collaboration/replication.js';
-import { V as ViewScope } from './editor-sRxrFJd8.js';
+import { V as ViewScope } from './editor-scope-DZJT4ukT.js';
 
 /**
  * Why an edited projection could not be mapped back into tree ops.
@@ -362,6 +362,16 @@ interface TreeDocxSessionView extends HeadlessDocumentView {
      * into documents that never render a character in them.
      */
     renderedFontFamilies(): readonly string[];
+    /**
+     * Font families named by a `w:sym/@w:font`, over the same roots
+     * {@link TreeDocxSessionView.documentFonts} reads. Memoized per package revision.
+     *
+     * Separate from both other answers on purpose. It is not a DECLARATION, so it does not
+     * join `documentFonts`, and it is not a face TEXT renders in, so the substitution notice
+     * must not report it — but a font resolver has to hear about it, or an app cannot supply
+     * the face a private-use glyph needs.
+     */
+    symbolFontFamilies(): readonly string[];
     /**
      * Whether the document puts any literal character on a page, over the same roots
      * {@link TreeDocxSessionView.documentFonts} reads. Memoized per package revision.

package/dist/{tree-store-DKJB0IcA.d.ts → tree-store-DU192chS.d.ts}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docx-editor.dev/core",
-  "version": "2.15.0",
+  "version": "2.16.0",
   "description": "Framework-agnostic core for docx-editor.dev: OOXML parse/serialize, the canonical document tree, layout and paint, and the Editor contract the adapters render.",
   "type": "module",
   "engines": {
@@ -105,7 +105,7 @@
     "directory": "packages/core"
   },
   "dependencies": {
-    "@docx-editor.dev/i18n": "^2.15.0",
+    "@docx-editor.dev/i18n": "^2.16.0",
     "bidi-js": "1.0.3",
     "emf-converter": "2.0.2",
     "fast-xml-parser": "^5.10.1",