@remotion/renderer 4.0.21 → 4.0.23

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import execa from 'execa';
 import { HeadlessBrowser } from './browser/Browser';
 import { SymbolicateableError } from './error-handling/symbolicateable-error';
@@ -24,7 +23,7 @@ export type { LogLevel } from './log-level';
 export { CancelSignal, makeCancelSignal } from './make-cancel-signal';
 export { openBrowser } from './open-browser';
 export type { ChromiumOptions } from './open-browser';
-export { RemotionOption } from './options/option';
+export { AnyRemotionOption, RemotionOption, ToOptions } from './options/option';
 export { PixelFormat } from './pixel-format';
 export { RemotionServer } from './prepare-server';
 export { ProResProfile } from './prores-profile';
@@ -37,6 +36,7 @@ export { SymbolicatedStackFrame } from './symbolicate-stacktrace';
 export { OnStartData, RenderFramesOutput } from './types';
 export { OpenGlRenderer } from './validate-opengl-renderer';
 export { validateOutputFilename } from './validate-output-filename';
+export { X264Preset } from './x264-preset';
 export declare const RenderInternals: {
     ensureLocalBrowser: (preferredBrowserExecutable: import("./browser-executable").BrowserExecutable) => Promise<void>;
     getActualConcurrency: (userPreference: string | number | null) => number;
@@ -45,8 +45,9 @@ export declare const RenderInternals: {
         downloadMap: import("./assets/download-map").DownloadMap;
         remotionRoot: string;
         concurrency: number;
-        logLevel: "error" | "verbose" | "info" | "warn";
+        logLevel: "verbose" | "info" | "warn" | "error";
         indent: boolean;
+        offthreadVideoCacheSizeInBytes: number | null;
     }) => Promise<{
         port: number;
         close: () => Promise<void>;
@@ -115,8 +116,8 @@ export declare const RenderInternals: {
     validPixelFormats: readonly ["yuv420p", "yuva420p", "yuv422p", "yuv444p", "yuv420p10le", "yuv422p10le", "yuv444p10le", "yuva444p10le"];
     DEFAULT_BROWSER: "chrome";
     validateFrameRange: (frameRange: import("./frame-range").FrameRange | null) => void;
-    DEFAULT_OPENGL_RENDERER: "angle" | "swangle" | "egl" | "swiftshader" | null;
-    validateOpenGlRenderer: (option: "angle" | "swangle" | "egl" | "swiftshader" | null) => "angle" | "swangle" | "egl" | "swiftshader" | null;
+    DEFAULT_OPENGL_RENDERER: "swangle" | "angle" | "egl" | "swiftshader" | null;
+    validateOpenGlRenderer: (option: "swangle" | "angle" | "egl" | "swiftshader" | null) => "swangle" | "angle" | "egl" | "swiftshader" | null;
     validCodecs: readonly ["h264", "h265", "vp8", "vp9", "mp3", "aac", "wav", "prores", "h264-mkv", "gif"];
     DEFAULT_PIXEL_FORMAT: "yuv420p" | "yuva420p" | "yuv422p" | "yuv444p" | "yuv420p10le" | "yuv422p10le" | "yuv444p10le" | "yuva444p10le";
     validateJpegQuality: (q: number | undefined) => void;
@@ -124,7 +125,7 @@ export declare const RenderInternals: {
     DEFAULT_CODEC: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif";
     isAudioCodec: (codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif" | undefined) => boolean;
     logLevels: readonly ["verbose", "info", "warn", "error"];
-    isEqualOrBelowLogLevel: (currentLevel: "error" | "verbose" | "info" | "warn", level: "error" | "verbose" | "info" | "warn") => boolean;
+    isEqualOrBelowLogLevel: (currentLevel: "verbose" | "info" | "warn" | "error", level: "verbose" | "info" | "warn" | "error") => boolean;
     isValidLogLevel: (level: string) => boolean;
     perf: typeof perf;
     convertToPositiveFrameIndex: ({ frame, durationInFrames, }: {
@@ -304,8 +305,8 @@ export declare const RenderInternals: {
     };
     validStillImageFormats: readonly ["png", "jpeg", "pdf", "webp"];
     validVideoImageFormats: readonly ["png", "jpeg", "none"];
-    DEFAULT_STILL_IMAGE_FORMAT: "jpeg" | "png" | "webp" | "pdf";
-    DEFAULT_VIDEO_IMAGE_FORMAT: "jpeg" | "png" | "none";
+    DEFAULT_STILL_IMAGE_FORMAT: "png" | "jpeg" | "pdf" | "webp";
+    DEFAULT_VIDEO_IMAGE_FORMAT: "png" | "jpeg" | "none";
     DEFAULT_JPEG_QUALITY: number;
     chalk: {
         enabled: () => boolean;
@@ -361,48 +362,50 @@ export declare const RenderInternals: {
         verbose: (message?: any, ...optionalParams: any[]) => void;
         verboseAdvanced: (options: {
             indent: boolean;
-            logLevel: "error" | "verbose" | "info" | "warn";
+            logLevel: "verbose" | "info" | "warn" | "error";
         } & {
             tag?: string | undefined;
         }, message?: any, ...optionalParams: any[]) => void;
         info: (message?: any, ...optionalParams: any[]) => void;
         infoAdvanced: (options: {
             indent: boolean;
-            logLevel: "error" | "verbose" | "info" | "warn";
+            logLevel: "verbose" | "info" | "warn" | "error";
         }, message?: any, ...optionalParams: any[]) => void;
         warn: (message?: any, ...optionalParams: any[]) => void;
         warnAdvanced: (options: {
             indent: boolean;
-            logLevel: "error" | "verbose" | "info" | "warn";
+            logLevel: "verbose" | "info" | "warn" | "error";
         }, message?: any, ...optionalParams: any[]) => void;
         error: (message?: any, ...optionalParams: any[]) => void;
         errorAdvanced: (options: {
             indent: boolean;
-            logLevel: "error" | "verbose" | "info" | "warn";
+            logLevel: "verbose" | "info" | "warn" | "error";
         } & {
             tag?: string | undefined;
         }, message?: any, ...optionalParams: any[]) => void;
     };
-    getLogLevel: () => "error" | "verbose" | "info" | "warn";
-    setLogLevel: (newLogLevel: "error" | "verbose" | "info" | "warn") => void;
+    getLogLevel: () => "verbose" | "info" | "warn" | "error";
+    setLogLevel: (newLogLevel: "verbose" | "info" | "warn" | "error") => void;
     INDENT_TOKEN: string;
     isColorSupported: () => boolean;
     HeadlessBrowser: typeof HeadlessBrowser;
-    prepareServer: ({ webpackConfigOrServeUrl, port, remotionRoot, concurrency, logLevel, indent, }: {
+    prepareServer: ({ webpackConfigOrServeUrl, port, remotionRoot, concurrency, logLevel, indent, offthreadVideoCacheSizeInBytes, }: {
         webpackConfigOrServeUrl: string;
         port: number | null;
         remotionRoot: string;
         concurrency: number;
-        logLevel: "error" | "verbose" | "info" | "warn";
+        logLevel: "verbose" | "info" | "warn" | "error";
         indent: boolean;
+        offthreadVideoCacheSizeInBytes: number | null;
     }) => Promise<import("./prepare-server").RemotionServer>;
     makeOrReuseServer: (server: import("./prepare-server").RemotionServer | undefined, config: {
         webpackConfigOrServeUrl: string;
         port: number | null;
         remotionRoot: string;
         concurrency: number;
-        logLevel: "error" | "verbose" | "info" | "warn";
+        logLevel: "verbose" | "info" | "warn" | "error";
         indent: boolean;
+        offthreadVideoCacheSizeInBytes: number | null;
     }, { onDownload, onError, }: {
         onError: (err: Error) => void;
         onDownload: import("./assets/download-and-map-assets-to-file").RenderMediaOnDownload | null;
@@ -416,7 +419,7 @@ export declare const RenderInternals: {
         frame: number;
         serializedInputPropsWithCustomSchema: string;
         serializedResolvedPropsWithCustomSchema: string;
-        imageFormat: "jpeg" | "png" | "webp" | "pdf";
+        imageFormat: "png" | "jpeg" | "pdf" | "webp";
         jpegQuality: number;
         puppeteerInstance: HeadlessBrowser | null;
         envVariables: Record<string, string>;
@@ -430,10 +433,18 @@ export declare const RenderInternals: {
         cancelSignal: import("./make-cancel-signal").CancelSignal | null;
         indent: boolean;
         server: import("./prepare-server").RemotionServer | undefined;
-        logLevel: "error" | "verbose" | "info" | "warn";
+        logLevel: "verbose" | "info" | "warn" | "error";
         serveUrl: string;
         port: number | null;
-    }) => Promise<{
+        offthreadVideoCacheSizeInBytes: number | null;
+    } & import("./options/option").ToOptions<readonly [{
+        name: string;
+        cliFlag: "offthreadvideo-cache-size-in-bytes";
+        description: JSX.Element;
+        ssrName: "offthreadVideoCacheSizeInBytes";
+        docLink: string;
+        type: number | null;
+    }]>) => Promise<{
         buffer: Buffer | null;
     }>;
     internalOpenBrowser: ({ browser, browserExecutable, chromiumOptions, forceDeviceScaleFactor, indent, viewport, logLevel, }: {
@@ -443,7 +454,7 @@ export declare const RenderInternals: {
         viewport: import("./browser/PuppeteerViewport").Viewport | null;
         indent: boolean;
         browser: "chrome";
-        logLevel: "error" | "verbose" | "info" | "warn";
+        logLevel: "verbose" | "info" | "warn" | "error";
     }) => Promise<HeadlessBrowser>;
     internalSelectComposition: (options: {
         serializedInputPropsWithCustomSchema: string;
@@ -456,14 +467,21 @@ export declare const RenderInternals: {
         port: number | null;
         indent: boolean;
         server: import("./prepare-server").RemotionServer | undefined;
-        logLevel: "error" | "verbose" | "info" | "warn";
+        logLevel: "verbose" | "info" | "warn" | "error";
         serveUrl: string;
         id: string;
-    }) => Promise<{
+    } & import("./options/option").ToOptions<readonly [{
+        name: string;
+        cliFlag: "offthreadvideo-cache-size-in-bytes";
+        description: JSX.Element;
+        ssrName: "offthreadVideoCacheSizeInBytes";
+        docLink: string;
+        type: number | null;
+    }]>) => Promise<{
         metadata: import("remotion").VideoConfig;
         propsSize: number;
     }>;
-    internalGetCompositions: ({ browserExecutable, chromiumOptions, envVariables, indent, serializedInputPropsWithCustomSchema, onBrowserLog, port, puppeteerInstance, serveUrlOrWebpackUrl, server, timeoutInMilliseconds, logLevel, }: {
+    internalGetCompositions: ({ browserExecutable, chromiumOptions, envVariables, indent, serializedInputPropsWithCustomSchema, onBrowserLog, port, puppeteerInstance, serveUrlOrWebpackUrl, server, timeoutInMilliseconds, logLevel, offthreadVideoCacheSizeInBytes, }: {
         serializedInputPropsWithCustomSchema: string;
         envVariables: Record<string, string>;
         puppeteerInstance: HeadlessBrowser | undefined;
@@ -474,14 +492,21 @@ export declare const RenderInternals: {
         port: number | null;
         server: import("./prepare-server").RemotionServer | undefined;
         indent: boolean;
-        logLevel: "error" | "verbose" | "info" | "warn";
+        logLevel: "verbose" | "info" | "warn" | "error";
         serveUrlOrWebpackUrl: string;
-    }) => Promise<import("remotion").VideoConfig[]>;
-    internalRenderFrames: ({ browserExecutable, cancelSignal, chromiumOptions, composition, concurrency, envVariables, everyNthFrame, frameRange, imageFormat, indent, jpegQuality, muted, onBrowserLog, onDownload, onFrameBuffer, onFrameUpdate, onStart, outputDir, port, puppeteerInstance, scale, server, timeoutInMilliseconds, logLevel, webpackBundleOrServeUrl, serializedInputPropsWithCustomSchema, serializedResolvedPropsWithCustomSchema, }: import("./render-frames").InternalRenderFramesOptions) => Promise<import("./types").RenderFramesOutput>;
-    internalRenderMedia: ({ proResProfile, crf, composition, serializedInputPropsWithCustomSchema, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, }: import("./render-media").InternalRenderMediaOptions) => Promise<{
+    } & import("./options/option").ToOptions<readonly [{
+        name: string;
+        cliFlag: "offthreadvideo-cache-size-in-bytes";
+        description: JSX.Element;
+        ssrName: "offthreadVideoCacheSizeInBytes";
+        docLink: string;
+        type: number | null;
+    }]>) => Promise<import("remotion").VideoConfig[]>;
+    internalRenderFrames: ({ browserExecutable, cancelSignal, chromiumOptions, composition, concurrency, envVariables, everyNthFrame, frameRange, imageFormat, indent, jpegQuality, muted, onBrowserLog, onDownload, onFrameBuffer, onFrameUpdate, onStart, outputDir, port, puppeteerInstance, scale, server, timeoutInMilliseconds, logLevel, webpackBundleOrServeUrl, serializedInputPropsWithCustomSchema, serializedResolvedPropsWithCustomSchema, offthreadVideoCacheSizeInBytes, }: import("./render-frames").InternalRenderFramesOptions) => Promise<import("./types").RenderFramesOutput>;
+    internalRenderMedia: ({ proResProfile, x264Preset, crf, composition, serializedInputPropsWithCustomSchema, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, offthreadVideoCacheSizeInBytes, }: import("./render-media").InternalRenderMediaOptions) => Promise<{
         buffer: Buffer | null;
         slowestFrames: import("./render-media").SlowFrame[];
     }>;
     validOpenGlRenderers: readonly ["swangle", "angle", "egl", "swiftshader"];
-    copyImageToClipboard: (src: string, logLevel: "error" | "verbose" | "info" | "warn") => Promise<void>;
+    copyImageToClipboard: (src: string, logLevel: "verbose" | "info" | "warn" | "error") => Promise<void>;
 };

package/dist/is-beyond-last-frame.d.ts

@@ -0,0 +1,3 @@
+import type { DownloadMap } from './assets/download-map';
+export declare const isBeyondLastFrame: (downloadMap: DownloadMap, src: string, time: number) => boolean | 0;
+export declare const markAsBeyondLastFrame: (downloadMap: DownloadMap, src: string, time: number) => void;

package/dist/is-beyond-last-frame.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.markAsBeyondLastFrame = exports.isBeyondLastFrame = void 0;
+const isBeyondLastFrame = (downloadMap, src, time) => {
+    return (downloadMap.isBeyondLastFrameMap[src] &&
+        time >= downloadMap.isBeyondLastFrameMap[src]);
+};
+exports.isBeyondLastFrame = isBeyondLastFrame;
+const markAsBeyondLastFrame = (downloadMap, src, time) => {
+    downloadMap.isBeyondLastFrameMap[src] = time;
+};
+exports.markAsBeyondLastFrame = markAsBeyondLastFrame;

package/dist/last-frame-from-video-cache.d.ts

@@ -0,0 +1,17 @@
+import type { OffthreadVideoImageFormat } from 'remotion';
+import type { DownloadMap, SpecialVCodecForTransparency } from './assets/download-map';
+import type { FfmpegExecutable } from './ffmpeg-executable';
+export type LastFrameOptions = {
+    ffmpegExecutable: FfmpegExecutable;
+    ffprobeExecutable: FfmpegExecutable;
+    offset: number;
+    src: string;
+    specialVCodecForTransparency: SpecialVCodecForTransparency;
+    imageFormat: OffthreadVideoImageFormat;
+    needsResize: [number, number] | null;
+    downloadMap: DownloadMap;
+    remotionRoot: string;
+};
+export declare const setLastFrameInCache: (options: LastFrameOptions, data: Buffer) => void;
+export declare const getLastFrameFromCache: (options: LastFrameOptions) => Buffer | null;
+export declare const clearLastFileCache: (downloadMap: DownloadMap) => void;

package/dist/last-frame-from-video-cache.js

@@ -0,0 +1,55 @@
+"use strict";
+// OffthreadVideo requires sometimes that the last frame of a video gets extracted, however, this can be slow. We allocate a cache for it but that can be garbage collected
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearLastFileCache = exports.getLastFrameFromCache = exports.setLastFrameInCache = void 0;
+const MAX_CACHE_SIZE = 50 * 1024 * 1024; // 50MB
+let bufferSize = 0;
+const makeLastFrameCacheKey = (options) => {
+    return [
+        options.ffmpegExecutable,
+        options.offset,
+        options.src,
+        options.imageFormat,
+        options.downloadMap.id,
+    ].join('-');
+};
+const setLastFrameInCache = (options, data) => {
+    const key = makeLastFrameCacheKey(options);
+    if (options.downloadMap.lastFrameMap[key]) {
+        bufferSize -= options.downloadMap.lastFrameMap[key].data.byteLength;
+    }
+    options.downloadMap.lastFrameMap[key] = { data, lastAccessed: Date.now() };
+    bufferSize += data.byteLength;
+    ensureMaxSize(options.downloadMap);
+};
+exports.setLastFrameInCache = setLastFrameInCache;
+const getLastFrameFromCache = (options) => {
+    var _a;
+    const key = makeLastFrameCacheKey(options);
+    if (!options.downloadMap.lastFrameMap[key]) {
+        return null;
+    }
+    options.downloadMap.lastFrameMap[key].lastAccessed = Date.now();
+    return (_a = options.downloadMap.lastFrameMap[key].data) !== null && _a !== void 0 ? _a : null;
+};
+exports.getLastFrameFromCache = getLastFrameFromCache;
+const removedLastFrameFromCache = (key, downloadMap) => {
+    if (!downloadMap.lastFrameMap[key]) {
+        return;
+    }
+    bufferSize -= downloadMap.lastFrameMap[key].data.byteLength;
+    delete downloadMap.lastFrameMap[key];
+};
+const ensureMaxSize = (downloadMap) => {
+    // eslint-disable-next-line no-unmodified-loop-condition
+    while (bufferSize > MAX_CACHE_SIZE) {
+        const earliest = Object.entries(downloadMap.lastFrameMap).sort((a, b) => {
+            return a[1].lastAccessed - b[1].lastAccessed;
+        })[0];
+        removedLastFrameFromCache(earliest[0], downloadMap);
+    }
+};
+const clearLastFileCache = (downloadMap) => {
+    downloadMap.lastFrameMap = {};
+};
+exports.clearLastFileCache = clearLastFileCache;

package/dist/legacy-webpack-config.d.ts

@@ -0,0 +1,9 @@
+export type ServeUrlOrWebpackBundle = {
+    serveUrl: string;
+} | {
+    /**
+     * @deprecated Renamed to `serveUrl`
+     */
+    webpackBundle: string;
+};
+export declare const getServeUrlWithFallback: (serve: ServeUrlOrWebpackBundle) => string;

package/dist/legacy-webpack-config.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getServeUrlWithFallback = void 0;
+const getServeUrlWithFallback = (serve) => {
+    if ('webpackBundle' in serve) {
+        return serve.webpackBundle;
+    }
+    if ('serveUrl' in serve) {
+        return serve.serveUrl;
+    }
+    throw new Error('You must pass the `serveUrl` parameter');
+};
+exports.getServeUrlWithFallback = getServeUrlWithFallback;

package/dist/log-level.d.ts

@@ -1,4 +1,4 @@
 export declare const logLevels: readonly ["verbose", "info", "warn", "error"];
-export type LogLevel = typeof logLevels[number];
+export type LogLevel = (typeof logLevels)[number];
 export declare const isValidLogLevel: (level: string) => boolean;
 export declare const isEqualOrBelowLogLevel: (currentLevel: LogLevel, level: LogLevel) => boolean;

package/dist/logger.d.ts

@@ -19,6 +19,6 @@ export declare const Log: {
     error: (message?: any, ...optionalParams: any[]) => void;
     errorAdvanced: (options: VerboseLogOptions, message?: any, ...optionalParams: any[]) => void;
 };
-export declare const getLogLevel: () => "error" | "verbose" | "info" | "warn";
+export declare const getLogLevel: () => "verbose" | "info" | "warn" | "error";
 export declare const setLogLevel: (newLogLevel: LogLevel) => void;
 export {};

package/dist/offthread-video-server.d.ts

@@ -7,8 +7,9 @@ export declare const extractUrlAndSourceFromUrl: (url: string) => {
     time: number;
     transparent: boolean;
 };
-export declare const startOffthreadVideoServer: ({ downloadMap, concurrency, logLevel, indent, }: {
+export declare const startOffthreadVideoServer: ({ downloadMap, concurrency, logLevel, indent, offthreadVideoCacheSizeInBytes, }: {
     downloadMap: DownloadMap;
+    offthreadVideoCacheSizeInBytes: number | null;
     concurrency: number;
     logLevel: LogLevel;
     indent: boolean;

package/dist/offthread-video-server.js

@@ -6,6 +6,7 @@ const download_and_map_assets_to_file_1 = require("./assets/download-and-map-ass
 const compositor_1 = require("./compositor/compositor");
 const log_level_1 = require("./log-level");
 const logger_1 = require("./logger");
+const offthreadvideo_cache_size_1 = require("./options/offthreadvideo-cache-size");
 const extractUrlAndSourceFromUrl = (url) => {
     const parsed = new URL(url, 'http://localhost');
     const query = parsed.search;
@@ -30,10 +31,11 @@ const extractUrlAndSourceFromUrl = (url) => {
 };
 exports.extractUrlAndSourceFromUrl = extractUrlAndSourceFromUrl;
 const REQUEST_CLOSED_TOKEN = 'Request closed';
-const startOffthreadVideoServer = ({ downloadMap, concurrency, logLevel, indent, }) => {
+const startOffthreadVideoServer = ({ downloadMap, concurrency, logLevel, indent, offthreadVideoCacheSizeInBytes, }) => {
+    (0, offthreadvideo_cache_size_1.validateOffthreadVideoCacheSizeInBytes)(offthreadVideoCacheSizeInBytes);
     const compositor = (0, compositor_1.startCompositor)('StartLongRunningProcess', {
         concurrency,
-        maximum_frame_cache_items: (0, compositor_1.getIdealMaximumFrameCacheItems)(),
+        maximum_frame_cache_size_in_bytes: offthreadVideoCacheSizeInBytes !== null && offthreadVideoCacheSizeInBytes !== void 0 ? offthreadVideoCacheSizeInBytes : (0, compositor_1.getIdealMaximumFrameCacheSizeInBytes)(),
         verbose: (0, log_level_1.isEqualOrBelowLogLevel)(logLevel, 'verbose'),
     }, logLevel, indent);
     return {
@@ -67,6 +69,9 @@ const startOffthreadVideoServer = ({ downloadMap, concurrency, logLevel, indent,
             else {
                 response.setHeader('content-type', `image/bmp`);
             }
+            // Prevent caching of the response and excessive disk writes
+            // https://github.com/remotion-dev/remotion/issues/2760
+            response.setHeader('cache-control', 'no-cache, no-store, must-revalidate');
             // Handling this case on Lambda:
             // https://support.google.com/chrome/a/answer/7679408?hl=en
             // Chrome sends Private Network Access preflights for subresources

package/dist/open-browser.d.ts

@@ -3,7 +3,7 @@ import type { HeadlessBrowser } from './browser/Browser';
 import type { Viewport } from './browser/PuppeteerViewport';
 import { type LogLevel } from './log-level';
 declare const validRenderers: readonly ["swangle", "angle", "egl", "swiftshader"];
-type OpenGlRenderer = typeof validRenderers[number];
+type OpenGlRenderer = (typeof validRenderers)[number];
 export type ChromiumOptions = {
     ignoreCertificateErrors?: boolean;
     disableWebSecurity?: boolean;

package/dist/options/audio-bitrate.d.ts

@@ -1,2 +1,8 @@
-import type { RemotionOption } from './option';
-export declare const audioBitrateOption: RemotionOption;
+export declare const audioBitrateOption: {
+    name: string;
+    cliFlag: string;
+    description: JSX.Element;
+    ssrName: string;
+    docLink: string;
+    type: string;
+};

package/dist/options/audio-bitrate.js

@@ -8,4 +8,5 @@ exports.audioBitrateOption = {
     description: ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["Specify the target bitrate for the generated video. The syntax for FFMPEGs", (0, jsx_runtime_1.jsx)("code", { children: "-b:a" }), " parameter should be used. FFMPEG may encode the video in a way that will not result in the exact audio bitrate specified. Example values: ", (0, jsx_runtime_1.jsx)("code", { children: "512K" }), " for 512 kbps, ", (0, jsx_runtime_1.jsx)("code", { children: "1M" }), " for 1 Mbps. Default: ", (0, jsx_runtime_1.jsx)("code", { children: "320k" })] })),
     ssrName: 'audioBitrate',
     docLink: 'https://www.remotion.dev/docs/renderer/render-media#audiobitrate-',
+    type: '0',
 };

package/dist/options/crf.d.ts

@@ -1,2 +1,8 @@
-import type { RemotionOption } from './option';
-export declare const crfOption: RemotionOption;
+export declare const crfOption: {
+    name: string;
+    cliFlag: string;
+    description: JSX.Element;
+    ssrName: string;
+    docLink: string;
+    type: number;
+};

package/dist/options/crf.js

@@ -8,4 +8,5 @@ exports.crfOption = {
     description: ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: "No matter which codec you end up using, there's always a tradeoff between file size and video quality. You can control it by setting the CRF (Constant Rate Factor). The lower the number, the better the quality, the higher the number, the smaller the file is \u2013 of course at the cost of quality." })),
     ssrName: 'crf',
     docLink: 'https://www.remotion.dev/docs/encoding/#controlling-quality-using-the-crf-setting',
+    type: 0,
 };

package/dist/options/enforce-audio.d.ts

@@ -1,2 +1,8 @@
-import type { RemotionOption } from './option';
-export declare const enforceAudioOption: RemotionOption;
+export declare const enforceAudioOption: {
+    name: string;
+    cliFlag: string;
+    description: JSX.Element;
+    ssrName: string;
+    docLink: string;
+    type: boolean;
+};

package/dist/options/enforce-audio.js

@@ -8,4 +8,5 @@ exports.enforceAudioOption = {
     description: ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: "Render a silent audio track if there would be none otherwise." })),
     ssrName: 'enforceAudioTrack',
     docLink: 'https://www.remotion.dev/docs/config#setenforceaudiotrack-',
+    type: false,
 };

package/dist/options/jpeg-quality.d.ts

@@ -1,2 +1,8 @@
-import type { RemotionOption } from './option';
-export declare const jpegQualityOption: RemotionOption;
+export declare const jpegQualityOption: {
+    name: string;
+    cliFlag: string;
+    description: JSX.Element;
+    ssrName: string;
+    docLink: string;
+    type: number;
+};

package/dist/options/jpeg-quality.js

@@ -8,4 +8,5 @@ exports.jpegQualityOption = {
     description: ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: "Sets the quality of the generated JPEG images. Must be an integer between 0 and 100. Default: 80." })),
     ssrName: 'jpegQuality',
     docLink: 'https://www.remotion.dev/docs/renderer/render-media#jpeg-quality',
+    type: 0,
 };

package/dist/options/mute.d.ts

@@ -1,2 +1,8 @@
-import type { RemotionOption } from './option';
-export declare const muteOption: RemotionOption;
+export declare const muteOption: {
+    name: string;
+    cliFlag: string;
+    description: JSX.Element;
+    ssrName: string;
+    docLink: string;
+    type: boolean;
+};

package/dist/options/mute.js

@@ -8,4 +8,5 @@ exports.muteOption = {
     description: (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: "The Audio of the video will be omitted." }),
     ssrName: 'muted',
     docLink: 'https://www.remotion.dev/docs/using-audio/#muted-property',
+    type: false,
 };

package/dist/options/offthreadvideo-cache-size.d.ts

@@ -0,0 +1,9 @@
+export declare const offthreadVideoCacheSizeInBytesOption: {
+    name: string;
+    cliFlag: "offthreadvideo-cache-size-in-bytes";
+    description: JSX.Element;
+    ssrName: "offthreadVideoCacheSizeInBytes";
+    docLink: string;
+    type: number | null;
+};
+export declare const validateOffthreadVideoCacheSizeInBytes: (option: unknown) => void;

package/dist/options/offthreadvideo-cache-size.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateOffthreadVideoCacheSizeInBytes = exports.offthreadVideoCacheSizeInBytesOption = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+exports.offthreadVideoCacheSizeInBytesOption = {
+    name: 'OffthreadVideo cache size',
+    cliFlag: 'offthreadvideo-cache-size-in-bytes',
+    description: ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["From v4.0, Remotion has a cache for", ' ', (0, jsx_runtime_1.jsx)("a", { href: "https://remotion.dev/docs/offthreadvideo", children: (0, jsx_runtime_1.jsx)("code", { children: "<OffthreadVideo>" }) }), ' ', "frames. The default is ", (0, jsx_runtime_1.jsx)("code", { children: "null" }), ", corresponding to half of the system memory available when the render starts.", (0, jsx_runtime_1.jsx)("br", {}), " This option allows to override the size of the cache. The higher it is, the faster the render will be, but the more memory will be used.", (0, jsx_runtime_1.jsx)("br", {}), "The used value will be printed when running in verbose mode.", (0, jsx_runtime_1.jsx)("br", {}), "Default: ", (0, jsx_runtime_1.jsx)("code", { children: "null" })] })),
+    ssrName: 'offthreadVideoCacheSizeInBytes',
+    docLink: 'https://www.remotion.dev/docs/offthreadvideo',
+    type: 0,
+};
+const validateOffthreadVideoCacheSizeInBytes = (option) => {
+    if (option === undefined || option === null) {
+        return;
+    }
+    if (typeof option !== 'number') {
+        throw new Error('Expected a number');
+    }
+    if (option < 0) {
+        throw new Error('Expected a positive number');
+    }
+    if (Number.isNaN(option)) {
+        throw new Error('Expected a number');
+    }
+    if (!Number.isFinite(option)) {
+        throw new Error('Expected a finite number');
+    }
+    if (option % 1 !== 0) {
+        throw new Error('Expected a whole number');
+    }
+};
+exports.validateOffthreadVideoCacheSizeInBytes = validateOffthreadVideoCacheSizeInBytes;

package/dist/options/option.d.ts

@@ -1,8 +1,13 @@
 import type React from 'react';
-export type RemotionOption = {
+export type RemotionOption<SsrName extends string, Type> = {
     name: string;
     cliFlag: string;
-    ssrName: string;
+    ssrName: SsrName;
     description: React.ReactNode;
     docLink: string;
+    type: Type;
+};
+export type AnyRemotionOption = RemotionOption<string, unknown>;
+export type ToOptions<T extends readonly AnyRemotionOption[]> = {
+    [K in T[number]['ssrName']]: T[number]['type'];
 };