docx 9.5.2 → 9.5.3

package/dist/index.cjs

@@ -53,24 +53,59 @@ var __async = (__this, __arguments, generator) => {
 };
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 class BaseXmlComponent {
+  /**
+   * Creates a new BaseXmlComponent with the specified XML element name.
+   *
+   * @param rootKey - The XML element name (e.g., "w:p", "w:r", "w:t")
+   */
   constructor(rootKey) {
+    /** The XML element name for this component (e.g., "w:p" for paragraph). */
     __publicField(this, "rootKey");
     this.rootKey = rootKey;
   }
 }
 const EMPTY_OBJECT = Object.seal({});
 class XmlComponent extends BaseXmlComponent {
+  /**
+   * Creates a new XmlComponent.
+   *
+   * @param rootKey - The XML element name (e.g., "w:p", "w:r", "w:t")
+   */
   constructor(rootKey) {
     super(rootKey);
+    /**
+     * Array of child components, text nodes, and attributes.
+     *
+     * This array forms the content of the XML element. It can contain other
+     * XmlComponents, string values (text nodes), or attribute components.
+     */
     // eslint-disable-next-line functional/prefer-readonly-type, @typescript-eslint/no-explicit-any
     __publicField(this, "root");
     this.root = new Array();
   }
-  // This method is called by the formatter to get the XML representation of this component.
-  // It is called recursively for all child components.
-  // It is a serializer to be used in the xml library.
-  // https://www.npmjs.com/package/xml
-  // Child components can override this method to customize the XML representation, or execute side effects.
+  /**
+   * Prepares this component and its children for XML serialization.
+   *
+   * This method is called by the Formatter to convert the component tree into
+   * an object structure compatible with the xml library (https://www.npmjs.com/package/xml).
+   * It recursively processes all children and handles special cases like
+   * attribute-only elements and empty elements.
+   *
+   * The method can be overridden by subclasses to customize XML representation
+   * or execute side effects during serialization (e.g., creating relationships).
+   *
+   * @param context - The serialization context containing document state
+   * @returns The XML-serializable object, or undefined to exclude from output
+   *
+   * @example
+   * ```typescript
+   * // Override to add custom serialization logic
+   * prepForXml(context: IContext): IXmlableObject | undefined {
+   *   // Custom logic here
+   *   return super.prepForXml(context);
+   * }
+   * ```
+   */
   prepForXml(context) {
     var _a;
     context.stack.push(this);
@@ -86,7 +121,11 @@ class XmlComponent extends BaseXmlComponent {
     };
   }
   /**
+   * Adds a child element to this component.
+   *
    * @deprecated Do not use this method. It is only used internally by the library. It will be removed in a future version.
+   * @param child - The child component or text string to add
+   * @returns This component (for chaining)
    */
   addChildElement(child) {
     this.root.push(child);
@@ -94,6 +133,12 @@ class XmlComponent extends BaseXmlComponent {
   }
 }
 class IgnoreIfEmptyXmlComponent extends XmlComponent {
+  /**
+   * Prepares the component for XML serialization, excluding it if empty.
+   *
+   * @param context - The serialization context
+   * @returns The XML-serializable object, or undefined if empty
+   */
   prepForXml(context) {
     const result = super.prepForXml(context);
     if (result && (typeof result[this.rootKey] !== "object" || Object.keys(result[this.rootKey]).length)) {
@@ -103,11 +148,26 @@ class IgnoreIfEmptyXmlComponent extends XmlComponent {
   }
 }
 class XmlAttributeComponent extends BaseXmlComponent {
+  /**
+   * Creates a new attribute component.
+   *
+   * @param root - The attribute data object
+   */
   constructor(root) {
     super("_attr");
+    /** Optional mapping from property names to XML attribute names. */
     __publicField(this, "xmlKeys");
     this.root = root;
   }
+  /**
+   * Converts the attribute data to an XML-serializable object.
+   *
+   * This method transforms the property names using xmlKeys (if defined)
+   * and filters out undefined values.
+   *
+   * @param _ - Context (unused for attributes)
+   * @returns Object with _attr key containing the mapped attributes
+   */
   prepForXml(_) {
     const attrs = {};
     Object.entries(this.root).forEach(([key, value]) => {
@@ -120,10 +180,24 @@ class XmlAttributeComponent extends BaseXmlComponent {
   }
 }
 class NextAttributeComponent extends BaseXmlComponent {
+  /**
+   * Creates a new NextAttributeComponent.
+   *
+   * @param root - Attribute payload with explicit key-value mappings
+   */
   constructor(root) {
     super("_attr");
     this.root = root;
   }
+  /**
+   * Converts the attribute payload to an XML-serializable object.
+   *
+   * Extracts the key and value from each property and filters out
+   * undefined values.
+   *
+   * @param _ - Context (unused for attributes)
+   * @returns Object with _attr key containing the attributes
+   */
   prepForXml(_) {
     const attrs = Object.values(this.root).filter(({ value }) => value !== void 0).reduce((acc, { key, value }) => __spreadProps(__spreadValues({}, acc), { [key]: value }), {});
     return { _attr: attrs };
@@ -833,7 +907,6 @@ function requireBase64Js() {
   return base64Js;
 }
 var ieee754 = {};
-/*! ieee754. BSD-3-Clause License. Feross Aboukhadijeh <https://feross.org/opensource> */
 var hasRequiredIeee754;
 function requireIeee754() {
   if (hasRequiredIeee754) return ieee754;
@@ -917,25 +990,19 @@ function requireIeee754() {
   };
   return ieee754;
 }
-/*!
- * The buffer module from node.js, for the browser.
- *
- * @author   Feross Aboukhadijeh <https://feross.org>
- * @license  MIT
- */
 var hasRequiredBuffer;
 function requireBuffer() {
   if (hasRequiredBuffer) return buffer;
   hasRequiredBuffer = 1;
-  (function(exports2) {
+  (function(exports$1) {
     var base64 = requireBase64Js();
     var ieee7542 = requireIeee754();
     var customInspectSymbol = typeof Symbol === "function" && typeof Symbol["for"] === "function" ? Symbol["for"]("nodejs.util.inspect.custom") : null;
-    exports2.Buffer = Buffer2;
-    exports2.SlowBuffer = SlowBuffer;
-    exports2.INSPECT_MAX_BYTES = 50;
+    exports$1.Buffer = Buffer2;
+    exports$1.SlowBuffer = SlowBuffer;
+    exports$1.INSPECT_MAX_BYTES = 50;
     var K_MAX_LENGTH = 2147483647;
-    exports2.kMaxLength = K_MAX_LENGTH;
+    exports$1.kMaxLength = K_MAX_LENGTH;
     Buffer2.TYPED_ARRAY_SUPPORT = typedArraySupport();
     if (!Buffer2.TYPED_ARRAY_SUPPORT && typeof console !== "undefined" && typeof console.error === "function") {
       console.error(
@@ -1368,7 +1435,7 @@ function requireBuffer() {
     };
     Buffer2.prototype.inspect = function inspect() {
       var str = "";
-      var max2 = exports2.INSPECT_MAX_BYTES;
+      var max2 = exports$1.INSPECT_MAX_BYTES;
       str = this.toString("hex", 0, max2).replace(/(.{2})/g, "$1 ").trim();
       if (this.length > max2) str += " ... ";
       return "<Buffer " + str + ">";
@@ -2281,7 +2348,7 @@ function requireBuffer() {
     function numberIsNaN(obj) {
       return obj !== obj;
     }
-    var hexSliceLookupTable = function() {
+    var hexSliceLookupTable = (function() {
       var alphabet = "0123456789abcdef";
       var table = new Array(256);
       for (var i = 0; i < 16; ++i) {
@@ -2291,7 +2358,7 @@ function requireBuffer() {
         }
       }
       return table;
-    }();
+    })();
   })(buffer);
   return buffer;
 }
@@ -2310,7 +2377,7 @@ function requireShams$1() {
       return true;
     }
     var obj = {};
-    var sym = Symbol("test");
+    var sym = /* @__PURE__ */ Symbol("test");
     var symObj = Object(sym);
     if (typeof sym === "string") {
       return false;
@@ -2556,7 +2623,7 @@ function requireHasSymbols() {
     if (typeof origSymbol("foo") !== "symbol") {
       return false;
     }
-    if (typeof Symbol("bar") !== "symbol") {
+    if (typeof /* @__PURE__ */ Symbol("bar") !== "symbol") {
       return false;
     }
     return hasSymbolSham();
@@ -2813,7 +2880,7 @@ function requireGetIntrinsic() {
   var throwTypeError = function() {
     throw new $TypeError();
   };
-  var ThrowTypeError = $gOPD ? function() {
+  var ThrowTypeError = $gOPD ? (function() {
     try {
       arguments.callee;
       return throwTypeError;
@@ -2824,7 +2891,7 @@ function requireGetIntrinsic() {
         return throwTypeError;
       }
     }
-  }() : throwTypeError;
+  })() : throwTypeError;
   var hasSymbols2 = requireHasSymbols()();
   var getProto2 = requireGetProto();
   var $ObjectGPO = requireObject_getPrototypeOf();
@@ -3087,7 +3154,7 @@ function requireGetIntrinsic() {
           if (!allowMissing) {
             throw new $TypeError("base intrinsic for " + name + " exists, but the property is not available.");
           }
-          return void 0;
+          return void undefined$1;
         }
         if ($gOPD && i + 1 >= parts.length) {
           var desc = $gOPD(value, part);
@@ -3110,185 +3177,28 @@ function requireGetIntrinsic() {
   };
   return getIntrinsic;
 }
-var callBind = { exports: {} };
-var defineDataProperty;
-var hasRequiredDefineDataProperty;
-function requireDefineDataProperty() {
-  if (hasRequiredDefineDataProperty) return defineDataProperty;
-  hasRequiredDefineDataProperty = 1;
-  var $defineProperty = /* @__PURE__ */ requireEsDefineProperty();
-  var $SyntaxError = /* @__PURE__ */ requireSyntax();
-  var $TypeError = /* @__PURE__ */ requireType();
-  var gopd2 = /* @__PURE__ */ requireGopd();
-  defineDataProperty = function defineDataProperty2(obj, property, value) {
-    if (!obj || typeof obj !== "object" && typeof obj !== "function") {
-      throw new $TypeError("`obj` must be an object or a function`");
-    }
-    if (typeof property !== "string" && typeof property !== "symbol") {
-      throw new $TypeError("`property` must be a string or a symbol`");
-    }
-    if (arguments.length > 3 && typeof arguments[3] !== "boolean" && arguments[3] !== null) {
-      throw new $TypeError("`nonEnumerable`, if provided, must be a boolean or null");
-    }
-    if (arguments.length > 4 && typeof arguments[4] !== "boolean" && arguments[4] !== null) {
-      throw new $TypeError("`nonWritable`, if provided, must be a boolean or null");
-    }
-    if (arguments.length > 5 && typeof arguments[5] !== "boolean" && arguments[5] !== null) {
-      throw new $TypeError("`nonConfigurable`, if provided, must be a boolean or null");
-    }
-    if (arguments.length > 6 && typeof arguments[6] !== "boolean") {
-      throw new $TypeError("`loose`, if provided, must be a boolean");
-    }
-    var nonEnumerable = arguments.length > 3 ? arguments[3] : null;
-    var nonWritable = arguments.length > 4 ? arguments[4] : null;
-    var nonConfigurable = arguments.length > 5 ? arguments[5] : null;
-    var loose = arguments.length > 6 ? arguments[6] : false;
-    var desc = !!gopd2 && gopd2(obj, property);
-    if ($defineProperty) {
-      $defineProperty(obj, property, {
-        configurable: nonConfigurable === null && desc ? desc.configurable : !nonConfigurable,
-        enumerable: nonEnumerable === null && desc ? desc.enumerable : !nonEnumerable,
-        value,
-        writable: nonWritable === null && desc ? desc.writable : !nonWritable
-      });
-    } else if (loose || !nonEnumerable && !nonWritable && !nonConfigurable) {
-      obj[property] = value;
-    } else {
-      throw new $SyntaxError("This environment does not support defining a property as non-configurable, non-writable, or non-enumerable.");
-    }
-  };
-  return defineDataProperty;
-}
-var hasPropertyDescriptors_1;
-var hasRequiredHasPropertyDescriptors;
-function requireHasPropertyDescriptors() {
-  if (hasRequiredHasPropertyDescriptors) return hasPropertyDescriptors_1;
-  hasRequiredHasPropertyDescriptors = 1;
-  var $defineProperty = /* @__PURE__ */ requireEsDefineProperty();
-  var hasPropertyDescriptors = function hasPropertyDescriptors2() {
-    return !!$defineProperty;
-  };
-  hasPropertyDescriptors.hasArrayLengthDefineBug = function hasArrayLengthDefineBug() {
-    if (!$defineProperty) {
-      return null;
-    }
-    try {
-      return $defineProperty([], "length", { value: 1 }).length !== 1;
-    } catch (e) {
-      return true;
-    }
-  };
-  hasPropertyDescriptors_1 = hasPropertyDescriptors;
-  return hasPropertyDescriptors_1;
-}
-var setFunctionLength;
-var hasRequiredSetFunctionLength;
-function requireSetFunctionLength() {
-  if (hasRequiredSetFunctionLength) return setFunctionLength;
-  hasRequiredSetFunctionLength = 1;
-  var GetIntrinsic = /* @__PURE__ */ requireGetIntrinsic();
-  var define = /* @__PURE__ */ requireDefineDataProperty();
-  var hasDescriptors = /* @__PURE__ */ requireHasPropertyDescriptors()();
-  var gOPD2 = /* @__PURE__ */ requireGopd();
-  var $TypeError = /* @__PURE__ */ requireType();
-  var $floor = GetIntrinsic("%Math.floor%");
-  setFunctionLength = function setFunctionLength2(fn, length) {
-    if (typeof fn !== "function") {
-      throw new $TypeError("`fn` is not a function");
-    }
-    if (typeof length !== "number" || length < 0 || length > 4294967295 || $floor(length) !== length) {
-      throw new $TypeError("`length` must be a positive 32-bit integer");
-    }
-    var loose = arguments.length > 2 && !!arguments[2];
-    var functionLengthIsConfigurable = true;
-    var functionLengthIsWritable = true;
-    if ("length" in fn && gOPD2) {
-      var desc = gOPD2(fn, "length");
-      if (desc && !desc.configurable) {
-        functionLengthIsConfigurable = false;
-      }
-      if (desc && !desc.writable) {
-        functionLengthIsWritable = false;
-      }
-    }
-    if (functionLengthIsConfigurable || functionLengthIsWritable || !loose) {
-      if (hasDescriptors) {
-        define(
-          /** @type {Parameters<define>[0]} */
-          fn,
-          "length",
-          length,
-          true,
-          true
-        );
-      } else {
-        define(
-          /** @type {Parameters<define>[0]} */
-          fn,
-          "length",
-          length
-        );
-      }
-    }
-    return fn;
-  };
-  return setFunctionLength;
-}
-var applyBind;
-var hasRequiredApplyBind;
-function requireApplyBind() {
-  if (hasRequiredApplyBind) return applyBind;
-  hasRequiredApplyBind = 1;
-  var bind = requireFunctionBind();
-  var $apply = requireFunctionApply();
-  var actualApply2 = requireActualApply();
-  applyBind = function applyBind2() {
-    return actualApply2(bind, $apply, arguments);
-  };
-  return applyBind;
-}
-var hasRequiredCallBind;
-function requireCallBind() {
-  if (hasRequiredCallBind) return callBind.exports;
-  hasRequiredCallBind = 1;
-  (function(module2) {
-    var setFunctionLength2 = /* @__PURE__ */ requireSetFunctionLength();
-    var $defineProperty = /* @__PURE__ */ requireEsDefineProperty();
-    var callBindBasic = requireCallBindApplyHelpers();
-    var applyBind2 = requireApplyBind();
-    module2.exports = function callBind2(originalFunction) {
-      var func = callBindBasic(arguments);
-      var adjustedLength = originalFunction.length - (arguments.length - 1);
-      return setFunctionLength2(
-        func,
-        1 + (adjustedLength > 0 ? adjustedLength : 0),
-        true
-      );
-    };
-    if ($defineProperty) {
-      $defineProperty(module2.exports, "apply", { value: applyBind2 });
-    } else {
-      module2.exports.apply = applyBind2;
-    }
-  })(callBind);
-  return callBind.exports;
-}
-var callBound$1;
-var hasRequiredCallBound$1;
-function requireCallBound$1() {
-  if (hasRequiredCallBound$1) return callBound$1;
-  hasRequiredCallBound$1 = 1;
+var callBound;
+var hasRequiredCallBound;
+function requireCallBound() {
+  if (hasRequiredCallBound) return callBound;
+  hasRequiredCallBound = 1;
   var GetIntrinsic = /* @__PURE__ */ requireGetIntrinsic();
-  var callBind2 = requireCallBind();
-  var $indexOf = callBind2(GetIntrinsic("String.prototype.indexOf"));
-  callBound$1 = function callBoundIntrinsic(name, allowMissing) {
-    var intrinsic = GetIntrinsic(name, !!allowMissing);
+  var callBindBasic = requireCallBindApplyHelpers();
+  var $indexOf = callBindBasic([GetIntrinsic("%String.prototype.indexOf%")]);
+  callBound = function callBoundIntrinsic(name, allowMissing) {
+    var intrinsic = (
+      /** @type {(this: unknown, ...args: unknown[]) => unknown} */
+      GetIntrinsic(name, !!allowMissing)
+    );
     if (typeof intrinsic === "function" && $indexOf(name, ".prototype.") > -1) {
-      return callBind2(intrinsic);
+      return callBindBasic(
+        /** @type {const} */
+        [intrinsic]
+      );
     }
     return intrinsic;
   };
-  return callBound$1;
+  return callBound;
 }
 var isArguments;
 var hasRequiredIsArguments;
@@ -3296,7 +3206,7 @@ function requireIsArguments() {
   if (hasRequiredIsArguments) return isArguments;
   hasRequiredIsArguments = 1;
   var hasToStringTag = requireShams()();
-  var callBound2 = requireCallBound$1();
+  var callBound2 = /* @__PURE__ */ requireCallBound();
   var $toString = callBound2("Object.prototype.toString");
   var isStandardArguments = function isArguments2(value) {
     if (hasToStringTag && value && typeof value === "object" && Symbol.toStringTag in value) {
@@ -3308,11 +3218,11 @@ function requireIsArguments() {
     if (isStandardArguments(value)) {
       return true;
     }
-    return value !== null && typeof value === "object" && typeof value.length === "number" && value.length >= 0 && $toString(value) !== "[object Array]" && $toString(value.callee) === "[object Function]";
+    return value !== null && typeof value === "object" && "length" in value && typeof value.length === "number" && value.length >= 0 && $toString(value) !== "[object Array]" && "callee" in value && $toString(value.callee) === "[object Function]";
   };
-  var supportsStandardArguments = function() {
+  var supportsStandardArguments = (function() {
     return isStandardArguments(arguments);
-  }();
+  })();
   isStandardArguments.isLegacyArguments = isLegacyArguments;
   isArguments = supportsStandardArguments ? isStandardArguments : isLegacyArguments;
   return isArguments;
@@ -3572,30 +3482,170 @@ function requireAvailableTypedArrays() {
     }
     return out;
   };
-  return availableTypedArrays;
+  return availableTypedArrays;
+}
+var callBind = { exports: {} };
+var defineDataProperty;
+var hasRequiredDefineDataProperty;
+function requireDefineDataProperty() {
+  if (hasRequiredDefineDataProperty) return defineDataProperty;
+  hasRequiredDefineDataProperty = 1;
+  var $defineProperty = /* @__PURE__ */ requireEsDefineProperty();
+  var $SyntaxError = /* @__PURE__ */ requireSyntax();
+  var $TypeError = /* @__PURE__ */ requireType();
+  var gopd2 = /* @__PURE__ */ requireGopd();
+  defineDataProperty = function defineDataProperty2(obj, property, value) {
+    if (!obj || typeof obj !== "object" && typeof obj !== "function") {
+      throw new $TypeError("`obj` must be an object or a function`");
+    }
+    if (typeof property !== "string" && typeof property !== "symbol") {
+      throw new $TypeError("`property` must be a string or a symbol`");
+    }
+    if (arguments.length > 3 && typeof arguments[3] !== "boolean" && arguments[3] !== null) {
+      throw new $TypeError("`nonEnumerable`, if provided, must be a boolean or null");
+    }
+    if (arguments.length > 4 && typeof arguments[4] !== "boolean" && arguments[4] !== null) {
+      throw new $TypeError("`nonWritable`, if provided, must be a boolean or null");
+    }
+    if (arguments.length > 5 && typeof arguments[5] !== "boolean" && arguments[5] !== null) {
+      throw new $TypeError("`nonConfigurable`, if provided, must be a boolean or null");
+    }
+    if (arguments.length > 6 && typeof arguments[6] !== "boolean") {
+      throw new $TypeError("`loose`, if provided, must be a boolean");
+    }
+    var nonEnumerable = arguments.length > 3 ? arguments[3] : null;
+    var nonWritable = arguments.length > 4 ? arguments[4] : null;
+    var nonConfigurable = arguments.length > 5 ? arguments[5] : null;
+    var loose = arguments.length > 6 ? arguments[6] : false;
+    var desc = !!gopd2 && gopd2(obj, property);
+    if ($defineProperty) {
+      $defineProperty(obj, property, {
+        configurable: nonConfigurable === null && desc ? desc.configurable : !nonConfigurable,
+        enumerable: nonEnumerable === null && desc ? desc.enumerable : !nonEnumerable,
+        value,
+        writable: nonWritable === null && desc ? desc.writable : !nonWritable
+      });
+    } else if (loose || !nonEnumerable && !nonWritable && !nonConfigurable) {
+      obj[property] = value;
+    } else {
+      throw new $SyntaxError("This environment does not support defining a property as non-configurable, non-writable, or non-enumerable.");
+    }
+  };
+  return defineDataProperty;
+}
+var hasPropertyDescriptors_1;
+var hasRequiredHasPropertyDescriptors;
+function requireHasPropertyDescriptors() {
+  if (hasRequiredHasPropertyDescriptors) return hasPropertyDescriptors_1;
+  hasRequiredHasPropertyDescriptors = 1;
+  var $defineProperty = /* @__PURE__ */ requireEsDefineProperty();
+  var hasPropertyDescriptors = function hasPropertyDescriptors2() {
+    return !!$defineProperty;
+  };
+  hasPropertyDescriptors.hasArrayLengthDefineBug = function hasArrayLengthDefineBug() {
+    if (!$defineProperty) {
+      return null;
+    }
+    try {
+      return $defineProperty([], "length", { value: 1 }).length !== 1;
+    } catch (e) {
+      return true;
+    }
+  };
+  hasPropertyDescriptors_1 = hasPropertyDescriptors;
+  return hasPropertyDescriptors_1;
+}
+var setFunctionLength;
+var hasRequiredSetFunctionLength;
+function requireSetFunctionLength() {
+  if (hasRequiredSetFunctionLength) return setFunctionLength;
+  hasRequiredSetFunctionLength = 1;
+  var GetIntrinsic = /* @__PURE__ */ requireGetIntrinsic();
+  var define = /* @__PURE__ */ requireDefineDataProperty();
+  var hasDescriptors = /* @__PURE__ */ requireHasPropertyDescriptors()();
+  var gOPD2 = /* @__PURE__ */ requireGopd();
+  var $TypeError = /* @__PURE__ */ requireType();
+  var $floor = GetIntrinsic("%Math.floor%");
+  setFunctionLength = function setFunctionLength2(fn, length) {
+    if (typeof fn !== "function") {
+      throw new $TypeError("`fn` is not a function");
+    }
+    if (typeof length !== "number" || length < 0 || length > 4294967295 || $floor(length) !== length) {
+      throw new $TypeError("`length` must be a positive 32-bit integer");
+    }
+    var loose = arguments.length > 2 && !!arguments[2];
+    var functionLengthIsConfigurable = true;
+    var functionLengthIsWritable = true;
+    if ("length" in fn && gOPD2) {
+      var desc = gOPD2(fn, "length");
+      if (desc && !desc.configurable) {
+        functionLengthIsConfigurable = false;
+      }
+      if (desc && !desc.writable) {
+        functionLengthIsWritable = false;
+      }
+    }
+    if (functionLengthIsConfigurable || functionLengthIsWritable || !loose) {
+      if (hasDescriptors) {
+        define(
+          /** @type {Parameters<define>[0]} */
+          fn,
+          "length",
+          length,
+          true,
+          true
+        );
+      } else {
+        define(
+          /** @type {Parameters<define>[0]} */
+          fn,
+          "length",
+          length
+        );
+      }
+    }
+    return fn;
+  };
+  return setFunctionLength;
+}
+var applyBind;
+var hasRequiredApplyBind;
+function requireApplyBind() {
+  if (hasRequiredApplyBind) return applyBind;
+  hasRequiredApplyBind = 1;
+  var bind = requireFunctionBind();
+  var $apply = requireFunctionApply();
+  var actualApply2 = requireActualApply();
+  applyBind = function applyBind2() {
+    return actualApply2(bind, $apply, arguments);
+  };
+  return applyBind;
 }
-var callBound;
-var hasRequiredCallBound;
-function requireCallBound() {
-  if (hasRequiredCallBound) return callBound;
-  hasRequiredCallBound = 1;
-  var GetIntrinsic = /* @__PURE__ */ requireGetIntrinsic();
-  var callBindBasic = requireCallBindApplyHelpers();
-  var $indexOf = callBindBasic([GetIntrinsic("%String.prototype.indexOf%")]);
-  callBound = function callBoundIntrinsic(name, allowMissing) {
-    var intrinsic = (
-      /** @type {(this: unknown, ...args: unknown[]) => unknown} */
-      GetIntrinsic(name, !!allowMissing)
-    );
-    if (typeof intrinsic === "function" && $indexOf(name, ".prototype.") > -1) {
-      return callBindBasic(
-        /** @type {const} */
-        [intrinsic]
+var hasRequiredCallBind;
+function requireCallBind() {
+  if (hasRequiredCallBind) return callBind.exports;
+  hasRequiredCallBind = 1;
+  (function(module2) {
+    var setFunctionLength2 = /* @__PURE__ */ requireSetFunctionLength();
+    var $defineProperty = /* @__PURE__ */ requireEsDefineProperty();
+    var callBindBasic = requireCallBindApplyHelpers();
+    var applyBind2 = requireApplyBind();
+    module2.exports = function callBind2(originalFunction) {
+      var func = callBindBasic(arguments);
+      var adjustedLength = originalFunction.length - (arguments.length - 1);
+      return setFunctionLength2(
+        func,
+        1 + (adjustedLength > 0 ? adjustedLength : 0),
+        true
       );
+    };
+    if ($defineProperty) {
+      $defineProperty(module2.exports, "apply", { value: applyBind2 });
+    } else {
+      module2.exports.apply = applyBind2;
     }
-    return intrinsic;
-  };
-  return callBound;
+  })(callBind);
+  return callBind.exports;
 }
 var whichTypedArray;
 var hasRequiredWhichTypedArray;
@@ -3724,8 +3774,8 @@ var hasRequiredTypes;
 function requireTypes() {
   if (hasRequiredTypes) return types;
   hasRequiredTypes = 1;
-  (function(exports2) {
-    var isArgumentsObject = requireIsArguments();
+  (function(exports$1) {
+    var isArgumentsObject = /* @__PURE__ */ requireIsArguments();
     var isGeneratorFunction2 = requireIsGeneratorFunction();
     var whichTypedArray2 = /* @__PURE__ */ requireWhichTypedArray();
     var isTypedArray2 = /* @__PURE__ */ requireIsTypedArray();
@@ -3755,64 +3805,64 @@ function requireTypes() {
         return false;
       }
     }
-    exports2.isArgumentsObject = isArgumentsObject;
-    exports2.isGeneratorFunction = isGeneratorFunction2;
-    exports2.isTypedArray = isTypedArray2;
+    exports$1.isArgumentsObject = isArgumentsObject;
+    exports$1.isGeneratorFunction = isGeneratorFunction2;
+    exports$1.isTypedArray = isTypedArray2;
     function isPromise(input) {
       return typeof Promise !== "undefined" && input instanceof Promise || input !== null && typeof input === "object" && typeof input.then === "function" && typeof input.catch === "function";
     }
-    exports2.isPromise = isPromise;
+    exports$1.isPromise = isPromise;
     function isArrayBufferView(value) {
       if (typeof ArrayBuffer !== "undefined" && ArrayBuffer.isView) {
         return ArrayBuffer.isView(value);
       }
       return isTypedArray2(value) || isDataView(value);
     }
-    exports2.isArrayBufferView = isArrayBufferView;
+    exports$1.isArrayBufferView = isArrayBufferView;
     function isUint8Array(value) {
       return whichTypedArray2(value) === "Uint8Array";
     }
-    exports2.isUint8Array = isUint8Array;
+    exports$1.isUint8Array = isUint8Array;
     function isUint8ClampedArray(value) {
       return whichTypedArray2(value) === "Uint8ClampedArray";
     }
-    exports2.isUint8ClampedArray = isUint8ClampedArray;
+    exports$1.isUint8ClampedArray = isUint8ClampedArray;
     function isUint16Array(value) {
       return whichTypedArray2(value) === "Uint16Array";
     }
-    exports2.isUint16Array = isUint16Array;
+    exports$1.isUint16Array = isUint16Array;
     function isUint32Array(value) {
       return whichTypedArray2(value) === "Uint32Array";
     }
-    exports2.isUint32Array = isUint32Array;
+    exports$1.isUint32Array = isUint32Array;
     function isInt8Array(value) {
       return whichTypedArray2(value) === "Int8Array";
     }
-    exports2.isInt8Array = isInt8Array;
+    exports$1.isInt8Array = isInt8Array;
     function isInt16Array(value) {
       return whichTypedArray2(value) === "Int16Array";
     }
-    exports2.isInt16Array = isInt16Array;
+    exports$1.isInt16Array = isInt16Array;
     function isInt32Array(value) {
       return whichTypedArray2(value) === "Int32Array";
     }
-    exports2.isInt32Array = isInt32Array;
+    exports$1.isInt32Array = isInt32Array;
     function isFloat32Array(value) {
       return whichTypedArray2(value) === "Float32Array";
     }
-    exports2.isFloat32Array = isFloat32Array;
+    exports$1.isFloat32Array = isFloat32Array;
     function isFloat64Array(value) {
       return whichTypedArray2(value) === "Float64Array";
     }
-    exports2.isFloat64Array = isFloat64Array;
+    exports$1.isFloat64Array = isFloat64Array;
     function isBigInt64Array(value) {
       return whichTypedArray2(value) === "BigInt64Array";
     }
-    exports2.isBigInt64Array = isBigInt64Array;
+    exports$1.isBigInt64Array = isBigInt64Array;
     function isBigUint64Array(value) {
       return whichTypedArray2(value) === "BigUint64Array";
     }
-    exports2.isBigUint64Array = isBigUint64Array;
+    exports$1.isBigUint64Array = isBigUint64Array;
     function isMapToString(value) {
       return ObjectToString(value) === "[object Map]";
     }
@@ -3823,7 +3873,7 @@ function requireTypes() {
       }
       return isMapToString.working ? isMapToString(value) : value instanceof Map;
     }
-    exports2.isMap = isMap;
+    exports$1.isMap = isMap;
     function isSetToString(value) {
       return ObjectToString(value) === "[object Set]";
     }
@@ -3834,7 +3884,7 @@ function requireTypes() {
       }
       return isSetToString.working ? isSetToString(value) : value instanceof Set;
     }
-    exports2.isSet = isSet;
+    exports$1.isSet = isSet;
     function isWeakMapToString(value) {
       return ObjectToString(value) === "[object WeakMap]";
     }
@@ -3845,7 +3895,7 @@ function requireTypes() {
       }
       return isWeakMapToString.working ? isWeakMapToString(value) : value instanceof WeakMap;
     }
-    exports2.isWeakMap = isWeakMap;
+    exports$1.isWeakMap = isWeakMap;
     function isWeakSetToString(value) {
       return ObjectToString(value) === "[object WeakSet]";
     }
@@ -3853,7 +3903,7 @@ function requireTypes() {
     function isWeakSet(value) {
       return isWeakSetToString(value);
     }
-    exports2.isWeakSet = isWeakSet;
+    exports$1.isWeakSet = isWeakSet;
     function isArrayBufferToString(value) {
       return ObjectToString(value) === "[object ArrayBuffer]";
     }
@@ -3864,7 +3914,7 @@ function requireTypes() {
       }
       return isArrayBufferToString.working ? isArrayBufferToString(value) : value instanceof ArrayBuffer;
     }
-    exports2.isArrayBuffer = isArrayBuffer;
+    exports$1.isArrayBuffer = isArrayBuffer;
     function isDataViewToString(value) {
       return ObjectToString(value) === "[object DataView]";
     }
@@ -3875,7 +3925,7 @@ function requireTypes() {
       }
       return isDataViewToString.working ? isDataViewToString(value) : value instanceof DataView;
     }
-    exports2.isDataView = isDataView;
+    exports$1.isDataView = isDataView;
     var SharedArrayBufferCopy = typeof SharedArrayBuffer !== "undefined" ? SharedArrayBuffer : void 0;
     function isSharedArrayBufferToString(value) {
       return ObjectToString(value) === "[object SharedArrayBuffer]";
@@ -3889,57 +3939,57 @@ function requireTypes() {
       }
       return isSharedArrayBufferToString.working ? isSharedArrayBufferToString(value) : value instanceof SharedArrayBufferCopy;
     }
-    exports2.isSharedArrayBuffer = isSharedArrayBuffer;
+    exports$1.isSharedArrayBuffer = isSharedArrayBuffer;
     function isAsyncFunction(value) {
       return ObjectToString(value) === "[object AsyncFunction]";
     }
-    exports2.isAsyncFunction = isAsyncFunction;
+    exports$1.isAsyncFunction = isAsyncFunction;
     function isMapIterator(value) {
       return ObjectToString(value) === "[object Map Iterator]";
     }
-    exports2.isMapIterator = isMapIterator;
+    exports$1.isMapIterator = isMapIterator;
     function isSetIterator(value) {
       return ObjectToString(value) === "[object Set Iterator]";
     }
-    exports2.isSetIterator = isSetIterator;
+    exports$1.isSetIterator = isSetIterator;
     function isGeneratorObject(value) {
       return ObjectToString(value) === "[object Generator]";
     }
-    exports2.isGeneratorObject = isGeneratorObject;
+    exports$1.isGeneratorObject = isGeneratorObject;
     function isWebAssemblyCompiledModule(value) {
       return ObjectToString(value) === "[object WebAssembly.Module]";
     }
-    exports2.isWebAssemblyCompiledModule = isWebAssemblyCompiledModule;
+    exports$1.isWebAssemblyCompiledModule = isWebAssemblyCompiledModule;
     function isNumberObject(value) {
       return checkBoxedPrimitive(value, numberValue);
     }
-    exports2.isNumberObject = isNumberObject;
+    exports$1.isNumberObject = isNumberObject;
     function isStringObject(value) {
       return checkBoxedPrimitive(value, stringValue);
     }
-    exports2.isStringObject = isStringObject;
+    exports$1.isStringObject = isStringObject;
     function isBooleanObject(value) {
       return checkBoxedPrimitive(value, booleanValue);
     }
-    exports2.isBooleanObject = isBooleanObject;
+    exports$1.isBooleanObject = isBooleanObject;
     function isBigIntObject(value) {
       return BigIntSupported && checkBoxedPrimitive(value, bigIntValue);
     }
-    exports2.isBigIntObject = isBigIntObject;
+    exports$1.isBigIntObject = isBigIntObject;
     function isSymbolObject(value) {
       return SymbolSupported && checkBoxedPrimitive(value, symbolValue);
     }
-    exports2.isSymbolObject = isSymbolObject;
+    exports$1.isSymbolObject = isSymbolObject;
     function isBoxedPrimitive(value) {
       return isNumberObject(value) || isStringObject(value) || isBooleanObject(value) || isBigIntObject(value) || isSymbolObject(value);
     }
-    exports2.isBoxedPrimitive = isBoxedPrimitive;
+    exports$1.isBoxedPrimitive = isBoxedPrimitive;
     function isAnyArrayBuffer(value) {
       return typeof Uint8Array !== "undefined" && (isArrayBuffer(value) || isSharedArrayBuffer(value));
     }
-    exports2.isAnyArrayBuffer = isAnyArrayBuffer;
+    exports$1.isAnyArrayBuffer = isAnyArrayBuffer;
     ["isProxy", "isExternal", "isModuleNamespaceObject"].forEach(function(method) {
-      Object.defineProperty(exports2, method, {
+      Object.defineProperty(exports$1, method, {
         enumerable: false,
         value: function() {
           throw new Error(method + " is not supported in userland");
@@ -3963,7 +4013,7 @@ var hasRequiredUtil;
 function requireUtil() {
   if (hasRequiredUtil) return util;
   hasRequiredUtil = 1;
-  (function(exports2) {
+  (function(exports$1) {
     var getOwnPropertyDescriptors = Object.getOwnPropertyDescriptors || function getOwnPropertyDescriptors2(obj) {
       var keys = Object.keys(obj);
       var descriptors = {};
@@ -3973,7 +4023,7 @@ function requireUtil() {
       return descriptors;
     };
     var formatRegExp = /%[sdj%]/g;
-    exports2.format = function(f) {
+    exports$1.format = function(f) {
       if (!isString(f)) {
         var objects = [];
         for (var i = 0; i < arguments.length; i++) {
@@ -4011,13 +4061,13 @@ function requireUtil() {
       }
       return str;
     };
-    exports2.deprecate = function(fn, msg) {
+    exports$1.deprecate = function(fn, msg) {
       if (typeof process$1 !== "undefined" && process$1.noDeprecation === true) {
         return fn;
       }
       if (typeof process$1 === "undefined") {
         return function() {
-          return exports2.deprecate(fn, msg).apply(this, arguments);
+          return exports$1.deprecate(fn, msg).apply(this, arguments);
         };
       }
       var warned = false;
@@ -4043,13 +4093,13 @@ function requireUtil() {
       debugEnv = debugEnv.replace(/[|\\{}()[\]^$+?.]/g, "\\$&").replace(/\*/g, ".*").replace(/,/g, "$|^").toUpperCase();
       debugEnvRegex = new RegExp("^" + debugEnv + "$", "i");
     }
-    exports2.debuglog = function(set) {
+    exports$1.debuglog = function(set) {
       set = set.toUpperCase();
       if (!debugs[set]) {
         if (debugEnvRegex.test(set)) {
           var pid = process$1.pid;
           debugs[set] = function() {
-            var msg = exports2.format.apply(exports2, arguments);
+            var msg = exports$1.format.apply(exports$1, arguments);
             console.error("%s %d: %s", set, pid, msg);
           };
         } else {
@@ -4069,7 +4119,7 @@ function requireUtil() {
       if (isBoolean(opts)) {
         ctx.showHidden = opts;
       } else if (opts) {
-        exports2._extend(ctx, opts);
+        exports$1._extend(ctx, opts);
       }
       if (isUndefined(ctx.showHidden)) ctx.showHidden = false;
       if (isUndefined(ctx.depth)) ctx.depth = 2;
@@ -4078,7 +4128,7 @@ function requireUtil() {
       if (ctx.colors) ctx.stylize = stylizeWithColor;
       return formatValue(ctx, obj, ctx.depth);
     }
-    exports2.inspect = inspect;
+    exports$1.inspect = inspect;
     inspect.colors = {
       "bold": [1, 22],
       "italic": [3, 23],
@@ -4125,7 +4175,7 @@ function requireUtil() {
     }
     function formatValue(ctx, value, recurseTimes) {
       if (ctx.customInspect && value && isFunction(value.inspect) && // Filter out the util module, it's inspect function is special
-      value.inspect !== exports2.inspect && // Also filter out any prototype objects using the circular check.
+      value.inspect !== exports$1.inspect && // Also filter out any prototype objects using the circular check.
       !(value.constructor && value.constructor.prototype === value)) {
         var ret = value.inspect(recurseTimes, ctx);
         if (!isString(ret)) {
@@ -4311,68 +4361,68 @@ function requireUtil() {
       }
       return braces[0] + base + " " + output.join(", ") + " " + braces[1];
     }
-    exports2.types = requireTypes();
+    exports$1.types = requireTypes();
     function isArray(ar) {
       return Array.isArray(ar);
     }
-    exports2.isArray = isArray;
+    exports$1.isArray = isArray;
     function isBoolean(arg) {
       return typeof arg === "boolean";
     }
-    exports2.isBoolean = isBoolean;
+    exports$1.isBoolean = isBoolean;
     function isNull(arg) {
       return arg === null;
     }
-    exports2.isNull = isNull;
+    exports$1.isNull = isNull;
     function isNullOrUndefined(arg) {
       return arg == null;
     }
-    exports2.isNullOrUndefined = isNullOrUndefined;
+    exports$1.isNullOrUndefined = isNullOrUndefined;
     function isNumber(arg) {
       return typeof arg === "number";
     }
-    exports2.isNumber = isNumber;
+    exports$1.isNumber = isNumber;
     function isString(arg) {
       return typeof arg === "string";
     }
-    exports2.isString = isString;
+    exports$1.isString = isString;
     function isSymbol(arg) {
       return typeof arg === "symbol";
     }
-    exports2.isSymbol = isSymbol;
+    exports$1.isSymbol = isSymbol;
     function isUndefined(arg) {
       return arg === void 0;
     }
-    exports2.isUndefined = isUndefined;
+    exports$1.isUndefined = isUndefined;
     function isRegExp(re) {
       return isObject(re) && objectToString(re) === "[object RegExp]";
     }
-    exports2.isRegExp = isRegExp;
-    exports2.types.isRegExp = isRegExp;
+    exports$1.isRegExp = isRegExp;
+    exports$1.types.isRegExp = isRegExp;
     function isObject(arg) {
       return typeof arg === "object" && arg !== null;
     }
-    exports2.isObject = isObject;
+    exports$1.isObject = isObject;
     function isDate(d) {
       return isObject(d) && objectToString(d) === "[object Date]";
     }
-    exports2.isDate = isDate;
-    exports2.types.isDate = isDate;
+    exports$1.isDate = isDate;
+    exports$1.types.isDate = isDate;
     function isError(e) {
       return isObject(e) && (objectToString(e) === "[object Error]" || e instanceof Error);
     }
-    exports2.isError = isError;
-    exports2.types.isNativeError = isError;
+    exports$1.isError = isError;
+    exports$1.types.isNativeError = isError;
     function isFunction(arg) {
       return typeof arg === "function";
     }
-    exports2.isFunction = isFunction;
+    exports$1.isFunction = isFunction;
     function isPrimitive(arg) {
       return arg === null || typeof arg === "boolean" || typeof arg === "number" || typeof arg === "string" || typeof arg === "symbol" || // ES6 symbol
       typeof arg === "undefined";
     }
-    exports2.isPrimitive = isPrimitive;
-    exports2.isBuffer = requireIsBufferBrowser();
+    exports$1.isPrimitive = isPrimitive;
+    exports$1.isBuffer = requireIsBufferBrowser();
     function objectToString(o) {
       return Object.prototype.toString.call(o);
     }
@@ -4402,11 +4452,11 @@ function requireUtil() {
       ].join(":");
       return [d.getDate(), months[d.getMonth()], time].join(" ");
     }
-    exports2.log = function() {
-      console.log("%s - %s", timestamp(), exports2.format.apply(exports2, arguments));
+    exports$1.log = function() {
+      console.log("%s - %s", timestamp(), exports$1.format.apply(exports$1, arguments));
     };
-    exports2.inherits = requireInherits_browser();
-    exports2._extend = function(origin, add) {
+    exports$1.inherits = requireInherits_browser();
+    exports$1._extend = function(origin, add) {
       if (!add || !isObject(add)) return origin;
       var keys = Object.keys(add);
       var i = keys.length;
@@ -4418,8 +4468,8 @@ function requireUtil() {
     function hasOwnProperty(obj, prop) {
       return Object.prototype.hasOwnProperty.call(obj, prop);
     }
-    var kCustomPromisifiedSymbol = typeof Symbol !== "undefined" ? Symbol("util.promisify.custom") : void 0;
-    exports2.promisify = function promisify(original) {
+    var kCustomPromisifiedSymbol = typeof Symbol !== "undefined" ? /* @__PURE__ */ Symbol("util.promisify.custom") : void 0;
+    exports$1.promisify = function promisify(original) {
       if (typeof original !== "function")
         throw new TypeError('The "original" argument must be of type Function');
       if (kCustomPromisifiedSymbol && original[kCustomPromisifiedSymbol]) {
@@ -4471,7 +4521,7 @@ function requireUtil() {
         getOwnPropertyDescriptors(original)
       );
     };
-    exports2.promisify.custom = kCustomPromisifiedSymbol;
+    exports$1.promisify.custom = kCustomPromisifiedSymbol;
     function callbackifyOnRejected(reason, cb) {
       if (!reason) {
         var newReason = new Error("Promise was rejected with a falsy value");
@@ -4513,7 +4563,7 @@ function requireUtil() {
       );
       return callbackified;
     }
-    exports2.callbackify = callbackify;
+    exports$1.callbackify = callbackify;
   })(util);
   return util;
 }
@@ -4526,31 +4576,25 @@ function requireBuffer_list() {
     var keys = Object.keys(object);
     if (Object.getOwnPropertySymbols) {
       var symbols = Object.getOwnPropertySymbols(object);
-      if (enumerableOnly) symbols = symbols.filter(function(sym) {
+      enumerableOnly && (symbols = symbols.filter(function(sym) {
         return Object.getOwnPropertyDescriptor(object, sym).enumerable;
-      });
-      keys.push.apply(keys, symbols);
+      })), keys.push.apply(keys, symbols);
     }
     return keys;
   }
   function _objectSpread(target) {
     for (var i = 1; i < arguments.length; i++) {
-      var source = arguments[i] != null ? arguments[i] : {};
-      if (i % 2) {
-        ownKeys(Object(source), true).forEach(function(key) {
-          _defineProperty(target, key, source[key]);
-        });
-      } else if (Object.getOwnPropertyDescriptors) {
-        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
-      } else {
-        ownKeys(Object(source)).forEach(function(key) {
-          Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
-        });
-      }
+      var source = null != arguments[i] ? arguments[i] : {};
+      i % 2 ? ownKeys(Object(source), true).forEach(function(key) {
+        _defineProperty(target, key, source[key]);
+      }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function(key) {
+        Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+      });
     }
     return target;
   }
   function _defineProperty(obj, key, value) {
+    key = _toPropertyKey(key);
     if (key in obj) {
       Object.defineProperty(obj, key, { value, enumerable: true, configurable: true, writable: true });
     } else {
@@ -4569,20 +4613,35 @@ function requireBuffer_list() {
       descriptor.enumerable = descriptor.enumerable || false;
       descriptor.configurable = true;
       if ("value" in descriptor) descriptor.writable = true;
-      Object.defineProperty(target, descriptor.key, descriptor);
+      Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor);
     }
   }
   function _createClass(Constructor, protoProps, staticProps) {
     if (protoProps) _defineProperties(Constructor.prototype, protoProps);
+    Object.defineProperty(Constructor, "prototype", { writable: false });
     return Constructor;
   }
+  function _toPropertyKey(arg) {
+    var key = _toPrimitive(arg, "string");
+    return typeof key === "symbol" ? key : String(key);
+  }
+  function _toPrimitive(input, hint) {
+    if (typeof input !== "object" || input === null) return input;
+    var prim = input[Symbol.toPrimitive];
+    if (prim !== void 0) {
+      var res = prim.call(input, hint);
+      if (typeof res !== "object") return res;
+      throw new TypeError("@@toPrimitive must return a primitive value.");
+    }
+    return String(input);
+  }
   var _require = requireBuffer(), Buffer2 = _require.Buffer;
   var _require2 = requireUtil(), inspect = _require2.inspect;
   var custom = inspect && inspect.custom || "inspect";
   function copyBuffer(src, target, offset) {
     Buffer2.prototype.copy.call(src, target, offset);
   }
-  buffer_list = /* @__PURE__ */ function() {
+  buffer_list = /* @__PURE__ */ (function() {
     function BufferList() {
       _classCallCheck(this, BufferList);
       this.head = null;
@@ -4634,9 +4693,7 @@ function requireBuffer_list() {
         if (this.length === 0) return "";
         var p = this.head;
         var ret = "" + p.data;
-        while (p = p.next) {
-          ret += s + p.data;
-        }
+        while (p = p.next) ret += s + p.data;
         return ret;
       }
     }, {
@@ -4737,7 +4794,7 @@ function requireBuffer_list() {
     }, {
       key: custom,
       value: function value(_, options) {
-        return inspect(this, _objectSpread({}, options, {
+        return inspect(this, _objectSpread(_objectSpread({}, options), {}, {
           // Only inspect one level.
           depth: 0,
           // It should not recurse.
@@ -4746,7 +4803,7 @@ function requireBuffer_list() {
       }
     }]);
     return BufferList;
-  }();
+  })();
   return buffer_list;
 }
 var destroy_1;
@@ -4860,13 +4917,13 @@ function requireErrorsBrowser() {
         return message(arg1, arg2, arg3);
       }
     }
-    var NodeError = /* @__PURE__ */ function(_Base) {
+    var NodeError = /* @__PURE__ */ (function(_Base) {
       _inheritsLoose(NodeError2, _Base);
       function NodeError2(arg1, arg2, arg3) {
         return _Base.call(this, getMessage(arg1, arg2, arg3)) || this;
       }
       return NodeError2;
-    }(Base);
+    })(Base);
     NodeError.prototype.name = Base.name;
     NodeError.prototype.code = code;
     codes[code] = NodeError;
@@ -5031,7 +5088,7 @@ function require_stream_writable() {
   };
   var Stream = requireStreamBrowser();
   var Buffer2 = requireBuffer().Buffer;
-  var OurUint8Array = commonjsGlobal.Uint8Array || function() {
+  var OurUint8Array = (typeof commonjsGlobal !== "undefined" ? commonjsGlobal : typeof window !== "undefined" ? window : typeof self !== "undefined" ? self : {}).Uint8Array || function() {
   };
   function _uint8ArrayToBuffer(chunk) {
     return Buffer2.from(chunk);
@@ -5479,9 +5536,7 @@ function require_stream_duplex() {
   hasRequired_stream_duplex = 1;
   var objectKeys = Object.keys || function(obj) {
     var keys2 = [];
-    for (var key in obj) {
-      keys2.push(key);
-    }
+    for (var key in obj) keys2.push(key);
     return keys2;
   };
   _stream_duplex = Duplex;
@@ -5570,7 +5625,7 @@ var hasRequiredSafeBuffer;
 function requireSafeBuffer() {
   if (hasRequiredSafeBuffer) return safeBuffer.exports;
   hasRequiredSafeBuffer = 1;
-  (function(module2, exports2) {
+  (function(module2, exports$1) {
     var buffer2 = requireBuffer();
     var Buffer2 = buffer2.Buffer;
     function copyProps(src, dst) {
@@ -5581,8 +5636,8 @@ function requireSafeBuffer() {
     if (Buffer2.from && Buffer2.alloc && Buffer2.allocUnsafe && Buffer2.allocUnsafeSlow) {
       module2.exports = buffer2;
     } else {
-      copyProps(buffer2, exports2);
-      exports2.Buffer = SafeBuffer;
+      copyProps(buffer2, exports$1);
+      exports$1.Buffer = SafeBuffer;
     }
     function SafeBuffer(arg, encodingOrOffset, length) {
       return Buffer2(arg, encodingOrOffset, length);
@@ -5958,6 +6013,7 @@ function requireAsync_iterator() {
   hasRequiredAsync_iterator = 1;
   var _Object$setPrototypeO;
   function _defineProperty(obj, key, value) {
+    key = _toPropertyKey(key);
     if (key in obj) {
       Object.defineProperty(obj, key, { value, enumerable: true, configurable: true, writable: true });
     } else {
@@ -5965,14 +6021,28 @@ function requireAsync_iterator() {
     }
     return obj;
   }
+  function _toPropertyKey(arg) {
+    var key = _toPrimitive(arg, "string");
+    return typeof key === "symbol" ? key : String(key);
+  }
+  function _toPrimitive(input, hint) {
+    if (typeof input !== "object" || input === null) return input;
+    var prim = input[Symbol.toPrimitive];
+    if (prim !== void 0) {
+      var res = prim.call(input, hint);
+      if (typeof res !== "object") return res;
+      throw new TypeError("@@toPrimitive must return a primitive value.");
+    }
+    return (hint === "string" ? String : Number)(input);
+  }
   var finished = requireEndOfStream();
-  var kLastResolve = Symbol("lastResolve");
-  var kLastReject = Symbol("lastReject");
-  var kError = Symbol("error");
-  var kEnded = Symbol("ended");
-  var kLastPromise = Symbol("lastPromise");
-  var kHandlePromise = Symbol("handlePromise");
-  var kStream = Symbol("stream");
+  var kLastResolve = /* @__PURE__ */ Symbol("lastResolve");
+  var kLastReject = /* @__PURE__ */ Symbol("lastReject");
+  var kError = /* @__PURE__ */ Symbol("error");
+  var kEnded = /* @__PURE__ */ Symbol("ended");
+  var kLastPromise = /* @__PURE__ */ Symbol("lastPromise");
+  var kHandlePromise = /* @__PURE__ */ Symbol("handlePromise");
+  var kStream = /* @__PURE__ */ Symbol("stream");
   function createIterResult(value, done) {
     return {
       value,
@@ -6143,7 +6213,7 @@ function require_stream_readable() {
   };
   var Stream = requireStreamBrowser();
   var Buffer2 = requireBuffer().Buffer;
-  var OurUint8Array = commonjsGlobal.Uint8Array || function() {
+  var OurUint8Array = (typeof commonjsGlobal !== "undefined" ? commonjsGlobal : typeof window !== "undefined" ? window : typeof self !== "undefined" ? self : {}).Uint8Array || function() {
   };
   function _uint8ArrayToBuffer(chunk) {
     return Buffer2.from(chunk);
@@ -6608,11 +6678,9 @@ function require_stream_readable() {
       state2.pipes = null;
       state2.pipesCount = 0;
       state2.flowing = false;
-      for (var i = 0; i < len; i++) {
-        dests[i].emit("unpipe", this, {
-          hasUnpiped: false
-        });
-      }
+      for (var i = 0; i < len; i++) dests[i].emit("unpipe", this, {
+        hasUnpiped: false
+      });
       return this;
     }
     var index = indexOf(state2.pipes, dest);
@@ -6711,8 +6779,7 @@ function require_stream_readable() {
   function flow(stream) {
     var state2 = stream._readableState;
     debug("flow", state2.flowing);
-    while (state2.flowing && stream.read() !== null) {
-    }
+    while (state2.flowing && stream.read() !== null) ;
   }
   Readable.prototype.wrap = function(stream) {
     var _this = this;
@@ -6739,11 +6806,11 @@ function require_stream_readable() {
     });
     for (var i in stream) {
       if (this[i] === void 0 && typeof stream[i] === "function") {
-        this[i] = /* @__PURE__ */ function methodWrap(method) {
+        this[i] = /* @__PURE__ */ (function methodWrap(method) {
           return function methodWrapReturnFunction() {
             return stream[method].apply(stream, arguments);
           };
-        }(i);
+        })(i);
       }
     }
     for (var n = 0; n < kProxyEvents.length; n++) {
@@ -7139,7 +7206,7 @@ var hasRequiredSax;
 function requireSax() {
   if (hasRequiredSax) return sax;
   hasRequiredSax = 1;
-  (function(exports2) {
+  (function(exports$1) {
     (function(sax2) {
       sax2.parser = function(strict, opt) {
         return new SAXParser(strict, opt);
@@ -8516,7 +8583,6 @@ function requireSax() {
         }
         return parser;
       }
-      /*! http://mths.be/fromcodepoint v0.1.0 by @mathias */
       if (!String.fromCodePoint) {
         (function() {
           var stringFromCharCode = String.fromCharCode;
@@ -8566,7 +8632,7 @@ function requireSax() {
           }
         })();
       }
-    })(exports2);
+    })(exports$1);
   })(sax);
   return sax;
 }
@@ -9386,9 +9452,20 @@ class ImportedXmlComponentAttributes extends XmlAttributeComponent {
 }
 class ImportedXmlComponent extends XmlComponent {
   /**
-   * Converts the xml string to a XmlComponent tree.
+   * Parses an XML string and converts it to an ImportedXmlComponent tree.
+   *
+   * This static method is the primary way to import external XML content.
+   * It uses xml-js to parse the XML string into a JSON representation,
+   * then converts that into a tree of XmlComponent objects.
    *
-   * @param importedContent xml content of the imported component
+   * @param importedContent - The XML content as a string
+   * @returns An ImportedXmlComponent representing the parsed XML
+   *
+   * @example
+   * ```typescript
+   * const xml = '<w:p><w:r><w:t>Hello</w:t></w:r></w:p>';
+   * const component = ImportedXmlComponent.fromXmlString(xml);
+   * ```
    */
   static fromXmlString(importedContent) {
     const xmlObj = libExports.xml2js(importedContent, { compact: false });
@@ -9397,8 +9474,8 @@ class ImportedXmlComponent extends XmlComponent {
   /**
    * Creates an ImportedXmlComponent.
    *
-   * @param rootKey the root element name
-   * @param _attr optional attributes for the root element
+   * @param rootKey - The XML element name
+   * @param _attr - Optional attributes for the root element
    */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   constructor(rootKey, _attr) {
@@ -9407,16 +9484,32 @@ class ImportedXmlComponent extends XmlComponent {
       this.root.push(new ImportedXmlComponentAttributes(_attr));
     }
   }
+  /**
+   * Adds a child component or text to this element.
+   *
+   * @param xmlComponent - The child component or text string to add
+   */
   push(xmlComponent) {
     this.root.push(xmlComponent);
   }
 }
 class ImportedRootElementAttributes extends XmlComponent {
+  /**
+   * Creates an ImportedRootElementAttributes component.
+   *
+   * @param _attr - The attributes object to pass through
+   */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   constructor(_attr) {
     super("");
     this._attr = _attr;
   }
+  /**
+   * Prepares the attributes for XML serialization.
+   *
+   * @param _ - Context (unused)
+   * @returns Object with _attr key containing the raw attributes
+   */
   prepForXml(_) {
     return {
       _attr: this._attr
@@ -9425,6 +9518,12 @@ class ImportedRootElementAttributes extends XmlComponent {
 }
 const WORKAROUND3 = "";
 class InitializableXmlComponent extends XmlComponent {
+  /**
+   * Creates a new InitializableXmlComponent.
+   *
+   * @param rootKey - The XML element name
+   * @param initComponent - Optional component to copy children from
+   */
   constructor(rootKey, initComponent) {
     super(rootKey);
     if (initComponent) {
@@ -9495,6 +9594,12 @@ const eighthPointMeasureValue = unsignedDecimalNumber;
 const pointMeasureValue = unsignedDecimalNumber;
 const dateTimeValue = (val) => val.toISOString();
 class OnOffElement extends XmlComponent {
+  /**
+   * Creates an OnOffElement.
+   *
+   * @param name - The XML element name (e.g., "w:b", "w:i")
+   * @param val - The boolean value (defaults to true)
+   */
   constructor(name, val = true) {
     super(name);
     if (val !== true) {
@@ -9503,6 +9608,12 @@ class OnOffElement extends XmlComponent {
   }
 }
 class HpsMeasureElement extends XmlComponent {
+  /**
+   * Creates an HpsMeasureElement.
+   *
+   * @param name - The XML element name
+   * @param val - The measurement value (number in half-points or string with units)
+   */
   constructor(name, val) {
     super(name);
     this.root.push(new Attributes({ val: hpsMeasureValue(val) }));
@@ -9511,6 +9622,12 @@ class HpsMeasureElement extends XmlComponent {
 class EmptyElement extends XmlComponent {
 }
 class StringValueElement extends XmlComponent {
+  /**
+   * Creates a StringValueElement.
+   *
+   * @param name - The XML element name
+   * @param val - The string value
+   */
   constructor(name, val) {
     super(name);
     this.root.push(new Attributes({ val }));
@@ -9523,24 +9640,50 @@ const createStringElement = (name, value) => new BuilderElement({
   }
 });
 class NumberValueElement extends XmlComponent {
+  /**
+   * Creates a NumberValueElement.
+   *
+   * @param name - The XML element name
+   * @param val - The numeric value
+   */
   constructor(name, val) {
     super(name);
     this.root.push(new Attributes({ val }));
   }
 }
 class StringEnumValueElement extends XmlComponent {
+  /**
+   * Creates a StringEnumValueElement.
+   *
+   * @param name - The XML element name
+   * @param val - The enum value
+   */
   constructor(name, val) {
     super(name);
     this.root.push(new Attributes({ val }));
   }
 }
 class StringContainer extends XmlComponent {
+  /**
+   * Creates a StringContainer.
+   *
+   * @param name - The XML element name
+   * @param val - The text content
+   */
   constructor(name, val) {
     super(name);
     this.root.push(val);
   }
 }
 class BuilderElement extends XmlComponent {
+  /**
+   * Creates a BuilderElement with the specified configuration.
+   *
+   * @param config - Element configuration
+   * @param config.name - The XML element name
+   * @param config.attributes - Optional attributes with explicit key-value pairs
+   * @param config.children - Optional child elements
+   */
   constructor({
     name,
     attributes,
@@ -9775,17 +9918,27 @@ class End extends XmlComponent {
   }
 }
 const HorizontalPositionAlign = {
+  /** Center horizontally */
   CENTER: "center",
+  /** Align to inside margin (left on odd, right on even pages) */
   INSIDE: "inside",
+  /** Align to left */
   LEFT: "left",
+  /** Align to outside margin (right on odd, left on even pages) */
   OUTSIDE: "outside",
+  /** Align to right */
   RIGHT: "right"
 };
 const VerticalPositionAlign = {
+  /** Align to bottom */
   BOTTOM: "bottom",
+  /** Center vertically */
   CENTER: "center",
+  /** Align to inside margin */
   INSIDE: "inside",
+  /** Align to outside margin */
   OUTSIDE: "outside",
+  /** Align to top */
   TOP: "top"
 };
 const NumberFormat$1 = {
@@ -9914,6 +10067,7 @@ class Shading extends XmlComponent {
   }
 }
 const ShadingType = {
+  /** Clear shading - no pattern, fill color only */
   CLEAR: "clear",
   DIAGONAL_CROSS: "diagCross",
   DIAGONAL_STRIPE: "diagStripe",
@@ -9963,6 +10117,7 @@ class ChangeAttributes extends XmlAttributeComponent {
   }
 }
 const EmphasisMarkType = {
+  /** Dot emphasis mark */
   DOT: "dot"
 };
 class BaseEmphasisMark extends XmlComponent {
@@ -10095,23 +10250,41 @@ class SubScript extends VerticalAlign$1 {
   }
 }
 const UnderlineType = {
+  /** Single underline */
   SINGLE: "single",
+  /** Underline words only (not spaces) */
   WORDS: "words",
+  /** Double underline */
   DOUBLE: "double",
+  /** Thick single underline */
   THICK: "thick",
+  /** Dotted underline */
   DOTTED: "dotted",
+  /** Heavy dotted underline */
   DOTTEDHEAVY: "dottedHeavy",
+  /** Dashed underline */
   DASH: "dash",
+  /** Heavy dashed underline */
   DASHEDHEAVY: "dashedHeavy",
+  /** Long dashed underline */
   DASHLONG: "dashLong",
+  /** Heavy long dashed underline */
   DASHLONGHEAVY: "dashLongHeavy",
+  /** Dot-dash underline */
   DOTDASH: "dotDash",
+  /** Heavy dot-dash underline */
   DASHDOTHEAVY: "dashDotHeavy",
+  /** Dot-dot-dash underline */
   DOTDOTDASH: "dotDotDash",
+  /** Heavy dot-dot-dash underline */
   DASHDOTDOTHEAVY: "dashDotDotHeavy",
+  /** Wave underline */
   WAVE: "wave",
+  /** Heavy wave underline */
   WAVYHEAVY: "wavyHeavy",
+  /** Double wave underline */
   WAVYDOUBLE: "wavyDouble",
+  /** No underline */
   NONE: "none"
 };
 class Underline extends XmlComponent {
@@ -10126,31 +10299,55 @@ class Underline extends XmlComponent {
   }
 }
 const TextEffect = {
+  /** Blinking background animation */
   BLINK_BACKGROUND: "blinkBackground",
+  /** Lights animation effect */
   LIGHTS: "lights",
+  /** Black marching ants animation */
   ANTS_BLACK: "antsBlack",
+  /** Red marching ants animation */
   ANTS_RED: "antsRed",
+  /** Shimmer animation effect */
   SHIMMER: "shimmer",
+  /** Sparkle animation effect */
   SPARKLE: "sparkle",
+  /** No text effect */
   NONE: "none"
 };
 const HighlightColor = {
+  /** Black highlight */
   BLACK: "black",
+  /** Blue highlight */
   BLUE: "blue",
+  /** Cyan highlight */
   CYAN: "cyan",
+  /** Dark blue highlight */
   DARK_BLUE: "darkBlue",
+  /** Dark cyan highlight */
   DARK_CYAN: "darkCyan",
+  /** Dark gray highlight */
   DARK_GRAY: "darkGray",
+  /** Dark green highlight */
   DARK_GREEN: "darkGreen",
+  /** Dark magenta highlight */
   DARK_MAGENTA: "darkMagenta",
+  /** Dark red highlight */
   DARK_RED: "darkRed",
+  /** Dark yellow highlight */
   DARK_YELLOW: "darkYellow",
+  /** Green highlight */
   GREEN: "green",
+  /** Light gray highlight */
   LIGHT_GRAY: "lightGray",
+  /** Magenta highlight */
   MAGENTA: "magenta",
+  /** No highlight */
   NONE: "none",
+  /** Red highlight */
   RED: "red",
+  /** White highlight */
   WHITE: "white",
+  /** Yellow highlight */
   YELLOW: "yellow"
 };
 class RunProperties extends IgnoreIfEmptyXmlComponent {
@@ -10307,9 +10504,13 @@ class Text extends XmlComponent {
   }
 }
 const PageNumber = {
+  /** Inserts the current page number */
   CURRENT: "CURRENT",
+  /** Inserts the total number of pages in the document */
   TOTAL_PAGES: "TOTAL_PAGES",
+  /** Inserts the total number of pages in the current section */
   TOTAL_PAGES_IN_SECTION: "TOTAL_PAGES_IN_SECTION",
+  /** Inserts the current section number */
   CURRENT_SECTION: "SECTION"
 };
 class Run extends XmlComponent {
@@ -12023,8 +12224,8 @@ var hasRequiredHash;
 function requireHash() {
   if (hasRequiredHash) return hash$1;
   hasRequiredHash = 1;
-  (function(exports2) {
-    var hash2 = exports2;
+  (function(exports$1) {
+    var hash2 = exports$1;
     hash2.utils = requireUtils();
     hash2.common = requireCommon$1();
     hash2.sha = requireSha();
@@ -12623,9 +12824,13 @@ const TextWrappingType = {
   TOP_AND_BOTTOM: 3
 };
 const TextWrappingSide = {
+  /** Text wraps on both sides of the drawing */
   BOTH_SIDES: "bothSides",
+  /** Text wraps only on the left side */
   LEFT: "left",
+  /** Text wraps only on the right side */
   RIGHT: "right",
+  /** Text wraps on the side with more space */
   LARGEST: "largest"
 };
 class WrapNone extends XmlComponent {
@@ -13048,6 +13253,7 @@ class RelationshipAttributes extends XmlAttributeComponent {
   }
 }
 const TargetModeType = {
+  /** Target is external to the package (e.g., hyperlink to a URL) */
   EXTERNAL: "External"
 };
 class Relationship extends XmlComponent {
@@ -13072,11 +13278,24 @@ class Relationships extends XmlComponent {
       })
     );
   }
+  /**
+   * Creates a new relationship to another part in the package.
+   *
+   * @param id - Unique identifier for this relationship (will be prefixed with "rId")
+   * @param type - Relationship type URI (e.g., image, header, hyperlink)
+   * @param target - Path to the target part
+   * @param targetMode - Optional mode indicating if target is external
+   * @returns The created Relationship instance
+   */
   createRelationship(id, type2, target, targetMode) {
     const relationship = new Relationship(`rId${id}`, type2, target, targetMode);
     this.root.push(relationship);
     return relationship;
   }
+  /**
+   * Gets the count of relationships in this collection.
+   * Excludes the attributes element from the count.
+   */
   get RelationshipCount() {
     return this.root.length - 1;
   }
@@ -13299,19 +13518,29 @@ class LastRenderedPageBreak extends EmptyElement {
   }
 }
 const PositionalTabAlignment = {
+  /** Left-aligned tab */
   LEFT: "left",
+  /** Center-aligned tab */
   CENTER: "center",
+  /** Right-aligned tab */
   RIGHT: "right"
 };
 const PositionalTabRelativeTo = {
+  /** Position relative to margin */
   MARGIN: "margin",
+  /** Position relative to indent */
   INDENT: "indent"
 };
 const PositionalTabLeader = {
+  /** No leader character */
   NONE: "none",
+  /** Dot leader (...) */
   DOT: "dot",
+  /** Hyphen leader (---) */
   HYPHEN: "hyphen",
+  /** Underscore leader (___) */
   UNDERSCORE: "underscore",
+  /** Middle dot leader (···) */
   MIDDLE_DOT: "middleDot"
 };
 class PositionalTab extends XmlComponent {
@@ -13336,7 +13565,9 @@ class PositionalTab extends XmlComponent {
   }
 }
 const BreakType = {
+  /** Column break - text continues at the beginning of the next column */
   COLUMN: "column",
+  /** Page break - text continues at the beginning of the next page */
   PAGE: "page"
   // textWrapping breaks are the default and already exposed via the "Run" class
 };
@@ -13368,9 +13599,13 @@ class PageBreakBefore extends XmlComponent {
   }
 }
 const LineRuleType = {
+  /** Line spacing is at least the specified value */
   AT_LEAST: "atLeast",
+  /** Line spacing is exactly the specified value */
   EXACTLY: "exactly",
+  /** Line spacing is exactly the specified value (alias for EXACTLY) */
   EXACT: "exact",
+  /** Line spacing is automatically determined based on content */
   AUTO: "auto"
 };
 class SpacingAttributes extends XmlAttributeComponent {
@@ -13393,12 +13628,19 @@ class Spacing extends XmlComponent {
   }
 }
 const HeadingLevel = {
+  /** Heading 1 style */
   HEADING_1: "Heading1",
+  /** Heading 2 style */
   HEADING_2: "Heading2",
+  /** Heading 3 style */
   HEADING_3: "Heading3",
+  /** Heading 4 style */
   HEADING_4: "Heading4",
+  /** Heading 5 style */
   HEADING_5: "Heading5",
+  /** Heading 6 style */
   HEADING_6: "Heading6",
+  /** Title style */
   TITLE: "Title"
 };
 let Style$1 = class Style extends XmlComponent {
@@ -13420,24 +13662,39 @@ class TabStop extends XmlComponent {
   }
 }
 const TabStopType = {
+  /** Left-aligned tab stop */
   LEFT: "left",
+  /** Right-aligned tab stop */
   RIGHT: "right",
+  /** Center-aligned tab stop */
   CENTER: "center",
+  /** Bar tab stop - inserts a vertical bar at the position */
   BAR: "bar",
+  /** Clears a tab stop at the specified position */
   CLEAR: "clear",
+  /** Decimal-aligned tab stop - aligns on decimal point */
   DECIMAL: "decimal",
+  /** End-aligned tab stop (right-to-left equivalent) */
   END: "end",
+  /** List tab stop for numbered lists */
   NUM: "num",
+  /** Start-aligned tab stop (left-to-right equivalent) */
   START: "start"
 };
 const LeaderType = {
+  /** Dot leader (....) */
   DOT: "dot",
+  /** Hyphen leader (----) */
   HYPHEN: "hyphen",
+  /** Middle dot leader (····) */
   MIDDLE_DOT: "middleDot",
+  /** No leader */
   NONE: "none",
+  /** Underscore leader (____) */
   UNDERSCORE: "underscore"
 };
 const TabStopPosition = {
+  /** Maximum tab stop position (right margin) */
   MAX: 9026
 };
 class TabAttributes extends XmlAttributeComponent {
@@ -13493,7 +13750,8 @@ class NumberId extends XmlComponent {
 class FileChild extends XmlComponent {
   constructor() {
     super(...arguments);
-    __publicField(this, "fileChild", Symbol());
+    /** Marker property identifying this as a FileChild */
+    __publicField(this, "fileChild", /* @__PURE__ */ Symbol());
   }
 }
 class HyperlinkAttributes extends XmlAttributeComponent {
@@ -13507,7 +13765,9 @@ class HyperlinkAttributes extends XmlAttributeComponent {
   }
 }
 const HyperlinkType = {
+  /** Internal hyperlink to a bookmark within the document */
   INTERNAL: "INTERNAL",
+  /** External hyperlink to a URL outside the document */
   EXTERNAL: "EXTERNAL"
 };
 class ConcreteHyperlink extends XmlComponent {
@@ -13789,16 +14049,23 @@ const createLineNumberType = ({ countBy, start, restart, distance }) => new Buil
   }
 });
 const PageBorderDisplay = {
+  /** Display border on all pages */
   ALL_PAGES: "allPages",
+  /** Display border only on first page */
   FIRST_PAGE: "firstPage",
+  /** Display border on all pages except first page */
   NOT_FIRST_PAGE: "notFirstPage"
 };
 const PageBorderOffsetFrom = {
+  /** Position border relative to page edge */
   PAGE: "page",
+  /** Position border relative to text (default) */
   TEXT: "text"
 };
 const PageBorderZOrder = {
+  /** Display border behind page contents */
   BACK: "back",
+  /** Display border in front of page contents (default) */
   FRONT: "front"
 };
 class PageBordersAttributes extends XmlAttributeComponent {
@@ -13859,10 +14126,15 @@ class PageMargin extends XmlComponent {
   }
 }
 const PageNumberSeparator = {
+  /** Hyphen separator (-) */
   HYPHEN: "hyphen",
+  /** Period separator (.) */
   PERIOD: "period",
+  /** Colon separator (:) */
   COLON: "colon",
+  /** Em dash separator (—) */
   EM_DASH: "emDash",
+  /** En dash separator (–) */
   EN_DASH: "endash"
 };
 class PageNumberTypeAttributes extends XmlAttributeComponent {
@@ -13915,7 +14187,9 @@ const createPageSize = ({ width, height, orientation, code }) => {
   });
 };
 const PageTextDirectionType = {
+  /** Left-to-right, top-to-bottom (standard Western text flow) */
   LEFT_TO_RIGHT_TOP_TO_BOTTOM: "lrTb",
+  /** Top-to-bottom, right-to-left (vertical East Asian text flow) */
   TOP_TO_BOTTOM_RIGHT_TO_LEFT: "tbRl"
 };
 class PageTextDirectionAttributes extends XmlAttributeComponent {
@@ -13935,10 +14209,15 @@ class PageTextDirection extends XmlComponent {
   }
 }
 const SectionType = {
+  /** Section begins on the next page */
   NEXT_PAGE: "nextPage",
+  /** Section begins on the next column */
   NEXT_COLUMN: "nextColumn",
+  /** Section begins immediately following the previous section */
   CONTINUOUS: "continuous",
+  /** Section begins on the next even-numbered page */
   EVEN_PAGE: "evenPage",
+  /** Section begins on the next odd-numbered page */
   ODD_PAGE: "oddPage"
 };
 class SectionTypeAttributes extends XmlAttributeComponent {
@@ -13956,17 +14235,27 @@ class Type extends XmlComponent {
   }
 }
 const sectionMarginDefaults = {
+  /** Top margin: 1440 twips (1 inch) */
   TOP: 1440,
+  /** Right margin: 1440 twips (1 inch) */
   RIGHT: 1440,
+  /** Bottom margin: 1440 twips (1 inch) */
   BOTTOM: 1440,
+  /** Left margin: 1440 twips (1 inch) */
   LEFT: 1440,
+  /** Header margin from top: 708 twips (0.5 inches) */
   HEADER: 708,
+  /** Footer margin from bottom: 708 twips (0.5 inches) */
   FOOTER: 708,
+  /** Gutter margin for binding: 0 twips */
   GUTTER: 0
 };
 const sectionPageSizeDefaults = {
+  /** Page width: 11906 twips (8.27 inches, 210mm) */
   WIDTH: 11906,
+  /** Page height: 16838 twips (11.69 inches, 297mm) */
   HEIGHT: 16838,
+  /** Page orientation: portrait */
   ORIENTATION: PageOrientation.PORTRAIT
 };
 class SectionProperties extends XmlComponent {
@@ -14062,19 +14351,32 @@ class Body extends XmlComponent {
     __publicField(this, "sections", []);
   }
   /**
-   * Adds new section properties.
-   * Note: Previous section is created in paragraph after the current element, and then new section will be added.
-   * The spec says:
-   *  - section element should be in the last paragraph of the section
-   *  - last section should be direct child of body
+   * Adds new section properties to the document body.
+   *
+   * Creates a new section by moving the previous section's properties into a paragraph
+   * at the end of that section, and then adding the new section as the current section.
    *
-   * @param options new section options
+   * According to the OOXML specification:
+   * - Section properties for all sections except the last must be stored in a paragraph's
+   *   properties (pPr/sectPr) at the end of each section
+   * - The last section's properties are stored as a direct child of the body element (w:body/w:sectPr)
+   *
+   * @param options - Section properties configuration (page size, margins, headers, footers, etc.)
    */
   addSection(options) {
     const currentSection = this.sections.pop();
     this.root.push(this.createSectionParagraph(currentSection));
     this.sections.push(new SectionProperties(options));
   }
+  /**
+   * Prepares the body element for XML serialization.
+   *
+   * Ensures that the last section's properties are placed as a direct child of the body
+   * element, as required by the OOXML specification.
+   *
+   * @param context - The XML serialization context
+   * @returns The prepared XML object or undefined
+   */
   prepForXml(context) {
     if (this.sections.length === 1) {
       this.root.splice(0, 1);
@@ -14082,6 +14384,14 @@ class Body extends XmlComponent {
     }
     return super.prepForXml(context);
   }
+  /**
+   * Adds a block-level component to the body.
+   *
+   * This method is used internally by the Document class to add paragraphs,
+   * tables, and other block-level elements to the document body.
+   *
+   * @param component - The XML component to add (paragraph, table, etc.)
+   */
   push(component) {
     this.root.push(component);
   }
@@ -14224,10 +14534,21 @@ class Document extends XmlComponent {
     }
     this.root.push(this.body);
   }
+  /**
+   * Adds a block-level element to the document body.
+   *
+   * @param item - The element to add (paragraph, table, table of contents, or hyperlink)
+   * @returns The Document instance for method chaining
+   */
   add(item) {
     this.body.push(item);
     return this;
   }
+  /**
+   * Gets the document body element.
+   *
+   * @returns The Body instance containing all document content
+   */
   get Body() {
     return this.body;
   }
@@ -14259,21 +14580,33 @@ class WordWrap extends XmlComponent {
   }
 }
 const DropCapType = {
+  /** No drop cap effect */
   NONE: "none",
+  /** Drop cap that drops down into the paragraph text */
   DROP: "drop",
+  /** Drop cap that extends into the margin */
   MARGIN: "margin"
 };
 const FrameAnchorType = {
+  /** Anchor relative to the page margin */
   MARGIN: "margin",
+  /** Anchor relative to the page edge */
   PAGE: "page",
+  /** Anchor relative to the text column */
   TEXT: "text"
 };
 const FrameWrap = {
+  /** Wrap text around the frame on all sides */
   AROUND: "around",
+  /** Automatic wrapping based on available space */
   AUTO: "auto",
+  /** No text wrapping */
   NONE: "none",
+  /** Do not allow text beside the frame */
   NOT_BESIDE: "notBeside",
+  /** Allow text to flow through the frame */
   THROUGH: "through",
+  /** Wrap text tightly around the frame */
   TIGHT: "tight"
 };
 const createFrameProperties = (options) => {
@@ -14447,9 +14780,23 @@ class ParagraphProperties extends IgnoreIfEmptyXmlComponent {
       this.push(new RunProperties(options.run));
     }
   }
+  /**
+   * Adds a property element to the paragraph properties.
+   *
+   * @param item - The XML component to add to the paragraph properties
+   */
   push(item) {
     this.root.push(item);
   }
+  /**
+   * Prepares the paragraph properties for XML serialization.
+   *
+   * This method creates concrete numbering instances for any numbering references
+   * before the properties are converted to XML.
+   *
+   * @param context - The XML context containing document and file information
+   * @returns The prepared XML object, or undefined if the component should be ignored
+   */
   prepForXml(context) {
     if (context.viewWrapper instanceof DocumentWrapper) {
       for (const reference of this.numberingReferences) {
@@ -14949,10 +15296,12 @@ class GridSpan extends XmlComponent {
 const VerticalMergeType = {
   /**
    * Cell that is merged with upper one.
+   * This cell continues a vertical merge started by a cell above it.
    */
   CONTINUE: "continue",
   /**
    * Cell that is starting the vertical merge.
+   * This cell begins a new vertical merge region.
    */
   RESTART: "restart"
 };
@@ -14973,8 +15322,11 @@ class VerticalMerge extends XmlComponent {
   }
 }
 const TextDirection = {
+  /** Text flows from bottom to top, left to right */
   BOTTOM_TO_TOP_LEFT_TO_RIGHT: "btLr",
+  /** Text flows from left to right, top to bottom (default) */
   LEFT_TO_RIGHT_TOP_TO_BOTTOM: "lrTb",
+  /** Text flows from top to bottom, right to left */
   TOP_TO_BOTTOM_RIGHT_TO_LEFT: "tbRl"
 };
 class TDirectionAttributes extends XmlAttributeComponent {
@@ -15182,7 +15534,9 @@ class TableFloatProperties extends XmlComponent {
   }
 }
 const TableLayoutType = {
+  /** Auto-fit layout - column widths are adjusted based on content */
   AUTOFIT: "autofit",
+  /** Fixed layout - column widths are fixed as specified */
   FIXED: "fixed"
 };
 class TableLayoutAttributes extends XmlAttributeComponent {
@@ -15501,11 +15855,21 @@ class ContentTypes extends XmlComponent {
     this.root.push(new Override("application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml", "/word/comments.xml"));
     this.root.push(new Override("application/vnd.openxmlformats-officedocument.wordprocessingml.fontTable+xml", "/word/fontTable.xml"));
   }
+  /**
+   * Registers a footer part in the content types.
+   *
+   * @param index - Footer index number (e.g., 1 for footer1.xml)
+   */
   addFooter(index) {
     this.root.push(
       new Override("application/vnd.openxmlformats-officedocument.wordprocessingml.footer+xml", `/word/footer${index}.xml`)
     );
   }
+  /**
+   * Registers a header part in the content types.
+   *
+   * @param index - Header index number (e.g., 1 for header1.xml)
+   */
   addHeader(index) {
     this.root.push(
       new Override("application/vnd.openxmlformats-officedocument.wordprocessingml.header+xml", `/word/header${index}.xml`)
@@ -15571,7 +15935,7 @@ class CustomPropertyAttributes extends XmlAttributeComponent {
   constructor() {
     super(...arguments);
     __publicField(this, "xmlKeys", {
-      fmtid: "fmtid",
+      formatId: "fmtid",
       pid: "pid",
       name: "name"
     });
@@ -15582,7 +15946,7 @@ class CustomProperty extends XmlComponent {
     super("property");
     this.root.push(
       new CustomPropertyAttributes({
-        fmtid: "{D5CDD505-2E9C-101B-9397-08002B2CF9AE}",
+        formatId: "{D5CDD505-2E9C-101B-9397-08002B2CF9AE}",
         pid: id.toString(),
         name: properties.name
       })
@@ -15663,50 +16027,47 @@ const createFont = ({
   embedBold,
   embedItalic,
   embedBoldItalic
-}) => (
-  // http://www.datypic.com/sc/ooxml/e-w_font-1.html
-  new BuilderElement({
-    name: "w:font",
-    attributes: {
-      name: { key: "w:name", value: name }
-    },
-    children: [
-      // http://www.datypic.com/sc/ooxml/e-w_altName-1.html
-      ...altName ? [createStringElement("w:altName", altName)] : [],
-      // http://www.datypic.com/sc/ooxml/e-w_panose1-1.html
-      ...panose1 ? [createStringElement("w:panose1", panose1)] : [],
-      // 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
-      ...[createStringElement("w:family", family)],
-      // http://www.datypic.com/sc/ooxml/e-w_notTrueType-1.html
-      ...notTrueType ? [new OnOffElement("w:notTrueType", notTrueType)] : [],
-      ...[createStringElement("w:pitch", pitch)],
-      // http://www.datypic.com/sc/ooxml/e-w_sig-1.html
-      ...sig ? [
-        new BuilderElement({
-          name: "w:sig",
-          attributes: {
-            usb0: { key: "w:usb0", value: sig.usb0 },
-            usb1: { key: "w:usb1", value: sig.usb1 },
-            usb2: { key: "w:usb2", value: sig.usb2 },
-            usb3: { key: "w:usb3", value: sig.usb3 },
-            csb0: { key: "w:csb0", value: sig.csb0 },
-            csb1: { key: "w:csb1", value: sig.csb1 }
-          }
-        })
-      ] : [],
-      // http://www.datypic.com/sc/ooxml/e-w_embedRegular-1.html
-      ...embedRegular ? [createFontRelationship(embedRegular, "w:embedRegular")] : [],
-      // http://www.datypic.com/sc/ooxml/e-w_embedBold-1.html
-      ...embedBold ? [createFontRelationship(embedBold, "w:embedBold")] : [],
-      // http://www.datypic.com/sc/ooxml/e-w_embedItalic-1.html
-      ...embedItalic ? [createFontRelationship(embedItalic, "w:embedItalic")] : [],
-      // http://www.datypic.com/sc/ooxml/e-w_embedBoldItalic-1.html
-      ...embedBoldItalic ? [createFontRelationship(embedBoldItalic, "w:embedBoldItalic")] : []
-    ]
-  })
-);
+}) => new BuilderElement({
+  name: "w:font",
+  attributes: {
+    name: { key: "w:name", value: name }
+  },
+  children: [
+    // http://www.datypic.com/sc/ooxml/e-w_altName-1.html
+    ...altName ? [createStringElement("w:altName", altName)] : [],
+    // http://www.datypic.com/sc/ooxml/e-w_panose1-1.html
+    ...panose1 ? [createStringElement("w:panose1", panose1)] : [],
+    // 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
+    ...[createStringElement("w:family", family)],
+    // http://www.datypic.com/sc/ooxml/e-w_notTrueType-1.html
+    ...notTrueType ? [new OnOffElement("w:notTrueType", notTrueType)] : [],
+    ...[createStringElement("w:pitch", pitch)],
+    // http://www.datypic.com/sc/ooxml/e-w_sig-1.html
+    ...sig ? [
+      new BuilderElement({
+        name: "w:sig",
+        attributes: {
+          usb0: { key: "w:usb0", value: sig.usb0 },
+          usb1: { key: "w:usb1", value: sig.usb1 },
+          usb2: { key: "w:usb2", value: sig.usb2 },
+          usb3: { key: "w:usb3", value: sig.usb3 },
+          csb0: { key: "w:csb0", value: sig.csb0 },
+          csb1: { key: "w:csb1", value: sig.csb1 }
+        }
+      })
+    ] : [],
+    // http://www.datypic.com/sc/ooxml/e-w_embedRegular-1.html
+    ...embedRegular ? [createFontRelationship(embedRegular, "w:embedRegular")] : [],
+    // http://www.datypic.com/sc/ooxml/e-w_embedBold-1.html
+    ...embedBold ? [createFontRelationship(embedBold, "w:embedBold")] : [],
+    // http://www.datypic.com/sc/ooxml/e-w_embedItalic-1.html
+    ...embedItalic ? [createFontRelationship(embedItalic, "w:embedItalic")] : [],
+    // http://www.datypic.com/sc/ooxml/e-w_embedBoldItalic-1.html
+    ...embedBoldItalic ? [createFontRelationship(embedBoldItalic, "w:embedBoldItalic")] : []
+  ]
+});
 const createRegularFont = ({
   name,
   index,
@@ -15892,7 +16253,9 @@ class FootnoteRefRun extends Run {
   }
 }
 const FootnoteType = {
+  /** Separator line between body text and footnotes */
   SEPERATOR: "separator",
+  /** Continuation separator for footnotes spanning pages */
   CONTINUATION_SEPERATOR: "continuationSeparator"
 };
 class Footnote extends XmlComponent {
@@ -16014,6 +16377,12 @@ class FootNotes extends XmlComponent {
     });
     this.root.push(spacing);
   }
+  /**
+   * Creates and adds a new footnote to the collection.
+   *
+   * @param id - Unique numeric identifier for the footnote
+   * @param paragraph - Array of paragraphs that make up the footnote content
+   */
   createFootNote(id, paragraph) {
     const footnote = new Footnote({
       id,
@@ -16153,77 +16522,151 @@ class Media {
     __publicField(this, "map");
     this.map = /* @__PURE__ */ new Map();
   }
+  /**
+   * Adds an image to the media collection.
+   *
+   * @param key - Unique identifier for this image
+   * @param mediaData - Complete image data including file name, transformation, and raw data
+   */
   addImage(key, mediaData) {
     this.map.set(key, mediaData);
   }
+  /**
+   * Gets all images as an array.
+   *
+   * @returns Read-only array of all media data in the collection
+   */
   get Array() {
     return Array.from(this.map.values());
   }
 }
 const WORKAROUND2 = "";
 const LevelFormat = {
+  /** Decimal numbering (1, 2, 3...). */
   DECIMAL: "decimal",
+  /** Uppercase roman numerals (I, II, III...). */
   UPPER_ROMAN: "upperRoman",
+  /** Lowercase roman numerals (i, ii, iii...). */
   LOWER_ROMAN: "lowerRoman",
+  /** Uppercase letters (A, B, C...). */
   UPPER_LETTER: "upperLetter",
+  /** Lowercase letters (a, b, c...). */
   LOWER_LETTER: "lowerLetter",
+  /** Ordinal numbers (1st, 2nd, 3rd...). */
   ORDINAL: "ordinal",
+  /** Cardinal text (one, two, three...). */
   CARDINAL_TEXT: "cardinalText",
+  /** Ordinal text (first, second, third...). */
   ORDINAL_TEXT: "ordinalText",
+  /** Hexadecimal numbering. */
   HEX: "hex",
+  /** Chicago Manual of Style numbering. */
   CHICAGO: "chicago",
+  /** Ideograph digital numbering. */
   IDEOGRAPH__DIGITAL: "ideographDigital",
+  /** Japanese counting system. */
   JAPANESE_COUNTING: "japaneseCounting",
+  /** Japanese aiueo ordering. */
   AIUEO: "aiueo",
+  /** Japanese iroha ordering. */
   IROHA: "iroha",
+  /** Full-width decimal numbering. */
   DECIMAL_FULL_WIDTH: "decimalFullWidth",
+  /** Half-width decimal numbering. */
   DECIMAL_HALF_WIDTH: "decimalHalfWidth",
+  /** Japanese legal numbering. */
   JAPANESE_LEGAL: "japaneseLegal",
+  /** Japanese digital ten thousand numbering. */
   JAPANESE_DIGITAL_TEN_THOUSAND: "japaneseDigitalTenThousand",
+  /** Decimal numbers enclosed in circles. */
   DECIMAL_ENCLOSED_CIRCLE: "decimalEnclosedCircle",
+  /** Full-width decimal numbering variant 2. */
   DECIMAL_FULL_WIDTH2: "decimalFullWidth2",
+  /** Full-width aiueo ordering. */
   AIUEO_FULL_WIDTH: "aiueoFullWidth",
+  /** Full-width iroha ordering. */
   IROHA_FULL_WIDTH: "irohaFullWidth",
+  /** Decimal with leading zeros. */
   DECIMAL_ZERO: "decimalZero",
+  /** Bullet points. */
   BULLET: "bullet",
+  /** Korean ganada ordering. */
   GANADA: "ganada",
+  /** Korean chosung ordering. */
   CHOSUNG: "chosung",
+  /** Decimal enclosed with fullstop. */
   DECIMAL_ENCLOSED_FULLSTOP: "decimalEnclosedFullstop",
+  /** Decimal enclosed in parentheses. */
   DECIMAL_ENCLOSED_PARENTHESES: "decimalEnclosedParen",
+  /** Decimal enclosed in circles (Chinese). */
   DECIMAL_ENCLOSED_CIRCLE_CHINESE: "decimalEnclosedCircleChinese",
+  /** Ideograph enclosed in circles. */
   IDEOGRAPH_ENCLOSED_CIRCLE: "ideographEnclosedCircle",
+  /** Traditional ideograph numbering. */
   IDEOGRAPH_TRADITIONAL: "ideographTraditional",
+  /** Ideograph zodiac numbering. */
   IDEOGRAPH_ZODIAC: "ideographZodiac",
+  /** Traditional ideograph zodiac numbering. */
   IDEOGRAPH_ZODIAC_TRADITIONAL: "ideographZodiacTraditional",
+  /** Taiwanese counting system. */
   TAIWANESE_COUNTING: "taiwaneseCounting",
+  /** Traditional ideograph legal numbering. */
   IDEOGRAPH_LEGAL_TRADITIONAL: "ideographLegalTraditional",
+  /** Taiwanese counting thousand system. */
   TAIWANESE_COUNTING_THOUSAND: "taiwaneseCountingThousand",
+  /** Taiwanese digital numbering. */
   TAIWANESE_DIGITAL: "taiwaneseDigital",
+  /** Chinese counting system. */
   CHINESE_COUNTING: "chineseCounting",
+  /** Simplified Chinese legal numbering. */
   CHINESE_LEGAL_SIMPLIFIED: "chineseLegalSimplified",
+  /** Chinese counting thousand system. */
   CHINESE_COUNTING_THOUSAND: "chineseCountingThousand",
+  /** Korean digital numbering. */
   KOREAN_DIGITAL: "koreanDigital",
+  /** Korean counting system. */
   KOREAN_COUNTING: "koreanCounting",
+  /** Korean legal numbering. */
   KOREAN_LEGAL: "koreanLegal",
+  /** Korean digital numbering variant 2. */
   KOREAN_DIGITAL2: "koreanDigital2",
+  /** Vietnamese counting system. */
   VIETNAMESE_COUNTING: "vietnameseCounting",
+  /** Russian lowercase numbering. */
   RUSSIAN_LOWER: "russianLower",
+  /** Russian uppercase numbering. */
   RUSSIAN_UPPER: "russianUpper",
+  /** No numbering. */
   NONE: "none",
+  /** Number enclosed in dashes. */
   NUMBER_IN_DASH: "numberInDash",
+  /** Hebrew numbering variant 1. */
   HEBREW1: "hebrew1",
+  /** Hebrew numbering variant 2. */
   HEBREW2: "hebrew2",
+  /** Arabic alpha numbering. */
   ARABIC_ALPHA: "arabicAlpha",
+  /** Arabic abjad numbering. */
   ARABIC_ABJAD: "arabicAbjad",
+  /** Hindi vowels. */
   HINDI_VOWELS: "hindiVowels",
+  /** Hindi consonants. */
   HINDI_CONSONANTS: "hindiConsonants",
+  /** Hindi numbers. */
   HINDI_NUMBERS: "hindiNumbers",
+  /** Hindi counting system. */
   HINDI_COUNTING: "hindiCounting",
+  /** Thai letters. */
   THAI_LETTERS: "thaiLetters",
+  /** Thai numbers. */
   THAI_NUMBERS: "thaiNumbers",
+  /** Thai counting system. */
   THAI_COUNTING: "thaiCounting",
+  /** Thai Baht text. */
   BAHT_TEXT: "bahtText",
+  /** Dollar text. */
   DOLLAR_TEXT: "dollarText",
+  /** Custom numbering format. */
   CUSTOM: "custom"
 };
 class LevelAttributes extends XmlAttributeComponent {
@@ -16266,8 +16709,11 @@ class LevelJc extends XmlComponent {
   }
 }
 const LevelSuffix = {
+  /** No separator after the numbering. */
   NOTHING: "nothing",
+  /** Space character after the numbering. */
   SPACE: "space",
+  /** Tab character after the numbering. */
   TAB: "tab"
 };
 class Suffix extends XmlComponent {
@@ -16286,6 +16732,12 @@ class IsLegalNumberingStyle extends XmlComponent {
   }
 }
 class LevelBase extends XmlComponent {
+  /**
+   * Creates a new numbering level.
+   *
+   * @param options - Level configuration options
+   * @throws Error if level is greater than 9 (Word limitation)
+   */
   constructor({
     level,
     format,
@@ -16331,12 +16783,16 @@ class LevelBase extends XmlComponent {
   }
 }
 class Level extends LevelBase {
-  // This is the level that sits under abstractNum. We make a
-  // handful of properties required
+  // This is the level that sits under abstractNum
 }
 class LevelForOverride extends LevelBase {
 }
 class MultiLevelType extends XmlComponent {
+  /**
+   * Creates a new multi-level type specification.
+   *
+   * @param value - The multi-level type: "singleLevel", "multilevel", or "hybridMultilevel"
+   */
   constructor(value) {
     super("w:multiLevelType");
     this.root.push(
@@ -16356,8 +16812,15 @@ class AbstractNumberingAttributes extends XmlAttributeComponent {
   }
 }
 class AbstractNumbering extends XmlComponent {
+  /**
+   * Creates a new abstract numbering definition.
+   *
+   * @param id - Unique identifier for this abstract numbering definition
+   * @param levelOptions - Array of level definitions (up to 9 levels)
+   */
   constructor(id, levelOptions) {
     super("w:abstractNum");
+    /** The unique identifier for this abstract numbering definition. */
     __publicField(this, "id");
     this.root.push(
       new AbstractNumberingAttributes({
@@ -16389,10 +16852,18 @@ class NumAttributes extends XmlAttributeComponent {
   }
 }
 class ConcreteNumbering extends XmlComponent {
+  /**
+   * Creates a new concrete numbering instance.
+   *
+   * @param options - Configuration options for the numbering instance
+   */
   constructor(options) {
     super("w:num");
+    /** The unique identifier for this numbering instance. */
     __publicField(this, "numId");
+    /** The reference name for this numbering instance. */
     __publicField(this, "reference");
+    /** The instance number for tracking multiple uses. */
     __publicField(this, "instance");
     this.numId = options.numId;
     this.reference = options.reference;
@@ -16417,6 +16888,12 @@ class LevelOverrideAttributes extends XmlAttributeComponent {
   }
 }
 class LevelOverride extends XmlComponent {
+  /**
+   * Creates a new level override.
+   *
+   * @param levelNum - The level number to override (0-8)
+   * @param start - Optional starting number for the level
+   */
   constructor(levelNum, start) {
     super("w:lvlOverride");
     this.root.push(new LevelOverrideAttributes({ ilvl: levelNum }));
@@ -16432,12 +16909,25 @@ class StartOverrideAttributes extends XmlAttributeComponent {
   }
 }
 class StartOverride extends XmlComponent {
+  /**
+   * Creates a new start override.
+   *
+   * @param start - The starting number
+   */
   constructor(start) {
     super("w:startOverride");
     this.root.push(new StartOverrideAttributes({ val: start }));
   }
 }
 class Numbering extends XmlComponent {
+  /**
+   * Creates a new numbering definition collection.
+   *
+   * Initializes the numbering with a default bullet list configuration and
+   * any custom numbering configurations provided in the options.
+   *
+   * @param options - Configuration options for numbering definitions
+   */
   constructor(options) {
     super("w:numbering");
     __publicField(this, "abstractNumberingMap", /* @__PURE__ */ new Map());
@@ -16574,6 +17064,14 @@ class Numbering extends XmlComponent {
       this.referenceConfigMap.set(con.reference, con.levels);
     }
   }
+  /**
+   * Prepares the numbering definitions for XML serialization.
+   *
+   * Adds all abstract and concrete numbering definitions to the XML tree.
+   *
+   * @param context - The XML context
+   * @returns The prepared XML object
+   */
   prepForXml(context) {
     for (const numbering of this.abstractNumberingMap.values()) {
       this.root.push(numbering);
@@ -16583,6 +17081,16 @@ class Numbering extends XmlComponent {
     }
     return super.prepForXml(context);
   }
+  /**
+   * Creates a concrete numbering instance from an abstract numbering definition.
+   *
+   * This method creates a new concrete numbering instance that references an
+   * abstract numbering definition. It's used internally when paragraphs reference
+   * numbering configurations.
+   *
+   * @param reference - The reference name of the abstract numbering definition
+   * @param instance - The instance number for this concrete numbering
+   */
   createConcreteNumberingInstance(reference, instance) {
     const abstractNumbering = this.abstractNumberingMap.get(reference);
     if (!abstractNumbering) {
@@ -16611,9 +17119,19 @@ class Numbering extends XmlComponent {
     };
     this.concreteNumberingMap.set(fullReference, new ConcreteNumbering(concreteNumberingSettings));
   }
+  /**
+   * Gets all concrete numbering instances.
+   *
+   * @returns An array of all concrete numbering instances
+   */
   get ConcreteNumbering() {
     return Array.from(this.concreteNumberingMap.values());
   }
+  /**
+   * Gets all reference configurations.
+   *
+   * @returns An array of all numbering reference configurations
+   */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   get ReferenceConfig() {
     return Array.from(this.referenceConfigMap.values());
@@ -17205,27 +17723,29 @@ class DocumentDefaults extends XmlComponent {
 }
 class ExternalStylesFactory {
   /**
-   * Creates new Style based on the given styles.
-   * Parses the styles and convert them to XmlComponent.
+   * Creates new Styles based on the given XML data.
+   *
+   * Parses the styles XML and converts them to XmlComponent instances.
+   *
    * Example content from styles.xml:
-   * <?xml version="1.0">
+   * ```xml
+   * <?xml version="1.0"?>
    * <w:styles xmlns:mc="some schema" ...>
-   *
    *   <w:style w:type="paragraph" w:styleId="Heading1">
-   *           <w:name w:val="heading 1"/>
-   *           .....
+   *     <w:name w:val="heading 1"/>
+   *     ...
    *   </w:style>
-   *
    *   <w:style w:type="paragraph" w:styleId="Heading2">
-   *           <w:name w:val="heading 2"/>
-   *           .....
+   *     <w:name w:val="heading 2"/>
+   *     ...
    *   </w:style>
-   *
-   *   <w:docDefaults>Or any other element will be parsed to</w:docDefaults>
-   *
+   *   <w:docDefaults>...</w:docDefaults>
    * </w:styles>
+   * ```
    *
-   * @param externalStyles context from styles.xml
+   * @param xmlData - XML string containing styles data from styles.xml
+   * @returns Styles object containing all parsed styles
+   * @throws Error if styles element cannot be found in the XML
    */
   newInstance(xmlData) {
     const xmlObj = libExports.xml2js(xmlData, { compact: false });
@@ -17239,11 +17759,10 @@ class ExternalStylesFactory {
       throw new Error("can not find styles element");
     }
     const stylesElements = stylesXmlElement.elements || [];
-    const importedStyle = new Styles({
+    return {
       initialStyles: new ImportedRootElementAttributes(stylesXmlElement.attributes),
       importedStyles: stylesElements.map((childElm) => convertToXmlComponent(childElm))
-    });
-    return importedStyle;
+    };
   }
 }
 class DefaultStylesFactory {
@@ -17328,7 +17847,7 @@ class File {
     __publicField(this, "styles");
     __publicField(this, "comments");
     __publicField(this, "fontWrapper");
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
     this.coreProperties = new CoreProperties(__spreadProps(__spreadValues({}, options), {
       creator: (_a = options.creator) != null ? _a : "Un-named",
       revision: (_b = options.revision) != null ? _b : 1,
@@ -17358,8 +17877,13 @@ class File {
     });
     this.media = new Media();
     if (options.externalStyles !== void 0) {
-      const stylesFactory = new ExternalStylesFactory();
-      this.styles = stylesFactory.newInstance(options.externalStyles);
+      const defaultFactory = new DefaultStylesFactory();
+      const defaultStyles = defaultFactory.newInstance((_l = options.styles) == null ? void 0 : _l.default);
+      const externalFactory = new ExternalStylesFactory();
+      const externalStyles = externalFactory.newInstance(options.externalStyles);
+      this.styles = new Styles(__spreadProps(__spreadValues({}, externalStyles), {
+        importedStyles: [...defaultStyles.importedStyles, ...externalStyles.importedStyles]
+      }));
     } else if (options.styles) {
       const stylesFactory = new DefaultStylesFactory();
       const defaultStyles = stylesFactory.newInstance(options.styles.default);
@@ -17377,7 +17901,7 @@ class File {
         this.footnotesWrapper.View.createFootNote(parseFloat(key), options.footnotes[key].children);
       }
     }
-    this.fontWrapper = new FontWrapper((_l = options.fonts) != null ? _l : []);
+    this.fontWrapper = new FontWrapper((_m = options.fonts) != null ? _m : []);
   }
   addSection({ headers = {}, footers = {}, children, properties }) {
     this.documentWrapper.View.Body.addSection(__spreadProps(__spreadValues({}, properties), {
@@ -17626,7 +18150,9 @@ class TableOfContents extends FileChild {
 }
 class StyleLevel {
   constructor(styleName, level) {
+    /** The name of the paragraph style. */
     __publicField(this, "styleName");
+    /** The TOC level (1-9) to assign to this style. */
     __publicField(this, "level");
     this.styleName = styleName;
     this.level = level;
@@ -17663,6 +18189,11 @@ class FootnoteReference extends XmlComponent {
   }
 }
 class FootnoteReferenceRun extends Run {
+  /**
+   * Creates a new footnote reference run.
+   *
+   * @param id - Unique identifier linking to the footnote content
+   */
   constructor(id) {
     super({ style: "FootnoteReference" });
     this.root.push(new FootnoteReference(id));
@@ -17935,11 +18466,11 @@ var hasRequiredJszip_min;
 function requireJszip_min() {
   if (hasRequiredJszip_min) return jszip_min.exports;
   hasRequiredJszip_min = 1;
-  (function(module2, exports2) {
-    !function(e) {
+  (function(module2, exports$1) {
+    !(function(e) {
       module2.exports = e();
-    }(function() {
-      return function s(a, o, h) {
+    })(function() {
+      return (function s(a, o, h) {
         function u(r, e2) {
           if (!o[r]) {
             if (!a[r]) {
@@ -17959,7 +18490,7 @@ function requireJszip_min() {
         }
         for (var l = "function" == typeof commonjsRequire && commonjsRequire, e = 0; e < h.length; e++) u(h[e]);
         return u;
-      }({ 1: [function(e, t, r) {
+      })({ 1: [function(e, t, r) {
         var d = e("./utils"), c = e("./support"), p = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=";
         r.encode = function(e2) {
           for (var t2, r2, n, i, s, a, o, h = [], u = 0, l = e2.length, f = l, c2 = "string" !== d.getTypeOf(e2); u < e2.length; ) f = l - u, n = c2 ? (t2 = e2[u++], r2 = u < l ? e2[u++] : 0, u < l ? e2[u++] : 0) : (t2 = e2.charCodeAt(u++), r2 = u < l ? e2.charCodeAt(u++) : 0, u < l ? e2.charCodeAt(u++) : 0), i = t2 >> 2, s = (3 & t2) << 4 | r2 >> 4, a = 1 < f ? (15 & r2) << 2 | n >> 6 : 64, o = 2 < f ? 63 & n : 64, h.push(p.charAt(i) + p.charAt(s) + p.charAt(a) + p.charAt(o));
@@ -17996,26 +18527,26 @@ function requireJszip_min() {
         } }, r.DEFLATE = e("./flate");
       }, { "./flate": 7, "./stream/GenericWorker": 28 }], 4: [function(e, t, r) {
         var n = e("./utils");
-        var o = function() {
+        var o = (function() {
           for (var e2, t2 = [], r2 = 0; r2 < 256; r2++) {
             e2 = r2;
             for (var n2 = 0; n2 < 8; n2++) e2 = 1 & e2 ? 3988292384 ^ e2 >>> 1 : e2 >>> 1;
             t2[r2] = e2;
           }
           return t2;
-        }();
+        })();
         t.exports = function(e2, t2) {
-          return void 0 !== e2 && e2.length ? "string" !== n.getTypeOf(e2) ? function(e3, t3, r2, n2) {
+          return void 0 !== e2 && e2.length ? "string" !== n.getTypeOf(e2) ? (function(e3, t3, r2, n2) {
             var i = o, s = n2 + r2;
             e3 ^= -1;
             for (var a = n2; a < s; a++) e3 = e3 >>> 8 ^ i[255 & (e3 ^ t3[a])];
             return -1 ^ e3;
-          }(0 | t2, e2, e2.length, 0) : function(e3, t3, r2, n2) {
+          })(0 | t2, e2, e2.length, 0) : (function(e3, t3, r2, n2) {
             var i = o, s = n2 + r2;
             e3 ^= -1;
             for (var a = n2; a < s; a++) e3 = e3 >>> 8 ^ i[255 & (e3 ^ t3.charCodeAt(a))];
             return -1 ^ e3;
-          }(0 | t2, e2, e2.length, 0) : 0;
+          })(0 | t2, e2, e2.length, 0) : 0;
         };
       }, { "./utils": 32 }], 5: [function(e, t, r) {
         r.base64 = false, r.binary = false, r.dir = false, r.createFolders = true, r.date = null, r.compression = null, r.compressionOptions = null, r.comment = null, r.unixPermissions = null, r.dosPermissions = null;
@@ -18056,12 +18587,12 @@ function requireJszip_min() {
           var S = 0;
           t2 && (S |= 8), l || !_ && !g || (S |= 2048);
           var z = 0, C = 0;
-          w && (z |= 16), "UNIX" === i2 ? (C = 798, z |= function(e3, t3) {
+          w && (z |= 16), "UNIX" === i2 ? (C = 798, z |= (function(e3, t3) {
             var r3 = e3;
             return e3 || (r3 = t3 ? 16893 : 33204), (65535 & r3) << 16;
-          }(h.unixPermissions, w)) : (C = 20, z |= function(e3) {
+          })(h.unixPermissions, w)) : (C = 20, z |= (function(e3) {
             return 63 & (e3 || 0);
-          }(h.dosPermissions)), a = k.getUTCHours(), a <<= 6, a |= k.getUTCMinutes(), a <<= 5, a |= k.getUTCSeconds() / 2, o = k.getUTCFullYear() - 1980, o <<= 4, o |= k.getUTCMonth() + 1, o <<= 5, o |= k.getUTCDate(), _ && (v = A(1, 1) + A(B(f), 4) + c, b += "up" + A(v.length, 2) + v), g && (y = A(1, 1) + A(B(p), 4) + m, b += "uc" + A(y.length, 2) + y);
+          })(h.dosPermissions)), a = k.getUTCHours(), a <<= 6, a |= k.getUTCMinutes(), a <<= 5, a |= k.getUTCSeconds() / 2, o = k.getUTCFullYear() - 1980, o <<= 4, o |= k.getUTCMonth() + 1, o <<= 5, o |= k.getUTCDate(), _ && (v = A(1, 1) + A(B(f), 4) + c, b += "up" + A(v.length, 2) + v), g && (y = A(1, 1) + A(B(p), 4) + m, b += "uc" + A(y.length, 2) + y);
           var E = "";
           return E += "\n\0", E += A(S, 2), E += u.magic, E += A(a, 2), E += A(o, 2), E += A(x.crc32, 4), E += A(x.compressedSize, 4), E += A(x.uncompressedSize, 4), E += A(f.length, 2), E += A(b.length, 2), { fileRecord: R.LOCAL_FILE_HEADER + E + f + b, dirRecord: R.CENTRAL_FILE_HEADER + A(C, 2) + E + A(p.length, 2) + "\0\0\0\0" + A(z, 4) + A(n2, 4) + f + b + p };
         }
@@ -18082,17 +18613,17 @@ function requireJszip_min() {
         }, s.prototype.closedSource = function(e2) {
           this.accumulate = false;
           var t2 = this.streamFiles && !e2.file.dir, r2 = n(e2, t2, true, this.currentSourceOffset, this.zipPlatform, this.encodeFileName);
-          if (this.dirRecords.push(r2.dirRecord), t2) this.push({ data: function(e3) {
+          if (this.dirRecords.push(r2.dirRecord), t2) this.push({ data: (function(e3) {
             return R.DATA_DESCRIPTOR + A(e3.crc32, 4) + A(e3.compressedSize, 4) + A(e3.uncompressedSize, 4);
-          }(e2), meta: { percent: 100 } });
+          })(e2), meta: { percent: 100 } });
           else for (this.push({ data: r2.fileRecord, meta: { percent: 0 } }); this.contentBuffer.length; ) this.push(this.contentBuffer.shift());
           this.currentFile = null;
         }, s.prototype.flush = function() {
           for (var e2 = this.bytesWritten, t2 = 0; t2 < this.dirRecords.length; t2++) this.push({ data: this.dirRecords[t2], meta: { percent: 100 } });
-          var r2 = this.bytesWritten - e2, n2 = function(e3, t3, r3, n3, i2) {
+          var r2 = this.bytesWritten - e2, n2 = (function(e3, t3, r3, n3, i2) {
             var s2 = I.transformTo("string", i2(n3));
             return R.CENTRAL_DIRECTORY_END + "\0\0\0\0" + A(e3, 2) + A(e3, 2) + A(t3, 4) + A(r3, 4) + A(s2.length, 2) + s2;
-          }(this.dirRecords.length, r2, e2, this.zipComment, this.encodeFileName);
+          })(this.dirRecords.length, r2, e2, this.zipComment, this.encodeFileName);
           this.push({ data: n2, meta: { percent: 100 } });
         }, s.prototype.prepareNextSource = function() {
           this.previous = this._sources.shift(), this.openedSource(this.previous.streamInfo), this.isPaused ? this.previous.pause() : this.previous.resume();
@@ -18127,11 +18658,11 @@ function requireJszip_min() {
           try {
             e2.forEach(function(e3, t3) {
               h++;
-              var r2 = function(e4, t4) {
+              var r2 = (function(e4, t4) {
                 var r3 = e4 || t4, n3 = u[r3];
                 if (!n3) throw new Error(r3 + " is not a valid compression method !");
                 return n3;
-              }(t3.options.compression, a.compression), n2 = t3.options.compressionOptions || a.compressionOptions || {}, i = t3.dir, s = t3.date;
+              })(t3.options.compression, a.compression), n2 = t3.options.compressionOptions || a.compressionOptions || {}, i = t3.dir, s = t3.date;
               t3._compressWorker(r2, n2).withStreamInfo("file", { name: e3, dir: i, date: s, comment: t3.comment || "", unixPermissions: t3.unixPermissions, dosPermissions: t3.dosPermissions }).pipe(o);
             }), o.entriesCount = h;
           } catch (e3) {
@@ -18532,7 +19063,7 @@ function requireJszip_min() {
               n2 = [], r2(e3);
             }).on("end", function() {
               try {
-                var e3 = function(e4, t3, r3) {
+                var e3 = (function(e4, t3, r3) {
                   switch (e4) {
                     case "blob":
                       return h.newBlob(h.transformTo("arraybuffer", t3), r3);
@@ -18541,7 +19072,7 @@ function requireJszip_min() {
                     default:
                       return h.transformTo(e4, t3);
                   }
-                }(s2, function(e4, t3) {
+                })(s2, (function(e4, t3) {
                   var r3, n3 = 0, i3 = null, s3 = 0;
                   for (r3 = 0; r3 < t3.length; r3++) s3 += t3[r3].length;
                   switch (e4) {
@@ -18557,7 +19088,7 @@ function requireJszip_min() {
                     default:
                       throw new Error("concat : unsupported type '" + e4 + "'");
                   }
-                }(i2, n2), a2);
+                })(i2, n2), a2);
                 t2(e3);
               } catch (e4) {
                 r2(e4);
@@ -18629,14 +19160,14 @@ function requireJszip_min() {
           n.call(this, "utf-8 encode");
         }
         s.utf8encode = function(e2) {
-          return h.nodebuffer ? r.newBufferFrom(e2, "utf-8") : function(e3) {
+          return h.nodebuffer ? r.newBufferFrom(e2, "utf-8") : (function(e3) {
             var t2, r2, n2, i2, s2, a2 = e3.length, o2 = 0;
             for (i2 = 0; i2 < a2; i2++) 55296 == (64512 & (r2 = e3.charCodeAt(i2))) && i2 + 1 < a2 && 56320 == (64512 & (n2 = e3.charCodeAt(i2 + 1))) && (r2 = 65536 + (r2 - 55296 << 10) + (n2 - 56320), i2++), o2 += r2 < 128 ? 1 : r2 < 2048 ? 2 : r2 < 65536 ? 3 : 4;
             for (t2 = h.uint8array ? new Uint8Array(o2) : new Array(o2), i2 = s2 = 0; s2 < o2; i2++) 55296 == (64512 & (r2 = e3.charCodeAt(i2))) && i2 + 1 < a2 && 56320 == (64512 & (n2 = e3.charCodeAt(i2 + 1))) && (r2 = 65536 + (r2 - 55296 << 10) + (n2 - 56320), i2++), r2 < 128 ? t2[s2++] = r2 : (r2 < 2048 ? t2[s2++] = 192 | r2 >>> 6 : (r2 < 65536 ? t2[s2++] = 224 | r2 >>> 12 : (t2[s2++] = 240 | r2 >>> 18, t2[s2++] = 128 | r2 >>> 12 & 63), t2[s2++] = 128 | r2 >>> 6 & 63), t2[s2++] = 128 | 63 & r2);
             return t2;
-          }(e2);
+          })(e2);
         }, s.utf8decode = function(e2) {
-          return h.nodebuffer ? o.transformTo("nodebuffer", e2).toString("utf-8") : function(e3) {
+          return h.nodebuffer ? o.transformTo("nodebuffer", e2).toString("utf-8") : (function(e3) {
             var t2, r2, n2, i2, s2 = e3.length, a2 = new Array(2 * s2);
             for (t2 = r2 = 0; t2 < s2; ) if ((n2 = e3[t2++]) < 128) a2[r2++] = n2;
             else if (4 < (i2 = u[n2])) a2[r2++] = 65533, t2 += i2 - 1;
@@ -18645,7 +19176,7 @@ function requireJszip_min() {
               1 < i2 ? a2[r2++] = 65533 : n2 < 65536 ? a2[r2++] = n2 : (n2 -= 65536, a2[r2++] = 55296 | n2 >> 10 & 1023, a2[r2++] = 56320 | 1023 & n2);
             }
             return a2.length !== r2 && (a2.subarray ? a2 = a2.subarray(0, r2) : a2.length = r2), o.applyFromCharCode(a2);
-          }(e2 = o.transformTo(h.uint8array ? "uint8array" : "array", e2));
+          })(e2 = o.transformTo(h.uint8array ? "uint8array" : "array", e2));
         }, o.inherits(a, n), a.prototype.processChunk = function(e2) {
           var t2 = o.transformTo(h.uint8array ? "uint8array" : "array", e2.data);
           if (this.leftOver && this.leftOver.length) {
@@ -18655,11 +19186,11 @@ function requireJszip_min() {
             } else t2 = this.leftOver.concat(t2);
             this.leftOver = null;
           }
-          var n2 = function(e3, t3) {
+          var n2 = (function(e3, t3) {
             var r3;
             for ((t3 = t3 || e3.length) > e3.length && (t3 = e3.length), r3 = t3 - 1; 0 <= r3 && 128 == (192 & e3[r3]); ) r3--;
             return r3 < 0 ? t3 : 0 === r3 ? t3 : r3 + u[e3[r3]] > t3 ? r3 : t3;
-          }(t2), i2 = t2;
+          })(t2), i2 = t2;
           n2 !== t2.length && (h.uint8array ? (i2 = t2.subarray(0, n2), this.leftOver = t2.subarray(n2, t2.length)) : (i2 = t2.slice(0, n2), this.leftOver = t2.slice(n2, t2.length))), this.push({ data: s.utf8decode(i2), meta: e2.meta });
         }, a.prototype.flush = function() {
           this.leftOver && this.leftOver.length && (this.push({ data: s.utf8decode(this.leftOver), meta: {} }), this.leftOver = null);
@@ -18696,19 +19227,19 @@ function requireJszip_min() {
         }, stringifyByChar: function(e2) {
           for (var t2 = "", r2 = 0; r2 < e2.length; r2++) t2 += String.fromCharCode(e2[r2]);
           return t2;
-        }, applyCanBeUsed: { uint8array: function() {
+        }, applyCanBeUsed: { uint8array: (function() {
           try {
             return o.uint8array && 1 === String.fromCharCode.apply(null, new Uint8Array(1)).length;
           } catch (e2) {
             return false;
           }
-        }(), nodebuffer: function() {
+        })(), nodebuffer: (function() {
           try {
             return o.nodebuffer && 1 === String.fromCharCode.apply(null, r.allocBuffer(1)).length;
           } catch (e2) {
             return false;
           }
-        }() } };
+        })() } };
         function s(e2) {
           var t2 = 65536, r2 = a.getTypeOf(e2), n2 = true;
           if ("uint8array" === r2 ? n2 = i.applyCanBeUsed.uint8array : "nodebuffer" === r2 && (n2 = i.applyCanBeUsed.nodebuffer), n2) for (; 1 < t2; ) try {
@@ -18801,9 +19332,9 @@ function requireJszip_min() {
             }) : n3;
           }).then(function(e3) {
             var t2 = a.getTypeOf(e3);
-            return t2 ? ("arraybuffer" === t2 ? e3 = a.transformTo("uint8array", e3) : "string" === t2 && (s2 ? e3 = h.decode(e3) : n2 && true !== i2 && (e3 = function(e4) {
+            return t2 ? ("arraybuffer" === t2 ? e3 = a.transformTo("uint8array", e3) : "string" === t2 && (s2 ? e3 = h.decode(e3) : n2 && true !== i2 && (e3 = (function(e4) {
               return l(e4, o.uint8array ? new Uint8Array(e4.length) : new Array(e4.length));
-            }(e3))), e3) : u.Promise.reject(new Error("Can't read the data of '" + r2 + "'. Is it in a supported JavaScript type (String, Blob, ArrayBuffer, etc) ?"));
+            })(e3))), e3) : u.Promise.reject(new Error("Can't read the data of '" + r2 + "'. Is it in a supported JavaScript type (String, Blob, ArrayBuffer, etc) ?"));
           });
         };
       }, { "./base64": 1, "./external": 6, "./nodejsUtils": 14, "./support": 30, setimmediate: 54 }], 33: [function(e, t, r) {
@@ -18870,10 +19401,10 @@ function requireJszip_min() {
         }, readLocalPart: function(e2) {
           var t2, r2;
           if (e2.skip(22), this.fileNameLength = e2.readInt(2), r2 = e2.readInt(2), this.fileName = e2.readData(this.fileNameLength), e2.skip(r2), -1 === this.compressedSize || -1 === this.uncompressedSize) throw new Error("Bug or corrupted zip : didn't get enough information from the central directory (compressedSize === -1 || uncompressedSize === -1)");
-          if (null === (t2 = function(e3) {
+          if (null === (t2 = (function(e3) {
             for (var t3 in h) if (Object.prototype.hasOwnProperty.call(h, t3) && h[t3].magic === e3) return h[t3];
             return null;
-          }(this.compressionMethod))) throw new Error("Corrupted zip : compression " + s.pretty(this.compressionMethod) + " unknown (inner file : " + s.transformTo("string", this.fileName) + ")");
+          })(this.compressionMethod))) throw new Error("Corrupted zip : compression " + s.pretty(this.compressionMethod) + " unknown (inner file : " + s.transformTo("string", this.fileName) + ")");
           this.decompressed = new i(this.compressedSize, this.uncompressedSize, this.crc32, t2, e2.readData(this.compressedSize));
         }, readCentralPart: function(e2) {
           this.versionMadeBy = e2.readInt(2), e2.skip(2), this.bitFlag = e2.readInt(2), this.compressionMethod = e2.readString(2), this.date = e2.readDate(), this.crc32 = e2.readInt(4), this.compressedSize = e2.readInt(4), this.uncompressedSize = e2.readInt(4);
@@ -19276,14 +19807,14 @@ function requireJszip_min() {
       }, {}], 44: [function(e, t, r) {
         t.exports = { Z_NO_FLUSH: 0, Z_PARTIAL_FLUSH: 1, Z_SYNC_FLUSH: 2, Z_FULL_FLUSH: 3, Z_FINISH: 4, Z_BLOCK: 5, Z_TREES: 6, Z_OK: 0, Z_STREAM_END: 1, Z_NEED_DICT: 2, Z_ERRNO: -1, Z_STREAM_ERROR: -2, Z_DATA_ERROR: -3, Z_BUF_ERROR: -5, Z_NO_COMPRESSION: 0, Z_BEST_SPEED: 1, Z_BEST_COMPRESSION: 9, Z_DEFAULT_COMPRESSION: -1, Z_FILTERED: 1, Z_HUFFMAN_ONLY: 2, Z_RLE: 3, Z_FIXED: 4, Z_DEFAULT_STRATEGY: 0, Z_BINARY: 0, Z_TEXT: 1, Z_UNKNOWN: 2, Z_DEFLATED: 8 };
       }, {}], 45: [function(e, t, r) {
-        var o = function() {
+        var o = (function() {
           for (var e2, t2 = [], r2 = 0; r2 < 256; r2++) {
             e2 = r2;
             for (var n = 0; n < 8; n++) e2 = 1 & e2 ? 3988292384 ^ e2 >>> 1 : e2 >>> 1;
             t2[r2] = e2;
           }
           return t2;
-        }();
+        })();
         t.exports = function(e2, t2, r2, n) {
           var i = o, s = n + r2;
           e2 ^= -1;
@@ -19384,9 +19915,9 @@ function requireJszip_min() {
         }
         function K(e2) {
           var t2 = G(e2);
-          return t2 === m && function(e3) {
+          return t2 === m && (function(e3) {
             e3.window_size = 2 * e3.w_size, D(e3.head), e3.max_lazy_match = h[e3.level].max_lazy, e3.good_match = h[e3.level].good_length, e3.nice_match = h[e3.level].nice_length, e3.max_chain_length = h[e3.level].max_chain, e3.strstart = 0, e3.block_start = 0, e3.lookahead = 0, e3.insert = 0, e3.match_length = e3.prev_length = x - 1, e3.match_available = 0, e3.ins_h = 0;
-          }(e2.state), t2;
+          })(e2.state), t2;
         }
         function Y(e2, t2, r2, n2, i2, s2) {
           if (!e2) return _;
@@ -19453,7 +19984,7 @@ function requireJszip_min() {
           } else if (0 === e2.avail_in && T(t2) <= T(r2) && t2 !== f) return R(e2, -5);
           if (666 === n2.status && 0 !== e2.avail_in) return R(e2, -5);
           if (0 !== e2.avail_in || 0 !== n2.lookahead || t2 !== l && 666 !== n2.status) {
-            var o2 = 2 === n2.strategy ? function(e3, t3) {
+            var o2 = 2 === n2.strategy ? (function(e3, t3) {
               for (var r3; ; ) {
                 if (0 === e3.lookahead && (j(e3), 0 === e3.lookahead)) {
                   if (t3 === l) return A;
@@ -19462,7 +19993,7 @@ function requireJszip_min() {
                 if (e3.match_length = 0, r3 = u._tr_tally(e3, 0, e3.window[e3.strstart]), e3.lookahead--, e3.strstart++, r3 && (N(e3, false), 0 === e3.strm.avail_out)) return A;
               }
               return e3.insert = 0, t3 === f ? (N(e3, true), 0 === e3.strm.avail_out ? O : B) : e3.last_lit && (N(e3, false), 0 === e3.strm.avail_out) ? A : I;
-            }(n2, t2) : 3 === n2.strategy ? function(e3, t3) {
+            })(n2, t2) : 3 === n2.strategy ? (function(e3, t3) {
               for (var r3, n3, i3, s3, a3 = e3.window; ; ) {
                 if (e3.lookahead <= S) {
                   if (j(e3), e3.lookahead <= S && t3 === l) return A;
@@ -19477,7 +20008,7 @@ function requireJszip_min() {
                 if (e3.match_length >= x ? (r3 = u._tr_tally(e3, 1, e3.match_length - x), e3.lookahead -= e3.match_length, e3.strstart += e3.match_length, e3.match_length = 0) : (r3 = u._tr_tally(e3, 0, e3.window[e3.strstart]), e3.lookahead--, e3.strstart++), r3 && (N(e3, false), 0 === e3.strm.avail_out)) return A;
               }
               return e3.insert = 0, t3 === f ? (N(e3, true), 0 === e3.strm.avail_out ? O : B) : e3.last_lit && (N(e3, false), 0 === e3.strm.avail_out) ? A : I;
-            }(n2, t2) : h[n2.level].func(n2, t2);
+            })(n2, t2) : h[n2.level].func(n2, t2);
             if (o2 !== O && o2 !== B || (n2.status = 666), o2 === A || o2 === O) return 0 === e2.avail_out && (n2.last_flush = -1), m;
             if (o2 === I && (1 === t2 ? u._tr_align(n2) : 5 !== t2 && (u._tr_stored_block(n2, 0, 0, false), 3 === t2 && (D(n2.head), 0 === n2.lookahead && (n2.strstart = 0, n2.block_start = 0, n2.insert = 0))), F(e2), 0 === e2.avail_out)) return n2.last_flush = -1, m;
           }
@@ -20086,7 +20617,7 @@ function requireJszip_min() {
           for (; e2.heap_len < 2; ) s2[2 * (i2 = e2.heap[++e2.heap_len] = u2 < 2 ? ++u2 : 0)] = 1, e2.depth[i2] = 0, e2.opt_len--, o2 && (e2.static_len -= a2[2 * i2 + 1]);
           for (t2.max_code = u2, r2 = e2.heap_len >> 1; 1 <= r2; r2--) G(e2, s2, r2);
           for (i2 = h2; r2 = e2.heap[1], e2.heap[1] = e2.heap[e2.heap_len--], G(e2, s2, 1), n2 = e2.heap[1], e2.heap[--e2.heap_max] = r2, e2.heap[--e2.heap_max] = n2, s2[2 * i2] = s2[2 * r2] + s2[2 * n2], e2.depth[i2] = (e2.depth[r2] >= e2.depth[n2] ? e2.depth[r2] : e2.depth[n2]) + 1, s2[2 * r2 + 1] = s2[2 * n2 + 1] = i2, e2.heap[1] = i2++, G(e2, s2, 1), 2 <= e2.heap_len; ) ;
-          e2.heap[--e2.heap_max] = e2.heap[1], function(e3, t3) {
+          e2.heap[--e2.heap_max] = e2.heap[1], (function(e3, t3) {
             var r3, n3, i3, s3, a3, o3, h3 = t3.dyn_tree, u3 = t3.max_code, l2 = t3.stat_desc.static_tree, f2 = t3.stat_desc.has_stree, c2 = t3.stat_desc.extra_bits, d2 = t3.stat_desc.extra_base, p2 = t3.stat_desc.max_length, m2 = 0;
             for (s3 = 0; s3 <= g; s3++) e3.bl_count[s3] = 0;
             for (h3[2 * e3.heap[e3.heap_max] + 1] = 0, r3 = e3.heap_max + 1; r3 < _; r3++) p2 < (s3 = h3[2 * h3[2 * (n3 = e3.heap[r3]) + 1] + 1] + 1) && (s3 = p2, m2++), h3[2 * n3 + 1] = s3, u3 < n3 || (e3.bl_count[s3]++, a3 = 0, d2 <= n3 && (a3 = c2[n3 - d2]), o3 = h3[2 * n3], e3.opt_len += o3 * (s3 + a3), f2 && (e3.static_len += o3 * (l2[2 * n3 + 1] + a3)));
@@ -20097,7 +20628,7 @@ function requireJszip_min() {
               } while (0 < m2);
               for (s3 = p2; 0 !== s3; s3--) for (n3 = e3.bl_count[s3]; 0 !== n3; ) u3 < (i3 = e3.heap[--r3]) || (h3[2 * i3 + 1] !== s3 && (e3.opt_len += (s3 - h3[2 * i3 + 1]) * h3[2 * i3], h3[2 * i3 + 1] = s3), n3--);
             }
-          }(e2, t2), Z(s2, u2, e2.bl_count);
+          })(e2, t2), Z(s2, u2, e2.bl_count);
         }
         function X(e2, t2, r2) {
           var n2, i2, s2 = -1, a2 = t2[1], o2 = 0, h2 = 7, u2 = 4;
@@ -20114,12 +20645,12 @@ function requireJszip_min() {
         n(T);
         var q = false;
         function J(e2, t2, r2, n2) {
-          P(e2, (s << 1) + (n2 ? 1 : 0), 3), function(e3, t3, r3, n3) {
+          P(e2, (s << 1) + (n2 ? 1 : 0), 3), (function(e3, t3, r3, n3) {
             M(e3), U(e3, r3), U(e3, ~r3), i.arraySet(e3.pending_buf, e3.window, t3, r3, e3.pending), e3.pending += r3;
-          }(e2, t2, r2);
+          })(e2, t2, r2);
         }
         r._tr_init = function(e2) {
-          q || (function() {
+          q || ((function() {
             var e3, t2, r2, n2, i2, s2 = new Array(g + 1);
             for (n2 = r2 = 0; n2 < a - 1; n2++) for (I[n2] = r2, e3 = 0; e3 < 1 << w[n2]; e3++) A[r2++] = n2;
             for (A[r2 - 1] = n2, n2 = i2 = 0; n2 < 16; n2++) for (T[n2] = i2, e3 = 0; e3 < 1 << k[n2]; e3++) E[i2++] = n2;
@@ -20131,30 +20662,30 @@ function requireJszip_min() {
             for (; e3 <= 287; ) z[2 * e3 + 1] = 8, e3++, s2[8]++;
             for (Z(z, l + 1, s2), e3 = 0; e3 < f; e3++) C[2 * e3 + 1] = 5, C[2 * e3] = j(e3, 5);
             O = new D(z, w, u + 1, l, g), B = new D(C, k, 0, f, g), R = new D(new Array(0), x, 0, c, p);
-          }(), q = true), e2.l_desc = new F(e2.dyn_ltree, O), e2.d_desc = new F(e2.dyn_dtree, B), e2.bl_desc = new F(e2.bl_tree, R), e2.bi_buf = 0, e2.bi_valid = 0, W(e2);
+          })(), q = true), e2.l_desc = new F(e2.dyn_ltree, O), e2.d_desc = new F(e2.dyn_dtree, B), e2.bl_desc = new F(e2.bl_tree, R), e2.bi_buf = 0, e2.bi_valid = 0, W(e2);
         }, r._tr_stored_block = J, r._tr_flush_block = function(e2, t2, r2, n2) {
           var i2, s2, a2 = 0;
-          0 < e2.level ? (2 === e2.strm.data_type && (e2.strm.data_type = function(e3) {
+          0 < e2.level ? (2 === e2.strm.data_type && (e2.strm.data_type = (function(e3) {
             var t3, r3 = 4093624447;
             for (t3 = 0; t3 <= 31; t3++, r3 >>>= 1) if (1 & r3 && 0 !== e3.dyn_ltree[2 * t3]) return o;
             if (0 !== e3.dyn_ltree[18] || 0 !== e3.dyn_ltree[20] || 0 !== e3.dyn_ltree[26]) return h;
             for (t3 = 32; t3 < u; t3++) if (0 !== e3.dyn_ltree[2 * t3]) return h;
             return o;
-          }(e2)), Y(e2, e2.l_desc), Y(e2, e2.d_desc), a2 = function(e3) {
+          })(e2)), Y(e2, e2.l_desc), Y(e2, e2.d_desc), a2 = (function(e3) {
             var t3;
             for (X(e3, e3.dyn_ltree, e3.l_desc.max_code), X(e3, e3.dyn_dtree, e3.d_desc.max_code), Y(e3, e3.bl_desc), t3 = c - 1; 3 <= t3 && 0 === e3.bl_tree[2 * S[t3] + 1]; t3--) ;
             return e3.opt_len += 3 * (t3 + 1) + 5 + 5 + 4, t3;
-          }(e2), i2 = e2.opt_len + 3 + 7 >>> 3, (s2 = e2.static_len + 3 + 7 >>> 3) <= i2 && (i2 = s2)) : i2 = s2 = r2 + 5, r2 + 4 <= i2 && -1 !== t2 ? J(e2, t2, r2, n2) : 4 === e2.strategy || s2 === i2 ? (P(e2, 2 + (n2 ? 1 : 0), 3), K(e2, z, C)) : (P(e2, 4 + (n2 ? 1 : 0), 3), function(e3, t3, r3, n3) {
+          })(e2), i2 = e2.opt_len + 3 + 7 >>> 3, (s2 = e2.static_len + 3 + 7 >>> 3) <= i2 && (i2 = s2)) : i2 = s2 = r2 + 5, r2 + 4 <= i2 && -1 !== t2 ? J(e2, t2, r2, n2) : 4 === e2.strategy || s2 === i2 ? (P(e2, 2 + (n2 ? 1 : 0), 3), K(e2, z, C)) : (P(e2, 4 + (n2 ? 1 : 0), 3), (function(e3, t3, r3, n3) {
             var i3;
             for (P(e3, t3 - 257, 5), P(e3, r3 - 1, 5), P(e3, n3 - 4, 4), i3 = 0; i3 < n3; i3++) P(e3, e3.bl_tree[2 * S[i3] + 1], 3);
             V(e3, e3.dyn_ltree, t3 - 1), V(e3, e3.dyn_dtree, r3 - 1);
-          }(e2, e2.l_desc.max_code + 1, e2.d_desc.max_code + 1, a2 + 1), K(e2, e2.dyn_ltree, e2.dyn_dtree)), W(e2), n2 && M(e2);
+          })(e2, e2.l_desc.max_code + 1, e2.d_desc.max_code + 1, a2 + 1), K(e2, e2.dyn_ltree, e2.dyn_dtree)), W(e2), n2 && M(e2);
         }, r._tr_tally = function(e2, t2, r2) {
           return e2.pending_buf[e2.d_buf + 2 * e2.last_lit] = t2 >>> 8 & 255, e2.pending_buf[e2.d_buf + 2 * e2.last_lit + 1] = 255 & t2, e2.pending_buf[e2.l_buf + e2.last_lit] = 255 & r2, e2.last_lit++, 0 === t2 ? e2.dyn_ltree[2 * r2]++ : (e2.matches++, t2--, e2.dyn_ltree[2 * (A[r2] + u + 1)]++, e2.dyn_dtree[2 * N(t2)]++), e2.last_lit === e2.lit_bufsize - 1;
         }, r._tr_align = function(e2) {
-          P(e2, 2, 3), L(e2, m, z), function(e3) {
+          P(e2, 2, 3), L(e2, m, z), (function(e3) {
             16 === e3.bi_valid ? (U(e3, e3.bi_buf), e3.bi_buf = 0, e3.bi_valid = 0) : 8 <= e3.bi_valid && (e3.pending_buf[e3.pending++] = 255 & e3.bi_buf, e3.bi_buf >>= 8, e3.bi_valid -= 8);
-          }(e2);
+          })(e2);
         };
       }, { "../utils/common": 41 }], 53: [function(e, t, r) {
         t.exports = function() {
@@ -20162,21 +20693,21 @@ function requireJszip_min() {
         };
       }, {}], 54: [function(e, t, r) {
         (function(e2) {
-          !function(r2, n) {
+          !(function(r2, n) {
             if (!r2.setImmediate) {
               var i, s, t2, a, o = 1, h = {}, u = false, l = r2.document, e3 = Object.getPrototypeOf && Object.getPrototypeOf(r2);
               e3 = e3 && e3.setTimeout ? e3 : r2, i = "[object process]" === {}.toString.call(r2.process) ? function(e4) {
                 process$1.nextTick(function() {
                   c(e4);
                 });
-              } : function() {
+              } : (function() {
                 if (r2.postMessage && !r2.importScripts) {
                   var e4 = true, t3 = r2.onmessage;
                   return r2.onmessage = function() {
                     e4 = false;
                   }, r2.postMessage("", "*"), r2.onmessage = t3, e4;
                 }
-              }() ? (a = "setImmediate$" + Math.random() + "$", r2.addEventListener ? r2.addEventListener("message", d, false) : r2.attachEvent("onmessage", d), function(e4) {
+              })() ? (a = "setImmediate$" + Math.random() + "$", r2.addEventListener ? r2.addEventListener("message", d, false) : r2.attachEvent("onmessage", d), function(e4) {
                 r2.postMessage(a + e4, "*");
               }) : r2.MessageChannel ? ((t2 = new MessageChannel()).port1.onmessage = function(e4) {
                 c(e4.data);
@@ -20206,7 +20737,7 @@ function requireJszip_min() {
                 if (t3) {
                   u = true;
                   try {
-                    !function(e5) {
+                    !(function(e5) {
                       var t4 = e5.callback, r3 = e5.args;
                       switch (r3.length) {
                         case 0:
@@ -20224,7 +20755,7 @@ function requireJszip_min() {
                         default:
                           t4.apply(n, r3);
                       }
-                    }(t3);
+                    })(t3);
                   } finally {
                     f(e4), u = false;
                   }
@@ -20234,7 +20765,7 @@ function requireJszip_min() {
             function d(e4) {
               e4.source === r2 && "string" == typeof e4.data && 0 === e4.data.indexOf(a) && c(+e4.data.slice(a.length));
             }
-          }("undefined" == typeof self ? void 0 === e2 ? this : e2 : self);
+          })("undefined" == typeof self ? void 0 === e2 ? this : e2 : self);
         }).call(this, "undefined" != typeof commonjsGlobal ? commonjsGlobal : "undefined" != typeof self ? self : "undefined" != typeof window ? window : {});
       }, {}] }, {}, [10])(10);
     });
@@ -20521,6 +21052,14 @@ const obfuscate = (buf, fontKey) => {
   return out;
 };
 class Formatter {
+  /**
+   * Formats an XML component into a serializable object.
+   *
+   * @param input - The XML component to format
+   * @param context - The context containing file state and relationships
+   * @returns A serializable XML object structure
+   * @throws Error if the component cannot be formatted correctly
+   */
   format(input, context = { stack: [] }) {
     const output = input.prepForXml(context);
     if (output) {
@@ -20531,6 +21070,14 @@ class Formatter {
   }
 }
 class ImageReplacer {
+  /**
+   * Replaces image placeholder tokens with relationship IDs.
+   *
+   * @param xmlData - The XML string containing image placeholders
+   * @param mediaData - Array of media data to replace
+   * @param offset - Starting offset for relationship IDs
+   * @returns XML string with placeholders replaced by relationship IDs
+   */
   replace(xmlData, mediaData, offset) {
     let currentXmlData = xmlData;
     mediaData.forEach((image, i) => {
@@ -20538,11 +21085,28 @@ class ImageReplacer {
     });
     return currentXmlData;
   }
+  /**
+   * Extracts media data referenced in the XML content.
+   *
+   * @param xmlData - The XML string to search for media references
+   * @param media - The media collection to search within
+   * @returns Array of media data found in the XML
+   */
   getMediaData(xmlData, media) {
     return media.Array.filter((image) => xmlData.search(`{${image.fileName}}`) > 0);
   }
 }
 class NumberingReplacer {
+  /**
+   * Replaces numbering placeholder tokens with actual numbering IDs.
+   *
+   * Placeholder format: {reference-instance} where reference identifies the
+   * numbering definition and instance is the specific usage.
+   *
+   * @param xmlData - The XML string containing numbering placeholders
+   * @param concreteNumberings - Array of concrete numbering instances to replace
+   * @returns XML string with placeholders replaced by numbering IDs
+   */
   replace(xmlData, concreteNumberings) {
     let currentXmlData = xmlData;
     for (const concreteNumbering of concreteNumberings) {
@@ -20555,6 +21119,11 @@ class NumberingReplacer {
   }
 }
 class Compiler {
+  /**
+   * Creates a new Compiler instance.
+   *
+   * Initializes the formatter and replacer utilities used during compilation.
+   */
   constructor() {
     __publicField(this, "formatter");
     __publicField(this, "imageReplacer");
@@ -20563,6 +21132,21 @@ class Compiler {
     this.imageReplacer = new ImageReplacer();
     this.numberingReplacer = new NumberingReplacer();
   }
+  /**
+   * Compiles a File object into a JSZip archive containing the complete OOXML package.
+   *
+   * This method orchestrates the entire compilation process:
+   * - Converts all document components to XML
+   * - Manages image and numbering placeholder replacements
+   * - Creates relationship files
+   * - Packages fonts and media files
+   * - Assembles everything into a ZIP archive
+   *
+   * @param file - The document to compile
+   * @param prettifyXml - Optional XML formatting style
+   * @param overrides - Optional custom XML file overrides
+   * @returns A JSZip instance containing the complete .docx package
+   */
   compile(file, prettifyXml, overrides = []) {
     const zip = new JSZip();
     const xmlifiedFileMapping = this.xmlifyFile(file, prettifyXml);
@@ -21033,13 +21617,26 @@ class Compiler {
   }
 }
 const PrettifyType = {
+  /** No prettification (smallest file size) */
   NONE: "",
+  /** Indent with 2 spaces */
   WITH_2_BLANKS: "  ",
+  /** Indent with 4 spaces */
   WITH_4_BLANKS: "    ",
+  /** Indent with tab character */
   WITH_TAB: "	"
 };
 const convertPrettifyType = (prettify) => prettify === true ? PrettifyType.WITH_2_BLANKS : prettify === false ? void 0 : prettify;
 const _Packer = class _Packer {
+  /**
+   * Exports a document to the specified output format.
+   *
+   * @param file - The document to export
+   * @param type - The output format type (e.g., "nodebuffer", "blob", "string")
+   * @param prettify - Whether to prettify the XML output (boolean or PrettifyType)
+   * @param overrides - Optional array of file overrides for custom XML content
+   * @returns A promise resolving to the exported document in the specified format
+   */
   // eslint-disable-next-line require-await
   static pack(_0, _12, _2) {
     return __async(this, arguments, function* (file, type2, prettify, overrides = []) {
@@ -21051,21 +21648,69 @@ const _Packer = class _Packer {
       });
     });
   }
+  /**
+   * Exports a document to a string representation.
+   *
+   * @param file - The document to export
+   * @param prettify - Whether to prettify the XML output
+   * @param overrides - Optional array of file overrides
+   * @returns A promise resolving to the document as a string
+   */
   static toString(file, prettify, overrides = []) {
     return _Packer.pack(file, "string", prettify, overrides);
   }
+  /**
+   * Exports a document to a Node.js Buffer.
+   *
+   * @param file - The document to export
+   * @param prettify - Whether to prettify the XML output
+   * @param overrides - Optional array of file overrides
+   * @returns A promise resolving to the document as a Buffer
+   */
   static toBuffer(file, prettify, overrides = []) {
     return _Packer.pack(file, "nodebuffer", prettify, overrides);
   }
+  /**
+   * Exports a document to a base64-encoded string.
+   *
+   * @param file - The document to export
+   * @param prettify - Whether to prettify the XML output
+   * @param overrides - Optional array of file overrides
+   * @returns A promise resolving to the document as a base64 string
+   */
   static toBase64String(file, prettify, overrides = []) {
     return _Packer.pack(file, "base64", prettify, overrides);
   }
+  /**
+   * Exports a document to a Blob (for browser environments).
+   *
+   * @param file - The document to export
+   * @param prettify - Whether to prettify the XML output
+   * @param overrides - Optional array of file overrides
+   * @returns A promise resolving to the document as a Blob
+   */
   static toBlob(file, prettify, overrides = []) {
     return _Packer.pack(file, "blob", prettify, overrides);
   }
+  /**
+   * Exports a document to an ArrayBuffer.
+   *
+   * @param file - The document to export
+   * @param prettify - Whether to prettify the XML output
+   * @param overrides - Optional array of file overrides
+   * @returns A promise resolving to the document as an ArrayBuffer
+   */
   static toArrayBuffer(file, prettify, overrides = []) {
     return _Packer.pack(file, "arraybuffer", prettify, overrides);
   }
+  /**
+   * Exports a document to a Node.js Stream.
+   *
+   * @param file - The document to export
+   * @param prettify - Whether to prettify the XML output
+   * @param overrides - Optional array of file overrides
+   * @returns A readable stream containing the document data
+   */
   static toStream(file, prettify, overrides = []) {
     const stream = new streamBrowserifyExports.Stream();
     const zip = this.compiler.compile(file, convertPrettifyType(prettify), overrides);
@@ -21146,6 +21791,12 @@ const appendRelationship = (relationships, id, type2, target, targetMode) => {
   });
   return relationshipElements;
 };
+class TokenNotFoundError extends Error {
+  constructor(token) {
+    super(`Token ${token} not found`);
+    this.name = "TokenNotFoundError";
+  }
+}
 const findRunElementIndexWithToken = (paragraphElement, token) => {
   var _a, _b, _c, _d;
   for (let i = 0; i < ((_a = paragraphElement.elements) != null ? _a : []).length; i++) {
@@ -21162,7 +21813,7 @@ const findRunElementIndexWithToken = (paragraphElement, token) => {
       }
     }
   }
-  throw new Error("Token not found");
+  throw new TokenNotFoundError(token);
 };
 const splitRunElement = (runElement, token) => {
   var _a, _b;
@@ -21190,8 +21841,11 @@ const splitRunElement = (runElement, token) => {
   return { left: leftRunElement, right: rightRunElement };
 };
 const ReplaceMode = {
+  /** Looking for the start of the replacement text */
   START: 0,
+  /** Processing runs in the middle of the replacement text */
   MIDDLE: 1,
+  /** Reached the end of the replacement text */
   END: 2
 };
 const replaceTokenInParagraphElement = ({
@@ -21399,7 +22053,9 @@ const goToElementFromPath = (json, path) => {
 const goToParentElementFromPath = (json, path) => goToElementFromPath(json, path.slice(0, path.length - 1));
 const getLastElementIndexFromPath = (path) => path[path.length - 1];
 const PatchType = {
+  /** Replace entire file-level elements (e.g., whole paragraphs) */
   DOCUMENT: "file",
+  /** Replace content within paragraphs (inline replacement) */
   PARAGRAPH: "paragraph"
 };
 const imageReplacer = new ImageReplacer();
@@ -21416,7 +22072,7 @@ const compareByteArrays = (a, b) => {
   }
   return true;
 };
-const patchDocument = (_0) => __async(exports, [_0], function* ({
+const patchDocument = (_0) => __async(null, [_0], function* ({
   outputType,
   data,
   patches,
@@ -21609,7 +22265,7 @@ const createRelationshipFile = () => ({
     }
   ]
 });
-const patchDetector = (_0) => __async(exports, [_0], function* ({ data }) {
+const patchDetector = (_0) => __async(null, [_0], function* ({ 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)) {