@remotion/renderer 4.0.113 → 4.0.115

package/dist/options/options-map.js

@@ -1,45 +1,79 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.optionsMap = void 0;
+const audio_bitrate_1 = require("./audio-bitrate");
+const color_space_1 = require("./color-space");
+const delete_after_1 = require("./delete-after");
+const encoding_buffer_size_1 = require("./encoding-buffer-size");
+const encoding_max_rate_1 = require("./encoding-max-rate");
+const jpeg_quality_1 = require("./jpeg-quality");
+const mute_1 = require("./mute");
 const number_of_gif_loops_1 = require("./number-of-gif-loops");
 const offthreadvideo_cache_size_1 = require("./offthreadvideo-cache-size");
 const repro_1 = require("./repro");
 const video_bitrate_1 = require("./video-bitrate");
+const video_codec_1 = require("./video-codec");
+const x264_preset_1 = require("./x264-preset");
 exports.optionsMap = {
     renderMedia: {
-        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytes,
-        videoBitrate: video_bitrate_1.videoBitrate,
+        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
+        videoBitrate: video_bitrate_1.videoBitrateOption,
         numberOfGifLoops: number_of_gif_loops_1.numberOfGifLoopsOption,
         repro: repro_1.reproOption,
+        x264Preset: x264_preset_1.x264Option,
+        audioBitrate: audio_bitrate_1.audioBitrateOption,
+        colorSpace: color_space_1.colorSpaceOption,
+        codec: video_codec_1.videoCodecOption,
+        jpegQuality: jpeg_quality_1.jpegQualityOption,
+        encodingMaxRate: encoding_max_rate_1.encodingMaxRateOption,
+        encodingBufferSize: encoding_buffer_size_1.encodingBufferSizeOption,
+        muted: mute_1.mutedOption,
     },
     renderStill: {
-        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytes,
+        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
+        jpegQuality: jpeg_quality_1.jpegQualityOption,
     },
     getCompositions: {
-        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytes,
+        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
     },
     selectComposition: {
-        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytes,
+        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
     },
     renderFrames: {
-        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytes,
+        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
+        jpegQuality: jpeg_quality_1.jpegQualityOption,
     },
     renderMediaOnLambda: {
-        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytes,
-        videoBitrate: video_bitrate_1.videoBitrate,
+        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
+        videoBitrate: video_bitrate_1.videoBitrateOption,
         numberOfGifLoops: number_of_gif_loops_1.numberOfGifLoopsOption,
+        audioBitrate: audio_bitrate_1.audioBitrateOption,
+        deleteAfter: delete_after_1.deleteAfterOption,
+        x264Preset: x264_preset_1.x264Option,
+        encodingMaxRate: encoding_max_rate_1.encodingMaxRateOption,
+        encodingBufferSize: encoding_buffer_size_1.encodingBufferSizeOption,
+        colorSpace: color_space_1.colorSpaceOption,
+        muted: mute_1.mutedOption,
     },
     renderStillOnLambda: {
-        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytes,
+        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
+        jpegQuality: jpeg_quality_1.jpegQualityOption,
     },
     getCompositionsOnLambda: {
-        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytes,
+        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
     },
     renderMediaOnCloudRun: {
-        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytes,
+        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
         numberOfGifLoops: number_of_gif_loops_1.numberOfGifLoopsOption,
+        colorSpace: color_space_1.colorSpaceOption,
+        audioBitrate: audio_bitrate_1.audioBitrateOption,
+        videoBitrate: video_bitrate_1.videoBitrateOption,
+        x264Preset: x264_preset_1.x264Option,
+        encodingMaxRate: encoding_max_rate_1.encodingMaxRateOption,
+        encodingBufferSize: encoding_buffer_size_1.encodingBufferSizeOption,
+        muted: mute_1.mutedOption,
     },
     renderStillOnCloudRun: {
-        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytes,
+        offthreadVideoCacheSizeInBytes: offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption,
     },
 };

package/dist/options/overwrite.d.ts

