@studiomeyer/mcp-video 1.0.0

package/dist/tools/engine/encoder.js

@@ -0,0 +1,154 @@
+/**
+ * ffmpeg encoding pipeline — stitches PNG frames into cinema-grade video
+ */
+import { execFile } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../../lib/logger.js';
+const CODEC_MAP = {
+    h264: {
+        codec: 'libx264',
+        format: 'mp4',
+        extraArgs: ['-pix_fmt', 'yuv420p', '-movflags', '+faststart'],
+    },
+    h265: {
+        codec: 'libx265',
+        format: 'mp4',
+        extraArgs: ['-pix_fmt', 'yuv420p', '-tag:v', 'hvc1'],
+    },
+    vp9: {
+        codec: 'libvpx-vp9',
+        format: 'webm',
+        extraArgs: ['-pix_fmt', 'yuv420p', '-row-mt', '1'],
+    },
+};
+/**
+ * Encode a sequence of PNG frames into a video file using ffmpeg
+ */
+export async function encodeFrames(framesDir, framePattern, outputPath, totalFrames, config = {}) {
+    const { codec: codecName = 'h264', crf = 18, preset = 'slow', fps = 60, } = config;
+    const codecConfig = CODEC_MAP[codecName];
+    const format = config.format ?? codecConfig.format;
+    const finalOutput = outputPath.endsWith(`.${format}`)
+        ? outputPath
+        : `${outputPath}.${format}`;
+    // Ensure output directory exists
+    const outputDir = path.dirname(finalOutput);
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+    const inputPattern = path.join(framesDir, framePattern);
+    const args = [
+        '-y', // Overwrite output
+        '-framerate', String(fps), // Input frame rate
+        '-i', inputPattern, // Input pattern
+        '-c:v', codecConfig.codec, // Video codec
+        '-preset', preset, // Encoding speed/quality
+        '-crf', String(crf), // Quality factor
+        ...codecConfig.extraArgs, // Codec-specific args
+        finalOutput, // Output file
+    ];
+    logger.info(`Encoding ${totalFrames} frames → ${finalOutput} (${codecName}, CRF ${crf}, ${fps}fps)`);
+    await runFfmpeg(args);
+    // Get file stats
+    const stats = fs.statSync(finalOutput);
+    const duration = totalFrames / fps;
+    return {
+        outputPath: finalOutput,
+        format,
+        codec: codecName,
+        fps,
+        sizeBytes: stats.size,
+        sizeMB: (stats.size / (1024 * 1024)).toFixed(2),
+        duration,
+        totalFrames,
+    };
+}
+/**
+ * Add a fade-in and/or fade-out to an existing video
+ */
+export async function addFade(inputPath, outputPath, fadeInDuration = 0.5, fadeOutDuration = 0.5, totalDuration) {
+    const fadeOutStart = totalDuration - fadeOutDuration;
+    const filter = `fade=t=in:st=0:d=${fadeInDuration},fade=t=out:st=${fadeOutStart}:d=${fadeOutDuration}`;
+    const args = [
+        '-y',
+        '-i', inputPath,
+        '-vf', filter,
+        '-c:v', 'libx264',
+        '-crf', '18',
+        '-preset', 'medium',
+        '-pix_fmt', 'yuv420p',
+        '-movflags', '+faststart',
+        outputPath,
+    ];
+    await runFfmpeg(args);
+}
+/**
+ * Concatenate multiple video clips with crossfade transitions
+ */
+export async function concatenateWithTransition(clips, outputPath, transitionDuration = 1, transitionType = 'fade') {
+    if (clips.length < 2) {
+        // Single clip — just copy
+        if (clips[0] && clips[0] !== outputPath) {
+            fs.copyFileSync(clips[0], outputPath);
+        }
+        return;
+    }
+    // Build ffmpeg xfade filter chain for multiple clips
+    const inputs = [];
+    const filterParts = [];
+    for (const clip of clips) {
+        inputs.push('-i', clip);
+    }
+    // Chain xfade filters
+    let prevLabel = '0:v';
+    for (let i = 1; i < clips.length; i++) {
+        const outLabel = i === clips.length - 1 ? '' : `[v${i}]`;
+        const offset = i * 5 - transitionDuration; // Approximate offset
+        const filter = `[${prevLabel}][${i}:v]xfade=transition=${transitionType}:duration=${transitionDuration}:offset=${offset}`;
+        filterParts.push(filter + (outLabel ? outLabel : ''));
+        prevLabel = outLabel ? `v${i}` : '';
+    }
+    const args = [
+        '-y',
+        ...inputs,
+        '-filter_complex', filterParts.join(';'),
+        '-c:v', 'libx264',
+        '-crf', '18',
+        '-pix_fmt', 'yuv420p',
+        '-movflags', '+faststart',
+        outputPath,
+    ];
+    await runFfmpeg(args);
+}
+/**
+ * Run ffmpeg command and return a promise
+ */
+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;
+            }
+            logger.debug(`ffmpeg output: ${stderr.slice(-200)}`);
+            resolve(stdout);
+        });
+    });
+}
+/**
+ * Clean up temporary frame files
+ */
+export function cleanupFrames(framesDir) {
+    try {
+        if (fs.existsSync(framesDir)) {
+            fs.rmSync(framesDir, { recursive: true, force: true });
+            logger.debug(`Cleaned up frames: ${framesDir}`);
+        }
+    }
+    catch (error) {
+        logger.warn(`Failed to cleanup frames: ${framesDir}`);
+    }
+}
+//# sourceMappingURL=encoder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.js","sourceRoot":"","sources":["../../../src/tools/engine/encoder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAc7C,MAAM,SAAS,GAAoF;IACjG,IAAI,EAAE;QACJ,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC;KAC9D;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC;KACrD;IACD,GAAG,EAAE;QACH,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC;KACnD;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAAiB,EACjB,YAAoB,EACpB,UAAkB,EAClB,WAAmB,EACnB,SAAyB,EAAE;IAE3B,MAAM,EACJ,KAAK,EAAE,SAAS,GAAG,MAAM,EACzB,GAAG,GAAG,EAAE,EACR,MAAM,GAAG,MAAM,EACf,GAAG,GAAG,EAAE,GACT,GAAG,MAAM,CAAC;IAEX,MAAM,WAAW,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,WAAW,CAAC,MAAM,CAAC;IACnD,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC;QACnD,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC;IAE9B,iCAAiC;IACjC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAExD,MAAM,IAAI,GAAG;QACX,IAAI,EAA8B,mBAAmB;QACrD,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,EAAS,mBAAmB;QACrD,IAAI,EAAE,YAAY,EAAgB,gBAAgB;QAClD,MAAM,EAAE,WAAW,CAAC,KAAK,EAAS,cAAc;QAChD,SAAS,EAAE,MAAM,EAAiB,yBAAyB;QAC3D,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAe,iBAAiB;QACnD,GAAG,WAAW,CAAC,SAAS,EAAU,sBAAsB;QACxD,WAAW,EAAuB,cAAc;KACjD,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,YAAY,WAAW,aAAa,WAAW,KAAK,SAAS,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC;IAErG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IAEtB,iBAAiB;IACjB,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,WAAW,GAAG,GAAG,CAAC;IAEnC,OAAO;QACL,UAAU,EAAE,WAAW;QACvB,MAAM;QACN,KAAK,EAAE,SAAS;QAChB,GAAG;QACH,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,QAAQ;QACR,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,SAAiB,EACjB,UAAkB,EAClB,iBAAyB,GAAG,EAC5B,kBAA0B,GAAG,EAC7B,aAAqB;IAErB,MAAM,YAAY,GAAG,aAAa,GAAG,eAAe,CAAC;IACrD,MAAM,MAAM,GAAG,oBAAoB,cAAc,kBAAkB,YAAY,MAAM,eAAe,EAAE,CAAC;IAEvG,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,QAAQ;QACnB,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,YAAY;QACzB,UAAU;KACX,CAAC;IAEF,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAAe,EACf,UAAkB,EAClB,qBAA6B,CAAC,EAC9B,iBAAyB,MAAM;IAE/B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,0BAA0B;QAC1B,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;YACxC,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QACxC,CAAC;QACD,OAAO;IACT,CAAC;IAED,qDAAqD;IACrD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,sBAAsB;IACtB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;QACzD,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,CAAC,qBAAqB;QAChE,MAAM,MAAM,GAAG,IAAI,SAAS,KAAK,CAAC,uBAAuB,cAAc,aAAa,kBAAkB,WAAW,MAAM,EAAE,CAAC;QAC1H,WAAW,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtD,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,GAAG,MAAM;QACT,iBAAiB,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;QACxC,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,YAAY;QACzB,UAAU;KACX,CAAC;IAEF,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,IAAc;IAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAClF,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,EAAE,CAAC,CAAC;gBACzC,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC/D,OAAO;YACT,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrD,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACvD,MAAM,CAAC,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,6BAA6B,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,30 @@
+export { recordWebsite } from './capture.js';
+export { encodeFrames, addFade, concatenateWithTransition, cleanupFrames } from './encoder.js';
+export { getEasing, applyEasing, EASINGS } from './easing.js';
+export { injectCursor, moveCursor, moveCursorToElement, animateClick, hideCursor } from './cursor.js';
+export { executeScenes, createDefaultScenes } from './scenes.js';
+export { addBackgroundMusic, getMediaDuration } from './audio.js';
+export { concatenateVideos, generateIntro, TRANSITIONS } from './concat.js';
+export { convertToSocialFormat, convertToAllFormats, SOCIAL_FORMATS } from './social-format.js';
+export { addTextOverlays } from './text-overlay.js';
+export { generateSpeech, listElevenLabsVoices } from './tts.js';
+export { createNarratedVideo } from './narrated-video.js';
+export { smartScreenshot } from './smart-screenshot.js';
+export type { SmartScreenshotConfig, SmartScreenshotResult, SmartTarget, DetectedFeature } from './smart-screenshot.js';
+export { applyLutPreset, listLutPresets, ALL_LUT_PRESETS, PRESET_DESCRIPTIONS } from './lut-presets.js';
+export type { LutPreset, LutPresetConfig } from './lut-presets.js';
+export { applyVoiceEffect, ALL_VOICE_EFFECTS, VOICE_EFFECT_DESCRIPTIONS } from './voice-effects.js';
+export type { VoiceEffect, VoiceEffectConfig } from './voice-effects.js';
+export { applyChromaKey } from './chroma-key.js';
+export type { ChromaKeyConfig } from './chroma-key.js';
+export { syncToBeats } from './beat-sync.js';
+export type { BeatSyncConfig, BeatSyncResult } from './beat-sync.js';
+export { animateText, ALL_TEXT_ANIMATIONS, TEXT_ANIMATION_DESCRIPTIONS } from './text-animations.js';
+export type { TextAnimation, TextAnimationConfig, TextPosition as AnimTextPosition } from './text-animations.js';
+export { mixAudioTracks } from './audio-mixer.js';
+export type { AudioTrack, AudioMixConfig, AudioMixResult } from './audio-mixer.js';
+export { listTemplates, getTemplate, getTemplateSummaries, getTemplateCategories } from './templates.js';
+export type { VideoTemplate, TemplateCategory, TemplateSlot } from './templates.js';
+export { renderTemplate } from './template-renderer.js';
+export type { RenderTemplateConfig, RenderResult, TemplateAssets } from './template-renderer.js';
+export * from './types.js';

