@stll/folio-core 0.35.1 → 0.37.0

package/dist/docx/xmlSafety.js

@@ -1,8 +1,165 @@
 import { XMLValidator } from "fast-xml-parser";
 //#region src/docx/xmlSafety.ts
 const DOCTYPE_PATTERN = /<!DOCTYPE(?:\s|>)/iu;
+const BUILT_IN_ENTITIES = /* @__PURE__ */ new Set([
+	"amp",
+	"apos",
+	"gt",
+	"lt",
+	"quot"
+]);
+const DECIMAL_CHARACTER_REFERENCE = /^#[0-9]+$/u;
+const HEX_CHARACTER_REFERENCE = /^#[xX][0-9A-Fa-f]+$/u;
+const NCNAME = /^[\p{L}_][\p{L}\p{N}._\-\u00b7\p{M}]*$/u;
+const BYTE_ORDER_MARK = "";
+const ENCODING_NAME = String.raw`[A-Za-z][A-Za-z0-9._-]*`;
+const XML_DECLARATION = new RegExp(String.raw`^<\?xml[ \t\r\n]+version[ \t\r\n]*=[ \t\r\n]*(?:"1\.0"|'1\.0')(?:[ \t\r\n]+encoding[ \t\r\n]*=[ \t\r\n]*(?:"${ENCODING_NAME}"|'${ENCODING_NAME}'))?(?:[ \t\r\n]+standalone[ \t\r\n]*=[ \t\r\n]*(?:"(?:yes|no)"|'(?:yes|no)'))?[ \t\r\n]*\?>$`, "u");
+const isXmlCharacter = (codePoint) => codePoint === 9 || codePoint === 10 || codePoint === 13 || codePoint >= 32 && codePoint <= 55295 || codePoint >= 57344 && codePoint <= 65533 || codePoint >= 65536 && codePoint <= 1114111;
+const validEntity = (entity) => {
+	if (BUILT_IN_ENTITIES.has(entity)) return true;
+	if (!DECIMAL_CHARACTER_REFERENCE.test(entity) && !HEX_CHARACTER_REFERENCE.test(entity)) return false;
+	const digits = entity[1]?.toLowerCase() === "x" ? entity.slice(2) : entity.slice(1);
+	const significantDigits = digits.replace(/^0+/u, "") || "0";
+	const hexadecimal = entity[1]?.toLowerCase() === "x";
+	if (digits.length === 0 || significantDigits.length > (hexadecimal ? 6 : 7)) return false;
+	return isXmlCharacter(Number.parseInt(significantDigits, hexadecimal ? 16 : 10));
+};
+const hasForbiddenEntity = (xml) => {
+	let cursor = 0;
+	while (cursor < xml.length) {
+		if (xml.startsWith("<!--", cursor)) {
+			const end = xml.indexOf("-->", cursor + 4);
+			cursor = end === -1 ? xml.length : end + 3;
+			continue;
+		}
+		if (xml.startsWith("<![CDATA[", cursor)) {
+			const end = xml.indexOf("]]>", cursor + 9);
+			cursor = end === -1 ? xml.length : end + 3;
+			continue;
+		}
+		if (xml.startsWith("<?", cursor)) {
+			const end = xml.indexOf("?>", cursor + 2);
+			cursor = end === -1 ? xml.length : end + 2;
+			continue;
+		}
+		if (xml[cursor] !== "&") {
+			cursor += 1;
+			continue;
+		}
+		const end = xml.indexOf(";", cursor + 1);
+		if (end === -1) return true;
+		if (!validEntity(xml.slice(cursor + 1, end))) return true;
+		cursor = end + 1;
+	}
+	return false;
+};
+const isValidQName = (name) => {
+	const parts = name.split(":");
+	return parts.length <= 2 && parts.every((part) => NCNAME.test(part));
+};
+const containsOnlyXmlCharacters = (xml) => {
+	for (const character of xml) {
+		const codePoint = character.codePointAt(0);
+		if (codePoint === void 0 || !isXmlCharacter(codePoint)) return false;
+	}
+	return true;
+};
+const isWhitespace = (character) => character === " " || character === "	" || character === "\r" || character === "\n";
+const scanName = (xml, start) => {
+	let cursor = start;
+	while (cursor < xml.length && !isWhitespace(xml[cursor]) && xml[cursor] !== ">" && xml[cursor] !== "/" && xml[cursor] !== "=" && xml[cursor] !== "?") cursor += 1;
+	const name = xml.slice(start, cursor);
+	return name !== "" && isValidQName(name) ? {
+		name,
+		next: cursor
+	} : null;
+};
+/**
+* Reject lexical forms that fast-xml-parser's permissive validator repairs.
+* This is deliberately a small XML lexer, not a second tree parser: structural
+* nesting remains XMLValidator's job.
+*/
+const hasInvalidXmlLexicalForm = (xml) => {
+	if (!containsOnlyXmlCharacters(xml)) return true;
+	const byteOrderMark = xml.indexOf(BYTE_ORDER_MARK);
+	if (byteOrderMark > 0 || byteOrderMark === 0 && xml.indexOf(BYTE_ORDER_MARK, 1) !== -1) return true;
+	let cursor = 0;
+	while (cursor < xml.length) {
+		const opening = xml.indexOf("<", cursor);
+		const textEnd = opening === -1 ? xml.length : opening;
+		if (xml.slice(cursor, textEnd).includes("]]>") || opening === -1) return xml.slice(cursor, textEnd).includes("]]>");
+		if (xml.startsWith("<!--", opening)) {
+			const end = xml.indexOf("-->", opening + 4);
+			if (end === -1) return true;
+			const body = xml.slice(opening + 4, end);
+			if (body.includes("--") || body.endsWith("-")) return true;
+			cursor = end + 3;
+			continue;
+		}
+		if (xml.startsWith("<![CDATA[", opening)) {
+			const end = xml.indexOf("]]>", opening + 9);
+			if (end === -1) return true;
+			cursor = end + 3;
+			continue;
+		}
+		if (xml.startsWith("<?", opening)) {
+			const end = xml.indexOf("?>", opening + 2);
+			if (end === -1) return true;
+			let targetEnd = opening + 2;
+			while (targetEnd < end && !isWhitespace(xml[targetEnd]) && xml[targetEnd] !== "?") targetEnd += 1;
+			const target = xml.slice(opening + 2, targetEnd);
+			if (!NCNAME.test(target)) return true;
+			if (target.toLowerCase() === "xml") {
+				if (opening !== (xml.startsWith(BYTE_ORDER_MARK) ? 1 : 0) || target !== "xml" || !XML_DECLARATION.test(xml.slice(opening, end + 2))) return true;
+			}
+			cursor = end + 2;
+			continue;
+		}
+		if (xml.startsWith("<!", opening)) return true;
+		let tagCursor = opening + 1;
+		const closing = xml[tagCursor] === "/";
+		if (closing) tagCursor += 1;
+		const tagName = scanName(xml, tagCursor);
+		if (!tagName) return true;
+		tagCursor = tagName.next;
+		if (closing) {
+			while (isWhitespace(xml[tagCursor])) tagCursor += 1;
+			if (xml[tagCursor] !== ">") return true;
+			cursor = tagCursor + 1;
+			continue;
+		}
+		while (tagCursor < xml.length) {
+			while (isWhitespace(xml[tagCursor])) tagCursor += 1;
+			if (xml[tagCursor] === ">") {
+				cursor = tagCursor + 1;
+				break;
+			}
+			if (xml[tagCursor] === "/" && xml[tagCursor + 1] === ">") {
+				cursor = tagCursor + 2;
+				break;
+			}
+			const attribute = scanName(xml, tagCursor);
+			if (!attribute) return true;
+			if (attribute.name.startsWith("xmlns:") && (!NCNAME.test(attribute.name.slice(6)) || attribute.name.slice(6).includes(":"))) return true;
+			tagCursor = attribute.next;
+			while (isWhitespace(xml[tagCursor])) tagCursor += 1;
+			if (xml[tagCursor] !== "=") return true;
+			tagCursor += 1;
+			while (isWhitespace(xml[tagCursor])) tagCursor += 1;
+			const quote = xml[tagCursor];
+			if (quote !== "\"" && quote !== "'") return true;
+			const valueEnd = xml.indexOf(quote, tagCursor + 1);
+			if (valueEnd === -1 || xml.slice(tagCursor + 1, valueEnd).includes("<")) return true;
+			tagCursor = valueEnd + 1;
+		}
+		if (tagCursor >= xml.length && cursor !== xml.length) return true;
+	}
+	return false;
+};
 const getDocxXmlSafetyIssue = (xml) => {
 	if (DOCTYPE_PATTERN.test(xml)) return "doctype-forbidden";
+	if (hasForbiddenEntity(xml)) return "entity-forbidden";
+	if (hasInvalidXmlLexicalForm(xml)) return "not-well-formed";
 	return XMLValidator.validate(xml) === true ? null : "not-well-formed";
 };
 //#endregion

