@stll/folio-core 0.35.1 → 0.37.0

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

@@ -6,7 +6,13 @@ import { SpacingExplicit } from "../../types/formatting.js";
 import { ParagraphDirection } from "../paragraphDirection.js";
 //#region src/prosemirror/schema/nodes.d.ts
 type HardBreakAttrs = {
-  breakType?: "column";
+  /** Absent means the source `w:br` omitted `w:type`. */
+  breakType?: "column" | "textWrapping";
+  clear?: "none" | "left" | "right" | "all";
+};
+/** Attributes preserved from an authored `<w:br w:type="page"/>`. */
+type PageBreakRunAttrs = {
+  clear?: "none" | "left" | "right" | "all";
 };
 type TabAttrs = {
   positional?: document_d_exports.PositionalTab;
@@ -32,6 +38,8 @@ type ParagraphAttrs = {
   paraId?: string;
   textId?: string;
   alignment?: document_d_exports.ParagraphAlignment;
+  /** Effective inherited alignment beneath any direct `w:jc` override. */
+  alignmentFromStyle?: document_d_exports.ParagraphAlignment;
   /** Effective East Asian line-edge policy (`w:kinsoku`). */
   kinsoku?: boolean;
   /** Effective hanging-punctuation policy (`w:overflowPunct`). */
@@ -42,12 +50,17 @@ type ParagraphAttrs = {
   spaceAfter?: number;
   lineSpacing?: number;
   lineSpacingRule?: document_d_exports.LineSpacingRule;
-  lineSpacingExplicit?: boolean;
+  /**
+   * Which line-spacing attributes came from this paragraph's own `w:spacing`.
+   * `true` is accepted for editor states written before provenance became
+   * field-specific; newly created state uses the exact discriminator.
+   */
+  lineSpacingExplicit?: boolean | "value" | "rule" | "both";
   snapToGrid?: boolean;
   spacingExplicit?: SpacingExplicit;
   /** Layout provenance: document defaults survive on empty paragraphs. */
   spacingFromDocDefaults?: SpacingExplicit;
-  /** Layout provenance: implicit default-style spacing survives on empty paragraphs. */
+  /** Layout provenance: resolved paragraph/table-style spacing survives on empty paragraphs. */
   spacingFromImplicitDefaultStyle?: SpacingExplicit;
   indentLeft?: number;
   indentRight?: number;
@@ -77,6 +90,8 @@ type ParagraphAttrs = {
   listIsLegal?: boolean;
   /** Computed list marker text (e.g., "1.", "1.1.", "•") */
   listMarker?: string;
+  /** Source numbering pattern used to compute markers for inserted list siblings. */
+  listMarkerTemplate?: string;
   /** Whether the list marker is hidden (w:vanish on numbering level rPr) */
   listMarkerHidden?: boolean;
   /** Canonical numbering-level marker typography, in OOXML units. */
@@ -205,10 +220,15 @@ type ParagraphAttrs = {
  * snapshot fields alongside the canonical paragraph formatting fields.
  * Keeping that shape typed here lets layout consume validated attrs directly.
  */
-type ParagraphPropertyChangeAttrs = Omit<document_d_exports.ParagraphPropertyChange, "previousFormatting" | "currentFormatting"> & {
+type ParagraphPropertyChangeAttrs = Omit<document_d_exports.ParagraphPropertyChange, "info" | "previousFormatting" | "currentFormatting"> & {
+  info: document_d_exports.ParagraphPropertyChange["info"] & {
+    /** Editor-only proposal provenance; stripped or re-authored before OOXML serialization. */
+    provenance?: TrackedChangeProvenance;
+    suggestionId?: string | null;
+  };
   previousFormatting?: Omit<document_d_exports.ParagraphFormatting, "numPr"> & {
     numPr?: document_d_exports.ParagraphFormatting["numPr"] | null;
-  } & Partial<Pick<ParagraphAttrs, "listIsBullet" | "listIsLegal" | "listNumFmt" | "listMarker" | "listMarkerHidden" | "listMarkerFormatting" | "listMarkerAlignment" | "listMarkerSuffix" | "listLevelNumFmts" | "listLevelStarts" | "listAbstractNumId" | "listStartOverride" | "lineSpacingExplicit" | "direction" | "_autospacingBase">>;
+  } & 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;
 };
 /**
@@ -622,6 +642,7 @@ type TableRowAttrs = {
     revisionId: number;
     author: string;
     date?: string | null;
+    utcDate?: string | null;
     initials?: string | null;
     provenance?: TrackedChangeProvenance;
     suggestionId?: string | null;
@@ -634,6 +655,7 @@ type TableRowAttrs = {
     revisionId: number;
     author: string;
     date?: string | null;
+    utcDate?: string | null;
     initials?: string | null;
     provenance?: TrackedChangeProvenance;
     suggestionId?: string | null;
@@ -717,6 +739,7 @@ type TableCellAttrs = {
       revisionId: number;
       author: string;
       date?: string | null;
+      utcDate?: string | null;
       initials?: string | null;
       /** `"suggested"` marks this as an AI proposal (stripped until accepted). */
       provenance?: TrackedChangeProvenance;
@@ -733,6 +756,7 @@ type TableCellAttrs = {
       revisionId: number;
       author: string;
       date?: string | null;
+      utcDate?: string | null;
       initials?: string | null;
     };
     verticalMerge?: "continue" | "rest";
@@ -744,4 +768,4 @@ type TableCellAttrs = {
   _docxVMergeContinuationCells?: document_d_exports.TableCell[];
 };
 //#endregion
-export { BlockSdtAttrs, BookmarkBoundaryAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, ParagraphAttrs, ParagraphPropertyChangeAttrs, SdtAttrs, ShapeAttrs, SuggestedStructuralMarker, SymbolAttrs, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAnchorAttrs, TextBoxAttrs };
+export { BlockSdtAttrs, BookmarkBoundaryAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, PageBreakRunAttrs, ParagraphAttrs, ParagraphPropertyChangeAttrs, SdtAttrs, ShapeAttrs, SuggestedStructuralMarker, SymbolAttrs, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAnchorAttrs, TextBoxAttrs };

package/dist/prosemirror/styles/resolvedStyleAttrs.d.ts

@@ -1,5 +1,5 @@
-import { NumberingMap } from "../../docx/numberingParser.js";
 import { ResolvedParagraphStyle } from "./styleResolver.js";
+import { NumberingMap } from "../../docx/numberingParser.js";
 //#region src/prosemirror/styles/resolvedStyleAttrs.d.ts
 type ResolvedStyleIdentity = {
   styleId: string;
@@ -31,5 +31,17 @@ declare function paragraphAttrsFromResolvedStyle(resolved: ResolvedParagraphStyl
  * subsequent save + reload re-derives them from the document content.
  */
 declare function listAttrsFromResolvedStyle(resolved: ResolvedParagraphStyle, numbering: NumberingMap | null | undefined): Record<string, unknown> | null;
+/** Project one resolved numbering level into the complete editor attr group. */
+declare function listAttrsFromNumbering(numPr: {
+  numId: number;
+  ilvl: number;
+}, numbering: NumberingMap | null | undefined): Record<string, unknown>;
+/** Recompute every level-dependent attr when a paragraph changes list level. */
+declare function listLevelAttrPatch(attrs: {
+  listImplicitChildLevelAdvances?: number | null;
+}, numPr: {
+  numId: number;
+  ilvl: number;
+}, numbering: NumberingMap | null | undefined): Record<string, unknown>;
 //#endregion
-export { listAttrsFromResolvedStyle, paragraphAttrsFromResolvedStyle };
+export { listAttrsFromNumbering, listAttrsFromResolvedStyle, listLevelAttrPatch, paragraphAttrsFromResolvedStyle };

package/dist/prosemirror/styles/resolvedStyleAttrs.js

@@ -1,6 +1,7 @@
-import { computeListRendering } from "../../docx/numberingParser.js";
+import { computeListRendering, numberingLevelHasMarkerSlot } from "../../docx/numberingParser.js";
 import { tableOfContentsStyleLevel } from "../../utils/tableOfContentsStyle.js";
 import { setAutospacingBaseValue } from "../autospacingBase.js";
+import { CLEARED_LIST_RENDERING_ATTRS } from "../listMarker.js";
 //#region src/prosemirror/styles/resolvedStyleAttrs.ts
 /**
 * Shared helper for projecting a resolved paragraph style onto ProseMirror
@@ -24,6 +25,7 @@ function paragraphAttrsFromResolvedStyle(resolved, identity) {
 	const hasRunFormatting = !!runFormatting && Object.keys(runFormatting).length > 0;
 	return {
 		alignment: ppr?.alignment ?? null,
+		alignmentFromStyle: ppr?.alignment,
 		spaceBefore: ppr?.spaceBefore ?? null,
 		spaceAfter: ppr?.spaceAfter ?? null,
 		lineSpacing: ppr?.lineSpacing ?? null,
@@ -72,42 +74,62 @@ function autospacingBaseFromResolvedParagraphFormatting(ppr) {
 function listAttrsFromResolvedStyle(resolved, numbering) {
 	const numPr = resolved.paragraphFormatting?.numPr;
 	if (!numPr || numPr.numId === void 0 || numPr.numId === 0) return null;
-	const rendering = numbering ? computeListRendering(numPr, numbering) : null;
+	const attrs = listAttrsFromNumbering({
+		numId: numPr.numId,
+		ilvl: numPr.ilvl ?? 0
+	}, numbering);
 	const level = numbering?.getLevel(numPr.numId, numPr.ilvl ?? 0);
-	const attrs = {
-		numPr: {
-			numId: numPr.numId,
-			ilvl: numPr.ilvl ?? 0
-		},
-		numPrFromStyle: {
-			numId: numPr.numId,
-			ilvl: numPr.ilvl ?? 0
-		},
+	attrs["numPrFromStyle"] = {
+		numId: numPr.numId,
+		ilvl: numPr.ilvl ?? 0
+	};
+	const ppr = resolved.paragraphFormatting;
+	if (level?.pPr) {
+		if (ppr?.indentLeft === void 0 && level.pPr.indentLeft !== void 0) attrs["indentLeft"] = level.pPr.indentLeft;
+		if (!(ppr?.indentFirstLine !== void 0 || ppr?.hangingIndent !== void 0) && numberingLevelHasMarkerSlot(level)) {
+			if (level.pPr.indentFirstLine !== void 0) attrs["indentFirstLine"] = level.pPr.indentFirstLine;
+			if (level.pPr.hangingIndent !== void 0) attrs["hangingIndent"] = level.pPr.hangingIndent;
+		}
+	}
+	return attrs;
+}
+/** Project one resolved numbering level into the complete editor attr group. */
+function listAttrsFromNumbering(numPr, numbering) {
+	const targetNumPr = {
+		numId: numPr.numId,
+		ilvl: numPr.ilvl
+	};
+	const rendering = numbering ? computeListRendering(targetNumPr, numbering) : null;
+	return {
+		...CLEARED_LIST_RENDERING_ATTRS,
+		numPr: targetNumPr,
 		listNumFmt: rendering?.numFmt ?? null,
 		listIsBullet: rendering?.isBullet ?? null,
 		listIsLegal: rendering?.isLegal ?? null,
 		listMarker: rendering?.marker ?? null,
+		listMarkerTemplate: rendering?.markerTemplate ?? null,
 		listMarkerHidden: rendering?.markerHidden ?? null,
 		listMarkerFormatting: rendering?.markerFormatting ?? null,
 		listMarkerAlignment: rendering?.markerAlignment ?? null,
 		listMarkerSuffix: rendering?.markerSuffix ?? null,
 		listMarkerAllCaps: rendering?.markerAllCaps ?? null,
-		listImplicitChildLevelAdvances: null,
-		listMarkerSecondSlotOffsetTwips: null,
 		listLevelNumFmts: rendering?.levelNumFmts ?? null,
 		listLevelStarts: rendering?.levelStarts ?? null,
 		listAbstractNumId: rendering?.abstractNumId ?? null,
 		listStartOverride: rendering?.startOverride ?? null
 	};
-	const ppr = resolved.paragraphFormatting;
-	if (level?.pPr) {
-		if (ppr?.indentLeft === void 0 && level.pPr.indentLeft !== void 0) attrs["indentLeft"] = level.pPr.indentLeft;
-		if (!(ppr?.indentFirstLine !== void 0 || ppr?.hangingIndent !== void 0)) {
-			if (level.pPr.indentFirstLine !== void 0) attrs["indentFirstLine"] = level.pPr.indentFirstLine;
-			if (level.pPr.hangingIndent !== void 0) attrs["hangingIndent"] = level.pPr.hangingIndent;
-		}
-	}
-	return attrs;
+}
+/** Recompute every level-dependent attr when a paragraph changes list level. */
+function listLevelAttrPatch(attrs, numPr, numbering) {
+	const level = numbering?.getLevel(numPr.numId, numPr.ilvl);
+	const hasMarkerSlot = level ? numberingLevelHasMarkerSlot(level) : false;
+	return {
+		...listAttrsFromNumbering(numPr, numbering),
+		listImplicitChildLevelAdvances: attrs.listImplicitChildLevelAdvances ?? null,
+		indentLeft: level?.pPr?.indentLeft ?? null,
+		indentFirstLine: hasMarkerSlot ? level?.pPr?.indentFirstLine ?? null : null,
+		hangingIndent: hasMarkerSlot ? level?.pPr?.hangingIndent ?? null : null
+	};
 }
 //#endregion
-export { listAttrsFromResolvedStyle, paragraphAttrsFromResolvedStyle };
+export { listAttrsFromNumbering, listAttrsFromResolvedStyle, listLevelAttrPatch, paragraphAttrsFromResolvedStyle };

package/dist/prosemirror/styles/styleResolver.d.ts

@@ -10,21 +10,18 @@ type ResolvedParagraphStyle = {
   runFormatting?: document_d_exports.TextFormatting;
 };
 /**
- * Paragraph-spacing fields sourced from the table style enclosing a cell
- * paragraph: the table style's own `w:pPr`, then the applicable
+ * Paragraph fields sourced from the table style enclosing a cell paragraph:
+ * the table style's own `w:pPr`, then the applicable
  * `w:tblStylePr` conditional region's `w:pPr` layered on top (already merged
  * by the caller — see `resolveTableBaseStyle`/`resolveTableStyleConditional`
  * in toProseDoc.ts).
  *
- * Deliberately narrower than the full {@link ParagraphFormatting}: this is
- * the layer-2 overlay described on {@link StyleResolver.resolveParagraphStyleInTable}
- * and is scoped to the spacing fields responsible for folio's table-row
- * height bug (table styles like Word's `TableGrid` zero these out relative
- * to `docDefaults`). Alignment, indentation, borders, etc. are out of scope
- * here — applying the whole `pPr` would risk regressing unrelated cell
- * layout that isn't part of this fix.
+ * Deliberately narrower than the full {@link ParagraphFormatting}: spacing
+ * affects table-row height, while `frame` participates in lossless page-break
+ * ownership checks. Other fields remain out of scope until their table-style
+ * projection is modeled end to end.
  */
-type TableCellParagraphSpacingOverlay = Pick<document_d_exports.ParagraphFormatting, "spaceBefore" | "spaceAfter" | "lineSpacing" | "lineSpacingRule" | "contextualSpacing">;
+type TableCellParagraphSpacingOverlay = Pick<document_d_exports.ParagraphFormatting, "spaceBefore" | "spaceAfter" | "lineSpacing" | "lineSpacingRule" | "contextualSpacing" | "frame">;
 /**
  * StyleResolver provides efficient access to resolved style properties
  */
@@ -52,7 +49,7 @@ declare class StyleResolver {
   resolveParagraphStyle(styleId: string | undefined | null): ResolvedParagraphStyle;
   /**
    * Resolve paragraph style properties for a paragraph inside a table cell,
-   * layering the enclosing table style's paragraph-spacing fields into the
+   * layering the modeled enclosing-table paragraph fields into the
    * cascade between docDefaults and the paragraph's own style chain.
    *
    * Per ECMA-376 §17.7.2, a cell paragraph's properties resolve in this
@@ -68,10 +65,10 @@ declare class StyleResolver {
    * paragraph style still wins over the table for any field it sets.
    *
    * @param styleId - The paragraph's style ID (e.g., 'Heading1', 'Normal')
-   * @param tableParagraphOverlay - Paragraph-spacing fields from the
+   * @param tableParagraphOverlay - Modeled paragraph fields from the
    *   enclosing table style (base `pPr` merged with the applicable
    *   conditional region), or `undefined` when the paragraph isn't in a
-   *   table cell, the table has no style, or the style sets no spacing.
+   *   table cell, the table has no style, or the style sets none of them.
    * @returns Resolved paragraph and run formatting
    */
   resolveParagraphStyleInTable(styleId: string | undefined | null, tableParagraphOverlay: TableCellParagraphSpacingOverlay | undefined): ResolvedParagraphStyle;

package/dist/prosemirror/styles/styleResolver.js

@@ -74,7 +74,7 @@ var StyleResolver = class {
 	}
 	/**
 	* Resolve paragraph style properties for a paragraph inside a table cell,
-	* layering the enclosing table style's paragraph-spacing fields into the
+	* layering the modeled enclosing-table paragraph fields into the
 	* cascade between docDefaults and the paragraph's own style chain.
 	*
 	* Per ECMA-376 §17.7.2, a cell paragraph's properties resolve in this
@@ -90,10 +90,10 @@ var StyleResolver = class {
 	* paragraph style still wins over the table for any field it sets.
 	*
 	* @param styleId - The paragraph's style ID (e.g., 'Heading1', 'Normal')
-	* @param tableParagraphOverlay - Paragraph-spacing fields from the
+	* @param tableParagraphOverlay - Modeled paragraph fields from the
 	*   enclosing table style (base `pPr` merged with the applicable
 	*   conditional region), or `undefined` when the paragraph isn't in a
-	*   table cell, the table has no style, or the style sets no spacing.
+	*   table cell, the table has no style, or the style sets none of them.
 	* @returns Resolved paragraph and run formatting
 	*/
 	resolveParagraphStyleInTable(styleId, tableParagraphOverlay) {

package/dist/prosemirror/styles/styleToggleCascade.d.ts

@@ -23,6 +23,13 @@ type StyleToggleCascadeOptions = {
   /** Existing ordinary-property merge whose toggle fields this cascade replaces. */
   ordinaryFormatting: document_d_exports.TextFormatting | undefined;
 };
+type CascadeStyleFromResolvedBaseOptions = {
+  baseFormatting: document_d_exports.TextFormatting | undefined;
+  defaultsActiveProperties: readonly StyleToggleKey[] | undefined;
+  styleFormatting: document_d_exports.TextFormatting | undefined;
+};
+/** Continue a style cascade from a compact resolved paragraph snapshot. */
+declare const cascadeStyleFromResolvedBase: ({ baseFormatting, defaultsActiveProperties, styleFormatting }: CascadeStyleFromResolvedBaseOptions) => document_d_exports.TextFormatting | undefined;
 /**
  * Resolve run formatting across OOXML style hierarchy levels.
  *
@@ -34,4 +41,4 @@ type StyleToggleCascadeOptions = {
  */
 declare function cascadeStyleTextFormatting(levels: readonly StyleToggleLevel[], options?: StyleToggleCascadeOptions): StyleTextFormattingCascade;
 //#endregion
-export { cascadeStyleTextFormatting };
+export { StyleToggleKey, cascadeStyleFromResolvedBase, cascadeStyleTextFormatting };

package/dist/prosemirror/styles/styleToggleCascade.js

@@ -1,5 +1,28 @@
 import { STYLE_TOGGLE_KEYS, mergeTextFormatting } from "../../utils/textFormattingMerge.js";
 //#region src/prosemirror/styles/styleToggleCascade.ts
+/** Continue a style cascade from a compact resolved paragraph snapshot. */
+const cascadeStyleFromResolvedBase = ({ baseFormatting, defaultsActiveProperties, styleFormatting }) => {
+	const defaultsActive = new Set(defaultsActiveProperties);
+	const toggleStates = /* @__PURE__ */ new Map();
+	for (const key of STYLE_TOGGLE_KEYS) {
+		const value = baseFormatting?.[key];
+		if (value !== void 0) toggleStates.set(key, {
+			value,
+			defaultsActive: defaultsActive.has(key)
+		});
+	}
+	return cascadeStyleTextFormatting([{
+		cascade: {
+			formatting: baseFormatting,
+			toggleStates,
+			type: "styleToggleCascade"
+		},
+		type: "carried"
+	}, {
+		formatting: styleFormatting,
+		type: "style"
+	}]).formatting;
+};
 /**
 * Resolve run formatting across OOXML style hierarchy levels.
 *
@@ -49,4 +72,4 @@ function cascadeStyleTextFormatting(levels, options) {
 	};
 }
 //#endregion
-export { cascadeStyleTextFormatting };
+export { cascadeStyleFromResolvedBase, cascadeStyleTextFormatting };

package/dist/prosemirror/tableGridMutation.d.ts

@@ -0,0 +1,20 @@
+import { Transaction } from "prosemirror-state";
+import { Node } from "prosemirror-model";
+//#region src/prosemirror/tableGridMutation.d.ts
+type ReconcileTableGridAfterColumnRemovalOptions = {
+  tr: Transaction;
+  tablePosition: number;
+  previousTable: Node;
+  removedColumn: number;
+};
+/**
+ * Keep the editable table grid aligned with a physical column removal.
+ *
+ * `prosemirror-tables` owns cell topology, but Folio separately retains the
+ * authored `w:tblGrid` widths and source XML on the table node. A topology
+ * edit that leaves those attrs untouched serializes a new row shape against
+ * the old grid; reopening then has to interpret surviving cells as spans.
+ */
+declare const reconcileTableGridAfterColumnRemoval: ({ tr, tablePosition, previousTable, removedColumn }: ReconcileTableGridAfterColumnRemovalOptions) => void;
+//#endregion
+export { reconcileTableGridAfterColumnRemoval };

package/dist/prosemirror/tableGridMutation.js

@@ -0,0 +1,30 @@
+import { expectTableAttrs, mergeTableAttrs } from "./attrs/index.js";
+import { TableMap } from "prosemirror-tables";
+//#region src/prosemirror/tableGridMutation.ts
+/**
+* Keep the editable table grid aligned with a physical column removal.
+*
+* `prosemirror-tables` owns cell topology, but Folio separately retains the
+* authored `w:tblGrid` widths and source XML on the table node. A topology
+* edit that leaves those attrs untouched serializes a new row shape against
+* the old grid; reopening then has to interpret surviving cells as spans.
+*/
+const reconcileTableGridAfterColumnRemoval = ({ tr, tablePosition, previousTable, removedColumn }) => {
+	const previousColumnCount = TableMap.get(previousTable).width;
+	const table = tr.doc.nodeAt(tablePosition);
+	if (!table || table.type.spec["tableRole"] !== "table") return;
+	const columnCount = TableMap.get(table).width;
+	if (columnCount >= previousColumnCount) return;
+	const removedColumnCount = previousColumnCount - columnCount;
+	const previousWidths = expectTableAttrs(previousTable).columnWidths;
+	const columnWidths = previousWidths?.length === previousColumnCount ? previousWidths.toSpliced(removedColumn, removedColumnCount) : void 0;
+	const formatting = expectTableAttrs(table)._originalFormatting;
+	const originalFormatting = formatting ? { ...formatting } : void 0;
+	if (originalFormatting) delete originalFormatting.gridSourceXml;
+	tr.setNodeMarkup(tablePosition, void 0, mergeTableAttrs(table, {
+		columnWidths: columnWidths?.length === columnCount ? columnWidths : void 0,
+		_originalFormatting: originalFormatting
+	}));
+};
+//#endregion
+export { reconcileTableGridAfterColumnRemoval };

package/dist/prosemirror/trackedRunInlineAtoms.d.ts

@@ -0,0 +1,31 @@
+import { Node } from "prosemirror-model";
+//#region src/prosemirror/trackedRunInlineAtoms.d.ts
+type TrackedRunInlineAtomDisposition = "carry" | "field-carrier" | "outside-wrapper" | "page-break-carrier" | "text-carrier" | "transparent";
+/**
+ * How every inline atom in the editor schema participates in an OOXML
+ * run-level tracked-change wrapper.
+ *
+ * The schema is assembled at runtime, so the fixed-point test binds this map
+ * to its complete inline-atom set. The lookup also panics on a missing entry:
+ * a new atom cannot silently lose revision ownership before that test runs.
+ */
+declare const TRACKED_RUN_INLINE_ATOM_DISPOSITIONS: Readonly<{
+  readonly bookmarkBoundary: "carry";
+  readonly field: "field-carrier";
+  readonly hardBreak: "carry";
+  readonly image: "carry";
+  readonly math: "outside-wrapper";
+  readonly pageBreakRun: "page-break-carrier";
+  readonly renderedPageBreak: "transparent";
+  readonly shape: "carry";
+  readonly structuredField: "carry";
+  readonly symbol: "carry";
+  readonly tab: "carry";
+  readonly text: "text-carrier";
+  readonly textBoxAnchor: "carry";
+}>;
+declare const trackedRunInlineAtomDisposition: (node: Node) => TrackedRunInlineAtomDisposition | null;
+/** Whether an editor node can own an insertion/deletion mark as one run carrier. */
+declare const canCarryTrackedRunMark: (node: Node) => boolean;
+//#endregion
+export { TRACKED_RUN_INLINE_ATOM_DISPOSITIONS, TrackedRunInlineAtomDisposition, canCarryTrackedRunMark, trackedRunInlineAtomDisposition };

package/dist/prosemirror/trackedRunInlineAtoms.js

@@ -0,0 +1,39 @@
+import { panic } from "better-result";
+//#region src/prosemirror/trackedRunInlineAtoms.ts
+/**
+* How every inline atom in the editor schema participates in an OOXML
+* run-level tracked-change wrapper.
+*
+* The schema is assembled at runtime, so the fixed-point test binds this map
+* to its complete inline-atom set. The lookup also panics on a missing entry:
+* a new atom cannot silently lose revision ownership before that test runs.
+*/
+const TRACKED_RUN_INLINE_ATOM_DISPOSITIONS = Object.freeze({
+	bookmarkBoundary: "carry",
+	field: "field-carrier",
+	hardBreak: "carry",
+	image: "carry",
+	math: "outside-wrapper",
+	pageBreakRun: "page-break-carrier",
+	renderedPageBreak: "transparent",
+	shape: "carry",
+	structuredField: "carry",
+	symbol: "carry",
+	tab: "carry",
+	text: "text-carrier",
+	textBoxAnchor: "carry"
+});
+const dispositionsByName = new Map(Object.entries(TRACKED_RUN_INLINE_ATOM_DISPOSITIONS));
+const trackedRunInlineAtomDisposition = (node) => {
+	if (!node.isInline || !node.isAtom) return null;
+	const disposition = dispositionsByName.get(node.type.name);
+	if (!disposition) panic(`Inline atom ${JSON.stringify(node.type.name)} has no tracked-run disposition`);
+	return disposition;
+};
+/** Whether an editor node can own an insertion/deletion mark as one run carrier. */
+const canCarryTrackedRunMark = (node) => {
+	const disposition = trackedRunInlineAtomDisposition(node);
+	return disposition === "carry" || disposition === "field-carrier" || disposition === "text-carrier" || disposition === "page-break-carrier";
+};
+//#endregion
+export { TRACKED_RUN_INLINE_ATOM_DISPOSITIONS, canCarryTrackedRunMark, trackedRunInlineAtomDisposition };

package/dist/prosemirror/utils/visualLineNavigation.js

@@ -1,3 +1,5 @@
+import { findBodyEmptyRuns, findBodyPmSpans } from "../../layout-bridge/dom/findBodyPmSpans.js";
+import { createTextStreamRange, descendantTextNodes, totalTextLength } from "../../layout-bridge/dom/textStreamDom.js";
 import { findVerticalScrollParent } from "../../utils/findVerticalScrollParent.js";
 import { TextSelection } from "prosemirror-state";
 //#region src/prosemirror/utils/visualLineNavigation.ts
@@ -33,28 +35,21 @@ function scrollIntoViewIfNeeded(el) {
 }
 /** @internal */
 function getCaretClientX(container, pmPos) {
-	const spans = container.querySelectorAll("span[data-pm-start][data-pm-end]");
-	for (const span of Array.from(spans)) {
-		const spanEl = span;
+	for (const spanEl of findBodyPmSpans(container)) {
 		const pmStart = Number(spanEl.dataset["pmStart"]);
 		const pmEnd = Number(spanEl.dataset["pmEnd"]);
 		if (spanEl.classList.contains("layout-run-tab")) {
 			if (pmPos >= pmStart && pmPos < pmEnd) return spanEl.getBoundingClientRect().left;
 			continue;
 		}
-		if (pmPos >= pmStart && pmPos <= pmEnd && span.firstChild?.nodeType === Node.TEXT_NODE) {
-			const textNode = span.firstChild;
-			const charIndex = Math.min(pmPos - pmStart, textNode.length);
-			const ownerDoc = spanEl.ownerDocument;
-			if (!ownerDoc) continue;
-			const range = ownerDoc.createRange();
-			range.setStart(textNode, charIndex);
-			range.setEnd(textNode, charIndex);
-			return range.getBoundingClientRect().left;
+		if (pmPos >= pmStart && pmPos <= pmEnd) {
+			const textNodes = descendantTextNodes(spanEl);
+			const charIndex = Math.min(pmPos - pmStart, totalTextLength(textNodes));
+			const range = createTextStreamRange(spanEl, charIndex, charIndex);
+			if (range) return range.getBoundingClientRect().left;
 		}
 	}
-	const emptyRuns = container.querySelectorAll(".layout-empty-run");
-	for (const emptyRun of Array.from(emptyRuns)) {
+	for (const emptyRun of findBodyEmptyRuns(container)) {
 		const paragraph = emptyRun.closest(".layout-paragraph");
 		if (!paragraph) continue;
 		const pmStart = Number(paragraph.dataset["pmStart"]);
@@ -91,6 +86,13 @@ function findLineElementAtPosition(container, pmPos) {
 /** @internal */
 function findPositionOnLineAtClientX(lineEl, clientX) {
 	const spans = lineEl.querySelectorAll("span[data-pm-start][data-pm-end]");
+	const emptyRun = lineEl.querySelector(".layout-empty-run");
+	if (emptyRun) {
+		const emptyRunStart = emptyRun.dataset["pmStart"];
+		if (emptyRunStart !== void 0) return Number(emptyRunStart);
+		const paragraphStart = emptyRun.closest(".layout-paragraph")?.dataset["pmStart"];
+		return paragraphStart === void 0 ? null : Number(paragraphStart) + 1;
+	}
 	if (spans.length === 0) {
 		const paragraph = lineEl.closest(".layout-paragraph");
 		if (paragraph?.dataset["pmStart"]) return Number(paragraph.dataset["pmStart"]) + 1;
@@ -106,29 +108,23 @@ function findPositionOnLineAtClientX(lineEl, clientX) {
 			continue;
 		}
 		if (clientX >= rect.left && clientX <= rect.right) {
-			const textNode = spanEl.firstChild;
-			if (!textNode || textNode.nodeType !== Node.TEXT_NODE) return pmStart;
-			const text = textNode;
-			const ownerDoc = spanEl.ownerDocument;
-			if (!ownerDoc) return pmStart;
+			const textLength = totalTextLength(descendantTextNodes(spanEl));
+			if (textLength === 0) return pmStart;
 			let lo = 0;
-			let hi = text.length;
+			let hi = textLength;
 			while (lo < hi) {
 				const mid = Math.floor((lo + hi) / 2);
-				const r = ownerDoc.createRange();
-				r.setStart(text, mid);
-				r.setEnd(text, mid);
+				const r = createTextStreamRange(spanEl, mid, mid);
+				if (!r) return pmStart;
 				if (clientX < r.getBoundingClientRect().left) hi = mid;
 				else lo = mid + 1;
 			}
-			if (lo > 0 && lo <= text.length) {
-				const r = ownerDoc.createRange();
-				r.setStart(text, lo - 1);
-				r.setEnd(text, lo - 1);
-				const leftX = r.getBoundingClientRect().left;
-				r.setStart(text, Math.min(lo, text.length));
-				r.setEnd(text, Math.min(lo, text.length));
-				const rightX = r.getBoundingClientRect().left;
+			if (lo > 0 && lo <= textLength) {
+				const left = createTextStreamRange(spanEl, lo - 1, lo - 1);
+				const right = createTextStreamRange(spanEl, Math.min(lo, textLength), Math.min(lo, textLength));
+				if (!left || !right) return pmStart;
+				const leftX = left.getBoundingClientRect().left;
+				const rightX = right.getBoundingClientRect().left;
 				if (Math.abs(clientX - leftX) < Math.abs(clientX - rightX)) return pmStart + (lo - 1);
 			}
 			return pmStart + Math.min(lo, pmEnd - pmStart);