@remotion/renderer 4.0.501 → 4.0.503

package/dist/esm/pure.mjs

@@ -63,11 +63,12 @@ var getFramesToRender = (frameRange, everyNthFrame) => {
   if (everyNthFrame === 0) {
     throw new Error("everyNthFrame cannot be 0");
   }
-  return new Array(frameRange[1] - frameRange[0] + 1).fill(true).map((_, index) => {
-    return index + frameRange[0];
+  const ranges = Array.isArray(frameRange[0]) ? frameRange : [frameRange];
+  return ranges.flatMap((range) => new Array(range[1] - range[0] + 1).fill(true).map((_, index) => {
+    return index + range[0];
   }).filter((frame) => {
-    return (frame - frameRange[0]) % everyNthFrame === 0;
-  });
+    return (frame - range[0]) % everyNthFrame === 0;
+  }));
 };
 
 // src/codec.ts

package/dist/frame-range.d.ts

@@ -1,2 +1,11 @@
-export type FrameRange = number | [number, number] | [number, null];
+export type ResolvedFrameRange = [number, number];
+export type OpenEndedFrameRange = [number, null];
+export type FrameRangeTuple = ResolvedFrameRange | OpenEndedFrameRange;
+export type SingleFrameRange = number | FrameRangeTuple;
+export type FrameRange = SingleFrameRange | FrameRangeTuple[];
+export type FrameSelection = FrameRange | {
+    type: 'frames';
+    frames: number[];
+} | null;
+export declare const isMultipleFrameRanges: (frameRange: FrameRange) => frameRange is FrameRangeTuple[];
 export declare const validateFrameRange: (frameRange: FrameRange | null) => void;

package/dist/frame-range.js