@@ -0,0 +1,15 @@
+export declare const overwriteOption: {
+    name: string;
+    cliFlag: "overwrite";
+    description: () => import("react/jsx-runtime").JSX.Element;
+    ssrName: string;
+    docLink: string;
+    type: boolean;
+    getValue: ({ commandLine }: {
+        commandLine: Record<string, unknown>;
+    }, defaultValue: boolean) => {
+        source: string;
+        value: boolean;
+    };
+    setConfig: (value: boolean) => void;
+};

package/dist/options/overwrite.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.overwriteOption = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+let shouldOverwrite = null;
+const cliFlag = 'overwrite';
+const validate = (value) => {
+    if (typeof value !== 'boolean') {
+        throw new Error(`overwriteExisting must be a boolean but got ${typeof value} (${value})`);
+    }
+};
+exports.overwriteOption = {
+    name: 'Overwrite output',
+    cliFlag,
+    description: () => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["If set to ", (0, jsx_runtime_1.jsx)("code", { children: "false" }), ", will prevent rendering to a path that already exists. Default is ", (0, jsx_runtime_1.jsx)("code", { children: "true" }), "."] })),
+    ssrName: 'overwrite',
+    docLink: 'https://www.remotion.dev/docs/config#setoverwriteoutput',
+    type: false,
+    getValue: ({ commandLine }, defaultValue) => {
+        if (commandLine[cliFlag] !== undefined) {
+            validate(commandLine[cliFlag]);
+            return {
+                source: 'cli',
+                value: commandLine[cliFlag],
+            };
+        }
+        if (shouldOverwrite !== null) {
+            return {
+                source: 'config',
+                value: shouldOverwrite,
+            };
+        }
+        return {
+            source: 'default',
+            value: defaultValue,
+        };
+    },
+    setConfig: (value) => {
+        validate(value);
+        shouldOverwrite = value;
+    },
+};

package/dist/options/repro.d.ts

@@ -1,8 +1,18 @@
 export declare const reproOption: {
     name: string;
-    cliFlag: string;
+    cliFlag: "repro";
     description: () => import("react/jsx-runtime").JSX.Element;
     ssrName: string;
     docLink: string;
     type: boolean;
+    getValue: ({ commandLine }: {
+        commandLine: Record<string, unknown>;
+    }) => {
+        value: true;
+        source: string;
+    } | {
+        value: false;
+        source: string;
+    };
+    setConfig: (should: boolean) => void;
 };

package/dist/options/repro.js

@@ -2,11 +2,35 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.reproOption = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
+let enableRepro = false;
+const setRepro = (should) => {
+    enableRepro = should;
+};
+const cliFlag = 'repro';
 exports.reproOption = {
     name: 'Create reproduction',
-    cliFlag: 'repro',
+    cliFlag,
     description: () => ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: "Create a ZIP that you can submit to Remotion if asked for a reproduction." })),
     ssrName: 'repro',
     docLink: 'https://www.remotion.dev/docs/render-media#repro',
     type: false,
+    getValue: ({ commandLine }) => {
+        if (commandLine[cliFlag] !== undefined) {
+            return {
+                value: true,
+                source: 'cli',
+            };
+        }
+        if (enableRepro) {
+            return {
+                value: enableRepro,
+                source: 'config',
+            };
+        }
+        return {
+            value: false,
+            source: 'default',
+        };
+    },
+    setConfig: setRepro,
 };

package/dist/options/scale.d.ts

@@ -5,4 +5,11 @@ export declare const scaleOption: {
     ssrName: string;
     docLink: string;
     type: number;
+    getValue: ({ commandLine }: {
+        commandLine: Record<string, unknown>;
+    }) => {
+        source: string;
+        value: number;
+    };
+    setConfig: (scale: number) => void;
 };

package/dist/options/scale.js

@@ -2,11 +2,40 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.scaleOption = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
+let currentScale = 1;
+const cliFlag = 'scale';
+const validateScale = (value) => {
+    if (typeof value !== 'number') {
+        throw new Error('scale must be a number.');
+    }
+};
 exports.scaleOption = {
     name: 'Scale',
-    cliFlag: 'scale',
+    cliFlag,
     description: () => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["Scales the output by a factor. For example, a 1280x720px frame will become a 1920x1080px frame with a scale factor of ", (0, jsx_runtime_1.jsx)("code", { children: "1.5" }), ". Vector elements like fonts and HTML markups will be rendered with extra details."] })),
     ssrName: 'scale',
     docLink: 'https://www.remotion.dev/docs/scaling',
     type: 0,
