@office-open/core 0.3.6 → 0.4.0

package/dist/drawingml/index.d.mts

@@ -1,4 +1,4 @@
-import { O as XmlComponent, T as XmlAttributeComponent, a as BuilderElement } from "../_chunks/index-eOE0yRGG.mjs";
+import { O as XmlComponent, T as XmlAttributeComponent, a as BuilderElement } from "../_chunks/index-hmJg8TDw.mjs";
 
 //#region src/drawingml/color/color-transform.d.ts
 /**
@@ -91,9 +91,9 @@ 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 sat: number;
+  readonly saturation: number;
   /** Luminance in 1/1000th of a percent (0-100000) */
-  readonly lum: number;
+  readonly luminance: number;
   /** Optional color transforms */
   readonly transforms?: ColorTransformOptions;
 }
@@ -551,7 +551,7 @@ declare const createColorElement: (color: SolidFillOptions) => XmlComponent;
  *   value: SchemeColor.ACCENT1, transforms: { tint: 40000 },
  * });
  * // HSL solid fill
- * const hslFill = createSolidFill({ hue: 120000, sat: 100000, lum: 50000 });
+ * const hslFill = createSolidFill({ hue: 120000, saturation: 100000, luminance: 50000 });
  * ```
  */
 declare const createSolidFill: (options: SolidFillOptions) => XmlComponent;
@@ -586,9 +586,9 @@ 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 sat?: number;
+  readonly saturation?: number;
   /** Luminance adjustment in percentage points (-100 to 100). Default 0. */
-  readonly lum?: number;
+  readonly luminance?: number;
 }
 /**
  * Options for tint effect.
@@ -603,7 +603,7 @@ interface TintEffectOptions$1 {
   /** Hue in 60000ths of a degree. Default 0. */
   readonly hue?: number;
   /** Amount in percentage points (0 to 100). Default 0. */
-  readonly amt?: number;
+  readonly amount?: number;
 }
 /**
  * Options for duotone effect.
@@ -629,7 +629,7 @@ interface DuotoneEffectOptions$1 {
  */
 interface BiLevelEffectOptions {
   /** Threshold percentage (0 to 100). Pixels above are white, below are black. */
-  readonly thresh: number;
+  readonly threshold: number;
 }
 /**
  * Options for alpha replace effect.
@@ -653,7 +653,7 @@ interface AlphaReplaceEffectOptions$1 {
  */
 interface AlphaBiLevelEffectOptions$1 {
   /** Threshold percentage (0 to 100). Alpha above is fully opaque, below is fully transparent. */
-  readonly thresh: number;
+  readonly threshold: number;
 }
 /**
  * Options for alpha modulate fixed effect.
@@ -708,7 +708,7 @@ interface ColorReplaceEffectOptions {
  */
 interface BlipBlurEffectOptions {
   /** Blur radius in EMUs. Default 0. */
-  readonly rad?: number;
+  readonly radius?: number;
   /** Whether to grow the blur boundary. Default true. */
   readonly grow?: boolean;
 }
@@ -1709,7 +1709,7 @@ declare const createFillOverlayEffect: (options: FillOverlayEffectOptions) => Xm
  */
 interface GlowEffectOptions {
   /** Glow radius in EMUs */
-  readonly rad?: number;
+  readonly radius?: number;
   /** Glow color */
   readonly color: SolidFillOptions;
 }
@@ -1734,11 +1734,11 @@ declare const createGlowEffect: (options: GlowEffectOptions) => XmlComponent;
  */
 interface InnerShadowEffectOptions {
   /** Blur radius in EMUs */
-  readonly blurRad?: number;
+  readonly blurRadius?: number;
   /** Distance from shape edge in EMUs */
-  readonly dist?: number;
+  readonly distance?: number;
   /** Direction angle in 60,000ths of a degree */
-  readonly dir?: number;
+  readonly direction?: number;
   /** Shadow color */
   readonly color: SolidFillOptions;
 }
@@ -1779,21 +1779,21 @@ declare const RectAlignment: {
  */
 interface OuterShadowEffectOptions {
   /** Blur radius in EMUs */
-  readonly blurRad?: number;
+  readonly blurRadius?: number;
   /** Distance from shape in EMUs */
-  readonly dist?: number;
+  readonly distance?: number;
   /** Direction angle in 60,000ths of a degree */
-  readonly dir?: number;
+  readonly direction?: number;
   /** Horizontal scale percentage (e.g., 100000 = 100%) */
-  readonly sx?: number;
+  readonly scaleX?: number;
   /** Vertical scale percentage */
-  readonly sy?: number;
+  readonly scaleY?: number;
   /** Horizontal skew angle in 60,000ths of a degree */
-  readonly kx?: number;
+  readonly skewX?: number;
   /** Vertical skew angle */
-  readonly ky?: number;
+  readonly skewY?: number;
   /** Shadow alignment */
-  readonly algn?: keyof typeof RectAlignment;
+  readonly alignment?: keyof typeof RectAlignment;
   /** Whether shadow rotates with shape */
   readonly rotWithShape?: boolean;
   /** Shadow color */
@@ -1855,11 +1855,11 @@ declare const PresetShadowVal: {
  */
 interface PresetShadowEffectOptions {
   /** Preset shadow type (required) */
-  readonly prst: keyof typeof PresetShadowVal;
+  readonly preset: keyof typeof PresetShadowVal;
   /** Distance from shape in EMUs */
-  readonly dist?: number;
+  readonly distance?: number;
   /** Direction angle in 60,000ths of a degree */
-  readonly dir?: number;
+  readonly direction?: number;
   /** Shadow color */
   readonly color: SolidFillOptions;
 }
@@ -1888,31 +1888,31 @@ declare const createPresetShadowEffect: (options: PresetShadowEffectOptions) =>
  */
 interface ReflectionEffectOptions {
   /** Blur radius in EMUs */
-  readonly blurRad?: number;
+  readonly blurRadius?: number;
   /** Start opacity (fixed percentage, e.g., 100000 = 100%) */
-  readonly stA?: number;
+  readonly startAlpha?: number;
   /** Start position (fixed percentage) */
-  readonly stPos?: number;
+  readonly startPosition?: number;
   /** End opacity (fixed percentage) */
-  readonly endA?: number;
+  readonly endAlpha?: number;
   /** End position (fixed percentage) */
-  readonly endPos?: number;
+  readonly endPosition?: number;
   /** Distance from shape in EMUs */
-  readonly dist?: number;
+  readonly distance?: number;
   /** Direction angle in 60,000ths of a degree */
-  readonly dir?: number;
+  readonly direction?: number;
   /** Fade direction angle in 60,000ths of a degree */
-  readonly fadeDir?: number;
+  readonly fadeDirection?: number;
   /** Horizontal scale percentage */
-  readonly sx?: number;
+  readonly scaleX?: number;
   /** Vertical scale percentage */
-  readonly sy?: number;
+  readonly scaleY?: number;
   /** Horizontal skew angle */
-  readonly kx?: number;
+  readonly skewX?: number;
   /** Vertical skew angle */
-  readonly ky?: number;
+  readonly skewY?: number;
   /** Alignment */
-  readonly algn?: string;
+  readonly alignment?: string;
   /** Whether reflection rotates with shape */
   readonly rotWithShape?: boolean;
 }
@@ -1947,7 +1947,7 @@ declare const createReflectionEffect: (options?: ReflectionEffectOptions) => Bui
  */
 interface BlurEffectOptions {
   /** Blur radius in EMUs */
-  readonly rad?: number;
+  readonly radius?: number;
   /** Whether to grow the shape boundary */
   readonly grow?: boolean;
 }
@@ -2024,7 +2024,7 @@ declare const EffectContainerType: {
 /** Alpha bi-level effect — clips alpha to threshold (CT_AlphaBiLevelEffect). */
 interface AlphaBiLevelEffectOptions {
   /** Alpha threshold (fixed percentage, required) */
-  readonly thresh: number;
+  readonly threshold: number;
 }
 /** Alpha inverse effect — inverts alpha, optionally with color (CT_AlphaInverseEffect). */
 interface AlphaInverseEffectOptions {
@@ -2034,17 +2034,17 @@ interface AlphaInverseEffectOptions {
 /** Alpha modulate fixed effect (CT_AlphaModulateFixedEffect). */
 interface AlphaModulateFixedEffectOptions {
   /** Amount percentage (default 100%) */
-  readonly amt?: number;
+  readonly amount?: number;
 }
 /** Alpha outset effect (CT_AlphaOutsetEffect). */
 interface AlphaOutsetEffectOptions {
   /** Outset radius */
-  readonly rad?: number;
+  readonly radius?: number;
 }
 /** Alpha replace effect — replaces alpha value (CT_AlphaReplaceEffect). */
 interface AlphaReplaceEffectOptions {
   /** New alpha value (fixed percentage, required) */
-  readonly a: number;
+  readonly alpha: number;
 }
 /** Blend effect — blends with nested container (CT_BlendEffect). */
 interface BlendEffectOptions {
@@ -2087,9 +2087,9 @@ interface HSLEffectOptions {
   /** Hue angle in 60,000ths of a degree (default 0) */
   readonly hue?: number;
   /** Saturation percentage (default 0%) */
-  readonly sat?: number;
+  readonly saturation?: number;
   /** Luminance percentage (default 0%) */
-  readonly lum?: number;
+  readonly luminance?: number;
 }
 /** Luminance effect — adjusts brightness and contrast (CT_LuminanceEffect). */
 interface LuminanceEffectOptions {
@@ -2103,29 +2103,29 @@ interface TintEffectOptions {
   /** Hue angle in 60,000ths of a degree (default 0) */
   readonly hue?: number;
   /** Tint amount percentage (default 0%) */
-  readonly amt?: number;
+  readonly amount?: number;
 }
 /** Relative offset effect (CT_RelativeOffsetEffect). */
 interface RelativeOffsetEffectOptions {
   /** Horizontal offset percentage (default 0%) */
-  readonly tx?: number;
+  readonly translateX?: number;
   /** Vertical offset percentage (default 0%) */
-  readonly ty?: number;
+  readonly translateY?: number;
 }
 /** Transform effect — scale, skew, translate (CT_TransformEffect). */
 interface TransformEffectOptions {
   /** Horizontal scale percentage (default 100%) */
-  readonly sx?: number;
+  readonly scaleX?: number;
   /** Vertical scale percentage (default 100%) */
-  readonly sy?: number;
+  readonly scaleY?: number;
   /** Horizontal skew angle (default 0) */
-  readonly kx?: number;
+  readonly skewX?: number;
   /** Vertical skew angle (default 0) */
-  readonly ky?: number;
+  readonly skewY?: number;
   /** Horizontal translation */
-  readonly tx?: number;
+  readonly translateX?: number;
   /** Vertical translation */
-  readonly ty?: number;
+  readonly translateY?: number;
 }
 /** Effect reference — references an effect by ID (CT_EffectReference). */
 interface EffectReferenceOptions {
@@ -2181,7 +2181,7 @@ interface EffectDagOptions {
   readonly alphaReplace?: AlphaReplaceEffectOptions;
   /** Bi-level effect (threshold) */
   readonly biLevel?: {
-    readonly thresh: number;
+    readonly threshold: number;
   };
   /** Blend effect (requires nested container) */
   readonly blend?: BlendEffectOptions;
@@ -2216,14 +2216,14 @@ interface EffectDagOptions {
  * ```typescript
  * // Simple effect DAG with glow and outer shadow
  * createEffectDag({
- *   glow: { rad: 50800, color: { value: "FF0000" } },
- *   outerShadow: { color: { value: "000000" }, blurRad: 76200 },
+ *   glow: { radius: 50800, color: { value: "FF0000" } },
+ *   outerShadow: { color: { value: "000000" }, blurRadius: 76200 },
  * });
  *
  * // DAG with alpha effects and nested container
  * createEffectDag({
  *   type: "tree",
- *   alphaBiLevel: { thresh: 50000 },
+ *   alphaBiLevel: { threshold: 50000 },
  *   containers: [{
  *     glow: { color: { value: "FF0000" } },
  *   }],
@@ -2717,10 +2717,10 @@ interface PathLineTo {
 /** Arc-to path command (CT_Path2DArcTo). */
 interface PathArcTo {
   readonly command: "arcTo";
-  readonly wR: string;
-  readonly hR: string;
-  readonly stAng: string;
-  readonly swAng: string;
+  readonly widthRadius: string;
+  readonly heightRadius: string;
+  readonly startAngle: string;
+  readonly sweepAngle: string;
 }
 /** Quadratic Bezier-to path command (CT_Path2DQuadBezierTo). */
 interface PathQuadBezTo {
@@ -2788,10 +2788,10 @@ interface AdjustHandlePosition {
  */
 interface XYAdjustHandle {
   readonly type: "xy";
-  readonly gdRefX?: string;
+  readonly guideRefX?: string;
   readonly minX?: string;
   readonly maxX?: string;
-  readonly gdRefY?: string;
+  readonly guideRefY?: string;
   readonly minY?: string;
   readonly maxY?: string;
   readonly position: AdjustHandlePosition;
@@ -2803,12 +2803,12 @@ interface XYAdjustHandle {
  */
 interface PolarAdjustHandle {
   readonly type: "polar";
-  readonly gdRefR?: string;
-  readonly minR?: string;
-  readonly maxR?: string;
-  readonly gdRefAng?: string;
-  readonly minAng?: string;
-  readonly maxAng?: string;
+  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). */
@@ -2820,7 +2820,7 @@ type AdjustHandle = XYAdjustHandle | PolarAdjustHandle;
  */
 interface ConnectionSite {
   /** Angle (absolute value or guide name) */
-  readonly ang: string;
+  readonly angle: string;
   /** Position */
   readonly position: AdjustHandlePosition;
 }
@@ -2831,10 +2831,10 @@ interface ConnectionSite {
  * Coordinates can be absolute values or references to geometry guide names.
  */
 interface GeomRect {
-  readonly l: string;
-  readonly t: string;
-  readonly r: string;
-  readonly b: string;
+  readonly left: string;
+  readonly top: string;
+  readonly right: string;
+  readonly bottom: string;
 }
 /**
  * Options for a custom 2D geometry (CT_CustomGeometry2D).
@@ -2900,6 +2900,7 @@ interface CustomGeometryOptions {
  *       { command: "close" },
  *     ],
  *   }],
+ *   textRect: { left: "2000000", top: "2000000", right: "8000000", bottom: "8000000" },
  * });
  * ```
  */
@@ -3054,6 +3055,34 @@ 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.
@@ -3116,4 +3145,4 @@ interface IMediaTransformation {
  */
 declare const createTransformation: (options: IMediaTransformation) => IMediaDataTransformation;
 //#endregion
-export { type BackdropOptions, type BevelOptions, BevelPresetType, BlendMode, type BlipEffectsOptions, type BlipFillConfigOptions, type BlipFillMediaData, type BlipFillOptions, type BlipOptions, type BlurEffectOptions, type CameraOptions, type ColorTransformOptions, CompoundLine, type ConnectionSite, type CustomGeometryOptions, type DashStop, type EffectContainerType, type EffectDagOptions, type EffectListOptions, type FillOptions, type FillOverlayEffectOptions, type GeomRect, type GeometryGuide, type GlowEffectOptions, type GradientFillOptions, type GradientShadeOptions, type GradientStopOptions, type HslColorOptions, type IGradientStop, type IMediaDataTransformation, type IMediaTransformation, type InnerShadowEffectOptions, type LightRigOptions, LineCap, LineEndLength, type LineEndOptions, LineEndType, LineEndWidth, LineJoin, type LinearShadeOptions, type OuterShadowEffectOptions, type OutlineFillProperties, type OutlineOptions, type PathCommand, type PathFillMode, type PathOptions, type PathShadeOptions, PathShadeType, type PatternFillOptions, PenAlignment, type Point3D, PresetColor, type PresetColorOptions, PresetDash, PresetGeometry, PresetGeometryAttributes, type PresetGeometryOptions, PresetMaterialType, PresetPattern, type PresetShadowEffectOptions, PresetShadowVal, RectAlignment, type ReflectionEffectOptions, type RelativeRect, type RgbColorOptions, type ScRgbColorOptions, type Scene3DOptions, SchemeColor, type SchemeColorOptions, type Shape3DOptions, type SolidFillOptions, type SourceRectangleOptions, type SphereCoords, Stretch, SystemColor, type SystemColorOptions, TileAlignment, TileFlipMode, type TileOptions, type Vector3D, buildFill, createAdjustmentValues, createBevel, createBlip, createBlipEffects, createBlipFill, createBottomBevel, createColorElement, createColorTransforms, createCustomDash, createCustomGeometry, createEffectDag, createEffectList, createExtentionList, createFillOverlayEffect, createGlowEffect, createGradientFill, createGradientStop, createGroupFill, createHslColor, createInnerShadowEffect, createLineEnd, createNoFill, createOuterShadowEffect, createOutline, createPatternFill, createPresetColor, createPresetShadowEffect, createReflectionEffect, createRgbColor, createScRgbColor, createScene3D, createSchemeColor, createShape3D, createSoftEdgeEffect, createSolidFill, createSourceRectangle, createSystemColor, createTileInfo, createTransformation, extractBlipFillMedia };
+export { type BackdropOptions, type BevelOptions, BevelPresetType, BlendMode, type BlipEffectsOptions, type BlipFillConfigOptions, type BlipFillMediaData, type BlipFillOptions, type BlipOptions, type BlurEffectOptions, type CameraOptions, type ColorTransformOptions, CompoundLine, type ConnectionSite, type CustomGeometryOptions, type DashStop, type EffectContainerType, type EffectDagOptions, type EffectListOptions, type FillOptions, type FillOverlayEffectOptions, type GeomRect, type GeometryGuide, type GlowEffectOptions, type GradientFillOptions, type GradientShadeOptions, type GradientStopOptions, type GroupTransform2DOptions, type HslColorOptions, type IGradientStop, type IMediaDataTransformation, type IMediaTransformation, type InnerShadowEffectOptions, type LightRigOptions, LineCap, LineEndLength, type LineEndOptions, LineEndType, LineEndWidth, LineJoin, type LinearShadeOptions, type OuterShadowEffectOptions, type OutlineFillProperties, type OutlineOptions, type PathCommand, type PathFillMode, type PathOptions, type PathShadeOptions, PathShadeType, type PatternFillOptions, PenAlignment, type Point3D, PresetColor, type PresetColorOptions, PresetDash, PresetGeometry, PresetGeometryAttributes, type PresetGeometryOptions, PresetMaterialType, PresetPattern, type PresetShadowEffectOptions, PresetShadowVal, RectAlignment, type ReflectionEffectOptions, type RelativeRect, type RgbColorOptions, type ScRgbColorOptions, type Scene3DOptions, SchemeColor, type SchemeColorOptions, type Shape3DOptions, type SolidFillOptions, type SourceRectangleOptions, type SphereCoords, Stretch, SystemColor, type SystemColorOptions, TileAlignment, TileFlipMode, type TileOptions, type Transform2DOptions, type Vector3D, buildFill, createAdjustmentValues, createBevel, createBlip, createBlipEffects, createBlipFill, createBottomBevel, createColorElement, createColorTransforms, createCustomDash, createCustomGeometry, createEffectDag, createEffectList, createExtentionList, createFillOverlayEffect, createGlowEffect, createGradientFill, createGradientStop, createGroupFill, createGroupTransform2D, createHslColor, createInnerShadowEffect, createLineEnd, createNoFill, createOuterShadowEffect, createOutline, createPatternFill, createPresetColor, createPresetShadowEffect, createReflectionEffect, createRgbColor, createScRgbColor, createScene3D, createSchemeColor, createShape3D, createSoftEdgeEffect, createSolidFill, createSourceRectangle, createSystemColor, createTileInfo, createTransform2D, createTransformation, extractBlipFillMedia };