docx-plus 0.0.6 → 0.0.8

package/dist/index.mjs

@@ -3736,6 +3736,1257 @@ const createVerticalPosition = ({ relative, align, offset }) => new BuilderEleme
 	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.
@@ -3972,143 +5223,103 @@ var Form = class extends XmlComponent {
 */
 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
@@ -4127,44 +5338,56 @@ const createSolidFill = (options) => new BuilderElement({
 *
 * @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
 /**
@@ -4302,15 +5525,181 @@ var ShapePropertiesAttributes = class extends XmlAttributeComponent {
 	}
 };
 //#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
@@ -4332,33 +5721,29 @@ var ShapePropertiesAttributes = class extends XmlAttributeComponent {
 * @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
@@ -4429,7 +5814,11 @@ const createWpsShape = (options) => new BuilderElement({
 		createNonVisualShapeProperties(options.nonVisualProperties),
 		new ShapeProperties({
 			element: "wps",
+			effects: options.effects,
+			gradientFill: options.gradientFill,
+			noFill: options.noFill,
 			outline: options.outline,
+			shape3d: options.shape3d,
 			solidFill: options.solidFill,
 			transform: options.transformation
 		}),
@@ -4594,17 +5983,17 @@ const createBlip = (mediaData) => new BuilderElement({
 *
 * 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
@@ -4618,13 +6007,33 @@ const createBlip = (mediaData) => new BuilderElement({
 *
 * @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
@@ -4695,9 +6104,9 @@ var Stretch = class extends XmlComponent {
 * 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
@@ -4715,13 +6124,14 @@ var Stretch = class extends XmlComponent {
 * @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());
 	}
 };
@@ -5092,15 +6502,90 @@ var Pic = class extends XmlComponent {
 };
 //#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"
@@ -5149,8 +6634,9 @@ var GraphicData = class extends XmlComponent {
 			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,
@@ -5163,7 +6649,11 @@ var GraphicData = class extends XmlComponent {
 						transform: child.transformation
 					});
 				}),
-				transformation: transform
+				transformation: transform,
+				chOff: md.chOff,
+				chExt: md.chExt,
+				solidFill: md.solidFill,
+				effects: md.effects
 			});
 			this.root.push(wpg);
 		} else {
@@ -5933,9 +7423,10 @@ var Drawing = class extends XmlComponent {
 };
 //#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),
@@ -5981,7 +7472,7 @@ var ImageRun = class extends Run {
 			const fallbackData = 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}`)
@@ -5989,7 +7480,7 @@ var ImageRun = class extends Run {
 			};
 		} 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,