package/dist/tools/engine/index.js

@@ -0,0 +1,23 @@
+export { recordWebsite } from './capture.js';
+export { encodeFrames, addFade, concatenateWithTransition, cleanupFrames } from './encoder.js';
+export { getEasing, applyEasing, EASINGS } from './easing.js';
+export { injectCursor, moveCursor, moveCursorToElement, animateClick, hideCursor } from './cursor.js';
+export { executeScenes, createDefaultScenes } from './scenes.js';
+export { addBackgroundMusic, getMediaDuration } from './audio.js';
+export { concatenateVideos, generateIntro, TRANSITIONS } from './concat.js';
+export { convertToSocialFormat, convertToAllFormats, SOCIAL_FORMATS } from './social-format.js';
+export { addTextOverlays } from './text-overlay.js';
+export { generateSpeech, listElevenLabsVoices } from './tts.js';
+export { createNarratedVideo } from './narrated-video.js';
+export { smartScreenshot } from './smart-screenshot.js';
+// CapCut-tier engines
+export { applyLutPreset, listLutPresets, ALL_LUT_PRESETS, PRESET_DESCRIPTIONS } from './lut-presets.js';
+export { applyVoiceEffect, ALL_VOICE_EFFECTS, VOICE_EFFECT_DESCRIPTIONS } from './voice-effects.js';
+export { applyChromaKey } from './chroma-key.js';
+export { syncToBeats } from './beat-sync.js';
+export { animateText, ALL_TEXT_ANIMATIONS, TEXT_ANIMATION_DESCRIPTIONS } from './text-animations.js';
+export { mixAudioTracks } from './audio-mixer.js';
+export { listTemplates, getTemplate, getTemplateSummaries, getTemplateCategories } from './templates.js';
+export { renderTemplate } from './template-renderer.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/F,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtG,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,sBAAsB;AACtB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAExG,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAEpG,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAErG,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEzG,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,cAAc,YAAY,CAAC"}

