@remotion/renderer 3.0.0-processing.8 → 3.0.0-rc.7

package/dist/render-still.d.ts

@@ -1,22 +1,27 @@
 import { Browser as PuppeteerBrowser } from 'puppeteer-core';
-import { Browser, BrowserExecutable, TCompMetadata } from 'remotion';
-/**
- * @description Render a still frame from a composition and returns an image path
- */
-export declare const renderStill: ({ composition, quality, imageFormat, webpackBundle, browser, puppeteerInstance, dumpBrowserLogs, onError, inputProps, envVariables, output, frame, overwrite, browserExecutable, }: {
+import { BrowserExecutable, StillImageFormat, TCompMetadata } from 'remotion';
+import { ServeUrlOrWebpackBundle } from './legacy-webpack-config';
+import { ChromiumOptions } from './open-browser';
+declare type InnerStillOptions = {
     composition: TCompMetadata;
     output: string;
-    webpackBundle: string;
-    frame?: number | undefined;
+    frame?: number;
     inputProps?: unknown;
-    imageFormat?: "png" | "jpeg" | undefined;
-    quality?: number | undefined;
-    browser?: Browser | undefined;
-    puppeteerInstance?: PuppeteerBrowser | undefined;
-    dumpBrowserLogs?: boolean | undefined;
-    onError?: ((err: Error) => void) | undefined;
-    envVariables?: Record<string, string> | undefined;
-    overwrite?: boolean | undefined;
-    browserExecutable?: BrowserExecutable | undefined;
-}) => Promise<void>;
+    imageFormat?: StillImageFormat;
+    quality?: number;
+    puppeteerInstance?: PuppeteerBrowser;
+    dumpBrowserLogs?: boolean;
+    envVariables?: Record<string, string>;
+    overwrite?: boolean;
+    browserExecutable?: BrowserExecutable;
+    timeoutInMilliseconds?: number;
+    chromiumOptions?: ChromiumOptions;
+    scale?: number;
+};
+export declare type RenderStillOptions = InnerStillOptions & ServeUrlOrWebpackBundle;
+/**
+ * @description Render a still frame from a composition and returns an image path
+ */
+export declare const renderStill: (options: RenderStillOptions) => Promise<void>;
+export {};
 //# sourceMappingURL=render-still.d.ts.map

