docx 9.9.0 → 9.10.0

package/dist/index.umd.cjs

@@ -12789,7 +12789,7 @@ DOT: "dot" };
 		hash.sha512 = hash.sha.sha512;
 		hash.ripemd160 = hash.ripemd.ripemd160;
 	})))(), 1);
-	var urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
+	var urlAlphabet = "57X6y3wQZNzYjJB2L_10pxbackgroundhimselfUTF-8DEMOGRAPHICSVqvt4KW9";
 	//#endregion
 	//#region node_modules/nanoid/non-secure/index.js
 	var customAlphabet = (alphabet, defaultSize = 21) => {
@@ -14586,48 +14586,6 @@ DOT: "dot" };
 		}
 	};
 	//#endregion
-	//#region src/file/drawing/doc-properties/doc-properties-children.ts
-	/**
-	* Child elements for document properties.
-	*
-	* This module provides hyperlink elements that can be attached to
-	* drawing elements for interactive behavior.
-	*
-	* @module
-	*/
-	/**
-	* Creates a click hyperlink element for a drawing.
-	*
-	* This element defines what happens when a user clicks on a drawing element.
-	*
-	* ## XSD Schema
-	* ```xml
-	* <xsd:complexType name="CT_Hyperlink">
-	*   <xsd:group ref="EG_PContent" minOccurs="0" maxOccurs="unbounded"/>
-	*   <xsd:attribute name="tgtFrame" type="s:ST_String"/>
-	*   <xsd:attribute name="tooltip" type="s:ST_String"/>
-	*   <xsd:attribute name="docLocation" type="s:ST_String"/>
-	*   <xsd:attribute name="history" type="s:ST_OnOff"/>
-	*   <xsd:attribute name="anchor" type="s:ST_String"/>
-	*   <xsd:attribute ref="r:id"/>
-	* </xsd:complexType>
-	* ```
-	*
-	* @param linkId - The relationship ID for the hyperlink target
-	* @param hasXmlNs - Whether to include the XML namespace declaration
-	* @returns An XML component representing the click hyperlink
-	*/
-	var createHyperlinkClick = (linkId, hasXmlNs) => new BuilderElement({
-		name: "a:hlinkClick",
-		attributes: _objectSpread2(_objectSpread2({}, hasXmlNs ? { xmlns: {
-			key: "xmlns:a",
-			value: "http://schemas.openxmlformats.org/drawingml/2006/main"
-		} } : {}), {}, { id: {
-			key: "r:id",
-			value: `rId${linkId}`
-		} })
-	});
-	//#endregion
 	//#region src/file/drawing/inline/graphic/graphic-data/pic/non-visual-pic-properties/non-visual-properties/non-visual-properties-attributes.ts
 	/**
 	* Non-visual properties attributes module.
@@ -14708,7 +14666,7 @@ DOT: "dot" };
 			for (let i = context.stack.length - 1; i >= 0; i--) {
 				const element = context.stack[i];
 				if (!(element instanceof ConcreteHyperlink)) continue;
-				this.root.push(createHyperlinkClick(element.linkId, false));
+				this.root.push(element.createDrawingClick(context, false));
 				break;
 			}
 			const result = super.prepForXml(context);
@@ -15378,6 +15336,48 @@ EXTERNAL: "External" };
 		}
 	});
 	//#endregion
+	//#region src/file/drawing/doc-properties/doc-properties-children.ts
+	/**
+	* Child elements for document properties.
+	*
+	* This module provides hyperlink elements that can be attached to
+	* drawing elements for interactive behavior.
+	*
+	* @module
+	*/
+	/**
+	* Creates a click hyperlink element for a drawing.
+	*
+	* This element defines what happens when a user clicks on a drawing element.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_Hyperlink">
+	*   <xsd:group ref="EG_PContent" minOccurs="0" maxOccurs="unbounded"/>
+	*   <xsd:attribute name="tgtFrame" type="s:ST_String"/>
+	*   <xsd:attribute name="tooltip" type="s:ST_String"/>
+	*   <xsd:attribute name="docLocation" type="s:ST_String"/>
+	*   <xsd:attribute name="history" type="s:ST_OnOff"/>
+	*   <xsd:attribute name="anchor" type="s:ST_String"/>
+	*   <xsd:attribute ref="r:id"/>
+	* </xsd:complexType>
+	* ```
+	*
+	* @param linkId - The relationship ID for the hyperlink target
+	* @param hasXmlNs - Whether to include the XML namespace declaration
+	* @returns An XML component representing the click hyperlink
+	*/
+	var createHyperlinkClick = (linkId, hasXmlNs) => new BuilderElement({
+		name: "a:hlinkClick",
+		attributes: _objectSpread2(_objectSpread2({}, hasXmlNs ? { xmlns: {
+			key: "xmlns:a",
+			value: "http://schemas.openxmlformats.org/drawingml/2006/main"
+		} } : {}), {}, { id: {
+			key: "r:id",
+			value: `rId${linkId}`
+		} })
+	});
+	//#endregion
 	//#region src/file/drawing/doc-properties/non-visual-drawing-properties.ts
 	/**
 	* Non-visual drawing properties (`CT_NonVisualDrawingProps`) of the shapes, pictures and groups inside a drawing:
@@ -15572,7 +15572,7 @@ EXTERNAL: "External" };
 			} else for (let i = context.stack.length - 1; i >= 0; i--) {
 				const element = context.stack[i];
 				if (!(element instanceof ConcreteHyperlink)) continue;
-				this.root.push(createHyperlinkClick(element.linkId, true));
+				this.root.push(element.createDrawingClick(context, true));
 				break;
 			}
 			if (this.decorative) this.root.push(createDecorativeExtensionList(true));
@@ -18960,20 +18960,44 @@ MAX: 9026 };
 	* ```
 	*/
 	var ConcreteHyperlink = class extends XmlComponent {
-		constructor(children, relationshipId, anchor) {
+		/**
+		* @param children - Inline content of the hyperlink
+		* @param relationshipId - Id of the external relationship, without the rId prefix
+		* @param anchor - Bookmark name or external URL fragment
+		* @param externalLink - The full address of an external hyperlink, so the relationship id is kept alongside its anchor
+		*/
+		constructor(children, relationshipId, anchor, externalLink) {
 			super("w:hyperlink");
 			_defineProperty(this, "linkId", void 0);
+			_defineProperty(this, "drawingLink", void 0);
 			this.linkId = relationshipId;
+			this.drawingLink = anchor && externalLink !== void 0 ? new DrawingLink(externalLink) : void 0;
 			const attributes = new HyperlinkAttributes({
 				history: 1,
 				anchor: anchor ? anchor : void 0,
-				id: !anchor ? `rId${this.linkId}` : void 0
+				id: !anchor || externalLink !== void 0 ? `rId${this.linkId}` : void 0
 			});
 			this.root.push(attributes);
 			children.forEach((child) => {
 				this.root.push(child);
 			});
 		}
+		/**
+		* Creates the `a:hlinkClick` of a picture in the hyperlink, which links to the same address.
+		*
+		* The hyperlink decides which relationship its pictures use, rather than the pictures reading `linkId`, because only it
+		* knows whether that relationship has lost the fragment to `w:anchor`. The picture's relationship is added as the
+		* picture is written, through the context's relationships, so it lands in the part the picture is in, both when
+		* packing and when patching.
+		*
+		* @param context - The context the picture is written in, whose relationships get the picture's link if it has its own
+		* @param declareNamespace - Declares the DrawingML namespace, for elements outside `a:graphic` such as `wp:docPr`
+		*/
+		createDrawingClick(context, declareNamespace) {
+			if (!this.drawingLink) return createHyperlinkClick(this.linkId, declareNamespace);
+			this.drawingLink.addRelationship(context);
+			return this.drawingLink.createClick(declareNamespace);
+		}
 	};
 	/**
 	* Represents an internal hyperlink to a bookmark within the document.
@@ -19022,6 +19046,11 @@ MAX: 9026 };
 	* External hyperlinks create a relationship to an external resource (URL).
 	* The relationship is created during document preparation and the hyperlink
 	* is converted to a ConcreteHyperlink with the relationship ID.
+	* URL fragments of at most 255 UTF-16 units are written as anchors, preserving any additional # characters.
+	* Longer fragments stay in the original relationship URI to avoid exceeding Word's anchor limit;
+	* those links retain the existing limitations for fragments with multiple # characters.
+	* Word appends the anchor to the relationship target as described in MS-OI29500 §17.16.22:
+	* https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oi29500/df06e423-11a6-4a36-bfb3-82139e531781
 	*
 	* Reference: http://officeopenxml.com/WPhyperlink.php
 	*
@@ -19035,6 +19064,7 @@ MAX: 9026 };
 	*   <xsd:group ref="EG_PContent" minOccurs="0" maxOccurs="unbounded"/>
 	*   <xsd:attribute ref="r:id"/>
 	*   <xsd:attribute name="history" type="s:ST_OnOff" use="optional"/>
+	*   <xsd:attribute name="anchor" type="s:ST_String" use="optional"/>
 	* </xsd:complexType>
 	* ```
 	*
@@ -19483,6 +19513,29 @@ MAX: 9026 };
 		}
 	};
 	//#endregion
+	//#region src/file/paragraph/links/external-hyperlink-target.ts
+	/**
+	* External hyperlink targets and fragments for WordprocessingML.
+	*
+	* Word appends the anchor to the relationship target, separated by a # character.
+	* Reference: https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oi29500/df06e423-11a6-4a36-bfb3-82139e531781
+	*
+	* @module
+	*/
+	var MAX_ANCHOR_LENGTH = 255;
+	/**
+	* Splits a nonempty fragment that fits Word's anchor limit without decoding or normalizing either part.
+	* Longer fragments stay in the original relationship URI, retaining its existing multi-hash limitations.
+	*/
+	var externalHyperlinkTarget = (link) => {
+		const index = link.indexOf("#");
+		const fragmentLength = link.length - index - 1;
+		return index > 0 && fragmentLength > 0 && fragmentLength <= MAX_ANCHOR_LENGTH ? {
+			target: link.slice(0, index),
+			anchor: link.slice(index + 1)
+		} : { target: link };
+	};
+	//#endregion
 	//#region src/file/fonts/font.ts
 	/**
 	* Font module for WordprocessingML documents.
@@ -19621,32 +19674,26 @@ MAX: 9026 };
 		]
 	});
 	//#endregion
-	//#region src/file/fonts/create-regular-font.ts
+	//#region src/file/fonts/create-embedded-font.ts
 	/**
-	* Creates a regular embedded font with default settings.
+	* Creates an embedded font with default settings.
 	*
 	* This helper function creates a font definition with standard font signature
 	* values that work for most common fonts. The signature specifies Unicode
 	* and code page ranges supported by the font.
 	*
-	* @param options - Font creation options
-	* @param options.name - Font name
-	* @param options.index - Font relationship index
-	* @param options.fontKey - Unique font key (GUID) for obfuscation
-	* @param options.characterSet - Optional character set identifier
-	*
 	* @returns XmlComponent representing the font definition
 	*
 	* @example
 	* ```typescript
-	* const font = createRegularFont({
+	* const font = createEmbeddedFont({
 	*   name: "Arial",
-	*   index: 1,
-	*   fontKey: "12345678-1234-1234-1234-123456789012"
+	*   embedRegular: { id: "rId1", fontKey: "12345678-1234-1234-1234-123456789012" },
+	*   embedBold: { id: "rId2", fontKey: "12345678-1234-1234-1234-123456789013" },
 	* });
 	* ```
 	*/
-	var createRegularFont = ({ name, index, fontKey, characterSet }) => createFont({
+	var createEmbeddedFont = ({ name, characterSet, embedRegular, embedBold, embedItalic, embedBoldItalic }) => createFont({
 		name,
 		sig: {
 			usb0: "E0002AFF",
@@ -19659,10 +19706,10 @@ MAX: 9026 };
 		charset: characterSet,
 		family: "auto",
 		pitch: "variable",
-		embedRegular: {
-			fontKey,
-			id: `rId${index}`
-		}
+		embedRegular,
+		embedBold,
+		embedItalic,
+		embedBoldItalic
 	});
 	//#endregion
 	//#region src/file/fonts/font-table.ts
@@ -19740,25 +19787,47 @@ MAX: 9026 };
 				value: "w14 w15 w16se w16cid w16 w16cex w16sdtdh"
 			}
 		},
