remotion 3.2.21 → 3.2.23-ensure-ffmpeg.123

package/.turbo/turbo-build.log

@@ -1,5 +1,4 @@
-remotion:build: cache hit, replaying output 038c93fe806f4b5d
-remotion:build: 
-remotion:build: > remotion@3.2.20 build /Users/jonathanburger/remotion/packages/core
-remotion:build: > tsc -d
-remotion:build: 
+
+> remotion@3.2.44 build /Users/jonathanburger/remotion/packages/core
+> tsc -d
+

package/LICENSE.md

@@ -1,34 +1,34 @@
 # Remotion License
 
-Depending on the type of your legal entity, you are granted permission to use Remotion for your project. Individuals and small companies are allowed to use Remotion create videos for free (even commercial), while a company license is required for for-profit organisations of a certain size. This two-tier system was designed to ensure funding for this project while still allowing the source code to be available and the program to be free for most. Read below for the exact terms of use.
+Depending on the type of your legal entity, you are granted permission to use Remotion for your project. Individuals and small companies are allowed to use Remotion to create videos for free (even commercial), while a company license is required for for-profit organizations of a certain size. This two-tier system was designed to ensure funding for this project while still allowing the source code to be available and the program to be free for most. Read below for the exact terms of use.
 
 - [Free license](#free-license)
 - [Company license](#company-license)
 
 ## Free license
 
-Copyright © 2022 [Jonny Burger](https://jonny.io)
+Copyright © 2022 [Remotion](https://www.remotion.dev/)
 
 ### Eligibility
 
 You are eligible to use Remotion for free if you are:
 
 - an individual
-- a for-profit organisation with up to 3 employees
-- a non-profit or not-for-profit organisation
+- a for-profit organization with up to 3 employees
+- a non-profit or not-for-profit organization
 - evaluating whether Remotion is a good fit, and are not yet using it in a commercial way
 
 ### Allowed use cases
 
-Permission is hereby granted, free of charge, to any person eligible for the "Free license", to use the software non-commercially or commercially for the purpose of creating videos and images and to modify and the software to their own liking, for the purpose of fulfilling their custom use case or to contribute bug fixes or improvements back to Remotion.
+Permission is hereby granted, free of charge, to any person eligible for the "Free license", to use the software non-commercially or commercially for the purpose of creating videos and images and to modify the software to their own liking, for the purpose of fulfilling their custom use case or to contribute bug fixes or improvements back to Remotion.
 
 ### Disallowed use cases
 
-It is not allowed to copy or modify Remotion code for the purpose of selling, renting, licensing, relicensing, sublicensing your own derivate of Remotion.
+It is not allowed to copy or modify Remotion code for the purpose of selling, renting, licensing, relicensing, or sublicensing your own derivate of Remotion.
 
 ### Warranty notice
 
-The software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the author or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.
+The software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement. In no event shall the author or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.
 
 ### Support
 
@@ -36,6 +36,6 @@ Support is provided on a best-we-can-do basis via GitHub Issues and Discord.
 
 ## Company license
 
-You are required to obtain a company license to use Remotion if you are not within the group of entities eligible for a free license. This license will enable you to use Remotion for the allowed use cases specified in the free license, and give you access to prioritized support.
+You are required to obtain a company license to use Remotion if you are not within the group of entities eligible for a free license. This license will enable you to use Remotion for the allowed use cases specified in the free license, and give you access to prioritized support (read the [Support Policy](/docs/support)).
 
 Visit [companies.remotion.dev](https://companies.remotion.dev) for pricing and to buy a license.

package/dist/Img.js

@@ -4,11 +4,14 @@ exports.Img = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const delay_render_1 = require("./delay-render");
-const ImgRefForwarding = ({ onError, ...props }, ref) => {
+const get_environment_1 = require("./get-environment");
+const prefetch_1 = require("./prefetch");
+const ImgRefForwarding = ({ onError, src, ...props }, ref) => {
     const imageRef = (0, react_1.useRef)(null);
     (0, react_1.useImperativeHandle)(ref, () => {
         return imageRef.current;
-    });
+    }, []);
+    const actualSrc = (0, prefetch_1.usePreload)(src);
     const didGetError = (0, react_1.useCallback)((e) => {
         var _a;
         if (onError) {
@@ -19,27 +22,30 @@ const ImgRefForwarding = ({ onError, ...props }, ref) => {
         }
     }, [onError]);
     // If image source switches, make new handle
-    (0, react_1.useLayoutEffect)(() => {
-        if (process.env.NODE_ENV === 'test') {
-            return;
-        }
-        const newHandle = (0, delay_render_1.delayRender)('Loading <Img> with src=' + props.src);
-        const { current } = imageRef;
-        const didLoad = () => {
-            (0, delay_render_1.continueRender)(newHandle);
-        };
-        if (current === null || current === void 0 ? void 0 : current.complete) {
-            (0, delay_render_1.continueRender)(newHandle);
-        }
-        else {
-            current === null || current === void 0 ? void 0 : current.addEventListener('load', didLoad, { once: true });
-        }
-        // If tag gets unmounted, clear pending handles because image is not going to load
-        return () => {
-            current === null || current === void 0 ? void 0 : current.removeEventListener('load', didLoad);
-            (0, delay_render_1.continueRender)(newHandle);
-        };
-    }, [props.src]);
-    return (0, jsx_runtime_1.jsx)("img", { ...props, ref: imageRef, onError: didGetError });
+    if ((0, get_environment_1.getRemotionEnvironment)() === 'rendering') {
+        // eslint-disable-next-line react-hooks/rules-of-hooks
+        (0, react_1.useLayoutEffect)(() => {
+            if (process.env.NODE_ENV === 'test') {
+                return;
+            }
+            const newHandle = (0, delay_render_1.delayRender)('Loading <Img> with src=' + src);
+            const { current } = imageRef;
+            const didLoad = () => {
+                (0, delay_render_1.continueRender)(newHandle);
+            };
+            if (current === null || current === void 0 ? void 0 : current.complete) {
+                (0, delay_render_1.continueRender)(newHandle);
+            }
+            else {
+                current === null || current === void 0 ? void 0 : current.addEventListener('load', didLoad, { once: true });
+            }
+            // If tag gets unmounted, clear pending handles because image is not going to load
+            return () => {
+                current === null || current === void 0 ? void 0 : current.removeEventListener('load', didLoad);
+                (0, delay_render_1.continueRender)(newHandle);
+            };
+        }, [src]);
+    }
+    return ((0, jsx_runtime_1.jsx)("img", { ...props, ref: imageRef, src: actualSrc, onError: didGetError }));
 };
 exports.Img = (0, react_1.forwardRef)(ImgRefForwarding);

package/dist/RemotionRoot.js

@@ -7,8 +7,10 @@ const shared_audio_tags_1 = require("./audio/shared-audio-tags");
 const CompositionManager_1 = require("./CompositionManager");
 const delay_render_1 = require("./delay-render");
 const nonce_1 = require("./nonce");
+const prefetch_state_1 = require("./prefetch-state");
 const random_1 = require("./random");
 const timeline_position_state_1 = require("./timeline-position-state");
+const duration_state_1 = require("./video/duration-state");
 const RemotionRoot = ({ children }) => {
     var _a;
     const [remotionRootId] = (0, react_1.useState)(() => String((0, random_1.random)(null)));
@@ -61,10 +63,10 @@ const RemotionRoot = ({ children }) => {
             });
         }
     }, []);
-    return ((0, jsx_runtime_1.jsx)(nonce_1.NonceContext.Provider, { value: nonceContext, children: (0, jsx_runtime_1.jsx)(timeline_position_state_1.TimelineContext.Provider, { value: timelineContextValue, children: (0, jsx_runtime_1.jsx)(timeline_position_state_1.SetTimelineContext.Provider, { value: setTimelineContextValue, children: (0, jsx_runtime_1.jsx)(CompositionManager_1.CompositionManagerProvider, { children: (0, jsx_runtime_1.jsx)(shared_audio_tags_1.SharedAudioContextProvider
-                    // In the preview, which is mostly played on Desktop, we opt out of the autoplay policy fix as described in https://github.com/remotion-dev/remotion/pull/554, as it mostly applies to mobile.
-                    , { 
-                        // In the preview, which is mostly played on Desktop, we opt out of the autoplay policy fix as described in https://github.com/remotion-dev/remotion/pull/554, as it mostly applies to mobile.
-                        numberOfAudioTags: 0, children: children }) }) }) }) }));
+    return ((0, jsx_runtime_1.jsx)(nonce_1.NonceContext.Provider, { value: nonceContext, children: (0, jsx_runtime_1.jsx)(timeline_position_state_1.TimelineContext.Provider, { value: timelineContextValue, children: (0, jsx_runtime_1.jsx)(timeline_position_state_1.SetTimelineContext.Provider, { value: setTimelineContextValue, children: (0, jsx_runtime_1.jsx)(prefetch_state_1.PrefetchProvider, { children: (0, jsx_runtime_1.jsx)(CompositionManager_1.CompositionManagerProvider, { children: (0, jsx_runtime_1.jsx)(duration_state_1.DurationsContextProvider, { children: (0, jsx_runtime_1.jsx)(shared_audio_tags_1.SharedAudioContextProvider
+                            // In the preview, which is mostly played on Desktop, we opt out of the autoplay policy fix as described in https://github.com/remotion-dev/remotion/pull/554, as it mostly applies to mobile.
+                            , { 
+                                // In the preview, which is mostly played on Desktop, we opt out of the autoplay policy fix as described in https://github.com/remotion-dev/remotion/pull/554, as it mostly applies to mobile.
+                                numberOfAudioTags: 0, children: children }) }) }) }) }) }) }));
 };
 exports.RemotionRoot = RemotionRoot;

package/dist/Sequence.d.ts

@@ -15,7 +15,7 @@ declare type LayoutAndStyle = {
 };
 export declare type SequenceProps = {
     children: React.ReactNode;
-    from: number;
+    from?: number;
     durationInFrames?: number;
     name?: string;
     showInTimeline?: boolean;

package/dist/Sequence.js

@@ -11,7 +11,7 @@ const nonce_1 = require("./nonce");
 const timeline_position_state_1 = require("./timeline-position-state");
 const use_video_config_1 = require("./use-video-config");
 exports.SequenceContext = (0, react_1.createContext)(null);
-const SequenceRefForwardingFunction = ({ from, durationInFrames = Infinity, children, name, showInTimeline = true, showLoopTimesInTimeline, ...other }, ref) => {
+const SequenceRefForwardingFunction = ({ from = 0, durationInFrames = Infinity, children, name, showInTimeline = true, showLoopTimesInTimeline, ...other }, ref) => {
     const { layout = 'absolute-fill' } = other;
     const [id] = (0, react_1.useState)(() => String(Math.random()));
     const parentSequence = (0, react_1.useContext)(exports.SequenceContext);

package/dist/audio/Audio.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import type { RemotionMainAudioProps } from './props';
-export declare const Audio: React.ForwardRefExoticComponent<Pick<Omit<React.DetailedHTMLProps<React.AudioHTMLAttributes<HTMLAudioElement>, HTMLAudioElement>, "onEnded" | "autoPlay" | "controls" | "loop"> & {
+export declare const Audio: React.ForwardRefExoticComponent<Pick<Omit<React.DetailedHTMLProps<React.AudioHTMLAttributes<HTMLAudioElement>, HTMLAudioElement>, "nonce" | "onEnded" | "autoPlay" | "controls"> & {
     volume?: import("../volume-prop").VolumeProp | undefined;
     playbackRate?: number | undefined;
-} & RemotionMainAudioProps, "id" | "key" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "hidden" | "lang" | "placeholder" | "slot" | "spellCheck" | "style" | "tabIndex" | "title" | "translate" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "children" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "src" | "volume" | "playbackRate" | "controlsList" | "crossOrigin" | "mediaGroup" | "muted" | "playsInline" | "preload" | keyof RemotionMainAudioProps> & React.RefAttributes<HTMLAudioElement>>;
+    acceptableTimeShiftInSeconds?: number | undefined;
+} & RemotionMainAudioProps, "id" | "key" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "hidden" | "lang" | "placeholder" | "slot" | "spellCheck" | "style" | "tabIndex" | "title" | "translate" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "children" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "src" | "volume" | "playbackRate" | "controlsList" | "crossOrigin" | "loop" | "mediaGroup" | "muted" | "playsInline" | "preload" | "acceptableTimeShiftInSeconds" | keyof RemotionMainAudioProps> & React.RefAttributes<HTMLAudioElement>>;

package/dist/audio/Audio.js

@@ -4,19 +4,32 @@ exports.Audio = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const get_environment_1 = require("../get-environment");
+const loop_1 = require("../loop");
 const Sequence_1 = require("../Sequence");
+const use_video_config_1 = require("../use-video-config");
 const validate_media_props_1 = require("../validate-media-props");
 const validate_start_from_props_1 = require("../validate-start-from-props");
+const duration_state_1 = require("../video/duration-state");
 const AudioForDevelopment_1 = require("./AudioForDevelopment");
 const AudioForRendering_1 = require("./AudioForRendering");
 const shared_audio_tags_1 = require("./shared-audio-tags");
 const AudioRefForwardingFunction = (props, ref) => {
     const audioContext = (0, react_1.useContext)(shared_audio_tags_1.SharedAudioContext);
     const { startFrom, endAt, ...otherProps } = props;
+    const { loop, ...propsOtherThanLoop } = props;
+    const { fps } = (0, use_video_config_1.useVideoConfig)();
+    const { durations, setDurations } = (0, react_1.useContext)(duration_state_1.DurationsContext);
     const onError = (0, react_1.useCallback)((e) => {
         console.log(e.currentTarget.error);
         throw new Error(`Could not play audio with src ${otherProps.src}: ${e.currentTarget.error}. See https://remotion.dev/docs/media-playback-error for help.`);
     }, [otherProps.src]);
+    const onDuration = (0, react_1.useCallback)((src, durationInSeconds) => {
+        setDurations({ type: 'got-duration', durationInSeconds, src });
+    }, [setDurations]);
+    if (loop && props.src && durations[props.src] !== undefined) {
+        const duration = Math.floor(durations[props.src] * fps);
+        return ((0, jsx_runtime_1.jsx)(loop_1.Loop, { layout: "none", durationInFrames: duration, children: (0, jsx_runtime_1.jsx)(exports.Audio, { ...propsOtherThanLoop, ref: ref }) }));
+    }
     if (typeof startFrom !== 'undefined' || typeof endAt !== 'undefined') {
         (0, validate_start_from_props_1.validateStartFromProps)(startFrom, endAt);
         const startFromFrameNo = startFrom !== null && startFrom !== void 0 ? startFrom : 0;
@@ -25,8 +38,8 @@ const AudioRefForwardingFunction = (props, ref) => {
     }
     (0, validate_media_props_1.validateMediaProps)(props, 'Audio');
     if ((0, get_environment_1.getRemotionEnvironment)() === 'rendering') {
-        return (0, jsx_runtime_1.jsx)(AudioForRendering_1.AudioForRendering, { ...props, ref: ref, onError: onError });
+        return ((0, jsx_runtime_1.jsx)(AudioForRendering_1.AudioForRendering, { onDuration: onDuration, ...props, ref: ref, onError: onError }));
     }
-    return ((0, jsx_runtime_1.jsx)(AudioForDevelopment_1.AudioForDevelopment, { shouldPreMountAudioTags: audioContext !== null && audioContext.numberOfAudioTags > 0, ...props, ref: ref, onError: onError }));
+    return ((0, jsx_runtime_1.jsx)(AudioForDevelopment_1.AudioForDevelopment, { shouldPreMountAudioTags: audioContext !== null && audioContext.numberOfAudioTags > 0, ...props, ref: ref, onError: onError, onDuration: onDuration }));
 };
 exports.Audio = (0, react_1.forwardRef)(AudioRefForwardingFunction);

package/dist/audio/AudioForDevelopment.d.ts

@@ -1,8 +1,10 @@
 import type { ForwardRefExoticComponent, RefAttributes } from 'react';
 import React from 'react';
-export declare const AudioForDevelopment: ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.AudioHTMLAttributes<HTMLAudioElement>, HTMLAudioElement>, "onEnded" | "autoPlay" | "controls" | "loop"> & {
+export declare const AudioForDevelopment: ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.AudioHTMLAttributes<HTMLAudioElement>, HTMLAudioElement>, "nonce" | "onEnded" | "autoPlay" | "controls"> & {
     volume?: import("../volume-prop").VolumeProp | undefined;
     playbackRate?: number | undefined;
+    acceptableTimeShiftInSeconds?: number | undefined;
 } & {
     shouldPreMountAudioTags: boolean;
+    onDuration: (src: string, durationInSeconds: number) => void;
 } & RefAttributes<HTMLAudioElement>>;

package/dist/audio/AudioForDevelopment.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AudioForDevelopment = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
+const prefetch_1 = require("../prefetch");
 const random_1 = require("../random");
 const Sequence_1 = require("../Sequence");
 const use_media_in_timeline_1 = require("../use-media-in-timeline");
@@ -20,20 +21,22 @@ const AudioForDevelopmentForwardRefFunction = (props, ref) => {
     const [mediaVolume] = (0, volume_position_state_1.useMediaVolumeState)();
     const [mediaMuted] = (0, volume_position_state_1.useMediaMutedState)();
     const volumePropFrame = (0, use_audio_frame_1.useFrameForVolumeProp)();
-    const { volume, muted, playbackRate, shouldPreMountAudioTags, ...nativeProps } = props;
+    const { volume, muted, playbackRate, shouldPreMountAudioTags, src, onDuration, acceptableTimeShiftInSeconds, ...nativeProps } = props;
+    if (!src) {
+        throw new TypeError("No 'src' was passed to <Audio>.");
+    }
+    const preloadedSrc = (0, prefetch_1.usePreload)(src);
     const propsToPass = (0, react_1.useMemo)(() => {
         return {
             muted: muted || mediaMuted,
+            src: preloadedSrc,
             ...nativeProps,
         };
-    }, [mediaMuted, muted, nativeProps]);
+    }, [mediaMuted, muted, nativeProps, preloadedSrc]);
     const sequenceContext = (0, react_1.useContext)(Sequence_1.SequenceContext);
     // Generate a string that's as unique as possible for this asset
     // but at the same time deterministic. We use it to combat strict mode issues.
-    const id = (0, react_1.useMemo)(() => {
-        var _a;
-        return `audio-${(0, random_1.random)((_a = props.src) !== null && _a !== void 0 ? _a : '')}-${sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.relativeFrom}-${sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.cumulatedFrom}-${sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.durationInFrames}-muted:${props.muted}`;
-    }, [props.muted, props.src, sequenceContext]);
+    const id = (0, react_1.useMemo)(() => `audio-${(0, random_1.random)(src !== null && src !== void 0 ? src : '')}-${sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.relativeFrom}-${sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.cumulatedFrom}-${sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.durationInFrames}-muted:${props.muted}`, [props.muted, src, sequenceContext]);
     const audioRef = (0, shared_audio_tags_1.useSharedAudio)(propsToPass, id).el;
     const actualVolume = (0, use_media_tag_volume_1.useMediaTagVolume)(audioRef);
     (0, use_sync_volume_with_media_tag_1.useSyncVolumeWithMediaTag)({
@@ -47,19 +50,41 @@ const AudioForDevelopmentForwardRefFunction = (props, ref) => {
         volume,
         mediaVolume,
         mediaRef: audioRef,
-        src: nativeProps.src,
+        src,
         mediaType: 'audio',
     });
     (0, use_media_playback_1.useMediaPlayback)({
         mediaRef: audioRef,
-        src: nativeProps.src,
+        src,
         mediaType: 'audio',
         playbackRate: playbackRate !== null && playbackRate !== void 0 ? playbackRate : 1,
         onlyWarnForMediaSeekingError: false,
+        acceptableTimeshift: acceptableTimeShiftInSeconds !== null && acceptableTimeShiftInSeconds !== void 0 ? acceptableTimeShiftInSeconds : use_media_playback_1.DEFAULT_ACCEPTABLE_TIMESHIFT,
     });
     (0, react_1.useImperativeHandle)(ref, () => {
         return audioRef.current;
-    });
+    }, [audioRef]);
+    const currentOnDurationCallback = (0, react_1.useRef)();
+    currentOnDurationCallback.current = onDuration;
+    (0, react_1.useEffect)(() => {
+        var _a;
+        const { current } = audioRef;
+        if (!current) {
+            return;
+        }
+        if (current.duration) {
+            (_a = currentOnDurationCallback.current) === null || _a === void 0 ? void 0 : _a.call(currentOnDurationCallback, src, current.duration);
+            return;
+        }
+        const onLoadedMetadata = () => {
+            var _a;
+            (_a = currentOnDurationCallback.current) === null || _a === void 0 ? void 0 : _a.call(currentOnDurationCallback, src, current.duration);
+        };
+        current.addEventListener('loadedmetadata', onLoadedMetadata);
+        return () => {
+            current.removeEventListener('loadedmetadata', onLoadedMetadata);
+        };
+    }, [audioRef, src]);
     if (initialShouldPreMountAudioElements) {
         return null;
     }

package/dist/audio/AudioForRendering.d.ts

@@ -1,6 +1,9 @@
 import type { ForwardRefExoticComponent, RefAttributes } from 'react';
 import React from 'react';
-export declare const AudioForRendering: ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.AudioHTMLAttributes<HTMLAudioElement>, HTMLAudioElement>, "onEnded" | "autoPlay" | "controls" | "loop"> & {
+export declare const AudioForRendering: ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.AudioHTMLAttributes<HTMLAudioElement>, HTMLAudioElement>, "nonce" | "onEnded" | "autoPlay" | "controls"> & {
     volume?: import("../volume-prop").VolumeProp | undefined;
     playbackRate?: number | undefined;
+    acceptableTimeShiftInSeconds?: number | undefined;
+} & {
+    onDuration: (src: string, durationInSeconds: number) => void;
 } & RefAttributes<HTMLAudioElement>>;

package/dist/audio/AudioForRendering.js

@@ -5,6 +5,8 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const absolute_src_1 = require("../absolute-src");
 const CompositionManager_1 = require("../CompositionManager");
+const delay_render_1 = require("../delay-render");
+const get_environment_1 = require("../get-environment");
 const random_1 = require("../random");
 const Sequence_1 = require("../Sequence");
 const timeline_position_state_1 = require("../timeline-position-state");
@@ -32,7 +34,7 @@ const AudioForRenderingRefForwardingFunction = (props, ref) => {
     });
     (0, react_1.useImperativeHandle)(ref, () => {
         return audioRef.current;
-    });
+    }, []);
     (0, react_1.useEffect)(() => {
         var _a;
         if (!props.src) {
@@ -70,6 +72,36 @@ const AudioForRenderingRefForwardingFunction = (props, ref) => {
         playbackRate,
         props.playbackRate,
     ]);
+    const { src, onDuration } = props;
+    // If audio source switches, make new handle
+    if ((0, get_environment_1.getRemotionEnvironment)() === 'rendering') {
+        // eslint-disable-next-line react-hooks/rules-of-hooks
+        (0, react_1.useLayoutEffect)(() => {
+            if (process.env.NODE_ENV === 'test') {
+                return;
+            }
+            const newHandle = (0, delay_render_1.delayRender)('Loading <Audio> duration with src=' + src);
+            const { current } = audioRef;
+            const didLoad = () => {
+                if (current) {
+                    onDuration(src, current.duration);
+                }
+                (0, delay_render_1.continueRender)(newHandle);
+            };
+            if (current === null || current === void 0 ? void 0 : current.duration) {
+                onDuration(src, current.duration);
+                (0, delay_render_1.continueRender)(newHandle);
+            }
+            else {
+                current === null || current === void 0 ? void 0 : current.addEventListener('loadedmetadata', didLoad, { once: true });
+            }
+            // If tag gets unmounted, clear pending handles because video metadata is not going to load
+            return () => {
+                current === null || current === void 0 ? void 0 : current.removeEventListener('loadedmetadata', didLoad);
+                (0, delay_render_1.continueRender)(newHandle);
+            };
+        }, [src, onDuration]);
+    }
     return (0, jsx_runtime_1.jsx)("audio", { ref: audioRef, ...nativeProps });
 };
 exports.AudioForRendering = (0, react_1.forwardRef)(AudioForRenderingRefForwardingFunction);

package/dist/audio/props.d.ts

@@ -4,7 +4,8 @@ export declare type RemotionMainAudioProps = {
     startFrom?: number;
     endAt?: number;
 };
-export declare type RemotionAudioProps = Omit<React.DetailedHTMLProps<React.AudioHTMLAttributes<HTMLAudioElement>, HTMLAudioElement>, 'autoPlay' | 'controls' | 'loop' | 'onEnded'> & {
+export declare type RemotionAudioProps = Omit<React.DetailedHTMLProps<React.AudioHTMLAttributes<HTMLAudioElement>, HTMLAudioElement>, 'autoPlay' | 'controls' | 'onEnded' | 'nonce'> & {
     volume?: VolumeProp;
     playbackRate?: number;
+    acceptableTimeShiftInSeconds?: number;
 };

package/dist/config.d.ts

@@ -28,6 +28,11 @@ export declare type ConfigType = {
         readonly setKeyboardShortcutsEnabled: (enableShortcuts: boolean) => void;
     };
     readonly Bundling: {
+        /**
+         * Specify the entry point so you don't have to specify it in the
+         * CLI command
+         */
+        readonly setEntryPoint: (src: string) => void;
         /**
          * Pass in a function which takes the current Webpack config
          * and return a modified Webpack configuration.
@@ -196,6 +201,14 @@ export declare type ConfigType = {
          * Set to true if don't want a video but an image sequence as the output.
          */
         readonly setImageSequence: (newImageSequence: boolean) => void;
+        /**
+         * Overrides the height of a composition
+         */
+        readonly overrideHeight: (newHeight: number) => void;
+        /**
+         * Overrides the width of a composition
+         */
+        readonly overrideWidth: (newWidth: number) => void;
         /**
          * Set the ProRes profile.
          * This method is only valid if the codec has been set to 'prores'.
@@ -203,6 +216,23 @@ export declare type ConfigType = {
          * See https://avpres.net/FFmpeg/im_ProRes.html for meaning of possible values.
          */
         readonly setProResProfile: (profile: '4444-xq' | '4444' | 'hq' | 'standard' | 'light' | 'proxy' | undefined) => void;
+        /**
+         * Override the arguments that Remotion passes to FFMPEG.
+         * Consult https://remotion.dev/docs/renderer/render-media#ffmpegoverride before using this feature.
+         */
+        readonly overrideFfmpegCommand: (command: (info: {
+            type: 'pre-stitcher' | 'stitcher';
+            args: string[];
+        }) => string[]) => void;
+        /**
+         * Set a target audio bitrate to be passed to FFMPEG.
+         */
+        readonly setAudioBitrate: (bitrate: string | null) => void;
+        /**
+         * Set a target video bitrate to be passed to FFMPEG.
+         * Mutually exclusive with setCrf().
+         */
+        readonly setVideoBitrate: (bitrate: string | null) => void;
     };
 };
 export type { Concurrency, WebpackConfiguration, WebpackOverrideFn };

package/dist/get-environment.js

@@ -8,7 +8,7 @@ const getRemotionEnvironment = () => {
         }
         return 'rendering';
     }
-    // The Jest framework sets NODE_ENV as test.
+    // The Vitest framework sets NODE_ENV as test.
     // Right now we don't need to treat it in a special
     // way which is good - defaulting to `rendering`.
     if (process.env.NODE_ENV === 'test') {