@remotion/renderer 3.1.6 → 3.1.7

package/dist/prepare-server.js

@@ -9,15 +9,15 @@ const path_1 = __importDefault(require("path"));
 const is_serve_url_1 = require("./is-serve-url");
 const serve_static_1 = require("./serve-static");
 const wait_for_symbolication_error_to_be_done_1 = require("./wait-for-symbolication-error-to-be-done");
-const prepareServer = async ({ downloadDir, ffmpegExecutable, ffprobeExecutable, onDownload, onError, webpackConfigOrServeUrl, port, }) => {
+const prepareServer = async ({ ffmpegExecutable, ffprobeExecutable, onDownload, onError, webpackConfigOrServeUrl, port, downloadMap, }) => {
     if ((0, is_serve_url_1.isServeUrl)(webpackConfigOrServeUrl)) {
         const { port: offthreadPort, close: closeProxy } = await (0, serve_static_1.serveStatic)(null, {
-            downloadDir,
             onDownload,
             onError,
             ffmpegExecutable,
             ffprobeExecutable,
             port,
+            downloadMap,
         });
         return Promise.resolve({
             serveUrl: webpackConfigOrServeUrl,
@@ -34,12 +34,12 @@ const prepareServer = async ({ downloadDir, ffmpegExecutable, ffprobeExecutable,
         throw new Error(`Tried to serve the Webpack bundle on a HTTP server, but the file ${indexFile} does not exist. Is this a valid path to a Webpack bundle?`);
     }
     const { port: serverPort, close } = await (0, serve_static_1.serveStatic)(webpackConfigOrServeUrl, {
-        downloadDir,
         onDownload,
         onError,
         ffmpegExecutable,
         ffprobeExecutable,
         port,
+        downloadMap,
     });
     return Promise.resolve({
         closeServer: () => {

package/dist/preprocess-audio-track.d.ts

@@ -1,5 +1,6 @@
-import type { FfmpegExecutable } from 'remotion';
+import type { DownloadMap } from './assets/download-map';
 import type { MediaAsset } from './assets/types';
+import type { FfmpegExecutable } from './ffmpeg-executable';
 declare type Options = {
     ffmpegExecutable: FfmpegExecutable;
     ffprobeExecutable: FfmpegExecutable;
@@ -7,6 +8,7 @@ declare type Options = {
     asset: MediaAsset;
     expectedFrames: number;
     fps: number;
+    downloadMap: DownloadMap;
 };
 export declare const preprocessAudioTrack: (options: Options) => Promise<string | null>;
 export {};

package/dist/preprocess-audio-track.js

@@ -10,8 +10,8 @@ const calculate_ffmpeg_filters_1 = require("./calculate-ffmpeg-filters");
 const ffmpeg_filter_file_1 = require("./ffmpeg-filter-file");
 const p_limit_1 = require("./p-limit");
 const resolve_asset_src_1 = require("./resolve-asset-src");
-const preprocessAudioTrackUnlimited = async ({ ffmpegExecutable, ffprobeExecutable, outName, asset, expectedFrames, fps, }) => {
-    const { channels, duration } = await (0, get_audio_channels_1.getAudioChannelsAndDuration)((0, resolve_asset_src_1.resolveAssetSrc)(asset.src), ffprobeExecutable);
+const preprocessAudioTrackUnlimited = async ({ ffmpegExecutable, ffprobeExecutable, outName, asset, expectedFrames, fps, downloadMap, }) => {
+    const { channels, duration } = await (0, get_audio_channels_1.getAudioChannelsAndDuration)(downloadMap, (0, resolve_asset_src_1.resolveAssetSrc)(asset.src), ffprobeExecutable);
     const filter = (0, calculate_ffmpeg_filters_1.calculateFfmpegFilter)({
         asset,
         durationInFrames: expectedFrames,

package/dist/prespawn-ffmpeg.d.ts

@@ -1,6 +1,10 @@
 import execa from 'execa';
-import type { Codec, FfmpegExecutable, ImageFormat, PixelFormat, ProResProfile } from 'remotion';
+import type { Codec } from './codec';
+import type { FfmpegExecutable } from './ffmpeg-executable';
+import type { ImageFormat } from './image-format';
 import type { CancelSignal } from './make-cancel-signal';
+import type { PixelFormat } from './pixel-format';
+import type { ProResProfile } from './prores-profile';
 declare type PreSticherOptions = {
     fps: number;
     width: number;

package/dist/prespawn-ffmpeg.js

@@ -6,25 +6,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.prespawnFfmpeg = void 0;
 const execa_1 = __importDefault(require("execa"));
 const remotion_1 = require("remotion");
+const codec_1 = require("./codec");
+const crf_1 = require("./crf");
 const get_codec_name_1 = require("./get-codec-name");
 const get_prores_profile_name_1 = require("./get-prores-profile-name");
 const parse_ffmpeg_progress_1 = require("./parse-ffmpeg-progress");
+const pixel_format_1 = require("./pixel-format");
 const validate_even_dimensions_with_codec_1 = require("./validate-even-dimensions-with-codec");
 const validate_ffmpeg_1 = require("./validate-ffmpeg");
 const prespawnFfmpeg = async (options) => {
     var _a, _b, _c, _d, _e, _f, _g;
     remotion_1.Internals.validateDimension(options.height, 'height', 'passed to `stitchFramesToVideo()`');
     remotion_1.Internals.validateDimension(options.width, 'width', 'passed to `stitchFramesToVideo()`');
-    const codec = (_a = options.codec) !== null && _a !== void 0 ? _a : remotion_1.Internals.DEFAULT_CODEC;
-    remotion_1.Internals.validateFps(options.fps, 'in `stitchFramesToVideo()`', codec);
+    const codec = (_a = options.codec) !== null && _a !== void 0 ? _a : codec_1.DEFAULT_CODEC;
+    remotion_1.Internals.validateFps(options.fps, 'in `stitchFramesToVideo()`', codec === 'gif');
     (0, validate_even_dimensions_with_codec_1.validateEvenDimensionsWithCodec)({
         width: options.width,
         height: options.height,
         codec,
         scale: 1,
     });
-    const crf = (_b = options.crf) !== null && _b !== void 0 ? _b : remotion_1.Internals.getDefaultCrfForCodec(codec);
-    const pixelFormat = (_c = options.pixelFormat) !== null && _c !== void 0 ? _c : remotion_1.Internals.DEFAULT_PIXEL_FORMAT;
+    const crf = (_b = options.crf) !== null && _b !== void 0 ? _b : (0, crf_1.getDefaultCrfForCodec)(codec);
+    const pixelFormat = (_c = options.pixelFormat) !== null && _c !== void 0 ? _c : pixel_format_1.DEFAULT_PIXEL_FORMAT;
     await (0, validate_ffmpeg_1.validateFfmpeg)((_d = options.ffmpegExecutable) !== null && _d !== void 0 ? _d : null);
     const encoderName = (0, get_codec_name_1.getCodecName)(codec);
     const proResProfileName = (0, get_prores_profile_name_1.getProResProfileName)(codec, options.proResProfile);
@@ -42,8 +45,8 @@ const prespawnFfmpeg = async (options) => {
         console.log('[verbose] codec', codec);
         console.log('[verbose] proResProfileName', proResProfileName);
     }
-    remotion_1.Internals.validateSelectedCrfAndCodecCombination(crf, codec);
-    remotion_1.Internals.validateSelectedPixelFormatAndCodecCombination(pixelFormat, codec);
+    (0, crf_1.validateSelectedCrfAndCodecCombination)(crf, codec);
+    (0, pixel_format_1.validateSelectedPixelFormatAndCodecCombination)(pixelFormat, codec);
     const ffmpegArgs = [
         ['-r', options.fps.toFixed(2)],
         ...[

package/dist/prores-profile.d.ts

@@ -0,0 +1,5 @@
+import type { Codec } from './codec';
+declare const proResProfileOptions: readonly ["4444-xq", "4444", "hq", "standard", "light", "proxy"];
+export declare type ProResProfile = typeof proResProfileOptions[number];
+export declare const validateSelectedCodecAndProResCombination: (actualCodec: Codec, actualProResProfile: ProResProfile | undefined) => void;
+export {};

package/dist/prores-profile.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateSelectedCodecAndProResCombination = void 0;
+const proResProfileOptions = [
+    '4444-xq',
+    '4444',
+    'hq',
+    'standard',
+    'light',
+    'proxy',
+];
+const validateSelectedCodecAndProResCombination = (actualCodec, actualProResProfile) => {
+    if (typeof actualProResProfile !== 'undefined' && actualCodec !== 'prores') {
+        throw new TypeError('You have set a ProRes profile but the codec is not "prores". Set the codec to "prores" or remove the ProRes profile.');
+    }
+    if (actualProResProfile !== undefined &&
+        !proResProfileOptions.includes(actualProResProfile)) {
+        throw new TypeError(`The ProRes profile "${actualProResProfile}" is not valid. Valid options are ${proResProfileOptions
+            .map((p) => `"${p}"`)
+            .join(', ')}`);
+    }
+};
+exports.validateSelectedCodecAndProResCombination = validateSelectedCodecAndProResCombination;

package/dist/provide-screenshot.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
-import type { ImageFormat } from 'remotion';
 import type { Page } from './browser/BrowserPage';
+import type { ImageFormat } from './image-format';
 export declare const provideScreenshot: ({ page, imageFormat, options, quality, }: {
     page: Page;
     imageFormat: ImageFormat;

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,8 +1,13 @@
 /// <reference types="node" />
-import type { BrowserExecutable, FfmpegExecutable, FrameRange, ImageFormat, SmallTCompMetadata } from 'remotion';
+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';
@@ -39,6 +44,10 @@ declare type RenderFramesOptions = {
     ffprobeExecutable?: FfmpegExecutable;
     port?: number | null;
     cancelSignal?: CancelSignal;
+    /**
+     * @deprecated Only for Remotion internal usage
+     */
+    downloadMap?: DownloadMap;
 } & ConfigOrComposition & ServeUrlOrWebpackBundle;
 export declare const renderFrames: (options: RenderFramesOptions) => Promise<RenderFramesOutput>;
 export {};

package/dist/render-frames.js

@@ -8,6 +8,9 @@ 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");
@@ -16,14 +19,16 @@ 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) {
@@ -39,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, everyNthFrame = 1, 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, }) => {
     if (!puppeteerInstance) {
         throw new Error('no puppeteer instance passed to innerRenderFrames - internal error');
     }
@@ -133,7 +138,7 @@ 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,
@@ -143,7 +148,7 @@ const innerRenderFrames = ({ onFrameUpdate, outputDir, onStart, inputProps, qual
                         output: null,
                     },
                 });
-                remotion_1.Internals.perf.stopPerfMeasure(id);
+                (0, perf_1.stopPerfMeasure)(id);
                 onFrameBuffer(buffer, frame);
             }
             else {
@@ -177,13 +182,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}`));
             });
@@ -199,9 +204,9 @@ const innerRenderFrames = ({ onFrameUpdate, outputDir, onStart, inputProps, qual
         const returnValue = {
             assetsInfo: {
                 assets,
-                downloadDir,
                 imageSequenceName: `element-%0${filePadLength}d.${imageFormat}`,
                 firstFrameIndex: framesToRender[0],
+                downloadMap,
             },
             frameCount: framesToRender.length,
         };
@@ -214,30 +219,30 @@ const innerRenderFrames = ({ onFrameUpdate, outputDir, onStart, inputProps, qual
         .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()`', null);
+    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, _c;
@@ -255,12 +260,12 @@ const renderFrames = (options) => {
             Promise.all([
                 (0, prepare_server_1.prepareServer)({
                     webpackConfigOrServeUrl: selectedServeUrl,
-                    downloadDir,
                     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]) => {
@@ -276,8 +281,8 @@ const renderFrames = (options) => {
                     composition,
                     actualParallelism,
                     onDownload,
-                    downloadDir,
                     proxyPort: offthreadPort,
+                    downloadMap,
                 });
             }),
         ])

package/dist/render-media.d.ts

@@ -1,11 +1,18 @@
 /// <reference types="node" />
-import type { BrowserExecutable, Codec, FfmpegExecutable, FrameRange, PixelFormat, ProResProfile, SmallTCompMetadata } from 'remotion';
+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: {
@@ -45,10 +52,15 @@ export declare type RenderMediaOptions = {
     port?: number | null;
     cancelSignal?: CancelSignal;
     browserExecutable?: BrowserExecutable;
+    verbose?: boolean;
+    /**
+     * @deprecated Only for Remotion internal usage
+     */
+    downloadMap?: DownloadMap;
 } & ServeUrlOrWebpackBundle;
 /**
  *
  * @description Render a video from a composition
  * @link https://www.remotion.dev/docs/renderer/render-media
  */
-export declare 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 }: RenderMediaOptions) => Promise<Buffer | null>;
+export declare 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, downloadMap, ...options }: RenderMediaOptions) => Promise<Buffer | null>;

package/dist/render-media.js

@@ -8,7 +8,9 @@ const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
 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 crf_1 = require("./crf");
 const ensure_frames_in_order_1 = require("./ensure-frames-in-order");
 const ensure_output_directory_1 = require("./ensure-output-directory");
 const get_duration_from_frame_range_1 = require("./get-duration-from-frame-range");
@@ -17,7 +19,10 @@ 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 make_cancel_signal_1 = require("./make-cancel-signal");
+const overwrite_1 = require("./overwrite");
+const perf_1 = require("./perf");
 const prespawn_ffmpeg_1 = require("./prespawn-ffmpeg");
+const quality_1 = require("./quality");
 const render_frames_1 = require("./render-frames");
 const stitch_frames_to_video_1 = require("./stitch-frames-to-video");
 const tmp_dir_1 = require("./tmp-dir");
@@ -29,11 +34,11 @@ const validate_scale_1 = require("./validate-scale");
  * @description Render a video from a composition
  * @link 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 }) => {
+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, downloadMap, ...options }) => {
     var _a, _b;
-    remotion_1.Internals.validateQuality(quality);
+    (0, quality_1.validateQuality)(quality);
     if (typeof crf !== 'undefined' && crf !== null) {
-        remotion_1.Internals.validateSelectedCrfAndCodecCombination(crf, codec);
+        (0, crf_1.validateSelectedCrfAndCodecCombination)(crf, codec);
     }
     if (outputLocation) {
         (0, validate_output_filename_1.validateOutputFilename)(codec, (0, get_extension_of_filename_1.getExtensionOfFilename)(outputLocation));
@@ -84,8 +89,9 @@ 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);
+    remotion_1.Internals.validateFps(fps, 'in "renderMedia()"', codec === 'gif');
     const createPrestitcherIfNecessary = async () => {
+        var _a;
         if (preEncodedFileLocation) {
             preStitcher = await (0, prespawn_ffmpeg_1.prespawnFfmpeg)({
                 width: composition.width * (scale !== null && scale !== void 0 ? scale : 1),
@@ -100,7 +106,7 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
                     encodedFrames = frame;
                     callUpdate();
                 },
-                verbose: remotion_1.Internals.Logging.isEqualOrBelowLogLevel(remotion_1.Internals.Logging.getLogLevel(), 'verbose'),
+                verbose: (_a = options.verbose) !== null && _a !== void 0 ? _a : false,
                 ffmpegExecutable,
                 imageFormat: actualImageFormat,
                 signal: cancelPrestitcher.cancelSignal,
@@ -150,9 +156,9 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
                     if (cancelled) {
                         return;
                     }
-                    const id = remotion_1.Internals.perf.startPerfMeasure('piping');
+                    const id = (0, perf_1.startPerfMeasure)('piping');
                     (_a = stitcherFfmpeg === null || stitcherFfmpeg === void 0 ? void 0 : stitcherFfmpeg.stdin) === null || _a === void 0 ? void 0 : _a.write(buffer);
-                    remotion_1.Internals.perf.stopPerfMeasure(id);
+                    (0, perf_1.stopPerfMeasure)(id);
                     setFrameToStitch(Math.min(realFrameRange[1] + 1, frame + everyNthFrame));
                 }
                 : undefined,
@@ -168,6 +174,7 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
             browserExecutable,
             port,
             cancelSignal: cancelRenderFrames.cancelSignal,
+            downloadMap: downloadMap !== null && downloadMap !== void 0 ? downloadMap : (0, download_map_1.makeDownloadMap)(),
         });
         return renderFramesProc;
     })
@@ -191,7 +198,7 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
                     preEncodedFileLocation,
                     imageFormat: actualImageFormat,
                 },
-                force: overwrite !== null && overwrite !== void 0 ? overwrite : remotion_1.Internals.DEFAULT_OVERWRITE,
+                force: overwrite !== null && overwrite !== void 0 ? overwrite : overwrite_1.DEFAULT_OVERWRITE,
                 pixelFormat,
                 codec,
                 proResProfile,
@@ -206,7 +213,7 @@ const renderMedia = ({ parallelism, proResProfile, crf, composition, imageFormat
                 },
                 onDownload,
                 numberOfGifLoops,
-                verbose: remotion_1.Internals.Logging.isEqualOrBelowLogLevel(remotion_1.Internals.Logging.getLogLevel(), 'verbose'),
+                verbose: options.verbose,
                 dir: outputDir !== null && outputDir !== void 0 ? outputDir : undefined,
                 cancelSignal: cancelStitcher.cancelSignal,
             }),

package/dist/render-still.d.ts

@@ -1,6 +1,10 @@
-import type { BrowserExecutable, FfmpegExecutable, SmallTCompMetadata, StillImageFormat } from 'remotion';
+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 { 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';
@@ -23,6 +27,10 @@ declare type InnerStillOptions = {
     cancelSignal?: CancelSignal;
     ffmpegExecutable?: FfmpegExecutable;
     ffprobeExecutable?: FfmpegExecutable;
+    /**
+     * @deprecated Only for Remotion internal usage
+     */
+    downloadMap?: DownloadMap;
 };
 declare type RenderStillOptions = InnerStillOptions & ServeUrlOrWebpackBundle & {
     port?: number | null;

package/dist/render-still.js

@@ -30,25 +30,29 @@ exports.renderStill = void 0;
 const fs_1 = __importStar(require("fs"));
 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 ensure_output_directory_1 = require("./ensure-output-directory");
 const handle_javascript_exception_1 = require("./error-handling/handle-javascript-exception");
+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 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 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, }) => {
     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()`', null);
+    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()`');
-    remotion_1.Internals.validateNonNullImageFormat(imageFormat);
-    remotion_1.Internals.validateFrame(frame, composition.durationInFrames);
+    (0, image_format_1.validateNonNullImageFormat)(imageFormat);
+    (0, validate_frame_1.validateFrame)(frame, composition.durationInFrames);
     (0, validate_puppeteer_timeout_1.validatePuppeteerTimeout)(timeoutInMilliseconds);
     (0, validate_scale_1.validateScale)(scale);
     if (typeof output !== 'string') {
@@ -58,7 +62,7 @@ const innerRenderStill = async ({ composition, quality, imageFormat = 'png', ser
     if (quality !== undefined && imageFormat !== 'jpeg') {
         throw new Error("You can only pass the `quality` option if `imageFormat` is 'jpeg'.");
     }
-    remotion_1.Internals.validateQuality(quality);
+    (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.`);
@@ -69,7 +73,7 @@ const innerRenderStill = async ({ composition, quality, imageFormat = 'png', ser
         }
     }
     (0, ensure_output_directory_1.ensureOutputDirectory)(output);
-    const browserInstance = puppeteerInstance !== null && puppeteerInstance !== void 0 ? puppeteerInstance : (await (0, open_browser_1.openBrowser)(remotion_1.Internals.DEFAULT_BROWSER, {
+    const browserInstance = puppeteerInstance !== null && puppeteerInstance !== void 0 ? puppeteerInstance : (await (0, open_browser_1.openBrowser)(browser_1.DEFAULT_BROWSER, {
         browserExecutable,
         shouldDumpIo: dumpBrowserLogs,
         chromiumOptions,
@@ -143,22 +147,22 @@ const innerRenderStill = async ({ composition, quality, imageFormat = 'png', ser
  * @link https://www.remotion.dev/docs/renderer/render-still
  */
 const renderStill = (options) => {
-    var _a;
+    var _a, _b;
     const selectedServeUrl = (0, legacy_webpack_config_1.getServeUrlWithFallback)(options);
-    const downloadDir = (0, make_assets_download_dir_1.makeAssetsDownloadTmpDir)();
-    const onDownload = (_a = options.onDownload) !== null && _a !== void 0 ? _a : (() => () => undefined);
+    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;
         const onError = (err) => reject(err);
         let close = null;
         (0, prepare_server_1.prepareServer)({
             webpackConfigOrServeUrl: selectedServeUrl,
-            downloadDir,
             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,
         })
             .then(({ serveUrl, closeServer, offthreadPort }) => {
             close = closeServer;

package/dist/screenshot-dom-element.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
-import type { ImageFormat } from 'remotion';
 import type { Page } from './browser/BrowserPage';
+import type { ImageFormat } from './image-format';
 export declare const screenshotDOMElement: ({ page, imageFormat, quality, opts, }: {
     page: Page;
     imageFormat: ImageFormat;

package/dist/screenshot-task.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="node" />
-import type { StillImageFormat } from 'remotion';
 import type { Page } from './browser/BrowserPage';
 import type { ScreenshotOptions } from './browser/ScreenshotOptions';
+import type { StillImageFormat } from './image-format';
 export declare const _screenshotTask: (page: Page, format: StillImageFormat, options: ScreenshotOptions) => Promise<Buffer | string>;