docxmlater 11.0.10 → 12.1.0

package/dist/elements/Footer.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Footer = void 0;
+const XMLBuilder_js_1 = require("../xml/XMLBuilder.js");
+const XMLParser_js_1 = require("../xml/XMLParser.js");
 const Paragraph_js_1 = require("./Paragraph.js");
 const Table_js_1 = require("./Table.js");
 class Footer {
@@ -8,13 +10,35 @@ 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_js_1.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;
     }
@@ -30,6 +54,7 @@ class Footer {
     }
     addParagraph(paragraph) {
         this.elements.push(paragraph);
+        this.invalidateRawXmlOnGrowth();
         return this;
     }
     createParagraph(text) {
@@ -38,21 +63,25 @@ class Footer {
             para.addText(text);
         }
         this.elements.push(para);
+        this.invalidateRawXmlOnGrowth();
         return para;
     }
     addText(text, formatting) {
         const para = new Paragraph_js_1.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_js_1.Table(rows, columns);
         this.elements.push(table);
+        this.invalidateRawXmlOnGrowth();
         return table;
     }
     getElements() {
@@ -70,60 +99,17 @@ 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_js_1.XMLBuilder.w('p'));
         }
-        return xml;
+        const namespaces = {
+            ...XMLBuilder_js_1.XMLBuilder.createNamespaces(),
+            'mc:Ignorable': 'w14 w15 wp14 asvg',
+        };
+        const builder = new XMLBuilder_js_1.XMLBuilder();
+        builder.element('w:ftr', namespaces, children);
+        return builder.build(true);
     }
     getFilename(number) {
         return `footer${number}.xml`;

package/dist/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/elements/FootnoteManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FootnoteManager.d.ts","sourceRoot":"","sources":["../../src/elements/FootnoteManager.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAgB,MAAM,eAAe,CAAC;AAOvD,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,MAAM,CAAK;IAMnB,OAAO;IASP,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,iBAAiB;IAYzB,MAAM,CAAC,MAAM,IAAI,eAAe;IAShC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAuBtC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAWtC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAQ7C,eAAe,IAAI,QAAQ,EAAE;IAS7B,0BAA0B,IAAI,QAAQ,EAAE;IAQxC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAShC,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAWnC,SAAS,IAAI,MAAM;IAOnB,QAAQ,IAAI,MAAM;IAOlB,OAAO,IAAI,OAAO;IAQlB,KAAK,IAAI,IAAI;IAqBb,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB;IAUD,oBAAoB,IAAI,MAAM;IAwB9B,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAkBtC"}
+{"version":3,"file":"FootnoteManager.d.ts","sourceRoot":"","sources":["../../src/elements/FootnoteManager.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAgB,MAAM,eAAe,CAAC;AAOvD,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,MAAM,CAAK;IAMnB,OAAO;IASP,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,iBAAiB;IAYzB,MAAM,CAAC,MAAM,IAAI,eAAe;IAShC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAuBtC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAWtC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAQ7C,eAAe,IAAI,QAAQ,EAAE;IAS7B,0BAA0B,IAAI,QAAQ,EAAE;IAQxC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAYhC,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAWnC,SAAS,IAAI,MAAM;IAOnB,QAAQ,IAAI,MAAM;IAOlB,OAAO,IAAI,OAAO;IAQlB,KAAK,IAAI,IAAI;IAqBb,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB;IAUD,oBAAoB,IAAI,MAAM;IAwB9B,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAkBtC"}

package/dist/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/elements/Header.d.ts

@@ -11,8 +11,11 @@ export declare class Header {
     private type;
     private headerId?;
     private rawXML?;
+    private rawXmlBlockCount;
     constructor(properties?: HeaderProperties);
     setRawXML(xml: string): this;
+    private static countTopLevelBlocks;
+    private invalidateRawXmlOnGrowth;
     getRawXML(): string | undefined;
     getType(): HeaderType;
     setHeaderId(id: string): this;
@@ -26,7 +29,6 @@ export declare class Header {
     getElementCount(): number;
     clear(): this;
     toXML(): string;
-    private renderElement;
     getFilename(number: number): string;
     static createDefault(): Header;
     static createFirst(): Header;

package/dist/elements/Header.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Header.d.ts","sourceRoot":"","sources":["../../src/elements/Header.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAKnC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAKtD,KAAK,aAAa,GAAG,SAAS,GAAG,KAAK,CAAC;AAKvC,MAAM,WAAW,gBAAgB;IAE/B,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAKD,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAS;gBAMZ,UAAU,GAAE,gBAAqB;IAQ7C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ5B,SAAS,IAAI,MAAM,GAAG,SAAS;IAO/B,OAAO,IAAI,UAAU;IAQrB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ7B,WAAW,IAAI,MAAM,GAAG,SAAS;IAQjC,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IASxC,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS;IA0BzC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,SAAS;IAW5D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAU5B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK;IASjD,WAAW,IAAI,aAAa,EAAE;IAO9B,eAAe,IAAI,MAAM;IAOzB,KAAK,IAAI,IAAI;IAUb,KAAK,IAAI,MAAM;IA+Bf,OAAO,CAAC,aAAa;IAmDrB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAOnC,MAAM,CAAC,aAAa,IAAI,MAAM;IAO9B,MAAM,CAAC,WAAW,IAAI,MAAM;IAO5B,MAAM,CAAC,UAAU,IAAI,MAAM;IAQ3B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,MAAM;CAGrD"}
+{"version":3,"file":"Header.d.ts","sourceRoot":"","sources":["../../src/elements/Header.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAKnC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAKtD,KAAK,aAAa,GAAG,SAAS,GAAG,KAAK,CAAC;AAKvC,MAAM,WAAW,gBAAgB;IAE/B,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAKD,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAS;IAMxB,OAAO,CAAC,gBAAgB,CAA2B;gBAMvC,UAAU,GAAE,gBAAqB;IAQ7C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAW5B,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAsBlC,OAAO,CAAC,wBAAwB;IAShC,SAAS,IAAI,MAAM,GAAG,SAAS;IAO/B,OAAO,IAAI,UAAU;IAQrB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ7B,WAAW,IAAI,MAAM,GAAG,SAAS;IAQjC,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAUxC,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS;IA2BzC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,SAAS;IAY5D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAW5B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK;IAUjD,WAAW,IAAI,aAAa,EAAE;IAO9B,eAAe,IAAI,MAAM;IAOzB,KAAK,IAAI,IAAI;IAUb,KAAK,IAAI,MAAM;IA+Bf,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAOnC,MAAM,CAAC,aAAa,IAAI,MAAM;IAO9B,MAAM,CAAC,WAAW,IAAI,MAAM;IAO5B,MAAM,CAAC,UAAU,IAAI,MAAM;IAQ3B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,MAAM;CAGrD"}

package/dist/elements/Header.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Header = void 0;
+const XMLBuilder_js_1 = require("../xml/XMLBuilder.js");
+const XMLParser_js_1 = require("../xml/XMLParser.js");
 const Paragraph_js_1 = require("./Paragraph.js");
 const Table_js_1 = require("./Table.js");
 class Header {
@@ -8,13 +10,35 @@ 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_js_1.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;
     }
@@ -30,6 +54,7 @@ class Header {
     }
     addParagraph(paragraph) {
         this.elements.push(paragraph);
+        this.invalidateRawXmlOnGrowth();
         return this;
     }
     createParagraph(text) {
@@ -38,21 +63,25 @@ class Header {
             para.addText(text);
         }
         this.elements.push(para);
+        this.invalidateRawXmlOnGrowth();
         return para;
     }
     addText(text, formatting) {
         const para = new Paragraph_js_1.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_js_1.Table(rows, columns);
         this.elements.push(table);
+        this.invalidateRawXmlOnGrowth();
         return table;
     }
     getElements() {
@@ -70,60 +99,17 @@ 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_js_1.XMLBuilder.w('p'));
         }
-        return xml;
+        const namespaces = {
+            ...XMLBuilder_js_1.XMLBuilder.createNamespaces(),
+            'mc:Ignorable': 'w14 w15 wp14 asvg',
+        };
+        const builder = new XMLBuilder_js_1.XMLBuilder();
+        builder.element('w:hdr', namespaces, children);
+        return builder.build(true);
     }
     getFilename(number) {
         return `header${number}.xml`;

package/dist/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":";;;AAOA,wDAAkD;AAClD,sDAAgD;AAChD,iDAA2C;AAE3C,yCAAmC;AAuBnC,MAAa,MAAM;IACT,QAAQ,GAAoB,EAAE,CAAC;IAC/B,IAAI,CAAa;IACjB,QAAQ,CAAU;IAClB,MAAM,CAAU;IAMhB,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAMnD,YAAY,aAA+B,EAAE;QAC3C,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,SAAS,CAAC;IAC3C,CAAC;IAMD,SAAS,CAAC,GAAW;QACnB,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;QAClB,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAOO,MAAM,CAAC,mBAAmB,CAAC,GAAW;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,wBAAS,CAAC,aAAa,CAAC,GAAG,CAA4B,CAAC;YACvE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtC,OAAO,CAAC,CAAC;YACX,CAAC;YACD,MAAM,KAAK,GAAG,CAAC,IAAa,EAAU,EAAE,CACtC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACjE,MAAM,OAAO,GAAG,IAA+B,CAAC;YAChD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YAEP,OAAO,MAAM,CAAC,gBAAgB,CAAC;QACjC,CAAC;IACH,CAAC;IAOO,wBAAwB;QAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC9E,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QAC1B,CAAC;IACH,CAAC;IAKD,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAKD,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAMD,WAAW,CAAC,EAAU;QACpB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAMD,YAAY,CAAC,SAAoB;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9B,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAMD,eAAe,CAAC,IAAa;QAC3B,MAAM,IAAI,GAAG,IAAI,wBAAS,EAAE,CAAC;QAC7B,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAmBD,OAAO,CAAC,IAAY,EAAE,UAA0B;QAC9C,MAAM,IAAI,GAAG,IAAI,wBAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAMD,QAAQ,CAAC,KAAY;QACnB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAOD,WAAW,CAAC,IAAY,EAAE,OAAe;QACvC,MAAM,KAAK,GAAG,IAAI,gBAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAKD,WAAW;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAKD,eAAe;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAKD,KAAK;QACH,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAMD,KAAK;QAEH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAID,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QAGvD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC,0BAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,UAAU,GAA2B;YACzC,GAAG,0BAAU,CAAC,gBAAgB,EAAE;YAGhC,cAAc,EAAE,mBAAmB;SACpC,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,0BAAU,EAAE,CAAC;QACjC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC/C,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAMD,WAAW,CAAC,MAAc;QACxB,OAAO,SAAS,MAAM,MAAM,CAAC;IAC/B,CAAC;IAKD,MAAM,CAAC,aAAa;QAClB,OAAO,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACzC,CAAC;IAKD,MAAM,CAAC,WAAW;QAChB,OAAO,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACvC,CAAC;IAKD,MAAM,CAAC,UAAU;QACf,OAAO,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC;IAMD,MAAM,CAAC,MAAM,CAAC,UAA6B;QACzC,OAAO,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;CACF;AA9PD,wBA8PC","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/elements/HeaderFooterManager.d.ts

@@ -18,8 +18,10 @@ export declare class HeaderFooterManager {
     private nextHeaderNumber;
     private nextFooterNumber;
     constructor();
-    registerHeader(header: Header, relationshipId: string): string;
-    registerFooter(footer: Footer, relationshipId: string): string;
+    registerHeader(header: Header, relationshipId: string, originalFilename?: string): string;
+    registerFooter(footer: Footer, relationshipId: string, originalFilename?: string): string;
+    peekHeaderFilename(header: Header): string;
+    peekFooterFilename(footer: Footer): string;
     getHeaderFilename(header: Header): string | undefined;
     getFooterFilename(footer: Footer): string | undefined;
     getHeaderRelationshipId(header: Header): string | undefined;

package/dist/elements/HeaderFooterManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HeaderFooterManager.d.ts","sourceRoot":"","sources":["../../src/elements/HeaderFooterManager.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAKrC,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAS;;IAkBjC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM;IAiC9D,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM;IAgC9D,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IASrD,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IASrD,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAS3D,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAQ3D,aAAa,IAAI,WAAW,EAAE;IAQ9B,aAAa,IAAI,WAAW,EAAE;IAQ9B,cAAc,IAAI,MAAM;IAQxB,cAAc,IAAI,MAAM;IASxB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IASlC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAOlC,KAAK,IAAI,IAAI;IAWb,MAAM,CAAC,MAAM,IAAI,mBAAmB;CAGrC"}
+{"version":3,"file":"HeaderFooterManager.d.ts","sourceRoot":"","sources":["../../src/elements/HeaderFooterManager.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAKrC,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAS;;IAoBjC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM;IA8CzF,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM;IA6CzF,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAW1C,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAS1C,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IASrD,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IASrD,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAS3D,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAQ3D,aAAa,IAAI,WAAW,EAAE;IAQ9B,aAAa,IAAI,WAAW,EAAE;IAQ9B,cAAc,IAAI,MAAM;IAQxB,cAAc,IAAI,MAAM;IASxB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IASlC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAOlC,KAAK,IAAI,IAAI;IAWb,MAAM,CAAC,MAAM,IAAI,mBAAmB;CAGrC"}

package/dist/elements/HeaderFooterManager.js

@@ -12,13 +12,25 @@ 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,
@@ -29,13 +41,25 @@ 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,
@@ -46,6 +70,12 @@ 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;
     }