@stll/folio-core 0.37.5 → 0.38.0

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

@@ -9,6 +9,29 @@ declare const numberingReferenceKeysOf: (snapshot: FolioAIEditSnapshot) => reado
 declare const storyTablesOf: (snapshot: FolioAIEditSnapshot) => readonly FolioStoryTable[];
 /** @internal The immutable ProseMirror document that produced this snapshot. */
 declare const sourceDocumentOf: (snapshot: FolioAIEditSnapshot) => Node;
+/** @internal Style context that produced the snapshot's authored run properties. */
+declare const styleResolverOf: (snapshot: FolioAIEditSnapshot) => RunStyleResolver | null;
+/**
+ * Derive a comparison-only view with concrete numbering references rebound.
+ * Rebuild from the remapped source document so blocks, anchors, table nodes,
+ * and operation templates retain one canonical set of numbering references.
+ */
+declare const remapFolioAIEditSnapshotNumberingReferences: (snapshot: FolioAIEditSnapshot, numIdMap: ReadonlyMap<number, number>) => FolioAIEditSnapshot;
+/**
+ * Detach external hyperlink relationship ids before copying a story into a
+ * different package. The serializer allocates relationship ids for the
+ * receiving part; bookmark targets remain package-local and are refused.
+ */
+declare const detachFolioAIEditSnapshotExternalHyperlinks: (snapshot: FolioAIEditSnapshot) => FolioAIEditSnapshot | null;
+type RemapFolioAIEditSnapshotStyleReferencesOptions = {
+  snapshot: FolioAIEditSnapshot;
+  styleIdMap: ReadonlyMap<string, string>;
+  defaultParagraphStyleId: string | undefined;
+  importedStyleResolver: RunStyleResolver | null;
+  reconcileAuthoredFormatting?: boolean;
+};
+/** Rebind imported style identifiers while retaining the source formatting context. */
+declare const remapFolioAIEditSnapshotStyleReferences: ({ snapshot, styleIdMap, defaultParagraphStyleId, importedStyleResolver, reconcileAuthoredFormatting }: RemapFolioAIEditSnapshotStyleReferencesOptions) => FolioAIEditSnapshot;
 declare const normalizeFolioAIBlockText: (text: string) => string;
 /**
  * Whether a block carries text a reader would see.
@@ -82,4 +105,4 @@ declare const createFolioAIEditSnapshot: (doc: Node) => FolioAIEditSnapshot;
 /** @internal Use for an EditorState that owns the document's style resolver. */
 declare const createFolioAIEditSnapshotWithStyleResolver: (doc: Node, styleResolver: RunStyleResolver | null) => FolioAIEditSnapshot;
 //#endregion
-export { FolioStoryTable, createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, folioStoryTables, hashFolioAIBlockStructuralBoundaries, hashFolioAIBlockText, isFolioAIContentBlock, isHiddenTableRow, normalizeFolioAIBlockText, numberingReferenceKeysOf, projectFolioAIBlockStructuralBoundaries, sourceDocumentOf, storyTablesOf, trailingBodyBlockId };
+export { FolioStoryTable, createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, detachFolioAIEditSnapshotExternalHyperlinks, folioStoryTables, hashFolioAIBlockStructuralBoundaries, hashFolioAIBlockText, isFolioAIContentBlock, isHiddenTableRow, normalizeFolioAIBlockText, numberingReferenceKeysOf, projectFolioAIBlockStructuralBoundaries, remapFolioAIEditSnapshotNumberingReferences, remapFolioAIEditSnapshotStyleReferences, sourceDocumentOf, storyTablesOf, styleResolverOf, trailingBodyBlockId };

package/dist/ai-edits/snapshot.js

@@ -1,12 +1,17 @@
-import { expectParagraphAttrs, expectRunFormattingOverrideMarkAttrs } from "../prosemirror/attrs/index.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 { directParagraphAlignment } from "../prosemirror/paragraphAlignment.js";
+import { directParagraphIndentation } from "../prosemirror/paragraphIndentation.js";
 import { directParagraphSpacing } from "../prosemirror/paragraphSpacing.js";
+import { runFormattingInlineControlCharacter } from "../prosemirror/runFormattingInlineCarriers.js";
 import { authoredRunFormattingFromAttrs } from "../prosemirror/runFormattingProvenance.js";
+import { readAuthoredRunFormatting, reconcileRunFormattingMarks } from "../prosemirror/runFormattingReconciliation.js";
 import { paragraphRunStyleContext } from "../prosemirror/runStyleFormatting.js";
 import { deriveBlankBlockId, deriveBlockId } from "../types/block-id.js";
 import { buildCleanBlockText } from "./clean-text.js";
 import { panic } from "better-result";
+import { Fragment } from "prosemirror-model";
 import { TableMap } from "prosemirror-tables";
 //#region src/ai-edits/snapshot.ts
 const metadataBySnapshot = /* @__PURE__ */ new WeakMap();
