docxmlater 10.1.3 → 10.1.5

package/dist/core/DocumentValidator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentValidator.d.ts","sourceRoot":"","sources":["../../src/core/DocumentValidator.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQhD,MAAM,WAAW,aAAa;IAE5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAKD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAAU;gBAEtB,qBAAqB,SAAK,EAAE,OAAO,GAAE,aAAkB;IAqBnE,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,kBAAkB,GAAG,kBAAkB;IAwH7E,kBAAkB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,IAAI;IAgDrD,oBAAoB,IAAI,IAAI;IAkD5B,YAAY,CAAC,YAAY,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,YAAY,GAAG,YAAY;IAmDnF,YAAY,CAAC,YAAY,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,YAAY,GAAG;QACrE,QAAQ,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QACjE,IAAI,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QACrD,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB;CA6BF"}
+{"version":3,"file":"DocumentValidator.d.ts","sourceRoot":"","sources":["../../src/core/DocumentValidator.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQhD,MAAM,WAAW,aAAa;IAE5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAKD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAAU;gBAEtB,qBAAqB,SAAK,EAAE,OAAO,GAAE,aAAkB;IAiBnE,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,kBAAkB,GAAG,kBAAkB;IAmH7E,kBAAkB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,IAAI;IA8CrD,oBAAoB,IAAI,IAAI;IAkD5B,YAAY,CAAC,YAAY,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,YAAY,GAAG,YAAY;IAkDnF,YAAY,CACV,YAAY,EAAE,WAAW,EAAE,EAC3B,YAAY,EAAE,YAAY,GACzB;QACD,QAAQ,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QACjE,IAAI,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QACrD,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB;CA6BF"}

package/dist/core/DocumentValidator.js

@@ -45,9 +45,7 @@ class DocumentValidator {
     useAbsoluteLimit;
     constructor(maxMemoryUsagePercent = 80, options = {}) {
         const memoryPercent = options.maxMemoryUsagePercent ?? maxMemoryUsagePercent;
-        if (memoryPercent < 1 ||
-            memoryPercent > 100 ||
-            !Number.isFinite(memoryPercent)) {
+        if (memoryPercent < 1 || memoryPercent > 100 || !Number.isFinite(memoryPercent)) {
             throw new Error('maxMemoryUsagePercent must be between 1 and 100');
         }
         this.maxMemoryUsagePercent = memoryPercent;
@@ -111,8 +109,7 @@ class DocumentValidator {
             validated.lastModifiedBy = properties.lastModifiedBy;
         }
         if (properties.revision !== undefined) {
-            if (typeof properties.revision !== 'number' ||
-                !Number.isInteger(properties.revision)) {
+            if (typeof properties.revision !== 'number' || !Number.isInteger(properties.revision)) {
                 throw new Error('DocumentProperties.revision must be an integer');
             }
             if (properties.revision < 0 || properties.revision > limits_1.LIMITS.MAX_REVISION) {

package/dist/core/DocumentValidator.js.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentValidator.js","sourceRoot":"","sources":["../../src/core/DocumentValidator.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * DocumentValidator - Handles validation of document properties and content\r\n * Prevents security issues and data corruption\r\n */\r\n\r\nimport { Paragraph } from '../elements/Paragraph';\r\nimport { Table } from '../elements/Table';\r\nimport { ImageManager } from '../elements/ImageManager';\r\nimport { DocumentProperties } from './Document';\r\nimport { BodyElement } from './DocumentContent';\r\nimport { LIMITS } from '../constants/limits';\r\nimport { defaultLogger } from '../utils/logger';\r\nimport * as v8 from 'v8';\r\n\r\n/**\r\n * Memory validation options\r\n */\r\nexport interface MemoryOptions {\r\n  /** Maximum memory usage percentage (0-100) before throwing error. Default: 80 */\r\n  maxMemoryUsagePercent?: number;\r\n  /** Maximum absolute RSS (Resident Set Size) in MB. Default: 2048 (2GB) */\r\n  maxRssMB?: number;\r\n  /** Enable absolute RSS limit checking. Default: true */\r\n  useAbsoluteLimit?: boolean;\r\n}\r\n\r\n/**\r\n * Size estimation result\r\n */\r\nexport interface SizeEstimate {\r\n  paragraphs: number;\r\n  tables: number;\r\n  images: number;\r\n  estimatedXmlBytes: number;\r\n  imageBytes: number;\r\n  totalEstimatedBytes: number;\r\n  totalEstimatedMB: number;\r\n  warning?: string;\r\n}\r\n\r\n/**\r\n * DocumentValidator handles all validation logic\r\n */\r\nexport class DocumentValidator {\r\n  private maxMemoryUsagePercent: number;\r\n  private maxRssMB: number;\r\n  private useAbsoluteLimit: boolean;\r\n\r\n  constructor(maxMemoryUsagePercent = 80, options: MemoryOptions = {}) {\r\n    // Validate maxMemoryUsagePercent\r\n    const memoryPercent = options.maxMemoryUsagePercent ?? maxMemoryUsagePercent;\r\n    if (\r\n      memoryPercent < 1 ||\r\n      memoryPercent > 100 ||\r\n      !Number.isFinite(memoryPercent)\r\n    ) {\r\n      throw new Error('maxMemoryUsagePercent must be between 1 and 100');\r\n    }\r\n    this.maxMemoryUsagePercent = memoryPercent;\r\n    this.maxRssMB = options.maxRssMB ?? 2048; // Default 2GB\r\n    this.useAbsoluteLimit = options.useAbsoluteLimit ?? true;\r\n  }\r\n\r\n  /**\r\n   * Validates and sanitizes document properties\r\n   * Prevents injection attacks and excessive memory usage\r\n   * @param properties - Properties to validate\r\n   * @returns Validated and sanitized properties\r\n   */\r\n  static validateProperties(properties: DocumentProperties): DocumentProperties {\r\n    const validated: DocumentProperties = {};\r\n\r\n    // Validate and truncate string properties\r\n    if (properties.title !== undefined) {\r\n      if (typeof properties.title !== 'string') {\r\n        throw new Error('DocumentProperties.title must be a string');\r\n      }\r\n      if (properties.title.length > LIMITS.MAX_STRING_LENGTH) {\r\n        throw new Error(\r\n          `DocumentProperties.title exceeds maximum length of ${LIMITS.MAX_STRING_LENGTH} characters`\r\n        );\r\n      }\r\n      validated.title = properties.title;\r\n    }\r\n\r\n    if (properties.subject !== undefined) {\r\n      if (typeof properties.subject !== 'string') {\r\n        throw new Error('DocumentProperties.subject must be a string');\r\n      }\r\n      if (properties.subject.length > LIMITS.MAX_STRING_LENGTH) {\r\n        throw new Error(\r\n          `DocumentProperties.subject exceeds maximum length of ${LIMITS.MAX_STRING_LENGTH} characters`\r\n        );\r\n      }\r\n      validated.subject = properties.subject;\r\n    }\r\n\r\n    if (properties.creator !== undefined) {\r\n      if (typeof properties.creator !== 'string') {\r\n        throw new Error('DocumentProperties.creator must be a string');\r\n      }\r\n      if (properties.creator.length > LIMITS.MAX_STRING_LENGTH) {\r\n        throw new Error(\r\n          `DocumentProperties.creator exceeds maximum length of ${LIMITS.MAX_STRING_LENGTH} characters`\r\n        );\r\n      }\r\n      validated.creator = properties.creator;\r\n    }\r\n\r\n    if (properties.keywords !== undefined) {\r\n      if (typeof properties.keywords !== 'string') {\r\n        throw new Error('DocumentProperties.keywords must be a string');\r\n      }\r\n      if (properties.keywords.length > LIMITS.MAX_STRING_LENGTH) {\r\n        throw new Error(\r\n          `DocumentProperties.keywords exceeds maximum length of ${LIMITS.MAX_STRING_LENGTH} characters`\r\n        );\r\n      }\r\n      validated.keywords = properties.keywords;\r\n    }\r\n\r\n    if (properties.description !== undefined) {\r\n      if (typeof properties.description !== 'string') {\r\n        throw new Error('DocumentProperties.description must be a string');\r\n      }\r\n      if (properties.description.length > LIMITS.MAX_STRING_LENGTH) {\r\n        throw new Error(\r\n          `DocumentProperties.description exceeds maximum length of ${LIMITS.MAX_STRING_LENGTH} characters`\r\n        );\r\n      }\r\n      validated.description = properties.description;\r\n    }\r\n\r\n    if (properties.lastModifiedBy !== undefined) {\r\n      if (typeof properties.lastModifiedBy !== 'string') {\r\n        throw new Error('DocumentProperties.lastModifiedBy must be a string');\r\n      }\r\n      if (properties.lastModifiedBy.length > LIMITS.MAX_STRING_LENGTH) {\r\n        throw new Error(\r\n          `DocumentProperties.lastModifiedBy exceeds maximum length of ${LIMITS.MAX_STRING_LENGTH} characters`\r\n        );\r\n      }\r\n      validated.lastModifiedBy = properties.lastModifiedBy;\r\n    }\r\n\r\n    // Validate revision number\r\n    if (properties.revision !== undefined) {\r\n      if (\r\n        typeof properties.revision !== 'number' ||\r\n        !Number.isInteger(properties.revision)\r\n      ) {\r\n        throw new Error('DocumentProperties.revision must be an integer');\r\n      }\r\n      if (properties.revision < 0 || properties.revision > LIMITS.MAX_REVISION) {\r\n        throw new Error(\r\n          `DocumentProperties.revision must be between 0 and ${LIMITS.MAX_REVISION}`\r\n        );\r\n      }\r\n      validated.revision = properties.revision;\r\n    }\r\n\r\n    // Validate dates\r\n    if (properties.created !== undefined) {\r\n      if (!(properties.created instanceof Date)) {\r\n        throw new Error('DocumentProperties.created must be a Date object');\r\n      }\r\n      if (!Number.isFinite(properties.created.getTime())) {\r\n        throw new Error('DocumentProperties.created is an invalid date');\r\n      }\r\n      validated.created = properties.created;\r\n    }\r\n\r\n    if (properties.modified !== undefined) {\r\n      if (!(properties.modified instanceof Date)) {\r\n        throw new Error('DocumentProperties.modified must be a Date object');\r\n      }\r\n      if (!Number.isFinite(properties.modified.getTime())) {\r\n        throw new Error('DocumentProperties.modified is an invalid date');\r\n      }\r\n      validated.modified = properties.modified;\r\n    }\r\n\r\n    return validated;\r\n  }\r\n\r\n  /**\r\n   * Validates that the document has meaningful content before saving\r\n   * Warns if the document appears to be empty or corrupted\r\n   */\r\n  validateBeforeSave(bodyElements: BodyElement[]): void {\r\n    const paragraphs = bodyElements.filter(\r\n      (el): el is Paragraph => el instanceof Paragraph\r\n    );\r\n\r\n    if (paragraphs.length === 0) {\r\n      defaultLogger.warn(\r\n        '\\nDocXML Save Warning:\\n' +\r\n          'Document has no paragraphs. You are saving an empty document.\\n'\r\n      );\r\n      return;\r\n    }\r\n\r\n    // Count runs with text\r\n    let totalRuns = 0;\r\n    let emptyRuns = 0;\r\n\r\n    for (const para of paragraphs) {\r\n      const runs = para.getRuns();\r\n      totalRuns += runs.length;\r\n\r\n      for (const run of runs) {\r\n        if (run.getText().length === 0) {\r\n          emptyRuns++;\r\n        }\r\n      }\r\n    }\r\n\r\n    if (totalRuns > 0) {\r\n      const emptyPercentage = (emptyRuns / totalRuns) * 100;\r\n\r\n      if (emptyPercentage > 90 && emptyRuns > 10) {\r\n        defaultLogger.warn(\r\n          '\\nDocXML Save Warning:\\n' +\r\n            `You are about to save a document where ${emptyRuns} out of ${totalRuns} runs (${emptyPercentage.toFixed(1)}%) are empty.\\n` +\r\n            'This may result in a document with no visible text content.\\n' +\r\n            'If this is unintentional, please review the document before saving.\\n'\r\n        );\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Checks current memory usage and throws if above threshold\r\n   * Prevents out-of-memory errors by failing early\r\n   * Uses both heap percentage and absolute RSS limits for better accuracy\r\n   * @throws {Error} If memory usage exceeds configured limits\r\n   */\r\n  checkMemoryThreshold(): void {\r\n    const { heapUsed, external, rss } = process.memoryUsage();\r\n    const heapStats = v8.getHeapStatistics();\r\n    const heapLimit = heapStats.heap_size_limit; // Actual max heap (typically 4GB on 64-bit)\r\n\r\n    // Calculate heap usage percentage against the actual limit, not currently allocated\r\n    const heapPercent = (heapUsed / heapLimit) * 100;\r\n    const heapMB = heapUsed / (1024 * 1024);\r\n    const heapLimitMB = heapLimit / (1024 * 1024);\r\n\r\n    // Calculate RSS (Resident Set Size - actual memory used by process)\r\n    const rssMB = rss / (1024 * 1024);\r\n    const externalMB = external / (1024 * 1024);\r\n\r\n    // Check heap percentage (protects against heap fragmentation)\r\n    const heapExceeded = heapPercent > this.maxMemoryUsagePercent;\r\n\r\n    // Check absolute RSS limit (protects against excessive total memory)\r\n    const rssExceeded = this.useAbsoluteLimit && rssMB > this.maxRssMB;\r\n\r\n    // Only throw if BOTH conditions are true (avoids false positives)\r\n    if (heapExceeded && rssExceeded) {\r\n      throw new Error(\r\n        `Memory usage critical:\\n` +\r\n        `  Heap: ${heapMB.toFixed(0)}MB / ${heapLimitMB.toFixed(0)}MB (${heapPercent.toFixed(1)}%)\\n` +\r\n        `  RSS: ${rssMB.toFixed(0)}MB (limit: ${this.maxRssMB}MB)\\n` +\r\n        `  External: ${externalMB.toFixed(0)}MB\\n` +\r\n        `Cannot process document safely. Consider:\\n` +\r\n        `  - Reducing document size (remove/compress images)\\n` +\r\n        `  - Splitting into multiple documents\\n` +\r\n        `  - Increasing memory limits in DocumentOptions\\n` +\r\n        `  - Increasing Node.js heap size (--max-old-space-size)`\r\n      );\r\n    }\r\n\r\n    // Warn if only heap exceeded (might be temporary fragmentation)\r\n    if (heapExceeded && !rssExceeded && this.useAbsoluteLimit) {\r\n      defaultLogger.warn(\r\n        `DocXML Memory Warning: Heap usage high (${heapPercent.toFixed(1)}%) ` +\r\n        `but RSS (${rssMB.toFixed(0)}MB) is below limit. ` +\r\n        `This might be temporary heap fragmentation.`\r\n      );\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Estimates the size of the document\r\n   * Provides breakdown by component and warnings if size is too large\r\n   * @returns Size estimation with breakdown and optional warning\r\n   */\r\n  estimateSize(bodyElements: BodyElement[], imageManager: ImageManager): SizeEstimate {\r\n    // Count elements\r\n    const paragraphs = bodyElements.filter(\r\n      (el): el is Paragraph => el instanceof Paragraph\r\n    );\r\n    const tables = bodyElements.filter((el): el is Table => el instanceof Table);\r\n    const paragraphCount = paragraphs.length;\r\n    const tableCount = tables.length;\r\n    const imageCount = imageManager.getImageCount();\r\n\r\n    // Estimate XML size using documented constants\r\n    const estimatedXml = paragraphCount * LIMITS.BYTES_PER_PARAGRAPH +\r\n                         tableCount * LIMITS.BYTES_PER_TABLE +\r\n                         LIMITS.BASE_STRUCTURE_BYTES;\r\n\r\n    // Get actual image sizes\r\n    const imageBytes = imageManager.getTotalSize();\r\n\r\n    // Total estimate\r\n    const totalBytes = estimatedXml + imageBytes;\r\n    const totalMB = totalBytes / (1024 * 1024);\r\n\r\n    // Use documented threshold constants\r\n    let warning: string | undefined;\r\n\r\n    if (totalMB > LIMITS.ERROR_SIZE_MB) {\r\n      warning =\r\n        `Document size (${totalMB.toFixed(1)}MB) exceeds recommended maximum of ${LIMITS.ERROR_SIZE_MB}MB. ` +\r\n        `This may cause memory issues. Consider splitting into multiple documents or optimizing images.`;\r\n    } else if (totalMB > LIMITS.WARNING_SIZE_MB) {\r\n      warning =\r\n        `Document size (${totalMB.toFixed(1)}MB) exceeds ${LIMITS.WARNING_SIZE_MB}MB. ` +\r\n        `Large documents may take longer to process and use significant memory.`;\r\n    }\r\n\r\n    return {\r\n      paragraphs: paragraphCount,\r\n      tables: tableCount,\r\n      images: imageCount,\r\n      estimatedXmlBytes: estimatedXml,\r\n      imageBytes,\r\n      totalEstimatedBytes: totalBytes,\r\n      totalEstimatedMB: parseFloat(totalMB.toFixed(2)),\r\n      warning,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Gets size statistics for the document\r\n   * @returns Size statistics\r\n   */\r\n  getSizeStats(bodyElements: BodyElement[], imageManager: ImageManager): {\r\n    elements: { paragraphs: number; tables: number; images: number };\r\n    size: { xml: string; images: string; total: string };\r\n    warnings: string[];\r\n  } {\r\n    const estimate = this.estimateSize(bodyElements, imageManager);\r\n    const warnings: string[] = [];\r\n\r\n    if (estimate.warning) {\r\n      warnings.push(estimate.warning);\r\n    }\r\n\r\n    // Format sizes for display\r\n    const formatBytes = (bytes: number): string => {\r\n      if (bytes < 1024) return `${bytes} B`;\r\n      if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;\r\n      return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;\r\n    };\r\n\r\n    return {\r\n      elements: {\r\n        paragraphs: estimate.paragraphs,\r\n        tables: estimate.tables,\r\n        images: estimate.images,\r\n      },\r\n      size: {\r\n        xml: formatBytes(estimate.estimatedXmlBytes),\r\n        images: formatBytes(estimate.imageBytes),\r\n        total: formatBytes(estimate.totalEstimatedBytes),\r\n      },\r\n      warnings,\r\n    };\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"DocumentValidator.js","sourceRoot":"","sources":["../../src/core/DocumentValidator.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * DocumentValidator - Handles validation of document properties and content\n * Prevents security issues and data corruption\n */\n\nimport { Paragraph } from '../elements/Paragraph';\nimport { Table } from '../elements/Table';\nimport { ImageManager } from '../elements/ImageManager';\nimport { DocumentProperties } from './Document';\nimport { BodyElement } from './DocumentContent';\nimport { LIMITS } from '../constants/limits';\nimport { defaultLogger } from '../utils/logger';\nimport * as v8 from 'v8';\n\n/**\n * Memory validation options\n */\nexport interface MemoryOptions {\n  /** Maximum memory usage percentage (0-100) before throwing error. Default: 80 */\n  maxMemoryUsagePercent?: number;\n  /** Maximum absolute RSS (Resident Set Size) in MB. Default: 2048 (2GB) */\n  maxRssMB?: number;\n  /** Enable absolute RSS limit checking. Default: true */\n  useAbsoluteLimit?: boolean;\n}\n\n/**\n * Size estimation result\n */\nexport interface SizeEstimate {\n  paragraphs: number;\n  tables: number;\n  images: number;\n  estimatedXmlBytes: number;\n  imageBytes: number;\n  totalEstimatedBytes: number;\n  totalEstimatedMB: number;\n  warning?: string;\n}\n\n/**\n * DocumentValidator handles all validation logic\n */\nexport class DocumentValidator {\n  private maxMemoryUsagePercent: number;\n  private maxRssMB: number;\n  private useAbsoluteLimit: boolean;\n\n  constructor(maxMemoryUsagePercent = 80, options: MemoryOptions = {}) {\n    // Validate maxMemoryUsagePercent\n    const memoryPercent = options.maxMemoryUsagePercent ?? maxMemoryUsagePercent;\n    if (memoryPercent < 1 || memoryPercent > 100 || !Number.isFinite(memoryPercent)) {\n      throw new Error('maxMemoryUsagePercent must be between 1 and 100');\n    }\n    this.maxMemoryUsagePercent = memoryPercent;\n    this.maxRssMB = options.maxRssMB ?? 2048; // Default 2GB\n    this.useAbsoluteLimit = options.useAbsoluteLimit ?? true;\n  }\n\n  /**\n   * Validates and sanitizes document properties\n   * Prevents injection attacks and excessive memory usage\n   * @param properties - Properties to validate\n   * @returns Validated and sanitized properties\n   */\n  static validateProperties(properties: DocumentProperties): DocumentProperties {\n    const validated: DocumentProperties = {};\n\n    // Validate and truncate string properties\n    if (properties.title !== undefined) {\n      if (typeof properties.title !== 'string') {\n        throw new Error('DocumentProperties.title must be a string');\n      }\n      if (properties.title.length > LIMITS.MAX_STRING_LENGTH) {\n        throw new Error(\n          `DocumentProperties.title exceeds maximum length of ${LIMITS.MAX_STRING_LENGTH} characters`\n        );\n      }\n      validated.title = properties.title;\n    }\n\n    if (properties.subject !== undefined) {\n      if (typeof properties.subject !== 'string') {\n        throw new Error('DocumentProperties.subject must be a string');\n      }\n      if (properties.subject.length > LIMITS.MAX_STRING_LENGTH) {\n        throw new Error(\n          `DocumentProperties.subject exceeds maximum length of ${LIMITS.MAX_STRING_LENGTH} characters`\n        );\n      }\n      validated.subject = properties.subject;\n    }\n\n    if (properties.creator !== undefined) {\n      if (typeof properties.creator !== 'string') {\n        throw new Error('DocumentProperties.creator must be a string');\n      }\n      if (properties.creator.length > LIMITS.MAX_STRING_LENGTH) {\n        throw new Error(\n          `DocumentProperties.creator exceeds maximum length of ${LIMITS.MAX_STRING_LENGTH} characters`\n        );\n      }\n      validated.creator = properties.creator;\n    }\n\n    if (properties.keywords !== undefined) {\n      if (typeof properties.keywords !== 'string') {\n        throw new Error('DocumentProperties.keywords must be a string');\n      }\n      if (properties.keywords.length > LIMITS.MAX_STRING_LENGTH) {\n        throw new Error(\n          `DocumentProperties.keywords exceeds maximum length of ${LIMITS.MAX_STRING_LENGTH} characters`\n        );\n      }\n      validated.keywords = properties.keywords;\n    }\n\n    if (properties.description !== undefined) {\n      if (typeof properties.description !== 'string') {\n        throw new Error('DocumentProperties.description must be a string');\n      }\n      if (properties.description.length > LIMITS.MAX_STRING_LENGTH) {\n        throw new Error(\n          `DocumentProperties.description exceeds maximum length of ${LIMITS.MAX_STRING_LENGTH} characters`\n        );\n      }\n      validated.description = properties.description;\n    }\n\n    if (properties.lastModifiedBy !== undefined) {\n      if (typeof properties.lastModifiedBy !== 'string') {\n        throw new Error('DocumentProperties.lastModifiedBy must be a string');\n      }\n      if (properties.lastModifiedBy.length > LIMITS.MAX_STRING_LENGTH) {\n        throw new Error(\n          `DocumentProperties.lastModifiedBy exceeds maximum length of ${LIMITS.MAX_STRING_LENGTH} characters`\n        );\n      }\n      validated.lastModifiedBy = properties.lastModifiedBy;\n    }\n\n    // Validate revision number\n    if (properties.revision !== undefined) {\n      if (typeof properties.revision !== 'number' || !Number.isInteger(properties.revision)) {\n        throw new Error('DocumentProperties.revision must be an integer');\n      }\n      if (properties.revision < 0 || properties.revision > LIMITS.MAX_REVISION) {\n        throw new Error(`DocumentProperties.revision must be between 0 and ${LIMITS.MAX_REVISION}`);\n      }\n      validated.revision = properties.revision;\n    }\n\n    // Validate dates\n    if (properties.created !== undefined) {\n      if (!(properties.created instanceof Date)) {\n        throw new Error('DocumentProperties.created must be a Date object');\n      }\n      if (!Number.isFinite(properties.created.getTime())) {\n        throw new Error('DocumentProperties.created is an invalid date');\n      }\n      validated.created = properties.created;\n    }\n\n    if (properties.modified !== undefined) {\n      if (!(properties.modified instanceof Date)) {\n        throw new Error('DocumentProperties.modified must be a Date object');\n      }\n      if (!Number.isFinite(properties.modified.getTime())) {\n        throw new Error('DocumentProperties.modified is an invalid date');\n      }\n      validated.modified = properties.modified;\n    }\n\n    return validated;\n  }\n\n  /**\n   * Validates that the document has meaningful content before saving\n   * Warns if the document appears to be empty or corrupted\n   */\n  validateBeforeSave(bodyElements: BodyElement[]): void {\n    const paragraphs = bodyElements.filter((el): el is Paragraph => el instanceof Paragraph);\n\n    if (paragraphs.length === 0) {\n      defaultLogger.warn(\n        '\\nDocXML Save Warning:\\n' +\n          'Document has no paragraphs. You are saving an empty document.\\n'\n      );\n      return;\n    }\n\n    // Count runs with text\n    let totalRuns = 0;\n    let emptyRuns = 0;\n\n    for (const para of paragraphs) {\n      const runs = para.getRuns();\n      totalRuns += runs.length;\n\n      for (const run of runs) {\n        if (run.getText().length === 0) {\n          emptyRuns++;\n        }\n      }\n    }\n\n    if (totalRuns > 0) {\n      const emptyPercentage = (emptyRuns / totalRuns) * 100;\n\n      if (emptyPercentage > 90 && emptyRuns > 10) {\n        defaultLogger.warn(\n          '\\nDocXML Save Warning:\\n' +\n            `You are about to save a document where ${emptyRuns} out of ${totalRuns} runs (${emptyPercentage.toFixed(1)}%) are empty.\\n` +\n            'This may result in a document with no visible text content.\\n' +\n            'If this is unintentional, please review the document before saving.\\n'\n        );\n      }\n    }\n  }\n\n  /**\n   * Checks current memory usage and throws if above threshold\n   * Prevents out-of-memory errors by failing early\n   * Uses both heap percentage and absolute RSS limits for better accuracy\n   * @throws {Error} If memory usage exceeds configured limits\n   */\n  checkMemoryThreshold(): void {\n    const { heapUsed, external, rss } = process.memoryUsage();\n    const heapStats = v8.getHeapStatistics();\n    const heapLimit = heapStats.heap_size_limit; // Actual max heap (typically 4GB on 64-bit)\n\n    // Calculate heap usage percentage against the actual limit, not currently allocated\n    const heapPercent = (heapUsed / heapLimit) * 100;\n    const heapMB = heapUsed / (1024 * 1024);\n    const heapLimitMB = heapLimit / (1024 * 1024);\n\n    // Calculate RSS (Resident Set Size - actual memory used by process)\n    const rssMB = rss / (1024 * 1024);\n    const externalMB = external / (1024 * 1024);\n\n    // Check heap percentage (protects against heap fragmentation)\n    const heapExceeded = heapPercent > this.maxMemoryUsagePercent;\n\n    // Check absolute RSS limit (protects against excessive total memory)\n    const rssExceeded = this.useAbsoluteLimit && rssMB > this.maxRssMB;\n\n    // Only throw if BOTH conditions are true (avoids false positives)\n    if (heapExceeded && rssExceeded) {\n      throw new Error(\n        `Memory usage critical:\\n` +\n          `  Heap: ${heapMB.toFixed(0)}MB / ${heapLimitMB.toFixed(0)}MB (${heapPercent.toFixed(1)}%)\\n` +\n          `  RSS: ${rssMB.toFixed(0)}MB (limit: ${this.maxRssMB}MB)\\n` +\n          `  External: ${externalMB.toFixed(0)}MB\\n` +\n          `Cannot process document safely. Consider:\\n` +\n          `  - Reducing document size (remove/compress images)\\n` +\n          `  - Splitting into multiple documents\\n` +\n          `  - Increasing memory limits in DocumentOptions\\n` +\n          `  - Increasing Node.js heap size (--max-old-space-size)`\n      );\n    }\n\n    // Warn if only heap exceeded (might be temporary fragmentation)\n    if (heapExceeded && !rssExceeded && this.useAbsoluteLimit) {\n      defaultLogger.warn(\n        `DocXML Memory Warning: Heap usage high (${heapPercent.toFixed(1)}%) ` +\n          `but RSS (${rssMB.toFixed(0)}MB) is below limit. ` +\n          `This might be temporary heap fragmentation.`\n      );\n    }\n  }\n\n  /**\n   * Estimates the size of the document\n   * Provides breakdown by component and warnings if size is too large\n   * @returns Size estimation with breakdown and optional warning\n   */\n  estimateSize(bodyElements: BodyElement[], imageManager: ImageManager): SizeEstimate {\n    // Count elements\n    const paragraphs = bodyElements.filter((el): el is Paragraph => el instanceof Paragraph);\n    const tables = bodyElements.filter((el): el is Table => el instanceof Table);\n    const paragraphCount = paragraphs.length;\n    const tableCount = tables.length;\n    const imageCount = imageManager.getImageCount();\n\n    // Estimate XML size using documented constants\n    const estimatedXml =\n      paragraphCount * LIMITS.BYTES_PER_PARAGRAPH +\n      tableCount * LIMITS.BYTES_PER_TABLE +\n      LIMITS.BASE_STRUCTURE_BYTES;\n\n    // Get actual image sizes\n    const imageBytes = imageManager.getTotalSize();\n\n    // Total estimate\n    const totalBytes = estimatedXml + imageBytes;\n    const totalMB = totalBytes / (1024 * 1024);\n\n    // Use documented threshold constants\n    let warning: string | undefined;\n\n    if (totalMB > LIMITS.ERROR_SIZE_MB) {\n      warning =\n        `Document size (${totalMB.toFixed(1)}MB) exceeds recommended maximum of ${LIMITS.ERROR_SIZE_MB}MB. ` +\n        `This may cause memory issues. Consider splitting into multiple documents or optimizing images.`;\n    } else if (totalMB > LIMITS.WARNING_SIZE_MB) {\n      warning =\n        `Document size (${totalMB.toFixed(1)}MB) exceeds ${LIMITS.WARNING_SIZE_MB}MB. ` +\n        `Large documents may take longer to process and use significant memory.`;\n    }\n\n    return {\n      paragraphs: paragraphCount,\n      tables: tableCount,\n      images: imageCount,\n      estimatedXmlBytes: estimatedXml,\n      imageBytes,\n      totalEstimatedBytes: totalBytes,\n      totalEstimatedMB: parseFloat(totalMB.toFixed(2)),\n      warning,\n    };\n  }\n\n  /**\n   * Gets size statistics for the document\n   * @returns Size statistics\n   */\n  getSizeStats(\n    bodyElements: BodyElement[],\n    imageManager: ImageManager\n  ): {\n    elements: { paragraphs: number; tables: number; images: number };\n    size: { xml: string; images: string; total: string };\n    warnings: string[];\n  } {\n    const estimate = this.estimateSize(bodyElements, imageManager);\n    const warnings: string[] = [];\n\n    if (estimate.warning) {\n      warnings.push(estimate.warning);\n    }\n\n    // Format sizes for display\n    const formatBytes = (bytes: number): string => {\n      if (bytes < 1024) return `${bytes} B`;\n      if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;\n      return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;\n    };\n\n    return {\n      elements: {\n        paragraphs: estimate.paragraphs,\n        tables: estimate.tables,\n        images: estimate.images,\n      },\n      size: {\n        xml: formatBytes(estimate.estimatedXmlBytes),\n        images: formatBytes(estimate.imageBytes),\n        total: formatBytes(estimate.totalEstimatedBytes),\n      },\n      warnings,\n    };\n  }\n}\n"]}

package/dist/core/Relationship.js.map

@@ -1 +1 @@
-{"version":3,"file":"Relationship.js","sourceRoot":"","sources":["../../src/core/Relationship.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * Relationship - Represents an OpenXML relationship\r\n *\r\n * Relationships link document parts together (images, headers, footers, styles, etc.)\r\n * They are stored in _rels/*.xml.rels files throughout the document structure.\r\n */\r\n\r\nimport { XMLBuilder } from '../xml/XMLBuilder';\r\n\r\n/**\r\n * Relationship types used in Word documents\r\n */\r\nexport enum RelationshipType {\r\n  /** Link to styles.xml */\r\n  STYLES = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles',\r\n\r\n  /** Link to numbering.xml */\r\n  NUMBERING = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/numbering',\r\n\r\n  /** Link to an image */\r\n  IMAGE = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/image',\r\n\r\n  /** Link to a header */\r\n  HEADER = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/header',\r\n\r\n  /** Link to a footer */\r\n  FOOTER = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer',\r\n\r\n  /** Link to fontTable.xml */\r\n  FONT_TABLE = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/fontTable',\r\n\r\n  /** Link to settings.xml */\r\n  SETTINGS = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/settings',\r\n\r\n  /** Link to theme */\r\n  THEME = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme',\r\n\r\n  /** Link to hyperlink */\r\n  HYPERLINK = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink',\r\n\r\n  /** Link to comments.xml */\r\n  COMMENTS = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments',\r\n\r\n  /** Link to footnotes.xml */\r\n  FOOTNOTES = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/footnotes',\r\n\r\n  /** Link to endnotes.xml */\r\n  ENDNOTES = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/endnotes',\r\n\r\n  /** Link to web settings */\r\n  WEB_SETTINGS = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/webSettings',\r\n\r\n  /** Link to people.xml (track changes authors) */\r\n  PEOPLE = 'http://schemas.microsoft.com/office/2011/relationships/people',\r\n}\r\n\r\n/**\r\n * Properties for creating a relationship\r\n */\r\nexport interface RelationshipProperties {\r\n  /** Relationship ID (e.g., 'rId1', 'rId2') */\r\n  id: string;\r\n\r\n  /** Relationship type (URL defining the relationship type) */\r\n  type: string | RelationshipType;\r\n\r\n  /** Target path (relative to the source part) */\r\n  target: string;\r\n\r\n  /** Target mode (Internal or External) */\r\n  targetMode?: 'Internal' | 'External';\r\n}\r\n\r\n/**\r\n * Represents a single relationship in an OpenXML package\r\n */\r\nexport class Relationship {\r\n  private id: string;\r\n  private type: string;\r\n  private target: string;\r\n  private targetMode: 'Internal' | 'External';\r\n\r\n  /**\r\n   * Creates a new relationship\r\n   * @param properties Relationship properties\r\n   */\r\n  constructor(properties: RelationshipProperties) {\r\n    this.id = properties.id;\r\n    this.type = properties.type;\r\n    this.target = properties.target;\r\n    this.targetMode = properties.targetMode || 'Internal';\r\n\r\n    this.validate();\r\n  }\r\n\r\n  /**\r\n   * Validates the relationship properties\r\n   */\r\n  private validate(): void {\r\n    if (!this.id?.startsWith('rId')) {\r\n      throw new Error(`Relationship ID must start with 'rId', got '${this.id}'`);\r\n    }\r\n\r\n    if (!this.type) {\r\n      throw new Error('Relationship type is required');\r\n    }\r\n\r\n    if (!this.target) {\r\n      throw new Error('Relationship target is required');\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Gets the relationship ID\r\n   */\r\n  getId(): string {\r\n    return this.id;\r\n  }\r\n\r\n  /**\r\n   * Gets the relationship type\r\n   */\r\n  getType(): string {\r\n    return this.type;\r\n  }\r\n\r\n  /**\r\n   * Gets the target path\r\n   */\r\n  getTarget(): string {\r\n    return this.target;\r\n  }\r\n\r\n  /**\r\n   * Sets the target path\r\n   *\r\n   * This method allows updating the target of an existing relationship,\r\n   * which is crucial for properly updating hyperlink URLs without creating\r\n   * orphaned relationships. Per ECMA-376 §9.2, relationships can be modified\r\n   * as long as the ID remains the same.\r\n   *\r\n   * @param target The new target path or URL\r\n   */\r\n  setTarget(target: string): void {\r\n    if (!target) {\r\n      throw new Error('Relationship target cannot be empty');\r\n    }\r\n    this.target = target;\r\n  }\r\n\r\n  /**\r\n   * Gets the target mode\r\n   */\r\n  getTargetMode(): 'Internal' | 'External' {\r\n    return this.targetMode;\r\n  }\r\n\r\n  /**\r\n   * Checks if this relationship is external\r\n   */\r\n  isExternal(): boolean {\r\n    return this.targetMode === 'External';\r\n  }\r\n\r\n  /**\r\n   * Generates XML for this relationship\r\n   *\r\n   * **Security:** All attributes are properly XML-escaped to prevent injection attacks.\r\n   * Per ECMA-376 Part 2 §9, relationship attributes must be escaped.\r\n   */\r\n  toXML(): string {\r\n    // Escape all attributes to prevent XML injection\r\n    const escapedId = XMLBuilder.escapeXmlAttribute(this.id);\r\n    const escapedType = XMLBuilder.escapeXmlAttribute(this.type);\r\n    const escapedTarget = XMLBuilder.escapeXmlAttribute(this.target);\r\n\r\n    let xml = `  <Relationship Id=\"${escapedId}\" Type=\"${escapedType}\" Target=\"${escapedTarget}\"`;\r\n\r\n    if (this.targetMode === 'External') {\r\n      xml += ` TargetMode=\"External\"`;\r\n    }\r\n\r\n    xml += '/>';\r\n    return xml;\r\n  }\r\n\r\n  /**\r\n   * Factory method to create a relationship\r\n   * @param properties Relationship properties\r\n   */\r\n  static create(properties: RelationshipProperties): Relationship {\r\n    return new Relationship(properties);\r\n  }\r\n\r\n  /**\r\n   * Creates a styles relationship\r\n   * @param id Relationship ID\r\n   */\r\n  static createStyles(id = 'rId1'): Relationship {\r\n    return new Relationship({\r\n      id,\r\n      type: RelationshipType.STYLES,\r\n      target: 'styles.xml',\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates a numbering relationship\r\n   * @param id Relationship ID\r\n   */\r\n  static createNumbering(id = 'rId2'): Relationship {\r\n    return new Relationship({\r\n      id,\r\n      type: RelationshipType.NUMBERING,\r\n      target: 'numbering.xml',\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates a fontTable relationship\r\n   * @param id Relationship ID (defaults to 'rId3')\r\n   */\r\n  static createFontTable(id = 'rId3'): Relationship {\r\n    return new Relationship({\r\n      id,\r\n      type: RelationshipType.FONT_TABLE,\r\n      target: 'fontTable.xml',\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates a settings relationship\r\n   * @param id Relationship ID (defaults to 'rId4')\r\n   */\r\n  static createSettings(id = 'rId4'): Relationship {\r\n    return new Relationship({\r\n      id,\r\n      type: RelationshipType.SETTINGS,\r\n      target: 'settings.xml',\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates a webSettings relationship\r\n   * @param id Relationship ID (defaults to 'rId5')\r\n   */\r\n  static createWebSettings(id = 'rId5'): Relationship {\r\n    return new Relationship({\r\n      id,\r\n      type: RelationshipType.WEB_SETTINGS,\r\n      target: 'webSettings.xml',\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates a theme relationship\r\n   * @param id Relationship ID (defaults to 'rId6')\r\n   */\r\n  static createTheme(id = 'rId6'): Relationship {\r\n    return new Relationship({\r\n      id,\r\n      type: RelationshipType.THEME,\r\n      target: 'theme/theme1.xml',\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates an image relationship\r\n   * @param id Relationship ID\r\n   * @param target Image path (e.g., 'media/image1.png')\r\n   */\r\n  static createImage(id: string, target: string): Relationship {\r\n    return new Relationship({\r\n      id,\r\n      type: RelationshipType.IMAGE,\r\n      target,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates a header relationship\r\n   * @param id Relationship ID\r\n   * @param target Header file path (e.g., 'header1.xml')\r\n   */\r\n  static createHeader(id: string, target: string): Relationship {\r\n    return new Relationship({\r\n      id,\r\n      type: RelationshipType.HEADER,\r\n      target,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates a footer relationship\r\n   * @param id Relationship ID\r\n   * @param target Footer file path (e.g., 'footer1.xml')\r\n   */\r\n  static createFooter(id: string, target: string): Relationship {\r\n    return new Relationship({\r\n      id,\r\n      type: RelationshipType.FOOTER,\r\n      target,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates a hyperlink relationship (external)\r\n   * @param id Relationship ID\r\n   * @param url Hyperlink URL\r\n   */\r\n  static createHyperlink(id: string, url: string): Relationship {\r\n    return new Relationship({\r\n      id,\r\n      type: RelationshipType.HYPERLINK,\r\n      target: url,\r\n      targetMode: 'External',\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates a comments relationship\r\n   * @param id Relationship ID (required - use RelationshipManager.generateId())\r\n   */\r\n  static createComments(id: string): Relationship {\r\n    return new Relationship({\r\n      id,\r\n      type: RelationshipType.COMMENTS,\r\n      target: 'comments.xml',\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates a footnotes relationship\r\n   * @param id Relationship ID (required - use RelationshipManager.generateId())\r\n   */\r\n  static createFootnotes(id: string): Relationship {\r\n    return new Relationship({\r\n      id,\r\n      type: RelationshipType.FOOTNOTES,\r\n      target: 'footnotes.xml',\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates an endnotes relationship\r\n   * @param id Relationship ID (required - use RelationshipManager.generateId())\r\n   */\r\n  static createEndnotes(id: string): Relationship {\r\n    return new Relationship({\r\n      id,\r\n      type: RelationshipType.ENDNOTES,\r\n      target: 'endnotes.xml',\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates a people relationship (track changes authors)\r\n   * @param id Relationship ID (required - use RelationshipManager.generateId())\r\n   */\r\n  static createPeople(id: string): Relationship {\r\n    return new Relationship({\r\n      id,\r\n      type: RelationshipType.PEOPLE,\r\n      target: 'people.xml',\r\n    });\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Relationship.js","sourceRoot":"","sources":["../../src/core/Relationship.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Relationship - Represents an OpenXML relationship\n *\n * Relationships link document parts together (images, headers, footers, styles, etc.)\n * They are stored in _rels/*.xml.rels files throughout the document structure.\n */\n\nimport { XMLBuilder } from '../xml/XMLBuilder';\n\n/**\n * Relationship types used in Word documents\n */\nexport enum RelationshipType {\n  /** Link to styles.xml */\n  STYLES = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles',\n\n  /** Link to numbering.xml */\n  NUMBERING = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/numbering',\n\n  /** Link to an image */\n  IMAGE = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/image',\n\n  /** Link to a header */\n  HEADER = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/header',\n\n  /** Link to a footer */\n  FOOTER = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer',\n\n  /** Link to fontTable.xml */\n  FONT_TABLE = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/fontTable',\n\n  /** Link to settings.xml */\n  SETTINGS = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/settings',\n\n  /** Link to theme */\n  THEME = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme',\n\n  /** Link to hyperlink */\n  HYPERLINK = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink',\n\n  /** Link to comments.xml */\n  COMMENTS = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments',\n\n  /** Link to footnotes.xml */\n  FOOTNOTES = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/footnotes',\n\n  /** Link to endnotes.xml */\n  ENDNOTES = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/endnotes',\n\n  /** Link to web settings */\n  WEB_SETTINGS = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/webSettings',\n\n  /** Link to people.xml (track changes authors) */\n  PEOPLE = 'http://schemas.microsoft.com/office/2011/relationships/people',\n}\n\n/**\n * Properties for creating a relationship\n */\nexport interface RelationshipProperties {\n  /** Relationship ID (e.g., 'rId1', 'rId2') */\n  id: string;\n\n  /** Relationship type (URL defining the relationship type) */\n  type: string | RelationshipType;\n\n  /** Target path (relative to the source part) */\n  target: string;\n\n  /** Target mode (Internal or External) */\n  targetMode?: 'Internal' | 'External';\n}\n\n/**\n * Represents a single relationship in an OpenXML package\n */\nexport class Relationship {\n  private id: string;\n  private type: string;\n  private target: string;\n  private targetMode: 'Internal' | 'External';\n\n  /**\n   * Creates a new relationship\n   * @param properties Relationship properties\n   */\n  constructor(properties: RelationshipProperties) {\n    this.id = properties.id;\n    this.type = properties.type;\n    this.target = properties.target;\n    this.targetMode = properties.targetMode || 'Internal';\n\n    this.validate();\n  }\n\n  /**\n   * Validates the relationship properties\n   */\n  private validate(): void {\n    if (!this.id?.startsWith('rId')) {\n      throw new Error(`Relationship ID must start with 'rId', got '${this.id}'`);\n    }\n\n    if (!this.type) {\n      throw new Error('Relationship type is required');\n    }\n\n    if (!this.target) {\n      throw new Error('Relationship target is required');\n    }\n  }\n\n  /**\n   * Gets the relationship ID\n   */\n  getId(): string {\n    return this.id;\n  }\n\n  /**\n   * Gets the relationship type\n   */\n  getType(): string {\n    return this.type;\n  }\n\n  /**\n   * Gets the target path\n   */\n  getTarget(): string {\n    return this.target;\n  }\n\n  /**\n   * Sets the target path\n   *\n   * This method allows updating the target of an existing relationship,\n   * which is crucial for properly updating hyperlink URLs without creating\n   * orphaned relationships. Per ECMA-376 §9.2, relationships can be modified\n   * as long as the ID remains the same.\n   *\n   * @param target The new target path or URL\n   */\n  setTarget(target: string): void {\n    if (!target) {\n      throw new Error('Relationship target cannot be empty');\n    }\n    this.target = target;\n  }\n\n  /**\n   * Gets the target mode\n   */\n  getTargetMode(): 'Internal' | 'External' {\n    return this.targetMode;\n  }\n\n  /**\n   * Checks if this relationship is external\n   */\n  isExternal(): boolean {\n    return this.targetMode === 'External';\n  }\n\n  /**\n   * Generates XML for this relationship\n   *\n   * **Security:** All attributes are properly XML-escaped to prevent injection attacks.\n   * Per ECMA-376 Part 2 §9, relationship attributes must be escaped.\n   */\n  toXML(): string {\n    // Escape all attributes to prevent XML injection\n    const escapedId = XMLBuilder.escapeXmlAttribute(this.id);\n    const escapedType = XMLBuilder.escapeXmlAttribute(this.type);\n    const escapedTarget = XMLBuilder.escapeXmlAttribute(this.target);\n\n    let xml = `  <Relationship Id=\"${escapedId}\" Type=\"${escapedType}\" Target=\"${escapedTarget}\"`;\n\n    if (this.targetMode === 'External') {\n      xml += ` TargetMode=\"External\"`;\n    }\n\n    xml += '/>';\n    return xml;\n  }\n\n  /**\n   * Factory method to create a relationship\n   * @param properties Relationship properties\n   */\n  static create(properties: RelationshipProperties): Relationship {\n    return new Relationship(properties);\n  }\n\n  /**\n   * Creates a styles relationship\n   * @param id Relationship ID\n   */\n  static createStyles(id = 'rId1'): Relationship {\n    return new Relationship({\n      id,\n      type: RelationshipType.STYLES,\n      target: 'styles.xml',\n    });\n  }\n\n  /**\n   * Creates a numbering relationship\n   * @param id Relationship ID\n   */\n  static createNumbering(id = 'rId2'): Relationship {\n    return new Relationship({\n      id,\n      type: RelationshipType.NUMBERING,\n      target: 'numbering.xml',\n    });\n  }\n\n  /**\n   * Creates a fontTable relationship\n   * @param id Relationship ID (defaults to 'rId3')\n   */\n  static createFontTable(id = 'rId3'): Relationship {\n    return new Relationship({\n      id,\n      type: RelationshipType.FONT_TABLE,\n      target: 'fontTable.xml',\n    });\n  }\n\n  /**\n   * Creates a settings relationship\n   * @param id Relationship ID (defaults to 'rId4')\n   */\n  static createSettings(id = 'rId4'): Relationship {\n    return new Relationship({\n      id,\n      type: RelationshipType.SETTINGS,\n      target: 'settings.xml',\n    });\n  }\n\n  /**\n   * Creates a webSettings relationship\n   * @param id Relationship ID (defaults to 'rId5')\n   */\n  static createWebSettings(id = 'rId5'): Relationship {\n    return new Relationship({\n      id,\n      type: RelationshipType.WEB_SETTINGS,\n      target: 'webSettings.xml',\n    });\n  }\n\n  /**\n   * Creates a theme relationship\n   * @param id Relationship ID (defaults to 'rId6')\n   */\n  static createTheme(id = 'rId6'): Relationship {\n    return new Relationship({\n      id,\n      type: RelationshipType.THEME,\n      target: 'theme/theme1.xml',\n    });\n  }\n\n  /**\n   * Creates an image relationship\n   * @param id Relationship ID\n   * @param target Image path (e.g., 'media/image1.png')\n   */\n  static createImage(id: string, target: string): Relationship {\n    return new Relationship({\n      id,\n      type: RelationshipType.IMAGE,\n      target,\n    });\n  }\n\n  /**\n   * Creates a header relationship\n   * @param id Relationship ID\n   * @param target Header file path (e.g., 'header1.xml')\n   */\n  static createHeader(id: string, target: string): Relationship {\n    return new Relationship({\n      id,\n      type: RelationshipType.HEADER,\n      target,\n    });\n  }\n\n  /**\n   * Creates a footer relationship\n   * @param id Relationship ID\n   * @param target Footer file path (e.g., 'footer1.xml')\n   */\n  static createFooter(id: string, target: string): Relationship {\n    return new Relationship({\n      id,\n      type: RelationshipType.FOOTER,\n      target,\n    });\n  }\n\n  /**\n   * Creates a hyperlink relationship (external)\n   * @param id Relationship ID\n   * @param url Hyperlink URL\n   */\n  static createHyperlink(id: string, url: string): Relationship {\n    return new Relationship({\n      id,\n      type: RelationshipType.HYPERLINK,\n      target: url,\n      targetMode: 'External',\n    });\n  }\n\n  /**\n   * Creates a comments relationship\n   * @param id Relationship ID (required - use RelationshipManager.generateId())\n   */\n  static createComments(id: string): Relationship {\n    return new Relationship({\n      id,\n      type: RelationshipType.COMMENTS,\n      target: 'comments.xml',\n    });\n  }\n\n  /**\n   * Creates a footnotes relationship\n   * @param id Relationship ID (required - use RelationshipManager.generateId())\n   */\n  static createFootnotes(id: string): Relationship {\n    return new Relationship({\n      id,\n      type: RelationshipType.FOOTNOTES,\n      target: 'footnotes.xml',\n    });\n  }\n\n  /**\n   * Creates an endnotes relationship\n   * @param id Relationship ID (required - use RelationshipManager.generateId())\n   */\n  static createEndnotes(id: string): Relationship {\n    return new Relationship({\n      id,\n      type: RelationshipType.ENDNOTES,\n      target: 'endnotes.xml',\n    });\n  }\n\n  /**\n   * Creates a people relationship (track changes authors)\n   * @param id Relationship ID (required - use RelationshipManager.generateId())\n   */\n  static createPeople(id: string): Relationship {\n    return new Relationship({\n      id,\n      type: RelationshipType.PEOPLE,\n      target: 'people.xml',\n    });\n  }\n}\n"]}

package/dist/core/RelationshipManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RelationshipManager.d.ts","sourceRoot":"","sources":["../../src/core/RelationshipManager.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAMhE,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,MAAM,CAAS;;IAevB,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,YAAY;IAmBzD,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAOrD,mBAAmB,IAAI,YAAY,EAAE;IAQrC,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,YAAY,EAAE;IAQvE,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IASpC,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAOvC,QAAQ,IAAI,MAAM;IAOlB,KAAK,IAAI,IAAI;IAUb,UAAU,IAAI,MAAM;IAQpB,SAAS,IAAI,YAAY;IASzB,YAAY,IAAI,YAAY;IAS5B,YAAY,IAAI,YAAY;IAS5B,WAAW,IAAI,YAAY;IAS3B,cAAc,IAAI,YAAY;IAS9B,QAAQ,IAAI,YAAY;IAUxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAUtC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAUvC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAUvC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY;IAgBvC,qBAAqB,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAyBtE,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAgBlE,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY;IAqB/C,wBAAwB,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM;IAyB5D,WAAW,IAAI,YAAY;IAS3B,YAAY,IAAI,YAAY;IAS5B,WAAW,IAAI,YAAY;IAS3B,SAAS,IAAI,YAAY;IASzB,WAAW,IAAI,MAAM;IAmBrB,MAAM,CAAC,iBAAiB,IAAI,mBAAmB;IAe/C,MAAM,CAAC,MAAM,IAAI,mBAAmB;IASpC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB;CA+CjD"}
+{"version":3,"file":"RelationshipManager.d.ts","sourceRoot":"","sources":["../../src/core/RelationshipManager.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAMhE,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,MAAM,CAAS;;IAevB,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,YAAY;IAmBzD,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAOrD,mBAAmB,IAAI,YAAY,EAAE;IAQrC,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,YAAY,EAAE;IAQvE,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IASpC,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAOvC,QAAQ,IAAI,MAAM;IAOlB,KAAK,IAAI,IAAI;IAUb,UAAU,IAAI,MAAM;IAQpB,SAAS,IAAI,YAAY;IASzB,YAAY,IAAI,YAAY;IAS5B,YAAY,IAAI,YAAY;IAS5B,WAAW,IAAI,YAAY;IAS3B,cAAc,IAAI,YAAY;IAS9B,QAAQ,IAAI,YAAY;IAUxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAUtC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAUvC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAUvC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY;IAgBvC,qBAAqB,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAyBtE,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAgBlE,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY;IAqB/C,wBAAwB,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM;IAyB5D,WAAW,IAAI,YAAY;IAS3B,YAAY,IAAI,YAAY;IAS5B,WAAW,IAAI,YAAY;IAS3B,SAAS,IAAI,YAAY;IASzB,WAAW,IAAI,MAAM;IAmBrB,MAAM,CAAC,iBAAiB,IAAI,mBAAmB;IAe/C,MAAM,CAAC,MAAM,IAAI,mBAAmB;IASpC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB;CAgDjD"}

package/dist/core/RelationshipManager.js

@@ -28,7 +28,7 @@ class RelationshipManager {
         return Array.from(this.relationships.values());
     }
     getRelationshipsByType(type) {
-        return this.getAllRelationships().filter(rel => rel.getType() === type);
+        return this.getAllRelationships().filter((rel) => rel.getType() === type);
     }
     hasRelationship(id) {
         return this.relationships.has(id);
@@ -100,7 +100,7 @@ class RelationshipManager {
         return true;
     }
     findHyperlinkByTarget(targetUrl) {
-        return this.getAllRelationships().find(rel => rel.getType() === Relationship_1.RelationshipType.HYPERLINK && rel.getTarget() === targetUrl);
+        return this.getAllRelationships().find((rel) => rel.getType() === Relationship_1.RelationshipType.HYPERLINK && rel.getTarget() === targetUrl);
     }
     getOrCreateHyperlink(url) {
         const existing = this.findHyperlinkByTarget(url);
@@ -179,7 +179,7 @@ class RelationshipManager {
             const targetMode = XMLParser_1.XMLParser.extractAttribute(relationshipElement, 'TargetMode');
             if (id && type && target) {
                 const validatedTargetMode = targetMode === 'Internal' || targetMode === 'External' || targetMode === undefined
-                    ? (targetMode)
+                    ? targetMode
                     : undefined;
                 const relationship = Relationship_1.Relationship.create({
                     id,

package/dist/core/RelationshipManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"RelationshipManager.js","sourceRoot":"","sources":["../../src/core/RelationshipManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * RelationshipManager - Manages collections of relationships\r\n *\r\n * Handles relationship creation, tracking, and XML generation for various\r\n * document parts (document.xml, header.xml, footer.xml, etc.)\r\n */\r\n\r\nimport { Relationship, RelationshipType } from './Relationship';\r\nimport { XMLParser } from '../xml/XMLParser';\r\n\r\n/**\r\n * Manages relationships for a document or document part\r\n */\r\nexport class RelationshipManager {\r\n  private relationships: Map<string, Relationship>;\r\n  private nextId: number;\r\n\r\n  /**\r\n   * Creates a new relationship manager\r\n   */\r\n  constructor() {\r\n    this.relationships = new Map();\r\n    this.nextId = 1;\r\n  }\r\n\r\n  /**\r\n   * Adds a relationship\r\n   * @param relationship The relationship to add\r\n   * @returns The relationship that was added\r\n   */\r\n  addRelationship(relationship: Relationship): Relationship {\r\n    this.relationships.set(relationship.getId(), relationship);\r\n\r\n    // Update next ID if necessary\r\n    const idMatch = /^rId(\\d+)$/.exec(relationship.getId());\r\n    if (idMatch?.[1]) {\r\n      const idNum = parseInt(idMatch[1], 10);\r\n      if (idNum >= this.nextId) {\r\n        this.nextId = idNum + 1;\r\n      }\r\n    }\r\n\r\n    return relationship;\r\n  }\r\n\r\n  /**\r\n   * Gets a relationship by ID\r\n   * @param id The relationship ID\r\n   */\r\n  getRelationship(id: string): Relationship | undefined {\r\n    return this.relationships.get(id);\r\n  }\r\n\r\n  /**\r\n   * Gets all relationships\r\n   */\r\n  getAllRelationships(): Relationship[] {\r\n    return Array.from(this.relationships.values());\r\n  }\r\n\r\n  /**\r\n   * Gets relationships of a specific type\r\n   * @param type The relationship type\r\n   */\r\n  getRelationshipsByType(type: string | RelationshipType): Relationship[] {\r\n    return this.getAllRelationships().filter(rel => rel.getType() === type);\r\n  }\r\n\r\n  /**\r\n   * Checks if a relationship exists\r\n   * @param id The relationship ID\r\n   */\r\n  hasRelationship(id: string): boolean {\r\n    return this.relationships.has(id);\r\n  }\r\n\r\n  /**\r\n   * Removes a relationship\r\n   * @param id The relationship ID\r\n   * @returns True if removed, false if not found\r\n   */\r\n  removeRelationship(id: string): boolean {\r\n    return this.relationships.delete(id);\r\n  }\r\n\r\n  /**\r\n   * Gets the number of relationships\r\n   */\r\n  getCount(): number {\r\n    return this.relationships.size;\r\n  }\r\n\r\n  /**\r\n   * Clears all relationships\r\n   */\r\n  clear(): this {\r\n    this.relationships.clear();\r\n    this.nextId = 1;\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Generates a new unique relationship ID\r\n   * @returns New relationship ID (e.g., 'rId1', 'rId2')\r\n   */\r\n  generateId(): string {\r\n    return `rId${this.nextId++}`;\r\n  }\r\n\r\n  /**\r\n   * Adds a styles relationship\r\n   * @returns The created relationship\r\n   */\r\n  addStyles(): Relationship {\r\n    const id = this.generateId();\r\n    return this.addRelationship(Relationship.createStyles(id));\r\n  }\r\n\r\n  /**\r\n   * Adds a numbering relationship\r\n   * @returns The created relationship\r\n   */\r\n  addNumbering(): Relationship {\r\n    const id = this.generateId();\r\n    return this.addRelationship(Relationship.createNumbering(id));\r\n  }\r\n\r\n  /**\r\n   * Adds a fontTable relationship\r\n   * @returns The created relationship\r\n   */\r\n  addFontTable(): Relationship {\r\n    const id = this.generateId();\r\n    return this.addRelationship(Relationship.createFontTable(id));\r\n  }\r\n\r\n  /**\r\n   * Adds a settings relationship\r\n   * @returns The created relationship\r\n   */\r\n  addSettings(): Relationship {\r\n    const id = this.generateId();\r\n    return this.addRelationship(Relationship.createSettings(id));\r\n  }\r\n\r\n  /**\r\n   * Adds a webSettings relationship\r\n   * @returns The created relationship\r\n   */\r\n  addWebSettings(): Relationship {\r\n    const id = this.generateId();\r\n    return this.addRelationship(Relationship.createWebSettings(id));\r\n  }\r\n\r\n  /**\r\n   * Adds a theme relationship\r\n   * @returns The created relationship\r\n   */\r\n  addTheme(): Relationship {\r\n    const id = this.generateId();\r\n    return this.addRelationship(Relationship.createTheme(id));\r\n  }\r\n\r\n  /**\r\n   * Adds an image relationship\r\n   * @param target Image path relative to the part (e.g., 'media/image1.png')\r\n   * @returns The created relationship\r\n   */\r\n  addImage(target: string): Relationship {\r\n    const id = this.generateId();\r\n    return this.addRelationship(Relationship.createImage(id, target));\r\n  }\r\n\r\n  /**\r\n   * Adds a header relationship\r\n   * @param target Header file path (e.g., 'header1.xml')\r\n   * @returns The created relationship\r\n   */\r\n  addHeader(target: string): Relationship {\r\n    const id = this.generateId();\r\n    return this.addRelationship(Relationship.createHeader(id, target));\r\n  }\r\n\r\n  /**\r\n   * Adds a footer relationship\r\n   * @param target Footer file path (e.g., 'footer1.xml')\r\n   * @returns The created relationship\r\n   */\r\n  addFooter(target: string): Relationship {\r\n    const id = this.generateId();\r\n    return this.addRelationship(Relationship.createFooter(id, target));\r\n  }\r\n\r\n  /**\r\n   * Adds a hyperlink relationship\r\n   * @param url The hyperlink URL\r\n   * @returns The created relationship\r\n   */\r\n  addHyperlink(url: string): Relationship {\r\n    const id = this.generateId();\r\n    return this.addRelationship(Relationship.createHyperlink(id, url));\r\n  }\r\n\r\n  /**\r\n   * Updates the target URL of an existing hyperlink relationship\r\n   *\r\n   * This method modifies an existing relationship's target in-place, maintaining\r\n   * the same relationship ID. This is crucial for proper OpenXML compliance\r\n   * per ECMA-376 §17.16.22, as it prevents orphaned relationships.\r\n   *\r\n   * @param relationshipId The ID of the relationship to update\r\n   * @param newUrl The new URL to set\r\n   * @returns True if updated, false if relationship not found\r\n   */\r\n  updateHyperlinkTarget(relationshipId: string, newUrl: string): boolean {\r\n    const relationship = this.getRelationship(relationshipId);\r\n    if (!relationship) {\r\n      return false;\r\n    }\r\n\r\n    // Verify this is a hyperlink relationship\r\n    if (relationship.getType() !== RelationshipType.HYPERLINK) {\r\n      throw new Error(\r\n        `Relationship ${relationshipId} is not a hyperlink relationship. ` +\r\n        `Type is ${relationship.getType()}, expected ${RelationshipType.HYPERLINK}`\r\n      );\r\n    }\r\n\r\n    // Update the target URL\r\n    relationship.setTarget(newUrl);\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Finds a hyperlink relationship by its target URL\r\n   *\r\n   * @param targetUrl The URL to search for\r\n   * @returns The matching relationship, or undefined if not found\r\n   */\r\n  findHyperlinkByTarget(targetUrl: string): Relationship | undefined {\r\n    return this.getAllRelationships().find(\r\n      rel => rel.getType() === RelationshipType.HYPERLINK && rel.getTarget() === targetUrl\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Gets or creates a hyperlink relationship for the given URL\r\n   *\r\n   * This method ensures we don't create duplicate relationships for the same URL.\r\n   * If a relationship already exists for the URL, it returns the existing one.\r\n   * Otherwise, it creates a new relationship.\r\n   *\r\n   * @param url The hyperlink URL\r\n   * @returns The existing or newly created relationship\r\n   */\r\n  getOrCreateHyperlink(url: string): Relationship {\r\n    // Check if relationship already exists for this URL\r\n    const existing = this.findHyperlinkByTarget(url);\r\n    if (existing) {\r\n      return existing;\r\n    }\r\n\r\n    // Create new relationship\r\n    return this.addHyperlink(url);\r\n  }\r\n\r\n  /**\r\n   * Removes orphaned hyperlink relationships\r\n   *\r\n   * This method removes hyperlink relationships that are no longer referenced\r\n   * by any hyperlink in the document. Call this after updating URLs to clean\r\n   * up any orphaned relationships.\r\n   *\r\n   * @param referencedIds Set of relationship IDs that are still in use\r\n   * @returns Number of relationships removed\r\n   */\r\n  removeOrphanedHyperlinks(referencedIds: Set<string>): number {\r\n    let removed = 0;\r\n    const toRemove: string[] = [];\r\n\r\n    // Find orphaned relationships\r\n    for (const rel of this.getAllRelationships()) {\r\n      if (rel.getType() === RelationshipType.HYPERLINK && !referencedIds.has(rel.getId())) {\r\n        toRemove.push(rel.getId());\r\n      }\r\n    }\r\n\r\n    // Remove orphaned relationships\r\n    for (const id of toRemove) {\r\n      if (this.removeRelationship(id)) {\r\n        removed++;\r\n      }\r\n    }\r\n\r\n    return removed;\r\n  }\r\n\r\n  /**\r\n   * Adds a comments relationship\r\n   * @returns The created relationship\r\n   */\r\n  addComments(): Relationship {\r\n    const id = this.generateId();\r\n    return this.addRelationship(Relationship.createComments(id));\r\n  }\r\n\r\n  /**\r\n   * Adds a footnotes relationship\r\n   * @returns The created relationship\r\n   */\r\n  addFootnotes(): Relationship {\r\n    const id = this.generateId();\r\n    return this.addRelationship(Relationship.createFootnotes(id));\r\n  }\r\n\r\n  /**\r\n   * Adds an endnotes relationship\r\n   * @returns The created relationship\r\n   */\r\n  addEndnotes(): Relationship {\r\n    const id = this.generateId();\r\n    return this.addRelationship(Relationship.createEndnotes(id));\r\n  }\r\n\r\n  /**\r\n   * Adds a people relationship (track changes authors)\r\n   * @returns The created relationship\r\n   */\r\n  addPeople(): Relationship {\r\n    const id = this.generateId();\r\n    return this.addRelationship(Relationship.createPeople(id));\r\n  }\r\n\r\n  /**\r\n   * Generates the relationships XML file content\r\n   * @returns Complete XML string for .rels file\r\n   */\r\n  generateXml(): string {\r\n    const relationships = this.getAllRelationships();\r\n\r\n    let xml = '<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\\n';\r\n    xml += '<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\">\\n';\r\n\r\n    for (const rel of relationships) {\r\n      xml += rel.toXML() + '\\n';\r\n    }\r\n\r\n    xml += '</Relationships>';\r\n\r\n    return xml;\r\n  }\r\n\r\n  /**\r\n   * Creates a new relationship manager with common document relationships\r\n   * @returns RelationshipManager with styles, numbering, fontTable, settings, and theme relationships\r\n   */\r\n  static createForDocument(): RelationshipManager {\r\n    const manager = new RelationshipManager();\r\n    manager.addStyles();\r\n    manager.addNumbering();\r\n    manager.addFontTable();\r\n    manager.addSettings();\r\n    manager.addWebSettings();\r\n    manager.addTheme();\r\n    return manager;\r\n  }\r\n\r\n  /**\r\n   * Creates an empty relationship manager\r\n   * @returns Empty RelationshipManager\r\n   */\r\n  static create(): RelationshipManager {\r\n    return new RelationshipManager();\r\n  }\r\n\r\n  /**\r\n   * Parses relationships from XML string and creates a populated manager\r\n   * @param xml The relationships XML content (.rels file)\r\n   * @returns RelationshipManager with parsed relationships\r\n   */\r\n  static fromXml(xml: string): RelationshipManager {\r\n    const manager = new RelationshipManager();\r\n\r\n    // Prevent ReDoS: validate input size (typical .rels files are < 10KB)\r\n    if (xml.length > 100000) {\r\n      throw new Error('Relationships XML file too large (>100KB). Possible malicious input or corrupted file.');\r\n    }\r\n\r\n    // Use XMLParser to extract all Relationship elements\r\n    const relationshipElements = XMLParser.extractElements(xml, 'Relationship');\r\n\r\n    // Prevent infinite loops: check relationship count\r\n    if (relationshipElements.length > 1000) {\r\n      throw new Error('Too many relationships in XML file (>1000). Possible malicious input.');\r\n    }\r\n\r\n    // Process each relationship element\r\n    for (const relationshipElement of relationshipElements) {\r\n      // Extract attributes using XMLParser\r\n      const id = XMLParser.extractAttribute(relationshipElement, 'Id');\r\n      const type = XMLParser.extractAttribute(relationshipElement, 'Type');\r\n      const target = XMLParser.extractAttribute(relationshipElement, 'Target');\r\n      const targetMode = XMLParser.extractAttribute(relationshipElement, 'TargetMode');\r\n\r\n      // Only create relationship if all required attributes present\r\n      if (id && type && target) {\r\n        // Validate targetMode before type assertion\r\n        const validatedTargetMode =\r\n          targetMode === 'Internal' || targetMode === 'External' || targetMode === undefined\r\n            ? (targetMode)\r\n            : undefined;\r\n\r\n        // Create and add relationship\r\n        const relationship = Relationship.create({\r\n          id,\r\n          type,\r\n          target,\r\n          targetMode: validatedTargetMode || 'Internal',\r\n        });\r\n\r\n        manager.addRelationship(relationship);\r\n      }\r\n    }\r\n\r\n    return manager;\r\n  }\r\n\r\n}\r\n"]}
+{"version":3,"file":"RelationshipManager.js","sourceRoot":"","sources":["../../src/core/RelationshipManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * RelationshipManager - Manages collections of relationships\n *\n * Handles relationship creation, tracking, and XML generation for various\n * document parts (document.xml, header.xml, footer.xml, etc.)\n */\n\nimport { Relationship, RelationshipType } from './Relationship';\nimport { XMLParser } from '../xml/XMLParser';\n\n/**\n * Manages relationships for a document or document part\n */\nexport class RelationshipManager {\n  private relationships: Map<string, Relationship>;\n  private nextId: number;\n\n  /**\n   * Creates a new relationship manager\n   */\n  constructor() {\n    this.relationships = new Map();\n    this.nextId = 1;\n  }\n\n  /**\n   * Adds a relationship\n   * @param relationship The relationship to add\n   * @returns The relationship that was added\n   */\n  addRelationship(relationship: Relationship): Relationship {\n    this.relationships.set(relationship.getId(), relationship);\n\n    // Update next ID if necessary\n    const idMatch = /^rId(\\d+)$/.exec(relationship.getId());\n    if (idMatch?.[1]) {\n      const idNum = parseInt(idMatch[1], 10);\n      if (idNum >= this.nextId) {\n        this.nextId = idNum + 1;\n      }\n    }\n\n    return relationship;\n  }\n\n  /**\n   * Gets a relationship by ID\n   * @param id The relationship ID\n   */\n  getRelationship(id: string): Relationship | undefined {\n    return this.relationships.get(id);\n  }\n\n  /**\n   * Gets all relationships\n   */\n  getAllRelationships(): Relationship[] {\n    return Array.from(this.relationships.values());\n  }\n\n  /**\n   * Gets relationships of a specific type\n   * @param type The relationship type\n   */\n  getRelationshipsByType(type: string | RelationshipType): Relationship[] {\n    return this.getAllRelationships().filter((rel) => rel.getType() === type);\n  }\n\n  /**\n   * Checks if a relationship exists\n   * @param id The relationship ID\n   */\n  hasRelationship(id: string): boolean {\n    return this.relationships.has(id);\n  }\n\n  /**\n   * Removes a relationship\n   * @param id The relationship ID\n   * @returns True if removed, false if not found\n   */\n  removeRelationship(id: string): boolean {\n    return this.relationships.delete(id);\n  }\n\n  /**\n   * Gets the number of relationships\n   */\n  getCount(): number {\n    return this.relationships.size;\n  }\n\n  /**\n   * Clears all relationships\n   */\n  clear(): this {\n    this.relationships.clear();\n    this.nextId = 1;\n    return this;\n  }\n\n  /**\n   * Generates a new unique relationship ID\n   * @returns New relationship ID (e.g., 'rId1', 'rId2')\n   */\n  generateId(): string {\n    return `rId${this.nextId++}`;\n  }\n\n  /**\n   * Adds a styles relationship\n   * @returns The created relationship\n   */\n  addStyles(): Relationship {\n    const id = this.generateId();\n    return this.addRelationship(Relationship.createStyles(id));\n  }\n\n  /**\n   * Adds a numbering relationship\n   * @returns The created relationship\n   */\n  addNumbering(): Relationship {\n    const id = this.generateId();\n    return this.addRelationship(Relationship.createNumbering(id));\n  }\n\n  /**\n   * Adds a fontTable relationship\n   * @returns The created relationship\n   */\n  addFontTable(): Relationship {\n    const id = this.generateId();\n    return this.addRelationship(Relationship.createFontTable(id));\n  }\n\n  /**\n   * Adds a settings relationship\n   * @returns The created relationship\n   */\n  addSettings(): Relationship {\n    const id = this.generateId();\n    return this.addRelationship(Relationship.createSettings(id));\n  }\n\n  /**\n   * Adds a webSettings relationship\n   * @returns The created relationship\n   */\n  addWebSettings(): Relationship {\n    const id = this.generateId();\n    return this.addRelationship(Relationship.createWebSettings(id));\n  }\n\n  /**\n   * Adds a theme relationship\n   * @returns The created relationship\n   */\n  addTheme(): Relationship {\n    const id = this.generateId();\n    return this.addRelationship(Relationship.createTheme(id));\n  }\n\n  /**\n   * Adds an image relationship\n   * @param target Image path relative to the part (e.g., 'media/image1.png')\n   * @returns The created relationship\n   */\n  addImage(target: string): Relationship {\n    const id = this.generateId();\n    return this.addRelationship(Relationship.createImage(id, target));\n  }\n\n  /**\n   * Adds a header relationship\n   * @param target Header file path (e.g., 'header1.xml')\n   * @returns The created relationship\n   */\n  addHeader(target: string): Relationship {\n    const id = this.generateId();\n    return this.addRelationship(Relationship.createHeader(id, target));\n  }\n\n  /**\n   * Adds a footer relationship\n   * @param target Footer file path (e.g., 'footer1.xml')\n   * @returns The created relationship\n   */\n  addFooter(target: string): Relationship {\n    const id = this.generateId();\n    return this.addRelationship(Relationship.createFooter(id, target));\n  }\n\n  /**\n   * Adds a hyperlink relationship\n   * @param url The hyperlink URL\n   * @returns The created relationship\n   */\n  addHyperlink(url: string): Relationship {\n    const id = this.generateId();\n    return this.addRelationship(Relationship.createHyperlink(id, url));\n  }\n\n  /**\n   * Updates the target URL of an existing hyperlink relationship\n   *\n   * This method modifies an existing relationship's target in-place, maintaining\n   * the same relationship ID. This is crucial for proper OpenXML compliance\n   * per ECMA-376 §17.16.22, as it prevents orphaned relationships.\n   *\n   * @param relationshipId The ID of the relationship to update\n   * @param newUrl The new URL to set\n   * @returns True if updated, false if relationship not found\n   */\n  updateHyperlinkTarget(relationshipId: string, newUrl: string): boolean {\n    const relationship = this.getRelationship(relationshipId);\n    if (!relationship) {\n      return false;\n    }\n\n    // Verify this is a hyperlink relationship\n    if (relationship.getType() !== RelationshipType.HYPERLINK) {\n      throw new Error(\n        `Relationship ${relationshipId} is not a hyperlink relationship. ` +\n          `Type is ${relationship.getType()}, expected ${RelationshipType.HYPERLINK}`\n      );\n    }\n\n    // Update the target URL\n    relationship.setTarget(newUrl);\n    return true;\n  }\n\n  /**\n   * Finds a hyperlink relationship by its target URL\n   *\n   * @param targetUrl The URL to search for\n   * @returns The matching relationship, or undefined if not found\n   */\n  findHyperlinkByTarget(targetUrl: string): Relationship | undefined {\n    return this.getAllRelationships().find(\n      (rel) => rel.getType() === RelationshipType.HYPERLINK && rel.getTarget() === targetUrl\n    );\n  }\n\n  /**\n   * Gets or creates a hyperlink relationship for the given URL\n   *\n   * This method ensures we don't create duplicate relationships for the same URL.\n   * If a relationship already exists for the URL, it returns the existing one.\n   * Otherwise, it creates a new relationship.\n   *\n   * @param url The hyperlink URL\n   * @returns The existing or newly created relationship\n   */\n  getOrCreateHyperlink(url: string): Relationship {\n    // Check if relationship already exists for this URL\n    const existing = this.findHyperlinkByTarget(url);\n    if (existing) {\n      return existing;\n    }\n\n    // Create new relationship\n    return this.addHyperlink(url);\n  }\n\n  /**\n   * Removes orphaned hyperlink relationships\n   *\n   * This method removes hyperlink relationships that are no longer referenced\n   * by any hyperlink in the document. Call this after updating URLs to clean\n   * up any orphaned relationships.\n   *\n   * @param referencedIds Set of relationship IDs that are still in use\n   * @returns Number of relationships removed\n   */\n  removeOrphanedHyperlinks(referencedIds: Set<string>): number {\n    let removed = 0;\n    const toRemove: string[] = [];\n\n    // Find orphaned relationships\n    for (const rel of this.getAllRelationships()) {\n      if (rel.getType() === RelationshipType.HYPERLINK && !referencedIds.has(rel.getId())) {\n        toRemove.push(rel.getId());\n      }\n    }\n\n    // Remove orphaned relationships\n    for (const id of toRemove) {\n      if (this.removeRelationship(id)) {\n        removed++;\n      }\n    }\n\n    return removed;\n  }\n\n  /**\n   * Adds a comments relationship\n   * @returns The created relationship\n   */\n  addComments(): Relationship {\n    const id = this.generateId();\n    return this.addRelationship(Relationship.createComments(id));\n  }\n\n  /**\n   * Adds a footnotes relationship\n   * @returns The created relationship\n   */\n  addFootnotes(): Relationship {\n    const id = this.generateId();\n    return this.addRelationship(Relationship.createFootnotes(id));\n  }\n\n  /**\n   * Adds an endnotes relationship\n   * @returns The created relationship\n   */\n  addEndnotes(): Relationship {\n    const id = this.generateId();\n    return this.addRelationship(Relationship.createEndnotes(id));\n  }\n\n  /**\n   * Adds a people relationship (track changes authors)\n   * @returns The created relationship\n   */\n  addPeople(): Relationship {\n    const id = this.generateId();\n    return this.addRelationship(Relationship.createPeople(id));\n  }\n\n  /**\n   * Generates the relationships XML file content\n   * @returns Complete XML string for .rels file\n   */\n  generateXml(): string {\n    const relationships = this.getAllRelationships();\n\n    let xml = '<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\\n';\n    xml += '<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\">\\n';\n\n    for (const rel of relationships) {\n      xml += rel.toXML() + '\\n';\n    }\n\n    xml += '</Relationships>';\n\n    return xml;\n  }\n\n  /**\n   * Creates a new relationship manager with common document relationships\n   * @returns RelationshipManager with styles, numbering, fontTable, settings, and theme relationships\n   */\n  static createForDocument(): RelationshipManager {\n    const manager = new RelationshipManager();\n    manager.addStyles();\n    manager.addNumbering();\n    manager.addFontTable();\n    manager.addSettings();\n    manager.addWebSettings();\n    manager.addTheme();\n    return manager;\n  }\n\n  /**\n   * Creates an empty relationship manager\n   * @returns Empty RelationshipManager\n   */\n  static create(): RelationshipManager {\n    return new RelationshipManager();\n  }\n\n  /**\n   * Parses relationships from XML string and creates a populated manager\n   * @param xml The relationships XML content (.rels file)\n   * @returns RelationshipManager with parsed relationships\n   */\n  static fromXml(xml: string): RelationshipManager {\n    const manager = new RelationshipManager();\n\n    // Prevent ReDoS: validate input size (typical .rels files are < 10KB)\n    if (xml.length > 100000) {\n      throw new Error(\n        'Relationships XML file too large (>100KB). Possible malicious input or corrupted file.'\n      );\n    }\n\n    // Use XMLParser to extract all Relationship elements\n    const relationshipElements = XMLParser.extractElements(xml, 'Relationship');\n\n    // Prevent infinite loops: check relationship count\n    if (relationshipElements.length > 1000) {\n      throw new Error('Too many relationships in XML file (>1000). Possible malicious input.');\n    }\n\n    // Process each relationship element\n    for (const relationshipElement of relationshipElements) {\n      // Extract attributes using XMLParser\n      const id = XMLParser.extractAttribute(relationshipElement, 'Id');\n      const type = XMLParser.extractAttribute(relationshipElement, 'Type');\n      const target = XMLParser.extractAttribute(relationshipElement, 'Target');\n      const targetMode = XMLParser.extractAttribute(relationshipElement, 'TargetMode');\n\n      // Only create relationship if all required attributes present\n      if (id && type && target) {\n        // Validate targetMode before type assertion\n        const validatedTargetMode =\n          targetMode === 'Internal' || targetMode === 'External' || targetMode === undefined\n            ? targetMode\n            : undefined;\n\n        // Create and add relationship\n        const relationship = Relationship.create({\n          id,\n          type,\n          target,\n          targetMode: validatedTargetMode || 'Internal',\n        });\n\n        manager.addRelationship(relationship);\n      }\n    }\n\n    return manager;\n  }\n}\n"]}

package/dist/elements/AlternateContent.js.map

@@ -1 +1 @@
-{"version":3,"file":"AlternateContent.js","sourceRoot":"","sources":["../../src/elements/AlternateContent.ts"],"names":[],"mappings":";;;AAWA,MAAa,gBAAgB;IACnB,MAAM,CAAS;IAEvB,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAKD,KAAK;QACH,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;SACN,CAAC;IAClB,CAAC;IAKD,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAKD,OAAO;QACL,OAAO,kBAAkB,CAAC;IAC5B,CAAC;CACF;AA9BD,4CA8BC","sourcesContent":["/**\r\n * AlternateContent - Represents mc:AlternateContent block element\r\n *\r\n * Per ECMA-376 Part 3 §11.4, mc:AlternateContent provides markup compatibility.\r\n * Word uses this for newer features (Word 2010+ shapes as Choice, VML as Fallback).\r\n *\r\n * Stored as raw XML for round-trip fidelity since the internal structure varies widely.\r\n */\r\n\r\nimport { XMLElement } from '../xml/XMLBuilder';\r\n\r\nexport class AlternateContent {\r\n  private rawXml: string;\r\n\r\n  constructor(rawXml: string) {\r\n    this.rawXml = rawXml;\r\n  }\r\n\r\n  /**\r\n   * Returns the raw XML for round-trip serialization\r\n   */\r\n  toXML(): XMLElement {\r\n    return {\r\n      name: '__rawXml',\r\n      rawXml: this.rawXml,\r\n    } as XMLElement;\r\n  }\r\n\r\n  /**\r\n   * Gets the raw XML string\r\n   */\r\n  getRawXml(): string {\r\n    return this.rawXml;\r\n  }\r\n\r\n  /**\r\n   * Returns the element type identifier\r\n   */\r\n  getType(): string {\r\n    return 'alternateContent';\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AlternateContent.js","sourceRoot":"","sources":["../../src/elements/AlternateContent.ts"],"names":[],"mappings":";;;AAWA,MAAa,gBAAgB;IACnB,MAAM,CAAS;IAEvB,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAKD,KAAK;QACH,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;SACN,CAAC;IAClB,CAAC;IAKD,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAKD,OAAO;QACL,OAAO,kBAAkB,CAAC;IAC5B,CAAC;CACF;AA9BD,4CA8BC","sourcesContent":["/**\n * AlternateContent - Represents mc:AlternateContent block element\n *\n * Per ECMA-376 Part 3 §11.4, mc:AlternateContent provides markup compatibility.\n * Word uses this for newer features (Word 2010+ shapes as Choice, VML as Fallback).\n *\n * Stored as raw XML for round-trip fidelity since the internal structure varies widely.\n */\n\nimport { XMLElement } from '../xml/XMLBuilder';\n\nexport class AlternateContent {\n  private rawXml: string;\n\n  constructor(rawXml: string) {\n    this.rawXml = rawXml;\n  }\n\n  /**\n   * Returns the raw XML for round-trip serialization\n   */\n  toXML(): XMLElement {\n    return {\n      name: '__rawXml',\n      rawXml: this.rawXml,\n    } as XMLElement;\n  }\n\n  /**\n   * Gets the raw XML string\n   */\n  getRawXml(): string {\n    return this.rawXml;\n  }\n\n  /**\n   * Returns the element type identifier\n   */\n  getType(): string {\n    return 'alternateContent';\n  }\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"Bookmark.d.ts","sourceRoot":"","sources":["../../src/elements/Bookmark.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAK/C,MAAM,WAAW,kBAAkB;IAEjC,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,IAAI,EAAE,MAAM,CAAC;IAEb,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAKD,qBAAa,QAAQ;IACnB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,IAAI,CAAS;gBAMT,UAAU,EAAE,kBAAkB;IAgB1C,OAAO,CAAC,aAAa;IAyBrB,KAAK,IAAI,MAAM;IAQf,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOvB,OAAO,IAAI,MAAM;IAejB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IA4B3B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS9B,UAAU,IAAI,UAAU;IAexB,QAAQ,IAAI,UAAU;IActB,KAAK,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC;IASjC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAUrC,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ;IAetD,MAAM,CAAC,UAAU,CAAC,MAAM,SAAa,GAAG,QAAQ;CAMjD"}
+{"version":3,"file":"Bookmark.d.ts","sourceRoot":"","sources":["../../src/elements/Bookmark.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAK/C,MAAM,WAAW,kBAAkB;IAEjC,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,IAAI,EAAE,MAAM,CAAC;IAEb,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAKD,qBAAa,QAAQ;IACnB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,IAAI,CAAS;gBAMT,UAAU,EAAE,kBAAkB;IAkB1C,OAAO,CAAC,aAAa;IAyBrB,KAAK,IAAI,MAAM;IAQf,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOvB,OAAO,IAAI,MAAM;IAejB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IA4B3B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS9B,UAAU,IAAI,UAAU;IAexB,QAAQ,IAAI,UAAU;IActB,KAAK,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC;IASjC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAUrC,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ;IAetD,MAAM,CAAC,UAAU,CAAC,MAAM,SAAa,GAAG,QAAQ;CAMjD"}

package/dist/elements/Bookmark.js

@@ -6,7 +6,9 @@ class Bookmark {
     name;
     constructor(properties) {
         this.id = properties.id ?? 0;
-        this.name = properties.skipNormalization ? properties.name : this.normalizeName(properties.name);
+        this.name = properties.skipNormalization
+            ? properties.name
+            : this.normalizeName(properties.name);
     }
     normalizeName(name) {
         let normalized = name.replace(/[^a-zA-Z0-9_]/g, '_');

package/dist/elements/Bookmark.js.map

@@ -1 +1 @@
-{"version":3,"file":"Bookmark.js","sourceRoot":"","sources":["../../src/elements/Bookmark.ts"],"names":[],"mappings":";;;AAwBA,MAAa,QAAQ;IACX,EAAE,CAAS;IACX,IAAI,CAAS;IAMrB,YAAY,UAA8B;QACxC,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;QAG7B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACnG,CAAC;IAWO,aAAa,CAAC,IAAY;QAEhC,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QAGrD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACpD,UAAU,GAAG,GAAG,GAAG,UAAU,CAAC;QAChC,CAAC;QAGD,IAAI,UAAU,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC3B,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3C,CAAC;QAGD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,UAAU,GAAG,WAAW,CAAC;QAC3B,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAKD,KAAK;QACH,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAMD,KAAK,CAAC,EAAU;QACd,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAKD,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAaD,OAAO,CAAC,IAAY;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAyBD,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAMD,UAAU;QACR,OAAO;YACL,IAAI,EAAE,iBAAiB;YACvB,UAAU,EAAE;gBACV,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE;gBAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI;aACpB;YACD,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAMD,QAAQ;QACN,OAAO;YACL,IAAI,EAAE,eAAe;YACrB,UAAU,EAAE;gBACV,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE;aAC3B;YACD,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAMD,KAAK;QACH,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9C,CAAC;IAOD,MAAM,CAAC,MAAM,CAAC,IAAY;QACxB,OAAO,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAQD,MAAM,CAAC,gBAAgB,CAAC,WAAmB;QAGzC,MAAM,IAAI,GAAG,WAAW;aACrB,IAAI,EAAE;aACN,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;aAC9B,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpB,OAAO,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,UAAU,EAAE,CAAC,CAAC;IACpD,CAAC;IAOD,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,UAAU;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QAChD,OAAO,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;CACF;AAzLD,4BAyLC","sourcesContent":["/**\r\n * Bookmark - Represents a bookmark in a Word document\r\n *\r\n * Bookmarks mark specific locations in a document for internal navigation.\r\n * They consist of a start marker and an end marker with matching IDs.\r\n */\r\n\r\nimport { XMLElement } from '../xml/XMLBuilder';\r\n\r\n/**\r\n * Bookmark properties\r\n */\r\nexport interface BookmarkProperties {\r\n  /** Unique bookmark ID (generated automatically if not provided) */\r\n  id?: number;\r\n  /** Bookmark name (must be unique within document) */\r\n  name: string;\r\n  /** Skip name normalization (used when loading from existing documents) */\r\n  skipNormalization?: boolean;\r\n}\r\n\r\n/**\r\n * Represents a bookmark location in a document\r\n */\r\nexport class Bookmark {\r\n  private id: number;\r\n  private name: string;\r\n\r\n  /**\r\n   * Creates a new Bookmark\r\n   * @param properties - Bookmark properties\r\n   */\r\n  constructor(properties: BookmarkProperties) {\r\n    this.id = properties.id ?? 0; // ID will be assigned by BookmarkManager\r\n    // Preserve exact bookmark names when loading from documents (Word allows =, ., etc.)\r\n    // Only normalize when creating new bookmarks programmatically\r\n    this.name = properties.skipNormalization ? properties.name : this.normalizeName(properties.name);\r\n  }\r\n\r\n  /**\r\n   * Normalizes a bookmark name to be valid\r\n   * - Must start with a letter or underscore\r\n   * - Can only contain letters, numbers, and underscores\r\n   * - Maximum 40 characters\r\n   * - Case-insensitive (Word converts to lowercase)\r\n   * @param name - Raw bookmark name\r\n   * @returns Normalized bookmark name\r\n   */\r\n  private normalizeName(name: string): string {\r\n    // Remove invalid characters\r\n    let normalized = name.replace(/[^a-zA-Z0-9_]/g, '_');\r\n\r\n    // Ensure it starts with a letter or underscore\r\n    if (normalized.length > 0 && /^\\d/.test(normalized)) {\r\n      normalized = '_' + normalized;\r\n    }\r\n\r\n    // Limit to 40 characters\r\n    if (normalized.length > 40) {\r\n      normalized = normalized.substring(0, 40);\r\n    }\r\n\r\n    // Default if empty\r\n    if (normalized.length === 0) {\r\n      normalized = '_bookmark';\r\n    }\r\n\r\n    return normalized;\r\n  }\r\n\r\n  /**\r\n   * Gets the bookmark ID\r\n   */\r\n  getId(): number {\r\n    return this.id;\r\n  }\r\n\r\n  /**\r\n   * Sets the bookmark ID (used by BookmarkManager)\r\n   * @internal\r\n   */\r\n  setId(id: number): void {\r\n    this.id = id;\r\n  }\r\n\r\n  /**\r\n   * Gets the bookmark name\r\n   */\r\n  getName(): string {\r\n    return this.name;\r\n  }\r\n\r\n  /**\r\n   * Sets the bookmark name (normalizes the name)\r\n   *\r\n   * The name will be normalized:\r\n   * - Invalid characters replaced with underscores\r\n   * - Leading digits prefixed with underscore\r\n   * - Limited to 40 characters\r\n   *\r\n   * @param name - New bookmark name\r\n   * @returns This bookmark for chaining\r\n   */\r\n  setName(name: string): this {\r\n    this.name = this.normalizeName(name);\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Sets the bookmark name without normalization\r\n   *\r\n   * Use this method when:\r\n   * - Preserving exact names from imported documents\r\n   * - Setting names with special characters that Word allows (=, ., etc.)\r\n   * - Round-trip fidelity is required\r\n   *\r\n   * **Warning:** Setting invalid bookmark names may cause issues in Word.\r\n   * Only use this if you know the name is valid or needs to match an existing document.\r\n   *\r\n   * @param name - Raw bookmark name (not normalized)\r\n   * @returns This bookmark for chaining\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * // Preserve exact name from Word document\r\n   * bookmark.setRawName('SECTION=II.MNKE7E8NA385_');\r\n   *\r\n   * // For new bookmarks, prefer setName() which normalizes\r\n   * bookmark.setName('My Heading'); // Becomes 'My_Heading'\r\n   * ```\r\n   */\r\n  setRawName(name: string): this {\r\n    this.name = name;\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Generates XML for the bookmark start marker\r\n   * @returns XMLElement for bookmarkStart\r\n   */\r\n  toStartXML(): XMLElement {\r\n    return {\r\n      name: 'w:bookmarkStart',\r\n      attributes: {\r\n        'w:id': this.id.toString(),\r\n        'w:name': this.name,\r\n      },\r\n      selfClosing: true,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Generates XML for the bookmark end marker\r\n   * @returns XMLElement for bookmarkEnd\r\n   */\r\n  toEndXML(): XMLElement {\r\n    return {\r\n      name: 'w:bookmarkEnd',\r\n      attributes: {\r\n        'w:id': this.id.toString(),\r\n      },\r\n      selfClosing: true,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Generates both start and end XML elements as an array\r\n   * @returns Array of XMLElements [start, end]\r\n   */\r\n  toXML(): [XMLElement, XMLElement] {\r\n    return [this.toStartXML(), this.toEndXML()];\r\n  }\r\n\r\n  /**\r\n   * Creates a new Bookmark\r\n   * @param name - Bookmark name\r\n   * @returns New Bookmark instance\r\n   */\r\n  static create(name: string): Bookmark {\r\n    return new Bookmark({ name });\r\n  }\r\n\r\n  /**\r\n   * Creates a bookmark for a heading\r\n   * Useful for table of contents internal links\r\n   * @param headingText - The text of the heading\r\n   * @returns New Bookmark instance with normalized name\r\n   */\r\n  static createForHeading(headingText: string): Bookmark {\r\n    // Create a bookmark name from heading text\r\n    // Example: \"Chapter 1: Introduction\" -> \"_Chapter_1_Introduction\"\r\n    const name = headingText\r\n      .trim()\r\n      .replace(/[^a-zA-Z0-9]+/g, '_')\r\n      .substring(0, 40);\r\n    return new Bookmark({ name: name || '_heading' });\r\n  }\r\n\r\n  /**\r\n   * Creates a bookmark with an auto-generated unique name\r\n   * @param prefix - Optional prefix for the name (default: 'bookmark')\r\n   * @returns New Bookmark instance\r\n   */\r\n  static createAuto(prefix = 'bookmark'): Bookmark {\r\n    const timestamp = Date.now().toString(36);\r\n    const random = Math.random().toString(36).substring(2, 7);\r\n    const name = `${prefix}_${timestamp}_${random}`;\r\n    return new Bookmark({ name });\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Bookmark.js","sourceRoot":"","sources":["../../src/elements/Bookmark.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Bookmark - Represents a bookmark in a Word document\n *\n * Bookmarks mark specific locations in a document for internal navigation.\n * They consist of a start marker and an end marker with matching IDs.\n */\n\nimport { XMLElement } from '../xml/XMLBuilder';\n\n/**\n * Bookmark properties\n */\nexport interface BookmarkProperties {\n  /** Unique bookmark ID (generated automatically if not provided) */\n  id?: number;\n  /** Bookmark name (must be unique within document) */\n  name: string;\n  /** Skip name normalization (used when loading from existing documents) */\n  skipNormalization?: boolean;\n}\n\n/**\n * Represents a bookmark location in a document\n */\nexport class Bookmark {\n  private id: number;\n  private name: string;\n\n  /**\n   * Creates a new Bookmark\n   * @param properties - Bookmark properties\n   */\n  constructor(properties: BookmarkProperties) {\n    this.id = properties.id ?? 0; // ID will be assigned by BookmarkManager\n    // Preserve exact bookmark names when loading from documents (Word allows =, ., etc.)\n    // Only normalize when creating new bookmarks programmatically\n    this.name = properties.skipNormalization\n      ? properties.name\n      : this.normalizeName(properties.name);\n  }\n\n  /**\n   * Normalizes a bookmark name to be valid\n   * - Must start with a letter or underscore\n   * - Can only contain letters, numbers, and underscores\n   * - Maximum 40 characters\n   * - Case-insensitive (Word converts to lowercase)\n   * @param name - Raw bookmark name\n   * @returns Normalized bookmark name\n   */\n  private normalizeName(name: string): string {\n    // Remove invalid characters\n    let normalized = name.replace(/[^a-zA-Z0-9_]/g, '_');\n\n    // Ensure it starts with a letter or underscore\n    if (normalized.length > 0 && /^\\d/.test(normalized)) {\n      normalized = '_' + normalized;\n    }\n\n    // Limit to 40 characters\n    if (normalized.length > 40) {\n      normalized = normalized.substring(0, 40);\n    }\n\n    // Default if empty\n    if (normalized.length === 0) {\n      normalized = '_bookmark';\n    }\n\n    return normalized;\n  }\n\n  /**\n   * Gets the bookmark ID\n   */\n  getId(): number {\n    return this.id;\n  }\n\n  /**\n   * Sets the bookmark ID (used by BookmarkManager)\n   * @internal\n   */\n  setId(id: number): void {\n    this.id = id;\n  }\n\n  /**\n   * Gets the bookmark name\n   */\n  getName(): string {\n    return this.name;\n  }\n\n  /**\n   * Sets the bookmark name (normalizes the name)\n   *\n   * The name will be normalized:\n   * - Invalid characters replaced with underscores\n   * - Leading digits prefixed with underscore\n   * - Limited to 40 characters\n   *\n   * @param name - New bookmark name\n   * @returns This bookmark for chaining\n   */\n  setName(name: string): this {\n    this.name = this.normalizeName(name);\n    return this;\n  }\n\n  /**\n   * Sets the bookmark name without normalization\n   *\n   * Use this method when:\n   * - Preserving exact names from imported documents\n   * - Setting names with special characters that Word allows (=, ., etc.)\n   * - Round-trip fidelity is required\n   *\n   * **Warning:** Setting invalid bookmark names may cause issues in Word.\n   * Only use this if you know the name is valid or needs to match an existing document.\n   *\n   * @param name - Raw bookmark name (not normalized)\n   * @returns This bookmark for chaining\n   *\n   * @example\n   * ```typescript\n   * // Preserve exact name from Word document\n   * bookmark.setRawName('SECTION=II.MNKE7E8NA385_');\n   *\n   * // For new bookmarks, prefer setName() which normalizes\n   * bookmark.setName('My Heading'); // Becomes 'My_Heading'\n   * ```\n   */\n  setRawName(name: string): this {\n    this.name = name;\n    return this;\n  }\n\n  /**\n   * Generates XML for the bookmark start marker\n   * @returns XMLElement for bookmarkStart\n   */\n  toStartXML(): XMLElement {\n    return {\n      name: 'w:bookmarkStart',\n      attributes: {\n        'w:id': this.id.toString(),\n        'w:name': this.name,\n      },\n      selfClosing: true,\n    };\n  }\n\n  /**\n   * Generates XML for the bookmark end marker\n   * @returns XMLElement for bookmarkEnd\n   */\n  toEndXML(): XMLElement {\n    return {\n      name: 'w:bookmarkEnd',\n      attributes: {\n        'w:id': this.id.toString(),\n      },\n      selfClosing: true,\n    };\n  }\n\n  /**\n   * Generates both start and end XML elements as an array\n   * @returns Array of XMLElements [start, end]\n   */\n  toXML(): [XMLElement, XMLElement] {\n    return [this.toStartXML(), this.toEndXML()];\n  }\n\n  /**\n   * Creates a new Bookmark\n   * @param name - Bookmark name\n   * @returns New Bookmark instance\n   */\n  static create(name: string): Bookmark {\n    return new Bookmark({ name });\n  }\n\n  /**\n   * Creates a bookmark for a heading\n   * Useful for table of contents internal links\n   * @param headingText - The text of the heading\n   * @returns New Bookmark instance with normalized name\n   */\n  static createForHeading(headingText: string): Bookmark {\n    // Create a bookmark name from heading text\n    // Example: \"Chapter 1: Introduction\" -> \"_Chapter_1_Introduction\"\n    const name = headingText\n      .trim()\n      .replace(/[^a-zA-Z0-9]+/g, '_')\n      .substring(0, 40);\n    return new Bookmark({ name: name || '_heading' });\n  }\n\n  /**\n   * Creates a bookmark with an auto-generated unique name\n   * @param prefix - Optional prefix for the name (default: 'bookmark')\n   * @returns New Bookmark instance\n   */\n  static createAuto(prefix = 'bookmark'): Bookmark {\n    const timestamp = Date.now().toString(36);\n    const random = Math.random().toString(36).substring(2, 7);\n    const name = `${prefix}_${timestamp}_${random}`;\n    return new Bookmark({ name });\n  }\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"BookmarkManager.d.ts","sourceRoot":"","sources":["../../src/elements/BookmarkManager.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAMtC,MAAM,MAAM,kBAAkB,GAAG,MAAM,MAAM,CAAC;AAM9C,MAAM,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;AAK5D,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,gBAAgB,CAAiC;IAUzD,aAAa,CAAC,QAAQ,EAAE,kBAAkB,EAAE,cAAc,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAYpF,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IA2BtC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAgC9C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAS/C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQlC,eAAe,IAAI,QAAQ,EAAE;IAQ7B,QAAQ,IAAI,MAAM;IASlB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOrC,KAAK,IAAI,IAAI;IAUb,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAU3B,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAmCvC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAYtC,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ;IAWpD,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB;IAYD,MAAM,CAAC,MAAM,IAAI,eAAe;CAGjC"}
+{"version":3,"file":"BookmarkManager.d.ts","sourceRoot":"","sources":["../../src/elements/BookmarkManager.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAMtC,MAAM,MAAM,kBAAkB,GAAG,MAAM,MAAM,CAAC;AAM9C,MAAM,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;AAK5D,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,gBAAgB,CAAiC;IAUzD,aAAa,CAAC,QAAQ,EAAE,kBAAkB,EAAE,cAAc,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAYpF,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IA2BtC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAgC9C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAS/C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQlC,eAAe,IAAI,QAAQ,EAAE;IAQ7B,QAAQ,IAAI,MAAM;IASlB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOrC,KAAK,IAAI,IAAI;IAUb,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAU3B,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAgCvC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAYtC,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ;IAWpD,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB;IAYD,MAAM,CAAC,MAAM,IAAI,eAAe;CAGjC"}

package/dist/elements/BookmarkManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"BookmarkManager.js","sourceRoot":"","sources":["../../src/elements/BookmarkManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * BookmarkManager - Manages bookmarks in a document\r\n *\r\n * Tracks all bookmarks, assigns unique IDs, and ensures name uniqueness.\r\n *\r\n * Per ECMA-376, bookmark IDs must be unique across ALL annotation types\r\n * in a document. Use setIdProvider() to connect to a centralized ID allocator.\r\n */\r\n\r\nimport { Bookmark } from './Bookmark';\r\n\r\n/**\r\n * Type for the centralized ID provider callback.\r\n * Returns the next available annotation ID from a shared counter.\r\n */\r\nexport type IdProviderCallback = () => number;\r\n\r\n/**\r\n * Type for callback to notify of existing IDs (for synchronization).\r\n * Called when registering an existing bookmark to keep the central counter in sync.\r\n */\r\nexport type IdExistsCallback = (existingId: number) => void;\r\n\r\n/**\r\n * Manages document bookmarks\r\n */\r\nexport class BookmarkManager {\r\n  private bookmarks = new Map<string, Bookmark>();\r\n  private nextId = 0;\r\n  private idProvider: IdProviderCallback | null = null;\r\n  private idExistsNotifier: IdExistsCallback | null = null;\r\n\r\n  /**\r\n   * Sets the centralized ID provider callback.\r\n   * When set, IDs will be allocated from the centralized DocumentIdManager\r\n   * instead of the local nextId counter.\r\n   *\r\n   * @param provider - Callback that returns the next available ID\r\n   * @param existsNotifier - Optional callback to notify when existing IDs are found\r\n   */\r\n  setIdProvider(provider: IdProviderCallback, existsNotifier?: IdExistsCallback): void {\r\n    this.idProvider = provider;\r\n    this.idExistsNotifier = existsNotifier || null;\r\n  }\r\n\r\n  /**\r\n   * Registers a bookmark with the manager\r\n   * Assigns a unique ID and ensures name uniqueness\r\n   * @param bookmark - Bookmark to register\r\n   * @returns The registered bookmark (same instance)\r\n   * @throws Error if a bookmark with the same name already exists\r\n   */\r\n  register(bookmark: Bookmark): Bookmark {\r\n    const name = bookmark.getName();\r\n\r\n    // Check for duplicate names\r\n    if (this.bookmarks.has(name)) {\r\n      throw new Error(\r\n        `Bookmark with name \"${name}\" already exists. Bookmark names must be unique within a document.`\r\n      );\r\n    }\r\n\r\n    // Assign unique ID - use centralized provider if available\r\n    const id = this.idProvider ? this.idProvider() : this.nextId++;\r\n    bookmark.setId(id);\r\n\r\n    // Store bookmark\r\n    this.bookmarks.set(name, bookmark);\r\n\r\n    return bookmark;\r\n  }\r\n\r\n  /**\r\n   * Registers an existing bookmark, preserving its ID\r\n   * Used when loading documents to preserve original bookmark IDs and avoid collisions\r\n   * @param bookmark - Bookmark with existing ID to register\r\n   * @returns The registered bookmark (same instance)\r\n   * @throws Error if a bookmark with the same name already exists\r\n   */\r\n  registerExisting(bookmark: Bookmark): Bookmark {\r\n    const name = bookmark.getName();\r\n    const existingId = bookmark.getId();\r\n\r\n    // Check for duplicate names\r\n    if (this.bookmarks.has(name)) {\r\n      throw new Error(\r\n        `Bookmark with name \"${name}\" already exists. Bookmark names must be unique within a document.`\r\n      );\r\n    }\r\n\r\n    // Notify centralized ID manager about this existing ID\r\n    if (this.idExistsNotifier) {\r\n      this.idExistsNotifier(existingId);\r\n    }\r\n\r\n    // Also update local nextId to avoid collisions (for fallback)\r\n    if (existingId >= this.nextId) {\r\n      this.nextId = existingId + 1;\r\n    }\r\n\r\n    // Store bookmark (keep its existing ID)\r\n    this.bookmarks.set(name, bookmark);\r\n\r\n    return bookmark;\r\n  }\r\n\r\n  /**\r\n   * Gets a bookmark by name\r\n   * @param name - Bookmark name\r\n   * @returns The bookmark, or undefined if not found\r\n   */\r\n  getBookmark(name: string): Bookmark | undefined {\r\n    return this.bookmarks.get(name);\r\n  }\r\n\r\n  /**\r\n   * Checks if a bookmark exists\r\n   * @param name - Bookmark name\r\n   * @returns True if the bookmark exists\r\n   */\r\n  hasBookmark(name: string): boolean {\r\n    return this.bookmarks.has(name);\r\n  }\r\n\r\n  /**\r\n   * Gets all bookmarks\r\n   * @returns Array of all bookmarks\r\n   */\r\n  getAllBookmarks(): Bookmark[] {\r\n    return Array.from(this.bookmarks.values());\r\n  }\r\n\r\n  /**\r\n   * Gets the number of bookmarks\r\n   * @returns Number of bookmarks\r\n   */\r\n  getCount(): number {\r\n    return this.bookmarks.size;\r\n  }\r\n\r\n  /**\r\n   * Removes a bookmark\r\n   * @param name - Bookmark name\r\n   * @returns True if the bookmark was removed\r\n   */\r\n  removeBookmark(name: string): boolean {\r\n    return this.bookmarks.delete(name);\r\n  }\r\n\r\n  /**\r\n   * Clears all bookmarks\r\n   */\r\n  clear(): void {\r\n    this.bookmarks.clear();\r\n    this.nextId = 0;\r\n  }\r\n\r\n  /**\r\n   * Sets the next ID to be assigned\r\n   * Used when loading documents to avoid ID collisions with existing bookmarks\r\n   * @param id - The next ID value to use\r\n   */\r\n  setNextId(id: number): void {\r\n    this.nextId = id;\r\n  }\r\n\r\n  /**\r\n   * Gets a unique bookmark name by adding a suffix if needed\r\n   * Ensures the returned name is always within the 40-character limit\r\n   * @param baseName - Base name for the bookmark\r\n   * @returns A unique bookmark name (max 40 characters)\r\n   */\r\n  getUniqueName(baseName: string): string {\r\n    const maxLength = 40;\r\n\r\n    if (!this.hasBookmark(baseName)) {\r\n      return baseName;\r\n    }\r\n\r\n    // Try adding numbers until we find a unique name\r\n    let counter = 1;\r\n    while (counter <= 1000) {\r\n      const suffix = `_${counter}`;\r\n\r\n      // Truncate base name to leave room for suffix within 40-char limit\r\n      const maxBase = maxLength - suffix.length;\r\n      const truncatedBase =\r\n        baseName.length > maxBase ? baseName.substring(0, maxBase) : baseName;\r\n\r\n      const uniqueName = `${truncatedBase}${suffix}`;\r\n\r\n      if (!this.hasBookmark(uniqueName)) {\r\n        return uniqueName;\r\n      }\r\n      counter++;\r\n    }\r\n\r\n    throw new Error(\r\n      `Could not generate unique bookmark name from base \"${baseName}\"`\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Creates and registers a new bookmark with a unique name\r\n   * @param name - Desired bookmark name\r\n   * @returns The created and registered bookmark\r\n   */\r\n  createBookmark(name: string): Bookmark {\r\n    const uniqueName = this.getUniqueName(name);\r\n    const bookmark = Bookmark.create(uniqueName);\r\n    return this.register(bookmark);\r\n  }\r\n\r\n  /**\r\n   * Creates and registers a bookmark for a heading\r\n   * Automatically generates a unique name from the heading text\r\n   * @param headingText - The text of the heading\r\n   * @returns The created and registered bookmark\r\n   */\r\n  createHeadingBookmark(headingText: string): Bookmark {\r\n    const bookmark = Bookmark.createForHeading(headingText);\r\n    const uniqueName = this.getUniqueName(bookmark.getName());\r\n    bookmark.setName(uniqueName);\r\n    return this.register(bookmark);\r\n  }\r\n\r\n  /**\r\n   * Gets statistics about bookmarks\r\n   * @returns Object with bookmark statistics\r\n   */\r\n  getStats(): {\r\n    total: number;\r\n    nextId: number;\r\n    names: string[];\r\n  } {\r\n    return {\r\n      total: this.bookmarks.size,\r\n      nextId: this.nextId,\r\n      names: Array.from(this.bookmarks.keys()),\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Creates a new BookmarkManager\r\n   * @returns New BookmarkManager instance\r\n   */\r\n  static create(): BookmarkManager {\r\n    return new BookmarkManager();\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"BookmarkManager.js","sourceRoot":"","sources":["../../src/elements/BookmarkManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * BookmarkManager - Manages bookmarks in a document\n *\n * Tracks all bookmarks, assigns unique IDs, and ensures name uniqueness.\n *\n * Per ECMA-376, bookmark IDs must be unique across ALL annotation types\n * in a document. Use setIdProvider() to connect to a centralized ID allocator.\n */\n\nimport { Bookmark } from './Bookmark';\n\n/**\n * Type for the centralized ID provider callback.\n * Returns the next available annotation ID from a shared counter.\n */\nexport type IdProviderCallback = () => number;\n\n/**\n * Type for callback to notify of existing IDs (for synchronization).\n * Called when registering an existing bookmark to keep the central counter in sync.\n */\nexport type IdExistsCallback = (existingId: number) => void;\n\n/**\n * Manages document bookmarks\n */\nexport class BookmarkManager {\n  private bookmarks = new Map<string, Bookmark>();\n  private nextId = 0;\n  private idProvider: IdProviderCallback | null = null;\n  private idExistsNotifier: IdExistsCallback | null = null;\n\n  /**\n   * Sets the centralized ID provider callback.\n   * When set, IDs will be allocated from the centralized DocumentIdManager\n   * instead of the local nextId counter.\n   *\n   * @param provider - Callback that returns the next available ID\n   * @param existsNotifier - Optional callback to notify when existing IDs are found\n   */\n  setIdProvider(provider: IdProviderCallback, existsNotifier?: IdExistsCallback): void {\n    this.idProvider = provider;\n    this.idExistsNotifier = existsNotifier || null;\n  }\n\n  /**\n   * Registers a bookmark with the manager\n   * Assigns a unique ID and ensures name uniqueness\n   * @param bookmark - Bookmark to register\n   * @returns The registered bookmark (same instance)\n   * @throws Error if a bookmark with the same name already exists\n   */\n  register(bookmark: Bookmark): Bookmark {\n    const name = bookmark.getName();\n\n    // Check for duplicate names\n    if (this.bookmarks.has(name)) {\n      throw new Error(\n        `Bookmark with name \"${name}\" already exists. Bookmark names must be unique within a document.`\n      );\n    }\n\n    // Assign unique ID - use centralized provider if available\n    const id = this.idProvider ? this.idProvider() : this.nextId++;\n    bookmark.setId(id);\n\n    // Store bookmark\n    this.bookmarks.set(name, bookmark);\n\n    return bookmark;\n  }\n\n  /**\n   * Registers an existing bookmark, preserving its ID\n   * Used when loading documents to preserve original bookmark IDs and avoid collisions\n   * @param bookmark - Bookmark with existing ID to register\n   * @returns The registered bookmark (same instance)\n   * @throws Error if a bookmark with the same name already exists\n   */\n  registerExisting(bookmark: Bookmark): Bookmark {\n    const name = bookmark.getName();\n    const existingId = bookmark.getId();\n\n    // Check for duplicate names\n    if (this.bookmarks.has(name)) {\n      throw new Error(\n        `Bookmark with name \"${name}\" already exists. Bookmark names must be unique within a document.`\n      );\n    }\n\n    // Notify centralized ID manager about this existing ID\n    if (this.idExistsNotifier) {\n      this.idExistsNotifier(existingId);\n    }\n\n    // Also update local nextId to avoid collisions (for fallback)\n    if (existingId >= this.nextId) {\n      this.nextId = existingId + 1;\n    }\n\n    // Store bookmark (keep its existing ID)\n    this.bookmarks.set(name, bookmark);\n\n    return bookmark;\n  }\n\n  /**\n   * Gets a bookmark by name\n   * @param name - Bookmark name\n   * @returns The bookmark, or undefined if not found\n   */\n  getBookmark(name: string): Bookmark | undefined {\n    return this.bookmarks.get(name);\n  }\n\n  /**\n   * Checks if a bookmark exists\n   * @param name - Bookmark name\n   * @returns True if the bookmark exists\n   */\n  hasBookmark(name: string): boolean {\n    return this.bookmarks.has(name);\n  }\n\n  /**\n   * Gets all bookmarks\n   * @returns Array of all bookmarks\n   */\n  getAllBookmarks(): Bookmark[] {\n    return Array.from(this.bookmarks.values());\n  }\n\n  /**\n   * Gets the number of bookmarks\n   * @returns Number of bookmarks\n   */\n  getCount(): number {\n    return this.bookmarks.size;\n  }\n\n  /**\n   * Removes a bookmark\n   * @param name - Bookmark name\n   * @returns True if the bookmark was removed\n   */\n  removeBookmark(name: string): boolean {\n    return this.bookmarks.delete(name);\n  }\n\n  /**\n   * Clears all bookmarks\n   */\n  clear(): void {\n    this.bookmarks.clear();\n    this.nextId = 0;\n  }\n\n  /**\n   * Sets the next ID to be assigned\n   * Used when loading documents to avoid ID collisions with existing bookmarks\n   * @param id - The next ID value to use\n   */\n  setNextId(id: number): void {\n    this.nextId = id;\n  }\n\n  /**\n   * Gets a unique bookmark name by adding a suffix if needed\n   * Ensures the returned name is always within the 40-character limit\n   * @param baseName - Base name for the bookmark\n   * @returns A unique bookmark name (max 40 characters)\n   */\n  getUniqueName(baseName: string): string {\n    const maxLength = 40;\n\n    if (!this.hasBookmark(baseName)) {\n      return baseName;\n    }\n\n    // Try adding numbers until we find a unique name\n    let counter = 1;\n    while (counter <= 1000) {\n      const suffix = `_${counter}`;\n\n      // Truncate base name to leave room for suffix within 40-char limit\n      const maxBase = maxLength - suffix.length;\n      const truncatedBase = baseName.length > maxBase ? baseName.substring(0, maxBase) : baseName;\n\n      const uniqueName = `${truncatedBase}${suffix}`;\n\n      if (!this.hasBookmark(uniqueName)) {\n        return uniqueName;\n      }\n      counter++;\n    }\n\n    throw new Error(`Could not generate unique bookmark name from base \"${baseName}\"`);\n  }\n\n  /**\n   * Creates and registers a new bookmark with a unique name\n   * @param name - Desired bookmark name\n   * @returns The created and registered bookmark\n   */\n  createBookmark(name: string): Bookmark {\n    const uniqueName = this.getUniqueName(name);\n    const bookmark = Bookmark.create(uniqueName);\n    return this.register(bookmark);\n  }\n\n  /**\n   * Creates and registers a bookmark for a heading\n   * Automatically generates a unique name from the heading text\n   * @param headingText - The text of the heading\n   * @returns The created and registered bookmark\n   */\n  createHeadingBookmark(headingText: string): Bookmark {\n    const bookmark = Bookmark.createForHeading(headingText);\n    const uniqueName = this.getUniqueName(bookmark.getName());\n    bookmark.setName(uniqueName);\n    return this.register(bookmark);\n  }\n\n  /**\n   * Gets statistics about bookmarks\n   * @returns Object with bookmark statistics\n   */\n  getStats(): {\n    total: number;\n    nextId: number;\n    names: string[];\n  } {\n    return {\n      total: this.bookmarks.size,\n      nextId: this.nextId,\n      names: Array.from(this.bookmarks.keys()),\n    };\n  }\n\n  /**\n   * Creates a new BookmarkManager\n   * @returns New BookmarkManager instance\n   */\n  static create(): BookmarkManager {\n    return new BookmarkManager();\n  }\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"Comment.d.ts","sourceRoot":"","sources":["../../src/elements/Comment.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAM/C,MAAM,WAAW,iBAAiB;IAEhC,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,MAAM,EAAE,MAAM,CAAC;IAEf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;IAE9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAKD,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,IAAI,CAAU;gBAMV,UAAU,EAAE,iBAAiB;IAsBzC,OAAO,CAAC,gBAAgB;IAcxB,KAAK,IAAI,MAAM;IAQf,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOvB,SAAS,IAAI,MAAM;IAOnB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ/B,WAAW,IAAI,MAAM;IAOrB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQnC,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAQzB,WAAW,IAAI,MAAM,GAAG,SAAS;IAOjC,OAAO,IAAI,OAAO;IAQlB,UAAU,IAAI,OAAO;IAQrB,OAAO,IAAI,IAAI;IASf,SAAS,IAAI,IAAI;IAQjB,OAAO,IAAI,GAAG,EAAE;IAOhB,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAQtB,OAAO,IAAI,MAAM;IAOjB,UAAU,IAAI,MAAM;IAQpB,OAAO,CAAC,UAAU;IAQlB,eAAe,IAAI,UAAU;IAc7B,aAAa,IAAI,UAAU;IAc3B,cAAc,IAAI,UAAU;IAmB5B,KAAK,IAAI,UAAU;IAsCnB,MAAM,CAAC,MAAM,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO;IAgBV,MAAM,CAAC,WAAW,CAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO;IAgBV,MAAM,CAAC,eAAe,CACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,GAAG,EAAE,EACX,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO;CAOX"}
+{"version":3,"file":"Comment.d.ts","sourceRoot":"","sources":["../../src/elements/Comment.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAM/C,MAAM,WAAW,iBAAiB;IAEhC,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,MAAM,EAAE,MAAM,CAAC;IAEf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;IAE9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAKD,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,IAAI,CAAU;gBAMV,UAAU,EAAE,iBAAiB;IAsBzC,OAAO,CAAC,gBAAgB;IAmBxB,KAAK,IAAI,MAAM;IAQf,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOvB,SAAS,IAAI,MAAM;IAOnB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ/B,WAAW,IAAI,MAAM;IAOrB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQnC,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAQzB,WAAW,IAAI,MAAM,GAAG,SAAS;IAOjC,OAAO,IAAI,OAAO;IAQlB,UAAU,IAAI,OAAO;IAQrB,OAAO,IAAI,IAAI;IASf,SAAS,IAAI,IAAI;IAQjB,OAAO,IAAI,GAAG,EAAE;IAOhB,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAQtB,OAAO,IAAI,MAAM;IAOjB,UAAU,IAAI,MAAM;IAQpB,OAAO,CAAC,UAAU;IAQlB,eAAe,IAAI,UAAU;IAc7B,aAAa,IAAI,UAAU;IAc3B,cAAc,IAAI,UAAU;IAmB5B,KAAK,IAAI,UAAU;IAsCnB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAgBxF,MAAM,CAAC,WAAW,CAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO;IAgBV,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;CAOhF"}

package/dist/elements/Comment.js

@@ -29,16 +29,19 @@ class Comment {
         }
     }
     generateInitials(author) {
-        const words = author.trim().split(/\s+/).filter(w => w.length > 0);
+        const words = author
+            .trim()
+            .split(/\s+/)
+            .filter((w) => w.length > 0);
         if (words.length === 0)
             return 'U';
         if (words.length === 1)
             return (words[0] || 'U').substring(0, 2).toUpperCase();
-        return words
-            .map(word => word[0] || '')
+        return (words
+            .map((word) => word[0] || '')
             .join('')
             .toUpperCase()
-            .substring(0, 3) || 'U';
+            .substring(0, 3) || 'U');
     }
     getId() {
         return this.id;
@@ -92,7 +95,7 @@ class Comment {
         return this;
     }
     getText() {
-        return this.runs.map(run => run.getText()).join('');
+        return this.runs.map((run) => run.getText()).join('');
     }
     getContent() {
         return this.getText();
@@ -147,7 +150,7 @@ class Comment {
         }
         const commentParagraph = {
             name: 'w:p',
-            children: this.runs.map(run => run.toXML()),
+            children: this.runs.map((run) => run.toXML()),
         };
         return {
             name: 'w:comment',