package/dist/headless-layout.js

@@ -88,7 +88,8 @@ const buildFlowOptions = (document, pageContentHeight) => {
 	const settings = document.package.settings;
 	const options = {
 		pageContentHeight,
-		fontAlternates: buildFontAlternates(document.package.fontTable)
+		fontAlternates: buildFontAlternates(document.package.fontTable),
+		...document.package.styles ? { styles: document.package.styles } : {}
 	};
 	const theme = document.package.theme;
 	if (theme) options.theme = theme;
@@ -118,8 +119,8 @@ const buildBlockLookup = (blocks, measures) => new Map(blocks.flatMap((block, in
 		measure
 	}]];
 }));
-const buildStoryOptions = (document, flowOptions) => ({
-	...document.package.styles ? { styles: document.package.styles } : {},
+const buildStoryOptions = (flowOptions) => ({
+	...flowOptions.styles === void 0 ? {} : { styles: flowOptions.styles },
 	...flowOptions.theme === void 0 ? {} : { theme: flowOptions.theme },
 	...flowOptions.fontAlternates === void 0 ? {} : { fontAlternates: flowOptions.fontAlternates },
 	...flowOptions.defaultTabStopTwips === void 0 ? {} : { defaultTabStopTwips: flowOptions.defaultTabStopTwips },
@@ -240,7 +241,7 @@ const layoutDocxHeadless = async (input, options = {}) => {
 	const contentWidth = pageSize.w - margins.left - margins.right;
 	const pageContentHeight = pageSize.h - margins.top - margins.bottom;
 	const flowOptions = buildFlowOptions(document, pageContentHeight);
-	const storyOptions = buildStoryOptions(document, flowOptions);
+	const storyOptions = buildStoryOptions(flowOptions);
 	const laidOut = Result.try(() => {
 		const authored = toFlowBlocks(projected.value, flowOptions);
 		const footnotes = document.package.footnotes ?? [];

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import { document_d_exports } from "./types/document.js";
-import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIBlockTableLocation, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditNormalization, FolioAIEditNormalizationCode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAISignatureParty } from "./ai-edits/types.js";
+import { FolioContentBlock, FolioContentContainerPathEntry, FolioContentIdStability, FolioContentInlineBooleanProperty, FolioContentInlineFormatting, FolioContentInlineFormattingPatch, FolioContentLineSpacingRule, FolioContentParagraphAlignment, FolioContentParagraphSpacing, FolioContentRun, FolioContentSnapshot, FolioContentTableLocation } from "./compare/content-types.js";
+import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIBlockStructuralBoundary, FolioAIBlockTableLocation, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditNormalization, FolioAIEditNormalizationCode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineBooleanProperty, FolioAIInlineFormatting, FolioAIInlineFormattingPatch, FolioAIParagraphSpacing, FolioAISignatureParty } from "./ai-edits/types.js";
 import { WORD_DIFF_GRANULARITIES, WordDiffGranularity, WordDiffNormalization, WordDiffOptions, WordDiffSegment, diffWordSegments } from "./ai-edits/word-diff.js";
 import { FolioAIEditApplyOutcome, FolioRevisionStamp, FolioWordDiffOptions, applyFolioAIEditOperations } from "./ai-edits/apply.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_LINE_SPACING_RULE_VALUES, 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 { createFolioAIEditSnapshot, hashFolioAIBlockText, isFolioAIContentBlock, normalizeFolioAIBlockText } from "./ai-edits/snapshot.js";
 import { DeriveBlockIdInput, FolioBlockId, currentFolioBlockId, deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
 import "./ai-edits/index.js";
@@ -10,6 +11,7 @@ import { AIBarStatus, AIChatMode, AICitation, AICitationSource, AIGenerateInput,
 import { ApplyResult, applySuggestions } from "./ai-suggestions/apply.js";
 import { ResolvedAnchor, isSuggestionStale, resolveSuggestionAnchor } from "./ai-suggestions/conflict.js";
 import { PositionalText, buildPositionalText } from "./ai-suggestions/text-positions.js";
+import { CompareContentOptions, FOLIO_CONTENT_COMPARISON_LIMITS, FolioContentBlockProperty, FolioContentComparison, FolioContentComparisonError, FolioContentComparisonEvent, FolioContentComparisonLimit, FolioContentComparisonLimitError, FolioContentFormatRange, FolioContentFormattingChange, FolioContentParagraphFormattingPatch, FolioContentStructuralChange, FolioContentTextSegment, InvalidFolioContentComparisonError, compareContent } from "./compare/content.js";
 import { COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, CompareVerification, CompareVerificationCause, CompareVerificationFailure, CompareVerificationInvariant, FinalParagraphMarkRevision } from "./compare/verification.js";
 import { COMPARE_UNSUPPORTED_REASONS, CompareChange, CompareChangeLocation, CompareDocxApplyError, CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, CompareFormatRange, CompareResult, CompareUnsupportedPart, CompareUnsupportedReason, InvalidCompareDocxOptionsError } from "./compare/types.js";
 import { MAX_COMPARE_OPERATIONS, compareDocx } from "./compare/compare.js";
@@ -38,4 +40,4 @@ import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
 type Document = document_d_exports.Document;
 type DocxConformanceClass = document_d_exports.DocxConformanceClass;
-export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type BlockRect, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, type CompareChange, type CompareChangeLocation, CompareDocxApplyError, type CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, type CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, type CompareFormatRange, type CompareResult, type CompareUnsupportedPart, type CompareUnsupportedReason, type CompareVerification, type CompareVerificationCause, type CompareVerificationFailure, type CompareVerificationInvariant, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, 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, type FinalParagraphMarkRevision, 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 FolioAISignatureParty, type FolioBlockId, 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 FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type FolioRevisionStamp, type FolioWordDiffOptions, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type BlockRect, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, type CompareChange, type CompareChangeLocation, type CompareContentOptions, CompareDocxApplyError, type CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, type CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, type CompareFormatRange, type CompareResult, type CompareUnsupportedPart, type CompareUnsupportedReason, type CompareVerification, type CompareVerificationCause, type CompareVerificationFailure, type CompareVerificationInvariant, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, FOLIO_CONTENT_COMPARISON_LIMITS, 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_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, type FinalParagraphMarkRevision, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, 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 FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIParagraphSpacing, type FolioAISignatureParty, type FolioBlockId, type FolioContentBlock, type FolioContentBlockProperty, type FolioContentComparison, type FolioContentComparisonError, type FolioContentComparisonEvent, type FolioContentComparisonLimit, FolioContentComparisonLimitError, type FolioContentContainerPathEntry, type FolioContentFormatRange, type FolioContentFormattingChange, type FolioContentIdStability, type FolioContentInlineBooleanProperty, type FolioContentInlineFormatting, type FolioContentInlineFormattingPatch, type FolioContentLineSpacingRule, type FolioContentParagraphAlignment, type FolioContentParagraphFormattingPatch, type FolioContentParagraphSpacing, type FolioContentRun, type FolioContentSnapshot, type FolioContentStructuralChange, type FolioContentTableLocation, type FolioContentTextSegment, 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 FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type FolioRevisionStamp, type FolioWordDiffOptions, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareContent, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/index.js

@@ -6,9 +6,10 @@ import { isSuggestionStale, resolveSuggestionAnchor } from "./ai-suggestions/con
 import { buildPositionalText } from "./ai-suggestions/text-positions.js";
 import { DEFAULT_AI_SUGGESTION_PRESETS } from "./ai-suggestions/types.js";
 import { MAX_COMPARE_OPERATIONS, compareDocx } from "./compare/compare.js";
+import { FOLIO_CONTENT_COMPARISON_LIMITS, FolioContentComparisonLimitError, InvalidFolioContentComparisonError, compareContent } from "./compare/content.js";
 import { COMPARE_UNSUPPORTED_REASONS, CompareDocxApplyError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, InvalidCompareDocxOptionsError } from "./compare/types.js";
 import { COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS } from "./compare/verification.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, 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_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "./document-operations.js";
 import { inspectDocxCompatibility } from "./docx/compatibility.js";
 import { createDocx } from "./docx/rezip.js";
 import { buildEmbeddedFontFamilyMap, extractEmbeddedFonts, getEmbeddedFontFaces, scopeEmbeddedFontFamily } from "./fonts/embeddedFonts.js";
@@ -31,4 +32,4 @@ import { createEmptyDocument } from "./utils/createDocument.js";
 import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled } from "./utils/fontResolver.js";
 import { mergeDocumentContent } from "./utils/mergeDocumentContent.js";
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
-export { COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, CompareDocxApplyError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, 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, InvalidCompareDocxOptionsError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, CompareDocxApplyError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, FOLIO_CONTENT_COMPARISON_LIMITS, 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_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FolioContentComparisonLimitError, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareContent, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/internal/headlessRevisionResolution.d.ts

@@ -0,0 +1,23 @@
+import { RunStyleResolver } from "../prosemirror/runStyleFormatting.js";
+import { Transaction } from "prosemirror-state";
+import { MarkType } from "prosemirror-model";
+//#region src/internal/headlessRevisionResolution.d.ts
+type HeadlessRevisionResolutionMode = "accept" | "reject";
+type HeadlessDeleteRange = {
+  from: number;
+  to: number;
+};
+type HeadlessInlineChangeTracking = {
+  ranges: readonly HeadlessDeleteRange[];
+  mappingFrom: number;
+};
+type AppendHeadlessInlineResolutionOptions = {
+  tr: Transaction;
+  mode: HeadlessRevisionResolutionMode;
+  keepType: MarkType | undefined;
+  removeType: MarkType | undefined;
+  styleResolver: RunStyleResolver | null;
+};
+declare const appendHeadlessInlineResolution: ({ tr, mode, keepType, removeType, styleResolver }: AppendHeadlessInlineResolutionOptions) => HeadlessInlineChangeTracking | null;
+//#endregion
+export { HeadlessInlineChangeTracking, HeadlessRevisionResolutionMode, appendHeadlessInlineResolution };

package/dist/internal/headlessRevisionResolution.js

@@ -0,0 +1,155 @@
+import { recreateProseNodeWithParagraphPropertySource } from "../docx/paragraphPropertySource.js";
+import { expectRunPropertyChangeMarkAttrs } from "../prosemirror/attrs/index.js";
+import { RUN_FORMATTING_MARK_NAMES } from "../prosemirror/runFormattingMarkNames.js";
+import { reconstructRejectedRunFormattingMarks } from "../prosemirror/runPropertyChangeResolution.js";
+import { paragraphRunStyleContext } from "../prosemirror/runStyleFormatting.js";
+import { panic } from "better-result";
+import { Fragment, Slice } from "prosemirror-model";
+import { ReplaceStep, StepMap } from "prosemirror-transform";
+//#region src/internal/headlessRevisionResolution.ts
+const EMPTY_PARAGRAPH_RUN_STYLE_CONTEXT = {
+	baseParagraphFormatting: void 0,
+	paragraphFormatting: void 0,
+	paragraphMarkFormatting: void 0,
+	paragraphMarkPrecedesStyle: false
+};
+const resolveParagraphRunStyleScope = (scope, styleResolver) => {
+	if (!scope) return EMPTY_PARAGRAPH_RUN_STYLE_CONTEXT;
+	scope.resolved ??= paragraphRunStyleContext(scope.paragraph, styleResolver);
+	return scope.resolved;
+};
+/**
+* A synchronous headless replacement with the granular position map of the
+* inline deletions it applies. It must never enter history or collaboration;
+* map and serialization fail loudly if that invariant is broken.
+*/
+var HeadlessInlineResolutionStep = class HeadlessInlineResolutionStep extends ReplaceStep {
+	positionMap;
+	constructor(from, to, slice, positionMap) {
+		super(from, to, slice);
+		this.positionMap = positionMap;
+	}
+	getMap() {
+		return this.positionMap;
+	}
+	invert(doc) {
+		return new HeadlessInlineResolutionStep(this.from, this.from + this.slice.size, doc.slice(this.from, this.to), this.positionMap.invert());
+	}
+	map(_mapping) {
+		return panic("A headless revision-resolution step cannot be mapped");
+	}
+	toJSON() {
+		return panic("A headless revision-resolution step cannot be serialized");
+	}
+};
+const marksEqual = (left, right) => left.length === right.length && left.every((mark, index) => {
+	const candidate = right[index];
+	return candidate !== void 0 && mark.eq(candidate);
+});
+const rebuildNode = (source, attrs, content, marks = source.marks) => recreateProseNodeWithParagraphPropertySource(source, {
+	attrs,
+	content,
+	marks
+});
+const resolveInlineNode = ({ node, context, paragraphScope }) => {
+	let marks = node.marks;
+	const runPropertyChangeMark = marks.find((mark) => mark.type.name === "runPropertyChange");
+	if (runPropertyChangeMark) {
+		const { changes } = expectRunPropertyChangeMarkAttrs(runPropertyChangeMark);
+		if (changes.length > 0) {
+			marks = marks.filter((mark) => mark !== runPropertyChangeMark);
+			if (context.mode === "reject") {
+				marks = marks.filter((mark) => !RUN_FORMATTING_MARK_NAMES.has(mark.type.name));
+				const previousFormatting = changes.at(0)?.previousFormatting;
+				for (const previousMark of reconstructRejectedRunFormattingMarks({
+					node,
+					paragraphContext: resolveParagraphRunStyleScope(paragraphScope, context.styleResolver),
+					previousFormatting,
+					styleResolver: context.styleResolver
+				})) marks = previousMark.addToSet(marks);
+			}
+		}
+	}
+	if (context.removeType && node.marks.some((mark) => mark.type === context.removeType)) return null;
+	if (context.keepType) marks = marks.filter((mark) => mark.type !== context.keepType);
+	return marksEqual(marks, node.marks) ? node : node.mark(marks);
+};
+const resolveInlineContent = ({ node, position, context, inheritedParagraphScope }) => {
+	const paragraphScope = node.type.name === "paragraph" && context.mode === "reject" ? { paragraph: node } : inheritedParagraphScope;
+	let resolvedNode = node;
+	if (node.isInline) {
+		const resolved = resolveInlineNode({
+			node,
+			context,
+			paragraphScope
+		});
+		if (resolved === null) {
+			context.deleteRanges.push({
+				from: position,
+				to: position + node.nodeSize
+			});
+			return null;
+		}
+		resolvedNode = resolved;
+		if (resolvedNode.isLeaf) return resolvedNode;
+	}
+	const children = [];
+	const contentStart = resolvedNode.type.name === "doc" ? 0 : position + 1;
+	let contentChanged = false;
+	resolvedNode.forEach((child, offset) => {
+		const resolved = resolveInlineContent({
+			node: child,
+			position: contentStart + offset,
+			context,
+			...paragraphScope !== void 0 ? { inheritedParagraphScope: paragraphScope } : {}
+		});
+		if (resolved) {
+			children.push(resolved);
+			contentChanged ||= resolved !== child;
+		} else contentChanged = true;
+	});
+	if (!contentChanged) return resolvedNode;
+	if (resolvedNode.type.name === "paragraph") context.changedParagraphRanges.push({
+		from: position,
+		to: position + resolvedNode.nodeSize
+	});
+	return rebuildNode(node, resolvedNode.attrs, Fragment.fromArray(children), resolvedNode.marks);
+};
+const coalesceDeleteRanges = (deleteRanges) => {
+	const coalesced = [];
+	for (const range of deleteRanges) {
+		const previous = coalesced.at(-1);
+		if (previous && range.from <= previous.to) previous.to = Math.max(previous.to, range.to);
+		else coalesced.push({ ...range });
+	}
+	return coalesced;
+};
+const appendHeadlessInlineResolution = ({ tr, mode, keepType, removeType, styleResolver }) => {
+	const context = {
+		mode,
+		keepType,
+		removeType,
+		deleteRanges: [],
+		changedParagraphRanges: [],
+		styleResolver
+	};
+	const resolved = resolveInlineContent({
+		node: tr.doc,
+		position: -1,
+		context
+	});
+	if (!resolved || resolved.eq(tr.doc)) return null;
+	const positionMap = new StepMap(coalesceDeleteRanges(context.deleteRanges).flatMap(({ from, to }) => [
+		from,
+		to - from,
+		0
+	]));
+	const mappingFrom = tr.steps.length;
+	tr.step(new HeadlessInlineResolutionStep(0, tr.doc.content.size, new Slice(resolved.content, 0, 0), positionMap));
+	return {
+		ranges: context.changedParagraphRanges,
+		mappingFrom
+	};
+};
+//#endregion
+export { appendHeadlessInlineResolution };

package/dist/internal/headlessRevisionResolutionGuard.d.ts

@@ -0,0 +1,12 @@
+import { EditorState, Plugin } from "prosemirror-state";
+//#region src/internal/headlessRevisionResolutionGuard.d.ts
+/**
+ * Whether a state can consume an unmapped replacement before it returns.
+ * Only the internal headless plugin set opts in; history and collaboration
+ * plugins always keep the state on the legacy editor-command path.
+ */
+declare const stateAllowsHeadlessRevisionResolution: (state: EditorState) => boolean;
+/** Build the private plugin set for synchronous headless review states. */
+declare const pluginsForHeadlessRevisionResolution: (plugins: readonly Plugin[]) => readonly Plugin[];
+//#endregion
+export { pluginsForHeadlessRevisionResolution, stateAllowsHeadlessRevisionResolution };

package/dist/internal/headlessRevisionResolutionGuard.js

@@ -0,0 +1,28 @@
+import { Plugin, PluginKey } from "prosemirror-state";
+//#region src/internal/headlessRevisionResolutionGuard.ts
+const UNSAFE_PLUGIN_KEY_PREFIXES = [
+	"collab$",
+	"history$",
+	"y-sync$",
+	"y-undo$"
+];
+const headlessRevisionResolutionKey = new PluginKey("folioHeadlessRevisionResolution");
+const headlessRevisionResolutionPlugin = new Plugin({ key: headlessRevisionResolutionKey });
+const pluginRuntimeKey = (plugin) => {
+	const key = Reflect.get(plugin, "key");
+	return typeof key === "string" ? key : null;
+};
+const retainsOrTransportsSteps = (plugin) => {
+	const key = pluginRuntimeKey(plugin);
+	return key !== null && UNSAFE_PLUGIN_KEY_PREFIXES.some((prefix) => key.startsWith(prefix));
+};
+/**
+* Whether a state can consume an unmapped replacement before it returns.
+* Only the internal headless plugin set opts in; history and collaboration
+* plugins always keep the state on the legacy editor-command path.
+*/
+const stateAllowsHeadlessRevisionResolution = (state) => headlessRevisionResolutionKey.get(state) === headlessRevisionResolutionPlugin && !state.plugins.some(retainsOrTransportsSteps);
+/** Build the private plugin set for synchronous headless review states. */
+const pluginsForHeadlessRevisionResolution = (plugins) => [...plugins.filter((plugin) => !retainsOrTransportsSteps(plugin)), headlessRevisionResolutionPlugin];
+//#endregion
+export { pluginsForHeadlessRevisionResolution, stateAllowsHeadlessRevisionResolution };

package/dist/internal/pageBreakRunDescendantIndex.d.ts

@@ -0,0 +1,9 @@
+import { Node } from "prosemirror-model";
+//#region src/internal/pageBreakRunDescendantIndex.d.ts
+type PageBreakRunDescendantIndex = {
+  firstPageBreakRunPosition: (node: Node) => number | undefined;
+};
+/** Build one identity-scoped index for a single layout conversion. */
+declare const buildPageBreakRunDescendantIndex: (doc: Node) => PageBreakRunDescendantIndex;
+//#endregion
+export { PageBreakRunDescendantIndex, buildPageBreakRunDescendantIndex };

package/dist/internal/pageBreakRunDescendantIndex.js

@@ -0,0 +1,27 @@
+//#region src/internal/pageBreakRunDescendantIndex.ts
+const indexesPageBreakDescendants = (node) => {
+	switch (node.type.name) {
+		case "paragraph":
+		case "tableCell":
+		case "tableHeader":
+		case "textBox": return true;
+		default: return false;
+	}
+};
+/** Build one identity-scoped index for a single layout conversion. */
+const buildPageBreakRunDescendantIndex = (doc) => {
+	const positions = /* @__PURE__ */ new WeakMap();
+	const visitNode = (node, startPos) => {
+		let firstPosition = node.type.name === "pageBreakRun" ? startPos : void 0;
+		node.forEach((child, offset) => {
+			const descendantPosition = visitNode(child, startPos + 1 + offset);
+			firstPosition ??= descendantPosition;
+		});
+		if (firstPosition !== void 0 && indexesPageBreakDescendants(node)) positions.set(node, firstPosition);
+		return firstPosition;
+	};
+	visitNode(doc, -1);
+	return { firstPageBreakRunPosition: (node) => positions.get(node) };
+};
+//#endregion
+export { buildPageBreakRunDescendantIndex };

package/dist/internal/pageBreakRunPartition.d.ts

@@ -0,0 +1,26 @@
+//#region src/internal/pageBreakRunPartition.d.ts
+type PositionedRun = {
+  pmStart?: number;
+  pmEnd?: number;
+};
+type PositionedPageBreak = {
+  pmStart: number;
+  pmEnd: number;
+};
+type PageBreakRunPartition<TRun, TPageBreak> = {
+  before: TRun[];
+  pageBreak: TPageBreak;
+};
+type PageBreakRunPartitionResult<TRun, TPageBreak> = {
+  type: "partitioned";
+  partitions: PageBreakRunPartition<TRun, TPageBreak>[];
+  remaining: TRun[];
+} | {
+  type: "overlap";
+  pageBreak: TPageBreak;
+  run: TRun;
+};
+/** Partition ordered runs with one monotonic cursor; each run is consumed once and peeked once. */
+declare const partitionRunsAtPageBreaks: <TRun extends PositionedRun, TPageBreak extends PositionedPageBreak>(runs: readonly TRun[], pageBreaks: readonly TPageBreak[]) => PageBreakRunPartitionResult<TRun, TPageBreak>;
+//#endregion
+export { PageBreakRunPartition, PageBreakRunPartitionResult, partitionRunsAtPageBreaks };

package/dist/internal/pageBreakRunPartition.js

@@ -0,0 +1,35 @@
+//#region src/internal/pageBreakRunPartition.ts
+/** Partition ordered runs with one monotonic cursor; each run is consumed once and peeked once. */
+const partitionRunsAtPageBreaks = (runs, pageBreaks) => {
+	const partitions = [];
+	let nextRunIndex = 0;
+	for (const pageBreak of pageBreaks) {
+		const before = [];
+		while (nextRunIndex < runs.length) {
+			const run = runs[nextRunIndex];
+			if (!run) break;
+			if (run.pmEnd !== void 0 && run.pmEnd <= pageBreak.pmStart) {
+				before.push(run);
+				nextRunIndex += 1;
+				continue;
+			}
+			if (run.pmStart !== void 0 && run.pmStart >= pageBreak.pmEnd) break;
+			return {
+				type: "overlap",
+				pageBreak,
+				run
+			};
+		}
+		partitions.push({
+			before,
+			pageBreak
+		});
+	}
+	return {
+		type: "partitioned",
+		partitions,
+		remaining: runs.slice(nextRunIndex)
+	};
+};
+//#endregion
+export { partitionRunsAtPageBreaks };

package/dist/internal/pageBreakRunSourceDescendantIndex.d.ts

@@ -0,0 +1,15 @@
+import { document_d_exports } from "../types/document.js";
+//#region src/internal/pageBreakRunSourceDescendantIndex.d.ts
+type PageBreakRunSourceDescendantIndex = {
+  containsPageBreakRun: (content: readonly document_d_exports.BlockContent[]) => boolean;
+  paragraphFeatures: (paragraph: document_d_exports.Paragraph) => PageBreakRunSourceParagraphFeatures;
+};
+type PageBreakRunSourceParagraphFeatures = {
+  hasPageBreakRun: boolean;
+  hasTextBoxShape: boolean;
+  pageBreakSharesTextBoxShape: boolean;
+};
+/** Index authored page-break descendants once for one source conversion. */
+declare const buildPageBreakRunSourceDescendantIndex: (rootContent: readonly document_d_exports.BlockContent[]) => PageBreakRunSourceDescendantIndex;
+//#endregion
+export { PageBreakRunSourceDescendantIndex, PageBreakRunSourceParagraphFeatures, buildPageBreakRunSourceDescendantIndex };