docx 9.7.0 → 9.7.2

package/dist/index.iife.js

@@ -8,7 +8,7 @@ var docx = (function(exports) {
 	var __getProtoOf = Object.getPrototypeOf;
 	var __hasOwnProp = Object.prototype.hasOwnProperty;
 	var __esmMin = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-	var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+	var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
 	var __copyProps = (to, from, except, desc) => {
 		if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
 			key = keys[i];
@@ -24,7 +24,7 @@ var docx = (function(exports) {
 		enumerable: true
 	}) : target, mod));
 	//#endregion
-	//#region \0@oxc-project+runtime@0.121.0/helpers/typeof.js
+	//#region \0@oxc-project+runtime@0.133.0/helpers/esm/typeof.js
 	function _typeof(o) {
 		"@babel/helpers - typeof";
 		return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
@@ -34,7 +34,7 @@ var docx = (function(exports) {
 		}, _typeof(o);
 	}
 	//#endregion
-	//#region \0@oxc-project+runtime@0.121.0/helpers/toPrimitive.js
+	//#region \0@oxc-project+runtime@0.133.0/helpers/esm/toPrimitive.js
 	function toPrimitive(t, r) {
 		if ("object" != _typeof(t) || !t) return t;
 		var e = t[Symbol.toPrimitive];
@@ -46,13 +46,13 @@ var docx = (function(exports) {
 		return ("string" === r ? String : Number)(t);
 	}
 	//#endregion
-	//#region \0@oxc-project+runtime@0.121.0/helpers/toPropertyKey.js
+	//#region \0@oxc-project+runtime@0.133.0/helpers/esm/toPropertyKey.js
 	function toPropertyKey(t) {
 		var i = toPrimitive(t, "string");
 		return "symbol" == _typeof(i) ? i : i + "";
 	}
 	//#endregion
-	//#region \0@oxc-project+runtime@0.121.0/helpers/defineProperty.js
+	//#region \0@oxc-project+runtime@0.133.0/helpers/esm/defineProperty.js
 	function _defineProperty(e, r, t) {
 		return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
 			value: t,
@@ -252,7 +252,7 @@ var docx = (function(exports) {
 		}
 	};
 	//#endregion
-	//#region \0@oxc-project+runtime@0.121.0/helpers/objectSpread2.js
+	//#region \0@oxc-project+runtime@0.133.0/helpers/esm/objectSpread2.js
 	function ownKeys(e, r) {
 		var t = Object.keys(e);
 		if (Object.getOwnPropertySymbols) {
@@ -309,6 +309,7 @@ var docx = (function(exports) {
 		*/
 		constructor(root) {
 			super("_attr");
+			_defineProperty(this, "root", void 0);
 			_defineProperty(
 				this,
 				/** Optional mapping from property names to XML attribute names. */
@@ -361,6 +362,7 @@ var docx = (function(exports) {
 		*/
 		constructor(root) {
 			super("_attr");
+			_defineProperty(this, "root", void 0);
 			this.root = root;
 		}
 		/**
@@ -884,7 +886,7 @@ var docx = (function(exports) {
 			return 0;
 		};
 		browserExports = browser.exports;
-		process$1 = /* @__PURE__ */ getDefaultExportFromCjs(browserExports);
+		process$1 = /*@__PURE__*/ getDefaultExportFromCjs(browserExports);
 	}));
 	//#endregion
 	//#region node_modules/stream-browserify/node_modules/readable-stream/lib/internal/streams/stream-browser.js
@@ -3938,7 +3940,7 @@ var docx = (function(exports) {
 		function copyBuffer(src, target, offset) {
 			Buffer.prototype.copy.call(src, target, offset);
 		}
-		module.exports = /* @__PURE__ */ function() {
+		module.exports = /*#__PURE__*/ function() {
 			function BufferList() {
 				_classCallCheck(this, BufferList);
 				this.head = null;
@@ -4195,7 +4197,7 @@ var docx = (function(exports) {
 				if (typeof message === "string") return message;
 				else return message(arg1, arg2, arg3);
 			}
-			var NodeError = /* @__PURE__ */ function(_Base) {
+			var NodeError = /*#__PURE__*/ function(_Base) {
 				_inheritsLoose(NodeError, _Base);
 				function NodeError(arg1, arg2, arg3) {
 					return _Base.call(this, getMessage(arg1, arg2, arg3)) || this;
@@ -4384,7 +4386,8 @@ var docx = (function(exports) {
 			this.ended = false;
 			this.finished = false;
 			this.destroyed = false;
-			this.decodeStrings = !(options.decodeStrings === false);
+			var noDecode = options.decodeStrings === false;
+			this.decodeStrings = !noDecode;
 			this.defaultEncoding = options.defaultEncoding || "utf8";
 			this.length = 0;
 			this.writing = false;
@@ -8126,6 +8129,7 @@ var docx = (function(exports) {
 		*/
 		constructor(_attr) {
 			super("");
+			_defineProperty(this, "_attr", void 0);
 			this._attr = _attr;
 		}
 		/**
@@ -8836,18 +8840,31 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var AlignmentType = {
+		/** Align Start */
 		START: "start",
+		/** Align Center */
 		CENTER: "center",
+		/** End */
 		END: "end",
+		/** Justified */
 		BOTH: "both",
+		/** Medium Kashida Length */
 		MEDIUM_KASHIDA: "mediumKashida",
+		/** Distribute All Characters Equally */
 		DISTRIBUTE: "distribute",
+		/** Align to List Tab */
 		NUM_TAB: "numTab",
+		/** Widest Kashida Length */
 		HIGH_KASHIDA: "highKashida",
+		/** Low Kashida Length */
 		LOW_KASHIDA: "lowKashida",
+		/** Thai Language Justification */
 		THAI_DISTRIBUTE: "thaiDistribute",
+		/** Align Left */
 		LEFT: "left",
+		/** Align Right */
 		RIGHT: "right",
+		/** Justified */
 		JUSTIFIED: "both"
 	};
 	/**
@@ -8995,32 +9012,59 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var BorderStyle = {
+		/** a single line */
 		SINGLE: "single",
+		/** a line with a series of alternating thin and thick strokes */
 		DASH_DOT_STROKED: "dashDotStroked",
+		/** a dashed line */
 		DASHED: "dashed",
+		/** a dashed line with small gaps */
 		DASH_SMALL_GAP: "dashSmallGap",
+		/** a line with alternating dots and dashes */
 		DOT_DASH: "dotDash",
+		/** a line with a repeating dot - dot - dash sequence */
 		DOT_DOT_DASH: "dotDotDash",
+		/** a dotted line */
 		DOTTED: "dotted",
+		/** a double line */
 		DOUBLE: "double",
+		/** a double wavy line */
 		DOUBLE_WAVE: "doubleWave",
+		/** an inset set of lines */
 		INSET: "inset",
+		/** no border */
 		NIL: "nil",
+		/** no border */
 		NONE: "none",
+		/** an outset set of lines */
 		OUTSET: "outset",
+		/** a single line */
 		THICK: "thick",
+		/** a thick line contained within a thin line with a large-sized intermediate gap */
 		THICK_THIN_LARGE_GAP: "thickThinLargeGap",
+		/** a thick line contained within a thin line with a medium-sized intermediate gap */
 		THICK_THIN_MEDIUM_GAP: "thickThinMediumGap",
+		/** a thick line contained within a thin line with a small intermediate gap */
 		THICK_THIN_SMALL_GAP: "thickThinSmallGap",
+		/** a thin line contained within a thick line with a large-sized intermediate gap */
 		THIN_THICK_LARGE_GAP: "thinThickLargeGap",
+		/** a thick line contained within a thin line with a medium-sized intermediate gap */
 		THIN_THICK_MEDIUM_GAP: "thinThickMediumGap",
+		/** a thick line contained within a thin line with a small intermediate gap */
 		THIN_THICK_SMALL_GAP: "thinThickSmallGap",
+		/** a thin-thick-thin line with a large gap */
 		THIN_THICK_THIN_LARGE_GAP: "thinThickThinLargeGap",
+		/** a thin-thick-thin line with a medium gap */
 		THIN_THICK_THIN_MEDIUM_GAP: "thinThickThinMediumGap",
+		/** a thin-thick-thin line with a small gap */
 		THIN_THICK_THIN_SMALL_GAP: "thinThickThinSmallGap",
+		/** a three-staged gradient line, getting darker towards the paragraph */
 		THREE_D_EMBOSS: "threeDEmboss",
+		/** a three-staged gradient like, getting darker away from the paragraph */
 		THREE_D_ENGRAVE: "threeDEngrave",
+		/** a triple line */
 		TRIPLE: "triple",
+		/** a wavy line */
 		WAVE: "wave"
 	};
 	//#endregion
@@ -9336,10 +9380,15 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var 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"
 	};
 	/**
@@ -9350,10 +9399,15 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var 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"
 	};
 	//#endregion
@@ -9672,6 +9726,7 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var ShadingType = {
+		/** Clear shading - no pattern, fill color only */
 		CLEAR: "clear",
 		DIAGONAL_CROSS: "diagCross",
 		DIAGONAL_STRIPE: "diagStripe",
@@ -9816,7 +9871,9 @@ var docx = (function(exports) {
 	*
 	* @publicApi
 	*/
-	var EmphasisMarkType = { DOT: "dot" };
+	var EmphasisMarkType = { 
+	/** Dot emphasis mark */
+DOT: "dot" };
 	/**
 	* Creates an emphasis mark element for a WordprocessingML document.
 	*
@@ -10233,23 +10290,41 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var 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"
 	};
 	/**
@@ -10335,12 +10410,19 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var 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"
 	};
 	/**
@@ -10376,22 +10458,39 @@ var docx = (function(exports) {
 	* ```
 	*/
 	var 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"
 	};
 	/**
@@ -10546,9 +10645,13 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var 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"
 	};
 	/**
@@ -12171,7 +12274,7 @@ var docx = (function(exports) {
 		};
 	}));
 	//#endregion
-	//#region node_modules/nanoid/non-secure/index.js
+	//#region node_modules/nanoid/url-alphabet/index.js
 	var import_hash = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports) => {
 		var hash = exports;
 		hash.utils = require_utils();
@@ -12187,18 +12290,20 @@ var docx = (function(exports) {
 		hash.ripemd160 = hash.ripemd.ripemd160;
 	})))(), 1);
 	var urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
+	//#endregion
+	//#region node_modules/nanoid/non-secure/index.js
 	var customAlphabet = (alphabet, defaultSize = 21) => {
 		return (size = defaultSize) => {
 			let id = "";
 			let i = size | 0;
-			while (i--) id += alphabet[Math.random() * alphabet.length | 0];
+			while (i-- > 0) id += alphabet[Math.random() * alphabet.length | 0];
 			return id;
 		};
 	};
 	var nanoid = (size = 21) => {
 		let id = "";
 		let i = size | 0;
-		while (i--) id += urlAlphabet[Math.random() * 64 | 0];
+		while (i-- > 0) id += urlAlphabet[Math.random() * 64 | 0];
 		return id;
 	};
 	//#endregion
@@ -12407,13 +12512,53 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var HorizontalPositionRelativeFrom = {
+		/**
+		* ## Character
+		*
+		* Specifies that the horizontal positioning shall be relative to the position of the anchor within its run content.
+		*/
 		CHARACTER: "character",
+		/**
+		* ## Column
+		*
+		* Specifies that the horizontal positioning shall be relative to the extents of the column which contains its anchor.
+		*/
 		COLUMN: "column",
+		/**
+		* ## Inside Margin
+		*
+		* Specifies that the horizontal positioning shall be relative to the inside margin of the current page (the left margin on odd pages, right on even pages).
+		*/
 		INSIDE_MARGIN: "insideMargin",
+		/**
+		* ## Left Margin
+		*
+		* Specifies that the horizontal positioning shall be relative to the left margin of the page.
+		*/
 		LEFT_MARGIN: "leftMargin",
+		/**
+		* ## Page Margin
+		*
+		* Specifies that the horizontal positioning shall be relative to the page margins.
+		*/
 		MARGIN: "margin",
+		/**
+		* ## Outside Margin
+		*
+		* Specifies that the horizontal positioning shall be relative to the outside margin of the current page (the right margin on odd pages, left on even pages).
+		*/
 		OUTSIDE_MARGIN: "outsideMargin",
+		/**
+		* ## Page Edge
+		*
+		* Specifies that the horizontal positioning shall be relative to the edge of the page.
+		*/
 		PAGE: "page",
+		/**
+		* ## Right Margin
+		*
+		* Specifies that the horizontal positioning shall be relative to the right margin of the page.
+		*/
 		RIGHT_MARGIN: "rightMargin"
 	};
 	/**
@@ -12442,13 +12587,53 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var VerticalPositionRelativeFrom = {
+		/**
+		* ## Bottom Margin
+		*
+		* Specifies that the vertical positioning shall be relative to the bottom margin of the current page.
+		*/
 		BOTTOM_MARGIN: "bottomMargin",
+		/**
+		* ## Inside Margin
+		*
+		* Specifies that the vertical positioning shall be relative to the inside margin of the current page.
+		*/
 		INSIDE_MARGIN: "insideMargin",
+		/**
+		* ## Line
+		*
+		* Specifies that the vertical positioning shall be relative to the line containing the anchor character.
+		*/
 		LINE: "line",
+		/**
+		* ## Page Margin
+		*
+		* Specifies that the vertical positioning shall be relative to the page margins.
+		*/
 		MARGIN: "margin",
+		/**
+		* ## Outside Margin
+		*
+		* Specifies that the vertical positioning shall be relative to the outside margin of the current page.
+		*/
 		OUTSIDE_MARGIN: "outsideMargin",
+		/**
+		* ## Page Edge
+		*
+		* Specifies that the vertical positioning shall be relative to the edge of the page.
+		*/
 		PAGE: "page",
+		/**
+		* ## Paragraph
+		*
+		* Specifies that the vertical positioning shall be relative to the paragraph which contains the drawing anchor.
+		*/
 		PARAGRAPH: "paragraph",
+		/**
+		* ## Top Margin
+		*
+		* Specifies that the vertical positioning shall be relative to the top margin of the current page.
+		*/
 		TOP_MARGIN: "topMargin"
 	};
 	//#endregion
@@ -14151,9 +14336,13 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var 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"
 	};
 	//#endregion
@@ -15189,7 +15378,9 @@ var docx = (function(exports) {
 	*
 	* Indicates whether a relationship target is external to the package.
 	*/
-	var TargetModeType = { EXTERNAL: "External" };
+	var TargetModeType = { 
+	/** Target is external to the package (e.g., hyperlink to a URL) */
+EXTERNAL: "External" };
 	/**
 	* Creates a single relationship between parts in an OPC package.
 	*
@@ -15547,6 +15738,7 @@ var docx = (function(exports) {
 			super("w:comments");
 			_defineProperty(this, "relationships", void 0);
 			_defineProperty(this, "threadData", void 0);
+			_defineProperty(this, "commentIdsData", void 0);
 			this.root.push(new RootCommentsAttributes({
 				"xmlns:cx": "http://schemas.microsoft.com/office/drawing/2014/chartex",
 				"xmlns:cx1": "http://schemas.microsoft.com/office/drawing/2015/9/8/chartex",
@@ -15580,14 +15772,23 @@ var docx = (function(exports) {
 				"xmlns:wne": "http://schemas.microsoft.com/office/word/2006/wordml",
 				"xmlns:wps": "http://schemas.microsoft.com/office/word/2010/wordprocessingShape"
 			}));
-			if (children.some((child) => child.parentId !== void 0)) {
+			const hasThreading = children.some((child) => child.parentId !== void 0);
+			const hasDurableIds = children.some((child) => child.durableId !== void 0);
+			if (hasThreading || hasDurableIds) {
 				const idToParaId = new Map(children.map((child) => [child.id, commentIdToParaId(child.id)]));
 				for (const child of children) this.root.push(new Comment(child, idToParaId.get(child.id)));
-				this.threadData = children.map((child) => ({
+				if (hasThreading) this.threadData = children.map((child) => ({
 					paraId: idToParaId.get(child.id),
 					parentParaId: child.parentId !== void 0 ? idToParaId.get(child.parentId) : void 0,
 					done: child.resolved
 				}));
+				if (hasDurableIds) this.commentIdsData = children.map((child) => {
+					var _child$durableId;
+					return {
+						paraId: idToParaId.get(child.id),
+						durableId: (_child$durableId = child.durableId) !== null && _child$durableId !== void 0 ? _child$durableId : idToParaId.get(child.id)
+					};
+				});
 			} else for (const child of children) this.root.push(new Comment(child));
 			this.relationships = new Relationships();
 		}
@@ -15598,6 +15799,10 @@ var docx = (function(exports) {
 		get ThreadData() {
 			return this.threadData;
 		}
+		/** Comment id data for commentsIds.xml, or undefined when no comments carry a durableId. */
+		get CommentIdsData() {
+			return this.commentIdsData;
+		}
 	};
 	//#endregion
 	//#region src/file/paragraph/run/comments-extended.ts
@@ -15678,6 +15883,69 @@ var docx = (function(exports) {
 			for (const data of threadData) this.root.push(new CommentEx(data));
 		}
 	};
+	/**
+	* @internal
+	*/
+	var CommentIdAttributes = class extends XmlAttributeComponent {
+		constructor(..._args3) {
+			super(..._args3);
+			_defineProperty(this, "xmlKeys", {
+				paraId: "w16cid:paraId",
+				durableId: "w16cid:durableId"
+			});
+		}
+	};
+	/**
+	* @internal
+	*/
+	var CommentId = class extends XmlComponent {
+		constructor(options) {
+			super("w16cid:commentId");
+			this.root.push(new CommentIdAttributes({
+				paraId: options.paraId,
+				durableId: options.durableId
+			}));
+		}
+	};
+	/**
+	* @internal
+	*/
+	var CommentsIdsAttributes = class extends XmlAttributeComponent {
+		constructor(..._args4) {
+			super(..._args4);
+			_defineProperty(this, "xmlKeys", {
+				"xmlns:w16cid": "xmlns:w16cid",
+				"xmlns:mc": "xmlns:mc",
+				"mc:Ignorable": "mc:Ignorable"
+			});
+		}
+	};
+	/**
+	* Represents the commentsIds part (word/commentsIds.xml).
+	*
+	* Contains w16cid:commentId elements that map each comment's volatile paraId
+	* to a stable w16cid:durableId preserved by Word across edits.
+	*
+	* ## XSD Schema (wml-cid.xsd)
+	* ```xml
+	* <xsd:complexType name="CT_CommentsIds">
+	*   <xsd:sequence>
+	*     <xsd:element name="commentId" type="CT_CommentId" minOccurs="0" maxOccurs="unbounded"/>
+	*   </xsd:sequence>
+	* </xsd:complexType>
+	* ```
+	*/
+	var CommentsIds = class extends XmlComponent {
+		constructor(commentIdsData) {
+			super("w16cid:commentsIds");
+			this.root.push(new CommentsIdsAttributes({
+				"xmlns:w16cid": "http://schemas.microsoft.com/office/word/2016/wordml/cid",
+				"xmlns:mc": "http://schemas.openxmlformats.org/markup-compatibility/2006",
+				"mc:Ignorable": "w16cid"
+			}));
+			for (const data of commentIdsData) this.root.push(new CommentId(data));
+		}
+	};
 	//#endregion
 	//#region src/file/paragraph/run/empty-children.ts
 	/**
@@ -15895,8 +16163,11 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var PositionalTabAlignment = {
+		/** Left-aligned tab */
 		LEFT: "left",
+		/** Center-aligned tab */
 		CENTER: "center",
+		/** Right-aligned tab */
 		RIGHT: "right"
 	};
 	/**
@@ -15917,7 +16188,9 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var PositionalTabRelativeTo = {
+		/** Position relative to margin */
 		MARGIN: "margin",
+		/** Position relative to indent */
 		INDENT: "indent"
 	};
 	/**
@@ -15941,10 +16214,15 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var PositionalTabLeader = {
+		/** No leader character */
 		NONE: "none",
+		/** Dot leader (...) */
 		DOT: "dot",
+		/** Hyphen leader (---) */
 		HYPHEN: "hyphen",
+		/** Underscore leader (___) */
 		UNDERSCORE: "underscore",
+		/** Middle dot leader (···) */
 		MIDDLE_DOT: "middleDot"
 	};
 	var PositionalTabAttributes = class extends XmlAttributeComponent {
@@ -16013,7 +16291,9 @@ var docx = (function(exports) {
 	* @internal
 	*/
 	var 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"
 	};
 	/**
@@ -16133,9 +16413,13 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var 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"
 	};
 	/**
@@ -16218,12 +16502,19 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var 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"
 	};
 	/**
@@ -16281,14 +16572,23 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var 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"
 	};
 	/**
@@ -16299,10 +16599,15 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var LeaderType = {
+		/** Dot leader (....) */
 		DOT: "dot",
+		/** Hyphen leader (----) */
 		HYPHEN: "hyphen",
+		/** Middle dot leader (····) */
 		MIDDLE_DOT: "middleDot",
+		/** No leader */
 		NONE: "none",
+		/** Underscore leader (____) */
 		UNDERSCORE: "underscore"
 	};
 	/**
@@ -16310,7 +16615,9 @@ var docx = (function(exports) {
 	*
 	* @publicApi
 	*/
-	var TabStopPosition = { MAX: 9026 };
+	var TabStopPosition = { 
+	/** Maximum tab stop position (right margin) */
+MAX: 9026 };
 	/**
 	* Creates a single tab stop item element.
 	*
@@ -16541,7 +16848,9 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var HyperlinkType = {
+		/** Internal hyperlink to a bookmark within the document */
 		INTERNAL: "INTERNAL",
+		/** External hyperlink to a URL outside the document */
 		EXTERNAL: "EXTERNAL"
 	};
 	/**
@@ -16657,6 +16966,7 @@ var docx = (function(exports) {
 	var ExternalHyperlink = class extends XmlComponent {
 		constructor(options) {
 			super("w:externalHyperlink");
+			_defineProperty(this, "options", void 0);
 			this.options = options;
 		}
 	};
@@ -16906,10 +17216,10 @@ var docx = (function(exports) {
 		return NumberedItemReferenceFormat;
 	}({});
 	var SWITCH_MAP = {
-		[NumberedItemReferenceFormat.RELATIVE]: "\\r",
-		[NumberedItemReferenceFormat.NO_CONTEXT]: "\\n",
-		[NumberedItemReferenceFormat.FULL_CONTEXT]: "\\w",
-		[NumberedItemReferenceFormat.NONE]: void 0
+		["relative"]: "\\r",
+		["no_context"]: "\\n",
+		["full_context"]: "\\w",
+		["none"]: void 0
 	};
 	/**
 	* Creates a field/cross reference to a numbered item in the document.
@@ -16928,7 +17238,7 @@ var docx = (function(exports) {
 	*/
 	var NumberedItemReference = class extends SimpleField {
 		constructor(bookmarkId, cachedValue, options = {}) {
-			const { hyperlink = true, referenceFormat = NumberedItemReferenceFormat.FULL_CONTEXT } = options;
+			const { hyperlink = true, referenceFormat = "full_context" } = options;
 			const instruction = `${`REF ${bookmarkId}`} ${[...hyperlink ? ["\\h"] : [], ...[SWITCH_MAP[referenceFormat]].filter((a) => !!a)].join(" ")}`;
 			super(instruction, cachedValue);
 		}
@@ -17344,6 +17654,7 @@ var docx = (function(exports) {
 	*/
 	var FontWrapper = class {
 		constructor(options) {
+			_defineProperty(this, "options", void 0);
 			_defineProperty(this, "fontTable", void 0);
 			_defineProperty(this, "relationships", void 0);
 			_defineProperty(this, "fontOptionsWithKey", []);
@@ -17395,8 +17706,11 @@ var docx = (function(exports) {
 	* beginning of a paragraph. This enum defines how the drop cap should be positioned.
 	*/
 	var 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"
 	};
 	/**
@@ -17405,8 +17719,11 @@ var docx = (function(exports) {
 	* Determines the reference point for frame positioning (horizontal and vertical).
 	*/
 	var 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"
 	};
 	/**
@@ -17415,11 +17732,17 @@ var docx = (function(exports) {
 	* Controls how surrounding text wraps around the frame.
 	*/
 	var 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"
 	};
 	/**
@@ -19918,7 +20241,13 @@ var docx = (function(exports) {
 	* Vertical merge revision types.
 	*/
 	var VerticalMergeRevisionType = {
+		/**
+		* Cell that is merged with upper one.
+		*/
 		CONTINUE: "cont",
+		/**
+		* Cell that is starting the vertical merge.
+		*/
 		RESTART: "rest"
 	};
 	var CellMergeAttributes = class extends XmlAttributeComponent {
@@ -20155,9 +20484,13 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var WidthType = {
+		/** Auto. */
 		AUTO: "auto",
+		/** Value is in twentieths of a point */
 		DXA: "dxa",
+		/** No (empty) value. */
 		NIL: "nil",
+		/** Value is in percentage. */
 		PERCENTAGE: "pct"
 	};
 	/**
@@ -20289,7 +20622,15 @@ var docx = (function(exports) {
 	* Defines the merge behavior for vertically merged cells (row span).
 	*/
 	var 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"
 	};
 	/**
@@ -20338,8 +20679,11 @@ var docx = (function(exports) {
 	* Specifies the direction in which text flows within a table cell.
 	*/
 	var 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"
 	};
 	/**
@@ -20543,6 +20887,7 @@ var docx = (function(exports) {
 	var TableCell = class extends XmlComponent {
 		constructor(options) {
 			super("w:tc");
+			_defineProperty(this, "options", void 0);
 			this.options = options;
 			this.root.push(new TableCellProperties(options));
 			for (const child of options.children) this.root.push(child);
@@ -20792,7 +21137,9 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var TableLayoutType = {
+		/** Auto-fit layout - column widths are adjusted based on content */
 		AUTOFIT: "autofit",
+		/** Fixed layout - column widths are fixed as specified */
 		FIXED: "fixed"
 	};
 	/**
@@ -20845,7 +21192,9 @@ var docx = (function(exports) {
 	* ```
 	*/
 	var CellSpacingType = {
+		/** Value is in twentieths of a point */
 		DXA: "dxa",
+		/** No (empty) value. */
 		NIL: "nil"
 	};
 	/**
@@ -21158,8 +21507,11 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var HeightRule = {
+		/** Height is determined based on the content, so value is ignored. */
 		AUTO: "auto",
+		/** At least the value specified */
 		ATLEAST: "atLeast",
+		/** Exactly the value specified */
 		EXACT: "exact"
 	};
 	/**
@@ -21337,6 +21689,7 @@ var docx = (function(exports) {
 	var TableRow = class extends XmlComponent {
 		constructor(options) {
 			super("w:tr");
+			_defineProperty(this, "options", void 0);
 			this.options = options;
 			this.root.push(new TableRowProperties(options));
 			for (const child of options.children) this.root.push(child);
@@ -21603,6 +21956,12 @@ var docx = (function(exports) {
 			this.root.push(createOverride("application/vnd.openxmlformats-officedocument.wordprocessingml.commentsExtended+xml", "/word/commentsExtended.xml"));
 		}
 		/**
+		* Registers the commentsIds part in the content types.
+		*/
+		addCommentsIds() {
+			this.root.push(createOverride("application/vnd.openxmlformats-officedocument.wordprocessingml.commentsIds+xml", "/word/commentsIds.xml"));
+		}
+		/**
 		* Registers a footer part in the content types.
 		*
 		* @param index - Footer index number (e.g., 1 for footer1.xml)
@@ -22050,9 +22409,24 @@ var docx = (function(exports) {
 	* ```
 	*/
 	var DocumentGridType = {
+		/**
+		* Specifies that no document grid shall be applied to the contents of the current section in the document.
+		*/
 		DEFAULT: "default",
+		/**
+		* Specifies that the parent section shall have additional line pitch added to each line within it (as specified on the <docGrid> element (§2.6.5)) in order to maintain the specified number of lines per page.
+		*/
 		LINES: "lines",
+		/**
+		* Specifies that the parent section shall have both the additional line pitch and character pitch added to each line and character within it (as specified on the <docGrid> element (§2.6.5)) in order to maintain a specific number of lines per page and characters per line.
+		*
+		* When this value is set, the input specified via the user interface may be allowed in exact number of line/character pitch units. */
 		LINES_AND_CHARS: "linesAndChars",
+		/**
+		* Specifies that the parent section shall have both the additional line pitch and character pitch added to each line and character within it (as specified on the <docGrid> element (§2.6.5)) in order to maintain a specific number of lines per page and characters per line.
+		*
+		* When this value is set, the input specified via the user interface may be restricted to the number of lines per page and characters per line, with the consumer or producer translating this information based on the current font data to get the resulting line and character pitch values
+		*/
 		SNAP_TO_CHARS: "snapToChars"
 	};
 	/**
@@ -22105,8 +22479,11 @@ var docx = (function(exports) {
 	* ```
 	*/
 	var HeaderFooterReferenceType = {
+		/** Specifies that this header or footer shall appear on every page in this section which is not overridden with a specific `even` or `first` page header/footer. In a section with all three types specified, this type shall be used on all odd numbered pages (counting from the `first` page in the section, not the section numbering). */
 		DEFAULT: "default",
+		/** Specifies that this header or footer shall appear on the first page in this section. The appearance of this header or footer is contingent on the setting of the `titlePg` element (§2.10.6). */
 		FIRST: "first",
+		/** Specifies that this header or footer shall appear on all even numbered pages in this section (counting from the first page in the section, not the section numbering). The appearance of this header or footer is contingent on the setting of the `evenAndOddHeaders` element (§2.10.1). */
 		EVEN: "even"
 	};
 	var HeaderFooterType = {
@@ -22148,8 +22525,23 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var LineNumberRestartFormat = {
+		/**
+		* ## Restart Line Numbering on Each Page
+		*
+		* Specifies that line numbering for the parent section shall restart to the starting value whenever a new page is displayed.
+		*/
 		NEW_PAGE: "newPage",
+		/**
+		* ## Restart Line Numbering for Each Section
+		*
+		* Specifies that line numbering for the parent section shall restart to the starting value whenever the parent begins.
+		*/
 		NEW_SECTION: "newSection",
+		/**
+		* ## Continue Line Numbering From Previous Section
+		*
+		* Specifies that line numbering for the parent section shall continue from the line numbering from the end of the previous section, if any.
+		*/
 		CONTINUOUS: "continuous"
 	};
 	/**
@@ -22219,8 +22611,11 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var 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"
 	};
 	/**
@@ -22239,7 +22634,9 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var PageBorderOffsetFrom = {
+		/** Position border relative to page edge */
 		PAGE: "page",
+		/** Position border relative to text (default) */
 		TEXT: "text"
 	};
 	/**
@@ -22258,7 +22655,9 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var PageBorderZOrder = {
+		/** Display border behind page contents */
 		BACK: "back",
+		/** Display border in front of page contents (default) */
 		FRONT: "front"
 	};
 	var PageBordersAttributes = class extends XmlAttributeComponent {
@@ -22416,10 +22815,15 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var 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"
 	};
 	/**
@@ -22487,7 +22891,17 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var PageOrientation = {
+		/**
+		* ## Portrait Mode
+		*
+		* Specifies that pages in this section shall be printed in portrait mode.
+		*/
 		PORTRAIT: "portrait",
+		/**
+		* ## Landscape Mode
+		*
+		* Specifies that pages in this section shall be printed in landscape mode, which prints the page contents with a 90 degree rotation with respect to the normal page orientation.
+		*/
 		LANDSCAPE: "landscape"
 	};
 	/**
@@ -22549,7 +22963,9 @@ var docx = (function(exports) {
 	* vertically (top-to-bottom), commonly used for East Asian languages.
 	*/
 	var 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"
 	};
 	var PageTextDirectionAttributes = class extends XmlAttributeComponent {
@@ -22613,10 +23029,15 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var 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"
 	};
 	/**
@@ -22667,12 +23088,19 @@ var docx = (function(exports) {
 	* @property GUTTER - Gutter margin: 0 twips
 	*/
 	var 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
 	};
 	/**
@@ -22685,8 +23113,11 @@ var docx = (function(exports) {
 	* @property ORIENTATION - Page orientation: portrait
 	*/
 	var 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
 	};
 	/**
@@ -23608,6 +24039,7 @@ var docx = (function(exports) {
 	*/
 	var FooterWrapper = class {
 		constructor(media, referenceId, initContent) {
+			_defineProperty(this, "media", void 0);
 			_defineProperty(this, "footer", void 0);
 			_defineProperty(this, "relationships", void 0);
 			this.media = media;
@@ -23722,7 +24154,9 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var FootnoteType = {
+		/** Separator line between body text and footnotes */
 		SEPERATOR: "separator",
+		/** Continuation separator for footnotes spanning pages */
 		CONTINUATION_SEPERATOR: "continuationSeparator"
 	};
 	/**
@@ -24128,6 +24562,7 @@ var docx = (function(exports) {
 	*/
 	var HeaderWrapper = class {
 		constructor(media, referenceId, initContent) {
+			_defineProperty(this, "media", void 0);
 			_defineProperty(this, "header", void 0);
 			_defineProperty(this, "relationships", void 0);
 			this.media = media;
@@ -24239,68 +24674,131 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var 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"
 	};
 	/**
@@ -24367,8 +24865,11 @@ var docx = (function(exports) {
 	* @publicApi
 	*/
 	var LevelSuffix = {
+		/** No separator after the numbering. */
 		NOTHING: "nothing",
+		/** Space character after the numbering. */
 		SPACE: "space",
+		/** Tab character after the numbering. */
 		TAB: "tab"
 	};
 	/**
@@ -26384,6 +26885,12 @@ var docx = (function(exports) {
 				"commentsExtended",
 				void 0
 			);
+			_defineProperty(
+				this,
+				/** Durable comment id mapping (word/commentsIds.xml). */
+				"commentsIds",
+				void 0
+			);
 			_defineProperty(this, "fontWrapper", void 0);
 			this.coreProperties = new CoreProperties(_objectSpread2(_objectSpread2({}, options), {}, {
 				creator: (_options$creator = options.creator) !== null && _options$creator !== void 0 ? _options$creator : "Un-named",
@@ -26393,6 +26900,7 @@ var docx = (function(exports) {
 			this.numbering = new Numbering(options.numbering ? options.numbering : { config: [] });
 			this.comments = new Comments((_options$comments = options.comments) !== null && _options$comments !== void 0 ? _options$comments : { children: [] });
 			if (this.comments.ThreadData) this.commentsExtended = new CommentsExtended(this.comments.ThreadData);
+			if (this.comments.CommentIdsData) this.commentsIds = new CommentsIds(this.comments.CommentIdsData);
 			this.fileRelationships = new Relationships();
 			this.customProperties = new CustomProperties((_options$customProper = options.customProperties) !== null && _options$customProper !== void 0 ? _options$customProper : []);
 			this.appProperties = new AppProperties();
@@ -26420,8 +26928,13 @@ var docx = (function(exports) {
 				const defaultStyles = new DefaultStylesFactory().newInstance((_options$styles = options.styles) === null || _options$styles === void 0 ? void 0 : _options$styles.default);
 				const externalStyles = new ExternalStylesFactory().newInstance(options.externalStyles);
 				this.styles = new Styles(_objectSpread2(_objectSpread2({}, externalStyles), {}, { importedStyles: [...defaultStyles.importedStyles, ...externalStyles.importedStyles] }));
-			} else if (options.styles) this.styles = new Styles(_objectSpread2(_objectSpread2({}, new DefaultStylesFactory().newInstance(options.styles.default)), options.styles));
-			else this.styles = new Styles(new DefaultStylesFactory().newInstance());
+			} else if (options.styles) {
+				const defaultStyles = new DefaultStylesFactory().newInstance(options.styles.default);
+				this.styles = new Styles(_objectSpread2(_objectSpread2({}, defaultStyles), options.styles));
+			} else {
+				const stylesFactory = new DefaultStylesFactory();
+				this.styles = new Styles(stylesFactory.newInstance());
+			}
 			this.addDefaultRelationships();
 			for (const section of options.sections) this.addSection(section);
 			if (options.footnotes) for (const key in options.footnotes) this.footnotesWrapper.View.createFootNote(parseFloat(key), options.footnotes[key].children);
@@ -26486,6 +26999,10 @@ var docx = (function(exports) {
 				this.documentWrapper.Relationships.addRelationship(this.currentRelationshipId++, "http://schemas.microsoft.com/office/2011/relationships/commentsExtended", "commentsExtended.xml");
 				this.contentTypes.addCommentsExtended();
 			}
+			if (this.commentsIds) {
+				this.documentWrapper.Relationships.addRelationship(this.currentRelationshipId++, "http://schemas.microsoft.com/office/2016/09/relationships/commentsIds", "commentsIds.xml");
+				this.contentTypes.addCommentsIds();
+			}
 		}
 		get Document() {
 			return this.documentWrapper;
@@ -26536,6 +27053,10 @@ var docx = (function(exports) {
 		get CommentsExtended() {
 			return this.commentsExtended;
 		}
+		/** Durable comment id part. Undefined when no comment carries a durableId. */
+		get CommentsIds() {
+			return this.commentsIds;
+		}
 		get FontTable() {
 			return this.fontWrapper;
 		}
@@ -26705,7 +27226,7 @@ var docx = (function(exports) {
 		}
 	};
 	//#endregion
-	//#region \0@oxc-project+runtime@0.121.0/helpers/objectWithoutPropertiesLoose.js
+	//#region \0@oxc-project+runtime@0.133.0/helpers/esm/objectWithoutPropertiesLoose.js
 	function _objectWithoutPropertiesLoose(r, e) {
 		if (null == r) return {};
 		var t = {};
@@ -26716,7 +27237,7 @@ var docx = (function(exports) {
 		return t;
 	}
 	//#endregion
-	//#region \0@oxc-project+runtime@0.121.0/helpers/objectWithoutProperties.js
+	//#region \0@oxc-project+runtime@0.133.0/helpers/esm/objectWithoutProperties.js
 	function _objectWithoutProperties(e, t) {
 		if (null == e) return {};
 		var o, r, i = _objectWithoutPropertiesLoose(e, t);
@@ -30669,8 +31190,8 @@ while (n === a[++i] && n === a[++i] && n === a[++i] && n === a[++i] && n === a[+
 		module.exports = escapeForXML;
 	}));
 	//#endregion
-	//#region src/file/fonts/obfuscate-ttf-to-odttf.ts
-	var import_xml = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports, module) => {
+	//#region node_modules/xml/lib/xml.js
+	var require_xml = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		init_dist();
 		var escapeForXML = require_escapeForXML();
 		var Stream = require_stream_browserify().Stream;
@@ -30843,9 +31364,12 @@ while (n === a[++i] && n === a[++i] && n === a[++i] && n === a[++i] && n === a[+
 		}
 		module.exports = xml;
 		module.exports.element = module.exports.Element = element;
-	})))(), 1);
-	var import_jszip_min = /* @__PURE__ */ __toESM(require_jszip_min(), 1);
+	}));
+	//#endregion
+	//#region src/file/fonts/obfuscate-ttf-to-odttf.ts
 	var import_stream_browserify = require_stream_browserify();
+	var import_jszip_min = /* @__PURE__ */ __toESM(require_jszip_min(), 1);
+	var import_xml = /* @__PURE__ */ __toESM(require_xml(), 1);
 	/**
 	* Font obfuscation module for embedding fonts in WordprocessingML documents.
 	*
@@ -31109,7 +31633,7 @@ while (n === a[++i] && n === a[++i] && n === a[++i] && n === a[++i] && n === a[+
 			const documentMediaDatas = this.imageReplacer.getMediaData(documentXmlData, file.Media);
 			const commentMediaDatas = this.imageReplacer.getMediaData(commentXmlData, file.Media);
 			const footnoteMediaDatas = this.imageReplacer.getMediaData(footnoteXmlData, file.Media);
-			return _objectSpread2(_objectSpread2({
+			return _objectSpread2(_objectSpread2(_objectSpread2({
 				Relationships: {
 					data: (() => {
 						documentMediaDatas.forEach((mediaData, i) => {
@@ -31410,6 +31934,22 @@ while (n === a[++i] && n === a[++i] && n === a[++i] && n === a[++i] && n === a[+
 					}
 				}),
 				path: "word/commentsExtended.xml"
+			} } : {}), file.CommentsIds ? { CommentsIds: {
+				data: (0, import_xml.default)(this.formatter.format(file.CommentsIds, {
+					viewWrapper: {
+						View: file.CommentsIds,
+						Relationships: file.Comments.Relationships
+					},
+					file,
+					stack: []
+				}), {
+					indent: prettify,
+					declaration: {
+						standalone: "yes",
+						encoding: "UTF-8"
+					}
+				}),
+				path: "word/commentsIds.xml"
 			} } : {}), {}, {
 				FontTable: {
 					data: (0, import_xml.default)(this.formatter.format(file.FontTable.View, {
@@ -31426,21 +31966,21 @@ while (n === a[++i] && n === a[++i] && n === a[++i] && n === a[++i] && n === a[+
 					path: "word/fontTable.xml"
 				},
 				FontTableRelationships: {
-					data: (0, import_xml.default)(this.formatter.format(file.FontTable.Relationships, {
+					data: (() => (0, import_xml.default)(this.formatter.format(file.FontTable.Relationships, {
 						viewWrapper: file.Document,
 						file,
 						stack: []
 					}), {
 						indent: prettify,
 						declaration: { encoding: "UTF-8" }
-					}),
+					}))(),
 					path: "word/_rels/fontTable.xml.rels"
 				}
 			});
 		}
 	};
 	//#endregion
-	//#region \0@oxc-project+runtime@0.121.0/helpers/asyncToGenerator.js
+	//#region \0@oxc-project+runtime@0.133.0/helpers/esm/asyncToGenerator.js
 	function asyncGeneratorStep(n, t, e, r, o, a, c) {
 		try {
 			var i = n[a](c), u = i.value;
@@ -31481,9 +32021,13 @@ while (n === a[++i] && n === a[++i] && n === a[++i] && n === a[++i] && n === a[+
 	* @publicApi
 	*/
 	var 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: "	"
 	};
 	var convertPrettifyType = (prettify) => prettify === true ? PrettifyType.WITH_2_BLANKS : prettify === false ? void 0 : prettify;
@@ -31878,8 +32422,11 @@ while (n === a[++i] && n === a[++i] && n === a[++i] && n === a[++i] && n === a[+
 	* Replacement modes for multi-run text replacement.
 	*/
 	var 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
 	};
 	/**
@@ -32171,7 +32718,9 @@ while (n === a[++i] && n === a[++i] && n === a[++i] && n === a[++i] && n === a[+
 	* @publicApi
 	*/
 	var PatchType = {
+		/** Replace entire file-level elements (e.g., whole paragraphs) */
 		DOCUMENT: "file",
+		/** Replace content within paragraphs (inline replacement) */
 		PARAGRAPH: "paragraph"
 	};
 	var imageReplacer = new ImageReplacer();
@@ -32457,6 +33006,7 @@ while (n === a[++i] && n === a[++i] && n === a[++i] && n === a[++i] && n === a[+
 	exports.CommentReference = CommentReference;
 	exports.Comments = Comments;
 	exports.CommentsExtended = CommentsExtended;
+	exports.CommentsIds = CommentsIds;
 	exports.ConcreteHyperlink = ConcreteHyperlink;
 	exports.ConcreteNumbering = ConcreteNumbering;
 	exports.ContinuationSeparator = ContinuationSeparator;