frameyard 0.0.0-stage → 0.2.0

package/dist/renderer/audio.js

@@ -0,0 +1,88 @@
+import { stat } from "node:fs/promises";
+import path from "node:path";
+import { FrameyardError } from "../errors.js";
+import { probeMedia } from "./ffmpeg.js";
+function contains(root, candidate) {
+    return candidate === root || candidate.startsWith(root + path.sep);
+}
+/** Resolves local audio files, probes durations, and reports timeline overruns. */
+export async function inspectTimelineAudio(options) {
+    const compositionDuration = options.durationInFrames / options.fps;
+    const assets = [];
+    const warnings = [];
+    for (const [clipIndex, clip] of options.clips.entries()) {
+        if (options.signal?.aborted) {
+            throw new FrameyardError("RENDER_FAILED", "Operation cancelled.");
+        }
+        const absolutePath = path.resolve(options.projectRoot, clip.src);
+        if (!contains(options.projectRoot, absolutePath)) {
+            throw new FrameyardError("AUDIO_INVALID", `Audio clip ${clipIndex + 1} source escapes the project root: ${clip.src}`);
+        }
+        let fileStat;
+        try {
+            fileStat = await stat(absolutePath);
+        }
+        catch {
+            throw new FrameyardError("ASSET_NOT_FOUND", `Audio clip ${clipIndex + 1} source does not exist: ${clip.src}`);
+        }
+        if (!fileStat.isFile()) {
+            throw new FrameyardError("ASSET_NOT_FOUND", `Audio clip ${clipIndex + 1} source is not a file: ${clip.src}`);
+        }
+        const probe = await probeMedia(absolutePath, { signal: options.signal });
+        if (!probe.streams.some((stream) => stream.codec_type === "audio")) {
+            throw new FrameyardError("AUDIO_INVALID", `Audio clip ${clipIndex + 1} source has no audio stream: ${clip.src}`);
+        }
+        const rawDuration = Number(probe.format?.duration);
+        const streamDuration = Math.max(0, ...probe.streams
+            .filter((stream) => stream.codec_type === "audio")
+            .map((stream) => Number(stream.duration))
+            .filter((value) => Number.isFinite(value)));
+        const sourceDurationSeconds = Number.isFinite(rawDuration) && rawDuration > 0 ? rawDuration : streamDuration;
+        if (!Number.isFinite(sourceDurationSeconds) || sourceDurationSeconds <= 0) {
+            throw new FrameyardError("AUDIO_INVALID", `Audio clip ${clipIndex + 1} source duration could not be determined: ${clip.src}`);
+        }
+        if (clip.trimStart >= sourceDurationSeconds) {
+            warnings.push(`Audio clip ${clipIndex + 1} (${clip.src}) trimStart ${clip.trimStart}s is at or beyond the source duration ${sourceDurationSeconds.toFixed(2)}s.`);
+        }
+        if (clip.trimDuration !== undefined && clip.trimStart + clip.trimDuration > sourceDurationSeconds + 0.001) {
+            warnings.push(`Audio clip ${clipIndex + 1} (${clip.src}) trim range ends at ${(clip.trimStart + clip.trimDuration).toFixed(2)}s, beyond the source duration ${sourceDurationSeconds.toFixed(2)}s.`);
+        }
+        const timelineStartSeconds = clip.startFrame / options.fps;
+        const usedDuration = clip.trimDuration ?? Math.max(0, sourceDurationSeconds - clip.trimStart);
+        const timelineEndSeconds = timelineStartSeconds + usedDuration;
+        if (timelineStartSeconds >= compositionDuration) {
+            warnings.push(`Audio clip ${clipIndex + 1} (${clip.src}) starts at ${timelineStartSeconds.toFixed(2)}s, after the composition ends at ${compositionDuration.toFixed(2)}s.`);
+        }
+        else if (timelineEndSeconds > compositionDuration + 0.001) {
+            warnings.push(`Audio clip ${clipIndex + 1} (${clip.src}) ends at ${timelineEndSeconds.toFixed(2)}s, beyond the composition duration ${compositionDuration.toFixed(2)}s.`);
+        }
+        assets.push({
+            clip,
+            path: absolutePath,
+            sourceDurationSeconds,
+            timelineStartSeconds,
+            timelineEndSeconds,
+        });
+    }
+    return {
+        assets,
+        clips: assets.map((asset) => {
+            const clip = asset.clip;
+            const result = {
+                src: clip.src,
+                startFrame: clip.startFrame,
+                startSeconds: asset.timelineStartSeconds,
+                endSeconds: asset.timelineEndSeconds,
+                sourceDurationSeconds: asset.sourceDurationSeconds,
+                trimStart: clip.trimStart,
+                volume: clip.volume,
+            };
+            if (clip.trimDuration !== undefined) {
+                result.trimDuration = clip.trimDuration;
+            }
+            return result;
+        }),
+        warnings,
+    };
+}
+//# sourceMappingURL=audio.js.map

