@stll/folio-core 0.37.4 → 0.37.5

package/dist/docx/paragraphPropertySource.d.ts

@@ -1,11 +1,13 @@
 import { document_d_exports } from "../types/document.js";
+import { ModeledParagraphFormattingEmission } from "../internal/paragraphFormattingSerialization.js";
 import { Transaction } from "prosemirror-state";
 import { Fragment, Mark, Node, NodeType } from "prosemirror-model";
 //#region src/docx/paragraphPropertySource.d.ts
-type ParagraphPropertySource = {
+declare const paragraphPropertySourceEmissionFingerprint: unique symbol;
+type ParagraphPropertySource = Readonly<{
   xml: string;
-  formattingJson: string;
-};
+  [paragraphPropertySourceEmissionFingerprint]: string;
+}>;
 declare const PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR = "_docxParagraphSourceToken";
 declare const PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR = "_docxParagraphSourceContract";
 /** Durable identity nested inside opaque collapsed-cell ProseMirror attrs; stripped on restore. */
@@ -26,8 +28,9 @@ declare const isParagraphPropertySourceToken: (token: unknown) => token is strin
 declare const paragraphPropertySourceTokenMatchesContract: (token: unknown, contract: string) => token is string;
 /** Visit the v1 provenance scope in canonical OOXML body-story order. */
 declare const visitDocumentStoryParagraphs: (content: document_d_exports.Document["package"]["document"]["content"], visit: (paragraph: document_d_exports.Paragraph) => void) => void;
-declare const assignParagraphPropertySource: (paragraph: document_d_exports.Paragraph, source: ParagraphPropertySource) => void;
+declare const assignParagraphPropertySource: (paragraph: document_d_exports.Paragraph, xml: string) => void;
 declare const getParagraphPropertySource: (paragraph: document_d_exports.Paragraph) => ParagraphPropertySource | undefined;
+declare const paragraphPropertySourceMatchesEmission: (source: ParagraphPropertySource, emission: ModeledParagraphFormattingEmission) => boolean;
 /** Copy the captured `w:pPr` without claiming the source paragraph's durable identity. */
 declare const copyParagraphPropertyCapture: (target: document_d_exports.Paragraph, source: document_d_exports.Paragraph) => void;
 declare const copyParagraphPropertySource: (target: document_d_exports.Paragraph, source: document_d_exports.Paragraph) => void;
