@stll/folio-core 0.45.0 → 0.47.0

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

@@ -6,7 +6,7 @@ import { document_d_exports } from "../../types/document.js";
  */
 type TextColorAttrs = {
   rgb?: string;
-  themeColor?: document_d_exports.ThemeColorSlot;
+  themeColor?: document_d_exports.ThemeColor;
   themeTint?: string;
   themeShade?: string;
 };
@@ -115,6 +115,8 @@ type TrackedChangeMarkAttrs = {
    * `null` default is normalized to absent by the attrs reader).
    */
   suggestionId?: string;
+  /** Imported deleted content uses its pre-change formatting hierarchy. */
+  _historicalFormatting?: true;
 };
 /** Run-property revisions carried through the editable model. */
 type RunPropertyChangeMarkAttrs = {
@@ -123,9 +125,50 @@ type RunPropertyChangeMarkAttrs = {
   provenance: TrackedChangeProvenance;
   suggestionId?: string;
 };
-/** Editor-only identity for one authored run that contains an explicit page break. */
-type PageBreakRunOwnerMarkAttrs = {
+/**
+ * Editor-side identity for one authored `w:r`, and everything about that
+ * element the model holds but no formatting mark carries.
+ *
+ * One mark rather than three, because all three payloads are facts about one
+ * element and the save leg asks that element a single question: where does
+ * this run begin and end. Two marks could give two answers to it, and nothing
+ * in the schema would force a resolution.
+ *
+ * Minted only when the run has something to carry — a page break, an
+ * attribute remainder, or a property-set remainder — so a document that
+ * carries none pays nothing.
+ */
+type RunIdentityMarkAttrs = {
+  /** The authored run this leaf came from. Monotonic within one parse. */
   id: number;
+  /** `w:r`'s attribute remainder: resolved names, source order. */
+  preservedAttributes?: readonly document_d_exports.PreservedAttribute[];
+  /** The `w:rPr` children no reader took a value from, with their ordinals. */
+  preserved?: document_d_exports.PreservedMarkup;
+};
+/**
+ * One transparent wrapper a leaf sits inside, minus the content ProseMirror
+ * now holds instead.
+ *
+ * Distributed over the model's union rather than written out beside it: a
+ * wrapper kind exists in both places or in neither, and the fields a kind
+ * carries are stated once. A smart tag cannot gain a `control` this way, and
+ * a kind added to the model reaches the editor as a compile error at every
+ * site that decides per kind.
+ */
+type WrapperLayer<Wrapper> = Wrapper extends unknown ? Omit<Wrapper, "type" | "content"> : never;
+type InlineWrapperLayer = WrapperLayer<document_d_exports.InlineWrapper>;
+type InlineWrapperKind = InlineWrapperLayer["kind"];
+/**
+ * The wrappers a leaf sits inside, outermost first.
+ *
+ * Multiplicity lives here rather than in the mark set: ProseMirror marks are
+ * unordered across types and a mark excludes its own type, so nesting a
+ * wrapper inside another cannot be spelled as two marks. `null` is no
+ * wrapper; an empty stack is never stored.
+ */
+type InlineWrapperAttrs = {
+  stack: readonly InlineWrapperLayer[];
 };
 declare const COMPLEX_SCRIPT_RUN_PROPERTY_KEYS: readonly ["boldCs", "italicCs", "fontSizeCs"];
 type ComplexScriptRunPropertyKey = (typeof COMPLEX_SCRIPT_RUN_PROPERTY_KEYS)[number];
@@ -231,4 +274,4 @@ type HyperlinkAttrs = {
   _docxHyperlinkIndex?: number;
 };
 //#endregion
-export { AuthoredRunFormattingValues, COMPLEX_SCRIPT_RUN_PROPERTY_KEYS, CharacterSpacingAttrs, CharacterStyleAttrs, CommentAttrs, ComplexScriptRunPropertyKey, EmphasisMarkAttrs, FontFamilyAttrs, FontSizeAttrs, FootnoteRefAttrs, HighlightAttrs, HyperlinkAttrs, LanguageAttrs, PageBreakRunOwnerMarkAttrs, RUN_FORMATTING_BOOLEAN_PROPERTIES, RUN_FORMATTING_PROPERTY_SPECS, RUN_FORMATTING_VALUE_PROPERTIES, RunFormattingBooleanProperty, RunFormattingOverrideAttrs, RunFormattingValueProperty, RunPropertyChangeMarkAttrs, RunShadingAttrs, StrikeAttrs, TRACKED_CHANGE_PROVENANCE_VALUES, TextColorAttrs, TextEffectAttrs, TrackedChangeMarkAttrs, TrackedChangeProvenance, UnderlineAttrs };
+export { AuthoredRunFormattingValues, COMPLEX_SCRIPT_RUN_PROPERTY_KEYS, CharacterSpacingAttrs, CharacterStyleAttrs, CommentAttrs, ComplexScriptRunPropertyKey, EmphasisMarkAttrs, FontFamilyAttrs, FontSizeAttrs, FootnoteRefAttrs, HighlightAttrs, HyperlinkAttrs, InlineWrapperAttrs, InlineWrapperKind, InlineWrapperLayer, LanguageAttrs, RUN_FORMATTING_BOOLEAN_PROPERTIES, RUN_FORMATTING_PROPERTY_SPECS, RUN_FORMATTING_VALUE_PROPERTIES, RunFormattingBooleanProperty, RunFormattingOverrideAttrs, RunFormattingValueProperty, RunIdentityMarkAttrs, RunPropertyChangeMarkAttrs, RunShadingAttrs, StrikeAttrs, TRACKED_CHANGE_PROVENANCE_VALUES, TextColorAttrs, TextEffectAttrs, TrackedChangeMarkAttrs, TrackedChangeProvenance, UnderlineAttrs };

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

@@ -3,6 +3,7 @@ import { TrackedChangeProvenance } from "./marks.js";
 import "../../types/index.js";
 import { OutlineStyleAttr } from "../../types/documentEnumValues.js";
 import { SpacingExplicit } from "../../types/formatting.js";
+import { ParagraphNumberingAttr } from "../numberingAttr.js";
 import { ParagraphDirection } from "../paragraphDirection.js";
 //#region src/prosemirror/schema/nodes.d.ts
 type HardBreakAttrs = {
@@ -21,6 +22,35 @@ type SymbolAttrs = {
   font: string;
   char: string;
 };
+/** A run child folio does not model, carried through the editor untouched. */
+/**
+ * Which container the captured markup came out of, and goes back into.
+ *
+ * `w:ruby` is a run child and has to be written back inside a `w:r`;
+ * `w:permStart` is a paragraph child and the schema admits none inside a run,
+ * so writing one there would produce a package Word repairs. One atom serves
+ * both because the editor treats them identically — opaque, zero-width unless
+ * the markup shows text, carrying whatever marks surround it — and only the
+ * save path has to tell them apart.
+ */
+declare const PRESERVED_XML_LEVELS: {
+  readonly run: "run";
+  readonly inline: "inline";
+};
+type PreservedXmlLevel = (typeof PRESERVED_XML_LEVELS)[keyof typeof PRESERVED_XML_LEVELS];
+/** A run or inline child folio does not model, carried through the editor untouched. */
+type PreservedXmlAttrs = {
+  /** Replayable markup, as `captureVerbatimXml` wrote it. */
+  xml: string;
+  /** The visible text the markup puts on the line, empty when it shows none. */
+  text: string;
+  level: PreservedXmlLevel;
+};
+/** A block child folio does not model, carried through the editor untouched. */
+type PreservedBlockAttrs = {
+  /** Replayable markup, as `captureVerbatimXml` wrote it. */
+  xml: string;
+};
 type BookmarkBoundaryAttrs = {
   type: "start";
   id: number;
@@ -33,6 +63,14 @@ type BookmarkBoundaryAttrs = {
   id: number;
   displacedByCustomXml?: document_d_exports.DisplacedByCustomXml;
 };
+/**
+ * The position of a comment's `w:commentReference`: the run that paints the
+ * visible comment mark. It is authored data, not a consequence of where the
+ * range ends, so the editor carries it as a node of its own.
+ */
+type CommentReferenceAttrs = {
+  commentId: number;
+};
 /**
  * Paragraph node attributes - maps to ParagraphFormatting
  */
@@ -69,10 +107,11 @@ type ParagraphAttrs = {
   indentRight?: number;
   indentFirstLine?: number;
   hangingIndent?: boolean;
-  numPr?: {
-    numId?: number;
-    ilvl?: number;
-  };
+  /**
+   * The stated `w:numPr` (17.3.1.19), as the model carries it. Minted by
+   * `paragraphNumberingAttr`, so a model value cannot land here unconverted.
+   */
+  numPr?: ParagraphNumberingAttr;
   /**
    * The style-sourced numPr value when `numPr` came from the paragraph
    * style rather than direct formatting. While `numPr` still equals this,
@@ -81,12 +120,9 @@ type ParagraphAttrs = {
    * commands that change `numPr` make the values diverge, which re-enables
    * direct serialization — no explicit clearing needed.
    */
-  numPrFromStyle?: {
-    numId?: number;
-    ilvl?: number;
-  };
+  numPrFromStyle?: ParagraphNumberingAttr;
   /** List number format (decimal, lowerRoman, upperRoman, etc.) for CSS counter styling */
-  listNumFmt?: document_d_exports.NumberFormat;
+  listNumFmt?: document_d_exports.CounterFormat;
   /** Whether this is a bullet list */
   listIsBullet?: boolean;
   /** Whether this level uses legal numbering (parent placeholders render decimal). */
@@ -122,7 +158,7 @@ type ParagraphAttrs = {
    */
   listMarkerSecondSlotOffsetTwips?: number;
   /** Number format for each level used by multi-level marker templates. */
-  listLevelNumFmts?: document_d_exports.NumberFormat[];
+  listLevelNumFmts?: document_d_exports.CounterFormat[];
   /** Initial counter for each level used by multi-level marker templates. */
   listLevelStarts?: number[];
   /** Abstract numbering ID shared by numbering instances. */
@@ -157,7 +193,6 @@ type ParagraphAttrs = {
   defaultTextFormatting?: document_d_exports.TextFormatting;
   /** Internal table-style run overlay, used to resolve body-run provenance. */
   _tableRunFormatting?: document_d_exports.TextFormatting;
-  sectionBreakType?: "nextPage" | "continuous" | "oddPage" | "evenPage";
   /**
    * Base text direction as a discriminated union (undecided when absent). Maps
    * to the serialized OOXML `w:bidi` tri-state via `directionToBidi`; the
@@ -165,7 +200,8 @@ type ParagraphAttrs = {
    * re-evaluable auto-detected one. See `paragraphDirection.ts`.
    */
   direction?: ParagraphDirection | null;
-  outlineLevel?: number;
+  /** The stated `w:outlineLvl`, style-resolved: a heading level or body text. */
+  outlineLevel?: document_d_exports.OutlineLevel;
   bookmarks?: {
     id: number;
     name: string;
@@ -210,9 +246,27 @@ type ParagraphAttrs = {
     before?: number | null;
     after?: number | null;
   };
-  /** Full section properties for paragraphs that end a section.
-   *  Used by layout engine for per-section column/page config and round-trip. */
+  /**
+   * The section that ends at this paragraph's mark, and the whole of that
+   * state: the break type is a field of the record, derived through
+   * `sectionBreakTypeOf`, never a second attr beside it.
+   *
+   * The record is shared by reference, never cloned. Among the paragraphs
+   * holding one object the from-leg writes only the last, which is how a split
+   * paragraph's two halves stay one section.
+   */
   _sectionProperties?: document_d_exports.SectionProperties;
+  /**
+   * Attributes the authored `w:p` carried and the model has no field for
+   * (`w:rsidR` and its family), carried opaquely so an edit does not rewrite
+   * the document's revision history.
+   *
+   * The remainder follows the record. ProseMirror copies a node's attrs to
+   * both halves of a split, so `fromProseDoc` gives it to the first paragraph
+   * that carries it and to no other: a paragraph the editor created never had
+   * those attributes and must not inherit them from a neighbour.
+   */
+  _preservedAttributes?: document_d_exports.PreservedAttribute[];
   /** Paragraph-property-change tracking entries (`w:pPrChange`).
    *  Preserved opaquely through ProseMirror — the editor does not surface
    *  them in UI today, but stripping them on every edit would corrupt the
@@ -233,6 +287,20 @@ type ParagraphAttrs = {
    */
   _suggestedInsert?: SuggestedStructuralMarker | null;
 };
+/**
+ * A partial write over a paragraph's attrs: every key carries its own attr
+ * type, or the attr's absent state. Which spelling that is belongs to the
+ * node spec's per-attr `default` (`null` for most, `undefined` for a few,
+ * `alignmentFromStyle` among them), so both are admitted here.
+ *
+ * Derived from {@link ParagraphAttrs} rather than hand-listed, so an attr
+ * added to the node spec is writable without a second edit, and a producer
+ * that assembles a patch is held to each attr's type. `numPr` is the reason
+ * it exists: a patch typed `Record<string, unknown>` can store a raw
+ * `ParagraphNumberingOverride` there, which is exactly what the
+ * {@link ParagraphNumberingAttr} brand makes impossible.
+ */
+type ParagraphAttrsPatch = { [K in keyof ParagraphAttrs]?: ParagraphAttrs[K] | null | undefined; };
 /**
  * ProseMirror property-change attrs may also carry the editor's list-marker
  * snapshot fields alongside the canonical paragraph formatting fields.
@@ -245,7 +313,7 @@ type ParagraphPropertyChangeAttrs = Omit<document_d_exports.ParagraphPropertyCha
     suggestionId?: string | null;
   };
   previousFormatting?: Omit<document_d_exports.ParagraphFormatting, "numPr"> & {
-    numPr?: document_d_exports.ParagraphFormatting["numPr"] | null;
+    numPr?: ParagraphAttrs["numPr"] | null;
   } & Partial<Pick<ParagraphAttrs, "listIsBullet" | "listIsLegal" | "listNumFmt" | "listMarker" | "listMarkerTemplate" | "listMarkerHidden" | "listMarkerFormatting" | "listMarkerAlignment" | "listMarkerSuffix" | "listMarkerAllCaps" | "listImplicitChildLevelAdvances" | "listMarkerSecondSlotOffsetTwips" | "listLevelNumFmts" | "listLevelStarts" | "listAbstractNumId" | "listStartOverride" | "lineSpacingExplicit" | "direction" | "_autospacingBase">>;
   currentFormatting?: document_d_exports.ParagraphFormatting;
 };
@@ -288,6 +356,20 @@ type TextBoxMarginAttr = "marginTop" | "marginBottom" | "marginLeft" | "marginRi
  */
 type ImageAttrs = {
   src: string;
+  /**
+   * How to draw a drawing that carries no image data, set instead of `src`.
+   *
+   * Carried on the attr rather than in a side table so an editor state is
+   * still self-contained: a state that loses the table would lose the picture.
+   * It is shape geometry in a serialized attr, which is a real cost in a
+   * collaboration update, but the descriptor is bounded by the shape cap and
+   * is three orders of magnitude smaller than the base64 raster this attr used
+   * to hold for the same drawing.
+   *
+   * A state saved before this existed carries the raster in `src` and still
+   * paints from it, so nothing stored needs migrating.
+   */
+  preview?: document_d_exports.PreviewDescriptor;
   docPrName?: string;
   alt?: string;
   title?: string;
@@ -302,13 +384,23 @@ type ImageAttrs = {
   displayMode?: "inline" | "float" | "block";
   /** CSS float direction for floating images */
   cssFloat?: "left" | "right" | "none";
-  /** CSS transform string (rotation, flip) */
+  /** CSS transform string, derived from the authored transform below. */
   transform?: string;
+  /** Authored `a:xfrm@rot` in degrees; `null` when the drawing states none. */
+  docxRotation?: number | null;
+  /** Authored `a:xfrm@flipH`; `null` when the drawing states none. */
+  docxFlipH?: boolean | null;
+  /** Authored `a:xfrm@flipV`; `null` when the drawing states none. */
+  docxFlipV?: boolean | null;
   /**
    * Opacity in [0, 1] from `<a:alphaModFix amt>`. Undefined / 1 means fully
    * opaque (no CSS `opacity` emitted). eigenpal #424.
    */
   opacity?: number;
+  /** DrawingML `a:lum@bright` as a signed percentage in [-100, 100]. */
+  brightness?: number;
+  /** DrawingML `a:lum@contrast` as a signed percentage in [-100, 100]. */
+  contrast?: number;
   /** Distance from text above (pixels) */
   distTop?: number;
   /** Distance from text below (pixels) */
@@ -337,8 +429,22 @@ type ImageAttrs = {
   paddingLeft?: 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;
+  /** `wp:anchor`'s own attributes, carried whole so a rebuild can restate them. */
+  anchor?: document_d_exports.DrawingAnchor;
+  /**
+   * Which element stated each wrap inset. The insets above are the value in
+   * force; this is the slot each was authored on, without which a rebuild
+   * collects them all onto the drawing.
+   */
+  wrapDistanceSlots?: document_d_exports.WrapDistanceSlots;
+  /**
+   * Which element stated a `wp:effectExtent`. The drawing's is the reservation
+   * in force; the wrap child's is the one the text flow is computed against,
+   * and without the slots a rebuild writes neither back where it was authored.
+   */
+  wrapEffectExtentSlots?: document_d_exports.EffectExtentSlots;
+  /** `wp:wrapPolygon` as authored, in the path's own units. */
+  wrapPolygon?: document_d_exports.ImageWrapPolygon;
   /**
    * The image carries no information, so assistive technology skips it
    * (`wp:docPr`'s decorative extension). Not {@link hidden}: a decorative
@@ -369,6 +475,19 @@ type ImageAttrs = {
   hlinkHref?: string;
   /** DOCX relationship ID for the clickable image hyperlink */
   hlinkRId?: string;
+  /**
+   * `a:hlinkClick` as the source wrote it, and `a:hlinkHover` beside it. The
+   * model has a field for the click target and none for the tooltip, the target
+   * frame or the history flag, so an edit that did not touch the link has to
+   * hand the element's own bytes back for the rebuild to replay.
+   */
+  hlinkClickSource?: document_d_exports.ImageDocPrLink;
+  hlinkHoverXml?: string;
+  /**
+   * `wp:docPr@id`, the drawing's own identity. Without it a rebuilt drawing is
+   * renumbered from the serializer's counter on every edit.
+   */
+  docPrId?: string;
   /** Original OOXML for opaque/unsupported DOCX drawings. */
   _docxRawXml?: string;
   /** Raw XML preserved without an editable image projection. */
@@ -447,10 +566,21 @@ type SdtAttrs = {
   dropdownLastValue?: string;
   /** Checkbox checked state */
   checked?: boolean;
-  /** Captured `<w:sdtPr>…</w:sdtPr>` for round-trip replay. */
-  rawPropertiesXml?: string;
+  /**
+   * The `w:sdtPr` children folio does not model, at their schema ordinal.
+   *
+   * The control keeps its own bytes through the editor the way a paragraph
+   * keeps its attribute remainder: the serializer merges them back with the
+   * modelled children in `CT_SdtPr` order.
+   */
+  _preserved?: document_d_exports.PreservedMarkup;
   /** Captured `<w:sdtEndPr>…</w:sdtEndPr>` for round-trip replay. */
   rawEndPropertiesXml?: string;
+  /**
+   * `w:sdtEndPr` as a record, for a control the editor rebuilds and which has
+   * no captured bytes left to replay. See `SdtProperties.endProperties`.
+   */
+  endProperties?: document_d_exports.SdtEndProperties;
 };
 /**
  * Block-level structured document tag node attributes. Mirrors `SdtAttrs`
@@ -480,10 +610,18 @@ type BlockSdtAttrs = {
    * 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;
+  /**
+   * The `w:sdtPr` children folio does not model, at their schema ordinal.
+   *
+   * The control keeps its own bytes through the editor the way a paragraph
+   * keeps its attribute remainder: the serializer merges them back with the
+   * modelled children in `CT_SdtPr` order.
+   */
+  _preserved?: document_d_exports.PreservedMarkup;
   /** Captured `<w:sdtEndPr>…</w:sdtEndPr>` for round-trip replay. */
   rawEndPropertiesXml?: string;
+  /** `w:sdtEndPr` as a record; see `SdtAttrs.endProperties`. */
+  endProperties?: document_d_exports.SdtEndProperties;
   /** Verbatim XML for sdt siblings before sdtContent (range markers). */
   rawSdtChildrenBeforeContent?: string;
   /** Verbatim XML for sdt siblings after sdtContent (range markers). */
@@ -537,8 +675,14 @@ type ShapeAttrs = {
   outlineHeadEnd?: NonNullable<document_d_exports.ShapeOutline["headEnd"]>;
   /** Tail arrow/end marker */
   outlineTailEnd?: NonNullable<document_d_exports.ShapeOutline["tailEnd"]>;
-  /** CSS transform */
+  /** CSS transform, derived from the authored transform below. */
   transform?: string;
+  /** Authored `a:xfrm@rot` in degrees; `null` when the drawing states none. */
+  docxRotation?: number | null;
+  /** Authored `a:xfrm@flipH`; `null` when the drawing states none. */
+  docxFlipH?: boolean | null;
+  /** Authored `a:xfrm@flipV`; `null` when the drawing states none. */
+  docxFlipV?: boolean | null;
   /** Display mode */
   displayMode?: "inline" | "float" | "block";
   /** CSS float */
@@ -557,6 +701,22 @@ type ShapeAttrs = {
   distRight?: number;
   /** Position for floating shapes (horizontal and vertical alignment) */
   position?: ImagePositionAttrs;
+  /** `wp:anchor`'s own attributes, carried whole so a rebuild can restate them. */
+  anchor?: document_d_exports.DrawingAnchor;
+  /**
+   * Which element stated each wrap inset. The insets above are the value in
+   * force; this is the slot each was authored on, without which a rebuild
+   * collects them all onto the drawing.
+   */
+  wrapDistanceSlots?: document_d_exports.WrapDistanceSlots;
+  /**
+   * Which element stated a `wp:effectExtent`. The drawing's is the reservation
+   * in force; the wrap child's is the one the text flow is computed against,
+   * and without the slots a rebuild writes neither back where it was authored.
+   */
+  wrapEffectExtentSlots?: document_d_exports.EffectExtentSlots;
+  /** `wp:wrapPolygon` as authored, in the path's own units. */
+  wrapPolygon?: document_d_exports.ImageWrapPolygon;
   /** Shadow color as CSS color */
   shadowColor?: string;
   /** Shadow blur radius in pixels */
@@ -618,6 +778,12 @@ type TextBoxAttrs = {
   outlineStyle?: OutlineStyleAttr;
   /** DrawingML rotation and/or flips, serialized as CSS transform functions. */
   transform?: string;
+  /** Authored `a:xfrm@rot` in degrees; `null` when the drawing states none. */
+  docxRotation?: number | null;
+  /** Authored `a:xfrm@flipH`; `null` when the drawing states none. */
+  docxFlipH?: boolean | null;
+  /** Authored `a:xfrm@flipV`; `null` when the drawing states none. */
+  docxFlipV?: boolean | null;
   /** Internal margin top in pixels */
   marginTop?: number;
   /** Internal margin bottom in pixels */
@@ -646,6 +812,22 @@ type TextBoxAttrs = {
   distRight?: number;
   /** Position for floating/anchored text boxes */
   position?: ImagePositionAttrs;
+  /** `wp:anchor`'s own attributes, carried whole so a rebuild can restate them. */
+  anchor?: document_d_exports.DrawingAnchor;
+  /**
+   * Which element stated each wrap inset. The insets above are the value in
+   * force; this is the slot each was authored on, without which a rebuild
+   * collects them all onto the drawing.
+   */
+  wrapDistanceSlots?: document_d_exports.WrapDistanceSlots;
+  /**
+   * Which element stated a `wp:effectExtent`. The drawing's is the reservation
+   * in force; the wrap child's is the one the text flow is computed against,
+   * and without the slots a rebuild writes neither back where it was authored.
+   */
+  wrapEffectExtentSlots?: document_d_exports.EffectExtentSlots;
+  /** `wp:wrapPolygon` as authored, in the path's own units. */
+  wrapPolygon?: document_d_exports.ImageWrapPolygon;
   /** Original DOCX placement hint for save-path reconstruction. */
   _docxPlacement?: "standalone" | "inlineWithPrevious";
   /** Original DOCX paragraph group for standalone text-box reconstruction. */
@@ -674,6 +856,17 @@ type TextBoxAttrs = {
   };
   /** Original inline content-control ancestry for save-path reconstruction. */
   _docxInlineSdts?: SdtAttrs[];
+  /**
+   * The attribute remainder of the `w:p` this node was lifted out of.
+   *
+   * A paragraph whose only content was an anchored drawing has no paragraph
+   * node in the editor: this node stands in for it, so it carries the host's
+   * remainder the way `ParagraphAttrs._preservedAttributes` carries a
+   * paragraph's own. Only a `"standalone"` placement has a host to speak for;
+   * an `"inlineWithPrevious"` text box sits in a paragraph that is projected
+   * itself and keeps its own.
+   */
+  _preservedAttributes?: document_d_exports.PreservedAttribute[];
 };
 /** Internal inline position marker for an extracted text box block. */
 type TextBoxAnchorAttrs = {
@@ -689,8 +882,8 @@ type TableAttrs = {
   width?: number;
   /** Table width type ('auto', 'pct', 'dxa') */
   widthType?: document_d_exports.TableWidthType;
-  /** Table justification/alignment */
-  justification?: "left" | "center" | "right";
+  /** Table placement (`w:tblPr/w:jc`) */
+  justification?: NonNullable<document_d_exports.TableFormatting["justification"]>;
   /** Column widths (in twips) from w:tblGrid */
   columnWidths?: number[];
   /** Floating table properties (w:tblpPr) */
@@ -723,6 +916,27 @@ type TableAttrs = {
   _originalFormatting?: document_d_exports.TableFormatting;
   /** Tracked table property changes (w:tblPrChange) for round-trip + accept/reject */
   tblPrChange?: document_d_exports.TablePropertyChange[];
+  /**
+   * Bookmark markers the authored element held beside its own children, with
+   * the position each was read at.
+   *
+   * There is no node for a boundary between two rows or two cells — a row's
+   * children are cells — so the markers ride the record by reference, the way
+   * `_preservedAttributes` does and for the same reason: a copy the editor
+   * made shares the array, an authored record holds its own, and only the
+   * first in document order keeps it.
+   */
+  _bookmarks?: document_d_exports.PositionedBookmarkMarker[];
+  /**
+   * Markup the authored `w:tbl` carried beside its rows — a bookmark or
+   * permission boundary, a proofing error, a custom-XML revision range —
+   * with the row count that places it back between the same two rows.
+   *
+   * Carried by reference for the reason `_preservedAttributes` is: the sink
+   * follows the record it was authored on, so a table the editor created has
+   * none and a copy does not inherit one.
+   */
+  _preserved?: document_d_exports.TablePreservedMarkup;
   /**
    * Marks this whole table as a *suggested* insertion (AI proposal). The table
    * is dropped from serialized DOCX until accepted; because OOXML has no tracked
@@ -746,8 +960,51 @@ type TableRowAttrs = {
   _resolvedJustification?: NonNullable<document_d_exports.TableRowFormatting["justification"]>;
   /** Original row formatting from DOCX for lossless round-trip serialization */
   _originalFormatting?: document_d_exports.TableRowFormatting;
+  /**
+   * The table properties the authored row overrides (`w:tblPrEx`), carried
+   * whole for the reason `_originalFormatting` is: the editor surfaces none of
+   * them, and rebuilding the element from the handful of attrs it does surface
+   * would drop the rest.
+   */
+  _tablePropertyExceptions?: document_d_exports.TablePropertyExceptionFormatting;
   /** Tracked row property changes (w:trPrChange) for round-trip + accept/reject */
   trPrChange?: document_d_exports.TableRowPropertyChange[];
+  /** Tracked changes to the property exceptions (w:tblPrExChange), carried opaquely */
+  tblPrExChange?: document_d_exports.TablePropertyExceptionChange[];
+  /**
+   * Attributes the authored `w:tr` carried and the model has no field for
+   * (`w:rsidR`, `w:rsidDel`, `w:rsidTr`, `w:rsidRPr`), carried opaquely for
+   * the reason `ParagraphAttrs._preservedAttributes` gives.
+   */
+  _preservedAttributes?: document_d_exports.PreservedAttribute[];
+  /**
+   * Bookmark markers the authored element held beside its own children, with
+   * the position each was read at.
+   *
+   * There is no node for a boundary between two rows or two cells — a row's
+   * children are cells — so the markers ride the record by reference, the way
+   * `_preservedAttributes` does and for the same reason: a copy the editor
+   * made shares the array, an authored record holds its own, and only the
+   * first in document order keeps it.
+   */
+  _bookmarks?: document_d_exports.PositionedBookmarkMarker[];
+  /**
+   * The row-level content controls (`CT_SdtRow`) this row sits inside,
+   * outermost first.
+   *
+   * The record travels on the row because a table's children are rows and
+   * ProseMirror has no node to spare for a wrapper that is not one. Splitting
+   * or moving a row takes its controls with it, which an index between rows
+   * would not; the save re-opens one wrapper per run of consecutive rows that
+   * name the same control. See `TableRow.contentControls`.
+   */
+  contentControls?: document_d_exports.SdtProperties[];
+  /**
+   * Markup the authored `w:tr` carried beside its cells, with the cell count
+   * that places it back between the same two cells. Follows the record the
+   * same way `TableAttrs._preserved` does.
+   */
+  _preserved?: document_d_exports.TablePreservedMarkup;
 } & ({
   /**
    * Tracked structural row insertion (w:trPr/w:ins). A `"suggested"`
@@ -803,12 +1060,33 @@ type TableCellAttrs = {
   colspan: number;
   /** Row span */
   rowspan: number;
+  /**
+   * A non-authored cell which occupies a `w:gridBefore` or `w:gridAfter`
+   * slot so ProseMirror can retain a rectangular table map. It is invisible
+   * in the editor and omitted when projecting back to OOXML.
+   */
+  _omittedGridSlot?: "before" | "after";
   /** 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;
+  /**
+   * The preferred width the cell itself states, absent when it states none.
+   *
+   * `width` is the width the cell *renders* at, which the table resolves from
+   * its grid when the cell declares no `w:tcW`, so a save that read it would
+   * give every cell in the document a preferred width its author never wrote.
+   * The companion to `width` that `_resolvedBorders` is to `borders`, and the
+   * one the save leg writes `w:tcW` from. A command that moves a cell's width
+   * states one: `mergeTableCellAttrs` records it for every command that goes
+   * through it.
+   */
+  _authoredWidth?: {
+    value: number;
+    type: document_d_exports.TableWidthType;
+  };
   /** Vertical alignment */
   verticalAlign?: "top" | "center" | "bottom";
   /** Background color (RGB hex) */
@@ -879,10 +1157,15 @@ type TableCellAttrs = {
     verticalMerge?: "continue" | "rest";
     verticalMergeOriginal?: "continue" | "rest";
   };
+  /**
+   * The cell-level content controls (`CT_SdtCell`) this cell sits inside,
+   * outermost first. The row's twin, one level down.
+   */
+  contentControls?: document_d_exports.SdtProperties[];
   /** 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?: unknown;
 };
 //#endregion
-export { AuthoredEmuAttrs, BlockSdtAttrs, BookmarkBoundaryAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, PageBreakRunAttrs, ParagraphAttrs, ParagraphPropertyChangeAttrs, SdtAttrs, ShapeAttrs, SuggestedStructuralMarker, SymbolAttrs, TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAnchorAttrs, TextBoxAttrs, TextBoxTextBodyContentState };
+export { AuthoredEmuAttrs, BlockSdtAttrs, BookmarkBoundaryAttrs, CommentReferenceAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, PRESERVED_XML_LEVELS, PageBreakRunAttrs, ParagraphAttrs, ParagraphAttrsPatch, ParagraphPropertyChangeAttrs, PreservedBlockAttrs, PreservedXmlAttrs, PreservedXmlLevel, SdtAttrs, ShapeAttrs, SuggestedStructuralMarker, SymbolAttrs, TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAnchorAttrs, TextBoxAttrs, TextBoxTextBodyContentState };

package/dist/prosemirror/schema/nodes.js

@@ -1,7 +1,22 @@
 //#region src/prosemirror/schema/nodes.ts
+/** A run child folio does not model, carried through the editor untouched. */
+/**
+* Which container the captured markup came out of, and goes back into.
+*
+* `w:ruby` is a run child and has to be written back inside a `w:r`;
+* `w:permStart` is a paragraph child and the schema admits none inside a run,
+* so writing one there would produce a package Word repairs. One atom serves
+* both because the editor treats them identically — opaque, zero-width unless
+* the markup shows text, carrying whatever marks surround it — and only the
+* save path has to tell them apart.
+*/
+const PRESERVED_XML_LEVELS = {
+	run: "run",
+	inline: "inline"
+};
 /**
 * Text box node attributes
 */
 const TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES = Object.freeze(["source-empty", "authored"]);
 //#endregion
-export { TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES };
+export { PRESERVED_XML_LEVELS, TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES };