docx-plus 0.0.6 → 0.0.7

package/dist/index.umd.js

@@ -3766,6 +3766,1257 @@
 		name: "wp:positionV"
 	});
 	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/outline/color-transform.ts
+	/**
+	* Color transform elements for DrawingML colors.
+	*
+	* This module provides color transformation elements defined in EG_ColorTransform,
+	* which can be applied as child elements to any color type (srgbClr, schemeClr, etc.).
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, EG_ColorTransform
+	*
+	* @module
+	*/
+	/**
+	* Creates color transform child elements.
+	*
+	* These elements modify the parent color according to OOXML color transform rules.
+	* Multiple transforms can be applied in sequence.
+	*
+	* @example
+	* ```typescript
+	* // Lighten accent1 by 40%
+	* createColorTransforms({ tint: 40000 });
+	* // Semi-transparent red with 50% alpha
+	* createColorTransforms({ alpha: 50000 });
+	* ```
+	*/
+	const createColorTransforms = (options) => {
+		const transforms = [];
+		if (options.tint !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.tint
+			} },
+			name: "a:tint"
+		}));
+		if (options.shade !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.shade
+			} },
+			name: "a:shade"
+		}));
+		if (options.comp) transforms.push(new BuilderElement({ name: "a:comp" }));
+		if (options.inv) transforms.push(new BuilderElement({ name: "a:inv" }));
+		if (options.gray) transforms.push(new BuilderElement({ name: "a:gray" }));
+		if (options.alpha !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.alpha
+			} },
+			name: "a:alpha"
+		}));
+		if (options.alphaOff !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.alphaOff
+			} },
+			name: "a:alphaOff"
+		}));
+		if (options.alphaMod !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.alphaMod
+			} },
+			name: "a:alphaMod"
+		}));
+		if (options.hue !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.hue
+			} },
+			name: "a:hue"
+		}));
+		if (options.hueOff !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.hueOff
+			} },
+			name: "a:hueOff"
+		}));
+		if (options.hueMod !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.hueMod
+			} },
+			name: "a:hueMod"
+		}));
+		if (options.sat !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.sat
+			} },
+			name: "a:sat"
+		}));
+		if (options.satOff !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.satOff
+			} },
+			name: "a:satOff"
+		}));
+		if (options.satMod !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.satMod
+			} },
+			name: "a:satMod"
+		}));
+		if (options.lum !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.lum
+			} },
+			name: "a:lum"
+		}));
+		if (options.lumOff !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.lumOff
+			} },
+			name: "a:lumOff"
+		}));
+		if (options.lumMod !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.lumMod
+			} },
+			name: "a:lumMod"
+		}));
+		if (options.red !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.red
+			} },
+			name: "a:red"
+		}));
+		if (options.redOff !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.redOff
+			} },
+			name: "a:redOff"
+		}));
+		if (options.redMod !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.redMod
+			} },
+			name: "a:redMod"
+		}));
+		if (options.green !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.green
+			} },
+			name: "a:green"
+		}));
+		if (options.greenOff !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.greenOff
+			} },
+			name: "a:greenOff"
+		}));
+		if (options.greenMod !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.greenMod
+			} },
+			name: "a:greenMod"
+		}));
+		if (options.blue !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.blue
+			} },
+			name: "a:blue"
+		}));
+		if (options.blueOff !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.blueOff
+			} },
+			name: "a:blueOff"
+		}));
+		if (options.blueMod !== void 0) transforms.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: options.blueMod
+			} },
+			name: "a:blueMod"
+		}));
+		if (options.gamma) transforms.push(new BuilderElement({ name: "a:gamma" }));
+		if (options.invGamma) transforms.push(new BuilderElement({ name: "a:invGamma" }));
+		return transforms;
+	};
+	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/outline/hsl-color.ts
+	/**
+	* HSL color element for DrawingML.
+	*
+	* This module provides HSL (Hue, Saturation, Luminance) color support.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_HslColor
+	*
+	* @module
+	*/
+	/**
+	* Creates an HSL color element.
+	*
+	* Specifies a color using Hue, Saturation, and Luminance values.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_HslColor">
+	*   <xsd:sequence>
+	*     <xsd:group ref="EG_ColorTransform" minOccurs="0" maxOccurs="unbounded"/>
+	*   </xsd:sequence>
+	*   <xsd:attribute name="hue" type="ST_PositiveFixedAngle" use="required"/>
+	*   <xsd:attribute name="sat" type="ST_Percentage" use="required"/>
+	*   <xsd:attribute name="lum" type="ST_Percentage" use="required"/>
+	* </xsd:complexType>
+	* ```
+	*/
+	const createHslColor = (options) => {
+		const transforms = options.transforms ? createColorTransforms(options.transforms) : [];
+		return new BuilderElement({
+			attributes: {
+				hue: {
+					key: "hue",
+					value: options.hue
+				},
+				lum: {
+					key: "lum",
+					value: options.lum
+				},
+				sat: {
+					key: "sat",
+					value: options.sat
+				}
+			},
+			children: [...transforms],
+			name: "a:hslClr"
+		});
+	};
+	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/outline/preset-color.ts
+	/**
+	* Preset color element for DrawingML.
+	*
+	* This module provides named preset colors (CSS named colors).
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_PresetColor / ST_PresetColorVal
+	*
+	* @module
+	*/
+	/**
+	* Preset color values (CSS named colors).
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:simpleType name="ST_PresetColorVal">
+	*   <xsd:restriction base="xsd:token">
+	*     <xsd:enumeration value="aliceBlue"/>
+	*     ...
+	*     <xsd:enumeration value="yellowGreen"/>
+	*   </xsd:restriction>
+	* </xsd:simpleType>
+	* ```
+	*/
+	const PresetColor = {
+		ALICE_BLUE: "aliceBlue",
+		ANTIQUE_WHITE: "antiqueWhite",
+		AQUA: "aqua",
+		AQUAMARINE: "aquamarine",
+		AZURE: "azure",
+		BEIGE: "beige",
+		BISQUE: "bisque",
+		BLACK: "black",
+		BLANCHED_ALMOND: "blanchedAlmond",
+		BLUE: "blue",
+		BLUE_VIOLET: "blueViolet",
+		BROWN: "brown",
+		BURLY_WOOD: "burlyWood",
+		CADET_BLUE: "cadetBlue",
+		CHARTREUSE: "chartreuse",
+		CHOCOLATE: "chocolate",
+		CORAL: "coral",
+		CORNFLOWER_BLUE: "cornflowerBlue",
+		CORNSILK: "cornsilk",
+		CRIMSON: "crimson",
+		CYAN: "cyan",
+		DARK_BLUE: "darkBlue",
+		DARK_CYAN: "darkCyan",
+		DARK_GOLDENROD: "darkGoldenrod",
+		DARK_GRAY: "darkGray",
+		DARK_GREY: "darkGrey",
+		DARK_GREEN: "darkGreen",
+		DARK_KHAKI: "darkKhaki",
+		DARK_MAGENTA: "darkMagenta",
+		DARK_OLIVE_GREEN: "darkOliveGreen",
+		DARK_ORANGE: "darkOrange",
+		DARK_ORCHID: "darkOrchid",
+		DARK_RED: "darkRed",
+		DARK_SALMON: "darkSalmon",
+		DARK_SEA_GREEN: "darkSeaGreen",
+		DARK_SLATE_BLUE: "darkSlateBlue",
+		DARK_SLATE_GRAY: "darkSlateGray",
+		DARK_SLATE_GREY: "darkSlateGrey",
+		DARK_TURQUOISE: "darkTurquoise",
+		DARK_VIOLET: "darkViolet",
+		DEEP_PINK: "deepPink",
+		DEEP_SKY_BLUE: "deepSkyBlue",
+		DIM_GRAY: "dimGray",
+		DIM_GREY: "dimGrey",
+		DODGER_BLUE: "dodgerBlue",
+		FIREBRICK: "firebrick",
+		FLORAL_WHITE: "floralWhite",
+		FOREST_GREEN: "forestGreen",
+		FUCHSIA: "fuchsia",
+		GAINSBORO: "gainsboro",
+		GHOST_WHITE: "ghostWhite",
+		GOLD: "gold",
+		GOLDENROD: "goldenrod",
+		GRAY: "gray",
+		GREY: "grey",
+		GREEN: "green",
+		GREEN_YELLOW: "greenYellow",
+		HONEYDEW: "honeydew",
+		HOT_PINK: "hotPink",
+		INDIAN_RED: "indianRed",
+		INDIGO: "indigo",
+		IVORY: "ivory",
+		KHAKI: "khaki",
+		LAVENDER: "lavender",
+		LAVENDER_BLUSH: "lavenderBlush",
+		LAWN_GREEN: "lawnGreen",
+		LEMON_CHIFFON: "lemonChiffon",
+		LIGHT_BLUE: "lightBlue",
+		LIGHT_CORAL: "lightCoral",
+		LIGHT_CYAN: "lightCyan",
+		LIGHT_GOLDENROD_YELLOW: "lightGoldenrodYellow",
+		LIGHT_GRAY: "lightGray",
+		LIGHT_GREY: "lightGrey",
+		LIGHT_GREEN: "lightGreen",
+		LIGHT_PINK: "lightPink",
+		LIGHT_SALMON: "lightSalmon",
+		LIGHT_SEA_GREEN: "lightSeaGreen",
+		LIGHT_SKY_BLUE: "lightSkyBlue",
+		LIGHT_SLATE_GRAY: "lightSlateGray",
+		LIGHT_SLATE_GREY: "lightSlateGrey",
+		LIGHT_STEEL_BLUE: "lightSteelBlue",
+		LIGHT_YELLOW: "lightYellow",
+		LIME: "lime",
+		LIME_GREEN: "limeGreen",
+		LINEN: "linen",
+		MAGENTA: "magenta",
+		MAROON: "maroon",
+		MEDIUM_AQUAMARINE: "mediumAquamarine",
+		MEDIUM_BLUE: "mediumBlue",
+		MEDIUM_ORCHID: "mediumOrchid",
+		MEDIUM_PURPLE: "mediumPurple",
+		MEDIUM_SEA_GREEN: "mediumSeaGreen",
+		MEDIUM_SLATE_BLUE: "mediumSlateBlue",
+		MEDIUM_SPRING_GREEN: "mediumSpringGreen",
+		MEDIUM_TURQUOISE: "mediumTurquoise",
+		MEDIUM_VIOLET_RED: "mediumVioletRed",
+		MIDNIGHT_BLUE: "midnightBlue",
+		MINT_CREAM: "mintCream",
+		MISTY_ROSE: "mistyRose",
+		MOCCASIN: "moccasin",
+		NAVAJO_WHITE: "navajoWhite",
+		NAVY: "navy",
+		OLD_LACE: "oldLace",
+		OLIVE: "olive",
+		OLIVE_DRAB: "oliveDrab",
+		ORANGE: "orange",
+		ORANGE_RED: "orangeRed",
+		ORCHID: "orchid",
+		PALE_GOLDENROD: "paleGoldenrod",
+		PALE_GREEN: "paleGreen",
+		PALE_TURQUOISE: "paleTurquoise",
+		PALE_VIOLET_RED: "paleVioletRed",
+		PAPAYA_WHIP: "papayaWhip",
+		PEACH_PUFF: "peachPuff",
+		PERU: "peru",
+		PINK: "pink",
+		PLUM: "plum",
+		POWDER_BLUE: "powderBlue",
+		PURPLE: "purple",
+		RED: "red",
+		ROSY_BROWN: "rosyBrown",
+		ROYAL_BLUE: "royalBlue",
+		SADDLE_BROWN: "saddleBrown",
+		SALMON: "salmon",
+		SANDY_BROWN: "sandyBrown",
+		SEA_GREEN: "seaGreen",
+		SEA_SHELL: "seaShell",
+		SIENNA: "sienna",
+		SILVER: "silver",
+		SKY_BLUE: "skyBlue",
+		SLATE_BLUE: "slateBlue",
+		SLATE_GRAY: "slateGray",
+		SLATE_GREY: "slateGrey",
+		SNOW: "snow",
+		SPRING_GREEN: "springGreen",
+		STEEL_BLUE: "steelBlue",
+		TAN: "tan",
+		TEAL: "teal",
+		THISTLE: "thistle",
+		TOMATO: "tomato",
+		TURQUOISE: "turquoise",
+		VIOLET: "violet",
+		WHEAT: "wheat",
+		WHITE: "white",
+		WHITE_SMOKE: "whiteSmoke",
+		YELLOW: "yellow",
+		YELLOW_GREEN: "yellowGreen"
+	};
+	/**
+	* Creates a preset color element.
+	*
+	* Specifies a color using a named preset (CSS named color).
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_PresetColor">
+	*   <xsd:sequence>
+	*     <xsd:group ref="EG_ColorTransform" minOccurs="0" maxOccurs="unbounded"/>
+	*   </xsd:sequence>
+	*   <xsd:attribute name="val" type="ST_PresetColorVal" use="required"/>
+	* </xsd:complexType>
+	* ```
+	*/
+	const createPresetColor = (options) => {
+		const transforms = options.transforms ? createColorTransforms(options.transforms) : [];
+		return new BuilderElement({
+			attributes: { value: {
+				key: "val",
+				value: options.value
+			} },
+			children: [...transforms],
+			name: "a:prstClr"
+		});
+	};
+	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/outline/rgb-color.ts
+	/**
+	* RGB color element for DrawingML shapes.
+	*
+	* This module provides RGB color support for solid fills.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_SRgbColor
+	*
+	* @module
+	*/
+	/**
+	* Creates an sRGB color element.
+	*
+	* Specifies a color using RGB hex values.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_SRgbColor">
+	*   <xsd:sequence>
+	*     <xsd:group ref="EG_ColorTransform" minOccurs="0" maxOccurs="unbounded"/>
+	*   </xsd:sequence>
+	*   <xsd:attribute name="val" type="s:ST_HexColorRGB" use="required"/>
+	* </xsd:complexType>
+	* ```
+	*
+	* @example
+	* ```typescript
+	* const redColor = createRgbColor({ value: "FF0000" });
+	* // With alpha transform
+	* const semiRed = createRgbColor({ value: "FF0000", transforms: { alpha: 50000 } });
+	* ```
+	*/
+	const createRgbColor = (options) => {
+		const transforms = options.transforms ? createColorTransforms(options.transforms) : [];
+		return new BuilderElement({
+			attributes: { value: {
+				key: "val",
+				value: options.value
+			} },
+			children: [...transforms],
+			name: "a:srgbClr"
+		});
+	};
+	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/outline/scheme-color.ts
+	/**
+	* Scheme color element for DrawingML shapes.
+	*
+	* This module provides scheme-based color support for solid fills,
+	* allowing colors to be defined using theme color schemes.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_SchemeColor / ST_SchemeColorVal
+	*
+	* @module
+	*/
+	/**
+	* Scheme color values for theme-based colors.
+	*
+	* These values reference colors defined in the document's color scheme/theme.
+	*/
+	const SchemeColor = {
+		BG1: "bg1",
+		TX1: "tx1",
+		BG2: "bg2",
+		TX2: "tx2",
+		ACCENT1: "accent1",
+		ACCENT2: "accent2",
+		ACCENT3: "accent3",
+		ACCENT4: "accent4",
+		ACCENT5: "accent5",
+		ACCENT6: "accent6",
+		HLINK: "hlink",
+		FOLHLINK: "folHlink",
+		DK1: "dk1",
+		LT1: "lt1",
+		DK2: "dk2",
+		LT2: "lt2",
+		PHCLR: "phClr"
+	};
+	/**
+	* Creates a scheme color element.
+	*
+	* Specifies a color using a theme color scheme reference.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_SchemeColor">
+	*   <xsd:sequence>
+	*     <xsd:group ref="EG_ColorTransform" minOccurs="0" maxOccurs="unbounded"/>
+	*   </xsd:sequence>
+	*   <xsd:attribute name="val" type="ST_SchemeColorVal" use="required"/>
+	* </xsd:complexType>
+	* ```
+	*
+	* @example
+	* ```typescript
+	* const accentColor = createSchemeColor({ value: SchemeColor.ACCENT1 });
+	* // With tint transform
+	* const lightAccent = createSchemeColor({
+	*   value: SchemeColor.ACCENT1,
+	*   transforms: { tint: 40000 },
+	* });
+	* ```
+	*/
+	const createSchemeColor = (options) => {
+		const transforms = options.transforms ? createColorTransforms(options.transforms) : [];
+		return new BuilderElement({
+			attributes: { value: {
+				key: "val",
+				value: options.value
+			} },
+			children: [...transforms],
+			name: "a:schemeClr"
+		});
+	};
+	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/outline/system-color.ts
+	/**
+	* System color element for DrawingML.
+	*
+	* This module provides system color support, referencing OS-level UI colors.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_SystemColor / ST_SystemColorVal
+	*
+	* @module
+	*/
+	/**
+	* System color values referencing OS UI colors.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:simpleType name="ST_SystemColorVal">
+	*   <xsd:restriction base="xsd:token">
+	*     <xsd:enumeration value="scrollBar"/>
+	*     <xsd:enumeration value="background"/>
+	*     ...
+	*     <xsd:enumeration value="menuBar"/>
+	*   </xsd:restriction>
+	* </xsd:simpleType>
+	* ```
+	*/
+	const SystemColor = {
+		SCROLL_BAR: "scrollBar",
+		BACKGROUND: "background",
+		ACTIVE_CAPTION: "activeCaption",
+		INACTIVE_CAPTION: "inactiveCaption",
+		MENU: "menu",
+		WINDOW: "window",
+		WINDOW_FRAME: "windowFrame",
+		MENU_TEXT: "menuText",
+		WINDOW_TEXT: "windowText",
+		CAPTION_TEXT: "captionText",
+		ACTIVE_BORDER: "activeBorder",
+		INACTIVE_BORDER: "inactiveBorder",
+		APP_WORKSPACE: "appWorkspace",
+		HIGHLIGHT: "highlight",
+		HIGHLIGHT_TEXT: "highlightText",
+		BTN_FACE: "btnFace",
+		BTN_SHADOW: "btnShadow",
+		GRAY_TEXT: "grayText",
+		BTN_TEXT: "btnText",
+		INACTIVE_CAPTION_TEXT: "inactiveCaptionText",
+		BTN_HIGHLIGHT: "btnHighlight",
+		THREE_D_DK_SHADOW: "3dDkShadow",
+		THREE_D_LIGHT: "3dLight",
+		INFO_TEXT: "infoText",
+		INFO_BK: "infoBk",
+		HOT_LIGHT: "hotLight",
+		GRADIENT_ACTIVE_CAPTION: "gradientActiveCaption",
+		GRADIENT_INACTIVE_CAPTION: "gradientInactiveCaption",
+		MENU_HIGHLIGHT: "menuHighlight",
+		MENU_BAR: "menuBar"
+	};
+	/**
+	* Creates a system color element.
+	*
+	* References a system-defined UI color (e.g., window background, button face).
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_SystemColor">
+	*   <xsd:sequence>
+	*     <xsd:group ref="EG_ColorTransform" minOccurs="0" maxOccurs="unbounded"/>
+	*   </xsd:sequence>
+	*   <xsd:attribute name="val" type="ST_SystemColorVal" use="required"/>
+	*   <xsd:attribute name="lastClr" type="s:ST_HexColorRGB" use="optional"/>
+	* </xsd:complexType>
+	* ```
+	*/
+	const createSystemColor = (options) => {
+		const transforms = options.transforms ? createColorTransforms(options.transforms) : [];
+		return new BuilderElement({
+			attributes: {
+				lastClr: {
+					key: "lastClr",
+					value: options.lastClr
+				},
+				value: {
+					key: "val",
+					value: options.value
+				}
+			},
+			children: [...transforms],
+			name: "a:sysClr"
+		});
+	};
+	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/outline/solid-fill.ts
+	/**
+	* Solid fill element for DrawingML shapes.
+	*
+	* This module provides solid fill support for outlines and shapes,
+	* supporting RGB, scheme, HSL, system, and preset colors.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_SolidColorFillProperties
+	*
+	* @module
+	*/
+	/**
+	* Creates the color child element for a solid fill based on the color type.
+	*/
+	const SYSTEM_COLOR_VALUES = new Set(Object.values(SystemColor));
+	const PRESET_COLOR_VALUES = new Set(Object.values(PresetColor));
+	const SCHEME_COLOR_VALUES = new Set(Object.values(SchemeColor));
+	const createColorElement = (color) => {
+		if ("hue" in color && "sat" in color && "lum" in color) return createHslColor(color);
+		const colorValue = color.value;
+		if (SYSTEM_COLOR_VALUES.has(colorValue)) return createSystemColor(color);
+		if (PRESET_COLOR_VALUES.has(colorValue)) return createPresetColor(color);
+		if (SCHEME_COLOR_VALUES.has(colorValue)) return createSchemeColor(color);
+		return createRgbColor(color);
+	};
+	/**
+	* Creates a solid fill element.
+	*
+	* Specifies a solid color fill using any supported color type.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_SolidColorFillProperties">
+	*   <xsd:sequence>
+	*     <xsd:group ref="EG_ColorChoice" minOccurs="0"/>
+	*     <xsd:group ref="EG_EffectProperties" minOccurs="0"/>
+	*   </xsd:sequence>
+	* </xsd:complexType>
+	* ```
+	*
+	* @example
+	* ```typescript
+	* // RGB solid fill
+	* const fill = createSolidFill({ value: "FF0000" });
+	* // Scheme solid fill with tint
+	* const schemeFill = createSolidFill({
+	*   value: SchemeColor.ACCENT1, transforms: { tint: 40000 },
+	* });
+	* // HSL solid fill
+	* const hslFill = createSolidFill({ hue: 120000, sat: 100000, lum: 50000 });
+	* ```
+	*/
+	const createSolidFill = (options) => new BuilderElement({
+		children: [createColorElement(options)],
+		name: "a:solidFill"
+	});
+	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/effects/glow.ts
+	/**
+	* Glow effect for DrawingML shapes.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_GlowEffect
+	*
+	* @module
+	*/
+	/**
+	* Creates a glow effect element.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_GlowEffect">
+	*   <xsd:sequence>
+	*     <xsd:group ref="EG_ColorChoice" minOccurs="1" maxOccurs="1"/>
+	*   </xsd:sequence>
+	*   <xsd:attribute name="rad" type="ST_PositiveCoordinate" use="optional" default="0"/>
+	* </xsd:complexType>
+	* ```
+	*/
+	const createGlowEffect = (options) => {
+		if (options.rad === void 0) return new BuilderElement({
+			children: [createColorElement(options.color)],
+			name: "a:glow"
+		});
+		return new BuilderElement({
+			attributes: { rad: {
+				key: "rad",
+				value: options.rad
+			} },
+			children: [createColorElement(options.color)],
+			name: "a:glow"
+		});
+	};
+	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/effects/inner-shdw.ts
+	/**
+	* Inner shadow effect for DrawingML shapes.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_InnerShadowEffect
+	*
+	* @module
+	*/
+	/**
+	* Creates an inner shadow effect element.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_InnerShadowEffect">
+	*   <xsd:sequence>
+	*     <xsd:group ref="EG_ColorChoice" minOccurs="1" maxOccurs="1"/>
+	*   </xsd:sequence>
+	*   <xsd:attribute name="blurRad" type="ST_PositiveCoordinate" default="0"/>
+	*   <xsd:attribute name="dist" type="ST_PositiveCoordinate" default="0"/>
+	*   <xsd:attribute name="dir" type="ST_PositiveFixedAngle" default="0"/>
+	* </xsd:complexType>
+	* ```
+	*/
+	const createInnerShadowEffect = (options) => {
+		if (!(options.blurRad !== void 0 || options.dist !== void 0 || options.dir !== void 0)) return new BuilderElement({
+			children: [createColorElement(options.color)],
+			name: "a:innerShdw"
+		});
+		return new BuilderElement({
+			attributes: {
+				...options.blurRad !== void 0 && { blurRad: {
+					key: "blurRad",
+					value: options.blurRad
+				} },
+				...options.dist !== void 0 && { dist: {
+					key: "dist",
+					value: options.dist
+				} },
+				...options.dir !== void 0 && { dir: {
+					key: "dir",
+					value: options.dir
+				} }
+			},
+			children: [createColorElement(options.color)],
+			name: "a:innerShdw"
+		});
+	};
+	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/effects/outer-shdw.ts
+	/**
+	* Outer shadow effect for DrawingML shapes.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_OuterShadowEffect
+	*
+	* @module
+	*/
+	/**
+	* Rectangle alignment for shadow positioning.
+	*/
+	const RectAlignment = {
+		TOP_LEFT: "tl",
+		TOP: "t",
+		TOP_RIGHT: "tr",
+		LEFT: "l",
+		CENTER: "ctr",
+		RIGHT: "r",
+		BOTTOM_LEFT: "bl",
+		BOTTOM: "b",
+		BOTTOM_RIGHT: "br"
+	};
+	/**
+	* Creates an outer shadow effect element.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_OuterShadowEffect">
+	*   <xsd:sequence>
+	*     <xsd:group ref="EG_ColorChoice" minOccurs="1" maxOccurs="1"/>
+	*   </xsd:sequence>
+	*   <xsd:attribute name="blurRad" type="ST_PositiveCoordinate" default="0"/>
+	*   <xsd:attribute name="dist" type="ST_PositiveCoordinate" default="0"/>
+	*   <xsd:attribute name="dir" type="ST_PositiveFixedAngle" default="0"/>
+	*   <xsd:attribute name="sx" type="ST_Percentage" default="100%"/>
+	*   <xsd:attribute name="sy" type="ST_Percentage" default="100%"/>
+	*   <xsd:attribute name="kx" type="ST_FixedAngle" default="0"/>
+	*   <xsd:attribute name="ky" type="ST_FixedAngle" default="0"/>
+	*   <xsd:attribute name="algn" type="ST_RectAlignment" default="b"/>
+	*   <xsd:attribute name="rotWithShape" type="xsd:boolean" default="true"/>
+	* </xsd:complexType>
+	* ```
+	*/
+	const createOuterShadowEffect = (options) => {
+		const attributes = {};
+		if (options.blurRad !== void 0) attributes.blurRad = {
+			key: "blurRad",
+			value: options.blurRad
+		};
+		if (options.dist !== void 0) attributes.dist = {
+			key: "dist",
+			value: options.dist
+		};
+		if (options.dir !== void 0) attributes.dir = {
+			key: "dir",
+			value: options.dir
+		};
+		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.kx !== void 0) attributes.kx = {
+			key: "kx",
+			value: options.kx
+		};
+		if (options.ky !== void 0) attributes.ky = {
+			key: "ky",
+			value: options.ky
+		};
+		if (options.algn !== void 0) attributes.algn = {
+			key: "algn",
+			value: RectAlignment[options.algn]
+		};
+		if (options.rotWithShape === false) attributes.rotWithShape = {
+			key: "rotWithShape",
+			value: 0
+		};
+		return new BuilderElement({
+			attributes,
+			children: [createColorElement(options.color)],
+			name: "a:outerShdw"
+		});
+	};
+	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/effects/prst-shdw.ts
+	/**
+	* Preset shadow effect for DrawingML shapes.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_PresetShadowEffect
+	*
+	* @module
+	*/
+	/**
+	* Preset shadow types (20 variations).
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, ST_PresetShadowVal
+	*/
+	const PresetShadowVal = {
+		SHDW1: "shdw1",
+		SHDW2: "shdw2",
+		SHDW3: "shdw3",
+		SHDW4: "shdw4",
+		SHDW5: "shdw5",
+		SHDW6: "shdw6",
+		SHDW7: "shdw7",
+		SHDW8: "shdw8",
+		SHDW9: "shdw9",
+		SHDW10: "shdw10",
+		SHDW11: "shdw11",
+		SHDW12: "shdw12",
+		SHDW13: "shdw13",
+		SHDW14: "shdw14",
+		SHDW15: "shdw15",
+		SHDW16: "shdw16",
+		SHDW17: "shdw17",
+		SHDW18: "shdw18",
+		SHDW19: "shdw19",
+		SHDW20: "shdw20"
+	};
+	/**
+	* Creates a preset shadow effect element.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_PresetShadowEffect">
+	*   <xsd:sequence>
+	*     <xsd:group ref="EG_ColorChoice" minOccurs="1" maxOccurs="1"/>
+	*   </xsd:sequence>
+	*   <xsd:attribute name="prst" type="ST_PresetShadowVal" use="required"/>
+	*   <xsd:attribute name="dist" type="ST_PositiveCoordinate" default="0"/>
+	*   <xsd:attribute name="dir" type="ST_PositiveFixedAngle" default="0"/>
+	* </xsd:complexType>
+	* ```
+	*/
+	const createPresetShadowEffect = (options) => {
+		const attributes = { prst: {
+			key: "prst",
+			value: PresetShadowVal[options.prst]
+		} };
+		if (options.dist !== void 0) attributes.dist = {
+			key: "dist",
+			value: options.dist
+		};
+		if (options.dir !== void 0) attributes.dir = {
+			key: "dir",
+			value: options.dir
+		};
+		return new BuilderElement({
+			attributes,
+			children: [createColorElement(options.color)],
+			name: "a:prstShdw"
+		});
+	};
+	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/effects/reflection.ts
+	/**
+	* Reflection effect for DrawingML shapes.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_ReflectionEffect
+	*
+	* @module
+	*/
+	/**
+	* Creates a reflection effect element.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_ReflectionEffect">
+	*   <xsd:attribute name="blurRad" type="ST_PositiveCoordinate" default="0"/>
+	*   <xsd:attribute name="stA" type="ST_PositiveFixedPercentage" default="100%"/>
+	*   <xsd:attribute name="stPos" type="ST_PositiveFixedPercentage" default="0%"/>
+	*   <xsd:attribute name="endA" type="ST_PositiveFixedPercentage" default="0%"/>
+	*   <xsd:attribute name="endPos" type="ST_PositiveFixedPercentage" default="100%"/>
+	*   <xsd:attribute name="dist" type="ST_PositiveCoordinate" default="0"/>
+	*   <xsd:attribute name="dir" type="ST_PositiveFixedAngle" default="0"/>
+	*   <xsd:attribute name="fadeDir" type="ST_PositiveFixedAngle" default="5400000"/>
+	*   <xsd:attribute name="sx" type="ST_Percentage" default="100%"/>
+	*   <xsd:attribute name="sy" type="ST_Percentage" default="100%"/>
+	*   <xsd:attribute name="kx" type="ST_FixedAngle" default="0"/>
+	*   <xsd:attribute name="ky" type="ST_FixedAngle" default="0"/>
+	*   <xsd:attribute name="algn" type="ST_RectAlignment" default="b"/>
+	*   <xsd:attribute name="rotWithShape" type="xsd:boolean" default="true"/>
+	* </xsd:complexType>
+	* ```
+	*/
+	const createReflectionEffect = (options) => {
+		if (!options) return new BuilderElement({ name: "a:reflection" });
+		const attributes = {};
+		if (options.blurRad !== void 0) attributes.blurRad = {
+			key: "blurRad",
+			value: options.blurRad
+		};
+		if (options.stA !== void 0) attributes.stA = {
+			key: "stA",
+			value: options.stA
+		};
+		if (options.stPos !== void 0) attributes.stPos = {
+			key: "stPos",
+			value: options.stPos
+		};
+		if (options.endA !== void 0) attributes.endA = {
+			key: "endA",
+			value: options.endA
+		};
+		if (options.endPos !== void 0) attributes.endPos = {
+			key: "endPos",
+			value: options.endPos
+		};
+		if (options.dist !== void 0) attributes.dist = {
+			key: "dist",
+			value: options.dist
+		};
+		if (options.dir !== void 0) attributes.dir = {
+			key: "dir",
+			value: options.dir
+		};
+		if (options.fadeDir !== void 0) attributes.fadeDir = {
+			key: "fadeDir",
+			value: options.fadeDir
+		};
+		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.kx !== void 0) attributes.kx = {
+			key: "kx",
+			value: options.kx
+		};
+		if (options.ky !== void 0) attributes.ky = {
+			key: "ky",
+			value: options.ky
+		};
+		if (options.algn !== void 0) attributes.algn = {
+			key: "algn",
+			value: options.algn
+		};
+		if (options.rotWithShape === false) attributes.rotWithShape = {
+			key: "rotWithShape",
+			value: 0
+		};
+		return new BuilderElement({
+			attributes,
+			name: "a:reflection"
+		});
+	};
+	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/effects/soft-edge.ts
+	/**
+	* Soft edge effect for DrawingML shapes.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_SoftEdgesEffect
+	*
+	* @module
+	*/
+	/**
+	* Creates a soft edge effect element.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_SoftEdgesEffect">
+	*   <xsd:attribute name="rad" type="ST_PositiveCoordinate" use="required"/>
+	* </xsd:complexType>
+	* ```
+	*
+	* @param rad - Soft edge radius in EMUs (required)
+	*/
+	const createSoftEdgeEffect = (rad) => new BuilderElement({
+		attributes: { rad: {
+			key: "rad",
+			value: rad
+		} },
+		name: "a:softEdge"
+	});
+	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/effects/effect-list.ts
+	/**
+	* Effect list container for DrawingML shapes.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_EffectList, EG_EffectProperties
+	*
+	* @module
+	*/
+	/**
+	* Creates a blur effect element.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_BlurEffect">
+	*   <xsd:attribute name="rad" type="ST_PositiveCoordinate" default="0"/>
+	*   <xsd:attribute name="grow" type="xsd:boolean" default="true"/>
+	* </xsd:complexType>
+	* ```
+	*/
+	const createBlurEffect = (options) => {
+		if (!(options.rad !== void 0 || options.grow === false)) return new BuilderElement({ name: "a:blur" });
+		return new BuilderElement({
+			attributes: {
+				...options.rad !== void 0 && { rad: {
+					key: "rad",
+					value: options.rad
+				} },
+				...options.grow === false && { grow: {
+					key: "grow",
+					value: 0
+				} }
+			},
+			name: "a:blur"
+		});
+	};
+	/**
+	* Creates an effect list element (a:effectLst).
+	*
+	* This is the EG_EffectProperties choice for a flat list of effects.
+	* Effects are emitted in XSD order: blur, glow, innerShdw, outerShdw, prstShdw, reflection, softEdge.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_EffectList">
+	*   <xsd:sequence>
+	*     <xsd:element name="blur" type="CT_BlurEffect" minOccurs="0"/>
+	*     <xsd:element name="fillOverlay" type="CT_FillOverlayEffect" minOccurs="0"/>
+	*     <xsd:element name="glow" type="CT_GlowEffect" minOccurs="0"/>
+	*     <xsd:element name="innerShdw" type="CT_InnerShadowEffect" minOccurs="0"/>
+	*     <xsd:element name="outerShdw" type="CT_OuterShadowEffect" minOccurs="0"/>
+	*     <xsd:element name="prstShdw" type="CT_PresetShadowEffect" minOccurs="0"/>
+	*     <xsd:element name="reflection" type="CT_ReflectionEffect" minOccurs="0"/>
+	*     <xsd:element name="softEdge" type="CT_SoftEdgesEffect" minOccurs="0"/>
+	*   </xsd:sequence>
+	* </xsd:complexType>
+	* ```
+	*/
+	const createEffectList = (options) => {
+		const children = [];
+		if (options.blur) children.push(createBlurEffect(options.blur));
+		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.reflection) children.push(createReflectionEffect(options.reflection === true ? void 0 : options.reflection));
+		if (options.softEdge !== void 0) children.push(createSoftEdgeEffect(options.softEdge));
+		return new BuilderElement({
+			children,
+			name: "a:effectLst"
+		});
+	};
+	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/fill/gradient-fill.ts
+	/**
+	* Gradient fill element for DrawingML shapes.
+	*
+	* This module provides gradient fill support with linear and path shading.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_GradientFillProperties
+	*
+	* @module
+	*/
+	/**
+	* Path shade type for radial gradients.
+	*/
+	const PathShadeType = {
+		SHAPE: "shape",
+		CIRCLE: "circle",
+		RECT: "rect"
+	};
+	/**
+	* Creates a gradient stop element (a:gs).
+	*
+	* @example
+	* ```typescript
+	* createGradientStop({ position: 0, color: { value: "FF0000" } });
+	* createGradientStop({ position: 100000, color: { value: "0000FF" } });
+	* ```
+	*/
+	const createGradientStop = (stop) => new BuilderElement({
+		attributes: { pos: {
+			key: "pos",
+			value: stop.position
+		} },
+		children: [createColorElement(stop.color)],
+		name: "a:gs"
+	});
+	/**
+	* Creates the shade element (a:lin or a:path).
+	*/
+	const createShadeElement = (shade) => {
+		if ("angle" in shade) return new BuilderElement({
+			attributes: {
+				ang: {
+					key: "ang",
+					value: shade.angle
+				},
+				scaled: {
+					key: "scaled",
+					value: shade.scaled
+				}
+			},
+			name: "a:lin"
+		});
+		const pathShade = shade;
+		return new BuilderElement({
+			attributes: { path: {
+				key: "path",
+				value: pathShade.path ? PathShadeType[pathShade.path] : void 0
+			} },
+			name: "a:path"
+		});
+	};
+	/**
+	* Creates a gradient fill element.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_GradientFillProperties">
+	*   <xsd:sequence>
+	*     <xsd:element name="gsLst" type="CT_GradientStopList" minOccurs="0"/>
+	*     <xsd:group ref="EG_ShadeProperties" minOccurs="0"/>
+	*   </xsd:sequence>
+	*   <xsd:attribute name="rotWithShape" type="xsd:boolean" use="optional"/>
+	* </xsd:complexType>
+	* ```
+	*
+	* @example
+	* ```typescript
+	* // Linear gradient from red to blue
+	* createGradientFill({
+	*   stops: [
+	*     { position: 0, color: { value: "FF0000" } },
+	*     { position: 100000, color: { value: "0000FF" } },
+	*   ],
+	*   shade: { angle: 5400000 },
+	* });
+	* ```
+	*/
+	const createGradientFill = (options) => {
+		const children = [];
+		children.push(new BuilderElement({
+			children: options.stops.map(createGradientStop),
+			name: "a:gsLst"
+		}));
+		if (options.shade) children.push(createShadeElement(options.shade));
+		return new BuilderElement({
+			attributes: { rotWithShape: {
+				key: "rotWithShape",
+				value: options.rotateWithShape
+			} },
+			children,
+			name: "a:gradFill"
+		});
+	};
+	//#endregion
 	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/form/extents/extents-attributes.ts
 	/**
 	* Extents attributes for DrawingML shapes.
@@ -4002,143 +5253,103 @@
 	*/
 	const createNoFill = () => new BuilderElement({ name: "a:noFill" });
 	//#endregion
-	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/outline/rgb-color.ts
-	/**
-	* RGB color element for DrawingML shapes.
-	*
-	* This module provides RGB color support for solid fills.
-	*
-	* @module
-	*/
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/outline/outline.ts
 	/**
-	* Creates an sRGB color element.
+	* Outline (line) properties for DrawingML shapes.
 	*
-	* Specifies a color using RGB hex values.
+	* This module provides support for configuring outline properties including
+	* width, cap style, compound line types, fill properties, dash, and join.
 	*
-	* ## XSD Schema
-	* ```xml
-	* <xsd:complexType name="CT_SRgbColor">
-	*   <xsd:sequence>
-	*     <xsd:group ref="EG_ColorTransform" minOccurs="0" maxOccurs="unbounded"/>
-	*   </xsd:sequence>
-	*   <xsd:attribute name="val" type="s:ST_HexColorRGB" use="required"/>
-	* </xsd:complexType>
-	* ```
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_LineProperties
 	*
-	* @example
-	* ```typescript
-	* const redColor = createSolidRgbColor({ value: "FF0000" });
-	* const blueColor = createSolidRgbColor({ value: "0000FF" });
-	* ```
+	* @module
 	*/
-	const createSolidRgbColor = (options) => new BuilderElement({
-		attributes: { value: {
-			key: "val",
-			value: options.value
-		} },
-		name: "a:srgbClr"
-	});
-	//#endregion
-	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/outline/scheme-color.ts
 	/**
-	* Scheme color element for DrawingML shapes.
-	*
-	* This module provides scheme-based color support for solid fills,
-	* allowing colors to be defined using theme color schemes.
+	* Line cap styles for outline endpoints.
 	*
-	* @module
+	* Defines how the ends of a line are rendered.
 	*/
+	const LineCap = {
+		ROUND: "rnd",
+		SQUARE: "sq",
+		FLAT: "flat"
+	};
 	/**
-	* Creates a scheme color element.
-	*
-	* Specifies a color using a theme color scheme reference.
-	*
-	* ## XSD Schema
-	* ```xml
-	* <xsd:complexType name="CT_SchemeColor">
-	*   <xsd:sequence>
-	*     <xsd:group ref="EG_ColorTransform" minOccurs="0" maxOccurs="unbounded"/>
-	*   </xsd:sequence>
-	*   <xsd:attribute name="val" type="ST_SchemeColorVal" use="required"/>
-	* </xsd:complexType>
-	* ```
+	* Compound line types for outlines.
 	*
-	* @example
-	* ```typescript
-	* const accentColor = createSchemeColor({ value: SchemeColor.ACCENT1 });
-	* const bgColor = createSchemeColor({ value: SchemeColor.BG1 });
-	* ```
+	* Defines the structure of compound lines (single, double, etc.).
 	*/
-	const createSchemeColor = (options) => new BuilderElement({
-		attributes: { value: {
-			key: "val",
-			value: options.value
-		} },
-		name: "a:schemeClr"
-	});
-	//#endregion
-	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/outline/solid-fill.ts
+	const CompoundLine = {
+		SINGLE: "sng",
+		DOUBLE: "dbl",
+		THICK_THIN: "thickThin",
+		THIN_THICK: "thinThick",
+		TRI: "tri"
+	};
 	/**
-	* Solid fill element for DrawingML shapes.
-	*
-	* This module provides solid fill support for outlines and shapes,
-	* supporting both RGB and scheme-based colors.
+	* Pen alignment options for outline positioning.
 	*
-	* @module
+	* Defines how the outline is aligned relative to the shape edge.
 	*/
+	const PenAlignment = {
+		CENTER: "ctr",
+		INSET: "in"
+	};
 	/**
-	* Creates a solid fill element.
-	*
-	* Specifies a solid color fill using either RGB or scheme colors.
+	* Preset dash styles for outlines.
 	*
 	* ## XSD Schema
 	* ```xml
-	* <xsd:complexType name="CT_SolidColorFillProperties">
-	*   <xsd:sequence>
-	*     <xsd:group ref="EG_ColorChoice" minOccurs="0"/>
-	*     <xsd:group ref="EG_EffectProperties" minOccurs="0"/>
-	*   </xsd:sequence>
-	* </xsd:complexType>
-	* ```
-	*
-	* @example
-	* ```typescript
-	* // RGB solid fill
-	* const fill = createSolidFill({
-	*   type: "rgb",
-	*   value: "FF0000"
-	* });
-	*
-	* // Scheme solid fill
-	* const schemeFill = createSolidFill({
-	*   type: "scheme",
-	*   value: SchemeColor.ACCENT1
-	* });
+	* <xsd:simpleType name="ST_PresetLineDashVal">
+	*   <xsd:restriction base="xsd:token">
+	*     <xsd:enumeration value="solid"/>
+	*     <xsd:enumeration value="dot"/>
+	*     <xsd:enumeration value="dash"/>
+	*     <xsd:enumeration value="lgDash"/>
+	*     <xsd:enumeration value="dashDot"/>
+	*     <xsd:enumeration value="lgDashDot"/>
+	*     <xsd:enumeration value="lgDashDotDot"/>
+	*     <xsd:enumeration value="sysDash"/>
+	*     <xsd:enumeration value="sysDot"/>
+	*     <xsd:enumeration value="sysDashDot"/>
+	*     <xsd:enumeration value="sysDashDotDot"/>
+	*   </xsd:restriction>
+	* </xsd:simpleType>
 	* ```
 	*/
