@stll/folio-core 0.58.4 → 0.59.0

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

@@ -60,8 +60,8 @@ type ApplyFolioAIEditOperationsOptions = {
   tableTemplates?: FolioTableTemplates;
   /** What a replacement does with a background the text it replaces carries. */
   replacementBackground?: FolioReplacementBackground;
-  /** What an operation naming a paragraph style the document does not define does. */
-  undefinedStyles?: FolioUndefinedStylePolicy;
+  /** Policy for undefined style and numbering references; see FolioUndefinedReferencePolicy. */
+  undefinedReferences: FolioUndefinedReferencePolicy;
 };
 /**
  * How an apply batch cuts the redline for a replacement. Word-level by
@@ -88,17 +88,16 @@ type FolioWordDiffOptions = {
  */
 type FolioReplacementBackground = "clear" | "keep";
 /**
- * What an operation naming a paragraph style the document does not define —
- * no `w:style` with that id, or one of another type — does.
+ * How operations handle style and numbering references the document does not define.
  *
- * `refuse` is the default: such a `w:pStyle` confers no formatting, so the
- * paragraph would keep its body look while the operation reported a restyle;
- * the operation is skipped with `missingStyle`. `keep` is for a caller that
- * copies references another document already holds — a comparison or redline
- * reproducing the revised document, which may itself reference a style it
- * never defines — and writes them as given.
+ * Editing callers explicitly select `refuse`: an undefined reference would
+ * report a formatting edit without changing its appearance. Missing references are skipped with
+ * `missingStyle` or `missingNumbering`.
+ * Comparison and redline use `keep` for unknown source styles; their import
+ * boundary clears destination style collisions with warnings before application.
+ * The parser already normalizes undefined source numbering to none.
  */
