docxmlater 11.0.9 → 12.0.1

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

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

package/dist/core/RelationshipManager.js

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

package/dist/core/RelationshipManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"RelationshipManager.js","sourceRoot":"","sources":["../../src/core/RelationshipManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\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/elements/Comment.d.ts

@@ -1,5 +1,14 @@
 import { Run } from './Run.js';
 import { XMLElement } from '../xml/XMLBuilder.js';
+export interface CommentPreservedContent {
+    rawXml: string;
+    runs: Run[];
+}
+export type CommentContentItem = Run | CommentPreservedContent;
+export interface CommentParagraph {
+    pPr?: string;
+    content: CommentContentItem[];
+}
 export interface CommentProperties {
     id?: number;
     author: string;
@@ -14,13 +23,16 @@ export declare class Comment {
     private author;
     private initials;
     private date;
-    private runs;
+    private paragraphs;
     private parentId?;
     private done;
+    private onModified;
     constructor(properties: CommentProperties);
     private generateInitials;
     getId(): number;
     setId(id: number): void;
+    setModifiedCallback(callback: () => void): void;
+    private notifyModified;
     getAuthor(): string;
     setAuthor(author: string): this;
     getInitials(): string;
@@ -34,6 +46,8 @@ export declare class Comment {
     unresolve(): this;
     getRuns(): Run[];
     addRun(run: Run): this;
+    getParagraphs(): CommentParagraph[];
+    setParagraphs(paragraphs: CommentParagraph[]): void;
     getText(): string;
     getContent(): string;
     private formatDate;

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

@@ -1 +1 @@
-{"version":3,"file":"Comment.d.ts","sourceRoot":"","sources":["../../src/elements/Comment.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAMlD,MAAM,WAAW,iBAAiB;IAEhC,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,MAAM,EAAE,MAAM,CAAC;IAEf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;IAE9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAKD,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,IAAI,CAAU;gBAMV,UAAU,EAAE,iBAAiB;IAsBzC,OAAO,CAAC,gBAAgB;IAmBxB,KAAK,IAAI,MAAM;IAQf,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOvB,SAAS,IAAI,MAAM;IAOnB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ/B,WAAW,IAAI,MAAM;IAOrB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQnC,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAQzB,WAAW,IAAI,MAAM,GAAG,SAAS;IAOjC,OAAO,IAAI,OAAO;IAQlB,UAAU,IAAI,OAAO;IAQrB,OAAO,IAAI,IAAI;IASf,SAAS,IAAI,IAAI;IAQjB,OAAO,IAAI,GAAG,EAAE;IAOhB,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAQtB,OAAO,IAAI,MAAM;IAOjB,UAAU,IAAI,MAAM;IAQpB,OAAO,CAAC,UAAU;IAQlB,eAAe,IAAI,UAAU;IAc7B,aAAa,IAAI,UAAU;IAc3B,cAAc,IAAI,UAAU;IAmB5B,KAAK,IAAI,UAAU;IAsCnB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAgBxF,MAAM,CAAC,WAAW,CAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO;IAgBV,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;CAOhF"}
+{"version":3,"file":"Comment.d.ts","sourceRoot":"","sources":["../../src/elements/Comment.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AASlD,MAAM,WAAW,uBAAuB;IAEtC,MAAM,EAAE,MAAM,CAAC;IAEf,IAAI,EAAE,GAAG,EAAE,CAAC;CACb;AAGD,MAAM,MAAM,kBAAkB,GAAG,GAAG,GAAG,uBAAuB,CAAC;AAO/D,MAAM,WAAW,gBAAgB;IAE/B,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAKD,MAAM,WAAW,iBAAiB;IAEhC,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,MAAM,EAAE,MAAM,CAAC;IAEf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;IAE9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAKD,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,IAAI,CAAU;IACtB,OAAO,CAAC,UAAU,CAA6B;gBAMnC,UAAU,EAAE,iBAAiB;IAwBzC,OAAO,CAAC,gBAAgB;IAmBxB,KAAK,IAAI,MAAM;IAQf,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAWvB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAI/C,OAAO,CAAC,cAAc;IAStB,SAAS,IAAI,MAAM;IAOnB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAS/B,WAAW,IAAI,MAAM;IAOrB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IASnC,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IASzB,WAAW,IAAI,MAAM,GAAG,SAAS;IAOjC,OAAO,IAAI,OAAO;IAQlB,UAAU,IAAI,OAAO;IAQrB,OAAO,IAAI,IAAI;IAUf,SAAS,IAAI,IAAI;IAUjB,OAAO,IAAI,GAAG,EAAE;IAiBhB,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IActB,aAAa,IAAI,gBAAgB,EAAE;IAcnC,aAAa,CAAC,UAAU,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAOnD,OAAO,IAAI,MAAM;IASjB,UAAU,IAAI,MAAM;IAQpB,OAAO,CAAC,UAAU;IAQlB,eAAe,IAAI,UAAU;IAc7B,aAAa,IAAI,UAAU;IAc3B,cAAc,IAAI,UAAU;IAmB5B,KAAK,IAAI,UAAU;IAkDnB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAgBxF,MAAM,CAAC,WAAW,CAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO;IAgBV,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;CAOhF"}

package/dist/elements/Comment.js

@@ -8,9 +8,10 @@ class Comment {
     author;
     initials;
     date;
-    runs;
+    paragraphs;
     parentId;
     done;
+    onModified = null;
     constructor(properties) {
         this.id = properties.id ?? 0;
         this.author = properties.author;
@@ -18,15 +19,17 @@ 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_js_1.Run(properties.content)];
+            runs = [new Run_js_1.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
@@ -49,11 +52,20 @@ 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() {
@@ -61,6 +73,7 @@ class Comment {
     }
     setInitials(initials) {
         this.initials = initials;
+        this.notifyModified();
         return this;
     }
     getDate() {
@@ -68,6 +81,7 @@ class Comment {
     }
     setDate(date) {
         this.date = date;
+        this.notifyModified();
         return this;
     }
     getParentId() {
@@ -81,21 +95,51 @@ 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_js_1.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();
@@ -148,14 +192,25 @@ 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_js_1.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/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/elements/CommentManager.d.ts

@@ -7,7 +7,9 @@ export declare class CommentManager {
     private nextId;
     private idProvider;
     private idExistsNotifier;
+    private modifiedNotifier;
     setIdProvider(provider: IdProviderCallback, existsNotifier?: IdExistsCallback): void;
+    setModifiedNotifier(notifier: () => void): void;
     register(comment: Comment): Comment;
     registerExisting(comment: Comment): void;
     linkReplies(): void;
@@ -45,6 +47,8 @@ export declare class CommentManager {
         nextId: number;
     };
     generateCommentsXml(): string;
+    static commentParaId(commentId: number): string;
+    generateCommentsExtendedXml(): string | null;
     private commentToXmlString;
     private runToXmlString;
     static create(): CommentManager;

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

@@ -1 +1 @@
-{"version":3,"file":"CommentManager.d.ts","sourceRoot":"","sources":["../../src/elements/CommentManager.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAQ/B,MAAM,MAAM,kBAAkB,GAAG,MAAM,MAAM,CAAC;AAM9C,MAAM,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;AAc5D,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,gBAAgB,CAAiC;IAUzD,aAAa,CAAC,QAAQ,EAAE,kBAAkB,EAAE,cAAc,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAWpF,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IA6BnC,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IA0BxC,WAAW,IAAI,IAAI;IAqBnB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAQ3C,cAAc,IAAI,OAAO,EAAE;IAU3B,yBAAyB,IAAI,OAAO,EAAE;IAStC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE;IAUxC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAStC,QAAQ,IAAI,MAAM;IAQlB,gBAAgB,IAAI,MAAM;IAQ1B,UAAU,IAAI,MAAM,EAAE;IAatB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE;IAY9C,sBAAsB,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,EAAE;IAejE,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAkBlC,KAAK,IAAI,IAAI;IAUb,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAW3B,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAcxF,WAAW,CACT,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO;IAgBV,OAAO,IAAI,OAAO;IASlB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,EAAE,CAAA;KAAE,GAAG,SAAS;IAgBzF,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,EAAE;IAWjD,mBAAmB,IAAI,OAAO,EAAE;IAUhC,qBAAqB,IAAI,OAAO,EAAE;IAWlC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE;IAW3C,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB;IAkBD,mBAAmB,IAAI,MAAM;IAoC7B,OAAO,CAAC,kBAAkB;IAkC1B,OAAO,CAAC,cAAc;IAetB,MAAM,CAAC,MAAM,IAAI,cAAc;CAGhC"}
+{"version":3,"file":"CommentManager.d.ts","sourceRoot":"","sources":["../../src/elements/CommentManager.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAQ/B,MAAM,MAAM,kBAAkB,GAAG,MAAM,MAAM,CAAC;AAM9C,MAAM,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;AAc5D,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,gBAAgB,CAA6B;IAUrD,aAAa,CAAC,QAAQ,EAAE,kBAAkB,EAAE,cAAc,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAapF,mBAAmB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAa/C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAiCnC,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IA8BxC,WAAW,IAAI,IAAI;IAqBnB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAQ3C,cAAc,IAAI,OAAO,EAAE;IAU3B,yBAAyB,IAAI,OAAO,EAAE;IAStC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE;IAUxC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAStC,QAAQ,IAAI,MAAM;IAQlB,gBAAgB,IAAI,MAAM;IAQ1B,UAAU,IAAI,MAAM,EAAE;IAatB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE;IAY9C,sBAAsB,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,EAAE;IAejE,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IA4BlC,KAAK,IAAI,IAAI;IAUb,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAW3B,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAcxF,WAAW,CACT,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO;IAgBV,OAAO,IAAI,OAAO;IASlB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,EAAE,CAAA;KAAE,GAAG,SAAS;IAgBzF,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,EAAE;IAWjD,mBAAmB,IAAI,OAAO,EAAE;IAUhC,qBAAqB,IAAI,OAAO,EAAE;IAWlC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE;IAW3C,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB;IAkBD,mBAAmB,IAAI,MAAM;IAqD7B,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAU/C,2BAA2B,IAAI,MAAM,GAAG,IAAI;IA8B5C,OAAO,CAAC,kBAAkB;IA8C1B,OAAO,CAAC,cAAc;IAWtB,MAAM,CAAC,MAAM,IAAI,cAAc;CAGhC"}

package/dist/elements/CommentManager.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CommentManager = void 0;
 const Comment_js_1 = require("./Comment.js");
+const Run_js_1 = require("./Run.js");
 const XMLBuilder_js_1 = require("../xml/XMLBuilder.js");
 const dateFormatting_js_1 = require("../utils/dateFormatting.js");
 class CommentManager {
@@ -9,13 +10,23 @@ 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: [],
@@ -34,6 +45,9 @@ class CommentManager {
         if (this.idExistsNotifier) {
             this.idExistsNotifier(id);
         }
+        if (this.modifiedNotifier) {
+            comment.setModifiedCallback(this.modifiedNotifier);
+        }
         const entry = {
             comment,
             replies: [],
@@ -110,6 +124,13 @@ 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() {
@@ -186,22 +207,53 @@ 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_js_1.XMLBuilder.escapeXmlAttribute(comment.getAuthor())}"`;
         xml += ` w:date="${(0, dateFormatting_js_1.formatDateForXml)(comment.getDate())}"`;
@@ -209,25 +261,31 @@ 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_js_1.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_js_1.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_js_1.XMLBuilder.elementToString(run.toXML())}\n`;
     }
     static create() {
         return new CommentManager();