docxmlater 10.4.0 → 11.0.4

package/dist/esm/elements/HeaderFooterManager.js

@@ -0,0 +1,87 @@
+export class HeaderFooterManager {
+    headers;
+    footers;
+    nextHeaderNumber;
+    nextFooterNumber;
+    constructor() {
+        this.headers = new Map();
+        this.footers = new Map();
+        this.nextHeaderNumber = 1;
+        this.nextFooterNumber = 1;
+    }
+    registerHeader(header, relationshipId) {
+        const existing = this.headers.get(header);
+        if (existing) {
+            return existing.filename;
+        }
+        const number = this.nextHeaderNumber++;
+        const filename = header.getFilename(number);
+        header.setHeaderId(relationshipId);
+        const entry = {
+            header,
+            filename,
+            relationshipId,
+            number,
+        };
+        this.headers.set(header, entry);
+        return filename;
+    }
+    registerFooter(footer, relationshipId) {
+        const existing = this.footers.get(footer);
+        if (existing) {
+            return existing.filename;
+        }
+        const number = this.nextFooterNumber++;
+        const filename = footer.getFilename(number);
+        footer.setFooterId(relationshipId);
+        const entry = {
+            footer,
+            filename,
+            relationshipId,
+            number,
+        };
+        this.footers.set(footer, entry);
+        return filename;
+    }
+    getHeaderFilename(header) {
+        return this.headers.get(header)?.filename;
+    }
+    getFooterFilename(footer) {
+        return this.footers.get(footer)?.filename;
+    }
+    getHeaderRelationshipId(header) {
+        return this.headers.get(header)?.relationshipId;
+    }
+    getFooterRelationshipId(footer) {
+        return this.footers.get(footer)?.relationshipId;
+    }
+    getAllHeaders() {
+        return Array.from(this.headers.values());
+    }
+    getAllFooters() {
+        return Array.from(this.footers.values());
+    }
+    getHeaderCount() {
+        return this.headers.size;
+    }
+    getFooterCount() {
+        return this.footers.size;
+    }
+    hasHeader(header) {
+        return this.headers.has(header);
+    }
+    hasFooter(footer) {
+        return this.footers.has(footer);
+    }
+    clear() {
+        this.headers.clear();
+        this.footers.clear();
+        this.nextHeaderNumber = 1;
+        this.nextFooterNumber = 1;
+        return this;
+    }
+    static create() {
+        return new HeaderFooterManager();
+    }
+}
+//# sourceMappingURL=HeaderFooterManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HeaderFooterManager.js","sourceRoot":"","sources":["../../../src/elements/HeaderFooterManager.ts"],"names":[],"mappings":"AAiCA,MAAM,OAAO,mBAAmB;IACtB,OAAO,CAA2B;IAClC,OAAO,CAA2B;IAClC,gBAAgB,CAAS;IACzB,gBAAgB,CAAS;IAKjC;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;IAC5B,CAAC;IAQD,cAAc,CAAC,MAAc,EAAE,cAAsB;QAEnD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC,QAAQ,CAAC;QAC3B,CAAC;QAGD,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAG5C,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QAGnC,MAAM,KAAK,GAAgB;YACzB,MAAM;YACN,QAAQ;YACR,cAAc;YACd,MAAM;SACP,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAEhC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAQD,cAAc,CAAC,MAAc,EAAE,cAAsB;QAEnD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC,QAAQ,CAAC;QAC3B,CAAC;QAGD,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAG5C,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QAGnC,MAAM,KAAK,GAAgB;YACzB,MAAM;YACN,QAAQ;YACR,cAAc;YACd,MAAM;SACP,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAEhC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAOD,iBAAiB,CAAC,MAAc;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAC5C,CAAC;IAOD,iBAAiB,CAAC,MAAc;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAC5C,CAAC;IAOD,uBAAuB,CAAC,MAAc;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IAClD,CAAC;IAOD,uBAAuB,CAAC,MAAc;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IAClD,CAAC;IAMD,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAMD,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAMD,cAAc;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAMD,cAAc;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAOD,SAAS,CAAC,MAAc;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAOD,SAAS,CAAC,MAAc;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAKD,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,mBAAmB,EAAE,CAAC;IACnC,CAAC;CACF","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"]}

