docxmlater 10.4.0 → 11.0.4

package/dist/esm/elements/CustomXml.js

@@ -0,0 +1,19 @@
+export class CustomXmlBlock {
+    rawXml;
+    constructor(rawXml) {
+        this.rawXml = rawXml;
+    }
+    toXML() {
+        return {
+            name: '__rawXml',
+            rawXml: this.rawXml,
+        };
+    }
+    getRawXml() {
+        return this.rawXml;
+    }
+    getType() {
+        return 'customXmlBlock';
+    }
+}
+//# sourceMappingURL=CustomXml.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CustomXml.js","sourceRoot":"","sources":["../../../src/elements/CustomXml.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,cAAc;IACjB,MAAM,CAAS;IAEvB,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK;QACH,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;SACN,CAAC;IAClB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,OAAO;QACL,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF","sourcesContent":["/**\n * CustomXml - Represents w:customXml block and inline elements\n *\n * Per ECMA-376 Part 1 §17.5.1.6, custom XML elements carry a URI and element\n * name, wrapping block-level or inline content.\n *\n * Stored as raw XML for round-trip fidelity.\n */\n\nimport { XMLElement } from '../xml/XMLBuilder.js';\n\n/**\n * Block-level custom XML (w:customXml wrapping block content)\n */\nexport class CustomXmlBlock {\n  private rawXml: string;\n\n  constructor(rawXml: string) {\n    this.rawXml = rawXml;\n  }\n\n  toXML(): XMLElement {\n    return {\n      name: '__rawXml',\n      rawXml: this.rawXml,\n    } as XMLElement;\n  }\n\n  getRawXml(): string {\n    return this.rawXml;\n  }\n\n  getType(): string {\n    return 'customXmlBlock';\n  }\n}\n"]}

package/dist/esm/elements/Endnote.js

