@stll/folio-core 0.28.1 → 0.30.0

package/dist/prosemirror/conversion/toProseDoc.js

@@ -1,11 +1,13 @@
 import { resolveColorValueToHex } from "../../docx/drawingUtils.js";
 import { createStyleEngine } from "../../style-engine/styleEngine.js";
+import { normalizeHorizontalScalePercent } from "../../utils/horizontalScale.js";
 import { mergeParagraphFormatting, mergeParagraphTabStops } from "../../utils/paragraphFormattingMerge.js";
 import { tableOfContentsStyleLevel } from "../../utils/tableOfContentsStyle.js";
 import { mergeTextFormatting } from "../../utils/textFormattingMerge.js";
 import { emuToPixels } from "../../utils/units.js";
 import { setAutospacingBaseValue } from "../autospacingBase.js";
 import { buildRunFormattingOverrideAttrs } from "../extensions/marks/RunFormattingOverrideExtension.js";
+import { stampNumberedRefFieldBaselines } from "../numberedRefFields.js";
 import { directionFromBidi } from "../paragraphDirection.js";
 import { schema } from "../schema/index.js";
 import { cascadeStyleTextFormatting } from "../styles/styleToggleCascade.js";
@@ -36,6 +38,56 @@ const createHyperlinkInstanceIndexAllocator = () => {
 	return () => index++;
 };
 /**
+* Find bookmark pairs across every editable inline wrapper in a document story.
+* Each endpoint is converted at its own structural position, so a range may
+* start outside a hyperlink and end inside it (or the inverse).
+*/
+const collectPairedBookmarkIds = (blocks) => {
+	const counts = /* @__PURE__ */ new Map();
+	let position = 0;
+	const countBoundary = (id, type) => {
+		const count = counts.get(id) ?? {
+			starts: 0,
+			ends: 0
+		};
+		if (type === "start") {
+			count.starts += 1;
+			count.firstStart ??= position;
+		} else {
+			count.ends += 1;
+			count.firstEnd ??= position;
+		}
+		position += 1;
+		counts.set(id, count);
+	};
+	const visitRun = (run) => {
+		for (const content of run.content) if (content.type === "shape" && content.shape.textBody) visitBlocks(content.shape.textBody.content);
+	};
+	const visitHyperlink = (hyperlink) => {
+		for (const child of hyperlink.children) if (child.type === "bookmarkStart") countBoundary(child.id, "start");
+		else if (child.type === "bookmarkEnd") countBoundary(child.id, "end");
+		else visitRun(child);
+	};
+	const visitParagraphContent = (content) => {
+		if (content.type === "bookmarkStart") countBoundary(content.id, "start");
+		else if (content.type === "bookmarkEnd") countBoundary(content.id, "end");
+		else if (content.type === "run") visitRun(content);
+		else if (content.type === "hyperlink") visitHyperlink(content);
+		else if (content.type === "simpleField") for (const child of content.content) if (child.type === "hyperlink") visitHyperlink(child);
+		else visitRun(child);
+		else if (content.type === "complexField") for (const run of [...content.fieldCode ?? [], ...content.fieldResult]) visitRun(run);
+		else if (content.type === "inlineSdt") for (const child of content.content) visitParagraphContent(child);
+		else if (content.type === "insertion" || content.type === "deletion" || content.type === "moveFrom" || content.type === "moveTo") for (const child of content.content) visitParagraphContent(child);
+	};
+	const visitBlocks = (nestedBlocks) => {
+		for (const block of nestedBlocks) if (block.type === "paragraph") for (const content of block.content) visitParagraphContent(content);
+		else if (block.type === "table") for (const row of block.rows) for (const cell of row.cells) visitBlocks(cell.content);
+		else visitBlocks(block.content);
+	};
+	visitBlocks(blocks);
+	return new Set([...counts].flatMap(([id, count]) => count.starts === 1 && count.ends === 1 && count.firstStart !== void 0 && count.firstEnd !== void 0 && count.firstStart < count.firstEnd ? [id] : []));
+};
+/**
 * Convert a Document to a ProseMirror document
 *
 * @param document - The Document to convert
@@ -50,7 +102,8 @@ function toProseDoc(document, options) {
 	const conversionContext = {
 		theme,
 		nextTextBoxGroupId,
-		nextHyperlinkInstanceIndex: createHyperlinkInstanceIndexAllocator()
+		nextHyperlinkInstanceIndex: createHyperlinkInstanceIndexAllocator(),
+		pairedBookmarkIds: collectPairedBookmarkIds(paragraphs)
 	};
 	const convertBodyBlocks = (blocks) => {
 		const out = [];
@@ -85,7 +138,7 @@ function toProseDoc(document, options) {
 	};
 	nodes.push(...convertBodyBlocks(paragraphs));
 	if (nodes.length === 0) nodes.push(schema.node("paragraph", {}, []));
-	const pmDoc = schema.node("doc", null, nodes);
+	const pmDoc = stampNumberedRefFieldBaselines(schema.node("doc", null, nodes));
 	assertValidProseMirrorDocument(pmDoc, "Document conversion produced an invalid ProseMirror document");
 	return pmDoc;
 }
@@ -126,7 +179,7 @@ function convertBlockSdt(blockSdt, convertBlocks) {
 * Resolves style-based text formatting and passes it to runs so that
 * paragraph styles (like Heading1) apply their font size, color, etc.
 */
