@remotion/cli 4.0.505 → 4.0.506

package/dist/config/index.d.ts

@@ -1,5 +1,5 @@
 import type { BundlerOverrideFn, RspackConfiguration, RspackOverrideFn, WebpackConfiguration, WebpackOverrideFn } from '@remotion/bundler';
-import type { BrowserExecutable, ChromeMode, CodecOrUndefined, ColorSpace, Crf, DeleteAfter, DefaultEditor, FrameRange, NumberOfGifLoops, StillImageFormat, VideoImageFormat } from '@remotion/renderer';
+import type { BrowserExecutable, ChromeMode, CodecOrUndefined, ColorSpace, Crf, DefaultCodingAgent, DefaultEditor, DeleteAfter, FrameRange, NumberOfGifLoops, StillImageFormat, VideoImageFormat } from '@remotion/renderer';
 import type { HardwareAccelerationOption } from '@remotion/renderer/client';
 import type { Concurrency } from './concurrency';
 export type { BundlerOverrideFn, Concurrency, RspackConfiguration, RspackOverrideFn, WebpackConfiguration, WebpackOverrideFn, };
@@ -388,6 +388,10 @@ type FlatConfig = RemotionConfigObject & RemotionBundlingOptions & {
      * Set the editor used when opening files from Remotion Studio.
      */
     setDefaultEditor: (editor: DefaultEditor) => void;
+    /**
+     * Set the coding agent used by Remotion Studio.
+     */
+    setDefaultCodingAgent: (codingAgent: DefaultCodingAgent) => void;
     setDeleteAfter: (day: DeleteAfter | null) => void;
     /**
      * Set whether S3 buckets should be allowed to expire.

package/dist/config/index.js

@@ -18,7 +18,7 @@ const preview_server_1 = require("./preview-server");
 const still_frame_1 = require("./still-frame");
 const webpack_caching_1 = require("./webpack-caching");
 const webpack_poll_1 = require("./webpack-poll");
-const { benchmarkConcurrenciesOption, concurrencyOption, offthreadVideoCacheSizeInBytesOption, x264Option, audioBitrateOption, videoBitrateOption, scaleOption, crfOption, jpegQualityOption, enforceAudioOption, overwriteOption, chromeModeOption, mutedOption, videoCodecOption, colorSpaceOption, disallowParallelEncodingOption, deleteAfterOption, folderExpiryOption, enableMultiprocessOnLinuxOption, glOption, gopSizeOption, headlessOption, numberOfGifLoopsOption, beepOnFinishOption, encodingMaxRateOption, encodingBufferSizeOption, reproOption, enableLambdaInsights, logLevelOption, delayRenderTimeoutInMillisecondsOption, publicDirOption, binariesDirectoryOption, preferLosslessOption, framesOption, forSeamlessAacConcatenationOption, audioCodecOption, publicPathOption, hardwareAccelerationOption, audioLatencyHintOption, enableCrossSiteIsolationOption, imageSequencePatternOption, darkModeOption, defaultEditorOption, askAIOption, publicLicenseKeyOption, interactivityOption, keyboardShortcutsOption, forceNewStudioOption, numberOfSharedAudioTagsOption, ipv4Option, pixelFormatOption, browserExecutableOption, everyNthFrameOption, proResProfileOption, stillImageFormatOption, videoImageFormatOption, userAgentOption, disableWebSecurityOption, ignoreCertificateErrorsOption, overrideHeightOption, overrideWidthOption, overrideFpsOption, overrideDurationOption, rspackOption, outDirOption, webpackPollOption, imageSequenceOption, bundleCacheOption, envFileOption, runsOption, noOpenOption, sampleRateOption, previewSampleRateOption, } = client_1.BrowserSafeApis.options;
+const { benchmarkConcurrenciesOption, concurrencyOption, offthreadVideoCacheSizeInBytesOption, x264Option, audioBitrateOption, videoBitrateOption, scaleOption, crfOption, jpegQualityOption, enforceAudioOption, overwriteOption, chromeModeOption, mutedOption, videoCodecOption, colorSpaceOption, disallowParallelEncodingOption, deleteAfterOption, folderExpiryOption, enableMultiprocessOnLinuxOption, glOption, gopSizeOption, headlessOption, numberOfGifLoopsOption, beepOnFinishOption, encodingMaxRateOption, encodingBufferSizeOption, reproOption, enableLambdaInsights, logLevelOption, delayRenderTimeoutInMillisecondsOption, publicDirOption, binariesDirectoryOption, preferLosslessOption, framesOption, forSeamlessAacConcatenationOption, audioCodecOption, publicPathOption, hardwareAccelerationOption, audioLatencyHintOption, enableCrossSiteIsolationOption, imageSequencePatternOption, darkModeOption, defaultCodingAgentOption, defaultEditorOption, askAIOption, publicLicenseKeyOption, interactivityOption, keyboardShortcutsOption, forceNewStudioOption, numberOfSharedAudioTagsOption, ipv4Option, pixelFormatOption, browserExecutableOption, everyNthFrameOption, proResProfileOption, stillImageFormatOption, videoImageFormatOption, userAgentOption, disableWebSecurityOption, ignoreCertificateErrorsOption, overrideHeightOption, overrideWidthOption, overrideFpsOption, overrideDurationOption, rspackOption, outDirOption, webpackPollOption, imageSequenceOption, bundleCacheOption, envFileOption, runsOption, noOpenOption, sampleRateOption, previewSampleRateOption, } = client_1.BrowserSafeApis.options;
 const setAllowHtmlInCanvasEnabled = (_enabled) => {
     log_1.Log.warn({ indent: false, logLevel: 'info' }, 'Config.setAllowHtmlInCanvasEnabled() is now a no-op because HTML-in-canvas is enabled by default when supported. You can remove this option from your config file.');
 };
@@ -128,6 +128,7 @@ exports.Config = {
     setEnableCrossSiteIsolation: enableCrossSiteIsolationOption.setConfig,
     setAskAIEnabled: askAIOption.setConfig,
     setPublicLicenseKey: publicLicenseKeyOption.setConfig,
+    setDefaultCodingAgent: defaultCodingAgentOption.setConfig,
     setDefaultEditor: defaultEditorOption.setConfig,
     setForceNewStudioEnabled: forceNewStudioOption.setConfig,
     setIPv4: ipv4Option.setConfig,

package/dist/config-file-change.d.ts

@@ -0,0 +1,10 @@
+import type { ConfigFileChangeType } from '@remotion/studio-shared';
+export type ConfigFileFingerprints = {
+    reload: string;
+    restart: string;
+};
+export declare const makeConfigFileFingerprints: (code: string) => ConfigFileFingerprints;
+export declare const classifyConfigFileChange: ({ currentCode, startupFingerprints, }: {
+    currentCode: string;
+    startupFingerprints: ConfigFileFingerprints;
+}) => ConfigFileChangeType;

package/dist/config-file-change.js

@@ -0,0 +1,239 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyConfigFileChange = exports.makeConfigFileFingerprints = void 0;
+const parser_1 = require("@babel/parser");
+// Keep this exhaustive so every new Config method must declare its Studio lifecycle.
+const configMethodLifecycles = {
+    overrideBundlerConfig: 'restart',
+    overrideDuration: 'runtime',
+    overrideFfmpegCommand: 'runtime',
+    overrideFps: 'runtime',
+    overrideHeight: 'runtime',
+    overrideRspackConfig: 'restart',
+    overrideWebpackConfig: 'restart',
+    overrideWidth: 'runtime',
+    setAllowHtmlInCanvasEnabled: 'runtime',
+    setAskAIEnabled: 'runtime',
+    setAudioBitrate: 'runtime',
+    setAudioCodec: 'runtime',
+    setAudioLatencyHint: 'reload',
+    setBeepOnFinish: 'runtime',
+    setBenchmarkConcurrencies: 'runtime',
+    setBenchmarkRuns: 'runtime',
+    setBinariesDirectory: 'restart',
+    setBrowserExecutable: 'runtime',
+    setBufferStateDelayInMilliseconds: 'runtime',
+    setBundleOutDir: 'runtime',
+    setCachingEnabled: 'runtime',
+    setChromeMode: 'runtime',
+    setChromiumDarkMode: 'runtime',
+    setChromiumDisableWebSecurity: 'runtime',
+    setChromiumHeadlessMode: 'runtime',
+    setChromiumIgnoreCertificateErrors: 'runtime',
+    setChromiumMultiProcessOnLinux: 'runtime',
+    setChromiumOpenGlRenderer: 'runtime',
+    setChromiumUserAgent: 'runtime',
+    setCodec: 'runtime',
+    setColorSpace: 'runtime',
+    setConcurrency: 'runtime',
+    setCrf: 'runtime',
+    setDefaultCodingAgent: 'runtime',
+    setDefaultEditor: 'runtime',
+    setDelayRenderTimeoutInMilliseconds: 'runtime',
+    setDeleteAfter: 'runtime',
+    setDisallowParallelEncoding: 'runtime',
+    setDotEnvLocation: 'restart',
+    setEnableCrossSiteIsolation: 'restart',
+    setEnableFolderExpiry: 'runtime',
+    setEncodingBufferSize: 'runtime',
+    setEncodingMaxRate: 'runtime',
+    setEnforceAudioTrack: 'runtime',
+    setEntryPoint: 'restart',
+    setEveryNthFrame: 'runtime',
+    setExperimentalRspackEnabled: 'restart',
+    setForSeamlessAacConcatenation: 'runtime',
+    setForceNewStudioEnabled: 'restart',
+    setFrameRange: 'runtime',
+    setGopSize: 'runtime',
+    setHardwareAcceleration: 'runtime',
+    setIPv4: 'restart',
+    setImageFormat: 'runtime',
+    setImageSequence: 'runtime',
+    setImageSequencePattern: 'runtime',
+    setInteractivityEnabled: 'runtime',
+    setJpegQuality: 'runtime',
+    setKeyboardShortcutsEnabled: 'runtime',
+    setLambdaInsights: 'runtime',
+    setLevel: 'restart',
+    setLogLevel: 'restart',
+    setMaxTimelineTracks: 'runtime',
+    setMetadata: 'runtime',
+    setMuted: 'runtime',
+    setNumberOfGifLoops: 'runtime',
+    setNumberOfSharedAudioTags: 'reload',
+    setOffthreadVideoCacheSizeInBytes: 'runtime',
+    setOutputLocation: 'runtime',
+    setOverwriteOutput: 'runtime',
+    setPixelFormat: 'runtime',
+    setPort: 'restart',
+    setPreferLosslessAudio: 'runtime',
+    setPreviewSampleRate: 'reload',
+    setProResProfile: 'runtime',
+    setPublicDir: 'restart',
+    setPublicLicenseKey: 'runtime',
+    setPublicPath: 'runtime',
+    setQuality: 'runtime',
+    setRendererPort: 'restart',
+    setRepro: 'runtime',
+    setRspack: 'restart',
+    setSampleRate: 'runtime',
+    setScale: 'runtime',
+    setShouldOpenBrowser: 'restart',
+    setStillImageFormat: 'runtime',
+    setStudioPort: 'restart',
+    setTimeoutInMilliseconds: 'runtime',
+    setVideoBitrate: 'runtime',
+    setVideoImageFormat: 'runtime',
+    setWebpackPollingInMilliseconds: 'restart',
+    setX264Preset: 'runtime',
+};
+const getConfigMethodsWithLifecycle = (lifecycle) => {
+    return new Set(Object.entries(configMethodLifecycles)
+        .filter(([, value]) => value === lifecycle)
+        .map(([methodName]) => methodName));
+};
+const runtimeConfigMethods = getConfigMethodsWithLifecycle('runtime');
+const reloadConfigMethods = getConfigMethodsWithLifecycle('reload');
+const ignoredAstProperties = new Set([
+    'comments',
+    'end',
+    'errors',
+    'extra',
+    'loc',
+    'start',
+]);
+const getStaticPropertyName = (node) => {
+    var _a;
+    if (!node || typeof node !== 'object') {
+        return null;
+    }
+    const candidate = node;
+    if (candidate.type === 'Identifier') {
+        return (_a = candidate.name) !== null && _a !== void 0 ? _a : null;
+    }
+    if (candidate.type === 'StringLiteral') {
+        return typeof candidate.value === 'string' ? candidate.value : null;
+    }
+    return null;
+};
+const getConfigMethodName = (node) => {
+    if (!node || typeof node !== 'object') {
+        return null;
+    }
+    const callExpression = node;
+    if (callExpression.type !== 'CallExpression' ||
+        !callExpression.callee ||
+        typeof callExpression.callee !== 'object') {
+        return null;
+    }
+    const callee = callExpression.callee;
+    if (callee.type !== 'MemberExpression') {
+        return null;
+    }
+    const methodName = getStaticPropertyName(callee.property);
+    if (!methodName || !callee.object || typeof callee.object !== 'object') {
+        return null;
+    }
+    const configObject = callee.object;
+    if ((configObject.type === 'Identifier' && configObject.name === 'Config') ||
+        (configObject.type === 'MemberExpression' &&
+            getStaticPropertyName(configObject.property) === 'Config')) {
+        return methodName;
+    }
+    return null;
+};
+const isConfigRequire = (node) => {
+    var _a;
+    if (!node || typeof node !== 'object') {
+        return false;
+    }
+    const declarator = node;
+    if (declarator.type !== 'VariableDeclarator' ||
+        !declarator.init ||
+        typeof declarator.init !== 'object') {
+        return false;
+    }
+    const init = declarator.init;
+    if (init.type !== 'CallExpression' ||
+        !init.callee ||
+        typeof init.callee !== 'object' ||
+        init.callee.type !== 'Identifier' ||
+        init.callee.name !== 'require' ||
+        ((_a = init.arguments) === null || _a === void 0 ? void 0 : _a.length) !== 1) {
+        return false;
+    }
+    const source = init.arguments[0];
+    return ((source === null || source === void 0 ? void 0 : source.type) === 'StringLiteral' && source.value === '@remotion/cli/config');
+};
+const makeConfigFingerprint = ({ code, ignoredConfigMethods, }) => {
+    const ast = (0, parser_1.parse)(code, { sourceType: 'unambiguous' });
+    const omit = Symbol('omit');
+    const normalize = (value) => {
+        var _a;
+        if (Array.isArray(value)) {
+            return value
+                .map(normalize)
+                .filter((normalizedValue) => normalizedValue !== omit);
+        }
+        if (!value || typeof value !== 'object') {
+            return value;
+        }
+        const node = value;
+        const expressionConfigMethodName = getConfigMethodName(node.expression);
+        if (node.type === 'ExpressionStatement' &&
+            expressionConfigMethodName &&
+            ignoredConfigMethods.has(expressionConfigMethodName)) {
+            return omit;
+        }
+        if (node.type === 'VariableDeclaration' &&
+            ((_a = node.declarations) === null || _a === void 0 ? void 0 : _a.length) &&
+            node.declarations.every(isConfigRequire)) {
+            return omit;
+        }
+        const configMethodName = getConfigMethodName(value);
+        if (configMethodName && ignoredConfigMethods.has(configMethodName)) {
+            return { type: 'IgnoredConfigCall' };
+        }
+        return Object.fromEntries(Object.entries(value)
+            .filter(([key]) => !ignoredAstProperties.has(key))
+            .map(([key, child]) => [key, normalize(child)]));
+    };
+    return JSON.stringify(normalize(ast));
+};
+const makeConfigFileFingerprints = (code) => {
+    return {
+        reload: makeConfigFingerprint({
+            code,
+            ignoredConfigMethods: runtimeConfigMethods,
+        }),
+        restart: makeConfigFingerprint({
+            code,
+            ignoredConfigMethods: new Set([
+                ...runtimeConfigMethods,
+                ...reloadConfigMethods,
+            ]),
+        }),
+    };
+};
+exports.makeConfigFileFingerprints = makeConfigFileFingerprints;
+const classifyConfigFileChange = ({ currentCode, startupFingerprints, }) => {
+    const currentFingerprints = (0, exports.makeConfigFileFingerprints)(currentCode);
+    if (currentFingerprints.restart !== startupFingerprints.restart) {
+        return 'restart';
+    }
+    if (currentFingerprints.reload !== startupFingerprints.reload) {
+        return 'reload';
+    }
+    return 'runtime';
+};
+exports.classifyConfigFileChange = classifyConfigFileChange;

package/dist/get-config-file-name.d.ts

@@ -1,5 +1,17 @@
 export declare const getLoadedConfigFile: () => string | null;
+export declare const getLoadedConfigFileCode: () => string | null;
 export declare const loadConfig: (remotionRoot: string) => Promise<string | null>;
-export declare const reloadConfig: ({ resetConfigOptions, }: {
+type ReloadConfigResult<T> = {
+    type: 'success';
+    value: T;
+} | {
+    type: 'error';
+    errorMessage: string;
+} | {
+    type: 'no-config';
+};
+export declare const reloadConfig: <T>({ resetConfigOptions, getConfigSnapshot, }: {
     resetConfigOptions: () => void;
-}) => Promise<boolean>;
+    getConfigSnapshot: (configFileCode: string) => T | Promise<T>;
+}) => Promise<ReloadConfigResult<T>>;
+export {};

package/dist/get-config-file-name.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.reloadConfig = exports.loadConfig = exports.getLoadedConfigFile = void 0;
+exports.reloadConfig = exports.loadConfig = exports.getLoadedConfigFileCode = exports.getLoadedConfigFile = void 0;
 const node_fs_1 = require("node:fs");
 const node_path_1 = __importDefault(require("node:path"));
 const client_1 = require("@remotion/renderer/client");
@@ -20,6 +20,11 @@ const getLoadedConfigFile = () => {
     return (_a = loadedConfigFile === null || loadedConfigFile === void 0 ? void 0 : loadedConfigFile.resolved) !== null && _a !== void 0 ? _a : null;
 };
 exports.getLoadedConfigFile = getLoadedConfigFile;
+const getLoadedConfigFileCode = () => {
+    var _a;
+    return (_a = loadedConfigFile === null || loadedConfigFile === void 0 ? void 0 : loadedConfigFile.code) !== null && _a !== void 0 ? _a : null;
+};
+exports.getLoadedConfigFileCode = getLoadedConfigFileCode;
 const warnAboutBundlerOverride = () => {
     const useRspack = rspackOption.getValue({ commandLine: parsed_cli_1.parsedCli }).value;
     const hasWebpackOverride = config_1.ConfigInternals.getWebpackOverrideFn() !==
@@ -79,9 +84,12 @@ const loadConfig = async (remotionRoot) => {
     return null;
 };
 exports.loadConfig = loadConfig;
-const reloadConfig = async ({ resetConfigOptions, }) => {
+const logConfigReloadError = (errorMessage) => {
+    log_1.Log.error({ indent: false, logLevel: 'error' }, 'Could not reload the Remotion config. Keeping the previous configuration.', errorMessage);
+};
+const reloadConfig = async ({ resetConfigOptions, getConfigSnapshot, }) => {
     if (!loadedConfigFile) {
-        return false;
+        return { type: 'no-config' };
     }
     const previousConfigFile = loadedConfigFile;
     let nextConfigFile;
@@ -89,21 +97,24 @@ const reloadConfig = async ({ resetConfigOptions, }) => {
         nextConfigFile = await (0, load_config_1.prepareConfigFile)(previousConfigFile.remotionRoot, previousConfigFile.resolved, previousConfigFile.resolved.endsWith('.js'));
     }
     catch (error) {
-        log_1.Log.error({ indent: false, logLevel: 'error' }, 'Could not reload the Remotion config. Keeping the previous configuration.', error instanceof Error ? error.message : String(error));
-        return false;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logConfigReloadError(errorMessage);
+        return { type: 'error', errorMessage };
     }
     resetConfigOptions();
     try {
         (0, load_config_1.executeConfigFile)(nextConfigFile);
-        loadedConfigFile = nextConfigFile;
+        const configSnapshot = await getConfigSnapshot(nextConfigFile.code);
         warnAboutBundlerOverride();
-        return true;
+        loadedConfigFile = nextConfigFile;
+        return { type: 'success', value: configSnapshot };
     }
     catch (error) {
         resetConfigOptions();
         (0, load_config_1.executeConfigFile)(previousConfigFile);
-        log_1.Log.error({ indent: false, logLevel: 'error' }, 'Could not reload the Remotion config. Keeping the previous configuration.', error instanceof Error ? error.message : String(error));
-        return false;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logConfigReloadError(errorMessage);
+        return { type: 'error', errorMessage };
     }
 };
 exports.reloadConfig = reloadConfig;

package/dist/parsed-cli.d.ts

@@ -351,6 +351,21 @@ declare const benchmarkConcurrenciesOption: {
     };
     setConfig: (value: boolean) => void;
     id: "dark-mode";
+}, defaultCodingAgentOption: {
+    name: string;
+    cliFlag: "coding-agent";
+    description: () => import("react/jsx-runtime").JSX.Element;
+    ssrName: null;
+    docLink: string;
+    type: "claude-code" | "codex" | "cursor" | "github-copilot" | null;
+    getValue: ({ commandLine }: {
+        commandLine: Record<string, unknown>;
+    }) => {
+        value: "claude-code" | "codex" | "cursor" | "github-copilot" | null;
+        source: string;
+    };
+    setConfig(value: "claude-code" | "codex" | "cursor" | "github-copilot" | null): void;
+    id: "coding-agent";
 }, defaultEditorOption: {
     name: string;
     cliFlag: "editor";
@@ -1190,6 +1205,7 @@ export type CommandLineOptions = {
     [envFileOption.cliFlag]: TypeOfOption<typeof envFileOption>;
     [ignoreCertificateErrorsOption.cliFlag]: TypeOfOption<typeof ignoreCertificateErrorsOption> | null;
     [darkModeOption.cliFlag]: TypeOfOption<typeof darkModeOption> | null;
+    [defaultCodingAgentOption.cliFlag]: TypeOfOption<typeof defaultCodingAgentOption>;
     [defaultEditorOption.cliFlag]: TypeOfOption<typeof defaultEditorOption>;
     [disableWebSecurityOption.cliFlag]: TypeOfOption<typeof disableWebSecurityOption> | null;
     [everyNthFrameOption.cliFlag]: TypeOfOption<typeof everyNthFrameOption>;

package/dist/parsed-cli.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.quietFlagProvided = exports.parsedCli = exports.BooleanFlags = void 0;
 const client_1 = require("@remotion/renderer/client");
 const minimist_1 = __importDefault(require("minimist"));
-const { benchmarkConcurrenciesOption, beepOnFinishOption, colorSpaceOption, concurrencyOption, disallowParallelEncodingOption, offthreadVideoCacheSizeInBytesOption, encodingBufferSizeOption, encodingMaxRateOption, deleteAfterOption, folderExpiryOption, enableMultiprocessOnLinuxOption, numberOfGifLoopsOption, x264Option, enforceAudioOption, jpegQualityOption, audioBitrateOption, videoBitrateOption, audioCodecOption, publicPathOption, audioLatencyHintOption, darkModeOption, defaultEditorOption, publicLicenseKeyOption, forceNewStudioOption, numberOfSharedAudioTagsOption, ipv4Option, pixelFormatOption, browserExecutableOption, everyNthFrameOption, proResProfileOption, userAgentOption, disableWebSecurityOption, ignoreCertificateErrorsOption, overrideHeightOption, overrideWidthOption, overrideFpsOption, overrideDurationOption, outDirOption, packageManagerOption, webpackPollOption, keyboardShortcutsOption, interactivityOption, imageSequencePatternOption, scaleOption, overwriteOption, crfOption, logLevelOption, videoCodecOption, stillFrameOption, imageSequenceOption, versionFlagOption, bundleCacheOption, envFileOption, glOption, gopSizeOption, runsOption, reproOption, mutedOption, headlessOption, disableGitSourceOption, delayRenderTimeoutInMillisecondsOption, framesOption, forSeamlessAacConcatenationOption, isProductionOption, noOpenOption, portOption, propsOption, configOption, browserOption, sampleRateOption, previewSampleRateOption, rspackOption, skipSkillsOption, } = client_1.BrowserSafeApis.options;
+const { benchmarkConcurrenciesOption, beepOnFinishOption, colorSpaceOption, concurrencyOption, disallowParallelEncodingOption, offthreadVideoCacheSizeInBytesOption, encodingBufferSizeOption, encodingMaxRateOption, deleteAfterOption, folderExpiryOption, enableMultiprocessOnLinuxOption, numberOfGifLoopsOption, x264Option, enforceAudioOption, jpegQualityOption, audioBitrateOption, videoBitrateOption, audioCodecOption, publicPathOption, audioLatencyHintOption, darkModeOption, defaultCodingAgentOption, defaultEditorOption, publicLicenseKeyOption, forceNewStudioOption, numberOfSharedAudioTagsOption, ipv4Option, pixelFormatOption, browserExecutableOption, everyNthFrameOption, proResProfileOption, userAgentOption, disableWebSecurityOption, ignoreCertificateErrorsOption, overrideHeightOption, overrideWidthOption, overrideFpsOption, overrideDurationOption, outDirOption, packageManagerOption, webpackPollOption, keyboardShortcutsOption, interactivityOption, imageSequencePatternOption, scaleOption, overwriteOption, crfOption, logLevelOption, videoCodecOption, stillFrameOption, imageSequenceOption, versionFlagOption, bundleCacheOption, envFileOption, glOption, gopSizeOption, runsOption, reproOption, mutedOption, headlessOption, disableGitSourceOption, delayRenderTimeoutInMillisecondsOption, framesOption, forSeamlessAacConcatenationOption, isProductionOption, noOpenOption, portOption, propsOption, configOption, browserOption, sampleRateOption, previewSampleRateOption, rspackOption, skipSkillsOption, } = client_1.BrowserSafeApis.options;
 exports.BooleanFlags = [
     overwriteOption.cliFlag,
     imageSequenceOption.cliFlag,

package/dist/studio.js

@@ -3,8 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.studioCommand = void 0;
 const client_1 = require("@remotion/renderer/client");
 const studio_server_1 = require("@remotion/studio-server");
+const studio_shared_1 = require("@remotion/studio-shared");
 const chalk_1 = require("./chalk");
 const config_1 = require("./config");
+const config_file_change_1 = require("./config-file-change");
 const convert_entry_point_to_serve_url_1 = require("./convert-entry-point-to-serve-url");
 const entry_point_1 = require("./entry-point");
 const get_config_file_name_1 = require("./get-config-file-name");
@@ -15,7 +17,7 @@ const get_render_defaults_1 = require("./get-render-defaults");
 const log_1 = require("./log");
 const parsed_cli_1 = require("./parsed-cli");
 const queue_1 = require("./render-queue/queue");
-const { binariesDirectoryOption, publicDirOption, disableGitSourceOption, enableCrossSiteIsolationOption, askAIOption, interactivityOption, keyboardShortcutsOption, forceNewStudioOption, numberOfSharedAudioTagsOption, audioLatencyHintOption, ipv4Option, rspackOption, webpackPollOption, noOpenOption, portOption, browserOption, previewSampleRateOption, defaultEditorOption, } = client_1.BrowserSafeApis.options;
+const { binariesDirectoryOption, publicDirOption, disableGitSourceOption, enableCrossSiteIsolationOption, askAIOption, interactivityOption, keyboardShortcutsOption, forceNewStudioOption, numberOfSharedAudioTagsOption, audioLatencyHintOption, ipv4Option, rspackOption, webpackPollOption, noOpenOption, portOption, browserOption, previewSampleRateOption, defaultCodingAgentOption, defaultEditorOption, } = client_1.BrowserSafeApis.options;
 const studioCommand = async (remotionRoot, args, logLevel) => {
     var _a, _b, _c;
     const { file, reason } = (0, entry_point_1.findEntryPoint)({
@@ -35,36 +37,6 @@ const studioCommand = async (remotionRoot, args, logLevel) => {
     const fullEntryPath = (0, convert_entry_point_to_serve_url_1.convertEntryPointToServeUrl)(file);
     studio_server_1.StudioServerInternals.setFileWatcherRegistry(studio_server_1.StudioServerInternals.createFileWatcherRegistry());
     const configFile = (0, get_config_file_name_1.getLoadedConfigFile)();
-    if (configFile) {
-        let isReloadingConfig = false;
-        studio_server_1.StudioServerInternals.installFileWatcher({
-            file: configFile,
-            existenceOnly: false,
-            onChange: async () => {
-                if (isReloadingConfig) {
-                    return;
-                }
-                isReloadingConfig = true;
-                try {
-                    const configWasReloaded = await (0, get_config_file_name_1.reloadConfig)({
-                        resetConfigOptions: config_1.ConfigInternals.resetConfigOptions,
-                    });
-                    if (!configWasReloaded) {
-                        return;
-                    }
-                    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue('Config file changed. Reloading Studio'));
-                    studio_server_1.StudioServerInternals.waitForLiveEventsListener().then((listener) => {
-                        listener.sendEventToClient({
-                            type: 'config-file-changed',
-                        });
-                    });
-                }
-                finally {
-                    isReloadingConfig = false;
-                }
-            },
-        });
-    }
     let inputProps = (0, get_input_props_1.getInputProps)((newProps) => {
         studio_server_1.StudioServerInternals.waitForLiveEventsListener().then((listener) => {
             inputProps = newProps;
@@ -118,7 +90,79 @@ const studioCommand = async (remotionRoot, args, logLevel) => {
     const getNumberOfAudioTags = () => numberOfSharedAudioTagsOption.getValue({ commandLine: parsed_cli_1.parsedCli }).value;
     const getAudioLatencyHint = () => audioLatencyHintOption.getValue({ commandLine: parsed_cli_1.parsedCli }).value;
     const getPreviewSampleRate = () => previewSampleRateOption.getValue({ commandLine: parsed_cli_1.parsedCli }).value;
+    const getDefaultCodingAgent = () => defaultCodingAgentOption.getValue({ commandLine: parsed_cli_1.parsedCli }).value;
     const getDefaultEditor = () => defaultEditorOption.getValue({ commandLine: parsed_cli_1.parsedCli }).value;
+    const startupConfigCode = (0, get_config_file_name_1.getLoadedConfigFileCode)();
+    if (configFile && startupConfigCode) {
+        let isReloadingConfig = false;
+        let startupConfigFingerprints = null;
+        const sendConfigFileReloadError = (errorMessage) => {
+            studio_server_1.StudioServerInternals.waitForLiveEventsListener().then((listener) => {
+                listener.sendEventToClient({
+                    type: 'config-file-reload-failed',
+                    errorMessage,
+                });
+            });
+        };
+        studio_server_1.StudioServerInternals.installFileWatcher({
+            file: configFile,
+            existenceOnly: false,
+            onChange: async () => {
+                if (isReloadingConfig) {
+                    return;
+                }
+                isReloadingConfig = true;
+                try {
+                    const reloadResult = await (0, get_config_file_name_1.reloadConfig)({
+                        resetConfigOptions: config_1.ConfigInternals.resetConfigOptions,
+                        getConfigSnapshot: async (currentConfigCode) => {
+                            startupConfigFingerprints !== null && startupConfigFingerprints !== void 0 ? startupConfigFingerprints : (startupConfigFingerprints = (0, config_file_change_1.makeConfigFileFingerprints)(startupConfigCode));
+                            const configFileChangeType = (0, config_file_change_1.classifyConfigFileChange)({
+                                currentCode: currentConfigCode,
+                                startupFingerprints: startupConfigFingerprints,
+                            });
+                            return {
+                                changeType: configFileChangeType,
+                                renderDefaults: (0, get_render_defaults_1.getRenderDefaults)(logLevel),
+                                studioRuntimeConfig: getStudioRuntimeConfig(),
+                                editorName: await studio_server_1.StudioServerInternals.getEditorName({
+                                    getDefaultEditor,
+                                    logLevel,
+                                }),
+                            };
+                        },
+                    });
+                    if (reloadResult.type === 'no-config') {
+                        return;
+                    }
+                    if (reloadResult.type === 'error') {
+                        sendConfigFileReloadError(reloadResult.errorMessage);
+                        return;
+                    }
+                    const { changeType, renderDefaults, studioRuntimeConfig, editorName } = reloadResult.value;
+                    const message = (0, studio_shared_1.getConfigFileChangeMessage)(changeType);
+                    log_1.Log.info({ indent: false, logLevel }, chalk_1.chalk.blue(message));
+                    studio_server_1.StudioServerInternals.waitForLiveEventsListener().then((listener) => {
+                        listener.sendEventToClient({
+                            type: 'config-file-changed',
+                            changeType,
+                            renderDefaults,
+                            studioRuntimeConfig,
+                            editorName,
+                        });
+                    });
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    log_1.Log.error({ indent: false, logLevel: 'error' }, errorMessage);
+                    sendConfigFileReloadError(errorMessage);
+                }
+                finally {
+                    isReloadingConfig = false;
+                }
+            },
+        });
+    }
     const result = await studio_server_1.StudioServerInternals.startStudio({
         previewEntry: require.resolve('@remotion/studio/previewEntry'),
         browserArgs: parsed_cli_1.parsedCli['browser-args'],
@@ -158,6 +202,7 @@ const studioCommand = async (remotionRoot, args, logLevel) => {
         forceIPv4: ipv4Option.getValue({ commandLine: parsed_cli_1.parsedCli }).value,
         getAudioLatencyHint,
         getPreviewSampleRate,
+        getDefaultCodingAgent,
         getDefaultEditor,
         enableCrossSiteIsolation,
         forceNew: forceNewStudioOption.getValue({ commandLine: parsed_cli_1.parsedCli }).value,

package/package.json

@@ -3,7 +3,7 @@
 		"url": "https://github.com/remotion-dev/remotion/tree/main/packages/cli"
 	},
 	"name": "@remotion/cli",
-	"version": "4.0.505",
+	"version": "4.0.506",
 	"description": "Control Remotion features using the `npx remotion` command",
 	"main": "dist/index.js",
 	"bin": {
@@ -36,18 +36,19 @@
 	"author": "Jonny Burger <jonny@remotion.dev>",
 	"license": "SEE LICENSE IN LICENSE.md",
 	"dependencies": {
-		"@remotion/bundler": "4.0.505",
-		"@remotion/media-utils": "4.0.505",
-		"@remotion/player": "4.0.505",
-		"@remotion/renderer": "4.0.505",
-		"@remotion/studio-shared": "4.0.505",
-		"@remotion/studio-server": "4.0.505",
-		"@remotion/studio": "4.0.505",
+		"@babel/parser": "7.24.1",
+		"@remotion/bundler": "4.0.506",
+		"@remotion/media-utils": "4.0.506",
+		"@remotion/player": "4.0.506",
+		"@remotion/renderer": "4.0.506",
+		"@remotion/studio-shared": "4.0.506",
+		"@remotion/studio-server": "4.0.506",
+		"@remotion/studio": "4.0.506",
 		"dotenv": "17.3.1",
 		"minimist": "1.2.6",
 		"prompts": "2.4.2",
 		"semver": "7.5.3",
-		"remotion": "4.0.505"
+		"remotion": "4.0.506"
 	},
 	"peerDependencies": {
 		"react": ">=16.8.0",
@@ -59,14 +60,14 @@
 		"@types/prettier": "2.7.2",
 		"@types/semver": "7.5.3",
 		"@types/node": "20.12.14",
-		"@remotion/zod-types": "4.0.505",
-		"@remotion/tailwind-v4": "4.0.505",
-		"@remotion/enable-scss": "4.0.505",
-		"@remotion/skia": "4.0.505",
+		"@remotion/zod-types": "4.0.506",
+		"@remotion/tailwind-v4": "4.0.506",
+		"@remotion/enable-scss": "4.0.506",
+		"@remotion/skia": "4.0.506",
 		"react": "19.2.3",
 		"react-dom": "19.2.3",
 		"zod": "4.4.3",
-		"@remotion/eslint-config-internal": "4.0.505",
+		"@remotion/eslint-config-internal": "4.0.506",
 		"eslint": "9.19.0",
 		"@typescript/native-preview": "7.0.0-dev.20260217.1"
 	},