@stll/folio-core 0.36.0 → 0.37.1

package/dist/docx/rezip.js

@@ -1,3 +1,4 @@
+import { consumeTrackedSectionEndpointRemoval } from "../internal/sectionEndpointResolution.js";
 import { isAllowedExternalWatermarkImageUrl } from "../watermark/index.js";
 import { normalizeAppVersionInExtendedProperties } from "./appVersionNormalization.js";
 import { withoutOrphanCommentRanges } from "./commentRangeIntegrity.js";
@@ -115,11 +116,34 @@ const extractHeaderFooterReferences = (xml) => {
 const hasParsedHeaderFooterPart = (doc, ref) => {
 	return (ref.element === "headerReference" ? doc.package.headers : doc.package.footers)?.has(ref.rId) ?? false;
 };
-function assertDocumentPackageFidelity(originalDocumentXml, serializedDocumentXml, doc) {
+const headerFooterReferenceKey = ({ element, type, rId }) => `${element}:${type}:${rId}`;
+const incrementReferenceCount = (counts, key) => {
+	counts.set(key, (counts.get(key) ?? 0) + 1);
+};
+const consumeReferenceCount = (counts, key) => {
+	const count = counts.get(key) ?? 0;
+	if (count === 0) return false;
+	counts.set(key, count - 1);
+	return true;
+};
+function assertDocumentPackageFidelity(originalDocumentXml, serializedDocumentXml, doc, sectionEndpointRemoval) {
 	const originalSectionCount = countDocumentSections(originalDocumentXml);
-	if (countDocumentSections(serializedDocumentXml) < originalSectionCount) throw new DocxPackageFidelityError("Full DOCX repack would drop section properties. Use selective patching instead.");
-	const serializedRefs = new Set(extractHeaderFooterReferences(serializedDocumentXml).map((ref) => `${ref.element}:${ref.type}:${ref.rId}`));
-	if (extractHeaderFooterReferences(originalDocumentXml).filter((ref) => hasParsedHeaderFooterPart(doc, ref) && !serializedRefs.has(`${ref.element}:${ref.type}:${ref.rId}`)).length > 0) throw new DocxPackageFidelityError("Full DOCX repack would drop header/footer references. Use selective patching instead.");
+	const serializedSectionCount = countDocumentSections(serializedDocumentXml);
+	const trackedRemovedSectionCount = sectionEndpointRemoval ? sectionEndpointRemoval.sourceParagraphEndpointCount - sectionEndpointRemoval.expectedParagraphEndpointCount : 0;
+	const exactTrackedSectionRemoval = trackedRemovedSectionCount > 0 && originalSectionCount - trackedRemovedSectionCount === serializedSectionCount && serializedSectionCount < originalSectionCount;
+	if (serializedSectionCount < originalSectionCount && !exactTrackedSectionRemoval) throw new DocxPackageFidelityError("Full DOCX repack would drop section properties. Use selective patching instead.");
+	const serializedReferenceCounts = /* @__PURE__ */ new Map();
+	for (const reference of extractHeaderFooterReferences(serializedDocumentXml)) incrementReferenceCount(serializedReferenceCounts, headerFooterReferenceKey(reference));
+	const removedReferenceCounts = /* @__PURE__ */ new Map();
+	if (exactTrackedSectionRemoval && sectionEndpointRemoval) for (const { part, type, relationshipId } of sectionEndpointRemoval.removedReferences) incrementReferenceCount(removedReferenceCounts, `${part}Reference:${type}:${relationshipId}`);
+	const missingRefs = [];
+	for (const reference of extractHeaderFooterReferences(originalDocumentXml)) {
+		if (!hasParsedHeaderFooterPart(doc, reference)) continue;
+		const key = headerFooterReferenceKey(reference);
+		if (consumeReferenceCount(serializedReferenceCounts, key) || consumeReferenceCount(removedReferenceCounts, key)) continue;
+		missingRefs.push(reference);
+	}
+	if (missingRefs.length > 0) throw new DocxPackageFidelityError("Full DOCX repack would drop header/footer references. Use selective patching instead.");
 }
 async function serializeCommentsToZip(doc, zip, compressionLevel) {
 	const comments = doc.package.document.comments ?? [];
@@ -488,7 +512,7 @@ const cloneDocxZip = (source) => {
 	clone.files = { ...source.files };
 	return clone;
 };
-const finishRepack = async ({ document, originalZip, outputZip, originalDocumentXml, originalCorePropertiesXml, compressionLevel, updateModifiedDate, modifiedBy, changedNoteParaIds }) => {
+const finishRepack = async ({ document, originalZip, outputZip, originalDocumentXml, originalCorePropertiesXml, compressionLevel, updateModifiedDate, modifiedBy, changedNoteParaIds, sectionEndpointRemoval }) => {
 	await materializeNewHeaderFooterParts(document, outputZip, compressionLevel);
 	const parts = collectDocxParts(document, outputZip);
 	await processNewImages(parts, outputZip, compressionLevel);
@@ -496,7 +520,7 @@ const finishRepack = async ({ document, originalZip, outputZip, originalDocument
 	assertValidFolioDocumentModel(document, "Cannot repack invalid DOCX document model");
 	applyReplyThreadMarkers(document);
 	const documentXml = serializeDocument(document, originalDocumentXml === void 0 ? void 0 : readRootNamespaceBindings(originalDocumentXml));
-	if (originalDocumentXml) assertDocumentPackageFidelity(originalDocumentXml, documentXml, document);
+	if (originalDocumentXml) assertDocumentPackageFidelity(originalDocumentXml, documentXml, document, sectionEndpointRemoval);
 	outputZip.file("word/document.xml", documentXml, {
 		compression: "DEFLATE",
 		compressionOptions: { level: compressionLevel }
@@ -526,15 +550,7 @@ const finishRepack = async ({ document, originalZip, outputZip, originalDocument
 	}
 	return generateDocxZip(outputZip, compressionLevel);
 };
-/**
-* Repack a Document into a valid DOCX file
-*
-* @param doc - Document with modified content
-* @param options - Optional repack options
-* @returns Promise resolving to DOCX as ArrayBuffer
-* @throws {Error} if document has no original buffer for round-trip
-*/
-async function repackDocx(doc, options = {}) {
+async function repackDocxWithSectionEndpointRemoval({ document: doc, options, sectionEndpointRemoval }) {
 	if (!doc.originalBuffer) panic("Cannot repack document: no original buffer for round-trip. Use createDocx() for new documents.");
 	const { compressionLevel = 6, updateModifiedDate = true, modifiedBy, changedNoteParaIds } = options;
 	const exportDocument = withoutOrphanCommentRanges(doc);
@@ -551,7 +567,16 @@ async function repackDocx(doc, options = {}) {
 		compressionLevel,
 		updateModifiedDate,
 		...modifiedBy !== void 0 ? { modifiedBy } : {},
-		...changedNoteParaIds !== void 0 ? { changedNoteParaIds } : {}
+		...changedNoteParaIds !== void 0 ? { changedNoteParaIds } : {},
+		...sectionEndpointRemoval !== void 0 ? { sectionEndpointRemoval } : {}
+	});
+}
+function repackDocx(doc, options = {}) {
+	const sectionEndpointRemoval = consumeTrackedSectionEndpointRemoval(doc);
+	return repackDocxWithSectionEndpointRemoval({
+		document: doc,
+		options,
+		...sectionEndpointRemoval ? { sectionEndpointRemoval } : {}
 	});
 }
 /**

package/dist/docx/runParser.js

@@ -41,9 +41,11 @@ function parseShadingProperties(shd) {
 	if (!shd) return;
 	const props = {};
 	const color = getAttribute(shd, "w", "color");
-	if (color && color !== "auto" && isValidHexColor(color)) props.color = { rgb: color };
+	if (color === "auto") props.color = { auto: true };
+	else if (color && isValidHexColor(color)) props.color = { rgb: color };
 	const fill = getAttribute(shd, "w", "fill");
-	if (fill && fill !== "auto" && isValidHexColor(fill)) props.fill = { rgb: fill };
+	if (fill === "auto") props.fill = { auto: true };
+	else if (fill && isValidHexColor(fill)) props.fill = { rgb: fill };
 	const validatedThemeFill = narrowEnum(getAttribute(shd, "w", "themeFill"), ThemeColorSlotSchema);
 	if (validatedThemeFill) {
 		if (!props.fill) props.fill = {};

package/dist/docx/serializer/paragraphSerializer.js

@@ -398,6 +398,8 @@ const withParagraphMarkChange = (sourceXml, mark) => {
 	return captureVerbatimXml(cloneElement(root, { elements }));
 };
 const serializeParagraphFormattingWithOptions = (formatting, { propertyChanges, paragraphMarkChange, propertySource, sectionProperties } = {}) => {
+	const serializablePropertyChangeCount = propertyChanges?.length ?? 0;
+	if (serializablePropertyChangeCount > 1) panic("A paragraph cannot serialize more than one w:pPrChange", { count: serializablePropertyChangeCount });
 	const paragraphMarkXml = paragraphMarkChange ? serializeParagraphMarkChange(paragraphMarkChange) : "";
 	const sectionPropertiesXml = serializeSectionProperties(sectionProperties);
 	const propertyChangesXml = (propertyChanges ?? []).map((change) => serializeParagraphPropertyChange(change));

package/dist/docx/serializer/runSerializer.js

@@ -5,7 +5,7 @@ import { THEME_COLOR_TO_DRAWING_SCHEME } from "../drawingUtils.js";
 import { requiresXmlSpacePreserve } from "../textWhitespace.js";
 import { serializeParagraph } from "./paragraphSerializer.js";
 import { serializeTable } from "./tableSerializer.js";
-import { serializeTrackedChangeAttributes } from "./trackedChangeAttributes.js";
+import { getSingularRunPropertyChange, serializeTrackedChangeAttributes } from "./trackedChangeAttributes.js";
 import { escapeXml, intAttr } from "./xmlUtils.js";
 import { panic } from "better-result";
 //#region src/docx/serializer/runSerializer.ts
@@ -145,7 +145,7 @@ function serializeTextFormatting(formatting) {
 		}
 		parts.push(`<w:u ${uAttrs.join(" ")}/>`);
 	}
-	if (formatting.effect && formatting.effect !== "none") parts.push(`<w:effect w:val="${formatting.effect}"/>`);
+	if (formatting.effect) parts.push(`<w:effect w:val="${formatting.effect}"/>`);
 	const shadingXml = serializeShading(formatting.shading) || customHighlightShadingXml;
 	if (shadingXml) parts.push(shadingXml);
 	if (formatting.vertAlign) parts.push(`<w:vertAlign w:val="${formatting.vertAlign}"/>`);
@@ -174,7 +174,9 @@ function serializeRunPropertyChange(change) {
 }
 function serializeRunProperties(formatting, propertyChanges) {
 	const currentRPrXml = serializeTextFormatting(formatting);
-	const combined = `${currentRPrXml ? extractRPrInner(currentRPrXml) : ""}${(propertyChanges ?? []).map(serializeRunPropertyChange).join("")}`;
+	const currentInner = currentRPrXml ? extractRPrInner(currentRPrXml) : "";
+	const propertyChange = getSingularRunPropertyChange(propertyChanges);
+	const combined = `${currentInner}${propertyChange ? serializeRunPropertyChange(propertyChange) : ""}`;
 	if (!combined) return "";
 	return `<w:rPr>${combined}</w:rPr>`;
 }

package/dist/docx/serializer/trackedChangeAttributes.d.ts

@@ -1,9 +1,11 @@
 import { document_d_exports } from "../../types/document.js";
 //#region src/docx/serializer/trackedChangeAttributes.d.ts
 type SerializableTrackedChangeInfo = document_d_exports.TrackedChangeInfo | document_d_exports.PropertyChangeInfo;
+/** Enforces the singular `w:rPrChange` child in a run-property container. */
+declare const getSingularRunPropertyChange: (propertyChanges: readonly document_d_exports.RunPropertyChange[] | undefined) => document_d_exports.RunPropertyChange | undefined;
 /** Normalized, unescaped attributes in schema order for an XML element or string serializer. */
 declare const trackedChangeAttributeEntries: (info: SerializableTrackedChangeInfo) => readonly (readonly [string, string])[];
 declare const trackedChangeAttributeRecord: (info: SerializableTrackedChangeInfo) => Record<string, string>;
 declare const serializeTrackedChangeAttributes: (info: SerializableTrackedChangeInfo) => string;
 //#endregion
-export { serializeTrackedChangeAttributes, trackedChangeAttributeEntries, trackedChangeAttributeRecord };
+export { getSingularRunPropertyChange, serializeTrackedChangeAttributes, trackedChangeAttributeEntries, trackedChangeAttributeRecord };

package/dist/docx/serializer/trackedChangeAttributes.js

@@ -1,7 +1,17 @@
 import { DATE_UTC_ATTRIBUTE } from "../trackedChangeInfo.js";
 import { escapeXml } from "./xmlUtils.js";
+import { panic } from "better-result";
 import { normalizeRevisionId } from "@stll/docx-core/model";
 //#region src/docx/serializer/trackedChangeAttributes.ts
+/** Enforces the singular `w:rPrChange` child in a run-property container. */
+const getSingularRunPropertyChange = (propertyChanges) => {
+	const propertyChangeCount = propertyChanges?.length ?? 0;
+	if (propertyChangeCount > 1) panic("A run-property container cannot serialize more than one w:rPrChange", {
+		elementName: "w:rPrChange",
+		propertyChangeCount
+	});
+	return propertyChanges?.at(0);
+};
 /** Normalized, unescaped attributes in schema order for an XML element or string serializer. */
 const trackedChangeAttributeEntries = (info) => {
 	const author = typeof info.author === "string" ? info.author.trim() : "";
@@ -18,4 +28,4 @@ const trackedChangeAttributeEntries = (info) => {
 const trackedChangeAttributeRecord = (info) => Object.fromEntries(trackedChangeAttributeEntries(info));
 const serializeTrackedChangeAttributes = (info) => trackedChangeAttributeEntries(info).map(([name, value]) => `${name}="${escapeXml(value)}"`).join(" ");
 //#endregion
-export { serializeTrackedChangeAttributes, trackedChangeAttributeEntries, trackedChangeAttributeRecord };
+export { getSingularRunPropertyChange, serializeTrackedChangeAttributes, trackedChangeAttributeEntries, trackedChangeAttributeRecord };

package/dist/docx/server/build.d.ts

@@ -1,7 +1,7 @@
 import { ShadingProperties } from "../../types/colors.js";
 import { document_d_exports } from "../../types/document.js";
-import { Hyperlink, Paragraph, ParagraphContent, Run, Table } from "../../types/content.js";
 import { ParagraphFormatting, TextFormatting } from "../../types/formatting.js";
+import { Hyperlink, Paragraph, ParagraphContent, Run, Table } from "../../types/content.js";
 //#region src/docx/server/build.d.ts
 declare const HEADING_LEVELS: readonly [1, 2, 3, 4, 5, 6];
 type HeadingLevel = (typeof HEADING_LEVELS)[number];

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, 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 { 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, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, 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, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, 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, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, 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 HeadlessRange = {
+  from: number;
+  to: number;
+};
+type HeadlessInlineChangeTracking = {
+  ranges: readonly HeadlessRange[];
+  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,176 @@
+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;
+	const replacementRangeStart = context.replacementRanges.length;
+	let resolvedNode = node;
+	if (node.isInline) {
+		const resolved = resolveInlineNode({
+			node,
+			context,
+			paragraphScope
+		});
+		if (resolved === null) {
+			context.replacementRanges.push({
+				from: position,
+				to: position + node.nodeSize,
+				newSize: 0
+			});
+			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;
+	let resolvedContent = Fragment.fromArray(children);
+	if (!resolvedNode.type.validContent(resolvedContent)) {
+		const fitted = resolvedNode.type.createAndFill(resolvedNode.attrs, resolvedContent, resolvedNode.marks);
+		if (!fitted || !resolvedNode.type.validContent(fitted.content)) {
+			if (!resolvedNode.isInline) return panic(`Headless inline resolution invalidated ${resolvedNode.type.name} content`);
+			context.replacementRanges.splice(replacementRangeStart, context.replacementRanges.length - replacementRangeStart, {
+				from: position,
+				to: position + node.nodeSize,
+				newSize: 0
+			});
+			return null;
+		}
+		context.replacementRanges.splice(replacementRangeStart, context.replacementRanges.length - replacementRangeStart, {
+			from: contentStart,
+			to: contentStart + node.content.size,
+			newSize: fitted.content.size
+		});
+		resolvedContent = fitted.content;
+	}
+	if (resolvedNode.type.name === "paragraph") context.changedParagraphRanges.push({
+		from: position,
+		to: position + resolvedNode.nodeSize
+	});
+	return rebuildNode(node, resolvedNode.attrs, resolvedContent, resolvedNode.marks);
+};
+const coalesceReplacementRanges = (replacementRanges) => {
+	const coalesced = [];
+	for (const range of replacementRanges) {
+		const previous = coalesced.at(-1);
+		if (previous && previous.newSize === 0 && range.newSize === 0 && 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,
+		replacementRanges: [],
+		changedParagraphRanges: [],
+		styleResolver
+	};
+	const resolved = resolveInlineContent({
+		node: tr.doc,
+		position: -1,
+		context
+	});
+	if (!resolved || resolved.eq(tr.doc)) return null;
+	const positionMap = new StepMap(coalesceReplacementRanges(context.replacementRanges).flatMap(({ from, to, newSize }) => [
+		from,
+		to - from,
+		newSize
+	]));
+	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 };