@remotion/renderer 4.0.0-alpha.4 → 4.0.0-alpha10

package/dist/select-composition.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectComposition = void 0;
+const download_map_1 = require("./assets/download-map");
+const handle_javascript_exception_1 = require("./error-handling/handle-javascript-exception");
+const find_closest_package_json_1 = require("./find-closest-package-json");
+const get_browser_instance_1 = require("./get-browser-instance");
+const prepare_server_1 = require("./prepare-server");
+const puppeteer_evaluate_1 = require("./puppeteer-evaluate");
+const seek_to_frame_1 = require("./seek-to-frame");
+const set_props_and_env_1 = require("./set-props-and-env");
+const validate_puppeteer_timeout_1 = require("./validate-puppeteer-timeout");
+const innerSelectComposition = async ({ page, onBrowserLog, inputProps, envVariables, serveUrl, timeoutInMilliseconds, port, id, }) => {
+    if (onBrowserLog) {
+        page.on('console', (log) => {
+            onBrowserLog === null || onBrowserLog === void 0 ? void 0 : onBrowserLog({
+                stackTrace: log.stackTrace(),
+                text: log.text,
+                type: log.type,
+            });
+        });
+    }
+    (0, validate_puppeteer_timeout_1.validatePuppeteerTimeout)(timeoutInMilliseconds);
+    await (0, set_props_and_env_1.setPropsAndEnv)({
+        inputProps: inputProps !== null && inputProps !== void 0 ? inputProps : {},
+        envVariables,
+        page,
+        serveUrl,
+        initialFrame: 0,
+        timeoutInMilliseconds,
+        proxyPort: port,
+        retriesRemaining: 2,
+        audioEnabled: false,
+        videoEnabled: false,
+    });
+    await (0, puppeteer_evaluate_1.puppeteerEvaluateWithCatch)({
+        page,
+        pageFunction: () => {
+            window.setBundleMode({
+                type: 'evaluation',
+            });
+        },
+        frame: null,
+        args: [],
+    });
+    await (0, seek_to_frame_1.waitForReady)(page);
+    const result = await (0, puppeteer_evaluate_1.puppeteerEvaluateWithCatch)({
+        pageFunction: (_id) => {
+            return window.calculateComposition(_id);
+        },
+        frame: null,
+        page,
+        args: [id],
+    });
+    return result;
+};
+/**
+ * @description Gets a composition defined in a Remotion project based on a Webpack bundle.
+ * @see [Documentation](https://www.remotion.dev/docs/renderer/select-composition)
+ */
+const selectComposition = async (options) => {
+    const { puppeteerInstance, browserExecutable, chromiumOptions, downloadMap: passedDownloadMap, serveUrl: serveUrlOrWebpackUrl, verbose, indent, port, } = options;
+    const downloadMap = passedDownloadMap !== null && passedDownloadMap !== void 0 ? passedDownloadMap : (0, download_map_1.makeDownloadMap)();
+    const { page, cleanup } = await (0, get_browser_instance_1.getPageAndCleanupFn)({
+        passedInInstance: puppeteerInstance,
+        browserExecutable: browserExecutable !== null && browserExecutable !== void 0 ? browserExecutable : null,
+        chromiumOptions: chromiumOptions !== null && chromiumOptions !== void 0 ? chromiumOptions : {},
+    });
+    return new Promise((resolve, reject) => {
+        const onError = (err) => reject(err);
+        const cleanupPageError = (0, handle_javascript_exception_1.handleJavascriptException)({
+            page,
+            frame: null,
+            onError,
+        });
+        let close = null;
+        (0, prepare_server_1.prepareServer)({
+            webpackConfigOrServeUrl: serveUrlOrWebpackUrl,
+            onDownload: () => undefined,
+            onError,
+            port: port !== null && port !== void 0 ? port : null,
+            downloadMap,
+            remotionRoot: (0, find_closest_package_json_1.findRemotionRoot)(),
+            concurrency: 1,
+            verbose: verbose !== null && verbose !== void 0 ? verbose : false,
+            indent: indent !== null && indent !== void 0 ? indent : false,
+        })
+            .then(({ serveUrl, closeServer, offthreadPort }) => {
+            close = closeServer;
+            return innerSelectComposition({
+                ...options,
+                serveUrl,
+                page,
+                port: offthreadPort,
+            });
+        })
+            .then((comp) => {
+            if (close) {
+                return Promise.all([comp, close(true)]);
+            }
+            return Promise.resolve([comp, null]);
+        })
+            .then(([comp]) => {
+            return resolve(comp);
+        })
+            .catch((err) => {
+            reject(err);
+        })
+            .finally(() => {
+            cleanup();
+            cleanupPageError();
+            // Clean download map if it was not passed in
+            if (!passedDownloadMap) {
+                (0, download_map_1.cleanDownloadMap)(downloadMap);
+            }
+        });
+    });
+};
+exports.selectComposition = selectComposition;