package/dist/renderer/audio.js.map

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

package/dist/renderer/browser.d.ts

@@ -0,0 +1,22 @@
+import { type Browser } from "playwright";
+import type { CompositionMetadata, Props, ResolvedAudioClip, ResolvedTranscriptClip } from "../contracts.js";
+export interface CompositionSession {
+    readonly metadata: CompositionMetadata;
+    readonly props: Props;
+    readonly audioClips: ResolvedAudioClip[];
+    readonly transcriptClips: ResolvedTranscriptClip[];
+    seek(frame: number): Promise<void>;
+    capture(): Promise<Buffer>;
+    assertHealthy(): void;
+    close(): Promise<void>;
+}
+export declare const BROWSER_ARGS: string[];
+type BrowserContextOptions = Parameters<Browser["newContext"]>[0];
+export declare const BROWSER_CONTEXT_OPTIONS: BrowserContextOptions;
+export declare function openCompositionSession(options: {
+    serverUrl: string;
+    entry: string;
+    props?: unknown;
+}): Promise<CompositionSession>;
+export {};
+//# sourceMappingURL=browser.d.ts.map

package/dist/renderer/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/renderer/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAmD,MAAM,YAAY,CAAC;AACrG,OAAO,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAG7G,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,sBAAsB,EAAE,CAAC;IACnD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,aAAa,IAAI,IAAI,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAkBD,eAAO,MAAM,YAAY,EAAE,MAAM,EAShC,CAAC;AAEF,KAAK,qBAAqB,GAAG,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAElE,eAAO,MAAM,uBAAuB,EAAE,qBAOrC,CAAC;AAiCF,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA4J9B"}

package/dist/renderer/browser.js

