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

package/dist/render-media.js

@@ -10,6 +10,7 @@ const path_1 = __importDefault(require("path"));
 const remotion_1 = require("remotion");
 const download_map_1 = require("./assets/download-map");
 const can_use_parallel_encoding_1 = require("./can-use-parallel-encoding");
+const codec_supports_media_1 = require("./codec-supports-media");
 const crf_1 = require("./crf");
 const delete_directory_1 = require("./delete-directory");
 const ensure_frames_in_order_1 = require("./ensure-frames-in-order");
@@ -18,36 +19,62 @@ const get_duration_from_frame_range_1 = require("./get-duration-from-frame-range
 const get_extension_from_codec_1 = require("./get-extension-from-codec");
 const get_extension_of_filename_1 = require("./get-extension-of-filename");
 const get_frame_to_render_1 = require("./get-frame-to-render");
-const legacy_webpack_config_1 = require("./legacy-webpack-config");
+const image_format_1 = require("./image-format");
+const is_audio_codec_1 = require("./is-audio-codec");
+const jpeg_quality_1 = require("./jpeg-quality");
 const make_cancel_signal_1 = require("./make-cancel-signal");
 const overwrite_1 = require("./overwrite");
 const perf_1 = require("./perf");
+const pixel_format_1 = require("./pixel-format");
 const prespawn_ffmpeg_1 = require("./prespawn-ffmpeg");
 const prestitcher_memory_usage_1 = require("./prestitcher-memory-usage");
-const quality_1 = require("./quality");
+const prores_profile_1 = require("./prores-profile");
 const render_frames_1 = require("./render-frames");
 const stitch_frames_to_video_1 = require("./stitch-frames-to-video");
 const validate_even_dimensions_with_codec_1 = require("./validate-even-dimensions-with-codec");
+const validate_every_nth_frame_1 = require("./validate-every-nth-frame");
+const validate_ffmpeg_override_1 = require("./validate-ffmpeg-override");
+const validate_number_of_gif_loops_1 = require("./validate-number-of-gif-loops");
 const validate_output_filename_1 = require("./validate-output-filename");
 const validate_scale_1 = require("./validate-scale");
+const validate_videobitrate_1 = require("./validate-videobitrate");
+const SLOWEST_FRAME_COUNT = 10;
 /**
  *
  * @description Render a video from a composition
- * @link https://www.remotion.dev/docs/renderer/render-media
+ * @see [Documentation](https://www.remotion.dev/docs/renderer/render-media)
  */
-const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat, ffmpegExecutable, ffprobeExecutable, inputProps, pixelFormat, codec, envVariables, quality, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, dumpBrowserLogs, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, ...options }) => {
-    var _a, _b, _c;
-    (0, quality_1.validateQuality)(quality);
-    if (typeof crf !== 'undefined' && crf !== null) {
-        (0, crf_1.validateSelectedCrfAndCodecCombination)(crf, codec);
+const renderMedia = ({ proResProfile, crf, composition, inputProps, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, dumpBrowserLogs, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, audioCodec, ...options }) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    if (options.quality) {
+        throw new Error(`The "quality" option has been renamed. Please use "jpegQuality" instead.`);
     }
+    (0, jpeg_quality_1.validateJpegQuality)(options.jpegQuality);
+    (0, crf_1.validateQualitySettings)({ crf, codec, videoBitrate });
+    (0, validate_videobitrate_1.validateBitrate)(audioBitrate, 'audioBitrate');
+    (0, validate_videobitrate_1.validateBitrate)(videoBitrate, 'videoBitrate');
+    (0, prores_profile_1.validateSelectedCodecAndProResCombination)({
+        codec,
+        proResProfile,
+    });
+    (0, pixel_format_1.validateSelectedPixelFormatAndCodecCombination)(pixelFormat, codec);
     if (outputLocation) {
-        (0, validate_output_filename_1.validateOutputFilename)(codec, (0, get_extension_of_filename_1.getExtensionOfFilename)(outputLocation));
+        (0, validate_output_filename_1.validateOutputFilename)({
+            codec,
+            audioCodec: audioCodec !== null && audioCodec !== void 0 ? audioCodec : null,
+            extension: (0, get_extension_of_filename_1.getExtensionOfFilename)(outputLocation),
+            preferLossless: (_a = options.preferLossless) !== null && _a !== void 0 ? _a : false,
+        });
     }
+    const absoluteOutputLocation = outputLocation
+        ? path_1.default.resolve(process.cwd(), outputLocation)
+        : null;
     (0, validate_scale_1.validateScale)(scale);
-    const everyNthFrame = (_a = options.everyNthFrame) !== null && _a !== void 0 ? _a : 1;
-    const numberOfGifLoops = (_b = options.numberOfGifLoops) !== null && _b !== void 0 ? _b : null;
-    const serveUrl = (0, legacy_webpack_config_1.getServeUrlWithFallback)(options);
+    (0, validate_ffmpeg_override_1.validateFfmpegOverride)(ffmpegOverride);
+    const everyNthFrame = (_b = options.everyNthFrame) !== null && _b !== void 0 ? _b : 1;
+    (0, validate_every_nth_frame_1.validateEveryNthFrame)(everyNthFrame, codec);
+    const numberOfGifLoops = (_c = options.numberOfGifLoops) !== null && _c !== void 0 ? _c : null;
+    (0, validate_number_of_gif_loops_1.validateNumberOfGifLoops)(numberOfGifLoops, codec);
     let stitchStage = 'encoding';
     let stitcherFfmpeg;
     let preStitcher = null;
@@ -57,29 +84,40 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
     let encodedDoneIn = null;
     let cancelled = false;
     const renderStart = Date.now();
-    const downloadMap = (_c = options.downloadMap) !== null && _c !== void 0 ? _c : (0, download_map_1.makeDownloadMap)();
+    const downloadMap = (_e = (_d = options.internal) === null || _d === void 0 ? void 0 : _d.downloadMap) !== null && _e !== void 0 ? _e : (0, download_map_1.makeDownloadMap)();
     const { estimatedUsage, freeMemory, hasEnoughMemory } = (0, prestitcher_memory_usage_1.shouldUseParallelEncoding)({
         height: composition.height,
         width: composition.width,
     });
-    const parallelEncoding = hasEnoughMemory && (0, can_use_parallel_encoding_1.canUseParallelEncoding)(codec);
+    const parallelEncoding = !options.disallowParallelEncoding &&
+        hasEnoughMemory &&
+        (0, can_use_parallel_encoding_1.canUseParallelEncoding)(codec);
     if (options.verbose) {
-        console.log('[PRESTITCHER] Free memory:', freeMemory, 'Estimated usage parallel encoding', estimatedUsage);
-        console.log('[PRESTICHER]: Codec supports parallel rendering:', (0, can_use_parallel_encoding_1.canUseParallelEncoding)(codec));
+        const log = (_f = options.printLog) !== null && _f !== void 0 ? _f : console.log;
+        log('[PRESTITCHER] Free memory:', freeMemory, 'Estimated usage parallel encoding', estimatedUsage);
+        log('[PRESTITCHER]: Codec supports parallel rendering:', (0, can_use_parallel_encoding_1.canUseParallelEncoding)(codec));
+        log('[PRESTITCHER]: User disallowed parallel encoding:', Boolean(options.disallowParallelEncoding));
         if (parallelEncoding) {
-            console.log('[PRESTICHER] Parallel encoding is enabled.');
+            log('[PRESTITCHER] Parallel encoding is enabled.');
         }
         else {
-            console.log('[PRESTITCHER] Parallel encoding is disabled.');
+            log('[PRESTITCHER] Parallel encoding is disabled.');
         }
     }
-    const actualImageFormat = imageFormat !== null && imageFormat !== void 0 ? imageFormat : 'jpeg';
+    const imageFormat = (0, is_audio_codec_1.isAudioCodec)(codec)
+        ? 'none'
+        : (_g = options.imageFormat) !== null && _g !== void 0 ? _g : 'jpeg';
+    const jpegQuality = imageFormat === 'jpeg' ? options.jpegQuality : undefined;
+    (0, image_format_1.validateSelectedPixelFormatAndImageFormatCombination)(pixelFormat, imageFormat);
     const preEncodedFileLocation = parallelEncoding
-        ? path_1.default.join(downloadMap.preEncode, 'pre-encode.' + (0, get_extension_from_codec_1.getFileExtensionFromCodec)(codec, 'chunk'))
+        ? path_1.default.join(downloadMap.preEncode, 'pre-encode.' + (0, get_extension_from_codec_1.getFileExtensionFromCodec)(codec, audioCodec !== null && audioCodec !== void 0 ? audioCodec : null))
         : null;
     const outputDir = parallelEncoding
         ? null
         : fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'react-motion-render'));