package/dist/render-still.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-still.d.ts","sourceRoot":"","sources":["../src/render-still.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,OAAO,IAAI,gBAAgB,EAAC,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAC,OAAO,EAAE,iBAAiB,EAAa,aAAa,EAAC,MAAM,UAAU,CAAC;AAO9E;;GAEG;AACH,eAAO,MAAM,WAAW;iBAgBV,aAAa;YAClB,MAAM;mBACC,MAAM;;iBAER,OAAO;;;;;;qBAMJ,KAAK,KAAK,IAAI;;;;mBAoI9B,CAAC"}
+{"version":3,"file":"render-still.d.ts","sourceRoot":"","sources":["../src/render-still.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,OAAO,IAAI,gBAAgB,EAAC,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EACN,iBAAiB,EAEjB,gBAAgB,EAChB,aAAa,EACb,MAAM,UAAU,CAAC;AAGlB,OAAO,EAEN,uBAAuB,EACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAC,eAAe,EAAc,MAAM,gBAAgB,CAAC;AAS5D,aAAK,iBAAiB,GAAG;IACxB,WAAW,EAAE,aAAa,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;IACrC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,oBAAY,kBAAkB,GAAG,iBAAiB,GAAG,uBAAuB,CAAC;AAmK7E;;GAEG;AAEH,eAAO,MAAM,WAAW,YACd,kBAAkB,KACzB,QAAQ,IAAI,CAed,CAAC"}

package/dist/render-still.js

@@ -26,21 +26,26 @@ exports.renderStill = void 0;
 const fs_1 = __importStar(require("fs"));
 const path_1 = __importDefault(require("path"));
 const remotion_1 = require("remotion");
+const ensure_output_directory_1 = require("./ensure-output-directory");
+const handle_javascript_exception_1 = require("./error-handling/handle-javascript-exception");
+const legacy_webpack_config_1 = require("./legacy-webpack-config");
 const open_browser_1 = require("./open-browser");
+const prepare_server_1 = require("./prepare-server");
 const provide_screenshot_1 = require("./provide-screenshot");
+const puppeteer_evaluate_1 = require("./puppeteer-evaluate");
 const seek_to_frame_1 = require("./seek-to-frame");
-const serve_static_1 = require("./serve-static");
 const set_props_and_env_1 = require("./set-props-and-env");
-/**
- * @description Render a still frame from a composition and returns an image path
- */
-const renderStill = async ({ composition, quality, imageFormat = 'png', webpackBundle, browser = remotion_1.Internals.DEFAULT_BROWSER, puppeteerInstance, dumpBrowserLogs = false, onError, inputProps, envVariables, output, frame = 0, overwrite = true, browserExecutable, }) => {
+const validate_puppeteer_timeout_1 = require("./validate-puppeteer-timeout");
+const validate_scale_1 = require("./validate-scale");
+const innerRenderStill = async ({ composition, quality, imageFormat = 'png', serveUrl, puppeteerInstance, dumpBrowserLogs = false, onError, inputProps, envVariables, output, frame = 0, overwrite = true, browserExecutable, timeoutInMilliseconds, chromiumOptions, scale, }) => {
     remotion_1.Internals.validateDimension(composition.height, 'height', 'in the `config` object passed to `renderStill()`');
     remotion_1.Internals.validateDimension(composition.width, 'width', 'in the `config` object passed to `renderStill()`');
     remotion_1.Internals.validateFps(composition.fps, 'in the `config` object of `renderStill()`');
     remotion_1.Internals.validateDurationInFrames(composition.durationInFrames, 'in the `config` object passed to `renderStill()`');
     remotion_1.Internals.validateNonNullImageFormat(imageFormat);
     remotion_1.Internals.validateFrame(frame, composition.durationInFrames);
+    (0, validate_puppeteer_timeout_1.validatePuppeteerTimeout)(timeoutInMilliseconds);
+    (0, validate_scale_1.validateScale)(scale);
     if (typeof output !== 'string') {
         throw new TypeError('`output` parameter was not passed or is not a string');
     }
@@ -58,35 +63,57 @@ const renderStill = async ({ composition, quality, imageFormat = 'png', webpackB
             throw new Error(`The output location ${output} already exists, but is not a file, but something else (e.g. folder). Cannot save to it.`);
         }
     }
-    (0, fs_1.mkdirSync)(path_1.default.resolve(output, '..'), {
-        recursive: true,
-    });
-    const [{ port, close }, browserInstance] = await Promise.all([
-        (0, serve_static_1.serveStatic)(webpackBundle),
-        puppeteerInstance !== null && puppeteerInstance !== void 0 ? puppeteerInstance : (0, open_browser_1.openBrowser)(browser, {
-            browserExecutable,
-            shouldDumpIo: dumpBrowserLogs,
-        }),
-    ]);
+    (0, ensure_output_directory_1.ensureOutputDirectory)(output);
+    const browserInstance = puppeteerInstance !== null && puppeteerInstance !== void 0 ? puppeteerInstance : (await (0, open_browser_1.openBrowser)(remotion_1.Internals.DEFAULT_BROWSER, {
+        browserExecutable,
+        shouldDumpIo: dumpBrowserLogs,
+        chromiumOptions,
+    }));
     const page = await browserInstance.newPage();
     page.setViewport({
         width: composition.width,
         height: composition.height,
-        deviceScaleFactor: 1,
+        deviceScaleFactor: scale !== null && scale !== void 0 ? scale : 1,
     });
+    const cleanup = async () => {
+        cleanUpJSException();
+        if (puppeteerInstance) {
+            await page.close();
+        }
+        else {
+            browserInstance.close().catch((err) => {
+                console.log('Unable to close browser', err);
+            });
+        }
+    };
     const errorCallback = (err) => {
-        onError === null || onError === void 0 ? void 0 : onError(err);
+        onError(err);
+        cleanup();
     };
-    page.on('pageerror', errorCallback);
+    const cleanUpJSException = (0, handle_javascript_exception_1.handleJavascriptException)({
+        page,
+        onError: errorCallback,
+        frame: null,
+    });
     await (0, set_props_and_env_1.setPropsAndEnv)({
         inputProps,
         envVariables,
         page,
-        port,
+        serveUrl,
         initialFrame: frame,
+        timeoutInMilliseconds,
+    });
+    await (0, puppeteer_evaluate_1.puppeteerEvaluateWithCatch)({
+        pageFunction: (id) => {
+            window.setBundleMode({
+                type: 'composition',
+                compositionName: id,
+            });
+        },
+        args: [composition.id],
+        frame: null,
+        page,
     });
-    const site = `http://localhost:${port}/index.html?composition=${composition.id}`;
-    await page.goto(site);
     try {
         await (0, seek_to_frame_1.seekToFrame)({ frame, page });
     }
@@ -94,10 +121,7 @@ const renderStill = async ({ composition, quality, imageFormat = 'png', webpackB
         const error = err;
         if (error.message.includes('timeout') &&
             error.message.includes('exceeded')) {
-            errorCallback(new Error('The rendering timed out. See https://www.remotion.dev/docs/timeout/ for possible reasons.'));
-        }
-        else {
-            errorCallback(error);
+            throw new Error('The rendering timed out. See https://www.remotion.dev/docs/timeout/ for possible reasons.');
         }
         throw error;
     }
@@ -110,18 +134,24 @@ const renderStill = async ({ composition, quality, imageFormat = 'png', webpackB
             output,
         },
     });
-    page.off('pageerror', errorCallback);
-    close().catch((err) => {
-        console.log('Unable to close web server', err);
+    await cleanup();
+};
+/**
+ * @description Render a still frame from a composition and returns an image path
+ */
+const renderStill = async (options) => {
+    const selectedServeUrl = (0, legacy_webpack_config_1.getServeUrlWithFallback)(options);
+    const { closeServer, serveUrl } = await (0, prepare_server_1.prepareServer)(selectedServeUrl);
+    return new Promise((resolve, reject) => {
+        innerRenderStill({
+            ...options,
+            serveUrl,
+            onError: (err) => reject(err),
+        })
+            .then((res) => resolve(res))
+            .catch((err) => reject(err))
+            .finally(() => closeServer());
     });
-    if (puppeteerInstance) {
-        await page.close();
-    }
-    else {
-        browserInstance.close().catch((err) => {
-            console.log('Unable to close browser', err);
-        });
-    }
 };
 exports.renderStill = renderStill;
 //# sourceMappingURL=render-still.js.map

package/dist/render-still.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-still.js","sourceRoot":"","sources":["../src/render-still.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"render-still.js","sourceRoot":"","sources":["../src/render-still.ts"],"names":[],"mappings":"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"}

package/dist/render.d.ts

@@ -1,23 +1,45 @@
-import { Browser as PuppeteerBrowser } from 'puppeteer-core';
-import { Browser, BrowserExecutable, FrameRange, ImageFormat, VideoConfig } from 'remotion';
-import { OnErrorInfo, OnStartData, RenderFramesOutput } from './types';
-export declare const renderFrames: ({ config, parallelism, onFrameUpdate, compositionId, outputDir, onStart, inputProps, envVariables, webpackBundle, quality, imageFormat, browser, frameRange, dumpBrowserLogs, puppeteerInstance, onError, browserExecutable, }: {
-    config: VideoConfig;
-    compositionId: string;
+/// <reference types="node" />
+import { Browser as PuppeteerBrowser, Page } from 'puppeteer-core';
+import { BrowserExecutable, FrameRange, ImageFormat, SmallTCompMetadata } from 'remotion';
+import { RenderMediaOnDownload } from './assets/download-and-map-assets-to-file';
+import { BrowserLog } from './browser-log';
+import { ServeUrlOrWebpackBundle } from './legacy-webpack-config';
+import { ChromiumOptions } from './open-browser';
+import { OnStartData, RenderFramesOutput } from './types';
+declare type ConfigOrComposition = {
+    /**
+     * @deprecated This field has been renamed to `composition`
+     */
+    config: SmallTCompMetadata;
+} | {
+    composition: SmallTCompMetadata;
+};
+declare type RenderFramesOptions = {
     onStart: (data: OnStartData) => void;
-    onFrameUpdate: (f: number) => void;
-    outputDir: string;
+    onFrameUpdate: (framesRendered: number, frameIndex: number) => void;
+    outputDir: string | null;
     inputProps: unknown;
-    envVariables?: Record<string, string> | undefined;
-    webpackBundle: string;
+    envVariables?: Record<string, string>;
     imageFormat: ImageFormat;
-    parallelism?: number | null | undefined;
-    quality?: number | undefined;
-    browser?: Browser | undefined;
-    frameRange?: FrameRange | null | undefined;
-    dumpBrowserLogs?: boolean | undefined;
-    puppeteerInstance?: PuppeteerBrowser | undefined;
-    browserExecutable?: BrowserExecutable | undefined;
-    onError?: ((info: OnErrorInfo) => void) | undefined;
+    parallelism?: number | null;
+    quality?: number;
+    frameRange?: FrameRange | null;
+    dumpBrowserLogs?: boolean;
+    puppeteerInstance?: PuppeteerBrowser;
+    browserExecutable?: BrowserExecutable;
+    onBrowserLog?: (log: BrowserLog) => void;
+    onFrameBuffer?: (buffer: Buffer, frame: number) => void;
+    onDownload?: RenderMediaOnDownload;
+    timeoutInMilliseconds?: number;
+    chromiumOptions?: ChromiumOptions;
+    scale?: number;
+} & ConfigOrComposition & ServeUrlOrWebpackBundle;
+export declare const innerRenderFrames: ({ parallelism, onFrameUpdate, outputDir, onStart, inputProps, quality, imageFormat, frameRange, puppeteerInstance, onError, envVariables, onBrowserLog, onFrameBuffer, onDownload, pagesArray, serveUrl, composition, timeoutInMilliseconds, scale, }: Omit<RenderFramesOptions, "url"> & {
+    onError: (err: Error) => void;
+    pagesArray: Page[];
+    serveUrl: string;
+    composition: SmallTCompMetadata;
 }) => Promise<RenderFramesOutput>;
+export declare const renderFrames: (options: RenderFramesOptions) => Promise<RenderFramesOutput>;
+export {};
 //# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,IAAI,gBAAgB,EAAC,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EACN,OAAO,EACP,iBAAiB,EACjB,UAAU,EACV,WAAW,EAEX,WAAW,EACX,MAAM,UAAU,CAAC;AAYlB,OAAO,EAAC,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAC,MAAM,SAAS,CAAC;AAErE,eAAO,MAAM,YAAY;YAmBhB,WAAW;mBACJ,MAAM;oBACL,WAAW,KAAK,IAAI;uBACjB,MAAM,KAAK,IAAI;eACvB,MAAM;gBACL,OAAO;;mBAEJ,MAAM;iBACR,WAAW;;;;;;;;sBAQP,WAAW,KAAK,IAAI;MAClC,QAAQ,kBAAkB,CA4K7B,CAAC"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":";AAEA,OAAO,EACN,OAAO,IAAI,gBAAgB,EAE3B,IAAI,EACJ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,iBAAiB,EACjB,UAAU,EACV,WAAW,EAEX,kBAAkB,EAElB,MAAM,UAAU,CAAC;AAClB,OAAO,EAEN,qBAAqB,EACrB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAMzC,OAAO,EAEN,uBAAuB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAC,eAAe,EAAc,MAAM,gBAAgB,CAAC;AAM5D,OAAO,EAAC,WAAW,EAAE,kBAAkB,EAAC,MAAM,SAAS,CAAC;AAIxD,aAAK,mBAAmB,GACrB;IACA;;OAEG;IACH,MAAM,EAAE,kBAAkB,CAAC;CAC1B,GACD;IACA,WAAW,EAAE,kBAAkB,CAAC;CAC/B,CAAC;AAEL,aAAK,mBAAmB,GAAG;IAC1B,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IACrC,aAAa,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACpE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;IACrC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IACzC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,mBAAmB,GACtB,uBAAuB,CAAC;AAczB,eAAO,MAAM,iBAAiB;mBAqBd,KAAK,KAAK,IAAI;gBACjB,IAAI,EAAE;cACR,MAAM;iBACH,kBAAkB;MAC5B,QAAQ,kBAAkB,CAkN7B,CAAC;AAEF,eAAO,MAAM,YAAY,YACf,mBAAmB,KAC1B,QAAQ,kBAAkB,CAiF5B,CAAC"}

package/dist/render.js

@@ -3,48 +3,67 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderFrames = void 0;
+exports.renderFrames = exports.innerRenderFrames = void 0;
+const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const remotion_1 = require("remotion");
+const download_and_map_assets_to_file_1 = require("./assets/download-and-map-assets-to-file");
 const cycle_browser_tabs_1 = require("./cycle-browser-tabs");
 const get_concurrency_1 = require("./get-concurrency");
-const get_frame_range_1 = require("./get-frame-range");
 const get_frame_to_render_1 = require("./get-frame-to-render");
+const handle_javascript_exception_1 = require("./error-handling/handle-javascript-exception");
 const image_format_1 = require("./image-format");
+const legacy_webpack_config_1 = require("./legacy-webpack-config");
+const make_assets_download_dir_1 = require("./make-assets-download-dir");
 const open_browser_1 = require("./open-browser");
 const pool_1 = require("./pool");
+const prepare_server_1 = require("./prepare-server");
 const provide_screenshot_1 = require("./provide-screenshot");
 const seek_to_frame_1 = require("./seek-to-frame");
-const serve_static_1 = require("./serve-static");
 const set_props_and_env_1 = require("./set-props-and-env");
-const renderFrames = async ({ config, parallelism, onFrameUpdate, compositionId, outputDir, onStart, inputProps, envVariables = {}, webpackBundle, quality, imageFormat = image_format_1.DEFAULT_IMAGE_FORMAT, browser = remotion_1.Internals.DEFAULT_BROWSER, frameRange, dumpBrowserLogs = false, puppeteerInstance, onError, browserExecutable, }) => {
-    remotion_1.Internals.validateDimension(config.height, 'height', 'in the `config` object passed to `renderFrames()`');
-    remotion_1.Internals.validateDimension(config.width, 'width', 'in the `config` object passed to `renderFrames()`');
-    remotion_1.Internals.validateFps(config.fps, 'in the `config` object of `renderFrames()`');
-    remotion_1.Internals.validateDurationInFrames(config.durationInFrames, 'in the `config` object passed to `renderFrames()`');
-    if (quality !== undefined && imageFormat !== 'jpeg') {
-        throw new Error("You can only pass the `quality` option if `imageFormat` is 'jpeg'.");
+const validate_scale_1 = require("./validate-scale");
+const puppeteer_evaluate_1 = require("./puppeteer-evaluate");
+const getComposition = (others) => {
+    if ('composition' in others) {
+        return others.composition;
+    }
+    if ('config' in others) {
+        return others.config;
+    }
+    return undefined;
+};
+const innerRenderFrames = async ({ parallelism, onFrameUpdate, outputDir, onStart, inputProps, quality, imageFormat = image_format_1.DEFAULT_IMAGE_FORMAT, frameRange, puppeteerInstance, onError, envVariables, onBrowserLog, onFrameBuffer, onDownload, pagesArray, serveUrl, composition, timeoutInMilliseconds, scale, }) => {
+    if (!puppeteerInstance) {
+        throw new Error('weird');
     }
-    remotion_1.Internals.validateQuality(quality);
     const actualParallelism = (0, get_concurrency_1.getActualConcurrency)(parallelism !== null && parallelism !== void 0 ? parallelism : null);
-    const [{ port, close }, browserInstance] = await Promise.all([
-        (0, serve_static_1.serveStatic)(webpackBundle),
-        puppeteerInstance !== null && puppeteerInstance !== void 0 ? puppeteerInstance : (0, open_browser_1.openBrowser)(browser, {
-            shouldDumpIo: dumpBrowserLogs,
-            browserExecutable,
-        }),
-    ]);
+    if (outputDir) {
+        if (!fs_1.default.existsSync(outputDir)) {
+            fs_1.default.mkdirSync(outputDir, {
+                recursive: true,
+            });
+        }
+    }
+    const realFrameRange = (0, get_frame_to_render_1.getRealFrameRange)(composition.durationInFrames, frameRange !== null && frameRange !== void 0 ? frameRange : null);
+    const frameCount = realFrameRange[1] - realFrameRange[0] + 1;
     const pages = new Array(actualParallelism).fill(true).map(async () => {
-        const page = await browserInstance.newPage();
+        const page = await puppeteerInstance.newPage();
+        pagesArray.push(page);
         page.setViewport({
-            width: config.width,
-            height: config.height,
-            deviceScaleFactor: 1,
+            width: composition.width,
+            height: composition.height,
+            deviceScaleFactor: scale !== null && scale !== void 0 ? scale : 1,
         });
-        const errorCallback = (err) => {
-            onError === null || onError === void 0 ? void 0 : onError({ error: err, frame: null });
+        const logCallback = (log) => {
+            onBrowserLog === null || onBrowserLog === void 0 ? void 0 : onBrowserLog({
+                stackTrace: log.stackTrace(),
+                text: log.text(),
+                type: log.type(),
+            });
         };
-        page.on('pageerror', errorCallback);
+        if (onBrowserLog) {
+            page.on('console', logCallback);
+        }
         const initialFrame = typeof frameRange === 'number'
             ? frameRange
             : frameRange === null || frameRange === undefined
@@ -54,39 +73,52 @@ const renderFrames = async ({ config, parallelism, onFrameUpdate, compositionId,
             inputProps,
             envVariables,
             page,
-            port,
+            serveUrl,
             initialFrame,
+            timeoutInMilliseconds,
         });
-        const site = `http://localhost:${port}/index.html?composition=${compositionId}`;
-        await page.goto(site);
-        page.off('pageerror', errorCallback);
+        await (0, puppeteer_evaluate_1.puppeteerEvaluateWithCatch)({
+            pageFunction: (id) => {
+                window.setBundleMode({
+                    type: 'composition',
+                    compositionName: id,
+                });
+            },
+            args: [composition.id],
+            frame: null,
+            page,
+        });
+        page.off('console', logCallback);
         return page;
     });
-    const { stopCycling } = (0, cycle_browser_tabs_1.cycleBrowserTabs)(browserInstance);
     const puppeteerPages = await Promise.all(pages);
     const pool = new pool_1.Pool(puppeteerPages);
-    const frameCount = (0, get_frame_range_1.getFrameCount)(config.durationInFrames, frameRange !== null && frameRange !== void 0 ? frameRange : null);
+    const [firstFrameIndex, lastFrameIndex] = realFrameRange;
     // Substract one because 100 frames will be 00-99
     // --> 2 digits
-    let filePadLength = 0;
-    if (frameCount) {
-        filePadLength = String(frameCount - 1).length;
-    }
+    const filePadLength = String(lastFrameIndex).length;
     let framesRendered = 0;
     onStart({
         frameCount,
     });
-    const assets = await Promise.all(new Array(frameCount)
+    const downloadDir = (0, make_assets_download_dir_1.makeAssetsDownloadTmpDir)();
+    const assets = new Array(frameCount).fill(undefined);
+    await Promise.all(new Array(frameCount)
         .fill(Boolean)
         .map((x, i) => i)
         .map(async (index) => {
-        const frame = (0, get_frame_to_render_1.getFrameToRender)(frameRange !== null && frameRange !== void 0 ? frameRange : null, index);
+        const frame = realFrameRange[0] + index;
         const freePage = await pool.acquire();
         const paddedIndex = String(frame).padStart(filePadLength, '0');
-        const errorCallback = (err) => {
-            onError === null || onError === void 0 ? void 0 : onError({ error: err, frame });
+        const errorCallbackOnFrame = (err) => {
+            onError(err);
         };
-        freePage.on('pageerror', errorCallback);
+        const cleanupPageError = (0, handle_javascript_exception_1.handleJavascriptException)({
+            page: freePage,
+            onError: errorCallbackOnFrame,
+            frame,
+        });
+        freePage.on('error', errorCallbackOnFrame);
         try {
             await (0, seek_to_frame_1.seekToFrame)({ frame, page: freePage });
         }
@@ -94,57 +126,133 @@ const renderFrames = async ({ config, parallelism, onFrameUpdate, compositionId,
             const error = err;
             if (error.message.includes('timeout') &&
                 error.message.includes('exceeded')) {
-                errorCallback(new Error('The rendering timed out. See https://www.remotion.dev/docs/timeout/ for possible reasons.'));
+                errorCallbackOnFrame(new Error('The rendering timed out. See https://www.remotion.dev/docs/timeout/ for possible reasons.'));
             }
             else {
-                errorCallback(error);
+                errorCallbackOnFrame(error);
             }
             throw error;
         }
         if (imageFormat !== 'none') {
-            await (0, provide_screenshot_1.provideScreenshot)({
-                page: freePage,
-                imageFormat,
-                quality,
-                options: {
-                    frame,
-                    output: path_1.default.join(outputDir, `element-${paddedIndex}.${imageFormat}`),
-                },
-            });
+            if (onFrameBuffer) {
+                const buffer = await (0, provide_screenshot_1.provideScreenshot)({
+                    page: freePage,
+                    imageFormat,
+                    quality,
+                    options: {
+                        frame,
+                        output: undefined,
+                    },
+                });
+                onFrameBuffer(buffer, frame);
+            }
+            else {
+                if (!outputDir) {
+                    throw new Error('Called renderFrames() without specifying either `outputDir` or `onFrameBuffer`');
+                }
+                const output = path_1.default.join(outputDir, `element-${paddedIndex}.${imageFormat}`);
+                await (0, provide_screenshot_1.provideScreenshot)({
+                    page: freePage,
+                    imageFormat,
+                    quality,
+                    options: {
+                        frame,
+                        output,
+                    },
+                });
+            }
         }
-        const collectedAssets = await freePage.evaluate(() => {
-            return window.remotion_collectAssets();
+        const collectedAssets = await (0, puppeteer_evaluate_1.puppeteerEvaluateWithCatch)({
+            pageFunction: () => {
+                return window.remotion_collectAssets();
+            },
+            args: [],
+            frame,
+            page: freePage,
+        });
+        const compressedAssets = collectedAssets.map((asset) => remotion_1.Internals.AssetCompression.compressAsset(assets.filter(remotion_1.Internals.truthy).flat(1), asset));
+        assets[index] = compressedAssets;
+        compressedAssets.forEach((asset) => {
+            (0, download_and_map_assets_to_file_1.downloadAndMapAssetsToFileUrl)({
+                asset,
+                downloadDir,
+                onDownload: onDownload !== null && onDownload !== void 0 ? onDownload : (() => () => undefined),
+            }).catch((err) => {
+                onError(new Error(`Error while downloading asset: ${err.stack}`));
+            });
         });
         pool.release(freePage);
         framesRendered++;
-        onFrameUpdate(framesRendered);
-        freePage.off('pageerror', errorCallback);
-        return collectedAssets;
+        onFrameUpdate(framesRendered, frame);
+        cleanupPageError();
+        freePage.off('error', errorCallbackOnFrame);
+        return compressedAssets;
     }));
-    close().catch((err) => {
-        console.log('Unable to close web server', err);
-    });
-    stopCycling();
-    // If browser instance was passed in, we close all the pages
-    // we opened.
-    // If new browser was opened, then closing the browser as a cleanup.
-    if (puppeteerInstance) {
-        await Promise.all(puppeteerPages.map((p) => p.close())).catch((err) => {
-            console.log('Unable to close browser tab', err);
-        });
-    }
-    else {
-        browserInstance.close().catch((err) => {
-            console.log('Unable to close browser', err);
-        });
-    }
-    return {
+    const returnValue = {
         assetsInfo: {
             assets,
-            bundleDir: webpackBundle,
+            downloadDir,
+            firstFrameIndex,
+            imageSequenceName: `element-%0${filePadLength}d.${imageFormat}`,
         },
         frameCount,
     };
+    return returnValue;
+};
+exports.innerRenderFrames = innerRenderFrames;
+const renderFrames = async (options) => {
+    var _a;
+    const composition = getComposition(options);
+    if (!composition) {
+        throw new Error('No `composition` option has been specified for renderFrames()');
+    }
+    remotion_1.Internals.validateDimension(composition.height, 'height', 'in the `config` object passed to `renderFrames()`');
+    remotion_1.Internals.validateDimension(composition.width, 'width', 'in the `config` object passed to `renderFrames()`');
+    remotion_1.Internals.validateFps(composition.fps, 'in the `config` object of `renderFrames()`');
+    remotion_1.Internals.validateDurationInFrames(composition.durationInFrames, 'in the `config` object passed to `renderFrames()`');
+    if (options.quality !== undefined && options.imageFormat !== 'jpeg') {
+        throw new Error("You can only pass the `quality` option if `imageFormat` is 'jpeg'.");
+    }
+    const selectedServeUrl = (0, legacy_webpack_config_1.getServeUrlWithFallback)(options);
+    remotion_1.Internals.validateQuality(options.quality);
+    (0, validate_scale_1.validateScale)(options.scale);
+    const { closeServer, serveUrl } = await (0, prepare_server_1.prepareServer)(selectedServeUrl);
+    const browserInstance = (_a = options.puppeteerInstance) !== null && _a !== void 0 ? _a : (await (0, open_browser_1.openBrowser)(remotion_1.Internals.DEFAULT_BROWSER, {
+        shouldDumpIo: options.dumpBrowserLogs,
+        browserExecutable: options.browserExecutable,
+        chromiumOptions: options.chromiumOptions,
+    }));
+    const { stopCycling } = (0, cycle_browser_tabs_1.cycleBrowserTabs)(browserInstance);
+    const openedPages = [];
+    return new Promise((resolve, reject) => {
+        (0, exports.innerRenderFrames)({
+            ...options,
+            puppeteerInstance: browserInstance,
+            onError: (err) => reject(err),
+            pagesArray: openedPages,
+            serveUrl,
+            composition,
+        })
+            .then((res) => resolve(res))
+            .catch((err) => reject(err))
+            .finally(() => {
+            // If browser instance was passed in, we close all the pages
+            // we opened.
+            // If new browser was opened, then closing the browser as a cleanup.
+            if (options.puppeteerInstance) {
+                Promise.all(openedPages.map((p) => p.close())).catch((err) => {
+                    console.log('Unable to close browser tab', err);
+                });
+            }
+            else {
+                browserInstance.close().catch((err) => {
+                    console.log('Unable to close browser', err);
+                });
+            }
+            stopCycling();
+            closeServer();
+        });
+    });
 };
 exports.renderFrames = renderFrames;
 //# sourceMappingURL=render.js.map