+    getValue: ({ commandLine }) => {
+        if (commandLine[cliFlag] !== undefined) {
+            validateScale(commandLine[cliFlag]);
+            return {
+                source: 'cli',
+                value: commandLine[cliFlag],
+            };
+        }
+        if (currentScale !== null) {
+            return {
+                source: 'config',
+                value: currentScale,
+            };
+        }
+        return {
+            source: 'default',
+            value: 1,
+        };
+    },
+    setConfig: (scale) => {
+        currentScale = scale;
+    },
 };

package/dist/options/timeout.d.ts

@@ -0,0 +1,15 @@
+export declare const delayRenderTimeoutInMillisecondsOption: {
+    name: string;
+    cliFlag: "timeout";
+    description: () => import("react/jsx-runtime").JSX.Element;
+    ssrName: "timeoutInMilliseconds";
+    docLink: string;
+    type: number;
+    getValue: ({ commandLine }: {
+        commandLine: Record<string, unknown>;
+    }) => {
+        source: string;
+        value: number;
+    };
+    setConfig: (value: number) => void;
+};

package/dist/options/timeout.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.delayRenderTimeoutInMillisecondsOption = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const TimeoutSettings_1 = require("../browser/TimeoutSettings");
+let currentTimeout = TimeoutSettings_1.DEFAULT_TIMEOUT;
+const validate = (value) => {
+    if (typeof value !== 'number') {
+        throw new Error('--timeout flag / setDelayRenderTimeoutInMilliseconds() must be a number, but got ' +
+            JSON.stringify(value));
+    }
+};
+const cliFlag = 'timeout';
+exports.delayRenderTimeoutInMillisecondsOption = {
+    name: 'delayRender() timeout',
+    cliFlag,
+    description: () => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["A number describing how long the render may take to resolve all", ' ', (0, jsx_runtime_1.jsx)("a", { href: "https://remotion.dev/docs/delay-render", children: (0, jsx_runtime_1.jsx)("code", { children: "delayRender()" }) }), ' ', "calls ", (0, jsx_runtime_1.jsx)("a", { href: "https://remotion.dev/docs/timeout", children: "before it times out" }), ". Default: ", (0, jsx_runtime_1.jsx)("code", { children: "30000" })] })),
+    ssrName: 'timeoutInMilliseconds',
+    docLink: 'https://www.remotion.dev/docs/timeout',
+    type: 0,
+    getValue: ({ commandLine }) => {
+        if (commandLine[cliFlag] !== undefined) {
+            return {
+                source: 'cli',
+                value: commandLine[cliFlag],
+            };
+        }
+        if (currentTimeout !== null) {
+            validate(currentTimeout);
+            return {
+                source: 'config',
+                value: currentTimeout,
+            };
+        }
+        return {
+            source: 'default',
+            value: TimeoutSettings_1.DEFAULT_TIMEOUT,
+        };
+    },
+    setConfig: (value) => {
+        validate(value);
+        currentTimeout = value;
+    },
+};

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

@@ -1,8 +1,15 @@
-export declare const videoBitrate: {
+export declare const videoBitrateOption: {
     name: string;
-    cliFlag: string;
+    cliFlag: "video-bitrate";
     description: () => import("react/jsx-runtime").JSX.Element;
     ssrName: string;
     docLink: string;
     type: string | null;
+    getValue: ({ commandLine }: {
+        commandLine: Record<string, unknown>;
+    }) => {
+        source: string;
+        value: string | null;
+    };
+    setConfig: (bitrate: string | null) => void;
 };

package/dist/options/video-bitrate.js

@@ -1,12 +1,35 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.videoBitrate = void 0;
+exports.videoBitrateOption = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
-exports.videoBitrate = {
+let videoBitrate = null;
+const cliFlag = 'video-bitrate';
+exports.videoBitrateOption = {
     name: 'Video Bitrate',
-    cliFlag: 'video-bitrate',
-    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:v" }), " parameter should be used. FFMPEG may encode the video in a way that will not result in the exact video 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."] })),
+    cliFlag,
+    description: () => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["Specify the target bitrate for the generated video. The syntax for FFmpeg", "'", "s", (0, jsx_runtime_1.jsx)("code", { children: "-b:v" }), " parameter should be used. FFmpeg may encode the video in a way that will not result in the exact video 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."] })),
     ssrName: 'videoBitrate',
     docLink: 'https://www.remotion.dev/docs/renderer/render-media#videobitrate-',
     type: '',
