docx 9.2.0 → 9.4.0

package/dist/index.mjs

@@ -9374,32 +9374,59 @@ class BordersAttributes extends XmlAttributeComponent {
   }
 }
 const BorderStyle = {
+  /** a single line */
   SINGLE: "single",
+  /** a line with a series of alternating thin and thick strokes */
   DASH_DOT_STROKED: "dashDotStroked",
+  /** a dashed line */
   DASHED: "dashed",
+  /** a dashed line with small gaps */
   DASH_SMALL_GAP: "dashSmallGap",
+  /** a line with alternating dots and dashes */
   DOT_DASH: "dotDash",
+  /** a line with a repeating dot - dot - dash sequence */
   DOT_DOT_DASH: "dotDotDash",
+  /** a dotted line */
   DOTTED: "dotted",
+  /** a double line */
   DOUBLE: "double",
+  /** a double wavy line */
   DOUBLE_WAVE: "doubleWave",
+  /** an inset set of lines */
   INSET: "inset",
+  /** no border */
   NIL: "nil",
+  /** no border */
   NONE: "none",
+  /** an outset set of lines */
   OUTSET: "outset",
+  /** a single line */
   THICK: "thick",
+  /** a thick line contained within a thin line with a large-sized intermediate gap */
   THICK_THIN_LARGE_GAP: "thickThinLargeGap",
+  /** a thick line contained within a thin line with a medium-sized intermediate gap */
   THICK_THIN_MEDIUM_GAP: "thickThinMediumGap",
+  /** a thick line contained within a thin line with a small intermediate gap */
   THICK_THIN_SMALL_GAP: "thickThinSmallGap",
+  /** a thin line contained within a thick line with a large-sized intermediate gap */
   THIN_THICK_LARGE_GAP: "thinThickLargeGap",
+  /** a thick line contained within a thin line with a medium-sized intermediate gap */
   THIN_THICK_MEDIUM_GAP: "thinThickMediumGap",
+  /** a thick line contained within a thin line with a small intermediate gap */
   THIN_THICK_SMALL_GAP: "thinThickSmallGap",
+  /** a thin-thick-thin line with a large gap */
   THIN_THICK_THIN_LARGE_GAP: "thinThickThinLargeGap",
+  /** a thin-thick-thin line with a medium gap */
   THIN_THICK_THIN_MEDIUM_GAP: "thinThickThinMediumGap",
+  /** a thin-thick-thin line with a small gap */
   THIN_THICK_THIN_SMALL_GAP: "thinThickThinSmallGap",
+  /** a three-staged gradient line, getting darker towards the paragraph */
   THREE_D_EMBOSS: "threeDEmboss",
+  /** a three-staged gradient like, getting darker away from the paragraph */
   THREE_D_ENGRAVE: "threeDEngrave",
+  /** a triple line */
   TRIPLE: "triple",
+  /** a wavy line */
   WAVE: "wave"
 };
 class Border extends IgnoreIfEmptyXmlComponent {
@@ -11799,107 +11826,157 @@ const hashedId = (data) => hash.sha1().update(data instanceof ArrayBuffer ? new
 const generateUuidPart = (count) => customAlphabet("1234567890abcdef", count)();
 const uniqueUuid = () => `${generateUuidPart(8)}-${generateUuidPart(4)}-${generateUuidPart(4)}-${generateUuidPart(4)}-${generateUuidPart(12)}`;
 const HorizontalPositionRelativeFrom = {
+  /**
+   * ## Character
+   *
+   * Specifies that the horizontal positioning shall be relative to the position of the anchor within its run content.
+   */
   CHARACTER: "character",
+  /**
+   * ## Column
+   *
+   * Specifies that the horizontal positioning shall be relative to the extents of the column which contains its anchor.
+   */
   COLUMN: "column",
+  /**
+   * ## Inside Margin
+   *
+   * Specifies that the horizontal positioning shall be relative to the inside margin of the current page (the left margin on odd pages, right on even pages).
+   */
   INSIDE_MARGIN: "insideMargin",
+  /**
+   * ## Left Margin
+   *
+   * Specifies that the horizontal positioning shall be relative to the left margin of the page.
+   */
   LEFT_MARGIN: "leftMargin",
+  /**
+   * ## Page Margin
+   *
+   * Specifies that the horizontal positioning shall be relative to the page margins.
+   */
   MARGIN: "margin",
+  /**
+   * ## Outside Margin
+   *
+   * Specifies that the horizontal positioning shall be relative to the outside margin of the current page (the right margin on odd pages, left on even pages).
+   */
   OUTSIDE_MARGIN: "outsideMargin",
+  /**
+   * ## Page Edge
+   *
+   * Specifies that the horizontal positioning shall be relative to the edge of the page.
+   */
   PAGE: "page",
+  /**
+   * ## Right Margin
+   *
+   * Specifies that the horizontal positioning shall be relative to the right margin of the page.
+   */
   RIGHT_MARGIN: "rightMargin"
 };
 const VerticalPositionRelativeFrom = {
+  /**
+   * ## Bottom Margin
+   *
+   * Specifies that the vertical positioning shall be relative to the bottom margin of the current page.
+   */
   BOTTOM_MARGIN: "bottomMargin",
+  /**
+   * ## Inside Margin
+   *
+   * Specifies that the vertical positioning shall be relative to the inside margin of the current page.
+   */
   INSIDE_MARGIN: "insideMargin",
+  /**
+   * ## Line
+   *
+   * Specifies that the vertical positioning shall be relative to the line containing the anchor character.
+   */
   LINE: "line",
+  /**
+   * ## Page Margin
+   *
+   * Specifies that the vertical positioning shall be relative to the page margins.
+   */
   MARGIN: "margin",
+  /**
+   * ## Outside Margin
+   *
+   * Specifies that the vertical positioning shall be relative to the outside margin of the current page.
+   */
   OUTSIDE_MARGIN: "outsideMargin",
+  /**
+   * ## Page Edge
+   *
+   * Specifies that the vertical positioning shall be relative to the edge of the page.
+   */
   PAGE: "page",
+  /**
+   * ## Paragraph
+   *
+   * Specifies that the vertical positioning shall be relative to the paragraph which contains the drawing anchor.
+   */
   PARAGRAPH: "paragraph",
+  /**
+   * ## Top Margin
+   *
+   * Specifies that the vertical positioning shall be relative to the top margin of the current page.
+   */
   TOP_MARGIN: "topMargin"
 };
-class SimplePosAttributes extends XmlAttributeComponent {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "xmlKeys", {
-      x: "x",
-      y: "y"
-    });
-  }
-}
-class SimplePos extends XmlComponent {
-  constructor() {
-    super("wp:simplePos");
-    this.root.push(
-      new SimplePosAttributes({
-        x: 0,
-        y: 0
-      })
-    );
-  }
-}
-class Align extends XmlComponent {
-  constructor(value) {
-    super("wp:align");
-    this.root.push(value);
-  }
-}
-class PositionOffset extends XmlComponent {
-  constructor(offsetValue) {
-    super("wp:posOffset");
-    this.root.push(offsetValue.toString());
-  }
-}
-class HorizontalPositionAttributes extends XmlAttributeComponent {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "xmlKeys", {
-      relativeFrom: "relativeFrom"
-    });
-  }
-}
-class HorizontalPosition extends XmlComponent {
-  constructor(horizontalPosition) {
-    super("wp:positionH");
-    this.root.push(
-      new HorizontalPositionAttributes({
-        relativeFrom: horizontalPosition.relative || HorizontalPositionRelativeFrom.PAGE
-      })
-    );
-    if (horizontalPosition.align) {
-      this.root.push(new Align(horizontalPosition.align));
-    } else if (horizontalPosition.offset !== void 0) {
-      this.root.push(new PositionOffset(horizontalPosition.offset));
-    } else {
-      throw new Error("There is no configuration provided for floating position (Align or offset)");
-    }
-  }
-}
-class VerticalPositionAttributes extends XmlAttributeComponent {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "xmlKeys", {
-      relativeFrom: "relativeFrom"
-    });
-  }
-}
-class VerticalPosition extends XmlComponent {
-  constructor(verticalPosition) {
-    super("wp:positionV");
-    this.root.push(
-      new VerticalPositionAttributes({
-        relativeFrom: verticalPosition.relative || VerticalPositionRelativeFrom.PAGE
-      })
-    );
-    if (verticalPosition.align) {
-      this.root.push(new Align(verticalPosition.align));
-    } else if (verticalPosition.offset !== void 0) {
-      this.root.push(new PositionOffset(verticalPosition.offset));
-    } else {
-      throw new Error("There is no configuration provided for floating position (Align or offset)");
-    }
+const createSimplePos = () => new BuilderElement({
+  name: "wp:simplePos",
+  // NOTE: It's not fully supported in Microsoft Word, but this element is needed anyway
+  attributes: {
+    x: { key: "x", value: 0 },
+    y: { key: "y", value: 0 }
   }
-}
+});
+const createAlign = (value) => new BuilderElement({
+  name: "wp:align",
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  children: [value]
+});
+const createPositionOffset = (offsetValue) => new BuilderElement({
+  name: "wp:posOffset",
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  children: [offsetValue.toString()]
+});
+const createHorizontalPosition = ({ relative, align, offset }) => new BuilderElement({
+  name: "wp:positionH",
+  attributes: {
+    relativeFrom: { key: "relativeFrom", value: relative != null ? relative : HorizontalPositionRelativeFrom.PAGE }
+  },
+  children: [
+    (() => {
+      if (align) {
+        return createAlign(align);
+      } else if (offset !== void 0) {
+        return createPositionOffset(offset);
+      } else {
+        throw new Error("There is no configuration provided for floating position (Align or offset)");
+      }
+    })()
+  ]
+});
+const createVerticalPosition = ({ relative, align, offset }) => new BuilderElement({
+  name: "wp:positionV",
+  attributes: {
+    relativeFrom: { key: "relativeFrom", value: relative != null ? relative : VerticalPositionRelativeFrom.PAGE }
+  },
+  children: [
+    (() => {
+      if (align) {
+        return createAlign(align);
+      } else if (offset !== void 0) {
+        return createPositionOffset(offset);
+      } else {
+        throw new Error("There is no configuration provided for floating position (Align or offset)");
+      }
+    })()
+  ]
+});
 class GraphicDataAttributes extends XmlAttributeComponent {
   constructor() {
     super(...arguments);
@@ -12442,26 +12519,13 @@ const createEffectExtent = ({ top, right, bottom, left }) => new BuilderElement(
     }
   }
 });