-		children: fonts.map((font, i) => createRegularFont({
-			name: font.name,
-			index: i + 1,
-			fontKey: font.fontKey,
-			characterSet: font.characterSet
-		}))
+		children: fonts.map(createEmbeddedFont)
 	});
 	//#endregion
 	//#region src/file/fonts/font-wrapper.ts
+	var FACES = [
+		{
+			option: "data",
+			element: "embedRegular",
+			bold: false,
+			italic: false
+		},
+		{
+			option: "bold",
+			element: "embedBold",
+			bold: true,
+			italic: false
+		},
+		{
+			option: "italic",
+			element: "embedItalic",
+			bold: false,
+			italic: true
+		},
+		{
+			option: "boldItalic",
+			element: "embedBoldItalic",
+			bold: true,
+			italic: true
+		}
+	];
 	/**
 	* Wrapper class for managing the font table and its relationships.
 	*
 	* Creates a font table with embedded font files and manages the relationships
-	* required for font embedding. Each font is assigned a unique key for obfuscation.
+	* required for font embedding. Each face of a font is embedded as a file of its own,
+	* with a unique key for obfuscation.
 	*
 	* @example
 	* ```typescript
 	* const fontWrapper = new FontWrapper([
-	*   { name: "CustomFont", data: fontBuffer }
+	*   { name: "CustomFont", data: fontBuffer, bold: boldFontBuffer }
 	* ]);
 	* ```
 	*/
