@stll/folio-core 0.46.0 → 0.47.0

package/dist/prosemirror/runIdentity.js

@@ -0,0 +1,36 @@
+//#region src/prosemirror/runIdentity.ts
+/** The DOM attribute that carries a run's identity through copy and paste. */
+const RUN_IDENTITY_ATTRIBUTE = "data-docx-run-identity";
+/** The schema name of the mark these attrs belong to. */
+const RUN_IDENTITY_MARK_NAME = "runIdentity";
+/** One remainder entry with its keys in canonical order. */
+const preservedAttribute = ({ namespace, name, value }) => namespace === void 0 ? {
+	name,
+	value
+} : {
+	namespace,
+	name,
+	value
+};
+/** The property-set sink with its keys in canonical order. */
+const preservedMarkup = ({ children }) => ({ children: (children ?? []).map(({ index, xml }) => ({
+	index,
+	xml
+})) });
+/** A run identity's attrs in canonical form. */
+const runIdentityAttrs = (id, { preservedAttributes, preserved } = {}) => {
+	const attrs = { id };
+	if (preservedAttributes && preservedAttributes.length > 0) attrs.preservedAttributes = preservedAttributes.map(preservedAttribute);
+	if (preserved && (preserved.children?.length ?? 0) > 0) attrs.preserved = preservedMarkup(preserved);
+	return attrs;
+};
+/**
+* Whether a run holds markup the mark exists to carry.
+*
+* The mint condition, minus the page break: a run with neither remainder nor
+* sink and no break to rejoin its leaves across needs no identity, and 57.5%
+* of corpus files hold none.
+*/
+const hasRunIdentityPayload = ({ preservedAttributes, preserved }) => (preservedAttributes?.length ?? 0) > 0 || (preserved?.children?.length ?? 0) > 0;
+//#endregion
+export { RUN_IDENTITY_ATTRIBUTE, RUN_IDENTITY_MARK_NAME, hasRunIdentityPayload, runIdentityAttrs };

package/dist/prosemirror/runStyleFormatting.js