-class ExtentAttributes extends XmlAttributeComponent {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "xmlKeys", {
-      cx: "cx",
-      cy: "cy"
-    });
-  }
-}
-class Extent extends XmlComponent {
-  constructor(x, y) {
-    super("wp:extent");
-    __publicField(this, "attributes");
-    this.attributes = new ExtentAttributes({
-      cx: x,
-      cy: y
-    });
-    this.root.push(this.attributes);
+const createExtent = ({ x, y }) => new BuilderElement({
+  name: "wp:extent",
+  attributes: {
+    x: { key: "cx", value: x },
+    y: { key: "cy", value: y }
   }
-}
+});
 class GraphicFrameLockAttributes extends XmlAttributeComponent {
   constructor() {
     super(...arguments);
@@ -12482,12 +12546,10 @@ class GraphicFrameLocks extends XmlComponent {
     );
   }
 }
-class GraphicFrameProperties extends XmlComponent {
-  constructor() {
-    super("wp:cNvGraphicFramePr");
-    this.root.push(new GraphicFrameLocks());
-  }
-}
+const createGraphicFrameProperties = () => new BuilderElement({
+  name: "wp:cNvGraphicFramePr",
+  children: [new GraphicFrameLocks()]
+});
 class AnchorAttributes extends XmlAttributeComponent {
   constructor() {
     super(...arguments);
@@ -12535,10 +12597,10 @@ class Anchor extends XmlComponent {
         relativeHeight: floating.zIndex ? floating.zIndex : transform.emus.y
       })
     );
-    this.root.push(new SimplePos());
-    this.root.push(new HorizontalPosition(floating.horizontalPosition));
-    this.root.push(new VerticalPosition(floating.verticalPosition));
-    this.root.push(new Extent(transform.emus.x, transform.emus.y));
+    this.root.push(createSimplePos());
+    this.root.push(createHorizontalPosition(floating.horizontalPosition));
+    this.root.push(createVerticalPosition(floating.verticalPosition));
+    this.root.push(createExtent({ x: transform.emus.x, y: transform.emus.y }));
     this.root.push(createEffectExtent({ top: 0, right: 0, bottom: 0, left: 0 }));
     if (drawingOptions.floating !== void 0 && drawingOptions.floating.wrap !== void 0) {
       switch (drawingOptions.floating.wrap.type) {
@@ -12559,7 +12621,7 @@ class Anchor extends XmlComponent {
       this.root.push(new WrapNone());
     }
     this.root.push(new DocProperties(drawingOptions.docProperties));
-    this.root.push(new GraphicFrameProperties());
+    this.root.push(createGraphicFrameProperties());
     this.root.push(new Graphic({ mediaData, transform, outline: drawingOptions.outline }));
   }
 }
@@ -12586,7 +12648,7 @@ const createInline = ({ mediaData, transform, docProperties, outline }) => {
       }
     },
     children: [
-      new Extent(transform.emus.x, transform.emus.y),
+      createExtent({ x: transform.emus.x, y: transform.emus.y }),
       createEffectExtent(
         outline ? {
           top: ((_a = outline.width) != null ? _a : 9525) * 2,
@@ -12596,7 +12658,7 @@ const createInline = ({ mediaData, transform, docProperties, outline }) => {
         } : { top: 0, right: 0, bottom: 0, left: 0 }
       ),
       new DocProperties(docProperties),
-      new GraphicFrameProperties(),
+      createGraphicFrameProperties(),
       new Graphic({ mediaData, transform, outline })
     ]
   });