@@ -1,6 +1,48 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateFrameRange = void 0;
+exports.validateFrameRange = exports.isMultipleFrameRanges = void 0;
+const isMultipleFrameRanges = (frameRange) => {
+    return Array.isArray(frameRange) && Array.isArray(frameRange[0]);
+};
+exports.isMultipleFrameRanges = isMultipleFrameRanges;
+const 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('-'));
+    }
+};
 const validateFrameRange = (frameRange) => {
     if (frameRange === null) {
         return;
@@ -17,45 +59,27 @@ const 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 (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 ((0, exports.isMultipleFrameRanges)(frameRange)) {
+        if (frameRange.length === 0) {
+            throw new TypeError('Multiple frame ranges must not be empty.');
         }
-        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('-'));
+        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('-')}.`);
+            }
         }
         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);
 };

package/dist/get-duration-from-frame-range.d.ts

@@ -1 +1,2 @@
-export declare const getFramesToRender: (frameRange: [number, number], everyNthFrame: number) => number[];
+import type { ResolvedFrameRange } from './frame-range';
+export declare const getFramesToRender: (frameRange: ResolvedFrameRange[] | ResolvedFrameRange, everyNthFrame: number) => number[];

package/dist/get-duration-from-frame-range.js

@@ -5,13 +5,16 @@ const getFramesToRender = (frameRange, everyNthFrame) => {
     if (everyNthFrame === 0) {
         throw new Error('everyNthFrame cannot be 0');
     }
-    return new Array(frameRange[1] - frameRange[0] + 1)
+    const ranges = Array.isArray(frameRange[0])
+        ? frameRange
+        : [frameRange];
+    return ranges.flatMap((range) => new Array(range[1] - range[0] + 1)
         .fill(true)
         .map((_, index) => {
-        return index + frameRange[0];
+        return index + range[0];
     })
         .filter((frame) => {
-        return (frame - frameRange[0]) % everyNthFrame === 0;
-    });
+        return (frame - range[0]) % everyNthFrame === 0;
+    }));
 };
 exports.getFramesToRender = getFramesToRender;

package/dist/get-frame-to-render.d.ts

@@ -1,2 +1,3 @@
-import type { FrameRange } from './frame-range';
+import { type FrameRange, type ResolvedFrameRange } from './frame-range';
+export declare const getRealFrameRanges: (durationInFrames: number, frameRange: FrameRange | null) => ResolvedFrameRange[];
 export declare const getRealFrameRange: (durationInFrames: number, frameRange: FrameRange | null) => [number, number];

package/dist/get-frame-to-render.js

@@ -1,10 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRealFrameRange = void 0;
-const getRealFrameRange = (durationInFrames, frameRange) => {
-    if (frameRange === null) {
-        return [0, durationInFrames - 1];
-    }
+exports.getRealFrameRange = exports.getRealFrameRanges = void 0;
+const frame_range_1 = require("./frame-range");
+const resolveFrameRange = (durationInFrames, frameRange) => {
     if (typeof frameRange === 'number') {
         if (frameRange < 0 || frameRange >= durationInFrames) {
             throw new Error(`Frame number is out of range, must be between 0 and ${durationInFrames - 1} but got ${frameRange}`);
@@ -22,4 +20,22 @@ const getRealFrameRange = (durationInFrames, frameRange) => {
     }
     return resolved;
 };
+const getRealFrameRanges = (durationInFrames, frameRange) => {
+    if (frameRange === null) {
+        return [[0, durationInFrames - 1]];
+    }
+    (0, frame_range_1.validateFrameRange)(frameRange);
+    if ((0, frame_range_1.isMultipleFrameRanges)(frameRange)) {
+        return frameRange.map((range) => resolveFrameRange(durationInFrames, range));
+    }
+    return [resolveFrameRange(durationInFrames, frameRange)];
+};
+exports.getRealFrameRanges = getRealFrameRanges;
+const getRealFrameRange = (durationInFrames, frameRange) => {
+    const ranges = (0, exports.getRealFrameRanges)(durationInFrames, frameRange);
+    if (ranges.length !== 1) {
+        throw new Error('Expected a single frame range, but received multiple frame ranges.');
+    }
+    return ranges[0];
+};
 exports.getRealFrameRange = getRealFrameRange;

package/dist/index.d.ts

@@ -18,7 +18,7 @@ export { ErrorWithStackFrame } from './error-handling/handle-javascript-exceptio
 export { extractAudio } from './extract-audio';
 export type { FfmpegOverrideFn } from './ffmpeg-override';
 export { FileExtension } from './file-extensions';
-export { FrameRange } from './frame-range';
+export { FrameRange, FrameRangeTuple, FrameSelection, OpenEndedFrameRange, ResolvedFrameRange, SingleFrameRange, } from './frame-range';
 export { GetCompositionsOptions, getCompositions, LegacyGetCompositionsOptions, } from './get-compositions';
 export { SilentPart, getSilentParts } from './get-silent-parts';
 export { VideoMetadata, getVideoMetadata } from './get-video-metadata';
@@ -31,6 +31,8 @@ export type { ChromiumOptions } from './open-browser';
 export { ChromeMode } from './options/chrome-mode';
 export { ColorSpace } from './options/color-space';
 export type { Concurrency } from './options/concurrency';
+export { customEditorColumnNumberPlaceholder, customEditorLineNumberPlaceholder, customEditorTargetPathPlaceholder, defaultEditorIds, } from './options/default-editor';
+export type { BuiltInEditor, CustomEditor, DefaultEditor, } from './options/default-editor';
 export type { DeleteAfter } from './options/delete-after';
 export { OpenGlRenderer } from './options/gl';
 export { NumberOfGifLoops } from './options/number-of-gif-loops';
@@ -86,6 +88,7 @@ export declare const RenderInternals: {
     isServeUrl: (potentialUrl: string) => boolean;
     ensureOutputDirectory: (outputLocation: string) => void;
     getRealFrameRange: (durationInFrames: number, frameRange: import("./frame-range").FrameRange | null) => [number, number];
+    getRealFrameRanges: (durationInFrames: number, frameRange: import("./frame-range").FrameRange | null) => import("./frame-range").ResolvedFrameRange[];
     validatePuppeteerTimeout: (timeoutInMilliseconds: unknown) => void;
     downloadFile: (options: {
         url: string;
@@ -108,7 +111,7 @@ export declare const RenderInternals: {
     formatStackFrameCodeFrame: (frame: import("./symbolicate-stacktrace").SymbolicatedStackFrame) => string | null;
     formatStackFrameLocationLine: (frame: import("./symbolicate-stacktrace").SymbolicatedStackFrame) => string | null;
     SymbolicateableError: typeof SymbolicateableError;
-    getFramesToRender: (frameRange: [number, number], everyNthFrame: number) => number[];
+    getFramesToRender: (frameRange: import("./frame-range").ResolvedFrameRange[] | import("./frame-range").ResolvedFrameRange, everyNthFrame: number) => number[];
     getExtensionOfFilename: (filename: string | null) => string | null;
     getDesiredPort: ({ desiredPort, from, hostsToTry, to, onPortUnavailable, }: {
         desiredPort: number | undefined;
@@ -157,6 +160,10 @@ export declare const RenderInternals: {
     validPixelFormats: readonly ["yuv420p", "yuva420p", "yuv422p", "yuv444p", "yuv420p10le", "yuv422p10le", "yuv444p10le", "yuva444p10le"];
     DEFAULT_BROWSER: "chrome";
     validateFrameRange: (frameRange: import("./frame-range").FrameRange | null) => void;
+    validateSelectedFrames: ({ frames, durationInFrames, }: {
+        frames: unknown;
+        durationInFrames: number | null;
+    }) => number[];
     DEFAULT_OPENGL_RENDERER: "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan" | null;
     validateOpenGlRenderer: (option: unknown) => "angle" | "angle-egl" | "egl" | "swangle" | "swiftshader" | "vulkan" | null;
     validCodecs: readonly ["h264", "h265", "vp8", "vp9", "av1", "mp3", "aac", "wav", "prores", "h264-mkv", "h264-ts", "gif"];
@@ -1033,6 +1040,8 @@ export declare const RenderInternals: {
         imageFormat: "jpeg" | "none" | "png";
         jpegQuality: number;
         frameRange: import("./frame-range").FrameRange | null;
+        frames: number[] | null;
+        outputFramesInSequence: boolean;
         everyNthFrame: number;
         puppeteerInstance: HeadlessBrowser | undefined;
         browserExecutable: import("./browser-executable").BrowserExecutable;
@@ -1372,7 +1381,7 @@ export declare const RenderInternals: {
         audioCodec: "aac" | "mp3" | "opus" | "pcm-16" | null;
         cancelSignal: import("./make-cancel-signal").CancelSignal | undefined;
         metadata: Record<string, string> | null;
-        frameRange: import("./frame-range").FrameRange | null;
+        frameRange: import("./frame-range").SingleFrameRange | null;
         everyNthFrame: number;
         sampleRate: number;
     } & {

package/dist/index.js

@@ -36,7 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RenderInternals = exports.validateOutputFilename = exports.stitchFramesToVideo = exports.selectComposition = exports.renderStill = exports.renderMedia = exports.renderFrames = exports.openBrowser = exports.makeCancelSignal = exports.validateSelectedPixelFormatAndImageFormatCombination = exports.getVideoMetadata = exports.getSilentParts = exports.getCompositions = exports.extractAudio = exports.ErrorWithStackFrame = exports.ensureBrowser = exports.combineChunks = void 0;
+exports.RenderInternals = exports.validateOutputFilename = exports.stitchFramesToVideo = exports.selectComposition = exports.renderStill = exports.renderMedia = exports.renderFrames = exports.defaultEditorIds = exports.customEditorTargetPathPlaceholder = exports.customEditorLineNumberPlaceholder = exports.customEditorColumnNumberPlaceholder = exports.openBrowser = exports.makeCancelSignal = exports.validateSelectedPixelFormatAndImageFormatCombination = exports.getVideoMetadata = exports.getSilentParts = exports.getCompositions = exports.extractAudio = exports.ErrorWithStackFrame = exports.ensureBrowser = exports.combineChunks = void 0;
 const execa_1 = __importDefault(require("execa"));
 const download_file_1 = require("./assets/download-file");
 const browser_1 = require("./browser");
@@ -88,6 +88,7 @@ const test_gpu_1 = require("./test-gpu");
 const tmp_dir_1 = require("./tmp-dir");
 const validate_concurrency_1 = require("./validate-concurrency");
 const validate_even_dimensions_with_codec_1 = require("./validate-even-dimensions-with-codec");
+const validate_selected_frames_1 = require("./validate-selected-frames");
 const combine_chunks_1 = require("./combine-chunks");
 Object.defineProperty(exports, "combineChunks", { enumerable: true, get: function () { return combine_chunks_1.combineChunks; } });
 const ensure_browser_1 = require("./ensure-browser");
@@ -108,6 +109,11 @@ const make_cancel_signal_1 = require("./make-cancel-signal");
 Object.defineProperty(exports, "makeCancelSignal", { enumerable: true, get: function () { return make_cancel_signal_1.makeCancelSignal; } });
 const open_browser_2 = require("./open-browser");
 Object.defineProperty(exports, "openBrowser", { enumerable: true, get: function () { return open_browser_2.openBrowser; } });
+const default_editor_1 = require("./options/default-editor");
+Object.defineProperty(exports, "customEditorColumnNumberPlaceholder", { enumerable: true, get: function () { return default_editor_1.customEditorColumnNumberPlaceholder; } });
+Object.defineProperty(exports, "customEditorLineNumberPlaceholder", { enumerable: true, get: function () { return default_editor_1.customEditorLineNumberPlaceholder; } });
+Object.defineProperty(exports, "customEditorTargetPathPlaceholder", { enumerable: true, get: function () { return default_editor_1.customEditorTargetPathPlaceholder; } });
+Object.defineProperty(exports, "defaultEditorIds", { enumerable: true, get: function () { return default_editor_1.defaultEditorIds; } });
 const render_frames_2 = require("./render-frames");
 Object.defineProperty(exports, "renderFrames", { enumerable: true, get: function () { return render_frames_2.renderFrames; } });
 const render_media_2 = require("./render-media");
@@ -145,6 +151,7 @@ exports.RenderInternals = {
     isServeUrl: is_serve_url_1.isServeUrl,
     ensureOutputDirectory: ensure_output_directory_1.ensureOutputDirectory,
     getRealFrameRange: get_frame_to_render_1.getRealFrameRange,
+    getRealFrameRanges: get_frame_to_render_1.getRealFrameRanges,
     validatePuppeteerTimeout: validate_puppeteer_timeout_1.validatePuppeteerTimeout,
     downloadFile: download_file_1.downloadFile,
     parseStack: parse_browser_error_stack_1.parseStack,
@@ -167,6 +174,7 @@ exports.RenderInternals = {
     validPixelFormats: pixel_format_1.validPixelFormats,
     DEFAULT_BROWSER: browser_1.DEFAULT_BROWSER,
     validateFrameRange: frame_range_1.validateFrameRange,
+    validateSelectedFrames: validate_selected_frames_1.validateSelectedFrames,
     DEFAULT_OPENGL_RENDERER: gl_1.DEFAULT_OPENGL_RENDERER,
     validateOpenGlRenderer: gl_1.validateOpenGlRenderer,
     validCodecs: codec_1.validCodecs,

package/dist/options/default-editor.d.ts

@@ -0,0 +1,28 @@
+export declare const defaultEditorIds: readonly ["vscode", "cursor", "windsurf", "zed", "vscodium", "webstorm", "sublime-text"];
+export declare const customEditorTargetPathPlaceholder: "%TARGET_PATH%";
+export declare const customEditorLineNumberPlaceholder: "%LINE_NUMBER%";
+export declare const customEditorColumnNumberPlaceholder: "%COLUMN_NUMBER%";
+export type BuiltInEditor = (typeof defaultEditorIds)[number];
+export type CustomEditor = {
+    readonly type: 'custom';
+    readonly name: string;
+    readonly executable: string;
+    readonly arguments: readonly string[];
+};
+export type DefaultEditor = BuiltInEditor | CustomEditor;
+export declare const defaultEditorOption: {
+    name: string;
+    cliFlag: "editor";
+    description: () => import("react/jsx-runtime").JSX.Element;
+    ssrName: null;
+    docLink: string;
+    type: DefaultEditor | null;
+    getValue: ({ commandLine }: {
+        commandLine: Record<string, unknown>;
+    }) => {
+        value: DefaultEditor | null;
+        source: string;
+    };
+    setConfig(value: DefaultEditor | null): void;
+    id: "editor";
+};

package/dist/options/default-editor.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultEditorOption = exports.customEditorColumnNumberPlaceholder = exports.customEditorLineNumberPlaceholder = exports.customEditorTargetPathPlaceholder = exports.defaultEditorIds = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+exports.defaultEditorIds = [
+    'vscode',
+    'cursor',
+    'windsurf',
+    'zed',
+    'vscodium',
+    'webstorm',
+    'sublime-text',
+];
+exports.customEditorTargetPathPlaceholder = '%TARGET_PATH%';
+exports.customEditorLineNumberPlaceholder = '%LINE_NUMBER%';
+exports.customEditorColumnNumberPlaceholder = '%COLUMN_NUMBER%';
+const cliFlag = 'editor';
+let defaultEditor = null;
+const validateBuiltInEditor = (value, source) => {
+    if (typeof value !== 'string' ||
+        !exports.defaultEditorIds.includes(value)) {
+        throw new TypeError(`${source} must be one of: ${exports.defaultEditorIds.join(', ')}. Received: ${JSON.stringify(value)}`);
+    }
+    return value;
+};
+const validateCustomEditor = (value, source) => {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new TypeError(`${source} must be a built-in editor ID or a custom editor object. Received: ${JSON.stringify(value)}`);
+    }
+    const editor = value;
+    if (editor.type !== 'custom') {
+        throw new TypeError(`${source}: Custom editors must have type "custom".`);
+    }
+    if (typeof editor.name !== 'string' || editor.name.trim() === '') {
+        throw new TypeError(`${source}: Custom editor name must not be empty.`);
+    }
+    if (typeof editor.executable !== 'string' ||
+        editor.executable.trim() === '') {
+        throw new TypeError(`${source}: Custom editor executable must not be empty.`);
+    }
+    if (!Array.isArray(editor.arguments) ||
+        !editor.arguments.every((argument) => typeof argument === 'string')) {
+        throw new TypeError(`${source}: Custom editor arguments must be an array of strings.`);
+    }
+    if (!editor.arguments.some((argument) => argument.includes(exports.customEditorTargetPathPlaceholder))) {
+        throw new TypeError(`${source}: Custom editor arguments must include ${exports.customEditorTargetPathPlaceholder}.`);
+    }
+    return editor;
+};
+const validateDefaultEditor = (value, source) => {
+    if (value === null) {
+        return null;
+    }
+    return typeof value === 'string'
+        ? validateBuiltInEditor(value, source)
+        : validateCustomEditor(value, source);
+};
+exports.defaultEditorOption = {
+    name: 'Default editor',
+    cliFlag,
+    description: () => (jsx_runtime_1.jsxs(jsx_runtime_1.Fragment, { children: ["Set the default editor for opening files from Remotion Studio. Available editors: ",
+            jsx_runtime_1.jsx("code", { children: exports.defaultEditorIds.join(', ') }),
+            "."] })),
+    ssrName: null,
+    docLink: 'https://www.remotion.dev/docs/studio/open-in-editor',
+    type: null,
+    getValue: ({ commandLine }) => {
+        const cliValue = commandLine[cliFlag];
+        if (cliValue !== undefined && cliValue !== null) {
+            return {
+                value: validateBuiltInEditor(cliValue, `--${cliFlag}`),
+                source: 'cli',
+            };
+        }
+        return {
+            value: defaultEditor,
+            source: 'config',
+        };
+    },
+    setConfig(value) {
+        defaultEditor = validateDefaultEditor(value, 'Config.setDefaultEditor()');
+    },
+    id: cliFlag,
+};

package/dist/options/frames.d.ts

@@ -1,17 +1,17 @@
-import type { FrameRange } from '../frame-range';
+import type { FrameSelection } from '../frame-range';
 export declare const framesOption: {
     name: string;
     cliFlag: "frames";
     description: () => import("react/jsx-runtime").JSX.Element;
     ssrName: "frameRange";
     docLink: string;
-    type: FrameRange | null;
+    type: FrameSelection;
     getValue: ({ commandLine }: {
         commandLine: Record<string, unknown>;
     }) => {
         source: string;
-        value: FrameRange | null;
+        value: FrameSelection;
     };
-    setConfig: (value: FrameRange | null) => void;
+    setConfig: (value: FrameSelection) => void;
     id: "frames";
 };

package/dist/options/frames.js

@@ -3,8 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.framesOption = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const frame_range_1 = require("../frame-range");
+const validate_selected_frames_1 = require("../validate-selected-frames");
 const cliFlag = 'frames';
-let frameRange = null;
+let frameSelection = null;
 const parseFrameRangeFromCli = (newFrameRange) => {
     if (typeof newFrameRange === 'number') {
         if (newFrameRange < 0) {
@@ -16,6 +17,37 @@ const 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 = (0, validate_selected_frames_1.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];
+            });
+            (0, frame_range_1.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`);
@@ -23,7 +55,7 @@ const 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;
         }
