@stll/folio-core 0.14.1 → 0.15.1

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

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
-
 //#region src/docx/serializer/documentSerializer.d.ts
 /**
  * Serialize a DocumentBody to document.xml body content

package/dist/docx/serializer/documentSerializer.js

@@ -1,8 +1,8 @@
-import { serializeBlockSdt } from "./blockSdtSerializer.js";
 import { serializeTable } from "./tableSerializer.js";
 import { resetAutoIdCounter } from "./runSerializer.js";
 import { serializeSectionProperties } from "./sectionPropertiesSerializer.js";
 import { serializeParagraph } from "./paragraphSerializer.js";
+import { serializeBlockSdt } from "./blockSdtSerializer.js";
 //#region src/docx/serializer/documentSerializer.ts
 /**
 * Standard OOXML namespaces for document.xml

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

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
-
 //#region src/docx/serializer/fontTableSerializer.d.ts
 declare const serializeFontTableXml: (fontTable: document_d_exports.FontTable) => string;
 //#endregion

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

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
-
 //#region src/docx/serializer/headerFooterSerializer.d.ts
 /**
  * Serialize a HeaderFooter object to valid OOXML XML

package/dist/docx/serializer/headerFooterSerializer.js

@@ -1,8 +1,8 @@
 import { canReplayHeaderFooterVerbatim, getHeaderFooterVerbatimXml } from "../headerFooterVerbatim.js";
 import { escapeXml } from "./xmlUtils.js";
-import { serializeBlockSdt } from "./blockSdtSerializer.js";
 import { serializeTable } from "./tableSerializer.js";
 import { serializeParagraph } from "./paragraphSerializer.js";
+import { serializeBlockSdt } from "./blockSdtSerializer.js";
 //#region src/docx/serializer/headerFooterSerializer.ts
 const NAMESPACES = {
 	wpc: "http://schemas.microsoft.com/office/word/2010/wordprocessingCanvas",

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

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
-
 //#region src/docx/serializer/noteSerializer.d.ts
 /**
  * Serialize footnotes to a complete word/footnotes.xml string.

package/dist/docx/serializer/noteSerializer.js

@@ -1,6 +1,6 @@
-import { serializeBlockSdt } from "./blockSdtSerializer.js";
 import { serializeTable } from "./tableSerializer.js";
 import { serializeParagraph } from "./paragraphSerializer.js";
+import { serializeBlockSdt } from "./blockSdtSerializer.js";
 //#region src/docx/serializer/noteSerializer.ts
 const NAMESPACES = {
 	wpc: "http://schemas.microsoft.com/office/word/2010/wordprocessingCanvas",

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

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
-
 //#region src/docx/serializer/numberingSerializer.d.ts
 /**
  * Serialize {@link NumberingDefinitions} to a complete `word/numbering.xml`

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

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
-
 //#region src/docx/serializer/paragraphSerializer.d.ts
 declare function serializeParagraphFormatting(formatting: document_d_exports.ParagraphFormatting | undefined, propertyChanges?: document_d_exports.ParagraphPropertyChange[], pPrMark?: document_d_exports.ParagraphMarkChange): string;
 /**

package/dist/docx/serializer/paragraphSerializer.js

@@ -1,7 +1,7 @@
 import { numPrEqual } from "../numberingParser.js";
 import { isValidHexColor } from "../../utils/colorResolver.js";
-import { escapeXml, intAttr, isSingleWellFormedElement } from "./xmlUtils.js";
 import { reconcileRawSdtPr } from "../sdtPropertiesPatch.js";
+import { escapeXml, intAttr, isSingleWellFormedElement } from "./xmlUtils.js";
 import { serializeBorder } from "./borderSerializer.js";
 import { serializeRun, serializeTextFormatting } from "./runSerializer.js";
 import { serializeSectionProperties } from "./sectionPropertiesSerializer.js";
@@ -90,10 +90,8 @@ function serializeIndentation(formatting) {
 	const attrs = [];
 	if (formatting.indentLeft !== void 0) attrs.push(`w:left="${intAttr(formatting.indentLeft)}"`);
 	if (formatting.indentRight !== void 0) attrs.push(`w:right="${intAttr(formatting.indentRight)}"`);
-	if (formatting.indentFirstLine !== void 0) {
-		if (formatting.hangingIndent) attrs.push(`w:hanging="${intAttr(Math.abs(formatting.indentFirstLine))}"`);
-		else if (formatting.indentFirstLine !== 0) attrs.push(`w:firstLine="${intAttr(formatting.indentFirstLine)}"`);
-	}
+	if (formatting.indentFirstLine !== void 0) if (formatting.hangingIndent) attrs.push(`w:hanging="${intAttr(Math.abs(formatting.indentFirstLine))}"`);
+	else attrs.push(`w:firstLine="${intAttr(formatting.indentFirstLine)}"`);
 	if (attrs.length === 0) return "";
 	return `<w:ind ${attrs.join(" ")}/>`;
 }
@@ -246,24 +244,13 @@ function serializeBookmarkStart(bookmark) {
 function serializeBookmarkEnd(bookmark) {
 	return `<w:bookmarkEnd w:id="${bookmark.id}"/>`;
 }
-/**
-* Serialize a simple field as a complex field (fldChar begin/separate/end).
-* Complex field format is more widely supported by OOXML consumers
-* (Google Docs, Apple Pages) than w:fldSimple.
-*/
+/** Serialize a simple field without changing its authored OOXML field form. */
 function serializeSimpleField(field) {
-	const parts = [];
-	const firstRun = field.content.find((c) => c.type === "run");
-	const rPrXml = firstRun?.formatting ? serializeTextFormatting(firstRun.formatting) : "";
-	const beginAttrs = ["w:fldCharType=\"begin\""];
-	if (field.fldLock) beginAttrs.push("w:fldLock=\"true\"");
-	parts.push(`<w:r>${rPrXml}<w:fldChar ${beginAttrs.join(" ")}/></w:r>`);
-	const spaceAttr = field.instruction.startsWith(" ") || field.instruction.endsWith(" ") || field.instruction.includes("  ") ? " xml:space=\"preserve\"" : "";
-	parts.push(`<w:r>${rPrXml}<w:instrText${spaceAttr}>${escapeXml(field.instruction)}</w:instrText></w:r>`);
-	parts.push(`<w:r>${rPrXml}<w:fldChar w:fldCharType="separate"/></w:r>`);
-	for (const item of field.content) if (item.type === "run") parts.push(serializeRun(item));
-	parts.push(`<w:r>${rPrXml}<w:fldChar w:fldCharType="end"/></w:r>`);
-	return parts.join("");
+	const attrs = [`w:instr="${escapeXml(field.instruction)}"`];
+	if (field.fldLock) attrs.push("w:fldLock=\"true\"");
+	if (field.dirty) attrs.push("w:dirty=\"true\"");
+	const contentXml = field.content.map((item) => item.type === "run" ? serializeRun(item) : serializeHyperlink(item)).join("");
+	return `<w:fldSimple ${attrs.join(" ")}>${contentXml}</w:fldSimple>`;
 }
 /**
 * Serialize a complex field
@@ -278,7 +265,7 @@ function serializeComplexField(field) {
 	if (field.fldLock) beginAttrs.push("w:fldLock=\"true\"");
 	parts.push(`<w:r>${rPrXml}<w:fldChar ${beginAttrs.join(" ")}/></w:r>`);
 	if (field.fieldCode.length > 0) parts.push(...field.fieldCode.map((run) => serializeRun(run)));
-	else {
+	else if (field.instruction.length > 0) {
 		const spaceAttr = field.instruction.startsWith(" ") || field.instruction.endsWith(" ") || field.instruction.includes("  ") ? " xml:space=\"preserve\"" : "";
 		parts.push(`<w:r>${rPrXml}<w:instrText${spaceAttr}>${escapeXml(field.instruction)}</w:instrText></w:r>`);
 	}

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

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
-
 //#region src/docx/serializer/runSerializer.d.ts
 /**
  * Reset the auto-incrementing ID counter. Call before each serialization pass

package/dist/docx/serializer/runSerializer.js

@@ -1,5 +1,7 @@
 import { HIGHLIGHT_COLOR_VALUES } from "../../types/documentEnumValues.js";
+import { THEME_COLOR_TO_DRAWING_SCHEME } from "../drawingUtils.js";
 import { isValidHexColor } from "../../utils/colorResolver.js";
+import { requiresXmlSpacePreserve } from "../textWhitespace.js";
 import { escapeXml, intAttr } from "./xmlUtils.js";
 import { serializeTable } from "./tableSerializer.js";
 import { serializeParagraph } from "./paragraphSerializer.js";
@@ -82,6 +84,7 @@ function serializeTextFormatting(formatting) {
 		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="${formatting.fontFamily.asciiTheme}"`);
 		if (formatting.fontFamily.hAnsiTheme) fontAttrs.push(`w:hAnsiTheme="${formatting.fontFamily.hAnsiTheme}"`);
 		if (formatting.fontFamily.eastAsiaTheme) fontAttrs.push(`w:eastAsiaTheme="${formatting.fontFamily.eastAsiaTheme}"`);
@@ -183,7 +186,7 @@ function serializeRunProperties(formatting, propertyChanges) {
 * Serialize text content (w:t)
 */
 function serializeTextContent(content) {
-	return `<w:t${content.preserveSpace || content.text.startsWith(" ") || content.text.endsWith(" ") || content.text.includes("  ") ? " xml:space=\"preserve\"" : ""}>${escapeXml(content.text)}</w:t>`;
+	return `<w:t${content.preserveSpace || requiresXmlSpacePreserve(content.text) ? " xml:space=\"preserve\"" : ""}>${escapeXml(content.text)}</w:t>`;
 }
 /**
 * Serialize tab content (w:tab)
@@ -250,7 +253,7 @@ function serializeDrawingColor(color) {
 	if (!color) return "";
 	if (color.rgb && isValidHexColor(color.rgb)) return `<a:srgbClr val="${escapeXml(color.rgb.replace("#", ""))}"/>`;
 	if (color.themeColor) {
-		let clr = `<a:schemeClr val="${escapeXml(color.themeColor)}"`;
+		let clr = `<a:schemeClr val="${THEME_COLOR_TO_DRAWING_SCHEME[color.themeColor]}"`;
 		if (color.themeTint) clr += `><a:tint val="${escapeXml(color.themeTint)}"/></a:schemeClr>`;
 		else if (color.themeShade) clr += `><a:shade val="${escapeXml(color.themeShade)}"/></a:schemeClr>`;
 		else clr += `/>`;
@@ -260,7 +263,8 @@ function serializeDrawingColor(color) {
 }
 /** Serialize shape fill to DrawingML */
 function serializeFill(fill) {
-	if (!fill || fill.type === "none") return "<a:noFill/>";
+	if (!fill) return "";
+	if (fill.type === "none") return "<a:noFill/>";
 	if (fill.type === "solid" && fill.color) return `<a:solidFill>${serializeDrawingColor(fill.color)}</a:solidFill>`;
 	if (fill.type === "gradient" && fill.gradient) {
 		const g = fill.gradient;
@@ -287,7 +291,7 @@ function serializeOutline(outline) {
 	if (outline.cap) attrs.push(`cap="${serializeLineCap(outline.cap)}"`);
 	const parts = [];
 	if (outline.color) parts.push(`<a:solidFill>${serializeDrawingColor(outline.color)}</a:solidFill>`);
-	if (outline.style && outline.style !== "solid") parts.push(`<a:prstDash val="${outline.style}"/>`);
+	if (outline.style) parts.push(`<a:prstDash val="${outline.style}"/>`);
 	if (outline.join === "bevel") parts.push("<a:bevel/>");
 	else if (outline.join === "round") parts.push("<a:round/>");
 	else if (outline.join === "miter") parts.push("<a:miter/>");
@@ -370,6 +374,18 @@ function serializePicGraphic(image, sharedId) {
 	].join("");
 }
 /**
+* Serialize only authored wrap-distance attributes. OOXML defaults omitted
+* values to zero, but preserving absence keeps untouched models stable.
+*/
+function serializeWrapDistanceAttrs(wrap) {
+	const attrs = [];
+	if (wrap?.distT !== void 0) attrs.push(`distT="${intAttr(wrap.distT)}"`);
+	if (wrap?.distB !== void 0) attrs.push(`distB="${intAttr(wrap.distB)}"`);
+	if (wrap?.distL !== void 0) attrs.push(`distL="${intAttr(wrap.distL)}"`);
+	if (wrap?.distR !== void 0) attrs.push(`distR="${intAttr(wrap.distR)}"`);
+	return attrs.length > 0 ? ` ${attrs.join(" ")}` : "";
+}
+/**
 * Serialize drawing/image content (w:drawing) to full DrawingML XML
 */
 function serializeDrawingContent(content) {
@@ -377,24 +393,28 @@ function serializeDrawingContent(content) {
 	const isFloating = image.wrap.type !== "inline";
 	const cx = image.size.width;
 	const cy = image.size.height;
-	const distT = image.wrap.distT ?? 0;
-	const distB = image.wrap.distB ?? 0;
-	const distL = image.wrap.distL ?? 0;
-	const distR = image.wrap.distR ?? 0;
+	const wrapDistanceAttrs = serializeWrapDistanceAttrs(image.wrap);
 	const effL = image.padding?.left ?? 0;
 	const effT = image.padding?.top ?? 0;
 	const effR = image.padding?.right ?? 0;
 	const effB = image.padding?.bottom ?? 0;
 	const effectExtentEl = `<wp:effectExtent l="${intAttr(effL)}" t="${intAttr(effT)}" r="${intAttr(effR)}" b="${intAttr(effB)}"/>`;
 	const docPrId = getUniqueId(image.id);
-	const docPrName = image.title || image.filename || `Picture ${docPrId}`;
+	const docPrName = image.docPrName ?? image.filename ?? `Picture ${docPrId}`;
+	const docPrDescription = image.alt !== void 0 ? ` descr="${escapeXml(image.alt)}"` : "";
+	const docPrTitle = image.title !== void 0 ? ` title="${escapeXml(image.title)}"` : "";
+	const hlinkClick = image.hlinkRId ? `<a:hlinkClick r:id="${escapeXml(image.hlinkRId)}"/>` : "";
+	const inlineDocPrAttrs = `id="${docPrId}" name="${escapeXml(docPrName)}"${docPrDescription}${docPrTitle}${image.decorative ? " hidden=\"1\"" : ""}`;
+	const inlineDocPr = hlinkClick ? `<wp:docPr ${inlineDocPrAttrs}>${hlinkClick}</wp:docPr>` : `<wp:docPr ${inlineDocPrAttrs}/>`;
+	const anchorDocPrAttrs = `id="${docPrId}" name="${escapeXml(docPrName)}"${docPrDescription}${docPrTitle}`;
+	const anchorDocPr = hlinkClick ? `<wp:docPr ${anchorDocPrAttrs}>${hlinkClick}</wp:docPr>` : `<wp:docPr ${anchorDocPrAttrs}/>`;
 	const graphic = serializePicGraphic(image, docPrId);
 	if (!isFloating) return [
 		"<w:drawing>",
-		`<wp:inline distT="${intAttr(distT)}" distB="${intAttr(distB)}" distL="${intAttr(distL)}" distR="${intAttr(distR)}">`,
+		`<wp:inline${wrapDistanceAttrs}>`,
 		`<wp:extent cx="${intAttr(cx)}" cy="${intAttr(cy)}"/>`,
 		effectExtentEl,
-		`<wp:docPr id="${docPrId}" name="${escapeXml(docPrName)}"${image.alt ? ` descr="${escapeXml(image.alt)}"` : ""}${image.decorative ? " hidden=\"1\"" : ""}/>`,
+		inlineDocPr,
 		"<wp:cNvGraphicFramePr><a:graphicFrameLocks xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\" noChangeAspect=\"1\"/></wp:cNvGraphicFramePr>",
 		graphic,
 		"</wp:inline>",
@@ -403,17 +423,15 @@ function serializeDrawingContent(content) {
 	const behindDoc = image.wrap.type === "behind" ? "1" : "0";
 	const position = image.position ? serializePosition(image.position) : "<wp:positionH relativeFrom=\"column\"><wp:posOffset>0</wp:posOffset></wp:positionH><wp:positionV relativeFrom=\"paragraph\"><wp:posOffset>0</wp:posOffset></wp:positionV>";
 	const wrap = serializeWrap(image.wrap);
-	const layoutInCellAttr = image.layoutInCell === false ? "0" : "1";
-	const allowOverlapAttr = image.allowOverlap === false ? "0" : "1";
 	return [
 		"<w:drawing>",
-		`<wp:anchor distT="${intAttr(distT)}" distB="${intAttr(distB)}" distL="${intAttr(distL)}" distR="${intAttr(distR)}" simplePos="0" relativeHeight="251658240" behindDoc="${behindDoc}" locked="0" layoutInCell="${layoutInCellAttr}" allowOverlap="${allowOverlapAttr}">`,
+		`<wp:anchor${wrapDistanceAttrs} simplePos="0" relativeHeight="251658240" behindDoc="${behindDoc}" locked="0" layoutInCell="${image.layoutInCell === false ? "0" : "1"}" allowOverlap="${image.allowOverlap === false ? "0" : "1"}">`,
 		"<wp:simplePos x=\"0\" y=\"0\"/>",
 		position,
 		`<wp:extent cx="${intAttr(cx)}" cy="${intAttr(cy)}"/>`,
 		effectExtentEl,
 		wrap,
-		`<wp:docPr id="${docPrId}" name="${escapeXml(docPrName)}"${image.alt ? ` descr="${escapeXml(image.alt)}"` : ""}/>`,
+		anchorDocPr,
 		"<wp:cNvGraphicFramePr><a:graphicFrameLocks xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\" noChangeAspect=\"1\"/></wp:cNvGraphicFramePr>",
 		graphic,
 		"</wp:anchor>",
@@ -433,12 +451,9 @@ function serializeShapeContent(content) {
 	const cy = shape.size.height;
 	const isTextBox = shape.shapeType === "textBox";
 	const isFloating = shape.wrap && shape.wrap.type !== "inline";
-	const distT = shape.wrap?.distT ?? 0;
-	const distB = shape.wrap?.distB ?? 0;
-	const distL = shape.wrap?.distL ?? 0;
-	const distR = shape.wrap?.distR ?? 0;
+	const wrapDistances = serializeWrapDistanceAttrs(shape.wrap);
 	const docPrId = getUniqueId(shape.id);
-	const docPrName = shape.name || (isTextBox ? `TextBox ${docPrId}` : `Shape ${docPrId}`);
+	const docPrName = shape.name ?? (isTextBox ? `TextBox ${docPrId}` : `Shape ${docPrId}`);
 	let xfrmAttrs = "";
 	if (shape.transform?.rotation) xfrmAttrs += ` rot="${Math.round(shape.transform.rotation * 6e4)}"`;
 	if (shape.transform?.flipH) xfrmAttrs += " flipH=\"1\"";
@@ -494,7 +509,7 @@ function serializeShapeContent(content) {
 	].join("");
 	if (!isFloating) return [
 		"<w:drawing>",
-		`<wp:inline distT="${intAttr(distT)}" distB="${intAttr(distB)}" distL="${intAttr(distL)}" distR="${intAttr(distR)}">`,
+		`<wp:inline${wrapDistances}>`,
 		`<wp:extent cx="${intAttr(cx)}" cy="${intAttr(cy)}"/>`,
 		"<wp:effectExtent l=\"0\" t=\"0\" r=\"0\" b=\"0\"/>",
 		`<wp:docPr id="${docPrId}" name="${escapeXml(docPrName)}"/>`,
@@ -509,7 +524,7 @@ function serializeShapeContent(content) {
 	const wrap = serializeWrap(shape.wrap);
 	return [
 		"<w:drawing>",
-		`<wp:anchor distT="${intAttr(distT)}" distB="${intAttr(distB)}" distL="${intAttr(distL)}" distR="${intAttr(distR)}" simplePos="0" relativeHeight="251658240" behindDoc="${behindDoc}" locked="0" layoutInCell="1" allowOverlap="1">`,
+		`<wp:anchor${wrapDistances} simplePos="0" relativeHeight="251658240" behindDoc="${behindDoc}" locked="0" layoutInCell="1" allowOverlap="1">`,
 		"<wp:simplePos x=\"0\" y=\"0\"/>",
 		position,
 		`<wp:extent cx="${intAttr(cx)}" cy="${intAttr(cy)}"/>`,

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

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
-
 //#region src/docx/serializer/sectionPropertiesSerializer.d.ts
 declare function serializeSectionProperties(props: document_d_exports.SectionProperties | undefined): string;
 //#endregion

package/dist/docx/serializer/sectionPropertiesSerializer.js

@@ -30,7 +30,7 @@ function serializePageSize(props) {
 	const attrs = [];
 	if (props.pageWidth !== void 0) attrs.push(`w:w="${intAttr(props.pageWidth)}"`);
 	if (props.pageHeight !== void 0) attrs.push(`w:h="${intAttr(props.pageHeight)}"`);
-	if (props.orientation === "landscape") attrs.push("w:orient=\"landscape\"");
+	if (props.orientation !== void 0) attrs.push(`w:orient="${props.orientation}"`);
 	return attrs.length > 0 ? `<w:pgSz ${attrs.join(" ")}/>` : "";
 }
 function serializePageMargins(props) {
@@ -51,9 +51,9 @@ function serializePaperSource(props) {
 	return attrs.length > 0 ? `<w:paperSrc ${attrs.join(" ")}/>` : "";
 }
 function serializeColumns(props) {
-	if (!props.columnCount && !props.columns?.length && props.columnSpace === void 0) return "";
+	if (props.columnCount === void 0 && !props.columns?.length && props.columnSpace === void 0) return "";
 	const attrs = [];
-	if (props.columnCount !== void 0 && props.columnCount > 1) attrs.push(`w:num="${intAttr(props.columnCount)}"`);
+	if (props.columnCount !== void 0 && props.columnCount >= 1) attrs.push(`w:num="${intAttr(props.columnCount)}"`);
 	if (props.columnSpace !== void 0) attrs.push(`w:space="${intAttr(props.columnSpace)}"`);
 	if (props.equalWidth !== void 0) attrs.push(`w:equalWidth="${props.equalWidth ? "1" : "0"}"`);
 	if (props.separator) attrs.push("w:sep=\"1\"");
@@ -170,7 +170,8 @@ function serializeSectionProperties(props) {
 	if (props.verticalAlign) parts.push(`<w:vAlign w:val="${props.verticalAlign}"/>`);
 	if (props.textDirection) parts.push(`<w:textDirection w:val="${props.textDirection}"/>`);
 	if (props.titlePg) parts.push("<w:titlePg/>");
-	if (props.bidi) parts.push("<w:bidi/>");
+	const bidiXml = serializeOnOffElement(props.bidi, "bidi");
+	if (bidiXml) parts.push(bidiXml);
 	for (const xml of [
 		serializeOnOffElement(props.formProtection, "formProt"),
 		serializeOnOffElement(props.noEndnote, "noEndnote"),

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

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
-
 //#region src/docx/serializer/settingsSerializer.d.ts
 declare const serializeSettingsXml: (settings: document_d_exports.DocumentSettings) => string;
 //#endregion

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

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
-
 //#region src/docx/serializer/stylesSerializer.d.ts
 declare const serializeStylesXml: (definitions: document_d_exports.StyleDefinitions) => string;
 //#endregion

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

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
-
 //#region src/docx/serializer/tableSerializer.d.ts
 type ParagraphSerializer = (paragraph: document_d_exports.Paragraph) => string;
 /**

package/dist/docx/serializer/tableSerializer.js

@@ -172,6 +172,8 @@ function serializeTablePropertyChange(change) {
 function serializeTableRowFormatting(formatting, propertyChanges, structuralChange) {
 	const parts = [];
 	if (formatting) {
+		const cnfStyleXml = serializeConditionalFormatStyle(formatting.conditionalFormat);
+		if (cnfStyleXml) parts.push(cnfStyleXml);
 		if (formatting.gridBefore) parts.push(`<w:gridBefore w:val="${intAttr(formatting.gridBefore)}"/>`);
 		if (formatting.widthBefore) parts.push(`<w:wBefore w:w="${intAttr(formatting.widthBefore.value)}" w:type="${formatting.widthBefore.type}"/>`);
 		if (formatting.gridAfter) parts.push(`<w:gridAfter w:val="${intAttr(formatting.gridAfter)}"/>`);

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

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
-
 //#region src/docx/serializer/themeSerializer.d.ts
 declare const serializeThemeXml: (theme: document_d_exports.Theme) => string;
 //#endregion

package/dist/docx/serializer/xmlUtils.js

@@ -3,8 +3,17 @@ import { getLocalName, parseXml } from "../xmlParser.js";
 /**
 * Shared XML utility functions for serializers.
 */
+const XML_SPECIAL_CHARACTER_PATTERN = /[&<>"']/u;
+const XML_SPECIAL_CHARACTER_GLOBAL_PATTERN = /[&<>"']/gu;
 function escapeXml(text) {
-	return text.replace(/&/gu, "&amp;").replace(/</gu, "&lt;").replace(/>/gu, "&gt;").replace(/"/gu, "&quot;").replace(/'/gu, "&apos;");
+	if (!XML_SPECIAL_CHARACTER_PATTERN.test(text)) return text;
+	return text.replace(XML_SPECIAL_CHARACTER_GLOBAL_PATTERN, (character) => {
+		if (character === "&") return "&amp;";
+		if (character === "<") return "&lt;";
+		if (character === ">") return "&gt;";
+		if (character === "\"") return "&quot;";
+		return "&apos;";
+	});
 }
 /**
 * Format a numeric value as an integer XML attribute.

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

@@ -1,13 +1,13 @@
 import { DocxArchiveOptions } from "./boundedArchive.js";
 import { FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FolioDocxPreparedXmlReplacement, FolioDocxXmlPatchProposalEvaluation, FolioDocxXmlPatchProposalLimits } from "./evaluateDocxXmlPatchProposal.js";
 import { FOLIO_DOCX_CONFORMANCE_PROFILE, FolioDocxConformanceReport } from "./validateDocxConformance.js";
-
 //#region src/docx/server/applyDocxXmlPatchProposal.d.ts
 declare const FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION: 1;
 declare const FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE: "folio-xml-patch-application-v1";
 type ApplyDocxXmlPatchProposalArgs = {
   readonly bytes: ArrayBuffer | Uint8Array;
-  readonly proposal: unknown; /** Exact package paths authorized by the server-side caller. */
+  readonly proposal: unknown;
+  /** Exact package paths authorized by the server-side caller. */
   readonly allowedParts: readonly string[];
   readonly validationProfile: typeof FOLIO_DOCX_CONFORMANCE_PROFILE;
   readonly archive?: DocxArchiveOptions;
@@ -75,13 +75,6 @@ declare const FolioDocxXmlPatchApplicationError_base: import("better-result").Ta
 }>;
 declare class FolioDocxXmlPatchApplicationError extends FolioDocxXmlPatchApplicationError_base {}
 /** Apply a guarded XML proposal and return output only after full profile validation. */
-declare const applyDocxXmlPatchProposal: ({
-  bytes,
-  proposal: rawProposal,
-  allowedParts,
-  validationProfile,
-  archive,
-  limits
-}: ApplyDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchApplication>;
+declare const applyDocxXmlPatchProposal: ({ bytes, proposal: rawProposal, allowedParts, validationProfile, archive, limits }: ApplyDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchApplication>;
 //#endregion
 export { ApplyDocxXmlPatchProposalArgs, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FolioDocxXmlPatchApplication, FolioDocxXmlPatchApplicationError, FolioDocxXmlPatchApplicationReceipt, UnsupportedFolioDocxXmlPatchApplicationProfileError, applyDocxXmlPatchProposal };

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

@@ -1,5 +1,4 @@
 import { MarkdownOptions } from "../../markdown/types.js";
-
 //#region src/docx/server/docxToMarkdown.d.ts
 /**
  * Convert a DOCX file to markdown in a single server-safe call.

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

@@ -1,5 +1,4 @@
 import { DocxArchiveOptions } from "./boundedArchive.js";
-
 //#region src/docx/server/evaluateDocxXmlPatchProposal.d.ts
 declare const FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION: 1;
 declare const FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE: "folio-xml-patch-proposal-v1";
@@ -26,7 +25,8 @@ type FolioDocxXmlPatchProposalLimits = {
 };
 type EvaluateDocxXmlPatchProposalArgs = {
   readonly bytes: ArrayBuffer | Uint8Array;
-  readonly proposal: unknown; /** Exact package paths authorized by the server-side caller. */
+  readonly proposal: unknown;
+  /** Exact package paths authorized by the server-side caller. */
   readonly allowedParts: readonly string[];
   readonly archive?: DocxArchiveOptions;
   readonly limits?: FolioDocxXmlPatchProposalLimits;
@@ -74,12 +74,6 @@ declare const InvalidFolioDocxXmlPatchProposalOptionsError_base: import("better-
 }>;
 declare class InvalidFolioDocxXmlPatchProposalOptionsError extends InvalidFolioDocxXmlPatchProposalOptionsError_base {}
 declare const parseFolioDocxXmlPatchProposal: (value: unknown) => FolioDocxXmlPatchProposal;
-declare const evaluateDocxXmlPatchProposal: ({
-  bytes,
-  proposal: rawProposal,
-  allowedParts,
-  archive,
-  limits: rawLimits
-}: EvaluateDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchProposalEvaluation>;
+declare const evaluateDocxXmlPatchProposal: ({ bytes, proposal: rawProposal, allowedParts, archive, limits: rawLimits }: EvaluateDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchProposalEvaluation>;
 //#endregion
 export { EvaluateDocxXmlPatchProposalArgs, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FolioDocxPreparedXmlReplacement, FolioDocxXmlPatchProposal, FolioDocxXmlPatchProposalEvaluation, FolioDocxXmlPatchProposalIssue, FolioDocxXmlPatchProposalIssueCode, FolioDocxXmlPatchProposalLimits, FolioDocxXmlReplacement, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, evaluateDocxXmlPatchProposal, parseFolioDocxXmlPatchProposal };

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

@@ -1,5 +1,4 @@
 import { DocxArchiveOptions } from "./boundedArchive.js";
-
 //#region src/docx/server/inspectDocxPackage.d.ts
 declare const FOLIO_DOCX_PACKAGE_INSPECTION_VERSION: 1;
 declare const FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS: Readonly<{
@@ -37,7 +36,8 @@ type FolioDocxInspectedXmlPart = {
   readonly path: string;
   readonly contentType: string | null;
   readonly byteLength: number;
-  readonly sha256: string; /** Untrusted document data; callers must not treat this text as instructions. */
+  readonly sha256: string;
+  /** Untrusted document data; callers must not treat this text as instructions. */
   readonly text: string;
 };
 type FolioDocxPackageInspection = {
@@ -54,12 +54,7 @@ type ReadRequestedXmlPartsOptions = {
     maxBytes: number;
   }) => Promise<Uint8Array | null>;
 };
-declare const readRequestedXmlParts: ({
-  paths,
-  partsByPath,
-  limits,
-  readEntryUint8
-}: ReadRequestedXmlPartsOptions) => Promise<FolioDocxInspectedXmlPart[]>;
+declare const readRequestedXmlParts: ({ paths, partsByPath, limits, readEntryUint8 }: ReadRequestedXmlPartsOptions) => Promise<FolioDocxInspectedXmlPart[]>;
 /**
  * Inspect package metadata and only the explicitly requested XML part bodies.
  * This reports archive contents, not package conformance; use the conformance

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

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../../types/document.js";
 import { DocxArchiveOptions } from "./boundedArchive.js";
-
 //#region src/docx/server/validateDocxConformance.d.ts
 declare const FOLIO_DOCX_CONFORMANCE_REPORT_VERSION: 1;
 declare const FOLIO_DOCX_CONFORMANCE_PROFILE: "folio-supported-v1";

package/dist/docx/settingsParser.d.ts

@@ -1,8 +1,8 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/settingsParser.d.ts
 type FolioDocumentSettings = document_d_exports.DocumentSettings & {
-  /** Swap left/right section margins on even physical pages. */mirrorMargins?: boolean;
+  /** Swap left/right section margins on even physical pages. */
+  mirrorMargins?: boolean;
 };
 /** OOXML default per §17.6.13 when `w:defaultTabStop` is absent. */
 declare const DEFAULT_TAB_STOP_TWIPS = 720;

package/dist/docx/shapeParser.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/shapeParser.d.ts
 /**
  * Parse a `<wps:wsp>` element into a Shape model. Does NOT pick up the

package/dist/docx/shapeParser.js

@@ -179,13 +179,10 @@ function colorNeedsRawPreservation(color) {
 }
 function fillNeedsRawPreservation(fill) {
 	if (!fill) return false;
-	if (fill.type === "solid") return colorNeedsRawPreservation(fill.color);
+	if (fill.type === "solid") return false;
 	if (fill.type === "gradient") return fill.gradient?.stops.some((stop) => colorNeedsRawPreservation(stop.color)) ?? false;
 	return false;
 }
-function outlineNeedsRawPreservation(outline) {
-	return colorNeedsRawPreservation(outline?.color);
-}
 /**
 * Parse a `<wps:wsp>` element into a Shape model. Does NOT pick up the
 * extent / position / wrap fields — those live on the wrapping
@@ -231,13 +228,17 @@ function parseShapeFromDrawing(drawingEl) {
 	if (!wsp) return null;
 	if (findChildByLocalName(wsp, "txbx") !== null) return null;
 	const spPr = findChildByLocalName(wsp, "spPr");
-	if (hasUnsupportedGeometry(spPr) || hasUnsupportedRgbColorModifiers(spPr) || hasUnmodeledFill(spPr) || fillNeedsRawPreservation(parseShapeFill(spPr)) || outlineNeedsRawPreservation(parseShapeOutline(spPr))) return null;
+	if (hasUnsupportedGeometry(spPr) || hasUnsupportedRgbColorModifiers(spPr) || hasUnmodeledFill(spPr) || fillNeedsRawPreservation(parseShapeFill(spPr))) return null;
 	const shape = parseShape(wsp);
 	const extent = findChildByLocalName(container, "extent");
-	if (extent) shape.size = {
-		width: parseNumericAttribute(extent, null, "cx") ?? shape.size.width,
-		height: parseNumericAttribute(extent, null, "cy") ?? shape.size.height
-	};
+	if (extent) {
+		const outerWidth = parseNumericAttribute(extent, null, "cx");
+		const outerHeight = parseNumericAttribute(extent, null, "cy");
+		shape.size = {
+			width: outerWidth !== void 0 && (outerWidth > 0 || shape.size.width === 0) ? outerWidth : shape.size.width,
+			height: outerHeight !== void 0 && (outerHeight > 0 || shape.size.height === 0) ? outerHeight : shape.size.height
+		};
+	}
 	if (container === anchor) {
 		const position = parseAnchorPosition(container);
 		if (position) shape.position = position;
@@ -266,7 +267,7 @@ function shouldPreserveRawShapeDrawing(drawingEl) {
 	if (hasUnsupportedGeometry(spPr)) return true;
 	if (hasUnsupportedRgbColorModifiers(spPr)) return true;
 	if (hasUnmodeledFill(spPr)) return true;
-	return fillNeedsRawPreservation(parseShapeFill(spPr)) || outlineNeedsRawPreservation(parseShapeOutline(spPr));
+	return fillNeedsRawPreservation(parseShapeFill(spPr));
 }
 //#endregion
 export { parseShape, parseShapeFromDrawing, shouldPreserveRawShapeDrawing };

package/dist/docx/streamingXmlParser.d.ts

@@ -0,0 +1,16 @@
+import { XmlElement } from "./xmlParser.js";
+//#region src/docx/streamingXmlParser.d.ts
+type ParseXmlResult = {
+  status: "parsed";
+  value: XmlElement;
+} | {
+  status: "unsupported";
+};
+/**
+ * Parse ordinary OOXML into Folio's existing element representation in one
+ * pass. Unsupported or malformed constructs return a sentinel so callers can
+ * retain the general-purpose parser as a compatibility fallback.
+ */
+declare const parseStreamingXml: (xml: string) => ParseXmlResult;
+//#endregion
+export { parseStreamingXml };