@@ -12719,6 +12781,59 @@ class SimpleMailMergeField extends SimpleField {
     super(` MERGEFIELD ${fieldName} `, `«${fieldName}»`);
   }
 }
+class RelationshipsAttributes extends XmlAttributeComponent {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "xmlKeys", {
+      xmlns: "xmlns"
+    });
+  }
+}
+class RelationshipAttributes extends XmlAttributeComponent {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "xmlKeys", {
+      id: "Id",
+      type: "Type",
+      target: "Target",
+      targetMode: "TargetMode"
+    });
+  }
+}
+const TargetModeType = {
+  EXTERNAL: "External"
+};
+class Relationship extends XmlComponent {
+  constructor(id, type2, target, targetMode) {
+    super("Relationship");
+    this.root.push(
+      new RelationshipAttributes({
+        id,
+        type: type2,
+        target,
+        targetMode
+      })
+    );
+  }
+}
+class Relationships extends XmlComponent {
+  constructor() {
+    super("Relationships");
+    this.root.push(
+      new RelationshipsAttributes({
+        xmlns: "http://schemas.openxmlformats.org/package/2006/relationships"
+      })
+    );
+  }
+  createRelationship(id, type2, target, targetMode) {
+    const relationship = new Relationship(`rId${id}`, type2, target, targetMode);
+    this.root.push(relationship);
+    return relationship;
+  }
+  get RelationshipCount() {
+    return this.root.length - 1;
+  }
+}
 class CommentAttributes extends XmlAttributeComponent {
   constructor() {
     super(...arguments);
@@ -12806,6 +12921,7 @@ class Comment extends XmlComponent {
 class Comments extends XmlComponent {
   constructor({ children }) {
     super("w:comments");
+    __publicField(this, "relationships");
     this.root.push(
       new RootCommentsAttributes({
         "xmlns:cx": "http://schemas.microsoft.com/office/drawing/2014/chartex",
@@ -12844,6 +12960,10 @@ class Comments extends XmlComponent {
     for (const child of children) {
       this.root.push(new Comment(child));
     }
+    this.relationships = new Relationships();
+  }
+  get Relationships() {
+    return this.relationships;
   }
 }
 class NoBreakHyphen extends EmptyElement {
@@ -13015,7 +13135,7 @@ class SpacingAttributes extends XmlAttributeComponent {
       line: "w:line",
       lineRule: "w:lineRule",
       beforeAutoSpacing: "w:beforeAutospacing",
-      afterAutoSpacing: "w:afterAutoSpacing"
+      afterAutoSpacing: "w:afterAutospacing"
     });
   }
 }
@@ -13129,33 +13249,6 @@ class FileChild extends XmlComponent {
     __publicField(this, "fileChild", Symbol());
   }
 }
-class RelationshipAttributes extends XmlAttributeComponent {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "xmlKeys", {
-      id: "Id",
-      type: "Type",
-      target: "Target",
-      targetMode: "TargetMode"
-    });
-  }
-}
-const TargetModeType = {
-  EXTERNAL: "External"
-};
-class Relationship extends XmlComponent {
-  constructor(id, type2, target, targetMode) {
-    super("Relationship");
-    this.root.push(
-      new RelationshipAttributes({
-        id,
-        type: type2,
-        target,
-        targetMode
-      })
-    );
-  }
-}
 class HyperlinkAttributes extends XmlAttributeComponent {
   constructor() {
     super(...arguments);
@@ -13314,36 +13407,40 @@ class Columns extends XmlComponent {
   }
 }
 const DocumentGridType = {
+  /**
+   * Specifies that no document grid shall be applied to the contents of the current section in the document.
+   */
   DEFAULT: "default",
+  /**
+   * Specifies that the parent section shall have additional line pitch added to each line within it (as specified on the <docGrid> element (§2.6.5)) in order to maintain the specified number of lines per page.
+   */
   LINES: "lines",
+  /**
+   * Specifies that the parent section shall have both the additional line pitch and character pitch added to each line and character within it (as specified on the <docGrid> element (§2.6.5)) in order to maintain a specific number of lines per page and characters per line.
+   *
+   * When this value is set, the input specified via the user interface may be allowed in exact number of line/character pitch units. */
   LINES_AND_CHARS: "linesAndChars",
+  /**
+   * Specifies that the parent section shall have both the additional line pitch and character pitch added to each line and character within it (as specified on the <docGrid> element (§2.6.5)) in order to maintain a specific number of lines per page and characters per line.
+   *
+   * When this value is set, the input specified via the user interface may be restricted to the number of lines per page and characters per line, with the consumer or producer translating this information based on the current font data to get the resulting line and character pitch values
+   */
   SNAP_TO_CHARS: "snapToChars"
 };
-class DocGridAttributes extends XmlAttributeComponent {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "xmlKeys", {
-      type: "w:type",
-      linePitch: "w:linePitch",
-      charSpace: "w:charSpace"
-    });
-  }
-}
-class DocumentGrid extends XmlComponent {
-  constructor(linePitch, charSpace, type2) {
-    super("w:docGrid");
-    this.root.push(
-      new DocGridAttributes({
-        type: type2,
-        linePitch: decimalNumber(linePitch),
-        charSpace: charSpace ? decimalNumber(charSpace) : void 0
-      })
-    );
+const createDocumentGrid = ({ type: type2, linePitch, charSpace }) => new BuilderElement({
+  name: "w:docGrid",
+  attributes: {
+    type: { key: "w:type", value: type2 },
+    linePitch: { key: "w:linePitch", value: decimalNumber(linePitch) },
+    charSpace: { key: "w:charSpace", value: charSpace ? decimalNumber(charSpace) : void 0 }
   }
-}
+});
 const HeaderFooterReferenceType = {
+  /** Specifies that this header or footer shall appear on every page in this section which is not overridden with a specific `even` or `first` page header/footer. In a section with all three types specified, this type shall be used on all odd numbered pages (counting from the `first` page in the section, not the section numbering). */
   DEFAULT: "default",
+  /** Specifies that this header or footer shall appear on the first page in this section. The appearance of this header or footer is contingent on the setting of the `titlePg` element (§2.10.6). */
   FIRST: "first",
+  /** Specifies that this header or footer shall appear on all even numbered pages in this section (counting from the first page in the section, not the section numbering). The appearance of this header or footer is contingent on the setting of the `evenAndOddHeaders` element (§2.10.1). */
   EVEN: "even"
 };
 class FooterReferenceAttributes extends XmlAttributeComponent {
@@ -13371,8 +13468,23 @@ class HeaderFooterReference extends XmlComponent {
   }
 }
 const LineNumberRestartFormat = {
+  /**
+   * ## Restart Line Numbering on Each Page
+   *
+   * Specifies that line numbering for the parent section shall restart to the starting value whenever a new page is displayed.
+   */
   NEW_PAGE: "newPage",
+  /**
+   * ## Restart Line Numbering for Each Section
+   *
+   * Specifies that line numbering for the parent section shall restart to the starting value whenever the parent begins.
+   */
   NEW_SECTION: "newSection",
+  /**
+   * ## Continue Line Numbering From Previous Section
+   *
+   * Specifies that line numbering for the parent section shall continue from the line numbering from the end of the previous section, if any.
+   */
   CONTINUOUS: "continuous"
 };
 const createLineNumberType = ({ countBy, start, restart, distance }) => new BuilderElement({
@@ -13487,24 +13599,32 @@ class PageNumberType extends XmlComponent {
   }
 }
 const PageOrientation = {
+  /**
+   * ## Portrait Mode
+   *
+   * Specifies that pages in this section shall be printed in portrait mode.
+   */
   PORTRAIT: "portrait",
+  /**
+   * ## Landscape Mode
+   *
+   * Specifies that pages in this section shall be printed in landscape mode, which prints the page contents with a 90 degree rotation with respect to the normal page orientation.
+   */
   LANDSCAPE: "landscape"
 };
-class PageSize extends XmlComponent {
-  constructor(width, height, orientation) {
-    super("w:pgSz");
-    const flip = orientation === PageOrientation.LANDSCAPE;
-    const widthTwips = twipsMeasureValue(width);
-    const heightTwips = twipsMeasureValue(height);
-    this.root.push(
-      new NextAttributeComponent({
-        width: { key: "w:w", value: flip ? heightTwips : widthTwips },
-        height: { key: "w:h", value: flip ? widthTwips : heightTwips },
-        orientation: { key: "w:orient", value: orientation }
-      })
-    );
-  }
-}
+const createPageSize = ({ width, height, orientation, code }) => {
+  const widthTwips = twipsMeasureValue(width);
+  const heightTwips = twipsMeasureValue(height);
+  return new BuilderElement({
+    name: "w:pgSz",
+    attributes: {
+      width: { key: "w:w", value: orientation === PageOrientation.LANDSCAPE ? heightTwips : widthTwips },
+      height: { key: "w:h", value: orientation === PageOrientation.LANDSCAPE ? widthTwips : heightTwips },
+      orientation: { key: "w:orient", value: orientation },
+      code: { key: "w:code", value: code }
+    }
+  });
+};
 const PageTextDirectionType = {
   LEFT_TO_RIGHT_TOP_TO_BOTTOM: "lrTb",
   TOP_TO_BOTTOM_RIGHT_TO_LEFT: "tbRl"
@@ -13596,7 +13716,7 @@ class SectionProperties extends XmlComponent {
     if (type2) {
       this.root.push(new Type(type2));
     }
-    this.root.push(new PageSize(width, height, orientation));
+    this.root.push(createPageSize({ width, height, orientation }));
     this.root.push(new PageMargin(top, right, bottom, left, header, footer, gutter));
     if (borders) {
       this.root.push(new PageBorders(borders));
@@ -13617,7 +13737,7 @@ class SectionProperties extends XmlComponent {
     if (textDirection) {
       this.root.push(new PageTextDirection(textDirection));
     }
-    this.root.push(new DocumentGrid(linePitch, charSpace, gridType));
+    this.root.push(createDocumentGrid({ linePitch, charSpace, type: gridType }));
   }
   addHeaderFooterGroup(type2, group) {
     if (group.default) {
@@ -13823,32 +13943,6 @@ class Document extends XmlComponent {
     return this.body;
   }
 }
-class RelationshipsAttributes extends XmlAttributeComponent {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "xmlKeys", {
-      xmlns: "xmlns"
-    });
-  }
-}
-class Relationships extends XmlComponent {
-  constructor() {
-    super("Relationships");
-    this.root.push(
-      new RelationshipsAttributes({
-        xmlns: "http://schemas.openxmlformats.org/package/2006/relationships"
-      })
-    );
-  }
-  createRelationship(id, type2, target, targetMode) {
-    const relationship = new Relationship(`rId${id}`, type2, target, targetMode);
-    this.root.push(relationship);
-    return relationship;
-  }
-  get RelationshipCount() {
-    return this.root.length - 1;
-  }
-}
 class DocumentWrapper {
   constructor(options) {
     __publicField(this, "document");
@@ -14169,117 +14263,93 @@ class MathFraction extends XmlComponent {
     this.root.push(new MathDenominator(options.denominator));
   }
 }
-class MathAccentCharacterAttributes extends XmlAttributeComponent {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "xmlKeys", { accent: "m:val" });
-  }
-}
-class MathAccentCharacter extends XmlComponent {
-  constructor(accent) {
-    super("m:chr");
-    this.root.push(new MathAccentCharacterAttributes({ accent }));
-  }
-}
-class MathBase extends XmlComponent {
-  constructor(children) {
-    super("m:e");
-    for (const child of children) {
-      this.root.push(child);
-    }
-  }
-}
-class MathLimitLocationAttributes extends XmlAttributeComponent {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "xmlKeys", { value: "m:val" });
-  }
-}
-class MathLimitLocation extends XmlComponent {
-  constructor(value) {
-    super("m:limLoc");
-    this.root.push(new MathLimitLocationAttributes({ value: value || "undOvr" }));
-  }
-}
-class MathSubScriptHideAttributes extends XmlAttributeComponent {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "xmlKeys", { hide: "m:val" });
-  }
-}
-class MathSubScriptHide extends XmlComponent {
-  constructor() {
-    super("m:subHide");
-    this.root.push(new MathSubScriptHideAttributes({ hide: 1 }));
-  }
-}
-class MathSuperScriptHideAttributes extends XmlAttributeComponent {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "xmlKeys", { hide: "m:val" });
-  }
-}
-class MathSuperScriptHide extends XmlComponent {
-  constructor() {
-    super("m:supHide");
-    this.root.push(new MathSuperScriptHideAttributes({ hide: 1 }));
+const createMathAccentCharacter = ({ accent }) => new BuilderElement({
+  name: "m:chr",
+  attributes: {
+    accent: { key: "m:val", value: accent }
   }
-}
-class MathNAryProperties extends XmlComponent {
-  constructor(accent, hasSuperScript, hasSubScript, limitLocationVal) {
-    super("m:naryPr");
-    if (!!accent) {
-      this.root.push(new MathAccentCharacter(accent));
-    }
-    this.root.push(new MathLimitLocation(limitLocationVal));
-    if (!hasSuperScript) {
-      this.root.push(new MathSuperScriptHide());
-    }
-    if (!hasSubScript) {
-      this.root.push(new MathSubScriptHide());
-    }
+});
+const createMathBase = ({ children }) => new BuilderElement({
+  name: "m:e",
+  children
+});
+const createMathLimitLocation = ({ value }) => new BuilderElement({
+  name: "m:limLoc",
+  attributes: {
+    value: { key: "m:val", value: value || "undOvr" }
   }
-}
-class MathSubScriptElement extends XmlComponent {
-  constructor(children) {
-    super("m:sub");
-    for (const child of children) {
-      this.root.push(child);
-    }
+});
+const createMathSubScriptHide = () => new BuilderElement({
+  name: "m:subHide",
+  attributes: {
+    hide: { key: "m:val", value: 1 }
   }
-}
-class MathSuperScriptElement extends XmlComponent {
-  constructor(children) {
-    super("m:sup");
-    for (const child of children) {
-      this.root.push(child);
-    }
+});
+const createMathSuperScriptHide = () => new BuilderElement({
+  name: "m:supHide",
+  attributes: {
+    hide: { key: "m:val", value: 1 }
   }
-}
+});
+const createMathNAryProperties = ({
+  accent,
+  hasSuperScript,
+  hasSubScript,
+  limitLocationVal
+}) => new BuilderElement({
+  name: "m:naryPr",
+  children: [
+    ...!!accent ? [createMathAccentCharacter({ accent })] : [],
+    createMathLimitLocation({ value: limitLocationVal }),
+    ...!hasSuperScript ? [createMathSuperScriptHide()] : [],
+    ...!hasSubScript ? [createMathSubScriptHide()] : []
+  ]
+});
+const createMathSubScriptElement = ({ children }) => new BuilderElement({
+  name: "m:sub",
+  children
+});
+const createMathSuperScriptElement = ({ children }) => new BuilderElement({
+  name: "m:sup",
+  children
+});
 class MathSum extends XmlComponent {
   constructor(options) {
     super("m:nary");
-    this.root.push(new MathNAryProperties("∑", !!options.superScript, !!options.subScript));
+    this.root.push(
+      createMathNAryProperties({
+        accent: "∑",
+        hasSuperScript: !!options.superScript,
+        hasSubScript: !!options.subScript
+      })
+    );
     if (!!options.subScript) {
-      this.root.push(new MathSubScriptElement(options.subScript));
+      this.root.push(createMathSubScriptElement({ children: options.subScript }));
     }
     if (!!options.superScript) {
-      this.root.push(new MathSuperScriptElement(options.superScript));
+      this.root.push(createMathSuperScriptElement({ children: options.superScript }));
     }
-    this.root.push(new MathBase(options.children));
+    this.root.push(createMathBase({ children: options.children }));
   }
 }
 class MathIntegral extends XmlComponent {
   constructor(options) {
     super("m:nary");
-    this.root.push(new MathNAryProperties("", !!options.superScript, !!options.subScript, "subSup"));
+    this.root.push(
+      createMathNAryProperties({
+        accent: "",
+        hasSuperScript: !!options.superScript,
+        hasSubScript: !!options.subScript,
+        limitLocationVal: "subSup"
+      })
+    );
     if (!!options.subScript) {
-      this.root.push(new MathSubScriptElement(options.subScript));
+      this.root.push(createMathSubScriptElement({ children: options.subScript }));
     }
     if (!!options.superScript) {
-      this.root.push(new MathSuperScriptElement(options.superScript));
+      this.root.push(createMathSuperScriptElement({ children: options.superScript }));
     }
-    this.root.push(new MathBase(options.children));
+    this.root.push(createMathBase({ children: options.children }));
   }
 }
 class MathLimit extends XmlComponent {
@@ -14293,69 +14363,65 @@ class MathLimit extends XmlComponent {
 class MathLimitUpper extends XmlComponent {
   constructor(options) {
     super("m:limUpp");
-    this.root.push(new MathBase(options.children));
+    this.root.push(createMathBase({ children: options.children }));
     this.root.push(new MathLimit(options.limit));
   }
 }
 class MathLimitLower extends XmlComponent {
   constructor(options) {
     super("m:limLow");
-    this.root.push(new MathBase(options.children));
+    this.root.push(createMathBase({ children: options.children }));
     this.root.push(new MathLimit(options.limit));
   }
 }
-class MathSuperScriptProperties extends XmlComponent {
-  constructor() {
-    super("m:sSupPr");
-  }
-}
+const createMathSuperScriptProperties = () => new BuilderElement({
+  name: "m:sSupPr"
+});
 class MathSuperScript extends XmlComponent {
   constructor(options) {
     super("m:sSup");
-    this.root.push(new MathSuperScriptProperties());
-    this.root.push(new MathBase(options.children));
-    this.root.push(new MathSuperScriptElement(options.superScript));
-  }
-}
-class MathSubScriptProperties extends XmlComponent {
-  constructor() {
-    super("m:sSubPr");
+    this.root.push(createMathSuperScriptProperties());
+    this.root.push(createMathBase({ children: options.children }));
+    this.root.push(createMathSuperScriptElement({ children: options.superScript }));
   }
 }
+const createMathSubScriptProperties = () => new BuilderElement({
+  name: "m:sSubPr"
+});
 class MathSubScript extends XmlComponent {
   constructor(options) {
     super("m:sSub");
-    this.root.push(new MathSubScriptProperties());
-    this.root.push(new MathBase(options.children));
-    this.root.push(new MathSubScriptElement(options.subScript));
-  }
-}
-class MathSubSuperScriptProperties extends XmlComponent {
-  constructor() {
-    super("m:sSubSupPr");
+    this.root.push(createMathSubScriptProperties());
+    this.root.push(createMathBase({ children: options.children }));
+    this.root.push(createMathSubScriptElement({ children: options.subScript }));
   }
 }
+const createMathSubSuperScriptProperties = () => new BuilderElement({
+  name: "m:sSubSupPr"
+});
 class MathSubSuperScript extends XmlComponent {
   constructor(options) {
     super("m:sSubSup");
-    this.root.push(new MathSubSuperScriptProperties());
-    this.root.push(new MathBase(options.children));
-    this.root.push(new MathSubScriptElement(options.subScript));
-    this.root.push(new MathSuperScriptElement(options.superScript));
+    this.root.push(createMathSubSuperScriptProperties());
+    this.root.push(createMathBase({ children: options.children }));
+    this.root.push(createMathSubScriptElement({ children: options.subScript }));
+    this.root.push(createMathSuperScriptElement({ children: options.superScript }));
   }
 }
-class MathPreSubSuperScriptProperties extends XmlComponent {
-  constructor() {
-    super("m:sPrePr");
-  }
-}
-class MathPreSubSuperScript extends XmlComponent {
-  constructor(options) {
-    super("m:sPre");
-    this.root.push(new MathPreSubSuperScriptProperties());
-    this.root.push(new MathBase(options.children));
-    this.root.push(new MathSubScriptElement(options.subScript));
-    this.root.push(new MathSuperScriptElement(options.superScript));
+const createMathPreSubSuperScriptProperties = () => new BuilderElement({
+  name: "m:sPrePr"
+});
+class MathPreSubSuperScript extends BuilderElement {
+  constructor({ children, subScript, superScript }) {
+    super({
+      name: "m:sPre",
+      children: [
+        createMathPreSubSuperScriptProperties(),
+        createMathBase({ children }),
+        createMathSubScriptElement({ children: subScript }),
+        createMathSuperScriptElement({ children: superScript })
+      ]
+    });
   }
 }
 const WORKAROUND4 = "";
@@ -14394,7 +14460,7 @@ class MathRadical extends XmlComponent {
     super("m:rad");
     this.root.push(new MathRadicalProperties(!!options.degree));
     this.root.push(new MathDegree(options.degree));
-    this.root.push(new MathBase(options.children));
+    this.root.push(createMathBase({ children: options.children }));
   }
 }
 class MathFunctionName extends XmlComponent {
@@ -14415,83 +14481,75 @@ class MathFunction extends XmlComponent {
     super("m:func");
     this.root.push(new MathFunctionProperties());
     this.root.push(new MathFunctionName(options.name));
-    this.root.push(new MathBase(options.children));
-  }
-}
-class MathBeginningCharacterAttributes extends XmlAttributeComponent {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "xmlKeys", { character: "m:val" });
-  }
-}
-class MathBeginningCharacter extends XmlComponent {
-  constructor(character) {
-    super("m:begChr");
-    this.root.push(new MathBeginningCharacterAttributes({ character }));
-  }
-}
-class MathEndingCharacterAttributes extends XmlAttributeComponent {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "xmlKeys", { character: "m:val" });
+    this.root.push(createMathBase({ children: options.children }));
   }
 }
-class MathEndingCharacter extends XmlComponent {
-  constructor(character) {
-    super("m:endChr");
-    this.root.push(new MathEndingCharacterAttributes({ character }));
+const createMathBeginningCharacter = ({ character }) => new BuilderElement({
+  name: "m:begChr",
+  attributes: {
+    character: { key: "m:val", value: character }
   }
-}
-class MathBracketProperties extends XmlComponent {
-  constructor(options) {
-    super("m:dPr");
-    if (!!options) {
-      this.root.push(new MathBeginningCharacter(options.beginningCharacter));
-      this.root.push(new MathEndingCharacter(options.endingCharacter));
-    }
+});
+const createMathEndingCharacter = ({ character }) => new BuilderElement({
+  name: "m:endChr",
+  attributes: {
+    character: { key: "m:val", value: character }
   }
-}
+});
+const createMathBracketProperties = ({ characters }) => new BuilderElement({
+  name: "m:dPr",
+  children: !!characters ? [
+    createMathBeginningCharacter({ character: characters.beginningCharacter }),
+    createMathEndingCharacter({ character: characters.endingCharacter })
+  ] : []
+});
 class MathRoundBrackets extends XmlComponent {
   constructor(options) {
     super("m:d");
-    this.root.push(new MathBracketProperties());
-    this.root.push(new MathBase(options.children));
+    this.root.push(createMathBracketProperties({}));
+    this.root.push(createMathBase({ children: options.children }));
   }
 }
 class MathSquareBrackets extends XmlComponent {
   constructor(options) {
     super("m:d");
     this.root.push(
-      new MathBracketProperties({
-        beginningCharacter: "[",
-        endingCharacter: "]"
+      createMathBracketProperties({
+        characters: {
+          beginningCharacter: "[",
+          endingCharacter: "]"
+        }
       })
     );
-    this.root.push(new MathBase(options.children));
+    this.root.push(createMathBase({ children: options.children }));
   }
 }
 class MathCurlyBrackets extends XmlComponent {
   constructor(options) {
     super("m:d");
     this.root.push(
-      new MathBracketProperties({
-        beginningCharacter: "{",
-        endingCharacter: "}"
+      createMathBracketProperties({
+        characters: {
+          beginningCharacter: "{",
+          endingCharacter: "}"
+        }
       })
     );
-    this.root.push(new MathBase(options.children));
+    this.root.push(createMathBase({ children: options.children }));
   }
 }
 class MathAngledBrackets extends XmlComponent {
   constructor(options) {
     super("m:d");
     this.root.push(
-      new MathBracketProperties({
-        beginningCharacter: "〈",
-        endingCharacter: "〉"
+      createMathBracketProperties({
+        characters: {
+          beginningCharacter: "〈",
+          endingCharacter: "〉"
+        }
       })
     );
-    this.root.push(new MathBase(options.children));
+    this.root.push(createMathBase({ children: options.children }));
   }
 }
 class TableGrid extends XmlComponent {
@@ -14850,6 +14908,21 @@ class TableLayout extends XmlComponent {
     this.root.push(new TableLayoutAttributes({ type: type2 }));
   }
 }
+const CellSpacingType = {
+  /** Value is in twentieths of a point */
+  DXA: "dxa"
+};
+class TableCellSpacingElement extends XmlComponent {
+  constructor({ type: type2 = CellSpacingType.DXA, value }) {
+    super("w:tblCellSpacing");
+    this.root.push(
+      new NextAttributeComponent({
+        type: { key: "w:type", value: type2 },
+        value: { key: "w:w", value: measurementOrPercentValue(value) }
+      })
+    );
+  }
+}
 class TableProperties extends IgnoreIfEmptyXmlComponent {
   constructor(options) {
     super("w:tblPr");
@@ -14883,6 +14956,9 @@ class TableProperties extends IgnoreIfEmptyXmlComponent {
     if (options.cellMargin) {
       this.root.push(new TableCellMargin(TableCellMarginElementType.TABLE, options.cellMargin));
     }
+    if (options.cellSpacing) {
+      this.root.push(new TableCellSpacingElement(options.cellSpacing));
+    }
   }
 }
 class Table extends FileChild {
@@ -14898,7 +14974,8 @@ class Table extends FileChild {
     style,
     borders,
     alignment,
-    visuallyRightToLeft
+    visuallyRightToLeft,
+    cellSpacing
   }) {
     super("w:tbl");
     this.root.push(
@@ -14911,7 +14988,8 @@ class Table extends FileChild {
         style,
         alignment,
         cellMargin: margins,
-        visuallyRightToLeft
+        visuallyRightToLeft,
+        cellSpacing
       })
     );
     this.root.push(new TableGrid(columnWidths));
@@ -14977,6 +15055,9 @@ class TableRowProperties extends IgnoreIfEmptyXmlComponent {
     if (options.height) {
       this.root.push(new TableRowHeight(options.height.value, options.height.rule));
     }
+    if (options.cellSpacing) {
+      this.root.push(new TableCellSpacingElement(options.cellSpacing));
+    }
   }
 }
 class TableRow extends XmlComponent {
@@ -15308,10 +15389,10 @@ const createFont = ({
       // http://www.datypic.com/sc/ooxml/e-w_charset-1.html
       ...charset ? [createStringElement("w:charset", charset)] : [],
       // http://www.datypic.com/sc/ooxml/e-w_family-1.html
-      ...family ? [createStringElement("w:family", family)] : [],
+      ...[createStringElement("w:family", family)],
       // http://www.datypic.com/sc/ooxml/e-w_notTrueType-1.html
       ...notTrueType ? [new OnOffElement("w:notTrueType", notTrueType)] : [],
-      ...pitch ? [createStringElement("w:pitch", pitch)] : [],
+      ...[createStringElement("w:pitch", pitch)],
       // http://www.datypic.com/sc/ooxml/e-w_sig-1.html
       ...sig ? [
         new BuilderElement({
@@ -17522,12 +17603,7 @@ const styleToKeyMap = {
   zIndex: "z-index"
 };
 const formatShapeStyle = (style) => style ? Object.entries(style).map(([key, value]) => `${styleToKeyMap[key]}:${value}`).join(";") : void 0;
-const createShape = ({
-  id,
-  children,
-  type: type2 = SHAPE_TYPE,
-  style
-}) => new BuilderElement({
+const createShape = ({ id, children, type: type2 = SHAPE_TYPE, style }) => new BuilderElement({
   name: "v:shape",
   attributes: {
     id: {
@@ -20244,7 +20320,26 @@ class Compiler {
         }
       }
     );
+    const commentRelationshipCount = file.Comments.Relationships.RelationshipCount + 1;
+    const commentXmlData = xml(
+      this.formatter.format(file.Comments, {
+        viewWrapper: {
+          View: file.Comments,
+          Relationships: file.Comments.Relationships
+        },
+        file,
+        stack: []
+      }),
+      {
+        indent: prettify,
+        declaration: {
+          standalone: "yes",
+          encoding: "UTF-8"
+        }
+      }
+    );
     const documentMediaDatas = this.imageReplacer.getMediaData(documentXmlData, file.Media);
+    const commentMediaDatas = this.imageReplacer.getMediaData(commentXmlData, file.Media);
     return {
       Relationships: {
         data: (() => {
@@ -20577,22 +20672,41 @@ class Compiler {
         path: "word/settings.xml"
       },
       Comments: {
-        data: xml(
-          this.formatter.format(file.Comments, {
-            viewWrapper: file.Document,
-            file,
-            stack: []
-          }),
-          {
-            indent: prettify,
-            declaration: {
-              standalone: "yes",
-              encoding: "UTF-8"
-            }
-          }
-        ),
+        data: (() => {
+          const xmlData = this.imageReplacer.replace(commentXmlData, commentMediaDatas, commentRelationshipCount);
+          const referenedXmlData = this.numberingReplacer.replace(xmlData, file.Numbering.ConcreteNumbering);
+          return referenedXmlData;
+        })(),
         path: "word/comments.xml"
       },
+      CommentsRelationships: {
+        data: (() => {
+          commentMediaDatas.forEach((mediaData, i) => {
+            file.Comments.Relationships.createRelationship(
+              commentRelationshipCount + i,
+              "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image",
+              `media/${mediaData.fileName}`
+            );
+          });
+          return xml(
+            this.formatter.format(file.Comments.Relationships, {
+              viewWrapper: {
+                View: file.Comments,
+                Relationships: file.Comments.Relationships
+              },
+              file,
+              stack: []
+            }),
+            {
+              indent: prettify,
+              declaration: {
+                encoding: "UTF-8"
+              }
+            }
+          );
+        })(),
+        path: "word/_rels/comments.xml.rels"
+      },
       FontTable: {
         data: xml(
           this.formatter.format(file.FontTable.View, {
@@ -20921,9 +21035,8 @@ const traverse = (node) => {
     currentNode = queue2.shift();
     if (currentNode.element.name === "w:p") {
       renderedParagraphs = [...renderedParagraphs, renderParagraphNode(currentNode)];
-    } else {
-      queue2.push(...elementsToWrapper(currentNode));
     }
+    queue2.push(...elementsToWrapper(currentNode));
   }
   return renderedParagraphs;
 };
@@ -21001,14 +21114,21 @@ const PatchType = {
   PARAGRAPH: "paragraph"
 };
 const imageReplacer = new ImageReplacer();
+const UTF16LE = Buffer.from([255, 254]);
+const UTF16BE = Buffer.from([254, 255]);
 const patchDocument = (_0) => __async(void 0, [_0], function* ({
   outputType,
   data,
   patches,
-  keepOriginalStyles
+  keepOriginalStyles,
+  placeholderDelimiters = { start: "{{", end: "}}" },
+  /**
+   * Search for occurrences over patched document
+   */
+  recursive = true
 }) {
-  var _a, _b, _c, _d;
-  const zipContent = yield JSZip.loadAsync(data);
+  var _a, _b, _c;
+  const zipContent = data instanceof JSZip ? data : yield JSZip.loadAsync(data);
   const contexts = /* @__PURE__ */ new Map();
   const file = {
     Media: new Media()
@@ -21019,15 +21139,20 @@ const patchDocument = (_0) => __async(void 0, [_0], function* ({
   let hasMedia = false;
   const binaryContentMap = /* @__PURE__ */ new Map();
   for (const [key, value] of Object.entries(zipContent.files)) {
+    const binaryValue = yield value.async("uint8array");
+    const startBytes = binaryValue.slice(0, 2);
+    if (UTF16LE.equals(startBytes) || UTF16BE.equals(startBytes)) {
+      binaryContentMap.set(key, binaryValue);
+      continue;
+    }
     if (!key.endsWith(".xml") && !key.endsWith(".rels")) {
-      binaryContentMap.set(key, yield value.async("uint8array"));
+      binaryContentMap.set(key, binaryValue);
       continue;
     }
     const json = toJson(yield value.async("text"));
     if (key === "word/document.xml") {
       const document2 = (_a = json.elements) == null ? void 0 : _a.find((i) => i.name === "w:document");
-      if (document2) {
-        document2.attributes = (_b = document2.attributes) != null ? _b : {};
+      if (document2 && document2.attributes) {
         for (const ns of ["mc", "wp", "r", "w15", "m"]) {
           document2.attributes[`xmlns:${ns}`] = DocumentAttributeNamespaces[ns];
         }
@@ -21053,8 +21178,12 @@ const patchDocument = (_0) => __async(void 0, [_0], function* ({
         stack: []
       };
       contexts.set(key, context);
+      if (!(placeholderDelimiters == null ? void 0 : placeholderDelimiters.start.trim()) || !(placeholderDelimiters == null ? void 0 : placeholderDelimiters.end.trim())) {
+        throw new Error("Both start and end delimiters must be non-empty strings.");
+      }
+      const { start, end } = placeholderDelimiters;
       for (const [patchKey, patchValue] of Object.entries(patches)) {
-        const patchText = `{{${patchKey}}}`;
+        const patchText = `${start}${patchKey}${end}`;
         while (true) {
           const { didFindOccurrence } = replacer({
             json,
@@ -21080,7 +21209,7 @@ const patchDocument = (_0) => __async(void 0, [_0], function* ({
             context,
             keepOriginalStyles
           });
-          if (!didFindOccurrence) {
+          if (!recursive || !didFindOccurrence) {
             break;
           }
         }
@@ -21098,7 +21227,7 @@ const patchDocument = (_0) => __async(void 0, [_0], function* ({
   }
   for (const { key, mediaDatas } of imageRelationshipAdditions) {
     const relationshipKey = `word/_rels/${key.split("/").pop()}.rels`;
-    const relationshipsJson = (_c = map.get(relationshipKey)) != null ? _c : createRelationshipFile();
+    const relationshipsJson = (_b = map.get(relationshipKey)) != null ? _b : createRelationshipFile();
     map.set(relationshipKey, relationshipsJson);
     const index = getNextRelationshipIndex(relationshipsJson);
     const newJson = imageReplacer.replace(JSON.stringify(map.get(key)), mediaDatas, index);
@@ -21115,7 +21244,7 @@ const patchDocument = (_0) => __async(void 0, [_0], function* ({
   }
   for (const { key, hyperlink } of hyperlinkRelationshipAdditions) {
     const relationshipKey = `word/_rels/${key.split("/").pop()}.rels`;
-    const relationshipsJson = (_d = map.get(relationshipKey)) != null ? _d : createRelationshipFile();
+    const relationshipsJson = (_c = map.get(relationshipKey)) != null ? _c : createRelationshipFile();
     map.set(relationshipKey, relationshipsJson);
     appendRelationship(
       relationshipsJson,
@@ -21155,7 +21284,10 @@ const patchDocument = (_0) => __async(void 0, [_0], function* ({
   });
 });
 const toXml = (jsonObj) => {
-  const output = libExports.js2xml(jsonObj);
+  const output = libExports.js2xml(jsonObj, {
+    attributeValueFn: (str) => String(str).replace(/&(?!amp;|lt;|gt;|quot;|apos;)/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;")
+    // cspell:words apos
+  });
   return output;
 };
 const createRelationshipFile = () => ({
@@ -21178,7 +21310,7 @@ const createRelationshipFile = () => ({
   ]
 });
 const patchDetector = (_0) => __async(void 0, [_0], function* ({ data }) {
-  const zipContent = yield JSZip.loadAsync(data);
+  const zipContent = data instanceof JSZip ? data : yield JSZip.loadAsync(data);
   const patches = /* @__PURE__ */ new Set();
   for (const [key, value] of Object.entries(zipContent.files)) {
     if (!key.endsWith(".xml") && !key.endsWith(".rels")) {
@@ -21232,14 +21364,12 @@ export {
   DayLong,
   DayShort,
   DeletedTextRun,
-  DocGridAttributes,
   File as Document,
   DocumentAttributeNamespaces,
   DocumentAttributes,
   DocumentBackground,
   DocumentBackgroundAttributes,
   DocumentDefaults,
-  DocumentGrid,
   DocumentGridType,
   DotEmphasisMark,
   Drawing,
@@ -21270,7 +21400,6 @@ export {
   HeadingLevel,
   HeightRule,
   HighlightColor,
-  HorizontalPosition,
   HorizontalPositionAlign,
   HorizontalPositionRelativeFrom,
   HpsMeasureElement,
@@ -21294,9 +21423,7 @@ export {
   LineNumberRestartFormat,
   LineRuleType,
   Math$1 as Math,
-  MathAccentCharacter,
   MathAngledBrackets,
-  MathBase,
   MathCurlyBrackets,
   MathDegree,
   MathDenominator,
@@ -21306,27 +21433,19 @@ export {
   MathFunctionProperties,
   MathIntegral,
   MathLimit,
-  MathLimitLocation,
   MathLimitLower,
   MathLimitUpper,
-  MathNAryProperties,
   MathNumerator,
   MathPreSubSuperScript,
-  MathPreSubSuperScriptProperties,
   MathRadical,
   MathRadicalProperties,
   MathRoundBrackets,
   MathRun,
   MathSquareBrackets,
   MathSubScript,
-  MathSubScriptElement,
-  MathSubScriptProperties,
   MathSubSuperScript,
-  MathSubSuperScriptProperties,
   MathSum,
   MathSuperScript,
-  MathSuperScriptElement,
-  MathSuperScriptProperties,
   Media,
   MonthLong,
   MonthShort,
@@ -21354,7 +21473,6 @@ export {
   PageNumberTypeAttributes,
   PageOrientation,
   PageReference,
-  PageSize,
   PageTextDirection,
   PageTextDirectionType,
   Paragraph,
@@ -21382,7 +21500,6 @@ export {
   ShadingType,
   SimpleField,
   SimpleMailMergeField,
-  SimplePos,
   SoftHyphen,
   SpaceType,
   Spacing,
@@ -21432,7 +21549,6 @@ export {
   VerticalAlignElement,
   VerticalMerge,
   VerticalMergeType,
-  VerticalPosition,
   VerticalPositionAlign,
   VerticalPositionRelativeFrom,
   WORKAROUND2,
@@ -21453,9 +21569,24 @@ export {
   convertInchesToTwip,
   convertMillimetersToTwip,
   convertToXmlComponent,
+  createDocumentGrid,
   createFrameProperties,
+  createHorizontalPosition,
   createLineNumberType,
+  createMathAccentCharacter,
+  createMathBase,
+  createMathLimitLocation,
+  createMathNAryProperties,
+  createMathPreSubSuperScriptProperties,
+  createMathSubScriptElement,
+  createMathSubScriptProperties,
+  createMathSubSuperScriptProperties,
+  createMathSuperScriptElement,
+  createMathSuperScriptProperties,
+  createPageSize,
+  createSimplePos,
   createStringElement,
+  createVerticalPosition,
   dateTimeValue,
   decimalNumber,
   docPropertiesUniqueNumericIdGen,