@remotion/cli 4.0.409 → 4.0.410

package/dist/add.js

@@ -1,17 +1,34 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addCommand = void 0;
 const renderer_1 = require("@remotion/renderer");
 const studio_server_1 = require("@remotion/studio-server");
 const node_child_process_1 = require("node:child_process");
+const node_fs_1 = __importDefault(require("node:fs"));
 const chalk_1 = require("./chalk");
+const extra_packages_1 = require("./extra-packages");
 const list_of_remotion_packages_1 = require("./list-of-remotion-packages");
 const log_1 = require("./log");
+const resolve_from_1 = require("./resolve-from");
+const getInstalledVersion = (remotionRoot, pkg) => {
+    try {
+        const pkgJsonPath = (0, resolve_from_1.resolveFrom)(remotionRoot, `${pkg}/package.json`);
+        const file = node_fs_1.default.readFileSync(pkgJsonPath, 'utf-8');
+        const packageJson = JSON.parse(file);
+        return packageJson.version;
+    }
+    catch (_a) {
+        return null;
+    }
+};
 const addCommand = async ({ remotionRoot, packageManager, packageNames, logLevel, args, }) => {
     // Validate that all package names are Remotion packages
-    const invalidPackages = packageNames.filter((pkg) => !list_of_remotion_packages_1.listOfRemotionPackages.includes(pkg));
+    const invalidPackages = packageNames.filter((pkg) => !list_of_remotion_packages_1.listOfRemotionPackages.includes(pkg) && !extra_packages_1.EXTRA_PACKAGES[pkg]);
     if (invalidPackages.length > 0) {
-        throw new Error(`The following packages are not Remotion packages: ${invalidPackages.join(', ')}. Must be one of the Remotion packages.`);
+        throw new Error(`The following packages are not Remotion packages: ${invalidPackages.join(', ')}. Must be one of the Remotion packages or one of the supported extra packages: ${Object.keys(extra_packages_1.EXTRA_PACKAGES).join(', ')}.`);
     }
     const { dependencies, devDependencies, optionalDependencies, peerDependencies, } = studio_server_1.StudioServerInternals.getInstalledDependencies(remotionRoot);
     // Check if packages are already installed
@@ -21,34 +38,69 @@ const addCommand = async ({ remotionRoot, packageManager, packageNames, logLevel
         ...optionalDependencies,
         ...peerDependencies,
     ];
-    const alreadyInstalled = packageNames.filter((pkg) => allDeps.includes(pkg));
-    const toInstall = packageNames.filter((pkg) => !allDeps.includes(pkg));
+    const alreadyInstalled = [];
+    const toInstall = [];
+    const toUpgrade = [];
+    for (const pkg of packageNames) {
+        const isInstalled = allDeps.includes(pkg);
+        const requiredVersion = extra_packages_1.EXTRA_PACKAGES[pkg];
+        if (!isInstalled) {
+            toInstall.push(pkg);
+        }
+        else if (requiredVersion) {
+            // For extra packages, check if the version is correct
+            const installedVersion = getInstalledVersion(remotionRoot, pkg);
+            if (installedVersion !== requiredVersion) {
+                toUpgrade.push({
+                    pkg,
+                    from: installedVersion !== null && installedVersion !== void 0 ? installedVersion : 'unknown',
+                    to: requiredVersion,
+                });
+                toInstall.push(pkg);
+            }
+            else {
+                alreadyInstalled.push(pkg);
+            }
+        }
+        else {
+            alreadyInstalled.push(pkg);
+        }
+    }
     // Log already installed packages
     for (const pkg of alreadyInstalled) {
         log_1.Log.info({ indent: false, logLevel }, `○ ${pkg} ${chalk_1.chalk.gray('(already installed)')}`);
     }
+    // Log packages that will be upgraded
+    for (const { pkg, from, to } of toUpgrade) {
+        log_1.Log.info({ indent: false, logLevel }, `↑ ${pkg} ${chalk_1.chalk.yellow(`${from} → ${to}`)}`);
+    }
     // If nothing to install, return early
     if (toInstall.length === 0) {
         return;
     }
-    // Find the version of installed Remotion packages
     const installedRemotionPackages = list_of_remotion_packages_1.listOfRemotionPackages.filter((pkg) => allDeps.includes(pkg));
-    if (installedRemotionPackages.length === 0) {
-        throw new Error('No Remotion packages found in your project. Install Remotion first.');
-    }
     // Get the version from the first installed Remotion package
     const packageJsonPath = `${remotionRoot}/node_modules/${installedRemotionPackages[0]}/package.json`;
-    let targetVersion;
-    try {
-        const packageJson = require(packageJsonPath);
-        targetVersion = packageJson.version;
-        const packageList = toInstall.length === 1
-            ? toInstall[0]
-            : `${toInstall.length} packages (${toInstall.join(', ')})`;
-        log_1.Log.info({ indent: false, logLevel }, `Installing ${packageList}@${targetVersion} to match your other Remotion packages`);
+    let targetVersion = null;
+    if (installedRemotionPackages.length > 0) {
+        try {
+            const packageJson = require(packageJsonPath);
+            targetVersion = packageJson.version;
+            const packageList = toInstall.length === 1
+                ? toInstall[0]
+                : `${toInstall.length} packages (${toInstall.join(', ')})`;
+            log_1.Log.info({ indent: false, logLevel }, `Installing ${packageList}`);
+        }
+        catch (err) {
+            throw new Error(`Could not determine version of installed Remotion packages: ${err.message}`);
+        }
     }
-    catch (err) {
-        throw new Error(`Could not determine version of installed Remotion packages: ${err.message}`);
+    else {
+        // If no Remotion packages are installed, we can only install extra packages
+        const notExtraPackages = toInstall.filter((pkg) => !extra_packages_1.EXTRA_PACKAGES[pkg]);
+        if (notExtraPackages.length > 0) {
+            throw new Error('No Remotion packages found in your project. Install Remotion first.');
+        }
     }
     const manager = studio_server_1.StudioServerInternals.getPackageManager(remotionRoot, packageManager, 0);
     if (manager === 'unknown') {
@@ -56,10 +108,16 @@ const addCommand = async ({ remotionRoot, packageManager, packageNames, logLevel
             .map((p) => p.path)
             .join(', ')}). Install dependencies using your favorite manager!`);
     }
+    const packagesWithVersions = toInstall.map((pkg) => {
+        if (extra_packages_1.EXTRA_PACKAGES[pkg]) {
+            return `${pkg}@${extra_packages_1.EXTRA_PACKAGES[pkg]}`;
+        }
+        return `${pkg}@${targetVersion}`;
+    });
     const command = studio_server_1.StudioServerInternals.getInstallCommand({
         manager: manager.manager,
-        packages: toInstall,
-        version: targetVersion,
+        packages: packagesWithVersions,
+        version: '',
         additionalArgs: args,
     });
     log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.gray(`$ ${manager.manager} ${command.join(' ')}`));
@@ -68,6 +126,7 @@ const addCommand = async ({ remotionRoot, packageManager, packageNames, logLevel
             ...process.env,
             ADBLOCK: '1',
             DISABLE_OPENCOLLECTIVE: '1',
+            npm_config_loglevel: 'error',
         },
         stdio: renderer_1.RenderInternals.isEqualOrBelowLogLevel(logLevel, 'info')
             ? 'inherit'
@@ -86,11 +145,18 @@ const addCommand = async ({ remotionRoot, packageManager, packageNames, logLevel
             }
         });
     });
-    for (const pkg of alreadyInstalled) {
-        log_1.Log.info({ indent: false, logLevel }, `○ ${pkg}@${targetVersion} ${chalk_1.chalk.gray('(already installed)')}`);
-    }
+    const upgradedPkgs = new Set(toUpgrade.map((u) => u.pkg));
     for (const pkg of toInstall) {
-        log_1.Log.info({ indent: false, logLevel }, `+ ${pkg}@${targetVersion}`);
+        if (upgradedPkgs.has(pkg)) {
+            // Already logged as upgrade
+            continue;
+        }
+        if (extra_packages_1.EXTRA_PACKAGES[pkg]) {
+            log_1.Log.info({ indent: false, logLevel }, `+ ${pkg}@${extra_packages_1.EXTRA_PACKAGES[pkg]}`);
+        }
+        else {
+            log_1.Log.info({ indent: false, logLevel }, `+ ${pkg}@${targetVersion}`);
+        }
     }
 };
 exports.addCommand = addCommand;

package/dist/benchmark.js

@@ -382,6 +382,7 @@ const benchmarkCommand = async (remotionRoot, args, logLevel) => {
                 }).value,
                 onLog: renderer_1.RenderInternals.defaultOnLog,
                 licenseKey: null,
+                isProduction: null,
             }, (run, progress) => {
                 benchmarkProgress.update(makeBenchmarkProgressBar({
                     totalRuns: runs,

package/dist/extra-packages.d.ts

@@ -0,0 +1,2 @@
+export declare const EXTRA_PACKAGES: Record<string, string>;
+export declare const EXTRA_PACKAGES_DOCS: Record<string, string>;

package/dist/extra-packages.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXTRA_PACKAGES_DOCS = exports.EXTRA_PACKAGES = void 0;
+exports.EXTRA_PACKAGES = {
+    zod: '3.22.3',
+    mediabunny: '1.29.0',
+};
+exports.EXTRA_PACKAGES_DOCS = {
+    zod: 'https://www.remotion.dev/docs/schemas#prerequisites',
+    mediabunny: 'https://www.remotion.dev/docs/mediabunny/version',
+};

package/dist/index.js

@@ -41,18 +41,15 @@ const print_help_1 = require("./print-help");
 const progress_bar_1 = require("./progress-bar");
 const render_1 = require("./render");
 const should_use_non_overlaying_logger_1 = require("./should-use-non-overlaying-logger");
+const skills_1 = require("./skills");
 const still_1 = require("./still");
 const studio_1 = require("./studio");
 const upgrade_1 = require("./upgrade");
 const versions_1 = require("./versions");
 const cli = async () => {
     const [command, ...args] = parsed_cli_1.parsedCli._;
-    if (parsed_cli_1.parsedCli.help) {
-        (0, print_help_1.printHelp)('info');
-        process.exit(0);
-    }
     const remotionRoot = renderer_1.RenderInternals.findRemotionRoot();
-    if (command !== versions_1.VERSIONS_COMMAND) {
+    if (command !== versions_1.VERSIONS_COMMAND && !parsed_cli_1.parsedCli.help) {
         await (0, versions_1.validateVersionsBeforeCommand)(remotionRoot, 'info');
     }
     const logLevel = await (0, initialize_cli_1.initializeCli)(remotionRoot);
@@ -131,6 +128,9 @@ const cli = async () => {
                 args: additionalArgs,
             });
         }
+        else if (command === 'skills') {
+            await (0, skills_1.skillsCommand)(args, logLevel);
+        }
         else if (command === versions_1.VERSIONS_COMMAND) {
             await (0, versions_1.versionsCommand)(remotionRoot, logLevel);
         }
@@ -144,6 +144,9 @@ const cli = async () => {
             (0, print_help_1.printHelp)(logLevel);
             process.exit(0);
         }
+        else if (parsed_cli_1.parsedCli.help) {
+            (0, print_help_1.printHelp)(logLevel);
+        }
         else {
             if (command) {
                 log_1.Log.error({ indent: false, logLevel }, `Command ${command} not found.`);

package/dist/parsed-cli.js

@@ -39,6 +39,7 @@ exports.BooleanFlags = [
     'compatible-only',
     'force-path-style',
     'onlyAllocateCpuDuringRequestProcessing',
+    client_1.BrowserSafeApis.options.isProductionOption.cliFlag,
 ];
 exports.parsedCli = (0, minimist_1.default)(process.argv.slice(2), {
     boolean: exports.BooleanFlags,

package/dist/print-help.js

@@ -56,6 +56,9 @@ const printHelp = (logLevel) => {
     log_1.Log.info({ indent: false, logLevel }, 'Add Remotion packages with the correct version.');
     log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.gray('https://www.remotion.dev/docs/cli/add'));
     log_1.Log.info({ indent: false, logLevel });
+    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue('remotion skills ') + chalk_1.chalk.gray('<add | update>'));
+    log_1.Log.info({ indent: false, logLevel }, 'Install or update skills from remotion-dev/skills.');
+    log_1.Log.info({ indent: false, logLevel });
     log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue(`remotion ${browser_1.BROWSER_COMMAND}`));
     log_1.Log.info({ indent: false, logLevel }, 'Ensure Remotion has a browser it can use for rendering.');
     log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.gray('https://www.remotion.dev/docs/cli/browser'));

package/dist/render-flows/render.js

@@ -500,8 +500,8 @@ const renderVideoFlow = async ({ remotionRoot, fullEntryPoint, indent, logLevel,
         chromeMode,
         mediaCacheSizeInBytes,
         onLog,
-        apiKey: null,
         licenseKey: null,
+        isProduction: null,
     });
     if (!updatesDontOverwrite) {
         updateRenderProgress({ newline: true, printToConsole: true });

package/dist/render-flows/still.js

@@ -276,8 +276,8 @@ const renderStillFlow = async ({ remotionRoot, fullEntryPoint, entryPointReason,
                 printToConsole: true,
             });
         },
-        apiKey: null,
         licenseKey: null,
+        isProduction: null,
     });
     aggregate.rendering = {
         frames: 1,

package/dist/skills.d.ts

@@ -0,0 +1,3 @@
+import type { LogLevel } from '@remotion/renderer';
+export declare const printSkillsHelp: (logLevel: LogLevel) => void;
+export declare const skillsCommand: (args: string[], logLevel: LogLevel) => Promise<void> | undefined;

package/dist/skills.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skillsCommand = exports.printSkillsHelp = void 0;
+const node_child_process_1 = require("node:child_process");
+const chalk_1 = require("./chalk");
+const log_1 = require("./log");
+const printSkillsHelp = (logLevel) => {
+    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue('remotion skills'));
+    log_1.Log.info({ indent: false, logLevel }, 'Install or update skills from remotion-dev/skills.');
+    log_1.Log.info({ indent: false, logLevel });
+    log_1.Log.info({ indent: false, logLevel }, 'Available subcommands:');
+    log_1.Log.info({ indent: false, logLevel });
+    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue('remotion skills add'));
+    log_1.Log.info({ indent: false, logLevel }, 'Install skills from remotion-dev/skills.');
+    log_1.Log.info({ indent: false, logLevel });
+    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue('remotion skills update'));
+    log_1.Log.info({ indent: false, logLevel }, 'Update skills from remotion-dev/skills.');
+};
+exports.printSkillsHelp = printSkillsHelp;
+const skillsCommand = (args, logLevel) => {
+    const subcommand = args[0];
+    const restArgs = args.slice(1);
+    if (!subcommand || !['add', 'update'].includes(subcommand)) {
+        (0, exports.printSkillsHelp)(logLevel);
+        return;
+    }
+    const command = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+    const fullArgs = [
+        '-y',
+        '--loglevel=error',
+        'skills',
+        subcommand,
+        'remotion-dev/skills',
+        ...restArgs,
+    ];
+    const child = (0, node_child_process_1.spawn)(command, fullArgs, {
+        stdio: 'inherit',
+    });
+    return new Promise((resolve, reject) => {
+        child.on('exit', (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                reject(new Error(`The skills command failed with exit code ${code}`));
+            }
+        });
+        child.on('error', (err) => {
+            reject(err);
+        });
+    });
+};
+exports.skillsCommand = skillsCommand;

package/dist/upgrade.js

@@ -5,8 +5,26 @@ const renderer_1 = require("@remotion/renderer");
 const studio_server_1 = require("@remotion/studio-server");
 const node_child_process_1 = require("node:child_process");
 const chalk_1 = require("./chalk");
+const extra_packages_1 = require("./extra-packages");
 const list_of_remotion_packages_1 = require("./list-of-remotion-packages");
 const log_1 = require("./log");
+const getExtraPackageVersionsForRemotionVersion = (remotionVersion) => {
+    try {
+        const output = (0, node_child_process_1.execSync)(`npm view @remotion/studio@${remotionVersion} dependencies --json`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+        const dependencies = JSON.parse(output);
+        const extraVersions = {};
+        for (const pkg of Object.keys(extra_packages_1.EXTRA_PACKAGES)) {
+            if (dependencies[pkg]) {
+                extraVersions[pkg] = dependencies[pkg];
+            }
+        }
+        return extraVersions;
+    }
+    catch (_a) {
+        // If we can't fetch the versions, return the default versions from EXTRA_PACKAGES
+        return extra_packages_1.EXTRA_PACKAGES;
+    }
+};
 const upgradeCommand = async ({ remotionRoot, packageManager, version, logLevel, args, }) => {
     const { dependencies, devDependencies, optionalDependencies, peerDependencies, } = studio_server_1.StudioServerInternals.getInstalledDependencies(remotionRoot);
     let targetVersion;
@@ -24,14 +42,29 @@ const upgradeCommand = async ({ remotionRoot, packageManager, version, logLevel,
             .map((p) => p.path)
             .join(', ')}). Install dependencies using your favorite manager!`);
     }
-    const toUpgrade = list_of_remotion_packages_1.listOfRemotionPackages.filter((u) => dependencies.includes(u) ||
-        devDependencies.includes(u) ||
-        optionalDependencies.includes(u) ||
-        peerDependencies.includes(u));
+    const allDeps = [
+        ...dependencies,
+        ...devDependencies,
+        ...optionalDependencies,
+        ...peerDependencies,
+    ];
+    const remotionToUpgrade = list_of_remotion_packages_1.listOfRemotionPackages.filter((u) => allDeps.includes(u));
+    // Check if extra packages (zod, mediabunny) are installed
+    const installedExtraPackages = Object.keys(extra_packages_1.EXTRA_PACKAGES).filter((pkg) => allDeps.includes(pkg));
+    // Get the correct versions for extra packages for this Remotion version
+    const extraPackageVersions = getExtraPackageVersionsForRemotionVersion(targetVersion);
+    // Build the list of packages to upgrade
+    const packagesWithVersions = [
+        ...remotionToUpgrade.map((pkg) => `${pkg}@${targetVersion}`),
+        ...installedExtraPackages.map((pkg) => `${pkg}@${extraPackageVersions[pkg]}`),
+    ];
+    if (installedExtraPackages.length > 0) {
+        log_1.Log.info({ indent: false, logLevel }, `Also upgrading extra packages: ${installedExtraPackages.map((pkg) => `${pkg}@${extraPackageVersions[pkg]}`).join(', ')}`);
+    }
     const command = studio_server_1.StudioServerInternals.getInstallCommand({
         manager: manager.manager,
-        packages: toUpgrade,
-        version: targetVersion,
+        packages: packagesWithVersions,
+        version: '',
         additionalArgs: args,
     });
     log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.gray(`$ ${manager.manager} ${command.join(' ')}`));

package/dist/versions.js

@@ -8,6 +8,7 @@ const renderer_1 = require("@remotion/renderer");
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const chalk_1 = require("./chalk");
+const extra_packages_1 = require("./extra-packages");
 const list_of_remotion_packages_1 = require("./list-of-remotion-packages");
 const log_1 = require("./log");
 const parse_command_line_1 = require("./parse-command-line");
@@ -39,27 +40,69 @@ const groupBy = (vals) => {
 const getAllVersions = async (remotionRoot) => {
     return (await Promise.all(list_of_remotion_packages_1.listOfRemotionPackages.map(async (p) => [p, await getVersion(remotionRoot, p)]))).filter(([, version]) => version);
 };
+const getExtraPackagesStatus = async (remotionRoot) => {
+    const results = [];
+    for (const [pkg, requiredVersion] of Object.entries(extra_packages_1.EXTRA_PACKAGES)) {
+        const versionAndPath = await getVersion(remotionRoot, pkg);
+        if (versionAndPath) {
+            results.push({
+                pkg,
+                requiredVersion,
+                installedVersion: versionAndPath.version,
+                path: versionAndPath.path,
+                isCorrect: versionAndPath.version === requiredVersion,
+            });
+        }
+        else {
+            results.push({
+                pkg,
+                requiredVersion,
+                installedVersion: null,
+                path: null,
+                isCorrect: true, // Not installed is fine - only validate if installed
+            });
+        }
+    }
+    return results;
+};
 exports.VERSIONS_COMMAND = 'versions';
 const validateVersionsBeforeCommand = async (remotionRoot, logLevel) => {
     var _a;
     const versions = await getAllVersions(remotionRoot);
     const grouped = groupBy(versions);
     const installedVersions = Object.keys(grouped);
-    if (installedVersions.length === 1) {
+    const hasRemotionMismatch = installedVersions.length > 1 && installedVersions.length !== 0;
+    // Check extra packages
+    const extraPackagesStatus = await getExtraPackagesStatus(remotionRoot);
+    const incorrectExtraPackages = extraPackagesStatus.filter((status) => !status.isCorrect);
+    if (!hasRemotionMismatch && incorrectExtraPackages.length === 0) {
         return;
     }
     // Could be a global install of @remotion/cli.
     // If you render a bundle with a different version, it will give a warning accordingly.
-    if (installedVersions.length === 0) {
+    if (installedVersions.length === 0 && incorrectExtraPackages.length === 0) {
         return;
     }
     const logOptions = { indent: false, logLevel };
     log_1.Log.warn(logOptions, '-------------');
     log_1.Log.warn(logOptions, 'Version mismatch:');
-    for (const version of installedVersions) {
-        log_1.Log.warn(logOptions, `- On version: ${version}`);
-        for (const pkg of (_a = grouped[version]) !== null && _a !== void 0 ? _a : []) {
-            log_1.Log.warn(logOptions, `  - ${pkg.pkg} ${chalk_1.chalk.gray(node_path_1.default.relative(remotionRoot, pkg.versionAndPath.path))}`);
+    if (hasRemotionMismatch) {
+        for (const version of installedVersions) {
+            log_1.Log.warn(logOptions, `- On version: ${version}`);
+            for (const pkg of (_a = grouped[version]) !== null && _a !== void 0 ? _a : []) {
+                log_1.Log.warn(logOptions, `  - ${pkg.pkg} ${chalk_1.chalk.gray(node_path_1.default.relative(remotionRoot, pkg.versionAndPath.path))}`);
+            }
+            log_1.Log.info({ indent: false, logLevel });
+        }
+    }
+    if (incorrectExtraPackages.length > 0) {
+        log_1.Log.warn(logOptions, 'Extra packages with wrong versions:');
+        for (const status of incorrectExtraPackages) {
+            const docLink = extra_packages_1.EXTRA_PACKAGES_DOCS[status.pkg];
+            log_1.Log.warn(logOptions, `  - ${status.pkg}: installed ${status.installedVersion}, required ${status.requiredVersion}`);
+            if (docLink) {
+                log_1.Log.warn(logOptions, `    See: ${docLink}`);
+            }
         }
         log_1.Log.info({ indent: false, logLevel });
     }
@@ -71,6 +114,9 @@ const validateVersionsBeforeCommand = async (remotionRoot, logLevel) => {
     log_1.Log.warn(logOptions, 'To resolve:');
     log_1.Log.warn(logOptions, '- Make sure your package.json has all Remotion packages pointing to the same version.');
     log_1.Log.warn(logOptions, '- Remove the `^` character in front of a version to pin a package.');
+    for (const incorrectPkg of incorrectExtraPackages) {
+        log_1.Log.warn(logOptions, `- For ${incorrectPkg.pkg}, install exact version ${incorrectPkg.requiredVersion} (run: npx remotion add ${incorrectPkg.pkg}).`);
+    }
     if (!renderer_1.RenderInternals.isEqualOrBelowLogLevel(logLevel, 'verbose')) {
         log_1.Log.warn(logOptions, '- Run `npx remotion versions --log=verbose` to see the path of the modules resolved.');
     }
@@ -94,19 +140,49 @@ const versionsCommand = async (remotionRoot, logLevel) => {
         }
         log_1.Log.info({ indent: false, logLevel });
     }
+    // Check extra packages
+    const extraPackagesStatus = await getExtraPackagesStatus(remotionRoot);
+    const installedExtraPackages = extraPackagesStatus.filter((status) => status.installedVersion !== null);
+    if (installedExtraPackages.length > 0) {
+        log_1.Log.info({ indent: false, logLevel }, 'Extra packages:');
+        for (const status of installedExtraPackages) {
+            const versionStatus = status.isCorrect
+                ? chalk_1.chalk.green(`${status.installedVersion}`)
+                : chalk_1.chalk.red(`${status.installedVersion} (required: ${status.requiredVersion})`);
+            log_1.Log.info({ indent: false, logLevel }, `- ${status.pkg}@${versionStatus}`);
+            if (status.path) {
+                log_1.Log.verbose({ indent: false, logLevel }, `  ${status.path}`);
+            }
+        }
+        log_1.Log.info({ indent: false, logLevel });
+    }
     if (installedVersions.length === 0) {
         log_1.Log.info({ indent: false, logLevel }, 'No Remotion packages found.');
         log_1.Log.info({ indent: false, logLevel }, 'Maybe @remotion/cli is installed globally.');
         log_1.Log.info({ indent: false, logLevel }, 'If you try to render a video that was bundled with a different version, you will get a warning.');
         process.exit(1);
     }
-    if (installedVersions.length === 1) {
-        log_1.Log.info({ indent: false, logLevel }, `✅ Great! All packages have the same version.`);
+    const incorrectExtraPackages = extraPackagesStatus.filter((status) => !status.isCorrect);
+    if (installedVersions.length === 1 && incorrectExtraPackages.length === 0) {
+        log_1.Log.info({ indent: false, logLevel }, `All packages have the correct version.`);
     }
     else {
-        log_1.Log.error({ indent: false, logLevel }, 'Version mismatch: Not all Remotion packages have the same version.');
-        log_1.Log.info({ indent: false, logLevel }, '- Make sure your package.json has all Remotion packages pointing to the same version.');
-        log_1.Log.info({ indent: false, logLevel }, '- Remove the `^` character in front of a version to pin a package.');
+        if (installedVersions.length !== 1) {
+            log_1.Log.error({ indent: false, logLevel }, 'Version mismatch: Not all Remotion packages have the same version.');
+            log_1.Log.info({ indent: false, logLevel }, '- Make sure your package.json has all Remotion packages pointing to the same version.');
+            log_1.Log.info({ indent: false, logLevel }, '- Remove the `^` character in front of a version to pin a package.');
+        }
+        if (incorrectExtraPackages.length > 0) {
+            log_1.Log.error({ indent: false, logLevel }, 'Extra packages have incorrect versions:');
+            for (const status of incorrectExtraPackages) {
+                const docLink = extra_packages_1.EXTRA_PACKAGES_DOCS[status.pkg];
+                log_1.Log.info({ indent: false, logLevel }, `- ${status.pkg}: installed ${status.installedVersion}, required ${status.requiredVersion}`);
+                if (docLink) {
+                    log_1.Log.info({ indent: false, logLevel }, `  See: ${docLink}`);
+                }
+            }
+            log_1.Log.info({ indent: false, logLevel }, `To fix, run: npx remotion add ${incorrectExtraPackages.map((s) => s.pkg).join(' ')}`);
+        }
         if (!renderer_1.RenderInternals.isEqualOrBelowLogLevel(logLevel, 'verbose')) {
             log_1.Log.info({ indent: false, logLevel }, '- Rerun this command with --log=verbose to see the path of the modules resolved.');
         }

package/package.json

@@ -3,7 +3,7 @@
 		"url": "https://github.com/remotion-dev/remotion/tree/main/packages/cli"
 	},
 	"name": "@remotion/cli",
-	"version": "4.0.409",
+	"version": "4.0.410",
 	"description": "Control Remotion features using the `npx remotion` command",
 	"main": "dist/index.js",
 	"sideEffects": false,
@@ -36,17 +36,17 @@
 	"author": "Jonny Burger <jonny@remotion.dev>",
 	"license": "SEE LICENSE IN LICENSE.md",
 	"dependencies": {
-		"@remotion/bundler": "4.0.409",
-		"@remotion/media-utils": "4.0.409",
-		"@remotion/player": "4.0.409",
-		"@remotion/renderer": "4.0.409",
-		"@remotion/studio-shared": "4.0.409",
-		"@remotion/studio-server": "4.0.409",
-		"@remotion/studio": "4.0.409",
+		"@remotion/bundler": "4.0.410",
+		"@remotion/media-utils": "4.0.410",
+		"@remotion/player": "4.0.410",
+		"@remotion/renderer": "4.0.410",
+		"@remotion/studio-shared": "4.0.410",
+		"@remotion/studio-server": "4.0.410",
+		"@remotion/studio": "4.0.410",
 		"dotenv": "9.0.2",
 		"minimist": "1.2.6",
 		"prompts": "2.4.2",
-		"remotion": "4.0.409"
+		"remotion": "4.0.410"
 	},
 	"peerDependencies": {
 		"react": ">=16.8.0",
@@ -57,14 +57,14 @@
 		"@types/prompts": "^2.4.1",
 		"@types/prettier": "^2.7.2",
 		"@types/node": "20.12.14",
-		"@remotion/zod-types": "4.0.409",
-		"@remotion/tailwind-v4": "4.0.409",
-		"@remotion/enable-scss": "4.0.409",
-		"@remotion/skia": "4.0.409",
+		"@remotion/zod-types": "4.0.410",
+		"@remotion/tailwind-v4": "4.0.410",
+		"@remotion/enable-scss": "4.0.410",
+		"@remotion/skia": "4.0.410",
 		"react": "19.2.3",
 		"react-dom": "19.2.3",
 		"zod": "3.22.3",
-		"@remotion/eslint-config-internal": "4.0.409",
+		"@remotion/eslint-config-internal": "4.0.410",
 		"eslint": "9.19.0"
 	},
 	"keywords": [