@remotion/renderer 4.0.0-offthread.9 → 4.0.0-prefetch.10

package/dist/provide-screenshot.d.ts

@@ -1,11 +1,12 @@
-import puppeteer from 'puppeteer-core';
-import { ImageFormat } from 'remotion';
+/// <reference types="node" />
+import type { Page } from './browser/BrowserPage';
+import type { ImageFormat } from './image-format';
 export declare const provideScreenshot: ({ page, imageFormat, options, quality, }: {
-    page: puppeteer.Page;
+    page: Page;
     imageFormat: ImageFormat;
     quality: number | undefined;
     options: {
         frame: number;
-        output?: string;
+        output: string | null;
     };
 }) => Promise<Buffer>;

package/dist/provide-screenshot.js

@@ -7,7 +7,6 @@ const provideScreenshot = ({ page, imageFormat, options, quality, }) => {
         page,
         opts: {
             path: options.output,
-            selector: '#remotion-canvas',
         },
         imageFormat,
         quality,

package/dist/puppeteer-evaluate.d.ts

@@ -1,4 +1,4 @@
-import { Page } from 'puppeteer-core';
+import type { Page } from './browser/BrowserPage';
 export declare function puppeteerEvaluateWithCatch<ReturnType>({ page, pageFunction, frame, args, }: {
     page: Page;
     pageFunction: Function | string;

package/dist/puppeteer-evaluate.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.puppeteerEvaluateWithCatch = void 0;
-/* eslint-disable no-new */
-const puppeteer_core_1 = require("puppeteer-core");
+const JSHandle_1 = require("./browser/JSHandle");
 const symbolicateable_error_1 = require("./error-handling/symbolicateable-error");
 const parse_browser_error_stack_1 = require("./parse-browser-error-stack");
 const EVALUATION_SCRIPT_URL = '__puppeteer_evaluation_script__';
@@ -33,7 +32,7 @@ function isString(obj) {
 async function puppeteerEvaluateWithCatch({ page, pageFunction, frame, args, }) {
     var _a, _b, _c, _d, _e, _f, _g;
     const contextId = (await page.mainFrame().executionContext())._contextId;
-    const client = page._client;
+    const client = page._client();
     const suffix = `//# sourceURL=${EVALUATION_SCRIPT_URL}`;
     if (isString(pageFunction)) {
         const expression = pageFunction;
@@ -140,7 +139,7 @@ function convertArgument(arg) {
         return { unserializableValue: '-Infinity' };
     if (Object.is(arg, NaN))
         return { unserializableValue: 'NaN' };
-    const objectHandle = arg && arg instanceof puppeteer_core_1.JSHandle ? arg : null;
+    const objectHandle = arg && arg instanceof JSHandle_1.JSHandle ? arg : null;
     if (objectHandle) {
         if (objectHandle._disposed)
             throw new Error('JSHandle is disposed!');

package/dist/puppeteer-screenshot.d.ts

@@ -1,3 +1,4 @@
 /// <reference types="node" />
-import { Page, ScreenshotOptions } from 'puppeteer-core';
-export declare const screenshot: (page: Page, options?: ScreenshotOptions) => Promise<Buffer | string | void>;
+import type { Page } from './browser/BrowserPage';
+import type { ScreenshotOptions } from './browser/ScreenshotOptions';
+export declare const screenshot: (page: Page, options: ScreenshotOptions) => Promise<Buffer | string | void>;

package/dist/puppeteer-screenshot.js

@@ -26,7 +26,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.screenshot = void 0;
 const assert = __importStar(require("assert"));
 const screenshot_task_1 = require("./screenshot-task");
-const screenshot = (page, options = {}) => {
+const screenshot = (page, options) => {
     let screenshotType = null;
     // options.type takes precedence over inferring the type from options.path
     // because it may be a 0-length file with no extension created beforehand
@@ -58,7 +58,6 @@ const screenshot = (page, options = {}) => {
         assert.ok(options.quality >= 0 && options.quality <= 100, 'Expected options.quality to be between 0 and 100 (inclusive), got ' +
             options.quality);
     }
-    assert.ok(!options.clip || !options.fullPage, 'options.clip and options.fullPage are exclusive');
     if (options.clip) {
         assert.ok(typeof options.clip.x === 'number', 'Expected options.clip.x to be a number but found ' +
             typeof options.clip.x);
@@ -71,7 +70,6 @@ const screenshot = (page, options = {}) => {
         assert.ok(options.clip.width !== 0, 'Expected options.clip.width not to be 0.');
         assert.ok(options.clip.height !== 0, 'Expected options.clip.height not to be 0.');
     }
-    // @ts-expect-error
-    return page._screenshotTaskQueue.postTask(() => (0, screenshot_task_1._screenshotTask)(page, screenshotType, options));
+    return page.screenshotTaskQueue.postTask(() => (0, screenshot_task_1._screenshotTask)(page, screenshotType, options));
 };
 exports.screenshot = screenshot;

package/dist/quality.d.ts

@@ -0,0 +1 @@
+export declare const validateQuality: (q: number | undefined) => void;

package/dist/quality.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateQuality = void 0;
+const validateQuality = (q) => {
+    if (typeof q !== 'undefined' && typeof q !== 'number') {
+        throw new Error(`Quality option must be a number or undefined. Got ${typeof q} (${JSON.stringify(q)})`);
+    }
+    if (typeof q === 'undefined') {
+        return;
+    }
+    if (!Number.isFinite(q)) {
+        throw new RangeError(`Quality must be a finite number, but is ${q}`);
+    }
+    if (Number.isNaN(q)) {
+        throw new RangeError(`Quality is NaN, but must be a real number`);
+    }
+    if (q > 100 || q < 0) {
+        throw new RangeError('Quality option must be between 0 and 100.');
+    }
+};
+exports.validateQuality = validateQuality;

package/dist/render-frames.d.ts

@@ -1,12 +1,17 @@
 /// <reference types="node" />
-import { Browser as PuppeteerBrowser } from 'puppeteer-core';
-import { BrowserExecutable, FfmpegExecutable, FrameRange, ImageFormat, SmallTCompMetadata } from 'remotion';
-import { RenderMediaOnDownload } from './assets/download-and-map-assets-to-file';
-import { BrowserLog } from './browser-log';
-import { ServeUrlOrWebpackBundle } from './legacy-webpack-config';
-import { CancelSignal } from './make-cancel-signal';
-import { ChromiumOptions } from './open-browser';
-import { OnStartData, RenderFramesOutput } from './types';
+import type { SmallTCompMetadata } from 'remotion';
+import type { RenderMediaOnDownload } from './assets/download-and-map-assets-to-file';
+import type { DownloadMap } from './assets/download-map';
+import type { BrowserExecutable } from './browser-executable';
+import type { BrowserLog } from './browser-log';
+import type { Browser } from './browser/Browser';
+import type { FfmpegExecutable } from './ffmpeg-executable';
+import type { FrameRange } from './frame-range';
+import type { ImageFormat } from './image-format';
+import type { ServeUrlOrWebpackBundle } from './legacy-webpack-config';
+import type { CancelSignal } from './make-cancel-signal';
+import type { ChromiumOptions } from './open-browser';
+import type { OnStartData, RenderFramesOutput } from './types';
 declare type ConfigOrComposition = {
     /**
      * @deprecated This field has been renamed to `composition`
@@ -25,8 +30,9 @@ declare type RenderFramesOptions = {
     parallelism?: number | null;
     quality?: number;
     frameRange?: FrameRange | null;
+    everyNthFrame?: number;
     dumpBrowserLogs?: boolean;
-    puppeteerInstance?: PuppeteerBrowser;
+    puppeteerInstance?: Browser;
     browserExecutable?: BrowserExecutable;
     onBrowserLog?: (log: BrowserLog) => void;
     onFrameBuffer?: (buffer: Buffer, frame: number) => void;
@@ -35,8 +41,14 @@ declare type RenderFramesOptions = {
     chromiumOptions?: ChromiumOptions;
     scale?: number;
     ffmpegExecutable?: FfmpegExecutable;
+    ffprobeExecutable?: FfmpegExecutable;
     port?: number | null;
     cancelSignal?: CancelSignal;
+    /**
+     * @deprecated Only for Remotion internal usage
+     */
+    downloadMap?: DownloadMap;
+    muted?: boolean;
 } & ConfigOrComposition & ServeUrlOrWebpackBundle;
 export declare const renderFrames: (options: RenderFramesOptions) => Promise<RenderFramesOutput>;
 export {};

package/dist/render-frames.js

@@ -8,21 +8,27 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const remotion_1 = require("remotion");
 const download_and_map_assets_to_file_1 = require("./assets/download-and-map-assets-to-file");
+const download_map_1 = require("./assets/download-map");
+const browser_1 = require("./browser");
+const compress_assets_1 = require("./compress-assets");
 const cycle_browser_tabs_1 = require("./cycle-browser-tabs");
 const handle_javascript_exception_1 = require("./error-handling/handle-javascript-exception");
 const get_concurrency_1 = require("./get-concurrency");
 const get_duration_from_frame_range_1 = require("./get-duration-from-frame-range");
+const get_frame_padded_index_1 = require("./get-frame-padded-index");
 const get_frame_to_render_1 = require("./get-frame-to-render");
 const image_format_1 = require("./image-format");
 const legacy_webpack_config_1 = require("./legacy-webpack-config");
-const make_assets_download_dir_1 = require("./make-assets-download-dir");
 const open_browser_1 = require("./open-browser");
+const perf_1 = require("./perf");
 const pool_1 = require("./pool");
 const prepare_server_1 = require("./prepare-server");
 const provide_screenshot_1 = require("./provide-screenshot");
 const puppeteer_evaluate_1 = require("./puppeteer-evaluate");
+const quality_1 = require("./quality");
 const seek_to_frame_1 = require("./seek-to-frame");
 const set_props_and_env_1 = require("./set-props-and-env");
+const truthy_1 = require("./truthy");
 const validate_scale_1 = require("./validate-scale");
 const getComposition = (others) => {
     if ('composition' in others) {
@@ -38,7 +44,7 @@ const getPool = async (pages) => {
     const pool = new pool_1.Pool(puppeteerPages);
     return pool;
 };
-const innerRenderFrames = ({ onFrameUpdate, outputDir, onStart, inputProps, quality, imageFormat = image_format_1.DEFAULT_IMAGE_FORMAT, frameRange, puppeteerInstance, onError, envVariables, onBrowserLog, onFrameBuffer, onDownload, pagesArray, serveUrl, composition, timeoutInMilliseconds, scale, actualParallelism, downloadDir, proxyPort, cancelSignal, }) => {
+const innerRenderFrames = ({ onFrameUpdate, outputDir, onStart, inputProps, quality, imageFormat = image_format_1.DEFAULT_IMAGE_FORMAT, frameRange, puppeteerInstance, onError, envVariables, onBrowserLog, onFrameBuffer, onDownload, pagesArray, serveUrl, composition, timeoutInMilliseconds, scale, actualParallelism, everyNthFrame = 1, proxyPort, cancelSignal, downloadMap, muted, }) => {
     if (!puppeteerInstance) {
         throw new Error('no puppeteer instance passed to innerRenderFrames - internal error');
     }
@@ -49,8 +55,10 @@ const innerRenderFrames = ({ onFrameUpdate, outputDir, onStart, inputProps, qual
             });
         }
     }
+    const downloadPromises = [];
     const realFrameRange = (0, get_frame_to_render_1.getRealFrameRange)(composition.durationInFrames, frameRange !== null && frameRange !== void 0 ? frameRange : null);
-    const frameCount = (0, get_duration_from_frame_range_1.getDurationFromFrameRange)(realFrameRange, composition.durationInFrames);
+    const framesToRender = (0, get_duration_from_frame_range_1.getFramesToRender)(realFrameRange, everyNthFrame);
+    const lastFrame = framesToRender[framesToRender.length - 1];
     const pages = new Array(actualParallelism).fill(true).map(async () => {
         const page = await puppeteerInstance.newPage();
         pagesArray.push(page);
@@ -62,18 +70,14 @@ const innerRenderFrames = ({ onFrameUpdate, outputDir, onStart, inputProps, qual
         const logCallback = (log) => {
             onBrowserLog === null || onBrowserLog === void 0 ? void 0 : onBrowserLog({
                 stackTrace: log.stackTrace(),
-                text: log.text(),
-                type: log.type(),
+                text: log.text,
+                type: log.type,
             });
         };
         if (onBrowserLog) {
             page.on('console', logCallback);
         }
-        const initialFrame = typeof frameRange === 'number'
-            ? frameRange
-            : frameRange === null || frameRange === undefined
-                ? 0
-                : frameRange[0];
+        const initialFrame = realFrameRange[0];
         await (0, set_props_and_env_1.setPropsAndEnv)({
             inputProps,
             envVariables,
@@ -83,46 +87,60 @@ const innerRenderFrames = ({ onFrameUpdate, outputDir, onStart, inputProps, qual
             timeoutInMilliseconds,
             proxyPort,
             retriesRemaining: 2,
+            audioEnabled: !muted,
+            videoEnabled: imageFormat !== 'none',
         });
         await (0, puppeteer_evaluate_1.puppeteerEvaluateWithCatch)({
-            pageFunction: (id) => {
+            // eslint-disable-next-line max-params
+            pageFunction: (id, defaultProps, durationInFrames, fps, height, width) => {
                 window.setBundleMode({
                     type: 'composition',
                     compositionName: id,
+                    compositionDefaultProps: defaultProps,
+                    compositionDurationInFrames: durationInFrames,
+                    compositionFps: fps,
+                    compositionHeight: height,
+                    compositionWidth: width,
                 });
             },
-            args: [composition.id],
+            args: [
+                composition.id,
+                composition.defaultProps,
+                composition.durationInFrames,
+                composition.fps,
+                composition.height,
+                composition.width,
+            ],
             frame: null,
             page,
         });
         page.off('console', logCallback);
         return page;
     });
-    const [firstFrameIndex, lastFrameIndex] = realFrameRange;
-    // Substract one because 100 frames will be 00-99
-    // --> 2 digits
-    const filePadLength = String(lastFrameIndex).length;
+    // If rendering a GIF and skipping frames, we must ensure it starts from 0
+    // and then is consecutive so FFMPEG recognizes the sequence
+    const countType = everyNthFrame === 1 ? 'actual-frames' : 'from-zero';
+    const filePadLength = (0, get_frame_padded_index_1.getFilePadLength)({
+        lastFrame,
+        totalFrames: framesToRender.length,
+        countType,
+    });
     let framesRendered = 0;
     const poolPromise = getPool(pages);
     onStart({
-        frameCount,
+        frameCount: framesToRender.length,
     });
-    const assets = new Array(frameCount).fill(undefined);
+    const assets = new Array(framesToRender.length).fill(undefined);
     let stopped = false;
     cancelSignal === null || cancelSignal === void 0 ? void 0 : cancelSignal(() => {
         stopped = true;
     });
-    const progress = Promise.all(new Array(frameCount)
-        .fill(Boolean)
-        .map((_x, i) => i)
-        .map(async (index) => {
-        const frame = realFrameRange[0] + index;
+    const progress = Promise.all(framesToRender.map(async (frame, index) => {
         const pool = await poolPromise;
         const freePage = await pool.acquire();
         if (stopped) {
             throw new Error('Render was stopped');
         }
-        const paddedIndex = String(frame).padStart(filePadLength, '0');
         const errorCallbackOnFrame = (err) => {
             onError(err);
         };
@@ -135,24 +153,31 @@ const innerRenderFrames = ({ onFrameUpdate, outputDir, onStart, inputProps, qual
         await (0, seek_to_frame_1.seekToFrame)({ frame, page: freePage });
         if (imageFormat !== 'none') {
             if (onFrameBuffer) {
-                const id = remotion_1.Internals.perf.startPerfMeasure('save');
+                const id = (0, perf_1.startPerfMeasure)('save');
                 const buffer = await (0, provide_screenshot_1.provideScreenshot)({
                     page: freePage,
                     imageFormat,
                     quality,
                     options: {
                         frame,
-                        output: undefined,
+                        output: null,
                     },
                 });
-                remotion_1.Internals.perf.stopPerfMeasure(id);
+                (0, perf_1.stopPerfMeasure)(id);
                 onFrameBuffer(buffer, frame);
             }
             else {
                 if (!outputDir) {
                     throw new Error('Called renderFrames() without specifying either `outputDir` or `onFrameBuffer`');
                 }
-                const output = path_1.default.join(outputDir, `element-${paddedIndex}.${imageFormat}`);
+                const output = path_1.default.join(outputDir, (0, get_frame_padded_index_1.getFrameOutputFileName)({
+                    frame,
+                    imageFormat,
+                    index,
+                    countType,
+                    lastFrame,
+                    totalFrames: framesToRender.length,
+                }));
                 await (0, provide_screenshot_1.provideScreenshot)({
                     page: freePage,
                     imageFormat,
@@ -172,13 +197,13 @@ const innerRenderFrames = ({ onFrameUpdate, outputDir, onStart, inputProps, qual
             frame,
             page: freePage,
         });
-        const compressedAssets = collectedAssets.map((asset) => remotion_1.Internals.AssetCompression.compressAsset(assets.filter(remotion_1.Internals.truthy).flat(1), asset));
+        const compressedAssets = collectedAssets.map((asset) => (0, compress_assets_1.compressAsset)(assets.filter(truthy_1.truthy).flat(1), asset));
         assets[index] = compressedAssets;
         compressedAssets.forEach((asset) => {
             (0, download_and_map_assets_to_file_1.downloadAndMapAssetsToFileUrl)({
                 asset,
-                downloadDir,
                 onDownload,
+                downloadMap,
             }).catch((err) => {
                 onError(new Error(`Error while downloading asset: ${err.stack}`));
             });
@@ -194,88 +219,91 @@ const innerRenderFrames = ({ onFrameUpdate, outputDir, onStart, inputProps, qual
         const returnValue = {
             assetsInfo: {
                 assets,
-                downloadDir,
-                firstFrameIndex,
                 imageSequenceName: `element-%0${filePadLength}d.${imageFormat}`,
+                firstFrameIndex: framesToRender[0],
+                downloadMap,
             },
-            frameCount,
+            frameCount: framesToRender.length,
         };
         return returnValue;
     });
-    return Promise.race([
-        happyPath,
-        new Promise((_resolve, reject) => {
-            cancelSignal === null || cancelSignal === void 0 ? void 0 : cancelSignal(() => {
-                reject(new Error('renderFrames() got cancelled'));
-            });
-        }),
-    ]);
+    return happyPath
+        .then(() => {
+        return Promise.all(downloadPromises);
+    })
+        .then(() => happyPath);
 };
 const renderFrames = (options) => {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     const composition = getComposition(options);
     if (!composition) {
         throw new Error('No `composition` option has been specified for renderFrames()');
     }
     remotion_1.Internals.validateDimension(composition.height, 'height', 'in the `config` object passed to `renderFrames()`');
     remotion_1.Internals.validateDimension(composition.width, 'width', 'in the `config` object passed to `renderFrames()`');
-    remotion_1.Internals.validateFps(composition.fps, 'in the `config` object of `renderFrames()`');
+    remotion_1.Internals.validateFps(composition.fps, 'in the `config` object of `renderFrames()`', false);
     remotion_1.Internals.validateDurationInFrames(composition.durationInFrames, 'in the `config` object passed to `renderFrames()`');
     if (options.quality !== undefined && options.imageFormat !== 'jpeg') {
         throw new Error("You can only pass the `quality` option if `imageFormat` is 'jpeg'.");
     }
     const selectedServeUrl = (0, legacy_webpack_config_1.getServeUrlWithFallback)(options);
-    remotion_1.Internals.validateQuality(options.quality);
+    (0, quality_1.validateQuality)(options.quality);
     (0, validate_scale_1.validateScale)(options.scale);
-    const browserInstance = (_a = options.puppeteerInstance) !== null && _a !== void 0 ? _a : (0, open_browser_1.openBrowser)(remotion_1.Internals.DEFAULT_BROWSER, {
+    const browserInstance = (_a = options.puppeteerInstance) !== null && _a !== void 0 ? _a : (0, open_browser_1.openBrowser)(browser_1.DEFAULT_BROWSER, {
         shouldDumpIo: options.dumpBrowserLogs,
         browserExecutable: options.browserExecutable,
         chromiumOptions: options.chromiumOptions,
         forceDeviceScaleFactor: (_b = options.scale) !== null && _b !== void 0 ? _b : 1,
     });
-    const downloadDir = (0, make_assets_download_dir_1.makeAssetsDownloadTmpDir)();
-    const onDownload = (_c = options.onDownload) !== null && _c !== void 0 ? _c : (() => () => undefined);
-    const actualParallelism = (0, get_concurrency_1.getActualConcurrency)((_d = options.parallelism) !== null && _d !== void 0 ? _d : null);
+    const downloadMap = (_c = options.downloadMap) !== null && _c !== void 0 ? _c : (0, download_map_1.makeDownloadMap)();
+    const onDownload = (_d = options.onDownload) !== null && _d !== void 0 ? _d : (() => () => undefined);
+    const actualParallelism = (0, get_concurrency_1.getActualConcurrency)((_e = options.parallelism) !== null && _e !== void 0 ? _e : null);
     const openedPages = [];
     return new Promise((resolve, reject) => {
-        var _a, _b;
+        var _a, _b, _c;
         const cleanup = [];
-        const onError = (err) => reject(err);
-        Promise.all([
-            (0, prepare_server_1.prepareServer)({
-                webpackConfigOrServeUrl: selectedServeUrl,
-                downloadDir,
-                onDownload,
-                onError,
-                ffmpegExecutable: (_a = options.ffmpegExecutable) !== null && _a !== void 0 ? _a : null,
-                port: (_b = options.port) !== null && _b !== void 0 ? _b : null,
+        const onError = (err) => {
+            reject(err);
+        };
+        Promise.race([
+            new Promise((_, rej) => {
+                var _a;
+                (_a = options.cancelSignal) === null || _a === void 0 ? void 0 : _a.call(options, () => {
+                    rej(new Error('renderFrames() got cancelled'));
+                });
+            }),
+            Promise.all([
+                (0, prepare_server_1.prepareServer)({
+                    webpackConfigOrServeUrl: selectedServeUrl,
+                    onDownload,
+                    onError,
+                    ffmpegExecutable: (_a = options.ffmpegExecutable) !== null && _a !== void 0 ? _a : null,
+                    ffprobeExecutable: (_b = options.ffprobeExecutable) !== null && _b !== void 0 ? _b : null,
+                    port: (_c = options.port) !== null && _c !== void 0 ? _c : null,
+                    downloadMap,
+                }),
+                browserInstance,
+            ]).then(([{ serveUrl, closeServer, offthreadPort }, puppeteerInstance]) => {
+                const { stopCycling } = (0, cycle_browser_tabs_1.cycleBrowserTabs)(puppeteerInstance, actualParallelism);
+                cleanup.push(stopCycling);
+                cleanup.push(closeServer);
+                return innerRenderFrames({
+                    ...options,
+                    puppeteerInstance,
+                    onError,
+                    pagesArray: openedPages,
+                    serveUrl,
+                    composition,
+                    actualParallelism,
+                    onDownload,
+                    proxyPort: offthreadPort,
+                    downloadMap,
+                });
             }),
-            browserInstance,
         ])
-            .then(([{ serveUrl, closeServer, offthreadPort }, puppeteerInstance]) => {
-            var _a;
-            const { stopCycling } = (0, cycle_browser_tabs_1.cycleBrowserTabs)(puppeteerInstance, actualParallelism);
-            cleanup.push(stopCycling);
-            (_a = options.cancelSignal) === null || _a === void 0 ? void 0 : _a.call(options, () => {
-                stopCycling();
-                closeServer();
-            });
-            cleanup.push(closeServer);
-            const renderFramesProm = innerRenderFrames({
-                ...options,
-                puppeteerInstance,
-                onError,
-                pagesArray: openedPages,
-                serveUrl,
-                composition,
-                actualParallelism,
-                onDownload,
-                downloadDir,
-                proxyPort: offthreadPort,
-            });
-            return renderFramesProm;
+            .then((res) => {
+            return resolve(res);
         })
-            .then((res) => resolve(res))
             .catch((err) => reject(err))
             .finally(() => {
             // If browser instance was passed in, we close all the pages
@@ -298,6 +326,7 @@ const renderFrames = (options) => {
             cleanup.forEach((c) => {
                 c();
             });
+            // Don't clear download dir because it might be used by stitchFramesToVideo
         });
     });
 };

package/dist/render-media.d.ts

@@ -1,11 +1,19 @@
-import type { Browser as PuppeteerBrowser } from 'puppeteer-core';
-import { BrowserExecutable, Codec, FfmpegExecutable, FrameRange, PixelFormat, ProResProfile, SmallTCompMetadata } from 'remotion';
-import { RenderMediaOnDownload } from './assets/download-and-map-assets-to-file';
-import { BrowserLog } from './browser-log';
-import { ServeUrlOrWebpackBundle } from './legacy-webpack-config';
-import { CancelSignal } from './make-cancel-signal';
-import { ChromiumOptions } from './open-browser';
-import { OnStartData } from './types';
+/// <reference types="node" />
+import type { SmallTCompMetadata } from 'remotion';
+import type { RenderMediaOnDownload } from './assets/download-and-map-assets-to-file';
+import type { DownloadMap } from './assets/download-map';
+import type { BrowserExecutable } from './browser-executable';
+import type { BrowserLog } from './browser-log';
+import type { Browser as PuppeteerBrowser } from './browser/Browser';
+import type { Codec } from './codec';
+import type { FfmpegExecutable } from './ffmpeg-executable';
+import type { FrameRange } from './frame-range';
+import type { ServeUrlOrWebpackBundle } from './legacy-webpack-config';
+import type { CancelSignal } from './make-cancel-signal';
+import type { ChromiumOptions } from './open-browser';
+import type { PixelFormat } from './pixel-format';
+import type { ProResProfile } from './prores-profile';
+import type { OnStartData } from './types';
 export declare type StitchingState = 'encoding' | 'muxing';
 export declare type RenderMediaOnProgress = (progress: {
     renderedFrames: number;
@@ -15,7 +23,7 @@ export declare type RenderMediaOnProgress = (progress: {
     stitchStage: StitchingState;
 }) => void;
 export declare type RenderMediaOptions = {
-    outputLocation: string;
+    outputLocation?: string | null;
     codec: Codec;
     composition: SmallTCompMetadata;
     inputProps?: unknown;
@@ -23,10 +31,13 @@ export declare type RenderMediaOptions = {
     crf?: number | null;
     imageFormat?: 'png' | 'jpeg' | 'none';
     ffmpegExecutable?: FfmpegExecutable;
+    ffprobeExecutable?: FfmpegExecutable;
     pixelFormat?: PixelFormat;
     envVariables?: Record<string, string>;
     quality?: number;
     frameRange?: FrameRange | null;
+    everyNthFrame?: number;
+    numberOfGifLoops?: number | null;
     puppeteerInstance?: PuppeteerBrowser;
     overwrite?: boolean;
     onProgress?: RenderMediaOnProgress;
@@ -41,5 +52,17 @@ export declare type RenderMediaOptions = {
     port?: number | null;
     cancelSignal?: CancelSignal;
     browserExecutable?: BrowserExecutable;
+    verbose?: boolean;
+    /**
+     * @deprecated Only for Remotion internal usage
+     */
+    downloadMap?: DownloadMap;
+    muted?: boolean;
+    enforceAudioTrack?: boolean;
 } & ServeUrlOrWebpackBundle;
-export declare const renderMedia: ({ parallelism, proResProfile, crf, composition, imageFormat, ffmpegExecutable, inputProps, pixelFormat, codec, envVariables, quality, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, dumpBrowserLogs, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, ...options }: RenderMediaOptions) => Promise<void>;
+/**
+ *
+ * @description Render a video from a composition
+ * @link https://www.remotion.dev/docs/renderer/render-media
+ */
+export declare const renderMedia: ({ parallelism, proResProfile, crf, composition, ffmpegExecutable, ffprobeExecutable, inputProps, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, dumpBrowserLogs, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ...options }: RenderMediaOptions) => Promise<Buffer | null>;