@office-open/core 0.6.4 → 0.6.5

package/dist/index-CuRO3Jmz.d.mts

@@ -0,0 +1,3127 @@
+import { C as XmlComponent, a as BuilderElement } from "./index-B1wzvu1m.mjs";
+
+//#region src/drawingml/color/color-transform.d.ts
+/**
+ * Options for color transforms.
+ *
+ * All percentage values are in 1/1000th of a percent (e.g., 50000 = 50%).
+ * Angle values are in 60,000ths of a degree.
+ *
+ * Reference: ISO/IEC 29500-4, dml-main.xsd, EG_ColorTransform
+ */
+interface ColorTransformOptions {
+  /** Tint: moves color toward white (0-100000) */
+  readonly tint?: number;
+  /** Shade: moves color toward black (0-100000) */
+  readonly shade?: number;
+  /** Complement: inverts the color (no value) */
+  readonly comp?: boolean;
+  /** Inverse: inverts the color (no value) */
+  readonly inv?: boolean;
+  /** Grayscale: converts to grayscale (no value) */
+  readonly gray?: boolean;
+  /** Alpha: sets transparency (0-100000) */
+  readonly alpha?: number;
+  /** Alpha offset: adjusts alpha by fixed amount (-100000 to 100000) */
+  readonly alphaOff?: number;
+  /** Alpha modulation: scales alpha by percentage (0-100000) */
+  readonly alphaMod?: number;
+  /** Hue: sets hue angle (0-21600000) */
+  readonly hue?: number;
+  /** Hue offset: adjusts hue by angle (-5400000 to 5400000) */
+  readonly hueOff?: number;
+  /** Hue modulation: scales hue by percentage (0-100000) */
+  readonly hueMod?: number;
+  /** Saturation: sets saturation (-100000 to 100000) */
+  readonly sat?: number;
+  /** Saturation offset: adjusts saturation (-100000 to 100000) */
+  readonly satOff?: number;
+  /** Saturation modulation: scales saturation (0-100000) */
+  readonly satMod?: number;
+  /** Luminance: sets luminance (-100000 to 100000) */
+  readonly lum?: number;
+  /** Luminance offset: adjusts luminance (-100000 to 100000) */
+  readonly lumOff?: number;
+  /** Luminance modulation: scales luminance (0-100000) */
+  readonly lumMod?: number;
+  /** Red: sets red channel (-100000 to 100000) */
+  readonly red?: number;
+  /** Red offset: adjusts red channel (-100000 to 100000) */
+  readonly redOff?: number;
+  /** Red modulation: scales red channel (0-100000) */
+  readonly redMod?: number;
+  /** Green: sets green channel (-100000 to 100000) */
+  readonly green?: number;
+  /** Green offset: adjusts green channel (-100000 to 100000) */
+  readonly greenOff?: number;
+  /** Green modulation: scales green channel (0-100000) */
+  readonly greenMod?: number;
+  /** Blue: sets blue channel (-100000 to 100000) */
+  readonly blue?: number;
+  /** Blue offset: adjusts blue channel (-100000 to 100000) */
+  readonly blueOff?: number;
+  /** Blue modulation: scales blue channel (0-100000) */
+  readonly blueMod?: number;
+  /** Gamma correction (no value) */
+  readonly gamma?: boolean;
+  /** Inverse gamma correction (no value) */
+  readonly invGamma?: boolean;
+}
+/**
+ * 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 });
+ * ```
+ */
+declare const createColorTransforms: (options: ColorTransformOptions) => readonly XmlComponent[];
+//#endregion
+//#region src/drawingml/color/hsl-color.d.ts
+/**
+ * Options for HSL color.
+ */
+interface HslColorOptions {
+  /** Hue angle in 60,000ths of a degree (0-21600000) */
+  readonly hue: number;
+  /** Saturation in 1/1000th of a percent (0-100000) */
+  readonly saturation: number;
+  /** Luminance in 1/1000th of a percent (0-100000) */
+  readonly luminance: number;
+  /** Optional color transforms */
+  readonly transforms?: ColorTransformOptions;
+}
+/**
+ * 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>
+ * ```
+ */
+declare const createHslColor: (options: HslColorOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/color/preset-color.d.ts
+/**
+ * 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>
+ * ```
+ */
+declare const PresetColor: {
+  readonly ALICE_BLUE: "aliceBlue";
+  readonly ANTIQUE_WHITE: "antiqueWhite";
+  readonly AQUA: "aqua";
+  readonly AQUAMARINE: "aquamarine";
+  readonly AZURE: "azure";
+  readonly BEIGE: "beige";
+  readonly BISQUE: "bisque";
+  readonly BLACK: "black";
+  readonly BLANCHED_ALMOND: "blanchedAlmond";
+  readonly BLUE: "blue";
+  readonly BLUE_VIOLET: "blueViolet";
+  readonly BROWN: "brown";
+  readonly BURLY_WOOD: "burlyWood";
+  readonly CADET_BLUE: "cadetBlue";
+  readonly CHARTREUSE: "chartreuse";
+  readonly CHOCOLATE: "chocolate";
+  readonly CORAL: "coral";
+  readonly CORNFLOWER_BLUE: "cornflowerBlue";
+  readonly CORNSILK: "cornsilk";
+  readonly CRIMSON: "crimson";
+  readonly CYAN: "cyan";
+  readonly DARK_BLUE: "darkBlue";
+  readonly DARK_CYAN: "darkCyan";
+  readonly DARK_GOLDENROD: "darkGoldenrod";
+  readonly DARK_GRAY: "darkGray";
+  readonly DARK_GREY: "darkGrey";
+  readonly DARK_GREEN: "darkGreen";
+  readonly DARK_KHAKI: "darkKhaki";
+  readonly DARK_MAGENTA: "darkMagenta";
+  readonly DARK_OLIVE_GREEN: "darkOliveGreen";
+  readonly DARK_ORANGE: "darkOrange";
+  readonly DARK_ORCHID: "darkOrchid";
+  readonly DARK_RED: "darkRed";
+  readonly DARK_SALMON: "darkSalmon";
+  readonly DARK_SEA_GREEN: "darkSeaGreen";
+  readonly DARK_SLATE_BLUE: "darkSlateBlue";
+  readonly DARK_SLATE_GRAY: "darkSlateGray";
+  readonly DARK_SLATE_GREY: "darkSlateGrey";
+  readonly DARK_TURQUOISE: "darkTurquoise";
+  readonly DARK_VIOLET: "darkViolet";
+  readonly DEEP_PINK: "deepPink";
+  readonly DEEP_SKY_BLUE: "deepSkyBlue";
+  readonly DIM_GRAY: "dimGray";
+  readonly DIM_GREY: "dimGrey";
+  readonly DODGER_BLUE: "dodgerBlue";
+  readonly FIREBRICK: "firebrick";
+  readonly FLORAL_WHITE: "floralWhite";
+  readonly FOREST_GREEN: "forestGreen";
+  readonly FUCHSIA: "fuchsia";
+  readonly GAINSBORO: "gainsboro";
+  readonly GHOST_WHITE: "ghostWhite";
+  readonly GOLD: "gold";
+  readonly GOLDENROD: "goldenrod";
+  readonly GRAY: "gray";
+  readonly GREY: "grey";
+  readonly GREEN: "green";
+  readonly GREEN_YELLOW: "greenYellow";
+  readonly HONEYDEW: "honeydew";
+  readonly HOT_PINK: "hotPink";
+  readonly INDIAN_RED: "indianRed";
+  readonly INDIGO: "indigo";
+  readonly IVORY: "ivory";
+  readonly KHAKI: "khaki";
+  readonly LAVENDER: "lavender";
+  readonly LAVENDER_BLUSH: "lavenderBlush";
+  readonly LAWN_GREEN: "lawnGreen";
+  readonly LEMON_CHIFFON: "lemonChiffon";
+  readonly LIGHT_BLUE: "lightBlue";
+  readonly LIGHT_CORAL: "lightCoral";
+  readonly LIGHT_CYAN: "lightCyan";
+  readonly LIGHT_GOLDENROD_YELLOW: "lightGoldenrodYellow";
+  readonly LIGHT_GRAY: "lightGray";
+  readonly LIGHT_GREY: "lightGrey";
+  readonly LIGHT_GREEN: "lightGreen";
+  readonly LIGHT_PINK: "lightPink";
+  readonly LIGHT_SALMON: "lightSalmon";
+  readonly LIGHT_SEA_GREEN: "lightSeaGreen";
+  readonly LIGHT_SKY_BLUE: "lightSkyBlue";
+  readonly LIGHT_SLATE_GRAY: "lightSlateGray";
+  readonly LIGHT_SLATE_GREY: "lightSlateGrey";
+  readonly LIGHT_STEEL_BLUE: "lightSteelBlue";
+  readonly LIGHT_YELLOW: "lightYellow";
+  readonly LIME: "lime";
+  readonly LIME_GREEN: "limeGreen";
+  readonly LINEN: "linen";
+  readonly MAGENTA: "magenta";
+  readonly MAROON: "maroon";
+  readonly MEDIUM_AQUAMARINE: "mediumAquamarine";
+  readonly MEDIUM_BLUE: "mediumBlue";
+  readonly MEDIUM_ORCHID: "mediumOrchid";
+  readonly MEDIUM_PURPLE: "mediumPurple";
+  readonly MEDIUM_SEA_GREEN: "mediumSeaGreen";
+  readonly MEDIUM_SLATE_BLUE: "mediumSlateBlue";
+  readonly MEDIUM_SPRING_GREEN: "mediumSpringGreen";
+  readonly MEDIUM_TURQUOISE: "mediumTurquoise";
+  readonly MEDIUM_VIOLET_RED: "mediumVioletRed";
+  readonly MIDNIGHT_BLUE: "midnightBlue";
+  readonly MINT_CREAM: "mintCream";
+  readonly MISTY_ROSE: "mistyRose";
+  readonly MOCCASIN: "moccasin";
+  readonly NAVAJO_WHITE: "navajoWhite";
+  readonly NAVY: "navy";
+  readonly OLD_LACE: "oldLace";
+  readonly OLIVE: "olive";
+  readonly OLIVE_DRAB: "oliveDrab";
+  readonly ORANGE: "orange";
+  readonly ORANGE_RED: "orangeRed";
+  readonly ORCHID: "orchid";
+  readonly PALE_GOLDENROD: "paleGoldenrod";
+  readonly PALE_GREEN: "paleGreen";
+  readonly PALE_TURQUOISE: "paleTurquoise";
+  readonly PALE_VIOLET_RED: "paleVioletRed";
+  readonly PAPAYA_WHIP: "papayaWhip";
+  readonly PEACH_PUFF: "peachPuff";
+  readonly PERU: "peru";
+  readonly PINK: "pink";
+  readonly PLUM: "plum";
+  readonly POWDER_BLUE: "powderBlue";
+  readonly PURPLE: "purple";
+  readonly RED: "red";
+  readonly ROSY_BROWN: "rosyBrown";
+  readonly ROYAL_BLUE: "royalBlue";
+  readonly SADDLE_BROWN: "saddleBrown";
+  readonly SALMON: "salmon";
+  readonly SANDY_BROWN: "sandyBrown";
+  readonly SEA_GREEN: "seaGreen";
+  readonly SEA_SHELL: "seaShell";
+  readonly SIENNA: "sienna";
+  readonly SILVER: "silver";
+  readonly SKY_BLUE: "skyBlue";
+  readonly SLATE_BLUE: "slateBlue";
+  readonly SLATE_GRAY: "slateGray";
+  readonly SLATE_GREY: "slateGrey";
+  readonly SNOW: "snow";
+  readonly SPRING_GREEN: "springGreen";
+  readonly STEEL_BLUE: "steelBlue";
+  readonly TAN: "tan";
+  readonly TEAL: "teal";
+  readonly THISTLE: "thistle";
+  readonly TOMATO: "tomato";
+  readonly TURQUOISE: "turquoise";
+  readonly VIOLET: "violet";
+  readonly WHEAT: "wheat";
+  readonly WHITE: "white";
+  readonly WHITE_SMOKE: "whiteSmoke";
+  readonly YELLOW: "yellow";
+  readonly YELLOW_GREEN: "yellowGreen";
+};
+/**
+ * Options for preset color.
+ */
+interface PresetColorOptions {
+  /** Preset color value */
+  readonly value: (typeof PresetColor)[keyof typeof PresetColor];
+  /** Optional color transforms */
+  readonly transforms?: ColorTransformOptions;
+}
+/**
+ * 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>
+ * ```
+ */
+declare const createPresetColor: (options: PresetColorOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/color/rgb-color.d.ts
+/**
+ * Options for RGB color.
+ */
+interface RgbColorOptions {
+  /** Hex color value (e.g., "FF0000" for red) */
+  readonly value: string;
+  /** Optional color transforms */
+  readonly transforms?: ColorTransformOptions;
+}
+/**
+ * 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 } });
+ * ```
+ */
+declare const createRgbColor: (options: RgbColorOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/color/sc-rgb-color.d.ts
+/**
+ * Options for scRGB color.
+ */
+interface ScRgbColorOptions {
+  /** Red percentage (e.g., "50%" or "100%") */
+  readonly r: string;
+  /** Green percentage (e.g., "50%" or "100%") */
+  readonly g: string;
+  /** Blue percentage (e.g., "50%" or "100%") */
+  readonly b: string;
+  /** Optional color transforms */
+  readonly transforms?: ColorTransformOptions;
+}
+/**
+ * Creates an scRGB color element.
+ *
+ * Specifies a color using percentage-based RGB values.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_ScRgbColor">
+ *   <xsd:sequence>
+ *     <xsd:group ref="EG_ColorTransform" minOccurs="0" maxOccurs="unbounded"/>
+ *   </xsd:sequence>
+ *   <xsd:attribute name="r" type="ST_Percentage" use="required"/>
+ *   <xsd:attribute name="g" type="ST_Percentage" use="required"/>
+ *   <xsd:attribute name="b" type="ST_Percentage" use="required"/>
+ * </xsd:complexType>
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const redColor = createScRgbColor({ r: "100%", g: "0%", b: "0%" });
+ * // With alpha transform
+ * const semiRed = createScRgbColor({ r: "100%", g: "0%", b: "0%", transforms: { alpha: 50000 } });
+ * ```
+ */
+declare const createScRgbColor: (options: ScRgbColorOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/color/scheme-color.d.ts
+/**
+ * Options for scheme color.
+ */
+interface SchemeColorOptions {
+  /** Scheme color value */
+  readonly value: (typeof SchemeColor)[keyof typeof SchemeColor];
+  /** Optional color transforms */
+  readonly transforms?: ColorTransformOptions;
+}
+/**
+ * Scheme color values for theme-based colors.
+ *
+ * These values reference colors defined in the document's color scheme/theme.
+ */
+declare const SchemeColor: {
+  /** Background color 1 */readonly BG1: "bg1"; /** Text color 1 */
+  readonly TX1: "tx1"; /** Background color 2 */
+  readonly BG2: "bg2"; /** Text color 2 */
+  readonly TX2: "tx2"; /** Accent color 1 */
+  readonly ACCENT1: "accent1"; /** Accent color 2 */
+  readonly ACCENT2: "accent2"; /** Accent color 3 */
+  readonly ACCENT3: "accent3"; /** Accent color 4 */
+  readonly ACCENT4: "accent4"; /** Accent color 5 */
+  readonly ACCENT5: "accent5"; /** Accent color 6 */
+  readonly ACCENT6: "accent6"; /** Hyperlink color */
+  readonly HLINK: "hlink"; /** Followed hyperlink color */
+  readonly FOLHLINK: "folHlink"; /** Dark color 1 */
+  readonly DK1: "dk1"; /** Light color 1 */
+  readonly LT1: "lt1"; /** Dark color 2 */
+  readonly DK2: "dk2"; /** Light color 2 */
+  readonly LT2: "lt2"; /** Placeholder color */
+  readonly 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 },
+ * });
+ * ```
+ */
+declare const createSchemeColor: (options: SchemeColorOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/color/system-color.d.ts
+/**
+ * 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>
+ * ```
+ */
+declare const SystemColor: {
+  readonly SCROLL_BAR: "scrollBar";
+  readonly BACKGROUND: "background";
+  readonly ACTIVE_CAPTION: "activeCaption";
+  readonly INACTIVE_CAPTION: "inactiveCaption";
+  readonly MENU: "menu";
+  readonly WINDOW: "window";
+  readonly WINDOW_FRAME: "windowFrame";
+  readonly MENU_TEXT: "menuText";
+  readonly WINDOW_TEXT: "windowText";
+  readonly CAPTION_TEXT: "captionText";
+  readonly ACTIVE_BORDER: "activeBorder";
+  readonly INACTIVE_BORDER: "inactiveBorder";
+  readonly APP_WORKSPACE: "appWorkspace";
+  readonly HIGHLIGHT: "highlight";
+  readonly HIGHLIGHT_TEXT: "highlightText";
+  readonly BTN_FACE: "btnFace";
+  readonly BTN_SHADOW: "btnShadow";
+  readonly GRAY_TEXT: "grayText";
+  readonly BTN_TEXT: "btnText";
+  readonly INACTIVE_CAPTION_TEXT: "inactiveCaptionText";
+  readonly BTN_HIGHLIGHT: "btnHighlight";
+  readonly THREE_D_DK_SHADOW: "3dDkShadow";
+  readonly THREE_D_LIGHT: "3dLight";
+  readonly INFO_TEXT: "infoText";
+  readonly INFO_BK: "infoBk";
+  readonly HOT_LIGHT: "hotLight";
+  readonly GRADIENT_ACTIVE_CAPTION: "gradientActiveCaption";
+  readonly GRADIENT_INACTIVE_CAPTION: "gradientInactiveCaption";
+  readonly MENU_HIGHLIGHT: "menuHighlight";
+  readonly MENU_BAR: "menuBar";
+};
+/**
+ * Options for system color.
+ */
+interface SystemColorOptions {
+  /** System color value */
+  readonly value: (typeof SystemColor)[keyof typeof SystemColor];
+  /** Last known RGB color value (optional fallback) */
+  readonly lastClr?: string;
+  /** Optional color transforms */
+  readonly transforms?: ColorTransformOptions;
+}
+/**
+ * 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>
+ * ```
+ */
+declare const createSystemColor: (options: SystemColorOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/color/solid-fill.d.ts
+/**
+ * Union type for all color options supported by solid fill.
+ *
+ * Extends the original pattern with additional color types:
+ * RGB, scheme, HSL, system, and preset colors.
+ */
+type SolidFillOptions = ScRgbColorOptions | RgbColorOptions | SchemeColorOptions | HslColorOptions | SystemColorOptions | PresetColorOptions;
+declare const createColorElement: (color: SolidFillOptions) => XmlComponent;
+/**
+ * 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, saturation: 100000, luminance: 50000 });
+ * ```
+ */
+declare const createSolidFill: (options: SolidFillOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/blip/blip-effects.d.ts
+/**
+ * Options for luminance (brightness/contrast) effect.
+ *
+ * ## XSD: CT_LuminanceEffect
+ * ```xml
+ * <xsd:attribute name="bright" type="ST_FixedPercentage" default="0%"/>
+ * <xsd:attribute name="contrast" type="ST_FixedPercentage" default="0%"/>
+ * ```
+ */
+interface LuminanceEffectOptions$1 {
+  /** Brightness adjustment in percentage points (-100 to 100). Default 0. */
+  readonly bright?: number;
+  /** Contrast adjustment in percentage points (-100 to 100). Default 0. */
+  readonly contrast?: number;
+}
+/**
+ * Options for HSL effect.
+ *
+ * ## XSD: CT_HSLEffect
+ * ```xml
+ * <xsd:attribute name="hue" type="ST_PositiveFixedAngle" default="0"/>
+ * <xsd:attribute name="sat" type="ST_FixedPercentage" default="0%"/>
+ * <xsd:attribute name="lum" type="ST_FixedPercentage" default="0%"/>
+ * ```
+ */
+interface HSLEffectOptions$1 {
+  /** Hue rotation in 60000ths of a degree. Default 0. */
+  readonly hue?: number;
+  /** Saturation adjustment in percentage points (-100 to 100). Default 0. */
+  readonly saturation?: number;
+  /** Luminance adjustment in percentage points (-100 to 100). Default 0. */
+  readonly luminance?: number;
+}
+/**
+ * Options for tint effect.
+ *
+ * ## XSD: CT_TintEffect
+ * ```xml
+ * <xsd:attribute name="hue" type="ST_PositiveFixedAngle" default="0"/>
+ * <xsd:attribute name="amt" type="ST_FixedPercentage" default="0%"/>
+ * ```
+ */
+interface TintEffectOptions$1 {
+  /** Hue in 60000ths of a degree. Default 0. */
+  readonly hue?: number;
+  /** Amount in percentage points (0 to 100). Default 0. */
+  readonly amount?: number;
+}
+/**
+ * Options for duotone effect.
+ *
+ * ## XSD: CT_DuotoneEffect
+ * ```xml
+ * <xsd:group ref="EG_ColorChoice" minOccurs="2" maxOccurs="2"/>
+ * ```
+ */
+interface DuotoneEffectOptions$1 {
+  /** First color (dark). */
+  readonly color1: SolidFillOptions;
+  /** Second color (light). */
+  readonly color2: SolidFillOptions;
+}
+/**
+ * Options for biLevel (black & white threshold) effect.
+ *
+ * ## XSD: CT_BiLevelEffect
+ * ```xml
+ * <xsd:attribute name="thresh" type="ST_PositiveFixedPercentage" use="required"/>
+ * ```
+ */
+interface BiLevelEffectOptions {
+  /** Threshold percentage (0 to 100). Pixels above are white, below are black. */
+  readonly threshold: number;
+}
+/**
+ * Options for alpha replace effect.
+ *
+ * ## XSD: CT_AlphaReplaceEffect
+ * ```xml
+ * <xsd:attribute name="a" type="ST_PositiveFixedPercentage" use="required"/>
+ * ```
+ */
+interface AlphaReplaceEffectOptions$1 {
+  /** Alpha percentage (0 = fully transparent, 100 = fully opaque). */
+  readonly amount: number;
+}
+/**
+ * Options for alpha bi-level effect.
+ *
+ * ## XSD: CT_AlphaBiLevelEffect
+ * ```xml
+ * <xsd:attribute name="thresh" type="ST_PositiveFixedPercentage" use="required"/>
+ * ```
+ */
+interface AlphaBiLevelEffectOptions$1 {
+  /** Threshold percentage (0 to 100). Alpha above is fully opaque, below is fully transparent. */
+  readonly threshold: number;
+}
+/**
+ * Options for alpha modulate fixed effect.
+ *
+ * ## XSD: CT_AlphaModulateFixedEffect
+ * ```xml
+ * <xsd:attribute name="amt" type="ST_PositivePercentage" default="100%"/>
+ * ```
+ */
+interface AlphaModulateFixedEffectOptions$1 {
+  /** Alpha amount in percentage (0 to 100). Default 100. */
+  readonly amount?: number;
+}
+/**
+ * Options for color change effect.
+ *
+ * ## XSD: CT_ColorChangeEffect
+ * ```xml
+ * <xsd:element name="clrFrom" type="CT_Color"/>
+ * <xsd:element name="clrTo" type="CT_Color"/>
+ * <xsd:attribute name="useA" type="xsd:boolean" default="true"/>
+ * ```
+ */
+interface ColorChangeEffectOptions$1 {
+  /** Source color to change from. */
+  readonly from: SolidFillOptions;
+  /** Target color to change to. */
+  readonly to: SolidFillOptions;
+  /** Whether to use alpha channel. Default true. */
+  readonly useAlpha?: boolean;
+}
+/**
+ * Options for color replace effect.
+ *
+ * ## XSD: CT_ColorReplaceEffect
+ * ```xml
+ * <xsd:group ref="EG_ColorChoice" minOccurs="1" maxOccurs="1"/>
+ * ```
+ */
+interface ColorReplaceEffectOptions {
+  /** Replacement color. */
+  readonly color: SolidFillOptions;
+}
+/**
+ * Options for blur effect on blip.
+ *
+ * ## XSD: CT_BlurEffect
+ * ```xml
+ * <xsd:attribute name="rad" type="ST_PositiveCoordinate" default="0"/>
+ * <xsd:attribute name="grow" type="xsd:boolean" default="true"/>
+ * ```
+ */
+interface BlipBlurEffectOptions {
+  /** Blur radius in EMUs. Default 0. */
+  readonly radius?: number;
+  /** Whether to grow the blur boundary. Default true. */
+  readonly grow?: boolean;
+}
+/**
+ * All blip image adjustment effects.
+ */
+interface BlipEffectsOptions {
+  /** Grayscale effect (no options needed). */
+  readonly grayscale?: boolean;
+  /** Luminance (brightness/contrast) effect. */
+  readonly luminance?: LuminanceEffectOptions$1;
+  /** HSL adjustment effect. */
+  readonly hsl?: HSLEffectOptions$1;
+  /** Tint effect. */
+  readonly tint?: TintEffectOptions$1;
+  /** Duotone effect (two-color mapping). */
+  readonly duotone?: DuotoneEffectOptions$1;
+  /** Black & white threshold effect. */
+  readonly biLevel?: BiLevelEffectOptions;
+  /** Alpha ceiling effect (no options needed). */
+  readonly alphaCeiling?: boolean;
+  /** Alpha floor effect (no options needed). */
+  readonly alphaFloor?: boolean;
+  /** Alpha inverse effect (with optional color). */
+  readonly alphaInverse?: SolidFillOptions;
+  /** Alpha modulate fixed effect. */
+  readonly alphaModFix?: AlphaModulateFixedEffectOptions$1;
+  /** Alpha replace effect. */
+  readonly alphaRepl?: AlphaReplaceEffectOptions$1;
+  /** Alpha bi-level effect. */
+  readonly alphaBiLevel?: AlphaBiLevelEffectOptions$1;
+  /** Color change effect. */
+  readonly colorChange?: ColorChangeEffectOptions$1;
+  /** Color replace effect. */
+  readonly colorRepl?: ColorReplaceEffectOptions;
+  /** Blur effect on blip. */
+  readonly blur?: BlipBlurEffectOptions;
+}
+/**
+ * Creates blip effect elements from BlipEffectsOptions.
+ *
+ * @returns Array of XML components representing blip effects
+ */
+declare const createBlipEffects: (options: BlipEffectsOptions) => XmlComponent[];
+//#endregion
+//#region src/drawingml/blip/source-rectangle.d.ts
+/**
+ * Options for source rectangle cropping.
+ *
+ * Each value is a percentage (0-100000) of the image dimension to crop.
+ * The values represent the inset from each edge.
+ */
+interface SourceRectangleOptions {
+  /** Left inset percentage (0-100000) */
+  readonly left?: number;
+  /** Top inset percentage (0-100000) */
+  readonly top?: number;
+  /** Right inset percentage (0-100000) */
+  readonly right?: number;
+  /** Bottom inset percentage (0-100000) */
+  readonly bottom?: number;
+}
+/**
+ * Creates a source rectangle element for blip fill cropping.
+ *
+ * This element specifies a portion of the blip (image) to use as the fill.
+ * When no options are provided, the entire blip is used.
+ *
+ * Reference: ISO/IEC 29500-4, dml-main.xsd, CT_RelativeRect
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_RelativeRect">
+ *   <xsd:attribute name="l" type="ST_Percentage" use="optional" default="0"/>
+ *   <xsd:attribute name="t" type="ST_Percentage" use="optional" default="0"/>
+ *   <xsd:attribute name="r" type="ST_Percentage" use="optional" default="0"/>
+ *   <xsd:attribute name="b" type="ST_Percentage" use="optional" default="0"/>
+ * </xsd:complexType>
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Crop 10% from left and right
+ * createSourceRectangle({ left: 10000, right: 10000 });
+ * ```
+ */
+declare const createSourceRectangle: (options?: SourceRectangleOptions) => BuilderElement<{}>;
+//#endregion
+//#region src/drawingml/blip/tile.d.ts
+/**
+ * Tile flip mode for tiling images.
+ *
+ * Specifies whether the image is flipped along the x-axis, y-axis,
+ * both axes, or not at all when tiling.
+ */
+declare const TileFlipMode$1: {
+  /** No flipping */readonly NONE: "none"; /** Flip along x-axis */
+  readonly X: "x"; /** Flip along y-axis */
+  readonly Y: "y"; /** Flip along both axes */
+  readonly XY: "xy";
+};
+/**
+ * Tile alignment within the shape.
+ *
+ * Specifies the anchor position of the first tile relative to the shape.
+ */
+declare const TileAlignment: {
+  /** Top-left corner */readonly TOP_LEFT: "topLeft"; /** Top center */
+  readonly TOP: "top"; /** Top-right corner */
+  readonly TOP_RIGHT: "topRight"; /** Middle-left */
+  readonly LEFT: "left"; /** Center */
+  readonly CENTER: "center"; /** Middle-right */
+  readonly RIGHT: "right"; /** Bottom-left corner */
+  readonly BOTTOM_LEFT: "bottomLeft"; /** Bottom center */
+  readonly BOTTOM: "bottom"; /** Bottom-right corner */
+  readonly BOTTOM_RIGHT: "bottomRight";
+};
+/**
+ * Options for tile fill mode.
+ *
+ * Configures how an image is tiled (repeated) to fill a shape.
+ */
+interface TileOptions {
+  /** Horizontal offset for the tile origin (in EMUs) */
+  readonly tx?: number;
+  /** Vertical offset for the tile origin (in EMUs) */
+  readonly ty?: number;
+  /** Horizontal scale factor as percentage (e.g., 50 = 50%) */
+  readonly sx?: number;
+  /** Vertical scale factor as percentage (e.g., 50 = 50%) */
+  readonly sy?: number;
+  /** Flip mode for alternating tiles */
+  readonly flip?: (typeof TileFlipMode$1)[keyof typeof TileFlipMode$1];
+  /** Alignment of the first tile within the shape */
+  readonly align?: (typeof TileAlignment)[keyof typeof TileAlignment];
+}
+/**
+ * Creates a tile fill mode element for blip fills.
+ *
+ * When a blip fill uses tile mode, the image is repeated (tiled) to fill
+ * the shape instead of being stretched. This element controls the tiling
+ * parameters such as offset, scale, flip, and alignment.
+ *
+ * Reference: ISO/IEC 29500-4, dml-main.xsd, CT_TileInfoProperties
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_TileInfoProperties">
+ *   <xsd:attribute name="tx" type="ST_Coordinate" use="optional"/>
+ *   <xsd:attribute name="ty" type="ST_Coordinate" use="optional"/>
+ *   <xsd:attribute name="sx" type="ST_Percentage" use="optional"/>
+ *   <xsd:attribute name="sy" type="ST_Percentage" use="optional"/>
+ *   <xsd:attribute name="flip" type="ST_TileFlipMode" default="none"/>
+ *   <xsd:attribute name="algn" type="ST_RectAlignment" use="optional"/>
+ * </xsd:complexType>
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Tile with 50% scale
+ * createTileInfo({ sx: 50, sy: 50 });
+ * // Tile with flip and alignment
+ * createTileInfo({ flip: "XY", align: "CENTER" });
+ * ```
+ */
+declare const createTileInfo: (options?: TileOptions) => BuilderElement<{}>;
+//#endregion
+//#region src/drawingml/fill/gradient-fill.d.ts
+/**
+ * Gradient stop position (0-100000, representing 0%-100%).
+ */
+interface GradientStop {
+  /** Position of the color stop (0-100000) */
+  readonly position: number;
+  /** Color at this stop */
+  readonly color: SolidFillOptions;
+}
+/**
+ * Path shade type for radial gradients.
+ */
+declare const PathShadeType: {
+  /** Follow shape path */readonly SHAPE: "shape"; /** Circular gradient */
+  readonly CIRCLE: "circle"; /** Rectangular gradient */
+  readonly RECT: "rect";
+};
+/**
+ * Tile flip mode for gradient fill.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:simpleType name="ST_TileFlipMode">
+ *   <xsd:restriction base="xsd:string">
+ *     <xsd:enumeration value="none"/>
+ *     <xsd:enumeration value="x"/>
+ *     <xsd:enumeration value="y"/>
+ *     <xsd:enumeration value="xy"/>
+ *   </xsd:restriction>
+ * </xsd:simpleType>
+ * ```
+ */
+declare const TileFlipMode: {
+  /** No flip */readonly NONE: "none"; /** Flip horizontally */
+  readonly X: "x"; /** Flip vertically */
+  readonly Y: "y"; /** Flip both horizontally and vertically */
+  readonly XY: "xy";
+};
+/**
+ * Options for linear gradient shading.
+ */
+interface LinearShadeOptions {
+  /** Angle in 60,000ths of a degree (e.g., 5400000 = 90°) */
+  readonly angle?: number;
+  /** Whether the angle scales with the shape */
+  readonly scaled?: boolean;
+}
+/**
+ * Relative rectangle (CT_RelativeRect) with percentage offsets.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_RelativeRect">
+ *   <xsd:attribute name="l" type="ST_Percentage" default="0%"/>
+ *   <xsd:attribute name="t" type="ST_Percentage" default="0%"/>
+ *   <xsd:attribute name="r" type="ST_Percentage" default="0%"/>
+ *   <xsd:attribute name="b" type="ST_Percentage" default="0%"/>
+ * </xsd:complexType>
+ * ```
+ */
+interface RelativeRect {
+  /** Left offset percentage (e.g., "0%") */
+  readonly left?: string;
+  /** Top offset percentage (e.g., "0%") */
+  readonly top?: string;
+  /** Right offset percentage (e.g., "0%") */
+  readonly right?: string;
+  /** Bottom offset percentage (e.g., "0%") */
+  readonly bottom?: string;
+}
+/**
+ * Options for path (radial) gradient shading.
+ */
+interface PathShadeOptions {
+  /** Path type */
+  readonly path?: (typeof PathShadeType)[keyof typeof PathShadeType];
+  /**
+   * Fill-to rectangle for path gradient.
+   *
+   * Defines the rectangle to which the gradient fills.
+   */
+  readonly fillToRect?: RelativeRect;
+}
+/**
+ * Gradient shade options (linear or path).
+ */
+type GradientShadeOptions = LinearShadeOptions | PathShadeOptions;
+/**
+ * Options for gradient fill.
+ *
+ * ## 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:element name="tileRect" type="CT_RelativeRect" minOccurs="0"/>
+ *   </xsd:sequence>
+ *   <xsd:attribute name="flip" type="ST_TileFlipMode" use="optional"/>
+ *   <xsd:attribute name="rotWithShape" type="xsd:boolean" use="optional"/>
+ * </xsd:complexType>
+ * ```
+ */
+interface GradientFillOptions {
+  /** Gradient color stops (minimum 2) */
+  readonly stops: readonly GradientStop[];
+  /** Shade type (linear or path) */
+  readonly shade?: GradientShadeOptions;
+  /**
+   * Tile flip mode.
+   *
+   * Controls how the gradient is flipped when tiled.
+   */
+  readonly flip?: (typeof TileFlipMode)[keyof typeof TileFlipMode];
+  /**
+   * Tile rectangle for gradient tiling.
+   *
+   * Defines the rectangle used for gradient tiling.
+   */
+  readonly tileRect?: RelativeRect;
+  /** Whether gradient rotates with the shape */
+  readonly rotateWithShape?: boolean;
+}
+/**
+ * Creates a gradient stop element (a:gs).
+ *
+ * @example
+ * ```typescript
+ * createGradientStop({ position: 0, color: { value: "FF0000" } });
+ * createGradientStop({ position: 100000, color: { value: "0000FF" } });
+ * ```
+ */
+declare const createGradientStop: (stop: GradientStop) => XmlComponent;
+/**
+ * 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 },
+ * });
+ * ```
+ */
+declare const createGradientFill: (options: GradientFillOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/fill/fill-options.d.ts
+/**
+ * Gradient stop options (simplified API).
+ * Position is 0-100 (percentage), color is a hex string or SolidFillOptions.
+ */
+interface GradientStopOptions {
+  readonly position: number;
+  readonly color: string | SolidFillOptions;
+}
+/**
+ * Blip fill options (image fill) for DrawingML shapes.
+ */
+interface BlipFillConfigOptions {
+  /** Image data (raw bytes) */
+  readonly data: Uint8Array | ArrayBuffer | Buffer;
+  /** Image type */
+  readonly imageType: "png" | "jpg" | "gif" | "bmp" | "tif" | "ico" | "emf" | "wmf";
+  /** DPI of the image */
+  readonly dpi?: number;
+  /** Whether the fill rotates with the shape */
+  readonly rotWithShape?: boolean;
+  /** Image adjustment effects (brightness, contrast, grayscale, etc.) */
+  readonly blipEffects?: BlipEffectsOptions;
+  /** Source rectangle for cropping */
+  readonly srcRect?: SourceRectangleOptions;
+  /** Tile fill mode (if omitted, defaults to stretch) */
+  readonly tile?: TileOptions;
+}
+/**
+ * Media data extracted from a blip fill, for registration with the document's media store.
+ */
+interface BlipFillMediaData {
+  readonly fileName: string;
+  readonly data: Uint8Array;
+  readonly type: string;
+}
+/**
+ * Fill options — discriminated union for DrawingML EG_FillProperties.
+ *
+ * Supports string shorthand for solid fill (most common case).
+ * Color fields accept hex strings or advanced SolidFillOptions
+ * (scheme color, HSL, etc.).
+ *
+ * @example
+ * // Solid fill (shorthand)
+ * fill: "4472C4"
+ * // Solid fill with scheme color
+ * fill: { type: "solid", color: { value: "accent1" } }
+ * // No fill
+ * fill: { type: "none" }
+ * // Gradient fill — linear
+ * fill: { type: "gradient", angle: 90, stops: [{ position: 0, color: "4472C4" }, { position: 100, color: "ED7D31" }] }
+ * // Gradient fill — path (radial)
+ * fill: { type: "gradient", path: "circle", stops: [{ position: 0, color: "FFFFFF" }, { position: 100, color: "4472C4" }] }
+ * // Gradient fill (core API for advanced options)
+ * fill: { type: "gradient", options: { stops: [...], shade: { angle: 5400000 } } }
+ * // Blip fill (image)
+ * fill: { type: "blip", data: imageBuffer, imageType: "png" }
+ * // Pattern fill
+ * fill: { type: "pattern", pattern: "cross", foregroundColor: "FF0000" }
+ * // Group fill
+ * fill: { type: "group" }
+ */
+type FillOptions = string | {
+  readonly type: "solid";
+  readonly color: string | SolidFillOptions;
+} | {
+  readonly type: "none";
+} | {
+  readonly type: "gradient";
+  readonly angle?: number;
+  readonly scaled?: boolean;
+  readonly path?: "shape" | "circle" | "rect";
+  readonly stops: readonly GradientStopOptions[];
+} | {
+  readonly type: "gradient";
+  readonly options: GradientFillOptions;
+} | ({
+  readonly type: "blip";
+} & BlipFillConfigOptions) | {
+  readonly type: "pattern";
+  readonly pattern: string;
+  readonly foregroundColor?: string | SolidFillOptions;
+  readonly backgroundColor?: string | SolidFillOptions;
+} | {
+  readonly type: "group";
+};
+/**
+ * Extracts media data from a blip fill option, if present.
+ * Returns undefined for non-blip fills.
+ *
+ * The returned data should be registered with the document's media store
+ * during `prepForXml` so the packer can resolve the `{fileName}` placeholder.
+ */
+declare const extractBlipFillMedia: (fill: FillOptions) => BlipFillMediaData | undefined;
+/**
+ * Builds a DrawingML fill XmlComponent from a FillOptions config.
+ */
+declare const buildFill: (options: FillOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/fill/no-fill.d.ts
+/**
+ * Creates a no-fill element.
+ *
+ * Specifies that the outline or shape should have no fill applied.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:element name="noFill" type="CT_Empty"/>
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const noFill = createNoFill();
+ * ```
+ */
+declare const createNoFill: () => XmlComponent;
+//#endregion
+//#region src/drawingml/fill/pattern-fill.d.ts
+/**
+ * Preset pattern values for pattern fill.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:simpleType name="ST_PresetPatternVal">
+ *   <xsd:restriction base="xsd:token">
+ *     <xsd:enumeration value="pct5"/> ... <xsd:enumeration value="zigZag"/>
+ *   </xsd:restriction>
+ * </xsd:simpleType>
+ * ```
+ *
+ * @publicApi
+ */
+declare const PresetPattern: {
+  /** 5% pattern */readonly PCT5: "percent5"; /** 10% pattern */
+  readonly PCT10: "percent10"; /** 20% pattern */
+  readonly PCT20: "percent20"; /** 25% pattern */
+  readonly PCT25: "percent25"; /** 30% pattern */
+  readonly PCT30: "percent30"; /** 40% pattern */
+  readonly PCT40: "percent40"; /** 50% pattern */
+  readonly PCT50: "percent50"; /** 60% pattern */
+  readonly PCT60: "percent60"; /** 70% pattern */
+  readonly PCT70: "percent70"; /** 75% pattern */
+  readonly PCT75: "percent75"; /** 80% pattern */
+  readonly PCT80: "percent80"; /** 90% pattern */
+  readonly PCT90: "percent90"; /** Horizontal lines */
+  readonly HORZ: "horizontal"; /** Vertical lines */
+  readonly VERT: "vertical"; /** Light horizontal lines */
+  readonly LT_HORZ: "lightHorizontal"; /** Light vertical lines */
+  readonly LT_VERT: "lightVertical"; /** Dark horizontal lines */
+  readonly DK_HORZ: "darkHorizontal"; /** Dark vertical lines */
+  readonly DK_VERT: "darkVertical"; /** Narrow horizontal lines */
+  readonly NAR_HORZ: "narrowHorizontal"; /** Narrow vertical lines */
+  readonly NAR_VERT: "narrowVertical"; /** Dashed horizontal lines */
+  readonly DASH_HORZ: "dashedHorizontal"; /** Dashed vertical lines */
+  readonly DASH_VERT: "dashedVertical"; /** Cross pattern (+) */
+  readonly CROSS: "cross"; /** Downward diagonal lines (\) */
+  readonly DN_DIAG: "downDiagonal"; /** Upward diagonal lines (/) */
+  readonly UP_DIAG: "upDiagonal"; /** Light downward diagonal lines */
+  readonly LT_DN_DIAG: "lightDownDiagonal"; /** Light upward diagonal lines */
+  readonly LT_UP_DIAG: "lightUpDiagonal"; /** Dark downward diagonal lines */
+  readonly DK_DN_DIAG: "darkDownDiagonal"; /** Dark upward diagonal lines */
+  readonly DK_UP_DIAG: "darkUpDiagonal"; /** Wide downward diagonal lines */
+  readonly WD_DN_DIAG: "wideDownDiagonal"; /** Wide upward diagonal lines */
+  readonly WD_UP_DIAG: "wideUpDiagonal"; /** Dashed downward diagonal lines */
+  readonly DASH_DN_DIAG: "dashedDownDiagonal"; /** Dashed upward diagonal lines */
+  readonly DASH_UP_DIAG: "dashedUpDiagonal"; /** Diagonal cross pattern (X) */
+  readonly DIAG_CROSS: "diagonalCross"; /** Small checkerboard */
+  readonly SM_CHECK: "smallChecker"; /** Large checkerboard */
+  readonly LG_CHECK: "largeChecker"; /** Small grid */
+  readonly SM_GRID: "smallGrid"; /** Large grid */
+  readonly LG_GRID: "largeGrid"; /** Dot grid */
+  readonly DOT_GRID: "dotGrid"; /** Small confetti */
+  readonly SM_CONFETTI: "smallConfetti"; /** Large confetti */
+  readonly LG_CONFETTI: "largeConfetti"; /** Horizontal brick pattern */
+  readonly HORZ_BRICK: "horizontalBrick"; /** Diagonal brick pattern */
+  readonly DIAG_BRICK: "diagonalBrick"; /** Solid diamond */
+  readonly SOLID_DMND: "solidDiamond"; /** Open diamond */
+  readonly OPEN_DMND: "openDiamond"; /** Dotted diamond */
+  readonly DOT_DMND: "dottedDiamond"; /** Plaid pattern */
+  readonly PLAID: "plaid"; /** Sphere pattern */
+  readonly SPHERE: "sphere"; /** Weave pattern */
+  readonly WEAVE: "weave"; /** Divot pattern */
+  readonly DIVOT: "divot"; /** Shingle pattern */
+  readonly SHINGLE: "shingle"; /** Wave pattern */
+  readonly WAVE: "wave"; /** Trellis pattern */
+  readonly TRELLIS: "trellis"; /** Zigzag pattern */
+  readonly ZIG_ZAG: "zigZag";
+};
+/**
+ * Options for pattern fill.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_PatternFillProperties">
+ *   <xsd:sequence>
+ *     <xsd:element name="fgClr" type="CT_Color" minOccurs="0"/>
+ *     <xsd:element name="bgClr" type="CT_Color" minOccurs="0"/>
+ *   </xsd:sequence>
+ *   <xsd:attribute name="prst" type="ST_PresetPatternVal" use="optional"/>
+ * </xsd:complexType>
+ * ```
+ */
+interface PatternFillOptions {
+  /** Preset pattern type */
+  readonly pattern: (typeof PresetPattern)[keyof typeof PresetPattern];
+  /** Foreground color */
+  readonly foregroundColor?: SolidFillOptions;
+  /** Background color */
+  readonly backgroundColor?: SolidFillOptions;
+}
+/**
+ * Creates a pattern fill element (a:pattFill).
+ *
+ * Specifies a pattern fill using preset patterns with optional
+ * foreground and background colors.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_PatternFillProperties">
+ *   <xsd:sequence>
+ *     <xsd:element name="fgClr" type="CT_Color" minOccurs="0"/>
+ *     <xsd:element name="bgClr" type="CT_Color" minOccurs="0"/>
+ *   </xsd:sequence>
+ *   <xsd:attribute name="prst" type="ST_PresetPatternVal" use="optional"/>
+ * </xsd:complexType>
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Simple crosshatch pattern
+ * createPatternFill({ pattern: PresetPattern.CROSS });
+ * // Pattern with foreground color
+ * createPatternFill({
+ *   pattern: PresetPattern.DIAG_CROSS,
+ *   foregroundColor: { value: "FF0000" },
+ * });
+ * // Pattern with foreground and background colors
+ * createPatternFill({
+ *   pattern: PresetPattern.HORZ,
+ *   foregroundColor: { value: "0000FF" },
+ *   backgroundColor: { value: "FFFF00" },
+ * });
+ * ```
+ */
+declare const createPatternFill: (options: PatternFillOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/fill/group-fill.d.ts
+/**
+ * Creates a group fill element (a:grpFill).
+ *
+ * This element specifies that the shape should inherit its fill
+ * from the parent group shape. This is useful when shapes are
+ * grouped together and should share the same fill.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_GroupFillProperties"/>
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Shape inherits fill from parent group
+ * createGroupFill();
+ * ```
+ */
+declare const createGroupFill: () => XmlComponent;
+//#endregion
+//#region src/drawingml/outline/custom-dash.d.ts
+/**
+ * A single dash stop in a custom dash pattern.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_DashStop">
+ *   <xsd:attribute name="d" type="ST_PositivePercentage" use="required"/>
+ *   <xsd:attribute name="sp" type="ST_PositivePercentage" use="required"/>
+ * </xsd:complexType>
+ * ```
+ *
+ * `ST_PositivePercentage` is a string matching `[0-9]+(\.[0-9]+)?%`
+ * (e.g., `"100%"`, `"500%"`, `"50.5%"`).
+ *
+ * @example
+ * ```typescript
+ * // A dash stop with 500% dash length and 200% space length
+ * { d: "500%", sp: "200%" }
+ * ```
+ */
+interface DashStop {
+  /** Dash length as a percentage of line width (e.g., "500%") */
+  readonly d: string;
+  /** Space length as a percentage of line width (e.g., "200%") */
+  readonly sp: string;
+}
+/**
+ * Creates a custom dash element (a:custDash) for outlines.
+ *
+ * The custom dash element specifies a repeating pattern of dash and space
+ * segments. Each segment is defined by a `DashStop` with dash (`d`) and
+ * space (`sp`) lengths as positive percentages of the line width.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_DashStopList">
+ *   <xsd:sequence>
+ *     <xsd:element name="ds" type="CT_DashStop" minOccurs="0" maxOccurs="unbounded"/>
+ *   </xsd:sequence>
+ * </xsd:complexType>
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Simple dash pattern
+ * createCustomDash([
+ *   { d: "500%", sp: "200%" },
+ * ]);
+ *
+ * // Complex alternating pattern
+ * createCustomDash([
+ *   { d: "500%", sp: "200%" },
+ *   { d: "100%", sp: "200%" },
+ * ]);
+ * ```
+ */
+declare const createCustomDash: (stops: readonly DashStop[]) => XmlComponent;
+//#endregion
+//#region src/drawingml/outline/line-end.d.ts
+/**
+ * Line end types (arrow head styles).
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:simpleType name="ST_LineEndType">
+ *   <xsd:restriction base="xsd:token">
+ *     <xsd:enumeration value="none"/>
+ *     <xsd:enumeration value="triangle"/>
+ *     <xsd:enumeration value="stealth"/>
+ *     <xsd:enumeration value="diamond"/>
+ *     <xsd:enumeration value="oval"/>
+ *     <xsd:enumeration value="arrow"/>
+ *   </xsd:restriction>
+ * </xsd:simpleType>
+ * ```
+ *
+ * @publicApi
+ */
+declare const LineEndType: {
+  /** No line end */readonly NONE: "none"; /** Triangle arrow */
+  readonly TRIANGLE: "triangle"; /** Stealth arrow (filled triangle) */
+  readonly STEALTH: "stealth"; /** Diamond shape */
+  readonly DIAMOND: "diamond"; /** Oval shape */
+  readonly OVAL: "oval"; /** Simple arrow */
+  readonly ARROW: "arrow";
+};
+/**
+ * Line end width options.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:simpleType name="ST_LineEndWidth">
+ *   <xsd:restriction base="xsd:token">
+ *     <xsd:enumeration value="sm"/>
+ *     <xsd:enumeration value="med"/>
+ *     <xsd:enumeration value="lg"/>
+ *   </xsd:restriction>
+ * </xsd:simpleType>
+ * ```
+ *
+ * @publicApi
+ */
+declare const LineEndWidth: {
+  /** Small width */readonly SMALL: "small"; /** Medium width */
+  readonly MEDIUM: "medium"; /** Large width */
+  readonly LARGE: "large";
+};
+/**
+ * Line end length options.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:simpleType name="ST_LineEndLength">
+ *   <xsd:restriction base="xsd:token">
+ *     <xsd:enumeration value="sm"/>
+ *     <xsd:enumeration value="med"/>
+ *     <xsd:enumeration value="lg"/>
+ *   </xsd:restriction>
+ * </xsd:simpleType>
+ * ```
+ *
+ * @publicApi
+ */
+declare const LineEndLength: {
+  /** Small length */readonly SMALL: "small"; /** Medium length */
+  readonly MEDIUM: "medium"; /** Large length */
+  readonly LARGE: "large";
+};
+/**
+ * Options for line end (arrow) properties.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_LineEndProperties">
+ *   <xsd:attribute name="type" type="ST_LineEndType" use="optional" default="none"/>
+ *   <xsd:attribute name="w" type="ST_LineEndWidth" use="optional"/>
+ *   <xsd:attribute name="len" type="ST_LineEndLength" use="optional"/>
+ * </xsd:complexType>
+ * ```
+ */
+interface LineEndOptions {
+  /** Arrow/head type */
+  readonly type: (typeof LineEndType)[keyof typeof LineEndType];
+  /** Arrow width */
+  readonly width?: (typeof LineEndWidth)[keyof typeof LineEndWidth];
+  /** Arrow length */
+  readonly length?: (typeof LineEndLength)[keyof typeof LineEndLength];
+}
+/**
+ * Creates a line end element (a:headEnd or a:tailEnd).
+ *
+ * @example
+ * ```typescript
+ * // Stealth arrow at start, medium size
+ * createLineEnd("a:headEnd", { type: "STEALTH", width: "MEDIUM", length: "MEDIUM" });
+ * // Triangle arrow at end
+ * createLineEnd("a:tailEnd", { type: "TRIANGLE" });
+ * ```
+ */
+declare const createLineEnd: (name: string, options: LineEndOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/outline/outline.d.ts
+/**
+ * Line cap styles for outline endpoints.
+ *
+ * Defines how the ends of a line are rendered.
+ */
+declare const LineCap: {
+  /** Round cap style */readonly ROUND: "round"; /** Square cap style */
+  readonly SQUARE: "square"; /** Flat cap style */
+  readonly FLAT: "flat";
+};
+/**
+ * Compound line types for outlines.
+ *
+ * Defines the structure of compound lines (single, double, etc.).
+ */
+declare const CompoundLine: {
+  /** Single line */readonly SINGLE: "single"; /** Double line */
+  readonly DOUBLE: "double"; /** Thick-thin double line */
+  readonly THICK_THIN: "thickThin"; /** Thin-thick double line */
+  readonly THIN_THICK: "thinThick"; /** Triple line */
+  readonly TRI: "triple";
+};
+/**
+ * Pen alignment options for outline positioning.
+ *
+ * Defines how the outline is aligned relative to the shape edge.
+ */
+declare const PenAlignment: {
+  /** Center alignment */readonly CENTER: "center"; /** Inset alignment */
+  readonly INSET: "inside";
+};
+/**
+ * Preset dash styles for outlines.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <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>
+ * ```
+ */
+declare const PresetDash: {
+  readonly SOLID: "solid";
+  readonly DOT: "dot";
+  readonly DASH: "dash";
+  readonly LG_DASH: "lgDash";
+  readonly DASH_DOT: "dashDot";
+  readonly LG_DASH_DOT: "lgDashDot";
+  readonly LG_DASH_DOT_DOT: "lgDashDotDot";
+  readonly SYS_DASH: "sysDash";
+  readonly SYS_DOT: "sysDot";
+  readonly SYS_DASH_DOT: "sysDashDot";
+  readonly SYS_DASH_DOT_DOT: "sysDashDotDot";
+};
+/**
+ * Line join styles.
+ */
+declare const LineJoin: {
+  readonly ROUND: "round";
+  readonly BEVEL: "bevel";
+  readonly MITER: "miter";
+};
+/**
+ * Attributes for configuring outline properties.
+ */
+interface OutlineAttributes {
+  /** Line width in EMUs (English Metric Units) */
+  readonly width?: number;
+  /** Line cap style */
+  readonly cap?: (typeof LineCap)[keyof typeof LineCap];
+  /** Compound line type */
+  readonly compoundLine?: (typeof CompoundLine)[keyof typeof CompoundLine];
+  /** Pen alignment */
+  readonly align?: (typeof PenAlignment)[keyof typeof PenAlignment];
+  /**
+   * Preset dash style.
+   *
+   * Mutually exclusive with `customDash` — only one can be specified.
+   */
+  readonly dash?: (typeof PresetDash)[keyof typeof PresetDash];
+  /**
+   * Custom dash pattern (list of dash/space stops).
+   *
+   * Mutually exclusive with `dash` — only one can be specified.
+   */
+  readonly customDash?: readonly DashStop[];
+  /** Line join style */
+  readonly join?: (typeof LineJoin)[keyof typeof LineJoin];
+  /** Miter limit (only when join is MITER) */
+  readonly miterLimit?: number;
+  /** Line start arrow/head */
+  readonly headEnd?: LineEndOptions;
+  /** Line end arrow/tail */
+  readonly tailEnd?: LineEndOptions;
+}
+/**
+ * Fill properties for outline (EG_LineFillProperties).
+ *
+ * Supports noFill, solidFill, gradFill, and pattFill per XSD.
+ * blipFill and grpFill are not applicable to lines.
+ */
+interface OutlineFillProperties {
+  /** Fill type */
+  readonly type?: "noFill" | "solidFill" | "gradFill" | "pattFill";
+  /** Color definition (required when type is "solidFill") */
+  readonly color?: SolidFillOptions;
+  /** Gradient fill options (required when type is "gradFill") */
+  readonly gradientFill?: GradientFillOptions;
+  /** Pattern fill options (required when type is "pattFill") */
+  readonly patternFill?: PatternFillOptions;
+}
+/**
+ * Complete outline configuration options.
+ *
+ * Combines outline attributes with fill properties.
+ */
+type OutlineOptions = OutlineAttributes & OutlineFillProperties;
+/**
+ * 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, dash, join, and fill.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_LineProperties">
+ *   <xsd:sequence>
+ *     <xsd:group ref="EG_FillProperties" minOccurs="0"/>
+ *     <xsd:group ref="EG_LineDashProperties" minOccurs="0"/>
+ *     <xsd:group ref="EG_LineJoinProperties" minOccurs="0"/>
+ *   </xsd:sequence>
+ *   <xsd:attribute name="w" use="optional" type="a:ST_LineWidth"/>
+ *   <xsd:attribute name="cap" use="optional" type="ST_LineCap"/>
+ *   <xsd:attribute name="cmpd" use="optional" type="ST_CompoundLine"/>
+ *   <xsd:attribute name="algn" use="optional" type="ST_PenAlignment"/>
+ * </xsd:complexType>
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Outline with RGB color and dash
+ * const outline = createOutline({
+ *   width: 9525,
+ *   type: "solidFill",
+ *   color: { value: "FF0000" },
+ *   dash: "DASH",
+ * });
+ * ```
+ */
+declare const createOutline: (options: OutlineOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/effects/fill-overlay.d.ts
+/**
+ * Blend modes for fill overlay effect.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:simpleType name="ST_BlendMode">
+ *   <xsd:restriction base="xsd:token">
+ *     <xsd:enumeration value="over"/>
+ *     <xsd:enumeration value="mult"/>
+ *     <xsd:enumeration value="screen"/>
+ *     <xsd:enumeration value="darken"/>
+ *     <xsd:enumeration value="lighten"/>
+ *   </xsd:restriction>
+ * </xsd:simpleType>
+ * ```
+ */
+declare const BlendMode: {
+  /** Over blend mode */readonly OVER: "over"; /** Multiply blend mode */
+  readonly MULTIPLY: "multiply"; /** Screen blend mode */
+  readonly SCREEN: "screen"; /** Darken blend mode */
+  readonly DARKEN: "darken"; /** Lighten blend mode */
+  readonly LIGHTEN: "lighten";
+};
+/**
+ * Options for fill overlay effect.
+ */
+interface FillOverlayEffectOptions {
+  /** Blend mode (required) */
+  readonly blend: (typeof BlendMode)[keyof typeof BlendMode];
+  /** Solid fill color */
+  readonly solidFill?: SolidFillOptions;
+  /** Gradient fill */
+  readonly gradientFill?: GradientFillOptions;
+  /** Pattern fill */
+  readonly patternFill?: PatternFillOptions;
+  /** Group fill (inherit from parent) */
+  readonly groupFill?: boolean;
+  /** No fill */
+  readonly noFill?: boolean;
+}
+/**
+ * Creates a fill overlay effect element.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_FillOverlayEffect">
+ *   <xsd:sequence>
+ *     <xsd:group ref="EG_FillProperties" minOccurs="1" maxOccurs="1"/>
+ *   </xsd:sequence>
+ *   <xsd:attribute name="blend" type="ST_BlendMode" use="required"/>
+ * </xsd:complexType>
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Solid fill overlay
+ * const fillOverlay = createFillOverlayEffect({
+ *   blend: BlendMode.MULTIPLY,
+ *   solidFill: { value: "FF0000" },
+ * });
+ *
+ * // Gradient fill overlay
+ * const fillOverlay = createFillOverlayEffect({
+ *   blend: BlendMode.SCREEN,
+ *   gradientFill: { type: "linear", stops: [...] },
+ * });
+ * ```
+ */
+declare const createFillOverlayEffect: (options: FillOverlayEffectOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/effects/glow.d.ts
+/**
+ * Options for glow effect.
+ */
+interface GlowEffectOptions {
+  /** Glow radius in EMUs */
+  readonly radius?: number;
+  /** Glow color */
+  readonly color: SolidFillOptions;
+}
+/**
+ * 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>
+ * ```
+ */
+declare const createGlowEffect: (options: GlowEffectOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/effects/inner-shadow.d.ts
+/**
+ * Options for inner shadow effect.
+ */
+interface InnerShadowEffectOptions {
+  /** Blur radius in EMUs */
+  readonly blurRadius?: number;
+  /** Distance from shape edge in EMUs */
+  readonly distance?: number;
+  /** Direction angle in 60,000ths of a degree */
+  readonly direction?: number;
+  /** Shadow color */
+  readonly color: SolidFillOptions;
+}
+/**
+ * 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>
+ * ```
+ */
+declare const createInnerShadowEffect: (options: InnerShadowEffectOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/effects/outer-shadow.d.ts
+/**
+ * Rectangle alignment for shadow positioning.
+ */
+declare const RectAlignment: {
+  readonly TOP_LEFT: "topLeft";
+  readonly TOP: "top";
+  readonly TOP_RIGHT: "topRight";
+  readonly LEFT: "left";
+  readonly CENTER: "center";
+  readonly RIGHT: "right";
+  readonly BOTTOM_LEFT: "bottomLeft";
+  readonly BOTTOM: "bottom";
+  readonly BOTTOM_RIGHT: "bottomRight";
+};
+/**
+ * Options for outer shadow effect.
+ */
+interface OuterShadowEffectOptions {
+  /** Blur radius in EMUs */
+  readonly blurRadius?: number;
+  /** Distance from shape in EMUs */
+  readonly distance?: number;
+  /** Direction angle in 60,000ths of a degree */
+  readonly direction?: number;
+  /** Horizontal scale percentage (e.g., 100000 = 100%) */
+  readonly scaleX?: number;
+  /** Vertical scale percentage */
+  readonly scaleY?: number;
+  /** Horizontal skew angle in 60,000ths of a degree */
+  readonly skewX?: number;
+  /** Vertical skew angle */
+  readonly skewY?: number;
+  /** Shadow alignment */
+  readonly alignment?: (typeof RectAlignment)[keyof typeof RectAlignment];
+  /** Whether shadow rotates with shape */
+  readonly rotWithShape?: boolean;
+  /** Shadow color */
+  readonly color: SolidFillOptions;
+}
+/**
+ * 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>
+ * ```
+ */
+declare const createOuterShadowEffect: (options: OuterShadowEffectOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/effects/preset-shadow.d.ts
+/**
+ * Preset shadow types (20 variations).
+ *
+ * Reference: ISO/IEC 29500-4, dml-main.xsd, ST_PresetShadowVal
+ */
+declare const PresetShadowVal: {
+  readonly SHDW1: "shadow1";
+  readonly SHDW2: "shadow2";
+  readonly SHDW3: "shadow3";
+  readonly SHDW4: "shadow4";
+  readonly SHDW5: "shadow5";
+  readonly SHDW6: "shadow6";
+  readonly SHDW7: "shadow7";
+  readonly SHDW8: "shadow8";
+  readonly SHDW9: "shadow9";
+  readonly SHDW10: "shadow10";
+  readonly SHDW11: "shadow11";
+  readonly SHDW12: "shadow12";
+  readonly SHDW13: "shadow13";
+  readonly SHDW14: "shadow14";
+  readonly SHDW15: "shadow15";
+  readonly SHDW16: "shadow16";
+  readonly SHDW17: "shadow17";
+  readonly SHDW18: "shadow18";
+  readonly SHDW19: "shadow19";
+  readonly SHDW20: "shadow20";
+};
+/**
+ * Options for preset shadow effect.
+ */
+interface PresetShadowEffectOptions {
+  /** Preset shadow type (required) */
+  readonly preset: (typeof PresetShadowVal)[keyof typeof PresetShadowVal];
+  /** Distance from shape in EMUs */
+  readonly distance?: number;
+  /** Direction angle in 60,000ths of a degree */
+  readonly direction?: number;
+  /** Shadow color */
+  readonly color: SolidFillOptions;
+}
+/**
+ * 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>
+ * ```
+ */
+declare const createPresetShadowEffect: (options: PresetShadowEffectOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/effects/reflection.d.ts
+/**
+ * Options for reflection effect.
+ *
+ * All properties are optional with XSD defaults.
+ */
+interface ReflectionEffectOptions {
+  /** Blur radius in EMUs */
+  readonly blurRadius?: number;
+  /** Start opacity (fixed percentage, e.g., 100000 = 100%) */
+  readonly startAlpha?: number;
+  /** Start position (fixed percentage) */
+  readonly startPosition?: number;
+  /** End opacity (fixed percentage) */
+  readonly endAlpha?: number;
+  /** End position (fixed percentage) */
+  readonly endPosition?: number;
+  /** Distance from shape in EMUs */
+  readonly distance?: number;
+  /** Direction angle in 60,000ths of a degree */
+  readonly direction?: number;
+  /** Fade direction angle in 60,000ths of a degree */
+  readonly fadeDirection?: number;
+  /** Horizontal scale percentage */
+  readonly scaleX?: number;
+  /** Vertical scale percentage */
+  readonly scaleY?: number;
+  /** Horizontal skew angle */
+  readonly skewX?: number;
+  /** Vertical skew angle */
+  readonly skewY?: number;
+  /** Alignment */
+  readonly alignment?: string;
+  /** Whether reflection rotates with shape */
+  readonly rotWithShape?: boolean;
+}
+/**
+ * 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>
+ * ```
+ */
+declare const createReflectionEffect: (options?: ReflectionEffectOptions) => BuilderElement<{}>;
+//#endregion
+//#region src/drawingml/effects/effect-list.d.ts
+/**
+ * Blur effect options.
+ */
+interface BlurEffectOptions {
+  /** Blur radius in EMUs */
+  readonly radius?: number;
+  /** Whether to grow the shape boundary */
+  readonly grow?: boolean;
+}
+/**
+ * Options for the effect list container.
+ *
+ * Each property corresponds to an optional child effect element.
+ * Only specified effects will be included in the output.
+ */
+interface EffectListOptions {
+  /** Blur effect */
+  readonly blur?: BlurEffectOptions;
+  /** Fill overlay effect */
+  readonly fillOverlay?: FillOverlayEffectOptions;
+  /** Glow effect */
+  readonly glow?: GlowEffectOptions;
+  /** Inner shadow effect */
+  readonly innerShadow?: InnerShadowEffectOptions;
+  /** Outer shadow effect */
+  readonly outerShadow?: OuterShadowEffectOptions;
+  /** Preset shadow effect */
+  readonly presetShadow?: PresetShadowEffectOptions;
+  /** Reflection effect (pass object for attributes, or true for defaults) */
+  readonly reflection?: ReflectionEffectOptions | true;
+  /** Soft edge radius in EMUs */
+  readonly softEdge?: number;
+}
+/**
+ * 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>
+ * ```
+ */
+declare const createEffectList: (options: EffectListOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/effects/effect-dag.d.ts
+/**
+ * Effect container type (ST_EffectContainerType).
+ *
+ * Controls how child effects are combined:
+ * - `sib`: sibling effects are applied in parallel
+ * - `tree`: effects are applied sequentially in tree order
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:simpleType name="ST_EffectContainerType">
+ *   <xsd:restriction base="xsd:token">
+ *     <xsd:enumeration value="sib"/>
+ *     <xsd:enumeration value="tree"/>
+ *   </xsd:restriction>
+ * </xsd:simpleType>
+ * ```
+ */
+declare const EffectContainerType: {
+  readonly SIB: "sibling";
+  readonly TREE: "tree";
+};
+/** Alpha bi-level effect — clips alpha to threshold (CT_AlphaBiLevelEffect). */
+interface AlphaBiLevelEffectOptions {
+  /** Alpha threshold (fixed percentage, required) */
+  readonly threshold: number;
+}
+/** Alpha inverse effect — inverts alpha, optionally with color (CT_AlphaInverseEffect). */
+interface AlphaInverseEffectOptions {
+  /** Optional color to apply inverse to */
+  readonly color?: SolidFillOptions;
+}
+/** Alpha modulate fixed effect (CT_AlphaModulateFixedEffect). */
+interface AlphaModulateFixedEffectOptions {
+  /** Amount percentage (default 100%) */
+  readonly amount?: number;
+}
+/** Alpha outset effect (CT_AlphaOutsetEffect). */
+interface AlphaOutsetEffectOptions {
+  /** Outset radius */
+  readonly radius?: number;
+}
+/** Alpha replace effect — replaces alpha value (CT_AlphaReplaceEffect). */
+interface AlphaReplaceEffectOptions {
+  /** New alpha value (fixed percentage, required) */
+  readonly alpha: number;
+}
+/** Blend effect — blends with nested container (CT_BlendEffect). */
+interface BlendEffectOptions {
+  /** Blend mode (required) */
+  readonly blend: (typeof BlendMode)[keyof typeof BlendMode];
+  /** Nested effect container */
+  readonly container: EffectDagOptions;
+}
+/** Color change effect — maps one color to another (CT_ColorChangeEffect). */
+interface ColorChangeEffectOptions {
+  /** Source color to replace */
+  readonly from: SolidFillOptions;
+  /** Target color */
+  readonly to: SolidFillOptions;
+  /** Whether to use alpha channel (default true) */
+  readonly useA?: boolean;
+}
+/** Duotone effect — two-color tone mapping (CT_DuotoneEffect). */
+interface DuotoneEffectOptions {
+  /** First color */
+  readonly color1: SolidFillOptions;
+  /** Second color */
+  readonly color2: SolidFillOptions;
+}
+/** Fill effect — applies a fill as an effect (CT_FillEffect). */
+interface FillEffectOptions {
+  /** Solid fill */
+  readonly solidFill?: SolidFillOptions;
+  /** Gradient fill */
+  readonly gradientFill?: GradientFillOptions;
+  /** Pattern fill */
+  readonly patternFill?: PatternFillOptions;
+  /** Group fill (inherit from parent) */
+  readonly groupFill?: boolean;
+  /** No fill */
+  readonly noFill?: boolean;
+}
+/** HSL effect — adjusts hue, saturation, luminance (CT_HSLEffect). */
+interface HSLEffectOptions {
+  /** Hue angle in 60,000ths of a degree (default 0) */
+  readonly hue?: number;
+  /** Saturation percentage (default 0%) */
+  readonly saturation?: number;
+  /** Luminance percentage (default 0%) */
+  readonly luminance?: number;
+}
+/** Luminance effect — adjusts brightness and contrast (CT_LuminanceEffect). */
+interface LuminanceEffectOptions {
+  /** Brightness percentage (default 0%) */
+  readonly bright?: number;
+  /** Contrast percentage (default 0%) */
+  readonly contrast?: number;
+}
+/** Tint effect — applies tint with hue and amount (CT_TintEffect). */
+interface TintEffectOptions {
+  /** Hue angle in 60,000ths of a degree (default 0) */
+  readonly hue?: number;
+  /** Tint amount percentage (default 0%) */
+  readonly amount?: number;
+}
+/** Relative offset effect (CT_RelativeOffsetEffect). */
+interface RelativeOffsetEffectOptions {
+  /** Horizontal offset percentage (default 0%) */
+  readonly translateX?: number;
+  /** Vertical offset percentage (default 0%) */
+  readonly translateY?: number;
+}
+/** Transform effect — scale, skew, translate (CT_TransformEffect). */
+interface TransformEffectOptions {
+  /** Horizontal scale percentage (default 100%) */
+  readonly scaleX?: number;
+  /** Vertical scale percentage (default 100%) */
+  readonly scaleY?: number;
+  /** Horizontal skew angle (default 0) */
+  readonly skewX?: number;
+  /** Vertical skew angle (default 0) */
+  readonly skewY?: number;
+  /** Horizontal translation */
+  readonly translateX?: number;
+  /** Vertical translation */
+  readonly translateY?: number;
+}
+/** Effect reference — references an effect by ID (CT_EffectReference). */
+interface EffectReferenceOptions {
+  /** Reference ID (required) */
+  readonly ref: string;
+}
+/**
+ * Options for an effect container (CT_EffectContainer).
+ *
+ * Supports all 28 effect types from EG_Effect, including recursive nesting.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_EffectContainer">
+ *   <xsd:group ref="EG_Effect" minOccurs="0" maxOccurs="unbounded"/>
+ *   <xsd:attribute name="type" type="ST_EffectContainerType" default="sib"/>
+ *   <xsd:attribute name="name" type="xsd:token"/>
+ * </xsd:complexType>
+ * ```
+ */
+interface EffectDagOptions {
+  /** Container type: "sib" (parallel) or "tree" (sequential) */
+  readonly type?: (typeof EffectContainerType)[keyof typeof EffectContainerType];
+  /** Container name */
+  readonly name?: string;
+  readonly blur?: BlurEffectOptions;
+  readonly fillOverlay?: FillOverlayEffectOptions;
+  readonly glow?: GlowEffectOptions;
+  readonly innerShadow?: InnerShadowEffectOptions;
+  readonly outerShadow?: OuterShadowEffectOptions;
+  readonly presetShadow?: PresetShadowEffectOptions;
+  readonly reflection?: ReflectionEffectOptions | true;
+  readonly softEdge?: number;
+  /** Nested effect containers */
+  readonly containers?: readonly EffectDagOptions[];
+  /** Effect references */
+  readonly effectRefs?: readonly EffectReferenceOptions[];
+  /** Alpha bi-level effect */
+  readonly alphaBiLevel?: AlphaBiLevelEffectOptions;
+  /** Alpha ceiling effect (empty element) */
+  readonly alphaCeiling?: boolean;
+  /** Alpha floor effect (empty element) */
+  readonly alphaFloor?: boolean;
+  /** Alpha inverse effect */
+  readonly alphaInverse?: AlphaInverseEffectOptions;
+  /** Alpha modulate effect (requires nested container) */
+  readonly alphaModulate?: EffectDagOptions;
+  /** Alpha modulate fixed effect */
+  readonly alphaModulateFixed?: AlphaModulateFixedEffectOptions;
+  /** Alpha outset effect */
+  readonly alphaOutset?: AlphaOutsetEffectOptions;
+  /** Alpha replace effect */
+  readonly alphaReplace?: AlphaReplaceEffectOptions;
+  /** Bi-level effect (threshold) */
+  readonly biLevel?: {
+    readonly threshold: number;
+  };
+  /** Blend effect (requires nested container) */
+  readonly blend?: BlendEffectOptions;
+  /** Color change effect */
+  readonly colorChange?: ColorChangeEffectOptions;
+  /** Color replace effect */
+  readonly colorReplace?: SolidFillOptions;
+  /** Duotone effect */
+  readonly duotone?: DuotoneEffectOptions;
+  /** Fill effect */
+  readonly fill?: FillEffectOptions;
+  /** Grayscale effect (empty element) */
+  readonly grayscale?: boolean;
+  /** HSL effect */
+  readonly hsl?: HSLEffectOptions;
+  /** Luminance effect */
+  readonly luminance?: LuminanceEffectOptions;
+  /** Tint effect */
+  readonly tint?: TintEffectOptions;
+  /** Relative offset effect */
+  readonly relativeOffset?: RelativeOffsetEffectOptions;
+  /** Transform effect */
+  readonly transform?: TransformEffectOptions;
+}
+/**
+ * Creates an effect DAG element (a:effectDag).
+ *
+ * This is the EG_EffectProperties choice alternative to effectLst,
+ * supporting all 28 effect types with recursive nesting.
+ *
+ * @example
+ * ```typescript
+ * // Simple effect DAG with glow and outer shadow
+ * createEffectDag({
+ *   glow: { radius: 50800, color: { value: "FF0000" } },
+ *   outerShadow: { color: { value: "000000" }, blurRadius: 76200 },
+ * });
+ *
+ * // DAG with alpha effects and nested container
+ * createEffectDag({
+ *   type: "tree",
+ *   alphaBiLevel: { threshold: 50000 },
+ *   containers: [{
+ *     glow: { color: { value: "FF0000" } },
+ *   }],
+ * });
+ * ```
+ */
+declare const createEffectDag: (options: EffectDagOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/effects/soft-edge.d.ts
+/**
+ * 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)
+ */
+declare const createSoftEdgeEffect: (rad: number) => BuilderElement<{
+  readonly rad: number;
+}>;
+//#endregion
+//#region src/drawingml/three-d/scene-3d.d.ts
+/**
+ * Sphere coordinates (CT_SphereCoords).
+ *
+ * Used for camera and light rig rotation. All angles are in 1/60000 of a degree.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_SphereCoords">
+ *   <xsd:attribute name="lat" type="ST_PositiveFixedAngle" use="required"/>
+ *   <xsd:attribute name="lon" type="ST_PositiveFixedAngle" use="required"/>
+ *   <xsd:attribute name="rev" type="ST_PositiveFixedAngle" use="required"/>
+ * </xsd:complexType>
+ * ```
+ */
+interface SphereCoords {
+  /** Latitude angle (0 to 21600000, in 1/60000 degree units) */
+  readonly lat: number;
+  /** Longitude angle (0 to 21600000) */
+  readonly lon: number;
+  /** Revolution angle (0 to 21600000) */
+  readonly rev: number;
+}
+/**
+ * Camera options (CT_Camera).
+ *
+ * Defines the camera type and optional rotation for the 3D scene.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_Camera">
+ *   <xsd:sequence>
+ *     <xsd:element name="rot" type="CT_SphereCoords" minOccurs="0"/>
+ *   </xsd:sequence>
+ *   <xsd:attribute name="prst" type="ST_PresetCameraType" use="required"/>
+ *   <xsd:attribute name="fov" type="ST_FOVAngle" use="optional"/>
+ *   <xsd:attribute name="zoom" type="ST_PositivePercentage" use="optional" default="100%"/>
+ * </xsd:complexType>
+ * ```
+ */
+interface CameraOptions {
+  /** Preset camera type (e.g., "perspectiveFront", "isometricTopUp") */
+  readonly preset: string;
+  /** Field of view angle (0 to 10800000, in 1/60000 degree units, max 180°) */
+  readonly fov?: number;
+  /** Zoom percentage (e.g., "100%") */
+  readonly zoom?: string;
+  /** Camera rotation */
+  readonly rotation?: SphereCoords;
+}
+/**
+ * Light rig options (CT_LightRig).
+ *
+ * Defines the lighting setup for the 3D scene.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_LightRig">
+ *   <xsd:sequence>
+ *     <xsd:element name="rot" type="CT_SphereCoords" minOccurs="0"/>
+ *   </xsd:sequence>
+ *   <xsd:attribute name="rig" type="ST_LightRigType" use="required"/>
+ *   <xsd:attribute name="dir" type="ST_LightRigDirection" use="required"/>
+ * </xsd:complexType>
+ * ```
+ */
+interface LightRigOptions {
+  /** Light rig type (e.g., "threePt", "balanced", "soft") */
+  readonly rig: string;
+  /** Light direction (e.g., "tl", "t", "tr", "l", "r", "bl", "b", "br") */
+  readonly direction: string;
+  /** Light rig rotation */
+  readonly rotation?: SphereCoords;
+}
+/**
+ * 3D point (CT_Point3D).
+ */
+interface Point3D {
+  readonly x: number;
+  readonly y: number;
+  readonly z: number;
+}
+/**
+ * 3D vector (CT_Vector3D).
+ */
+interface Vector3D {
+  readonly dx: number;
+  readonly dy: number;
+  readonly dz: number;
+}
+/**
+ * Backdrop options (CT_Backdrop).
+ *
+ * Defines the backdrop plane for the 3D scene.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_Backdrop">
+ *   <xsd:sequence>
+ *     <xsd:element name="anchor" type="CT_Point3D" use="required"/>
+ *     <xsd:element name="norm" type="CT_Vector3D" use="required"/>
+ *     <xsd:element name="up" type="CT_Vector3D" use="required"/>
+ *   </xsd:sequence>
+ * </xsd:complexType>
+ * ```
+ */
+interface BackdropOptions {
+  /** Anchor point */
+  readonly anchor: Point3D;
+  /** Normal vector */
+  readonly normal: Vector3D;
+  /** Up vector */
+  readonly up: Vector3D;
+}
+/**
+ * Options for a 3D scene (CT_Scene3D).
+ *
+ * Both `camera` and `lightRig` are required. `backdrop` is optional.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_Scene3D">
+ *   <xsd:sequence>
+ *     <xsd:element name="camera" type="CT_Camera" minOccurs="1"/>
+ *     <xsd:element name="lightRig" type="CT_LightRig" minOccurs="1"/>
+ *     <xsd:element name="backdrop" type="CT_Backdrop" minOccurs="0"/>
+ *   </xsd:sequence>
+ * </xsd:complexType>
+ * ```
+ *
+ * @example
+ * ```typescript
+ * createScene3D({
+ *   camera: { preset: "perspectiveFront" },
+ *   lightRig: { rig: "threePt", direction: "t" },
+ * });
+ * ```
+ */
+interface Scene3DOptions {
+  /** Camera settings (required) */
+  readonly camera: CameraOptions;
+  /** Light rig settings (required) */
+  readonly lightRig: LightRigOptions;
+  /** Backdrop settings (optional) */
+  readonly backdrop?: BackdropOptions;
+}
+/**
+ * Creates a 3D scene element (a:scene3d).
+ *
+ * @example
+ * ```typescript
+ * // Simple scene with default camera and lighting
+ * createScene3D({
+ *   camera: { preset: "perspectiveFront" },
+ *   lightRig: { rig: "threePt", direction: "t" },
+ * });
+ *
+ * // Scene with rotated camera and backdrop
+ * createScene3D({
+ *   camera: {
+ *     preset: "isometricTopUp",
+ *     rotation: { lat: 0, lon: 0, rev: 5400000 },
+ *   },
+ *   lightRig: { rig: "balanced", direction: "tl" },
+ *   backdrop: {
+ *     anchor: { x: 0, y: 0, z: 0 },
+ *     normal: { dx: 0, dy: 0, dz: 1 },
+ *     up: { dx: 0, dy: 1, dz: 0 },
+ *   },
+ * });
+ * ```
+ */
+declare const createScene3D: (options: Scene3DOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/three-d/bevel.d.ts
+/**
+ * Bevel preset types (12 variations).
+ *
+ * Reference: ISO/IEC 29500-4, dml-main.xsd, ST_BevelPresetType
+ */
+declare const BevelPresetType: {
+  readonly RELAXED_INSET: "relaxedInset";
+  readonly CIRCLE: "circle";
+  readonly SLOPE: "slope";
+  readonly CROSS: "cross";
+  readonly ANGLE: "angle";
+  readonly SOFT_ROUND: "softRound";
+  readonly CONVEX: "convex";
+  readonly COOL_SLANT: "coolSlant";
+  readonly DIVOT: "divot";
+  readonly RIBLET: "riblet";
+  readonly HARD_EDGE: "hardEdge";
+  readonly ART_DECO: "artDeco";
+};
+/**
+ * Options for a bevel element.
+ */
+interface BevelOptions {
+  /** Bevel width in EMUs (default 76200) */
+  readonly w?: number;
+  /** Bevel height in EMUs (default 76200) */
+  readonly h?: number;
+  /** Bevel preset type */
+  readonly prst?: (typeof BevelPresetType)[keyof typeof BevelPresetType];
+}
+/**
+ * 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>
+ * ```
+ */
+declare const createBevel: (options?: BevelOptions) => BuilderElement<{}>;
+/**
+ * Creates a bottom bevel element (a:bevelB).
+ */
+declare const createBottomBevel: (options?: BevelOptions) => BuilderElement<{}>;
+//#endregion
+//#region src/drawingml/three-d/shape-3d.d.ts
+/**
+ * Preset material types for 3D shapes (15 variations).
+ *
+ * Reference: ISO/IEC 29500-4, dml-main.xsd, ST_PresetMaterialType
+ */
+declare const PresetMaterialType: {
+  readonly LEGACY_MATTE: "legacyMatte";
+  readonly LEGACY_PLASTIC: "legacyPlastic";
+  readonly LEGACY_METAL: "legacyMetal";
+  readonly LEGACY_WIREFRAME: "legacyWireframe";
+  readonly MATTE: "matte";
+  readonly PLASTIC: "plastic";
+  readonly METAL: "metal";
+  readonly WARM_MATTE: "warmMatte";
+  readonly TRANSLUCENT_POWDER: "translucentPowder";
+  readonly POWDER: "powder";
+  readonly DK_EDGE: "darkEdge";
+  readonly SOFT_EDGE: "softEdge";
+  readonly CLEAR: "clear";
+  readonly FLAT: "flat";
+  readonly SOFT_METAL: "softMetal";
+};
+/**
+ * Options for 3D shape properties.
+ */
+interface Shape3DOptions {
+  /** Top bevel options */
+  readonly bevelT?: BevelOptions;
+  /** Bottom bevel options */
+  readonly bevelB?: BevelOptions;
+  /** Extrusion color (CT_Color / EG_ColorChoice) */
+  readonly extrusionColor?: SolidFillOptions;
+  /** Contour color (CT_Color / EG_ColorChoice) */
+  readonly contourColor?: SolidFillOptions;
+  /** Depth in EMUs (default 0) */
+  readonly z?: number;
+  /** Extrusion height in EMUs (default 0) */
+  readonly extrusionH?: number;
+  /** Contour width in EMUs (default 0) */
+  readonly contourW?: number;
+  /** Material preset type */
+  readonly prstMaterial?: (typeof PresetMaterialType)[keyof typeof PresetMaterialType];
+}
+/**
+ * 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>
+ * ```
+ */
+declare const createShape3D: (options: Shape3DOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/geometry/adjustment-values.d.ts
+/**
+ * A single geometry guide that defines an adjustment value.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_GeomGuide">
+ *   <xsd:attribute name="name" type="ST_GeomGuideName" use="required"/>
+ *   <xsd:attribute name="fmla" type="ST_GeomGuideFormula" use="required"/>
+ * </xsd:complexType>
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Adjust rounded rectangle corner radius
+ * { name: "adj", formula: "val 16667" }
+ *
+ * // Adjust star inner radius
+ * { name: "val", formula: "val 50000" }
+ * ```
+ *
+ * Note: Formula examples like `val 16667` define fixed adjustment values.
+ */
+interface GeometryGuide {
+  /** Guide name (identifier) */
+  readonly name: string;
+  /** Guide formula (e.g., "val 16667") */
+  readonly formula: string;
+}
+/**
+ * Creates an adjustment values list element (a:avLst).
+ *
+ * The adjustment values list contains geometry guides that modify
+ * the appearance of a preset geometric shape. When empty, default
+ * values are used.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_GeomGuideList">
+ *   <xsd:sequence>
+ *     <xsd:element name="gd" type="CT_GeomGuide" minOccurs="0" maxOccurs="unbounded"/>
+ *   </xsd:sequence>
+ * </xsd:complexType>
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Empty adjustment values (defaults)
+ * createAdjustmentValues();
+ *
+ * // With guides
+ * createAdjustmentValues([
+ *   { name: "adj", formula: "val 16667" },
+ * ]);
+ * ```
+ */
+declare const createAdjustmentValues: (guides?: readonly GeometryGuide[]) => XmlComponent;
+//#endregion
+//#region src/drawingml/geometry/preset-geometry.d.ts
+/**
+ * Options for preset geometry.
+ */
+interface PresetGeometryOptions {
+  /**
+   * Preset shape type (ST_ShapeType).
+   *
+   * Defaults to `"rect"` if not specified.
+   */
+  readonly preset?: string;
+  /**
+   * Adjustment values that modify the base shape.
+   *
+   * Each guide has a name and formula (e.g., `{ name: "adj", formula: "val 16667" }`).
+   */
+  readonly adjustmentValues?: readonly GeometryGuide[];
+}
+/**
+ * Represents a preset geometry for a DrawingML shape.
+ *
+ * This element specifies when a preset geometric shape should be used instead
+ * of a custom geometry. It includes a shape preset identifier and optional
+ * adjustment values that modify the base shape.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_PresetGeometry2D">
+ *   <xsd:sequence>
+ *     <xsd:element name="avLst" type="CT_GeomGuideList" minOccurs="0" maxOccurs="1"/>
+ *   </xsd:sequence>
+ *   <xsd:attribute name="prst" type="ST_ShapeType" use="required"/>
+ * </xsd:complexType>
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Default rectangle
+ * const geometry = new PresetGeometry();
+ *
+ * // Rounded rectangle with adjustment
+ * const geometry = new PresetGeometry({
+ *   preset: "roundRect",
+ *   adjustmentValues: [{ name: "adj", formula: "val 16667" }],
+ * });
+ * ```
+ */
+declare class PresetGeometry extends XmlComponent {
+  constructor(options?: PresetGeometryOptions);
+}
+//#endregion
+//#region src/drawingml/geometry/custom-geometry.d.ts
+/**
+ * Path fill mode (ST_PathFillMode).
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:simpleType name="ST_PathFillMode">
+ *   <xsd:restriction base="xsd:token">
+ *     <xsd:enumeration value="none"/>
+ *     <xsd:enumeration value="norm"/>
+ *     <xsd:enumeration value="lighten"/>
+ *     <xsd:enumeration value="lightenLess"/>
+ *     <xsd:enumeration value="darken"/>
+ *     <xsd:enumeration value="darkenLess"/>
+ *   </xsd:restriction>
+ * </xsd:simpleType>
+ * ```
+ */
+declare const PathFillMode: {
+  readonly NONE: "none";
+  readonly NORM: "normal";
+  readonly LIGHTEN: "lighten";
+  readonly LIGHTEN_LESS: "lightenLess";
+  readonly DARKEN: "darken";
+  readonly DARKEN_LESS: "darkenLess";
+};
+/**
+ * An adjustable point (CT_AdjPoint2D).
+ *
+ * Coordinates can be absolute values or references to geometry guide names.
+ */
+interface AdjPoint {
+  /** X coordinate (absolute value or guide name) */
+  readonly x: string;
+  /** Y coordinate (absolute value or guide name) */
+  readonly y: string;
+}
+/** Move-to path command (CT_Path2DMoveTo). */
+interface PathMoveTo {
+  readonly command: "moveTo";
+  readonly point: AdjPoint;
+}
+/** Line-to path command (CT_Path2DLineTo). */
+interface PathLineTo {
+  readonly command: "lineTo";
+  readonly point: AdjPoint;
+}
+/** Arc-to path command (CT_Path2DArcTo). */
+interface PathArcTo {
+  readonly command: "arcTo";
+  readonly widthRadius: string;
+  readonly heightRadius: string;
+  readonly startAngle: string;
+  readonly sweepAngle: string;
+}
+/** Quadratic Bezier-to path command (CT_Path2DQuadBezierTo). */
+interface PathQuadBezTo {
+  readonly command: "quadBezTo";
+  readonly points: readonly [AdjPoint, AdjPoint];
+}
+/** Cubic Bezier-to path command (CT_Path2DCubicBezierTo). */
+interface PathCubicBezTo {
+  readonly command: "cubicBezTo";
+  readonly points: readonly [AdjPoint, AdjPoint, AdjPoint];
+}
+/** Close path command (CT_Path2DClose). */
+interface PathClose {
+  readonly command: "close";
+}
+/** A path command within a custom geometry path. */
+type PathCommand = PathMoveTo | PathLineTo | PathArcTo | PathQuadBezTo | PathCubicBezTo | PathClose;
+/**
+ * Options for a 2D path (CT_Path2D).
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_Path2D">
+ *   <xsd:choice minOccurs="0" maxOccurs="unbounded">
+ *     <xsd:element name="close" type="CT_Path2DClose"/>
+ *     <xsd:element name="moveTo" type="CT_Path2DMoveTo"/>
+ *     <xsd:element name="lnTo" type="CT_Path2DLineTo"/>
+ *     <xsd:element name="arcTo" type="CT_Path2DArcTo"/>
+ *     <xsd:element name="quadBezTo" type="CT_Path2DQuadBezierTo"/>
+ *     <xsd:element name="cubicBezTo" type="CT_Path2DCubicBezierTo"/>
+ *   </xsd:choice>
+ *   <xsd:attribute name="w" type="ST_PositiveCoordinate" default="0"/>
+ *   <xsd:attribute name="h" type="ST_PositiveCoordinate" default="0"/>
+ *   <xsd:attribute name="fill" type="ST_PathFillMode" default="norm"/>
+ *   <xsd:attribute name="stroke" type="xsd:boolean" default="true"/>
+ *   <xsd:attribute name="extrusionOk" type="xsd:boolean" default="true"/>
+ * </xsd:complexType>
+ * ```
+ */
+interface PathOptions {
+  /** Path width (coordinate value, default 0 = use shape width) */
+  readonly w?: number;
+  /** Path height (coordinate value, default 0 = use shape height) */
+  readonly h?: number;
+  /** Fill mode for this path */
+  readonly fill?: (typeof PathFillMode)[keyof typeof PathFillMode];
+  /** Whether to stroke the path */
+  readonly stroke?: boolean;
+  /** Whether extrusion is allowed */
+  readonly extrusionOk?: boolean;
+  /** Path commands (moveTo, lineTo, arcTo, etc.) */
+  readonly commands: readonly PathCommand[];
+}
+/**
+ * A position reference for adjust handles and connection sites.
+ */
+interface AdjustHandlePosition {
+  readonly x: string;
+  readonly y: string;
+}
+/**
+ * XY adjust handle (CT_XYAdjustHandle).
+ *
+ * Allows the user to drag a handle in X/Y directions.
+ */
+interface XYAdjustHandle {
+  readonly type: "xy";
+  readonly guideRefX?: string;
+  readonly minX?: string;
+  readonly maxX?: string;
+  readonly guideRefY?: string;
+  readonly minY?: string;
+  readonly maxY?: string;
+  readonly position: AdjustHandlePosition;
+}
+/**
+ * Polar adjust handle (CT_PolarAdjustHandle).
+ *
+ * Allows the user to drag a handle in radius/angle directions.
+ */
+interface PolarAdjustHandle {
+  readonly type: "polar";
+  readonly guideRefRadius?: string;
+  readonly minRadius?: string;
+  readonly maxRadius?: string;
+  readonly guideRefAngle?: string;
+  readonly minAngle?: string;
+  readonly maxAngle?: string;
+  readonly position: AdjustHandlePosition;
+}
+/** An adjust handle (XY or Polar). */
+type AdjustHandle = XYAdjustHandle | PolarAdjustHandle;
+/**
+ * Connection site (CT_ConnectionSite).
+ *
+ * Defines a point on the shape boundary where connectors can attach.
+ */
+interface ConnectionSite {
+  /** Angle (absolute value or guide name) */
+  readonly angle: string;
+  /** Position */
+  readonly position: AdjustHandlePosition;
+}
+/**
+ * Text insertion rectangle (CT_GeomRect).
+ *
+ * Defines the rectangle within the shape where text is placed.
+ * Coordinates can be absolute values or references to geometry guide names.
+ */
+interface GeomRect {
+  readonly left: string;
+  readonly top: string;
+  readonly right: string;
+  readonly bottom: string;
+}
+/**
+ * Options for a custom 2D geometry (CT_CustomGeometry2D).
+ *
+ * Only `pathList` is required. All other sub-elements are optional.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_CustomGeometry2D">
+ *   <xsd:sequence>
+ *     <xsd:element name="avLst" type="CT_GeomGuideList" minOccurs="0"/>
+ *     <xsd:element name="gdLst" type="CT_GeomGuideList" minOccurs="0"/>
+ *     <xsd:element name="ahLst" type="CT_AdjustHandleList" minOccurs="0"/>
+ *     <xsd:element name="cxnLst" type="CT_ConnectionSiteList" minOccurs="0"/>
+ *     <xsd:element name="rect" type="CT_GeomRect" minOccurs="0"/>
+ *     <xsd:element name="pathLst" type="CT_Path2DList" minOccurs="1"/>
+ *   </xsd:sequence>
+ * </xsd:complexType>
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Simple triangle
+ * createCustomGeometry({
+ *   pathList: [{
+ *     commands: [
+ *       { command: "moveTo", point: { x: "0", y: "0" } },
+ *       { command: "lineTo", point: { x: "10000000", y: "0" } },
+ *       { command: "lineTo", point: { x: "5000000", y: "10000000" } },
+ *       { command: "close" },
+ *     ],
+ *   }],
+ * });
+ * ```
+ */
+interface CustomGeometryOptions {
+  /** Adjustment value guides (a:avLst) */
+  readonly adjustmentValues?: readonly GeometryGuide[];
+  /** Geometry guide formulas (a:gdLst) */
+  readonly guides?: readonly GeometryGuide[];
+  /** Adjust handles (a:ahLst) */
+  readonly adjustHandles?: readonly AdjustHandle[];
+  /** Connection sites (a:cxnLst) */
+  readonly connectionSites?: readonly ConnectionSite[];
+  /** Text insertion rectangle (a:rect) */
+  readonly textRect?: GeomRect;
+  /** Path definitions (a:pathLst) — required */
+  readonly pathList: readonly PathOptions[];
+}
+/**
+ * Creates a custom 2D geometry element (a:custGeom).
+ *
+ * @example
+ * ```typescript
+ * // Diamond shape
+ * const geom = createCustomGeometry({
+ *   pathList: [{
+ *     commands: [
+ *       { command: "moveTo", point: { x: "5000000", y: "0" } },
+ *       { command: "lineTo", point: { x: "10000000", y: "5000000" } },
+ *       { command: "lineTo", point: { x: "5000000", y: "10000000" } },
+ *       { command: "lineTo", point: { x: "0", y: "5000000" } },
+ *       { command: "close" },
+ *     ],
+ *   }],
+ *   textRect: { left: "2000000", top: "2000000", right: "8000000", bottom: "8000000" },
+ * });
+ * ```
+ */
+declare const createCustomGeometry: (options: CustomGeometryOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/blip/blip.d.ts
+/**
+ * Options for creating a blip element.
+ */
+interface BlipOptions {
+  /** File name used as placeholder; the packer's ImageReplacer replaces `{referenceId}` with `rId{N}` */
+  readonly referenceId: string;
+  /** Image type for SVG detection */
+  readonly type?: "svg" | string;
+  /** For SVG images, the fallback image file name */
+  readonly fallbackFileName?: string;
+}
+/**
+ * Creates a blip element for an image.
+ *
+ * A blip references the actual image data stored in the document package
+ * through a relationship ID. For SVG images, it includes extensions that
+ * reference the SVG data.
+ *
+ * Reference: http://officeopenxml.com/drwPic.php
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_Blip">
+ *   <xsd:sequence>
+ *     <xsd:choice minOccurs="0" maxOccurs="unbounded">
+ *       <xsd:element name="alphaBiLevel" type="CT_AlphaBiLevelEffect"/>
+ *       <xsd:element name="alphaCeiling" type="CT_AlphaCeilingEffect"/>
+ *       <xsd:element name="alphaFloor" type="CT_AlphaFloorEffect"/>
+ *       <xsd:element name="alphaInv" type="CT_AlphaInverseEffect"/>
+ *       <xsd:element name="alphaMod" type="CT_AlphaModulateEffect"/>
+ *       <xsd:element name="alphaModFix" type="CT_AlphaModulateFixedEffect"/>
+ *       <xsd:element name="alphaRepl" type="CT_AlphaReplaceEffect"/>
+ *       <xsd:element name="biLevel" type="CT_BiLevelEffect"/>
+ *       <xsd:element name="blur" type="CT_BlurEffect"/>
+ *       <xsd:element name="clrChange" type="CT_ColorChangeEffect"/>
+ *       <xsd:element name="clrRepl" type="CT_ColorReplaceEffect"/>
+ *       <xsd:element name="duotone" type="CT_DuotoneEffect"/>
+ *       <xsd:element name="fillOverlay" type="CT_FillOverlayEffect"/>
+ *       <xsd:element name="grayscl" type="CT_GrayscaleEffect"/>
+ *       <xsd:element name="hsl" type="CT_HSLEffect"/>
+ *       <xsd:element name="lum" type="CT_LuminanceEffect"/>
+ *       <xsd:element name="tint" type="CT_TintEffect"/>
+ *     </xsd:choice>
+ *     <xsd:element name="extLst" type="CT_OfficeArtExtensionList" minOccurs="0"/>
+ *   </xsd:sequence>
+ *   <xsd:attribute ref="r:embed"/>
+ *   <xsd:attribute ref="r:link"/>
+ *   <xsd:attribute name="cstate" type="ST_BlipCompression"/>
+ * </xsd:complexType>
+ * ```
+ *
+ * @param options - Blip options including referenceId and type
+ * @param blipEffects - Optional blip effects (brightness, contrast, etc.)
+ * @returns An XML component representing the blip element
+ */
+declare const createBlip: (options: BlipOptions, blipEffects?: BlipEffectsOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/blip/blip-fill.d.ts
+/**
+ * Options for blip fill properties.
+ */
+interface BlipFillOptions {
+  /** DPI of the image */
+  readonly dpi?: number;
+  /** Whether the fill rotates with the shape */
+  readonly rotWithShape?: boolean;
+  /** Image adjustment effects (brightness, contrast, grayscale, etc.) */
+  readonly blipEffects?: BlipEffectsOptions;
+  /** Source rectangle for cropping */
+  readonly srcRect?: SourceRectangleOptions;
+  /** Tile fill mode (if omitted, defaults to stretch) */
+  readonly tile?: TileOptions;
+}
+/**
+ * Creates a blip fill element.
+ *
+ * This element specifies the type of fill used for a picture. It contains the blip (image)
+ * reference, an optional source rectangle for cropping, and the fill mode (typically stretch).
+ *
+ * Reference: ISO/IEC 29500-4, dml-main.xsd, CT_BlipFillProperties
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_BlipFillProperties">
+ *   <xsd:sequence>
+ *     <xsd:element name="blip" type="CT_Blip" minOccurs="0" maxOccurs="1"/>
+ *     <xsd:element name="srcRect" type="CT_RelativeRect" minOccurs="0" maxOccurs="1"/>
+ *     <xsd:group ref="EG_FillModeProperties" minOccurs="0" maxOccurs="1"/>
+ *   </xsd:sequence>
+ *   <xsd:attribute name="dpi" type="xsd:unsignedInt" use="optional"/>
+ *   <xsd:attribute name="rotWithShape" type="xsd:boolean" use="optional"/>
+ * </xsd:complexType>
+ * ```
+ *
+ * @param blipOptions - Blip options including referenceId and type
+ * @param fillOptions - Optional blip fill options
+ */
+declare const createBlipFill: (blipOptions: BlipOptions, fillOptions?: BlipFillOptions) => XmlComponent;
+//#endregion
+//#region src/drawingml/blip/blip-extentions.d.ts
+/**
+ * Creates an extension list for SVG images.
+ *
+ * This element contains the extensions needed to embed SVG images
+ * within a blip. It wraps the SVG-specific extension elements.
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_OfficeArtExtensionList">
+ *   <xsd:sequence>
+ *     <xsd:element name="ext" type="CT_OfficeArtExtension" minOccurs="0" maxOccurs="unbounded"/>
+ *   </xsd:sequence>
+ * </xsd:complexType>
+ * ```
+ *
+ * @param svgReferenceId - The reference ID for the SVG image
+ * @returns An XML component representing the extension list
+ */
+declare const createExtentionList: (svgReferenceId: string) => XmlComponent;
+//#endregion
+//#region src/drawingml/blip/stretch.d.ts
+/**
+ * Represents a stretch fill mode for blip fills.
+ *
+ * This element specifies that the blip (image) should be stretched to fill
+ * the entire shape. The stretch fill is one of the fill mode properties
+ * that determines how an image is applied to a shape.
+ *
+ * Reference: http://officeopenxml.com/drwPic.php
+ *
+ * ## XSD Schema
+ * ```xml
+ * <xsd:complexType name="CT_StretchInfoProperties">
+ *   <xsd:sequence>
+ *     <xsd:element name="fillRect" type="CT_RelativeRect" minOccurs="0" maxOccurs="1"/>
+ *   </xsd:sequence>
+ * </xsd:complexType>
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const stretch = new Stretch();
+ * ```
+ */
+declare class Stretch extends XmlComponent {
+  constructor();
+}
+//#endregion
+//#region src/drawingml/transform.d.ts
+interface Transform2DOptions {
+  readonly x?: number;
+  readonly y?: number;
+  readonly width?: number;
+  readonly height?: number;
+  readonly flipHorizontal?: boolean;
+  readonly flipVertical?: boolean;
+  readonly rotation?: number;
+}
+interface GroupTransform2DOptions extends Transform2DOptions {
+  readonly childOffsetX?: number;
+  readonly childOffsetY?: number;
+  readonly childExtentWidth?: number;
+  readonly childExtentHeight?: number;
+}
+/**
+ * Creates a 2D transform element (a:xfrm).
+ *
+ * @param options - Transform options including position, size, rotation, and flip.
+ * @param elementName - Element name, defaults to "a:xfrm".
+ */
+declare const createTransform2D: (options: Transform2DOptions, elementName?: string) => XmlComponent;
+/**
+ * Creates a group transform element (a:xfrm with chOff/chExt children).
+ */
+declare const createGroupTransform2D: (options: GroupTransform2DOptions, elementName?: string) => XmlComponent;
+//#endregion
+//#region src/drawingml/media/transformation.d.ts
+/**
+ * Internal media data transformation with both pixel and EMU values.
+ */
+interface MediaDataTransformation {
+  readonly offset?: {
+    readonly pixels: {
+      readonly x: number;
+      readonly y: number;
+    };
+    readonly emus?: {
+      readonly x: number;
+      readonly y: number;
+    };
+  };
+  readonly pixels: {
+    /** Width in pixels */readonly x: number; /** Height in pixels */
+    readonly y: number;
+  };
+  /** Display dimensions in EMUs (English Metric Units) */
+  readonly emus: {
+    /** Width in EMUs (1 inch = 914400 EMUs) */readonly x: number; /** Height in EMUs (1 inch = 914400 EMUs) */
+    readonly y: number;
+  };
+  /** Optional flip transformations */
+  readonly flip?: {
+    /** Whether to flip the image vertically */readonly vertical?: boolean; /** Whether to flip the image horizontally */
+    readonly horizontal?: boolean;
+  };
+  /** Optional rotation angle in degrees */
+  readonly rotation?: number;
+}
+/**
+ * Transformation options for media display.
+ *
+ * Specifies how an image should be transformed when displayed in the document.
+ */
+interface MediaTransformation {
+  readonly offset?: {
+    readonly top?: number;
+    readonly left?: number;
+  };
+  readonly width: number;
+  /** Display height in pixels */
+  readonly height: number;
+  /** Optional flip transformations */
+  readonly flip?: {
+    /** Whether to flip the image vertically */readonly vertical?: boolean; /** Whether to flip the image horizontally */
+    readonly horizontal?: boolean;
+  };
+  /** Optional rotation angle in degrees */
+  readonly rotation?: number;
+}
+/**
+ * Converts user-facing transformation options (pixels) to internal
+ * transformation data (pixels + EMUs).
+ *
+ * @param options - User-facing transformation in pixels
+ * @returns Internal transformation data with both pixel and EMU values
+ */
+declare const createTransformation: (options: MediaTransformation) => MediaDataTransformation;
+//#endregion
+export { RectAlignment as $, createSolidFill as $t, createBevel as A, FillOptions as At, createSoftEdgeEffect as B, RelativeRect as Bt, GeometryGuide as C, createGroupFill as Ct, createShape3D as D, createNoFill as Dt, Shape3DOptions as E, createPatternFill as Et, Point3D as F, GradientShadeOptions as Ft, EffectListOptions as G, TileOptions as Gt, EffectDagOptions as H, createGradientFill as Ht, Scene3DOptions as I, GradientStop as It, createReflectionEffect as J, createSourceRectangle as Jt, createEffectList as K, createTileInfo as Kt, SphereCoords as L, LinearShadeOptions as Lt, BackdropOptions as M, buildFill as Mt, CameraOptions as N, extractBlipFillMedia as Nt, BevelOptions as O, BlipFillConfigOptions as Ot, LightRigOptions as P, GradientFillOptions as Pt, OuterShadowEffectOptions as Q, createColorElement as Qt, Vector3D as R, PathShadeOptions as Rt, PresetGeometryOptions as S, createCustomDash as St, PresetMaterialType as T, PresetPattern as Tt, createEffectDag as U, createGradientStop as Ut, EffectContainerType as V, TileFlipMode as Vt, BlurEffectOptions as W, TileAlignment as Wt, PresetShadowVal as X, createBlipEffects as Xt, PresetShadowEffectOptions as Y, BlipEffectsOptions as Yt, createPresetShadowEffect as Z, SolidFillOptions as Zt, PathCommand as _, LineEndOptions as _t, Transform2DOptions as a, createSchemeColor as an, BlendMode as at, createCustomGeometry as b, createLineEnd as bt, Stretch as c, RgbColorOptions as cn, CompoundLine as ct, createBlipFill as d, PresetColorOptions as dn, OutlineFillProperties as dt, SystemColor as en, createOuterShadowEffect as et, BlipOptions as f, createPresetColor as fn, OutlineOptions as ft, GeomRect as g, createColorTransforms as gn, LineEndLength as gt, CustomGeometryOptions as h, ColorTransformOptions as hn, createOutline as ht, GroupTransform2DOptions as i, SchemeColorOptions as in, createGlowEffect as it, createBottomBevel as j, GradientStopOptions as jt, BevelPresetType as k, BlipFillMediaData as kt, createExtentionList as l, createRgbColor as ln, LineCap as lt, ConnectionSite as m, createHslColor as mn, PresetDash as mt, MediaTransformation as n, createSystemColor as nn, createInnerShadowEffect as nt, createGroupTransform2D as o, ScRgbColorOptions as on, FillOverlayEffectOptions as ot, createBlip as p, HslColorOptions as pn, PenAlignment as pt, ReflectionEffectOptions as q, SourceRectangleOptions as qt, createTransformation as r, SchemeColor as rn, GlowEffectOptions as rt, createTransform2D as s, createScRgbColor as sn, createFillOverlayEffect as st, MediaDataTransformation as t, SystemColorOptions as tn, InnerShadowEffectOptions as tt, BlipFillOptions as u, PresetColor as un, LineJoin as ut, PathFillMode as v, LineEndType as vt, createAdjustmentValues as w, PatternFillOptions as wt, PresetGeometry as x, DashStop as xt, PathOptions as y, LineEndWidth as yt, createScene3D as z, PathShadeType as zt };