@@ -126,4 +129,4 @@ declare const linkParagraphPropertySourceCandidate: (target: document_d_exports.
 declare const getParagraphPropertySourceCandidate: (paragraph: document_d_exports.Paragraph) => document_d_exports.Paragraph | undefined;
 declare const getParagraphPropertySourceTransferId: (paragraph: document_d_exports.Paragraph) => string | undefined;
 //#endregion
-export { DecodedTableCellParagraphSourcePayload, PARAGRAPH_PROPERTY_SOURCE_VALIDATION_CODES, PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR, PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR, ParagraphPropertySourceValidationCode, ParagraphPropertySourceValidationError, TABLE_CELL_PARAGRAPH_SOURCE_BINDING_ATTR, TABLE_CELL_PARAGRAPH_SOURCE_PAYLOAD_ERROR_CLASSIFICATIONS, TableCellParagraphPropertySourceBinding, TableCellParagraphSourcePayloadErrorClassification, assignDocumentParagraphPropertySourceContract, assignParagraphPropertySource, cloneDocumentWithParagraphPropertySources, cloneParagraphWithPropertySource, cloneParagraphWithoutPropertySource, cloneTableCellsWithParagraphPropertyCaptures, copyDocumentParagraphPropertySourceContract, copyDocumentParagraphPropertySources, copyParagraphPropertyCapture, copyParagraphPropertySource, createProseParagraphWithPropertySource, decodeTableCellParagraphSourcePayload, getDocumentParagraphPropertySourceContract, getExplicitParagraphPropertySourceTransfers, getParagraphPropertySource, getParagraphPropertySourceCandidate, getParagraphPropertySourceToken, getParagraphPropertySourceTransferId, getProseDocumentParagraphPropertySourceContract, getProseParagraphPropertySourceToken, isParagraphPropertySourceToken, joinProseParagraphsWithRightPropertySource, linkParagraphPropertySourceCandidate, linkProseParagraphPropertySource, paragraphPropertySourceBelongsToDocument, paragraphPropertySourceTokenMatchesContract, recreateProseNodeWithDetachedParagraphPropertySource, recreateProseNodeWithParagraphPropertySource, restoreTableCellsWithParagraphPropertySources, setProseParagraphMarkupWithPropertySource, transferProseParagraphPropertySource, transportTableCellsWithParagraphPropertySources, visitDocumentStoryParagraphs, visitTableCellParagraphPropertySourceBindings };
+export { DecodedTableCellParagraphSourcePayload, PARAGRAPH_PROPERTY_SOURCE_VALIDATION_CODES, PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR, PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR, ParagraphPropertySourceValidationCode, ParagraphPropertySourceValidationError, TABLE_CELL_PARAGRAPH_SOURCE_BINDING_ATTR, TABLE_CELL_PARAGRAPH_SOURCE_PAYLOAD_ERROR_CLASSIFICATIONS, TableCellParagraphPropertySourceBinding, TableCellParagraphSourcePayloadErrorClassification, assignDocumentParagraphPropertySourceContract, assignParagraphPropertySource, cloneDocumentWithParagraphPropertySources, cloneParagraphWithPropertySource, cloneParagraphWithoutPropertySource, cloneTableCellsWithParagraphPropertyCaptures, copyDocumentParagraphPropertySourceContract, copyDocumentParagraphPropertySources, copyParagraphPropertyCapture, copyParagraphPropertySource, createProseParagraphWithPropertySource, decodeTableCellParagraphSourcePayload, getDocumentParagraphPropertySourceContract, getExplicitParagraphPropertySourceTransfers, getParagraphPropertySource, getParagraphPropertySourceCandidate, getParagraphPropertySourceToken, getParagraphPropertySourceTransferId, getProseDocumentParagraphPropertySourceContract, getProseParagraphPropertySourceToken, isParagraphPropertySourceToken, joinProseParagraphsWithRightPropertySource, linkParagraphPropertySourceCandidate, linkProseParagraphPropertySource, paragraphPropertySourceBelongsToDocument, paragraphPropertySourceMatchesEmission, paragraphPropertySourceTokenMatchesContract, recreateProseNodeWithDetachedParagraphPropertySource, recreateProseNodeWithParagraphPropertySource, restoreTableCellsWithParagraphPropertySources, setProseParagraphMarkupWithPropertySource, transferProseParagraphPropertySource, transportTableCellsWithParagraphPropertySources, visitDocumentStoryParagraphs, visitTableCellParagraphPropertySourceBindings };

package/dist/docx/paragraphPropertySource.js

@@ -1,8 +1,18 @@
+import { modelParagraphFormattingEmission } from "../internal/paragraphFormattingSerialization.js";
+import { canonicalJson } from "../utils/canonicalJson.js";
 import { visitDocxParagraphs } from "./paragraphTraversal.js";
 import { TaggedError, panic } from "better-result";
 import { PluginKey } from "prosemirror-state";
 //#region src/docx/paragraphPropertySource.ts
+const paragraphPropertySourceEmissionFingerprint = Symbol("paragraphPropertySourceEmissionFingerprint");
 const paragraphPropertySources = /* @__PURE__ */ new WeakMap();
+const paragraphFormattingEmissionFingerprint = (emission) => canonicalJson(emission);
+const ownedParagraphPropertySource = (paragraph, xml) => {
+	return Object.freeze({
+		xml,
+		[paragraphPropertySourceEmissionFingerprint]: paragraphFormattingEmissionFingerprint(modelParagraphFormattingEmission(paragraph.formatting))
+	});
+};
 const paragraphPropertySourceOwners = /* @__PURE__ */ new WeakMap();
 const proseParagraphSourceOwners = /* @__PURE__ */ new WeakMap();
 const paragraphPropertySourceCandidates = /* @__PURE__ */ new WeakMap();
@@ -80,16 +90,18 @@ const paragraphPropertySourceTokenMatchesContract = (token, contract) => {
 const visitDocumentStoryParagraphs = (content, visit) => {
 	visitDocxParagraphs({ documentBody: { content } }, visit);
 };
-const assignParagraphPropertySource = (paragraph, source) => {
-	paragraphPropertySources.set(paragraph, source);
+const assignParagraphPropertySource = (paragraph, xml) => {
+	paragraphPropertySources.set(paragraph, ownedParagraphPropertySource(paragraph, xml));
 	paragraphPropertySourceOwners.set(paragraph, paragraph);
 };
 const getParagraphPropertySource = (paragraph) => paragraphPropertySources.get(paragraph);
+const paragraphPropertySourceMatchesEmission = (source, emission) => source[paragraphPropertySourceEmissionFingerprint] === paragraphFormattingEmissionFingerprint(emission);
 /** Copy the captured `w:pPr` without claiming the source paragraph's durable identity. */
 const copyParagraphPropertyCapture = (target, source) => {
 	const propertySource = paragraphPropertySources.get(source);
 	if (propertySource) {
-		paragraphPropertySources.set(target, { ...propertySource });
+		const copiedSource = Object.freeze({ ...propertySource });
+		paragraphPropertySources.set(target, copiedSource);
 		paragraphPropertySourceOwners.set(target, paragraphPropertySourceOwners.get(source) ?? source);
 	}
 };
@@ -676,4 +688,4 @@ const linkParagraphPropertySourceCandidate = (target, source) => {
 const getParagraphPropertySourceCandidate = (paragraph) => paragraphPropertySourceCandidates.get(paragraph);
 const getParagraphPropertySourceTransferId = (paragraph) => paragraphPropertySourceTransferIds.get(paragraph);
 //#endregion
-export { PARAGRAPH_PROPERTY_SOURCE_VALIDATION_CODES, PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR, PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR, ParagraphPropertySourceValidationError, TABLE_CELL_PARAGRAPH_SOURCE_BINDING_ATTR, TABLE_CELL_PARAGRAPH_SOURCE_PAYLOAD_ERROR_CLASSIFICATIONS, assignDocumentParagraphPropertySourceContract, assignParagraphPropertySource, cloneDocumentWithParagraphPropertySources, cloneParagraphWithPropertySource, cloneParagraphWithoutPropertySource, cloneTableCellsWithParagraphPropertyCaptures, copyDocumentParagraphPropertySourceContract, copyDocumentParagraphPropertySources, copyParagraphPropertyCapture, copyParagraphPropertySource, createProseParagraphWithPropertySource, decodeTableCellParagraphSourcePayload, getDocumentParagraphPropertySourceContract, getExplicitParagraphPropertySourceTransfers, getParagraphPropertySource, getParagraphPropertySourceCandidate, getParagraphPropertySourceToken, getParagraphPropertySourceTransferId, getProseDocumentParagraphPropertySourceContract, getProseParagraphPropertySourceToken, isParagraphPropertySourceToken, joinProseParagraphsWithRightPropertySource, linkParagraphPropertySourceCandidate, linkProseParagraphPropertySource, paragraphPropertySourceBelongsToDocument, paragraphPropertySourceTokenMatchesContract, recreateProseNodeWithDetachedParagraphPropertySource, recreateProseNodeWithParagraphPropertySource, restoreTableCellsWithParagraphPropertySources, setProseParagraphMarkupWithPropertySource, transferProseParagraphPropertySource, transportTableCellsWithParagraphPropertySources, visitDocumentStoryParagraphs, visitTableCellParagraphPropertySourceBindings };
+export { PARAGRAPH_PROPERTY_SOURCE_VALIDATION_CODES, PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR, PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR, ParagraphPropertySourceValidationError, TABLE_CELL_PARAGRAPH_SOURCE_BINDING_ATTR, TABLE_CELL_PARAGRAPH_SOURCE_PAYLOAD_ERROR_CLASSIFICATIONS, assignDocumentParagraphPropertySourceContract, assignParagraphPropertySource, cloneDocumentWithParagraphPropertySources, cloneParagraphWithPropertySource, cloneParagraphWithoutPropertySource, cloneTableCellsWithParagraphPropertyCaptures, copyDocumentParagraphPropertySourceContract, copyDocumentParagraphPropertySources, copyParagraphPropertyCapture, copyParagraphPropertySource, createProseParagraphWithPropertySource, decodeTableCellParagraphSourcePayload, getDocumentParagraphPropertySourceContract, getExplicitParagraphPropertySourceTransfers, getParagraphPropertySource, getParagraphPropertySourceCandidate, getParagraphPropertySourceToken, getParagraphPropertySourceTransferId, getProseDocumentParagraphPropertySourceContract, getProseParagraphPropertySourceToken, isParagraphPropertySourceToken, joinProseParagraphsWithRightPropertySource, linkParagraphPropertySourceCandidate, linkProseParagraphPropertySource, paragraphPropertySourceBelongsToDocument, paragraphPropertySourceMatchesEmission, paragraphPropertySourceTokenMatchesContract, recreateProseNodeWithDetachedParagraphPropertySource, recreateProseNodeWithParagraphPropertySource, restoreTableCellsWithParagraphPropertySources, setProseParagraphMarkupWithPropertySource, transferProseParagraphPropertySource, transportTableCellsWithParagraphPropertySources, visitDocumentStoryParagraphs, visitTableCellParagraphPropertySourceBindings };

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

@@ -1,5 +1,8 @@
 import { document_d_exports } from "../../types/document.js";
 //#region src/docx/serializer/borderSerializer.d.ts
+type ExhaustiveFields<Source, Classified extends keyof Source> = Exclude<keyof Source, Classified> extends never ? Source : never;
+type ClassifiedBorderField = "style" | "color" | "size" | "space" | "shadow" | "frame" | "artRelationshipId" | "topLeftArtRelationshipId" | "topRightArtRelationshipId" | "bottomLeftArtRelationshipId" | "bottomRightArtRelationshipId";
+type ExhaustiveBorder = ExhaustiveFields<document_d_exports.BorderSpec, ClassifiedBorderField>;
 /**
  * Serialize a single border element (`<w:top .../>`, `<w:left .../>`, ...).
  *
@@ -19,6 +22,6 @@ import { document_d_exports } from "../../types/document.js";
  * untrusted and are `escapeXml`'d before re-entering XML attributes; for valid
  * documents these are enum/hex values, so escaping is a no-op.
  */
-declare function serializeBorder(border: document_d_exports.BorderSpec | undefined, elementName: string): string;
+declare function serializeBorder(input: ExhaustiveBorder | undefined, elementName: string): string;
 //#endregion
 export { serializeBorder };

package/dist/docx/serializer/borderSerializer.js

@@ -19,25 +19,27 @@ import { escapeXml, intAttr } from "./xmlUtils.js";
 * untrusted and are `escapeXml`'d before re-entering XML attributes; for valid
 * documents these are enum/hex values, so escaping is a no-op.
 */
-function serializeBorder(border, elementName) {
-	if (!border) return "";
-	const attrs = [`w:val="${escapeXml(border.style)}"`];
-	if (border.size !== void 0) attrs.push(`w:sz="${intAttr(border.size)}"`);
-	if (border.space !== void 0) attrs.push(`w:space="${intAttr(border.space)}"`);
-	if (border.color) {
-		if (border.color.auto) attrs.push("w:color=\"auto\"");
-		else if (border.color.rgb) attrs.push(`w:color="${escapeXml(border.color.rgb)}"`);
-		if (border.color.themeColor) attrs.push(`w:themeColor="${escapeXml(border.color.themeColor)}"`);
-		if (border.color.themeTint) attrs.push(`w:themeTint="${escapeXml(border.color.themeTint)}"`);
-		if (border.color.themeShade) attrs.push(`w:themeShade="${escapeXml(border.color.themeShade)}"`);
+function serializeBorder(input, elementName) {
+	if (!input) return "";
+	const { style, color, size, space, shadow, frame, artRelationshipId, topLeftArtRelationshipId, topRightArtRelationshipId, bottomLeftArtRelationshipId, bottomRightArtRelationshipId } = input;
+	const attrs = [`w:val="${escapeXml(style)}"`];
+	if (size !== void 0) attrs.push(`w:sz="${intAttr(size)}"`);
+	if (space !== void 0) attrs.push(`w:space="${intAttr(space)}"`);
+	if (color) {
+		const { auto, rgb, themeColor, themeTint, themeShade } = color;
+		if (auto) attrs.push("w:color=\"auto\"");
+		else if (rgb) attrs.push(`w:color="${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)}"`);
 	}
-	if (border.shadow) attrs.push("w:shadow=\"true\"");
-	if (border.frame) attrs.push("w:frame=\"true\"");
-	if (border.artRelationshipId) attrs.push(`w:id="${escapeXml(border.artRelationshipId)}"`);
-	if (border.topLeftArtRelationshipId) attrs.push(`w:topLeft="${escapeXml(border.topLeftArtRelationshipId)}"`);
-	if (border.topRightArtRelationshipId) attrs.push(`w:topRight="${escapeXml(border.topRightArtRelationshipId)}"`);
-	if (border.bottomLeftArtRelationshipId) attrs.push(`w:bottomLeft="${escapeXml(border.bottomLeftArtRelationshipId)}"`);
-	if (border.bottomRightArtRelationshipId) attrs.push(`w:bottomRight="${escapeXml(border.bottomRightArtRelationshipId)}"`);
+	if (shadow) attrs.push("w:shadow=\"true\"");
+	if (frame) attrs.push("w:frame=\"true\"");
+	if (artRelationshipId) attrs.push(`w:id="${escapeXml(artRelationshipId)}"`);
+	if (topLeftArtRelationshipId) attrs.push(`w:topLeft="${escapeXml(topLeftArtRelationshipId)}"`);
+	if (topRightArtRelationshipId) attrs.push(`w:topRight="${escapeXml(topRightArtRelationshipId)}"`);
+	if (bottomLeftArtRelationshipId) attrs.push(`w:bottomLeft="${escapeXml(bottomLeftArtRelationshipId)}"`);
+	if (bottomRightArtRelationshipId) attrs.push(`w:bottomRight="${escapeXml(bottomRightArtRelationshipId)}"`);
 	return `<w:${elementName} ${attrs.join(" ")}/>`;
 }
 //#endregion

package/dist/docx/serializer/commentSerializer.js

@@ -1,7 +1,7 @@
 import { deterministicHexId } from "../../utils/hexId.js";
 import { serializeParagraph } from "./paragraphSerializer.js";
 import { serializePartElement } from "./partNamespaces.js";
-import { serializeTextFormatting } from "./runSerializer.js";
+import { serializeTextFormatting } from "./textFormattingSerializer.js";
 import { escapeXml } from "./xmlUtils.js";
 //#region src/docx/serializer/commentSerializer.ts
 /**

package/dist/docx/serializer/numberingSerializer.js

@@ -1,5 +1,5 @@
 import { serializePartElement } from "./partNamespaces.js";
-import { serializeTextFormatting } from "./runSerializer.js";
+import { serializeTextFormatting } from "./textFormattingSerializer.js";
 import { escapeXml, intAttr } from "./xmlUtils.js";
 //#region src/docx/serializer/numberingSerializer.ts
 /**

package/dist/docx/serializer/paragraphSerializer.js

@@ -1,142 +1,19 @@
-import { canonicalJson } from "../../utils/canonicalJson.js";
-import { isValidHexColor } from "../../utils/colorResolver.js";
-import { numPrEqual } from "../numberingParser.js";
-import { getParagraphPropertySource } from "../paragraphPropertySource.js";
+import { modelParagraphFormattingEmission } from "../../internal/paragraphFormattingSerialization.js";
+import { getParagraphPropertySource, paragraphPropertySourceMatchesEmission } from "../paragraphPropertySource.js";
 import { reconcileRawSdtPr } from "../sdtPropertiesPatch.js";
 import { DATE_UTC_ATTRIBUTE } from "../trackedChangeInfo.js";
 import { toTransitionalNamespaceUri } from "../transitionalSpelling.js";
 import { captureVerbatimXml, sanitizeCapturedXmlElement } from "../verbatimCapture.js";
 import { NAMESPACES, OOXML_NAMESPACE_SCOPE, cloneElement, getChildElements, getLocalName, parseXml } from "../xmlParser.js";
-import { serializeBorder } from "./borderSerializer.js";
-import { serializeRun, serializeTextFormatting } from "./runSerializer.js";
+import { serializeRun } from "./runSerializer.js";
 import { serializeSectionProperties } from "./sectionPropertiesSerializer.js";
+import { serializeTextFormatting } from "./textFormattingSerializer.js";
 import { serializeTrackedChangeAttributes, trackedChangeAttributeRecord } from "./trackedChangeAttributes.js";
-import { escapeXml, intAttr, isSingleWellFormedElement } from "./xmlUtils.js";
+import { escapeXml, isSingleWellFormedElement } from "./xmlUtils.js";
 import { panic } from "better-result";
 import { PARAGRAPH_MARK_CHANGE_KINDS } from "@stll/docx-core/model";
 //#region src/docx/serializer/paragraphSerializer.ts
 /**
-* Serialize paragraph borders (w:pBdr)
-*/
-function serializeParagraphBorders(borders) {
-	if (!borders) return "";
-	const parts = [];
-	if (borders.top) {
-		const topXml = serializeBorder(borders.top, "top");
-		if (topXml) parts.push(topXml);
-	}
-	if (borders.left) {
-		const leftXml = serializeBorder(borders.left, "left");
-		if (leftXml) parts.push(leftXml);
-	}
-	if (borders.bottom) {
-		const bottomXml = serializeBorder(borders.bottom, "bottom");
-		if (bottomXml) parts.push(bottomXml);
-	}
-	if (borders.right) {
-		const rightXml = serializeBorder(borders.right, "right");
-		if (rightXml) parts.push(rightXml);
-	}
-	if (borders.between) {
-		const betweenXml = serializeBorder(borders.between, "between");
-		if (betweenXml) parts.push(betweenXml);
-	}
-	if (borders.bar) {
-		const barXml = serializeBorder(borders.bar, "bar");
-		if (barXml) parts.push(barXml);
-	}
-	if (parts.length === 0) return "";
-	return `<w:pBdr>${parts.join("")}</w:pBdr>`;
-}
-/**
-* 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 tab stops (w:tabs)
-*/
-function serializeTabStops(tabs) {
-	if (!tabs || tabs.length === 0) return "";
-	return `<w:tabs>${tabs.map((tab) => {
-		const attrs = [`w:val="${tab.alignment}"`, `w:pos="${intAttr(tab.position)}"`];
-		if (tab.leader && tab.leader !== "none") attrs.push(`w:leader="${tab.leader}"`);
-		return `<w:tab ${attrs.join(" ")}/>`;
-	}).join("")}</w:tabs>`;
-}
-/**
-* Serialize spacing properties (w:spacing)
-*/
-function serializeSpacing(formatting) {
-	const attrs = [];
-	if (formatting.spaceBefore !== void 0) attrs.push(`w:before="${intAttr(formatting.spaceBefore)}"`);
-	if (formatting.spaceAfter !== void 0) attrs.push(`w:after="${intAttr(formatting.spaceAfter)}"`);
-	if (formatting.lineSpacing !== void 0) attrs.push(`w:line="${intAttr(formatting.lineSpacing)}"`);
-	if (formatting.lineSpacingRule) attrs.push(`w:lineRule="${formatting.lineSpacingRule}"`);
-	if (formatting.beforeAutospacing !== void 0) attrs.push(`w:beforeAutospacing="${formatting.beforeAutospacing ? "1" : "0"}"`);
-	if (formatting.afterAutospacing !== void 0) attrs.push(`w:afterAutospacing="${formatting.afterAutospacing ? "1" : "0"}"`);
-	if (attrs.length === 0) return "";
-	return `<w:spacing ${attrs.join(" ")}/>`;
-}
-/**
-* Serialize indentation properties (w:ind)
-*/
-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 attrs.push(`w:firstLine="${intAttr(formatting.indentFirstLine)}"`);
-	if (attrs.length === 0) return "";
-	return `<w:ind ${attrs.join(" ")}/>`;
-}
-/**
-* Serialize numbering properties (w:numPr)
-*/
-function serializeNumbering(numPr) {
-	if (!numPr) return "";
-	const parts = [];
-	if (numPr.ilvl !== void 0) parts.push(`<w:ilvl w:val="${intAttr(numPr.ilvl)}"/>`);
-	if (numPr.numId !== void 0) parts.push(`<w:numId w:val="${intAttr(numPr.numId)}"/>`);
-	if (parts.length === 0) return "";
-	return `<w:numPr>${parts.join("")}</w:numPr>`;
-}
-/**
-* Serialize frame properties (w:framePr)
-*/
-function serializeFrameProperties(frame) {
-	if (!frame) return "";
-	const attrs = [];
-	if (frame.dropCap) attrs.push(`w:dropCap="${frame.dropCap}"`);
-	if (frame.lines !== void 0) attrs.push(`w:lines="${intAttr(frame.lines)}"`);
-	if (frame.width !== void 0) attrs.push(`w:w="${intAttr(frame.width)}"`);
-	if (frame.height !== void 0) attrs.push(`w:h="${intAttr(frame.height)}"`);
-	if (frame.hSpace !== void 0) attrs.push(`w:hSpace="${intAttr(frame.hSpace)}"`);
-	if (frame.vSpace !== void 0) attrs.push(`w:vSpace="${intAttr(frame.vSpace)}"`);
-	if (frame.hAnchor) attrs.push(`w:hAnchor="${frame.hAnchor}"`);
-	if (frame.vAnchor) attrs.push(`w:vAnchor="${frame.vAnchor}"`);
-	if (frame.x !== void 0) attrs.push(`w:x="${frame.x}"`);
-	if (frame.y !== void 0) attrs.push(`w:y="${frame.y}"`);
-	if (frame.xAlign) attrs.push(`w:xAlign="${frame.xAlign}"`);
-	if (frame.yAlign) attrs.push(`w:yAlign="${frame.yAlign}"`);
-	if (frame.wrap) attrs.push(`w:wrap="${frame.wrap}"`);
-	if (attrs.length === 0) return "";
-	return `<w:framePr ${attrs.join(" ")}/>`;
-}
-/**
 * Serialize paragraph formatting properties to w:pPr XML
 */
 function serializeParagraphMarkChange(mark) {
@@ -361,7 +238,7 @@ const verifiedParagraphPropertySource = (formatting, source) => {
 	if (!source) return null;
 	const replayableSource = replayableParagraphPropertySourceXml(source.xml);
 	if (replayableSource === null) return null;
-	return canonicalJson(formatting ?? {}) === source.formattingJson ? replayableSource : null;
+	return paragraphPropertySourceMatchesEmission(source, formatting) ? replayableSource : null;
 };
 const withTrailingParagraphPropertyChildren = (sourceXml, children) => {
 	const written = children.join("");
@@ -398,6 +275,7 @@ const withParagraphMarkChange = (sourceXml, mark) => {
 	return captureVerbatimXml(cloneElement(root, { elements }));
 };
 const serializeParagraphFormattingWithOptions = (formatting, { propertyChanges, paragraphMarkChange, propertySource, sectionProperties } = {}) => {
+	const modeledFormatting = modelParagraphFormattingEmission(formatting);
 	const serializablePropertyChangeCount = propertyChanges?.length ?? 0;
 	if (serializablePropertyChangeCount > 1) panic("A paragraph cannot serialize more than one w:pPrChange", { count: serializablePropertyChangeCount });
 	const paragraphMarkXml = paragraphMarkChange ? serializeParagraphMarkChange(paragraphMarkChange) : "";
@@ -408,50 +286,15 @@ const serializeParagraphFormattingWithOptions = (formatting, { propertyChanges,
 		sectionPropertiesXml,
 		...propertyChangesXml
 	].some((xml) => xml.includes(`${DATE_UTC_ATTRIBUTE}=`));
-	const verifiedSource = verifiedParagraphPropertySource(formatting, propertySource);
+	const verifiedSource = verifiedParagraphPropertySource(modeledFormatting, propertySource);
 	if (verifiedSource !== null && (!composedChildrenUseDateUtc || !sourceShadowsDateUtcPrefix(verifiedSource))) {
 		const sourceWithMark = paragraphMarkChange ? withParagraphMarkChange(verifiedSource, paragraphMarkChange) : verifiedSource;
 		return withTrailingParagraphPropertyChildren(sourceWithMark, [sectionPropertiesXml, ...propertyChangesXml]);
 	}
 	const parts = [];
-	const pushToggle = (name, value) => {
-		if (value === true) parts.push(`<w:${name}/>`);
-		else if (value === false) parts.push(`<w:${name} w:val="0"/>`);
-	};
-	if (formatting) {
-		if (formatting.styleId) parts.push(`<w:pStyle w:val="${escapeXml(formatting.styleId)}"/>`);
-		pushToggle("keepNext", formatting.keepNext);
-		pushToggle("keepLines", formatting.keepLines);
-		pushToggle("pageBreakBefore", formatting.pageBreakBefore);
-		const frameXml = serializeFrameProperties(formatting.frame);
-		if (frameXml) parts.push(frameXml);
-		pushToggle("widowControl", formatting.widowControl);
-		const numPrXml = formatting.numPrFromStyle != null && numPrEqual(formatting.numPr, formatting.numPrFromStyle) ? "" : serializeNumbering(formatting.numPr);
-		if (numPrXml) parts.push(numPrXml);
-		pushToggle("suppressLineNumbers", formatting.suppressLineNumbers);
-		const bordersXml = serializeParagraphBorders(formatting.borders);
-		if (bordersXml) parts.push(bordersXml);
-		const shadingXml = serializeShading(formatting.shading);
-		if (shadingXml) parts.push(shadingXml);
-		const tabsXml = serializeTabStops(formatting.tabs);
-		if (tabsXml) parts.push(tabsXml);
-		pushToggle("suppressAutoHyphens", formatting.suppressAutoHyphens);
-		pushToggle("kinsoku", formatting.kinsoku);
-		pushToggle("overflowPunct", formatting.overflowPunctuation);
-		pushToggle("bidi", formatting.bidi);
-		pushToggle("snapToGrid", formatting.snapToGrid);
-		const spacingXml = serializeSpacing(formatting);
-		if (spacingXml) parts.push(spacingXml);
-		const indXml = serializeIndentation(formatting);
-		if (indXml) parts.push(indXml);
-		pushToggle("contextualSpacing", formatting.contextualSpacing);
-		if (formatting.alignment) parts.push(`<w:jc w:val="${formatting.alignment}"/>`);
-		if (formatting.outlineLevel !== void 0) parts.push(`<w:outlineLvl w:val="${formatting.outlineLevel}"/>`);
-		if (paragraphMarkChange || formatting.runProperties || formatting.runInWithNext) {
-			const fullInner = `${paragraphMarkChange ? paragraphMarkXml : ""}${formatting.runProperties ? extractRPrInner(serializeTextFormatting(formatting.runProperties)) : ""}${formatting.runInWithNext ? "<w:specVanish/>" : ""}`;
-			if (fullInner.length > 0) parts.push(`<w:rPr>${fullInner}</w:rPr>`);
-		}
-	} else if (paragraphMarkChange) parts.push(`<w:rPr>${paragraphMarkXml}</w:rPr>`);
+	if (modeledFormatting.propertiesXml) parts.push(modeledFormatting.propertiesXml);
+	const paragraphMarkPropertiesInnerXml = `${paragraphMarkXml}${modeledFormatting.paragraphMarkPropertiesInnerXml ?? ""}`;
+	if (paragraphMarkPropertiesInnerXml) parts.push(`<w:rPr>${paragraphMarkPropertiesInnerXml}</w:rPr>`);
 	parts.push(sectionPropertiesXml);
 	if (propertyChangesXml.length > 0) parts.push(...propertyChangesXml);
 	const inner = parts.join("");
@@ -468,15 +311,6 @@ function extractPPrInner(pPrXml) {
 	if (!pPrXml.startsWith("<w:pPr>") || !pPrXml.endsWith("</w:pPr>")) return "";
 	return pPrXml.slice(7, -8);
 }
-/**
-* Strip the outer `<w:rPr>...</w:rPr>` wrapper so callers can splice
-* additional rPr children (e.g. `<w:specVanish/>`) and re-emit a
-* single rPr element.
-*/
-function extractRPrInner(rPrXml) {
-	if (!rPrXml.startsWith("<w:rPr>") || !rPrXml.endsWith("</w:rPr>")) return "";
-	return rPrXml.slice(7, -8);
-}
 function serializeParagraphPropertyChange(change) {
 	const previousPPrInner = extractPPrInner(serializeParagraphFormatting(change.previousFormatting) || "<w:pPr/>");
 	const normalizedPreviousPPr = previousPPrInner.length > 0 ? `<w:pPr>${previousPPrInner}</w:pPr>` : "<w:pPr/>";

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

@@ -5,10 +5,6 @@ import { document_d_exports } from "../../types/document.js";
  * to keep IDs deterministic across saves.
  */
 declare function resetAutoIdCounter(): void;
-/**
- * Serialize text formatting properties to w:rPr XML
- */
-declare function serializeTextFormatting(formatting: document_d_exports.TextFormatting | undefined): string;
 /**
  * Serialize a run to OOXML XML (w:r)
  *
@@ -52,4 +48,4 @@ declare function createBreakRun(breakType?: "page" | "column" | "textWrapping",
  */
 declare function createTabRun(formatting?: document_d_exports.TextFormatting): document_d_exports.Run;
 //#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/runSerializer.js

@@ -1,10 +1,9 @@
-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 { 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 +37,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);
@@ -667,4 +540,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/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" | "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 };