@studiomeyer/mcp-video 1.0.0

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

@@ -0,0 +1,17 @@
+/**
+ * Scene execution engine — processes scene definitions into frame captures
+ */
+import type { Page } from 'playwright';
+import type { Scene } from './types.js';
+interface FrameCallback {
+    (frameIndex: number): Promise<void>;
+}
+/**
+ * Execute all scenes and capture frames
+ */
+export declare function executeScenes(page: Page, scenes: Scene[], fps: number, captureFrame: FrameCallback, cursorEnabled: boolean): Promise<number>;
+/**
+ * Create default scenes for a simple scroll-through video
+ */
+export declare function createDefaultScenes(scrollDuration?: number): Scene[];
+export {};

package/dist/tools/engine/scenes.js

@@ -0,0 +1,223 @@
+/**
+ * Scene execution engine — processes scene definitions into frame captures
+ */
+import { applyEasing } from './easing.js';
+import { moveCursorToElement, animateClick } from './cursor.js';
+import { logger } from '../../lib/logger.js';
+/**
+ * Execute all scenes and capture frames
+ */
+export async function executeScenes(page, scenes, fps, captureFrame, cursorEnabled) {
+    let totalFramesCaptured = 0;
+    for (let i = 0; i < scenes.length; i++) {
+        const scene = scenes[i];
+        logger.info(`Scene ${i + 1}/${scenes.length}: ${scene.type}`);
+        let framesInScene = 0;
+        switch (scene.type) {
+            case 'scroll':
+                framesInScene = await executeScrollScene(page, scene, fps, async (fi) => {
+                    await captureFrame(totalFramesCaptured + fi);
+                });
+                break;
+            case 'pause':
+                framesInScene = await executePauseScene(page, scene.duration, fps, async (fi) => {
+                    await captureFrame(totalFramesCaptured + fi);
+                });
+                break;
+            case 'hover':
+                framesInScene = await executeHoverScene(page, scene, fps, cursorEnabled, async (fi) => {
+                    await captureFrame(totalFramesCaptured + fi);
+                });
+                break;
+            case 'click':
+                framesInScene = await executeClickScene(page, scene, fps, cursorEnabled, async (fi) => {
+                    await captureFrame(totalFramesCaptured + fi);
+                });
+                break;
+            case 'type':
+                framesInScene = await executeTypeScene(page, scene, fps, async (fi) => {
+                    await captureFrame(totalFramesCaptured + fi);
+                });
+                break;
+            case 'wait':
+                framesInScene = await executeWaitScene(page, scene, fps, async (fi) => {
+                    await captureFrame(totalFramesCaptured + fi);
+                });
+                break;
+        }
+        totalFramesCaptured += framesInScene;
+        logger.debug(`Scene ${i + 1} captured ${framesInScene} frames (total: ${totalFramesCaptured})`);
+    }
+    return totalFramesCaptured;
+}
+/**
+ * Execute a scroll scene — the core of cinema-quality videos
+ */
+async function executeScrollScene(page, scene, fps, captureFrame) {
+    const easingName = scene.easing ?? 'easeInOutCubic';
+    const totalFrames = Math.ceil(scene.duration * fps);
+    // Resolve scroll target
+    const scrollInfo = await page.evaluate((target) => {
+        const docHeight = document.documentElement.scrollHeight;
+        const viewportHeight = window.innerHeight;
+        const currentScroll = window.scrollY;
+        const maxScroll = Math.max(0, docHeight - viewportHeight);
+        if (target === 'bottom')
+            return { from: currentScroll, to: maxScroll };
+        if (target === 'top')
+            return { from: currentScroll, to: 0 };
+        if (typeof target === 'number')
+            return { from: currentScroll, to: Math.min(target, maxScroll) };
+        // CSS selector — scroll to element
+        const el = document.querySelector(target);
+        if (el) {
+            const rect = el.getBoundingClientRect();
+            const targetY = Math.min(currentScroll + rect.top - 100, maxScroll);
+            return { from: currentScroll, to: targetY };
+        }
+        return { from: currentScroll, to: maxScroll };
+    }, scene.to);
+    const scrollDistance = scrollInfo.to - scrollInfo.from;
+    for (let frame = 0; frame <= totalFrames; frame++) {
+        const progress = frame / totalFrames;
+        const easedScroll = scrollInfo.from + applyEasing(progress, scrollDistance, easingName);
+        await page.evaluate((y) => window.scrollTo(0, y), easedScroll);
+        // Small delay to let scroll-triggered animations render
+        await page.waitForTimeout(8);
+        await captureFrame(frame);
+    }
+    return totalFrames + 1;
+}
+/**
+ * Execute a pause scene — captures static frames
+ */
+async function executePauseScene(_page, duration, fps, captureFrame) {
+    const totalFrames = Math.ceil(duration * fps);
+    for (let frame = 0; frame < totalFrames; frame++) {
+        await captureFrame(frame);
+    }
+    return totalFrames;
+}
+/**
+ * Execute a hover scene — move cursor to element and hold
+ */
+async function executeHoverScene(page, scene, fps, cursorEnabled, captureFrame) {
+    let frameCount = 0;
+    // Move cursor to element (animated)
+    if (cursorEnabled && scene.animateCursor !== false) {
+        const moveDuration = 600; // ms
+        const moveFrames = Math.ceil((moveDuration / 1000) * fps);
+        await moveCursorToElement(page, scene.selector, moveDuration, fps);
+        // Capture frames during cursor movement — take snapshots
+        for (let i = 0; i < moveFrames; i++) {
+            await captureFrame(frameCount++);
+        }
+    }
+    else {
+        // Instant hover
+        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 };
+        }, scene.selector);
+        if (pos) {
+            await page.mouse.move(pos.x, pos.y);
+        }
+    }
+    // Hold hover — capture frames
+    const holdFrames = Math.ceil(scene.duration * fps);
+    for (let i = 0; i < holdFrames; i++) {
+        await captureFrame(frameCount++);
+    }
+    return frameCount;
+}
+/**
+ * Execute a click scene
+ */
+async function executeClickScene(page, scene, fps, cursorEnabled, captureFrame) {
+    let frameCount = 0;
+    // Move cursor to element
+    if (cursorEnabled) {
+        const moveFrames = Math.ceil(0.5 * fps);
+        await moveCursorToElement(page, scene.selector, 500, fps);
+        for (let i = 0; i < moveFrames; i++) {
+            await captureFrame(frameCount++);
+        }
+    }
+    // Click animation
+    if (cursorEnabled) {
+        await animateClick(page);
+    }
+    // Actual click
+    await page.click(scene.selector);
+    // Wait for navigation/content
+    if (scene.waitFor === 'networkidle') {
+        await page.waitForLoadState('networkidle').catch(() => { });
+    }
+    else if (scene.waitFor === 'load') {
+        await page.waitForLoadState('load').catch(() => { });
+    }
+    else if (typeof scene.waitFor === 'number') {
+        await page.waitForTimeout(scene.waitFor);
+    }
+    // Pause after click
+    const pauseDuration = scene.pauseAfter ?? 1;
+    const pauseFrames = Math.ceil(pauseDuration * fps);
+    for (let i = 0; i < pauseFrames; i++) {
+        await captureFrame(frameCount++);
+    }
+    return frameCount;
+}
+/**
+ * Execute a type scene
+ */
+async function executeTypeScene(page, scene, fps, captureFrame) {
+    let frameCount = 0;
+    const delay = scene.delay ?? 80;
+    const framesPerKeystroke = Math.max(1, Math.ceil((delay / 1000) * fps));
+    // Focus the input
+    await page.click(scene.selector);
+    await captureFrame(frameCount++);
+    // Type character by character
+    for (const char of scene.text) {
+        await page.keyboard.type(char, { delay: 0 });
+        for (let i = 0; i < framesPerKeystroke; i++) {
+            await captureFrame(frameCount++);
+        }
+    }
+    return frameCount;
+}
+/**
+ * Execute a wait scene — wait for selector, capturing frames
+ */
+async function executeWaitScene(page, scene, fps, captureFrame) {
+    const timeout = scene.timeout ?? 5000;
+    const maxFrames = Math.ceil((timeout / 1000) * fps);
+    let frameCount = 0;
+    const waitPromise = page.waitForSelector(scene.selector, { timeout }).catch(() => null);
+    // Capture frames while waiting
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeout && frameCount < maxFrames) {
+        await captureFrame(frameCount++);
+        await page.waitForTimeout(Math.floor(1000 / fps));
+        // Check if element appeared
+        const found = await page.$(scene.selector);
+        if (found)
+            break;
+    }
+    await waitPromise;
+    return frameCount;
+}
+/**
+ * Create default scenes for a simple scroll-through video
+ */
+export function createDefaultScenes(scrollDuration = 18) {
+    return [
+        { type: 'pause', duration: 1.5 },
+        { type: 'scroll', to: 'bottom', duration: scrollDuration, easing: 'showcase' },
+        { type: 'pause', duration: 2 },
+    ];
+}
+//# sourceMappingURL=scenes.js.map

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

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