@@ -0,0 +1,175 @@
+import { chromium } from "playwright";
+import { FrameyardError, isFrameyardError } from "../errors.js";
+export const BROWSER_ARGS = [
+    "--force-color-profile=srgb",
+    "--disable-lcd-text",
+    "--hide-scrollbars",
+    "--mute-audio",
+    "--disable-background-timer-throttling",
+    "--disable-backgrounding-occluded-windows",
+    "--disable-renderer-backgrounding",
+    "--disable-dev-shm-usage",
+];
+export const BROWSER_CONTEXT_OPTIONS = {
+    viewport: { width: 1280, height: 720 },
+    deviceScaleFactor: 1,
+    colorScheme: "light",
+    reducedMotion: "no-preference",
+    locale: "en-US",
+    timezoneId: "UTC",
+};
+function browserError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return message
+        .replace(/^page\.evaluate: /, "")
+        .replace(/^Error: /, "")
+        .split("\n")
+        .filter((line) => !line.trimStart().startsWith("at "))
+        .join("\n")
+        .trim();
+}
+function browserCommandError(error) {
+    if (isFrameyardError(error)) {
+        return error;
+    }
+    const message = browserError(error);
+    const match = /^\[([A-Z_]+)\]\s*([\s\S]*)$/.exec(message);
+    if (match) {
+        return new FrameyardError(match[1], match[2].trim(), { cause: error });
+    }
+    return new FrameyardError("COMPOSITION_ERROR", message, { cause: error });
+}
+async function closeQuietly(action) {
+    try {
+        await action();
+    }
+    catch {
+        // Cleanup must not hide the original failure.
+    }
+}
+export async function openCompositionSession(options) {
+    let browser;
+    try {
+        browser = await chromium.launch({
+            headless: true,
+            args: BROWSER_ARGS,
+        });
+    }
+    catch (error) {
+        throw new FrameyardError("BROWSER_FAILED", `Chromium could not start. Install the pinned browser with "npx playwright install chromium".\n${browserError(error)}`, { cause: error });
+    }
+    let context;
+    let page;
+    let cdp;
+    try {
+        context = await browser.newContext(BROWSER_CONTEXT_OPTIONS);
+        page = await context.newPage();
+        page.setDefaultTimeout(60_000);
+        const pageErrors = [];
+        page.on("pageerror", (error) => {
+            pageErrors.push(error.message);
+        });
+        page.on("crash", () => {
+            pageErrors.push("The browser page crashed.");
+        });
+        await page.goto(new URL("/__frameyard/?render=1", options.serverUrl).href, {
+            waitUntil: "domcontentloaded",
+            timeout: 60_000,
+        });
+        await page.waitForFunction(() => Boolean(window.__frameyardPreview), undefined, { timeout: 30_000 });
+        let loaded;
+        try {
+            loaded = await page.evaluate(async ({ entry, props }) => {
+                const api = window.__frameyardPreview;
+                return api.load(entry, props);
+            }, { entry: options.entry, props: options.props });
+        }
+        catch (error) {
+            throw browserCommandError(error);
+        }
+        await page.setViewportSize({ width: loaded.metadata.width, height: loaded.metadata.height });
+        try {
+            await page.waitForLoadState("networkidle", { timeout: 30_000 });
+        }
+        catch (error) {
+            throw new FrameyardError("RENDER_FAILED", "Timed out waiting for composition assets and network requests to finish loading.", { cause: error });
+        }
+        await page.evaluate(() => new Promise((resolve) => {
+            requestAnimationFrame(() => requestAnimationFrame(() => resolve()));
+        }));
+        // Loading is complete. Frame production must not depend on new network data.
+        await page.route("**/*", (route) => route.abort("blockedbyclient"));
+        cdp = await context.newCDPSession(page);
+        const activePage = page;
+        const activeCdp = cdp;
+        const assertHealthy = () => {
+            if (pageErrors.length > 0) {
+                throw new FrameyardError("COMPOSITION_ERROR", `Unhandled browser error: ${pageErrors.join("\n")}`);
+            }
+        };
+        assertHealthy();
+        const session = {
+            metadata: loaded.metadata,
+            props: loaded.props,
+            audioClips: loaded.audioClips,
+            transcriptClips: loaded.transcriptClips,
+            async seek(frame) {
+                assertHealthy();
+                try {
+                    await activePage.evaluate((targetFrame) => {
+                        const api = window.__frameyardPreview;
+                        api.seek(targetFrame);
+                    }, frame);
+                }
+                catch (error) {
+                    throw browserCommandError(error);
+                }
+                assertHealthy();
+            },
+            async capture() {
+                assertHealthy();
+                let result;
+                try {
+                    result = (await activeCdp.send("Page.captureScreenshot", {
+                        format: "png",
+                        fromSurface: true,
+                        captureBeyondViewport: false,
+                        // Lossless PNG with fast compression. The default zlib level is the
+                        // dominant cost of a 1080p frame; decoded pixels are identical.
+                        optimizeForSpeed: true,
+                    }));
+                }
+                catch (error) {
+                    if (isFrameyardError(error)) {
+                        throw error;
+                    }
+                    throw new FrameyardError("RENDER_FAILED", `Could not capture a browser frame: ${browserError(error)}`, {
+                        cause: error,
+                    });
+                }
+                assertHealthy();
+                return Buffer.from(result.data, "base64");
+            },
+            assertHealthy,
+            async close() {
+                await closeQuietly(async () => {
+                    await activePage.evaluate(async () => {
+                        const api = window.__frameyardPreview;
+                        await api?.dispose?.();
+                    });
+                });
+                await closeQuietly(async () => cdp?.detach());
+                await closeQuietly(async () => context?.close());
+                await closeQuietly(async () => browser.close());
+            },
+        };
+        return session;
+    }
+    catch (error) {
+        await closeQuietly(async () => cdp?.detach());
+        await closeQuietly(async () => context?.close());
+        await closeQuietly(async () => browser.close());
+        throw error;
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/renderer/browser.js.map

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

package/dist/renderer/ffmpeg.d.ts

@@ -0,0 +1,58 @@
+/** Fails early when the installed FFmpeg cannot produce the required output. */
+export declare function assertFfmpegCapabilities(signal?: AbortSignal): Promise<void>;
+interface ProcessOptions {
+    signal?: AbortSignal;
+}
+export interface ProbeStream {
+    codec_type?: string;
+    codec_name?: string;
+    width?: number;
+    height?: number;
+    channels?: number;
+    sample_rate?: string;
+    duration?: string;
+}
+export interface ProbeResult {
+    streams: ProbeStream[];
+    format?: {
+        duration?: string;
+        format_name?: string;
+    };
+}
+export declare function probeMedia(filePath: string, options?: ProcessOptions): Promise<ProbeResult>;
+export interface MixClip {
+    path: string;
+    startFrame: number;
+    trimStart: number;
+    trimDuration?: number;
+    volume: number;
+}
+/** Normalizes any decodable source to the 16 kHz mono PCM WAV that whisper.cpp expects. */
+export declare function normalizeAudioForTranscription(options: {
+    inputPath: string;
+    outputPath: string;
+    signal?: AbortSignal;
+}): Promise<void>;
+export declare function mixAudioTimeline(options: {
+    clips: MixClip[];
+    fps: number;
+    durationSeconds: number;
+    outputPath: string;
+    signal?: AbortSignal;
+}): Promise<void>;
+export interface VideoEncoder {
+    writeFrame(png: Buffer): Promise<void>;
+    finish(): Promise<void>;
+    abort(): Promise<void>;
+}
+export declare function startVideoEncoder(options: {
+    outputPath: string;
+    durationSeconds: number;
+    /** Exact number of frames that must be written. */
+    frames: number;
+    fps: number;
+    audioPath?: string;
+    signal?: AbortSignal;
+}): Promise<VideoEncoder>;
+export {};
+//# sourceMappingURL=ffmpeg.d.ts.map

package/dist/renderer/ffmpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg.d.ts","sourceRoot":"","sources":["../../src/renderer/ffmpeg.ts"],"names":[],"mappings":"AAwBA,gFAAgF;AAChF,wBAAsB,wBAAwB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAUlF;AAED,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAwED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAWrG;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2FAA2F;AAC3F,wBAAsB,8BAA8B,CAAC,OAAO,EAAE;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DhB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,YAAY,CAAC,CAyKxB"}

package/dist/renderer/ffmpeg.js

@@ -0,0 +1,268 @@
+import { spawn } from "node:child_process";
+import { FrameyardError } from "../errors.js";
+const STDERR_LIMIT = 16 * 1024;
+function captureTail(child) {
+    let tail = "";
+    child.stderr.on("data", (chunk) => {
+        tail += chunk.toString();
+        if (tail.length > STDERR_LIMIT) {
+            tail = tail.slice(-STDERR_LIMIT);
+        }
+    });
+    return () => tail.trim();
+}
+function abortError() {
+    return new FrameyardError("RENDER_FAILED", "Operation cancelled.");
+}
+function formatNumber(value) {
+    return Number.isInteger(value) ? String(value) : value.toFixed(6).replace(/0+$/, "").replace(/\.$/, "");
+}
+/** Fails early when the installed FFmpeg cannot produce the required output. */
+export async function assertFfmpegCapabilities(signal) {
+    const { stdout, stderr } = await runCaptured("ffmpeg", ["-hide_banner", "-encoders"], { signal });
+    const encoders = `${stdout}\n${stderr}`;
+    const missing = ["libx264", "aac"].filter((name) => !new RegExp(`(^|\\s)${name}(\\s|$)`, "m").test(encoders));
+    if (missing.length > 0) {
+        throw new FrameyardError("FFMPEG_FAILED", `FFmpeg is missing required encoder${missing.length === 1 ? "" : "s"}: ${missing.join(", ")}. Install a build with H.264 and AAC support.`);
+    }
+}
+function runCaptured(command, args, options = {}) {
+    return new Promise((resolve, reject) => {
+        if (options.signal?.aborted) {
+            reject(abortError());
+            return;
+        }
+        const child = spawn(command, args, { stdio: ["ignore", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        const onAbort = () => child.kill("SIGKILL");
+        options.signal?.addEventListener("abort", onAbort, { once: true });
+        child.once("error", (error) => {
+            options.signal?.removeEventListener("abort", onAbort);
+            if (options.signal?.aborted) {
+                reject(abortError());
+                return;
+            }
+            if (error.code === "ENOENT") {
+                reject(new FrameyardError(command === "ffmpeg" ? "FFMPEG_FAILED" : "FFPROBE_FAILED", `${command === "ffmpeg" ? "FFmpeg" : "FFprobe"} was not found on PATH. Install FFmpeg and ensure both executables are available.`, { cause: error }));
+                return;
+            }
+            reject(new FrameyardError(command === "ffmpeg" ? "FFMPEG_FAILED" : "FFPROBE_FAILED", `${command} could not start: ${error.message}`, { cause: error }));
+        });
+        child.once("close", (code) => {
+            options.signal?.removeEventListener("abort", onAbort);
+            if (options.signal?.aborted) {
+                reject(abortError());
+                return;
+            }
+            if (code !== 0) {
+                reject(new FrameyardError(command === "ffmpeg" ? "FFMPEG_FAILED" : "FFPROBE_FAILED", `${command} exited with code ${code}${stderr ? `:\n${stderr.trim()}` : "."}`));
+                return;
+            }
+            resolve({ stdout, stderr });
+        });
+    });
+}
+export async function probeMedia(filePath, options = {}) {
+    const { stdout } = await runCaptured("ffprobe", ["-v", "error", "-show_format", "-show_streams", "-of", "json", filePath], options);
+    try {
+        return JSON.parse(stdout);
+    }
+    catch (error) {
+        throw new FrameyardError("FFPROBE_FAILED", `Could not parse ffprobe output for ${filePath}.`, { cause: error });
+    }
+}
+/** Normalizes any decodable source to the 16 kHz mono PCM WAV that whisper.cpp expects. */
+export async function normalizeAudioForTranscription(options) {
+    await runCaptured("ffmpeg", [
+        "-hide_banner",
+        "-loglevel",
+        "error",
+        "-nostdin",
+        "-y",
+        "-i",
+        options.inputPath,
+        "-map",
+        "0:a:0",
+        "-vn",
+        "-ac",
+        "1",
+        "-ar",
+        "16000",
+        "-c:a",
+        "pcm_s16le",
+        options.outputPath,
+    ], { signal: options.signal });
+}
+export async function mixAudioTimeline(options) {
+    if (options.clips.length === 0) {
+        throw new FrameyardError("AUDIO_INVALID", "Cannot mix an empty audio timeline.");
+    }
+    const args = ["-hide_banner", "-loglevel", "error", "-nostdin", "-y"];
+    for (const clip of options.clips) {
+        args.push("-i", clip.path);
+    }
+    const filters = [];
+    const labels = [];
+    options.clips.forEach((clip, index) => {
+        const trim = [`start=${formatNumber(clip.trimStart)}`];
+        if (clip.trimDuration !== undefined) {
+            trim.push(`duration=${formatNumber(clip.trimDuration)}`);
+        }
+        const delayMs = Math.round((clip.startFrame * 1000) / options.fps);
+        const chain = [
+            `atrim=${trim.join(":")}`,
+            "asetpts=PTS-STARTPTS",
+            `volume=${formatNumber(clip.volume)}`,
+            "aresample=48000",
+            "aformat=sample_fmts=fltp:channel_layouts=stereo",
+        ];
+        if (delayMs > 0) {
+            chain.push(`adelay=${delayMs}|${delayMs}`);
+        }
+        const label = options.clips.length === 1 ? "audio" : `clip${index}`;
+        filters.push(`[${index}:a]${chain.join(",")}[${label}]`);
+        if (options.clips.length > 1) {
+            labels.push(`[${label}]`);
+        }
+    });
+    if (options.clips.length > 1) {
+        filters.push(`${labels.join("")}amix=inputs=${options.clips.length}:duration=longest:normalize=0[audio]`);
+    }
+    args.push("-filter_complex", filters.join(";"), "-map", "[audio]", "-t", formatNumber(options.durationSeconds), "-ar", "48000", "-ac", "2", "-c:a", "pcm_s16le", options.outputPath);
+    await runCaptured("ffmpeg", args, { signal: options.signal });
+}
+export async function startVideoEncoder(options) {
+    if (options.signal?.aborted) {
+        throw abortError();
+    }
+    const args = [
+        "-hide_banner",
+        "-loglevel",
+        "error",
+        "-nostdin",
+        "-y",
+        "-f",
+        "image2pipe",
+        "-framerate",
+        formatNumber(options.fps),
+        "-i",
+        "pipe:0",
+    ];
+    if (options.audioPath) {
+        args.push("-i", options.audioPath);
+    }
+    args.push("-map", "0:v:0");
+    if (options.audioPath) {
+        args.push("-map", "1:a:0");
+    }
+    args.push("-c:v", "libx264", "-preset", "medium", "-crf", "20", "-pix_fmt", "yuv420p", "-r", formatNumber(options.fps), "-frames:v", String(options.frames), "-t", formatNumber(options.durationSeconds));
+    if (options.audioPath) {
+        args.push("-c:a", "aac", "-b:a", "192k", "-ar", "48000", "-ac", "2");
+    }
+    args.push("-movflags", "+faststart", options.outputPath);
+    let child;
+    try {
+        child = spawn("ffmpeg", args, { stdio: ["pipe", "pipe", "pipe"] });
+    }
+    catch (error) {
+        throw new FrameyardError("FFMPEG_FAILED", "Could not start FFmpeg.", { cause: error });
+    }
+    const stderrTail = captureTail(child);
+    await new Promise((resolve, reject) => {
+        child.once("spawn", resolve);
+        child.once("error", (error) => {
+            if (error.code === "ENOENT") {
+                reject(new FrameyardError("FFMPEG_FAILED", "FFmpeg was not found on PATH. Install FFmpeg and ensure it is available.", { cause: error }));
+            }
+            else {
+                reject(new FrameyardError("FFMPEG_FAILED", `FFmpeg could not start: ${error.message}`, { cause: error }));
+            }
+        });
+    });
+    const closed = new Promise((resolve) => {
+        child.once("close", (code, signal) => resolve({ code, signal }));
+    });
+    let finished = false;
+    let framesWritten = 0;
+    const onAbort = () => {
+        child.stdin.destroy();
+        child.kill("SIGKILL");
+    };
+    options.signal?.addEventListener("abort", onAbort, { once: true });
+    async function abort() {
+        if (finished) {
+            return;
+        }
+        finished = true;
+        options.signal?.removeEventListener("abort", onAbort);
+        child.stdin.destroy();
+        if (child.exitCode === null && child.signalCode === null) {
+            child.kill("SIGKILL");
+        }
+        await closed.catch(() => undefined);
+    }
+    return {
+        async writeFrame(png) {
+            if (finished) {
+                throw new FrameyardError("FFMPEG_FAILED", "Cannot write a frame after the encoder finished.");
+            }
+            if (options.signal?.aborted) {
+                throw abortError();
+            }
+            await new Promise((resolve, reject) => {
+                const onError = (error) => {
+                    child.stdin.off("error", onError);
+                    if (options.signal?.aborted) {
+                        reject(abortError());
+                    }
+                    else {
+                        reject(new FrameyardError("FFMPEG_FAILED", `FFmpeg stopped while accepting frames: ${error.message}`, {
+                            cause: error,
+                        }));
+                    }
+                };
+                child.stdin.once("error", onError);
+                child.stdin.write(png, (error) => {
+                    child.stdin.off("error", onError);
+                    if (error) {
+                        reject(new FrameyardError("FFMPEG_FAILED", `Could not write a frame to FFmpeg: ${error.message}`, {
+                            cause: error,
+                        }));
+                    }
+                    else {
+                        framesWritten += 1;
+                        resolve();
+                    }
+                });
+            });
+        },
+        async finish() {
+            if (finished) {
+                return;
+            }
+            finished = true;
+            options.signal?.removeEventListener("abort", onAbort);
+            child.stdin.end();
+            const { code, signal } = await closed;
+            if (options.signal?.aborted) {
+                throw abortError();
+            }
+            if (code !== 0) {
+                const detail = stderrTail();
+                throw new FrameyardError("FFMPEG_FAILED", `FFmpeg encoding failed${signal ? ` (${signal})` : code === null ? "" : ` (exit ${code})`}${detail ? `:\n${detail}` : "."}`);
+            }
+            if (framesWritten !== options.frames) {
+                throw new FrameyardError("FFMPEG_FAILED", `FFmpeg encoded ${framesWritten} frames but ${options.frames} were required.`);
+            }
+        },
+        abort,
+    };
+}
+//# sourceMappingURL=ffmpeg.js.map