@stll/folio-core 0.46.0 → 0.47.0

package/dist/ai-edits/apply.js

@@ -1,3 +1,4 @@
+import { paragraphNumberingReference, paragraphNumberingReferenceId } from "../docx/numberingReference.js";
 import { formattingEquals } from "../docx/runConsolidator.js";
 import { expectParagraphAttrs, expectRunPropertyChangeMarkAttrs } from "../prosemirror/attrs/index.js";
 import { hasSerializableParagraphPropertyChange, paragraphPropertiesSnapshot } from "../prosemirror/commands/propertyChangeScope.js";
@@ -5,6 +6,7 @@ import { addedBreakCarrierBefore, finalParagraphsOf, paragraphEndsItsContainer }
 import { requestDeterministicParaIds } from "../prosemirror/extensions/features/ParaIdAllocatorExtension.js";
 import { markStructuralChange } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
 import { CLEARED_LIST_RENDERING_ATTRS } from "../prosemirror/listMarker.js";
+import { paragraphNumberingAttr, readParagraphNumberingAttr } from "../prosemirror/numberingAttr.js";
 import { directParagraphAlignment } from "../prosemirror/paragraphAlignment.js";
 import { directParagraphIndentation, paragraphIndentationAttrPatch, paragraphIndentationEqual, paragraphIndentationFromFormatting, withDirectParagraphIndentation } from "../prosemirror/paragraphIndentation.js";
 import { directParagraphSpacing, paragraphSpacingAttrPatch, paragraphSpacingEqual, paragraphSpacingFromFormatting, withDirectParagraphSpacing } from "../prosemirror/paragraphSpacing.js";
@@ -188,26 +190,25 @@ const paragraphPropertiesPatch = ({ node, properties, resolvedFormattingFromStyl
 			ilvl: properties.numbering.level
 		}, numbering));
 		if (properties.listLevel === null) {
-			patch["numPr"] = { numId: properties.numbering.numId };
+			patch["numPr"] = paragraphNumberingAttr(paragraphNumberingReference({ numId: properties.numbering.numId }));
 			patch["numPrFromStyle"] = null;
 		}
 	}