package/dist/esm/elements/Hyperlink.js

@@ -0,0 +1,586 @@
+import { Run } from './Run.js';
+import { Revision } from './Revision.js';
+import { validateRunText, sanitizeHyperlinkUrl } from '../utils/validation.js';
+import { defaultLogger } from '../utils/logger.js';
+export class Hyperlink {
+    url;
+    anchor;
+    text;
+    run;
+    tooltip;
+    relationshipId;
+    formatting;
+    _isEmpty = false;
+    tgtFrame;
+    history;
+    docLocation;
+    trackingContext;
+    _parentParagraph;
+    _preTrackingFormatting;
+    constructor(properties) {
+        this.url = properties.url;
+        this.anchor = properties.anchor;
+        this.tooltip = properties.tooltip;
+        this.relationshipId = properties.relationshipId;
+        this.tgtFrame = properties.tgtFrame;
+        this.history = properties.history;
+        this.docLocation = properties.docLocation;
+        this._isEmpty = properties.isEmpty ?? false;
+        if (this.url && this.anchor) {
+            defaultLogger.warn(`DocXML Warning: Hyperlink has both URL ("${this.url}") and anchor ("${this.anchor}"). ` +
+                `This is ambiguous per ECMA-376 spec. URL will take precedence. ` +
+                `Use Hyperlink.createExternal() or Hyperlink.createInternal() to avoid ambiguity.`);
+        }
+        if (this._isEmpty) {
+            this.text = '';
+            this.formatting = {};
+            this.run = new Run('', {});
+            return;
+        }
+        this.text = properties.text || this.url || 'Link';
+        const validation = validateRunText(this.text, {
+            context: 'Hyperlink text',
+            autoClean: properties.formatting?.cleanXmlFromText !== false,
+            warnToConsole: true,
+        });
+        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);
+    }
+    _setTrackingContext(context) {
+        this.trackingContext = context;
+    }
+    _setParentParagraph(paragraph) {
+        this._parentParagraph = paragraph;
+    }
+    _getParentParagraph() {
+        return this._parentParagraph;
+    }
+    _applyFormattingRPrChange(previousFormatting) {
+        if (!this._preTrackingFormatting) {
+            this._preTrackingFormatting = { ...previousFormatting };
+        }
+        const baseline = this._preTrackingFormatting;
+        const current = this.formatting;
+        const previousProperties = {};
+        let hasChanges = false;
+        for (const key of Object.keys(baseline)) {
+            if (baseline[key] !== current[key]) {
+                previousProperties[key] = baseline[key];
+                hasChanges = true;
+            }
+        }
+        for (const key of Object.keys(current)) {
+            if (!(key in baseline) && current[key] !== undefined) {
+                previousProperties[key] = undefined;
+                hasChanges = true;
+            }
+        }
+        if (!hasChanges)
+            return;
+        const revisionId = this.trackingContext.getRevisionManager().consumeNextId();
+        const author = this.trackingContext.getAuthor();
+        this.run.setPropertyChangeRevision({
+            id: revisionId,
+            author,
+            date: new Date(),
+            previousProperties,
+        });
+    }
+    getUrl() {
+        return this.url;
+    }
+    getFullUrl() {
+        if (this.url && this.anchor) {
+            return this.url + '#' + this.anchor;
+        }
+        return this.url;
+    }
+    getAnchor() {
+        return this.anchor;
+    }
+    isEmpty() {
+        return this._isEmpty;
+    }
+    getTgtFrame() {
+        return this.tgtFrame;
+    }
+    getHistory() {
+        return this.history;
+    }
+    setTgtFrame(tgtFrame) {
+        this.tgtFrame = tgtFrame;
+        return this;
+    }
+    setHistory(history) {
+        this.history = history;
+        return this;
+    }
+    getDocLocation() {
+        return this.docLocation;
+    }
+    setDocLocation(docLocation) {
+        this.docLocation = docLocation;
+        return this;
+    }
+    getText() {
+        return this.run.getText();
+    }
+    setText(text) {
+        const validation = validateRunText(text, {
+            context: 'Hyperlink.setText',
+            autoClean: this.formatting.cleanXmlFromText !== false,
+            warnToConsole: true,
+        });
+        const cleanedText = validation.cleanedText || text;
+        const previousValue = this.text;
+        if (previousValue === cleanedText) {
+            return this;
+        }
+        if (this.trackingContext?.isEnabled() && this._parentParagraph) {
+            const author = this.trackingContext.getAuthor();
+            const oldHyperlink = this.clone();
+            this.text = cleanedText;
+            this.run.setText(cleanedText);
+            const deletion = Revision.createDeletion(author, [oldHyperlink]);
+            const insertion = Revision.createInsertion(author, [this]);
+            this._parentParagraph.replaceContent(this, [deletion, insertion]);
+            this._parentParagraph = undefined;
+            this._preTrackingFormatting = undefined;
+            return this;
+        }
+        this.text = cleanedText;
+        this.run.setText(cleanedText);
+        return this;
+    }
+    setRun(run) {
+        this.run = run;
+        this.text = run.getText();
+        return this;
+    }
+    getTooltip() {
+        return this.tooltip;
+    }
+    setTooltip(tooltip) {
+        const previousValue = this.tooltip;
+        if (previousValue === tooltip) {
+            return this;
+        }
+        if (this.trackingContext?.isEnabled() && this._parentParagraph) {
+            const author = this.trackingContext.getAuthor();
+            const oldHyperlink = this.clone();
+            this.tooltip = tooltip;
+            const deletion = Revision.createDeletion(author, [oldHyperlink]);
+            const insertion = Revision.createInsertion(author, [this]);
+            this._parentParagraph.replaceContent(this, [deletion, insertion]);
+            this._parentParagraph = undefined;
+            this._preTrackingFormatting = undefined;
+            return this;
+        }
+        this.tooltip = tooltip;
+        return this;
+    }
+    getRelationshipId() {
+        return this.relationshipId;
+    }
+    setRelationshipId(id) {
+        this.relationshipId = id;
+        return this;
+    }
+    setUrl(url) {
+        if (!url && !this.anchor) {
+            throw new Error(`Cannot set URL to undefined: Hyperlink "${this.run.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.`);
+        }
+        const oldUrl = this.url;
+        if (oldUrl === url) {
+            return this;
+        }
+        if (this.trackingContext?.isEnabled() && this._parentParagraph) {
+            const author = this.trackingContext.getAuthor();
+            const oldHyperlink = this.clone();
+            this.url = url;
+            this.relationshipId = undefined;
+            if (this.run.getText() === oldUrl) {
+                this.text = url || this.anchor || 'Link';
+                this.run.setText(this.text);
+            }
+            const deletion = Revision.createDeletion(author, [oldHyperlink]);
+            const insertion = Revision.createInsertion(author, [this]);
+            this._parentParagraph.replaceContent(this, [deletion, insertion]);
+            this._parentParagraph = undefined;
+            return this;
+        }
+        this.url = url;
+        this.relationshipId = undefined;
+        if (this.run.getText() === oldUrl) {
+            this.text = url || this.anchor || 'Link';
+            this.run.setText(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. ` +
+                `Clearing the anchor would create an invalid hyperlink per ECMA-376 §17.16.22. ` +
+                `Either provide a new anchor or delete the hyperlink entirely.`);
+        }
+        const oldAnchor = this.anchor;
+        if (oldAnchor === anchor) {
+            return this;
+        }
+        if (this.trackingContext?.isEnabled() && this._parentParagraph) {
+            const author = this.trackingContext.getAuthor();
+            const oldHyperlink = this.clone();
+            this.anchor = anchor;
+            if (anchor && this.url) {
+                defaultLogger.warn(`DocXML Warning: Setting anchor "${anchor}" on hyperlink that has URL "${this.url}". ` +
+                    `Clearing URL to make this an internal link. Use separate hyperlinks for external and internal links.`);
+                this.url = undefined;
+                this.relationshipId = undefined;
+            }
+            if (this.run.getText() === oldAnchor) {
+                this.text = anchor || this.url || 'Link';
+                this.run.setText(this.text);
+            }
+            const deletion = Revision.createDeletion(author, [oldHyperlink]);
+            const insertion = Revision.createInsertion(author, [this]);
+            this._parentParagraph.replaceContent(this, [deletion, insertion]);
+            this._parentParagraph = undefined;
+            return this;
+        }
+        this.anchor = anchor;
+        if (anchor && this.url) {
+            defaultLogger.warn(`DocXML Warning: Setting anchor "${anchor}" on hyperlink that has URL "${this.url}". ` +
+                `Clearing URL to make this an internal link. Use separate hyperlinks for external and internal links.`);
+            this.url = undefined;
+            this.relationshipId = undefined;
+        }
+        if (this.run.getText() === oldAnchor) {
+            this.text = anchor || this.url || 'Link';
+            this.run.setText(this.text);
+        }
+        return this;
+    }
+    getRun() {
+        return this.run;
+    }
+    setFormatting(formatting, options) {
+        const previousFormatting = { ...this.formatting };
+        if (options?.replace) {
+            this.formatting = { ...formatting };
+        }
+        else {
+            this.formatting = { ...this.formatting, ...formatting };
+        }
+        const currentText = this.run.getText();
+        this.run = new Run(currentText, this.formatting);
+        this.text = currentText;
+        if (this.trackingContext?.isEnabled()) {
+            this._applyFormattingRPrChange(previousFormatting);
+        }
+        return this;
+    }
+    getFormatting() {
+        return this;
+    }
+    getRawFormatting() {
+        return this.formatting;
+    }
+    getColor() {
+        return this.formatting.color;
+    }
+    getUnderline() {
+        return this.formatting.underline;
+    }
+    getBold() {
+        return this.formatting.bold ?? false;
+    }
+    getItalic() {
+        return this.formatting.italic ?? false;
+    }
+    getFont() {
+        return this.formatting.font;
+    }
+    getSize() {
+        return this.formatting.size;
+    }
+    setColor(color) {
+        const previousFormatting = { ...this.formatting };
+        this.formatting.color = color;
+        this.run = new Run(this.text, this.formatting);
+        if (this.trackingContext?.isEnabled() && previousFormatting.color !== color) {
+            this._applyFormattingRPrChange(previousFormatting);
+        }
+        return this;
+    }
+    setUnderline(underline) {
+        const previousFormatting = { ...this.formatting };
+        this.formatting.underline = underline;
+        this.run = new Run(this.text, this.formatting);
+        if (this.trackingContext?.isEnabled() && previousFormatting.underline !== underline) {
+            this._applyFormattingRPrChange(previousFormatting);
+        }
+        return this;
+    }
+    setBold(bold = true) {
+        const previousFormatting = { ...this.formatting };
+        this.formatting.bold = bold;
+        this.run = new Run(this.text, this.formatting);
+        if (this.trackingContext?.isEnabled() && previousFormatting.bold !== bold) {
+            this._applyFormattingRPrChange(previousFormatting);
+        }
+        return this;
+    }
+    setItalic(italic = true) {
+        const previousFormatting = { ...this.formatting };
+        this.formatting.italic = italic;
+        this.run = new Run(this.text, this.formatting);
+        if (this.trackingContext?.isEnabled() && previousFormatting.italic !== italic) {
+            this._applyFormattingRPrChange(previousFormatting);
+        }
+        return this;
+    }
+    setFont(font) {
+        const previousFormatting = { ...this.formatting };
+        this.formatting.font = font;
+        this.run = new Run(this.text, this.formatting);
+        if (this.trackingContext?.isEnabled() && previousFormatting.font !== font) {
+            this._applyFormattingRPrChange(previousFormatting);
+        }
+        return this;
+    }
+    setSize(size) {
+        const previousFormatting = { ...this.formatting };
+        this.formatting.size = size;
+        this.run = new Run(this.text, this.formatting);
+        if (this.trackingContext?.isEnabled() && previousFormatting.size !== size) {
+            this._applyFormattingRPrChange(previousFormatting);
+        }
+        return this;
+    }
+    async validateAndFix(options) {
+        const { checkAccessibility = false, fixCommonIssues = true, timeout = 5000, bookmarkManager, } = options || {};
+        const issues = [];
+        const fixed = [];
+        let fixedUrl = this.url;
+        const originalUrl = this.url;
+        if (this.anchor) {
+            if (bookmarkManager) {
+                const bookmarkExists = bookmarkManager.hasBookmark(this.anchor);
+                if (!bookmarkExists) {
+                    issues.push(`Internal bookmark "${this.anchor}" not found`);
+                }
+            }
+            return {
+                valid: issues.length === 0,
+                issues,
+                fixed,
+                originalUrl,
+            };
+        }
+        if (!this.url) {
+            issues.push('No URL or anchor specified');
+            return { valid: false, issues, fixed, originalUrl };
+        }
+        if (fixCommonIssues && fixedUrl) {
+            const sanitizeResult = sanitizeHyperlinkUrl(fixedUrl);
+            if (sanitizeResult) {
+                fixedUrl = sanitizeResult.url;
+                fixed.push(...sanitizeResult.fixes);
+            }
+            if (!/^[a-z]+:\/\//i.exec(fixedUrl)) {
+                fixedUrl = 'https://' + fixedUrl;
+                fixed.push('Added missing protocol (https://)');
+            }
+            const protocolMatch = /^([a-z]+:\/\/)/i.exec(fixedUrl);
+            if (protocolMatch?.[1]) {
+                const protocol = protocolMatch[1];
+                const rest = fixedUrl.substring(protocol.length);
+                const fixedRest = rest.replace(/\/\//g, '/');
+                if (rest !== fixedRest) {
+                    fixedUrl = protocol + fixedRest;
+                    fixed.push('Fixed double slashes');
+                }
+            }
+            if (fixedUrl.includes(' ')) {
+                fixedUrl = fixedUrl.replace(/ /g, '%20');
+                fixed.push('Encoded spaces as %20');
+            }
+            if (/^https?:\/\/[^/]+\/.+\/$/.exec(fixedUrl)) {
+                fixedUrl = fixedUrl.replace(/\/$/, '');
+                fixed.push('Removed trailing slash');
+            }
+            fixedUrl = fixedUrl.replace(/^http:\/\//i, 'https://');
+            if (fixedUrl !== this.url && fixedUrl.startsWith('https://')) {
+                fixed.push('Upgraded HTTP to HTTPS');
+            }
+            if (fixedUrl !== this.url) {
+                this.setUrl(fixedUrl);
+            }
+        }
+        if (checkAccessibility && fixedUrl?.match(/^https?:\/\//i)) {
+            if (typeof fetch === 'undefined') {
+                issues.push('Network validation unavailable: fetch API not supported in this environment');
+            }
+            else {
+                try {
+                    const controller = new AbortController();
+                    const timeoutId = setTimeout(() => controller.abort(), timeout);
+                    const response = await fetch(fixedUrl, {
+                        method: 'HEAD',
+                        signal: controller.signal,
+                        redirect: 'follow',
+                    });
+                    clearTimeout(timeoutId);
+                    if (!response.ok) {
+                        issues.push(`HTTP ${response.status}: ${response.statusText || 'Error'}`);
+                    }
+                }
+                catch (error) {
+                    const isErrorWithName = (err) => {
+                        return typeof err === 'object' && err !== null && 'name' in err;
+                    };
+                    const isErrorWithMessage = (err) => {
+                        return typeof err === 'object' && err !== null && 'message' in err;
+                    };
+                    if (isErrorWithName(error) && error.name === 'AbortError') {
+                        issues.push(`Timeout after ${timeout}ms`);
+                    }
+                    else if (isErrorWithMessage(error) && error.message?.includes('fetch')) {
+                        issues.push(`Unreachable: ${error.message}`);
+                    }
+                    else if (isErrorWithMessage(error)) {
+                        issues.push(`Network error: ${error.message}`);
+                    }
+                    else {
+                        issues.push('Network error: Unknown error');
+                    }
+                }
+            }
+        }
+        return {
+            valid: issues.length === 0,
+            issues,
+            fixed,
+            originalUrl,
+            fixedUrl: fixedUrl !== originalUrl ? fixedUrl : undefined,
+        };
+    }
+    resetToStandardFormatting() {
+        const standardFormatting = {
+            font: 'Verdana',
+            color: '0000FF',
+            underline: 'single',
+            bold: false,
+            italic: false,
+            strike: false,
+        };
+        this.setFormatting(standardFormatting);
+        return this;
+    }
+    isExternal() {
+        return this.url !== undefined;
+    }
+    isInternal() {
+        return this.anchor !== undefined;
+    }
+    clone() {
+        const cloned = new Hyperlink({
+            url: this.url,
+            anchor: this.anchor,
+            text: this.text,
+            tooltip: this.tooltip,
+            relationshipId: this.relationshipId,
+            formatting: { ...this.formatting },
+            tgtFrame: this.tgtFrame,
+            history: this.history,
+            docLocation: this.docLocation,
+        });
+        if (this.run) {
+            cloned.run = new Run(this.run.getText(), { ...this.run.getFormatting() });
+            const existingRPrChange = this.run.getPropertyChangeRevision();
+            if (existingRPrChange) {
+                cloned.run.setPropertyChangeRevision({ ...existingRPrChange });
+            }
+        }
+        return cloned;
+    }
+    toXML() {
+        if (!this.url && !this.anchor && !this.relationshipId) {
+            throw new Error('CRITICAL: Hyperlink must have either a URL (external link), anchor (internal link), or relationshipId. ' +
+                'Cannot generate valid XML for hyperlink without destination.');
+        }
+        if (this.url && !this.relationshipId) {
+            throw new Error(`CRITICAL: External hyperlink to "${this.url}" is missing relationship ID. ` +
+                `This would create an invalid OpenXML document per ECMA-376 §17.16.22. ` +
+                `Solution: Use Document.save() which automatically registers relationships, ` +
+                `or manually call relationshipManager.addHyperlink(url) and set the relationship ID.`);
+        }
+        const attributes = {};
+        if (this.relationshipId) {
+            attributes['r:id'] = this.relationshipId;
+        }
+        if (this.anchor) {
+            attributes['w:anchor'] = this.anchor;
+        }
+        if (this.tooltip) {
+            attributes['w:tooltip'] = this.tooltip;
+        }
+        if (this.tgtFrame) {
+            attributes['w:tgtFrame'] = this.tgtFrame;
+        }
+        if (this.history !== undefined) {
+            attributes['w:history'] = this.history;
+        }
+        if (this.docLocation) {
+            attributes['w:docLocation'] = this.docLocation;
+        }
+        if (this._isEmpty) {
+            return {
+                name: 'w:hyperlink',
+                attributes,
+                children: [],
+            };
+        }
+        const runXml = this.run.toXML();
+        return {
+            name: 'w:hyperlink',
+            attributes,
+            children: [runXml],
+        };
+    }
+    static createExternal(url, text, formatting) {
+        return new Hyperlink({ url, text, formatting });
+    }
+    static createInternal(anchor, text, formatting) {
+        return new Hyperlink({ anchor, text, formatting });
+    }
+    static createWebLink(url, text, formatting) {
+        return new Hyperlink({
+            url,
+            text: text || url,
+            formatting,
+        });
+    }
+    static createEmail(email, text, formatting) {
+        return new Hyperlink({
+            url: `mailto:${email}`,
+            text: text || email,
+            formatting,
+        });
+    }
+    static create(properties) {
+        return new Hyperlink(properties);
+    }
+}
+//# sourceMappingURL=Hyperlink.js.map