docxmlater 11.0.10 → 12.1.0

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

@@ -1 +1 @@
-{"version":3,"file":"HeaderFooterManager.js","sourceRoot":"","sources":["../../../src/elements/HeaderFooterManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * HeaderFooterManager - Manages headers and footers in a document\n *\n * Tracks all headers and footers, assigns unique IDs, generates filenames,\n * and manages relationships.\n */\n\nimport { Header } from './Header.js';\nimport { Footer } from './Footer.js';\n\n/**\n * Header entry with metadata\n */\ninterface HeaderEntry {\n  header: Header;\n  filename: string;\n  relationshipId: string;\n  number: number;\n}\n\n/**\n * Footer entry with metadata\n */\ninterface FooterEntry {\n  footer: Footer;\n  filename: string;\n  relationshipId: string;\n  number: number;\n}\n\n/**\n * Manages all headers and footers in a document\n */\nexport class HeaderFooterManager {\n  private headers: Map<Header, HeaderEntry>;\n  private footers: Map<Footer, FooterEntry>;\n  private nextHeaderNumber: number;\n  private nextFooterNumber: number;\n\n  /**\n   * Creates a new header/footer manager\n   */\n  constructor() {\n    this.headers = new Map();\n    this.footers = new Map();\n    this.nextHeaderNumber = 1;\n    this.nextFooterNumber = 1;\n  }\n\n  /**\n   * Registers a header with the manager\n   * @param header The header to register\n   * @param relationshipId The relationship ID for this header\n   * @returns The filename assigned to this header\n   */\n  registerHeader(header: Header, relationshipId: string): string {\n    // Check if already registered\n    const existing = this.headers.get(header);\n    if (existing) {\n      return existing.filename;\n    }\n\n    // Generate filename\n    const number = this.nextHeaderNumber++;\n    const filename = header.getFilename(number);\n\n    // Set header ID\n    header.setHeaderId(relationshipId);\n\n    // Store entry\n    const entry: HeaderEntry = {\n      header,\n      filename,\n      relationshipId,\n      number,\n    };\n\n    this.headers.set(header, entry);\n\n    return filename;\n  }\n\n  /**\n   * Registers a footer with the manager\n   * @param footer The footer to register\n   * @param relationshipId The relationship ID for this footer\n   * @returns The filename assigned to this footer\n   */\n  registerFooter(footer: Footer, relationshipId: string): string {\n    // Check if already registered\n    const existing = this.footers.get(footer);\n    if (existing) {\n      return existing.filename;\n    }\n\n    // Generate filename\n    const number = this.nextFooterNumber++;\n    const filename = footer.getFilename(number);\n\n    // Set footer ID\n    footer.setFooterId(relationshipId);\n\n    // Store entry\n    const entry: FooterEntry = {\n      footer,\n      filename,\n      relationshipId,\n      number,\n    };\n\n    this.footers.set(footer, entry);\n\n    return filename;\n  }\n\n  /**\n   * Gets the filename for a header\n   * @param header The header\n   * @returns The filename, or undefined if not registered\n   */\n  getHeaderFilename(header: Header): string | undefined {\n    return this.headers.get(header)?.filename;\n  }\n\n  /**\n   * Gets the filename for a footer\n   * @param footer The footer\n   * @returns The filename, or undefined if not registered\n   */\n  getFooterFilename(footer: Footer): string | undefined {\n    return this.footers.get(footer)?.filename;\n  }\n\n  /**\n   * Gets the relationship ID for a header\n   * @param header The header\n   * @returns The relationship ID, or undefined if not registered\n   */\n  getHeaderRelationshipId(header: Header): string | undefined {\n    return this.headers.get(header)?.relationshipId;\n  }\n\n  /**\n   * Gets the relationship ID for a footer\n   * @param footer The footer\n   * @returns The relationship ID, or undefined if not registered\n   */\n  getFooterRelationshipId(footer: Footer): string | undefined {\n    return this.footers.get(footer)?.relationshipId;\n  }\n\n  /**\n   * Gets all registered headers\n   * @returns Array of header entries\n   */\n  getAllHeaders(): HeaderEntry[] {\n    return Array.from(this.headers.values());\n  }\n\n  /**\n   * Gets all registered footers\n   * @returns Array of footer entries\n   */\n  getAllFooters(): FooterEntry[] {\n    return Array.from(this.footers.values());\n  }\n\n  /**\n   * Gets the number of headers\n   * @returns Number of registered headers\n   */\n  getHeaderCount(): number {\n    return this.headers.size;\n  }\n\n  /**\n   * Gets the number of footers\n   * @returns Number of registered footers\n   */\n  getFooterCount(): number {\n    return this.footers.size;\n  }\n\n  /**\n   * Checks if a header is registered\n   * @param header The header\n   * @returns True if registered\n   */\n  hasHeader(header: Header): boolean {\n    return this.headers.has(header);\n  }\n\n  /**\n   * Checks if a footer is registered\n   * @param footer The footer\n   * @returns True if registered\n   */\n  hasFooter(footer: Footer): boolean {\n    return this.footers.has(footer);\n  }\n\n  /**\n   * Clears all headers and footers\n   */\n  clear(): this {\n    this.headers.clear();\n    this.footers.clear();\n    this.nextHeaderNumber = 1;\n    this.nextFooterNumber = 1;\n    return this;\n  }\n\n  /**\n   * Creates a new header/footer manager\n   */\n  static create(): HeaderFooterManager {\n    return new HeaderFooterManager();\n  }\n}\n"]}
+{"version":3,"file":"HeaderFooterManager.js","sourceRoot":"","sources":["../../../src/elements/HeaderFooterManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * HeaderFooterManager - Manages headers and footers in a document\n *\n * Tracks all headers and footers, assigns unique IDs, generates filenames,\n * and manages relationships.\n */\n\nimport { Header } from './Header.js';\nimport { Footer } from './Footer.js';\n\n/**\n * Header entry with metadata\n */\ninterface HeaderEntry {\n  header: Header;\n  filename: string;\n  relationshipId: string;\n  number: number;\n}\n\n/**\n * Footer entry with metadata\n */\ninterface FooterEntry {\n  footer: Footer;\n  filename: string;\n  relationshipId: string;\n  number: number;\n}\n\n/**\n * Manages all headers and footers in a document\n */\nexport class HeaderFooterManager {\n  private headers: Map<Header, HeaderEntry>;\n  private footers: Map<Footer, FooterEntry>;\n  private nextHeaderNumber: number;\n  private nextFooterNumber: number;\n\n  /**\n   * Creates a new header/footer manager\n   */\n  constructor() {\n    this.headers = new Map();\n    this.footers = new Map();\n    this.nextHeaderNumber = 1;\n    this.nextFooterNumber = 1;\n  }\n\n  /**\n   * Registers a header with the manager\n   * @param header The header to register\n   * @param relationshipId The relationship ID for this header\n   * @param originalFilename Part name from the relationship target for loaded\n   *   headers — kept as-is so saved content lands where the relationship points\n   * @returns The filename assigned to this header\n   */\n  registerHeader(header: Header, relationshipId: string, originalFilename?: string): string {\n    // Check if already registered\n    const existing = this.headers.get(header);\n    if (existing) {\n      return existing.filename;\n    }\n\n    let number: number;\n    let filename: string;\n    if (originalFilename) {\n      filename = originalFilename;\n      const digits = /(\\d+)\\.xml$/i.exec(originalFilename)?.[1];\n      number = digits ? parseInt(digits, 10) : this.nextHeaderNumber;\n      // Keep the counter ahead of parsed part names so generated names never collide\n      if (number >= this.nextHeaderNumber) {\n        this.nextHeaderNumber = number + 1;\n      }\n    } else {\n      number = this.nextHeaderNumber++;\n      filename = header.getFilename(number);\n    }\n\n    // Set header ID\n    header.setHeaderId(relationshipId);\n\n    // Store entry\n    const entry: HeaderEntry = {\n      header,\n      filename,\n      relationshipId,\n      number,\n    };\n\n    this.headers.set(header, entry);\n\n    return filename;\n  }\n\n  /**\n   * Registers a footer with the manager\n   * @param footer The footer to register\n   * @param relationshipId The relationship ID for this footer\n   * @param originalFilename Part name from the relationship target for loaded\n   *   footers — kept as-is so saved content lands where the relationship points\n   * @returns The filename assigned to this footer\n   */\n  registerFooter(footer: Footer, relationshipId: string, originalFilename?: string): string {\n    // Check if already registered\n    const existing = this.footers.get(footer);\n    if (existing) {\n      return existing.filename;\n    }\n\n    let number: number;\n    let filename: string;\n    if (originalFilename) {\n      filename = originalFilename;\n      const digits = /(\\d+)\\.xml$/i.exec(originalFilename)?.[1];\n      number = digits ? parseInt(digits, 10) : this.nextFooterNumber;\n      // Keep the counter ahead of parsed part names so generated names never collide\n      if (number >= this.nextFooterNumber) {\n        this.nextFooterNumber = number + 1;\n      }\n    } else {\n      number = this.nextFooterNumber++;\n      filename = footer.getFilename(number);\n    }\n\n    // Set footer ID\n    footer.setFooterId(relationshipId);\n\n    // Store entry\n    const entry: FooterEntry = {\n      footer,\n      filename,\n      relationshipId,\n      number,\n    };\n\n    this.footers.set(footer, entry);\n\n    return filename;\n  }\n\n  /**\n   * Returns the part filename this header has, or would receive when\n   * registered. Does not consume a sequence number — callers can create the\n   * relationship targeting the same part name registerHeader() will assign.\n   * @param header The header\n   * @returns The current or upcoming filename\n   */\n  peekHeaderFilename(header: Header): string {\n    return this.headers.get(header)?.filename ?? header.getFilename(this.nextHeaderNumber);\n  }\n\n  /**\n   * Returns the part filename this footer has, or would receive when\n   * registered. Does not consume a sequence number — callers can create the\n   * relationship targeting the same part name registerFooter() will assign.\n   * @param footer The footer\n   * @returns The current or upcoming filename\n   */\n  peekFooterFilename(footer: Footer): string {\n    return this.footers.get(footer)?.filename ?? footer.getFilename(this.nextFooterNumber);\n  }\n\n  /**\n   * Gets the filename for a header\n   * @param header The header\n   * @returns The filename, or undefined if not registered\n   */\n  getHeaderFilename(header: Header): string | undefined {\n    return this.headers.get(header)?.filename;\n  }\n\n  /**\n   * Gets the filename for a footer\n   * @param footer The footer\n   * @returns The filename, or undefined if not registered\n   */\n  getFooterFilename(footer: Footer): string | undefined {\n    return this.footers.get(footer)?.filename;\n  }\n\n  /**\n   * Gets the relationship ID for a header\n   * @param header The header\n   * @returns The relationship ID, or undefined if not registered\n   */\n  getHeaderRelationshipId(header: Header): string | undefined {\n    return this.headers.get(header)?.relationshipId;\n  }\n\n  /**\n   * Gets the relationship ID for a footer\n   * @param footer The footer\n   * @returns The relationship ID, or undefined if not registered\n   */\n  getFooterRelationshipId(footer: Footer): string | undefined {\n    return this.footers.get(footer)?.relationshipId;\n  }\n\n  /**\n   * Gets all registered headers\n   * @returns Array of header entries\n   */\n  getAllHeaders(): HeaderEntry[] {\n    return Array.from(this.headers.values());\n  }\n\n  /**\n   * Gets all registered footers\n   * @returns Array of footer entries\n   */\n  getAllFooters(): FooterEntry[] {\n    return Array.from(this.footers.values());\n  }\n\n  /**\n   * Gets the number of headers\n   * @returns Number of registered headers\n   */\n  getHeaderCount(): number {\n    return this.headers.size;\n  }\n\n  /**\n   * Gets the number of footers\n   * @returns Number of registered footers\n   */\n  getFooterCount(): number {\n    return this.footers.size;\n  }\n\n  /**\n   * Checks if a header is registered\n   * @param header The header\n   * @returns True if registered\n   */\n  hasHeader(header: Header): boolean {\n    return this.headers.has(header);\n  }\n\n  /**\n   * Checks if a footer is registered\n   * @param footer The footer\n   * @returns True if registered\n   */\n  hasFooter(footer: Footer): boolean {\n    return this.footers.has(footer);\n  }\n\n  /**\n   * Clears all headers and footers\n   */\n  clear(): this {\n    this.headers.clear();\n    this.footers.clear();\n    this.nextHeaderNumber = 1;\n    this.nextFooterNumber = 1;\n    return this;\n  }\n\n  /**\n   * Creates a new header/footer manager\n   */\n  static create(): HeaderFooterManager {\n    return new HeaderFooterManager();\n  }\n}\n"]}

