docxmlater 10.4.0 → 11.0.4

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

@@ -0,0 +1 @@
+{"version":3,"file":"Field.js","sourceRoot":"","sources":["../../../src/elements/Field.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Field - Represents a dynamic field in a Word document\n *\n * Fields are used for dynamic content like page numbers, dates, document properties, etc.\n * They are represented using the <w:fldSimple> element with field codes.\n */\n\nimport { XMLElement } from '../xml/XMLBuilder.js';\nimport { RunFormatting, FormFieldData } from './Run.js';\nimport {\n  ParsedHyperlinkInstruction,\n  parseHyperlinkInstruction,\n  isHyperlinkInstruction,\n} from './FieldHelpers.js';\nimport type { Revision } from './Revision.js';\nimport { pointsToHalfPoints } from '../utils/units.js';\n\n/**\n * Common field types\n */\nexport type FieldType =\n  | 'PAGE' // Current page number\n  | 'NUMPAGES' // Total number of pages\n  | 'DATE' // Current date\n  | 'TIME' // Current time\n  | 'AUTHOR' // Document author\n  | 'TITLE' // Document title\n  | 'FILENAME' // Document filename\n  | 'FILENAMEWITHPATH' // Document filename with path\n  | 'SUBJECT' // Document subject\n  | 'KEYWORDS' // Document keywords\n  | 'CREATEDATE' // Document creation date\n  | 'SAVEDATE' // Last save date\n  | 'PRINTDATE' // Last print date\n  | 'SECTIONPAGES' // Pages in current section\n  | 'SECTION' // Current section number\n  | 'REF' // Cross-reference to bookmark\n  | 'HYPERLINK' // Hyperlink field\n  | 'SEQ' // Sequence numbering\n  | 'TC' // Table of contents entry\n  | 'XE' // Index entry\n  | 'IF' // Conditional field\n  | 'MERGEFIELD' // Mail merge field\n  | 'INCLUDE' // Include text from external file\n  | 'INCLUDETEXT' // Include text from external file (alias)\n  | 'CUSTOM'; // Custom field type for unknown/specialized fields\n\n/**\n * Field properties\n */\nexport interface FieldProperties {\n  /** Field type */\n  type: FieldType;\n  /** Field instruction (e.g., 'PAGE \\* MERGEFORMAT') */\n  instruction?: string;\n  /** Format switches (e.g., '\\\\* MERGEFORMAT') */\n  format?: string;\n  /** Date/time format (e.g., 'MMMM d, yyyy') */\n  dateFormat?: string;\n  /** Preserve formatting during updates */\n  preserveFormatting?: boolean;\n  /** Run formatting for field result */\n  formatting?: RunFormatting;\n  /**\n   * `<w:fldSimple w:fldLock=\"…\">` — CT_OnOff per ECMA-376 §17.16.16.\n   * When true, the field is locked against automatic updates.\n   */\n  fldLock?: boolean;\n  /**\n   * `<w:fldSimple w:dirty=\"…\">` — CT_OnOff per ECMA-376 §17.16.16.\n   * When true, the field's cached result is out of date and Word should\n   * refresh it at open-time.\n   */\n  dirty?: boolean;\n}\n\n/**\n * Represents a dynamic field\n */\nexport class Field {\n  private type: FieldType;\n  private instruction: string;\n  private formatting?: RunFormatting;\n  private fldLock?: boolean;\n  private dirty?: boolean;\n\n  /**\n   * Creates a new field\n   * @param properties Field properties\n   */\n  constructor(properties: FieldProperties) {\n    this.type = properties.type;\n    this.formatting = properties.formatting;\n    this.fldLock = properties.fldLock;\n    this.dirty = properties.dirty;\n\n    // Build field instruction\n    if (properties.instruction) {\n      this.instruction = properties.instruction;\n    } else {\n      this.instruction = this.buildInstruction(properties);\n    }\n  }\n\n  /**\n   * Builds field instruction from properties\n   */\n  private buildInstruction(properties: FieldProperties): string {\n    let instruction = properties.type;\n\n    // Add date format for date/time fields\n    if (properties.dateFormat && this.isDateField(properties.type)) {\n      instruction += ` \\\\@ \"${properties.dateFormat}\"`;\n    }\n\n    // Add format switch\n    if (properties.format) {\n      instruction += ` ${properties.format}`;\n    } else if (properties.preserveFormatting !== false) {\n      // Add MERGEFORMAT by default to preserve formatting\n      instruction += ' \\\\* MERGEFORMAT';\n    }\n\n    return instruction;\n  }\n\n  /**\n   * Checks if field type is a date field\n   */\n  private isDateField(type: FieldType): boolean {\n    return ['DATE', 'TIME', 'CREATEDATE', 'SAVEDATE', 'PRINTDATE'].includes(type);\n  }\n\n  /**\n   * Gets the field type\n   */\n  getType(): FieldType {\n    return this.type;\n  }\n\n  /**\n   * Gets the field instruction\n   */\n  getInstruction(): string {\n    return this.instruction;\n  }\n\n  /**\n   * Sets run formatting for the field\n   */\n  setFormatting(formatting: RunFormatting): this {\n    this.formatting = formatting;\n    return this;\n  }\n\n  /**\n   * Gets run formatting\n   */\n  getFormatting(): RunFormatting | undefined {\n    return this.formatting;\n  }\n\n  /**\n   * Checks if this field is a HYPERLINK field\n   * @returns True if the field type is HYPERLINK or instruction starts with HYPERLINK\n   */\n  isHyperlinkField(): boolean {\n    return (\n      this.type === 'HYPERLINK' || this.instruction.trim().toUpperCase().startsWith('HYPERLINK')\n    );\n  }\n\n  /**\n   * Sets text color for the field\n   * @param color Color in hex format (e.g., '0000FF')\n   * @returns This field for chaining\n   */\n  setColor(color: string): this {\n    if (!this.formatting) {\n      this.formatting = {};\n    }\n    this.formatting.color = color.replace('#', '');\n    return this;\n  }\n\n  /**\n   * Generates XML for the field.\n   * Per ECMA-376, w:fldSimple is a paragraph-level element that CONTAINS w:r children.\n   * Structure: <w:fldSimple w:instr=\"...\"><w:r><w:rPr/><w:t>...</w:t></w:r></w:fldSimple>\n   * The fldSimple element should be added directly to paragraph children (not wrapped in w:r).\n   */\n  toXML(): XMLElement {\n    // Build the inner run with optional formatting\n    const runChildren: XMLElement[] = [];\n    if (this.formatting) {\n      runChildren.push(this.createRunProperties());\n    }\n    // Per ECMA-376 §22.1.2.33 CT_Text, `xml:space=\"preserve\"` is the\n    // standard sentinel that stops XML processors from collapsing leading /\n    // trailing whitespace in the text content. Run.ts always emits it;\n    // emit it here too so field placeholders with spaces (e.g. localized\n    // date formats like \"1 Jan 2026\") survive XML round-trip intact.\n    runChildren.push({\n      name: 'w:t',\n      attributes: { 'xml:space': 'preserve' },\n      children: [this.getPlaceholderText()],\n    });\n\n    // CT_SimpleField (§17.16.16) carries two ST_OnOff attributes beyond\n    // the required w:instr: w:fldLock (locked against updates) and\n    // w:dirty (cached result out of date). Emit when the caller set\n    // them so Word-authored fldSimple documents round-trip their\n    // lock/dirty state instead of silently clearing it.\n    const fldSimpleAttrs: Record<string, string> = {\n      'w:instr': this.instruction,\n    };\n    if (this.fldLock !== undefined) {\n      fldSimpleAttrs['w:fldLock'] = this.fldLock ? '1' : '0';\n    }\n    if (this.dirty !== undefined) {\n      fldSimpleAttrs['w:dirty'] = this.dirty ? '1' : '0';\n    }\n\n    return {\n      name: 'w:fldSimple',\n      attributes: fldSimpleAttrs,\n      children: [\n        {\n          name: 'w:r',\n          children: runChildren,\n        },\n      ],\n    };\n  }\n\n  /**\n   * Gets placeholder text for the field\n   */\n  private getPlaceholderText(): string {\n    switch (this.type) {\n      case 'PAGE':\n        return '1';\n      case 'NUMPAGES':\n        return '1';\n      case 'SECTIONPAGES':\n        return '1';\n      case 'SECTION':\n        return '1';\n      case 'DATE':\n        return new Date().toLocaleDateString();\n      case 'TIME':\n        return new Date().toLocaleTimeString();\n      case 'CREATEDATE':\n      case 'SAVEDATE':\n      case 'PRINTDATE':\n        return new Date().toLocaleDateString();\n      case 'FILENAME':\n        return 'Document';\n      case 'FILENAMEWITHPATH':\n        return 'C:\\\\Document.docx';\n      case 'AUTHOR':\n        return 'Author';\n      case 'TITLE':\n        return 'Title';\n      case 'SUBJECT':\n        return 'Subject';\n      case 'KEYWORDS':\n        return 'Keywords';\n      case 'REF':\n        return '1'; // Reference typically shows page number or heading text\n      case 'HYPERLINK':\n        return 'Link'; // Hyperlink displays the link text\n      case 'SEQ':\n        return '1'; // Sequence shows the current number\n      case 'TC':\n        return ''; // TC fields are hidden\n      case 'XE':\n        return ''; // XE fields are hidden\n      default:\n        return '';\n    }\n  }\n\n  /**\n   * Creates run properties XML\n   */\n  private createRunProperties(): XMLElement {\n    const children: XMLElement[] = [];\n\n    if (!this.formatting) {\n      return { name: 'w:rPr', children };\n    }\n\n    // Per ECMA-376 CT_RPr ordering:\n    // rFonts → b → i → strike → color → sz/szCs → highlight → u\n\n    if (this.formatting.font) {\n      children.push({\n        name: 'w:rFonts',\n        attributes: {\n          'w:ascii': this.formatting.font,\n          'w:hAnsi': this.formatting.font,\n          'w:cs': this.formatting.font,\n        },\n        selfClosing: true,\n      });\n    }\n\n    if (this.formatting.bold) {\n      children.push({ name: 'w:b', selfClosing: true });\n    }\n\n    if (this.formatting.italic) {\n      children.push({ name: 'w:i', selfClosing: true });\n    }\n\n    if (this.formatting.strike) {\n      children.push({ name: 'w:strike', selfClosing: true });\n    }\n\n    if (this.formatting.color) {\n      const color = this.formatting.color.replace('#', '');\n      children.push({\n        name: 'w:color',\n        attributes: { 'w:val': color },\n        selfClosing: true,\n      });\n    }\n\n    if (this.formatting.size) {\n      const sizeValue = pointsToHalfPoints(this.formatting.size).toString();\n      children.push({\n        name: 'w:sz',\n        attributes: { 'w:val': sizeValue },\n        selfClosing: true,\n      });\n      children.push({\n        name: 'w:szCs',\n        attributes: { 'w:val': sizeValue },\n        selfClosing: true,\n      });\n    }\n\n    if (this.formatting.highlight) {\n      children.push({\n        name: 'w:highlight',\n        attributes: { 'w:val': this.formatting.highlight },\n        selfClosing: true,\n      });\n    }\n\n    if (this.formatting.underline) {\n      const val =\n        typeof this.formatting.underline === 'string' ? this.formatting.underline : 'single';\n      children.push({\n        name: 'w:u',\n        attributes: { 'w:val': val },\n        selfClosing: true,\n      });\n    }\n\n    return { name: 'w:rPr', children };\n  }\n\n  /**\n   * Creates a page number field\n   * @param formatting Optional run formatting\n   */\n  static createPageNumber(formatting?: RunFormatting): Field {\n    return new Field({\n      type: 'PAGE',\n      formatting,\n    });\n  }\n\n  /**\n   * Creates a total pages field\n   * @param formatting Optional run formatting\n   */\n  static createTotalPages(formatting?: RunFormatting): Field {\n    return new Field({\n      type: 'NUMPAGES',\n      formatting,\n    });\n  }\n\n  /**\n   * Creates a date field\n   * @param format Date format (e.g., 'MMMM d, yyyy')\n   * @param formatting Optional run formatting\n   */\n  static createDate(format?: string, formatting?: RunFormatting): Field {\n    return new Field({\n      type: 'DATE',\n      dateFormat: format,\n      formatting,\n    });\n  }\n\n  /**\n   * Creates a time field\n   * @param format Time format\n   * @param formatting Optional run formatting\n   */\n  static createTime(format?: string, formatting?: RunFormatting): Field {\n    return new Field({\n      type: 'TIME',\n      dateFormat: format,\n      formatting,\n    });\n  }\n\n  /**\n   * Creates a filename field\n   * @param includePath Whether to include full path\n   * @param formatting Optional run formatting\n   */\n  static createFilename(includePath = false, formatting?: RunFormatting): Field {\n    return new Field({\n      type: includePath ? 'FILENAMEWITHPATH' : 'FILENAME',\n      formatting,\n    });\n  }\n\n  /**\n   * Creates an author field\n   * @param formatting Optional run formatting\n   */\n  static createAuthor(formatting?: RunFormatting): Field {\n    return new Field({\n      type: 'AUTHOR',\n      formatting,\n    });\n  }\n\n  /**\n   * Creates a title field\n   * @param formatting Optional run formatting\n   */\n  static createTitle(formatting?: RunFormatting): Field {\n    return new Field({\n      type: 'TITLE',\n      formatting,\n    });\n  }\n\n  /**\n   * Creates a section pages field (pages in current section)\n   * @param formatting Optional run formatting\n   */\n  static createSectionPages(formatting?: RunFormatting): Field {\n    return new Field({\n      type: 'SECTIONPAGES',\n      formatting,\n    });\n  }\n\n  /**\n   * Creates a cross-reference field\n   * @param bookmark Bookmark name to reference\n   * @param format Reference format (\\h for hyperlink, \\p for page number, etc.)\n   * @param formatting Optional run formatting\n   */\n  static createRef(bookmark: string, format?: string, formatting?: RunFormatting): Field {\n    const formatSwitch = format || '\\\\h'; // Default to hyperlink format\n    const instruction = `REF ${bookmark} ${formatSwitch} \\\\* MERGEFORMAT`;\n\n    return new Field({\n      type: 'REF',\n      instruction,\n      formatting,\n    });\n  }\n\n  /**\n   * Creates a hyperlink field\n   * @param url The URL to link to\n   * @param displayText The text to display\n   * @param tooltip Optional tooltip text\n   * @param formatting Optional run formatting\n   */\n  static createHyperlink(\n    url: string,\n    _displayText: string = url,\n    tooltip?: string,\n    formatting?: RunFormatting\n  ): Field {\n    let instruction = `HYPERLINK \"${url}\"`;\n\n    if (tooltip) {\n      instruction += ` \\\\o \"${tooltip}\"`;\n    }\n\n    instruction += ' \\\\* MERGEFORMAT';\n\n    return new Field({\n      type: 'HYPERLINK',\n      instruction,\n      formatting,\n    });\n  }\n\n  /**\n   * Creates a sequence numbering field\n   * @param identifier Sequence identifier (e.g., 'Figure', 'Table')\n   * @param format Number format (\\* ARABIC, \\* ROMAN, etc.)\n   * @param formatting Optional run formatting\n   */\n  static createSeq(identifier: string, format?: string, formatting?: RunFormatting): Field {\n    let instruction = `SEQ ${identifier}`;\n\n    if (format) {\n      instruction += ` ${format}`;\n    } else {\n      instruction += ' \\\\* ARABIC'; // Default to Arabic numerals\n    }\n\n    instruction += ' \\\\* MERGEFORMAT';\n\n    return new Field({\n      type: 'SEQ',\n      instruction,\n      formatting,\n    });\n  }\n\n  /**\n   * Creates a table of contents entry field (TC)\n   * @param text Entry text\n   * @param level TOC level (1-9)\n   * @param formatting Optional run formatting\n   */\n  static createTCEntry(text: string, level = 1, formatting?: RunFormatting): Field {\n    if (level < 1 || level > 9) {\n      throw new Error('TC level must be between 1 and 9');\n    }\n\n    const instruction = `TC \"${text}\" \\\\f C \\\\l ${level}`;\n\n    return new Field({\n      type: 'TC',\n      instruction,\n      formatting,\n    });\n  }\n\n  /**\n   * Creates an index entry field (XE)\n   * @param text Entry text\n   * @param subEntry Optional sub-entry text\n   * @param formatting Optional run formatting\n   */\n  static createXEEntry(text: string, subEntry?: string, formatting?: RunFormatting): Field {\n    let instruction = `XE \"${text}\"`;\n\n    if (subEntry) {\n      instruction += `:${subEntry}`;\n    }\n\n    return new Field({\n      type: 'XE',\n      instruction,\n      formatting,\n    });\n  }\n\n  /**\n   * Creates a custom field with instruction\n   * @param instruction Field instruction code\n   * @param formatting Optional run formatting\n   */\n  static createCustom(instruction: string, formatting?: RunFormatting): Field {\n    return new Field({\n      type: 'PAGE', // Placeholder type\n      instruction,\n      formatting,\n    });\n  }\n\n  /**\n   * Creates a field from properties\n   * @param properties Field properties\n   */\n  static create(properties: FieldProperties): Field {\n    return new Field(properties);\n  }\n}\n\n/**\n * Field character type for complex fields\n */\nexport type FieldCharType = 'begin' | 'separate' | 'end';\n\n/**\n * Complex field properties\n * Complex fields use begin/separate/end structure instead of fldSimple\n */\nexport interface ComplexFieldProperties {\n  /** Field instruction (e.g., \" TOC \\\\o \\\"1-3\\\" \\\\h \\\\z \\\\u \") */\n  instruction: string;\n\n  /** Current field result text (optional) */\n  result?: string;\n\n  /** Run formatting for instruction */\n  instructionFormatting?: RunFormatting;\n\n  /** Run formatting for result */\n  resultFormatting?: RunFormatting;\n\n  /** Nested fields to include within this field */\n  nestedFields?: ComplexField[];\n\n  /** Custom XML content for result section */\n  resultContent?: XMLElement[];\n\n  /** Whether field spans multiple paragraphs */\n  multiParagraph?: boolean;\n\n  /** Parsed HYPERLINK instruction components (auto-populated if instruction is HYPERLINK) */\n  parsedHyperlink?: ParsedHyperlinkInstruction;\n\n  /**\n   * Whether the field has a result section (w:fldSep was present during parsing)\n   * Per ECMA-376, fields without results skip the separator element.\n   * This flag distinguishes between:\n   * - hasResult=true, result=\"\" → Field had separator but result was empty\n   * - hasResult=false, result=\"\" → Field never had a result section (empty field)\n   */\n  hasResult?: boolean;\n\n  /** Form field data (w:ffData) from begin field char per ECMA-376 §17.16.17 */\n  formFieldData?: FormFieldData;\n}\n\n/**\n * Represents a complex field (begin/separate/end structure)\n * Used for TOC, cross-references, and other advanced fields\n *\n * Structure:\n * <w:r><w:fldChar w:fldCharType=\"begin\"/></w:r>\n * <w:r><w:instrText>INSTRUCTION</w:instrText></w:r>\n * <w:r><w:fldChar w:fldCharType=\"separate\"/></w:r>\n * <w:r><w:t>RESULT</w:t></w:r>\n * <w:r><w:fldChar w:fldCharType=\"end\"/></w:r>\n */\nexport class ComplexField {\n  private instruction: string;\n  private result?: string;\n  private instructionFormatting?: RunFormatting;\n  private resultFormatting?: RunFormatting;\n  private nestedFields: ComplexField[];\n  private resultContent: XMLElement[];\n  private multiParagraph: boolean;\n  private parsedHyperlink?: ParsedHyperlinkInstruction;\n  /** Revisions that wrap the result section (for tracked changes in field content) */\n  private resultRevisions: Revision[] = [];\n  /**\n   * Whether the field has a result section (w:fldSep was present during parsing)\n   * Per ECMA-376, fields without results skip the separator element.\n   */\n  private _hasResultSection = false;\n  private _formFieldData?: FormFieldData;\n  private trackingContext?: import('../tracking/TrackingContext.js').TrackingContext;\n\n  /**\n   * Creates a new complex field\n   * @param properties Complex field properties\n   */\n  constructor(properties: ComplexFieldProperties) {\n    this.instruction = properties.instruction;\n    this.result = properties.result;\n    this.instructionFormatting = properties.instructionFormatting;\n    this.resultFormatting = properties.resultFormatting;\n    this.nestedFields = properties.nestedFields || [];\n    this.resultContent = properties.resultContent || [];\n    this.multiParagraph = properties.multiParagraph || false;\n    this._hasResultSection = properties.hasResult ?? false;\n    this._formFieldData = properties.formFieldData;\n\n    // Auto-parse HYPERLINK instruction if provided or detected\n    if (properties.parsedHyperlink) {\n      this.parsedHyperlink = properties.parsedHyperlink;\n    } else if (isHyperlinkInstruction(this.instruction)) {\n      this.parsedHyperlink = parseHyperlinkInstruction(this.instruction) || undefined;\n    }\n  }\n\n  /**\n   * Gets the field instruction\n   */\n  getInstruction(): string {\n    return this.instruction;\n  }\n\n  /**\n   * Sets the field instruction\n   */\n  setInstruction(instruction: string): this {\n    this.instruction = instruction;\n    return this;\n  }\n\n  /**\n   * Gets form field data (w:ffData) if present\n   */\n  getFormFieldData(): FormFieldData | undefined {\n    return this._formFieldData;\n  }\n\n  /**\n   * Gets the field result text\n   */\n  getResult(): string | undefined {\n    return this.result;\n  }\n\n  /**\n   * Sets the field result text\n   */\n  setResult(result: string): this {\n    this.result = result;\n    this.resultRevisions = []; // Clear orphaned revisions from old text\n    this.resultContent = []; // Clear raw XML content since we have new text\n    return this;\n  }\n\n  /**\n   * Checks if the field has a result section\n   *\n   * Per ECMA-376, complex fields may or may not have a result section.\n   * Fields without results (like TOC markers or empty PAGE fields) skip\n   * the w:fldSep (separator) element entirely.\n   *\n   * This method distinguishes between:\n   * - `hasResultSection() === true && getResult() === \"\"` → Field had separator but result was empty\n   * - `hasResultSection() === false && getResult() === undefined` → Field never had a result section\n   *\n   * @returns True if the field has a result section (w:fldSep was present)\n   *\n   * @example\n   * ```typescript\n   * const field = paragraph.getFields()[0];\n   * if (field instanceof ComplexField) {\n   *   if (field.hasResultSection()) {\n   *     console.log('Field result:', field.getResult());\n   *   } else {\n   *     console.log('Field has no result section (empty field)');\n   *   }\n   * }\n   * ```\n   */\n  hasResultSection(): boolean {\n    return this._hasResultSection;\n  }\n\n  /**\n   * Sets instruction formatting\n   */\n  setInstructionFormatting(formatting: RunFormatting): this {\n    this.instructionFormatting = formatting;\n    return this;\n  }\n\n  /**\n   * Sets result formatting\n   */\n  setResultFormatting(formatting: RunFormatting): this {\n    this.resultFormatting = formatting;\n    return this;\n  }\n\n  /**\n   * Gets the parsed HYPERLINK instruction components\n   * Returns undefined if this is not a HYPERLINK field\n   */\n  getParsedHyperlink(): ParsedHyperlinkInstruction | undefined {\n    return this.parsedHyperlink;\n  }\n\n  /**\n   * Checks if this field is a HYPERLINK field\n   */\n  isHyperlinkField(): boolean {\n    return this.parsedHyperlink !== undefined;\n  }\n\n  /**\n   * Gets the full URL for HYPERLINK fields (combining base URL and anchor)\n   * Returns undefined if not a HYPERLINK field\n   */\n  getHyperlinkUrl(): string | undefined {\n    return this.parsedHyperlink?.fullUrl;\n  }\n\n  /**\n   * Adds a nested field within this field\n   * Nested fields appear between instruction and separator\n   */\n  addNestedField(field: ComplexField): this {\n    this.nestedFields.push(field);\n    return this;\n  }\n\n  /**\n   * Gets all nested fields\n   */\n  getNestedFields(): ComplexField[] {\n    return [...this.nestedFields];\n  }\n\n  /**\n   * Removes a nested field at the specified index\n   * @param index - Index of the nested field to remove (0-based)\n   * @returns True if removed, false if index out of bounds\n   *\n   * @example\n   * ```typescript\n   * const field = new ComplexField({ instruction: 'TOC' });\n   * field.addNestedField(nested1);\n   * field.addNestedField(nested2);\n   * field.removeNestedField(0); // Removes nested1\n   * ```\n   */\n  removeNestedField(index: number): boolean {\n    if (index < 0 || index >= this.nestedFields.length) {\n      return false;\n    }\n    this.nestedFields.splice(index, 1);\n    return true;\n  }\n\n  /**\n   * Gets the count of nested fields\n   * @returns Number of nested fields\n   */\n  getNestedFieldCount(): number {\n    return this.nestedFields.length;\n  }\n\n  /**\n   * Clears all nested fields\n   * @returns This field for chaining\n   */\n  clearNestedFields(): this {\n    this.nestedFields = [];\n    return this;\n  }\n\n  /**\n   * Updates the field instruction\n   * @param instruction - New field instruction (e.g., 'TOC \\\\o \"1-3\"')\n   * @returns This field for chaining\n   *\n   * @example\n   * ```typescript\n   * const field = new ComplexField({ instruction: 'DATE' });\n   * field.updateInstruction('DATE \\\\@ \"yyyy-MM-dd\"');\n   * ```\n   */\n  updateInstruction(instruction: string): this {\n    this.instruction = instruction;\n    return this;\n  }\n\n  /**\n   * Adds custom XML content to the result section\n   */\n  addResultContent(content: XMLElement): this {\n    this.resultContent.push(content);\n    return this;\n  }\n\n  /**\n   * Gets result content XML elements\n   */\n  getResultContent(): XMLElement[] {\n    return [...this.resultContent];\n  }\n\n  /**\n   * Sets the tracking context for automatic change tracking\n   * @internal\n   */\n  _setTrackingContext(context: import('../tracking/TrackingContext.js').TrackingContext): void {\n    this.trackingContext = context;\n  }\n\n  /**\n   * Gets the accepted (visible) text from resultContent XMLElements.\n   * Processes w:r (plain runs), w:ins (accepted insertions), skips w:del/w:moveFrom.\n   * Falls back to this.result if resultContent is empty.\n   */\n  getAcceptedResultText(): string {\n    if (this.resultContent.length === 0) {\n      return this.result || '';\n    }\n    let text = '';\n    for (const element of this.resultContent) {\n      if (element.name === 'w:r') {\n        text += this.extractTextFromRunXml(element);\n      } else if (element.name === 'w:ins') {\n        for (const child of element.children || []) {\n          if (typeof child !== 'string' && child.name === 'w:r') {\n            text += this.extractTextFromRunXml(child);\n          }\n        }\n      }\n      // Skip w:del, w:moveFrom (deleted/moved text not visible)\n    }\n    return text || this.result || '';\n  }\n\n  /**\n   * Extracts text content from a w:r (run) XMLElement\n   */\n  private extractTextFromRunXml(run: XMLElement): string {\n    let text = '';\n    for (const child of run.children || []) {\n      if (typeof child !== 'string' && (child.name === 'w:t' || child.name === 'w:delText')) {\n        for (const t of child.children || []) {\n          if (typeof t === 'string') text += t;\n        }\n      }\n    }\n    return text;\n  }\n\n  /**\n   * Sets the field result with tracked changes (del/ins pair).\n   * Creates a w:del wrapping the old text and a w:ins wrapping the new text,\n   * preserving formatting from the original result runs.\n   *\n   * @param newText - New result text to display\n   * @param author - Author name for the revision\n   * @param options - Optional formatting control\n   */\n  setTrackedResult(\n    newText: string,\n    author: string,\n    options?: {\n      formatting?: RunFormatting;\n      preserveFormatting?: boolean;\n    }\n  ): this {\n    const currentText = this.getAcceptedResultText();\n    if (currentText === newText) return this; // No-op if unchanged\n\n    const date = new Date().toISOString().replace(/\\.\\d{3}Z$/, 'Z');\n\n    // Get revision IDs from TrackingContext if available, else Date.now()-based\n    let delId: number, insId: number;\n    if (this.trackingContext) {\n      const rm = this.trackingContext.getRevisionManager();\n      delId = rm.consumeNextId();\n      insId = rm.consumeNextId();\n    } else {\n      const base = Date.now() % 100000000;\n      delId = base;\n      insId = base + 1;\n    }\n\n    // Resolve formatting: explicit > preserve > resultFormatting\n    let rPr: XMLElement | null = null;\n    if (options?.formatting) {\n      rPr = this.createRunProperties(options.formatting);\n    } else if (options?.preserveFormatting) {\n      rPr = this.extractFirstVisibleRunProperties();\n    }\n\n    // Build <w:del> with old text\n    const delRunChildren: (string | XMLElement)[] = [];\n    if (rPr) delRunChildren.push(rPr);\n    delRunChildren.push({\n      name: 'w:delText',\n      attributes: { 'xml:space': 'preserve' },\n      children: [currentText],\n    });\n    const delElement: XMLElement = {\n      name: 'w:del',\n      attributes: { 'w:id': String(delId), 'w:author': author, 'w:date': date },\n      children: [{ name: 'w:r', children: delRunChildren }],\n    };\n\n    // Build <w:ins> with new text\n    const insRunChildren: (string | XMLElement)[] = [];\n    if (rPr) insRunChildren.push(rPr);\n    insRunChildren.push({\n      name: 'w:t',\n      attributes: { 'xml:space': 'preserve' },\n      children: [newText],\n    });\n    const insElement: XMLElement = {\n      name: 'w:ins',\n      attributes: { 'w:id': String(insId), 'w:author': author, 'w:date': date },\n      children: [{ name: 'w:r', children: insRunChildren }],\n    };\n\n    // Replace content: resultContent takes priority in toXML()\n    this.resultContent = [delElement, insElement];\n    this.result = newText;\n    this.resultRevisions = [];\n\n    return this;\n  }\n\n  /**\n   * Extracts w:rPr from the first visible run in resultContent\n   */\n  private extractFirstVisibleRunProperties(): XMLElement | null {\n    for (const element of this.resultContent) {\n      if (element.name === 'w:r') {\n        const rPr = (element.children || []).find(\n          (c): c is XMLElement => typeof c !== 'string' && c.name === 'w:rPr'\n        );\n        if (rPr) return rPr;\n      } else if (element.name === 'w:ins') {\n        for (const child of element.children || []) {\n          if (typeof child !== 'string' && child.name === 'w:r') {\n            const rPr = (child.children || []).find(\n              (c): c is XMLElement => typeof c !== 'string' && c.name === 'w:rPr'\n            );\n            if (rPr) return rPr;\n          }\n        }\n      }\n    }\n    // Fall back to resultFormatting\n    if (this.resultFormatting) {\n      return this.createRunProperties(this.resultFormatting);\n    }\n    return null;\n  }\n\n  /**\n   * Sets whether this field spans multiple paragraphs\n   */\n  setMultiParagraph(multiParagraph: boolean): this {\n    this.multiParagraph = multiParagraph;\n    return this;\n  }\n\n  /**\n   * Gets whether this field spans multiple paragraphs\n   */\n  isMultiParagraph(): boolean {\n    return this.multiParagraph;\n  }\n\n  /**\n   * Sets revisions that wrap the result section\n   * These are tracked changes (w:ins, w:del) that need to wrap the result AND end marker\n   * @param revisions Array of Revision objects\n   */\n  setResultRevisions(revisions: Revision[]): this {\n    this.resultRevisions = revisions;\n    return this;\n  }\n\n  /**\n   * Adds a revision to the result section\n   * @param revision Revision to add\n   */\n  addResultRevision(revision: Revision): this {\n    this.resultRevisions.push(revision);\n    return this;\n  }\n\n  /**\n   * Gets revisions that wrap the result section\n   */\n  getResultRevisions(): Revision[] {\n    return [...this.resultRevisions];\n  }\n\n  /**\n   * Checks if this field has revisions in the result section\n   */\n  hasResultRevisions(): boolean {\n    return this.resultRevisions.length > 0;\n  }\n\n  /**\n   * Generates XML for the complex field\n   * Returns array of run elements (begin, instr, sep, result, end)\n   */\n  toXML(): XMLElement[] {\n    const runs: XMLElement[] = [];\n\n    // 1. Begin marker run\n    const beginFldChar: XMLElement = this._formFieldData\n      ? this.buildFldCharWithFfData()\n      : {\n          name: 'w:fldChar',\n          attributes: { 'w:fldCharType': 'begin' },\n          selfClosing: true,\n        };\n    runs.push({\n      name: 'w:r',\n      children: [beginFldChar],\n    });\n\n    // 2. Instruction run\n    const instrChildren: XMLElement[] = [];\n    if (this.instructionFormatting) {\n      instrChildren.push(this.createRunProperties(this.instructionFormatting));\n    }\n    instrChildren.push({\n      name: 'w:instrText',\n      attributes: { 'xml:space': 'preserve' },\n      children: [this.instruction],\n    });\n    runs.push({\n      name: 'w:r',\n      children: instrChildren,\n    });\n\n    // 2a. Nested fields (if any)\n    for (const nestedField of this.nestedFields) {\n      runs.push(...nestedField.toXML());\n    }\n\n    // 3. Separator run\n    runs.push({\n      name: 'w:r',\n      children: [\n        {\n          name: 'w:fldChar',\n          attributes: { 'w:fldCharType': 'separate' },\n          selfClosing: true,\n        },\n      ],\n    });\n\n    // 4. Result content (prioritize custom XML content, then simple text)\n    // Design note: For INCLUDEPICTURE fields, the parser stores the w:drawing\n    // content in resultContent so it survives the parser→generator round-trip.\n    // When flattenFieldCodes() is active, the full field structure is emitted\n    // here, then _postProcessDocumentXml() strips the INCLUDEPICTURE scaffolding\n    // (fldChar/instrText runs) from the final XML while preserving the drawing.\n    // Non-INCLUDEPICTURE fields emit their complete structure unchanged.\n    if (this.resultContent.length > 0) {\n      // Use custom XML content\n      runs.push(...this.resultContent);\n    } else if (this.result) {\n      // Use simple text result\n      const resultChildren: XMLElement[] = [];\n      if (this.resultFormatting) {\n        resultChildren.push(this.createRunProperties(this.resultFormatting));\n      }\n      resultChildren.push({\n        name: 'w:t',\n        attributes: { 'xml:space': 'preserve' },\n        children: [this.result],\n      });\n      runs.push({\n        name: 'w:r',\n        children: resultChildren,\n      });\n    }\n\n    // 4a. Result revisions — only when NOT using resultContent\n    // When resultContent is populated (e.g., by DocumentParser with interleaved revision XML),\n    // it already includes revision elements in the correct interleaved position.\n    // Emitting them again here would cause duplication.\n    if (this.resultContent.length === 0) {\n      for (const revision of this.resultRevisions) {\n        const revisionXml = revision.toXML();\n        if (revisionXml) {\n          runs.push(revisionXml);\n        }\n      }\n    }\n\n    // 5. End marker run\n    runs.push({\n      name: 'w:r',\n      children: [\n        {\n          name: 'w:fldChar',\n          attributes: { 'w:fldCharType': 'end' },\n          selfClosing: true,\n        },\n      ],\n    });\n\n    return runs;\n  }\n\n  /**\n   * Creates run properties XML from formatting\n   */\n  private createRunProperties(formatting: RunFormatting): XMLElement {\n    const children: XMLElement[] = [];\n\n    if (formatting.bold) {\n      children.push({ name: 'w:b', selfClosing: true });\n    }\n\n    if (formatting.italic) {\n      children.push({ name: 'w:i', selfClosing: true });\n    }\n\n    if (formatting.underline) {\n      const val = typeof formatting.underline === 'string' ? formatting.underline : 'single';\n      children.push({\n        name: 'w:u',\n        attributes: { 'w:val': val },\n        selfClosing: true,\n      });\n    }\n\n    if (formatting.strike) {\n      children.push({ name: 'w:strike', selfClosing: true });\n    }\n\n    if (formatting.font) {\n      children.push({\n        name: 'w:rFonts',\n        attributes: {\n          'w:ascii': formatting.font,\n          'w:hAnsi': formatting.font,\n          'w:cs': formatting.font,\n        },\n        selfClosing: true,\n      });\n    }\n\n    if (formatting.size) {\n      const sizeValue = pointsToHalfPoints(formatting.size).toString();\n      children.push({\n        name: 'w:sz',\n        attributes: { 'w:val': sizeValue },\n        selfClosing: true,\n      });\n      children.push({\n        name: 'w:szCs',\n        attributes: { 'w:val': sizeValue },\n        selfClosing: true,\n      });\n    }\n\n    if (formatting.color) {\n      const color = formatting.color.replace('#', '');\n      children.push({\n        name: 'w:color',\n        attributes: { 'w:val': color },\n        selfClosing: true,\n      });\n    }\n\n    if (formatting.highlight) {\n      children.push({\n        name: 'w:highlight',\n        attributes: { 'w:val': formatting.highlight },\n        selfClosing: true,\n      });\n    }\n\n    return { name: 'w:rPr', children };\n  }\n\n  /**\n   * Builds a w:fldChar begin element with w:ffData child\n   */\n  private buildFldCharWithFfData(): XMLElement {\n    const ffd = this._formFieldData!;\n    const ffDataChildren: (string | XMLElement)[] = [];\n\n    if (ffd.name) {\n      ffDataChildren.push({ name: 'w:name', attributes: { 'w:val': ffd.name }, selfClosing: true });\n    }\n    if (ffd.enabled !== undefined) {\n      if (ffd.enabled) {\n        ffDataChildren.push({ name: 'w:enabled', selfClosing: true });\n      } else {\n        ffDataChildren.push({ name: 'w:enabled', attributes: { 'w:val': '0' }, selfClosing: true });\n      }\n    }\n    if (ffd.calcOnExit !== undefined) {\n      ffDataChildren.push({\n        name: 'w:calcOnExit',\n        attributes: { 'w:val': ffd.calcOnExit ? '1' : '0' },\n        selfClosing: true,\n      });\n    }\n    if (ffd.helpText) {\n      ffDataChildren.push({\n        name: 'w:helpText',\n        attributes: { 'w:type': 'text', 'w:val': ffd.helpText },\n        selfClosing: true,\n      });\n    }\n    if (ffd.statusText) {\n      ffDataChildren.push({\n        name: 'w:statusText',\n        attributes: { 'w:type': 'text', 'w:val': ffd.statusText },\n        selfClosing: true,\n      });\n    }\n    if (ffd.entryMacro) {\n      ffDataChildren.push({\n        name: 'w:entryMacro',\n        attributes: { 'w:val': ffd.entryMacro },\n        selfClosing: true,\n      });\n    }\n    if (ffd.exitMacro) {\n      ffDataChildren.push({\n        name: 'w:exitMacro',\n        attributes: { 'w:val': ffd.exitMacro },\n        selfClosing: true,\n      });\n    }\n\n    if (ffd.fieldType) {\n      switch (ffd.fieldType.type) {\n        case 'textInput': {\n          const tiChildren: (string | XMLElement)[] = [];\n          if (ffd.fieldType.inputType)\n            tiChildren.push({\n              name: 'w:type',\n              attributes: { 'w:val': ffd.fieldType.inputType },\n              selfClosing: true,\n            });\n          if (ffd.fieldType.defaultValue)\n            tiChildren.push({\n              name: 'w:default',\n              attributes: { 'w:val': ffd.fieldType.defaultValue },\n              selfClosing: true,\n            });\n          if (ffd.fieldType.maxLength !== undefined)\n            tiChildren.push({\n              name: 'w:maxLength',\n              attributes: { 'w:val': String(ffd.fieldType.maxLength) },\n              selfClosing: true,\n            });\n          if (ffd.fieldType.format)\n            tiChildren.push({\n              name: 'w:format',\n              attributes: { 'w:val': ffd.fieldType.format },\n              selfClosing: true,\n            });\n          ffDataChildren.push({ name: 'w:textInput', children: tiChildren });\n          break;\n        }\n        case 'checkBox': {\n          const cbChildren: (string | XMLElement)[] = [];\n          if (ffd.fieldType.size === 'auto') {\n            cbChildren.push({ name: 'w:sizeAuto', selfClosing: true });\n          } else if (ffd.fieldType.size !== undefined) {\n            cbChildren.push({\n              name: 'w:size',\n              attributes: { 'w:val': String(ffd.fieldType.size) },\n              selfClosing: true,\n            });\n          }\n          if (ffd.fieldType.defaultChecked !== undefined)\n            cbChildren.push({\n              name: 'w:default',\n              attributes: { 'w:val': ffd.fieldType.defaultChecked ? '1' : '0' },\n              selfClosing: true,\n            });\n          if (ffd.fieldType.checked !== undefined)\n            cbChildren.push({\n              name: 'w:checked',\n              attributes: { 'w:val': ffd.fieldType.checked ? '1' : '0' },\n              selfClosing: true,\n            });\n          ffDataChildren.push({ name: 'w:checkBox', children: cbChildren });\n          break;\n        }\n        case 'dropDownList': {\n          const ddChildren: (string | XMLElement)[] = [];\n          if (ffd.fieldType.result !== undefined)\n            ddChildren.push({\n              name: 'w:result',\n              attributes: { 'w:val': String(ffd.fieldType.result) },\n              selfClosing: true,\n            });\n          if (ffd.fieldType.defaultResult !== undefined)\n            ddChildren.push({\n              name: 'w:default',\n              attributes: { 'w:val': String(ffd.fieldType.defaultResult) },\n              selfClosing: true,\n            });\n          if (ffd.fieldType.listEntries) {\n            for (const entry of ffd.fieldType.listEntries) {\n              ddChildren.push({\n                name: 'w:listEntry',\n                attributes: { 'w:val': entry },\n                selfClosing: true,\n              });\n            }\n          }\n          ffDataChildren.push({ name: 'w:ddList', children: ddChildren });\n          break;\n        }\n      }\n    }\n\n    return {\n      name: 'w:fldChar',\n      attributes: { 'w:fldCharType': 'begin' },\n      children: [{ name: 'w:ffData', children: ffDataChildren }],\n    };\n  }\n}\n\n/**\n * TOC field options\n */\nexport interface TOCFieldOptions {\n  /** Heading levels to include (e.g., \"1-3\" for levels 1-3) */\n  levels?: string;\n\n  /** Make entries hyperlinks (\\h switch) */\n  hyperlinks?: boolean;\n\n  /** Hide tab leaders and page numbers in Web Layout (\\z switch) */\n  hideInWebLayout?: boolean;\n\n  /** Use outline levels (\\u switch) */\n  useOutlineLevels?: boolean;\n\n  /** Omit page numbers (\\n switch) */\n  omitPageNumbers?: boolean;\n\n  /** Custom styles to use (\\t switch) */\n  customStyles?: string;\n}\n\n/**\n * Creates a TOC (Table of Contents) complex field\n * Generates proper field instruction with switches\n *\n * @param options TOC field options\n * @returns ComplexField configured for TOC\n *\n * @example\n * const toc = createTOCField({ levels: '1-3', hyperlinks: true });\n * // Generates: TOC \\o \"1-3\" \\h \\z \\u\n */\nexport function createTOCField(options: TOCFieldOptions = {}): ComplexField {\n  // Build instruction string\n  let instruction = ' TOC';\n\n  // Add outline levels switch\n  if (options.levels !== undefined) {\n    instruction += ` \\\\o \"${options.levels}\"`;\n  } else {\n    instruction += ' \\\\o \"1-3\"'; // Default: levels 1-3\n  }\n\n  // Add hyperlinks switch\n  if (options.hyperlinks !== false) {\n    instruction += ' \\\\h';\n  }\n\n  // Add hide in web layout switch\n  if (options.hideInWebLayout !== false) {\n    instruction += ' \\\\z';\n  }\n\n  // Add use outline levels switch\n  if (options.useOutlineLevels !== false) {\n    instruction += ' \\\\u';\n  }\n\n  // Add omit page numbers switch\n  if (options.omitPageNumbers) {\n    instruction += ' \\\\n';\n  }\n\n  // Add custom styles switch\n  if (options.customStyles) {\n    instruction += ` \\\\t \"${options.customStyles}\"`;\n  }\n\n  instruction += ' '; // Trailing space per Microsoft convention\n\n  return new ComplexField({\n    instruction,\n    result: 'Table of Contents', // Placeholder result\n  });\n}\n"]}