@@ -0,0 +1,107 @@
+import { Paragraph } from './Paragraph.js';
+import { XMLBuilder } from '../xml/XMLBuilder.js';
+export var EndnoteType;
+(function (EndnoteType) {
+    EndnoteType["Normal"] = "normal";
+    EndnoteType["Separator"] = "separator";
+    EndnoteType["ContinuationSeparator"] = "continuationSeparator";
+    EndnoteType["ContinuationNotice"] = "continuationNotice";
+})(EndnoteType || (EndnoteType = {}));
+export class Endnote {
+    id;
+    type;
+    customMark;
+    paragraphs = [];
+    constructor(properties) {
+        this.id = properties.id;
+        this.type = properties.type || EndnoteType.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 !== EndnoteType.Normal) {
+            attrs['w:type'] = this.type;
+        }
+        const children = [];
+        if (this.type === EndnoteType.Separator) {
+            children.push(XMLBuilder.w('p', undefined, [
+                XMLBuilder.w('r', undefined, [XMLBuilder.wSelf('separator')]),
+            ]));
+        }
+        else if (this.type === EndnoteType.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('endnote', attrs, children);
+    }
+    static fromText(id, text) {
+        const endnote = new Endnote({ id });
+        endnote.createParagraph(text);
+        return endnote;
+    }
+    static createSeparator(id) {
+        const endnote = new Endnote({
+            id,
+            type: EndnoteType.Separator,
+        });
+        endnote.createParagraph();
+        return endnote;
+    }
+    static createContinuationSeparator(id) {
+        return new Endnote({
+            id,
+            type: EndnoteType.ContinuationSeparator,
+        });
+    }
+    static createContinuationNotice(id, text = 'Continued...') {
+        const endnote = new Endnote({
+            id,
+            type: EndnoteType.ContinuationNotice,
+        });
+        endnote.createParagraph(text);
+        return endnote;
+    }
+}
+//# sourceMappingURL=Endnote.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Endnote.js","sourceRoot":"","sources":["../../../src/elements/Endnote.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Endnote - Represents an endnote in a Word document\n *\n * Endnotes appear at the end of the document or section and are referenced\n * within the document text via endnote references.\n */\n\nimport { Paragraph } from './Paragraph.js';\nimport { XMLBuilder, XMLElement } from '../xml/XMLBuilder.js';\n\n/**\n * Endnote type\n */\nexport enum EndnoteType {\n  /** Normal endnote */\n  Normal = 'normal',\n  /** Separator between document text and endnotes */\n  Separator = 'separator',\n  /** Continuation separator for endnotes that continue to next page */\n  ContinuationSeparator = 'continuationSeparator',\n  /** Continuation notice at bottom of page when endnotes continue */\n  ContinuationNotice = 'continuationNotice',\n}\n\n/**\n * Endnote properties\n */\nexport interface EndnoteProperties {\n  /** Endnote ID (required, must be unique) */\n  id: number;\n  /** Type of endnote */\n  type?: EndnoteType;\n  /** Custom mark/symbol (optional, otherwise uses numbering) */\n  customMark?: string;\n}\n\n/**\n * Represents an endnote in a document\n */\nexport class Endnote {\n  private id: number;\n  private type: EndnoteType;\n  private customMark?: string;\n  private paragraphs: Paragraph[] = [];\n\n  /**\n   * Creates a new endnote\n   * @param properties Endnote properties\n   */\n  constructor(properties: EndnoteProperties) {\n    this.id = properties.id;\n    this.type = properties.type || EndnoteType.Normal;\n    this.customMark = properties.customMark;\n  }\n\n  /**\n   * Gets the endnote ID\n   */\n  getId(): number {\n    return this.id;\n  }\n\n  /**\n   * Gets the endnote type\n   */\n  getType(): EndnoteType {\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 endnote\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 endnote\n   */\n  getParagraphs(): Paragraph[] {\n    return [...this.paragraphs];\n  }\n\n  /**\n   * Gets the text content of the endnote\n   */\n  getText(): string {\n    return this.paragraphs.map((p) => p.getText()).join('\\n');\n  }\n\n  /**\n   * Generates the XML for this endnote\n   */\n  toXML(): XMLElement {\n    const attrs: Record<string, any> = {\n      'w:id': this.id.toString(),\n    };\n\n    if (this.type !== EndnoteType.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 === EndnoteType.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 === EndnoteType.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('endnote', attrs, children);\n  }\n\n  /**\n   * Creates an endnote from text\n   * @param id Endnote ID\n   * @param text Text content\n   * @returns New endnote instance\n   */\n  static fromText(id: number, text: string): Endnote {\n    const endnote = new Endnote({ id });\n    endnote.createParagraph(text);\n    return endnote;\n  }\n\n  /**\n   * Creates a separator endnote\n   * @param id Endnote ID\n   * @returns New separator endnote\n   */\n  static createSeparator(id: number): Endnote {\n    const endnote = new Endnote({\n      id,\n      type: EndnoteType.Separator,\n    });\n    // Separator typically has a horizontal line\n    endnote.createParagraph();\n    // Add separator formatting if needed\n    return endnote;\n  }\n\n  /**\n   * Creates a continuation separator endnote\n   * @param id Endnote ID\n   * @returns New continuation separator endnote\n   */\n  static createContinuationSeparator(id: number): Endnote {\n    return new Endnote({\n      id,\n      type: EndnoteType.ContinuationSeparator,\n    });\n  }\n\n  /**\n   * Creates a continuation notice endnote\n   * @param id Endnote ID\n   * @param text Notice text (e.g., \"Continued on next page...\")\n   * @returns New continuation notice endnote\n   */\n  static createContinuationNotice(id: number, text = 'Continued...'): Endnote {\n    const endnote = new Endnote({\n      id,\n      type: EndnoteType.ContinuationNotice,\n    });\n    endnote.createParagraph(text);\n    return endnote;\n  }\n}\n"]}

package/dist/esm/elements/EndnoteManager.js