package/dist/tools/engine/lut-presets.d.ts

@@ -0,0 +1,25 @@
+/**
+ * LUT Preset Engine — 22 cinematic color grade presets via FFmpeg filter chains.
+ *
+ * No external .cube files needed — each preset is a combination of
+ * colorbalance, eq, curves, colorchannelmixer, and hue filters.
+ * Intensity parameter (0.0-1.0) blends graded output with the original.
+ */
+export type LutPreset = 'cinematic-teal-orange' | 'cinematic-teal-orange-subtle' | 'vintage-film' | 'vintage-kodachrome' | 'cross-process' | 'moody-dark' | 'warm-golden' | 'cold-blue' | 'film-noir' | 'noir-blue-tint' | 'bleach-bypass' | 'cyberpunk-neon' | 'cyberpunk-teal-pink' | 'desaturated-fincher' | 'pastel-dream' | 'matrix-green' | 'sepia' | 'blockbuster-extreme' | 'muted-forest' | 'high-contrast-music' | 'faded-lofi' | 'sunset-magic-hour';
+export interface LutPresetConfig {
+    inputPath: string;
+    outputPath: string;
+    /** The color grade preset to apply */
+    preset: LutPreset;
+    /** Blend intensity: 0.0 (original) to 1.0 (full effect). Default: 1.0 */
+    intensity?: number;
+}
+/** Human-readable descriptions for each preset */
+export declare const PRESET_DESCRIPTIONS: Record<LutPreset, string>;
+export declare const ALL_LUT_PRESETS: LutPreset[];
+export declare function applyLutPreset(config: LutPresetConfig): Promise<string>;
+/** List all available presets with descriptions */
+export declare function listLutPresets(): Array<{
+    name: LutPreset;
+    description: string;
+}>;

