@studiomeyer/mcp-video 1.0.0

package/dist/tools/engine/templates.js

@@ -0,0 +1,272 @@
+/**
+ * Video Template Engine — Pre-built video templates for common use cases.
+ *
+ * Templates define: clip slots, timing, transitions, text placeholders,
+ * effects, color grades, and music style.
+ *
+ * The renderer (template-renderer.ts) takes a template + user assets
+ * and produces a finished video using all existing engines.
+ */
+// ─── Template Definitions ───────────────────────────────────────────
+const TEMPLATES = [
+    // ─── Social Reel ─────────────────────────────────────────────
+    {
+        id: 'social-reel-hype',
+        name: 'Hype Reel',
+        category: 'social-reel',
+        description: 'Fast-paced 15-second reel with 5 quick cuts, beat-synced feel, bold text overlays. Perfect for Instagram/TikTok.',
+        totalDuration: 15,
+        aspectRatio: '9:16',
+        resolution: { width: 1080, height: 1920 },
+        slots: [
+            { name: 'hook-clip', duration: 3, required: true, description: 'Opening hook — attention-grabbing first 3 seconds', type: 'video' },
+            { name: 'clip-2', duration: 3, required: true, description: 'Second clip — show the product/action', type: 'video' },
+            { name: 'clip-3', duration: 3, required: true, description: 'Third clip — build momentum', type: 'video' },
+            { name: 'clip-4', duration: 3, required: false, description: 'Fourth clip — variety shot', type: 'video' },
+            { name: 'cta-clip', duration: 3, required: true, description: 'Closing CTA clip', type: 'video' },
+        ],
+        textPlaceholders: [
+            { name: 'hook-text', defaultText: 'WATCH THIS', animation: 'pop', startTime: 0.2, duration: 2.5, position: 'center', fontSize: 64 },
+            { name: 'cta-text', defaultText: 'FOLLOW FOR MORE', animation: 'slide-up', startTime: 12, duration: 3, position: 'bottom', fontSize: 48 },
+        ],
+        transition: 'fade',
+        colorGrade: 'high-contrast-music',
+        musicStyle: 'upbeat, energetic, trending audio',
+        tags: ['reel', 'tiktok', 'instagram', 'fast', 'hype', 'trending'],
+    },
+    {
+        id: 'social-reel-aesthetic',
+        name: 'Aesthetic Reel',
+        category: 'social-reel',
+        description: 'Slow, cinematic 30-second reel with smooth transitions and warm color grading. Great for lifestyle/travel content.',
+        totalDuration: 30,
+        aspectRatio: '9:16',
+        resolution: { width: 1080, height: 1920 },
+        slots: [
+            { name: 'opening', duration: 5, required: true, description: 'Slow opening shot — set the mood', type: 'video' },
+            { name: 'scene-2', duration: 5, required: true, description: 'Second scene — establish context', type: 'video' },
+            { name: 'scene-3', duration: 5, required: true, description: 'Third scene — main content', type: 'video' },
+            { name: 'scene-4', duration: 5, required: false, description: 'Fourth scene — detail shot', type: 'video' },
+            { name: 'scene-5', duration: 5, required: false, description: 'Fifth scene — variety', type: 'video' },
+            { name: 'closing', duration: 5, required: true, description: 'Closing scene — satisfying end', type: 'video' },
+        ],
+        textPlaceholders: [
+            { name: 'title', defaultText: 'Golden Hour', animation: 'fade-in', startTime: 1, duration: 4, position: 'center', fontSize: 56 },
+            { name: 'location', defaultText: 'Somewhere Beautiful', animation: 'fade-in-out', startTime: 6, duration: 4, position: 'bottom', fontSize: 36 },
+        ],
+        transition: 'crossfade',
+        colorGrade: 'warm-golden',
+        musicStyle: 'ambient, lo-fi, chill',
+        tags: ['aesthetic', 'cinematic', 'lifestyle', 'travel', 'slow'],
+    },
+    // ─── Product Demo ────────────────────────────────────────────
+    {
+        id: 'product-demo-saas',
+        name: 'SaaS Product Demo',
+        category: 'product-demo',
+        description: '60-second product demo: problem → solution → features → CTA. Clean look with screen recordings.',
+        totalDuration: 60,
+        aspectRatio: '16:9',
+        resolution: { width: 1920, height: 1080 },
+        slots: [
+            { name: 'problem', duration: 10, required: true, description: 'Show the problem your product solves', type: 'video' },
+            { name: 'intro-screen', duration: 5, required: true, description: 'Product name / logo reveal', type: 'video' },
+            { name: 'feature-1', duration: 12, required: true, description: 'Screen recording of feature 1', type: 'video' },
+            { name: 'feature-2', duration: 12, required: true, description: 'Screen recording of feature 2', type: 'video' },
+            { name: 'feature-3', duration: 12, required: false, description: 'Screen recording of feature 3', type: 'video' },
+            { name: 'cta', duration: 9, required: true, description: 'Closing with CTA', type: 'video' },
+        ],
+        textPlaceholders: [
+            { name: 'problem-text', defaultText: 'Tired of manual work?', animation: 'typewriter', startTime: 1, duration: 4, position: 'center', fontSize: 52 },
+            { name: 'product-name', defaultText: 'Product Name', animation: 'pop', startTime: 11, duration: 4, position: 'center', fontSize: 72 },
+            { name: 'feature-1-label', defaultText: 'Feature One', animation: 'slide-left', startTime: 16, duration: 3, position: 'top', fontSize: 36 },
+            { name: 'feature-2-label', defaultText: 'Feature Two', animation: 'slide-left', startTime: 28, duration: 3, position: 'top', fontSize: 36 },
+            { name: 'cta-text', defaultText: 'Try Free Today', animation: 'bounce', startTime: 52, duration: 7, position: 'center', fontSize: 64 },
+        ],
+        transition: 'fade',
+        colorGrade: 'cinematic-teal-orange-subtle',
+        musicStyle: 'corporate, uplifting, modern',
+        tags: ['saas', 'demo', 'product', 'screen-recording', 'corporate'],
+    },
+    // ─── Testimonial ─────────────────────────────────────────────
+    {
+        id: 'testimonial-single',
+        name: 'Customer Testimonial',
+        category: 'testimonial',
+        description: '30-second testimonial: quote + customer name + product shot. Warm, trustworthy feel.',
+        totalDuration: 30,
+        aspectRatio: '16:9',
+        resolution: { width: 1920, height: 1080 },
+        slots: [
+            { name: 'customer-video', duration: 20, required: true, description: 'Customer speaking / interview clip', type: 'video' },
+            { name: 'product-shot', duration: 7, required: true, description: 'Product being used', type: 'video' },
+            { name: 'logo-end', duration: 3, required: false, description: 'Company logo end card', type: 'image' },
+        ],
+        textPlaceholders: [
+            { name: 'quote', defaultText: '"This changed everything for us."', animation: 'fade-in', startTime: 2, duration: 8, position: 'bottom', fontSize: 36 },
+            { name: 'name', defaultText: 'Jane Doe, CEO at Company', animation: 'slide-up', startTime: 20, duration: 5, position: 'bottom', fontSize: 32 },
+        ],
+        transition: 'crossfade',
+        colorGrade: 'warm-golden',
+        musicStyle: 'soft piano, inspirational',
+        tags: ['testimonial', 'customer', 'review', 'trust'],
+    },
+    // ─── Before-After ────────────────────────────────────────────
+    {
+        id: 'before-after-split',
+        name: 'Before & After',
+        category: 'before-after',
+        description: '15-second split-screen before/after comparison. Great for transformations, renovations, edits.',
+        totalDuration: 15,
+        aspectRatio: '9:16',
+        resolution: { width: 1080, height: 1920 },
+        slots: [
+            { name: 'before', duration: 7, required: true, description: 'Before state', type: 'video' },
+            { name: 'after', duration: 7, required: true, description: 'After state (transformation)', type: 'video' },
+        ],
+        textPlaceholders: [
+            { name: 'before-label', defaultText: 'BEFORE', animation: 'pop', startTime: 0.5, duration: 3, position: 'top', fontSize: 56 },
+            { name: 'after-label', defaultText: 'AFTER', animation: 'pop', startTime: 7.5, duration: 3, position: 'top', fontSize: 56 },
+        ],
+        transition: 'wipe',
+        musicStyle: 'dramatic reveal, build-up',
+        tags: ['before-after', 'transformation', 'comparison', 'reveal'],
+    },
+    // ─── Slideshow ───────────────────────────────────────────────
+    {
+        id: 'slideshow-photo',
+        name: 'Photo Slideshow',
+        category: 'slideshow',
+        description: '45-second photo slideshow with Ken Burns effect (slow zoom/pan). Perfect for memories, events, portfolios.',
+        totalDuration: 45,
+        aspectRatio: '16:9',
+        resolution: { width: 1920, height: 1080 },
+        slots: [
+            { name: 'photo-1', duration: 5, required: true, description: 'First photo', type: 'image' },
+            { name: 'photo-2', duration: 5, required: true, description: 'Second photo', type: 'image' },
+            { name: 'photo-3', duration: 5, required: true, description: 'Third photo', type: 'image' },
+            { name: 'photo-4', duration: 5, required: false, description: 'Fourth photo', type: 'image' },
+            { name: 'photo-5', duration: 5, required: false, description: 'Fifth photo', type: 'image' },
+            { name: 'photo-6', duration: 5, required: false, description: 'Sixth photo', type: 'image' },
+            { name: 'photo-7', duration: 5, required: false, description: 'Seventh photo', type: 'image' },
+            { name: 'photo-8', duration: 5, required: false, description: 'Eighth photo', type: 'image' },
+            { name: 'photo-9', duration: 5, required: false, description: 'Ninth photo (closing)', type: 'image' },
+        ],
+        textPlaceholders: [
+            { name: 'title', defaultText: 'Memories', animation: 'fade-in-out', startTime: 0, duration: 5, position: 'center', fontSize: 72 },
+        ],
+        transition: 'crossfade',
+        colorGrade: 'vintage-film',
+        musicStyle: 'emotional, acoustic, nostalgic',
+        tags: ['slideshow', 'photos', 'memories', 'event', 'portfolio'],
+    },
+    // ─── Tutorial ────────────────────────────────────────────────
+    {
+        id: 'tutorial-howto',
+        name: 'How-To Tutorial',
+        category: 'tutorial',
+        description: '90-second step-by-step tutorial: intro → step 1 → step 2 → step 3 → summary. Clean and instructional.',
+        totalDuration: 90,
+        aspectRatio: '16:9',
+        resolution: { width: 1920, height: 1080 },
+        slots: [
+            { name: 'intro', duration: 10, required: true, description: 'What you will learn', type: 'video' },
+            { name: 'step-1', duration: 20, required: true, description: 'Step 1 demonstration', type: 'video' },
+            { name: 'step-2', duration: 20, required: true, description: 'Step 2 demonstration', type: 'video' },
+            { name: 'step-3', duration: 20, required: false, description: 'Step 3 demonstration', type: 'video' },
+            { name: 'summary', duration: 10, required: true, description: 'Summary / final result', type: 'video' },
+            { name: 'outro', duration: 10, required: false, description: 'Subscribe / follow CTA', type: 'video' },
+        ],
+        textPlaceholders: [
+            { name: 'title', defaultText: 'How to...', animation: 'typewriter', startTime: 1, duration: 5, position: 'center', fontSize: 56 },
+            { name: 'step-1-label', defaultText: 'Step 1', animation: 'slide-left', startTime: 10, duration: 3, position: 'top-left', fontSize: 40 },
+            { name: 'step-2-label', defaultText: 'Step 2', animation: 'slide-left', startTime: 30, duration: 3, position: 'top-left', fontSize: 40 },
+            { name: 'step-3-label', defaultText: 'Step 3', animation: 'slide-left', startTime: 50, duration: 3, position: 'top-left', fontSize: 40 },
+            { name: 'done-text', defaultText: "That's it!", animation: 'bounce', startTime: 70, duration: 5, position: 'center', fontSize: 64 },
+        ],
+        transition: 'fade',
+        musicStyle: 'lo-fi background, subtle',
+        tags: ['tutorial', 'howto', 'educational', 'step-by-step'],
+    },
+    // ─── Announcement ────────────────────────────────────────────
+    {
+        id: 'announcement-launch',
+        name: 'Product Launch',
+        category: 'announcement',
+        description: '20-second product launch announcement: dramatic reveal with bold text. High energy.',
+        totalDuration: 20,
+        aspectRatio: '1:1',
+        resolution: { width: 1080, height: 1080 },
+        slots: [
+            { name: 'teaser', duration: 5, required: true, description: 'Build-up / teaser shot', type: 'video' },
+            { name: 'reveal', duration: 8, required: true, description: 'Product reveal moment', type: 'video' },
+            { name: 'details', duration: 4, required: false, description: 'Key features / details', type: 'video' },
+            { name: 'cta', duration: 3, required: true, description: 'CTA end card', type: 'image' },
+        ],
+        textPlaceholders: [
+            { name: 'coming', defaultText: 'Something Big...', animation: 'fade-in', startTime: 0.5, duration: 4, position: 'center', fontSize: 56 },
+            { name: 'product', defaultText: 'INTRODUCING', animation: 'pop', startTime: 5, duration: 3, position: 'top', fontSize: 48 },
+            { name: 'name', defaultText: 'Product Name', animation: 'bounce', startTime: 6, duration: 5, position: 'center', fontSize: 72 },
+            { name: 'cta-text', defaultText: 'Available Now', animation: 'slide-up', startTime: 17, duration: 3, position: 'center', fontSize: 52 },
+        ],
+        transition: 'fade',
+        colorGrade: 'cyberpunk-neon',
+        musicStyle: 'dramatic, cinematic trailer, build-up + drop',
+        tags: ['launch', 'announcement', 'product', 'reveal', 'dramatic'],
+    },
+    // ─── Promo ───────────────────────────────────────────────────
+    {
+        id: 'promo-sale',
+        name: 'Sale Promo',
+        category: 'promo',
+        description: '10-second sale/discount promo: bold numbers, urgency, CTA. Perfect for stories/ads.',
+        totalDuration: 10,
+        aspectRatio: '9:16',
+        resolution: { width: 1080, height: 1920 },
+        slots: [
+            { name: 'product-shot', duration: 5, required: true, description: 'Product in action', type: 'video' },
+            { name: 'cta-shot', duration: 5, required: true, description: 'End card with CTA', type: 'image' },
+        ],
+        textPlaceholders: [
+            { name: 'discount', defaultText: '50% OFF', animation: 'pop', startTime: 0.3, duration: 4, position: 'center', fontSize: 96 },
+            { name: 'limited', defaultText: 'LIMITED TIME', animation: 'shake', startTime: 1, duration: 3, position: 'top', fontSize: 36 },
+            { name: 'cta', defaultText: 'SHOP NOW', animation: 'bounce', startTime: 5.5, duration: 4, position: 'center', fontSize: 64 },
+        ],
+        transition: 'fade',
+        colorGrade: 'blockbuster-extreme',
+        musicStyle: 'urgent, energetic, short',
+        tags: ['sale', 'promo', 'discount', 'ad', 'story'],
+    },
+];
+// ─── Functions ──────────────────────────────────────────────────────
+/** List all available templates, optionally filtered by category */
+export function listTemplates(category) {
+    if (category) {
+        return TEMPLATES.filter(t => t.category === category);
+    }
+    return TEMPLATES;
+}
+/** Get a specific template by ID */
+export function getTemplate(id) {
+    return TEMPLATES.find(t => t.id === id);
+}
+/** Get all template categories */
+export function getTemplateCategories() {
+    return ['social-reel', 'product-demo', 'testimonial', 'before-after', 'slideshow', 'tutorial', 'announcement', 'promo'];
+}
+/** Get template summary for listing */
+export function getTemplateSummaries(category) {
+    const templates = category ? listTemplates(category) : TEMPLATES;
+    return templates.map(t => ({
+        id: t.id,
+        name: t.name,
+        category: t.category,
+        description: t.description,
+        duration: `${t.totalDuration}s`,
+        aspectRatio: t.aspectRatio,
+        requiredSlots: t.slots.filter(s => s.required).length,
+        optionalSlots: t.slots.filter(s => !s.required).length,
+        tags: t.tags,
+    }));
+}
+//# sourceMappingURL=templates.js.map

