docxmlater 11.0.10 → 12.1.0

package/dist/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"]}

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

@@ -1 +1 @@
-{"version":3,"file":"EndnoteManager.d.ts","sourceRoot":"","sources":["../../src/elements/EndnoteManager.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAe,MAAM,cAAc,CAAC;AAOpD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,MAAM,CAAK;IAMnB,OAAO;IASP,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,gBAAgB;IAYxB,MAAM,CAAC,MAAM,IAAI,cAAc;IAS/B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAuBnC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAWpC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAQ3C,cAAc,IAAI,OAAO,EAAE;IAS3B,yBAAyB,IAAI,OAAO,EAAE;IAQtC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAS/B,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAWlC,SAAS,IAAI,MAAM;IAOnB,QAAQ,IAAI,MAAM;IAOlB,OAAO,IAAI,OAAO;IAQlB,KAAK,IAAI,IAAI;IAqBb,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB;IAUD,mBAAmB,IAAI,MAAM;IAwB7B,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAkBtC"}
+{"version":3,"file":"EndnoteManager.d.ts","sourceRoot":"","sources":["../../src/elements/EndnoteManager.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAe,MAAM,cAAc,CAAC;AAOpD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,MAAM,CAAK;IAMnB,OAAO;IASP,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,gBAAgB;IAYxB,MAAM,CAAC,MAAM,IAAI,cAAc;IAS/B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAuBnC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAWpC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAQ3C,cAAc,IAAI,OAAO,EAAE;IAS3B,yBAAyB,IAAI,OAAO,EAAE;IAQtC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAY/B,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAWlC,SAAS,IAAI,MAAM;IAOnB,QAAQ,IAAI,MAAM;IAOlB,OAAO,IAAI,OAAO;IAQlB,KAAK,IAAI,IAAI;IAqBb,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB;IAUD,mBAAmB,IAAI,MAAM;IAwB7B,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAkBtC"}

package/dist/elements/EndnoteManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"EndnoteManager.js","sourceRoot":"","sources":["../../src/elements/EndnoteManager.ts"],"names":[],"mappings":";;;AAOA,6CAAoD;AACpD,wDAA8D;AAC9D,sDAAgD;AAKhD,MAAa,cAAc;IACjB,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IACtC,MAAM,GAAG,CAAC,CAAC;IAMnB;QAEE,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;IAMO,kBAAkB;QAExB,MAAM,SAAS,GAAG,oBAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAGjC,MAAM,eAAe,GAAG,oBAAO,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IACxC,CAAC;IAQO,gBAAgB,CAAC,OAAgB;QACvC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAC/B,OAAO,CACL,IAAI,KAAK,wBAAW,CAAC,SAAS;YAC9B,IAAI,KAAK,wBAAW,CAAC,qBAAqB;YAC1C,IAAI,KAAK,wBAAW,CAAC,kBAAkB,CACxC,CAAC;IACJ,CAAC;IAKD,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,cAAc,EAAE,CAAC;IAC9B,CAAC;IAOD,QAAQ,CAAC,OAAgB;QACvB,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QAG3B,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAG/B,IAAI,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAOD,aAAa,CAAC,IAAY;QACxB,MAAM,OAAO,GAAG,oBAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,OAAO,CAAC;IACjB,CAAC;IAOD,UAAU,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAMD,cAAc;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;aACtC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;aACxC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3C,CAAC;IAKD,yBAAyB;QACvB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAClF,CAAC;IAMD,UAAU,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAOD,aAAa,CAAC,EAAU;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAKD,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAKD,QAAQ;QACN,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC;IACtC,CAAC;IAKD,OAAO;QACL,OAAO,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAMD,KAAK;QACH,MAAM,eAAe,GAAG,IAAI,GAAG,EAAmB,CAAC;QACnD,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnC,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;gBACjC,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;oBACtB,YAAY,GAAG,EAAE,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAC;QAEhC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC;IAKD,QAAQ;QAIN,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE;YACtB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;IAKD,mBAAmB;QACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAGlD,MAAM,eAAe,GAAe;YAClC,IAAI,EAAE,YAAY;YAClB,UAAU,EAAE;gBACV,SAAS,EAAE,8DAA8D;gBACzE,SAAS,EAAE,qEAAqE;aACjF;YACD,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;SACzC,CAAC;QAGF,MAAM,OAAO,GAAG,IAAI,0BAAU,EAAE,CAAC;QACjC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC5F,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAOD,MAAM,CAAC,QAAQ,CAAC,GAAW;QAEzB,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,eAAe,GAAG,wBAAS,CAAC,kBAAkB,CAAC,GAAG,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;QAC1F,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC;QACf,CAAC;QAGD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAvOD,wCAuOC","sourcesContent":["/**\n * EndnoteManager - Manages endnotes in a document\n *\n * Handles creation, registration, and XML generation for endnotes.\n * Maintains unique IDs and proper ordering.\n */\n\nimport { Endnote, EndnoteType } from './Endnote.js';\nimport { XMLBuilder, XMLElement } from '../xml/XMLBuilder.js';\nimport { XMLParser } from '../xml/XMLParser.js';\n\n/**\n * Manages endnotes in a document\n */\nexport class EndnoteManager {\n  private endnotes = new Map<number, Endnote>();\n  private nextId = 1;\n\n  /**\n   * Creates a new EndnoteManager\n   * @private Use static factory method\n   */\n  private constructor() {\n    // Add special endnotes (separators) with negative IDs\n    this.addSpecialEndnotes();\n  }\n\n  /**\n   * Adds special endnotes (separator, continuation)\n   * These use negative IDs as per OOXML specification\n   */\n  private addSpecialEndnotes(): void {\n    // Separator endnote (ID -1)\n    const separator = Endnote.createSeparator(-1);\n    this.endnotes.set(-1, separator);\n\n    // Continuation separator (ID 0)\n    const continuationSep = Endnote.createContinuationSeparator(0);\n    this.endnotes.set(0, continuationSep);\n  }\n\n  /**\n   * Checks if an endnote is a special/system type (separator, continuationSeparator,\n   * continuationNotice) that should be preserved across clear() operations.\n   * Uses type-based detection rather than ID-based, because continuationNotice\n   * has a positive ID (typically 1) but is still a system endnote.\n   */\n  private isSpecialEndnote(endnote: Endnote): boolean {\n    const type = endnote.getType();\n    return (\n      type === EndnoteType.Separator ||\n      type === EndnoteType.ContinuationSeparator ||\n      type === EndnoteType.ContinuationNotice\n    );\n  }\n\n  /**\n   * Creates a new EndnoteManager instance\n   */\n  static create(): EndnoteManager {\n    return new EndnoteManager();\n  }\n\n  /**\n   * Registers an endnote\n   * @param endnote Endnote to register\n   * @returns The registered endnote\n   */\n  register(endnote: Endnote): Endnote {\n    const id = endnote.getId();\n\n    // Ensure ID is not already used (except for special endnotes)\n    if (id > 0 && this.endnotes.has(id)) {\n      throw new Error(`Endnote with ID ${id} already exists`);\n    }\n\n    this.endnotes.set(id, endnote);\n\n    // Update next ID if needed\n    if (id >= this.nextId) {\n      this.nextId = id + 1;\n    }\n\n    return endnote;\n  }\n\n  /**\n   * Creates and registers a new endnote\n   * @param text Endnote text\n   * @returns The created endnote\n   */\n  createEndnote(text: string): Endnote {\n    const endnote = Endnote.fromText(this.nextId++, text);\n    this.endnotes.set(endnote.getId(), endnote);\n    return endnote;\n  }\n\n  /**\n   * Gets an endnote by ID\n   * @param id Endnote ID\n   * @returns The endnote, or undefined if not found\n   */\n  getEndnote(id: number): Endnote | undefined {\n    return this.endnotes.get(id);\n  }\n\n  /**\n   * Gets all user endnotes (excluding special system types: separator,\n   * continuationSeparator, continuationNotice)\n   */\n  getAllEndnotes(): Endnote[] {\n    return Array.from(this.endnotes.values())\n      .filter((e) => !this.isSpecialEndnote(e))\n      .sort((a, b) => a.getId() - b.getId());\n  }\n\n  /**\n   * Gets all endnotes including special ones\n   */\n  getAllEndnotesWithSpecial(): Endnote[] {\n    return Array.from(this.endnotes.values()).sort((a, b) => a.getId() - b.getId());\n  }\n\n  /**\n   * Checks if an endnote exists\n   * @param id Endnote ID\n   */\n  hasEndnote(id: number): boolean {\n    return this.endnotes.has(id);\n  }\n\n  /**\n   * Removes an endnote\n   * @param id Endnote ID\n   * @returns True if removed, false if not found or if it's a special type\n   */\n  removeEndnote(id: number): boolean {\n    const endnote = this.endnotes.get(id);\n    if (!endnote || this.isSpecialEndnote(endnote)) {\n      return false;\n    }\n    return this.endnotes.delete(id);\n  }\n\n  /**\n   * Gets the next available ID\n   */\n  getNextId(): number {\n    return this.nextId;\n  }\n\n  /**\n   * Gets the count of endnotes (excluding special ones)\n   */\n  getCount(): number {\n    return this.getAllEndnotes().length;\n  }\n\n  /**\n   * Checks if there are any endnotes (excluding special ones)\n   */\n  isEmpty(): boolean {\n    return this.getCount() === 0;\n  }\n\n  /**\n   * Clears all user endnotes (preserves special system types: separator,\n   * continuationSeparator, continuationNotice)\n   */\n  clear(): void {\n    const specialEndnotes = new Map<number, Endnote>();\n    let maxSpecialId = 0;\n\n    for (const [id, endnote] of this.endnotes) {\n      if (this.isSpecialEndnote(endnote)) {\n        specialEndnotes.set(id, endnote);\n        if (id > maxSpecialId) {\n          maxSpecialId = id;\n        }\n      }\n    }\n\n    this.endnotes = specialEndnotes;\n    // Ensure nextId doesn't collide with special endnotes that have positive IDs\n    this.nextId = Math.max(maxSpecialId + 1, 1);\n  }\n\n  /**\n   * Gets statistics about endnotes\n   */\n  getStats(): {\n    total: number;\n    nextId: number;\n  } {\n    return {\n      total: this.getCount(),\n      nextId: this.nextId,\n    };\n  }\n\n  /**\n   * Generates the endnotes.xml content\n   */\n  generateEndnotesXml(): string {\n    const endnotes = this.getAllEndnotesWithSpecial();\n\n    // Build endnotes element\n    const endnotesElement: XMLElement = {\n      name: 'w:endnotes',\n      attributes: {\n        'xmlns:w': 'http://schemas.openxmlformats.org/wordprocessingml/2006/main',\n        'xmlns:r': 'http://schemas.openxmlformats.org/officeDocument/2006/relationships',\n      },\n      children: endnotes.map((e) => e.toXML()),\n    };\n\n    // Build XML using XMLBuilder\n    const builder = new XMLBuilder();\n    builder.element(endnotesElement.name, endnotesElement.attributes, endnotesElement.children);\n    return builder.build(true);\n  }\n\n  /**\n   * Validates endnotes XML\n   * @param xml XML string to validate\n   * @returns True if valid\n   */\n  static validate(xml: string): boolean {\n    // Use XMLParser to extract root element\n    if (!xml) {\n      return false;\n    }\n\n    const endnotesContent = XMLParser.extractBetweenTags(xml, '<w:endnotes', '</w:endnotes>');\n    if (!endnotesContent) {\n      return false;\n    }\n\n    // Check for proper structure - namespace declaration\n    if (!xml.includes('xmlns:w=')) {\n      return false;\n    }\n\n    return true;\n  }\n}\n"]}
+{"version":3,"file":"EndnoteManager.js","sourceRoot":"","sources":["../../src/elements/EndnoteManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * EndnoteManager - Manages endnotes in a document\n *\n * Handles creation, registration, and XML generation for endnotes.\n * Maintains unique IDs and proper ordering.\n */\n\nimport { Endnote, EndnoteType } from './Endnote.js';\nimport { XMLBuilder, XMLElement } from '../xml/XMLBuilder.js';\nimport { XMLParser } from '../xml/XMLParser.js';\n\n/**\n * Manages endnotes in a document\n */\nexport class EndnoteManager {\n  private endnotes = new Map<number, Endnote>();\n  private nextId = 1;\n\n  /**\n   * Creates a new EndnoteManager\n   * @private Use static factory method\n   */\n  private constructor() {\n    // Add special endnotes (separators) with negative IDs\n    this.addSpecialEndnotes();\n  }\n\n  /**\n   * Adds special endnotes (separator, continuation)\n   * These use negative IDs as per OOXML specification\n   */\n  private addSpecialEndnotes(): void {\n    // Separator endnote (ID -1)\n    const separator = Endnote.createSeparator(-1);\n    this.endnotes.set(-1, separator);\n\n    // Continuation separator (ID 0)\n    const continuationSep = Endnote.createContinuationSeparator(0);\n    this.endnotes.set(0, continuationSep);\n  }\n\n  /**\n   * Checks if an endnote is a special/system type (separator, continuationSeparator,\n   * continuationNotice) that should be preserved across clear() operations.\n   * Uses type-based detection rather than ID-based, because continuationNotice\n   * has a positive ID (typically 1) but is still a system endnote.\n   */\n  private isSpecialEndnote(endnote: Endnote): boolean {\n    const type = endnote.getType();\n    return (\n      type === EndnoteType.Separator ||\n      type === EndnoteType.ContinuationSeparator ||\n      type === EndnoteType.ContinuationNotice\n    );\n  }\n\n  /**\n   * Creates a new EndnoteManager instance\n   */\n  static create(): EndnoteManager {\n    return new EndnoteManager();\n  }\n\n  /**\n   * Registers an endnote\n   * @param endnote Endnote to register\n   * @returns The registered endnote\n   */\n  register(endnote: Endnote): Endnote {\n    const id = endnote.getId();\n\n    // Ensure ID is not already used (except for special endnotes)\n    if (id > 0 && this.endnotes.has(id)) {\n      throw new Error(`Endnote with ID ${id} already exists`);\n    }\n\n    this.endnotes.set(id, endnote);\n\n    // Update next ID if needed\n    if (id >= this.nextId) {\n      this.nextId = id + 1;\n    }\n\n    return endnote;\n  }\n\n  /**\n   * Creates and registers a new endnote\n   * @param text Endnote text\n   * @returns The created endnote\n   */\n  createEndnote(text: string): Endnote {\n    const endnote = Endnote.fromText(this.nextId++, text);\n    this.endnotes.set(endnote.getId(), endnote);\n    return endnote;\n  }\n\n  /**\n   * Gets an endnote by ID\n   * @param id Endnote ID\n   * @returns The endnote, or undefined if not found\n   */\n  getEndnote(id: number): Endnote | undefined {\n    return this.endnotes.get(id);\n  }\n\n  /**\n   * Gets all user endnotes (excluding special system types: separator,\n   * continuationSeparator, continuationNotice)\n   */\n  getAllEndnotes(): Endnote[] {\n    return Array.from(this.endnotes.values())\n      .filter((e) => !this.isSpecialEndnote(e))\n      .sort((a, b) => a.getId() - b.getId());\n  }\n\n  /**\n   * Gets all endnotes including special ones\n   */\n  getAllEndnotesWithSpecial(): Endnote[] {\n    return Array.from(this.endnotes.values()).sort((a, b) => a.getId() - b.getId());\n  }\n\n  /**\n   * Checks if an endnote exists\n   * @param id Endnote ID\n   */\n  hasEndnote(id: number): boolean {\n    return this.endnotes.has(id);\n  }\n\n  /**\n   * Removes an endnote from the model only. Does not touch body\n   * w:endnoteReference runs or the document's dirty flags — callers going\n   * through a Document should use Document.removeEndnote(), which also\n   * strips the matching references and forces endnotes.xml regeneration.\n   * @param id Endnote ID\n   * @returns True if removed, false if not found or if it's a special type\n   */\n  removeEndnote(id: number): boolean {\n    const endnote = this.endnotes.get(id);\n    if (!endnote || this.isSpecialEndnote(endnote)) {\n      return false;\n    }\n    return this.endnotes.delete(id);\n  }\n\n  /**\n   * Gets the next available ID\n   */\n  getNextId(): number {\n    return this.nextId;\n  }\n\n  /**\n   * Gets the count of endnotes (excluding special ones)\n   */\n  getCount(): number {\n    return this.getAllEndnotes().length;\n  }\n\n  /**\n   * Checks if there are any endnotes (excluding special ones)\n   */\n  isEmpty(): boolean {\n    return this.getCount() === 0;\n  }\n\n  /**\n   * Clears all user endnotes (preserves special system types: separator,\n   * continuationSeparator, continuationNotice)\n   */\n  clear(): void {\n    const specialEndnotes = new Map<number, Endnote>();\n    let maxSpecialId = 0;\n\n    for (const [id, endnote] of this.endnotes) {\n      if (this.isSpecialEndnote(endnote)) {\n        specialEndnotes.set(id, endnote);\n        if (id > maxSpecialId) {\n          maxSpecialId = id;\n        }\n      }\n    }\n\n    this.endnotes = specialEndnotes;\n    // Ensure nextId doesn't collide with special endnotes that have positive IDs\n    this.nextId = Math.max(maxSpecialId + 1, 1);\n  }\n\n  /**\n   * Gets statistics about endnotes\n   */\n  getStats(): {\n    total: number;\n    nextId: number;\n  } {\n    return {\n      total: this.getCount(),\n      nextId: this.nextId,\n    };\n  }\n\n  /**\n   * Generates the endnotes.xml content\n   */\n  generateEndnotesXml(): string {\n    const endnotes = this.getAllEndnotesWithSpecial();\n\n    // Build endnotes element\n    const endnotesElement: XMLElement = {\n      name: 'w:endnotes',\n      attributes: {\n        'xmlns:w': 'http://schemas.openxmlformats.org/wordprocessingml/2006/main',\n        'xmlns:r': 'http://schemas.openxmlformats.org/officeDocument/2006/relationships',\n      },\n      children: endnotes.map((e) => e.toXML()),\n    };\n\n    // Build XML using XMLBuilder\n    const builder = new XMLBuilder();\n    builder.element(endnotesElement.name, endnotesElement.attributes, endnotesElement.children);\n    return builder.build(true);\n  }\n\n  /**\n   * Validates endnotes XML\n   * @param xml XML string to validate\n   * @returns True if valid\n   */\n  static validate(xml: string): boolean {\n    // Use XMLParser to extract root element\n    if (!xml) {\n      return false;\n    }\n\n    const endnotesContent = XMLParser.extractBetweenTags(xml, '<w:endnotes', '</w:endnotes>');\n    if (!endnotesContent) {\n      return false;\n    }\n\n    // Check for proper structure - namespace declaration\n    if (!xml.includes('xmlns:w=')) {\n      return false;\n    }\n\n    return true;\n  }\n}\n"]}

package/dist/elements/Field.d.ts

@@ -13,12 +13,18 @@ export interface FieldProperties {
     fldLock?: boolean;
     dirty?: boolean;
 }
+export interface CachedFieldResultRun {
+    text: string;
+    formatting?: RunFormatting;
+}
 export declare class Field {
     private type;
     private instruction;
     private formatting?;
     private fldLock?;
     private dirty?;
+    private cachedResult?;
+    private cachedResultRuns?;
     constructor(properties: FieldProperties);
     private buildInstruction;
     private isDateField;
@@ -26,6 +32,9 @@ export declare class Field {
     getInstruction(): string;
     setFormatting(formatting: RunFormatting): this;
     getFormatting(): RunFormatting | undefined;
+    setCachedResult(text: string): this;
+    setCachedResultRuns(runs: CachedFieldResultRun[]): this;
+    getCachedResult(): string | undefined;
     isHyperlinkField(): boolean;
     setColor(color: string): this;
     toXML(): XMLElement;
@@ -40,7 +49,7 @@ export declare class Field {
     static createTitle(formatting?: RunFormatting): Field;
     static createSectionPages(formatting?: RunFormatting): Field;
     static createRef(bookmark: string, format?: string, formatting?: RunFormatting): Field;
-    static createHyperlink(url: string, _displayText?: string, tooltip?: string, formatting?: RunFormatting): Field;
+    static createHyperlink(url: string, displayText?: string, tooltip?: string, formatting?: RunFormatting): Field;
     static createSeq(identifier: string, format?: string, formatting?: RunFormatting): Field;
     static createTCEntry(text: string, level?: number, formatting?: RunFormatting): Field;
     static createXEEntry(text: string, subEntry?: string, formatting?: RunFormatting): Field;

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

@@ -1 +1 @@
-{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../src/elements/Field.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EACL,0BAA0B,EAG3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAM9C,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,QAAQ,GACR,OAAO,GACP,UAAU,GACV,kBAAkB,GAClB,SAAS,GACT,UAAU,GACV,YAAY,GACZ,UAAU,GACV,WAAW,GACX,cAAc,GACd,SAAS,GACT,KAAK,GACL,WAAW,GACX,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,YAAY,GACZ,SAAS,GACT,aAAa,GACb,QAAQ,CAAC;AAKb,MAAM,WAAW,eAAe;IAE9B,IAAI,EAAE,SAAS,CAAC;IAEhB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,UAAU,CAAC,EAAE,aAAa,CAAC;IAK3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAMlB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAKD,qBAAa,KAAK;IAChB,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAgB;IACnC,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,KAAK,CAAC,CAAU;gBAMZ,UAAU,EAAE,eAAe;IAiBvC,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,WAAW;IAOnB,OAAO,IAAI,SAAS;IAOpB,cAAc,IAAI,MAAM;IAOxB,aAAa,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI;IAQ9C,aAAa,IAAI,aAAa,GAAG,SAAS;IAQ1C,gBAAgB,IAAI,OAAO;IAW3B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAc7B,KAAK,IAAI,UAAU;IA+CnB,OAAO,CAAC,kBAAkB;IAgD1B,OAAO,CAAC,mBAAmB;IAkF3B,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAW1D,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAY1D,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAarE,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAarE,MAAM,CAAC,cAAc,CAAC,WAAW,UAAQ,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAW7E,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAWtD,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAWrD,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAa5D,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAkBtF,MAAM,CAAC,eAAe,CACpB,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,MAAY,EAC1B,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,aAAa,GACzB,KAAK;IAsBR,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAwBxF,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAoBhF,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAmBxF,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAY3E,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,GAAG,KAAK;CAGlD;AAKD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,KAAK,CAAC;AAMzD,MAAM,WAAW,sBAAsB;IAErC,WAAW,EAAE,MAAM,CAAC;IAGpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,qBAAqB,CAAC,EAAE,aAAa,CAAC;IAGtC,gBAAgB,CAAC,EAAE,aAAa,CAAC;IAGjC,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAG9B,aAAa,CAAC,EAAE,UAAU,EAAE,CAAC;IAG7B,cAAc,CAAC,EAAE,OAAO,CAAC;IAGzB,eAAe,CAAC,EAAE,0BAA0B,CAAC;IAS7C,SAAS,CAAC,EAAE,OAAO,CAAC;IAGpB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAaD,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,qBAAqB,CAAC,CAAgB;IAC9C,OAAO,CAAC,gBAAgB,CAAC,CAAgB;IACzC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,eAAe,CAAC,CAA6B;IAErD,OAAO,CAAC,eAAe,CAAkB;IAKzC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,cAAc,CAAC,CAAgB;IACvC,OAAO,CAAC,eAAe,CAAC,CAA2D;gBAMvE,UAAU,EAAE,sBAAsB;IAsB9C,cAAc,IAAI,MAAM;IAOxB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQzC,gBAAgB,IAAI,aAAa,GAAG,SAAS;IAO7C,SAAS,IAAI,MAAM,GAAG,SAAS;IAO/B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAgC/B,gBAAgB,IAAI,OAAO;IAO3B,wBAAwB,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI;IAQzD,mBAAmB,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI;IASpD,kBAAkB,IAAI,0BAA0B,GAAG,SAAS;IAO5D,gBAAgB,IAAI,OAAO;IAQ3B,eAAe,IAAI,MAAM,GAAG,SAAS;IAQrC,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAQzC,eAAe,IAAI,YAAY,EAAE;IAiBjC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAYzC,mBAAmB,IAAI,MAAM;IAQ7B,iBAAiB,IAAI,IAAI;IAgBzB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQ5C,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAQ3C,gBAAgB,IAAI,UAAU,EAAE;IAQhC,mBAAmB,CAAC,OAAO,EAAE,OAAO,gCAAgC,EAAE,eAAe,GAAG,IAAI;IAS5F,qBAAqB,IAAI,MAAM;IAuB/B,OAAO,CAAC,qBAAqB;IAqB7B,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,aAAa,CAAC;QAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B,GACA,IAAI;IAiEP,OAAO,CAAC,gCAAgC;IA4BxC,iBAAiB,CAAC,cAAc,EAAE,OAAO,GAAG,IAAI;IAQhD,gBAAgB,IAAI,OAAO;IAS3B,kBAAkB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI;IAS/C,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAQ3C,kBAAkB,IAAI,QAAQ,EAAE;IAOhC,kBAAkB,IAAI,OAAO;IAQ7B,KAAK,IAAI,UAAU,EAAE;IA0GrB,OAAO,CAAC,mBAAmB;IAyE3B,OAAO,CAAC,sBAAsB;CA8I/B;AAKD,MAAM,WAAW,eAAe;IAE9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,UAAU,CAAC,EAAE,OAAO,CAAC;IAGrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAG1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAG3B,eAAe,CAAC,EAAE,OAAO,CAAC;IAG1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAaD,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,YAAY,CA0C1E"}
+{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../src/elements/Field.ts"],"names":[],"mappings":"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"}

package/dist/elements/Field.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ComplexField = exports.Field = void 0;
 exports.createTOCField = createTOCField;
+const Run_js_1 = require("./Run.js");
 const FieldHelpers_js_1 = require("./FieldHelpers.js");
 const units_js_1 = require("../utils/units.js");
 class Field {
@@ -10,6 +11,8 @@ class Field {
     formatting;
     fldLock;
     dirty;
+    cachedResult;
+    cachedResultRuns;
     constructor(properties) {
         this.type = properties.type;
         this.formatting = properties.formatting;
@@ -51,6 +54,21 @@ class Field {
     getFormatting() {
         return this.formatting;
     }
+    setCachedResult(text) {
+        this.cachedResult = text;
+        this.cachedResultRuns = undefined;
+        return this;
+    }
+    setCachedResultRuns(runs) {
+        this.cachedResultRuns = runs.length > 0 ? [...runs] : undefined;
+        return this;
+    }
+    getCachedResult() {
+        if (this.cachedResultRuns) {
+            return this.cachedResultRuns.map((run) => run.text).join('');
+        }
+        return this.cachedResult;
+    }
     isHyperlinkField() {
         return (this.type === 'HYPERLINK' || this.instruction.trim().toUpperCase().startsWith('HYPERLINK'));
     }
@@ -62,15 +80,37 @@ class Field {
         return this;
     }
     toXML() {
-        const runChildren = [];
-        if (this.formatting) {
-            runChildren.push(this.createRunProperties());
+        let resultRuns;
+        if (this.cachedResultRuns) {
+            resultRuns = this.cachedResultRuns.map((cached) => {
+                const children = [];
+                const merged = cached.formatting || this.formatting
+                    ? { ...cached.formatting, ...this.formatting }
+                    : undefined;
+                const rPr = merged ? Run_js_1.Run.generateRunPropertiesXML(merged) : null;
+                if (rPr) {
+                    children.push(rPr);
+                }
+                children.push({
+                    name: 'w:t',
+                    attributes: { 'xml:space': 'preserve' },
+                    children: [cached.text],
+                });
+                return { name: 'w:r', children };
+            });
+        }
+        else {
+            const runChildren = [];
+            if (this.formatting) {
+                runChildren.push(this.createRunProperties());
+            }
+            runChildren.push({
+                name: 'w:t',
+                attributes: { 'xml:space': 'preserve' },
+                children: [this.cachedResult ?? this.getPlaceholderText()],
+            });
+            resultRuns = [{ name: 'w:r', children: runChildren }];
         }
-        runChildren.push({
-            name: 'w:t',
-            attributes: { 'xml:space': 'preserve' },
-            children: [this.getPlaceholderText()],
-        });
         const fldSimpleAttrs = {
             'w:instr': this.instruction,
         };
@@ -83,12 +123,7 @@ class Field {
         return {
             name: 'w:fldSimple',
             attributes: fldSimpleAttrs,
-            children: [
-                {
-                    name: 'w:r',
-                    children: runChildren,
-                },
-            ],
+            children: resultRuns,
         };
     }
     getPlaceholderText() {
@@ -257,17 +292,19 @@ class Field {
             formatting,
         });
     }
-    static createHyperlink(url, _displayText = url, tooltip, formatting) {
-        let instruction = `HYPERLINK "${url}"`;
+    static createHyperlink(url, displayText = url, tooltip, formatting) {
+        let instruction = `HYPERLINK "${(0, FieldHelpers_js_1.escapeFieldArgument)(url)}"`;
         if (tooltip) {
-            instruction += ` \\o "${tooltip}"`;
+            instruction += ` \\o "${(0, FieldHelpers_js_1.escapeFieldArgument)(tooltip)}"`;
         }
         instruction += ' \\* MERGEFORMAT';
-        return new Field({
+        const field = new Field({
             type: 'HYPERLINK',
             instruction,
             formatting,
         });
+        field.cachedResult = displayText;
+        return field;
     }
     static createSeq(identifier, format, formatting) {
         let instruction = `SEQ ${identifier}`;
@@ -288,7 +325,7 @@ class Field {
         if (level < 1 || level > 9) {
             throw new Error('TC level must be between 1 and 9');
         }
-        const instruction = `TC "${text}" \\f C \\l ${level}`;
+        const instruction = `TC "${(0, FieldHelpers_js_1.escapeFieldArgument)(text)}" \\f C \\l ${level}`;
         return new Field({
             type: 'TC',
             instruction,
@@ -296,10 +333,9 @@ class Field {
         });
     }
     static createXEEntry(text, subEntry, formatting) {
-        let instruction = `XE "${text}"`;
-        if (subEntry) {
-            instruction += `:${subEntry}`;
-        }
+        const instruction = subEntry
+            ? `XE "${(0, FieldHelpers_js_1.escapeFieldArgument)(text)}:${(0, FieldHelpers_js_1.escapeFieldArgument)(subEntry)}"`
+            : `XE "${(0, FieldHelpers_js_1.escapeFieldArgument)(text)}"`;
         return new Field({
             type: 'XE',
             instruction,
@@ -308,7 +344,7 @@ class Field {
     }
     static createCustom(instruction, formatting) {
         return new Field({
-            type: 'PAGE',
+            type: 'CUSTOM',
             instruction,
             formatting,
         });
@@ -579,16 +615,22 @@ class ComplexField {
         for (const nestedField of this.nestedFields) {
             runs.push(...nestedField.toXML());
         }
-        runs.push({
-            name: 'w:r',
-            children: [
-                {
-                    name: 'w:fldChar',
-                    attributes: { 'w:fldCharType': 'separate' },
-                    selfClosing: true,
-                },
-            ],
-        });
+        const emitsResultSection = this._hasResultSection ||
+            !!this.result ||
+            this.resultContent.length > 0 ||
+            this.resultRevisions.length > 0;
+        if (emitsResultSection) {
+            runs.push({
+                name: 'w:r',
+                children: [
+                    {
+                        name: 'w:fldChar',
+                        attributes: { 'w:fldCharType': 'separate' },
+                        selfClosing: true,
+                    },
+                ],
+            });
+        }
         if (this.resultContent.length > 0) {
             runs.push(...this.resultContent);
         }