package/dist/tools/engine/smart-screenshot.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Smart Screenshot Engine
+ *
+ * Element-aware screenshot system that can target specific page features.
+ * Instead of full-page screenshots, this finds and captures specific UI elements
+ * like chat widgets, booking forms, pricing sections, wizards, etc.
+ *
+ * Usage:
+ *   smartScreenshot({ url: '...', targets: ['chat', 'pricing', 'booking'] })
+ *   smartScreenshot({ url: '...', targets: [{ selector: '.hero-section' }] })
+ *   smartScreenshot({ url: '...', targets: ['all'] }) // auto-detect all features
+ */
+export interface SmartTarget {
+    /** Feature keyword (e.g. "chat", "pricing") or CSS selector (prefixed with .) or "all" for auto-detect */
+    feature: string;
+    /** Optional: custom CSS selector override */
+    selector?: string;
+    /** Optional: custom padding around element */
+    padding?: number;
+    /** Optional: click to reveal before screenshot */
+    revealFirst?: boolean;
+}
+export interface SmartScreenshotConfig {
+    /** URL to screenshot */
+    url: string;
+    /** What to capture - keywords, selectors, or "all" */
+    targets: (string | SmartTarget)[];
+    /** Output directory */
+    outputDir?: string;
+    /** Viewport size */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    /** Device scale factor for retina */
+    deviceScaleFactor?: number;
+    /** Dark mode */
+    darkMode?: boolean;
+    /** Wait time after page load (ms) */
+    waitAfterLoad?: number;
+    /** Also take a full-page screenshot */
+    includeFullPage?: boolean;
+    /** Maximum width for element screenshots (prevents ultra-wide captures) */
+    maxWidth?: number;
+    /** Maximum height for element screenshots */
+    maxHeight?: number;
+}
+export interface DetectedFeature {
+    name: string;
+    pattern: string;
+    selector: string;
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    matchMethod: 'selector' | 'text' | 'aria' | 'custom';
+    confidence: 'high' | 'medium' | 'low';
+}
+export interface SmartScreenshotResult {
+    success: boolean;
+    url: string;
+    screenshots: {
+        feature: string;
+        path: string;
+        bounds: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+        matchMethod: string;
+        confidence: string;
+    }[];
+    detected: DetectedFeature[];
+    fullPage?: string;
+    totalTime: string;
+}
+export declare function smartScreenshot(config: SmartScreenshotConfig): Promise<SmartScreenshotResult>;