package/dist/esm/elements/FieldHelpers.js

@@ -0,0 +1,134 @@
+import { ComplexField } from './Field.js';
+import { defaultLogger } from '../utils/logger.js';
+export function parseHyperlinkInstruction(instruction) {
+    if (!instruction) {
+        return null;
+    }
+    const normalized = instruction.trim();
+    if (!normalized.toUpperCase().startsWith('HYPERLINK')) {
+        return null;
+    }
+    let url = '';
+    const urlMatch = /HYPERLINK\s+"([^"]*)"/i.exec(normalized);
+    if (urlMatch?.[1] !== undefined) {
+        url = urlMatch[1];
+        try {
+            url = decodeURIComponent(url);
+        }
+        catch (e) {
+            defaultLogger.debug(`[FieldHelpers] Failed to decode URL: ${url}`);
+        }
+    }
+    let anchor;
+    const anchorMatch = /\\l\s+"([^"]*)"/i.exec(normalized);
+    if (anchorMatch?.[1] !== undefined) {
+        anchor = anchorMatch[1];
+        try {
+            anchor = decodeURIComponent(anchor);
+        }
+        catch (e) {
+            defaultLogger.debug(`[FieldHelpers] Failed to decode anchor: ${anchor}`);
+        }
+    }
+    if (!url && !anchor) {
+        return null;
+    }
+    let tooltip;
+    const tooltipMatch = /\\o\s+"([^"]*)"/i.exec(normalized);
+    if (tooltipMatch?.[1] !== undefined) {
+        tooltip = tooltipMatch[1];
+    }
+    const hasHSwitch = /\\h(?:\s|$)/i.test(normalized);
+    let fullUrl = url;
+    if (anchor) {
+        const hashIndex = url.indexOf('#');
+        if (hashIndex >= 0) {
+            fullUrl = url.substring(0, hashIndex) + '#' + anchor;
+        }
+        else if (url) {
+            fullUrl = url + '#' + anchor;
+        }
+        else {
+            fullUrl = '#' + anchor;
+        }
+    }
+    return {
+        url,
+        anchor,
+        tooltip,
+        hasHSwitch,
+        fullUrl,
+        rawInstruction: instruction,
+    };
+}
+export function buildHyperlinkInstruction(url, anchor, tooltip) {
+    let instruction = `HYPERLINK "${url}"`;
+    if (anchor) {
+        instruction += ` \\l "${anchor}"`;
+    }
+    if (tooltip) {
+        instruction += ` \\o "${tooltip}"`;
+    }
+    instruction += ' \\h';
+    return instruction;
+}
+export function isHyperlinkInstruction(instruction) {
+    if (!instruction) {
+        return false;
+    }
+    return instruction.trim().toUpperCase().startsWith('HYPERLINK');
+}
+export function createNestedIFMergeField(condition, mergeFieldName, trueText = '', falseText = '') {
+    const mergeField = new ComplexField({
+        instruction: ` MERGEFIELD ${mergeFieldName} `,
+        result: `[${mergeFieldName}]`,
+    });
+    const ifField = new ComplexField({
+        instruction: ` IF ${condition} "${trueText}" "${falseText}" `,
+        result: trueText || falseText,
+    });
+    ifField.addNestedField(mergeField);
+    return ifField;
+}
+export function createMergeField(fieldName, format) {
+    let instruction = ` MERGEFIELD ${fieldName}`;
+    if (format) {
+        instruction += ` ${format}`;
+    }
+    instruction += ' \\* MERGEFORMAT ';
+    return new ComplexField({
+        instruction,
+        result: `[${fieldName}]`,
+    });
+}
+export function createRefField(bookmarkName, format) {
+    let instruction = ` REF ${bookmarkName}`;
+    if (format) {
+        instruction += ` ${format}`;
+    }
+    else {
+        instruction += ' \\h';
+    }
+    instruction += ' \\* MERGEFORMAT ';
+    return new ComplexField({
+        instruction,
+        result: `[${bookmarkName}]`,
+    });
+}
+export function createIFField(condition, trueContent, falseContent = '') {
+    const instruction = ` IF ${condition} "${trueContent}" "${falseContent}" `;
+    return new ComplexField({
+        instruction,
+        result: trueContent,
+    });
+}
+export function createNestedField(outerInstruction, nestedFields) {
+    const field = new ComplexField({
+        instruction: outerInstruction,
+    });
+    for (const nested of nestedFields) {
+        field.addNestedField(nested);
+    }
+    return field;
+}
+//# sourceMappingURL=FieldHelpers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FieldHelpers.js","sourceRoot":"","sources":["../../../src/elements/FieldHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Helper functions for creating complex and nested fields\n */\n\nimport { ComplexField } from './Field.js';\nimport { defaultLogger } from '../utils/logger.js';\n\n/**\n * Parsed components of a HYPERLINK field instruction\n */\nexport interface ParsedHyperlinkInstruction {\n  /** Base URL (with encoded characters decoded) */\n  url: string;\n  /** Anchor/fragment from \\l switch (decoded) */\n  anchor?: string;\n  /** Tooltip text from \\o switch */\n  tooltip?: string;\n  /** Whether \\h switch is present (creates hyperlink) */\n  hasHSwitch: boolean;\n  /** Combined full URL (url + \"#\" + anchor if both present) */\n  fullUrl: string;\n  /** Original raw instruction string */\n  rawInstruction: string;\n}\n\n/**\n * Parses a HYPERLINK field instruction string into its components\n *\n * HYPERLINK field syntax per ECMA-376:\n * - HYPERLINK \"url\" - basic external hyperlink\n * - HYPERLINK \\l \"anchor\" - anchor-only internal hyperlink (no URL)\n * - \\l \"anchor\" - specifies a location (anchor/fragment) within the target\n * - \\o \"tooltip\" - specifies the tooltip/screentip text\n * - \\h - creates a hyperlink (always present for clickable links)\n * - \\n - opens link in new window\n * - \\t \"target\" - specifies target frame\n *\n * @param instruction The raw field instruction string (e.g., 'HYPERLINK \"url\" \\l \"anchor\" \\h')\n * @returns Parsed components or null if not a valid HYPERLINK instruction\n *\n * @example\n * ```typescript\n * // External hyperlink with anchor\n * const result = parseHyperlinkInstruction('HYPERLINK \"https://example.com/\" \\\\l \"section1\" \\\\h');\n * // result.url = \"https://example.com/\"\n * // result.anchor = \"section1\"\n * // result.fullUrl = \"https://example.com/#section1\"\n *\n * // Anchor-only internal hyperlink (e.g., \"Top of the Document\")\n * const result2 = parseHyperlinkInstruction('HYPERLINK \\\\l \"_top\" \\\\h');\n * // result2.url = \"\"\n * // result2.anchor = \"_top\"\n * // result2.fullUrl = \"#_top\"\n * ```\n */\nexport function parseHyperlinkInstruction(instruction: string): ParsedHyperlinkInstruction | null {\n  if (!instruction) {\n    return null;\n  }\n\n  // Normalize whitespace and trim\n  const normalized = instruction.trim();\n\n  // Check if this is a HYPERLINK instruction\n  if (!normalized.toUpperCase().startsWith('HYPERLINK')) {\n    return null;\n  }\n\n  // Extract the URL (first quoted string after HYPERLINK, before any switches)\n  // URL is optional - anchor-only hyperlinks like 'HYPERLINK \\l \"_top\"' are valid\n  let url = '';\n  const urlMatch = /HYPERLINK\\s+\"([^\"]*)\"/i.exec(normalized);\n  if (urlMatch?.[1] !== undefined) {\n    url = urlMatch[1];\n    // Decode URL-encoded characters\n    try {\n      url = decodeURIComponent(url);\n    } catch (e) {\n      defaultLogger.debug(`[FieldHelpers] Failed to decode URL: ${url}`);\n    }\n  }\n\n  // Extract \\l switch (anchor/fragment)\n  let anchor: string | undefined;\n  const anchorMatch = /\\\\l\\s+\"([^\"]*)\"/i.exec(normalized);\n  if (anchorMatch?.[1] !== undefined) {\n    anchor = anchorMatch[1];\n    // Decode anchor as well\n    try {\n      anchor = decodeURIComponent(anchor);\n    } catch (e) {\n      defaultLogger.debug(`[FieldHelpers] Failed to decode anchor: ${anchor}`);\n    }\n  }\n\n  // Must have either URL or anchor to be valid\n  if (!url && !anchor) {\n    return null;\n  }\n\n  // Extract \\o switch (tooltip)\n  let tooltip: string | undefined;\n  const tooltipMatch = /\\\\o\\s+\"([^\"]*)\"/i.exec(normalized);\n  if (tooltipMatch?.[1] !== undefined) {\n    tooltip = tooltipMatch[1];\n  }\n\n  // Check for \\h switch\n  const hasHSwitch = /\\\\h(?:\\s|$)/i.test(normalized);\n\n  // Build full URL by combining base URL and anchor\n  let fullUrl: string = url;\n  if (anchor) {\n    // If URL already has a fragment, replace it; otherwise append\n    const hashIndex = url.indexOf('#');\n    if (hashIndex >= 0) {\n      fullUrl = url.substring(0, hashIndex) + '#' + anchor;\n    } else if (url) {\n      fullUrl = url + '#' + anchor;\n    } else {\n      // Anchor-only: just use #anchor\n      fullUrl = '#' + anchor;\n    }\n  }\n\n  return {\n    url,\n    anchor,\n    tooltip,\n    hasHSwitch,\n    fullUrl,\n    rawInstruction: instruction,\n  };\n}\n\n/**\n * Creates a HYPERLINK field instruction string from components\n *\n * @param url The target URL\n * @param anchor Optional anchor/fragment (will use \\l switch)\n * @param tooltip Optional tooltip text (will use \\o switch)\n * @returns Properly formatted HYPERLINK instruction string\n *\n * @example\n * ```typescript\n * const instr = buildHyperlinkInstruction('https://example.com/', 'section1', 'Click here');\n * // Returns: 'HYPERLINK \"https://example.com/\" \\\\l \"section1\" \\\\o \"Click here\" \\\\h'\n * ```\n */\nexport function buildHyperlinkInstruction(url: string, anchor?: string, tooltip?: string): string {\n  let instruction = `HYPERLINK \"${url}\"`;\n\n  if (anchor) {\n    instruction += ` \\\\l \"${anchor}\"`;\n  }\n\n  if (tooltip) {\n    instruction += ` \\\\o \"${tooltip}\"`;\n  }\n\n  // Always add \\h switch for clickable hyperlinks\n  instruction += ' \\\\h';\n\n  return instruction;\n}\n\n/**\n * Checks if a field instruction is a HYPERLINK field\n *\n * @param instruction The field instruction to check\n * @returns True if the instruction is a HYPERLINK field\n */\nexport function isHyperlinkInstruction(instruction: string): boolean {\n  if (!instruction) {\n    return false;\n  }\n  return instruction.trim().toUpperCase().startsWith('HYPERLINK');\n}\n\n/**\n * Creates a nested IF field containing a MERGEFIELD\n * This is a common pattern for conditional mail merge\n *\n * @param condition The IF condition (e.g., 'Status = \"Active\"')\n * @param mergeFieldName The merge field name to include\n * @param trueText Text to show when condition is true\n * @param falseText Text to show when condition is false\n * @returns ComplexField with nested MERGEFIELD\n *\n * @example\n * ```typescript\n * const field = createNestedIFMergeField('Status = \"Active\"', 'Name', 'Active: ', 'Inactive');\n * // Result: IF field that shows \"Active: [Name]\" if Status is Active, otherwise \"Inactive\"\n * ```\n */\nexport function createNestedIFMergeField(\n  condition: string,\n  mergeFieldName: string,\n  trueText = '',\n  falseText = ''\n): ComplexField {\n  // Create the nested MERGEFIELD\n  const mergeField = new ComplexField({\n    instruction: ` MERGEFIELD ${mergeFieldName} `,\n    result: `[${mergeFieldName}]`,\n  });\n\n  // Create the IF field with nested MERGEFIELD\n  const ifField = new ComplexField({\n    instruction: ` IF ${condition} \"${trueText}\" \"${falseText}\" `,\n    result: trueText || falseText,\n  });\n\n  ifField.addNestedField(mergeField);\n\n  return ifField;\n}\n\n/**\n * Creates a MERGEFIELD with custom formatting\n *\n * @param fieldName The merge field name\n * @param format Optional format switches\n * @returns ComplexField for MERGEFIELD\n *\n * @example\n * ```typescript\n * const field = createMergeField('Date', '\\\\@ \"MMMM d, yyyy\"');\n * ```\n */\nexport function createMergeField(fieldName: string, format?: string): ComplexField {\n  let instruction = ` MERGEFIELD ${fieldName}`;\n\n  if (format) {\n    instruction += ` ${format}`;\n  }\n\n  instruction += ' \\\\* MERGEFORMAT ';\n\n  return new ComplexField({\n    instruction,\n    result: `[${fieldName}]`,\n  });\n}\n\n/**\n * Creates a REF field with a nested field in the bookmark reference\n * Used for complex cross-references\n *\n * @param bookmarkName The bookmark to reference\n * @param format Optional format switches\n * @returns ComplexField for REF\n *\n * @example\n * ```typescript\n * const field = createRefField('Chapter1', '\\\\h');\n * ```\n */\nexport function createRefField(bookmarkName: string, format?: string): ComplexField {\n  let instruction = ` REF ${bookmarkName}`;\n\n  if (format) {\n    instruction += ` ${format}`;\n  } else {\n    instruction += ' \\\\h'; // Hyperlink by default\n  }\n\n  instruction += ' \\\\* MERGEFORMAT ';\n\n  return new ComplexField({\n    instruction,\n    result: `[${bookmarkName}]`,\n  });\n}\n\n/**\n * Creates an IF field with custom true/false branches\n *\n * @param condition The condition to evaluate\n * @param trueContent Content to show when true\n * @param falseContent Content to show when false\n * @returns ComplexField for IF\n *\n * @example\n * ```typescript\n * const field = createIFField('Amount > 1000', 'High Value', 'Normal');\n * ```\n */\nexport function createIFField(\n  condition: string,\n  trueContent: string,\n  falseContent = ''\n): ComplexField {\n  const instruction = ` IF ${condition} \"${trueContent}\" \"${falseContent}\" `;\n\n  return new ComplexField({\n    instruction,\n    result: trueContent,\n  });\n}\n\n/**\n * Creates a complex nested field structure with multiple levels\n * Useful for advanced scenarios like nested IF statements\n *\n * @param outerInstruction The outer field instruction\n * @param nestedFields Array of nested fields to include\n * @returns ComplexField with nested structure\n *\n * @example\n * ```typescript\n * const innerField = createMergeField('Amount');\n * const field = createNestedField('IF Amount > 0', [innerField]);\n * ```\n */\nexport function createNestedField(\n  outerInstruction: string,\n  nestedFields: ComplexField[]\n): ComplexField {\n  const field = new ComplexField({\n    instruction: outerInstruction,\n  });\n\n  for (const nested of nestedFields) {\n    field.addNestedField(nested);\n  }\n\n  return field;\n}\n"]}