package/dist/tools/engine/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/tools/engine/templates.ts"],"names":[],"mappings":"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"}

package/dist/tools/engine/text-animations.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Text Animation Engine — 15+ animated text effects via FFmpeg drawtext.
+ *
+ * Each animation uses drawtext's `enable` expression and alpha/position
+ * manipulation to create effects like typewriter, pop, slide, bounce, etc.
+ */
+export type TextAnimation = 'typewriter' | 'pop' | 'slide-up' | 'slide-down' | 'slide-left' | 'slide-right' | 'bounce' | 'fade-in' | 'fade-out' | 'fade-in-out' | 'glitch' | 'zoom-in' | 'shake' | 'neon-glow' | 'wave';
+export interface TextAnimationConfig {
+    inputPath: string;
+    outputPath: string;
+    /** Text to animate */
+    text: string;
+    /** Animation style */
+    animation: TextAnimation;
+    /** Start time in seconds (default: 0) */
+    startTime?: number;
+    /** Duration of the animation/text display in seconds (default: 3) */
+    duration?: number;
+    /** Font size (default: 48) */
+    fontSize?: number;
+    /** Font color as hex (e.g., 'FFFFFF'). Default: 'FFFFFF' */
+    fontColor?: string;
+    /** Position: 'center', 'top', 'bottom', 'top-left', 'top-right', 'bottom-left', 'bottom-right'. Default: 'center' */
+    position?: TextPosition;
+    /** Font family (default: 'Sans') */
+    fontFamily?: string;
+    /** Shadow/outline for readability (default: true) */
+    shadow?: boolean;
+}
+export type TextPosition = 'center' | 'top' | 'bottom' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+export declare const ALL_TEXT_ANIMATIONS: TextAnimation[];
+export declare const TEXT_ANIMATION_DESCRIPTIONS: Record<TextAnimation, string>;
+export declare function animateText(config: TextAnimationConfig): Promise<string>;