-	const createSolidFill = (options) => new BuilderElement({
-		children: [options.type === "rgb" ? createSolidRgbColor(options) : createSchemeColor(options)],
-		name: "a:solidFill"
-	});
-	//#endregion
-	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/outline/outline.ts
+	const PresetDash = {
+		SOLID: "solid",
+		DOT: "dot",
+		DASH: "dash",
+		LG_DASH: "lgDash",
+		DASH_DOT: "dashDot",
+		LG_DASH_DOT: "lgDashDot",
+		LG_DASH_DOT_DOT: "lgDashDotDot",
+		SYS_DASH: "sysDash",
+		SYS_DOT: "sysDot",
+		SYS_DASH_DOT: "sysDashDot",
+		SYS_DASH_DOT_DOT: "sysDashDotDot"
+	};
 	/**
-	* Outline (line) properties for DrawingML shapes.
-	*
-	* This module provides support for configuring outline properties including
-	* width, cap style, compound line types, and fill properties.
-	*
-	* Reference: http://officeopenxml.com/drwSp-outline.php
-	*
-	* @module
+	* Line join styles.
 	*/
+	const LineJoin = {
+		ROUND: "round",
+		BEVEL: "bevel",
+		MITER: "miter"
+	};
+	/**
+	* Creates the fill child element for an outline.
+	*/
+	const createOutlineFill = (options) => {
+		if (options.type === "noFill") return createNoFill();
+		return createSolidFill(options.color);
+	};
 	/**
 	* Creates an outline element for DrawingML shapes.
 	*
 	* The outline element specifies the line properties for the shape border,
-	* including width, cap style, compound line type, alignment, and fill.
-	*
-	* Reference: http://officeopenxml.com/drwSp-outline.php
+	* including width, cap style, compound line type, alignment, dash, join, and fill.
 	*
 	* ## XSD Schema
 	* ```xml
@@ -4157,44 +5368,56 @@
 	*
 	* @example
 	* ```typescript
-	* // Create outline with RGB color
+	* // Outline with RGB color and dash
 	* const outline = createOutline({
 	*   width: 9525,
-	*   cap: "ROUND",
 	*   type: "solidFill",
-	*   solidFillType: "rgb",
-	*   value: "FF0000"
+	*   color: { value: "FF0000" },
+	*   dash: "DASH",
 	* });
 	* ```
 	*/