-function convertParagraph(paragraph, styleResolver, nextHyperlinkInstanceIndex, activeCommentIds, extraRunFormatting, tableParagraphOverlay, textBoxAnchors) {
+function convertParagraph(paragraph, styleResolver, nextHyperlinkInstanceIndex, pairedBookmarkIds, activeCommentIds, extraRunFormatting, tableParagraphOverlay, textBoxAnchors) {
 	const attrs = paragraphFormattingToAttrs(paragraph, styleResolver, tableParagraphOverlay);
 	const isTocParagraph = attrs._tableOfContentsLevel !== void 0;
 	const inlineNodes = [];
@@ -209,42 +262,56 @@ function convertParagraph(paragraph, styleResolver, nextHyperlinkInstanceIndex,
 	const emitTrackedChange = (change, markType, moveKind) => {
 		emitInlineNodes(convertTrackedChange(change, markType, nextHyperlinkInstanceIndex, getInheritedRunFormatting, styleResolver, moveKind, textBoxAnchors));
 	};
-	for (const content of paragraph.content) {
-		if (content.type === "commentRangeStart") commentIds.add(content.id);
-		else if (content.type === "commentRangeEnd") commentIds.delete(content.id);
-		else if (content.type === "commentReference") anchorPointComment(inlineNodes, content.id);
-		else if (content.type === "run") emitInlineNodes(convertRun(content, getInheritedRunFormatting(content.formatting), styleResolver, textBoxAnchors));
-		else if (content.type === "hyperlink") {
-			const linkNodes = convertHyperlink(content, {
-				getInheritedRunFormatting,
-				styleResolver,
-				hyperlinkIndex: nextHyperlinkInstanceIndex(),
-				textBoxAnchors
-			});
-			if (linkNodes.length === 0) {
-				emptyHyperlinks ??= [];
-				emptyHyperlinks.push({
-					offset: inlineOffset,
-					...content.href !== void 0 ? { href: content.href } : {},
-					...content.anchor !== void 0 ? { anchor: content.anchor } : {},
-					...content.tooltip !== void 0 ? { tooltip: content.tooltip } : {},
-					...content.rId !== void 0 ? { rId: content.rId } : {}
-				});
-				continue;
-			}
-			emitInlineNodes(linkNodes);
-		} else if (content.type === "simpleField" || content.type === "complexField") emitInlineNode(convertField(content, getInheritedRunFormatting, styleResolver));
-		else if (content.type === "inlineSdt") emitInlineNode(convertInlineSdt(content, nextHyperlinkInstanceIndex, getInheritedRunFormatting, styleResolver, textBoxAnchors));
-		else if (content.type === "insertion" || content.type === "moveTo") emitTrackedChange(content, "insertion", content.type === "moveTo" ? "moveTo" : null);
-		else if (content.type === "deletion" || content.type === "moveFrom") emitTrackedChange(content, "deletion", content.type === "moveFrom" ? "moveFrom" : null);
-		else if (content.type === "mathEquation") emitInlineNode(convertMathEquation(content));
-		if (content.type === "bookmarkStart") {
-			if (!bookmarksArr) bookmarksArr = [];
-			bookmarksArr.push({
-				id: content.id,
-				name: content.name
+	for (const content of paragraph.content) if (content.type === "commentRangeStart") commentIds.add(content.id);
+	else if (content.type === "commentRangeEnd") commentIds.delete(content.id);
+	else if (content.type === "commentReference") anchorPointComment(inlineNodes, content.id);
+	else if (content.type === "run") emitInlineNodes(convertRun(content, getInheritedRunFormatting(content.formatting), styleResolver, textBoxAnchors));
+	else if (content.type === "hyperlink") {
+		const linkNodes = convertHyperlink(content, {
+			getInheritedRunFormatting,
+			styleResolver,
+			hyperlinkIndex: nextHyperlinkInstanceIndex(),
+			textBoxAnchors
+		});
+		if (linkNodes.length === 0) {
+			emptyHyperlinks ??= [];
+			emptyHyperlinks.push({
+				offset: inlineOffset,
+				...content.href !== void 0 ? { href: content.href } : {},
+				...content.anchor !== void 0 ? { anchor: content.anchor } : {},
+				...content.tooltip !== void 0 ? { tooltip: content.tooltip } : {},
+				...content.rId !== void 0 ? { rId: content.rId } : {}
 			});
+			continue;
 		}
+		emitInlineNodes(linkNodes);
+	} else if (content.type === "simpleField" || content.type === "complexField") emitInlineNode(convertField(content, {
+		getInheritedRunFormatting,
+		styleResolver,
+		nextHyperlinkInstanceIndex,
+		textBoxAnchors
+	}));
+	else if (content.type === "inlineSdt") emitInlineNode(convertInlineSdt(content, nextHyperlinkInstanceIndex, getInheritedRunFormatting, styleResolver, textBoxAnchors));
+	else if (content.type === "insertion" || content.type === "moveTo") emitTrackedChange(content, "insertion", content.type === "moveTo" ? "moveTo" : null);
+	else if (content.type === "deletion" || content.type === "moveFrom") emitTrackedChange(content, "deletion", content.type === "moveFrom" ? "moveFrom" : null);
+	else if (content.type === "mathEquation") emitInlineNode(convertMathEquation(content));
+	else if (content.type === "bookmarkStart" && pairedBookmarkIds.has(content.id)) emitInlineNode(schema.node("bookmarkBoundary", {
+		type: "start",
+		id: content.id,
+		name: content.name,
+		colFirst: content.colFirst,
+		colLast: content.colLast
+	}));
+	else if (content.type === "bookmarkEnd" && pairedBookmarkIds.has(content.id)) emitInlineNode(schema.node("bookmarkBoundary", {
+		type: "end",
+		id: content.id
+	}));
+	else if (content.type === "bookmarkStart") {
+		if (!bookmarksArr) bookmarksArr = [];
+		bookmarksArr.push({
+			id: content.id,
+			name: content.name
+		});
 	}
 	if (bookmarksArr) attrs.bookmarks = bookmarksArr;
 	if (emptyHyperlinks) attrs._emptyHyperlinks = emptyHyperlinks;
@@ -313,7 +380,7 @@ function convertTrackedChange(change, markType, nextHyperlinkInstanceIndex, getI
 	});
 }
 function canCarryTrackedRunMark(node, markType) {
-	return node.isText || node.isInline && node.type.allowsMarkType(markType) && (node.type.name === "image" || node.type.name === "shape" || node.type.name === "hardBreak" || node.type.name === "tab" || node.type.name === "symbol" || node.type.name === "textBoxAnchor");
+	return node.isText || node.isInline && node.type.allowsMarkType(markType) && (node.type.name === "image" || node.type.name === "shape" || node.type.name === "hardBreak" || node.type.name === "tab" || node.type.name === "symbol" || node.type.name === "bookmarkBoundary" || node.type.name === "textBoxAnchor");
 }
 /**
 * Convert ParagraphFormatting to ProseMirror paragraph attrs
@@ -736,6 +803,7 @@ function convertTable(table, styleResolver, context) {
 	const resolvedTableBorders = table.formatting?.borders ?? tableStyle?.tblPr?.borders ?? fallbackTableStyle?.tblPr?.borders;
 	const fallbackTableIndent = fallbackTableStyle?.tblPr?.indent;
 	const resolvedTableIndent = table.formatting?.indent ?? tableStyle?.tblPr?.indent ?? (fallbackTableIndent?.value === 0 ? void 0 : fallbackTableIndent);
+	const resolvedTableJustification = tableStyle?.tblPr?.justification ?? fallbackTableStyle?.tblPr?.justification;
 	const resolvedTableBidi = table.formatting?.bidi ?? tableStyle?.tblPr?.bidi ?? fallbackTableStyle?.tblPr?.bidi;
 	const tableCellMargins = table.formatting?.cellMargins ?? tableStyle?.tblPr?.cellMargins ?? fallbackTableStyle?.tblPr?.cellMargins;
 	let cellMarginsAttr;
@@ -758,6 +826,7 @@ function convertTable(table, styleResolver, context) {
 	if (table.formatting?.look) attrs.look = table.formatting.look;
 	if (table.formatting?.borders) attrs.borders = table.formatting.borders;
 	if (resolvedTableIndent) attrs._resolvedIndent = resolvedTableIndent;
+	if (resolvedTableJustification) attrs._resolvedJustification = resolvedTableJustification;
 	if (resolvedTableBidi !== void 0) attrs._resolvedBidi = resolvedTableBidi;
 	if (table.formatting) attrs._originalFormatting = table.formatting;
 	if (table.propertyChanges && table.propertyChanges.length > 0) attrs.tblPrChange = [...table.propertyChanges];
@@ -797,7 +866,8 @@ function convertTable(table, styleResolver, context) {
 			})();
 		})();
 		if (bandingEnabledH && !isFirstRowStyled && !isLastRow) dataRowIndex++;
-		return convertTableRow(row, styleResolver, context, isFirstRowStyled, columnWidths, totalWidth, conditionalStyles, rowBandStyle, bandingEnabledV, look, resolvedTableBorders, rowIndex, totalRows, totalColumns, rowSpanMap, cellMarginsAttr);
+		const resolvedRowJustification = tableStyle?.trPr?.justification ?? fallbackTableStyle?.trPr?.justification;
+		return convertTableRow(row, styleResolver, context, isFirstRowStyled, columnWidths, totalWidth, conditionalStyles, rowBandStyle, bandingEnabledV, look, resolvedTableBorders, rowIndex, totalRows, totalColumns, rowSpanMap, cellMarginsAttr, resolvedRowJustification);
 	});
 	return schema.node("table", attrs, rows);
 }
@@ -814,11 +884,12 @@ function countTableColumns(rows) {
 /**
 * Convert a TableRow to a ProseMirror table row node
 */
-function convertTableRow(row, styleResolver, context, isHeaderRow, columnWidths, totalWidth, conditionalStyles, rowBandStyle, bandingEnabledV, tableLook, tableBorders, rowIndex, totalRows, totalColumns, rowSpanMap, defaultCellMargins) {
+function convertTableRow(row, styleResolver, context, isHeaderRow, columnWidths, totalWidth, conditionalStyles, rowBandStyle, bandingEnabledV, tableLook, tableBorders, rowIndex, totalRows, totalColumns, rowSpanMap, defaultCellMargins, resolvedJustification) {
 	const attrsWithoutStructuralChange = { isHeader: !!row.formatting?.header };
 	if (row.formatting?.height?.value !== void 0) attrsWithoutStructuralChange.height = row.formatting.height.value;
 	if (row.formatting?.heightRule) attrsWithoutStructuralChange.heightRule = row.formatting.heightRule;
 	if (row.formatting?.hidden) attrsWithoutStructuralChange.hidden = true;
+	if (resolvedJustification) attrsWithoutStructuralChange._resolvedJustification = resolvedJustification;
 	if (row.formatting) attrsWithoutStructuralChange._originalFormatting = row.formatting;
 	if (row.propertyChanges && row.propertyChanges.length > 0) attrsWithoutStructuralChange.trPrChange = [...row.propertyChanges];
 	let attrs = attrsWithoutStructuralChange;
@@ -1011,7 +1082,8 @@ function standaloneTableCellToProseMirror(cell, nodeType) {
 		context: {
 			theme: null,
 			nextTextBoxGroupId: createTextBoxGroupIdFactory(),
-			nextHyperlinkInstanceIndex: createHyperlinkInstanceIndexAllocator()
+			nextHyperlinkInstanceIndex: createHyperlinkInstanceIndexAllocator(),
+			pairedBookmarkIds: collectPairedBookmarkIds(cell.content)
 		},
 		isHeader: nodeType === "tableHeader",
 		gridWidthPercent: void 0,
@@ -1024,31 +1096,47 @@ function standaloneTableCellToProseMirror(cell, nodeType) {
 		defaultCellMargins: void 0
 	});
 }
-/**
-* Convert a SimpleField or ComplexField to a ProseMirror field node.
-* Preserves run formatting (bold, fontSize, color, etc.) as PM marks.
-* Accepts a run formatting resolver so fields inherit paragraph-level
-* formatting the same way regular text runs do.
-*/
-function convertField(field, getInheritedRunFormatting, styleResolver) {
+function convertField(field, { getInheritedRunFormatting, styleResolver, nextHyperlinkInstanceIndex, textBoxAnchors }) {
 	let displayText = "";
 	let fieldFormatting;
-	const runs = field.type === "simpleField" ? field.content : field.fieldResult;
-	for (const r of runs) if (r.type === "run") {
-		for (const c of r.content) if (c.type === "text") displayText += c.text;
-		if (!fieldFormatting && r.formatting) fieldFormatting = r.formatting;
+	const inlineNodes = [];
+	const hasStructuredSourceContent = field.type === "simpleField" && field.content.some((content) => content.type === "hyperlink");
+	const appendRun = (run) => {
+		for (const content of run.content) if (content.type === "text") displayText += content.text;
+		fieldFormatting ??= run.formatting;
+		if (!hasStructuredSourceContent) return;
+		inlineNodes.push(...convertRun(run, getInheritedRunFormatting(run.formatting, field.fieldType), styleResolver, textBoxAnchors));
+	};
+	if (field.type === "simpleField") for (const content of field.content) {
+		if (content.type === "run") {
+			appendRun(content);
+			continue;
+		}
+		for (const child of content.children) if (child.type === "run") {
+			for (const runContent of child.content) if (runContent.type === "text") displayText += runContent.text;
+			fieldFormatting ??= child.formatting;
+		}
+		inlineNodes.push(...convertHyperlink(content, {
+			getInheritedRunFormatting: (formatting) => getInheritedRunFormatting(formatting, field.fieldType),
+			styleResolver,
+			hyperlinkIndex: nextHyperlinkInstanceIndex(),
+			textBoxAnchors
+		}));
 	}
+	else for (const run of field.fieldResult) appendRun(run);
 	if (!fieldFormatting && field.type === "complexField" && field.fieldResult.length === 0) fieldFormatting = field.formatting;
 	const inheritedFormatting = getInheritedRunFormatting(fieldFormatting, field.fieldType);
 	const { marks } = buildRunMarks(fieldFormatting, inheritedFormatting, styleResolver);
-	return schema.node("field", {
+	const hasConvertedHyperlinkContent = inlineNodes.some((node) => node.marks.some((mark) => mark.type.name === "hyperlink"));
+	const createStructuredField = hasStructuredSourceContent && hasConvertedHyperlinkContent;
+	return schema.node(createStructuredField ? "structuredField" : "field", {
 		fieldType: field.fieldType,
 		instruction: field.instruction,
 		displayText,
 		fieldKind: field.type === "simpleField" ? "simple" : "complex",
 		fldLock: field.fldLock ?? false,
 		dirty: field.dirty ?? false
-	}, void 0, marks);
+	}, createStructuredField ? inlineNodes : void 0, marks);
 }
 /**
 * Convert a MathEquation to a ProseMirror math node.
@@ -1078,7 +1166,12 @@ function convertInlineSdt(sdt, nextHyperlinkInstanceIndex, getInheritedRunFormat
 		});
 		inlineNodes.push(...linkNodes);
 	} else if (content.type === "simpleField" || content.type === "complexField") {
-		const fieldNode = convertField(content, getInheritedRunFormatting, styleResolver);
+		const fieldNode = convertField(content, {
+			getInheritedRunFormatting,
+			styleResolver,
+			nextHyperlinkInstanceIndex,
+			textBoxAnchors
+		});
 		if (fieldNode) inlineNodes.push(fieldNode);
 	} else if (content.type === "inlineSdt") {
 		const nestedSdt = convertInlineSdt(content, nextHyperlinkInstanceIndex, getInheritedRunFormatting, styleResolver, textBoxAnchors);
@@ -1338,11 +1431,30 @@ function convertHyperlink(hyperlink, { getInheritedRunFormatting, styleResolver,
 		rId: hyperlink.rId,
 		_docxHyperlinkIndex: hyperlinkIndex
 	});
-	for (const child of hyperlink.children) if (child.type === "run") {
-		const inheritedFormatting = getInheritedRunFormatting(child.formatting);
-		const { marks: runMarks, mergedFormatting } = buildRunMarks(child.formatting, inheritedFormatting, styleResolver);
-		const allMarks = [...runMarks, linkMark];
-		for (const content of child.content) nodes.push(...convertRunContent(content, allMarks, mergedFormatting, textBoxAnchors));
+	for (const child of hyperlink.children) {
+		if (child.type === "bookmarkStart") {
+			nodes.push(schema.node("bookmarkBoundary", {
+				type: "start",
+				id: child.id,
+				name: child.name,
+				colFirst: child.colFirst,
+				colLast: child.colLast
+			}, void 0, [linkMark]));
+			continue;
+		}
+		if (child.type === "bookmarkEnd") {
+			nodes.push(schema.node("bookmarkBoundary", {
+				type: "end",
+				id: child.id
+			}, void 0, [linkMark]));
+			continue;
+		}
+		if (child.type === "run") {
+			const inheritedFormatting = getInheritedRunFormatting(child.formatting);
+			const { marks: runMarks, mergedFormatting } = buildRunMarks(child.formatting, inheritedFormatting, styleResolver);
+			const allMarks = [...runMarks, linkMark];
+			for (const content of child.content) nodes.push(...convertRunContent(content, allMarks, mergedFormatting, textBoxAnchors));
+		}
 	}
 	return nodes;
 }
@@ -1386,7 +1498,7 @@ function textFormattingToMarks(formatting, options) {
 	if (formatting.smallCaps) marks.push(schema.mark("smallCaps"));
 	const spacing = typeof formatting.spacing === "number" ? formatting.spacing : null;
 	const position = typeof formatting.position === "number" ? formatting.position : null;
-	const scale = typeof formatting.scale === "number" ? formatting.scale : null;
+	const scale = normalizeHorizontalScalePercent(formatting.scale) ?? null;
 	const kerning = typeof formatting.kerning === "number" ? formatting.kerning : null;
 	if (spacing !== null || position !== null || scale !== null || kerning !== null) marks.push(schema.mark("characterSpacing", {
 		spacing,
@@ -1511,7 +1623,7 @@ function convertShape(shape) {
 }
 function convertParagraphWithTextBoxes(block, styleResolver, { textBoxGroupId, context, extraRunFormatting, tableParagraphOverlay }) {
 	const { textBoxes, textBoxAnchors } = extractTextBoxesFromParagraph(block, textBoxGroupId);
-	const pmParagraph = convertParagraph(block, styleResolver, context.nextHyperlinkInstanceIndex, void 0, extraRunFormatting, tableParagraphOverlay, textBoxAnchors);
+	const pmParagraph = convertParagraph(block, styleResolver, context.nextHyperlinkInstanceIndex, context.pairedBookmarkIds, void 0, extraRunFormatting, tableParagraphOverlay, textBoxAnchors);
 	const nodes = [];
 	const isEmptyAfterExtraction = textBoxes.length > 0 && !hasContentBesidesTextBoxAnchors(pmParagraph);
 	const keepWrapperParagraph = isEmptyAfterExtraction && hasParagraphBoundaryPayload(block, pmParagraph);
@@ -1657,6 +1769,7 @@ function textBoxFromShape(shape, textBody) {
 	if (textBody.margins) textBox.margins = textBody.margins;
 	if (textBody.autoFit) textBox.autoFit = textBody.autoFit;
 	if (textBody.textWrap) textBox.textWrap = textBody.textWrap;
+	if (textBody.anchor) textBox.verticalAlign = textBody.anchor;
 	return textBox;
 }
 /**
@@ -1732,6 +1845,7 @@ function convertTextBox(textBox, styleResolver, options) {
 		height: heightPx,
 		autoFit: textBox.autoFit,
 		textWrap: textBox.textWrap,
+		verticalAlign: textBox.verticalAlign,
 		textBoxId: textBox.id,
 		fillColor,
 		outlineWidth,
@@ -1773,7 +1887,8 @@ function headerFooterToProseDoc(content, options) {
 	const conversionContext = {
 		theme,
 		nextTextBoxGroupId,
-		nextHyperlinkInstanceIndex: createHyperlinkInstanceIndexAllocator()
+		nextHyperlinkInstanceIndex: createHyperlinkInstanceIndexAllocator(),
+		pairedBookmarkIds: collectPairedBookmarkIds(content)
 	};
 	const convertBlocks = (blocks) => {
 		const out = [];
@@ -1787,7 +1902,7 @@ function headerFooterToProseDoc(content, options) {
 	};
 	nodes.push(...convertBlocks(content));
 	if (nodes.length === 0) nodes.push(schema.node("paragraph", {}, []));
-	const pmDoc = schema.node("doc", null, nodes);
+	const pmDoc = stampNumberedRefFieldBaselines(schema.node("doc", null, nodes));
 	assertValidProseMirrorDocument(pmDoc, "Header/footer conversion produced an invalid ProseMirror document");
 	return pmDoc;
 }

package/dist/prosemirror/extensions/StarterKit.js

@@ -43,7 +43,8 @@ import { EmbossExtension, EmphasisMarkExtension, ImprintExtension, TextOutlineEx
 import { DeletionExtension, InsertionExtension, RunPropertyChangeExtension } from "./marks/TrackedChangeExtensions.js";
 import { UnderlineExtension } from "./marks/UnderlineExtension.js";
 import { BlockSdtExtension } from "./nodes/BlockSdtExtension.js";
-import { FieldExtension } from "./nodes/FieldExtension.js";
+import { BookmarkBoundaryExtension } from "./nodes/BookmarkBoundaryExtension.js";
+import { FieldExtension, StructuredFieldExtension } from "./nodes/FieldExtension.js";
 import { HardBreakExtension } from "./nodes/HardBreakExtension.js";
 import { HorizontalRuleExtension } from "./nodes/HorizontalRuleExtension.js";
 import { ImageExtension } from "./nodes/ImageExtension.js";
@@ -64,6 +65,11 @@ import { TextBoxExtension } from "./nodes/TextBoxExtension.js";
 function createStarterKit(options = {}) {
 	const disabled = options.disable ? new Set(options.disable) : /* @__PURE__ */ new Set();
 	const extensions = [];
+	let internalClipboardToken;
+	const getInternalClipboardToken = () => {
+		internalClipboardToken ??= globalThis.crypto.randomUUID();
+		return internalClipboardToken;
+	};
 	function add(name, ext) {
 		if (!disabled.has(name)) extensions.push(ext);
 	}
@@ -105,12 +111,13 @@ function createStarterKit(options = {}) {
 	add("insertion", InsertionExtension());
 	add("deletion", DeletionExtension());
 	add("runPropertyChange", RunPropertyChangeExtension());
+	add("bookmarkBoundary", BookmarkBoundaryExtension({ getInternalClipboardToken }));
 	add("hardBreak", HardBreakExtension());
 	add("tab", TabExtension());
 	add("symbol", SymbolExtension());
 	add("image", ImageExtension());
 	add("textBox", TextBoxExtension());
-	add("textBoxAnchor", TextBoxAnchorExtension());
+	add("textBoxAnchor", TextBoxAnchorExtension({ getInternalClipboardToken }));
 	add("shape", ShapeExtension());
 	add("imageDrag", ImageDragExtension());
 	add("imagePaste", ImagePasteExtension());
@@ -120,11 +127,12 @@ function createStarterKit(options = {}) {
 	add("pageBreak", PageBreakExtension());
 	add("renderedPageBreak", RenderedPageBreakExtension());
 	add("field", FieldExtension());
+	add("field", StructuredFieldExtension({ getInternalClipboardToken }));
 	add("sdt", SdtExtension());
 	add("blockSdt", BlockSdtExtension());
 	add("math", MathExtension());
 	if (!disabled.has("table")) extensions.push(...createTableExtensions());
-	add("pasteCleanup", PasteCleanupExtension());
+	add("pasteCleanup", PasteCleanupExtension({ getInternalClipboardToken }));
 	add("pasteStyleInliner", PasteStyleInlinerExtension());
 	add("list", ListExtension());
 	add("baseKeymap", BaseKeymapExtension());

package/dist/prosemirror/extensions/features/AutoBidiDetectionExtension.js

@@ -9,12 +9,16 @@ const autoBidiDetectionKey = new PluginKey("autoBidiDetection");
 const paragraphDirectionalText = (node) => {
 	let text = "";
 	node.descendants((child) => {
+		if (child.marks.some((mark) => mark.type.name === "deletion")) return false;
 		if (child.isText) {
-			if (!child.marks.some((mark) => mark.type.name === "deletion")) text += child.text ?? "";
-		} else if (child.type.name === "field") {
-			const display = child.attrs["displayText"];
-			if (typeof display === "string") text += display;
+			text += child.text ?? "";
+			return false;
 		}
+		if (child.isLeaf && child.textContent) {
+			text += child.textContent;
+			return false;
+		}
+		return true;
 	});
 	return text;
 };

package/dist/prosemirror/extensions/features/PasteCleanupExtension.d.ts

@@ -14,6 +14,9 @@ import { Extension } from "../types.js";
  * 2. `Mod-Alt-v` — "paste without formatting", inserting clipboard text with
  *    the source formatting stripped (see {@link pasteWithoutFormatting}).
  */
-declare const PasteCleanupExtension: (options?: Partial<Record<string, unknown>> | undefined) => Extension;
+type PasteCleanupOptions = {
+  getInternalClipboardToken?: () => string;
+};
+declare const PasteCleanupExtension: (options?: Partial<PasteCleanupOptions> | undefined) => Extension;
 //#endregion
 export { PasteCleanupExtension };

package/dist/prosemirror/extensions/features/PasteCleanupExtension.js

@@ -1,7 +1,7 @@
 import { pasteWithoutFormatting } from "../../commands/pastePlainText.js";
 import { createExtension } from "../create.js";
 import { Priority } from "../types.js";
-import { cleanPastedHtml } from "./pasteCleanup.js";
+import { cleanPastedHtml, removeUnpairedBookmarkBoundaries } from "./pasteCleanup.js";
 import { Plugin } from "prosemirror-state";
 //#region src/prosemirror/extensions/features/PasteCleanupExtension.ts
 /**
@@ -21,11 +21,15 @@ import { Plugin } from "prosemirror-state";
 const PasteCleanupExtension = createExtension({
 	name: "pasteCleanup",
 	priority: Priority.Highest,
-	onSchemaReady() {
+	onSchemaReady(_context, options) {
 		return {
-			plugins: [new Plugin({ props: { transformPastedHTML(html) {
-				return cleanPastedHtml(html);
-			} } })],
+			plugins: [new Plugin({ props: {
+				transformPastedHTML(html) {
+					const internalClipboardToken = options.getInternalClipboardToken?.();
+					return cleanPastedHtml(html, { ...internalClipboardToken ? { internalClipboardToken } : {} });
+				},
+				transformPasted: removeUnpairedBookmarkBoundaries
+			} })],
 			keyboardShortcuts: { "Mod-Alt-v": pasteWithoutFormatting }
 		};
 	}

package/dist/prosemirror/extensions/features/pasteCleanup.d.ts

@@ -1,31 +1,18 @@
+import { Slice } from "prosemirror-model";
 //#region src/prosemirror/extensions/features/pasteCleanup.d.ts
-/**
- * Office / web paste cleanup
- *
- * Content pasted from word processors and web pages arrives wrapped in a large
- * amount of producer-specific cruft: conditional comments, XML processing
- * instructions, namespaced markup (`<o:p>`, `<w:sdt>`, smart tags), `mso-*`
- * style declarations, and empty spans. None of it maps to the editor schema,
- * and some of it confuses the browser HTML parser that ProseMirror's clipboard
- * pipeline relies on. Producer class names (`MsoNormal`, ...) are deliberately
- * kept so the downstream style inliner can match `<style>` rules against them.
- *
- * `cleanPastedHtml` normalizes the raw clipboard HTML string into something the
- * schema's `parseDOM` rules can read cleanly. It is a pure string transform so
- * it runs in the editor and in tests without a DOM, and it is deliberately
- * conservative: it strips producer metadata but never rewrites visible text
- * (curly quotes, non-Latin scripts, and whitespace between words are left
- * untouched, since this editor targets an international, typography-sensitive
- * audience).
- */
 /**
  * Strip Office/web producer cruft from a raw clipboard HTML string.
  *
- * Best-effort and non-throwing: any unexpected failure returns the original
- * markup so a paste degrades to the browser default rather than losing content.
+ * Best-effort and non-throwing: any unexpected failure returns empty markup so
+ * reconstruction capabilities and other untrusted attributes fail closed.
  * `<style>` blocks are intentionally left in place for the downstream style
  * inliner, which resolves class-based CSS before the schema parser runs.
  */
-declare function cleanPastedHtml(html: string): string;
+type CleanPastedHtmlOptions = {
+  internalClipboardToken?: string;
+};
+declare function cleanPastedHtml(html: string, options?: CleanPastedHtmlOptions): string;
+/** Remove incomplete or duplicate bookmark pairs at copied slice edges. */
+declare function removeUnpairedBookmarkBoundaries(slice: Slice): Slice;
 //#endregion
-export { cleanPastedHtml };
+export { cleanPastedHtml, removeUnpairedBookmarkBoundaries };