+    if (((_h = options.internal) === null || _h === void 0 ? void 0 : _h.onCtrlCExit) && outputDir) {
+        options.internal.onCtrlCExit(() => (0, delete_directory_1.deleteDirectory)(outputDir));
+    }
     (0, validate_even_dimensions_with_codec_1.validateEvenDimensionsWithCodec)({
         codec,
         height: composition.height,
@@ -93,6 +131,9 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
             renderedDoneIn,
             renderedFrames,
             stitchStage,
+            progress: Math.round(((0.7 * renderedFrames + 0.3 * encodedFrames) /
+                composition.durationInFrames) *
+                100) / 100,
         });
     };
     const realFrameRange = (0, get_frame_to_render_1.getRealFrameRange)(composition.durationInFrames, frameRange !== null && frameRange !== void 0 ? frameRange : null);
@@ -105,10 +146,10 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
     const { waitForRightTimeOfFrameToBeInserted, setFrameToStitch, waitForFinish } = (0, ensure_frames_in_order_1.ensureFramesInOrder)(realFrameRange);
     const fps = composition.fps / (everyNthFrame !== null && everyNthFrame !== void 0 ? everyNthFrame : 1);
     remotion_1.Internals.validateFps(fps, 'in "renderMedia()"', codec === 'gif');
