Skip to content

🎥 Make videos programmatically with React

`@remotion/browser-studio`: Install packages outside the Element flow (#10681)

Jonny Burgere54bcd724704
diff --git a/packages/browser-studio/e2e/browser-studio.test.ts b/packages/browser-studio/e2e/browser-studio.test.ts
index 67c20c3b6e..aea7763956 100644
--- a/packages/browser-studio/e2e/browser-studio.test.ts
+++ b/packages/browser-studio/e2e/browser-studio.test.ts
@@ -232,6 +232,107 @@ test('loads Browser Studio from one immutable release artifact set', async ({
expect(remoteRemotionRequests).toEqual([]);
});
+test('installs packages without a server API and preserves undo, redo, and HMR', async ({
+ page,
+}) => {
+ const studioApiRequests: string[] = [];
+ page.on('request', (request) => {
+ const requestUrl = new URL(request.url());
+ if (
+ requestUrl.pathname.startsWith('/api/') &&
+ requestUrl.origin === new URL(page.url()).origin
+ ) {
+ studioApiRequests.push(requestUrl.pathname);
+ }
+ });
+
+ await page.goto('/');
+ const studio = page.frameLocator('iframe');
+ await expect(studio.getByTitle('/project').getByText('MyComp')).toBeVisible();
+ await studio.locator('body').evaluate(() => {
+ (
+ window as typeof window & {
+ __browserStudioInstallPreservedIframe?: boolean;
+ }
+ ).__browserStudioInstallPreservedIframe = true;
+ });
+
+ await studio.getByRole('button', {name: 'Tools', exact: true}).click();
+ await studio.getByText('Install package...', {exact: true}).click();
+ await expect(
+ studio.getByText('Install packages', {exact: true}),
+ ).toBeVisible();
+ await studio.locator('input[name="@remotion/google-fonts"]').click();
+ await studio.getByRole('button', {name: /^Install/}).click();
+ await expect(
+ studio.getByText('Installed package successfully.'),
+ ).toBeVisible();
+ await expect
+ .poll(() =>
+ page.evaluate(() => {
+ const browserWindow = window as typeof window & {
+ __browserStudioProject: {files: Record<string, string>};
+ __browserStudioRemotionVersion: string;
+ };
+ const packageJson = JSON.parse(
+ browserWindow.__browserStudioProject.files['/project/package.json'],
+ ) as {dependencies: Record<string, string>};
+ return packageJson.dependencies['@remotion/google-fonts'];
+ }),
+ )
+ .toBe(
+ await page.evaluate(
+ () =>
+ (
+ window as typeof window & {
+ __browserStudioRemotionVersion: string;
+ }
+ ).__browserStudioRemotionVersion,
+ ),
+ );
+ expect(
+ await studio.locator('body').evaluate(
+ () =>
+ (
+ window as typeof window & {
+ __browserStudioInstallPreservedIframe?: boolean;
+ }
+ ).__browserStudioInstallPreservedIframe,
+ ),
+ ).toBe(true);
+
+ await studio.getByRole('button', {name: /^Done/}).click();
+ await page.keyboard.press('ControlOrMeta+Z');
+ await expect
+ .poll(() =>
+ page.evaluate(() => {
+ const browserWindow = window as typeof window & {
+ __browserStudioProject: {files: Record<string, string>};
+ };
+ const packageJson = JSON.parse(
+ browserWindow.__browserStudioProject.files['/project/package.json'],
+ ) as {dependencies: Record<string, string>};
+ return packageJson.dependencies['@remotion/google-fonts'];
+ }),
+ )
+ .toBeUndefined();
+ await page.keyboard.press('ControlOrMeta+Shift+Z');
+ await expect
+ .poll(() =>
+ page.evaluate(() => {
+ const browserWindow = window as typeof window & {
+ __browserStudioProject: {files: Record<string, string>};
+ };
+ const packageJson = JSON.parse(
+ browserWindow.__browserStudioProject.files['/project/package.json'],
+ ) as {dependencies: Record<string, string>};
+ return packageJson.dependencies['@remotion/google-fonts'];
+ }),
+ )
+ .toBeDefined();
+ expect(studioApiRequests).toEqual([]);
+});
+
test('fetches each HTTP module once when the vendor bundle is overridden', async ({
page,
}) => {
diff --git a/packages/browser-studio/src/browser-studio-operations.ts b/packages/browser-studio/src/browser-studio-operations.ts
index 78b1b708a2..0a94b04b24 100644
--- a/packages/browser-studio/src/browser-studio-operations.ts
+++ b/packages/browser-studio/src/browser-studio-operations.ts
@@ -44,6 +44,7 @@ import {
type BrowserStudioEffectOperations,
type BrowserStudioKeyframeOperations,
type BrowserStudioOperations,
+ type BrowserStudioPackageInstallationOperations,
type ElementInstallExpectedFileState,
type EventSourceEvent,
type InsertElementResponse,
@@ -1168,6 +1169,33 @@ export const createBrowserStudioOperations = ({
},
};
+ const packageInstallation: BrowserStudioPackageInstallationOperations = {
+ installPackages: async ({dependencies}) => {
+ try {
+ if (dependencies.length === 0) {
+ throw new Error('No packages were specified');
+ }
+
+ const installedDependencies =
+ await resolveElementDependencies(dependencies);
+ const project = getProject();
+ const nextProject = addDependenciesToProject({
+ dependencies: installedDependencies,
+ project,
+ });
+ controller.applyMutation({
+ fileName: 'Install packages',
+ mutate: () => nextProject,
+ nodePathMutationFiles: null,
+ });
+
+ return {success: true};
+ } catch (error) {
+ return getStructuredError(error);
+ }
+ },
+ };
+
const deleteJsxNode: BrowserStudioOperations['deleteJsxNode'] = async ({
nodes,
}) => {
@@ -1999,6 +2027,7 @@ export const createBrowserStudioOperations = ({
insertJsxElement,
insertSolid: insertJsxElement,
keyframes,
+ packageInstallation,
prepareElementInstall: async (request) => {
try {
const plan = await getElementInstallPlanForProject({
diff --git a/packages/browser-studio/src/test/browser-studio-operations.test.ts b/packages/browser-studio/src/test/browser-studio-operations.test.ts
index 0dba4cced3..852523b270 100644
--- a/packages/browser-studio/src/test/browser-studio-operations.test.ts
+++ b/packages/browser-studio/src/test/browser-studio-operations.test.ts
@@ -865,8 +865,8 @@ export const Comp = () => {
width: 1280,
},
});
- if (!subscription.success || !operations.keyframes) {
- throw new Error('Expected Browser Studio keyframe capability');
+ if (!subscription.success) {
+ throw new Error('Expected sequence props subscription');
}
const failedContents = getProject().files[fileName];
@@ -1631,8 +1631,8 @@ export const Comp = () => (
width: 1280,
},
});
- if (!subscription.success || !operations.effects) {
- throw new Error('Expected Browser Studio effect capability');
+ if (!subscription.success) {
+ throw new Error('Expected sequence props subscription');
}
const {effects} = operations;
diff --git a/packages/browser-studio/src/test/browser-studio-project-operations.test.ts b/packages/browser-studio/src/test/browser-studio-project-operations.test.ts
index ee0d869186..182444573d 100644
--- a/packages/browser-studio/src/test/browser-studio-project-operations.test.ts
+++ b/packages/browser-studio/src/test/browser-studio-project-operations.test.ts
@@ -378,6 +378,72 @@ export const LowerThird = () => <Rect width={640} height={180} />;
);
});
+test('installs packages as an undoable project mutation and reports structured failures', async () => {
+ const initialProject = createBlankTemplateProject();
+ let project = initialProject;
+ const resolvedDependencies: string[][] = [];
+ const operations = createBrowserStudioOperations({
+ dependencyVersions: {remotion: '4.0.999'},
+ getStaticFiles: null,
+ getProject: () => project,
+ initialElement: null,
+ onProjectChange: (nextProject) => {
+ project = nextProject;
+ },
+ resolveDependencies: (dependencies) => {
+ resolvedDependencies.push(
+ dependencies.map((dependency) => dependency.name),
+ );
+ return Promise.resolve({zod: '4.1.5'});
+ },
+ });
+ const result = await operations.packageInstallation.installPackages({
+ dependencies: [
+ {name: '@remotion/google-fonts', version: null},
+ {name: 'zod', version: '4.1.5'},
+ ],
+ });
+ expect(result).toEqual({success: true});
+ expect(resolvedDependencies).toEqual([['@remotion/google-fonts', 'zod']]);
+ const packageJson = JSON.parse(project.files['/project/package.json']) as {
+ dependencies: Record<string, string>;
+ };
+ expect(packageJson.dependencies['@remotion/google-fonts']).toBe('4.0.999');
+ expect(packageJson.dependencies.zod).toBe('4.1.5');
+
+ expect(await operations.undo()).toEqual({
+ success: true,
+ nodePathMutation: null,
+ });
+ expect(project.files['/project/package.json']).toBe(
+ initialProject.files['/project/package.json'],
+ );
+ expect(await operations.redo()).toEqual({
+ success: true,
+ nodePathMutation: null,
+ });
+ expect(project.files['/project/package.json']).toContain(
+ '"@remotion/google-fonts": "4.0.999"',
+ );
+
+ const unresolved = await operations.packageInstallation.installPackages({
+ dependencies: [{name: 'unresolvable', version: null}],
+ });
+ expect(unresolved).toMatchObject({
+ success: false,
+ reason: 'Could not resolve unresolvable',
+ stack: expect.any(String),
+ });
+ const empty = await operations.packageInstallation.installPackages({
+ dependencies: [],
+ });
+ expect(empty).toMatchObject({
+ success: false,
+ reason: 'No packages were specified',
+ stack: expect.any(String),
+ });
+});
+
test('inserts generic elements with pinned Remotion dependencies', async () => {
let project = createBlankTemplateProject();
const operations = createBrowserStudioOperations({
diff --git a/packages/studio-shared/src/browser-studio-operations.ts b/packages/studio-shared/src/browser-studio-operations.ts
index 6f799368a6..60d3382532 100644
--- a/packages/studio-shared/src/browser-studio-operations.ts
+++ b/packages/studio-shared/src/browser-studio-operations.ts
@@ -30,6 +30,7 @@ import type {
InsertJsxElementResponse,
InsertElementRequest,
InsertElementResponse,
+ InstallPackageRequest,
MoveKeyframesRequest,
MoveKeyframesResponse,
PasteEffectsRequest,
@@ -137,6 +138,22 @@ export type BrowserStudioEffectOperations = {
) => Promise<SaveMultipleEffectPropsResponse>;
};
+export type BrowserStudioInstallPackagesResponse =
+ | {
+ success: true;
+ }
+ | {
+ success: false;
+ reason: string;
+ stack: string;
+ };
+
+export type BrowserStudioPackageInstallationOperations = {
+ installPackages: (
+ request: InstallPackageRequest,
+ ) => Promise<BrowserStudioInstallPackagesResponse>;
+};
+
export type BrowserStudioOperations = {
consumeInitialElement: () => {
element: ElementDragData['element'];
@@ -156,8 +173,7 @@ export type BrowserStudioOperations = {
duplicateComposition: (
request: DuplicateCompositionRequest,
) => Promise<DuplicateCompositionResponse>;
- /** Optional for compatibility with older Browser Studio hosts. */
- effects?: BrowserStudioEffectOperations;
+ effects: BrowserStudioEffectOperations;
findInFile: (request: FindInFileRequest) => Promise<FindInFileResponse>;
getFileSource: (fileName: string) => Promise<string | null>;
getCompositionFile: (compositionId: string) => string | null;
@@ -173,8 +189,8 @@ export type BrowserStudioOperations = {
insertJsxElement: (
request: InsertJsxElementRequest,
) => Promise<InsertJsxElementResponse>;
- /** Optional for compatibility with older Browser Studio hosts. */
- keyframes?: BrowserStudioKeyframeOperations;
+ keyframes: BrowserStudioKeyframeOperations;
+ packageInstallation: BrowserStudioPackageInstallationOperations;
prepareElementInstall: (
request: PrepareElementInstallRequest,
) => Promise<PrepareElementInstallResponse>;
diff --git a/packages/studio-shared/src/index.ts b/packages/studio-shared/src/index.ts
index fb4882d171..44a62caa47 100644
--- a/packages/studio-shared/src/index.ts
+++ b/packages/studio-shared/src/index.ts
@@ -158,7 +158,9 @@ export {
export type {
BrowserStudioKeyframeOperations,
BrowserStudioEffectOperations,
+ BrowserStudioInstallPackagesResponse,
BrowserStudioOperations,
+ BrowserStudioPackageInstallationOperations,
DuplicateCompositionRequest,
DuplicateCompositionResponse,
} from './browser-studio-operations';
diff --git a/packages/studio/src/api/install-package.ts b/packages/studio/src/api/install-package.ts
index 8bce4f0a31..3cad3ce127 100644
--- a/packages/studio/src/api/install-package.ts
+++ b/packages/studio/src/api/install-package.ts
@@ -4,14 +4,30 @@ import type {
} from '@remotion/studio-shared';
import {getRemotionEnvironment} from 'remotion';
import {callApi} from '../components/call-api';
+import {getBrowserStudioOperations} from '../helpers/browser-studio-operations';
-export const installPackages = (
+export const installPackages = async (
dependencies: readonly PackageInstallSpec[],
): Promise<InstallPackageResponse> => {
if (!getRemotionEnvironment().isStudio) {
throw new Error('installPackages() is only available in the Studio');
}
+ const browserStudioOperations = getBrowserStudioOperations();
+ if (browserStudioOperations !== null) {
+ const response =
+ await browserStudioOperations.packageInstallation.installPackages({
+ dependencies: [...dependencies],
+ });
+ if (!response.success) {
+ const error = new Error(response.reason);
+ error.stack = response.stack;
+ throw error;
+ }
+
+ return {};
+ }
+
if (window.remotion_isReadOnlyStudio) {
throw new Error('installPackages() is not available in Read-Only Studio');
}
diff --git a/packages/studio/src/components/InstallPackage.tsx b/packages/studio/src/components/InstallPackage.tsx
index 6adf99090e..ca0df80893 100644
--- a/packages/studio/src/components/InstallPackage.tsx
+++ b/packages/studio/src/components/InstallPackage.tsx
@@ -13,6 +13,7 @@ import {ShortcutHint} from '../error-overlay/remotion-overlay/ShortcutHint';
import {StudioServerConnectionCtx} from '../helpers/client-id';
import {LIGHT_TEXT} from '../helpers/colors';
import {useKeybinding} from '../helpers/use-keybinding';
+import {SetSelectedModalContext} from '../state/modals';
import {Checkbox} from './Checkbox';
import {InstallablePackageComp} from './InstallablePackage';
import {Flex, Row, Spacing} from './layout';
@@ -51,17 +52,27 @@ type State =
};
export const InstallPackageModal: React.FC<{
- readonly packageManager: PackageManager;
+ readonly packageManager: PackageManager | null;
}> = ({packageManager}) => {
const [state, setState] = React.useState<State>({type: 'idle'});
const [map, setMap] = React.useState<Record<string, boolean>>({});
const {previewServerState: ctx} = useContext(StudioServerConnectionCtx);
+ const {setSelectedModal} = useContext(SetSelectedModalContext);
const selectedPackages = Object.keys(map).filter((pkg) => map[pkg]);
+ const selectedPackageSpecs = selectedPackages.map((name) => ({
+ name,
+ version: extraPackages.find((pkg) => pkg.name === name)?.version ?? null,
+ }));
const onClick = useCallback(async () => {
if (state.type === 'done') {
+ if (packageManager === null) {
+ setSelectedModal(null);
+ return;
+ }
+
setState({type: 'restarting'});
restartStudio();
return;
@@ -69,14 +80,24 @@ export const InstallPackageModal: React.FC<{
setState({type: 'installing'});
try {
- await installPackages(
- selectedPackages.map((name) => ({name, version: null})),
+ await installPackages(selectedPackageSpecs);
+ window.remotion_installedPackages = Array.from(
+ new Set([
+ ...(window.remotion_installedPackages ?? []),
+ ...selectedPackages,
+ ]),
);
setState({type: 'done'});
} catch (err) {
setState({type: 'error', error: err as Error});
}
- }, [selectedPackages, state.type]);
+ }, [
+ packageManager,
+ selectedPackageSpecs,
+ selectedPackages,
+ setSelectedModal,
+ state.type,
+ ]);
const canSelectPackages = state.type === 'idle' && ctx.type === 'connected';
@@ -114,14 +135,19 @@ export const InstallPackageModal: React.FC<{
{state.type === 'done' ? (
<div style={text}>
Installed package{selectedPackages.length === 1 ? '' : 's'}{' '}
- successfully. Restart the server to complete.
+ successfully.
+ {packageManager === null
+ ? null
+ : ' Restart the server to complete.'}
</div>
) : state.type === 'restarting' ? (
<div style={text}>Restarting the Studio server...</div>
) : state.type === 'installing' ? (
<div style={text}>
- Installing package{selectedPackages.length === 1 ? '' : 's'}. Check
- your terminal for progress.
+ Installing package{selectedPackages.length === 1 ? '' : 's'}
+ {packageManager === null
+ ? '.'
+ : '. Check your terminal for progress.'}
</div>
) : (
<div style={text}>
@@ -200,7 +226,9 @@ export const InstallPackageModal: React.FC<{
This will install {selectedPackages.length} package
{selectedPackages.length === 1 ? '' : 's'}
<br />
- using {packageManager}, Remotion v{VERSION}
+ {packageManager === null
+ ? `in this project, Remotion v${VERSION}`
+ : `using ${packageManager}, Remotion v${VERSION}`}
</span>
) : null}
<Flex />
@@ -210,7 +238,9 @@ export const InstallPackageModal: React.FC<{
: state.type === 'installing'
? 'Installing...'
: state.type === 'done'
- ? 'Restart Server'
+ ? packageManager === null
+ ? 'Done'
+ : 'Restart Server'
: 'Install'}
{disabled ? null : <ShortcutHint keyToPress="↵" cmdOrCtrl />}
</ModalButton>
diff --git a/packages/studio/src/components/Modals.tsx b/packages/studio/src/components/Modals.tsx
index 6535b0a2b2..bc5f83776f 100644
--- a/packages/studio/src/components/Modals.tsx
+++ b/packages/studio/src/components/Modals.tsx
@@ -202,13 +202,9 @@ export const Modals: React.FC<{
{modalContextType && modalContextType.type === 'fix-computed-value' && (
<FixComputedValueModal state={modalContextType} />
)}
- {!isBrowserStudio &&
- modalContextType &&
- modalContextType.type === 'install-packages' && (
- <InstallPackageModal
- packageManager={modalContextType.packageManager}
- />
- )}
+ {modalContextType && modalContextType.type === 'install-packages' && (
+ <InstallPackageModal packageManager={modalContextType.packageManager} />
+ )}
{modalContextType && modalContextType.type === 'quick-switcher' && (
<QuickSwitcher
diff --git a/packages/studio/src/components/effect-operations-api.ts b/packages/studio/src/components/effect-operations-api.ts
index bd825c0289..cb5ac81c1d 100644
--- a/packages/studio/src/components/effect-operations-api.ts
+++ b/packages/studio/src/components/effect-operations-api.ts
@@ -10,14 +10,8 @@ import type {
import {getBrowserStudioOperations} from '../helpers/browser-studio-operations';
import {callApi} from './call-api';
-const getBrowserEffectOperations = () => {
- const browserStudio = getBrowserStudioOperations();
- if (browserStudio !== null && browserStudio.effects === undefined) {
- throw new Error('Effect editing is not supported by this Browser Studio');
- }
-
- return browserStudio?.effects ?? null;
-};
+const getBrowserEffectOperations = () =>
+ getBrowserStudioOperations()?.effects ?? null;
export const addEffect = (request: AddEffectRequest) =>
getBrowserEffectOperations()?.addEffect(request) ??
diff --git a/packages/studio/src/helpers/browser-studio-operations.ts b/packages/studio/src/helpers/browser-studio-operations.ts
index 0df8533b60..13fb42008e 100644
--- a/packages/studio/src/helpers/browser-studio-operations.ts
+++ b/packages/studio/src/helpers/browser-studio-operations.ts
@@ -27,3 +27,12 @@ export const canUseKeyframeOperations = () =>
export const canUseEffectOperations = () =>
!window.remotion_isReadOnlyStudio ||
getBrowserStudioEffectOperations() !== null;
+
+export const canInstallPackages = () => {
+ const browserStudioOperations = getBrowserStudioOperations();
+ if (browserStudioOperations !== null) {
+ return true;
+ }
+
+ return !window.remotion_isReadOnlyStudio;
+};
diff --git a/packages/studio/src/helpers/use-menu-structure.tsx b/packages/studio/src/helpers/use-menu-structure.tsx
index 035e2280b7..0a22ac07e9 100644
--- a/packages/studio/src/helpers/use-menu-structure.tsx
+++ b/packages/studio/src/helpers/use-menu-structure.tsx
@@ -30,7 +30,10 @@ import type {ModalState} from '../state/modals';
import {SetSelectedModalContext} from '../state/modals';
import type {SidebarCollapsedState} from '../state/sidebar';
import {SidebarContext} from '../state/sidebar';
-import {getBrowserStudioOperations} from './browser-studio-operations';
+import {
+ canInstallPackages,
+ getBrowserStudioOperations,
+} from './browser-studio-operations';
import {checkFullscreenSupport} from './check-fullscreen-support';
import {StudioServerConnectionCtx} from './client-id';
import {CURRENT_COLOR} from './colors';
@@ -893,7 +896,9 @@ export const useMenuStructure = (
quickSwitcherLabel: 'Show Color Picker',
}
: null,
- readOnlyStudio || remotion_packageManager === 'unknown'
+ !canInstallPackages() ||
+ (browserStudioOperations === null &&
+ remotion_packageManager === 'unknown')
? null
: {
id: 'install-packages',
@@ -903,7 +908,10 @@ export const useMenuStructure = (
closeMenu();
setSelectedModal({
type: 'install-packages',
- packageManager: remotion_packageManager,
+ packageManager:
+ remotion_packageManager === 'unknown'
+ ? null
+ : remotion_packageManager,
});
},
type: 'item' as const,
diff --git a/packages/studio/src/state/modals.ts b/packages/studio/src/state/modals.ts
index fffd35f0cc..b8e2a4c9df 100644
--- a/packages/studio/src/state/modals.ts
+++ b/packages/studio/src/state/modals.ts
@@ -217,7 +217,7 @@ export type ModalState =
}
| {
type: 'install-packages';
- packageManager: PackageManager;
+ packageManager: PackageManager | null;
}
| {
type: 'quick-switcher';
diff --git a/packages/studio/src/test/browser-studio-effects.test.ts b/packages/studio/src/test/browser-studio-effects.test.ts
index 0d864f1d9d..4ee9419ed7 100644
--- a/packages/studio/src/test/browser-studio-effects.test.ts
+++ b/packages/studio/src/test/browser-studio-effects.test.ts
@@ -149,14 +149,3 @@ test('routes effect mutations through the explicit Browser Studio capability', a
'delete:1',
]);
});
-
-test('reports the capability as unavailable for an older Browser Studio host', () => {
- Object.defineProperty(globalThis, 'window', {
- configurable: true,
- value: {
- remotion_browserStudio: makeBrowserStudioOperations({}),
- remotion_isReadOnlyStudio: true,
- },
- });
- expect(canUseEffectOperations()).toBe(false);
-});
diff --git a/packages/studio/src/test/browser-studio-package-installation.test.ts b/packages/studio/src/test/browser-studio-package-installation.test.ts
new file mode 100644
index 0000000000..50d23d0e6d
--- /dev/null
+++ b/packages/studio/src/test/browser-studio-package-installation.test.ts
@@ -0,0 +1,71 @@
+import {afterEach, expect, test} from 'bun:test';
+import type {BrowserStudioPackageInstallationOperations} from '@remotion/studio-shared';
+import {installPackages} from '../api/install-package';
+import {canInstallPackages} from '../helpers/browser-studio-operations';
+import {makeBrowserStudioOperations} from './make-browser-studio-operations';
+
+const originalWindowDescriptor = Object.getOwnPropertyDescriptor(
+ globalThis,
+ 'window',
+);
+
+afterEach(() => {
+ if (originalWindowDescriptor) {
+ Object.defineProperty(globalThis, 'window', originalWindowDescriptor);
+ return;
+ }
+
+ Reflect.deleteProperty(globalThis, 'window');
+});
+
+test('routes package installation through the explicit Browser Studio capability', async () => {
+ const requests: string[][] = [];
+ const packageInstallation: BrowserStudioPackageInstallationOperations = {
+ installPackages: ({dependencies}) => {
+ requests.push(dependencies.map((dependency) => dependency.name));
+ return Promise.resolve({success: true});
+ },
+ };
+ Object.defineProperty(globalThis, 'window', {
+ configurable: true,
+ value: {
+ remotion_browserStudio: makeBrowserStudioOperations({
+ packageInstallation,
+ }),
+ remotion_isPlayer: false,
+ remotion_isReadOnlyStudio: false,
+ remotion_isStudio: true,
+ },
+ });
+
+ expect(canInstallPackages()).toBe(true);
+ expect(
+ await installPackages([{name: '@remotion/google-fonts', version: null}]),
+ ).toEqual({});
+ expect(requests).toEqual([['@remotion/google-fonts']]);
+});
+
+test('surfaces structured Browser Studio package installation failures', async () => {
+ Object.defineProperty(globalThis, 'window', {
+ configurable: true,
+ value: {
+ remotion_browserStudio: makeBrowserStudioOperations({
+ packageInstallation: {
+ installPackages: () =>
+ Promise.resolve({
+ success: false,
+ reason: 'Could not resolve example-package',
+ stack: 'browser-studio-stack',
+ }),
+ },
+ }),
+ remotion_isPlayer: false,
+ remotion_isReadOnlyStudio: true,
+ remotion_isStudio: true,
+ },
+ });
+
+ await expect(
+ installPackages([{name: 'example-package', version: null}]),
+ ).rejects.toThrow('Could not resolve example-package');
+});
diff --git a/packages/studio/src/test/make-browser-studio-operations.ts b/packages/studio/src/test/make-browser-studio-operations.ts
index 7c50862a11..fe26d68705 100644
--- a/packages/studio/src/test/make-browser-studio-operations.ts
+++ b/packages/studio/src/test/make-browser-studio-operations.ts
@@ -14,6 +14,15 @@ export const makeBrowserStudioOperations = (
deleteStaticFile: () => unusedOperation('deleteStaticFile'),
downloadProject: () => unusedOperation('downloadProject'),
duplicateComposition: () => unusedOperation('duplicateComposition'),
+ effects: {
+ addEffect: () => unusedOperation('effects'),
+ deleteEffects: () => unusedOperation('effects'),
+ duplicateEffects: () => unusedOperation('effects'),
+ pasteEffects: () => unusedOperation('effects'),
+ reorderEffect: () => unusedOperation('effects'),
+ saveEffectProps: () => unusedOperation('effects'),
+ saveMultipleEffectProps: () => unusedOperation('effects'),
+ },
findInFile: () => unusedOperation('findInFile'),
getCompositionComponentInfo: () =>
unusedOperation('getCompositionComponentInfo'),
@@ -22,6 +31,19 @@ export const makeBrowserStudioOperations = (
insertElement: () => unusedOperation('insertElement'),
insertJsxElement: () => unusedOperation('insertJsxElement'),
insertSolid: () => unusedOperation('insertSolid'),
+ keyframes: {
+ addEffectKeyframe: () => unusedOperation('keyframes'),
+ addKeyframes: () => unusedOperation('keyframes'),
+ addSequenceKeyframe: () => unusedOperation('keyframes'),
+ batchUpdateKeyframeSettings: () => unusedOperation('keyframes'),
+ deleteKeyframes: () => unusedOperation('keyframes'),
+ moveKeyframes: () => unusedOperation('keyframes'),
+ updateEffectKeyframeSettings: () => unusedOperation('keyframes'),
+ updateSequenceKeyframeSettings: () => unusedOperation('keyframes'),
+ },
+ packageInstallation: {
+ installPackages: () => unusedOperation('packageInstallation'),
+ },
prepareElementInstall: () => unusedOperation('prepareElementInstall'),
redo: () => unusedOperation('redo'),
renameStaticFile: () => unusedOperation('renameStaticFile'),