@remotion/renderer 4.0.501 → 4.0.502

package/dist/esm/client.mjs

@@ -1914,6 +1914,45 @@ var forceNewStudioOption = {
 };
 
 // src/frame-range.ts
+var isMultipleFrameRanges = (frameRange) => {
+  return Array.isArray(frameRange) && Array.isArray(frameRange[0]);
+};
+var validateFrameRangeTuple = (frameRange) => {
+  if (frameRange.length !== 2) {
+    throw new TypeError("Frame range must be a tuple, got an array with length " + frameRange.length);
+  }
+  const [first, second] = frameRange;
+  if (typeof first !== "number") {
+    throw new Error(`The first value of frame range must be a number, but got ${typeof first} (${JSON.stringify(first)})`);
+  }
+  if (!Number.isFinite(first)) {
+    throw new TypeError("The first value of frame range must be finite, but got " + first);
+  }
+  if (!Number.isInteger(first)) {
+    throw new Error(`The first value of frame range must be an integer, but got a float (${first})`);
+  }
+  if (first < 0) {
+    throw new Error(`The first value of frame range must be non-negative, but got ${first}`);
+  }
+  if (second === null) {
+    return;
+  }
+  if (typeof second !== "number") {
+    throw new Error(`The second value of frame range must be a number or null, but got ${typeof second} (${JSON.stringify(second)})`);
+  }
+  if (!Number.isFinite(second)) {
+    throw new TypeError("The second value of frame range must be finite, but got " + second);
+  }
+  if (!Number.isInteger(second)) {
+    throw new Error(`The second value of frame range must be an integer, but got a float (${second})`);
+  }
+  if (second < 0) {
+    throw new Error(`The second value of frame range must be non-negative, but got ${second}`);
+  }
+  if (second < first) {
+    throw new Error("The second value of frame range must be not smaller than the first one, but got " + frameRange.join("-"));
+  }
+};
 var validateFrameRange = (frameRange) => {
   if (frameRange === null) {
     return;
@@ -1930,50 +1969,69 @@ var validateFrameRange = (frameRange) => {
     }
     return;
   }
-  if (Array.isArray(frameRange)) {
-    if (frameRange.length !== 2) {
-      throw new TypeError("Frame range must be a tuple, got an array with length " + frameRange.length);
-    }
-    const [first, second] = frameRange;
-    if (typeof first !== "number") {
-      throw new Error(`The first value of frame range must be a number, but got ${typeof first} (${JSON.stringify(first)})`);
-    }
-    if (!Number.isFinite(first)) {
-      throw new TypeError("The first value of frame range must be finite, but got " + first);
-    }
-    if (!Number.isInteger(first)) {
-      throw new Error(`The first value of frame range must be an integer, but got a float (${first})`);
-    }
-    if (first < 0) {
-      throw new Error(`The first value of frame range must be non-negative, but got ${first}`);
-    }
-    if (second === null) {
-      return;
+  if (isMultipleFrameRanges(frameRange)) {
+    if (frameRange.length === 0) {
+      throw new TypeError("Multiple frame ranges must not be empty.");
+    }
+    for (let index = 0;index < frameRange.length; index++) {
+      const range = frameRange[index];
+      validateFrameRangeTuple(range);
+      if (range[1] === null && index !== frameRange.length - 1) {
+        throw new Error("An open-ended frame range must be the last range.");
+      }
+      const previous = frameRange[index - 1];
+      if (previous && previous[1] !== null && range[0] <= previous[1]) {
+        throw new Error(`Frame ranges must be ordered and non-overlapping, but got ${previous.join("-")} followed by ${range.join("-")}.`);
+      }
     }
-    if (typeof second !== "number") {
-      throw new Error(`The second value of frame range must be a number or null, but got ${typeof second} (${JSON.stringify(second)})`);
+    return;
+  }
+  if (Array.isArray(frameRange)) {
+    validateFrameRangeTuple(frameRange);
+    return;
+  }
+  throw new TypeError("Frame range must be a number or a tuple of numbers, but got object of type " + typeof frameRange);
+};
+
+// src/validate-selected-frames.ts
+var validateSelectedFrames = ({
+  frames,
+  durationInFrames
+}) => {
+  if (!Array.isArray(frames)) {
+    throw new TypeError("The `frames` option must be an array of frame numbers.");
+  }
+  if (frames.length === 0) {
+    throw new TypeError("The `frames` option must contain at least one frame.");
+  }
+  for (const frame of frames) {
+    if (typeof frame !== "number") {
+      throw new TypeError(`The \`frames\` option must contain only numbers, but got ${typeof frame}.`);
     }
-    if (!Number.isFinite(second)) {
-      throw new TypeError("The second value of frame range must be finite, but got " + second);
+    if (!Number.isFinite(frame)) {
+      throw new TypeError(`The \`frames\` option must contain only finite numbers, but got ${frame}.`);
     }
-    if (!Number.isInteger(second)) {
-      throw new Error(`The second value of frame range must be an integer, but got a float (${second})`);
+    if (!Number.isInteger(frame)) {
+      throw new TypeError(`The \`frames\` option must contain only integers, but got ${frame}.`);
     }
-    if (second < 0) {
-      throw new Error(`The second value of frame range must be non-negative, but got ${second}`);
+    if (frame < 0) {
+      throw new TypeError(`The \`frames\` option must contain only non-negative numbers, but got ${frame}.`);
     }
-    if (second < first) {
-      throw new Error("The second value of frame range must be not smaller than the first one, but got " + frameRange.join("-"));
+    if (durationInFrames !== null && frame >= durationInFrames) {
+      throw new RangeError(`Frame ${frame} is out of range, must be between 0 and ${durationInFrames - 1}.`);
     }
-    return;
   }
-  throw new TypeError("Frame range must be a number or a tuple of numbers, but got object of type " + typeof frameRange);
+  const uniqueFrames = new Set(frames);
+  if (uniqueFrames.size !== frames.length) {
+    throw new TypeError("The `frames` option must not contain duplicate frames.");
+  }
+  return [...frames].sort((a, b) => a - b);
 };
 
 // src/options/frames.tsx
 import { jsx as jsx30, jsxs as jsxs21, Fragment as Fragment30 } from "react/jsx-runtime";
 var cliFlag33 = "frames";
-var frameRange = null;
+var frameSelection = null;
 var parseFrameRangeFromCli = (newFrameRange) => {
   if (typeof newFrameRange === "number") {
     if (newFrameRange < 0) {
@@ -1985,6 +2043,35 @@ var parseFrameRangeFromCli = (newFrameRange) => {
     if (newFrameRange.trim() === "") {
       throw new Error("--frames flag must be a single number, or 2 numbers separated by `-`");
     }
+    if (newFrameRange.includes(",")) {
+      const selectors = newFrameRange.split(",").map((selector) => selector.trim());
+      if (selectors.some((selector) => selector === "")) {
+        throw new TypeError("--frames must contain a frame or frame range between commas.");
+      }
+      const onlyFrames = selectors.every((selector) => !selector.includes("-"));
+      if (onlyFrames) {
+        const frames = validateSelectedFrames({
+          frames: selectors.map((frame) => Number(frame)),
+          durationInFrames: null
+        });
+        return { type: "frames", frames };
+      }
+      const ranges = selectors.map((selector) => {
+        if (!selector.includes("-")) {
+          const frame = Number(selector);
+          return [frame, frame];
+        }
+        const rangeParts = selector.split("-");
+        if (rangeParts.length !== 2 || rangeParts[0] === "") {
+          throw new Error(`Invalid frame selector "${selector}". Use a frame number, a range such as 0-9, or an open-ended range such as 100-.`);
+        }
+        const start = Number(rangeParts[0]);
+        const end = rangeParts[1] === "" ? null : Number(rangeParts[1]);
+        return [start, end];
+      });
+      validateFrameRange(ranges);
+      return ranges;
+    }
     const parts = newFrameRange.split("-");
     if (parts.length > 2 || parts.length <= 0) {
       throw new Error(`--frames flag must be a number or 2 numbers separated by '-', instead got ${parts.length} numbers`);
@@ -1992,7 +2079,7 @@ var parseFrameRangeFromCli = (newFrameRange) => {
     if (parts.length === 1) {
       const value = Number(parts[0]);
       if (isNaN(value)) {
-        throw new Error("--frames flag must be a single number, or 2 numbers separated by `-`");
+        throw new Error("--frames flag must be a frame number, range, or comma-separated selection");
       }
       return value;
     }
@@ -2000,7 +2087,7 @@ var parseFrameRangeFromCli = (newFrameRange) => {
     if (secondPart === "" && firstPart !== "") {
       const start = Number(firstPart);
       if (isNaN(start)) {
-        throw new Error("--frames flag must be a single number, or 2 numbers separated by `-`");
+        throw new Error("--frames flag must be a frame number, range, or comma-separated selection");
       }
       return [start, null];
     }
@@ -2008,7 +2095,7 @@ var parseFrameRangeFromCli = (newFrameRange) => {
     const [first, second] = parsed;
     for (const value of parsed) {
       if (isNaN(value)) {
-        throw new Error("--frames flag must be a single number, or 2 numbers separated by `-`");
+        throw new Error("--frames flag must be a frame number, range, or comma-separated selection");
       }
     }
     if (second < first) {
@@ -2041,7 +2128,14 @@ var framesOption = {
   getValue: ({ commandLine }) => {
     if (commandLine[cliFlag33] !== undefined) {
       const value = parseFrameRangeFromCli(commandLine[cliFlag33]);
-      validateFrameRange(value);
+      if (typeof value === "object" && !Array.isArray(value)) {
+        validateSelectedFrames({
+          frames: value.frames,
+          durationInFrames: null
+        });
+      } else {
+        validateFrameRange(value);
+      }
       return {
         source: "cli",
         value
@@ -2049,14 +2143,16 @@ var framesOption = {
     }
     return {
       source: "config",
-      value: frameRange
+      value: frameSelection
     };
   },
   setConfig: (value) => {
-    if (value !== null) {
+    if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+      validateSelectedFrames({ frames: value.frames, durationInFrames: null });
+    } else if (value !== null) {
       validateFrameRange(value);
     }
-    frameRange = value;
+    frameSelection = value;
   },
   id: cliFlag33
 };
@@ -4114,9 +4210,9 @@ var reproOption = {
 // src/options/rspack.tsx
 import { jsx as jsx70, Fragment as Fragment70 } from "react/jsx-runtime";
 var rspackEnabled = false;
-var cliFlag74 = "experimental-rspack";
+var cliFlag74 = "rspack";
 var rspackOption = {
-  name: "Experimental Rspack",
+  name: "Rspack",
   cliFlag: cliFlag74,
   description: () => /* @__PURE__ */ jsx70(Fragment70, {
     children: "Uses Rspack instead of Webpack as the bundler for the Studio or bundle."
@@ -4125,8 +4221,7 @@ var rspackOption = {
   docLink: null,
   type: false,
   getValue: ({ commandLine }) => {
-    if (commandLine[cliFlag74] !== undefined) {
-      rspackEnabled = true;
+    if (commandLine[cliFlag74] !== undefined && commandLine[cliFlag74] !== null) {
       return {
         value: commandLine[cliFlag74],
         source: "cli"