@stll/folio-core 0.37.2 → 0.37.4

package/dist/prosemirror/conversion/fromProseDoc.js

@@ -1,5 +1,5 @@
 import { numPrEqual } from "../../docx/numberingParser.js";
-import { copyParagraphPropertySource, getParagraphPropertySource, getParagraphPropertySourceCandidate, getParagraphPropertySourceTransferId, linkParagraphPropertySourceCandidate, recreateProseNodeWithParagraphPropertySource } from "../../docx/paragraphPropertySource.js";
+import { PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR, ParagraphPropertySourceValidationError, copyDocumentParagraphPropertySourceContract, copyDocumentParagraphPropertySources, copyParagraphPropertyCapture, copyParagraphPropertySource, decodeTableCellParagraphSourcePayload, getDocumentParagraphPropertySourceContract, getParagraphPropertySource, getParagraphPropertySourceCandidate, getParagraphPropertySourceToken, getParagraphPropertySourceTransferId, getProseDocumentParagraphPropertySourceContract, getProseParagraphPropertySourceToken, isParagraphPropertySourceToken, linkParagraphPropertySourceCandidate, paragraphPropertySourceBelongsToDocument, paragraphPropertySourceTokenMatchesContract, recreateProseNodeWithParagraphPropertySource, restoreTableCellsWithParagraphPropertySources, visitDocumentStoryParagraphs, visitTableCellParagraphPropertySourceBindings } from "../../docx/paragraphPropertySource.js";
 import { visitDocxParagraphs } from "../../docx/paragraphTraversal.js";
 import { ShapeOutlineStyleSchema, narrowEnum } from "../../docx/parserEnums.js";
 import { DATE_UTC_ATTRIBUTE } from "../../docx/trackedChangeInfo.js";
@@ -103,23 +103,84 @@ const uniqueParagraphsById = (content, includeTransferIds = false) => {
 	});
 	return paragraphs;
 };
+const restoreParagraphPropertySource = (paragraph, baseParagraph) => {
+	copyParagraphPropertySource(paragraph, baseParagraph);
+	const baseFormatting = baseParagraph.formatting;
+	if (!baseFormatting?.numPr || !baseFormatting.numPrFromStyle || !numPrEqual(baseFormatting.numPr, baseFormatting.numPrFromStyle)) return;
+	const { numPr, numPrFromStyle, ...authoredFormatting } = baseFormatting;
+	if (canonicalJson(paragraph.formatting ?? {}) !== canonicalJson(authoredFormatting)) return;
+	paragraph.formatting = {
+		...paragraph.formatting,
+		numPr,
+		numPrFromStyle
+	};
+};
 const restoreParagraphPropertySources = (content, baseContent, linkedTargets, linkedSources) => {
 	const baseParagraphs = uniqueParagraphsById(baseContent, true);
 	for (const [paraId, paragraph] of uniqueParagraphsById(content)) {
 		const baseParagraph = baseParagraphs.get(paraId);
 		if (!paragraph || !baseParagraph || linkedTargets.has(paragraph) || linkedSources.has(baseParagraph) || !getParagraphPropertySource(baseParagraph)) continue;
-		copyParagraphPropertySource(paragraph, baseParagraph);
-		const baseFormatting = baseParagraph.formatting;
-		if (!baseFormatting?.numPr || !baseFormatting.numPrFromStyle || !numPrEqual(baseFormatting.numPr, baseFormatting.numPrFromStyle)) continue;
-		const { numPr, numPrFromStyle, ...authoredFormatting } = baseFormatting;
-		if (canonicalJson(paragraph.formatting ?? {}) !== canonicalJson(authoredFormatting)) continue;
-		paragraph.formatting = {
-			...paragraph.formatting,
-			numPr,
-			numPrFromStyle
-		};
+		restoreParagraphPropertySource(paragraph, baseParagraph);
 	}
 };