@@ -21,7 +21,7 @@ const hasDirectRunFormatting = (formatting) => {
 	return Object.entries(formatting).some(([property, value]) => property !== "styleId" && value !== void 0);
 };
 const stripParagraphMarkOnlyFormatting = (formatting) => {
-	const { allCaps: _allCaps, highlight: _highlight, shading: _shading, smallCaps: _smallCaps, vertAlign: _vertAlign, ...formattingForBody } = formatting;
+	const { allCaps: _allCaps, highlight: _highlight, shading: _shading, smallCaps: _smallCaps, vertAlign: _vertAlign, preserved: _preserved, ...formattingForBody } = formatting;
 	return Object.keys(formattingForBody).length > 0 ? formattingForBody : void 0;
 };
 const stripParagraphMarkFormattingForBodyRuns = (formatting) => {

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

@@ -1,4 +1,4 @@
-import { CharacterSpacingAttrs, CharacterStyleAttrs, CommentAttrs, EmphasisMarkAttrs, FontFamilyAttrs, FontSizeAttrs, FootnoteRefAttrs, HighlightAttrs, HyperlinkAttrs, InlineWrapperAttrs, InlineWrapperKind, InlineWrapperLayer, LanguageAttrs, PageBreakRunOwnerMarkAttrs, RunFormattingOverrideAttrs, RunPropertyChangeMarkAttrs, RunShadingAttrs, StrikeAttrs, TextColorAttrs, TextEffectAttrs, TrackedChangeMarkAttrs, UnderlineAttrs } from "./marks.js";
+import { CharacterSpacingAttrs, CharacterStyleAttrs, CommentAttrs, EmphasisMarkAttrs, FontFamilyAttrs, FontSizeAttrs, FootnoteRefAttrs, HighlightAttrs, HyperlinkAttrs, InlineWrapperAttrs, InlineWrapperKind, InlineWrapperLayer, LanguageAttrs, RunFormattingOverrideAttrs, RunIdentityMarkAttrs, RunPropertyChangeMarkAttrs, RunShadingAttrs, StrikeAttrs, TextColorAttrs, TextEffectAttrs, TrackedChangeMarkAttrs, UnderlineAttrs } from "./marks.js";
 import { BlockSdtAttrs, BookmarkBoundaryAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, PageBreakRunAttrs, ParagraphAttrs, ParagraphPropertyChangeAttrs, PreservedBlockAttrs, PreservedXmlAttrs, PreservedXmlLevel, SdtAttrs, ShapeAttrs, SymbolAttrs, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAttrs } from "./nodes.js";
 import { ExtensionManager } from "../extensions/ExtensionManager.js";
 //#region src/prosemirror/schema/index.d.ts
@@ -11,4 +11,4 @@ type DocxSchema = typeof schema;
 type DocxNode = ReturnType<typeof schema.node>;
 type DocxMark = ReturnType<typeof schema.mark>;
 //#endregion
-export { type BlockSdtAttrs, type BookmarkBoundaryAttrs, type CharacterSpacingAttrs, type CharacterStyleAttrs, type CommentAttrs, DocxMark, DocxNode, DocxSchema, type EmphasisMarkAttrs, type FieldAttrs, type FontFamilyAttrs, type FontSizeAttrs, type FootnoteRefAttrs, type HardBreakAttrs, type HighlightAttrs, type HyperlinkAttrs, type ImageAttrs, type ImagePositionAttrs, type InlineWrapperAttrs, type InlineWrapperKind, type InlineWrapperLayer, type LanguageAttrs, type MathAttrs, type PageBreakRunAttrs, type PageBreakRunOwnerMarkAttrs, type ParagraphAttrs, type ParagraphPropertyChangeAttrs, type PreservedBlockAttrs, type PreservedXmlAttrs, type PreservedXmlLevel, type RunFormattingOverrideAttrs, type RunPropertyChangeMarkAttrs, type RunShadingAttrs, type SdtAttrs, type ShapeAttrs, type StrikeAttrs, type SymbolAttrs, type TabAttrs, type TableAttrs, type TableCellAttrs, type TableRowAttrs, type TextBoxAttrs, type TextColorAttrs, type TextEffectAttrs, type TrackedChangeMarkAttrs, type UnderlineAttrs, schema, singletonManager };
+export { type BlockSdtAttrs, type BookmarkBoundaryAttrs, type CharacterSpacingAttrs, type CharacterStyleAttrs, type CommentAttrs, DocxMark, DocxNode, DocxSchema, type EmphasisMarkAttrs, type FieldAttrs, type FontFamilyAttrs, type FontSizeAttrs, type FootnoteRefAttrs, type HardBreakAttrs, type HighlightAttrs, type HyperlinkAttrs, type ImageAttrs, type ImagePositionAttrs, type InlineWrapperAttrs, type InlineWrapperKind, type InlineWrapperLayer, type LanguageAttrs, type MathAttrs, type PageBreakRunAttrs, type ParagraphAttrs, type ParagraphPropertyChangeAttrs, type PreservedBlockAttrs, type PreservedXmlAttrs, type PreservedXmlLevel, type RunFormattingOverrideAttrs, type RunIdentityMarkAttrs, type RunPropertyChangeMarkAttrs, type RunShadingAttrs, type SdtAttrs, type ShapeAttrs, type StrikeAttrs, type SymbolAttrs, type TabAttrs, type TableAttrs, type TableCellAttrs, type TableRowAttrs, type TextBoxAttrs, type TextColorAttrs, type TextEffectAttrs, type TrackedChangeMarkAttrs, type UnderlineAttrs, schema, singletonManager };

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,26 @@ 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
@@ -255,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, InlineWrapperAttrs, InlineWrapperKind, InlineWrapperLayer, 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 = {
@@ -106,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,
@@ -118,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). */
@@ -159,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. */
@@ -194,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
@@ -202,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;
@@ -247,8 +246,15 @@ 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
@@ -281,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.
@@ -293,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;
 };
@@ -336,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;
@@ -395,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
@@ -427,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. */
@@ -505,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`
@@ -538,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). */
@@ -621,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 */
@@ -716,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. */
@@ -770,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) */
@@ -804,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
@@ -827,14 +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"`
@@ -890,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) */
@@ -966,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, CommentReferenceAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, PRESERVED_XML_LEVELS, PageBreakRunAttrs, ParagraphAttrs, ParagraphPropertyChangeAttrs, PreservedBlockAttrs, PreservedXmlAttrs, PreservedXmlLevel, 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/sectionCarrier.d.ts

@@ -0,0 +1,37 @@
+import { document_d_exports } from "../types/document.js";
+import { Node } from "prosemirror-model";
+//#region src/prosemirror/sectionCarrier.d.ts
+/**
+ * `ST_SectionMark` in full (§17.18.77). The list is total over the model union:
+ * `sectionBreakTypeOf` returns a record's `SectionStart` as a
+ * `SectionBreakType`, so a member missing here fails to compile rather than
+ * going typeless to every reader. Which members the *insert* commands offer is
+ * a separate, narrower question (`InsertableSectionBreak`).
+ */
+declare const SECTION_BREAK_TYPES: readonly ["nextPage", "nextColumn", "continuous", "evenPage", "oddPage"];
+/** A section start a `w:sectPr` can state. */
+type SectionBreakType = (typeof SECTION_BREAK_TYPES)[number];
+/** A break type read off an untrusted boundary (a `data-` attribute, a snapshot). */
+declare const parseSectionBreakType: (value: unknown) => SectionBreakType | null;
+/** The section record a paragraph holds, or `null` when it ends no section. */
+declare const sectionPropertiesOf: (paragraph: Node) => document_d_exports.SectionProperties | null;
+/**
+ * The break type a section record states, or `null` when it states none.
+ *
+ * The single derivation every reader goes through. Every producer of a record
+ * already validated `w:type` against the enumeration (the parser, the insert
+ * commands, the Yjs migration's `parseSectionBreakType`), so the field needs no
+ * second check here; declaring the narrower return type is what proves
+ * `SECTION_BREAK_TYPES` still covers the model union.
+ */
+declare const sectionBreakTypeOf: (properties: document_d_exports.SectionProperties | null | undefined) => SectionBreakType | null;
+/**
+ * Mint the one record a newly inserted break carries.
+ *
+ * A minted record states only its type: every other setting of the new section
+ * is inherited from the section that follows it, which is what a reader of the
+ * package does with a `w:sectPr` that omits them.
+ */
+declare const mintSectionProperties: (breakType: SectionBreakType) => document_d_exports.SectionProperties;
+//#endregion
+export { SECTION_BREAK_TYPES, SectionBreakType, mintSectionProperties, parseSectionBreakType, sectionBreakTypeOf, sectionPropertiesOf };