+    getValue: ({ commandLine }) => {
+        if (commandLine[cliFlag] !== undefined) {
+            return {
+                source: 'cli',
+                value: commandLine[cliFlag],
+            };
+        }
+        if (videoBitrate !== null) {
+            return {
+                source: 'config',
+                value: videoBitrate,
+            };
+        }
+        return {
+            source: 'default',
+            value: null,
+        };
+    },
+    setConfig: (bitrate) => {
+        videoBitrate = bitrate;
+    },
 };

package/dist/options/video-codec.d.ts

@@ -1,8 +1,23 @@
+import type { Codec, CodecOrUndefined } from '../codec';
+export declare const getOutputCodecOrUndefined: () => CodecOrUndefined;
 export declare const videoCodecOption: {
     name: string;
     cliFlag: "codec";
     description: () => import("react/jsx-runtime").JSX.Element;
     ssrName: string;
     docLink: string;
-    type: string;
+    type: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif";
+    getValue: ({ commandLine }: {
+        commandLine: Record<string, unknown>;
+    }, { compositionCodec, configFile, downloadName, outName, uiCodec, }: {
+        outName: string | null;
+        downloadName: string | null;
+        configFile: Codec | null;
+        uiCodec: Codec | null;
+        compositionCodec: Codec | null;
+    }) => {
+        value: Codec;
+        source: string;
+    };
+    setConfig: (newCodec: CodecOrUndefined) => void;
 };

package/dist/options/video-codec.js

@@ -1,12 +1,91 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.videoCodecOption = void 0;
+exports.videoCodecOption = exports.getOutputCodecOrUndefined = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
+const codec_1 = require("../codec");
+const get_extension_from_codec_1 = require("../get-extension-from-codec");
+const get_extension_of_filename_1 = require("../get-extension-of-filename");
+let codec;
+const setCodec = (newCodec) => {
+    if (newCodec === undefined) {
+        codec = undefined;
+        return;
+    }
+    if (!codec_1.validCodecs.includes(newCodec)) {
+        throw new Error(`Codec must be one of the following: ${codec_1.validCodecs.join(', ')}, but got ${newCodec}`);
+    }
+    codec = newCodec;
+};
+const getOutputCodecOrUndefined = () => {
+    return codec;
+};
+exports.getOutputCodecOrUndefined = getOutputCodecOrUndefined;
+const deriveCodecsFromFilename = (extension) => {
+    var _a, _b;
+    if (extension === null) {
+        return { possible: [], default: null };
+    }
+    return {
+        default: (_a = get_extension_from_codec_1.defaultCodecsForFileExtension[extension]) !== null && _a !== void 0 ? _a : null,
+        possible: (_b = (0, get_extension_from_codec_1.makeFileExtensionMap)()[extension]) !== null && _b !== void 0 ? _b : [],
+    };
+};
+const cliFlag = 'codec';
 exports.videoCodecOption = {
     name: 'Codec',
-    cliFlag: 'codec',
+    cliFlag,
     description: () => ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: "H264 works well in most cases, but sometimes it's worth going for a different codec. WebM achieves higher compression but is slower to render. WebM, GIF and ProRes support transparency." })),
     ssrName: 'codec',
     docLink: 'https://www.remotion.dev/docs/encoding/#choosing-a-codec',
     type: '',
