@stll/folio-core 0.37.1 → 0.37.3

package/dist/ai-edits/table-cell-mutations.js

@@ -1,3 +1,4 @@
+import { decodeTableCellParagraphSourcePayload, restoreTableCellsWithParagraphPropertySources, transportTableCellsWithParagraphPropertySources } from "../docx/paragraphPropertySource.js";
 import { expectTableCellAttrs } from "../prosemirror/attrs/index.js";
 import { standaloneTableCellFromProseMirror } from "../prosemirror/conversion/fromProseDoc.js";
 import { standaloneTableCellToProseMirror } from "../prosemirror/conversion/toProseDoc.js";
@@ -105,7 +106,7 @@ const mergeTrackedVerticalTableCells = ({ tr, tablePosition, table, rectangle, r
 			bottom: row + 1
 		})) return null;
 		const attrs = expectTableCellAttrs(cell);
-		if (attrs.colspan !== 1 || attrs.rowspan !== 1 || attrs.cellMarker !== void 0 || attrs._docxVMergeContinuationCells !== void 0 || attrs._preserveVMergeRestart === true || attrs._originalFormatting?.vMerge !== void 0) return null;
+		if (attrs.colspan !== 1 || attrs.rowspan !== 1 || attrs.cellMarker !== void 0 || attrs._docxVMergeContinuationCells !== void 0 && attrs._docxVMergeContinuationCells !== null || attrs._preserveVMergeRestart === true || attrs._originalFormatting?.vMerge !== void 0) return null;
 		cells.push({
 			position,
 			cell
@@ -139,7 +140,7 @@ const mergeTrackedVerticalTableCells = ({ tr, tablePosition, table, rectangle, r
 		rectangle
 	});
 	if (!nextTr) return null;
-	nextTr.setNodeAttribute(tablePosition + 1 + origin.position, "_docxVMergeContinuationCells", continuationCells);
+	nextTr.setNodeAttribute(tablePosition + 1 + origin.position, "_docxVMergeContinuationCells", transportTableCellsWithParagraphPropertySources(continuationCells));
 	markStructuralChange(nextTr);
 	return nextTr;
 };
@@ -196,8 +197,10 @@ const splitTrackedVerticalTableCell = ({ tr, tablePosition, table, rectangle, re
 	if (!cell) return null;
 	const attrs = expectTableCellAttrs(cell);
 	if (attrs.colspan !== 1 || attrs.rowspan !== rectangle.bottom - rectangle.top || attrs.cellMarker !== void 0) return null;
-	const continuationCells = attrs._docxVMergeContinuationCells;
+	const continuationPayload = attrs._docxVMergeContinuationCells === void 0 || attrs._docxVMergeContinuationCells === null ? null : decodeTableCellParagraphSourcePayload(attrs._docxVMergeContinuationCells);
+	const continuationCells = continuationPayload?.cells;
 	if (continuationCells !== void 0 && continuationCells.length !== rectangle.bottom - rectangle.top - 1) return null;
+	const restoredContinuationCells = continuationPayload ? restoreTableCellsWithParagraphPropertySources(continuationPayload) : void 0;
 	const marker = {
 		kind: "merge",
 		info: {
@@ -211,9 +214,11 @@ const splitTrackedVerticalTableCell = ({ tr, tablePosition, table, rectangle, re
 	for (let index = 0; index < rectangle.bottom - rectangle.top - 1; index++) {
 		const source = continuationCells?.[index];
 		if (source?.structuralChange !== void 0) return null;
-		const insertedCell = source ? trackedSplitCellFromStoredSource({
+		const restoredSource = restoredContinuationCells?.[index];
+		if (source && !restoredSource) return null;
+		const insertedCell = restoredSource ? trackedSplitCellFromStoredSource({
 			origin: cell,
-			source,
+			source: restoredSource,
 			marker
 		}) : cell.type.createAndFill({
 			...cell.attrs,

package/dist/ai-edits/table-template.js

@@ -1,3 +1,5 @@
+import { cloneTableCellsWithParagraphPropertyCaptures, decodeTableCellParagraphSourcePayload, recreateProseNodeWithDetachedParagraphPropertySource } from "../docx/paragraphPropertySource.js";
+import { expectTableCellAttrs } from "../prosemirror/attrs/index.js";
 import { stripBlockIdentityAttrs } from "./block-identity.js";
 import { Fragment } from "prosemirror-model";
 //#region src/ai-edits/table-template.ts
@@ -137,10 +139,18 @@ const copiedAttrs = (node, context) => {
 			trIns: context.revision
 		} : attrs;
 		case "cell":
-		case "header_cell": return context.clampRowSpan ? {
-			...attrs,
-			rowspan: 1
-		} : attrs;
+		case "header_cell": {
+			if (context.clampRowSpan) return {
+				...attrs,
+				rowspan: 1,
+				_docxVMergeContinuationCells: null
+			};
+			const continuationCells = expectTableCellAttrs(node)._docxVMergeContinuationCells;
+			return continuationCells !== void 0 && continuationCells !== null ? {
+				...attrs,
+				_docxVMergeContinuationCells: cloneTableCellsWithParagraphPropertyCaptures(decodeTableCellParagraphSourcePayload(continuationCells))
+			} : attrs;
+		}
 		default: return attrs;
 	}
 };
@@ -162,7 +172,11 @@ const copyNode = (node, context) => {
 		const copied = copyNode(child, inner);
 		if (copied) content.push(copied);
 	});
-	return node.type.create(copiedAttrs(node, context), Fragment.fromArray(content), marks);
+	return recreateProseNodeWithDetachedParagraphPropertySource(node, {
+		attrs: copiedAttrs(node, context),
+		content: Fragment.fromArray(content),
+		marks
+	});
 };
 /**
 * The template table, ready to insert: its properties, grid, rows and cells

package/dist/compare/compare.d.ts

@@ -31,7 +31,6 @@ type ParsedComparison = {
   baseBuffer: ArrayBuffer;
   baseCarriedRevisions: boolean;
   reviewer: FolioDocxReviewer;
-  targetReviewer: FolioDocxReviewer;
   revisionStamp: FolioRevisionStamp;
   packageDate: Date;
   pairs: readonly ComparedStoryPair[];
@@ -50,7 +49,7 @@ type PlannedStoryComparison = {
  * Stage 2: align every paired story and derive its operations. Pure — no
  * parsing, no serialization, no clock.
  */
-declare const planComparison: ({ pairs, targetReviewer }: ParsedComparison) => Result<readonly PlannedStoryComparison[], CompareDocxOperationLimitError>;
+declare const planComparison: ({ pairs }: ParsedComparison) => Result<readonly PlannedStoryComparison[], CompareDocxOperationLimitError>;
 declare const getCompareSkipDisposition: (reason: FolioAIEditSkipReason) => "fatal" | "unwritable";
 /** What stage 3 produced: the change list, whether it was proven, and whether it wrote anything. */
 type AppliedComparison = {
@@ -77,7 +76,7 @@ type AppliedComparison = {
  * what you could not represent" and "give me nothing unless you can prove it"
  * are both legitimate asks and only the caller knows which one it is making.
  */
-declare const applyComparison: ({ reviewer, targetReviewer, revisionStamp, granularity, numberingChanges }: ParsedComparison, planned: readonly PlannedStoryComparison[]) => Result<AppliedComparison, CompareDocxApplyError>;
+declare const applyComparison: ({ reviewer, revisionStamp, granularity, numberingChanges }: ParsedComparison, planned: readonly PlannedStoryComparison[]) => Result<AppliedComparison, CompareDocxApplyError>;
 /**
  * Stage 4: the result package, with every ZIP entry date pinned.
  *

package/dist/compare/compare.js

@@ -1,5 +1,5 @@
-import { FolioDocxReviewer } from "../ai-edits/headless.js";
-import { numberingReferenceKeysOf } from "../ai-edits/snapshot.js";
+import { FolioDocxReviewer, getFolioDocxComparisonAccess } from "../ai-edits/headless.js";
+import { numberingReferenceKeysOf, storyTablesOf } from "../ai-edits/snapshot.js";
 import { projectTableGeometry } from "../ai-edits/table-geometry.js";
 import { tableTemplateCanCrossPackageLosslessly } from "../ai-edits/table-template.js";
 import { createScopedWordDiffOptions } from "../ai-edits/word-diff.js";
@@ -60,25 +60,6 @@ const parseSide = async (buffer, side, author) => await Result.tryPromise({
 		cause
 	})
 });
-/** Read before either side is resolved, so it describes the package as it arrived. */
-const existingRevisionsOf = (reviewer) => {
-	let highest = 0;
-	let present = false;
-	for (const { handle } of reviewer.listStories()) {
-		const story = reviewer.readReviewedStory({
-			story: handle,
-			view: "current-markup"
-		});
-		for (const change of story?.changes ?? []) {
-			highest = Math.max(highest, change.id);
-			present = true;
-		}
-	}
-	return {
-		idSeed: highest + 1,
-		present
-	};
-};
 /** Verify formatting only where the plan claims a text-equal formatting change. */
 const formattingRoundTripFailure = ({ invariant, story, changes, actualBlocks, expectedBlocks, expectedBlockId }) => {
 	const expectedIndexById = new Map(expectedBlocks.map(({ id }, index) => [id, index]));
@@ -146,15 +127,20 @@ const parseComparison = async (base, target, options) => {
 	if (targetParse.isErr()) return Result.err(targetParse.error);
 	const reviewer = baseParse.value;
 	const targetReviewer = targetParse.value;
-	const existing = existingRevisionsOf(reviewer);
-	for (const { handle } of reviewer.listStories()) reviewer.resolveReviewedStory({
-		story: handle,
-		view: "final"
-	});
-	for (const { handle } of targetReviewer.listStories()) targetReviewer.resolveReviewedStory({
-		story: handle,
-		view: "final"
-	});
+	const baseProjection = getFolioDocxComparisonAccess(reviewer).projectStories("with-revision-census");
+	const targetProjection = getFolioDocxComparisonAccess(targetReviewer).projectStories("without-revision-census");
+	const baseStories = [];
+	const targetStories = [];
+	const baseSnapshots = /* @__PURE__ */ new Map();
+	const targetSnapshots = /* @__PURE__ */ new Map();
+	for (const { handle, snapshot } of baseProjection.stories) {
+		baseStories.push(handle);
+		baseSnapshots.set(handle, snapshot);
+	}
+	for (const { handle, snapshot } of targetProjection.stories) {
+		targetStories.push(handle);
+		targetSnapshots.set(handle, snapshot);
+	}
 	const pairs = [];
 	const unsupported = [];
 	const referencedNumberingLevels = /* @__PURE__ */ new Set();
@@ -162,10 +148,10 @@ const parseComparison = async (base, target, options) => {
 		if (!snapshot) return;
 		for (const referenceKey of numberingReferenceKeysOf(snapshot)) referencedNumberingLevels.add(referenceKey);
 	};
-	for (const { baseStory, revisedStory: targetStory } of pairFolioDocumentStories(reviewer.listStories().map(({ handle }) => handle), targetReviewer.listStories().map(({ handle }) => handle))) {
+	for (const { baseStory, revisedStory: targetStory } of pairFolioDocumentStories(baseStories, targetStories)) {
 		if (!baseStory) {
 			if (!targetStory) panic("A story pair contained neither a base nor a target story");
-			collectNumberingReferences(targetReviewer.snapshotStory(targetStory));
+			collectNumberingReferences(targetSnapshots.get(targetStory));
 			unsupported.push({
 				reason: "story-missing-in-base",
 				baseStory: null,
@@ -174,7 +160,7 @@ const parseComparison = async (base, target, options) => {
 			continue;
 		}
 		if (!targetStory) {
-			collectNumberingReferences(reviewer.snapshotStory(baseStory));
+			collectNumberingReferences(baseSnapshots.get(baseStory));
 			unsupported.push({
 				reason: "story-missing-in-target",
 				baseStory,
@@ -182,8 +168,8 @@ const parseComparison = async (base, target, options) => {
 			});
 			continue;
 		}
-		const baseSnapshot = reviewer.snapshotStory(baseStory);
-		const targetSnapshot = targetReviewer.snapshotStory(targetStory);
+		const baseSnapshot = baseSnapshots.get(baseStory);
+		const targetSnapshot = targetSnapshots.get(targetStory);
 		collectNumberingReferences(baseSnapshot);
 		collectNumberingReferences(targetSnapshot);
 		if (!baseSnapshot || !targetSnapshot) {
@@ -204,12 +190,11 @@ const parseComparison = async (base, target, options) => {
 	return Result.ok({
 		granularity: options.granularity ?? "word",
 		baseBuffer: base,
-		baseCarriedRevisions: existing.present,
+		baseCarriedRevisions: baseProjection.revisions.present,
 		reviewer,
-		targetReviewer,
 		revisionStamp: {
 			date: options.timestamp,
-			idSeed: existing.idSeed
+			idSeed: baseProjection.revisions.highestId + 1
 		},
 		packageDate,
 		pairs,
@@ -217,8 +202,8 @@ const parseComparison = async (base, target, options) => {
 		unsupported
 	});
 };
-const planCopiesNonPortableWholeTable = (targetReviewer, pair, plan) => {
-	const targetTables = new Map(targetReviewer.storyTables({ story: pair.targetStory }).map(({ index, node }) => [index, node]));
+const planCopiesNonPortableWholeTable = (pair, plan) => {
+	const targetTables = new Map(storyTablesOf(pair.targetSnapshot).map(({ index, node }) => [index, node]));
 	return plan.tableTemplates.some(({ targetRowIndex, targetTableIndex }) => {
 		if (targetRowIndex !== void 0) return false;
 		const table = targetTables.get(targetTableIndex);
@@ -229,7 +214,7 @@ const planCopiesNonPortableWholeTable = (targetReviewer, pair, plan) => {
 * Stage 2: align every paired story and derive its operations. Pure — no
 * parsing, no serialization, no clock.
 */
-const planComparison = ({ pairs, targetReviewer }) => {
+const planComparison = ({ pairs }) => {
 	const planned = [];
 	const workSession = createContentComparisonWorkSession();
 	let remainingOperations = MAX_COMPARE_OPERATIONS;
@@ -246,7 +231,7 @@ const planComparison = ({ pairs, targetReviewer }) => {
 			wholeTableReplacement: "allow",
 			workSession
 		});
-		if (plan && planCopiesNonPortableWholeTable(targetReviewer, pair, plan)) {
+		if (plan && planCopiesNonPortableWholeTable(pair, plan)) {
 			workSession.alignment.remainingLcsCells = remainingLcsCells;
 			workSession.alignment.remainingStructuralTokenLookups = remainingStructuralTokenLookups;
 			workSession.remainingMoveComparisons = remainingMoveComparisons;
@@ -343,7 +328,8 @@ const resolveTableTemplates = (targetTables, requests) => {
 * what you could not represent" and "give me nothing unless you can prove it"
 * are both legitimate asks and only the caller knows which one it is making.
 */
-const applyComparison = ({ reviewer, targetReviewer, revisionStamp, granularity, numberingChanges }, planned) => {
+const applyComparison = ({ reviewer, revisionStamp, granularity, numberingChanges }, planned) => {
+	const comparisonAccess = getFolioDocxComparisonAccess(reviewer);
 	const changes = [...numberingChanges];
 	const failures = [];
 	let idSeed = revisionStamp.idSeed;
@@ -352,12 +338,9 @@ const applyComparison = ({ reviewer, targetReviewer, revisionStamp, granularity,
 	for (const { pair, plan } of planned) {
 		changes.push(...plan.changes);
 		if (plan.operations.length === 0 && plan.tableGeometryPairings.length === 0) continue;
-		const baseBefore = reviewer.readReviewedStory({
-			story: pair.baseStory,
-			view: "final"
-		})?.snapshot.blocks ?? [];
-		const baseBeforeGeometry = projectTableGeometry(reviewer.storyTables({ story: pair.baseStory }));
-		const targetTables = new Map(targetReviewer.storyTables({ story: pair.targetStory }).map(({ index, node }) => [index, node]));
+		const baseBefore = pair.baseSnapshot.blocks;
+		const baseBeforeGeometry = projectTableGeometry(storyTablesOf(pair.baseSnapshot));
+		const targetTables = new Map(storyTablesOf(pair.targetSnapshot).map(({ index, node }) => [index, node]));
 		const afterGeometry = reviewer.matchStoryTableGeometry({
 			story: pair.baseStory,
 			targetTables,
@@ -396,14 +379,14 @@ const applyComparison = ({ reviewer, targetReviewer, revisionStamp, granularity,
 				skipped: refused
 			}));
 		}
-		const acceptedStory = reviewer.readReviewedStory({
+		const acceptedSnapshot = comparisonAccess.snapshotReviewedStory({
 			story: pair.baseStory,
 			view: "final"
 		});
 		const acceptFailure = classifyProjectionMismatch({
 			invariant: "accept-reproduces-target",
 			story: pair.baseStory,
-			actual: acceptedStory?.snapshot.blocks ?? [],
+			actual: acceptedSnapshot?.blocks ?? [],
 			expected: pair.targetSnapshot.blocks
 		});
 		if (acceptFailure) failures.push(acceptFailure);
@@ -412,20 +395,20 @@ const applyComparison = ({ reviewer, targetReviewer, revisionStamp, granularity,
 				invariant: "accept-reproduces-target",
 				story: pair.baseStory,
 				changes: plan.changes,
-				actualBlocks: acceptedStory?.snapshot.blocks ?? [],
+				actualBlocks: acceptedSnapshot?.blocks ?? [],
 				expectedBlocks: pair.targetSnapshot.blocks,
 				expectedBlockId: ({ targetBlockId }) => targetBlockId
 			});
 			if (formattingFailure) failures.push(formattingFailure);
 		}
-		const rejectedStory = reviewer.readReviewedStory({
+		const rejectedSnapshot = comparisonAccess.snapshotReviewedStory({
 			story: pair.baseStory,
 			view: "original"
 		});
 		const rejectFailure = classifyProjectionMismatch({
 			invariant: "reject-reproduces-base",
 			story: pair.baseStory,
-			actual: rejectedStory?.snapshot.blocks ?? [],
+			actual: rejectedSnapshot?.blocks ?? [],
 			expected: baseBefore
 		});
 		if (rejectFailure) failures.push(rejectFailure);
@@ -434,7 +417,7 @@ const applyComparison = ({ reviewer, targetReviewer, revisionStamp, granularity,
 				invariant: "reject-reproduces-base",
 				story: pair.baseStory,
 				changes: plan.changes,
-				actualBlocks: rejectedStory?.snapshot.blocks ?? [],
+				actualBlocks: rejectedSnapshot?.blocks ?? [],
 				expectedBlocks: pair.baseSnapshot.blocks,
 				expectedBlockId: ({ baseBlockId }) => baseBlockId
 			});
@@ -443,20 +426,14 @@ const applyComparison = ({ reviewer, targetReviewer, revisionStamp, granularity,
 		const geometryAcceptFailure = classifyGeometryMismatch({
 			invariant: "accept-reproduces-target",
 			story: pair.baseStory,
-			actual: projectTableGeometry(reviewer.storyTables({
-				story: pair.baseStory,
-				view: "final"
-			})),
-			expected: projectTableGeometry(targetReviewer.storyTables({ story: pair.targetStory }))
+			actual: projectTableGeometry(acceptedSnapshot ? storyTablesOf(acceptedSnapshot) : []),
+			expected: projectTableGeometry(storyTablesOf(pair.targetSnapshot))
 		});
 		if (geometryAcceptFailure) failures.push(geometryAcceptFailure);
 		const geometryRejectFailure = classifyGeometryMismatch({
 			invariant: "reject-reproduces-base",
 			story: pair.baseStory,
-			actual: projectTableGeometry(reviewer.storyTables({
-				story: pair.baseStory,
-				view: "original"
-			})),
+			actual: projectTableGeometry(rejectedSnapshot ? storyTablesOf(rejectedSnapshot) : []),
 			expected: baseBeforeGeometry
 		});
 		if (geometryRejectFailure) failures.push(geometryRejectFailure);

package/dist/compare/content-alignment.js

@@ -601,7 +601,6 @@ const trustedContentSequencePairs = ({ exactPairs, stablePairs, revisedLength, p
 	return [...primary, ...secondary].toSorted((left, right) => left.baseIndex - right.baseIndex || left.revisedIndex - right.revisedIndex);
 };
 const persistedContentSequencePairs = ({ base, revised, anchors, canPair }) => {
-	if (anchors.length === 0) return /* @__PURE__ */ new Set();
 	const uniqueIndexesByFirstId = (items) => {
 		const indexes = /* @__PURE__ */ new Map();
 		items.forEach(({ profile }, itemIndex) => {

package/dist/compare/scenario.d.ts

@@ -1,7 +1,15 @@
-import { FolioAIInlineFormattingPatch } from "../ai-edits/types.js";
+import { FolioAIEditOperation, FolioAIInlineFormattingPatch } from "../ai-edits/types.js";
 import { CompareDocxParseError, CompareDocxSerializeError } from "./types.js";
 import { Result } from "better-result";
 //#region src/compare/scenario.d.ts
+type InsertTableRowOperation = Extract<FolioAIEditOperation, {
+  type: "insertTableRow";
+}>;
+type TableRowPosition = NonNullable<InsertTableRowOperation["position"]>;
+declare const EDIT_SCRIPT_TABLE_ROW_POSITION: {
+  readonly after: "after";
+  readonly before: "before";
+};
 type EditScriptStep = {
   type: "insertParagraphAfter";
   blockIndex: number;
@@ -46,6 +54,7 @@ type EditScriptStep = {
 } | {
   type: "insertTableRow";
   blockIndex: number;
+  position?: TableRowPosition;
   cellTexts: readonly string[];
 } | {
   type: "deleteTableRow";
@@ -74,4 +83,4 @@ type EditScriptResult = {
  */
 declare const applyEditScript: (base: ArrayBuffer, script: EditScript) => Promise<Result<EditScriptResult, CompareDocxParseError | CompareDocxSerializeError>>;
 //#endregion
-export { EDIT_SCRIPT_UNRESOLVED_REASONS, EditScript, EditScriptResult, EditScriptStep, EditScriptUnresolvedReason, EditScriptUnresolvedStep, applyEditScript };
+export { EDIT_SCRIPT_TABLE_ROW_POSITION, EDIT_SCRIPT_UNRESOLVED_REASONS, EditScript, EditScriptResult, EditScriptStep, EditScriptUnresolvedReason, EditScriptUnresolvedStep, applyEditScript };

package/dist/compare/scenario.js

@@ -24,6 +24,10 @@ import { Result, panic } from "better-result";
 * dropped: a script silently doing less than it says would weaken every
 * property built on it.
 */
+const EDIT_SCRIPT_TABLE_ROW_POSITION = {
+	after: "after",
+	before: "before"
+};
 const EDIT_SCRIPT_UNRESOLVED_REASONS = Object.freeze([
 	"block-out-of-range",
 	"block-not-in-table",
@@ -160,7 +164,7 @@ const planStep = ({ step, blocks, nextOperationId }) => {
 				id: nextOperationId(),
 				type: "insertTableRow",
 				blockId: block.id,
-				position: "after",
+				position: step.position ?? EDIT_SCRIPT_TABLE_ROW_POSITION.after,
 				cellTexts: [...step.cellTexts]
 			}]
 		} : {
@@ -260,4 +264,4 @@ const applyEditScript = async (base, script) => {
 	});
 };
 //#endregion
-export { EDIT_SCRIPT_UNRESOLVED_REASONS, applyEditScript };
+export { EDIT_SCRIPT_TABLE_ROW_POSITION, EDIT_SCRIPT_UNRESOLVED_REASONS, applyEditScript };

package/dist/controller/hiddenEditorManager.js

@@ -7,6 +7,7 @@ import { ensureParaIdsInDoc, ensureParaIdsInState } from "../prosemirror/extensi
 import { createDocumentNumberingPlugin } from "../prosemirror/plugins/documentNumbering.js";
 import { createDocumentStylesPlugin } from "../prosemirror/plugins/documentStyles.js";
 import { schema } from "../prosemirror/schema/index.js";
+import { proseDocumentParagraphSourceContract, readYjsParagraphSourceContract, withParagraphSourceContract, writeYjsParagraphSourceContract } from "../prosemirror/yjsParagraphSourceContract.js";
 import { createHiddenEditorApi } from "./hiddenEditorApi.js";
 import { panic } from "better-result";
 import { EditorState } from "prosemirror-state";
@@ -125,9 +126,18 @@ function createHiddenEditorState(options) {
 				plugins
 			}));
 			collaborationModules.yProseMirror.prosemirrorToYXmlFragment(seedState.doc, collaboration.yXmlFragment);
+			const collaborationDocument = collaboration.yXmlFragment.doc;
+			if (!collaborationDocument) panic("A collaboration fragment must belong to a Yjs document before seeding.");
+			if (proseDocumentParagraphSourceContract(seedState.doc)) writeYjsParagraphSourceContract(collaborationDocument, seedState.doc);
 			collaboration.onSeeded?.();
 		}
 		let { doc } = collaborationModules.yProseMirror.initProseMirrorDoc(collaboration.yXmlFragment, activeSchema);
+		const collaborationDocument = collaboration.yXmlFragment.doc;
+		if (!collaborationDocument) panic("A collaboration fragment must belong to a Yjs document before loading.");
+		const collaborationContract = readYjsParagraphSourceContract(collaborationDocument);
+		const localContract = proseDocumentParagraphSourceContract(localDoc);
+		if (localContract && collaborationContract !== localContract) panic("The collaboration state belongs to a different paragraph-property source.");
+		if (collaborationContract) doc = withParagraphSourceContract(doc, collaborationContract);
 		const initializedState = normalizeSeedState(EditorState.create({
 			doc,
 			schema: activeSchema,
@@ -136,6 +146,7 @@ function createHiddenEditorState(options) {
 		if (!initializedState.doc.eq(doc)) {
 			collaborationModules.yProseMirror.prosemirrorToYXmlFragment(initializedState.doc, collaboration.yXmlFragment);
 			({doc} = collaborationModules.yProseMirror.initProseMirrorDoc(collaboration.yXmlFragment, activeSchema));
+			if (collaborationContract) doc = withParagraphSourceContract(doc, collaborationContract);
 		}
 		const startedAt = performance.now();
 		const state = normalizeSeedState(EditorState.create({

package/dist/controller/layoutPipeline.js

@@ -181,7 +181,7 @@ function runLayoutPipeline(deps, state, options = {}) {
 		const hfPageCountEstimate = layout?.pages.length ?? 1;
 		const hfClock = /* @__PURE__ */ new Date();
 		const buildHfOptions = (pageCount, fieldInputs) => {
-			const hfMeasureBlocks = (hfBlocks, hfWidth) => measureBlocks(hfBlocks, hfWidth, void 0, void 0, buildHeaderFooterFieldValues(hfBlocks, pageCount, hfClock, fieldInputs));
+			const hfMeasureBlocks = (hfBlocks, hfWidth) => measureBlocks(hfBlocks, hfWidth, void 0, void 0, buildHeaderFooterFieldValues(hfBlocks, pageCount, hfClock, fieldInputs), { allowEndTabOverflow: true });
 			return {
 				...flowOpts.styles ? { styles: flowOpts.styles } : {},
 				..._theme !== void 0 ? { theme: _theme } : {},

package/dist/display-list/build/textBoxPrimitives.js

@@ -1,9 +1,10 @@
 import { layoutTextBoxContent } from "../../layout-engine/measure/textBoxParagraphLayout.js";
 import { DEFAULT_TEXTBOX_MARGINS } from "../../layout-engine/types.js";
+import { hasHorizontalFlip, hasVerticalFlip, parseRotationDegrees } from "../../utils/rotationBoundingBox.js";
 import { HIT_REGION_KINDS } from "../primitives.js";
 import { parseDisplayColor } from "./colors.js";
 import { paintParagraphFragment } from "./paragraphPrimitives.js";
-import { blockRegion } from "./regions.js";
+import { blockRegion, createPageComposer } from "./regions.js";
 import { resolveBorderStroke } from "./strokes.js";
 import { paintTableBlock } from "./tablePrimitives.js";
 import { UNSUPPORTED_CONSTRUCT } from "./unsupported.js";
@@ -15,6 +16,38 @@ import { UNSUPPORTED_CONSTRUCT } from "./unsupported.js";
 * measurer used, so the paragraphs land where their heights were reserved.
 */
 const paintTextBoxFragment = ({ composer, fragment, block, measure, context }) => {
+	const rotation = parseRotationDegrees(block.transform);
+	const flipH = hasHorizontalFlip(block.transform);
+	const flipV = hasVerticalFlip(block.transform);
+	if (rotation === 0 && !flipH && !flipV) {
+		paintUnrotatedTextBoxFragment({
+			composer,
+			fragment,
+			block,
+			measure,
+			context
+		});
+		return;
+	}
+	const inner = createPageComposer();
+	paintUnrotatedTextBoxFragment({
+		composer: inner,
+		fragment,
+		block,
+		measure,
+		context
+	});
+	composer.push([{
+		kind: "rotateGroup",
+		degrees: rotation,
+		originXPx: fragment.x + fragment.width / 2,
+		originYPx: fragment.y + fragment.height / 2,
+		...flipH ? { scaleX: -1 } : {},
+		...flipV ? { scaleY: -1 } : {},
+		children: inner.primitives()
+	}]);
+};
+const paintUnrotatedTextBoxFragment = ({ composer, fragment, block, measure, context }) => {
 	const primitives = [];
 	const box = {
 		xPx: fragment.x,

package/dist/display-list/dom/renderDisplayListToDom.js

@@ -434,10 +434,13 @@ const paintClipGroup = ({ rect, children, regions }, context) => {
 		regions
 	}, inner);
 };
-const paintRotateGroup = ({ degrees, originXPx, originYPx, children }, context) => {
+const paintRotateGroup = ({ degrees, originXPx, originYPx, scaleX, scaleY, children }, context) => {
 	const element = createTransparentGroupDiv(context);
 	element.style.transformOrigin = `${px(originXPx - context.originXPx)} ${px(originYPx - context.originYPx)}`;
-	element.style.transform = `rotate(${degrees}deg)`;
+	const transforms = [`rotate(${degrees}deg)`];
+	if (scaleX === -1) transforms.push("scaleX(-1)");
+	if (scaleY === -1) transforms.push("scaleY(-1)");
+	element.style.transform = transforms.join(" ");
 	context.parent.append(element);
 	const inner = {
 		...context,

package/dist/display-list/primitives.d.ts

@@ -15,7 +15,7 @@ import { hasComplexScript, isComplexScriptCodePoint } from "../utils/scriptSegme
  * advances rightward from its origin whatever the paragraph does.
  */
 declare const glyphCellOffsetsPx: (run: DisplayGlyphRun) => readonly number[];
-declare const DISPLAY_PRIMITIVE_KINDS: ("image" | "glyphRun" | "rect" | "line" | "clipGroup" | "rotateGroup" | "opacityGroup")[];
+declare const DISPLAY_PRIMITIVE_KINDS: ("glyphRun" | "rect" | "line" | "image" | "clipGroup" | "rotateGroup" | "opacityGroup")[];
 /**
  * Dash geometry of each stroke pattern, as multiples of the stroke thickness.
  *

package/dist/display-list/types.d.ts

@@ -309,16 +309,20 @@ type DisplayClipGroup = {
   readonly regions: readonly DisplayHitRegion[];
 };
 /**
- * Rotates its children about `originXPx`/`originYPx`. Rotated images,
- * watermark text and vertical (`w:textDirection`) table text are all this.
- * Rotation is the only transform folio paints; scale is resolved into
- * geometry by the producer.
+ * Rotates and optionally reflects its children about `originXPx`/`originYPx`.
+ * Rotated images, text boxes, watermark text and vertical (`w:textDirection`)
+ * table text are all this. A scale of `-1` is a DrawingML flip; the scale is
+ * applied before the rotation, matching CSS and OOXML transform order.
  */
 type DisplayRotateGroup = {
   readonly kind: "rotateGroup";
   readonly degrees: number;
   readonly originXPx: number;
   readonly originYPx: number;
+  /** Optional horizontal reflection about the transform origin. */
+  readonly scaleX?: -1;
+  /** Optional vertical reflection about the transform origin. */
+  readonly scaleY?: -1;
   readonly children: readonly DisplayPrimitive[];
 };
 /** Uniform alpha over a subtree, for watermark washout and image opacity. */