@remotion/cli 4.0.0-umungobongo.4 → 4.0.0-webhook.25

package/dist/benchmark.d.ts

@@ -0,0 +1 @@
+export declare const benchmarkCommand: (remotionRoot: string, args: string[]) => Promise<void>;

package/dist/benchmark.js

@@ -0,0 +1,180 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.benchmarkCommand = void 0;
+const renderer_1 = require("@remotion/renderer");
+const path_1 = __importDefault(require("path"));
+const chalk_1 = require("./chalk");
+const config_1 = require("./config");
+const get_cli_options_1 = require("./get-cli-options");
+const get_render_media_options_1 = require("./get-render-media-options");
+const log_1 = require("./log");
+const make_progress_bar_1 = require("./make-progress-bar");
+const parse_command_line_1 = require("./parse-command-line");
+const progress_bar_1 = require("./progress-bar");
+const setup_cache_1 = require("./setup-cache");
+const truthy_1 = require("./truthy");
+const DEFAULT_RUNS = 3;
+const getValidConcurrency = (renderMediaOptions) => {
+    var _a;
+    const concurrency = 'concurrency' in renderMediaOptions
+        ? (_a = renderMediaOptions.concurrency) !== null && _a !== void 0 ? _a : null
+        : null;
+    const { concurrencies } = parse_command_line_1.parsedCli;
+    if (!concurrencies) {
+        return [renderer_1.RenderInternals.getActualConcurrency(concurrency)];
+    }
+    return concurrencies
+        .split(',')
+        .map((c) => parseInt(c.trim(), 10));
+};
+const runBenchmark = async (runs, options, onProgress) => {
+    const timeTaken = [];
+    for (let run = 0; run < runs; ++run) {
+        const startTime = performance.now();
+        await (0, renderer_1.renderMedia)({
+            ...options,
+            onProgress: ({ progress }) => onProgress === null || onProgress === void 0 ? void 0 : onProgress(run, progress),
+        });
+        const endTime = performance.now();
+        timeTaken.push(endTime - startTime);
+    }
+    return timeTaken;
+};
+const formatTime = (time) => {
+    let ret = '';
+    const hours = Math.floor(time / (60 * 60 * 1000));
+    if (hours) {
+        ret = `${hours}h`;
+    }
+    time %= 60 * 60 * 1000;
+    const minutes = Math.floor(time / (60 * 1000));
+    if (minutes) {
+        ret = `${ret}${minutes}m`;
+    }
+    time %= 60 * 1000;
+    const seconds = (time / 1000).toFixed(5);
+    if (seconds) {
+        ret = `${ret}${seconds}s`;
+    }
+    return ret;
+};
+const avg = (time) => time.reduce((prev, curr) => prev + curr) / time.length;
+const stdDev = (time) => {
+    const mean = avg(time);
+    return Math.sqrt(time.map((x) => (x - mean) ** 2).reduce((a, b) => a + b) / time.length);
+};
+const getResults = (results, runs) => {
+    const mean = avg(results);
+    const dev = stdDev(results);
+    const max = Math.max(...results);
+    const min = Math.min(...results);
+    return `    Time (${chalk_1.chalk.green('mean')} ± ${chalk_1.chalk.green('σ')}):         ${chalk_1.chalk.green(formatTime(mean))} ± ${chalk_1.chalk.green(formatTime(dev))}\n    Range (${chalk_1.chalk.blue('min')} ... ${chalk_1.chalk.red('max')}):     ${chalk_1.chalk.blue(formatTime(min))} ... ${chalk_1.chalk.red(formatTime(max))} \t ${chalk_1.chalk.gray(`${runs} runs`)}
+	`;
+};
+const makeBenchmarkProgressBar = ({ totalRuns, run, progress, doneIn, }) => {
+    const totalProgress = (run + progress) / totalRuns;
+    return [
+        `Rendering (${run + 1} out of ${totalRuns} runs)`,
+        (0, make_progress_bar_1.makeProgressBar)(totalProgress),
+        doneIn === null
+            ? `${(totalProgress * 100).toFixed(2)}% `
+            : chalk_1.chalk.gray(doneIn),
+    ].join(' ');
+};
+const benchmarkCommand = async (remotionRoot, args) => {
+    var _a, _b;
+    const runs = (_a = parse_command_line_1.parsedCli.runs) !== null && _a !== void 0 ? _a : DEFAULT_RUNS;
+    const filePath = args[0];
+    if (!filePath) {
+        log_1.Log.error('No entry file passed.');
+        log_1.Log.info('Pass an additional argument specifying the entry file');
+        log_1.Log.info();
+        log_1.Log.info(`$ remotion benchmark <entry file>`);
+        process.exit(1);
+    }
+    const fullPath = path_1.default.join(process.cwd(), filePath);
+    const { inputProps, envVariables, browserExecutable, ffmpegExecutable, ffprobeExecutable, chromiumOptions, port, puppeteerTimeout, browser, scale, publicDir, } = await (0, get_cli_options_1.getCliOptions)({
+        isLambda: false,
+        type: 'series',
+        codec: 'h264',
+    });
+    const browserInstance = (0, renderer_1.openBrowser)(browser, {
+        browserExecutable,
+        shouldDumpIo: renderer_1.RenderInternals.isEqualOrBelowLogLevel(config_1.ConfigInternals.Logging.getLogLevel(), 'verbose'),
+        chromiumOptions,
+        forceDeviceScaleFactor: scale,
+    });
+    const { urlOrBundle: bundleLocation, cleanup: cleanupBundle } = await (0, setup_cache_1.bundleOnCliOrTakeServeUrl)({
+        fullPath,
+        publicDir,
+        remotionRoot,
+        steps: ['bundling'],
+    });
+    const puppeteerInstance = await browserInstance;
+    const comps = await (0, renderer_1.getCompositions)(bundleLocation, {
+        inputProps,
+        envVariables,
+        chromiumOptions,
+        timeoutInMilliseconds: puppeteerTimeout,
+        ffmpegExecutable,
+        ffprobeExecutable,
+        port,
+        puppeteerInstance,
+    });
+    const ids = ((_b = args[1]) !== null && _b !== void 0 ? _b : '')
+        .split(',')
+        .map((c) => c.trim())
+        .filter(truthy_1.truthy);
+    const compositions = ids.map((compId) => {
+        const composition = comps.find((c) => c.id === compId);
+        if (!composition) {
+            throw new Error(`No composition with the ID "${compId}" found.`);
+        }
+        return composition;
+    });
+    if (compositions.length === 0) {
+        log_1.Log.error('No composition IDs passed. Add another argument to the command specifying at least 1 composition ID.');
+    }
+    const benchmark = {};
+    let count = 1;
+    const { codec, reason: codecReason } = (0, get_cli_options_1.getFinalCodec)({
+        downloadName: null,
+        outName: null,
+    });
+    for (const composition of compositions) {
+        const renderMediaOptions = await (0, get_render_media_options_1.getRenderMediaOptions)({
+            config: composition,
+            outputLocation: undefined,
+            serveUrl: bundleLocation,
+            codec,
+        });
+        const concurrency = getValidConcurrency(renderMediaOptions);
+        benchmark[composition.id] = {};
+        for (const con of concurrency) {
+            const benchmarkProgress = (0, progress_bar_1.createOverwriteableCliOutput)((0, parse_command_line_1.quietFlagProvided)());
+            log_1.Log.info();
+            log_1.Log.info(`${chalk_1.chalk.bold(`Benchmark #${count++}:`)} ${chalk_1.chalk.gray(`composition=${composition.id} concurrency=${con} codec=${codec} (${codecReason})`)}`);
+            const timeTaken = await runBenchmark(runs, {
+                ...renderMediaOptions,
+                puppeteerInstance,
+                concurrency: con,
+            }, (run, progress) => {
+                benchmarkProgress.update(makeBenchmarkProgressBar({
+                    totalRuns: runs,
+                    run,
+                    doneIn: null,
+                    progress,
+                }));
+            });
+            benchmarkProgress.update('');
+            benchmarkProgress.update(getResults(timeTaken, runs));
+            benchmark[composition.id][`${con}`] = timeTaken;
+        }
+    }
+    log_1.Log.info();
+    await cleanupBundle();
+};
+exports.benchmarkCommand = benchmarkCommand;

package/dist/compositions.js

@@ -27,7 +27,7 @@ const max = (arr) => {
 const listCompositionsCommand = async (remotionRoot) => {
     const file = parse_command_line_1.parsedCli._[1];
     if (!file) {
-        log_1.Log.error('The `compositions` command requires you to specify a root file. For example');
+        log_1.Log.error('The `compositions` command requires you to specify a entry point. For example');
         log_1.Log.error('  npx remotion compositions src/index.tsx');
         log_1.Log.error('See https://www.remotion.dev/docs/register-root for more information.');
         process.exit(1);
@@ -35,14 +35,16 @@ const listCompositionsCommand = async (remotionRoot) => {
     const downloadMap = renderer_1.RenderInternals.makeDownloadMap();
     const fullPath = path_1.default.join(process.cwd(), file);
     await (0, get_config_file_name_1.loadConfig)(remotionRoot);
-    const { browserExecutable, ffmpegExecutable, ffprobeExecutable, chromiumOptions, envVariables, inputProps, puppeteerTimeout, port, } = await (0, get_cli_options_1.getCliOptions)({
+    const { browserExecutable, ffmpegExecutable, ffprobeExecutable, chromiumOptions, envVariables, inputProps, puppeteerTimeout, port, publicDir, } = await (0, get_cli_options_1.getCliOptions)({
         isLambda: false,
         type: 'get-compositions',
+        codec: 'h264',
     });
     const { urlOrBundle: bundled, cleanup: cleanupBundle } = await (0, setup_cache_1.bundleOnCliOrTakeServeUrl)({
         remotionRoot,
         fullPath,
         steps: ['bundling'],
+        publicDir,
     });
     const compositions = await (0, renderer_1.getCompositions)(bundled, {
         browserExecutable,

package/dist/config/enforce-audio-track.d.ts

@@ -0,0 +1,2 @@
+export declare const setEnforceAudioTrack: (enforceAudioTrack: boolean) => void;
+export declare const getEnforceAudioTrack: () => boolean;

package/dist/config/enforce-audio-track.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEnforceAudioTrack = exports.setEnforceAudioTrack = void 0;
+const DEFAULT_ENFORCE_AUDIO_TRACK = true;
+let enforceAudioTrackState = DEFAULT_ENFORCE_AUDIO_TRACK;
+const setEnforceAudioTrack = (enforceAudioTrack) => {
+    enforceAudioTrackState = enforceAudioTrack;
+};
+exports.setEnforceAudioTrack = setEnforceAudioTrack;
+const getEnforceAudioTrack = () => {
+    return enforceAudioTrackState;
+};
+exports.getEnforceAudioTrack = getEnforceAudioTrack;

package/dist/config/ffmpeg-override.d.ts

@@ -0,0 +1,3 @@
+import type { FfmpegOverrideFn } from '@remotion/renderer';
+export declare const setFfmpegOverrideFunction: (fn: FfmpegOverrideFn) => void;
+export declare const getFfmpegOverrideFunction: () => FfmpegOverrideFn;

package/dist/config/ffmpeg-override.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFfmpegOverrideFunction = exports.setFfmpegOverrideFunction = void 0;
+let ffmpegOverrideFn = ({ args }) => args;
+const setFfmpegOverrideFunction = (fn) => {
+    ffmpegOverrideFn = fn;
+};
+exports.setFfmpegOverrideFunction = setFfmpegOverrideFunction;
+const getFfmpegOverrideFunction = () => {
+    return ffmpegOverrideFn;
+};
+exports.getFfmpegOverrideFunction = getFfmpegOverrideFunction;

package/dist/config/image-format.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getUserPreferredImageFormat = exports.setImageFormat = void 0;
 const renderer_1 = require("@remotion/renderer");
+const truthy_1 = require("../truthy");
 let currentImageFormat;
 const setImageFormat = (format) => {
     if (typeof format === 'undefined') {
@@ -9,7 +10,13 @@ const setImageFormat = (format) => {
         return;
     }
     if (!renderer_1.RenderInternals.validImageFormats.includes(format)) {
-        throw new TypeError(`Value ${format} is not valid as an image format.`);
+        throw new TypeError([
+            `Value ${format} is not valid as an image format.`,
+            // @ts-expect-error
+            format === 'jpg' ? 'Did you mean "jpeg"?' : null,
+        ]
+            .filter(truthy_1.truthy)
+            .join(' '));
     }
     currentImageFormat = format;
 };

package/dist/config/index.d.ts

@@ -13,7 +13,9 @@ export declare const ConfigInternals: {
     getActualCrf: (codec: "h264" | "h265" | "vp8" | "vp9" | "mp3" | "aac" | "wav" | "prores" | "h264-mkv" | "gif") => number;
     getPixelFormat: () => "yuv420p" | "yuva420p" | "yuv422p" | "yuv444p" | "yuv420p10le" | "yuv422p10le" | "yuv444p10le" | "yuva444p10le";
     getProResProfile: () => "4444-xq" | "4444" | "hq" | "standard" | "light" | "proxy" | undefined;
-    getShouldOverwrite: () => boolean;
+    getShouldOverwrite: ({ defaultValue, }: {
+        defaultValue: boolean;
+    }) => boolean;
     getBrowserExecutable: () => import("@remotion/renderer").BrowserExecutable;
     getCustomFfprobeExecutable: () => import("@remotion/renderer").FfmpegExecutable;
     getScale: () => number;
@@ -39,5 +41,12 @@ export declare const ConfigInternals: {
     setStillFrame: (frame: number) => void;
     getMaxTimelineTracks: () => number;
     defaultOverrideFunction: WebpackOverrideFn;
+    setMuted: (muted: boolean) => void;
+    getMuted: () => boolean;
+    getEnforceAudioTrack: () => boolean;
+    setEnforceAudioTrack: (enforceAudioTrack: boolean) => void;
+    getKeyboardShortcutsEnabled: () => boolean;
+    getPublicDir: () => string | null;
+    getFfmpegOverrideFunction: () => import("@remotion/renderer").FfmpegOverrideFn;
 };
 export declare const overrideRemotion: () => void;

package/dist/config/index.js

@@ -57,14 +57,18 @@ const chromium_flags_2 = require("./chromium-flags");
 const codec_2 = require("./codec");
 const concurrency_2 = require("./concurrency");
 const crf_2 = require("./crf");
+const enforce_audio_track_1 = require("./enforce-audio-track");
 const env_file_2 = require("./env-file");
 const every_nth_frame_2 = require("./every-nth-frame");
 const ffmpeg_executable_2 = require("./ffmpeg-executable");
+const ffmpeg_override_1 = require("./ffmpeg-override");
 const frame_range_2 = require("./frame-range");
 const image_format_2 = require("./image-format");
 const image_sequence_2 = require("./image-sequence");
+const keyboard_shortcuts_1 = require("./keyboard-shortcuts");
 const log_1 = require("./log");
 const max_timeline_tracks_2 = require("./max-timeline-tracks");
+const muted_1 = require("./muted");
 const number_of_gif_loops_2 = require("./number-of-gif-loops");
 const output_location_2 = require("./output-location");
 const override_webpack_2 = require("./override-webpack");
@@ -72,6 +76,7 @@ const overwrite_2 = require("./overwrite");
 const pixel_format_2 = require("./pixel-format");
 const preview_server_2 = require("./preview-server");
 const prores_profile_2 = require("./prores-profile");
+const public_dir_1 = require("./public-dir");
 const quality_2 = require("./quality");
 const scale_2 = require("./scale");
 const timeout_2 = require("./timeout");
@@ -79,11 +84,13 @@ const webpack_caching_2 = require("./webpack-caching");
 exports.Config = {
     Preview: {
         setMaxTimelineTracks: max_timeline_tracks_2.setMaxTimelineTracks,
+        setKeyboardShortcutsEnabled: keyboard_shortcuts_1.setKeyboardShortcutsEnabled,
     },
     Bundling: {
         overrideWebpackConfig: override_webpack_2.overrideWebpackConfig,
         setCachingEnabled: webpack_caching_2.setWebpackCaching,
         setPort: preview_server_2.setPort,
+        setPublicDir: public_dir_1.setPublicDir,
     },
     Log: {
         setLevel: log_1.setLogLevel,
@@ -107,6 +114,8 @@ exports.Config = {
         setScale: scale_2.setScale,
         setEveryNthFrame: every_nth_frame_2.setEveryNthFrame,
         setNumberOfGifLoops: number_of_gif_loops_2.setNumberOfGifLoops,
+        setMuted: muted_1.setMuted,
+        setEnforceAudioTrack: enforce_audio_track_1.setEnforceAudioTrack,
     },
     Output: {
         setOutputLocation: output_location_2.setOutputLocation,
@@ -117,6 +126,7 @@ exports.Config = {
         setCrf: crf_2.setCrf,
         setImageSequence: image_sequence_2.setImageSequence,
         setProResProfile: prores_profile_2.setProResProfile,
+        overrideFfmpegCommand: ffmpeg_override_1.setFfmpegOverrideFunction,
     },
 };
 // eslint-disable-next-line no-restricted-imports
@@ -154,6 +164,13 @@ exports.ConfigInternals = {
     setStillFrame: still_frame_1.setStillFrame,
     getMaxTimelineTracks: max_timeline_tracks_1.getMaxTimelineTracks,
     defaultOverrideFunction: override_webpack_1.defaultOverrideFunction,
+    setMuted: muted_1.setMuted,
+    getMuted: muted_1.getMuted,
+    getEnforceAudioTrack: enforce_audio_track_1.getEnforceAudioTrack,
+    setEnforceAudioTrack: enforce_audio_track_1.setEnforceAudioTrack,
+    getKeyboardShortcutsEnabled: keyboard_shortcuts_1.getKeyboardShortcutsEnabled,
+    getPublicDir: public_dir_1.getPublicDir,
+    getFfmpegOverrideFunction: ffmpeg_override_1.getFfmpegOverrideFunction,
 };
 const overrideRemotion = () => {
     Object.assign(remotion_1.Config, exports.Config);

package/dist/config/keyboard-shortcuts.d.ts

@@ -0,0 +1,2 @@
+export declare const setKeyboardShortcutsEnabled: (enabled: boolean) => void;
+export declare const getKeyboardShortcutsEnabled: () => boolean;

package/dist/config/keyboard-shortcuts.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getKeyboardShortcutsEnabled = exports.setKeyboardShortcutsEnabled = void 0;
+let shortcutsEnabled = true;
+const setKeyboardShortcutsEnabled = (enabled) => {
+    shortcutsEnabled = enabled;
+};
+exports.setKeyboardShortcutsEnabled = setKeyboardShortcutsEnabled;
+const getKeyboardShortcutsEnabled = () => {
+    return shortcutsEnabled;
+};
+exports.getKeyboardShortcutsEnabled = getKeyboardShortcutsEnabled;

package/dist/config/log.d.ts

@@ -1,3 +1,3 @@
 import type { LogLevel } from '@remotion/renderer';
-export declare const getLogLevel: () => "verbose" | "info" | "warn" | "error";
+export declare const getLogLevel: () => "error" | "verbose" | "info" | "warn";
 export declare const setLogLevel: (newLogLevel: LogLevel) => void;

package/dist/config/muted.d.ts

@@ -0,0 +1,2 @@
+export declare const setMuted: (muted: boolean) => void;
+export declare const getMuted: () => boolean;

package/dist/config/muted.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMuted = exports.setMuted = void 0;
+const DEFAULT_MUTED_STATE = false;
+let mutedState = DEFAULT_MUTED_STATE;
+const setMuted = (muted) => {
+    mutedState = muted;
+};
+exports.setMuted = setMuted;
+const getMuted = () => {
+    return mutedState;
+};
+exports.getMuted = getMuted;

package/dist/config/overwrite.d.ts

@@ -1,2 +1,4 @@
 export declare const setOverwriteOutput: (newOverwrite: boolean) => void;
-export declare const getShouldOverwrite: () => boolean;
+export declare const getShouldOverwrite: ({ defaultValue, }: {
+    defaultValue: boolean;
+}) => boolean;

package/dist/config/overwrite.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getShouldOverwrite = exports.setOverwriteOutput = void 0;
-const renderer_1 = require("@remotion/renderer");
-let shouldOverwrite = renderer_1.RenderInternals.DEFAULT_OVERWRITE;
+let shouldOverwrite = null;
 const setOverwriteOutput = (newOverwrite) => {
     if (typeof newOverwrite !== 'boolean') {
         throw new Error(`overwriteExisting must be a boolean but got ${typeof newOverwrite} (${JSON.stringify(newOverwrite)})`);
@@ -10,5 +9,5 @@ const setOverwriteOutput = (newOverwrite) => {
     shouldOverwrite = newOverwrite;
 };
 exports.setOverwriteOutput = setOverwriteOutput;
-const getShouldOverwrite = () => shouldOverwrite;
+const getShouldOverwrite = ({ defaultValue, }) => shouldOverwrite !== null && shouldOverwrite !== void 0 ? shouldOverwrite : defaultValue;
 exports.getShouldOverwrite = getShouldOverwrite;

package/dist/config/public-dir.d.ts

@@ -0,0 +1,2 @@
+export declare const getPublicDir: () => string | null;
+export declare const setPublicDir: (dir: string) => void;

package/dist/config/public-dir.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setPublicDir = exports.getPublicDir = void 0;
+let publicDir = null;
+const getPublicDir = () => {
+    return publicDir;
+};
+exports.getPublicDir = getPublicDir;
+const setPublicDir = (dir) => {
+    publicDir = dir;
+};
+exports.setPublicDir = setPublicDir;

package/dist/determine-image-format.d.ts

@@ -0,0 +1,11 @@
+import type { ImageFormat, StillImageFormat } from '@remotion/renderer';
+export declare const determineFinalImageFormat: ({ downloadName, outName, configImageFormat, cliFlag, isLambda, }: {
+    downloadName: string | null;
+    outName: string | null;
+    configImageFormat: ImageFormat | null;
+    cliFlag: ImageFormat | null;
+    isLambda: boolean;
+}) => {
+    format: StillImageFormat;
+    source: string;
+};

package/dist/determine-image-format.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.determineFinalImageFormat = void 0;
+const deriveExtensionFromFilename = (filename) => {
+    if (filename === null || filename === void 0 ? void 0 : filename.endsWith('.png')) {
+        return 'png';
+    }
+    if (filename === null || filename === void 0 ? void 0 : filename.endsWith('.jpg')) {
+        return 'jpeg';
+    }
+    if (filename === null || filename === void 0 ? void 0 : filename.endsWith('.jpeg')) {
+        return 'jpeg';
+    }
+    return null;
+};
+const determineFinalImageFormat = ({ downloadName, outName, configImageFormat, cliFlag, isLambda, }) => {
+    const outNameExtension = deriveExtensionFromFilename(outName);
+    const downloadNameExtension = deriveExtensionFromFilename(downloadName);
+    const outNameDescription = isLambda ? 'S3 output key' : 'out name';
+    if (outNameExtension &&
+        downloadNameExtension &&
+        outNameExtension !== downloadNameExtension) {
+        throw new TypeError(`Image format mismatch: ${outName} was given as the ${outNameDescription} and ${downloadName} was given as the download name, but the extensions don't match.`);
+    }
+    if (downloadNameExtension) {
+        if (cliFlag && downloadNameExtension !== cliFlag) {
+            throw new TypeError(`Image format mismatch: ${downloadName} was given as the download name, but --image-format=${cliFlag} was passed. The image formats must match.`);
+        }
+        return { format: downloadNameExtension, source: 'Download name extension' };
+    }
+    if (outNameExtension) {
+        if (cliFlag && outNameExtension !== cliFlag) {
+            throw new TypeError(`Image format mismatch: ${outName} was given as the ${outNameDescription}, but --image-format=${cliFlag} was passed. The image formats must match.`);
+        }
+        return { format: outNameExtension, source: 'Out name extension' };
+    }
+    if (cliFlag === 'none') {
+        throw new TypeError('The --image-format flag must not be "none" for stills.');
+    }
+    if (cliFlag !== null) {
+        return { format: cliFlag, source: '--image-format flag' };
+    }
+    if (configImageFormat !== null && configImageFormat !== 'none') {
+        return { format: configImageFormat, source: 'Config file' };
+    }
+    return { format: 'png', source: 'Default' };
+};
+exports.determineFinalImageFormat = determineFinalImageFormat;