docx 9.7.0 → 9.7.2

package/dist/index.cjs

@@ -7,7 +7,7 @@ var __getOwnPropNames = Object.getOwnPropertyNames;
 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];
@@ -23,7 +23,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	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) {
@@ -33,7 +33,7 @@ function _typeof(o) {
 	}, _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];
@@ -45,13 +45,13 @@ function toPrimitive(t, r) {
 	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,
@@ -251,7 +251,7 @@ var IgnoreIfEmptyXmlComponent = class extends XmlComponent {
 	}
 };
 //#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) {
@@ -308,6 +308,7 @@ var XmlAttributeComponent = class extends BaseXmlComponent {
 	*/
 	constructor(root) {
 		super("_attr");
+		_defineProperty(this, "root", void 0);
 		_defineProperty(
 			this,
 			/** Optional mapping from property names to XML attribute names. */
@@ -360,6 +361,7 @@ var NextAttributeComponent = class extends BaseXmlComponent {
 	*/
 	constructor(root) {
 		super("_attr");
+		_defineProperty(this, "root", void 0);
 		this.root = root;
 	}
 	/**
@@ -883,7 +885,7 @@ var init_dist = __esmMin((() => {
 		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
@@ -3937,7 +3939,7 @@ var require_buffer_list = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	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;
@@ -4194,7 +4196,7 @@ var require_errors_browser = /* @__PURE__ */ __commonJSMin(((exports, module) =>
 			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;
@@ -4383,7 +4385,8 @@ var require__stream_writable = /* @__PURE__ */ __commonJSMin(((exports, module)
 		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;
@@ -8125,6 +8128,7 @@ var ImportedRootElementAttributes = class extends XmlComponent {
 	*/
 	constructor(_attr) {
 		super("");
+		_defineProperty(this, "_attr", void 0);
 		this._attr = _attr;
 	}
 	/**
@@ -8835,18 +8839,31 @@ var BuilderElement = class extends XmlComponent {
 * @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"
 };
 /**
@@ -8994,32 +9011,59 @@ var createBorderElement = (elementName, { color, size, space, style }) => new Bu
 * @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
@@ -9335,10 +9379,15 @@ var createEnd = (dirty) => createFieldChar(FieldCharacterType.END, dirty);
 * @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"
 };
 /**
@@ -9349,10 +9398,15 @@ var HorizontalPositionAlign = {
 * @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
@@ -9671,6 +9725,7 @@ var createShading = ({ fill, color, type }) => new BuilderElement({
 * @publicApi
 */
 var ShadingType = {
+	/** Clear shading - no pattern, fill color only */
 	CLEAR: "clear",
 	DIAGONAL_CROSS: "diagCross",
 	DIAGONAL_STRIPE: "diagStripe",
@@ -9815,7 +9870,9 @@ var InsertionTrackChange = class extends XmlComponent {
 *
 * @publicApi
 */
-var EmphasisMarkType = { DOT: "dot" };
+var EmphasisMarkType = { 
+/** Dot emphasis mark */
+DOT: "dot" };
 /**
 * Creates an emphasis mark element for a WordprocessingML document.
 *
@@ -10232,23 +10289,41 @@ var createSubScript = () => createVerticalAlignRun("subscript");
 * @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"
 };
 /**
@@ -10334,12 +10409,19 @@ var createUnderline = (underlineType = UnderlineType.SINGLE, color) => new Build
 * @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"
 };
 /**
@@ -10375,22 +10457,39 @@ var TextEffect = {
 * ```
 */
 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"
 };
 /**
@@ -10545,9 +10644,13 @@ var Text = class extends XmlComponent {
 * @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"
 };
 /**
@@ -12170,7 +12273,7 @@ var require_hmac = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	};
 }));
 //#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();
@@ -12186,18 +12289,20 @@ var import_hash = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((expor
 	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
@@ -12406,13 +12511,53 @@ var encodeUtf8 = (str) => new Uint8Array(new TextEncoder().encode(str));
 * @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"
 };
 /**
@@ -12441,13 +12586,53 @@ var HorizontalPositionRelativeFrom = {
 * @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
@@ -14150,9 +14335,13 @@ var TextWrappingType = {
 * @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
@@ -15188,7 +15377,9 @@ var RelationshipsAttributes = class extends XmlAttributeComponent {
 *
 * 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.
 *
@@ -15546,6 +15737,7 @@ var Comments = class extends XmlComponent {
 		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",
@@ -15579,14 +15771,23 @@ var Comments = class extends XmlComponent {
 			"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();
 	}
@@ -15597,6 +15798,10 @@ var Comments = class extends XmlComponent {
 	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
@@ -15677,6 +15882,69 @@ var CommentsExtended = class extends XmlComponent {
 		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
 /**
@@ -15894,8 +16162,11 @@ var LastRenderedPageBreak = class extends EmptyElement {
 * @publicApi
 */
 var PositionalTabAlignment = {
+	/** Left-aligned tab */
 	LEFT: "left",
+	/** Center-aligned tab */
 	CENTER: "center",
+	/** Right-aligned tab */
 	RIGHT: "right"
 };
 /**
@@ -15916,7 +16187,9 @@ var PositionalTabAlignment = {
 * @publicApi
 */
 var PositionalTabRelativeTo = {
+	/** Position relative to margin */
 	MARGIN: "margin",
+	/** Position relative to indent */
 	INDENT: "indent"
 };
 /**
@@ -15940,10 +16213,15 @@ var PositionalTabRelativeTo = {
 * @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 {
@@ -16012,7 +16290,9 @@ var PositionalTab = class extends XmlComponent {
 * @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"
 };
 /**
@@ -16132,9 +16412,13 @@ var PageBreakBefore = class extends XmlComponent {
 * @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"
 };
 /**
@@ -16217,12 +16501,19 @@ var createSpacing = ({ after, before, line, lineRule, beforeAutoSpacing, afterAu
 * @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"
 };
 /**
@@ -16280,14 +16571,23 @@ var createParagraphStyle = (styleId) => new BuilderElement({
 * @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"
 };
 /**
@@ -16298,10 +16598,15 @@ var TabStopType = {
 * @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"
 };
 /**
@@ -16309,7 +16614,9 @@ var LeaderType = {
 *
 * @publicApi
 */
-var TabStopPosition = { MAX: 9026 };
+var TabStopPosition = { 
+/** Maximum tab stop position (right margin) */
+MAX: 9026 };
 /**
 * Creates a single tab stop item element.
 *
@@ -16540,7 +16847,9 @@ var HyperlinkAttributes = class extends XmlAttributeComponent {
 * @publicApi
 */
 var HyperlinkType = {
+	/** Internal hyperlink to a bookmark within the document */
 	INTERNAL: "INTERNAL",
+	/** External hyperlink to a URL outside the document */
 	EXTERNAL: "EXTERNAL"
 };
 /**
@@ -16656,6 +16965,7 @@ var InternalHyperlink = class extends ConcreteHyperlink {
 var ExternalHyperlink = class extends XmlComponent {
 	constructor(options) {
 		super("w:externalHyperlink");
+		_defineProperty(this, "options", void 0);
 		this.options = options;
 	}
 };
@@ -16905,10 +17215,10 @@ var NumberedItemReferenceFormat = /* @__PURE__ */ function(NumberedItemReference
 	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.
@@ -16927,7 +17237,7 @@ var SWITCH_MAP = {
 */
 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);
 	}
@@ -17343,6 +17653,7 @@ var createFontTable = (fonts) => new BuilderElement({
 */
 var FontWrapper = class {
 	constructor(options) {
+		_defineProperty(this, "options", void 0);
 		_defineProperty(this, "fontTable", void 0);
 		_defineProperty(this, "relationships", void 0);
 		_defineProperty(this, "fontOptionsWithKey", []);
@@ -17394,8 +17705,11 @@ var createWordWrap = () => new BuilderElement({
 * 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"
 };
 /**
@@ -17404,8 +17718,11 @@ var DropCapType = {
 * 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"
 };
 /**
@@ -17414,11 +17731,17 @@ var FrameAnchorType = {
 * 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"
 };
 /**
@@ -19917,7 +20240,13 @@ var DeletedTableCell = class extends XmlComponent {
 * 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 {
@@ -20154,9 +20483,13 @@ var createCellMargin = (options) => {
 * @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"
 };
 /**
@@ -20288,7 +20621,15 @@ var GridSpan = class extends XmlComponent {
 * 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"
 };
 /**
@@ -20337,8 +20678,11 @@ var VerticalMerge = class extends XmlComponent {
 * 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"
 };
 /**
@@ -20542,6 +20886,7 @@ var TableCellPropertiesChange = class extends XmlComponent {
 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);
@@ -20791,7 +21136,9 @@ var createTableFloatProperties = ({ horizontalAnchor, verticalAnchor, absoluteHo
 * @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"
 };
 /**
@@ -20844,7 +21191,9 @@ var createTableLayout = (type) => new BuilderElement({
 * ```
 */
 var CellSpacingType = {
+	/** Value is in twentieths of a point */
 	DXA: "dxa",
+	/** No (empty) value. */
 	NIL: "nil"
 };
 /**
@@ -21157,8 +21506,11 @@ var Table = class extends FileChild {
 * @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"
 };
 /**
@@ -21336,6 +21688,7 @@ var TableRowPropertiesChange = class extends XmlComponent {
 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);
@@ -21602,6 +21955,12 @@ var ContentTypes = class extends XmlComponent {
 		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)
@@ -22049,9 +22408,24 @@ var createColumns = ({ space, count, separate, equalWidth, children }) => new Bu
 * ```
 */
 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"
 };
 /**
@@ -22104,8 +22478,11 @@ var createDocumentGrid = ({ type, linePitch, charSpace }) => new BuilderElement(
 * ```
 */
 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 = {
@@ -22147,8 +22524,23 @@ var createHeaderFooterReference = (type, options) => new BuilderElement({
 * @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"
 };
 /**
@@ -22218,8 +22610,11 @@ var createLineNumberType = ({ countBy, start, restart, distance }) => new Builde
 * @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"
 };
 /**
@@ -22238,7 +22633,9 @@ var PageBorderDisplay = {
 * @publicApi
 */
 var PageBorderOffsetFrom = {
+	/** Position border relative to page edge */
 	PAGE: "page",
+	/** Position border relative to text (default) */
 	TEXT: "text"
 };
 /**
@@ -22257,7 +22654,9 @@ var PageBorderOffsetFrom = {
 * @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 {
@@ -22415,10 +22814,15 @@ var createPageMargin = (top, right, bottom, left, header, footer, gutter) => new
 * @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"
 };
 /**
@@ -22486,7 +22890,17 @@ var createPageNumberType = ({ start, formatType, separator }) => new BuilderElem
 * @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"
 };
 /**
@@ -22548,7 +22962,9 @@ var createPageSize = ({ width, height, orientation, code }) => {
 * 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 {
@@ -22612,10 +23028,15 @@ var PageTextDirection = class extends XmlComponent {
 * @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"
 };
 /**
@@ -22666,12 +23087,19 @@ var createSectionType = (value) => new BuilderElement({
 * @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
 };
 /**
@@ -22684,8 +23112,11 @@ var sectionMarginDefaults = {
 * @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
 };
 /**
@@ -23607,6 +24038,7 @@ var Footer$1 = class extends InitializableXmlComponent {
 */
 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;
@@ -23721,7 +24153,9 @@ var FootnoteRefRun = class extends Run {
 * @publicApi
 */
 var FootnoteType = {
+	/** Separator line between body text and footnotes */
 	SEPERATOR: "separator",
+	/** Continuation separator for footnotes spanning pages */
 	CONTINUATION_SEPERATOR: "continuationSeparator"
 };
 /**
@@ -24127,6 +24561,7 @@ var Header$1 = class extends InitializableXmlComponent {
 */
 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;
@@ -24238,68 +24673,131 @@ var WORKAROUND2 = "";
 * @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"
 };
 /**
@@ -24366,8 +24864,11 @@ var LevelJc = class extends XmlComponent {
 * @publicApi
 */
 var LevelSuffix = {
+	/** No separator after the numbering. */
 	NOTHING: "nothing",
+	/** Space character after the numbering. */
 	SPACE: "space",
+	/** Tab character after the numbering. */
 	TAB: "tab"
 };
 /**
@@ -26383,6 +26884,12 @@ var File = class {
 			"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",
@@ -26392,6 +26899,7 @@ var File = class {
 		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();
@@ -26419,8 +26927,13 @@ var File = class {
 			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);
@@ -26485,6 +26998,10 @@ var File = class {
 			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;
@@ -26535,6 +27052,10 @@ var File = class {
 	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;
 	}
@@ -26704,7 +27225,7 @@ var StructuredDocumentTagProperties = class extends XmlComponent {
 	}
 };
 //#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 = {};
@@ -26715,7 +27236,7 @@ function _objectWithoutPropertiesLoose(r, e) {
 	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);
@@ -30668,8 +31189,8 @@ var require_escapeForXML = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	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;
@@ -30842,9 +31363,12 @@ var import_xml = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((export
 	}
 	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.
 *
@@ -31108,7 +31632,7 @@ var Compiler = class {
 		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) => {
@@ -31409,6 +31933,22 @@ var Compiler = class {
 				}
 			}),
 			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, {
@@ -31425,21 +31965,21 @@ var Compiler = class {
 				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;
@@ -31480,9 +32020,13 @@ function _asyncToGenerator(n) {
 * @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;
@@ -31877,8 +32421,11 @@ var splitRunElement = (runElement, token) => {
 * 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
 };
 /**
@@ -32170,7 +32717,9 @@ var getLastElementIndexFromPath = (path) => path[path.length - 1];
 * @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();
@@ -32456,6 +33005,7 @@ exports.CommentRangeStart = CommentRangeStart;
 exports.CommentReference = CommentReference;
 exports.Comments = Comments;
 exports.CommentsExtended = CommentsExtended;
+exports.CommentsIds = CommentsIds;
 exports.ConcreteHyperlink = ConcreteHyperlink;
 exports.ConcreteNumbering = ConcreteNumbering;
 exports.ContinuationSeparator = ContinuationSeparator;