package/dist/esm/elements/Hyperlink.js

@@ -6,7 +6,7 @@ export class Hyperlink {
     url;
     anchor;
     text;
-    run;
+    runs;
     tooltip;
     relationshipId;
     formatting;
@@ -34,7 +34,7 @@ export class Hyperlink {
         if (this._isEmpty) {
             this.text = '';
             this.formatting = {};
-            this.run = new Run('', {});
+            this.runs = [new Run('', {})];
             return;
         }
         this.text = properties.text || this.url || 'Link';
@@ -46,14 +46,16 @@ export class Hyperlink {
         if (validation.cleanedText) {
             this.text = validation.cleanedText;
         }
-        this.formatting = {
-            font: 'Verdana',
-            size: 12,
-            color: '0000FF',
-            underline: 'single',
-            ...properties.formatting,
-        };
-        this.run = new Run(this.text, this.formatting);
+        this.formatting = properties.preserveFormatting
+            ? { ...properties.formatting }
+            : {
+                font: 'Verdana',
+                size: 12,
+                color: '0000FF',
+                underline: 'single',
+                ...properties.formatting,
+            };
+        this.runs = [new Run(this.text, this.formatting)];
     }
     _setTrackingContext(context) {
         this.trackingContext = context;
@@ -88,7 +90,7 @@ export class Hyperlink {
             return;
         const revisionId = this.trackingContext.getRevisionManager().consumeNextId();
         const author = this.trackingContext.getAuthor();
-        this.run.setPropertyChangeRevision({
+        this.runs[0].setPropertyChangeRevision({
             id: revisionId,
             author,
             date: new Date(),
@@ -132,7 +134,12 @@ export class Hyperlink {
         return this;
     }
     getText() {
-        return this.run.getText();
+        return this.runs.map((run) => run.getText()).join('');
+    }
+    replaceRunText(text) {
+        const first = this.runs[0];
+        first.setText(text);
+        this.runs = [first];
     }
     setText(text) {
         const validation = validateRunText(text, {
@@ -140,8 +147,9 @@ export class Hyperlink {
             autoClean: this.formatting.cleanXmlFromText !== false,
             warnToConsole: true,
         });
-        const cleanedText = validation.cleanedText || text;
+        const cleanedText = validation.cleanedText ?? text;
         const previousValue = this.text;
+        this._isEmpty = false;
         if (previousValue === cleanedText) {
             return this;
         }
@@ -149,7 +157,7 @@ export class Hyperlink {
             const author = this.trackingContext.getAuthor();
             const oldHyperlink = this.clone();
             this.text = cleanedText;
-            this.run.setText(cleanedText);
+            this.replaceRunText(cleanedText);
             const deletion = Revision.createDeletion(author, [oldHyperlink]);
             const insertion = Revision.createInsertion(author, [this]);
             this._parentParagraph.replaceContent(this, [deletion, insertion]);
@@ -158,14 +166,25 @@ export class Hyperlink {
             return this;
         }
         this.text = cleanedText;
-        this.run.setText(cleanedText);
+        this.replaceRunText(cleanedText);
         return this;
     }
     setRun(run) {
-        this.run = run;
+        this.runs = [run];
         this.text = run.getText();
         return this;
     }
+    setRuns(runs) {
+        if (runs.length === 0) {
+            return this;
+        }
+        this.runs = [...runs];
+        this.text = this.getText();
+        return this;
+    }
+    getRuns() {
+        return [...this.runs];
+    }
     getTooltip() {
         return this.tooltip;
     }
@@ -197,7 +216,7 @@ export class Hyperlink {
     }
     setUrl(url) {
         if (!url && !this.anchor) {
-            throw new Error(`Cannot set URL to undefined: Hyperlink "${this.run.getText()}" has no anchor. ` +
+            throw new Error(`Cannot set URL to undefined: Hyperlink "${this.getText()}" has no anchor. ` +
                 `Clearing the URL would create an invalid hyperlink per ECMA-376 §17.16.22. ` +
                 `Either provide a new URL or delete the hyperlink entirely.`);
         }
@@ -210,9 +229,9 @@ export class Hyperlink {
             const oldHyperlink = this.clone();
             this.url = url;
             this.relationshipId = undefined;
-            if (this.run.getText() === oldUrl) {
+            if (this.getText() === oldUrl) {
                 this.text = url || this.anchor || 'Link';
-                this.run.setText(this.text);
+                this.replaceRunText(this.text);
             }
             const deletion = Revision.createDeletion(author, [oldHyperlink]);
             const insertion = Revision.createInsertion(author, [this]);
@@ -222,15 +241,15 @@ export class Hyperlink {
         }
         this.url = url;
         this.relationshipId = undefined;
-        if (this.run.getText() === oldUrl) {
+        if (this.getText() === oldUrl) {
             this.text = url || this.anchor || 'Link';
-            this.run.setText(this.text);
+            this.replaceRunText(this.text);
         }
         return this;
     }
     setAnchor(anchor) {
         if (!anchor && !this.url) {
-            throw new Error(`Cannot set anchor to undefined: Hyperlink "${this.run.getText()}" has no URL. ` +
+            throw new Error(`Cannot set anchor to undefined: Hyperlink "${this.getText()}" has no URL. ` +
                 `Clearing the anchor would create an invalid hyperlink per ECMA-376 §17.16.22. ` +
                 `Either provide a new anchor or delete the hyperlink entirely.`);
         }
@@ -248,9 +267,9 @@ export class Hyperlink {
                 this.url = undefined;
                 this.relationshipId = undefined;
             }
-            if (this.run.getText() === oldAnchor) {
+            if (this.getText() === oldAnchor) {
                 this.text = anchor || this.url || 'Link';
-                this.run.setText(this.text);
+                this.replaceRunText(this.text);
             }
             const deletion = Revision.createDeletion(author, [oldHyperlink]);
             const insertion = Revision.createInsertion(author, [this]);
@@ -265,14 +284,14 @@ export class Hyperlink {
             this.url = undefined;
             this.relationshipId = undefined;
         }
-        if (this.run.getText() === oldAnchor) {
+        if (this.getText() === oldAnchor) {
             this.text = anchor || this.url || 'Link';
-            this.run.setText(this.text);
+            this.replaceRunText(this.text);
         }
         return this;
     }
     getRun() {
-        return this.run;
+        return this.runs[0];
     }
     setFormatting(formatting, options) {
         const previousFormatting = { ...this.formatting };
@@ -282,14 +301,16 @@ export class Hyperlink {
         else {
             this.formatting = { ...this.formatting, ...formatting };
         }
-        const currentText = this.run.getText();
-        this.run = new Run(currentText, this.formatting);
-        this.text = currentText;
+        this.runs = this.runs.map((run) => Run.createFromContent(run.getContent(), options?.replace ? { ...formatting } : { ...run.getFormatting(), ...formatting }));
+        this.text = this.getText();
         if (this.trackingContext?.isEnabled()) {
             this._applyFormattingRPrChange(previousFormatting);
         }
         return this;
     }
+    patchRunFormatting(patch) {
+        this.runs = this.runs.map((run) => Run.createFromContent(run.getContent(), { ...run.getFormatting(), ...patch }));
+    }
     getFormatting() {
         return this;
     }
@@ -317,7 +338,7 @@ export class Hyperlink {
     setColor(color) {
         const previousFormatting = { ...this.formatting };
         this.formatting.color = color;
-        this.run = new Run(this.text, this.formatting);
+        this.patchRunFormatting({ color });
         if (this.trackingContext?.isEnabled() && previousFormatting.color !== color) {
             this._applyFormattingRPrChange(previousFormatting);
         }
@@ -326,7 +347,7 @@ export class Hyperlink {
     setUnderline(underline) {
         const previousFormatting = { ...this.formatting };
         this.formatting.underline = underline;
-        this.run = new Run(this.text, this.formatting);
+        this.patchRunFormatting({ underline });
         if (this.trackingContext?.isEnabled() && previousFormatting.underline !== underline) {
             this._applyFormattingRPrChange(previousFormatting);
         }
@@ -335,7 +356,7 @@ export class Hyperlink {
     setBold(bold = true) {
         const previousFormatting = { ...this.formatting };
         this.formatting.bold = bold;
-        this.run = new Run(this.text, this.formatting);
+        this.patchRunFormatting({ bold });
         if (this.trackingContext?.isEnabled() && previousFormatting.bold !== bold) {
             this._applyFormattingRPrChange(previousFormatting);
         }
@@ -344,7 +365,7 @@ export class Hyperlink {
     setItalic(italic = true) {
         const previousFormatting = { ...this.formatting };
         this.formatting.italic = italic;
-        this.run = new Run(this.text, this.formatting);
+        this.patchRunFormatting({ italic });
         if (this.trackingContext?.isEnabled() && previousFormatting.italic !== italic) {
             this._applyFormattingRPrChange(previousFormatting);
         }
@@ -353,7 +374,7 @@ export class Hyperlink {
     setFont(font) {
         const previousFormatting = { ...this.formatting };
         this.formatting.font = font;
-        this.run = new Run(this.text, this.formatting);
+        this.patchRunFormatting({ font });
         if (this.trackingContext?.isEnabled() && previousFormatting.font !== font) {
             this._applyFormattingRPrChange(previousFormatting);
         }
@@ -362,7 +383,7 @@ export class Hyperlink {
     setSize(size) {
         const previousFormatting = { ...this.formatting };
         this.formatting.size = size;
-        this.run = new Run(this.text, this.formatting);
+        this.patchRunFormatting({ size });
         if (this.trackingContext?.isEnabled() && previousFormatting.size !== size) {
             this._applyFormattingRPrChange(previousFormatting);
         }
@@ -420,8 +441,9 @@ export class Hyperlink {
                 fixedUrl = fixedUrl.replace(/\/$/, '');
                 fixed.push('Removed trailing slash');
             }
+            const beforeUpgrade = fixedUrl;
             fixedUrl = fixedUrl.replace(/^http:\/\//i, 'https://');
-            if (fixedUrl !== this.url && fixedUrl.startsWith('https://')) {
+            if (fixedUrl !== beforeUpgrade) {
                 fixed.push('Upgraded HTTP to HTTPS');
             }
             if (fixedUrl !== this.url) {
@@ -502,17 +524,21 @@ export class Hyperlink {
             tooltip: this.tooltip,
             relationshipId: this.relationshipId,
             formatting: { ...this.formatting },
+            preserveFormatting: true,
             tgtFrame: this.tgtFrame,
             history: this.history,
             docLocation: this.docLocation,
+            isEmpty: this._isEmpty,
         });
-        if (this.run) {
-            cloned.run = new Run(this.run.getText(), { ...this.run.getFormatting() });
-            const existingRPrChange = this.run.getPropertyChangeRevision();
+        cloned.runs = this.runs.map((run) => {
+            const copy = run.clone();
+            const existingRPrChange = run.getPropertyChangeRevision();
             if (existingRPrChange) {
-                cloned.run.setPropertyChangeRevision({ ...existingRPrChange });
+                copy.setPropertyChangeRevision({ ...existingRPrChange });
             }
-        }
+            return copy;
+        });
+        cloned.text = cloned.getText();
         return cloned;
     }
     toXML() {
@@ -552,11 +578,10 @@ export class Hyperlink {
                 children: [],
             };
         }
-        const runXml = this.run.toXML();
         return {
             name: 'w:hyperlink',
             attributes,
-            children: [runXml],
+            children: this.runs.map((run) => run.toXML()),
         };
     }
     static createExternal(url, text, formatting) {