@@ -17,6 +22,169 @@ const numberingReferenceKeysOf = (snapshot) => metadataOf(snapshot).numberingRef
 const storyTablesOf = (snapshot) => metadataOf(snapshot).storyTables;
 /** @internal The immutable ProseMirror document that produced this snapshot. */
 const sourceDocumentOf = (snapshot) => metadataOf(snapshot).sourceDocument;
+/** @internal Style context that produced the snapshot's authored run properties. */
+const styleResolverOf = (snapshot) => metadataOf(snapshot).styleResolver;
+/**
+* Derive a comparison-only view with concrete numbering references rebound.
+* Rebuild from the remapped source document so blocks, anchors, table nodes,
+* and operation templates retain one canonical set of numbering references.
+*/
+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);
+		if (remappedNumId === void 0) return node;
+		return recreateProseNodeWithParagraphPropertySource(node, { attrs: {
+			...node.attrs,
+			numPr: {
+				...numPr,
+				numId: remappedNumId
+			}
+		} });
+	};
+	const remapped = remapDocument(metadata.sourceDocument, remapNode);
+	if (remapped === metadata.sourceDocument) return snapshot;
+	return createFolioAIEditSnapshotInternal(remapped, metadata.styleResolver);
+};
+const remapDocument = (doc, remapNode) => {
+	const rewrite = (node) => {
+		if (node.isText) return remapNode(node);
+		const children = [];
+		let changed = false;
+		node.forEach((child) => {
+			const next = rewrite(child);
+			if (next !== child) changed = true;
+			children.push(next);
+		});
+		return remapNode(changed ? recreateProseNodeWithParagraphPropertySource(node, { content: Fragment.fromArray(children) }) : node);
+	};
+	return rewrite(doc);
+};
+const externalHrefCanCrossPackage = (href) => href.length > 0 && !href.startsWith("#");
+const hyperlinkCanCrossPackage = ({ href, rId }) => externalHrefCanCrossPackage(href) || href.length === 0 && !(typeof rId === "string" && rId.length > 0);
+/**
+* Detach external hyperlink relationship ids before copying a story into a
+* different package. The serializer allocates relationship ids for the
+* receiving part; bookmark targets remain package-local and are refused.
+*/
+const detachFolioAIEditSnapshotExternalHyperlinks = (snapshot) => {
+	const metadata = metadataOf(snapshot);
+	let portable = true;
+	metadata.sourceDocument.descendants((node) => {
+		const emptyHyperlinks = node.attrs["_emptyHyperlinks"];
+		if (Array.isArray(emptyHyperlinks)) {
+			for (const hyperlink of emptyHyperlinks) if (typeof hyperlink !== "object" || hyperlink === null || "anchor" in hyperlink || "rId" in hyperlink && (typeof hyperlink.href !== "string" || !externalHrefCanCrossPackage(hyperlink.href))) {
+				portable = false;
+				return false;
+			}
+		}
+		for (const mark of node.marks) {
+			if (mark.type.name !== "hyperlink") continue;
+			if (!hyperlinkCanCrossPackage(expectHyperlinkMarkAttrs(mark))) {
+				portable = false;
+				return false;
+			}
+		}
+		return true;
+	});
+	if (!portable) return null;
+	const remapNode = (node) => {
+		const emptyHyperlinks = node.attrs["_emptyHyperlinks"];
+		const attrs = Array.isArray(emptyHyperlinks) ? {
+			...node.attrs,
+			_emptyHyperlinks: emptyHyperlinks.map(({ rId: _rId, ...hyperlink }) => hyperlink)
+		} : node.attrs;
+		let marks = node.marks;
+		for (const mark of node.marks) {
+			if (mark.type.name !== "hyperlink") continue;
+			const { rId: _rId, ...hyperlink } = expectHyperlinkMarkAttrs(mark);
+			marks = marks.map((candidate) => candidate === mark ? mark.type.create(hyperlink) : candidate);
+		}
+		if (attrs === node.attrs && marks === node.marks) return node;
+		if (node.isText) return node.mark(marks);
+		return recreateProseNodeWithParagraphPropertySource(node, {
+			attrs,
+			marks
+		});
+	};
+	const remapped = remapDocument(metadata.sourceDocument, remapNode);
+	return remapped === metadata.sourceDocument ? snapshot : createFolioAIEditSnapshotInternal(remapped, metadata.styleResolver);
+};
+/** Rebind imported style identifiers while retaining the source formatting context. */
+const remapFolioAIEditSnapshotStyleReferences = ({ snapshot, styleIdMap, defaultParagraphStyleId, importedStyleResolver, reconcileAuthoredFormatting = false }) => {
+	if (defaultParagraphStyleId === void 0 && (styleIdMap.size === 0 || [...styleIdMap].every(([source, target]) => source === target))) return snapshot;
+	const metadata = metadataOf(snapshot);
+	const remapNode = (node) => {
+		const styleId = node.attrs["styleId"];
+		const remappedStyleId = typeof styleId === "string" ? styleIdMap.get(styleId) : void 0;
+		if (remappedStyleId !== void 0) return recreateProseNodeWithParagraphPropertySource(node, { attrs: {
+			...node.attrs,
+			styleId: remappedStyleId
+		} });
+		if (node.isTextblock && typeof styleId !== "string" && defaultParagraphStyleId !== void 0) return recreateProseNodeWithParagraphPropertySource(node, { attrs: {
+			...node.attrs,
+			styleId: defaultParagraphStyleId
+		} });
+		if (!node.isText) return node;
+		let marks = node.marks;
+		for (const mark of node.marks) {
+			if (mark.type.name !== "characterStyle") continue;
+			const attrs = expectCharacterStyleMarkAttrs(mark);
+			const remapped = styleIdMap.get(attrs.styleId);
+			if (remapped === void 0) continue;
+			marks = marks.map((candidate) => candidate === mark ? mark.type.create({
+				...attrs,
+				styleId: remapped
+			}) : candidate);
+		}
+		return marks === node.marks ? node : node.mark(marks);
+	};
+	const remapped = remapDocument(metadata.sourceDocument, remapNode);
+	if (remapped === metadata.sourceDocument) return snapshot;
+	if (!reconcileAuthoredFormatting) return createFolioAIEditSnapshotInternal(remapped, importedStyleResolver);
+	const rebindAuthoredInlineFormatting = (source, candidate) => {
+		if (source.childCount !== candidate.childCount) return panic("Style remapping changed the document structure");
+		if (source.isInline) {
+			if (!source.marks.some(({ type }) => type.name === "runFormattingOverride" || type.name === "characterStyle")) return candidate;
+			return candidate;
+		}
+		const sourceContext = source.type.name === "paragraph" ? paragraphRunStyleContext(source, metadata.styleResolver) : void 0;
+		const candidateContext = candidate.type.name === "paragraph" ? paragraphRunStyleContext(candidate, importedStyleResolver) : void 0;
+		const children = [];
+		let changed = false;
+		source.forEach((sourceChild, _offset, index) => {
+			const candidateChild = candidate.child(index);
+			let next = rebindAuthoredInlineFormatting(sourceChild, candidateChild);
+			if (sourceContext && candidateContext && sourceChild.isInline) {
+				if (sourceChild.marks.some(({ type }) => type.name === "runFormattingOverride" || type.name === "characterStyle")) {
+					const authoredFormatting = readAuthoredRunFormatting({
+						context: sourceContext,
+						marks: sourceChild.marks,
+						styleResolver: metadata.styleResolver
+					});
+					if (authoredFormatting.styleId !== void 0) authoredFormatting.styleId = styleIdMap.get(authoredFormatting.styleId) ?? authoredFormatting.styleId;
+					const marks = reconcileRunFormattingMarks({
+						authoredFormatting,
+						context: candidateContext,
+						node: candidateChild,
+						styleResolver: importedStyleResolver
+					});
+					next = candidateChild.isText ? candidateChild.mark(marks) : recreateProseNodeWithParagraphPropertySource(candidateChild, { marks });
+				}
+			}
+			if (next !== candidateChild) changed = true;
+			children.push(next);
+		});
+		return changed ? recreateProseNodeWithParagraphPropertySource(candidate, { content: Fragment.fromArray(children) }) : candidate;
+	};
+	const rebound = rebindAuthoredInlineFormatting(metadata.sourceDocument, remapped);
+	return createFolioAIEditSnapshotInternal(rebound, importedStyleResolver);
+};
 const normalizeFolioAIBlockText = (text) => text.replace(/\s+/gu, " ").trim();
 /**
 * Whether a block carries text a reader would see.
@@ -226,11 +394,18 @@ const createFolioAIEditSnapshotInternal = (doc, styleResolver) => {
 		const displayLabel = getDisplayLabel(node);
 		const styleId = getStyleId(node);
 		const listLevel = getListLevel(node);
+		const listReference = getListReference(node);
 		const numberingReferenceKey = getNumberingReferenceKey(node);
 		if (numberingReferenceKey) numberingReferenceKeys.add(numberingReferenceKey);
 		const directAlignment = getDirectAlignment(node);
 		const directSpacing = getDirectSpacing(node);
-		const previewRuns = getPreviewRuns(node, styleResolver);
+		const directIndentation = getDirectIndentation(node);
+		const previewRuns = getPreviewRuns({
+			node,
+			nodeFrom: pos,
+			cleanBlock,
+			styleResolver
+		});
 		const table = getTableLocation({
 			path,
 			blockIndex: index,
@@ -246,8 +421,10 @@ const createFolioAIEditSnapshotInternal = (doc, styleResolver) => {
 				...displayLabel !== void 0 && { displayLabel },
 				...styleId !== void 0 && { styleId },
 				...listLevel !== void 0 && { listLevel },
+				...listReference !== void 0 && { listReference },
 				...directAlignment !== void 0 && { directAlignment },
 				...directSpacing !== void 0 && { directSpacing },
+				...directIndentation !== void 0 && { directIndentation },
 				...previewRuns !== void 0 && { previewRuns },
 				...structuralBoundaries.length > 0 && { structuralBoundaries },
 				...table !== void 0 && { table }
@@ -280,6 +457,7 @@ const createFolioAIEditSnapshotInternal = (doc, styleResolver) => {
 	metadataBySnapshot.set(snapshot, {
 		numberingReferenceKeys: [...numberingReferenceKeys],
 		sourceDocument: doc,
+		styleResolver,
 		storyTables: tables
 	});
 	return snapshot;
@@ -314,6 +492,16 @@ const getListLevel = (node) => {
 	const { ilvl } = numPr;
 	return typeof ilvl === "number" && Number.isInteger(ilvl) && ilvl >= 0 ? ilvl : 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
+	} : void 0;
+};
 const getNumberingReferenceKey = (node) => {
 	const numPr = node.attrs["numPr"];
 	if (typeof numPr !== "object" || numPr === null || !("numId" in numPr)) return null;
@@ -331,17 +519,26 @@ const getStyleId = (node) => {
 const getDirectAlignment = (node) => directParagraphAlignment(expectParagraphAttrs(node));
 /** Read only authored `w:spacing`, never effective spacing resolved from a style. */
 const getDirectSpacing = (node) => directParagraphSpacing(expectParagraphAttrs(node));
