docxmlater 10.4.0 → 11.0.4

package/dist/esm/elements/Footer.js

@@ -0,0 +1,141 @@
+import { Paragraph } from './Paragraph.js';
+import { Table } from './Table.js';
+export class Footer {
+    elements = [];
+    type;
+    footerId;
+    rawXML;
+    constructor(properties = {}) {
+        this.type = properties.type || 'default';
+    }
+    setRawXML(xml) {
+        this.rawXML = xml;
+        return this;
+    }
+    getRawXML() {
+        return this.rawXML;
+    }
+    getType() {
+        return this.type;
+    }
+    setFooterId(id) {
+        this.footerId = id;
+        return this;
+    }
+    getFooterId() {
+        return this.footerId;
+    }
+    addParagraph(paragraph) {
+        this.elements.push(paragraph);
+        return this;
+    }
+    createParagraph(text) {
+        const para = new Paragraph();
+        if (text) {
+            para.addText(text);
+        }
+        this.elements.push(para);
+        return para;
+    }
+    addText(text, formatting) {
+        const para = new Paragraph();
+        para.addText(text, formatting);
+        this.elements.push(para);
+        return para;
+    }
+    addTable(table) {
+        this.elements.push(table);
+        return this;
+    }
+    createTable(rows, columns) {
+        const table = new Table(rows, columns);
+        this.elements.push(table);
+        return table;
+    }
+    getElements() {
+        return [...this.elements];
+    }
+    getElementCount() {
+        return this.elements.length;
+    }
+    clear() {
+        this.elements = [];
+        this.rawXML = undefined;
+        return this;
+    }
+    toXML() {
+        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`;
+        }
+        return xml;
+    }
+    getFilename(number) {
+        return `footer${number}.xml`;
+    }
+    static createDefault() {
+        return new Footer({ type: 'default' });
+    }
+    static createFirst() {
+        return new Footer({ type: 'first' });
+    }
+    static createEven() {
+        return new Footer({ type: 'even' });
+    }
+    static create(properties) {
+        return new Footer(properties);
+    }
+}
+//# sourceMappingURL=Footer.js.map

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

@@ -0,0 +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"]}

package/dist/esm/elements/Footnote.js

@@ -0,0 +1,107 @@
+import { Paragraph } from './Paragraph.js';
+import { XMLBuilder } from '../xml/XMLBuilder.js';
+export var FootnoteType;
+(function (FootnoteType) {
+    FootnoteType["Normal"] = "normal";
+    FootnoteType["Separator"] = "separator";
+    FootnoteType["ContinuationSeparator"] = "continuationSeparator";
+    FootnoteType["ContinuationNotice"] = "continuationNotice";
+})(FootnoteType || (FootnoteType = {}));
+export class Footnote {
+    id;
+    type;
+    customMark;
+    paragraphs = [];
+    constructor(properties) {
+        this.id = properties.id;
+        this.type = properties.type || FootnoteType.Normal;
+        this.customMark = properties.customMark;
+    }
+    getId() {
+        return this.id;
+    }
+    getType() {
+        return this.type;
+    }
+    getCustomMark() {
+        return this.customMark;
+    }
+    setCustomMark(mark) {
+        this.customMark = mark;
+        return this;
+    }
+    addParagraph(paragraph) {
+        this.paragraphs.push(paragraph);
+        return this;
+    }
+    createParagraph(text) {
+        const para = new Paragraph();
+        if (text) {
+            para.addText(text);
+        }
+        this.paragraphs.push(para);
+        return para;
+    }
+    getParagraphs() {
+        return [...this.paragraphs];
+    }
+    getText() {
+        return this.paragraphs.map((p) => p.getText()).join('\n');
+    }
+    toXML() {
+        const attrs = {
+            'w:id': this.id.toString(),
+        };
+        if (this.type !== FootnoteType.Normal) {
+            attrs['w:type'] = this.type;
+        }
+        const children = [];
+        if (this.type === FootnoteType.Separator) {
+            children.push(XMLBuilder.w('p', undefined, [
+                XMLBuilder.w('r', undefined, [XMLBuilder.wSelf('separator')]),
+            ]));
+        }
+        else if (this.type === FootnoteType.ContinuationSeparator) {
+            children.push(XMLBuilder.w('p', undefined, [
+                XMLBuilder.w('r', undefined, [XMLBuilder.wSelf('continuationSeparator')]),
+            ]));
+        }
+        else {
+            for (const para of this.paragraphs) {
+                children.push(para.toXML());
+            }
+            if (children.length === 0) {
+                children.push(XMLBuilder.w('p'));
+            }
+        }
+        return XMLBuilder.w('footnote', attrs, children);
+    }
+    static fromText(id, text) {
+        const footnote = new Footnote({ id });
+        footnote.createParagraph(text);
+        return footnote;
+    }
+    static createSeparator(id) {
+        const footnote = new Footnote({
+            id,
+            type: FootnoteType.Separator,
+        });
+        footnote.createParagraph();
+        return footnote;
+    }
+    static createContinuationSeparator(id) {
+        return new Footnote({
+            id,
+            type: FootnoteType.ContinuationSeparator,
+        });
+    }
+    static createContinuationNotice(id, text = 'Continued...') {
+        const footnote = new Footnote({
+            id,
+            type: FootnoteType.ContinuationNotice,
+        });
+        footnote.createParagraph(text);
+        return footnote;
+    }
+}
+//# sourceMappingURL=Footnote.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Footnote.js","sourceRoot":"","sources":["../../../src/elements/Footnote.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAc,MAAM,sBAAsB,CAAC;AAK9D,MAAM,CAAN,IAAY,YASX;AATD,WAAY,YAAY;IAEtB,iCAAiB,CAAA;IAEjB,uCAAuB,CAAA;IAEvB,+DAA+C,CAAA;IAE/C,yDAAyC,CAAA;AAC3C,CAAC,EATW,YAAY,KAAZ,YAAY,QASvB;AAiBD,MAAM,OAAO,QAAQ;IACX,EAAE,CAAS;IACX,IAAI,CAAe;IACnB,UAAU,CAAU;IACpB,UAAU,GAAgB,EAAE,CAAC;IAMrC,YAAY,UAA8B;QACxC,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,YAAY,CAAC,MAAM,CAAC;QACnD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;IAC1C,CAAC;IAKD,KAAK;QACH,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAKD,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAKD,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAMD,aAAa,CAAC,IAAY;QACxB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAMD,YAAY,CAAC,SAAoB;QAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAOD,eAAe,CAAC,IAAa;QAC3B,MAAM,IAAI,GAAG,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,aAAa;QACX,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAKD,OAAO;QACL,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAKD,KAAK;QACH,MAAM,KAAK,GAAwB;YACjC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE;SAC3B,CAAC;QAEF,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,MAAM,EAAE,CAAC;YACtC,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAC9B,CAAC;QAED,MAAM,QAAQ,GAAiB,EAAE,CAAC;QAGlC,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,SAAS,EAAE,CAAC;YAEzC,QAAQ,CAAC,IAAI,CACX,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE;gBAC3B,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;aAC9D,CAAC,CACH,CAAC;QACJ,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,qBAAqB,EAAE,CAAC;YAE5D,QAAQ,CAAC,IAAI,CACX,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE;gBAC3B,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;aAC1E,CAAC,CACH,CAAC;QACJ,CAAC;aAAM,CAAC;YAEN,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACnC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9B,CAAC;YAGD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAQD,MAAM,CAAC,QAAQ,CAAC,EAAU,EAAE,IAAY;QACtC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACtC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAOD,MAAM,CAAC,eAAe,CAAC,EAAU;QAC/B,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC;YAC5B,EAAE;YACF,IAAI,EAAE,YAAY,CAAC,SAAS;SAC7B,CAAC,CAAC;QAEH,QAAQ,CAAC,eAAe,EAAE,CAAC;QAE3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAOD,MAAM,CAAC,2BAA2B,CAAC,EAAU;QAC3C,OAAO,IAAI,QAAQ,CAAC;YAClB,EAAE;YACF,IAAI,EAAE,YAAY,CAAC,qBAAqB;SACzC,CAAC,CAAC;IACL,CAAC;IAQD,MAAM,CAAC,wBAAwB,CAAC,EAAU,EAAE,IAAI,GAAG,cAAc;QAC/D,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC;YAC5B,EAAE;YACF,IAAI,EAAE,YAAY,CAAC,kBAAkB;SACtC,CAAC,CAAC;QACH,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF","sourcesContent":["/**\n * Footnote - Represents a footnote in a Word document\n *\n * Footnotes appear at the bottom of the page and are referenced\n * within the document text via footnote references.\n */\n\nimport { Paragraph } from './Paragraph.js';\nimport { XMLBuilder, XMLElement } from '../xml/XMLBuilder.js';\n\n/**\n * Footnote type\n */\nexport enum FootnoteType {\n  /** Normal footnote */\n  Normal = 'normal',\n  /** Separator between document text and footnotes */\n  Separator = 'separator',\n  /** Continuation separator for footnotes that continue to next page */\n  ContinuationSeparator = 'continuationSeparator',\n  /** Continuation notice at bottom of page when footnotes continue */\n  ContinuationNotice = 'continuationNotice',\n}\n\n/**\n * Footnote properties\n */\nexport interface FootnoteProperties {\n  /** Footnote ID (required, must be unique) */\n  id: number;\n  /** Type of footnote */\n  type?: FootnoteType;\n  /** Custom mark/symbol (optional, otherwise uses numbering) */\n  customMark?: string;\n}\n\n/**\n * Represents a footnote in a document\n */\nexport class Footnote {\n  private id: number;\n  private type: FootnoteType;\n  private customMark?: string;\n  private paragraphs: Paragraph[] = [];\n\n  /**\n   * Creates a new footnote\n   * @param properties Footnote properties\n   */\n  constructor(properties: FootnoteProperties) {\n    this.id = properties.id;\n    this.type = properties.type || FootnoteType.Normal;\n    this.customMark = properties.customMark;\n  }\n\n  /**\n   * Gets the footnote ID\n   */\n  getId(): number {\n    return this.id;\n  }\n\n  /**\n   * Gets the footnote type\n   */\n  getType(): FootnoteType {\n    return this.type;\n  }\n\n  /**\n   * Gets the custom mark\n   */\n  getCustomMark(): string | undefined {\n    return this.customMark;\n  }\n\n  /**\n   * Sets the custom mark\n   * @param mark Custom mark/symbol\n   */\n  setCustomMark(mark: string): this {\n    this.customMark = mark;\n    return this;\n  }\n\n  /**\n   * Adds a paragraph to the footnote\n   * @param paragraph Paragraph to add\n   */\n  addParagraph(paragraph: Paragraph): this {\n    this.paragraphs.push(paragraph);\n    return this;\n  }\n\n  /**\n   * Creates and adds a new paragraph\n   * @param text Optional text content\n   * @returns The created paragraph\n   */\n  createParagraph(text?: string): Paragraph {\n    const para = new Paragraph();\n    if (text) {\n      para.addText(text);\n    }\n    this.paragraphs.push(para);\n    return para;\n  }\n\n  /**\n   * Gets all paragraphs in the footnote\n   */\n  getParagraphs(): Paragraph[] {\n    return [...this.paragraphs];\n  }\n\n  /**\n   * Gets the text content of the footnote\n   */\n  getText(): string {\n    return this.paragraphs.map((p) => p.getText()).join('\\n');\n  }\n\n  /**\n   * Generates the XML for this footnote\n   */\n  toXML(): XMLElement {\n    const attrs: Record<string, any> = {\n      'w:id': this.id.toString(),\n    };\n\n    if (this.type !== FootnoteType.Normal) {\n      attrs['w:type'] = this.type;\n    }\n\n    const children: XMLElement[] = [];\n\n    // Separator types require specific child elements per ECMA-376\n    if (this.type === FootnoteType.Separator) {\n      // <w:p><w:r><w:separator/></w:r></w:p>\n      children.push(\n        XMLBuilder.w('p', undefined, [\n          XMLBuilder.w('r', undefined, [XMLBuilder.wSelf('separator')]),\n        ])\n      );\n    } else if (this.type === FootnoteType.ContinuationSeparator) {\n      // <w:p><w:r><w:continuationSeparator/></w:r></w:p>\n      children.push(\n        XMLBuilder.w('p', undefined, [\n          XMLBuilder.w('r', undefined, [XMLBuilder.wSelf('continuationSeparator')]),\n        ])\n      );\n    } else {\n      // Add paragraphs\n      for (const para of this.paragraphs) {\n        children.push(para.toXML());\n      }\n\n      // If no paragraphs, add an empty one (required)\n      if (children.length === 0) {\n        children.push(XMLBuilder.w('p'));\n      }\n    }\n\n    return XMLBuilder.w('footnote', attrs, children);\n  }\n\n  /**\n   * Creates a footnote from text\n   * @param id Footnote ID\n   * @param text Text content\n   * @returns New footnote instance\n   */\n  static fromText(id: number, text: string): Footnote {\n    const footnote = new Footnote({ id });\n    footnote.createParagraph(text);\n    return footnote;\n  }\n\n  /**\n   * Creates a separator footnote\n   * @param id Footnote ID\n   * @returns New separator footnote\n   */\n  static createSeparator(id: number): Footnote {\n    const footnote = new Footnote({\n      id,\n      type: FootnoteType.Separator,\n    });\n    // Separator typically has a horizontal line\n    footnote.createParagraph();\n    // Add separator formatting if needed\n    return footnote;\n  }\n\n  /**\n   * Creates a continuation separator footnote\n   * @param id Footnote ID\n   * @returns New continuation separator footnote\n   */\n  static createContinuationSeparator(id: number): Footnote {\n    return new Footnote({\n      id,\n      type: FootnoteType.ContinuationSeparator,\n    });\n  }\n\n  /**\n   * Creates a continuation notice footnote\n   * @param id Footnote ID\n   * @param text Notice text (e.g., \"Continued on next page...\")\n   * @returns New continuation notice footnote\n   */\n  static createContinuationNotice(id: number, text = 'Continued...'): Footnote {\n    const footnote = new Footnote({\n      id,\n      type: FootnoteType.ContinuationNotice,\n    });\n    footnote.createParagraph(text);\n    return footnote;\n  }\n}\n"]}

package/dist/esm/elements/FootnoteManager.js

@@ -0,0 +1,119 @@
+import { Footnote, FootnoteType } from './Footnote.js';
+import { XMLBuilder } from '../xml/XMLBuilder.js';
+import { XMLParser } from '../xml/XMLParser.js';
+export class FootnoteManager {
+    footnotes = new Map();
+    nextId = 1;
+    constructor() {
+        this.addSpecialFootnotes();
+    }
+    addSpecialFootnotes() {
+        const separator = Footnote.createSeparator(-1);
+        this.footnotes.set(-1, separator);
+        const continuationSep = Footnote.createContinuationSeparator(0);
+        this.footnotes.set(0, continuationSep);
+    }
+    isSpecialFootnote(footnote) {
+        const type = footnote.getType();
+        return (type === FootnoteType.Separator ||
+            type === FootnoteType.ContinuationSeparator ||
+            type === FootnoteType.ContinuationNotice);
+    }
+    static create() {
+        return new FootnoteManager();
+    }
+    register(footnote) {
+        const id = footnote.getId();
+        if (id > 0 && this.footnotes.has(id)) {
+            throw new Error(`Footnote with ID ${id} already exists`);
+        }
+        this.footnotes.set(id, footnote);
+        if (id >= this.nextId) {
+            this.nextId = id + 1;
+        }
+        return footnote;
+    }
+    createFootnote(text) {
+        const footnote = Footnote.fromText(this.nextId++, text);
+        this.footnotes.set(footnote.getId(), footnote);
+        return footnote;
+    }
+    getFootnote(id) {
+        return this.footnotes.get(id);
+    }
+    getAllFootnotes() {
+        return Array.from(this.footnotes.values())
+            .filter((f) => !this.isSpecialFootnote(f))
+            .sort((a, b) => a.getId() - b.getId());
+    }
+    getAllFootnotesWithSpecial() {
+        return Array.from(this.footnotes.values()).sort((a, b) => a.getId() - b.getId());
+    }
+    hasFootnote(id) {
+        return this.footnotes.has(id);
+    }
+    removeFootnote(id) {
+        const footnote = this.footnotes.get(id);
+        if (!footnote || this.isSpecialFootnote(footnote)) {
+            return false;
+        }
+        return this.footnotes.delete(id);
+    }
+    getNextId() {
+        return this.nextId;
+    }
+    getCount() {
+        return this.getAllFootnotes().length;
+    }
+    isEmpty() {
+        return this.getCount() === 0;
+    }
+    clear() {
+        const specialFootnotes = new Map();
+        let maxSpecialId = 0;
+        for (const [id, footnote] of this.footnotes) {
+            if (this.isSpecialFootnote(footnote)) {
+                specialFootnotes.set(id, footnote);
+                if (id > maxSpecialId) {
+                    maxSpecialId = id;
+                }
+            }
+        }
+        this.footnotes = specialFootnotes;
+        this.nextId = Math.max(maxSpecialId + 1, 1);
+    }
+    getStats() {
+        return {
+            total: this.getCount(),
+            nextId: this.nextId,
+        };
+    }
+    generateFootnotesXml() {
+        const footnotes = this.getAllFootnotesWithSpecial();
+        const footnotesElement = {
+            name: 'w:footnotes',
+            attributes: {
+                'xmlns:w': 'http://schemas.openxmlformats.org/wordprocessingml/2006/main',
+                'xmlns:r': 'http://schemas.openxmlformats.org/officeDocument/2006/relationships',
+            },
+            children: footnotes.map((f) => f.toXML()),
+        };
+        const builder = new XMLBuilder();
+        builder.element(footnotesElement.name, footnotesElement.attributes, footnotesElement.children);
+        return builder.build(true);
+    }
+    static validate(xml) {
+        if (!xml) {
+            return false;
+        }
+        const footnotesContent = XMLParser.extractBetweenTags(xml, '<w:footnotes', '</w:footnotes>');
+        if (!footnotesContent) {
+            return false;
+        }
+        if (!xml.includes('xmlns:w=')) {
+            return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=FootnoteManager.js.map

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

@@ -0,0 +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"]}

package/dist/esm/elements/Header.js

@@ -0,0 +1,141 @@
+import { Paragraph } from './Paragraph.js';
+import { Table } from './Table.js';
+export class Header {
+    elements = [];
+    type;
+    headerId;
+    rawXML;
+    constructor(properties = {}) {
+        this.type = properties.type || 'default';
+    }
+    setRawXML(xml) {
+        this.rawXML = xml;
+        return this;
+    }
+    getRawXML() {
+        return this.rawXML;
+    }
+    getType() {
+        return this.type;
+    }
+    setHeaderId(id) {
+        this.headerId = id;
+        return this;
+    }
+    getHeaderId() {
+        return this.headerId;
+    }
+    addParagraph(paragraph) {
+        this.elements.push(paragraph);
+        return this;
+    }
+    createParagraph(text) {
+        const para = new Paragraph();
+        if (text) {
+            para.addText(text);
+        }
+        this.elements.push(para);
+        return para;
+    }
+    addText(text, formatting) {
+        const para = new Paragraph();
+        para.addText(text, formatting);
+        this.elements.push(para);
+        return para;
+    }
+    addTable(table) {
+        this.elements.push(table);
+        return this;
+    }
+    createTable(rows, columns) {
+        const table = new Table(rows, columns);
+        this.elements.push(table);
+        return table;
+    }
+    getElements() {
+        return [...this.elements];
+    }
+    getElementCount() {
+        return this.elements.length;
+    }
+    clear() {
+        this.elements = [];
+        this.rawXML = undefined;
+        return this;
+    }
+    toXML() {
+        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`;
+        }
+        return xml;
+    }
+    getFilename(number) {
+        return `header${number}.xml`;
+    }
+    static createDefault() {
+        return new Header({ type: 'default' });
+    }
+    static createFirst() {
+        return new Header({ type: 'first' });
+    }
+    static createEven() {
+        return new Header({ type: 'even' });
+    }
+    static create(properties) {
+        return new Header(properties);
+    }
+}
+//# sourceMappingURL=Header.js.map

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

@@ -0,0 +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"]}