@remotion/renderer 4.0.301 → 4.0.303

package/dist/client.d.ts

@@ -884,6 +884,24 @@ export declare const BrowserSafeApis: {
             };
             setConfig: (value: string | null) => void;
         };
+        audioLatencyHintOption: {
+            name: string;
+            cliFlag: "audio-latency-hint";
+            description: () => import("react/jsx-runtime").JSX.Element;
+            ssrName: "audioLatencyHint";
+            docLink: string;
+            type: AudioContextLatencyCategory;
+            getValue: ({ commandLine }: {
+                commandLine: Record<string, unknown>;
+            }) => {
+                value: AudioContextLatencyCategory;
+                source: string;
+            } | {
+                value: null;
+                source: string;
+            };
+            setConfig: (profile: AudioContextLatencyCategory | null) => void;
+        };
     };
     validColorSpaces: readonly ["default", "bt709", "bt2020-ncl"];
     optionsMap: {

package/dist/esm/client.mjs

@@ -1597,44 +1597,99 @@ var jpegQualityOption = {
   }
 };
 
-// src/options/log-level.tsx
+// src/options/latency-hint.tsx
 import { jsx as jsx19, jsxs as jsxs15, Fragment as Fragment19 } from "react/jsx-runtime";
+var cliFlag23 = "audio-latency-hint";
+var value = null;
+var audioLatencyHintOption = {
+  name: "Audio Latency Hint",
+  cliFlag: cliFlag23,
+  description: () => /* @__PURE__ */ jsxs15(Fragment19, {
+    children: [
+      "Sets the",
+      " ",
+      /* @__PURE__ */ jsx19("a", {
+        href: "https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/AudioContext",
+        children: "audio latency"
+      }),
+      " ",
+      "hint for the global ",
+      /* @__PURE__ */ jsx19("code", {
+        children: "AudioContext"
+      }),
+      " context that Remotion uses to play audio.",
+      /* @__PURE__ */ jsx19("br", {}),
+      "Possible values: ",
+      /* @__PURE__ */ jsx19("code", {
+        children: "interactive"
+      }),
+      ", ",
+      /* @__PURE__ */ jsx19("code", {
+        children: "balanced"
+      }),
+      ",",
+      " ",
+      /* @__PURE__ */ jsx19("code", {
+        children: "playback"
+      })
+    ]
+  }),
+  ssrName: "audioLatencyHint",
+  docLink: "https://www.remotion.dev/docs/renderer/render-media",
+  type: "interactive",
+  getValue: ({ commandLine }) => {
+    const val = commandLine[cliFlag23];
+    if (typeof val !== "undefined") {
+      return { value: val, source: "cli" };
+    }
+    if (value !== null) {
+      return { value, source: "config" };
+    }
+    return { value: null, source: "default" };
+  },
+  setConfig: (profile) => {
+    value = profile;
+  }
+};
+
+// src/options/log-level.tsx
+import { jsx as jsx20, jsxs as jsxs16, Fragment as Fragment20 } from "react/jsx-runtime";
 var logLevel = "info";