-	else if (properties.listLevel !== void 0) {
-		const numPr = node.attrs["numPr"];
-		if (properties.listLevel === null) {
-			patch["numPr"] = null;
-			Object.assign(patch, CLEARED_LIST_RENDERING_ATTRS);
-		} else {
-			const numId = typeof numPr === "object" && numPr !== null && "numId" in numPr ? numPr.numId : void 0;
-			if (typeof numId === "number") Object.assign(patch, listLevelAttrPatch(attrs, {
-				numId,
+	else if (properties.listLevel !== void 0) if (properties.listLevel === null) {
+		patch["numPr"] = null;
+		Object.assign(patch, CLEARED_LIST_RENDERING_ATTRS);
+	} else {
+		const numId = paragraphNumberingReferenceId(readParagraphNumberingAttr(node.attrs["numPr"]) ?? void 0);
+		if (numId === void 0) {
+			patch["numPr"] = paragraphNumberingAttr({
+				kind: "levelOnly",
 				ilvl: properties.listLevel
-			}, numbering));
-			else {
-				patch["numPr"] = { ilvl: properties.listLevel };
-				Object.assign(patch, CLEARED_LIST_RENDERING_ATTRS);
-			}
-		}
+			});
+			Object.assign(patch, CLEARED_LIST_RENDERING_ATTRS);
+		} else Object.assign(patch, listLevelAttrPatch(attrs, {
+			numId,
+			ilvl: properties.listLevel
+		}, numbering));
 	}
 	if (properties.alignment !== void 0 && (styleChanged || (currentDirectAlignment ?? null) !== properties.alignment)) {
 		originalFormatting ??= {};
@@ -1152,23 +1153,24 @@ const buildInsertedParagraphs = ({ item, schema, formattingFromStyle, mode, auth
 					ilvl: explicitNumbering.level
 				}, numbering));
 				if (listLevel === null) {
-					attrs["numPr"] = { numId: explicitNumbering.numId };
+					attrs["numPr"] = paragraphNumberingAttr(paragraphNumberingReference({ numId: explicitNumbering.numId }));
 					attrs["numPrFromStyle"] = null;
 				}
 			} else if (listLevel === null) {
 				attrs["numPr"] = null;
 				Object.assign(attrs, CLEARED_LIST_RENDERING_ATTRS);
 			} else if (typeof listLevel === "number") {
-				const anchorNumPr = Reflect.get(baseAttrs, "numPr");
-				const numId = typeof anchorNumPr === "object" && anchorNumPr !== null && "numId" in anchorNumPr ? anchorNumPr.numId : void 0;
-				if (typeof numId === "number") Object.assign(attrs, listLevelAttrPatch(operation.inheritFormatting === false ? {} : expectParagraphAttrs(item.blockNode), {
+				const numId = paragraphNumberingReferenceId(readParagraphNumberingAttr(Reflect.get(baseAttrs, "numPr")) ?? void 0);
+				if (numId === void 0) {
+					attrs["numPr"] = paragraphNumberingAttr({
+						kind: "levelOnly",
+						ilvl: listLevel
+					});
+					Object.assign(attrs, CLEARED_LIST_RENDERING_ATTRS);
+				} else Object.assign(attrs, listLevelAttrPatch(operation.inheritFormatting === false ? {} : expectParagraphAttrs(item.blockNode), {
 					numId,
 					ilvl: listLevel
 				}, numbering));
-				else {
-					attrs["numPr"] = { ilvl: listLevel };
-					Object.assign(attrs, CLEARED_LIST_RENDERING_ATTRS);
-				}
 			}
 		}
 		if (formatsParagraph && operation.styleId !== void 0) {

package/dist/ai-edits/headless.js

@@ -35,9 +35,9 @@ import { createFolioAIEditSnapshotWithStyleResolver, detachFolioAIEditSnapshotEx
 import { matchTableGeometry } from "./table-geometry.js";
 import { tableTemplateCanCrossPackageLosslessly } from "./table-template.js";
 import { TaggedError, panic } from "better-result";
+import { REVIEW_CARRIERS } from "@stll/docx-core/model";
 import { Fragment } from "prosemirror-model";
 import { EditorState } from "prosemirror-state";
-import { REVIEW_CARRIERS } from "@stll/docx-core/model";
 import JSZip from "jszip";
 //#region src/ai-edits/headless.ts
 /**

package/dist/ai-edits/read.d.ts

@@ -25,6 +25,7 @@ declare const FOLIO_REVIEW_CHANGE_KINDS: Readonly<{
   readonly paragraphPropertiesChanged: "paragraphPropertiesChanged";
   readonly sectionPropertiesChanged: "sectionPropertiesChanged";
   readonly tablePropertiesChanged: "tablePropertiesChanged";
+  readonly tablePropertyExceptionsChanged: "tablePropertyExceptionsChanged";
   readonly rowPropertiesChanged: "rowPropertiesChanged";
   readonly cellPropertiesChanged: "cellPropertiesChanged";
 }>;

package/dist/ai-edits/read.js

@@ -26,6 +26,7 @@ const FOLIO_REVIEW_CHANGE_KINDS = Object.freeze({
 	paragraphPropertiesChanged: "paragraphPropertiesChanged",
 	sectionPropertiesChanged: "sectionPropertiesChanged",
 	tablePropertiesChanged: "tablePropertiesChanged",
+	tablePropertyExceptionsChanged: "tablePropertyExceptionsChanged",
 	rowPropertiesChanged: "rowPropertiesChanged",
 	cellPropertiesChanged: "cellPropertiesChanged"
 });

package/dist/ai-edits/snapshot.js

@@ -1,7 +1,10 @@
 import { EMPTY_BUILT_IN_STYLE_INDEX, resolveHeadingLevel } from "../docx/builtInStyles.js";
+import { resolveParagraphNumbering } from "../docx/numberingReference.js";
 import { recreateProseNodeWithParagraphPropertySource } from "../docx/paragraphPropertySource.js";
 import { expectCharacterStyleMarkAttrs, expectHyperlinkMarkAttrs, expectParagraphAttrs, expectRunFormattingOverrideMarkAttrs } from "../prosemirror/attrs/index.js";
 import { marksToTextFormatting } from "../prosemirror/conversion/fromProseDoc.js";
+import { paragraphNumberingAttr, readParagraphNumberingAttr } from "../prosemirror/numberingAttr.js";
+import { readOutlineLevelAttr } from "../prosemirror/outlineLevelAttr.js";
 import { directParagraphAlignment } from "../prosemirror/paragraphAlignment.js";
 import { directParagraphIndentation } from "../prosemirror/paragraphIndentation.js";
 import { directParagraphSpacing } from "../prosemirror/paragraphSpacing.js";
@@ -34,18 +37,16 @@ const remapFolioAIEditSnapshotNumberingReferences = (snapshot, numIdMap) => {
 	if (numIdMap.size === 0) return snapshot;
 	const metadata = metadataOf(snapshot);
 	const remapNode = (node) => {
-		const numPr = node.attrs["numPr"];
-		if (typeof numPr !== "object" || numPr === null || !("numId" in numPr)) return node;
-		const numId = numPr.numId;
-		if (typeof numId !== "number") return node;
-		const remappedNumId = numIdMap.get(numId);
+		const numPr = readParagraphNumberingAttr(node.attrs["numPr"]);
+		if (numPr?.kind !== "reference") return node;
+		const remappedNumId = numIdMap.get(numPr.numId);
 		if (remappedNumId === void 0) return node;
 		return recreateProseNodeWithParagraphPropertySource(node, { attrs: {
 			...node.attrs,
-			numPr: {
+			numPr: paragraphNumberingAttr({
 				...numPr,
 				numId: remappedNumId
-			}
+			})
 		} });
 	};
 	const remapped = remapDocument(metadata.sourceDocument, remapNode);
@@ -481,10 +482,9 @@ const getBlockKind = (node, headingLevel) => {
 };
 /** The block's 1-based heading level, as {@link resolveHeadingLevel} classifies it. */
 const getHeadingLevel = (node, styles) => {
-	const outlineLevel = node.attrs["outlineLevel"];
 	const styleId = node.attrs["styleId"];
 	const level = resolveHeadingLevel({
-		outlineLevel: typeof outlineLevel === "number" ? outlineLevel : null,
+		outlineLevel: readOutlineLevelAttr(node.attrs["outlineLevel"]),
 		styleId: typeof styleId === "string" ? styleId : null
 	}, styles);
 	return level === void 0 ? void 0 : level + 1;
@@ -495,30 +495,35 @@ const getDisplayLabel = (node, isHeading) => {
 	const styleId = node.attrs["styleId"];
 	if (isHeading && typeof styleId === "string") return styleId;
 };
+/**
+* The level the paragraph's `<w:numPr>` states, and only that. An absent
+* `w:ilvl` renders as level zero but is not a stated zero, and a caller that
+* writes it back would turn an untouched paragraph into one stating a level
+* its source never did.
+*/
 const getListLevel = (node) => {
-	const numPr = node.attrs["numPr"];
-	if (typeof numPr !== "object" || numPr === null || !("ilvl" in numPr)) return;
-	const { ilvl } = numPr;
-	return typeof ilvl === "number" && Number.isInteger(ilvl) && ilvl >= 0 ? ilvl : void 0;
+	const numPr = readParagraphNumberingAttr(node.attrs["numPr"]);
+	return numPr === null || numPr.kind === "none" ? void 0 : numPr.ilvl;
 };
+/**
+* The numbering a paragraph attr states, read through the model's own reader.
+*
+* The two functions below used to test the reserved id relationally
+* (`numId > 0`, `numId <= 0`), which is the one spelling that disagreed with
+* the other four: a malformed package's negative id is a dangling reference
+* everywhere else and "not numbered" here.
+*/
+const statedNumbering = (node) => resolveParagraphNumbering(readParagraphNumberingAttr(node.attrs["numPr"]) ?? void 0);
 const getListReference = (node) => {
-	const numPr = node.attrs["numPr"];
-	if (typeof numPr !== "object" || numPr === null || !("numId" in numPr)) return void 0;
-	const { numId } = numPr;
-	const level = "ilvl" in numPr ? numPr.ilvl : 0;
-	return typeof numId === "number" && Number.isInteger(numId) && numId > 0 && typeof level === "number" && Number.isInteger(level) && level >= 0 ? {
-		numId,
-		level
+	const numbering = statedNumbering(node);
+	return numbering.kind === "reference" ? {
+		numId: numbering.numId,
+		level: numbering.ilvl
 	} : void 0;
 };
 const getNumberingReferenceKey = (node) => {
-	const numPr = node.attrs["numPr"];
-	if (typeof numPr !== "object" || numPr === null || !("numId" in numPr)) return null;
-	const { numId } = numPr;
-	if (typeof numId !== "number" || !Number.isInteger(numId) || numId <= 0) return null;
-	const level = "ilvl" in numPr ? numPr.ilvl : void 0;
-	if (level !== void 0 && (typeof level !== "number" || !Number.isInteger(level) || level < 0)) return null;
-	return `${String(numId)}:${String(level ?? 0)}`;
+	const numbering = statedNumbering(node);
+	return numbering.kind === "reference" ? `${String(numbering.numId)}:${String(numbering.ilvl)}` : null;
 };
 const getStyleId = (node) => {
 	const styleId = node.attrs["styleId"];

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

@@ -51,7 +51,11 @@ const mergeTableRectangle = ({ tr, tablePosition, table, rectangle }) => {
 		rowspan: rectangle.bottom - rectangle.top,
 		colwidth: nextColwidth,
 		width: preferredWidth.type === "value" ? preferredWidth.width : null,
-		widthType: preferredWidth.type === "value" ? preferredWidth.widthType : null
+		widthType: preferredWidth.type === "value" ? preferredWidth.widthType : null,
+		_authoredWidth: preferredWidth.type === "value" ? {
+			value: preferredWidth.width,
+			type: preferredWidth.widthType
+		} : null
 	});
 	if (appendedContent.size > 0) {
 		const contentEnd = absoluteMergedPosition + 1 + merged.cell.content.size;
@@ -74,16 +78,20 @@ const mergeTopRowColwidths = (cells, mergedColspan) => {
 * preferred widths; retaining only the first cell's width makes a 50%+50%
 * bilingual row serialize as a 50%-wide spanning cell. Mixed/implicit units
 * cannot be composed safely, so clear the preference and let the table grid
-* define the merged width. */
+* define the merged width.
+*
+* The summands are `_authoredWidth`, not the rendered `width`: a cell that
+* states no preferred width still renders at the width the table grid
+* resolved, and summing those would give the merged cell a `w:tcW` no source
+* cell wrote. */
 const mergeTopRowPreferredWidths = (cells) => {
 	let width = 0;
 	let widthType;
 	for (const cell of cells) {
-		const candidateWidth = cell.attrs["width"];
-		const candidateType = cell.attrs["widthType"];
-		if (typeof candidateWidth !== "number" || !Number.isFinite(candidateWidth) || candidateType !== "dxa" && candidateType !== "pct" || widthType !== void 0 && candidateType !== widthType) return { type: "absent" };
-		width += candidateWidth;
-		widthType = candidateType;
+		const stated = expectTableCellAttrs(cell)._authoredWidth;
+		if (stated === void 0 || !Number.isFinite(stated.value) || stated.type !== "dxa" && stated.type !== "pct" || widthType !== void 0 && stated.type !== widthType) return { type: "absent" };
+		width += stated.value;
+		widthType = stated.type;
 	}
 	return widthType === void 0 ? { type: "absent" } : {
 		type: "value",

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

@@ -80,21 +80,24 @@ const TABLE_SCOPE = {
 	changeAttr: "tblPrChange",
 	changeType: "tablePropertyChange"
 };
-const ROW_SCOPE = {
-	keys: ROW_SCOPED_ATTRS,
-	signatureOf: (node) => scopedValues(node.attrs, ROW_SCOPED_ATTRS),
-	formattingOf: (node) => tableRowAttrsToFormatting(node.attrs),
-	rejectPatch: (previousFormatting) => tableRowRejectAttrPatch(previousFormatting),
-	changeAttr: "trPrChange",
-	changeType: "tableRowPropertyChange"
-};
-const CELL_SCOPE = {
-	keys: CELL_SCOPED_ATTRS,
-	signatureOf: (node) => scopedValues(node.attrs, CELL_SCOPED_ATTRS),
-	formattingOf: (node) => tableCellAttrsToFormatting(cellAttrsOf(node)),
-	rejectPatch: (previousFormatting, liveFormatting) => tableCellRejectAttrPatch(previousFormatting, liveFormatting),
-	changeAttr: "tcPrChange",
-	changeType: "tableCellPropertyChange"
+const GEOMETRY_SCOPES = {
+	tablePropertyChange: TABLE_SCOPE,
+	tableRowPropertyChange: {
+		keys: ROW_SCOPED_ATTRS,
+		signatureOf: (node) => scopedValues(node.attrs, ROW_SCOPED_ATTRS),
+		formattingOf: (node) => tableRowAttrsToFormatting(node.attrs),
+		rejectPatch: (previousFormatting) => tableRowRejectAttrPatch(previousFormatting),
+		changeAttr: "trPrChange",
+		changeType: "tableRowPropertyChange"
+	},
+	tableCellPropertyChange: {
+		keys: CELL_SCOPED_ATTRS,
+		signatureOf: (node) => scopedValues(node.attrs, CELL_SCOPED_ATTRS),
+		formattingOf: (node) => tableCellAttrsToFormatting(cellAttrsOf(node)),
+		rejectPatch: (previousFormatting, liveFormatting) => tableCellRejectAttrPatch(previousFormatting, liveFormatting),
+		changeAttr: "tcPrChange",
+		changeType: "tableCellPropertyChange"
+	}
 };
 const scopedValues = (attrs, keys) => canonicalJson(scopedAttrs(attrs, keys));
 /**
@@ -200,9 +203,9 @@ const matchTableGeometry = ({ tr, baseTables, targetTables, pairings, revision }
 		const targetCell = targetRow.maybeChild(target.cellIndex);
 		const cellPosition = childPositions(baseRow, rowPosition)[base.cellIndex];
 		if (!baseCell || !targetCell || cellPosition === void 0) continue;
-		consider(baseTable.node, targetTable, baseTable.start, TABLE_SCOPE);
-		consider(baseRow, targetRow, rowPosition, ROW_SCOPE);
-		consider(baseCell, targetCell, cellPosition, CELL_SCOPE);
+		consider(baseTable.node, targetTable, baseTable.start, GEOMETRY_SCOPES.tablePropertyChange);
+		consider(baseRow, targetRow, rowPosition, GEOMETRY_SCOPES.tableRowPropertyChange);
+		consider(baseCell, targetCell, cellPosition, GEOMETRY_SCOPES.tableCellPropertyChange);
 	}
 	let revisionId = revision.idSeed;
 	for (const target of targets) {

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

@@ -70,7 +70,6 @@ const CLEARED_PARAGRAPH_ATTRS = [
 	"pPrMark",
 	"_suggestedInsert",
 	"_sectionProperties",
-	"sectionBreakType",
 	"renderedPageBreakBefore"
 ];
 /** Table, row and cell attrs that record the other document's revisions. */
@@ -78,7 +77,8 @@ const CLEARED_TABLE_ATTRS = ["tblPrChange", "_suggestedInsert"];
 const CLEARED_ROW_ATTRS = [
 	"trIns",
 	"trDel",
-	"trPrChange"
+	"trPrChange",
+	"tblPrExChange"
 ];
 const CLEARED_CELL_ATTRS = ["cellMarker", "tcPrChange"];
 const hasAuthoredValue = (value) => {

package/dist/compare/content-alignment.js

@@ -1,3 +1,4 @@
+import { alignParagraphOrdinals } from "../docx/paraIdAttribute.js";
 import { alignTableColumns } from "./column-alignment.js";
 import { panic } from "better-result";
 //#region src/compare/content-alignment.ts
@@ -273,6 +274,44 @@ const pairsInAnchorGaps = ({ baseLength, revisedLength, anchors, pairGap }) => {
 	}
 	return pairs;
 };
+/**
+* Blocks the anchor passes left unpaired whose exact text stands, also
+* unpaired, on the other side.
+*
+* Anchoring is monotone, so content that moved past other content leaves one
+* of its two correspondences unanchored by construction: two paragraphs that
+* swap places produce two exact candidates that cross, and only one survives
+* the increasing subsequence. What is left over is both ends of that crossing.
+* It is not a paragraph rewritten into another, so the positional fallback
+* must not fuse them: a relocation would come back as a replacement neither
+* document contains, and the move pass would never see the removal and the
+* arrival it is there to pair.
+*/
+const crossedExactTextBlocks = ({ base, revised, anchors, canPair }) => {
+	const uniqueUnanchoredByText = (blocks, anchored) => {
+		const blocksByText = /* @__PURE__ */ new Map();
+		for (const block of blocks) {
+			if (anchored.has(block.index) || !NON_WHITESPACE.test(block.block.text)) continue;
+			const { text } = block.block;
+			blocksByText.set(text, blocksByText.has(text) ? null : block);
+		}
+		return blocksByText;
+	};
+	const baseByText = uniqueUnanchoredByText(base, new Set(anchors.map(({ baseIndex }) => baseIndex)));
+	const revisedByText = uniqueUnanchoredByText(revised, new Set(anchors.map(({ revisedIndex }) => revisedIndex)));
+	const crossedBase = /* @__PURE__ */ new Set();
+	const crossedRevised = /* @__PURE__ */ new Set();
+	for (const [text, baseBlock] of baseByText) {
+		const revisedBlock = revisedByText.get(text);
+		if (!baseBlock || !revisedBlock || !canPair(baseBlock, revisedBlock)) continue;
+		crossedBase.add(baseBlock.index);
+		crossedRevised.add(revisedBlock.index);
+	}
+	return {
+		base: crossedBase,
+		revised: crossedRevised
+	};
+};
 const alignFolioContentBlocksInScope = (baseBlocks, revisedBlocks, options) => {
 	const stableIdMismatch = options.stableIdMismatch ?? "separate";
 	const idStability = options.idStability ?? folioContentIdStability;
@@ -322,13 +361,19 @@ const alignFolioContentBlocksInScope = (baseBlocks, revisedBlocks, options) => {
 		})
 	});
 	const anchors = [...exactAndStableAnchors, ...continuityAnchors].toSorted((left, right) => left.baseIndex - right.baseIndex || left.revisedIndex - right.revisedIndex);
+	const crossed = crossedExactTextBlocks({
+		base: prepared.base,
+		revised: prepared.revised,
+		anchors,
+		canPair
+	});
 	const events = [];
 	const emitPositionalGap = (baseFrom, baseTo, revisedFrom, revisedTo) => {
 		const pairedCount = Math.min(baseTo - baseFrom, revisedTo - revisedFrom);
 		for (let offset = 0; offset < pairedCount; offset++) {
 			const baseBlock = prepared.base[baseFrom + offset];
 			const revisedBlock = prepared.revised[revisedFrom + offset];
-			if (baseBlock && revisedBlock) if (!canPair(baseBlock, revisedBlock)) {
+			if (baseBlock && revisedBlock) if (baseBlock.block.text !== revisedBlock.block.text && crossed.base.has(baseBlock.index) && crossed.revised.has(revisedBlock.index) || !canPair(baseBlock, revisedBlock)) {
 				events.push({
 					type: "baseOnly",
 					block: baseBlock.block
@@ -644,15 +689,64 @@ const stableContentSequencePairs = (base, revised) => {
 	}
 	return pairs;
 };
-const contentContainerIdentityTransition = (base, revised) => {
-	if (base === null || revised === null || base.status !== "available" || revised.status !== "available" || base.blockIds.length === 0 || base.blockIds.length !== revised.blockIds.length) return false;
-	let hasStabilityTransition = false;
-	for (let index = 0; index < base.blockIds.length; index++) {
-		if (base.blockIds[index] !== revised.blockIds[index]) return false;
-		hasStabilityTransition ||= base.idStabilities[index] !== revised.idStabilities[index];
-	}
-	return hasStabilityTransition;
+/**
+* A container's blocks as the paragraph identities the save reasons about: a
+* stable id is one the package wrote, a positional id one folio minted for a
+* paragraph that arrived without one.
+*/
+const containerParagraphIdentities = (profile) => profile.blockIds.map((paraId, ordinal) => profile.idStabilities[ordinal] === "stable" ? {
+	type: "authored",
+	paraId,
+	ordinal
+} : {
+	type: "minted",
+	paraId,
+	ordinal
+});
+/**
+* Whether two containers are the same container, read from the paragraph ids
+* their blocks carry.
+*
+* This used to ask for a positional-to-stable *transition* with identical ids
+* at every index, which is the shape a save produced when it stamped folio's
+* minted ids into the package it wrote. That made the comparison depend on a
+* side effect of the save rather than on the documents in front of it: once a
+* save stopped persisting a minted id, both sides read positional, the
+* transition never fired, and an edited row was reported deleted and inserted
+* instead of edited.
+*
+* The question is the one {@link alignParagraphOrdinals} answers, and it is
+* asked through the owner the save asks it through, so the two cannot come to
+* disagree about which paragraph is which. A comparison sees two different
+* documents, so absence of contradiction is not enough on its own: most of the
+* container has to actively confirm the ordinals, or every container of equal
+* size would pair with every other on the strength of saying nothing. A
+* positional id is derived from the paragraph's own text and position, so an
+* unedited block keeps it across the edit and supplies that confirmation, while
+* an edited block's id changes with its text. A majority is therefore "the
+* blocks this edit did not touch", and it is what separates a row with an edit
+* in it from a row replaced by a different row, which shares no id at all.
+*
+* This signal only has to carry the containers similarity cannot reach: a pair
+* it declines is still weighed on content, so a two-block container with one
+* block edited pairs on the half it kept rather than on a bare majority.
+*/
+const contentContainersShareIdentity = (base, revised) => {
+	if (base === null || revised === null || base.status !== "available" || revised.status !== "available" || base.blockIds.length === 0) return false;
+	const alignment = alignParagraphOrdinals(containerParagraphIdentities(base), containerParagraphIdentities(revised));
+	return alignment.consistent && alignment.sharedOrdinals * 2 > base.blockIds.length;
 };
+/**
+* Whether two containers carry the same block ids in the same order, over
+* their whole length.
+*
+* Stricter than {@link contentContainersShareIdentity}, which answers which
+* container this is while blocks come and go. This answers whether there is
+* anything left to decide: nothing moved within either container, so paired
+* with equal content they are one container seen twice. An identity a cap
+* withheld is unknown, never equal.
+*/
+const contentContainerIdsAreEqual = (base, revised) => base !== null && revised !== null && base.status === "available" && revised.status === "available" && base.blockIds.length > 0 && base.blockIds.length === revised.blockIds.length && base.blockIds.every((id, index) => id === revised.blockIds[index]);
 const uniqueExactContentSequencePairs = ({ baseKeys, revisedKeys }) => {
 	const uniqueIndexes = (keys) => {
 		const indexes = /* @__PURE__ */ new Map();
@@ -723,7 +817,7 @@ const persistedContentSequencePairs = ({ base, revised, anchors, canPair }) => {
 			baseIndex,
 			revisedIndex
 		};
-		if (revisedItem && canPair(baseItem, revisedItem) && contentContainerIdentityTransition(baseItem.profile.containerIdentity, revisedItem.profile.containerIdentity) && pairIsCompatibleWithAnchors(pair, anchors)) candidates.push(pair);
+		if (revisedItem && canPair(baseItem, revisedItem) && contentContainersShareIdentity(baseItem.profile.containerIdentity, revisedItem.profile.containerIdentity) && pairIsCompatibleWithAnchors(pair, anchors)) candidates.push(pair);
 	}
 	return new Set(monotoneContentSequencePairs(candidates).map(({ baseIndex, revisedIndex }) => baseIndex * revised.length + revisedIndex));
 };
@@ -742,7 +836,7 @@ const alignProfiledContentSequence = ({ base, revised, workSession, canPair = ()
 		const revisedProfile = revised[index]?.profile;
 		if (!baseProfile || !revisedProfile) continue;
 		const hasContainerIdentity = baseProfile.containerIdentity !== null || revisedProfile.containerIdentity !== null;
-		let hasProvenanceTransition = contentContainerIdentityTransition(baseProfile.containerIdentity, revisedProfile.containerIdentity);
+		let hasProvenanceTransition = contentContainersShareIdentity(baseProfile.containerIdentity, revisedProfile.containerIdentity);
 		if (!hasContainerIdentity) {
 			const revisedIds = new Set(revisedProfile.blockIds);
 			const baseStableIds = new Set(baseProfile.stableIds);
@@ -861,6 +955,7 @@ const alignProfiledContentSequence = ({ base, revised, workSession, canPair = ()
 	let revisedIndex = 0;
 	let pairCount = 0;
 	let solePairIsShifted = false;
+	let solePairIsIdentity = false;
 	let hasBaseOnly = false;
 	let hasRevisedOnly = false;
 	while (baseIndex < base.length && revisedIndex < revised.length) {
@@ -875,6 +970,7 @@ const alignProfiledContentSequence = ({ base, revised, workSession, canPair = ()
 			});
 			pairCount += 1;
 			solePairIsShifted = baseIndex !== revisedIndex;
+			solePairIsIdentity = baseExactSignatureKeys[baseIndex] === revisedExactSignatureKeys[revisedIndex] && contentContainerIdsAreEqual(base[baseIndex]?.profile.containerIdentity ?? null, revised[revisedIndex]?.profile.containerIdentity ?? null);
 			baseIndex += 1;
 			revisedIndex += 1;
 		} else if (direction === ALIGNMENT_DIRECTION.revisedOnly && revisedItem !== void 0) {
@@ -907,7 +1003,7 @@ const alignProfiledContentSequence = ({ base, revised, workSession, canPair = ()
 		});
 		hasRevisedOnly = true;
 	}
-	if ((soleShiftedPairResiduePolicy === "conservative" || base.length === revised.length) && pairCount === 1 && solePairIsShifted && hasBaseOnly && hasRevisedOnly) return aligned.flatMap((entry) => entry.type === "pair" ? [{
+	if (!solePairIsIdentity && (soleShiftedPairResiduePolicy === "conservative" || base.length === revised.length) && pairCount === 1 && solePairIsShifted && hasBaseOnly && hasRevisedOnly) return aligned.flatMap((entry) => entry.type === "pair" ? [{
 		type: "baseOnly",
 		item: entry.base
 	}, {

package/dist/compare/content-types.d.ts

@@ -1,3 +1,4 @@
+import { document_d_exports } from "../types/document.js";
 //#region src/compare/content-types.d.ts
 /** How callers expect a block identifier to behave across document revisions. */
 type FolioContentIdStability = "stable" | "positional";
@@ -74,8 +75,13 @@ type FolioContentTableLocation = {
   rowSpan: number;
   paragraphIndex: number;
 };
-/** Direct paragraph alignment understood by the neutral comparison model. */
-type FolioContentParagraphAlignment = "left" | "center" | "right" | "both" | "distribute" | "mediumKashida" | "highKashida" | "lowKashida" | "thaiDistribute";
+/**
+ * Direct paragraph alignment understood by the neutral comparison model.
+ *
+ * The model's own `ST_Jc` union: a copy spelled here would refuse an alignment
+ * a parsed document carries.
+ */
+type FolioContentParagraphAlignment = document_d_exports.ParagraphAlignment;
 /** Line-height interpretation understood by the neutral comparison model. */
 type FolioContentLineSpacingRule = "auto" | "exact" | "atLeast";
 /** The complete modeled attribute set of direct paragraph indentation. */

package/dist/compare/content.js

@@ -1,5 +1,6 @@
 import { WORD_DIFF_GRANULARITIES, createWordDiffSession } from "../ai-edits/word-diff.js";
 import { paragraphIndentationEqual } from "../prosemirror/paragraphIndentation.js";
+import { PARAGRAPH_ALIGNMENT_VALUES } from "../types/documentEnumValues.js";
 import { alignFolioContentStructure, contentBlocksShareContainer, createFolioContentAlignmentWorkSession } from "./content-alignment.js";
 import { inlineFormattingSegments } from "./formatting.js";
 import { Result, TaggedError, panic } from "better-result";
@@ -67,17 +68,7 @@ const isFiniteInteger = (value) => typeof value === "number" && Number.isSafeInt
 const isFiniteNumber = (value) => typeof value === "number" && Number.isFinite(value);
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const hasRecordShape = (value) => isRecord(value);
-const PARAGRAPH_ALIGNMENTS = /* @__PURE__ */ new Set([
-	"left",
-	"center",
-	"right",
-	"both",
-	"distribute",
-	"mediumKashida",
-	"highKashida",
-	"lowKashida",
-	"thaiDistribute"
-]);
+const PARAGRAPH_ALIGNMENTS = new Set(PARAGRAPH_ALIGNMENT_VALUES);
 const validateRunFormatting = (block, side, blockIndex) => {
 	for (const [runIndex, run] of (block.previewRuns ?? []).entries()) {
 		if (run.directFormatting !== void 0 && !isRecord(run.directFormatting)) return invalidInput(side, `blocks[${String(blockIndex)}].previewRuns[${String(runIndex)}].directFormatting`, "Direct inline formatting must be an object.", blockIndex);

package/dist/compare/plan.js

@@ -178,16 +178,19 @@ const terminalCarrierIsStranded = (steps, baseBlocks) => {
 * back over the next paragraph. The applier rotates instead — the paragraph
 * the run was appended after takes the inserted mark, and the last one takes
 * the free mark — and that rotation reaches only across paragraphs. A table
-* among them stops it, and the words the target ends with have to be written
-* into the base's own last paragraph instead.
+* among them stops it, and so does removing the paragraph the rotation turns
+* on: a run appended after a paragraph that is itself deleted has no mark to
+* take. Either way the words the target ends with have to be written into the
+* base's own last paragraph instead.
 */
 const addedTerminalCarrierIsStranded = (steps, baseBlocks, targetBlocks) => {
 	const baseLast = baseBlocks.at(-1);
 	const targetLast = targetBlocks.at(-1);
 	if (baseLast === void 0 || targetLast === void 0) return false;
 	if (!steps.some((step) => step.type === "targetOnly" && step.block.id === targetLast.id)) return false;
-	const baseLastStep = steps.findIndex((step) => step.type === "pair" && step.baseBlock.id === baseLast.id || step.type === "baseOnly" && step.block.id === baseLast.id);
-	return baseLastStep === -1 || steps.slice(baseLastStep + 1).some((step) => step.type !== "targetOnly");
+	const baseLastStepIndex = steps.findIndex((step) => step.type === "pair" && step.baseBlock.id === baseLast.id || step.type === "baseOnly" && step.block.id === baseLast.id);
+	const baseLastStep = steps[baseLastStepIndex];
+	return baseLastStep === void 0 || baseLastStep.type === "baseOnly" || steps.slice(baseLastStepIndex + 1).some((step) => step.type !== "targetOnly");
 };
 const buildSteps = ({ baseSnapshot, targetSnapshot, wholeTableReplacement, workSession }) => {
 	const baseBlocks = baseSnapshot.blocks;

package/dist/compare/section-boundary-properties.js

@@ -220,8 +220,7 @@ const stageSectionBoundaryProperties = ({ state, target, originalRevisionIdSeed,
 			_sectionProperties: {
 				...update.target,
 				...propertyChanges === void 0 ? {} : { propertyChanges }
-			},
-			sectionBreakType: update.target.sectionStart ?? null
+			}
 		});
 	}
 	return {

package/dist/content-controls/checkboxDisplay.d.ts

@@ -5,7 +5,13 @@ type CheckboxDisplayContent = Extract<document_d_exports.RunContent, {
 } | {
   type: "text";
 }>;
-/** Resolve the authored checkbox state into the run payload Word expects. */
-declare const checkboxDisplayContent: (rawPropertiesXml: string | undefined, checked: boolean) => CheckboxDisplayContent;
+/**
+ * Resolve the authored checkbox state into the run payload Word expects.
+ *
+ * @param checkboxXml the preserved `w14:checkbox` element, from
+ *   `SdtProperties.preserved`. A control that carries none — one built in
+ *   code, or one whose author wrote no glyphs — gets Word's own defaults.
+ */
+declare const checkboxDisplayContent: (checkboxXml: string | undefined, checked: boolean) => CheckboxDisplayContent;
 //#endregion
 export { checkboxDisplayContent };