package/dist/prosemirror/sectionCarrier.js

@@ -0,0 +1,40 @@
+//#region src/prosemirror/sectionCarrier.ts
+/**
+* `ST_SectionMark` in full (§17.18.77). The list is total over the model union:
+* `sectionBreakTypeOf` returns a record's `SectionStart` as a
+* `SectionBreakType`, so a member missing here fails to compile rather than
+* going typeless to every reader. Which members the *insert* commands offer is
+* a separate, narrower question (`InsertableSectionBreak`).
+*/
+const SECTION_BREAK_TYPES = [
+	"nextPage",
+	"nextColumn",
+	"continuous",
+	"evenPage",
+	"oddPage"
+];
+const isSectionBreakType = (value) => SECTION_BREAK_TYPES.some((type) => type === value);
+/** A break type read off an untrusted boundary (a `data-` attribute, a snapshot). */
+const parseSectionBreakType = (value) => isSectionBreakType(value) ? value : null;
+/** The section record a paragraph holds, or `null` when it ends no section. */
+const sectionPropertiesOf = (paragraph) => paragraph.attrs["_sectionProperties"] ?? null;
+/**
+* The break type a section record states, or `null` when it states none.
+*
+* The single derivation every reader goes through. Every producer of a record
+* already validated `w:type` against the enumeration (the parser, the insert
+* commands, the Yjs migration's `parseSectionBreakType`), so the field needs no
+* second check here; declaring the narrower return type is what proves
+* `SECTION_BREAK_TYPES` still covers the model union.
+*/
+const sectionBreakTypeOf = (properties) => properties?.sectionStart ?? null;
+/**
+* Mint the one record a newly inserted break carries.
+*
+* A minted record states only its type: every other setting of the new section
+* is inherited from the section that follows it, which is what a reader of the
+* package does with a `w:sectPr` that omits them.
+*/
+const mintSectionProperties = (breakType) => ({ sectionStart: breakType });
+//#endregion
+export { SECTION_BREAK_TYPES, mintSectionProperties, parseSectionBreakType, sectionBreakTypeOf, sectionPropertiesOf };

package/dist/prosemirror/selectionState.d.ts

@@ -1,4 +1,5 @@
 import { document_d_exports } from "../types/document.js";
+import { ListState } from "./listState.js";
 import { EditorState } from "prosemirror-state";
 //#region src/prosemirror/selectionState.d.ts
 /**
@@ -21,6 +22,8 @@ type SelectionSnapshot = {
   startParagraphIndex: number;
   /** End paragraph index */
   endParagraphIndex: number;
+  /** Which list the selection is in, resolved against the numbering definitions. */
+  listState: ListState;
 };
 /** Compatibility name for the public toolbar selection contract. */
 type SelectionState = SelectionSnapshot;

package/dist/prosemirror/selectionState.js

@@ -1,6 +1,8 @@
 import { FONT_THEME_VALUES } from "../types/documentEnumValues.js";
 import { expectFontFamilyMarkAttrs, expectFontSizeMarkAttrs, expectHighlightMarkAttrs, expectParagraphAttrs, expectStrikeMarkAttrs, expectTextColorMarkAttrs, expectUnderlineMarkAttrs } from "./attrs/index.js";
+import { resolveListState } from "./listState.js";
 import { directionIsRtl } from "./paragraphDirection.js";
+import { getDocumentNumbering } from "./plugins/documentNumbering.js";
 import { collectMarksInRange } from "./selectionMarks.js";
 //#region src/prosemirror/selectionState.ts
 const isFontTheme = (value) => value !== void 0 && FONT_THEME_VALUES.some((theme) => theme === value);
@@ -43,7 +45,8 @@ function extractSelectionSnapshot(state) {
 		paragraphFormatting,
 		styleId,
 		startParagraphIndex,
-		endParagraphIndex
+		endParagraphIndex,
+		listState: resolveListState(getDocumentNumbering(state), paragraphFormatting.numPr)
 	};
 }
 /** Compatibility entry point used by existing React and Vue integrations. */