docxmlater 10.4.0 → 11.0.4

package/dist/elements/FieldHelpers.js

@@ -8,8 +8,8 @@ exports.createMergeField = createMergeField;
 exports.createRefField = createRefField;
 exports.createIFField = createIFField;
 exports.createNestedField = createNestedField;
-const Field_1 = require("./Field");
-const logger_1 = require("../utils/logger");
+const Field_js_1 = require("./Field.js");
+const logger_js_1 = require("../utils/logger.js");
 function parseHyperlinkInstruction(instruction) {
     if (!instruction) {
         return null;
@@ -26,7 +26,7 @@ function parseHyperlinkInstruction(instruction) {
             url = decodeURIComponent(url);
         }
         catch (e) {
-            logger_1.defaultLogger.debug(`[FieldHelpers] Failed to decode URL: ${url}`);
+            logger_js_1.defaultLogger.debug(`[FieldHelpers] Failed to decode URL: ${url}`);
         }
     }
     let anchor;
@@ -37,7 +37,7 @@ function parseHyperlinkInstruction(instruction) {
             anchor = decodeURIComponent(anchor);
         }
         catch (e) {
-            logger_1.defaultLogger.debug(`[FieldHelpers] Failed to decode anchor: ${anchor}`);
+            logger_js_1.defaultLogger.debug(`[FieldHelpers] Failed to decode anchor: ${anchor}`);
         }
     }
     if (!url && !anchor) {
@@ -89,11 +89,11 @@ function isHyperlinkInstruction(instruction) {
     return instruction.trim().toUpperCase().startsWith('HYPERLINK');
 }
 function createNestedIFMergeField(condition, mergeFieldName, trueText = '', falseText = '') {
-    const mergeField = new Field_1.ComplexField({
+    const mergeField = new Field_js_1.ComplexField({
         instruction: ` MERGEFIELD ${mergeFieldName} `,
         result: `[${mergeFieldName}]`,
     });
-    const ifField = new Field_1.ComplexField({
+    const ifField = new Field_js_1.ComplexField({
         instruction: ` IF ${condition} "${trueText}" "${falseText}" `,
         result: trueText || falseText,
     });
@@ -106,7 +106,7 @@ function createMergeField(fieldName, format) {
         instruction += ` ${format}`;
     }
     instruction += ' \\* MERGEFORMAT ';
-    return new Field_1.ComplexField({
+    return new Field_js_1.ComplexField({
         instruction,
         result: `[${fieldName}]`,
     });
@@ -120,20 +120,20 @@ function createRefField(bookmarkName, format) {
         instruction += ' \\h';
     }
     instruction += ' \\* MERGEFORMAT ';
-    return new Field_1.ComplexField({
+    return new Field_js_1.ComplexField({
         instruction,
         result: `[${bookmarkName}]`,
     });
 }
 function createIFField(condition, trueContent, falseContent = '') {
     const instruction = ` IF ${condition} "${trueContent}" "${falseContent}" `;
-    return new Field_1.ComplexField({
+    return new Field_js_1.ComplexField({
         instruction,
         result: trueContent,
     });
 }
 function createNestedField(outerInstruction, nestedFields) {
-    const field = new Field_1.ComplexField({
+    const field = new Field_js_1.ComplexField({
         instruction: outerInstruction,
     });
     for (const nested of nestedFields) {

package/dist/elements/FieldHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"FieldHelpers.js","sourceRoot":"","sources":["../../src/elements/FieldHelpers.ts"],"names":[],"mappings":";;AAuDA,8DA8EC;AAgBD,8DAeC;AAQD,wDAKC;AAkBD,4DAqBC;AAcD,4CAaC;AAeD,wCAeC;AAeD,sCAWC;AAgBD,8CAaC;AApUD,mCAAuC;AACvC,4CAAgD;AAkDhD,SAAgB,yBAAyB,CAAC,WAAmB;IAC3D,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAGtC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAID,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,MAAM,QAAQ,GAAG,wBAAwB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3D,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAChC,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAElB,IAAI,CAAC;YACH,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,sBAAa,CAAC,KAAK,CAAC,wCAAwC,GAAG,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAGD,IAAI,MAA0B,CAAC;IAC/B,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxD,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAExB,IAAI,CAAC;YACH,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,sBAAa,CAAC,KAAK,CAAC,2CAA2C,MAAM,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAGD,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,IAAI,OAA2B,CAAC;IAChC,MAAM,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzD,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAGD,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAGnD,IAAI,OAAO,GAAW,GAAG,CAAC;IAC1B,IAAI,MAAM,EAAE,CAAC;QAEX,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACnB,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,GAAG,GAAG,MAAM,CAAC;QACvD,CAAC;aAAM,IAAI,GAAG,EAAE,CAAC;YACf,OAAO,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC;QAC/B,CAAC;aAAM,CAAC;YAEN,OAAO,GAAG,GAAG,GAAG,MAAM,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG;QACH,MAAM;QACN,OAAO;QACP,UAAU;QACV,OAAO;QACP,cAAc,EAAE,WAAW;KAC5B,CAAC;AACJ,CAAC;AAgBD,SAAgB,yBAAyB,CAAC,GAAW,EAAE,MAAe,EAAE,OAAgB;IACtF,IAAI,WAAW,GAAG,cAAc,GAAG,GAAG,CAAC;IAEvC,IAAI,MAAM,EAAE,CAAC;QACX,WAAW,IAAI,SAAS,MAAM,GAAG,CAAC;IACpC,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,WAAW,IAAI,SAAS,OAAO,GAAG,CAAC;IACrC,CAAC;IAGD,WAAW,IAAI,MAAM,CAAC;IAEtB,OAAO,WAAW,CAAC;AACrB,CAAC;AAQD,SAAgB,sBAAsB,CAAC,WAAmB;IACxD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAClE,CAAC;AAkBD,SAAgB,wBAAwB,CACtC,SAAiB,EACjB,cAAsB,EACtB,QAAQ,GAAG,EAAE,EACb,SAAS,GAAG,EAAE;IAGd,MAAM,UAAU,GAAG,IAAI,oBAAY,CAAC;QAClC,WAAW,EAAE,eAAe,cAAc,GAAG;QAC7C,MAAM,EAAE,IAAI,cAAc,GAAG;KAC9B,CAAC,CAAC;IAGH,MAAM,OAAO,GAAG,IAAI,oBAAY,CAAC;QAC/B,WAAW,EAAE,OAAO,SAAS,KAAK,QAAQ,MAAM,SAAS,IAAI;QAC7D,MAAM,EAAE,QAAQ,IAAI,SAAS;KAC9B,CAAC,CAAC;IAEH,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAEnC,OAAO,OAAO,CAAC;AACjB,CAAC;AAcD,SAAgB,gBAAgB,CAAC,SAAiB,EAAE,MAAe;IACjE,IAAI,WAAW,GAAG,eAAe,SAAS,EAAE,CAAC;IAE7C,IAAI,MAAM,EAAE,CAAC;QACX,WAAW,IAAI,IAAI,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED,WAAW,IAAI,mBAAmB,CAAC;IAEnC,OAAO,IAAI,oBAAY,CAAC;QACtB,WAAW;QACX,MAAM,EAAE,IAAI,SAAS,GAAG;KACzB,CAAC,CAAC;AACL,CAAC;AAeD,SAAgB,cAAc,CAAC,YAAoB,EAAE,MAAe;IAClE,IAAI,WAAW,GAAG,QAAQ,YAAY,EAAE,CAAC;IAEzC,IAAI,MAAM,EAAE,CAAC;QACX,WAAW,IAAI,IAAI,MAAM,EAAE,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,WAAW,IAAI,MAAM,CAAC;IACxB,CAAC;IAED,WAAW,IAAI,mBAAmB,CAAC;IAEnC,OAAO,IAAI,oBAAY,CAAC;QACtB,WAAW;QACX,MAAM,EAAE,IAAI,YAAY,GAAG;KAC5B,CAAC,CAAC;AACL,CAAC;AAeD,SAAgB,aAAa,CAC3B,SAAiB,EACjB,WAAmB,EACnB,YAAY,GAAG,EAAE;IAEjB,MAAM,WAAW,GAAG,OAAO,SAAS,KAAK,WAAW,MAAM,YAAY,IAAI,CAAC;IAE3E,OAAO,IAAI,oBAAY,CAAC;QACtB,WAAW;QACX,MAAM,EAAE,WAAW;KACpB,CAAC,CAAC;AACL,CAAC;AAgBD,SAAgB,iBAAiB,CAC/B,gBAAwB,EACxB,YAA4B;IAE5B,MAAM,KAAK,GAAG,IAAI,oBAAY,CAAC;QAC7B,WAAW,EAAE,gBAAgB;KAC9B,CAAC,CAAC;IAEH,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["/**\n * Helper functions for creating complex and nested fields\n */\n\nimport { ComplexField } from './Field';\nimport { defaultLogger } from '../utils/logger';\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"]}
+{"version":3,"file":"FieldHelpers.js","sourceRoot":"","sources":["../../src/elements/FieldHelpers.ts"],"names":[],"mappings":";;AAuDA,8DA8EC;AAgBD,8DAeC;AAQD,wDAKC;AAkBD,4DAqBC;AAcD,4CAaC;AAeD,wCAeC;AAeD,sCAWC;AAgBD,8CAaC;AApUD,yCAA0C;AAC1C,kDAAmD;AAkDnD,SAAgB,yBAAyB,CAAC,WAAmB;IAC3D,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAGtC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAID,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,MAAM,QAAQ,GAAG,wBAAwB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3D,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAChC,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAElB,IAAI,CAAC;YACH,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,yBAAa,CAAC,KAAK,CAAC,wCAAwC,GAAG,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAGD,IAAI,MAA0B,CAAC;IAC/B,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxD,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAExB,IAAI,CAAC;YACH,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,yBAAa,CAAC,KAAK,CAAC,2CAA2C,MAAM,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAGD,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,IAAI,OAA2B,CAAC;IAChC,MAAM,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzD,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAGD,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAGnD,IAAI,OAAO,GAAW,GAAG,CAAC;IAC1B,IAAI,MAAM,EAAE,CAAC;QAEX,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACnB,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,GAAG,GAAG,MAAM,CAAC;QACvD,CAAC;aAAM,IAAI,GAAG,EAAE,CAAC;YACf,OAAO,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC;QAC/B,CAAC;aAAM,CAAC;YAEN,OAAO,GAAG,GAAG,GAAG,MAAM,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG;QACH,MAAM;QACN,OAAO;QACP,UAAU;QACV,OAAO;QACP,cAAc,EAAE,WAAW;KAC5B,CAAC;AACJ,CAAC;AAgBD,SAAgB,yBAAyB,CAAC,GAAW,EAAE,MAAe,EAAE,OAAgB;IACtF,IAAI,WAAW,GAAG,cAAc,GAAG,GAAG,CAAC;IAEvC,IAAI,MAAM,EAAE,CAAC;QACX,WAAW,IAAI,SAAS,MAAM,GAAG,CAAC;IACpC,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,WAAW,IAAI,SAAS,OAAO,GAAG,CAAC;IACrC,CAAC;IAGD,WAAW,IAAI,MAAM,CAAC;IAEtB,OAAO,WAAW,CAAC;AACrB,CAAC;AAQD,SAAgB,sBAAsB,CAAC,WAAmB;IACxD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAClE,CAAC;AAkBD,SAAgB,wBAAwB,CACtC,SAAiB,EACjB,cAAsB,EACtB,QAAQ,GAAG,EAAE,EACb,SAAS,GAAG,EAAE;IAGd,MAAM,UAAU,GAAG,IAAI,uBAAY,CAAC;QAClC,WAAW,EAAE,eAAe,cAAc,GAAG;QAC7C,MAAM,EAAE,IAAI,cAAc,GAAG;KAC9B,CAAC,CAAC;IAGH,MAAM,OAAO,GAAG,IAAI,uBAAY,CAAC;QAC/B,WAAW,EAAE,OAAO,SAAS,KAAK,QAAQ,MAAM,SAAS,IAAI;QAC7D,MAAM,EAAE,QAAQ,IAAI,SAAS;KAC9B,CAAC,CAAC;IAEH,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAEnC,OAAO,OAAO,CAAC;AACjB,CAAC;AAcD,SAAgB,gBAAgB,CAAC,SAAiB,EAAE,MAAe;IACjE,IAAI,WAAW,GAAG,eAAe,SAAS,EAAE,CAAC;IAE7C,IAAI,MAAM,EAAE,CAAC;QACX,WAAW,IAAI,IAAI,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED,WAAW,IAAI,mBAAmB,CAAC;IAEnC,OAAO,IAAI,uBAAY,CAAC;QACtB,WAAW;QACX,MAAM,EAAE,IAAI,SAAS,GAAG;KACzB,CAAC,CAAC;AACL,CAAC;AAeD,SAAgB,cAAc,CAAC,YAAoB,EAAE,MAAe;IAClE,IAAI,WAAW,GAAG,QAAQ,YAAY,EAAE,CAAC;IAEzC,IAAI,MAAM,EAAE,CAAC;QACX,WAAW,IAAI,IAAI,MAAM,EAAE,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,WAAW,IAAI,MAAM,CAAC;IACxB,CAAC;IAED,WAAW,IAAI,mBAAmB,CAAC;IAEnC,OAAO,IAAI,uBAAY,CAAC;QACtB,WAAW;QACX,MAAM,EAAE,IAAI,YAAY,GAAG;KAC5B,CAAC,CAAC;AACL,CAAC;AAeD,SAAgB,aAAa,CAC3B,SAAiB,EACjB,WAAmB,EACnB,YAAY,GAAG,EAAE;IAEjB,MAAM,WAAW,GAAG,OAAO,SAAS,KAAK,WAAW,MAAM,YAAY,IAAI,CAAC;IAE3E,OAAO,IAAI,uBAAY,CAAC;QACtB,WAAW;QACX,MAAM,EAAE,WAAW;KACpB,CAAC,CAAC;AACL,CAAC;AAgBD,SAAgB,iBAAiB,CAC/B,gBAAwB,EACxB,YAA4B;IAE5B,MAAM,KAAK,GAAG,IAAI,uBAAY,CAAC;QAC7B,WAAW,EAAE,gBAAgB;KAC9B,CAAC,CAAC;IAEH,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC","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/elements/Footer.d.ts

@@ -1,6 +1,6 @@
-import { Paragraph } from './Paragraph';
-import { RunFormatting } from './Run';
-import { Table } from './Table';
+import { Paragraph } from './Paragraph.js';
+import { RunFormatting } from './Run.js';
+import { Table } from './Table.js';
 export type FooterType = 'default' | 'first' | 'even';
 type FooterElement = Paragraph | Table;
 export interface FooterProperties {

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

@@ -1 +1 @@
-{"version":3,"file":"Footer.d.ts","sourceRoot":"","sources":["../../src/elements/Footer.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAKhC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAKtD,KAAK,aAAa,GAAG,SAAS,GAAG,KAAK,CAAC;AAKvC,MAAM,WAAW,gBAAgB;IAE/B,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAKD,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAS;gBAMZ,UAAU,GAAE,gBAAqB;IAQ7C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ5B,SAAS,IAAI,MAAM,GAAG,SAAS;IAO/B,OAAO,IAAI,UAAU;IAQrB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ7B,WAAW,IAAI,MAAM,GAAG,SAAS;IAQjC,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IASxC,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS;IAwBzC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,SAAS;IAW5D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAU5B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK;IASjD,WAAW,IAAI,aAAa,EAAE;IAO9B,eAAe,IAAI,MAAM;IAOzB,KAAK,IAAI,IAAI;IAUb,KAAK,IAAI,MAAM;IA+Bf,OAAO,CAAC,aAAa;IAmDrB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAOnC,MAAM,CAAC,aAAa,IAAI,MAAM;IAO9B,MAAM,CAAC,WAAW,IAAI,MAAM;IAO5B,MAAM,CAAC,UAAU,IAAI,MAAM;IAQ3B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,MAAM;CAGrD"}
+{"version":3,"file":"Footer.d.ts","sourceRoot":"","sources":["../../src/elements/Footer.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAKnC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAKtD,KAAK,aAAa,GAAG,SAAS,GAAG,KAAK,CAAC;AAKvC,MAAM,WAAW,gBAAgB;IAE/B,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAKD,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAS;gBAMZ,UAAU,GAAE,gBAAqB;IAQ7C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ5B,SAAS,IAAI,MAAM,GAAG,SAAS;IAO/B,OAAO,IAAI,UAAU;IAQrB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ7B,WAAW,IAAI,MAAM,GAAG,SAAS;IAQjC,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IASxC,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS;IAwBzC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,SAAS;IAW5D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAU5B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK;IASjD,WAAW,IAAI,aAAa,EAAE;IAO9B,eAAe,IAAI,MAAM;IAOzB,KAAK,IAAI,IAAI;IAUb,KAAK,IAAI,MAAM;IA+Bf,OAAO,CAAC,aAAa;IAmDrB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAOnC,MAAM,CAAC,aAAa,IAAI,MAAM;IAO9B,MAAM,CAAC,WAAW,IAAI,MAAM;IAO5B,MAAM,CAAC,UAAU,IAAI,MAAM;IAQ3B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,MAAM;CAGrD"}

package/dist/elements/Footer.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Footer = void 0;
-const Paragraph_1 = require("./Paragraph");
-const Table_1 = require("./Table");
+const Paragraph_js_1 = require("./Paragraph.js");
+const Table_js_1 = require("./Table.js");
 class Footer {
     elements = [];
     type;
@@ -33,7 +33,7 @@ class Footer {
         return this;
     }
     createParagraph(text) {
-        const para = new Paragraph_1.Paragraph();
+        const para = new Paragraph_js_1.Paragraph();
         if (text) {
             para.addText(text);
         }
@@ -41,7 +41,7 @@ class Footer {
         return para;
     }
     addText(text, formatting) {
-        const para = new Paragraph_1.Paragraph();
+        const para = new Paragraph_js_1.Paragraph();
         para.addText(text, formatting);
         this.elements.push(para);
         return para;
@@ -51,7 +51,7 @@ class Footer {
         return this;
     }
     createTable(rows, columns) {
-        const table = new Table_1.Table(rows, columns);
+        const table = new Table_js_1.Table(rows, columns);
         this.elements.push(table);
         return table;
     }

package/dist/elements/Footer.js.map

@@ -1 +1 @@
-{"version":3,"file":"Footer.js","sourceRoot":"","sources":["../../src/elements/Footer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Footer - Represents a document footer\n *\n * Footers appear at the bottom of pages and can contain text, tables, images, and fields.\n * Different footers can be defined for first page, odd pages, and even pages.\n */\n\nimport { XMLElement } from '../xml/XMLBuilder';\nimport { Paragraph } from './Paragraph';\nimport { RunFormatting } from './Run';\nimport { Table } from './Table';\n\n/**\n * Footer type\n */\nexport type FooterType = 'default' | 'first' | 'even';\n\n/**\n * Footer content element\n */\ntype FooterElement = Paragraph | Table;\n\n/**\n * Footer properties\n */\nexport interface FooterProperties {\n  /** Footer type (default, first page, or even page) */\n  type?: FooterType;\n}\n\n/**\n * Represents a document footer\n */\nexport class Footer {\n  private elements: FooterElement[] = [];\n  private type: FooterType;\n  private footerId?: string;\n  private rawXML?: string; // Store original XML for preservation\n\n  /**\n   * Creates a new footer\n   * @param properties Footer properties\n   */\n  constructor(properties: FooterProperties = {}) {\n    this.type = properties.type || 'default';\n  }\n\n  /**\n   * Sets the raw XML content (used when loading existing footers)\n   * @param xml Raw XML content\n   */\n  setRawXML(xml: string): this {\n    this.rawXML = xml;\n    return this;\n  }\n\n  /**\n   * Gets the raw XML content if available\n   */\n  getRawXML(): string | undefined {\n    return this.rawXML;\n  }\n\n  /**\n   * Gets the footer type\n   */\n  getType(): FooterType {\n    return this.type;\n  }\n\n  /**\n   * Sets the footer ID (used for relationships)\n   * @param id Footer ID\n   */\n  setFooterId(id: string): this {\n    this.footerId = id;\n    return this;\n  }\n\n  /**\n   * Gets the footer ID\n   */\n  getFooterId(): string | undefined {\n    return this.footerId;\n  }\n\n  /**\n   * Adds a paragraph to the footer\n   * @param paragraph Paragraph to add\n   */\n  addParagraph(paragraph: Paragraph): this {\n    this.elements.push(paragraph);\n    return this;\n  }\n\n  /**\n   * Creates and adds a new paragraph\n   * @param text Optional text content\n   */\n  createParagraph(text?: string): Paragraph {\n    const para = new Paragraph();\n    if (text) {\n      para.addText(text);\n    }\n    this.elements.push(para);\n    return para;\n  }\n\n  /**\n   * Adds formatted text to the footer as a new paragraph\n   *\n   * Convenience method that creates a paragraph with a single formatted run.\n   *\n   * @param text - Text content\n   * @param formatting - Optional run formatting (bold, font, size, etc.)\n   * @returns The created Paragraph for further customization\n   *\n   * @example\n   * ```typescript\n   * footer.addText('Page ', { size: 8 });\n   * footer.addText('Confidential', { italic: true, color: '888888' });\n   * ```\n   */\n  addText(text: string, formatting?: RunFormatting): Paragraph {\n    const para = new Paragraph();\n    para.addText(text, formatting);\n    this.elements.push(para);\n    return para;\n  }\n\n  /**\n   * Adds a table to the footer\n   * @param table Table to add\n   */\n  addTable(table: Table): this {\n    this.elements.push(table);\n    return this;\n  }\n\n  /**\n   * Creates and adds a new table\n   * @param rows Number of rows\n   * @param columns Number of columns\n   */\n  createTable(rows: number, columns: number): Table {\n    const table = new Table(rows, columns);\n    this.elements.push(table);\n    return table;\n  }\n\n  /**\n   * Gets all elements in the footer\n   */\n  getElements(): FooterElement[] {\n    return [...this.elements];\n  }\n\n  /**\n   * Gets the number of elements\n   */\n  getElementCount(): number {\n    return this.elements.length;\n  }\n\n  /**\n   * Clears all elements and resets raw XML so toXML() regenerates an empty footer\n   */\n  clear(): this {\n    this.elements = [];\n    this.rawXML = undefined;\n    return this;\n  }\n\n  /**\n   * Generates the complete footer XML file content\n   * This creates a complete footer document (footer1.xml, etc.)\n   */\n  toXML(): string {\n    // If we have raw XML preserved from loading, use it\n    if (this.rawXML) {\n      return this.rawXML;\n    }\n\n    // Otherwise generate from elements\n    const elementXmls = this.elements.map((el) => el.toXML());\n\n    let xml = '<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\\n';\n    xml += '<w:ftr xmlns:w=\"http://schemas.openxmlformats.org/wordprocessingml/2006/main\" ';\n    xml += 'xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\">\\n';\n\n    // Add elements\n    for (const element of elementXmls) {\n      xml += this.renderElement(element, 1);\n    }\n\n    // If no elements, add an empty paragraph\n    if (this.elements.length === 0) {\n      xml += '  <w:p/>\\n';\n    }\n\n    xml += '</w:ftr>';\n\n    return xml;\n  }\n\n  /**\n   * Renders an XML element to string with indentation\n   */\n  private renderElement(element: XMLElement, indent: number): string {\n    const spaces = '  '.repeat(indent);\n    let xml = '';\n\n    if (element.selfClosing) {\n      xml += `${spaces}<${element.name}`;\n      if (element.attributes) {\n        for (const [key, value] of Object.entries(element.attributes)) {\n          xml += ` ${key}=\"${value}\"`;\n        }\n      }\n      xml += '/>\\n';\n    } else {\n      xml += `${spaces}<${element.name}`;\n      if (element.attributes) {\n        for (const [key, value] of Object.entries(element.attributes)) {\n          xml += ` ${key}=\"${value}\"`;\n        }\n      }\n      xml += '>';\n\n      if (element.children && element.children.length > 0) {\n        const hasOnlyText = element.children.every((c) => typeof c === 'string');\n\n        if (hasOnlyText) {\n          // Inline text content\n          xml += element.children.join('');\n        } else {\n          // Block-level children\n          xml += '\\n';\n          for (const child of element.children) {\n            if (typeof child === 'string') {\n              xml += spaces + '  ' + child + '\\n';\n            } else {\n              xml += this.renderElement(child, indent + 1);\n            }\n          }\n          xml += spaces;\n        }\n      }\n\n      xml += `</${element.name}>\\n`;\n    }\n\n    return xml;\n  }\n\n  /**\n   * Gets the filename for this footer\n   * @param number Footer number (1, 2, 3, etc.)\n   */\n  getFilename(number: number): string {\n    return `footer${number}.xml`;\n  }\n\n  /**\n   * Creates a default footer\n   */\n  static createDefault(): Footer {\n    return new Footer({ type: 'default' });\n  }\n\n  /**\n   * Creates a first page footer\n   */\n  static createFirst(): Footer {\n    return new Footer({ type: 'first' });\n  }\n\n  /**\n   * Creates an even page footer\n   */\n  static createEven(): Footer {\n    return new Footer({ type: 'even' });\n  }\n\n  /**\n   * Creates a footer with properties\n   * @param properties Footer properties\n   */\n  static create(properties?: FooterProperties): Footer {\n    return new Footer(properties);\n  }\n}\n"]}
+{"version":3,"file":"Footer.js","sourceRoot":"","sources":["../../src/elements/Footer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Footer - Represents a document footer\n *\n * Footers appear at the bottom of pages and can contain text, tables, images, and fields.\n * Different footers can be defined for first page, odd pages, and even pages.\n */\n\nimport { XMLElement } from '../xml/XMLBuilder.js';\nimport { Paragraph } from './Paragraph.js';\nimport { RunFormatting } from './Run.js';\nimport { Table } from './Table.js';\n\n/**\n * Footer type\n */\nexport type FooterType = 'default' | 'first' | 'even';\n\n/**\n * Footer content element\n */\ntype FooterElement = Paragraph | Table;\n\n/**\n * Footer properties\n */\nexport interface FooterProperties {\n  /** Footer type (default, first page, or even page) */\n  type?: FooterType;\n}\n\n/**\n * Represents a document footer\n */\nexport class Footer {\n  private elements: FooterElement[] = [];\n  private type: FooterType;\n  private footerId?: string;\n  private rawXML?: string; // Store original XML for preservation\n\n  /**\n   * Creates a new footer\n   * @param properties Footer properties\n   */\n  constructor(properties: FooterProperties = {}) {\n    this.type = properties.type || 'default';\n  }\n\n  /**\n   * Sets the raw XML content (used when loading existing footers)\n   * @param xml Raw XML content\n   */\n  setRawXML(xml: string): this {\n    this.rawXML = xml;\n    return this;\n  }\n\n  /**\n   * Gets the raw XML content if available\n   */\n  getRawXML(): string | undefined {\n    return this.rawXML;\n  }\n\n  /**\n   * Gets the footer type\n   */\n  getType(): FooterType {\n    return this.type;\n  }\n\n  /**\n   * Sets the footer ID (used for relationships)\n   * @param id Footer ID\n   */\n  setFooterId(id: string): this {\n    this.footerId = id;\n    return this;\n  }\n\n  /**\n   * Gets the footer ID\n   */\n  getFooterId(): string | undefined {\n    return this.footerId;\n  }\n\n  /**\n   * Adds a paragraph to the footer\n   * @param paragraph Paragraph to add\n   */\n  addParagraph(paragraph: Paragraph): this {\n    this.elements.push(paragraph);\n    return this;\n  }\n\n  /**\n   * Creates and adds a new paragraph\n   * @param text Optional text content\n   */\n  createParagraph(text?: string): Paragraph {\n    const para = new Paragraph();\n    if (text) {\n      para.addText(text);\n    }\n    this.elements.push(para);\n    return para;\n  }\n\n  /**\n   * Adds formatted text to the footer as a new paragraph\n   *\n   * Convenience method that creates a paragraph with a single formatted run.\n   *\n   * @param text - Text content\n   * @param formatting - Optional run formatting (bold, font, size, etc.)\n   * @returns The created Paragraph for further customization\n   *\n   * @example\n   * ```typescript\n   * footer.addText('Page ', { size: 8 });\n   * footer.addText('Confidential', { italic: true, color: '888888' });\n   * ```\n   */\n  addText(text: string, formatting?: RunFormatting): Paragraph {\n    const para = new Paragraph();\n    para.addText(text, formatting);\n    this.elements.push(para);\n    return para;\n  }\n\n  /**\n   * Adds a table to the footer\n   * @param table Table to add\n   */\n  addTable(table: Table): this {\n    this.elements.push(table);\n    return this;\n  }\n\n  /**\n   * Creates and adds a new table\n   * @param rows Number of rows\n   * @param columns Number of columns\n   */\n  createTable(rows: number, columns: number): Table {\n    const table = new Table(rows, columns);\n    this.elements.push(table);\n    return table;\n  }\n\n  /**\n   * Gets all elements in the footer\n   */\n  getElements(): FooterElement[] {\n    return [...this.elements];\n  }\n\n  /**\n   * Gets the number of elements\n   */\n  getElementCount(): number {\n    return this.elements.length;\n  }\n\n  /**\n   * Clears all elements and resets raw XML so toXML() regenerates an empty footer\n   */\n  clear(): this {\n    this.elements = [];\n    this.rawXML = undefined;\n    return this;\n  }\n\n  /**\n   * Generates the complete footer XML file content\n   * This creates a complete footer document (footer1.xml, etc.)\n   */\n  toXML(): string {\n    // If we have raw XML preserved from loading, use it\n    if (this.rawXML) {\n      return this.rawXML;\n    }\n\n    // Otherwise generate from elements\n    const elementXmls = this.elements.map((el) => el.toXML());\n\n    let xml = '<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\\n';\n    xml += '<w:ftr xmlns:w=\"http://schemas.openxmlformats.org/wordprocessingml/2006/main\" ';\n    xml += 'xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\">\\n';\n\n    // Add elements\n    for (const element of elementXmls) {\n      xml += this.renderElement(element, 1);\n    }\n\n    // If no elements, add an empty paragraph\n    if (this.elements.length === 0) {\n      xml += '  <w:p/>\\n';\n    }\n\n    xml += '</w:ftr>';\n\n    return xml;\n  }\n\n  /**\n   * Renders an XML element to string with indentation\n   */\n  private renderElement(element: XMLElement, indent: number): string {\n    const spaces = '  '.repeat(indent);\n    let xml = '';\n\n    if (element.selfClosing) {\n      xml += `${spaces}<${element.name}`;\n      if (element.attributes) {\n        for (const [key, value] of Object.entries(element.attributes)) {\n          xml += ` ${key}=\"${value}\"`;\n        }\n      }\n      xml += '/>\\n';\n    } else {\n      xml += `${spaces}<${element.name}`;\n      if (element.attributes) {\n        for (const [key, value] of Object.entries(element.attributes)) {\n          xml += ` ${key}=\"${value}\"`;\n        }\n      }\n      xml += '>';\n\n      if (element.children && element.children.length > 0) {\n        const hasOnlyText = element.children.every((c) => typeof c === 'string');\n\n        if (hasOnlyText) {\n          // Inline text content\n          xml += element.children.join('');\n        } else {\n          // Block-level children\n          xml += '\\n';\n          for (const child of element.children) {\n            if (typeof child === 'string') {\n              xml += spaces + '  ' + child + '\\n';\n            } else {\n              xml += this.renderElement(child, indent + 1);\n            }\n          }\n          xml += spaces;\n        }\n      }\n\n      xml += `</${element.name}>\\n`;\n    }\n\n    return xml;\n  }\n\n  /**\n   * Gets the filename for this footer\n   * @param number Footer number (1, 2, 3, etc.)\n   */\n  getFilename(number: number): string {\n    return `footer${number}.xml`;\n  }\n\n  /**\n   * Creates a default footer\n   */\n  static createDefault(): Footer {\n    return new Footer({ type: 'default' });\n  }\n\n  /**\n   * Creates a first page footer\n   */\n  static createFirst(): Footer {\n    return new Footer({ type: 'first' });\n  }\n\n  /**\n   * Creates an even page footer\n   */\n  static createEven(): Footer {\n    return new Footer({ type: 'even' });\n  }\n\n  /**\n   * Creates a footer with properties\n   * @param properties Footer properties\n   */\n  static create(properties?: FooterProperties): Footer {\n    return new Footer(properties);\n  }\n}\n"]}

package/dist/elements/Footnote.d.ts

@@ -1,5 +1,5 @@
-import { Paragraph } from './Paragraph';
-import { XMLElement } from '../xml/XMLBuilder';
+import { Paragraph } from './Paragraph.js';
+import { XMLElement } from '../xml/XMLBuilder.js';
 export declare enum FootnoteType {
     Normal = "normal",
     Separator = "separator",

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

@@ -1 +1 @@
-{"version":3,"file":"Footnote.d.ts","sourceRoot":"","sources":["../../src/elements/Footnote.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAc,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAK3D,oBAAY,YAAY;IAEtB,MAAM,WAAW;IAEjB,SAAS,cAAc;IAEvB,qBAAqB,0BAA0B;IAE/C,kBAAkB,uBAAuB;CAC1C;AAKD,MAAM,WAAW,kBAAkB;IAEjC,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,CAAC,EAAE,YAAY,CAAC;IAEpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,qBAAa,QAAQ;IACnB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAmB;gBAMzB,UAAU,EAAE,kBAAkB;IAS1C,KAAK,IAAI,MAAM;IAOf,OAAO,IAAI,YAAY;IAOvB,aAAa,IAAI,MAAM,GAAG,SAAS;IAQnC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASjC,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAUxC,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS;IAYzC,aAAa,IAAI,SAAS,EAAE;IAO5B,OAAO,IAAI,MAAM;IAOjB,KAAK,IAAI,UAAU;IA+CnB,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ;IAWnD,MAAM,CAAC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ;IAgB5C,MAAM,CAAC,2BAA2B,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ;IAaxD,MAAM,CAAC,wBAAwB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,SAAiB,GAAG,QAAQ;CAQ7E"}
+{"version":3,"file":"Footnote.d.ts","sourceRoot":"","sources":["../../src/elements/Footnote.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAc,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAK9D,oBAAY,YAAY;IAEtB,MAAM,WAAW;IAEjB,SAAS,cAAc;IAEvB,qBAAqB,0BAA0B;IAE/C,kBAAkB,uBAAuB;CAC1C;AAKD,MAAM,WAAW,kBAAkB;IAEjC,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,CAAC,EAAE,YAAY,CAAC;IAEpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,qBAAa,QAAQ;IACnB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAmB;gBAMzB,UAAU,EAAE,kBAAkB;IAS1C,KAAK,IAAI,MAAM;IAOf,OAAO,IAAI,YAAY;IAOvB,aAAa,IAAI,MAAM,GAAG,SAAS;IAQnC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASjC,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAUxC,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS;IAYzC,aAAa,IAAI,SAAS,EAAE;IAO5B,OAAO,IAAI,MAAM;IAOjB,KAAK,IAAI,UAAU;IA+CnB,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ;IAWnD,MAAM,CAAC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ;IAgB5C,MAAM,CAAC,2BAA2B,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ;IAaxD,MAAM,CAAC,wBAAwB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,SAAiB,GAAG,QAAQ;CAQ7E"}

package/dist/elements/Footnote.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Footnote = exports.FootnoteType = void 0;
-const Paragraph_1 = require("./Paragraph");
-const XMLBuilder_1 = require("../xml/XMLBuilder");
+const Paragraph_js_1 = require("./Paragraph.js");
+const XMLBuilder_js_1 = require("../xml/XMLBuilder.js");
 var FootnoteType;
 (function (FootnoteType) {
     FootnoteType["Normal"] = "normal";
@@ -38,7 +38,7 @@ class Footnote {
         return this;
     }
     createParagraph(text) {
-        const para = new Paragraph_1.Paragraph();
+        const para = new Paragraph_js_1.Paragraph();
         if (text) {
             para.addText(text);
         }
@@ -60,13 +60,13 @@ class Footnote {
         }
         const children = [];
         if (this.type === FootnoteType.Separator) {
-            children.push(XMLBuilder_1.XMLBuilder.w('p', undefined, [
-                XMLBuilder_1.XMLBuilder.w('r', undefined, [XMLBuilder_1.XMLBuilder.wSelf('separator')]),
+            children.push(XMLBuilder_js_1.XMLBuilder.w('p', undefined, [
+                XMLBuilder_js_1.XMLBuilder.w('r', undefined, [XMLBuilder_js_1.XMLBuilder.wSelf('separator')]),
             ]));
         }
         else if (this.type === FootnoteType.ContinuationSeparator) {
-            children.push(XMLBuilder_1.XMLBuilder.w('p', undefined, [
-                XMLBuilder_1.XMLBuilder.w('r', undefined, [XMLBuilder_1.XMLBuilder.wSelf('continuationSeparator')]),
+            children.push(XMLBuilder_js_1.XMLBuilder.w('p', undefined, [
+                XMLBuilder_js_1.XMLBuilder.w('r', undefined, [XMLBuilder_js_1.XMLBuilder.wSelf('continuationSeparator')]),
             ]));
         }
         else {
@@ -74,10 +74,10 @@ class Footnote {
                 children.push(para.toXML());
             }
             if (children.length === 0) {
-                children.push(XMLBuilder_1.XMLBuilder.w('p'));
+                children.push(XMLBuilder_js_1.XMLBuilder.w('p'));
             }
         }
-        return XMLBuilder_1.XMLBuilder.w('footnote', attrs, children);
+        return XMLBuilder_js_1.XMLBuilder.w('footnote', attrs, children);
     }
     static fromText(id, text) {
         const footnote = new Footnote({ id });

package/dist/elements/Footnote.js.map

@@ -1 +1 @@
-{"version":3,"file":"Footnote.js","sourceRoot":"","sources":["../../src/elements/Footnote.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Footnote - Represents a footnote in a Word document\n *\n * Footnotes appear at the bottom of the page and are referenced\n * within the document text via footnote references.\n */\n\nimport { Paragraph } from './Paragraph';\nimport { XMLBuilder, XMLElement } from '../xml/XMLBuilder';\n\n/**\n * Footnote type\n */\nexport enum FootnoteType {\n  /** Normal footnote */\n  Normal = 'normal',\n  /** Separator between document text and footnotes */\n  Separator = 'separator',\n  /** Continuation separator for footnotes that continue to next page */\n  ContinuationSeparator = 'continuationSeparator',\n  /** Continuation notice at bottom of page when footnotes continue */\n  ContinuationNotice = 'continuationNotice',\n}\n\n/**\n * Footnote properties\n */\nexport interface FootnoteProperties {\n  /** Footnote ID (required, must be unique) */\n  id: number;\n  /** Type of footnote */\n  type?: FootnoteType;\n  /** Custom mark/symbol (optional, otherwise uses numbering) */\n  customMark?: string;\n}\n\n/**\n * Represents a footnote in a document\n */\nexport class Footnote {\n  private id: number;\n  private type: FootnoteType;\n  private customMark?: string;\n  private paragraphs: Paragraph[] = [];\n\n  /**\n   * Creates a new footnote\n   * @param properties Footnote properties\n   */\n  constructor(properties: FootnoteProperties) {\n    this.id = properties.id;\n    this.type = properties.type || FootnoteType.Normal;\n    this.customMark = properties.customMark;\n  }\n\n  /**\n   * Gets the footnote ID\n   */\n  getId(): number {\n    return this.id;\n  }\n\n  /**\n   * Gets the footnote type\n   */\n  getType(): FootnoteType {\n    return this.type;\n  }\n\n  /**\n   * Gets the custom mark\n   */\n  getCustomMark(): string | undefined {\n    return this.customMark;\n  }\n\n  /**\n   * Sets the custom mark\n   * @param mark Custom mark/symbol\n   */\n  setCustomMark(mark: string): this {\n    this.customMark = mark;\n    return this;\n  }\n\n  /**\n   * Adds a paragraph to the footnote\n   * @param paragraph Paragraph to add\n   */\n  addParagraph(paragraph: Paragraph): this {\n    this.paragraphs.push(paragraph);\n    return this;\n  }\n\n  /**\n   * Creates and adds a new paragraph\n   * @param text Optional text content\n   * @returns The created paragraph\n   */\n  createParagraph(text?: string): Paragraph {\n    const para = new Paragraph();\n    if (text) {\n      para.addText(text);\n    }\n    this.paragraphs.push(para);\n    return para;\n  }\n\n  /**\n   * Gets all paragraphs in the footnote\n   */\n  getParagraphs(): Paragraph[] {\n    return [...this.paragraphs];\n  }\n\n  /**\n   * Gets the text content of the footnote\n   */\n  getText(): string {\n    return this.paragraphs.map((p) => p.getText()).join('\\n');\n  }\n\n  /**\n   * Generates the XML for this footnote\n   */\n  toXML(): XMLElement {\n    const attrs: Record<string, any> = {\n      'w:id': this.id.toString(),\n    };\n\n    if (this.type !== FootnoteType.Normal) {\n      attrs['w:type'] = this.type;\n    }\n\n    const children: XMLElement[] = [];\n\n    // Separator types require specific child elements per ECMA-376\n    if (this.type === FootnoteType.Separator) {\n      // <w:p><w:r><w:separator/></w:r></w:p>\n      children.push(\n        XMLBuilder.w('p', undefined, [\n          XMLBuilder.w('r', undefined, [XMLBuilder.wSelf('separator')]),\n        ])\n      );\n    } else if (this.type === FootnoteType.ContinuationSeparator) {\n      // <w:p><w:r><w:continuationSeparator/></w:r></w:p>\n      children.push(\n        XMLBuilder.w('p', undefined, [\n          XMLBuilder.w('r', undefined, [XMLBuilder.wSelf('continuationSeparator')]),\n        ])\n      );\n    } else {\n      // Add paragraphs\n      for (const para of this.paragraphs) {\n        children.push(para.toXML());\n      }\n\n      // If no paragraphs, add an empty one (required)\n      if (children.length === 0) {\n        children.push(XMLBuilder.w('p'));\n      }\n    }\n\n    return XMLBuilder.w('footnote', attrs, children);\n  }\n\n  /**\n   * Creates a footnote from text\n   * @param id Footnote ID\n   * @param text Text content\n   * @returns New footnote instance\n   */\n  static fromText(id: number, text: string): Footnote {\n    const footnote = new Footnote({ id });\n    footnote.createParagraph(text);\n    return footnote;\n  }\n\n  /**\n   * Creates a separator footnote\n   * @param id Footnote ID\n   * @returns New separator footnote\n   */\n  static createSeparator(id: number): Footnote {\n    const footnote = new Footnote({\n      id,\n      type: FootnoteType.Separator,\n    });\n    // Separator typically has a horizontal line\n    footnote.createParagraph();\n    // Add separator formatting if needed\n    return footnote;\n  }\n\n  /**\n   * Creates a continuation separator footnote\n   * @param id Footnote ID\n   * @returns New continuation separator footnote\n   */\n  static createContinuationSeparator(id: number): Footnote {\n    return new Footnote({\n      id,\n      type: FootnoteType.ContinuationSeparator,\n    });\n  }\n\n  /**\n   * Creates a continuation notice footnote\n   * @param id Footnote ID\n   * @param text Notice text (e.g., \"Continued on next page...\")\n   * @returns New continuation notice footnote\n   */\n  static createContinuationNotice(id: number, text = 'Continued...'): Footnote {\n    const footnote = new Footnote({\n      id,\n      type: FootnoteType.ContinuationNotice,\n    });\n    footnote.createParagraph(text);\n    return footnote;\n  }\n}\n"]}
+{"version":3,"file":"Footnote.js","sourceRoot":"","sources":["../../src/elements/Footnote.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Footnote - Represents a footnote in a Word document\n *\n * Footnotes appear at the bottom of the page and are referenced\n * within the document text via footnote references.\n */\n\nimport { Paragraph } from './Paragraph.js';\nimport { XMLBuilder, XMLElement } from '../xml/XMLBuilder.js';\n\n/**\n * Footnote type\n */\nexport enum FootnoteType {\n  /** Normal footnote */\n  Normal = 'normal',\n  /** Separator between document text and footnotes */\n  Separator = 'separator',\n  /** Continuation separator for footnotes that continue to next page */\n  ContinuationSeparator = 'continuationSeparator',\n  /** Continuation notice at bottom of page when footnotes continue */\n  ContinuationNotice = 'continuationNotice',\n}\n\n/**\n * Footnote properties\n */\nexport interface FootnoteProperties {\n  /** Footnote ID (required, must be unique) */\n  id: number;\n  /** Type of footnote */\n  type?: FootnoteType;\n  /** Custom mark/symbol (optional, otherwise uses numbering) */\n  customMark?: string;\n}\n\n/**\n * Represents a footnote in a document\n */\nexport class Footnote {\n  private id: number;\n  private type: FootnoteType;\n  private customMark?: string;\n  private paragraphs: Paragraph[] = [];\n\n  /**\n   * Creates a new footnote\n   * @param properties Footnote properties\n   */\n  constructor(properties: FootnoteProperties) {\n    this.id = properties.id;\n    this.type = properties.type || FootnoteType.Normal;\n    this.customMark = properties.customMark;\n  }\n\n  /**\n   * Gets the footnote ID\n   */\n  getId(): number {\n    return this.id;\n  }\n\n  /**\n   * Gets the footnote type\n   */\n  getType(): FootnoteType {\n    return this.type;\n  }\n\n  /**\n   * Gets the custom mark\n   */\n  getCustomMark(): string | undefined {\n    return this.customMark;\n  }\n\n  /**\n   * Sets the custom mark\n   * @param mark Custom mark/symbol\n   */\n  setCustomMark(mark: string): this {\n    this.customMark = mark;\n    return this;\n  }\n\n  /**\n   * Adds a paragraph to the footnote\n   * @param paragraph Paragraph to add\n   */\n  addParagraph(paragraph: Paragraph): this {\n    this.paragraphs.push(paragraph);\n    return this;\n  }\n\n  /**\n   * Creates and adds a new paragraph\n   * @param text Optional text content\n   * @returns The created paragraph\n   */\n  createParagraph(text?: string): Paragraph {\n    const para = new Paragraph();\n    if (text) {\n      para.addText(text);\n    }\n    this.paragraphs.push(para);\n    return para;\n  }\n\n  /**\n   * Gets all paragraphs in the footnote\n   */\n  getParagraphs(): Paragraph[] {\n    return [...this.paragraphs];\n  }\n\n  /**\n   * Gets the text content of the footnote\n   */\n  getText(): string {\n    return this.paragraphs.map((p) => p.getText()).join('\\n');\n  }\n\n  /**\n   * Generates the XML for this footnote\n   */\n  toXML(): XMLElement {\n    const attrs: Record<string, any> = {\n      'w:id': this.id.toString(),\n    };\n\n    if (this.type !== FootnoteType.Normal) {\n      attrs['w:type'] = this.type;\n    }\n\n    const children: XMLElement[] = [];\n\n    // Separator types require specific child elements per ECMA-376\n    if (this.type === FootnoteType.Separator) {\n      // <w:p><w:r><w:separator/></w:r></w:p>\n      children.push(\n        XMLBuilder.w('p', undefined, [\n          XMLBuilder.w('r', undefined, [XMLBuilder.wSelf('separator')]),\n        ])\n      );\n    } else if (this.type === FootnoteType.ContinuationSeparator) {\n      // <w:p><w:r><w:continuationSeparator/></w:r></w:p>\n      children.push(\n        XMLBuilder.w('p', undefined, [\n          XMLBuilder.w('r', undefined, [XMLBuilder.wSelf('continuationSeparator')]),\n        ])\n      );\n    } else {\n      // Add paragraphs\n      for (const para of this.paragraphs) {\n        children.push(para.toXML());\n      }\n\n      // If no paragraphs, add an empty one (required)\n      if (children.length === 0) {\n        children.push(XMLBuilder.w('p'));\n      }\n    }\n\n    return XMLBuilder.w('footnote', attrs, children);\n  }\n\n  /**\n   * Creates a footnote from text\n   * @param id Footnote ID\n   * @param text Text content\n   * @returns New footnote instance\n   */\n  static fromText(id: number, text: string): Footnote {\n    const footnote = new Footnote({ id });\n    footnote.createParagraph(text);\n    return footnote;\n  }\n\n  /**\n   * Creates a separator footnote\n   * @param id Footnote ID\n   * @returns New separator footnote\n   */\n  static createSeparator(id: number): Footnote {\n    const footnote = new Footnote({\n      id,\n      type: FootnoteType.Separator,\n    });\n    // Separator typically has a horizontal line\n    footnote.createParagraph();\n    // Add separator formatting if needed\n    return footnote;\n  }\n\n  /**\n   * Creates a continuation separator footnote\n   * @param id Footnote ID\n   * @returns New continuation separator footnote\n   */\n  static createContinuationSeparator(id: number): Footnote {\n    return new Footnote({\n      id,\n      type: FootnoteType.ContinuationSeparator,\n    });\n  }\n\n  /**\n   * Creates a continuation notice footnote\n   * @param id Footnote ID\n   * @param text Notice text (e.g., \"Continued on next page...\")\n   * @returns New continuation notice footnote\n   */\n  static createContinuationNotice(id: number, text = 'Continued...'): Footnote {\n    const footnote = new Footnote({\n      id,\n      type: FootnoteType.ContinuationNotice,\n    });\n    footnote.createParagraph(text);\n    return footnote;\n  }\n}\n"]}

package/dist/elements/FootnoteManager.d.ts

@@ -1,4 +1,4 @@
-import { Footnote } from './Footnote';
+import { Footnote } from './Footnote.js';
 export declare class FootnoteManager {
     private footnotes;
     private nextId;

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

@@ -1 +1 @@
-{"version":3,"file":"FootnoteManager.d.ts","sourceRoot":"","sources":["../../src/elements/FootnoteManager.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAOpD,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,MAAM,CAAK;IAMnB,OAAO;IASP,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,iBAAiB;IAYzB,MAAM,CAAC,MAAM,IAAI,eAAe;IAShC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAuBtC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAWtC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAQ7C,eAAe,IAAI,QAAQ,EAAE;IAS7B,0BAA0B,IAAI,QAAQ,EAAE;IAQxC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAShC,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAWnC,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,oBAAoB,IAAI,MAAM;IAwB9B,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAkBtC"}
+{"version":3,"file":"FootnoteManager.d.ts","sourceRoot":"","sources":["../../src/elements/FootnoteManager.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAgB,MAAM,eAAe,CAAC;AAOvD,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,MAAM,CAAK;IAMnB,OAAO;IASP,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,iBAAiB;IAYzB,MAAM,CAAC,MAAM,IAAI,eAAe;IAShC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAuBtC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAWtC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAQ7C,eAAe,IAAI,QAAQ,EAAE;IAS7B,0BAA0B,IAAI,QAAQ,EAAE;IAQxC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAShC,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAWnC,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,oBAAoB,IAAI,MAAM;IAwB9B,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAkBtC"}

package/dist/elements/FootnoteManager.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FootnoteManager = void 0;
-const Footnote_1 = require("./Footnote");
-const XMLBuilder_1 = require("../xml/XMLBuilder");
-const XMLParser_1 = require("../xml/XMLParser");
+const Footnote_js_1 = require("./Footnote.js");
+const XMLBuilder_js_1 = require("../xml/XMLBuilder.js");
+const XMLParser_js_1 = require("../xml/XMLParser.js");
 class FootnoteManager {
     footnotes = new Map();
     nextId = 1;
@@ -11,16 +11,16 @@ class FootnoteManager {
         this.addSpecialFootnotes();
     }
     addSpecialFootnotes() {
-        const separator = Footnote_1.Footnote.createSeparator(-1);
+        const separator = Footnote_js_1.Footnote.createSeparator(-1);
         this.footnotes.set(-1, separator);
-        const continuationSep = Footnote_1.Footnote.createContinuationSeparator(0);
+        const continuationSep = Footnote_js_1.Footnote.createContinuationSeparator(0);
         this.footnotes.set(0, continuationSep);
     }
     isSpecialFootnote(footnote) {
         const type = footnote.getType();
-        return (type === Footnote_1.FootnoteType.Separator ||
-            type === Footnote_1.FootnoteType.ContinuationSeparator ||
-            type === Footnote_1.FootnoteType.ContinuationNotice);
+        return (type === Footnote_js_1.FootnoteType.Separator ||
+            type === Footnote_js_1.FootnoteType.ContinuationSeparator ||
+            type === Footnote_js_1.FootnoteType.ContinuationNotice);
     }
     static create() {
         return new FootnoteManager();
@@ -37,7 +37,7 @@ class FootnoteManager {
         return footnote;
     }
     createFootnote(text) {
-        const footnote = Footnote_1.Footnote.fromText(this.nextId++, text);
+        const footnote = Footnote_js_1.Footnote.fromText(this.nextId++, text);
         this.footnotes.set(footnote.getId(), footnote);
         return footnote;
     }
@@ -101,7 +101,7 @@ class FootnoteManager {
             },
             children: footnotes.map((f) => f.toXML()),
         };
-        const builder = new XMLBuilder_1.XMLBuilder();
+        const builder = new XMLBuilder_js_1.XMLBuilder();
         builder.element(footnotesElement.name, footnotesElement.attributes, footnotesElement.children);
         return builder.build(true);
     }
@@ -109,7 +109,7 @@ class FootnoteManager {
         if (!xml) {
             return false;
         }
-        const footnotesContent = XMLParser_1.XMLParser.extractBetweenTags(xml, '<w:footnotes', '</w:footnotes>');
+        const footnotesContent = XMLParser_js_1.XMLParser.extractBetweenTags(xml, '<w:footnotes', '</w:footnotes>');
         if (!footnotesContent) {
             return false;
         }

package/dist/elements/FootnoteManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"FootnoteManager.js","sourceRoot":"","sources":["../../src/elements/FootnoteManager.ts"],"names":[],"mappings":";;;AAOA,yCAAoD;AACpD,kDAA2D;AAC3D,gDAA6C;AAK7C,MAAa,eAAe;IAClB,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IACxC,MAAM,GAAG,CAAC,CAAC;IAMnB;QAEE,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAMO,mBAAmB;QAEzB,MAAM,SAAS,GAAG,mBAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAGlC,MAAM,eAAe,GAAG,mBAAQ,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IACzC,CAAC;IAQO,iBAAiB,CAAC,QAAkB;QAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;QAChC,OAAO,CACL,IAAI,KAAK,uBAAY,CAAC,SAAS;YAC/B,IAAI,KAAK,uBAAY,CAAC,qBAAqB;YAC3C,IAAI,KAAK,uBAAY,CAAC,kBAAkB,CACzC,CAAC;IACJ,CAAC;IAKD,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC;IAOD,QAAQ,CAAC,QAAkB;QACzB,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;QAG5B,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAGjC,IAAI,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAOD,cAAc,CAAC,IAAY;QACzB,MAAM,QAAQ,GAAG,mBAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;QACxD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC/C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAOD,WAAW,CAAC,EAAU;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAMD,eAAe;QACb,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;aACvC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;aACzC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3C,CAAC;IAKD,0BAA0B;QACxB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,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;IACnF,CAAC;IAMD,WAAW,CAAC,EAAU;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAOD,cAAc,CAAC,EAAU;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAKD,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAKD,QAAQ;QACN,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC;IACvC,CAAC;IAKD,OAAO;QACL,OAAO,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAMD,KAAK;QACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAoB,CAAC;QACrD,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5C,IAAI,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACrC,gBAAgB,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;gBACnC,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;oBACtB,YAAY,GAAG,EAAE,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,gBAAgB,CAAC;QAElC,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,oBAAoB;QAClB,MAAM,SAAS,GAAG,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAGpD,MAAM,gBAAgB,GAAe;YACnC,IAAI,EAAE,aAAa;YACnB,UAAU,EAAE;gBACV,SAAS,EAAE,8DAA8D;gBACzE,SAAS,EAAE,qEAAqE;aACjF;YACD,QAAQ,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;SAC1C,CAAC;QAGF,MAAM,OAAO,GAAG,IAAI,uBAAU,EAAE,CAAC;QACjC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC/F,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,gBAAgB,GAAG,qBAAS,CAAC,kBAAkB,CAAC,GAAG,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC;QAC7F,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,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,0CAuOC","sourcesContent":["/**\n * FootnoteManager - Manages footnotes in a document\n *\n * Handles creation, registration, and XML generation for footnotes.\n * Maintains unique IDs and proper ordering.\n */\n\nimport { Footnote, FootnoteType } from './Footnote';\nimport { XMLBuilder, XMLElement } from '../xml/XMLBuilder';\nimport { XMLParser } from '../xml/XMLParser';\n\n/**\n * Manages footnotes in a document\n */\nexport class FootnoteManager {\n  private footnotes = new Map<number, Footnote>();\n  private nextId = 1;\n\n  /**\n   * Creates a new FootnoteManager\n   * @private Use static factory method\n   */\n  private constructor() {\n    // Add special footnotes (separators) with negative IDs\n    this.addSpecialFootnotes();\n  }\n\n  /**\n   * Adds special footnotes (separator, continuation)\n   * These use negative IDs as per OOXML specification\n   */\n  private addSpecialFootnotes(): void {\n    // Separator footnote (ID -1)\n    const separator = Footnote.createSeparator(-1);\n    this.footnotes.set(-1, separator);\n\n    // Continuation separator (ID 0)\n    const continuationSep = Footnote.createContinuationSeparator(0);\n    this.footnotes.set(0, continuationSep);\n  }\n\n  /**\n   * Checks if a footnote 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 footnote.\n   */\n  private isSpecialFootnote(footnote: Footnote): boolean {\n    const type = footnote.getType();\n    return (\n      type === FootnoteType.Separator ||\n      type === FootnoteType.ContinuationSeparator ||\n      type === FootnoteType.ContinuationNotice\n    );\n  }\n\n  /**\n   * Creates a new FootnoteManager instance\n   */\n  static create(): FootnoteManager {\n    return new FootnoteManager();\n  }\n\n  /**\n   * Registers a footnote\n   * @param footnote Footnote to register\n   * @returns The registered footnote\n   */\n  register(footnote: Footnote): Footnote {\n    const id = footnote.getId();\n\n    // Ensure ID is not already used (except for special footnotes)\n    if (id > 0 && this.footnotes.has(id)) {\n      throw new Error(`Footnote with ID ${id} already exists`);\n    }\n\n    this.footnotes.set(id, footnote);\n\n    // Update next ID if needed\n    if (id >= this.nextId) {\n      this.nextId = id + 1;\n    }\n\n    return footnote;\n  }\n\n  /**\n   * Creates and registers a new footnote\n   * @param text Footnote text\n   * @returns The created footnote\n   */\n  createFootnote(text: string): Footnote {\n    const footnote = Footnote.fromText(this.nextId++, text);\n    this.footnotes.set(footnote.getId(), footnote);\n    return footnote;\n  }\n\n  /**\n   * Gets a footnote by ID\n   * @param id Footnote ID\n   * @returns The footnote, or undefined if not found\n   */\n  getFootnote(id: number): Footnote | undefined {\n    return this.footnotes.get(id);\n  }\n\n  /**\n   * Gets all user footnotes (excluding special system types: separator,\n   * continuationSeparator, continuationNotice)\n   */\n  getAllFootnotes(): Footnote[] {\n    return Array.from(this.footnotes.values())\n      .filter((f) => !this.isSpecialFootnote(f))\n      .sort((a, b) => a.getId() - b.getId());\n  }\n\n  /**\n   * Gets all footnotes including special ones\n   */\n  getAllFootnotesWithSpecial(): Footnote[] {\n    return Array.from(this.footnotes.values()).sort((a, b) => a.getId() - b.getId());\n  }\n\n  /**\n   * Checks if a footnote exists\n   * @param id Footnote ID\n   */\n  hasFootnote(id: number): boolean {\n    return this.footnotes.has(id);\n  }\n\n  /**\n   * Removes a footnote\n   * @param id Footnote ID\n   * @returns True if removed, false if not found or if it's a special type\n   */\n  removeFootnote(id: number): boolean {\n    const footnote = this.footnotes.get(id);\n    if (!footnote || this.isSpecialFootnote(footnote)) {\n      return false;\n    }\n    return this.footnotes.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 footnotes (excluding special ones)\n   */\n  getCount(): number {\n    return this.getAllFootnotes().length;\n  }\n\n  /**\n   * Checks if there are any footnotes (excluding special ones)\n   */\n  isEmpty(): boolean {\n    return this.getCount() === 0;\n  }\n\n  /**\n   * Clears all user footnotes (preserves special system types: separator,\n   * continuationSeparator, continuationNotice)\n   */\n  clear(): void {\n    const specialFootnotes = new Map<number, Footnote>();\n    let maxSpecialId = 0;\n\n    for (const [id, footnote] of this.footnotes) {\n      if (this.isSpecialFootnote(footnote)) {\n        specialFootnotes.set(id, footnote);\n        if (id > maxSpecialId) {\n          maxSpecialId = id;\n        }\n      }\n    }\n\n    this.footnotes = specialFootnotes;\n    // Ensure nextId doesn't collide with special footnotes that have positive IDs\n    this.nextId = Math.max(maxSpecialId + 1, 1);\n  }\n\n  /**\n   * Gets statistics about footnotes\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 footnotes.xml content\n   */\n  generateFootnotesXml(): string {\n    const footnotes = this.getAllFootnotesWithSpecial();\n\n    // Build footnotes element\n    const footnotesElement: XMLElement = {\n      name: 'w:footnotes',\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: footnotes.map((f) => f.toXML()),\n    };\n\n    // Build XML using XMLBuilder\n    const builder = new XMLBuilder();\n    builder.element(footnotesElement.name, footnotesElement.attributes, footnotesElement.children);\n    return builder.build(true);\n  }\n\n  /**\n   * Validates footnotes 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 footnotesContent = XMLParser.extractBetweenTags(xml, '<w:footnotes', '</w:footnotes>');\n    if (!footnotesContent) {\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":"FootnoteManager.js","sourceRoot":"","sources":["../../src/elements/FootnoteManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * FootnoteManager - Manages footnotes in a document\n *\n * Handles creation, registration, and XML generation for footnotes.\n * Maintains unique IDs and proper ordering.\n */\n\nimport { Footnote, FootnoteType } from './Footnote.js';\nimport { XMLBuilder, XMLElement } from '../xml/XMLBuilder.js';\nimport { XMLParser } from '../xml/XMLParser.js';\n\n/**\n * Manages footnotes in a document\n */\nexport class FootnoteManager {\n  private footnotes = new Map<number, Footnote>();\n  private nextId = 1;\n\n  /**\n   * Creates a new FootnoteManager\n   * @private Use static factory method\n   */\n  private constructor() {\n    // Add special footnotes (separators) with negative IDs\n    this.addSpecialFootnotes();\n  }\n\n  /**\n   * Adds special footnotes (separator, continuation)\n   * These use negative IDs as per OOXML specification\n   */\n  private addSpecialFootnotes(): void {\n    // Separator footnote (ID -1)\n    const separator = Footnote.createSeparator(-1);\n    this.footnotes.set(-1, separator);\n\n    // Continuation separator (ID 0)\n    const continuationSep = Footnote.createContinuationSeparator(0);\n    this.footnotes.set(0, continuationSep);\n  }\n\n  /**\n   * Checks if a footnote 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 footnote.\n   */\n  private isSpecialFootnote(footnote: Footnote): boolean {\n    const type = footnote.getType();\n    return (\n      type === FootnoteType.Separator ||\n      type === FootnoteType.ContinuationSeparator ||\n      type === FootnoteType.ContinuationNotice\n    );\n  }\n\n  /**\n   * Creates a new FootnoteManager instance\n   */\n  static create(): FootnoteManager {\n    return new FootnoteManager();\n  }\n\n  /**\n   * Registers a footnote\n   * @param footnote Footnote to register\n   * @returns The registered footnote\n   */\n  register(footnote: Footnote): Footnote {\n    const id = footnote.getId();\n\n    // Ensure ID is not already used (except for special footnotes)\n    if (id > 0 && this.footnotes.has(id)) {\n      throw new Error(`Footnote with ID ${id} already exists`);\n    }\n\n    this.footnotes.set(id, footnote);\n\n    // Update next ID if needed\n    if (id >= this.nextId) {\n      this.nextId = id + 1;\n    }\n\n    return footnote;\n  }\n\n  /**\n   * Creates and registers a new footnote\n   * @param text Footnote text\n   * @returns The created footnote\n   */\n  createFootnote(text: string): Footnote {\n    const footnote = Footnote.fromText(this.nextId++, text);\n    this.footnotes.set(footnote.getId(), footnote);\n    return footnote;\n  }\n\n  /**\n   * Gets a footnote by ID\n   * @param id Footnote ID\n   * @returns The footnote, or undefined if not found\n   */\n  getFootnote(id: number): Footnote | undefined {\n    return this.footnotes.get(id);\n  }\n\n  /**\n   * Gets all user footnotes (excluding special system types: separator,\n   * continuationSeparator, continuationNotice)\n   */\n  getAllFootnotes(): Footnote[] {\n    return Array.from(this.footnotes.values())\n      .filter((f) => !this.isSpecialFootnote(f))\n      .sort((a, b) => a.getId() - b.getId());\n  }\n\n  /**\n   * Gets all footnotes including special ones\n   */\n  getAllFootnotesWithSpecial(): Footnote[] {\n    return Array.from(this.footnotes.values()).sort((a, b) => a.getId() - b.getId());\n  }\n\n  /**\n   * Checks if a footnote exists\n   * @param id Footnote ID\n   */\n  hasFootnote(id: number): boolean {\n    return this.footnotes.has(id);\n  }\n\n  /**\n   * Removes a footnote\n   * @param id Footnote ID\n   * @returns True if removed, false if not found or if it's a special type\n   */\n  removeFootnote(id: number): boolean {\n    const footnote = this.footnotes.get(id);\n    if (!footnote || this.isSpecialFootnote(footnote)) {\n      return false;\n    }\n    return this.footnotes.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 footnotes (excluding special ones)\n   */\n  getCount(): number {\n    return this.getAllFootnotes().length;\n  }\n\n  /**\n   * Checks if there are any footnotes (excluding special ones)\n   */\n  isEmpty(): boolean {\n    return this.getCount() === 0;\n  }\n\n  /**\n   * Clears all user footnotes (preserves special system types: separator,\n   * continuationSeparator, continuationNotice)\n   */\n  clear(): void {\n    const specialFootnotes = new Map<number, Footnote>();\n    let maxSpecialId = 0;\n\n    for (const [id, footnote] of this.footnotes) {\n      if (this.isSpecialFootnote(footnote)) {\n        specialFootnotes.set(id, footnote);\n        if (id > maxSpecialId) {\n          maxSpecialId = id;\n        }\n      }\n    }\n\n    this.footnotes = specialFootnotes;\n    // Ensure nextId doesn't collide with special footnotes that have positive IDs\n    this.nextId = Math.max(maxSpecialId + 1, 1);\n  }\n\n  /**\n   * Gets statistics about footnotes\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 footnotes.xml content\n   */\n  generateFootnotesXml(): string {\n    const footnotes = this.getAllFootnotesWithSpecial();\n\n    // Build footnotes element\n    const footnotesElement: XMLElement = {\n      name: 'w:footnotes',\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: footnotes.map((f) => f.toXML()),\n    };\n\n    // Build XML using XMLBuilder\n    const builder = new XMLBuilder();\n    builder.element(footnotesElement.name, footnotesElement.attributes, footnotesElement.children);\n    return builder.build(true);\n  }\n\n  /**\n   * Validates footnotes 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 footnotesContent = XMLParser.extractBetweenTags(xml, '<w:footnotes', '</w:footnotes>');\n    if (!footnotesContent) {\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/Header.d.ts

@@ -1,6 +1,6 @@
-import { Paragraph } from './Paragraph';
-import { RunFormatting } from './Run';
-import { Table } from './Table';
+import { Paragraph } from './Paragraph.js';
+import { RunFormatting } from './Run.js';
+import { Table } from './Table.js';
 export type HeaderType = 'default' | 'first' | 'even';
 type HeaderElement = Paragraph | Table;
 export interface HeaderProperties {

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

@@ -1 +1 @@
-{"version":3,"file":"Header.d.ts","sourceRoot":"","sources":["../../src/elements/Header.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAKhC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAKtD,KAAK,aAAa,GAAG,SAAS,GAAG,KAAK,CAAC;AAKvC,MAAM,WAAW,gBAAgB;IAE/B,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAKD,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAS;gBAMZ,UAAU,GAAE,gBAAqB;IAQ7C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ5B,SAAS,IAAI,MAAM,GAAG,SAAS;IAO/B,OAAO,IAAI,UAAU;IAQrB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ7B,WAAW,IAAI,MAAM,GAAG,SAAS;IAQjC,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IASxC,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS;IA0BzC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,SAAS;IAW5D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAU5B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK;IASjD,WAAW,IAAI,aAAa,EAAE;IAO9B,eAAe,IAAI,MAAM;IAOzB,KAAK,IAAI,IAAI;IAUb,KAAK,IAAI,MAAM;IA+Bf,OAAO,CAAC,aAAa;IAmDrB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAOnC,MAAM,CAAC,aAAa,IAAI,MAAM;IAO9B,MAAM,CAAC,WAAW,IAAI,MAAM;IAO5B,MAAM,CAAC,UAAU,IAAI,MAAM;IAQ3B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,MAAM;CAGrD"}
+{"version":3,"file":"Header.d.ts","sourceRoot":"","sources":["../../src/elements/Header.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAKnC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAKtD,KAAK,aAAa,GAAG,SAAS,GAAG,KAAK,CAAC;AAKvC,MAAM,WAAW,gBAAgB;IAE/B,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAKD,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAS;gBAMZ,UAAU,GAAE,gBAAqB;IAQ7C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ5B,SAAS,IAAI,MAAM,GAAG,SAAS;IAO/B,OAAO,IAAI,UAAU;IAQrB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ7B,WAAW,IAAI,MAAM,GAAG,SAAS;IAQjC,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IASxC,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS;IA0BzC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,SAAS;IAW5D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAU5B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK;IASjD,WAAW,IAAI,aAAa,EAAE;IAO9B,eAAe,IAAI,MAAM;IAOzB,KAAK,IAAI,IAAI;IAUb,KAAK,IAAI,MAAM;IA+Bf,OAAO,CAAC,aAAa;IAmDrB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAOnC,MAAM,CAAC,aAAa,IAAI,MAAM;IAO9B,MAAM,CAAC,WAAW,IAAI,MAAM;IAO5B,MAAM,CAAC,UAAU,IAAI,MAAM;IAQ3B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,MAAM;CAGrD"}

package/dist/elements/Header.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Header = void 0;
-const Paragraph_1 = require("./Paragraph");
-const Table_1 = require("./Table");
+const Paragraph_js_1 = require("./Paragraph.js");
+const Table_js_1 = require("./Table.js");
 class Header {
     elements = [];
     type;
@@ -33,7 +33,7 @@ class Header {
         return this;
     }
     createParagraph(text) {
-        const para = new Paragraph_1.Paragraph();
+        const para = new Paragraph_js_1.Paragraph();
         if (text) {
             para.addText(text);
         }
@@ -41,7 +41,7 @@ class Header {
         return para;
     }
     addText(text, formatting) {
-        const para = new Paragraph_1.Paragraph();
+        const para = new Paragraph_js_1.Paragraph();
         para.addText(text, formatting);
         this.elements.push(para);
         return para;
@@ -51,7 +51,7 @@ class Header {
         return this;
     }
     createTable(rows, columns) {
-        const table = new Table_1.Table(rows, columns);
+        const table = new Table_js_1.Table(rows, columns);
         this.elements.push(table);
         return table;
     }