-    const createPrestitcherIfNecessary = async () => {
+    const createPrestitcherIfNecessary = () => {
         var _a;
         if (preEncodedFileLocation) {
-            preStitcher = await (0, prespawn_ffmpeg_1.prespawnFfmpeg)({
+            preStitcher = (0, prespawn_ffmpeg_1.prespawnFfmpeg)({
                 width: composition.width * (scale !== null && scale !== void 0 ? scale : 1),
                 height: composition.height * (scale !== null && scale !== void 0 ? scale : 1),
                 fps,
@@ -122,9 +163,10 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
                     callUpdate();
                 },
                 verbose: (_a = options.verbose) !== null && _a !== void 0 ? _a : false,
-                ffmpegExecutable,
-                imageFormat: actualImageFormat,
+                imageFormat,
                 signal: cancelPrestitcher.cancelSignal,
+                ffmpegOverride: ffmpegOverride !== null && ffmpegOverride !== void 0 ? ffmpegOverride : (({ args }) => args),
+                videoBitrate: videoBitrate !== null && videoBitrate !== void 0 ? videoBitrate : null,
             });
             stitcherFfmpeg = preStitcher.task;
         }
@@ -142,15 +184,43 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
             }
         }
     };
-    const happyPath = createPrestitcherIfNecessary()
+    const mediaSupport = (0, codec_supports_media_1.codecSupportsMedia)(codec);
+    const disableAudio = !mediaSupport.audio || muted;
+    const slowestFrames = [];
+    let maxTime = 0;
+    let minTime = 0;
+    const recordFrameTime = (frameIndex, time) => {
+        var _a, _b;
+        const frameTime = { frame: frameIndex, time };
+        if (time < minTime && slowestFrames.length === SLOWEST_FRAME_COUNT) {
+            return;
+        }
+        if (time > maxTime) {
+            // add at starting;
+            slowestFrames.unshift(frameTime);
+            maxTime = time;
+        }
+        else {
+            // add frame at appropriate position
+            const index = slowestFrames.findIndex(({ time: indexTime }) => indexTime < time);
+            slowestFrames.splice(index, 0, frameTime);
+        }
+        if (slowestFrames.length > SLOWEST_FRAME_COUNT) {
+            slowestFrames.pop();
+        }
+        minTime = (_b = (_a = slowestFrames[slowestFrames.length - 1]) === null || _a === void 0 ? void 0 : _a.time) !== null && _b !== void 0 ? _b : minTime;
+    };
+    const happyPath = Promise.resolve(createPrestitcherIfNecessary())
         .then(() => {
+        var _a;
         const renderFramesProc = (0, render_frames_1.renderFrames)({
-            config: composition,
-            onFrameUpdate: (frame) => {
+            composition,
+            onFrameUpdate: (frame, frameIndex, timeToRenderInMilliseconds) => {
                 renderedFrames = frame;
                 callUpdate();
+                recordFrameTime(frameIndex, timeToRenderInMilliseconds);
             },
-            parallelism,
+            concurrency: options.concurrency,
             outputDir,
             onStart: (data) => {
                 renderedFrames = 0;
@@ -159,8 +229,8 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
             },
             inputProps,
             envVariables,
-            imageFormat: actualImageFormat,
-            quality,
+            imageFormat,
+            jpegQuality,
             frameRange: frameRange !== null && frameRange !== void 0 ? frameRange : null,
             puppeteerInstance,
             everyNthFrame,
@@ -177,19 +247,19 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
                     setFrameToStitch(Math.min(realFrameRange[1] + 1, frame + everyNthFrame));
                 }
                 : undefined,
-            serveUrl,
+            serveUrl: options.serveUrl,
             dumpBrowserLogs,
             onBrowserLog,
             onDownload,
             timeoutInMilliseconds,
             chromiumOptions,
             scale,
-            ffmpegExecutable,
-            ffprobeExecutable,
             browserExecutable,
             port,
             cancelSignal: cancelRenderFrames.cancelSignal,
             downloadMap,
+            muted: disableAudio,
+            verbose: (_a = options.verbose) !== null && _a !== void 0 ? _a : false,
         });
         return renderFramesProc;
     })