package/dist/tools/engine/lut-presets.js

@@ -0,0 +1,141 @@
+/**
+ * LUT Preset Engine — 22 cinematic color grade presets via FFmpeg filter chains.
+ *
+ * No external .cube files needed — each preset is a combination of
+ * colorbalance, eq, curves, colorchannelmixer, and hue filters.
+ * Intensity parameter (0.0-1.0) blends graded output with the original.
+ */
+import { execFile } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../../lib/logger.js';
+// ─── Preset Definitions ─────────────────────────────────────────────
+const PRESET_FILTERS = {
+    'cinematic-teal-orange': "colorbalance=rs=-0.15:gs=-0.05:bs=0.25:rm=0.0:gm=-0.02:bm=0.05:rh=0.15:gh=0.02:bh=-0.2,eq=contrast=1.15:saturation=0.9:gamma=0.95,curves=r='0/0 0.25/0.22 0.5/0.55 0.75/0.80 1/1':b='0/0.05 0.25/0.28 0.5/0.45 0.75/0.70 1/0.9'",
+    'cinematic-teal-orange-subtle': "colorbalance=rs=-0.1:gs=-0.03:bs=0.18:rh=0.12:gh=0.02:bh=-0.15,eq=contrast=1.1:saturation=0.75:brightness=-0.02,curves=preset=medium_contrast",
+    'vintage-film': "curves=r='0/0.11 0.42/0.51 1/0.95':g='0/0 0.50/0.48 1/1':b='0/0.22 0.49/0.44 1/0.8',eq=saturation=0.8:contrast=0.9:gamma=1.1,colorbalance=rs=0.05:gs=0.02:bs=-0.05:rh=0.08:gh=0.05:bh=-0.03",
+    'vintage-kodachrome': "curves=r='0/0 0.15/0.18 0.5/0.58 0.85/0.88 1/1':g='0/0 0.5/0.48 1/0.92':b='0/0.06 0.5/0.44 1/0.85',eq=saturation=1.15:contrast=1.1,colorbalance=rs=0.04:gs=-0.02:bs=0.06:rh=0.06:gh=0.03:bh=-0.08",
+    'cross-process': "curves=r='0/0.2 0.5/0.6 1/0.9':g='0/0 0.5/0.55 1/1':b='0/0.3 0.5/0.4 1/0.8',eq=saturation=1.15:contrast=1.1",
+    'moody-dark': "eq=contrast=1.3:brightness=-0.08:saturation=0.65:gamma=0.85,colorbalance=rs=-0.05:gs=-0.02:bs=0.12:rm=-0.03:gm=-0.02:bm=0.05:rh=0.0:gh=-0.02:bh=0.05,curves=master='0/0 0.15/0.05 0.5/0.42 1/0.95'",
+    'warm-golden': "colorbalance=rs=0.12:gs=0.05:bs=-0.12:rm=0.06:gm=0.03:bm=-0.06:rh=0.1:gh=0.06:bh=-0.1,eq=saturation=1.15:contrast=1.05:brightness=0.03,curves=b='0/0 0.5/0.42 1/0.85'",
+    'cold-blue': "colorbalance=rs=-0.12:gs=-0.03:bs=0.2:rm=-0.06:gm=-0.02:bm=0.1:rh=-0.08:gh=0.0:bh=0.12,eq=saturation=0.7:contrast=1.1:brightness=0.05:gamma=1.1",
+    'film-noir': "colorchannelmixer=.3:.4:.3:0:.3:.4:.3:0:.3:.4:.3:0,eq=contrast=1.5:brightness=-0.05:gamma=0.9,curves=preset=strong_contrast",
+    'noir-blue-tint': "colorchannelmixer=.3:.4:.3:0:.3:.4:.3:0:.35:.45:.35:0,eq=contrast=1.4:brightness=-0.04:gamma=0.9",
+    'bleach-bypass': "eq=contrast=1.4:saturation=0.5:gamma=0.9,curves=preset=strong_contrast,colorbalance=rs=-0.02:gs=-0.02:bs=0.04",
+    'cyberpunk-neon': "eq=contrast=1.25:saturation=1.6:brightness=-0.05:gamma=0.9,colorbalance=rs=-0.1:gs=-0.15:bs=0.2:rm=0.15:gm=-0.1:bm=0.1:rh=0.2:gh=-0.05:bh=0.15,curves=r='0/0 0.3/0.2 0.6/0.7 1/1':b='0/0.05 0.4/0.5 1/1'",
+    'cyberpunk-teal-pink': "colorbalance=rs=-0.15:gs=-0.1:bs=0.25:rm=0.2:gm=-0.12:bm=0.12:rh=0.2:gh=-0.08:bh=0.2,eq=saturation=1.5:contrast=1.3:brightness=-0.06,hue=h=5",
+    'desaturated-fincher': "colorbalance=rs=-0.08:gs=-0.03:bs=0.12:rh=0.08:gh=0.02:bh=-0.1,eq=contrast=1.2:saturation=0.55:brightness=-0.03:gamma=0.92,curves=master='0/0 0.2/0.12 0.5/0.48 0.8/0.82 1/0.95'",
+    'pastel-dream': "eq=contrast=0.8:saturation=0.6:brightness=0.08:gamma=1.2,curves=master='0.0/0.15 0.5/0.55 1/0.9',colorbalance=rs=0.05:gs=0.03:bs=0.06:rh=0.04:gh=0.04:bh=0.02",
+    'matrix-green': "colorchannelmixer=rr=0.3:rg=0.6:rb=0.1:gr=0.1:gg=0.9:gb=0.0:br=0.1:bg=0.4:bb=0.5,eq=contrast=1.2:brightness=-0.03:gamma=0.9,curves=preset=increase_contrast",
+    'sepia': "colorchannelmixer=.393:.769:.189:0:.349:.686:.168:0:.272:.534:.131:0,eq=contrast=1.05:brightness=0.02",
+    'blockbuster-extreme': "colorbalance=rs=-0.2:gs=-0.1:bs=0.35:rm=0.05:gm=-0.03:bm=0.0:rh=0.2:gh=0.05:bh=-0.25,eq=contrast=1.25:saturation=1.1:gamma=0.92,curves=r='0/0 0.25/0.28 0.5/0.58 1/1':b='0/0.08 0.5/0.42 1/0.85'",
+    'muted-forest': "colorbalance=rs=0.03:gs=0.05:bs=-0.05:rm=-0.02:gm=0.04:bm=-0.03:rh=0.02:gh=0.02:bh=-0.04,eq=saturation=0.65:contrast=1.05:gamma=1.05,curves=g='0/0 0.5/0.52 1/0.92':r='0/0 0.5/0.48 1/0.95'",
+    'high-contrast-music': "eq=contrast=1.4:saturation=1.4:brightness=-0.02:gamma=0.85,curves=preset=strong_contrast",
+    'faded-lofi': "curves=master='0/0.08 0.25/0.2 0.75/0.78 1/0.92':r='0/0.05 1/0.95':b='0/0.08 1/0.88',eq=saturation=0.75:contrast=0.95",
+    'sunset-magic-hour': "colorbalance=rs=0.06:gs=-0.02:bs=0.08:rm=0.1:gm=0.04:bm=-0.05:rh=0.15:gh=0.08:bh=-0.12,eq=saturation=1.2:contrast=1.1:brightness=0.02,curves=r='0/0 0.5/0.56 1/1':b='0/0.03 0.5/0.44 1/0.88'",
+};
+/** Human-readable descriptions for each preset */
+export const PRESET_DESCRIPTIONS = {
+    'cinematic-teal-orange': 'Hollywood blockbuster look — teal shadows, orange highlights (Transformers, Mad Max)',
+    'cinematic-teal-orange-subtle': 'Restrained teal-orange for drama/thriller tone',
+    'vintage-film': 'Faded 70s film — lifted blacks, warm cast, slightly desaturated',
+    'vintage-kodachrome': 'Iconic Kodachrome — saturated reds/yellows, slightly cool shadows',
+    'cross-process': 'Vivid, surreal color shifts — the "wrong chemistry" lab look',
+    'moody-dark': 'Crushed blacks, cold undertone — dark drama atmosphere',
+    'warm-golden': 'Sun-kissed warmth — golden hour / magic hour look',
+    'cold-blue': 'Icy blue, desaturated — arctic / winter feel',
+    'film-noir': 'Classic black & white with dramatic contrast and deep blacks',
+    'noir-blue-tint': 'B&W base with subtle cold blue wash',
+    'bleach-bypass': 'High contrast + desaturated + metallic — analog lab technique',
+    'cyberpunk-neon': 'Vivid blues, magentas, teals — oversaturated neon city',
+    'cyberpunk-teal-pink': 'Teal-pink variant cyberpunk — Blade Runner vibes',
+    'desaturated-fincher': 'Muted, controlled palette — David Fincher style (Gone Girl, Seven)',
+    'pastel-dream': 'Soft, lifted, airy — low contrast pastel feel',
+    'matrix-green': 'Green-tinted computer world from The Matrix',
+    'sepia': 'Classic warm sepia tone — antique photograph look',
+    'blockbuster-extreme': 'Aggressive orange & teal for action/superhero films',
+    'muted-forest': 'Desaturated greens and browns — indie film / A24 aesthetic',
+    'high-contrast-music': 'Punchy, vivid, crushed blacks — music video look',
+    'faded-lofi': 'Instagram-style faded shadows with slight color cast',
+    'sunset-magic-hour': 'Deep warm amber highlights, slightly purple shadows',
+};
+export const ALL_LUT_PRESETS = Object.keys(PRESET_FILTERS);
+// ─── 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`;
+}
+// ─── Main Function ──────────────────────────────────────────────────
+export async function applyLutPreset(config) {
+    const { inputPath, outputPath, preset, intensity = 1.0 } = config;
+    assertExists(inputPath, 'Input video');
+    ensureDir(outputPath);
+    const filterChain = PRESET_FILTERS[preset];
+    if (!filterChain) {
+        throw new Error(`Unknown LUT preset: ${preset}. Available: ${ALL_LUT_PRESETS.join(', ')}`);
+    }
+    const clampedIntensity = Math.max(0, Math.min(1, intensity));
+    logger.info(`Applying LUT preset: ${preset} (intensity: ${clampedIntensity})`);
+    let args;
+    if (clampedIntensity >= 0.99) {
+        // Full intensity — no blending needed
+        args = [
+            '-y', '-i', inputPath,
+            '-vf', filterChain,
+            '-c:a', 'copy',
+            '-c:v', 'libx264', '-crf', '18', '-preset', 'medium',
+            '-pix_fmt', 'yuv420p', '-movflags', '+faststart',
+            outputPath,
+        ];
+    }
+    else {
+        // Partial intensity — blend with original using split+blend
+        const origWeight = (1 - clampedIntensity).toFixed(4);
+        const gradedWeight = clampedIntensity.toFixed(4);
+        const filterComplex = [
+            `[0:v]split[original][tograde]`,
+            `[tograde]${filterChain}[graded]`,
+            `[original][graded]blend=all_expr='A*${origWeight}+B*${gradedWeight}'[out]`,
+        ].join(';');
+        args = [
+            '-y', '-i', inputPath,
+            '-filter_complex', filterComplex,
+            '-map', '[out]', '-map', '0:a?',
+            '-c:v', 'libx264', '-crf', '18', '-preset', 'medium',
+            '-pix_fmt', 'yuv420p', '-movflags', '+faststart',
+            outputPath,
+        ];
+    }
+    await runFfmpeg(args);
+    logger.info(`LUT preset applied: ${preset} → ${outputPath} (${fileInfo(outputPath)})`);
+    return outputPath;
+}
+/** List all available presets with descriptions */
+export function listLutPresets() {
+    return ALL_LUT_PRESETS.map(name => ({
+        name,
+        description: PRESET_DESCRIPTIONS[name],
+    }));
+}
+//# sourceMappingURL=lut-presets.js.map