+const sourceValidationError = (code, message) => new ParagraphPropertySourceValidationError({
+	code,
+	message
+});
+const validateParagraphPropertySourceTokens = (pmDoc, baseDocument, contract) => {
+	const sourceParagraphs = copyDocumentParagraphPropertySources(baseDocument);
+	if (!sourceParagraphs) panic("A paragraph-property source contract lost its source registry");
+	const currentTokens = /* @__PURE__ */ new Set();
+	visitDocumentStoryParagraphs(baseDocument.package.document.content, (paragraph) => {
+		const token = getParagraphPropertySourceToken(paragraph);
+		if (!token) {
+			if (paragraphPropertySourceBelongsToDocument(paragraph, baseDocument)) throw sourceValidationError("invalid_token", "A source-bound paragraph is missing its paragraph-property token.");
+			return;
+		}
+		if (!paragraphPropertySourceTokenMatchesContract(token, contract)) throw sourceValidationError("invalid_token", "The source document contains an invalid paragraph-property token.");
+		if (!sourceParagraphs.has(token)) throw sourceValidationError("unknown_token", "The source document contains an unknown paragraph-property token.");
+		if (currentTokens.has(token)) throw sourceValidationError("duplicate_token", "The source document contains a duplicate paragraph-property token.");
+		currentTokens.add(token);
+	});
+	const seen = /* @__PURE__ */ new Set();
+	const validateToken = (token) => {
+		if (token === null || token === void 0) return;
+		if (!isParagraphPropertySourceToken(token)) throw sourceValidationError("invalid_token", "A paragraph contains a malformed paragraph-property token.");
+		if (!paragraphPropertySourceTokenMatchesContract(token, contract)) throw sourceValidationError("unknown_token", "A paragraph-property token belongs to a different source document.");
+		if (seen.has(token)) throw sourceValidationError("duplicate_token", "A paragraph-property token is attached to more than one paragraph.");
+		if (!sourceParagraphs.has(token)) throw sourceValidationError("unknown_token", "A paragraph-property token is not present in the source document.");
+		seen.add(token);
+	};
+	const validateTableCellBinding = (binding) => {
+		switch (binding.type) {
+			case "authored": return;
+			case "source":
+				validateToken(binding.token);
+				return;
+			default: return binding;
+		}
+	};
+	pmDoc.descendants((node) => {
+		if (node.type.name === "tableCell" || node.type.name === "tableHeader") {
+			const continuationCells = expectTableCellAttrs(node)._docxVMergeContinuationCells;
+			if (continuationCells !== void 0 && continuationCells !== null) visitTableCellParagraphPropertySourceBindings(decodeTableCellParagraphSourcePayload(continuationCells), (binding) => validateTableCellBinding(binding));
+			return true;
+		}
+		if (node.type.name !== "paragraph") return true;
+		validateToken(getProseParagraphPropertySourceToken(node));
+		return false;
+	});
+	return sourceParagraphs;
+};
+const restoreParagraphPropertySourcesByToken = (content, baseParagraphs) => {
+	visitDocumentStoryParagraphs(content, (paragraph) => {
+		const token = getParagraphPropertySourceToken(paragraph);
+		if (!token) return;
+		const baseParagraph = baseParagraphs.get(token);
+		if (!baseParagraph) panic("Validated paragraph-property token lost its source owner");
+		restoreParagraphPropertySource(paragraph, baseParagraph);
+	});
+};
 const restoreLinkedParagraphPropertySources = (content) => {
 	const targetsBySource = /* @__PURE__ */ new Map();
 	const linkedTargets = /* @__PURE__ */ new Set();
@@ -133,7 +194,7 @@ const restoreLinkedParagraphPropertySources = (content) => {
 	});
 	for (const [source, targets] of targetsBySource) if (targets.length === 1) {
 		const target = targets.at(0);
-		if (target) copyParagraphPropertySource(target, source);
+		if (target) copyParagraphPropertyCapture(target, source);
 	}
 	return {
 		targets: linkedTargets,
@@ -143,20 +204,30 @@ const restoreLinkedParagraphPropertySources = (content) => {
 /** Convert a ProseMirror document to the document model. */
 function fromProseDoc(pmDoc, baseDocument) {
 	assertValidProseMirrorDocument(pmDoc, "Cannot convert invalid ProseMirror document to DOCX model");
+	const baseContract = baseDocument ? getDocumentParagraphPropertySourceContract(baseDocument) : void 0;
+	const proseContractAttribute = pmDoc.attrs[PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR];
+	const proseContract = getProseDocumentParagraphPropertySourceContract(pmDoc);
+	if (proseContractAttribute !== null && proseContractAttribute !== void 0 && proseContract === null || (baseContract ?? null) !== proseContract) throw sourceValidationError("contract_mismatch", "The ProseMirror document does not match its paragraph-property source document.");
+	const tokenSources = baseContract && proseContract && baseDocument ? validateParagraphPropertySourceTokens(pmDoc, baseDocument, baseContract) : null;
 	const blocks = extractBlocks(pmDoc, "resolve", baseDocument?.package.styles ? createStyleEngine(baseDocument.package.styles) : null);
 	const linkedSources = restoreLinkedParagraphPropertySources(blocks);
-	if (baseDocument) restoreParagraphPropertySources(blocks, baseDocument.package.document.content, linkedSources.targets, linkedSources.sources);
+	if (tokenSources) restoreParagraphPropertySourcesByToken(blocks, tokenSources);
+	else if (baseDocument) restoreParagraphPropertySources(blocks, baseDocument.package.document.content, linkedSources.targets, linkedSources.sources);
 	const documentBody = { content: blocks };
 	if (baseDocument?.package.document.finalSectionProperties) documentBody.finalSectionProperties = baseDocument.package.document.finalSectionProperties;
 	if (baseDocument?.package.document.sections) documentBody.sections = baseDocument.package.document.sections;
 	if (baseDocument?.package.document.comments) documentBody.comments = baseDocument.package.document.comments;
-	if (baseDocument) return {
-		...baseDocument,
-		package: {
-			...baseDocument.package,
-			document: documentBody
-		}
-	};
+	if (baseDocument) {
+		const updatedDocument = {
+			...baseDocument,
+			package: {
+				...baseDocument.package,
+				document: documentBody
+			}
+		};
+		copyDocumentParagraphPropertySourceContract(updatedDocument, baseDocument);
+		return updatedDocument;
+	}
 	return { package: { document: documentBody } };
 }
 const isSuggestedMark = (mark) => mark.attrs["provenance"] === "suggested";
@@ -2606,7 +2677,7 @@ function convertPMTableRow(node, documentCounts, activeVerticalMerges, styleReso
 			const colspan = Math.max(cellAttrs.colspan, 1);
 			cells.push(convertPMTableCell(cellNode, documentCounts, styleResolver));
 			if (cellAttrs.rowspan > 1) {
-				const continuationCells = cellAttrs._docxVMergeContinuationCells;
+				const continuationCells = cellAttrs._docxVMergeContinuationCells !== void 0 && cellAttrs._docxVMergeContinuationCells !== null ? restoreTableCellsWithParagraphPropertySources(decodeTableCellParagraphSourcePayload(cellAttrs._docxVMergeContinuationCells)) : void 0;
 				activeVerticalMerges?.set(gridColumn, {
 					remainingRows: cellAttrs.rowspan - 1,
 					colspan,
@@ -2791,6 +2862,24 @@ function tableCellAttrsToFormatting(attrs) {
 	if (attrs.margins) f.margins = buildCellMarginsFromAttrs(attrs.margins);
 	return f;
 }
+const isUnchangedSourceEmptyPlaceholder = (blocks) => {
+	const paragraph = blocks.at(0);
+	if (blocks.length !== 1 || paragraph?.type !== "paragraph" || paragraph.content.length !== 0) return false;
+	return Object.keys(paragraph).every((key) => key === "type" || key === "content" || key === "paraId" || key === "textId");
+};
+const projectTextBoxBodyContent = (state, blocks) => {
+	switch (state.type) {
+		case "source-empty": return isUnchangedSourceEmptyPlaceholder(blocks) ? { type: "source-empty" } : {
+			type: "authored",
+			content: blocks
+		};
+		case "authored": return {
+			type: "authored",
+			content: blocks
+		};
+		default: return state;
+	}
+};
 /**
 * Convert a ProseMirror textBox node back to a Paragraph wrapping a ShapeContent run.
 * The text box content becomes a Shape with textBody.
@@ -2803,6 +2892,7 @@ function convertPMTextBox(node, styleResolver = null) {
 		if (child.type.name === "paragraph") childBlocks.push(convertPMParagraph(child, void 0, void 0, styleResolver));
 		else if (child.type.name === "table") childBlocks.push(convertPMTable(child, void 0, styleResolver));
 	});
+	const textBodyContent = projectTextBoxBodyContent(attrs._docxTextBodyContentState, childBlocks);
 	const shape = {
 		type: "shape",
 		shapeType: "textBox",
@@ -2811,10 +2901,7 @@ function convertPMTextBox(node, styleResolver = null) {
 			height: attrs.height ? pixelsToEmu(attrs.height) : 0
 		},
 		textBody: {
-			content: childBlocks.length > 0 ? childBlocks : [{
-				type: "paragraph",
-				content: []
-			}],
+			content: textBodyContent.type === "source-empty" ? [] : textBodyContent.content,
 			...attrs.autoFit !== void 0 ? { autoFit: attrs.autoFit } : {},
 			...attrs.textWrap !== void 0 ? { textWrap: attrs.textWrap } : {},
 			...verticalAlign !== void 0 ? { anchor: verticalAlign } : {},
@@ -2829,6 +2916,8 @@ function convertPMTextBox(node, styleResolver = null) {
 		}
 	};
 	if (attrs.textBoxId) shape.id = attrs.textBoxId;
+	const transform = parseTransformAttr(attrs.transform);
+	if (transform) shape.transform = transform;
 	if (attrs.fillColor) shape.fill = {
 		type: "solid",
 		color: { rgb: attrs.fillColor.replace("#", "") }

package/dist/prosemirror/conversion/toProseDoc.js

@@ -1,5 +1,5 @@
 import { resolveColorValueToHex } from "../../docx/drawingUtils.js";
-import { linkProseParagraphPropertySource, recreateProseNodeWithParagraphPropertySource } from "../../docx/paragraphPropertySource.js";
+import { PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR, createProseParagraphWithPropertySource, getDocumentParagraphPropertySourceContract, recreateProseNodeWithParagraphPropertySource, transportTableCellsWithParagraphPropertySources } from "../../docx/paragraphPropertySource.js";
 import { buildPageBreakRunSourceDescendantIndex } from "../../internal/pageBreakRunSourceDescendantIndex.js";
 import { createStyleEngine } from "../../style-engine/styleEngine.js";
 import { normalizeHorizontalScalePercent } from "../../utils/horizontalScale.js";
@@ -131,6 +131,7 @@ function toProseDoc(document, options) {
 	const finalSectionStart = document.package.document.sections?.at(-1)?.properties.sectionStart ?? null;
 	const adjustLineHeightInTable = document.package.settings?.adjustLineHeightInTable === true;
 	const pmDoc = stampNumberedRefFieldBaselines(schema.node("doc", {
+		[PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR]: getDocumentParagraphPropertySourceContract(document) ?? null,
 		_finalSectionStart: finalSectionStart,
 		_adjustLineHeightInTable: adjustLineHeightInTable
 	}, nodes));
@@ -205,7 +206,8 @@ function convertParagraph(paragraph, styleResolver, context, activeCommentIds, e
 	let paragraphStyleRunFormatting;
 	let paragraphStyleFontFamily;
 	if (styleResolver) {
-		styleRunFormatting = styleResolver.resolveParagraphStyle(paragraph.formatting?.styleId).runFormatting;
+		const resolved = styleResolver.resolveParagraphStyle(paragraph.formatting?.styleId);
+		styleRunFormatting = extraRunFormatting === void 0 ? resolved.runFormatting : withoutFontFamily(resolved.runFormatting);
 		const paragraphStyle = paragraph.formatting?.styleId ? styleResolver.getStyle(paragraph.formatting.styleId) ?? styleResolver.getDefaultParagraphStyle() : styleResolver.getDefaultParagraphStyle();
 		paragraphStyleRunFormatting = paragraphStyle?.type === "paragraph" ? paragraphStyle.rPr : void 0;
 		paragraphStyleFontFamily = resolveParagraphStyleFontFamily(paragraph.formatting?.styleId, styleResolver);
@@ -343,18 +345,28 @@ function convertParagraph(paragraph, styleResolver, context, activeCommentIds, e
 	}
 	if (bookmarksArr) attrs.bookmarks = bookmarksArr;
 	if (emptyHyperlinks) attrs._emptyHyperlinks = emptyHyperlinks;
-	const proseParagraph = schema.node("paragraph", attrs, inlineNodes);
-	linkProseParagraphPropertySource(proseParagraph, paragraph);
-	return proseParagraph;
+	return createProseParagraphWithPropertySource(schema.nodes["paragraph"], paragraph, {
+		attrs,
+		content: inlineNodes
+	});
 }
+const withoutFontFamily = (formatting) => {
+	if (!formatting?.fontFamily) return formatting;
+	const { fontFamily: _fontFamily, ...withoutFont } = formatting;
+	return Object.keys(withoutFont).length > 0 ? withoutFont : void 0;
+};
 const resolveParagraphStyleFontFamily = (styleId, styleResolver) => {
 	let style = styleId ? styleResolver.getStyle(styleId) : styleResolver.getDefaultParagraphStyle();
 	const visited = /* @__PURE__ */ new Set();
+	const styleChain = [];
 	while (style?.type === "paragraph" && !visited.has(style.styleId)) {
 		visited.add(style.styleId);
-		if (style.rPr?.fontFamily) return style.rPr.fontFamily;
+		if (style.rPr?.fontFamily) styleChain.push({ fontFamily: style.rPr.fontFamily });
 		style = style.basedOn ? styleResolver.getStyle(style.basedOn) : void 0;
 	}
+	let formatting;
+	for (const styleFormatting of styleChain.toReversed()) formatting = mergeTextFormatting(formatting, styleFormatting);
+	return formatting?.fontFamily;
 };
 /**
 * Apply comment marks to PM nodes within a comment range.
@@ -789,7 +801,14 @@ function paragraphContentHasMeaningfulContent(content) {
 	return true;
 }
 function convertTable(table, styleResolver, context) {
-	for (const row of table.rows) for (const cell of row.cells) assertSourceContainerHasNoPageBreakRun(cell.content, "table-cell", context.pageBreakRunSourceDescendants);
+	for (const row of table.rows) for (const cell of row.cells) {
+		if (cell.formatting?.vMerge === "continue" && context.pageBreakRunSourceDescendants.containsPageBreakRun(cell.content)) throw new UnsupportedDocxToProseMirrorConversionError({
+			message: `${PAGE_BREAK_CONTAINER_DESCRIPTIONS["table-cell"]} cannot be represented in the editor model`,
+			owner: "table-cell",
+			contentType: "break"
+		});
+		assertSourceContainerHasNoPageBreakRun(cell.content, "table-cell", context.pageBreakRunSourceDescendants);
+	}
 	const rowSpanMap = calculateRowSpans(table);
 	const columnWidths = table.columnWidths;
 	const totalWidth = columnWidths?.reduce((sum, w) => sum + w, 0) ?? 0;
@@ -1077,7 +1096,7 @@ function convertTableCell({ cell, styleResolver, context, isHeader, gridWidthPer
 		...cell.structuralChange.verticalMergeOriginal !== void 0 ? { verticalMergeOriginal: cell.structuralChange.verticalMergeOriginal } : {}
 	};
 	if (preserveVMergeRestart) attrs._preserveVMergeRestart = true;
-	if (vMergeContinuationCells && vMergeContinuationCells.length > 0) attrs._docxVMergeContinuationCells = vMergeContinuationCells;
+	if (vMergeContinuationCells && vMergeContinuationCells.length > 0) attrs._docxVMergeContinuationCells = transportTableCellsWithParagraphPropertySources(vMergeContinuationCells);
 	const contentNodes = [];
 	for (const content of cell.content) if (content.type === "paragraph") contentNodes.push(...convertParagraphWithTextBoxes(content, styleResolver, {
 		textBoxGroupId: context.nextTextBoxGroupId(),
@@ -1255,12 +1274,74 @@ const PAGE_BREAK_PARAGRAPH_OWNERS = {
 };
 function assertSourceContainerHasNoPageBreakRun(content, owner, sourceDescendants) {
 	if (!sourceDescendants.containsPageBreakRun(content)) return;
+	if (owner === "table-cell" && hasSingleLeadingTableCellPageBreak(content)) return;
 	throw new UnsupportedDocxToProseMirrorConversionError({
 		message: `${PAGE_BREAK_CONTAINER_DESCRIPTIONS[owner]} cannot be represented in the editor model`,
 		owner,
 		contentType: "break"
 	});
 }
+/** A leading page-break run in a cell advances the whole row during pagination. This
+* narrow shape has a lossless PM representation and a row-wide layout
+* projection; interior breaks still require table-fragment ownership. */
+function hasSingleLeadingTableCellPageBreak(content) {
+	const paragraph = content.length === 1 && content[0]?.type === "paragraph" ? content[0] : void 0;
+	return paragraph !== void 0 && hasSingleLeadingParagraphPageBreak(paragraph);
+}
+const scanLeadingPageBreakRun = (run, scan) => {
+	for (const content of run.content) {
+		if (content.type === "renderedPageBreak") continue;
+		if (content.type === "break" && content.breakType === "page") {
+			scan.pageBreaks += 1;
+			continue;
+		}
+		if (scan.pageBreaks === 0) scan.contentBeforeBreak = true;
+	}
+};
+const scanLeadingPageBreakContent = (content, scan) => {
+	switch (content.type) {
+		case "run":
+			scanLeadingPageBreakRun(content, scan);
+			return;
+		case "hyperlink":
+			for (const child of content.children) scanLeadingPageBreakContent(child, scan);
+			return;
+		case "insertion":
+		case "deletion":
+		case "moveFrom":
+		case "moveTo":
+		case "inlineSdt":
+			for (const child of content.content) scanLeadingPageBreakContent(child, scan);
+			return;
+		case "simpleField":
+			for (const child of content.content) scanLeadingPageBreakContent(child, scan);
+			return;
+		case "complexField":
+			for (const child of content.fieldResult) scanLeadingPageBreakRun(child, scan);
+			return;
+		case "bookmarkStart":
+		case "bookmarkEnd":
+		case "commentRangeStart":
+		case "commentRangeEnd":
+		case "moveFromRangeStart":
+		case "moveFromRangeEnd":
+		case "moveToRangeStart":
+		case "moveToRangeEnd": return;
+		case "commentReference":
+		case "mathEquation":
+			if (scan.pageBreaks === 0) scan.contentBeforeBreak = true;
+			return;
+		default: return content;
+	}
+};
+const hasSingleLeadingParagraphPageBreak = (paragraph) => {
+	const scan = {
+		contentBeforeBreak: false,
+		pageBreaks: 0
+	};
+	for (const content of paragraph.content) scanLeadingPageBreakContent(content, scan);
+	return !scan.contentBeforeBreak && scan.pageBreaks === 1;
+};
 function assertParagraphPageBreakCanBeProjected({ paragraph, attrs, effectiveFrame, sourceDescendants }) {
 	const sourceFeatures = sourceDescendants.paragraphFeatures(paragraph);
 	if (!sourceFeatures.hasPageBreakRun) return;
@@ -1270,6 +1351,7 @@ function assertParagraphPageBreakCanBeProjected({ paragraph, attrs, effectiveFra
 		hasTextBoxAnchor: sourceFeatures.hasTextBoxShape && !sourceFeatures.pageBreakSharesTextBoxShape
 	});
 	if (disposition.status === "supported") return;
+	if (disposition.reason !== "textBoxAnchor" && hasSingleLeadingParagraphPageBreak(paragraph)) return;
 	throw new UnsupportedDocxToProseMirrorConversionError({
 		message: disposition.message,
 		owner: PAGE_BREAK_PARAGRAPH_OWNERS[disposition.reason],
@@ -2065,6 +2147,7 @@ function textBoxFromShape(shape, textBody) {
 	if (shape.wrap) textBox.wrap = shape.wrap;
 	if (shape.fill) textBox.fill = shape.fill;
 	if (shape.outline) textBox.outline = shape.outline;
+	if (shape.transform) textBox.transform = shape.transform;
 	if (textBody.margins) textBox.margins = textBody.margins;
 	if (textBody.autoFit) textBox.autoFit = textBody.autoFit;
 	if (textBody.textWrap) textBox.textWrap = textBody.textWrap;
@@ -2089,6 +2172,14 @@ function convertTextBox(textBox, styleResolver, options) {
 		if (textBox.outline.color?.rgb) outlineColor = `#${textBox.outline.color.rgb}`;
 		outlineStyle = textBox.outline.style || "solid";
 	}
+	let transform;
+	if (textBox.transform) {
+		const transforms = [];
+		if (textBox.transform.rotation) transforms.push(`rotate(${textBox.transform.rotation}deg)`);
+		if (textBox.transform.flipH) transforms.push("scaleX(-1)");
+		if (textBox.transform.flipV) transforms.push("scaleY(-1)");
+		if (transforms.length > 0) transform = transforms.join(" ");
+	}
 	const marginTop = textBox.margins?.top !== void 0 ? emuToPixels(textBox.margins.top) : 4;
 	const marginBottom = textBox.margins?.bottom !== void 0 ? emuToPixels(textBox.margins.bottom) : 4;
 	const marginLeft = textBox.margins?.left !== void 0 ? emuToPixels(textBox.margins.left) : 7;
@@ -2151,6 +2242,7 @@ function convertTextBox(textBox, styleResolver, options) {
 		outlineWidth,
 		outlineColor,
 		outlineStyle,
+		transform,
 		marginTop,
 		marginBottom,
 		marginLeft,
@@ -2167,6 +2259,7 @@ function convertTextBox(textBox, styleResolver, options) {
 		_docxPlacement: options.placement,
 		_docxGroupId: options.groupId,
 		_docxAnchorId: options.anchorId,
+		_docxTextBodyContentState: textBox.content.length === 0 ? { type: "source-empty" } : { type: "authored" },
 		_docxTrackedChange: options.trackedChange,
 		_docxInlineSdts: options.inlineSdts.length > 0 ? options.inlineSdts : void 0
 	}, contentNodes);

package/dist/prosemirror/extensions/core/DocExtension.js

@@ -1,3 +1,4 @@
+import { PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR } from "../../../docx/paragraphPropertySource.js";
 import { createNodeExtension } from "../create.js";
 //#region src/prosemirror/extensions/core/DocExtension.ts
 /**
@@ -8,6 +9,7 @@ const DocExtension = createNodeExtension({
 	schemaNodeName: "doc",
 	nodeSpec: {
 		attrs: {
+			[PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR]: { default: null },
 			_finalSectionStart: { default: null },
 			_adjustLineHeightInTable: { default: false }
 		},

package/dist/prosemirror/extensions/core/ParagraphExtension.js

@@ -1,3 +1,4 @@
+import { PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR } from "../../../docx/paragraphPropertySource.js";
 import { PARAGRAPH_ALIGNMENT_VALUES } from "../../../types/documentEnumValues.js";
 import { paragraphToStyle } from "../../../utils/formatToStyle.js";
 import { collectHeadings } from "../../../utils/headingCollector.js";
@@ -184,6 +185,7 @@ const paragraphNodeSpec = {
 	group: "block",
 	attrs: {
 		paraId: { default: null },
+		[PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR]: { default: null },
 		idStability: { default: void 0 },
 		textId: { default: null },
 		alignment: { default: null },

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

@@ -2,7 +2,11 @@ import { Extension } from "../types.js";
 import { EditorState, PluginKey, Transaction } from "prosemirror-state";
 import { Node } from "prosemirror-model";
 //#region src/prosemirror/extensions/features/ParaIdAllocatorExtension.d.ts
-declare const paraIdAllocatorKey: PluginKey<any>;
+type ParagraphPropertySourceSeed = {
+  contract: string | null;
+  tokens: ReadonlySet<string>;
+};
+declare const paraIdAllocatorKey: PluginKey<ParagraphPropertySourceSeed>;
 /**
  * Transaction meta asking this plugin to derive the ids it mints from a
  * caller-supplied seed instead of `Math.random()`.