@remotion/renderer 4.0.496 → 4.0.498

package/dist/client.d.ts

@@ -632,10 +632,7 @@ export declare const BrowserSafeApis: {
             getValue: ({ commandLine }: {
                 commandLine: Record<string, unknown>;
             }) => {
-                value: "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan";
-                source: string;
-            } | {
-                value: null;
+                value: "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan" | null;
                 source: string;
             };
             setConfig: (value: "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan" | null) => void;

package/dist/esm/client.mjs

@@ -1,5 +1,5 @@
 // src/client.ts
-import { NoReactInternals as NoReactInternals4 } from "remotion/no-react";
+import { NoReactInternals as NoReactInternals5 } from "remotion/no-react";
 
 // src/browser/TimeoutSettings.ts
 var DEFAULT_TIMEOUT = 30000;
@@ -2062,6 +2062,7 @@ var framesOption = {
 };
 
 // src/options/gl.tsx
+import { NoReactInternals as NoReactInternals2 } from "remotion/no-react";
 import { jsx as jsx31, jsxs as jsxs22, Fragment as Fragment31 } from "react/jsx-runtime";
 var validOpenGlRenderers = [
   "swangle",
@@ -2071,7 +2072,10 @@ var validOpenGlRenderers = [
   "vulkan",
   "angle-egl"
 ];
-var DEFAULT_OPENGL_RENDERER = null;
+var getDefaultOpenGlRenderer = (enableV5BreakingChanges) => {
+  return enableV5BreakingChanges ? "angle" : null;
+};
+var DEFAULT_OPENGL_RENDERER = getDefaultOpenGlRenderer(NoReactInternals2.ENABLE_V5_BREAKING_CHANGES);
 var openGlRenderer = DEFAULT_OPENGL_RENDERER;
 var AngleChangelog = () => {
   return /* @__PURE__ */ jsxs22("details", {
@@ -2105,7 +2109,16 @@ var AngleChangelog = () => {
               }),
               ", however it turns out to have a small memory leak that could crash long Remotion renders."
             ]
-          })
+          }),
+          NoReactInternals2.ENABLE_V5_BREAKING_CHANGES ? /* @__PURE__ */ jsxs22("li", {
+            children: [
+              "From Remotion v5.0, the default is ",
+              /* @__PURE__ */ jsx31("code", {
+                children: "angle"
+              }),
+              ". If no compatible GPU is available, Chromium automatically falls back to SwiftShader."
+            ]
+          }) : null
         ]
       })
     ]
