@stll/folio-core 0.37.4 → 0.38.0

package/dist/docx/serializer/runSerializer.js

@@ -1,10 +1,10 @@
-import { HIGHLIGHT_COLOR_VALUES } from "../../types/documentEnumValues.js";
 import { isValidHexColor } from "../../utils/colorResolver.js";
-import { roundHorizontalScalePercentForSerialization } from "../../utils/horizontalScale.js";
 import { THEME_COLOR_TO_DRAWING_SCHEME } from "../drawingUtils.js";
+import { canReplayEditableImageRawXml } from "../imageRawXml.js";
 import { requiresXmlSpacePreserve } from "../textWhitespace.js";
 import { serializeParagraph } from "./paragraphSerializer.js";
 import { serializeTable } from "./tableSerializer.js";
+import { serializeTextFormatting } from "./textFormattingSerializer.js";
 import { getSingularRunPropertyChange, serializeTrackedChangeAttributes } from "./trackedChangeAttributes.js";
 import { escapeXml, intAttr } from "./xmlUtils.js";
 import { panic } from "better-result";
@@ -38,132 +38,6 @@ function getUniqueId(id) {
 	if (id !== void 0 && id !== "" && id !== 0) return String(id);
 	return String(nextAutoId++);
 }
-/** Valid OOXML highlight color names (ECMA-376 §17.18.40) */
-const VALID_HIGHLIGHT_COLORS = new Set(HIGHLIGHT_COLOR_VALUES);
-/**
-* Serialize a color element (w:color)
-*/
-function serializeColorElement(color) {
-	if (!color) return "";
-	const attrs = [];
-	if (color.auto) attrs.push("w:val=\"auto\"");
-	else if (color.rgb && isValidHexColor(color.rgb)) attrs.push(`w:val="${escapeXml(color.rgb)}"`);
-	if (color.themeColor) attrs.push(`w:themeColor="${escapeXml(color.themeColor)}"`);
-	if (color.themeTint) attrs.push(`w:themeTint="${escapeXml(color.themeTint)}"`);
-	if (color.themeShade) attrs.push(`w:themeShade="${escapeXml(color.themeShade)}"`);
-	if (attrs.length === 0) return "";
-	return `<w:color ${attrs.join(" ")}/>`;
-}
-/**
-* Serialize shading properties (w:shd)
-*/
-function serializeShading(shading) {
-	if (!shading) return "";
-	const attrs = [];
-	if (shading.pattern) attrs.push(`w:val="${escapeXml(shading.pattern)}"`);
-	else attrs.push("w:val=\"clear\"");
-	if (shading.color?.rgb && isValidHexColor(shading.color.rgb)) attrs.push(`w:color="${escapeXml(shading.color.rgb)}"`);
-	else if (shading.color?.auto) attrs.push("w:color=\"auto\"");
-	if (shading.fill?.rgb && isValidHexColor(shading.fill.rgb)) attrs.push(`w:fill="${escapeXml(shading.fill.rgb)}"`);
-	else if (shading.fill?.auto) attrs.push("w:fill=\"auto\"");
-	if (shading.fill?.themeColor) attrs.push(`w:themeFill="${escapeXml(shading.fill.themeColor)}"`);
-	if (shading.fill?.themeTint) attrs.push(`w:themeFillTint="${escapeXml(shading.fill.themeTint)}"`);
-	if (shading.fill?.themeShade) attrs.push(`w:themeFillShade="${escapeXml(shading.fill.themeShade)}"`);
-	if (attrs.length === 0) return "";
-	return `<w:shd ${attrs.join(" ")}/>`;
-}
-/**
-* Serialize text formatting properties to w:rPr XML
-*/
-function serializeTextFormatting(formatting) {
-	if (!formatting) return "";
-	const parts = [];
-	if (formatting.styleId) parts.push(`<w:rStyle w:val="${escapeXml(formatting.styleId)}"/>`);
-	if (formatting.fontFamily) {
-		const fontAttrs = [];
-		if (formatting.fontFamily.ascii) fontAttrs.push(`w:ascii="${escapeXml(formatting.fontFamily.ascii)}"`);
-		if (formatting.fontFamily.hAnsi) fontAttrs.push(`w:hAnsi="${escapeXml(formatting.fontFamily.hAnsi)}"`);
-		if (formatting.fontFamily.eastAsia) fontAttrs.push(`w:eastAsia="${escapeXml(formatting.fontFamily.eastAsia)}"`);
-		if (formatting.fontFamily.cs) fontAttrs.push(`w:cs="${escapeXml(formatting.fontFamily.cs)}"`);
-		if (formatting.fontFamily.hint) fontAttrs.push(`w:hint="${escapeXml(formatting.fontFamily.hint)}"`);
-		if (formatting.fontFamily.asciiTheme) fontAttrs.push(`w:asciiTheme="${escapeXml(formatting.fontFamily.asciiTheme)}"`);
-		if (formatting.fontFamily.hAnsiTheme) fontAttrs.push(`w:hAnsiTheme="${escapeXml(formatting.fontFamily.hAnsiTheme)}"`);
-		if (formatting.fontFamily.eastAsiaTheme) fontAttrs.push(`w:eastAsiaTheme="${escapeXml(formatting.fontFamily.eastAsiaTheme)}"`);
-		if (formatting.fontFamily.csTheme) fontAttrs.push(`w:cstheme="${escapeXml(formatting.fontFamily.csTheme)}"`);
-		if (fontAttrs.length > 0) parts.push(`<w:rFonts ${fontAttrs.join(" ")}/>`);
-	}
-	if (formatting.bold === true) parts.push("<w:b/>");
-	else if (formatting.bold === false) parts.push("<w:b w:val=\"0\"/>");
-	if (formatting.boldCs === true) parts.push("<w:bCs/>");
-	else if (formatting.boldCs === false) parts.push("<w:bCs w:val=\"0\"/>");
-	if (formatting.italic === true) parts.push("<w:i/>");
-	else if (formatting.italic === false) parts.push("<w:i w:val=\"0\"/>");
-	if (formatting.italicCs === true) parts.push("<w:iCs/>");
-	else if (formatting.italicCs === false) parts.push("<w:iCs w:val=\"0\"/>");
-	if (formatting.allCaps === true) parts.push("<w:caps/>");
-	else if (formatting.allCaps === false) parts.push("<w:caps w:val=\"0\"/>");
-	if (formatting.smallCaps === true) parts.push("<w:smallCaps/>");
-	else if (formatting.smallCaps === false) parts.push("<w:smallCaps w:val=\"0\"/>");
-	if (formatting.strike === true) parts.push("<w:strike/>");
-	else if (formatting.strike === false) parts.push("<w:strike w:val=\"0\"/>");
-	if (formatting.doubleStrike === true) parts.push("<w:dstrike/>");
-	else if (formatting.doubleStrike === false) parts.push("<w:dstrike w:val=\"0\"/>");
-	if (formatting.outline === true) parts.push("<w:outline/>");
-	else if (formatting.outline === false) parts.push("<w:outline w:val=\"0\"/>");
-	if (formatting.shadow === true) parts.push("<w:shadow/>");
-	else if (formatting.shadow === false) parts.push("<w:shadow w:val=\"0\"/>");
-	if (formatting.emboss === true) parts.push("<w:emboss/>");
-	else if (formatting.emboss === false) parts.push("<w:emboss w:val=\"0\"/>");
-	if (formatting.imprint === true) parts.push("<w:imprint/>");
-	else if (formatting.imprint === false) parts.push("<w:imprint w:val=\"0\"/>");
-	if (formatting.hidden === true) parts.push("<w:vanish/>");
-	else if (formatting.hidden === false) parts.push("<w:vanish w:val=\"0\"/>");
-	const colorXml = serializeColorElement(formatting.color);
-	if (colorXml) parts.push(colorXml);
-	if (formatting.spacing !== void 0) parts.push(`<w:spacing w:val="${intAttr(formatting.spacing)}"/>`);
-	const horizontalScale = roundHorizontalScalePercentForSerialization(formatting.scale);
-	if (horizontalScale !== void 0) parts.push(`<w:w w:val="${intAttr(horizontalScale)}"/>`);
-	if (formatting.kerning !== void 0) parts.push(`<w:kern w:val="${intAttr(formatting.kerning)}"/>`);
-	if (formatting.position !== void 0) parts.push(`<w:position w:val="${intAttr(formatting.position)}"/>`);
-	if (formatting.fontSize !== void 0) parts.push(`<w:sz w:val="${intAttr(formatting.fontSize)}"/>`);
-	if (formatting.fontSizeCs !== void 0) parts.push(`<w:szCs w:val="${intAttr(formatting.fontSizeCs)}"/>`);
-	let customHighlightShadingXml = "";
-	if (formatting.highlight) {
-		if (VALID_HIGHLIGHT_COLORS.has(formatting.highlight)) parts.push(`<w:highlight w:val="${formatting.highlight}"/>`);
-		else if (!formatting.shading) {
-			const hex = formatting.highlight.replace(/^#/u, "");
-			if (/^[0-9a-fA-F]{6}$/u.test(hex)) customHighlightShadingXml = `<w:shd w:val="clear" w:color="auto" w:fill="${hex}"/>`;
-		}
-	}
-	if (formatting.underline) {
-		const uAttrs = [`w:val="${formatting.underline.style}"`];
-		if (formatting.underline.color) {
-			if (formatting.underline.color.rgb && isValidHexColor(formatting.underline.color.rgb)) uAttrs.push(`w:color="${escapeXml(formatting.underline.color.rgb)}"`);
-			if (formatting.underline.color.themeColor) uAttrs.push(`w:themeColor="${escapeXml(formatting.underline.color.themeColor)}"`);
-			if (formatting.underline.color.themeTint) uAttrs.push(`w:themeTint="${escapeXml(formatting.underline.color.themeTint)}"`);
-			if (formatting.underline.color.themeShade) uAttrs.push(`w:themeShade="${escapeXml(formatting.underline.color.themeShade)}"`);
-		}
-		parts.push(`<w:u ${uAttrs.join(" ")}/>`);
-	}
-	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}"/>`);
-	if (formatting.rtl === true) parts.push("<w:rtl/>");
-	else if (formatting.rtl === false) parts.push("<w:rtl w:val=\"0\"/>");
-	if (formatting.cs === true) parts.push("<w:cs/>");
-	else if (formatting.cs === false) parts.push("<w:cs w:val=\"0\"/>");
-	if (formatting.emphasisMark) parts.push(`<w:em w:val="${formatting.emphasisMark}"/>`);
-	if (formatting.language) {
-		const languageAttrs = [];
-		if (formatting.language.val) languageAttrs.push(`w:val="${escapeXml(formatting.language.val)}"`);
-		if (formatting.language.eastAsia) languageAttrs.push(`w:eastAsia="${escapeXml(formatting.language.eastAsia)}"`);
-		if (formatting.language.bidi) languageAttrs.push(`w:bidi="${escapeXml(formatting.language.bidi)}"`);
-		if (languageAttrs.length > 0) parts.push(`<w:lang ${languageAttrs.join(" ")}/>`);
-	}
-	if (parts.length === 0) return "";
-	return `<w:rPr>${parts.join("")}</w:rPr>`;
-}
 function extractRPrInner(rPrXml) {
 	if (!rPrXml.startsWith("<w:rPr>") || !rPrXml.endsWith("</w:rPr>")) return "";
 	return rPrXml.slice(7, -8);
@@ -572,7 +446,7 @@ function serializeRunContent(content) {
 		case "noBreakHyphen": return serializeNoBreakHyphen(content);
 		case "renderedPageBreak": return "<w:lastRenderedPageBreak/>";
 		case "drawing":
-			if (content.rawXml) return content.rawXml;
+			if (content.rawXml && canReplayEditableImageRawXml(content)) return content.rawXml;
 			return serializeDrawingContent(content);
 		case "shape": return serializeShapeContent(content);
 		default: return "";
@@ -667,4 +541,4 @@ function createTabRun(formatting) {
 	};
 }
 //#endregion
-export { createBreakRun, createEmptyRun, createTabRun, createTextRun, getRunPlainText, hasRunContent, hasRunFormatting, resetAutoIdCounter, serializeRun, serializeRuns, serializeTextFormatting };
+export { createBreakRun, createEmptyRun, createTabRun, createTextRun, getRunPlainText, hasRunContent, hasRunFormatting, resetAutoIdCounter, serializeRun, serializeRuns };

package/dist/docx/serializer/sectionPropertiesSerializer.js

@@ -1,4 +1,5 @@
 import { getUnserializedSectionPropertyChildNames } from "../sectionParser.js";
+import { serializeSectionReferenceHistory } from "../sectionReferenceHistory.js";
 import { serializeBorder } from "./borderSerializer.js";
 import { serializeTrackedChangeAttributes } from "./trackedChangeAttributes.js";
 import { escapeXml, intAttr } from "./xmlUtils.js";
@@ -133,8 +134,10 @@ function serializeOnOffElement(value, name) {
 	return value ? `<w:${name}/>` : `<w:${name} w:val="0"/>`;
 }
 function serializeSectionPropertyChange(change) {
-	const previousSectPrXml = serializeSectionProperties(change.previousProperties) || "<w:sectPr/>";
-	return `<w:sectPrChange ${serializeTrackedChangeAttributes(change.info)}>${previousSectPrXml}</w:sectPrChange>`;
+	const { headerReferences: _headers, footerReferences: _footers, ...previous } = change.previousProperties ?? {};
+	const previousSectPrXml = serializeSectionProperties(previous) || "<w:sectPr/>";
+	const history = serializeSectionReferenceHistory(change.previousReferences);
+	return `<w:sectPrChange ${serializeTrackedChangeAttributes(change.info)}>${previousSectPrXml}${history}</w:sectPrChange>`;
 }
 function serializeSectionProperties(props) {
 	if (!props) return "";

package/dist/docx/serializer/stylesSerializer.js

@@ -1,7 +1,7 @@
 import { serializeParagraphFormatting } from "./paragraphSerializer.js";
 import { serializePartElement } from "./partNamespaces.js";
-import { serializeTextFormatting } from "./runSerializer.js";
 import { serializeTableCellFormatting, serializeTableFormatting, serializeTableRowFormatting } from "./tableSerializer.js";
+import { serializeTextFormatting } from "./textFormattingSerializer.js";
 import { escapeXml } from "./xmlUtils.js";
 //#region src/docx/serializer/stylesSerializer.ts
 const serializeStylesXml = (definitions) => {

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

@@ -0,0 +1,17 @@
+import { document_d_exports } from "../../types/document.js";
+//#region src/docx/serializer/textFormattingSerializer.d.ts
+type ExhaustiveFields<Source, Classified extends keyof Source> = Exclude<keyof Source, Classified> extends never ? Source : never;
+type ClassifiedShadingField = "color" | "fill" | "pattern";
+type ExhaustiveShadingProperties = ExhaustiveFields<document_d_exports.ShadingProperties, ClassifiedShadingField>;
+type ClassifiedTextFormattingField = "bold" | "boldCs" | "italic" | "italicCs" | "underline" | "strike" | "doubleStrike" | "vertAlign" | "smallCaps" | "allCaps" | "hidden" | "noProof" | "color" | "highlight" | "shading" | "fontSize" | "fontSizeCs" | "fontFamily" | "language" | "spacing" | "position" | "scale" | "kerning" | "effect" | "emphasisMark" | "emboss" | "imprint" | "outline" | "shadow" | "rtl" | "cs" | "styleId";
+type ExhaustiveTextFormatting = ExhaustiveFields<document_d_exports.TextFormatting, ClassifiedTextFormattingField>;
+/**
+ * Serialize shading properties (w:shd)
+ */
+declare function serializeShading(shading: ExhaustiveShadingProperties | undefined): string;
+/**
+ * Serialize text formatting properties to w:rPr XML
+ */
+declare function serializeTextFormatting(input: ExhaustiveTextFormatting | undefined): string;
+//#endregion
+export { serializeShading, serializeTextFormatting };

package/dist/docx/serializer/textFormattingSerializer.js

@@ -0,0 +1,144 @@
+import { HIGHLIGHT_COLOR_VALUES } from "../../types/documentEnumValues.js";
+import { isValidHexColor } from "../../utils/colorResolver.js";
+import { roundHorizontalScalePercentForSerialization } from "../../utils/horizontalScale.js";
+import { escapeXml, intAttr } from "./xmlUtils.js";
+//#region src/docx/serializer/textFormattingSerializer.ts
+const VALID_HIGHLIGHT_COLORS = new Set(HIGHLIGHT_COLOR_VALUES);
+/**
+* Serialize a color element (w:color)
+*/
+function serializeColorElement(color) {
+	if (!color) return "";
+	const { auto, rgb, themeColor, themeTint, themeShade } = color;
+	const attrs = [];
+	if (auto) attrs.push("w:val=\"auto\"");
+	else if (rgb && isValidHexColor(rgb)) attrs.push(`w:val="${escapeXml(rgb)}"`);
+	if (themeColor) attrs.push(`w:themeColor="${escapeXml(themeColor)}"`);
+	if (themeTint) attrs.push(`w:themeTint="${escapeXml(themeTint)}"`);
+	if (themeShade) attrs.push(`w:themeShade="${escapeXml(themeShade)}"`);
+	return attrs.length === 0 ? "" : `<w:color ${attrs.join(" ")}/>`;
+}
+/**
+* Serialize shading properties (w:shd)
+*/
+function serializeShading(shading) {
+	if (!shading) return "";
+	const { pattern, color, fill } = shading;
+	const attrs = [];
+	if (pattern) attrs.push(`w:val="${escapeXml(pattern)}"`);
+	else attrs.push("w:val=\"clear\"");
+	if (color) {
+		const { rgb, auto, themeColor: _themeColor, themeTint: _themeTint, themeShade: _themeShade } = color;
+		if (rgb && isValidHexColor(rgb)) attrs.push(`w:color="${escapeXml(rgb)}"`);
+		else if (auto) attrs.push("w:color=\"auto\"");
+	}
+	if (fill) {
+		const { rgb, auto, themeColor, themeTint, themeShade } = fill;
+		if (rgb && isValidHexColor(rgb)) attrs.push(`w:fill="${escapeXml(rgb)}"`);
+		else if (auto) attrs.push("w:fill=\"auto\"");
+		if (themeColor) attrs.push(`w:themeFill="${escapeXml(themeColor)}"`);
+		if (themeTint) attrs.push(`w:themeFillTint="${escapeXml(themeTint)}"`);
+		if (themeShade) attrs.push(`w:themeFillShade="${escapeXml(themeShade)}"`);
+	}
+	return attrs.length === 0 ? "" : `<w:shd ${attrs.join(" ")}/>`;
+}
+/**
+* Serialize text formatting properties to w:rPr XML
+*/
+function serializeTextFormatting(input) {
+	if (!input) return "";
+	const { bold, boldCs, italic, italicCs, underline, strike, doubleStrike, vertAlign, smallCaps, allCaps, hidden, noProof, color, highlight, shading, fontSize, fontSizeCs, fontFamily, language, spacing, position, scale, kerning, effect, emphasisMark, emboss, imprint, outline, shadow, rtl, cs, styleId } = input;
+	const parts = [];
+	if (styleId) parts.push(`<w:rStyle w:val="${escapeXml(styleId)}"/>`);
+	if (fontFamily) {
+		const { ascii, hAnsi, eastAsia, cs: complexScript, hint, asciiTheme, hAnsiTheme, eastAsiaTheme, csTheme } = fontFamily;
+		const fontAttrs = [];
+		if (ascii) fontAttrs.push(`w:ascii="${escapeXml(ascii)}"`);
+		if (hAnsi) fontAttrs.push(`w:hAnsi="${escapeXml(hAnsi)}"`);
+		if (eastAsia) fontAttrs.push(`w:eastAsia="${escapeXml(eastAsia)}"`);
+		if (complexScript) fontAttrs.push(`w:cs="${escapeXml(complexScript)}"`);
+		if (hint) fontAttrs.push(`w:hint="${escapeXml(hint)}"`);
+		if (asciiTheme) fontAttrs.push(`w:asciiTheme="${escapeXml(asciiTheme)}"`);
+		if (hAnsiTheme) fontAttrs.push(`w:hAnsiTheme="${escapeXml(hAnsiTheme)}"`);
+		if (eastAsiaTheme) fontAttrs.push(`w:eastAsiaTheme="${escapeXml(eastAsiaTheme)}"`);
+		if (csTheme) fontAttrs.push(`w:cstheme="${escapeXml(csTheme)}"`);
+		if (fontAttrs.length > 0) parts.push(`<w:rFonts ${fontAttrs.join(" ")}/>`);
+	}
+	if (bold === true) parts.push("<w:b/>");
+	else if (bold === false) parts.push("<w:b w:val=\"0\"/>");
+	if (boldCs === true) parts.push("<w:bCs/>");
+	else if (boldCs === false) parts.push("<w:bCs w:val=\"0\"/>");
+	if (italic === true) parts.push("<w:i/>");
+	else if (italic === false) parts.push("<w:i w:val=\"0\"/>");
+	if (italicCs === true) parts.push("<w:iCs/>");
+	else if (italicCs === false) parts.push("<w:iCs w:val=\"0\"/>");
+	if (allCaps === true) parts.push("<w:caps/>");
+	else if (allCaps === false) parts.push("<w:caps w:val=\"0\"/>");
+	if (smallCaps === true) parts.push("<w:smallCaps/>");
+	else if (smallCaps === false) parts.push("<w:smallCaps w:val=\"0\"/>");
+	if (strike === true) parts.push("<w:strike/>");
+	else if (strike === false) parts.push("<w:strike w:val=\"0\"/>");
+	if (doubleStrike === true) parts.push("<w:dstrike/>");
+	else if (doubleStrike === false) parts.push("<w:dstrike w:val=\"0\"/>");
+	if (outline === true) parts.push("<w:outline/>");
+	else if (outline === false) parts.push("<w:outline w:val=\"0\"/>");
+	if (shadow === true) parts.push("<w:shadow/>");
+	else if (shadow === false) parts.push("<w:shadow w:val=\"0\"/>");
+	if (emboss === true) parts.push("<w:emboss/>");
+	else if (emboss === false) parts.push("<w:emboss w:val=\"0\"/>");
+	if (imprint === true) parts.push("<w:imprint/>");
+	else if (imprint === false) parts.push("<w:imprint w:val=\"0\"/>");
+	if (hidden === true) parts.push("<w:vanish/>");
+	else if (hidden === false) parts.push("<w:vanish w:val=\"0\"/>");
+	if (noProof === true) parts.push("<w:noProof/>");
+	else if (noProof === false) parts.push("<w:noProof w:val=\"0\"/>");
+	const colorXml = serializeColorElement(color);
+	if (colorXml) parts.push(colorXml);
+	if (spacing !== void 0) parts.push(`<w:spacing w:val="${intAttr(spacing)}"/>`);
+	const horizontalScale = roundHorizontalScalePercentForSerialization(scale);
+	if (horizontalScale !== void 0) parts.push(`<w:w w:val="${intAttr(horizontalScale)}"/>`);
+	if (kerning !== void 0) parts.push(`<w:kern w:val="${intAttr(kerning)}"/>`);
+	if (position !== void 0) parts.push(`<w:position w:val="${intAttr(position)}"/>`);
+	if (fontSize !== void 0) parts.push(`<w:sz w:val="${intAttr(fontSize)}"/>`);
+	if (fontSizeCs !== void 0) parts.push(`<w:szCs w:val="${intAttr(fontSizeCs)}"/>`);
+	let customHighlightShadingXml = "";
+	if (highlight) {
+		if (VALID_HIGHLIGHT_COLORS.has(highlight)) parts.push(`<w:highlight w:val="${highlight}"/>`);
+		else if (!shading) {
+			const hex = highlight.replace(/^#/u, "");
+			if (/^[0-9a-fA-F]{6}$/u.test(hex)) customHighlightShadingXml = `<w:shd w:val="clear" w:color="auto" w:fill="${hex}"/>`;
+		}
+	}
+	if (underline) {
+		const { style, color: underlineColor } = underline;
+		const uAttrs = [`w:val="${style}"`];
+		if (underlineColor) {
+			const { rgb, themeColor, themeTint, themeShade, auto: _auto } = underlineColor;
+			if (rgb && isValidHexColor(rgb)) uAttrs.push(`w:color="${escapeXml(rgb)}"`);
+			if (themeColor) uAttrs.push(`w:themeColor="${escapeXml(themeColor)}"`);
+			if (themeTint) uAttrs.push(`w:themeTint="${escapeXml(themeTint)}"`);
+			if (themeShade) uAttrs.push(`w:themeShade="${escapeXml(themeShade)}"`);
+		}
+		parts.push(`<w:u ${uAttrs.join(" ")}/>`);
+	}
+	if (effect) parts.push(`<w:effect w:val="${effect}"/>`);
+	const shadingXml = serializeShading(shading) || customHighlightShadingXml;
+	if (shadingXml) parts.push(shadingXml);
+	if (vertAlign) parts.push(`<w:vertAlign w:val="${vertAlign}"/>`);
+	if (rtl === true) parts.push("<w:rtl/>");
+	else if (rtl === false) parts.push("<w:rtl w:val=\"0\"/>");
+	if (cs === true) parts.push("<w:cs/>");
+	else if (cs === false) parts.push("<w:cs w:val=\"0\"/>");
+	if (emphasisMark) parts.push(`<w:em w:val="${emphasisMark}"/>`);
+	if (language) {
+		const { val, eastAsia, bidi } = language;
+		const languageAttrs = [];
+		if (val) languageAttrs.push(`w:val="${escapeXml(val)}"`);
+		if (eastAsia) languageAttrs.push(`w:eastAsia="${escapeXml(eastAsia)}"`);
+		if (bidi) languageAttrs.push(`w:bidi="${escapeXml(bidi)}"`);
+		if (languageAttrs.length > 0) parts.push(`<w:lang ${languageAttrs.join(" ")}/>`);
+	}
+	return parts.length === 0 ? "" : `<w:rPr>${parts.join("")}</w:rPr>`;
+}
+//#endregion
+export { serializeShading, serializeTextFormatting };

package/dist/docx/tableParser.js

@@ -5,7 +5,7 @@ import { enrichParagraphTextBoxes } from "./paragraphTextBoxEnrichment.js";
 import { BorderStyleSchema, FloatingTableXSpecSchema, FloatingTableYSpecSchema, ShadingPatternSchema, TableCellTextDirectionSchema, ThemeColorSlotSchema, narrowEnum } from "./parserEnums.js";
 import { parsePropertyChangeInfo, parseTrackedChangeInfo } from "./trackedChangeInfo.js";
 import { captureVerbatimXml } from "./verbatimCapture.js";
-import { cloneElement, findChild, findChildByLocalName, findChildren, getAttribute, getChildElements, getLocalName, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute, parseTableMeasurementValue } from "./xmlParser.js";
+import { cloneElement, findChild, findChildByLocalName, findChildren, getAttribute, getChildElements, getLocalName, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute, parseTableMeasurementValue, selectAlternateContentBranch } from "./xmlParser.js";
 //#region src/docx/tableParser.ts
 /**
 * Sanity cap on `w:gridSpan` (and the derived table column count). Word's
@@ -531,27 +531,35 @@ function parseCellContent(tcElement, styles, theme, numbering, rels, media, opti
 	const content = [];
 	const pendingBookmarkMarkers = [];
 	const elements = getChildElements(tcElement);
-	const parseCellChild = (child) => {
+	const parseCellChild = (child, childOptions = options) => {
 		if (!child.name) return;
 		const localName = getLocalName(child.name);
 		if (localName === "p") {
-			const para = parseParagraph(child, styles, theme, numbering, rels, media, options);
+			const para = parseParagraph(child, styles, theme, numbering, rels, media, childOptions);
 			enrichParagraphTextBoxes(para, child, styles, theme, numbering, rels, media, parseTable);
 			prependPendingBookmarkMarkers(para, pendingBookmarkMarkers);
 			content.push(para);
 			return;
 		}
 		if (localName === "tbl") {
-			const table = parseTable(child, styles, theme, numbering, rels, media, options);
+			const table = parseTable(child, styles, theme, numbering, rels, media, childOptions);
 			if (!table) return;
 			if (prependBookmarkMarkersToFirstParagraphInBlocks([table], pendingBookmarkMarkers)) pendingBookmarkMarkers.length = 0;
 			content.push(table);
 			return;
 		}
+		if (localName === "AlternateContent") {
+			const selectedBranch = selectAlternateContentBranch(child);
+			if (!selectedBranch) return;
+			const branchOptions = withContainerXmlns(withContainerXmlns(childOptions, child), selectedBranch);
+			for (const selectedChild of getChildElements(selectedBranch)) parseCellChild(selectedChild, branchOptions);
+			return;
+		}
 		if (localName === "sdt") {
 			const sdtContent = findChildByLocalName(child, "sdtContent");
 			if (!sdtContent) return;
-			for (const sdtChild of getChildElements(sdtContent)) parseCellChild(sdtChild);
+			const sdtContentOptions = withContainerXmlns(withContainerXmlns(childOptions, child), sdtContent);
+			for (const sdtChild of getChildElements(sdtContent)) parseCellChild(sdtChild, sdtContentOptions);
 			return;
 		}
 		if (localName === "bookmarkStart" || localName === "bookmarkEnd") {
@@ -618,10 +626,10 @@ function parseTableRow(trElement, styles, theme, numbering, rels, media, options
 	if (rowStructChange !== void 0) row.structuralChange = rowStructChange;
 	const rowOptions = withContainerXmlns(options, trElement);
 	const pendingBookmarkMarkers = [];
-	const parseRowChild = (child) => {
+	const parseRowChild = (child, childOptions = rowOptions) => {
 		const localName = getLocalName(child.name);
 		if (localName === "tc") {
-			const cell = parseTableCell(child, styles, theme, numbering, rels, media, rowOptions);
+			const cell = parseTableCell(child, styles, theme, numbering, rels, media, childOptions);
 			if (pendingBookmarkMarkers.length > 0) {
 				prependBookmarkMarkersToFirstParagraphInCell(cell, pendingBookmarkMarkers);
 				pendingBookmarkMarkers.length = 0;
@@ -632,7 +640,8 @@ function parseTableRow(trElement, styles, theme, numbering, rels, media, options
 		if (localName === "sdt") {
 			const sdtContent = findChildByLocalName(child, "sdtContent");
 			if (!sdtContent) return;
-			for (const sdtChild of getChildElements(sdtContent)) parseRowChild(sdtChild);
+			const sdtContentOptions = withContainerXmlns(withContainerXmlns(childOptions, child), sdtContent);
+			for (const sdtChild of getChildElements(sdtContent)) parseRowChild(sdtChild, sdtContentOptions);
 			return;
 		}
 		if (localName !== "bookmarkStart" && localName !== "bookmarkEnd") return;
@@ -744,11 +753,11 @@ function parseTable(tblElement, styles, theme, numbering, rels, media, options)
 	};
 	const tableOptions = withContainerXmlns(options, tblElement);
 	const rowsWithGridOffsets = /* @__PURE__ */ new Set();
-	const parseTableChild = (child) => {
+	const parseTableChild = (child, childOptions = tableOptions) => {
 		const localName = getLocalName(child.name);
 		if (localName === "tr") {
 			const rowIndex = table.rows.length;
-			const row = parseTableRow(child, styles, theme, numbering, rels, media, tableOptions);
+			const row = parseTableRow(child, styles, theme, numbering, rels, media, childOptions);
 			table.rows.push(row);
 			if (hasRowGridOffsets(child)) rowsWithGridOffsets.add(rowIndex);
 			return;
@@ -756,7 +765,8 @@ function parseTable(tblElement, styles, theme, numbering, rels, media, options)
 		if (localName !== "sdt") return;
 		const sdtContent = findChildByLocalName(child, "sdtContent");
 		if (!sdtContent) return;
-		for (const sdtChild of getChildElements(sdtContent)) parseTableChild(sdtChild);
+		const sdtContentOptions = withContainerXmlns(withContainerXmlns(childOptions, child), sdtContent);
+		for (const sdtChild of getChildElements(sdtContent)) parseTableChild(sdtChild, sdtContentOptions);
 	};
 	for (const child of getChildElements(tblElement)) parseTableChild(child);
 	if (table.rows.length === 0) return;

package/dist/docx/xmlParser.d.ts

@@ -111,6 +111,8 @@ declare function getNamespacePrefix(name: string): string | null;
 declare const getNamespaceUri: (element: XmlElement) => string | undefined;
 /** WordprocessingML main namespace, Transitional and Strict (ECMA-376 Parts 1 and 4). */
 declare const WORDPROCESSINGML_NAMESPACE_URIS: ReadonlySet<string>;
+/** Office document relationship attributes, Transitional and Strict. */
+declare const OFFICE_RELATIONSHIP_NAMESPACE_URIS: ReadonlySet<string>;
 /**
  * First child whose local name matches AND whose resolved namespace URI is
  * one of `namespaceUris`. Unlike {@link findChild}, a same-named element
@@ -184,6 +186,13 @@ declare function findByFullName(parent: XmlElement | null | undefined, fullName:
  * @returns Array of child elements
  */
 declare function getChildElements(parent: XmlElement | null | undefined): XmlElement[];
+/**
+ * Folio's normalized Markup Compatibility policy: use the first Choice, which
+ * is the established parser behavior when `mc:Requires` cannot be evaluated;
+ * use Fallback only when there is no Choice. Callers serialize that selected
+ * branch as ordinary WordprocessingML rather than concatenating alternatives.
+ */
+declare function selectAlternateContentBranch(alternateContent: XmlElement): XmlElement | undefined;
 /**
  * Get an attribute value from an element
  *
@@ -369,4 +378,4 @@ declare function cloneWithXmlnsDeclarations(element: XmlElement, xmlnsDecls: Rec
  */
 declare function cloneElement(element: XmlElement, overrides: Partial<XmlElement>): XmlElement;
 //#endregion
-export { NAMESPACES, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, XmlAttributeMatch, XmlElement, XmlNamespaceScope, attachXmlNamespaceContext, cloneElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findChildrenByNamespaceUri, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument };
+export { NAMESPACES, OFFICE_RELATIONSHIP_NAMESPACE_URIS, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, XmlAttributeMatch, XmlElement, XmlNamespaceScope, attachXmlNamespaceContext, cloneElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findChildrenByNamespaceUri, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument, selectAlternateContentBranch };

package/dist/docx/xmlParser.js

@@ -217,6 +217,8 @@ function getNamespacePrefix(name) {
 const getNamespaceUri = (element) => element.namespaceUri;
 /** WordprocessingML main namespace, Transitional and Strict (ECMA-376 Parts 1 and 4). */
 const WORDPROCESSINGML_NAMESPACE_URIS = /* @__PURE__ */ new Set([NAMESPACES.w, "http://purl.oclc.org/ooxml/wordprocessingml/main"]);
+/** Office document relationship attributes, Transitional and Strict. */
+const OFFICE_RELATIONSHIP_NAMESPACE_URIS = /* @__PURE__ */ new Set([NAMESPACES.r, "http://purl.oclc.org/ooxml/officeDocument/relationships"]);
 /**
 * First child whose local name matches AND whose resolved namespace URI is
 * one of `namespaceUris`. Unlike {@link findChild}, a same-named element
@@ -355,6 +357,26 @@ function getChildElements(parent) {
 	return results;
 }
 /**
+* Folio's normalized Markup Compatibility policy: use the first Choice, which
+* is the established parser behavior when `mc:Requires` cannot be evaluated;
+* use Fallback only when there is no Choice. Callers serialize that selected
+* branch as ordinary WordprocessingML rather than concatenating alternatives.
+*/
+function selectAlternateContentBranch(alternateContent) {
+	let fallback;
+	for (const child of getChildElements(alternateContent)) {
+		if (getNamespaceUri(child) !== NAMESPACES.mc) continue;
+		switch (getLocalName(child.name)) {
+			case "Choice": return child;
+			case "Fallback":
+				fallback ??= child;
+				break;
+			default: break;
+		}
+	}
+	return fallback;
+}
+/**
 * Get an attribute value from an element
 *
 * @param element - Element to get attribute from
@@ -788,4 +810,4 @@ function cloneElement(element, overrides) {
 	return clone;
 }
 //#endregion
-export { NAMESPACES, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, attachXmlNamespaceContext, cloneElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findChildrenByNamespaceUri, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument };
+export { NAMESPACES, OFFICE_RELATIONSHIP_NAMESPACE_URIS, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, attachXmlNamespaceContext, cloneElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findChildrenByNamespaceUri, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument, selectAlternateContentBranch };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { document_d_exports } from "./types/document.js";
-import { FolioContentBlock, FolioContentContainerPathEntry, FolioContentIdStability, FolioContentInlineBooleanProperty, FolioContentInlineFormatting, FolioContentInlineFormattingPatch, FolioContentLineSpacingRule, FolioContentParagraphAlignment, FolioContentParagraphSpacing, FolioContentRun, FolioContentSnapshot, FolioContentTableLocation } from "./compare/content-types.js";
+import { FolioContentBlock, FolioContentContainerPathEntry, FolioContentFormatRange, FolioContentIdStability, FolioContentInlineBooleanProperty, FolioContentInlineComparisonResult, FolioContentInlineFormatting, FolioContentInlineFormattingPatch, FolioContentLineSpacingRule, FolioContentParagraphAlignment, FolioContentParagraphKind, 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";
@@ -11,9 +11,9 @@ 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 { COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, CompareChange, CompareChangeLocation, CompareCompatibility, CompareDocxApplyError, CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, CompareFolioRequirement, CompareResult, CompareRevisionFormat, CompareUnsupportedPart, CompareUnsupportedReason, InvalidCompareDocxOptionsError } from "./compare/types.js";
+import { CompareContentOptions, FOLIO_CONTENT_COMPARISON_LIMITS, FolioContentBlockProperty, FolioContentComparison, FolioContentComparisonError, FolioContentComparisonEvent, FolioContentComparisonLimit, FolioContentComparisonLimitError, FolioContentFormattingChange, FolioContentInlinePresentationProjectionError, FolioContentParagraphFormattingPatch, FolioContentStructuralChange, FolioContentTextSegment, InvalidFolioContentComparisonError, compareContent } from "./compare/content.js";
 import { MAX_COMPARE_OPERATIONS, compareDocx } from "./compare/compare.js";
 import { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DocumentPreset, DocumentStyleSet } from "./style-sets/types.js";
 import { CreateEmptyDocumentOptions, createEmptyDocument } from "./utils/createDocument.js";
@@ -40,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, 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 };
+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_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, type CompareChange, type CompareChangeLocation, type CompareCompatibility, type CompareContentOptions, CompareDocxApplyError, type CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, type CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, type CompareFolioRequirement, type CompareResult, type CompareRevisionFormat, 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 FolioContentInlineComparisonResult, type FolioContentInlineFormatting, type FolioContentInlineFormattingPatch, FolioContentInlinePresentationProjectionError, type FolioContentLineSpacingRule, type FolioContentParagraphAlignment, type FolioContentParagraphFormattingPatch, type FolioContentParagraphKind, 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,8 +6,8 @@ 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 { FOLIO_CONTENT_COMPARISON_LIMITS, FolioContentComparisonLimitError, FolioContentInlinePresentationProjectionError, InvalidFolioContentComparisonError, compareContent } from "./compare/content.js";
+import { COMPARE_REVISION_FORMATS, 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_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";
@@ -32,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_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 };
+export { COMPARE_REVISION_FORMATS, 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, FolioContentInlinePresentationProjectionError, 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 };