/**
 * @module _shared/edit/text-overlay
 * @description `applyTextOverlays` + `executeTextOverlay` — burn text onto
 * video using FFmpeg drawtext filter. Falls back to Remotion when libfreetype
 * is missing. Auto-detects system fonts (macOS/Linux/Windows). Split out of
 * `ai-edit.ts` in v0.69 (Plan G Phase 3).
 */
/** Visual style preset for text overlays. */
export type TextOverlayStyle = "lower-third" | "center-bold" | "subtitle" | "minimal";
/** Options for {@link applyTextOverlays} and {@link executeTextOverlay}. */
export interface TextOverlayOptions {
    /** Path to the input video file */
    videoPath: string;
    /** Array of text lines to overlay */
    texts: string[];
    /** Path for the output video */
    outputPath: string;
    /** Text overlay style preset (default: "lower-third") */
    style?: TextOverlayStyle;
    /** Font size override (auto-calculated from video height if omitted) */
    fontSize?: number;
    /** Font color name (default: "white") */
    fontColor?: string;
    /** Fade in/out duration for text in seconds (default: 0.3) */
    fadeDuration?: number;
    /** Start time for text display in seconds (default: 0) */
    startTime?: number;
    /** End time for text display in seconds (default: video duration) */
    endTime?: number;
}
/** Result from {@link applyTextOverlays} and {@link executeTextOverlay}. */
export interface TextOverlayResult {
    /** Whether the operation succeeded */
    success: boolean;
    /** Absolute path to the output video */
    outputPath?: string;
    /** Error message on failure */
    error?: string;
}
/**
 * Apply text overlays to a video using FFmpeg drawtext filter.
 *
 * Supports multiple text lines with configurable style, position, font,
 * and fade-in/out. Auto-detects system fonts across macOS, Linux, and Windows.
 */
export declare function applyTextOverlays(options: TextOverlayOptions): Promise<TextOverlayResult>;
/**
 * Execute text overlay for CLI/Agent usage. Delegates to {@link applyTextOverlays}.
 */
export declare function executeTextOverlay(options: TextOverlayOptions): Promise<TextOverlayResult>;
