docx-plus 0.0.13 → 0.1.0

package/dist/index.cjs

@@ -8921,8 +8921,8 @@ const createHorizontalPosition = ({ relative, align, offset }) => new BuilderEle
 	} },
 	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"
 });
@@ -8982,8 +8982,8 @@ const createVerticalPosition = ({ relative, align, offset }) => new BuilderEleme
 	} },
 	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"
 });
@@ -9697,6 +9697,44 @@ const createSolidFill = (options) => new BuilderElement({
 	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.
@@ -9733,7 +9771,7 @@ const createGlowEffect = (options) => {
 	});
 };
 //#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.
 *
@@ -9781,7 +9819,7 @@ const createInnerShadowEffect = (options) => {
 	});
 };
 //#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.
 *
@@ -9869,7 +9907,7 @@ const createOuterShadowEffect = (options) => {
 	});
 };
 //#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.
 *
@@ -10123,10 +10161,11 @@ const createBlurEffect = (options) => {
 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({
@@ -10562,10 +10601,13 @@ const LineJoin = {
 };
 /**
 * 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.
@@ -10601,7 +10643,8 @@ const createOutlineFill = (options) => {
 */
 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",
@@ -10913,12 +10956,12 @@ const createShape3D = (options) => {
 	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({
@@ -10992,7 +11035,6 @@ var ShapeProperties = class extends XmlComponent {
 		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));
@@ -11105,6 +11147,158 @@ var GraphicDataAttributes = class extends XmlAttributeComponent {
 	}
 };
 //#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.
@@ -11214,20 +11408,25 @@ const createExtentionList = (mediaData) => new BuilderElement({
 * @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
 /**
@@ -11351,6 +11550,106 @@ var Stretch = class extends XmlComponent {
 	}
 };
 //#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.
@@ -11379,12 +11678,48 @@ var Stretch = class extends XmlComponent {
 * // 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
@@ -11509,6 +11844,7 @@ var PicLocks = class extends XmlComponent {
 var ChildNonVisualProperties = class extends XmlComponent {
 	constructor() {
 		super("pic:cNvPicPr");
+		this.root.push(new ChildNonVisualPropertiesAttributes({ preferRelativeResize: true }));
 		this.root.push(new PicLocks());
 	}
 };
@@ -11557,6 +11893,85 @@ const createHyperlinkClick = (linkId, hasXmlNs) => new BuilderElement({
 	},
 	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
 /**
@@ -11586,16 +12001,7 @@ var NonVisualPropertiesAttributes = class extends XmlAttributeComponent {
 };
 //#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.
 *
@@ -11626,8 +12032,10 @@ var NonVisualPropertiesAttributes = class extends XmlAttributeComponent {
 * ```
 */
 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,
@@ -11635,28 +12043,32 @@ var NonVisualProperties = class extends XmlComponent {
 		}));
 	}
 	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
@@ -11681,9 +12093,9 @@ var NonVisualProperties = class extends XmlComponent {
 * ```
 */
 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());
 	}
 };
@@ -11740,14 +12152,19 @@ var PicAttributes = class extends XmlAttributeComponent {
 * ```
 */
 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
 		}));
 	}
@@ -11873,7 +12290,7 @@ const createWpgGroup = (options) => new BuilderElement({
 * ```
 */
 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" }));
@@ -11911,8 +12328,13 @@ var GraphicData = class extends XmlComponent {
 		} 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);
@@ -11958,14 +12380,18 @@ var GraphicAttributes = class extends XmlAttributeComponent {
 * ```
 */
 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);
@@ -12187,12 +12613,13 @@ const createWrapTopAndBottom = (margins = {
 * 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.
 *
@@ -12217,13 +12644,15 @@ const createWrapTopAndBottom = (margins = {
 * ```
 */
 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",
@@ -12245,12 +12674,26 @@ var DocProperties = class extends XmlComponent {
 		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);
 	}
 };
@@ -12526,6 +12969,7 @@ var AnchorAttributes = class extends XmlAttributeComponent {
 */
 var Anchor = class extends XmlComponent {
 	constructor({ mediaData, transform, drawingOptions }) {
+		var _drawingOptions$docPr;
 		super("wp:anchor");
 		const floating = {
 			allowOverlap: true,
@@ -12578,16 +13022,20 @@ var Anchor = class extends XmlComponent {
 		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: {
@@ -12627,9 +13075,13 @@ const createInline = ({ mediaData, transform, docProperties, outline, solidFill
 			new DocProperties(docProperties),
 			createGraphicFrameProperties(),
 			new Graphic({
+				blipEffects,
+				effects,
+				hyperlink: docProperties === null || docProperties === void 0 ? void 0 : docProperties.hyperlink,
 				mediaData,
 				outline,
 				solidFill,
+				tile,
 				transform
 			})
 		],
@@ -12660,10 +13112,13 @@ var Drawing = class extends XmlComponent {
 	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({
@@ -12809,9 +13264,13 @@ var ImageRun = class extends Run {
 			...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);
 	}
@@ -13065,50 +13524,6 @@ var RelationshipsAttributes = class extends XmlAttributeComponent {
 	}
 };
 //#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.
@@ -14209,8 +14624,7 @@ var NumberProperties = class extends XmlComponent {
 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) }));
 	}
 };
 /**
@@ -22379,9 +22793,8 @@ var LevelBase = class extends XmlComponent {
 		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
 		}));
 	}
@@ -24136,7 +24549,10 @@ var ExternalStylesFactory = class {
 		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)