@stll/folio-core 0.46.0 → 0.47.0

package/dist/prosemirror/paragraphFormattingProvenance.d.ts

@@ -67,6 +67,9 @@ declare const PARAGRAPH_FORMATTING_WRITE_BACK: {
   readonly spacingExplicit: {
     readonly kind: "derived";
   };
+  readonly spacingPreservedAttributes: {
+    readonly kind: "original-only";
+  };
   readonly indentLeft: {
     readonly kind: "style-resolved-attr";
     readonly attr: "indentLeft";
@@ -82,6 +85,9 @@ declare const PARAGRAPH_FORMATTING_WRITE_BACK: {
   readonly hangingIndent: {
     readonly kind: "direct-provenance";
   };
+  readonly indentPreservedAttributes: {
+    readonly kind: "original-only";
+  };
   readonly borders: {
     readonly kind: "style-resolved-attr";
     readonly attr: "borders";
@@ -147,6 +153,9 @@ declare const PARAGRAPH_FORMATTING_WRITE_BACK: {
     readonly kind: "style-resolved-attr";
     readonly attr: "runInWithNext";
   };
+  readonly preserved: {
+    readonly kind: "original-only";
+  };
 };
 type StyleResolvedParagraphField = { [Field in keyof typeof PARAGRAPH_FORMATTING_WRITE_BACK]: (typeof PARAGRAPH_FORMATTING_WRITE_BACK)[Field] extends {
   kind: "style-resolved-attr";

package/dist/prosemirror/paragraphFormattingProvenance.js

@@ -28,6 +28,7 @@ const PARAGRAPH_FORMATTING_WRITE_BACK = {
 	beforeAutospacing: { kind: "direct-provenance" },
 	afterAutospacing: { kind: "direct-provenance" },
 	spacingExplicit: { kind: "derived" },
+	spacingPreservedAttributes: { kind: "original-only" },
 	indentLeft: {
 		kind: "style-resolved-attr",
 		attr: "indentLeft"
@@ -41,6 +42,7 @@ const PARAGRAPH_FORMATTING_WRITE_BACK = {
 		attr: "indentFirstLine"
 	},
 	hangingIndent: { kind: "direct-provenance" },
+	indentPreservedAttributes: { kind: "original-only" },
 	borders: {
 		kind: "style-resolved-attr",
 		attr: "borders"
@@ -91,7 +93,8 @@ const PARAGRAPH_FORMATTING_WRITE_BACK = {
 	runInWithNext: {
 		kind: "style-resolved-attr",
 		attr: "runInWithNext"
-	}
+	},
+	preserved: { kind: "original-only" }
 };
 const STYLE_RESOLVED_PARAGRAPH_FIELDS = Object.keys(PARAGRAPH_FORMATTING_WRITE_BACK).filter((field) => PARAGRAPH_FORMATTING_WRITE_BACK[field].kind === "style-resolved-attr");
 /**

package/dist/prosemirror/plugins/selectionTracker.d.ts

@@ -1,4 +1,5 @@
 import { document_d_exports } from "../../types/document.js";
+import { ListState } from "../listState.js";
 import { EditorState, Plugin, PluginKey } from "prosemirror-state";
 //#region src/prosemirror/plugins/selectionTracker.d.ts
 /**
@@ -17,12 +18,8 @@ type SelectionContext = {
   startParagraphIndex: number;
   /** End paragraph index */
   endParagraphIndex: number;
-  /** Whether cursor is in a list */
-  inList: boolean;
-  /** List type if in list */
-  listType?: "bullet" | "numbered";
-  /** List level (0-8) */
-  listLevel?: number;
+  /** Which list the cursor is in, resolved against the numbering definitions. */
+  listState: ListState;
   /** Active comment IDs at cursor position */
   activeCommentIds: number[];
   /** Whether cursor is inside a tracked insertion */

package/dist/prosemirror/plugins/selectionTracker.js

@@ -1,4 +1,5 @@
 import { expectCommentMarkAttrs, expectTrackedChangeMarkAttrs } from "../attrs/index.js";
+import { sameListState } from "../listState.js";
 import { extractSelectionSnapshot } from "../selectionState.js";
 import { Plugin, PluginKey } from "prosemirror-state";
 //#region src/prosemirror/plugins/selectionTracker.ts
@@ -26,12 +27,6 @@ function extractSelectionContext(state) {
 		...snapshot.paragraphFormatting,
 		styleId: snapshot.styleId
 	};
-	const numPr = snapshot.paragraphFormatting.numPr;
-	const inList = !!numPr?.numId;
-	let listType;
-	if (numPr?.numId === 1) listType = "bullet";
-	else if (numPr?.numId) listType = "numbered";
-	const listLevel = numPr?.ilvl;
 	const allMarks = state.storedMarks || (empty ? selection.$from.marks() : []);
 	const activeCommentIds = [];
 	let inInsertion = false;
@@ -54,9 +49,7 @@ function extractSelectionContext(state) {
 		paragraphFormatting,
 		startParagraphIndex: snapshot.startParagraphIndex,
 		endParagraphIndex: snapshot.endParagraphIndex,
-		inList,
-		...listType !== void 0 ? { listType } : {},
-		...listLevel !== void 0 ? { listLevel } : {},
+		listState: snapshot.listState,
 		activeCommentIds,
 		inInsertion,
 		inDeletion
@@ -99,7 +92,7 @@ function arraysEqual(a, b) {
 * Compare two selection contexts for equality
 */
 function contextsEqual(a, b) {
-	return a.hasSelection === b.hasSelection && a.isMultiParagraph === b.isMultiParagraph && a.startParagraphIndex === b.startParagraphIndex && a.endParagraphIndex === b.endParagraphIndex && a.inList === b.inList && a.listType === b.listType && a.listLevel === b.listLevel && a.inInsertion === b.inInsertion && a.inDeletion === b.inDeletion && arraysEqual(a.activeCommentIds, b.activeCommentIds) && JSON.stringify(a.textFormatting) === JSON.stringify(b.textFormatting) && JSON.stringify(a.paragraphFormatting) === JSON.stringify(b.paragraphFormatting);
+	return a.hasSelection === b.hasSelection && a.isMultiParagraph === b.isMultiParagraph && a.startParagraphIndex === b.startParagraphIndex && a.endParagraphIndex === b.endParagraphIndex && sameListState(a.listState, b.listState) && a.inInsertion === b.inInsertion && a.inDeletion === b.inDeletion && arraysEqual(a.activeCommentIds, b.activeCommentIds) && JSON.stringify(a.textFormatting) === JSON.stringify(b.textFormatting) && JSON.stringify(a.paragraphFormatting) === JSON.stringify(b.paragraphFormatting);
 }
 /**
 * Get current selection context from editor state

package/dist/prosemirror/rangeAnchorAttrs.d.ts

@@ -0,0 +1,14 @@
+import { ReadProseMirrorAttrsResult } from "./attrs/index.js";
+import { RangeAnchorAttrs } from "./emptyRangeAnchor.js";
+import { Node } from "prosemirror-model";
+//#region src/prosemirror/rangeAnchorAttrs.d.ts
+/** The two marker values, checked for every field the DOCX serializer reads. */
+declare const readRangeAnchorValues: (start: unknown, end: unknown) => ReadProseMirrorAttrsResult<RangeAnchorAttrs>;
+/**
+ * The anchor's attrs, checked before a save can call string methods or emit
+ * invalid range-marker XML.
+ */
+declare const readRangeAnchorAttrs: (node: Node) => ReadProseMirrorAttrsResult<RangeAnchorAttrs>;
+declare const expectRangeAnchorAttrs: (node: Node) => RangeAnchorAttrs;
+//#endregion
+export { expectRangeAnchorAttrs, readRangeAnchorAttrs, readRangeAnchorValues };

package/dist/prosemirror/rangeAnchorAttrs.js

@@ -0,0 +1,101 @@
+import { isDisplacedByCustomXml } from "./bookmarkBoundaryAttrs.js";
+import { RANGE_END_FOR_START } from "./emptyRangeAnchor.js";
+import { panic } from "better-result";
+//#region src/prosemirror/rangeAnchorAttrs.ts
+const attrsCache = /* @__PURE__ */ new WeakMap();
+const isRecord = (value) => typeof value === "object" && value !== null;
+const isMarkerId = (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+const isRangeStartType = (value) => typeof value === "string" && value in RANGE_END_FOR_START;
+const validateRangeMarkerAttrs = (marker, path, issues) => {
+	if (!isMarkerId(marker["id"])) issues.push({
+		path: `${path}.id`,
+		message: "Expected a non-negative integer."
+	});
+	const displacedByCustomXml = marker["displacedByCustomXml"];
+	if (displacedByCustomXml !== void 0 && !isDisplacedByCustomXml(displacedByCustomXml)) issues.push({
+		path: `${path}.displacedByCustomXml`,
+		message: "Expected \"next\" or \"prev\"."
+	});
+};
+const validateMoveRangeStartAttrs = (marker, path, issues) => {
+	for (const required of ["name", "author"]) if (typeof marker[required] !== "string" || marker[required].trim() === "") issues.push({
+		path: `${path}.${required}`,
+		message: "Expected a non-empty string on a move range start."
+	});
+	const date = marker["date"];
+	if (date !== void 0 && typeof date !== "string") issues.push({
+		path: `${path}.date`,
+		message: "Expected a string."
+	});
+	for (const column of ["colFirst", "colLast"]) {
+		const value = marker[column];
+		if (value !== void 0 && (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0)) issues.push({
+			path: `${path}.${column}`,
+			message: "Expected a non-negative integer."
+		});
+	}
+};
+/** The two marker values, checked for every field the DOCX serializer reads. */
+const readRangeAnchorValues = (start, end) => {
+	const issues = [];
+	if (!isRecord(start) || !isRangeStartType(start["type"])) {
+		issues.push({
+			path: "rangeAnchor.attrs.start",
+			message: `Expected one of ${Object.keys(RANGE_END_FOR_START).join(", ")}.`
+		});
+		return {
+			ok: false,
+			issues
+		};
+	}
+	const expectedEndType = RANGE_END_FOR_START[start["type"]];
+	if (!isRecord(end) || end["type"] !== expectedEndType) issues.push({
+		path: "rangeAnchor.attrs.end",
+		message: `Expected ${expectedEndType}.`
+	});
+	validateRangeMarkerAttrs(start, "rangeAnchor.attrs.start", issues);
+	if (isRecord(end)) {
+		validateRangeMarkerAttrs(end, "rangeAnchor.attrs.end", issues);
+		if (end["id"] !== start["id"]) issues.push({
+			path: "rangeAnchor.attrs.end.id",
+			message: "Expected the id its start carries."
+		});
+	}
+	if (start["type"] !== "commentRangeStart") validateMoveRangeStartAttrs(start, "rangeAnchor.attrs.start", issues);
+	if (issues.length > 0) return {
+		ok: false,
+		issues
+	};
+	return {
+		ok: true,
+		value: {
+			start,
+			end
+		}
+	};
+};
+/**
+* The anchor's attrs, checked before a save can call string methods or emit
+* invalid range-marker XML.
+*/
+const readRangeAnchorAttrs = (node) => {
+	const result = readRangeAnchorValues(node.attrs["start"], node.attrs["end"]);
+	if (node.type.name === "rangeAnchor") return result;
+	return {
+		ok: false,
+		issues: [{
+			path: "rangeAnchor.type.name",
+			message: `Expected rangeAnchor, got ${node.type.name}.`
+		}, ...result.ok ? [] : result.issues]
+	};
+};
+const expectRangeAnchorAttrs = (node) => {
+	const cached = attrsCache.get(node);
+	if (cached) return cached;
+	const result = readRangeAnchorAttrs(node);
+	if (!result.ok) panic(`Invalid ProseMirror range anchor attrs:\n${result.issues.map((issue) => `${issue.path}: ${issue.message}`).join("\n")}`);
+	attrsCache.set(node, result.value);
+	return result.value;
+};
+//#endregion
+export { expectRangeAnchorAttrs, readRangeAnchorAttrs, readRangeAnchorValues };

package/dist/prosemirror/replacedAnnotations.d.ts

@@ -11,7 +11,7 @@ declare const NON_INCLUSIVE_MARK_DISPOSITION: {
   readonly comment: "carry";
   readonly hyperlink: "carry";
   readonly footnoteRef: "followsTheText";
-  readonly pageBreakRunOwner: "followsTheText";
+  readonly runIdentity: "followsTheText";
   readonly insertion: "followsTheText";
   readonly deletion: "followsTheText";
   readonly runPropertyChange: "followsTheText";

package/dist/prosemirror/replacedAnnotations.js

@@ -1,6 +1,9 @@
 import { BOOKMARK_BOUNDARY_NODE_NAME } from "./extensions/nodes/BookmarkBoundaryExtension.js";
 import { COMMENT_REFERENCE_NODE_NAME } from "./extensions/nodes/CommentReferenceExtension.js";
+import { MOVE_RANGE_BOUNDARY_NODE_NAME } from "./extensions/nodes/MoveRangeBoundaryExtension.js";
+import { RANGE_ANCHOR_NODE_NAME } from "./extensions/nodes/RangeAnchorExtension.js";
 import { TEXT_BOX_ANCHOR_NODE_NAME } from "./extensions/nodes/TextBoxAnchorExtension.js";
+import { readMoveRangeBoundaryAttrs } from "./moveRangeBoundaryAttrs.js";
 import { Fragment, Mark } from "prosemirror-model";
 //#region src/prosemirror/replacedAnnotations.ts
 /**
@@ -35,9 +38,11 @@ import { Fragment, Mark } from "prosemirror-model";
 *   bare `w:footnoteReference` run, so carrying it onto a replacement would
 *   discard the new text. Replacing a reference's text deletes the reference,
 *   as deleting that text does.
-* - `pageBreakRunOwner` mark: not carried. It is editor-only identity for one
-*   authored run, not a target, and carrying it would fuse the replacement
-*   into a run it was never part of.
+* - `runIdentity` mark: not carried. It is one authored run's identity and the
+*   markup that run carried, not a target. A replacement is characters the
+*   session named by its `w:rsidR` did not write, so carrying it would fuse
+*   the replacement into a run it was never part of and stamp it with an
+*   editing session it did not belong to.
 * - tracked-change marks (`insertion`, `deletion`, `runPropertyChange`): not
 *   carried. The applier decides them per edit mode and writes them itself.
 * - `inlineWrapper` mark: not carried. Every wrapper kind states something
@@ -46,6 +51,11 @@ import { Fragment, Mark } from "prosemirror-model";
 *   override is still inside it, and one that replaces the whole of it is not.
 * - `commentReference` node: kept after the replacement, where the comment's
 *   last covered position now is.
+* - `rangeAnchor` node: kept after the replacement. A comment or move range
+*   that spans no content has no mark to carry, so replacing the words around
+*   a point comment would otherwise delete the comment outright.
+* - `moveRangeBoundary` node: a start kept before the replacement, an end
+*   after it, so replacing a moved span keeps that range's identity and scope.
 * - `bookmarkBoundary` node: a start kept before the replacement, an end after
 *   it, so the bookmark still covers the new text.
 * - `textBoxAnchor` node: kept after the replacement; the shape it anchors
@@ -70,7 +80,7 @@ const NON_INCLUSIVE_MARK_DISPOSITION = {
 	comment: "carry",
 	hyperlink: "carry",
 	footnoteRef: "followsTheText",
-	pageBreakRunOwner: "followsTheText",
+	runIdentity: "followsTheText",
 	insertion: "followsTheText",
 	deletion: "followsTheText",
 	runPropertyChange: "followsTheText",
@@ -82,10 +92,18 @@ const isCarried = (mark) => NON_INCLUSIVE_MARK_DISPOSITION[mark.type.name] === "
 /** Anchors an edit must put back, and where relative to the replacement. */
 const ANCHOR_PLACEMENT = {
 	[COMMENT_REFERENCE_NODE_NAME]: "after",
+	[RANGE_ANCHOR_NODE_NAME]: "after",
 	[TEXT_BOX_ANCHOR_NODE_NAME]: "after",
-	[BOOKMARK_BOUNDARY_NODE_NAME]: "byBoundaryType"
+	[BOOKMARK_BOUNDARY_NODE_NAME]: "byBoundaryType",
+	[MOVE_RANGE_BOUNDARY_NODE_NAME]: "byMoveBoundaryType"
 };
 const anchorPlacement = (node) => ANCHOR_PLACEMENT[node.type.name];
+const opensRange = (node, placement) => {
+	if (placement === "byBoundaryType") return node.attrs["type"] === "start";
+	if (placement !== "byMoveBoundaryType") return false;
+	const marker = readMoveRangeBoundaryAttrs(node);
+	return marker.ok && marker.value.type.endsWith("Start");
+};
 const NOTHING_REPLACED = {
 	carried: [],
 	leading: [],
@@ -107,7 +125,7 @@ const surveyReplacedAnnotations = (doc, from, to) => {
 		for (const mark of node.marks) if (isCarried(mark) && !alreadyCarried(mark, carried)) carried.push(mark);
 		const placement = anchorPlacement(node);
 		if (placement === void 0 || position < from || position + node.nodeSize > to) return false;
-		(placement === "byBoundaryType" && node.attrs["type"] === "start" ? leading : trailing).push(node);
+		(opensRange(node, placement) ? leading : trailing).push(node);
 		return false;
 	});
 	return {

package/dist/prosemirror/revisionCarriers.d.ts

@@ -1,6 +1,76 @@
 import { Node } from "prosemirror-model";
+import { PropertyRevisionKind } from "@stll/docx-core/model";
 //#region src/prosemirror/revisionCarriers.d.ts
-type FolioNodeRevisionKind = "paragraphMarkInserted" | "paragraphMarkDeleted" | "paragraphPropertiesChanged" | "sectionPropertiesChanged" | "tablePropertiesChanged" | "rowPropertiesChanged" | "cellPropertiesChanged";
+declare const PROPERTY_REVISION_SITES: {
+  readonly runPropertyChange: {
+    readonly kind: "runPropertyChange";
+    readonly resolution: "inline-mark";
+  };
+  readonly paragraphPropertyChange: {
+    readonly kind: "paragraphPropertyChange";
+    readonly resolution: "paragraph-pass";
+    readonly nodeTypes: readonly ["paragraph"];
+    readonly path: readonly ["_propertyChanges"];
+    readonly carrier: "paragraphPropertiesChanged";
+    readonly range: "paragraph-boundary";
+  };
+  readonly sectionPropertyChange: {
+    readonly kind: "sectionPropertyChange";
+    readonly resolution: "paragraph-pass";
+    readonly nodeTypes: readonly ["paragraph"];
+    readonly path: readonly ["_sectionProperties", "propertyChanges"];
+    readonly carrier: "sectionPropertiesChanged";
+    readonly range: "paragraph-boundary";
+  };
+  readonly tablePropertyChange: {
+    readonly kind: "tablePropertyChange";
+    readonly resolution: "node-attrs";
+    readonly nodeTypes: readonly ["table"];
+    readonly attr: "tblPrChange";
+    readonly carrier: "tablePropertiesChanged";
+    readonly range: "whole-node";
+  };
+  readonly tablePropertyExceptionChange: {
+    readonly kind: "tablePropertyExceptionChange";
+    readonly resolution: "node-attrs";
+    readonly nodeTypes: readonly ["tableRow"];
+    readonly attr: "tblPrExChange";
+    readonly carrier: "tablePropertyExceptionsChanged";
+    readonly range: "whole-node";
+  };
+  readonly tableRowPropertyChange: {
+    readonly kind: "tableRowPropertyChange";
+    readonly resolution: "node-attrs";
+    readonly nodeTypes: readonly ["tableRow"];
+    readonly attr: "trPrChange";
+    readonly carrier: "rowPropertiesChanged";
+    readonly range: "whole-node";
+  };
+  readonly tableCellPropertyChange: {
+    readonly kind: "tableCellPropertyChange";
+    readonly resolution: "node-attrs";
+    readonly nodeTypes: readonly ["tableCell", "tableHeader"];
+    readonly attr: "tcPrChange";
+    readonly carrier: "cellPropertiesChanged";
+    readonly range: "whole-node";
+  };
+};
+type SiteOf<TKind extends PropertyRevisionKind> = (typeof PROPERTY_REVISION_SITES)[TKind];
+/** One property revision carried on a node's attrs rather than on a mark. */
+type NodePropertyRevisionSite = Extract<SiteOf<PropertyRevisionKind>, {
+  carrier: string;
+}>;
+/** The sites the shared node-attr pass resolves, and therefore must patch. */
+type NodeAttrsPropertyRevisionSite = Extract<NodePropertyRevisionSite, {
+  resolution: "node-attrs";
+}>;
+/** The kinds that pass resolves. */
+type NodeAttrsPropertyRevisionKind = NodeAttrsPropertyRevisionSite["kind"];
+/** The reviewer-facing name of a property revision carried on a node. */
+type PropertyRevisionCarrier = NodePropertyRevisionSite["carrier"];
+type FolioNodeRevisionKind = "paragraphMarkInserted" | "paragraphMarkDeleted" | PropertyRevisionCarrier;
+/** The property revisions a PM node of this type can carry, in element order. */
+declare const nodePropertyRevisionSites: (nodeTypeName: string) => NodePropertyRevisionSite[];
 type FolioNodeRevisionCarrier = {
   id: number;
   type: FolioNodeRevisionKind;
@@ -10,10 +80,24 @@ type FolioNodeRevisionCarrier = {
   from: number;
   to: number;
 };
+type RevisionMetadata = Pick<FolioNodeRevisionCarrier, "id" | "author" | "date">;
+/** The `w:id`, author and date a stored revision's `info` carries, or null. */
+declare const propertyRevisionMetadata: (value: unknown) => RevisionMetadata | null;
+/**
+ * A stored property-revision record as ProseMirror attrs carry it. The
+ * previous property set is whatever the site's own element stores, which the
+ * reject patch filed under that kind narrows.
+ */
+type StoredPropertyRevision = {
+  info?: unknown;
+  previousFormatting?: unknown;
+};
+/** The record array a site names, walked from a node's attrs. */
+declare const propertyRevisionRecords: (node: Node, site: NodePropertyRevisionSite) => StoredPropertyRevision[];
 /**
  * Read revision records stored on ProseMirror node attributes and return the
  * exact range the shared accept/reject command requires for each carrier.
  */
 declare const getFolioNodeRevisionCarriers: (node: Node, nodePos: number) => FolioNodeRevisionCarrier[];
 //#endregion
-export { FolioNodeRevisionCarrier, FolioNodeRevisionKind, getFolioNodeRevisionCarriers };
+export { FolioNodeRevisionCarrier, FolioNodeRevisionKind, NodeAttrsPropertyRevisionKind, NodeAttrsPropertyRevisionSite, NodePropertyRevisionSite, PROPERTY_REVISION_SITES, PropertyRevisionCarrier, StoredPropertyRevision, getFolioNodeRevisionCarriers, nodePropertyRevisionSites, propertyRevisionMetadata, propertyRevisionRecords };

package/dist/prosemirror/revisionCarriers.js

@@ -1,6 +1,62 @@
-import { expectParagraphAttrs } from "./attrs/index.js";
 import { PARAGRAPH_MARK_CHANGE_KINDS } from "@stll/docx-core/model";
 //#region src/prosemirror/revisionCarriers.ts
+const PROPERTY_REVISION_SITES = {
+	runPropertyChange: {
+		kind: "runPropertyChange",
+		resolution: "inline-mark"
+	},
+	paragraphPropertyChange: {
+		kind: "paragraphPropertyChange",
+		resolution: "paragraph-pass",
+		nodeTypes: ["paragraph"],
+		path: ["_propertyChanges"],
+		carrier: "paragraphPropertiesChanged",
+		range: "paragraph-boundary"
+	},
+	sectionPropertyChange: {
+		kind: "sectionPropertyChange",
+		resolution: "paragraph-pass",
+		nodeTypes: ["paragraph"],
+		path: ["_sectionProperties", "propertyChanges"],
+		carrier: "sectionPropertiesChanged",
+		range: "paragraph-boundary"
+	},
+	tablePropertyChange: {
+		kind: "tablePropertyChange",
+		resolution: "node-attrs",
+		nodeTypes: ["table"],
+		attr: "tblPrChange",
+		carrier: "tablePropertiesChanged",
+		range: "whole-node"
+	},
+	tablePropertyExceptionChange: {
+		kind: "tablePropertyExceptionChange",
+		resolution: "node-attrs",
+		nodeTypes: ["tableRow"],
+		attr: "tblPrExChange",
+		carrier: "tablePropertyExceptionsChanged",
+		range: "whole-node"
+	},
+	tableRowPropertyChange: {
+		kind: "tableRowPropertyChange",
+		resolution: "node-attrs",
+		nodeTypes: ["tableRow"],
+		attr: "trPrChange",
+		carrier: "rowPropertiesChanged",
+		range: "whole-node"
+	},
+	tableCellPropertyChange: {
+		kind: "tableCellPropertyChange",
+		resolution: "node-attrs",
+		nodeTypes: ["tableCell", "tableHeader"],
+		attr: "tcPrChange",
+		carrier: "cellPropertiesChanged",
+		range: "whole-node"
+	}
+};
+const NODE_PROPERTY_REVISION_SITES = Object.values(PROPERTY_REVISION_SITES).flatMap((site) => site.resolution === "inline-mark" ? [] : [site]);
+/** The property revisions a PM node of this type can carry, in element order. */
+const nodePropertyRevisionSites = (nodeTypeName) => NODE_PROPERTY_REVISION_SITES.filter(({ nodeTypes }) => nodeTypes.some((name) => name === nodeTypeName));
 /**
 * Which carrier each paragraph-mark kind reports as. A relocation's break
 * resolves as the insertion or deletion it is; the kind exists so a reader is
@@ -17,7 +73,8 @@ const PARAGRAPH_MARK_KIND_CARRIERS = {
 };
 const isParagraphMarkChangeKind = (value) => PARAGRAPH_MARK_CHANGE_KINDS.some((kind) => kind === value);
 const isObjectRecord = (value) => typeof value === "object" && value !== null;
-const revisionMetadata = (value) => {
+/** The `w:id`, author and date a stored revision's `info` carries, or null. */
+const propertyRevisionMetadata = (value) => {
 	if (!isObjectRecord(value) || typeof value["id"] !== "number") return null;
 	return {
 		id: value["id"],
@@ -25,12 +82,21 @@ const revisionMetadata = (value) => {
 		date: typeof value["date"] === "string" ? value["date"] : null
 	};
 };
+/** The record array a site names, walked from a node's attrs. */
+const propertyRevisionRecords = (node, site) => {
+	const path = site.resolution === "node-attrs" ? [site.attr] : site.path;
+	let value = node.attrs;
+	for (const key of path) {
+		if (!isObjectRecord(value)) return [];
+		value = value[key];
+	}
+	return Array.isArray(value) ? value.filter(isObjectRecord) : [];
+};
 const appendPropertyCarriers = ({ carriers, changes, type, node, from, to }) => {
-	if (!Array.isArray(changes)) return;
 	let text = null;
 	for (const change of changes) {
 		if (!isObjectRecord(change)) continue;
-		const metadata = revisionMetadata(change["info"]);
+		const metadata = propertyRevisionMetadata(change["info"]);
 		if (!metadata) continue;
 		text ??= node.textContent;
 		carriers.push({
@@ -49,76 +115,36 @@ const appendPropertyCarriers = ({ carriers, changes, type, node, from, to }) =>
 const getFolioNodeRevisionCarriers = (node, nodePos) => {
 	const carriers = [];
 	if (node.type.name === "paragraph") {
-		const from = nodePos + node.nodeSize - 1;
-		const to = nodePos + node.nodeSize;
-		const paragraphAttrs = expectParagraphAttrs(node);
 		const paragraphMark = node.attrs["pPrMark"];
 		const paragraphMarkKind = isObjectRecord(paragraphMark) && isParagraphMarkChangeKind(paragraphMark["kind"]) ? PARAGRAPH_MARK_KIND_CARRIERS[paragraphMark["kind"]] : void 0;
 		if (paragraphMarkKind !== void 0 && isObjectRecord(paragraphMark)) {
-			const metadata = revisionMetadata(paragraphMark["info"]);
+			const metadata = propertyRevisionMetadata(paragraphMark["info"]);
 			if (metadata) carriers.push({
 				...metadata,
 				type: paragraphMarkKind,
 				text: node.textContent,
-				from,
-				to
+				from: nodePos + node.nodeSize - 1,
+				to: nodePos + node.nodeSize
 			});
 		}
+	}
+	for (const site of nodePropertyRevisionSites(node.type.name)) {
+		const range = site.range === "paragraph-boundary" ? {
+			from: nodePos + node.nodeSize - 1,
+			to: nodePos + node.nodeSize
+		} : {
+			from: nodePos,
+			to: nodePos + node.nodeSize
+		};
 		appendPropertyCarriers({
 			carriers,
-			changes: paragraphAttrs._propertyChanges,
-			type: "paragraphPropertiesChanged",
-			node,
-			from,
-			to
-		});
-		const sectionProperties = node.attrs["_sectionProperties"];
-		appendPropertyCarriers({
-			carriers,
-			changes: isObjectRecord(sectionProperties) ? sectionProperties["propertyChanges"] : null,
-			type: "sectionPropertiesChanged",
+			changes: propertyRevisionRecords(node, site),
+			type: site.carrier,
 			node,
-			from,
-			to
+			...range
 		});
-		return carriers;
-	}
-	const range = {
-		from: nodePos,
-		to: nodePos + node.nodeSize
-	};
-	switch (node.type.name) {
-		case "table":
-			appendPropertyCarriers({
-				carriers,
-				changes: node.attrs["tblPrChange"],
-				type: "tablePropertiesChanged",
-				node,
-				...range
-			});
-			break;
-		case "tableRow":
-			appendPropertyCarriers({
-				carriers,
-				changes: node.attrs["trPrChange"],
-				type: "rowPropertiesChanged",
-				node,
-				...range
-			});
-			break;
-		case "tableCell":
-		case "tableHeader":
-			appendPropertyCarriers({
-				carriers,
-				changes: node.attrs["tcPrChange"],
-				type: "cellPropertiesChanged",
-				node,
-				...range
-			});
-			break;
-		default: break;
 	}
 	return carriers;
 };
 //#endregion
-export { getFolioNodeRevisionCarriers };
+export { PROPERTY_REVISION_SITES, getFolioNodeRevisionCarriers, nodePropertyRevisionSites, propertyRevisionMetadata, propertyRevisionRecords };

package/dist/prosemirror/runFormattingInlineCarriers.d.ts

@@ -17,8 +17,10 @@ declare const RUN_FORMATTING_INLINE_ATOM_DISPOSITIONS: Readonly<{
   readonly hardBreak: "break-run";
   readonly image: "not-a-run";
   readonly math: "not-a-run";
+  readonly moveRangeBoundary: "not-a-run";
   readonly pageBreakRun: "page-break-carrier";
   readonly preservedXml: "preserved-xml-run";
+  readonly rangeAnchor: "not-a-run";
   readonly renderedPageBreak: "not-a-run";
   readonly shape: "not-a-run";
   readonly structuredField: "structured-field";

package/dist/prosemirror/runFormattingInlineCarriers.js

@@ -18,8 +18,10 @@ const RUN_FORMATTING_INLINE_ATOM_DISPOSITIONS = Object.freeze({
 	hardBreak: "break-run",
 	image: "not-a-run",
 	math: "not-a-run",
+	moveRangeBoundary: "not-a-run",
 	pageBreakRun: "page-break-carrier",
 	preservedXml: "preserved-xml-run",
+	rangeAnchor: "not-a-run",
 	renderedPageBreak: "not-a-run",
 	shape: "not-a-run",
 	structuredField: "structured-field",

package/dist/prosemirror/runIdentity.d.ts

@@ -0,0 +1,28 @@
+import { document_d_exports } from "../types/document.js";
+import { RunIdentityMarkAttrs } from "./schema/marks.js";
+//#region src/prosemirror/runIdentity.d.ts
+/** The DOM attribute that carries a run's identity through copy and paste. */
+declare const RUN_IDENTITY_ATTRIBUTE = "data-docx-run-identity";
+/** The schema name of the mark these attrs belong to. */
+declare const RUN_IDENTITY_MARK_NAME = "runIdentity";
+/**
+ * What a run carries beside its id: absent fields left absent, empty
+ * collections normalised to absent so a run with nothing to carry keys the
+ * same however it was built.
+ */
+type RunIdentityPayload = {
+  preservedAttributes?: readonly document_d_exports.PreservedAttribute[] | undefined;
+  preserved?: document_d_exports.PreservedMarkup | undefined;
+};
+/** A run identity's attrs in canonical form. */
+declare const runIdentityAttrs: (id: number, { preservedAttributes, preserved }?: RunIdentityPayload) => RunIdentityMarkAttrs;
+/**
+ * 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.
+ */
+declare const hasRunIdentityPayload: ({ preservedAttributes, preserved }: RunIdentityPayload) => boolean;
+//#endregion
+export { RUN_IDENTITY_ATTRIBUTE, RUN_IDENTITY_MARK_NAME, RunIdentityPayload, hasRunIdentityPayload, runIdentityAttrs };