-	const createOutline = (options) => new BuilderElement({
-		attributes: {
-			align: {
-				key: "algn",
-				value: options.align
-			},
-			cap: {
-				key: "cap",
-				value: options.cap
-			},
-			compoundLine: {
-				key: "cmpd",
-				value: options.compoundLine
+	const createOutline = (options) => {
+		const children = [];
+		children.push(createOutlineFill(options));
+		if (options.dash !== void 0) children.push(new BuilderElement({
+			attributes: { val: {
+				key: "val",
+				value: PresetDash[options.dash]
+			} },
+			name: "a:prstDash"
+		}));
+		if (options.join !== void 0) if (options.join === "MITER" && options.miterLimit !== void 0) children.push(new BuilderElement({
+			attributes: { lim: {
+				key: "lim",
+				value: options.miterLimit
+			} },
+			name: "a:miter"
+		}));
+		else children.push(new BuilderElement({ name: `a:${LineJoin[options.join]}` }));
+		return new BuilderElement({
+			attributes: {
+				align: {
+					key: "algn",
+					value: options.align ? PenAlignment[options.align] : void 0
+				},
+				cap: {
+					key: "cap",
+					value: options.cap ? LineCap[options.cap] : void 0
+				},
+				compoundLine: {
+					key: "cmpd",
+					value: options.compoundLine ? CompoundLine[options.compoundLine] : void 0
+				},
+				width: {
+					key: "w",
+					value: options.width
+				}
 			},
-			width: {
-				key: "w",
-				value: options.width
-			}
-		},
-		children: [options.type === "noFill" ? createNoFill() : options.solidFillType === "rgb" ? createSolidFill({
-			type: "rgb",
-			value: options.value
-		}) : createSolidFill({
-			type: "scheme",
-			value: options.value
-		})],
-		name: "a:ln"
-	});
+			children,
+			name: "a:ln"
+		});
+	};
 	//#endregion
 	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/preset-geometry/adjustment-values/adjustment-values.ts
 	/**
@@ -4332,15 +5555,181 @@
 		}
 	};
 	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/three-d/bevel.ts
+	/**
+	* Bevel element for DrawingML 3D shapes.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_Bevel
+	*
+	* @module
+	*/
+	/**
+	* Bevel preset types (12 variations).
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, ST_BevelPresetType
+	*/
+	const BevelPresetType = {
+		RELAXED_INSET: "relaxedInset",
+		CIRCLE: "circle",
+		SLOPE: "slope",
+		CROSS: "cross",
+		ANGLE: "angle",
+		SOFT_ROUND: "softRound",
+		CONVEX: "convex",
+		COOL_SLANT: "coolSlant",
+		DIVOT: "divot",
+		RIBLET: "riblet",
+		HARD_EDGE: "hardEdge",
+		ART_DECO: "artDeco"
+	};
+	/**
+	* Creates a bevel element.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_Bevel">
+	*   <xsd:attribute name="w" type="ST_PositiveCoordinate" default="76200"/>
+	*   <xsd:attribute name="h" type="ST_PositiveCoordinate" default="76200"/>
+	*   <xsd:attribute name="prst" type="ST_BevelPresetType" default="circle"/>
+	* </xsd:complexType>
+	* ```
+	*/
+	const createBevel = (options) => {
+		if (!options) return new BuilderElement({ name: "a:bevelT" });
+		const attributes = {};
+		if (options.w !== void 0) attributes.w = {
+			key: "w",
+			value: options.w
+		};
+		if (options.h !== void 0) attributes.h = {
+			key: "h",
+			value: options.h
+		};
+		if (options.prst !== void 0) attributes.prst = {
+			key: "prst",
+			value: BevelPresetType[options.prst]
+		};
+		return new BuilderElement({
+			attributes,
+			name: "a:bevelT"
+		});
+	};
+	/**
+	* Creates a bottom bevel element (a:bevelB).
+	*/
+	const createBottomBevel = (options) => {
+		if (!options) return new BuilderElement({ name: "a:bevelB" });
+		const attributes = {};
+		if (options.w !== void 0) attributes.w = {
+			key: "w",
+			value: options.w
+		};
+		if (options.h !== void 0) attributes.h = {
+			key: "h",
+			value: options.h
+		};
+		if (options.prst !== void 0) attributes.prst = {
+			key: "prst",
+			value: BevelPresetType[options.prst]
+		};
+		return new BuilderElement({
+			attributes,
+			name: "a:bevelB"
+		});
+	};
+	//#endregion
+	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/three-d/shape-3d.ts
+	/**
+	* 3D shape properties for DrawingML.
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_Shape3D
+	*
+	* @module
+	*/
+	/**
+	* Preset material types for 3D shapes (15 variations).
+	*
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, ST_PresetMaterialType
+	*/
+	const PresetMaterialType = {
+		LEGACY_MATTE: "legacyMatte",
+		LEGACY_PLASTIC: "legacyPlastic",
+		LEGACY_METAL: "legacyMetal",
+		LEGACY_WIREFRAME: "legacyWireframe",
+		MATTE: "matte",
+		PLASTIC: "plastic",
+		METAL: "metal",
+		WARM_MATTE: "warmMatte",
+		TRANSLUCENT_POWDER: "translucentPowder",
+		POWDER: "powder",
+		DK_EDGE: "dkEdge",
+		SOFT_EDGE: "softEdge",
+		CLEAR: "clear",
+		FLAT: "flat",
+		SOFT_METAL: "softmetal"
+	};
+	/**
+	* Creates a 3D shape properties element (a:sp3d).
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_Shape3D">
+	*   <xsd:sequence>
+	*     <xsd:element name="bevelT" type="CT_Bevel" minOccurs="0"/>
+	*     <xsd:element name="bevelB" type="CT_Bevel" minOccurs="0"/>
+	*     <xsd:element name="extrusionClr" type="CT_Color" minOccurs="0"/>
+	*     <xsd:element name="contourClr" type="CT_Color" minOccurs="0"/>
+	*   </xsd:sequence>
+	*   <xsd:attribute name="z" type="ST_Coordinate" default="0"/>
+	*   <xsd:attribute name="extrusionH" type="ST_PositiveCoordinate" default="0"/>
+	*   <xsd:attribute name="contourW" type="ST_PositiveCoordinate" default="0"/>
+	*   <xsd:attribute name="prstMaterial" type="ST_PresetMaterialType" default="warmMatte"/>
+	* </xsd:complexType>
+	* ```
+	*/
+	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)],
+			name: "a:extrusionClr"
+		}));
+		if (options.contourClr) children.push(new BuilderElement({
+			children: [createColorElement(options.contourClr)],
+			name: "a:contourClr"
+		}));
+		return new BuilderElement({
+			attributes: options.z !== void 0 || options.extrusionH !== void 0 || options.contourW !== void 0 || options.prstMaterial !== void 0 ? {
+				...options.z !== void 0 && { z: {
+					key: "z",
+					value: options.z
+				} },
+				...options.extrusionH !== void 0 && { extrusionH: {
+					key: "extrusionH",
+					value: options.extrusionH
+				} },
+				...options.contourW !== void 0 && { contourW: {
+					key: "contourW",
+					value: options.contourW
+				} },
+				...options.prstMaterial !== void 0 && { prstMaterial: {
+					key: "prstMaterial",
+					value: PresetMaterialType[options.prstMaterial]
+				} }
+			} : void 0,
+			children,
+			name: "a:sp3d"
+		});
+	};
+	//#endregion
 	//#region src/file/drawing/inline/graphic/graphic-data/pic/shape-properties/shape-properties.ts
 	/**
 	* Represents shape properties for a DrawingML picture.
 	*
 	* This element defines the visual formatting of a picture, including
 	* its transform (size, position, rotation, flip), geometry preset,
-	* and outline properties.
-	*
-	* Reference: http://officeopenxml.com/drwSp-SpPr.php
+	* fill, outline, effects, and 3D properties.
 	*
 	* ## XSD Schema
 	* ```xml
@@ -4362,33 +5751,29 @@
 	* @example
 	* ```typescript
 	* const shapeProps = new ShapeProperties({
-	*   transform: {
-	*     emus: { x: 914400, y: 914400 },
-	*     flip: { horizontal: false, vertical: false },
-	*     rotation: 0
+	*   element: "pic",
+	*   transform: { emus: { x: 914400, y: 914400 } },
+	*   effects: {
+	*     glow: { rad: 50800, color: { value: "FF0000" } },
 	*   },
-	*   outline: {
-	*     width: 9525,
-	*     type: "solidFill",
-	*     solidFillType: "rgb",
-	*     value: "FF0000"
-	*   }
 	* });
 	* ```
 	*/
 	var ShapeProperties = class extends XmlComponent {
-		constructor({ element, outline, solidFill, transform }) {
+		constructor({ element, effects, gradientFill, noFill, outline, shape3d, solidFill, transform }) {
 			super(`${element}:spPr`);
 			_defineProperty(this, "form", void 0);
 			this.root.push(new ShapePropertiesAttributes({ bwMode: "auto" }));
 			this.form = new Form(transform);
 			this.root.push(this.form);
 			this.root.push(new PresetGeometry());
-			if (outline) {
-				this.root.push(createNoFill());
-				this.root.push(createOutline(outline));
-			}
-			if (solidFill) this.root.push(createSolidFill(solidFill));
+			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));
 		}
 	};
 	//#endregion