package/dist/esm/elements/FontManager.js

@@ -0,0 +1,158 @@
+export class FontManager {
+    fonts = new Map();
+    static fontCounter = 1;
+    constructor() {
+    }
+    static create() {
+        return new FontManager();
+    }
+    addFont(fontFamily, data, format = 'ttf') {
+        const sanitizedFamily = this.sanitizeFontName(fontFamily);
+        const filename = `${sanitizedFamily}_${FontManager.fontCounter++}.${format}`;
+        const path = `word/fonts/${filename}`;
+        const entry = {
+            filename,
+            format,
+            fontFamily,
+            data,
+            path,
+        };
+        this.fonts.set(path, entry);
+        return path;
+    }
+    async addFontFromFile(fontFamily, filePath, format) {
+        const fs = require('fs').promises;
+        if (!format) {
+            const ext = filePath.split('.').pop()?.toLowerCase();
+            if (ext === 'ttf' || ext === 'otf' || ext === 'woff' || ext === 'woff2') {
+                format = ext;
+            }
+            else {
+                throw new Error(`Unable to detect font format from file: ${filePath}`);
+            }
+        }
+        const data = await fs.readFile(filePath);
+        return this.addFont(fontFamily, data, format);
+    }
+    hasFont(fontFamily) {
+        for (const entry of this.fonts.values()) {
+            if (entry.fontFamily === fontFamily) {
+                return true;
+            }
+        }
+        return false;
+    }
+    getAllFonts() {
+        return Array.from(this.fonts.values());
+    }
+    getCount() {
+        return this.fonts.size;
+    }
+    static getMimeType(format) {
+        const mimeTypes = {
+            ttf: 'application/x-font-ttf',
+            otf: 'application/x-font-opentype',
+            woff: 'application/font-woff',
+            woff2: 'font/woff2',
+        };
+        return mimeTypes[format] || 'application/octet-stream';
+    }
+    getExtensions() {
+        const extensions = new Set();
+        for (const entry of this.fonts.values()) {
+            extensions.add(entry.format);
+        }
+        return extensions;
+    }
+    generateContentTypeEntries() {
+        const entries = [];
+        const extensions = this.getExtensions();
+        for (const ext of extensions) {
+            const mimeType = FontManager.getMimeType(ext);
+            entries.push(`  <Default Extension="${ext}" ContentType="${mimeType}"/>`);
+        }
+        return entries;
+    }
+    sanitizeFontName(fontName) {
+        return fontName
+            .toLowerCase()
+            .replace(/\s+/g, '_')
+            .replace(/[^a-z0-9_-]/g, '')
+            .substring(0, 50);
+    }
+    clear() {
+        this.fonts.clear();
+    }
+    removeFont(path) {
+        return this.fonts.delete(path);
+    }
+    getFontByPath(path) {
+        return this.fonts.get(path);
+    }
+    getFontByFamily(fontFamily) {
+        for (const entry of this.fonts.values()) {
+            if (entry.fontFamily === fontFamily) {
+                return entry;
+            }
+        }
+        return undefined;
+    }
+    static parseFontExtensionsFromContentTypes(contentTypesXml) {
+        const fontExtensions = [];
+        const fontMimeTypes = [
+            'application/x-font-ttf',
+            'application/x-font-opentype',
+            'application/font-woff',
+            'font/woff2',
+        ];
+        const defaultPattern = /<Default\s+Extension="([^"]+)"\s+ContentType="([^"]+)"/g;
+        let match;
+        while ((match = defaultPattern.exec(contentTypesXml)) !== null) {
+            const extension = match[1];
+            const mimeType = match[2];
+            if (extension && mimeType && fontMimeTypes.includes(mimeType)) {
+                fontExtensions.push(extension);
+            }
+        }
+        return fontExtensions;
+    }
+    static detectFormatFromExtension(extension) {
+        const ext = extension.toLowerCase().replace('.', '');
+        if (ext === 'ttf' || ext === 'otf' || ext === 'woff' || ext === 'woff2') {
+            return ext;
+        }
+        return undefined;
+    }
+    loadFontsFromArchive(zipFiles, contentTypesXml) {
+        const registeredExtensions = FontManager.parseFontExtensionsFromContentTypes(contentTypesXml);
+        for (const [path, content] of zipFiles.entries()) {
+            if (path.startsWith('word/fonts/') && content instanceof Buffer) {
+                const filename = path.split('/').pop() || '';
+                const extension = filename.split('.').pop()?.toLowerCase();
+                if (extension && registeredExtensions.includes(extension)) {
+                    const format = FontManager.detectFormatFromExtension(extension);
+                    if (format) {
+                        const familyName = this.extractFontFamilyFromFilename(filename);
+                        const entry = {
+                            filename,
+                            format,
+                            fontFamily: familyName,
+                            data: content,
+                            path,
+                        };
+                        this.fonts.set(path, entry);
+                    }
+                }
+            }
+        }
+    }
+    extractFontFamilyFromFilename(filename) {
+        const nameWithoutExt = filename.replace(/\.(ttf|otf|woff|woff2)$/i, '');
+        const nameWithoutCounter = nameWithoutExt.replace(/_\d+$/, '');
+        return nameWithoutCounter
+            .split('_')
+            .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+            .join(' ');
+    }
+}
+//# sourceMappingURL=FontManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FontManager.js","sourceRoot":"","sources":["../../../src/elements/FontManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * FontManager - Manages embedded fonts in DOCX documents\n * Handles font registration and Content_Types.xml updates\n */\n\n/**\n * Font format types supported in DOCX\n */\nexport type FontFormat = 'ttf' | 'otf' | 'woff' | 'woff2';\n\n/**\n * Font entry information\n */\nexport interface FontEntry {\n  /** Font file name (e.g., 'arial.ttf') */\n  filename: string;\n  /** Font format */\n  format: FontFormat;\n  /** Font family name (e.g., 'Arial') */\n  fontFamily: string;\n  /** Font data (Buffer) */\n  data: Buffer;\n  /** Path in DOCX archive (e.g., 'word/fonts/arial.ttf') */\n  path: string;\n}\n\n/**\n * FontManager handles embedded fonts in documents\n * Ensures fonts are properly registered in [Content_Types].xml\n */\nexport class FontManager {\n  private fonts = new Map<string, FontEntry>();\n  private static fontCounter = 1;\n\n  /**\n   * Creates a new FontManager\n   */\n  constructor() {\n    // Empty constructor\n  }\n\n  /**\n   * Factory method to create a new FontManager\n   */\n  static create(): FontManager {\n    return new FontManager();\n  }\n\n  /**\n   * Adds a font to the document\n   * @param fontFamily - Font family name (e.g., 'Arial', 'Times New Roman')\n   * @param data - Font file data as Buffer\n   * @param format - Font format (ttf, otf, woff, woff2)\n   * @returns Font path in the archive\n   */\n  addFont(fontFamily: string, data: Buffer, format: FontFormat = 'ttf'): string {\n    // Generate unique filename\n    const sanitizedFamily = this.sanitizeFontName(fontFamily);\n    const filename = `${sanitizedFamily}_${FontManager.fontCounter++}.${format}`;\n    const path = `word/fonts/${filename}`;\n\n    // Create font entry\n    const entry: FontEntry = {\n      filename,\n      format,\n      fontFamily,\n      data,\n      path,\n    };\n\n    // Store with path as key for easy lookup\n    this.fonts.set(path, entry);\n\n    return path;\n  }\n\n  /**\n   * Adds a font from a file path\n   * @param fontFamily - Font family name\n   * @param filePath - Path to font file\n   * @param format - Font format (optional, detected from extension)\n   * @returns Font path in the archive\n   */\n  async addFontFromFile(\n    fontFamily: string,\n    filePath: string,\n    format?: FontFormat\n  ): Promise<string> {\n    const fs = require('fs').promises;\n\n    // Detect format from extension if not provided\n    if (!format) {\n      const ext = filePath.split('.').pop()?.toLowerCase();\n      if (ext === 'ttf' || ext === 'otf' || ext === 'woff' || ext === 'woff2') {\n        format = ext as FontFormat;\n      } else {\n        throw new Error(`Unable to detect font format from file: ${filePath}`);\n      }\n    }\n\n    // Read font file\n    const data = await fs.readFile(filePath);\n\n    return this.addFont(fontFamily, data, format);\n  }\n\n  /**\n   * Checks if a font exists\n   * @param fontFamily - Font family name\n   * @returns True if font is registered\n   */\n  hasFont(fontFamily: string): boolean {\n    for (const entry of this.fonts.values()) {\n      if (entry.fontFamily === fontFamily) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  /**\n   * Gets all registered fonts\n   * @returns Array of font entries\n   */\n  getAllFonts(): FontEntry[] {\n    return Array.from(this.fonts.values());\n  }\n\n  /**\n   * Gets font count\n   * @returns Number of fonts\n   */\n  getCount(): number {\n    return this.fonts.size;\n  }\n\n  /**\n   * Gets MIME type for font format\n   * @param format - Font format\n   * @returns MIME type string\n   */\n  static getMimeType(format: FontFormat): string {\n    const mimeTypes: Record<FontFormat, string> = {\n      ttf: 'application/x-font-ttf',\n      otf: 'application/x-font-opentype',\n      woff: 'application/font-woff',\n      woff2: 'font/woff2',\n    };\n\n    return mimeTypes[format] || 'application/octet-stream';\n  }\n\n  /**\n   * Gets all unique font extensions\n   * @returns Set of extensions (e.g., 'ttf', 'otf')\n   */\n  getExtensions(): Set<string> {\n    const extensions = new Set<string>();\n    for (const entry of this.fonts.values()) {\n      extensions.add(entry.format);\n    }\n    return extensions;\n  }\n\n  /**\n   * Generates Content_Types.xml entries for fonts\n   * @returns Array of XML strings\n   */\n  generateContentTypeEntries(): string[] {\n    const entries: string[] = [];\n    const extensions = this.getExtensions();\n\n    // Add Default entries for each extension\n    for (const ext of extensions) {\n      const mimeType = FontManager.getMimeType(ext as FontFormat);\n      entries.push(`  <Default Extension=\"${ext}\" ContentType=\"${mimeType}\"/>`);\n    }\n\n    return entries;\n  }\n\n  /**\n   * Sanitizes font name for use in filename\n   * @param fontName - Font family name\n   * @returns Sanitized name safe for filename\n   */\n  private sanitizeFontName(fontName: string): string {\n    // Remove spaces and special characters\n    return fontName\n      .toLowerCase()\n      .replace(/\\s+/g, '_')\n      .replace(/[^a-z0-9_-]/g, '')\n      .substring(0, 50); // Limit length\n  }\n\n  /**\n   * Clears all fonts\n   */\n  clear(): void {\n    this.fonts.clear();\n  }\n\n  /**\n   * Removes a specific font\n   * @param path - Font path in archive\n   * @returns True if font was removed\n   */\n  removeFont(path: string): boolean {\n    return this.fonts.delete(path);\n  }\n\n  /**\n   * Gets font by path\n   * @param path - Font path in archive\n   * @returns Font entry or undefined\n   */\n  getFontByPath(path: string): FontEntry | undefined {\n    return this.fonts.get(path);\n  }\n\n  /**\n   * Gets font by family name\n   * @param fontFamily - Font family name\n   * @returns Font entry or undefined\n   */\n  getFontByFamily(fontFamily: string): FontEntry | undefined {\n    for (const entry of this.fonts.values()) {\n      if (entry.fontFamily === fontFamily) {\n        return entry;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Parses Content_Types.xml to detect font extensions\n   * @param contentTypesXml - Content_Types.xml content\n   * @returns Array of font extensions found\n   */\n  static parseFontExtensionsFromContentTypes(contentTypesXml: string): string[] {\n    const fontExtensions: string[] = [];\n    const fontMimeTypes = [\n      'application/x-font-ttf',\n      'application/x-font-opentype',\n      'application/font-woff',\n      'font/woff2',\n    ];\n\n    // Parse XML to find Default elements with font MIME types\n    const defaultPattern = /<Default\\s+Extension=\"([^\"]+)\"\\s+ContentType=\"([^\"]+)\"/g;\n    let match;\n\n    while ((match = defaultPattern.exec(contentTypesXml)) !== null) {\n      const extension = match[1];\n      const mimeType = match[2];\n\n      if (extension && mimeType && fontMimeTypes.includes(mimeType)) {\n        fontExtensions.push(extension);\n      }\n    }\n\n    return fontExtensions;\n  }\n\n  /**\n   * Detects font format from extension\n   * @param extension - File extension\n   * @returns FontFormat or undefined\n   */\n  static detectFormatFromExtension(extension: string): FontFormat | undefined {\n    const ext = extension.toLowerCase().replace('.', '');\n    if (ext === 'ttf' || ext === 'otf' || ext === 'woff' || ext === 'woff2') {\n      return ext as FontFormat;\n    }\n    return undefined;\n  }\n\n  /**\n   * Loads fonts from a ZIP archive\n   * Reads fonts from word/fonts/ directory and registers them\n   * @param zipFiles - Map of file paths to content (from ZipHandler)\n   * @param contentTypesXml - Content of [Content_Types].xml\n   */\n  loadFontsFromArchive(zipFiles: Map<string, Buffer | string>, contentTypesXml: string): void {\n    // First, detect which font formats are registered in Content_Types.xml\n    const registeredExtensions = FontManager.parseFontExtensionsFromContentTypes(contentTypesXml);\n\n    // Then, scan word/fonts/ directory for font files\n    for (const [path, content] of zipFiles.entries()) {\n      if (path.startsWith('word/fonts/') && content instanceof Buffer) {\n        const filename = path.split('/').pop() || '';\n        const extension = filename.split('.').pop()?.toLowerCase();\n\n        // Check if this extension is registered\n        if (extension && registeredExtensions.includes(extension)) {\n          const format = FontManager.detectFormatFromExtension(extension);\n\n          if (format) {\n            // Extract font family from filename (sanitize back)\n            const familyName = this.extractFontFamilyFromFilename(filename);\n\n            // Create font entry\n            const entry: FontEntry = {\n              filename,\n              format,\n              fontFamily: familyName,\n              data: content,\n              path,\n            };\n\n            this.fonts.set(path, entry);\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * Extracts font family name from filename\n   * @param filename - Font filename\n   * @returns Inferred font family name\n   */\n  private extractFontFamilyFromFilename(filename: string): string {\n    // Remove extension\n    const nameWithoutExt = filename.replace(/\\.(ttf|otf|woff|woff2)$/i, '');\n\n    // Remove counter suffix (e.g., _1, _2)\n    const nameWithoutCounter = nameWithoutExt.replace(/_\\d+$/, '');\n\n    // Replace underscores with spaces and title case\n    return nameWithoutCounter\n      .split('_')\n      .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n      .join(' ');\n  }\n}\n"]}