@@ -0,0 +1,119 @@
+import { Endnote, EndnoteType } from './Endnote.js';
+import { XMLBuilder } from '../xml/XMLBuilder.js';
+import { XMLParser } from '../xml/XMLParser.js';
+export class EndnoteManager {
+    endnotes = new Map();
+    nextId = 1;
+    constructor() {
+        this.addSpecialEndnotes();
+    }
+    addSpecialEndnotes() {
+        const separator = Endnote.createSeparator(-1);
+        this.endnotes.set(-1, separator);
+        const continuationSep = Endnote.createContinuationSeparator(0);
+        this.endnotes.set(0, continuationSep);
+    }
+    isSpecialEndnote(endnote) {
+        const type = endnote.getType();
+        return (type === EndnoteType.Separator ||
+            type === EndnoteType.ContinuationSeparator ||
+            type === EndnoteType.ContinuationNotice);
+    }
+    static create() {
+        return new EndnoteManager();
+    }
+    register(endnote) {
+        const id = endnote.getId();
+        if (id > 0 && this.endnotes.has(id)) {
+            throw new Error(`Endnote with ID ${id} already exists`);
+        }
+        this.endnotes.set(id, endnote);
+        if (id >= this.nextId) {
+            this.nextId = id + 1;
+        }
+        return endnote;
+    }
+    createEndnote(text) {
+        const endnote = Endnote.fromText(this.nextId++, text);
+        this.endnotes.set(endnote.getId(), endnote);
+        return endnote;
+    }
+    getEndnote(id) {
+        return this.endnotes.get(id);
+    }
+    getAllEndnotes() {
+        return Array.from(this.endnotes.values())
+            .filter((e) => !this.isSpecialEndnote(e))
+            .sort((a, b) => a.getId() - b.getId());
+    }
+    getAllEndnotesWithSpecial() {
+        return Array.from(this.endnotes.values()).sort((a, b) => a.getId() - b.getId());
+    }
+    hasEndnote(id) {
+        return this.endnotes.has(id);
+    }
+    removeEndnote(id) {
+        const endnote = this.endnotes.get(id);
+        if (!endnote || this.isSpecialEndnote(endnote)) {
+            return false;
+        }
+        return this.endnotes.delete(id);
+    }
+    getNextId() {
+        return this.nextId;
+    }
+    getCount() {
+        return this.getAllEndnotes().length;
+    }
+    isEmpty() {
+        return this.getCount() === 0;
+    }
+    clear() {
+        const specialEndnotes = new Map();
+        let maxSpecialId = 0;
+        for (const [id, endnote] of this.endnotes) {
+            if (this.isSpecialEndnote(endnote)) {
+                specialEndnotes.set(id, endnote);
+                if (id > maxSpecialId) {
+                    maxSpecialId = id;
+                }
+            }
+        }
+        this.endnotes = specialEndnotes;
+        this.nextId = Math.max(maxSpecialId + 1, 1);
+    }
+    getStats() {
+        return {
+            total: this.getCount(),
+            nextId: this.nextId,
+        };
+    }
+    generateEndnotesXml() {
+        const endnotes = this.getAllEndnotesWithSpecial();
+        const endnotesElement = {
+            name: 'w:endnotes',
+            attributes: {
+                'xmlns:w': 'http://schemas.openxmlformats.org/wordprocessingml/2006/main',
+                'xmlns:r': 'http://schemas.openxmlformats.org/officeDocument/2006/relationships',
+            },
+            children: endnotes.map((e) => e.toXML()),
+        };
+        const builder = new XMLBuilder();
+        builder.element(endnotesElement.name, endnotesElement.attributes, endnotesElement.children);
+        return builder.build(true);
+    }
+    static validate(xml) {
+        if (!xml) {
+            return false;
+        }
+        const endnotesContent = XMLParser.extractBetweenTags(xml, '<w:endnotes', '</w:endnotes>');
+        if (!endnotesContent) {
+            return false;
+        }
+        if (!xml.includes('xmlns:w=')) {
+            return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=EndnoteManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EndnoteManager.js","sourceRoot":"","sources":["../../../src/elements/EndnoteManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * EndnoteManager - Manages endnotes in a document\n *\n * Handles creation, registration, and XML generation for endnotes.\n * Maintains unique IDs and proper ordering.\n */\n\nimport { Endnote, EndnoteType } from './Endnote.js';\nimport { XMLBuilder, XMLElement } from '../xml/XMLBuilder.js';\nimport { XMLParser } from '../xml/XMLParser.js';\n\n/**\n * Manages endnotes in a document\n */\nexport class EndnoteManager {\n  private endnotes = new Map<number, Endnote>();\n  private nextId = 1;\n\n  /**\n   * Creates a new EndnoteManager\n   * @private Use static factory method\n   */\n  private constructor() {\n    // Add special endnotes (separators) with negative IDs\n    this.addSpecialEndnotes();\n  }\n\n  /**\n   * Adds special endnotes (separator, continuation)\n   * These use negative IDs as per OOXML specification\n   */\n  private addSpecialEndnotes(): void {\n    // Separator endnote (ID -1)\n    const separator = Endnote.createSeparator(-1);\n    this.endnotes.set(-1, separator);\n\n    // Continuation separator (ID 0)\n    const continuationSep = Endnote.createContinuationSeparator(0);\n    this.endnotes.set(0, continuationSep);\n  }\n\n  /**\n   * Checks if an endnote 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 endnote.\n   */\n  private isSpecialEndnote(endnote: Endnote): boolean {\n    const type = endnote.getType();\n    return (\n      type === EndnoteType.Separator ||\n      type === EndnoteType.ContinuationSeparator ||\n      type === EndnoteType.ContinuationNotice\n    );\n  }\n\n  /**\n   * Creates a new EndnoteManager instance\n   */\n  static create(): EndnoteManager {\n    return new EndnoteManager();\n  }\n\n  /**\n   * Registers an endnote\n   * @param endnote Endnote to register\n   * @returns The registered endnote\n   */\n  register(endnote: Endnote): Endnote {\n    const id = endnote.getId();\n\n    // Ensure ID is not already used (except for special endnotes)\n    if (id > 0 && this.endnotes.has(id)) {\n      throw new Error(`Endnote with ID ${id} already exists`);\n    }\n\n    this.endnotes.set(id, endnote);\n\n    // Update next ID if needed\n    if (id >= this.nextId) {\n      this.nextId = id + 1;\n    }\n\n    return endnote;\n  }\n\n  /**\n   * Creates and registers a new endnote\n   * @param text Endnote text\n   * @returns The created endnote\n   */\n  createEndnote(text: string): Endnote {\n    const endnote = Endnote.fromText(this.nextId++, text);\n    this.endnotes.set(endnote.getId(), endnote);\n    return endnote;\n  }\n\n  /**\n   * Gets an endnote by ID\n   * @param id Endnote ID\n   * @returns The endnote, or undefined if not found\n   */\n  getEndnote(id: number): Endnote | undefined {\n    return this.endnotes.get(id);\n  }\n\n  /**\n   * Gets all user endnotes (excluding special system types: separator,\n   * continuationSeparator, continuationNotice)\n   */\n  getAllEndnotes(): Endnote[] {\n    return Array.from(this.endnotes.values())\n      .filter((e) => !this.isSpecialEndnote(e))\n      .sort((a, b) => a.getId() - b.getId());\n  }\n\n  /**\n   * Gets all endnotes including special ones\n   */\n  getAllEndnotesWithSpecial(): Endnote[] {\n    return Array.from(this.endnotes.values()).sort((a, b) => a.getId() - b.getId());\n  }\n\n  /**\n   * Checks if an endnote exists\n   * @param id Endnote ID\n   */\n  hasEndnote(id: number): boolean {\n    return this.endnotes.has(id);\n  }\n\n  /**\n   * Removes an endnote\n   * @param id Endnote ID\n   * @returns True if removed, false if not found or if it's a special type\n   */\n  removeEndnote(id: number): boolean {\n    const endnote = this.endnotes.get(id);\n    if (!endnote || this.isSpecialEndnote(endnote)) {\n      return false;\n    }\n    return this.endnotes.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 endnotes (excluding special ones)\n   */\n  getCount(): number {\n    return this.getAllEndnotes().length;\n  }\n\n  /**\n   * Checks if there are any endnotes (excluding special ones)\n   */\n  isEmpty(): boolean {\n    return this.getCount() === 0;\n  }\n\n  /**\n   * Clears all user endnotes (preserves special system types: separator,\n   * continuationSeparator, continuationNotice)\n   */\n  clear(): void {\n    const specialEndnotes = new Map<number, Endnote>();\n    let maxSpecialId = 0;\n\n    for (const [id, endnote] of this.endnotes) {\n      if (this.isSpecialEndnote(endnote)) {\n        specialEndnotes.set(id, endnote);\n        if (id > maxSpecialId) {\n          maxSpecialId = id;\n        }\n      }\n    }\n\n    this.endnotes = specialEndnotes;\n    // Ensure nextId doesn't collide with special endnotes that have positive IDs\n    this.nextId = Math.max(maxSpecialId + 1, 1);\n  }\n\n  /**\n   * Gets statistics about endnotes\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 endnotes.xml content\n   */\n  generateEndnotesXml(): string {\n    const endnotes = this.getAllEndnotesWithSpecial();\n\n    // Build endnotes element\n    const endnotesElement: XMLElement = {\n      name: 'w:endnotes',\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: endnotes.map((e) => e.toXML()),\n    };\n\n    // Build XML using XMLBuilder\n    const builder = new XMLBuilder();\n    builder.element(endnotesElement.name, endnotesElement.attributes, endnotesElement.children);\n    return builder.build(true);\n  }\n\n  /**\n   * Validates endnotes 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 endnotesContent = XMLParser.extractBetweenTags(xml, '<w:endnotes', '</w:endnotes>');\n    if (!endnotesContent) {\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"]}