@@ -4624,17 +6009,17 @@
 	*
 	* This module defines the portion of an image to use when filling a shape.
 	*
-	* Reference: http://officeopenxml.com/drwPic.php
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_RelativeRect
 	*
 	* @module
 	*/
 	/**
-	* Represents a source rectangle for blip fills.
+	* Creates a source rectangle element for blip fill cropping.
 	*
 	* This element specifies a portion of the blip (image) to use as the fill.
-	* When not specified with attributes, it indicates the entire blip should be used.
+	* When no options are provided, the entire blip is used.
 	*
-	* Reference: http://officeopenxml.com/drwPic.php
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_RelativeRect
 	*
 	* ## XSD Schema
 	* ```xml
@@ -4648,13 +6033,33 @@
 	*
 	* @example
 	* ```typescript
-	* const srcRect = new SourceRectangle();
+	* // Crop 10% from left and right
+	* createSourceRectangle({ l: 10000, r: 10000 });
 	* ```
 	*/
-	var SourceRectangle = class extends XmlComponent {
-		constructor() {
-			super("a:srcRect");
-		}
+	const createSourceRectangle = (options) => {
+		if (!options) return new BuilderElement({ name: "a:srcRect" });
+		const attributes = {};
+		if (options.l !== void 0) attributes.l = {
+			key: "l",
+			value: options.l
+		};
+		if (options.t !== void 0) attributes.t = {
+			key: "t",
+			value: options.t
+		};
+		if (options.r !== void 0) attributes.r = {
+			key: "r",
+			value: options.r
+		};
+		if (options.b !== void 0) attributes.b = {
+			key: "b",
+			value: options.b
+		};
+		return new BuilderElement({
+			attributes,
+			name: "a:srcRect"
+		});
 	};
 	//#endregion
 	//#region src/file/drawing/inline/graphic/graphic-data/pic/blip/stretch.ts
@@ -4725,9 +6130,9 @@
 	* Represents a blip fill for pictures in DrawingML.
 	*
 	* This element specifies the type of fill used for a picture. It contains the blip (image)
-	* reference, an optional source rectangle, and the fill mode (typically stretch).
+	* reference, an optional source rectangle for cropping, and the fill mode (typically stretch).
 	*
-	* Reference: http://officeopenxml.com/drwPic.php
+	* Reference: ISO/IEC 29500-4, dml-main.xsd, CT_BlipFillProperties
 	*
 	* ## XSD Schema
 	* ```xml
@@ -4745,13 +6150,14 @@
 	* @example
 	* ```typescript
 	* const blipFill = new BlipFill(mediaData);
+	* // 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(new SourceRectangle());
+			this.root.push(createSourceRectangle(mediaData.srcRect));
 			this.root.push(new Stretch());
 		}
 	};