-type FolioUndefinedStylePolicy = "refuse" | "keep";
+type FolioUndefinedReferencePolicy = "refuse" | "keep";
 /**
  * An apply result plus where the batch left the revision-id counter.
  *
@@ -129,4 +128,4 @@ declare const previewFolioAIEditOperationsWithResult: (options: ApplyFolioAIEdit
   commentIds: readonly number[];
 };
 //#endregion
-export { FolioAIEditApplyOutcome, FolioAIEditView, FolioReplacementBackground, FolioRevisionStamp, FolioUndefinedStylePolicy, FolioWordDiffOptions, applyFolioAIEditOperations, previewFolioAIEditOperations, previewFolioAIEditOperationsWithResult };
+export { FolioAIEditApplyOutcome, FolioAIEditView, FolioReplacementBackground, FolioRevisionStamp, FolioUndefinedReferencePolicy, FolioWordDiffOptions, applyFolioAIEditOperations, previewFolioAIEditOperations, previewFolioAIEditOperationsWithResult };

package/dist/ai-edits/apply.js

@@ -1,9 +1,9 @@
-import { paragraphNumberingReference, paragraphNumberingReferenceId } from "../docx/numberingReference.js";
 import { formattingEquals } from "../docx/runConsolidator.js";
 import { isStyleSourcedParagraphNumbering } from "../internal/paragraphFormattingSerialization.js";
 import { addTrackedDeletionMark } from "../prosemirror/addTrackedDeletionMark.js";
 import { deleteTextBoxesAnchoredAt, droppedTextBoxAnchorIds, endOfParagraphWithItsTextBoxes, gatherTextBoxesAfterParagraph, textBoxAnchorIdOf, textBoxAnchorIdsBetween } from "../prosemirror/anchoredTextBoxes.js";
 import { expectParagraphAttrs, expectRunPropertyChangeMarkAttrs, expectTableRowAttrs, mergeParagraphAttrs } from "../prosemirror/attrs/index.js";
+import { paragraphJoinAfter } from "../prosemirror/commands/paragraphBookmarkJoin.js";
 import { hasSerializableParagraphPropertyChange, paragraphPropertiesSnapshot } from "../prosemirror/commands/propertyChangeScope.js";
 import { resolveParagraphChangeAttrs } from "../prosemirror/commands/resolveParagraphProperties.js";
 import { addedBreakCarrierBefore, finalParagraphsOf, paragraphEndsItsContainer } from "../prosemirror/containerFinalParagraph.js";
@@ -13,7 +13,7 @@ import { requestDeterministicParaIds } from "../prosemirror/extensions/features/
 import { markStructuralChange } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
 import "../prosemirror/extensions/nodes/TextBoxAnchorExtension.js";
 import { CLEARED_LIST_RENDERING_ATTRS } from "../prosemirror/listMarker.js";
-import { paragraphNumberingAttr, readParagraphNumberingAttr, removedNumberingAttr } from "../prosemirror/numberingAttr.js";
+import { effectiveParagraphNumbering, paragraphNumberingAttr, paragraphNumberingSourcesFromBoundary, readParagraphNumberingAttr, removedNumberingAttr } from "../prosemirror/numberingAttr.js";
 import { directParagraphAlignment } from "../prosemirror/paragraphAlignment.js";
 import { styleResolvedParagraphFormatting } from "../prosemirror/paragraphFormattingProvenance.js";
 import { directParagraphIndentation, paragraphIndentationAttrPatch, paragraphIndentationEqual, paragraphIndentationFromFormatting, withDirectParagraphIndentation } from "../prosemirror/paragraphIndentation.js";
@@ -41,8 +41,9 @@ import { describeCharacterSplit } from "./character-boundaries.js";
 import { buildCleanBlockText, resolveCleanTextRange } from "./clean-text.js";
 import { hasInlineEmphasis, parseInlineEmphasisRuns, stripInlineEmphasisMarkers } from "./inline-emphasis.js";
 import { applyTextChanges, changesFromSegments, keepAtomicSpans, planTextChanges, widenChangesToAtomicSpans } from "./minimal-replacement.js";
-import { concreteListReference, resolveNewListOperations } from "./newListNumbering.js";
+import { resolveNewListOperations } from "./newListNumbering.js";
 import { cutsIntoNoteReference, noteReferenceEditsAllowed, noteReferenceOf, noteReferenceSpansWithin, planChangesAroundNoteReferences, segmentsAroundNoteReferences } from "./note-references.js";
+import { classifyResourceReference } from "./referenceClassification.js";
 import { separateRevisionStretches } from "./revisionStretches.js";
 import { collectNoteReferenceLabels, hashFolioAIBlockStructuralBoundaries, hashFolioAIBlockText, isHiddenTableRow, normalizeFolioAIBlockText } from "./snapshot.js";
 import { isEmptyTableCell, mergeTableRectangle, mergeTrackedVerticalTableCells, splitTableRectangle, splitTrackedVerticalTableCell } from "./table-cell-mutations.js";
@@ -54,7 +55,7 @@ import { wordDiffSessionFromOptions } from "./word-diff.js";
 import { panic } from "better-result";
 import { Fragment, Mark } from "prosemirror-model";
 import { TableMap } from "prosemirror-tables";
-import { canJoin, canSplit } from "prosemirror-transform";
+import { canSplit } from "prosemirror-transform";
 //#region src/ai-edits/apply.ts
 const coarseWordDiff = (before, after) => {
 	if (before === after) return before.length === 0 ? [] : [{
@@ -179,6 +180,28 @@ const resolveReplaceBlockImpact = ({ changesText, changesStyle }) => {
 	if (changesStyle) return "style";
 	return panic("Cannot resolve a replaceBlock that changes neither text nor style");
 };
+/** Project exact authored numbering while deriving rendering from its inherited tier. */
+const statedNumberingAttrPatch = ({ attrs, stated, fromStyle, numbering }) => {
+	const numPr = stated.kind === "inherit" ? void 0 : paragraphNumberingAttr(stated);
+	const numPrFromStyle = numPr?.kind === "reference" || numPr?.kind === "none" ? void 0 : fromStyle;
+	const projected = { ...attrs };
+	if (numPr === void 0) Reflect.deleteProperty(projected, "numPr");
+	else projected.numPr = numPr;
+	if (numPrFromStyle === void 0) Reflect.deleteProperty(projected, "numPrFromStyle");
+	else projected.numPrFromStyle = numPrFromStyle;
+	const effective = effectiveParagraphNumbering(paragraphNumberingSourcesFromBoundary({
+		numPr: projected.numPr,
+		numPrFromStyle: projected.numPrFromStyle
+	}));
+	return {
+		...effective?.kind === "reference" ? listLevelAttrPatch(projected, effective.ilvl ?? 0, numbering) : {
+			...listLevelIndentRemovalPatch(attrs, numbering),
+			...CLEARED_LIST_RENDERING_ATTRS
+		},
+		numPr: numPr ?? null,
+		numPrFromStyle: numPrFromStyle ?? null
+	};
+};
 const paragraphPropertiesPatch = ({ node, properties, resolvedFormattingFromStyle, numbering = null }) => {
 	const attrs = expectParagraphAttrs(node);
 	const currentDirectAlignment = directParagraphAlignment(attrs);
@@ -225,51 +248,19 @@ const paragraphPropertiesPatch = ({ node, properties, resolvedFormattingFromStyl
 		patch["outlineLevel"] = directOutlineLevel ?? resolvedFormattingFromStyle?.outlineLevel ?? null;
 		originalFormattingChanged = true;
 	}
-	const numPrFromStyle = styleChanged ? readParagraphNumberingAttr(patch["numPrFromStyle"]) : attrs.numPrFromStyle;
-	if (properties.numbering !== void 0) if (properties.numbering === null) {
-		Object.assign(patch, listLevelIndentRemovalPatch(mergeParagraphAttrs(node, {
-			...attrs,
-			_styleResolvedFormatting: styleResolvedParagraphFormatting(resolvedFormattingFromStyle)
-		}), numbering));
-		patch["numPr"] = removedNumberingAttr(numPrFromStyle);
-		Object.assign(patch, CLEARED_LIST_RENDERING_ATTRS);
-	} else {
-		const listReference = concreteListReference(properties.numbering);
-		Object.assign(patch, listLevelAttrPatch(mergeParagraphAttrs(node, {
-			...attrs,
-			_styleResolvedFormatting: styleResolvedParagraphFormatting(resolvedFormattingFromStyle)
-		}), {
-			numId: listReference.numId,
-			ilvl: listReference.level
-		}, numbering));
-		if (properties.listLevel === null) {
-			patch["numPr"] = paragraphNumberingAttr(paragraphNumberingReference({ numId: listReference.numId }));
-			patch["numPrFromStyle"] = null;
-		}
-	}
-	else if (properties.listLevel !== void 0) if (properties.listLevel === null) {
-		Object.assign(patch, listLevelIndentRemovalPatch(mergeParagraphAttrs(node, {
-			...attrs,
-			_styleResolvedFormatting: styleResolvedParagraphFormatting(resolvedFormattingFromStyle)
-		}), numbering));
-		patch["numPr"] = removedNumberingAttr(numPrFromStyle);
-		Object.assign(patch, CLEARED_LIST_RENDERING_ATTRS);
-	} else {
-		const numId = paragraphNumberingReferenceId(readParagraphNumberingAttr(styleChanged ? patch["numPr"] : node.attrs["numPr"]) ?? void 0);
-		if (numId === void 0) {
-			patch["numPr"] = paragraphNumberingAttr({
-				kind: "levelOnly",
-				ilvl: properties.listLevel
-			});
-			Object.assign(patch, CLEARED_LIST_RENDERING_ATTRS);
-		} else Object.assign(patch, listLevelAttrPatch(mergeParagraphAttrs(node, {
+	let numPrFromStyle = attrs.numPrFromStyle;
+	if (resolvedFormattingFromStyle?.numPr !== void 0) numPrFromStyle = paragraphNumberingAttr(resolvedFormattingFromStyle.numPr);
+	else if (styleChanged) numPrFromStyle = readParagraphNumberingAttr(patch["numPrFromStyle"]) ?? void 0;
+	if (properties.numbering !== void 0) Object.assign(patch, statedNumberingAttrPatch({
+		attrs: mergeParagraphAttrs(node, {
 			...attrs,
+			...patch,
 			_styleResolvedFormatting: styleResolvedParagraphFormatting(resolvedFormattingFromStyle)
-		}), {
-			numId,
-			ilvl: properties.listLevel
-		}, numbering));
-	}
+		}),
+		stated: properties.numbering,
+		fromStyle: numPrFromStyle,
+		numbering
+	}));
 	if (properties.alignment !== void 0 && (styleChanged || (currentDirectAlignment ?? null) !== properties.alignment)) {
 		originalFormatting ??= {};
 		if (properties.alignment === null) Reflect.deleteProperty(originalFormatting, "alignment");
@@ -297,14 +288,22 @@ const paragraphPropertiesPatch = ({ node, properties, resolvedFormattingFromStyl
 		originalFormattingChanged = true;
 	}
 	if (originalFormattingChanged) patch["_originalFormatting"] = originalFormatting && Object.keys(originalFormatting).length > 0 ? originalFormatting : null;
-	if (styleChanged || properties.numbering !== void 0 || properties.listLevel !== void 0 || properties.indentation !== void 0) {
+	if (styleChanged || properties.numbering !== void 0 || properties.indentation !== void 0) {
 		const nextNumbering = patch["numPr"] === void 0 ? attrs.numPr : readParagraphNumberingAttr(patch["numPr"]);
-		if (nextNumbering?.kind === "reference") {
+		const nextSources = {
+			numPr: nextNumbering,
+			numPrFromStyle: patch["numPrFromStyle"] === void 0 ? numPrFromStyle : readParagraphNumberingAttr(patch["numPrFromStyle"])
+		};
+		const effectiveNumbering = effectiveParagraphNumbering(paragraphNumberingSourcesFromBoundary({
+			numPr: nextSources.numPr,
+			numPrFromStyle: nextSources.numPrFromStyle
+		}));
+		if (effectiveNumbering?.kind === "reference") {
 			const direct = properties.indentation === void 0 ? currentDirectIndentation : properties.indentation ?? void 0;
 			Object.assign(patch, listLevelAttrPatch(mergeParagraphAttrs(node, {
-				numPr: nextNumbering,
+				numPr: nextNumbering ?? void 0,
 				_styleResolvedFormatting: styleResolvedParagraphFormatting(resolvedFormattingFromStyle),
-				numPrFromStyle: numPrFromStyle ?? void 0,
+				numPrFromStyle: nextSources.numPrFromStyle ?? void 0,
 				listImplicitChildLevelAdvances: attrs.listImplicitChildLevelAdvances,
 				_originalFormatting: withDirectParagraphIndentation(originalFormatting, direct),
 				_resolvedFormatting: withDirectParagraphIndentation(styleChanged ? styleResolvedParagraphFormatting(resolvedFormattingFromStyle) : attrs._resolvedFormatting, resolvedIndentationFromStyle),
@@ -312,11 +311,9 @@ const paragraphPropertiesPatch = ({ node, properties, resolvedFormattingFromStyl
 				indentRight: direct?.indentRight ?? resolvedFormattingFromStyle?.indentRight ?? void 0,
 				indentFirstLine: direct?.indentFirstLine ?? resolvedFormattingFromStyle?.indentFirstLine ?? void 0,
 				hangingIndent: direct?.hangingIndent ?? resolvedFormattingFromStyle?.hangingIndent ?? false
-			}), {
-				numId: nextNumbering.numId,
-				ilvl: nextNumbering.ilvl ?? 0
-			}, numbering));
-			patch["numPr"] = nextNumbering;
+			}), effectiveNumbering.ilvl ?? 0, numbering));
+			patch["numPr"] = nextNumbering ?? null;
+			patch["numPrFromStyle"] = nextSources.numPrFromStyle ?? null;
 		}
 	}
 	return Object.keys(patch).length > 0 ? patch : null;
@@ -1976,12 +1973,16 @@ const restyledListAttrs = ({ attrs, styleNumbering, removesNumbering, numbering
 	const stated = readParagraphNumberingAttr(attrs["numPr"]);
 	const statedByOldStyle = isStyleSourcedParagraphNumbering(stated, readParagraphNumberingAttr(attrs["numPrFromStyle"]));
 	const fromStyle = styleNumbering === void 0 ? null : paragraphNumberingAttr(styleNumbering);
-	const numPr = removesNumbering ? removedNumberingAttr(fromStyle) : stated !== null && !statedByOldStyle ? stated : fromStyle;
+	const numPr = removesNumbering ? removedNumberingAttr(fromStyle) : statedByOldStyle ? null : stated;
+	const effective = effectiveParagraphNumbering(paragraphNumberingSourcesFromBoundary({
+		numPr,
+		numPrFromStyle: fromStyle
+	}));
 	return {
 		...CLEARED_LIST_RENDERING_ATTRS,
-		...numPr?.kind === "reference" && listAttrsFromNumbering({
-			numId: numPr.numId,
-			ilvl: numPr.ilvl ?? 0
+		...effective?.kind === "reference" && listAttrsFromNumbering({
+			numId: effective.numId,
+			ilvl: effective.ilvl ?? 0
 		}, numbering),
 		numPr,
 		numPrFromStyle: fromStyle
@@ -2041,52 +2042,16 @@ const buildInsertedParagraphs = ({ item, schema, formattingFromStyle, mode, auth
 		}) : buildEmphasisInlineContent(schema, text, marks);
 		const attrs = formatsParagraph ? { ...baseAttrs } : {};
 		if (isFirstParagraph && operation.pageBreakBefore === true) attrs["pageBreakBefore"] = true;
-		const explicitNumbering = operation.numbering === void 0 || operation.numbering === null ? operation.numbering : concreteListReference(operation.numbering);
-		const listLevel = operation.listLevel;
-		if (formatsParagraph) {
-			if (explicitNumbering === null) {
-				Object.assign(attrs, listLevelIndentRemovalPatch(mergeParagraphAttrs(schema.node("paragraph"), {
-					...operation.inheritFormatting === false ? {} : expectParagraphAttrs(item.blockNode),
-					_styleResolvedFormatting: styleResolvedParagraphFormatting(formattingFromStyle)
-				}), numbering));
-				attrs["numPr"] = removedNumberingAttr(readParagraphNumberingAttr(attrs["numPrFromStyle"]));
-				Object.assign(attrs, CLEARED_LIST_RENDERING_ATTRS);
-			} else if (explicitNumbering !== void 0) {
-				Object.assign(attrs, listLevelAttrPatch(mergeParagraphAttrs(schema.node("paragraph"), {
-					...operation.inheritFormatting === false ? {} : expectParagraphAttrs(item.blockNode),
-					_styleResolvedFormatting: styleResolvedParagraphFormatting(formattingFromStyle)
-				}), {
-					numId: explicitNumbering.numId,
-					ilvl: explicitNumbering.level
-				}, numbering));
-				if (listLevel === null) {
-					attrs["numPr"] = paragraphNumberingAttr(paragraphNumberingReference({ numId: explicitNumbering.numId }));
-					attrs["numPrFromStyle"] = null;
-				}
-			} else if (listLevel === null) {
-				Object.assign(attrs, listLevelIndentRemovalPatch(mergeParagraphAttrs(schema.node("paragraph"), {
-					...operation.inheritFormatting === false ? {} : expectParagraphAttrs(item.blockNode),
-					_styleResolvedFormatting: styleResolvedParagraphFormatting(formattingFromStyle)
-				}), numbering));
-				attrs["numPr"] = removedNumberingAttr(readParagraphNumberingAttr(attrs["numPrFromStyle"]));
-				Object.assign(attrs, CLEARED_LIST_RENDERING_ATTRS);
-			} else if (typeof listLevel === "number") {
-				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(mergeParagraphAttrs(schema.node("paragraph"), {
-					...operation.inheritFormatting === false ? {} : expectParagraphAttrs(item.blockNode),
-					_styleResolvedFormatting: styleResolvedParagraphFormatting(formattingFromStyle)
-				}), {
-					numId,
-					ilvl: listLevel
-				}, numbering));
-			}
-		}
+		if (formatsParagraph && operation.numbering !== void 0) Object.assign(attrs, statedNumberingAttrPatch({
+			attrs: mergeParagraphAttrs(schema.node("paragraph"), {
+				...operation.inheritFormatting === false ? {} : expectParagraphAttrs(item.blockNode),
+				...attrs,
+				_styleResolvedFormatting: styleResolvedParagraphFormatting(formattingFromStyle)
+			}),
+			stated: operation.numbering,
+			fromStyle: formattingFromStyle?.numPr === void 0 ? void 0 : paragraphNumberingAttr(formattingFromStyle.numPr),
+			numbering
+		}));
 		if (formatsParagraph && operation.styleId !== void 0) {
 			attrs["styleId"] = operation.styleId;
 			attrs["_resolvedFormatting"] = styleResolvedParagraphFormatting(formattingFromStyle);
@@ -2099,7 +2064,7 @@ const buildInsertedParagraphs = ({ item, schema, formattingFromStyle, mode, auth
 				Object.assign(attrs, restyledListAttrs({
 					attrs,
 					styleNumbering: formattingFromStyle?.numPr,
-					removesNumbering: explicitNumbering === null || explicitNumbering === void 0 && listLevel === null,
+					removesNumbering: operation.numbering?.kind === "none",
 					numbering
 				}));
 				attrs["outlineLevel"] = attrs["_originalFormatting"]?.outlineLevel ?? formattingFromStyle?.outlineLevel ?? null;
@@ -2144,9 +2109,14 @@ const buildInsertedParagraphs = ({ item, schema, formattingFromStyle, mode, auth
 			}));
 			attrs["_originalFormatting"] = originalFormatting && Object.keys(originalFormatting).length > 0 ? originalFormatting : null;
 			const finalNumbering = readParagraphNumberingAttr(attrs["numPr"]);
-			if (finalNumbering?.kind === "reference") {
+			const finalFromStyle = readParagraphNumberingAttr(attrs["numPrFromStyle"]);
+			const effectiveNumbering = effectiveParagraphNumbering(paragraphNumberingSourcesFromBoundary({
+				numPr: finalNumbering ?? void 0,
+				numPrFromStyle: finalFromStyle
+			}));
+			if (effectiveNumbering?.kind === "reference") {
 				Object.assign(attrs, listLevelAttrPatch(mergeParagraphAttrs(schema.node("paragraph"), {
-					numPr: finalNumbering,
+					numPr: finalNumbering ?? void 0,
 					_styleResolvedFormatting: styleResolvedParagraphFormatting(formattingFromStyle),
 					numPrFromStyle: readParagraphNumberingAttr(attrs["numPrFromStyle"]) ?? void 0,
 					listImplicitChildLevelAdvances: operation.inheritFormatting === false ? void 0 : expectParagraphAttrs(item.blockNode).listImplicitChildLevelAdvances,
@@ -2156,14 +2126,12 @@ const buildInsertedParagraphs = ({ item, schema, formattingFromStyle, mode, auth
 					indentRight: directIndentation?.indentRight ?? formattingFromStyle?.indentRight ?? void 0,
 					indentFirstLine: directIndentation?.indentFirstLine ?? formattingFromStyle?.indentFirstLine ?? void 0,
 					hangingIndent: directIndentation?.hangingIndent ?? formattingFromStyle?.hangingIndent ?? false
-				}), {
-					numId: finalNumbering.numId,
-					ilvl: finalNumbering.ilvl ?? 0
-				}, numbering));
+				}), effectiveNumbering.ilvl ?? 0, numbering));
 				attrs["numPr"] = finalNumbering;
+				attrs["numPrFromStyle"] = finalFromStyle;
 			}
 		}
-		if (formatsParagraph && operation.styleId !== void 0 && formattingFromStyle?.numPr?.kind === "reference" && operation.numbering === void 0 && operation.listLevel === void 0) {
+		if (formatsParagraph && operation.styleId !== void 0 && formattingFromStyle?.numPr?.kind === "reference" && operation.numbering === void 0) {
 			const { numId, ilvl = 0 } = formattingFromStyle.numPr;
 			const levelIndentation = numbering?.getLevel(numId, ilvl)?.pPr;
 			if (levelIndentation && operation.indentation === void 0) {
@@ -2226,7 +2194,7 @@ const buildInsertedParagraphs = ({ item, schema, formattingFromStyle, mode, auth
 		nextRevisionId
 	};
 };
-const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: requestedOperations, mode = "tracked-changes", author = "AI", initials, createCommentId, revisionStamp, revisionIdSeed, wordDiff, wordDiffMode = "bounded", tableTemplates, replacementBackground = "clear", undefinedStyles = "refuse" }) => {
+const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: requestedOperations, mode = "tracked-changes", author = "AI", initials, createCommentId, revisionStamp, revisionIdSeed, wordDiff, wordDiffMode = "bounded", tableTemplates, replacementBackground = "clear", undefinedReferences }) => {
 	seedRevisionIdsFromDoc(view.state.doc);
 	const applied = [];
 	const skipped = [];
@@ -2259,7 +2227,7 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: reques
 		return id;
 	};
 	const styleResolver = getDocumentStyleResolver(view.state);
-	const styleDefinitions = undefinedStyles === "keep" ? null : getDocumentStyleDefinitions(view.state);
+	const styleDefinitions = getDocumentStyleDefinitions(view.state);
 	const { operations, numbering } = resolveNewListOperations(requestedOperations, getDocumentNumbering(view.state));
 	const formattingFromStyleForInsertion = (item) => {
 		if (item.operation.type !== "insertAfterBlock" && item.operation.type !== "insertBeforeBlock") return;
@@ -2323,7 +2291,11 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: reques
 			});
 			continue;
 		}
-		const undefinedStyle = findUndefinedParagraphStyleReference(operation, styleDefinitions);
+		const undefinedStyle = findUndefinedParagraphStyleReference({
+			operation,
+			definitions: styleDefinitions,
+			undefinedReferences
+		});
 		if (undefinedStyle !== void 0) {
 			skipped.push({
 				id: operation.id,
@@ -2332,7 +2304,11 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: reques
 			});
 			continue;
 		}
-		const undefinedNumbering = findUndefinedNumberingReference(operation, numberingInstanceIds);
+		const undefinedNumbering = findUndefinedNumberingReference({
+			operation,
+			instanceIds: numberingInstanceIds,
+			undefinedReferences
+		});
 		if (undefinedNumbering !== void 0) {
 			skipped.push({
 				id: operation.id,
@@ -3615,21 +3591,34 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: reques
 				break;
 			}
 			case "mergeBlockWithNext": {
-				if (mode === "direct" && !canJoin(tr.doc, item.blockTo)) {
+				const mapped = tr.mapping.mapResult(item.blockFrom, 1);
+				const live = mapped.deletedAcross ? null : tr.doc.nodeAt(mapped.pos);
+				const paraId = item.blockNode.attrs["paraId"];
+				if (!live || live.type !== item.blockNode.type || typeof paraId === "string" && live.attrs["paraId"] !== paraId) {
+					skipped.push({
+						id: item.operation.id,
+						reason: "changedBlock"
+					});
+					continue;
+				}
+				const blockFrom = mapped.pos;
+				const blockTo = blockFrom + live.nodeSize;
+				const join = paragraphJoinAfter(tr.doc, blockTo);
+				if (!join) {
 					skipped.push({
 						id: item.operation.id,
 						reason: "unsupportedBlock"
 					});
 					continue;
 				}
-				const separator = followedOnlyByDeletedParagraphs(tr.doc, item.blockTo) ? "" : item.operation.separator ?? "";
-				const insertAt = item.blockTo - 1;
-				let mergedPropertiesAt = item.blockFrom;
+				const separator = followedOnlyByDeletedParagraphs(tr.doc, blockTo) ? "" : item.operation.separator ?? "";
+				const insertAt = blockTo - 1;
+				let mergedPropertiesAt = blockFrom;
 				let mergedPropertiesRecorded = false;
-				const second = tr.doc.nodeAt(item.blockTo);
-				const spanningComments = commentsAcrossBlockBoundary(tr.doc, item.blockTo);
+				const second = join.next;
+				const spanningComments = commentsAcrossBlockBoundary(tr.doc, blockTo);
 				const withSeparator = (transaction) => {
-					const paragraph = transaction.doc.nodeAt(item.blockFrom);
+					const paragraph = transaction.doc.nodeAt(blockFrom);
 					const sourceMarks = paragraph?.lastChild?.marks.filter(({ type }) => RUN_FORMATTING_MARK_NAMES.has(type.name)) ?? [];
 					const sourceNode = view.state.schema.text(separator, sourceMarks);
 					const context = paragraph && paragraphRunStyleContext(paragraph, styleResolver);
@@ -3649,9 +3638,9 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: reques
 				};
 				if (mode === "direct") {
 					if (separator.length > 0) tr = withSeparator(tr);
-					const nextPosition = item.blockTo + separator.length;
+					const nextPosition = join.nextPosition + separator.length;
 					const next = tr.doc.nodeAt(nextPosition);
-					const paragraph = tr.doc.nodeAt(item.blockFrom);
+					const paragraph = tr.doc.nodeAt(blockFrom);
 					if (next && paragraph) tr = rebaseParagraphRuns({
 						tr,
 						position: nextPosition,
@@ -3660,10 +3649,27 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: reques
 						styleResolver
 					});
 					tr.setMeta(JOINED_RUNS_RESTYLED_META, true);
-					tr = tr.join(item.blockTo + separator.length);
+					if (join.inlineBookmarks.length > 0) tr = tr.replaceWith(blockTo + separator.length - 1, nextPosition + 1, join.inlineBookmarks);
+					else tr = tr.join(blockTo + separator.length);
 					const secondSection = second ? sectionPropertiesOf(second) : null;
-					const joined = tr.doc.nodeAt(item.blockFrom);
-					if (joined && sectionPropertiesOf(joined) !== secondSection) tr = tr.setNodeAttribute(item.blockFrom, "_sectionProperties", secondSection);
+					const joined = tr.doc.nodeAt(blockFrom);
+					if (joined && second) tr = tr.setNodeAttribute(blockFrom, "pPrMark", expectParagraphAttrs(second).pPrMark ?? null);
+					if (joined && sectionPropertiesOf(joined) !== secondSection) tr = tr.setNodeAttribute(blockFrom, "_sectionProperties", secondSection);
+					const endingMark = second ? expectParagraphAttrs(second).pPrMark : null;
+					if (joined && (endingMark?.kind === "del" || endingMark?.kind === "moveFrom")) {
+						const survivor = paragraphLeftAfter({
+							doc: tr.doc,
+							paragraphPos: blockFrom
+						});
+						if (survivor !== null) tr = carryParagraphProperties({
+							tr,
+							position: survivor,
+							source: joined,
+							styleResolver,
+							numbering,
+							revision: endingMark.info
+						}).tr;
+					}
 				} else {
 					const revisionIdMark = operationRevisionSeed++;
 					appliedRevisionIds = [revisionIdMark];
@@ -3678,25 +3684,25 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: reques
 						}));
 						appliedRevisionIds.push(revisionIdSeparator);
 					}
-					const paragraph = tr.doc.nodeAt(item.blockFrom);
-					const joinPos = item.blockTo + separator.length;
-					const next = tr.doc.nodeAt(joinPos);
+					const paragraph = tr.doc.nodeAt(blockFrom);
+					const nextPosition = join.nextPosition + separator.length;
+					const next = tr.doc.nodeAt(nextPosition);
 					if (!paragraph || !next) panic("A resolved merge lost its paragraphs");
 					if (isInsertedPPrMark(paragraph.attrs["pPrMark"])) {
 						joinAtParagraphMark({
 							tr,
-							paragraphPos: item.blockFrom,
+							paragraphPos: blockFrom,
 							paragraph,
 							next,
 							styleResolver
 						});
-						const joinedMark = tr.doc.nodeAt(item.blockFrom)?.attrs["pPrMark"];
+						const joinedMark = tr.doc.nodeAt(blockFrom)?.attrs["pPrMark"];
 						const removedBreakPositions = pendingRemovedFinalBreakPositions(tr, deletedFinalParagraphs);
-						const carryPos = isDeletedPPrMark(joinedMark) || removedBreakPositions.has(item.blockFrom) ? paragraphLeftAfter({
+						const carryPos = isDeletedPPrMark(joinedMark) || removedBreakPositions.has(blockFrom) ? paragraphLeftAfter({
 							doc: tr.doc,
-							paragraphPos: item.blockFrom,
+							paragraphPos: blockFrom,
 							removedBreakPositions
-						}) ?? item.blockFrom : item.blockFrom;
+						}) ?? blockFrom : blockFrom;
 						const carried = carryParagraphProperties({
 							tr,
 							position: carryPos,
@@ -3715,7 +3721,7 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: reques
 						mergedPropertiesRecorded = carried.tracked;
 						if (!carried.tracked) appliedRevisionIds = appliedRevisionIds.filter((id) => id !== revisionIdMark);
 					} else {
-						tr = tr.setNodeAttribute(item.blockFrom, "pPrMark", {
+						tr = tr.setNodeAttribute(blockFrom, "pPrMark", {
 							kind: "del",
 							info: {
 								id: revisionIdMark,
@@ -3726,9 +3732,9 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: reques
 						});
 						const survivorPos = paragraphLeftAfter({
 							doc: tr.doc,
-							paragraphPos: item.blockFrom,
+							paragraphPos: blockFrom,
 							removedBreakPositions: pendingRemovedFinalBreakPositions(tr, deletedFinalParagraphs)
-						}) ?? joinPos;
+						}) ?? nextPosition;
 						const carried = carryParagraphProperties({
 							tr,
 							position: survivorPos,
@@ -5169,7 +5175,7 @@ const resolveOperationTarget = ({ snapshot, operation, liveBlocks, liveBlocksByP
 		};
 	}
 	if (operation.type === "mergeBlockWithNext") {
-		if (!canJoin(doc, blockTo)) return {
+		if (!paragraphJoinAfter(doc, blockTo)) return {
 			type: "skip",
 			reason: "unsupportedBlock"
 		};
@@ -5373,22 +5379,32 @@ const operationParagraphStyleReferences = (operation) => {
 	}
 };
 /**
-* The first paragraph style the operation names that the document does not
-* define as a paragraph style. A `w:pStyle` naming no definition, or a table
-* or character style, confers no formatting: the paragraph keeps its body
-* look while the operation reports a restyle. Refused here, before anything
-* is applied, the way an undefined block id is. `null` definitions (a state
-* without the styles plugin) cannot say what is defined, and check nothing.
+* Explicit editing requests refuse unavailable paragraph styles before apply.
+* Source-preserving imports keep their references verbatim; closure import
+* validates every defined resource separately. A state without the styles
+* plugin cannot classify a reference and checks nothing.
 */
-const findUndefinedParagraphStyleReference = (operation, definitions) => {
+const findUndefinedParagraphStyleReference = ({ operation, definitions, undefinedReferences }) => {
 	if (definitions === null) return;
 	for (const { path, styleId } of operationParagraphStyleReferences(operation)) {
 		if (styleId === null || styleId === void 0) continue;
-		const definition = definitions.get(styleId);
-		if (definition?.type !== "paragraph") return {
+		const reference = classifyResourceReference({
+			kind: "style",
+			id: styleId,
+			sourceDefines: (id) => definitions.get(id) !== void 0,
+			destinationDefines: (id) => definitions.get(id) !== void 0
+		});
+		if (undefinedReferences === "keep") continue;
+		if (reference !== "sourceDefined") return {
 			path,
 			styleId,
-			definedAs: definition?.type
+			definedAs: void 0
+		};
+		const definition = definitions.get(styleId) ?? panic("A classified style lost its definition");
+		if (definition.type !== "paragraph") return {
+			path,
+			styleId,
+			definedAs: definition.type
 		};
 	}
 };
@@ -5400,15 +5416,10 @@ const describeUndefinedParagraphStyle = ({ path, styleId, definedAs }, definitio
 	return `${path} "${styleId}" ${definedAs === void 0 ? "names no style in this document" : `names a ${definedAs} style, not a paragraph style`} (${available}).`;
 };
 /** The `w:num` id a stated numbering names, when it names one. */
-const statedNumberingInstance = (numbering) => {
-	if (numbering === null || numbering === void 0) return;
-	const numId = Reflect.get(numbering, "numId");
-	return typeof numId === "number" ? numId : void 0;
-};
+const statedNumberingInstance = (numbering) => numbering?.kind === "reference" ? numbering.numId : void 0;
 /**
 * Every numbering instance an operation names, with the field that names it.
-* `listLevel` is not among them: it keeps the instance the paragraph or its
-* anchor already references, which the document holds by construction.
+* Only reference variants name an instance; inheritance, cancellation and level-only do not.
 */
 const operationNumberingReferences = (operation) => {
 	switch (operation.type) {
@@ -5435,18 +5446,18 @@ const operationNumberingReferences = (operation) => {
 		default: return [];
 	}
 };
-/**
-* The first numbering instance the operation names that the document does not
-* define. A paragraph referencing a missing `w:num` is a model no save can
-* write, so it is refused here, before anything is applied, the way a block id
-* naming no block is. `null` instance ids (a state without the numbering
-* plugin) cannot say what is defined, and check nothing.
-*/
-const findUndefinedNumberingReference = (operation, instanceIds) => {
+const findUndefinedNumberingReference = ({ operation, instanceIds, undefinedReferences }) => {
 	if (instanceIds === null) return;
 	for (const { path, numbering } of operationNumberingReferences(operation)) {
 		const numId = statedNumberingInstance(numbering);
-		if (numId !== void 0 && !instanceIds.has(numId)) return {
+		if (numId === void 0) continue;
+		const reference = classifyResourceReference({
+			kind: "numbering",
+			id: numId,
+			sourceDefines: (id) => instanceIds.has(id),
+			destinationDefines: (id) => instanceIds.has(id)
+		});
+		if (undefinedReferences !== "keep" && reference !== "sourceDefined") return {
 			path,
 			numId
 		};