docx-plus 0.0.13 → 0.1.0

package/dist/index.umd.js

@@ -8926,8 +8926,8 @@
 		} },
 		children: [(() => {
 			if (align) return createAlign(align);
-			else if (offset !== void 0) return createPositionOffset(offset);
-			else throw new Error("There is no configuration provided for floating position (Align or offset)");
+			if (offset !== void 0) return createPositionOffset(offset);
+			return createAlign(HorizontalPositionAlign.LEFT);
 		})()],
 		name: "wp:positionH"
 	});
@@ -8987,8 +8987,8 @@
 		} },
 		children: [(() => {
 			if (align) return createAlign(align);
-			else if (offset !== void 0) return createPositionOffset(offset);
-			else throw new Error("There is no configuration provided for floating position (Align or offset)");
+			if (offset !== void 0) return createPositionOffset(offset);
+			return createAlign(VerticalPositionAlign.TOP);
 		})()],
 		name: "wp:positionV"
 	});
@@ -9702,6 +9702,44 @@
 		name: "a:solidFill"
 	});
 	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/effects/fill-overlay.ts
+	/**
+	* Fill overlay effect for DrawingML shapes.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_FillOverlayEffect
+	*
+	* @module
+	*/
+	/**
+	* Creates a fill overlay effect element.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_FillOverlayEffect">
+	*   <xsd:sequence>
+	*     <xsd:group ref="EG_FillProperties" minOccurs="1" maxOccurs="1"/>
+	*   </xsd:sequence>
+	*   <xsd:attribute name="blend" type="ST_BlendMode" use="required"/>
+	* </xsd:complexType>
+	* ```
+	*
+	* @example
+	* ```typescript
+	* const fillOverlay = createFillOverlayEffect({
+	*   blend: BlendMode.MULTIPLY,
+	*   color: { value: "FF0000" },
+	* });
+	* ```
+	*/
+	const createFillOverlayEffect = (options) => new BuilderElement({
+		attributes: { blend: {
+			key: "blend",
+			value: options.blend
+		} },
+		children: [createSolidFill(options.color)],
+		name: "a:fillOverlay"
+	});
+	//#endregion
 	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/effects/glow.ts
 	/**
 	* Glow effect for DrawingML shapes.
@@ -9738,7 +9776,7 @@
 		});
 	};
 	//#endregion
-	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/effects/inner-shdw.ts
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/effects/inner-shadow.ts
 	/**
 	* Inner shadow effect for DrawingML shapes.
 	*
@@ -9786,7 +9824,7 @@
 		});
 	};
 	//#endregion
-	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/effects/outer-shdw.ts
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/effects/outer-shadow.ts
 	/**
 	* Outer shadow effect for DrawingML shapes.
 	*
@@ -9874,7 +9912,7 @@
 		});
 	};
 	//#endregion
-	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/effects/prst-shdw.ts
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/effects/preset-shadow.ts
 	/**
 	* Preset shadow effect for DrawingML shapes.
 	*
@@ -10128,10 +10166,11 @@
 	const createEffectList = (options) => {
 		const children = [];
 		if (options.blur) children.push(createBlurEffect(options.blur));
+		if (options.fillOverlay) children.push(createFillOverlayEffect(options.fillOverlay));
 		if (options.glow) children.push(createGlowEffect(options.glow));
-		if (options.innerShdw) children.push(createInnerShadowEffect(options.innerShdw));
-		if (options.outerShdw) children.push(createOuterShadowEffect(options.outerShdw));
-		if (options.prstShdw) children.push(createPresetShadowEffect(options.prstShdw));
+		if (options.innerShadow) children.push(createInnerShadowEffect(options.innerShadow));
+		if (options.outerShadow) children.push(createOuterShadowEffect(options.outerShadow));
+		if (options.presetShadow) children.push(createPresetShadowEffect(options.presetShadow));
 		if (options.reflection) children.push(createReflectionEffect(options.reflection === true ? void 0 : options.reflection));
 		if (options.softEdge !== void 0) children.push(createSoftEdgeEffect(options.softEdge));
 		return new BuilderElement({
@@ -10567,10 +10606,13 @@
 	};
 	/**
 	* Creates the fill child element for an outline.
+	*
+	* Returns null when no fill type is specified (OOXML allows outline without fill).
 	*/
 	const createOutlineFill = (options) => {
 		if (options.type === "noFill") return createNoFill();
-		return createSolidFill(options.color);
+		if (options.type === "solidFill" && options.color) return createSolidFill(options.color);
+		return null;
 	};
 	/**
 	* Creates an outline element for DrawingML shapes.
@@ -10606,7 +10648,8 @@
 	*/
 	const createOutline = (options) => {
 		const children = [];
-		children.push(createOutlineFill(options));
+		const fill = createOutlineFill(options);
+		if (fill) children.push(fill);
 		if (options.dash !== void 0) children.push(new BuilderElement({
 			attributes: { val: {
 				key: "val",
@@ -10918,12 +10961,12 @@
 		const children = [];
 		if (options.bevelT) children.push(createBevel(options.bevelT));
 		if (options.bevelB) children.push(createBottomBevel(options.bevelB));
-		if (options.extrusionClr) children.push(new BuilderElement({
-			children: [createColorElement(options.extrusionClr)],
+		if (options.extrusionColor) children.push(new BuilderElement({
+			children: [createColorElement(options.extrusionColor)],
 			name: "a:extrusionClr"
 		}));
-		if (options.contourClr) children.push(new BuilderElement({
-			children: [createColorElement(options.contourClr)],
+		if (options.contourColor) children.push(new BuilderElement({
+			children: [createColorElement(options.contourColor)],
 			name: "a:contourClr"
 		}));
 		return new BuilderElement({
@@ -10997,7 +11040,6 @@
 			if (noFill) this.root.push(createNoFill());
 			else if (solidFill) this.root.push(createSolidFill(solidFill));
 			else if (gradientFill) this.root.push(createGradientFill(gradientFill));
-			else if (outline) this.root.push(createNoFill());
 			if (outline) this.root.push(createOutline(outline));
 			if (effects) this.root.push(createEffectList(effects));
 			if (shape3d) this.root.push(createShape3D(shape3d));
@@ -11110,6 +11152,158 @@
 		}
 	};
 	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/blip/blip-effects.ts
+	/**
+	* Blip image adjustment effects for DrawingML.
+	*
+	* These effects are applied directly to the image data within the `<a:blip>` element,
+	* corresponding to Word's "Picture Format > Adjust" features (brightness, contrast,
+	* grayscale, tint, duotone, etc.).
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_Blip children
+	*
+	* @module
+	*/
+	/**
+	* Creates blip effect elements from BlipEffectsOptions.
+	*
+	* @returns Array of XML components representing blip effects
+	*/
+	const createBlipEffects = (options) => {
+		const children = [];
+		if (options.grayscale) children.push(new BuilderElement({ name: "a:grayscl" }));
+		if (options.luminance) {
+			const attrs = {};
+			if (options.luminance.bright !== void 0) attrs.bright = {
+				key: "bright",
+				value: `${options.luminance.bright}%`
+			};
+			if (options.luminance.contrast !== void 0) attrs.contrast = {
+				key: "contrast",
+				value: `${options.luminance.contrast}%`
+			};
+			children.push(new BuilderElement({
+				attributes: attrs,
+				name: "a:lum"
+			}));
+		}
+		if (options.hsl) {
+			const attrs = {};
+			if (options.hsl.hue !== void 0) attrs.hue = {
+				key: "hue",
+				value: String(options.hsl.hue)
+			};
+			if (options.hsl.sat !== void 0) attrs.sat = {
+				key: "sat",
+				value: `${options.hsl.sat}%`
+			};
+			if (options.hsl.lum !== void 0) attrs.lum = {
+				key: "lum",
+				value: `${options.hsl.lum}%`
+			};
+			children.push(new BuilderElement({
+				attributes: attrs,
+				name: "a:hsl"
+			}));
+		}
+		if (options.tint) {
+			const attrs = {};
+			if (options.tint.hue !== void 0) attrs.hue = {
+				key: "hue",
+				value: String(options.tint.hue)
+			};
+			if (options.tint.amt !== void 0) attrs.amt = {
+				key: "amt",
+				value: `${options.tint.amt}%`
+			};
+			children.push(new BuilderElement({
+				attributes: attrs,
+				name: "a:tint"
+			}));
+		}
+		if (options.duotone) children.push(new BuilderElement({
+			children: [createColorElement(options.duotone.color1), createColorElement(options.duotone.color2)],
+			name: "a:duotone"
+		}));
+		if (options.biLevel) children.push(new BuilderElement({
+			attributes: { thresh: {
+				key: "thresh",
+				value: `${options.biLevel.thresh}%`
+			} },
+			name: "a:biLevel"
+		}));
+		if (options.alphaCeiling) children.push(new BuilderElement({ name: "a:alphaCeiling" }));
+		if (options.alphaFloor) children.push(new BuilderElement({ name: "a:alphaFloor" }));
+		if (options.alphaInverse !== void 0) if (typeof options.alphaInverse === "boolean") children.push(new BuilderElement({ name: "a:alphaInv" }));
+		else children.push(new BuilderElement({
+			children: [createColorElement(options.alphaInverse)],
+			name: "a:alphaInv"
+		}));
+		if (options.alphaModFix) {
+			var _options$alphaModFix$;
+			const amt = (_options$alphaModFix$ = options.alphaModFix.amount) !== null && _options$alphaModFix$ !== void 0 ? _options$alphaModFix$ : 100;
+			children.push(new BuilderElement({
+				attributes: { amt: {
+					key: "amt",
+					value: `${amt}%`
+				} },
+				name: "a:alphaModFix"
+			}));
+		}
+		if (options.alphaRepl) children.push(new BuilderElement({
+			attributes: { a: {
+				key: "a",
+				value: `${options.alphaRepl.amount}%`
+			} },
+			name: "a:alphaRepl"
+		}));
+		if (options.alphaBiLevel) children.push(new BuilderElement({
+			attributes: { thresh: {
+				key: "thresh",
+				value: `${options.alphaBiLevel.thresh}%`
+			} },
+			name: "a:alphaBiLevel"
+		}));
+		if (options.colorChange) {
+			const attrs = {};
+			if (options.colorChange.useAlpha === false) attrs.useA = {
+				key: "useA",
+				value: "0"
+			};
+			children.push(new BuilderElement({
+				attributes: attrs,
+				children: [new BuilderElement({
+					children: [createColorElement(options.colorChange.from)],
+					name: "a:clrFrom"
+				}), new BuilderElement({
+					children: [createColorElement(options.colorChange.to)],
+					name: "a:clrTo"
+				})],
+				name: "a:clrChange"
+			}));
+		}
+		if (options.colorRepl) children.push(new BuilderElement({
+			children: [createColorElement(options.colorRepl.color)],
+			name: "a:clrRepl"
+		}));
+		if (options.blur) {
+			const attrs = {};
+			if (options.blur.rad !== void 0) attrs.rad = {
+				key: "rad",
+				value: options.blur.rad
+			};
+			if (options.blur.grow === false) attrs.grow = {
+				key: "grow",
+				value: 0
+			};
+			children.push(new BuilderElement({
+				attributes: attrs,
+				name: "a:blur"
+			}));
+		}
+		return children;
+	};
+	//#endregion
 	//#region src/file/drawing/inline/graphic/graphic-data/pic/blip/blip-extentions.ts
 	/**
 	* Creates an SVG blip element for embedding SVG images.
@@ -11219,20 +11413,25 @@
 	* @param mediaData - The media data containing the image information
 	* @returns An XML component representing the blip element
 	*/
-	const createBlip = (mediaData) => new BuilderElement({
-		attributes: {
-			cstate: {
-				key: "cstate",
-				value: "none"
+	const createBlip = (mediaData, blipEffects) => {
+		const children = [];
+		if (blipEffects) children.push(...createBlipEffects(blipEffects));
+		if (mediaData.type === "svg") children.push(createExtentionList(mediaData));
+		return new BuilderElement({
+			attributes: {
+				cstate: {
+					key: "cstate",
+					value: "none"
+				},
+				embed: {
+					key: "r:embed",
+					value: `rId{${mediaData.type === "svg" ? mediaData.fallback.fileName : mediaData.fileName}}`
+				}
 			},
-			embed: {
-				key: "r:embed",
-				value: `rId{${mediaData.type === "svg" ? mediaData.fallback.fileName : mediaData.fileName}}`
-			}
-		},
-		children: mediaData.type === "svg" ? [createExtentionList(mediaData)] : [],
-		name: "a:blip"
-	});
+			children,
+			name: "a:blip"
+		});
+	};
 	//#endregion
 	//#region src/file/drawing/inline/graphic/graphic-data/pic/blip/source-rectangle.ts
 	/**
@@ -11356,6 +11555,106 @@
 		}
 	};
 	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/blip/tile.ts
+	/**
+	* Tile fill module for blip fills.
+	*
+	* This module defines how images are tiled (repeated) to fill shapes.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_TileInfoProperties
+	*
+	* @module
+	*/
+	/**
+	* Tile flip mode for tiling images.
+	*
+	* Specifies whether the image is flipped along the x-axis, y-axis,
+	* both axes, or not at all when tiling.
+	*/
+	const TileFlipMode = {
+		NONE: "none",
+		X: "x",
+		Y: "y",
+		XY: "xy"
+	};
+	/**
+	* Tile alignment within the shape.
+	*
+	* Specifies the anchor position of the first tile relative to the shape.
+	*/
+	const TileAlignment = {
+		TOP_LEFT: "tl",
+		TOP: "t",
+		TOP_RIGHT: "tr",
+		LEFT: "l",
+		CENTER: "ctr",
+		RIGHT: "r",
+		BOTTOM_LEFT: "bl",
+		BOTTOM: "b",
+		BOTTOM_RIGHT: "br"
+	};
+	/**
+	* Creates a tile fill mode element for blip fills.
+	*
+	* When a blip fill uses tile mode, the image is repeated (tiled) to fill
+	* the shape instead of being stretched. This element controls the tiling
+	* parameters such as offset, scale, flip, and alignment.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_TileInfoProperties
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_TileInfoProperties">
+	*   <xsd:attribute name="tx" type="ST_Coordinate" use="optional"/>
+	*   <xsd:attribute name="ty" type="ST_Coordinate" use="optional"/>
+	*   <xsd:attribute name="sx" type="ST_Percentage" use="optional"/>
+	*   <xsd:attribute name="sy" type="ST_Percentage" use="optional"/>
+	*   <xsd:attribute name="flip" type="ST_TileFlipMode" default="none"/>
+	*   <xsd:attribute name="algn" type="ST_RectAlignment" use="optional"/>
+	* </xsd:complexType>
+	* ```
+	*
+	* @example
+	* ```typescript
+	* // Tile with 50% scale
+	* createTileInfo({ sx: 50, sy: 50 });
+	* // Tile with flip and alignment
+	* createTileInfo({ flip: "XY", align: "CENTER" });
+	* ```
+	*/
+	const createTileInfo = (options) => {
+		if (!options) return new BuilderElement({ name: "a:tile" });
+		const attributes = {};
+		if (options.tx !== void 0) attributes.tx = {
+			key: "tx",
+			value: options.tx
+		};
+		if (options.ty !== void 0) attributes.ty = {
+			key: "ty",
+			value: options.ty
+		};
+		if (options.sx !== void 0) attributes.sx = {
+			key: "sx",
+			value: options.sx
+		};
+		if (options.sy !== void 0) attributes.sy = {
+			key: "sy",
+			value: options.sy
+		};
+		if (options.flip !== void 0) attributes.flip = {
+			key: "flip",
+			value: TileFlipMode[options.flip]
+		};
+		if (options.align !== void 0) attributes.algn = {
+			key: "algn",
+			value: TileAlignment[options.align]
+		};
+		return new BuilderElement({
+			attributes: Object.keys(attributes).length > 0 ? attributes : void 0,
+			name: "a:tile"
+		});
+	};
+	//#endregion
 	//#region src/file/drawing/inline/graphic/graphic-data/pic/blip/blip-fill.ts
 	/**
 	* Represents a blip fill for pictures in DrawingML.
@@ -11384,12 +11683,48 @@
 	* // If mediaData.srcRect is set, cropping is applied
 	* ```
 	*/
-	var BlipFill = class extends XmlComponent {
-		constructor(mediaData) {
-			super("pic:blipFill");
-			this.root.push(createBlip(mediaData));
-			this.root.push(createSourceRectangle(mediaData.srcRect));
-			this.root.push(new Stretch());
+	const createBlipFill = (mediaData, options) => {
+		const children = [];
+		children.push(createBlip(mediaData, options === null || options === void 0 ? void 0 : options.blipEffects));
+		children.push(createSourceRectangle(mediaData.srcRect));
+		if (options === null || options === void 0 ? void 0 : options.tile) children.push(createTileInfo(options.tile));
+		else children.push(new Stretch());
+		const attributes = {};
+		if ((options === null || options === void 0 ? void 0 : options.dpi) !== void 0) attributes.dpi = {
+			key: "dpi",
+			value: options.dpi
+		};
+		if ((options === null || options === void 0 ? void 0 : options.rotWithShape) !== void 0) attributes.rotWithShape = {
+			key: "rotWithShape",
+			value: options.rotWithShape ? 1 : 0
+		};
+		return new BuilderElement({
+			attributes: Object.keys(attributes).length > 0 ? attributes : void 0,
+			children,
+			name: "pic:blipFill"
+		});
+	};
+	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/non-visual-pic-properties/child-non-visual-pic-properties/child-non-visual-pic-properties-attributes.ts
+	/**
+	* Attributes for non-visual picture properties.
+	*
+	* @module
+	*/
+	/**
+	* Attributes for CT_NonVisualPictureProperties.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:attribute name="preferRelativeResize" type="xsd:boolean" use="optional" default="true"/>
+	* ```
+	*
+	* @internal
+	*/
+	var ChildNonVisualPropertiesAttributes = class extends XmlAttributeComponent {
+		constructor(..._args) {
+			super(..._args);
+			_defineProperty(this, "xmlKeys", { preferRelativeResize: "preferRelativeResize" });
 		}
 	};
 	//#endregion
@@ -11514,6 +11849,7 @@
 	var ChildNonVisualProperties = class extends XmlComponent {
 		constructor() {
 			super("pic:cNvPicPr");
+			this.root.push(new ChildNonVisualPropertiesAttributes({ preferRelativeResize: true }));
 			this.root.push(new PicLocks());
 		}
 	};
@@ -11562,6 +11898,85 @@
 		},
 		name: "a:hlinkClick"
 	});
+	/**
+	* Creates a hover hyperlink element for a drawing.
+	*
+	* This element defines what happens when a user hovers over 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 hover hyperlink
+	*/
+	const createHyperlinkHover = (linkId, hasXmlNs) => new BuilderElement({
+		attributes: {
+			...hasXmlNs ? { xmlns: {
+				key: "xmlns:a",
+				value: "http://schemas.openxmlformats.org/drawingml/2006/main"
+			} } : {},
+			id: {
+				key: "r:id",
+				value: `rId${linkId}`
+			}
+		},
+		name: "a:hlinkHover"
+	});
+	//#endregion
+	//#region src/file/relationships/relationship/relationship.ts
+	/**
+	* Target mode types for relationships.
+	*
+	* Indicates whether a relationship target is external to the package.
+	*/
+	const TargetModeType = { EXTERNAL: "External" };
+	/**
+	* Creates a single relationship between parts in an OPC package.
+	*
+	* A relationship defines a typed connection from a source part to a target part,
+	* identified by a unique ID within the relationships collection.
+	*
+	* @example
+	* ```typescript
+	* // Internal relationship to an image
+	* createRelationship("rId1", "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image", "media/image1.png");
+	*
+	* // External relationship to a hyperlink
+	* createRelationship("rId2", "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink", "https://example.com", TargetModeType.EXTERNAL);
+	* ```
+	*/
+	const createRelationship = (id, type, target, targetMode) => new BuilderElement({
+		attributes: {
+			id: {
+				key: "Id",
+				value: id
+			},
+			target: {
+				key: "Target",
+				value: target
+			},
+			targetMode: {
+				key: "TargetMode",
+				value: targetMode
+			},
+			type: {
+				key: "Type",
+				value: type
+			}
+		},
+		name: "Relationship"
+	});
 	//#endregion
 	//#region src/file/drawing/inline/graphic/graphic-data/pic/non-visual-pic-properties/non-visual-properties/non-visual-properties-attributes.ts
 	/**
@@ -11591,16 +12006,7 @@
 	};
 	//#endregion
 	//#region src/file/drawing/inline/graphic/graphic-data/pic/non-visual-pic-properties/non-visual-properties/non-visual-properties.ts
-	/**
-	* Non-visual drawing properties module.
-	*
-	* This module provides basic metadata for drawing elements including
-	* ID, name, description, and hyperlink support.
-	*
-	* Reference: http://officeopenxml.com/drwPic.php
-	*
-	* @module
-	*/
+	const HYPERLINK_RELATIONSHIP_TYPE$1 = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
 	/**
 	* Represents non-visual drawing properties for pictures.
 	*
@@ -11631,8 +12037,10 @@
 	* ```
 	*/
 	var NonVisualProperties = class extends XmlComponent {
-		constructor() {
+		constructor(hyperlink) {
 			super("pic:cNvPr");
+			_defineProperty(this, "hyperlink", void 0);
+			this.hyperlink = hyperlink;
 			this.root.push(new NonVisualPropertiesAttributes({
 				descr: "",
 				id: 0,
@@ -11640,28 +12048,32 @@
 			}));
 		}
 		prepForXml(context) {
+			let hasStackClick = false;
 			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));
+				hasStackClick = true;
 				break;
 			}
+			if (this.hyperlink) {
+				if (this.hyperlink.click && !hasStackClick) {
+					const linkId = uniqueId();
+					context.viewWrapper.Relationships.addRelationship(linkId, HYPERLINK_RELATIONSHIP_TYPE$1, this.hyperlink.click, TargetModeType.EXTERNAL);
+					this.root.push(createHyperlinkClick(linkId, false));
+				}
+				if (this.hyperlink.hover) {
+					const linkId = uniqueId();
+					context.viewWrapper.Relationships.addRelationship(linkId, HYPERLINK_RELATIONSHIP_TYPE$1, this.hyperlink.hover, TargetModeType.EXTERNAL);
+					this.root.push(createHyperlinkHover(linkId, false));
+				}
+			}
 			return super.prepForXml(context);
 		}
 	};
 	//#endregion
 	//#region src/file/drawing/inline/graphic/graphic-data/pic/non-visual-pic-properties/non-visual-pic-properties.ts
 	/**
-	* Non-visual picture properties module.
-	*
-	* This module provides metadata and locking settings for pictures
-	* that don't affect their visual appearance.
-	*
-	* Reference: http://officeopenxml.com/drwPic.php
-	*
-	* @module
-	*/
-	/**
 	* Represents non-visual picture properties.
 	*
 	* This element specifies non-visual properties for a picture. These properties
@@ -11686,9 +12098,9 @@
 	* ```
 	*/
 	var NonVisualPicProperties = class extends XmlComponent {
-		constructor() {
+		constructor(hyperlink) {
 			super("pic:nvPicPr");
-			this.root.push(new NonVisualProperties());
+			this.root.push(new NonVisualProperties(hyperlink));
 			this.root.push(new ChildNonVisualProperties());
 		}
 	};
@@ -11745,14 +12157,19 @@
 	* ```
 	*/
 	var Pic = class extends XmlComponent {
-		constructor({ mediaData, transform, outline }) {
+		constructor({ mediaData, transform, outline, solidFill, effects, blipEffects, tile, hyperlink }) {
 			super("pic:pic");
 			this.root.push(new PicAttributes({ xmlns: "http://schemas.openxmlformats.org/drawingml/2006/picture" }));
-			this.root.push(new NonVisualPicProperties());
-			this.root.push(new BlipFill(mediaData));
+			this.root.push(new NonVisualPicProperties(hyperlink));
+			this.root.push(createBlipFill(mediaData, {
+				blipEffects,
+				tile
+			}));
 			this.root.push(new ShapeProperties({
 				element: "pic",
+				effects,
 				outline,
+				solidFill,
 				transform
 			}));
 		}
@@ -11878,7 +12295,7 @@
 	* ```
 	*/
 	var GraphicData = class extends XmlComponent {
-		constructor({ mediaData, transform, outline, solidFill }) {
+		constructor({ mediaData, transform, outline, solidFill, effects, blipEffects, tile, hyperlink }) {
 			super("a:graphicData");
 			if (mediaData.type === "wps") {
 				this.root.push(new GraphicDataAttributes({ uri: "http://schemas.microsoft.com/office/word/2010/wordprocessingShape" }));
@@ -11916,8 +12333,13 @@
 			} else {
 				this.root.push(new GraphicDataAttributes({ uri: "http://schemas.openxmlformats.org/drawingml/2006/picture" }));
 				const pic = new Pic({
+					blipEffects,
+					effects,
+					hyperlink,
 					mediaData,
 					outline,
+					solidFill,
+					tile,
 					transform
 				});
 				this.root.push(pic);
@@ -11963,14 +12385,18 @@
 	* ```
 	*/
 	var Graphic = class extends XmlComponent {
-		constructor({ mediaData, transform, outline, solidFill }) {
+		constructor({ mediaData, transform, outline, solidFill, effects, blipEffects, tile, hyperlink }) {
 			super("a:graphic");
 			_defineProperty(this, "data", void 0);
 			this.root.push(new GraphicAttributes({ a: "http://schemas.openxmlformats.org/drawingml/2006/main" }));
 			this.data = new GraphicData({
+				blipEffects,
+				effects,
+				hyperlink,
 				mediaData,
 				outline,
 				solidFill,
+				tile,
 				transform
 			});
 			this.root.push(this.data);
@@ -12192,12 +12618,13 @@
 	* Document Properties module for DrawingML elements.
 	*
 	* This module provides non-visual properties for drawing elements,
-	* including name, description, and accessibility information.
+	* including name, description, accessibility information, and hyperlinks.
 	*
 	* Reference: https://c-rex.net/projects/samples/ooxml/e1/Part4/OOXML_P4_DOCX_docPr_topic_ID0ES32OB.html
 	*
 	* @module
 	*/
+	const HYPERLINK_RELATIONSHIP_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
 	/**
 	* Represents non-visual drawing properties in a WordprocessingML document.
 	*
@@ -12222,13 +12649,15 @@
 	* ```
 	*/
 	var DocProperties = class extends XmlComponent {
-		constructor({ name, description, title, id } = {
+		constructor({ name, description, title, id, hyperlink } = {
 			description: "",
 			name: "",
 			title: ""
 		}) {
 			super("wp:docPr");
 			_defineProperty(this, "docPropertiesUniqueNumericId", docPropertiesUniqueNumericIdGen());
+			_defineProperty(this, "hyperlink", void 0);
+			this.hyperlink = hyperlink;
 			const attributes = {
 				id: {
 					key: "id",
@@ -12250,12 +12679,26 @@
 			this.root.push(new NextAttributeComponent(attributes));
 		}
 		prepForXml(context) {
+			let hasStackClick = false;
 			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));
+				hasStackClick = true;
 				break;
 			}
+			if (this.hyperlink) {
+				if (this.hyperlink.click && !hasStackClick) {
+					const linkId = uniqueId();
+					context.viewWrapper.Relationships.addRelationship(linkId, HYPERLINK_RELATIONSHIP_TYPE, this.hyperlink.click, TargetModeType.EXTERNAL);
+					this.root.push(createHyperlinkClick(linkId, true));
+				}
+				if (this.hyperlink.hover) {
+					const linkId = uniqueId();
+					context.viewWrapper.Relationships.addRelationship(linkId, HYPERLINK_RELATIONSHIP_TYPE, this.hyperlink.hover, TargetModeType.EXTERNAL);
+					this.root.push(createHyperlinkHover(linkId, true));
+				}
+			}
 			return super.prepForXml(context);
 		}
 	};
@@ -12531,6 +12974,7 @@
 	*/
 	var Anchor = class extends XmlComponent {
 		constructor({ mediaData, transform, drawingOptions }) {
+			var _drawingOptions$docPr;
 			super("wp:anchor");
 			const floating = {
 				allowOverlap: true,
@@ -12583,16 +13027,20 @@
 			this.root.push(new DocProperties(drawingOptions.docProperties));
 			this.root.push(createGraphicFrameProperties());
 			this.root.push(new Graphic({
+				blipEffects: drawingOptions.blipEffects,
+				effects: drawingOptions.effects,
+				hyperlink: (_drawingOptions$docPr = drawingOptions.docProperties) === null || _drawingOptions$docPr === void 0 ? void 0 : _drawingOptions$docPr.hyperlink,
 				mediaData,
 				outline: drawingOptions.outline,
 				solidFill: drawingOptions.solidFill,
+				tile: drawingOptions.tile,
 				transform
 			}));
 		}
 	};
 	//#endregion
 	//#region src/file/drawing/inline/inline.ts
-	const createInline = ({ mediaData, transform, docProperties, outline, solidFill }) => {
+	const createInline = ({ mediaData, transform, docProperties, outline, solidFill, effects, blipEffects, tile }) => {
 		var _outline$width, _outline$width2, _outline$width3, _outline$width4;
 		return new BuilderElement({
 			attributes: {
@@ -12632,9 +13080,13 @@
 				new DocProperties(docProperties),
 				createGraphicFrameProperties(),
 				new Graphic({
+					blipEffects,
+					effects,
+					hyperlink: docProperties === null || docProperties === void 0 ? void 0 : docProperties.hyperlink,
 					mediaData,
 					outline,
 					solidFill,
+					tile,
 					transform
 				})
 			],
@@ -12665,10 +13117,13 @@
 		constructor(imageData, drawingOptions = {}) {
 			super("w:drawing");
 			if (!drawingOptions.floating) this.root.push(createInline({
+				blipEffects: drawingOptions.blipEffects,
 				docProperties: drawingOptions.docProperties,
+				effects: drawingOptions.effects,
 				mediaData: imageData,
 				outline: drawingOptions.outline,
 				solidFill: drawingOptions.solidFill,
+				tile: drawingOptions.tile,
 				transform: imageData.transformation
 			}));
 			else this.root.push(new Anchor({
@@ -12814,9 +13269,13 @@
 				...createImageData(rawData, options.transformation, key, options.srcRect)
 			};
 			const drawing = new Drawing(this.imageData, {
+				blipEffects: options.blipEffects,
 				docProperties: options.altText,
 				floating: options.floating,
-				outline: options.outline
+				outline: options.outline,
+				solidFill: options.solidFill,
+				effects: options.effects,
+				tile: options.tile
 			});
 			this.root.push(drawing);
 		}
@@ -13070,50 +13529,6 @@
 		}
 	};
 	//#endregion
-	//#region src/file/relationships/relationship/relationship.ts
-	/**
-	* Target mode types for relationships.
-	*
-	* Indicates whether a relationship target is external to the package.
-	*/
-	const TargetModeType = { EXTERNAL: "External" };
-	/**
-	* Creates a single relationship between parts in an OPC package.
-	*
-	* A relationship defines a typed connection from a source part to a target part,
-	* identified by a unique ID within the relationships collection.
-	*
-	* @example
-	* ```typescript
-	* // Internal relationship to an image
-	* createRelationship("rId1", "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image", "media/image1.png");
-	*
-	* // External relationship to a hyperlink
-	* createRelationship("rId2", "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink", "https://example.com", TargetModeType.EXTERNAL);
-	* ```
-	*/
-	const createRelationship = (id, type, target, targetMode) => new BuilderElement({
-		attributes: {
-			id: {
-				key: "Id",
-				value: id
-			},
-			target: {
-				key: "Target",
-				value: target
-			},
-			targetMode: {
-				key: "TargetMode",
-				value: targetMode
-			},
-			type: {
-				key: "Type",
-				value: type
-			}
-		},
-		name: "Relationship"
-	});
-	//#endregion
 	//#region src/file/relationships/relationships.ts
 	/**
 	* Relationships module for Open Packaging Conventions.
@@ -14214,8 +14629,7 @@
 	var IndentLevel = class extends XmlComponent {
 		constructor(level) {
 			super("w:ilvl");
-			if (level > 9) throw new Error("Level cannot be greater than 9. Read more here: https://answers.microsoft.com/en-us/msoffice/forum/all/does-word-support-more-than-9-list-levels/d130fdcd-1781-446d-8c84-c6c79124e4d7");
-			this.root.push(new Attributes({ val: level }));
+			this.root.push(new Attributes({ val: Math.min(level, 9) }));
 		}
 	};
 	/**
@@ -22384,9 +22798,8 @@
 			this.runProperties = new RunProperties(style && style.run);
 			this.root.push(this.paragraphProperties);
 			this.root.push(this.runProperties);
-			if (level > 9) throw new Error("Level cannot be greater than 9. Read more here: https://answers.microsoft.com/en-us/msoffice/forum/all/does-word-support-more-than-9-list-levels/d130fdcd-1781-446d-8c84-c6c79124e4d7");
 			this.root.push(new LevelAttributes({
-				ilvl: decimalNumber(level),
+				ilvl: decimalNumber(Math.min(level, 9)),
 				tentative: 1
 			}));
 		}
@@ -24141,7 +24554,10 @@
 			const xmlObj = (0, import_lib.xml2js)(xmlData, { compact: false });
 			let stylesXmlElement;
 			for (const xmlElm of xmlObj.elements || []) if (xmlElm.name === "w:styles") stylesXmlElement = xmlElm;
-			if (stylesXmlElement === void 0) throw new Error("can not find styles element");
+			if (stylesXmlElement === void 0) return {
+				importedStyles: [],
+				initialStyles: new ImportedRootElementAttributes({})
+			};
 			return {
 				importedStyles: (stylesXmlElement.elements || []).map((childElm) => convertToXmlComponent(childElm)),
 				initialStyles: new ImportedRootElementAttributes(stylesXmlElement.attributes)