@remotion/studio-server 4.0.534 → 4.0.535

package/dist/file-watcher.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.writeFileAndNotifyFileWatchers = exports.installFileWatcher = exports.getFileWatcherRegistry = exports.setFileWatcherRegistry = exports.createFileWatcherRegistry = void 0;
 const node_fs_1 = __importStar(require("node:fs"));
+const watch_ignore_next_change_1 = require("./preview-server/watch-ignore-next-change");
 const getRegistryKey = (file, existenceOnly) => existenceOnly ? `${file}\0existence-only` : file;
 const createFileWatcherRegistry = () => {
     const sharedWatchers = new Map();
@@ -130,6 +131,7 @@ const createFileWatcherRegistry = () => {
     };
     const _writeFileAndNotifyFileWatchers = ({ file, content, originatorClientId, metadata, }) => {
         var _a;
+        (0, watch_ignore_next_change_1.prepareBundlerForFileWrite)(file);
         (0, node_fs_1.writeFileSync)(file, content);
         const shared = sharedWatchers.get(getRegistryKey(file, false));
         if (!shared) {

package/dist/helpers/app-discovery.d.ts

@@ -0,0 +1,9 @@
+import type { DefaultEditor } from '@remotion/renderer';
+import type { GetDefaultEditorInfoResponse } from '@remotion/studio-shared';
+export declare const getAppDiscovery: () => Promise<{
+    installedEditors: readonly import("./editor-registry").InstalledEditor[];
+    installedCodingAgents: readonly import("./coding-agent-registry").InstalledCodingAgent[];
+    runningEditors: readonly ("cursor" | "sublime-text" | "vscode" | "vscodium" | "webstorm" | "windsurf" | "zed")[];
+    runningCodingAgents: readonly ("claude-code" | "codex" | "copilot" | "cursor")[];
+}>;
+export declare const getEditorInfo: (configuredEditor: DefaultEditor | null) => Promise<GetDefaultEditorInfoResponse>;

package/dist/helpers/app-discovery.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEditorInfo = exports.getAppDiscovery = void 0;
+const coding_agent_registry_1 = require("./coding-agent-registry");
+const custom_editor_1 = require("./custom-editor");
+const editor_registry_1 = require("./editor-registry");
+let appDiscovery = null;
+const discoverApps = async () => {
+    const [installedEditors, installedCodingAgents] = await Promise.all([
+        (0, editor_registry_1.getAvailableEditors)(),
+        (0, coding_agent_registry_1.getAvailableCodingAgents)(),
+    ]);
+    const [runningEditors, runningCodingAgents] = await Promise.all([
+        (0, editor_registry_1.getRunningEditors)(installedEditors),
+        (0, coding_agent_registry_1.getRunningCodingAgents)(installedCodingAgents),
+    ]);
+    return {
+        installedEditors,
+        installedCodingAgents,
+        runningEditors,
+        runningCodingAgents,
+    };
+};
+// The terminal helper and Studio requests share the same in-flight discovery
+// and process snapshot. Configuration and app history are read separately.
+const getAppDiscovery = () => {
+    appDiscovery !== null && appDiscovery !== void 0 ? appDiscovery : (appDiscovery = discoverApps());
+    return appDiscovery;
+};
+exports.getAppDiscovery = getAppDiscovery;
+const getEditorInfo = async (configuredEditor) => {
+    const { installedEditors, runningEditors } = await (0, exports.getAppDiscovery)();
+    const customEditor = configuredEditor &&
+        typeof configuredEditor === 'object' &&
+        (0, custom_editor_1.resolveCustomEditorExecutable)(configuredEditor)
+        ? configuredEditor
+        : null;
+    return {
+        defaultEditor: configuredEditor && typeof configuredEditor === 'object'
+            ? 'custom'
+            : configuredEditor,
+        runningEditors,
+        installedEditors: [
+            ...installedEditors.map(({ id, name, nameWithType }) => ({
+                id,
+                name,
+                nameWithType,
+            })),
+            ...(customEditor
+                ? [
+                    {
+                        id: 'custom',
+                        name: customEditor.name,
+                        nameWithType: customEditor.name,
+                    },
+                ]
+                : []),
+        ],
+    };
+};
+exports.getEditorInfo = getEditorInfo;

package/dist/helpers/open-in-app.d.ts

@@ -0,0 +1,13 @@
+import { type DefaultEditor } from '@remotion/renderer';
+import type { OpenInCodingAgentRequest, OpenInCodingAgentResponse, OpenInEditorRequest, OpenInEditorResponse } from '@remotion/studio-shared';
+export declare const openInEditor: ({ input, remotionRoot, logLevel, getDefaultEditor, }: {
+    input: OpenInEditorRequest;
+    remotionRoot: string;
+    logLevel: "error" | "info" | "trace" | "verbose" | "warn";
+    getDefaultEditor: () => DefaultEditor | null;
+}) => Promise<OpenInEditorResponse>;
+export declare const openInCodingAgent: ({ input, logLevel, remotionRoot, }: {
+    input: OpenInCodingAgentRequest;
+    logLevel: "error" | "info" | "trace" | "verbose" | "warn";
+    remotionRoot: string;
+}) => Promise<OpenInCodingAgentResponse>;

package/dist/helpers/open-in-app.js

@@ -0,0 +1,72 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openInCodingAgent = exports.openInEditor = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const renderer_1 = require("@remotion/renderer");
+const coding_agent_registry_1 = require("./coding-agent-registry");
+const custom_editor_1 = require("./custom-editor");
+const open_in_editor_1 = require("./open-in-editor");
+const resolve_editor_1 = require("./resolve-editor");
+const openInEditor = async ({ input, remotionRoot, logLevel, getDefaultEditor, }) => {
+    try {
+        if (!('stack' in input)) {
+            throw new TypeError('Need to pass stack');
+        }
+        const { stack } = input;
+        if (input.editorId !== null &&
+            input.editorId !== 'custom' &&
+            !renderer_1.defaultEditorIds.includes(input.editorId)) {
+            return { success: false };
+        }
+        const editor = await (0, resolve_editor_1.resolveEditor)({
+            defaultEditor: getDefaultEditor(),
+            logLevel,
+            preferredEditor: input.editorId,
+        });
+        if (!editor) {
+            return { success: false };
+        }
+        const fileName = node_path_1.default.resolve(remotionRoot, stack.originalFileName);
+        const didOpen = editor.type === 'custom'
+            ? await (0, custom_editor_1.launchCustomEditor)({
+                editor: editor.editor,
+                resolvedExecutable: editor,
+                targetPath: fileName,
+                lineNumber: stack.originalLineNumber,
+                columnNumber: stack.originalColumnNumber,
+                logLevel,
+                spawnProcess: null,
+            })
+            : await (0, open_in_editor_1.launchEditor)({
+                colNumber: stack.originalColumnNumber,
+                editor,
+                fileName,
+                lineNumber: stack.originalLineNumber,
+                vsCodeNewWindow: false,
+                logLevel,
+            }, remotionRoot);
+        return { success: didOpen };
+    }
+    catch (_a) {
+        return { success: false };
+    }
+};
+exports.openInEditor = openInEditor;
+const openInCodingAgent = async ({ input, logLevel, remotionRoot, }) => {
+    const codingAgent = (await (0, coding_agent_registry_1.getAvailableCodingAgents)()).find((agent) => agent.id === input.codingAgentId);
+    if (!codingAgent) {
+        return { success: false };
+    }
+    return {
+        success: await (0, coding_agent_registry_1.launchCodingAgent)({
+            codingAgent,
+            projectPath: remotionRoot,
+            logLevel,
+            prompt: input.prompt,
+        }),
+    };
+};
+exports.openInCodingAgent = openInCodingAgent;

package/dist/helpers/open-in-editor.js

@@ -382,9 +382,8 @@ async function launchEditor({ colNumber, editor, fileName, lineNumber, vsCodeNew
     if (editor.command.toLowerCase() === 'none') {
         return false;
     }
-    let folderToOpen = isVsCodeDerivative(editor.command) && !node_fs_1.default.statSync(fileName).isDirectory()
-        ? projectFolder
-        : null;
+    const isDirectory = node_fs_1.default.statSync(fileName).isDirectory();
+    let folderToOpen = isVsCodeDerivative(editor.command) && !isDirectory ? projectFolder : null;
     if (process.platform === 'linux' &&
         fileName.startsWith('/mnt/') &&
         /Microsoft/i.test(node_os_1.default.release())) {
@@ -417,7 +416,7 @@ async function launchEditor({ colNumber, editor, fileName, lineNumber, vsCodeNew
     }
     const shouldOpenVsCodeNewWindow = isVsCodeDerivative(editor.command) && vsCodeNewWindow;
     // The file URL cannot specify both a workspace folder and a source location.
-    if (!shouldOpenVsCodeNewWindow && folderToOpen === null) {
+    if (!shouldOpenVsCodeNewWindow && folderToOpen === null && !isDirectory) {
         const result = (0, open_in_editor_url_scheme_1.openInEditorViaUrlScheme)({
             editor: editor.command,
             fileName,
@@ -433,13 +432,15 @@ async function launchEditor({ colNumber, editor, fileName, lineNumber, vsCodeNew
     }
     const args = shouldOpenVsCodeNewWindow
         ? ['--new-window', fileName]
-        : lineNumber
+        : lineNumber && !isDirectory
             ? getArgumentsForLineNumber(editor.command, fileName, String(lineNumber), colNumber)
             : [fileName];
     if (folderToOpen !== null) {
         args.unshift(folderToOpen);
     }
-    if (process.platform === 'darwin' && folderToOpen !== null) {
+    if (process.platform === 'darwin' &&
+        isVsCodeDerivative(editor.command) &&
+        (folderToOpen !== null || isDirectory)) {
         const applicationPath = (_a = editor.process.match(/^(.*?\.app)\/Contents\//)) === null || _a === void 0 ? void 0 : _a[1];
         if (applicationPath && node_fs_1.default.existsSync(applicationPath)) {
             // Match the CLI's native macOS launch without starting its Node.js wrapper.

package/dist/helpers/recently-used-apps.d.ts

@@ -0,0 +1,9 @@
+export declare const subscribeToRecentlyUsedApps: ({ remotionRoot, onChange, }: {
+    remotionRoot: string;
+    onChange: () => void;
+}) => () => void;
+export declare const getRecentlyUsedApps: ({ remotionRoot, type, recentlyUsedIds, }: {
+    remotionRoot: string;
+    type: "coding-agent" | "editor";
+    recentlyUsedIds: readonly string[] | null;
+}) => Promise<readonly string[]>;

package/dist/helpers/recently-used-apps.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRecentlyUsedApps = exports.subscribeToRecentlyUsedApps = void 0;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const renderer_1 = require("@remotion/renderer");
+const histories = new Map();
+const historyListeners = new Set();
+const subscribeToRecentlyUsedApps = ({ remotionRoot, onChange, }) => {
+    const listener = { remotionRoot, onChange };
+    historyListeners.add(listener);
+    return () => {
+        historyListeners.delete(listener);
+    };
+};
+exports.subscribeToRecentlyUsedApps = subscribeToRecentlyUsedApps;
+const getRecentlyUsedApps = ({ remotionRoot, type, recentlyUsedIds, }) => {
+    var _a;
+    const filePath = node_path_1.default.join(remotionRoot, 'node_modules', '.cache', 'remotion', `recently-used-${type}s.json`);
+    const allowedIds = type === 'editor' ? [...renderer_1.defaultEditorIds, 'custom'] : renderer_1.defaultCodingAgentIds;
+    const previous = (_a = histories.get(filePath)) !== null && _a !== void 0 ? _a : (async () => {
+        try {
+            const stored = JSON.parse(await (0, promises_1.readFile)(filePath, 'utf8'));
+            return Array.isArray(stored)
+                ? [
+                    ...new Set(stored.filter((id) => allowedIds.includes(id))),
+                ]
+                : [];
+        }
+        catch (_a) {
+            return [];
+        }
+    })();
+    const history = previous.then(async (ids) => {
+        if (recentlyUsedIds === null) {
+            return ids;
+        }
+        const updatedIds = [
+            ...new Set(recentlyUsedIds.filter((id) => allowedIds.includes(id))),
+        ];
+        if (JSON.stringify(ids) !== JSON.stringify(updatedIds)) {
+            try {
+                await (0, promises_1.mkdir)(node_path_1.default.dirname(filePath), { recursive: true });
+                await (0, promises_1.writeFile)(filePath, JSON.stringify(updatedIds));
+            }
+            catch (_a) {
+                // Keep the history in memory when the project cache is not writable.
+            }
+            historyListeners.forEach((listener) => {
+                if (listener.remotionRoot === remotionRoot) {
+                    listener.onChange();
+                }
+            });
+        }
+        return updatedIds;
+    });
+    histories.set(filePath, history);
+    return history;
+};
+exports.getRecentlyUsedApps = getRecentlyUsedApps;

package/dist/preview-server/api-routes.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.allApiRoutes = void 0;
+const open_in_app_1 = require("../helpers/open-in-app");
 const add_composition_1 = require("./routes/add-composition");
 const add_effect_1 = require("./routes/add-effect");
 const add_effect_keyframe_1 = require("./routes/add-effect-keyframe");
@@ -8,14 +9,13 @@ const add_folder_1 = require("./routes/add-folder");
 const add_keyframes_1 = require("./routes/add-keyframes");
 const add_render_1 = require("./routes/add-render");
 const add_sequence_keyframe_1 = require("./routes/add-sequence-keyframe");
+const app_info_1 = require("./routes/app-info");
 const apply_visual_control_change_1 = require("./routes/apply-visual-control-change");
 const batch_update_keyframe_settings_1 = require("./routes/batch-update-keyframe-settings");
 const cancel_render_1 = require("./routes/cancel-render");
 const composition_component_info_1 = require("./routes/composition-component-info");
 const convert_figma_clipboard_to_svg_1 = require("./routes/convert-figma-clipboard-to-svg");
 const copy_render_output_to_asset_1 = require("./routes/copy-render-output-to-asset");
-const default_coding_agent_1 = require("./routes/default-coding-agent");
-const default_editor_1 = require("./routes/default-editor");
 const delete_composition_1 = require("./routes/delete-composition");
 const delete_effect_1 = require("./routes/delete-effect");
 const delete_keyframes_1 = require("./routes/delete-keyframes");
@@ -95,7 +95,7 @@ exports.allApiRoutes = {
     '/api/open-in-terminal': open_in_terminal_1.openInTerminalHandler,
     '/api/open-in-git-client': open_in_git_client_1.openInGitClientHandler,
     '/api/open-in-editor': open_in_editor_1.openInEditorHandler,
-    '/api/open-in-coding-agent': default_coding_agent_1.openInCodingAgentHandler,
+    '/api/open-in-coding-agent': open_in_app_1.openInCodingAgent,
     '/api/register-client-render': register_client_render_1.registerClientRenderHandler,
     '/api/unregister-client-render': unregister_client_render_1.unregisterClientRenderHandler,
     '/api/update-default-props': update_default_props_1.updateDefaultPropsHandler,
@@ -152,8 +152,7 @@ exports.allApiRoutes = {
     '/api/upgrade-remotion': upgrade_remotion_1.handleUpgradeRemotion,
     '/api/shutdown-studio': shutdown_studio_1.handleShutdownStudio,
     '/api/restart-studio': restart_studio_1.handleRestartStudio,
-    '/api/default-coding-agent-info': default_coding_agent_1.getDefaultCodingAgentInfoHandler,
-    '/api/default-editor-info': default_editor_1.getDefaultEditorInfoHandler,
+    '/api/app-info': app_info_1.appInfoHandler,
     '/api/insert-composition-element': insert_composition_element_1.insertCompositionElementHandler,
     '/api/insert-element': insert_element_1.insertElementHandler,
     '/api/prepare-element-install': prepare_element_install_1.prepareElementInstallHandler,

package/dist/preview-server/live-events.d.ts

@@ -7,6 +7,7 @@ export type LiveEventsServer = {
     closeConnections: () => Promise<void>;
     addNewClientListener: (cb: () => void) => () => void;
 };
+export declare const subscribeToConfigChanges: (onChange: () => void) => () => void;
 export declare const clearPrintPortMessageTimeout: () => void;
 export type InitialUndoRedoState = {
     undoFile: string | null;

package/dist/preview-server/live-events.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setLiveEventsListener = exports.getLiveEventsListener = exports.waitForLiveEventsListener = exports.makeLiveEventsRouter = exports.clearPrintPortMessageTimeout = void 0;
+exports.setLiveEventsListener = exports.getLiveEventsListener = exports.waitForLiveEventsListener = exports.makeLiveEventsRouter = exports.clearPrintPortMessageTimeout = exports.subscribeToConfigChanges = void 0;
 const server_ready_1 = require("../server-ready");
 const default_props_watchers_1 = require("./default-props-watchers");
 const file_existence_watchers_1 = require("./file-existence-watchers");
@@ -9,6 +9,14 @@ const serializeMessage = (message) => {
     return `data: ${JSON.stringify(message)}\n\n`;
 };
 let printPortMessageTimeout = null;
+const configChangeListeners = new Set();
+const subscribeToConfigChanges = (onChange) => {
+    configChangeListeners.add(onChange);
+    return () => {
+        configChangeListeners.delete(onChange);
+    };
+};
+exports.subscribeToConfigChanges = subscribeToConfigChanges;
 const clearPrintPortMessageTimeout = () => {
     if (printPortMessageTimeout) {
         clearTimeout(printPortMessageTimeout);
@@ -57,6 +65,9 @@ const makeLiveEventsRouter = (logLevel, getInitialUndoRedoState) => {
         return Promise.resolve();
     };
     const sendEventToClient = (event) => {
+        if (event.type === 'config-file-changed') {
+            configChangeListeners.forEach((listener) => listener());
+        }
         clients.forEach((client) => {
             client.response.write(serializeMessage(event));
         });

package/dist/preview-server/routes/app-info.d.ts

@@ -0,0 +1,3 @@
+import type { GetAppInfoRequest, GetAppInfoResponse } from '@remotion/studio-shared';
+import type { ApiHandler } from '../api-types';
+export declare const appInfoHandler: ApiHandler<GetAppInfoRequest, GetAppInfoResponse>;

package/dist/preview-server/routes/app-info.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appInfoHandler = void 0;
+const default_coding_agent_1 = require("./default-coding-agent");
+const default_editor_1 = require("./default-editor");
+const appInfoHandler = async (params) => {
+    const [editorInfo, codingAgentInfo] = await Promise.all([
+        (0, default_editor_1.getDefaultEditorInfoHandler)({ ...params, input: params.input.editor }),
+        (0, default_coding_agent_1.getDefaultCodingAgentInfoHandler)({
+            ...params,
+            input: params.input.codingAgent,
+        }),
+    ]);
+    return { editorInfo, codingAgentInfo };
+};
+exports.appInfoHandler = appInfoHandler;

package/dist/preview-server/routes/default-coding-agent.d.ts

@@ -1,4 +1,3 @@
-import type { GetDefaultCodingAgentInfoRequest, GetDefaultCodingAgentInfoResponse, OpenInCodingAgentRequest, OpenInCodingAgentResponse } from '@remotion/studio-shared';
+import type { GetDefaultCodingAgentInfoRequest, GetDefaultCodingAgentInfoResponse } from '@remotion/studio-shared';
 import type { ApiHandler } from '../api-types';
 export declare const getDefaultCodingAgentInfoHandler: ApiHandler<GetDefaultCodingAgentInfoRequest, GetDefaultCodingAgentInfoResponse>;
-export declare const openInCodingAgentHandler: ApiHandler<OpenInCodingAgentRequest, OpenInCodingAgentResponse>;

package/dist/preview-server/routes/default-coding-agent.js

@@ -1,12 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.openInCodingAgentHandler = exports.getDefaultCodingAgentInfoHandler = void 0;
-const coding_agent_registry_1 = require("../../helpers/coding-agent-registry");
+exports.getDefaultCodingAgentInfoHandler = void 0;
+const app_discovery_1 = require("../../helpers/app-discovery");
 const git_client_registry_1 = require("../../helpers/git-client-registry");
+const recently_used_apps_1 = require("../../helpers/recently-used-apps");
 const terminal_registry_1 = require("../../helpers/terminal-registry");
-const getDefaultCodingAgentInfoHandler = async ({ getDefaultCodingAgent }) => {
-    const installedCodingAgents = await (0, coding_agent_registry_1.getAvailableCodingAgents)();
-    const runningCodingAgents = await (0, coding_agent_registry_1.getRunningCodingAgents)(installedCodingAgents);
+const getDefaultCodingAgentInfoHandler = async ({ getDefaultCodingAgent, input, remotionRoot }) => {
+    await (0, recently_used_apps_1.getRecentlyUsedApps)({
+        remotionRoot,
+        type: 'coding-agent',
+        recentlyUsedIds: input.recentlyUsedIds,
+    });
+    const { installedCodingAgents, runningCodingAgents } = await (0, app_discovery_1.getAppDiscovery)();
     const installedTerminals = await (0, terminal_registry_1.getAvailableTerminals)();
     const installedGitClients = await (0, git_client_registry_1.getAvailableGitClients)();
     return {
@@ -22,18 +27,3 @@ const getDefaultCodingAgentInfoHandler = async ({ getDefaultCodingAgent }) => {
     };
 };
 exports.getDefaultCodingAgentInfoHandler = getDefaultCodingAgentInfoHandler;
-const openInCodingAgentHandler = async ({ input, logLevel, remotionRoot }) => {
-    const codingAgent = (await (0, coding_agent_registry_1.getAvailableCodingAgents)()).find((agent) => agent.id === input.codingAgentId);
-    if (!codingAgent) {
-        return { success: false };
-    }
-    return {
-        success: await (0, coding_agent_registry_1.launchCodingAgent)({
-            codingAgent,
-            projectPath: remotionRoot,
-            logLevel,
-            prompt: input.prompt,
-        }),
-    };
-};
-exports.openInCodingAgentHandler = openInCodingAgentHandler;

package/dist/preview-server/routes/default-editor.js

@@ -1,38 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDefaultEditorInfoHandler = void 0;
-const custom_editor_1 = require("../../helpers/custom-editor");
-const editor_registry_1 = require("../../helpers/editor-registry");
-const getDefaultEditorInfoHandler = async ({ getDefaultEditor }) => {
-    const installedEditors = await (0, editor_registry_1.getAvailableEditors)();
-    const runningEditors = await (0, editor_registry_1.getRunningEditors)(installedEditors);
-    const configuredEditor = getDefaultEditor();
-    const customEditor = configuredEditor &&
-        typeof configuredEditor === 'object' &&
-        (0, custom_editor_1.resolveCustomEditorExecutable)(configuredEditor)
-        ? configuredEditor
-        : null;
-    return {
-        defaultEditor: configuredEditor && typeof configuredEditor === 'object'
-            ? 'custom'
-            : configuredEditor,
-        runningEditors,
-        installedEditors: [
-            ...installedEditors.map(({ id, name, nameWithType }) => ({
-                id,
-                name,
-                nameWithType,
-            })),
-            ...(customEditor
-                ? [
-                    {
-                        id: 'custom',
-                        name: customEditor.name,
-                        nameWithType: customEditor.name,
-                    },
-                ]
-                : []),
-        ],
-    };
+const app_discovery_1 = require("../../helpers/app-discovery");
+const recently_used_apps_1 = require("../../helpers/recently-used-apps");
+const getDefaultEditorInfoHandler = async ({ getDefaultEditor, input, remotionRoot }) => {
+    await (0, recently_used_apps_1.getRecentlyUsedApps)({
+        remotionRoot,
+        type: 'editor',
+        recentlyUsedIds: input.recentlyUsedIds,
+    });
+    return (0, app_discovery_1.getEditorInfo)(getDefaultEditor());
 };
 exports.getDefaultEditorInfoHandler = getDefaultEditorInfoHandler;

package/dist/preview-server/routes/element-install-plan.js

@@ -74,6 +74,11 @@ const getExpectedFileState = (existingSource) => {
 const getElementInstallPlan = async ({ destination, element, installationName, entryPoint, remotionRoot, }) => {
     var _a;
     (0, exports.validateElementForInstallation)(element);
+    if (destination.type === 'selected-media' &&
+        (element.isCaptionStyle !== true ||
+            element.installationMode !== 'component-owned-sequence')) {
+        throw new Error('The Element must be a component-owned caption style');
+    }
     const componentName = studio_protocol_1.StudioProtocolInternals.getElementComponentNameFromSourceCode(element.sourceCode);
     if (componentName === null) {
         throw new Error('Element source must export exactly one named component');

package/dist/preview-server/routes/insert-basic-captions.js

@@ -45,6 +45,7 @@ const insertBasicCaptionsHandler = ({ input: { fileName, nodePath, captions, dur
             },
         });
         const { output, logLine, nodePathRemappings } = insertBasicCaptions({
+            element: null,
             input: fileContents,
             nodePath,
             captions,

package/dist/preview-server/routes/insert-element.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.insertElementHandler = void 0;
 const node_fs_1 = require("node:fs");
 const node_path_1 = __importDefault(require("node:path"));
+const codemods_1 = require("@remotion/codemods");
 const renderer_1 = require("@remotion/renderer");
 const studio_protocol_1 = require("@remotion/studio-protocol");
 const add_composition_to_file_1 = require("../../codemods/add-composition-to-file");
@@ -33,10 +34,18 @@ const hasExpectedFileState = ({ expected, actual, }) => {
     }
     return actual.sourceHash === expected.sourceHash;
 };
-const insertElementHandler = async ({ input: { compositionFile, compositionId, element, installationName, expectedFileState, from, premountFor, position, overwriteExisting, undoRedoNavigation, newComposition, }, entryPoint, remotionRoot, logLevel, publicDir, }) => {
+const insertElementHandler = async ({ input: { compositionFile, compositionId, captionTarget, element, installationName, expectedFileState, from, premountFor, position, overwriteExisting, undoRedoNavigation, newComposition, }, entryPoint, remotionRoot, logLevel, publicDir, }) => {
     var _a;
     let resolvedAssets;
     try {
+        if (captionTarget !== null &&
+            (element.isCaptionStyle !== true ||
+                element.installationMode !== 'component-owned-sequence' ||
+                newComposition !== null ||
+                compositionFile !== null ||
+                compositionId !== null)) {
+            throw new Error('Invalid caption style installation target');
+        }
         studio_protocol_1.StudioProtocolInternals.assertElementAssets(element.assets);
         studio_protocol_1.StudioProtocolInternals.assertElementAssetReferences(element);
         resolvedAssets = await studio_protocol_1.StudioProtocolInternals.resolveElementAssets({
@@ -132,16 +141,21 @@ const insertElementHandler = async ({ input: { compositionFile, compositionId, e
                     [componentFilePath, componentFileContents],
                 ]);
             }
-            const installDestination = newComposition === null
+            const installDestination = captionTarget !== null
                 ? {
-                    type: 'current-composition',
-                    compositionFile,
-                    compositionId,
+                    type: 'selected-media',
+                    compositionFile: captionTarget.fileName,
                 }
-                : {
-                    type: 'new-composition',
-                    compositionFile,
-                };
+                : newComposition === null
+                    ? {
+                        type: 'current-composition',
+                        compositionFile,
+                        compositionId,
+                    }
+                    : {
+                        type: 'new-composition',
+                        compositionFile,
+                    };
             const plan = await (0, element_install_plan_1.getElementInstallPlan)({
                 installationName,
                 destination: installDestination,
@@ -235,10 +249,29 @@ const insertElementHandler = async ({ input: { compositionFile, compositionId, e
                         position,
                     },
             };
-            const inserted = await (0, resolve_composition_component_1.insertJsxElementIntoComposition)({
-                ...insertionInput,
-                sourceFileOverrides,
-            });
+            let inserted;
+            if (captionTarget === null) {
+                inserted = await (0, resolve_composition_component_1.insertJsxElementIntoComposition)({
+                    ...insertionInput,
+                    compositionFile,
+                    compositionId,
+                    sourceFileOverrides,
+                });
+            }
+            else {
+                const fileName = plan.safePaths.compositionFileName;
+                const oldContents = (0, node_fs_1.readFileSync)(fileName, 'utf-8');
+                inserted = {
+                    ...codemods_1.CodemodsInternals.insertBasicCaptions({
+                        ...captionTarget,
+                        input: oldContents,
+                        importPath: plan.importPath,
+                        element: { componentName: plan.componentName, initialProps },
+                    }),
+                    fileName,
+                    oldContents,
+                };
+            }
             if (compositionCreation !== null &&
                 inserted.fileName !== compositionCreation.componentFilePath) {
                 throw new Error('New composition component does not match installation target');

package/dist/preview-server/routes/open-in-editor.d.ts

@@ -1,4 +1,4 @@
-import { type DefaultEditor } from '@remotion/renderer';
+import type { DefaultEditor } from '@remotion/renderer';
 import type { OpenInEditorRequest, OpenInEditorResponse } from '@remotion/studio-shared';
 import type { ApiHandler } from '../api-types';
 export declare const getEditorName: ({ getDefaultEditor, logLevel, }: {

package/dist/preview-server/routes/open-in-editor.js

@@ -1,13 +1,7 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.openInEditorHandler = exports.getEditorName = void 0;
-const node_path_1 = __importDefault(require("node:path"));
-const renderer_1 = require("@remotion/renderer");
-const custom_editor_1 = require("../../helpers/custom-editor");
-const open_in_editor_1 = require("../../helpers/open-in-editor");
+const open_in_app_1 = require("../../helpers/open-in-app");
 const resolve_editor_1 = require("../../helpers/resolve-editor");
 const getEditorName = async ({ getDefaultEditor, logLevel, }) => {
     var _a;
@@ -19,52 +13,4 @@ const getEditorName = async ({ getDefaultEditor, logLevel, }) => {
     return (_a = editor === null || editor === void 0 ? void 0 : editor.nameWithType) !== null && _a !== void 0 ? _a : null;
 };
 exports.getEditorName = getEditorName;
-const openInEditorHandler = async ({ input, remotionRoot, logLevel, getDefaultEditor }) => {
-    try {
-        if (!('stack' in input)) {
-            throw new TypeError('Need to pass stack');
-        }
-        const { stack } = input;
-        if (input.editorId !== null &&
-            input.editorId !== 'custom' &&
-            !renderer_1.defaultEditorIds.includes(input.editorId)) {
-            return { success: false };
-        }
-        const editor = await (0, resolve_editor_1.resolveEditor)({
-            defaultEditor: getDefaultEditor(),
-            logLevel,
-            preferredEditor: input.editorId,
-        });
-        if (!editor) {
-            return { success: false };
-        }
-        const fileName = node_path_1.default.resolve(remotionRoot, stack.originalFileName);
-        const didOpen = editor.type === 'custom'
-            ? await (0, custom_editor_1.launchCustomEditor)({
-                editor: editor.editor,
-                resolvedExecutable: editor,
-                targetPath: fileName,
-                lineNumber: stack.originalLineNumber,
-                columnNumber: stack.originalColumnNumber,
-                logLevel,
-                spawnProcess: null,
-            })
-            : await (0, open_in_editor_1.launchEditor)({
-                colNumber: stack.originalColumnNumber,
-                editor,
-                fileName,
-                lineNumber: stack.originalLineNumber,
-                vsCodeNewWindow: false,
-                logLevel,
-            }, remotionRoot);
-        return {
-            success: didOpen,
-        };
-    }
-    catch (_a) {
-        return {
-            success: false,
-        };
-    }
-};
-exports.openInEditorHandler = openInEditorHandler;
+exports.openInEditorHandler = open_in_app_1.openInEditor;

package/dist/preview-server/routes/redo.js

@@ -2,7 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.redoHandler = void 0;
 const undo_stack_1 = require("../undo-stack");
+const source_file_write_queue_1 = require("./source-file-write-queue");
 const redoHandler = () => {
-    return Promise.resolve((0, undo_stack_1.popRedo)());
+    return (0, source_file_write_queue_1.withSourceFileWriteQueue)(() => (0, undo_stack_1.popRedo)());
 };
 exports.redoHandler = redoHandler;

package/dist/preview-server/routes/source-file-write-queue.d.ts

@@ -1,2 +1,2 @@
 export declare const getCodemodTimingPrefix: (logLevel: "error" | "info" | "trace" | "verbose" | "warn") => string;
-export declare const withSourceFileWriteQueue: <T>(fn: () => Promise<T>) => Promise<T>;
+export declare const withSourceFileWriteQueue: <T>(fn: () => T | Promise<T>) => Promise<T>;

package/dist/preview-server/routes/undo.js

@@ -2,7 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.undoHandler = void 0;
 const undo_stack_1 = require("../undo-stack");
+const source_file_write_queue_1 = require("./source-file-write-queue");
 const undoHandler = () => {
-    return Promise.resolve((0, undo_stack_1.popUndo)());
+    return (0, source_file_write_queue_1.withSourceFileWriteQueue)(() => (0, undo_stack_1.popUndo)());
 };
 exports.undoHandler = undoHandler;

package/dist/preview-server/routes/update-config.js

@@ -120,6 +120,10 @@ const validateUpdates = (updates) => {
             catch (_b) {
                 return 'Config.addElementLibrary() expects an HTTP or HTTPS URL.';
             }
+            if (elementLibrary.captionStylesUrl !== undefined &&
+                (0, studio_shared_1.normalizeHttpUrl)(elementLibrary.captionStylesUrl) === null) {
+                return 'Config.addElementLibrary() expects "captionStylesUrl" to be an absolute HTTP or HTTPS URL.';
+            }
             if (displayName !== undefined &&
                 (typeof displayName !== 'string' || displayName.trim() === '')) {
                 return 'Config.addElementLibrary() expects a non-empty display name.';
@@ -223,16 +227,19 @@ const updateConfigFile = ({ configContents, existingElementLibraryUrls, updates,
         let value = initialValue;
         if (setter === 'addElementLibrary') {
             const elementLibrary = initialValue;
-            const { displayName: rawDisplayName, url } = elementLibrary;
+            const { displayName: rawDisplayName, url, captionStylesUrl, } = elementLibrary;
             const normalizedUrl = new URL(url).href;
             if (elementLibraryUrls.has(normalizedUrl)) {
                 continue;
             }
             const displayName = typeof rawDisplayName === 'string' ? rawDisplayName.trim() : null;
-            value =
-                displayName === null
-                    ? { url: normalizedUrl }
-                    : { url: normalizedUrl, displayName };
+            value = {
+                url: normalizedUrl,
+                ...(displayName === null ? {} : { displayName }),
+                ...(captionStylesUrl === undefined
+                    ? {}
+                    : { captionStylesUrl: new URL(captionStylesUrl).href }),
+            };
             elementLibraryUrls.add(normalizedUrl);
         }
         const serializedValue = JSON.stringify(value)

package/dist/preview-server/studio-protocol/handle-element-library.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleStudioProtocolElementLibrary = void 0;
 const studio_protocol_1 = require("@remotion/studio-protocol");
+const studio_shared_1 = require("@remotion/studio-shared");
 const element_install_state_1 = require("../element-install-state");
 const parse_body_1 = require("../parse-body");
 const origin_policy_1 = require("./origin-policy");
@@ -81,6 +82,18 @@ const handleStudioProtocolElementLibrary = async ({ configFile, focusStudioTab,
         });
         return;
     }
+    const captionStylesUrl = parsedRequest.captionStylesUrl === null
+        ? null
+        : (0, studio_shared_1.normalizeHttpUrl)(parsedRequest.captionStylesUrl);
+    if (parsedRequest.captionStylesUrl !== null && captionStylesUrl === null) {
+        (0, protocol_response_1.writeStudioProtocolError)({
+            code: 'invalid-url',
+            message: 'The caption styles URL must be an absolute HTTP or HTTPS URL.',
+            response,
+            status: 400,
+        });
+        return;
+    }
     const displayName = (_b = (_a = parsedRequest.displayName) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : null;
     if (displayName === '') {
         (0, protocol_response_1.writeStudioProtocolError)({
@@ -117,6 +130,7 @@ const handleStudioProtocolElementLibrary = async ({ configFile, focusStudioTab,
     }
     const delivered = liveEventsServer.sendEventToClientId(target.clientId, {
         type: 'element-library-add-request',
+        captionStylesUrl,
         url: normalizedUrl,
         displayName,
         origin: requestOrigin,

package/dist/preview-server/studio-protocol/handle-install.js

@@ -10,7 +10,7 @@ const protocol_response_1 = require("./protocol-response");
 // UTF-8 representation and the protocol envelope while keeping memory bounded.
 const MAX_STUDIO_PROTOCOL_INSTALL_BODY_SIZE = 1000000;
 const deliverElementInstall = ({ element, focusStudioTab, liveEventsServer, origin, target, }) => {
-    var _a, _b, _c;
+    var _a, _b, _c, _d;
     const installRequest = {
         id: `${Date.now()}-${Math.random().toString(16).slice(2)}`,
         clientId: target.clientId,
@@ -22,6 +22,7 @@ const deliverElementInstall = ({ element, focusStudioTab, liveEventsServer, orig
             durationInFrames: (_a = element.durationInFrames) !== null && _a !== void 0 ? _a : null,
             initialProps: (_b = element.initialProps) !== null && _b !== void 0 ? _b : null,
             installationMode: (_c = element.installationMode) !== null && _c !== void 0 ? _c : null,
+            isCaptionStyle: (_d = element.isCaptionStyle) !== null && _d !== void 0 ? _d : false,
         },
         from: null,
         position: null,

package/dist/preview-server/undo-stack.js

@@ -285,6 +285,7 @@ function popUndo() {
             (0, watch_ignore_next_change_1.suppressBundlerUpdateForFile)(snapshot.filePath);
         }
         if (snapshot.oldContents === null) {
+            (0, watch_ignore_next_change_1.prepareBundlerForFileWrite)(snapshot.filePath);
             (0, node_fs_1.rmSync)(snapshot.filePath, { force: true });
         }
         else {

package/dist/preview-server/watch-ignore-next-change.d.ts

@@ -1,5 +1,6 @@
 import type { WatchIgnoreNextChangePlugin } from '@remotion/bundler';
 export declare const setWatchIgnoreNextChangePlugin: (plugin: WatchIgnoreNextChangePlugin) => void;
 export declare const suppressBundlerUpdateForFile: (absolutePath: string) => void;
+export declare const prepareBundlerForFileWrite: (absolutePath: string) => void;
 export declare const invalidatePreviouslySuppressedFiles: () => Promise<boolean>;
 export declare const reloadPreviouslySuppressedFiles: () => Promise<void>;

package/dist/preview-server/watch-ignore-next-change.js

@@ -1,16 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.reloadPreviouslySuppressedFiles = exports.invalidatePreviouslySuppressedFiles = exports.suppressBundlerUpdateForFile = exports.setWatchIgnoreNextChangePlugin = void 0;
+exports.reloadPreviouslySuppressedFiles = exports.invalidatePreviouslySuppressedFiles = exports.prepareBundlerForFileWrite = exports.suppressBundlerUpdateForFile = exports.setWatchIgnoreNextChangePlugin = void 0;
 const node_fs_1 = require("node:fs");
+const pendingSuppressedWrites = new Set();
 let currentPlugin = null;
 const setWatchIgnoreNextChangePlugin = (plugin) => {
     currentPlugin = plugin;
+    pendingSuppressedWrites.clear();
 };
 exports.setWatchIgnoreNextChangePlugin = setWatchIgnoreNextChangePlugin;
 const suppressBundlerUpdateForFile = (absolutePath) => {
-    currentPlugin === null || currentPlugin === void 0 ? void 0 : currentPlugin.ignoreNextChange(absolutePath);
+    pendingSuppressedWrites.add(absolutePath);
 };
 exports.suppressBundlerUpdateForFile = suppressBundlerUpdateForFile;
+// Consume the intent for this write, rather than letting an earlier suppressed
+// write swallow a subsequent structural change in the watcher's aggregated event.
+const prepareBundlerForFileWrite = (absolutePath) => {
+    if (pendingSuppressedWrites.delete(absolutePath)) {
+        currentPlugin === null || currentPlugin === void 0 ? void 0 : currentPlugin.ignoreNextChange(absolutePath);
+    }
+    else {
+        currentPlugin === null || currentPlugin === void 0 ? void 0 : currentPlugin.requireRebuild(absolutePath);
+    }
+};
+exports.prepareBundlerForFileWrite = prepareBundlerForFileWrite;
 const invalidatePreviouslySuppressedFiles = async () => {
     if (!currentPlugin) {
         return false;

package/dist/start-studio.js

@@ -11,13 +11,13 @@ const renderer_1 = require("@remotion/renderer");
 const file_watcher_1 = require("./file-watcher");
 const get_network_address_1 = require("./get-network-address");
 const maybe_open_browser_1 = require("./maybe-open-browser");
-const open_browser_shortcut_1 = require("./open-browser-shortcut");
 const close_and_restart_1 = require("./preview-server/close-and-restart");
 const get_absolute_public_dir_1 = require("./preview-server/get-absolute-public-dir");
 const live_events_1 = require("./preview-server/live-events");
 const public_folder_1 = require("./preview-server/public-folder");
 const start_server_1 = require("./preview-server/start-server");
 const server_ready_1 = require("./server-ready");
+const studio_shortcuts_1 = require("./studio-shortcuts");
 const watch_root_file_1 = require("./watch-root-file");
 const startStudio = async ({ browserArgs, browserFlag, shouldOpenBrowser, fullEntryPath, logLevel, getCurrentInputProps, getEnvVariables, desiredPort, remotionRoot, relativePublicDir, bundlerOverride, rspackOverride, webpackOverride, poll, getRenderDefaults, getRenderQueue, getNumberOfAudioTags, queueMethods, previewEntry, gitSource, binariesDirectory, forceIPv4, getAudioLatencyHint, getExperimentalKeepAudioContextAlive, getPreviewSampleRate, enableCrossSiteIsolation, forceNew, rspack, getStudioRuntimeConfig, getDefaultCodingAgent, getDefaultEditor, configFile, }) => {
     try {
@@ -128,11 +128,14 @@ const startStudio = async ({ browserArgs, browserFlag, shouldOpenBrowser, fullEn
     (0, server_ready_1.printServerReadyComment)('Server ready', logLevel);
     renderer_1.RenderInternals.Log.info({ indent: false, logLevel }, 'Building...');
     const studioUrl = `http://localhost:${port}`;
-    const openBrowserShortcut = (0, open_browser_shortcut_1.registerOpenBrowserShortcut)({
+    const studioShortcuts = (0, studio_shortcuts_1.registerStudioShortcuts)({
         browserArgs,
         browserFlag,
         url: studioUrl,
         logLevel,
+        remotionRoot,
+        getDefaultEditor,
+        getDefaultCodingAgent,
     });
     let action;
     try {
@@ -146,7 +149,7 @@ const startStudio = async ({ browserArgs, browserFlag, shouldOpenBrowser, fullEn
         action = await (0, close_and_restart_1.noOpUntilRestart)();
     }
     finally {
-        openBrowserShortcut.cleanup();
+        studioShortcuts.cleanup();
     }
     renderer_1.RenderInternals.Log.info({ indent: false, logLevel }, action === 'shutdown'
         ? 'Shutting down Studio...'

package/dist/studio-shortcuts.d.ts

@@ -0,0 +1,13 @@
+import type { DefaultEditor } from '@remotion/renderer';
+export declare const registerStudioShortcuts: ({ browserArgs, browserFlag, url, logLevel, remotionRoot, getDefaultEditor, getDefaultCodingAgent, }: {
+    browserArgs: string;
+    browserFlag: string;
+    url: string;
+    logLevel: "error" | "info" | "trace" | "verbose" | "warn";
+    remotionRoot: string;
+    getDefaultEditor: () => DefaultEditor | null;
+    getDefaultCodingAgent: () => "claude-code" | "codex" | "copilot" | "cursor" | null;
+}) => {
+    registered: boolean;
+    cleanup: () => void;
+};

package/dist/studio-shortcuts.js

@@ -0,0 +1,257 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerStudioShortcuts = void 0;
+const readline = __importStar(require("node:readline"));
+const renderer_1 = require("@remotion/renderer");
+const studio_shared_1 = require("@remotion/studio-shared");
+const better_opn_1 = require("./better-opn");
+const app_discovery_1 = require("./helpers/app-discovery");
+const open_in_app_1 = require("./helpers/open-in-app");
+const recently_used_apps_1 = require("./helpers/recently-used-apps");
+const maybe_open_browser_1 = require("./maybe-open-browser");
+const live_events_1 = require("./preview-server/live-events");
+const registerStudioShortcuts = ({ browserArgs, browserFlag, url, logLevel, remotionRoot, getDefaultEditor, getDefaultCodingAgent, }) => {
+    if (!process.stdin.isTTY) {
+        return { registered: false, cleanup: () => undefined };
+    }
+    if (typeof process.stdin.setRawMode !== 'function') {
+        return { registered: false, cleanup: () => undefined };
+    }
+    const wasRaw = process.stdin.isRaw;
+    const shouldPauseAfterCleanup = process.stdin.isPaused();
+    let cleanedUp = false;
+    let isOpeningBrowser = false;
+    let editor = null;
+    let codingAgent = null;
+    const openingApps = new Set();
+    let refreshRevision = 0;
+    let lastPrintedAssignment = null;
+    const refreshShortcuts = async () => {
+        var _a;
+        const revision = ++refreshRevision;
+        const configuredEditor = getDefaultEditor();
+        const configuredCodingAgent = getDefaultCodingAgent();
+        const [discovery, editorInfo, recentEditors, recentCodingAgents] = await Promise.all([
+            (0, app_discovery_1.getAppDiscovery)(),
+            (0, app_discovery_1.getEditorInfo)(configuredEditor),
+            (0, recently_used_apps_1.getRecentlyUsedApps)({
+                remotionRoot,
+                type: 'editor',
+                recentlyUsedIds: null,
+            }),
+            (0, recently_used_apps_1.getRecentlyUsedApps)({
+                remotionRoot,
+                type: 'coding-agent',
+                recentlyUsedIds: null,
+            }),
+        ]);
+        if (cleanedUp || revision !== refreshRevision) {
+            return;
+        }
+        editor = (0, studio_shared_1.getPreferredApp)({
+            installedApps: editorInfo.installedEditors,
+            configuredId: editorInfo.defaultEditor,
+            runningIds: (_a = editorInfo.runningEditors) !== null && _a !== void 0 ? _a : [],
+            recentlyUsedIds: recentEditors,
+            fallbackIds: studio_shared_1.preferredFallbackEditorIds,
+        });
+        codingAgent = (0, studio_shared_1.getPreferredApp)({
+            installedApps: discovery.installedCodingAgents,
+            configuredId: configuredCodingAgent,
+            runningIds: discovery.runningCodingAgents,
+            recentlyUsedIds: recentCodingAgents,
+            fallbackIds: discovery.installedCodingAgents.map(({ id }) => id),
+        });
+        printShortcuts();
+    };
+    const printShortcuts = () => {
+        var _a, _b;
+        if (cleanedUp) {
+            return;
+        }
+        const shortcuts = [
+            '[s] Open Studio',
+            ...(codingAgent ? [`[a] Open agent (${codingAgent.name})`] : []),
+            ...(editor
+                ? [
+                    `[e] Open editor (${editor.name === 'Code' ? 'VS Code' : editor.name})`,
+                ]
+                : []),
+        ];
+        const assignment = JSON.stringify([
+            (_a = editor === null || editor === void 0 ? void 0 : editor.id) !== null && _a !== void 0 ? _a : null,
+            (_b = codingAgent === null || codingAgent === void 0 ? void 0 : codingAgent.id) !== null && _b !== void 0 ? _b : null,
+            shortcuts,
+            (editor === null || editor === void 0 ? void 0 : editor.id) === 'custom' ? getDefaultEditor() : null,
+        ]);
+        if (assignment === lastPrintedAssignment) {
+            return;
+        }
+        lastPrintedAssignment = assignment;
+        renderer_1.RenderInternals.Log.info({ indent: false, logLevel }, renderer_1.RenderInternals.chalk.gray(shortcuts.join('  ')));
+    };
+    const onPreferencesChange = () => {
+        if (cleanedUp) {
+            return;
+        }
+        refreshShortcuts().catch((err) => {
+            renderer_1.RenderInternals.Log.verbose({ indent: false, logLevel }, 'Could not refresh Studio shortcuts:', err);
+            printShortcuts();
+        });
+    };
+    const unsubscribeHistory = (0, recently_used_apps_1.subscribeToRecentlyUsedApps)({
+        remotionRoot,
+        onChange: onPreferencesChange,
+    });
+    const unsubscribeConfig = (0, live_events_1.subscribeToConfigChanges)(onPreferencesChange);
+    const openApp = async (key) => {
+        if (openingApps.has(key) || cleanedUp) {
+            return;
+        }
+        openingApps.add(key);
+        try {
+            const response = key === 'a' && codingAgent
+                ? await (0, open_in_app_1.openInCodingAgent)({
+                    input: { codingAgentId: codingAgent.id, prompt: null },
+                    remotionRoot,
+                    logLevel,
+                })
+                : key === 'e' && editor
+                    ? await (0, open_in_app_1.openInEditor)({
+                        input: {
+                            editorId: editor.id,
+                            stack: {
+                                originalFileName: remotionRoot,
+                                originalLineNumber: 1,
+                                originalColumnNumber: 1,
+                                originalFunctionName: null,
+                                originalScriptCode: null,
+                            },
+                        },
+                        remotionRoot,
+                        logLevel,
+                        getDefaultEditor,
+                    })
+                    : null;
+            if (response && !response.success) {
+                renderer_1.RenderInternals.Log.error({ indent: false, logLevel }, `Could not open ${key === 'a' ? codingAgent === null || codingAgent === void 0 ? void 0 : codingAgent.name : editor === null || editor === void 0 ? void 0 : editor.name}`);
+            }
+        }
+        catch (err) {
+            renderer_1.RenderInternals.Log.error({ indent: false, logLevel }, key === 'a' ? 'Could not open coding agent:' : 'Could not open editor:', err);
+        }
+        finally {
+            openingApps.delete(key);
+        }
+    };
+    const cleanup = () => {
+        if (cleanedUp) {
+            return;
+        }
+        cleanedUp = true;
+        unsubscribeHistory();
+        unsubscribeConfig();
+        process.stdin.removeListener('keypress', onKeypress);
+        process.removeListener('SIGINT', cleanup);
+        process.removeListener('exit', cleanup);
+        if (!wasRaw && process.stdin.isTTY) {
+            process.stdin.setRawMode(false);
+        }
+        if (shouldPauseAfterCleanup) {
+            process.stdin.pause();
+        }
+    };
+    const openStudio = async () => {
+        if (isOpeningBrowser) {
+            return;
+        }
+        isOpeningBrowser = true;
+        (0, live_events_1.clearPrintPortMessageTimeout)();
+        try {
+            const didFocus = await (0, better_opn_1.focusBrowserTabByOrigin)({
+                url,
+                browserArgs,
+                browserFlag,
+            });
+            if (didFocus) {
+                renderer_1.RenderInternals.Log.info({ indent: false, logLevel }, renderer_1.RenderInternals.chalk.blue(`Opened ${url} in browser`));
+                return;
+            }
+            const result = await (0, maybe_open_browser_1.maybeOpenBrowser)({
+                browserArgs,
+                browserFlag,
+                shouldOpenBrowser: true,
+                url,
+                logLevel,
+            });
+            if (result.didOpenBrowser) {
+                renderer_1.RenderInternals.Log.info({ indent: false, logLevel }, renderer_1.RenderInternals.chalk.blue(`Opened ${url} in browser`));
+            }
+        }
+        catch (err) {
+            renderer_1.RenderInternals.Log.error({ indent: false, logLevel }, 'Could not open browser:', err);
+        }
+        finally {
+            isOpeningBrowser = false;
+        }
+    };
+    function onKeypress(_str, key) {
+        if ((key === null || key === void 0 ? void 0 : key.ctrl) && key.name === 'c') {
+            cleanup();
+            process.kill(process.pid, 'SIGINT');
+            return;
+        }
+        if ((key === null || key === void 0 ? void 0 : key.meta) || (key === null || key === void 0 ? void 0 : key.ctrl)) {
+            return;
+        }
+        if ((key === null || key === void 0 ? void 0 : key.name) === 's') {
+            openStudio().catch(() => undefined);
+        }
+        else if ((key === null || key === void 0 ? void 0 : key.name) === 'a' || (key === null || key === void 0 ? void 0 : key.name) === 'e') {
+            openApp(key.name).catch(() => undefined);
+        }
+    }
+    readline.emitKeypressEvents(process.stdin);
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.on('keypress', onKeypress);
+    process.once('SIGINT', cleanup);
+    process.once('exit', cleanup);
+    // Discovery may finish after other startup logs; never await it here.
+    onPreferencesChange();
+    return { registered: true, cleanup };
+};
+exports.registerStudioShortcuts = registerStudioShortcuts;

package/package.json

@@ -3,7 +3,7 @@
 		"url": "https://github.com/remotion-dev/remotion/tree/main/packages/studio-server"
 	},
 	"name": "@remotion/studio-server",
-	"version": "4.0.534",
+	"version": "4.0.535",
 	"description": "Run a Remotion Studio with a server backend",
 	"main": "dist",
 	"scripts": {
@@ -23,7 +23,7 @@
 		"access": "public"
 	},
 	"dependencies": {
-		"@remotion/studio-protocol": "4.0.534",
+		"@remotion/studio-protocol": "4.0.535",
 		"@babel/types": "7.24.0",
 		"@babel/parser": "7.24.1",
 		"@svgr/core": "8.1.0",
@@ -31,12 +31,12 @@
 		"kiwi-schema": "0.5.0",
 		"semver": "7.5.3",
 		"zod": "4.5.4",
-		"remotion": "4.0.534",
+		"remotion": "4.0.535",
 		"recast": "0.23.21",
-		"@remotion/bundler": "4.0.534",
-		"@remotion/renderer": "4.0.534",
-		"@remotion/codemods": "4.0.534",
-		"@remotion/studio-shared": "4.0.534",
+		"@remotion/bundler": "4.0.535",
+		"@remotion/renderer": "4.0.535",
+		"@remotion/codemods": "4.0.535",
+		"@remotion/studio-shared": "4.0.535",
 		"memfs": "3.4.3",
 		"open": "8.4.2"
 	},
@@ -44,7 +44,7 @@
 		"ast-types": "0.16.1",
 		"react": "19.2.3",
 		"@types/semver": "7.5.3",
-		"@remotion/eslint-config-internal": "4.0.534",
+		"@remotion/eslint-config-internal": "4.0.535",
 		"eslint": "9.19.0",
 		"prettier": "3.8.1",
 		"@types/node": "20.12.14",