@beyondwork/docx-react-component 1.0.28 → 1.0.30

package/src/io/export/serialize-footnotes.ts

@@ -8,6 +8,14 @@ import type {
   TableRowNode,
   TextMark,
 } from "../../model/canonical-document.ts";
+import type { RevisionRecord as ReviewRevisionRecord } from "../../review/store/revision-types.ts";
+import { serializeRuntimeRevisionsIntoStoryXml } from "./serialize-runtime-revisions.ts";
+import { splitStoryBlocksForRuntimeRevisions } from "./split-story-blocks-for-runtime-revisions.ts";
+import {
+  serializeTableCellPropertiesXml,
+  serializeTablePropertiesXml,
+  serializeTableRowPropertiesXml,
+} from "./table-properties-xml.ts";
 
 export const WORD_FOOTNOTES_CONTENT_TYPE =
   "application/vnd.openxmlformats-officedocument.wordprocessingml.footnotes+xml";
@@ -21,12 +29,16 @@ const R_NS = `xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/rel
  * Serialize the footnotes portion of a FootnoteCollection to footnotes.xml.
  * Includes the required separator and continuation-separator stubs.
  */
-export function serializeFootnotesXml(collection: FootnoteCollection): string {
+export function serializeFootnotesXml(
+  collection: FootnoteCollection,
+  revisionsByNoteId: Record<string, readonly ReviewRevisionRecord[]> = {},
+): string {
   const entries = Object.values(collection.footnotes).sort(compareNoteIds);
   const body = [
     serializeSeparatorStub("footnote", "-1", "separator"),
     serializeSeparatorStub("footnote", "0", "continuationSeparator"),
-    ...entries.map((entry) => serializeNoteDefinition("footnote", entry)),
+    ...entries.map((entry) =>
+      serializeNoteDefinition("footnote", entry, revisionsByNoteId[entry.noteId] ?? [])),
   ].join("");
 
   return [
@@ -39,12 +51,16 @@ export function serializeFootnotesXml(collection: FootnoteCollection): string {
  * Serialize the endnotes portion of a FootnoteCollection to endnotes.xml.
  * Includes the required separator and continuation-separator stubs.
  */
-export function serializeEndnotesXml(collection: FootnoteCollection): string {
+export function serializeEndnotesXml(
+  collection: FootnoteCollection,
+  revisionsByNoteId: Record<string, readonly ReviewRevisionRecord[]> = {},
+): string {
   const entries = Object.values(collection.endnotes).sort(compareNoteIds);
   const body = [
     serializeSeparatorStub("endnote", "-1", "separator"),
     serializeSeparatorStub("endnote", "0", "continuationSeparator"),
-    ...entries.map((entry) => serializeNoteDefinition("endnote", entry)),
+    ...entries.map((entry) =>
+      serializeNoteDefinition("endnote", entry, revisionsByNoteId[entry.noteId] ?? [])),
   ].join("");
 
   return [
@@ -67,9 +83,11 @@ function serializeSeparatorStub(
 function serializeNoteDefinition(
   kind: "footnote" | "endnote",
   definition: FootnoteDefinition,
+  revisions: readonly ReviewRevisionRecord[] = [],
 ): string {
   const tag = kind === "footnote" ? "w:footnote" : "w:endnote";
-  const blocks = definition.blocks
+  const revisionReadyBlocks = splitStoryBlocksForRuntimeRevisions(definition.blocks, revisions);
+  const blocks = revisionReadyBlocks
     .map((block) => {
       if (block.type === "paragraph") {
         return serializeParagraph(block);
@@ -85,7 +103,17 @@ function serializeNoteDefinition(
     .join("");
 
   const body = blocks || `<w:p><w:r><w:t></w:t></w:r></w:p>`;
-  return `<${tag} w:id="${escapeAttribute(definition.noteId)}">${body}</${tag}>`;
+  const noteXml = `<${tag} w:id="${escapeAttribute(definition.noteId)}">${body}</${tag}>`;
+  if (revisions.length === 0) {
+    return noteXml;
+  }
+  const serialized = serializeRuntimeRevisionsIntoStoryXml(noteXml, revisions);
+  if (serialized.skippedRevisionIds.length > 0) {
+    throw new Error(
+      `Cannot safely serialize ${serialized.skippedRevisionIds.length} revisions for ${kind} ${definition.noteId}.`,
+    );
+  }
+  return serialized.documentXml;
 }
 
 function serializeParagraph(paragraph: ParagraphNode): string {
@@ -107,8 +135,9 @@ function serializeParagraph(paragraph: ParagraphNode): string {
 
 function serializeTable(table: TableNode): string {
   let xml = "<w:tbl>";
-  if (table.propertiesXml) {
-    xml += table.propertiesXml;
+  const propertiesXml = serializeTablePropertiesXml(table);
+  if (propertiesXml) {
+    xml += propertiesXml;
   }
   if (table.gridColumns.length > 0) {
     xml += "<w:tblGrid>";
@@ -126,8 +155,9 @@ function serializeTable(table: TableNode): string {
 
 function serializeTableRow(row: TableRowNode): string {
   let xml = "<w:tr>";
-  if (row.propertiesXml) {
-    xml += wrapPropertiesXml("w:trPr", row.propertiesXml);
+  const propertiesXml = serializeTableRowPropertiesXml(row);
+  if (propertiesXml) {
+    xml += propertiesXml;
   }
   for (const cell of row.cells) {
     xml += serializeTableCell(cell);
@@ -359,41 +389,6 @@ function serializeHyperlinkNode(node: Extract<InlineNode, { type: "hyperlink" }>
   return `<w:hyperlink r:id="${escapeAttribute(node.href)}">${childrenXml}</w:hyperlink>`;
 }
 
-function wrapPropertiesXml(tagName: "w:trPr" | "w:tcPr", xml: string): string {
-  const trimmed = xml.trim();
-  if (trimmed.startsWith(`<${tagName}`)) {
-    return trimmed;
-  }
-  return `<${tagName}>${trimmed}</${tagName}>`;
-}
-
-function extractWrappedChildren(tagName: "w:tcPr", xml: string | undefined): string {
-  if (!xml) {
-    return "";
-  }
-  const trimmed = xml.trim();
-  const wrapped = new RegExp(`^<${tagName}\\b[^>]*>([\\s\\S]*)</${tagName}>$`, "u").exec(trimmed);
-  return wrapped?.[1] ?? trimmed;
-}
-
 function buildTableCellPropertiesXml(cell: TableCellNode): string {
-  const innerXml = extractWrappedChildren("w:tcPr", cell.propertiesXml)
-    .replace(/<w:gridSpan\b[^>]*\/>/gu, "")
-    .replace(/<w:vMerge\b[^>]*\/>/gu, "")
-    .trim();
-  const parts: string[] = [];
-  if (cell.gridSpan && cell.gridSpan > 1) {
-    parts.push(`<w:gridSpan w:val="${cell.gridSpan}"/>`);
-  }
-  if (cell.verticalMerge) {
-    parts.push(
-      cell.verticalMerge === "restart"
-        ? `<w:vMerge w:val="restart"/>`
-        : `<w:vMerge/>`,
-    );
-  }
-  if (innerXml.length > 0) {
-    parts.push(innerXml);
-  }
-  return parts.length > 0 ? `<w:tcPr>${parts.join("")}</w:tcPr>` : "";
+  return serializeTableCellPropertiesXml(cell);
 }

package/src/io/export/serialize-headers-footers.ts

@@ -9,6 +9,13 @@ import type {
   TableRowNode,
   TextMark,
 } from "../../model/canonical-document.ts";
+import type { RevisionRecord as ReviewRevisionRecord } from "../../review/store/revision-types.ts";
+import { splitStoryBlocksForRuntimeRevisions } from "./split-story-blocks-for-runtime-revisions.ts";
+import {
+  serializeTableCellPropertiesXml,
+  serializeTablePropertiesXml,
+  serializeTableRowPropertiesXml,
+} from "./table-properties-xml.ts";
 
 export const WORD_HEADER_CONTENT_TYPE =
   "application/vnd.openxmlformats-officedocument.wordprocessingml.header+xml";
@@ -40,6 +47,17 @@ export function serializeHeaderXml(header: HeaderDocument): string {
   ].join("\n");
 }
 
+export function serializeHeaderXmlWithRevisions(
+  header: HeaderDocument,
+  revisions: readonly ReviewRevisionRecord[] = [],
+): string {
+  const body = serializeBlocks(splitStoryBlocksForRuntimeRevisions(header.blocks, revisions));
+  return [
+    `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>`,
+    `<w:hdr ${W_NS} ${R_NS} ${EXTENDED_ROOT_ATTRS}>${body}</w:hdr>`,
+  ].join("\n");
+}
+
 /**
  * Serialize a FooterDocument into a footerN.xml string.
  */
@@ -51,6 +69,17 @@ export function serializeFooterXml(footer: FooterDocument): string {
   ].join("\n");
 }
 
+export function serializeFooterXmlWithRevisions(
+  footer: FooterDocument,
+  revisions: readonly ReviewRevisionRecord[] = [],
+): string {
+  const body = serializeBlocks(splitStoryBlocksForRuntimeRevisions(footer.blocks, revisions));
+  return [
+    `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>`,
+    `<w:ftr ${W_NS} ${R_NS} ${EXTENDED_ROOT_ATTRS}>${body}</w:ftr>`,
+  ].join("\n");
+}
+
 // ---- Internal serialization ----
 
 function serializeBlocks(
@@ -96,8 +125,9 @@ function serializeParagraph(paragraph: ParagraphNode): string {
 
 function serializeTable(table: TableNode): string {
   let xml = "<w:tbl>";
-  if (table.propertiesXml) {
-    xml += table.propertiesXml;
+  const propertiesXml = serializeTablePropertiesXml(table);
+  if (propertiesXml) {
+    xml += propertiesXml;
   }
   if (table.gridColumns.length > 0) {
     xml += "<w:tblGrid>";
@@ -115,8 +145,9 @@ function serializeTable(table: TableNode): string {
 
 function serializeTableRow(row: TableRowNode): string {
   let xml = "<w:tr>";
-  if (row.propertiesXml) {
-    xml += wrapPropertiesXml("w:trPr", row.propertiesXml);
+  const propertiesXml = serializeTableRowPropertiesXml(row);
+  if (propertiesXml) {
+    xml += propertiesXml;
   }
   for (const cell of row.cells) {
     xml += serializeTableCell(cell);
@@ -332,41 +363,6 @@ function serializeHyperlinkNode(node: Extract<InlineNode, { type: "hyperlink" }>
   return `<w:hyperlink r:id="${escapeAttribute(node.href)}">${childrenXml}</w:hyperlink>`;
 }
 
-function wrapPropertiesXml(tagName: "w:trPr" | "w:tcPr", xml: string): string {
-  const trimmed = xml.trim();
-  if (trimmed.startsWith(`<${tagName}`)) {
-    return trimmed;
-  }
-  return `<${tagName}>${trimmed}</${tagName}>`;
-}
-
-function extractWrappedChildren(tagName: "w:tcPr", xml: string | undefined): string {
-  if (!xml) {
-    return "";
-  }
-  const trimmed = xml.trim();
-  const wrapped = new RegExp(`^<${tagName}\\b[^>]*>([\\s\\S]*)</${tagName}>$`, "u").exec(trimmed);
-  return wrapped?.[1] ?? trimmed;
-}
-
 function buildTableCellPropertiesXml(cell: TableCellNode): string {
-  const innerXml = extractWrappedChildren("w:tcPr", cell.propertiesXml)
-    .replace(/<w:gridSpan\b[^>]*\/>/gu, "")
-    .replace(/<w:vMerge\b[^>]*\/>/gu, "")
-    .trim();
-  const parts: string[] = [];
-  if (cell.gridSpan && cell.gridSpan > 1) {
-    parts.push(`<w:gridSpan w:val="${cell.gridSpan}"/>`);
-  }
-  if (cell.verticalMerge) {
-    parts.push(
-      cell.verticalMerge === "restart"
-        ? `<w:vMerge w:val="restart"/>`
-        : `<w:vMerge/>`,
-    );
-  }
-  if (innerXml.length > 0) {
-    parts.push(innerXml);
-  }
-  return parts.length > 0 ? `<w:tcPr>${parts.join("")}</w:tcPr>` : "";
+  return serializeTableCellPropertiesXml(cell);
 }

package/src/io/export/serialize-main-document.ts

@@ -18,6 +18,11 @@ import type { RevisionParagraphBoundary } from "../ooxml/revision-boundaries.ts"
 import { getOpaqueFragment } from "../../preservation/store.ts";
 import { retainRelationshipsForFragment } from "../../preservation/relationship-retention.ts";
 import { serializeParagraphNumberingProperties } from "./serialize-numbering.ts";
+import {
+  serializeTableCellPropertiesXml,
+  serializeTablePropertiesXml,
+  serializeTableRowPropertiesXml,
+} from "./table-properties-xml.ts";
 
 const HYPERLINK_RELATIONSHIP_TYPE =
   "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
@@ -209,7 +214,7 @@ function serializeTableNode(
   table: TableNode,
   state: SerializationState,
 ): string {
-  const propertiesXml = table.propertiesXml ?? buildTablePropertiesXml(table);
+  const propertiesXml = buildTablePropertiesXml(table);
   const gridXml =
     table.gridColumns.length > 0
       ? `<w:tblGrid>${table.gridColumns
@@ -218,7 +223,7 @@ function serializeTableNode(
       : "";
   const rowsXml = table.rows
     .map((row) => {
-      const rowPropertiesXml = row.propertiesXml ?? buildTableRowPropertiesXml(row);
+      const rowPropertiesXml = buildTableRowPropertiesXml(row);
       const cellsXml = row.cells
         .map((cell) => serializeTableCellNode(cell, state))
         .join("");
@@ -232,7 +237,7 @@ function serializeTableCellNode(
   cell: TableCellNode,
   state: SerializationState,
 ): string {
-  const propertiesXml = cell.propertiesXml ?? buildCellPropertiesXml(cell);
+  const propertiesXml = buildCellPropertiesXml(cell);
   const blocksXml = cell.children
     .map((child) => serializeBlockNode(child, state))
     .join("");
@@ -257,47 +262,26 @@ function serializeBlockNode(
     case "opaque_block":
       return lookupOpaqueXml(block.fragmentId, state);
     case "section_break":
-      if (block.sectionPropertiesXml ?? block.propertiesXml) {
-        return block.sectionPropertiesXml ?? block.propertiesXml!;
-      }
-      if (block.sectionProperties) return serializeSectionPropertiesXml(block.sectionProperties);
-      return "<w:sectPr/>";
+      return serializeNestedSectionBreak(block);
   }
 }
 
+function serializeNestedSectionBreak(
+  block: Extract<DocumentRootNode["children"][number], { type: "section_break" }>,
+): string {
+  const sectionPropertiesXml =
+    block.sectionPropertiesXml ??
+    block.propertiesXml ??
+    (block.sectionProperties ? serializeSectionPropertiesXml(block.sectionProperties) : "<w:sectPr/>");
+  return `<w:p><w:pPr>${sectionPropertiesXml}</w:pPr></w:p>`;
+}
+
 function buildCellPropertiesXml(cell: TableCellNode): string {
-  const children: string[] = [];
-  if (cell.gridSpan && cell.gridSpan > 1) {
-    children.push(`<w:gridSpan w:val="${cell.gridSpan}"/>`);
-  }
-  if (cell.verticalMerge) {
-    children.push(
-      cell.verticalMerge === "restart"
-        ? `<w:vMerge w:val="restart"/>`
-        : `<w:vMerge/>`,
-    );
-  }
-  return children.length > 0 ? `<w:tcPr>${children.join("")}</w:tcPr>` : "";
+  return serializeTableCellPropertiesXml(cell);
 }
 
 function buildTableRowPropertiesXml(row: TableNode["rows"][number]): string {
-  const children: string[] = [];
-  if (row.gridBefore !== undefined) {
-    children.push(`<w:gridBefore w:val="${row.gridBefore}"/>`);
-  }
-  if (row.widthBefore) {
-    children.push(`<w:wBefore w:w="${row.widthBefore.value}" w:type="${row.widthBefore.type}"/>`);
-  }
-  if (row.gridAfter !== undefined) {
-    children.push(`<w:gridAfter w:val="${row.gridAfter}"/>`);
-  }
-  if (row.widthAfter) {
-    children.push(`<w:wAfter w:w="${row.widthAfter.value}" w:type="${row.widthAfter.type}"/>`);
-  }
-  if (children.length === 0) {
-    return "";
-  }
-  return `<w:trPr>${children.join("")}</w:trPr>`;
+  return serializeTableRowPropertiesXml(row);
 }
 
 function serializeSdtNode(
@@ -313,6 +297,9 @@ function serializeCustomXmlNode(
   block: CustomXmlNode,
   state: SerializationState,
 ): string {
+  if (block.rawXml) {
+    return block.rawXml;
+  }
   const attrs: string[] = [];
   if (block.uri) {
     attrs.push(`w:uri="${escapeAttribute(block.uri)}"`);
@@ -573,33 +560,7 @@ function buildParagraphPropertiesXml(paragraph: ParagraphNode): string {
 }
 
 function buildTablePropertiesXml(table: TableNode): string {
-  const children: string[] = [];
-  if (table.styleId) {
-    children.push(`<w:tblStyle w:val="${escapeAttribute(table.styleId)}"/>`);
-  }
-  if (table.tblLook) {
-    const attrs: string[] = [];
-    if (table.tblLook.val) {
-      attrs.push(`w:val="${escapeAttribute(table.tblLook.val)}"`);
-    }
-    for (const [key, attr] of [
-      ["firstRow", "w:firstRow"],
-      ["lastRow", "w:lastRow"],
-      ["firstColumn", "w:firstColumn"],
-      ["lastColumn", "w:lastColumn"],
-      ["noHBand", "w:noHBand"],
-      ["noVBand", "w:noVBand"],
-    ] as const) {
-      const value = table.tblLook[key];
-      if (value !== undefined) {
-        attrs.push(`${attr}="${value ? "1" : "0"}"`);
-      }
-    }
-    if (attrs.length > 0) {
-      children.push(`<w:tblLook ${attrs.join(" ")}/>`);
-    }
-  }
-  return children.length > 0 ? `<w:tblPr>${children.join("")}</w:tblPr>` : "";
+  return serializeTablePropertiesXml(table);
 }
 
 function serializeParagraphBorders(borders: ParagraphNode["borders"]): string {
@@ -1347,30 +1308,35 @@ function wrapInlineRawXml(rawXml: string): string {
 }
 
 function documentNeedsW14Namespace(content: DocumentRootNode): boolean {
-  const blockQueue = [...content.children];
-  while (blockQueue.length > 0) {
-    const block = blockQueue.shift();
-    if (!block) {
-      continue;
-    }
-    if (block.type === "paragraph") {
-      for (const child of block.children) {
-        if (
-          (child.type === "text" || child.type === "symbol") &&
-          child.marks?.some((mark) => mark.type === "textFill")
-        ) {
-          return true;
-        }
-      }
-      continue;
-    }
-    if (block.type === "table") {
-      for (const row of block.rows) {
-        for (const cell of row.cells) {
-          blockQueue.push(...cell.children);
-        }
-      }
-    }
+  return content.children.some(blockNeedsW14Namespace);
+}
+
+function blockNeedsW14Namespace(block: DocumentRootNode["children"][number]): boolean {
+  switch (block.type) {
+    case "paragraph":
+      return block.children.some(inlineNodeNeedsW14Namespace);
+    case "table":
+      return block.rows.some((row) =>
+        row.cells.some((cell) => cell.children.some(blockNeedsW14Namespace)),
+      );
+    case "sdt":
+      return Boolean(block.properties.checkbox) || block.children.some(blockNeedsW14Namespace);
+    case "custom_xml":
+      return block.children.some(blockNeedsW14Namespace);
+    default:
+      return false;
+  }
+}
+
+function inlineNodeNeedsW14Namespace(node: InlineNode): boolean {
+  switch (node.type) {
+    case "text":
+    case "symbol":
+      return Boolean(node.marks?.some((mark) => mark.type === "textFill"));
+    case "hyperlink":
+    case "field":
+      return node.children.some(inlineNodeNeedsW14Namespace);
+    default:
+      return false;
   }
-  return false;
 }

package/src/io/export/serialize-numbering.ts

@@ -65,17 +65,56 @@ function serializeAbstractDefinition(definition: NumberingCatalog["abstractDefin
   return `<w:abstractNum w:abstractNumId="${abstractNumId}">${levels}</w:abstractNum>`;
 }
 
-function serializeLevel(level: NumberingCatalog["abstractDefinitions"][string]["levels"][number]): string {
+function serializeLevel(
+  level: NumberingCatalog["abstractDefinitions"][string]["levels"][number],
+  serializedLevel = level.level,
+): string {
   const start = level.startAt !== undefined ? `<w:start w:val="${level.startAt}"/>` : "";
   const paragraphStyle = level.paragraphStyleId
     ? `<w:pStyle w:val="${escapeAttribute(level.paragraphStyleId)}"/>`
     : "";
   const isLegal = level.isLegalNumbering ? "<w:isLgl/>" : "";
   const suffix = level.suffix ? `<w:suff w:val="${escapeAttribute(level.suffix)}"/>` : "";
+  const justification = level.paragraphGeometry?.justification
+    ? `<w:lvlJc w:val="${escapeAttribute(level.paragraphGeometry.justification)}"/>`
+    : "";
+  const paragraphProperties = serializeLevelParagraphGeometry(level.paragraphGeometry);
 
-  return `<w:lvl w:ilvl="${level.level}">${start}<w:numFmt w:val="${escapeAttribute(
+  return `<w:lvl w:ilvl="${serializedLevel}">${start}<w:numFmt w:val="${escapeAttribute(
     level.format,
-  )}"/><w:lvlText w:val="${escapeAttribute(level.text)}"/>${paragraphStyle}${isLegal}${suffix}</w:lvl>`;
+  )}"/><w:lvlText w:val="${escapeAttribute(level.text)}"/>${paragraphStyle}${isLegal}${suffix}${justification}${paragraphProperties}</w:lvl>`;
+}
+
+function serializeLevelOverride(
+  level: NumberingCatalog["instances"][string]["overrides"][number]["levelDefinition"],
+  serializedLevel: number,
+): string {
+  if (!level) {
+    return "";
+  }
+
+  const start = level.startAt !== undefined ? `<w:start w:val="${level.startAt}"/>` : "";
+  const format = level.format ? `<w:numFmt w:val="${escapeAttribute(level.format)}"/>` : "";
+  const text = level.text !== undefined
+    ? `<w:lvlText w:val="${escapeAttribute(level.text)}"/>`
+    : "";
+  const paragraphStyle = level.paragraphStyleId
+    ? `<w:pStyle w:val="${escapeAttribute(level.paragraphStyleId)}"/>`
+    : "";
+  const isLegal =
+    level.isLegalNumbering === undefined
+      ? ""
+      : level.isLegalNumbering
+        ? "<w:isLgl/>"
+        : `<w:isLgl w:val="0"/>`;
+  const suffix = level.suffix ? `<w:suff w:val="${escapeAttribute(level.suffix)}"/>` : "";
+  const justification = level.paragraphGeometry?.justification
+    ? `<w:lvlJc w:val="${escapeAttribute(level.paragraphGeometry.justification)}"/>`
+    : "";
+  const paragraphProperties = serializeLevelParagraphGeometry(level.paragraphGeometry);
+  const body = `${start}${format}${text}${paragraphStyle}${isLegal}${suffix}${justification}${paragraphProperties}`;
+
+  return body.length > 0 ? `<w:lvl w:ilvl="${serializedLevel}">${body}</w:lvl>` : "";
 }
 
 function serializeInstance(instance: NumberingCatalog["instances"][string]): string {
@@ -94,7 +133,68 @@ function serializeInstance(instance: NumberingCatalog["instances"][string]): str
 function serializeOverride(override: NumberingCatalog["instances"][string]["overrides"][number]): string {
   const startOverride =
     override.startAt !== undefined ? `<w:startOverride w:val="${override.startAt}"/>` : "";
-  return `<w:lvlOverride w:ilvl="${override.level}">${startOverride}</w:lvlOverride>`;
+  const levelDefinition = override.levelDefinition
+    ? serializeLevelOverride(override.levelDefinition, override.level)
+    : "";
+  return `<w:lvlOverride w:ilvl="${override.level}">${startOverride}${levelDefinition}</w:lvlOverride>`;
+}
+
+function serializeLevelParagraphGeometry(
+  paragraphGeometry: NumberingCatalog["abstractDefinitions"][string]["levels"][number]["paragraphGeometry"],
+): string {
+  if (!paragraphGeometry) {
+    return "";
+  }
+
+  const children: string[] = [];
+  if (paragraphGeometry.spacing) {
+    const attrs: string[] = [];
+    if (paragraphGeometry.spacing.before !== undefined) {
+      attrs.push(`w:before="${paragraphGeometry.spacing.before}"`);
+    }
+    if (paragraphGeometry.spacing.after !== undefined) {
+      attrs.push(`w:after="${paragraphGeometry.spacing.after}"`);
+    }
+    if (paragraphGeometry.spacing.line !== undefined) {
+      attrs.push(`w:line="${paragraphGeometry.spacing.line}"`);
+    }
+    if (paragraphGeometry.spacing.lineRule !== undefined) {
+      attrs.push(`w:lineRule="${paragraphGeometry.spacing.lineRule}"`);
+    }
+    if (attrs.length > 0) {
+      children.push(`<w:spacing ${attrs.join(" ")}/>`);
+    }
+  }
+
+  if (paragraphGeometry.indentation) {
+    const attrs: string[] = [];
+    if (paragraphGeometry.indentation.left !== undefined) {
+      attrs.push(`w:left="${paragraphGeometry.indentation.left}"`);
+    }
+    if (paragraphGeometry.indentation.right !== undefined) {
+      attrs.push(`w:right="${paragraphGeometry.indentation.right}"`);
+    }
+    if (paragraphGeometry.indentation.firstLine !== undefined) {
+      attrs.push(`w:firstLine="${paragraphGeometry.indentation.firstLine}"`);
+    }
+    if (paragraphGeometry.indentation.hanging !== undefined) {
+      attrs.push(`w:hanging="${paragraphGeometry.indentation.hanging}"`);
+    }
+    if (attrs.length > 0) {
+      children.push(`<w:ind ${attrs.join(" ")}/>`);
+    }
+  }
+
+  if (paragraphGeometry.tabStops && paragraphGeometry.tabStops.length > 0) {
+    const tabsXml = paragraphGeometry.tabStops.map((tab) => {
+      const leader = tab.leader === "middleDot" ? "middledot" : tab.leader;
+      const leaderAttr = leader ? ` w:leader="${leader}"` : "";
+      return `<w:tab w:val="${tab.align}" w:pos="${tab.position}"${leaderAttr}/>`;
+    }).join("");
+    children.push(`<w:tabs>${tabsXml}</w:tabs>`);
+  }
+
+  return children.length > 0 ? `<w:pPr>${children.join("")}</w:pPr>` : "";
 }
 
 function compareSerializedIds(left: string, right: string): number {