@@ -197,10 +267,11 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
         return Promise.all([renderFramesReturn, waitForPrestitcherIfNecessary()]);
     })
         .then(([{ assetsInfo }]) => {
+        var _a;
         renderedDoneIn = Date.now() - renderStart;
         callUpdate();
-        if (outputLocation) {
-            (0, ensure_output_directory_1.ensureOutputDirectory)(outputLocation);
+        if (absoluteOutputLocation) {
+            (0, ensure_output_directory_1.ensureOutputDirectory)(absoluteOutputLocation);
         }
         const stitchStart = Date.now();
         return Promise.all([
@@ -208,10 +279,11 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
                 width: composition.width * (scale !== null && scale !== void 0 ? scale : 1),
                 height: composition.height * (scale !== null && scale !== void 0 ? scale : 1),
                 fps,
-                outputLocation,
+                outputLocation: absoluteOutputLocation,
                 internalOptions: {
                     preEncodedFileLocation,
-                    imageFormat: actualImageFormat,
+                    imageFormat,
+                    preferLossless: (_a = options.preferLossless) !== null && _a !== void 0 ? _a : false,
                 },
                 force: overwrite !== null && overwrite !== void 0 ? overwrite : overwrite_1.DEFAULT_OVERWRITE,
                 pixelFormat,
@@ -219,8 +291,6 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
                 proResProfile,
                 crf,
                 assetsInfo,
-                ffmpegExecutable,
-                ffprobeExecutable,
                 onProgress: (frame) => {
                     stitchStage = 'muxing';
                     encodedFrames = frame;
@@ -231,6 +301,12 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
                 verbose: options.verbose,
                 dir: outputDir !== null && outputDir !== void 0 ? outputDir : undefined,
                 cancelSignal: cancelStitcher.cancelSignal,
+                muted: disableAudio,
+                enforceAudioTrack,
+                ffmpegOverride,
+                audioBitrate,
+                videoBitrate,
+                audioCodec: audioCodec !== null && audioCodec !== void 0 ? audioCodec : null,
             }),
             stitchStart,
         ]);
@@ -239,7 +315,12 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
         encodedFrames = (0, get_duration_from_frame_range_1.getFramesToRender)(realFrameRange, everyNthFrame).length;
         encodedDoneIn = Date.now() - stitchStart;
         callUpdate();
-        return buffer;
+        slowestFrames.sort((a, b) => b.time - a.time);
+        const result = {
+            buffer,
+            slowestFrames,
+        };
+        return result;
     })
         .catch((err) => {
         /**
@@ -265,20 +346,25 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
         throw err;
     })
         .finally(() => {
+        var _a;
         if (preEncodedFileLocation !== null &&
             fs_1.default.existsSync(preEncodedFileLocation)) {
             (0, delete_directory_1.deleteDirectory)(path_1.default.dirname(preEncodedFileLocation));
         }
         // Clean download map if it was not passed in
-        if (!(options === null || options === void 0 ? void 0 : options.downloadMap)) {
+        if (!((_a = options.internal) === null || _a === void 0 ? void 0 : _a.downloadMap)) {
             (0, download_map_1.cleanDownloadMap)(downloadMap);
         }
+        // Clean temporary image frames when rendering ends or fails
+        if (outputDir && fs_1.default.existsSync(outputDir)) {
+            (0, delete_directory_1.deleteDirectory)(outputDir);
+        }
     });
     return Promise.race([
         happyPath,
         new Promise((_resolve, reject) => {
             cancelSignal === null || cancelSignal === void 0 ? void 0 : cancelSignal(() => {
-                reject(new Error('renderMedia() got cancelled'));
+                reject(new Error(make_cancel_signal_1.cancelErrorMessages.renderMedia));
             });
         }),
     ]);

package/dist/render-still.d.ts

@@ -1,20 +1,23 @@
-import type { SmallTCompMetadata } from 'remotion';
+/// <reference types="node" />
+import type { AnySmallCompMetadata } 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 { Browser as PuppeteerBrowser } from './browser/Browser';
-import type { FfmpegExecutable } from './ffmpeg-executable';
 import type { StillImageFormat } from './image-format';
-import type { ServeUrlOrWebpackBundle } from './legacy-webpack-config';
 import type { CancelSignal } from './make-cancel-signal';
 import type { ChromiumOptions } from './open-browser';
 declare type InnerStillOptions = {
-    composition: SmallTCompMetadata;
-    output: string;
+    composition: AnySmallCompMetadata;
+    output?: string | null;
     frame?: number;
     inputProps?: unknown;
     imageFormat?: StillImageFormat;
-    quality?: number;
+    /**
+     * @deprecated Renamed to `jpegQuality`
+     */
+    quality?: never;
+    jpegQuality?: number;
     puppeteerInstance?: PuppeteerBrowser;
     dumpBrowserLogs?: boolean;
     envVariables?: Record<string, string>;
@@ -25,20 +28,23 @@ declare type InnerStillOptions = {
     scale?: number;
     onDownload?: RenderMediaOnDownload;
     cancelSignal?: CancelSignal;
-    ffmpegExecutable?: FfmpegExecutable;
-    ffprobeExecutable?: FfmpegExecutable;
     /**
      * @deprecated Only for Remotion internal usage
      */
     downloadMap?: DownloadMap;
+    verbose?: boolean;
+};
+declare type RenderStillReturnValue = {
+    buffer: Buffer | null;
 };
-declare type RenderStillOptions = InnerStillOptions & ServeUrlOrWebpackBundle & {
+export declare type RenderStillOptions = InnerStillOptions & {
+    serveUrl: string;
     port?: number | null;
 };
 /**
  *
  * @description Render a still frame from a composition
- * @link https://www.remotion.dev/docs/renderer/render-still
+ * @see [Documentation](https://www.remotion.dev/docs/renderer/render-still)
  */
-export declare const renderStill: (options: RenderStillOptions) => Promise<void>;
+export declare const renderStill: (options: RenderStillOptions) => Promise<RenderStillReturnValue>;
 export {};

package/dist/render-still.js

@@ -32,47 +32,63 @@ const path_1 = __importDefault(require("path"));
 const remotion_1 = require("remotion");
 const download_map_1 = require("./assets/download-map");
 const browser_1 = require("./browser");
+const convert_to_positive_frame_index_1 = require("./convert-to-positive-frame-index");
 const ensure_output_directory_1 = require("./ensure-output-directory");
 const handle_javascript_exception_1 = require("./error-handling/handle-javascript-exception");
+const find_closest_package_json_1 = require("./find-closest-package-json");
 const image_format_1 = require("./image-format");
-const legacy_webpack_config_1 = require("./legacy-webpack-config");
+const jpeg_quality_1 = require("./jpeg-quality");
+const make_cancel_signal_1 = require("./make-cancel-signal");
 const open_browser_1 = require("./open-browser");
 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 validate_frame_1 = require("./validate-frame");
+const take_frame_and_compose_1 = require("./take-frame-and-compose");
 const validate_puppeteer_timeout_1 = require("./validate-puppeteer-timeout");
 const validate_scale_1 = require("./validate-scale");
-const innerRenderStill = async ({ composition, quality, imageFormat = 'png', serveUrl, puppeteerInstance, dumpBrowserLogs = false, onError, inputProps, envVariables, output, frame = 0, overwrite = true, browserExecutable, timeoutInMilliseconds, chromiumOptions, scale, proxyPort, cancelSignal, }) => {
+const innerRenderStill = async ({ composition, quality, imageFormat = image_format_1.DEFAULT_STILL_IMAGE_FORMAT, serveUrl, puppeteerInstance, dumpBrowserLogs = false, onError, inputProps, envVariables, output, frame = 0, overwrite = true, browserExecutable, timeoutInMilliseconds, chromiumOptions, scale = 1, proxyPort, cancelSignal, downloadMap, jpegQuality, }) => {
+    if (quality) {
+        throw new Error('quality has been renamed to jpegQuality. Please rename the option.');
+    }
     remotion_1.Internals.validateDimension(composition.height, 'height', 'in the `config` object passed to `renderStill()`');
     remotion_1.Internals.validateDimension(composition.width, 'width', 'in the `config` object passed to `renderStill()`');
     remotion_1.Internals.validateFps(composition.fps, 'in the `config` object of `renderStill()`', false);
-    remotion_1.Internals.validateDurationInFrames(composition.durationInFrames, 'in the `config` object passed to `renderStill()`');
-    (0, image_format_1.validateNonNullImageFormat)(imageFormat);
-    (0, validate_frame_1.validateFrame)(frame, composition.durationInFrames);
+    remotion_1.Internals.validateDurationInFrames({
+        durationInFrames: composition.durationInFrames,
+        component: 'in the `config` object passed to `renderStill()`',
+        allowFloats: false,
+    });
+    (0, image_format_1.validateStillImageFormat)(imageFormat);
+    remotion_1.Internals.validateFrame({
+        frame,
+        durationInFrames: composition.durationInFrames,
+        allowFloats: false,
+    });
+    const stillFrame = (0, convert_to_positive_frame_index_1.convertToPositiveFrameIndex)({
+        durationInFrames: composition.durationInFrames,
+        frame,
+    });
     (0, validate_puppeteer_timeout_1.validatePuppeteerTimeout)(timeoutInMilliseconds);
     (0, validate_scale_1.validateScale)(scale);
-    if (typeof output !== 'string') {
-        throw new TypeError('`output` parameter was not passed or is not a string');
-    }
-    output = path_1.default.resolve(process.cwd(), output);
-    if (quality !== undefined && imageFormat !== 'jpeg') {
+    output =
+        typeof output === 'string' ? path_1.default.resolve(process.cwd(), output) : null;
+    if (jpegQuality !== undefined && imageFormat !== 'jpeg') {
         throw new Error("You can only pass the `quality` option if `imageFormat` is 'jpeg'.");
     }
-    (0, quality_1.validateQuality)(quality);
-    if (fs_1.default.existsSync(output)) {
-        if (!overwrite) {
-            throw new Error(`Cannot render still - "overwrite" option was set to false, but the output destination ${output} already exists.`);
-        }
-        const stat = (0, fs_1.statSync)(output);
-        if (!stat.isFile()) {
-            throw new Error(`The output location ${output} already exists, but is not a file, but something else (e.g. folder). Cannot save to it.`);
+    (0, jpeg_quality_1.validateJpegQuality)(jpegQuality);
+    if (output) {
+        if (fs_1.default.existsSync(output)) {
+            if (!overwrite) {
+                throw new Error(`Cannot render still - "overwrite" option was set to false, but the output destination ${output} already exists.`);
+            }
+            const stat = (0, fs_1.statSync)(output);
+            if (!stat.isFile()) {
+                throw new Error(`The output location ${output} already exists, but is not a file, but something else (e.g. folder). Cannot save to it.`);
+            }
         }
+        (0, ensure_output_directory_1.ensureOutputDirectory)(output);
     }
-    (0, ensure_output_directory_1.ensureOutputDirectory)(output);
     const browserInstance = puppeteerInstance !== null && puppeteerInstance !== void 0 ? puppeteerInstance : (await (0, open_browser_1.openBrowser)(browser_1.DEFAULT_BROWSER, {
         browserExecutable,
         shouldDumpIo: dumpBrowserLogs,
@@ -100,7 +116,7 @@ const innerRenderStill = async ({ composition, quality, imageFormat = 'png', ser
             await page.close();
         }
         else {
-            browserInstance.close().catch((err) => {
+            browserInstance.close(true).catch((err) => {
                 console.log('Unable to close browser', err);
             });
         }
@@ -113,56 +129,75 @@ const innerRenderStill = async ({ composition, quality, imageFormat = 'png', ser
         envVariables,
         page,
         serveUrl,
-        initialFrame: frame,
+        initialFrame: stillFrame,
         timeoutInMilliseconds,
         proxyPort,
         retriesRemaining: 2,
+        audioEnabled: false,
+        videoEnabled: true,
     });
     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,
     });
-    await (0, seek_to_frame_1.seekToFrame)({ frame, page });
-    await (0, provide_screenshot_1.provideScreenshot)({
-        page,
+    await (0, seek_to_frame_1.seekToFrame)({ frame: stillFrame, page });
+    const { buffer } = await (0, take_frame_and_compose_1.takeFrameAndCompose)({
+        downloadMap,
+        frame: stillFrame,
+        freePage: page,
+        height: composition.height,
+        width: composition.width,
         imageFormat,
-        quality,
-        options: {
-            frame,
-            output,
-        },
+        scale,
+        output,
+        jpegQuality,
+        wantsBuffer: !output,
     });
     await cleanup();
+    return { buffer: output ? null : buffer };
 };
 /**
  *
  * @description Render a still frame from a composition
- * @link https://www.remotion.dev/docs/renderer/render-still
+ * @see [Documentation](https://www.remotion.dev/docs/renderer/render-still)
  */
 const renderStill = (options) => {
     var _a, _b;
-    const selectedServeUrl = (0, legacy_webpack_config_1.getServeUrlWithFallback)(options);
     const downloadMap = (_a = options.downloadMap) !== null && _a !== void 0 ? _a : (0, download_map_1.makeDownloadMap)();
     const onDownload = (_b = options.onDownload) !== null && _b !== void 0 ? _b : (() => () => undefined);
     const happyPath = new Promise((resolve, reject) => {
-        var _a, _b, _c;
+        var _a, _b;
         const onError = (err) => reject(err);
         let close = null;
         (0, prepare_server_1.prepareServer)({
-            webpackConfigOrServeUrl: selectedServeUrl,
+            webpackConfigOrServeUrl: options.serveUrl,
             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,
+            port: (_a = options.port) !== null && _a !== void 0 ? _a : null,
             downloadMap,
+            remotionRoot: (0, find_closest_package_json_1.findRemotionRoot)(),
+            concurrency: 1,
+            verbose: (_b = options.verbose) !== null && _b !== void 0 ? _b : false,
         })
             .then(({ serveUrl, closeServer, offthreadPort }) => {
             close = closeServer;
@@ -171,6 +206,7 @@ const renderStill = (options) => {
                 serveUrl,
                 onError: (err) => reject(err),
                 proxyPort: offthreadPort,
+                downloadMap,
             });
         })
             .then((res) => resolve(res))
@@ -180,7 +216,7 @@ const renderStill = (options) => {
             if (!(options === null || options === void 0 ? void 0 : options.downloadMap)) {
                 (0, download_map_1.cleanDownloadMap)(downloadMap);
             }
-            return close === null || close === void 0 ? void 0 : close();
+            return close === null || close === void 0 ? void 0 : close(false);
         });
     });
     return Promise.race([
@@ -188,7 +224,7 @@ const renderStill = (options) => {
         new Promise((_resolve, reject) => {
             var _a;
             (_a = options.cancelSignal) === null || _a === void 0 ? void 0 : _a.call(options, () => {
-                reject(new Error('renderStill() got cancelled'));
+                reject(new Error(make_cancel_signal_1.cancelErrorMessages.renderStill));
             });
         }),
     ]);

package/dist/replace-browser.d.ts

@@ -0,0 +1,6 @@
+import type { Browser } from './browser/Browser';
+export declare type BrowserReplacer = {
+    getBrowser: () => Browser;
+    replaceBrowser: (make: () => Promise<Browser>, makeNewPages: () => Promise<void>) => Promise<Browser>;
+};
+export declare const handleBrowserCrash: (instance: Browser) => BrowserReplacer;