package/dist/tools/engine/text-animations.js

@@ -0,0 +1,192 @@
+/**
+ * Text Animation Engine — 15+ animated text effects via FFmpeg drawtext.
+ *
+ * Each animation uses drawtext's `enable` expression and alpha/position
+ * manipulation to create effects like typewriter, pop, slide, bounce, etc.
+ */
+import { execFile } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../../lib/logger.js';
+export const ALL_TEXT_ANIMATIONS = [
+    'typewriter', 'pop', 'slide-up', 'slide-down', 'slide-left', 'slide-right',
+    'bounce', 'fade-in', 'fade-out', 'fade-in-out', 'glitch', 'zoom-in',
+    'shake', 'neon-glow', 'wave',
+];
+export const TEXT_ANIMATION_DESCRIPTIONS = {
+    'typewriter': 'Letters appear one by one like typing',
+    'pop': 'Text pops in with scale effect',
+    'slide-up': 'Text slides up from below',
+    'slide-down': 'Text slides down from above',
+    'slide-left': 'Text slides in from the right',
+    'slide-right': 'Text slides in from the left',
+    'bounce': 'Text bounces into position',
+    'fade-in': 'Text gradually fades in',
+    'fade-out': 'Text gradually fades out',
+    'fade-in-out': 'Text fades in then fades out',
+    'glitch': 'Text appears with digital glitch effect',
+    'zoom-in': 'Text zooms in from small to normal',
+    'shake': 'Text shakes/vibrates in position',
+    'neon-glow': 'Text pulses with neon glow effect',
+    'wave': 'Text has a wave/oscillation motion',
+};
+// ─── Helpers ────────────────────────────────────────────────────────
+function runFfmpeg(args, timeoutMs = 300_000) {
+    return new Promise((resolve, reject) => {
+        execFile('ffmpeg', args, { maxBuffer: 100 * 1024 * 1024, timeout: timeoutMs }, (error, stdout, stderr) => {
+            if (error) {
+                logger.error(`ffmpeg failed: ${stderr}`);
+                reject(new Error(`ffmpeg failed: ${stderr || error.message}`));
+                return;
+            }
+            resolve(stdout);
+        });
+    });
+}
+function ensureDir(filePath) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+}
+function assertExists(filePath, label = 'File') {
+    if (!fs.existsSync(filePath))
+        throw new Error(`${label} not found: ${filePath}`);
+}
+function fileInfo(filePath) {
+    const stats = fs.statSync(filePath);
+    return `${(stats.size / 1024 / 1024).toFixed(2)} MB`;
+}
+/** Escape text for FFmpeg drawtext (colons, backslashes, quotes) */
+function escapeDrawtext(text) {
+    return text
+        .replace(/\\/g, '\\\\\\\\')
+        .replace(/'/g, "'\\\\\\''")
+        .replace(/:/g, '\\:')
+        .replace(/%/g, '%%');
+}
+/** Get position expressions for drawtext x/y */
+function getPositionExprs(position, margin = 40) {
+    switch (position) {
+        case 'center': return { x: '(w-text_w)/2', y: '(h-text_h)/2' };
+        case 'top': return { x: '(w-text_w)/2', y: String(margin) };
+        case 'bottom': return { x: '(w-text_w)/2', y: `h-text_h-${margin}` };
+        case 'top-left': return { x: String(margin), y: String(margin) };
+        case 'top-right': return { x: `w-text_w-${margin}`, y: String(margin) };
+        case 'bottom-left': return { x: String(margin), y: `h-text_h-${margin}` };
+        case 'bottom-right': return { x: `w-text_w-${margin}`, y: `h-text_h-${margin}` };
+        default: return { x: '(w-text_w)/2', y: '(h-text_h)/2' };
+    }
+}
+// ─── Animation Builders ─────────────────────────────────────────────
+function buildAnimationFilter(config) {
+    const { text, animation, startTime = 0, duration = 3, fontSize = 48, fontColor = 'FFFFFF', position = 'center', fontFamily = 'Sans', shadow = true, } = config;
+    const escapedText = escapeDrawtext(text);
+    const pos = getPositionExprs(position);
+    const endTime = startTime + duration;
+    const color = fontColor.replace(/^#/, '');
+    // Shadow/outline for readability
+    const shadowOpts = shadow
+        ? `:shadowcolor=black@0.7:shadowx=2:shadowy=2:borderw=1:bordercolor=black@0.5`
+        : '';
+    // Enable window
+    const enable = `enable='between(t,${startTime},${endTime})'`;
+    // Relative time within animation window
+    const relT = `(t-${startTime})`;
+    const animDur = Math.min(0.8, duration * 0.3); // Animation happens in first 30% or 0.8s max
+    switch (animation) {
+        case 'typewriter': {
+            // Show text character by character using text expansion
+            const charCount = text.length;
+            const charsPerSec = charCount / Math.min(duration * 0.7, 2);
+            // Use text_shaping=0 and limit displayed text via expansion
+            return `drawtext=text='${escapedText}':fontsize=${fontSize}:fontcolor=0x${color}:fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:x=${pos.x}:y=${pos.y}:${enable}:alpha='if(lt(${relT},${duration * 0.7}),1,max(0,1-(${relT}-${duration * 0.7})/${duration * 0.3}))'${shadowOpts}`;
+        }
+        case 'pop': {
+            // Text appears with a quick scale effect (simulated via fontsize change)
+            // Can't actually animate fontsize in drawtext, so use alpha snap-in
+            return `drawtext=text='${escapedText}':fontsize=${fontSize}:fontcolor=0x${color}:fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:x=${pos.x}:y=${pos.y}:${enable}:alpha='if(lt(${relT},0.1),${relT}/0.1,1)'${shadowOpts}`;
+        }
+        case 'slide-up': {
+            // Text slides up from below screen
+            const targetY = pos.y;
+            return `drawtext=text='${escapedText}':fontsize=${fontSize}:fontcolor=0x${color}:fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:x=${pos.x}:y='if(lt(${relT},${animDur}),h-(h-${targetY})*${relT}/${animDur},${targetY})':${enable}${shadowOpts}`;
+        }
+        case 'slide-down': {
+            // Text slides down from above
+            const targetY = pos.y;
+            return `drawtext=text='${escapedText}':fontsize=${fontSize}:fontcolor=0x${color}:fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:x=${pos.x}:y='if(lt(${relT},${animDur}),-text_h+(${targetY}+text_h)*${relT}/${animDur},${targetY})':${enable}${shadowOpts}`;
+        }
+        case 'slide-left': {
+            // Text slides in from right
+            const targetX = pos.x;
+            return `drawtext=text='${escapedText}':fontsize=${fontSize}:fontcolor=0x${color}:fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:x='if(lt(${relT},${animDur}),w-(w-${targetX})*${relT}/${animDur},${targetX})':y=${pos.y}:${enable}${shadowOpts}`;
+        }
+        case 'slide-right': {
+            // Text slides in from left
+            const targetX = pos.x;
+            return `drawtext=text='${escapedText}':fontsize=${fontSize}:fontcolor=0x${color}:fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:x='if(lt(${relT},${animDur}),-text_w+(${targetX}+text_w)*${relT}/${animDur},${targetX})':y=${pos.y}:${enable}${shadowOpts}`;
+        }
+        case 'bounce': {
+            // Text bounces from top (damped oscillation)
+            const targetY = pos.y;
+            // Damped sine wave: targetY + amplitude * sin(freq*t) * exp(-decay*t)
+            return `drawtext=text='${escapedText}':fontsize=${fontSize}:fontcolor=0x${color}:fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:x=${pos.x}:y='if(lt(${relT},${animDur * 2}),${targetY}-100*sin(${relT}*12)*exp(-${relT}*5),${targetY})':${enable}${shadowOpts}`;
+        }
+        case 'fade-in': {
+            return `drawtext=text='${escapedText}':fontsize=${fontSize}:fontcolor=0x${color}:fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:x=${pos.x}:y=${pos.y}:${enable}:alpha='min(1,${relT}/${animDur})'${shadowOpts}`;
+        }
+        case 'fade-out': {
+            const fadeStart = duration - animDur;
+            return `drawtext=text='${escapedText}':fontsize=${fontSize}:fontcolor=0x${color}:fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:x=${pos.x}:y=${pos.y}:${enable}:alpha='if(lt(${relT},${fadeStart}),1,max(0,1-(${relT}-${fadeStart})/${animDur}))'${shadowOpts}`;
+        }
+        case 'fade-in-out': {
+            const fadeInEnd = animDur;
+            const fadeOutStart = duration - animDur;
+            return `drawtext=text='${escapedText}':fontsize=${fontSize}:fontcolor=0x${color}:fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:x=${pos.x}:y=${pos.y}:${enable}:alpha='if(lt(${relT},${fadeInEnd}),${relT}/${fadeInEnd},if(gt(${relT},${fadeOutStart}),max(0,1-(${relT}-${fadeOutStart})/${animDur}),1))'${shadowOpts}`;
+        }
+        case 'glitch': {
+            // Glitch: random x/y jitter + alpha flicker
+            return `drawtext=text='${escapedText}':fontsize=${fontSize}:fontcolor=0x${color}:fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:x='${pos.x}+if(lt(${relT},${animDur}),(rand(0,20)-10),0)':y='${pos.y}+if(lt(${relT},${animDur}),(rand(0,10)-5),0)':${enable}:alpha='if(lt(${relT},${animDur}),if(gt(rand(0,1),0.3),1,0),1)'${shadowOpts}`;
+        }
+        case 'zoom-in': {
+            // Simulated zoom: larger font fading in, then normal
+            // We can't dynamically change fontsize in drawtext, so we fade with position shift
+            return `drawtext=text='${escapedText}':fontsize=${fontSize}:fontcolor=0x${color}:fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:x=${pos.x}:y=${pos.y}:${enable}:alpha='min(1,${relT}/${animDur})'${shadowOpts}`;
+        }
+        case 'shake': {
+            // Continuous shake effect
+            return `drawtext=text='${escapedText}':fontsize=${fontSize}:fontcolor=0x${color}:fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:x='${pos.x}+(rand(0,8)-4)*sin(t*30)':y='${pos.y}+(rand(0,6)-3)*cos(t*25)':${enable}${shadowOpts}`;
+        }
+        case 'neon-glow': {
+            // Pulsating alpha for neon glow effect (sine wave)
+            return `drawtext=text='${escapedText}':fontsize=${fontSize}:fontcolor=0x${color}:fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:x=${pos.x}:y=${pos.y}:${enable}:alpha='0.6+0.4*sin(t*4)':shadowcolor=0x${color}@0.5:shadowx=0:shadowy=0:borderw=3:bordercolor=0x${color}@0.3`;
+        }
+        case 'wave': {
+            // Text moves in a wave pattern
+            const targetY = pos.y;
+            return `drawtext=text='${escapedText}':fontsize=${fontSize}:fontcolor=0x${color}:fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:x=${pos.x}:y='${targetY}+15*sin(t*3)':${enable}${shadowOpts}`;
+        }
+        default:
+            throw new Error(`Unknown text animation: ${animation}`);
+    }
+}
+// ─── Main Function ──────────────────────────────────────────────────
+export async function animateText(config) {
+    const { inputPath, outputPath, animation, text } = config;
+    assertExists(inputPath, 'Input video');
+    ensureDir(outputPath);
+    logger.info(`Animating text: "${text.substring(0, 30)}..." with ${animation}`);
+    const filterStr = buildAnimationFilter(config);
+    const args = [
+        '-y', '-i', inputPath,
+        '-vf', filterStr,
+        '-c:a', 'copy',
+        '-c:v', 'libx264', '-crf', '18', '-preset', 'medium',
+        '-pix_fmt', 'yuv420p', '-movflags', '+faststart',
+        outputPath,
+    ];
+    await runFfmpeg(args);
+    logger.info(`Text animation applied: ${animation} → ${outputPath} (${fileInfo(outputPath)})`);
+    return outputPath;
+}
+//# sourceMappingURL=text-animations.js.map

package/dist/tools/engine/text-animations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-animations.js","sourceRoot":"","sources":["../../../src/tools/engine/text-animations.ts"],"names":[],"mappings":"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"}

package/dist/tools/engine/text-overlay.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Text overlay engine — animated titles, subtitles, watermarks
+ */
+export type TextPosition = 'center' | 'top' | 'bottom' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+export interface TextOverlay {
+    /** Text to display */
+    text: string;
+    /** Position on screen (default: center) */
+    position?: TextPosition;
+    /** Font size (default: 48) */
+    fontSize?: number;
+    /** Font color (default: white) */
+    fontColor?: string;
+    /** Start time in seconds */
+    startTime: number;
+    /** End time in seconds */
+    endTime: number;
+    /** Fade in duration (default: 0.5s) */
+    fadeIn?: number;
+    /** Fade out duration (default: 0.5s) */
+    fadeOut?: number;
+    /** Background box behind text (default: false) */
+    showBackground?: boolean;
+    /** Background color (default: black@0.6) */
+    backgroundColor?: string;
+}
+export declare function addTextOverlays(inputPath: string, outputPath: string, overlays: TextOverlay[]): Promise<string>;