@stll/folio-core 0.37.1 → 0.37.3

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,

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()`.

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

@@ -1,7 +1,8 @@
-import { recreateProseNodeWithParagraphPropertySource, setProseParagraphMarkupWithPropertySource, transferProseParagraphPropertySource } from "../../../docx/paragraphPropertySource.js";
+import { PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR, getExplicitParagraphPropertySourceTransfers, getProseDocumentParagraphPropertySourceContract, getProseParagraphPropertySourceToken, paragraphPropertySourceTokenMatchesContract, recreateProseNodeWithParagraphPropertySource, setProseParagraphMarkupWithPropertySource, transferProseParagraphPropertySource } from "../../../docx/paragraphPropertySource.js";
 import { deterministicHexId, generateHexId } from "../../../utils/hexId.js";
 import { createExtension } from "../create.js";
 import { ignoreTrackedChanges } from "./ParagraphChangeTrackerExtension.js";
+import { panic } from "better-result";
 import { Fragment } from "prosemirror-model";
 import { Plugin, PluginKey } from "prosemirror-state";
 //#region src/prosemirror/extensions/features/ParaIdAllocatorExtension.ts
@@ -73,61 +74,100 @@ const mintParaId = (taken, seed, pos) => {
 	return id;
 };
 const isUsableParaId = (value) => typeof value === "string" && value.length > 0 && value !== "00000000";
-/**
-* For every valid paraId in the pre-transaction doc, the position its
-* paragraph ends up at after `transactions` — the occurrence that
-* rightfully keeps the id when the new doc holds duplicates. Ids whose
-* paragraph start was deleted by the steps are left out.
-*/
-const mapKeeperPositions = (oldDoc, transactions) => {
-	const keepers = /* @__PURE__ */ new Map();
+const collectParagraphPropertySourceSeed = (doc) => {
+	const contract = getProseDocumentParagraphPropertySourceContract(doc);
+	if (!contract) return {
+		contract: null,
+		tokens: /* @__PURE__ */ new Set()
+	};
+	const counts = /* @__PURE__ */ new Map();
+	doc.descendants((node) => {
+		if (node.type.name !== "paragraph") return true;
+		const token = getProseParagraphPropertySourceToken(node);
+		if (paragraphPropertySourceTokenMatchesContract(token, contract)) counts.set(token, (counts.get(token) ?? 0) + 1);
+		return false;
+	});
+	return {
+		contract,
+		tokens: new Set([...counts].filter(([, count]) => count === 1).map(([token]) => token))
+	};
+};
+const mapParagraphKeepers = (oldDoc, transactions, sourceSeed) => {
+	const paraIds = /* @__PURE__ */ new Map();
+	const sourceTokens = /* @__PURE__ */ new Map();
 	oldDoc.descendants((node, pos) => {
 		if (node.type.name !== "paragraph") return true;
 		const id = node.attrs["paraId"];
-		if (!isUsableParaId(id) || keepers.has(id)) return false;
+		const token = getProseParagraphPropertySourceToken(node);
+		const mapsParaId = isUsableParaId(id) && !paraIds.has(id);
+		const mapsSourceToken = typeof token === "string" && sourceSeed.tokens.has(token);
+		if (!mapsParaId && !mapsSourceToken) return false;
 		let mapped = pos;
+		let mappedInterior = pos + 1;
 		let deleted = false;
-		for (const tr of transactions) {
-			const result = tr.mapping.mapResult(mapped);
-			if (result.deleted) {
-				deleted = true;
-				break;
-			}
-			mapped = result.pos;
+		for (const transaction of transactions) {
+			const ownerResult = transaction.mapping.mapResult(mapped);
+			const interiorResult = transaction.mapping.mapResult(mappedInterior, -1);
+			deleted ||= interiorResult.deletedAcross;
+			mapped = ownerResult.pos;
+			mappedInterior = interiorResult.pos;
 		}
-		if (!deleted) keepers.set(id, mapped);
+		if (mapsParaId && !deleted) paraIds.set(id, mapped);
+		if (mapsSourceToken) sourceTokens.set(token, sourceTokens.has(token) ? { status: "ambiguous" } : {
+			pos: mapped,
+			status: deleted ? "deleted" : "mapped"
+		});
 		return false;
 	});
-	return keepers;
+	return {
+		paraIds,
+		sourceTokens
+	};
 };
-const collectParaIdUpdates = (doc, keeperPositions, deterministicSeed = null) => {
-	const missing = [];
-	const occurrencesById = /* @__PURE__ */ new Map();
+const collectParagraphCensus = (doc, sourceSeed) => {
+	const census = {
+		invalidSourceTokens: [],
+		missingParaIds: [],
+		paragraphs: /* @__PURE__ */ new Map(),
+		paraIds: /* @__PURE__ */ new Map(),
+		sourceTokens: /* @__PURE__ */ new Map()
+	};
+	const contractMatchesSeed = sourceSeed?.contract !== null && sourceSeed?.contract !== void 0 && getProseDocumentParagraphPropertySourceContract(doc) === sourceSeed.contract;
 	doc.descendants((node, pos) => {
 		if (node.type.name !== "paragraph") return true;
-		const id = node.attrs["paraId"];
-		if (!isUsableParaId(id)) missing.push({
+		const occurrence = {
 			pos,
 			attrs: node.attrs
-		});
-		else {
-			const occurrences = occurrencesById.get(id) ?? [];
-			occurrences.push({
-				pos,
-				attrs: node.attrs
-			});
-			occurrencesById.set(id, occurrences);
+		};
+		census.paragraphs.set(pos, occurrence);
+		const id = node.attrs["paraId"];
+		if (isUsableParaId(id)) {
+			const occurrences = census.paraIds.get(id) ?? [];
+			occurrences.push(occurrence);
+			census.paraIds.set(id, occurrences);
+		} else census.missingParaIds.push(occurrence);
+		if (sourceSeed) {
+			const token = getProseParagraphPropertySourceToken(node);
+			if (token !== null && token !== void 0) if (typeof token !== "string" || !contractMatchesSeed || !sourceSeed.contract || !sourceSeed.tokens.has(token) || !paragraphPropertySourceTokenMatchesContract(token, sourceSeed.contract)) census.invalidSourceTokens.push(occurrence);
+			else {
+				const occurrences = census.sourceTokens.get(token) ?? [];
+				occurrences.push(occurrence);
+				census.sourceTokens.set(token, occurrences);
+			}
 		}
 		return false;
 	});
-	const needFreshId = [...missing];
-	for (const [id, occurrences] of occurrencesById) {
+	return census;
+};
+const collectParaIdUpdatesFromCensus = (census, keeperPositions, deterministicSeed = null) => {
+	const needFreshId = [...census.missingParaIds];
+	for (const [id, occurrences] of census.paraIds) {
 		if (occurrences.length === 1) continue;
 		const keeperPos = keeperPositions?.get(id);
-		const keeper = occurrences.find((occurrence) => occurrence.pos === keeperPos) ?? occurrences[0];
+		const keeper = occurrences.find(({ pos }) => pos === keeperPos) ?? occurrences[0];
 		for (const occurrence of occurrences) if (occurrence !== keeper) needFreshId.push(occurrence);
 	}
-	const taken = new Set(occurrencesById.keys());
+	const taken = new Set(census.paraIds.keys());
 	const updates = [];
 	for (const { pos, attrs } of needFreshId) {
 		const newId = mintParaId(taken, deterministicSeed, pos);
@@ -140,9 +180,39 @@ const collectParaIdUpdates = (doc, keeperPositions, deterministicSeed = null) =>
 			}
 		});
 	}
-	updates.sort((a, b) => a.pos - b.pos);
+	updates.sort((left, right) => left.pos - right.pos);
 	return updates;
 };
+const collectParaIdUpdates = (doc) => collectParaIdUpdatesFromCensus(collectParagraphCensus(doc));
+const collectParagraphPropertySourceUpdates = (census, keeperPositions, transactions) => {
+	const updates = /* @__PURE__ */ new Map();
+	for (const { pos } of census.invalidSourceTokens) updates.set(pos, null);
+	const explicitTransfers = transactions.flatMap((transaction) => [...getExplicitParagraphPropertySourceTransfers(transaction)]);
+	const explicitlySelected = new Set(explicitTransfers.map(({ selectedToken }) => selectedToken).filter((token) => token !== null));
+	const explicitlyDisplaced = new Set(explicitTransfers.map(({ displacedToken }) => displacedToken).filter((token) => token !== null));
+	const keptPositions = /* @__PURE__ */ new Set();
+	const keptTokens = /* @__PURE__ */ new Set();
+	for (const [token, occurrences] of census.sourceTokens) {
+		const mappedOwner = keeperPositions.get(token);
+		const mappedKeeper = mappedOwner?.status === "mapped" ? occurrences.find(({ pos }) => pos === mappedOwner.pos) : void 0;
+		const transferredKeeper = !mappedKeeper && explicitlySelected.has(token) && occurrences.length === 1 ? occurrences.at(0) : void 0;
+		const detachedKeeper = !mappedKeeper && !transferredKeeper && occurrences.length === 1 && (mappedOwner === void 0 || mappedOwner.status === "deleted" && mappedOwner.pos === occurrences.at(0)?.pos) ? occurrences.at(0) : void 0;
+		const keeper = mappedKeeper ?? transferredKeeper ?? detachedKeeper;
+		if (keeper) {
+			keptPositions.add(keeper.pos);
+			keptTokens.add(token);
+		}
+		for (const occurrence of occurrences) if (occurrence !== keeper) updates.set(occurrence.pos, null);
+	}
+	for (const [token, mappedOwner] of keeperPositions) {
+		if (mappedOwner.status !== "mapped" || keptTokens.has(token) || explicitlyDisplaced.has(token) || keptPositions.has(mappedOwner.pos) || !census.paragraphs.has(mappedOwner.pos)) continue;
+		updates.set(mappedOwner.pos, token);
+	}
+	return [...updates].map(([pos, token]) => ({
+		pos,
+		token
+	})).sort((left, right) => left.pos - right.pos);
+};
 const collectInitialParaIds = (doc) => {
 	let needsRewrite = false;
 	const taken = /* @__PURE__ */ new Set();
@@ -215,12 +285,20 @@ const ensureParaIdsInState = (state) => {
 };
 const createParaIdAllocatorPlugin = () => new Plugin({
 	key: paraIdAllocatorKey,
+	state: {
+		init: (_config, state) => collectParagraphPropertySourceSeed(state.doc),
+		apply: (_transaction, seed) => seed
+	},
 	appendTransaction(transactions, oldState, newState) {
 		if (!transactions.some((t) => t.docChanged)) return null;
-		const keeperPositions = mapKeeperPositions(oldState.doc, transactions);
-		const seed = transactions.map((transaction) => transaction.getMeta(deterministicParaIdSeedKey)).find((value) => typeof value === "string") ?? null;
-		const updates = collectParaIdUpdates(newState.doc, keeperPositions, seed);
-		if (updates.length === 0) return null;
+		const paragraphSourceSeed = paraIdAllocatorKey.getState(oldState);
+		if (!paragraphSourceSeed) panic("ParaId allocator lost its paragraph-property source seed");
+		const keeperPositions = mapParagraphKeepers(oldState.doc, transactions, paragraphSourceSeed);
+		const deterministicSeed = transactions.map((transaction) => transaction.getMeta(deterministicParaIdSeedKey)).find((value) => typeof value === "string") ?? null;
+		const census = collectParagraphCensus(newState.doc, paragraphSourceSeed);
+		const updates = collectParaIdUpdatesFromCensus(census, keeperPositions.paraIds, deterministicSeed);
+		const paragraphSourceUpdates = collectParagraphPropertySourceUpdates(census, keeperPositions.sourceTokens, transactions);
+		if (updates.length === 0 && paragraphSourceUpdates.length === 0) return null;
 		const tr = newState.tr;
 		for (const u of updates) setProseParagraphMarkupWithPropertySource({
 			attrs: u.attrs,
@@ -228,6 +306,19 @@ const createParaIdAllocatorPlugin = () => new Plugin({
 			pos: u.pos,
 			transaction: tr
 		});
+		for (const { pos, token } of paragraphSourceUpdates) {
+			const paragraph = tr.doc.nodeAt(pos);
+			if (!paragraph || paragraph.type.name !== "paragraph") panic("Paragraph-property token update lost its paragraph");
+			setProseParagraphMarkupWithPropertySource({
+				attrs: {
+					...paragraph.attrs,
+					[PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR]: token
+				},
+				ownership: "preserve",
+				pos,
+				transaction: tr
+			});
+		}
 		ignoreTrackedChanges(tr);
 		tr.setMeta(paraIdAllocatorKey, "allocated");
 		tr.setMeta("addToHistory", false);

package/dist/prosemirror/extensions/nodes/TextBoxExtension.d.ts

@@ -22,6 +22,8 @@ type TextBoxAttrs = {
   outlineColor?: string;
   /** Outline dash style, or `"none"` for an explicit no-outline. */
   outlineStyle?: OutlineStyleAttr;
+  /** DrawingML rotation and/or flips, serialized as CSS transform functions. */
+  transform?: string;
   /** Internal margin top in pixels */
   marginTop?: number;
   /** Internal margin bottom in pixels */

package/dist/prosemirror/extensions/nodes/TextBoxExtension.js

@@ -42,6 +42,7 @@ const TextBoxExtension = createNodeExtension({
 			outlineWidth: { default: null },
 			outlineColor: { default: null },
 			outlineStyle: { default: null },
+			transform: { default: null },
 			marginTop: { default: 4 },
 			marginBottom: { default: 4 },
 			marginLeft: { default: 7 },
@@ -82,6 +83,7 @@ const TextBoxExtension = createNodeExtension({
 					...d["outlineWidth"] ? { outlineWidth: Number(d["outlineWidth"]) } : {},
 					...d["outlineColor"] ? { outlineColor: d["outlineColor"] } : {},
 					...d["outlineStyle"] ? { outlineStyle: d["outlineStyle"] } : {},
+					...d["transform"] ? { transform: d["transform"] } : {},
 					...d["marginTop"] ? { marginTop: Number(d["marginTop"]) } : {},
 					...d["marginBottom"] ? { marginBottom: Number(d["marginBottom"]) } : {},
 					...d["marginLeft"] ? { marginLeft: Number(d["marginLeft"]) } : {},
@@ -111,6 +113,7 @@ const TextBoxExtension = createNodeExtension({
 			if (attrs.outlineWidth) domAttrs["data-outline-width"] = String(attrs.outlineWidth);
 			if (attrs.outlineColor) domAttrs["data-outline-color"] = attrs.outlineColor;
 			if (attrs.outlineStyle) domAttrs["data-outline-style"] = attrs.outlineStyle;
+			if (attrs.transform) domAttrs["data-transform"] = attrs.transform;
 			if (typeof attrs.marginTop === "number") domAttrs["data-margin-top"] = String(attrs.marginTop);
 			if (typeof attrs.marginBottom === "number") domAttrs["data-margin-bottom"] = String(attrs.marginBottom);
 			if (typeof attrs.marginLeft === "number") domAttrs["data-margin-left"] = String(attrs.marginLeft);
@@ -158,6 +161,10 @@ const TextBoxExtension = createNodeExtension({
 			styles.push("box-sizing: border-box");
 			styles.push("overflow: hidden");
 			styles.push("position: relative");
+			if (attrs.transform) {
+				styles.push(`transform: ${attrs.transform}`);
+				styles.push("transform-origin: center center");
+			}
 			domAttrs["style"] = styles.join("; ");
 			return [
 				"div",

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

@@ -507,6 +507,8 @@ type TextBoxAttrs = {
   outlineColor?: string;
   /** Outline dash style, or `"none"` for an explicit no-outline. */
   outlineStyle?: OutlineStyleAttr;
+  /** DrawingML rotation and/or flips, serialized as CSS transform functions. */
+  transform?: string;
   /** Internal margin top in pixels */
   marginTop?: number;
   /** Internal margin bottom in pixels */
@@ -765,7 +767,7 @@ type TableCellAttrs = {
   /** Preserve a DOCX vMerge restart even when PM cannot model it as a rowspan. */
   _preserveVMergeRestart?: boolean;
   /** Original DOCX vMerge continuation cells skipped into this PM rowspan. */
-  _docxVMergeContinuationCells?: document_d_exports.TableCell[];
+  _docxVMergeContinuationCells?: unknown;
 };
 //#endregion
 export { BlockSdtAttrs, BookmarkBoundaryAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, PageBreakRunAttrs, ParagraphAttrs, ParagraphPropertyChangeAttrs, SdtAttrs, ShapeAttrs, SuggestedStructuralMarker, SymbolAttrs, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAnchorAttrs, TextBoxAttrs };

package/dist/prosemirror/yjsParagraphSourceContract.d.ts

@@ -0,0 +1,9 @@
+import { Node } from "prosemirror-model";
+import * as Y from "yjs";
+//#region src/prosemirror/yjsParagraphSourceContract.d.ts
+declare const proseDocumentParagraphSourceContract: (document: Node) => string | null;
+declare const writeYjsParagraphSourceContract: (ydoc: Y.Doc, document: Node) => void;
+declare const readYjsParagraphSourceContract: (ydoc: Y.Doc) => string | null;
+declare const withParagraphSourceContract: (document: Node, contract: string) => Node;
+//#endregion
+export { proseDocumentParagraphSourceContract, readYjsParagraphSourceContract, withParagraphSourceContract, writeYjsParagraphSourceContract };

package/dist/prosemirror/yjsParagraphSourceContract.js

@@ -0,0 +1,26 @@
+import { PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR, getProseDocumentParagraphPropertySourceContract } from "../docx/paragraphPropertySource.js";
+import { panic } from "better-result";
+//#region src/prosemirror/yjsParagraphSourceContract.ts
+const FOLIO_YJS_METADATA_MAP_NAME = "folio:document-metadata";
+const PARAGRAPH_SOURCE_CONTRACT_KEY = "paragraphSourceContract";
+const proseDocumentParagraphSourceContract = (document) => {
+	return getProseDocumentParagraphPropertySourceContract(document);
+};
+const writeYjsParagraphSourceContract = (ydoc, document) => {
+	const contract = proseDocumentParagraphSourceContract(document);
+	if (!contract) panic("Cannot seed collaboration without a paragraph-property source contract");
+	ydoc.getMap(FOLIO_YJS_METADATA_MAP_NAME).set(PARAGRAPH_SOURCE_CONTRACT_KEY, contract);
+};
+const readYjsParagraphSourceContract = (ydoc) => {
+	const contract = ydoc.getMap(FOLIO_YJS_METADATA_MAP_NAME).get(PARAGRAPH_SOURCE_CONTRACT_KEY);
+	return typeof contract === "string" ? contract : null;
+};
+const withParagraphSourceContract = (document, contract) => {
+	if (document.type.name !== "doc") panic("A paragraph-property source contract can only attach to a document node");
+	return document.type.create({
+		...document.attrs,
+		[PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR]: contract
+	}, document.content, document.marks);
+};
+//#endregion
+export { proseDocumentParagraphSourceContract, readYjsParagraphSourceContract, withParagraphSourceContract, writeYjsParagraphSourceContract };

package/dist/utils/rotationBoundingBox.d.ts

@@ -5,7 +5,11 @@ type BoundingBox = {
   height: number;
 };
 declare function parseRotationDegrees(transform: string | undefined): number;
+/** Whether a DrawingML/CSS transform reflects around the vertical centre line. */
+declare function hasHorizontalFlip(transform: string | undefined): boolean;
+/** Whether a DrawingML/CSS transform reflects around the horizontal centre line. */
+declare function hasVerticalFlip(transform: string | undefined): boolean;
 declare function rotatedBoundingBox(w: number, h: number, deg: number): BoundingBox;
 declare function inlineImageBoundingBox(run: ImageRun): BoundingBox;
 //#endregion
-export { BoundingBox, inlineImageBoundingBox, parseRotationDegrees, rotatedBoundingBox };
+export { BoundingBox, hasHorizontalFlip, hasVerticalFlip, inlineImageBoundingBox, parseRotationDegrees, rotatedBoundingBox };

package/dist/utils/rotationBoundingBox.js

@@ -7,6 +7,14 @@ function parseRotationDegrees(transform) {
 	if (!Number.isFinite(raw)) return 0;
 	return (raw % 360 + 360) % 360;
 }
+/** Whether a DrawingML/CSS transform reflects around the vertical centre line. */
+function hasHorizontalFlip(transform) {
+	return /scaleX\(\s*-1\s*\)/iu.test(transform ?? "");
+}
+/** Whether a DrawingML/CSS transform reflects around the horizontal centre line. */
+function hasVerticalFlip(transform) {
+	return /scaleY\(\s*-1\s*\)/iu.test(transform ?? "");
+}
 function rotatedBoundingBox(w, h, deg) {
 	if (deg === 0 || deg === 180) return {
 		width: w,
@@ -33,4 +41,4 @@ function inlineImageBoundingBox(run) {
 	return rotatedBoundingBox(run.width, run.height, rotation);
 }
 //#endregion
-export { inlineImageBoundingBox, parseRotationDegrees, rotatedBoundingBox };
+export { hasHorizontalFlip, hasVerticalFlip, inlineImageBoundingBox, parseRotationDegrees, rotatedBoundingBox };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.37.1",
+  "version": "0.37.3",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",
@@ -121,7 +121,7 @@
     "perf": "bun scripts/profile-editor.ts"
   },
   "dependencies": {
-    "@stll/docx-core": "^0.19.3",
+    "@stll/docx-core": "^0.19.4",
     "@stll/docx-utils": "^0.1.0",
     "@stll/template-conditions": ">=0.4.0 <1.0.0",
     "better-result": "3.0.1",