@@ -19767,12 +19836,43 @@ MAX: 9026 };
 			_defineProperty(this, "options", void 0);
 			_defineProperty(this, "fontTable", void 0);
 			_defineProperty(this, "relationships", void 0);
-			_defineProperty(this, "fontOptionsWithKey", []);
+			_defineProperty(
+				this,
+				/** @deprecated Use `files`, which has the file and key of each face a font embeds, not only the regular face's key */
+				"fontOptionsWithKey",
+				[]
+			);
+			_defineProperty(
+				this,
+				/** The files of the faces the fonts embed, in order: the Nth is `fonts/font<N>.odttf`, with the relationship `rId<N>` */
+				"files",
+				[]
+			);
 			this.options = options;
-			this.fontOptionsWithKey = options.map((o) => _objectSpread2(_objectSpread2({}, o), {}, { fontKey: uniqueUuid() }));
-			this.fontTable = createFontTable(this.fontOptionsWithKey);
+			const faces = options.map((font) => FACES.flatMap(({ option, element, bold, italic }) => {
+				const data = font[option];
+				return data ? [{
+					element,
+					file: {
+						name: font.name,
+						data,
+						bold,
+						italic,
+						fontKey: uniqueUuid()
+					}
+				}] : [];
+			}));
+			this.files = faces.flatMap((ofFont) => ofFont.map(({ file }) => file));
+			this.fontOptionsWithKey = options.map((font, index) => _objectSpread2(_objectSpread2({}, font), {}, { fontKey: faces[index][0].file.fontKey }));
+			this.fontTable = createFontTable(options.map((font, index) => _objectSpread2({
+				name: font.name,
+				characterSet: font.characterSet
+			}, Object.fromEntries(faces[index].map(({ element, file }) => [element, {
+				id: `rId${this.files.indexOf(file) + 1}`,
+				fontKey: file.fontKey
+			}])))));
 			this.relationships = new Relationships();