package/dist/serve-handler/index.d.ts

@@ -1,4 +1,4 @@
-import type { IncomingMessage, ServerResponse } from 'http';
+import type { IncomingMessage, ServerResponse } from 'node:http';
 export declare const serveHandler: (request: IncomingMessage, response: ServerResponse, config: {
     public: string;
 }) => Promise<void>;

package/dist/serve-handler/index.js

@@ -4,15 +4,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.serveHandler = void 0;
-const fs_1 = require("fs");
-const path_1 = __importDefault(require("path"));
-const url_1 = __importDefault(require("url"));
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const node_url_1 = __importDefault(require("node:url"));
 const mime_types_1 = require("../mime-types");
 // Packages
 const is_path_inside_1 = require("./is-path-inside");
 const range_parser_1 = require("./range-parser");
 const getHeaders = (absolutePath, stats) => {
-    const { base } = path_1.default.parse(absolutePath);
+    const { base } = node_path_1.default.parse(absolutePath);
     let defaultHeaders = {};
     if (stats) {
         defaultHeaders = {
@@ -28,19 +28,19 @@ const getHeaders = (absolutePath, stats) => {
     return defaultHeaders;
 };
 const getPossiblePaths = (relativePath, extension) => [
-    path_1.default.join(relativePath, `index${extension}`),
+    node_path_1.default.join(relativePath, `index${extension}`),
     relativePath.endsWith('/')
         ? relativePath.replace(/\/$/g, extension)
         : relativePath + extension,
-].filter((item) => path_1.default.basename(item) !== extension);
+].filter((item) => node_path_1.default.basename(item) !== extension);
 const findRelated = async (current, relativePath) => {
     const possible = getPossiblePaths(relativePath, '.html');
     let stats = null;
     for (let index = 0; index < possible.length; index++) {
         const related = possible[index];
-        const absolutePath = path_1.default.join(current, related);
+        const absolutePath = node_path_1.default.join(current, related);
         try {
-            stats = await fs_1.promises.lstat(absolutePath);
+            stats = await node_fs_1.promises.lstat(absolutePath);
         }
         catch (err) {
             if (err.code !== 'ENOENT' &&
@@ -59,10 +59,11 @@ const findRelated = async (current, relativePath) => {
 };
 const sendError = (absolutePath, response, spec) => {
     const { message, statusCode } = spec;
-    response.statusCode = statusCode;
     const headers = getHeaders(absolutePath, null);
-    response.writeHead(statusCode, headers);
-    response.setHeader('content-type', 'application/json');
+    response.writeHead(statusCode, {
+        ...headers,
+        'Content-Type': 'application/json',
+    });
     response.end(JSON.stringify({ statusCode, message }));
 };
 const internalError = (absolutePath, response) => {
@@ -74,10 +75,10 @@ const internalError = (absolutePath, response) => {
 };
 const serveHandler = async (request, response, config) => {
     const cwd = process.cwd();
-    const current = path_1.default.resolve(cwd, config.public);
+    const current = node_path_1.default.resolve(cwd, config.public);
     let relativePath = null;
     try {
-        relativePath = decodeURIComponent(url_1.default.parse(request.url).pathname);
+        relativePath = decodeURIComponent(node_url_1.default.parse(request.url).pathname);
     }
     catch (err) {
         return sendError('/', response, {
@@ -86,7 +87,7 @@ const serveHandler = async (request, response, config) => {
             message: 'Bad Request',
         });
     }
-    let absolutePath = path_1.default.join(current, relativePath);
+    let absolutePath = node_path_1.default.join(current, relativePath);
     // Prevent path traversal vulnerabilities. We could do this
     // by ourselves, but using the package covers all the edge cases.
     if (!(0, is_path_inside_1.isPathInside)(absolutePath, current)) {
@@ -108,9 +109,9 @@ const serveHandler = async (request, response, config) => {
     // directory exists requires loading all the file paths and then checking if
     // one of them includes the path of the directory. As that's a very
     // performance-expensive thing to do, we need to ensure it's not happening if not really necessary.
-    if (path_1.default.extname(relativePath) !== '') {
+    if (node_path_1.default.extname(relativePath) !== '') {
         try {
-            stats = await fs_1.promises.lstat(absolutePath);
+            stats = await node_fs_1.promises.lstat(absolutePath);
         }
         catch (err) {
             if (err.code !== 'ENOENT' &&
@@ -123,7 +124,8 @@ const serveHandler = async (request, response, config) => {
         try {
             const related = await findRelated(current, relativePath);
             if (related) {
-                ({ stats, absolutePath } = related);
+                stats = related.stats;
+                absolutePath = related.absolutePath;
             }
         }
         catch (err) {
@@ -133,7 +135,7 @@ const serveHandler = async (request, response, config) => {
             }
         }
         try {
-            stats = await fs_1.promises.lstat(absolutePath);
+            stats = await node_fs_1.promises.lstat(absolutePath);
         }
         catch (err) {
             if (err.code !== 'ENOENT' &&
@@ -188,7 +190,7 @@ const serveHandler = async (request, response, config) => {
     }
     let stream = null;
     try {
-        stream = (0, fs_1.createReadStream)(absolutePath, streamOpts !== null && streamOpts !== void 0 ? streamOpts : {});
+        stream = (0, node_fs_1.createReadStream)(absolutePath, streamOpts !== null && streamOpts !== void 0 ? streamOpts : {});
     }
     catch (err) {
         return internalError(absolutePath, response);

package/dist/serve-handler/is-path-inside.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isPathInside = void 0;
-const path_1 = __importDefault(require("path"));
+const node_path_1 = __importDefault(require("node:path"));
 const isPathInside = function (thePath, potentialParent) {
     // For inside-directory checking, we want to allow trailing slashes, so normalize.
     thePath = stripTrailingSep(thePath);
@@ -15,12 +15,12 @@ const isPathInside = function (thePath, potentialParent) {
         potentialParent = potentialParent.toLowerCase();
     }
     return (thePath.lastIndexOf(potentialParent, 0) === 0 &&
-        (thePath[potentialParent.length] === path_1.default.sep ||
+        (thePath[potentialParent.length] === node_path_1.default.sep ||
             thePath[potentialParent.length] === undefined));
 };
 exports.isPathInside = isPathInside;
 function stripTrailingSep(thePath) {
-    if (thePath[thePath.length - 1] === path_1.default.sep) {
+    if (thePath[thePath.length - 1] === node_path_1.default.sep) {
         return thePath.slice(0, -1);
     }
     return thePath;

package/dist/serve-static.d.ts

@@ -1,14 +1,17 @@
 import type { RenderMediaOnDownload } from './assets/download-and-map-assets-to-file';
 import type { DownloadMap } from './assets/download-map';
-import type { FfmpegExecutable } from './ffmpeg-executable';
+import type { Compositor } from './compositor/compositor';
 export declare const serveStatic: (path: string | null, options: {
     port: number | null;
-    ffmpegExecutable: FfmpegExecutable;
-    ffprobeExecutable: FfmpegExecutable;
     onDownload: RenderMediaOnDownload;
     onError: (err: Error) => void;
     downloadMap: DownloadMap;
+    remotionRoot: string;
+    concurrency: number;
+    verbose: boolean;
+    indent: boolean;
 }) => Promise<{
     port: number;
     close: () => Promise<void>;
+    compositor: Compositor;
 }>;

package/dist/serve-static.js

@@ -4,63 +4,104 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.serveStatic = void 0;
-const http_1 = __importDefault(require("http"));
+const node_http_1 = __importDefault(require("node:http"));
 const get_port_1 = require("./get-port");
 const offthread_video_server_1 = require("./offthread-video-server");
 const serve_handler_1 = require("./serve-handler");
 const serveStatic = async (path, options) => {
-    var _a;
-    const port = await (0, get_port_1.getDesiredPort)((_a = options === null || options === void 0 ? void 0 : options.port) !== null && _a !== void 0 ? _a : undefined, 3000, 3100);
-    const offthreadRequest = (0, offthread_video_server_1.startOffthreadVideoServer)({
-        ffmpegExecutable: options.ffmpegExecutable,
-        ffprobeExecutable: options.ffprobeExecutable,
+    const { listener: offthreadRequest, close: closeCompositor, compositor, } = (0, offthread_video_server_1.startOffthreadVideoServer)({
         onDownload: options.onDownload,
         onError: options.onError,
         downloadMap: options.downloadMap,
+        concurrency: options.concurrency,
+        verbose: options.verbose,
+        indent: options.indent,
     });
-    try {
-        const server = http_1.default
-            .createServer((request, response) => {
-            var _a;
-            if ((_a = request.url) === null || _a === void 0 ? void 0 : _a.startsWith('/proxy')) {
-                return offthreadRequest(request, response);
-            }
-            if (path === null) {
-                response.writeHead(404);
-                response.end('Server only supports /proxy');
-                return;
+    const connections = {};
+    const server = node_http_1.default.createServer((request, response) => {
+        var _a;
+        if ((_a = request.url) === null || _a === void 0 ? void 0 : _a.startsWith('/proxy')) {
+            return offthreadRequest(request, response);
+        }
+        if (path === null) {
+            response.writeHead(404);
+            response.end('Server only supports /proxy');
+            return;
+        }
+        (0, serve_handler_1.serveHandler)(request, response, {
+            public: path,
+        }).catch(() => {
+            if (!response.headersSent) {
+                response.writeHead(500);
             }
-            (0, serve_handler_1.serveHandler)(request, response, {
-                public: path,
-            }).catch(() => {
-                response.statusCode = 500;
-                response.end('Error serving file');
-            });
-        })
-            .listen(port);
-        const close = () => {
-            return new Promise((resolve, reject) => {
-                server.close((err) => {
-                    if (err) {
-                        if (err.code === 'ERR_SERVER_NOT_RUNNING') {
-                            return resolve();
-                        }
+            response.end('Error serving file');
+        });
+    });
+    server.on('connection', (conn) => {
+        const key = conn.remoteAddress + ':' + conn.remotePort;
+        connections[key] = conn;
+        conn.on('close', () => {
+            delete connections[key];
+        });
+    });
+    let selectedPort = null;
+    const maxTries = 5;
+    for (let i = 0; i < maxTries; i++) {
+        try {
+            selectedPort = await new Promise((resolve, reject) => {
+                var _a;
+                (0, get_port_1.getDesiredPort)((_a = options === null || options === void 0 ? void 0 : options.port) !== null && _a !== void 0 ? _a : undefined, 3000, 3100)
+                    .then(({ port, didUsePort }) => {
+                    server.listen(port);
+                    server.on('listening', () => {
+                        resolve(port);
+                        return didUsePort();
+                    });
+                    server.on('error', (err) => {
                         reject(err);
-                    }
-                    else {
-                        resolve();
-                    }
-                });
+                    });
+                })
+                    .catch((err) => reject(err));
             });
-        };
-        return { port, close };
-    }
-    catch (err) {
-        console.log({ err, msg: err.message });
-        if (err.message.includes('EADDRINUSE')) {
-            return (0, exports.serveStatic)(path, options);
+            const destroyConnections = function () {
+                for (const key in connections)
+                    connections[key].destroy();
+            };
+            const close = async () => {
+                await Promise.all([
+                    closeCompositor(),
+                    new Promise((resolve, reject) => {
+                        destroyConnections();
+                        server.close((err) => {
+                            if (err) {
+                                if (err.code ===
+                                    'ERR_SERVER_NOT_RUNNING') {
+                                    return resolve();
+                                }
+                                reject(err);
+                            }
+                            else {
+                                resolve();
+                            }
+                        });
+                    }),
+                ]);
+            };
+            return { port: selectedPort, close, compositor };
+        }
+        catch (err) {
+            if (!(err instanceof Error)) {
+                throw err;
+            }
+            const codedError = err;
+            if (codedError.code === 'EADDRINUSE') {
+                // Already in use, try another port
+            }
+            else {
+                throw err;
+            }
         }
-        throw err;
     }
+    throw new Error(`Tried ${maxTries} times to find a free port. Giving up.`);
 };
 exports.serveStatic = serveStatic;

package/dist/set-props-and-env.d.ts

@@ -1,6 +1,6 @@
 import type { Page } from './browser/BrowserPage';
-export declare const setPropsAndEnv: ({ inputProps, envVariables, page, serveUrl, initialFrame, timeoutInMilliseconds, proxyPort, retriesRemaining, }: {
-    inputProps: unknown;
+declare type SetPropsAndEnv = {
+    inputProps: Record<string, unknown>;
     envVariables: Record<string, string> | undefined;
     page: Page;
     serveUrl: string;
@@ -8,4 +8,8 @@ export declare const setPropsAndEnv: ({ inputProps, envVariables, page, serveUrl
     timeoutInMilliseconds: number | undefined;
     proxyPort: number;
     retriesRemaining: number;
-}) => Promise<void>;
+    audioEnabled: boolean;
+    videoEnabled: boolean;
+};
+export declare const setPropsAndEnv: (params: SetPropsAndEnv) => Promise<unknown>;
+export {};

package/dist/set-props-and-env.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setPropsAndEnv = void 0;
+const version_1 = require("remotion/version");
 const TimeoutSettings_1 = require("./browser/TimeoutSettings");
 const normalize_serve_url_1 = require("./normalize-serve-url");
 const puppeteer_evaluate_1 = require("./puppeteer-evaluate");
+const redirect_status_codes_1 = require("./redirect-status-codes");
 const validate_puppeteer_timeout_1 = require("./validate-puppeteer-timeout");
-const setPropsAndEnv = async ({ inputProps, envVariables, page, serveUrl, initialFrame, timeoutInMilliseconds, proxyPort, retriesRemaining, }) => {
+const innerSetPropsAndEnv = async ({ inputProps, envVariables, page, serveUrl, initialFrame, timeoutInMilliseconds, proxyPort, retriesRemaining, audioEnabled, videoEnabled, }) => {
     (0, validate_puppeteer_timeout_1.validatePuppeteerTimeout)(timeoutInMilliseconds);
     const actualTimeout = timeoutInMilliseconds !== null && timeoutInMilliseconds !== void 0 ? timeoutInMilliseconds : TimeoutSettings_1.DEFAULT_TIMEOUT;
     page.setDefaultTimeout(actualTimeout);
@@ -13,23 +15,32 @@ const setPropsAndEnv = async ({ inputProps, envVariables, page, serveUrl, initia
     const urlToVisit = (0, normalize_serve_url_1.normalizeServeUrl)(serveUrl);
     await page.evaluateOnNewDocument((timeout) => {
         window.remotion_puppeteerTimeout = timeout;
-    }, [actualTimeout]);
+    }, actualTimeout);
+    if (typeof inputProps === 'string') {
+        throw new Error('Input props should be an object, not a string.');
+    }
     if (inputProps) {
         await page.evaluateOnNewDocument((input) => {
             window.remotion_inputProps = input;
-        }, [JSON.stringify(inputProps)]);
+        }, JSON.stringify(inputProps));
     }
     if (envVariables) {
         await page.evaluateOnNewDocument((input) => {
             window.remotion_envVariables = input;
-        }, [JSON.stringify(envVariables)]);
+        }, JSON.stringify(envVariables));
     }
     await page.evaluateOnNewDocument((key) => {
         window.remotion_initialFrame = key;
-    }, [initialFrame]);
+    }, initialFrame);
     await page.evaluateOnNewDocument((port) => {
         window.remotion_proxyPort = port;
-    }, [proxyPort]);
+    }, proxyPort);
+    await page.evaluateOnNewDocument((enabled) => {
+        window.remotion_audioEnabled = enabled;
+    }, audioEnabled);
+    await page.evaluateOnNewDocument((enabled) => {
+        window.remotion_videoEnabled = enabled;
+    }, videoEnabled);
     const pageRes = await page.goto(urlToVisit);
     if (pageRes === null) {
         throw new Error(`Visited "${urlToVisit}" but got no response.`);
@@ -43,7 +54,7 @@ const setPropsAndEnv = async ({ inputProps, envVariables, page, serveUrl, initia
                 resolve();
             }, 2000);
         });
-        return (0, exports.setPropsAndEnv)({
+        return innerSetPropsAndEnv({
             envVariables,
             initialFrame,
             inputProps,
@@ -52,15 +63,11 @@ const setPropsAndEnv = async ({ inputProps, envVariables, page, serveUrl, initia
             retriesRemaining: retriesRemaining - 1,
             serveUrl,
             timeoutInMilliseconds,
+            audioEnabled,
+            videoEnabled,
         });
     }
-    if (status !== 200 &&
-        status !== 301 &&
-        status !== 302 &&
-        status !== 303 &&
-        status !== 304 &&
-        status !== 307 &&
-        status !== 308) {
+    if (!redirect_status_codes_1.redirectStatusCodes.every((code) => code !== status)) {
         throw new Error(`Error while getting compositions: Tried to go to ${urlToVisit} but the status code was ${status} instead of 200. Does the site you specified exist?`);
     }
     const isRemotionFn = await (0, puppeteer_evaluate_1.puppeteerEvaluateWithCatch)({
@@ -82,8 +89,35 @@ const setPropsAndEnv = async ({ inputProps, envVariables, page, serveUrl, initia
         frame: null,
         page,
     });
-    if (siteVersion !== '3') {
-        throw new Error(`Incompatible site: When visiting ${urlToVisit}, a bundle was found, but one that is not compatible with this version of Remotion. The bundle format changed in version 3.0.11. To resolve this error, please bundle and deploy again.`);
+    const remotionVersion = await (0, puppeteer_evaluate_1.puppeteerEvaluateWithCatch)({
+        pageFunction: () => {
+            return window.remotion_version;
+        },
+        args: [],
+        frame: null,
+        page,
+    });
+    const requiredVersion = '5';
+    if (siteVersion !== requiredVersion) {
+        throw new Error(`Incompatible site: When visiting ${urlToVisit}, a bundle was found, but one that is not compatible with this version of Remotion. Found version: ${siteVersion} - Required version: ${requiredVersion}. To resolve this error, please bundle and deploy again.`);
+    }
+    if (remotionVersion !== version_1.VERSION && process.env.NODE_ENV !== 'test') {
+        if (remotionVersion) {
+            console.warn(`The site was bundled with version ${remotionVersion} of @remotion/bundler, while @remotion/renderer is on version ${version_1.VERSION}. You may not have the newest bugfixes and features. Re-bundle the site to fix this issue.`);
+        }
+        else {
+            console.warn(`The site was bundled with an old version of Remotion, while @remotion/renderer is on version ${version_1.VERSION}. You may not have the newest bugfixes and features. Re-bundle the site to fix this issue.`);
+        }
     }
 };
+const setPropsAndEnv = (params) => {
+    return Promise.race([
+        innerSetPropsAndEnv(params),
+        new Promise((_, reject) => {
+            setTimeout(() => {
+                reject(new Error('Timed out while setting up the headless browser - the browser seems to not respond. This error is thrown to trigger a retry.'));
+            }, 10000);
+        }),
+    ]);
+};
 exports.setPropsAndEnv = setPropsAndEnv;

package/dist/stitch-frames-to-video.d.ts

@@ -1,13 +1,16 @@
 /// <reference types="node" />
 import type { RenderMediaOnDownload } from './assets/download-and-map-assets-to-file';
 import type { RenderAssetInfo } from './assets/download-map';
+import type { AudioCodec } from './audio-codec';
 import type { Codec } from './codec';
-import type { FfmpegExecutable } from './ffmpeg-executable';
-import type { ImageFormat } from './image-format';
+import type { FfmpegOverrideFn } from './ffmpeg-override';
+import type { VideoImageFormat } from './image-format';
 import type { CancelSignal } from './make-cancel-signal';
 import type { PixelFormat } from './pixel-format';
 import type { ProResProfile } from './prores-profile';
 export declare type StitcherOptions = {
+    audioBitrate?: string | null;
+    videoBitrate?: string | null;
     fps: number;
     width: number;
     height: number;
@@ -17,24 +20,26 @@ export declare type StitcherOptions = {
     pixelFormat?: PixelFormat;
     numberOfGifLoops?: number | null;
     codec?: Codec;
+    audioCodec?: AudioCodec | null;
     crf?: number | null;
     onProgress?: (progress: number) => void;
     onDownload?: RenderMediaOnDownload;
     proResProfile?: ProResProfile;
     verbose?: boolean;
-    ffmpegExecutable?: FfmpegExecutable;
-    ffprobeExecutable?: FfmpegExecutable;
     dir?: string;
     cancelSignal?: CancelSignal;
     internalOptions?: {
         preEncodedFileLocation: string | null;
-        imageFormat: ImageFormat;
+        imageFormat: VideoImageFormat;
+        preferLossless: boolean;
+        indent: boolean;
     };
+    muted?: boolean;
+    enforceAudioTrack?: boolean;
+    ffmpegOverride?: FfmpegOverrideFn;
 };
-declare type ReturnType = {
-    task: Promise<Buffer | null>;
-    getLogs: () => string;
-};
-export declare const spawnFfmpeg: (options: StitcherOptions) => Promise<ReturnType>;
+/**
+ * @description Takes a series of images and audio information generated by renderFrames() and encodes it to a video.
+ * @see [Documentation](https://www.remotion.dev/docs/renderer/stitch-frames-to-video)
+ */
 export declare const stitchFramesToVideo: (options: StitcherOptions) => Promise<Buffer | null>;
-export {};