pptx-craft 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,1795 @@
+/** Measurement in inches. */
+type Inches = number;
+/** Measurement in English Metric Units (914400 EMUs per inch). */
+type Emu = number;
+/** Position and size of an element on a slide, in inches. */
+interface Placement {
+    /** Horizontal offset from the left edge of the slide. */
+    x: Inches;
+    /** Vertical offset from the top edge of the slide. */
+    y: Inches;
+    /** Width of the element. */
+    w: Inches;
+    /** Height of the element. */
+    h: Inches;
+    /** Clockwise rotation in degrees (0–360). */
+    rotation?: number;
+}
+/** Color transform modifiers applied as children of any color element. */
+interface ColorTransform {
+    tint?: number;
+    shade?: number;
+    lumMod?: number;
+    lumOff?: number;
+    alpha?: number;
+    alphaOff?: number;
+    satMod?: number;
+    satOff?: number;
+    hueMod?: number;
+    hueOff?: number;
+}
+/** Theme color role names (ST_SchemeColorVal). */
+type SchemeColorVal = 'dk1' | 'lt1' | 'dk2' | 'lt2' | 'accent1' | 'accent2' | 'accent3' | 'accent4' | 'accent5' | 'accent6' | 'hlink' | 'folHlink' | 'phClr' | 'bg1' | 'bg2' | 'tx1' | 'tx2';
+/** Theme color reference (a:schemeClr). */
+interface SchemeColor {
+    scheme: SchemeColorVal;
+    transforms?: ColorTransform;
+}
+/** System color reference (a:sysClr). */
+interface SystemColor {
+    sys: string;
+    lastClr?: string;
+    transforms?: ColorTransform;
+}
+/** Preset named color (a:prstClr). */
+interface PresetColor {
+    preset: string;
+    transforms?: ColorTransform;
+}
+/** HSL color (a:hslClr). */
+interface HslColor {
+    hue: number;
+    sat: number;
+    lum: number;
+    transforms?: ColorTransform;
+}
+/** sRGB color with optional transforms. */
+interface SrgbColor {
+    hex: string;
+    transforms?: ColorTransform;
+}
+/** Color specification: bare hex string, or a structured color object. */
+type Color = string | SrgbColor | SchemeColor | SystemColor | PresetColor | HslColor;
+/** A single color stop in a gradient fill. */
+interface GradientStop {
+    /** Position along the gradient path (0–100). */
+    position: number;
+    /** Color value (hex string or structured color). */
+    color: Color;
+    /** Opacity percentage (0–100; defaults to 100). */
+    alpha?: number;
+}
+/** Direction mode for a gradient fill. */
+type GradientDirection = 'linear' | 'radial' | 'path';
+/** A gradient fill with one or more color stops. */
+interface GradientFill {
+    /** Gradient direction mode. */
+    type: GradientDirection;
+    /** Ordered color stops defining the gradient. */
+    stops: GradientStop[];
+    /** Angle in degrees for linear gradients. */
+    angle?: number;
+}
+/** DrawingML preset pattern type identifiers (ST_PresetPatternVal). */
+type PatternType = 'pct5' | 'pct10' | 'pct20' | 'pct25' | 'pct30' | 'pct40' | 'pct50' | 'pct60' | 'pct70' | 'pct75' | 'pct80' | 'pct90' | 'horz' | 'vert' | 'ltHorz' | 'ltVert' | 'dkHorz' | 'dkVert' | 'narHorz' | 'narVert' | 'dashHorz' | 'dashVert' | 'cross' | 'dnDiag' | 'upDiag' | 'ltDnDiag' | 'ltUpDiag' | 'dkDnDiag' | 'dkUpDiag' | 'wdDnDiag' | 'wdUpDiag' | 'dashDnDiag' | 'dashUpDiag' | 'diagCross' | 'smCheck' | 'lgCheck' | 'smGrid' | 'lgGrid' | 'dotGrid' | 'smConfetti' | 'lgConfetti' | 'horzBrick' | 'diagBrick' | 'solidDmnd' | 'openDmnd' | 'dotDmnd' | 'plaid' | 'sphere' | 'weave' | 'divot' | 'shingle' | 'wave' | 'trellis' | 'zigZag';
+/** A patterned fill using a foreground/background color pair. */
+interface PatternFill {
+    /** DrawingML preset pattern identifier. */
+    pattern: PatternType;
+    /** Foreground color. */
+    foreground: Color;
+    /** Background color. */
+    background: Color;
+}
+/** A picture (image) used as a fill. */
+interface PictureFill {
+    /** File system path to the image. */
+    path?: string;
+    /** Raw image bytes (mutually exclusive with `path`). */
+    data?: Uint8Array;
+    /** MIME type of the image (e.g. `'image/png'`). */
+    contentType?: string;
+    /** Whether to stretch the image to fill the area (defaults to `true`). */
+    stretch?: boolean;
+    /** Tile parameters for repeating the image. */
+    tile?: {
+        sx: number;
+        sy: number;
+        tx: number;
+        ty: number;
+    };
+}
+/** Fill definition: a hex color string for solid fill, or an object for gradient/pattern/picture. */
+type Fill = string | GradientFill | PatternFill | PictureFill;
+/** Line dash style (ST_PresetLineDashVal). */
+type LineDash = 'solid' | 'dash' | 'dashDot' | 'lgDash' | 'lgDashDot' | 'lgDashDotDot' | 'sysDash' | 'sysDashDot' | 'sysDashDotDot' | 'sysDot' | 'dot';
+/** Line end cap style (ST_LineCap). */
+type LineCap = 'flat' | 'round' | 'square';
+/** Line join style at corners. */
+type LineJoin = 'round' | 'bevel' | 'miter';
+/** Arrowhead / line-end shape type. */
+type LineEndType = 'none' | 'triangle' | 'stealth' | 'diamond' | 'oval' | 'arrow';
+/** Arrowhead size category. */
+type LineEndSize = 'sm' | 'med' | 'lg';
+/** Properties for arrowheads or other line-end decorations. */
+interface LineEndProperties {
+    /** Shape of the line end. */
+    type?: LineEndType;
+    /** Width category of the line end. */
+    width?: LineEndSize;
+    /** Length category of the line end. */
+    length?: LineEndSize;
+}
+/** Stroke/outline formatting for lines and borders. */
+interface LineProperties {
+    /** Stroke color. */
+    color?: Color;
+    /** Stroke width in points. */
+    width?: number;
+    /** Dash pattern. */
+    dash?: LineDash;
+    /** End cap style. */
+    cap?: LineCap;
+    /** Corner join style. */
+    join?: LineJoin;
+    /** Arrowhead at the start of the line. */
+    headEnd?: LineEndProperties;
+    /** Arrowhead at the end of the line. */
+    tailEnd?: LineEndProperties;
+    /** Fill for the line stroke (e.g. gradient line). */
+    fill?: Fill;
+    /** Stroke opacity (0–100). */
+    opacity?: number;
+    /** Compound line type. */
+    compound?: 'sng' | 'dbl' | 'thickThin' | 'thinThick' | 'tri';
+    /** Pen alignment. */
+    alignment?: 'ctr' | 'in';
+    /** Custom dash pattern (pairs of dash length and space length in EMUs). */
+    customDash?: Array<{
+        d: number;
+        sp: number;
+    }>;
+}
+/** Drop shadow or inner shadow effect. */
+interface ShadowEffect {
+    /** Shadow direction relative to the element. */
+    type?: 'outer' | 'inner';
+    /** Shadow color. */
+    color?: Color;
+    /** Shadow opacity (0–100). */
+    alpha?: number;
+    /** Blur radius in points. */
+    blur?: number;
+    /** Distance from the element in points. */
+    offset?: number;
+    /** Shadow direction angle in degrees. */
+    angle?: number;
+}
+/** Outer glow effect surrounding an element. */
+interface GlowEffect {
+    /** Glow color. */
+    color?: Color;
+    /** Glow opacity (0–100). */
+    alpha?: number;
+    /** Glow radius in points. */
+    radius?: number;
+}
+/** Reflection effect beneath an element. */
+interface ReflectionEffect {
+    /** Blur radius of the reflection in points. */
+    blur?: number;
+    /** Starting opacity of the reflection (0–100). */
+    startAlpha?: number;
+    /** Ending opacity of the reflection (0–100). */
+    endAlpha?: number;
+    /** Distance of the reflection from the element in points. */
+    distance?: number;
+    /** Direction angle in degrees. */
+    direction?: number;
+    /** Fade direction angle in degrees. */
+    fadeDirection?: number;
+}
+/** Soft edge (feathered edge) effect. */
+interface SoftEdgeEffect {
+    /** Feather radius in points. */
+    radius?: number;
+}
+/** Combined visual effects applicable to an element. */
+interface EffectProperties {
+    /** Drop shadow or inner shadow. */
+    shadow?: ShadowEffect;
+    /** Outer glow effect. */
+    glow?: GlowEffect;
+    /** Reflection effect. */
+    reflection?: ReflectionEffect;
+    /** Soft/feathered edge effect. */
+    softEdge?: SoftEdgeEffect;
+}
+/** Bevel preset shape. */
+type BevelPreset = 'relaxedInset' | 'circle' | 'slope' | 'cross' | 'angle' | 'softRound' | 'convex' | 'coolSlant' | 'divot' | 'riblet' | 'hardEdge' | 'artDeco';
+/** Bevel (3D edge) properties. */
+interface BevelProperties {
+    width?: number;
+    height?: number;
+    preset?: BevelPreset;
+}
+/** Preset material for 3D rendering. */
+type PresetMaterial = 'matte' | 'warmMatte' | 'plastic' | 'metal' | 'dkEdge' | 'softEdge' | 'flat' | 'softmetal' | 'clear' | 'powder' | 'translucentPowder' | 'legacyMatte' | 'legacyPlastic' | 'legacyMetal' | 'legacyWireframe';
+/** Camera preset for 3D scene. */
+type CameraPreset = 'orthographicFront' | 'isometricTopUp' | 'isometricTopDown' | 'isometricBottomUp' | 'isometricBottomDown' | 'isometricLeftUp' | 'isometricLeftDown' | 'isometricRightUp' | 'isometricRightDown' | 'isometricOffAxis1Left' | 'isometricOffAxis1Right' | 'isometricOffAxis1Top' | 'isometricOffAxis2Left' | 'isometricOffAxis2Right' | 'isometricOffAxis2Top' | 'obliqueTopLeft' | 'obliqueTop' | 'obliqueTopRight' | 'obliqueLeft' | 'obliqueRight' | 'obliqueBottomLeft' | 'obliqueBottom' | 'obliqueBottomRight' | 'perspectiveFront' | 'perspectiveLeft' | 'perspectiveRight' | 'perspectiveAbove' | 'perspectiveBelow' | 'perspectiveAboveLeftFacing' | 'perspectiveAboveRightFacing' | 'perspectiveContrastingLeftFacing' | 'perspectiveContrastingRightFacing' | 'perspectiveHeroicLeftFacing' | 'perspectiveHeroicRightFacing' | 'perspectiveHeroicExtremeLeftFacing' | 'perspectiveHeroicExtremeRightFacing' | 'perspectiveRelaxed' | 'perspectiveRelaxedModerately';
+/** Light rig type for 3D scene. */
+type LightRigType = 'flood' | 'contrasting' | 'morning' | 'sunrise' | 'sunset' | 'chilly' | 'freezing' | 'flat' | 'twoPt' | 'glow' | 'brightRoom' | 'soft' | 'harsh' | 'balanced' | 'legacyFlat1' | 'legacyFlat2' | 'legacyFlat3' | 'legacyFlat4' | 'legacyNormal1' | 'legacyNormal2' | 'legacyNormal3' | 'legacyNormal4' | 'legacyHarsh1' | 'legacyHarsh2' | 'legacyHarsh3' | 'legacyHarsh4' | 'threePt';
+/** Light rig direction. */
+type LightRigDirection = 't' | 'tl' | 'tr' | 'b' | 'bl' | 'br' | 'l' | 'r';
+/** 3D scene properties (camera + lighting). */
+interface Scene3DProperties {
+    camera?: {
+        preset?: CameraPreset;
+        fov?: number;
+    };
+    lightRig?: {
+        type?: LightRigType;
+        direction?: LightRigDirection;
+    };
+}
+/** 3D shape properties (extrusion, bevels, material). */
+interface Shape3DProperties {
+    bevelTop?: BevelProperties;
+    bevelBottom?: BevelProperties;
+    extrusionHeight?: number;
+    contourWidth?: number;
+    extrusionColor?: Color;
+    contourColor?: Color;
+    material?: PresetMaterial;
+}
+/** 2-D transform properties (rotation and flip). */
+interface TransformProperties {
+    /** Clockwise rotation in degrees (0–360). */
+    rotation?: number;
+    /** Mirror horizontally. */
+    flipH?: boolean;
+    /** Mirror vertically. */
+    flipV?: boolean;
+}
+/** Hyperlink target (external URL or internal slide jump). */
+interface HyperlinkProperties {
+    /** External URL target. */
+    url?: string;
+    /** Internal slide number to jump to (1-based). */
+    slide?: number;
+    /** Hover tooltip text. */
+    tooltip?: string;
+    /** Email address (generates mailto: link). */
+    email?: string;
+    /** Local file path link. */
+    file?: string;
+    /** Action string (e.g. 'ppaction://hlinkshowjump?jump=nextslide'). */
+    action?: string;
+}
+/** Theme color scheme mapping the 12 standard DrawingML color roles. */
+interface ColorScheme {
+    /** Dark 1 color (typically used for text on light backgrounds). */
+    dk1: string;
+    /** Light 1 color (typically used for backgrounds). */
+    lt1: string;
+    /** Dark 2 color. */
+    dk2: string;
+    /** Light 2 color. */
+    lt2: string;
+    /** Accent color 1. */
+    accent1: string;
+    /** Accent color 2. */
+    accent2: string;
+    /** Accent color 3. */
+    accent3: string;
+    /** Accent color 4. */
+    accent4: string;
+    /** Accent color 5. */
+    accent5: string;
+    /** Accent color 6. */
+    accent6: string;
+    /** Hyperlink color. */
+    hlink: string;
+    /** Followed hyperlink color. */
+    folHlink: string;
+}
+/** Theme font scheme defining major (heading) and minor (body) typefaces. */
+interface FontScheme {
+    /** Typeface for headings. */
+    majorFont: string;
+    /** Typeface for body text. */
+    minorFont: string;
+    /** East Asian typeface for headings. */
+    majorEastAsian?: string;
+    /** Complex script typeface for headings. */
+    majorComplexScript?: string;
+    /** East Asian typeface for body text. */
+    minorEastAsian?: string;
+    /** Complex script typeface for body text. */
+    minorComplexScript?: string;
+}
+/** Presentation theme defining colors, fonts, and a display name. */
+interface Theme {
+    /** Theme display name. */
+    name: string;
+    /** Color scheme with the 12 standard roles. */
+    colors: ColorScheme;
+    /** Font scheme for headings and body text. */
+    fonts: FontScheme;
+    /** Additional color schemes (rendered as `a:extraClrSchemeLst`). */
+    extraColorSchemes?: ColorScheme[];
+}
+/** String discriminator identifying an element's kind (e.g. `'text'`, `'shape'`). */
+type ElementType = string;
+/** Base interface implemented by all slide elements. */
+interface IElement {
+    /** Element type discriminator. */
+    readonly type: ElementType;
+    /** Position and size on the slide. */
+    placement: Placement;
+    /** Optional descriptive name (used in OOXML `nvSpPr`). */
+    name?: string;
+}
+/** Context passed to element serializers during OOXML generation. */
+interface SerializationContext {
+    /** Registers a relationship and returns its `rId`. */
+    addRelationship(type: string, target: string, data?: Uint8Array): string;
+    /** The active presentation theme. */
+    theme: Theme;
+    /** Zero-based index of the slide being serialized. */
+    slideIndex: number;
+}
+/** Serializer that converts an element instance to OOXML markup. */
+interface IElementSerializer<E extends IElement = IElement> {
+    /** Element type this serializer handles. */
+    type: ElementType;
+    /** Produces OOXML XML string for the given element. */
+    serialize(element: E, ctx: SerializationContext): string;
+}
+/** Plugin that extends serialization capabilities by registering new element types. */
+interface IPlugin {
+    /** Unique plugin name. */
+    name: string;
+    /** Called once to install serializers into the registry. */
+    install(registry: IRegistry): void;
+}
+/** Registry for looking up element serializers by type. */
+interface IRegistry {
+    /** Registers a serializer for the given element type. */
+    registerElement<E extends IElement>(type: ElementType, serializer: IElementSerializer<E>): void;
+    /** Returns the serializer for the given element type, or `undefined`. */
+    getSerializer(type: ElementType): IElementSerializer | undefined;
+}
+/** Bullet point configuration for paragraph lists. */
+interface BulletOptions {
+    /** Bullet kind: `'char'` for a custom character, `'auto'` for automatic. */
+    type?: 'char' | 'auto';
+    /** Custom bullet character (e.g. `'•'`, `'–'`). */
+    char?: string;
+    /** Bullet color. */
+    color?: Color;
+    /** Bullet size as a percentage of the text size. */
+    size?: number;
+    /** Bullet font face name. */
+    font?: string;
+}
+/** Numbered list configuration for paragraph lists. */
+interface NumberingOptions {
+    /** Numbering scheme (e.g. `'arabicPeriod'`, `'romanUcPeriod'`). */
+    type?: 'arabicPeriod' | 'arabicParenR' | 'romanUcPeriod' | 'romanLcPeriod' | 'alphaUcPeriod' | 'alphaLcPeriod' | 'arabicPlain';
+    /** Starting number (defaults to 1). */
+    startAt?: number;
+    /** Number color. */
+    color?: Color;
+    /** Number size as a percentage of the text size. */
+    size?: number;
+    /** Number font face name. */
+    font?: string;
+}
+/** A custom tab stop position within a paragraph. */
+interface TabStop {
+    /** Tab position in points from the left margin. */
+    position: number;
+    /** Tab alignment: left, center, right, or decimal. */
+    alignment?: 'l' | 'ctr' | 'r' | 'dec';
+}
+/** Character-level formatting options for a text run (a:rPr). */
+interface TextRunOptions {
+    /** Bold weight. */
+    bold?: boolean;
+    /** Italic style. */
+    italic?: boolean;
+    /** Single underline. */
+    underline?: boolean;
+    /** Strikethrough style. */
+    strikethrough?: boolean | 'single' | 'double';
+    /** Font size in points. */
+    fontSize?: number;
+    /** Font face name (e.g. `'Arial'`). */
+    fontFace?: string;
+    /** Text color. */
+    color?: Color;
+    /** Render as subscript. */
+    subscript?: boolean;
+    /** Render as superscript. */
+    superscript?: boolean;
+    /** Highlight/background color behind the text. */
+    highlight?: Color;
+    /** Tracked letter spacing in points. */
+    letterSpacing?: number;
+    /** Baseline offset percentage for super/subscript positioning. */
+    baseline?: number;
+    /** Clickable hyperlink attached to this run. */
+    hyperlink?: HyperlinkProperties;
+    /** Text outline/stroke formatting. */
+    outline?: LineProperties;
+    /** Text shadow effect. */
+    shadow?: ShadowEffect;
+    /** Capitalization mode. */
+    caps?: 'none' | 'small' | 'all';
+    /** Language code (e.g. `'en-US'`). */
+    lang?: string;
+    /** East Asian font face (a:ea typeface). */
+    eastAsianFont?: string;
+    /** Complex script font face (a:cs typeface). */
+    complexScriptFont?: string;
+    /** Alternate language tag (e.g. `'ja-JP'`). */
+    altLang?: string;
+}
+/** Paragraph-level formatting options (a:pPr). */
+interface ParagraphOptions {
+    /** Horizontal text alignment. */
+    align?: 'left' | 'center' | 'right' | 'justify';
+    /** Line spacing — number = points, or `{ value, unit }` for explicit unit. */
+    lineSpacing?: number | {
+        value: number;
+        unit: 'pt' | 'pct';
+    };
+    /** Space before — number = points, or `{ value, unit }` for explicit unit. */
+    spaceBefore?: number | {
+        value: number;
+        unit: 'pt' | 'pct';
+    };
+    /** Space after — number = points, or `{ value, unit }` for explicit unit. */
+    spaceAfter?: number | {
+        value: number;
+        unit: 'pt' | 'pct';
+    };
+    /** First-line indent in points (negative = hanging indent). */
+    indent?: number;
+    /** Left margin/indent in points. */
+    marginLeft?: number;
+    /** Outline/indent level (0–8). */
+    level?: number;
+    /** Right-to-left text direction. */
+    rtl?: boolean;
+    /** Bullet configuration, or `true` for a default bullet. */
+    bullet?: BulletOptions | boolean;
+    /** Numbered list configuration. */
+    numbering?: NumberingOptions;
+    /** Custom tab stop positions. */
+    tabStops?: TabStop[];
+    /** Default run-level formatting applied to all runs in this paragraph (a:defRPr). */
+    defaultRunOptions?: TextRunOptions;
+}
+/** Text body formatting options (a:bodyPr). */
+interface TextBodyOptions {
+    /** Vertical text anchor within the text box. */
+    verticalAlign?: 'top' | 'middle' | 'bottom';
+    /** Text flow direction. */
+    textDirection?: 'horz' | 'vert' | 'vert270' | 'wordArtVert';
+    /** Whether text wraps at the text box boundary. */
+    wordWrap?: boolean;
+    /** Auto-fit behavior for overflowing text. */
+    autoFit?: boolean | 'shrink' | 'none';
+    /** Internal text box margins/insets in points. */
+    margin?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    /** Number of text columns. */
+    columns?: number;
+    /** Spacing between text columns in points. */
+    columnSpacing?: number;
+    /** WordArt text-path transform preset. */
+    textPath?: {
+        preset: string;
+    };
+}
+/** Combined options for adding a text element (placement + run + paragraph + body + shape styling). */
+interface TextOptions extends Partial<Placement>, TextRunOptions, ParagraphOptions, TextBodyOptions {
+    /** Text box background fill. */
+    fill?: Fill;
+    /** Text box border/outline. */
+    line?: LineProperties;
+    /** Visual effects on the text box shape. */
+    effects?: EffectProperties;
+    /** Rotation and flip for the text box. */
+    transform?: TransformProperties;
+    /** 3D scene (camera + lighting). */
+    scene3d?: Scene3DProperties;
+    /** 3D shape (extrusion, bevels, material). */
+    shape3d?: Shape3DProperties;
+}
+/** Options for adding an image element to a slide. */
+interface ImageOptions extends Partial<Placement> {
+    /** File system path to the image. */
+    path?: string;
+    /** Raw image bytes (mutually exclusive with `path`). */
+    data?: Uint8Array;
+    /** MIME type of the image (e.g. `'image/png'`). */
+    contentType?: string;
+    /** Image border/outline. */
+    border?: LineProperties;
+    /** Visual effects (shadow, glow, etc.). */
+    effects?: EffectProperties;
+    /** Rotation and flip. */
+    transform?: TransformProperties;
+    /** 3D scene (camera + lighting). */
+    scene3d?: Scene3DProperties;
+    /** 3D shape (extrusion, bevels, material). */
+    shape3d?: Shape3DProperties;
+    /** Image opacity (0–100). */
+    opacity?: number;
+    /** Cropping percentages (0–100) from each edge. */
+    crop?: {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+    };
+    /** Clickable hyperlink on the image. */
+    hyperlink?: HyperlinkProperties;
+    /** How the image fills its bounding box. */
+    sizing?: {
+        type: 'contain' | 'cover' | 'crop';
+        align?: 'tl' | 'tc' | 'tr' | 'ml' | 'mc' | 'mr' | 'bl' | 'bc' | 'br';
+    };
+    /** Lock the aspect ratio when resizing (defaults to `true`). */
+    lockAspectRatio?: boolean;
+    /** Brightness adjustment (-100 to 100). */
+    brightness?: number;
+    /** Contrast adjustment (-100 to 100). */
+    contrast?: number;
+    /** Color saturation (0 to 200, 100 = normal). */
+    saturation?: number;
+    /** Duotone recolor using two colors. */
+    duotone?: {
+        color1: Color;
+        color2: Color;
+    };
+    /** Crop to a preset geometry shape instead of rectangle. */
+    cropShape?: PresetGeometry;
+}
+/** DrawingML preset geometry type (ST_ShapeType). */
+type PresetGeometry = 'rect' | 'roundRect' | 'ellipse' | 'triangle' | 'diamond' | 'line' | 'arrow' | 'star5' | 'heart' | 'accentBorderCallout1' | 'accentBorderCallout2' | 'accentBorderCallout3' | 'accentCallout1' | 'accentCallout2' | 'accentCallout3' | 'actionButtonBackPrevious' | 'actionButtonBeginning' | 'actionButtonBlank' | 'actionButtonDocument' | 'actionButtonEnd' | 'actionButtonForwardNext' | 'actionButtonHelp' | 'actionButtonHome' | 'actionButtonInformation' | 'actionButtonMovie' | 'actionButtonReturn' | 'actionButtonSound' | 'arc' | 'bentArrow' | 'bentUpArrow' | 'bevel' | 'blockArc' | 'borderCallout1' | 'borderCallout2' | 'borderCallout3' | 'bracePair' | 'bracketPair' | 'callout1' | 'callout2' | 'callout3' | 'can' | 'chartPlus' | 'chartStar' | 'chartX' | 'chevron' | 'chord' | 'circularArrow' | 'cloud' | 'cloudCallout' | 'corner' | 'cornerTabs' | 'cross' | 'cube' | 'curvedConnector2' | 'curvedConnector3' | 'curvedConnector4' | 'curvedConnector5' | 'curvedDownArrow' | 'curvedLeftArrow' | 'curvedRightArrow' | 'curvedUpArrow' | 'decagon' | 'diagStripe' | 'dodecagon' | 'donut' | 'doubleWave' | 'downArrow' | 'downArrowCallout' | 'ellipseRibbon' | 'ellipseRibbon2' | 'flowChartAlternateProcess' | 'flowChartCollate' | 'flowChartConnector' | 'flowChartDecision' | 'flowChartDelay' | 'flowChartDisplay' | 'flowChartDocument' | 'flowChartExtract' | 'flowChartInputOutput' | 'flowChartInternalStorage' | 'flowChartMagneticDisk' | 'flowChartMagneticDrum' | 'flowChartMagneticTape' | 'flowChartManualInput' | 'flowChartManualOperation' | 'flowChartMerge' | 'flowChartMultidocument' | 'flowChartOfflineStorage' | 'flowChartOffpageConnector' | 'flowChartOnlineStorage' | 'flowChartOr' | 'flowChartPredefinedProcess' | 'flowChartPreparation' | 'flowChartProcess' | 'flowChartPunchedCard' | 'flowChartPunchedTape' | 'flowChartSort' | 'flowChartSummingJunction' | 'flowChartTerminator' | 'foldedCorner' | 'frame' | 'funnel' | 'gear6' | 'gear9' | 'halfFrame' | 'heptagon' | 'hexagon' | 'homePlate' | 'horizontalScroll' | 'irregularSeal1' | 'irregularSeal2' | 'leftArrow' | 'leftArrowCallout' | 'leftBrace' | 'leftBracket' | 'leftCircularArrow' | 'leftRightArrow' | 'leftRightArrowCallout' | 'leftRightCircularArrow' | 'leftRightRibbon' | 'leftRightUpArrow' | 'leftUpArrow' | 'lightningBolt' | 'lineInv' | 'mathDivide' | 'mathEqual' | 'mathMinus' | 'mathMultiply' | 'mathNotEqual' | 'mathPlus' | 'moon' | 'noSmoking' | 'nonIsoscelesTrapezoid' | 'notchedRightArrow' | 'octagon' | 'parallelogram' | 'pentagon' | 'pie' | 'pieWedge' | 'plaque' | 'plaqueTabs' | 'plus' | 'quadArrow' | 'quadArrowCallout' | 'ribbon' | 'ribbon2' | 'rightArrow' | 'rightArrowCallout' | 'rightBrace' | 'rightBracket' | 'round1Rect' | 'round2DiagRect' | 'round2SameRect' | 'rtTriangle' | 'smileyFace' | 'snip1Rect' | 'snip2DiagRect' | 'snip2SameRect' | 'snipRoundRect' | 'squareTabs' | 'star10' | 'star12' | 'star16' | 'star24' | 'star32' | 'star4' | 'star6' | 'star7' | 'star8' | 'straightConnector1' | 'stripedRightArrow' | 'sun' | 'swooshArrow' | 'teardrop' | 'trapezoid' | 'upArrow' | 'upArrowCallout' | 'upDownArrow' | 'upDownArrowCallout' | 'uturnArrow' | 'verticalScroll' | 'wave' | 'wedgeEllipseCallout' | 'wedgeRectCallout' | 'wedgeRoundRectCallout';
+/** Text body options when text is placed inside a shape. */
+interface ShapeTextOptions {
+    /** Vertical text anchor within the shape. */
+    verticalAlign?: 'top' | 'middle' | 'bottom';
+    /** Whether text wraps inside the shape. */
+    wordWrap?: boolean;
+    /** Internal text margins/insets in points. */
+    margin?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    /** Auto-fit behavior for overflowing text. */
+    autoFit?: boolean | 'shrink' | 'none';
+}
+/** Path command for custom geometry. */
+type PathCommand = {
+    type: 'moveTo';
+    x: number;
+    y: number;
+} | {
+    type: 'lineTo';
+    x: number;
+    y: number;
+} | {
+    type: 'arcTo';
+    wR: number;
+    hR: number;
+    stAng: number;
+    swAng: number;
+} | {
+    type: 'cubicBezTo';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    x: number;
+    y: number;
+} | {
+    type: 'close';
+};
+/** A custom geometry path. */
+interface CustomGeometryPath {
+    w?: number;
+    h?: number;
+    commands: PathCommand[];
+}
+/** Custom geometry definition. */
+interface CustomGeometry {
+    paths: CustomGeometryPath[];
+}
+/** Shape protection locks. */
+interface ShapeLocks {
+    noGroup?: boolean;
+    noRotation?: boolean;
+    noMove?: boolean;
+    noResize?: boolean;
+    noSelect?: boolean;
+    noTextEdit?: boolean;
+}
+/** Options for adding a preset geometry shape to a slide. */
+interface ShapeOptions extends Partial<Placement> {
+    /** Shape background fill. */
+    fill?: Fill;
+    /** Shape outline/border. */
+    line?: LineProperties;
+    /** Visual effects (shadow, glow, etc.). */
+    effects?: EffectProperties;
+    /** Rotation and flip. */
+    transform?: TransformProperties;
+    /** 3D scene (camera + lighting). */
+    scene3d?: Scene3DProperties;
+    /** 3D shape (extrusion, bevels, material). */
+    shape3d?: Shape3DProperties;
+    /** Shape opacity (0–100). */
+    opacity?: number;
+    /** Plain text to display inside the shape. */
+    text?: string;
+    /** Text body formatting for the shape's inner text. */
+    textOptions?: ShapeTextOptions;
+    /** Run-level formatting for the shape's inner text. */
+    textRunOptions?: TextRunOptions;
+    /** Paragraph-level formatting for the shape's inner text. */
+    textParagraphOptions?: ParagraphOptions;
+    /** Preset geometry adjustment handle values (a:avLst). */
+    adjustValues?: Record<string, number>;
+    /** Clickable hyperlink on the shape. */
+    hyperlink?: HyperlinkProperties;
+    /** Custom geometry paths (overrides preset geometry). */
+    customGeometry?: CustomGeometry;
+    /** Shape protection locks. */
+    locks?: ShapeLocks;
+}
+/** Border definition for a single side of a table cell. */
+interface TableCellBorder {
+    /** Border color. */
+    color?: Color;
+    /** Border width in points. */
+    width?: number;
+}
+/** A single cell within a table row. */
+interface TableCell {
+    /** Plain text content of the cell. */
+    text: string;
+    /** Cell formatting options (run-level text styling plus cell-specific properties). */
+    options?: TextRunOptions & {
+        /** Cell background fill. */
+        fill?: Fill;
+        /** Number of columns this cell spans. */
+        colSpan?: number;
+        /** Number of rows this cell spans. */
+        rowSpan?: number;
+        /** Cell internal padding in points. */
+        margin?: {
+            top?: number;
+            right?: number;
+            bottom?: number;
+            left?: number;
+        };
+        /** Vertical text alignment within the cell. */
+        verticalAlign?: 'top' | 'middle' | 'bottom' | 'distributed';
+        /** Text body formatting for the cell. */
+        textBody?: TextBodyOptions;
+        /** Left border override. */
+        borderLeft?: TableCellBorder;
+        /** Right border override. */
+        borderRight?: TableCellBorder;
+        /** Top border override. */
+        borderTop?: TableCellBorder;
+        /** Bottom border override. */
+        borderBottom?: TableCellBorder;
+        /** Horizontal text alignment within the cell. */
+        align?: 'left' | 'center' | 'right' | 'justify';
+    };
+}
+/** An array of table cells forming one row. */
+type TableRow = TableCell[];
+/** Border configuration for the entire table, with optional per-side overrides. */
+interface TableBorderOptions {
+    /** Default border color. */
+    color?: Color;
+    /** Default border width in points. */
+    width?: number;
+    /** Left edge border override. */
+    left?: TableCellBorder;
+    /** Right edge border override. */
+    right?: TableCellBorder;
+    /** Top edge border override. */
+    top?: TableCellBorder;
+    /** Bottom edge border override. */
+    bottom?: TableCellBorder;
+    /** Inside horizontal border override. */
+    insideH?: TableCellBorder;
+    /** Inside vertical border override. */
+    insideV?: TableCellBorder;
+}
+/** Options for adding a table element to a slide. */
+interface TableOptions extends Partial<Placement> {
+    /** Column widths in inches. */
+    colWidths?: number[];
+    /** Row heights in inches. */
+    rowHeights?: number[];
+    /** Table border configuration. */
+    border?: TableBorderOptions;
+    /** Table background fill. */
+    fill?: Fill;
+    /** Enable special formatting for the first (header) row. */
+    firstRow?: boolean;
+    /** Enable special formatting for the last (total) row. */
+    lastRow?: boolean;
+    /** Enable special formatting for the first column. */
+    firstCol?: boolean;
+    /** Enable special formatting for the last column. */
+    lastCol?: boolean;
+    /** Enable alternating row fill banding. */
+    bandRow?: boolean;
+    /** Enable alternating column fill banding. */
+    bandCol?: boolean;
+    /** Pair of colors for alternating row fills when `bandRow` is enabled. */
+    bandRowColors?: [Color, Color];
+    /** Visual effects on the table shape. */
+    effects?: EffectProperties;
+    /** Rotation and flip. */
+    transform?: TransformProperties;
+    /** Built-in table style GUID. */
+    tableStyleId?: string;
+}
+/** Supported chart type identifiers, including 3-D variants. */
+type ChartType = 'bar' | 'col' | 'line' | 'pie' | 'area' | 'scatter' | 'doughnut' | 'radar' | 'bubble' | 'stock' | 'surface' | 'bar3D' | 'col3D' | 'line3D' | 'pie3D' | 'area3D';
+/** Data point marker options for line/scatter charts. */
+interface ChartMarkerOptions {
+    /** Marker shape. */
+    type?: 'circle' | 'square' | 'diamond' | 'triangle' | 'star' | 'x' | 'plus' | 'none';
+    /** Marker size (2–72). */
+    size?: number;
+    /** Marker fill color. */
+    fill?: Color;
+    /** Marker border. */
+    border?: {
+        color?: Color;
+        width?: number;
+    };
+}
+/** A single data series within a chart. */
+/** Trendline configuration for a chart series. */
+interface TrendlineOptions {
+    type?: 'linear' | 'exp' | 'log' | 'movingAvg' | 'poly' | 'power';
+    order?: number;
+    period?: number;
+    forward?: number;
+    backward?: number;
+    intercept?: number;
+    displayEquation?: boolean;
+    displayRSquared?: boolean;
+    color?: Color;
+    width?: number;
+    dash?: LineDash;
+}
+/** Error bar configuration for a chart series. */
+interface ErrorBarOptions {
+    direction?: 'x' | 'y';
+    type?: 'both' | 'plus' | 'minus';
+    valueType?: 'fixedVal' | 'percentage' | 'stdDev' | 'stdErr' | 'cust';
+    value?: number;
+    noEndCap?: boolean;
+    color?: Color;
+    width?: number;
+}
+/** Data label configuration for chart series or chart-level. */
+interface DataLabelOptions {
+    position?: 'ctr' | 'inEnd' | 'outEnd' | 'bestFit' | 't' | 'b' | 'l' | 'r';
+    showValue?: boolean;
+    showCategory?: boolean;
+    showSeriesName?: boolean;
+    showPercent?: boolean;
+    separator?: string;
+    numberFormat?: string;
+    fontSize?: number;
+    fontFace?: string;
+    color?: Color;
+}
+interface ChartSeries {
+    /** Display name for this series (shown in legend). */
+    name: string;
+    /** Data point values. */
+    values: number[];
+    /** Series fill/line color. */
+    color?: Color;
+    /** Per-data-point colors (e.g. for pie slices). */
+    colors?: Color[];
+    /** Line width in points (line/scatter charts). */
+    lineWidth?: number;
+    /** Line dash style (line/scatter charts). */
+    lineDash?: LineDash;
+    /** Data point marker options (line/scatter charts). */
+    marker?: ChartMarkerOptions;
+    /** Smooth curve interpolation for line charts. */
+    smooth?: boolean;
+    /** Series area fill color (area charts). */
+    fill?: Color;
+    /** Series fill opacity (0–100). */
+    opacity?: number;
+    /** Trendline for this series. */
+    trendline?: TrendlineOptions;
+    /** Error bars for this series. */
+    errorBars?: ErrorBarOptions;
+    /** Per-series data labels. */
+    dataLabels?: DataLabelOptions;
+    /** Explosion distance for individual pie/doughnut slices. */
+    explosion?: number;
+}
+/** Data input for a chart element. */
+interface ChartData {
+    /** Category axis labels. */
+    categories?: string[];
+    /** One or more data series. */
+    series: ChartSeries[];
+    /** X-axis values for scatter/bubble charts. */
+    xValues?: number[];
+    /** Bubble size values for bubble charts. */
+    bubbleSizes?: number[];
+}
+/** Configuration options for a chart axis. */
+interface AxisOptions {
+    /** Axis title text. */
+    title?: string;
+    /** Axis title font size in points. */
+    titleFontSize?: number;
+    /** Minimum axis value. */
+    min?: number;
+    /** Maximum axis value. */
+    max?: number;
+    /** Interval between major tick marks. */
+    majorUnit?: number;
+    /** Interval between minor tick marks. */
+    minorUnit?: number;
+    /** Axis value ordering. */
+    orientation?: 'minMax' | 'maxMin';
+    /** Axis label font size in points. */
+    labelFontSize?: number;
+    /** Axis label color. */
+    labelColor?: Color;
+    /** Axis label rotation in degrees. */
+    labelRotation?: number;
+    /** Number format string (e.g. `'#,##0'`). */
+    format?: string;
+    /** Axis position relative to the plot area. */
+    position?: 'b' | 't' | 'l' | 'r';
+    /** Hide the axis entirely. */
+    delete?: boolean;
+    /** Show major gridlines (or configure with color/width). */
+    majorGridlines?: boolean | {
+        color?: Color;
+        width?: number;
+    };
+    /** Show minor gridlines (or configure with color/width). */
+    minorGridlines?: boolean | {
+        color?: Color;
+        width?: number;
+    };
+    /** Value where the perpendicular axis crosses. */
+    crossesAt?: number | 'min' | 'max' | 'auto';
+    /** Logarithmic scale base (e.g. 10). */
+    logBase?: number;
+}
+/** Options for adding a chart element to a slide. */
+interface ChartOptions extends Partial<Placement> {
+    /** Chart title text. */
+    title?: string;
+    /** Show the chart legend. */
+    showLegend?: boolean;
+    /** Show data labels on data points. */
+    showDataLabels?: boolean;
+    /** Show value axis gridlines. */
+    showGridLines?: boolean;
+    /** Chart title font size in points. */
+    titleFontSize?: number;
+    /** Chart title color. */
+    titleColor?: Color;
+    /** Legend position relative to the chart. */
+    legendPosition?: 'b' | 't' | 'l' | 'r' | 'tr';
+    /** Category axis configuration. */
+    catAxis?: AxisOptions;
+    /** Primary value axis configuration. */
+    valAxis?: AxisOptions;
+    /** Secondary value axis configuration. */
+    secondaryValAxis?: AxisOptions;
+    /** Plot area background styling. */
+    plotArea?: {
+        fill?: Color;
+        border?: LineProperties;
+    };
+    /** Gap width between bar/column groups (0–500 percent). */
+    barGapWidth?: number;
+    /** Bar/column overlap (-100 to 100 percent). */
+    barOverlap?: number;
+    /** Bar/column grouping mode. */
+    barGrouping?: 'clustered' | 'stacked' | 'percentStacked';
+    /** Pie/doughnut slice explosion distance (0–400 percent). */
+    pieExplosion?: number;
+    /** Doughnut hole size (10–90 percent). */
+    doughnutHoleSize?: number;
+    /** Line chart grouping mode. */
+    lineGrouping?: 'standard' | 'stacked' | 'percentStacked';
+    /** Area chart grouping mode. */
+    areaGrouping?: 'standard' | 'stacked' | 'percentStacked';
+    /** Scatter chart display style. */
+    scatterStyle?: 'lineMarker' | 'line' | 'marker' | 'smooth' | 'smoothMarker';
+    /** Radar chart display style. */
+    radarStyle?: 'standard' | 'marker' | 'filled';
+    /** Chart area border. */
+    border?: LineProperties;
+    /** Chart area background color. */
+    fill?: Color;
+    /** Chart-level data label configuration. */
+    dataLabels?: DataLabelOptions;
+    /** 3-D view / camera settings. */
+    view3D?: {
+        /** X-axis rotation in degrees. */
+        rotX?: number;
+        /** Y-axis rotation in degrees. */
+        rotY?: number;
+        /** Depth of the 3-D area as a percentage. */
+        depthPercent?: number;
+        /** Use right-angle axes (orthographic). */
+        rAngAx?: boolean;
+        /** Perspective field-of-view in degrees. */
+        perspective?: number;
+    };
+}
+/** Playback settings for embedded video or audio media. */
+interface MediaPlaybackOptions {
+    /** Start playback at this time offset in milliseconds. */
+    start?: number;
+    /** End playback at this time offset in milliseconds. */
+    end?: number;
+    /** Loop playback continuously. */
+    loop?: boolean;
+    /** Begin playing automatically when the slide is shown. */
+    autoPlay?: boolean;
+    /** Mute audio. */
+    mute?: boolean;
+    /** Show playback controls (defaults to `true`). */
+    showControls?: boolean;
+    /** Rewind to the beginning after playback ends. */
+    rewind?: boolean;
+    /** Play in fullscreen mode. */
+    fullscreen?: boolean;
+}
+/** Poster/thumbnail image displayed before media playback begins. */
+interface MediaPoster {
+    /** File system path to the poster image. */
+    path?: string;
+    /** Raw poster image bytes. */
+    data?: Uint8Array;
+    /** MIME type of the poster image. */
+    contentType?: string;
+}
+/** Options for adding a video or audio media element to a slide. */
+interface MediaOptions extends Partial<Placement> {
+    /** File system path to the media file. */
+    path?: string;
+    /** Raw media bytes (mutually exclusive with `path`). */
+    data?: Uint8Array;
+    /** MIME type (defaults to `'video/mp4'` or `'audio/mpeg'`). */
+    contentType?: string;
+    /** Poster/thumbnail image for the media. */
+    poster?: MediaPoster;
+    /** Playback settings (autoplay, loop, timing, etc.). */
+    playback?: MediaPlaybackOptions;
+    /** Visual effects on the media frame. */
+    effects?: EffectProperties;
+    /** Rotation and flip. */
+    transform?: TransformProperties;
+}
+/** Slideshow playback behavior properties. */
+interface SlideShowProperties {
+    /** Loop the slideshow continuously. */
+    loop?: boolean;
+    /** Play embedded narration audio. */
+    showNarration?: boolean;
+    /** Play slide animations. */
+    showAnimation?: boolean;
+    /** Use recorded slide timings for auto-advance. */
+    useTimings?: boolean;
+}
+/** Print-related presentation properties. */
+interface PrintProperties {
+    /** Print a border frame around each slide. */
+    frameSlides?: boolean;
+    /** Include hidden slides when printing. */
+    hiddenSlides?: boolean;
+}
+/** Presentation-level properties (slideshow behavior, print options). */
+interface PresentationProperties {
+    /** Slideshow playback properties. */
+    slideShow?: SlideShowProperties;
+    /** Print properties. */
+    print?: PrintProperties;
+}
+/** Identifier for the last-used PowerPoint editing view. */
+type LastViewType = 'sldView' | 'sldMasterView' | 'notesView' | 'handoutView' | 'sldSorterView';
+/** View properties controlling which editing view opens by default. */
+interface ViewProperties {
+    /** The view that was active when the presentation was last saved. */
+    lastView?: LastViewType;
+}
+/** A registered comment author for slide comments. */
+interface CommentAuthor {
+    /** Unique author identifier (0-based). */
+    id: number;
+    /** Display name of the author. */
+    name: string;
+    /** Author initials shown in comment badges. */
+    initials: string;
+    /** Index of the author's most recent comment. */
+    lastIdx: number;
+    /** Color index for the author's comment badge. */
+    clrIdx: number;
+}
+/** A comment attached to a slide. */
+interface SlideComment {
+    /** ID of the comment author (from {@link CommentAuthor.id}). */
+    authorId: number;
+    /** Comment text content. */
+    text: string;
+    /** ISO 8601 date string when the comment was created. */
+    date?: string;
+    /** Position of the comment anchor on the slide (in points). */
+    position?: {
+        x: number;
+        y: number;
+    };
+    /** Sequential comment index within the slide. */
+    index?: number;
+}
+/** A user-defined key-value tag. */
+interface UserDefinedTag {
+    /** Tag name/key. */
+    name: string;
+    /** Tag value. */
+    value: string;
+}
+/** Synchronization metadata for collaborative slide updates. */
+interface SlideSyncData {
+    /** Server-assigned slide identifier. */
+    serverSldId: string;
+    /** ISO 8601 timestamp of the last server-side modification. */
+    serverSldModifiedTime: string;
+    /** ISO 8601 timestamp when the client inserted this slide. */
+    clientInsertedTime: string;
+}
+/** Slide transition effect type. */
+type TransitionType = 'fade' | 'push' | 'wipe' | 'split' | 'cover' | 'uncover' | 'strips' | 'blinds' | 'checker' | 'dissolve' | 'comb' | 'newsflash' | 'randomBars' | 'circle' | 'diamond' | 'plus' | 'wedge' | 'wheel' | 'zoom' | 'cut' | 'random' | 'none';
+/** Transition effect configuration for advancing to a slide. */
+interface SlideTransition {
+    /** Transition effect type. */
+    type?: TransitionType;
+    /** Transition duration in milliseconds. */
+    duration?: number;
+    /** Auto-advance to the next slide after this many milliseconds (0 = click only). */
+    advanceAfter?: number;
+    /** Allow advancing on mouse click (defaults to `true`). */
+    advanceOnClick?: boolean;
+    /** Directional variant for the transition effect. */
+    direction?: 'l' | 'r' | 'u' | 'd' | 'lu' | 'ru' | 'ld' | 'rd';
+    /** Raw duration in milliseconds (overrides the spd fast/med/slow mapping). */
+    durationMs?: number;
+}
+/** Animation preset effect name. */
+type AnimationEffect = 'appear' | 'fade' | 'flyIn' | 'split' | 'wipe' | 'blinds' | 'box' | 'checkerboard' | 'circle' | 'diamond' | 'dissolve' | 'peek' | 'plus' | 'randomBars' | 'strips' | 'wedge' | 'wheel' | 'zoom' | 'grow' | 'shrink' | 'spin' | 'transparency' | 'pulse' | 'colorPulse' | 'teeter' | 'bounce' | 'float' | 'swivel';
+/** What triggers the animation to start. */
+type AnimationTrigger = 'onClick' | 'withPrevious' | 'afterPrevious';
+/** Broad animation category. */
+type AnimationCategory = 'entrance' | 'exit' | 'emphasis' | 'motionPath';
+/** Animation definition targeting an element on a slide. */
+interface Animation {
+    /** Zero-based index of the target element in the slide's element array. */
+    elementIndex: number;
+    /** Preset animation effect to apply. */
+    effect: AnimationEffect;
+    /** Animation category (defaults to `'entrance'`). */
+    category?: AnimationCategory;
+    /** What triggers the animation (defaults to `'onClick'`). */
+    trigger?: AnimationTrigger;
+    /** Animation duration in milliseconds (defaults to 500). */
+    duration?: number;
+    /** Delay before the animation starts in milliseconds. */
+    delay?: number;
+    /** Effect-specific directional variant. */
+    direction?: string;
+    /** Number of times to repeat, or `'indefinite'`. */
+    repeatCount?: number | 'indefinite';
+    /** Acceleration percentage (0–100). */
+    acceleration?: number;
+    /** Deceleration percentage (0–100). */
+    deceleration?: number;
+    /** SVG-style motion path string (e.g. 'M 0 0 L 1 0'). */
+    motionPath?: string;
+}
+/** Placement options for a group of elements. */
+interface GroupOptions extends Partial<Placement> {
+}
+/** Connector routing style. */
+type ConnectorType = 'straight' | 'elbow' | 'curved';
+/** Options for adding a connector line between points on a slide. */
+interface ConnectorOptions extends Partial<Placement> {
+    /** Connector routing style (defaults to `'straight'`). */
+    type?: ConnectorType;
+    /** Line formatting (color, width, dash, etc.). */
+    line?: LineProperties;
+    /** Arrowhead at the start of the connector. */
+    startArrow?: LineEndProperties;
+    /** Arrowhead at the end of the connector. */
+    endArrow?: LineEndProperties;
+}
+/** Background fill configuration for a slide. */
+interface SlideBackground {
+    /** Full fill definition (solid, gradient, pattern, or picture). */
+    fill?: Fill;
+    /** Shortcut for a solid background color. */
+    color?: Color;
+}
+
+interface SlideMasterDef {
+    name: string;
+    background?: Color;
+    elements?: IElement[];
+}
+declare class SlideMaster {
+    name: string;
+    background?: Color;
+    elements: IElement[];
+    constructor(def: SlideMasterDef);
+}
+
+type PlaceholderType = 'title' | 'body' | 'ctrTitle' | 'subTitle' | 'dt' | 'ftr' | 'sldNum';
+interface PlaceholderDef {
+    type: PlaceholderType;
+    placement: Placement;
+    idx?: number;
+}
+type LayoutType = 'blank' | 'title' | 'titleAndContent' | 'sectionHeader' | 'twoContent';
+interface SlideLayoutDef {
+    name: string;
+    type?: LayoutType;
+    placeholders?: PlaceholderDef[];
+}
+declare class SlideLayout {
+    name: string;
+    type: LayoutType;
+    placeholders: PlaceholderDef[];
+    constructor(def: SlideLayoutDef);
+}
+declare const builtinLayouts: Record<string, SlideLayoutDef>;
+
+interface NotesMasterDef {
+    name?: string;
+}
+declare class NotesMaster {
+    name: string;
+    constructor(def?: NotesMasterDef);
+}
+
+interface HandoutMasterDef {
+    name?: string;
+}
+declare class HandoutMaster {
+    name: string;
+    constructor(def?: HandoutMasterDef);
+}
+
+declare class Registry implements IRegistry {
+    private serializers;
+    registerElement<E extends IElement>(type: ElementType, serializer: IElementSerializer<E>): void;
+    getSerializer(type: ElementType): IElementSerializer | undefined;
+}
+
+/** Data describing a single slide's content and metadata. */
+interface SlideData {
+    /** Elements (text, images, shapes, etc.) placed on the slide. */
+    elements: IElement[];
+    /** Plain-text speaker notes for this slide. */
+    notes?: string;
+    /** Index into the layouts array; defaults to 0 (blank). */
+    layoutIndex?: number;
+    /** Comments attached to this slide. */
+    comments?: SlideComment[];
+    /** User-defined key-value tags for this slide. */
+    tags?: UserDefinedTag[];
+    /** Synchronization metadata for collaborative editing. */
+    syncData?: SlideSyncData;
+    /** Transition effect applied when advancing to this slide. */
+    transition?: SlideTransition;
+    /** Animation effects applied to elements on this slide. */
+    animations?: Animation[];
+    /** Background fill or image for this slide. */
+    background?: SlideBackground;
+}
+
+/** Builder for adding elements and metadata to a single slide. */
+declare class SlideBuilder {
+    private data;
+    private commentAuthors?;
+    constructor(data: SlideData, commentAuthors?: CommentAuthor[]);
+    /** Adds a text box to the slide. Placement dimensions are in inches. */
+    addText(text: string, opts?: TextOptions): this;
+    /** Adds an image to the slide from a file path or binary data. */
+    addImage(opts: ImageOptions): this;
+    /** Adds a preset geometry shape to the slide. */
+    addShape(geometry: PresetGeometry, opts?: ShapeOptions): this;
+    /** Adds a table to the slide. */
+    addTable(rows: TableRow[], opts?: TableOptions): this;
+    /** Adds a chart to the slide. Defaults to 6x4 inches if width/height are not specified. */
+    addChart(type: ChartType, data: ChartData, opts?: ChartOptions): this;
+    /** Sets speaker notes text for this slide. */
+    setNotes(notes: string): this;
+    /** Adds a video element to the slide. Defaults to 6x4 inches. */
+    addVideo(opts: MediaOptions): this;
+    /** Adds an audio element to the slide. Defaults to 1x1 inch. */
+    addAudio(opts: MediaOptions): this;
+    /** Adds a pre-built element directly to the slide. */
+    addElement(element: IElement): this;
+    /**
+     * Adds a comment to the slide.
+     * @param authorId - ID returned by {@link Presentation.defineCommentAuthor}.
+     */
+    addComment(text: string, authorId: number, opts?: {
+        position?: {
+            x: number;
+            y: number;
+        };
+        date?: string;
+    }): this;
+    /** Sets user-defined tags on this slide as key-value pairs. */
+    setTags(tags: Record<string, string>): this;
+    /** Sets synchronization data for collaborative slide updates. */
+    setSyncData(data: SlideSyncData): this;
+    /** Sets the transition effect for this slide. */
+    setTransition(transition: SlideTransition): this;
+    /** Adds an animation to the slide's animation sequence. */
+    addAnimation(anim: Animation): this;
+    /** Sets the background fill or image for this slide. */
+    setBackground(bg: SlideBackground): this;
+    /**
+     * Adds a group of elements that are positioned and transformed together.
+     * @param buildFn - Callback receiving a {@link GroupBuilder} to populate the group.
+     */
+    addGroup(buildFn: (group: GroupBuilder) => void, opts?: GroupOptions): this;
+    /** Adds a connector line between points on the slide. */
+    addConnector(opts: ConnectorOptions): this;
+}
+/** Builder for adding child elements within a group. */
+declare class GroupBuilder {
+    private children;
+    constructor(children: IElement[]);
+    /** Adds a shape to the group. */
+    addShape(geometry: PresetGeometry, opts?: ShapeOptions): this;
+    /** Adds a text box to the group. */
+    addText(text: string, opts?: TextOptions): this;
+    /** Adds an image to the group. */
+    addImage(opts: ImageOptions): this;
+    /** Adds a pre-built element directly to the group. */
+    addElement(element: IElement): this;
+}
+
+/** Options for creating a new presentation. */
+interface PresentationOptions {
+    /** Custom theme overrides for colors and fonts. */
+    theme?: Partial<Theme>;
+    /** URI for HTML publish output. */
+    htmlPublishUri?: string;
+    /** URL for slide update synchronization. */
+    slideUpdateUrl?: string;
+    /** Custom slide size (default: standard widescreen 10x7.5). */
+    slideSize?: {
+        width: Inches;
+        height: Inches;
+        type?: string;
+    };
+    /** Default language for text runs (e.g. 'en-US'). */
+    defaultLang?: string;
+    /** Core document properties (Dublin Core metadata). */
+    coreProperties?: {
+        title?: string;
+        creator?: string;
+        subject?: string;
+        description?: string;
+        keywords?: string;
+        category?: string;
+    };
+}
+/** Builder for constructing PPTX presentations. */
+declare class Presentation {
+    private slides;
+    private registry;
+    private theme;
+    private masters;
+    private layouts;
+    private layoutNameMap;
+    private presProps;
+    private viewProps;
+    private notesMaster?;
+    private handoutMaster?;
+    private commentAuthors;
+    private authorNameMap;
+    private presTags;
+    private opts;
+    /** Creates a new presentation with optional configuration. */
+    constructor(opts?: PresentationOptions);
+    /** Registers a plugin to extend serialization capabilities. */
+    use(plugin: IPlugin): this;
+    /** Defines or replaces the default slide master. */
+    defineSlideMaster(def: SlideMasterDef): this;
+    /** Registers a new slide layout that can be referenced by name when adding slides. */
+    defineLayout(def: SlideLayoutDef): this;
+    /** Defines the notes master for speaker notes formatting. */
+    defineNotesMaster(def?: NotesMasterDef): this;
+    /** Defines the handout master for printed handout formatting. */
+    defineHandoutMaster(def?: HandoutMasterDef): this;
+    /** Configures slideshow playback properties (e.g., loop, timing). */
+    setShowProperties(props: SlideShowProperties): this;
+    /** Configures print-related properties. */
+    setPrintProperties(props: PrintProperties): this;
+    /** Sets the default view properties (e.g., normal, slide sorter). */
+    setViewProperties(props: ViewProperties): this;
+    /**
+     * Registers a comment author. Returns the author ID, reusing an existing one if the name matches.
+     * @param name - Display name of the author.
+     * @param initials - Author initials shown in comment badges.
+     */
+    defineCommentAuthor(name: string, initials: string): number;
+    /** Sets user-defined tags on the presentation as key-value pairs. */
+    setTags(tags: Record<string, string>): this;
+    /**
+     * Adds a new slide and returns a builder for populating it.
+     * @param layoutName - Name of a previously defined layout; defaults to "blank".
+     */
+    addSlide(layoutName?: string): SlideBuilder;
+    /** Serializes the presentation to a PPTX file in memory and returns the raw bytes. */
+    toBuffer(): Uint8Array;
+    /** Writes the presentation as a .pptx file to disk (Node.js only). */
+    toFile(path: string): Promise<void>;
+}
+
+declare const defaultColorScheme: ColorScheme;
+declare const defaultFontScheme: FontScheme;
+declare const defaultTheme: Theme;
+
+/** Abstract base class for all slide elements. */
+declare abstract class BaseElement implements IElement {
+    /** Discriminator indicating the concrete element kind. */
+    abstract readonly type: ElementType;
+    /** Position and size of the element on the slide. */
+    placement: Placement;
+    /** Optional human-readable name for the element. */
+    name?: string;
+    constructor(placement: Placement, name?: string);
+}
+
+/** A single run of text with optional formatting. */
+interface TextRun {
+    /** The text content of this run. */
+    text: string;
+    /** Optional formatting applied to this run (font, size, color, etc.). */
+    options?: TextRunOptions;
+}
+/** A paragraph composed of one or more text runs. */
+interface TextParagraph {
+    /** Ordered text runs that make up the paragraph. */
+    runs: TextRun[];
+    /** Optional paragraph-level formatting (alignment, spacing, etc.). */
+    options?: ParagraphOptions;
+}
+/** A text box element containing one or more paragraphs. */
+declare class TextElement extends BaseElement {
+    /** Element type discriminator. */
+    readonly type: "text";
+    /** Paragraphs that make up the text content. */
+    paragraphs: TextParagraph[];
+    /** Options controlling the text body (margins, wrapping, auto-fit, etc.). */
+    bodyOptions?: TextBodyOptions;
+    /** Background fill for the text box. */
+    fill?: Fill;
+    /** Outline/border properties for the text box. */
+    line?: LineProperties;
+    /** Visual effects (shadow, glow, etc.). */
+    effects?: EffectProperties;
+    /** 2-D transform (rotation, flip). */
+    transform?: TransformProperties;
+    /** 3D scene (camera + lighting). */
+    scene3d?: Scene3DProperties;
+    /** 3D shape (extrusion, bevels, material). */
+    shape3d?: Shape3DProperties;
+    constructor(paragraphs: TextParagraph[], placement: Placement, name?: string, opts?: {
+        bodyOptions?: TextBodyOptions;
+        fill?: Fill;
+        line?: LineProperties;
+        effects?: EffectProperties;
+        transform?: TransformProperties;
+        scene3d?: Scene3DProperties;
+        shape3d?: Shape3DProperties;
+    });
+    /**
+     * Creates a TextElement from a plain string, splitting on newlines into paragraphs.
+     * @param text - Plain text content (newlines become paragraph breaks).
+     * @param placement - Position and size on the slide.
+     * @param runOptions - Optional formatting for all text runs.
+     * @param paraOptions - Optional paragraph-level formatting.
+     * @param bodyOptions - Optional text body options.
+     * @returns A new TextElement instance.
+     */
+    static fromString(text: string, placement: Placement, runOptions?: TextRunOptions, paraOptions?: ParagraphOptions, bodyOptions?: TextBodyOptions): TextElement;
+}
+
+/** An image element placed on a slide. */
+declare class ImageElement extends BaseElement {
+    /** Element type discriminator. */
+    readonly type: "image";
+    /** File system path to the image (mutually exclusive with `data`). */
+    path?: string;
+    /** Raw image bytes (mutually exclusive with `path`). */
+    data?: Uint8Array;
+    /** MIME type of the image (defaults to 'image/png'). */
+    contentType: string;
+    /** Border/outline properties for the image. */
+    border?: LineProperties;
+    /** Visual effects (shadow, glow, etc.). */
+    effects?: EffectProperties;
+    /** 2-D transform (rotation, flip). */
+    transform?: TransformProperties;
+    /** Image opacity, 0-100. */
+    opacity?: number;
+    /** Crop offsets as fractions (0-1) from each edge. */
+    crop?: {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+    };
+    /** Hyperlink attached to the image. */
+    hyperlink?: HyperlinkProperties;
+    /** Whether to lock the aspect ratio when resizing. */
+    lockAspectRatio?: boolean;
+    /** 3D scene (camera + lighting). */
+    scene3d?: Scene3DProperties;
+    /** 3D shape (extrusion, bevels, material). */
+    shape3d?: Shape3DProperties;
+    brightness?: number;
+    contrast?: number;
+    saturation?: number;
+    duotone?: {
+        color1: Color;
+        color2: Color;
+    };
+    cropShape?: PresetGeometry;
+    constructor(placement: Placement, opts: {
+        path?: string;
+        data?: Uint8Array;
+        contentType?: string;
+        border?: LineProperties;
+        effects?: EffectProperties;
+        transform?: TransformProperties;
+        opacity?: number;
+        crop?: {
+            top?: number;
+            bottom?: number;
+            left?: number;
+            right?: number;
+        };
+        hyperlink?: HyperlinkProperties;
+        lockAspectRatio?: boolean;
+        scene3d?: Scene3DProperties;
+        shape3d?: Shape3DProperties;
+        brightness?: number;
+        contrast?: number;
+        saturation?: number;
+        duotone?: {
+            color1: Color;
+            color2: Color;
+        };
+        cropShape?: PresetGeometry;
+    });
+}
+
+/** An auto-shape element (rectangle, ellipse, arrow, etc.). */
+declare class ShapeElement extends BaseElement {
+    /** Element type discriminator. */
+    readonly type: "shape";
+    /** Preset geometry type (e.g. 'rect', 'ellipse', 'roundRect'). */
+    geometry: PresetGeometry;
+    /** Background fill for the shape. */
+    fill?: Fill;
+    /** Outline/border properties. */
+    line?: LineProperties;
+    /** Visual effects (shadow, glow, etc.). */
+    effects?: EffectProperties;
+    /** 2-D transform (rotation, flip). */
+    transform?: TransformProperties;
+    /** Shape opacity, 0-100. */
+    opacity?: number;
+    /** Plain text content rendered inside the shape. */
+    text?: string;
+    /** Text body options for text rendered inside the shape. */
+    textOptions?: ShapeTextOptions;
+    /** Run-level formatting for the shape's text. */
+    textRunOptions?: TextRunOptions;
+    /** Paragraph-level formatting for the shape's text. */
+    textParagraphOptions?: ParagraphOptions;
+    /** Geometry adjustment values keyed by handle name. */
+    adjustValues?: Record<string, number>;
+    /** Hyperlink attached to the shape. */
+    hyperlink?: HyperlinkProperties;
+    /** 3D scene (camera + lighting). */
+    scene3d?: Scene3DProperties;
+    /** 3D shape (extrusion, bevels, material). */
+    shape3d?: Shape3DProperties;
+    /** Custom geometry (overrides preset). */
+    customGeometry?: CustomGeometry;
+    /** Shape protection locks. */
+    locks?: ShapeLocks;
+    constructor(geometry: PresetGeometry, placement: Placement, opts?: {
+        fill?: Fill;
+        line?: LineProperties;
+        effects?: EffectProperties;
+        transform?: TransformProperties;
+        opacity?: number;
+        text?: string;
+        textOptions?: ShapeTextOptions;
+        textRunOptions?: TextRunOptions;
+        textParagraphOptions?: ParagraphOptions;
+        adjustValues?: Record<string, number>;
+        hyperlink?: HyperlinkProperties;
+        scene3d?: Scene3DProperties;
+        shape3d?: Shape3DProperties;
+        customGeometry?: CustomGeometry;
+        locks?: ShapeLocks;
+    });
+}
+
+/** A table element with rows, columns, and optional banding. */
+declare class TableElement extends BaseElement {
+    /** Element type discriminator. */
+    readonly type: "table";
+    /** Row data including cells and per-row options. */
+    rows: TableRow[];
+    /** Column widths in EMUs. */
+    colWidths?: number[];
+    /** Row heights in EMUs. */
+    rowHeights?: number[];
+    /** Border configuration for the table. */
+    border?: TableBorderOptions;
+    /** Default background fill for cells. */
+    fill?: Fill;
+    /** Apply special formatting to the first row. */
+    firstRow?: boolean;
+    /** Apply special formatting to the last row. */
+    lastRow?: boolean;
+    /** Apply special formatting to the first column. */
+    firstCol?: boolean;
+    /** Apply special formatting to the last column. */
+    lastCol?: boolean;
+    /** Enable row banding (alternating row colors). */
+    bandRow?: boolean;
+    /** Enable column banding (alternating column colors). */
+    bandCol?: boolean;
+    /** Pair of colors for alternating row bands. */
+    bandRowColors?: [Color, Color];
+    /** Visual effects (shadow, glow, etc.). */
+    effects?: EffectProperties;
+    /** 2-D transform (rotation, flip). */
+    transform?: TransformProperties;
+    /** Built-in table style GUID. */
+    tableStyleId?: string;
+    constructor(rows: TableRow[], placement: Placement, opts?: {
+        colWidths?: number[];
+        rowHeights?: number[];
+        border?: TableBorderOptions;
+        fill?: Fill;
+        firstRow?: boolean;
+        lastRow?: boolean;
+        firstCol?: boolean;
+        lastCol?: boolean;
+        bandRow?: boolean;
+        bandCol?: boolean;
+        bandRowColors?: [Color, Color];
+        effects?: EffectProperties;
+        transform?: TransformProperties;
+        tableStyleId?: string;
+    });
+}
+
+/** A chart element (bar, line, pie, scatter, etc.). */
+declare class ChartElement extends BaseElement {
+    /** Element type discriminator. */
+    readonly type: "chart";
+    /** The kind of chart to render (e.g. 'bar', 'line', 'pie'). */
+    chartType: ChartType;
+    /** Series and category data for the chart. */
+    data: ChartData;
+    /** Optional chart title text. */
+    title?: string;
+    /** Whether to display the legend (defaults to true). */
+    showLegend: boolean;
+    /** Whether to show data labels on data points (defaults to false). */
+    showDataLabels: boolean;
+    /** Whether to display grid lines (defaults to true). */
+    showGridLines: boolean;
+    /** Font size for the chart title, in points. */
+    titleFontSize?: number;
+    /** Color for the chart title. */
+    titleColor?: Color;
+    /** Position of the legend relative to the chart. */
+    legendPosition?: 'b' | 't' | 'l' | 'r' | 'tr';
+    /** Category (horizontal) axis options. */
+    catAxis?: AxisOptions;
+    /** Primary value (vertical) axis options. */
+    valAxis?: AxisOptions;
+    /** Secondary value axis options (for combo charts). */
+    secondaryValAxis?: AxisOptions;
+    /** Plot area background fill and border. */
+    plotArea?: {
+        fill?: Color;
+        border?: LineProperties;
+    };
+    /** Gap width between bar groups, as a percentage. */
+    barGapWidth?: number;
+    /** Overlap between bars in a group, as a percentage (-100 to 100). */
+    barOverlap?: number;
+    /** Grouping mode for bar/column charts. */
+    barGrouping?: 'clustered' | 'stacked' | 'percentStacked';
+    /** Explosion distance for pie slices, as a percentage. */
+    pieExplosion?: number;
+    /** Hole size for doughnut charts, as a percentage (0-90). */
+    doughnutHoleSize?: number;
+    /** Grouping mode for line charts. */
+    lineGrouping?: 'standard' | 'stacked' | 'percentStacked';
+    /** Grouping mode for area charts. */
+    areaGrouping?: 'standard' | 'stacked' | 'percentStacked';
+    /** Rendering style for scatter charts. */
+    scatterStyle?: 'lineMarker' | 'line' | 'marker' | 'smooth' | 'smoothMarker';
+    /** Rendering style for radar charts. */
+    radarStyle?: 'standard' | 'marker' | 'filled';
+    /** Chart border/outline properties. */
+    border?: LineProperties;
+    /** Chart background fill color. */
+    fill?: Color;
+    /** Chart-level data label configuration. */
+    dataLabels?: DataLabelOptions;
+    /** 3-D view settings for the chart. */
+    view3D?: {
+        rotX?: number;
+        rotY?: number;
+        depthPercent?: number;
+        rAngAx?: boolean;
+        perspective?: number;
+    };
+    constructor(chartType: ChartType, data: ChartData, placement: Placement, opts?: {
+        title?: string;
+        showLegend?: boolean;
+        showDataLabels?: boolean;
+        showGridLines?: boolean;
+        titleFontSize?: number;
+        titleColor?: Color;
+        legendPosition?: 'b' | 't' | 'l' | 'r' | 'tr';
+        catAxis?: AxisOptions;
+        valAxis?: AxisOptions;
+        secondaryValAxis?: AxisOptions;
+        plotArea?: {
+            fill?: Color;
+            border?: LineProperties;
+        };
+        barGapWidth?: number;
+        barOverlap?: number;
+        barGrouping?: 'clustered' | 'stacked' | 'percentStacked';
+        pieExplosion?: number;
+        doughnutHoleSize?: number;
+        lineGrouping?: 'standard' | 'stacked' | 'percentStacked';
+        areaGrouping?: 'standard' | 'stacked' | 'percentStacked';
+        scatterStyle?: 'lineMarker' | 'line' | 'marker' | 'smooth' | 'smoothMarker';
+        radarStyle?: 'standard' | 'marker' | 'filled';
+        border?: LineProperties;
+        fill?: Color;
+        dataLabels?: DataLabelOptions;
+        view3D?: {
+            rotX?: number;
+            rotY?: number;
+            depthPercent?: number;
+            rAngAx?: boolean;
+            perspective?: number;
+        };
+    });
+}
+
+/** Discriminator for the kind of embedded media. */
+type MediaType = 'video' | 'audio';
+/** An embedded video or audio media element. */
+declare class MediaElement extends BaseElement {
+    /** Element type discriminator. */
+    readonly type: "media";
+    /** Whether this is a video or audio element. */
+    mediaType: MediaType;
+    /** File system path to the media file (mutually exclusive with `data`). */
+    path?: string;
+    /** Raw media bytes (mutually exclusive with `path`). */
+    data?: Uint8Array;
+    /** MIME type (defaults to 'video/mp4' or 'audio/mpeg' based on mediaType). */
+    contentType: string;
+    /** Poster/thumbnail image displayed before playback. */
+    poster?: MediaPoster;
+    /** Playback settings (autoplay, loop, etc.). */
+    playback?: MediaPlaybackOptions;
+    /** Visual effects (shadow, glow, etc.). */
+    effects?: EffectProperties;
+    /** 2-D transform (rotation, flip). */
+    transform?: TransformProperties;
+    constructor(mediaType: MediaType, placement: Placement, opts: {
+        path?: string;
+        data?: Uint8Array;
+        contentType?: string;
+        poster?: MediaPoster;
+        playback?: MediaPlaybackOptions;
+        effects?: EffectProperties;
+        transform?: TransformProperties;
+    });
+}
+
+/** A group element that contains multiple child elements. */
+declare class GroupElement extends BaseElement {
+    /** Element type discriminator. */
+    readonly type: "group";
+    /** Child elements contained within this group. */
+    children: IElement[];
+    constructor(children: IElement[], placement: Placement, name?: string);
+}
+
+/** A connector line element (straight, elbow, or curved). */
+declare class ConnectorElement extends BaseElement {
+    /** Element type discriminator. */
+    readonly type: "connector";
+    /** The connector routing style (defaults to 'straight'). */
+    connectorType: ConnectorType;
+    /** Line formatting (color, width, dash style, etc.). */
+    line?: LineProperties;
+    /** Arrowhead properties for the start of the connector. */
+    startArrow?: LineEndProperties;
+    /** Arrowhead properties for the end of the connector. */
+    endArrow?: LineEndProperties;
+    constructor(placement: Placement, opts?: {
+        type?: ConnectorType;
+        line?: LineProperties;
+        startArrow?: LineEndProperties;
+        endArrow?: LineEndProperties;
+    });
+}
+
+export { type Animation, type AnimationCategory, type AnimationEffect, type AnimationTrigger, type AxisOptions, type BevelPreset, type BevelProperties, type BulletOptions, type CameraPreset, type ChartData, ChartElement, type ChartMarkerOptions, type ChartOptions, type ChartSeries, type ChartType, type Color, type ColorScheme, type ColorTransform, type CommentAuthor, ConnectorElement, type ConnectorOptions, type ConnectorType, type CustomGeometry, type CustomGeometryPath, type DataLabelOptions, type EffectProperties, type ElementType, type Emu, type ErrorBarOptions, type Fill, type FontScheme, type GlowEffect, type GradientDirection, type GradientFill, type GradientStop, GroupElement, type GroupOptions, HandoutMaster, type HandoutMasterDef, type HslColor, type HyperlinkProperties, type IElement, type IElementSerializer, type IPlugin, type IRegistry, ImageElement, type ImageOptions, type Inches, type LastViewType, type LayoutType, type LightRigDirection, type LightRigType, type LineCap, type LineDash, type LineEndProperties, type LineEndSize, type LineEndType, type LineJoin, type LineProperties, MediaElement, type MediaOptions, type MediaPlaybackOptions, type MediaPoster, type MediaType, NotesMaster, type NotesMasterDef, type NumberingOptions, type ParagraphOptions, type PathCommand, type PatternFill, type PatternType, type PictureFill, type PlaceholderDef, type PlaceholderType, type Placement, Presentation, type PresentationOptions, type PresentationProperties, type PresetColor, type PresetGeometry, type PresetMaterial, type PrintProperties, type ReflectionEffect, Registry, type Scene3DProperties, type SchemeColor, type SchemeColorVal, type SerializationContext, type ShadowEffect, type Shape3DProperties, ShapeElement, type ShapeLocks, type ShapeOptions, type ShapeTextOptions, type SlideBackground, SlideBuilder, type SlideComment, SlideLayout, type SlideLayoutDef, SlideMaster, type SlideMasterDef, type SlideShowProperties, type SlideSyncData, type SlideTransition, type SoftEdgeEffect, type SrgbColor, type SystemColor, type TabStop, type TableBorderOptions, type TableCell, type TableCellBorder, TableElement, type TableOptions, type TableRow, type TextBodyOptions, TextElement, type TextOptions, type TextParagraph, type TextRun, type TextRunOptions, type Theme, type TransformProperties, type TransitionType, type TrendlineOptions, type UserDefinedTag, type ViewProperties, builtinLayouts, defaultColorScheme, defaultFontScheme, defaultTheme };