@@ -2179,11 +2192,13 @@ var glOption = {
         }),
         /* @__PURE__ */ jsxs22("p", {
           children: [
-            "The default is ",
+            "The default is",
+            " ",
             /* @__PURE__ */ jsx31("code", {
-              children: "null"
+              children: DEFAULT_OPENGL_RENDERER === null ? "null" : `"${DEFAULT_OPENGL_RENDERER}"`
             }),
-            ", letting Chrome decide, except on Lambda where the default is ",
+            DEFAULT_OPENGL_RENDERER === null ? ", letting Chrome decide" : ", with automatic fallback to SwiftShader if no compatible GPU is available",
+            ", except on Lambda where the default is ",
             /* @__PURE__ */ jsx31("code", {
               children: '"swangle"'
             })
@@ -2331,16 +2346,14 @@ var headlessOption = {
   cliFlag: cliFlag37,
   description: () => /* @__PURE__ */ jsxs24(Fragment33, {
     children: [
-      "Deprecated - will be removed in 5.0.0. With the migration to",
+      "If disabled, the render will open an actual Chrome window where you can see the render happen. This requires",
       " ",
       /* @__PURE__ */ jsx33("a", {
         href: "/docs/miscellaneous/chrome-headless-shell",
-        children: "Chrome Headless Shell"
+        children: "Chrome for Testing"
       }),
-      ", this option is not functional anymore.",
-      /* @__PURE__ */ jsx33("br", {}),
-      /* @__PURE__ */ jsx33("br", {}),
-      " If disabled, the render will open an actual Chrome window where you can see the render happen. The default is headless mode."
+      " ",
+      "or a custom Chrome or Chromium executable. Chrome Headless Shell always runs headlessly. The default is headless mode."
     ]
   }),
   ssrName: "headless",
@@ -3301,10 +3314,10 @@ var outDirOption = {
 };
 
 // src/validate.ts
-import { NoReactInternals as NoReactInternals2 } from "remotion/no-react";
-var validateFps = NoReactInternals2.validateFps;
-var validateDimension = NoReactInternals2.validateDimension;
-var validateDurationInFrames = NoReactInternals2.validateDurationInFrames;
+import { NoReactInternals as NoReactInternals3 } from "remotion/no-react";
+var validateFps = NoReactInternals3.validateFps;
+var validateDimension = NoReactInternals3.validateDimension;
+var validateDurationInFrames = NoReactInternals3.validateDurationInFrames;
 
 // src/options/override-duration.tsx
 import { jsx as jsx54, Fragment as Fragment54 } from "react/jsx-runtime";
@@ -4023,17 +4036,13 @@ var publicPathOption = {
       children: [
         "The path of the URL where the bundle is going to be hosted. By default it is ",
         /* @__PURE__ */ jsx68("code", {
-          children: "/"
+          children: "./"
         }),
-        ", meaning that the bundle is going to be hosted at the root of the domain (e.g. ",
-        /* @__PURE__ */ jsx68("code", {
-          children: "https://localhost:3000/"
-        }),
-        "). If you are deploying to a subdirectory (e.g. ",
+        ", making the bundle relocatable. Set an absolute path such as ",
         /* @__PURE__ */ jsx68("code", {
           children: "/sites/my-site/"
         }),
-        "), you should set this to the subdirectory."
+        " to host the bundle at a fixed location."
       ]
     });
   },
@@ -4272,12 +4281,12 @@ var scaleOption = {
 };
 
 // src/options/still-frame.tsx
-import { NoReactInternals as NoReactInternals3 } from "remotion/no-react";
+import { NoReactInternals as NoReactInternals4 } from "remotion/no-react";
 import { jsx as jsx74, jsxs as jsxs51, Fragment as Fragment74 } from "react/jsx-runtime";
 var cliFlag78 = "frame";
 var currentFrame = null;
 var validate3 = (frame) => {
-  NoReactInternals3.validateFrame({
+  NoReactInternals4.validateFrame({
     frame,
     durationInFrames: Infinity,
     allowFloats: false
@@ -5443,7 +5452,7 @@ var BrowserSafeApis = {
   validAudioCodecs,
   getDefaultCrfForCodec,
   getValidCrfRanges,
-  proResProfileOptions: NoReactInternals4.proResProfileOptions,
+  proResProfileOptions: NoReactInternals5.proResProfileOptions,
   x264PresetOptions,
   hardwareAccelerationOptions,
   validPixelFormats,

package/dist/esm/index.mjs

@@ -5429,7 +5429,7 @@ var validateFrameRange = (frameRange) => {
 };
 
 // src/get-compositions.ts
-import { NoReactInternals as NoReactInternals8 } from "remotion/no-react";
+import { NoReactInternals as NoReactInternals10 } from "remotion/no-react";
 
 // src/to-megabytes.ts
 function toMegabytes(bytes) {
@@ -5474,6 +5474,7 @@ var defaultOnLog = ({ logLevel, tag, previewString }) => {
 import fs11 from "node:fs";
 import os6 from "node:os";
 import path10 from "node:path";
+import { NoReactInternals as NoReactInternals7 } from "remotion/no-react";
 
 // src/browser/Launcher.ts
 var launchChrome = async ({
@@ -6995,6 +6996,7 @@ var getIdealVideoThreadsFlag = (logLevel) => {
 };
 
 // src/options/gl.tsx
+import { NoReactInternals as NoReactInternals6 } from "remotion/no-react";
 import { jsx, jsxs, Fragment } from "react/jsx-runtime";
 var validOpenGlRenderers = [
   "swangle",
@@ -7004,7 +7006,10 @@ var validOpenGlRenderers = [
   "vulkan",
   "angle-egl"
 ];
-var DEFAULT_OPENGL_RENDERER = null;
+var getDefaultOpenGlRenderer = (enableV5BreakingChanges) => {
+  return enableV5BreakingChanges ? "angle" : null;
+};
+var DEFAULT_OPENGL_RENDERER = getDefaultOpenGlRenderer(NoReactInternals6.ENABLE_V5_BREAKING_CHANGES);
 var validateOpenGlRenderer = (option) => {
   if (option === null) {
     return null;
@@ -7017,7 +7022,7 @@ var validateOpenGlRenderer = (option) => {
 
 // src/open-browser.ts
 var featuresToEnable = (option) => {
-  const renderer = option ?? DEFAULT_OPENGL_RENDERER;
+  const renderer = option === undefined ? getDefaultOpenGlRenderer(NoReactInternals7.ENABLE_V5_BREAKING_CHANGES) : option;
   const enableAlways = [
     "NetworkService",
     "NetworkServiceInProcess",
@@ -7031,8 +7036,8 @@ var featuresToEnable = (option) => {
   }
   return enableAlways;
 };
-var getOpenGlRenderer = (option) => {
-  const renderer = option ?? DEFAULT_OPENGL_RENDERER;
+var getOpenGlRenderer = (option, enableV5BreakingChanges = NoReactInternals7.ENABLE_V5_BREAKING_CHANGES) => {
+  const renderer = option === undefined ? getDefaultOpenGlRenderer(enableV5BreakingChanges) : option;
   validateOpenGlRenderer(renderer);
   if (renderer === "swangle") {
     return ["--use-gl=angle", "--use-angle=swiftshader"];
@@ -7053,6 +7058,12 @@ var getOpenGlRenderer = (option) => {
   if (renderer === null) {
     return [];
   }
+  if (renderer === "angle" && enableV5BreakingChanges) {
+    return [
+      "--use-gl=angle",
+      "--enable-unsafe-swiftshader"
+    ];
+  }
   return [`--use-gl=${renderer}`];
 };
 var internalOpenBrowser = async ({
@@ -7084,7 +7095,7 @@ var internalOpenBrowser = async ({
     indent,
     chromeMode
   });
-  const customGlRenderer = getOpenGlRenderer(chromiumOptions.gl ?? null);
+  const customGlRenderer = getOpenGlRenderer(chromiumOptions.gl);
   const enableMultiProcessOnLinux = chromiumOptions.enableMultiProcessOnLinux ?? true;
   Log.verbose({ indent, logLevel, tag: "openBrowser()" }, `Opening browser: gl = ${chromiumOptions.gl}, executable = ${executablePath}, enableMultiProcessOnLinux = ${enableMultiProcessOnLinux}`);
   if (chromiumOptions.userAgent) {
@@ -7264,7 +7275,7 @@ var DEFAULT_RENDER_FRAMES_OFFTHREAD_VIDEO_THREADS = 2;
 // src/prepare-server.ts
 import { existsSync as existsSync4 } from "node:fs";
 import path20 from "node:path";
-import { NoReactInternals as NoReactInternals7 } from "remotion/no-react";
+import { NoReactInternals as NoReactInternals9 } from "remotion/no-react";
 
 // src/assets/download-and-map-assets-to-file.ts
 import fs12 from "node:fs";
@@ -17190,7 +17201,7 @@ var cleanDownloadMap = (downloadMap) => {
 
 // src/get-bundle-url-from-serve-url.ts
 import path17 from "path";
-import { NoReactInternals as NoReactInternals6 } from "remotion/no-react";
+import { NoReactInternals as NoReactInternals8 } from "remotion/no-react";
 var map = (webpackBundleOrServeUrl, suffix) => {
   if (isServeUrl(webpackBundleOrServeUrl)) {
     const parsed = new URL(webpackBundleOrServeUrl);
@@ -17205,7 +17216,7 @@ var map = (webpackBundleOrServeUrl, suffix) => {
   return url;
 };
 var getBundleMapUrlFromServeUrl = (serveUrl) => {
-  return map(serveUrl, NoReactInternals6.bundleMapName);
+  return map(serveUrl, NoReactInternals8.bundleMapName);
 };
 
 // src/normalize-serve-url.ts
@@ -17861,7 +17872,7 @@ var prepareServer = async ({
     throw new Error(`Tried to serve the Webpack bundle on a HTTP server, but the file ${indexFile} does not exist. Is this a valid path to a Webpack bundle?`);
   }
   let localSourceMap = null;
-  getSourceMapFromLocalFile(path20.join(webpackConfigOrServeUrl, NoReactInternals7.bundleName)).then((s) => {
+  getSourceMapFromLocalFile(path20.join(webpackConfigOrServeUrl, NoReactInternals9.bundleName)).then((s) => {
     localSourceMap = s;
   }).catch((err) => {
     Log.verbose({ indent, logLevel }, "Could not fetch sourcemap for ", webpackConfigOrServeUrl, err);
@@ -18605,6 +18616,19 @@ var wrapWithErrorHandling = (fn) => {
 };
 
 // src/get-compositions.ts
+var convertGetCompositionsArgumentsToOptions = (args) => {
+  if (args.length === 0) {
+    throw new Error("No serve URL or webpack bundle directory was passed to getCompositions().");
+  }
+  const firstArg = args[0];
+  if (typeof firstArg === "string") {
+    return {
+      ...args[1] ?? {},
+      serveUrl: firstArg
+    };
+  }
+  return firstArg;
+};
 var innerGetCompositions = async ({
   envVariables,
   serializedInputPropsWithCustomSchema,
@@ -18688,8 +18712,8 @@ var innerGetCompositions = async ({
       height,
       fps,
       durationInFrames,
-      props: NoReactInternals8.deserializeJSONWithSpecialTypes(r.serializedResolvedPropsWithCustomSchema),
-      defaultProps: NoReactInternals8.deserializeJSONWithSpecialTypes(r.serializedDefaultPropsWithCustomSchema),
+      props: NoReactInternals10.deserializeJSONWithSpecialTypes(r.serializedResolvedPropsWithCustomSchema),
+      defaultProps: NoReactInternals10.deserializeJSONWithSpecialTypes(r.serializedDefaultPropsWithCustomSchema),
       defaultCodec,
       defaultOutName,
       defaultVideoImageFormat,
@@ -18790,8 +18814,9 @@ var internalGetCompositionsRaw = async ({
   });
 };
 var internalGetCompositions = wrapWithErrorHandling(internalGetCompositionsRaw);
-var getCompositions = (serveUrlOrWebpackUrl, config) => {
-  if (!serveUrlOrWebpackUrl) {
+var getCompositions = (...args) => {
+  const options2 = convertGetCompositionsArgumentsToOptions(args);
+  if (typeof options2?.serveUrl !== "string" || !options2.serveUrl) {
     throw new Error("No serve URL or webpack bundle directory was passed to getCompositions().");
   }
   const {
@@ -18809,15 +18834,16 @@ var getCompositions = (serveUrlOrWebpackUrl, config) => {
     offthreadVideoCacheSizeInBytes,
     chromeMode,
     offthreadVideoThreads,
-    mediaCacheSizeInBytes
-  } = config ?? {};
+    mediaCacheSizeInBytes,
+    serveUrl
+  } = options2;
   const indent = false;
   const logLevel = passedLogLevel ?? "info";
   return internalGetCompositions({
     browserExecutable: browserExecutable ?? null,
     chromiumOptions: chromiumOptions ?? {},
     envVariables: envVariables ?? {},
-    serializedInputPropsWithCustomSchema: NoReactInternals8.serializeJSONWithSpecialTypes({
+    serializedInputPropsWithCustomSchema: NoReactInternals10.serializeJSONWithSpecialTypes({
       data: inputProps ?? {},
       indent: undefined,
       staticBase: null
@@ -18826,7 +18852,7 @@ var getCompositions = (serveUrlOrWebpackUrl, config) => {
     onBrowserLog: onBrowserLog ?? null,
     port: port ?? null,
     puppeteerInstance: puppeteerInstance ?? undefined,
-    serveUrlOrWebpackUrl,
+    serveUrlOrWebpackUrl: serveUrl,
     server: undefined,
     timeoutInMilliseconds: timeoutInMilliseconds ?? DEFAULT_TIMEOUT,
     logLevel,
@@ -19194,7 +19220,7 @@ var validateSelectedPixelFormatAndCodecCombination = (pixelFormat, codec) => {
 // src/render-frames.ts
 import fs16 from "node:fs";
 import path22 from "node:path";
-import { NoReactInternals as NoReactInternals12 } from "remotion/no-react";
+import { NoReactInternals as NoReactInternals14 } from "remotion/no-react";
 
 // src/cycle-browser-tabs.ts
 var cycleBrowserTabs = ({
@@ -20017,10 +20043,10 @@ class Pool {
 }
 
 // src/render-frame-and-retry-target-close.ts
-import { NoReactInternals as NoReactInternals10 } from "remotion/no-react";
+import { NoReactInternals as NoReactInternals12 } from "remotion/no-react";
 
 // src/is-delay-render-error-with-retry.ts
-import { NoReactInternals as NoReactInternals9 } from "remotion/no-react";
+import { NoReactInternals as NoReactInternals11 } from "remotion/no-react";
 var getRetriesLeftFromError = (error) => {
   if (!error) {
     throw new Error("Expected stack");
@@ -20029,15 +20055,15 @@ var getRetriesLeftFromError = (error) => {
   if (!stack) {
     throw new Error("Expected stack: " + JSON.stringify(error));
   }
-  const beforeIndex = stack.indexOf(NoReactInternals9.DELAY_RENDER_ATTEMPT_TOKEN);
+  const beforeIndex = stack.indexOf(NoReactInternals11.DELAY_RENDER_ATTEMPT_TOKEN);
   if (beforeIndex === -1) {
     throw new Error("Expected to find attempt token in stack");
   }
-  const afterIndex = stack.indexOf(NoReactInternals9.DELAY_RENDER_RETRY_TOKEN);
+  const afterIndex = stack.indexOf(NoReactInternals11.DELAY_RENDER_RETRY_TOKEN);
   if (afterIndex === -1) {
     throw new Error("Expected to find retry token in stack");
   }
-  const inbetween = stack.substring(beforeIndex + NoReactInternals9.DELAY_RENDER_ATTEMPT_TOKEN.length, afterIndex);
+  const inbetween = stack.substring(beforeIndex + NoReactInternals11.DELAY_RENDER_ATTEMPT_TOKEN.length, afterIndex);
   const parsed = Number(inbetween);
   if (Number.isNaN(parsed)) {
     throw new Error(`Expected to find a number in the stack ${stack}`);
@@ -20602,7 +20628,7 @@ var renderFrameAndRetryTargetClose = async ({
     currentPool.release(freePage);
   } catch (err) {
     const isTargetClosedError = isTargetClosedErr(err);
-    const shouldRetryError = err.stack?.includes(NoReactInternals10.DELAY_RENDER_RETRY_TOKEN);
+    const shouldRetryError = err.stack?.includes(NoReactInternals12.DELAY_RENDER_RETRY_TOKEN);
     const flakyNetworkError = isFlakyNetworkError(err);
     if (isUserCancelledRender(err) && !shouldRetryError) {
       throw err;
@@ -20754,10 +20780,10 @@ var handleBrowserCrash = (instance, logLevel, indent) => {
 };
 
 // src/validate.ts
-import { NoReactInternals as NoReactInternals11 } from "remotion/no-react";
-var validateFps = NoReactInternals11.validateFps;
-var validateDimension = NoReactInternals11.validateDimension;
-var validateDurationInFrames = NoReactInternals11.validateDurationInFrames;
+import { NoReactInternals as NoReactInternals13 } from "remotion/no-react";
+var validateFps = NoReactInternals13.validateFps;
+var validateDimension = NoReactInternals13.validateDimension;
+var validateDurationInFrames = NoReactInternals13.validateDurationInFrames;
 
 // src/validate-scale.ts
 var validateScale = (scale) => {
@@ -21223,12 +21249,12 @@ var renderFrames = (options2) => {
     indent,
     jpegQuality: jpegQuality ?? DEFAULT_JPEG_QUALITY,
     onDownload: onDownload ?? null,
-    serializedInputPropsWithCustomSchema: NoReactInternals12.serializeJSONWithSpecialTypes({
+    serializedInputPropsWithCustomSchema: NoReactInternals14.serializeJSONWithSpecialTypes({
       indent: undefined,
       staticBase: null,
       data: inputProps ?? {}
     }).serializedString,
-    serializedResolvedPropsWithCustomSchema: NoReactInternals12.serializeJSONWithSpecialTypes({
+    serializedResolvedPropsWithCustomSchema: NoReactInternals14.serializeJSONWithSpecialTypes({
       indent: undefined,
       staticBase: null,
       data: composition.props
@@ -21267,7 +21293,7 @@ import fs18 from "node:fs";
 import os9 from "node:os";
 import path28 from "node:path";
 import { LicensingInternals } from "@remotion/licensing";
-import { NoReactInternals as NoReactInternals15 } from "remotion/no-react";
+import { NoReactInternals as NoReactInternals17 } from "remotion/no-react";
 
 // src/crf.ts
 var defaultCrfMap = {
@@ -21474,12 +21500,12 @@ var ensureFramesInOrder = (framesToRender) => {
 };
 
 // src/options/color-space.tsx
-import { NoReactInternals as NoReactInternals13 } from "remotion/no-react";
+import { NoReactInternals as NoReactInternals15 } from "remotion/no-react";
 import { jsx as jsx4, jsxs as jsxs4, Fragment as Fragment4 } from "react/jsx-runtime";
 var validV4ColorSpaces = ["default", "bt601", "bt709", "bt2020-ncl"];
 var validV5ColorSpaces = ["bt601", "bt709", "bt2020-ncl"];
-var validColorSpaces = NoReactInternals13.ENABLE_V5_BREAKING_CHANGES ? validV5ColorSpaces : validV4ColorSpaces;
-var DEFAULT_COLOR_SPACE = NoReactInternals13.ENABLE_V5_BREAKING_CHANGES ? "bt709" : "default";
+var validColorSpaces = NoReactInternals15.ENABLE_V5_BREAKING_CHANGES ? validV5ColorSpaces : validV4ColorSpaces;
+var DEFAULT_COLOR_SPACE = NoReactInternals15.ENABLE_V5_BREAKING_CHANGES ? "bt709" : "default";
 
 // src/options/gop-size.tsx
 import { jsx as jsx5, jsxs as jsxs5, Fragment as Fragment5 } from "react/jsx-runtime";
@@ -22019,7 +22045,7 @@ var shouldUseParallelEncoding = ({
 };
 
 // src/prores-profile.ts
-import { NoReactInternals as NoReactInternals14 } from "remotion/no-react";
+import { NoReactInternals as NoReactInternals16 } from "remotion/no-react";
 var validateSelectedCodecAndProResCombination = ({
   codec,
   proResProfile
@@ -22027,8 +22053,8 @@ var validateSelectedCodecAndProResCombination = ({
   if (typeof proResProfile !== "undefined" && codec !== "prores") {
     throw new TypeError(`You have set a ProRes profile but the codec is "${codec}". Set the codec to "prores" or remove the ProRes profile.`);
   }
-  if (proResProfile !== undefined && !NoReactInternals14.proResProfileOptions.includes(proResProfile)) {
-    throw new TypeError(`The ProRes profile "${proResProfile}" is not valid. Valid options are ${NoReactInternals14.proResProfileOptions.map((p) => `"${p}"`).join(", ")}`);
+  if (proResProfile !== undefined && !NoReactInternals16.proResProfileOptions.includes(proResProfile)) {
+    throw new TypeError(`The ProRes profile "${proResProfile}" is not valid. Valid options are ${NoReactInternals16.proResProfileOptions.map((p) => `"${p}"`).join(", ")}`);
   }
 };
 
@@ -24130,7 +24156,7 @@ var renderMedia = ({
     ffmpegOverride: ffmpegOverride ?? undefined,
     frameRange: frameRange ?? null,
     imageFormat: imageFormat ?? null,
-    serializedInputPropsWithCustomSchema: NoReactInternals15.serializeJSONWithSpecialTypes({
+    serializedInputPropsWithCustomSchema: NoReactInternals17.serializeJSONWithSpecialTypes({
       indent: undefined,
       staticBase: null,
       data: inputProps ?? {}
@@ -24165,7 +24191,7 @@ var renderMedia = ({
       return;
     },
     server: undefined,
-    serializedResolvedPropsWithCustomSchema: NoReactInternals15.serializeJSONWithSpecialTypes({
+    serializedResolvedPropsWithCustomSchema: NoReactInternals17.serializeJSONWithSpecialTypes({
       indent: undefined,
       staticBase: null,
       data: composition.props ?? {}
@@ -24199,7 +24225,7 @@ var renderMedia = ({
 import fs19, { statSync as statSync2 } from "node:fs";
 import path29 from "node:path";
 import { LicensingInternals as LicensingInternals2 } from "@remotion/licensing";
-import { NoReactInternals as NoReactInternals16 } from "remotion/no-react";
+import { NoReactInternals as NoReactInternals18 } from "remotion/no-react";
 var innerRenderStill = async ({
   composition,
   imageFormat = DEFAULT_STILL_IMAGE_FORMAT,
@@ -24237,7 +24263,7 @@ var innerRenderStill = async ({
     allowFloats: false
   });
   validateStillImageFormat(imageFormat);
-  NoReactInternals16.validateFrame({
+  NoReactInternals18.validateFrame({
     frame,
     durationInFrames: composition.durationInFrames,
     allowFloats: false
@@ -24530,7 +24556,7 @@ var renderStill = (options2) => {
     frame: frame ?? 0,
     imageFormat: imageFormat ?? DEFAULT_STILL_IMAGE_FORMAT,
     indent,
-    serializedInputPropsWithCustomSchema: NoReactInternals16.serializeJSONWithSpecialTypes({
+    serializedInputPropsWithCustomSchema: NoReactInternals18.serializeJSONWithSpecialTypes({
       staticBase: null,
       indent: undefined,
       data: inputProps ?? {}
@@ -24547,7 +24573,7 @@ var renderStill = (options2) => {
     serveUrl,
     timeoutInMilliseconds: timeoutInMilliseconds ?? DEFAULT_TIMEOUT,
     logLevel,
-    serializedResolvedPropsWithCustomSchema: NoReactInternals16.serializeJSONWithSpecialTypes({
+    serializedResolvedPropsWithCustomSchema: NoReactInternals18.serializeJSONWithSpecialTypes({
       indent: undefined,
       staticBase: null,
       data: composition.props ?? {}
@@ -24570,7 +24596,7 @@ var renderStill = (options2) => {
 };
 
 // src/select-composition.ts
-import { NoReactInternals as NoReactInternals17 } from "remotion/no-react";
+import { NoReactInternals as NoReactInternals19 } from "remotion/no-react";
 var innerSelectComposition = async ({
   page,
   serializedInputPropsWithCustomSchema,
@@ -24664,8 +24690,8 @@ var innerSelectComposition = async ({
       height,
       fps,
       durationInFrames,
-      props: NoReactInternals17.deserializeJSONWithSpecialTypes(res.serializedResolvedPropsWithCustomSchema),
-      defaultProps: NoReactInternals17.deserializeJSONWithSpecialTypes(res.serializedDefaultPropsWithCustomSchema),
+      props: NoReactInternals19.deserializeJSONWithSpecialTypes(res.serializedResolvedPropsWithCustomSchema),
+      defaultProps: NoReactInternals19.deserializeJSONWithSpecialTypes(res.serializedDefaultPropsWithCustomSchema),
       defaultCodec,
       defaultOutName,
       defaultVideoImageFormat,
@@ -24805,7 +24831,7 @@ var selectComposition = async (options2) => {
     browserExecutable: browserExecutable ?? null,
     chromiumOptions: chromiumOptions ?? {},
     envVariables: envVariables ?? {},
-    serializedInputPropsWithCustomSchema: NoReactInternals17.serializeJSONWithSpecialTypes({
+    serializedInputPropsWithCustomSchema: NoReactInternals19.serializeJSONWithSpecialTypes({
       indent: undefined,
       staticBase: null,
       data: inputProps ?? {}
@@ -25240,12 +25266,25 @@ var extractAudio = async (options2) => {
     binariesDirectory: options2.binariesDirectory ?? null,
     extraThreads: 0
   });
-  await compositor.executeCommand("ExtractAudio", {
-    input_path: options2.videoSource,
-    output_path: options2.audioOutput
-  });
-  await compositor.finishCommands();
-  await compositor.waitForDone();
+  let executeError;
+  try {
+    await compositor.executeCommand("ExtractAudio", {
+      input_path: options2.videoSource,
+      output_path: options2.audioOutput
+    });
+  } catch (error) {
+    executeError = error;
+  }
+  try {
+    await compositor.shutDownOrKill();
+  } catch (shutdownError) {
+    if (!executeError) {
+      throw shutdownError;
+    }
+  }
+  if (executeError) {
+    throw executeError;
+  }
 };
 // src/get-silent-parts.ts
 var getSilentParts = async ({
@@ -25316,7 +25355,11 @@ var getAudibleParts = ({
 };
 // src/get-video-metadata.ts
 import { resolve as resolve2 } from "node:path";
+import { NoReactInternals as NoReactInternals20 } from "remotion/no-react";
 var getVideoMetadata = async (videoSource, options2) => {
+  if (NoReactInternals20.ENABLE_V5_BREAKING_CHANGES) {
+    throw new Error("getVideoMetadata() has been removed in Remotion 5. Use Mediabunny instead: https://www.remotion.dev/docs/mediabunny/metadata");
+  }
   const compositor = startLongRunningCompositor({
     maximumFrameCacheItemsInBytes: null,
     logLevel: options2?.logLevel ?? "info",

package/dist/extract-audio.js

@@ -15,11 +15,26 @@ const extractAudio = async (options) => {
         binariesDirectory: (_b = options.binariesDirectory) !== null && _b !== void 0 ? _b : null,
         extraThreads: 0,
     });
-    await compositor.executeCommand('ExtractAudio', {
-        input_path: options.videoSource,
-        output_path: options.audioOutput,
-    });
-    await compositor.finishCommands();
-    await compositor.waitForDone();
+    let executeError;
+    try {
+        await compositor.executeCommand('ExtractAudio', {
+            input_path: options.videoSource,
+            output_path: options.audioOutput,
+        });
+    }
+    catch (error) {
+        executeError = error;
+    }
+    try {
+        await compositor.shutDownOrKill();
+    }
+    catch (shutdownError) {
+        if (!executeError) {
+            throw shutdownError;
+        }
+    }
+    if (executeError) {
+        throw executeError;
+    }
 };
 exports.extractAudio = extractAudio;

package/dist/get-compositions.d.ts

@@ -21,7 +21,7 @@ type InternalGetCompositionsOptions = {
     serveUrlOrWebpackUrl: string;
     onLog: OnLog;
 } & ToOptions<typeof optionsMap.getCompositions>;
-export type GetCompositionsOptions = RequiredInputPropsInV5 & {
+export type LegacyGetCompositionsOptions = RequiredInputPropsInV5 & {
     envVariables?: Record<string, string>;
     puppeteerInstance?: HeadlessBrowser;
     onBrowserLog?: (log: BrowserLog) => void;
@@ -29,6 +29,10 @@ export type GetCompositionsOptions = RequiredInputPropsInV5 & {
     chromiumOptions?: ChromiumOptions;
     port?: number | null;
 } & Partial<ToOptions<typeof optionsMap.getCompositions>>;
+export type GetCompositionsOptions = LegacyGetCompositionsOptions & {
+    serveUrl: string;
+};
+type GetCompositionsArguments = [options: GetCompositionsOptions] | [serveUrlOrWebpackUrl: string, config?: LegacyGetCompositionsOptions];
 export declare const internalGetCompositions: (args_0: InternalGetCompositionsOptions) => Promise<VideoConfig[]>;
-export declare const getCompositions: (serveUrlOrWebpackUrl: string, config?: GetCompositionsOptions | undefined) => Promise<VideoConfig[]>;
+export declare const getCompositions: (...args: GetCompositionsArguments) => Promise<VideoConfig[]>;
 export {};

package/dist/get-compositions.js

@@ -16,6 +16,20 @@ const seek_to_frame_1 = require("./seek-to-frame");
 const set_props_and_env_1 = require("./set-props-and-env");
 const validate_puppeteer_timeout_1 = require("./validate-puppeteer-timeout");
 const wrap_with_error_handling_1 = require("./wrap-with-error-handling");
+const convertGetCompositionsArgumentsToOptions = (args) => {
+    var _a;
+    if (args.length === 0) {
+        throw new Error('No serve URL or webpack bundle directory was passed to getCompositions().');
+    }
+    const firstArg = args[0];
+    if (typeof firstArg === 'string') {
+        return {
+            ...((_a = args[1]) !== null && _a !== void 0 ? _a : {}),
+            serveUrl: firstArg,
+        };
+    }
+    return firstArg;
+};
 const innerGetCompositions = async ({ envVariables, serializedInputPropsWithCustomSchema, page, proxyPort, serveUrl, timeoutInMilliseconds, indent, logLevel, mediaCacheSizeInBytes, darkMode, }) => {
     (0, validate_puppeteer_timeout_1.validatePuppeteerTimeout)(timeoutInMilliseconds);
     await (0, set_props_and_env_1.setPropsAndEnv)({
@@ -163,11 +177,12 @@ exports.internalGetCompositions = (0, wrap_with_error_handling_1.wrapWithErrorHa
  * @description Gets a list of compositions defined in a Remotion project based on a Remotion Bundle by evaluating the Remotion Root.
  * @see [Documentation](https://www.remotion.dev/docs/renderer/get-compositions)
  */
-const getCompositions = (serveUrlOrWebpackUrl, config) => {
-    if (!serveUrlOrWebpackUrl) {
+const getCompositions = (...args) => {
+    const options = convertGetCompositionsArgumentsToOptions(args);
+    if (typeof (options === null || options === void 0 ? void 0 : options.serveUrl) !== 'string' || !options.serveUrl) {
         throw new Error('No serve URL or webpack bundle directory was passed to getCompositions().');
     }
-    const { browserExecutable, chromiumOptions, envVariables, inputProps, onBrowserLog, port, puppeteerInstance, timeoutInMilliseconds, logLevel: passedLogLevel, onBrowserDownload, binariesDirectory, offthreadVideoCacheSizeInBytes, chromeMode, offthreadVideoThreads, mediaCacheSizeInBytes, } = config !== null && config !== void 0 ? config : {};
+    const { browserExecutable, chromiumOptions, envVariables, inputProps, onBrowserLog, port, puppeteerInstance, timeoutInMilliseconds, logLevel: passedLogLevel, onBrowserDownload, binariesDirectory, offthreadVideoCacheSizeInBytes, chromeMode, offthreadVideoThreads, mediaCacheSizeInBytes, serveUrl, } = options;
     const indent = false;
     const logLevel = passedLogLevel !== null && passedLogLevel !== void 0 ? passedLogLevel : 'info';
     return (0, exports.internalGetCompositions)({
@@ -183,7 +198,7 @@ const getCompositions = (serveUrlOrWebpackUrl, config) => {
         onBrowserLog: onBrowserLog !== null && onBrowserLog !== void 0 ? onBrowserLog : null,
         port: port !== null && port !== void 0 ? port : null,
         puppeteerInstance: puppeteerInstance !== null && puppeteerInstance !== void 0 ? puppeteerInstance : undefined,
-        serveUrlOrWebpackUrl,
+        serveUrlOrWebpackUrl: serveUrl,
         server: undefined,
         timeoutInMilliseconds: timeoutInMilliseconds !== null && timeoutInMilliseconds !== void 0 ? timeoutInMilliseconds : TimeoutSettings_1.DEFAULT_TIMEOUT,
         logLevel,

package/dist/get-video-metadata.d.ts

@@ -1,7 +1,7 @@
 import type { VideoMetadata } from './compositor/payloads';
 export { VideoMetadata } from './compositor/payloads';
 /**
- * @deprecated Use `parseMedia()` instead: https://www.remotion.dev/docs/media-parser/parse-media
+ * @deprecated Use Mediabunny instead: https://www.remotion.dev/docs/mediabunny/metadata
  */
 export declare const getVideoMetadata: (videoSource: string, options?: {
     logLevel?: "error" | "info" | "trace" | "verbose" | "warn" | undefined;

package/dist/get-video-metadata.js

@@ -2,12 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getVideoMetadata = void 0;
 const node_path_1 = require("node:path");
+const no_react_1 = require("remotion/no-react");
 const compositor_1 = require("./compositor/compositor");
 /**
- * @deprecated Use `parseMedia()` instead: https://www.remotion.dev/docs/media-parser/parse-media
+ * @deprecated Use Mediabunny instead: https://www.remotion.dev/docs/mediabunny/metadata
  */
 const getVideoMetadata = async (videoSource, options) => {
     var _a, _b;
+    if (no_react_1.NoReactInternals.ENABLE_V5_BREAKING_CHANGES) {
+        throw new Error('getVideoMetadata() has been removed in Remotion 5. Use Mediabunny instead: https://www.remotion.dev/docs/mediabunny/metadata');
+    }
     const compositor = (0, compositor_1.startLongRunningCompositor)({
         maximumFrameCacheItemsInBytes: null,
         logLevel: (_a = options === null || options === void 0 ? void 0 : options.logLevel) !== null && _a !== void 0 ? _a : 'info',

package/dist/index.d.ts

@@ -19,7 +19,7 @@ export { extractAudio } from './extract-audio';
 export type { FfmpegOverrideFn } from './ffmpeg-override';
 export { FileExtension } from './file-extensions';
 export { FrameRange } from './frame-range';
-export { GetCompositionsOptions, getCompositions } from './get-compositions';
+export { GetCompositionsOptions, getCompositions, LegacyGetCompositionsOptions, } from './get-compositions';
 export { SilentPart, getSilentParts } from './get-silent-parts';
 export { VideoMetadata, getVideoMetadata } from './get-video-metadata';
 export { ImageFormat, StillImageFormat, VideoImageFormat, validateSelectedPixelFormatAndImageFormatCombination, } from './image-format';

package/dist/open-browser.d.ts

@@ -1,4 +1,4 @@
-import type { NoReactInternals } from 'remotion/no-react';
+import { NoReactInternals } from 'remotion/no-react';
 import type { Browser } from './browser';
 import type { HeadlessBrowser } from './browser/Browser';
 import type { Viewport } from './browser/PuppeteerViewport';
@@ -8,13 +8,6 @@ import type { validOpenGlRenderers } from './options/gl';
 import type { ToOptions } from './options/option';
 import type { optionsMap } from './options/options-map';
 type OpenGlRenderer = (typeof validOpenGlRenderers)[number];
-type OnlyV4Options = typeof NoReactInternals.ENABLE_V5_BREAKING_CHANGES extends true ? {} : {
-    /**
-     * @deprecated - Will be removed in v5.
-     * Chrome Headless shell does not allow disabling headless mode anymore.
-     */
-    headless?: boolean;
-};
 export type ChromiumOptions = {
     ignoreCertificateErrors?: boolean;
     disableWebSecurity?: boolean;
@@ -22,7 +15,13 @@ export type ChromiumOptions = {
     userAgent?: string | null;
     enableMultiProcessOnLinux?: boolean;
     darkMode?: boolean;
-} & OnlyV4Options;
+    /**
+     * Opens a browser window if Chrome for Testing or a custom Chrome/Chromium
+     * executable is used. Chrome Headless Shell always runs headlessly.
+     */
+    headless?: boolean;
+};
+export declare const getOpenGlRenderer: (option: "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan" | null | undefined, enableV5BreakingChanges?: boolean) => string[];
 type InternalOpenBrowserOptions = {
     browserExecutable: string | null;
     chromiumOptions: ChromiumOptions;

package/dist/open-browser.js

@@ -3,10 +3,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.openBrowser = exports.internalOpenBrowser = void 0;
+exports.openBrowser = exports.internalOpenBrowser = exports.getOpenGlRenderer = void 0;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
+const no_react_1 = require("remotion/no-react");
 const browser_download_progress_bar_1 = require("./browser/browser-download-progress-bar");
 const Launcher_1 = require("./browser/Launcher");
 const ensure_browser_1 = require("./ensure-browser");
@@ -15,7 +16,9 @@ const get_video_threads_flag_1 = require("./get-video-threads-flag");
 const logger_1 = require("./logger");
 const gl_1 = require("./options/gl");
 const featuresToEnable = (option) => {
-    const renderer = option !== null && option !== void 0 ? option : gl_1.DEFAULT_OPENGL_RENDERER;
+    const renderer = option === undefined
+        ? (0, gl_1.getDefaultOpenGlRenderer)(no_react_1.NoReactInternals.ENABLE_V5_BREAKING_CHANGES)
+        : option;
     const enableAlways = [
         'NetworkService',
         'NetworkServiceInProcess',
@@ -29,8 +32,10 @@ const featuresToEnable = (option) => {
     }
     return enableAlways;
 };
-const getOpenGlRenderer = (option) => {
-    const renderer = option !== null && option !== void 0 ? option : gl_1.DEFAULT_OPENGL_RENDERER;
+const getOpenGlRenderer = (option, enableV5BreakingChanges = no_react_1.NoReactInternals.ENABLE_V5_BREAKING_CHANGES) => {
+    const renderer = option === undefined
+        ? (0, gl_1.getDefaultOpenGlRenderer)(enableV5BreakingChanges)
+        : option;
     (0, gl_1.validateOpenGlRenderer)(renderer);
     if (renderer === 'swangle') {
         return ['--use-gl=angle', '--use-angle=swiftshader'];
@@ -51,11 +56,20 @@ const getOpenGlRenderer = (option) => {
     if (renderer === null) {
         return [];
     }
+    if (renderer === 'angle' && enableV5BreakingChanges) {
+        return [
+            '--use-gl=angle',
+            // Opt into Chromium's software WebGL fallback for GPU-less machines:
+            // https://chromium.googlesource.com/chromium/src/+/main/docs/gpu/swiftshader.md
+            '--enable-unsafe-swiftshader',
+        ];
+    }
     return [`--use-gl=${renderer}`];
 };
+exports.getOpenGlRenderer = getOpenGlRenderer;
 const internalOpenBrowser = async ({ browser, browserExecutable, chromiumOptions, forceDeviceScaleFactor, indent, viewport, logLevel, onBrowserDownload, chromeMode, }) => {
     var _a;
-    var _b, _c, _d;
+    var _b, _c;
     // @ts-expect-error Firefox
     if (browser === 'firefox') {
         throw new TypeError('Firefox supported is not yet turned on. Stay tuned for the future.');
@@ -75,8 +89,8 @@ const internalOpenBrowser = async ({ browser, browserExecutable, chromiumOptions
         indent,
         chromeMode,
     });
-    const customGlRenderer = getOpenGlRenderer((_b = chromiumOptions.gl) !== null && _b !== void 0 ? _b : null);
-    const enableMultiProcessOnLinux = (_c = chromiumOptions.enableMultiProcessOnLinux) !== null && _c !== void 0 ? _c : true;
+    const customGlRenderer = (0, exports.getOpenGlRenderer)(chromiumOptions.gl);
+    const enableMultiProcessOnLinux = (_b = chromiumOptions.enableMultiProcessOnLinux) !== null && _b !== void 0 ? _b : true;
     logger_1.Log.verbose({ indent, logLevel, tag: 'openBrowser()' }, `Opening browser: gl = ${chromiumOptions.gl}, executable = ${executablePath}, enableMultiProcessOnLinux = ${enableMultiProcessOnLinux}`);
     if (chromiumOptions.userAgent) {
         logger_1.Log.verbose({ indent, logLevel, tag: 'openBrowser()' }, `Using custom user agent: ${chromiumOptions.userAgent}`);
@@ -123,7 +137,7 @@ const internalOpenBrowser = async ({ browser, browserExecutable, chromiumOptions
             '--enable-blink-features=IdleDetection',
             '--export-tagged-pdf',
             '--intensive-wake-up-throttling-policy=0',
-            ((_d = chromiumOptions.headless) !== null && _d !== void 0 ? _d : true)
+            ((_c = chromiumOptions.headless) !== null && _c !== void 0 ? _c : true)
                 ? chromeMode === 'chrome-for-testing'
                     ? '--headless=new'
                     : '--headless=old'

package/dist/options/gl.d.ts

@@ -1,6 +1,7 @@
 export declare const validOpenGlRenderers: readonly ["swangle", "angle", "egl", "swiftshader", "vulkan", "angle-egl"];
 export type OpenGlRenderer = (typeof validOpenGlRenderers)[number];
-export declare const DEFAULT_OPENGL_RENDERER: OpenGlRenderer | null;
+export declare const getDefaultOpenGlRenderer: (enableV5BreakingChanges: boolean) => "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan" | null;
+export declare const DEFAULT_OPENGL_RENDERER: "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan" | null;
 export declare const getChromiumOpenGlRenderer: () => "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan" | null;
 export declare const setChromiumOpenGlRenderer: (renderer: "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan") => void;
 export declare const glOption: {
@@ -13,10 +14,7 @@ export declare const glOption: {
     getValue: ({ commandLine }: {
         commandLine: Record<string, unknown>;
     }) => {
-        value: "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan";
-        source: string;
-    } | {
-        value: null;
+        value: "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan" | null;
         source: string;
     };
     setConfig: (value: "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan" | null) => void;

package/dist/options/gl.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateOpenGlRenderer = exports.glOption = exports.setChromiumOpenGlRenderer = exports.getChromiumOpenGlRenderer = exports.DEFAULT_OPENGL_RENDERER = exports.validOpenGlRenderers = void 0;
+exports.validateOpenGlRenderer = exports.glOption = exports.setChromiumOpenGlRenderer = exports.getChromiumOpenGlRenderer = exports.DEFAULT_OPENGL_RENDERER = exports.getDefaultOpenGlRenderer = exports.validOpenGlRenderers = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
+const no_react_1 = require("remotion/no-react");
 exports.validOpenGlRenderers = [
     'swangle',
     'angle',
@@ -10,7 +11,11 @@ exports.validOpenGlRenderers = [
     'vulkan',
     'angle-egl',
 ];
-exports.DEFAULT_OPENGL_RENDERER = null;
+const getDefaultOpenGlRenderer = (enableV5BreakingChanges) => {
+    return enableV5BreakingChanges ? 'angle' : null;
+};
+exports.getDefaultOpenGlRenderer = getDefaultOpenGlRenderer;
+exports.DEFAULT_OPENGL_RENDERER = (0, exports.getDefaultOpenGlRenderer)(no_react_1.NoReactInternals.ENABLE_V5_BREAKING_CHANGES);
 let openGlRenderer = exports.DEFAULT_OPENGL_RENDERER;
 const getChromiumOpenGlRenderer = () => openGlRenderer;
 exports.getChromiumOpenGlRenderer = getChromiumOpenGlRenderer;
@@ -26,8 +31,9 @@ const AngleChangelog = () => {
                             ", but from v3.0.8 the default is", ' ', jsx_runtime_1.jsx("code", { children: "swangle" }),
                             " (Swiftshader on Angle) since Chrome 101 added support for it."] }), jsx_runtime_1.jsxs("li", { children: ["From Remotion v2.4.3 until v2.6.6, the default was ",
                             jsx_runtime_1.jsx("code", { children: "angle" }),
-                            ", however it turns out to have a small memory leak that could crash long Remotion renders."] })
-                ] })
+                            ", however it turns out to have a small memory leak that could crash long Remotion renders."] }), no_react_1.NoReactInternals.ENABLE_V5_BREAKING_CHANGES ? (jsx_runtime_1.jsxs("li", { children: ["From Remotion v5.0, the default is ",
+                            jsx_runtime_1.jsx("code", { children: "angle" }),
+                            ". If no compatible GPU is available, Chromium automatically falls back to SwiftShader."] })) : null] })
         ] }));
 };
 const cliFlag = 'gl';
@@ -51,9 +57,11 @@ exports.glOption = {
                                 " (",
                                 jsx_runtime_1.jsx("em", { children: "from Remotion v4.0.51" }),
                                 ")"] })
-                    ] }), jsx_runtime_1.jsxs("p", { children: ["The default is ",
-                        jsx_runtime_1.jsx("code", { children: "null" }),
-                        ", letting Chrome decide, except on Lambda where the default is ",
+                    ] }), jsx_runtime_1.jsxs("p", { children: ["The default is", ' ', jsx_runtime_1.jsx("code", { children: exports.DEFAULT_OPENGL_RENDERER === null
+                                ? 'null'
+                                : `"${exports.DEFAULT_OPENGL_RENDERER}"` }), exports.DEFAULT_OPENGL_RENDERER === null
+                            ? ', letting Chrome decide'
+                            : ', with automatic fallback to SwiftShader if no compatible GPU is available', ", except on Lambda where the default is ",
                         jsx_runtime_1.jsx("code", { children: '"swangle"' })
                     ] })
             ] }));

package/dist/options/headless.js

@@ -8,10 +8,7 @@ const cliFlag = 'disable-headless';
 exports.headlessOption = {
     name: 'Disable Headless Mode',
     cliFlag,
-    description: () => (jsx_runtime_1.jsxs(jsx_runtime_1.Fragment, { children: ["Deprecated - will be removed in 5.0.0. With the migration to", ' ', jsx_runtime_1.jsx("a", { href: "/docs/miscellaneous/chrome-headless-shell", children: "Chrome Headless Shell" }),
-            ", this option is not functional anymore.",
-            jsx_runtime_1.jsx("br", {}), jsx_runtime_1.jsx("br", {}),
-            " If disabled, the render will open an actual Chrome window where you can see the render happen. The default is headless mode."] })),
+    description: () => (jsx_runtime_1.jsxs(jsx_runtime_1.Fragment, { children: ["If disabled, the render will open an actual Chrome window where you can see the render happen. This requires", ' ', jsx_runtime_1.jsx("a", { href: "/docs/miscellaneous/chrome-headless-shell", children: "Chrome for Testing" }), ' ', "or a custom Chrome or Chromium executable. Chrome Headless Shell always runs headlessly. The default is headless mode."] })),
     ssrName: 'headless',
     docLink: 'https://www.remotion.dev/docs/chromium-flags#--disable-headless',
     type: false,

package/dist/options/index.d.ts

@@ -386,10 +386,7 @@ export declare const allOptions: {
         getValue: ({ commandLine }: {
             commandLine: Record<string, unknown>;
         }) => {
-            value: "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan";
-            source: string;
-        } | {
-            value: null;
+            value: "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan" | null;
             source: string;
         };
         setConfig: (value: "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan" | null) => void;

package/dist/options/public-path.js

@@ -9,12 +9,10 @@ exports.publicPathOption = {
     cliFlag,
     description: () => {
         return (jsx_runtime_1.jsxs(jsx_runtime_1.Fragment, { children: ["The path of the URL where the bundle is going to be hosted. By default it is ",
-                jsx_runtime_1.jsx("code", { children: "/" }),
-                ", meaning that the bundle is going to be hosted at the root of the domain (e.g. ",
-                jsx_runtime_1.jsx("code", { children: "https://localhost:3000/" }),
-                "). If you are deploying to a subdirectory (e.g. ",
+                jsx_runtime_1.jsx("code", { children: "./" }),
+                ", making the bundle relocatable. Set an absolute path such as ",
                 jsx_runtime_1.jsx("code", { children: "/sites/my-site/" }),
-                "), you should set this to the subdirectory."] }));
+                " to host the bundle at a fixed location."] }));
     },
     ssrName: 'publicPath',
     docLink: 'https://www.remotion.dev/docs/renderer',

package/dist/set-props-and-env.js

@@ -166,6 +166,11 @@ const innerSetPropsAndEnv = async ({ serializedInputPropsWithCustomSchema, envVa
         page,
         timeoutInMilliseconds: actualTimeout,
     });
+    // Increment this value when the generated bundle format or behavior changes
+    // in a backwards-incompatible way. It is not the Remotion package version and
+    // should not be bumped for every generated HTML change. Keep it synchronized
+    // with window.siteVersion in packages/studio-shared/src/studio-html.ts by
+    // incrementing both values.
     const requiredVersion = '11';
     if (siteVersion !== requiredVersion) {
         throw new Error([

package/package.json

@@ -3,7 +3,7 @@
 		"url": "https://github.com/remotion-dev/remotion/tree/main/packages/renderer"
 	},
 	"name": "@remotion/renderer",
-	"version": "4.0.496",
+	"version": "4.0.498",
 	"description": "Render Remotion videos using Node.js or Bun",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -22,11 +22,11 @@
 	},
 	"dependencies": {
 		"execa": "5.1.1",
-		"remotion": "4.0.496",
-		"@remotion/streaming": "4.0.496",
+		"remotion": "4.0.498",
+		"@remotion/streaming": "4.0.498",
 		"source-map": "0.8.0-beta.0",
 		"ws": "8.21.0",
-		"@remotion/licensing": "4.0.496"
+		"@remotion/licensing": "4.0.498"
 	},
 	"peerDependencies": {
 		"react": ">=16.8.0",
@@ -40,19 +40,19 @@
 		"react-dom": "19.2.3",
 		"@typescript/native-preview": "7.0.0-dev.20260217.1",
 		"@types/ws": "8.5.10",
-		"@remotion/example-videos": "4.0.496",
-		"@remotion/eslint-config-internal": "4.0.496",
+		"@remotion/example-videos": "4.0.498",
+		"@remotion/eslint-config-internal": "4.0.498",
 		"eslint": "9.19.0",
 		"@types/node": "20.12.14"
 	},
 	"optionalDependencies": {
-		"@remotion/compositor-darwin-arm64": "4.0.496",
-		"@remotion/compositor-darwin-x64": "4.0.496",
-		"@remotion/compositor-linux-arm64-gnu": "4.0.496",
-		"@remotion/compositor-linux-arm64-musl": "4.0.496",
-		"@remotion/compositor-linux-x64-gnu": "4.0.496",
-		"@remotion/compositor-linux-x64-musl": "4.0.496",
-		"@remotion/compositor-win32-x64-msvc": "4.0.496"
+		"@remotion/compositor-darwin-arm64": "4.0.498",
+		"@remotion/compositor-darwin-x64": "4.0.498",
+		"@remotion/compositor-linux-arm64-gnu": "4.0.498",
+		"@remotion/compositor-linux-arm64-musl": "4.0.498",
+		"@remotion/compositor-linux-x64-gnu": "4.0.498",
+		"@remotion/compositor-linux-x64-musl": "4.0.498",
+		"@remotion/compositor-win32-x64-msvc": "4.0.498"
 	},
 	"keywords": [
 		"remotion",