package/dist/tools/engine/lut-presets.js.map

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

package/dist/tools/engine/narrated-video.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Narrated Video Engine
+ * Combines TTS voice generation with website recording
+ * for fully automated explainer videos
+ *
+ * Flow:
+ * 1. Generate speech from script segments
+ * 2. Record website scenes synchronized to speech durations
+ * 3. Merge video + audio into final output
+ */
+import type { TTSProvider, ElevenLabsVoice, ElevenLabsModel, OpenAIVoice, OpenAIModel } from './tts.js';
+import type { Scene, ViewportPreset } from './types.js';
+export interface NarrationSegment {
+    /** Text to speak for this segment */
+    text: string;
+    /** Scene action during this segment */
+    scene: Scene;
+    /** Extra padding time after speech (seconds, default: 0.5) */
+    paddingAfter?: number;
+}
+export interface NarratedVideoConfig {
+    /** URL to record */
+    url: string;
+    /** Narration script segments */
+    segments: NarrationSegment[];
+    /** Output path (without extension) */
+    outputPath: string;
+    /** TTS provider (default: elevenlabs) */
+    provider?: TTSProvider;
+    /** Language (default: en) */
+    language?: string;
+    /** Viewport (default: desktop) */
+    viewport?: ViewportPreset;
+    /** ElevenLabs voice (default: adam) */
+    elevenLabsVoice?: ElevenLabsVoice | string;
+    /** ElevenLabs model */
+    elevenLabsModel?: ElevenLabsModel;
+    /** OpenAI voice */
+    openaiVoice?: OpenAIVoice;
+    /** OpenAI model */
+    openaiModel?: OpenAIModel;
+    /** Speaking speed (default: 1.0) */
+    speed?: number;
+    /** Music volume if background music provided (default: 0.1) */
+    backgroundMusicVolume?: number;
+    /** Background music path (optional) */
+    backgroundMusicPath?: string;
+}
+export interface NarratedVideoResult {
+    success: boolean;
+    video: {
+        path: string;
+        duration: number;
+        sizeMB: string;
+    };
+    audio: {
+        totalSegments: number;
+        totalDuration: number;
+        provider: TTSProvider;
+    };
+    url: string;
+}
+export declare function createNarratedVideo(config: NarratedVideoConfig): Promise<NarratedVideoResult>;