+/** Read only authored `w:ind`, never effective indentation resolved from a style. */
+const getDirectIndentation = (node) => directParagraphIndentation(expectParagraphAttrs(node));
 const DELETION_MARK = "deletion";
 const HIDDEN_MARK = "hidden";
 const RUN_FORMATTING_OVERRIDE_MARK = "runFormattingOverride";
 const CHARACTER_STYLE_MARK = "characterStyle";
-const getPreviewRuns = (node, styleResolver) => {
+const getPreviewRuns = ({ node, nodeFrom, cleanBlock, styleResolver }) => {
 	const runs = [];
 	const defaultStyle = getDefaultPreviewRunStyle(node);
 	let paragraphStyleContext;
-	node.descendants((child) => {
-		if (!child.isText || child.text === void 0) return true;
+	let cleanOffset = 0;
+	node.descendants((child, relativePosition) => {
+		const text = child.isText ? child.text : runFormattingInlineControlCharacter(child);
+		if (text === void 0 || text === null) return true;
 		if (child.marks.some((mark) => mark.type.name === DELETION_MARK || mark.type.name === HIDDEN_MARK)) return false;
+		const start = nodeFrom + 1 + relativePosition;
+		while ((cleanBlock.offsets[cleanOffset] ?? Number.POSITIVE_INFINITY) < start) cleanOffset++;
+		const endOffset = cleanOffset + text.length - 1;
+		if (cleanBlock.offsets[cleanOffset] !== start || cleanBlock.offsets[endOffset] !== start + text.length - 1) return false;
+		cleanOffset += text.length;
 		const style = getPreviewRunStyle(child.marks, defaultStyle);
 		const hasAuthorshipCarrier = child.marks.some(({ type }) => type.name === RUN_FORMATTING_OVERRIDE_MARK || type.name === CHARACTER_STYLE_MARK);
 		let directFormatting;
@@ -359,11 +556,11 @@ const getPreviewRuns = (node, styleResolver) => {
 		}
 		const previous = runs.at(-1);
 		if (previous && samePreviewRunStyle(previous, style) && sameDirectFormatting(previous.directFormatting, directFormatting)) {
-			previous.text += child.text;
+			previous.text += text;
 			return false;
 		}
 		runs.push({
-			text: child.text,
+			text,
 			...style,
 			...!isEmptyPreviewRunStyle(directFormatting) && { directFormatting }
 		});
@@ -504,6 +701,6 @@ const getColorFromAttrs = (attrs) => {
 const samePreviewRunStyle = (run, style) => run.bold === style.bold && run.italic === style.italic && run.underline === style.underline && run.strike === style.strike && run.fontFamily === style.fontFamily && run.fontSizePt === style.fontSizePt && run.color === style.color;
 const isEmptyPreviewRunStyle = ({ bold, italic, underline, strike, fontFamily, fontSizePt, color }) => bold === void 0 && italic === void 0 && underline === void 0 && strike === void 0 && fontFamily === void 0 && fontSizePt === void 0 && color === void 0;
 const sameDirectFormatting = (left, right) => left === void 0 && isEmptyPreviewRunStyle(right) || left !== void 0 && left.bold === right.bold && left.italic === right.italic && left.underline === right.underline && left.strike === right.strike && left.fontFamily === right.fontFamily && left.fontSizePt === right.fontSizePt && left.color === right.color;
-const isUnstyledPreviewRun = ({ bold, italic, underline, strike, fontFamily, fontSizePt, color }) => bold === void 0 && italic === void 0 && underline === void 0 && strike === void 0 && fontFamily === void 0 && fontSizePt === void 0 && color === void 0;
+const isUnstyledPreviewRun = ({ directFormatting, ...style }) => isEmptyPreviewRunStyle(style) && (directFormatting === void 0 || isEmptyPreviewRunStyle(directFormatting));
 //#endregion
-export { createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, folioStoryTables, hashFolioAIBlockStructuralBoundaries, hashFolioAIBlockText, isFolioAIContentBlock, isHiddenTableRow, normalizeFolioAIBlockText, numberingReferenceKeysOf, projectFolioAIBlockStructuralBoundaries, sourceDocumentOf, storyTablesOf, trailingBodyBlockId };
+export { createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, detachFolioAIEditSnapshotExternalHyperlinks, folioStoryTables, hashFolioAIBlockStructuralBoundaries, hashFolioAIBlockText, isFolioAIContentBlock, isHiddenTableRow, normalizeFolioAIBlockText, numberingReferenceKeysOf, projectFolioAIBlockStructuralBoundaries, remapFolioAIEditSnapshotNumberingReferences, remapFolioAIEditSnapshotStyleReferences, sourceDocumentOf, storyTablesOf, styleResolverOf, trailingBodyBlockId };

package/dist/ai-edits/table-geometry.d.ts

@@ -2,13 +2,6 @@ import { FolioStoryTable } from "./snapshot.js";
 import { Transaction } from "prosemirror-state";
 import { Node } from "prosemirror-model";
 //#region src/ai-edits/table-geometry.d.ts
-/**
- * One line per table, in the document order tables are numbered in: the
- * table's own properties, then each row's and each cell's. Nested tables get
- * their own lines rather than being folded into their parent's, so a
- * difference names the table it is in.
- */
-declare const projectTableGeometry: (tables: readonly FolioStoryTable[]) => string[];
 /** Where a cell sits: which table, which row of it, which cell of that row. */
 type TableCellCoordinate = {
   tableIndex: number;
@@ -39,6 +32,13 @@ type MatchTableGeometryResult = {
   /** Tables, rows and cells whose properties the match moved. */
   matched: number;
 };
+/**
+ * One line per table, in the document order tables are numbered in: the
+ * table's own properties, then each row's and each cell's. Nested tables get
+ * their own lines rather than being folded into their parent's, so a
+ * difference names the table it is in.
+ */
+declare const projectTableGeometry: (tables: readonly FolioStoryTable[]) => string[];
 /**
  * Copy a paired table's, row's and cell's properties from the document it was
  * compared against, recording the previous set so a reject restores it.

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

@@ -36,31 +36,6 @@ const scopedAttrs = (attrs, keys) => {
 	}
 	return scoped;
 };
-const cellProjection = (cell) => canonicalJson({
-	colspan: cell.attrs["colspan"],
-	rowspan: cell.attrs["rowspan"],
-	...scopedAttrs(cell.attrs, CELL_SCOPED_ATTRS)
-});
-const rowProjection = (row) => {
-	const cells = [];
-	row.forEach((cell) => {
-		cells.push(cellProjection(cell));
-	});
-	return `${canonicalJson(scopedAttrs(row.attrs, ROW_SCOPED_ATTRS))}|${cells.join("|")}`;
-};
-/**
-* One line per table, in the document order tables are numbered in: the
-* table's own properties, then each row's and each cell's. Nested tables get
-* their own lines rather than being folded into their parent's, so a
-* difference names the table it is in.
-*/
-const projectTableGeometry = (tables) => tables.map(({ node }) => {
-	const rows = [];
-	node.forEach((row) => {
-		rows.push(rowProjection(row));
-	});
-	return `${canonicalJson(scopedAttrs(node.attrs, TABLE_SCOPED_ATTRS))}#${rows.join("#")}`;
-});
 const childPositions = (node, start) => {
 	const positions = [];
 	let offset = start + 1;
@@ -99,6 +74,7 @@ const effectiveAttrs = (node) => ({
 });
 const TABLE_SCOPE = {
 	keys: TABLE_SCOPED_ATTRS,
+	signatureOf: (node) => formattingProjection(tableAttrsToFormatting(effectiveAttrs(node))),
 	formattingOf: (node) => tableAttrsToFormatting(effectiveAttrs(node)),
 	rejectPatch: (previousFormatting) => tableRejectAttrPatch(previousFormatting),
 	changeAttr: "tblPrChange",
@@ -106,6 +82,7 @@ const TABLE_SCOPE = {
 };
 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",
@@ -113,6 +90,7 @@ const ROW_SCOPE = {
 };
 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",
@@ -120,6 +98,43 @@ const CELL_SCOPE = {
 };
 const scopedValues = (attrs, keys) => canonicalJson(scopedAttrs(attrs, keys));
 /**
+* `sourceXml` and `gridSourceXml` record byte-exact captures; they are
+* deliberately excluded from a tracked formatting decision. Every other
+* parsed property is serializer-supported and belongs in the complete old
+* property set Word stores in a property-change element.
+*/
+const semanticFormatting = (formatting) => {
+	if (!formatting) return {};
+	const { sourceXml: _sourceXml, gridSourceXml: _gridSourceXml, ...properties } = formatting;
+	return properties;
+};
+const formattingProjection = (formatting) => canonicalJson(semanticFormatting(formatting));
+const cellProjection = (cell) => canonicalJson({
+	colspan: cell.attrs["colspan"],
+	rowspan: cell.attrs["rowspan"],
+	...scopedAttrs(cell.attrs, CELL_SCOPED_ATTRS)
+});
+const rowProjection = (row) => {
+	const cells = [];
+	row.forEach((cell) => {
+		cells.push(cellProjection(cell));
+	});
+	return `${canonicalJson(scopedAttrs(row.attrs, ROW_SCOPED_ATTRS))}|${cells.join("|")}`;
+};
+/**
+* One line per table, in the document order tables are numbered in: the
+* table's own properties, then each row's and each cell's. Nested tables get
+* their own lines rather than being folded into their parent's, so a
+* difference names the table it is in.
+*/
+const projectTableGeometry = (tables) => tables.map(({ node }) => {
+	const rows = [];
+	node.forEach((row) => {
+		rows.push(rowProjection(row));
+	});
+	return `${formattingProjection(TABLE_SCOPE.formattingOf(node))}#${rows.join("#")}`;
+});
+/**
 * One node's properties, matched to the node it was paired with, or `null`
 * when the difference cannot be recorded.
 *
@@ -136,14 +151,15 @@ const scopedValues = (attrs, keys) => canonicalJson(scopedAttrs(attrs, keys));
 */
 const propertyChangeFor = (base, target, position, scope) => {
 	const live = scopedValues(base.attrs, scope.keys);
-	if (live === scopedValues(target.attrs, scope.keys)) return null;
 	const previousFormatting = scope.formattingOf(base);
+	const targetFormatting = scope.formattingOf(target);
+	if (scope.signatureOf(base) === scope.signatureOf(target)) return null;
 	if (scopedValues(scope.rejectPatch(previousFormatting, previousFormatting), scope.keys) !== live) return null;
 	return {
 		position,
 		attrs: {
 			...scopedAttrs(target.attrs, scope.keys),
-			[ORIGINAL_FORMATTING]: scope.formattingOf(target) ?? null
+			[ORIGINAL_FORMATTING]: targetFormatting ?? null
 		},
 		changeAttr: scope.changeAttr,
 		changeType: scope.changeType,

package/dist/ai-edits/table-template.d.ts

@@ -3,6 +3,7 @@ import { Node, Schema } from "prosemirror-model";
 //#region src/ai-edits/table-template.d.ts
 /** The node an operation should place, by the id of the operation placing it. */
 type FolioTableTemplates = ReadonlyMap<string, Node>;
+type HyperlinkPortability = "strict" | "rebind-external";
 /**
  * Whether a target table can cross into the base package without semantic
  * content being stripped from its template.
@@ -12,7 +13,7 @@ type FolioTableTemplates = ReadonlyMap<string, Node>;
  * bookmarks and unresolved revision metadata are not portable and therefore
  * make a replacement unsafe. Callers can retain their granular plan instead.
  */
-declare const tableTemplateCanCrossPackageLosslessly: (template: Node) => boolean;
+declare const tableTemplateCanCrossPackageLosslessly: (template: Node, hyperlinkPortability?: HyperlinkPortability) => boolean;
 /**
  * A structural tracked change on a table row.
  *

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

@@ -1,5 +1,5 @@
 import { cloneTableCellsWithParagraphPropertyCaptures, decodeTableCellParagraphSourcePayload, recreateProseNodeWithDetachedParagraphPropertySource } from "../docx/paragraphPropertySource.js";
-import { expectTableCellAttrs } from "../prosemirror/attrs/index.js";
+import { expectHyperlinkMarkAttrs, expectTableCellAttrs } from "../prosemirror/attrs/index.js";
 import { stripBlockIdentityAttrs } from "./block-identity.js";
 import { Fragment } from "prosemirror-model";
 //#region src/ai-edits/table-template.ts
@@ -50,6 +50,12 @@ const PACKAGE_BOUND_MARK_NAMES = /* @__PURE__ */ new Set([
 	"deletion",
 	"runPropertyChange"
 ]);
+const canRebindExternalHyperlink = (mark) => {
+	if (mark.type.name !== "hyperlink") return false;
+	const { href, rId } = expectHyperlinkMarkAttrs(mark);
+	const hasRelationshipId = typeof rId === "string" && rId.length > 0;
+	return href.length > 0 && !href.startsWith("#") || href.length === 0 && !hasRelationshipId;
+};
 /**
 * Paragraph attrs cleared on a copied paragraph: its identity, the bookmarks
 * and empty hyperlinks that name package-scoped ids, the section it ended, and
@@ -98,10 +104,10 @@ const losesAuthoredAttrs = (node) => clearedAttrsOf(node).some((name) => hasAuth
 * bookmarks and unresolved revision metadata are not portable and therefore
 * make a replacement unsafe. Callers can retain their granular plan instead.
 */
-const tableTemplateCanCrossPackageLosslessly = (template) => {
+const tableTemplateCanCrossPackageLosslessly = (template, hyperlinkPortability = "strict") => {
 	let portable = true;
 	const inspect = (node) => {
-		if (PACKAGE_BOUND_NODE_NAMES.has(node.type.name) || node.marks.some(({ type }) => PACKAGE_BOUND_MARK_NAMES.has(type.name)) || losesAuthoredAttrs(node)) {
+		if (PACKAGE_BOUND_NODE_NAMES.has(node.type.name) || node.marks.some((mark) => PACKAGE_BOUND_MARK_NAMES.has(mark.type.name) && !(hyperlinkPortability === "rebind-external" && canRebindExternalHyperlink(mark))) || losesAuthoredAttrs(node)) {
 			portable = false;
 			return false;
 		}

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

@@ -1,5 +1,5 @@
 import { document_d_exports } from "../types/document.js";
-import { FolioContentBlock, FolioContentInlineBooleanProperty, FolioContentInlineFormatting, FolioContentInlineFormattingPatch, FolioContentParagraphKind, FolioContentParagraphSpacing, FolioContentRun, FolioContentSnapshot, FolioContentTableLocation } from "../compare/content-types.js";
+import { FolioContentBlock, FolioContentInlineBooleanProperty, FolioContentInlineFormatting, FolioContentInlineFormattingPatch, FolioContentListReference, FolioContentParagraphIndentation, FolioContentParagraphKind, FolioContentParagraphSpacing, FolioContentRun, FolioContentSnapshot, FolioContentTableLocation } from "../compare/content-types.js";
 //#region src/ai-edits/types.d.ts
 type FolioAIBlockKind = FolioContentParagraphKind;
 /** Boolean run properties supported by snapshots and range-formatting mutations. */
@@ -40,6 +40,9 @@ type FolioAIBlock = FolioContentBlock<FolioAIBlockKind> & {
  * an explicit zero or false value.
  */
 type FolioAIParagraphSpacing = FolioContentParagraphSpacing;
+/** The complete modeled attribute set of one direct `w:pPr/w:ind` child. */
+type FolioAIParagraphIndentation = FolioContentParagraphIndentation;
+type FolioAIListReference = FolioContentListReference;
 /**
  * The paragraph properties an operation may set. A subset of `w:pPrChange`'s
  * scope: properties a comparison can see in a block projection and an agent
@@ -49,14 +52,18 @@ type FolioAIBlockParagraphProperties = {
   /** `w:pStyle`. `null` clears the style back to the default. */
   styleId?: string | null;
   /**
-   * `w:numPr/w:ilvl`, zero-based. `null` removes `w:numPr` altogether: the
-   * paragraph stops being a list item rather than moving to another level.
+   * `w:numPr/w:ilvl`, zero-based. `null` removes numbering unless `numbering`
+   * supplies a concrete instance; together they retain that instance without
+   * an authored level.
    */
   listLevel?: number | null;
+  numbering?: FolioAIListReference | null;
   /** Direct `w:jc`. `null` clears the override and restores style inheritance. */
   alignment?: document_d_exports.ParagraphAlignment | null;
   /** Direct `w:spacing` attributes. `null` removes the whole direct child. */
   spacing?: FolioAIParagraphSpacing | null;
+  /** Direct `w:ind` attributes. `null` removes the whole direct child. */
+  indentation?: FolioAIParagraphIndentation | null;
 };
 /**
  * Every paragraph of one story, blank ones included.
@@ -203,12 +210,13 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & {
   type: "insertAfterBlock" | "insertBeforeBlock";
   blockId: string;
   /**
-   * The paragraph text to insert. A line break splits `text` into
-   * consecutive paragraphs at the same anchor instead of becoming
-   * literal newlines inside one paragraph: only the first paragraph
-   * gets `styleId` / `alignment` / `inheritFormatting`, later ones use body
-   * formatting. Blank lines are dropped. Reported as a
-   * `splitMultilineText` normalization when it happens.
+   * The paragraph text to insert. With the default `lineBreakMode:
+   * "paragraph"`, a line break splits `text` into consecutive
+   * paragraphs at the same anchor: only the first paragraph gets
+   * `styleId` / `alignment` / `inheritFormatting`, later ones use
+   * body formatting. Blank lines are dropped and reported as a
+   * `splitMultilineText` normalization. `"inline"` retains the
+   * control inside one paragraph.
    *
    * `""` inserts a BLANK paragraph, and is a real edit: adding an empty
    * line is a change a reader sees, and a document that has one where
@@ -216,6 +224,11 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & {
    * with a tracked paragraph mark, so rejecting closes it away.
    */
   text: string;
+  /**
+   * `"paragraph"` (the default) splits newlines into consecutive blocks.
+   * `"inline"` retains tabs and hard breaks inside this inserted block.
+   */
+  lineBreakMode?: "paragraph" | "inline";
   inheritFormatting?: boolean;
   /**
    * Links this insertion to the deletion that carries the same
@@ -229,6 +242,13 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & {
    * new page. Use for explicit page-break inserts.
    */
   pageBreakBefore?: boolean;
+  /**
+   * Insert one standalone authored `<w:br w:type="page"/>` carrier.
+   * This differs from `pageBreakBefore`, which is a paragraph property.
+   */
+  hardPageBreak?: {
+    clear?: document_d_exports.BreakContent["clear"];
+  };
   /**
    * Override the paragraph `styleId` attr of the inserted
    * block (e.g. `ClauseHeading1`). When omitted the inserted
@@ -242,10 +262,11 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & {
    * anchor's `w:numId`. Without it the inserted paragraph takes the
    * anchor's level, which is the wrong one whenever the new item sits
    * beside a list item at a different depth. `null` gives it no
-   * numbering at all — an ordinary paragraph next to a list item, which
-   * inheritance alone cannot say.
+   * numbering unless `numbering` supplies a concrete instance; together
+   * they retain that instance without an authored level.
    */
   listLevel?: number | null;
+  numbering?: FolioAIListReference | null;
   /**
    * Direct `w:jc` for the inserted block. `null` clears alignment copied
    * from the anchor and lets the inserted paragraph's style decide.
@@ -256,6 +277,8 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & {
    * copied from the anchor and lets the inserted paragraph's style decide.
    */
   spacing?: FolioAIParagraphSpacing | null;
+  /** Direct `w:ind` for the inserted block. `null` clears copied indentation. */
+  indentation?: FolioAIParagraphIndentation | null;
   comment?: FolioAIComment;
 } | {
   id: string;
@@ -545,9 +568,8 @@ type FolioAIEditSkippedOperation = {
  */
 type FolioAIEditNormalization =
 /**
- * A line-break in `insertAfterBlock` / `insertBeforeBlock`'s `text` cannot
- * become one paragraph with an embedded break (Word paragraphs are single
- * lines); the applier split it into one paragraph per non-blank line.
+ * A line-break in paragraph-mode `insertAfterBlock` /
+ * `insertBeforeBlock` text was split into one paragraph per non-blank line.
  */
 {
   id: string;
@@ -574,4 +596,4 @@ type FolioAIEditApplyResult = {
   normalizations?: FolioAIEditNormalization[];
 };
 //#endregion
-export { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockParagraphProperties, FolioAIBlockPreviewRun, FolioAIBlockStructuralBoundary, FolioAIBlockTableLocation, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditNormalization, FolioAIEditNormalizationCode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineBooleanProperty, FolioAIInlineFormatting, FolioAIInlineFormattingPatch, FolioAIParagraphSpacing, FolioAISignatureParty, FolioAITextRangeHandle, FolioDocumentNavigationTarget, FolioDocumentOutline, FolioDocumentOutlineEntry, FolioDocumentSection, FolioDocumentSectionHandle, FolioDocumentSectionReadResult };
+export { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockParagraphProperties, FolioAIBlockPreviewRun, FolioAIBlockStructuralBoundary, FolioAIBlockTableLocation, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditNormalization, FolioAIEditNormalizationCode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineBooleanProperty, FolioAIInlineFormatting, FolioAIInlineFormattingPatch, FolioAIListReference, FolioAIParagraphIndentation, FolioAIParagraphSpacing, FolioAISignatureParty, FolioAITextRangeHandle, FolioDocumentNavigationTarget, FolioDocumentOutline, FolioDocumentOutlineEntry, FolioDocumentSection, FolioDocumentSectionHandle, FolioDocumentSectionReadResult };