@@ -5122,15 +6528,90 @@
 	};
 	//#endregion
 	//#region src/file/drawing/inline/graphic/graphic-data/wpg/wpg-group.ts
-	const createGroupProperties = (transform) => new BuilderElement({
-		children: [new Form(transform)],
-		name: "wpg:grpSpPr"
-	});
+	/**
+	* Creates a group transform element (a:xfrm) with optional chOff/chExt.
+	*
+	* This uses CT_GroupTransform2D which extends CT_Transform2D with
+	* child offset and extent elements.
+	*
+	* ## XSD Schema
+	* ```xml
+	* <xsd:complexType name="CT_GroupTransform2D">
+	*   <xsd:sequence>
+	*     <xsd:element name="off" type="CT_Point2D" minOccurs="0"/>
+	*     <xsd:element name="ext" type="CT_PositiveSize2D" minOccurs="0"/>
+	*     <xsd:element name="chOff" type="CT_Point2D" minOccurs="0"/>
+	*     <xsd:element name="chExt" type="CT_PositiveSize2D" minOccurs="0"/>
+	*   </xsd:sequence>
+	*   <xsd:attribute name="rot" type="ST_Angle" default="0"/>
+	*   <xsd:attribute name="flipH" type="xsd:boolean" default="false"/>
+	*   <xsd:attribute name="flipV" type="xsd:boolean" default="false"/>
+	* </xsd:complexType>
+	* ```
+	*/
+	const createGroupForm = (transform, chOff, chExt) => {
+		var _transform$offset, _transform$offset2, _transform$flip, _transform$flip2, _transform$flip3, _transform$flip4;
+		const children = [new Offset((_transform$offset = transform.offset) === null || _transform$offset === void 0 || (_transform$offset = _transform$offset.emus) === null || _transform$offset === void 0 ? void 0 : _transform$offset.x, (_transform$offset2 = transform.offset) === null || _transform$offset2 === void 0 || (_transform$offset2 = _transform$offset2.emus) === null || _transform$offset2 === void 0 ? void 0 : _transform$offset2.y), new Extents(transform.emus.x, transform.emus.y)];
+		if (chOff) children.push(new BuilderElement({
+			attributes: {
+				x: {
+					key: "x",
+					value: chOff.x
+				},
+				y: {
+					key: "y",
+					value: chOff.y
+				}
+			},
+			name: "a:chOff"
+		}));
+		if (chExt) children.push(new BuilderElement({
+			attributes: {
+				cx: {
+					key: "cx",
+					value: chExt.cx
+				},
+				cy: {
+					key: "cy",
+					value: chExt.cy
+				}
+			},
+			name: "a:chExt"
+		}));
+		return new BuilderElement({
+			attributes: ((_transform$flip = transform.flip) === null || _transform$flip === void 0 ? void 0 : _transform$flip.horizontal) !== void 0 || ((_transform$flip2 = transform.flip) === null || _transform$flip2 === void 0 ? void 0 : _transform$flip2.vertical) !== void 0 || transform.rotation !== void 0 ? {
+				...((_transform$flip3 = transform.flip) === null || _transform$flip3 === void 0 ? void 0 : _transform$flip3.horizontal) !== void 0 && { flipH: {
+					key: "flipH",
+					value: transform.flip.horizontal
+				} },
+				...((_transform$flip4 = transform.flip) === null || _transform$flip4 === void 0 ? void 0 : _transform$flip4.vertical) !== void 0 && { flipV: {
+					key: "flipV",
+					value: transform.flip.vertical
+				} },
+				...transform.rotation !== void 0 && { rot: {
+					key: "rot",
+					value: transform.rotation
+				} }
+			} : void 0,
+			children,
+			name: "a:xfrm"
+		});
+	};
+	const createGroupProperties = (options) => {
+		const children = [createGroupForm(options.transformation, options.chOff, options.chExt)];
+		if (options.noFill) children.push(createNoFill());
+		else if (options.solidFill) children.push(createSolidFill(options.solidFill));
+		if (options.effects) children.push(createEffectList(options.effects));
+		return new BuilderElement({
+			children,
+			name: "wpg:grpSpPr"
+		});
+	};
 	const createNonVisualGroupProperties = () => new BuilderElement({ name: "wpg:cNvGrpSpPr" });
 	const createWpgGroup = (options) => new BuilderElement({
 		children: [
 			createNonVisualGroupProperties(),
-			createGroupProperties(options.transformation),
+			createGroupProperties(options),
 			...options.children
 		],
 		name: "wpg:wgp"
@@ -5179,8 +6660,9 @@
 				this.root.push(wps);
 			} else if (mediaData.type === "wpg") {
 				this.root.push(new GraphicDataAttributes({ uri: "http://schemas.microsoft.com/office/word/2010/wordprocessingGroup" }));
+				const md = mediaData;
 				const wpg = createWpgGroup({
-					children: mediaData.children.map((child) => {
+					children: md.children.map((child) => {
 						if (child.type === "wps") return createWpsShape({
 							...child.data,
 							outline: child.outline,
@@ -5193,7 +6675,11 @@
 							transform: child.transformation
 						});
 					}),
-					transformation: transform
+					transformation: transform,
+					chOff: md.chOff,
+					chExt: md.chExt,
+					solidFill: md.solidFill,
+					effects: md.effects
 				});
 				this.root.push(wpg);
 			} else {
@@ -5963,9 +7449,10 @@
 	};
 	//#endregion
 	//#region src/file/paragraph/run/image-run.ts
-	const createImageData = (data, transformation, key) => ({
+	const createImageData = (data, transformation, key, srcRect) => ({
 		data,
 		fileName: key,
+		srcRect,
 		transformation: {
 			emus: {
 				x: Math.round(transformation.width * 9525),
@@ -6011,7 +7498,7 @@
 				const fallbackData = (0, undio.toUint8Array)(options.fallback.data);
 				this.imageData = {
 					type: options.type,
-					...createImageData(rawData, options.transformation, key),
+					...createImageData(rawData, options.transformation, key, options.srcRect),
 					fallback: {
 						type: options.fallback.type,
 						...createImageData(fallbackData, options.transformation, `${hashedId(fallbackData)}.${options.fallback.type}`)
@@ -6019,7 +7506,7 @@
 				};
 			} else this.imageData = {
 				type: options.type,
-				...createImageData(rawData, options.transformation, key)
+				...createImageData(rawData, options.transformation, key, options.srcRect)
 			};
 			const drawing = new Drawing(this.imageData, {
 				docProperties: options.altText,