@stll/folio-core 0.14.1 → 0.15.1

package/dist/prosemirror/schema/nodes.d.ts

@@ -1,9 +1,9 @@
 import { document_d_exports } from "../../types/document.js";
 import { TrackedChangeProvenance } from "./marks.js";
+import "../../types/index.js";
 import { OutlineStyleAttr } from "../../types/documentEnumValues.js";
 import { SpacingExplicit } from "../../types/formatting.js";
 import { ParagraphDirection } from "../paragraphDirection.js";
-
 //#region src/prosemirror/schema/nodes.d.ts
 type HardBreakAttrs = {
   breakType?: "column";
@@ -14,17 +14,22 @@ type HardBreakAttrs = {
 type ParagraphAttrs = {
   paraId?: string;
   textId?: string;
-  alignment?: document_d_exports.ParagraphAlignment; /** Effective East Asian line-edge policy (`w:kinsoku`). */
-  kinsoku?: boolean; /** Effective hanging-punctuation policy (`w:overflowPunct`). */
-  overflowPunctuation?: boolean; /** Effective paragraph opt-out from document automatic hyphenation. */
+  alignment?: document_d_exports.ParagraphAlignment;
+  /** Effective East Asian line-edge policy (`w:kinsoku`). */
+  kinsoku?: boolean;
+  /** Effective hanging-punctuation policy (`w:overflowPunct`). */
+  overflowPunctuation?: boolean;
+  /** Effective paragraph opt-out from document automatic hyphenation. */
   suppressAutoHyphens?: boolean;
   spaceBefore?: number;
   spaceAfter?: number;
   lineSpacing?: number;
   lineSpacingRule?: document_d_exports.LineSpacingRule;
   snapToGrid?: boolean;
-  spacingExplicit?: SpacingExplicit; /** Layout provenance: document defaults survive on empty paragraphs. */
-  spacingFromDocDefaults?: SpacingExplicit; /** Layout provenance: implicit default-style spacing survives on empty paragraphs. */
+  spacingExplicit?: SpacingExplicit;
+  /** Layout provenance: document defaults survive on empty paragraphs. */
+  spacingFromDocDefaults?: SpacingExplicit;
+  /** Layout provenance: implicit default-style spacing survives on empty paragraphs. */
   spacingFromImplicitDefaultStyle?: SpacingExplicit;
   indentLeft?: number;
   indentRight?: number;
@@ -45,22 +50,32 @@ type ParagraphAttrs = {
   numPrFromStyle?: {
     numId?: number;
     ilvl?: number;
-  }; /** List number format (decimal, lowerRoman, upperRoman, etc.) for CSS counter styling */
-  listNumFmt?: document_d_exports.NumberFormat; /** Whether this is a bullet list */
-  listIsBullet?: boolean; /** Whether this level uses legal numbering (parent placeholders render decimal). */
-  listIsLegal?: boolean; /** Computed list marker text (e.g., "1.", "1.1.", "•") */
-  listMarker?: string; /** Whether the list marker is hidden (w:vanish on numbering level rPr) */
-  listMarkerHidden?: boolean; /** Marker font family from numbering level rPr */
-  listMarkerFontFamily?: string; /** Marker font size from numbering level rPr, in points */
-  listMarkerFontSize?: number; /** Marker bold state from numbering level rPr */
-  listMarkerBold?: boolean; /** Horizontal alignment of the marker around the paragraph's list anchor. */
+  };
+  /** List number format (decimal, lowerRoman, upperRoman, etc.) for CSS counter styling */
+  listNumFmt?: document_d_exports.NumberFormat;
+  /** Whether this is a bullet list */
+  listIsBullet?: boolean;
+  /** Whether this level uses legal numbering (parent placeholders render decimal). */
+  listIsLegal?: boolean;
+  /** Computed list marker text (e.g., "1.", "1.1.", "•") */
+  listMarker?: string;
+  /** Whether the list marker is hidden (w:vanish on numbering level rPr) */
+  listMarkerHidden?: boolean;
+  /** Marker font family from numbering level rPr */
+  listMarkerFontFamily?: string;
+  /** Marker font size from numbering level rPr, in points */
+  listMarkerFontSize?: number;
+  /** Marker bold state from numbering level rPr */
+  listMarkerBold?: boolean;
+  /** Horizontal alignment of the marker around the paragraph's list anchor. */
   listMarkerAlignment?: "left" | "center" | "right";
   /**
    * `w:suff` (§17.9.25) — what follows the marker before body text.
    * `tab` (default) grows the marker to the next tab stop; `space` adds one
    * space glyph; `nothing` lets body text butt against the marker.
    */
-  listMarkerSuffix?: "tab" | "space" | "nothing"; /** `w:caps` on the numbering level rPr — render marker in upper case. */
+  listMarkerSuffix?: "tab" | "space" | "nothing";
+  /** `w:caps` on the numbering level rPr — render marker in upper case. */
   listMarkerAllCaps?: boolean;
   /**
    * Inline LISTNUM count carried by this paragraph. Each advances the
@@ -73,10 +88,14 @@ type ParagraphAttrs = {
    * twips) is where the slot after the tab should land — used to align an
    * inline LISTNUM "(a)" with the deeper level's marker column.
    */
-  listMarkerSecondSlotOffsetTwips?: number; /** Number format for each level used by multi-level marker templates. */
-  listLevelNumFmts?: document_d_exports.NumberFormat[]; /** Initial counter for each level used by multi-level marker templates. */
-  listLevelStarts?: number[]; /** Abstract numbering ID shared by numbering instances. */
-  listAbstractNumId?: number; /** Numbering start override for this numId/level. */
+  listMarkerSecondSlotOffsetTwips?: number;
+  /** Number format for each level used by multi-level marker templates. */
+  listLevelNumFmts?: document_d_exports.NumberFormat[];
+  /** Initial counter for each level used by multi-level marker templates. */
+  listLevelStarts?: number[];
+  /** Abstract numbering ID shared by numbering instances. */
+  listAbstractNumId?: number;
+  /** Numbering start override for this numId/level. */
   listStartOverride?: number;
   styleId?: string;
   borders?: {
@@ -89,13 +108,17 @@ type ParagraphAttrs = {
   };
   shading?: document_d_exports.ShadingProperties;
   tabs?: document_d_exports.TabStop[];
-  pageBreakBefore?: boolean; /** Word's cached rendered-page-break marker; preserved for round-trip only. */
-  renderedPageBreakBefore?: boolean; /** Internal import marker for a paragraph whose only run content is a hard page break. */
-  _pageBreakCarrier?: boolean; /** Internal import marker for a hard page break after this paragraph's text. */
+  pageBreakBefore?: boolean;
+  /** Word's cached rendered-page-break marker; preserved for round-trip only. */
+  renderedPageBreakBefore?: boolean;
+  /** Internal import marker for a paragraph whose only run content is a hard page break. */
+  _pageBreakCarrier?: boolean;
+  /** Internal import marker for a hard page break after this paragraph's text. */
   _trailingPageBreak?: boolean;
   keepNext?: boolean;
   keepLines?: boolean;
-  widowControl?: boolean; /** Contextual spacing — suppress space between same-style paragraphs */
+  widowControl?: boolean;
+  /** Contextual spacing — suppress space between same-style paragraphs */
   contextualSpacing?: boolean;
   defaultTextFormatting?: document_d_exports.TextFormatting;
   sectionBreakType?: "nextPage" | "continuous" | "oddPage" | "evenPage";
@@ -115,7 +138,8 @@ type ParagraphAttrs = {
    *  Preserve their relationship metadata at the paragraph boundary so a
    *  no-edit DOCX round-trip does not silently drop hyperlink elements. */
   _emptyHyperlinks?: {
-    /** ProseMirror inline offset where the zero-width hyperlink appeared. */offset: number;
+    /** ProseMirror inline offset where the zero-width hyperlink appeared. */
+    offset: number;
     href?: document_d_exports.Hyperlink["href"];
     anchor?: document_d_exports.Hyperlink["anchor"];
     tooltip?: document_d_exports.Hyperlink["tooltip"];
@@ -180,23 +204,34 @@ type ImagePositionAttrs = {
  */
 type ImageAttrs = {
   src: string;
+  docPrName?: string;
   alt?: string;
-  title?: string; /** Width in pixels (already converted from EMU) */
-  width?: number; /** Height in pixels (already converted from EMU) */
+  title?: string;
+  /** Width in pixels (already converted from EMU) */
+  width?: number;
+  /** Height in pixels (already converted from EMU) */
   height?: number;
-  rId?: string; /** Wrap type from DOCX: inline, square, tight, through, topAndBottom, behind, inFront */
-  wrapType?: document_d_exports.ImageWrap["type"]; /** Display mode for CSS: inline (flows with text), float (left/right float), block (centered) */
-  displayMode?: "inline" | "float" | "block"; /** CSS float direction for floating images */
-  cssFloat?: "left" | "right" | "none"; /** CSS transform string (rotation, flip) */
+  rId?: string;
+  /** Wrap type from DOCX: inline, square, tight, through, topAndBottom, behind, inFront */
+  wrapType?: document_d_exports.ImageWrap["type"];
+  /** Display mode for CSS: inline (flows with text), float (left/right float), block (centered) */
+  displayMode?: "inline" | "float" | "block";
+  /** CSS float direction for floating images */
+  cssFloat?: "left" | "right" | "none";
+  /** CSS transform string (rotation, flip) */
   transform?: string;
   /**
    * Opacity in [0, 1] from `<a:alphaModFix amt>`. Undefined / 1 means fully
    * opaque (no CSS `opacity` emitted). eigenpal #424.
    */
-  opacity?: number; /** Distance from text above (pixels) */
-  distTop?: number; /** Distance from text below (pixels) */
-  distBottom?: number; /** Distance from text left (pixels) */
-  distLeft?: number; /** Distance from text right (pixels) */
+  opacity?: number;
+  /** Distance from text above (pixels) */
+  distTop?: number;
+  /** Distance from text below (pixels) */
+  distBottom?: number;
+  /** Distance from text left (pixels) */
+  distLeft?: number;
+  /** Distance from text right (pixels) */
   distRight?: number;
   /**
    * wp:srcRect crop fractions in [0, 1]. Carried through the editor so a
@@ -206,53 +241,87 @@ type ImageAttrs = {
   cropTop?: number;
   cropRight?: number;
   cropBottom?: number;
-  cropLeft?: number; /** Position for floating images (horizontal and vertical alignment) */
-  position?: ImagePositionAttrs; /** Use the containing table cell as the anchor's positioning scope (the OOXML default). */
-  layoutInCell?: boolean; /** Border width in pixels */
-  borderWidth?: number; /** Border color as CSS color string */
-  borderColor?: string; /** Border style (CSS border-style value) */
-  borderStyle?: string; /** Wrap text setting from DOCX (left, right, bothSides, largest) for round-trip */
-  wrapText?: NonNullable<document_d_exports.ImageWrap["wrapText"]>; /** Hyperlink URL for clickable image */
-  hlinkHref?: string; /** Original OOXML for opaque/unsupported DOCX drawings. */
-  _docxRawXml?: string; /** Embedded-object previews use their authored box as the exact line height. */
+  cropLeft?: number;
+  /** Position for floating images (horizontal and vertical alignment) */
+  position?: ImagePositionAttrs;
+  /** Use the containing table cell as the anchor's positioning scope (the OOXML default). */
+  layoutInCell?: boolean;
+  /** Border width in pixels */
+  borderWidth?: number;
+  /** Border color as CSS color string */
+  borderColor?: string;
+  /** Border style (CSS border-style value) */
+  borderStyle?: string;
+  /** Wrap text setting from DOCX (left, right, bothSides, largest) for round-trip */
+  wrapText?: NonNullable<document_d_exports.ImageWrap["wrapText"]>;
+  /** Hyperlink URL for clickable image */
+  hlinkHref?: string;
+  /** DOCX relationship ID for the clickable image hyperlink */
+  hlinkRId?: string;
+  /** Original OOXML for opaque/unsupported DOCX drawings. */
+  _docxRawXml?: string;
+  /** Embedded-object previews use their authored box as the exact line height. */
   _docxObjectPreview?: boolean;
 };
 /**
  * Field node attributes
  */
 type FieldAttrs = {
-  /** Field type: PAGE, NUMPAGES, DATE, MERGEFIELD, etc. */fieldType: document_d_exports.FieldType; /** Full field instruction (e.g. "PAGE \\* MERGEFORMAT") */
-  instruction: string; /** Current/cached display text */
-  displayText: string; /** Whether the field came from w:fldSimple or a complex fldChar range */
-  fieldKind: "simple" | "complex"; /** Field is locked */
-  fldLock?: boolean; /** Field is dirty and should be recalculated by the host application */
+  /** Field type: PAGE, NUMPAGES, DATE, MERGEFIELD, etc. */
+  fieldType: document_d_exports.FieldType;
+  /** Full field instruction (e.g. "PAGE \\* MERGEFORMAT") */
+  instruction: string;
+  /** Current/cached display text */
+  displayText: string;
+  /** Whether the field came from w:fldSimple or a complex fldChar range */
+  fieldKind: "simple" | "complex";
+  /** Field is locked */
+  fldLock?: boolean;
+  /** Field is dirty and should be recalculated by the host application */
   dirty?: boolean;
 };
 /**
  * Math equation node attributes
  */
 type MathAttrs = {
-  /** Whether this is inline OMML or a block equation paragraph */display?: "inline" | "block"; /** Raw OMML XML for round-trip preservation */
-  ommlXml: string; /** Plain text fallback used by the editor and layout engine */
+  /** Whether this is inline OMML or a block equation paragraph */
+  display?: "inline" | "block";
+  /** Raw OMML XML for round-trip preservation */
+  ommlXml: string;
+  /** Plain text fallback used by the editor and layout engine */
   plainText?: string;
 };
 /**
  * Structured document tag node attributes
  */
 type SdtAttrs = {
-  /** SDT type */sdtType: document_d_exports.SdtType; /** Alias (friendly name) */
-  alias?: string; /** Tag (developer identifier) */
-  tag?: string; /** Numeric `w:id/@w:val`. */
-  id?: number; /** Lock setting */
-  lock?: NonNullable<document_d_exports.SdtProperties["lock"]>; /** Placeholder text */
-  placeholder?: string; /** Whether showing placeholder */
-  showingPlaceholder?: boolean; /** Date format for date controls */
-  dateFormat?: string; /** ISO 8601 bound date value (`w:date@w:fullDate`). */
-  dateValueISO?: string; /** Dropdown/combobox list items as JSON string */
-  listItems?: string; /** Selected dropdown / comboBox value (`w:dropDownList@w:lastValue`). */
-  dropdownLastValue?: string; /** Checkbox checked state */
-  checked?: boolean; /** Captured `<w:sdtPr>…</w:sdtPr>` for round-trip replay. */
-  rawPropertiesXml?: string; /** Captured `<w:sdtEndPr>…</w:sdtEndPr>` for round-trip replay. */
+  /** SDT type */
+  sdtType: document_d_exports.SdtType;
+  /** Alias (friendly name) */
+  alias?: string;
+  /** Tag (developer identifier) */
+  tag?: string;
+  /** Numeric `w:id/@w:val`. */
+  id?: number;
+  /** Lock setting */
+  lock?: NonNullable<document_d_exports.SdtProperties["lock"]>;
+  /** Placeholder text */
+  placeholder?: string;
+  /** Whether showing placeholder */
+  showingPlaceholder?: boolean;
+  /** Date format for date controls */
+  dateFormat?: string;
+  /** ISO 8601 bound date value (`w:date@w:fullDate`). */
+  dateValueISO?: string;
+  /** Dropdown/combobox list items as JSON string */
+  listItems?: string;
+  /** Selected dropdown / comboBox value (`w:dropDownList@w:lastValue`). */
+  dropdownLastValue?: string;
+  /** Checkbox checked state */
+  checked?: boolean;
+  /** Captured `<w:sdtPr>…</w:sdtPr>` for round-trip replay. */
+  rawPropertiesXml?: string;
+  /** Captured `<w:sdtEndPr>…</w:sdtEndPr>` for round-trip replay. */
   rawEndPropertiesXml?: string;
 };
 /**
@@ -263,14 +332,18 @@ type SdtAttrs = {
 type BlockSdtAttrs = {
   sdtType: document_d_exports.SdtType;
   alias?: string;
-  tag?: string; /** Numeric `w:id/@w:val`. */
+  tag?: string;
+  /** Numeric `w:id/@w:val`. */
   id?: number;
   lock?: NonNullable<document_d_exports.SdtProperties["lock"]>;
   placeholder?: string;
   showingPlaceholder?: boolean;
-  dateFormat?: string; /** ISO 8601 bound date value (`w:date@w:fullDate`). */
-  dateValueISO?: string; /** Dropdown/combobox list items as JSON string. */
-  listItems?: string; /** Selected dropdown / comboBox value (`w:dropDownList@w:lastValue`). */
+  dateFormat?: string;
+  /** ISO 8601 bound date value (`w:date@w:fullDate`). */
+  dateValueISO?: string;
+  /** Dropdown/combobox list items as JSON string. */
+  listItems?: string;
+  /** Selected dropdown / comboBox value (`w:dropDownList@w:lastValue`). */
   dropdownLastValue?: string;
   checked?: boolean;
   /**
@@ -278,77 +351,142 @@ type BlockSdtAttrs = {
    * filler paragraph to satisfy PM's `block+`; on save the converter
    * uses this flag to drop the filler instead of guessing from shape.
    */
-  _originallyEmpty?: boolean; /** Captured `<w:sdtPr>…</w:sdtPr>` for round-trip replay. */
-  rawPropertiesXml?: string; /** Captured `<w:sdtEndPr>…</w:sdtEndPr>` for round-trip replay. */
-  rawEndPropertiesXml?: string; /** Verbatim XML for sdt siblings before sdtContent (range markers). */
-  rawSdtChildrenBeforeContent?: string; /** Verbatim XML for sdt siblings after sdtContent (range markers). */
+  _originallyEmpty?: boolean;
+  /** Captured `<w:sdtPr>…</w:sdtPr>` for round-trip replay. */
+  rawPropertiesXml?: string;
+  /** Captured `<w:sdtEndPr>…</w:sdtEndPr>` for round-trip replay. */
+  rawEndPropertiesXml?: string;
+  /** Verbatim XML for sdt siblings before sdtContent (range markers). */
+  rawSdtChildrenBeforeContent?: string;
+  /** Verbatim XML for sdt siblings after sdtContent (range markers). */
   rawSdtChildrenAfterContent?: string;
 };
 /**
  * Shape node attributes
  */
 type ShapeAttrs = {
-  /** Shape type preset */shapeType?: string; /** Unique identifier */
-  shapeId?: string; /** Width in pixels */
-  width?: number; /** Height in pixels */
-  height?: number; /** Fill color as CSS color */
-  fillColor?: string; /** Fill type: none, solid, gradient, pattern, picture */
-  fillType?: document_d_exports.ShapeFill["type"]; /** Gradient type: linear, radial, rectangular, path */
-  gradientType?: NonNullable<document_d_exports.ShapeFill["gradient"]>["type"]; /** Gradient angle in degrees (for linear) */
-  gradientAngle?: number; /** Gradient stops as JSON string: [{position, color}] */
-  gradientStops?: string; /** Outline width in pixels */
-  outlineWidth?: number; /** Outline color as CSS color */
-  outlineColor?: string; /** Outline dash style, or `"none"` for an explicit no-outline. */
-  outlineStyle?: OutlineStyleAttr; /** Line cap */
-  outlineCap?: NonNullable<document_d_exports.ShapeOutline["cap"]>; /** Head arrow/end marker */
-  outlineHeadEnd?: NonNullable<document_d_exports.ShapeOutline["headEnd"]>; /** Tail arrow/end marker */
-  outlineTailEnd?: NonNullable<document_d_exports.ShapeOutline["tailEnd"]>; /** CSS transform */
-  transform?: string; /** Display mode */
-  displayMode?: "inline" | "float" | "block"; /** CSS float */
-  cssFloat?: "left" | "right" | "none"; /** Wrap type */
-  wrapType?: document_d_exports.ImageWrap["type"]; /** Wrap text setting from DOCX (left, right, bothSides, largest) for round-trip */
-  wrapText?: NonNullable<document_d_exports.ImageWrap["wrapText"]>; /** Distance from text above (pixels) */
-  distTop?: number; /** Distance from text below (pixels) */
-  distBottom?: number; /** Distance from text left (pixels) */
-  distLeft?: number; /** Distance from text right (pixels) */
-  distRight?: number; /** Position for floating shapes (horizontal and vertical alignment) */
-  position?: ImagePositionAttrs; /** Shadow color as CSS color */
-  shadowColor?: string; /** Shadow blur radius in pixels */
-  shadowBlur?: number; /** Shadow X offset in pixels */
-  shadowOffsetX?: number; /** Shadow Y offset in pixels */
-  shadowOffsetY?: number; /** Glow color as CSS color */
-  glowColor?: string; /** Glow radius in pixels */
+  /** Shape type preset */
+  shapeType?: string;
+  /** Unique identifier */
+  shapeId?: string;
+  /** Width in pixels */
+  width?: number;
+  /** Height in pixels */
+  height?: number;
+  /** Fill color as CSS color */
+  fillColor?: string;
+  /** Authored OOXML fill color, retained when it references a theme slot. */
+  fillColorValue?: document_d_exports.ShapeFill["color"];
+  /** Fill type: none, solid, gradient, pattern, picture */
+  fillType?: document_d_exports.ShapeFill["type"];
+  /** Gradient type: linear, radial, rectangular, path */
+  gradientType?: NonNullable<document_d_exports.ShapeFill["gradient"]>["type"];
+  /** Gradient angle in degrees (for linear) */
+  gradientAngle?: number;
+  /** Gradient stops as JSON string: [{position, color}] */
+  gradientStops?: string;
+  /** Outline width in pixels */
+  outlineWidth?: number;
+  /** Outline color as CSS color */
+  outlineColor?: string;
+  /** Authored OOXML outline color, retained when it references a theme slot. */
+  outlineColorValue?: document_d_exports.ShapeOutline["color"];
+  /** Outline dash style, or `"none"` for an explicit no-outline. */
+  outlineStyle?: OutlineStyleAttr;
+  /** Line cap */
+  outlineCap?: NonNullable<document_d_exports.ShapeOutline["cap"]>;
+  /** Head arrow/end marker */
+  outlineHeadEnd?: NonNullable<document_d_exports.ShapeOutline["headEnd"]>;
+  /** Tail arrow/end marker */
+  outlineTailEnd?: NonNullable<document_d_exports.ShapeOutline["tailEnd"]>;
+  /** CSS transform */
+  transform?: string;
+  /** Display mode */
+  displayMode?: "inline" | "float" | "block";
+  /** CSS float */
+  cssFloat?: "left" | "right" | "none";
+  /** Wrap type */
+  wrapType?: document_d_exports.ImageWrap["type"];
+  /** Wrap text setting from DOCX (left, right, bothSides, largest) for round-trip */
+  wrapText?: NonNullable<document_d_exports.ImageWrap["wrapText"]>;
+  /** Distance from text above (pixels) */
+  distTop?: number;
+  /** Distance from text below (pixels) */
+  distBottom?: number;
+  /** Distance from text left (pixels) */
+  distLeft?: number;
+  /** Distance from text right (pixels) */
+  distRight?: number;
+  /** Position for floating shapes (horizontal and vertical alignment) */
+  position?: ImagePositionAttrs;
+  /** Shadow color as CSS color */
+  shadowColor?: string;
+  /** Shadow blur radius in pixels */
+  shadowBlur?: number;
+  /** Shadow X offset in pixels */
+  shadowOffsetX?: number;
+  /** Shadow Y offset in pixels */
+  shadowOffsetY?: number;
+  /** Glow color as CSS color */
+  glowColor?: string;
+  /** Glow radius in pixels */
   glowRadius?: number;
 };
 /**
  * Text box node attributes
  */
 type TextBoxAttrs = {
-  /** Width in pixels */width?: number; /** Height in pixels */
-  height?: number; /** Text fitting behavior */
-  autoFit?: document_d_exports.ShapeTextBody["autoFit"]; /** Unique identifier */
-  textBoxId?: string; /** Fill color as CSS color */
-  fillColor?: string; /** Outline width in pixels */
-  outlineWidth?: number; /** Outline color as CSS color */
-  outlineColor?: string; /** Outline dash style, or `"none"` for an explicit no-outline. */
-  outlineStyle?: OutlineStyleAttr; /** Internal margin top in pixels */
-  marginTop?: number; /** Internal margin bottom in pixels */
-  marginBottom?: number; /** Internal margin left in pixels */
-  marginLeft?: number; /** Internal margin right in pixels */
-  marginRight?: number; /** Vertical text alignment */
-  verticalAlign?: string; /** Display mode */
-  displayMode?: "inline" | "float" | "block"; /** CSS float direction */
-  cssFloat?: "left" | "right" | "none"; /** Wrap type */
-  wrapType?: document_d_exports.ImageWrap["type"]; /** OOXML wrapText direction for anchored text boxes (eigenpal #474). */
-  wrapText?: "bothSides" | "left" | "right" | "largest"; /** Wrap distance from top edge, in pixels (OOXML distT, EMU-converted). */
-  distTop?: number; /** Wrap distance from bottom edge, in pixels. */
-  distBottom?: number; /** Wrap distance from left edge, in pixels. */
-  distLeft?: number; /** Wrap distance from right edge, in pixels. */
-  distRight?: number; /** Position for floating/anchored text boxes */
-  position?: ImagePositionAttrs; /** Original DOCX placement hint for save-path reconstruction. */
-  _docxPlacement?: "standalone" | "inlineWithPrevious"; /** Original DOCX paragraph group for standalone text-box reconstruction. */
-  _docxGroupId?: string; /** Inline anchor linking this block node to its source run position. */
-  _docxAnchorId?: string; /** Original run-level revision wrapper for save-path reconstruction. */
+  /** Width in pixels */
+  width?: number;
+  /** Height in pixels */
+  height?: number;
+  /** Text fitting behavior */
+  autoFit?: document_d_exports.ShapeTextBody["autoFit"];
+  /** Unique identifier */
+  textBoxId?: string;
+  /** Fill color as CSS color */
+  fillColor?: string;
+  /** Outline width in pixels */
+  outlineWidth?: number;
+  /** Outline color as CSS color */
+  outlineColor?: string;
+  /** Outline dash style, or `"none"` for an explicit no-outline. */
+  outlineStyle?: OutlineStyleAttr;
+  /** Internal margin top in pixels */
+  marginTop?: number;
+  /** Internal margin bottom in pixels */
+  marginBottom?: number;
+  /** Internal margin left in pixels */
+  marginLeft?: number;
+  /** Internal margin right in pixels */
+  marginRight?: number;
+  /** Vertical text alignment */
+  verticalAlign?: string;
+  /** Display mode */
+  displayMode?: "inline" | "float" | "block";
+  /** CSS float direction */
+  cssFloat?: "left" | "right" | "none";
+  /** Wrap type */
+  wrapType?: document_d_exports.ImageWrap["type"];
+  /** OOXML wrapText direction for anchored text boxes (eigenpal #474). */
+  wrapText?: "bothSides" | "left" | "right" | "largest";
+  /** Wrap distance from top edge, in pixels (OOXML distT, EMU-converted). */
+  distTop?: number;
+  /** Wrap distance from bottom edge, in pixels. */
+  distBottom?: number;
+  /** Wrap distance from left edge, in pixels. */
+  distLeft?: number;
+  /** Wrap distance from right edge, in pixels. */
+  distRight?: number;
+  /** Position for floating/anchored text boxes */
+  position?: ImagePositionAttrs;
+  /** Original DOCX placement hint for save-path reconstruction. */
+  _docxPlacement?: "standalone" | "inlineWithPrevious";
+  /** Original DOCX paragraph group for standalone text-box reconstruction. */
+  _docxGroupId?: string;
+  /** Inline anchor linking this block node to its source run position. */
+  _docxAnchorId?: string;
+  /** Original run-level revision wrapper for save-path reconstruction. */
   _docxTrackedChange?: {
     type: "insertion";
     info: document_d_exports.TrackedChangeInfo;
@@ -361,7 +499,8 @@ type TextBoxAttrs = {
   } | {
     type: "moveTo";
     info: document_d_exports.TrackedChangeInfo;
-  }; /** Original inline content-control ancestry for save-path reconstruction. */
+  };
+  /** Original inline content-control ancestry for save-path reconstruction. */
   _docxInlineSdts?: SdtAttrs[];
 };
 /** Internal inline position marker for an extracted text box block. */
@@ -372,22 +511,34 @@ type TextBoxAnchorAttrs = {
  * Table node attributes
  */
 type TableAttrs = {
-  /** Table style ID */styleId?: string; /** Table width (in twips) */
-  width?: number; /** Table width type ('auto', 'pct', 'dxa') */
-  widthType?: document_d_exports.TableWidthType; /** Table justification/alignment */
-  justification?: "left" | "center" | "right"; /** Column widths (in twips) from w:tblGrid */
-  columnWidths?: number[]; /** Floating table properties (w:tblpPr) */
-  floating?: document_d_exports.FloatingTableProperties; /** Default cell margins for the table (w:tblCellMar), in twips */
+  /** Table style ID */
+  styleId?: string;
+  /** Table width (in twips) */
+  width?: number;
+  /** Table width type ('auto', 'pct', 'dxa') */
+  widthType?: document_d_exports.TableWidthType;
+  /** Table justification/alignment */
+  justification?: "left" | "center" | "right";
+  /** Column widths (in twips) from w:tblGrid */
+  columnWidths?: number[];
+  /** Floating table properties (w:tblpPr) */
+  floating?: document_d_exports.FloatingTableProperties;
+  /** Default cell margins for the table (w:tblCellMar), in twips */
   cellMargins?: {
     top?: number;
     bottom?: number;
     left?: number;
     right?: number;
-  }; /** Table look flags for conditional formatting (w:tblLook) */
-  look?: document_d_exports.TableLook; /** Table-level borders (w:tblBorders) — full BorderSpec per side */
-  borders?: document_d_exports.TableBorders; /** Effective table indent after style resolution. PM-only; never serialized. */
-  _resolvedIndent?: NonNullable<document_d_exports.TableFormatting["indent"]>; /** Original table formatting from DOCX for lossless round-trip serialization */
-  _originalFormatting?: document_d_exports.TableFormatting; /** Tracked table property changes (w:tblPrChange) for round-trip + accept/reject */
+  };
+  /** Table look flags for conditional formatting (w:tblLook) */
+  look?: document_d_exports.TableLook;
+  /** Table-level borders (w:tblBorders) — full BorderSpec per side */
+  borders?: document_d_exports.TableBorders;
+  /** Effective table indent after style resolution. PM-only; never serialized. */
+  _resolvedIndent?: NonNullable<document_d_exports.TableFormatting["indent"]>;
+  /** Original table formatting from DOCX for lossless round-trip serialization */
+  _originalFormatting?: document_d_exports.TableFormatting;
+  /** Tracked table property changes (w:tblPrChange) for round-trip + accept/reject */
   tblPrChange?: document_d_exports.TablePropertyChange[];
   /**
    * Marks this whole table as a *suggested* insertion (AI proposal). The table
@@ -400,11 +551,17 @@ type TableAttrs = {
  * Table row attributes
  */
 type TableRowAttrs = {
-  /** Row height (in twips) */height?: number; /** Height rule ('auto', 'exact', 'atLeast') */
-  heightRule?: NonNullable<document_d_exports.TableRowFormatting["heightRule"]>; /** Is header row */
-  isHeader?: boolean; /** Whether the row is hidden (`w:hidden`) */
-  hidden?: boolean; /** Original row formatting from DOCX for lossless round-trip serialization */
-  _originalFormatting?: document_d_exports.TableRowFormatting; /** Tracked row property changes (w:trPrChange) for round-trip + accept/reject */
+  /** Row height (in twips) */
+  height?: number;
+  /** Height rule ('auto', 'exact', 'atLeast') */
+  heightRule?: NonNullable<document_d_exports.TableRowFormatting["heightRule"]>;
+  /** Is header row */
+  isHeader?: boolean;
+  /** Whether the row is hidden (`w:hidden`) */
+  hidden?: boolean;
+  /** Original row formatting from DOCX for lossless round-trip serialization */
+  _originalFormatting?: document_d_exports.TableRowFormatting;
+  /** Tracked row property changes (w:trPrChange) for round-trip + accept/reject */
   trPrChange?: document_d_exports.TableRowPropertyChange[];
 } & ({
   /**
@@ -423,7 +580,8 @@ type TableRowAttrs = {
   };
   trDel?: never;
 } | {
-  trIns?: never; /** Tracked structural row deletion (w:trPr/w:del). */
+  trIns?: never;
+  /** Tracked structural row deletion (w:trPr/w:del). */
   trDel: {
     revisionId: number;
     author: string;
@@ -454,33 +612,50 @@ type SuggestedStructuralMarker = {
  * Table cell attributes
  */
 type TableCellAttrs = {
-  /** Column span */colspan: number; /** Row span */
-  rowspan: number; /** Column widths for prosemirror-tables resizing (array of pixel widths) */
-  colwidth?: number[] | null; /** Cell width (in twips) */
-  width?: number; /** Cell width type */
-  widthType?: document_d_exports.TableWidthType; /** Vertical alignment */
-  verticalAlign?: "top" | "center" | "bottom"; /** Background color (RGB hex) */
-  backgroundColor?: string; /** Resolved source color. PM-only; distinguishes theme rendering from a user override. */
-  _resolvedBackgroundColor?: string; /** OOXML text direction (e.g. 'tbRl', 'btLr') */
-  textDirection?: NonNullable<document_d_exports.TableCellFormatting["textDirection"]>; /** No text wrapping in cell */
-  noWrap?: boolean; /** Effective end-of-cell marker suppression (`w:hideMark`). */
-  hideMark?: boolean; /** Cell borders — full BorderSpec per side (style, color, size) */
-  borders?: document_d_exports.TableCellBorders; /** Cell margins/padding in twips per side */
+  /** Column span */
+  colspan: number;
+  /** Row span */
+  rowspan: number;
+  /** Column widths for prosemirror-tables resizing (array of pixel widths) */
+  colwidth?: number[] | null;
+  /** Cell width (in twips) */
+  width?: number;
+  /** Cell width type */
+  widthType?: document_d_exports.TableWidthType;
+  /** Vertical alignment */
+  verticalAlign?: "top" | "center" | "bottom";
+  /** Background color (RGB hex) */
+  backgroundColor?: string;
+  /** Resolved source color. PM-only; distinguishes theme rendering from a user override. */
+  _resolvedBackgroundColor?: string;
+  /** OOXML text direction (e.g. 'tbRl', 'btLr') */
+  textDirection?: NonNullable<document_d_exports.TableCellFormatting["textDirection"]>;
+  /** No text wrapping in cell */
+  noWrap?: boolean;
+  /** Effective end-of-cell marker suppression (`w:hideMark`). */
+  hideMark?: boolean;
+  /** Cell borders — full BorderSpec per side (style, color, size) */
+  borders?: document_d_exports.TableCellBorders;
+  /** Cell margins/padding in twips per side */
   margins?: {
     top?: number;
     bottom?: number;
     left?: number;
     right?: number;
-  }; /** Original cell formatting from DOCX for lossless round-trip serialization */
-  _originalFormatting?: document_d_exports.TableCellFormatting; /** Tracked cell property changes (w:tcPrChange) for round-trip + accept/reject */
-  tcPrChange?: document_d_exports.TableCellPropertyChange[]; /** Tracked cell structural revision for round-trip + accept/reject. */
+  };
+  /** Original cell formatting from DOCX for lossless round-trip serialization */
+  _originalFormatting?: document_d_exports.TableCellFormatting;
+  /** Tracked cell property changes (w:tcPrChange) for round-trip + accept/reject */
+  tcPrChange?: document_d_exports.TableCellPropertyChange[];
+  /** Tracked cell structural revision for round-trip + accept/reject. */
   cellMarker?: {
     kind: "ins" | "del";
     info: {
       revisionId: number;
       author: string;
       date?: string | null;
-      initials?: string | null; /** `"suggested"` marks this as an AI proposal (stripped until accepted). */
+      initials?: string | null;
+      /** `"suggested"` marks this as an AI proposal (stripped until accepted). */
       provenance?: TrackedChangeProvenance;
       suggestionId?: string | null;
     };
@@ -499,8 +674,10 @@ type TableCellAttrs = {
     };
     verticalMerge?: "continue" | "rest";
     verticalMergeOriginal?: "continue" | "rest";
-  }; /** Preserve a DOCX vMerge restart even when PM cannot model it as a rowspan. */
-  _preserveVMergeRestart?: boolean; /** Original DOCX vMerge continuation cells skipped into this PM rowspan. */
+  };
+  /** Preserve a DOCX vMerge restart even when PM cannot model it as a rowspan. */
+  _preserveVMergeRestart?: boolean;
+  /** Original DOCX vMerge continuation cells skipped into this PM rowspan. */
   _docxVMergeContinuationCells?: document_d_exports.TableCell[];
 };
 //#endregion