@beyondwork/docx-react-component 1.0.27 → 1.0.29

package/src/io/ooxml/parse-main-document.ts

@@ -1,2877 +0,0 @@
-import type {
-  BorderSpec,
-  TextMark,
-  ParagraphBorders,
-  ParagraphShading,
-  ParagraphSpacing,
-  ParagraphIndentation,
-  TabStop,
-  TableLook,
-  TableWidth,
-  SectionProperties,
-  PageSize,
-  PageMargins,
-  ColumnProperties,
-  PageNumbering,
-  HeaderFooterReference,
-  HeaderFooterVariant,
-  SectionDocumentGrid,
-  SectionLineNumbering,
-  SectionPageBorders,
-} from "../../model/canonical-document.ts";
-import type { OpcRelationship } from "./part-manifest.ts";
-import {
-  parseInlineMediaXml,
-  type InlineMediaPart,
-} from "./parse-inline-media.ts";
-import { toCanonicalNumberingInstanceId } from "./parse-numbering.ts";
-import { parseComplexContentXml } from "./parse-complex-content.ts";
-import { parseShapeXml, parseVmlXml } from "./parse-shapes.ts";
-import { classifyFieldInstruction } from "./parse-fields.ts";
-import { resolveHighlightColor } from "./highlight-colors.ts";
-
-export interface ParsedMainDocument {
-  blocks: ParsedBlockNode[];
-  finalSectionProperties?: SectionProperties;
-}
-
-export type ParsedBlockNode =
-  | ParsedParagraphNode
-  | ParsedTableBlockNode
-  | ParsedSdtNode
-  | ParsedCustomXmlNode
-  | ParsedAltChunkNode
-  | ParsedSectionBreakNode
-  | ParsedOpaqueBlockNode;
-
-export interface ParsedSectionBreakNode {
-  type: "section_break";
-  sectionPropertiesXml: string;
-  sectionProperties: SectionProperties;
-}
-
-export interface ParsedParagraphNode {
-  type: "paragraph";
-  styleId?: string;
-  numbering?: {
-    numberingInstanceId: string;
-    level: number;
-  };
-  alignment?: "left" | "center" | "right" | "both" | "distribute";
-  spacing?: ParagraphSpacing;
-  contextualSpacing?: boolean;
-  indentation?: ParagraphIndentation;
-  tabStops?: TabStop[];
-  keepNext?: boolean;
-  keepLines?: boolean;
-  outlineLevel?: number;
-  pageBreakBefore?: boolean;
-  widowControl?: boolean;
-  borders?: ParagraphBorders;
-  shading?: ParagraphShading;
-  bidi?: boolean;
-  suppressLineNumbers?: boolean;
-  cnfStyle?: string;
-  sectionProperties?: SectionProperties;
-  sectionPropertiesXml?: string;
-  children: ParsedInlineNode[];
-  rawXml: string;
-}
-
-export type ParsedInlineNode =
-  | ParsedTextNode
-  | ParsedBreakNode
-  | ParsedColumnBreakNode
-  | ParsedTabNode
-  | ParsedSymbolNode
-  | ParsedImageNode
-  | ParsedHyperlinkNode
-  | ParsedOpaqueInlineNode
-  | ParsedChartPreviewNode
-  | ParsedSmartArtPreviewNode
-  | ParsedShapeInlineNode
-  | ParsedWordArtInlineNode
-  | ParsedVmlShapeInlineNode
-  | ParsedBookmarkStartInlineNode
-  | ParsedBookmarkEndInlineNode
-  | ParsedFootnoteRefInlineNode
-  | ParsedFieldInlineNode
-  | ParsedPermStartInlineNode
-  | ParsedPermEndInlineNode;
-
-export interface ParsedTextNode {
-  type: "text";
-  text: string;
-  marks?: TextMark[];
-}
-
-export interface ParsedBreakNode {
-  type: "hard_break";
-}
-
-export interface ParsedColumnBreakNode {
-  type: "column_break";
-}
-
-export interface ParsedTabNode {
-  type: "tab";
-}
-
-export interface ParsedSymbolNode {
-  type: "symbol";
-  char: string;
-  font?: string;
-  marks?: TextMark[];
-}
-
-export interface ParsedImageNode {
-  type: "image";
-  mediaId: string;
-  relationshipId?: string;
-  packagePartName?: string;
-  contentType?: string;
-  filename?: string;
-  altText?: string;
-  widthEmu?: number;
-  heightEmu?: number;
-  placementXml?: string;
-  display?: "inline" | "floating";
-  floating?: {
-    horizontalPosition?: {
-      relativeFrom?: string;
-      align?: string;
-      offset?: number;
-    };
-    verticalPosition?: {
-      relativeFrom?: string;
-      align?: string;
-      offset?: number;
-    };
-    wrap?: "none" | "square" | "tight" | "through" | "topAndBottom";
-    behindDoc?: boolean;
-    layoutInCell?: boolean;
-    allowOverlap?: boolean;
-  };
-}
-
-export interface ParsedHyperlinkNode {
-  type: "hyperlink";
-  href: string;
-  children: Array<ParsedTextNode | ParsedBreakNode | ParsedColumnBreakNode | ParsedTabNode | ParsedSymbolNode>;
-  rawXml: string;
-}
-
-export interface ParsedOpaqueInlineNode {
-  type: "opaque_inline";
-  rawXml: string;
-}
-
-export interface ParsedChartPreviewNode {
-  type: "chart_preview";
-  previewMediaId?: string;
-  rawXml: string;
-}
-
-export interface ParsedSmartArtPreviewNode {
-  type: "smartart_preview";
-  previewMediaId?: string;
-  rawXml: string;
-}
-
-export interface ParsedShapeInlineNode {
-  type: "shape";
-  text?: string;
-  geometry?: string;
-  isTextBox?: boolean;
-  rawXml: string;
-}
-
-export interface ParsedWordArtInlineNode {
-  type: "wordart";
-  text: string;
-  geometry?: string;
-  rawXml: string;
-}
-
-export interface ParsedVmlShapeInlineNode {
-  type: "vml_shape";
-  text?: string;
-  shapeType?: string;
-  rawXml: string;
-}
-
-export interface ParsedBookmarkStartInlineNode {
-  type: "bookmark_start";
-  bookmarkId: string;
-  name: string;
-  rawXml: string;
-}
-
-export interface ParsedBookmarkEndInlineNode {
-  type: "bookmark_end";
-  bookmarkId: string;
-  rawXml: string;
-}
-
-export interface ParsedFootnoteRefInlineNode {
-  type: "footnote_ref";
-  noteId: string;
-  noteKind: "footnote" | "endnote";
-}
-
-export interface ParsedFieldInlineNode {
-  type: "field";
-  fieldType: "simple" | "complex";
-  instruction: string;
-  contentXml?: string;
-  children?: Array<ParsedTextNode | ParsedBreakNode | ParsedTabNode>;
-  rawXml: string;
-}
-
-export interface ParsedPermStartInlineNode {
-  type: "perm_start";
-  rangeId: string;
-  editorGroup?: string;
-  editor?: string;
-  rawXml: string;
-}
-
-export interface ParsedPermEndInlineNode {
-  type: "perm_end";
-  rangeId: string;
-  rawXml: string;
-}
-
-export interface ParsedOpaqueBlockNode {
-  type: "opaque_block";
-  rawXml: string;
-}
-
-export interface ParsedSdtCheckboxState {
-  checked: boolean;
-  checkedChar?: string;
-  uncheckedChar?: string;
-}
-
-export interface ParsedSdtDatePickerState {
-  fullDate?: string;
-  dateFormat?: string;
-  lid?: string;
-}
-
-export interface ParsedSdtDropdownListItem {
-  displayText?: string;
-  value: string;
-}
-
-export interface ParsedSdtNode {
-  type: "sdt";
-  properties: {
-    sdtType?: string;
-    alias?: string;
-    tag?: string;
-    lock?: string;
-    propertiesXml?: string;
-    checkbox?: ParsedSdtCheckboxState;
-    datePicker?: ParsedSdtDatePickerState;
-    dropdownList?: ParsedSdtDropdownListItem[];
-    comboBox?: ParsedSdtDropdownListItem[];
-    showingPlcHdr?: boolean;
-  };
-  children: ParsedBlockNode[];
-  rawXml: string;
-}
-
-export interface ParsedCustomXmlNode {
-  type: "custom_xml";
-  uri?: string;
-  element?: string;
-  children: ParsedBlockNode[];
-  rawXml: string;
-}
-
-export interface ParsedAltChunkNode {
-  type: "alt_chunk";
-  relationshipId: string;
-  rawXml: string;
-}
-
-export interface ParsedTableBlockNode {
-  type: "table";
-  styleId?: string;
-  tblLook?: TableLook;
-  propertiesXml?: string;
-  gridColumns: number[];
-  rows: ParsedTableRowNode[];
-  rawXml: string;
-}
-
-export interface ParsedTableRowNode {
-  type: "table_row";
-  propertiesXml?: string;
-  cells: ParsedTableCellNode[];
-  gridBefore?: number;
-  widthBefore?: TableWidth;
-  gridAfter?: number;
-  widthAfter?: TableWidth;
-  rawXml: string;
-}
-
-export interface ParsedTableCellNode {
-  type: "table_cell";
-  propertiesXml?: string;
-  gridSpan?: number;
-  verticalMerge?: "restart" | "continue";
-  children: ParsedBlockNode[];
-  rawXml: string;
-}
-
-interface XmlElementNode {
-  type: "element";
-  name: string;
-  attributes: Record<string, string>;
-  children: XmlNode[];
-  start: number;
-  end: number;
-}
-
-interface XmlTextNode {
-  type: "text";
-  text: string;
-  start: number;
-  end: number;
-}
-
-type XmlNode = XmlElementNode | XmlTextNode;
-
-interface RunParseResult {
-  nodes: Array<ParsedTextNode | ParsedBreakNode | ParsedColumnBreakNode | ParsedTabNode | ParsedSymbolNode>;
-  supported: boolean;
-}
-
-interface MarksParseResult {
-  marks: TextMark[];
-  supported: boolean;
-}
-
-const HYPERLINK_RELATIONSHIP_TYPE =
-  "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
-
-export function parseMainDocumentXml(
-  xml: string,
-  relationships: readonly OpcRelationship[] = [],
-  mediaParts: ReadonlyMap<string, InlineMediaPart> = new Map(),
-  sourcePartPath = "/word/document.xml",
-): ParsedMainDocument {
-  const root = parseXml(xml);
-  const documentElement = findChildElement(root, "document");
-  const bodyElement = findChildElement(documentElement, "body");
-  const relationshipMap = new Map(relationships.map((relationship) => [relationship.id, relationship]));
-
-  const allBlocks = bodyElement.children
-    .filter((node): node is XmlElementNode => node.type === "element")
-    .map((node) => parseBodyChild(node, xml, relationshipMap, relationships, mediaParts, sourcePartPath));
-
-  // The last body-level sectPr is the final section properties (not an intermediate section break).
-  // Extract it from the blocks list and store it separately.
-  let finalSectionProperties: SectionProperties | undefined;
-  const blocks: ParsedBlockNode[] = [];
-  for (let i = 0; i < allBlocks.length; i++) {
-    const block = allBlocks[i];
-    if (block.type === "section_break" && i === allBlocks.length - 1) {
-      finalSectionProperties = block.sectionProperties;
-    } else {
-      blocks.push(block);
-    }
-  }
-
-  return { blocks, finalSectionProperties };
-}
-
-function parseBodyChild(
-  node: XmlElementNode,
-  sourceXml: string,
-  relationshipMap: Map<string, OpcRelationship>,
-  relationships: readonly OpcRelationship[],
-  mediaParts: ReadonlyMap<string, InlineMediaPart>,
-  sourcePartPath: string,
-): ParsedBlockNode {
-  const nodeType = localName(node.name);
-
-  if (nodeType === "tbl") {
-    // Tables with revision markup (tracked changes inside cells) stay opaque
-    // to preserve fidelity until revision-aware table editing is implemented
-    const rawTableXml = sourceXml.slice(node.start, node.end);
-    if (tableRequiresOpaquePreservation(rawTableXml)) {
-      return {
-        type: "opaque_block",
-        rawXml: rawTableXml,
-      };
-    }
-    try {
-      return parseTableElement(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath);
-    } catch {
-      // If table parsing fails for any reason, fall back to opaque preservation
-      return {
-        type: "opaque_block",
-        rawXml: rawTableXml,
-      };
-    }
-  }
-
-  if (nodeType === "sdt") {
-    return parseSdtElement(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath);
-  }
-
-  if (nodeType === "customXml") {
-    return parseCustomXmlElement(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath);
-  }
-
-  if (nodeType === "altChunk") {
-    return parseAltChunkElement(node, sourceXml);
-  }
-
-  if (nodeType === "sectPr") {
-    return parseSectionBreakElement(node, sourceXml);
-  }
-
-  if (nodeType !== "p") {
-    return {
-      type: "opaque_block",
-      rawXml: sourceXml.slice(node.start, node.end),
-    };
-  }
-
-  let styleId: string | undefined;
-  let numbering: ParsedParagraphNode["numbering"];
-  let alignment: ParsedParagraphNode["alignment"];
-  let spacing: ParsedParagraphNode["spacing"];
-  let contextualSpacing: ParsedParagraphNode["contextualSpacing"];
-  let indentation: ParsedParagraphNode["indentation"];
-  let tabStops: ParsedParagraphNode["tabStops"];
-  let keepNext: ParsedParagraphNode["keepNext"];
-  let keepLines: ParsedParagraphNode["keepLines"];
-  let outlineLevel: ParsedParagraphNode["outlineLevel"];
-  let pageBreakBefore: ParsedParagraphNode["pageBreakBefore"];
-  let widowControl: ParsedParagraphNode["widowControl"];
-  let borders: ParsedParagraphNode["borders"];
-  let shading: ParsedParagraphNode["shading"];
-  let bidi: ParsedParagraphNode["bidi"];
-  let suppressLineNumbers: ParsedParagraphNode["suppressLineNumbers"];
-  let cnfStyle: ParsedParagraphNode["cnfStyle"];
-  let sectionProperties: SectionProperties | undefined;
-  let sectionPropertiesXml: string | undefined;
-  let paragraphSupported = true;
-  const children: ParsedInlineNode[] = [];
-  let activeComplexField: {
-    instruction: string;
-    children: Array<ParsedTextNode | ParsedBreakNode | ParsedTabNode>;
-    mode: "instruction" | "result";
-  } | null = null;
-
-  for (const child of node.children) {
-    if (child.type !== "element") {
-      continue;
-    }
-
-    switch (localName(child.name)) {
-      case "pPr":
-        styleId = readParagraphStyleId(child);
-        numbering = readParagraphNumbering(child);
-        alignment = readParagraphAlignment(child);
-        spacing = readParagraphSpacing(child);
-        contextualSpacing = readOptionalOnOffParagraphProperty(child, "contextualSpacing");
-        indentation = readParagraphIndentation(child);
-        tabStops = readParagraphTabStops(child);
-        keepNext = readOnOffParagraphProperty(child, "keepNext");
-        keepLines = readOnOffParagraphProperty(child, "keepLines");
-        outlineLevel = readParagraphOutlineLevel(child);
-        pageBreakBefore = readOnOffParagraphProperty(child, "pageBreakBefore");
-        widowControl = readOnOffParagraphProperty(child, "widowControl");
-        borders = readParagraphBorders(child);
-        shading = readParagraphShading(child);
-        bidi = readOnOffParagraphProperty(child, "bidi");
-        suppressLineNumbers = readOnOffParagraphProperty(child, "suppressLineNumbers");
-        cnfStyle = readParagraphCnfStyle(child);
-        sectionProperties = readSectionPropertiesFromPPr(child);
-        sectionPropertiesXml = readSectionPropertiesXmlFromPPr(child, sourceXml);
-        paragraphSupported = paragraphSupported && supportsParagraphProperties(child);
-        break;
-      case "r":
-        activeComplexField = appendParagraphRunNodes(
-          child,
-          children,
-          activeComplexField,
-          sourceXml,
-          relationships,
-          mediaParts,
-          sourcePartPath,
-        );
-        break;
-      case "hyperlink": {
-        flushActiveComplexField(children, () => {
-          activeComplexField = null;
-        }, activeComplexField);
-        const hyperlink = parseHyperlink(child, sourceXml, relationshipMap);
-        children.push(hyperlink);
-        break;
-      }
-      case "ins":
-      case "del": {
-        flushActiveComplexField(children, () => {
-          activeComplexField = null;
-        }, activeComplexField);
-        children.push(...parseRevisionContainer(child, sourceXml, relationshipMap));
-        break;
-      }
-      case "commentRangeStart":
-      case "commentRangeEnd":
-        break;
-      case "bookmarkStart": {
-        const bkId = child.attributes["w:id"] ?? child.attributes.id ?? "";
-        const bkName = child.attributes["w:name"] ?? child.attributes.name ?? "";
-        if (bkId) {
-          const bookmarkNode = {
-            type: "bookmark_start",
-            bookmarkId: bkId,
-            name: bkName,
-            rawXml: sourceXml.slice(child.start, child.end),
-          } as ParsedBookmarkStartInlineNode;
-          flushActiveComplexField(children, () => {
-            activeComplexField = null;
-          }, activeComplexField);
-          children.push(bookmarkNode);
-        } else {
-          flushActiveComplexField(children, () => {
-            activeComplexField = null;
-          }, activeComplexField);
-          children.push({ type: "opaque_inline", rawXml: sourceXml.slice(child.start, child.end) });
-        }
-        break;
-      }
-      case "bookmarkEnd": {
-        const bkEndId = child.attributes["w:id"] ?? child.attributes.id ?? "";
-        if (bkEndId) {
-          const bookmarkNode = {
-            type: "bookmark_end",
-            bookmarkId: bkEndId,
-            rawXml: sourceXml.slice(child.start, child.end),
-          } as ParsedBookmarkEndInlineNode;
-          flushActiveComplexField(children, () => {
-            activeComplexField = null;
-          }, activeComplexField);
-          children.push(bookmarkNode);
-        } else {
-          flushActiveComplexField(children, () => {
-            activeComplexField = null;
-          }, activeComplexField);
-          children.push({ type: "opaque_inline", rawXml: sourceXml.slice(child.start, child.end) });
-        }
-        break;
-      }
-      case "fldSimple": {
-        flushActiveComplexField(children, () => {
-          activeComplexField = null;
-        }, activeComplexField);
-        const fieldInstr = child.attributes["w:instr"] ?? child.attributes.instr ?? "";
-        const fieldContentXml = child.children
-          .filter((c): c is XmlElementNode => c.type === "element")
-          .map((c) => sourceXml.slice(c.start, c.end))
-          .join("");
-        children.push({
-          type: "field",
-          fieldType: "simple",
-          instruction: fieldInstr,
-          contentXml: fieldContentXml,
-          rawXml: sourceXml.slice(child.start, child.end),
-        } as ParsedFieldInlineNode);
-        break;
-      }
-      case "proofErr":
-        flushActiveComplexField(children, () => {
-          activeComplexField = null;
-        }, activeComplexField);
-        children.push({
-          type: "opaque_inline",
-          rawXml: sourceXml.slice(child.start, child.end),
-        });
-        break;
-      case "permStart":
-        flushActiveComplexField(children, () => {
-          activeComplexField = null;
-        }, activeComplexField);
-        children.push(parsePermStartNode(child, sourceXml));
-        break;
-      case "permEnd":
-        flushActiveComplexField(children, () => {
-          activeComplexField = null;
-        }, activeComplexField);
-        children.push(parsePermEndNode(child, sourceXml));
-        break;
-      case "footnoteReference": {
-        flushActiveComplexField(children, () => {
-          activeComplexField = null;
-        }, activeComplexField);
-        const noteId = child.attributes["w:id"] ?? child.attributes.id ?? "";
-        if (noteId) {
-          children.push({
-            type: "footnote_ref",
-            noteId,
-            noteKind: "footnote",
-          });
-        }
-        break;
-      }
-      case "endnoteReference": {
-        flushActiveComplexField(children, () => {
-          activeComplexField = null;
-        }, activeComplexField);
-        const noteId = child.attributes["w:id"] ?? child.attributes.id ?? "";
-        if (noteId) {
-          children.push({
-            type: "footnote_ref",
-            noteId,
-            noteKind: "endnote",
-          });
-        }
-        break;
-      }
-      default:
-        flushActiveComplexField(children, () => {
-          activeComplexField = null;
-        }, activeComplexField);
-        children.push({
-          type: "opaque_inline",
-          rawXml: sourceXml.slice(child.start, child.end),
-        });
-        break;
-    }
-  }
-
-  flushActiveComplexField(children, () => {
-    activeComplexField = null;
-  }, activeComplexField);
-
-  if (!paragraphSupported) {
-    return {
-      type: "opaque_block",
-      rawXml: sourceXml.slice(node.start, node.end),
-    };
-  }
-
-  return {
-    type: "paragraph",
-    styleId,
-    ...(numbering ? { numbering } : {}),
-    ...(alignment ? { alignment } : {}),
-    ...(spacing ? { spacing } : {}),
-    ...(contextualSpacing !== undefined ? { contextualSpacing } : {}),
-    ...(indentation ? { indentation } : {}),
-    ...(tabStops && tabStops.length > 0 ? { tabStops } : {}),
-    ...(keepNext ? { keepNext } : {}),
-    ...(keepLines ? { keepLines } : {}),
-    ...(outlineLevel !== undefined ? { outlineLevel } : {}),
-    ...(pageBreakBefore ? { pageBreakBefore } : {}),
-    ...(widowControl ? { widowControl } : {}),
-    ...(borders ? { borders } : {}),
-    ...(shading ? { shading } : {}),
-    ...(bidi ? { bidi } : {}),
-    ...(suppressLineNumbers ? { suppressLineNumbers } : {}),
-    ...(cnfStyle ? { cnfStyle } : {}),
-    ...(sectionProperties ? { sectionProperties } : {}),
-    ...(sectionPropertiesXml ? { sectionPropertiesXml } : {}),
-    children,
-    rawXml: sourceXml.slice(node.start, node.end),
-  };
-}
-
-function appendParagraphRunNodes(
-  node: XmlElementNode,
-  children: ParsedInlineNode[],
-  activeComplexField: {
-    instruction: string;
-    children: Array<ParsedTextNode | ParsedBreakNode | ParsedTabNode>;
-    mode: "instruction" | "result";
-  } | null,
-  sourceXml: string,
-  relationships: readonly OpcRelationship[],
-  mediaParts: ReadonlyMap<string, InlineMediaPart>,
-  sourcePartPath: string,
-): {
-  instruction: string;
-  children: Array<ParsedTextNode | ParsedBreakNode | ParsedTabNode>;
-  mode: "instruction" | "result";
-} | null {
-  const hasFieldMarkers = node.children.some(
-    (child) =>
-      child.type === "element" &&
-      (localName(child.name) === "fldChar" || localName(child.name) === "instrText"),
-  );
-
-  if (activeComplexField?.mode === "result" && !hasFieldMarkers) {
-    const run = parseRunContentOnly(node, sourceXml);
-    if (
-      run.supported &&
-      run.nodes.every(
-        (child) =>
-          child.type === "text" || child.type === "hard_break" || child.type === "tab",
-      )
-    ) {
-      activeComplexField.children.push(...run.nodes);
-      return activeComplexField;
-    }
-  }
-
-  if (!hasFieldMarkers) {
-    children.push(...parseRun(node, sourceXml, relationships, mediaParts, sourcePartPath));
-    return activeComplexField;
-  }
-
-  for (const child of node.children) {
-    if (child.type !== "element") {
-      continue;
-    }
-
-    const name = localName(child.name);
-    if (name === "fldChar") {
-      const fldType = child.attributes["w:fldCharType"] ?? child.attributes.fldCharType;
-      if (fldType === "begin") {
-        activeComplexField = { instruction: "", children: [], mode: "instruction" };
-      } else if (fldType === "separate" && activeComplexField) {
-        activeComplexField.mode = "result";
-      } else if (fldType === "end" && activeComplexField) {
-        flushActiveComplexField(children, () => {
-          activeComplexField = null;
-        }, activeComplexField);
-      }
-      continue;
-    }
-
-    if (name === "instrText") {
-      const instruction = child.children
-        .filter((entry): entry is XmlTextNode => entry.type === "text")
-        .map((entry) => entry.text)
-        .join("");
-      if (activeComplexField) {
-        activeComplexField.instruction += instruction;
-      } else if (instruction.trim().length > 0) {
-        children.push({
-          type: "field",
-          fieldType: "complex",
-          instruction,
-          children: [],
-          rawXml: sourceXml.slice(node.start, node.end),
-        });
-      }
-      continue;
-    }
-  }
-
-  return activeComplexField;
-}
-
-function flushActiveComplexField(
-  children: ParsedInlineNode[],
-  reset: () => void,
-  activeComplexField: {
-    instruction: string;
-    children: Array<ParsedTextNode | ParsedBreakNode | ParsedTabNode>;
-    mode: "instruction" | "result";
-  } | null,
-): void {
-  if (!activeComplexField || activeComplexField.instruction.trim().length === 0) {
-    return;
-  }
-
-  children.push({
-    type: "field",
-    fieldType: "complex",
-    instruction: activeComplexField.instruction,
-    children: activeComplexField.children,
-    rawXml: "",
-  });
-  reset();
-}
-
-function parseTableElement(
-  node: XmlElementNode,
-  sourceXml: string,
-  relationshipMap: Map<string, OpcRelationship>,
-  relationships: readonly OpcRelationship[],
-  mediaParts: ReadonlyMap<string, InlineMediaPart>,
-  sourcePartPath: string,
-): ParsedTableBlockNode {
-  let styleId: string | undefined;
-  let tblLook: TableLook | undefined;
-  let propertiesXml: string | undefined;
-  let gridColumns: number[] = [];
-  const rows: ParsedTableRowNode[] = [];
-
-  for (const child of node.children) {
-    if (child.type !== "element") continue;
-
-    switch (localName(child.name)) {
-      case "tblPr": {
-        propertiesXml = sourceXml.slice(child.start, child.end);
-        styleId = readTableStyleId(child);
-        tblLook = readTableLook(child);
-        break;
-      }
-      case "tblGrid": {
-        gridColumns = readTableGridColumns(child);
-        break;
-      }
-      case "tr": {
-        rows.push(parseTableRowElement(child, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath));
-        break;
-      }
-    }
-  }
-
-  return {
-    type: "table",
-    ...(styleId ? { styleId } : {}),
-    ...(tblLook ? { tblLook } : {}),
-    ...(propertiesXml ? { propertiesXml } : {}),
-    gridColumns,
-    rows,
-    rawXml: sourceXml.slice(node.start, node.end),
-  };
-}
-
-function parseTableRowElement(
-  node: XmlElementNode,
-  sourceXml: string,
-  relationshipMap: Map<string, OpcRelationship>,
-  relationships: readonly OpcRelationship[],
-  mediaParts: ReadonlyMap<string, InlineMediaPart>,
-  sourcePartPath: string,
-): ParsedTableRowNode {
-  let propertiesXml: string | undefined;
-  let gridBefore: number | undefined;
-  let widthBefore: TableWidth | undefined;
-  let gridAfter: number | undefined;
-  let widthAfter: TableWidth | undefined;
-  const cells: ParsedTableCellNode[] = [];
-
-  for (const child of node.children) {
-    if (child.type !== "element") continue;
-
-    switch (localName(child.name)) {
-      case "trPr":
-        propertiesXml = sourceXml.slice(child.start, child.end);
-        gridBefore = readTableRowGridPosition(child, "gridBefore");
-        widthBefore = readTableRowWidth(child, "wBefore");
-        gridAfter = readTableRowGridPosition(child, "gridAfter");
-        widthAfter = readTableRowWidth(child, "wAfter");
-        break;
-      case "tc":
-        cells.push(parseTableCellElement(child, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath));
-        break;
-    }
-  }
-
-  return {
-    type: "table_row",
-    ...(propertiesXml ? { propertiesXml } : {}),
-    ...(gridBefore !== undefined ? { gridBefore } : {}),
-    ...(widthBefore ? { widthBefore } : {}),
-    ...(gridAfter !== undefined ? { gridAfter } : {}),
-    ...(widthAfter ? { widthAfter } : {}),
-    cells,
-    rawXml: sourceXml.slice(node.start, node.end),
-  };
-}
-
-function parseTableCellElement(
-  node: XmlElementNode,
-  sourceXml: string,
-  relationshipMap: Map<string, OpcRelationship>,
-  relationships: readonly OpcRelationship[],
-  mediaParts: ReadonlyMap<string, InlineMediaPart>,
-  sourcePartPath: string,
-): ParsedTableCellNode {
-  let propertiesXml: string | undefined;
-  let gridSpan: number | undefined;
-  let verticalMerge: "restart" | "continue" | undefined;
-  const children: ParsedBlockNode[] = [];
-
-  for (const child of node.children) {
-    if (child.type !== "element") continue;
-
-    switch (localName(child.name)) {
-      case "tcPr": {
-        propertiesXml = sourceXml.slice(child.start, child.end);
-        gridSpan = readCellGridSpan(child);
-        verticalMerge = readCellVerticalMerge(child);
-        break;
-      }
-      default: {
-        // Everything else in a cell is a block child (paragraphs, nested tables, etc.)
-        children.push(parseBodyChild(child, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath));
-        break;
-      }
-    }
-  }
-
-  return {
-    type: "table_cell",
-    ...(propertiesXml ? { propertiesXml } : {}),
-    ...(gridSpan ? { gridSpan } : {}),
-    ...(verticalMerge ? { verticalMerge } : {}),
-    children,
-    rawXml: sourceXml.slice(node.start, node.end),
-  };
-}
-
-function parseSdtElement(
-  node: XmlElementNode,
-  sourceXml: string,
-  relationshipMap: Map<string, OpcRelationship>,
-  relationships: readonly OpcRelationship[],
-  mediaParts: ReadonlyMap<string, InlineMediaPart>,
-  sourcePartPath: string,
-): ParsedBlockNode {
-  const propertiesNode = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "sdtPr",
-  );
-  const contentNode = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "sdtContent",
-  );
-
-  if (!contentNode) {
-    return {
-      type: "opaque_block",
-      rawXml: sourceXml.slice(node.start, node.end),
-    };
-  }
-
-  const children = contentNode.children
-    .filter((child): child is XmlElementNode => child.type === "element")
-    .map((child) => parseBodyChild(child, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath));
-
-  return {
-    type: "sdt",
-    properties: readSdtProperties(propertiesNode, sourceXml),
-    children,
-    rawXml: sourceXml.slice(node.start, node.end),
-  };
-}
-
-function parseCustomXmlElement(
-  node: XmlElementNode,
-  sourceXml: string,
-  relationshipMap: Map<string, OpcRelationship>,
-  relationships: readonly OpcRelationship[],
-  mediaParts: ReadonlyMap<string, InlineMediaPart>,
-  sourcePartPath: string,
-): ParsedBlockNode {
-  const uri = readOptionalAttribute(node, "uri");
-  const element = readOptionalAttribute(node, "element");
-  if (!uri && !element) {
-    return {
-      type: "opaque_block",
-      rawXml: sourceXml.slice(node.start, node.end),
-    };
-  }
-
-  const children = node.children
-    .filter(
-      (child): child is XmlElementNode =>
-        child.type === "element" && localName(child.name) !== "customXmlPr",
-    )
-    .map((child) => parseBodyChild(child, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath));
-
-  return {
-    type: "custom_xml",
-    ...(uri ? { uri } : {}),
-    ...(element ? { element } : {}),
-    children,
-    rawXml: sourceXml.slice(node.start, node.end),
-  };
-}
-
-function parseAltChunkElement(
-  node: XmlElementNode,
-  sourceXml: string,
-): ParsedBlockNode {
-  const relationshipId = readOptionalAttribute(node, "id");
-  if (!relationshipId) {
-    return {
-      type: "opaque_block",
-      rawXml: sourceXml.slice(node.start, node.end),
-    };
-  }
-
-  return {
-    type: "alt_chunk",
-    relationshipId,
-    rawXml: sourceXml.slice(node.start, node.end),
-  };
-}
-
-function readSdtProperties(
-  node: XmlElementNode | undefined,
-  sourceXml: string,
-): ParsedSdtNode["properties"] {
-  if (!node) {
-    return {};
-  }
-
-  const properties: ParsedSdtNode["properties"] = {
-    propertiesXml: sourceXml.slice(node.start, node.end),
-  };
-
-  for (const child of node.children) {
-    if (child.type !== "element") {
-      continue;
-    }
-
-    const name = localName(child.name);
-    if (name === "alias") {
-      properties.alias = readOptionalAttribute(child, "val");
-      continue;
-    }
-    if (name === "tag") {
-      properties.tag = readOptionalAttribute(child, "val");
-      continue;
-    }
-    if (name === "lock") {
-      properties.lock = readOptionalAttribute(child, "val");
-      continue;
-    }
-    if (name === "showingPlcHdr") {
-      const val = readOptionalAttribute(child, "val");
-      properties.showingPlcHdr = val !== "false" && val !== "0";
-      continue;
-    }
-
-    // Checkbox (w14:checkbox)
-    if (name === "checkbox") {
-      properties.sdtType = "checkbox";
-      const checkedNode = findFirstDescendant(child, "checked");
-      const checkedVal = checkedNode ? (readOptionalAttribute(checkedNode, "val") ?? "0") : "0";
-      const checkedCharNode = findFirstDescendant(child, "checkedState");
-      const uncheckedCharNode = findFirstDescendant(child, "uncheckedState");
-      properties.checkbox = {
-        checked: checkedVal === "1" || checkedVal === "true",
-        ...(checkedCharNode ? { checkedChar: readOptionalAttribute(checkedCharNode, "val") } : {}),
-        ...(uncheckedCharNode ? { uncheckedChar: readOptionalAttribute(uncheckedCharNode, "val") } : {}),
-      };
-      continue;
-    }
-
-    // Date picker
-    if (name === "date") {
-      properties.sdtType = "date";
-      const fullDate = readOptionalAttribute(child, "fullDate");
-      const dateFormatNode = findFirstChild(child, "dateFormat");
-      const lidNode = findFirstChild(child, "lid");
-      properties.datePicker = {
-        ...(fullDate ? { fullDate } : {}),
-        ...(dateFormatNode ? { dateFormat: readOptionalAttribute(dateFormatNode, "val") } : {}),
-        ...(lidNode ? { lid: readOptionalAttribute(lidNode, "val") } : {}),
-      };
-      continue;
-    }
-
-    // Dropdown list
-    if (name === "dropDownList") {
-      properties.sdtType = "dropDownList";
-      properties.dropdownList = readSdtListItems(child);
-      continue;
-    }
-
-    // Combo box
-    if (name === "comboBox") {
-      properties.sdtType = "comboBox";
-      properties.comboBox = readSdtListItems(child);
-      continue;
-    }
-
-    // Plain text
-    if (name === "text") {
-      properties.sdtType = "plainText";
-      continue;
-    }
-
-    // Rich text (richText element is the default, but if explicitly present, tag it)
-    if (name === "richText") {
-      properties.sdtType = "richText";
-      continue;
-    }
-
-    if (!properties.sdtType && name !== "id" && name !== "placeholder" && name !== "showingPlcHdr" && name !== "rPr") {
-      properties.sdtType = name;
-    }
-  }
-
-  return properties;
-}
-
-function readSdtListItems(node: XmlElementNode): ParsedSdtDropdownListItem[] {
-  const items: ParsedSdtDropdownListItem[] = [];
-  for (const child of node.children) {
-    if (child.type !== "element" || localName(child.name) !== "listItem") continue;
-    const value = readOptionalAttribute(child, "value") ?? "";
-    const displayText = readOptionalAttribute(child, "displayText");
-    items.push({ value, ...(displayText ? { displayText } : {}) });
-  }
-  return items;
-}
-
-function findFirstChild(node: XmlElementNode, local: string): XmlElementNode | undefined {
-  for (const child of node.children) {
-    if (child.type === "element" && localName(child.name) === local) return child;
-  }
-  return undefined;
-}
-
-function findFirstDescendant(node: XmlElementNode, local: string): XmlElementNode | undefined {
-  for (const child of node.children) {
-    if (child.type !== "element") continue;
-    if (localName(child.name) === local) return child;
-    const nested = findFirstDescendant(child, local);
-    if (nested) return nested;
-  }
-  return undefined;
-}
-
-function readTableStyleId(node: XmlElementNode): string | undefined {
-  for (const child of node.children) {
-    if (child.type !== "element" || localName(child.name) !== "tblStyle") continue;
-    const styleId = child.attributes["w:val"] ?? child.attributes.val;
-    if (styleId) return styleId;
-  }
-  return undefined;
-}
-
-function readTableLook(node: XmlElementNode): TableLook | undefined {
-  const tblLookNode = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "tblLook",
-  );
-  if (!tblLookNode) {
-    return undefined;
-  }
-
-  const tableLook: TableLook = {};
-  const val = tblLookNode.attributes["w:val"] ?? tblLookNode.attributes.val;
-  if (val) {
-    tableLook.val = val;
-  }
-  for (const [attribute, key] of [
-    ["w:firstRow", "firstRow"],
-    ["w:lastRow", "lastRow"],
-    ["w:firstColumn", "firstColumn"],
-    ["w:lastColumn", "lastColumn"],
-    ["w:noHBand", "noHBand"],
-    ["w:noVBand", "noVBand"],
-  ] as const) {
-    const fallback = attribute.replace("w:", "");
-    const raw = tblLookNode.attributes[attribute] ?? tblLookNode.attributes[fallback];
-    if (raw !== undefined) {
-      tableLook[key] = raw !== "0" && raw !== "false" && raw !== "off";
-    }
-  }
-
-  return Object.keys(tableLook).length > 0 ? tableLook : undefined;
-}
-
-function readTableGridColumns(node: XmlElementNode): number[] {
-  return node.children
-    .filter((child): child is XmlElementNode => child.type === "element" && localName(child.name) === "gridCol")
-    .map((child) => {
-      const raw = child.attributes["w:w"] ?? child.attributes.w ?? "0";
-      const value = Number.parseInt(raw, 10);
-      return Number.isFinite(value) && value > 0 ? value : 0;
-    });
-}
-
-/**
- * Check if a table's raw XML contains content that cannot safely round-trip
- * through the parsed table path yet. This includes:
- * - Revision markup (tracked changes inside cells)
- * - Field syntax and smart tags that still lack a safe table-local live model
- * - Grid geometry tags that the table serializer does not reconstruct yet
- *
- * Tables matching this check stay opaque until the respective features
- * are implemented in the table editing path.
- */
-function tableRequiresOpaquePreservation(rawXml: string): boolean {
-  // Safe table-local content now includes hyperlinks, bookmarks, comments,
-  // nested tables, floating images, VML preview atoms, and bounded field
-  // families already owned by the current field slice. Risky table-local
-  // semantics still fail closed to preserve-only.
-  if (/<w:(ins|del|rPrChange|pPrChange|tblPrChange|trPrChange|tcPrChange|sectPrChange|cellIns|cellDel|cellMerge|smartTag|tblCellSpacing)\b/.test(rawXml)) {
-    return true;
-  }
-
-  const simpleInstructions = [...rawXml.matchAll(/\bw:instr="([^"]*)"/g)].map((match) => match[1] ?? "");
-  const complexInstructions = extractComplexFieldInstructions(rawXml);
-  for (const instruction of [...simpleInstructions, ...complexInstructions]) {
-    const classification = classifyFieldInstruction(instruction);
-    if (!isSafeMainStoryTableFieldFamily(classification.family)) {
-      return true;
-    }
-  }
-
-  return false;
-}
-
-function isSafeMainStoryTableFieldFamily(family: string): boolean {
-  return (
-    family === "REF" ||
-    family === "PAGEREF" ||
-    family === "NOTEREF" ||
-    family === "TOC" ||
-    family === "PAGE" ||
-    family === "NUMPAGES"
-  );
-}
-
-function extractComplexFieldInstructions(rawXml: string): string[] {
-  const tokenPattern =
-    /<(?:\w+:)?fldChar\b[^>]*?(?:\w+:)?fldCharType="(begin|separate|end)"[^>]*?(?:\/>|>[\s\S]*?<\/(?:\w+:)?fldChar>)|<(?:\w+:)?instrText\b[^>]*>([\s\S]*?)<\/(?:\w+:)?instrText>/gu;
-  const instructions: string[] = [];
-  let activeInstruction = "";
-  let capturingInstruction = false;
-
-  for (const match of rawXml.matchAll(tokenPattern)) {
-    const fldCharType = match[1];
-    const instrText = match[2];
-    if (fldCharType === "begin") {
-      activeInstruction = "";
-      capturingInstruction = true;
-      continue;
-    }
-    if (fldCharType === "separate" || fldCharType === "end") {
-      if (capturingInstruction && activeInstruction.trim().length > 0) {
-        instructions.push(activeInstruction);
-      }
-      activeInstruction = "";
-      capturingInstruction = false;
-      continue;
-    }
-    if (capturingInstruction && instrText !== undefined) {
-      activeInstruction += decodeXmlEntities(instrText);
-    }
-  }
-
-  return instructions;
-}
-
-function readTableRowGridPosition(
-  node: XmlElementNode,
-  local: "gridBefore" | "gridAfter",
-): number | undefined {
-  const positionNode = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === local,
-  );
-  if (!positionNode) return undefined;
-  const raw = positionNode.attributes["w:val"] ?? positionNode.attributes.val;
-  const value = Number.parseInt(raw ?? "", 10);
-  return Number.isFinite(value) && value > 0 ? value : 0;
-}
-
-function readTableRowWidth(
-  node: XmlElementNode,
-  local: "wBefore" | "wAfter",
-): TableWidth | undefined {
-  const widthNode = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === local,
-  );
-  if (!widthNode) return undefined;
-  const rawValue = widthNode.attributes["w:w"] ?? widthNode.attributes.w;
-  const value = Number.parseInt(rawValue ?? "", 10);
-  if (!Number.isFinite(value)) {
-    return undefined;
-  }
-  const rawType = (widthNode.attributes["w:type"] ?? widthNode.attributes.type ?? "dxa").toLowerCase();
-  const type: TableWidth["type"] =
-    rawType === "auto" ? "auto" : rawType === "pct" ? "pct" : rawType === "nil" ? "nil" : "dxa";
-  return { value, type };
-}
-
-function readCellGridSpan(node: XmlElementNode): number | undefined {
-  const gridSpanNode = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "gridSpan",
-  );
-  if (!gridSpanNode) return undefined;
-  const raw = gridSpanNode.attributes["w:val"] ?? gridSpanNode.attributes.val;
-  const value = Number.parseInt(raw ?? "0", 10);
-  return Number.isFinite(value) && value > 1 ? value : undefined;
-}
-
-function readCellVerticalMerge(node: XmlElementNode): "restart" | "continue" | undefined {
-  const vMergeNode = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "vMerge",
-  );
-  if (!vMergeNode) return undefined;
-  const raw = (vMergeNode.attributes["w:val"] ?? vMergeNode.attributes.val ?? "continue").toLowerCase();
-  return raw === "restart" ? "restart" : "continue";
-}
-
-function readParagraphAlignment(node: XmlElementNode): ParsedParagraphNode["alignment"] {
-  const jcNode = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "jc",
-  );
-  if (!jcNode) return undefined;
-  const val = (jcNode.attributes["w:val"] ?? jcNode.attributes.val ?? "").toLowerCase();
-  if (val === "left" || val === "center" || val === "right" || val === "both" || val === "distribute") {
-    return val;
-  }
-  return undefined;
-}
-
-function readParagraphSpacing(node: XmlElementNode): ParagraphSpacing | undefined {
-  const spacingNode = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "spacing",
-  );
-  if (!spacingNode) return undefined;
-
-  const spacing: ParagraphSpacing = {};
-  const before = spacingNode.attributes["w:before"] ?? spacingNode.attributes.before;
-  const after = spacingNode.attributes["w:after"] ?? spacingNode.attributes.after;
-  const line = spacingNode.attributes["w:line"] ?? spacingNode.attributes.line;
-  const lineRule = spacingNode.attributes["w:lineRule"] ?? spacingNode.attributes.lineRule;
-
-  if (before !== undefined) {
-    const v = Number.parseInt(before, 10);
-    if (Number.isFinite(v)) spacing.before = v;
-  }
-  if (after !== undefined) {
-    const v = Number.parseInt(after, 10);
-    if (Number.isFinite(v)) spacing.after = v;
-  }
-  if (line !== undefined) {
-    const v = Number.parseInt(line, 10);
-    if (Number.isFinite(v)) spacing.line = v;
-  }
-  if (lineRule !== undefined) {
-    const lr = lineRule.toLowerCase();
-    if (lr === "auto" || lr === "exact") {
-      spacing.lineRule = lr;
-    } else if (lr === "atleast") {
-      spacing.lineRule = "atLeast";
-    }
-  }
-
-  if (
-    spacing.before === undefined &&
-    spacing.after === undefined &&
-    spacing.line === undefined &&
-    spacing.lineRule === undefined
-  ) {
-    return undefined;
-  }
-  return spacing;
-}
-
-function readParagraphIndentation(node: XmlElementNode): ParagraphIndentation | undefined {
-  const indNode = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "ind",
-  );
-  if (!indNode) return undefined;
-
-  const indentation: ParagraphIndentation = {};
-  const left = indNode.attributes["w:left"] ?? indNode.attributes.left;
-  const right = indNode.attributes["w:right"] ?? indNode.attributes.right;
-  const firstLine = indNode.attributes["w:firstLine"] ?? indNode.attributes.firstLine;
-  const hanging = indNode.attributes["w:hanging"] ?? indNode.attributes.hanging;
-
-  if (left !== undefined) {
-    const v = Number.parseInt(left, 10);
-    if (Number.isFinite(v)) indentation.left = v;
-  }
-  if (right !== undefined) {
-    const v = Number.parseInt(right, 10);
-    if (Number.isFinite(v)) indentation.right = v;
-  }
-  if (firstLine !== undefined) {
-    const v = Number.parseInt(firstLine, 10);
-    if (Number.isFinite(v)) indentation.firstLine = v;
-  }
-  if (hanging !== undefined) {
-    const v = Number.parseInt(hanging, 10);
-    if (Number.isFinite(v)) indentation.hanging = v;
-  }
-
-  if (
-    indentation.left === undefined &&
-    indentation.right === undefined &&
-    indentation.firstLine === undefined &&
-    indentation.hanging === undefined
-  ) {
-    return undefined;
-  }
-  return indentation;
-}
-
-function readParagraphTabStops(node: XmlElementNode): TabStop[] | undefined {
-  const tabsNode = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "tabs",
-  );
-  if (!tabsNode) return undefined;
-
-  const tabStops: TabStop[] = [];
-  for (const child of tabsNode.children) {
-    if (child.type !== "element" || localName(child.name) !== "tab") continue;
-    const pos = child.attributes["w:pos"] ?? child.attributes.pos;
-    const val = (child.attributes["w:val"] ?? child.attributes.val ?? "left").toLowerCase();
-    const leader = (child.attributes["w:leader"] ?? child.attributes.leader ?? "none").toLowerCase();
-
-    if (pos === undefined) continue;
-    const position = Number.parseInt(pos, 10);
-    if (!Number.isFinite(position)) continue;
-
-    const align = (["left", "center", "right", "decimal", "bar", "clear"] as const).includes(
-      val as "left" | "center" | "right" | "decimal" | "bar" | "clear",
-    )
-      ? (val as TabStop["align"])
-      : "left";
-
-    const leaderValue =
-      leader === "none" ||
-      leader === "dot" ||
-      leader === "hyphen" ||
-      leader === "underscore" ||
-      leader === "heavy"
-        ? (leader as Exclude<TabStop["leader"], "middleDot">)
-        : leader === "middledot"
-          ? "middleDot"
-          : undefined;
-
-    tabStops.push({
-      position,
-      align,
-      ...(leaderValue && leaderValue !== "none" ? { leader: leaderValue } : {}),
-    });
-  }
-
-  return tabStops.length > 0 ? tabStops : undefined;
-}
-
-function readOnOffParagraphProperty(node: XmlElementNode, name: string): boolean | undefined {
-  const propNode = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === name,
-  );
-  if (!propNode) return undefined;
-  const val = (propNode.attributes["w:val"] ?? propNode.attributes.val ?? "true").toLowerCase();
-  return val !== "false" && val !== "0" && val !== "off" ? true : undefined;
-}
-
-function readOptionalOnOffParagraphProperty(
-  node: XmlElementNode,
-  name: string,
-): boolean | undefined {
-  const propNode = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === name,
-  );
-  if (!propNode) return undefined;
-  const val = (propNode.attributes["w:val"] ?? propNode.attributes.val ?? "true").toLowerCase();
-  return val !== "false" && val !== "0" && val !== "off";
-}
-
-function readParagraphOutlineLevel(node: XmlElementNode): number | undefined {
-  const propNode = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "outlineLvl",
-  );
-  if (!propNode) return undefined;
-  const val = propNode.attributes["w:val"] ?? propNode.attributes.val;
-  if (val === undefined) return undefined;
-  const level = Number.parseInt(val, 10);
-  return Number.isFinite(level) ? level : undefined;
-}
-
-function readParagraphBorders(node: XmlElementNode): ParagraphBorders | undefined {
-  const borderContainer = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "pBdr",
-  );
-  if (!borderContainer) {
-    return undefined;
-  }
-
-  const borders: ParagraphBorders = {};
-  for (const [name, key] of [
-    ["top", "top"],
-    ["left", "left"],
-    ["bottom", "bottom"],
-    ["right", "right"],
-    ["bar", "bar"],
-    ["between", "between"],
-  ] as const) {
-    const borderNode = borderContainer.children.find(
-      (child): child is XmlElementNode => child.type === "element" && localName(child.name) === name,
-    );
-    if (borderNode) {
-      const border = readBorder(borderNode);
-      if (border) {
-        borders[key] = border;
-      }
-    }
-  }
-
-  return Object.keys(borders).length > 0 ? borders : undefined;
-}
-
-function readParagraphShading(node: XmlElementNode): ParagraphShading | undefined {
-  const shadingNode = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "shd",
-  );
-  if (!shadingNode) {
-    return undefined;
-  }
-
-  const shading: ParagraphShading = {};
-  const fill = shadingNode.attributes["w:fill"] ?? shadingNode.attributes.fill;
-  const color = shadingNode.attributes["w:color"] ?? shadingNode.attributes.color;
-  const val = shadingNode.attributes["w:val"] ?? shadingNode.attributes.val;
-  if (fill) shading.fill = fill;
-  if (color) shading.color = color;
-  if (val) shading.val = val;
-  return Object.keys(shading).length > 0 ? shading : undefined;
-}
-
-function readParagraphCnfStyle(node: XmlElementNode): string | undefined {
-  const cnfStyleNode = node.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "cnfStyle",
-  );
-  return cnfStyleNode?.attributes["w:val"] ?? cnfStyleNode?.attributes.val;
-}
-
-function readBorder(node: XmlElementNode): ParagraphBorders[keyof ParagraphBorders] {
-  const border: NonNullable<ParagraphBorders[keyof ParagraphBorders]> = {};
-  const value = node.attributes["w:val"] ?? node.attributes.val;
-  const size = node.attributes["w:sz"] ?? node.attributes.sz;
-  const space = node.attributes["w:space"] ?? node.attributes.space;
-  const color = node.attributes["w:color"] ?? node.attributes.color;
-  if (value) border.value = value;
-  if (size !== undefined) {
-    const parsedSize = Number.parseInt(size, 10);
-    if (Number.isFinite(parsedSize)) border.size = parsedSize;
-  }
-  if (space !== undefined) {
-    const parsedSpace = Number.parseInt(space, 10);
-    if (Number.isFinite(parsedSpace)) border.space = parsedSpace;
-  }
-  if (color) border.color = color;
-  return Object.keys(border).length > 0 ? border : undefined;
-}
-
-function readParagraphStyleId(node: XmlElementNode): string | undefined {
-  for (const child of node.children) {
-    if (child.type !== "element" || localName(child.name) !== "pStyle") {
-      continue;
-    }
-
-    const styleId = child.attributes["w:val"] ?? child.attributes.val;
-    if (styleId) {
-      return styleId;
-    }
-  }
-
-  return undefined;
-}
-
-function readParagraphNumbering(
-  node: XmlElementNode,
-): ParsedParagraphNode["numbering"] | undefined {
-  const numberingProperties = node.children.find(
-    (child): child is XmlElementNode =>
-      child.type === "element" && localName(child.name) === "numPr",
-  );
-  if (!numberingProperties) {
-    return undefined;
-  }
-
-  const levelNode = numberingProperties.children.find(
-    (child): child is XmlElementNode =>
-      child.type === "element" && localName(child.name) === "ilvl",
-  );
-  const instanceNode = numberingProperties.children.find(
-    (child): child is XmlElementNode =>
-      child.type === "element" && localName(child.name) === "numId",
-  );
-  const rawLevel = levelNode?.attributes["w:val"] ?? levelNode?.attributes.val;
-  const rawInstanceId = instanceNode?.attributes["w:val"] ?? instanceNode?.attributes.val;
-  if (!rawInstanceId || rawLevel === undefined || !/^-?\d+$/.test(rawLevel)) {
-    return undefined;
-  }
-
-  return {
-    numberingInstanceId: toCanonicalNumberingInstanceId(rawInstanceId),
-    level: Number.parseInt(rawLevel, 10),
-  };
-}
-
-function parseRun(
-  node: XmlElementNode,
-  sourceXml: string,
-  relationships: readonly OpcRelationship[],
-  mediaParts: ReadonlyMap<string, InlineMediaPart>,
-  sourcePartPath: string,
-): ParsedInlineNode[] {
-  const marksResult = readRunMarks(node, sourceXml);
-  if (!marksResult.supported) {
-    return [
-      {
-        type: "opaque_inline",
-        rawXml: sourceXml.slice(node.start, node.end),
-      },
-    ];
-  }
-
-  const marks = marksResult.marks;
-  const result: ParsedInlineNode[] = [];
-  let encounteredUnsupportedChild = false;
-
-  for (const child of node.children) {
-    if (child.type !== "element") {
-      continue;
-    }
-
-    switch (localName(child.name)) {
-      case "rPr":
-        break;
-      case "t": {
-        const text = child.children
-          .filter((entry): entry is XmlTextNode => entry.type === "text")
-          .map((entry) => entry.text)
-          .join("");
-        result.push({
-          type: "text",
-          text,
-          ...(marks.length > 0 ? { marks } : {}),
-        });
-        break;
-      }
-      case "tab":
-        result.push({ type: "tab" });
-        break;
-      case "sym": {
-        const symbol = parseSymbolNode(child, marks);
-        if (!symbol) {
-          encounteredUnsupportedChild = true;
-          result.push({
-            type: "opaque_inline",
-            rawXml: sourceXml.slice(child.start, child.end),
-          });
-          break;
-        }
-        result.push(symbol);
-        break;
-      }
-      case "br":
-        if (isColumnBreak(child)) {
-          result.push({ type: "column_break" });
-        } else if (isSimpleLineBreak(child)) {
-          result.push({ type: "hard_break" });
-        } else {
-          result.push({
-            type: "opaque_inline",
-            rawXml: sourceXml.slice(child.start, child.end),
-          });
-        }
-        break;
-      case "drawing": {
-        const drawingXml = sourceXml.slice(child.start, child.end);
-
-        // Try complex content (charts / SmartArt) first
-        try {
-          const complexContent = parseComplexContentXml(
-            drawingXml,
-            relationships,
-            mediaParts,
-            sourcePartPath,
-          );
-          if (complexContent) {
-            result.push(complexContent);
-            break;
-          }
-        } catch {
-          // Fall through to shape / image parsing
-        }
-
-        // Try shape / WordArt parsing
-        try {
-          const shapeResult = parseShapeXml(drawingXml);
-          if (shapeResult) {
-            result.push(shapeResult);
-            break;
-          }
-        } catch {
-          // Fall through to image parsing
-        }
-
-        const parsedMedia = parseInlineMediaXml(
-          drawingXml,
-          relationships,
-          mediaParts,
-          sourcePartPath,
-        );
-        if (parsedMedia.length === 0) {
-          encounteredUnsupportedChild = true;
-          result.push({
-            type: "opaque_inline",
-            rawXml: sourceXml.slice(node.start, node.end),
-          });
-          break;
-        }
-
-        const semanticChildren = node.children.filter(
-          (entry): entry is XmlElementNode =>
-            entry.type === "element" && localName(entry.name) !== "rPr",
-        );
-        const placementXml =
-          semanticChildren.length === 1
-            ? sourceXml.slice(node.start, node.end)
-            : sourceXml.slice(child.start, child.end);
-
-        result.push(
-          ...parsedMedia.map((media) => ({
-            type: "image" as const,
-            mediaId: media.mediaId,
-            relationshipId: media.relationshipId,
-            packagePartName: media.packagePartName,
-            contentType: media.contentType,
-            filename: media.filename,
-            ...(media.altText ? { altText: media.altText } : {}),
-            ...(media.widthEmu !== undefined ? { widthEmu: media.widthEmu } : {}),
-            ...(media.heightEmu !== undefined ? { heightEmu: media.heightEmu } : {}),
-            placementXml,
-            ...(media.display ? { display: media.display } : {}),
-            ...(media.floating ? { floating: media.floating } : {}),
-          })),
-        );
-        break;
-      }
-      case "pict": {
-        const pictXml = sourceXml.slice(child.start, child.end);
-        try {
-          const vmlResult = parseVmlXml(pictXml);
-          if (vmlResult) {
-            // Use the full run XML as rawXml so the export serializer can emit
-            // the complete <w:r>...<w:pict>...</w:pict></w:r> wrapper
-            result.push({
-              ...vmlResult,
-              rawXml: sourceXml.slice(node.start, node.end),
-            });
-            break;
-          }
-        } catch {
-          // Fall through to opaque
-        }
-        encounteredUnsupportedChild = true;
-        result.push({
-          type: "opaque_inline",
-          rawXml: pictXml,
-        });
-        break;
-      }
-      case "commentReference":
-        break;
-      case "footnoteReference": {
-        const noteId = child.attributes["w:id"] ?? child.attributes.id ?? "";
-        if (noteId) {
-          result.push({
-            type: "footnote_ref",
-            noteId,
-            noteKind: "footnote",
-          });
-        }
-        break;
-      }
-      case "endnoteReference": {
-        const noteId = child.attributes["w:id"] ?? child.attributes.id ?? "";
-        if (noteId) {
-          result.push({
-            type: "footnote_ref",
-            noteId,
-            noteKind: "endnote",
-          });
-        }
-        break;
-      }
-      case "lastRenderedPageBreak":
-      case "proofErr":
-        result.push({
-          type: "opaque_inline",
-          rawXml: sourceXml.slice(child.start, child.end),
-        });
-        break;
-      default:
-        encounteredUnsupportedChild = true;
-        result.push({
-          type: "opaque_inline",
-          rawXml: sourceXml.slice(child.start, child.end),
-        });
-        break;
-    }
-  }
-
-  if (encounteredUnsupportedChild && result.every((child) => child.type === "opaque_inline")) {
-    return [
-      {
-        type: "opaque_inline",
-        rawXml: sourceXml.slice(node.start, node.end),
-      },
-    ];
-  }
-
-  return result;
-}
-
-function parseRevisionContainer(
-  node: XmlElementNode,
-  sourceXml: string,
-  relationshipMap: Map<string, OpcRelationship>,
-): ParsedInlineNode[] {
-  const result: ParsedInlineNode[] = [];
-  const allowsDeletedText = localName(node.name) === "del";
-
-  for (const child of node.children) {
-    if (child.type !== "element") {
-      continue;
-    }
-
-    switch (localName(child.name)) {
-      case "r": {
-        const run = parseRunContentOnly(child, sourceXml, {
-          allowDeletedText: allowsDeletedText,
-          preserveUnsupportedReviewMarkup: true,
-        });
-        if (!run.supported) {
-          return [
-            {
-              type: "opaque_inline",
-              rawXml: sourceXml.slice(node.start, node.end),
-            },
-          ];
-        }
-        result.push(...run.nodes);
-        break;
-      }
-      case "hyperlink": {
-        const hyperlink = parseHyperlink(child, sourceXml, relationshipMap, {
-          allowDeletedText: allowsDeletedText,
-          preserveUnsupportedReviewMarkup: true,
-        });
-        if (hyperlink.type === "opaque_inline") {
-          return [
-            {
-              type: "opaque_inline",
-              rawXml: sourceXml.slice(node.start, node.end),
-            },
-          ];
-        }
-        result.push(hyperlink);
-        break;
-      }
-      case "commentRangeStart":
-      case "commentRangeEnd":
-      case "bookmarkStart":
-      case "bookmarkEnd":
-      case "proofErr":
-      case "lastRenderedPageBreak":
-        return [
-          {
-            type: "opaque_inline",
-            rawXml: sourceXml.slice(node.start, node.end),
-          },
-        ];
-      case "permStart":
-        result.push(parsePermStartNode(child, sourceXml));
-        break;
-      case "permEnd":
-        result.push(parsePermEndNode(child, sourceXml));
-        break;
-      default:
-        return [
-          {
-            type: "opaque_inline",
-            rawXml: sourceXml.slice(node.start, node.end),
-          },
-        ];
-    }
-  }
-
-  return result;
-}
-
-function parseHyperlink(
-  node: XmlElementNode,
-  sourceXml: string,
-  relationshipMap: Map<string, OpcRelationship>,
-  options: {
-    allowDeletedText?: boolean;
-    preserveUnsupportedReviewMarkup?: boolean;
-  } = {},
-): ParsedHyperlinkNode | ParsedOpaqueInlineNode {
-  const relationshipId = node.attributes["r:id"] ?? node.attributes.id;
-  const anchor = node.attributes["w:anchor"] ?? node.attributes.anchor;
-  let href: string | undefined;
-
-  if (relationshipId) {
-    const relationship = relationshipMap.get(relationshipId);
-    if (
-      relationship &&
-      relationship.type === HYPERLINK_RELATIONSHIP_TYPE &&
-      relationship.targetMode === "external"
-    ) {
-      href = relationship.target;
-    }
-  } else if (anchor) {
-    href = `#${anchor}`;
-  }
-
-  if (!href) {
-    return {
-      type: "opaque_inline",
-      rawXml: sourceXml.slice(node.start, node.end),
-    };
-  }
-
-  const children: Array<ParsedTextNode | ParsedBreakNode | ParsedColumnBreakNode | ParsedTabNode | ParsedSymbolNode> = [];
-
-  for (const child of node.children) {
-    if (child.type !== "element") {
-      continue;
-    }
-
-    if (localName(child.name) !== "r") {
-      return {
-        type: "opaque_inline",
-        rawXml: sourceXml.slice(node.start, node.end),
-      };
-    }
-
-    const run = parseRunContentOnly(child, sourceXml, {
-      allowDeletedText: options.allowDeletedText,
-      preserveUnsupportedReviewMarkup: options.preserveUnsupportedReviewMarkup,
-    });
-    if (!run.supported) {
-      return {
-        type: "opaque_inline",
-        rawXml: sourceXml.slice(node.start, node.end),
-      };
-    }
-
-    children.push(...run.nodes);
-  }
-
-  return {
-    type: "hyperlink",
-    href,
-    children,
-    rawXml: sourceXml.slice(node.start, node.end),
-  };
-}
-
-function parseRunContentOnly(
-  node: XmlElementNode,
-  _sourceXml: string,
-  options: {
-    allowDeletedText?: boolean;
-    preserveUnsupportedReviewMarkup?: boolean;
-  } = {},
-): RunParseResult {
-  const marksResult = readRunMarks(node, _sourceXml);
-  if (!marksResult.supported) {
-    return { nodes: [], supported: false };
-  }
-
-  const marks = marksResult.marks;
-  const nodes: Array<ParsedTextNode | ParsedBreakNode | ParsedColumnBreakNode | ParsedTabNode | ParsedSymbolNode> = [];
-
-  for (const child of node.children) {
-    if (child.type !== "element") {
-      continue;
-    }
-
-    switch (localName(child.name)) {
-      case "rPr":
-        break;
-      case "t": {
-        const text = child.children
-          .filter((entry): entry is XmlTextNode => entry.type === "text")
-          .map((entry) => entry.text)
-          .join("");
-        nodes.push({
-          type: "text",
-          text,
-          ...(marks.length > 0 ? { marks } : {}),
-        });
-        break;
-      }
-      case "delText":
-      case "delInstrText":
-        if (!options.allowDeletedText) {
-          return { nodes: [], supported: false };
-        }
-        nodes.push({
-          type: "text",
-          text: child.children
-            .filter((entry): entry is XmlTextNode => entry.type === "text")
-            .map((entry) => entry.text)
-            .join(""),
-          ...(marks.length > 0 ? { marks } : {}),
-        });
-        break;
-      case "tab":
-        nodes.push({ type: "tab" });
-        break;
-      case "sym": {
-        const symbol = parseSymbolNode(child, marks);
-        if (!symbol) {
-          return { nodes: [], supported: false };
-        }
-        nodes.push(symbol);
-        break;
-      }
-      case "br":
-        if (isColumnBreak(child)) {
-          nodes.push({ type: "column_break" });
-          break;
-        }
-        if (!isSimpleLineBreak(child)) {
-          return { nodes: [], supported: false };
-        }
-        nodes.push({ type: "hard_break" });
-        break;
-      case "commentReference":
-      case "lastRenderedPageBreak":
-      case "proofErr":
-        if (options.preserveUnsupportedReviewMarkup) {
-          return { nodes: [], supported: false };
-        }
-        break;
-      default:
-        return { nodes: [], supported: false };
-    }
-  }
-
-  return { nodes, supported: true };
-}
-
-function readRunMarks(node: XmlElementNode, sourceXml: string): MarksParseResult {
-  const properties = node.children.find(
-    (child): child is XmlElementNode =>
-      child.type === "element" && localName(child.name) === "rPr",
-  );
-
-  if (!properties) {
-    return { marks: [], supported: true };
-  }
-
-  if (
-    properties.children.some(
-      (child) =>
-        child.type === "element" &&
-        DISALLOWED_RUN_PROPERTY_NAMES.has(localName(child.name)),
-    )
-  ) {
-    return {
-      marks: [],
-      supported: false,
-    };
-  }
-
-  const marks: TextMark[] = [];
-  if (hasOnOffProperty(properties, "b")) {
-    marks.push({ type: "bold" });
-  }
-  if (hasOnOffProperty(properties, "i")) {
-    marks.push({ type: "italic" });
-  }
-  if (hasUnderlineProperty(properties)) {
-    marks.push({ type: "underline" });
-  }
-  if (hasOnOffProperty(properties, "strike")) {
-    marks.push({ type: "strikethrough" });
-  }
-  if (hasOnOffProperty(properties, "dstrike")) {
-    marks.push({ type: "doubleStrikethrough" });
-  }
-  if (hasOnOffProperty(properties, "vanish")) {
-    marks.push({ type: "vanish" });
-  }
-
-  const langMark = readRunLang(properties);
-  if (langMark) {
-    marks.push(langMark);
-  }
-
-  const backgroundColorMark = readRunBackgroundColor(properties);
-  if (backgroundColorMark) {
-    marks.push(backgroundColorMark);
-  }
-
-  const highlightMark = readRunHighlight(properties);
-  if (highlightMark) {
-    marks.push(highlightMark);
-  }
-
-  const charSpacingMark = readNumericRunMark(properties, "spacing", "charSpacing");
-  if (charSpacingMark) {
-    marks.push(charSpacingMark);
-  }
-
-  const kerningMark = readNumericRunMark(properties, "kern", "kerning");
-  if (kerningMark) {
-    marks.push(kerningMark);
-  }
-
-  const positionMark = readNumericRunMark(properties, "position", "position");
-  if (positionMark) {
-    marks.push(positionMark);
-  }
-
-  if (hasOnOffProperty(properties, "emboss")) {
-    marks.push({ type: "emboss" });
-  }
-  if (hasOnOffProperty(properties, "imprint")) {
-    marks.push({ type: "imprint" });
-  }
-  if (hasOnOffProperty(properties, "shadow")) {
-    marks.push({ type: "shadow" });
-  }
-
-  const textFillMark = readRunTextFill(properties, sourceXml);
-  if (textFillMark) {
-    marks.push(textFillMark);
-  }
-
-  // Font family
-  const rFontsNode = properties.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "rFonts",
-  );
-  if (rFontsNode) {
-    const family = rFontsNode.attributes["w:ascii"] ?? rFontsNode.attributes["w:hAnsi"] ?? rFontsNode.attributes.ascii ?? rFontsNode.attributes.hAnsi;
-    if (family) {
-      marks.push({ type: "fontFamily", val: family });
-    }
-  }
-
-  // Font size (half-points)
-  const szNode = properties.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "sz",
-  );
-  if (szNode) {
-    const szVal = szNode.attributes["w:val"] ?? szNode.attributes.val;
-    if (szVal) {
-      const size = Number.parseInt(szVal, 10);
-      if (Number.isFinite(size) && size > 0) {
-        marks.push({ type: "fontSize", val: size });
-      }
-    }
-  }
-
-  // Text color
-  const colorNode = properties.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "color",
-  );
-  if (colorNode) {
-    const colorVal = colorNode.attributes["w:val"] ?? colorNode.attributes.val;
-    if (colorVal && colorVal !== "auto") {
-      marks.push({ type: "textColor", color: colorVal });
-    }
-  }
-
-  // Small caps
-  if (hasOnOffProperty(properties, "smallCaps")) {
-    marks.push({ type: "smallCaps" });
-  }
-
-  // All caps
-  if (hasOnOffProperty(properties, "caps")) {
-    marks.push({ type: "allCaps" });
-  }
-
-  return {
-    marks,
-    supported: true,
-  };
-}
-
-function readRunLang(properties: XmlElementNode): TextMark | undefined {
-  const langNode = properties.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "lang",
-  );
-  if (!langNode) return undefined;
-  const val =
-    langNode.attributes["w:val"] ??
-    langNode.attributes.val ??
-    langNode.attributes["w:bidi"] ??
-    langNode.attributes.bidi;
-  if (!val) return undefined;
-  return { type: "lang", val };
-}
-
-function readRunBackgroundColor(properties: XmlElementNode): TextMark | undefined {
-  const shadingNode = properties.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "shd",
-  );
-  if (!shadingNode) {
-    return undefined;
-  }
-
-  const fill = shadingNode.attributes["w:fill"] ?? shadingNode.attributes.fill;
-  if (!fill || fill === "auto") {
-    return undefined;
-  }
-
-  return { type: "backgroundColor", color: fill };
-}
-
-function readRunHighlight(properties: XmlElementNode): TextMark | undefined {
-  const highlightNode = properties.children.find(
-    (child): child is XmlElementNode =>
-      child.type === "element" && localName(child.name) === "highlight",
-  );
-  if (!highlightNode) {
-    return undefined;
-  }
-
-  const highlightValue = highlightNode.attributes["w:val"] ?? highlightNode.attributes.val;
-  const resolvedHighlight = resolveHighlightColor(highlightValue);
-  if (!resolvedHighlight) {
-    return undefined;
-  }
-
-  return {
-    type: "highlight",
-    color: resolvedHighlight.color,
-    val: resolvedHighlight.val,
-  };
-}
-
-function readNumericRunMark(
-  properties: XmlElementNode,
-  elementName: "spacing" | "kern" | "position",
-  markType: "charSpacing" | "kerning" | "position",
-): TextMark | undefined {
-  const propertyNode = properties.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === elementName,
-  );
-  if (!propertyNode) {
-    return undefined;
-  }
-  const rawValue = propertyNode.attributes["w:val"] ?? propertyNode.attributes.val;
-  if (rawValue === undefined) {
-    return undefined;
-  }
-  const value = Number.parseInt(rawValue, 10);
-  if (!Number.isFinite(value)) {
-    return undefined;
-  }
-  return { type: markType, val: value };
-}
-
-function readRunTextFill(properties: XmlElementNode, sourceXml: string): TextMark | undefined {
-  const textFillNode = properties.children.find(
-    (child): child is XmlElementNode => child.type === "element" && localName(child.name) === "textFill",
-  );
-  if (!textFillNode) {
-    return undefined;
-  }
-  return {
-    type: "textFill",
-    xml: sourceXml.slice(textFillNode.start, textFillNode.end),
-  };
-}
-
-function parseSymbolNode(
-  node: XmlElementNode,
-  marks: TextMark[],
-): ParsedSymbolNode | undefined {
-  const char = node.attributes["w:char"] ?? node.attributes.char;
-  if (!char) {
-    return undefined;
-  }
-  const font = node.attributes["w:font"] ?? node.attributes.font;
-  return {
-    type: "symbol",
-    char,
-    ...(font ? { font } : {}),
-    ...(marks.length > 0 ? { marks } : {}),
-  };
-}
-
-function supportsParagraphProperties(node: XmlElementNode): boolean {
-  for (const child of node.children) {
-    if (child.type !== "element") {
-      continue;
-    }
-
-    const name = localName(child.name);
-    if (name === "pPrChange") {
-      return false;
-    }
-
-    if (name === "rPr") {
-      if (
-        child.children.some(
-          (entry) =>
-            entry.type === "element" &&
-            DISALLOWED_PARAGRAPH_PROPERTY_NAMES.has(localName(entry.name)),
-        )
-      ) {
-        return false;
-      }
-    }
-  }
-
-  return true;
-}
-
-const DISALLOWED_RUN_PROPERTY_NAMES = new Set(["rPrChange"]);
-const DISALLOWED_PARAGRAPH_PROPERTY_NAMES = new Set(["pPrChange", "rPrChange"]);
-
-function hasOnOffProperty(properties: XmlElementNode, propertyName: string): boolean {
-  const property = properties.children.find(
-    (child): child is XmlElementNode =>
-      child.type === "element" && localName(child.name) === propertyName,
-  );
-  if (!property) {
-    return false;
-  }
-
-  const value = (property.attributes["w:val"] ?? property.attributes.val ?? "true").toLowerCase();
-  return value !== "false" && value !== "0" && value !== "off";
-}
-
-function hasUnderlineProperty(properties: XmlElementNode): boolean {
-  const property = properties.children.find(
-    (child): child is XmlElementNode =>
-      child.type === "element" && localName(child.name) === "u",
-  );
-  if (!property) {
-    return false;
-  }
-
-  const value = (property.attributes["w:val"] ?? property.attributes.val ?? "single").toLowerCase();
-  return value !== "none";
-}
-
-function isSimpleLineBreak(node: XmlElementNode): boolean {
-  const value = (node.attributes["w:type"] ?? node.attributes.type ?? "textWrapping").toLowerCase();
-  return value === "textwrapping" || value === "line";
-}
-
-function isColumnBreak(node: XmlElementNode): boolean {
-  const value = (node.attributes["w:type"] ?? node.attributes.type ?? "").toLowerCase();
-  return value === "column";
-}
-
-function findChildElement(node: XmlElementNode, childLocalName: string): XmlElementNode {
-  const child = node.children.find(
-    (entry): entry is XmlElementNode =>
-      entry.type === "element" && localName(entry.name) === childLocalName,
-  );
-
-  if (!child) {
-    throw new Error(`Expected <${childLocalName}> element in main document XML.`);
-  }
-
-  return child;
-}
-
-function localName(name: string): string {
-  const separatorIndex = name.indexOf(":");
-  return separatorIndex >= 0 ? name.slice(separatorIndex + 1) : name;
-}
-
-function readOptionalAttribute(node: XmlElementNode, name: string): string | undefined {
-  return node.attributes[`w:${name}`]
-    ?? node.attributes[`r:${name}`]
-    ?? node.attributes[name];
-}
-
-function parseXml(xml: string): XmlElementNode {
-  const root: XmlElementNode = {
-    type: "element",
-    name: "__root__",
-    attributes: {},
-    children: [],
-    start: 0,
-    end: xml.length,
-  };
-  const stack: XmlElementNode[] = [root];
-  let cursor = 0;
-
-  while (cursor < xml.length) {
-    if (xml.startsWith("<!--", cursor)) {
-      const end = xml.indexOf("-->", cursor);
-      cursor = end >= 0 ? end + 3 : xml.length;
-      continue;
-    }
-
-    if (xml.startsWith("<?", cursor)) {
-      const end = xml.indexOf("?>", cursor);
-      cursor = end >= 0 ? end + 2 : xml.length;
-      continue;
-    }
-
-    if (xml.startsWith("<![CDATA[", cursor)) {
-      const end = xml.indexOf("]]>", cursor);
-      const textEnd = end >= 0 ? end : xml.length;
-      stack[stack.length - 1]?.children.push({
-        type: "text",
-        text: xml.slice(cursor + 9, textEnd),
-        start: cursor,
-        end: end >= 0 ? end + 3 : xml.length,
-      });
-      cursor = end >= 0 ? end + 3 : xml.length;
-      continue;
-    }
-
-    const currentChar = xml[cursor];
-    if (currentChar !== "<") {
-      const nextTag = xml.indexOf("<", cursor);
-      const end = nextTag >= 0 ? nextTag : xml.length;
-      const text = decodeXmlEntities(xml.slice(cursor, end));
-      if (text.length > 0) {
-        stack[stack.length - 1]?.children.push({
-          type: "text",
-          text,
-          start: cursor,
-          end,
-        });
-      }
-      cursor = end;
-      continue;
-    }
-
-    if (xml[cursor + 1] === "/") {
-      const end = xml.indexOf(">", cursor);
-      if (end < 0) {
-        throw new Error("Malformed XML: missing closing >.");
-      }
-
-      const name = xml.slice(cursor + 2, end).trim();
-      const current = stack.pop();
-      if (!current || localName(current.name) !== localName(name)) {
-        throw new Error(`Malformed XML: unexpected closing tag </${name}>.`);
-      }
-      current.end = end + 1;
-      cursor = end + 1;
-      continue;
-    }
-
-    const tagEnd = findTagEnd(xml, cursor);
-    const tagBody = xml.slice(cursor + 1, tagEnd);
-    const selfClosing = /\/\s*$/.test(tagBody);
-    const { name, attributes } = parseTag(tagBody.replace(/\/\s*$/, "").trim());
-    const element: XmlElementNode = {
-      type: "element",
-      name,
-      attributes,
-      children: [],
-      start: cursor,
-      end: tagEnd + 1,
-    };
-    stack[stack.length - 1]?.children.push(element);
-
-    if (!selfClosing) {
-      stack.push(element);
-    }
-
-    cursor = tagEnd + 1;
-  }
-
-  if (stack.length !== 1) {
-    throw new Error("Malformed XML: unclosed element in main document XML.");
-  }
-
-  return root;
-}
-
-function parseTag(tagBody: string): { name: string; attributes: Record<string, string> } {
-  let cursor = 0;
-  while (cursor < tagBody.length && /\s/.test(tagBody[cursor] ?? "")) {
-    cursor += 1;
-  }
-
-  const nameStart = cursor;
-  while (cursor < tagBody.length && !/\s/.test(tagBody[cursor] ?? "")) {
-    cursor += 1;
-  }
-  const name = tagBody.slice(nameStart, cursor);
-  const attributes: Record<string, string> = {};
-
-  while (cursor < tagBody.length) {
-    while (cursor < tagBody.length && /\s/.test(tagBody[cursor] ?? "")) {
-      cursor += 1;
-    }
-    if (cursor >= tagBody.length) {
-      break;
-    }
-
-    const keyStart = cursor;
-    while (cursor < tagBody.length && !/[\s=]/.test(tagBody[cursor] ?? "")) {
-      cursor += 1;
-    }
-    const key = tagBody.slice(keyStart, cursor);
-
-    while (cursor < tagBody.length && /\s/.test(tagBody[cursor] ?? "")) {
-      cursor += 1;
-    }
-
-    if (tagBody[cursor] !== "=") {
-      attributes[key] = "";
-      continue;
-    }
-    cursor += 1;
-
-    while (cursor < tagBody.length && /\s/.test(tagBody[cursor] ?? "")) {
-      cursor += 1;
-    }
-
-    const quote = tagBody[cursor];
-    if (quote !== `"` && quote !== `'`) {
-      throw new Error(`Malformed XML attribute ${key}.`);
-    }
-    cursor += 1;
-
-    const valueStart = cursor;
-    while (cursor < tagBody.length && tagBody[cursor] !== quote) {
-      cursor += 1;
-    }
-    const rawValue = tagBody.slice(valueStart, cursor);
-    attributes[key] = decodeXmlEntities(rawValue);
-    cursor += 1;
-  }
-
-  return { name, attributes };
-}
-
-function findTagEnd(xml: string, start: number): number {
-  let cursor = start + 1;
-  let quote: string | null = null;
-
-  while (cursor < xml.length) {
-    const current = xml[cursor];
-    if (quote) {
-      if (current === quote) {
-        quote = null;
-      }
-      cursor += 1;
-      continue;
-    }
-
-    if (current === `"` || current === `'`) {
-      quote = current;
-      cursor += 1;
-      continue;
-    }
-
-    if (current === ">") {
-      return cursor;
-    }
-
-    cursor += 1;
-  }
-
-  throw new Error("Malformed XML: missing >.");
-}
-
-function decodeXmlEntities(value: string): string {
-  return value.replace(/&(#x[0-9a-fA-F]+|#\d+|amp|lt|gt|quot|apos);/g, (match, entity) => {
-    switch (entity) {
-      case "amp":
-        return "&";
-      case "lt":
-        return "<";
-      case "gt":
-        return ">";
-      case "quot":
-        return `"`;
-      case "apos":
-        return "'";
-      default:
-        if (entity.startsWith("#x")) {
-          return String.fromCodePoint(Number.parseInt(entity.slice(2), 16));
-        }
-        if (entity.startsWith("#")) {
-          return String.fromCodePoint(Number.parseInt(entity.slice(1), 10));
-        }
-        return match;
-    }
-  });
-}
-
-// ---- Section properties parsing ----
-
-function parseSectionBreakElement(
-  node: XmlElementNode,
-  sourceXml: string,
-): ParsedSectionBreakNode {
-  const props = parseSectionPropertiesFromElement(node);
-  return {
-    type: "section_break",
-    sectionPropertiesXml: sourceXml.slice(node.start, node.end),
-    sectionProperties: props,
-  };
-}
-
-function readSectionPropertiesFromPPr(
-  pPrNode: XmlElementNode,
-): SectionProperties | undefined {
-  for (const child of pPrNode.children) {
-    if (child.type === "element" && localName(child.name) === "sectPr") {
-      return parseSectionPropertiesFromElement(child);
-    }
-  }
-  return undefined;
-}
-
-function readSectionPropertiesXmlFromPPr(
-  pPrNode: XmlElementNode,
-  sourceXml: string,
-): string | undefined {
-  for (const child of pPrNode.children) {
-    if (child.type === "element" && localName(child.name) === "sectPr") {
-      return sourceXml.slice(child.start, child.end);
-    }
-  }
-  return undefined;
-}
-
-export function parseSectionPropertiesFromElement(
-  node: XmlElementNode,
-): SectionProperties {
-  const props: SectionProperties = {};
-
-  for (const child of node.children) {
-    if (child.type !== "element") continue;
-    const name = localName(child.name);
-
-    switch (name) {
-      case "pgSz": {
-        const w = safeParseInt(child.attributes["w:w"]);
-        const h = safeParseInt(child.attributes["w:h"]);
-        if (w !== undefined && h !== undefined) {
-          const pageSize: PageSize = { width: w, height: h };
-          const orient = child.attributes["w:orient"];
-          if (orient === "landscape" || orient === "portrait") {
-            pageSize.orientation = orient;
-          }
-          props.pageSize = pageSize;
-        }
-        break;
-      }
-      case "pgMar": {
-        const top = safeParseInt(child.attributes["w:top"]);
-        const right = safeParseInt(child.attributes["w:right"]);
-        const bottom = safeParseInt(child.attributes["w:bottom"]);
-        const left = safeParseInt(child.attributes["w:left"]);
-        if (top !== undefined && right !== undefined && bottom !== undefined && left !== undefined) {
-          const margins: PageMargins = { top, right, bottom, left };
-          const header = safeParseInt(child.attributes["w:header"]);
-          const footer = safeParseInt(child.attributes["w:footer"]);
-          const gutter = safeParseInt(child.attributes["w:gutter"]);
-          if (header !== undefined) margins.header = header;
-          if (footer !== undefined) margins.footer = footer;
-          if (gutter !== undefined) margins.gutter = gutter;
-          props.pageMargins = margins;
-        }
-        break;
-      }
-      case "cols": {
-        const columns: ColumnProperties = {};
-        const num = safeParseInt(child.attributes["w:num"]);
-        const space = safeParseInt(child.attributes["w:space"]);
-        const equalWidth = child.attributes["w:equalWidth"];
-        const sep = child.attributes["w:sep"];
-        if (num !== undefined) columns.count = num;
-        if (space !== undefined) columns.space = space;
-        if (equalWidth !== undefined) columns.equalWidth = equalWidth !== "0" && equalWidth !== "false";
-        if (sep === "1" || sep === "true") columns.separator = true;
-        const colDefs: Array<{ width: number; space?: number }> = [];
-        for (const colChild of child.children) {
-          if (colChild.type === "element" && localName(colChild.name) === "col") {
-            const colW = safeParseInt(colChild.attributes["w:w"]);
-            const colSpace = safeParseInt(colChild.attributes["w:space"]);
-            if (colW !== undefined) {
-              colDefs.push(colSpace !== undefined ? { width: colW, space: colSpace } : { width: colW });
-            }
-          }
-        }
-        if (colDefs.length > 0) columns.columns = colDefs;
-        if (Object.keys(columns).length > 0) props.columns = columns;
-        break;
-      }
-      case "pgNumType": {
-        const numbering: PageNumbering = {};
-        const fmt = child.attributes["w:fmt"];
-        const start = safeParseInt(child.attributes["w:start"]);
-        const chapStyle = child.attributes["w:chapStyle"];
-        const chapSep = child.attributes["w:chapSep"];
-        if (fmt) numbering.format = fmt;
-        if (start !== undefined) numbering.start = start;
-        if (chapStyle) numbering.chapStyle = chapStyle;
-        if (chapSep) numbering.chapSep = chapSep;
-        if (Object.keys(numbering).length > 0) props.pageNumbering = numbering;
-        break;
-      }
-      case "lnNumType": {
-        const lineNumbering: SectionLineNumbering = {};
-        const countBy = safeParseInt(child.attributes["w:countBy"]);
-        const start = safeParseInt(child.attributes["w:start"]);
-        const distance = safeParseInt(child.attributes["w:distance"]);
-        const restart = child.attributes["w:restart"];
-        if (countBy !== undefined) lineNumbering.countBy = countBy;
-        if (start !== undefined) lineNumbering.start = start;
-        if (distance !== undefined) lineNumbering.distance = distance;
-        if (
-          restart === "newPage" ||
-          restart === "newSection" ||
-          restart === "continuous"
-        ) {
-          lineNumbering.restart = restart;
-        }
-        if (Object.keys(lineNumbering).length > 0) {
-          props.lineNumbering = lineNumbering;
-        }
-        break;
-      }
-      case "pgBorders": {
-        const pageBorders: SectionPageBorders = {};
-        const offsetFrom = child.attributes["w:offsetFrom"];
-        const display = child.attributes["w:display"];
-        const zOrder = child.attributes["w:zOrder"];
-        if (offsetFrom === "page" || offsetFrom === "text") {
-          pageBorders.offsetFrom = offsetFrom;
-        }
-        if (
-          display === "allPages" ||
-          display === "firstPage" ||
-          display === "notFirstPage"
-        ) {
-          pageBorders.display = display;
-        }
-        if (zOrder === "front" || zOrder === "back") {
-          pageBorders.zOrder = zOrder;
-        }
-        for (const borderChild of child.children) {
-          if (borderChild.type !== "element") continue;
-          const borderName = localName(borderChild.name);
-          const border = parseBorderSpec(borderChild);
-          if (!border) continue;
-          if (
-            borderName === "top" ||
-            borderName === "left" ||
-            borderName === "bottom" ||
-            borderName === "right"
-          ) {
-            pageBorders[borderName] = border;
-          }
-        }
-        if (Object.keys(pageBorders).length > 0) {
-          props.pageBorders = pageBorders;
-        }
-        break;
-      }
-      case "docGrid": {
-        const documentGrid: SectionDocumentGrid = {};
-        const type = child.attributes["w:type"];
-        const linePitch = safeParseInt(child.attributes["w:linePitch"]);
-        const charSpace = safeParseInt(child.attributes["w:charSpace"]);
-        if (
-          type === "default" ||
-          type === "lines" ||
-          type === "linesAndChars" ||
-          type === "snapToChars"
-        ) {
-          documentGrid.type = type;
-        }
-        if (linePitch !== undefined) documentGrid.linePitch = linePitch;
-        if (charSpace !== undefined) documentGrid.charSpace = charSpace;
-        if (Object.keys(documentGrid).length > 0) {
-          props.documentGrid = documentGrid;
-        }
-        break;
-      }
-      case "headerReference": {
-        const variant = child.attributes["w:type"] as HeaderFooterVariant | undefined;
-        const rId = child.attributes["r:id"];
-        if (variant && rId) {
-          if (!props.headerReferences) props.headerReferences = [];
-          props.headerReferences.push({ variant, relationshipId: rId });
-        }
-        break;
-      }
-      case "footerReference": {
-        const variant = child.attributes["w:type"] as HeaderFooterVariant | undefined;
-        const rId = child.attributes["r:id"];
-        if (variant && rId) {
-          if (!props.footerReferences) props.footerReferences = [];
-          props.footerReferences.push({ variant, relationshipId: rId });
-        }
-        break;
-      }
-      case "type": {
-        const val = child.attributes["w:val"];
-        if (val === "continuous" || val === "nextPage" || val === "evenPage" || val === "oddPage" || val === "nextColumn") {
-          props.sectionType = val;
-        }
-        break;
-      }
-      case "titlePg": {
-        const val = child.attributes["w:val"];
-        props.titlePage = val !== "false" && val !== "0";
-        break;
-      }
-    }
-  }
-
-  return props;
-}
-
-function safeParseInt(value: string | undefined): number | undefined {
-  if (value === undefined) return undefined;
-  const n = Number.parseInt(value, 10);
-  return Number.isFinite(n) ? n : undefined;
-}
-
-function parseBorderSpec(node: XmlElementNode): BorderSpec | undefined {
-  const border: BorderSpec = {};
-  const value = node.attributes["w:val"];
-  const size = safeParseInt(node.attributes["w:sz"]);
-  const space = safeParseInt(node.attributes["w:space"]);
-  const color = node.attributes["w:color"];
-
-  if (value) border.value = value;
-  if (size !== undefined) border.size = size;
-  if (space !== undefined) border.space = space;
-  if (color) border.color = color;
-
-  return Object.keys(border).length > 0 ? border : undefined;
-}
-
-function parsePermStartNode(
-  node: XmlElementNode,
-  sourceXml: string,
-): ParsedPermStartInlineNode {
-  const rangeId = node.attributes["w:id"] ?? node.attributes.id ?? "";
-  const edGrp = node.attributes["w:edGrp"] ?? node.attributes.edGrp;
-  const ed = node.attributes["w:ed"] ?? node.attributes.ed;
-  return {
-    type: "perm_start",
-    rangeId,
-    ...(edGrp ? { editorGroup: edGrp } : {}),
-    ...(ed ? { editor: ed } : {}),
-    rawXml: sourceXml.slice(node.start, node.end),
-  };
-}
-
-function parsePermEndNode(
-  node: XmlElementNode,
-  sourceXml: string,
-): ParsedPermEndInlineNode {
-  return {
-    type: "perm_end",
-    rangeId: node.attributes["w:id"] ?? node.attributes.id ?? "",
-    rawXml: sourceXml.slice(node.start, node.end),
-  };
-}