@@ -31,7 +63,7 @@ const 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];
         }
@@ -39,7 +71,7 @@ const 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) {
@@ -62,7 +94,15 @@ exports.framesOption = {
     getValue: ({ commandLine }) => {
         if (commandLine[cliFlag] !== undefined) {
             const value = parseFrameRangeFromCli(commandLine[cliFlag]);
-            (0, frame_range_1.validateFrameRange)(value);
+            if (typeof value === 'object' && !Array.isArray(value)) {
+                (0, validate_selected_frames_1.validateSelectedFrames)({
+                    frames: value.frames,
+                    durationInFrames: null,
+                });
+            }
+            else {
+                (0, frame_range_1.validateFrameRange)(value);
+            }
             return {
                 source: 'cli',
                 value,
@@ -70,14 +110,17 @@ exports.framesOption = {
         }
         return {
             source: 'config',
-            value: frameRange,
+            value: frameSelection,
         };
     },
     setConfig: (value) => {
-        if (value !== null) {
+        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            (0, validate_selected_frames_1.validateSelectedFrames)({ frames: value.frames, durationInFrames: null });
+        }
+        else if (value !== null) {
             (0, frame_range_1.validateFrameRange)(value);
         }
-        frameRange = value;
+        frameSelection = value;
     },
     id: cliFlag,
 };

package/dist/options/index.d.ts

@@ -1032,6 +1032,22 @@ export declare const allOptions: {
         setConfig: (value: boolean) => void;
         id: "dark-mode";
     };
+    defaultEditorOption: {
+        name: string;
+        cliFlag: "editor";
+        description: () => import("react/jsx-runtime").JSX.Element;
+        ssrName: null;
+        docLink: string;
+        type: import("./default-editor").DefaultEditor | null;
+        getValue: ({ commandLine }: {
+            commandLine: Record<string, unknown>;
+        }) => {
+            value: import("./default-editor").DefaultEditor | null;
+            source: string;
+        };
+        setConfig(value: import("./default-editor").DefaultEditor | null): void;
+        id: "editor";
+    };
     publicLicenseKeyOption: {
         name: string;
         cliFlag: "public-license-key";
@@ -1118,14 +1134,14 @@ export declare const allOptions: {
         description: () => import("react/jsx-runtime").JSX.Element;
         ssrName: "frameRange";
         docLink: string;
-        type: import("..").FrameRange | null;
+        type: import("..").FrameSelection;
         getValue: ({ commandLine }: {
             commandLine: Record<string, unknown>;
         }) => {
             source: string;
-            value: import("..").FrameRange | null;
+            value: import("..").FrameSelection;
         };
-        setConfig: (value: import("..").FrameRange | null) => void;
+        setConfig: (value: import("..").FrameSelection) => void;
         id: "frames";
     };
     forceNewStudioOption: {
@@ -1319,7 +1335,7 @@ export declare const allOptions: {
     };
     rspackOption: {
         name: string;
-        cliFlag: "experimental-rspack";
+        cliFlag: "rspack";
         description: () => import("react/jsx-runtime").JSX.Element;
         ssrName: null;
         docLink: null;
@@ -1331,7 +1347,7 @@ export declare const allOptions: {
             source: string;
         };
         setConfig(value: boolean): void;
-        id: "experimental-rspack";
+        id: "rspack";
     };
     outDirOption: {
         name: string;
@@ -1371,6 +1387,25 @@ export declare const allOptions: {
         type: string | null;
         id: "package-manager";
     };
+    skipSkillsOption: {
+        name: string;
+        cliFlag: "skip-skills";
+        description: () => import("react/jsx-runtime").JSX.Element;
+        ssrName: null;
+        docLink: string;
+        getValue: ({ commandLine }: {
+            commandLine: Record<string, unknown>;
+        }) => {
+            source: string;
+            value: true;
+        } | {
+            source: string;
+            value: false;
+        };
+        setConfig: () => never;
+        type: boolean;
+        id: "skip-skills";
+    };
     sampleRateOption: {
         name: string;
         cliFlag: "sample-rate";