+    getValue: ({ commandLine }, { compositionCodec, configFile, downloadName, outName, uiCodec, }) => {
+        if (uiCodec) {
+            return { value: uiCodec, source: 'via UI' };
+        }
+        const downloadNameExtension = (0, get_extension_of_filename_1.getExtensionOfFilename)(downloadName);
+        const outNameExtension = (0, get_extension_of_filename_1.getExtensionOfFilename)(outName);
+        const derivedDownloadCodecs = deriveCodecsFromFilename(downloadNameExtension);
+        const derivedOutNameCodecs = deriveCodecsFromFilename(outNameExtension);
+        if (derivedDownloadCodecs.possible.length > 0 &&
+            derivedOutNameCodecs.possible.length > 0 &&
+            derivedDownloadCodecs.possible.join('') !==
+                derivedOutNameCodecs.possible.join('')) {
+            throw new TypeError(`The download name is ${downloadName} but the output name is ${outName}. The file extensions must match`);
+        }
+        const cliArgument = commandLine[cliFlag];
+        if (cliArgument) {
+            if (derivedDownloadCodecs.possible.length > 0 &&
+                derivedDownloadCodecs.possible.indexOf(cliArgument) === -1) {
+                throw new TypeError(`The download name is ${downloadName} but --codec=${cliArgument} was passed. The download name implies a codec of ${derivedDownloadCodecs.possible.join(' or ')} which does not align with the --codec flag.`);
+            }
+            if (derivedOutNameCodecs.possible.length > 0 &&
+                derivedOutNameCodecs.possible.indexOf(cliArgument) === -1) {
+                throw new TypeError(`The out name is ${outName} but --codec=${cliArgument} was passed. The out name implies a codec of ${derivedOutNameCodecs.possible.join(' or ')} which does not align with the --codec flag.`);
+            }
+            return { value: cliArgument, source: 'from --codec flag' };
+        }
+        if (derivedDownloadCodecs.possible.length > 0) {
+            return {
+                value: derivedDownloadCodecs.default,
+                source: 'derived from download name',
+            };
+        }
+        if (derivedOutNameCodecs.possible.length > 0) {
+            return {
+                value: derivedOutNameCodecs.default,
+                source: 'derived from out name',
+            };
+        }
+        if (compositionCodec) {
+            return { value: compositionCodec, source: 'via calculateMetadata' };
+        }
+        if (configFile) {
+            return {
+                value: configFile,
+                source: 'Config file',
+            };
+        }
+        return { value: codec_1.DEFAULT_CODEC, source: 'default' };
+    },
+    setConfig: setCodec,
 };

package/dist/options/webhook-custom-data.d.ts

@@ -1,8 +1,10 @@
 export declare const webhookCustomDataOption: {
     name: string;
     cliFlag: "webhook-custom-data";
-    description: (type: "ssr" | "cli") => import("react/jsx-runtime").JSX.Element;
+    description: (type: "cli" | "ssr") => import("react/jsx-runtime").JSX.Element;
     ssrName: "customData";
     docLink: string;
     type: Record<string, unknown> | null;
+    getValue: () => never;
+    setConfig: () => never;
 };

package/dist/options/webhook-custom-data.js

@@ -2,13 +2,20 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.webhookCustomDataOption = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
+const cliFlag = 'webhook-custom-data';
 exports.webhookCustomDataOption = {
     name: 'Webhook custom data',
-    cliFlag: 'webhook-custom-data',
+    cliFlag,
     description: (type) => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["Pass up to 1,024 bytes of a JSON-serializable object to the webhook. This data will be included in the webhook payload.", ' ', type === 'cli'
                 ? 'Alternatively, pass a file path pointing to a JSON file'
                 : null] })),
     ssrName: 'customData',
     docLink: 'https://www.remotion.dev/docs/lambda/webhooks',
     type: {},
+    getValue: () => {
+        throw new Error('Option resolution not implemented');
+    },
+    setConfig: () => {
+        throw new Error('Not implemented');
+    },
 };

package/dist/options/x264-preset.d.ts

