@studiomeyer/mcp-video 1.0.0

package/dist/tools/engine/editing.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Video editing engine — speed, color grading, effects, crop, reverse,
+ * audio extraction, subtitles, keyframe animation, picture-in-picture.
+ *
+ * All processing via ffmpeg (no npm dependencies).
+ */
+export interface SpeedConfig {
+    inputPath: string;
+    outputPath: string;
+    /** Speed factor: 0.25 (4x slower) to 4.0 (4x faster). 1.0 = original. */
+    speed: number;
+    /** How to handle audio: 'match' adjusts pitch, 'mute' removes, 'original' keeps (may desync). Default: match */
+    audioMode?: 'match' | 'mute' | 'original';
+}
+export declare function adjustVideoSpeed(config: SpeedConfig): Promise<string>;
+export interface ColorGradeConfig {
+    inputPath: string;
+    outputPath: string;
+    /** Brightness adjustment: -1.0 to 1.0 (0 = no change) */
+    brightness?: number;
+    /** Contrast: 0.0 to 3.0 (1.0 = no change) */
+    contrast?: number;
+    /** Saturation: 0.0 to 3.0 (1.0 = no change, 0 = grayscale) */
+    saturation?: number;
+    /** Gamma: 0.1 to 10.0 (1.0 = no change) */
+    gamma?: number;
+    /** Color temperature shift: -1.0 (cool/blue) to 1.0 (warm/orange). 0 = neutral */
+    temperature?: number;
+}
+export declare function applyColorGrade(config: ColorGradeConfig): Promise<string>;
+export type VideoEffect = 'blur' | 'sharpen' | 'vignette' | 'grayscale' | 'sepia' | 'noise' | 'glow';
+export interface EffectConfig {
+    inputPath: string;
+    outputPath: string;
+    /** Effect to apply */
+    effect: VideoEffect;
+    /** Intensity 0.0-1.0 (default: 0.5) */
+    intensity?: number;
+}
+export declare function applyVideoEffect(config: EffectConfig): Promise<string>;
+export interface CropConfig {
+    inputPath: string;
+    outputPath: string;
+    /** X offset (pixels or 'center') */
+    x?: number | 'center';
+    /** Y offset (pixels or 'center') */
+    y?: number | 'center';
+    /** Width of crop region */
+    width: number;
+    /** Height of crop region */
+    height: number;
+}
+export declare function cropVideo(config: CropConfig): Promise<string>;
+export interface ReverseConfig {
+    inputPath: string;
+    outputPath: string;
+    /** Also reverse audio (default: true) */
+    reverseAudio?: boolean;
+}
+export declare function reverseClip(config: ReverseConfig): Promise<string>;
+export interface ExtractAudioConfig {
+    inputPath: string;
+    outputPath: string;
+    /** Output format: mp3, aac, wav, flac (default: mp3) */
+    format?: 'mp3' | 'aac' | 'wav' | 'flac';
+    /** Audio bitrate for lossy (default: 192k) */
+    bitrate?: string;
+}
+export declare function extractAudio(config: ExtractAudioConfig): Promise<string>;
+export interface BurnSubtitlesConfig {
+    inputPath: string;
+    outputPath: string;
+    /** Path to SRT or ASS subtitle file */
+    subtitlePath: string;
+    /** Font size (default: 24) */
+    fontSize?: number;
+    /** Font color (default: white) */
+    fontColor?: string;
+    /** Outline color (default: black) */
+    outlineColor?: string;
+    /** Outline width (default: 2) */
+    outlineWidth?: number;
+    /** Position: bottom, top, center (default: bottom) */
+    position?: 'bottom' | 'top' | 'center';
+}
+export declare function burnSubtitles(config: BurnSubtitlesConfig): Promise<string>;
+export interface AutoCaptionConfig {
+    inputPath: string;
+    outputPath: string;
+    /** Language code (default: auto-detect) */
+    language?: string;
+    /** Font size for captions (default: 28) */
+    fontSize?: number;
+    /** Caption position (default: bottom) */
+    position?: 'bottom' | 'top' | 'center';
+    /** Also return the SRT file path (default: true) */
+    keepSrt?: boolean;
+}
+export interface AutoCaptionResult {
+    videoPath: string;
+    srtPath: string;
+}
+export declare function autoCaption(config: AutoCaptionConfig): Promise<AutoCaptionResult>;
+export interface Keyframe {
+    /** Time in seconds */
+    time: number;
+    /** Scale factor (1.0 = original, 2.0 = 2x zoom) */
+    scale?: number;
+    /** Pan X offset in pixels (0 = center) */
+    panX?: number;
+    /** Pan Y offset in pixels (0 = center) */
+    panY?: number;
+    /** Rotation in degrees */
+    rotate?: number;
+}
+export interface KeyframeAnimationConfig {
+    inputPath: string;
+    outputPath: string;
+    /** Keyframes defining animation over time */
+    keyframes: Keyframe[];
+    /** Output width (default: source width) */
+    outputWidth?: number;
+    /** Output height (default: source height) */
+    outputHeight?: number;
+}
+export declare function addKeyframeAnimation(config: KeyframeAnimationConfig): Promise<string>;
+export type PipPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'center';
+export interface PipConfig {
+    /** Main (background) video */
+    mainVideo: string;
+    /** Overlay (PiP) video */
+    overlayVideo: string;
+    outputPath: string;
+    /** Position of PiP (default: bottom-right) */
+    position?: PipPosition;
+    /** Scale of PiP relative to main video width: 0.1-0.5 (default: 0.3) */
+    scale?: number;
+    /** PiP start time in seconds (default: 0) */
+    startTime?: number;
+    /** PiP end time in seconds (default: end of main video) */
+    endTime?: number;
+    /** Border radius / rounded corners in px (default: 0) */
+    borderWidth?: number;
+    /** Border color (default: white) */
+    borderColor?: string;
+}
+export declare function composePip(config: PipConfig): Promise<string>;
+export interface AudioDuckingConfig {
+    inputPath: string;
+    outputPath: string;
+    /** How much to reduce background when speech detected: 0.0-1.0 (default: 0.3 = reduce to 30%) */
+    duckLevel?: number;
+    /** Attack time in seconds (default: 0.5) */
+    attack?: number;
+    /** Release time in seconds (default: 1.0) */
+    release?: number;
+}
+export declare function addAudioDucking(config: AudioDuckingConfig): Promise<string>;