package/dist/tools/engine/narrated-video.js

@@ -0,0 +1,163 @@
+/**
+ * Narrated Video Engine
+ * Combines TTS voice generation with website recording
+ * for fully automated explainer videos
+ *
+ * Flow:
+ * 1. Generate speech from script segments
+ * 2. Record website scenes synchronized to speech durations
+ * 3. Merge video + audio into final output
+ */
+import { execFile } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../../lib/logger.js';
+import { generateSpeech } from './tts.js';
+import { recordWebsite } from './capture.js';
+import { getMediaDuration } from './audio.js';
+// ─── Main Function ──────────────────────────────────────────────────
+export async function createNarratedVideo(config) {
+    const { url, segments, outputPath, provider = 'elevenlabs', language = 'en', viewport = 'desktop', } = config;
+    const tempDir = `/tmp/narrated-video-${Date.now()}`;
+    fs.mkdirSync(tempDir, { recursive: true });
+    try {
+        // ─── Step 1: Generate all speech segments ───────────────────
+        logger.info(`Generating ${segments.length} speech segment(s)...`);
+        const audioPaths = [];
+        const audioDurations = [];
+        for (let i = 0; i < segments.length; i++) {
+            const seg = segments[i];
+            const audioPath = path.join(tempDir, `segment-${String(i).padStart(3, '0')}.mp3`);
+            const ttsResult = await generateSpeech({
+                text: seg.text,
+                outputPath: audioPath,
+                provider,
+                language,
+                elevenLabsVoice: config.elevenLabsVoice,
+                elevenLabsModel: config.elevenLabsModel,
+                openaiVoice: config.openaiVoice,
+                openaiModel: config.openaiModel,
+                speed: config.speed,
+            });
+            audioPaths.push(ttsResult.audioPath);
+            audioDurations.push(ttsResult.duration);
+            logger.info(`Segment ${i + 1}: "${seg.text.slice(0, 50)}..." → ${ttsResult.duration.toFixed(1)}s`);
+        }
+        // ─── Step 2: Concatenate audio segments ─────────────────────
+        logger.info('Concatenating audio segments...');
+        const fullAudioPath = path.join(tempDir, 'full-narration.mp3');
+        await concatenateAudio(audioPaths, fullAudioPath);
+        const totalAudioDuration = await getMediaDuration(fullAudioPath);
+        logger.info(`Total narration: ${totalAudioDuration.toFixed(1)}s`);
+        // ─── Step 3: Build scenes with matched durations ────────────
+        logger.info('Building synchronized scenes...');
+        const scenes = [];
+        for (let i = 0; i < segments.length; i++) {
+            const seg = segments[i];
+            const padding = seg.paddingAfter ?? 0.5;
+            const sceneDuration = audioDurations[i] + padding;
+            // Override scene duration to match audio
+            const scene = { ...seg.scene };
+            if ('duration' in scene) {
+                scene.duration = sceneDuration;
+            }
+            scenes.push(scene);
+        }
+        // ─── Step 4: Record website with synced scenes ──────────────
+        logger.info('Recording website with synchronized scenes...');
+        const videoOnlyPath = path.join(tempDir, 'video-only');
+        const recordResult = await recordWebsite({
+            url,
+            outputPath: videoOnlyPath,
+            viewport,
+            fps: 60,
+            scenes,
+            cursor: { enabled: false },
+            encoding: { codec: 'h264', crf: 18 },
+        });
+        // ─── Step 5: Merge video + audio ────────────────────────────
+        logger.info('Merging video + narration...');
+        const finalPath = outputPath.endsWith('.mp4') ? outputPath : `${outputPath}.mp4`;
+        const outDir = path.dirname(finalPath);
+        if (!fs.existsSync(outDir))
+            fs.mkdirSync(outDir, { recursive: true });
+        const mergeArgs = [
+            '-y',
+            '-i', recordResult.video.path,
+            '-i', fullAudioPath,
+        ];
+        // Optional background music
+        if (config.backgroundMusicPath && fs.existsSync(config.backgroundMusicPath)) {
+            const musicVol = config.backgroundMusicVolume ?? 0.1;
+            mergeArgs.push('-stream_loop', '-1', '-i', config.backgroundMusicPath);
+            // Mix narration + background music
+            mergeArgs.push('-filter_complex', `[1:a]volume=1.0[narration];[2:a]volume=${musicVol},afade=t=in:st=0:d=2[music];[narration][music]amix=inputs=2:duration=first[aout]`, '-map', '0:v', '-map', '[aout]');
+        }
+        else {
+            mergeArgs.push('-map', '0:v', '-map', '1:a');
+        }
+        mergeArgs.push('-c:v', 'copy', '-c:a', 'aac', '-b:a', '192k', '-shortest', '-movflags', '+faststart', finalPath);
+        await runFfmpeg(mergeArgs);
+        const finalStats = fs.statSync(finalPath);
+        const finalDuration = await getMediaDuration(finalPath);
+        // ─── Cleanup ────────────────────────────────────────────────
+        fs.rmSync(tempDir, { recursive: true, force: true });
+        logger.info(`Narrated video ready: ${finalPath} (${finalDuration.toFixed(1)}s, ${(finalStats.size / 1024 / 1024).toFixed(2)} MB)`);
+        return {
+            success: true,
+            video: {
+                path: finalPath,
+                duration: finalDuration,
+                sizeMB: (finalStats.size / 1024 / 1024).toFixed(2),
+            },
+            audio: {
+                totalSegments: segments.length,
+                totalDuration: totalAudioDuration,
+                provider,
+            },
+            url,
+        };
+    }
+    catch (error) {
+        // Cleanup on error
+        try {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+        catch { /* ignore */ }
+        throw error;
+    }
+}
+// ─── Helpers ────────────────────────────────────────────────────────
+/**
+ * Concatenate multiple audio files using ffmpeg concat demuxer
+ */
+async function concatenateAudio(files, outputPath) {
+    // Create concat list file
+    const listPath = outputPath + '.txt';
+    const listContent = files.map((f) => `file '${f}'`).join('\n');
+    fs.writeFileSync(listPath, listContent);
+    await runFfmpeg([
+        '-y',
+        '-f', 'concat',
+        '-safe', '0',
+        '-i', listPath,
+        '-c:a', 'libmp3lame',
+        '-b:a', '192k',
+        outputPath,
+    ]);
+    // Cleanup list file
+    fs.unlinkSync(listPath);
+}
+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=narrated-video.js.map

package/dist/tools/engine/narrated-video.js.map

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