@@ -1,8 +1,25 @@
-export declare const offthreadVideoCacheSizeInBytes: {
+import type { Codec } from '../codec';
+export declare const x264PresetOptions: readonly ["ultrafast", "superfast", "veryfast", "faster", "fast", "medium", "slow", "slower", "veryslow", "placebo"];
+export type X264Preset = (typeof x264PresetOptions)[number];
+export declare const validateSelectedCodecAndPresetCombination: ({ codec, x264Preset, }: {
+    codec: Codec;
+    x264Preset: X264Preset | null;
+}) => void;
+export declare const x264Option: {
     name: string;
     cliFlag: "x264-preset";
     description: () => import("react/jsx-runtime").JSX.Element;
-    ssrName: "offthreadVideoCacheSizeInBytes";
+    ssrName: "x264Preset";
     docLink: string;
-    type: number | null;
+    type: "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "medium" | "slow" | "slower" | "veryslow" | "placebo" | null;
+    getValue: ({ commandLine }: {
+        commandLine: Record<string, unknown>;
+    }) => {
+        value: "ultrafast" | "superfast" | "veryfast" | "faster" | "fast" | "medium" | "slow" | "slower" | "veryslow" | "placebo";
+        source: string;
+    } | {
+        value: null;
+        source: string;
+    };
+    setConfig: (profile: X264Preset | null) => void;
 };

package/dist/options/x264-preset.js

@@ -1,12 +1,52 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.offthreadVideoCacheSizeInBytes = void 0;
+exports.x264Option = exports.validateSelectedCodecAndPresetCombination = exports.x264PresetOptions = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
-exports.offthreadVideoCacheSizeInBytes = {
+exports.x264PresetOptions = [
+    'ultrafast',
+    'superfast',
+    'veryfast',
+    'faster',
+    'fast',
+    'medium',
+    'slow',
+    'slower',
+    'veryslow',
+    'placebo',
+];
+let preset = null;
+const validateSelectedCodecAndPresetCombination = ({ codec, x264Preset, }) => {
+    if (x264Preset !== null && codec !== 'h264' && codec !== 'h264-mkv') {
+        throw new TypeError(`You have set a x264 preset but the codec is "${codec}". Set the codec to "h264" or remove the Preset profile.`);
+    }
+    if (x264Preset !== null &&
+        !exports.x264PresetOptions.includes(x264Preset)) {
+        throw new TypeError(`The Preset profile "${x264Preset}" is not valid. Valid options are ${exports.x264PresetOptions
+            .map((p) => `"${p}"`)
+            .join(', ')}`);
+    }
+};
+exports.validateSelectedCodecAndPresetCombination = validateSelectedCodecAndPresetCombination;
+const cliFlag = 'x264-preset';
+const DEFAULT_PRESET = 'medium';
+exports.x264Option = {
     name: 'x264 Preset',
-    cliFlag: 'x264-preset',
-    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,
+    cliFlag,
+    description: () => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["Sets a x264 preset profile. Only applies to videos rendered with", ' ', (0, jsx_runtime_1.jsx)("code", { children: "h264" }), " codec.", (0, jsx_runtime_1.jsx)("br", {}), "Possible values: ", (0, jsx_runtime_1.jsx)("code", { children: "superfast" }), ", ", (0, jsx_runtime_1.jsx)("code", { children: "veryfast" }), ",", ' ', (0, jsx_runtime_1.jsx)("code", { children: "faster" }), ", ", (0, jsx_runtime_1.jsx)("code", { children: "fast" }), ", ", (0, jsx_runtime_1.jsx)("code", { children: "medium" }), ",", ' ', (0, jsx_runtime_1.jsx)("code", { children: "slow" }), ", ", (0, jsx_runtime_1.jsx)("code", { children: "slower" }), ", ", (0, jsx_runtime_1.jsx)("code", { children: "veryslow" }), ",", ' ', (0, jsx_runtime_1.jsx)("code", { children: "placebo" }), ".", (0, jsx_runtime_1.jsx)("br", {}), "Default: ", (0, jsx_runtime_1.jsx)("code", { children: DEFAULT_PRESET })] })),
+    ssrName: 'x264Preset',
+    docLink: 'https://www.remotion.dev/docs/renderer/render-media',
+    type: 'fast',
+    getValue: ({ commandLine }) => {
+        const value = commandLine[cliFlag];
+        if (typeof value !== 'undefined') {
+            return { value: value, source: 'cli' };
+        }
+        if (preset !== null) {
+            return { value: preset, source: 'config' };
+        }
+        return { value: null, source: 'default' };
+    },
+    setConfig: (profile) => {
+        preset = profile;
+    },
 };

package/dist/path-normalize.d.ts

@@ -0,0 +1 @@
+export declare const pathNormalize: (p: string) => string;