-var cliFlag23 = "log";
+var cliFlag24 = "log";
 var logLevelOption = {
-  cliFlag: cliFlag23,
+  cliFlag: cliFlag24,
   name: "Log Level",
   ssrName: "logLevel",
-  description: () => /* @__PURE__ */ jsxs15(Fragment19, {
+  description: () => /* @__PURE__ */ jsxs16(Fragment20, {
     children: [
       "One of ",
-      /* @__PURE__ */ jsx19("code", {
+      /* @__PURE__ */ jsx20("code", {
         children: "trace"
       }),
       ", ",
-      /* @__PURE__ */ jsx19("code", {
+      /* @__PURE__ */ jsx20("code", {
         children: "verbose"
       }),
       ", ",
-      /* @__PURE__ */ jsx19("code", {
+      /* @__PURE__ */ jsx20("code", {
         children: "info"
       }),
       ",",
       " ",
-      /* @__PURE__ */ jsx19("code", {
+      /* @__PURE__ */ jsx20("code", {
         children: "warn"
       }),
       ", ",
-      /* @__PURE__ */ jsx19("code", {
+      /* @__PURE__ */ jsx20("code", {
         children: "error"
       }),
       ".",
-      /* @__PURE__ */ jsx19("br", {}),
+      /* @__PURE__ */ jsx20("br", {}),
       " Determines how much info is being logged to the console.",
-      /* @__PURE__ */ jsx19("br", {}),
-      /* @__PURE__ */ jsx19("br", {}),
+      /* @__PURE__ */ jsx20("br", {}),
+      /* @__PURE__ */ jsx20("br", {}),
       " Default ",
-      /* @__PURE__ */ jsx19("code", {
+      /* @__PURE__ */ jsx20("code", {
         children: "info"
       }),
       "."
@@ -1642,11 +1697,11 @@ var logLevelOption = {
   }),
   docLink: "https://www.remotion.dev/docs/troubleshooting/debug-failed-render",
   getValue: ({ commandLine }) => {
-    if (commandLine[cliFlag23]) {
-      if (!isValidLogLevel(commandLine[cliFlag23])) {
+    if (commandLine[cliFlag24]) {
+      if (!isValidLogLevel(commandLine[cliFlag24])) {
         throw new Error(`Invalid \`--log\` value passed. Accepted values: ${logLevels.map((l) => `'${l}'`).join(", ")}.`);
       }
-      return { value: commandLine[cliFlag23], source: "cli" };
+      return { value: commandLine[cliFlag24], source: "cli" };
     }
     if (logLevel !== "info") {
       return { value: logLevel, source: "config" };
@@ -1660,19 +1715,19 @@ var logLevelOption = {
 };
 
 // src/options/metadata.tsx
-import { jsx as jsx20, jsxs as jsxs16, Fragment as Fragment20 } from "react/jsx-runtime";
+import { jsx as jsx21, jsxs as jsxs17, Fragment as Fragment21 } from "react/jsx-runtime";
 var metadata = {};
-var cliFlag24 = "metadata";
+var cliFlag25 = "metadata";
 var metadataOption = {
   name: "Metadata",
-  cliFlag: cliFlag24,
+  cliFlag: cliFlag25,
   description: (mode) => {
     if (mode === "ssr") {
-      return /* @__PURE__ */ jsxs16(Fragment20, {
+      return /* @__PURE__ */ jsxs17(Fragment21, {
         children: [
           "An object containing metadata to be embedded in the video. See",
           " ",
-          /* @__PURE__ */ jsx20("a", {
+          /* @__PURE__ */ jsx21("a", {
             href: "/docs/metadata",
             children: "here"
           }),
@@ -1680,18 +1735,18 @@ var metadataOption = {
         ]
       });
     }
-    return /* @__PURE__ */ jsxs16(Fragment20, {
+    return /* @__PURE__ */ jsxs17(Fragment21, {
       children: [
         "Metadata to be embedded in the video. See",
         " ",
-        /* @__PURE__ */ jsx20("a", {
+        /* @__PURE__ */ jsx21("a", {
           href: "/docs/metadata",
           children: "here"
         }),
         " for which metadata is accepted.",
-        /* @__PURE__ */ jsx20("br", {}),
+        /* @__PURE__ */ jsx21("br", {}),
         "The parameter must be in the format of ",
-        /* @__PURE__ */ jsx20("code", {
+        /* @__PURE__ */ jsx21("code", {
           children: "--metadata key=value"
         }),
         " ",
@@ -1702,8 +1757,8 @@ var metadataOption = {
   docLink: "https://www.remotion.dev/docs/metadata",
   type: {},
   getValue: ({ commandLine }) => {
-    if (commandLine[cliFlag24] !== undefined) {
-      const val = commandLine[cliFlag24];
+    if (commandLine[cliFlag25] !== undefined) {
+      const val = commandLine[cliFlag25];
       const array = typeof val === "string" ? [val] : val;
       const keyValues = array.map((a) => {
         if (!a.includes("=")) {
@@ -1715,10 +1770,10 @@ var metadataOption = {
         }
         return [splitted[0], splitted[1]];
       });
-      const value = Object.fromEntries(keyValues);
+      const value2 = Object.fromEntries(keyValues);
       return {
         source: "config",
-        value
+        value: value2
       };
     }
     return {
@@ -1733,24 +1788,24 @@ var metadataOption = {
 };
 
 // src/options/mute.tsx
-import { jsx as jsx21, Fragment as Fragment21 } from "react/jsx-runtime";
+import { jsx as jsx22, Fragment as Fragment22 } from "react/jsx-runtime";
 var DEFAULT_MUTED_STATE = false;
 var mutedState = DEFAULT_MUTED_STATE;
-var cliFlag25 = "muted";
+var cliFlag26 = "muted";
 var mutedOption = {
   name: "Muted",
-  cliFlag: cliFlag25,
-  description: () => /* @__PURE__ */ jsx21(Fragment21, {
+  cliFlag: cliFlag26,
+  description: () => /* @__PURE__ */ jsx22(Fragment22, {
     children: "The Audio of the video will be omitted."
   }),
   ssrName: "muted",
   docLink: "https://www.remotion.dev/docs/audio/muting",
   type: false,
   getValue: ({ commandLine }) => {
-    if (commandLine[cliFlag25] !== null) {
+    if (commandLine[cliFlag26] !== null) {
       return {
         source: "cli",
-        value: commandLine[cliFlag25]
+        value: commandLine[cliFlag26]
       };
     }
     if (mutedState !== DEFAULT_MUTED_STATE) {
@@ -1770,50 +1825,50 @@ var mutedOption = {
 };
 
 // src/options/number-of-gif-loops.tsx
-import { jsx as jsx22, jsxs as jsxs17, Fragment as Fragment22 } from "react/jsx-runtime";
+import { jsx as jsx23, jsxs as jsxs18, Fragment as Fragment23 } from "react/jsx-runtime";
 var currentLoop = null;
 var validate = (newLoop) => {
   if (newLoop !== null && typeof newLoop !== "number") {
     throw new Error("--number-of-gif-loops flag must be a number.");
   }
 };
-var cliFlag26 = "number-of-gif-loops";
+var cliFlag27 = "number-of-gif-loops";
 var numberOfGifLoopsOption = {
   name: "Number of GIF loops",
-  cliFlag: cliFlag26,
+  cliFlag: cliFlag27,
   description: () => {
-    return /* @__PURE__ */ jsxs17(Fragment22, {
+    return /* @__PURE__ */ jsxs18(Fragment23, {
       children: [
         "Allows you to set the number of loops as follows:",
-        /* @__PURE__ */ jsxs17("ul", {
+        /* @__PURE__ */ jsxs18("ul", {
           children: [
-            /* @__PURE__ */ jsxs17("li", {
+            /* @__PURE__ */ jsxs18("li", {
               children: [
-                /* @__PURE__ */ jsx22("code", {
+                /* @__PURE__ */ jsx23("code", {
                   children: "null"
                 }),
                 " (or omitting in the CLI) plays the GIF indefinitely."
               ]
             }),
-            /* @__PURE__ */ jsxs17("li", {
+            /* @__PURE__ */ jsxs18("li", {
               children: [
-                /* @__PURE__ */ jsx22("code", {
+                /* @__PURE__ */ jsx23("code", {
                   children: "0"
                 }),
                 " disables looping"
               ]
             }),
-            /* @__PURE__ */ jsxs17("li", {
+            /* @__PURE__ */ jsxs18("li", {
               children: [
-                /* @__PURE__ */ jsx22("code", {
+                /* @__PURE__ */ jsx23("code", {
                   children: "1"
                 }),
                 " loops the GIF once (plays twice in total)"
               ]
             }),
-            /* @__PURE__ */ jsxs17("li", {
+            /* @__PURE__ */ jsxs18("li", {
               children: [
-                /* @__PURE__ */ jsx22("code", {
+                /* @__PURE__ */ jsx23("code", {
                   children: "2"
                 }),
                 " loops the GIF twice (plays three times in total) and so on."
@@ -1828,10 +1883,10 @@ var numberOfGifLoopsOption = {
   docLink: "https://www.remotion.dev/docs/render-as-gif#changing-the-number-of-loops",
   type: 0,
   getValue: ({ commandLine }) => {
-    if (commandLine[cliFlag26] !== undefined) {
-      validate(commandLine[cliFlag26]);
+    if (commandLine[cliFlag27] !== undefined) {
+      validate(commandLine[cliFlag27]);
       return {
-        value: commandLine[cliFlag26],
+        value: commandLine[cliFlag27],
         source: "cli"
       };
     }
@@ -1853,35 +1908,35 @@ var numberOfGifLoopsOption = {
 };
 
 // src/options/offthreadvideo-cache-size.tsx
-import { jsx as jsx23, jsxs as jsxs18, Fragment as Fragment23 } from "react/jsx-runtime";
+import { jsx as jsx24, jsxs as jsxs19, Fragment as Fragment24 } from "react/jsx-runtime";
 var offthreadVideoCacheSizeInBytes = null;
-var cliFlag27 = "offthreadvideo-cache-size-in-bytes";
+var cliFlag28 = "offthreadvideo-cache-size-in-bytes";
 var offthreadVideoCacheSizeInBytesOption = {
   name: "OffthreadVideo cache size",
-  cliFlag: cliFlag27,
-  description: () => /* @__PURE__ */ jsxs18(Fragment23, {
+  cliFlag: cliFlag28,
+  description: () => /* @__PURE__ */ jsxs19(Fragment24, {
     children: [
       "From v4.0, Remotion has a cache for",
       " ",
-      /* @__PURE__ */ jsx23("a", {
+      /* @__PURE__ */ jsx24("a", {
         href: "https://remotion.dev/docs/offthreadvideo",
-        children: /* @__PURE__ */ jsx23("code", {
+        children: /* @__PURE__ */ jsx24("code", {
           children: "<OffthreadVideo>"
         })
       }),
       " ",
       "frames. The default is ",
-      /* @__PURE__ */ jsx23("code", {
+      /* @__PURE__ */ jsx24("code", {
         children: "null"
       }),
       ", corresponding to half of the system memory available when the render starts.",
-      /* @__PURE__ */ jsx23("br", {}),
+      /* @__PURE__ */ jsx24("br", {}),
       " This option allows to override the size of the cache. The higher it is, the faster the render will be, but the more memory will be used.",
-      /* @__PURE__ */ jsx23("br", {}),
+      /* @__PURE__ */ jsx24("br", {}),
       "The used value will be printed when running in verbose mode.",
-      /* @__PURE__ */ jsx23("br", {}),
+      /* @__PURE__ */ jsx24("br", {}),
       "Default: ",
-      /* @__PURE__ */ jsx23("code", {
+      /* @__PURE__ */ jsx24("code", {
         children: "null"
       })
     ]
@@ -1890,10 +1945,10 @@ var offthreadVideoCacheSizeInBytesOption = {
   docLink: "https://www.remotion.dev/docs/offthreadvideo",
   type: 0,
   getValue: ({ commandLine }) => {
-    if (commandLine[cliFlag27] !== undefined) {
+    if (commandLine[cliFlag28] !== undefined) {
       return {
         source: "cli",
-        value: commandLine[cliFlag27]
+        value: commandLine[cliFlag28]
       };
     }
     if (offthreadVideoCacheSizeInBytes !== null) {
@@ -1913,18 +1968,18 @@ var offthreadVideoCacheSizeInBytesOption = {
 };
 
 // src/options/offthreadvideo-threads.tsx
-import { jsx as jsx24, jsxs as jsxs19, Fragment as Fragment24 } from "react/jsx-runtime";
-var value = null;
-var cliFlag28 = "offthreadvideo-video-threads";
+import { jsx as jsx25, jsxs as jsxs20, Fragment as Fragment25 } from "react/jsx-runtime";
+var value2 = null;
+var cliFlag29 = "offthreadvideo-video-threads";
 var offthreadVideoThreadsOption = {
   name: "OffthreadVideo threads",
-  cliFlag: cliFlag28,
-  description: () => /* @__PURE__ */ jsxs19(Fragment24, {
+  cliFlag: cliFlag29,
+  description: () => /* @__PURE__ */ jsxs20(Fragment25, {
     children: [
       "The number of threads that",
-      /* @__PURE__ */ jsx24("a", {
+      /* @__PURE__ */ jsx25("a", {
         href: "https://remotion.dev/docs/offthreadvideo",
-        children: /* @__PURE__ */ jsx24("code", {
+        children: /* @__PURE__ */ jsx25("code", {
           children: "<OffthreadVideo>"
         })
       }),
@@ -1939,16 +1994,16 @@ var offthreadVideoThreadsOption = {
   docLink: "https://www.remotion.dev/docs/offthreadvideo",
   type: 0,
   getValue: ({ commandLine }) => {
-    if (commandLine[cliFlag28] !== undefined) {
+    if (commandLine[cliFlag29] !== undefined) {
       return {
         source: "cli",
-        value: commandLine[cliFlag28]
+        value: commandLine[cliFlag29]
       };
     }
-    if (value !== null) {
+    if (value2 !== null) {
       return {
         source: "config",
-        value
+        value: value2
       };
     }
     return {
@@ -1957,22 +2012,22 @@ var offthreadVideoThreadsOption = {
     };
   },
   setConfig: (size) => {
-    value = size ?? null;
+    value2 = size ?? null;
   }
 };
 var DEFAULT_RENDER_FRAMES_OFFTHREAD_VIDEO_THREADS = 2;
 
 // src/options/on-browser-download.tsx
-import { jsx as jsx25, jsxs as jsxs20, Fragment as Fragment25 } from "react/jsx-runtime";
-var cliFlag29 = "on-browser-download";
+import { jsx as jsx26, jsxs as jsxs21, Fragment as Fragment26 } from "react/jsx-runtime";
+var cliFlag30 = "on-browser-download";
 var onBrowserDownloadOption = {
   name: "Browser download callback function",
-  cliFlag: cliFlag29,
-  description: () => /* @__PURE__ */ jsxs20(Fragment25, {
+  cliFlag: cliFlag30,
+  description: () => /* @__PURE__ */ jsxs21(Fragment26, {
     children: [
       "Gets called when no compatible local browser is detected on the system and this API needs to download a browser. Return a callback to observe progress.",
       " ",
-      /* @__PURE__ */ jsx25("a", {
+      /* @__PURE__ */ jsx26("a", {
         href: "/docs/renderer/ensure-browser#onbrowserdownload",
         children: "See here for how to use this option."
       })
@@ -1990,25 +2045,25 @@ var onBrowserDownloadOption = {
 };
 
 // src/options/overwrite.tsx
-import { jsx as jsx26, jsxs as jsxs21, Fragment as Fragment26 } from "react/jsx-runtime";
+import { jsx as jsx27, jsxs as jsxs22, Fragment as Fragment27 } from "react/jsx-runtime";
 var shouldOverwrite = null;
-var cliFlag30 = "overwrite";
-var validate2 = (value2) => {
-  if (typeof value2 !== "boolean") {
-    throw new Error(`overwriteExisting must be a boolean but got ${typeof value2} (${value2})`);
+var cliFlag31 = "overwrite";
+var validate2 = (value3) => {
+  if (typeof value3 !== "boolean") {
+    throw new Error(`overwriteExisting must be a boolean but got ${typeof value3} (${value3})`);
   }
 };
 var overwriteOption = {
   name: "Overwrite output",
-  cliFlag: cliFlag30,
-  description: () => /* @__PURE__ */ jsxs21(Fragment26, {
+  cliFlag: cliFlag31,
+  description: () => /* @__PURE__ */ jsxs22(Fragment27, {
     children: [
       "If set to ",
-      /* @__PURE__ */ jsx26("code", {
+      /* @__PURE__ */ jsx27("code", {
         children: "false"
       }),
       ", will prevent rendering to a path that already exists. Default is ",
-      /* @__PURE__ */ jsx26("code", {
+      /* @__PURE__ */ jsx27("code", {
         children: "true"
       }),
       "."
@@ -2018,11 +2073,11 @@ var overwriteOption = {
   docLink: "https://www.remotion.dev/docs/config#setoverwriteoutput",
   type: false,
   getValue: ({ commandLine }, defaultValue2) => {
-    if (commandLine[cliFlag30] !== undefined) {
-      validate2(commandLine[cliFlag30]);
+    if (commandLine[cliFlag31] !== undefined) {
+      validate2(commandLine[cliFlag31]);
       return {
         source: "cli",
-        value: commandLine[cliFlag30]
+        value: commandLine[cliFlag31]
       };
     }
     if (shouldOverwrite !== null) {
@@ -2036,28 +2091,28 @@ var overwriteOption = {
       value: defaultValue2
     };
   },
-  setConfig: (value2) => {
-    validate2(value2);
-    shouldOverwrite = value2;
+  setConfig: (value3) => {
+    validate2(value3);
+    shouldOverwrite = value3;
   }
 };
 
 // src/options/prefer-lossless.tsx
-import { jsx as jsx27, jsxs as jsxs22, Fragment as Fragment27 } from "react/jsx-runtime";
-var cliFlag31 = "prefer-lossless";
+import { jsx as jsx28, jsxs as jsxs23, Fragment as Fragment28 } from "react/jsx-runtime";
+var cliFlag32 = "prefer-lossless";
 var input = false;
 var preferLosslessAudioOption = {
   name: "Prefer lossless",
-  cliFlag: cliFlag31,
-  description: () => /* @__PURE__ */ jsxs22(Fragment27, {
+  cliFlag: cliFlag32,
+  description: () => /* @__PURE__ */ jsxs23(Fragment28, {
     children: [
       "Uses a lossless audio codec, if one is available for the codec. If you set",
-      /* @__PURE__ */ jsx27("code", {
+      /* @__PURE__ */ jsx28("code", {
         children: "audioCodec"
       }),
       ", it takes priority over",
       " ",
-      /* @__PURE__ */ jsx27("code", {
+      /* @__PURE__ */ jsx28("code", {
         children: "preferLossless"
       }),
       "."
@@ -2067,7 +2122,7 @@ var preferLosslessAudioOption = {
   type: false,
   ssrName: "preferLossless",
   getValue: ({ commandLine }) => {
-    if (commandLine[cliFlag31]) {
+    if (commandLine[cliFlag32]) {
       return { value: true, source: "cli" };
     }
     if (input === true) {
@@ -2081,20 +2136,20 @@ var preferLosslessAudioOption = {
 };
 
 // src/options/public-dir.tsx
-import { jsx as jsx28, jsxs as jsxs23, Fragment as Fragment28 } from "react/jsx-runtime";
-var cliFlag32 = "public-dir";
+import { jsx as jsx29, jsxs as jsxs24, Fragment as Fragment29 } from "react/jsx-runtime";
+var cliFlag33 = "public-dir";
 var currentPublicDir = null;
 var publicDirOption = {
   name: "Public Directory",
-  cliFlag: cliFlag32,
+  cliFlag: cliFlag33,
   description: () => {
-    return /* @__PURE__ */ jsxs23(Fragment28, {
+    return /* @__PURE__ */ jsxs24(Fragment29, {
       children: [
         "Define the location of the",
         " ",
-        /* @__PURE__ */ jsx28("a", {
+        /* @__PURE__ */ jsx29("a", {
           href: "/docs/terminology/public-dir",
-          children: /* @__PURE__ */ jsx28("code", {
+          children: /* @__PURE__ */ jsx29("code", {
             children: "public/ directory"
           })
         }),
@@ -2105,10 +2160,10 @@ var publicDirOption = {
   ssrName: "publicDir",
   docLink: "https://www.remotion.dev/docs/terminology/public-dir",
   getValue: ({ commandLine }) => {
-    if (commandLine[cliFlag32] !== undefined) {
+    if (commandLine[cliFlag33] !== undefined) {
       return {
         source: "cli",
-        value: commandLine[cliFlag32]
+        value: commandLine[cliFlag33]
       };
     }
     if (currentPublicDir !== null) {
@@ -2122,32 +2177,32 @@ var publicDirOption = {
       value: null
     };
   },
-  setConfig: (value2) => {
-    currentPublicDir = value2;
+  setConfig: (value3) => {
+    currentPublicDir = value3;
   },
   type: ""
 };
 
 // src/options/public-path.tsx
-import { jsx as jsx29, jsxs as jsxs24, Fragment as Fragment29 } from "react/jsx-runtime";
-var cliFlag33 = "public-path";
+import { jsx as jsx30, jsxs as jsxs25, Fragment as Fragment30 } from "react/jsx-runtime";
+var cliFlag34 = "public-path";
 var currentPublicPath = null;
 var publicPathOption = {
   name: "Public Path",
-  cliFlag: cliFlag33,
+  cliFlag: cliFlag34,
   description: () => {
-    return /* @__PURE__ */ jsxs24(Fragment29, {
+    return /* @__PURE__ */ jsxs25(Fragment30, {
       children: [
         "The path of the URL where the bundle is going to be hosted. By default it is ",
-        /* @__PURE__ */ jsx29("code", {
+        /* @__PURE__ */ jsx30("code", {
           children: "/"
         }),
         ", meaning that the bundle is going to be hosted at the root of the domain (e.g. ",
-        /* @__PURE__ */ jsx29("code", {
+        /* @__PURE__ */ jsx30("code", {
           children: "https://localhost:3000/"
         }),
         "). If you are deploying to a subdirectory (e.g. ",
-        /* @__PURE__ */ jsx29("code", {
+        /* @__PURE__ */ jsx30("code", {
           children: "/sites/my-site/"
         }),
         "), you should set this to the subdirectory."
@@ -2157,10 +2212,10 @@ var publicPathOption = {
   ssrName: "publicPath",
   docLink: "https://www.remotion.dev/docs/renderer",
   getValue: ({ commandLine }) => {
-    if (commandLine[cliFlag33] !== undefined) {
+    if (commandLine[cliFlag34] !== undefined) {
       return {
         source: "cli",
-        value: commandLine[cliFlag33]
+        value: commandLine[cliFlag34]
       };
     }
     if (currentPublicPath !== null) {
@@ -2174,32 +2229,32 @@ var publicPathOption = {
       value: null
     };
   },
-  setConfig: (value2) => {
-    currentPublicPath = value2;
+  setConfig: (value3) => {
+    currentPublicPath = value3;
   },
   type: ""
 };
 
 // src/options/repro.tsx
-import { jsx as jsx30, Fragment as Fragment30 } from "react/jsx-runtime";
+import { jsx as jsx31, Fragment as Fragment31 } from "react/jsx-runtime";
 var enableRepro = false;
 var setRepro = (should) => {
   enableRepro = should;
 };
-var cliFlag34 = "repro";
+var cliFlag35 = "repro";
 var reproOption = {
   name: "Create reproduction",
-  cliFlag: cliFlag34,
-  description: () => /* @__PURE__ */ jsx30(Fragment30, {
+  cliFlag: cliFlag35,
+  description: () => /* @__PURE__ */ jsx31(Fragment31, {
     children: "Create a ZIP that you can submit to Remotion if asked for a reproduction."
   }),
   ssrName: "repro",
   docLink: "https://www.remotion.dev/docs/render-media#repro",
   type: false,
   getValue: ({ commandLine }) => {
-    if (commandLine[cliFlag34] !== undefined) {
+    if (commandLine[cliFlag35] !== undefined) {
       return {
-        value: commandLine[cliFlag34],
+        value: commandLine[cliFlag35],
         source: "cli"
       };
     }
@@ -2218,21 +2273,21 @@ var reproOption = {
 };
 
 // src/options/scale.tsx
-import { jsx as jsx31, jsxs as jsxs25, Fragment as Fragment31 } from "react/jsx-runtime";
+import { jsx as jsx32, jsxs as jsxs26, Fragment as Fragment32 } from "react/jsx-runtime";
 var currentScale = 1;
-var cliFlag35 = "scale";
-var validateScale = (value2) => {
-  if (typeof value2 !== "number") {
+var cliFlag36 = "scale";
+var validateScale = (value3) => {
+  if (typeof value3 !== "number") {
     throw new Error("scale must be a number.");
   }
 };
 var scaleOption = {
   name: "Scale",
-  cliFlag: cliFlag35,
-  description: () => /* @__PURE__ */ jsxs25(Fragment31, {
+  cliFlag: cliFlag36,
+  description: () => /* @__PURE__ */ jsxs26(Fragment32, {
     children: [
       "Scales the output by a factor. For example, a 1280x720px frame will become a 1920x1080px frame with a scale factor of ",
-      /* @__PURE__ */ jsx31("code", {
+      /* @__PURE__ */ jsx32("code", {
         children: "1.5"
       }),
       ". Vector elements like fonts and HTML markups will be rendered with extra details."
@@ -2242,11 +2297,11 @@ var scaleOption = {
   docLink: "https://www.remotion.dev/docs/scaling",
   type: 0,
   getValue: ({ commandLine }) => {
-    if (commandLine[cliFlag35] !== undefined) {
-      validateScale(commandLine[cliFlag35]);
+    if (commandLine[cliFlag36] !== undefined) {
+      validateScale(commandLine[cliFlag36]);
       return {
         source: "cli",
-        value: commandLine[cliFlag35]
+        value: commandLine[cliFlag36]
       };
     }
     if (currentScale !== null) {
@@ -2267,16 +2322,16 @@ var scaleOption = {
 
 // src/options/throw-if-site-exists.tsx
 var DEFAULT5 = false;
-var cliFlag36 = "throw-if-site-exists";
+var cliFlag37 = "throw-if-site-exists";
 var throwIfSiteExistsOption = {
-  cliFlag: cliFlag36,
+  cliFlag: cliFlag37,
   description: () => `Prevents accidential update of an existing site. If there are any files in the subfolder where the site should be placed, the function will throw.`,
   docLink: "https://remotion.dev/docs/lambda/deploy-site",
   getValue: ({ commandLine }) => {
-    if (commandLine[cliFlag36]) {
+    if (commandLine[cliFlag37]) {
       return {
         source: "cli",
-        value: commandLine[cliFlag36]
+        value: commandLine[cliFlag37]
       };
     }
     return {
@@ -2293,35 +2348,35 @@ var throwIfSiteExistsOption = {
 };
 
 // src/options/timeout.tsx
-import { jsx as jsx32, jsxs as jsxs26, Fragment as Fragment32 } from "react/jsx-runtime";
+import { jsx as jsx33, jsxs as jsxs27, Fragment as Fragment33 } from "react/jsx-runtime";
 var currentTimeout = DEFAULT_TIMEOUT;
-var validate3 = (value2) => {
-  if (typeof value2 !== "number") {
-    throw new Error("--timeout flag / setDelayRenderTimeoutInMilliseconds() must be a number, but got " + JSON.stringify(value2));
+var validate3 = (value3) => {
+  if (typeof value3 !== "number") {
+    throw new Error("--timeout flag / setDelayRenderTimeoutInMilliseconds() must be a number, but got " + JSON.stringify(value3));
   }
 };
-var cliFlag37 = "timeout";
+var cliFlag38 = "timeout";
 var delayRenderTimeoutInMillisecondsOption = {
   name: "delayRender() timeout",
-  cliFlag: cliFlag37,
-  description: () => /* @__PURE__ */ jsxs26(Fragment32, {
+  cliFlag: cliFlag38,
+  description: () => /* @__PURE__ */ jsxs27(Fragment33, {
     children: [
       "A number describing how long the render may take to resolve all",
       " ",
-      /* @__PURE__ */ jsx32("a", {
+      /* @__PURE__ */ jsx33("a", {
         href: "https://remotion.dev/docs/delay-render",
-        children: /* @__PURE__ */ jsx32("code", {
+        children: /* @__PURE__ */ jsx33("code", {
           children: "delayRender()"
         })
       }),
       " ",
       "calls ",
-      /* @__PURE__ */ jsx32("a", {
+      /* @__PURE__ */ jsx33("a", {
         href: "https://remotion.dev/docs/timeout",
         children: "before it times out"
       }),
       ". Default: ",
-      /* @__PURE__ */ jsx32("code", {
+      /* @__PURE__ */ jsx33("code", {
         children: "30000"
       })
     ]
@@ -2330,10 +2385,10 @@ var delayRenderTimeoutInMillisecondsOption = {
   docLink: "https://www.remotion.dev/docs/timeout",
   type: 0,
   getValue: ({ commandLine }) => {
-    if (commandLine[cliFlag37] !== undefined) {
+    if (commandLine[cliFlag38] !== undefined) {
       return {
         source: "cli",
-        value: commandLine[cliFlag37]
+        value: commandLine[cliFlag38]
       };
     }
     if (currentTimeout !== null) {
@@ -2348,33 +2403,33 @@ var delayRenderTimeoutInMillisecondsOption = {
       value: DEFAULT_TIMEOUT
     };
   },
-  setConfig: (value2) => {
-    validate3(value2);
-    currentTimeout = value2;
+  setConfig: (value3) => {
+    validate3(value3);
+    currentTimeout = value3;
   }
 };
 
 // src/options/video-bitrate.tsx
-import { jsx as jsx33, jsxs as jsxs27, Fragment as Fragment33 } from "react/jsx-runtime";
+import { jsx as jsx34, jsxs as jsxs28, Fragment as Fragment34 } from "react/jsx-runtime";
 var videoBitrate = null;
-var cliFlag38 = "video-bitrate";
+var cliFlag39 = "video-bitrate";
 var videoBitrateOption = {
   name: "Video Bitrate",
-  cliFlag: cliFlag38,
-  description: () => /* @__PURE__ */ jsxs27(Fragment33, {
+  cliFlag: cliFlag39,
+  description: () => /* @__PURE__ */ jsxs28(Fragment34, {
     children: [
       "Specify the target bitrate for the generated video. The syntax for FFmpeg",
       "'",
       "s",
-      /* @__PURE__ */ jsx33("code", {
+      /* @__PURE__ */ jsx34("code", {
         children: "-b:v"
       }),
       " parameter should be used. FFmpeg may encode the video in a way that will not result in the exact video bitrate specified. Example values: ",
-      /* @__PURE__ */ jsx33("code", {
+      /* @__PURE__ */ jsx34("code", {
         children: "512K"
       }),
       " for 512 kbps, ",
-      /* @__PURE__ */ jsx33("code", {
+      /* @__PURE__ */ jsx34("code", {
         children: "1M"
       }),
       " for 1 Mbps."
@@ -2384,10 +2439,10 @@ var videoBitrateOption = {
   docLink: "https://www.remotion.dev/docs/renderer/render-media#videobitrate",
   type: "",
   getValue: ({ commandLine }) => {
-    if (commandLine[cliFlag38] !== undefined) {
+    if (commandLine[cliFlag39] !== undefined) {
       return {
         source: "cli",
-        value: commandLine[cliFlag38]
+        value: commandLine[cliFlag39]
       };
     }
     if (videoBitrate !== null) {
@@ -2522,7 +2577,7 @@ var getExtensionOfFilename = (filename) => {
 };
 
 // src/options/video-codec.tsx
-import { jsx as jsx34, Fragment as Fragment34 } from "react/jsx-runtime";
+import { jsx as jsx35, Fragment as Fragment35 } from "react/jsx-runtime";
 var codec;
 var setCodec = (newCodec) => {
   if (newCodec === undefined) {
@@ -2546,11 +2601,11 @@ var deriveCodecsFromFilename = (extension) => {
     possible: makeFileExtensionMap()[extension] ?? []
   };
 };
-var cliFlag39 = "codec";
+var cliFlag40 = "codec";
 var videoCodecOption = {
   name: "Codec",
-  cliFlag: cliFlag39,
-  description: () => /* @__PURE__ */ jsx34(Fragment34, {
+  cliFlag: cliFlag40,
+  description: () => /* @__PURE__ */ jsx35(Fragment35, {
     children: "H264 works well in most cases, but sometimes it's worth going for a different codec. WebM achieves higher compression but is slower to render. WebM, GIF and ProRes support transparency."
   }),
   ssrName: "codec",
@@ -2573,7 +2628,7 @@ var videoCodecOption = {
     if (derivedDownloadCodecs.possible.length > 0 && derivedOutNameCodecs.possible.length > 0 && derivedDownloadCodecs.possible.join("") !== derivedOutNameCodecs.possible.join("")) {
       throw new TypeError(`The download name is ${downloadName} but the output name is ${outName}. The file extensions must match`);
     }
-    const cliArgument = commandLine[cliFlag39];
+    const cliArgument = commandLine[cliFlag40];
     if (cliArgument) {
       if (derivedDownloadCodecs.possible.length > 0 && derivedDownloadCodecs.possible.indexOf(cliArgument) === -1) {
         throw new TypeError(`The download name is ${downloadName} but --codec=${cliArgument} was passed. The download name implies a codec of ${derivedDownloadCodecs.possible.join(" or ")} which does not align with the --codec flag.`);
@@ -2610,12 +2665,12 @@ var videoCodecOption = {
 };
 
 // src/options/webhook-custom-data.tsx
-import { jsxs as jsxs28, Fragment as Fragment35 } from "react/jsx-runtime";
-var cliFlag40 = "webhook-custom-data";
+import { jsxs as jsxs29, Fragment as Fragment36 } from "react/jsx-runtime";
+var cliFlag41 = "webhook-custom-data";
 var webhookCustomDataOption = {
   name: "Webhook custom data",
-  cliFlag: cliFlag40,
-  description: (type) => /* @__PURE__ */ jsxs28(Fragment35, {
+  cliFlag: cliFlag41,
+  description: (type) => /* @__PURE__ */ jsxs29(Fragment36, {
     children: [
       "Pass up to 1,024 bytes of a JSON-serializable object to the webhook. This data will be included in the webhook payload.",
       " ",
@@ -2634,7 +2689,7 @@ var webhookCustomDataOption = {
 };
 
 // src/options/x264-preset.tsx
-import { jsx as jsx35, jsxs as jsxs29, Fragment as Fragment36 } from "react/jsx-runtime";
+import { jsx as jsx36, jsxs as jsxs30, Fragment as Fragment37 } from "react/jsx-runtime";
 var x264PresetOptions = [
   "ultrafast",
   "superfast",
@@ -2648,63 +2703,63 @@ var x264PresetOptions = [
   "placebo"
 ];
 var preset = null;
-var cliFlag41 = "x264-preset";
+var cliFlag42 = "x264-preset";
 var DEFAULT_PRESET = "medium";
 var x264Option = {
   name: "x264 Preset",
-  cliFlag: cliFlag41,
-  description: () => /* @__PURE__ */ jsxs29(Fragment36, {
+  cliFlag: cliFlag42,
+  description: () => /* @__PURE__ */ jsxs30(Fragment37, {
     children: [
       "Sets a x264 preset profile. Only applies to videos rendered with",
       " ",
-      /* @__PURE__ */ jsx35("code", {
+      /* @__PURE__ */ jsx36("code", {
         children: "h264"
       }),
       " codec.",
-      /* @__PURE__ */ jsx35("br", {}),
+      /* @__PURE__ */ jsx36("br", {}),
       "Possible values: ",
-      /* @__PURE__ */ jsx35("code", {
+      /* @__PURE__ */ jsx36("code", {
         children: "superfast"
       }),
       ", ",
-      /* @__PURE__ */ jsx35("code", {
+      /* @__PURE__ */ jsx36("code", {
         children: "veryfast"
       }),
       ",",
       " ",
-      /* @__PURE__ */ jsx35("code", {
+      /* @__PURE__ */ jsx36("code", {
         children: "faster"
       }),
       ", ",
-      /* @__PURE__ */ jsx35("code", {
+      /* @__PURE__ */ jsx36("code", {
         children: "fast"
       }),
       ", ",
-      /* @__PURE__ */ jsx35("code", {
+      /* @__PURE__ */ jsx36("code", {
         children: "medium"
       }),
       ",",
       " ",
-      /* @__PURE__ */ jsx35("code", {
+      /* @__PURE__ */ jsx36("code", {
         children: "slow"
       }),
       ", ",
-      /* @__PURE__ */ jsx35("code", {
+      /* @__PURE__ */ jsx36("code", {
         children: "slower"
       }),
       ", ",
-      /* @__PURE__ */ jsx35("code", {
+      /* @__PURE__ */ jsx36("code", {
         children: "veryslow"
       }),
       ",",
       " ",
-      /* @__PURE__ */ jsx35("code", {
+      /* @__PURE__ */ jsx36("code", {
         children: "placebo"
       }),
       ".",
-      /* @__PURE__ */ jsx35("br", {}),
+      /* @__PURE__ */ jsx36("br", {}),
       "Default: ",
-      /* @__PURE__ */ jsx35("code", {
+      /* @__PURE__ */ jsx36("code", {
         children: DEFAULT_PRESET
       })
     ]
@@ -2713,9 +2768,9 @@ var x264Option = {
   docLink: "https://www.remotion.dev/docs/renderer/render-media",
   type: "fast",
   getValue: ({ commandLine }) => {
-    const value2 = commandLine[cliFlag41];
-    if (typeof value2 !== "undefined") {
-      return { value: value2, source: "cli" };
+    const value3 = commandLine[cliFlag42];
+    if (typeof value3 !== "undefined") {
+      return { value: value3, source: "cli" };
     }
     if (preset !== null) {
       return { value: preset, source: "config" };
@@ -2769,7 +2824,8 @@ var allOptions = {
   metadataOption,
   hardwareAccelerationOption,
   chromeModeOption,
-  apiKeyOption
+  apiKeyOption,
+  audioLatencyHintOption
 };
 
 // src/options/options-map.ts

package/dist/options/index.d.ts

@@ -661,6 +661,24 @@ export declare const allOptions: {
         };
         setConfig: (value: string | null) => void;
     };
+    audioLatencyHintOption: {
+        name: string;
+        cliFlag: "audio-latency-hint";
+        description: () => import("react/jsx-runtime").JSX.Element;
+        ssrName: "audioLatencyHint";
+        docLink: string;
+        type: AudioContextLatencyCategory;
+        getValue: ({ commandLine }: {
+            commandLine: Record<string, unknown>;
+        }) => {
+            value: AudioContextLatencyCategory;
+            source: string;
+        } | {
+            value: null;
+            source: string;
+        };
+        setConfig: (profile: AudioContextLatencyCategory | null) => void;
+    };
 };
 export type AvailableOptions = keyof typeof allOptions;
 export type TypeOfOption<Type> = Type extends AnyRemotionOption<infer X> ? X : never;

package/dist/options/index.js

@@ -22,6 +22,7 @@ const gl_1 = require("./gl");
 const hardware_acceleration_1 = require("./hardware-acceleration");
 const headless_1 = require("./headless");
 const jpeg_quality_1 = require("./jpeg-quality");
+const latency_hint_1 = require("./latency-hint");
 const log_level_1 = require("./log-level");
 const metadata_1 = require("./metadata");
 const mute_1 = require("./mute");
@@ -84,4 +85,5 @@ exports.allOptions = {
     hardwareAccelerationOption: hardware_acceleration_1.hardwareAccelerationOption,
     chromeModeOption: chrome_mode_1.chromeModeOption,
     apiKeyOption: api_key_1.apiKeyOption,
+    audioLatencyHintOption: latency_hint_1.audioLatencyHintOption,
 };

package/dist/options/latency-hint.d.ts

@@ -0,0 +1,18 @@
+export declare const audioLatencyHintOption: {
+    name: string;
+    cliFlag: "audio-latency-hint";
+    description: () => import("react/jsx-runtime").JSX.Element;
+    ssrName: "audioLatencyHint";
+    docLink: string;
+    type: AudioContextLatencyCategory;
+    getValue: ({ commandLine }: {
+        commandLine: Record<string, unknown>;
+    }) => {
+        value: AudioContextLatencyCategory;
+        source: string;
+    } | {
+        value: null;
+        source: string;
+    };
+    setConfig: (profile: AudioContextLatencyCategory | null) => void;
+};

package/dist/options/latency-hint.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.audioLatencyHintOption = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const cliFlag = 'audio-latency-hint';
+let value = null;
+exports.audioLatencyHintOption = {
+    name: 'Audio Latency Hint',
+    cliFlag,
+    description: () => ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["Sets the", ' ', (0, jsx_runtime_1.jsx)("a", { href: "https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/AudioContext", children: "audio latency" }), ' ', "hint for the global ", (0, jsx_runtime_1.jsx)("code", { children: "AudioContext" }), " context that Remotion uses to play audio.", (0, jsx_runtime_1.jsx)("br", {}), "Possible values: ", (0, jsx_runtime_1.jsx)("code", { children: "interactive" }), ", ", (0, jsx_runtime_1.jsx)("code", { children: "balanced" }), ",", ' ', (0, jsx_runtime_1.jsx)("code", { children: "playback" })] })),
+    ssrName: 'audioLatencyHint',
+    docLink: 'https://www.remotion.dev/docs/renderer/render-media',
+    type: 'interactive',
+    getValue: ({ commandLine }) => {
+        const val = commandLine[cliFlag];
+        if (typeof val !== 'undefined') {
+            return { value: val, source: 'cli' };
+        }
+        if (value !== null) {
+            return { value, source: 'config' };
+        }
+        return { value: null, source: 'default' };
+    },
+    setConfig: (profile) => {
+        value = profile;
+    },
+};

package/package.json

@@ -3,7 +3,7 @@
     "url": "https://github.com/remotion-dev/remotion/tree/main/packages/renderer"
   },
   "name": "@remotion/renderer",
-  "version": "4.0.301",
+  "version": "4.0.303",
   "description": "Render Remotion videos using Node.js or Bun",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,8 +18,8 @@
     "extract-zip": "2.0.1",
     "source-map": "^0.8.0-beta.0",
     "ws": "8.17.1",
-    "@remotion/streaming": "4.0.301",
-    "remotion": "4.0.301"
+    "remotion": "4.0.303",
+    "@remotion/streaming": "4.0.303"
   },
   "peerDependencies": {
     "react": ">=16.8.0",
@@ -33,17 +33,17 @@
     "react-dom": "19.0.0",
     "@types/ws": "8.5.10",
     "eslint": "9.19.0",
-    "@remotion/example-videos": "4.0.301",
-    "@remotion/eslint-config-internal": "4.0.301"
+    "@remotion/eslint-config-internal": "4.0.303",
+    "@remotion/example-videos": "4.0.303"
   },
   "optionalDependencies": {
-    "@remotion/compositor-darwin-arm64": "4.0.301",
-    "@remotion/compositor-darwin-x64": "4.0.301",
-    "@remotion/compositor-linux-arm64-musl": "4.0.301",
-    "@remotion/compositor-linux-arm64-gnu": "4.0.301",
-    "@remotion/compositor-linux-x64-gnu": "4.0.301",
-    "@remotion/compositor-win32-x64-msvc": "4.0.301",
-    "@remotion/compositor-linux-x64-musl": "4.0.301"
+    "@remotion/compositor-darwin-arm64": "4.0.303",
+    "@remotion/compositor-linux-arm64-gnu": "4.0.303",
+    "@remotion/compositor-darwin-x64": "4.0.303",
+    "@remotion/compositor-linux-arm64-musl": "4.0.303",
+    "@remotion/compositor-linux-x64-gnu": "4.0.303",
+    "@remotion/compositor-win32-x64-msvc": "4.0.303",
+    "@remotion/compositor-linux-x64-musl": "4.0.303"
   },
   "keywords": [
     "remotion",