@office-open/docx 0.4.4 → 0.4.6

package/dist/index.mjs

@@ -1716,57 +1716,6 @@ const createRunFonts = (nameOrAttrs, hint) => {
 	});
 };
 //#endregion
-//#region src/file/paragraph/run/script.ts
-/**
-* Subscript and superscript module for WordprocessingML documents.
-*
-* This module provides vertical alignment elements for subscript
-* and superscript text formatting.
-*
-* Reference: http://officeopenxml.com/WPtextFormatting.php
-*
-* ## XSD Schema
-* ```xml
-* <xsd:complexType name="CT_VerticalAlignRun">
-*   <xsd:attribute name="val" type="ST_VerticalAlignRun" use="required"/>
-* </xsd:complexType>
-* <xsd:simpleType name="ST_VerticalAlignRun">
-*   <xsd:restriction base="xsd:string">
-*     <xsd:enumeration value="baseline"/>
-*     <xsd:enumeration value="superscript"/>
-*     <xsd:enumeration value="subscript"/>
-*   </xsd:restriction>
-* </xsd:simpleType>
-* ```
-*
-* @module
-*/
-/**
-* Creates a vertical alignment run element.
-* @internal
-*/
-const createVerticalAlignRun = (type) => new BuilderElement({
-	attributes: { val: {
-		key: "w:val",
-		value: type
-	} },
-	name: "w:vertAlign"
-});
-/**
-* Creates superscript text formatting.
-*
-* Raises text above the baseline, commonly used for exponents
-* and ordinal indicators.
-*/
-const createSuperScript = () => createVerticalAlignRun("superscript");
-/**
-* Creates subscript text formatting.
-*
-* Lowers text below the baseline, commonly used for chemical
-* formulas and footnote references.
-*/
-const createSubScript = () => createVerticalAlignRun("subscript");
-//#endregion
 //#region src/file/paragraph/run/underline.ts
 /**
 * Underline module for WordprocessingML documents.
@@ -2012,53 +1961,11 @@ var RunProperties = class extends IgnoreIfEmptyXmlComponent {
 	constructor(options) {
 		super("w:rPr");
 		if (!options) return;
-		if (options.style) this.push(new StringValueElement("w:rStyle", options.style));
-		if (options.font) if (typeof options.font === "string") this.push(createRunFonts(options.font));
-		else if ("name" in options.font) this.push(createRunFonts(options.font.name, options.font.hint));
-		else this.push(createRunFonts(options.font));
-		if (options.bold !== void 0) this.push(new OnOffElement("w:b", options.bold));
-		if (options.boldComplexScript === void 0 && options.bold !== void 0 || options.boldComplexScript) this.push(new OnOffElement("w:bCs", options.boldComplexScript ?? options.bold));
-		if (options.italics !== void 0) this.push(new OnOffElement("w:i", options.italics));
-		if (options.italicsComplexScript === void 0 && options.italics !== void 0 || options.italicsComplexScript) this.push(new OnOffElement("w:iCs", options.italicsComplexScript ?? options.italics));
-		if (options.smallCaps !== void 0) this.push(new OnOffElement("w:smallCaps", options.smallCaps));
-		else if (options.allCaps !== void 0) this.push(new OnOffElement("w:caps", options.allCaps));
-		if (options.strike !== void 0) this.push(new OnOffElement("w:strike", options.strike));
-		if (options.doubleStrike !== void 0) this.push(new OnOffElement("w:dstrike", options.doubleStrike));
-		if (options.emboss !== void 0) this.push(new OnOffElement("w:emboss", options.emboss));
-		if (options.imprint !== void 0) this.push(new OnOffElement("w:imprint", options.imprint));
-		if (options.outline !== void 0) this.push(new OnOffElement("w:outline", options.outline));
-		if (options.shadow !== void 0) this.push(new OnOffElement("w:shadow", options.shadow));
-		if (options.webHidden !== void 0) this.push(new OnOffElement("w:webHidden", options.webHidden));
-		if (options.noProof !== void 0) this.push(new OnOffElement("w:noProof", options.noProof));
-		if (options.snapToGrid !== void 0) this.push(new OnOffElement("w:snapToGrid", options.snapToGrid));
-		if (options.vanish) this.push(new OnOffElement("w:vanish", options.vanish));
-		if (options.color) this.push(new Color(options.color));
-		if (options.characterSpacing) this.push(new CharacterSpacing(options.characterSpacing));
-		if (options.scale !== void 0) this.push(new NumberValueElement("w:w", options.scale));
-		if (options.kern) this.push(new HpsMeasureElement("w:kern", options.kern));
-		if (options.position) this.push(new StringValueElement("w:position", options.position));
-		if (options.size !== void 0) this.push(new HpsMeasureElement("w:sz", options.size));
-		const szCs = options.sizeComplexScript === void 0 || options.sizeComplexScript === true ? options.size : options.sizeComplexScript;
-		if (szCs) this.push(new HpsMeasureElement("w:szCs", szCs));
-		if (options.highlight) this.push(new Highlight(options.highlight));
-		if (options.highlightComplexScript === true) {
-			if (options.highlight) this.push(new HighlightComplexScript(options.highlight));
-		} else if (options.highlightComplexScript !== void 0 && options.highlightComplexScript !== false) this.push(new HighlightComplexScript(options.highlightComplexScript));
-		if (options.underline) this.push(createUnderline(options.underline.type, options.underline.color));
-		if (options.effect) this.push(new StringValueElement("w:effect", options.effect));
-		if (options.border) this.push(createBorderElement("w:bdr", options.border));
-		if (options.shading) this.push(createShading(options.shading));
-		if (options.subScript) this.push(createSubScript());
-		if (options.superScript) this.push(createSuperScript());
-		if (options.rightToLeft !== void 0) this.push(new OnOffElement("w:rtl", options.rightToLeft));
-		if (options.emphasisMark) this.push(createEmphasisMark(options.emphasisMark.type));
-		if (options.language) this.push(createLanguageComponent(options.language));
-		if (options.specVanish) this.push(new OnOffElement("w:specVanish", options.specVanish));
-		if (options.math) this.push(new OnOffElement("w:oMath", options.math));
-		if (options.fitText !== void 0) this.push(new NumberValueElement("w:fitText", options.fitText));
-		if (options.complexScript !== void 0) this.push(new OnOffElement("w:cs", options.complexScript));
-		if (options.eastAsianLayout) this.push(createEastAsianLayout(options.eastAsianLayout));
-		if (options.revision) this.push(new RunPropertiesChange(options.revision));
+		const result = buildRunProperties(options);
+		if (result) {
+			const children = result["w:rPr"];
+			if (Array.isArray(children)) this.root.push(...children);
+		}
 	}
 	push(item) {
 		this.root.push(item);
@@ -15759,59 +15666,91 @@ var EndnotesWrapper = class {
 	}
 };
 //#endregion
-//#region src/file/footer/footer-attributes.ts
+//#region src/file/header-footer-base.ts
 /**
-* Component for managing XML namespace attributes on footer elements.
-*
-* This class handles the serialization of namespace declarations that are required
-* for proper XML validation and processing of footer content in WordprocessingML documents.
+* Shared base class for header and footer XML components.
 *
-* @example
-* ```typescript
-* new FooterAttributes({
-*   w: "http://schemas.openxmlformats.org/wordprocessingml/2006/main",
-*   r: "http://schemas.openxmlformats.org/officeDocument/2006/relationships"
-* });
-* ```
+* @module
 */
