docxmlater 11.0.10 → 12.1.0

package/dist/esm/core/RelationshipManager.js

@@ -168,8 +168,8 @@ export class RelationshipManager {
             throw new CorruptedArchiveError('Relationships XML file too large (>10MB). Possible malicious input or corrupted file.');
         }
         const relationshipElements = XMLParser.extractElements(xml, 'Relationship');
-        if (relationshipElements.length > 1000) {
-            throw new CorruptedArchiveError('Too many relationships in XML file (>1000). Possible malicious input.');
+        if (relationshipElements.length > 100000) {
+            throw new CorruptedArchiveError('Too many relationships in XML file (>100000). Possible malicious input or corrupted file.');
         }
         for (const relationshipElement of relationshipElements) {
             const id = XMLParser.extractAttribute(relationshipElement, 'Id');

package/dist/esm/core/RelationshipManager.js.map

@@ -1 +1 @@
-{"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.js';\nimport { XMLParser } from '../xml/XMLParser.js';\nimport { sanitizeHyperlinkUrl } from '../utils/validation.js';\nimport { InvalidDocxError, CorruptedArchiveError } from '../zip/errors.js';\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 InvalidDocxError(\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, max 10MB)\n    if (xml.length > 10000000) {\n      throw new CorruptedArchiveError(\n        'Relationships XML file too large (>10MB). 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 CorruptedArchiveError(\n        'Too many relationships in XML file (>1000). Possible malicious input.'\n      );\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        // Sanitize hyperlink URLs (strip browser extension prefixes)\n        let sanitizedTarget = target;\n        if (type.endsWith('/hyperlink')) {\n          const result = sanitizeHyperlinkUrl(target);\n          if (result) {\n            sanitizedTarget = result.url;\n          }\n        }\n\n        // Create and add relationship\n        const relationship = Relationship.create({\n          id,\n          type,\n          target: sanitizedTarget,\n          targetMode: validatedTargetMode || 'Internal',\n        });\n\n        manager.addRelationship(relationship);\n      }\n    }\n\n    return manager;\n  }\n}\n"]}
+{"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.js';\r\nimport { XMLParser } from '../xml/XMLParser.js';\r\nimport { sanitizeHyperlinkUrl } from '../utils/validation.js';\r\nimport { InvalidDocxError, CorruptedArchiveError } from '../zip/errors.js';\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 InvalidDocxError(\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, max 10MB)\r\n    if (xml.length > 10000000) {\r\n      throw new CorruptedArchiveError(\r\n        'Relationships XML file too large (>10MB). Possible malicious input or corrupted file.'\r\n      );\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    // The 10MB size cap above is the primary bound on the work performed here;\r\n    // this count check is a far-above-normal backstop. Link- and image-heavy\r\n    // documents (each unique hyperlink URL or image is one OPC relationship)\r\n    // legitimately exceed several thousand entries, so the limit must stay well\r\n    // clear of any realistic part.\r\n    if (relationshipElements.length > 100000) {\r\n      throw new CorruptedArchiveError(\r\n        'Too many relationships in XML file (>100000). Possible malicious input or corrupted file.'\r\n      );\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        // Sanitize hyperlink URLs (strip browser extension prefixes)\r\n        let sanitizedTarget = target;\r\n        if (type.endsWith('/hyperlink')) {\r\n          const result = sanitizeHyperlinkUrl(target);\r\n          if (result) {\r\n            sanitizedTarget = result.url;\r\n          }\r\n        }\r\n\r\n        // Create and add relationship\r\n        const relationship = Relationship.create({\r\n          id,\r\n          type,\r\n          target: sanitizedTarget,\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"]}

package/dist/esm/elements/Comment.js

