@stll/folio-core 0.35.1 → 0.36.0

package/dist/ai-edits/headless.js

@@ -1,6 +1,7 @@
 import { applyFolioDocumentOperations } from "../document-operations.js";
 import { getEndnoteText, getFootnoteText, isSeparatorEndnote, isSeparatorFootnote } from "../docx/footnoteParser.js";
 import { getHeaderFooterText } from "../docx/headerFooterParser.js";
+import { recreateProseNodeWithParagraphPropertySource, transferProseParagraphPropertySource } from "../docx/paragraphPropertySource.js";
 import { parseDocx } from "../docx/parser.js";
 import { createReply } from "../docx/replyToComment.js";
 import { repackDocx } from "../docx/rezip.js";
@@ -10,6 +11,7 @@ import { proseDocToBlocks, updateDocumentContent } from "../prosemirror/conversi
 import { footnoteToProseDoc, headerFooterToProseDoc, toProseDoc } from "../prosemirror/conversion/toProseDoc.js";
 import { ensureBaseDirectionInState } from "../prosemirror/extensions/features/AutoBidiDetectionExtension.js";
 import { getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
+import { createDocumentStylesPlugin } from "../prosemirror/plugins/documentStyles.js";
 import { schema, singletonManager } from "../prosemirror/schema/index.js";
 import { deterministicHexId } from "../utils/hexId.js";
 import { buildAnnotatedBlockText } from "./clean-text.js";
@@ -17,8 +19,8 @@ import { getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
 import { createFolioAIEditSnapshot, folioStoryTables, isFolioAIContentBlock, normalizeFolioAIBlockText } from "./snapshot.js";
 import { matchTableGeometry } from "./table-geometry.js";
 import { TaggedError } from "better-result";
-import { Fragment } from "prosemirror-model";
 import { EditorState } from "prosemirror-state";
+import { Fragment } from "prosemirror-model";
 //#region src/ai-edits/headless.ts
 /**
 * Headless `.docx` review path: buffer -> apply AI edits -> buffer, with
@@ -109,14 +111,16 @@ const ensureDeterministicParaIdsInDoc = (doc) => {
 					let paraId = deterministicHexId(`${child.textContent}:${ordinal}`);
 					for (let salt = 1; seen.has(paraId); salt++) paraId = deterministicHexId(`${child.textContent}:${ordinal}:${salt}`);
 					seen.add(paraId);
-					next = child.type.create({
+					next = recreateProseNodeWithParagraphPropertySource(child, { attrs: {
 						...child.attrs,
 						paraId
-					}, child.content, child.marks);
+					} });
 				}
+				const paraId = next.attrs["paraId"];
+				if (typeof paraId === "string") transferProseParagraphPropertySource(next, child, paraId);
 			} else if (child.childCount > 0) {
 				const content = rewrite(child);
-				if (content !== child.content) next = child.copy(content);
+				if (content !== child.content) next = recreateProseNodeWithParagraphPropertySource(child, { content });
 			}
 			if (next !== child) changed = true;
 			children.push(next);
@@ -124,7 +128,7 @@ const ensureDeterministicParaIdsInDoc = (doc) => {
 		return changed ? Fragment.fromArray(children) : parent.content;
 	};
 	const content = rewrite(doc);
-	return content === doc.content ? doc : doc.copy(content);
+	return content === doc.content ? doc : recreateProseNodeWithParagraphPropertySource(doc, { content });
 };
 const FOLIO_REVIEWED_VIEWS = Object.freeze([
 	"original",
@@ -248,7 +252,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			preloadFonts: false,
 			password: options.password
 		});
-		const plugins = singletonManager.getPlugins();
+		const plugins = [...singletonManager.getPlugins(), createDocumentStylesPlugin(baseDocument.package.styles)];
 		const state = ensureBaseDirectionInState(EditorState.create({
 			schema,
 			doc: ensureDeterministicParaIdsInDoc(toProseDoc(baseDocument)),
@@ -413,6 +417,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			},
 			...options.snapshot !== void 0 && { snapshot: options.snapshot },
 			...options.revisionStamp !== void 0 && { revisionStamp: options.revisionStamp },
+			...options.wordDiff !== void 0 && { wordDiff: options.wordDiff },
 			createUndoEntry: false
 		});
 		return {
@@ -432,6 +437,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			batch,
 			...options.snapshot !== void 0 && { snapshot: options.snapshot },
 			...options.revisionStamp !== void 0 && { revisionStamp: options.revisionStamp },
+			...options.wordDiff !== void 0 && { wordDiff: options.wordDiff },
 			createUndoEntry: true
 		});
 	}
@@ -872,7 +878,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		const state = ensureBaseDirectionInState(EditorState.create({
 			schema,
 			doc: ensureDeterministicParaIdsInDoc(storyDoc),
-			plugins: singletonManager.getPlugins()
+			plugins: [...singletonManager.getPlugins(), createDocumentStylesPlugin(this.baseDocument.package.styles)]
 		}));
 		this.secondaryStoryStates.set(key, {
 			handle: story,
@@ -930,7 +936,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 				if (!source) continue;
 				const edited = {
 					...source,
-					content: proseDocToBlocks(entry.state.doc)
+					content: proseDocToBlocks(entry.state.doc, source.content)
 				};
 				if (entry.handle.type === "header") {
 					headers ??= new Map(document.package.headers);
@@ -947,7 +953,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 				if (!source) continue;
 				const edited = {
 					...source,
-					content: proseDocToBlocks(entry.state.doc)
+					content: proseDocToBlocks(entry.state.doc, source.content)
 				};
 				footnotes ??= [...document.package.footnotes ?? []];
 				const index = footnotes.findIndex((note) => note.id === noteId);
@@ -959,7 +965,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			if (!source) continue;
 			const edited = {
 				...source,
-				content: proseDocToBlocks(entry.state.doc)
+				content: proseDocToBlocks(entry.state.doc, source.content)
 			};
 			endnotes ??= [...document.package.endnotes ?? []];
 			const index = endnotes.findIndex((note) => note.id === noteId);

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

@@ -3,10 +3,10 @@ import { WORD_DIFF_GRANULARITIES, WordDiffGranularity, WordDiffNormalization, Wo
 import { FolioAIEditApplyOutcome, FolioAIEditView, FolioRevisionStamp, FolioWordDiffOptions, applyFolioAIEditOperations } from "./apply.js";
 import { DocPositionRange, clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange } from "./blockRange.js";
 import { buildAnnotatedBlockText } from "./clean-text.js";
-import { ApplyFolioDocumentOperationsOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationResultBase, FolioDocumentOperationStatus, FolioDocumentOperationStory, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
+import { ApplyFolioDocumentOperationsOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationResultBase, FolioDocumentOperationStatus, FolioDocumentOperationStory, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
 import { FolioCommentAnchor, FolioReviewChange, FolioReviewChangeKind, getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
 import { createFolioAIEditSnapshot, createFolioAITextRangeHandle, hashFolioAIBlockText, isFolioAIContentBlock, normalizeFolioAIBlockText } from "./snapshot.js";
 import { FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioApplyDocumentOperationsToStoryOptions, FolioDocumentStory, FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, FolioEditableDocumentStoryHandle, FolioReadReviewedStoryOptions, FolioResolveReviewedStoryOptions, FolioResolvedReviewedView, FolioReviewedStory, FolioReviewedView, UnsupportedFolioReviewedViewError, isFolioResolvedReviewedView, isFolioReviewedView } from "./headless.js";
 import { getFolioDocumentOutline, readFolioDocumentSection } from "./scoped-reading.js";
 import { getFolioParaIdFromBlockId } from "../types/block-id.js";
-export { type ApplyFolioDocumentOperationsOptions, type DocPositionRange, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockTableLocation, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIEditView, type FolioAIInlineFormatting, type FolioAISignatureParty, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsToStoryOptions, type FolioCommentAnchor, type FolioDocumentNavigationTarget, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, type FolioEditableDocumentStoryHandle, type FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeKind, type FolioReviewedStory, type FolioReviewedView, type FolioRevisionStamp, type FolioWordDiffOptions, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAITextRangeHandle, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioAIContentBlock, isFolioDocumentOperationModeSupported, isFolioResolvedReviewedView, isFolioReviewedView, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };
+export { type ApplyFolioDocumentOperationsOptions, type DocPositionRange, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockTableLocation, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIEditView, type FolioAIInlineFormatting, type FolioAISignatureParty, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsToStoryOptions, type FolioCommentAnchor, type FolioDocumentNavigationTarget, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, type FolioEditableDocumentStoryHandle, type FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeKind, type FolioReviewedStory, type FolioReviewedView, type FolioRevisionStamp, type FolioWordDiffOptions, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAITextRangeHandle, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioAIContentBlock, isFolioDocumentOperationModeSupported, isFolioResolvedReviewedView, isFolioReviewedView, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };

package/dist/ai-edits/index.js

@@ -1,4 +1,4 @@
-import { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
+import { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
 import { getFolioParaIdFromBlockId } from "../types/block-id.js";
 import { applyFolioAIEditOperations } from "./apply.js";
 import { clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange } from "./blockRange.js";
@@ -8,4 +8,4 @@ import { getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
 import { getFolioDocumentOutline, readFolioDocumentSection } from "./scoped-reading.js";
 import { createFolioAIEditSnapshot, createFolioAITextRangeHandle, hashFolioAIBlockText, isFolioAIContentBlock, normalizeFolioAIBlockText } from "./snapshot.js";
 import { WORD_DIFF_GRANULARITIES, diffWordSegments } from "./word-diff.js";
-export { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioDocumentStoryNotFoundError, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, WORD_DIFF_GRANULARITIES, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAITextRangeHandle, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioAIContentBlock, isFolioDocumentOperationModeSupported, isFolioResolvedReviewedView, isFolioReviewedView, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };
+export { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioDocumentStoryNotFoundError, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, WORD_DIFF_GRANULARITIES, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAITextRangeHandle, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioAIContentBlock, isFolioDocumentOperationModeSupported, isFolioResolvedReviewedView, isFolioReviewedView, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };

package/dist/ai-edits/snapshot.js

@@ -1,4 +1,5 @@
-import { expectRunFormattingOverrideMarkAttrs } from "../prosemirror/attrs/index.js";
+import { expectParagraphAttrs, expectRunFormattingOverrideMarkAttrs } from "../prosemirror/attrs/index.js";
+import { directParagraphAlignment } from "../prosemirror/paragraphAlignment.js";
 import { deriveBlankBlockId, deriveBlockId } from "../types/block-id.js";
 import { buildCleanBlockText } from "./clean-text.js";
 import { panic } from "better-result";
@@ -178,6 +179,7 @@ const createFolioAIEditSnapshot = (doc) => {
 		const listLevel = getListLevel(node);
 		const numberingReferenceKey = getNumberingReferenceKey(node);
 		if (numberingReferenceKey) numberingReferenceKeys.add(numberingReferenceKey);
+		const directAlignment = getDirectAlignment(node);
 		const previewRuns = getPreviewRuns(node);
 		const table = getTableLocation({
 			path,
@@ -193,6 +195,7 @@ const createFolioAIEditSnapshot = (doc) => {
 				...displayLabel !== void 0 && { displayLabel },
 				...styleId !== void 0 && { styleId },
 				...listLevel !== void 0 && { listLevel },
+				...directAlignment !== void 0 && { directAlignment },
 				...previewRuns !== void 0 && { previewRuns },
 				...table !== void 0 && { table }
 			},
@@ -263,6 +266,8 @@ const getStyleId = (node) => {
 	const styleId = node.attrs["styleId"];
 	return typeof styleId === "string" && styleId.length > 0 ? styleId : void 0;
 };
+/** Read only authored `w:jc`, never the effective alignment resolved from a style. */
+const getDirectAlignment = (node) => directParagraphAlignment(expectParagraphAttrs(node));
 const DELETION_MARK = "deletion";
 const getPreviewRuns = (node) => {
 	const runs = [];

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

@@ -1,3 +1,4 @@
+import { document_d_exports } from "../types/document.js";
 //#region src/ai-edits/types.d.ts
 type FolioAIBlockKind = "heading" | "listItem" | "paragraph";
 type FolioAIInlineFormatting = Partial<Record<"bold" | "italic" | "underline" | "strike", boolean>> & {
@@ -51,6 +52,8 @@ type FolioAIBlock = {
   headingLevel?: number;
   displayLabel?: string;
   styleId?: string;
+  /** Direct `w:pPr/w:jc`; absent when alignment comes only from a style. */
+  directAlignment?: document_d_exports.ParagraphAlignment;
   /**
    * `w:numPr/w:ilvl`: the block's list indent level. Present only on a block
    * that carries numbering, and the only pPr property a redline can move
@@ -63,8 +66,8 @@ type FolioAIBlock = {
 };
 /**
  * The paragraph properties an operation may set. A subset of `w:pPrChange`'s
- * scope: the two a comparison can see in a block projection, and the two an
- * agent has a reason to change.
+ * scope: properties a comparison can see in a block projection and an agent
+ * has a reason to change.
  */
 type FolioAIBlockParagraphProperties = {
   /** `w:pStyle`. `null` clears the style back to the default. */
@@ -74,6 +77,8 @@ type FolioAIBlockParagraphProperties = {
    * paragraph stops being a list item rather than moving to another level.
    */
   listLevel?: number | null;
+  /** Direct `w:jc`. `null` clears the override and restores style inheritance. */
+  alignment?: document_d_exports.ParagraphAlignment | null;
 };
 /**
  * Every paragraph of one story, blank ones included.
@@ -222,7 +227,7 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & {
    * 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` / `inheritFormatting`, later ones use body
+   * gets `styleId` / `alignment` / `inheritFormatting`, later ones use body
    * formatting. Blank lines are dropped. Reported as a
    * `splitMultilineText` normalization when it happens.
    *
@@ -262,6 +267,11 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & {
    * inheritance alone cannot say.
    */
   listLevel?: number | null;
+  /**
+   * Direct `w:jc` for the inserted block. `null` clears alignment copied
+   * from the anchor and lets the inserted paragraph's style decide.
+   */
+  alignment?: document_d_exports.ParagraphAlignment | null;
   comment?: FolioAIComment;
 } | {
   id: string;
@@ -269,7 +279,8 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & {
   blockId: string;
   text: string;
   preserveFormatting?: boolean;
-  styleId?: string;
+  /** Paragraph style to apply; `null` clears the direct style. */
+  styleId?: string | null;
   comment?: FolioAIComment;
 } |
 /**
@@ -464,8 +475,8 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & {
  *   provenance: rendered with the tracked-change grammar but stripped from
  *   serialized DOCX until a human accepts them. Behaves like `"tracked-changes"`
  *   and covers the inline text/format operations (replaceInBlock, replaceRange,
- *   formatRange) plus the block and table row/column structural operations
- *   (insertAfterBlock, insertBeforeBlock, replaceBlock, deleteBlock,
+ *   formatRange), paragraph properties, plus the block and table row/column structural
+ *   operations (insertAfterBlock, insertBeforeBlock, replaceBlock, deleteBlock,
  *   insertSignatureTable, insertTableRow, deleteTableRow, insertTableColumn,
  *   deleteTableColumn). Only comment operations and cell merge/split report
  *   `unsupportedMode`.
@@ -506,6 +517,8 @@ type FolioAIEditAppliedOperation = {
    * fromProseDoc serialises a single id carrying both as a Word
    * "moveTo/moveFrom" pair, not an ins/del — so the two sides must
    * be distinct ids in the doc but conceptually one operation here.
+   * The list also includes a paragraph-property revision synthesized
+   * when an inserted final paragraph mark rotates to its carrier.
    * Use this list when you need to accept or reject every mark
    * belonging to this op.
    */

package/dist/ai-edits/word-diff.d.ts

@@ -23,8 +23,11 @@
  * 3. When what survives is still too fragmented for its length, the whole
  *    paragraph is one replacement ({@link isTooFragmented}).
  *
- * O(n*m) on token counts; past {@link MAX_WORD_DIFF_CELLS} the DP is skipped
- * for a single whole-string `del` + `ins` pair.
+ * Common affixes and unique-token anchors split the input into independent
+ * gaps before any quadratic work. The residual gaps share one
+ * {@link MAX_WORD_DIFF_CELLS} allowance per comparison or apply scope; once it
+ * is spent, a gap is a single `del` + `ins` pair. A standalone call owns one
+ * fresh scope.
  */
 type WordDiffSegment = {
   type: "equal" | "del" | "ins";
@@ -58,6 +61,18 @@ type WordDiffOptions = {
   /** Default: nothing normalized, so both strings reconstruct exactly. */
   normalization?: WordDiffNormalization;
 };
+/**
+ * One internal comparison/apply scope. Every diff shares the same quadratic
+ * allowance; public standalone calls below still receive a fresh allowance.
+ * Not re-exported from a package entry point.
+ */
+declare const createWordDiffSession: (options?: WordDiffOptions) => {
+  diff: (before: string, after: string) => WordDiffSegment[];
+};
+/** Attach one internal work scope without widening a caller-facing option type. */
+declare const createScopedWordDiffOptions: <Options extends WordDiffOptions>(options: Options) => Options;
+/** Reuse an internal scope when present; ordinary public callers get a fresh one. */
+declare const wordDiffSessionFromOptions: (options: WordDiffOptions | undefined) => ReturnType<typeof createWordDiffSession>;
 declare const diffWordSegments: (before: string, after: string, options?: WordDiffOptions) => WordDiffSegment[];
 //#endregion
-export { WORD_DIFF_GRANULARITIES, WordDiffGranularity, WordDiffNormalization, WordDiffOptions, WordDiffSegment, diffWordSegments };
+export { WORD_DIFF_GRANULARITIES, WordDiffGranularity, WordDiffNormalization, WordDiffOptions, WordDiffSegment, createScopedWordDiffOptions, createWordDiffSession, diffWordSegments, wordDiffSessionFromOptions };