-var FooterAttributes = class extends XmlAttributeComponent {
-	xmlKeys = {
-		cp: "xmlns:cp",
-		dc: "xmlns:dc",
-		dcmitype: "xmlns:dcmitype",
-		dcterms: "xmlns:dcterms",
-		m: "xmlns:m",
-		mc: "xmlns:mc",
-		o: "xmlns:o",
-		r: "xmlns:r",
-		type: "xsi:type",
-		v: "xmlns:v",
-		w: "xmlns:w",
-		w10: "xmlns:w10",
-		w14: "xmlns:w14",
-		w15: "xmlns:w15",
-		wne: "xmlns:wne",
-		wp: "xmlns:wp",
-		wp14: "xmlns:wp14",
-		wpc: "xmlns:wpc",
-		wpg: "xmlns:wpg",
-		wpi: "xmlns:wpi",
-		wps: "xmlns:wps",
-		xsi: "xmlns:xsi"
-	};
+/**
+* Namespace keys used by header elements.
+* @internal
+*/
+const HEADER_NAMESPACES = [
+	"cx",
+	"cx1",
+	"cx2",
+	"cx3",
+	"cx4",
+	"cx5",
+	"cx6",
+	"cx7",
+	"cx8",
+	"m",
+	"mc",
+	"o",
+	"r",
+	"v",
+	"w",
+	"w10",
+	"w14",
+	"w15",
+	"w16cid",
+	"w16se",
+	"wne",
+	"wp",
+	"wp14",
+	"wpc",
+	"wpg",
+	"wpi",
+	"wps"
+];
+/**
+* Namespace keys used by footer elements.
+* @internal
+*/
+const FOOTER_NAMESPACES = [
+	"m",
+	"mc",
+	"o",
+	"r",
+	"v",
+	"w",
+	"w10",
+	"w14",
+	"w15",
+	"wne",
+	"wp",
+	"wp14",
+	"wpc",
+	"wpg",
+	"wpi",
+	"wps"
+];
+/**
+* Base class for header (w:hdr) and footer (w:ftr) XML components.
+*
+* Both share the same structure: namespace attributes, reference ID,
+* and block-level child elements. This base class eliminates the
+* duplication between Header and Footer internal implementations.
+*/
+var HeaderFooterBase = class extends InitializableXmlComponent {
+	refId;
+	constructor(tagName, referenceNumber, namespaces, initContent) {
+		super(tagName, initContent);
+		this.refId = referenceNumber;
+		if (!initContent) this.root.push(buildDocumentAttributes(namespaces));
+	}
+	get ReferenceId() {
+		return this.refId;
+	}
+	add(item) {
+		this.root.push(item);
+	}
 };
 //#endregion
 //#region src/file/footer/footer.ts
 /**
-* Footer module for WordprocessingML documents.
-*
-* Footers are repeated at the bottom of each page in a section.
-*
-* Reference: http://officeopenxml.com/WPfooters.php
-*
-* @module
-*/
-/**
 * Represents a footer in a WordprocessingML document.
 *
 * A footer is the portion of the document that appears at the bottom of each page in a section.
@@ -15849,35 +15788,9 @@ var FooterAttributes = class extends XmlAttributeComponent {
 * }));
 * ```
 */
-var Footer$1 = class extends InitializableXmlComponent {
-	refId;
+var Footer$1 = class extends HeaderFooterBase {
 	constructor(referenceNumber, initContent) {
-		super("w:ftr", initContent);
-		this.refId = referenceNumber;
-		if (!initContent) this.root.push(new FooterAttributes({
-			m: "http://schemas.openxmlformats.org/officeDocument/2006/math",
-			mc: "http://schemas.openxmlformats.org/markup-compatibility/2006",
-			o: "urn:schemas-microsoft-com:office:office",
-			r: "http://schemas.openxmlformats.org/officeDocument/2006/relationships",
-			v: "urn:schemas-microsoft-com:vml",
-			w: "http://schemas.openxmlformats.org/wordprocessingml/2006/main",
-			w10: "urn:schemas-microsoft-com:office:word",
-			w14: "http://schemas.microsoft.com/office/word/2010/wordml",
-			w15: "http://schemas.microsoft.com/office/word/2012/wordml",
-			wne: "http://schemas.microsoft.com/office/word/2006/wordml",
-			wp: "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing",
-			wp14: "http://schemas.microsoft.com/office/word/2010/wordprocessingDrawing",
-			wpc: "http://schemas.microsoft.com/office/word/2010/wordprocessingCanvas",
-			wpg: "http://schemas.microsoft.com/office/word/2010/wordprocessingGroup",
-			wpi: "http://schemas.microsoft.com/office/word/2010/wordprocessingInk",
-			wps: "http://schemas.microsoft.com/office/word/2010/wordprocessingShape"
-		}));
-	}
-	get ReferenceId() {
-		return this.refId;
-	}
-	add(item) {
-		this.root.push(item);
+		super("w:ftr", referenceNumber, FOOTER_NAMESPACES, initContent);
 	}
 };
 //#endregion
@@ -16251,70 +16164,8 @@ var FootnotesWrapper = class {
 	}
 };
 //#endregion
-//#region src/file/header/header-attributes.ts
-/**
-* Component for managing XML namespace attributes on header elements.
-*
-* This class handles the serialization of namespace declarations that are required
-* for proper XML validation and processing of header content in WordprocessingML documents.
-*
-* @example
-* ```typescript
-* new HeaderAttributes({
-*   w: "http://schemas.openxmlformats.org/wordprocessingml/2006/main",
-*   r: "http://schemas.openxmlformats.org/officeDocument/2006/relationships"
-* });
-* ```
-*/
-var HeaderAttributes = class extends XmlAttributeComponent {
-	xmlKeys = {
-		cp: "xmlns:cp",
-		cx: "xmlns:cx",
-		cx1: "xmlns:cx1",
-		cx2: "xmlns:cx2",
-		cx3: "xmlns:cx3",
-		cx4: "xmlns:cx4",
-		cx5: "xmlns:cx5",
-		cx6: "xmlns:cx6",
-		cx7: "xmlns:cx7",
-		cx8: "xmlns:cx8",
-		dc: "xmlns:dc",
-		dcmitype: "xmlns:dcmitype",
-		dcterms: "xmlns:dcterms",
-		m: "xmlns:m",
-		mc: "xmlns:mc",
-		o: "xmlns:o",
-		r: "xmlns:r",
-		type: "xsi:type",
-		v: "xmlns:v",
-		w: "xmlns:w",
-		w10: "xmlns:w10",
-		w14: "xmlns:w14",
-		w15: "xmlns:w15",
-		w16cid: "xmlns:w16cid",
-		w16se: "xmlns:w16se",
-		wne: "xmlns:wne",
-		wp: "xmlns:wp",
-		wp14: "xmlns:wp14",
-		wpc: "xmlns:wpc",
-		wpg: "xmlns:wpg",
-		wpi: "xmlns:wpi",
-		wps: "xmlns:wps",
-		xsi: "xmlns:xsi"
-	};
-};
-//#endregion
 //#region src/file/header/header.ts
 /**
-* Header module for WordprocessingML documents.
-*
-* Headers are repeated at the top of each page in a section.
-*
-* Reference: http://officeopenxml.com/WPheaders.php
-*
-* @module
-*/
-/**
 * Represents a header in a WordprocessingML document.
 *
 * A header is the portion of the document that appears at the top of each page in a section.
@@ -16349,46 +16200,9 @@ var HeaderAttributes = class extends XmlAttributeComponent {
 * }));
 * ```
 */
-var Header$1 = class extends InitializableXmlComponent {
-	refId;
+var Header$1 = class extends HeaderFooterBase {
 	constructor(referenceNumber, initContent) {
-		super("w:hdr", initContent);
-		this.refId = referenceNumber;
-		if (!initContent) this.root.push(new HeaderAttributes({
-			cx: "http://schemas.microsoft.com/office/drawing/2014/chartex",
-			cx1: "http://schemas.microsoft.com/office/drawing/2015/9/8/chartex",
-			cx2: "http://schemas.microsoft.com/office/drawing/2015/10/21/chartex",
-			cx3: "http://schemas.microsoft.com/office/drawing/2016/5/9/chartex",
-			cx4: "http://schemas.microsoft.com/office/drawing/2016/5/10/chartex",
-			cx5: "http://schemas.microsoft.com/office/drawing/2016/5/11/chartex",
-			cx6: "http://schemas.microsoft.com/office/drawing/2016/5/12/chartex",
-			cx7: "http://schemas.microsoft.com/office/drawing/2016/5/13/chartex",
-			cx8: "http://schemas.microsoft.com/office/drawing/2016/5/14/chartex",
-			m: "http://schemas.openxmlformats.org/officeDocument/2006/math",
-			mc: "http://schemas.openxmlformats.org/markup-compatibility/2006",
-			o: "urn:schemas-microsoft-com:office:office",
-			r: "http://schemas.openxmlformats.org/officeDocument/2006/relationships",
-			v: "urn:schemas-microsoft-com:vml",
-			w: "http://schemas.openxmlformats.org/wordprocessingml/2006/main",
-			w10: "urn:schemas-microsoft-com:office:word",
-			w14: "http://schemas.microsoft.com/office/word/2010/wordml",
-			w15: "http://schemas.microsoft.com/office/word/2012/wordml",
-			w16cid: "http://schemas.microsoft.com/office/word/2016/wordml/cid",
-			w16se: "http://schemas.microsoft.com/office/word/2015/wordml/symex",
-			wne: "http://schemas.microsoft.com/office/word/2006/wordml",
-			wp: "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing",
-			wp14: "http://schemas.microsoft.com/office/word/2010/wordprocessingDrawing",
-			wpc: "http://schemas.microsoft.com/office/word/2010/wordprocessingCanvas",
-			wpg: "http://schemas.microsoft.com/office/word/2010/wordprocessingGroup",
-			wpi: "http://schemas.microsoft.com/office/word/2010/wordprocessingInk",
-			wps: "http://schemas.microsoft.com/office/word/2010/wordprocessingShape"
-		}));
-	}
-	get ReferenceId() {
-		return this.refId;
-	}
-	add(item) {
-		this.root.push(item);
+		super("w:hdr", referenceNumber, HEADER_NAMESPACES, initContent);
 	}
 };
 //#endregion
@@ -24215,7 +24029,7 @@ var Compiler = class {
 				path: "docProps/app.xml"
 			},
 			Comments: {
-				data: replaceNumberingPlaceholders(commentMediaDatas.length > 0 ? replaceImagePlaceholders(commentXmlData, commentMediaDatas, commentRelationshipCount, "plain") : commentXmlData, file.Numbering.ConcreteNumbering),
+				data: replaceNumberingPlaceholders(commentMediaDatas.length > 0 ? replaceImagePlaceholders(commentXmlData, commentMediaDatas, commentRelationshipCount, "rId") : commentXmlData, file.Numbering.ConcreteNumbering),
 				path: "word/comments.xml"
 			},
 			CommentsRelationships: {
@@ -24279,11 +24093,11 @@ var Compiler = class {
 			},
 			Document: {
 				data: (() => {
-					let xmlData = documentMediaDatas.length > 0 ? replaceImagePlaceholders(documentXmlData, documentMediaDatas, documentRelationshipCount, "plain") : documentXmlData;
+					let xmlData = documentMediaDatas.length > 0 ? replaceImagePlaceholders(documentXmlData, documentMediaDatas, documentRelationshipCount, "rId") : documentXmlData;
 					if (hasPlaceholders(xmlData)) {
-						xmlData = replaceChartPlaceholders(xmlData, file.Charts.Array.map((c) => c.key), documentRelationshipCount, "plain");
+						xmlData = replaceChartPlaceholders(xmlData, file.Charts.Array.map((c) => c.key), documentRelationshipCount, "rId");
 						const smartArtDataOffset = documentRelationshipCount + documentMediaDatas.length + file.Charts.Array.length;
-						xmlData = replaceSmartArtPlaceholders(xmlData, file.SmartArts.Array.map((s) => s.key), smartArtDataOffset, "plain");
+						xmlData = replaceSmartArtPlaceholders(xmlData, file.SmartArts.Array.map((s) => s.key), smartArtDataOffset, "rId");
 					}
 					return replaceNumberingPlaceholders(xmlData, file.Numbering.ConcreteNumbering);
 				})(),
@@ -24353,7 +24167,7 @@ var Compiler = class {
 				path: "word/_rels/fontTable.xml.rels"
 			},
 			FootNotes: {
-				data: replaceNumberingPlaceholders(footnoteMediaDatas.length > 0 ? replaceImagePlaceholders(footnoteXmlData, footnoteMediaDatas, footnoteRelationshipCount, "plain") : footnoteXmlData, file.Numbering.ConcreteNumbering),
+				data: replaceNumberingPlaceholders(footnoteMediaDatas.length > 0 ? replaceImagePlaceholders(footnoteXmlData, footnoteMediaDatas, footnoteRelationshipCount, "rId") : footnoteXmlData, file.Numbering.ConcreteNumbering),
 				path: "word/footnotes.xml"
 			},
 			FootNotesRelationships: {
@@ -24404,7 +24218,7 @@ var Compiler = class {
 				const tempXmlData = footerFormattedViews.get(index);
 				const mediaDatas = hasPlaceholders(tempXmlData) ? getReferencedMedia(tempXmlData, file.Media.Array) : [];
 				return {
-					data: replaceNumberingPlaceholders(mediaDatas.length > 0 ? replaceImagePlaceholders(tempXmlData, mediaDatas, 0, "plain") : tempXmlData, file.Numbering.ConcreteNumbering),
+					data: replaceNumberingPlaceholders(mediaDatas.length > 0 ? replaceImagePlaceholders(tempXmlData, mediaDatas, 0, "rId") : tempXmlData, file.Numbering.ConcreteNumbering),
 					path: `word/footer${index + 1}.xml`
 				};
 			}),
@@ -24439,7 +24253,7 @@ var Compiler = class {
 				const tempXmlData = headerFormattedViews.get(index);
 				const mediaDatas = hasPlaceholders(tempXmlData) ? getReferencedMedia(tempXmlData, file.Media.Array) : [];
 				return {
-					data: replaceNumberingPlaceholders(mediaDatas.length > 0 ? replaceImagePlaceholders(tempXmlData, mediaDatas, 0, "plain") : tempXmlData, file.Numbering.ConcreteNumbering),
+					data: replaceNumberingPlaceholders(mediaDatas.length > 0 ? replaceImagePlaceholders(tempXmlData, mediaDatas, 0, "rId") : tempXmlData, file.Numbering.ConcreteNumbering),
 					path: `word/header${index + 1}.xml`
 				};
 			}),