docxmlater 11.0.10 → 12.1.0

package/dist/esm/elements/FieldHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"FieldHelpers.js","sourceRoot":"","sources":["../../../src/elements/FieldHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Helper functions for creating complex and nested fields\n */\n\nimport { ComplexField } from './Field.js';\nimport { defaultLogger } from '../utils/logger.js';\n\n/**\n * Parsed components of a HYPERLINK field instruction\n */\nexport interface ParsedHyperlinkInstruction {\n  /** Base URL (with encoded characters decoded) */\n  url: string;\n  /** Anchor/fragment from \\l switch (decoded) */\n  anchor?: string;\n  /** Tooltip text from \\o switch */\n  tooltip?: string;\n  /** Whether \\h switch is present (creates hyperlink) */\n  hasHSwitch: boolean;\n  /** Combined full URL (url + \"#\" + anchor if both present) */\n  fullUrl: string;\n  /** Original raw instruction string */\n  rawInstruction: string;\n}\n\n/**\n * Parses a HYPERLINK field instruction string into its components\n *\n * HYPERLINK field syntax per ECMA-376:\n * - HYPERLINK \"url\" - basic external hyperlink\n * - HYPERLINK \\l \"anchor\" - anchor-only internal hyperlink (no URL)\n * - \\l \"anchor\" - specifies a location (anchor/fragment) within the target\n * - \\o \"tooltip\" - specifies the tooltip/screentip text\n * - \\h - creates a hyperlink (always present for clickable links)\n * - \\n - opens link in new window\n * - \\t \"target\" - specifies target frame\n *\n * @param instruction The raw field instruction string (e.g., 'HYPERLINK \"url\" \\l \"anchor\" \\h')\n * @returns Parsed components or null if not a valid HYPERLINK instruction\n *\n * @example\n * ```typescript\n * // External hyperlink with anchor\n * const result = parseHyperlinkInstruction('HYPERLINK \"https://example.com/\" \\\\l \"section1\" \\\\h');\n * // result.url = \"https://example.com/\"\n * // result.anchor = \"section1\"\n * // result.fullUrl = \"https://example.com/#section1\"\n *\n * // Anchor-only internal hyperlink (e.g., \"Top of the Document\")\n * const result2 = parseHyperlinkInstruction('HYPERLINK \\\\l \"_top\" \\\\h');\n * // result2.url = \"\"\n * // result2.anchor = \"_top\"\n * // result2.fullUrl = \"#_top\"\n * ```\n */\nexport function parseHyperlinkInstruction(instruction: string): ParsedHyperlinkInstruction | null {\n  if (!instruction) {\n    return null;\n  }\n\n  // Normalize whitespace and trim\n  const normalized = instruction.trim();\n\n  // Check if this is a HYPERLINK instruction\n  if (!normalized.toUpperCase().startsWith('HYPERLINK')) {\n    return null;\n  }\n\n  // Extract the URL (first quoted string after HYPERLINK, before any switches)\n  // URL is optional - anchor-only hyperlinks like 'HYPERLINK \\l \"_top\"' are valid\n  let url = '';\n  const urlMatch = /HYPERLINK\\s+\"([^\"]*)\"/i.exec(normalized);\n  if (urlMatch?.[1] !== undefined) {\n    url = urlMatch[1];\n    // Decode URL-encoded characters\n    try {\n      url = decodeURIComponent(url);\n    } catch (e) {\n      defaultLogger.debug(`[FieldHelpers] Failed to decode URL: ${url}`);\n    }\n  }\n\n  // Extract \\l switch (anchor/fragment)\n  let anchor: string | undefined;\n  const anchorMatch = /\\\\l\\s+\"([^\"]*)\"/i.exec(normalized);\n  if (anchorMatch?.[1] !== undefined) {\n    anchor = anchorMatch[1];\n    // Decode anchor as well\n    try {\n      anchor = decodeURIComponent(anchor);\n    } catch (e) {\n      defaultLogger.debug(`[FieldHelpers] Failed to decode anchor: ${anchor}`);\n    }\n  }\n\n  // Must have either URL or anchor to be valid\n  if (!url && !anchor) {\n    return null;\n  }\n\n  // Extract \\o switch (tooltip)\n  let tooltip: string | undefined;\n  const tooltipMatch = /\\\\o\\s+\"([^\"]*)\"/i.exec(normalized);\n  if (tooltipMatch?.[1] !== undefined) {\n    tooltip = tooltipMatch[1];\n  }\n\n  // Check for \\h switch\n  const hasHSwitch = /\\\\h(?:\\s|$)/i.test(normalized);\n\n  // Build full URL by combining base URL and anchor\n  let fullUrl: string = url;\n  if (anchor) {\n    // If URL already has a fragment, replace it; otherwise append\n    const hashIndex = url.indexOf('#');\n    if (hashIndex >= 0) {\n      fullUrl = url.substring(0, hashIndex) + '#' + anchor;\n    } else if (url) {\n      fullUrl = url + '#' + anchor;\n    } else {\n      // Anchor-only: just use #anchor\n      fullUrl = '#' + anchor;\n    }\n  }\n\n  return {\n    url,\n    anchor,\n    tooltip,\n    hasHSwitch,\n    fullUrl,\n    rawInstruction: instruction,\n  };\n}\n\n/**\n * Creates a HYPERLINK field instruction string from components\n *\n * @param url The target URL\n * @param anchor Optional anchor/fragment (will use \\l switch)\n * @param tooltip Optional tooltip text (will use \\o switch)\n * @returns Properly formatted HYPERLINK instruction string\n *\n * @example\n * ```typescript\n * const instr = buildHyperlinkInstruction('https://example.com/', 'section1', 'Click here');\n * // Returns: 'HYPERLINK \"https://example.com/\" \\\\l \"section1\" \\\\o \"Click here\" \\\\h'\n * ```\n */\nexport function buildHyperlinkInstruction(url: string, anchor?: string, tooltip?: string): string {\n  let instruction = `HYPERLINK \"${url}\"`;\n\n  if (anchor) {\n    instruction += ` \\\\l \"${anchor}\"`;\n  }\n\n  if (tooltip) {\n    instruction += ` \\\\o \"${tooltip}\"`;\n  }\n\n  // Always add \\h switch for clickable hyperlinks\n  instruction += ' \\\\h';\n\n  return instruction;\n}\n\n/**\n * Checks if a field instruction is a HYPERLINK field\n *\n * @param instruction The field instruction to check\n * @returns True if the instruction is a HYPERLINK field\n */\nexport function isHyperlinkInstruction(instruction: string): boolean {\n  if (!instruction) {\n    return false;\n  }\n  return instruction.trim().toUpperCase().startsWith('HYPERLINK');\n}\n\n/**\n * Creates a nested IF field containing a MERGEFIELD\n * This is a common pattern for conditional mail merge\n *\n * @param condition The IF condition (e.g., 'Status = \"Active\"')\n * @param mergeFieldName The merge field name to include\n * @param trueText Text to show when condition is true\n * @param falseText Text to show when condition is false\n * @returns ComplexField with nested MERGEFIELD\n *\n * @example\n * ```typescript\n * const field = createNestedIFMergeField('Status = \"Active\"', 'Name', 'Active: ', 'Inactive');\n * // Result: IF field that shows \"Active: [Name]\" if Status is Active, otherwise \"Inactive\"\n * ```\n */\nexport function createNestedIFMergeField(\n  condition: string,\n  mergeFieldName: string,\n  trueText = '',\n  falseText = ''\n): ComplexField {\n  // Create the nested MERGEFIELD\n  const mergeField = new ComplexField({\n    instruction: ` MERGEFIELD ${mergeFieldName} `,\n    result: `[${mergeFieldName}]`,\n  });\n\n  // Create the IF field with nested MERGEFIELD\n  const ifField = new ComplexField({\n    instruction: ` IF ${condition} \"${trueText}\" \"${falseText}\" `,\n    result: trueText || falseText,\n  });\n\n  ifField.addNestedField(mergeField);\n\n  return ifField;\n}\n\n/**\n * Creates a MERGEFIELD with custom formatting\n *\n * @param fieldName The merge field name\n * @param format Optional format switches\n * @returns ComplexField for MERGEFIELD\n *\n * @example\n * ```typescript\n * const field = createMergeField('Date', '\\\\@ \"MMMM d, yyyy\"');\n * ```\n */\nexport function createMergeField(fieldName: string, format?: string): ComplexField {\n  let instruction = ` MERGEFIELD ${fieldName}`;\n\n  if (format) {\n    instruction += ` ${format}`;\n  }\n\n  instruction += ' \\\\* MERGEFORMAT ';\n\n  return new ComplexField({\n    instruction,\n    result: `[${fieldName}]`,\n  });\n}\n\n/**\n * Creates a REF field with a nested field in the bookmark reference\n * Used for complex cross-references\n *\n * @param bookmarkName The bookmark to reference\n * @param format Optional format switches\n * @returns ComplexField for REF\n *\n * @example\n * ```typescript\n * const field = createRefField('Chapter1', '\\\\h');\n * ```\n */\nexport function createRefField(bookmarkName: string, format?: string): ComplexField {\n  let instruction = ` REF ${bookmarkName}`;\n\n  if (format) {\n    instruction += ` ${format}`;\n  } else {\n    instruction += ' \\\\h'; // Hyperlink by default\n  }\n\n  instruction += ' \\\\* MERGEFORMAT ';\n\n  return new ComplexField({\n    instruction,\n    result: `[${bookmarkName}]`,\n  });\n}\n\n/**\n * Creates an IF field with custom true/false branches\n *\n * @param condition The condition to evaluate\n * @param trueContent Content to show when true\n * @param falseContent Content to show when false\n * @returns ComplexField for IF\n *\n * @example\n * ```typescript\n * const field = createIFField('Amount > 1000', 'High Value', 'Normal');\n * ```\n */\nexport function createIFField(\n  condition: string,\n  trueContent: string,\n  falseContent = ''\n): ComplexField {\n  const instruction = ` IF ${condition} \"${trueContent}\" \"${falseContent}\" `;\n\n  return new ComplexField({\n    instruction,\n    result: trueContent,\n  });\n}\n\n/**\n * Creates a complex nested field structure with multiple levels\n * Useful for advanced scenarios like nested IF statements\n *\n * @param outerInstruction The outer field instruction\n * @param nestedFields Array of nested fields to include\n * @returns ComplexField with nested structure\n *\n * @example\n * ```typescript\n * const innerField = createMergeField('Amount');\n * const field = createNestedField('IF Amount > 0', [innerField]);\n * ```\n */\nexport function createNestedField(\n  outerInstruction: string,\n  nestedFields: ComplexField[]\n): ComplexField {\n  const field = new ComplexField({\n    instruction: outerInstruction,\n  });\n\n  for (const nested of nestedFields) {\n    field.addNestedField(nested);\n  }\n\n  return field;\n}\n"]}
+{"version":3,"file":"FieldHelpers.js","sourceRoot":"","sources":["../../../src/elements/FieldHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Helper functions for creating complex and nested fields\n */\n\nimport { ComplexField } from './Field.js';\nimport { defaultLogger } from '../utils/logger.js';\n\n/**\n * Parsed components of a HYPERLINK field instruction\n */\nexport interface ParsedHyperlinkInstruction {\n  /** Base URL (with encoded characters decoded) */\n  url: string;\n  /** Anchor/fragment from \\l switch (decoded) */\n  anchor?: string;\n  /** Tooltip text from \\o switch */\n  tooltip?: string;\n  /** Whether \\h switch is present (creates hyperlink) */\n  hasHSwitch: boolean;\n  /** Combined full URL (url + \"#\" + anchor if both present) */\n  fullUrl: string;\n  /** Original raw instruction string */\n  rawInstruction: string;\n}\n\n/**\n * Parses a HYPERLINK field instruction string into its components\n *\n * HYPERLINK field syntax per ECMA-376:\n * - HYPERLINK \"url\" - basic external hyperlink\n * - HYPERLINK \\l \"anchor\" - anchor-only internal hyperlink (no URL)\n * - \\l \"anchor\" - specifies a location (anchor/fragment) within the target\n * - \\o \"tooltip\" - specifies the tooltip/screentip text\n * - \\h - creates a hyperlink (always present for clickable links)\n * - \\n - opens link in new window\n * - \\t \"target\" - specifies target frame\n *\n * @param instruction The raw field instruction string (e.g., 'HYPERLINK \"url\" \\l \"anchor\" \\h')\n * @returns Parsed components or null if not a valid HYPERLINK instruction\n *\n * @example\n * ```typescript\n * // External hyperlink with anchor\n * const result = parseHyperlinkInstruction('HYPERLINK \"https://example.com/\" \\\\l \"section1\" \\\\h');\n * // result.url = \"https://example.com/\"\n * // result.anchor = \"section1\"\n * // result.fullUrl = \"https://example.com/#section1\"\n *\n * // Anchor-only internal hyperlink (e.g., \"Top of the Document\")\n * const result2 = parseHyperlinkInstruction('HYPERLINK \\\\l \"_top\" \\\\h');\n * // result2.url = \"\"\n * // result2.anchor = \"_top\"\n * // result2.fullUrl = \"#_top\"\n * ```\n */\nexport function parseHyperlinkInstruction(instruction: string): ParsedHyperlinkInstruction | null {\n  if (!instruction) {\n    return null;\n  }\n\n  // Normalize whitespace and trim\n  const normalized = instruction.trim();\n\n  // Check if this is a HYPERLINK instruction\n  if (!normalized.toUpperCase().startsWith('HYPERLINK')) {\n    return null;\n  }\n\n  // Extract the URL (first quoted string after HYPERLINK, before any switches)\n  // URL is optional - anchor-only hyperlinks like 'HYPERLINK \\l \"_top\"' are valid\n  let url = '';\n  const urlMatch = /HYPERLINK\\s+\"([^\"]*)\"/i.exec(normalized);\n  if (urlMatch?.[1] !== undefined) {\n    url = urlMatch[1];\n    // Decode URL-encoded characters\n    try {\n      url = decodeURIComponent(url);\n    } catch (e) {\n      defaultLogger.debug(`[FieldHelpers] Failed to decode URL: ${url}`);\n    }\n  }\n\n  // Extract \\l switch (anchor/fragment)\n  let anchor: string | undefined;\n  const anchorMatch = /\\\\l\\s+\"([^\"]*)\"/i.exec(normalized);\n  if (anchorMatch?.[1] !== undefined) {\n    anchor = anchorMatch[1];\n    // Decode anchor as well\n    try {\n      anchor = decodeURIComponent(anchor);\n    } catch (e) {\n      defaultLogger.debug(`[FieldHelpers] Failed to decode anchor: ${anchor}`);\n    }\n  }\n\n  // Must have either URL or anchor to be valid\n  if (!url && !anchor) {\n    return null;\n  }\n\n  // Extract \\o switch (tooltip)\n  let tooltip: string | undefined;\n  const tooltipMatch = /\\\\o\\s+\"([^\"]*)\"/i.exec(normalized);\n  if (tooltipMatch?.[1] !== undefined) {\n    tooltip = tooltipMatch[1];\n  }\n\n  // Check for \\h switch\n  const hasHSwitch = /\\\\h(?:\\s|$)/i.test(normalized);\n\n  // Build full URL by combining base URL and anchor\n  let fullUrl: string = url;\n  if (anchor) {\n    // If URL already has a fragment, replace it; otherwise append\n    const hashIndex = url.indexOf('#');\n    if (hashIndex >= 0) {\n      fullUrl = url.substring(0, hashIndex) + '#' + anchor;\n    } else if (url) {\n      fullUrl = url + '#' + anchor;\n    } else {\n      // Anchor-only: just use #anchor\n      fullUrl = '#' + anchor;\n    }\n  }\n\n  return {\n    url,\n    anchor,\n    tooltip,\n    hasHSwitch,\n    fullUrl,\n    rawInstruction: instruction,\n  };\n}\n\n/**\n * Escapes a value for use inside a quoted field-instruction argument.\n *\n * Per ECMA-376 field-argument syntax (§17.16.4.1), a literal double quote\n * inside a quoted argument must be written as \\\" and a literal backslash\n * as \\\\ — otherwise an embedded quote terminates the argument early and\n * the remainder is misparsed as stray switches. The XML layer only\n * escapes XML entities, so this must happen at field-code level.\n *\n * @param value Raw argument text\n * @returns Text safe to interpolate between double quotes in a field code\n */\nexport function escapeFieldArgument(value: string): string {\n  return value.replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"');\n}\n\n/**\n * Creates a HYPERLINK field instruction string from components\n *\n * @param url The target URL\n * @param anchor Optional anchor/fragment (will use \\l switch)\n * @param tooltip Optional tooltip text (will use \\o switch)\n * @returns Properly formatted HYPERLINK instruction string\n *\n * @example\n * ```typescript\n * const instr = buildHyperlinkInstruction('https://example.com/', 'section1', 'Click here');\n * // Returns: 'HYPERLINK \"https://example.com/\" \\\\l \"section1\" \\\\o \"Click here\" \\\\h'\n * ```\n */\nexport function buildHyperlinkInstruction(url: string, anchor?: string, tooltip?: string): string {\n  let instruction = `HYPERLINK \"${escapeFieldArgument(url)}\"`;\n\n  if (anchor) {\n    instruction += ` \\\\l \"${escapeFieldArgument(anchor)}\"`;\n  }\n\n  if (tooltip) {\n    instruction += ` \\\\o \"${escapeFieldArgument(tooltip)}\"`;\n  }\n\n  // Always add \\h switch for clickable hyperlinks\n  instruction += ' \\\\h';\n\n  return instruction;\n}\n\n/**\n * Checks if a field instruction is a HYPERLINK field\n *\n * @param instruction The field instruction to check\n * @returns True if the instruction is a HYPERLINK field\n */\nexport function isHyperlinkInstruction(instruction: string): boolean {\n  if (!instruction) {\n    return false;\n  }\n  return instruction.trim().toUpperCase().startsWith('HYPERLINK');\n}\n\n/**\n * Creates a nested IF field containing a MERGEFIELD\n * This is a common pattern for conditional mail merge\n *\n * @param condition The IF condition (e.g., 'Status = \"Active\"')\n * @param mergeFieldName The merge field name to include\n * @param trueText Text to show when condition is true\n * @param falseText Text to show when condition is false\n * @returns ComplexField with nested MERGEFIELD\n *\n * @example\n * ```typescript\n * const field = createNestedIFMergeField('Status = \"Active\"', 'Name', 'Active: ', 'Inactive');\n * // Result: IF field that shows \"Active: [Name]\" if Status is Active, otherwise \"Inactive\"\n * ```\n */\nexport function createNestedIFMergeField(\n  condition: string,\n  mergeFieldName: string,\n  trueText = '',\n  falseText = ''\n): ComplexField {\n  // Create the nested MERGEFIELD\n  const mergeField = new ComplexField({\n    instruction: ` MERGEFIELD ${mergeFieldName} `,\n    result: `[${mergeFieldName}]`,\n  });\n\n  // Create the IF field with nested MERGEFIELD\n  const ifField = new ComplexField({\n    instruction: ` IF ${condition} \"${trueText}\" \"${falseText}\" `,\n    result: trueText || falseText,\n  });\n\n  ifField.addNestedField(mergeField);\n\n  return ifField;\n}\n\n/**\n * Creates a MERGEFIELD with custom formatting\n *\n * @param fieldName The merge field name\n * @param format Optional format switches\n * @returns ComplexField for MERGEFIELD\n *\n * @example\n * ```typescript\n * const field = createMergeField('Date', '\\\\@ \"MMMM d, yyyy\"');\n * ```\n */\nexport function createMergeField(fieldName: string, format?: string): ComplexField {\n  let instruction = ` MERGEFIELD ${fieldName}`;\n\n  if (format) {\n    instruction += ` ${format}`;\n  }\n\n  instruction += ' \\\\* MERGEFORMAT ';\n\n  return new ComplexField({\n    instruction,\n    result: `[${fieldName}]`,\n  });\n}\n\n/**\n * Creates a REF field with a nested field in the bookmark reference\n * Used for complex cross-references\n *\n * @param bookmarkName The bookmark to reference\n * @param format Optional format switches\n * @returns ComplexField for REF\n *\n * @example\n * ```typescript\n * const field = createRefField('Chapter1', '\\\\h');\n * ```\n */\nexport function createRefField(bookmarkName: string, format?: string): ComplexField {\n  let instruction = ` REF ${bookmarkName}`;\n\n  if (format) {\n    instruction += ` ${format}`;\n  } else {\n    instruction += ' \\\\h'; // Hyperlink by default\n  }\n\n  instruction += ' \\\\* MERGEFORMAT ';\n\n  return new ComplexField({\n    instruction,\n    result: `[${bookmarkName}]`,\n  });\n}\n\n/**\n * Creates an IF field with custom true/false branches\n *\n * @param condition The condition to evaluate\n * @param trueContent Content to show when true\n * @param falseContent Content to show when false\n * @returns ComplexField for IF\n *\n * @example\n * ```typescript\n * const field = createIFField('Amount > 1000', 'High Value', 'Normal');\n * ```\n */\nexport function createIFField(\n  condition: string,\n  trueContent: string,\n  falseContent = ''\n): ComplexField {\n  const instruction = ` IF ${condition} \"${escapeFieldArgument(trueContent)}\" \"${escapeFieldArgument(falseContent)}\" `;\n\n  return new ComplexField({\n    instruction,\n    result: trueContent,\n  });\n}\n\n/**\n * Creates a complex nested field structure with multiple levels\n * Useful for advanced scenarios like nested IF statements\n *\n * @param outerInstruction The outer field instruction\n * @param nestedFields Array of nested fields to include\n * @returns ComplexField with nested structure\n *\n * @example\n * ```typescript\n * const innerField = createMergeField('Amount');\n * const field = createNestedField('IF Amount > 0', [innerField]);\n * ```\n */\nexport function createNestedField(\n  outerInstruction: string,\n  nestedFields: ComplexField[]\n): ComplexField {\n  const field = new ComplexField({\n    instruction: outerInstruction,\n  });\n\n  for (const nested of nestedFields) {\n    field.addNestedField(nested);\n  }\n\n  return field;\n}\n"]}

package/dist/esm/elements/Footer.js

@@ -1,3 +1,5 @@
+import { XMLBuilder } from '../xml/XMLBuilder.js';
+import { XMLParser } from '../xml/XMLParser.js';
 import { Paragraph } from './Paragraph.js';
 import { Table } from './Table.js';
 export class Footer {
@@ -5,13 +7,35 @@ export class Footer {
     type;
     footerId;
     rawXML;
+    rawXmlBlockCount = Number.MAX_SAFE_INTEGER;
     constructor(properties = {}) {
         this.type = properties.type || 'default';
     }
     setRawXML(xml) {
         this.rawXML = xml;
+        this.rawXmlBlockCount = Footer.countTopLevelBlocks(xml);
         return this;
     }
+    static countTopLevelBlocks(xml) {
+        try {
+            const parsed = XMLParser.parseToObject(xml);
+            const root = parsed?.['w:ftr'];
+            if (!root || typeof root !== 'object') {
+                return 0;
+            }
+            const count = (node) => node === undefined ? 0 : Array.isArray(node) ? node.length : 1;
+            const rootObj = root;
+            return count(rootObj['w:p']) + count(rootObj['w:tbl']);
+        }
+        catch {
+            return Number.MAX_SAFE_INTEGER;
+        }
+    }
+    invalidateRawXmlOnGrowth() {
+        if (this.rawXML !== undefined && this.elements.length > this.rawXmlBlockCount) {
+            this.rawXML = undefined;
+        }
+    }
     getRawXML() {
         return this.rawXML;
     }
@@ -27,6 +51,7 @@ export class Footer {
     }
     addParagraph(paragraph) {
         this.elements.push(paragraph);
+        this.invalidateRawXmlOnGrowth();
         return this;
     }
     createParagraph(text) {
@@ -35,21 +60,25 @@ export class Footer {
             para.addText(text);
         }
         this.elements.push(para);
+        this.invalidateRawXmlOnGrowth();
         return para;
     }
     addText(text, formatting) {
         const para = new Paragraph();
         para.addText(text, formatting);
         this.elements.push(para);
+        this.invalidateRawXmlOnGrowth();
         return para;
     }
     addTable(table) {
         this.elements.push(table);
+        this.invalidateRawXmlOnGrowth();
         return this;
     }
     createTable(rows, columns) {
         const table = new Table(rows, columns);
         this.elements.push(table);
+        this.invalidateRawXmlOnGrowth();
         return table;
     }
     getElements() {
@@ -67,60 +96,17 @@ export class Footer {
         if (this.rawXML) {
             return this.rawXML;
         }
-        const elementXmls = this.elements.map((el) => el.toXML());
-        let xml = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n';
-        xml += '<w:ftr xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main" ';
-        xml += 'xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">\n';
-        for (const element of elementXmls) {
-            xml += this.renderElement(element, 1);
-        }
-        if (this.elements.length === 0) {
-            xml += '  <w:p/>\n';
-        }
-        xml += '</w:ftr>';
-        return xml;
-    }
-    renderElement(element, indent) {
-        const spaces = '  '.repeat(indent);
-        let xml = '';
-        if (element.selfClosing) {
-            xml += `${spaces}<${element.name}`;
-            if (element.attributes) {
-                for (const [key, value] of Object.entries(element.attributes)) {
-                    xml += ` ${key}="${value}"`;
-                }
-            }
-            xml += '/>\n';
-        }
-        else {
-            xml += `${spaces}<${element.name}`;
-            if (element.attributes) {
-                for (const [key, value] of Object.entries(element.attributes)) {
-                    xml += ` ${key}="${value}"`;
-                }
-            }
-            xml += '>';
-            if (element.children && element.children.length > 0) {
-                const hasOnlyText = element.children.every((c) => typeof c === 'string');
-                if (hasOnlyText) {
-                    xml += element.children.join('');
-                }
-                else {
-                    xml += '\n';
-                    for (const child of element.children) {
-                        if (typeof child === 'string') {
-                            xml += spaces + '  ' + child + '\n';
-                        }
-                        else {
-                            xml += this.renderElement(child, indent + 1);
-                        }
-                    }
-                    xml += spaces;
-                }
-            }
-            xml += `</${element.name}>\n`;
+        const children = this.elements.map((el) => el.toXML());
+        if (children.length === 0) {
+            children.push(XMLBuilder.w('p'));
         }
-        return xml;
+        const namespaces = {
+            ...XMLBuilder.createNamespaces(),
+            'mc:Ignorable': 'w14 w15 wp14 asvg',
+        };
+        const builder = new XMLBuilder();
+        builder.element('w:ftr', namespaces, children);
+        return builder.build(true);
     }
     getFilename(number) {
         return `footer${number}.xml`;

package/dist/esm/elements/Footer.js.map

@@ -1 +1 @@
-{"version":3,"file":"Footer.js","sourceRoot":"","sources":["../../../src/elements/Footer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Footer - Represents a document footer\n *\n * Footers appear at the bottom of pages and can contain text, tables, images, and fields.\n * Different footers can be defined for first page, odd pages, and even pages.\n */\n\nimport { XMLElement } from '../xml/XMLBuilder.js';\nimport { Paragraph } from './Paragraph.js';\nimport { RunFormatting } from './Run.js';\nimport { Table } from './Table.js';\n\n/**\n * Footer type\n */\nexport type FooterType = 'default' | 'first' | 'even';\n\n/**\n * Footer content element\n */\ntype FooterElement = Paragraph | Table;\n\n/**\n * Footer properties\n */\nexport interface FooterProperties {\n  /** Footer type (default, first page, or even page) */\n  type?: FooterType;\n}\n\n/**\n * Represents a document footer\n */\nexport class Footer {\n  private elements: FooterElement[] = [];\n  private type: FooterType;\n  private footerId?: string;\n  private rawXML?: string; // Store original XML for preservation\n\n  /**\n   * Creates a new footer\n   * @param properties Footer properties\n   */\n  constructor(properties: FooterProperties = {}) {\n    this.type = properties.type || 'default';\n  }\n\n  /**\n   * Sets the raw XML content (used when loading existing footers)\n   * @param xml Raw XML content\n   */\n  setRawXML(xml: string): this {\n    this.rawXML = xml;\n    return this;\n  }\n\n  /**\n   * Gets the raw XML content if available\n   */\n  getRawXML(): string | undefined {\n    return this.rawXML;\n  }\n\n  /**\n   * Gets the footer type\n   */\n  getType(): FooterType {\n    return this.type;\n  }\n\n  /**\n   * Sets the footer ID (used for relationships)\n   * @param id Footer ID\n   */\n  setFooterId(id: string): this {\n    this.footerId = id;\n    return this;\n  }\n\n  /**\n   * Gets the footer ID\n   */\n  getFooterId(): string | undefined {\n    return this.footerId;\n  }\n\n  /**\n   * Adds a paragraph to the footer\n   * @param paragraph Paragraph to add\n   */\n  addParagraph(paragraph: Paragraph): this {\n    this.elements.push(paragraph);\n    return this;\n  }\n\n  /**\n   * Creates and adds a new paragraph\n   * @param text Optional text content\n   */\n  createParagraph(text?: string): Paragraph {\n    const para = new Paragraph();\n    if (text) {\n      para.addText(text);\n    }\n    this.elements.push(para);\n    return para;\n  }\n\n  /**\n   * Adds formatted text to the footer as a new paragraph\n   *\n   * Convenience method that creates a paragraph with a single formatted run.\n   *\n   * @param text - Text content\n   * @param formatting - Optional run formatting (bold, font, size, etc.)\n   * @returns The created Paragraph for further customization\n   *\n   * @example\n   * ```typescript\n   * footer.addText('Page ', { size: 8 });\n   * footer.addText('Confidential', { italic: true, color: '888888' });\n   * ```\n   */\n  addText(text: string, formatting?: RunFormatting): Paragraph {\n    const para = new Paragraph();\n    para.addText(text, formatting);\n    this.elements.push(para);\n    return para;\n  }\n\n  /**\n   * Adds a table to the footer\n   * @param table Table to add\n   */\n  addTable(table: Table): this {\n    this.elements.push(table);\n    return this;\n  }\n\n  /**\n   * Creates and adds a new table\n   * @param rows Number of rows\n   * @param columns Number of columns\n   */\n  createTable(rows: number, columns: number): Table {\n    const table = new Table(rows, columns);\n    this.elements.push(table);\n    return table;\n  }\n\n  /**\n   * Gets all elements in the footer\n   */\n  getElements(): FooterElement[] {\n    return [...this.elements];\n  }\n\n  /**\n   * Gets the number of elements\n   */\n  getElementCount(): number {\n    return this.elements.length;\n  }\n\n  /**\n   * Clears all elements and resets raw XML so toXML() regenerates an empty footer\n   */\n  clear(): this {\n    this.elements = [];\n    this.rawXML = undefined;\n    return this;\n  }\n\n  /**\n   * Generates the complete footer XML file content\n   * This creates a complete footer document (footer1.xml, etc.)\n   */\n  toXML(): string {\n    // If we have raw XML preserved from loading, use it\n    if (this.rawXML) {\n      return this.rawXML;\n    }\n\n    // Otherwise generate from elements\n    const elementXmls = this.elements.map((el) => el.toXML());\n\n    let xml = '<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\\n';\n    xml += '<w:ftr xmlns:w=\"http://schemas.openxmlformats.org/wordprocessingml/2006/main\" ';\n    xml += 'xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\">\\n';\n\n    // Add elements\n    for (const element of elementXmls) {\n      xml += this.renderElement(element, 1);\n    }\n\n    // If no elements, add an empty paragraph\n    if (this.elements.length === 0) {\n      xml += '  <w:p/>\\n';\n    }\n\n    xml += '</w:ftr>';\n\n    return xml;\n  }\n\n  /**\n   * Renders an XML element to string with indentation\n   */\n  private renderElement(element: XMLElement, indent: number): string {\n    const spaces = '  '.repeat(indent);\n    let xml = '';\n\n    if (element.selfClosing) {\n      xml += `${spaces}<${element.name}`;\n      if (element.attributes) {\n        for (const [key, value] of Object.entries(element.attributes)) {\n          xml += ` ${key}=\"${value}\"`;\n        }\n      }\n      xml += '/>\\n';\n    } else {\n      xml += `${spaces}<${element.name}`;\n      if (element.attributes) {\n        for (const [key, value] of Object.entries(element.attributes)) {\n          xml += ` ${key}=\"${value}\"`;\n        }\n      }\n      xml += '>';\n\n      if (element.children && element.children.length > 0) {\n        const hasOnlyText = element.children.every((c) => typeof c === 'string');\n\n        if (hasOnlyText) {\n          // Inline text content\n          xml += element.children.join('');\n        } else {\n          // Block-level children\n          xml += '\\n';\n          for (const child of element.children) {\n            if (typeof child === 'string') {\n              xml += spaces + '  ' + child + '\\n';\n            } else {\n              xml += this.renderElement(child, indent + 1);\n            }\n          }\n          xml += spaces;\n        }\n      }\n\n      xml += `</${element.name}>\\n`;\n    }\n\n    return xml;\n  }\n\n  /**\n   * Gets the filename for this footer\n   * @param number Footer number (1, 2, 3, etc.)\n   */\n  getFilename(number: number): string {\n    return `footer${number}.xml`;\n  }\n\n  /**\n   * Creates a default footer\n   */\n  static createDefault(): Footer {\n    return new Footer({ type: 'default' });\n  }\n\n  /**\n   * Creates a first page footer\n   */\n  static createFirst(): Footer {\n    return new Footer({ type: 'first' });\n  }\n\n  /**\n   * Creates an even page footer\n   */\n  static createEven(): Footer {\n    return new Footer({ type: 'even' });\n  }\n\n  /**\n   * Creates a footer with properties\n   * @param properties Footer properties\n   */\n  static create(properties?: FooterProperties): Footer {\n    return new Footer(properties);\n  }\n}\n"]}
+{"version":3,"file":"Footer.js","sourceRoot":"","sources":["../../../src/elements/Footer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Footer - Represents a document footer\n *\n * Footers appear at the bottom of pages and can contain text, tables, images, and fields.\n * Different footers can be defined for first page, odd pages, and even pages.\n */\n\nimport { XMLBuilder } from '../xml/XMLBuilder.js';\nimport { XMLParser } from '../xml/XMLParser.js';\nimport { Paragraph } from './Paragraph.js';\nimport { RunFormatting } from './Run.js';\nimport { Table } from './Table.js';\n\n/**\n * Footer type\n */\nexport type FooterType = 'default' | 'first' | 'even';\n\n/**\n * Footer content element\n */\ntype FooterElement = Paragraph | Table;\n\n/**\n * Footer properties\n */\nexport interface FooterProperties {\n  /** Footer type (default, first page, or even page) */\n  type?: FooterType;\n}\n\n/**\n * Represents a document footer\n */\nexport class Footer {\n  private elements: FooterElement[] = [];\n  private type: FooterType;\n  private footerId?: string;\n  private rawXML?: string; // Store original XML for preservation\n  // Top-level w:p/w:tbl count of the preserved raw XML. DocumentParser calls\n  // setRawXML() before repopulating elements from that same XML, so mutators\n  // can't simply clear rawXML — they would fire during parsing and lose the\n  // preserved bytes. Instead, growth beyond this count is the signal that\n  // content was added after load and the preserved XML is stale.\n  private rawXmlBlockCount = Number.MAX_SAFE_INTEGER;\n\n  /**\n   * Creates a new footer\n   * @param properties Footer properties\n   */\n  constructor(properties: FooterProperties = {}) {\n    this.type = properties.type || 'default';\n  }\n\n  /**\n   * Sets the raw XML content (used when loading existing footers)\n   * @param xml Raw XML content\n   */\n  setRawXML(xml: string): this {\n    this.rawXML = xml;\n    this.rawXmlBlockCount = Footer.countTopLevelBlocks(xml);\n    return this;\n  }\n\n  /**\n   * Counts the top-level w:p/w:tbl children of a raw footer part.\n   * Parsing populates this.elements from exactly those blocks, so the count\n   * is the baseline against which mutators detect post-load additions.\n   */\n  private static countTopLevelBlocks(xml: string): number {\n    try {\n      const parsed = XMLParser.parseToObject(xml) as Record<string, unknown>;\n      const root = parsed?.['w:ftr'];\n      if (!root || typeof root !== 'object') {\n        return 0;\n      }\n      const count = (node: unknown): number =>\n        node === undefined ? 0 : Array.isArray(node) ? node.length : 1;\n      const rootObj = root as Record<string, unknown>;\n      return count(rootObj['w:p']) + count(rootObj['w:tbl']);\n    } catch {\n      // Unparseable part: never invalidate, keep the preserved bytes\n      return Number.MAX_SAFE_INTEGER;\n    }\n  }\n\n  /**\n   * Drops the preserved raw XML once content grows beyond what that XML\n   * already contains, so toXML() regenerates from elements and post-load\n   * edits are not silently discarded on save.\n   */\n  private invalidateRawXmlOnGrowth(): void {\n    if (this.rawXML !== undefined && this.elements.length > this.rawXmlBlockCount) {\n      this.rawXML = undefined;\n    }\n  }\n\n  /**\n   * Gets the raw XML content if available\n   */\n  getRawXML(): string | undefined {\n    return this.rawXML;\n  }\n\n  /**\n   * Gets the footer type\n   */\n  getType(): FooterType {\n    return this.type;\n  }\n\n  /**\n   * Sets the footer ID (used for relationships)\n   * @param id Footer ID\n   */\n  setFooterId(id: string): this {\n    this.footerId = id;\n    return this;\n  }\n\n  /**\n   * Gets the footer ID\n   */\n  getFooterId(): string | undefined {\n    return this.footerId;\n  }\n\n  /**\n   * Adds a paragraph to the footer\n   * @param paragraph Paragraph to add\n   */\n  addParagraph(paragraph: Paragraph): this {\n    this.elements.push(paragraph);\n    this.invalidateRawXmlOnGrowth();\n    return this;\n  }\n\n  /**\n   * Creates and adds a new paragraph\n   * @param text Optional text content\n   */\n  createParagraph(text?: string): Paragraph {\n    const para = new Paragraph();\n    if (text) {\n      para.addText(text);\n    }\n    this.elements.push(para);\n    this.invalidateRawXmlOnGrowth();\n    return para;\n  }\n\n  /**\n   * Adds formatted text to the footer as a new paragraph\n   *\n   * Convenience method that creates a paragraph with a single formatted run.\n   *\n   * @param text - Text content\n   * @param formatting - Optional run formatting (bold, font, size, etc.)\n   * @returns The created Paragraph for further customization\n   *\n   * @example\n   * ```typescript\n   * footer.addText('Page ', { size: 8 });\n   * footer.addText('Confidential', { italic: true, color: '888888' });\n   * ```\n   */\n  addText(text: string, formatting?: RunFormatting): Paragraph {\n    const para = new Paragraph();\n    para.addText(text, formatting);\n    this.elements.push(para);\n    this.invalidateRawXmlOnGrowth();\n    return para;\n  }\n\n  /**\n   * Adds a table to the footer\n   * @param table Table to add\n   */\n  addTable(table: Table): this {\n    this.elements.push(table);\n    this.invalidateRawXmlOnGrowth();\n    return this;\n  }\n\n  /**\n   * Creates and adds a new table\n   * @param rows Number of rows\n   * @param columns Number of columns\n   */\n  createTable(rows: number, columns: number): Table {\n    const table = new Table(rows, columns);\n    this.elements.push(table);\n    this.invalidateRawXmlOnGrowth();\n    return table;\n  }\n\n  /**\n   * Gets all elements in the footer\n   */\n  getElements(): FooterElement[] {\n    return [...this.elements];\n  }\n\n  /**\n   * Gets the number of elements\n   */\n  getElementCount(): number {\n    return this.elements.length;\n  }\n\n  /**\n   * Clears all elements and resets raw XML so toXML() regenerates an empty footer\n   */\n  clear(): this {\n    this.elements = [];\n    this.rawXML = undefined;\n    return this;\n  }\n\n  /**\n   * Generates the complete footer XML file content\n   * This creates a complete footer document (footer1.xml, etc.)\n   */\n  toXML(): string {\n    // If we have raw XML preserved from loading, use it\n    if (this.rawXML) {\n      return this.rawXML;\n    }\n\n    // Serialize through XMLBuilder so text and attribute values are\n    // XML-escaped and rawXml passthrough children are honored\n    const children = this.elements.map((el) => el.toXML());\n\n    // ECMA-376 requires block-level content in w:ftr\n    if (children.length === 0) {\n      children.push(XMLBuilder.w('p'));\n    }\n\n    const namespaces: Record<string, string> = {\n      ...XMLBuilder.createNamespaces(),\n      // Extension namespaces (w14:paraId etc. on regenerated paragraphs)\n      // must be declared ignorable or Word rejects the part\n      'mc:Ignorable': 'w14 w15 wp14 asvg',\n    };\n\n    const builder = new XMLBuilder();\n    builder.element('w:ftr', namespaces, children);\n    return builder.build(true);\n  }\n\n  /**\n   * Gets the filename for this footer\n   * @param number Footer number (1, 2, 3, etc.)\n   */\n  getFilename(number: number): string {\n    return `footer${number}.xml`;\n  }\n\n  /**\n   * Creates a default footer\n   */\n  static createDefault(): Footer {\n    return new Footer({ type: 'default' });\n  }\n\n  /**\n   * Creates a first page footer\n   */\n  static createFirst(): Footer {\n    return new Footer({ type: 'first' });\n  }\n\n  /**\n   * Creates an even page footer\n   */\n  static createEven(): Footer {\n    return new Footer({ type: 'even' });\n  }\n\n  /**\n   * Creates a footer with properties\n   * @param properties Footer properties\n   */\n  static create(properties?: FooterProperties): Footer {\n    return new Footer(properties);\n  }\n}\n"]}

package/dist/esm/elements/FootnoteManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"FootnoteManager.js","sourceRoot":"","sources":["../../../src/elements/FootnoteManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * FootnoteManager - Manages footnotes in a document\n *\n * Handles creation, registration, and XML generation for footnotes.\n * Maintains unique IDs and proper ordering.\n */\n\nimport { Footnote, FootnoteType } from './Footnote.js';\nimport { XMLBuilder, XMLElement } from '../xml/XMLBuilder.js';\nimport { XMLParser } from '../xml/XMLParser.js';\n\n/**\n * Manages footnotes in a document\n */\nexport class FootnoteManager {\n  private footnotes = new Map<number, Footnote>();\n  private nextId = 1;\n\n  /**\n   * Creates a new FootnoteManager\n   * @private Use static factory method\n   */\n  private constructor() {\n    // Add special footnotes (separators) with negative IDs\n    this.addSpecialFootnotes();\n  }\n\n  /**\n   * Adds special footnotes (separator, continuation)\n   * These use negative IDs as per OOXML specification\n   */\n  private addSpecialFootnotes(): void {\n    // Separator footnote (ID -1)\n    const separator = Footnote.createSeparator(-1);\n    this.footnotes.set(-1, separator);\n\n    // Continuation separator (ID 0)\n    const continuationSep = Footnote.createContinuationSeparator(0);\n    this.footnotes.set(0, continuationSep);\n  }\n\n  /**\n   * Checks if a footnote is a special/system type (separator, continuationSeparator,\n   * continuationNotice) that should be preserved across clear() operations.\n   * Uses type-based detection rather than ID-based, because continuationNotice\n   * has a positive ID (typically 1) but is still a system footnote.\n   */\n  private isSpecialFootnote(footnote: Footnote): boolean {\n    const type = footnote.getType();\n    return (\n      type === FootnoteType.Separator ||\n      type === FootnoteType.ContinuationSeparator ||\n      type === FootnoteType.ContinuationNotice\n    );\n  }\n\n  /**\n   * Creates a new FootnoteManager instance\n   */\n  static create(): FootnoteManager {\n    return new FootnoteManager();\n  }\n\n  /**\n   * Registers a footnote\n   * @param footnote Footnote to register\n   * @returns The registered footnote\n   */\n  register(footnote: Footnote): Footnote {\n    const id = footnote.getId();\n\n    // Ensure ID is not already used (except for special footnotes)\n    if (id > 0 && this.footnotes.has(id)) {\n      throw new Error(`Footnote with ID ${id} already exists`);\n    }\n\n    this.footnotes.set(id, footnote);\n\n    // Update next ID if needed\n    if (id >= this.nextId) {\n      this.nextId = id + 1;\n    }\n\n    return footnote;\n  }\n\n  /**\n   * Creates and registers a new footnote\n   * @param text Footnote text\n   * @returns The created footnote\n   */\n  createFootnote(text: string): Footnote {\n    const footnote = Footnote.fromText(this.nextId++, text);\n    this.footnotes.set(footnote.getId(), footnote);\n    return footnote;\n  }\n\n  /**\n   * Gets a footnote by ID\n   * @param id Footnote ID\n   * @returns The footnote, or undefined if not found\n   */\n  getFootnote(id: number): Footnote | undefined {\n    return this.footnotes.get(id);\n  }\n\n  /**\n   * Gets all user footnotes (excluding special system types: separator,\n   * continuationSeparator, continuationNotice)\n   */\n  getAllFootnotes(): Footnote[] {\n    return Array.from(this.footnotes.values())\n      .filter((f) => !this.isSpecialFootnote(f))\n      .sort((a, b) => a.getId() - b.getId());\n  }\n\n  /**\n   * Gets all footnotes including special ones\n   */\n  getAllFootnotesWithSpecial(): Footnote[] {\n    return Array.from(this.footnotes.values()).sort((a, b) => a.getId() - b.getId());\n  }\n\n  /**\n   * Checks if a footnote exists\n   * @param id Footnote ID\n   */\n  hasFootnote(id: number): boolean {\n    return this.footnotes.has(id);\n  }\n\n  /**\n   * Removes a footnote\n   * @param id Footnote ID\n   * @returns True if removed, false if not found or if it's a special type\n   */\n  removeFootnote(id: number): boolean {\n    const footnote = this.footnotes.get(id);\n    if (!footnote || this.isSpecialFootnote(footnote)) {\n      return false;\n    }\n    return this.footnotes.delete(id);\n  }\n\n  /**\n   * Gets the next available ID\n   */\n  getNextId(): number {\n    return this.nextId;\n  }\n\n  /**\n   * Gets the count of footnotes (excluding special ones)\n   */\n  getCount(): number {\n    return this.getAllFootnotes().length;\n  }\n\n  /**\n   * Checks if there are any footnotes (excluding special ones)\n   */\n  isEmpty(): boolean {\n    return this.getCount() === 0;\n  }\n\n  /**\n   * Clears all user footnotes (preserves special system types: separator,\n   * continuationSeparator, continuationNotice)\n   */\n  clear(): void {\n    const specialFootnotes = new Map<number, Footnote>();\n    let maxSpecialId = 0;\n\n    for (const [id, footnote] of this.footnotes) {\n      if (this.isSpecialFootnote(footnote)) {\n        specialFootnotes.set(id, footnote);\n        if (id > maxSpecialId) {\n          maxSpecialId = id;\n        }\n      }\n    }\n\n    this.footnotes = specialFootnotes;\n    // Ensure nextId doesn't collide with special footnotes that have positive IDs\n    this.nextId = Math.max(maxSpecialId + 1, 1);\n  }\n\n  /**\n   * Gets statistics about footnotes\n   */\n  getStats(): {\n    total: number;\n    nextId: number;\n  } {\n    return {\n      total: this.getCount(),\n      nextId: this.nextId,\n    };\n  }\n\n  /**\n   * Generates the footnotes.xml content\n   */\n  generateFootnotesXml(): string {\n    const footnotes = this.getAllFootnotesWithSpecial();\n\n    // Build footnotes element\n    const footnotesElement: XMLElement = {\n      name: 'w:footnotes',\n      attributes: {\n        'xmlns:w': 'http://schemas.openxmlformats.org/wordprocessingml/2006/main',\n        'xmlns:r': 'http://schemas.openxmlformats.org/officeDocument/2006/relationships',\n      },\n      children: footnotes.map((f) => f.toXML()),\n    };\n\n    // Build XML using XMLBuilder\n    const builder = new XMLBuilder();\n    builder.element(footnotesElement.name, footnotesElement.attributes, footnotesElement.children);\n    return builder.build(true);\n  }\n\n  /**\n   * Validates footnotes XML\n   * @param xml XML string to validate\n   * @returns True if valid\n   */\n  static validate(xml: string): boolean {\n    // Use XMLParser to extract root element\n    if (!xml) {\n      return false;\n    }\n\n    const footnotesContent = XMLParser.extractBetweenTags(xml, '<w:footnotes', '</w:footnotes>');\n    if (!footnotesContent) {\n      return false;\n    }\n\n    // Check for proper structure - namespace declaration\n    if (!xml.includes('xmlns:w=')) {\n      return false;\n    }\n\n    return true;\n  }\n}\n"]}
+{"version":3,"file":"FootnoteManager.js","sourceRoot":"","sources":["../../../src/elements/FootnoteManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * FootnoteManager - Manages footnotes in a document\n *\n * Handles creation, registration, and XML generation for footnotes.\n * Maintains unique IDs and proper ordering.\n */\n\nimport { Footnote, FootnoteType } from './Footnote.js';\nimport { XMLBuilder, XMLElement } from '../xml/XMLBuilder.js';\nimport { XMLParser } from '../xml/XMLParser.js';\n\n/**\n * Manages footnotes in a document\n */\nexport class FootnoteManager {\n  private footnotes = new Map<number, Footnote>();\n  private nextId = 1;\n\n  /**\n   * Creates a new FootnoteManager\n   * @private Use static factory method\n   */\n  private constructor() {\n    // Add special footnotes (separators) with negative IDs\n    this.addSpecialFootnotes();\n  }\n\n  /**\n   * Adds special footnotes (separator, continuation)\n   * These use negative IDs as per OOXML specification\n   */\n  private addSpecialFootnotes(): void {\n    // Separator footnote (ID -1)\n    const separator = Footnote.createSeparator(-1);\n    this.footnotes.set(-1, separator);\n\n    // Continuation separator (ID 0)\n    const continuationSep = Footnote.createContinuationSeparator(0);\n    this.footnotes.set(0, continuationSep);\n  }\n\n  /**\n   * Checks if a footnote is a special/system type (separator, continuationSeparator,\n   * continuationNotice) that should be preserved across clear() operations.\n   * Uses type-based detection rather than ID-based, because continuationNotice\n   * has a positive ID (typically 1) but is still a system footnote.\n   */\n  private isSpecialFootnote(footnote: Footnote): boolean {\n    const type = footnote.getType();\n    return (\n      type === FootnoteType.Separator ||\n      type === FootnoteType.ContinuationSeparator ||\n      type === FootnoteType.ContinuationNotice\n    );\n  }\n\n  /**\n   * Creates a new FootnoteManager instance\n   */\n  static create(): FootnoteManager {\n    return new FootnoteManager();\n  }\n\n  /**\n   * Registers a footnote\n   * @param footnote Footnote to register\n   * @returns The registered footnote\n   */\n  register(footnote: Footnote): Footnote {\n    const id = footnote.getId();\n\n    // Ensure ID is not already used (except for special footnotes)\n    if (id > 0 && this.footnotes.has(id)) {\n      throw new Error(`Footnote with ID ${id} already exists`);\n    }\n\n    this.footnotes.set(id, footnote);\n\n    // Update next ID if needed\n    if (id >= this.nextId) {\n      this.nextId = id + 1;\n    }\n\n    return footnote;\n  }\n\n  /**\n   * Creates and registers a new footnote\n   * @param text Footnote text\n   * @returns The created footnote\n   */\n  createFootnote(text: string): Footnote {\n    const footnote = Footnote.fromText(this.nextId++, text);\n    this.footnotes.set(footnote.getId(), footnote);\n    return footnote;\n  }\n\n  /**\n   * Gets a footnote by ID\n   * @param id Footnote ID\n   * @returns The footnote, or undefined if not found\n   */\n  getFootnote(id: number): Footnote | undefined {\n    return this.footnotes.get(id);\n  }\n\n  /**\n   * Gets all user footnotes (excluding special system types: separator,\n   * continuationSeparator, continuationNotice)\n   */\n  getAllFootnotes(): Footnote[] {\n    return Array.from(this.footnotes.values())\n      .filter((f) => !this.isSpecialFootnote(f))\n      .sort((a, b) => a.getId() - b.getId());\n  }\n\n  /**\n   * Gets all footnotes including special ones\n   */\n  getAllFootnotesWithSpecial(): Footnote[] {\n    return Array.from(this.footnotes.values()).sort((a, b) => a.getId() - b.getId());\n  }\n\n  /**\n   * Checks if a footnote exists\n   * @param id Footnote ID\n   */\n  hasFootnote(id: number): boolean {\n    return this.footnotes.has(id);\n  }\n\n  /**\n   * Removes a footnote from the model only. Does not touch body\n   * w:footnoteReference runs or the document's dirty flags — callers going\n   * through a Document should use Document.removeFootnote(), which also\n   * strips the matching references and forces footnotes.xml regeneration.\n   * @param id Footnote ID\n   * @returns True if removed, false if not found or if it's a special type\n   */\n  removeFootnote(id: number): boolean {\n    const footnote = this.footnotes.get(id);\n    if (!footnote || this.isSpecialFootnote(footnote)) {\n      return false;\n    }\n    return this.footnotes.delete(id);\n  }\n\n  /**\n   * Gets the next available ID\n   */\n  getNextId(): number {\n    return this.nextId;\n  }\n\n  /**\n   * Gets the count of footnotes (excluding special ones)\n   */\n  getCount(): number {\n    return this.getAllFootnotes().length;\n  }\n\n  /**\n   * Checks if there are any footnotes (excluding special ones)\n   */\n  isEmpty(): boolean {\n    return this.getCount() === 0;\n  }\n\n  /**\n   * Clears all user footnotes (preserves special system types: separator,\n   * continuationSeparator, continuationNotice)\n   */\n  clear(): void {\n    const specialFootnotes = new Map<number, Footnote>();\n    let maxSpecialId = 0;\n\n    for (const [id, footnote] of this.footnotes) {\n      if (this.isSpecialFootnote(footnote)) {\n        specialFootnotes.set(id, footnote);\n        if (id > maxSpecialId) {\n          maxSpecialId = id;\n        }\n      }\n    }\n\n    this.footnotes = specialFootnotes;\n    // Ensure nextId doesn't collide with special footnotes that have positive IDs\n    this.nextId = Math.max(maxSpecialId + 1, 1);\n  }\n\n  /**\n   * Gets statistics about footnotes\n   */\n  getStats(): {\n    total: number;\n    nextId: number;\n  } {\n    return {\n      total: this.getCount(),\n      nextId: this.nextId,\n    };\n  }\n\n  /**\n   * Generates the footnotes.xml content\n   */\n  generateFootnotesXml(): string {\n    const footnotes = this.getAllFootnotesWithSpecial();\n\n    // Build footnotes element\n    const footnotesElement: XMLElement = {\n      name: 'w:footnotes',\n      attributes: {\n        'xmlns:w': 'http://schemas.openxmlformats.org/wordprocessingml/2006/main',\n        'xmlns:r': 'http://schemas.openxmlformats.org/officeDocument/2006/relationships',\n      },\n      children: footnotes.map((f) => f.toXML()),\n    };\n\n    // Build XML using XMLBuilder\n    const builder = new XMLBuilder();\n    builder.element(footnotesElement.name, footnotesElement.attributes, footnotesElement.children);\n    return builder.build(true);\n  }\n\n  /**\n   * Validates footnotes XML\n   * @param xml XML string to validate\n   * @returns True if valid\n   */\n  static validate(xml: string): boolean {\n    // Use XMLParser to extract root element\n    if (!xml) {\n      return false;\n    }\n\n    const footnotesContent = XMLParser.extractBetweenTags(xml, '<w:footnotes', '</w:footnotes>');\n    if (!footnotesContent) {\n      return false;\n    }\n\n    // Check for proper structure - namespace declaration\n    if (!xml.includes('xmlns:w=')) {\n      return false;\n    }\n\n    return true;\n  }\n}\n"]}

package/dist/esm/elements/Header.js

@@ -1,3 +1,5 @@
+import { XMLBuilder } from '../xml/XMLBuilder.js';
+import { XMLParser } from '../xml/XMLParser.js';
 import { Paragraph } from './Paragraph.js';
 import { Table } from './Table.js';
 export class Header {
@@ -5,13 +7,35 @@ export class Header {
     type;
     headerId;
     rawXML;
+    rawXmlBlockCount = Number.MAX_SAFE_INTEGER;
     constructor(properties = {}) {
         this.type = properties.type || 'default';
     }
     setRawXML(xml) {
         this.rawXML = xml;
+        this.rawXmlBlockCount = Header.countTopLevelBlocks(xml);
         return this;
     }
+    static countTopLevelBlocks(xml) {
+        try {
+            const parsed = XMLParser.parseToObject(xml);
+            const root = parsed?.['w:hdr'];
+            if (!root || typeof root !== 'object') {
+                return 0;
+            }
+            const count = (node) => node === undefined ? 0 : Array.isArray(node) ? node.length : 1;
+            const rootObj = root;
+            return count(rootObj['w:p']) + count(rootObj['w:tbl']);
+        }
+        catch {
+            return Number.MAX_SAFE_INTEGER;
+        }
+    }
+    invalidateRawXmlOnGrowth() {
+        if (this.rawXML !== undefined && this.elements.length > this.rawXmlBlockCount) {
+            this.rawXML = undefined;
+        }
+    }
     getRawXML() {
         return this.rawXML;
     }
@@ -27,6 +51,7 @@ export class Header {
     }
     addParagraph(paragraph) {
         this.elements.push(paragraph);
+        this.invalidateRawXmlOnGrowth();
         return this;
     }
     createParagraph(text) {
@@ -35,21 +60,25 @@ export class Header {
             para.addText(text);
         }
         this.elements.push(para);
+        this.invalidateRawXmlOnGrowth();
         return para;
     }
     addText(text, formatting) {
         const para = new Paragraph();
         para.addText(text, formatting);
         this.elements.push(para);
+        this.invalidateRawXmlOnGrowth();
         return para;
     }
     addTable(table) {
         this.elements.push(table);
+        this.invalidateRawXmlOnGrowth();
         return this;
     }
     createTable(rows, columns) {
         const table = new Table(rows, columns);
         this.elements.push(table);
+        this.invalidateRawXmlOnGrowth();
         return table;
     }
     getElements() {
@@ -67,60 +96,17 @@ export class Header {
         if (this.rawXML) {
             return this.rawXML;
         }
-        const elementXmls = this.elements.map((el) => el.toXML());
-        let xml = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n';
-        xml += '<w:hdr xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main" ';
-        xml += 'xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">\n';
-        for (const element of elementXmls) {
-            xml += this.renderElement(element, 1);
-        }
-        if (this.elements.length === 0) {
-            xml += '  <w:p/>\n';
-        }
-        xml += '</w:hdr>';
-        return xml;
-    }
-    renderElement(element, indent) {
-        const spaces = '  '.repeat(indent);
-        let xml = '';
-        if (element.selfClosing) {
-            xml += `${spaces}<${element.name}`;
-            if (element.attributes) {
-                for (const [key, value] of Object.entries(element.attributes)) {
-                    xml += ` ${key}="${value}"`;
-                }
-            }
-            xml += '/>\n';
-        }
-        else {
-            xml += `${spaces}<${element.name}`;
-            if (element.attributes) {
-                for (const [key, value] of Object.entries(element.attributes)) {
-                    xml += ` ${key}="${value}"`;
-                }
-            }
-            xml += '>';
-            if (element.children && element.children.length > 0) {
-                const hasOnlyText = element.children.every((c) => typeof c === 'string');
-                if (hasOnlyText) {
-                    xml += element.children.join('');
-                }
-                else {
-                    xml += '\n';
-                    for (const child of element.children) {
-                        if (typeof child === 'string') {
-                            xml += spaces + '  ' + child + '\n';
-                        }
-                        else {
-                            xml += this.renderElement(child, indent + 1);
-                        }
-                    }
-                    xml += spaces;
-                }
-            }
-            xml += `</${element.name}>\n`;
+        const children = this.elements.map((el) => el.toXML());
+        if (children.length === 0) {
+            children.push(XMLBuilder.w('p'));
         }
-        return xml;
+        const namespaces = {
+            ...XMLBuilder.createNamespaces(),
+            'mc:Ignorable': 'w14 w15 wp14 asvg',
+        };
+        const builder = new XMLBuilder();
+        builder.element('w:hdr', namespaces, children);
+        return builder.build(true);
     }
     getFilename(number) {
         return `header${number}.xml`;

package/dist/esm/elements/Header.js.map

@@ -1 +1 @@
-{"version":3,"file":"Header.js","sourceRoot":"","sources":["../../../src/elements/Header.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Header - Represents a document header\n *\n * Headers appear at the top of pages and can contain text, tables, images, and fields.\n * Different headers can be defined for first page, odd pages, and even pages.\n */\n\nimport { XMLElement } from '../xml/XMLBuilder.js';\nimport { Paragraph } from './Paragraph.js';\nimport { RunFormatting } from './Run.js';\nimport { Table } from './Table.js';\n\n/**\n * Header type\n */\nexport type HeaderType = 'default' | 'first' | 'even';\n\n/**\n * Header content element\n */\ntype HeaderElement = Paragraph | Table;\n\n/**\n * Header properties\n */\nexport interface HeaderProperties {\n  /** Header type (default, first page, or even page) */\n  type?: HeaderType;\n}\n\n/**\n * Represents a document header\n */\nexport class Header {\n  private elements: HeaderElement[] = [];\n  private type: HeaderType;\n  private headerId?: string;\n  private rawXML?: string; // Store original XML for preservation\n\n  /**\n   * Creates a new header\n   * @param properties Header properties\n   */\n  constructor(properties: HeaderProperties = {}) {\n    this.type = properties.type || 'default';\n  }\n\n  /**\n   * Sets the raw XML content (used when loading existing headers)\n   * @param xml Raw XML content\n   */\n  setRawXML(xml: string): this {\n    this.rawXML = xml;\n    return this;\n  }\n\n  /**\n   * Gets the raw XML content if available\n   */\n  getRawXML(): string | undefined {\n    return this.rawXML;\n  }\n\n  /**\n   * Gets the header type\n   */\n  getType(): HeaderType {\n    return this.type;\n  }\n\n  /**\n   * Sets the header ID (used for relationships)\n   * @param id Header ID\n   */\n  setHeaderId(id: string): this {\n    this.headerId = id;\n    return this;\n  }\n\n  /**\n   * Gets the header ID\n   */\n  getHeaderId(): string | undefined {\n    return this.headerId;\n  }\n\n  /**\n   * Adds a paragraph to the header\n   * @param paragraph Paragraph to add\n   */\n  addParagraph(paragraph: Paragraph): this {\n    this.elements.push(paragraph);\n    return this;\n  }\n\n  /**\n   * Creates and adds a new paragraph\n   * @param text Optional text content\n   */\n  createParagraph(text?: string): Paragraph {\n    const para = new Paragraph();\n    if (text) {\n      para.addText(text);\n    }\n    this.elements.push(para);\n    return para;\n  }\n\n  /**\n   * Adds formatted text to the header as a new paragraph\n   *\n   * Convenience method that creates a paragraph with a single formatted run.\n   * For headers with multiple runs or complex content, use `createParagraph()`\n   * and build content manually.\n   *\n   * @param text - Text content\n   * @param formatting - Optional run formatting (bold, font, size, etc.)\n   * @returns The created Paragraph for further customization\n   *\n   * @example\n   * ```typescript\n   * header.addText('Company Name', { bold: true, font: 'Arial', size: 10 });\n   * header.addText('Confidential', { italic: true, color: 'FF0000' });\n   * ```\n   */\n  addText(text: string, formatting?: RunFormatting): Paragraph {\n    const para = new Paragraph();\n    para.addText(text, formatting);\n    this.elements.push(para);\n    return para;\n  }\n\n  /**\n   * Adds a table to the header\n   * @param table Table to add\n   */\n  addTable(table: Table): this {\n    this.elements.push(table);\n    return this;\n  }\n\n  /**\n   * Creates and adds a new table\n   * @param rows Number of rows\n   * @param columns Number of columns\n   */\n  createTable(rows: number, columns: number): Table {\n    const table = new Table(rows, columns);\n    this.elements.push(table);\n    return table;\n  }\n\n  /**\n   * Gets all elements in the header\n   */\n  getElements(): HeaderElement[] {\n    return [...this.elements];\n  }\n\n  /**\n   * Gets the number of elements\n   */\n  getElementCount(): number {\n    return this.elements.length;\n  }\n\n  /**\n   * Clears all elements and resets raw XML so toXML() regenerates an empty header\n   */\n  clear(): this {\n    this.elements = [];\n    this.rawXML = undefined;\n    return this;\n  }\n\n  /**\n   * Generates the complete header XML file content\n   * This creates a complete header document (header1.xml, etc.)\n   */\n  toXML(): string {\n    // If we have raw XML preserved from loading, use it\n    if (this.rawXML) {\n      return this.rawXML;\n    }\n\n    // Otherwise generate from elements\n    const elementXmls = this.elements.map((el) => el.toXML());\n\n    let xml = '<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\\n';\n    xml += '<w:hdr xmlns:w=\"http://schemas.openxmlformats.org/wordprocessingml/2006/main\" ';\n    xml += 'xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\">\\n';\n\n    // Add elements\n    for (const element of elementXmls) {\n      xml += this.renderElement(element, 1);\n    }\n\n    // If no elements, add an empty paragraph\n    if (this.elements.length === 0) {\n      xml += '  <w:p/>\\n';\n    }\n\n    xml += '</w:hdr>';\n\n    return xml;\n  }\n\n  /**\n   * Renders an XML element to string with indentation\n   */\n  private renderElement(element: XMLElement, indent: number): string {\n    const spaces = '  '.repeat(indent);\n    let xml = '';\n\n    if (element.selfClosing) {\n      xml += `${spaces}<${element.name}`;\n      if (element.attributes) {\n        for (const [key, value] of Object.entries(element.attributes)) {\n          xml += ` ${key}=\"${value}\"`;\n        }\n      }\n      xml += '/>\\n';\n    } else {\n      xml += `${spaces}<${element.name}`;\n      if (element.attributes) {\n        for (const [key, value] of Object.entries(element.attributes)) {\n          xml += ` ${key}=\"${value}\"`;\n        }\n      }\n      xml += '>';\n\n      if (element.children && element.children.length > 0) {\n        const hasOnlyText = element.children.every((c) => typeof c === 'string');\n\n        if (hasOnlyText) {\n          // Inline text content\n          xml += element.children.join('');\n        } else {\n          // Block-level children\n          xml += '\\n';\n          for (const child of element.children) {\n            if (typeof child === 'string') {\n              xml += spaces + '  ' + child + '\\n';\n            } else {\n              xml += this.renderElement(child, indent + 1);\n            }\n          }\n          xml += spaces;\n        }\n      }\n\n      xml += `</${element.name}>\\n`;\n    }\n\n    return xml;\n  }\n\n  /**\n   * Gets the filename for this header\n   * @param number Header number (1, 2, 3, etc.)\n   */\n  getFilename(number: number): string {\n    return `header${number}.xml`;\n  }\n\n  /**\n   * Creates a default header\n   */\n  static createDefault(): Header {\n    return new Header({ type: 'default' });\n  }\n\n  /**\n   * Creates a first page header\n   */\n  static createFirst(): Header {\n    return new Header({ type: 'first' });\n  }\n\n  /**\n   * Creates an even page header\n   */\n  static createEven(): Header {\n    return new Header({ type: 'even' });\n  }\n\n  /**\n   * Creates a header with properties\n   * @param properties Header properties\n   */\n  static create(properties?: HeaderProperties): Header {\n    return new Header(properties);\n  }\n}\n"]}
+{"version":3,"file":"Header.js","sourceRoot":"","sources":["../../../src/elements/Header.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Header - Represents a document header\n *\n * Headers appear at the top of pages and can contain text, tables, images, and fields.\n * Different headers can be defined for first page, odd pages, and even pages.\n */\n\nimport { XMLBuilder } from '../xml/XMLBuilder.js';\nimport { XMLParser } from '../xml/XMLParser.js';\nimport { Paragraph } from './Paragraph.js';\nimport { RunFormatting } from './Run.js';\nimport { Table } from './Table.js';\n\n/**\n * Header type\n */\nexport type HeaderType = 'default' | 'first' | 'even';\n\n/**\n * Header content element\n */\ntype HeaderElement = Paragraph | Table;\n\n/**\n * Header properties\n */\nexport interface HeaderProperties {\n  /** Header type (default, first page, or even page) */\n  type?: HeaderType;\n}\n\n/**\n * Represents a document header\n */\nexport class Header {\n  private elements: HeaderElement[] = [];\n  private type: HeaderType;\n  private headerId?: string;\n  private rawXML?: string; // Store original XML for preservation\n  // Top-level w:p/w:tbl count of the preserved raw XML. DocumentParser calls\n  // setRawXML() before repopulating elements from that same XML, so mutators\n  // can't simply clear rawXML — they would fire during parsing and lose the\n  // preserved bytes. Instead, growth beyond this count is the signal that\n  // content was added after load and the preserved XML is stale.\n  private rawXmlBlockCount = Number.MAX_SAFE_INTEGER;\n\n  /**\n   * Creates a new header\n   * @param properties Header properties\n   */\n  constructor(properties: HeaderProperties = {}) {\n    this.type = properties.type || 'default';\n  }\n\n  /**\n   * Sets the raw XML content (used when loading existing headers)\n   * @param xml Raw XML content\n   */\n  setRawXML(xml: string): this {\n    this.rawXML = xml;\n    this.rawXmlBlockCount = Header.countTopLevelBlocks(xml);\n    return this;\n  }\n\n  /**\n   * Counts the top-level w:p/w:tbl children of a raw header part.\n   * Parsing populates this.elements from exactly those blocks, so the count\n   * is the baseline against which mutators detect post-load additions.\n   */\n  private static countTopLevelBlocks(xml: string): number {\n    try {\n      const parsed = XMLParser.parseToObject(xml) as Record<string, unknown>;\n      const root = parsed?.['w:hdr'];\n      if (!root || typeof root !== 'object') {\n        return 0;\n      }\n      const count = (node: unknown): number =>\n        node === undefined ? 0 : Array.isArray(node) ? node.length : 1;\n      const rootObj = root as Record<string, unknown>;\n      return count(rootObj['w:p']) + count(rootObj['w:tbl']);\n    } catch {\n      // Unparseable part: never invalidate, keep the preserved bytes\n      return Number.MAX_SAFE_INTEGER;\n    }\n  }\n\n  /**\n   * Drops the preserved raw XML once content grows beyond what that XML\n   * already contains, so toXML() regenerates from elements and post-load\n   * edits are not silently discarded on save.\n   */\n  private invalidateRawXmlOnGrowth(): void {\n    if (this.rawXML !== undefined && this.elements.length > this.rawXmlBlockCount) {\n      this.rawXML = undefined;\n    }\n  }\n\n  /**\n   * Gets the raw XML content if available\n   */\n  getRawXML(): string | undefined {\n    return this.rawXML;\n  }\n\n  /**\n   * Gets the header type\n   */\n  getType(): HeaderType {\n    return this.type;\n  }\n\n  /**\n   * Sets the header ID (used for relationships)\n   * @param id Header ID\n   */\n  setHeaderId(id: string): this {\n    this.headerId = id;\n    return this;\n  }\n\n  /**\n   * Gets the header ID\n   */\n  getHeaderId(): string | undefined {\n    return this.headerId;\n  }\n\n  /**\n   * Adds a paragraph to the header\n   * @param paragraph Paragraph to add\n   */\n  addParagraph(paragraph: Paragraph): this {\n    this.elements.push(paragraph);\n    this.invalidateRawXmlOnGrowth();\n    return this;\n  }\n\n  /**\n   * Creates and adds a new paragraph\n   * @param text Optional text content\n   */\n  createParagraph(text?: string): Paragraph {\n    const para = new Paragraph();\n    if (text) {\n      para.addText(text);\n    }\n    this.elements.push(para);\n    this.invalidateRawXmlOnGrowth();\n    return para;\n  }\n\n  /**\n   * Adds formatted text to the header as a new paragraph\n   *\n   * Convenience method that creates a paragraph with a single formatted run.\n   * For headers with multiple runs or complex content, use `createParagraph()`\n   * and build content manually.\n   *\n   * @param text - Text content\n   * @param formatting - Optional run formatting (bold, font, size, etc.)\n   * @returns The created Paragraph for further customization\n   *\n   * @example\n   * ```typescript\n   * header.addText('Company Name', { bold: true, font: 'Arial', size: 10 });\n   * header.addText('Confidential', { italic: true, color: 'FF0000' });\n   * ```\n   */\n  addText(text: string, formatting?: RunFormatting): Paragraph {\n    const para = new Paragraph();\n    para.addText(text, formatting);\n    this.elements.push(para);\n    this.invalidateRawXmlOnGrowth();\n    return para;\n  }\n\n  /**\n   * Adds a table to the header\n   * @param table Table to add\n   */\n  addTable(table: Table): this {\n    this.elements.push(table);\n    this.invalidateRawXmlOnGrowth();\n    return this;\n  }\n\n  /**\n   * Creates and adds a new table\n   * @param rows Number of rows\n   * @param columns Number of columns\n   */\n  createTable(rows: number, columns: number): Table {\n    const table = new Table(rows, columns);\n    this.elements.push(table);\n    this.invalidateRawXmlOnGrowth();\n    return table;\n  }\n\n  /**\n   * Gets all elements in the header\n   */\n  getElements(): HeaderElement[] {\n    return [...this.elements];\n  }\n\n  /**\n   * Gets the number of elements\n   */\n  getElementCount(): number {\n    return this.elements.length;\n  }\n\n  /**\n   * Clears all elements and resets raw XML so toXML() regenerates an empty header\n   */\n  clear(): this {\n    this.elements = [];\n    this.rawXML = undefined;\n    return this;\n  }\n\n  /**\n   * Generates the complete header XML file content\n   * This creates a complete header document (header1.xml, etc.)\n   */\n  toXML(): string {\n    // If we have raw XML preserved from loading, use it\n    if (this.rawXML) {\n      return this.rawXML;\n    }\n\n    // Serialize through XMLBuilder so text and attribute values are\n    // XML-escaped and rawXml passthrough children are honored\n    const children = this.elements.map((el) => el.toXML());\n\n    // ECMA-376 requires block-level content in w:hdr\n    if (children.length === 0) {\n      children.push(XMLBuilder.w('p'));\n    }\n\n    const namespaces: Record<string, string> = {\n      ...XMLBuilder.createNamespaces(),\n      // Extension namespaces (w14:paraId etc. on regenerated paragraphs)\n      // must be declared ignorable or Word rejects the part\n      'mc:Ignorable': 'w14 w15 wp14 asvg',\n    };\n\n    const builder = new XMLBuilder();\n    builder.element('w:hdr', namespaces, children);\n    return builder.build(true);\n  }\n\n  /**\n   * Gets the filename for this header\n   * @param number Header number (1, 2, 3, etc.)\n   */\n  getFilename(number: number): string {\n    return `header${number}.xml`;\n  }\n\n  /**\n   * Creates a default header\n   */\n  static createDefault(): Header {\n    return new Header({ type: 'default' });\n  }\n\n  /**\n   * Creates a first page header\n   */\n  static createFirst(): Header {\n    return new Header({ type: 'first' });\n  }\n\n  /**\n   * Creates an even page header\n   */\n  static createEven(): Header {\n    return new Header({ type: 'even' });\n  }\n\n  /**\n   * Creates a header with properties\n   * @param properties Header properties\n   */\n  static create(properties?: HeaderProperties): Header {\n    return new Header(properties);\n  }\n}\n"]}

package/dist/esm/elements/HeaderFooterManager.js

@@ -9,13 +9,25 @@ export class HeaderFooterManager {
         this.nextHeaderNumber = 1;
         this.nextFooterNumber = 1;
     }
-    registerHeader(header, relationshipId) {
+    registerHeader(header, relationshipId, originalFilename) {
         const existing = this.headers.get(header);
         if (existing) {
             return existing.filename;
         }
-        const number = this.nextHeaderNumber++;
-        const filename = header.getFilename(number);
+        let number;
+        let filename;
+        if (originalFilename) {
+            filename = originalFilename;
+            const digits = /(\d+)\.xml$/i.exec(originalFilename)?.[1];
+            number = digits ? parseInt(digits, 10) : this.nextHeaderNumber;
+            if (number >= this.nextHeaderNumber) {
+                this.nextHeaderNumber = number + 1;
+            }
+        }
+        else {
+            number = this.nextHeaderNumber++;
+            filename = header.getFilename(number);
+        }
         header.setHeaderId(relationshipId);
         const entry = {
             header,
@@ -26,13 +38,25 @@ export class HeaderFooterManager {
         this.headers.set(header, entry);
         return filename;
     }
-    registerFooter(footer, relationshipId) {
+    registerFooter(footer, relationshipId, originalFilename) {
         const existing = this.footers.get(footer);
         if (existing) {
             return existing.filename;
         }
-        const number = this.nextFooterNumber++;
-        const filename = footer.getFilename(number);
+        let number;
+        let filename;
+        if (originalFilename) {
+            filename = originalFilename;
+            const digits = /(\d+)\.xml$/i.exec(originalFilename)?.[1];
+            number = digits ? parseInt(digits, 10) : this.nextFooterNumber;
+            if (number >= this.nextFooterNumber) {
+                this.nextFooterNumber = number + 1;
+            }
+        }
+        else {
+            number = this.nextFooterNumber++;
+            filename = footer.getFilename(number);
+        }
         footer.setFooterId(relationshipId);
         const entry = {
             footer,
@@ -43,6 +67,12 @@ export class HeaderFooterManager {
         this.footers.set(footer, entry);
         return filename;
     }
+    peekHeaderFilename(header) {
+        return this.headers.get(header)?.filename ?? header.getFilename(this.nextHeaderNumber);
+    }
+    peekFooterFilename(footer) {
+        return this.footers.get(footer)?.filename ?? footer.getFilename(this.nextFooterNumber);
+    }
     getHeaderFilename(header) {
         return this.headers.get(header)?.filename;
     }