@studiomeyer/mcp-video 1.0.0

package/dist/tools/engine/concat.js

@@ -0,0 +1,149 @@
+/**
+ * Video concatenation engine — merge multiple clips with cinematic transitions
+ */
+import { execFile } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../../lib/logger.js';
+import { getMediaDuration } from './audio.js';
+// ─── Available Transitions ──────────────────────────────────────────
+export const TRANSITIONS = [
+    'fade', 'fadeblack', 'fadewhite', 'dissolve',
+    'wipeleft', 'wiperight', 'wipeup', 'wipedown',
+    'slideleft', 'slideright', 'slideup', 'slidedown',
+    'smoothleft', 'smoothright', 'smoothup', 'smoothdown',
+    'circlecrop', 'circleopen', 'circleclose',
+    'rectcrop', 'vertopen', 'vertclose', 'horzopen', 'horzclose',
+    'diagtl', 'diagtr', 'diagbl', 'diagbr',
+    'hlslice', 'hrslice', 'vuslice', 'vdslice',
+    'radial', 'pixelize',
+];
+export async function concatenateVideos(config) {
+    const { clips, outputPath, transition = 'fade', transitionDuration = 1, targetWidth = 1920, targetHeight = 1080, targetFps = 60, } = config;
+    if (clips.length === 0)
+        throw new Error('No clips provided');
+    if (clips.length === 1) {
+        fs.copyFileSync(clips[0].path, outputPath);
+        return outputPath;
+    }
+    // Verify all clips exist
+    for (const clip of clips) {
+        if (!fs.existsSync(clip.path))
+            throw new Error(`Clip not found: ${clip.path}`);
+    }
+    // Get durations for each clip
+    const durations = [];
+    for (const clip of clips) {
+        let dur = await getMediaDuration(clip.path);
+        if (clip.trimStart)
+            dur -= clip.trimStart;
+        if (clip.trimEnd)
+            dur = Math.min(dur, clip.trimEnd - (clip.trimStart ?? 0));
+        durations.push(dur);
+    }
+    logger.info(`Concatenating ${clips.length} clips (${durations.map(d => d.toFixed(1) + 's').join(' + ')}) with ${transition} transition`);
+    const inputs = [];
+    const filterParts = [];
+    // Add inputs
+    for (const clip of clips) {
+        if (clip.trimStart !== undefined || clip.trimEnd !== undefined) {
+            if (clip.trimStart)
+                inputs.push('-ss', String(clip.trimStart));
+            if (clip.trimEnd)
+                inputs.push('-to', String(clip.trimEnd));
+        }
+        inputs.push('-i', clip.path);
+    }
+    // Normalize all inputs to same resolution and fps
+    for (let i = 0; i < clips.length; i++) {
+        filterParts.push(`[${i}:v]scale=${targetWidth}:${targetHeight}:force_original_aspect_ratio=decrease,` +
+            `pad=${targetWidth}:${targetHeight}:(ow-iw)/2:(oh-ih)/2:color=black,` +
+            `setsar=1,fps=${targetFps}[v${i}]`);
+    }
+    // Chain xfade filters with correct offset calculation
+    let cumulativeDuration = durations[0];
+    let prevLabel = 'v0';
+    for (let i = 1; i < clips.length; i++) {
+        const offset = Math.max(0, cumulativeDuration - transitionDuration);
+        const outLabel = i === clips.length - 1 ? 'vout' : `xf${i}`;
+        filterParts.push(`[${prevLabel}][v${i}]xfade=transition=${transition}:duration=${transitionDuration}:offset=${offset.toFixed(3)}[${outLabel}]`);
+        cumulativeDuration += durations[i] - transitionDuration;
+        prevLabel = outLabel;
+    }
+    // Ensure output dir exists
+    const outDir = path.dirname(outputPath);
+    if (!fs.existsSync(outDir))
+        fs.mkdirSync(outDir, { recursive: true });
+    const args = [
+        '-y',
+        ...inputs,
+        '-filter_complex', filterParts.join(';'),
+        '-map', '[vout]',
+        '-c:v', 'libx264',
+        '-crf', '18',
+        '-preset', 'medium',
+        '-pix_fmt', 'yuv420p',
+        '-movflags', '+faststart',
+        outputPath,
+    ];
+    await runFfmpeg(args);
+    const stats = fs.statSync(outputPath);
+    logger.info(`Concatenated: ${outputPath} (${(stats.size / 1024 / 1024).toFixed(2)} MB)`);
+    return outputPath;
+}
+export async function generateIntro(config) {
+    const { text, subtitle, duration = 3, backgroundColor = '#0a0a0a', textColor = 'white', width = 1920, height = 1080, fps = 60, outputPath, } = config;
+    const outDir = path.dirname(outputPath);
+    if (!fs.existsSync(outDir))
+        fs.mkdirSync(outDir, { recursive: true });
+    // Find a usable font
+    const fontPath = await findFont();
+    // Build drawtext filter with fade animation
+    const escapedText = text.replace(/'/g, "\\\\'").replace(/:/g, '\\:');
+    let vf = `drawtext=text='${escapedText}':fontfile='${fontPath}':fontsize=72:fontcolor=${textColor}:x=(w-text_w)/2:y=(h-text_h)/2-40:alpha='if(lt(t\\,0.8)\\,t/0.8\\,if(gt(t\\,${duration - 0.8})\\,(${duration}-t)/0.8\\,1))'`;
+    if (subtitle) {
+        const escapedSub = subtitle.replace(/'/g, "\\\\'").replace(/:/g, '\\:');
+        vf += `,drawtext=text='${escapedSub}':fontfile='${fontPath}':fontsize=36:fontcolor=${textColor}@0.7:x=(w-text_w)/2:y=(h-text_h)/2+40:alpha='if(lt(t\\,1.2)\\,0\\,if(lt(t\\,2)\\,(t-1.2)/0.8\\,if(gt(t\\,${duration - 0.8})\\,(${duration}-t)/0.8\\,1)))'`;
+    }
+    const args = [
+        '-y',
+        '-f', 'lavfi',
+        '-i', `color=c=${backgroundColor}:s=${width}x${height}:d=${duration}:r=${fps}`,
+        '-vf', vf,
+        '-c:v', 'libx264',
+        '-crf', '18',
+        '-pix_fmt', 'yuv420p',
+        '-movflags', '+faststart',
+        outputPath,
+    ];
+    await runFfmpeg(args);
+    logger.info(`Intro generated: ${outputPath}`);
+    return outputPath;
+}
+// ─── Helpers ────────────────────────────────────────────────────────
+async function findFont() {
+    const candidates = [
+        '/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf',
+        '/usr/share/fonts/truetype/liberation/LiberationSans-Bold.ttf',
+        '/usr/share/fonts/truetype/ubuntu/Ubuntu-Bold.ttf',
+        '/usr/share/fonts/truetype/freefont/FreeSansBold.ttf',
+    ];
+    for (const f of candidates) {
+        if (fs.existsSync(f))
+            return f;
+    }
+    return '/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf';
+}
+function runFfmpeg(args) {
+    return new Promise((resolve, reject) => {
+        execFile('ffmpeg', args, { maxBuffer: 50 * 1024 * 1024 }, (error, stdout, stderr) => {
+            if (error) {
+                logger.error(`ffmpeg failed: ${stderr}`);
+                reject(new Error(`ffmpeg failed: ${stderr || error.message}`));
+                return;
+            }
+            resolve(stdout);
+        });
+    });
+}
+//# sourceMappingURL=concat.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * Cursor simulation — injects a visible, smooth cursor into the page
+ * Uses Bézier curves for natural-looking mouse movement
+ */
+import type { Page } from 'playwright';
+import type { CursorConfig } from './types.js';
+/**
+ * Inject a visible cursor overlay into the page
+ */
+export declare function injectCursor(page: Page, config?: Partial<CursorConfig>): Promise<void>;
+/**
+ * Move cursor to a specific position with smooth Bézier interpolation
+ */
+export declare function moveCursor(page: Page, targetX: number, targetY: number, duration?: number, fps?: number): Promise<void>;
+/**
+ * Move cursor to a CSS selector's center
+ */
+export declare function moveCursorToElement(page: Page, selector: string, duration?: number, fps?: number): Promise<void>;
+/**
+ * Animate a click effect at current cursor position
+ */
+export declare function animateClick(page: Page): Promise<void>;
+/**
+ * Hide cursor (move off-screen)
+ */
+export declare function hideCursor(page: Page): Promise<void>;

package/dist/tools/engine/cursor.js

@@ -0,0 +1,185 @@
+/**
+ * Cursor simulation — injects a visible, smooth cursor into the page
+ * Uses Bézier curves for natural-looking mouse movement
+ */
+const DEFAULT_CURSOR = {
+    enabled: true,
+    style: 'dot',
+    color: 'rgba(255, 255, 255, 0.9)',
+    size: 20,
+    clickAnimation: true,
+};
+/**
+ * Inject a visible cursor overlay into the page
+ */
+export async function injectCursor(page, config = {}) {
+    const opts = { ...DEFAULT_CURSOR, ...config };
+    if (!opts.enabled)
+        return;
+    await page.evaluate(({ style, color, size, clickAnimation }) => {
+        // Create cursor element
+        const cursor = document.createElement('div');
+        cursor.id = '__cinema-cursor';
+        const isArrow = style === 'arrow' || style === 'pointer';
+        if (isArrow) {
+            // SVG arrow cursor
+            cursor.innerHTML = `<svg width="${size}" height="${size}" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+          <path d="M5 3L19 12L12 13L9 20L5 3Z" fill="${color}" stroke="rgba(0,0,0,0.4)" stroke-width="1.5"/>
+        </svg>`;
+            Object.assign(cursor.style, {
+                position: 'fixed',
+                zIndex: '2147483647',
+                pointerEvents: 'none',
+                left: '-100px',
+                top: '-100px',
+                transition: 'none',
+                filter: 'drop-shadow(0 2px 4px rgba(0,0,0,0.3))',
+            });
+        }
+        else {
+            // Dot cursor
+            Object.assign(cursor.style, {
+                position: 'fixed',
+                zIndex: '2147483647',
+                pointerEvents: 'none',
+                width: `${size}px`,
+                height: `${size}px`,
+                borderRadius: '50%',
+                backgroundColor: color,
+                border: '2px solid rgba(0,0,0,0.2)',
+                boxShadow: '0 0 12px rgba(0,0,0,0.15), 0 2px 8px rgba(0,0,0,0.1)',
+                left: '-100px',
+                top: '-100px',
+                transform: 'translate(-50%, -50%)',
+                transition: 'none',
+            });
+        }
+        document.body.appendChild(cursor);
+        // Click animation ring
+        if (clickAnimation) {
+            const ring = document.createElement('div');
+            ring.id = '__cinema-cursor-ring';
+            Object.assign(ring.style, {
+                position: 'fixed',
+                zIndex: '2147483646',
+                pointerEvents: 'none',
+                width: `${size * 2.5}px`,
+                height: `${size * 2.5}px`,
+                borderRadius: '50%',
+                border: `2px solid ${color}`,
+                left: '-100px',
+                top: '-100px',
+                transform: 'translate(-50%, -50%) scale(0)',
+                opacity: '0',
+                transition: 'none',
+            });
+            document.body.appendChild(ring);
+        }
+        // Store config on window for later use
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        window.__cinemaCursorConfig = { style, color, size, clickAnimation };
+    }, opts);
+}
+/**
+ * Move cursor to a specific position with smooth Bézier interpolation
+ */
+export async function moveCursor(page, targetX, targetY, duration = 800, fps = 60) {
+    const frames = Math.max(1, Math.ceil((duration / 1000) * fps));
+    // Get current cursor position
+    const startPos = await page.evaluate(() => {
+        const cursor = document.getElementById('__cinema-cursor');
+        if (!cursor)
+            return { x: 0, y: 0 };
+        return {
+            x: parseFloat(cursor.style.left) || 0,
+            y: parseFloat(cursor.style.top) || 0,
+        };
+    });
+    // Generate Bézier control points for natural movement
+    const dx = targetX - startPos.x;
+    const dy = targetY - startPos.y;
+    const cp1x = startPos.x + dx * 0.3 + (Math.random() - 0.5) * Math.abs(dx) * 0.2;
+    const cp1y = startPos.y + dy * 0.1 + (Math.random() - 0.5) * Math.abs(dy) * 0.3;
+    const cp2x = startPos.x + dx * 0.7 + (Math.random() - 0.5) * Math.abs(dx) * 0.15;
+    const cp2y = startPos.y + dy * 0.9 + (Math.random() - 0.5) * Math.abs(dy) * 0.2;
+    // Animate through Bézier curve
+    for (let i = 0; i <= frames; i++) {
+        const t = i / frames;
+        // Ease the t parameter for acceleration/deceleration
+        const et = t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t;
+        // Cubic Bézier
+        const mt = 1 - et;
+        const x = mt * mt * mt * startPos.x +
+            3 * mt * mt * et * cp1x +
+            3 * mt * et * et * cp2x +
+            et * et * et * targetX;
+        const y = mt * mt * mt * startPos.y +
+            3 * mt * mt * et * cp1y +
+            3 * mt * et * et * cp2y +
+            et * et * et * targetY;
+        await page.evaluate(({ x, y }) => {
+            const cursor = document.getElementById('__cinema-cursor');
+            if (cursor) {
+                cursor.style.left = `${x}px`;
+                cursor.style.top = `${y}px`;
+            }
+        }, { x: Math.round(x), y: Math.round(y) });
+        // Also move the actual mouse for hover effects
+        await page.mouse.move(Math.round(x), Math.round(y));
+    }
+}
+/**
+ * Move cursor to a CSS selector's center
+ */
+export async function moveCursorToElement(page, selector, duration = 800, fps = 60) {
+    const pos = await page.evaluate((sel) => {
+        const el = document.querySelector(sel);
+        if (!el)
+            return null;
+        const rect = el.getBoundingClientRect();
+        return {
+            x: rect.left + rect.width / 2,
+            y: rect.top + rect.height / 2,
+        };
+    }, selector);
+    if (pos) {
+        await moveCursor(page, pos.x, pos.y, duration, fps);
+    }
+}
+/**
+ * Animate a click effect at current cursor position
+ */
+export async function animateClick(page) {
+    await page.evaluate(() => {
+        const ring = document.getElementById('__cinema-cursor-ring');
+        const cursor = document.getElementById('__cinema-cursor');
+        if (!ring || !cursor)
+            return;
+        ring.style.left = cursor.style.left;
+        ring.style.top = cursor.style.top;
+        ring.style.transition = 'transform 0.4s ease-out, opacity 0.4s ease-out';
+        ring.style.transform = 'translate(-50%, -50%) scale(0)';
+        ring.style.opacity = '1';
+        // Trigger animation
+        requestAnimationFrame(() => {
+            ring.style.transform = 'translate(-50%, -50%) scale(1)';
+            ring.style.opacity = '0';
+        });
+    });
+    // Wait for animation
+    await new Promise((r) => setTimeout(r, 450));
+}
+/**
+ * Hide cursor (move off-screen)
+ */
+export async function hideCursor(page) {
+    await page.evaluate(() => {
+        const cursor = document.getElementById('__cinema-cursor');
+        const ring = document.getElementById('__cinema-cursor-ring');
+        if (cursor)
+            cursor.style.left = '-100px';
+        if (ring)
+            ring.style.left = '-100px';
+    });
+}
+//# sourceMappingURL=cursor.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * Cinema-grade easing functions for smooth scroll animations
+ * All functions: t ∈ [0,1] → output ∈ [0,1]
+ */
+import type { EasingName } from './types.js';
+declare const EASINGS: Record<EasingName, (t: number) => number>;
+/**
+ * Get an easing function by name
+ */
+export declare function getEasing(name: EasingName): (t: number) => number;
+/**
+ * Apply easing to a progress value and map to a range
+ */
+export declare function applyEasing(progress: number, totalDistance: number, easingName?: EasingName): number;
+export { EASINGS };

package/dist/tools/engine/easing.js

@@ -0,0 +1,100 @@
+/**
+ * Cinema-grade easing functions for smooth scroll animations
+ * All functions: t ∈ [0,1] → output ∈ [0,1]
+ */
+// ─── Core Easing Functions ──────────────────────────────────────────
+const linear = (t) => t;
+const easeInQuad = (t) => t * t;
+const easeOutQuad = (t) => t * (2 - t);
+const easeInOutQuad = (t) => t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t;
+const easeInCubic = (t) => t * t * t;
+const easeOutCubic = (t) => (--t) * t * t + 1;
+const easeInOutCubic = (t) => t < 0.5 ? 4 * t * t * t : 1 - Math.pow(-2 * t + 2, 3) / 2;
+const easeInQuart = (t) => t * t * t * t;
+const easeOutQuart = (t) => 1 - (--t) * t * t * t;
+const easeInOutQuart = (t) => t < 0.5 ? 8 * t * t * t * t : 1 - Math.pow(-2 * t + 2, 4) / 2;
+const easeInQuint = (t) => t * t * t * t * t;
+const easeOutQuint = (t) => 1 + (--t) * t * t * t * t;
+const easeInOutQuint = (t) => t < 0.5 ? 16 * t * t * t * t * t : 1 - Math.pow(-2 * t + 2, 5) / 2;
+const easeInOutSine = (t) => -(Math.cos(Math.PI * t) - 1) / 2;
+/**
+ * Cinematic easing: slow start (15%), smooth cruise (70%), slow end (15%)
+ * Uses quintic in/out for dramatic deceleration at edges
+ */
+const cinematic = (t) => {
+    if (t < 0.15) {
+        // Slow ease-in (quintic)
+        const local = t / 0.15;
+        return 0.15 * (local * local * local);
+    }
+    else if (t > 0.85) {
+        // Slow ease-out (quintic)
+        const local = (t - 0.85) / 0.15;
+        return 0.85 + 0.15 * (1 - Math.pow(1 - local, 3));
+    }
+    else {
+        // Linear cruise in the middle
+        const local = (t - 0.15) / 0.70;
+        return 0.15 + 0.70 * local;
+    }
+};
+/**
+ * Showcase easing: dramatic slow start, buttery cruise, elegant deceleration
+ * Designed specifically for portfolio showcase videos
+ *
+ * Distribution: 25% slow start → 50% smooth cruise → 25% slow end
+ * The cruise section uses easeInOutSine for a gentle wave-like motion
+ * that never feels rushed — perfect for long pages
+ */
+const showcase = (t) => {
+    if (t < 0.25) {
+        // Very slow ease-in (quintic for dramatic slowness)
+        const local = t / 0.25;
+        return 0.08 * easeInQuint(local);
+    }
+    else if (t > 0.75) {
+        // Very slow ease-out (quintic for elegant stop)
+        const local = (t - 0.75) / 0.25;
+        return 0.92 + 0.08 * easeOutQuint(local);
+    }
+    else {
+        // Smooth cruise in the middle — easeInOutSine for wave-like feel
+        const local = (t - 0.25) / 0.50;
+        return 0.08 + 0.84 * easeInOutSine(local);
+    }
+};
+// ─── Easing Registry ────────────────────────────────────────────────
+const EASINGS = {
+    linear,
+    easeInQuad,
+    easeOutQuad,
+    easeInOutQuad,
+    easeInCubic,
+    easeOutCubic,
+    easeInOutCubic,
+    easeInQuart,
+    easeOutQuart,
+    easeInOutQuart,
+    easeInQuint,
+    easeOutQuint,
+    easeInOutQuint,
+    easeInOutSine,
+    cinematic,
+    showcase,
+};
+/**
+ * Get an easing function by name
+ */
+export function getEasing(name) {
+    return EASINGS[name] ?? EASINGS.easeInOutCubic;
+}
+/**
+ * Apply easing to a progress value and map to a range
+ */
+export function applyEasing(progress, totalDistance, easingName = 'easeInOutCubic') {
+    const easingFn = getEasing(easingName);
+    const clamped = Math.max(0, Math.min(1, progress));
+    return Math.round(easingFn(clamped) * totalDistance);
+}
+export { EASINGS };
+//# sourceMappingURL=easing.js.map

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

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