-			for (let i = 0; i < options.length; i++) this.relationships.addRelationship(i + 1, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/font", `fonts/font${i + 1}.odttf`);
+			for (let i = 0; i < this.files.length; i++) this.relationships.addRelationship(i + 1, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/font", `fonts/font${i + 1}.odttf`);
 		}
 		get View() {
 			return this.fontTable;
@@ -20295,8 +20395,9 @@ MAX: 9026 };
 		prepForXml(context) {
 			for (const element of this.root) if (element instanceof ExternalHyperlink) {
 				const index = this.root.indexOf(element);
-				const concreteHyperlink = new ConcreteHyperlink(element.options.children, uniqueId());
-				context.viewWrapper.Relationships.addRelationship(concreteHyperlink.linkId, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink", element.options.link, TargetModeType.EXTERNAL);
+				const { target, anchor } = externalHyperlinkTarget(element.options.link);
+				const concreteHyperlink = new ConcreteHyperlink(element.options.children, uniqueId(), anchor, element.options.link);
+				context.viewWrapper.Relationships.addRelationship(concreteHyperlink.linkId, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink", target, TargetModeType.EXTERNAL);
 				this.root[index] = concreteHyperlink;
 			}
 			return super.prepForXml(context);
@@ -35471,7 +35572,7 @@ while (n === a[++i] && n === a[++i] && n === a[++i] && n === a[++i] && n === a[+
 				zip.file(`word/media/${data.fileName}`, data.data);
 				zip.file(`word/media/${data.fallback.fileName}`, data.fallback.data);
 			}
-			for (const [i, { data: buffer, fontKey }] of file.FontTable.fontOptionsWithKey.entries()) zip.file(`word/fonts/font${i + 1}.odttf`, obfuscate(buffer, fontKey));
+			for (const [i, { data: buffer, fontKey }] of file.FontTable.files.entries()) zip.file(`word/fonts/font${i + 1}.odttf`, obfuscate(buffer, fontKey));
 			return zip;
 		}
 		xmlifyFile(file, prettify) {
@@ -37766,12 +37867,13 @@ while (n === a[++i] && n === a[++i] && n === a[++i] && n === a[++i] && n === a[+
 						json: element,
 						patch: _objectSpread2(_objectSpread2({}, patchValue), {}, { children: patchValue.children.flatMap((child) => child instanceof Bookmark ? child.writtenAs : [child]).map((child) => {
 							if (child instanceof ExternalHyperlink) {
-								const concreteHyperlink = new ConcreteHyperlink(child.options.children, uniqueId());
+								const { target, anchor } = externalHyperlinkTarget(child.options.link);
+								const concreteHyperlink = new ConcreteHyperlink(child.options.children, uniqueId(), anchor, child.options.link);
 								hyperlinkRelationships.push({
 									key,
 									id: concreteHyperlink.linkId,
 									type: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink",
-									target: child.options.link,
+									target,
 									targetMode: TargetModeType.EXTERNAL
 								});
 								return concreteHyperlink;

package/dist/layout.cjs

@@ -45182,12 +45182,7 @@ var partsOfFile = (context) => {
 		headersAndFooters: new Map([...file.Headers, ...file.Footers].map((wrapper) => [`rId${wrapper.View.ReferenceId}`, Object.values(format(wrapper))[0]])),
 		footnotes: format(file.FootNotes),
 		endnotes: format(file.Endnotes),
-		fonts: facesOf(file.FontTable.options.map(({ name, data }) => ({
-			name,
-			data,
-			bold: false,
-			italic: false
-		})))
+		fonts: facesOf(file.FontTable.files)
 	};
 };
 /**

package/dist/layout.iife.js

@@ -45183,12 +45183,7 @@ var docxLayout = (function(exports) {
 			headersAndFooters: new Map([...file.Headers, ...file.Footers].map((wrapper) => [`rId${wrapper.View.ReferenceId}`, Object.values(format(wrapper))[0]])),
 			footnotes: format(file.FootNotes),
 			endnotes: format(file.Endnotes),
-			fonts: facesOf(file.FontTable.options.map(({ name, data }) => ({
-				name,
-				data,
-				bold: false,
-				italic: false
-			})))
+			fonts: facesOf(file.FontTable.files)
 		};
 	};
 	/**

package/dist/layout.mjs

@@ -45181,12 +45181,7 @@ var partsOfFile = (context) => {
 		headersAndFooters: new Map([...file.Headers, ...file.Footers].map((wrapper) => [`rId${wrapper.View.ReferenceId}`, Object.values(format(wrapper))[0]])),
 		footnotes: format(file.FootNotes),
 		endnotes: format(file.Endnotes),
-		fonts: facesOf(file.FontTable.options.map(({ name, data }) => ({
-			name,
-			data,
-			bold: false,
-			italic: false
-		})))
+		fonts: facesOf(file.FontTable.files)
 	};
 };
 /**

package/dist/layout.umd.cjs

@@ -45185,12 +45185,7 @@
 			headersAndFooters: new Map([...file.Headers, ...file.Footers].map((wrapper) => [`rId${wrapper.View.ReferenceId}`, Object.values(format(wrapper))[0]])),
 			footnotes: format(file.FootNotes),
 			endnotes: format(file.Endnotes),
-			fonts: facesOf(file.FontTable.options.map(({ name, data }) => ({
-				name,
-				data,
-				bold: false,
-				italic: false
-			})))
+			fonts: facesOf(file.FontTable.files)
 		};
 	};
 	/**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "docx",
-    "version": "9.9.0",
+    "version": "9.10.0",
     "description": "Easily generate .docx files with JS/TS with a nice declarative API. Works for Node and on the Browser.",
     "type": "module",
     "main": "dist/index.umd.cjs",
@@ -150,6 +150,7 @@
         "@types/xml": "^1.0.8",
         "@typescript-eslint/eslint-plugin": "^8.8.1",
         "@typescript-eslint/parser": "^8.8.1",
+        "@typescript/native": "npm:typescript@7.0.2",
         "@vitest/coverage-v8": "^5.0.2",
         "@vitest/ui": "^5.0.2",
         "cspell": "^10.0.0",
@@ -168,14 +169,14 @@
         "inquirer": "^14.0.0",
         "jiti": "^2.3.3",
         "jsdom": "^30.1.0",
-        "pixelmatch": "^7.2.0",
+        "pixelmatch": "^8.0.0",
         "pngjs": "^7.0.0",
         "pre-commit": "^2.0.0",
         "prettier": "^3.1.1",
         "tsconfig-paths": "^4.0.0",
         "tsx": "^4.7.0",
         "typedoc": "^0.28.2",
-        "typescript": "5.9.3",
+        "typescript": "npm:@typescript/typescript6@6.0.2",
         "typescript-eslint": "^8.10.0",
         "unzipper": "^0.12.3",
         "vite": "^8.0.0",