@@ -5,9 +5,10 @@ export class Comment {
     author;
     initials;
     date;
-    runs;
+    paragraphs;
     parentId;
     done;
+    onModified = null;
     constructor(properties) {
         this.id = properties.id ?? 0;
         this.author = properties.author;
@@ -15,15 +16,17 @@ export class Comment {
         this.date = properties.date || new Date();
         this.parentId = properties.parentId;
         this.done = properties.done ?? false;
+        let runs;
         if (typeof properties.content === 'string') {
-            this.runs = [new Run(properties.content)];
+            runs = [new Run(properties.content)];
         }
         else if (Array.isArray(properties.content)) {
-            this.runs = properties.content;
+            runs = properties.content;
         }
         else {
-            this.runs = [properties.content];
+            runs = [properties.content];
         }
+        this.paragraphs = [{ content: runs }];
     }
     generateInitials(author) {
         const words = author
@@ -46,11 +49,20 @@ export class Comment {
     setId(id) {
         this.id = id;
     }
+    setModifiedCallback(callback) {
+        this.onModified = callback;
+    }
+    notifyModified() {
+        if (this.onModified) {
+            this.onModified();
+        }
+    }
     getAuthor() {
         return this.author;
     }
     setAuthor(author) {
         this.author = author;
+        this.notifyModified();
         return this;
     }
     getInitials() {
@@ -58,6 +70,7 @@ export class Comment {
     }
     setInitials(initials) {
         this.initials = initials;
+        this.notifyModified();
         return this;
     }
     getDate() {
@@ -65,6 +78,7 @@ export class Comment {
     }
     setDate(date) {
         this.date = date;
+        this.notifyModified();
         return this;
     }
     getParentId() {
@@ -78,21 +92,51 @@ export class Comment {
     }
     resolve() {
         this.done = true;
+        this.notifyModified();
         return this;
     }
     unresolve() {
         this.done = false;
+        this.notifyModified();
         return this;
     }
     getRuns() {
-        return [...this.runs];
+        const runs = [];
+        for (const paragraph of this.paragraphs) {
+            for (const item of paragraph.content) {
+                if (item instanceof Run) {
+                    runs.push(item);
+                }
+                else {
+                    runs.push(...item.runs);
+                }
+            }
+        }
+        return runs;
     }
     addRun(run) {
-        this.runs.push(run);
+        let last = this.paragraphs[this.paragraphs.length - 1];
+        if (!last) {
+            last = { content: [] };
+            this.paragraphs.push(last);
+        }
+        last.content.push(run);
+        this.notifyModified();
         return this;
     }
+    getParagraphs() {
+        return this.paragraphs.map((paragraph) => ({
+            pPr: paragraph.pPr,
+            content: [...paragraph.content],
+        }));
+    }
+    setParagraphs(paragraphs) {
+        this.paragraphs = paragraphs;
+    }
     getText() {
-        return this.runs.map((run) => run.getText()).join('');
+        return this.getRuns()
+            .map((run) => run.getText())
+            .join('');
     }
     getContent() {
         return this.getText();
@@ -145,14 +189,25 @@ export class Comment {
         if (this.done) {
             attributes['w:done'] = '1';
         }
-        const commentParagraph = {
-            name: 'w:p',
-            children: this.runs.map((run) => run.toXML()),
-        };
+        const commentParagraphs = this.paragraphs.map((paragraph) => {
+            const children = [];
+            if (paragraph.pPr) {
+                children.push({ name: '__rawXml', rawXml: paragraph.pPr });
+            }
+            for (const item of paragraph.content) {
+                if (item instanceof Run) {
+                    children.push(item.toXML());
+                }
+                else {
+                    children.push({ name: '__rawXml', rawXml: item.rawXml });
+                }
+            }
+            return { name: 'w:p', children };
+        });
         return {
             name: 'w:comment',
             attributes,
-            children: [commentParagraph],
+            children: commentParagraphs,
         };
     }
     static create(author, content, initials) {

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

@@ -1 +1 @@
-{"version":3,"file":"Comment.js","sourceRoot":"","sources":["../../../src/elements/Comment.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Comment - Represents a comment/annotation in a Word document\n *\n * Comments allow users to annotate specific text ranges in a document.\n * They include author, date, content, and can have replies.\n */\n\nimport { Run } from './Run.js';\nimport { XMLElement } from '../xml/XMLBuilder.js';\nimport { formatDateForXml } from '../utils/dateFormatting.js';\n\n/**\n * Comment properties\n */\nexport interface CommentProperties {\n  /** Unique comment ID (assigned by CommentManager) */\n  id?: number;\n  /** Author who created the comment */\n  author: string;\n  /** Author's initials (optional) */\n  initials?: string;\n  /** Date when the comment was created */\n  date?: Date;\n  /** Comment content (text or runs) */\n  content: string | Run | Run[];\n  /** Parent comment ID (for replies) */\n  parentId?: number;\n  /** Whether the comment is resolved/done (w:done attribute per ECMA-376) */\n  done?: boolean;\n}\n\n/**\n * Represents a comment/annotation in a document\n */\nexport class Comment {\n  private id: number;\n  private author: string;\n  private initials: string;\n  private date: Date;\n  private runs: Run[];\n  private parentId?: number;\n  private done: boolean;\n\n  /**\n   * Creates a new Comment\n   * @param properties - Comment properties\n   */\n  constructor(properties: CommentProperties) {\n    this.id = properties.id ?? 0; // Will be assigned by CommentManager\n    this.author = properties.author;\n    this.initials = properties.initials || this.generateInitials(properties.author);\n    this.date = properties.date || new Date();\n    this.parentId = properties.parentId;\n    this.done = properties.done ?? false;\n\n    // Convert content to runs\n    if (typeof properties.content === 'string') {\n      this.runs = [new Run(properties.content)];\n    } else if (Array.isArray(properties.content)) {\n      this.runs = properties.content;\n    } else {\n      this.runs = [properties.content];\n    }\n  }\n\n  /**\n   * Generates initials from author name\n   * Examples: \"John Doe\" -> \"JD\", \"Jane Smith\" -> \"JS\"\n   */\n  private generateInitials(author: string): string {\n    const words = author\n      .trim()\n      .split(/\\s+/)\n      .filter((w) => w.length > 0);\n    if (words.length === 0) return 'U';\n    if (words.length === 1) return (words[0] || 'U').substring(0, 2).toUpperCase();\n    return (\n      words\n        .map((word) => word[0] || '')\n        .join('')\n        .toUpperCase()\n        .substring(0, 3) || 'U'\n    );\n  }\n\n  /**\n   * Gets the comment ID\n   */\n  getId(): number {\n    return this.id;\n  }\n\n  /**\n   * Sets the comment ID (used by CommentManager)\n   * @internal\n   */\n  setId(id: number): void {\n    this.id = id;\n  }\n\n  /**\n   * Gets the author\n   */\n  getAuthor(): string {\n    return this.author;\n  }\n\n  /**\n   * Sets the author\n   */\n  setAuthor(author: string): this {\n    this.author = author;\n    return this;\n  }\n\n  /**\n   * Gets the author's initials\n   */\n  getInitials(): string {\n    return this.initials;\n  }\n\n  /**\n   * Sets the author's initials\n   */\n  setInitials(initials: string): this {\n    this.initials = initials;\n    return this;\n  }\n\n  /**\n   * Gets the comment date\n   */\n  getDate(): Date {\n    return this.date;\n  }\n\n  /**\n   * Sets the comment date\n   */\n  setDate(date: Date): this {\n    this.date = date;\n    return this;\n  }\n\n  /**\n   * Gets the parent comment ID (for replies)\n   */\n  getParentId(): number | undefined {\n    return this.parentId;\n  }\n\n  /**\n   * Checks if this is a reply to another comment\n   */\n  isReply(): boolean {\n    return this.parentId !== undefined;\n  }\n\n  /**\n   * Checks if the comment is resolved/done\n   * Per ECMA-376 Part 1, Section 17.13.4.2 (w:done attribute)\n   */\n  isResolved(): boolean {\n    return this.done;\n  }\n\n  /**\n   * Marks the comment as resolved/done\n   * Sets w:done=\"1\" in the XML output\n   */\n  resolve(): this {\n    this.done = true;\n    return this;\n  }\n\n  /**\n   * Marks the comment as unresolved\n   * Removes w:done attribute from XML output\n   */\n  unresolve(): this {\n    this.done = false;\n    return this;\n  }\n\n  /**\n   * Gets the runs in this comment\n   */\n  getRuns(): Run[] {\n    return [...this.runs];\n  }\n\n  /**\n   * Adds a run to this comment\n   */\n  addRun(run: Run): this {\n    this.runs.push(run);\n    return this;\n  }\n\n  /**\n   * Gets the comment text (combines all runs)\n   */\n  getText(): string {\n    return this.runs.map((run) => run.getText()).join('');\n  }\n\n  /**\n   * Gets the comment content (alias for getText for compatibility)\n   */\n  getContent(): string {\n    return this.getText();\n  }\n\n  /**\n   * Formats a date to ISO 8601 format for XML\n   * Uses formatDateForXml() to strip milliseconds which Word does not accept.\n   */\n  private formatDate(date: Date): string {\n    return formatDateForXml(date);\n  }\n\n  /**\n   * Generates XML for the comment range start marker\n   * This goes in word/document.xml at the start of the commented range\n   */\n  toRangeStartXML(): XMLElement {\n    return {\n      name: 'w:commentRangeStart',\n      attributes: {\n        'w:id': this.id.toString(),\n      },\n      selfClosing: true,\n    };\n  }\n\n  /**\n   * Generates XML for the comment range end marker\n   * This goes in word/document.xml at the end of the commented range\n   */\n  toRangeEndXML(): XMLElement {\n    return {\n      name: 'w:commentRangeEnd',\n      attributes: {\n        'w:id': this.id.toString(),\n      },\n      selfClosing: true,\n    };\n  }\n\n  /**\n   * Generates XML for the comment reference\n   * This goes in word/document.xml after the range end, inside a run\n   */\n  toReferenceXML(): XMLElement {\n    return {\n      name: 'w:r',\n      children: [\n        {\n          name: 'w:commentReference',\n          attributes: {\n            'w:id': this.id.toString(),\n          },\n          selfClosing: true,\n        },\n      ],\n    };\n  }\n\n  /**\n   * Generates XML for the comment definition\n   * This goes in word/comments.xml\n   */\n  toXML(): XMLElement {\n    const attributes: Record<string, string> = {\n      'w:id': this.id.toString(),\n      'w:author': this.author,\n      'w:date': this.formatDate(this.date),\n      'w:initials': this.initials,\n    };\n\n    // Add parent ID for replies (w15 namespace per Office 2012 extensions)\n    if (this.parentId !== undefined) {\n      attributes['w15:parentId'] = this.parentId.toString();\n    }\n\n    // Add done attribute for resolved comments (per ECMA-376)\n    if (this.done) {\n      attributes['w:done'] = '1';\n    }\n\n    // Create paragraph containing the comment content\n    const commentParagraph: XMLElement = {\n      name: 'w:p',\n      children: this.runs.map((run) => run.toXML()),\n    };\n\n    return {\n      name: 'w:comment',\n      attributes,\n      children: [commentParagraph],\n    };\n  }\n\n  /**\n   * Creates a new comment\n   * @param author - Comment author\n   * @param content - Comment content (text or runs)\n   * @param initials - Optional author initials\n   * @returns New Comment instance\n   */\n  static create(author: string, content: string | Run | Run[], initials?: string): Comment {\n    return new Comment({\n      author,\n      content,\n      initials,\n    });\n  }\n\n  /**\n   * Creates a reply to an existing comment\n   * @param parentId - ID of the parent comment\n   * @param author - Reply author\n   * @param content - Reply content (text or runs)\n   * @param initials - Optional author initials\n   * @returns New Comment instance (reply)\n   */\n  static createReply(\n    parentId: number,\n    author: string,\n    content: string | Run | Run[],\n    initials?: string\n  ): Comment {\n    return new Comment({\n      author,\n      content,\n      initials,\n      parentId,\n    });\n  }\n\n  /**\n   * Creates a comment with formatted content\n   * @param author - Comment author\n   * @param runs - Array of formatted runs\n   * @param initials - Optional author initials\n   * @returns New Comment instance\n   */\n  static createFormatted(author: string, runs: Run[], initials?: string): Comment {\n    return new Comment({\n      author,\n      content: runs,\n      initials,\n    });\n  }\n}\n"]}
+{"version":3,"file":"Comment.js","sourceRoot":"","sources":["../../../src/elements/Comment.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Comment - Represents a comment/annotation in a Word document\n *\n * Comments allow users to annotate specific text ranges in a document.\n * They include author, date, content, and can have replies.\n */\n\nimport { Run } from './Run.js';\nimport { XMLElement } from '../xml/XMLBuilder.js';\nimport { formatDateForXml } from '../utils/dateFormatting.js';\n\n/**\n * Inline comment content preserved as raw XML (e.g. w:hyperlink wrappers\n * from a parsed comments.xml). The wrapper is re-emitted verbatim on\n * regeneration so its r:id target survives; the runs parsed from inside\n * it are kept alongside so text extraction still sees their text.\n */\nexport interface CommentPreservedContent {\n  /** Original XML emitted verbatim when comments.xml is regenerated */\n  rawXml: string;\n  /** Runs parsed from inside the preserved element (text extraction only) */\n  runs: Run[];\n}\n\n/** Ordered item of comment paragraph content */\nexport type CommentContentItem = Run | CommentPreservedContent;\n\n/**\n * One paragraph of comment content. CT_Comment accepts block-level content\n * (ECMA-376 §17.13.4.2), so comments can span multiple paragraphs, each\n * with its own paragraph properties (typically the CommentText style).\n */\nexport interface CommentParagraph {\n  /** Raw <w:pPr> XML preserved for round-trip */\n  pPr?: string;\n  /** Paragraph content in document order */\n  content: CommentContentItem[];\n}\n\n/**\n * Comment properties\n */\nexport interface CommentProperties {\n  /** Unique comment ID (assigned by CommentManager) */\n  id?: number;\n  /** Author who created the comment */\n  author: string;\n  /** Author's initials (optional) */\n  initials?: string;\n  /** Date when the comment was created */\n  date?: Date;\n  /** Comment content (text or runs) */\n  content: string | Run | Run[];\n  /** Parent comment ID (for replies) */\n  parentId?: number;\n  /** Whether the comment is resolved/done (w:done attribute per ECMA-376) */\n  done?: boolean;\n}\n\n/**\n * Represents a comment/annotation in a document\n */\nexport class Comment {\n  private id: number;\n  private author: string;\n  private initials: string;\n  private date: Date;\n  private paragraphs: CommentParagraph[];\n  private parentId?: number;\n  private done: boolean;\n  private onModified: (() => void) | null = null;\n\n  /**\n   * Creates a new Comment\n   * @param properties - Comment properties\n   */\n  constructor(properties: CommentProperties) {\n    this.id = properties.id ?? 0; // Will be assigned by CommentManager\n    this.author = properties.author;\n    this.initials = properties.initials || this.generateInitials(properties.author);\n    this.date = properties.date || new Date();\n    this.parentId = properties.parentId;\n    this.done = properties.done ?? false;\n\n    // Convert content to runs in a single paragraph\n    let runs: Run[];\n    if (typeof properties.content === 'string') {\n      runs = [new Run(properties.content)];\n    } else if (Array.isArray(properties.content)) {\n      runs = properties.content;\n    } else {\n      runs = [properties.content];\n    }\n    this.paragraphs = [{ content: runs }];\n  }\n\n  /**\n   * Generates initials from author name\n   * Examples: \"John Doe\" -> \"JD\", \"Jane Smith\" -> \"JS\"\n   */\n  private generateInitials(author: string): string {\n    const words = author\n      .trim()\n      .split(/\\s+/)\n      .filter((w) => w.length > 0);\n    if (words.length === 0) return 'U';\n    if (words.length === 1) return (words[0] || 'U').substring(0, 2).toUpperCase();\n    return (\n      words\n        .map((word) => word[0] || '')\n        .join('')\n        .toUpperCase()\n        .substring(0, 3) || 'U'\n    );\n  }\n\n  /**\n   * Gets the comment ID\n   */\n  getId(): number {\n    return this.id;\n  }\n\n  /**\n   * Sets the comment ID (used by CommentManager)\n   * @internal\n   */\n  setId(id: number): void {\n    this.id = id;\n  }\n\n  /**\n   * Registers a callback invoked whenever this comment is mutated.\n   * Document wires this to its comments dirty flag so edits to parsed\n   * comments trigger regeneration of comments.xml instead of being\n   * silently discarded by the original-XML passthrough on save.\n   * @internal\n   */\n  setModifiedCallback(callback: () => void): void {\n    this.onModified = callback;\n  }\n\n  private notifyModified(): void {\n    if (this.onModified) {\n      this.onModified();\n    }\n  }\n\n  /**\n   * Gets the author\n   */\n  getAuthor(): string {\n    return this.author;\n  }\n\n  /**\n   * Sets the author\n   */\n  setAuthor(author: string): this {\n    this.author = author;\n    this.notifyModified();\n    return this;\n  }\n\n  /**\n   * Gets the author's initials\n   */\n  getInitials(): string {\n    return this.initials;\n  }\n\n  /**\n   * Sets the author's initials\n   */\n  setInitials(initials: string): this {\n    this.initials = initials;\n    this.notifyModified();\n    return this;\n  }\n\n  /**\n   * Gets the comment date\n   */\n  getDate(): Date {\n    return this.date;\n  }\n\n  /**\n   * Sets the comment date\n   */\n  setDate(date: Date): this {\n    this.date = date;\n    this.notifyModified();\n    return this;\n  }\n\n  /**\n   * Gets the parent comment ID (for replies)\n   */\n  getParentId(): number | undefined {\n    return this.parentId;\n  }\n\n  /**\n   * Checks if this is a reply to another comment\n   */\n  isReply(): boolean {\n    return this.parentId !== undefined;\n  }\n\n  /**\n   * Checks if the comment is resolved/done\n   * Per ECMA-376 Part 1, Section 17.13.4.2 (w:done attribute)\n   */\n  isResolved(): boolean {\n    return this.done;\n  }\n\n  /**\n   * Marks the comment as resolved/done\n   * Persists as w15:done=\"1\" in word/commentsExtended.xml on save\n   */\n  resolve(): this {\n    this.done = true;\n    this.notifyModified();\n    return this;\n  }\n\n  /**\n   * Marks the comment as unresolved\n   * Drops the w15:done flag from word/commentsExtended.xml on save\n   */\n  unresolve(): this {\n    this.done = false;\n    this.notifyModified();\n    return this;\n  }\n\n  /**\n   * Gets the runs in this comment (flattened across paragraphs,\n   * including runs inside preserved inline content)\n   */\n  getRuns(): Run[] {\n    const runs: Run[] = [];\n    for (const paragraph of this.paragraphs) {\n      for (const item of paragraph.content) {\n        if (item instanceof Run) {\n          runs.push(item);\n        } else {\n          runs.push(...item.runs);\n        }\n      }\n    }\n    return runs;\n  }\n\n  /**\n   * Adds a run to this comment (appended to the last paragraph)\n   */\n  addRun(run: Run): this {\n    let last = this.paragraphs[this.paragraphs.length - 1];\n    if (!last) {\n      last = { content: [] };\n      this.paragraphs.push(last);\n    }\n    last.content.push(run);\n    this.notifyModified();\n    return this;\n  }\n\n  /**\n   * Gets the comment content grouped by paragraph\n   */\n  getParagraphs(): CommentParagraph[] {\n    return this.paragraphs.map((paragraph) => ({\n      pPr: paragraph.pPr,\n      content: [...paragraph.content],\n    }));\n  }\n\n  /**\n   * Replaces the comment content with parsed paragraphs.\n   * Used by DocumentParser to preserve <w:p> boundaries, paragraph\n   * properties, and hyperlink wrappers of comments loaded from an\n   * existing comments.xml. Not a user mutation — no dirty notification.\n   * @internal\n   */\n  setParagraphs(paragraphs: CommentParagraph[]): void {\n    this.paragraphs = paragraphs;\n  }\n\n  /**\n   * Gets the comment text (combines all runs)\n   */\n  getText(): string {\n    return this.getRuns()\n      .map((run) => run.getText())\n      .join('');\n  }\n\n  /**\n   * Gets the comment content (alias for getText for compatibility)\n   */\n  getContent(): string {\n    return this.getText();\n  }\n\n  /**\n   * Formats a date to ISO 8601 format for XML\n   * Uses formatDateForXml() to strip milliseconds which Word does not accept.\n   */\n  private formatDate(date: Date): string {\n    return formatDateForXml(date);\n  }\n\n  /**\n   * Generates XML for the comment range start marker\n   * This goes in word/document.xml at the start of the commented range\n   */\n  toRangeStartXML(): XMLElement {\n    return {\n      name: 'w:commentRangeStart',\n      attributes: {\n        'w:id': this.id.toString(),\n      },\n      selfClosing: true,\n    };\n  }\n\n  /**\n   * Generates XML for the comment range end marker\n   * This goes in word/document.xml at the end of the commented range\n   */\n  toRangeEndXML(): XMLElement {\n    return {\n      name: 'w:commentRangeEnd',\n      attributes: {\n        'w:id': this.id.toString(),\n      },\n      selfClosing: true,\n    };\n  }\n\n  /**\n   * Generates XML for the comment reference\n   * This goes in word/document.xml after the range end, inside a run\n   */\n  toReferenceXML(): XMLElement {\n    return {\n      name: 'w:r',\n      children: [\n        {\n          name: 'w:commentReference',\n          attributes: {\n            'w:id': this.id.toString(),\n          },\n          selfClosing: true,\n        },\n      ],\n    };\n  }\n\n  /**\n   * Generates XML for the comment definition\n   * This goes in word/comments.xml\n   */\n  toXML(): XMLElement {\n    const attributes: Record<string, string> = {\n      'w:id': this.id.toString(),\n      'w:author': this.author,\n      'w:date': this.formatDate(this.date),\n      'w:initials': this.initials,\n    };\n\n    // Add parent ID for replies (w15 namespace per Office 2012 extensions)\n    if (this.parentId !== undefined) {\n      attributes['w15:parentId'] = this.parentId.toString();\n    }\n\n    // Add done attribute for resolved comments (per ECMA-376)\n    if (this.done) {\n      attributes['w:done'] = '1';\n    }\n\n    // One <w:p> per stored paragraph — collapsing into a single paragraph\n    // concatenates words across the lost boundaries and drops the\n    // CommentText paragraph style of parsed comments\n    const commentParagraphs: XMLElement[] = this.paragraphs.map((paragraph) => {\n      const children: XMLElement[] = [];\n      if (paragraph.pPr) {\n        children.push({ name: '__rawXml', rawXml: paragraph.pPr });\n      }\n      for (const item of paragraph.content) {\n        if (item instanceof Run) {\n          children.push(item.toXML());\n        } else {\n          children.push({ name: '__rawXml', rawXml: item.rawXml });\n        }\n      }\n      return { name: 'w:p', children };\n    });\n\n    return {\n      name: 'w:comment',\n      attributes,\n      children: commentParagraphs,\n    };\n  }\n\n  /**\n   * Creates a new comment\n   * @param author - Comment author\n   * @param content - Comment content (text or runs)\n   * @param initials - Optional author initials\n   * @returns New Comment instance\n   */\n  static create(author: string, content: string | Run | Run[], initials?: string): Comment {\n    return new Comment({\n      author,\n      content,\n      initials,\n    });\n  }\n\n  /**\n   * Creates a reply to an existing comment\n   * @param parentId - ID of the parent comment\n   * @param author - Reply author\n   * @param content - Reply content (text or runs)\n   * @param initials - Optional author initials\n   * @returns New Comment instance (reply)\n   */\n  static createReply(\n    parentId: number,\n    author: string,\n    content: string | Run | Run[],\n    initials?: string\n  ): Comment {\n    return new Comment({\n      author,\n      content,\n      initials,\n      parentId,\n    });\n  }\n\n  /**\n   * Creates a comment with formatted content\n   * @param author - Comment author\n   * @param runs - Array of formatted runs\n   * @param initials - Optional author initials\n   * @returns New Comment instance\n   */\n  static createFormatted(author: string, runs: Run[], initials?: string): Comment {\n    return new Comment({\n      author,\n      content: runs,\n      initials,\n    });\n  }\n}\n"]}

package/dist/esm/elements/CommentManager.js

@@ -1,4 +1,5 @@
 import { Comment } from './Comment.js';
+import { Run } from './Run.js';
 import { XMLBuilder } from '../xml/XMLBuilder.js';
 import { formatDateForXml } from '../utils/dateFormatting.js';
 export class CommentManager {
@@ -6,13 +7,23 @@ export class CommentManager {
     nextId = 0;
     idProvider = null;
     idExistsNotifier = null;
+    modifiedNotifier = null;
     setIdProvider(provider, existsNotifier) {
         this.idProvider = provider;
         this.idExistsNotifier = existsNotifier || null;
     }
+    setModifiedNotifier(notifier) {
+        this.modifiedNotifier = notifier;
+        for (const entry of this.comments.values()) {
+            entry.comment.setModifiedCallback(notifier);
+        }
+    }
     register(comment) {
         const id = this.idProvider ? this.idProvider() : this.nextId++;
         comment.setId(id);
+        if (this.modifiedNotifier) {
+            comment.setModifiedCallback(this.modifiedNotifier);
+        }
         const entry = {
             comment,
             replies: [],
@@ -31,6 +42,9 @@ export class CommentManager {
         if (this.idExistsNotifier) {
             this.idExistsNotifier(id);
         }
+        if (this.modifiedNotifier) {
+            comment.setModifiedCallback(this.modifiedNotifier);
+        }
         const entry = {
             comment,
             replies: [],
@@ -107,6 +121,13 @@ export class CommentManager {
         for (const reply of entry.replies) {
             this.comments.delete(reply.getId());
         }
+        const parentId = entry.comment.getParentId();
+        if (parentId !== undefined) {
+            const parentEntry = this.comments.get(parentId);
+            if (parentEntry) {
+                parentEntry.replies = parentEntry.replies.filter((reply) => reply !== entry.comment);
+            }
+        }
         return this.comments.delete(id);
     }
     clear() {
@@ -183,22 +204,53 @@ export class CommentManager {
 </w:comments>`;
         }
         const hasReplies = comments.some((c) => c.isReply());
+        const hasResolved = comments.some((c) => c.isResolved());
         let xml = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n';
         xml += '<w:comments xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"';
         xml += ' xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"';
+        if (hasResolved) {
+            xml += ' xmlns:w14="http://schemas.microsoft.com/office/word/2010/wordml"';
+        }
         if (hasReplies) {
             xml += ' xmlns:w15="http://schemas.microsoft.com/office/word/2012/wordml"';
-            xml +=
-                ' xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" mc:Ignorable="w15"';
+        }
+        if (hasReplies || hasResolved) {
+            const ignorable = [hasResolved ? 'w14' : '', hasReplies ? 'w15' : '']
+                .filter((ns) => ns.length > 0)
+                .join(' ');
+            xml += ` xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" mc:Ignorable="${ignorable}"`;
         }
         xml += '>\n';
         for (const comment of comments) {
-            xml += this.commentToXmlString(comment);
+            xml += this.commentToXmlString(comment, hasResolved ? CommentManager.commentParaId(comment.getId()) : undefined);
         }
         xml += '</w:comments>';
         return xml;
     }
-    commentToXmlString(comment) {
+    static commentParaId(commentId) {
+        return ((commentId + 1) & 0x7fffffff).toString(16).toUpperCase().padStart(8, '0');
+    }
+    generateCommentsExtendedXml() {
+        const comments = this.getAllCommentsWithReplies();
+        if (!comments.some((c) => c.isResolved())) {
+            return null;
+        }
+        let xml = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n';
+        xml += '<w15:commentsEx xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"';
+        xml +=
+            ' xmlns:w15="http://schemas.microsoft.com/office/word/2012/wordml" mc:Ignorable="w15">\n';
+        for (const comment of comments) {
+            xml += `  <w15:commentEx w15:paraId="${CommentManager.commentParaId(comment.getId())}"`;
+            const parentId = comment.getParentId();
+            if (parentId !== undefined && this.comments.has(parentId)) {
+                xml += ` w15:paraIdParent="${CommentManager.commentParaId(parentId)}"`;
+            }
+            xml += ` w15:done="${comment.isResolved() ? '1' : '0'}"/>\n`;
+        }
+        xml += '</w15:commentsEx>';
+        return xml;
+    }
+    commentToXmlString(comment, paraId) {
         let xml = `  <w:comment w:id="${comment.getId()}"`;
         xml += ` w:author="${XMLBuilder.escapeXmlAttribute(comment.getAuthor())}"`;
         xml += ` w:date="${formatDateForXml(comment.getDate())}"`;
@@ -206,25 +258,31 @@ export class CommentManager {
         if (comment.isReply() && comment.getParentId() !== undefined) {
             xml += ` w15:parentId="${comment.getParentId()}"`;
         }
-        if (comment.isResolved()) {
-            xml += ` w:done="1"`;
-        }
         xml += '>\n';
-        xml += '    <w:p>\n';
-        for (const run of comment.getRuns()) {
-            xml += this.runToXmlString(run, 6);
+        const paragraphs = comment.getParagraphs();
+        for (let i = 0; i < paragraphs.length; i++) {
+            const paragraph = paragraphs[i];
+            const isLast = i === paragraphs.length - 1;
+            xml += isLast && paraId ? `    <w:p w14:paraId="${paraId}">\n` : '    <w:p>\n';
+            if (paragraph.pPr) {
+                xml += `      ${paragraph.pPr}\n`;
+            }
+            for (const item of paragraph.content) {
+                if (item instanceof Run) {
+                    xml += this.runToXmlString(item, 6);
+                }
+                else {
+                    xml += `      ${item.rawXml}\n`;
+                }
+            }
+            xml += '    </w:p>\n';
         }
-        xml += '    </w:p>\n';
         xml += '  </w:comment>\n';
         return xml;
     }
     runToXmlString(run, indent) {
         const spaces = ' '.repeat(indent);
-        const text = XMLBuilder.escapeXmlText(run.getText());
-        let xml = `${spaces}<w:r>\n`;
-        xml += `${spaces}  <w:t xml:space="preserve">${text}</w:t>\n`;
-        xml += `${spaces}</w:r>\n`;
-        return xml;
+        return `${spaces}${XMLBuilder.elementToString(run.toXML())}\n`;
     }
     static create() {
         return new CommentManager();

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

@@ -1 +1 @@
-{"version":3,"file":"CommentManager.js","sourceRoot":"","sources":["../../../src/elements/CommentManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * CommentManager - Manages comments in a document\n *\n * Tracks all comments, assigns unique IDs, handles replies,\n * and generates the comments.xml file.\n *\n * Per ECMA-376, comment IDs must be unique across ALL annotation types\n * in a document. Use setIdProvider() to connect to a centralized ID allocator.\n */\n\nimport { Comment } from './Comment.js';\nimport { Run } from './Run.js';\nimport { XMLBuilder } from '../xml/XMLBuilder.js';\nimport { formatDateForXml } from '../utils/dateFormatting.js';\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 existing comments to keep the central counter in sync.\n */\nexport type IdExistsCallback = (existingId: number) => void;\n\n/**\n * Comment entry stored by the manager\n */\ninterface CommentEntry {\n  comment: Comment;\n  /** Comments that are replies to this comment */\n  replies: Comment[];\n}\n\n/**\n * Manages document comments\n */\nexport class CommentManager {\n  private comments = new Map<number, CommentEntry>();\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 comment with the manager\n   * Assigns a unique ID\n   * @param comment - Comment to register\n   * @returns The registered comment (same instance)\n   */\n  register(comment: Comment): Comment {\n    // Assign unique ID - use centralized provider if available\n    const id = this.idProvider ? this.idProvider() : this.nextId++;\n    comment.setId(id);\n\n    // Store comment\n    const entry: CommentEntry = {\n      comment,\n      replies: [],\n    };\n    this.comments.set(comment.getId(), entry);\n\n    // If this is a reply, add it to the parent's replies array\n    if (comment.isReply() && comment.getParentId() !== undefined) {\n      const parentEntry = this.comments.get(comment.getParentId()!);\n      if (parentEntry) {\n        parentEntry.replies.push(comment);\n      }\n    }\n\n    return comment;\n  }\n\n  /**\n   * Registers an existing comment (from parsing) with its pre-assigned ID.\n   * Unlike register(), this does NOT assign a new ID - the comment must already have one.\n   * Used when loading comments from an existing document.\n   * @param comment - Comment with ID already set\n   */\n  registerExisting(comment: Comment): void {\n    const id = comment.getId();\n\n    // Notify centralized ID manager if connected\n    if (this.idExistsNotifier) {\n      this.idExistsNotifier(id);\n    }\n\n    // Store comment\n    const entry: CommentEntry = {\n      comment,\n      replies: [],\n    };\n    this.comments.set(id, entry);\n\n    // Update local nextId if needed\n    if (id >= this.nextId) {\n      this.nextId = id + 1;\n    }\n  }\n\n  /**\n   * Links reply comments to their parents after all comments are parsed.\n   * Must be called after all comments are registered via registerExisting().\n   * This builds the reply arrays for each parent comment.\n   */\n  linkReplies(): void {\n    // Clear existing replies first for idempotency (safe to call multiple times)\n    for (const entry of this.comments.values()) {\n      entry.replies = [];\n    }\n    for (const entry of this.comments.values()) {\n      const comment = entry.comment;\n      if (comment.isReply() && comment.getParentId() !== undefined) {\n        const parentEntry = this.comments.get(comment.getParentId()!);\n        if (parentEntry) {\n          parentEntry.replies.push(comment);\n        }\n      }\n    }\n  }\n\n  /**\n   * Gets a comment by ID\n   * @param id - Comment ID\n   * @returns The comment, or undefined if not found\n   */\n  getComment(id: number): Comment | undefined {\n    return this.comments.get(id)?.comment;\n  }\n\n  /**\n   * Gets all comments (top-level only, not replies)\n   * @returns Array of all top-level comments\n   */\n  getAllComments(): Comment[] {\n    return Array.from(this.comments.values())\n      .filter((entry) => !entry.comment.isReply())\n      .map((entry) => entry.comment);\n  }\n\n  /**\n   * Gets all comments including replies\n   * @returns Array of all comments\n   */\n  getAllCommentsWithReplies(): Comment[] {\n    return Array.from(this.comments.values()).map((entry) => entry.comment);\n  }\n\n  /**\n   * Gets replies to a comment\n   * @param commentId - ID of the parent comment\n   * @returns Array of reply comments\n   */\n  getReplies(commentId: number): Comment[] {\n    const entry = this.comments.get(commentId);\n    return entry ? [...entry.replies] : [];\n  }\n\n  /**\n   * Checks if a comment has replies\n   * @param commentId - ID of the comment\n   * @returns True if the comment has replies\n   */\n  hasReplies(commentId: number): boolean {\n    const entry = this.comments.get(commentId);\n    return entry ? entry.replies.length > 0 : false;\n  }\n\n  /**\n   * Gets the number of comments (including replies)\n   * @returns Number of comments\n   */\n  getCount(): number {\n    return this.comments.size;\n  }\n\n  /**\n   * Gets the number of top-level comments (excluding replies)\n   * @returns Number of top-level comments\n   */\n  getTopLevelCount(): number {\n    return this.getAllComments().length;\n  }\n\n  /**\n   * Gets all unique authors who have made comments\n   * @returns Array of unique author names\n   */\n  getAuthors(): string[] {\n    const authorsSet = new Set<string>();\n    for (const entry of this.comments.values()) {\n      authorsSet.add(entry.comment.getAuthor());\n    }\n    return Array.from(authorsSet);\n  }\n\n  /**\n   * Gets comments by author\n   * @param author - Author name to filter by\n   * @returns Array of comments by the specified author\n   */\n  getCommentsByAuthor(author: string): Comment[] {\n    return Array.from(this.comments.values())\n      .map((entry) => entry.comment)\n      .filter((comment) => comment.getAuthor() === author);\n  }\n\n  /**\n   * Gets comments within a date range\n   * @param startDate - Start of date range\n   * @param endDate - End of date range\n   * @returns Array of comments within the date range\n   */\n  getCommentsByDateRange(startDate: Date, endDate: Date): Comment[] {\n    return Array.from(this.comments.values())\n      .map((entry) => entry.comment)\n      .filter((comment) => {\n        const commentDate = comment.getDate();\n        return commentDate >= startDate && commentDate <= endDate;\n      });\n  }\n\n  /**\n   * Removes a comment\n   * Also removes all replies to that comment\n   * @param id - Comment ID\n   * @returns True if the comment was removed\n   */\n  removeComment(id: number): boolean {\n    const entry = this.comments.get(id);\n    if (!entry) {\n      return false;\n    }\n\n    // Remove all replies first\n    for (const reply of entry.replies) {\n      this.comments.delete(reply.getId());\n    }\n\n    // Remove the comment itself\n    return this.comments.delete(id);\n  }\n\n  /**\n   * Clears all comments\n   */\n  clear(): void {\n    this.comments.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 comments.\n   * @param id - The next ID value to use\n   */\n  setNextId(id: number): void {\n    this.nextId = id;\n  }\n\n  /**\n   * Creates and registers a new comment\n   * @param author - Comment author\n   * @param content - Comment content (text or runs)\n   * @param initials - Optional author initials\n   * @returns The created and registered comment\n   */\n  createComment(author: string, content: string | Run | Run[], initials?: string): Comment {\n    const comment = Comment.create(author, content, initials);\n    return this.register(comment);\n  }\n\n  /**\n   * Creates and registers a reply to an existing comment\n   * @param parentCommentId - ID of the parent comment\n   * @param author - Reply author\n   * @param content - Reply content (text or runs)\n   * @param initials - Optional author initials\n   * @returns The created and registered reply\n   * @throws Error if parent comment doesn't exist\n   */\n  createReply(\n    parentCommentId: number,\n    author: string,\n    content: string | Run | Run[],\n    initials?: string\n  ): Comment {\n    // Verify parent exists\n    if (!this.comments.has(parentCommentId)) {\n      throw new Error(\n        `Cannot create reply: parent comment with ID ${parentCommentId} does not exist`\n      );\n    }\n\n    const reply = Comment.createReply(parentCommentId, author, content, initials);\n    return this.register(reply);\n  }\n\n  /**\n   * Checks if there are any comments\n   * @returns True if there are no comments\n   */\n  isEmpty(): boolean {\n    return this.comments.size === 0;\n  }\n\n  /**\n   * Gets a comment thread (comment and all its replies)\n   * @param commentId - ID of the top-level comment\n   * @returns Object with the comment and its replies\n   */\n  getCommentThread(commentId: number): { comment: Comment; replies: Comment[] } | undefined {\n    const entry = this.comments.get(commentId);\n    if (!entry || entry.comment.isReply()) {\n      return undefined;\n    }\n    return {\n      comment: entry.comment,\n      replies: [...entry.replies],\n    };\n  }\n\n  /**\n   * Searches comments by text content\n   * @param searchText - Text to search for (case-insensitive)\n   * @returns Array of comments containing the search text\n   */\n  findCommentsByText(searchText: string): Comment[] {\n    const lowerSearch = searchText.toLowerCase();\n    return Array.from(this.comments.values())\n      .map((entry) => entry.comment)\n      .filter((comment) => comment.getText().toLowerCase().includes(lowerSearch));\n  }\n\n  /**\n   * Gets all resolved/done comments\n   * @returns Array of resolved comments\n   */\n  getResolvedComments(): Comment[] {\n    return Array.from(this.comments.values())\n      .map((entry) => entry.comment)\n      .filter((comment) => comment.isResolved());\n  }\n\n  /**\n   * Gets all unresolved comments\n   * @returns Array of unresolved comments\n   */\n  getUnresolvedComments(): Comment[] {\n    return Array.from(this.comments.values())\n      .map((entry) => entry.comment)\n      .filter((comment) => !comment.isResolved());\n  }\n\n  /**\n   * Gets the most recent comments\n   * @param count - Number of recent comments to return\n   * @returns Array of most recent comments\n   */\n  getRecentComments(count: number): Comment[] {\n    const allComments = this.getAllCommentsWithReplies();\n    return allComments\n      .sort((a, b) => b.getDate().getTime() - a.getDate().getTime())\n      .slice(0, count);\n  }\n\n  /**\n   * Gets statistics about comments\n   * @returns Object with comment statistics\n   */\n  getStats(): {\n    total: number;\n    topLevel: number;\n    replies: number;\n    resolved: number;\n    unresolved: number;\n    authors: string[];\n    nextId: number;\n  } {\n    const topLevel = this.getTopLevelCount();\n    const resolved = this.getResolvedComments().length;\n    return {\n      total: this.comments.size,\n      topLevel,\n      replies: this.comments.size - topLevel,\n      resolved,\n      unresolved: this.comments.size - resolved,\n      authors: this.getAuthors(),\n      nextId: this.nextId,\n    };\n  }\n\n  /**\n   * Generates the word/comments.xml file content\n   * @returns XML string for comments.xml\n   */\n  generateCommentsXml(): string {\n    const comments = this.getAllCommentsWithReplies();\n\n    if (comments.length === 0) {\n      // Return minimal comments.xml\n      return `<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<w:comments xmlns:w=\"http://schemas.openxmlformats.org/wordprocessingml/2006/main\">\n</w:comments>`;\n    }\n\n    // Build XML manually for comments\n    const hasReplies = comments.some((c) => c.isReply());\n    let xml = '<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\\n';\n    xml += '<w:comments xmlns:w=\"http://schemas.openxmlformats.org/wordprocessingml/2006/main\"';\n    xml += ' xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\"';\n    if (hasReplies) {\n      xml += ' xmlns:w15=\"http://schemas.microsoft.com/office/word/2012/wordml\"';\n      xml +=\n        ' xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\" mc:Ignorable=\"w15\"';\n    }\n    xml += '>\\n';\n\n    // Add each comment\n    for (const comment of comments) {\n      xml += this.commentToXmlString(comment);\n    }\n\n    xml += '</w:comments>';\n    return xml;\n  }\n\n  /**\n   * Converts a comment to XML string\n   * @param comment - Comment to convert\n   * @returns XML string for the comment\n   */\n  private commentToXmlString(comment: Comment): string {\n    let xml = `  <w:comment w:id=\"${comment.getId()}\"`;\n    xml += ` w:author=\"${XMLBuilder.escapeXmlAttribute(comment.getAuthor())}\"`;\n    xml += ` w:date=\"${formatDateForXml(comment.getDate())}\"`;\n    xml += ` w:initials=\"${XMLBuilder.escapeXmlAttribute(comment.getInitials())}\"`;\n\n    if (comment.isReply() && comment.getParentId() !== undefined) {\n      xml += ` w15:parentId=\"${comment.getParentId()}\"`;\n    }\n\n    // Add done attribute for resolved comments (per ECMA-376)\n    if (comment.isResolved()) {\n      xml += ` w:done=\"1\"`;\n    }\n\n    xml += '>\\n';\n\n    // Add paragraph with runs\n    xml += '    <w:p>\\n';\n    for (const run of comment.getRuns()) {\n      xml += this.runToXmlString(run, 6);\n    }\n    xml += '    </w:p>\\n';\n\n    xml += '  </w:comment>\\n';\n    return xml;\n  }\n\n  /**\n   * Converts a run to XML string\n   * @param run - Run to convert\n   * @param indent - Number of spaces for indentation\n   * @returns XML string for the run\n   */\n  private runToXmlString(run: Run, indent: number): string {\n    const spaces = ' '.repeat(indent);\n    const text = XMLBuilder.escapeXmlText(run.getText());\n\n    let xml = `${spaces}<w:r>\\n`;\n    xml += `${spaces}  <w:t xml:space=\"preserve\">${text}</w:t>\\n`;\n    xml += `${spaces}</w:r>\\n`;\n\n    return xml;\n  }\n\n  /**\n   * Creates a new CommentManager\n   * @returns New CommentManager instance\n   */\n  static create(): CommentManager {\n    return new CommentManager();\n  }\n}\n"]}
+{"version":3,"file":"CommentManager.js","sourceRoot":"","sources":["../../../src/elements/CommentManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * CommentManager - Manages comments in a document\n *\n * Tracks all comments, assigns unique IDs, handles replies,\n * and generates the comments.xml file.\n *\n * Per ECMA-376, comment IDs must be unique across ALL annotation types\n * in a document. Use setIdProvider() to connect to a centralized ID allocator.\n */\n\nimport { Comment } from './Comment.js';\nimport { Run } from './Run.js';\nimport { XMLBuilder } from '../xml/XMLBuilder.js';\nimport { formatDateForXml } from '../utils/dateFormatting.js';\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 existing comments to keep the central counter in sync.\n */\nexport type IdExistsCallback = (existingId: number) => void;\n\n/**\n * Comment entry stored by the manager\n */\ninterface CommentEntry {\n  comment: Comment;\n  /** Comments that are replies to this comment */\n  replies: Comment[];\n}\n\n/**\n * Manages document comments\n */\nexport class CommentManager {\n  private comments = new Map<number, CommentEntry>();\n  private nextId = 0;\n  private idProvider: IdProviderCallback | null = null;\n  private idExistsNotifier: IdExistsCallback | null = null;\n  private modifiedNotifier: (() => void) | 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   * Sets the callback invoked when a registered comment is mutated.\n   * Document wires this to its comments dirty flag so instance-level edits\n   * (resolve, setAuthor, addRun, ...) force comments.xml regeneration\n   * instead of being silently discarded by the original-XML passthrough.\n   *\n   * @param notifier - Callback invoked on any comment mutation\n   */\n  setModifiedNotifier(notifier: () => void): void {\n    this.modifiedNotifier = notifier;\n    for (const entry of this.comments.values()) {\n      entry.comment.setModifiedCallback(notifier);\n    }\n  }\n\n  /**\n   * Registers a comment with the manager\n   * Assigns a unique ID\n   * @param comment - Comment to register\n   * @returns The registered comment (same instance)\n   */\n  register(comment: Comment): Comment {\n    // Assign unique ID - use centralized provider if available\n    const id = this.idProvider ? this.idProvider() : this.nextId++;\n    comment.setId(id);\n\n    if (this.modifiedNotifier) {\n      comment.setModifiedCallback(this.modifiedNotifier);\n    }\n\n    // Store comment\n    const entry: CommentEntry = {\n      comment,\n      replies: [],\n    };\n    this.comments.set(comment.getId(), entry);\n\n    // If this is a reply, add it to the parent's replies array\n    if (comment.isReply() && comment.getParentId() !== undefined) {\n      const parentEntry = this.comments.get(comment.getParentId()!);\n      if (parentEntry) {\n        parentEntry.replies.push(comment);\n      }\n    }\n\n    return comment;\n  }\n\n  /**\n   * Registers an existing comment (from parsing) with its pre-assigned ID.\n   * Unlike register(), this does NOT assign a new ID - the comment must already have one.\n   * Used when loading comments from an existing document.\n   * @param comment - Comment with ID already set\n   */\n  registerExisting(comment: Comment): void {\n    const id = comment.getId();\n\n    // Notify centralized ID manager if connected\n    if (this.idExistsNotifier) {\n      this.idExistsNotifier(id);\n    }\n\n    if (this.modifiedNotifier) {\n      comment.setModifiedCallback(this.modifiedNotifier);\n    }\n\n    // Store comment\n    const entry: CommentEntry = {\n      comment,\n      replies: [],\n    };\n    this.comments.set(id, entry);\n\n    // Update local nextId if needed\n    if (id >= this.nextId) {\n      this.nextId = id + 1;\n    }\n  }\n\n  /**\n   * Links reply comments to their parents after all comments are parsed.\n   * Must be called after all comments are registered via registerExisting().\n   * This builds the reply arrays for each parent comment.\n   */\n  linkReplies(): void {\n    // Clear existing replies first for idempotency (safe to call multiple times)\n    for (const entry of this.comments.values()) {\n      entry.replies = [];\n    }\n    for (const entry of this.comments.values()) {\n      const comment = entry.comment;\n      if (comment.isReply() && comment.getParentId() !== undefined) {\n        const parentEntry = this.comments.get(comment.getParentId()!);\n        if (parentEntry) {\n          parentEntry.replies.push(comment);\n        }\n      }\n    }\n  }\n\n  /**\n   * Gets a comment by ID\n   * @param id - Comment ID\n   * @returns The comment, or undefined if not found\n   */\n  getComment(id: number): Comment | undefined {\n    return this.comments.get(id)?.comment;\n  }\n\n  /**\n   * Gets all comments (top-level only, not replies)\n   * @returns Array of all top-level comments\n   */\n  getAllComments(): Comment[] {\n    return Array.from(this.comments.values())\n      .filter((entry) => !entry.comment.isReply())\n      .map((entry) => entry.comment);\n  }\n\n  /**\n   * Gets all comments including replies\n   * @returns Array of all comments\n   */\n  getAllCommentsWithReplies(): Comment[] {\n    return Array.from(this.comments.values()).map((entry) => entry.comment);\n  }\n\n  /**\n   * Gets replies to a comment\n   * @param commentId - ID of the parent comment\n   * @returns Array of reply comments\n   */\n  getReplies(commentId: number): Comment[] {\n    const entry = this.comments.get(commentId);\n    return entry ? [...entry.replies] : [];\n  }\n\n  /**\n   * Checks if a comment has replies\n   * @param commentId - ID of the comment\n   * @returns True if the comment has replies\n   */\n  hasReplies(commentId: number): boolean {\n    const entry = this.comments.get(commentId);\n    return entry ? entry.replies.length > 0 : false;\n  }\n\n  /**\n   * Gets the number of comments (including replies)\n   * @returns Number of comments\n   */\n  getCount(): number {\n    return this.comments.size;\n  }\n\n  /**\n   * Gets the number of top-level comments (excluding replies)\n   * @returns Number of top-level comments\n   */\n  getTopLevelCount(): number {\n    return this.getAllComments().length;\n  }\n\n  /**\n   * Gets all unique authors who have made comments\n   * @returns Array of unique author names\n   */\n  getAuthors(): string[] {\n    const authorsSet = new Set<string>();\n    for (const entry of this.comments.values()) {\n      authorsSet.add(entry.comment.getAuthor());\n    }\n    return Array.from(authorsSet);\n  }\n\n  /**\n   * Gets comments by author\n   * @param author - Author name to filter by\n   * @returns Array of comments by the specified author\n   */\n  getCommentsByAuthor(author: string): Comment[] {\n    return Array.from(this.comments.values())\n      .map((entry) => entry.comment)\n      .filter((comment) => comment.getAuthor() === author);\n  }\n\n  /**\n   * Gets comments within a date range\n   * @param startDate - Start of date range\n   * @param endDate - End of date range\n   * @returns Array of comments within the date range\n   */\n  getCommentsByDateRange(startDate: Date, endDate: Date): Comment[] {\n    return Array.from(this.comments.values())\n      .map((entry) => entry.comment)\n      .filter((comment) => {\n        const commentDate = comment.getDate();\n        return commentDate >= startDate && commentDate <= endDate;\n      });\n  }\n\n  /**\n   * Removes a comment\n   * Also removes all replies to that comment\n   * @param id - Comment ID\n   * @returns True if the comment was removed\n   */\n  removeComment(id: number): boolean {\n    const entry = this.comments.get(id);\n    if (!entry) {\n      return false;\n    }\n\n    // Remove all replies first\n    for (const reply of entry.replies) {\n      this.comments.delete(reply.getId());\n    }\n\n    // A reply is also tracked in its parent's replies array — drop it there\n    // too so getReplies()/hasReplies()/getCommentThread() agree with the map\n    const parentId = entry.comment.getParentId();\n    if (parentId !== undefined) {\n      const parentEntry = this.comments.get(parentId);\n      if (parentEntry) {\n        parentEntry.replies = parentEntry.replies.filter((reply) => reply !== entry.comment);\n      }\n    }\n\n    // Remove the comment itself\n    return this.comments.delete(id);\n  }\n\n  /**\n   * Clears all comments\n   */\n  clear(): void {\n    this.comments.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 comments.\n   * @param id - The next ID value to use\n   */\n  setNextId(id: number): void {\n    this.nextId = id;\n  }\n\n  /**\n   * Creates and registers a new comment\n   * @param author - Comment author\n   * @param content - Comment content (text or runs)\n   * @param initials - Optional author initials\n   * @returns The created and registered comment\n   */\n  createComment(author: string, content: string | Run | Run[], initials?: string): Comment {\n    const comment = Comment.create(author, content, initials);\n    return this.register(comment);\n  }\n\n  /**\n   * Creates and registers a reply to an existing comment\n   * @param parentCommentId - ID of the parent comment\n   * @param author - Reply author\n   * @param content - Reply content (text or runs)\n   * @param initials - Optional author initials\n   * @returns The created and registered reply\n   * @throws Error if parent comment doesn't exist\n   */\n  createReply(\n    parentCommentId: number,\n    author: string,\n    content: string | Run | Run[],\n    initials?: string\n  ): Comment {\n    // Verify parent exists\n    if (!this.comments.has(parentCommentId)) {\n      throw new Error(\n        `Cannot create reply: parent comment with ID ${parentCommentId} does not exist`\n      );\n    }\n\n    const reply = Comment.createReply(parentCommentId, author, content, initials);\n    return this.register(reply);\n  }\n\n  /**\n   * Checks if there are any comments\n   * @returns True if there are no comments\n   */\n  isEmpty(): boolean {\n    return this.comments.size === 0;\n  }\n\n  /**\n   * Gets a comment thread (comment and all its replies)\n   * @param commentId - ID of the top-level comment\n   * @returns Object with the comment and its replies\n   */\n  getCommentThread(commentId: number): { comment: Comment; replies: Comment[] } | undefined {\n    const entry = this.comments.get(commentId);\n    if (!entry || entry.comment.isReply()) {\n      return undefined;\n    }\n    return {\n      comment: entry.comment,\n      replies: [...entry.replies],\n    };\n  }\n\n  /**\n   * Searches comments by text content\n   * @param searchText - Text to search for (case-insensitive)\n   * @returns Array of comments containing the search text\n   */\n  findCommentsByText(searchText: string): Comment[] {\n    const lowerSearch = searchText.toLowerCase();\n    return Array.from(this.comments.values())\n      .map((entry) => entry.comment)\n      .filter((comment) => comment.getText().toLowerCase().includes(lowerSearch));\n  }\n\n  /**\n   * Gets all resolved/done comments\n   * @returns Array of resolved comments\n   */\n  getResolvedComments(): Comment[] {\n    return Array.from(this.comments.values())\n      .map((entry) => entry.comment)\n      .filter((comment) => comment.isResolved());\n  }\n\n  /**\n   * Gets all unresolved comments\n   * @returns Array of unresolved comments\n   */\n  getUnresolvedComments(): Comment[] {\n    return Array.from(this.comments.values())\n      .map((entry) => entry.comment)\n      .filter((comment) => !comment.isResolved());\n  }\n\n  /**\n   * Gets the most recent comments\n   * @param count - Number of recent comments to return\n   * @returns Array of most recent comments\n   */\n  getRecentComments(count: number): Comment[] {\n    const allComments = this.getAllCommentsWithReplies();\n    return allComments\n      .sort((a, b) => b.getDate().getTime() - a.getDate().getTime())\n      .slice(0, count);\n  }\n\n  /**\n   * Gets statistics about comments\n   * @returns Object with comment statistics\n   */\n  getStats(): {\n    total: number;\n    topLevel: number;\n    replies: number;\n    resolved: number;\n    unresolved: number;\n    authors: string[];\n    nextId: number;\n  } {\n    const topLevel = this.getTopLevelCount();\n    const resolved = this.getResolvedComments().length;\n    return {\n      total: this.comments.size,\n      topLevel,\n      replies: this.comments.size - topLevel,\n      resolved,\n      unresolved: this.comments.size - resolved,\n      authors: this.getAuthors(),\n      nextId: this.nextId,\n    };\n  }\n\n  /**\n   * Generates the word/comments.xml file content\n   * @returns XML string for comments.xml\n   */\n  generateCommentsXml(): string {\n    const comments = this.getAllCommentsWithReplies();\n\n    if (comments.length === 0) {\n      // Return minimal comments.xml\n      return `<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<w:comments xmlns:w=\"http://schemas.openxmlformats.org/wordprocessingml/2006/main\">\n</w:comments>`;\n    }\n\n    // Build XML manually for comments\n    const hasReplies = comments.some((c) => c.isReply());\n    const hasResolved = comments.some((c) => c.isResolved());\n    let xml = '<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\\n';\n    xml += '<w:comments xmlns:w=\"http://schemas.openxmlformats.org/wordprocessingml/2006/main\"';\n    xml += ' xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\"';\n    if (hasResolved) {\n      xml += ' xmlns:w14=\"http://schemas.microsoft.com/office/word/2010/wordml\"';\n    }\n    if (hasReplies) {\n      xml += ' xmlns:w15=\"http://schemas.microsoft.com/office/word/2012/wordml\"';\n    }\n    if (hasReplies || hasResolved) {\n      const ignorable = [hasResolved ? 'w14' : '', hasReplies ? 'w15' : '']\n        .filter((ns) => ns.length > 0)\n        .join(' ');\n      xml += ` xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\" mc:Ignorable=\"${ignorable}\"`;\n    }\n    xml += '>\\n';\n\n    // Add each comment. CT_Comment declares no resolved-state attribute —\n    // that lives in commentsExtended.xml keyed by the w14:paraId of each\n    // comment's last paragraph, so emit those anchors when any comment is\n    // resolved (see generateCommentsExtendedXml)\n    for (const comment of comments) {\n      xml += this.commentToXmlString(\n        comment,\n        hasResolved ? CommentManager.commentParaId(comment.getId()) : undefined\n      );\n    }\n\n    xml += '</w:comments>';\n    return xml;\n  }\n\n  /**\n   * Derives the w14:paraId anchor for a comment's last paragraph.\n   * Deterministic so comments.xml and commentsExtended.xml agree without\n   * shared state. Values must be 8 hex digits, nonzero, and below\n   * 0x80000000 per ST_LongHexNumber conventions for paraId.\n   * @param commentId - Comment ID\n   * @returns 8-character uppercase hex paraId\n   */\n  static commentParaId(commentId: number): string {\n    return ((commentId + 1) & 0x7fffffff).toString(16).toUpperCase().padStart(8, '0');\n  }\n\n  /**\n   * Generates the word/commentsExtended.xml content carrying resolved\n   * state (w15:done) and reply threading (w15:paraIdParent).\n   * @returns XML string, or null when no comment is resolved (the part is\n   *   only regenerated when it carries information)\n   */\n  generateCommentsExtendedXml(): string | null {\n    const comments = this.getAllCommentsWithReplies();\n    if (!comments.some((c) => c.isResolved())) {\n      return null;\n    }\n\n    let xml = '<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\\n';\n    xml += '<w15:commentsEx xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"';\n    xml +=\n      ' xmlns:w15=\"http://schemas.microsoft.com/office/word/2012/wordml\" mc:Ignorable=\"w15\">\\n';\n    for (const comment of comments) {\n      xml += `  <w15:commentEx w15:paraId=\"${CommentManager.commentParaId(comment.getId())}\"`;\n      const parentId = comment.getParentId();\n      if (parentId !== undefined && this.comments.has(parentId)) {\n        xml += ` w15:paraIdParent=\"${CommentManager.commentParaId(parentId)}\"`;\n      }\n      xml += ` w15:done=\"${comment.isResolved() ? '1' : '0'}\"/>\\n`;\n    }\n    xml += '</w15:commentsEx>';\n    return xml;\n  }\n\n  /**\n   * Converts a comment to XML string\n   * @param comment - Comment to convert\n   * @param paraId - w14:paraId to anchor on the last paragraph (links the\n   *   comment to its commentsExtended.xml entry), omitted when no comment\n   *   in the document is resolved\n   * @returns XML string for the comment\n   */\n  private commentToXmlString(comment: Comment, paraId?: string): string {\n    let xml = `  <w:comment w:id=\"${comment.getId()}\"`;\n    xml += ` w:author=\"${XMLBuilder.escapeXmlAttribute(comment.getAuthor())}\"`;\n    xml += ` w:date=\"${formatDateForXml(comment.getDate())}\"`;\n    xml += ` w:initials=\"${XMLBuilder.escapeXmlAttribute(comment.getInitials())}\"`;\n\n    if (comment.isReply() && comment.getParentId() !== undefined) {\n      xml += ` w15:parentId=\"${comment.getParentId()}\"`;\n    }\n\n    xml += '>\\n';\n\n    // One <w:p> per stored paragraph — collapsing into a single paragraph\n    // concatenates words across the lost boundaries and drops paragraph\n    // properties (CommentText pStyle) of parsed comments\n    const paragraphs = comment.getParagraphs();\n    for (let i = 0; i < paragraphs.length; i++) {\n      const paragraph = paragraphs[i]!;\n      // commentsExtended.xml entries reference the LAST paragraph's paraId\n      const isLast = i === paragraphs.length - 1;\n      xml += isLast && paraId ? `    <w:p w14:paraId=\"${paraId}\">\\n` : '    <w:p>\\n';\n      if (paragraph.pPr) {\n        xml += `      ${paragraph.pPr}\\n`;\n      }\n      for (const item of paragraph.content) {\n        if (item instanceof Run) {\n          xml += this.runToXmlString(item, 6);\n        } else {\n          // Preserved inline XML (e.g. w:hyperlink) re-emitted verbatim so\n          // its r:id target keeps pointing at word/_rels/comments.xml.rels\n          xml += `      ${item.rawXml}\\n`;\n        }\n      }\n      xml += '    </w:p>\\n';\n    }\n\n    xml += '  </w:comment>\\n';\n    return xml;\n  }\n\n  /**\n   * Converts a run to XML string\n   * @param run - Run to convert\n   * @param indent - Number of spaces for indentation\n   * @returns XML string for the run\n   */\n  private runToXmlString(run: Run, indent: number): string {\n    const spaces = ' '.repeat(indent);\n    // Serialize through Run.toXML() so w:rPr formatting and non-text\n    // content (w:annotationRef, tabs, breaks) survive regeneration\n    return `${spaces}${XMLBuilder.elementToString(run.toXML())}\\n`;\n  }\n\n  /**\n   * Creates a new CommentManager\n   * @returns New CommentManager instance\n   */\n  static create(): CommentManager {\n    return new CommentManager();\n  }\n}\n"]}